Add unclassified issue reconcile baseline

Author: redsunjin

docs/adapter-provider-backlog.md

@@ -56,11 +56,39 @@
   - Anthropic Messages API를 `draft-spec` adapter로 붙이는 후보다.
 - 기대 가치:
   - OpenAI 계열 외 provider contract를 처음 검증할 수 있다.
+- 후보 상태:
+  - 다음 cut 승격 검토 가능
+  - 구현 착수 전 contract 초안 필요
 - 필요한 일:
   - API request/response parsing 추가
   - `ANTHROPIC_API_KEY` 등 env contract 정의
   - message content parsing fail-closed 규칙 추가
   - stub harness 확장
+- contract 초안:
+  - adapter id:
+    - `anthropic-messages:<model-name>`
+  - 필수 env:
+    - `ANTHROPIC_API_KEY`
+  - 선택 env:
+    - `ANTHROPIC_BASE_URL`
+    - `ANTHROPIC_HTTP_TIMEOUT`
+    - `ANTHROPIC_HTTP_MAX_ATTEMPTS`
+  - request surface:
+    - `messages`
+    - deterministic JSON-only prompt
+    - bounded timeout/retry
+  - response expectations:
+    - 첫 text block에서 JSON 문자열을 추출
+    - text block 부재, invalid JSON, schema mismatch는 fail-closed
+  - evidence contract:
+    - 기존 `adapter_id`, `model_label`, `model_resolution_source`, `requested_model` 유지
+  - 최소 회귀 기준:
+    - success
+    - missing API key
+    - invalid JSON
+    - missing text block
+    - retryable HTTP
+    - non-retryable HTTP
 - 리스크:
   - OpenAI 계열과 다른 payload contract로 테스트 표면이 크게 늘어난다.
 - 보류 이유:

docs/context-memory.md

@@ -74,6 +74,7 @@
   - `blocked`
 - sign-off/report summary에 포함:
   - blocker/review issue summary
+  - unclassified issue summary
   - field issue summary
   - top rejected rows
   - sample review evidence

docs/roadmap.md

@@ -42,6 +42,7 @@
   - second OpenAI adapter baseline
   - `draft-spec` xlsx fail-closed baseline
   - OpenAI env validation baseline
+  - unclassified issue reconcile baseline
 
 ## Optional Backlog
 - fixture 시나리오를 더 늘려 adapter edge case 회귀를 강화

docs/test-plan.md

@@ -53,6 +53,7 @@ MVP가 `재현 가능성`, `설명 가능성`, `fail-closed` 원칙을 만족하
 - `unknown_code` 같은 blocker issue는 `blocked`로 분류된다
 - blocker가 없어도 loadable row가 0이면 `blocked`로 분류된다
 - `required_missing`, `rule_violation`, `type_mismatch`는 `review-needed` 근거로 남는다
+- unclassified issue만 있어도 `review-needed`와 `unclassified_issue_summary`가 남아야 한다
 - reconciliation summary는 `field_issue_summary`, `top_row_issue_summary`, `sample_issues`를 남긴다
 
 ### 7. Workflow Harness Tests

tests/test_cli_init.py

@@ -830,6 +830,84 @@ def test_reconcile_blocks_for_unknown_code_policy(tmp_path: Path) -> None:
     assert "진행을 중단" in reconciliation_summary["recommended_next_action"]
 
 
+def test_reconcile_tracks_unclassified_issue_summary(tmp_path: Path) -> None:
+    target_dir = tmp_path / "demo"
+    assert main(["init", str(target_dir)]) == 0
+
+    source_path = target_dir / "fixtures/members.csv"
+    source_path.write_text(
+        "member_no,name,status\n1001,Kim,ACTIVE\n1002,,INACTIVE\n",
+        encoding="utf-8",
+    )
+    assert main(
+        [
+            "--project-dir",
+            str(target_dir),
+            "approve-spec",
+            "--spec",
+            "specs/mapping-spec.yaml",
+            "--approver",
+            "lead01",
+            "--note",
+            "reviewed",
+        ]
+    ) == 0
+
+    run_dir = target_dir / "runs" / "20260411-unclassified-issue"
+    assert main(
+        [
+            "--project-dir",
+            str(target_dir),
+            "dry-run",
+            "--source",
+            "fixtures/members.csv",
+            "--spec",
+            "specs/mapping-spec.yaml",
+            "--out-dir",
+            str(run_dir),
+        ]
+    ) == 0
+
+    rejects_path = run_dir / "rejects.csv"
+    with rejects_path.open("r", encoding="utf-8", newline="") as handle:
+        reject_rows = list(csv.DictReader(handle))
+
+    assert len(reject_rows) == 1
+    reject_rows[0]["issue_code"] = "custom_policy_flag"
+    reject_rows[0]["message"] = "custom policy requires manual review"
+
+    with rejects_path.open("w", encoding="utf-8", newline="") as handle:
+        writer = csv.DictWriter(handle, fieldnames=list(reject_rows[0].keys()))
+        writer.writeheader()
+        writer.writerows(reject_rows)
+
+    report_path = target_dir / "reports" / "sign-off-20260411-unclassified-issue.md"
+    assert main(
+        [
+            "--project-dir",
+            str(target_dir),
+            "reconcile",
+            "--run",
+            str(run_dir),
+            "--out",
+            str(report_path),
+        ]
+    ) == 0
+
+    reconciliation_summary = json.loads((run_dir / "reconciliation-summary.json").read_text(encoding="utf-8"))
+
+    assert reconciliation_summary["verdict"] == "review-needed"
+    assert reconciliation_summary["blocker_issue_summary"] == {}
+    assert reconciliation_summary["review_issue_summary"] == {}
+    assert reconciliation_summary["unclassified_issue_summary"] == {"custom_policy_flag": 1}
+    assert reconciliation_summary["field_issue_summary"]["full_name"]["custom_policy_flag"] == 1
+    assert any(
+        factor["category"] == "unclassified_issue" and factor["code"] == "custom_policy_flag"
+        for factor in reconciliation_summary["verdict_factors"]
+    )
+    assert "custom_policy_flag" in reconciliation_summary["recommended_next_action"]
+
+
 def test_dry_run_auto_advances_workflow_from_work_to_inspect(tmp_path: Path) -> None:
     target_dir = tmp_path / "demo"
     assert main(["init", str(target_dir)]) == 0