@paths.design/caws-cli 11.0.0 → 11.1.0

package/dist/init/hook-packs/manifest-claude-code.js

@@ -0,0 +1,190 @@
+"use strict";
+// Claude Code hook pack manifest.
+//
+// Installs the v11-shape Claude Code hook plane into a repo. Activation
+// requires a session restart in Claude Code: hook registration is read at
+// session start, so installing mid-session does not affect the current
+// session's tool calls.
+//
+// Lineage entries this pack covers — see
+// packages/caws-cli/docs-status/failure-lineage.md:
+//   Entry 1  — git init catastrophic deletion (block-dangerous + classify_command)
+//   Entry 4  — worktree cross-contamination, inherited-dirty-state (worktree-guard)
+//   Entry 6  — stash-and-destroy (worktree-guard)
+//   Entry 8  — scope violations, union-mode interference (scope-guard)
+//   Entry 11 — ownership claim, CAWSFIX-31/32 (worktree-guard, session-caws-status)
+//   Entry 12 — unbound = no authority (scope-guard fail-closed)
+//   Entry 13 — working-spec.yaml baseline clobber (worktree-write-guard)
+//   Entry 16 — adjudicator overstep / role partitioning (the pack itself)
+//   Entry 17 — git --bare init bypass + danger latch (classify_command + block-dangerous + reset-danger-latch)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLAUDE_CODE_PACK = exports.CLAUDE_CODE_PACK_VERSION = void 0;
+// Pack version bumps when managed file contents change in a way that
+// existing installs should pick up via the managed_old_version → auto-
+// update path. Version 2 ships the strike-level diagnostic triage,
+// activation-banner wording fix, settings.json "why we don't write it"
+// note, and tightened ask/block semantics in block-dangerous.
+exports.CLAUDE_CODE_PACK_VERSION = 2;
+exports.CLAUDE_CODE_PACK = {
+    id: 'claude-code',
+    targetSurface: 'claude-code',
+    packVersion: exports.CLAUDE_CODE_PACK_VERSION,
+    cawsMinMajor: 11,
+    summary: 'v11-shape Claude Code hook pack: scope, worktree, dangerous-command, ' +
+        'and session lifecycle guards.',
+    activation: 'restart_required',
+    lifecycleEvents: ['pre_bash', 'pre_write', 'pre_edit', 'session_start', 'stop'],
+    stateModel: {
+        reads: [
+            '.caws/specs/*.yaml',
+            '.caws/worktrees.json',
+            '.caws/agents.json',
+            '.caws/policy.yaml',
+            'package.json',
+        ],
+        writes: [
+            '.claude/logs/audit.log',
+            '.claude/logs/session-*.log',
+            '.claude/hooks/state/danger-latch-*.json',
+            '.claude/hooks/state/guard-strikes-*.json',
+            'tmp/<session-id>/',
+        ],
+    },
+    lineageRefs: [1, 4, 6, 8, 11, 12, 13, 16, 17],
+    // Installed files. Order is deterministic (used by tests and by the
+    // install reporter). destPath is relative to repo root.
+    // sourcePath is relative to the pack root
+    // (packages/caws-cli/templates/hook-packs/claude-code/).
+    installedFiles: [
+        // -- Scope and worktree guards (v11-shape) --
+        {
+            destPath: '.claude/hooks/scope-guard.sh',
+            sourcePath: 'scope-guard.sh',
+            executable: true,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/worktree-guard.sh',
+            sourcePath: 'worktree-guard.sh',
+            executable: true,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/worktree-write-guard.sh',
+            sourcePath: 'worktree-write-guard.sh',
+            executable: true,
+            managed: true,
+        },
+        // -- Entry 17 dangerous-command hardening (preserved verbatim) --
+        {
+            destPath: '.claude/hooks/block-dangerous.sh',
+            sourcePath: 'block-dangerous.sh',
+            executable: true,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/classify_command.py',
+            sourcePath: 'classify_command.py',
+            executable: true,
+            managed: true,
+        },
+        // -- Human-authorized escape hatches (preserved) --
+        {
+            destPath: '.claude/hooks/reset-strikes.sh',
+            sourcePath: 'reset-strikes.sh',
+            executable: true,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/reset-danger-latch.sh',
+            sourcePath: 'reset-danger-latch.sh',
+            executable: true,
+            managed: true,
+        },
+        // -- Strike counter shared library (sourced by scope-guard) --
+        {
+            destPath: '.claude/hooks/guard-strikes.sh',
+            sourcePath: 'guard-strikes.sh',
+            executable: true,
+            managed: true,
+        },
+        // -- Session lifecycle and logging --
+        {
+            destPath: '.claude/hooks/session-caws-status.sh',
+            sourcePath: 'session-caws-status.sh',
+            executable: true,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/session-log.sh',
+            sourcePath: 'session-log.sh',
+            executable: true,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/audit.sh',
+            sourcePath: 'audit.sh',
+            executable: true,
+            managed: true,
+        },
+        // -- Shared libraries sourced by every hook script --
+        {
+            destPath: '.claude/hooks/runtime-paths.sh',
+            sourcePath: 'runtime-paths.sh',
+            executable: false,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/lib/parse-input.sh',
+            sourcePath: 'lib/parse-input.sh',
+            executable: false,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/lib/run-handlers.sh',
+            sourcePath: 'lib/run-handlers.sh',
+            executable: false,
+            managed: true,
+        },
+        // -- Dispatch entrypoints invoked from .claude/settings.json --
+        {
+            destPath: '.claude/hooks/dispatch/pre_tool_use.sh',
+            sourcePath: 'dispatch/pre_tool_use.sh',
+            executable: true,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/dispatch/post_tool_use.sh',
+            sourcePath: 'dispatch/post_tool_use.sh',
+            executable: true,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/dispatch/session_start.sh',
+            sourcePath: 'dispatch/session_start.sh',
+            executable: true,
+            managed: true,
+        },
+        {
+            destPath: '.claude/hooks/dispatch/stop.sh',
+            sourcePath: 'dispatch/stop.sh',
+            executable: true,
+            managed: true,
+        },
+        // NOTE: .claude/settings.json is NOT a managed pack file. It often
+        // carries user-authored `permissions` and `env` blocks that the pack
+        // should not touch. Install emits explicit instructions for the
+        // user to wire the four dispatch entrypoints into their existing
+        // settings.json (or to create one from the canonical snippet in
+        // CLAUDE.md if absent). This avoids JSON-merge complexity and
+        // preserves user-owned settings.
+        // -- Doctrine landing for hook editors --
+        {
+            destPath: '.claude/hooks/CLAUDE.md',
+            sourcePath: 'CLAUDE.md',
+            executable: false,
+            managed: true,
+        },
+    ],
+};
+//# sourceMappingURL=manifest-claude-code.js.map

package/dist/init/hook-packs/manifest-claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-claude-code.js","sourceRoot":"","sources":["../../../src/init/hook-packs/manifest-claude-code.ts"],"names":[],"mappings":"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"}

package/dist/init/hook-packs/register.d.ts

@@ -0,0 +1,19 @@
+import type { AgentSurface, HookPackV1 } from './types';
+export type PackResolution = {
+    readonly kind: 'pack';
+    readonly pack: HookPackV1;
+} | {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'declared_not_implemented';
+    readonly surface: Exclude<AgentSurface, 'none'>;
+};
+/** Resolve a requested surface to a pack manifest. */
+export declare function resolveHookPack(surface: AgentSurface): PackResolution;
+/** Full list of surfaces this CLI version recognizes (for help text and
+ *  validation). */
+export declare const KNOWN_SURFACES: readonly AgentSurface[];
+/** Surfaces that have a fully-implemented pack in this CLI version. */
+export declare const IMPLEMENTED_SURFACES: readonly AgentSurface[];
+export declare function isKnownSurface(value: string): value is AgentSurface;
+//# sourceMappingURL=register.d.ts.map

package/dist/init/hook-packs/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/init/hook-packs/register.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGxD,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IACE,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CACjD,CAAC;AAEN,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CASrE;AAED;mBACmB;AACnB,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAKjD,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,EAAE,SAAS,YAAY,EAAoB,CAAC;AAE7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE"}

package/dist/init/hook-packs/register.js

@@ -0,0 +1,37 @@
+"use strict";
+// Pack registry. Maps `--agent-surface <id>` to a `HookPackV1` manifest.
+//
+// v11.1 ships only the `claude-code` pack. `cursor` and `windsurf` are
+// recognized as values but resolution returns a "declared but not
+// implemented" diagnostic — the abstraction is in place so adding a
+// new pack is purely additive (drop a manifest, register it here).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMPLEMENTED_SURFACES = exports.KNOWN_SURFACES = void 0;
+exports.resolveHookPack = resolveHookPack;
+exports.isKnownSurface = isKnownSurface;
+const manifest_claude_code_1 = require("./manifest-claude-code");
+/** Resolve a requested surface to a pack manifest. */
+function resolveHookPack(surface) {
+    if (surface === 'none') {
+        return { kind: 'none' };
+    }
+    if (surface === 'claude-code') {
+        return { kind: 'pack', pack: manifest_claude_code_1.CLAUDE_CODE_PACK };
+    }
+    // cursor / windsurf: recognized but not yet implemented.
+    return { kind: 'declared_not_implemented', surface };
+}
+/** Full list of surfaces this CLI version recognizes (for help text and
+ *  validation). */
+exports.KNOWN_SURFACES = [
+    'claude-code',
+    'cursor',
+    'windsurf',
+    'none',
+];
+/** Surfaces that have a fully-implemented pack in this CLI version. */
+exports.IMPLEMENTED_SURFACES = ['claude-code'];
+function isKnownSurface(value) {
+    return exports.KNOWN_SURFACES.includes(value);
+}
+//# sourceMappingURL=register.js.map

package/dist/init/hook-packs/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/init/hook-packs/register.ts"],"names":[],"mappings":";AAAA,yEAAyE;AACzE,EAAE;AACF,uEAAuE;AACvE,kEAAkE;AAClE,oEAAoE;AACpE,mEAAmE;;;AAcnE,0CASC;AAcD,wCAEC;AApCD,iEAA0D;AAU1D,sDAAsD;AACtD,SAAgB,eAAe,CAAC,OAAqB;IACnD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uCAAgB,EAAE,CAAC;IAClD,CAAC;IACD,yDAAyD;IACzD,OAAO,EAAE,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,CAAC;AACvD,CAAC;AAED;mBACmB;AACN,QAAA,cAAc,GAA4B;IACrD,aAAa;IACb,QAAQ;IACR,UAAU;IACV,MAAM;CACP,CAAC;AAEF,uEAAuE;AAC1D,QAAA,oBAAoB,GAA4B,CAAC,aAAa,CAAC,CAAC;AAE7E,SAAgB,cAAc,CAAC,KAAa;IAC1C,OAAQ,sBAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}

package/dist/init/hook-packs/types.d.ts

@@ -0,0 +1,123 @@
+/** Supported agent harnesses. v11.1 implements claude-code only. */
+export type AgentSurface = 'claude-code' | 'cursor' | 'windsurf' | 'none';
+/** Lifecycle interception points a pack may register on a harness. */
+export type LifecycleEvent = 'pre_bash' | 'pre_write' | 'pre_edit' | 'session_start' | 'stop';
+/** A single file the pack installs, relative to the repo root. */
+export interface HookPackFile {
+    /** Destination path relative to repo root (e.g., `.claude/hooks/scope-guard.sh`). */
+    readonly destPath: string;
+    /** Source path within the templates tree, relative to the pack root
+     *  (e.g., `scope-guard.sh`). */
+    readonly sourcePath: string;
+    /** When true, the installed file must be executable (chmod +x). */
+    readonly executable: boolean;
+    /** When true, this file gets a managed header prepended/verified.
+     *  Set false for non-script auxiliary files where a comment marker
+     *  is not appropriate (e.g., a state directory placeholder). */
+    readonly managed: boolean;
+}
+/** State surfaces the pack reads from / writes to. Informational; used
+ *  by docs and by future drift detection. */
+export interface HookPackStateModel {
+    /** Files/dirs the pack reads (relative to repo root). */
+    readonly reads: readonly string[];
+    /** Files/dirs the pack writes (relative to repo root). */
+    readonly writes: readonly string[];
+}
+/** The pack manifest. */
+export interface HookPackV1 {
+    /** Pack identifier, stable across versions (e.g., "claude-code"). */
+    readonly id: string;
+    /** The harness this pack targets. */
+    readonly targetSurface: Exclude<AgentSurface, 'none'>;
+    /** Pack version. Bumps when managed file contents change in a way
+     *  that requires an update on re-install. */
+    readonly packVersion: number;
+    /** Minimum CAWS major version this pack is compatible with. */
+    readonly cawsMinMajor: number;
+    /** Lifecycle events this pack registers on the harness. */
+    readonly lifecycleEvents: readonly LifecycleEvent[];
+    /** Files installed by this pack, in deterministic order. */
+    readonly installedFiles: readonly HookPackFile[];
+    /** State surfaces (read/write paths). */
+    readonly stateModel: HookPackStateModel;
+    /** Failure-lineage entry numbers this pack covers. */
+    readonly lineageRefs: readonly number[];
+    /** Human-readable summary for init output. One short sentence. */
+    readonly summary: string;
+    /** Activation contract: whether installed hooks take effect in the
+     *  current harness session, or require a restart. */
+    readonly activation: 'immediate' | 'restart_required' | 'unknown';
+}
+/** Managed-file header fields. Used by install for parse/emit. */
+export interface ManagedHeader {
+    readonly hookPack: string;
+    readonly hookPackVersion: number;
+    readonly cawsMinMajor: number;
+    readonly lineageRefs: readonly number[];
+}
+/** Outcome of evaluating an installed-file path against the local filesystem
+ *  during install. */
+export type InstallFileState = 
+/** No file at destPath; safe to create. */
+{
+    readonly kind: 'absent';
+}
+/** Managed file at destPath matching this pack/version and unchanged
+ *  from bundled content. Safe to no-op. */
+ | {
+    readonly kind: 'managed_clean';
+    readonly header: ManagedHeader;
+}
+/** Managed file at destPath matching this pack but at an older version.
+ *  Safe to update under update policy. */
+ | {
+    readonly kind: 'managed_old_version';
+    readonly header: ManagedHeader;
+    readonly currentVersion: number;
+}
+/** Managed file at destPath matching this pack/version but content
+ *  differs from bundled. Refuses without --adopt or --overwrite. */
+ | {
+    readonly kind: 'managed_drift';
+    readonly header: ManagedHeader;
+}
+/** File at destPath without a managed header. Refuses without
+ *  --adopt or --overwrite. */
+ | {
+    readonly kind: 'unmanaged_collision';
+};
+/** Aggregate outcome of an install operation. */
+export type HookPackInstallOutcome = 
+/** Pack was installed for the first time (or new files added to an
+ *  existing pack install). */
+'installed'
+/** Pack files all present at correct version and content; no changes. */
+ | 'already_installed'
+/** Pack files updated from an older version. */
+ | 'updated'
+/** Caller explicitly chose `--agent-surface none`. No pack installed. */
+ | 'skipped_explicit_none'
+/** No harness detected, non-interactive mode. No pack installed, warning
+ *  emitted. */
+ | 'skipped_ambiguous';
+/** Per-file install action recorded for reporting. */
+export interface HookPackFileAction {
+    readonly destPath: string;
+    readonly action: 'created' | 'updated' | 'unchanged' | 'refused';
+    /** When action === 'refused', the reason. */
+    readonly refusalReason?: 'unmanaged_collision' | 'managed_drift';
+}
+/** Result of installing a pack into a repo. */
+export interface HookPackInstallResult {
+    readonly outcome: HookPackInstallOutcome;
+    /** The pack that was (or would have been) installed. Null when
+     *  outcome is 'skipped_explicit_none' or 'skipped_ambiguous'. */
+    readonly pack: HookPackV1 | null;
+    /** Per-file actions. */
+    readonly actions: readonly HookPackFileAction[];
+    /** Whether the harness requires a session restart for hooks to take
+     *  effect. Drives the activation banner. */
+    readonly activation: 'immediate' | 'restart_required' | 'unknown' | 'not_applicable';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/init/hook-packs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/init/hook-packs/types.ts"],"names":[],"mappings":"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"}

package/dist/init/hook-packs/types.js

@@ -0,0 +1,29 @@
+"use strict";
+// HookPackV1 — manifest model for harness-specific hook packs installed by
+// `caws init --agent-surface <name>`.
+//
+// A hook pack is the **runtime adapter** that projects CAWS authority into
+// an agent harness's lifecycle (Claude Code, Cursor, Windsurf, etc.).
+// The kernel/store/shell trinity owns canonical state. The pack interposes
+// at pre-Edit/Write/Bash, where the kernel cannot reach (it runs downstream
+// of the agent's tool call).
+//
+// Every file installed by a pack carries a CAWS-MANAGED-HOOK header:
+//
+//   # CAWS-MANAGED-HOOK
+//   # hook_pack: <id>
+//   # hook_pack_version: <pack_version>
+//   # caws_min_major: <caws_min_major>
+//   # lineage_refs: <comma-separated lineage entry numbers>
+//   # do_not_edit_directly: update via `caws init --agent-surface <id>`
+//
+// The marker is what install/update uses to distinguish managed files
+// (safe to rewrite under explicit policy) from local user files (refused
+// without --adopt/--overwrite).
+//
+// Lineage: every pack must declare which failure-lineage entries it covers
+// (packages/caws-cli/docs-status/failure-lineage.md). Removing or weakening
+// a pack file requires naming the entry and identifying the replacement
+// mechanism.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/init/hook-packs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/init/hook-packs/types.ts"],"names":[],"mappings":";AAAA,2EAA2E;AAC3E,sCAAsC;AACtC,EAAE;AACF,2EAA2E;AAC3E,sEAAsE;AACtE,2EAA2E;AAC3E,4EAA4E;AAC5E,6BAA6B;AAC7B,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,wBAAwB;AACxB,sBAAsB;AACtB,wCAAwC;AACxC,uCAAuC;AACvC,4DAA4D;AAC5D,wEAAwE;AACxE,EAAE;AACF,sEAAsE;AACtE,yEAAyE;AACzE,gCAAgC;AAChC,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AACxE,aAAa"}

package/dist/shell/commands/gates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../../../src/shell/commands/gates.ts"],"names":[],"mappings":"AAyCA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAMxC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AA6CD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,GAAE,sBAA2B,GAChC,MAAM,CAgIR"}
+{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../../../src/shell/commands/gates.ts"],"names":[],"mappings":"AA2CA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAMxC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AA6CD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,GAAE,sBAA2B,GAChC,MAAM,CA6JR"}

package/dist/shell/commands/gates.js

@@ -28,6 +28,7 @@ const resolve_session_1 = require("../session/resolve-session");
 const actor_1 = require("../session/actor");
 const rules_1 = require("../rules");
 const disposition_1 = require("../gates/disposition");
+const local_evaluators_1 = require("../gates/local-evaluators");
 const quality_gates_adapter_1 = require("../gates/quality-gates-adapter");
 const waiver_filter_1 = require("../gates/waiver-filter");
 const MAX_EVENT_VIOLATIONS = 100;
@@ -135,6 +136,32 @@ function runGatesRunCommand(request, opts = {}) {
         return 2;
     }
     const report = reportResult.value;
+    // 5b. Local CAWS policy evaluators. These produce violations under
+    //     canonical policy gate IDs (budget_limit, scope_boundary,
+    //     spec_completeness) that the subprocess does not emit. Locating
+    //     them in caws-cli (not in the generic quality-gates subprocess)
+    //     keeps quality-gates decoupled from spec/policy authority.
+    //
+    //     The active spec must exist and be loadable. If it isn't,
+    //     refuse the run with a typed diagnostic — running gates against
+    //     a missing or unparseable spec is a category error.
+    const activeSpec = snapshot.specs.find((s) => s.id === request.specId);
+    if (activeSpec === undefined) {
+        err(`caws gates run: spec ${request.specId} not found in .caws/specs/. ` +
+            `Either the id is wrong, or the spec failed to load (run \`caws doctor\` for details).`);
+        err(`(rule: ${rules_1.SHELL_RULES.GATES_POLICY_REQUIRED})`);
+        return 2;
+    }
+    const localResult = (0, local_evaluators_1.runLocalEvaluators)({
+        spec: activeSpec,
+        policy,
+        repoRoot,
+        nowIso: now.toISOString(),
+    });
+    const mergedReport = {
+        ...report,
+        violations: [...report.violations, ...localResult.violations],
+    };
     // 6a. Load + apply waivers BEFORE disposition.
     //     Waivers do NOT mutate policy.gates[gate].mode. They remove
     //     authorized-exception violations from the report so blocking is
@@ -145,7 +172,7 @@ function runGatesRunCommand(request, opts = {}) {
         err((0, diagnostic_1.renderDiagnostics)(waiversLoad.diagnostics, { showData }));
     }
     const waiverFilter = (0, waiver_filter_1.filterWaivedViolations)({
-        report,
+        report: mergedReport,
         waivers: waiversLoad.waivers,
         specId: request.specId,
         now,

package/dist/shell/commands/gates.js.map

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

package/dist/shell/commands/init.d.ts

@@ -1,8 +1,17 @@
+import type { AgentSurface } from '../../init/hook-packs/types';
 export interface InitCommandOptions {
     readonly cwd?: string;
     readonly out?: (line: string) => void;
     readonly err?: (line: string) => void;
     readonly showData?: boolean;
+    /** Selected agent harness. When undefined, the command attempts
+     *  filesystem detection. */
+    readonly agentSurface?: AgentSurface;
+    /** When true, overwrite drifted/unmanaged files at managed pack paths. */
+    readonly overwrite?: boolean;
+    /** When true, leave drifted/unmanaged files in place; do not enforce
+     *  pack contents at those paths. */
+    readonly adopt?: boolean;
 }
 export declare function runInitCommand(opts?: InitCommandOptions): number;
 //# sourceMappingURL=init.d.ts.map

package/dist/shell/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/shell/commands/init.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,kBAAuB,GAAG,MAAM,CAsCpE"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/shell/commands/init.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,6BAA6B,CAAC;AAUrC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;gCAC4B;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;wCACoC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AA0ED,wBAAgB,cAAc,CAAC,IAAI,GAAE,kBAAuB,GAAG,MAAM,CAoGpE"}