@dsh-cc/tui 0.5.0

package/lib/harness/session-list.js

@@ -0,0 +1,91 @@
+/**
+ * Pure session-list helpers for the /resume picker: last-activity sort,
+ * scope/query filtering, and row formatting. No imports — shared by the
+ * driver, the overlay renderer, and the specs.
+ * @module @dsh-cc/tui/harness/session-list
+ */
+/**
+ * Order sessions by last activity: `(updatedAtMs ?? createdAt)` descending,
+ * ties broken by createdAt then id (so the order is stable across reloads).
+ * Returns a new list; the input is untouched.
+ */
+export function sortByActivity(entries) {
+    return entries.slice().sort((a, b) => {
+        const activeA = a.updatedAtMs ?? a.createdAt;
+        const activeB = b.updatedAtMs ?? b.createdAt;
+        if (activeA !== activeB)
+            return activeB - activeA;
+        if (a.createdAt !== b.createdAt)
+            return b.createdAt - a.createdAt;
+        return a.id.localeCompare(b.id);
+    });
+}
+/**
+ * Filter sessions for the picker: child/fork sessions (those with
+ * `parentSession`) are hidden unless they are the live session; cwd scope
+ * keeps only entries the `isMember` predicate accepts (the driver builds it
+ * from the session's *project* — sidecar index ∪ cwd-prefix heuristic — so
+ * worktree and subdirectory sessions of the same repo stay visible; a
+ * missing predicate disables the scope); then a non-empty query keeps
+ * entries whose title, id, or cwd contains it case-insensitively. Never
+ * re-sorts — the caller controls order.
+ */
+export function filterSessions(entries, opts) {
+    let result = entries.slice();
+    result = result.filter(entry => entry.parentSession === undefined || entry.id === opts.currentId);
+    if (opts.scope === 'cwd' && opts.isMember !== undefined) {
+        result = result.filter(opts.isMember);
+    }
+    const query = opts.query.trim().toLowerCase();
+    if (query.length > 0) {
+        result = result.filter(entry => (entry.title ?? '').toLowerCase().includes(query)
+            || entry.id.toLowerCase().includes(query)
+            || (entry.cwd ?? '').toLowerCase().includes(query));
+    }
+    return result;
+}
+/** Short relative-time label for a session timestamp: "2m ago", "1h ago", "3d ago", or `M/D`. */
+export function relativeDate(ts, now = Date.now()) {
+    const seconds = Math.floor((now - ts) / 1000);
+    if (seconds < 60)
+        return 'just now';
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    if (days < 7)
+        return `${days}d ago`;
+    const d = new Date(ts);
+    return `${d.getMonth() + 1}/${d.getDate()}`;
+}
+/** First 8 chars of a session id — enough to distinguish in a short list. */
+export function shortId(id) {
+    return id.length > 8 ? id.slice(0, 8) : id;
+}
+/** Last path segment of a directory, accepting both `/` and `\` separators. */
+function basename(path) {
+    const segments = path.split(/[\\/]/);
+    return segments[segments.length - 1] ?? path;
+}
+/**
+ * Compute one picker row: relative time from last activity, the title (or
+ * short id when untitled), the 8-char short id, the cwd basename when the
+ * row should surface it (all-projects scope), and whether the entry is the
+ * session the user is currently in.
+ */
+export function formatSessionRow(entry, opts) {
+    const time = relativeDate(entry.updatedAtMs ?? entry.createdAt, opts.now);
+    const short = shortId(entry.id);
+    const label = entry.title !== undefined && entry.title.length > 0 ? entry.title : short;
+    return {
+        time,
+        label,
+        shortId: short,
+        ...opts.showCwd && entry.cwd !== undefined ? { cwdPart: basename(entry.cwd) } : {},
+        current: entry.id === opts.currentId,
+    };
+}
+//# sourceMappingURL=session-list.js.map

package/lib/harness/session-list.js.map

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

package/lib/harness/shell-output.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shell/output helpers extracted from harness/driver.ts: `!` command budget
+ * constants, git-branch probing, default `/export-md` path stamping, and
+ * bash-output row assembly. Node builtins only — no store or harness imports.
+ * @module @dsh-cc/tui/harness/shell-output
+ */
+import { execFile } from 'node:child_process';
+/** Wall-clock lifetime of a `!` shell command. */
+export declare const BASH_TIMEOUT_MS = 120000;
+/** Foreground stdout byte budget handed to the shell executor for a `!` run. */
+export declare const BASH_STDOUT_MAX_BYTES = 64000;
+/** Lines of command output shown under the `$ cmd` echo row (rest is elided). */
+export declare const BASH_OUTPUT_LINE_CAP = 20;
+/** Notice parked above the composer while a `!` command runs. */
+export declare const BASH_RUNNING_NOTICE = "\u280B running\u2026";
+export declare const execFileAsync: typeof execFile.__promisify__;
+/**
+ * Default `/export-md` output directory: `$DSH_HOME/tui/exports` (or
+ * `~/.dsh/tui/exports`), mirroring the `resume-target` data-dir
+ * resolution one level deeper.
+ */
+export declare function defaultExportDir(): string;
+/** Filesystem-safe timestamp for default export filenames (ISO, `:`/`.` dashed). */
+export declare function exportStamp(): string;
+/**
+ * Best-effort git branch probe: `git -C <cwd> rev-parse --abbrev-ref HEAD`
+ * with a short timeout. Never throws — errors (no git, no repo, detached
+ * head) resolve to undefined and the statusline simply omits the segment.
+ */
+export declare function gitBranchOf(cwd: string): Promise<string | undefined>;
+/**
+ * Assemble the bash-command output row: combined stdout/stderr (line-capped)
+ * plus a failure trailer. The row is error-marked for a non-zero exit, a
+ * signal death, or an executor timeout.
+ */
+export declare function shellOutputRow(stdout: string, stderr: string, outcome: {
+    exitCode: number | null;
+    timedOut: boolean;
+}): {
+    kind: 'status';
+    text: string;
+    error?: boolean;
+};
+//# sourceMappingURL=shell-output.d.ts.map

package/lib/harness/shell-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-output.d.ts","sourceRoot":"","sources":["../../src/harness/shell-output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAK7C,kDAAkD;AAClD,eAAO,MAAM,eAAe,SAAU,CAAA;AAEtC,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,yBAAe,CAAA;AAE/C,eAAO,MAAM,aAAa,+BAAsB,CAAA;AAEhD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAED,oFAAoF;AACpF,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU1E;AAeD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAiBnD"}

package/lib/harness/shell-output.js

@@ -0,0 +1,90 @@
+/**
+ * Shell/output helpers extracted from harness/driver.ts: `!` command budget
+ * constants, git-branch probing, default `/export-md` path stamping, and
+ * bash-output row assembly. Node builtins only — no store or harness imports.
+ * @module @dsh-cc/tui/harness/shell-output
+ */
+import { execFile } from 'node:child_process';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+/** Wall-clock lifetime of a `!` shell command. */
+export const BASH_TIMEOUT_MS = 120_000;
+/** Foreground stdout byte budget handed to the shell executor for a `!` run. */
+export const BASH_STDOUT_MAX_BYTES = 64_000;
+/** Lines of command output shown under the `$ cmd` echo row (rest is elided). */
+export const BASH_OUTPUT_LINE_CAP = 20;
+/** Notice parked above the composer while a `!` command runs. */
+export const BASH_RUNNING_NOTICE = '⠋ running…';
+export const execFileAsync = promisify(execFile);
+/**
+ * Default `/export-md` output directory: `$DSH_HOME/tui/exports` (or
+ * `~/.dsh/tui/exports`), mirroring the `resume-target` data-dir
+ * resolution one level deeper.
+ */
+export function defaultExportDir() {
+    const dshHome = process.env.DSH_HOME ?? join(homedir(), '.dsh');
+    return join(dshHome, 'tui', 'exports');
+}
+/** Filesystem-safe timestamp for default export filenames (ISO, `:`/`.` dashed). */
+export function exportStamp() {
+    return new Date().toISOString().replace(/[:.]/g, '-');
+}
+/**
+ * Best-effort git branch probe: `git -C <cwd> rev-parse --abbrev-ref HEAD`
+ * with a short timeout. Never throws — errors (no git, no repo, detached
+ * head) resolve to undefined and the statusline simply omits the segment.
+ */
+export async function gitBranchOf(cwd) {
+    try {
+        const { stdout } = await execFileAsync('git', ['-C', cwd, 'rev-parse', '--abbrev-ref', 'HEAD'], {
+            timeout: 2000,
+        });
+        const branch = stdout.trim();
+        return branch.length > 0 ? branch : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Cap combined command output at {@link BASH_OUTPUT_LINE_CAP} lines. Leading
+ * and trailing blank edges (from an empty stream or a trailing newline) are
+ * trimmed; interior blank lines are preserved.
+ */
+function capShellOutput(text) {
+    const lines = text.replace(/^\n+/, '').replace(/\n+$/, '').split('\n');
+    if (lines.length === 1 && lines[0] === '')
+        return '';
+    if (lines.length <= BASH_OUTPUT_LINE_CAP)
+        return lines.join('\n');
+    const hidden = lines.length - BASH_OUTPUT_LINE_CAP;
+    return `${lines.slice(0, BASH_OUTPUT_LINE_CAP).join('\n')}\n… +${hidden} more line${hidden === 1 ? '' : 's'}`;
+}
+/**
+ * Assemble the bash-command output row: combined stdout/stderr (line-capped)
+ * plus a failure trailer. The row is error-marked for a non-zero exit, a
+ * signal death, or an executor timeout.
+ */
+export function shellOutputRow(stdout, stderr, outcome) {
+    const parts = [];
+    const capped = capShellOutput(`${stdout}\n${stderr}`);
+    if (capped.length > 0)
+        parts.push(capped);
+    if (outcome.timedOut) {
+        parts.push(`timed out after ${BASH_TIMEOUT_MS / 1000}s`);
+    }
+    else if (outcome.exitCode === null) {
+        parts.push('killed by a signal');
+    }
+    else if (outcome.exitCode !== 0) {
+        parts.push(`exit code ${outcome.exitCode}`);
+    }
+    const failed = outcome.timedOut || outcome.exitCode === null || outcome.exitCode !== 0;
+    return {
+        kind: 'status',
+        text: parts.join('\n'),
+        ...(failed ? { error: true } : {}),
+    };
+}
+//# sourceMappingURL=shell-output.js.map

package/lib/harness/shell-output.js.map

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

package/lib/harness/statusline-cc-transcript.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CC-shape plaintext JSONL transcript mirror (statusline Slice C): a per-session
+ * mirror of the harness session events translated into the line shape
+ * ccstatusline reads (`message.usage` with the four token fields, ISO
+ * `timestamp`, `type` of 'assistant'/'user'). The statusline payload advertises
+ * the mirror as `transcript_path` ONLY while it is `ready` — a readable-but-
+ * empty file would make ccstatusline's fail-soft produce an all-zeros metrics
+ * object, and those zeros shadow truthful stdin fallbacks (`??` passes zeros
+ * through), so a mirror with no assistant usage is never created. Writes are
+ * atomic per rebuild (tmp file + rename; multi-TUI last-writer-wins yields
+ * complete files) and append-only per live event under a seq watermark. Any fs
+ * error permanently disables the mirror: appends run on the synchronous
+ * session-append hot path, so no retries, and later appends to a corrupt
+ * stream are worse than silence. This module never imports harness types —
+ * events are consumed structurally, matching the sibling modules' convention.
+ * @module @dsh-cc/tui/harness/statusline-cc-transcript
+ */
+/** Structural view of a harness session event ({type, data, seq, time}). */
+export type CcSessionEventLike = {
+    type?: unknown;
+    data?: unknown;
+    seq?: unknown;
+    time?: unknown;
+};
+/**
+ * Translate harness session events into CC transcript lines. Only
+ * `assistant/message` events with finite input/output usage and a finite time
+ * produce assistant lines (with EXPLICIT cache zeros when the source omits the
+ * cache fields — the token-meter projection also normalizes them to 0, keeping
+ * mirror totals ≡ projection totals); `user/message` events with a finite time
+ * produce speed-anchor lines. Everything else is dropped. `stop_reason` is
+ * NEVER emitted: if ccstatusline ever sees an own-property `stop_reason` on a
+ * message its accumulator switches semantics, so the key is banned outright.
+ */
+export declare function translateEventsToCcTranscript(events: readonly unknown[], sessionId: string): string[];
+/** The mirror state the wiring consults. */
+export type CcTranscriptMirror = {
+    /** Whether the mirror currently has a written, non-empty file. */
+    isReady(): boolean;
+    /** The mirror file path when ready, else undefined. */
+    getPath(): string | undefined;
+    /** Full rebuild from the session's event log (atomic rename, GC sweep). */
+    rebind(sessionId: string, events: readonly unknown[]): void;
+    /** Best-effort live append of one event; no-op while not ready. */
+    append(event: unknown): void;
+};
+/** Create a CC transcript mirror rooted under `dir` (default the tui dir). */
+export declare function createCcTranscriptMirror(options?: {
+    dir?: string;
+}): CcTranscriptMirror;
+//# sourceMappingURL=statusline-cc-transcript.d.ts.map

package/lib/harness/statusline-cc-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-cc-transcript.d.ts","sourceRoot":"","sources":["../../src/harness/statusline-cc-transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAkBH,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AA0BD;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAuCV;AAOD,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kEAAkE;IAClE,OAAO,IAAI,OAAO,CAAA;IAClB,uDAAuD;IACvD,OAAO,IAAI,MAAM,GAAG,SAAS,CAAA;IAC7B,2EAA2E;IAC3E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAA;IAC3D,mEAAmE;IACnE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;CAC7B,CAAA;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,kBAAkB,CA8E3F"}

package/lib/harness/statusline-cc-transcript.js

@@ -0,0 +1,191 @@
+/**
+ * CC-shape plaintext JSONL transcript mirror (statusline Slice C): a per-session
+ * mirror of the harness session events translated into the line shape
+ * ccstatusline reads (`message.usage` with the four token fields, ISO
+ * `timestamp`, `type` of 'assistant'/'user'). The statusline payload advertises
+ * the mirror as `transcript_path` ONLY while it is `ready` — a readable-but-
+ * empty file would make ccstatusline's fail-soft produce an all-zeros metrics
+ * object, and those zeros shadow truthful stdin fallbacks (`??` passes zeros
+ * through), so a mirror with no assistant usage is never created. Writes are
+ * atomic per rebuild (tmp file + rename; multi-TUI last-writer-wins yields
+ * complete files) and append-only per live event under a seq watermark. Any fs
+ * error permanently disables the mirror: appends run on the synchronous
+ * session-append hot path, so no retries, and later appends to a corrupt
+ * stream are worse than silence. This module never imports harness types —
+ * events are consumed structurally, matching the sibling modules' convention.
+ * @module @dsh-cc/tui/harness/statusline-cc-transcript
+ */
+import { appendFileSync, mkdirSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { randomBytes } from 'node:crypto';
+import { join } from 'node:path';
+import { defaultTuiDir } from "../history.js";
+/** Maximum age (ms) a mirrored file survives the GC sweep. */
+const GC_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000;
+/** Whether a value is a finite number. */
+function isFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+/** Structural read of a usage record; all four fields normalize to 0. */
+function usageOf(data) {
+    if (typeof data !== 'object' || data === null)
+        return undefined;
+    const usage = data.usage;
+    if (typeof usage !== 'object' || usage === null)
+        return undefined;
+    const u = usage;
+    return {
+        inputTokens: u.inputTokens,
+        outputTokens: u.outputTokens,
+        cacheReadTokens: u.cacheReadTokens,
+        cacheWriteTokens: u.cacheWriteTokens,
+    };
+}
+/**
+ * Translate harness session events into CC transcript lines. Only
+ * `assistant/message` events with finite input/output usage and a finite time
+ * produce assistant lines (with EXPLICIT cache zeros when the source omits the
+ * cache fields — the token-meter projection also normalizes them to 0, keeping
+ * mirror totals ≡ projection totals); `user/message` events with a finite time
+ * produce speed-anchor lines. Everything else is dropped. `stop_reason` is
+ * NEVER emitted: if ccstatusline ever sees an own-property `stop_reason` on a
+ * message its accumulator switches semantics, so the key is banned outright.
+ */
+export function translateEventsToCcTranscript(events, sessionId) {
+    const lines = [];
+    for (const raw of events) {
+        if (typeof raw !== 'object' || raw === null)
+            continue;
+        const event = raw;
+        const { type, data, time } = event;
+        if (!isFiniteNumber(time))
+            continue;
+        const timestamp = new Date(time).toISOString();
+        if (type === 'assistant/message') {
+            const usage = usageOf(data);
+            if (usage === undefined)
+                continue;
+            if (!isFiniteNumber(usage.inputTokens) || !isFiniteNumber(usage.outputTokens))
+                continue;
+            lines.push(JSON.stringify({
+                type: 'assistant',
+                timestamp,
+                isSidechain: false,
+                sessionId,
+                message: {
+                    usage: {
+                        input_tokens: usage.inputTokens,
+                        output_tokens: usage.outputTokens,
+                        // Explicit zeros for absent cache fields are intentional: the
+                        // token-meter normalizes them to 0 too, keeping the mirror totals
+                        // identical to the projection totals the payload carries.
+                        cache_creation_input_tokens: isFiniteNumber(usage.cacheWriteTokens) ? usage.cacheWriteTokens : 0,
+                        cache_read_input_tokens: isFiniteNumber(usage.cacheReadTokens) ? usage.cacheReadTokens : 0,
+                    },
+                },
+            }));
+        }
+        else if (type === 'user/message') {
+            lines.push(JSON.stringify({
+                type: 'user',
+                timestamp,
+                isSidechain: false,
+                sessionId,
+            }));
+        }
+    }
+    return lines;
+}
+/** The sanitized file name stem for a session id. */
+function sanitizeSessionId(sessionId) {
+    return sessionId.replace(/[^A-Za-z0-9._-]/g, '_');
+}
+/** Create a CC transcript mirror rooted under `dir` (default the tui dir). */
+export function createCcTranscriptMirror(options = {}) {
+    const dir = options.dir ?? defaultTuiDir();
+    let ready = false;
+    let path;
+    let watermark = 0;
+    let sessionId = '';
+    let dead = false;
+    /** Permanently disable the mirror after any fs failure (no retries). */
+    function fail() {
+        dead = true;
+        ready = false;
+        path = undefined;
+    }
+    return {
+        isReady() {
+            return ready;
+        },
+        getPath() {
+            return path;
+        },
+        rebind(nextSessionId, events) {
+            if (dead)
+                return;
+            sessionId = nextSessionId;
+            watermark = 0;
+            const lines = translateEventsToCcTranscript(events, sessionId);
+            for (const raw of events) {
+                const seq = raw?.seq;
+                if (isFiniteNumber(seq) && seq > watermark)
+                    watermark = seq;
+            }
+            // A mirror with zero assistant-usage lines would render as an all-zeros
+            // metrics object in ccstatusline and shadow truthful stdin values, so
+            // nothing is written and the payload stays without a transcript_path.
+            if (lines.every((line) => !line.includes('"type":"assistant"'))) {
+                ready = false;
+                path = undefined;
+                return;
+            }
+            try {
+                const ccDir = join(dir, 'cc-transcripts');
+                mkdirSync(ccDir, { recursive: true });
+                // GC sweep: drop mirrored files older than 30 days (best-effort).
+                try {
+                    for (const name of readdirSync(ccDir)) {
+                        if (!name.endsWith('.jsonl'))
+                            continue;
+                        const filePath = join(ccDir, name);
+                        try {
+                            if (Date.now() - statSync(filePath).mtimeMs > GC_MAX_AGE_MS)
+                                unlinkSync(filePath);
+                        }
+                        catch { /* per-entry errors are ignored */ }
+                    }
+                }
+                catch { /* sweep failures never break the rebind */ }
+                const finalPath = join(ccDir, `${sanitizeSessionId(sessionId)}.jsonl`);
+                const tmpPath = `${finalPath}.${process.pid}.${randomBytes(4).toString('hex')}.tmp`;
+                writeFileSync(tmpPath, lines.map((line) => `${line}\n`).join(''));
+                renameSync(tmpPath, finalPath);
+                ready = true;
+                path = finalPath;
+            }
+            catch {
+                fail();
+            }
+        },
+        append(event) {
+            if (!ready || path === undefined)
+                return;
+            if (typeof event !== 'object' || event === null)
+                return;
+            const seq = event.seq;
+            if (!isFiniteNumber(seq) || seq <= watermark)
+                return;
+            watermark = seq;
+            const lines = translateEventsToCcTranscript([event], sessionId);
+            if (lines.length === 0)
+                return;
+            try {
+                appendFileSync(path, lines.map((line) => `${line}\n`).join(''));
+            }
+            catch {
+                fail();
+            }
+        },
+    };
+}
+//# sourceMappingURL=statusline-cc-transcript.js.map

package/lib/harness/statusline-cc-transcript.js.map

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

package/lib/harness/statusline-command.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Status-line command runner: 300 ms-debounced execution of the configured
+ * command with the CC-shaped JSON payload on stdin. Kill-in-flight on every
+ * new trigger, generation-guarded settles (a superseded run's late result is
+ * discarded), update({ immediate: true }) bypass for settings-driven command
+ * changes, blank-on-failure (non-zero exit, killed, timeout, overrun, spawn
+ * throw, empty stdout), COLUMNS/LINES from the terminal-size getter at spawn
+ * time, a 60 s hard cap with a 64 KiB stdout cap, and a dispose that aborts,
+ * clears, and quiets.
+ * @module @dsh-cc/tui/harness/statusline-command
+ */
+import type { ShellExecutorLike } from '../state/driver-types.ts';
+/** Injectable collaborators of the status-line runner. */
+export type StatusLineCommandDeps = {
+    /** The deployment's shell executor (resolve→run seam). */
+    executor: ShellExecutorLike;
+    /** Current terminal dimensions, read at spawn time for COLUMNS/LINES. */
+    terminalSize: () => {
+        columns: number;
+        rows: number;
+    };
+    /** Notified after every generation that lands (success or blank). */
+    onSettled: (line: string) => void;
+    /** Debounce delay in ms (default 300); overridable for tests. */
+    debounceMs?: number;
+    /** Hard per-run cap in ms (default 60_000). */
+    timeoutMs?: number;
+    /** Stdout cap in bytes (default 64 KiB). */
+    stdoutMaxBytes?: number;
+};
+/** Options of {@link StatusLineCommand.update}. */
+export type StatusLineUpdateOptions = {
+    /** Skip the debounce (settings-driven `command` changes). */
+    immediate?: boolean;
+    /** Working directory for the child (defaults to the driver cwd). */
+    workdir?: string;
+};
+/** Handle of the running status-line command. */
+export type StatusLineCommand = {
+    /** Trigger a (debounced by default) run with a fresh payload. */
+    update(config: {
+        command: string;
+    }, payload: unknown, options?: StatusLineUpdateOptions): void;
+    /** The last settled rows (0–3, '\n'-joined; empty string until a run succeeds). */
+    latest(): string;
+    /** Abort in-flight, clear all timers, and make later settles no-ops. */
+    dispose(): void;
+};
+/**
+ * Create the status-line command runner. Pure with respect to the injected
+ * executor; owns exactly one debounce timer and one hard-cap timer at a time.
+ */
+export declare function createStatusLineCommand(deps: StatusLineCommandDeps): StatusLineCommand;
+//# sourceMappingURL=statusline-command.d.ts.map

package/lib/harness/statusline-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-command.d.ts","sourceRoot":"","sources":["../../src/harness/statusline-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,0BAA0B,CAAA;AAErF,0DAA0D;AAC1D,MAAM,MAAM,qBAAqB,GAAG;IAClC,0DAA0D;IAC1D,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,yEAAyE;IACzE,YAAY,EAAE,MAAM;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD,qEAAqE;IACrE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,mDAAmD;AACnD,MAAM,MAAM,uBAAuB,GAAG;IACpC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,iEAAiE;IACjE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAA;IAC9F,mFAAmF;IACnF,MAAM,IAAI,MAAM,CAAA;IAChB,wEAAwE;IACxE,OAAO,IAAI,IAAI,CAAA;CAChB,CAAA;AAWD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,CAsItF"}