agent-bober 0.17.1 → 0.19.0

package/dist/chat/careful-sidecar.js

@@ -0,0 +1,39 @@
+// ── careful-sidecar.ts ─────────────────────────────────────────────────
+//
+// Persists the per-session "careful mode" toggle at
+// .bober/chat/<sessionId>.careful.json. Default off → autopilot (Phase 1).
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ensureDir } from "../utils/fs.js";
+// ── CarefulSidecar ────────────────────────────────────────────────────
+export class CarefulSidecar {
+    projectRoot;
+    sessionId;
+    constructor(projectRoot, sessionId) {
+        this.projectRoot = projectRoot;
+        this.sessionId = sessionId;
+    }
+    path() {
+        return join(this.projectRoot, ".bober", "chat", `${this.sessionId}.careful.json`);
+    }
+    /**
+     * Read the careful flag. Missing/malformed file => false (autopilot). Never throws.
+     */
+    async isCareful() {
+        try {
+            const data = JSON.parse(await readFile(this.path(), "utf-8"));
+            return data.careful === true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Persist the careful flag atomically.
+     */
+    async setCareful(on) {
+        await ensureDir(join(this.projectRoot, ".bober", "chat"));
+        await writeFile(this.path(), JSON.stringify({ careful: on }, null, 2) + "\n", { encoding: "utf-8", mode: 0o600 });
+    }
+}
+//# sourceMappingURL=careful-sidecar.js.map

package/dist/chat/careful-sidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"careful-sidecar.js","sourceRoot":"","sources":["../../src/chat/careful-sidecar.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,oDAAoD;AACpD,2EAA2E;AAE3E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,yEAAyE;AAEzE,MAAM,OAAO,cAAc;IAEN;IACA;IAFnB,YACmB,WAAmB,EACnB,SAAiB;QADjB,gBAAW,GAAX,WAAW,CAAQ;QACnB,cAAS,GAAT,SAAS,CAAQ;IACjC,CAAC;IAEI,IAAI;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,eAAe,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAA0B,CAAC;YACvF,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,EAAW;QAC1B,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1D,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,EAAE,EACX,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAC/C,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CACnC,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,156 @@
+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;
+    /**
+     * Capture a plain task statement as an open action Finding in the hub pool.
+     * Reuses captureTask (sprint 1) — the single write path; never re-implements it.
+     * `now` is stamped here at the chat handler boundary (the only permitted
+     * new Date() per principles); captureTask/the store stay clock-free.
+     * Never throws: a persistence failure becomes an error reply, not an exception.
+     */
+    private handleCaptureTask;
+    /**
+     * Handle /priority in a hub chat session.
+     *
+     * Gated on this.memoryNamespace === "hub" — returns an informative no-op
+     * string for any other team without calling this.llm.
+     */
+    private handleHubPriority;
+    /**
+     * Handle /decide <X> vs <Y> in a hub chat session.
+     *
+     * Gated on this.memoryNamespace === "hub" — returns an informative no-op
+     * string for any other team without calling this.llm.
+     */
+    private handleHubDecide;
+    /**
+     * Collect sibling findings, rank via the hub judge, best-effort write priority.md,
+     * and return a ranked summary string ("rank. title" per line).
+     */
+    private rankAndRenderHub;
+    /**
+     * 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;AA6BtD,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;IAoKvD;;;;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;;;;;;OAMG;YACW,iBAAiB;IAsB/B;;;;;OAKG;YACW,iBAAiB;IAQ/B;;;;;OAKG;YACW,eAAe;IAgB7B;;;OAGG;YACW,gBAAgB;IAkB9B;;;;;OAKG;YACW,YAAY;IAe1B;;;;;;OAMG;YACW,iBAAiB;IAgB/B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAyC7B"}