@openrig/cli 0.2.0 → 0.3.0

package/daemon/dist/domain/steering/steering-composer.d.ts

@@ -0,0 +1,102 @@
+export interface SteeringComposerOpts {
+    /** Workspace root (e.g., the openrig-work substrate dir). Optional
+     *  per-piece overrides (steeringPath / roadmapPath / deliveryReadyDir)
+     *  trump the workspace-root-derived defaults. */
+    workspaceRoot: string | null;
+    steeringPath?: string | null;
+    roadmapPath?: string | null;
+    deliveryReadyDir?: string | null;
+    /** Per-lane top-N items to surface; default 3 (PRD § Item 1D). */
+    topNPerLane?: number;
+}
+export interface PriorityStackPayload {
+    /** Verbatim STEERING.md content. UI renders via the v0 MarkdownViewer
+     *  for consistency with the Files browser. */
+    content: string;
+    absolutePath: string;
+    mtime: string;
+    byteCount: number;
+}
+export interface RoadmapRailItem {
+    line: number;
+    text: string;
+    done: boolean;
+    /** Detected PL-XXX rail-item code if present (e.g., "PL-019"). */
+    railItemCode: string | null;
+    /** True for the first unchecked item on the rail (UI marks visually). */
+    isNextUnchecked: boolean;
+}
+export interface RoadmapRailPayload {
+    absolutePath: string;
+    mtime: string;
+    items: RoadmapRailItem[];
+    /** Total checkbox rows / done / next-unchecked-line for header. */
+    counts: {
+        total: number;
+        done: number;
+        nextUncheckedLine: number | null;
+    };
+}
+export interface LaneRailItem {
+    line: number;
+    text: string;
+    status: "active" | "done" | "blocked" | "unknown";
+    /** True when this is the lane's "next pull" per the Priority Rail
+     *  Rule: first non-done, non-blocked checkbox row on the lane. */
+    isNextPull: boolean;
+}
+export interface LaneRailPayload {
+    /** "mode-0" / "mode-1" / etc. — derived from the file's parent dir. */
+    laneId: string;
+    absolutePath: string;
+    mtime: string;
+    /** Top-N items shown on the steering panel (active/blocked first;
+     *  done items only filling remainder). */
+    topItems: LaneRailItem[];
+    /** Lane-health aggregate counts across ALL rows in the file. */
+    healthBadges: {
+        active: number;
+        blocked: number;
+        done: number;
+        total: number;
+    };
+    /** Convenience: line number of the lane's next-pull row, null if none. */
+    nextPullLine: number | null;
+}
+export interface SteeringPayload {
+    priorityStack: PriorityStackPayload | null;
+    roadmapRail: RoadmapRailPayload | null;
+    laneRails: LaneRailPayload[];
+    /** Surface-level diagnostics for the UI to render setup hints when
+     *  individual sources are missing. Each entry names the env var that
+     *  would resolve it. */
+    unavailableSources: Array<{
+        section: string;
+        reason: string;
+        envVar?: string;
+    }>;
+}
+export declare function steeringOptsFromEnv(env?: NodeJS.ProcessEnv): SteeringComposerOpts;
+export interface SteeringSettingsDefaults {
+    workspaceRoot: string;
+    workspaceSteeringPath: string;
+}
+export declare function steeringOptsFromSettings(settings: SteeringSettingsDefaults, env?: NodeJS.ProcessEnv): SteeringComposerOpts;
+export declare class SteeringComposer {
+    private readonly opts;
+    constructor(opts: SteeringComposerOpts);
+    /** True when at least one source is resolvable. Routes use this to
+     *  decide between 200 (with possibly-empty unavailableSources) and
+     *  503 (no sources at all). */
+    isReady(): boolean;
+    compose(): SteeringPayload;
+    private composePriorityStack;
+    private composeRoadmapRail;
+    private composeLaneRails;
+    private composeLaneFromFile;
+    private resolveSteeringPath;
+    private resolveRoadmapPath;
+    private resolveDeliveryReadyDir;
+}
+export declare function matchRailItemCode(text: string): string | null;
+//# sourceMappingURL=steering-composer.d.ts.map

package/daemon/dist/domain/steering/steering-composer.d.ts.map

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

package/daemon/dist/domain/steering/steering-composer.js

@@ -0,0 +1,263 @@
+// Operator Surface Reconciliation v0 — steering composer.
+//
+// Item 1 (HEADLINE): one-screen composed steering surface. Daemon-side
+// composer reads four filesystem sources and returns a payload the UI
+// renders across the priority-stack / roadmap-rail / lane-rails panels.
+//
+// Why this composer and NOT a full daemon orchestration of Mission
+// Control + agentActivity + everything: the steering UI fetches PL-005
+// queue views (in-motion / loop-state) and health summaries via their
+// own existing endpoints, so the composer stays narrow + testable. The
+// composer is responsible only for the filesystem-derived pieces:
+//   - STEERING.md priority stack (verbatim render upstream)
+//   - roadmap PROGRESS.md (PL-XXX checklist + next-unchecked marker)
+//   - delivery-ready/mode-{0..3}/PROGRESS.md (per-lane top-N + health
+//     badges + next-pull marker per Priority Rail Rule semantics)
+//
+// Configuration: per the env-var-pivot pattern from UI Enhancement
+// Pack v0 (ConfigStore's strict VALID_KEYS won't admit dynamic family
+// keys cleanly), the steering composer reads a single workspace root
+// from OPENRIG_STEERING_WORKSPACE. Everything else derives relative to
+// that root: STEERING.md, roadmap/PROGRESS.md, delivery-ready/mode-*/
+// PROGRESS.md. Operator-overridable via OPENRIG_STEERING_PATH /
+// OPENRIG_ROADMAP_PATH / OPENRIG_DELIVERY_READY_DIR for non-canonical
+// layouts. Empty/unset → composer.isReady() = false → route returns
+// 503 with structured setup hint.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { ProgressIndexer } from "../progress/progress-indexer.js";
+const ENV_WORKSPACE = "OPENRIG_STEERING_WORKSPACE";
+const ENV_LEGACY_WORKSPACE = "RIGGED_STEERING_WORKSPACE";
+const ENV_STEERING_PATH = "OPENRIG_STEERING_PATH";
+const ENV_ROADMAP_PATH = "OPENRIG_ROADMAP_PATH";
+const ENV_DELIVERY_READY_DIR = "OPENRIG_DELIVERY_READY_DIR";
+export function steeringOptsFromEnv(env = process.env) {
+    // Use || (not ??) so an empty-string env var falls through to the next
+    // candidate. Same precedent as the UI Enhancement Pack v0 env helpers.
+    const workspaceRoot = (env[ENV_WORKSPACE] || env[ENV_LEGACY_WORKSPACE] || "").trim() || null;
+    return {
+        workspaceRoot,
+        steeringPath: (env[ENV_STEERING_PATH] || "").trim() || null,
+        roadmapPath: (env[ENV_ROADMAP_PATH] || "").trim() || null,
+        deliveryReadyDir: (env[ENV_DELIVERY_READY_DIR] || "").trim() || null,
+    };
+}
+export function steeringOptsFromSettings(settings, env = process.env) {
+    const envOpts = steeringOptsFromEnv(env);
+    return {
+        workspaceRoot: envOpts.workspaceRoot ?? settings.workspaceRoot,
+        steeringPath: envOpts.steeringPath ?? settings.workspaceSteeringPath,
+        roadmapPath: envOpts.roadmapPath ?? null,
+        deliveryReadyDir: envOpts.deliveryReadyDir ?? null,
+    };
+}
+export class SteeringComposer {
+    opts;
+    constructor(opts) {
+        this.opts = {
+            workspaceRoot: opts.workspaceRoot,
+            steeringPath: opts.steeringPath ?? null,
+            roadmapPath: opts.roadmapPath ?? null,
+            deliveryReadyDir: opts.deliveryReadyDir ?? null,
+            topNPerLane: opts.topNPerLane ?? 3,
+        };
+    }
+    /** True when at least one source is resolvable. Routes use this to
+     *  decide between 200 (with possibly-empty unavailableSources) and
+     *  503 (no sources at all). */
+    isReady() {
+        return Boolean(this.resolveSteeringPath() ||
+            this.resolveRoadmapPath() ||
+            this.resolveDeliveryReadyDir());
+    }
+    compose() {
+        const unavailableSources = [];
+        const priorityStack = this.composePriorityStack(unavailableSources);
+        const roadmapRail = this.composeRoadmapRail(unavailableSources);
+        const laneRails = this.composeLaneRails(unavailableSources);
+        return { priorityStack, roadmapRail, laneRails, unavailableSources };
+    }
+    // --- per-section composers ---
+    composePriorityStack(unavailableSources) {
+        const p = this.resolveSteeringPath();
+        if (!p) {
+            unavailableSources.push({ section: "priorityStack", reason: "STEERING.md path not configured", envVar: ENV_STEERING_PATH });
+            return null;
+        }
+        try {
+            const content = fs.readFileSync(p, "utf-8");
+            const stat = fs.statSync(p);
+            return {
+                content,
+                absolutePath: p,
+                mtime: stat.mtime.toISOString(),
+                byteCount: stat.size,
+            };
+        }
+        catch (err) {
+            unavailableSources.push({
+                section: "priorityStack",
+                reason: `failed to read STEERING.md: ${err instanceof Error ? err.message : String(err)}`,
+                envVar: ENV_STEERING_PATH,
+            });
+            return null;
+        }
+    }
+    composeRoadmapRail(unavailableSources) {
+        const p = this.resolveRoadmapPath();
+        if (!p) {
+            unavailableSources.push({ section: "roadmapRail", reason: "roadmap PROGRESS.md path not configured", envVar: ENV_ROADMAP_PATH });
+            return null;
+        }
+        let content;
+        let mtime;
+        try {
+            content = fs.readFileSync(p, "utf-8");
+            mtime = fs.statSync(p).mtime;
+        }
+        catch (err) {
+            unavailableSources.push({
+                section: "roadmapRail",
+                reason: `failed to read roadmap PROGRESS.md: ${err instanceof Error ? err.message : String(err)}`,
+                envVar: ENV_ROADMAP_PATH,
+            });
+            return null;
+        }
+        const items = [];
+        let nextUncheckedSet = false;
+        let nextUncheckedLine = null;
+        let total = 0;
+        let done = 0;
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const m = lines[i].match(/^\s*(?:[-*]\s+)?\[([ xX])\]\s+(.+)$/);
+            if (!m)
+                continue;
+            const isDone = m[1].toLowerCase() === "x";
+            const text = m[2].trim();
+            total++;
+            if (isDone)
+                done++;
+            const railCode = matchRailItemCode(text);
+            const isNextUnchecked = !isDone && !nextUncheckedSet;
+            if (isNextUnchecked) {
+                nextUncheckedSet = true;
+                nextUncheckedLine = i + 1;
+            }
+            items.push({
+                line: i + 1,
+                text,
+                done: isDone,
+                railItemCode: railCode,
+                isNextUnchecked,
+            });
+        }
+        return {
+            absolutePath: p,
+            mtime: mtime.toISOString(),
+            items,
+            counts: { total, done, nextUncheckedLine },
+        };
+    }
+    composeLaneRails(unavailableSources) {
+        const dir = this.resolveDeliveryReadyDir();
+        if (!dir) {
+            unavailableSources.push({
+                section: "laneRails",
+                reason: "delivery-ready directory not configured",
+                envVar: ENV_DELIVERY_READY_DIR,
+            });
+            return [];
+        }
+        // Use the existing ProgressIndexer to parse mode-{0..3}/PROGRESS.md
+        // — same checkbox-status semantics as the UI Enhancement Pack v0
+        // /progress view, so the steering view stays consistent with what
+        // the operator sees in the Progress workspace.
+        const indexer = new ProgressIndexer({
+            roots: [{ name: "delivery-ready", canonicalPath: dir }],
+            maxDepth: 3,
+        });
+        const result = indexer.scan();
+        const lanes = [];
+        for (const file of result.files) {
+            // Derive laneId from "mode-N/PROGRESS.md" or fallback to relPath.
+            const m = file.relPath.match(/^(mode-\d+)\/PROGRESS\.md$/);
+            const laneId = m ? m[1] : file.relPath.replace(/\/?PROGRESS\.md$/i, "") || file.relPath;
+            lanes.push(this.composeLaneFromFile(laneId, file));
+        }
+        lanes.sort((a, b) => a.laneId.localeCompare(b.laneId));
+        return lanes;
+    }
+    composeLaneFromFile(laneId, file) {
+        const checkboxRows = file.rows.filter((r) => r.kind === "checkbox");
+        // Priority Rail Rule "next pull": first non-done, non-blocked
+        // checkbox row on the lane. Per the workstream-continuity convention
+        // (cited in the PRD), shelf/queue recency does NOT override; first
+        // ready item wins.
+        const nextPullIdx = checkboxRows.findIndex((r) => r.status !== "done" && r.status !== "blocked");
+        const nextPullLine = nextPullIdx >= 0 ? (checkboxRows[nextPullIdx]?.line ?? null) : null;
+        // Top-N: prefer active+blocked rows; only fall back to done if there
+        // aren't enough non-done rows to fill N (rare on healthy lanes,
+        // common on closed lanes).
+        const N = this.opts.topNPerLane;
+        const nonDoneRows = checkboxRows.filter((r) => r.status !== "done");
+        const doneRows = checkboxRows.filter((r) => r.status === "done");
+        const orderedSelection = [...nonDoneRows, ...doneRows].slice(0, N);
+        const topItems = orderedSelection.map((r) => ({
+            line: r.line,
+            text: r.text,
+            status: r.status,
+            isNextPull: r.line === nextPullLine,
+        }));
+        return {
+            laneId,
+            absolutePath: file.absolutePath,
+            mtime: file.mtime,
+            topItems,
+            healthBadges: {
+                active: file.counts.active,
+                blocked: file.counts.blocked,
+                done: file.counts.done,
+                total: file.counts.total,
+            },
+            nextPullLine,
+        };
+    }
+    // --- path resolvers ---
+    resolveSteeringPath() {
+        if (this.opts.steeringPath)
+            return this.opts.steeringPath;
+        if (!this.opts.workspaceRoot)
+            return null;
+        const candidate = path.join(this.opts.workspaceRoot, "STEERING.md");
+        return fs.existsSync(candidate) ? candidate : null;
+    }
+    resolveRoadmapPath() {
+        if (this.opts.roadmapPath)
+            return this.opts.roadmapPath;
+        if (!this.opts.workspaceRoot)
+            return null;
+        const candidate = path.join(this.opts.workspaceRoot, "roadmap", "PROGRESS.md");
+        return fs.existsSync(candidate) ? candidate : null;
+    }
+    resolveDeliveryReadyDir() {
+        if (this.opts.deliveryReadyDir)
+            return this.opts.deliveryReadyDir;
+        if (!this.opts.workspaceRoot)
+            return null;
+        const candidate = path.join(this.opts.workspaceRoot, "delivery-ready");
+        try {
+            const st = fs.statSync(candidate);
+            if (st.isDirectory())
+                return candidate;
+        }
+        catch { /* fall through */ }
+        return null;
+    }
+}
+const RAIL_CODE_REGEX = /\b(PL-\d{2,4})\b/;
+export function matchRailItemCode(text) {
+    const m = text.match(RAIL_CODE_REGEX);
+    return m ? m[1] : null;
+}
+//# sourceMappingURL=steering-composer.js.map

package/daemon/dist/domain/steering/steering-composer.js.map

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

package/daemon/dist/domain/transcript-capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcript-capture.d.ts","sourceRoot":"","sources":["../../src/domain/transcript-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EAC3C,eAAe,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACnD,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBhD"}
+{"version":3,"file":"transcript-capture.d.ts","sourceRoot":"","sources":["../../src/domain/transcript-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EAC3C,eAAe,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACnD,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBhD"}

package/daemon/dist/domain/transcript-capture.js

@@ -1,3 +1,4 @@
+import { startTranscriptRotation, getTranscriptRotationOptionsFromEnv, } from "./transcript-rotation.js";
 export async function startTmuxTranscriptCapture(tmuxAdapter, transcriptStore, rigName, sessionName) {
     if (!tmuxAdapter || !transcriptStore?.enabled) {
         return { started: false, reason: "transcript_capture_unavailable" };
@@ -6,10 +7,12 @@ export async function startTmuxTranscriptCapture(tmuxAdapter, transcriptStore, r
         return { started: false, reason: "transcript_dir_unavailable" };
     }
     const transcriptPath = transcriptStore.getTranscriptPath(rigName, sessionName);
-    const pipeResult = await tmuxAdapter.startPipePane(sessionName, transcriptPath);
-    if (!pipeResult.ok) {
-        return { started: false, reason: pipeResult.message };
-    }
+    // V1 pre-release CLI/daemon Item 1: bounded-trail rotation replaces
+    // the pipe-pane infinite-growth file. Defaults from env vars + 1000
+    // line / 2s baseline; failure inside rotation is best-effort silent
+    // and never blocks launch (the prior pipe-pane site treated failure
+    // as launch-warning, not launch-blocker, so behavior stays).
+    startTranscriptRotation(tmuxAdapter, sessionName, transcriptPath, getTranscriptRotationOptionsFromEnv());
     return { started: true };
 }
 //# sourceMappingURL=transcript-capture.js.map

package/daemon/dist/domain/transcript-capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"transcript-capture.js","sourceRoot":"","sources":["../../src/domain/transcript-capture.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,WAA2C,EAC3C,eAAmD,EACnD,OAAe,EACf,WAAmB;IAEnB,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,EAAE,OAAO,EAAE,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC;IACtE,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,cAAc,GAAG,eAAe,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAChF,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"transcript-capture.js","sourceRoot":"","sources":["../../src/domain/transcript-capture.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,uBAAuB,EACvB,mCAAmC,GACpC,MAAM,0BAA0B,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,WAA2C,EAC3C,eAAmD,EACnD,OAAe,EACf,WAAmB;IAEnB,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,EAAE,OAAO,EAAE,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC;IACtE,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,cAAc,GAAG,eAAe,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/E,oEAAoE;IACpE,oEAAoE;IACpE,oEAAoE;IACpE,oEAAoE;IACpE,6DAA6D;IAC7D,uBAAuB,CACrB,WAAW,EACX,WAAW,EACX,cAAc,EACd,mCAAmC,EAAE,CACtC,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/daemon/dist/domain/transcript-rotation.d.ts

@@ -0,0 +1,29 @@
+import type { TmuxAdapter } from "../adapters/tmux.js";
+export interface TranscriptRotationOptions {
+    /** Trailing line count to capture each tick. */
+    lines: number;
+    /** Poll interval in milliseconds. */
+    pollIntervalMs: number;
+}
+export declare const DEFAULT_TRANSCRIPT_LINES = 1000;
+export declare const DEFAULT_TRANSCRIPT_POLL_INTERVAL_MS = 2000;
+/** Resolve rotation options from env vars, falling back to defaults.
+ *  File-stored config (rig config set transcripts.lines …) is loaded
+ *  via the daemon settings-store at startup; consumers that need the
+ *  file-stored value can pass an explicit options object instead. */
+export declare function getTranscriptRotationOptionsFromEnv(): TranscriptRotationOptions;
+/** Start a per-session capture-pane rotation timer. Idempotent: a
+ *  second start for the same session replaces the first timer. The
+ *  first tick fires immediately so the transcript file is populated
+ *  before the first poll interval elapses. */
+export declare function startTranscriptRotation(tmuxAdapter: TmuxAdapter, sessionName: string, outputPath: string, opts: TranscriptRotationOptions): void;
+/** Clear the rotation timer for a session. Safe to call when no timer
+ *  is registered. */
+export declare function stopTranscriptRotation(sessionName: string): void;
+/** Test-only: count of active rotators. Production code should not
+ *  depend on this. */
+export declare function getActiveRotationCount(): number;
+/** Test-only: clear all active rotators. Production code should not
+ *  call this; use stopTranscriptRotation for individual sessions. */
+export declare function clearAllTranscriptRotationsForTest(): void;
+//# sourceMappingURL=transcript-rotation.d.ts.map

package/daemon/dist/domain/transcript-rotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-rotation.d.ts","sourceRoot":"","sources":["../../src/domain/transcript-rotation.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,yBAAyB;IACxC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,mCAAmC,OAAO,CAAC;AAExD;;;qEAGqE;AACrE,wBAAgB,mCAAmC,IAAI,yBAAyB,CAM/E;AAWD;;;8CAG8C;AAC9C,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,yBAAyB,GAC9B,IAAI,CA2CN;AAED;qBACqB;AACrB,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAMhE;AAED;sBACsB;AACtB,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;qEACqE;AACrE,wBAAgB,kCAAkC,IAAI,IAAI,CAGzD"}

package/daemon/dist/domain/transcript-rotation.js

@@ -0,0 +1,109 @@
+// V1 pre-release CLI/daemon Item 1 — bounded-trail transcript rotation.
+//
+// Replaces the legacy `tmux pipe-pane` mechanism (infinite-growth file)
+// with a periodic `tmux capture-pane -t <session> -p -S -<lines>` shellout
+// that atomically overwrites the transcript file. File size stays bounded
+// by trailing line count + line-byte ceiling, not by session duration.
+//
+// Tunables (env: OPENRIG_TRANSCRIPTS_LINES / OPENRIG_TRANSCRIPTS_POLL_INTERVAL_SECONDS;
+// allowlist keys transcripts.lines / transcripts.poll_interval_seconds):
+//   - lines:           number of trailing lines to capture per tick (default 1000)
+//   - pollIntervalMs:  millisecond cadence between ticks (default 2000)
+//
+// SC-29 EXCEPTION #4 declared in pre-release CLI/daemon ACK §5.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { readOpenRigEnv } from "../openrig-compat.js";
+export const DEFAULT_TRANSCRIPT_LINES = 1000;
+export const DEFAULT_TRANSCRIPT_POLL_INTERVAL_MS = 2000;
+/** Resolve rotation options from env vars, falling back to defaults.
+ *  File-stored config (rig config set transcripts.lines …) is loaded
+ *  via the daemon settings-store at startup; consumers that need the
+ *  file-stored value can pass an explicit options object instead. */
+export function getTranscriptRotationOptionsFromEnv() {
+    const linesRaw = readOpenRigEnv("OPENRIG_TRANSCRIPTS_LINES");
+    const pollRaw = readOpenRigEnv("OPENRIG_TRANSCRIPTS_POLL_INTERVAL_SECONDS");
+    const lines = parsePositiveInt(linesRaw, DEFAULT_TRANSCRIPT_LINES);
+    const pollSeconds = parsePositiveInt(pollRaw, DEFAULT_TRANSCRIPT_POLL_INTERVAL_MS / 1000);
+    return { lines, pollIntervalMs: pollSeconds * 1000 };
+}
+function parsePositiveInt(raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const n = parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return fallback;
+    return n;
+}
+const activeTimers = new Map();
+/** Start a per-session capture-pane rotation timer. Idempotent: a
+ *  second start for the same session replaces the first timer. The
+ *  first tick fires immediately so the transcript file is populated
+ *  before the first poll interval elapses. */
+export function startTranscriptRotation(tmuxAdapter, sessionName, outputPath, opts) {
+    stopTranscriptRotation(sessionName);
+    const tick = async () => {
+        try {
+            const content = await tmuxAdapter.capturePaneContent(sessionName, opts.lines);
+            if (content === null)
+                return;
+            // Preserve SESSION BOUNDARY lines that the restore orchestrator
+            // writes to the transcript file before launch. The capture-pane
+            // overwrite would otherwise wipe them on the first tick. The
+            // marker is the only structural header the transcript file is
+            // expected to carry across rotations; everything else is
+            // terminal-scrollback content from capture-pane.
+            let header = "";
+            try {
+                if (fs.existsSync(outputPath)) {
+                    const prev = fs.readFileSync(outputPath, "utf8");
+                    const boundaryLines = prev
+                        .split("\n")
+                        .filter((line) => line.startsWith("--- SESSION BOUNDARY:"));
+                    if (boundaryLines.length > 0)
+                        header = boundaryLines.join("\n") + "\n";
+                }
+            }
+            catch {
+                // Best-effort header read; missing file or read error means no header.
+            }
+            fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+            const tmpPath = `${outputPath}.tmp.${process.pid}`;
+            fs.writeFileSync(tmpPath, header + content);
+            fs.renameSync(tmpPath, outputPath);
+        }
+        catch {
+            // Best-effort capture: target session may have died, output path
+            // may be unwritable, etc. The next tick retries; failure here
+            // does not bubble up to the daemon's launch / lifecycle paths.
+        }
+    };
+    void tick();
+    const timer = setInterval(tick, opts.pollIntervalMs);
+    // Don't keep the daemon process alive solely on transcript timers.
+    if (typeof timer.unref === "function")
+        timer.unref();
+    activeTimers.set(sessionName, timer);
+}
+/** Clear the rotation timer for a session. Safe to call when no timer
+ *  is registered. */
+export function stopTranscriptRotation(sessionName) {
+    const timer = activeTimers.get(sessionName);
+    if (timer) {
+        clearInterval(timer);
+        activeTimers.delete(sessionName);
+    }
+}
+/** Test-only: count of active rotators. Production code should not
+ *  depend on this. */
+export function getActiveRotationCount() {
+    return activeTimers.size;
+}
+/** Test-only: clear all active rotators. Production code should not
+ *  call this; use stopTranscriptRotation for individual sessions. */
+export function clearAllTranscriptRotationsForTest() {
+    for (const timer of activeTimers.values())
+        clearInterval(timer);
+    activeTimers.clear();
+}
+//# sourceMappingURL=transcript-rotation.js.map

package/daemon/dist/domain/transcript-rotation.js.map

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

package/daemon/dist/domain/transcript-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcript-store.d.ts","sourceRoot":"","sources":["../../src/domain/transcript-store.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAiKD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAEvB,IAAI,CAAC,EAAE,mBAAmB;IAKtC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAS/D,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAe7C,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAYlF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAqB/B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA+B5E,OAAO,CAAC,gBAAgB;IAkBxB;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAU7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAU5E,OAAO,CAAC,QAAQ;CA+CjB"}
+{"version":3,"file":"transcript-store.d.ts","sourceRoot":"","sources":["../../src/domain/transcript-store.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAiKD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAEvB,IAAI,CAAC,EAAE,mBAAmB;IAKtC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAS/D,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAe7C,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAkBlF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAqB/B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA+B5E,OAAO,CAAC,gBAAgB;IAkBxB;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAU7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAU5E,OAAO,CAAC,QAAQ;CA+CjB"}

package/daemon/dist/domain/transcript-store.js

@@ -1,5 +1,5 @@
 import { mkdirSync, appendFileSync, existsSync, openSync, readSync, closeSync, statSync, readFileSync } from "node:fs";
-import { join } from "node:path";
+import { join, dirname } from "node:path";
 import { StringDecoder } from "node:string_decoder";
 import { getCompatibleOpenRigPath } from "../openrig-compat.js";
 const DEFAULT_ROOT = getCompatibleOpenRigPath("transcripts");
@@ -197,6 +197,12 @@ export class TranscriptStore {
             return false;
         try {
             const filePath = this.getTranscriptPath(rigName, sessionName);
+            // Ensure the rig directory exists so the marker write succeeds
+            // even when called before the launcher's ensureTranscriptDir.
+            // Restore orchestration writes the marker before launch; the
+            // launcher creates the dir later, which used to lose markers
+            // for the first restore on a fresh rig.
+            mkdirSync(dirname(filePath), { recursive: true });
             const marker = `--- SESSION BOUNDARY: ${reason} at ${new Date().toISOString()} ---\n`;
             appendFileSync(filePath, marker, "utf-8");
             return true;