poly-weaver 0.7.1 → 0.8.0

package/dist/session/resume.js

@@ -0,0 +1,109 @@
+import { join } from "node:path";
+import { readdir } from "node:fs/promises";
+import { setProviderVersions } from "../providers/registry.js";
+import { runPreflight, computePreflightNeeds } from "../preflight.js";
+import { StatusBar } from "../status-bar.js";
+import { DumpService } from "../dump/service.js";
+import { getGitInfo } from "../git-info.js";
+import { TerminalHost } from "../terminal/host.js";
+import { BufferOrchestrationOutput, ConsoleOrchestrationOutput } from "../terminal/output.js";
+import { CLEAR_SCREEN, CURSOR_HOME, SHOW_CURSOR } from "../ansi.js";
+import { orchestrateWithTemplate, interpretOrchestrationResult, interpretOrchestrationError, } from "../orchestrator.js";
+import { rehydrateFlow } from "./flow-snapshot.js";
+import { readJsonIfExists } from "./persistence.js";
+export async function runResumedSession(session, pkgVersion) {
+    const persistentDir = session.persistentDir;
+    const manifest = session.manifest;
+    if (manifest.status === "complete") {
+        return { exitCode: 1, exitMessage: `\nSession ${session.sessionId} is already complete.` };
+    }
+    const steps = new Map();
+    try {
+        const stepFiles = (await readdir(join(persistentDir, "steps")))
+            .filter(f => f.endsWith(".json"));
+        const entries = await Promise.all(stepFiles.map(f => readJsonIfExists(join(persistentDir, "steps", f))));
+        for (const entry of entries) {
+            if (entry)
+                steps.set(entry.seq, entry);
+        }
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+    }
+    // Rehydrate the flow template from the snapshot
+    const template = await rehydrateFlow(persistentDir);
+    // Re-run preflight against the resumed session's params
+    const preflight = await runPreflight(computePreflightNeeds({
+        planner: String(manifest.flow.params.planner),
+        reviewer: String(manifest.flow.params.reviewer),
+        implementor: String(manifest.flow.params.implementor),
+        simplifier: manifest.flow.params.simplifier
+            ? String(manifest.flow.params.simplifier)
+            : undefined,
+        planOnly: !!manifest.flow.params.planOnly,
+    }));
+    setProviderVersions(preflight.versions);
+    if (!preflight.ok) {
+        return {
+            exitCode: 1,
+            exitMessage: "\nPreflight checks failed on resume:\n" + preflight.errors.map(e => `  ${e}`).join("\n"),
+        };
+    }
+    const hostMode = process.stdin.isTTY === true && process.stdout.isTTY === true;
+    const statusBar = new StatusBar(undefined, { hostManaged: hostMode });
+    statusBar.init();
+    const gitInfo = await getGitInfo(manifest.workdir);
+    if (gitInfo)
+        statusBar.setGitInfo(gitInfo);
+    const dumpService = process.stdin.isTTY ? new DumpService(pkgVersion, statusBar) : undefined;
+    let terminalHost;
+    let bufferOutput;
+    if (hostMode) {
+        bufferOutput = new BufferOrchestrationOutput();
+        terminalHost = new TerminalHost({
+            statusBar,
+            output: bufferOutput,
+            onDump: dumpService ? () => { void dumpService.trigger(); } : undefined,
+        });
+        terminalHost.start();
+    }
+    const orchestrationOutput = bufferOutput ?? new ConsoleOrchestrationOutput();
+    const resumeFrom = {
+        sessionId: manifest.sessionId,
+        createdAt: manifest.createdAt,
+        persistentDir,
+        manifest,
+        steps,
+    };
+    let outcome = { exitCode: 0, exitMessage: "" };
+    try {
+        const result = await orchestrateWithTemplate({
+            template,
+            paramValues: manifest.flow.params,
+            task: manifest.taskText,
+            workdir: manifest.workdir,
+            opinionless: manifest.options.opinionless,
+            yolo: manifest.options.yolo,
+            statusBar,
+            dumpService,
+            output: orchestrationOutput,
+            terminalHost,
+            resumeFrom,
+            polyWeaverVersion: pkgVersion,
+        });
+        outcome = interpretOrchestrationResult(result);
+    }
+    catch (err) {
+        outcome = interpretOrchestrationError(err);
+    }
+    finally {
+        terminalHost?.stop();
+        statusBar.destroy();
+        if (process.stdout.isTTY) {
+            process.stdout.write(CLEAR_SCREEN + CURSOR_HOME + SHOW_CURSOR);
+        }
+    }
+    return outcome;
+}
+//# sourceMappingURL=resume.js.map

package/dist/session/resume.js.map

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

package/dist/session/session-store.d.ts

@@ -0,0 +1,43 @@
+import type { StepRecord } from "../dump/types.js";
+import type { StepContext } from "../flow/types.js";
+import type { SessionManifest } from "./manifest.js";
+/**
+ * Per-step persistent checkpoint writer.
+ *
+ * Subscribes to `ctx.onStepCompleted` alongside `DumpService`. On every step
+ * boundary, snapshots the **full** artifact store (so artifacts mutated outside
+ * `step.writes` — notably TASK after incorporateFeedback — survive a resume).
+ */
+export declare class SessionStore {
+    private readonly persistentDir;
+    private ctx;
+    private manifest;
+    constructor(persistentDir: string, manifest: SessionManifest);
+    /**
+     * Create directories and write the initial manifest atomically. Should be
+     * called exactly once per fresh session (resumed sessions re-use the
+     * existing manifest in place — see {@link initForResume}).
+     */
+    init(): Promise<void>;
+    /** For resumed sessions: ensure subdirs exist, but don't overwrite manifest. */
+    initForResume(): Promise<void>;
+    bindContext(ctx: StepContext): void;
+    getDir(): string;
+    /**
+     * Subscribed to ctx.onStepCompleted. Captures a full snapshot of
+     * ctx.artifacts plus counters.
+     */
+    readonly onStepCompleted: (record: StepRecord) => Promise<void>;
+    /** Mark this session complete so the picker hides it; pruner deletes after 7d. */
+    markComplete(): Promise<void>;
+    /** Build an ArtifactRef for one artifact, copying any file blob into the persistent dir. */
+    private snapshotArtifact;
+    /**
+     * Build a per-step input/output ref. Prefer the already-snapshotted artifact
+     * store entry (so persistentPath matches), but fall back to a minimal ref
+     * derived from the dump snapshot if the artifact wasn't in `ctx.artifacts`
+     * for some reason.
+     */
+    private refFromStoreKey;
+}
+//# sourceMappingURL=session-store.d.ts.map

package/dist/session/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/session/session-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EAAe,eAAe,EAAoB,MAAM,eAAe,CAAC;AAEpF;;;;;;GAMG;AACH,qBAAa,YAAY;IAKrB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJhC,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,QAAQ,CAAkB;gBAGf,aAAa,EAAE,MAAM,EACtC,QAAQ,EAAE,eAAe;IAK3B;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,gFAAgF;IAC1E,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAInC,MAAM,IAAI,MAAM;IAIhB;;;OAGG;IACH,QAAQ,CAAC,eAAe,GAAU,QAAQ,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC,CA2ClE;IAEF,kFAAkF;IAC5E,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC,4FAA4F;YAC9E,gBAAgB;IA2B9B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAWxB"}

package/dist/session/session-store.js

@@ -0,0 +1,134 @@
+import { copyFile } from "node:fs/promises";
+import { extname, join } from "node:path";
+import { atomicWriteJson, ensureDir, stepFilename } from "./persistence.js";
+/**
+ * Per-step persistent checkpoint writer.
+ *
+ * Subscribes to `ctx.onStepCompleted` alongside `DumpService`. On every step
+ * boundary, snapshots the **full** artifact store (so artifacts mutated outside
+ * `step.writes` — notably TASK after incorporateFeedback — survive a resume).
+ */
+export class SessionStore {
+    persistentDir;
+    ctx;
+    manifest;
+    constructor(persistentDir, manifest) {
+        this.persistentDir = persistentDir;
+        this.manifest = manifest;
+    }
+    /**
+     * Create directories and write the initial manifest atomically. Should be
+     * called exactly once per fresh session (resumed sessions re-use the
+     * existing manifest in place — see {@link initForResume}).
+     */
+    async init() {
+        await ensureDir(this.persistentDir);
+        await ensureDir(join(this.persistentDir, "artifacts"));
+        await ensureDir(join(this.persistentDir, "steps"));
+        await atomicWriteJson(join(this.persistentDir, "manifest.json"), this.manifest);
+    }
+    /** For resumed sessions: ensure subdirs exist, but don't overwrite manifest. */
+    async initForResume() {
+        await ensureDir(join(this.persistentDir, "artifacts"));
+        await ensureDir(join(this.persistentDir, "steps"));
+    }
+    bindContext(ctx) {
+        this.ctx = ctx;
+    }
+    getDir() {
+        return this.persistentDir;
+    }
+    /**
+     * Subscribed to ctx.onStepCompleted. Captures a full snapshot of
+     * ctx.artifacts plus counters.
+     */
+    onStepCompleted = async (record) => {
+        if (!this.ctx)
+            return;
+        const seq = record.seq;
+        const artifactStore = {};
+        for (const [storeKey, artifact] of this.ctx.artifacts.entries()) {
+            artifactStore[storeKey] = await this.snapshotArtifact(seq, storeKey, artifact);
+        }
+        const inputs = {};
+        for (const [alias, snap] of Object.entries(record.inputs)) {
+            inputs[alias] = this.refFromStoreKey(artifactStore, snap.artifactName, snap);
+        }
+        const outputs = {};
+        for (const [alias, snap] of Object.entries(record.outputs)) {
+            outputs[alias] = this.refFromStoreKey(artifactStore, snap.artifactName, snap);
+        }
+        const entry = {
+            seq,
+            stepId: record.stepId,
+            role: record.role,
+            driver: record.driver,
+            phaseLabel: record.phaseLabel,
+            inputs,
+            outputs,
+            artifactStore,
+            loopIterations: Object.fromEntries(this.ctx.loopIterations),
+            loopCycle: Object.fromEntries(this.ctx.loopCycle),
+            totalIterations: this.ctx.totalIterations,
+            nextClarificationNumber: this.ctx.nextClarificationNumber,
+            sessionIds: Object.fromEntries(this.ctx.sessionIds),
+            completedAt: new Date().toISOString(),
+        };
+        await atomicWriteJson(join(this.persistentDir, "steps", stepFilename(seq)), entry);
+        this.manifest = {
+            ...this.manifest,
+            lastCompletedSeq: seq,
+            lastActivityAt: entry.completedAt,
+        };
+        await atomicWriteJson(join(this.persistentDir, "manifest.json"), this.manifest);
+    };
+    /** Mark this session complete so the picker hides it; pruner deletes after 7d. */
+    async markComplete() {
+        this.manifest = {
+            ...this.manifest,
+            status: "complete",
+            lastActivityAt: new Date().toISOString(),
+        };
+        await atomicWriteJson(join(this.persistentDir, "manifest.json"), this.manifest);
+    }
+    /** Build an ArtifactRef for one artifact, copying any file blob into the persistent dir. */
+    async snapshotArtifact(seq, storeKey, artifact) {
+        const ref = { storeKey };
+        if (artifact.file) {
+            const ext = extname(artifact.file);
+            const safeKey = storeKey.replace(/[^A-Za-z0-9._-]/g, "_");
+            const dest = join(this.persistentDir, "artifacts", `step-${String(seq).padStart(4, "0")}-${safeKey}${ext}`);
+            try {
+                await copyFile(artifact.file, dest);
+                ref.persistentPath = dest;
+            }
+            catch {
+                // Source may have been cleaned up; fall through with text/data only.
+            }
+        }
+        if (artifact.text !== undefined)
+            ref.text = artifact.text;
+        if (artifact.data !== undefined)
+            ref.dataJson = JSON.stringify(artifact.data);
+        if (artifact.meta !== undefined)
+            ref.meta = artifact.meta;
+        return ref;
+    }
+    /**
+     * Build a per-step input/output ref. Prefer the already-snapshotted artifact
+     * store entry (so persistentPath matches), but fall back to a minimal ref
+     * derived from the dump snapshot if the artifact wasn't in `ctx.artifacts`
+     * for some reason.
+     */
+    refFromStoreKey(artifactStore, storeKey, fallback) {
+        if (artifactStore[storeKey])
+            return artifactStore[storeKey];
+        const ref = { storeKey };
+        if (fallback.text !== undefined)
+            ref.text = fallback.text;
+        if (fallback.dataJson !== undefined)
+            ref.dataJson = fallback.dataJson;
+        return ref;
+    }
+}
+//# sourceMappingURL=session-store.js.map

package/dist/session/session-store.js.map

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

package/dist/startup-tui.d.ts

@@ -1,5 +1,6 @@
 import type { CliOptions } from "./config.js";
 import type { FlowTemplate } from "./flow/types.js";
+import type { TerminalKey } from "./terminal-input.js";
 import type { GitInfo } from "./git-info.js";
 import { type UpdateInfo } from "./update-check.js";
 import { type ConfigField } from "./preview-panel.js";
@@ -33,15 +34,16 @@ export type TuiInputEvent = {
     type: "ctrl+c";
 };
 /**
- * TUI input parser — wraps {@link TerminalKeyParser} via composition and
- * maps {@link TerminalKey} → {@link TuiInputEvent}.
+ * Stateless mapper from `TerminalKey` events to {@link TuiInputEvent}
+ * domain events for the startup TUI / flow editor. Consumes events
+ * produced by the `KeyEventSource` byte/FFI pipeline.
  */
 export declare class TuiInputParser {
-    private parser;
-    constructor(escapeTimeoutMs?: number);
-    parseChunk(chunk: Buffer): TuiInputEvent[];
-    onDeferredEvents(cb: (events: TuiInputEvent[]) => void): void;
-    cancelPendingEscape(): void;
+    /**
+     * Map a stream of `TerminalKey[]` (from `KeyEventSource`) into TUI
+     * input events.
+     */
+    mapKeys(keys: TerminalKey[]): TuiInputEvent[];
     private mapKey;
 }
 export type { ConfigField } from "./preview-panel.js";
@@ -64,10 +66,7 @@ export interface TuiState {
     flowSectionHeight: number;
     templateIndex: number;
     taskRequired: boolean;
-    updateBanner: {
-        current: string;
-        latest: string;
-    } | null;
+    updateBanner: UpdateInfo | null;
 }
 export declare function buildInitialState(defaults: Partial<CliOptions>, rows: number, cols: number, gitInfo?: GitInfo | null): TuiState;
 /** Compute available editor height. */

package/dist/startup-tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"startup-tui.d.ts","sourceRoot":"","sources":["../src/startup-tui.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAmC,MAAM,iBAAiB,CAAC;AAQrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EASL,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAO5B,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,YAAY,EAAE,EACzB,YAAY,SAAmB,EAC/B,SAAS,SAA2C,GACnD,IAAI,CAKN;AAID,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAoB;gBAEtB,eAAe,CAAC,EAAE,MAAM;IAIpC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE;IAI1C,gBAAgB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,GAAG,IAAI;IAO7D,mBAAmB,IAAI,IAAI;IAI3B,OAAO,CAAC,MAAM;CAuCf;AAKD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC1D;AAsID,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,QAAQ,CAuCV;AAED,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAUvE;AAMD,wBAAgB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAyGrE;AAID,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,GAAG,YAAY,CAkC/E;AA0ED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,MAAM,GACf,UAAU,CAwBZ;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,CAAC,WAAW,EACvB,OAAO,GAAE,MAAM,OAAO,CAAC,UAAU,GAAG,IAAI,CAAkB,GACzD;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAazB;AAID,wBAAsB,cAAc,CAClC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,GAC5B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAoB5B"}
+{"version":3,"file":"startup-tui.d.ts","sourceRoot":"","sources":["../src/startup-tui.ts"],"names":[],"mappings":"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"}

package/dist/startup-tui.js

@@ -1,12 +1,11 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { flowReadsTask } from "./flow/inspect.js";
-import { TerminalKeyParser } from "./terminal-input.js";
-import { visibleLength, padToWidth, bold, dim, reset, cyan, green, red, yellow, HIDE_CURSOR, ALT_SCREEN_ON, ALT_SCREEN_OFF, CSI, } from "./ansi.js";
+import { createKeyEventSource } from "./terminal/key-event-source.js";
+import { padToWidth, bold, dim, reset, cyan, red, yellow, HIDE_CURSOR, ALT_SCREEN_ON, ALT_SCREEN_OFF, CSI, } from "./ansi.js";
 import { getGitInfo } from "./git-info.js";
-import { branchAnimalEmoji } from "./status-bar.js";
-import { APP_VERSION } from "./version.js";
 import { checkForUpdate } from "./update-check.js";
+import { renderAppHeader, shouldShowBanner, tildeify } from "./app-header.js";
 import { buildFieldsForTemplate as buildFieldsForTemplateBase, configRowCount, handleFieldEvent, renderConfigFields, renderFlowSection, renderEditorLines, handleTextEditorEvent, computeFlowSectionHeight, } from "./preview-panel.js";
 let flowTemplates = [];
 let flowBuiltinCount = 0;
@@ -19,26 +18,17 @@ export function setFlowTemplates(templates, builtinCount = templates.length, cus
     maxFlowNameLen = Math.max(0, ...templates.map((template) => template.name.length));
 }
 /**
- * TUI input parser — wraps {@link TerminalKeyParser} via composition and
- * maps {@link TerminalKey} → {@link TuiInputEvent}.
+ * Stateless mapper from `TerminalKey` events to {@link TuiInputEvent}
+ * domain events for the startup TUI / flow editor. Consumes events
+ * produced by the `KeyEventSource` byte/FFI pipeline.
  */
 export class TuiInputParser {
-    parser;
-    constructor(escapeTimeoutMs) {
-        this.parser = new TerminalKeyParser(escapeTimeoutMs);
-    }
-    parseChunk(chunk) {
-        return this.parser.parseChunk(chunk).flatMap((key) => this.mapKey(key));
-    }
-    onDeferredEvents(cb) {
-        this.parser.onDeferredKeys((keys) => {
-            const events = keys.flatMap((k) => this.mapKey(k));
-            if (events.length > 0)
-                cb(events);
-        });
-    }
-    cancelPendingEscape() {
-        this.parser.cancelPendingEscape();
+    /**
+     * Map a stream of `TerminalKey[]` (from `KeyEventSource`) into TUI
+     * input events.
+     */
+    mapKeys(keys) {
+        return keys.flatMap((k) => this.mapKey(k));
     }
     mapKey(key) {
         switch (key.kind) {
@@ -82,27 +72,19 @@ export class TuiInputParser {
                 if (key.keyCode === 3)
                     return [{ type: "ctrl+c" }];
                 return [];
+            case "raw":
+                // Unmapped VT frames are not meaningful to the TUI. The host
+                // (when present) is responsible for forwarding them to a child
+                // PTY; the startup TUI is not connected to one.
+                return [];
             default:
                 return [];
         }
     }
 }
 // ─── Constants ───────────────────────────────────────────────────────────
-/**
- * Whether the update banner should be rendered.
- * Suppressed when terminal is too narrow to fit the full banner text.
- */
-function shouldShowBanner(state, cols) {
-    if (!state.updateBanner)
-        return false;
-    // Visible text: "  Update available: v{cur} → v{latest}  Run: npm i -g poly-weaver"
-    // = 2 + "Update available: " (19) + "v" + cur + " → " (3) + "v" + latest + "  Run: " (7) + "npm i -g poly-weaver" (20)
-    // = 52 + cur.length + latest.length
-    const visLen = 52 + state.updateBanner.current.length + state.updateBanner.latest.length;
-    return visLen <= cols;
-}
 function headerRows(state, cols) {
-    return shouldShowBanner(state, cols) ? 3 : 2;
+    return shouldShowBanner(state.updateBanner, cols) ? 3 : 2;
 }
 const SEPARATOR_ROWS = 2; // margin line (config/flow) + separator (flow/task)
 const TASK_LABEL_ROWS = 1;
@@ -116,17 +98,6 @@ function getActiveTemplate(state) {
     ensureTemplates();
     return flowTemplates[state.templateIndex];
 }
-function tildeify(dir) {
-    const normalizedDir = dir.replace(/\\/g, "/");
-    const normalizedHome = homedir().replace(/\\/g, "/");
-    if (normalizedDir === normalizedHome) {
-        return "~";
-    }
-    if (normalizedDir.startsWith(`${normalizedHome}/`)) {
-        return `~${normalizedDir.slice(normalizedHome.length)}`;
-    }
-    return normalizedDir;
-}
 function buildOriginOpts(state) {
     const isBuiltin = state.templateIndex < flowBuiltinCount;
     return {
@@ -243,42 +214,7 @@ export function render(state, out) {
     const lines = [];
     const pad = (s) => padToWidth(s, cols);
     // Header
-    const title = `  ${bold}${cyan}poly-weaver v${APP_VERSION}${reset}`;
-    if (state.gitInfo) {
-        const animal = branchAnimalEmoji(state.gitInfo.branch);
-        const wt = state.gitInfo.isWorktree ? " 🌲" : "";
-        const gitSeg = `${animal} ${state.gitInfo.branch}${wt}`;
-        const titleVisible = visibleLength(title);
-        const gitSegVisible = visibleLength(gitSeg);
-        if (titleVisible + 2 + gitSegVisible <= cols - 2) {
-            lines.push(pad(`${title}  ${dim}${gitSeg}${reset}`));
-        }
-        else {
-            const maxBranch = cols - titleVisible - visibleLength(`${animal} ${wt}`) - 4;
-            if (maxBranch >= 4) {
-                const truncated = state.gitInfo.branch.slice(0, maxBranch - 1) + "…";
-                const truncSeg = `${animal} ${truncated}${wt}`;
-                lines.push(pad(`${title}  ${dim}${truncSeg}${reset}`));
-            }
-            else {
-                lines.push(pad(title));
-            }
-        }
-    }
-    else {
-        lines.push(pad(title));
-    }
-    // Update notification banner (between title and separator)
-    if (shouldShowBanner(state, cols)) {
-        const { current, latest } = state.updateBanner;
-        const bannerText = `  ${dim}Update available:${reset} ` +
-            `${yellow}v${current}${reset} ` +
-            `${dim}\u2192${reset} ` +
-            `${green}v${latest}${reset}  ` +
-            `${dim}Run:${reset} ${cyan}npm i -g poly-weaver${reset}`;
-        lines.push(pad(bannerText));
-    }
-    lines.push(pad(`  ${"━".repeat(Math.max(0, cols - 4))}`));
+    lines.push(...renderAppHeader(cols, state.gitInfo, state.updateBanner));
     // Config panel (shared)
     lines.push(...renderConfigFields(state.fields, state.configIndex, state.zone === "config", cols));
     // Flow diagram section (shared)
@@ -492,11 +428,11 @@ export async function showStartupTui(defaults) {
 }
 async function inputLoop(state, workdir) {
     const parser = new TuiInputParser();
-    process.stdin.setRawMode(true);
-    process.stdin.resume();
+    const source = createKeyEventSource();
+    source.start();
     return new Promise((resolve) => {
-        parser.onDeferredEvents((events) => {
-            for (const event of events) {
+        const unsubscribe = source.onEvents((keys) => {
+            for (const event of parser.mapKeys(keys)) {
                 const result = handleEvent(state, event);
                 if (result === "start") {
                     cleanup();
@@ -511,23 +447,6 @@ async function inputLoop(state, workdir) {
             }
             render(state, process.stdout);
         });
-        const onData = (chunk) => {
-            for (const event of parser.parseChunk(chunk)) {
-                const result = handleEvent(state, event);
-                if (result === "start") {
-                    cleanup();
-                    resolve(buildCliOptions(state, workdir));
-                    return;
-                }
-                else if (result === "cancel") {
-                    cleanup();
-                    resolve(null);
-                    return;
-                }
-            }
-            render(state, process.stdout);
-        };
-        process.stdin.on("data", onData);
         const onResize = () => {
             state.termRows = process.stdout.rows ?? 24;
             state.termCols = process.stdout.columns ?? 80;
@@ -536,11 +455,9 @@ async function inputLoop(state, workdir) {
         };
         process.stdout.on("resize", onResize);
         function cleanup() {
-            parser.cancelPendingEscape();
-            process.stdin.removeListener("data", onData);
+            unsubscribe();
+            source.stop();
             process.stdout.removeListener("resize", onResize);
-            process.stdin.setRawMode(false);
-            process.stdin.resume();
         }
     });
 }