elanous 0.2.36 → 0.2.38

package/scripts/gate-0226-accepted-remaining-90.txt

@@ -0,0 +1,91 @@
+# Source: 44fe14face:docs/reports/gate-0226-failure-census.tsv (pre-change accepted census)
+apps/android/app/src/test/kotlin/com/elanvitalai/elanous/android/data/FeedbackEnvelopeVectors.test.ts > Android FeedbackEnvelope shared vectors > runs FeedbackEnvelopeVectorsTest and verifies every shared vector was accounted for
+apps/android/app/src/test/kotlin/com/elanvitalai/elanous/android/ui/chat/ChatHarnessBubble.test.ts > ChatScreen assistant bubble for harness-style turns > injects turn-end through NexusClient→ViewModel and observes the bubble badge
+apps/android/app/src/test/kotlin/com/elanvitalai/elanous/android/ui/chat/ChatLastItemScrollOffset.test.ts > chatLastItemScrollOffset aligns the list to the last item end > ChatScreenLayoutTest drives ChatScreenLayout and observes last-item end alignment
+scripts/hooks/claude-code-utterance.test.ts > UserPromptSubmit reaches the human Claude Code utterance query
+scripts/lib/nl-routing-measurement.test.ts > NL routing corpus runner safety gate > the runner entrypoint stops after final surface resolution with non-zero exit and safety guidance
+scripts/nl-routing-measurement.test.ts > NL routing corpus runner safety gate > the runner entrypoint stops after final surface resolution with non-zero exit and safety guidance
+scripts/release-loop/freeze-off-parity.test.ts > freeze switch off: gate, publish and unattended release are byte-identical to pre-freeze behavior
+scripts/test-deterministic.test.ts > terminateDirectChild > SIGKILLs the group when the direct child is already dead and a grandchild ignores SIGTERM
+scripts/test-diet/effectiveness.test.ts > TD3 effectiveness > measure --effectiveness counts unreachable imports and leaves unreadable results absent
+scripts/webclone/loop/mirror-age.test.ts > edition-check는 조용함을 재료 미러보다 앞에 두고, 미러는 기존 original-mirror 인자로 부른다
+scripts/webclone/loop/mirror-age.test.ts > mirror-age > 12시간 경계 양쪽과 여러 미러를 fetchedAt만으로 한 줄씩 판정한다
+scripts/webclone/loop/mirror-age.test.ts > mirror-age > 파일 mtime이 아니라 MIRROR.json fetchedAt으로 판정한다
+scripts/webclone/loop/ruler-version.test.ts > ruler-version rc 계약 > 12시간을 넘긴 기준선은 rc 1 이고 ***origin-drift 로 재라***를 같이 낸다
+scripts/webclone/loop/ruler-version.test.ts > ruler-version rc 계약 > 최근 기준선은 rc 0 이고 「묵었다」고 말하지 않는다
+scripts/webclone/measure-fidelity.test.ts > main RenderProbe wiring > 로컬 링크가 우세한 미러 진입 문서는 링크 수와 self-contained 상태를 보존한다
+scripts/webclone/measure-fidelity.test.ts > main RenderProbe wiring > 원격 링크가 60% 이상인 미러 진입 문서를 non-self-contained로 기록한다
+scripts/webclone/measure-fidelity.test.ts > main RenderProbe wiring > 통제한 로컬 원문과 성공 프로브가 최종 렌더 위치까지 JSON 산출로 연결된다
+scripts/webclone/measure-fidelity.test.ts > main mirror-entry locality wiring > 네트워크 지배 미러는 참조 수를 내고 픽셀 차이를 품질로 읽을 수 없다고 말한다
+scripts/webclone/measure-fidelity.test.ts > main mirror-entry locality wiring > 로컬 지배 미러는 참조 수를 내고 네트워크 지배 경고를 내지 않는다
+scripts/webclone/measure-fidelity.test.ts > main mirror-entry locality wiring > 미러 진입 문서가 없으면 참조 수와 지배 판정을 못 쟀다로 보존한다
+scripts/webclone/measure-fidelity.test.ts > main overlay observability wiring > 원본과 사본 처리 수를 더해 내고 잔여 덮개면 픽셀 차이를 미신뢰로 표시한다
+scripts/webclone/measure-fidelity.test.ts > main screenshot reliability wiring > 실제 정상·빈 PNG를 기본 통계 추출 경로로 읽어 RMSE를 보존하고 미러 공백 사유를 JSON에 낸다
+src/acp/grok-leader-manager.test.ts > GrokLeaderManager · ensureLeader idempotency contract > ensureLeader returns state object (does not throw)
+src/agent-mission/driver-workdir.test.ts > ignored files outside workdir are detected when created or modified
+src/agent-mission/driver-workdir.test.ts > workdir skips git, runs PTY in the folder by default, and accepts a new mp4
+src/autopilot/build/isolated-instance.test.ts > createIsolatedInstance — 주입 worktree > ★ defaultMergeMainIntoWorktree — fetch 실패 → error / up-to-date / merged (실 git)
+src/dashboard/first-screen-band-wiring.test.ts > showDashboard renders the startup band before and after the real first chat input
+src/directives/directive-index.test.ts > FTS5, incremental byte offsets, version search, redaction, track votes and labels; originals stay unchanged
+src/git-fs/spawn-discipline.test.ts > 실제 저장소 — 이 게이트가 지키는 것 > 실물 git 프론트도어는 --help를 git argv로 전달하고 상태 줄과 git 종료 코드를 보존한다
+src/git-fs/spawn-discipline.test.ts > 실제 저장소 — 이 게이트가 지키는 것 > 실물 진입점에서 scripts 유예와 요약을 산출한다
+src/graph-runner/graph-cli.test.ts > graph YAML triggers.schedule fires through the workflow scheduler into graph tick and persists a run
+src/graph-runner/graph-cli.test.ts > graph tick defaults to idle and --start passes JSON input, prints results, and does not restart a finished run
+src/graph-runner/graph-variant-cli.test.ts > a paused variant resumes from its saved graph after the original template changes
+src/graph-runner/graph-variant-cli.test.ts > a route plan without a budget also executes the changed route
+src/graph-runner/graph-variant-cli.test.ts > ambiguous outcome plan is rejected before ledger or node execution
+src/graph-runner/graph-variant-cli.test.ts > two plans on the same template execute distinct persisted variant graphs through fake nodes
+src/graph-runner/graph-variant-cli.test.ts > variant preserves unrelated node and edge metadata in its runnable snapshot
+src/harness/dogfood.test.ts > assertThrowawayTarget — C 안전 가드(auto-approve 우회 방지) > runHarnessDogfood 도 실경로 target 을 current CLI guidance와 함께 refuse
+src/harness/dogfood.test.ts > assertThrowawayTarget — C 안전 가드(auto-approve 우회 방지) > ★ 실경로(홈·repo·시스템) → refuse with current CLI guidance
+src/mss/logging/log-store.test.ts > LogStore writer contention > carries a failed open observation to the next writable connection
+src/plugins/adapters/claude-package.test.ts > readClaudePackageLedger > reads this machine live ledger without a pluginsRoot override
+src/self-implement/orchestrator-blocked-draft.test.ts > environment branch is committed and pushed to an existing origin without opening a PR
+src/self-implement/orchestrator-blocked-draft.test.ts > environment stop without origin commits changes on the local branch for checkout recovery
+src/self-implement/orchestrator-blocked-draft.test.ts > failed environment push is reported to the caller and never presented as preserved
+src/self-implement/orchestrator-blocked-draft.test.ts > missing worktree keeps provider attribution and reports failed preservation without a draft
+src/self-implement/orchestrator-blocked-draft.test.ts > no changes takes precedence over environment branch preservation
+src/self-implement/orchestrator-blocked-draft.test.ts > quota-exhausted blocked run preserves its branch without opening a draft; implementation deficit still opens one
+src/self-implement/orchestrator-blocked-draft.test.ts > worktree-only environment stop never pushes, even when an origin exists
+src/self-implement/run-chain-query.test.ts > queryRunChain > pages past a full matching dispatch result page to find an old matching session
+src/self-implement/seams-usage-role.test.ts > goal summary passes classify usage role alongside the unchanged resolved model
+src/session-runtime/coding-surface-shell.test.ts > coding surface — shell 실행 tool 노출 > runtime 없는 Agent 폴백은 부모 도구·dispatcher·중단 신호를 자식에 보존한다
+src/skills/tools/dev-harness.test.ts > dispatchRunDevHarness — P3 외부 repo 타깃 > target 실 git repo → repoRoot+elanousBinRoot 를 seam 으로
+src/task-agent/mission.test.ts > shadow --mission → 미션 카드 1 ⊕ 조각 카드 4 · 같은 상태 파일 · 선행 없는 조각만 launch 수 · 나머지 wait after
+src/task-orchestrator/surfaces/pod-pool-cli.test.ts > independent harness ask/say and self CLI dispatch run real kubectl apply only when lease permits
+src/video-pipeline/recipes/reframe.test.ts > reframe — Affinity 가 없어도 «끝까지» 간다 > ⛔ 러너가 «없어도» 멈추지 않는다 (앱이 없는 고객 기계의 모습)
+src/video-pipeline/recipes/vlog.test.ts > vlog 레시피 — 실제 ffmpeg > ⭐ build-layers — 덮는 층(스크림·자막)이 «투명»하다 (🩸 불투명 자막이 영상 전체를 덮었다)
+src/webclone/archive-run.test.ts > 브라우저 재현 가능한 미러 계약 > 실제 wget은 POSIX ERE를 컴파일해 www 형제 자산만 받고 외부 호스트는 받지 않는다
+test/acp-subagent-wire-meta.test.ts > AcpAgent.prompt · _meta forwarding > undefined meta → request omits _meta field
+test/ad-production.test.ts > renders planned captions after assembly while preserving the uncaptained master and named failures
+test/ad-qc-measure.test.ts > QC measurement adapter > uses distinct OCR artifacts for repeated and parallel video measurement plans
+test/dashboard-acp-boot.test.ts > bootDashboardAcpSession — boot observability > records the selected branch and every successful boot outcome
+test/dashboard-turn-typeahead-echo.test.ts > dashboard real user echo wiring > PTY screen preserves submitted Q2 → answer Q2 → submitted Q3 → answer Q3
+test/finance-tools.test.ts > finance tool surface > SQL-injection guard on attractiveness args
+test/finance-tools.test.ts > finance tool surface > finance_trend (A2.1/A4): rotation + country + guards + injection-safe
+test/harness-worktree-add.test.ts > harness worktree add > 판정 신호: goal context records a leading H1 goal title instead of structural H2 headings
+test/harness-worktree-add.test.ts > harness worktree add > 판정 신호: goal synthesis truncates generated output at 250 characters and falls back to title on empty or thrown model output
+test/intake-plane-check-repo-axis.test.ts > frequent matches do not overflow the search buffer and disclose sampling
+test/llm-openrouter-provider.test.ts > OpenRouter provider wire > ⛔ 교차 경로 — config 가 grok 이면 그 키·baseUrl 을 OpenRouter 로 «안» 보낸다
+test/nexus-api-terminals.test.ts > handleTerminalsList > merges web preview PTYs into local and federated lists with their first registration time
+test/oauth/codex-mirror-real-home-guard.test.ts > ① 가드 — 실홈이 대상이면 «던진다» (쓰기는 일어나지 않는다) > ⛔ «심볼릭 링크»로 우회해도 던진다 — 문자열 비교로는 통과했다(리뷰 must-fix)
+test/ocr-tesseract.test.ts > OcrRegistry · Tesseract picker behaviour > strengths:["context-aware"] still picks LLM Vision (Tesseract loses)
+test/persistent-grounding-runtime.test.ts > PersistentGrounding ToolRuntime > default registration alias dispatch runs the guarded search loop and records session observations
+test/persistent-grounding-runtime.test.ts > PersistentGrounding ToolRuntime > generates one session ID for ambient observations and grounding when no session ID is supplied
+test/plugin-hooks-shell.test.ts > shell-hook > array JSON → warn + {}
+test/plugin-hooks-shell.test.ts > shell-hook > env propagated to shell
+test/plugin-hooks-shell.test.ts > shell-hook > stdout JSON object → output
+test/plugin-manifest-hooks.test.ts > plugin-host hook registration > end-to-end dispatch through registered manifest hook
+test/plugin-missions-runtime.test.ts > PX-4 P3 — MissionRegistry > never policy: history grows + iteration advances each tick
+test/plugin-missions-runtime.test.ts > PX-4 P3 — MissionRegistry > score_improvement: only strictly-better score advances
+test/plugin-missions-runtime.test.ts > PX-4 P3 — runMissionEvaluator > parses JSON stdout into MissionResult
+test/preview-terminal.test.ts > PreviewTerminal > resize reaches the kernel PTY — the shell sees the new size (stty size)
+test/rules-contract.test.ts > 변경 ↔ 규칙 갱신 — sources 가 바뀌면 그 «규칙 파일»이 같은 diff 에 있다 > 이 검사가 무엇을 봤는지 «말한다»
+test/self-dev-manual-goal-evidence.test.ts > hand-authored --file goal evidence contract > passes the attached requirement to the self-implement boundary for --file input
+test/shell-audit-log.test.ts > shell-primitive audit-log: programmatic sink > run event includes truncated when output exceeds budget
+test/shell-primitive.test.ts > shell-primitive: runShell (no approval) > maxOutputChars truncates and sets truncated=true
+test/skill-tool-mermaid.test.ts > dispatchMermaidRender — happy path > renders a simple flowchart to Unicode boxes
+test/voice-tts-providers.test.ts > TTS provider availability and unpaid default > falls back to edge-tts, not openai-tts, when nobody chose and no credential resolves
+test/voice-tts-providers.test.ts > TTS provider availability and unpaid default > reports edge-tts and macos-say usable without credentials
+test/workflow-templates-packaged.test.ts > the npm package carries every workflow template the repository has
+test/plugin-missions-runtime.test.ts > [error]

package/scripts/gate-0226-failure-census.ts

@@ -0,0 +1,546 @@
+#!/usr/bin/env bun
+/**
+ * GATE-0226-REMAINING-90 — 0.2.26 gate 실패 ID 전수표의 무결성 검증 진입점.
+ *
+ * 판정: `docs/reports/gate-0226-failure-census.tsv`가 accepted 실패 ID 96건을 중복 없이 보존하고,
+ * 그중 `provider-intake` 6건(첫 감소 칸 GATE-0226-PROVIDER-INTAKE6)을 제외한 90건이 정확히 남으며,
+ * `Error: no ACP` 로그 사건(34회)은 실패 ID로 더해지지 않았음. 보고서 md의 96행 색인과 선언 카운트도 실측과 일치.
+ * intake 제외 90개 ID는 변경 전 `44fe14face` TSV에서 고정한 accepted 목록과 집합 비교한다.
+ *
+ * 사용: bun run scripts/gate-0226-failure-census.ts [--tsv <path>] [--report <path>] [--accepted <path|none>] [--json] [--write-repair-card]
+ *
+ * `--write-repair-card`: 표의 `repair_card` 칸을 묶음·주인에서 다시 계산해 되쓴다(검증은 그대로 이어진다).
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+
+export const CENSUS_TSV = 'docs/reports/gate-0226-failure-census.tsv';
+export const CENSUS_REPORT = 'docs/reports/REPORT-gate-0226-failure-census.md';
+export const DEFAULT_ACCEPTED = 'elanous-hq/seat-state/OP/tools/accepted-0226.json';
+export const DEFAULT_REMAINING_BASELINE = 'scripts/gate-0226-accepted-remaining-90.txt';
+
+export const EXPECTED_HEADER = [
+  'no',
+  'test_id',
+  'source_file',
+  'group',
+  'classification',
+  'root_cause',
+  'repro_command',
+  'evidence',
+  'prescription',
+  'owner',
+  'replacement_contract_if_deleted',
+  'status',
+  'repair_card',
+] as const;
+
+export const TOTAL_IDS = 96;
+export const INTAKE_GROUP = 'provider-intake';
+export const INTAKE_IDS = 6;
+export const REMAINING_IDS = 90;
+
+export const EXPECTED_STATUS: Record<string, number> = {
+  'hypothesis-unverified': 68,
+  'paired-reproduced-root-cause-candidate': 7,
+  'untriaged': 21,
+};
+
+export const EXPECTED_GROUP: Record<string, number> = {
+  'UX-gate-pair': 5,
+  'blocked-draft': 7,
+  'plugin-stdin-EPIPE-candidate': 7,
+  'provider-intake': 6,
+  'provider-self-implement': 2,
+  'remaining-review': 61,
+  'webclone-measure': 8,
+};
+
+export const REQUIRED_FIELDS = ['classification', 'root_cause', 'repro_command', 'evidence', 'prescription', 'owner'] as const;
+
+export const NO_ACP_MARKER = 'Error: no ACP';
+export const ACP_LOG_EVENTS = 34;
+export const NO_DELETION_PROPOSAL = '시험 삭제 제안 없음';
+
+/** 묶음 → 수리 칸. `remaining-review` 만 주인별로 다시 쪼갠다. */
+export const REPAIR_CARDS_BY_GROUP: Record<string, string> = {
+  'provider-intake': 'GATE-0226-PROVIDER-INTAKE6',
+  'webclone-measure': 'GATE-0226-WEBCLONE-MEASURE',
+  'blocked-draft': 'GATE-0226-BLOCKED-DRAFT',
+  'plugin-stdin-EPIPE-candidate': 'GATE-0226-PLUGIN-STDIN-EPIPE',
+  'UX-gate-pair': 'GATE-0226-UX-GATE-PAIR',
+  'provider-self-implement': 'GATE-0226-PROVIDER-SELF-IMPLEMENT',
+};
+
+export const REMAINING_CARD_PREFIX = 'GATE-0226-REMAINING-';
+
+/** 주인 표기(`TC/OP gate`·`UX/Android·OP gate`)에서 두 글자 이상 대문자 트랙 이름만 뽑아 칸 이름 꼬리를 만든다. */
+export function ownerSlug(owner: string): string {
+  const tracks: string[] = [];
+  for (const token of owner.split(/[/·]/)) {
+    const match = /^[A-Z]{2,}/.exec(token.trim());
+    if (match && !tracks.includes(match[0])) tracks.push(match[0]);
+  }
+  return tracks.join('-');
+}
+
+/** 한 실패 ID를 어느 수리 칸이 이어받는지 정한다. 묶음 단위 칸 + `remaining-review` 는 주인 단위 칸. */
+export function repairCardFor(group: string, owner: string): string {
+  const fixed = REPAIR_CARDS_BY_GROUP[group];
+  if (fixed) return fixed;
+  const slug = ownerSlug(owner);
+  return slug.length > 0 ? `${REMAINING_CARD_PREFIX}${slug}` : REMAINING_CARD_PREFIX;
+}
+
+export type CensusRow = Record<(typeof EXPECTED_HEADER)[number], string>;
+
+export type CensusAudit = {
+  ok: boolean;
+  problems: string[];
+  counts: {
+    rows: number;
+    intake: number;
+    remaining: number;
+    status: Record<string, number>;
+    group: Record<string, number>;
+    repair: Record<string, number>;
+  };
+  intakeIds: string[];
+  remainingIds: string[];
+  acpLogEvents: number;
+  ledger: { path: string; status: 'compared' | 'skipped' | 'failed'; ids: number };
+  remainingBaseline: { path: string; status: 'compared' | 'failed'; ids: number };
+};
+
+/** RFC4180 형식의 탭 구분 표를 읽는다. 실패 ID 안의 따옴표·탭·개행을 보존한다. */
+export function parseTsv(text: string): string[][] {
+  const rows: string[][] = [];
+  let row: string[] = [];
+  let field = '';
+  let quoted = false;
+  for (let i = 0; i < text.length; i += 1) {
+    const ch = text[i]!;
+    if (quoted) {
+      if (ch === '"') {
+        if (text[i + 1] === '"') {
+          field += '"';
+          i += 1;
+        } else {
+          quoted = false;
+        }
+      } else {
+        field += ch;
+      }
+      continue;
+    }
+    if (ch === '"') {
+      quoted = true;
+      continue;
+    }
+    if (ch === '\t') {
+      row.push(field);
+      field = '';
+      continue;
+    }
+    if (ch === '\r') continue;
+    if (ch === '\n') {
+      row.push(field);
+      rows.push(row);
+      row = [];
+      field = '';
+      continue;
+    }
+    field += ch;
+  }
+  if (field.length > 0 || row.length > 0) {
+    row.push(field);
+    rows.push(row);
+  }
+  return rows.filter((cells) => cells.some((cell) => cell.trim().length > 0));
+}
+
+function encodeCell(value: string): string {
+  return /[\t\n\r"]/.test(value) ? `"${value.replace(/"/g, '""')}"` : value;
+}
+
+/** `CensusRow`를 탭 구분 표로 되쓴다(따옴표는 필요할 때만, 줄바꿈은 `\n`). */
+export function serializeTsv(rows: CensusRow[]): string {
+  const lines = [EXPECTED_HEADER.join('\t')];
+  for (const row of rows) lines.push(EXPECTED_HEADER.map((name) => encodeCell(row[name])).join('\t'));
+  return `${lines.join('\n')}\n`;
+}
+
+/**
+ * 표의 `repair_card` 칸을 묶음·주인에서 다시 계산해 파일에 되쓴다.
+ * 표에 정본 스키마 밖 칸이 있으면 자료를 잃지 않도록 거부한다.
+ */
+export function writeRepairCards(path: string): number {
+  const rawRows = parseTsv(readFileSync(path, 'utf8'));
+  const header = rawRows[0] ?? [];
+  const unknown = header.filter((name) => !(EXPECTED_HEADER as readonly string[]).includes(name));
+  if (unknown.length > 0) throw new Error(`${path}: 정본 스키마 밖 칸 (${unknown.join(', ')})`);
+  const rows: CensusRow[] = rawRows.slice(1).map((cells) => {
+    const row = {} as CensusRow;
+    EXPECTED_HEADER.forEach((name) => {
+      const at = header.indexOf(name);
+      row[name] = at >= 0 ? (cells[at] ?? '') : '';
+    });
+    row.repair_card = repairCardFor(row.group, row.owner);
+    return row;
+  });
+  writeFileSync(path, serializeTsv(rows), 'utf8');
+  return rows.length;
+}
+
+function tally(values: string[]): Record<string, number> {
+  const out: Record<string, number> = {};
+  for (const value of values) out[value] = (out[value] ?? 0) + 1;
+  return out;
+}
+
+function sortedTally(values: string[]): Record<string, number> {
+  const counted = tally(values);
+  const out: Record<string, number> = {};
+  for (const key of Object.keys(counted).sort()) out[key] = counted[key]!;
+  return out;
+}
+
+function sameTally(actual: Record<string, number>, expected: Record<string, number>): boolean {
+  const keys = new Set([...Object.keys(actual), ...Object.keys(expected)]);
+  for (const key of keys) if ((actual[key] ?? 0) !== (expected[key] ?? 0)) return false;
+  return true;
+}
+
+/** 보고서 md의 `| 번호 | \`실패 ID\` | 묶음 | \`상태\` | 주인 |` 색인 행을 읽는다. */
+export function parseReportIndex(report: string): Array<{ no: number; test_id: string; group: string; status: string; owner: string }> {
+  const out: Array<{ no: number; test_id: string; group: string; status: string; owner: string }> = [];
+  for (const line of report.split('\n')) {
+    const match = /^\| (\d+) \| `(.+?)` \| (.+?) \| `(.+?)` \| (.+?) \|$/.exec(line);
+    if (!match) continue;
+    out.push({
+      no: Number(match[1]),
+      test_id: match[2]!.replace(/\\\|/g, '|'),
+      group: match[3]!.trim(),
+      status: match[4]!,
+      owner: match[5]!.trim(),
+    });
+  }
+  return out;
+}
+
+/** 보고서 md가 선언한 `총 N건 = provider-intake M건 + 나머지 K건` 문면을 읽는다. */
+export function parseReportCounts(report: string): { total: number; intake: number; remaining: number } | null {
+  const match = /총 (\d+)건 = provider-intake (\d+)건[^\n]*나머지 (\d+)건/.exec(report);
+  if (!match) return null;
+  return { total: Number(match[1]), intake: Number(match[2]), remaining: Number(match[3]) };
+}
+
+/** 보고서 md의 수리 칸 표 `| \`GATE-0226-…\` | N |` 행을 읽는다. */
+export function parseReportRepairCards(report: string): Record<string, number> {
+  const out: Record<string, number> = {};
+  for (const line of report.split('\n')) {
+    const match = /^\| `(GATE-0226-[A-Z0-9-]+)` \| (\d+) \|/.exec(line);
+    if (match) out[match[1]!] = Number(match[2]);
+  }
+  return out;
+}
+
+function readAcceptedIds(path: string): string[] | null {
+  if (!existsSync(path)) return null;
+  const parsed: unknown = JSON.parse(readFileSync(path, 'utf8'));
+  if (!Array.isArray(parsed)) throw new Error(`${path}: accepted 원장이 배열이 아니다`);
+  return parsed.map((entry) => {
+    const id = (entry as { id?: unknown }).id;
+    if (typeof id !== 'string' || id.length === 0) throw new Error(`${path}: id 없는 항목`);
+    return id;
+  });
+}
+
+export type AuditInput = {
+  tsvText: string;
+  reportText: string;
+  /** accepted 원장 ID. null 이면 비교 불가(원장 부재)를 산출로 남긴다. */
+  acceptedIds: string[] | null;
+  /** 변경 전 독립 기준으로 고정한 remaining accepted ID 집합. */
+  remainingBaselineIds: string[] | null;
+  remainingBaselinePath: string;
+  ledgerPath: string;
+  ledgerRequired: boolean;
+};
+
+export function auditCensus(input: AuditInput): CensusAudit {
+  const problems: string[] = [];
+  const rawRows = parseTsv(input.tsvText);
+  const header = rawRows[0] ?? [];
+  const headerMatches = header.length === EXPECTED_HEADER.length && EXPECTED_HEADER.every((name, at) => header[at] === name);
+  if (!headerMatches) {
+    problems.push(`tsv-header: 기대 ${EXPECTED_HEADER.join(',')} / 실측 ${header.join(',')}`);
+  }
+  const rows: CensusRow[] = rawRows.slice(1).map((cells) => {
+    const row = {} as CensusRow;
+    EXPECTED_HEADER.forEach((name, at) => {
+      row[name] = cells[at] ?? '';
+    });
+    return row;
+  });
+
+  if (rows.length !== TOTAL_IDS) problems.push(`row-count: 기대 ${TOTAL_IDS}행 / 실측 ${rows.length}행`);
+
+  const numbering = rows.map((row) => Number(row.no));
+  const numbered = numbering.every((value, at) => value === at + 1);
+  if (!numbered) problems.push(`row-numbering: no 컬럼이 1..${rows.length} 순차가 아니다 (${numbering.slice(0, 5).join(',')}…)`);
+
+  const ids = rows.map((row) => row.test_id);
+  const uniqueIds = new Set(ids);
+  if (uniqueIds.size !== ids.length) {
+    const dupes = Object.entries(tally(ids))
+      .filter(([, count]) => count > 1)
+      .map(([id]) => id);
+    problems.push(`unique-ids: 중복 ${ids.length - uniqueIds.size}건 (${dupes.slice(0, 3).join(' | ')})`);
+  }
+
+  const intakeRows = rows.filter((row) => row.group === INTAKE_GROUP);
+  const otherRows = rows.filter((row) => row.group !== INTAKE_GROUP);
+  const intakeIds = intakeRows.map((row) => row.test_id);
+  const remainingIds = otherRows.map((row) => row.test_id);
+  if (intakeRows.length !== INTAKE_IDS) {
+    problems.push(`intake-split: ${INTAKE_GROUP} 기대 ${INTAKE_IDS}건 / 실측 ${intakeRows.length}건`);
+  }
+  if (otherRows.length !== REMAINING_IDS) {
+    problems.push(`intake-split: 제외 후 나머지 기대 ${REMAINING_IDS}건 / 실측 ${otherRows.length}건`);
+  }
+  const overlap = remainingIds.filter((id) => intakeIds.includes(id));
+  if (overlap.length > 0) problems.push(`intake-split: 제외 대상이 남은 묶음에도 있다 (${overlap.slice(0, 3).join(' | ')})`);
+  if (new Set(remainingIds).size !== remainingIds.length) {
+    problems.push(`intake-split: 제외 후 90건에 id 중복이 있다`);
+  }
+
+  const intakeCard = REPAIR_CARDS_BY_GROUP[INTAKE_GROUP]!;
+  const wrongCard = rows.filter((row) => row.repair_card !== repairCardFor(row.group, row.owner));
+  if (wrongCard.length > 0) {
+    problems.push(
+      `repair-card: 묶음·주인에서 유도한 칸 이름과 다른 행 ${wrongCard.length}건 (no ${wrongCard.slice(0, 4).map((row) => row.no).join(',')})`,
+    );
+  }
+  const repair = sortedTally(rows.map((row) => row.repair_card));
+  const onIntakeCard = rows.filter((row) => row.repair_card === intakeCard);
+  if (onIntakeCard.length !== INTAKE_IDS) {
+    problems.push(`repair-card: ${intakeCard} 기대 ${INTAKE_IDS}건 / 실측 ${onIntakeCard.length}건`);
+  }
+  const afterIntakeCard = rows.filter((row) => row.repair_card !== intakeCard);
+  if (afterIntakeCard.length !== REMAINING_IDS) {
+    problems.push(`repair-card: ${intakeCard} 제외 후 기대 ${REMAINING_IDS}건 / 실측 ${afterIntakeCard.length}건`);
+  }
+
+  const status = sortedTally(rows.map((row) => row.status));
+  if (!sameTally(status, EXPECTED_STATUS)) {
+    problems.push(`status-totals: 기대 ${JSON.stringify(EXPECTED_STATUS)} / 실측 ${JSON.stringify(status)}`);
+  }
+  const group = sortedTally(rows.map((row) => row.group));
+  if (!sameTally(group, EXPECTED_GROUP)) {
+    problems.push(`group-totals: 기대 ${JSON.stringify(EXPECTED_GROUP)} / 실측 ${JSON.stringify(group)}`);
+  }
+
+  const acpAttributed = rows.filter((row) => [row.evidence, row.root_cause, row.repro_command].some((cell) => cell.includes(NO_ACP_MARKER)));
+  if (acpAttributed.length > 0) {
+    problems.push(`no-acp-exclusion: \`${NO_ACP_MARKER}\` 로그 사건을 실패 ID로 센 행 ${acpAttributed.length}건 (${acpAttributed.map((row) => row.no).join(',')})`);
+  }
+
+  const blankCells: string[] = [];
+  const deletionProposals: string[] = [];
+  for (const row of rows) {
+    for (const field of REQUIRED_FIELDS) {
+      if (row[field].trim().length === 0) blankCells.push(`${row.no}.${field}`);
+    }
+    if (row.replacement_contract_if_deleted.trim().length === 0) blankCells.push(`${row.no}.replacement_contract_if_deleted`);
+    else if (!row.replacement_contract_if_deleted.includes(NO_DELETION_PROPOSAL)) deletionProposals.push(row.no);
+  }
+  if (blankCells.length > 0) problems.push(`evidence-completeness: 빈 칸 ${blankCells.length}개 (${blankCells.slice(0, 6).join(',')})`);
+  if (deletionProposals.length > 0) {
+    problems.push(`no-test-deletion-proposed: 근거 없이 시험 삭제를 제안한 행 ${deletionProposals.length}건 (${deletionProposals.slice(0, 6).join(',')})`);
+  }
+
+  if (!input.reportText.includes('## 90건 후속 조사와 남은 수리 칸')) {
+    problems.push('report-follow-up: 90건 후속 조사·상태·주인 근거 절이 없다');
+  }
+
+  const index = parseReportIndex(input.reportText);
+  if (index.length !== rows.length) {
+    problems.push(`report-index-parity: 보고서 색인 ${index.length}행 / TSV ${rows.length}행`);
+  } else {
+    const mismatched = rows.filter((row, at) => {
+      const entry = index[at]!;
+      return entry.no !== at + 1 || entry.test_id !== row.test_id || entry.group !== row.group || entry.status !== row.status || entry.owner !== row.owner;
+    });
+    if (mismatched.length > 0) {
+      problems.push(`report-index-parity: TSV와 어긋난 색인 행 ${mismatched.length}건 (no ${mismatched.slice(0, 4).map((row) => row.no).join(',')})`);
+    }
+  }
+
+  const declared = parseReportCounts(input.reportText);
+  if (!declared) {
+    problems.push('report-counts: 보고서에 `총 N건 = provider-intake M건 … 나머지 K건` 선언이 없다');
+  } else if (declared.total !== rows.length || declared.intake !== intakeRows.length || declared.remaining !== otherRows.length) {
+    problems.push(
+      `report-counts: 보고서 선언 ${declared.total}/${declared.intake}/${declared.remaining} / 실측 ${rows.length}/${intakeRows.length}/${otherRows.length}`,
+    );
+  }
+  const declaredRepair = parseReportRepairCards(input.reportText);
+  if (Object.keys(declaredRepair).length === 0) {
+    problems.push('report-repair-parity: 보고서에 수리 칸 표(`| `GATE-0226-…` | N |`)가 없다');
+  } else if (!sameTally(declaredRepair, repair)) {
+    problems.push(`report-repair-parity: 보고서 선언 ${JSON.stringify(declaredRepair)} / 실측 ${JSON.stringify(repair)}`);
+  }
+  if (!input.reportText.includes(NO_ACP_MARKER) || !input.reportText.includes(`${ACP_LOG_EVENTS}회`) || !input.reportText.includes('겹침은 0건')) {
+    problems.push(`report-counts: 보고서가 \`${NO_ACP_MARKER}\` ${ACP_LOG_EVENTS}회 · 겹침 0건 배제를 명시하지 않는다`);
+  }
+
+  let remainingBaseline: CensusAudit['remainingBaseline'];
+  if (input.remainingBaselineIds === null) {
+    problems.push(`remaining-baseline: 고정 기준 파일이 없다 (${input.remainingBaselinePath})`);
+    remainingBaseline = { path: input.remainingBaselinePath, status: 'failed', ids: 0 };
+  } else {
+    const baselineIds = input.remainingBaselineIds;
+    const baseline = new Set(baselineIds);
+    const actual = new Set(remainingIds);
+    const missing = [...baseline].filter((id) => !actual.has(id));
+    const extra = [...actual].filter((id) => !baseline.has(id));
+    if (baseline.size !== REMAINING_IDS || baseline.size !== baselineIds.length) {
+      problems.push(`remaining-baseline: 고정 기준은 중복 없이 ${REMAINING_IDS} ID여야 한다 (행 ${baselineIds.length} / 고유 ${baseline.size})`);
+    }
+    if (missing.length > 0 || extra.length > 0 || baseline.size !== actual.size) {
+      problems.push(`remaining-baseline: 기준 ${baseline.size}건 / TSV ${actual.size}건 · 누락 ${missing.length}${missing.length ? ` (${missing.slice(0, 3).join(' | ')})` : ''} · 추가 ${extra.length}${extra.length ? ` (${extra.slice(0, 3).join(' | ')})` : ''}`);
+      remainingBaseline = { path: input.remainingBaselinePath, status: 'failed', ids: baseline.size };
+    } else {
+      remainingBaseline = { path: input.remainingBaselinePath, status: 'compared', ids: baseline.size };
+    }
+  }
+
+  let ledger: CensusAudit['ledger'];
+  if (input.acceptedIds === null) {
+    if (input.ledgerRequired) {
+      problems.push(`accepted-ledger: 원장 파일이 없다 (${input.ledgerPath})`);
+      ledger = { path: input.ledgerPath, status: 'failed', ids: 0 };
+    } else {
+      ledger = { path: input.ledgerPath, status: 'skipped', ids: 0 };
+    }
+  } else {
+    const accepted = new Set(input.acceptedIds);
+    const missing = ids.filter((id) => !accepted.has(id));
+    const extra = [...accepted].filter((id) => !uniqueIds.has(id));
+    if (missing.length > 0 || extra.length > 0 || accepted.size !== rows.length) {
+      problems.push(`accepted-ledger: 원장 ${accepted.size}건 / TSV ${rows.length}건 · 누락 ${missing.length} · 여분 ${extra.length}`);
+      ledger = { path: input.ledgerPath, status: 'failed', ids: accepted.size };
+    } else {
+      ledger = { path: input.ledgerPath, status: 'compared', ids: accepted.size };
+    }
+  }
+
+  return {
+    ok: problems.length === 0,
+    problems,
+    counts: { rows: rows.length, intake: intakeRows.length, remaining: otherRows.length, status, group, repair },
+    intakeIds,
+    remainingIds,
+    acpLogEvents: acpAttributed.length,
+    ledger,
+    remainingBaseline,
+  };
+}
+
+export function renderText(audit: CensusAudit): string {
+  const lines: string[] = [];
+  lines.push(`rows: ${audit.counts.rows} (${INTAKE_GROUP} ${audit.counts.intake} excluded → ${audit.counts.remaining})`);
+  lines.push(`group: ${Object.entries(audit.counts.group).map(([key, value]) => `${key}=${value}`).join(' ')}`);
+  lines.push(`status: ${Object.entries(audit.counts.status).map(([key, value]) => `${key}=${value}`).join(' ')}`);
+  lines.push(`repair-cards: ${Object.entries(audit.counts.repair).map(([key, value]) => `${key}=${value}`).join(' ')}`);
+  lines.push(`no-acp: ${audit.acpLogEvents} (로그 ${ACP_LOG_EVENTS}회 사건은 실패 ID가 아니다)`);
+  lines.push(`accepted-ledger: ${audit.ledger.status} ${audit.ledger.path}${audit.ledger.status === 'skipped' ? ' (원장 부재 — 원장 대조 미실시)' : ''}`);
+  lines.push(`remaining-baseline: ${audit.remainingBaseline.status} ${audit.remainingBaseline.path} (${audit.remainingBaseline.ids})`);
+  for (const problem of audit.problems) lines.push(`FAIL ${problem}`);
+  lines.push(audit.ok ? 'census: PASS' : `census: FAIL (${audit.problems.length})`);
+  return lines.join('\n');
+}
+
+type CliOptions = {
+  tsv: string;
+  report: string;
+  accepted: string | null;
+  acceptedExplicit: boolean;
+  json: boolean;
+  writeRepairCard: boolean;
+};
+
+function parseArgs(argv: string[], cwd: string): CliOptions {
+  const options: CliOptions = {
+    tsv: resolve(cwd, CENSUS_TSV),
+    report: resolve(cwd, CENSUS_REPORT),
+    accepted: join(homedir(), DEFAULT_ACCEPTED),
+    acceptedExplicit: false,
+    json: false,
+    writeRepairCard: false,
+  };
+  for (let at = 0; at < argv.length; at += 1) {
+    const arg = argv[at]!;
+    const next = argv[at + 1];
+    if (arg === '--tsv' && next) {
+      options.tsv = resolve(cwd, next);
+      at += 1;
+    } else if (arg === '--report' && next) {
+      options.report = resolve(cwd, next);
+      at += 1;
+    } else if (arg === '--accepted' && next) {
+      options.acceptedExplicit = true;
+      options.accepted = next === 'none' ? null : resolve(cwd, next);
+      at += 1;
+    } else if (arg === '--json') {
+      options.json = true;
+    } else if (arg === '--write-repair-card') {
+      options.writeRepairCard = true;
+    } else {
+      throw new Error(`알 수 없는 인자: ${arg}`);
+    }
+  }
+  return options;
+}
+
+export function main(argv: string[] = process.argv.slice(2), cwd: string = process.cwd()): number {
+  let options: CliOptions;
+  try {
+    options = parseArgs(argv, cwd);
+  } catch (error) {
+    console.error(String(error instanceof Error ? error.message : error));
+    return 2;
+  }
+  for (const path of [options.tsv, options.report]) {
+    if (!existsSync(path)) {
+      console.error(`FAIL inputs: 필수 파일이 없다 — ${path}`);
+      return 2;
+    }
+  }
+  if (options.writeRepairCard) {
+    const rewritten = writeRepairCards(options.tsv);
+    process.stdout.write(`repair-card: ${rewritten}행 재계산 → ${options.tsv}\n`);
+  }
+  const acceptedIds = options.accepted ? readAcceptedIds(options.accepted) : null;
+  const remainingBaselinePath = resolve(cwd, DEFAULT_REMAINING_BASELINE);
+  const remainingBaselineIds = existsSync(remainingBaselinePath)
+    ? readFileSync(remainingBaselinePath, 'utf8').split(/\r?\n/).filter((line) => line.length > 0 && !line.startsWith('#'))
+    : null;
+  const audit = auditCensus({
+    tsvText: readFileSync(options.tsv, 'utf8'),
+    reportText: readFileSync(options.report, 'utf8'),
+    acceptedIds,
+    remainingBaselineIds,
+    remainingBaselinePath: DEFAULT_REMAINING_BASELINE,
+    ledgerPath: options.accepted ?? 'none',
+    ledgerRequired: options.acceptedExplicit && options.accepted !== null,
+  });
+  process.stdout.write(`${options.json ? JSON.stringify(audit, null, 2) : renderText(audit)}\n`);
+  return audit.ok ? 0 : 1;
+}
+
+if (import.meta.main) {
+  process.exit(main());
+}