agent-bober 0.17.1 → 0.18.0

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

@@ -0,0 +1,129 @@
+import * as readline from "node:readline";
+import type { LLMClient } from "../providers/types.js";
+import { RunSpawner } from "./run-spawner.js";
+import { CompletionTailer } from "./completion-tailer.js";
+import { ApprovalReader } from "./approval-reader.js";
+export interface ChatSessionOptions {
+    llm: LLMClient;
+    projectRoot: string;
+    sessionId?: string;
+    /** Override readline interface for testing (omit to use stdin/stdout). */
+    rl?: readline.Interface;
+    /** Injected RunSpawner for testing (omit to use a real instance). */
+    spawner?: RunSpawner;
+    /** Injected clock for deterministic runId generation in tests. */
+    now?: () => number;
+    /** Injected CompletionTailer for testing (omit to use a real instance). */
+    tailer?: CompletionTailer;
+    /** Injected ApprovalReader for testing (omit to use a real instance). */
+    approvalReader?: ApprovalReader;
+    /**
+     * Memory namespace for the active team. Omit (or pass "") for the default
+     * programming team, which resolves to the current .bober/memory/ path.
+     * Sprint 2: threaded through buildMemoryDistill so a named team reads its own subdir.
+     */
+    memoryNamespace?: string;
+}
+export declare class ChatSession {
+    private readonly llm;
+    private readonly projectRoot;
+    private readonly sessionId;
+    private readonly store;
+    private readonly roster;
+    private readonly classifier;
+    private readonly answerer;
+    private readonly spawner;
+    private readonly tailer;
+    private readonly approvalReader;
+    private readonly approvalCursor;
+    private readonly nowFn;
+    private readonly model;
+    /** Memory namespace for the active team; undefined means the default .bober/memory/ path. */
+    private readonly memoryNamespace;
+    /** Phase 2: persists the per-session careful-mode toggle. */
+    private readonly carefulSidecar;
+    constructor(opts: ChatSessionOptions);
+    /** Generate a session-scoped runId using the injected clock. */
+    private nextRunId;
+    /**
+     * Handle a single turn: slash-dispatch or classify→answer→persist.
+     * Returns the assistant reply string, or null for /exit.
+     */
+    handleTurn(input: string): Promise<string | null>;
+    /**
+     * Stop a run by resolving it against the current disk roster, then calling
+     * RunSpawner.stop. Shared by /stop <runId> (deterministic slash path) and
+     * classifier steer:stop (natural-language path). Never reaches the LLM.
+     */
+    private handleStop;
+    /**
+     * Handle /careful [on|off].
+     * - "on"  → set careful true, return confirmation
+     * - "off" → set careful false, return confirmation
+     * - undefined/other → report current state
+     */
+    private handleCareful;
+    /**
+     * Approve a pending checkpoint: guard with pendingExists, write the marker,
+     * clear the correlated RunState pending fields, and return an ack string.
+     * Returns a "no pending checkpoint" message and writes nothing if the pending
+     * file does not exist (sc-3-4).
+     */
+    private handleApprove;
+    /**
+     * Reject a pending checkpoint: guard with pendingExists, write the marker
+     * carrying the feedback string, clear the correlated RunState, and return ack.
+     * Returns a "no pending checkpoint" message and writes nothing if absent (sc-3-4).
+     */
+    private handleReject;
+    /**
+     * Queue free-text guidance for a run at the next pipeline boundary.
+     * Shared by /tell <runId> <text> (deterministic slash path) and
+     * classifier tell (natural-language path). Never reaches the LLM.
+     *
+     * Guards: unknown run (not in roster) → clear error, writes nothing.
+     * Path-traversal: appendGuidance validates runId via safeSegment first.
+     * Does NOT require careful mode; guidance can be queued for any known run.
+     */
+    private handleTell;
+    /**
+     * Soft-pause a run at the next checkpoint boundary.
+     *
+     * Distinct from handleStop: this does NOT send a kill signal — the process
+     * stays alive and will hold at the next cooperative-pause gate in the pipeline.
+     *
+     * Guards: run must be found in the roster with status "running".
+     * Side effects: writes paused.json marker + flips chat-owned RunState to
+     * 'paused' (with pausedAt timestamp) via writeRunState.
+     */
+    private handlePause;
+    /**
+     * Resume a soft-paused run.
+     *
+     * Clears the paused.json marker (best-effort) and flips RunState back
+     * to 'running' (dropping the pausedAt field). The pipeline's cooperative
+     * gate polls isPaused, so removing the marker allows the gate to advance.
+     */
+    private handleResume;
+    /**
+     * Clear pending fields from the RunState correlated to this checkpoint.
+     * Inverse of the Sprint 2 reflection block: finds the input-required RunState
+     * matching this checkpointId, drops the three pending fields, and sets
+     * status back to "running". Idempotent — no-op if no correlated state exists.
+     */
+    private clearPending;
+    /**
+     * Resolve a checkpoint id for NL approve/reject paths.
+     * - If an id is provided, use it directly.
+     * - If exactly one pending marker exists, use it.
+     * - If zero or multiple pending markers exist (without a named id), return
+     *   an ambiguous result so the caller can ask the user instead of guessing.
+     */
+    private resolveCheckpoint;
+    /**
+     * Start an interactive REPL loop reading from stdin.
+     * Use handleTurn() directly in tests instead.
+     */
+    start(): Promise<void>;
+}
+//# sourceMappingURL=chat-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session.d.ts","sourceRoot":"","sources":["../../src/chat/chat-session.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiBtD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,SAAS,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,EAAE,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC;IACxB,qEAAqE;IACrE,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,yEAAyE;IACzE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA+BD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAEpC,IAAI,EAAE,kBAAkB;IAyBpC,gEAAgE;IAChE,OAAO,CAAC,SAAS;IAIjB;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgKvD;;;;OAIG;YACW,UAAU;IAYxB;;;;;OAKG;YACW,aAAa;IAa3B;;;;;OAKG;YACW,aAAa;IAa3B;;;;OAIG;YACW,YAAY;IAc1B;;;;;;;;OAQG;YACW,UAAU;IAexB;;;;;;;;;OASG;YACW,WAAW;IAazB;;;;;;OAMG;YACW,YAAY;IAa1B;;;;;OAKG;YACW,YAAY;IAe1B;;;;;;OAMG;YACW,iBAAiB;IAgB/B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAyC7B"}

package/dist/chat/chat-session.js

@@ -0,0 +1,470 @@
+// ── chat-session.ts ───────────────────────────────────────────────────
+//
+// ChatSession: the main turn loop for `bober chat`.
+// Per turn: classify → answer (or slash-dispatch) → persist.
+import * as readline from "node:readline";
+import { loadLessonIndex, loadLesson } from "../state/memory.js";
+import { ConversationStore } from "./conversation-store.js";
+import { RosterReader } from "./roster-reader.js";
+import { TurnClassifier } from "./turn-classifier.js";
+import { Answerer } from "./answerer.js";
+import { dispatch } from "./slash-commands.js";
+import { RunSpawner } from "./run-spawner.js";
+import { CarefulSidecar } from "./careful-sidecar.js";
+import { CompletionTailer } from "./completion-tailer.js";
+import { ApprovalReader } from "./approval-reader.js";
+import { ApprovalCursor } from "./approval-cursor.js";
+import { writeRunState } from "../state/run-state.js";
+import { saveApproved, saveRejected, pendingExists, } from "../state/approval-state.js";
+import { appendGuidance, hasRunDir } from "../state/guidance.js";
+import { setPaused, clearPaused } from "../state/pause.js";
+import { resolveApprover } from "../cli/commands/approve.js";
+import { cleanupTerminalRun } from "./steer-cleanup.js";
+import { seedProjectFacts } from "../orchestrator/memory/fact-detector.js";
+// ── Memory distill helper ─────────────────────────────────────────────
+/**
+ * Compose a compact memory distill string from the team's namespaced .bober/memory/ path.
+ * Returns empty string if no lessons are recorded.
+ * namespace undefined or "" reads the default .bober/memory/ path (programming team / back-compat).
+ */
+async function buildMemoryDistill(projectRoot, namespace) {
+    try {
+        const index = await loadLessonIndex(projectRoot, { limit: 10 }, namespace);
+        if (index.length === 0)
+            return "";
+        const lines = ["Recent lessons learned:"];
+        for (const record of index) {
+            try {
+                const lesson = await loadLesson(projectRoot, record.lessonId, namespace);
+                lines.push(`- [${lesson.severity}] ${lesson.summary}`);
+            }
+            catch {
+                lines.push(`- ${record.summarySnippet}`);
+            }
+        }
+        return lines.join("\n");
+    }
+    catch {
+        return "";
+    }
+}
+// ── ChatSession ───────────────────────────────────────────────────────
+export class ChatSession {
+    llm;
+    projectRoot;
+    sessionId;
+    store;
+    roster;
+    classifier;
+    answerer;
+    spawner;
+    tailer;
+    approvalReader;
+    approvalCursor;
+    nowFn;
+    // bober: using "opus" as default model; the CLI wires in config.chat?.model via createClient
+    model = "opus";
+    /** Memory namespace for the active team; undefined means the default .bober/memory/ path. */
+    memoryNamespace;
+    /** Phase 2: persists the per-session careful-mode toggle. */
+    carefulSidecar;
+    constructor(opts) {
+        this.llm = opts.llm;
+        this.projectRoot = opts.projectRoot;
+        this.sessionId = opts.sessionId ?? "default";
+        this.memoryNamespace = opts.memoryNamespace || undefined;
+        this.store = new ConversationStore(this.projectRoot, this.sessionId);
+        this.roster = new RosterReader(this.projectRoot);
+        this.classifier = new TurnClassifier(this.llm, this.model);
+        this.answerer = new Answerer(this.llm, this.model);
+        this.nowFn = opts.now ?? (() => Date.now());
+        this.spawner =
+            opts.spawner ??
+                new RunSpawner({
+                    projectRoot: this.projectRoot,
+                    sessionId: this.sessionId,
+                });
+        this.tailer =
+            opts.tailer ??
+                new CompletionTailer(this.projectRoot, this.sessionId);
+        this.approvalReader =
+            opts.approvalReader ?? new ApprovalReader(this.projectRoot);
+        this.approvalCursor = new ApprovalCursor(this.projectRoot, this.sessionId);
+        this.carefulSidecar = new CarefulSidecar(this.projectRoot, this.sessionId);
+    }
+    /** Generate a session-scoped runId using the injected clock. */
+    nextRunId() {
+        return `run-${this.nowFn()}`;
+    }
+    /**
+     * Handle a single turn: slash-dispatch or classify→answer→persist.
+     * Returns the assistant reply string, or null for /exit.
+     */
+    async handleTurn(input) {
+        // ── Poll for run completions (prelude — runs before slash or LLM path) ─
+        let completions = [];
+        try {
+            completions = await this.tailer.poll();
+        }
+        catch {
+            // Poll errors must never break the turn
+        }
+        // ── Cleanup hygiene for runs that just went terminal (Sprint 6) ────────
+        for (const c of completions) {
+            if (c.runId) {
+                try {
+                    await cleanupTerminalRun(this.projectRoot, c.runId);
+                }
+                catch {
+                    // best-effort — a cleanup failure must never break the turn
+                }
+            }
+        }
+        // ── Poll for pending approvals (prelude) ──────────────────────────────
+        let approvalNotice = "";
+        try {
+            const pending = await this.approvalReader.read();
+            if (pending.length > 0) {
+                const fresh = await this.approvalCursor.filterNew(pending);
+                if (fresh.length > 0) {
+                    // Reflect correlated markers onto running RunStates (idempotent)
+                    const states = await this.roster.read();
+                    for (const m of fresh) {
+                        if (m.runId) {
+                            const state = states.find((s) => s.runId === m.runId && s.status === "running");
+                            if (state) {
+                                await writeRunState(this.projectRoot, {
+                                    ...state,
+                                    status: "input-required",
+                                    pendingCheckpointId: m.checkpointId,
+                                    pendingPrompt: m.prompt,
+                                    pendingSince: m.requestedAt,
+                                });
+                            }
+                        }
+                    }
+                    // Build the notice string
+                    const notices = fresh
+                        .map((m) => `[run ${m.runId ?? "unknown"} waiting at ${m.checkpointId}: ${m.prompt}]`)
+                        .join("\n");
+                    approvalNotice = notices;
+                }
+            }
+        }
+        catch {
+            // Approval read errors must never break the turn
+        }
+        // ── Slash commands (deterministic, no LLM) ─────────────────────────
+        const slashResult = await dispatch(input, this.roster, (runId) => this.handleStop(runId), (arg) => this.handleCareful(arg), (id) => this.handleApprove(id), (id, fb) => this.handleReject(id, fb), (runId, text) => this.handleTell(runId, text), (runId) => this.handlePause(runId), (runId) => this.handleResume(runId));
+        if (slashResult.handled) {
+            if (slashResult.exit)
+                return null;
+            let output = slashResult.output ?? "";
+            // Weave completion notices into slash-command reply as well
+            if (completions.length > 0) {
+                const notices = completions
+                    .map((c) => `[run ${c.runId ?? "unknown"} finished: ${c.phase}]`)
+                    .join("\n");
+                output = `${notices}\n\n${output}`;
+            }
+            // Weave approval notices into slash-command reply
+            if (approvalNotice) {
+                output = `${approvalNotice}\n\n${output}`;
+            }
+            // Persist slash command turns for transparency
+            await this.store.append({ role: "user", content: input, ts: new Date().toISOString() });
+            await this.store.append({ role: "assistant", content: output, ts: new Date().toISOString() });
+            return output;
+        }
+        // ── LLM path: read context ────────────────────────────────────────
+        const [states, memoryDistill, recentHistory] = await Promise.all([
+            this.roster.read(),
+            buildMemoryDistill(this.projectRoot, this.memoryNamespace),
+            this.store.loadRecent(20),
+        ]);
+        const rosterSummary = this.roster.summarize(states);
+        // ── Classify ──────────────────────────────────────────────────────
+        const action = await this.classifier.classify(input);
+        let reply;
+        if (action.action === "answer") {
+            reply = await this.answerer.answer(input, rosterSummary, memoryDistill, recentHistory);
+        }
+        else if (action.action === "spawn") {
+            const runId = this.nextRunId();
+            const careful = await this.carefulSidecar.isCareful();
+            const ack = await this.spawner.spawn(action.task, runId, { careful });
+            reply = ack.spawnError
+                ? `Failed to launch run ${runId}: ${ack.spawnError}`
+                : `Launched run ${runId} for: ${action.task}. Use /runs to track it.`;
+        }
+        else if (action.action === "steer") {
+            if (action.op === "inspect") {
+                reply = this.roster.summarize(states);
+            }
+            else {
+                // op === "stop", action.runId: string
+                reply = await this.handleStop(action.runId);
+            }
+        }
+        else if (action.action === "approve" || action.action === "reject") {
+            const target = await this.resolveCheckpoint(action.checkpointId);
+            if (target.kind === "ambiguous") {
+                reply = target.message;
+            }
+            else if (action.action === "approve") {
+                reply = await this.handleApprove(target.id);
+            }
+            else {
+                reply = await this.handleReject(target.id, action.feedback ?? "");
+            }
+        }
+        else if (action.action === "tell") {
+            reply = await this.handleTell(action.runId, action.text);
+        }
+        else if (action.action === "pause") {
+            reply = await this.handlePause(action.runId);
+        }
+        else if (action.action === "resume") {
+            reply = await this.handleResume(action.runId);
+        }
+        else {
+            // Unknown action — should not happen given the classifier union
+            reply = `Unrecognised action. For now, try /help for available commands.`;
+        }
+        // ── Weave completion notices ───────────────────────────────────────
+        if (completions.length > 0) {
+            const notices = completions
+                .map((c) => `[run ${c.runId ?? "unknown"} finished: ${c.phase}]`)
+                .join("\n");
+            reply = `${notices}\n\n${reply}`;
+        }
+        // Weave approval notices into LLM reply
+        if (approvalNotice) {
+            reply = `${approvalNotice}\n\n${reply}`;
+        }
+        // ── Persist ───────────────────────────────────────────────────────
+        const now = new Date().toISOString();
+        await this.store.append({ role: "user", content: input, ts: now });
+        await this.store.append({ role: "assistant", content: reply, ts: now });
+        return reply;
+    }
+    /**
+     * Stop a run by resolving it against the current disk roster, then calling
+     * RunSpawner.stop. Shared by /stop <runId> (deterministic slash path) and
+     * classifier steer:stop (natural-language path). Never reaches the LLM.
+     */
+    async handleStop(runId) {
+        // Resolve against disk roster at stop-time (sc-4-7 — not from spawn-time memory)
+        const states = await this.roster.read();
+        const target = states.find((s) => s.runId === runId && s.status === "running");
+        if (!target)
+            return `No such running run: ${runId}`;
+        const result = await this.spawner.stop(runId, "Stopped via chat");
+        return result.killedPid !== undefined
+            ? `Stopped run ${runId} (killed pid ${result.killedPid}).`
+            : `Stopped run ${runId} (no live process found; marked aborted).`;
+    }
+    /**
+     * Handle /careful [on|off].
+     * - "on"  → set careful true, return confirmation
+     * - "off" → set careful false, return confirmation
+     * - undefined/other → report current state
+     */
+    async handleCareful(arg) {
+        if (arg === "on") {
+            await this.carefulSidecar.setCareful(true);
+            return "Careful mode ON — new runs will pause at curated gates.";
+        }
+        else if (arg === "off") {
+            await this.carefulSidecar.setCareful(false);
+            return "Careful mode OFF — new runs will run in autopilot.";
+        }
+        else {
+            const current = await this.carefulSidecar.isCareful();
+            return `Careful mode is currently ${current ? "ON" : "OFF"}. Use /careful on or /careful off to toggle.`;
+        }
+    }
+    /**
+     * Approve a pending checkpoint: guard with pendingExists, write the marker,
+     * clear the correlated RunState pending fields, and return an ack string.
+     * Returns a "no pending checkpoint" message and writes nothing if the pending
+     * file does not exist (sc-3-4).
+     */
+    async handleApprove(checkpointId) {
+        if (!(await pendingExists(this.projectRoot, checkpointId))) {
+            return `No pending checkpoint found: ${checkpointId}`;
+        }
+        const marker = {
+            approvedAt: new Date().toISOString(),
+            approverId: resolveApprover(),
+        };
+        await saveApproved(this.projectRoot, checkpointId, marker);
+        await this.clearPending(checkpointId);
+        return `Approved checkpoint ${checkpointId}. The run will resume.`;
+    }
+    /**
+     * Reject a pending checkpoint: guard with pendingExists, write the marker
+     * carrying the feedback string, clear the correlated RunState, and return ack.
+     * Returns a "no pending checkpoint" message and writes nothing if absent (sc-3-4).
+     */
+    async handleReject(checkpointId, feedback) {
+        if (!(await pendingExists(this.projectRoot, checkpointId))) {
+            return `No pending checkpoint found: ${checkpointId}`;
+        }
+        const marker = {
+            rejectedAt: new Date().toISOString(),
+            rejecterId: resolveApprover(),
+            feedback,
+        };
+        await saveRejected(this.projectRoot, checkpointId, marker);
+        await this.clearPending(checkpointId);
+        return `Rejected checkpoint ${checkpointId}. Feedback sent for rework.`;
+    }
+    /**
+     * Queue free-text guidance for a run at the next pipeline boundary.
+     * Shared by /tell <runId> <text> (deterministic slash path) and
+     * classifier tell (natural-language path). Never reaches the LLM.
+     *
+     * Guards: unknown run (not in roster) → clear error, writes nothing.
+     * Path-traversal: appendGuidance validates runId via safeSegment first.
+     * Does NOT require careful mode; guidance can be queued for any known run.
+     */
+    async handleTell(runId, text) {
+        // Guard: check run exists in the roster (any status — not just running)
+        const exists = await hasRunDir(this.projectRoot, runId);
+        if (!exists) {
+            return `No such run: ${runId}`;
+        }
+        try {
+            await appendGuidance(this.projectRoot, runId, text);
+        }
+        catch (err) {
+            // Surface path-traversal or other appendGuidance errors clearly
+            return `Failed to queue guidance: ${err instanceof Error ? err.message : String(err)}`;
+        }
+        return `Queued guidance for run ${runId}.`;
+    }
+    /**
+     * Soft-pause a run at the next checkpoint boundary.
+     *
+     * Distinct from handleStop: this does NOT send a kill signal — the process
+     * stays alive and will hold at the next cooperative-pause gate in the pipeline.
+     *
+     * Guards: run must be found in the roster with status "running".
+     * Side effects: writes paused.json marker + flips chat-owned RunState to
+     * 'paused' (with pausedAt timestamp) via writeRunState.
+     */
+    async handlePause(runId) {
+        const states = await this.roster.read();
+        const target = states.find((s) => s.runId === runId && s.status === "running");
+        if (!target)
+            return `No such running run: ${runId}`;
+        await setPaused(this.projectRoot, runId);
+        await writeRunState(this.projectRoot, {
+            ...target,
+            status: "paused",
+            pausedAt: new Date().toISOString(),
+        });
+        return `Paused run ${runId} at the next boundary — the process stays alive (use /resume ${runId} to continue). This is NOT /stop.`;
+    }
+    /**
+     * Resume a soft-paused run.
+     *
+     * Clears the paused.json marker (best-effort) and flips RunState back
+     * to 'running' (dropping the pausedAt field). The pipeline's cooperative
+     * gate polls isPaused, so removing the marker allows the gate to advance.
+     */
+    async handleResume(runId) {
+        await clearPaused(this.projectRoot, runId);
+        const states = await this.roster.read();
+        const target = states.find((s) => s.runId === runId && s.status === "paused");
+        if (target) {
+            // Destructure out pausedAt so it is NOT serialized back to disk.
+            const { pausedAt, ...rest } = target;
+            void pausedAt;
+            await writeRunState(this.projectRoot, { ...rest, status: "running" });
+        }
+        return `Resumed run ${runId}.`;
+    }
+    /**
+     * Clear pending fields from the RunState correlated to this checkpoint.
+     * Inverse of the Sprint 2 reflection block: finds the input-required RunState
+     * matching this checkpointId, drops the three pending fields, and sets
+     * status back to "running". Idempotent — no-op if no correlated state exists.
+     */
+    async clearPending(checkpointId) {
+        const states = await this.roster.read();
+        const state = states.find((s) => s.status === "input-required" && s.pendingCheckpointId === checkpointId);
+        if (!state)
+            return;
+        // Destructure out the optional pending fields so they are NOT serialized.
+        const { pendingCheckpointId, pendingPrompt, pendingSince, ...rest } = state;
+        // Suppress unused-variable warnings — these are intentionally destructured out.
+        void pendingCheckpointId;
+        void pendingPrompt;
+        void pendingSince;
+        await writeRunState(this.projectRoot, { ...rest, status: "running" });
+    }
+    /**
+     * Resolve a checkpoint id for NL approve/reject paths.
+     * - If an id is provided, use it directly.
+     * - If exactly one pending marker exists, use it.
+     * - If zero or multiple pending markers exist (without a named id), return
+     *   an ambiguous result so the caller can ask the user instead of guessing.
+     */
+    async resolveCheckpoint(id) {
+        if (id)
+            return { kind: "id", id };
+        const pending = await this.approvalReader.read();
+        if (pending.length === 1)
+            return { kind: "id", id: pending[0].checkpointId };
+        if (pending.length === 0) {
+            return { kind: "ambiguous", message: "No pending checkpoints to act on." };
+        }
+        const ids = pending.map((p) => p.checkpointId).join(", ");
+        return {
+            kind: "ambiguous",
+            message: `Multiple pending checkpoints — which one? ${ids}`,
+        };
+    }
+    /**
+     * Start an interactive REPL loop reading from stdin.
+     * Use handleTurn() directly in tests instead.
+     */
+    async start() {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: false,
+        });
+        process.stdout.write("bober chat — type a question, /help for commands, /exit to quit\n> ");
+        // ── Sprint 5: seed project facts at chat startup (best-effort) ──
+        // A facts failure must NEVER break chat startup.
+        try {
+            await seedProjectFacts(this.projectRoot, this.memoryNamespace);
+        }
+        catch {
+            // Swallow silently — facts failure must never abort chat
+        }
+        for await (const line of rl) {
+            const input = line.trim();
+            if (!input) {
+                process.stdout.write("> ");
+                continue;
+            }
+            try {
+                const reply = await this.handleTurn(input);
+                if (reply === null) {
+                    process.stdout.write("Goodbye.\n");
+                    rl.close();
+                    return;
+                }
+                process.stdout.write(`${reply}\n> `);
+            }
+            catch (err) {
+                process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n> `);
+            }
+        }
+    }
+}
+//# sourceMappingURL=chat-session.js.map

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

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

package/dist/chat/completion-tailer.d.ts

@@ -0,0 +1,27 @@
+export interface CompletionEvent {
+    runId?: string;
+    phase: "complete" | "failed";
+    completed: number;
+    failed: number;
+    durationMs: number;
+    timestamp: string;
+}
+export declare class CompletionTailer {
+    private readonly projectRoot;
+    private readonly store;
+    constructor(projectRoot: string, sessionId: string);
+    /**
+     * Poll .bober/history.jsonl for new pipeline-complete events since the last
+     * persisted byte cursor. Returns only newly-seen completions.
+     *
+     * Algorithm:
+     * 1. stat the file; ENOENT → return [].
+     * 2. If stat.size < cursor (rotation/shrink) → readFrom = 0.
+     * 3. Read bytes [readFrom, EOF) via Buffer slice.
+     * 4. Parse complete lines only (skip partial trailing line).
+     * 5. Filter for event === "pipeline-complete"; extract runId via marker.
+     * 6. Dedupe against seenRunIds; persist updated cursor + seenRunIds.
+     */
+    poll(): Promise<CompletionEvent[]>;
+}
+//# sourceMappingURL=completion-tailer.d.ts.map

package/dist/chat/completion-tailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-tailer.d.ts","sourceRoot":"","sources":["../../src/chat/completion-tailer.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAoED,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAH9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAGjB,WAAW,EAAE,MAAM,EACpC,SAAS,EAAE,MAAM;IAKnB;;;;;;;;;;;OAWG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CA0GzC"}