critical-gate 2.3.1 → 2.4.1

package/README.md

@@ -217,7 +217,7 @@ Critical Gate has one analysis core and multiple surfaces:
 - **Codex hook**: repair-oriented stop hook for agent workflows.
 - **VS Code extension**: Activity Bar dashboard, status bar state, Problems diagnostics, full report
   output, evidence navigation, and repair-copy actions.
-- **Agent onboarding**: `critical-gate init-agent` and the VS Code initialization command add a
+- **Agent onboarding**: `npx critical-gate init-agent` and the VS Code initialization command add a
   managed Critical Gate section to `AGENTS.md` while preserving existing repository instructions.
 
 The CLI remains the source of truth. The editor and CI surfaces consume CLI output rather than
@@ -241,44 +241,44 @@ Recommended sequence:
 See [docs/usage-guide.md](docs/usage-guide.md) for local rollout advice and
 [docs/github-integration.md](docs/github-integration.md) for CI thresholds.
 
-## Quick Start From Source
+## Quick Start
 
-Critical Gate's current CLI distribution path is source-based: clone, install, build, and run
-`node dist/cli.js`. Package-registry publishing and prebuilt action releases are intentionally held
-until repository metadata, external dogfooding, and release artifacts are stable enough for broader
-public use.
+Run Critical Gate directly against the current repository diff:
 
 Requirements:
 
-- Node.js 22.13 or newer.
-- pnpm 11.1.2.
+- Node.js 20 or newer.
 - Git history for baseline comparisons.
 
 ```bash
-git clone git@github.com:criticaldeveloper/critical-gate.git
-cd critical-gate
-pnpm install --frozen-lockfile
-pnpm build
+npx critical-gate check --task "Add signup validation" --base main --format markdown
 ```
 
-Run a local check against `main`:
+With pnpm:
 
 ```bash
-node dist/cli.js check --task "Add signup validation" --base main --format markdown
+pnpm dlx critical-gate check --task "Add signup validation" --base main --format markdown
+```
+
+Install it in a repository for repeated local and CI use:
+
+```bash
+npm install -D critical-gate
+npx critical-gate check --task "Add signup validation" --base main
 ```
 
 Common output formats:
 
 ```bash
-node dist/cli.js check --task "Add signup validation" --format json --output critical-gate.json
-node dist/cli.js check --task "Add signup validation" --format sarif --output critical-gate.sarif
-node dist/cli.js check --task "Add signup validation" --format repair
+npx critical-gate check --task "Add signup validation" --format json --output critical-gate.json
+npx critical-gate check --task "Add signup validation" --format sarif --output critical-gate.sarif
+npx critical-gate check --task "Add signup validation" --format repair
 ```
 
 Create a public API contract snapshot for repositories that expose TS/JS entrypoints:
 
 ```bash
-node dist/cli.js snapshot-api
+npx critical-gate snapshot-api
 git add .critical-gate/api-surface.json
 ```
 
@@ -293,12 +293,29 @@ Exit codes:
 - `2`: usage or configuration error.
 - `3`: internal error.
 
+## Development From Source
+
+Contributors who are changing Critical Gate itself should use the source workflow:
+
+Requirements:
+
+- Node.js 20 or newer.
+- pnpm 10.34.4.
+
+```bash
+git clone git@github.com:criticaldeveloper/critical-gate.git
+cd critical-gate
+pnpm install --frozen-lockfile
+pnpm build
+node dist/cli.js check --task "Add signup validation" --base main --format markdown
+```
+
 ## Task Intent And Baselines
 
 The task intent tells the gate what the diff is supposed to satisfy. Good task text is specific:
 
 ```bash
-node dist/cli.js check \
+npx critical-gate check \
   --task "Add email validation to signup form without changing authentication flow" \
   --base origin/main \
   --format markdown
@@ -336,7 +353,7 @@ jobs:
           fetch-depth: 0
 
       - id: critical-gate
-        uses: ./
+        uses: criticaldeveloper/critical-gate@v2
         continue-on-error: true
         with:
           task: ${{ github.event.pull_request.title }}
@@ -361,8 +378,7 @@ Critical Gate can run as a Codex `Stop` hook so an agent receives compact repair
 task is considered complete.
 
 ```bash
-pnpm build
-node dist/cli.js hook --base main
+npx critical-gate hook --base main
 ```
 
 This repository includes `.codex/hooks.json` as a reviewable project hook example. See
@@ -370,17 +386,9 @@ This repository includes `.codex/hooks.json` as a reviewable project hook exampl
 
 ## VS Code Extension
 
-Build and package the VSIX:
+Install the Marketplace extension:
 
-```bash
-pnpm package:vscode
-```
-
-Install locally:
-
-```bash
-code --install-extension artifacts/vscode/critical-gate-vscode.vsix --force
-```
+[Critical Gate for VS Code](https://marketplace.visualstudio.com/items?itemName=criticaldeveloper.critical-gate-vscode)
 
 The extension adds:
 
@@ -438,7 +446,8 @@ Branch and commit conventions for this repository:
 - [docs/detector-quality.md](docs/detector-quality.md): detector quality boundaries, blind spots,
   and coverage expectations.
 - [docs/usage-guide.md](docs/usage-guide.md): practical usage examples and troubleshooting.
-- [docs/installation.md](docs/installation.md): CLI, GitHub Action, Codex hook, and VSIX installation.
+- [docs/installation.md](docs/installation.md): CLI, GitHub Action, Codex hook, and VS Code
+  installation.
 - [docs/editor-surface.md](docs/editor-surface.md): VS Code dashboard and diagnostics behavior.
 - [docs/github-integration.md](docs/github-integration.md): GitHub Action, SARIF, and threshold guidance.
 - [docs/policy-file.md](docs/policy-file.md): `.critical-gate.json` policy-as-code reference and
@@ -458,8 +467,8 @@ Branch and commit conventions for this repository:
 ## Project Status
 
 The repository contains the TypeScript CLI implementation, deterministic detectors, Codex hook
-integration, GitHub Action integration, optional LLM explanation boundaries, source-based CLI
-distribution, and a VS Code Marketplace extension surface.
+integration, GitHub Action integration, optional LLM explanation boundaries, npm CLI distribution,
+and a VS Code Marketplace extension surface.
 
 ## License
 

package/dist/agent-onboarding/agent-instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../../src/agent-onboarding/agent-instructions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAQnD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,EAAE,EAAE,mBAAmB,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,UAA4B,EAC5B,qBAA4B,EAC5B,EAAE,EACH,EAAE,4BAA4B,GAAG,2BAA2B,CAgB5D;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAcnF;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,SAAkB,EAC5B,qBAAqB,UAAO,GAC3B,MAAM,CAkCR"}
+{"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../../src/agent-onboarding/agent-instructions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAQnD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,EAAE,EAAE,mBAAmB,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,UAAgC,EAChC,qBAA4B,EAC5B,EAAE,EACH,EAAE,4BAA4B,GAAG,2BAA2B,CAgB5D;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAcnF;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,SAAsB,EAChC,qBAAqB,UAAO,GAC3B,MAAM,CAkCR"}

package/dist/agent-onboarding/agent-instructions.js

@@ -3,7 +3,7 @@ export const AGENT_INSTRUCTIONS_FILE = "AGENTS.md";
 const blockStart = "<!-- critical-gate:start -->";
 const blockEnd = "<!-- critical-gate:end -->";
 const managedBlockPattern = new RegExp(`${escapeRegExp(blockStart)}[\\s\\S]*?${escapeRegExp(blockEnd)}`);
-export function initAgentInstructions({ root, cliCommand = "critical-gate", includePolicyReminder = true, io }) {
+export function initAgentInstructions({ root, cliCommand = "npx critical-gate", includePolicyReminder = true, io }) {
     const path = join(root, AGENT_INSTRUCTIONS_FILE);
     const existing = io.exists?.(path) === true ? (io.readFile?.(path) ?? "") : "";
     const block = renderCriticalGateAgentBlock(cliCommand, includePolicyReminder);
@@ -29,7 +29,7 @@ export function mergeCriticalGateAgentBlock(existing, block) {
     }
     return `${trimmedExisting}\n\n${normalizedBlock}`;
 }
-export function renderCriticalGateAgentBlock(cliCommand = "critical-gate", includePolicyReminder = true) {
+export function renderCriticalGateAgentBlock(cliCommand = "npx critical-gate", includePolicyReminder = true) {
     const lines = [
         blockStart,
         "## Critical Gate Agent Instructions",

package/dist/agent-onboarding/agent-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-instructions.js","sourceRoot":"","sources":["../../src/agent-onboarding/agent-instructions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-instructions.js","sourceRoot":"","sources":["../../src/agent-onboarding/agent-instructions.ts"],"names":[],"mappings":"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"}

package/dist/cli/args.d.ts

@@ -0,0 +1,57 @@
+import type { CommandName } from "./help.js";
+import type { CheckOptions } from "./types.js";
+export declare function parseCheckArgs(args: string[], command: CommandName): {
+    ok: true;
+    options: CheckOptions;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function isCommandName(value: string): value is CommandName;
+export declare function parseFlagArgs(args: string[], allowedFlags: string[]): {
+    ok: true;
+    values: Record<string, string>;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseSnapshotApiArgs(args: string[]): {
+    ok: true;
+    options: {
+        output?: string;
+        entrypoints?: string[];
+    };
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseInstallHooksArgs(args: string[]): {
+    ok: true;
+    options: {
+        hook: "pre-commit" | "pre-push" | "all";
+        cli: string;
+        force: boolean;
+    };
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseInitPolicyArgs(args: string[]): {
+    ok: true;
+    options: {
+        force: boolean;
+    };
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseInitAgentArgs(args: string[]): {
+    ok: true;
+    options: {
+        cli: string;
+    };
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,WAAW,GAElB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,YAAY,CAAC;CACvB,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CA2FJ;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAWjE;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EAAE,EACd,YAAY,EAAE,MAAM,EAAE,GAEpB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CAqBJ;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAC/C;IACE,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;CACH,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CAqCJ;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAChD;IACE,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE;QACP,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC;QACxC,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;CACH,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CAuCJ;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAC9C;IACE,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;CACH,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CAcJ;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAC7C;IACE,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CAuBJ"}

package/dist/cli/args.js

@@ -0,0 +1,209 @@
+export function parseCheckArgs(args, command) {
+    const options = {
+        format: "markdown",
+        strict: false,
+        staged: false
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--strict") {
+            options.strict = true;
+            continue;
+        }
+        if (arg === "--staged") {
+            options.staged = true;
+            continue;
+        }
+        if (arg === "--task" ||
+            arg === "--base" ||
+            arg === "--format" ||
+            arg === "--output" ||
+            arg === "--fail-on") {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return { ok: false, error: `Missing value for ${arg}.` };
+            }
+            index += 1;
+            if (arg === "--task") {
+                options.task = value;
+            }
+            else if (arg === "--base") {
+                options.base = value;
+            }
+            else if (arg === "--format") {
+                if (!isReportFormat(value)) {
+                    return {
+                        ok: false,
+                        error: "Invalid --format value. Expected json, markdown, sarif, repair, or pr-comment."
+                    };
+                }
+                options.format = value;
+            }
+            else if (arg === "--fail-on") {
+                if (!isFailOnSeverity(value)) {
+                    return {
+                        ok: false,
+                        error: "Invalid --fail-on value. Expected blocker, high, or medium."
+                    };
+                }
+                options.failOn = value;
+            }
+            else if (arg === "--output") {
+                options.output = value;
+            }
+            continue;
+        }
+        return { ok: false, error: `Unknown option: ${arg}` };
+    }
+    if (options.task === undefined || options.task.trim().length === 0) {
+        if (command === "hook") {
+            options.task = "Codex completed feature implementation";
+        }
+        else {
+            return { ok: false, error: "Missing required --task value." };
+        }
+    }
+    if (options.task.trim().length === 0) {
+        return { ok: false, error: "Missing required --task value." };
+    }
+    return {
+        ok: true,
+        options: {
+            task: options.task,
+            base: options.base,
+            format: options.format ?? "markdown",
+            strict: options.strict ?? false,
+            staged: options.staged ?? false,
+            failOn: options.failOn,
+            output: options.output
+        }
+    };
+}
+export function isCommandName(value) {
+    return (value === "check" ||
+        value === "hook" ||
+        value === "accept" ||
+        value === "teach" ||
+        value === "snapshot-api" ||
+        value === "install-hooks" ||
+        value === "init-policy" ||
+        value === "init-agent");
+}
+export function parseFlagArgs(args, allowedFlags) {
+    const values = {};
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!allowedFlags.includes(arg)) {
+            return { ok: false, error: `Unknown option: ${arg}.` };
+        }
+        const value = args[index + 1];
+        if (value === undefined || value.startsWith("--")) {
+            return { ok: false, error: `Missing value for ${arg}.` };
+        }
+        values[arg] = value;
+        index += 1;
+    }
+    return { ok: true, values };
+}
+export function parseSnapshotApiArgs(args) {
+    const options = {
+        entrypoints: []
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg !== "--entrypoint" && arg !== "--output") {
+            return { ok: false, error: `Unknown option: ${arg}.` };
+        }
+        const value = args[index + 1];
+        if (value === undefined || value.startsWith("--")) {
+            return { ok: false, error: `Missing value for ${arg}.` };
+        }
+        if (arg === "--entrypoint") {
+            options.entrypoints.push(value);
+        }
+        else {
+            options.output = value;
+        }
+        index += 1;
+    }
+    return {
+        ok: true,
+        options: {
+            output: options.output,
+            entrypoints: options.entrypoints.length > 0 ? options.entrypoints : undefined
+        }
+    };
+}
+export function parseInstallHooksArgs(args) {
+    const options = {
+        hook: "all",
+        cli: "critical-gate",
+        force: false
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--force") {
+            options.force = true;
+            continue;
+        }
+        if (arg !== "--hook" && arg !== "--cli") {
+            return { ok: false, error: `Unknown option: ${arg}.` };
+        }
+        const value = args[index + 1];
+        if (value === undefined || value.startsWith("--")) {
+            return { ok: false, error: `Missing value for ${arg}.` };
+        }
+        if (arg === "--hook") {
+            if (value !== "pre-commit" && value !== "pre-push" && value !== "all") {
+                return { ok: false, error: "Invalid --hook value. Expected pre-commit, pre-push, or all." };
+            }
+            options.hook = value;
+        }
+        else {
+            options.cli = value;
+        }
+        index += 1;
+    }
+    return { ok: true, options };
+}
+export function parseInitPolicyArgs(args) {
+    const options = {
+        force: false
+    };
+    for (const arg of args) {
+        if (arg !== "--force") {
+            return { ok: false, error: `Unknown option: ${arg}.` };
+        }
+        options.force = true;
+    }
+    return { ok: true, options };
+}
+export function parseInitAgentArgs(args) {
+    const options = {
+        cli: "npx critical-gate"
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg !== "--cli") {
+            return { ok: false, error: `Unknown option: ${arg}.` };
+        }
+        const value = args[index + 1];
+        if (value === undefined || value.startsWith("--")) {
+            return { ok: false, error: `Missing value for ${arg}.` };
+        }
+        options.cli = value;
+        index += 1;
+    }
+    return { ok: true, options };
+}
+function isReportFormat(value) {
+    return (value === "json" ||
+        value === "markdown" ||
+        value === "sarif" ||
+        value === "repair" ||
+        value === "pr-comment");
+}
+function isFailOnSeverity(value) {
+    return value === "blocker" || value === "high" || value === "medium";
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands.d.ts

@@ -0,0 +1,8 @@
+import { ExitCode, type CliIo } from "./types.js";
+export declare function runSnapshotApiCommand(args: string[], io: CliIo): ExitCode;
+export declare function runInstallHooksCommand(args: string[], io: CliIo): ExitCode;
+export declare function runInitPolicyCommand(args: string[], io: CliIo): ExitCode;
+export declare function runInitAgentCommand(args: string[], io: CliIo): ExitCode;
+export declare function runAcceptCommand(args: string[], io: CliIo): ExitCode;
+export declare function runTeachCommand(args: string[], io: CliIo): ExitCode;
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,QAAQ,CA6BzE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,QAAQ,CA8B1E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,QAAQ,CAqBxE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,QAAQ,CAyBvE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,QAAQ,CA4CpE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,QAAQ,CAwDnE"}

package/dist/cli/commands.js

@@ -0,0 +1,170 @@
+import { join } from "node:path";
+import { CRITICAL_GATE_CONFIG_FILE, buildApiSurfaceSnapshot, createDefaultPolicyConfig, getApiSnapshotOutputPath, getConfiguredPublicApiEntrypoints, initAgentInstructions, loadCriticalGateConfig, updateCriticalGateConfig } from "../index.js";
+import { parseFlagArgs, parseInitAgentArgs, parseInitPolicyArgs, parseInstallHooksArgs, parseSnapshotApiArgs } from "./args.js";
+import { renderGitHookScript } from "./git-hooks.js";
+import { ExitCode } from "./types.js";
+export function runSnapshotApiCommand(args, io) {
+    const parsed = parseSnapshotApiArgs(args);
+    if (!parsed.ok) {
+        io.stderr(parsed.error);
+        io.stderr("Run critical-gate snapshot-api --help for usage.");
+        return ExitCode.UsageError;
+    }
+    const root = io.readDiff().root;
+    const configResult = loadCriticalGateConfig(root, {
+        exists: io.exists,
+        readFile: io.readFile
+    });
+    const snapshot = buildApiSurfaceSnapshot({
+        root,
+        generatedAt: io.now(),
+        entrypoints: parsed.options.entrypoints,
+        policyEntrypoints: getConfiguredPublicApiEntrypoints(configResult.config),
+        reader: io
+    });
+    const outputPath = getApiSnapshotOutputPath(root, parsed.options.output);
+    io.writeFile(outputPath, `${JSON.stringify(snapshot, null, 2)}\n`);
+    io.stdout(`Wrote public API snapshot to ${outputPath} (${snapshot.exports.length} exports across ${snapshot.entrypoints.length} entrypoints).`);
+    return ExitCode.Pass;
+}
+export function runInstallHooksCommand(args, io) {
+    const parsed = parseInstallHooksArgs(args);
+    if (!parsed.ok) {
+        io.stderr(parsed.error);
+        io.stderr("Run critical-gate install-hooks --help for usage.");
+        return ExitCode.UsageError;
+    }
+    const root = io.readDiff().root;
+    const hooks = parsed.options.hook === "all" ? ["pre-commit", "pre-push"] : [parsed.options.hook];
+    const installed = [];
+    for (const hook of hooks) {
+        const path = join(root, ".git", "hooks", hook);
+        if (io.exists?.(path) === true && parsed.options.force !== true) {
+            io.stderr(`Refusing to overwrite existing ${hook} hook at ${path}. Re-run with --force.`);
+            return ExitCode.UsageError;
+        }
+        io.writeFile(path, renderGitHookScript(hook, parsed.options.cli));
+        io.chmodFile?.(path, 0o755);
+        installed.push(path);
+    }
+    io.stdout(`Installed Critical Gate hook(s): ${installed.join(", ")}`);
+    return ExitCode.Pass;
+}
+export function runInitPolicyCommand(args, io) {
+    const parsed = parseInitPolicyArgs(args);
+    if (!parsed.ok) {
+        io.stderr(parsed.error);
+        io.stderr("Run critical-gate init-policy --help for usage.");
+        return ExitCode.UsageError;
+    }
+    const root = io.readDiff().root;
+    const path = join(root, CRITICAL_GATE_CONFIG_FILE);
+    if (io.exists?.(path) === true && parsed.options.force !== true) {
+        io.stderr(`Refusing to overwrite existing ${CRITICAL_GATE_CONFIG_FILE}. Re-run with --force.`);
+        return ExitCode.UsageError;
+    }
+    io.writeFile(path, `${JSON.stringify(createDefaultPolicyConfig(io.now()), null, 2)}\n`);
+    io.stdout(`Wrote reviewable Critical Gate policy to ${path}.`);
+    return ExitCode.Pass;
+}
+export function runInitAgentCommand(args, io) {
+    const parsed = parseInitAgentArgs(args);
+    if (!parsed.ok) {
+        io.stderr(parsed.error);
+        io.stderr("Run critical-gate init-agent --help for usage.");
+        return ExitCode.UsageError;
+    }
+    const root = io.readDiff().root;
+    const result = initAgentInstructions({
+        root,
+        cliCommand: parsed.options.cli,
+        io
+    });
+    if (result.updated) {
+        io.stdout(`${result.created ? "Created" : "Updated"} ${result.path} with Critical Gate agent instructions.`);
+    }
+    else {
+        io.stdout(`${result.path} already contains the current Critical Gate agent instructions.`);
+    }
+    return ExitCode.Pass;
+}
+export function runAcceptCommand(args, io) {
+    const parsed = parseFlagArgs(args, ["--finding", "--reason"]);
+    if (!parsed.ok) {
+        io.stderr(parsed.error);
+        io.stderr("Run critical-gate accept --help for usage.");
+        return ExitCode.UsageError;
+    }
+    const finding = parsed.values["--finding"];
+    const reason = parsed.values["--reason"];
+    if (finding === undefined || reason === undefined) {
+        io.stderr("Missing required --finding or --reason value.");
+        io.stderr("Run critical-gate accept --help for usage.");
+        return ExitCode.UsageError;
+    }
+    const root = io.readDiff().root;
+    const updated = updateCriticalGateConfig(root, (config) => ({
+        ...config,
+        learning: {
+            ...config.learning,
+            acceptedFindings: upsertById(config.learning?.acceptedFindings ?? [], {
+                id: finding,
+                reason,
+                createdAt: io.now().toISOString()
+            })
+        }
+    }), {
+        exists: io.exists,
+        readFile: io.readFile,
+        writeFile: io.writeFile
+    });
+    io.stdout(`Accepted finding ${finding} in ${CRITICAL_GATE_CONFIG_FILE} (${updated.learning?.acceptedFindings?.length ?? 0} accepted finding rules).`);
+    return ExitCode.Pass;
+}
+export function runTeachCommand(args, io) {
+    const parsed = parseFlagArgs(args, ["--id", "--when-changed", "--allow", "--reason"]);
+    if (!parsed.ok) {
+        io.stderr(parsed.error);
+        io.stderr("Run critical-gate teach --help for usage.");
+        return ExitCode.UsageError;
+    }
+    const id = parsed.values["--id"];
+    const whenChanged = parsed.values["--when-changed"];
+    const allow = parsed.values["--allow"]
+        ?.split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    const reason = parsed.values["--reason"];
+    if (id === undefined ||
+        whenChanged === undefined ||
+        allow === undefined ||
+        reason === undefined) {
+        io.stderr("Missing required --id, --when-changed, --allow, or --reason value.");
+        io.stderr("Run critical-gate teach --help for usage.");
+        return ExitCode.UsageError;
+    }
+    const root = io.readDiff().root;
+    const updated = updateCriticalGateConfig(root, (config) => ({
+        ...config,
+        learning: {
+            ...config.learning,
+            expectedSupportFiles: upsertById(config.learning?.expectedSupportFiles ?? [], {
+                id,
+                whenChanged,
+                allow,
+                reason,
+                createdAt: io.now().toISOString()
+            })
+        }
+    }), {
+        exists: io.exists,
+        readFile: io.readFile,
+        writeFile: io.writeFile
+    });
+    io.stdout(`Taught expected support rule ${id} in ${CRITICAL_GATE_CONFIG_FILE} (${updated.learning?.expectedSupportFiles?.length ?? 0} support rules).`);
+    return ExitCode.Pass;
+}
+function upsertById(entries, next) {
+    return [...entries.filter((entry) => entry.id !== next.id), next];
+}
+//# sourceMappingURL=commands.js.map