usesteady 0.1.0-alpha.1

package/dist/src/shell/cli/use-steady.js.map

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

package/dist/src/shell/cursor-shell.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Phase 9A: Cursor shell advance functions.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Pure (or async-pure) functions that map a user answer + current session
+ *   state → next session state. These are the seam between the I/O layer
+ *   (readline, test, UI) and the CursorProductSession API.
+ *
+ * ── What these functions do ───────────────────────────────────────────────────
+ *
+ *   advanceCursorOnConfirm — handles "confirm" prompt answers (y/n).
+ *     - From "conflict":  y → acceptConflict() → back to "prepared"
+ *                         n → reject()
+ *     - From "prepared":  y → approve() then immediately deliver()
+ *                         n → reject()
+ *
+ *   advanceCursorOnChoice — handles "choose" prompt answers (1-N).
+ *     - From "scope_question": resolves the candidate file, calls answerScope(),
+ *       then immediately delivers (answerScope → "approved" → deliver).
+ *     - Out-of-range index: returns state unchanged (re-prompt).
+ *
+ * ── Design note ───────────────────────────────────────────────────────────────
+ *
+ *   The approve → deliver combination is intentional at the CLI level.
+ *   The session still performs them as two distinct transitions (P3, P4).
+ *   The CLI collapses them into one user action because "I approved it, now
+ *   run it" is the correct product-shell semantic. The intermediate "approved"
+ *   state is not shown to the user — it is internal to the transition.
+ *
+ * ── What these functions are NOT ──────────────────────────────────────────────
+ *
+ *   NOT authority layers — all decisions are delegated to session functions.
+ *   NOT renderers — rendering is in render.ts.
+ *   NOT stateful — they return new state; they do not mutate.
+ */
+import type { CursorSessionState } from "../product/cursor-product-session.js";
+import type { CursorEditorPlugin } from "../cursor/delivery-gate.js";
+/**
+ * Advance the session based on a yes/no answer to the current confirm prompt.
+ *
+ * Called when `renderCursorFrame(state).prompt.kind === "confirm"`.
+ *
+ * @param state    Current session state (must be "prepared" or "conflict").
+ * @param yes      true = user said yes; false = user said no.
+ * @param plugin   The Cursor editor plugin for delivery.
+ * @param storeDir UCP store directory for envelope persistence.
+ */
+export declare function advanceCursorOnConfirm(state: CursorSessionState, yes: boolean, plugin: CursorEditorPlugin, storeDir: string): Promise<CursorSessionState>;
+/**
+ * Advance the session based on a numbered choice for scope clarification.
+ *
+ * Called when `renderCursorFrame(state).prompt.kind === "choose"`.
+ *
+ * @param state      Current session state (must be "scope_question").
+ * @param choiceIdx  1-based index into `state.scopeQuestion.candidates`.
+ * @param plugin     The Cursor editor plugin for delivery.
+ * @param storeDir   UCP store directory for envelope persistence.
+ * @returns          Next session state. If choiceIdx is out of range,
+ *                   returns state unchanged so the CLI can re-prompt.
+ */
+export declare function advanceCursorOnChoice(state: CursorSessionState, choiceIdx: number, plugin: CursorEditorPlugin, storeDir: string): Promise<CursorSessionState>;
+//# sourceMappingURL=cursor-shell.d.ts.map

package/dist/src/shell/cursor-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-shell.d.ts","sourceRoot":"","sources":["../../../src/shell/cursor-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAO,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAO,4BAA4B,CAAC;AAWtE;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAK,kBAAkB,EAC5B,GAAG,EAAO,OAAO,EACjB,MAAM,EAAI,kBAAkB,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAkB7B;AAID;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAM,kBAAkB,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAK,kBAAkB,EAC7B,QAAQ,EAAG,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAS7B"}

package/dist/src/shell/cursor-shell.js

@@ -0,0 +1,88 @@
+/**
+ * Phase 9A: Cursor shell advance functions.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Pure (or async-pure) functions that map a user answer + current session
+ *   state → next session state. These are the seam between the I/O layer
+ *   (readline, test, UI) and the CursorProductSession API.
+ *
+ * ── What these functions do ───────────────────────────────────────────────────
+ *
+ *   advanceCursorOnConfirm — handles "confirm" prompt answers (y/n).
+ *     - From "conflict":  y → acceptConflict() → back to "prepared"
+ *                         n → reject()
+ *     - From "prepared":  y → approve() then immediately deliver()
+ *                         n → reject()
+ *
+ *   advanceCursorOnChoice — handles "choose" prompt answers (1-N).
+ *     - From "scope_question": resolves the candidate file, calls answerScope(),
+ *       then immediately delivers (answerScope → "approved" → deliver).
+ *     - Out-of-range index: returns state unchanged (re-prompt).
+ *
+ * ── Design note ───────────────────────────────────────────────────────────────
+ *
+ *   The approve → deliver combination is intentional at the CLI level.
+ *   The session still performs them as two distinct transitions (P3, P4).
+ *   The CLI collapses them into one user action because "I approved it, now
+ *   run it" is the correct product-shell semantic. The intermediate "approved"
+ *   state is not shown to the user — it is internal to the transition.
+ *
+ * ── What these functions are NOT ──────────────────────────────────────────────
+ *
+ *   NOT authority layers — all decisions are delegated to session functions.
+ *   NOT renderers — rendering is in render.ts.
+ *   NOT stateful — they return new state; they do not mutate.
+ */
+import { approve, reject, acceptConflict, answerScope, deliver, } from "../product/cursor-product-session.js";
+// ─── Confirm advance (y/n) ────────────────────────────────────────────────────
+/**
+ * Advance the session based on a yes/no answer to the current confirm prompt.
+ *
+ * Called when `renderCursorFrame(state).prompt.kind === "confirm"`.
+ *
+ * @param state    Current session state (must be "prepared" or "conflict").
+ * @param yes      true = user said yes; false = user said no.
+ * @param plugin   The Cursor editor plugin for delivery.
+ * @param storeDir UCP store directory for envelope persistence.
+ */
+export async function advanceCursorOnConfirm(state, yes, plugin, storeDir) {
+    if (!yes)
+        return reject(state);
+    if (state.phase === "conflict") {
+        // Accept the conflict — session returns to "prepared". User will see a
+        // fresh "prepared" frame and be asked to approve explicitly.
+        return acceptConflict(state);
+    }
+    if (state.phase === "prepared") {
+        // Approve then immediately deliver.
+        // approve() → "approved" (internal), deliver() → final outcome.
+        const approved = approve(state);
+        return deliver(approved, plugin, storeDir);
+    }
+    // Phase is not "conflict" or "prepared" — return unchanged (defensive).
+    return state;
+}
+// ─── Choice advance (1-N selection) ──────────────────────────────────────────
+/**
+ * Advance the session based on a numbered choice for scope clarification.
+ *
+ * Called when `renderCursorFrame(state).prompt.kind === "choose"`.
+ *
+ * @param state      Current session state (must be "scope_question").
+ * @param choiceIdx  1-based index into `state.scopeQuestion.candidates`.
+ * @param plugin     The Cursor editor plugin for delivery.
+ * @param storeDir   UCP store directory for envelope persistence.
+ * @returns          Next session state. If choiceIdx is out of range,
+ *                   returns state unchanged so the CLI can re-prompt.
+ */
+export async function advanceCursorOnChoice(state, choiceIdx, plugin, storeDir) {
+    const candidates = state.scopeQuestion?.candidates ?? [];
+    const file = candidates[choiceIdx - 1];
+    if (!file)
+        return state;
+    // answerScope → "approved", then deliver immediately.
+    const narrowed = answerScope(state, file);
+    return deliver(narrowed, plugin, storeDir);
+}
+//# sourceMappingURL=cursor-shell.js.map

package/dist/src/shell/cursor-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-shell.js","sourceRoot":"","sources":["../../../src/shell/cursor-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAIH,OAAO,EACL,OAAO,EACP,MAAM,EACN,cAAc,EACd,WAAW,EACX,OAAO,GACR,MAAM,sCAAsC,CAAC;AAE9C,iFAAiF;AAEjF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA4B,EAC5B,GAAiB,EACjB,MAA4B,EAC5B,QAAgB;IAEhB,IAAI,CAAC,GAAG;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAE/B,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC/B,uEAAuE;QACvE,6DAA6D;QAC7D,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC/B,oCAAoC;QACpC,gEAAgE;QAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,wEAAwE;IACxE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAA6B,EAC7B,SAAiB,EACjB,MAA6B,EAC7B,QAAiB;IAEjB,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE,UAAU,IAAI,EAAE,CAAC;IACzD,MAAM,IAAI,GAAS,UAAU,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAE7C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAExB,sDAAsD;IACtD,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC"}

package/dist/src/shell/defaults.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Phase 9A: Shell default policies.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Sensible default policies for the CLI demo and development use.
+ *   These are NOT authoritative policy for production deployments — each
+ *   workspace should configure its own OCD policy.
+ *
+ *   They are exported here so the CLI main loop and integration tests can
+ *   share a consistent baseline without duplicating policy literals.
+ *
+ * ── What is NOT here ──────────────────────────────────────────────────────────
+ *
+ *   Production policy config (belongs in the workspace configuration layer).
+ *   The UCP store path (depends on runtime environment — tmpdir for demo).
+ */
+import type { CursorOCDPolicy } from "../cursor/types.js";
+import type { ClaudeOCDPolicy } from "../claude/artifact-mapper.js";
+import type { ClaudeToolPolicy } from "../claude/types.js";
+/**
+ * Default Cursor OCD policy for CLI use.
+ *
+ * Protects: migrations, .env files, secrets, lockfiles, node_modules, .git.
+ * Safe write zone: src/**, tests/**, docs/**.
+ * Max files: 5 (reasonable for a single-command edit).
+ * Workspace root: current working directory at startup.
+ */
+export declare const DEFAULT_CURSOR_POLICY: CursorOCDPolicy;
+/**
+ * Default Claude OCD policy for CLI use.
+ *
+ * Same prohibited globs as the Cursor default.
+ * writeSafeGlobs matches the Cursor policy for consistency.
+ */
+export declare const DEFAULT_CLAUDE_OCD_POLICY: ClaudeOCDPolicy;
+/**
+ * Default Claude tool policy for CLI use.
+ *
+ * V1: network access is always "deny". filesystemMode is always "scoped_only".
+ * Tools: the standard V1 read/write set.
+ */
+export declare const DEFAULT_CLAUDE_TOOL_POLICY: ClaudeToolPolicy;
+/**
+ * Default UCP store directory for the CLI shell.
+ *
+ * Uses the OS temp directory so demo runs do not pollute the workspace.
+ * Production shells should point to a committed or managed store path.
+ */
+export declare const DEFAULT_STORE_DIR: string;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/src/shell/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/shell/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAYnC,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,eASvC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBAIxC,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAwC,CAAC"}

package/dist/src/shell/defaults.js

@@ -0,0 +1,78 @@
+/**
+ * Phase 9A: Shell default policies.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Sensible default policies for the CLI demo and development use.
+ *   These are NOT authoritative policy for production deployments — each
+ *   workspace should configure its own OCD policy.
+ *
+ *   They are exported here so the CLI main loop and integration tests can
+ *   share a consistent baseline without duplicating policy literals.
+ *
+ * ── What is NOT here ──────────────────────────────────────────────────────────
+ *
+ *   Production policy config (belongs in the workspace configuration layer).
+ *   The UCP store path (depends on runtime environment — tmpdir for demo).
+ */
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+// ─── Cursor defaults ──────────────────────────────────────────────────────────
+/**
+ * Default Cursor OCD policy for CLI use.
+ *
+ * Protects: migrations, .env files, secrets, lockfiles, node_modules, .git.
+ * Safe write zone: src/**, tests/**, docs/**.
+ * Max files: 5 (reasonable for a single-command edit).
+ * Workspace root: current working directory at startup.
+ */
+export const DEFAULT_CURSOR_POLICY = {
+    writeSafeGlobs: ["src/**", "tests/**", "docs/**"],
+    maxFilesApprovalThreshold: 5,
+    alwaysProhibitedGlobs: [
+        "**/migrations/**",
+        "**/.env*",
+        "**/secrets/**",
+        "*.lock",
+        "**/__generated__/**",
+    ],
+    emptyAllowedFilesAdditionalProhibitions: ["**/node_modules/**", "**/.git/**"],
+    workspaceRoot: process.cwd(),
+};
+// ─── Claude defaults ──────────────────────────────────────────────────────────
+/**
+ * Default Claude OCD policy for CLI use.
+ *
+ * Same prohibited globs as the Cursor default.
+ * writeSafeGlobs matches the Cursor policy for consistency.
+ */
+export const DEFAULT_CLAUDE_OCD_POLICY = {
+    alwaysProhibitedGlobs: [
+        "**/migrations/**",
+        "**/.env*",
+        "**/secrets/**",
+        "*.lock",
+        "**/__generated__/**",
+    ],
+    writeSafeGlobs: ["src/**", "tests/**", "docs/**"],
+};
+/**
+ * Default Claude tool policy for CLI use.
+ *
+ * V1: network access is always "deny". filesystemMode is always "scoped_only".
+ * Tools: the standard V1 read/write set.
+ */
+export const DEFAULT_CLAUDE_TOOL_POLICY = {
+    allowedTools: ["str_replace_editor", "read_file", "list_files"],
+    networkAccess: "deny",
+    filesystemMode: "scoped_only",
+};
+// ─── UCP store ────────────────────────────────────────────────────────────────
+/**
+ * Default UCP store directory for the CLI shell.
+ *
+ * Uses the OS temp directory so demo runs do not pollute the workspace.
+ * Production shells should point to a committed or managed store path.
+ */
+export const DEFAULT_STORE_DIR = join(tmpdir(), "usesteady-ucp");
+//# sourceMappingURL=defaults.js.map

package/dist/src/shell/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/shell/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAQ,WAAW,CAAC;AAKnC,iFAAiF;AAEjF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAoB;IACpD,cAAc,EAA2B,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC;IAC1E,yBAAyB,EAAgB,CAAC;IAC1C,qBAAqB,EAAoB;QACvC,kBAAkB;QAClB,UAAU;QACV,eAAe;QACf,QAAQ;QACR,qBAAqB;KACtB;IACD,uCAAuC,EAAE,CAAC,oBAAoB,EAAE,YAAY,CAAC;IAC7E,aAAa,EAA4B,OAAO,CAAC,GAAG,EAAE;CACvD,CAAC;AAEF,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoB;IACxD,qBAAqB,EAAE;QACrB,kBAAkB;QAClB,UAAU;QACV,eAAe;QACf,QAAQ;QACR,qBAAqB;KACtB;IACD,cAAc,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC;CAClD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,YAAY,EAAK,CAAC,oBAAoB,EAAE,WAAW,EAAE,YAAY,CAAC;IAClE,aAAa,EAAI,MAAM;IACvB,cAAc,EAAG,aAAa;CAC/B,CAAC;AAEF,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAW,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC"}

package/dist/src/shell/history-render.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Phase 10C: History / Audit shell rendering.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Pure function that maps HistoryView state → ShellFrame.
+ *   No I/O. No store reads. No authority.
+ *
+ * ── Two views ─────────────────────────────────────────────────────────────────
+ *
+ *   list   — WorkflowHistorySummary[] rendered as a numbered list.
+ *            Prompt: "choose" so the user can select a run by number.
+ *            When empty: no prompt (terminal — CLI loop exits or re-prompts).
+ *
+ *   detail — WorkflowAuditRecord rendered as full per-task session chain.
+ *            Prompt: "confirm" to return to list.
+ *
+ * ── Key invariants (HR1–HR4) ──────────────────────────────────────────────────
+ *
+ *   HR1: Pure — no side effects, no store reads, no I/O.
+ *   HR2: No live WorkflowRun objects enter this module.
+ *        The view types carry already-resolved read-model data.
+ *   HR3: Empty history list renders with no prompt (loop can exit cleanly).
+ *        A choose prompt is only emitted when there is at least one run.
+ *   HR4: Session chain detail (cursor/claude, handoff/receipt/refused) is
+ *        rendered for every task that has a non-null session. Tasks with
+ *        null session render as "(no session)".
+ *
+ * See: docs/phase-10a-history-audit-design.md — design record
+ *      docs/phase-10c-baseline.md             — freeze record
+ */
+import type { WorkflowHistorySummary, WorkflowAuditRecord } from "../history/types.js";
+import type { ShellFrame } from "./types.js";
+/**
+ * HistoryView — the union of views the history shell can render.
+ *
+ * list   — summary list of all persisted workflow runs
+ * detail — full audit record for one selected run
+ */
+export type HistoryView = {
+    readonly kind: "list";
+    readonly summaries: readonly WorkflowHistorySummary[];
+} | {
+    readonly kind: "detail";
+    readonly record: WorkflowAuditRecord;
+};
+/**
+ * Render a HistoryView into a ShellFrame.
+ *
+ * Pure. No I/O. No store reads.
+ * Follows the same ShellFrame contract as renderCursorFrame, renderClaudeFrame,
+ * and renderWorkflowFrame — prompt.kind ("confirm" or "choose") is the only
+ * discriminant the CLI loop needs.
+ */
+export declare function renderHistoryFrame(view: HistoryView): ShellFrame;
+//# sourceMappingURL=history-render.d.ts.map

package/dist/src/shell/history-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-render.d.ts","sourceRoot":"","sources":["../../../src/shell/history-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAoC,MAAM,qBAAqB,CAAC;AACzH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAG,QAAQ,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,CAAA;CAAE,GAClF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAK,mBAAmB,CAAA;CAAE,CAAC;AA+IzE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAKhE"}

package/dist/src/shell/history-render.js

@@ -0,0 +1,166 @@
+/**
+ * Phase 10C: History / Audit shell rendering.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Pure function that maps HistoryView state → ShellFrame.
+ *   No I/O. No store reads. No authority.
+ *
+ * ── Two views ─────────────────────────────────────────────────────────────────
+ *
+ *   list   — WorkflowHistorySummary[] rendered as a numbered list.
+ *            Prompt: "choose" so the user can select a run by number.
+ *            When empty: no prompt (terminal — CLI loop exits or re-prompts).
+ *
+ *   detail — WorkflowAuditRecord rendered as full per-task session chain.
+ *            Prompt: "confirm" to return to list.
+ *
+ * ── Key invariants (HR1–HR4) ──────────────────────────────────────────────────
+ *
+ *   HR1: Pure — no side effects, no store reads, no I/O.
+ *   HR2: No live WorkflowRun objects enter this module.
+ *        The view types carry already-resolved read-model data.
+ *   HR3: Empty history list renders with no prompt (loop can exit cleanly).
+ *        A choose prompt is only emitted when there is at least one run.
+ *   HR4: Session chain detail (cursor/claude, handoff/receipt/refused) is
+ *        rendered for every task that has a non-null session. Tasks with
+ *        null session render as "(no session)".
+ *
+ * See: docs/phase-10a-history-audit-design.md — design record
+ *      docs/phase-10c-baseline.md             — freeze record
+ */
+// ─── Formatting helpers ───────────────────────────────────────────────────────
+const DIVIDER = "─".repeat(52);
+function header(label) {
+    return `${DIVIDER}\n  ${label}\n${DIVIDER}`;
+}
+function formatDate(ts) {
+    return new Date(ts).toISOString().slice(0, 10);
+}
+function outcomeTag(outcome) {
+    switch (outcome) {
+        case "accepted": return "[done]";
+        case "skipped": return "[skip]";
+        case "skipped_by_intake": return "[auto]";
+        case "stopped": return "[stop]";
+        case "rejected": return "[reject]";
+        case "pending": return "[...]";
+    }
+}
+function shortId(id) {
+    return id.slice(0, 8);
+}
+// ─── List view ────────────────────────────────────────────────────────────────
+function renderList(summaries) {
+    const lines = [];
+    lines.push(header("Workflow History"));
+    lines.push("");
+    if (summaries.length === 0) {
+        lines.push("  No workflow runs found.");
+        lines.push("");
+        // HR3: no prompt when list is empty.
+        return { lines };
+    }
+    lines.push(`  ${summaries.length} run${summaries.length === 1 ? "" : "s"} found.`);
+    lines.push("");
+    const choices = [];
+    for (let i = 0; i < summaries.length; i++) {
+        const s = summaries[i];
+        const tag = s.finalOutcome === "completed" ? "completed" : "stopped  ";
+        const stats = `${s.acceptedCount}/${s.taskCount} accepted`;
+        const row = `${s.workflowName}  ·  ${tag}  ·  ${formatDate(s.ts)}  ·  ${stats}`;
+        lines.push(`  ${i + 1}.  [${shortId(s.workflowRunId)}]  ${row}`);
+        choices.push(row);
+    }
+    lines.push("");
+    return {
+        lines,
+        prompt: {
+            kind: "choose",
+            question: "Select run to inspect:",
+            choices,
+        },
+    };
+}
+// ─── Detail view ──────────────────────────────────────────────────────────────
+function renderSessionChainLines(session) {
+    const lines = [];
+    lines.push(`    runtime   ${session.runtime}`);
+    if (session.cursorHandoff) {
+        lines.push(`    handoff   persisted`);
+        if (session.cursorReceipt) {
+            lines.push(`    receipt   accepted`);
+        }
+        else if (session.cursorRefused) {
+            const p = session.cursorRefused.payload;
+            const kind = p.refusalKind ?? "refused";
+            const sub = p.scopeQuestionKind;
+            lines.push(`    refused   ${kind}${sub ? `  [${sub}]` : ""}`);
+        }
+    }
+    else if (session.claudeHandoff) {
+        lines.push(`    handoff   persisted`);
+        if (session.claudeReceipt) {
+            lines.push(`    receipt   accepted`);
+        }
+        else if (session.claudeRefused) {
+            const p = session.claudeRefused.payload;
+            const kind = p.refusalKind ?? "refused";
+            lines.push(`    refused   ${kind}`);
+        }
+    }
+    return lines;
+}
+function renderDetail(record) {
+    const lines = [];
+    const tag = record.finalOutcome === "completed" ? "completed" : "stopped";
+    lines.push(header("Workflow Audit"));
+    lines.push("");
+    lines.push(`  ${record.workflowName}`);
+    lines.push(`  outcome    ${tag}`);
+    lines.push(`  run id     ${shortId(record.workflowRunId)}`);
+    lines.push(`  date       ${formatDate(record.ts)}`);
+    lines.push(`  tasks      ${record.acceptedCount}/${record.taskCount} accepted`);
+    lines.push("");
+    if (record.tasks.length === 0) {
+        lines.push("  No tasks ran.");
+        lines.push("");
+    }
+    for (const task of record.tasks) {
+        const inputText = task.input ? `"${task.input}"` : "(no input)";
+        lines.push(`  Task ${task.taskIndex + 1}  ${inputText}`);
+        lines.push(`    outcome   ${outcomeTag(task.outcome)}   retries: ${task.retryCount}`);
+        if (task.session === null) {
+            lines.push(`    session   (none)`);
+        }
+        else {
+            for (const line of renderSessionChainLines(task.session)) {
+                lines.push(line);
+            }
+        }
+        lines.push("");
+    }
+    return {
+        lines,
+        prompt: {
+            kind: "confirm",
+            question: "Return to list? (Enter / y  or 'exit')",
+        },
+    };
+}
+// ─── Main render function ─────────────────────────────────────────────────────
+/**
+ * Render a HistoryView into a ShellFrame.
+ *
+ * Pure. No I/O. No store reads.
+ * Follows the same ShellFrame contract as renderCursorFrame, renderClaudeFrame,
+ * and renderWorkflowFrame — prompt.kind ("confirm" or "choose") is the only
+ * discriminant the CLI loop needs.
+ */
+export function renderHistoryFrame(view) {
+    switch (view.kind) {
+        case "list": return renderList(view.summaries);
+        case "detail": return renderDetail(view.record);
+    }
+}
+//# sourceMappingURL=history-render.js.map

package/dist/src/shell/history-render.js.map

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

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

@@ -0,0 +1,43 @@
+/**
+ * Phase 9A + 9D + 10C: Product Shell — public API.
+ *
+ * ── What this module exports ──────────────────────────────────────────────────
+ *
+ *   types    — ShellFrame, ShellPrompt, ShellRuntime
+ *   render   — renderCursorFrame, renderClaudeFrame, renderWorkflowFrame,
+ *              renderHistoryFrame (Phase 10C)
+ *   advance  — advanceCursorOnConfirm, advanceCursorOnChoice,
+ *              advanceClaudeOnConfirm, advanceClaudeOnChoice (Phase 9A)
+ *              advanceWorkflowOnConfirm, advanceWorkflowOnChoice (Phase 9D)
+ *   defaults — DEFAULT_CURSOR_POLICY, DEFAULT_CLAUDE_OCD_POLICY,
+ *              DEFAULT_CLAUDE_TOOL_POLICY, DEFAULT_STORE_DIR,
+ *              DEFAULT_WORKFLOW_POLICIES
+ *
+ * ── What is NOT exported ──────────────────────────────────────────────────────
+ *
+ *   The CLI main loop (src/shell/cli/main.ts) — it has I/O and is not
+ *   a library concern. It imports from this module.
+ *
+ * ── WS6 guarantee ─────────────────────────────────────────────────────────────
+ *
+ *   All render functions return the same ShellFrame contract.
+ *   A generic shell loop can drive cursor, claude, workflow, AND history frames
+ *   without special-casing any runtime or view kind.
+ *   Prompt kind ("confirm" or "choose") is the only discriminant needed.
+ *
+ * See: docs/phase-9a-baseline.md
+ *      docs/phase-9d-baseline.md
+ *      docs/phase-10c-baseline.md
+ */
+export type { ShellRuntime, ShellFrame, ShellPrompt } from "./types.js";
+export { renderCursorFrame, renderClaudeFrame } from "./render.js";
+export { advanceCursorOnConfirm, advanceCursorOnChoice, } from "./cursor-shell.js";
+export { advanceClaudeOnConfirm, advanceClaudeOnChoice, } from "./claude-shell.js";
+export { renderWorkflowFrame } from "./workflow-render.js";
+export type { HistoryView } from "./history-render.js";
+export { renderHistoryFrame } from "./history-render.js";
+export type { WorkflowShellPolicies } from "./workflow-shell.js";
+export { advanceWorkflowOnConfirm, advanceWorkflowOnChoice, } from "./workflow-shell.js";
+export { DEFAULT_CURSOR_POLICY, DEFAULT_CLAUDE_OCD_POLICY, DEFAULT_CLAUDE_TOOL_POLICY, DEFAULT_STORE_DIR, } from "./defaults.js";
+export { DEFAULT_WORKFLOW_POLICIES } from "./workflow-defaults.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shell/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIxE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAInE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAI3D,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/shell/index.js

@@ -0,0 +1,45 @@
+/**
+ * Phase 9A + 9D + 10C: Product Shell — public API.
+ *
+ * ── What this module exports ──────────────────────────────────────────────────
+ *
+ *   types    — ShellFrame, ShellPrompt, ShellRuntime
+ *   render   — renderCursorFrame, renderClaudeFrame, renderWorkflowFrame,
+ *              renderHistoryFrame (Phase 10C)
+ *   advance  — advanceCursorOnConfirm, advanceCursorOnChoice,
+ *              advanceClaudeOnConfirm, advanceClaudeOnChoice (Phase 9A)
+ *              advanceWorkflowOnConfirm, advanceWorkflowOnChoice (Phase 9D)
+ *   defaults — DEFAULT_CURSOR_POLICY, DEFAULT_CLAUDE_OCD_POLICY,
+ *              DEFAULT_CLAUDE_TOOL_POLICY, DEFAULT_STORE_DIR,
+ *              DEFAULT_WORKFLOW_POLICIES
+ *
+ * ── What is NOT exported ──────────────────────────────────────────────────────
+ *
+ *   The CLI main loop (src/shell/cli/main.ts) — it has I/O and is not
+ *   a library concern. It imports from this module.
+ *
+ * ── WS6 guarantee ─────────────────────────────────────────────────────────────
+ *
+ *   All render functions return the same ShellFrame contract.
+ *   A generic shell loop can drive cursor, claude, workflow, AND history frames
+ *   without special-casing any runtime or view kind.
+ *   Prompt kind ("confirm" or "choose") is the only discriminant needed.
+ *
+ * See: docs/phase-9a-baseline.md
+ *      docs/phase-9d-baseline.md
+ *      docs/phase-10c-baseline.md
+ */
+// ─── Rendering ────────────────────────────────────────────────────────────────
+export { renderCursorFrame, renderClaudeFrame } from "./render.js";
+// ─── Cursor advance functions ─────────────────────────────────────────────────
+export { advanceCursorOnConfirm, advanceCursorOnChoice, } from "./cursor-shell.js";
+// ─── Claude advance functions ─────────────────────────────────────────────────
+export { advanceClaudeOnConfirm, advanceClaudeOnChoice, } from "./claude-shell.js";
+// ─── Workflow render (Phase 9D) ───────────────────────────────────────────────
+export { renderWorkflowFrame } from "./workflow-render.js";
+export { renderHistoryFrame } from "./history-render.js";
+export { advanceWorkflowOnConfirm, advanceWorkflowOnChoice, } from "./workflow-shell.js";
+// ─── Defaults ─────────────────────────────────────────────────────────────────
+export { DEFAULT_CURSOR_POLICY, DEFAULT_CLAUDE_OCD_POLICY, DEFAULT_CLAUDE_TOOL_POLICY, DEFAULT_STORE_DIR, } from "./defaults.js";
+export { DEFAULT_WORKFLOW_POLICIES } from "./workflow-defaults.js";
+//# sourceMappingURL=index.js.map