vigiles 3.0.0 → 4.0.1

package/dist/e2e.d.ts

@@ -15,5 +15,5 @@
  * [`vigiles/eval`](./eval.ts) + [`vigiles/judge`](./judge.ts), not from here.
  */
 export * from "./integration.js";
-export { egressRoutes } from "./adapters/claude-code/run-hook.js";
+export { egressRoutes } from "./run-hook.js";
 //# sourceMappingURL=e2e.d.ts.map

package/dist/e2e.js

@@ -34,6 +34,6 @@ exports.egressRoutes = void 0;
 __exportStar(require("./integration.js"), exports);
 // The real-egress capability probe (the egress-using runHook is already re-exported
 // via the integration→unit chain).
-var run_hook_js_1 = require("./adapters/claude-code/run-hook.js");
+var run_hook_js_1 = require("./run-hook.js");
 Object.defineProperty(exports, "egressRoutes", { enumerable: true, get: function () { return run_hook_js_1.egressRoutes; } });
 //# sourceMappingURL=e2e.js.map

package/dist/{adapters/claude-code/eval-cache.d.ts → eval-cache.d.ts}

@@ -1,4 +1,4 @@
-import { type SHA256Hash } from "../../core/hash.js";
+import { type SHA256Hash } from "./core/hash.js";
 import type { RunOut } from "./eval.js";
 /** Cache behaviour: never touch the cache / read-only / read-and-write. */
 export type CacheMode = "off" | "read" | "readwrite";

package/dist/{adapters/claude-code/eval-cache.js → eval-cache.js}

@@ -24,7 +24,7 @@ exports.restoreDir = restoreDir;
  */
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const hash_js_1 = require("../../core/hash.js");
+const hash_js_1 = require("./core/hash.js");
 const MAX_SNAPSHOT_FILE_BYTES = 1024 * 1024;
 const SKIP_DIRS = new Set(["node_modules", ".git"]);
 /**

package/dist/{adapters/claude-code/eval.js → eval.js}

@@ -39,8 +39,8 @@ const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
-const plugin_loader_js_1 = require("./plugin-loader.js");
-const runtime_js_1 = require("./runtime.js");
+const plugin_loader_js_1 = require("./adapters/claude-code/plugin-loader.js");
+const runtime_js_1 = require("./adapters/claude-code/runtime.js");
 const harness_test_js_1 = require("./harness-test.js");
 const eval_cache_js_1 = require("./eval-cache.js");
 function writeFiles(cwd, files) {

package/dist/harness-assert.d.ts

@@ -13,16 +13,16 @@
  *     `expect(...).toHaveCreated(...)` sugar. The signature is identical for
  *     vitest and jest, so the same object supports both.
  */
-import { type HarnessTestSpec, type HarnessTestResult, type ToolCall, type Trace } from "./adapters/claude-code/harness-test.js";
-import type { EvalReport, TriggerRateReport } from "./adapters/claude-code/eval.js";
-import type { HookRunResult, EgressAttempt } from "./adapters/claude-code/run-hook.js";
+import { type HarnessTestSpec, type HarnessTestResult, type ToolCall, type Trace } from "./harness-test.js";
+import type { EvalReport, TriggerRateReport } from "./eval.js";
+import type { HookRunResult, EgressAttempt } from "./run-hook.js";
 import type { OutputContract } from "./core/spec.js";
 import { type ParsedAgentResult } from "./adapters/claude-code/agent-result.js";
-import { type BaselineFile, type DiffOptions } from "./adapters/claude-code/eval-baseline.js";
-export { compareArms } from "./adapters/claude-code/stats.js";
-export type { Comparison } from "./adapters/claude-code/stats.js";
-export { diffReports, toBaselineFile, parseBaselineFile, readBaseline, writeBaseline, formatBaselineDiff, diffToJUnit, } from "./adapters/claude-code/eval-baseline.js";
-export type { BaselineFile, BaselineDiff, MetricDiff, DiffStatus, DiffOptions, } from "./adapters/claude-code/eval-baseline.js";
+import { type BaselineFile, type DiffOptions } from "./eval-baseline.js";
+export { compareArms } from "./stats.js";
+export type { Comparison } from "./stats.js";
+export { diffReports, toBaselineFile, parseBaselineFile, readBaseline, writeBaseline, formatBaselineDiff, diffToJUnit, } from "./eval-baseline.js";
+export type { BaselineFile, BaselineDiff, MetricDiff, DiffStatus, DiffOptions, } from "./eval-baseline.js";
 /**
  * Run a harness test, hand the result to `fn`, and always clean up the sandbox.
  * Returns whatever `fn` returns. Use this instead of calling `cleanup()` by

package/dist/harness-assert.js

@@ -57,15 +57,15 @@ exports.assertTriggerRate = assertTriggerRate;
  *     `expect(...).toHaveCreated(...)` sugar. The signature is identical for
  *     vitest and jest, so the same object supports both.
  */
-const harness_test_js_1 = require("./adapters/claude-code/harness-test.js");
+const harness_test_js_1 = require("./harness-test.js");
 const agent_result_js_1 = require("./adapters/claude-code/agent-result.js");
-const stats_js_1 = require("./adapters/claude-code/stats.js");
-const eval_baseline_js_1 = require("./adapters/claude-code/eval-baseline.js");
+const stats_js_1 = require("./stats.js");
+const eval_baseline_js_1 = require("./eval-baseline.js");
 // Re-export the significance primitives so the whole eval-analysis surface lives
 // behind `vigiles/harness-assert` (no separate entry point).
-var stats_js_2 = require("./adapters/claude-code/stats.js");
+var stats_js_2 = require("./stats.js");
 Object.defineProperty(exports, "compareArms", { enumerable: true, get: function () { return stats_js_2.compareArms; } });
-var eval_baseline_js_2 = require("./adapters/claude-code/eval-baseline.js");
+var eval_baseline_js_2 = require("./eval-baseline.js");
 Object.defineProperty(exports, "diffReports", { enumerable: true, get: function () { return eval_baseline_js_2.diffReports; } });
 Object.defineProperty(exports, "toBaselineFile", { enumerable: true, get: function () { return eval_baseline_js_2.toBaselineFile; } });
 Object.defineProperty(exports, "parseBaselineFile", { enumerable: true, get: function () { return eval_baseline_js_2.parseBaselineFile; } });

package/dist/{adapters/claude-code/harness-test.d.ts → harness-test.d.ts}

@@ -1,9 +1,9 @@
-import type { HarnessAdapter } from "../../core/adapter.js";
-import type { HarnessTestDriver, ToolCall, HookFire, ParsedRun, ModelTurn, ModelRequest } from "../../core/harness-driver.js";
+import type { HarnessAdapter } from "./core/adapter.js";
+import type { HarnessTestDriver, ToolCall, HookFire, ParsedRun, ModelTurn, ModelRequest } from "./core/harness-driver.js";
 import { type SandboxMode } from "./sandbox.js";
 export { scriptModel } from "./mock-model.js";
-export type { ModelTurn, ModelRequest, ToolCall, HookFire, HarnessTestDriver, } from "../../core/harness-driver.js";
-export { loadPlugin, resolveHarness } from "./plugin-loader.js";
+export type { ModelTurn, ModelRequest, ToolCall, HookFire, HarnessTestDriver, } from "./core/harness-driver.js";
+export { loadPlugin, resolveHarness, } from "./adapters/claude-code/plugin-loader.js";
 export { decideSandbox, specTrusted, sandboxAvailable, type SandboxMode, } from "./sandbox.js";
 export interface HarnessTestSpec {
     /** Fixture files to write in a fresh temp working dir (path → contents). */

package/dist/{adapters/claude-code/harness-test.js → harness-test.js}

@@ -43,14 +43,14 @@ const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
-const adapter_conformance_js_1 = require("../../adapter-conformance.js");
-const runtime_js_1 = require("./runtime.js");
+const adapter_conformance_js_1 = require("./adapter-conformance.js");
+const runtime_js_1 = require("./adapters/claude-code/runtime.js");
 const mock_model_js_1 = require("./mock-model.js");
-const plugin_loader_js_1 = require("./plugin-loader.js");
+const plugin_loader_js_1 = require("./adapters/claude-code/plugin-loader.js");
 const sandbox_js_1 = require("./sandbox.js");
 var mock_model_js_2 = require("./mock-model.js");
 Object.defineProperty(exports, "scriptModel", { enumerable: true, get: function () { return mock_model_js_2.scriptModel; } });
-var plugin_loader_js_2 = require("./plugin-loader.js");
+var plugin_loader_js_2 = require("./adapters/claude-code/plugin-loader.js");
 Object.defineProperty(exports, "loadPlugin", { enumerable: true, get: function () { return plugin_loader_js_2.loadPlugin; } });
 Object.defineProperty(exports, "resolveHarness", { enumerable: true, get: function () { return plugin_loader_js_2.resolveHarness; } });
 var sandbox_js_2 = require("./sandbox.js");

package/dist/integration.d.ts

@@ -10,7 +10,7 @@
  * imports from here.
  */
 export * from "./unit.js";
-export * from "./adapters/claude-code/harness-test.js";
-export * from "./adapters/claude-code/mock-model.js";
-export * from "./adapters/claude-code/plugin-loader.js";
+export * from "./harness-test.js";
+export * from "./mock-model.js";
+export type { LoadedPlugin } from "./plugin-loader.js";
 //# sourceMappingURL=integration.d.ts.map

package/dist/integration.js

@@ -26,7 +26,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * imports from here.
  */
 __exportStar(require("./unit.js"), exports);
-__exportStar(require("./adapters/claude-code/harness-test.js"), exports);
-__exportStar(require("./adapters/claude-code/mock-model.js"), exports);
-__exportStar(require("./adapters/claude-code/plugin-loader.js"), exports);
+__exportStar(require("./harness-test.js"), exports);
+__exportStar(require("./mock-model.js"), exports);
 //# sourceMappingURL=integration.js.map

package/dist/{adapters/claude-code/mock-model.d.ts → mock-model.d.ts}

@@ -1,5 +1,5 @@
-import type { ModelTurn, ModelRequest } from "../../core/harness-driver.js";
-export type { ModelTurn, ModelRequest } from "../../core/harness-driver.js";
+import type { ModelTurn, ModelRequest } from "./core/harness-driver.js";
+export type { ModelTurn, ModelRequest } from "./core/harness-driver.js";
 /** Build a scripted model from an ordered list of turns. */
 export declare function scriptModel(turns: readonly ModelTurn[]): ModelTurn[];
 export interface TurnInfo {

package/dist/{adapters/claude-code/run-hook.d.ts → run-hook.d.ts}

@@ -1,4 +1,4 @@
-import type { HookProtocol } from "../../core/hook-protocol.js";
+import type { HookProtocol } from "./core/hook-protocol.js";
 import { type SandboxMode, type EgressAttempt } from "./sandbox.js";
 export type { EgressAttempt };
 /** A hook event payload (the JSON Claude Code writes to the hook's stdin). */

package/dist/{adapters/claude-code/run-hook.js → run-hook.js}

@@ -38,7 +38,7 @@ const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
-const hook_protocol_js_1 = require("./hook-protocol.js");
+const hook_protocol_js_1 = require("./adapters/claude-code/hook-protocol.js");
 const egress_js_1 = require("./egress.js");
 const sandbox_js_1 = require("./sandbox.js");
 /** Parse stdout as a hook JSON decision (pure, testable without a process). */

package/dist/{adapters/claude-code/sandbox.js → sandbox.js}

@@ -35,7 +35,7 @@ const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
-const runtime_js_1 = require("./runtime.js");
+const runtime_js_1 = require("./adapters/claude-code/runtime.js");
 let cachedAvailable;
 /**
  * Whether this environment can ACTUALLY confine untrusted code under bubblewrap.

package/dist/setup-plan.d.ts

@@ -10,9 +10,9 @@
  */
 /** What `vigiles init` will set up. */
 export interface SetupPlan {
-    /** Pillar 1 — verify instruction files (specs, types, compile, audit, hooks). */
-    verify: boolean;
-    /** Pillar 2 — test the harness (scaffold a starter harness test + CI job). */
+    /** Lint pillar — verify instruction-file references (specs, types, compile, lint/audit, hooks). */
+    lint: boolean;
+    /** Test pillar — test the harness (scaffold a starter harness test + CI job). */
     test: boolean;
     /** Wire CI (the `zernie/vigiles@v1` Action; creates a workflow if none). */
     gha: boolean;
@@ -26,11 +26,17 @@ export interface ParsedSetupArgs {
     target?: string;
     strict: boolean;
     yes: boolean;
-    pillars?: "verify" | "test" | "both";
+    /** Lint pillar — `--lint` → true, `--no-lint` → false, absent → undefined. */
+    lint?: boolean;
+    /** Test pillar — `--test` → true, `--no-test` → false, absent → undefined. */
+    test?: boolean;
+    /** `--harness=claude,codex` override (empty = auto-detect). */
+    harness?: string;
     gha?: boolean;
     plugin?: boolean;
 }
-/** Parse `init` args into the choices the user pinned. */
+/** Parse `init` args into the choices the user pinned. The two pillars are
+ * selected with `--lint` / `--test`. */
 export declare function parseSetupArgs(args: readonly string[]): ParsedSetupArgs;
 /** The non-interactive defaults: both pillars, CI, and the plugin. */
 export declare function defaultPlan(strict?: boolean): SetupPlan;
@@ -41,11 +47,45 @@ export declare function defaultPlan(strict?: boolean): SetupPlan;
  */
 export declare function shouldPrompt(parsed: ParsedSetupArgs, isTTY: boolean): boolean;
 /** Interactive answers (only the fields the prompts cover). */
-export type SetupAnswers = Partial<Pick<SetupPlan, "verify" | "test" | "gha" | "plugin">>;
+export type SetupAnswers = Partial<Pick<SetupPlan, "lint" | "test" | "gha" | "plugin">>;
+/**
+ * How to install vigiles's skills/hooks for ONE harness — the deterministic
+ * decision behind the IO in cli.ts, so a CI test asserts WHICH commands an
+ * install runs without a network call or a real `claude`/`codex` binary.
+ *
+ * The method is genuinely harness-specific: Claude Code has a GLOBAL plugin
+ * marketplace (installs to ~/.claude/plugins/, nothing in the repo); Codex has
+ * no global store — its config is repo-committed (`.codex/`, AGENTS.md), so its
+ * instructions are read directly and skills are an opt-in, repo-local concern.
+ */
+export interface InstallPlan {
+    harness: string;
+    /** Shell commands to auto-run (empty = nothing runnable here). */
+    commands: string[];
+    /** One-line success message printed after the commands run. */
+    successMessage: string;
+    /** The equivalent commands a user runs by hand (printed on failure / no-CLI). */
+    manualSteps: string[];
+    /** Always-printed informational lines (where it installs, caveats). */
+    notes: string[];
+    /** Whether this method writes files into the consumer's repo (vendoring). */
+    vendors: boolean;
+}
+/** Per-harness install plan. `hasClaude` gates the auto-run `claude plugin` CLI
+ * (else the same two steps are printed as `/plugin` slash commands).
+ *
+ * Both methods install GLOBALLY, never into the repo: Claude through its plugin
+ * marketplace (~/.claude/plugins/), Codex through the cross-agent `skills` CLI
+ * with `-g -y` (the global store ~/.agents/skills/, which Codex reads). Codex
+ * gets the skills but NOT hooks — Codex hook wiring (.codex/config.toml [hooks])
+ * is not automated yet. */
+export declare function planPluginInstall(harnesses: readonly string[], opts: {
+    hasClaude: boolean;
+}): InstallPlan[];
 /**
  * Resolve the final plan: defaults, then flags, then interactive answers (each
  * layer overrides the previous only where it has an opinion). `--target` pins a
- * bare Pillar-1 spec (no harness scaffold).
+ * bare lint-pillar spec (no harness scaffold).
  */
 export declare function resolvePlan(parsed: ParsedSetupArgs, answers?: SetupAnswers): SetupPlan;
 //# sourceMappingURL=setup-plan.d.ts.map

package/dist/setup-plan.js

@@ -13,28 +13,36 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseSetupArgs = parseSetupArgs;
 exports.defaultPlan = defaultPlan;
 exports.shouldPrompt = shouldPrompt;
+exports.planPluginInstall = planPluginInstall;
 exports.resolvePlan = resolvePlan;
 function flagValue(args, prefix) {
     return args.find((a) => a.startsWith(prefix))?.slice(prefix.length);
 }
-/** Parse `init` args into the choices the user pinned. */
+/** `--name` → true, `--no-name` → false, neither present → undefined. */
+function boolFlag(args, name) {
+    if (args.includes(`--${name}`))
+        return true;
+    if (args.includes(`--no-${name}`))
+        return false;
+    return undefined;
+}
+/** Parse `init` args into the choices the user pinned. The two pillars are
+ * selected with `--lint` / `--test`. */
 function parseSetupArgs(args) {
-    const pillarsRaw = flagValue(args, "--pillars=");
-    const pillars = pillarsRaw === "verify" || pillarsRaw === "test" || pillarsRaw === "both"
-        ? pillarsRaw
-        : undefined;
     return {
         target: flagValue(args, "--target="),
         strict: args.includes("--strict"),
         yes: args.includes("--yes") || args.includes("-y"),
-        pillars,
+        lint: boolFlag(args, "lint"),
+        test: boolFlag(args, "test"),
+        harness: flagValue(args, "--harness="),
         gha: args.includes("--no-gha") ? false : undefined,
         plugin: args.includes("--no-plugin") ? false : undefined,
     };
 }
 /** The non-interactive defaults: both pillars, CI, and the plugin. */
 function defaultPlan(strict = false) {
-    return { verify: true, test: true, gha: true, plugin: true, strict };
+    return { lint: true, test: true, gha: true, plugin: true, strict };
 }
 /**
  * Whether to drop into interactive prompts: a human at a TTY who passed neither
@@ -44,42 +52,109 @@ function defaultPlan(strict = false) {
 function shouldPrompt(parsed, isTTY) {
     if (!isTTY || parsed.yes || parsed.target)
         return false;
-    const allPinned = parsed.pillars !== undefined &&
-        parsed.gha !== undefined &&
-        parsed.plugin !== undefined;
+    const pillarsPinned = parsed.lint !== undefined || parsed.test !== undefined;
+    const allPinned = pillarsPinned && parsed.gha !== undefined && parsed.plugin !== undefined;
     return !allPinned;
 }
+/**
+ * Apply the pillar flags. A positive flag (`--lint` and/or `--test`) is an
+ * explicit SELECTION — enable exactly the named pillars. Otherwise default to
+ * both and let a `--no-*` flag drop one.
+ */
+function applyPillarFlags(plan, parsed) {
+    if (parsed.lint === true || parsed.test === true) {
+        plan.lint = parsed.lint === true;
+        plan.test = parsed.test === true;
+        return;
+    }
+    if (parsed.lint === false)
+        plan.lint = false;
+    if (parsed.test === false)
+        plan.test = false;
+}
+function applyAnswers(plan, answers) {
+    if (answers.lint !== undefined)
+        plan.lint = answers.lint;
+    if (answers.test !== undefined)
+        plan.test = answers.test;
+    if (answers.gha !== undefined)
+        plan.gha = answers.gha;
+    if (answers.plugin !== undefined)
+        plan.plugin = answers.plugin;
+}
+/** Per-harness install plan. `hasClaude` gates the auto-run `claude plugin` CLI
+ * (else the same two steps are printed as `/plugin` slash commands).
+ *
+ * Both methods install GLOBALLY, never into the repo: Claude through its plugin
+ * marketplace (~/.claude/plugins/), Codex through the cross-agent `skills` CLI
+ * with `-g -y` (the global store ~/.agents/skills/, which Codex reads). Codex
+ * gets the skills but NOT hooks — Codex hook wiring (.codex/config.toml [hooks])
+ * is not automated yet. */
+function planPluginInstall(harnesses, opts) {
+    return harnesses.map((harness) => {
+        if (harness === "claude") {
+            return {
+                harness,
+                commands: opts.hasClaude
+                    ? [
+                        "claude plugin marketplace add zernie/vigiles",
+                        "claude plugin install vigiles@vigiles",
+                    ]
+                    : [],
+                successMessage: "✓ Installed the vigiles plugin (hooks + skills) into ~/.claude/plugins/",
+                manualSteps: [
+                    "/plugin marketplace add zernie/vigiles",
+                    "/plugin install vigiles@vigiles",
+                ],
+                notes: [
+                    "Installs globally to ~/.claude/plugins/ — nothing is added to your repo.",
+                ],
+                vendors: false,
+            };
+        }
+        if (harness === "codex") {
+            // The cross-agent `skills` CLI with `-g -y` installs to the global store
+            // ~/.agents/skills/ (NOT the repo, and NOT ~/.codex/ — verified against
+            // the real CLI). Skills only; Codex hooks (.codex/config.toml [hooks])
+            // are not wired automatically.
+            return {
+                harness,
+                commands: ["npx --yes skills add zernie/vigiles -a codex -g -y"],
+                successMessage: "✓ Installed the vigiles skills into ~/.agents/skills/ (global, not vendored)",
+                manualSteps: ["npx skills add zernie/vigiles -a codex -g -y"],
+                notes: [
+                    "Codex reads AGENTS.md directly; the skills install globally to ~/.agents/skills/ (not the repo).",
+                    "Codex hooks (.codex/config.toml [hooks]) are not auto-wired yet — add them manually for compile-on-edit.",
+                ],
+                vendors: false,
+            };
+        }
+        return {
+            harness,
+            commands: [],
+            successMessage: "",
+            manualSteps: [],
+            notes: [`No plugin install path for harness '${harness}'.`],
+            vendors: false,
+        };
+    });
+}
 /**
  * Resolve the final plan: defaults, then flags, then interactive answers (each
  * layer overrides the previous only where it has an opinion). `--target` pins a
- * bare Pillar-1 spec (no harness scaffold).
+ * bare lint-pillar spec (no harness scaffold).
  */
 function resolvePlan(parsed, answers) {
     const plan = defaultPlan(parsed.strict);
-    if (parsed.pillars === "verify") {
-        plan.verify = true;
-        plan.test = false;
-    }
-    else if (parsed.pillars === "test") {
-        plan.verify = false;
-        plan.test = true;
-    }
+    applyPillarFlags(plan, parsed);
     if (parsed.gha === false)
         plan.gha = false;
     if (parsed.plugin === false)
         plan.plugin = false;
     if (parsed.target)
         plan.test = false;
-    if (answers) {
-        if (answers.verify !== undefined)
-            plan.verify = answers.verify;
-        if (answers.test !== undefined)
-            plan.test = answers.test;
-        if (answers.gha !== undefined)
-            plan.gha = answers.gha;
-        if (answers.plugin !== undefined)
-            plan.plugin = answers.plugin;
-    }
+    if (answers)
+        applyAnswers(plan, answers);
     return plan;
 }
 //# sourceMappingURL=setup-plan.js.map

package/dist/testing.d.ts

@@ -4,9 +4,14 @@
  * (eval) — plus the runner-agnostic predicates/assertions. Kept deliberately
  * separate from `vigiles/claude-code` so this surface can stay harness-agnostic as
  * more harnesses are added. Granular paths (`vigiles/run-hook`, etc.) still work.
+ *
+ * It re-exports the composition-root runner modules (which do the Claude-Code
+ * default-wiring), never an adapter directly — the `agnostic-surface` eslint
+ * boundary forbids importing `src/adapters/*` from here. See
+ * `research/adapter-api-design.md`.
  */
-export * from "./adapters/claude-code/run-hook.js";
-export * from "./adapters/claude-code/harness-test.js";
-export * from "./adapters/claude-code/eval.js";
+export * from "./run-hook.js";
+export * from "./harness-test.js";
+export * from "./eval.js";
 export * from "./harness-assert.js";
 //# sourceMappingURL=testing.d.ts.map

package/dist/testing.js

@@ -20,9 +20,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * (eval) — plus the runner-agnostic predicates/assertions. Kept deliberately
  * separate from `vigiles/claude-code` so this surface can stay harness-agnostic as
  * more harnesses are added. Granular paths (`vigiles/run-hook`, etc.) still work.
+ *
+ * It re-exports the composition-root runner modules (which do the Claude-Code
+ * default-wiring), never an adapter directly — the `agnostic-surface` eslint
+ * boundary forbids importing `src/adapters/*` from here. See
+ * `research/adapter-api-design.md`.
  */
-__exportStar(require("./adapters/claude-code/run-hook.js"), exports);
-__exportStar(require("./adapters/claude-code/harness-test.js"), exports);
-__exportStar(require("./adapters/claude-code/eval.js"), exports);
+__exportStar(require("./run-hook.js"), exports);
+__exportStar(require("./harness-test.js"), exports);
+__exportStar(require("./eval.js"), exports);
 __exportStar(require("./harness-assert.js"), exports);
 //# sourceMappingURL=testing.js.map

package/dist/unit.d.ts

@@ -12,6 +12,6 @@
  * `vigiles/e2e`.
  */
 export * from "./harness-assert.js";
-export { runHook, parseHookOutput, decideHook, } from "./adapters/claude-code/run-hook.js";
-export type { HookInput, HookOutput, HookRunResult, RunHookOptions, } from "./adapters/claude-code/run-hook.js";
+export { runHook, parseHookOutput, decideHook } from "./run-hook.js";
+export type { HookInput, HookOutput, HookRunResult, RunHookOptions, } from "./run-hook.js";
 //# sourceMappingURL=unit.d.ts.map

package/dist/unit.js

@@ -29,7 +29,7 @@ exports.decideHook = exports.parseHookOutput = exports.runHook = void 0;
  * `vigiles/e2e`.
  */
 __exportStar(require("./harness-assert.js"), exports);
-var run_hook_js_1 = require("./adapters/claude-code/run-hook.js");
+var run_hook_js_1 = require("./run-hook.js");
 Object.defineProperty(exports, "runHook", { enumerable: true, get: function () { return run_hook_js_1.runHook; } });
 Object.defineProperty(exports, "parseHookOutput", { enumerable: true, get: function () { return run_hook_js_1.parseHookOutput; } });
 Object.defineProperty(exports, "decideHook", { enumerable: true, get: function () { return run_hook_js_1.decideHook; } });

package/hooks/session-start.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
-# SessionStart hook — inject a one-line vigiles audit summary into
+# SessionStart hook — inject a one-line vigiles lint summary into
 # Claude's context at session start and after compaction.
 #
-# Uses `vigiles audit --summary` which is designed for this: it
+# Uses `vigiles lint --summary` which is designed for this: it
 # silences all per-stage output and prints a single line like
 #   vigiles: 3 stale / 2 validation errors / 1 duplicate
 # (or "vigiles: clean") so the injection costs a handful of tokens.
@@ -24,7 +24,7 @@ fi
 
 # Prefer local install, fall back to npx.
 if command -v npx &>/dev/null; then
-  SUMMARY=$(npx --no-install vigiles audit --summary 2>/dev/null || true)
+  SUMMARY=$(npx --no-install vigiles lint --summary 2>/dev/null || true)
 else
   exit 0
 fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vigiles",
-  "version": "3.0.0",
+  "version": "4.0.1",
   "description": "Compile .spec.ts files to instruction files (CLAUDE.md, AGENTS.md) with linter cross-referencing",
   "bin": {
     "vigiles": "dist/cli.js"
@@ -20,14 +20,14 @@
     "./spec": "./dist/core/spec.js",
     "./compile": "./dist/core/compile.js",
     "./linters": "./dist/core/linters.js",
-    "./eval": "./dist/adapters/claude-code/eval.js",
-    "./harness-test": "./dist/adapters/claude-code/harness-test.js",
+    "./eval": "./dist/eval.js",
+    "./harness-test": "./dist/harness-test.js",
     "./harness-assert": "./dist/harness-assert.js",
-    "./run-hook": "./dist/adapters/claude-code/run-hook.js",
+    "./run-hook": "./dist/run-hook.js",
     "./plugin-loader": "./dist/adapters/claude-code/plugin-loader.js",
     "./mcp": "./dist/core/mcp.js",
-    "./judge": "./dist/adapters/claude-code/judge.js",
-    "./mock-model": "./dist/adapters/claude-code/mock-model.js",
+    "./judge": "./dist/judge.js",
+    "./mock-model": "./dist/mock-model.js",
     "./vitest": {
       "types": "./dist/vitest.d.mts",
       "default": "./dist/vitest.mjs"

package/skills/audit-feedback-loop/SKILL.md

@@ -1,76 +0,0 @@
----
-name: audit-feedback-loop
-description: Scan the current repo and score its feedback loop maturity for AI-assisted development
-disable-model-invocation: true
----
-
-Scan the current repository and score its feedback loop maturity for AI-assisted development.
-
-## Instructions
-
-Analyze this repository and score its **feedback loop maturity** using the levels below. Check for each signal, then output a summary report.
-
-### Maturity Levels
-
-**Level 0 — Vibes**
-No CI config, no linter rules, no CLAUDE.md. The AI agent is flying blind.
-
-**Level 1 — Guardrails**
-Has CI + standard linters, but no custom rules. The agent gets basic feedback but can't learn project-specific conventions.
-
-**Level 2 — Architecture as Code**
-Has custom lint rules, CLAUDE.md rules have enforcement annotations. The agent gets rich, project-specific feedback.
-
-**Level 3 — The Organism**
-Has CI + custom rules + screenshot/visual tests + observability + scheduled agent tasks. The entire development loop is instrumented.
-
-### Signals to Check
-
-Scan the repository for the following and note which exist:
-
-1. **CI Configuration**: Look for `.github/workflows/`, `.circleci/`, `Jenkinsfile`, `.gitlab-ci.yml`, `bitbucket-pipelines.yml`, `.travis.yml`, etc.
-2. **Linter Config** (language-aware):
-   - **JS/TS**: `eslint.config.*`, `.eslintrc*`, `biome.json`, `.prettierrc*`, `deno.json`
-   - **Python**: `pyproject.toml` (look for `[tool.ruff]`, `[tool.pylint]`, `[tool.flake8]`), `setup.cfg`, `.flake8`, `ruff.toml`
-   - **Rust**: `clippy.toml`, `.clippy.toml`, `rustfmt.toml`
-   - **Go**: `.golangci.yml`, `.golangci.yaml`
-   - **Ruby**: `.rubocop.yml`
-   - **Java/Kotlin**: `checkstyle.xml`, `pmd.xml`, `detekt.yml`
-3. **Custom Lint Rules**: Look for custom plugins, rule directories, or inline rule definitions in linter configs
-   - JS/TS: `eslint-plugin-*`, `eslint-rules/` directories
-   - Python: custom Ruff/Pylint plugins, AST-based checks
-   - Rust: custom Clippy lints
-   - Go: custom analyzers
-4. **CLAUDE.md**: Check if `CLAUDE.md` exists at the repo root
-5. **CLAUDE.md Enforcement**: Check if using vigiles v2 specs (`CLAUDE.md.spec.ts` exists) or v1 annotations (`**Enforced by:**` in CLAUDE.md). v2 specs = higher maturity.
-6. **Type-Safe Specs**: Check for `CLAUDE.md.spec.ts` or `*.spec.ts` files — indicates typed spec compilation via vigiles v2
-7. **Generated Types**: Check for `.vigiles/generated.d.ts` — indicates linter rules are type-checked at authoring time
-8. **Screenshot/Visual Tests**: Look for Playwright (`playwright.config.*`), Cypress (`cypress.config.*`), Chromatic, Percy, BackstopJS configs
-9. **Observability**: Search for imports/usage of `@sentry/`, `dd-trace`, `@datadog/`, `newrelic`, `@opentelemetry/`, `sentry_sdk`, `structlog`, `tracing` (Rust), `opentelemetry` in source files
-10. **Scheduled Agent Tasks**: Look for cron patterns in CI configs, `.github/workflows/` with `schedule:` triggers, or references to scheduled Claude Code tasks
-
-### Output Format
-
-```
-## Feedback Loop Audit
-
-**Repository:** <repo name>
-**Primary language(s):** <detected languages>
-**Score: Level X — <Name>**
-
-### Signals Found
-- [x] CI Configuration: <details>
-- [ ] Custom Lint Rules: not found
-- [x] CLAUDE.md: found, 5 enforced / 2 guidance / 1 missing
-...
-
-### Recommendations
-1. <Most impactful next step to level up>
-2. <Second recommendation>
-3. <Third recommendation>
-
-### How to Level Up
-<Specific, actionable advice for reaching the next maturity level>
-```
-
-Be specific about file paths and what you found. Give actionable recommendations tailored to the project's language and toolchain.