usesteady 0.1.0-alpha.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shell/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAMH,iFAAiF;AAEjF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnE,iFAAiF;AAEjF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,iFAAiF;AAEjF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,iFAAiF;AAEjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAK3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAMzD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,iFAAiF;AAEjF,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/render.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Phase 9A: Shell rendering.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Pure functions that map session state → ShellFrame.
+ *   No I/O. No session transitions. No authority.
+ *
+ * ── Display contract ──────────────────────────────────────────────────────────
+ *
+ *   Every frame has:
+ *     - A phase header (runtime + phase name)
+ *     - One or more content lines (from session.display)
+ *     - An optional prompt (matched to the phase's expected next action)
+ *
+ *   Terminal phases produce no prompt.
+ *   "approved" produces no prompt — the CLI advance functions call deliver
+ *   immediately after approve, so this phase is not surfaced to the user.
+ *
+ * ── What this is NOT ──────────────────────────────────────────────────────────
+ *
+ *   NOT a state machine — it reads phase and display; it does not modify them.
+ *   NOT an authority layer — it reflects what the session already decided.
+ */
+import type { CursorSessionState } from "../product/cursor-product-session.js";
+import type { ClaudeSessionState } from "../product/claude-product-session.js";
+import type { ShellFrame } from "./types.js";
+/**
+ * Render a Cursor product session state into a ShellFrame.
+ *
+ * The returned frame is ready to print and optionally prompt.
+ * No session state is modified.
+ */
+export declare function renderCursorFrame(state: CursorSessionState): ShellFrame;
+/**
+ * Render a Claude product session state into a ShellFrame.
+ *
+ * The returned frame is ready to print and optionally prompt.
+ * No session state is modified.
+ */
+export declare function renderClaudeFrame(state: ClaudeSessionState): ShellFrame;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/shell/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,sCAAsC,CAAC;AAC7F,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,sCAAsC,CAAC;AACnG,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AA2F1D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU,CAUvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU,CAUvE"}

package/dist/src/shell/render.js

@@ -0,0 +1,122 @@
+/**
+ * Phase 9A: Shell rendering.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Pure functions that map session state → ShellFrame.
+ *   No I/O. No session transitions. No authority.
+ *
+ * ── Display contract ──────────────────────────────────────────────────────────
+ *
+ *   Every frame has:
+ *     - A phase header (runtime + phase name)
+ *     - One or more content lines (from session.display)
+ *     - An optional prompt (matched to the phase's expected next action)
+ *
+ *   Terminal phases produce no prompt.
+ *   "approved" produces no prompt — the CLI advance functions call deliver
+ *   immediately after approve, so this phase is not surfaced to the user.
+ *
+ * ── What this is NOT ──────────────────────────────────────────────────────────
+ *
+ *   NOT a state machine — it reads phase and display; it does not modify them.
+ *   NOT an authority layer — it reflects what the session already decided.
+ */
+// ─── Formatting helpers ───────────────────────────────────────────────────────
+const DIVIDER = "─".repeat(52);
+function header(label) {
+    return `${DIVIDER}\n  ${label}\n${DIVIDER}`;
+}
+function phaseLabel(phase, runtime) {
+    const rt = runtime === "cursor" ? "Cursor" : "Claude";
+    const label = phase.toUpperCase().replace(/_/g, " ");
+    return `[${rt}] ${label}`;
+}
+function buildBodyLines(d) {
+    const lines = [`  ${d.headline}`];
+    if (d.changeSummary) {
+        lines.push(`  Summary:    ${d.changeSummary}`);
+    }
+    if (d.targetFiles && d.targetFiles.length > 0) {
+        lines.push(`  Files:      ${d.targetFiles.join(", ")}`);
+    }
+    if (d.conflicts && d.conflicts.length > 0) {
+        lines.push(`  Conflicts:`);
+        for (const c of d.conflicts) {
+            lines.push(`    • ${c}`);
+        }
+    }
+    if (d.scopeCandidates && d.scopeCandidates.length > 0) {
+        lines.push(`  Candidates:`);
+        d.scopeCandidates.forEach((c, i) => {
+            lines.push(`    ${i + 1}. ${c}`);
+        });
+    }
+    if (d.resultNote) {
+        lines.push(`  Result:     ${d.resultNote}`);
+    }
+    return lines;
+}
+function promptForPhase(phase, candidates) {
+    switch (phase) {
+        case "prepared":
+            return { kind: "confirm", question: "Approve this change? (y/n)" };
+        case "conflict":
+            return { kind: "confirm", question: "Conflicts detected. Accept and proceed anyway? (y/n)" };
+        case "scope_question":
+            return {
+                kind: "choose",
+                question: "Select a file to apply the change (enter number):",
+                choices: candidates ?? [],
+            };
+        // Terminal phases — no prompt.
+        case "accepted":
+        case "rejected":
+        case "exec_error":
+        case "blocked":
+        case "not_execute":
+        case "intake_failed":
+            return undefined;
+        // Transient phases not surfaced to user by the CLI advance loop.
+        case "idle":
+        case "approved":
+        default:
+            return undefined;
+    }
+}
+// ─── Public rendering functions ───────────────────────────────────────────────
+/**
+ * Render a Cursor product session state into a ShellFrame.
+ *
+ * The returned frame is ready to print and optionally prompt.
+ * No session state is modified.
+ */
+export function renderCursorFrame(state) {
+    const { phase, display } = state;
+    const lines = [
+        "",
+        header(phaseLabel(phase, "cursor")),
+        ...buildBodyLines(display),
+        "",
+    ];
+    const prompt = promptForPhase(phase, display.scopeCandidates);
+    return prompt !== undefined ? { lines, prompt } : { lines };
+}
+/**
+ * Render a Claude product session state into a ShellFrame.
+ *
+ * The returned frame is ready to print and optionally prompt.
+ * No session state is modified.
+ */
+export function renderClaudeFrame(state) {
+    const { phase, display } = state;
+    const lines = [
+        "",
+        header(phaseLabel(phase, "claude")),
+        ...buildBodyLines(display),
+        "",
+    ];
+    const prompt = promptForPhase(phase, display.scopeCandidates);
+    return prompt !== undefined ? { lines, prompt } : { lines };
+}
+//# sourceMappingURL=render.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * Phase 9A: Product Shell types.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   These types define the output contract between the session layer and the
+ *   I/O layer (CLI main loop, test harness, or any future product surface).
+ *
+ *   ShellFrame: what the surface should display + ask for next.
+ *   The surface renders frames; all authority stays in the session layer.
+ *
+ * ── What the shell is NOT ─────────────────────────────────────────────────────
+ *
+ *   NOT authority — it calls session functions; it makes no decisions.
+ *   NOT a session — it consumes sessions; it does not manage their state.
+ *   NOT a router  — it renders what the session already decided.
+ */
+export type ShellRuntime = "cursor" | "claude";
+/**
+ * A ShellFrame is the complete rendering of one session state.
+ *
+ * The surface prints frame.lines and, if frame.prompt is defined, reads
+ * user input. If frame.prompt is absent, the session is terminal — no
+ * further input is needed.
+ */
+export type ShellFrame = {
+    /** Lines to print to the terminal. Never empty. */
+    readonly lines: readonly string[];
+    /**
+     * What to ask the user next.
+     * Absent when the session phase is terminal (accepted, rejected, exec_error,
+     * blocked, not_execute, intake_failed).
+     */
+    readonly prompt?: ShellPrompt;
+};
+export type ShellPrompt = {
+    /** Yes/no confirmation. Used for "prepared" and "conflict" phases. */
+    kind: "confirm";
+    question: string;
+} | {
+    /** Numbered selection. Used for "scope_question" phase. */
+    kind: "choose";
+    question: string;
+    choices: readonly string[];
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shell/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAI/C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAIF,MAAM,MAAM,WAAW,GACnB;IACE,sEAAsE;IACtE,IAAI,EAAM,SAAS,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,2DAA2D;IAC3D,IAAI,EAAM,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAG,SAAS,MAAM,EAAE,CAAC;CAC7B,CAAC"}

package/dist/src/shell/types.js

@@ -0,0 +1,19 @@
+/**
+ * Phase 9A: Product Shell types.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   These types define the output contract between the session layer and the
+ *   I/O layer (CLI main loop, test harness, or any future product surface).
+ *
+ *   ShellFrame: what the surface should display + ask for next.
+ *   The surface renders frames; all authority stays in the session layer.
+ *
+ * ── What the shell is NOT ─────────────────────────────────────────────────────
+ *
+ *   NOT authority — it calls session functions; it makes no decisions.
+ *   NOT a session — it consumes sessions; it does not manage their state.
+ *   NOT a router  — it renders what the session already decided.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shell/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

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

@@ -0,0 +1,23 @@
+/**
+ * Phase 9D: Workflow shell default policies.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Sensible defaults for driving the WorkflowCoordinator from the CLI shell.
+ *   Groups all three policy objects into one WorkflowShellPolicies value so
+ *   the CLI main loop doesn't have to build them inline.
+ *
+ * ── What is NOT here ──────────────────────────────────────────────────────────
+ *
+ *   Production policy config (workspace-specific).
+ *   Workflow OCD overrides (spec-level, not defaults).
+ */
+import type { WorkflowShellPolicies } from "./workflow-shell.js";
+/**
+ * Default WorkflowShellPolicies for CLI use.
+ *
+ * Wraps the three existing shell defaults into the grouped type expected by
+ * advanceWorkflowOnConfirm and advanceWorkflowOnChoice.
+ */
+export declare const DEFAULT_WORKFLOW_POLICIES: WorkflowShellPolicies;
+//# sourceMappingURL=workflow-defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-defaults.d.ts","sourceRoot":"","sources":["../../../src/shell/workflow-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,qBAIvC,CAAC"}

package/dist/src/shell/workflow-defaults.js

@@ -0,0 +1,27 @@
+/**
+ * Phase 9D: Workflow shell default policies.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Sensible defaults for driving the WorkflowCoordinator from the CLI shell.
+ *   Groups all three policy objects into one WorkflowShellPolicies value so
+ *   the CLI main loop doesn't have to build them inline.
+ *
+ * ── What is NOT here ──────────────────────────────────────────────────────────
+ *
+ *   Production policy config (workspace-specific).
+ *   Workflow OCD overrides (spec-level, not defaults).
+ */
+import { DEFAULT_CURSOR_POLICY, DEFAULT_CLAUDE_OCD_POLICY, DEFAULT_CLAUDE_TOOL_POLICY } from "./defaults.js";
+/**
+ * Default WorkflowShellPolicies for CLI use.
+ *
+ * Wraps the three existing shell defaults into the grouped type expected by
+ * advanceWorkflowOnConfirm and advanceWorkflowOnChoice.
+ */
+export const DEFAULT_WORKFLOW_POLICIES = {
+    cursorPolicy: DEFAULT_CURSOR_POLICY,
+    claudeOCDPolicy: DEFAULT_CLAUDE_OCD_POLICY,
+    claudeToolPolicy: DEFAULT_CLAUDE_TOOL_POLICY,
+};
+//# sourceMappingURL=workflow-defaults.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-defaults.js","sourceRoot":"","sources":["../../../src/shell/workflow-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAG7G;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAA0B;IAC9D,YAAY,EAAM,qBAAqB;IACvC,eAAe,EAAG,yBAAyB;IAC3C,gBAAgB,EAAE,0BAA0B;CAC7C,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * Phase 9D: Workflow shell rendering.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   Pure function that maps WorkflowRun state → ShellFrame.
+ *   No I/O. No coordinator calls. No authority.
+ *
+ * ── Two-layer read rule (WS6) ─────────────────────────────────────────────────
+ *
+ *   1. Read WorkflowRun.phase first — determines the frame type and prompt kind.
+ *   2. Read currentSession.state.display second — provides task-level detail
+ *      (change summary, conflict list, scope candidates, failure note).
+ *
+ *   Never conflate workflow phase with session phase. See docs/phase-9c-baseline.md
+ *   for the full phase distinction table.
+ *
+ * ── Key invariants (WS1–WS5) ──────────────────────────────────────────────────
+ *
+ *   WS1: Pure — no side effects, no state mutation.
+ *   WS3: task_failed prompt is always "choose" (stop/skip/retry), never "confirm".
+ *        A choice prompt cannot imply a default the way a yes/no confirm can.
+ *   WS4: Failure note from display.failureNote is preserved verbatim.
+ *        exec_error, blocked, rejected, and missing-plugin all have distinct notes.
+ *        The renderer never replaces these with a generic "task failed" message.
+ *   WS5: completed/stopped frames read history from run.tasks[i].outcome, not
+ *        from currentSession (which is absent in those phases).
+ *
+ * ── task_approved rendering (9C distinction) ──────────────────────────────────
+ *
+ *   task_approved renders as "Approved — ready to deliver."
+ *   Never as "Accepted" or "Completed". Those are delivery outcomes.
+ *   The advance functions collapse approve+deliver into one user action, so
+ *   task_approved is usually a transient frame — but it must not visually blur.
+ *
+ * See: docs/phase-9c-baseline.md — workflow/session phase distinction
+ *      docs/phase-9d-baseline.md — Phase 9D freeze record
+ */
+import type { WorkflowRun } from "../workflow/types.js";
+import type { ShellFrame } from "./types.js";
+/**
+ * Render a WorkflowRun into a ShellFrame.
+ *
+ * WS1: Pure — no I/O, no side effects.
+ * WS6: Returns the same ShellFrame contract as renderCursorFrame /
+ *      renderClaudeFrame. A generic shell loop can drive all three without
+ *      special workflow logic.
+ *
+ * Two-layer read rule:
+ *   1. Switch on run.phase (workflow coordinator layer).
+ *   2. Read currentSession.state.display for task-level detail (session layer).
+ */
+export declare function renderWorkflowFrame(run: WorkflowRun): ShellFrame;
+//# sourceMappingURL=workflow-render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-render.d.ts","sourceRoot":"","sources":["../../../src/shell/workflow-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAe,MAAe,YAAY,CAAC;AAqFnE;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,UAAU,CAkNhE"}