@momentiq/dark-factory-cli 0.1.0-alpha.4

package/dist/cli.js

@@ -0,0 +1,581 @@
+#!/usr/bin/env node
+// Dark Factory CLI entrypoint.
+//
+// Phase B shipped the underlying services (Critic Orchestrator, Policy
+// Engine, Trusted-Surface Rebind) as a library + a stub binary.
+//
+// Phase C extended the binary with four subcommands that wrap the
+// Python-backed services extracted in cycle 331.1 Phase C:
+//
+//   df validate-cycle-doc          — service #5 (cycle-doc trailer validator)
+//   df audit-branch-protection     — service #7 (branch-protection drift detector)
+//   df sync-trackers               — service #9 part A (cycle tracker sync)
+//   df attribute-pr                — service #9 part B (PR -> Cycle Ref attribution)
+//
+// Phase D (this file's additions) ships two more pure-TS subcommands:
+//
+//   df audit stats [--path <NDJSON>]   — service #8 (read/summarize _runs.ndjson)
+//   df admit-pr --files-stdin          — service #6 plan-vs-code classifier
+//
+// Phase F upgrades two stubs to real implementations:
+//
+//   df status-check                    — sentinel aggregator (exit 0).
+//   df critic [--ref <gitref>]         — real Critic Orchestrator via
+//                                        runReview() + 4 vendor adapters.
+//
+// The remaining subcommands listed in --help (review, gate, doctor) land
+// in Phase G or later. For now they print a "not implemented" message
+// and exit 2.
+//
+// Argument parsing is intentionally minimal — every flag after a Phase C
+// subcommand is passed through to the wrapped Python script verbatim.
+// The Python scripts already have argparse-based help; consumers invoke
+// `df validate-cycle-doc --help` to get the full flag list. Phase D
+// subcommands accept their own flags directly (see `cmdAudit` and
+// `cmdAdmitPr` below).
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { runValidateCycleDoc } from "./cycle-doc-validator/index.js";
+import { runAuditBranchProtection } from "./branch-protection/index.js";
+import { runSyncCycleTrackers, runAttributePrCycleRef, } from "./cycle-tracker-sync/index.js";
+import { FileTelemetrySink, readTelemetryEvents, summarizeTelemetry, computeQuorumStats, computeCriticAgreement, } from "./evidence/audit-trail.js";
+import { classifyPrKindFromFiles } from "./policy/merge-queue.js";
+import { AdapterRegistry } from "./adapters/critic.js";
+import { CursorSdkAdapter } from "./adapters/cursor-sdk.js";
+import { CodexSdkAdapter } from "./adapters/codex-sdk.js";
+import { GeminiSdkAdapter } from "./adapters/gemini-sdk.js";
+import { GrokDirectSdkAdapter } from "./adapters/grok-direct-sdk.js";
+import { loadAgentReviewConfig } from "./policy/config.js";
+import { runReview } from "./runner.js";
+import { resolveArtifactDir, telemetryPath } from "./paths.js";
+function readPackageMeta() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        // dist/cli.js → ../package.json
+        const pkgPath = resolve(here, "..", "package.json");
+        const raw = readFileSync(pkgPath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function printHelp(meta) {
+    const name = meta.name ?? "@momentiq/dark-factory-cli";
+    const version = meta.version ?? "unknown";
+    process.stdout.write([
+        `${name} v${version}`,
+        "",
+        "Dark Factory OSS CLI — multi-vendor adversarial critic orchestration.",
+        "",
+        "Usage:",
+        "  df --version              Print version and exit",
+        "  df --help                 Print this help and exit",
+        "",
+        "Subcommands (Phase C — services #5/#7/#9):",
+        "  df validate-cycle-doc       Validate a PR's Cycle:/Issue:/ProjectItem: trailers",
+        "  df audit-branch-protection  Detect drift between spec.yaml and live GH ruleset",
+        "  df sync-trackers            Reconcile GitHub tracker issues with cycle docs",
+        "  df attribute-pr             Write PR's Cycle: trailer into project board's Cycle Ref field",
+        "",
+        "Subcommands (Phase D — services #6/#8):",
+        "  df audit stats              Summarize the _runs.ndjson audit trail (service #8)",
+        "  df admit-pr                 Classify a PR as plan vs code (service #6)",
+        "",
+        "Subcommands (Phase F — reusable-workflow gates, dogfood-wired):",
+        "  df status-check             Sentinel aggregator (PR Status Check gate).",
+        "                              Exits 0 — merge queue is the real aggregator.",
+        "  df critic                   Real Critic Orchestrator wiring (agent-critic",
+        "                              gate). Loads .agent-review/config.json, runs",
+        "                              the 4 vendor adapters via runReview, writes",
+        "                              aggregate verdict to .git/agent-reviews/<sha>.",
+        "                              Degrades-and-passes on any error (exit 0).",
+        "",
+        "Subcommands (coming in cycle 331.1 Phase G+):",
+        "  df review                 Run the multi-critic review for the current commit",
+        "  df gate                   Evaluate gate verdict for the current commit",
+        "  df doctor                 Diagnose installation, env, and config",
+        "",
+        "Each Phase C subcommand passes its remaining argv through to the bundled",
+        "Python script verbatim; run `df <subcommand> --help` for full flags.",
+        "Phase D subcommands parse flags directly — see `df audit --help` and",
+        "`df admit-pr --help`. Phase F's `df critic` accepts --ref/--config/--cwd",
+        "(see `df critic --help`); status-check accepts no flags. Both subcommands",
+        "exit 0 even on failure so the reusable workflows do not block the merge",
+        "queue on a single vendor flake — vendor errors register in the artifact",
+        "as `status=error` and the configured min-complete-quorum policy decides",
+        "the aggregate verdict.",
+        "",
+        "System requirements:",
+        "  Node.js >=20",
+        "  python3 (>=3.11)",
+        "  gh CLI (authenticated) for service #5/#7/#9 GitHub API calls",
+        "  git on PATH",
+        "",
+        "Library usage today:",
+        "  import { runReview, evaluateCommitGate, buildReviewPacket }",
+        `    from \"${name}\";`,
+        "",
+        "Status: 0.1.0-alpha.4 — Phase F wires the real Critic Orchestrator",
+        "        and dogfoods dark-factory on its own PRs. Reusable workflows",
+        "        from Phase E now invoke real critic logic. The substrate",
+        "        validates itself end-to-end.",
+        "        Pure-TS port of #5/#7/#9 tracked as Phase C-PORT follow-up.",
+        "",
+        "Docs:   https://github.com/momentiq-ai/dark-factory",
+        "",
+    ].join("\n"));
+}
+function printVersion(meta) {
+    process.stdout.write(`${meta.version ?? "unknown"}\n`);
+}
+function notImplemented(sub) {
+    process.stderr.write(`df: subcommand "${sub}" is not implemented in this alpha build.\n` +
+        `    Phase B/C/D ship services as library + Python-wrapped subcommands;\n` +
+        `    Phase E added reusable workflow stubs (status-check, critic);\n` +
+        `    Phase F upgraded both to real implementations;\n` +
+        `    "${sub}" lands in Phase G or later (see \`df --help\`).\n`);
+    return 2;
+}
+async function runPhaseCSubcommand(sub, rest) {
+    // Each Phase C subcommand inherits stdio so user sees Python output
+    // live (logs, progress, structured GHA `::error::` lines).
+    switch (sub) {
+        case "validate-cycle-doc": {
+            const result = await runValidateCycleDoc({ args: rest, inheritStdio: true });
+            return result.exitCode;
+        }
+        case "audit-branch-protection": {
+            const result = await runAuditBranchProtection({ args: rest, inheritStdio: true });
+            return result.exitCode;
+        }
+        case "sync-trackers": {
+            const result = await runSyncCycleTrackers({ args: rest, inheritStdio: true });
+            return result.exitCode;
+        }
+        case "attribute-pr": {
+            const result = await runAttributePrCycleRef({ args: rest, inheritStdio: true });
+            return result.exitCode;
+        }
+        default:
+            // Unreachable — caller guarantees `sub` is one of the cases above.
+            return notImplemented(sub);
+    }
+}
+const PHASE_C_SUBCOMMANDS = new Set([
+    "validate-cycle-doc",
+    "audit-branch-protection",
+    "sync-trackers",
+    "attribute-pr",
+]);
+const PHASE_D_SUBCOMMANDS = new Set(["audit", "admit-pr"]);
+// Phase F upgrades two reusable-workflow handlers from stubs (Phase E) to
+// real implementations:
+//
+//   - `status-check` stays thin: a sentinel aggregator. The merge queue's
+//     ALLGREEN rule already does the real cross-check aggregation; this
+//     subcommand exists for the `PR Status Check` ruleset context.
+//
+//   - `critic` is now wired to the real Critic Orchestrator (Phase B
+//     extraction). It loads `.agent-review/config.json`, instantiates
+//     the 4 vendor adapters, runs `runReview()`, and writes the
+//     aggregate artifact. Degrades-and-passes on any error so the
+//     dogfood gate stays green while operators triage upstream issues.
+const PHASE_F_SUBCOMMANDS = new Set(["status-check", "critic"]);
+function cmdStatusCheck(_rest) {
+    // PR Status Check is a sentinel aggregator. As cycle 331.1 Phase E
+    // documents in `.github/workflows/pr-status-check.yml`, this gate is
+    // present specifically to satisfy the `PR Status Check` ruleset context
+    // — its passage means "the workflow itself reached this step", which
+    // is the contract every other status check separately enforces. There
+    // is no useful aggregation work to do here that the merge queue's
+    // `ALLGREEN` rule doesn't already do. So we keep this thin: emit a
+    // structured one-liner and exit 0.
+    //
+    // A richer aggregator (querying the GitHub Actions API for sibling
+    // check results) was considered for Phase F; deferred as gold-plating
+    // because the merge queue already provides that semantics with
+    // stronger guarantees (it sees the actual rerun state, not a snapshot).
+    process.stdout.write("df status-check: sentinel-pass (cycle 331.1 Phase F) — merge queue is the real aggregator.\n");
+    return 0;
+}
+function parseCriticArgs(rest) {
+    const { flags } = parseFlags(rest);
+    const ref = typeof flags["ref"] === "string"
+        ? flags["ref"]
+        : typeof flags["pr"] === "string"
+            ? "HEAD"
+            : "HEAD";
+    const out = { ref };
+    if (typeof flags["config"] === "string") {
+        out.configPath = flags["config"];
+    }
+    if (typeof flags["cwd"] === "string") {
+        out.cwd = flags["cwd"];
+    }
+    return out;
+}
+function buildDefaultAdapterRegistry() {
+    // Each adapter reads its API key from the corresponding env var by
+    // default (CURSOR_API_KEY / CODEX_API_KEY / GEMINI_API_KEY /
+    // XAI_API_KEY). Missing keys cause the adapter's `review()` to
+    // return `status="error"` rather than throw at registry-init time —
+    // exactly the behavior min-complete-quorum needs to degrade
+    // gracefully.
+    const registry = new AdapterRegistry();
+    registry.register(new CursorSdkAdapter());
+    registry.register(new CodexSdkAdapter());
+    registry.register(new GeminiSdkAdapter());
+    registry.register(new GrokDirectSdkAdapter());
+    return registry;
+}
+async function cmdCritic(rest) {
+    if (rest.includes("--help") || rest.includes("-h")) {
+        process.stdout.write([
+            "df critic — run the multi-vendor adversarial critic against HEAD",
+            "",
+            "Usage:",
+            "  df critic [--ref <gitref>] [--config <path>] [--cwd <path>]",
+            "",
+            "Reads .agent-review/config.json (or --config <path>), instantiates",
+            "the configured vendor adapters, runs the critics against the named",
+            "git ref (default HEAD), and writes the aggregate verdict + per-",
+            "critic findings to `.git/agent-reviews/<sha>.json` (path comes",
+            "from the loaded config's git.artifactDir).",
+            "",
+            "Environment:",
+            "  CURSOR_API_KEY / CODEX_API_KEY / GEMINI_API_KEY / XAI_API_KEY",
+            "    Vendor critic API keys. Missing keys cause the corresponding",
+            "    critic to register as `status=error` (non-blocking under the",
+            "    default min-complete-quorum policy).",
+            "",
+            "Exit code:",
+            "  Always 0 in this build — vendor / config errors are surfaced",
+            "  on stderr with a [critic-degraded] prefix. The aggregate gate",
+            "  verdict is written to the artifact file regardless.",
+            "",
+        ].join("\n"));
+        return 0;
+    }
+    const opts = parseCriticArgs(rest);
+    try {
+        const loaded = await loadAgentReviewConfig({
+            ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+        });
+        const registry = buildDefaultAdapterRegistry();
+        // Wire a file telemetry sink so the run lands in
+        // `.git/agent-reviews/_runs.ndjson` (the same path `df audit stats`
+        // reads). This is dogfood proof: the substrate exercises its own
+        // audit trail on its own PRs.
+        const artifactDir = await resolveArtifactDir(loaded);
+        const sink = new FileTelemetrySink(telemetryPath(artifactDir));
+        const outcome = await runReview({
+            loaded,
+            registry,
+            ref: opts.ref,
+            telemetry: sink,
+        });
+        const verdict = outcome.artifact.gateVerdict ?? "(no verdict)";
+        const reviewedSha = outcome.artifact.commit;
+        const findingCount = outcome.artifact.criticResults.reduce((acc, r) => acc + r.findings.length, 0);
+        const criticSummaries = outcome.artifact.criticResults
+            .map((r) => `    ${r.criticId}: ${r.status}` +
+            (r.verdict ? ` (${r.verdict})` : "") +
+            ` — findings=${r.findings.length}`)
+            .join("\n");
+        process.stdout.write([
+            `df critic: review complete for ${reviewedSha}`,
+            `  verdict: ${verdict}`,
+            `  total findings: ${findingCount}`,
+            `  per-critic:`,
+            criticSummaries,
+            `  artifact: ${outcome.paths.jsonPath}`,
+            "",
+        ].join("\n"));
+        return 0;
+    }
+    catch (err) {
+        // Degrade-and-pass. See the design comment above the function.
+        process.stderr.write([
+            "[critic-degraded] df critic failed before completing a review.",
+            `[critic-degraded] cause: ${err.message}`,
+            "[critic-degraded] exiting 0 so the dogfood gate stays green. Operators:",
+            "[critic-degraded]   - check .agent-review/config.json exists at repo root",
+            "[critic-degraded]   - check vendor API keys are exported (CURSOR_API_KEY etc.)",
+            "[critic-degraded]   - check the worktree's .git/agent-reviews/ is writable",
+            "[critic-degraded]   - inspect upstream logs for stack trace context",
+            "",
+        ].join("\n"));
+        return 0;
+    }
+}
+// ---------------------------------------------------------------------------
+// Phase D: `df audit stats` — service #8 (audit/compliance trail).
+//
+// Reads the `_runs.ndjson` file (path supplied via `--path`, or default
+// resolved via `--git-dir` heuristic, or as a last resort the local
+// `.git/agent-reviews/_runs.ndjson`) and emits the same operator-
+// friendly summary that sage3c's `make agent-review-stats` produced.
+//
+// The default-path resolution chain is deliberately conservative:
+// without a Phase E config-loader, the CLI cannot reliably discover
+// the consumer's artifact dir from inside an arbitrary worktree, so
+// we surface a clear error when nothing was found rather than
+// silently scanning the wrong path.
+// ---------------------------------------------------------------------------
+function parseFlags(rest) {
+    const flags = {};
+    const positional = [];
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i] ?? "";
+        if (a.startsWith("--")) {
+            const eq = a.indexOf("=");
+            if (eq >= 0) {
+                flags[a.slice(2, eq)] = a.slice(eq + 1);
+            }
+            else {
+                const next = rest[i + 1];
+                if (next !== undefined && !next.startsWith("--")) {
+                    flags[a.slice(2)] = next;
+                    i++;
+                }
+                else {
+                    flags[a.slice(2)] = true;
+                }
+            }
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    return { flags, positional };
+}
+function cmdAuditHelp() {
+    process.stdout.write([
+        "df audit — operate on the _runs.ndjson audit trail (service #8)",
+        "",
+        "Usage:",
+        "  df audit stats [--path <PATH>]    Summarize the audit trail",
+        "  df audit --help                   Show this help",
+        "",
+        "Defaults:",
+        "  --path defaults to `<repo>/.git/agent-reviews/_runs.ndjson` when",
+        "         present; otherwise the command exits with a clear error.",
+        "",
+    ].join("\n"));
+}
+function cmdAudit(rest) {
+    if (rest.includes("--help") || rest.includes("-h")) {
+        cmdAuditHelp();
+        return 0;
+    }
+    const action = rest[0] ?? "";
+    if (action !== "stats") {
+        process.stderr.write(`df audit: unknown action "${action}". Run \`df audit --help\` for usage.\n`);
+        return 2;
+    }
+    const { flags } = parseFlags(rest.slice(1));
+    let path = typeof flags["path"] === "string" ? flags["path"] : undefined;
+    if (!path) {
+        const defaultPath = resolve(process.cwd(), ".git", "agent-reviews", "_runs.ndjson");
+        if (existsSync(defaultPath)) {
+            path = defaultPath;
+        }
+    }
+    if (!path) {
+        process.stderr.write("df audit stats: no audit trail found. Pass --path <PATH> or run inside a repo with a `.git/agent-reviews/_runs.ndjson` file.\n");
+        return 1;
+    }
+    const events = readTelemetryEvents(path);
+    const stats = summarizeTelemetry(events);
+    process.stdout.write(`df audit stats (${path})\n`);
+    process.stdout.write(`  total runs:        ${stats.totalRuns}\n`);
+    process.stdout.write(`  errored runs:      ${stats.errorRuns}\n`);
+    process.stdout.write(`  approved verdicts: ${stats.approvedCount}\n`);
+    process.stdout.write(`  changes requested: ${stats.changesRequestedCount}\n`);
+    process.stdout.write(`  gate passes:       ${stats.passes}\n`);
+    process.stdout.write(`  gate blocks:       ${stats.blocks}\n`);
+    process.stdout.write(`  gate bypasses:     ${stats.bypasses}\n`);
+    process.stdout.write(`  median run ms:     ${stats.medianDurationMs ?? "n/a"}\n`);
+    const retry = stats.retry;
+    const retryActivity = retry.totalRetryAttempts +
+        retry.oneRetrySuccess +
+        retry.twoPlusRetrySuccess +
+        Object.values(retry.exhaustedByErrorCode).reduce((a, b) => a + b, 0);
+    if (retryActivity > 0) {
+        process.stdout.write(`  retry summary:\n`);
+        process.stdout.write(`    first-attempt success: ${retry.firstAttemptSuccess}\n`);
+        process.stdout.write(`    1-retry success:       ${retry.oneRetrySuccess}\n`);
+        process.stdout.write(`    2+-retry success:      ${retry.twoPlusRetrySuccess}\n`);
+        process.stdout.write(`    total retry attempts:  ${retry.totalRetryAttempts}\n`);
+        const codes = Object.entries(retry.exhaustedByErrorCode);
+        if (codes.length > 0) {
+            process.stdout.write(`    exhausted by error code:\n`);
+            codes
+                .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+                .forEach(([code, n]) => process.stdout.write(`      ${code}: ${n}\n`));
+        }
+    }
+    for (const [id, c] of Object.entries(stats.byCritic)) {
+        process.stdout.write(`  critic ${id}: starts=${c.starts} finishes=${c.finishes} errors=${c.errors} approved=${c.approved} blocks=${c.totalBlockers} highs=${c.totalHigh}\n`);
+    }
+    const agreement = computeCriticAgreement(events);
+    if (agreement.comparedCommits > 0) {
+        const pct = Math.round((agreement.agreedCommits / agreement.comparedCommits) * 100);
+        process.stdout.write(`  multi-critic agreement: ${agreement.agreedCommits}/${agreement.comparedCommits} = ${pct}% (critics: ${agreement.comparedCriticIds.join(", ")})\n`);
+        const disagreements = Object.entries(agreement.disagreementsByPattern);
+        if (disagreements.length > 0) {
+            process.stdout.write(`  disagreements:\n`);
+            disagreements
+                .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+                .forEach(([pattern, n]) => process.stdout.write(`    ${pattern}: ${n}\n`));
+        }
+    }
+    const quorumStats = computeQuorumStats(events);
+    if (quorumStats.totalAggregateEvents > 0) {
+        process.stdout.write(`  quorum stats (${quorumStats.totalAggregateEvents} reviews):\n`);
+        const reasons = Object.entries(quorumStats.byReason);
+        reasons
+            .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+            .forEach(([reason, n]) => {
+            const pct = Math.round((n / quorumStats.totalAggregateEvents) * 100);
+            process.stdout.write(`    ${reason}: ${n} (${pct}%)\n`);
+        });
+        const culprits = Object.entries(quorumStats.quorumUnmetByCritic);
+        if (culprits.length > 0) {
+            process.stdout.write(`    would-be quorum_unmet by critic:\n`);
+            culprits
+                .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+                .forEach(([id, n]) => process.stdout.write(`      ${id}: ${n}\n`));
+        }
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Phase D: `df admit-pr` — service #6 plan-vs-code classifier.
+//
+// Classifies a PR's file list (passed via --files-stdin reading newline-
+// separated paths, or --files comma-separated for one-shot CLI) and
+// prints `plan` or `code` to stdout. Exit code is always 0 unless the
+// input cannot be parsed; this is a classifier, not a gate.
+//
+// Stdin form is preferred for CI integration:
+//   gh pr view 123 --json files --jq '.files[].path' | df admit-pr --files-stdin
+//
+// The lightweight CLI surface lets sage3c retire the inline bash
+// classifier in `.github/workflows/plan-pr-review-gate.yml` once Phase
+// E ships the reusable workflow.
+// ---------------------------------------------------------------------------
+function cmdAdmitPrHelp() {
+    process.stdout.write([
+        "df admit-pr — classify a PR as `plan` vs `code` (service #6)",
+        "",
+        "Usage:",
+        "  df admit-pr --files-stdin       Read newline-separated paths from stdin",
+        "  df admit-pr --files <a,b,c>     Comma-separated paths on the CLI",
+        "  df admit-pr --help              Show this help",
+        "",
+        "Output: `plan` or `code` on stdout, plus a one-line rationale on stderr.",
+        "",
+        "Classifier (ported from .github/workflows/plan-pr-review-gate.yml):",
+        "  - `plan` iff at least one file matches",
+        "    /docs/roadmap/cycles/cycleN[.M]-slug.md AND no file is outside docs/.",
+        "  - everything else is `code`.",
+        "",
+    ].join("\n"));
+}
+async function readStdinUtf8() {
+    return new Promise((res, rej) => {
+        let acc = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => {
+            acc += chunk;
+        });
+        process.stdin.on("end", () => res(acc));
+        process.stdin.on("error", (err) => rej(err));
+    });
+}
+async function cmdAdmitPr(rest) {
+    if (rest.includes("--help") || rest.includes("-h")) {
+        cmdAdmitPrHelp();
+        return 0;
+    }
+    const { flags } = parseFlags(rest);
+    let paths = [];
+    if (flags["files-stdin"]) {
+        const raw = await readStdinUtf8();
+        paths = raw
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0);
+    }
+    else if (typeof flags["files"] === "string") {
+        paths = flags["files"]
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+    }
+    else {
+        process.stderr.write("df admit-pr: pass --files-stdin (newline-separated stdin) or --files a,b,c. Run --help for usage.\n");
+        return 2;
+    }
+    if (paths.length === 0) {
+        process.stderr.write("df admit-pr: empty file list — cannot classify. Classifying as `code` (default-upward).\n");
+        process.stdout.write("code\n");
+        return 0;
+    }
+    const kind = classifyPrKindFromFiles(paths);
+    process.stderr.write(`df admit-pr: classified ${paths.length} file(s) as ${kind}.\n`);
+    process.stdout.write(`${kind}\n`);
+    return 0;
+}
+async function main(argv) {
+    const meta = readPackageMeta();
+    const args = argv.slice(2);
+    if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+        // Top-level --help/-h. Subcommand --help is forwarded to the Python
+        // script via the rest-args pass-through.
+        if (args.length === 0) {
+            printHelp(meta);
+            return 0;
+        }
+        // If a subcommand is present alongside --help, forward to Python.
+        const sub0 = args[0] ?? "";
+        if (!PHASE_C_SUBCOMMANDS.has(sub0) &&
+            !PHASE_D_SUBCOMMANDS.has(sub0) &&
+            !PHASE_F_SUBCOMMANDS.has(sub0)) {
+            printHelp(meta);
+            return 0;
+        }
+    }
+    if (args.length > 0 && (args[0] === "--version" || args[0] === "-V")) {
+        printVersion(meta);
+        return 0;
+    }
+    const sub = args[0] ?? "";
+    const rest = args.slice(1);
+    if (PHASE_C_SUBCOMMANDS.has(sub)) {
+        return runPhaseCSubcommand(sub, rest);
+    }
+    if (sub === "audit") {
+        return cmdAudit(rest);
+    }
+    if (sub === "admit-pr") {
+        return cmdAdmitPr(rest);
+    }
+    if (sub === "status-check") {
+        return cmdStatusCheck(rest);
+    }
+    if (sub === "critic") {
+        return await cmdCritic(rest);
+    }
+    return notImplemented(sub);
+}
+main(process.argv).then((code) => {
+    process.exitCode = code;
+}, (err) => {
+    process.stderr.write(`df: fatal: ${err.message}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,+BAA+B;AAC/B,EAAE;AACF,uEAAuE;AACvE,gEAAgE;AAChE,EAAE;AACF,kEAAkE;AAClE,2DAA2D;AAC3D,EAAE;AACF,8EAA8E;AAC9E,mFAAmF;AACnF,4EAA4E;AAC5E,qFAAqF;AACrF,EAAE;AACF,sEAAsE;AACtE,EAAE;AACF,kFAAkF;AAClF,4EAA4E;AAC5E,EAAE;AACF,sDAAsD;AACtD,EAAE;AACF,uEAAuE;AACvE,sEAAsE;AACtE,0EAA0E;AAC1E,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,cAAc;AACd,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,wEAAwE;AACxE,oEAAoE;AACpE,kEAAkE;AAClE,uBAAuB;AAEvB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAO/D,SAAS,eAAe;IACtB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,gCAAgC;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAiB;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,4BAA4B,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC;IAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;QACE,GAAG,IAAI,KAAK,OAAO,EAAE;QACrB,EAAE;QACF,uEAAuE;QACvE,EAAE;QACF,QAAQ;QACR,oDAAoD;QACpD,sDAAsD;QACtD,EAAE;QACF,4CAA4C;QAC5C,mFAAmF;QACnF,kFAAkF;QAClF,+EAA+E;QAC/E,8FAA8F;QAC9F,EAAE;QACF,yCAAyC;QACzC,mFAAmF;QACnF,0EAA0E;QAC1E,EAAE;QACF,iEAAiE;QACjE,2EAA2E;QAC3E,6EAA6E;QAC7E,6EAA6E;QAC7E,4EAA4E;QAC5E,2EAA2E;QAC3E,8EAA8E;QAC9E,0EAA0E;QAC1E,EAAE;QACF,+CAA+C;QAC/C,gFAAgF;QAChF,0EAA0E;QAC1E,oEAAoE;QACpE,EAAE;QACF,0EAA0E;QAC1E,sEAAsE;QACtE,sEAAsE;QACtE,0EAA0E;QAC1E,2EAA2E;QAC3E,yEAAyE;QACzE,yEAAyE;QACzE,yEAAyE;QACzE,wBAAwB;QACxB,EAAE;QACF,sBAAsB;QACtB,gBAAgB;QAChB,oBAAoB;QACpB,gEAAgE;QAChE,eAAe;QACf,EAAE;QACF,sBAAsB;QACtB,+DAA+D;QAC/D,cAAc,IAAI,KAAK;QACvB,EAAE;QACF,oEAAoE;QACpE,sEAAsE;QACtE,kEAAkE;QAClE,sCAAsC;QACtC,qEAAqE;QACrE,EAAE;QACF,qDAAqD;QACrD,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAiB;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,SAAS,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mBAAmB,GAAG,6CAA6C;QACjE,0EAA0E;QAC1E,qEAAqE;QACrE,sDAAsD;QACtD,QAAQ,GAAG,oDAAoD,CAClE,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,GAAW,EAAE,IAAc;IAC5D,oEAAoE;IACpE,2DAA2D;IAC3D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7E,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QACD,KAAK,yBAAyB,CAAC,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YAClF,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9E,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YAChF,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QACD;YACE,mEAAmE;YACnE,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,oBAAoB;IACpB,yBAAyB;IACzB,eAAe;IACf,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAE3D,0EAA0E;AAC1E,wBAAwB;AACxB,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,mEAAmE;AACnE,EAAE;AACF,qEAAqE;AACrE,sEAAsE;AACtE,gEAAgE;AAChE,kEAAkE;AAClE,uEAAuE;AACvE,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEhE,SAAS,cAAc,CAAC,KAAe;IACrC,mEAAmE;IACnE,qEAAqE;IACrE,wEAAwE;IACxE,qEAAqE;IACrE,sEAAsE;IACtE,kEAAkE;IAClE,mEAAmE;IACnE,mCAAmC;IACnC,EAAE;IACF,mEAAmE;IACnE,sEAAsE;IACtE,+DAA+D;IAC/D,wEAAwE;IACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8FAA8F,CAC/F,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAyCD,SAAS,eAAe,CAAC,IAAc;IACrC,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GACP,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ;QAC9B,CAAC,CAAE,KAAK,CAAC,KAAK,CAAY;QAC1B,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ;YAC/B,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,MAAM,CAAC;IACf,MAAM,GAAG,GAAkB,EAAE,GAAG,EAAE,CAAC;IACnC,IAAI,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;QACxC,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAW,CAAC;IAC7C,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;QACrC,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAW,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,2BAA2B;IAClC,mEAAmE;IACnE,6DAA6D;IAC7D,+DAA+D;IAC/D,oEAAoE;IACpE,4DAA4D;IAC5D,cAAc;IACd,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAc;IACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;YACE,kEAAkE;YAClE,EAAE;YACF,QAAQ;YACR,+DAA+D;YAC/D,EAAE;YACF,oEAAoE;YACpE,oEAAoE;YACpE,iEAAiE;YACjE,gEAAgE;YAChE,4CAA4C;YAC5C,EAAE;YACF,cAAc;YACd,iEAAiE;YACjE,kEAAkE;YAClE,kEAAkE;YAClE,0CAA0C;YAC1C,EAAE;YACF,YAAY;YACZ,gEAAgE;YAChE,iEAAiE;YACjE,uDAAuD;YACvD,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC;YACzC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC;QAE/C,iDAAiD;QACjD,oEAAoE;QACpE,iEAAiE;QACjE,8BAA8B;QAC9B,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,iBAAiB,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;QAE/D,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC;YAC9B,MAAM;YACN,QAAQ;YACR,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,IAAI,cAAc,CAAC;QAC/D,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CACxD,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EACnC,CAAC,CACF,CAAC;QACF,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa;aACnD,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM,EAAE;YAChC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACpC,eAAe,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CACrC;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;YACE,kCAAkC,WAAW,EAAE;YAC/C,cAAc,OAAO,EAAE;YACvB,qBAAqB,YAAY,EAAE;YACnC,eAAe;YACf,eAAe;YACf,eAAe,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE;YACvC,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,+DAA+D;QAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;YACE,gEAAgE;YAChE,4BAA6B,GAAa,CAAC,OAAO,EAAE;YACpD,yEAAyE;YACzE,2EAA2E;YAC3E,gFAAgF;YAChF,4EAA4E;YAC5E,qEAAqE;YACrE,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,mEAAmE;AACnE,EAAE;AACF,wEAAwE;AACxE,oEAAoE;AACpE,kEAAkE;AAClE,qEAAqE;AACrE,EAAE;AACF,kEAAkE;AAClE,oEAAoE;AACpE,oEAAoE;AACpE,8DAA8D;AAC9D,oCAAoC;AACpC,8EAA8E;AAE9E,SAAS,UAAU,CAAC,IAAc;IAChC,MAAM,KAAK,GAAqC,EAAE,CAAC;IACnD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBACZ,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACzB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjD,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;oBACzB,CAAC,EAAE,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;QACE,iEAAiE;QACjE,EAAE;QACF,QAAQ;QACR,+DAA+D;QAC/D,oDAAoD;QACpD,EAAE;QACF,WAAW;QACX,oEAAoE;QACpE,mEAAmE;QACnE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,IAAc;IAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,YAAY,EAAE,CAAC;QACf,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6BAA6B,MAAM,yCAAyC,CAC7E,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,IAAI,GACN,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAK,CAAC,MAAM,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;QACpF,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,GAAG,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gIAAgI,CACjI,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,CAAC;IACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;IAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;IAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,qBAAqB,IAAI,CAAC,CAAC;IAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,gBAAgB,IAAI,KAAK,IAAI,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,MAAM,aAAa,GACjB,KAAK,CAAC,kBAAkB;QACxB,KAAK,CAAC,eAAe;QACrB,KAAK,CAAC,mBAAmB;QACzB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;QAClF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;QAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;QAClF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,KAAK,CAAC,kBAAkB,IAAI,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACvD,KAAK;iBACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBACvD,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,YAAY,EAAE,YAAY,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC,QAAQ,WAAW,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC,QAAQ,WAAW,CAAC,CAAC,aAAa,UAAU,CAAC,CAAC,SAAS,IAAI,CACvJ,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,SAAS,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC,CAAC;QACpF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6BAA6B,SAAS,CAAC,aAAa,IAAI,SAAS,CAAC,eAAe,MAAM,GAAG,eAAe,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CACrJ,CAAC;QACF,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;QACvE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC3C,aAAa;iBACV,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBACvD,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,WAAW,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,WAAW,CAAC,oBAAoB,cAAc,CAAC,CAAC;QACxF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACrD,OAAO;aACJ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACvD,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,oBAAoB,CAAC,GAAG,GAAG,CAAC,CAAC;YACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QACL,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;QACjE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC/D,QAAQ;iBACL,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBACvD,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,8EAA8E;AAC9E,+DAA+D;AAC/D,EAAE;AACF,yEAAyE;AACzE,oEAAoE;AACpE,sEAAsE;AACtE,4DAA4D;AAC5D,EAAE;AACF,8CAA8C;AAC9C,iFAAiF;AACjF,EAAE;AACF,iEAAiE;AACjE,uEAAuE;AACvE,iCAAiC;AACjC,8EAA8E;AAE9E,SAAS,cAAc;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;QACE,8DAA8D;QAC9D,EAAE;QACF,QAAQ;QACR,2EAA2E;QAC3E,oEAAoE;QACpE,kDAAkD;QAClD,EAAE;QACF,0EAA0E;QAC1E,EAAE;QACF,qEAAqE;QACrE,0CAA0C;QAC1C,2EAA2E;QAC3E,gCAAgC;QAChC,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC9B,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,GAAG,IAAI,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAc;IACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,cAAc,EAAE,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;QAClC,KAAK,GAAG,GAAG;aACR,KAAK,CAAC,OAAO,CAAC;aACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;SAAM,IAAI,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC9C,KAAK,GAAI,KAAK,CAAC,OAAO,CAAY;aAC/B,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qGAAqG,CACtG,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2FAA2F,CAC5F,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,KAAK,CAAC,MAAM,eAAe,IAAI,KAAK,CAChE,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IAClC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,oEAAoE;QACpE,yCAAyC;QACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,kEAAkE;QAClE,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3B,IACE,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;YAC9B,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;YAC9B,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAC9B,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACrE,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3B,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;QAC3B,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CACrB,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,EACD,CAAC,GAAY,EAAE,EAAE;IACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAe,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CACF,CAAC"}

package/dist/cycle-doc-validator/index.d.ts

@@ -0,0 +1,43 @@
+export interface ValidateCycleDocOptions {
+    /** Extra argv passed to the Python script after the script path. */
+    readonly args?: ReadonlyArray<string>;
+    /**
+     * Working directory for the subprocess. Defaults to `process.cwd()`.
+     * The script uses cwd to locate the consumer's git toplevel.
+     */
+    readonly cwd?: string;
+    /**
+     * Override env vars merged into `process.env` for the subprocess. The
+     * wrapper always sets `DF_REPO_ROOT` if `repoRoot` is supplied.
+     */
+    readonly env?: NodeJS.ProcessEnv;
+    /**
+     * Explicit repo root. Set as `DF_REPO_ROOT` so the script bypasses
+     * `git rev-parse` resolution. Use when invoking outside a git
+     * worktree (rare; mostly for tests).
+     */
+    readonly repoRoot?: string;
+    /**
+     * Inherit stdio (default `true`). When `false` the parent captures
+     * stdout/stderr as strings on the result.
+     */
+    readonly inheritStdio?: boolean;
+    /** Python interpreter name. Defaults to `python3`. */
+    readonly python?: string;
+}
+export interface ValidateCycleDocResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+/**
+ * Filesystem path to the bundled `validate_cycle_doc.py` script.
+ *
+ * In dev (running from `src/`) and published (running from `dist/`), the
+ * script lives next to this module. The post-build copy step in
+ * `packages/cli/scripts/copy-assets.mjs` mirrors `src/**\/*.py` to
+ * `dist/**\/*.py` so the resolution is identical.
+ */
+export declare function getValidateCycleDocScriptPath(): string;
+export declare function runValidateCycleDoc(options?: ValidateCycleDocOptions): Promise<ValidateCycleDocResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cycle-doc-validator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cycle-doc-validator/index.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAGtD;AAED,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAmCjC"}