@dsh-cc/tui 0.5.0

package/lib/harness/worktree-exit.d.ts

@@ -0,0 +1,105 @@
+/**
+ * `/quit` worktree cleanup support: detect whether the session cwd is a git
+ * worktree this deployment manages, gather removal evidence, and perform the
+ * removal. Everything runs through an injectable exec so tests never spawn
+ * git.
+ *
+ * Slug/path/branch conventions mirror
+ * `packages/workspace/tool-git-worktree/src/worktree.ts` and the launcher's
+ * `packages/launcher/tui/bootstrap.mjs` (`--worktree` flag) — keep all three
+ * in sync.
+ *
+ * @module @dsh-cc/tui/harness/worktree-exit
+ */
+/**
+ * Env var the launcher sets when it created the session's worktree via
+ * `--worktree`. Mirrors `WORKTREE_ENV` in packages/launcher/tui/bootstrap.mjs.
+ */
+export declare const WORKTREE_ENV = "DSH_CC_WORKTREE";
+/** Branch prefix marking dsh-cc-owned worktree branches. */
+export declare const WORKTREE_BRANCH_PREFIX = "worktree-";
+/** A successful git invocation. */
+export interface WorktreeExecResult {
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Run one git argv in `cwd`. Rejects on non-zero exit or spawn failure.
+ * Injectable so tests script the git conversation.
+ */
+export type WorktreeExec = (argv: readonly string[], cwd: string) => Promise<WorktreeExecResult>;
+/** The default exec: real `git` via execFile (no shell). */
+export declare const gitExec: WorktreeExec;
+/** A session recognized as running inside a worktree. */
+export interface WorktreeExitSession {
+    /**
+     * `managed`: created by the launcher's `--worktree` (env marker verified
+     * against the live cwd; carries `baseHead` and a guaranteed owned branch).
+     * `detected`: the session cwd happens to sit under a repo's
+     * `.claude/worktrees/` convention directory without a launcher marker.
+     */
+    readonly kind: 'managed' | 'detected';
+    /** Canonical repository root (where `.claude/worktrees` lives). */
+    readonly repoRoot: string;
+    /** Absolute worktree path (the session cwd). */
+    readonly worktreePath: string;
+    /** The branch checked out in the worktree. */
+    readonly branch: string;
+    /** Managed sessions only: the commit the worktree was created from. */
+    readonly baseHead?: string;
+}
+/** Removal evidence shown in the exit overlay before the user confirms. */
+export interface WorktreeExitEvidence {
+    /** Uncommitted changes (porcelain line count); undefined when unreadable. */
+    readonly dirtyFiles?: number;
+    /** Managed sessions only: commits on the worktree branch past baseHead. */
+    readonly commitsAhead?: number;
+}
+/** Outcome of a successful removal. */
+export interface WorktreeCleanupOutcome {
+    /** Whether the backing branch was deleted (owned branches only). */
+    readonly branchDeleted: boolean;
+}
+/** The injectable seam consumed by the driver; production wires gitExec. */
+export interface WorktreeExitHooks {
+    probe(cwd: string): Promise<WorktreeExitSession | undefined>;
+    evidence(session: WorktreeExitSession): Promise<WorktreeExitEvidence>;
+    cleanup(session: WorktreeExitSession): Promise<WorktreeCleanupOutcome>;
+}
+/**
+ * Recognize a worktree session for `/quit`. Env marker first (it must match
+ * the live cwd — an inherited marker in a subprocess running elsewhere is
+ * ignored); otherwise probe git: the session top-level must sit under the
+ * main checkout's `.claude/worktrees/` directory. Anything else (main
+ * checkout, user-managed worktrees outside the convention dir, non-git
+ * cwd) returns undefined and `/quit` keeps its plain behavior.
+ */
+export declare function detectWorktreeSession(cwd: string, env?: NodeJS.ProcessEnv, exec?: WorktreeExec): Promise<WorktreeExitSession | undefined>;
+/**
+ * Count uncommitted changes and (managed only) commits ahead of the base.
+ * Best-effort: an unreadable dimension is reported as undefined rather than
+ * failing the prompt — the user's confirmation is the removal grant.
+ */
+export declare function gatherEvidence(session: WorktreeExitSession, exec?: WorktreeExec): Promise<WorktreeExitEvidence>;
+/**
+ * Whether the removal may also delete the backing branch. Managed sessions
+ * always own theirs; detected sessions only when the branch follows the
+ * `worktree-` convention (never a user's own branch).
+ */
+export declare function ownsBranch(session: WorktreeExitSession): boolean;
+/**
+ * Remove the worktree directory and (when owned) its branch. The branch
+ * delete runs only after the worktree remove succeeds — git refuses to
+ * delete a branch checked out in a registered worktree, and a failed remove
+ * must not escalate into a branch delete. A failed branch delete after a
+ * successful remove is lint residue, not a failure: reported, not thrown.
+ *
+ * The process first chdirs to the repo root (via the injectable `chdir` —
+ * tests pass a no-op): the session cwd lives inside the directory being
+ * removed, and anything touching cwd between removal and process exit would
+ * otherwise fail.
+ */
+export declare function removeWorktree(session: WorktreeExitSession, exec?: WorktreeExec, chdir?: (dir: string) => void): Promise<WorktreeCleanupOutcome>;
+/** The production hook set backed by real git. */
+export declare function createWorktreeExitHooks(env?: NodeJS.ProcessEnv): WorktreeExitHooks;
+//# sourceMappingURL=worktree-exit.d.ts.map

package/lib/harness/worktree-exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-exit.d.ts","sourceRoot":"","sources":["../../src/harness/worktree-exit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH;;;GAGG;AACH,eAAO,MAAM,YAAY,oBAAoB,CAAA;AAE7C,4DAA4D;AAC5D,eAAO,MAAM,sBAAsB,cAAc,CAAA;AAEjD,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAEhG,4DAA4D;AAC5D,eAAO,MAAM,OAAO,EAAE,YAMrB,CAAA;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAAA;IACrC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,uCAAuC;AACvC,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAChC;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAA;IAC5D,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACrE,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACvE;AAwBD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,GAAE,YAAsB,GAC3B,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CA2B1C;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,mBAAmB,EAC5B,IAAI,GAAE,YAAsB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAsB/B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAEhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,mBAAmB,EAC5B,IAAI,GAAE,YAAsB,EAC5B,KAAK,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAgC,GACvD,OAAO,CAAC,sBAAsB,CAAC,CAUjC;AAED,kDAAkD;AAClD,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CAM/F"}

package/lib/harness/worktree-exit.js

@@ -0,0 +1,168 @@
+/**
+ * `/quit` worktree cleanup support: detect whether the session cwd is a git
+ * worktree this deployment manages, gather removal evidence, and perform the
+ * removal. Everything runs through an injectable exec so tests never spawn
+ * git.
+ *
+ * Slug/path/branch conventions mirror
+ * `packages/workspace/tool-git-worktree/src/worktree.ts` and the launcher's
+ * `packages/launcher/tui/bootstrap.mjs` (`--worktree` flag) — keep all three
+ * in sync.
+ *
+ * @module @dsh-cc/tui/harness/worktree-exit
+ */
+import { execFile } from 'node:child_process';
+import { dirname, join, resolve, sep } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * Env var the launcher sets when it created the session's worktree via
+ * `--worktree`. Mirrors `WORKTREE_ENV` in packages/launcher/tui/bootstrap.mjs.
+ */
+export const WORKTREE_ENV = 'DSH_CC_WORKTREE';
+/** Branch prefix marking dsh-cc-owned worktree branches. */
+export const WORKTREE_BRANCH_PREFIX = 'worktree-';
+/** The default exec: real `git` via execFile (no shell). */
+export const gitExec = async (argv, cwd) => {
+    const { stdout, stderr } = await execFileAsync('git', [...argv], {
+        cwd,
+        maxBuffer: 4 * 1024 * 1024,
+    });
+    return { stdout, stderr };
+};
+/** Parse the launcher's env marker; garbage is treated as absent. */
+function parseMarker(raw) {
+    if (raw === undefined || raw.length === 0)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.repoRoot !== 'string' || typeof parsed.worktreePath !== 'string'
+            || typeof parsed.branch !== 'string') {
+            return undefined;
+        }
+        return {
+            repoRoot: parsed.repoRoot,
+            worktreePath: parsed.worktreePath,
+            branch: parsed.branch,
+            ...(typeof parsed.baseHead === 'string' && parsed.baseHead.length > 0
+                ? { baseHead: parsed.baseHead }
+                : {}),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Recognize a worktree session for `/quit`. Env marker first (it must match
+ * the live cwd — an inherited marker in a subprocess running elsewhere is
+ * ignored); otherwise probe git: the session top-level must sit under the
+ * main checkout's `.claude/worktrees/` directory. Anything else (main
+ * checkout, user-managed worktrees outside the convention dir, non-git
+ * cwd) returns undefined and `/quit` keeps its plain behavior.
+ */
+export async function detectWorktreeSession(cwd, env = process.env, exec = gitExec) {
+    const marker = parseMarker(env[WORKTREE_ENV]);
+    if (marker !== undefined && resolve(marker.worktreePath) === resolve(cwd)) {
+        return { kind: 'managed', ...marker };
+    }
+    let top;
+    let commonDir;
+    try {
+        top = (await exec(['rev-parse', '--show-toplevel'], cwd)).stdout.trim();
+        commonDir = (await exec(['rev-parse', '--path-format=absolute', '--git-common-dir'], cwd)).stdout.trim();
+    }
+    catch {
+        return undefined;
+    }
+    // The common dir of a standard layout is `<mainRoot>/.git`; anything else
+    // (bare repo, exotic GIT_DIR) is not ours to reason about.
+    if (!commonDir.endsWith(`${sep}.git`))
+        return undefined;
+    const mainRoot = dirname(commonDir);
+    if (resolve(top) === resolve(mainRoot))
+        return undefined;
+    const conventionDir = join(mainRoot, '.claude', 'worktrees');
+    if (!resolve(top).startsWith(conventionDir + sep))
+        return undefined;
+    let branch = '';
+    try {
+        branch = (await exec(['rev-parse', '--abbrev-ref', 'HEAD'], top)).stdout.trim();
+    }
+    catch {
+        return undefined;
+    }
+    return { kind: 'detected', repoRoot: mainRoot, worktreePath: top, branch };
+}
+/**
+ * Count uncommitted changes and (managed only) commits ahead of the base.
+ * Best-effort: an unreadable dimension is reported as undefined rather than
+ * failing the prompt — the user's confirmation is the removal grant.
+ */
+export async function gatherEvidence(session, exec = gitExec) {
+    let dirtyFiles;
+    try {
+        const status = await exec(['status', '--porcelain'], session.worktreePath);
+        dirtyFiles = status.stdout.split('\n').filter(line => line.trim().length > 0).length;
+    }
+    catch {
+        dirtyFiles = undefined;
+    }
+    let commitsAhead;
+    if (session.baseHead !== undefined) {
+        try {
+            const revs = await exec(['rev-list', '--count', `${session.baseHead}..HEAD`], session.worktreePath);
+            const parsed = Number.parseInt(revs.stdout.trim(), 10);
+            commitsAhead = Number.isNaN(parsed) ? undefined : parsed;
+        }
+        catch {
+            commitsAhead = undefined;
+        }
+    }
+    return {
+        ...(dirtyFiles === undefined ? {} : { dirtyFiles }),
+        ...(commitsAhead === undefined ? {} : { commitsAhead }),
+    };
+}
+/**
+ * Whether the removal may also delete the backing branch. Managed sessions
+ * always own theirs; detected sessions only when the branch follows the
+ * `worktree-` convention (never a user's own branch).
+ */
+export function ownsBranch(session) {
+    return session.kind === 'managed' || session.branch.startsWith(WORKTREE_BRANCH_PREFIX);
+}
+/**
+ * Remove the worktree directory and (when owned) its branch. The branch
+ * delete runs only after the worktree remove succeeds — git refuses to
+ * delete a branch checked out in a registered worktree, and a failed remove
+ * must not escalate into a branch delete. A failed branch delete after a
+ * successful remove is lint residue, not a failure: reported, not thrown.
+ *
+ * The process first chdirs to the repo root (via the injectable `chdir` —
+ * tests pass a no-op): the session cwd lives inside the directory being
+ * removed, and anything touching cwd between removal and process exit would
+ * otherwise fail.
+ */
+export async function removeWorktree(session, exec = gitExec, chdir = dir => process.chdir(dir)) {
+    chdir(session.repoRoot);
+    await exec(['worktree', 'remove', '--force', session.worktreePath], session.repoRoot);
+    if (!ownsBranch(session))
+        return { branchDeleted: false };
+    try {
+        await exec(['branch', '-D', session.branch], session.repoRoot);
+        return { branchDeleted: true };
+    }
+    catch {
+        return { branchDeleted: false };
+    }
+}
+/** The production hook set backed by real git. */
+export function createWorktreeExitHooks(env = process.env) {
+    return {
+        probe: cwd => detectWorktreeSession(cwd, env, gitExec),
+        evidence: session => gatherEvidence(session, gitExec),
+        cleanup: session => removeWorktree(session, gitExec),
+    };
+}
+//# sourceMappingURL=worktree-exit.js.map

package/lib/harness/worktree-exit.js.map

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

package/lib/history.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Persisted composer prompt history. Prompts (not slash commands) are stored
+ * as JSON-lines under the profile data dir so ↑/↓ recall survives restarts.
+ * fs access is best-effort: a corrupt or unwritable file degrades silently to
+ * an empty history and never breaks a session.
+ *
+ * One JSON string per physical line — the encoding is unambiguous for
+ * multi-line prompts (embedded newlines are escaped by JSON.stringify, so a
+ * single entry never spans multiple physical lines). Plain-line storage would
+ * split a multi-line prompt across lines and corrupt line-based loading.
+ *
+ * @module @dsh-cc/tui/history
+ */
+/** Maximum entries retained; the oldest are dropped when exceeded. */
+export declare const HISTORY_CAP = 500;
+/** Absolute path to the history file under the data dir. */
+export declare function historyFilePath(dir?: string): string;
+/**
+ * The default `tui` data dir (`$DSH_HOME/tui` or `~/.dsh/tui`) with no
+ * override — the parent of the per-project `projects/<key>` buckets and the
+ * home of the legacy global files {@link coldCutGlobalHistory} sets aside.
+ */
+export declare function defaultTuiDir(): string;
+/**
+ * One-time migration off the pre-project *global* history files. Before
+ * history was bucketed per project, prompts and bash commands both lived in
+ * single files under `$DSH_HOME/tui` (`history.txt`, `bash-history.txt`),
+ * leaking across every directory — the very reason per-project history now
+ * exists. Those files carry no provenance, so they cannot be split back onto
+ * their projects; they are set aside as `<name>.global.bak` (a previous backup
+ * is overwritten) and each project starts its history empty. Best-effort: a
+ * missing source or unwritable dir is a silent no-op that never breaks boot.
+ *
+ * @param tuiDir the `tui` directory holding the legacy global files
+ *   (`$DSH_HOME/tui`, or `~/.dsh/tui`).
+ */
+export declare function coldCutGlobalHistory(tuiDir: string): void;
+/**
+ * Read persisted history (oldest→newest). Missing or corrupt file → `[]`;
+ * never throws.
+ */
+export declare function loadHistory(dir?: string): string[];
+/**
+ * Write the full list (capped, consecutive-duplicate suppressed) to disk as
+ * JSON-lines. Returns the normalised list so callers can keep their in-memory
+ * copy in sync with what was actually persisted. Best-effort: fs failures are
+ * swallowed (the returned list still reflects the intended state).
+ */
+export declare function saveHistory(entries: readonly string[], dir?: string): string[];
+//# sourceMappingURL=history.d.ts.map

package/lib/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,sEAAsE;AACtE,eAAO,MAAM,WAAW,MAAM,CAAA;AAa9B,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAsBzD;AAiBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAclD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAY9E"}

package/lib/history.js

@@ -0,0 +1,139 @@
+/**
+ * Persisted composer prompt history. Prompts (not slash commands) are stored
+ * as JSON-lines under the profile data dir so ↑/↓ recall survives restarts.
+ * fs access is best-effort: a corrupt or unwritable file degrades silently to
+ * an empty history and never breaks a session.
+ *
+ * One JSON string per physical line — the encoding is unambiguous for
+ * multi-line prompts (embedded newlines are escaped by JSON.stringify, so a
+ * single entry never spans multiple physical lines). Plain-line storage would
+ * split a multi-line prompt across lines and corrupt line-based loading.
+ *
+ * @module @dsh-cc/tui/history
+ */
+import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** Maximum entries retained; the oldest are dropped when exceeded. */
+export const HISTORY_CAP = 500;
+/**
+ * Resolve the data directory (the `tui` dir). An injected `dir` overrides;
+ * otherwise mirrors {@link resume-target} resolution: `$DSH_HOME/tui` or
+ * `~/.dsh/tui`.
+ */
+function dataDir(dir) {
+    if (dir !== undefined)
+        return dir;
+    const dshHome = process.env.DSH_HOME ?? join(homedir(), '.dsh');
+    return join(dshHome, 'tui');
+}
+/** Absolute path to the history file under the data dir. */
+export function historyFilePath(dir) {
+    return join(dataDir(dir), 'history.txt');
+}
+/**
+ * The default `tui` data dir (`$DSH_HOME/tui` or `~/.dsh/tui`) with no
+ * override — the parent of the per-project `projects/<key>` buckets and the
+ * home of the legacy global files {@link coldCutGlobalHistory} sets aside.
+ */
+export function defaultTuiDir() {
+    return dataDir();
+}
+/**
+ * One-time migration off the pre-project *global* history files. Before
+ * history was bucketed per project, prompts and bash commands both lived in
+ * single files under `$DSH_HOME/tui` (`history.txt`, `bash-history.txt`),
+ * leaking across every directory — the very reason per-project history now
+ * exists. Those files carry no provenance, so they cannot be split back onto
+ * their projects; they are set aside as `<name>.global.bak` (a previous backup
+ * is overwritten) and each project starts its history empty. Best-effort: a
+ * missing source or unwritable dir is a silent no-op that never breaks boot.
+ *
+ * @param tuiDir the `tui` directory holding the legacy global files
+ *   (`$DSH_HOME/tui`, or `~/.dsh/tui`).
+ */
+export function coldCutGlobalHistory(tuiDir) {
+    const moves = {
+        'history.txt': 'history.global.bak',
+        'bash-history.txt': 'bash-history.global.bak',
+    };
+    for (const [from, to] of Object.entries(moves)) {
+        const src = join(tuiDir, from);
+        const dst = join(tuiDir, to);
+        // Drop any prior backup (POSIX rename would overwrite it, Windows refuses
+        // to — clearing first makes both platforms behave the same), then move the
+        // legacy global file aside. Missing source is the common no-op.
+        try {
+            rmSync(dst, { force: true });
+        }
+        catch {
+            // Unwritable — best-effort.
+        }
+        try {
+            renameSync(src, dst);
+        }
+        catch {
+            // Missing source (or unwritable dir) — best-effort, never break boot.
+        }
+    }
+}
+/**
+ * Normalise an entry list: drop empty/whitespace-only entries, suppress
+ * consecutive duplicates, and cap to {@link HISTORY_CAP} (keeping the newest).
+ */
+function normalize(entries) {
+    const out = [];
+    for (const entry of entries) {
+        if (typeof entry !== 'string')
+            continue;
+        if (entry.length === 0 || entry.trim().length === 0)
+            continue;
+        if (out.length > 0 && out[out.length - 1] === entry)
+            continue;
+        out.push(entry);
+    }
+    return out.slice(-HISTORY_CAP);
+}
+/**
+ * Read persisted history (oldest→newest). Missing or corrupt file → `[]`;
+ * never throws.
+ */
+export function loadHistory(dir) {
+    try {
+        const content = readFileSync(historyFilePath(dir), 'utf8');
+        const lines = content.split('\n');
+        const entries = [];
+        for (const line of lines) {
+            if (line.length === 0)
+                continue;
+            const parsed = JSON.parse(line);
+            if (typeof parsed === 'string' && parsed.length > 0)
+                entries.push(parsed);
+        }
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Write the full list (capped, consecutive-duplicate suppressed) to disk as
+ * JSON-lines. Returns the normalised list so callers can keep their in-memory
+ * copy in sync with what was actually persisted. Best-effort: fs failures are
+ * swallowed (the returned list still reflects the intended state).
+ */
+export function saveHistory(entries, dir) {
+    const normalized = normalize(entries);
+    try {
+        mkdirSync(dataDir(dir), { recursive: true });
+        const content = normalized.length === 0
+            ? ''
+            : `${normalized.map(entry => JSON.stringify(entry)).join('\n')}\n`;
+        writeFileSync(historyFilePath(dir), content);
+    }
+    catch {
+        // Persistence is best-effort; never break the session over a write.
+    }
+    return normalized;
+}
+//# sourceMappingURL=history.js.map

package/lib/history.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Cordis plugin surface for the CC-mode TUI. Heavy wiring lives behind a
+ * dynamic import so a boot failure is a plugin error, not a module-load crash.
+ * @module @dsh-cc/tui
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import Schema from '@deepseek-ai/schemastery';
+import type { ThemeOverrides } from './components/theme.ts';
+export declare const name = "dsh-cc-tui";
+export declare const inject: string[];
+export interface Config {
+    cwd?: string;
+    agentPreset?: string;
+    sessionId?: string;
+    /**
+     * Allow boot-time resume from the project's resume marker. When true (and
+     * `sessionId` is not set), the TUI reads `projects/<projectKey>/resume.txt`
+     * on boot and attaches the most recent session of this project. The
+     * `dsh-cc` launcher sets this for a bare `dsh-cc` launch; false/undefined
+     * default to a fresh session.
+     */
+    autoResume?: boolean;
+    /**
+     * `-c`/`--continue` was requested. Only affects the "no previous session
+     * to continue" notice when `autoResume` finds no marker — it does not force
+     * a resume by itself.
+     */
+    continueRequested?: boolean;
+    provider?: string;
+    model?: string;
+    allowNoTty?: boolean;
+    /**
+     * Terminal surface mode. 'regular' renders inline into the main screen
+     * scrollback; 'fullscreen' takes over the alternate screen on start with a
+     * docked layout. Plugin-level default is 'regular' — the
+     * cc-tui bundle profile pins 'fullscreen' for fullscreen-on-entry.
+     */
+    uiMode?: 'regular' | 'fullscreen';
+    /**
+     * Fullscreen-only: capture the mouse for viewport scrolling and
+     * application-owned text selection (OSC 52 copy). Default true.
+     */
+    mouse?: boolean;
+    /**
+     * Per-role palette overrides for the terminal theme. Every role accepts a
+     * basic ANSI color name ('red', 'brightCyan') or a raw SGR code string
+     * ('31', '1;31'); unknown values silently fall back to the built-in
+     * default, so omitting a role (or the whole block) keeps the default look.
+     */
+    theme?: ThemeOverrides;
+}
+export declare const Config: Schema<Config>;
+/**
+ * Effective UI mode. Precedence: the DSH_CCTUI_UI_MODE env beats plugin
+ * config, config beats the 'regular' default. The env is the instant escape
+ * hatch when a profile pins fullscreen and the terminal cannot cope.
+ */
+export declare function resolveUiMode(config: Config): 'regular' | 'fullscreen';
+/**
+ * Mount the terminal surface. Requires a TTY unless `allowNoTty`.
+ */
+export declare function apply(ctx: Context, config: Config): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAG3D,eAAO,MAAM,IAAI,eAAe,CAAA;AAChC,eAAO,MAAM,MAAM,UAAa,CAAA;AAEhC,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,YAAY,CAAA;IACjC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;OAKG;IACH,KAAK,CAAC,EAAE,cAAc,CAAA;CACvB;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CAmBhC,CAAA;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAItE;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASvE"}

package/lib/index.js

@@ -0,0 +1,54 @@
+/**
+ * Cordis plugin surface for the CC-mode TUI. Heavy wiring lives behind a
+ * dynamic import so a boot failure is a plugin error, not a module-load crash.
+ * @module @dsh-cc/tui
+ */
+import Schema from '@deepseek-ai/schemastery';
+import { resolveDshProfile } from "./profile.js";
+export const name = 'dsh-cc-tui';
+export const inject = ['agents'];
+export const Config = Schema.object({
+    cwd: Schema.string(),
+    agentPreset: Schema.string(),
+    sessionId: Schema.string(),
+    autoResume: Schema.boolean(),
+    continueRequested: Schema.boolean(),
+    provider: Schema.string(),
+    model: Schema.string(),
+    allowNoTty: Schema.boolean(),
+    uiMode: Schema.union([Schema.const('regular'), Schema.const('fullscreen')]),
+    mouse: Schema.boolean(),
+    theme: Schema.object({
+        accent: Schema.string(),
+        success: Schema.string(),
+        error: Schema.string(),
+        warning: Schema.string(),
+        muted: Schema.string(),
+        highlight: Schema.string(),
+    }),
+});
+/**
+ * Effective UI mode. Precedence: the DSH_CCTUI_UI_MODE env beats plugin
+ * config, config beats the 'regular' default. The env is the instant escape
+ * hatch when a profile pins fullscreen and the terminal cannot cope.
+ */
+export function resolveUiMode(config) {
+    const env = process.env.DSH_CCTUI_UI_MODE;
+    if (env === 'fullscreen' || env === 'regular')
+        return env;
+    return config.uiMode === 'fullscreen' ? 'fullscreen' : 'regular';
+}
+/**
+ * Mount the terminal surface. Requires a TTY unless `allowNoTty`.
+ */
+export async function apply(ctx, config) {
+    const allowNoTty = config.allowNoTty === true || process.env.DSH_CCTUI_ALLOW_NO_TTY === '1';
+    if (!allowNoTty && !process.stdout.isTTY) {
+        throw new Error('dsh-cc-tui requires an interactive terminal (stdout must be a TTY).');
+    }
+    ctx.provide('dshProfile', resolveDshProfile());
+    process.env.NODE_ENV ??= 'production';
+    const { mountTui } = await import("./plugin.js");
+    await mountTui(ctx, { ...config, uiMode: resolveUiMode(config) });
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAE7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD,MAAM,CAAC,MAAM,IAAI,GAAG,YAAY,CAAA;AAChC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAA;AA4ChC,MAAM,CAAC,MAAM,MAAM,GAAmB,MAAM,CAAC,MAAM,CAAC;IAClD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;IAC1B,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE;IAC5B,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;IACtB,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE;IAC5B,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC3E,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;KAC3B,CAAC;CACH,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAA;IACzC,IAAI,GAAG,KAAK,YAAY,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAA;IACzD,OAAO,MAAM,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAA;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,GAAY,EAAE,MAAc;IACtD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,GAAG,CAAA;IAC3F,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAA;IACxF,CAAC;IACD,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,iBAAiB,EAAE,CAAC,CAAA;IAC9C,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAA;IACrC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;IAChD,MAAM,QAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACnE,CAAC"}