@paths.design/caws-cli 11.0.0 → 11.1.1

package/dist/shell/commands/init.js

@@ -1,42 +1,110 @@
 "use strict";
-// `caws init` — vNext bootstrap of the canonical .caws/ shape.
+// `caws init` — vNext bootstrap of the canonical .caws/ shape, plus
+// optional hook-pack install for the operating agent harness.
 //
 // Pipeline:
 //   1. resolveRepoRoot(cwd)             — needs git, NOT .caws/
 //   2. initProject(repoRoot)            — store-side adapter does the work
-//   3. render result                    — short summary or "already initialized"
+//   3. render canonical-state result    — step 1 message
+//   4. resolve agent surface            — from --agent-surface or detection
+//   5. install hook pack (or skip)      — step 2 message
+//   6. inspect .claude/settings.json    — step 3 message
+//   7. emit activation contract         — step 4 message
+//
+// The init surface is **non-interactive**. All decisions come from CLI
+// flags or filesystem signals; nothing prompts. Each step prints a
+// clearly-labeled section so a turn-by-turn agent can read what
+// happened and what to do next.
 //
 // Exit codes:
 //   0 = canonical state established (created OR already_initialized)
-//   1 = legacy residue refused (INIT_LEGACY_RESIDUE) — non-destructive,
-//       the user must clear the listed files manually
-//   2 = repo-root resolution failed, write I/O failed, or the default
-//       policy itself failed kernel validation
-//       (INIT_DEFAULT_POLICY_INVALID — programmer error in our seed)
-//
-// Discipline:
-//   - No --force in 7b. Force modes turn into cleanup tools and cleanup
-//     belongs to a later doctor/repair surface.
-//   - The seeded policy MUST pass kernel validation BEFORE landing on
-//     disk. If our default is bad, that's a programmer error and exit 2
-//     is correct — we do NOT write a known-invalid policy just to keep
-//     `init` succeeding.
-//   - Init never overwrites existing canonical files. Idempotent rerun
-//     reports "already initialized"; partial state is filled in
-//     additively (a half-bootstrapped project becomes whole).
+//       AND hook-pack step did not refuse files
+//   1 = legacy residue refused (INIT_LEGACY_RESIDUE)
+//       OR hook-pack install refused one or more files (use --adopt or
+//       --overwrite to resolve)
+//   2 = repo-root resolution failed, write I/O failed, or default
+//       policy invalid
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runInitCommand = runInitCommand;
+const harness_detect_1 = require("../../init/harness-detect");
+const hook_install_1 = require("../../init/hook-install");
+const register_1 = require("../../init/hook-packs/register");
 const store_1 = require("../../store");
 const diagnostic_1 = require("../render/diagnostic");
 const init_1 = require("../render/init");
+const init_hook_pack_1 = require("../render/init-hook-pack");
+function chooseSurface(explicit, detection) {
+    if (explicit !== undefined) {
+        return { surface: explicit, reason: 'explicit' };
+    }
+    if (detection.kind === 'single') {
+        return { surface: detection.surface, reason: 'detected' };
+    }
+    if (detection.kind === 'ambiguous') {
+        return { surface: null, reason: 'ambiguous' };
+    }
+    return { surface: null, reason: 'none' };
+}
+function performHookPackStep(repoRoot, surface, reason, options) {
+    if (surface === null) {
+        // No surface chosen — emit skipped_ambiguous.
+        return {
+            outcome: 'skipped_ambiguous',
+            pack: null,
+            actions: [],
+            activation: 'not_applicable',
+        };
+    }
+    if (surface === 'none') {
+        return {
+            outcome: 'skipped_explicit_none',
+            pack: null,
+            actions: [],
+            activation: 'not_applicable',
+        };
+    }
+    const resolution = (0, register_1.resolveHookPack)(surface);
+    if (resolution.kind === 'declared_not_implemented') {
+        // Treat as a skip with a clear message in the renderer.
+        return {
+            outcome: 'skipped_ambiguous',
+            pack: null,
+            actions: [],
+            activation: 'not_applicable',
+        };
+    }
+    if (resolution.kind === 'none') {
+        return {
+            outcome: 'skipped_explicit_none',
+            pack: null,
+            actions: [],
+            activation: 'not_applicable',
+        };
+    }
+    const installOpts = { repoRoot };
+    if (options.overwrite !== undefined) {
+        installOpts.overwrite = options.overwrite;
+    }
+    if (options.adopt !== undefined) {
+        installOpts.adopt = options.adopt;
+    }
+    return (0, hook_install_1.installHookPack)(resolution.pack, installOpts);
+}
 function runInitCommand(opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
     const out = opts.out ?? ((s) => process.stdout.write(s + '\n'));
     const err = opts.err ?? ((s) => process.stderr.write(s + '\n'));
     const showData = opts.showData === true;
-    // 1. Resolve repo root. We do NOT pass requireCawsDir — the whole
-    //    point of init is to create .caws/, so failing on its absence
-    //    here would be self-contradictory.
+    // Validate --agent-surface early. An unknown value is a programmer
+    // error from the caller (or a typo at the CLI); fail fast with a
+    // clear diagnostic.
+    if (opts.agentSurface !== undefined &&
+        !(0, register_1.isKnownSurface)(opts.agentSurface)) {
+        err(`caws init: unknown --agent-surface "${opts.agentSurface}".`);
+        err('  Known values: claude-code, cursor, windsurf, none.');
+        return 2;
+    }
+    // Step 0: resolve repo root.
     const root = (0, store_1.resolveRepoRoot)(cwd);
     if (!root.ok) {
         err('caws init: failed to resolve repo root.');
@@ -44,12 +112,9 @@ function runInitCommand(opts = {}) {
         return 2;
     }
     const { repoRoot } = root.value;
-    // 2. Bootstrap.
+    // Step 1: bootstrap canonical .caws/ state.
     const result = (0, store_1.initProject)(repoRoot);
     if (!result.ok) {
-        // Decide exit code from the diagnostic rule. Legacy residue is a
-        // user-correctable domain error (1); everything else is a hard
-        // store/programmer failure (2).
         const isLegacy = result.errors.some((d) => d.rule === 'store.init.legacy_residue');
         err(isLegacy
             ? 'caws init: refusing to overwrite legacy state.'
@@ -57,8 +122,47 @@ function runInitCommand(opts = {}) {
         err((0, diagnostic_1.renderDiagnostics)(result.errors, { showData }));
         return isLegacy ? 1 : 2;
     }
-    // 3. Render and exit.
     out((0, init_1.renderInit)({ result: result.value, repoRoot }));
-    return 0;
+    // Step 2: choose the agent surface and install the hook pack.
+    const detection = (0, harness_detect_1.detectAgentHarness)(repoRoot);
+    const chosen = chooseSurface(opts.agentSurface, detection);
+    const hookPackResult = performHookPackStep(repoRoot, chosen.surface, chosen.reason, opts);
+    // When detection produced an ambiguous result and no explicit flag,
+    // the renderer's skipped_ambiguous branch handles the message.
+    // When the user requested an unimplemented surface (cursor, windsurf
+    // today), the renderer surfaces it as a skipped-ambiguous with the
+    // same instruction shape.
+    if (opts.agentSurface !== undefined &&
+        opts.agentSurface !== 'none' &&
+        chosen.surface !== null) {
+        const resolution = (0, register_1.resolveHookPack)(opts.agentSurface);
+        if (resolution.kind === 'declared_not_implemented') {
+            err(`caws init: --agent-surface "${opts.agentSurface}" is declared but not yet implemented in this CLI version.`);
+            err('  Known values: claude-code, cursor, windsurf, none.');
+            err('  Implemented values: claude-code.');
+            // Surface the canonical-state success (step 1 already printed) so
+            // the user knows .caws/ is set up.
+            return 1;
+        }
+    }
+    out((0, init_hook_pack_1.renderHookPackInstall)(hookPackResult));
+    // Step 3: inspect .claude/settings.json. Only meaningful when a pack
+    // was actually installed (claude-code in v11.1). For 'none' or
+    // 'skipped_ambiguous', skip this check.
+    let wiringStatus;
+    if (hookPackResult.pack !== null) {
+        wiringStatus = (0, hook_install_1.inspectClaudeSettings)(repoRoot);
+        out((0, init_hook_pack_1.renderSettingsWiring)(wiringStatus));
+    }
+    // Step 4: activation contract. The contract message tailors to whether
+    // anything was actually installed/updated this run AND whether the
+    // settings.json wiring is in place — without those signals the panel
+    // becomes a constant STOP sign on re-runs, training agents to ignore
+    // it.
+    out((0, init_hook_pack_1.renderActivationContract)(hookPackResult, wiringStatus));
+    // Exit code: refusal in pack install → 1 so callers see something went
+    // wrong; otherwise 0.
+    const anyRefused = hookPackResult.actions.some((a) => a.action === 'refused');
+    return anyRefused ? 1 : 0;
 }
 //# sourceMappingURL=init.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/shell/commands/init.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,EAAE;AACF,YAAY;AACZ,gEAAgE;AAChE,2EAA2E;AAC3E,iFAAiF;AACjF,EAAE;AACF,cAAc;AACd,qEAAqE;AACrE,wEAAwE;AACxE,sDAAsD;AACtD,sEAAsE;AACtE,+CAA+C;AAC/C,qEAAqE;AACrE,EAAE;AACF,cAAc;AACd,wEAAwE;AACxE,gDAAgD;AAChD,sEAAsE;AACtE,wEAAwE;AACxE,uEAAuE;AACvE,yBAAyB;AACzB,uEAAuE;AACvE,gEAAgE;AAChE,8DAA8D;;AAa9D,wCAsCC;AAjDD,uCAA2D;AAC3D,qDAAyD;AACzD,yCAA4C;AAS5C,SAAgB,cAAc,CAAC,OAA2B,EAAE;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;IAExC,kEAAkE;IAClE,kEAAkE;IAClE,uCAAuC;IACvC,MAAM,IAAI,GAAG,IAAA,uBAAe,EAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,GAAG,CAAC,yCAAyC,CAAC,CAAC;QAC/C,GAAG,CAAC,IAAA,8BAAiB,EAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;IAEhC,gBAAgB;IAChB,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,iEAAiE;QACjE,+DAA+D;QAC/D,gCAAgC;QAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,2BAA2B,CAC9C,CAAC;QACF,GAAG,CACD,QAAQ;YACN,CAAC,CAAC,gDAAgD;YAClD,CAAC,CAAC,yCAAyC,CAC9C,CAAC;QACF,GAAG,CAAC,IAAA,8BAAiB,EAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACpD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,sBAAsB;IACtB,GAAG,CAAC,IAAA,iBAAU,EAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/shell/commands/init.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,41 @@
+import { type ActorKind } from '@paths.design/caws-kernel';
+interface BaseCommandOptions {
+    readonly cwd?: string;
+    readonly now?: () => Date;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly out?: (line: string) => void;
+    readonly err?: (line: string) => void;
+    readonly showData?: boolean;
+    readonly actorKind?: ActorKind;
+}
+export interface SpecsCreateOptions extends BaseCommandOptions {
+    readonly id: string;
+    readonly title: string;
+    readonly mode: string;
+    readonly riskTier: number | string;
+}
+export declare function runSpecsCreateCommand(opts: SpecsCreateOptions): number;
+export interface SpecsListOptions extends BaseCommandOptions {
+    /** Include archived specs in the listing. */
+    readonly includeArchived?: boolean;
+}
+export declare function runSpecsListCommand(opts?: SpecsListOptions): number;
+export interface SpecsShowOptions extends BaseCommandOptions {
+    readonly id: string;
+}
+export declare function runSpecsShowCommand(opts: SpecsShowOptions): number;
+export interface SpecsCloseOptions extends BaseCommandOptions {
+    readonly id: string;
+    readonly resolution: string;
+    readonly reason?: string;
+    readonly mergeCommit?: string;
+    readonly supersededBy?: string;
+}
+export declare function runSpecsCloseCommand(opts: SpecsCloseOptions): number;
+export interface SpecsArchiveOptions extends BaseCommandOptions {
+    readonly id: string;
+    readonly reason?: string;
+}
+export declare function runSpecsArchiveCommand(opts: SpecsArchiveOptions): number;
+export {};
+//# sourceMappingURL=specs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../src/shell/commands/specs.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAoB7E,UAAU,kBAAkB;IAC1B,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,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAChC;AAyDD,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CACpC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAmDtE;AAID,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,6CAA6C;IAC7C,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,gBAAqB,GAAG,MAAM,CAgCvE;AAID,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAelE;AAID,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CA0CpE;AAID,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAgCxE"}

package/dist/shell/commands/specs.js

@@ -0,0 +1,264 @@
+"use strict";
+// `caws specs` command group — v11 spec lifecycle commands.
+//
+// CLI-SPECS-001: the canonical replacement for manual lifecycle YAML
+// edits. Five subcommands:
+//   - caws specs create <id> --title <title> --mode <mode> --risk-tier <n>
+//   - caws specs list [--archived]
+//   - caws specs show <id>
+//   - caws specs close <id> --resolution <r> [--reason <text>] [--merge-commit <sha>] [--superseded-by <id>]
+//   - caws specs archive <id> [--reason <text>]
+//
+// Discipline:
+//   - All mutation paths go through specs-writer (which uses the
+//     lifecycle-transaction substrate from Slice 4).
+//   - The shell never appends events directly. Event append happens
+//     inside the writer, which routes through appendEvent.
+//   - The shell never patches YAML directly. yaml-patch lives in the
+//     store layer.
+//   - The shell parses CLI args, builds an actor envelope, calls the
+//     writer, and renders the outcome.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSpecsCreateCommand = runSpecsCreateCommand;
+exports.runSpecsListCommand = runSpecsListCommand;
+exports.runSpecsShowCommand = runSpecsShowCommand;
+exports.runSpecsCloseCommand = runSpecsCloseCommand;
+exports.runSpecsArchiveCommand = runSpecsArchiveCommand;
+const path = __importStar(require("node:path"));
+const caws_kernel_1 = require("@paths.design/caws-kernel");
+const store_1 = require("../../store");
+const specs_writer_1 = require("../../store/specs-writer");
+const actor_1 = require("../session/actor");
+const resolve_session_1 = require("../session/resolve-session");
+const diagnostic_1 = require("../render/diagnostic");
+const VALID_MODES = ['feature', 'refactor', 'fix', 'doc', 'chore'];
+const VALID_RESOLUTIONS = ['completed', 'superseded', 'abandoned'];
+function setupIO(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const nowFn = opts.now ?? (() => new Date());
+    const env = opts.env ?? process.env;
+    const out = opts.out ?? ((s) => process.stdout.write(s + '\n'));
+    const errFn = opts.err ?? ((s) => process.stderr.write(s + '\n'));
+    const showData = opts.showData === true;
+    return { cwd, nowFn, env, out, err: errFn, showData };
+}
+function resolveCawsCtx(cwd, errFn, showData, cmd) {
+    const r = (0, store_1.resolveRepoRoot)(cwd);
+    if (!r.ok) {
+        errFn(`caws specs ${cmd}: failed to resolve repo root.`);
+        errFn((0, diagnostic_1.renderDiagnostics)(r.errors, { showData }));
+        return null;
+    }
+    return { repoRoot: r.value.repoRoot, cawsDir: r.value.cawsDir };
+}
+function buildActorOrError(cawsDir, cwd, env, nowFn, actorKind, errFn, showData, cmd) {
+    const sessionResult = (0, resolve_session_1.resolveSession)({
+        cawsDir,
+        worktreeRoot: cwd,
+        env,
+        now: nowFn,
+        allowMint: true,
+    });
+    if (!sessionResult.ok) {
+        errFn(`caws specs ${cmd}: failed to resolve session identity.`);
+        errFn((0, diagnostic_1.renderDiagnostics)(sessionResult.errors, { showData }));
+        return null;
+    }
+    return (0, actor_1.buildActor)({
+        session: sessionResult.value,
+        kind: actorKind ?? 'agent',
+    });
+}
+function runSpecsCreateCommand(opts) {
+    const { cwd, nowFn, env, out, err, showData } = setupIO(opts);
+    if (!VALID_MODES.includes(opts.mode)) {
+        err(`caws specs create: invalid --mode "${opts.mode}". Expected one of: ${VALID_MODES.join(', ')}.`);
+        return 1;
+    }
+    const riskTier = typeof opts.riskTier === 'string'
+        ? Number.parseInt(opts.riskTier, 10)
+        : opts.riskTier;
+    if (riskTier !== 1 && riskTier !== 2 && riskTier !== 3) {
+        err(`caws specs create: invalid --risk-tier "${opts.riskTier}". Expected 1, 2, or 3.`);
+        return 1;
+    }
+    const ctx = resolveCawsCtx(cwd, err, showData, 'create');
+    if (ctx === null)
+        return 2;
+    const actor = buildActorOrError(ctx.cawsDir, cwd, env, nowFn, opts.actorKind, err, showData, 'create');
+    if (actor === null)
+        return 2;
+    const result = (0, specs_writer_1.createSpec)(ctx.cawsDir, {
+        id: opts.id,
+        title: opts.title,
+        mode: opts.mode,
+        riskTier: riskTier,
+        initialState: 'active',
+        now: nowFn,
+        actor,
+    });
+    if (!(0, caws_kernel_1.isOk)(result)) {
+        err('caws specs create: failed.');
+        err((0, diagnostic_1.renderDiagnostics)(result.errors, { showData }));
+        return 1;
+    }
+    const outcome = result.value;
+    if (outcome.kind === 'partial_failure_recovered') {
+        err('caws specs create: partial failure recovered (no state change).');
+        err((0, diagnostic_1.renderDiagnostics)(outcome.cause, { showData }));
+        return 1;
+    }
+    out(`created ${outcome.id} at ${path.relative(ctx.repoRoot, outcome.path)} (lifecycle_state: active)`);
+    return 0;
+}
+function runSpecsListCommand(opts = {}) {
+    const { cwd, out, err, showData } = setupIO(opts);
+    const ctx = resolveCawsCtx(cwd, err, showData, 'list');
+    if (ctx === null)
+        return 2;
+    const result = (0, specs_writer_1.listSpecs)(ctx.cawsDir, {
+        includeArchived: opts.includeArchived === true,
+    });
+    if (!(0, caws_kernel_1.isOk)(result)) {
+        err('caws specs list: failed.');
+        err((0, diagnostic_1.renderDiagnostics)(result.errors, { showData }));
+        return 1;
+    }
+    const { active, archived } = result.value;
+    if (active.length === 0 && archived.length === 0) {
+        out('(no specs)');
+        return 0;
+    }
+    for (const entry of active) {
+        const rel = path.relative(ctx.repoRoot, entry.path);
+        out(`${entry.id.padEnd(28)} ${entry.lifecycle_state.padEnd(8)} ${entry.title}`);
+        void rel;
+    }
+    if (opts.includeArchived === true && archived.length > 0) {
+        out('');
+        out('-- archived --');
+        for (const entry of archived) {
+            out(`${entry.id.padEnd(28)} ${entry.lifecycle_state.padEnd(8)} ${entry.title}`);
+        }
+    }
+    return 0;
+}
+function runSpecsShowCommand(opts) {
+    const { cwd, out, err, showData } = setupIO(opts);
+    const ctx = resolveCawsCtx(cwd, err, showData, 'show');
+    if (ctx === null)
+        return 2;
+    const result = (0, specs_writer_1.showSpec)(ctx.cawsDir, opts.id);
+    if (!(0, caws_kernel_1.isOk)(result)) {
+        err('caws specs show: failed.');
+        err((0, diagnostic_1.renderDiagnostics)(result.errors, { showData }));
+        return 1;
+    }
+    // Print the raw source so the user gets byte-faithful output
+    // (comments preserved, etc).
+    out(result.value.source);
+    return 0;
+}
+function runSpecsCloseCommand(opts) {
+    const { cwd, nowFn, env, out, err, showData } = setupIO(opts);
+    if (!VALID_RESOLUTIONS.includes(opts.resolution)) {
+        err(`caws specs close: invalid --resolution "${opts.resolution}". Expected one of: ${VALID_RESOLUTIONS.join(', ')}.`);
+        return 1;
+    }
+    const ctx = resolveCawsCtx(cwd, err, showData, 'close');
+    if (ctx === null)
+        return 2;
+    const actor = buildActorOrError(ctx.cawsDir, cwd, env, nowFn, opts.actorKind, err, showData, 'close');
+    if (actor === null)
+        return 2;
+    const input = {
+        id: opts.id,
+        resolution: opts.resolution,
+        now: nowFn,
+        actor,
+    };
+    if (opts.reason !== undefined)
+        input.reason = opts.reason;
+    if (opts.mergeCommit !== undefined)
+        input.mergeCommit = opts.mergeCommit;
+    if (opts.supersededBy !== undefined)
+        input.supersededBy = opts.supersededBy;
+    const result = (0, specs_writer_1.closeSpec)(ctx.cawsDir, input);
+    if (!(0, caws_kernel_1.isOk)(result)) {
+        err('caws specs close: failed.');
+        err((0, diagnostic_1.renderDiagnostics)(result.errors, { showData }));
+        return 1;
+    }
+    const outcome = result.value;
+    if (outcome.kind === 'partial_failure_recovered') {
+        err('caws specs close: partial failure recovered (no state change).');
+        err((0, diagnostic_1.renderDiagnostics)(outcome.cause, { showData }));
+        return 1;
+    }
+    out(`closed ${outcome.id} (resolution: ${opts.resolution})`);
+    return 0;
+}
+function runSpecsArchiveCommand(opts) {
+    const { cwd, nowFn, env, out, err, showData } = setupIO(opts);
+    const ctx = resolveCawsCtx(cwd, err, showData, 'archive');
+    if (ctx === null)
+        return 2;
+    const actor = buildActorOrError(ctx.cawsDir, cwd, env, nowFn, opts.actorKind, err, showData, 'archive');
+    if (actor === null)
+        return 2;
+    const input = {
+        id: opts.id,
+        now: nowFn,
+        actor,
+    };
+    if (opts.reason !== undefined)
+        input.reason = opts.reason;
+    const result = (0, specs_writer_1.archiveSpec)(ctx.cawsDir, input);
+    if (!(0, caws_kernel_1.isOk)(result)) {
+        err('caws specs archive: failed.');
+        err((0, diagnostic_1.renderDiagnostics)(result.errors, { showData }));
+        return 1;
+    }
+    const outcome = result.value;
+    if (outcome.kind === 'partial_failure_recovered') {
+        err('caws specs archive: partial failure recovered (no state change).');
+        err((0, diagnostic_1.renderDiagnostics)(outcome.cause, { showData }));
+        return 1;
+    }
+    out(`archived ${outcome.id} → ${path.relative(ctx.repoRoot, outcome.path)}`);
+    return 0;
+}
+//# sourceMappingURL=specs.js.map

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

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

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

@@ -0,0 +1,38 @@
+import { type ActorKind } from '@paths.design/caws-kernel';
+interface BaseCommandOptions {
+    readonly cwd?: string;
+    readonly now?: () => Date;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly out?: (line: string) => void;
+    readonly err?: (line: string) => void;
+    readonly showData?: boolean;
+    readonly actorKind?: ActorKind;
+}
+export interface WorktreeCreateOptions extends BaseCommandOptions {
+    readonly name: string;
+    readonly specId: string;
+    readonly baseBranch?: string;
+    readonly branch?: string;
+}
+export declare function runWorktreeCreateCommand(opts: WorktreeCreateOptions): number;
+export interface WorktreeListOptions extends BaseCommandOptions {
+}
+export declare function runWorktreeListCommand(opts?: WorktreeListOptions): number;
+export interface WorktreeBindOptions extends BaseCommandOptions {
+    readonly name: string;
+    readonly specId: string;
+}
+export declare function runWorktreeBindCommand(opts: WorktreeBindOptions): number;
+export interface WorktreeDestroyOptions extends BaseCommandOptions {
+    readonly name: string;
+    readonly abandonUnmerged?: boolean;
+}
+export declare function runWorktreeDestroyCommand(opts: WorktreeDestroyOptions): number;
+export interface WorktreeMergeOptions extends BaseCommandOptions {
+    readonly name: string;
+    readonly dryRun?: boolean;
+    readonly message?: string;
+}
+export declare function runWorktreeMergeCommand(opts: WorktreeMergeOptions): number;
+export {};
+//# sourceMappingURL=worktree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../../src/shell/commands/worktree.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,KAAK,SAAS,EAAQ,MAAM,2BAA2B,CAAC;AAcjE,UAAU,kBAAkB;IAC1B,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,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAChC;AAkED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAuC5E;AAID,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;CAAG;AAElE,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,mBAAwB,GAAG,MAAM,CAwB7E;AAID,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CA+BxE;AAID,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAkC9E;AAID,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CA0C1E"}