@paths.design/caws-cli 10.1.0 → 11.0.0

package/dist/shell/index.d.ts

@@ -0,0 +1,50 @@
+export { SHELL_RULES, SHELL_RULE_PREFIXES } from './rules';
+export type { ShellRule } from './rules';
+export { resolveSession, describeSessionSource } from './session/resolve-session';
+export type { ResolveSessionOptions, ResolvedSession, SessionCapsule, SessionSource, } from './session/types';
+export { buildActor } from './session/actor';
+export type { BuildActorOptions } from './session/actor';
+export { resolveBinding, parseWorktreePorcelain, } from './binding/resolve-binding';
+export type { GitWorktreeEntry, ResolveBindingInput, ResolvedBinding, } from './binding/types';
+export { renderDiagnostic, renderDiagnostics, countSeverities, } from './render/diagnostic';
+export type { RenderDiagnosticsOptions } from './render/diagnostic';
+export { renderFinding, renderFindings, countFindingSeverities, } from './render/finding';
+export type { RenderFindingsOptions } from './render/finding';
+export { renderDecision } from './render/decision';
+export type { RenderDecisionOptions } from './render/decision';
+export { runDoctorCommand } from './commands/doctor';
+export type { DoctorCommandOptions } from './commands/doctor';
+export { runScopeCommand } from './commands/scope';
+export type { ScopeCommandOptions, ScopeMode } from './commands/scope';
+export { runEvidenceRecordCommand } from './commands/evidence';
+export type { EvidenceKind, EvidenceRecordOptions, } from './commands/evidence';
+export { runClaimCommand } from './commands/claim';
+export type { ClaimCommandOptions } from './commands/claim';
+export { renderClaimPanel, classifyOwnership } from './render/claim';
+export type { ClaimPanelInput, OwnershipRelation } from './render/claim';
+export { runStatusCommand } from './commands/status';
+export type { StatusCommandOptions } from './commands/status';
+export { renderStatus } from './render/status';
+export type { StatusRenderInput } from './render/status';
+export { runGatesRunCommand } from './commands/gates';
+export type { GatesRunCommandOptions, GatesRunCommandRequest, } from './commands/gates';
+export { renderGatesRun } from './render/gates';
+export { validateGatesReport, } from './gates/gate-result-contract';
+export type { GatesReport, GatesViolation, GatesWarning, } from './gates/gate-result-contract';
+export { runQualityGates, resolveQualityGatesBin } from './gates/quality-gates-adapter';
+export type { QualityGatesRunner, QualityGatesRunnerInput, RunQualityGatesOptions, SubprocessResult, } from './gates/quality-gates-adapter';
+export { deriveDispositions } from './gates/disposition';
+export type { DispositionResult, GateDisposition, GateOutcome, } from './gates/disposition';
+export { filterWaivedViolations } from './gates/waiver-filter';
+export type { WaiverFilterInput, WaiverFilterResult, WaiverEvidence, } from './gates/waiver-filter';
+export { runWaiverCreateCommand, runWaiverListCommand, runWaiverShowCommand, runWaiverRevokeCommand, } from './commands/waiver';
+export type { WaiverCreateOptions, WaiverListOptions, WaiverShowOptions, WaiverRevokeOptions, } from './commands/waiver';
+export { renderWaiverSummary, renderWaiverDetail, } from './render/waiver';
+export type { RenderWaiverSummaryInput, RenderWaiverDetailInput, } from './render/waiver';
+export { runInitCommand } from './commands/init';
+export type { InitCommandOptions } from './commands/init';
+export { renderInit } from './render/init';
+export type { RenderInitInput } from './render/init';
+export { registerShellCommands } from './register';
+export type { RegisterShellCommandsOptions } from './register';
+//# sourceMappingURL=index.d.ts.map

package/dist/shell/index.d.ts.map

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

package/dist/shell/index.js

@@ -0,0 +1,73 @@
+"use strict";
+// Programmatic exports for the shell layer.
+//
+// Slice 5c lands four CLI commands (doctor, scope show, scope check,
+// evidence record) registered via `registerShellCommands(program)`.
+// Internals below the command surface are exported for tests and for
+// adjacent shell modules that need them (hooks, status renderer).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerShellCommands = exports.renderInit = exports.runInitCommand = exports.renderWaiverDetail = exports.renderWaiverSummary = exports.runWaiverRevokeCommand = exports.runWaiverShowCommand = exports.runWaiverListCommand = exports.runWaiverCreateCommand = exports.filterWaivedViolations = exports.deriveDispositions = exports.resolveQualityGatesBin = exports.runQualityGates = exports.validateGatesReport = exports.renderGatesRun = exports.runGatesRunCommand = exports.renderStatus = exports.runStatusCommand = exports.classifyOwnership = exports.renderClaimPanel = exports.runClaimCommand = exports.runEvidenceRecordCommand = exports.runScopeCommand = exports.runDoctorCommand = exports.renderDecision = exports.countFindingSeverities = exports.renderFindings = exports.renderFinding = exports.countSeverities = exports.renderDiagnostics = exports.renderDiagnostic = exports.parseWorktreePorcelain = exports.resolveBinding = exports.buildActor = exports.describeSessionSource = exports.resolveSession = exports.SHELL_RULE_PREFIXES = exports.SHELL_RULES = void 0;
+var rules_1 = require("./rules");
+Object.defineProperty(exports, "SHELL_RULES", { enumerable: true, get: function () { return rules_1.SHELL_RULES; } });
+Object.defineProperty(exports, "SHELL_RULE_PREFIXES", { enumerable: true, get: function () { return rules_1.SHELL_RULE_PREFIXES; } });
+var resolve_session_1 = require("./session/resolve-session");
+Object.defineProperty(exports, "resolveSession", { enumerable: true, get: function () { return resolve_session_1.resolveSession; } });
+Object.defineProperty(exports, "describeSessionSource", { enumerable: true, get: function () { return resolve_session_1.describeSessionSource; } });
+var actor_1 = require("./session/actor");
+Object.defineProperty(exports, "buildActor", { enumerable: true, get: function () { return actor_1.buildActor; } });
+var resolve_binding_1 = require("./binding/resolve-binding");
+Object.defineProperty(exports, "resolveBinding", { enumerable: true, get: function () { return resolve_binding_1.resolveBinding; } });
+Object.defineProperty(exports, "parseWorktreePorcelain", { enumerable: true, get: function () { return resolve_binding_1.parseWorktreePorcelain; } });
+var diagnostic_1 = require("./render/diagnostic");
+Object.defineProperty(exports, "renderDiagnostic", { enumerable: true, get: function () { return diagnostic_1.renderDiagnostic; } });
+Object.defineProperty(exports, "renderDiagnostics", { enumerable: true, get: function () { return diagnostic_1.renderDiagnostics; } });
+Object.defineProperty(exports, "countSeverities", { enumerable: true, get: function () { return diagnostic_1.countSeverities; } });
+var finding_1 = require("./render/finding");
+Object.defineProperty(exports, "renderFinding", { enumerable: true, get: function () { return finding_1.renderFinding; } });
+Object.defineProperty(exports, "renderFindings", { enumerable: true, get: function () { return finding_1.renderFindings; } });
+Object.defineProperty(exports, "countFindingSeverities", { enumerable: true, get: function () { return finding_1.countFindingSeverities; } });
+var decision_1 = require("./render/decision");
+Object.defineProperty(exports, "renderDecision", { enumerable: true, get: function () { return decision_1.renderDecision; } });
+var doctor_1 = require("./commands/doctor");
+Object.defineProperty(exports, "runDoctorCommand", { enumerable: true, get: function () { return doctor_1.runDoctorCommand; } });
+var scope_1 = require("./commands/scope");
+Object.defineProperty(exports, "runScopeCommand", { enumerable: true, get: function () { return scope_1.runScopeCommand; } });
+var evidence_1 = require("./commands/evidence");
+Object.defineProperty(exports, "runEvidenceRecordCommand", { enumerable: true, get: function () { return evidence_1.runEvidenceRecordCommand; } });
+var claim_1 = require("./commands/claim");
+Object.defineProperty(exports, "runClaimCommand", { enumerable: true, get: function () { return claim_1.runClaimCommand; } });
+var claim_2 = require("./render/claim");
+Object.defineProperty(exports, "renderClaimPanel", { enumerable: true, get: function () { return claim_2.renderClaimPanel; } });
+Object.defineProperty(exports, "classifyOwnership", { enumerable: true, get: function () { return claim_2.classifyOwnership; } });
+var status_1 = require("./commands/status");
+Object.defineProperty(exports, "runStatusCommand", { enumerable: true, get: function () { return status_1.runStatusCommand; } });
+var status_2 = require("./render/status");
+Object.defineProperty(exports, "renderStatus", { enumerable: true, get: function () { return status_2.renderStatus; } });
+var gates_1 = require("./commands/gates");
+Object.defineProperty(exports, "runGatesRunCommand", { enumerable: true, get: function () { return gates_1.runGatesRunCommand; } });
+var gates_2 = require("./render/gates");
+Object.defineProperty(exports, "renderGatesRun", { enumerable: true, get: function () { return gates_2.renderGatesRun; } });
+var gate_result_contract_1 = require("./gates/gate-result-contract");
+Object.defineProperty(exports, "validateGatesReport", { enumerable: true, get: function () { return gate_result_contract_1.validateGatesReport; } });
+var quality_gates_adapter_1 = require("./gates/quality-gates-adapter");
+Object.defineProperty(exports, "runQualityGates", { enumerable: true, get: function () { return quality_gates_adapter_1.runQualityGates; } });
+Object.defineProperty(exports, "resolveQualityGatesBin", { enumerable: true, get: function () { return quality_gates_adapter_1.resolveQualityGatesBin; } });
+var disposition_1 = require("./gates/disposition");
+Object.defineProperty(exports, "deriveDispositions", { enumerable: true, get: function () { return disposition_1.deriveDispositions; } });
+var waiver_filter_1 = require("./gates/waiver-filter");
+Object.defineProperty(exports, "filterWaivedViolations", { enumerable: true, get: function () { return waiver_filter_1.filterWaivedViolations; } });
+var waiver_1 = require("./commands/waiver");
+Object.defineProperty(exports, "runWaiverCreateCommand", { enumerable: true, get: function () { return waiver_1.runWaiverCreateCommand; } });
+Object.defineProperty(exports, "runWaiverListCommand", { enumerable: true, get: function () { return waiver_1.runWaiverListCommand; } });
+Object.defineProperty(exports, "runWaiverShowCommand", { enumerable: true, get: function () { return waiver_1.runWaiverShowCommand; } });
+Object.defineProperty(exports, "runWaiverRevokeCommand", { enumerable: true, get: function () { return waiver_1.runWaiverRevokeCommand; } });
+var waiver_2 = require("./render/waiver");
+Object.defineProperty(exports, "renderWaiverSummary", { enumerable: true, get: function () { return waiver_2.renderWaiverSummary; } });
+Object.defineProperty(exports, "renderWaiverDetail", { enumerable: true, get: function () { return waiver_2.renderWaiverDetail; } });
+var init_1 = require("./commands/init");
+Object.defineProperty(exports, "runInitCommand", { enumerable: true, get: function () { return init_1.runInitCommand; } });
+var init_2 = require("./render/init");
+Object.defineProperty(exports, "renderInit", { enumerable: true, get: function () { return init_2.renderInit; } });
+var register_1 = require("./register");
+Object.defineProperty(exports, "registerShellCommands", { enumerable: true, get: function () { return register_1.registerShellCommands; } });
+//# sourceMappingURL=index.js.map

package/dist/shell/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shell/index.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,EAAE;AACF,qEAAqE;AACrE,oEAAoE;AACpE,qEAAqE;AACrE,kEAAkE;;;AAElE,iCAA2D;AAAlD,oGAAA,WAAW,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AAGzC,6DAAkF;AAAzE,iHAAA,cAAc,OAAA;AAAE,wHAAA,qBAAqB,OAAA;AAQ9C,yCAA6C;AAApC,mGAAA,UAAU,OAAA;AAGnB,6DAGmC;AAFjC,iHAAA,cAAc,OAAA;AACd,yHAAA,sBAAsB,OAAA;AAQxB,kDAI6B;AAH3B,8GAAA,gBAAgB,OAAA;AAChB,+GAAA,iBAAiB,OAAA;AACjB,6GAAA,eAAe,OAAA;AAGjB,4CAI0B;AAHxB,wGAAA,aAAa,OAAA;AACb,yGAAA,cAAc,OAAA;AACd,iHAAA,sBAAsB,OAAA;AAGxB,8CAAmD;AAA1C,0GAAA,cAAc,OAAA;AAGvB,4CAAqD;AAA5C,0GAAA,gBAAgB,OAAA;AAGzB,0CAAmD;AAA1C,wGAAA,eAAe,OAAA;AAGxB,gDAA+D;AAAtD,oHAAA,wBAAwB,OAAA;AAMjC,0CAAmD;AAA1C,wGAAA,eAAe,OAAA;AAGxB,wCAAqE;AAA5D,yGAAA,gBAAgB,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAG5C,4CAAqD;AAA5C,0GAAA,gBAAgB,OAAA;AAGzB,0CAA+C;AAAtC,sGAAA,YAAY,OAAA;AAGrB,0CAAsD;AAA7C,2GAAA,kBAAkB,OAAA;AAM3B,wCAAgD;AAAvC,uGAAA,cAAc,OAAA;AACvB,qEAEsC;AADpC,2HAAA,mBAAmB,OAAA;AAOrB,uEAAwF;AAA/E,wHAAA,eAAe,OAAA;AAAE,+HAAA,sBAAsB,OAAA;AAOhD,mDAAyD;AAAhD,iHAAA,kBAAkB,OAAA;AAO3B,uDAA+D;AAAtD,uHAAA,sBAAsB,OAAA;AAO/B,4CAK2B;AAJzB,gHAAA,sBAAsB,OAAA;AACtB,8GAAA,oBAAoB,OAAA;AACpB,8GAAA,oBAAoB,OAAA;AACpB,gHAAA,sBAAsB,OAAA;AASxB,0CAGyB;AAFvB,6GAAA,mBAAmB,OAAA;AACnB,4GAAA,kBAAkB,OAAA;AAOpB,wCAAiD;AAAxC,sGAAA,cAAc,OAAA;AAGvB,sCAA2C;AAAlC,kGAAA,UAAU,OAAA;AAGnB,uCAAmD;AAA1C,iHAAA,qBAAqB,OAAA"}

package/dist/shell/register.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from 'commander';
+export interface RegisterShellCommandsOptions {
+    /**
+     * Exit hook used after every shell command. Default `process.exit`.
+     * Tests inject a recorder so they can assert exit codes without
+     * actually exiting the test process.
+     */
+    readonly exit?: (code: number) => void;
+}
+export declare function registerShellCommands(program: Command, options?: RegisterShellCommandsOptions): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/shell/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/shell/register.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAyBD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,4BAAiC,GACzC,IAAI,CAiUN"}

package/dist/shell/register.js

@@ -0,0 +1,274 @@
+"use strict";
+// Commander registration bridge for the vNext shell commands.
+//
+// Thin translator: read Commander options → call the existing
+// `run*Command` functions → set `process.exitCode`. It does NOT
+// reimplement command behavior. It does NOT inspect business logic.
+//
+// 5c.9 / 5c.10 boundary:
+//
+//   - REPLACES the legacy `scope` command group (no env-var feature
+//     flag, no compatibility alias, no duplicate registration).
+//   - ADDS `doctor` and `evidence record` as new noun groups.
+//   - Leaves all other legacy commands (validate, iterate, evaluate,
+//     verify-acs, status, worktree create/merge, spec create/close,
+//     etc.) UNTOUCHED.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerShellCommands = registerShellCommands;
+const index_1 = require("./index");
+function parseDataOption(raw) {
+    if (typeof raw !== 'string' || raw.length === 0)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' ||
+            parsed === null ||
+            Array.isArray(parsed)) {
+            throw new TypeError('--data must be a JSON object');
+        }
+        return parsed;
+    }
+    catch (e) {
+        throw new Error(`caws evidence record: invalid --data JSON: ${e.message}`);
+    }
+}
+function isEvidenceKind(value) {
+    return value === 'test' || value === 'gate' || value === 'ac';
+}
+function registerShellCommands(program, options = {}) {
+    const exit = options.exit ?? ((code) => process.exit(code));
+    // -------------------------------------------------------------------
+    // caws init
+    //
+    // Creates the canonical vNext .caws/ shape (specs/, waivers/,
+    // policy.yaml, worktrees.json, agents.json). Idempotent. Refuses to
+    // overwrite legacy state (working-spec.yaml et al.). No --force.
+    // Replaces the legacy `caws init` registration removed from
+    // src/index.js as part of slice 7b.
+    // -------------------------------------------------------------------
+    program
+        .command('init')
+        .description('Bootstrap the canonical vNext .caws/ project state (idempotent; ' +
+        'refuses to overwrite legacy single-spec layout).')
+        .option('--data', 'Show structured data block on diagnostics')
+        .action((opts) => {
+        const code = (0, index_1.runInitCommand)({ showData: opts.data === true });
+        exit(code);
+    });
+    // -------------------------------------------------------------------
+    // caws doctor
+    // -------------------------------------------------------------------
+    program
+        .command('doctor')
+        .description('Run drift detection against the current .caws/ state')
+        .option('--data', 'Show structured data block on findings/diagnostics')
+        .action((opts) => {
+        const code = (0, index_1.runDoctorCommand)({
+            showData: opts.data === true,
+        });
+        exit(code);
+    });
+    // -------------------------------------------------------------------
+    // caws scope show <path>   /   caws scope check <path>
+    // (replaces the legacy `scope` group entirely)
+    // -------------------------------------------------------------------
+    const scopeCmd = program
+        .command('scope')
+        .description('Evaluate file paths against the bound spec scope');
+    scopeCmd
+        .command('show <path>')
+        .description('Explain the scope decision for <path>; always exits 0')
+        .option('--data', 'Show structured data block')
+        .action((p, opts) => {
+        const code = (0, index_1.runScopeCommand)({
+            path: p,
+            mode: 'show',
+            showData: opts.data === true,
+        });
+        exit(code);
+    });
+    scopeCmd
+        .command('check <path>')
+        .description('Enforce the scope decision for <path>; exits 0 on admit, 1 otherwise')
+        .option('--data', 'Show structured data block')
+        .action((p, opts) => {
+        const code = (0, index_1.runScopeCommand)({
+            path: p,
+            mode: 'check',
+            showData: opts.data === true,
+        });
+        exit(code);
+    });
+    // -------------------------------------------------------------------
+    // caws status — read-only dashboard (replaces legacy status)
+    // -------------------------------------------------------------------
+    program
+        .command('status')
+        .description('Read-only dashboard: project, current context, claim, and doctor findings')
+        .option('--data', 'Show structured data block on rendered diagnostics')
+        .action((opts) => {
+        const code = (0, index_1.runStatusCommand)({
+            showData: opts.data === true,
+        });
+        exit(code);
+    });
+    // -------------------------------------------------------------------
+    // caws claim [--takeover]
+    // -------------------------------------------------------------------
+    program
+        .command('claim')
+        .description('Surface ownership of the current worktree; with --takeover, ' +
+        'acquire ownership from a foreign session (writes prior_owners audit).')
+        .option('--takeover', 'Forcibly take ownership of a foreign-owned worktree. Required when ' +
+        'the current owner is a different session.')
+        .option('--data', 'Show structured data block on diagnostics')
+        .action((opts) => {
+        const code = (0, index_1.runClaimCommand)({
+            takeover: opts.takeover === true,
+            showData: opts.data === true,
+        });
+        exit(code);
+    });
+    // -------------------------------------------------------------------
+    // caws gates run --spec <id> [--context <ctx>]
+    // (replaces the legacy `gates` group and `quality-gates` alias)
+    // -------------------------------------------------------------------
+    const gatesCmd = program
+        .command('gates')
+        .description('Run quality gates against the current changes (policy-driven)');
+    gatesCmd
+        .command('run')
+        .description('Invoke quality-gates subprocess and apply policy.gates[gate].mode ' +
+        'to decide block/warn/skip. Appends one gate_evaluated event per ' +
+        'policy-declared gate.')
+        .requiredOption('--spec <id>', 'Spec id this gate run is about')
+        .option('--context <ctx>', 'Subprocess context: cli | commit | ci', 'cli')
+        .option('--data', 'Show structured data block on diagnostics')
+        .action((opts) => {
+        const code = (0, index_1.runGatesRunCommand)({ specId: opts.spec }, {
+            subprocessArgs: [`--context=${opts.context}`],
+            showData: opts.data === true,
+        });
+        exit(code);
+    });
+    // -------------------------------------------------------------------
+    // caws evidence record
+    // -------------------------------------------------------------------
+    const evidenceCmd = program
+        .command('evidence')
+        .description('Record typed evidence events into .caws/events.jsonl');
+    evidenceCmd
+        .command('record')
+        .description('Append a typed evidence event (test|gate|ac)')
+        .requiredOption('--type <kind>', 'Evidence kind: test | gate | ac')
+        .requiredOption('--spec <id>', 'Spec id this evidence is about')
+        .requiredOption('--data <json>', 'Event payload as a JSON object string')
+        .option('--actor-kind <kind>', 'Actor kind: agent | human | system | automation', 'agent')
+        .option('--actor-id <id>', 'Override actor id (defaults to session id)')
+        .action((opts) => {
+        // Parse --data here; pass already-typed shape to the command.
+        let data;
+        try {
+            data = parseDataOption(opts.data);
+        }
+        catch (e) {
+            process.stderr.write(`${e.message}\n`);
+            exit(1);
+            return;
+        }
+        if (!isEvidenceKind(opts.type)) {
+            process.stderr.write(`caws evidence record: invalid --type ${JSON.stringify(opts.type)}; expected test|gate|ac.\n`);
+            exit(1);
+            return;
+        }
+        const code = (0, index_1.runEvidenceRecordCommand)({
+            kind: opts.type,
+            specId: opts.spec,
+            data,
+            ...(opts.actorKind !== undefined
+                ? { actorKind: opts.actorKind }
+                : {}),
+            ...(opts.actorId !== undefined ? { actorId: opts.actorId } : {}),
+        });
+        exit(code);
+    });
+    // -------------------------------------------------------------------
+    // caws waiver create / list / show / revoke
+    //
+    // Singular `waiver` is the vNext authority surface. The legacy plural
+    // `waivers` group is removed in src/index.js as part of slice 7a.4 —
+    // no compatibility alias, no feature flag.
+    // -------------------------------------------------------------------
+    const waiverCmd = program
+        .command('waiver')
+        .description('Manage CAWS waivers (bounded exception records that suppress matching gate violations)');
+    waiverCmd
+        .command('create <id>')
+        .description('Create a new active waiver. Validates against the kernel before writing.')
+        .requiredOption('--title <title>', 'Short waiver title (≥5 chars)')
+        .requiredOption('--gate <gate>', 'Gate id this waiver covers; repeat for multiple gates', collectMulti, [])
+        .requiredOption('--reason <reason>', 'Justification for the waiver')
+        .requiredOption('--approved-by <id>', 'Approver identity')
+        .requiredOption('--expires-at <iso>', 'Expiry as an ISO-8601 datetime with timezone')
+        .option('--spec <id>', 'Optional spec id this waiver is scoped to (omit for project-wide)')
+        .option('--data', 'Show structured data block on diagnostics')
+        .action((id, opts) => {
+        const code = (0, index_1.runWaiverCreateCommand)({
+            id,
+            title: opts.title,
+            gates: opts.gate,
+            reason: opts.reason,
+            approvedBy: opts.approvedBy,
+            expiresAt: opts.expiresAt,
+            ...(opts.spec !== undefined ? { specId: opts.spec } : {}),
+            showData: opts.data === true,
+        });
+        exit(code);
+    });
+    waiverCmd
+        .command('list')
+        .description('List waivers. By default excludes revoked and expired records.')
+        .option('--include-revoked', 'Include revoked waivers')
+        .option('--include-expired', 'Include expired waivers')
+        .option('--data', 'Show structured data block on diagnostics')
+        .action((opts) => {
+        const code = (0, index_1.runWaiverListCommand)({
+            includeRevoked: opts.includeRevoked === true,
+            includeExpired: opts.includeExpired === true,
+            showData: opts.data === true,
+        });
+        exit(code);
+    });
+    waiverCmd
+        .command('show <id>')
+        .description('Show a waiver, including its derived effectiveness at now.')
+        .option('--data', 'Show structured data block on diagnostics')
+        .action((id, opts) => {
+        const code = (0, index_1.runWaiverShowCommand)({
+            id,
+            showData: opts.data === true,
+        });
+        exit(code);
+    });
+    waiverCmd
+        .command('revoke <id>')
+        .description('Revoke a waiver. Writes a revocation record; refuses double-revoke.')
+        .option('--revoked-by <id>', 'Identity recorded in revocation.revoked_by')
+        .option('--reason <reason>', 'Reason recorded in revocation.reason (recommended for audit)')
+        .option('--data', 'Show structured data block on diagnostics')
+        .action((id, opts) => {
+        const code = (0, index_1.runWaiverRevokeCommand)({
+            id,
+            ...(opts.revokedBy !== undefined ? { revokedBy: opts.revokedBy } : {}),
+            ...(opts.reason !== undefined ? { reason: opts.reason } : {}),
+            showData: opts.data === true,
+        });
+        exit(code);
+    });
+}
+/** Commander value collector for repeatable string options. */
+function collectMulti(value, prev) {
+    prev.push(value);
+    return prev;
+}
+//# sourceMappingURL=register.js.map

package/dist/shell/register.js.map

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

package/dist/shell/render/claim.d.ts

@@ -0,0 +1,22 @@
+import type { AgentRecord, SessionIdentity, WorktreeRecord } from '@paths.design/caws-kernel';
+export type OwnershipRelation = 'you' | 'foreign' | 'unowned';
+export interface ClaimPanelInput {
+    readonly worktreeName: string;
+    readonly worktreeRecord: WorktreeRecord;
+    /**
+     * Optional matching agent record from agents.json. When present, the
+     * panel renders a freshness line. When absent, the freshness line
+     * is omitted entirely (we do NOT invent a stale-forever line).
+     */
+    readonly agentRecord?: AgentRecord;
+    readonly currentSession: SessionIdentity;
+    readonly now: Date;
+    /**
+     * Heartbeat staleness threshold in ms. Default 24h. ONLY used for the
+     * display label "(stale)" — never as a takeover authority.
+     */
+    readonly staleTtlMs?: number;
+}
+export declare function classifyOwnership(record: WorktreeRecord, currentSession: SessionIdentity): OwnershipRelation;
+export declare function renderClaimPanel(input: ClaimPanelInput): string;
+//# sourceMappingURL=claim.d.ts.map

package/dist/shell/render/claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../../../src/shell/render/claim.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,WAAW,EAEX,eAAe,EACf,cAAc,EACf,MAAM,2BAA2B,CAAC;AAGnC,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAID,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EACtB,cAAc,EAAE,eAAe,GAC9B,iBAAiB,CAGnB;AAiBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAyC/D"}

package/dist/shell/render/claim.js

@@ -0,0 +1,75 @@
+"use strict";
+// Pure string-formatter for the Claim panel.
+//
+// The claim panel shows ownership for the worktree that the command was
+// invoked from. It distinguishes:
+//
+//   - owner is the current session       → "OWNED (you)"
+//   - owner is a foreign session         → "OWNED (foreign)"
+//   - no owner recorded                  → "UNOWNED"
+//   - cwd is outside any tracked worktree → no panel; caller decides
+//
+// Authority discipline preserved in the rendering:
+//   - `owner` line uses worktrees.json[name].owner verbatim — SOLE
+//     authority for ownership.
+//   - `heartbeat` line shows agents.json freshness — display only.
+//     If the heartbeat is "stale" by the configured TTL, we say so
+//     in parentheses but we DO NOT imply this authorizes takeover.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyOwnership = classifyOwnership;
+exports.renderClaimPanel = renderClaimPanel;
+const caws_kernel_1 = require("@paths.design/caws-kernel");
+const DEFAULT_STALE_TTL_MS = 24 * 60 * 60 * 1000;
+function classifyOwnership(record, currentSession) {
+    if (record.owner === undefined)
+        return 'unowned';
+    return record.owner.session_id === currentSession.session_id ? 'you' : 'foreign';
+}
+function fmtSessionTag(owner) {
+    if (owner.platform !== undefined && owner.platform.length > 0) {
+        return `${owner.session_id}:${owner.platform}`;
+    }
+    return owner.session_id;
+}
+function fmtAge(ms) {
+    if (!Number.isFinite(ms))
+        return 'unknown';
+    if (ms < 60_000)
+        return `${Math.round(ms / 1000)}s ago`;
+    if (ms < 3600_000)
+        return `${Math.round(ms / 60_000)}m ago`;
+    if (ms < 86_400_000)
+        return `${Math.round(ms / 3600_000)}h ago`;
+    return `${Math.round(ms / 86_400_000)}d ago`;
+}
+function renderClaimPanel(input) {
+    const rel = classifyOwnership(input.worktreeRecord, input.currentSession);
+    const lines = [];
+    lines.push(`Claim for worktree '${input.worktreeName}':`);
+    switch (rel) {
+        case 'you':
+            lines.push(`  Owner:     OWNED (you) — ${fmtSessionTag(input.worktreeRecord.owner)}`);
+            break;
+        case 'foreign':
+            lines.push(`  Owner:     OWNED (foreign) — ${fmtSessionTag(input.worktreeRecord.owner)}`);
+            lines.push(`             your session:   ${fmtSessionTag(input.currentSession)}`);
+            break;
+        case 'unowned':
+            lines.push('  Owner:     UNOWNED (no recorded owner)');
+            break;
+    }
+    // Freshness — display only. Never authorizes takeover.
+    if (input.agentRecord !== undefined) {
+        const ttl = input.staleTtlMs ?? DEFAULT_STALE_TTL_MS;
+        const age = (0, caws_kernel_1.heartbeatAge)(input.agentRecord, input.now);
+        const stale = (0, caws_kernel_1.isStaleByTTL)(input.agentRecord, ttl, input.now);
+        const staleNote = stale ? ' (stale; display only — NOT abandonment)' : '';
+        lines.push(`  Heartbeat: ${fmtAge(age)}${staleNote}`);
+    }
+    const priorOwners = input.worktreeRecord.prior_owners ?? [];
+    if (priorOwners.length > 0) {
+        lines.push(`  History:   ${priorOwners.length} prior owner${priorOwners.length === 1 ? '' : 's'} (audit)`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=claim.js.map

package/dist/shell/render/claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.js","sourceRoot":"","sources":["../../../src/shell/render/claim.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,EAAE;AACF,wEAAwE;AACxE,kCAAkC;AAClC,EAAE;AACF,yDAAyD;AACzD,6DAA6D;AAC7D,qDAAqD;AACrD,qEAAqE;AACrE,EAAE;AACF,mDAAmD;AACnD,mEAAmE;AACnE,+BAA+B;AAC/B,mEAAmE;AACnE,mEAAmE;AACnE,mEAAmE;;AAgCnE,8CAMC;AAiBD,4CAyCC;AAxFD,2DAAuE;AAsBvE,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEjD,SAAgB,iBAAiB,CAC/B,MAAsB,EACtB,cAA+B;IAE/B,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC;AAED,SAAS,aAAa,CAAC,KAAsB;IAC3C,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,UAAU,CAAC;AAC1B,CAAC;AAED,SAAS,MAAM,CAAC,EAAU;IACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,EAAE,GAAG,MAAM;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;IACxD,IAAI,EAAE,GAAG,QAAQ;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5D,IAAI,EAAE,GAAG,UAAU;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC;IAChE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC;AAC/C,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAsB;IACrD,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,uBAAuB,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;IAE1D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,KAAK,CAAC,IAAI,CACR,8BAA8B,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,KAAM,CAAC,EAAE,CAC3E,CAAC;YACF,MAAM;QACR,KAAK,SAAS;YACZ,KAAK,CAAC,IAAI,CACR,kCAAkC,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,KAAM,CAAC,EAAE,CAC/E,CAAC;YACF,KAAK,CAAC,IAAI,CACR,gCAAgC,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CACtE,CAAC;YACF,MAAM;QACR,KAAK,SAAS;YACZ,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YACvD,MAAM;IACV,CAAC;IAED,uDAAuD;IACvD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,oBAAoB,CAAC;QACrD,MAAM,GAAG,GAAG,IAAA,0BAAY,EAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,IAAA,0BAAY,EAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,0CAA0C,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,WAAW,GAA0B,KAAK,CAAC,cAAc,CAAC,YAAY,IAAI,EAAE,CAAC;IACnF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CACR,gBAAgB,WAAW,CAAC,MAAM,eAAe,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAC/F,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/shell/render/decision.d.ts

@@ -0,0 +1,15 @@
+import type { Decision } from '@paths.design/caws-kernel';
+import type { ResolvedBinding } from '../binding/types';
+export interface RenderDecisionOptions {
+    /**
+     * Shell-side binding resolution. Used ONLY to color the `unbound`
+     * no-authority case: when `worktreeName` is set, the message reads
+     * "tracked worktree without spec"; otherwise it reads "outside any
+     * worktree". The rule id is unchanged either way.
+     */
+    readonly boundContext?: ResolvedBinding;
+    /** Show the optional `data` block. Default false. */
+    readonly showData?: boolean;
+}
+export declare function renderDecision(decision: Decision, opts?: RenderDecisionOptions): string;
+//# sourceMappingURL=decision.d.ts.map

package/dist/shell/render/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../../src/shell/render/decision.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC;IACxC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AASD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,EAClB,IAAI,GAAE,qBAA0B,GAC/B,MAAM,CAyBR"}