@paths.design/caws-cli 10.2.0 → 11.1.0

package/dist/shell/render/init-hook-pack.js

@@ -0,0 +1,206 @@
+"use strict";
+// Pure formatter for hook-pack install output and settings.json wiring
+// guidance. Each step of `caws init` emits a labeled section so an
+// agent reading the output turn-by-turn can pick up what happened and
+// what to do next.
+//
+// This renderer never decides outcomes; install/inspect decide.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderHookPackInstall = renderHookPackInstall;
+exports.renderSettingsWiring = renderSettingsWiring;
+exports.renderActivationContract = renderActivationContract;
+const hook_install_1 = require("../../init/hook-install");
+function repeatChar(ch, n) {
+    return ch.repeat(Math.max(0, n));
+}
+function section(title) {
+    const bar = repeatChar('─', 64);
+    return `\n┌${bar}\n│ ${title}\n└${bar}`;
+}
+/** Render the install result. */
+function renderHookPackInstall(result) {
+    const lines = [];
+    if (!result.pack) {
+        if (result.outcome === 'skipped_explicit_none') {
+            lines.push(section('Step: hook-pack install'));
+            lines.push('  Skipped — --agent-surface none.');
+            lines.push('  No pre-tool-call governance was installed.');
+            lines.push('  This repo is NOT agent-safe for multi-session work without external governance.');
+            lines.push('  If you intended to enable a hook pack, rerun with --agent-surface claude-code.');
+            return lines.join('\n');
+        }
+        if (result.outcome === 'skipped_ambiguous') {
+            lines.push(section('Step: hook-pack install'));
+            lines.push('  Skipped — no harness detected and no --agent-surface flag passed.');
+            lines.push('  No pre-tool-call governance was installed.');
+            lines.push('  To enable a hook pack now, rerun with one of:');
+            lines.push('    caws init --agent-surface claude-code');
+            lines.push('    caws init --agent-surface none      # explicit opt-out');
+            return lines.join('\n');
+        }
+    }
+    const pack = result.pack;
+    lines.push(section(`Step: hook-pack install (${pack.id} v${pack.packVersion})`));
+    lines.push(`  ${pack.summary}`);
+    lines.push('');
+    // Per-file action lines.
+    const created = [];
+    const updated = [];
+    const unchanged = [];
+    const refused = [];
+    for (const a of result.actions) {
+        switch (a.action) {
+            case 'created':
+                created.push(a.destPath);
+                break;
+            case 'updated':
+                updated.push(a.destPath);
+                break;
+            case 'unchanged':
+                unchanged.push(a.destPath);
+                break;
+            case 'refused':
+                refused.push(`${a.destPath}  [refused: ${a.refusalReason ?? 'unknown'}]`);
+                break;
+        }
+    }
+    if (created.length > 0) {
+        lines.push(`  Created (${created.length}):`);
+        for (const p of created)
+            lines.push(`    + ${p}`);
+    }
+    if (updated.length > 0) {
+        lines.push(`  Updated (${updated.length}):`);
+        for (const p of updated)
+            lines.push(`    ↑ ${p}`);
+    }
+    if (unchanged.length > 0) {
+        lines.push(`  Unchanged (${unchanged.length}):`);
+        for (const p of unchanged)
+            lines.push(`    = ${p}`);
+    }
+    if (refused.length > 0) {
+        lines.push(`  Refused (${refused.length}):`);
+        for (const p of refused)
+            lines.push(`    ! ${p}`);
+        lines.push('');
+        lines.push('  One or more files were refused. To resolve, choose one of:');
+        lines.push('    --overwrite   Replace the file with the canonical pack version.');
+        lines.push('                  CAUTION: local edits to that file will be lost.');
+        lines.push('    --adopt       Leave the file in place; do not enforce that it');
+        lines.push('                  matches the pack. CAUTION: pack drift is no longer');
+        lines.push('                  tracked for this file until the marker is restored.');
+        lines.push('  Alternative: rename or remove the conflicting file, then re-run init.');
+    }
+    return lines.join('\n');
+}
+/** Render the settings.json wiring inspection result. */
+function renderSettingsWiring(status) {
+    const lines = [];
+    lines.push(section('Step: .claude/settings.json wiring'));
+    if (status.kind === 'wired') {
+        lines.push('  OK — .claude/settings.json already wires all four CAWS dispatch entrypoints.');
+        lines.push('  No action needed.');
+        return lines.join('\n');
+    }
+    if (status.kind === 'invalid') {
+        lines.push(`  ERROR — .claude/settings.json exists but could not be parsed: ${status.error}`);
+        lines.push('  Repair the JSON syntax, then re-run `caws doctor` to verify.');
+        lines.push('  The CAWS init does NOT modify settings.json; you must fix this by hand.');
+        return lines.join('\n');
+    }
+    if (status.kind === 'absent') {
+        lines.push('  No .claude/settings.json present. Hooks are installed but will');
+        lines.push('  NOT fire until Claude Code reads a settings.json that wires them.');
+        lines.push('');
+        lines.push('  init does not write this file directly because merging with your');
+        lines.push('  existing permissions, env, and hook entries is your responsibility.');
+        lines.push('');
+        lines.push('  Create .claude/settings.json with the following content:');
+        lines.push('');
+        for (const line of hook_install_1.CANONICAL_SETTINGS_SNIPPET.split('\n')) {
+            lines.push(`    ${line}`);
+        }
+        return lines.join('\n');
+    }
+    // partial
+    lines.push('  .claude/settings.json exists but is missing one or more canonical');
+    lines.push('  CAWS hook entries. Hooks may not fire as expected.');
+    lines.push('');
+    lines.push(`  Missing entries (${status.missing.length}): ${status.missing.join(', ')}`);
+    lines.push('');
+    lines.push('  Add the following blocks to the `hooks` object in your settings.json:');
+    lines.push('');
+    for (const line of hook_install_1.CANONICAL_SETTINGS_SNIPPET.split('\n')) {
+        lines.push(`    ${line}`);
+    }
+    lines.push('');
+    lines.push('  CAWS init does NOT modify settings.json automatically — it');
+    lines.push('  commonly carries user-authored `permissions` and `env` blocks that');
+    lines.push('  the pack should not overwrite. Merge the snippet by hand.');
+    return lines.join('\n');
+}
+/** Render the activation contract. Drives what the agent should do
+ *  immediately after init. The message tailors to three signals:
+ *  - did this run actually install or update files? (changed vs no-op)
+ *  - is settings.json wired? (only known when caller passes wiringStatus)
+ *  - what is the harness's activation model? (from pack)
+ *
+ *  Without these signals the panel becomes a constant STOP sign on every
+ *  re-run, which trains agents to ignore it. */
+function renderActivationContract(result, wiringStatus) {
+    const lines = [];
+    lines.push(section('Step: activation'));
+    if (!result.pack || result.outcome === 'skipped_explicit_none') {
+        lines.push('  No hook pack was installed. Pre-tool-call governance is NOT in effect.');
+        return lines.join('\n');
+    }
+    if (result.outcome === 'skipped_ambiguous') {
+        lines.push('  No hook pack was selected. Pre-tool-call governance is NOT in effect.');
+        return lines.join('\n');
+    }
+    const changed = result.outcome === 'installed' || result.outcome === 'updated';
+    const wired = wiringStatus?.kind === 'wired';
+    switch (result.activation) {
+        case 'immediate':
+            lines.push('  Hooks are active in the current session. No restart required.');
+            break;
+        case 'restart_required':
+            if (!changed && wired) {
+                // No-op re-run on a fully-wired install. Positive confirmation.
+                lines.push('  Hooks are installed and wired. They are active in any Claude Code');
+                lines.push('  session started AFTER the install. If you are running in a session');
+                lines.push('  that pre-dates the install, restart the session to load them.');
+            }
+            else if (changed && wired) {
+                // Files updated; wiring is already in place but the new versions
+                // need a session restart to load.
+                lines.push('  Hook files were installed or updated. Settings.json is wired.');
+                lines.push('  Restart the Claude Code session so the updated hooks load.');
+            }
+            else if (changed && !wired) {
+                // The original STOP-sign case. Files just landed AND wiring is
+                // missing or partial. Agent must not continue.
+                lines.push('  RESTART REQUIRED: Claude Code reads .claude/settings.json at session');
+                lines.push('  start. The hooks you just installed are NOT enforcing in this session.');
+                lines.push('');
+                lines.push('  STOP. Do not continue substantive work. Wire .claude/settings.json');
+                lines.push('  (see the previous panel) and ask the user to restart or reopen');
+                lines.push('  the Claude Code session so the hooks become active.');
+            }
+            else {
+                // Idempotent re-run with wiring still missing or invalid.
+                lines.push('  Hook files are installed but settings.json wiring is not complete.');
+                lines.push('  Hooks will not fire until the wiring is finished (see the previous');
+                lines.push('  panel) and the Claude Code session is restarted.');
+            }
+            break;
+        case 'unknown':
+        case 'not_applicable':
+            lines.push('  Activation semantics for this harness are not known. Consult the');
+            lines.push('  harness documentation for whether hooks take effect mid-session.');
+            break;
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=init-hook-pack.js.map

package/dist/shell/render/init-hook-pack.js.map

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

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

@@ -0,0 +1,11 @@
+import type { InitProjectResult } from '../../store';
+export interface RenderInitInput {
+    readonly result: InitProjectResult;
+    /**
+     * Optional repo root used to render created paths relative to the
+     * project. When omitted, absolute paths are rendered as-is.
+     */
+    readonly repoRoot?: string;
+}
+export declare function renderInit(input: RenderInitInput): string;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/shell/render/init.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AASD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAWzD"}

package/dist/shell/render/init.js

@@ -0,0 +1,32 @@
+"use strict";
+// Pure formatter for the `caws init` outcome.
+//
+// Two render shapes:
+//   - "created"             → list each created path
+//   - "already_initialized" → single status line
+//
+// Renderer never decides outcomes; the store does. Renderer never reads
+// `process.cwd` or `Date.now`. All inputs come from the caller.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderInit = renderInit;
+function relativize(p, repoRoot) {
+    if (repoRoot === undefined)
+        return p;
+    if (!p.startsWith(repoRoot))
+        return p;
+    const rel = p.slice(repoRoot.length);
+    return rel.startsWith('/') ? rel.slice(1) : rel;
+}
+function renderInit(input) {
+    const lines = [];
+    if (input.result.outcome === 'already_initialized') {
+        lines.push('caws init: project already initialized; no changes.');
+        return lines.join('\n');
+    }
+    lines.push(`caws init: created ${input.result.created.length} path(s).`);
+    for (const p of input.result.created) {
+        lines.push(`  + ${relativize(p, input.repoRoot)}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/shell/render/init.ts"],"names":[],"mappings":";AAAA,8CAA8C;AAC9C,EAAE;AACF,qBAAqB;AACrB,qDAAqD;AACrD,iDAAiD;AACjD,EAAE;AACF,wEAAwE;AACxE,gEAAgE;;AAoBhE,gCAWC;AAlBD,SAAS,UAAU,CAAC,CAAS,EAAE,QAAiB;IAC9C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAClD,CAAC;AAED,SAAgB,UAAU,CAAC,KAAsB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,qBAAqB,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,sBAAsB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;IACzE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,26 @@
+import type { AgentRegistry, DoctorFinding, Spec, WorktreeRegistry } from '@paths.design/caws-kernel';
+import type { ResolvedBinding } from '../binding/types';
+import type { ResolvedSession } from '../session/types';
+export interface StatusRenderInput {
+    readonly repoRoot: string;
+    readonly cawsDir: string;
+    readonly policyLoaded: boolean;
+    readonly specs: readonly Spec[];
+    readonly worktrees: WorktreeRegistry;
+    readonly agents: AgentRegistry;
+    readonly eventCount: number;
+    /** When undefined, the dashboard renders "no event chain on disk". */
+    readonly eventChainOk?: boolean;
+    /** Result of resolveBinding(cwd, ...). */
+    readonly binding: ResolvedBinding;
+    /** Result of resolveSession({ allowMint: false }). */
+    readonly session: ResolvedSession | null;
+    readonly doctorFindings: readonly DoctorFinding[];
+    readonly now: Date;
+    /** Heartbeat-stale TTL in ms; display only. Default 24h. */
+    readonly staleTtlMs?: number;
+    /** Cap on rendered top findings. Default 5. */
+    readonly findingCap?: number;
+}
+export declare function renderStatus(input: StatusRenderInput): string;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/shell/render/status.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACb,IAAI,EAEJ,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAOxD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEhC,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAEzC,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAoCD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAmG7D"}

package/dist/shell/render/status.js

@@ -0,0 +1,143 @@
+"use strict";
+// Pure formatter for the vNext `caws status` dashboard.
+//
+// Read-only: the formatter inspects already-loaded state and renders a
+// summary. It does NOT mint capsules, refresh heartbeats, write events,
+// or mutate any registry.
+//
+// Composition order (sections):
+//
+//   CAWS Status
+//
+//   Project
+//     repo root / .caws / policy presence / specs by lifecycle /
+//     worktree count / event count
+//
+//   Current context
+//     cwd relation: tracked / untracked / outside repo
+//     worktree name (if resolved) / bound spec id / binding state
+//     current session id (or "unresolved (read-only)")
+//
+//   Claim (only when inside a tracked worktree)
+//     reuses renderClaimPanel — same authority discipline.
+//
+//   Doctor
+//     error/warning/info counts; top findings, capped.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderStatus = renderStatus;
+const claim_1 = require("./claim");
+const finding_1 = require("./finding");
+const DEFAULT_FINDING_CAP = 5;
+function countSpecsByLifecycle(specs) {
+    const counts = {};
+    for (const s of specs) {
+        counts[s.lifecycle_state] = (counts[s.lifecycle_state] ?? 0) + 1;
+    }
+    return counts;
+}
+function fmtSessionTag(identity) {
+    if (identity.platform !== undefined && identity.platform.length > 0) {
+        return `${identity.session_id}:${identity.platform}`;
+    }
+    return identity.session_id;
+}
+function describeCwdRelation(binding) {
+    if (binding.worktreeName !== undefined)
+        return 'inside tracked worktree';
+    if (binding.source === 'none')
+        return 'main checkout (no tracked worktree match)';
+    return 'unknown';
+}
+function describeBindingState(state) {
+    switch (state.kind) {
+        case 'bound':
+            return `bound → ${state.spec.id} (worktree '${state.worktreeName}')`;
+        case 'one_sided':
+            return 'one_sided (corrupt asymmetric binding — see doctor)';
+        case 'unbound':
+            return 'unbound';
+    }
+}
+function renderStatus(input) {
+    const lines = [];
+    lines.push('CAWS Status');
+    lines.push('');
+    // -------- Project --------
+    lines.push('Project');
+    lines.push(`  repo root:   ${input.repoRoot}`);
+    lines.push(`  .caws dir:   ${input.cawsDir}`);
+    lines.push(`  policy:      ${input.policyLoaded ? 'loaded' : 'MISSING'}`);
+    const lifecycle = countSpecsByLifecycle(input.specs);
+    const lifecycleSummary = input.specs.length === 0
+        ? '0 specs'
+        : Object.entries(lifecycle)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => `${v} ${k}`)
+            .join(', ');
+    lines.push(`  specs:       ${lifecycleSummary}`);
+    const worktreeCount = Object.keys(input.worktrees).length;
+    lines.push(`  worktrees:   ${worktreeCount}`);
+    const eventLine = input.eventChainOk === undefined
+        ? `${input.eventCount} events`
+        : input.eventChainOk
+            ? `${input.eventCount} events (chain OK)`
+            : `${input.eventCount} events (CHAIN BROKEN — see doctor)`;
+    lines.push(`  events:      ${eventLine}`);
+    // -------- Current context --------
+    lines.push('');
+    lines.push('Current context');
+    lines.push(`  cwd:         ${describeCwdRelation(input.binding)}`);
+    if (input.binding.worktreeName !== undefined) {
+        lines.push(`  worktree:    ${input.binding.worktreeName}`);
+    }
+    lines.push(`  binding:     ${describeBindingState(input.binding.binding)}`);
+    if (input.session !== null) {
+        lines.push(`  session:     ${fmtSessionTag(input.session.identity)} (source: ${input.session.source})`);
+    }
+    else {
+        lines.push('  session:     unresolved (read-only; no capsule minted)');
+    }
+    // -------- Claim (only when inside a tracked worktree) --------
+    if (input.binding.worktreeName !== undefined && input.session !== null) {
+        const wtName = input.binding.worktreeName;
+        const record = input.worktrees[wtName];
+        if (record !== undefined) {
+            lines.push('');
+            const agentRecord = record.owner !== undefined ? input.agents[record.owner.session_id] : undefined;
+            lines.push((0, claim_1.renderClaimPanel)({
+                worktreeName: wtName,
+                worktreeRecord: record,
+                ...(agentRecord !== undefined ? { agentRecord } : {}),
+                currentSession: input.session.identity,
+                now: input.now,
+                ...(input.staleTtlMs !== undefined ? { staleTtlMs: input.staleTtlMs } : {}),
+            }));
+        }
+    }
+    // -------- Doctor --------
+    lines.push('');
+    lines.push('Doctor');
+    const counts = (0, finding_1.countFindingSeverities)(input.doctorFindings);
+    lines.push(`  Summary:   ${counts.errors}E / ${counts.warnings}W / ${counts.infos}I`);
+    if (input.doctorFindings.length === 0) {
+        lines.push('  (no findings)');
+    }
+    else {
+        const cap = input.findingCap ?? DEFAULT_FINDING_CAP;
+        // Sort by severity rank (error > warning > info) and take top `cap`.
+        const rank = {
+            error: 0,
+            warning: 1,
+            info: 2,
+        };
+        const top = [...input.doctorFindings]
+            .sort((a, b) => rank[a.severity] - rank[b.severity])
+            .slice(0, cap);
+        lines.push((0, finding_1.renderFindings)(top));
+        if (input.doctorFindings.length > cap) {
+            lines.push(`  … ${input.doctorFindings.length - cap} more — run \`caws doctor\` for full list`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=status.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { Waiver, WaiverEffectiveness } from '@paths.design/caws-kernel';
+export interface RenderWaiverSummaryInput {
+    readonly waiver: Waiver;
+    /** Pre-derived effectiveness from kernel.waiverEffectiveness. */
+    readonly effectiveness: WaiverEffectiveness;
+}
+export interface RenderWaiverDetailInput extends RenderWaiverSummaryInput {
+    /** Now, used to format expiry deltas. Caller owns the clock. */
+    readonly now: Date;
+}
+/**
+ * One-line summary suited to `caws waiver list`. Includes the kernel-
+ * derived effectiveness label so the caller doesn't need to re-classify.
+ */
+export declare function renderWaiverSummary(input: RenderWaiverSummaryInput): string;
+/**
+ * Multi-line detail block suited to `caws waiver show`. Includes
+ * everything `Waiver` carries plus a derived expiry delta.
+ */
+export declare function renderWaiverDetail(input: RenderWaiverDetailInput): string;
+//# sourceMappingURL=waiver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"waiver.d.ts","sourceRoot":"","sources":["../../../src/shell/render/waiver.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,MAAM,EACN,mBAAmB,EACpB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;CACpB;AAiCD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAI3E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAyBzE"}

package/dist/shell/render/waiver.js

@@ -0,0 +1,94 @@
+"use strict";
+// Pure formatter for waiver records.
+//
+// The renderer does NOT decide applicability. It receives a derived
+// effectiveness label from the caller — `effectiveWaiversForGate`
+// (kernel) and `waiverEffectiveness` (kernel) own that decision.
+// Renderers stay pure so they're trivial to test and reuse from
+// `list`, `show`, and any future doctor surface.
+//
+// Two output shapes:
+//
+//   renderWaiverSummary(input)  — single-line list row used by `list`.
+//   renderWaiverDetail(input)   — multi-line detail block used by `show`.
+//
+// `now` is supplied by the caller, never read from the clock here. That
+// keeps test output deterministic and matches the discipline that the
+// rest of the shell follows.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderWaiverSummary = renderWaiverSummary;
+exports.renderWaiverDetail = renderWaiverDetail;
+function effectivenessLabel(e) {
+    switch (e) {
+        case 'active':
+            return 'ACTIVE         ';
+        case 'expired':
+            return 'EXPIRED        ';
+        case 'revoked':
+            return 'REVOKED        ';
+        case 'not_applicable':
+            return 'NOT_APPLICABLE ';
+    }
+}
+function fmtScope(w) {
+    if (w.scope?.spec_id !== undefined)
+        return `spec=${w.scope.spec_id}`;
+    return 'project-wide';
+}
+function fmtExpiryDelta(expiresAt, now) {
+    const expMs = Date.parse(expiresAt);
+    if (!Number.isFinite(expMs))
+        return '(unparseable expires_at)';
+    const deltaMs = expMs - now.getTime();
+    const absMs = Math.abs(deltaMs);
+    let unit;
+    if (absMs < 60_000)
+        unit = `${Math.round(absMs / 1000)}s`;
+    else if (absMs < 3_600_000)
+        unit = `${Math.round(absMs / 60_000)}m`;
+    else if (absMs < 86_400_000)
+        unit = `${Math.round(absMs / 3_600_000)}h`;
+    else
+        unit = `${Math.round(absMs / 86_400_000)}d`;
+    return deltaMs >= 0 ? `in ${unit}` : `${unit} ago`;
+}
+/**
+ * One-line summary suited to `caws waiver list`. Includes the kernel-
+ * derived effectiveness label so the caller doesn't need to re-classify.
+ */
+function renderWaiverSummary(input) {
+    const w = input.waiver;
+    const gates = w.gates.join(',');
+    return `${effectivenessLabel(input.effectiveness)}  ${w.id}  [${gates}]  (${fmtScope(w)})  ${w.title}`;
+}
+/**
+ * Multi-line detail block suited to `caws waiver show`. Includes
+ * everything `Waiver` carries plus a derived expiry delta.
+ */
+function renderWaiverDetail(input) {
+    const w = input.waiver;
+    const lines = [];
+    lines.push(`Waiver ${w.id}`);
+    lines.push(`  Status (stored):  ${w.status}`);
+    lines.push(`  Effectiveness:    ${input.effectiveness}`);
+    lines.push(`  Title:            ${w.title}`);
+    lines.push(`  Gates:            ${w.gates.join(', ')}`);
+    lines.push(`  Scope:            ${fmtScope(w)}`);
+    lines.push(`  Reason:           ${w.reason}`);
+    lines.push(`  Approved by:      ${w.approved_by}`);
+    lines.push(`  Created at:       ${w.created_at}`);
+    lines.push(`  Expires at:       ${w.expires_at} (${fmtExpiryDelta(w.expires_at, input.now)})`);
+    if (w.constraints?.max_uses !== undefined) {
+        lines.push(`  Max uses:         ${w.constraints.max_uses} (kernel does not enforce)`);
+    }
+    if (w.revocation !== undefined) {
+        lines.push('  Revocation:');
+        lines.push(`    Revoked at:     ${w.revocation.revoked_at}`);
+        if (w.revocation.revoked_by !== undefined)
+            lines.push(`    Revoked by:     ${w.revocation.revoked_by}`);
+        if (w.revocation.reason !== undefined)
+            lines.push(`    Reason:         ${w.revocation.reason}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=waiver.js.map

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

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

package/dist/shell/rules.d.ts

@@ -0,0 +1,37 @@
+export declare const SHELL_RULE_PREFIXES: {
+    readonly session: "shell.session";
+    readonly binding: "shell.binding";
+    readonly command: "shell.command";
+    readonly gates: "shell.gates";
+    readonly waiver: "shell.waiver";
+};
+export declare const SHELL_RULES: {
+    readonly SESSION_RESOLVED_FROM_CLAUDE_ENV: "shell.session.resolved_from_claude_env";
+    readonly SESSION_RESOLVED_FROM_CAPSULE: "shell.session.resolved_from_capsule";
+    readonly SESSION_RESOLVED_FROM_CURSOR_ENV: "shell.session.resolved_from_cursor_env";
+    readonly SESSION_NO_STABLE_IDENTITY: "shell.session.no_stable_identity";
+    readonly SESSION_CAPSULE_MINTED: "shell.session.capsule_minted";
+    readonly SESSION_CAPSULE_INVALID: "shell.session.capsule_invalid";
+    readonly SESSION_CAPSULE_WRITE_FAILED: "shell.session.capsule_write_failed";
+    readonly BINDING_CWD_OUTSIDE_REPO: "shell.binding.cwd_outside_repo";
+    readonly BINDING_WORKTREE_NOT_FOUND_IN_REGISTRY: "shell.binding.worktree_not_found_in_registry";
+    readonly BINDING_NO_SPEC_FOR_WORKTREE: "shell.binding.no_spec_for_worktree";
+    readonly BINDING_UNBOUND_CWD: "shell.binding.unbound_cwd";
+    readonly COMMAND_INVALID_PATH_ARGUMENT: "shell.command.invalid_path_argument";
+    readonly COMMAND_PRE_CHAINED_EVENT_REFUSED: "shell.command.pre_chained_event_refused";
+    readonly COMMAND_INVALID_EVIDENCE_TYPE: "shell.command.invalid_evidence_type";
+    readonly COMMAND_MISSING_SPEC_ID: "shell.command.missing_spec_id";
+    readonly GATES_SUBPROCESS_NOT_FOUND: "shell.gates.subprocess_not_found";
+    readonly GATES_SUBPROCESS_FAILED: "shell.gates.subprocess_failed";
+    readonly GATES_REPORT_NOT_JSON: "shell.gates.report_not_json";
+    readonly GATES_REPORT_INVALID_SHAPE: "shell.gates.report_invalid_shape";
+    readonly GATES_POLICY_REQUIRED: "shell.gates.policy_required";
+    readonly WAIVER_MISSING_ID: "shell.waiver.missing_id";
+    readonly WAIVER_NOT_FOUND: "shell.waiver.not_found";
+    readonly WAIVER_DUPLICATE: "shell.waiver.duplicate";
+    readonly WAIVER_INVALID_INPUT: "shell.waiver.invalid_input";
+    readonly WAIVER_ALREADY_REVOKED: "shell.waiver.already_revoked";
+    readonly WAIVER_WRITE_FAILED: "shell.waiver.write_failed";
+};
+export type ShellRule = (typeof SHELL_RULES)[keyof typeof SHELL_RULES];
+//# sourceMappingURL=rules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/shell/rules.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,mBAAmB;;;;;;CAMtB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC"}