@martintrojer/mu 0.4.0 → 0.4.2

package/dist/index.d.ts

@@ -62,13 +62,13 @@ declare class SchemaTooOldError extends Error implements HasNextSteps {
     constructor(detectedVersion: number, requiredVersion: number);
     errorNextSteps(): NextStep[];
 }
-/** The schema version a fresh DB starts at. v7 drops the
- *  `approvals` table on top of v6 (which added 5 archive_* tables
- *  on top of v5's surrogate-PK substrate; docs/ARCHITECTURE.md §
- *  Surrogate-PK + SDK-boundary discipline). The refusal floor is
- *  v5 — pre-v5 DBs throw `SchemaTooOldError`; v5 → v6 → v7 DBs
- *  are forward-bumped in place by `applySchema`. */
-declare const CURRENT_SCHEMA_VERSION = 7;
+/** The schema version a fresh DB starts at. v8 adds the
+ *  machine_identity and workstream_sync sync substrate on top of v7
+ *  (which dropped the approvals table), v6 (which added 5 archive_*
+ *  tables), and v5's surrogate-PK substrate. The refusal floor is
+ *  v5 — pre-v5 DBs throw `SchemaTooOldError`; v5+ DBs are
+ *  forward-bumped in place by `applySchema`. */
+declare const CURRENT_SCHEMA_VERSION = 8;
 /** Tables a healthy DB must contain. Single source of truth so
  *  `mu doctor` and any other consumer don't drift. Adding a new table
  *  = one new entry here AND a CREATE TABLE in CURRENT_SCHEMA. (Schema
@@ -471,23 +471,11 @@ declare namespace tmux$1 {
 /**
  * What kind of reconciliation pass to run.
  *
- *   "full"        Default for `mu agent list`. Prunes ghosts (deleting
- *                 the registry row, which fires the deleteAgent reaper
- *                 that flips IN_PROGRESS tasks back to OPEN with
- *                 [reaper] notes), runs status detection against
- *                 surviving panes, surfaces orphans.
- *
- *   "status-only" The "freshen the operator's view" mode. Runs status
- *                 detection (DB writes that update agent status +
- *                 pane title — desired side-effects of a refresh) and
- *                 orphan surface. Does NOT prune (so a dead pane's
- *                 row stays visible until a real `mu agent list`) and
- *                 does NOT reap. Used by `mu state` and
- *                 `mu agent attach` — the verbs an operator polls to
- *                 answer "is worker-X busy or idle right
- *                 now?". Status detection skips placeholder agents
- *                 whose pane id starts with `%pending-` (mid-spawn,
- *                 no usable scrollback yet).
+ *   "full"        Default for `mu state` and `mu agent list`. Prunes
+ *                 ghosts (deleting the registry row, which fires the
+ *                 deleteAgent reaper that flips IN_PROGRESS tasks back
+ *                 to OPEN with [reaper] notes), runs status detection
+ *                 against surviving panes, surfaces orphans.
  *
  *   "report-only" Pure observation. Counts would-be-pruned ghosts
  *                 without deleting; skips status detection entirely
@@ -498,13 +486,11 @@ declare namespace tmux$1 {
  *                 snap_undo_reconcile_destroys_recovered_agents) and
  *                 `mu doctor` (read-only diagnostic).
  *
- * Surfaced live by bug_pane_title_glyph_stuck_at_needs_input: the
- * old `dryRun: boolean` flag conflated "don't prune" with "don't
- * detect status", so state-card pollers showed stale status
- * indefinitely. Splitting prune-suppression from status-suppression
- * is the fix.
+ * Mid-spawn placeholders are protected directly in the prune loop, so read
+ * paths no longer need a separate mode just to avoid racing spawn's workspace
+ * pre-stage.
  */
-type ReconcileMode = "full" | "status-only" | "report-only";
+type ReconcileMode = "full" | "report-only";
 interface ReconcileOptions {
     /** The workstream whose registry rows we're reconciling. */
     workstream: string;
@@ -526,9 +512,9 @@ interface ReconcileOptions {
     mode?: ReconcileMode;
 }
 interface ReconcileReport {
-    /** Number of registry rows whose pane was gone. In status-only and
-     *  report-only modes this is the count of rows that WOULD have
-     *  been pruned; in `full` mode it's the count actually deleted. */
+    /** Number of registry rows whose pane was gone. In `report-only` mode
+     *  this is the count of rows that WOULD have been pruned; in `full`
+     *  mode it's the count actually deleted. */
     prunedGhosts: number;
     /** Number of agents whose status was changed by scrollback detection.
      *  Always 0 in `report-only` mode (status detection is skipped). */
@@ -1287,6 +1273,9 @@ declare function updateAgentStatus(db: Db, name: string, status: AgentStatus, wo
  *  initial render before status detection runs, and 'spawning' is a
  *  transient state. */
 declare const STATUS_EMOJI: Record<AgentStatus, string>;
+/** Single rendering helper for agent status glyphs. Keep callers off
+ *  STATUS_EMOJI indexing so glyph fallback policy stays centralised. */
+declare function agentStatusGlyph(status: AgentStatus): string;
 /** Build the pane title for `agent` based on current DB state.
  *  Pure (no tmux side effect; no DB write). Read-only on the DB. */
 declare function composeAgentTitle(db: Db, agent: AgentRow): string;
@@ -1411,22 +1400,16 @@ interface ListLiveAgentsOptions {
     /**
      * Which kind of reconciliation pass to run. Forwarded to
      * `reconcile()`'s same-name option. Default `"full"` (the
-     * documented mutating behaviour `mu agent list` has always had).
+     * documented mutating behaviour `mu agent list` has always had,
+     * now also used by `mu state` and `mu agent attach`).
      *
-     * Read-only callers split two ways:
-     *   - `mu state`, `mu agent attach` →
-     *     `"status-only"`: refresh status + title (writes to DB),
-     *     skip prune + reap. The operator's primary signal
-     *     (busy/needs_input) stays fresh without a periodic poll
-     *     racing in-flight spawns.
-     *   - `mu doctor`, `mu undo` → `"report-only"`: count drift,
-     *     mutate nothing. `mu undo` MUST use this so a post-restore
-     *     reconcile doesn't delete the rows the snapshot just
-     *     restored (snap_undo_reconcile_destroys_recovered_agents).
+     * `mu doctor` and `mu undo` pass `"report-only"`: count drift,
+     * mutate nothing. `mu undo` MUST use this so a post-restore
+     * reconcile doesn't delete the rows the snapshot just restored
+     * (snap_undo_reconcile_destroys_recovered_agents).
      *
-     * Skipping prune is what protects mid-spawn placeholders (pane
-     * id `%pending-<name>`) from being treated as ghosts and pruned
-     * out from under `createWorkspace`'s FK insert
+     * Mid-spawn placeholders (pane id `%pending-<name>`) are protected
+     * directly in reconcile's prune loop, independent of mode
      * (bug_agent_spawn_workspace_fk_failure).
      *
      * BREAKING: this replaces the previous `dryRun?: boolean`
@@ -1445,11 +1428,10 @@ interface LiveAgentsView {
 }
 /**
  * Return the live, reality-reconciled view of agents in a workstream.
- * `mu agent list` calls this with `mode: "full"` (mutating); status
- * pollers (`mu state`, `mu agent attach`) call it with
- * `mode: "status-only"` to refresh status without pruning; read-only
- * diagnostic / restore paths (`mu doctor`, `mu undo`) call it with
- * `mode: "report-only"` to mutate nothing at all.
+ * `mu state`, `mu agent list`, and `mu agent attach` call this with the
+ * default `mode: "full"` (mutating); read-only diagnostic / restore paths
+ * (`mu doctor`, `mu undo`) call it with `mode: "report-only"` to mutate
+ * nothing at all.
  */
 declare function listLiveAgents(db: Db, opts: ListLiveAgentsOptions): Promise<LiveAgentsView>;
 
@@ -1636,6 +1618,26 @@ interface SearchArchivesOptions {
 /** LIKE-search archived task titles AND archived note content. */
 declare function searchArchives(db: Db, opts: SearchArchivesOptions): ArchiveSearchHit[];
 
+declare class ArchiveSourceAmbiguousError extends Error implements HasNextSteps {
+    readonly label: string;
+    readonly sources: readonly string[];
+    readonly name = "ArchiveSourceAmbiguousError";
+    constructor(label: string, sources: readonly string[]);
+    errorNextSteps(): NextStep[];
+}
+interface RestoreArchiveOptions {
+    sourceWorkstream?: string;
+}
+interface RestoreArchiveResult {
+    archiveLabel: string;
+    sourceWorkstream: string;
+    workstreamName: string;
+    restoredTasks: number;
+    restoredEdges: number;
+    restoredNotes: number;
+}
+declare function restoreArchive(db: Db, label: string, asWorkstream: string, opts?: RestoreArchiveOptions): RestoreArchiveResult;
+
 type TaskStatus = "OPEN" | "IN_PROGRESS" | "CLOSED" | "REJECTED" | "DEFERRED";
 /** Every legal task status, in canonical order (matches the schema
  *  CHECK clause). Exported so CLI surfaces (`--status` validators,
@@ -2860,6 +2862,164 @@ declare function loadFullDag(db: Db, workstream: string, opts?: LoadFullDagOptio
 declare function renderForest(roots: readonly TaskRow[], edges: ReadonlyMap<string, readonly string[]>, statusFn: TaskStatusLabelFn, tasksByName?: ReadonlyMap<string, TaskRow>, opts?: RenderTreeOptions): string;
 declare function renderTaskTree(db: Db, workstream: string, root: TaskRow, direction: "blockers" | "dependents", statusFn: TaskStatusLabelFn, opts?: RenderTreeOptions): string;
 
+declare class DbReplayWorkstreamMissingError extends Error implements HasNextSteps {
+    readonly workstream: string;
+    readonly name = "DbReplayWorkstreamMissingError";
+    constructor(workstream: string);
+    errorNextSteps(): NextStep[];
+}
+interface DbReplayTaskConflict {
+    localId: string;
+    local: {
+        title: string;
+        status: string;
+    };
+    sidecar: {
+        title: string;
+        status: string;
+    };
+}
+declare class DbReplayLocalIdConflictError extends Error implements HasNextSteps {
+    readonly workstream: string;
+    readonly conflicts: readonly DbReplayTaskConflict[];
+    readonly name = "DbReplayLocalIdConflictError";
+    constructor(workstream: string, conflicts: readonly DbReplayTaskConflict[]);
+    errorNextSteps(): NextStep[];
+}
+interface ReplayDbOptions {
+    apply?: boolean;
+    tasks?: readonly string[];
+    notes?: readonly string[];
+    all?: boolean;
+}
+interface DbReplayTaskItem {
+    localId: string;
+    title: string;
+    status: string;
+    impact: number;
+    effortDays: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface DbReplayNoteItem {
+    taskLocalId: string;
+    author: string | null;
+    content: string;
+    createdAt: string;
+    hash: string;
+}
+interface DbReplayEdgeItem {
+    fromLocalId: string;
+    toLocalId: string;
+    createdAt: string;
+}
+interface DbReplayPlan {
+    sourceFile: string;
+    workstream: string;
+    tasks: DbReplayTaskItem[];
+    notes: DbReplayNoteItem[];
+    edges: DbReplayEdgeItem[];
+    conflicts: DbReplayTaskConflict[];
+}
+interface DbReplayResult extends DbReplayPlan {
+    dryRun: boolean;
+    applied: boolean;
+    snapshotId?: number;
+    added: {
+        tasks: number;
+        notes: number;
+        edges: number;
+    };
+    warnings: string[];
+}
+declare function replayDb(db: Db, file: string, opts?: ReplayDbOptions): DbReplayResult;
+declare function buildReplayPlan(localDb: Db, sidecarDb: Db, sourceFile: string): DbReplayPlan;
+
+interface DbExportManifestWorkstream {
+    name: string;
+    tasks: number;
+    edges: number;
+    notes: number;
+    latestSeq: number;
+}
+interface DbExportManifest {
+    muVersion: string;
+    schemaVersion: number;
+    machineId: string;
+    hostname: string | null;
+    exportedAt: string;
+    workstreams: DbExportManifestWorkstream[];
+}
+interface ExportDbOptions {
+    force?: boolean;
+}
+interface ExportDbResult {
+    file: string;
+    manifestPath: string;
+    manifest: DbExportManifest;
+    overwritten: boolean;
+}
+declare class DbExportTargetExistsError extends Error implements HasNextSteps {
+    readonly file: string;
+    readonly name = "DbExportTargetExistsError";
+    constructor(file: string);
+    errorNextSteps(): NextStep[];
+}
+declare class DbImportManifestMissingError extends Error implements HasNextSteps {
+    readonly manifestPath: string;
+    readonly name = "DbImportManifestMissingError";
+    constructor(manifestPath: string);
+    errorNextSteps(): NextStep[];
+}
+declare class DbImportSchemaTooOldError extends Error implements HasNextSteps {
+    readonly sourceVersion: number;
+    readonly name = "DbImportSchemaTooOldError";
+    constructor(sourceVersion: number);
+    errorNextSteps(): NextStep[];
+}
+declare class DbImportSchemaTooNewError extends Error implements HasNextSteps {
+    readonly sourceVersion: number;
+    readonly name = "DbImportSchemaTooNewError";
+    constructor(sourceVersion: number);
+    errorNextSteps(): NextStep[];
+}
+declare class DbImportSourceStaleError extends Error implements HasNextSteps {
+    readonly workstreams: readonly string[];
+    readonly name = "DbImportSourceStaleError";
+    constructor(workstreams: readonly string[]);
+    errorNextSteps(): NextStep[];
+}
+declare class DbImportConflictError extends Error implements HasNextSteps {
+    readonly workstreams: readonly string[];
+    readonly name = "DbImportConflictError";
+    constructor(workstreams: readonly string[]);
+    errorNextSteps(): NextStep[];
+}
+type DbImportDecision = "IDENTICAL" | "FAST_FORWARD" | "LOCAL_AHEAD" | "CONFLICT" | "IMPORT" | "LEAVE_ALONE";
+interface DbImportSummaryItem {
+    workstream: string;
+    decision: DbImportDecision;
+    delta: Record<string, unknown>;
+    needs?: string;
+    parkPath?: string;
+}
+interface ImportDbOptions {
+    apply?: boolean;
+    forceSource?: boolean;
+    onlyWorkstreams?: readonly string[];
+}
+interface ImportDbResult {
+    machineId: string;
+    sourceFile: string;
+    dryRun: boolean;
+    applied: boolean;
+    snapshotId?: number;
+    summary: DbImportSummaryItem[];
+}
+declare function exportDb(db: Db, file: string, opts?: ExportDbOptions): ExportDbResult;
+declare function importDb(db: Db, file: string, opts?: ImportDbOptions): ImportDbResult;
+declare function buildImportPlan(localDb: Db, manifest: DbExportManifest, sourceFile: string, onlyWorkstreams?: readonly string[]): DbImportSummaryItem[];
+
 interface Track {
     /** Goal tasks (no outgoing edges) belonging to this track. */
     roots: TaskRow[];
@@ -3011,6 +3171,12 @@ declare function exportArchive(db: Db, opts: ExportArchiveOptions): ExportArchiv
 declare function isValidWorkstreamName(name: string): boolean;
 /** Thrown by `ensureWorkstream` and `mu workstream init` when the name
  *  doesn't match the rules. */
+declare class WorkstreamExistsError extends Error implements HasNextSteps {
+    readonly workstream: string;
+    readonly name: string;
+    constructor(workstream: string);
+    errorNextSteps(): NextStep[];
+}
 declare class WorkstreamNameInvalidError extends Error implements HasNextSteps {
     readonly attempted: string;
     readonly name = "WorkstreamNameInvalidError";
@@ -3058,6 +3224,15 @@ interface WorkstreamSummary {
      *  otherwise such rows are orphaned forever (the previous
      *  `nothingToDo` heuristic short-circuited on them). */
     registered: boolean;
+    /** "Presumed parked on another machine" derived signal. Present
+     *  iff `parkedStatus(db, name)` reports `parked: true` (most recent
+     *  agent_logs row is a `db export` event, no alive agents, no
+     *  IN_PROGRESS tasks, threshold elapsed). Consumed by
+     *  `mu workstream list` and the TUI tab strip / workstreams card.
+     *  See src/parked.ts. */
+    parked?: {
+        sinceDays: number;
+    };
 }
 interface DestroyResult {
     /** True iff `tmux kill-session` actually killed something. */
@@ -3168,82 +3343,6 @@ interface ExportResult {
  */
 declare function exportWorkstream(db: Db, opts: ExportWorkstreamOptions): ExportResult;
 
-declare class ImportBucketInvalidError extends Error implements HasNextSteps {
-    readonly bucketDir: string;
-    readonly reason: string;
-    readonly name = "ImportBucketInvalidError";
-    constructor(bucketDir: string, reason: string);
-    errorNextSteps(): NextStep[];
-}
-declare class WorkstreamAlreadyExistsError extends Error implements HasNextSteps {
-    readonly workstream: string;
-    readonly name = "WorkstreamAlreadyExistsError";
-    constructor(workstream: string);
-    errorNextSteps(): NextStep[];
-}
-declare class ImportFrontmatterParseError extends Error implements HasNextSteps {
-    readonly path: string;
-    readonly line: number;
-    readonly raw: string;
-    readonly name = "ImportFrontmatterParseError";
-    constructor(path: string, line: number, raw: string);
-    errorNextSteps(): NextStep[];
-}
-declare class ImportEdgeRefMissingError extends Error implements HasNextSteps {
-    readonly fromTask: string;
-    readonly toTask: string;
-    readonly direction: "blocked_by" | "blocks";
-    readonly name = "ImportEdgeRefMissingError";
-    constructor(fromTask: string, toTask: string, direction: "blocked_by" | "blocks");
-    errorNextSteps(): NextStep[];
-}
-interface ImportBucketOptions {
-    bucketDir: string;
-    /** Rename the (single) source workstream on import. Only valid when
-     *  the bucket has exactly one source-ws subdir (after applying any
-     *  `sourceWs` filter); otherwise rejected with an
-     *  ImportBucketInvalidError. */
-    workstreamOverride?: string;
-    /** Restrict the import to a subset of source-ws subdirs (by name).
-     *  Each name must be a key in the bucket manifest's `sources` map;
-     *  otherwise ImportSourceNotInBucketError is raised. Mutually
-     *  exclusive with the per-source-ws-subdir invocation form (Form 1):
-     *  passing this flag against a Form 1 path raises
-     *  ImportBucketInvalidError. Empty array is treated as "no filter";
-     *  the CLI rejects an explicitly-empty `--source-ws ,,`. */
-    sourceWs?: string[];
-    /** Walk + parse but write nothing to the DB. */
-    dryRun?: boolean;
-}
-interface ImportSourceResult {
-    workstreamName: string;
-    tasksImported: number;
-    edgesImported: number;
-    notesImported: number;
-    tombstonesSkipped: number;
-    /** Per-source-ws errors that did NOT roll back this source. Empty
-     *  on success. (Sibling failures live in their own entry.) */
-    errors: string[];
-}
-interface ImportBucketResult {
-    bucketLabel: string | null;
-    bucketVersion: number;
-    sources: ImportSourceResult[];
-}
-/**
- * Import a v0.3 bucket directory back into the DB. One source-ws
- * subdirectory becomes one workstream + N tasks + M edges + K notes.
- * Per source-ws transactional: a failure in source A rolls back A
- * but leaves source B's import committed.
- *
- * Throws on unrecoverable bucket-level errors (no manifest,
- * --workstream override against multi-source). Per-source
- * errors (frontmatter parse, edge ref, target name collision) leave
- * the failing source's `errors` array populated and that source's
- * counts at zero; siblings still attempt their own import.
- */
-declare function importBucket(db: Db, opts: ImportBucketOptions): ImportBucketResult;
-
 type LogKind = "message" | "event" | "broadcast" | string;
 interface LogRow {
     /** Monotonic AUTOINCREMENT id. Use as the cursor for `--since`. */
@@ -3300,7 +3399,7 @@ declare function listLogs(db: Db, opts?: ListLogsOptions): LogRow[];
  * by `mu log --tail` to start the cursor at "now" so the subscriber
  * only sees NEW entries unless they explicitly pass `--since 0`.
  */
-declare function latestSeq(db: Db): number;
+declare function latestSeq(db: Db, workstreamId?: number): number;
 /**
  * One-line helper for state-changing SDK functions to auto-emit a
  * `kind='event'` log entry. Called AFTER the mutation succeeds, only
@@ -3483,8 +3582,9 @@ declare function loadWorkstreamSnapshotFast(db: Db, workstream: string, opts?: L
  * doctor, which reports over those slow-tier observations). Returns only the
  * fields the fast snapshot deliberately leaves empty or undecorated.
  *
- * status-only refresh: don't prune mid-spawn placeholders or reap
- * unreachable agents — every render-mode is a polling read surface.
+ * The slow snapshot tier runs full reconciliation: missing panes are
+ * reaped, while mid-spawn placeholders remain protected by the prune
+ * loop's pending-pane guard.
  */
 declare function loadWorkstreamSnapshotSlow(db: Db, workstream: string, opts?: LoadWorkstreamSnapshotOptions, baseSnapshot?: WorkstreamSnapshot): Promise<WorkstreamSnapshotSlowFields>;
 /** Merge the latest slow-tier subprocess observations into a fresh fast tier. */
@@ -3619,4 +3719,36 @@ declare function deleteSnapshot(db: Db, snapshotId: number): DeleteSnapshotResul
 
 declare function restoreSnapshot(db: Db, snapshotId: number): RestoreSnapshotResult;
 
-export { type AddNoteOptions, type AddTaskOptions, type AddToArchiveResult, type AdoptAgentOptions, type AdoptAgentResult, AgentDiedOnSpawnError, AgentExistsError, AgentNotFoundError, AgentNotInWorkstreamError, type AgentRow, AgentSpawnCliNotFoundError, AgentSpawnStartupError, type AgentStatus, type AppendLogOptions, type Archive, ArchiveAlreadyExistsError, ArchiveLabelInvalidError, ArchiveNotFoundError, type ArchiveSearchHit, type ArchiveSourceSummary, type ArchiveSummary, type ArchivedTaskRow, type BlockEdgeResult, CURRENT_SCHEMA_VERSION, type CaptureOptions, type CaptureSnapshotResult, type ClaimResult, type ClaimTaskOptions, ClaimerNotRegisteredError, type ClassifiedEvent, type CloseAgentOptions, type CloseAgentResult, type CommandResolutionResult, type CommandResolver, CrossWorkstreamEdgeError, CycleError, type Db, type DeleteSnapshotResult, type DeleteTaskResult, type DestroyResult, type DetectedStatus, type DoctorCheck, type DoctorStatus, type DoctorSummary, EVENT_VERB_PREFIXES, EXPECTED_TABLES, type EvidenceOption, type ExportArchiveOptions, type ExportArchiveResult, type ExportManifest, type ExportResult, type ExportSource, type ExportSourceManifest, type ExportTaskEntry, type ExportWorkstreamOptions, type FreeAgentResult, type FullDag, HomeDirAsProjectRootError, type IdFromTitleResult, ImportBucketInvalidError, type ImportBucketOptions, type ImportBucketResult, ImportEdgeRefMissingError, ImportFrontmatterParseError, type ImportSourceResult, type InsertAgentInput, type KickAgentOptions, type KickAgentResult, type KickProcessExecutor, type KickSignal, type ListArchivedTasksOptions, type ListLiveAgentsOptions, type ListLogsOptions, type ListNotesOptions, type ListReadyOptions, type ListSnapshotsOptions, type ListTasksOptions, type LiveAgentsView, type LoadFullDagOptions, type LoadWorkstreamSnapshotOptions, type LogKind, type LogRow, type NewSessionOptions, type NewWindowOptions, NoForegroundProcessError, type OpenDbOptions, type OwnedTasksSummary, PANE_ID_RE, PaneNotFoundError, type PruneMode, type PruneOptions, PruneOptionsInvalidError, type PruneResult, type ReconcileMode, type ReconcileOptions, type ReconcileReport, type RejectDeferOptions, type RejectDeferResult, type ReleaseResult, type ReleaseTaskOptions, type RemoveBlockEdgeResult, type RemoveFromArchiveResult, type RenderBucketInput, type RenderBucketResult, type ReparentTaskResult, type RestoreSnapshotResult, type RoiBucket, STATUSES_TERMINAL_OR_PARKED, STATUS_EMOJI, SchemaTooOldError, type SearchArchivesOptions, type SearchTasksOptions, type SendOptions, type SetStatusResult, type SlugifyResult, SnapshotFileMissingError, SnapshotNotFoundError, type SnapshotRow, SnapshotVersionMismatchError, type SpawnAgentOptions, type SplitWindowOptions, type StrandedWorkspaceOrphan, TASK_STATUSES, TASK_STATUS_LIST, TaskAlreadyOwnedError, type TaskEdgeWithStatus, type TaskEdges, type TaskEdgesWithStatus, TaskExistsError, TaskHasOpenDependentsError, TaskNotFoundError, TaskNotInWorkstreamError, type TaskNoteRow, type TaskRow, type TaskStatus, type TaskWaitOptions, type TaskWaitRef, type TaskWaitResult, type TaskWaitTaskState, TmuxError, type TmuxExecResult, type TmuxExecutor, type TmuxPane, type TmuxSession, type TmuxWindow, type Track, type UpdateTaskOptions, type UpdateTaskResult, type VcsBackend, type VcsBackendName, type CreateWorkspaceOptions$1 as VcsCreateWorkspaceOptions, type CreateWorkspaceResult as VcsCreateWorkspaceResult, type FreeWorkspaceOptions$1 as VcsFreeWorkspaceOptions, type FreeWorkspaceResult$1 as VcsFreeWorkspaceResult, WORKSPACE_STALE_THRESHOLD, type CreateWorkspaceOptions as WorkspaceCreateOptions, WorkspaceExistsError, type WorkspaceFailure, type FreeWorkspaceOptions as WorkspaceFreeOptions, type FreeWorkspaceResult as WorkspaceFreeResult, WorkspaceNotFoundError, type WorkspaceOrphan, WorkspacePathNotEmptyError, WorkspacePreservedError, type RecreateWorkspaceOptions as WorkspaceRecreateOptions, type RecreateWorkspaceResult as WorkspaceRecreateResult, type WorkspaceRow, type WorkspaceStaleness, WorkstreamAlreadyExistsError, WorkstreamNameInvalidError, type WorkstreamOptions, type WorkstreamSnapshot, type WorkstreamSnapshotSlowFields, type WorkstreamSummary, addBlockEdge, addNote, addTask, addToArchive, adoptAgent, agentStatusHistogram, appendLog, assertValidPaneId, backendByName, capturePane, captureSnapshot, checkCommandResolvable, claimTask, classifyEventVerb, closeAgent, closeTask, composeAgentTitle, countProblems, createArchive, createWorkspace, currentAgentName, currentPaneTitle, decorateWithDirty, decorateWithStaleness, defaultDbPath, defaultSendDelayMs, defaultSpawnLivenessMs, defaultStateDir, deferTask, deleteAgent, deleteArchive, deleteSnapshot, deleteTask, destroyWorkstream, detectBackend, detectPiStatus, emitEvent, ensureWorkstream, envVarNameForCli, exportArchive, exportSourceForWorkstream, exportSourcesForArchive, exportWorkstream, extractTail, foregroundPgid, freeAgent, freeWorkspace, gcMaxAgeDays, gcMaxCount, gcSnapshots, getAgent, getAgentByPane, getArchive, getParallelTracks, getPrerequisites, getTask, getTaskEdges, getTaskEdgesWithStatus, getWaitPollCount, getWorkspaceForAgent, getWorkspaceStaleness, gitBackend, idFromTitle, idFromTitleVerbose, importBucket, insertAgent, isKickSignal, isStaleVersion, isTaskStatus, isValidAgentName, isValidArchiveLabel, isValidPaneId, isValidTaskId, isValidWorkstreamName, isWorkspaceStale, jjBackend, kickAgent, killPane, killSession, latestSeq, listAgents, listAllOrphanWorkspaces, listArchivedTasks, listArchives, listBlocked, listGoals, listInProgress, listLiveAgents, listLogs, listNotes, listPanes, listPanesInSession, listReady, listRecentClosed, listSessions, listSnapshots, listTasks, listTasksByOwner, listWindows, listWorkspaceOrphans, listWorkspaces, listWorkstreams, loadDoctorChecks, loadDoctorSummary, loadFullDag, loadWorkstreamSnapshot, loadWorkstreamSnapshotFast, loadWorkstreamSnapshotSlow, mergeSnapshotFastSlow, newSession, newSessionWithPane, newWindow, noneBackend, openDb, openTask, paneExists, paneTTY, parseAgentNameFromTitle, parsePsTtyOutput, pruneSnapshots, readAgent, reconcile, recreateWorkspace, refreshAgentTitle, rejectTask, releaseTask, remediationParagraph, removeBlockEdge, removeFromArchive, renderForest, renderTaskTree, renderToBucket, reparentTask, resetCommandResolverForTests, resetKickProcessExecutor, resetSleep, resetTmuxExecutor, resetWaitPollCount, resolveActorIdentity, resolveCliCommand, resolveCliCommandWithSource, restoreSnapshot, roiBucket, searchArchives, searchTasks, selectLayout, sendToAgent, sendToPane, sessionExists, setCommandResolverForTests, setKickProcessExecutor, setPaneTitle, setSleepForTests, setTaskStatus, setTmuxExecutor, setWaitSleepForTests, setWaitStuckWarnForTests, slBackend, sleep, slugifyTitle, slugifyTitleVerbose, snapshotFileSize, snapshotsDir, spawnAgent, splitWindow, summarizeOwnedTasks, summarizeWorkstream, tmux$1 as tmux, updateAgentStatus, updateTask, waitForTasks, workspacePath, workspacesRoot, yankCommandForCheck };
+/** Days that must have elapsed since the most recent `db export`
+ *  event before a workstream is considered parked. Default 1: prevents
+ *  a same-session "I exported to verify" from instantly flipping the
+ *  TUI tab to dim. Tuning higher would just delay the banner. */
+declare const WORKSTREAM_PARKED_THRESHOLD_DAYS = 1;
+interface ParkedStatus {
+    parked: boolean;
+    /** Whole days since the most recent `db export` event. Present iff
+     *  `parked === true`. */
+    sinceDays?: number;
+}
+/**
+ * Compute the parked status for one workstream. Pure read; no writes.
+ *
+ * Returns `{ parked: false }` when:
+ *  - the workstream has no `db export` event in agent_logs, OR
+ *  - any agent_logs row newer than the most recent `db export` exists
+ *    (i.e. local activity since export), OR
+ *  - the workstream has any alive agents (status != 'closed'), OR
+ *  - the workstream has any IN_PROGRESS tasks, OR
+ *  - the most recent `db export` is younger than the threshold.
+ *
+ * Otherwise returns `{ parked: true, sinceDays: <whole days> }`.
+ *
+ * `now` defaults to wall-clock; tests pass it explicitly to keep the
+ * threshold edge deterministic.
+ */
+declare function parkedStatus(db: Db, workstream: string, opts?: {
+    now?: Date;
+    thresholdDays?: number;
+}): ParkedStatus;
+
+export { type AddNoteOptions, type AddTaskOptions, type AddToArchiveResult, type AdoptAgentOptions, type AdoptAgentResult, AgentDiedOnSpawnError, AgentExistsError, AgentNotFoundError, AgentNotInWorkstreamError, type AgentRow, AgentSpawnCliNotFoundError, AgentSpawnStartupError, type AgentStatus, type AppendLogOptions, type Archive, ArchiveAlreadyExistsError, ArchiveLabelInvalidError, ArchiveNotFoundError, type ArchiveSearchHit, ArchiveSourceAmbiguousError, type ArchiveSourceSummary, type ArchiveSummary, type ArchivedTaskRow, type BlockEdgeResult, CURRENT_SCHEMA_VERSION, type CaptureOptions, type CaptureSnapshotResult, type ClaimResult, type ClaimTaskOptions, ClaimerNotRegisteredError, type ClassifiedEvent, type CloseAgentOptions, type CloseAgentResult, type CommandResolutionResult, type CommandResolver, CrossWorkstreamEdgeError, CycleError, type Db, type DbExportManifest, type DbExportManifestWorkstream, DbExportTargetExistsError, DbImportConflictError, type DbImportDecision, DbImportManifestMissingError, DbImportSchemaTooNewError, DbImportSchemaTooOldError, DbImportSourceStaleError, type DbImportSummaryItem, type DbReplayEdgeItem, DbReplayLocalIdConflictError, type DbReplayNoteItem, type DbReplayPlan, type DbReplayResult, type DbReplayTaskConflict, type DbReplayTaskItem, DbReplayWorkstreamMissingError, type DeleteSnapshotResult, type DeleteTaskResult, type DestroyResult, type DetectedStatus, type DoctorCheck, type DoctorStatus, type DoctorSummary, EVENT_VERB_PREFIXES, EXPECTED_TABLES, type EvidenceOption, type ExportArchiveOptions, type ExportArchiveResult, type ExportDbOptions, type ExportDbResult, type ExportManifest, type ExportResult, type ExportSource, type ExportSourceManifest, type ExportTaskEntry, type ExportWorkstreamOptions, type FreeAgentResult, type FullDag, HomeDirAsProjectRootError, type IdFromTitleResult, type ImportDbOptions, type ImportDbResult, type InsertAgentInput, type KickAgentOptions, type KickAgentResult, type KickProcessExecutor, type KickSignal, type ListArchivedTasksOptions, type ListLiveAgentsOptions, type ListLogsOptions, type ListNotesOptions, type ListReadyOptions, type ListSnapshotsOptions, type ListTasksOptions, type LiveAgentsView, type LoadFullDagOptions, type LoadWorkstreamSnapshotOptions, type LogKind, type LogRow, type NewSessionOptions, type NewWindowOptions, NoForegroundProcessError, type OpenDbOptions, type OwnedTasksSummary, PANE_ID_RE, PaneNotFoundError, type ParkedStatus, type PruneMode, type PruneOptions, PruneOptionsInvalidError, type PruneResult, type ReconcileMode, type ReconcileOptions, type ReconcileReport, type RejectDeferOptions, type RejectDeferResult, type ReleaseResult, type ReleaseTaskOptions, type RemoveBlockEdgeResult, type RemoveFromArchiveResult, type RenderBucketInput, type RenderBucketResult, type ReparentTaskResult, type ReplayDbOptions, type RestoreArchiveOptions, type RestoreArchiveResult, type RestoreSnapshotResult, type RoiBucket, STATUSES_TERMINAL_OR_PARKED, STATUS_EMOJI, SchemaTooOldError, type SearchArchivesOptions, type SearchTasksOptions, type SendOptions, type SetStatusResult, type SlugifyResult, SnapshotFileMissingError, SnapshotNotFoundError, type SnapshotRow, SnapshotVersionMismatchError, type SpawnAgentOptions, type SplitWindowOptions, type StrandedWorkspaceOrphan, TASK_STATUSES, TASK_STATUS_LIST, TaskAlreadyOwnedError, type TaskEdgeWithStatus, type TaskEdges, type TaskEdgesWithStatus, TaskExistsError, TaskHasOpenDependentsError, TaskNotFoundError, TaskNotInWorkstreamError, type TaskNoteRow, type TaskRow, type TaskStatus, type TaskWaitOptions, type TaskWaitRef, type TaskWaitResult, type TaskWaitTaskState, TmuxError, type TmuxExecResult, type TmuxExecutor, type TmuxPane, type TmuxSession, type TmuxWindow, type Track, type UpdateTaskOptions, type UpdateTaskResult, type VcsBackend, type VcsBackendName, type CreateWorkspaceOptions$1 as VcsCreateWorkspaceOptions, type CreateWorkspaceResult as VcsCreateWorkspaceResult, type FreeWorkspaceOptions$1 as VcsFreeWorkspaceOptions, type FreeWorkspaceResult$1 as VcsFreeWorkspaceResult, WORKSPACE_STALE_THRESHOLD, WORKSTREAM_PARKED_THRESHOLD_DAYS, type CreateWorkspaceOptions as WorkspaceCreateOptions, WorkspaceExistsError, type WorkspaceFailure, type FreeWorkspaceOptions as WorkspaceFreeOptions, type FreeWorkspaceResult as WorkspaceFreeResult, WorkspaceNotFoundError, type WorkspaceOrphan, WorkspacePathNotEmptyError, WorkspacePreservedError, type RecreateWorkspaceOptions as WorkspaceRecreateOptions, type RecreateWorkspaceResult as WorkspaceRecreateResult, type WorkspaceRow, type WorkspaceStaleness, WorkstreamExistsError, WorkstreamNameInvalidError, type WorkstreamOptions, type WorkstreamSnapshot, type WorkstreamSnapshotSlowFields, type WorkstreamSummary, addBlockEdge, addNote, addTask, addToArchive, adoptAgent, agentStatusGlyph, agentStatusHistogram, appendLog, assertValidPaneId, backendByName, buildImportPlan, buildReplayPlan, capturePane, captureSnapshot, checkCommandResolvable, claimTask, classifyEventVerb, closeAgent, closeTask, composeAgentTitle, countProblems, createArchive, createWorkspace, currentAgentName, currentPaneTitle, decorateWithDirty, decorateWithStaleness, defaultDbPath, defaultSendDelayMs, defaultSpawnLivenessMs, defaultStateDir, deferTask, deleteAgent, deleteArchive, deleteSnapshot, deleteTask, destroyWorkstream, detectBackend, detectPiStatus, emitEvent, ensureWorkstream, envVarNameForCli, exportArchive, exportDb, exportSourceForWorkstream, exportSourcesForArchive, exportWorkstream, extractTail, foregroundPgid, freeAgent, freeWorkspace, gcMaxAgeDays, gcMaxCount, gcSnapshots, getAgent, getAgentByPane, getArchive, getParallelTracks, getPrerequisites, getTask, getTaskEdges, getTaskEdgesWithStatus, getWaitPollCount, getWorkspaceForAgent, getWorkspaceStaleness, gitBackend, idFromTitle, idFromTitleVerbose, importDb, insertAgent, isKickSignal, isStaleVersion, isTaskStatus, isValidAgentName, isValidArchiveLabel, isValidPaneId, isValidTaskId, isValidWorkstreamName, isWorkspaceStale, jjBackend, kickAgent, killPane, killSession, latestSeq, listAgents, listAllOrphanWorkspaces, listArchivedTasks, listArchives, listBlocked, listGoals, listInProgress, listLiveAgents, listLogs, listNotes, listPanes, listPanesInSession, listReady, listRecentClosed, listSessions, listSnapshots, listTasks, listTasksByOwner, listWindows, listWorkspaceOrphans, listWorkspaces, listWorkstreams, loadDoctorChecks, loadDoctorSummary, loadFullDag, loadWorkstreamSnapshot, loadWorkstreamSnapshotFast, loadWorkstreamSnapshotSlow, mergeSnapshotFastSlow, newSession, newSessionWithPane, newWindow, noneBackend, openDb, openTask, paneExists, paneTTY, parkedStatus, parseAgentNameFromTitle, parsePsTtyOutput, pruneSnapshots, readAgent, reconcile, recreateWorkspace, refreshAgentTitle, rejectTask, releaseTask, remediationParagraph, removeBlockEdge, removeFromArchive, renderForest, renderTaskTree, renderToBucket, reparentTask, replayDb, resetCommandResolverForTests, resetKickProcessExecutor, resetSleep, resetTmuxExecutor, resetWaitPollCount, resolveActorIdentity, resolveCliCommand, resolveCliCommandWithSource, restoreArchive, restoreSnapshot, roiBucket, searchArchives, searchTasks, selectLayout, sendToAgent, sendToPane, sessionExists, setCommandResolverForTests, setKickProcessExecutor, setPaneTitle, setSleepForTests, setTaskStatus, setTmuxExecutor, setWaitSleepForTests, setWaitStuckWarnForTests, slBackend, sleep, slugifyTitle, slugifyTitleVerbose, snapshotFileSize, snapshotsDir, spawnAgent, splitWindow, summarizeOwnedTasks, summarizeWorkstream, tmux$1 as tmux, updateAgentStatus, updateTask, waitForTasks, workspacePath, workspacesRoot, yankCommandForCheck };