@mu-crew/mu 2.0.0 → 3.0.0

package/dist/index.d.ts

@@ -98,14 +98,14 @@ declare class SchemaTooOldError extends Error implements HasNextSteps {
     constructor(detectedVersion: number, requiredVersion: number);
     errorNextSteps(): NextStep[];
 }
-/** The schema version a fresh DB starts at. v10 drops the REJECTED
- *  and DEFERRED task statuses (three-state lifecycle: OPEN,
- *  IN_PROGRESS, CLOSED). See CHANGELOG.md. */
-declare const CURRENT_SCHEMA_VERSION = 10;
+/** The schema version a fresh DB starts at. v11 adds tasks.substate
+ *  and the task_substates lookup table on top of v10's three-state
+ *  lifecycle (OPEN, IN_PROGRESS, CLOSED). See CHANGELOG.md. */
+declare const CURRENT_SCHEMA_VERSION = 11;
 /** 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, plus a
- *  CURRENT_SCHEMA_VERSION bump. Sorted; exactly 10 entries in v10. */
+ *  CURRENT_SCHEMA_VERSION bump. Sorted; exactly 11 entries in v11. */
 declare const EXPECTED_TABLES: readonly string[];
 /** Op entities that cross machines. Everything else is machine-local.
  *  Readonly tuple (not `string[]`) so `SyncedEntity` is a real union
@@ -149,6 +149,8 @@ type PortableTable = (typeof PORTABLE_TABLES)[number];
  *    machine_identity IS the per-machine identity.
  *    schema_version   local bookkeeping.
  *    sync_peers       local bookkeeping (per-peer watermarks).
+ *    task_substates   seeded identically on every machine from
+ *                     TASK_SUBSTATE_ROWS; code, not data.
  *    ops              see below — the carrier, not cargo.
  *
  *  `ops` is listed here deliberately rather than omitted. It is not
@@ -163,7 +165,7 @@ type PortableTable = (typeof PORTABLE_TABLES)[number];
  *  is an FK into `agents`, and `agents` is machine-local. Therefore
  *  OWNERSHIP DOES NOT SYNC. The deleted db-sync.ts reached the same
  *  conclusion via an `includeOwners` flag; here it is structural. */
-declare const MACHINE_LOCAL_TABLES: readonly ["agents", "machine_identity", "ops", "schema_version", "sync_peers", "vcs_workspaces"];
+declare const MACHINE_LOCAL_TABLES: readonly ["agents", "machine_identity", "ops", "schema_version", "sync_peers", "task_substates", "vcs_workspaces"];
 type MachineLocalTable = (typeof MACHINE_LOCAL_TABLES)[number];
 
 /** The multiplexers mu can drive. */
@@ -2105,8 +2107,8 @@ interface CaptureDb {
 }
 
 type TaskStatus = "OPEN" | "IN_PROGRESS" | "CLOSED";
-/** Every legal task status, in canonical order (matches the schema
- *  CHECK clause). Exported so CLI surfaces (`--status` validators,
+/** Every legal task status, in canonical order (matches the seeded
+ *  task_substates rows). Exported so CLI surfaces (`--status` validators,
  *  --help text, error messages) name them all in one place; missing
  *  one used to silently lie about the supported set. */
 declare const TASK_STATUSES: readonly TaskStatus[];
@@ -2116,15 +2118,50 @@ declare function isTaskStatus(s: string): s is TaskStatus;
  *  --help text and error messages so adding a new status doesn't
  *  leave stale lists rotting in the CLI surface. */
 declare const TASK_STATUS_LIST: string;
+/** Legal substates per status. `substate` qualifies `status` and never
+ *  touches edge semantics: only `status === "CLOSED"` satisfies a
+ *  `blocks` edge. */
+declare const TASK_SUBSTATES: {
+    readonly OPEN: readonly ["todo", "parked"];
+    readonly IN_PROGRESS: readonly ["active"];
+    readonly CLOSED: readonly ["done", "wontfix", "duplicate", "superseded"];
+};
+type TaskSubstate = (typeof TASK_SUBSTATES)[TaskStatus][number];
+/** The substate a status takes when none is given. Never null: an
+ *  absent value must not carry meaning. */
+declare const DEFAULT_SUBSTATE: {
+    readonly [S in TaskStatus]: (typeof TASK_SUBSTATES)[S][number];
+};
+interface TaskPair {
+    status: TaskStatus;
+    substate: TaskSubstate;
+}
+/** Rows for seeding task_substates: [status, substate, isDefault]. */
+declare const TASK_SUBSTATE_ROWS: ReadonlyArray<readonly [TaskStatus, TaskSubstate, 0 | 1]>;
+declare function isValidPair(status: string, substate: string): boolean;
+/** REJECTED -> {CLOSED, wontfix}; DEFERRED -> {OPEN, parked}; else null. */
+declare function mapLegacyStatus(value: string): TaskPair | null;
+/** Map a stored/remote pair onto a legal one. Legacy status -> mapped pair
+ *  (ignores substate arg). Unknown status -> null. Known status with
+ *  unknown/missing/mismatched substate -> {status, DEFAULT_SUBSTATE[status]}. */
+declare function resolvePair(status: string, substate: unknown): TaskPair | null;
+/** "OPEN" for default pairs, "OPEN/parked" otherwise. Shared by CLI + TUI. */
+declare function formatPair(pair: TaskPair): string;
 
 interface SetStatusResult {
     /** Status before the call. */
     previousStatus: TaskStatus;
     /** Status after the call (== requested status). */
     status: TaskStatus;
-    /** True iff the row actually changed. False on idempotent no-op. */
+    /** Substate before the call. */
+    previousSubstate: TaskSubstate;
+    /** Substate after the call (== requested substate, or the status default). */
+    substate: TaskSubstate;
+    /** True iff status OR substate changed. False on idempotent no-op. */
     changed: boolean;
 }
+/** The substates a task can be closed as (`mu task close --as`). */
+type CloseSubstate = Extract<TaskSubstate, "done" | "wontfix" | "duplicate" | "superseded">;
 /**
  * Optional evidence string carried on lifecycle verbs (close / open /
  * claim / release). Lands in the auto-emitted `kind='event'` payload
@@ -2136,14 +2173,19 @@ interface SetStatusResult {
 interface EvidenceOption {
     evidence?: string;
 }
+interface SetStatusOptions extends EvidenceOption {
+    workstream: string;
+    /** Substate to land on; defaults to DEFAULT_SUBSTATE[status]. A pair
+     *  outside TASK_SUBSTATES throws InvalidSubstateError before any write. */
+    substate?: TaskSubstate;
+}
 /**
- * Flip a task's status to any of OPEN / IN_PROGRESS / CLOSED.
- * Idempotent: setting a task to its current status is a no-op (returns
+ * Flip a task's status to any of OPEN / IN_PROGRESS / CLOSED, writing
+ * status and substate in ONE UPDATE (one op, one HLC — spec D7).
+ * Idempotent: setting a task to its current pair is a no-op (returns
  * `changed: false`) rather than throwing. Owner is unchanged.
  */
-declare function setTaskStatus(db: Db, localId: string, status: TaskStatus, opts: EvidenceOption & {
-    workstream: string;
-}): SetStatusResult;
+declare function setTaskStatus(db: Db, localId: string, status: TaskStatus, opts: SetStatusOptions): SetStatusResult;
 /** Result of `closeTask` when called with `ifReady: true` and the
  *  task is NOT yet ready to close (still has at least one OPEN /
  *  IN_PROGRESS blocker). Distinguished from a regular `SetStatusResult`
@@ -2164,6 +2206,9 @@ interface CloseSkippedResult {
     previousStatus: TaskStatus;
     /** Status after the call (== previousStatus, since we no-op). */
     status: TaskStatus;
+    /** Substate before (and after) the call. */
+    previousSubstate: TaskSubstate;
+    substate: TaskSubstate;
     /** Always false on a skip (no row mutated). */
     changed: false;
     /** Local ids of every blocker still in OPEN or IN_PROGRESS, sorted
@@ -2188,6 +2233,19 @@ interface CloseTaskOptions extends EvidenceOption {
      *  as a bare `addNote` without `--author`). Surfaced in mufeedback
      *  task_close_evidence_does_not_append_the. */
     author?: string;
+    /** Closing substate; default "done". Any CLOSED/* satisfies edges. */
+    as?: CloseSubstate;
+    /** Required (non-empty) unless `as` is "done"; stored as a
+     *  `<AS>: <why>` note in the same op group. */
+    why?: string;
+}
+/** Result of a close that ran (not skipped). */
+interface CloseTaskResult extends SetStatusResult {
+    /** Direct same-workstream dependents that entered the `ready` view
+     *  because of this close, sorted. Computed only when `as` is not
+     *  "done" (spec D3: a non-done close must show what it released);
+     *  always [] for a done close. */
+    unblocked: string[];
 }
 /** Convenience: setTaskStatus(db, id, "CLOSED"). Accepts evidence.
  *  Skipped
@@ -2199,12 +2257,30 @@ interface CloseTaskOptions extends EvidenceOption {
  *  `mu task close --if-ready` so an orchestrator can fire-and-forget
  *  the umbrella close after every blocker resolves without first
  *  re-querying the graph. */
-declare function closeTask(db: Db, localId: string, opts: CloseTaskOptions): SetStatusResult | CloseSkippedResult;
+declare function closeTask(db: Db, localId: string, opts: CloseTaskOptions): CloseTaskResult | CloseSkippedResult;
 /** Convenience: setTaskStatus(db, id, "OPEN"). Owner intentionally NOT
  *  cleared — use `releaseTask` for that. Accepts evidence. */
 declare function openTask(db: Db, localId: string, opts: EvidenceOption & {
     workstream: string;
 }): SetStatusResult;
+interface ParkTaskOptions extends EvidenceOption {
+    workstream: string;
+    /** Required, non-empty; stored as a `PARKED: <why>` note. */
+    why: string;
+    author?: string;
+}
+/**
+ * OPEN/todo → OPEN/parked: keep the task out of `ready` / `next` and
+ * make `claim` refuse it without `--force`. Its dependents stay blocked
+ * (parked is still OPEN). Idempotent on OPEN/parked (no second note).
+ * Refuses IN_PROGRESS (release first) and CLOSED (open first) — one
+ * verb, one transition.
+ */
+declare function parkTask(db: Db, localId: string, opts: ParkTaskOptions): SetStatusResult;
+/** OPEN/parked → OPEN/todo. A no-op (`changed: false`) on any other pair. */
+declare function unparkTask(db: Db, localId: string, opts: EvidenceOption & {
+    workstream: string;
+}): SetStatusResult;
 
 interface ReleaseResult {
     /** The previous owner (null if the task was already unowned). */
@@ -2306,6 +2382,12 @@ interface ClaimTaskOptions extends EvidenceOption {
      * title (e.g. "deploy-bot" rather than "pi-mu").
      */
     actor?: string;
+    /**
+     * Claim an OPEN/parked task anyway. Without it, a parked task throws
+     * TaskParkedError before any write: parking means "keep out of the
+     * scheduler", so overriding it must be explicit.
+     */
+    force?: boolean;
 }
 interface ClaimResult {
     /** The agent now owning the task, or null when the claim was anonymous (--self). */
@@ -2374,6 +2456,8 @@ interface TaskRow {
     workstreamName: string;
     title: string;
     status: TaskStatus;
+    /** Qualifies status (e.g. OPEN/parked, CLOSED/wontfix). Never null. */
+    substate: TaskSubstate;
     impact: number;
     effortDays: number;
     /** Foreign-name reference to the owning agent (NULL when unowned). */
@@ -2400,6 +2484,7 @@ interface TaskEdges {
 interface TaskEdgeWithStatus {
     name: string;
     status: TaskStatus;
+    substate: TaskSubstate;
 }
 interface TaskEdgesWithStatus {
     /** Tasks that must close before this one can start (blockers),
@@ -2865,6 +2950,56 @@ declare class CrossWorkstreamEdgeError extends Error implements HasNextSteps {
     constructor(blocker: string, blockerWorkstream: string, dependent: string, dependentWorkstream: string);
     errorNextSteps(): NextStep[];
 }
+/**
+ * Thrown by `closeTask` (non-`done` `--as`) and `parkTask` when no
+ * non-empty `--why` was given. The reason is stored as a note, so a
+ * classification with no rationale is refused before any write.
+ */
+declare class SubstateReasonRequiredError extends Error implements HasNextSteps {
+    readonly verb: "close" | "park";
+    readonly substate: TaskSubstate;
+    readonly taskId: string;
+    readonly name = "SubstateReasonRequiredError";
+    constructor(verb: "close" | "park", substate: TaskSubstate, taskId: string);
+    errorNextSteps(): NextStep[];
+}
+/**
+ * Thrown by `parkTask` on an IN_PROGRESS or CLOSED task. Park is one
+ * transition (OPEN/todo → OPEN/parked); the owner releases, or the task
+ * is reopened, first.
+ */
+declare class TaskParkStateError extends Error implements HasNextSteps {
+    readonly taskId: string;
+    readonly status: "IN_PROGRESS" | "CLOSED";
+    readonly workstream: string;
+    readonly name = "TaskParkStateError";
+    constructor(taskId: string, status: "IN_PROGRESS" | "CLOSED", workstream: string);
+    errorNextSteps(): NextStep[];
+}
+/**
+ * Thrown by `claimTask` on an OPEN/parked task without `force`. Parked
+ * means "keep out of the scheduler"; claiming it anyway is explicit.
+ */
+declare class TaskParkedError extends Error implements HasNextSteps {
+    readonly taskId: string;
+    readonly workstream: string;
+    readonly name = "TaskParkedError";
+    constructor(taskId: string, workstream: string);
+    errorNextSteps(): NextStep[];
+}
+/**
+ * Thrown when a verb is asked for a (status, substate) pair that the
+ * task_substates table does not allow, e.g. `close --as parked`.
+ * Caught here rather than by the deferred FK, which would fail only at
+ * commit with an opaque constraint message.
+ */
+declare class InvalidSubstateError extends Error implements HasNextSteps {
+    readonly status: TaskStatus;
+    readonly substate: string;
+    readonly name = "InvalidSubstateError";
+    constructor(status: TaskStatus, substate: string);
+    errorNextSteps(): NextStep[];
+}
 
 declare function isValidTaskId(id: string): boolean;
 /**
@@ -2969,6 +3104,8 @@ declare function getTask(db: Db, localId: string, workstream: string): TaskRow |
 interface ListTasksOptions {
     /** Filter to one or more lifecycle statuses. Omitted = all statuses. */
     status?: TaskStatus | readonly TaskStatus[];
+    /** Filter to one or more substates (ANDed with `status`). */
+    substate?: TaskSubstate | readonly TaskSubstate[];
 }
 declare function listTasks(db: Db, workstream?: string, opts?: ListTasksOptions): TaskRow[];
 /** Options for listReady. The optional `statuses` filter composes
@@ -2979,6 +3116,8 @@ declare function listTasks(db: Db, workstream?: string, opts?: ListTasksOptions)
  *  shipped on `mu task list` (task_list_multi_status_union). */
 interface ListReadyOptions {
     status?: TaskStatus | readonly TaskStatus[];
+    /** Substate filter; the `ready` view already excludes OPEN/parked. */
+    substate?: TaskSubstate | readonly TaskSubstate[];
 }
 declare function listReady(db: Db, workstream: string, opts?: ListReadyOptions): TaskRow[];
 declare function listBlocked(db: Db, workstream: string): TaskRow[];
@@ -3139,6 +3278,8 @@ interface TaskWaitTaskState {
     name: string;
     /** Current status (at the moment we exit). */
     status: TaskStatus;
+    /** Current substate. A CLOSED ref that is not `done` has no deliverable. */
+    substate: TaskSubstate;
     /** Owner at exit time (NULL when unowned, after release, or after
      *  the reaper flipped IN_PROGRESS → OPEN due to a dead pane). */
     owner: string | null;
@@ -3192,6 +3333,9 @@ interface RenderTreeOptions {
 interface LoadFullDagOptions {
     /** Optional visible-status filter. Omitted = every task status. */
     statuses?: ReadonlySet<TaskStatus>;
+    /** Optional row predicate, applied after `statuses` (e.g. the TUI's
+     *  substate toggles). Omitted = keep every row. */
+    include?: (task: TaskRow) => boolean;
 }
 declare function loadFullDag(db: Db, workstream: string, opts?: LoadFullDagOptions): FullDag;
 /**
@@ -3330,6 +3474,9 @@ interface Track {
     taskIds: ReadonlySet<string>;
     /** Number of READY tasks (per the SQL view) within this track's subgraph. */
     readyCount: number;
+    /** True when every non-CLOSED task in the track is OPEN/parked: the
+     *  track holds work, but none of it is schedulable. */
+    parked: boolean;
 }
 /**
  * Identify independent task subtrees suitable for parallel assignment
@@ -3350,6 +3497,9 @@ interface WorkstreamSnapshot {
     inProgress: TaskRow[];
     blocked: TaskRow[];
     recentClosed: TaskRow[];
+    /** OPEN/parked tasks in the workstream. The ready card names them
+     *  when nothing is ready, since parked work is otherwise invisible there. */
+    parkedCount: number;
     /** Populated only when callers explicitly pass `withAllTasks: true`.
      *  The TUI dashboard fast tick leaves this empty and the all-tasks
      *  popup reads its exhaustive list directly from SQLite while open. */
@@ -3786,6 +3936,8 @@ declare const GLYPH: {
     readonly stale: "";
     /** Task is blocked by an incoming edge. */
     readonly blocked: "";
+    /** Task is parked (OPEN/parked): open, but set aside on purpose. */
+    readonly parked: "";
     /** Track whose roots merged (diamond dependency). */
     readonly merge: "";
     /** Agent owns more than one task (pane-title multi-count slot). */
@@ -3887,7 +4039,7 @@ declare function receiveHlc(db: Db, remoteHlc: string, now?: number): string;
 /** Every intent mu writes: the local ones (`emitEvent`, for changes no
  *  trigger can see) plus the capture-trigger ones (set via
  *  `withOpContext` around a portable-table mutation). */
-type CaptureIntent = "task.add" | "task.update" | "task.note" | "task.delete" | "task.close" | "task.open" | "task.reject" | "task.defer" | "task.claim" | "task.release" | "task.reap" | "task.block" | "task.unblock" | "task.reparent" | "workstream.init" | "workstream.teardown" | "workstream.destroy";
+type CaptureIntent = "task.add" | "task.update" | "task.note" | "task.delete" | "task.close" | "task.open" | "task.park" | "task.unpark" | "task.reject" | "task.defer" | "task.claim" | "task.release" | "task.reap" | "task.block" | "task.unblock" | "task.reparent" | "workstream.init" | "workstream.teardown" | "workstream.destroy";
 type KnownIntent = CaptureIntent | LocalIntent;
 /** A log row, reduced to what rendering needs. Structural so both
  *  `LogRow` (the SDK shape) and raw op rows satisfy it. */
@@ -4826,4 +4978,4 @@ declare function summarizeWorkstream(db: Db, opts: WorkstreamOptions): Promise<W
  */
 declare function teardownWorkstream(db: Db, opts: TeardownWorkstreamOptions): Promise<TeardownResult>;
 
-export { AGENT_STATE_GLYPH, type AddNoteOptions, type AddTaskOptions, type AdoptAgentOptions, type AdoptAgentResult, AgentDiedOnSpawnError, AgentExistsError, AgentNotFoundError, AgentNotInWorkstreamError, type AgentRow, AgentSpawnCliNotFoundError, AgentSpawnStartupError, type AmbientOptions, type AmbientResult, type AppendLogOptions, type ApplyResult, type BlockEdgeResult, CAPTURE_TRIGGER_DDL, CURRENT_SCHEMA_VERSION, type CaptureDb, type CaptureIntent, type CaptureOptions, type CaseCollision, type CheapDriftReport, type ClaimResult, type ClaimTaskOptions, ClaimerNotRegisteredError, type CloseAgentOptions, type CloseAgentResult, type CommandResolutionResult, type CommandResolver, CrossWorkstreamEdgeError, CycleError, DRIFT_REPORT_CAP, type Db, type DeleteTaskResult, type DoctorCheck, type DoctorStatus, type DoctorSummary, DriftDetectedError, type DriftRecord, type DriftReport, EXPECTED_TABLES, type EvidenceOption, type FileLockOptions, type FleetHazard, type FlushResult, type FsProbe, type FullDag, GLYPH, type GroupSummary, type HazardSeverity, type Hlc, HlcOverflowError, HlcParseError, HomeDirAsProjectRootError, type IdFromTitleResult, type IngestFromDbResult, type IngestResult, type InsertAgentInput, type InverseOp, KNOWN_INTENTS, KNOWN_VERBS, type KickAgentOptions, type KickAgentResult, type KickProcessExecutor, type KickSignal, type KnownIntent, type ListLiveAgentsOptions, type ListLogsOptions, type ListNotesOptions, type ListReadyOptions, type ListTasksOptions, type LiveAgent, type LiveAgentsView, type LoadFullDagOptions, type LoadWorkstreamSnapshotOptions, type LocalIntent, type LogKind, type LogRow, MACHINE_LOCAL_ENTITIES, MACHINE_LOCAL_TABLES, MachineIdentityMissingError, type MachineLocalEntity, type MachineLocalLoss, type MachineLocalTable, type MuxBackend, type MuxBackendName, MuxError, type MuxPane, type MuxPaneStatus, type MuxSession, type MuxWindow, type NewSessionOptions, type NewWindowOptions, NoForegroundProcessError, NoMultiplexerError, NothingToUndoError, OP_CTX_DDL, type Op, type OpContext, OpEntityNotSyncedError, OpKeyMalformedError, type OpenDbOptions, type OwnedTasksSummary, PANE_ID_RE, PEER_SHORT_LEN, PEER_STALE_MS, PORTABLE_TABLES, PaneNotFoundError, type PeerSegment, type PeerStatus, type PortableTable, type RebuildOptions, type RebuildReport, RebuildTargetExistsError, RebuildTargetIsSourceError, type ReconcileMode, type ReconcileOptions, type ReconcileReport, type ReleaseResult, type ReleaseTaskOptions, type RemoveBlockEdgeResult, type RenderableOp, type RenderedOp, type ReparentTaskResult, type RoiBucket, type RuntimeState, SEGMENT_FORMAT_VERSION, SYNCED_ENTITIES, SchemaTooOldError, type SegmentDefect, type SegmentDefectKind, type SegmentLine, type SegmentManifest, type SendOptions, type SendWarning, type SetStatusResult, type SlugifyResult, type SpawnAgentOptions, type SplitWindowOptions, type StateReading, type StateSource, type StrandedWorkspaceOrphan, type SyncPassResult, SyncPeerNotFoundError, SyncPeerRefAmbiguousError, SyncSourceNotFoundError, type SyncedEntity, TASK_STATUSES, TASK_STATUS_LIST, TaskAlreadyOwnedError, type TaskEdgeWithStatus, type TaskEdges, type TaskEdgesWithStatus, TaskExistsError, TaskNotFoundError, TaskNotInWorkstreamError, type TaskNoteRow, type TaskRow, type TaskStatus, type TaskWaitOptions, type TaskWaitRef, type TaskWaitResult, type TaskWaitTaskState, type TeardownResult, TmuxError, type TmuxExecResult, type TmuxExecutor, type TmuxPane, type TmuxSession, type TmuxWindow, type Track, UNKNOWN_REASON, UndoGroupNotFoundError, type UndoOptions, type UndoPlan, type UndoResult, UndoSupersededError, type UpdateTaskOptions, type UpdateTaskResult, type VcsBackend, type VcsBackendName, WORKSPACE_STALE_THRESHOLD, WorkspaceExistsError, type WorkspaceFailure, WorkspaceNotFoundError, type WorkspaceOrphan, WorkspacePathNotEmptyError, WorkspacePreservedError, type WorkspaceRow, type WorkspaceStaleness, WorkstreamExistsError, WorkstreamNameInvalidError, type WorkstreamOptions, type WorkstreamSnapshot, type WorkstreamSnapshotSlowFields, type WorkstreamSummary, activeMux, addBlockEdge, addNote, addTask, adoptAgent, agentKey, agentStateGlyph, agentStateHistogram, ambientFlush, ambientIngest, ambientSyncPass, appendLog, applyIncomingOp, applyOp, applyOps, assertValidPaneId, awaitPaneQuiescence, backendByName, capturePane, checkCaseCollisions, checkCheapDriftInvariant, checkCommandResolvable, checkDbInsideSyncDir, checkDrift, checkFleetHazards, checkNetworkMount, claimTask, classifyFsType, closeAgent, closeTask, compareHlc, composeAgentTitle, countProblems, createWorkspace, currentAgentName, currentOpContext, currentPaneTitle, decorateWithDirty, decorateWithStaleness, defaultDbPath, defaultSendDelayMs, defaultSendReadinessMs, defaultSpawnLivenessMs, defaultStateDir, deleteAgent, deleteTask, detectBackend, detectMux, discoverPeers, driftRemediation, emitEvent, ensureWorkstream, envVarNameForCli, findCaseCollisions, flushSegment, foregroundPgid, formatDriftRecord, formatHlc, freeWorkspace, getAgent, getAgentByPane, getParallelTracks, getPrerequisites, getTask, getTaskEdges, getTaskEdgesWithStatus, getWaitPollCount, getWatermark, getWorkspaceForAgent, getWorkspaceStaleness, gitBackend, hasWorkMarker, idFromTitle, idFromTitleVerbose, ingestFromDb, ingestSegment, insertAgent, installCapture, isKickSignal, isPathInside, isTaskStatus, isValidAgentName, isValidPaneId, isValidTaskId, isValidWorkstreamName, isWorkspaceStale, jjBackend, kickAgent, killPane, killSession, latestSeq, listAgents, listAllOrphanWorkspaces, listBlocked, listGoals, listInProgress, listLiveAgents, listLogs, listNotes, listPanes, listPanesInSession, listReady, listRecentClosed, listRecentGroups, listSessions, listTasks, listTasksByOwner, listWindows, listWorkspaceOrphans, listWorkspaces, listWorkstreams, loadDoctorChecks, loadDoctorSummary, loadFullDag, loadWorkstreamSnapshot, loadWorkstreamSnapshotFast, loadWorkstreamSnapshotSlow, localMachineId, locksDir, mergeSnapshotFastSlow, mostRecentGroup, murmurAvailable, mux, muxByName, newSession, newSessionWithPane, newWindow, nextHlc, noneBackend, opSubject, openDb, openTask, paneExists, paneTTY, parseAgentNameFromTitle, parseHlc, parseOpKey, parsePsTtyOutput, peerStatuses, planUndo, priorFieldValue, probeFilesystem, readAgent, readAgentStates, readFileLockMeta, readManifest, rebuildInto, receiveHlc, reconcile, refreshAgentTitle, releaseTask, remediationParagraph, removeBlockEdge, renderForest, renderOp, renderOpLine, renderTaskTree, repairPeer, reparentTask, resetCommandResolverForTests, resetKickProcessExecutor, resetMux, resetSleep, resetTmuxExecutor, resetWaitPollCount, resetWatermark, resolveActorIdentity, resolveCliCommand, resolveCliCommandWithSource, resolveGroupId, resolvePeerRef, roiBucket, segmentLineCount, segmentPath, selectLayout, sendToAgent, sendToPane, sessionExists, setCommandResolverForTests, setKickProcessExecutor, setMuxForTests, setPaneTitle, setSleepForTests, setTaskStatus, setTmuxExecutor, setWaitSleepForTests, setWaitStuckWarnForTests, setWatermark, slBackend, sleep, slugifyTitle, slugifyTitleVerbose, spawnAgent, splitWindow, summarizeOwnedTasks, summarizeWorkstream, syncDir, syncEnabled, syncPass, teardownWorkstream, tmux, tmuxBackend, transportNextSteps, undoGroup, updateTask, verifyAgainstManifest, waitForTasks, withCaptureSuppressed, withFileLock, withOpContext, workspacePath, workspacesRoot, yankCommandForCheck };
+export { AGENT_STATE_GLYPH, type AddNoteOptions, type AddTaskOptions, type AdoptAgentOptions, type AdoptAgentResult, AgentDiedOnSpawnError, AgentExistsError, AgentNotFoundError, AgentNotInWorkstreamError, type AgentRow, AgentSpawnCliNotFoundError, AgentSpawnStartupError, type AmbientOptions, type AmbientResult, type AppendLogOptions, type ApplyResult, type BlockEdgeResult, CAPTURE_TRIGGER_DDL, CURRENT_SCHEMA_VERSION, type CaptureDb, type CaptureIntent, type CaptureOptions, type CaseCollision, type CheapDriftReport, type ClaimResult, type ClaimTaskOptions, ClaimerNotRegisteredError, type CloseAgentOptions, type CloseAgentResult, type CloseSubstate, type CloseTaskResult, type CommandResolutionResult, type CommandResolver, CrossWorkstreamEdgeError, CycleError, DEFAULT_SUBSTATE, DRIFT_REPORT_CAP, type Db, type DeleteTaskResult, type DoctorCheck, type DoctorStatus, type DoctorSummary, DriftDetectedError, type DriftRecord, type DriftReport, EXPECTED_TABLES, type EvidenceOption, type FileLockOptions, type FleetHazard, type FlushResult, type FsProbe, type FullDag, GLYPH, type GroupSummary, type HazardSeverity, type Hlc, HlcOverflowError, HlcParseError, HomeDirAsProjectRootError, type IdFromTitleResult, type IngestFromDbResult, type IngestResult, type InsertAgentInput, InvalidSubstateError, type InverseOp, KNOWN_INTENTS, KNOWN_VERBS, type KickAgentOptions, type KickAgentResult, type KickProcessExecutor, type KickSignal, type KnownIntent, type ListLiveAgentsOptions, type ListLogsOptions, type ListNotesOptions, type ListReadyOptions, type ListTasksOptions, type LiveAgent, type LiveAgentsView, type LoadFullDagOptions, type LoadWorkstreamSnapshotOptions, type LocalIntent, type LogKind, type LogRow, MACHINE_LOCAL_ENTITIES, MACHINE_LOCAL_TABLES, MachineIdentityMissingError, type MachineLocalEntity, type MachineLocalLoss, type MachineLocalTable, type MuxBackend, type MuxBackendName, MuxError, type MuxPane, type MuxPaneStatus, type MuxSession, type MuxWindow, type NewSessionOptions, type NewWindowOptions, NoForegroundProcessError, NoMultiplexerError, NothingToUndoError, OP_CTX_DDL, type Op, type OpContext, OpEntityNotSyncedError, OpKeyMalformedError, type OpenDbOptions, type OwnedTasksSummary, PANE_ID_RE, PEER_SHORT_LEN, PEER_STALE_MS, PORTABLE_TABLES, PaneNotFoundError, type ParkTaskOptions, type PeerSegment, type PeerStatus, type PortableTable, type RebuildOptions, type RebuildReport, RebuildTargetExistsError, RebuildTargetIsSourceError, type ReconcileMode, type ReconcileOptions, type ReconcileReport, type ReleaseResult, type ReleaseTaskOptions, type RemoveBlockEdgeResult, type RenderableOp, type RenderedOp, type ReparentTaskResult, type RoiBucket, type RuntimeState, SEGMENT_FORMAT_VERSION, SYNCED_ENTITIES, SchemaTooOldError, type SegmentDefect, type SegmentDefectKind, type SegmentLine, type SegmentManifest, type SendOptions, type SendWarning, type SetStatusOptions, type SetStatusResult, type SlugifyResult, type SpawnAgentOptions, type SplitWindowOptions, type StateReading, type StateSource, type StrandedWorkspaceOrphan, SubstateReasonRequiredError, type SyncPassResult, SyncPeerNotFoundError, SyncPeerRefAmbiguousError, SyncSourceNotFoundError, type SyncedEntity, TASK_STATUSES, TASK_STATUS_LIST, TASK_SUBSTATES, TASK_SUBSTATE_ROWS, TaskAlreadyOwnedError, type TaskEdgeWithStatus, type TaskEdges, type TaskEdgesWithStatus, TaskExistsError, TaskNotFoundError, TaskNotInWorkstreamError, type TaskNoteRow, type TaskPair, TaskParkStateError, TaskParkedError, type TaskRow, type TaskStatus, type TaskSubstate, type TaskWaitOptions, type TaskWaitRef, type TaskWaitResult, type TaskWaitTaskState, type TeardownResult, TmuxError, type TmuxExecResult, type TmuxExecutor, type TmuxPane, type TmuxSession, type TmuxWindow, type Track, UNKNOWN_REASON, UndoGroupNotFoundError, type UndoOptions, type UndoPlan, type UndoResult, UndoSupersededError, type UpdateTaskOptions, type UpdateTaskResult, type VcsBackend, type VcsBackendName, WORKSPACE_STALE_THRESHOLD, WorkspaceExistsError, type WorkspaceFailure, WorkspaceNotFoundError, type WorkspaceOrphan, WorkspacePathNotEmptyError, WorkspacePreservedError, type WorkspaceRow, type WorkspaceStaleness, WorkstreamExistsError, WorkstreamNameInvalidError, type WorkstreamOptions, type WorkstreamSnapshot, type WorkstreamSnapshotSlowFields, type WorkstreamSummary, activeMux, addBlockEdge, addNote, addTask, adoptAgent, agentKey, agentStateGlyph, agentStateHistogram, ambientFlush, ambientIngest, ambientSyncPass, appendLog, applyIncomingOp, applyOp, applyOps, assertValidPaneId, awaitPaneQuiescence, backendByName, capturePane, checkCaseCollisions, checkCheapDriftInvariant, checkCommandResolvable, checkDbInsideSyncDir, checkDrift, checkFleetHazards, checkNetworkMount, claimTask, classifyFsType, closeAgent, closeTask, compareHlc, composeAgentTitle, countProblems, createWorkspace, currentAgentName, currentOpContext, currentPaneTitle, decorateWithDirty, decorateWithStaleness, defaultDbPath, defaultSendDelayMs, defaultSendReadinessMs, defaultSpawnLivenessMs, defaultStateDir, deleteAgent, deleteTask, detectBackend, detectMux, discoverPeers, driftRemediation, emitEvent, ensureWorkstream, envVarNameForCli, findCaseCollisions, flushSegment, foregroundPgid, formatDriftRecord, formatHlc, formatPair, freeWorkspace, getAgent, getAgentByPane, getParallelTracks, getPrerequisites, getTask, getTaskEdges, getTaskEdgesWithStatus, getWaitPollCount, getWatermark, getWorkspaceForAgent, getWorkspaceStaleness, gitBackend, hasWorkMarker, idFromTitle, idFromTitleVerbose, ingestFromDb, ingestSegment, insertAgent, installCapture, isKickSignal, isPathInside, isTaskStatus, isValidAgentName, isValidPair, isValidPaneId, isValidTaskId, isValidWorkstreamName, isWorkspaceStale, jjBackend, kickAgent, killPane, killSession, latestSeq, listAgents, listAllOrphanWorkspaces, listBlocked, listGoals, listInProgress, listLiveAgents, listLogs, listNotes, listPanes, listPanesInSession, listReady, listRecentClosed, listRecentGroups, listSessions, listTasks, listTasksByOwner, listWindows, listWorkspaceOrphans, listWorkspaces, listWorkstreams, loadDoctorChecks, loadDoctorSummary, loadFullDag, loadWorkstreamSnapshot, loadWorkstreamSnapshotFast, loadWorkstreamSnapshotSlow, localMachineId, locksDir, mapLegacyStatus, mergeSnapshotFastSlow, mostRecentGroup, murmurAvailable, mux, muxByName, newSession, newSessionWithPane, newWindow, nextHlc, noneBackend, opSubject, openDb, openTask, paneExists, paneTTY, parkTask, parseAgentNameFromTitle, parseHlc, parseOpKey, parsePsTtyOutput, peerStatuses, planUndo, priorFieldValue, probeFilesystem, readAgent, readAgentStates, readFileLockMeta, readManifest, rebuildInto, receiveHlc, reconcile, refreshAgentTitle, releaseTask, remediationParagraph, removeBlockEdge, renderForest, renderOp, renderOpLine, renderTaskTree, repairPeer, reparentTask, resetCommandResolverForTests, resetKickProcessExecutor, resetMux, resetSleep, resetTmuxExecutor, resetWaitPollCount, resetWatermark, resolveActorIdentity, resolveCliCommand, resolveCliCommandWithSource, resolveGroupId, resolvePair, resolvePeerRef, roiBucket, segmentLineCount, segmentPath, selectLayout, sendToAgent, sendToPane, sessionExists, setCommandResolverForTests, setKickProcessExecutor, setMuxForTests, setPaneTitle, setSleepForTests, setTaskStatus, setTmuxExecutor, setWaitSleepForTests, setWaitStuckWarnForTests, setWatermark, slBackend, sleep, slugifyTitle, slugifyTitleVerbose, spawnAgent, splitWindow, summarizeOwnedTasks, summarizeWorkstream, syncDir, syncEnabled, syncPass, teardownWorkstream, tmux, tmuxBackend, transportNextSteps, undoGroup, unparkTask, updateTask, verifyAgainstManifest, waitForTasks, withCaptureSuppressed, withFileLock, withOpContext, workspacePath, workspacesRoot, yankCommandForCheck };