@ordewell/core 0.7.0 → 0.7.2

package/dist/{plan-utils-CD1Xu65s.d.mts → plan-utils-CdW3mxt5.d.mts}

@@ -1,5 +1,6 @@
-import { b7 as StructuredTurnEnd, b9 as SubagentOutcome, bz as UsageRecord, k as ApprovalDecision, b5 as StructuredEvent, aX as RunnerId, y as DiscoveredModel, bc as Task, a9 as LegacyPlanState, aN as QueuedMessage, bA as UsageTotals, bG as Verdict, be as TaskIsolation, bt as TaskTransport, r as AwaitingReason, aO as QueuedTaskMessage, T as IsolationHandoff, _ as IsolationMergeResult, aT as ResearchStep, l as ApprovalKind, q as ApprovalSource, aU as ResearchStepOutcome, w as ConversationMessage, aR as ResearchLogEntry, az as PlannerUsage } from './Task-CoKhvBa1.mjs';
-import { R as RunnerModeInfo } from './ModeResolver-Cv01ZDd9.mjs';
+import { bc as StructuredTurnEnd, be as SubagentOutcome, bF as UsageRecord, k as ApprovalDecision, ba as StructuredEvent, b0 as RunnerId, z as DiscoveredModel, bi as Task, ac as LegacyPlanState, aR as QueuedMessage, bG as UsageTotals, bM as Verdict, bk as TaskIsolation, bz as TaskTransport, r as AwaitingReason, aS as QueuedTaskMessage, U as IsolationHandoff, $ as IsolationMergeResult, aY as ResearchStep, l as ApprovalKind, q as ApprovalSource, aZ as ResearchStepOutcome, w as ConversationMessage, aW as ResearchLogEntry, aC as PlannerUsage, bl as TaskIsolationState } from './Task-BpzIbunq.mjs';
+import { R as RunnerModeInfo } from './ModeResolver-DcqAho4y.mjs';
+import './order-labels.mjs';
 
 /**
  * One entry of a structured task's log (ADR-0018, P1): what a runner did,
@@ -11,11 +12,12 @@ import { R as RunnerModeInfo } from './ModeResolver-Cv01ZDd9.mjs';
  * without a format version.
  */
 type TaskLogEvent = 
-/** A turn began by delivering `message`; `messageId` names it when it had been queued. */
+/** A turn began by delivering `message`; `messageId` names it when it had been queued, `forced` when it was force sent. */
 {
     type: 'turn_start';
     message: string;
     messageId?: string;
+    forced?: boolean;
 } | {
     type: 'turn_end';
     reason: StructuredTurnEnd;
@@ -65,13 +67,37 @@ type TaskLogEvent =
 } | {
     type: 'usage';
     record: UsageRecord;
-} | {
+}
+/**
+ * Waiting in Ordewell's queue — again, for a message the runner was handed
+ * and let go of (ADR-0023, D4). `forced` moves it ahead of the rest (F2).
+ */
+ | {
     type: 'message_queued';
     messageId: string;
     text: string;
+    forced?: boolean;
 } | {
     type: 'message_removed';
     messageId: string;
+} | {
+    type: 'message_undelivered';
+    messageId: string;
+    text: string;
+}
+/** The runner accepted a queued message into its running turn; it can no longer be taken back. */
+ | {
+    type: 'message_handed_over';
+    messageId: string;
+}
+/**
+ * The model read a message inside its running turn (ADR-0023, Q2), logged
+ * where it read it. A message that opened a turn is that turn's `turn_start`.
+ */
+ | {
+    type: 'message_delivered';
+    messageId: string;
+    text: string;
 }
 /** The agent's own words for a failed turn. */
  | {
@@ -263,6 +289,8 @@ type SerializedTaskStatus = {
     transport?: Pick<TaskTransport, 'kind' | 'fallback'>;
     /** What an `awaiting_user` task waits on, when it was saved (ADR-0018, W1). */
     awaitingReason?: AwaitingReason;
+    /** The whole question of the checkpoint the task waits at; absent when it waits at none. */
+    checkpoint?: string;
     /** Messages waiting for a structured task's turn to end, oldest first; absent when there are none. */
     queued?: QueuedTaskMessage[];
     /** Set when the task can be continued in its saved runner session (ADR-0018, K1); the id itself stays in the daemon. */
@@ -483,8 +511,6 @@ type SessionMessage =
     };
 } | {
     type: 'execution_stopped';
-} | {
-    type: 'queue_ready';
 } | {
     type: 'task_updated';
     taskId: string;
@@ -578,7 +604,7 @@ type SessionNotice = {
 };
 type SessionBroadcaster = (msg: SessionMessage) => void;
 declare function serializeTask(t: Task): SerializedTask;
-declare function serializeTaskStatus(t: Task, idleSince?: string | null, isolation?: TaskIsolation | null, queued?: readonly QueuedTaskMessage[], awaitingApproval?: number, mergeGate?: readonly string[]): SerializedTaskStatus;
+declare function serializeTaskStatus(t: Task, idleSince?: string | null, isolation?: TaskIsolation | null, queued?: readonly QueuedTaskMessage[], awaitingApproval?: number, mergeGate?: readonly string[], checkpoint?: string): SerializedTaskStatus;
 declare function serializePlan(plan: LegacyPlanState): SerializedPlan;
 declare function executionSummary(tasks: readonly Task[]): {
     total: number;
@@ -794,7 +820,7 @@ declare function fromTranscript(conversationHistory: readonly ConversationMessag
  * one at a time.
  */
 interface TaskLogView extends BlockList {
-    /** Messages waiting for the running turn to end, oldest first. */
+    /** Messages not yet delivered, oldest first; `handedOver` marks the ones the runner already has. */
     readonly queued: readonly QueuedTaskMessage[];
     /** A turn is running. */
     readonly working: boolean;
@@ -925,4 +951,195 @@ declare function hasHiddenDetail(blocks: readonly DisplayBlock[]): boolean;
 /** The conversation line for a task starting, worded the same on every surface. */
 declare function taskStartedNotice(title: string, runner?: string): string;
 
-export { diffRows as $, type ApplyTaskOpsResult as A, type ToolBlock as B, CHECKPOINT_TRUNCATE_LENGTH as C, type DiffRow as D, EMPTY_CONVERSATION as E, type ToolHeadline as F, type GatedConversation as G, type ToolStatus as H, type TurnGate as I, aheadOfDraft as J, applyTaskOps as K, type LocalEntry as L, type MergeGateView as M, NO_TURN as N, type OutputPreview as O, type PlanBlock as P, canMergeTasks as Q, canSetDependencies as R, type SerializedPlan as S, type TakenPrompt as T, type UsageBlock as U, canSplitTask as V, capConflictFiles as W, classifyOutcome as X, coalesceTaskLog as Y, dependencyCandidates as Z, dependentsOf as _, type ApprovalBlock as a, diffStat as a0, diffSummary as a1, digestTaskLog as a2, drainNext as a3, executionSummary as a4, followTurn as a5, fromTranscript as a6, hasHiddenDetail as a7, holdPrompt as a8, outputLines as a9, outputPreview as aa, parseTaskOpsJson as ab, reduceConversation as ac, reduceTaskLog as ad, replayTaskLog as ae, runnerToolSubject as af, serializePlan as ag, serializeTask as ah, serializeTaskStatus as ai, stopTurn as aj, summarizeToolCall as ak, taskStartedNotice as al, textHasTaskOps as am, toTaskLogEvent as an, toolHeadline as ao, trimToolOutput as ap, truncateCheckpointSummary as aq, unsendAll as ar, unsendLatest as as, type ApprovalStatus as b, type ConversationInput as c, type ConversationView as d, type DiffRowKind as e, type DiffStat as f, type DisplayBlock as g, EMPTY_HOLD as h, EMPTY_TASK_LOG as i, type MessageBlock as j, type MessageRole as k, type PlanMarkerStatus as l, type PromptHold as m, type SerializedTask as n, type SerializedTaskStatus as o, type SessionBroadcaster as p, type SessionMessage as q, type SessionNotice as r, type SubagentBlock as s, type SubagentChild as t, type SubagentStatus as u, type TaskLogEvent as v, type TaskLogView as w, type TaskOp as x, type TaskRef as y, type ThinkingDisplayBlock as z };
+/**
+ * What a row's status means to a reader, before any surface picks a word,
+ * icon or colour for it. `quiet` is a running task whose runner has printed
+ * nothing for a while — the status is still `in_progress`, so only the row,
+ * never the store, tells the two apart.
+ */
+type TaskStatusKind = 'todo' | 'running' | 'quiet' | 'awaiting' | 'blocked' | 'failed' | 'done';
+/** A task with a runner live behind it. `in_progress` is the store's own status. */
+declare const isTaskRunning: (task: {
+    status: string;
+}) => boolean;
+/** Statuses of a task that has not started: what can still be started by hand, or flipped between change and ops (ADR-0020). */
+declare const NOT_STARTED: ReadonlySet<string>;
+declare function taskStatusKind(task: {
+    status: string;
+    idleSince?: string | null;
+}): TaskStatusKind;
+/** What an awaiting_user task waits on (ADR-0018, W1); null when no reason was saved. */
+declare function awaitingLabel(task: {
+    status: string;
+    awaitingReason?: AwaitingReason;
+}): string | null;
+/** Runner requests a task waits on (ADR-0018, A1); null when none do. */
+declare function approvalLabel(count: number | undefined): string | null;
+
+/** What a user can do to one task from its row. */
+type TaskRowAction = 'cancel' | 'skip' | 'force-start' | 'complete' | 'uncomplete';
+/** A subtask runs with its parent, so its row offers a different set than a top-level task's. */
+type TaskRowPlacement = 'task' | 'subtask';
+interface ActionSubject {
+    status: string;
+    type: 'ai' | 'user';
+}
+/** The actions a task's row offers while a plan runs, in the order they are laid out. */
+declare function taskRowActions(task: ActionSubject, placement?: TaskRowPlacement): TaskRowAction[];
+/**
+ * One toggle in both directions: a done task is taken back, anything else is
+ * marked done. A second control for the reverse is one nobody remembers.
+ */
+declare function markAction(task: {
+    status: string;
+}): 'complete' | 'uncomplete';
+/**
+ * The mark an action asks the session for, or null when it is not a mark.
+ * Skip has no request of its own: a skipped task is marked complete, so the
+ * run moves on past it.
+ */
+declare function markRequestFor(action: string): 'complete' | 'uncomplete' | null;
+/** Change versus ops can still be flipped (ADR-0020): an AI task that has not started. */
+declare function opsEditable(task: ActionSubject): boolean;
+
+/**
+ * A task as both surfaces hold it, with the live state each tracks beside it
+ * (silence, approvals, isolation, the merge gate). Structural, because the TUI
+ * projects tasks into its own shape.
+ */
+interface TaskRowSubject {
+    id: string;
+    order: number;
+    type: 'ai' | 'user';
+    status: string;
+    dependencies: readonly string[];
+    taskMode?: string;
+    ops?: boolean;
+    idleSince?: string | null;
+    awaitingReason?: AwaitingReason;
+    awaitingApproval?: number;
+    isolation?: TaskRowIsolation | null;
+    mergeGate?: readonly string[];
+    forcedPastGate?: readonly string[];
+}
+interface TaskRowIsolation {
+    state: TaskIsolationState;
+    repos?: string[];
+    conflictRepo?: string;
+    conflictFiles?: string[];
+    repair?: {
+        attempt: number;
+        limit: number;
+    };
+    repairedFiles?: string[];
+}
+interface TaskRowContext {
+    /** Set for a subtask: it is labelled by its dotted order. */
+    parent?: {
+        order: number;
+    } | null;
+    /** Which action set the row offers; a row with a parent is a subtask's unless told otherwise. */
+    placement?: TaskRowPlacement;
+    /** Order of each task a dependency or gate may name; one missing from it is shown by id. */
+    orderOf?: ReadonlyMap<string, number>;
+    /** The modes the task's runner declares; autonomy is a tag on one of them (ADR-0001). */
+    modes?: readonly {
+        id: string;
+        autonomous?: boolean;
+    }[];
+}
+/** Whether the row stands for an AI task, a manual one, or an ops task (ADR-0020). */
+type TaskRowKind = 'ai' | 'user' | 'ops';
+interface TaskRowView {
+    /** "2", or "2.1" for a subtask. */
+    orderLabel: string;
+    kind: TaskRowKind;
+    status: TaskStatusKind;
+    /** A runner is live behind it — `quiet` included. */
+    running: boolean;
+    /** What an awaiting task waits on, in sentence case; null when nothing was saved. */
+    awaiting: string | null;
+    /** Runner requests waiting on the user, in sentence case; null when none do. */
+    approvals: string | null;
+    /** The task's mode is tagged autonomous: it runs without permission prompts. */
+    autonomous: boolean;
+    /** The repos its isolated work changed, by path; empty for a group of one. */
+    repos: string[];
+    /** Integration stopped on a conflict: the one isolation state that needs the user. */
+    conflict: {
+        repo: string | null;
+        files: string | null;
+    } | null;
+    /** A conflict repair in flight (ADR-0015) — progress, not a blocker. */
+    repairing: {
+        files: string | null;
+        attempt: {
+            attempt: number;
+            limit: number;
+        } | null;
+    } | null;
+    /** The files a conflict repair was started for; `landed` once the task is integrated. */
+    repaired: {
+        files: string;
+        landed: boolean;
+    } | null;
+    /** The dependencies, by reference, whose work is not merged into the user's branch yet. */
+    mergeGate: string[] | null;
+    /** An ops task changed tracked files in the user's checkout and nothing was committed. */
+    opsChangedFiles: boolean;
+    /** The dependencies, by title, a force start went past the merge gate of. */
+    forcedPastGate: readonly string[] | null;
+    /** The task's dependencies, by reference. */
+    dependencies: string[];
+    /** What the row offers while a plan runs. */
+    actions: TaskRowAction[];
+    /** The one mark its toggle sets. */
+    mark: 'complete' | 'uncomplete';
+    opsEditable: boolean;
+}
+/** The repos a task changed, for a row that names them; none for a group of one. */
+declare const namedRepos: (repos: readonly string[] | undefined) => string[];
+/**
+ * Everything a plan row says about one task, decided once: each surface picks
+ * its own words, glyphs and casing for these facts, and derives none of them.
+ */
+declare function taskRowView(task: TaskRowSubject, context?: TaskRowContext): TaskRowView;
+
+interface Named {
+    id: string;
+    order: number;
+    title: string;
+    subtasks?: readonly Named[];
+}
+/** Each id as "#N title", subtasks included; one the plan no longer holds stays a bare id. */
+declare function titledRefs(ids: readonly string[], tasks: readonly Named[]): string[];
+/**
+ * What removing a task does to the tasks that depend on it, or null when none
+ * do. Named rather than counted: the removal rewrites their dependency lists,
+ * and a bare "Remove task?" would hide that.
+ */
+declare function dependentsNotice(dependents: readonly {
+    order: number;
+    title: string;
+}[]): string | null;
+/**
+ * What a start past a merge gate is asked with (ADR-0020): the work the task
+ * would act without, named. `subject` is how the asking surface refers to the
+ * task — "It" under a title that already names it.
+ */
+declare function pastGateConfirmation(unmerged: readonly string[], subject?: string): string;
+interface NewTaskFields {
+    title: string;
+    description: string;
+    prompt: string;
+    type: 'ai';
+}
+/**
+ * What a hand-added task starts as: an AI task whose description is its title
+ * and whose prompt, unless one was typed, is too. Null for a title with nothing
+ * in it, rather than a nameless task. Assignments are left for the session to
+ * derive from the runner's catalog.
+ */
+declare function newTaskFields(title: string, prompt?: string): NewTaskFields | null;
+
+export { type UsageBlock as $, type ApplyTaskOpsResult as A, type TaskOp as B, CHECKPOINT_TRUNCATE_LENGTH as C, type DiffRow as D, EMPTY_CONVERSATION as E, type TaskRef as F, type GatedConversation as G, type TaskRowAction as H, type TaskRowContext as I, type TaskRowIsolation as J, type TaskRowKind as K, type LocalEntry as L, type MergeGateView as M, NOT_STARTED as N, type OutputPreview as O, type PlanBlock as P, type TaskRowPlacement as Q, type TaskRowSubject as R, type SerializedPlan as S, type TakenPrompt as T, type TaskRowView as U, type TaskStatusKind as V, type ThinkingDisplayBlock as W, type ToolBlock as X, type ToolHeadline as Y, type ToolStatus as Z, type TurnGate as _, type ApprovalBlock as a, aheadOfDraft as a0, applyTaskOps as a1, approvalLabel as a2, awaitingLabel as a3, canMergeTasks as a4, canSetDependencies as a5, canSplitTask as a6, capConflictFiles as a7, classifyOutcome as a8, coalesceTaskLog as a9, runnerToolSubject as aA, serializePlan as aB, serializeTask as aC, serializeTaskStatus as aD, stopTurn as aE, summarizeToolCall as aF, taskRowActions as aG, taskRowView as aH, taskStartedNotice as aI, taskStatusKind as aJ, textHasTaskOps as aK, titledRefs as aL, toTaskLogEvent as aM, toolHeadline as aN, trimToolOutput as aO, truncateCheckpointSummary as aP, unsendAll as aQ, unsendLatest as aR, dependencyCandidates as aa, dependentsNotice as ab, dependentsOf as ac, diffRows as ad, diffStat as ae, diffSummary as af, digestTaskLog as ag, drainNext as ah, executionSummary as ai, followTurn as aj, fromTranscript as ak, hasHiddenDetail as al, holdPrompt as am, isTaskRunning as an, markAction as ao, markRequestFor as ap, namedRepos as aq, newTaskFields as ar, opsEditable as as, outputLines as at, outputPreview as au, parseTaskOpsJson as av, pastGateConfirmation as aw, reduceConversation as ax, reduceTaskLog as ay, replayTaskLog as az, type ApprovalStatus as b, type ConversationInput as c, type ConversationView as d, type DiffRowKind as e, type DiffStat as f, type DisplayBlock as g, EMPTY_HOLD as h, EMPTY_TASK_LOG as i, type EditCatalog as j, type MessageBlock as k, type MessageRole as l, NO_TURN as m, type NewTaskFields as n, type PlanMarkerStatus as o, type PromptHold as p, type SerializedTask as q, type SerializedTaskStatus as r, type SessionBroadcaster as s, type SessionMessage as t, type SessionNotice as u, type SubagentBlock as v, type SubagentChild as w, type SubagentStatus as x, type TaskLogEvent as y, type TaskLogView as z };

package/dist/{plan-utils-BdYPRBno.d.ts → plan-utils-D4Z8UyLL.d.ts}

@@ -1,5 +1,6 @@
-import { b7 as StructuredTurnEnd, b9 as SubagentOutcome, bz as UsageRecord, k as ApprovalDecision, b5 as StructuredEvent, aX as RunnerId, y as DiscoveredModel, bc as Task, a9 as LegacyPlanState, aN as QueuedMessage, bA as UsageTotals, bG as Verdict, be as TaskIsolation, bt as TaskTransport, r as AwaitingReason, aO as QueuedTaskMessage, T as IsolationHandoff, _ as IsolationMergeResult, aT as ResearchStep, l as ApprovalKind, q as ApprovalSource, aU as ResearchStepOutcome, w as ConversationMessage, aR as ResearchLogEntry, az as PlannerUsage } from './Task-CoKhvBa1.js';
-import { R as RunnerModeInfo } from './ModeResolver-BEcRAz1c.js';
+import { bc as StructuredTurnEnd, be as SubagentOutcome, bF as UsageRecord, k as ApprovalDecision, ba as StructuredEvent, b0 as RunnerId, z as DiscoveredModel, bi as Task, ac as LegacyPlanState, aR as QueuedMessage, bG as UsageTotals, bM as Verdict, bk as TaskIsolation, bz as TaskTransport, r as AwaitingReason, aS as QueuedTaskMessage, U as IsolationHandoff, $ as IsolationMergeResult, aY as ResearchStep, l as ApprovalKind, q as ApprovalSource, aZ as ResearchStepOutcome, w as ConversationMessage, aW as ResearchLogEntry, aC as PlannerUsage, bl as TaskIsolationState } from './Task-BpzIbunq.js';
+import { R as RunnerModeInfo } from './ModeResolver-DtfhWeVL.js';
+import './order-labels.js';
 
 /**
  * One entry of a structured task's log (ADR-0018, P1): what a runner did,
@@ -11,11 +12,12 @@ import { R as RunnerModeInfo } from './ModeResolver-BEcRAz1c.js';
  * without a format version.
  */
 type TaskLogEvent = 
-/** A turn began by delivering `message`; `messageId` names it when it had been queued. */
+/** A turn began by delivering `message`; `messageId` names it when it had been queued, `forced` when it was force sent. */
 {
     type: 'turn_start';
     message: string;
     messageId?: string;
+    forced?: boolean;
 } | {
     type: 'turn_end';
     reason: StructuredTurnEnd;
@@ -65,13 +67,37 @@ type TaskLogEvent =
 } | {
     type: 'usage';
     record: UsageRecord;
-} | {
+}
+/**
+ * Waiting in Ordewell's queue — again, for a message the runner was handed
+ * and let go of (ADR-0023, D4). `forced` moves it ahead of the rest (F2).
+ */
+ | {
     type: 'message_queued';
     messageId: string;
     text: string;
+    forced?: boolean;
 } | {
     type: 'message_removed';
     messageId: string;
+} | {
+    type: 'message_undelivered';
+    messageId: string;
+    text: string;
+}
+/** The runner accepted a queued message into its running turn; it can no longer be taken back. */
+ | {
+    type: 'message_handed_over';
+    messageId: string;
+}
+/**
+ * The model read a message inside its running turn (ADR-0023, Q2), logged
+ * where it read it. A message that opened a turn is that turn's `turn_start`.
+ */
+ | {
+    type: 'message_delivered';
+    messageId: string;
+    text: string;
 }
 /** The agent's own words for a failed turn. */
  | {
@@ -263,6 +289,8 @@ type SerializedTaskStatus = {
     transport?: Pick<TaskTransport, 'kind' | 'fallback'>;
     /** What an `awaiting_user` task waits on, when it was saved (ADR-0018, W1). */
     awaitingReason?: AwaitingReason;
+    /** The whole question of the checkpoint the task waits at; absent when it waits at none. */
+    checkpoint?: string;
     /** Messages waiting for a structured task's turn to end, oldest first; absent when there are none. */
     queued?: QueuedTaskMessage[];
     /** Set when the task can be continued in its saved runner session (ADR-0018, K1); the id itself stays in the daemon. */
@@ -483,8 +511,6 @@ type SessionMessage =
     };
 } | {
     type: 'execution_stopped';
-} | {
-    type: 'queue_ready';
 } | {
     type: 'task_updated';
     taskId: string;
@@ -578,7 +604,7 @@ type SessionNotice = {
 };
 type SessionBroadcaster = (msg: SessionMessage) => void;
 declare function serializeTask(t: Task): SerializedTask;
-declare function serializeTaskStatus(t: Task, idleSince?: string | null, isolation?: TaskIsolation | null, queued?: readonly QueuedTaskMessage[], awaitingApproval?: number, mergeGate?: readonly string[]): SerializedTaskStatus;
+declare function serializeTaskStatus(t: Task, idleSince?: string | null, isolation?: TaskIsolation | null, queued?: readonly QueuedTaskMessage[], awaitingApproval?: number, mergeGate?: readonly string[], checkpoint?: string): SerializedTaskStatus;
 declare function serializePlan(plan: LegacyPlanState): SerializedPlan;
 declare function executionSummary(tasks: readonly Task[]): {
     total: number;
@@ -794,7 +820,7 @@ declare function fromTranscript(conversationHistory: readonly ConversationMessag
  * one at a time.
  */
 interface TaskLogView extends BlockList {
-    /** Messages waiting for the running turn to end, oldest first. */
+    /** Messages not yet delivered, oldest first; `handedOver` marks the ones the runner already has. */
     readonly queued: readonly QueuedTaskMessage[];
     /** A turn is running. */
     readonly working: boolean;
@@ -925,4 +951,195 @@ declare function hasHiddenDetail(blocks: readonly DisplayBlock[]): boolean;
 /** The conversation line for a task starting, worded the same on every surface. */
 declare function taskStartedNotice(title: string, runner?: string): string;
 
-export { diffRows as $, type ApplyTaskOpsResult as A, type ToolBlock as B, CHECKPOINT_TRUNCATE_LENGTH as C, type DiffRow as D, EMPTY_CONVERSATION as E, type ToolHeadline as F, type GatedConversation as G, type ToolStatus as H, type TurnGate as I, aheadOfDraft as J, applyTaskOps as K, type LocalEntry as L, type MergeGateView as M, NO_TURN as N, type OutputPreview as O, type PlanBlock as P, canMergeTasks as Q, canSetDependencies as R, type SerializedPlan as S, type TakenPrompt as T, type UsageBlock as U, canSplitTask as V, capConflictFiles as W, classifyOutcome as X, coalesceTaskLog as Y, dependencyCandidates as Z, dependentsOf as _, type ApprovalBlock as a, diffStat as a0, diffSummary as a1, digestTaskLog as a2, drainNext as a3, executionSummary as a4, followTurn as a5, fromTranscript as a6, hasHiddenDetail as a7, holdPrompt as a8, outputLines as a9, outputPreview as aa, parseTaskOpsJson as ab, reduceConversation as ac, reduceTaskLog as ad, replayTaskLog as ae, runnerToolSubject as af, serializePlan as ag, serializeTask as ah, serializeTaskStatus as ai, stopTurn as aj, summarizeToolCall as ak, taskStartedNotice as al, textHasTaskOps as am, toTaskLogEvent as an, toolHeadline as ao, trimToolOutput as ap, truncateCheckpointSummary as aq, unsendAll as ar, unsendLatest as as, type ApprovalStatus as b, type ConversationInput as c, type ConversationView as d, type DiffRowKind as e, type DiffStat as f, type DisplayBlock as g, EMPTY_HOLD as h, EMPTY_TASK_LOG as i, type MessageBlock as j, type MessageRole as k, type PlanMarkerStatus as l, type PromptHold as m, type SerializedTask as n, type SerializedTaskStatus as o, type SessionBroadcaster as p, type SessionMessage as q, type SessionNotice as r, type SubagentBlock as s, type SubagentChild as t, type SubagentStatus as u, type TaskLogEvent as v, type TaskLogView as w, type TaskOp as x, type TaskRef as y, type ThinkingDisplayBlock as z };
+/**
+ * What a row's status means to a reader, before any surface picks a word,
+ * icon or colour for it. `quiet` is a running task whose runner has printed
+ * nothing for a while — the status is still `in_progress`, so only the row,
+ * never the store, tells the two apart.
+ */
+type TaskStatusKind = 'todo' | 'running' | 'quiet' | 'awaiting' | 'blocked' | 'failed' | 'done';
+/** A task with a runner live behind it. `in_progress` is the store's own status. */
+declare const isTaskRunning: (task: {
+    status: string;
+}) => boolean;
+/** Statuses of a task that has not started: what can still be started by hand, or flipped between change and ops (ADR-0020). */
+declare const NOT_STARTED: ReadonlySet<string>;
+declare function taskStatusKind(task: {
+    status: string;
+    idleSince?: string | null;
+}): TaskStatusKind;
+/** What an awaiting_user task waits on (ADR-0018, W1); null when no reason was saved. */
+declare function awaitingLabel(task: {
+    status: string;
+    awaitingReason?: AwaitingReason;
+}): string | null;
+/** Runner requests a task waits on (ADR-0018, A1); null when none do. */
+declare function approvalLabel(count: number | undefined): string | null;
+
+/** What a user can do to one task from its row. */
+type TaskRowAction = 'cancel' | 'skip' | 'force-start' | 'complete' | 'uncomplete';
+/** A subtask runs with its parent, so its row offers a different set than a top-level task's. */
+type TaskRowPlacement = 'task' | 'subtask';
+interface ActionSubject {
+    status: string;
+    type: 'ai' | 'user';
+}
+/** The actions a task's row offers while a plan runs, in the order they are laid out. */
+declare function taskRowActions(task: ActionSubject, placement?: TaskRowPlacement): TaskRowAction[];
+/**
+ * One toggle in both directions: a done task is taken back, anything else is
+ * marked done. A second control for the reverse is one nobody remembers.
+ */
+declare function markAction(task: {
+    status: string;
+}): 'complete' | 'uncomplete';
+/**
+ * The mark an action asks the session for, or null when it is not a mark.
+ * Skip has no request of its own: a skipped task is marked complete, so the
+ * run moves on past it.
+ */
+declare function markRequestFor(action: string): 'complete' | 'uncomplete' | null;
+/** Change versus ops can still be flipped (ADR-0020): an AI task that has not started. */
+declare function opsEditable(task: ActionSubject): boolean;
+
+/**
+ * A task as both surfaces hold it, with the live state each tracks beside it
+ * (silence, approvals, isolation, the merge gate). Structural, because the TUI
+ * projects tasks into its own shape.
+ */
+interface TaskRowSubject {
+    id: string;
+    order: number;
+    type: 'ai' | 'user';
+    status: string;
+    dependencies: readonly string[];
+    taskMode?: string;
+    ops?: boolean;
+    idleSince?: string | null;
+    awaitingReason?: AwaitingReason;
+    awaitingApproval?: number;
+    isolation?: TaskRowIsolation | null;
+    mergeGate?: readonly string[];
+    forcedPastGate?: readonly string[];
+}
+interface TaskRowIsolation {
+    state: TaskIsolationState;
+    repos?: string[];
+    conflictRepo?: string;
+    conflictFiles?: string[];
+    repair?: {
+        attempt: number;
+        limit: number;
+    };
+    repairedFiles?: string[];
+}
+interface TaskRowContext {
+    /** Set for a subtask: it is labelled by its dotted order. */
+    parent?: {
+        order: number;
+    } | null;
+    /** Which action set the row offers; a row with a parent is a subtask's unless told otherwise. */
+    placement?: TaskRowPlacement;
+    /** Order of each task a dependency or gate may name; one missing from it is shown by id. */
+    orderOf?: ReadonlyMap<string, number>;
+    /** The modes the task's runner declares; autonomy is a tag on one of them (ADR-0001). */
+    modes?: readonly {
+        id: string;
+        autonomous?: boolean;
+    }[];
+}
+/** Whether the row stands for an AI task, a manual one, or an ops task (ADR-0020). */
+type TaskRowKind = 'ai' | 'user' | 'ops';
+interface TaskRowView {
+    /** "2", or "2.1" for a subtask. */
+    orderLabel: string;
+    kind: TaskRowKind;
+    status: TaskStatusKind;
+    /** A runner is live behind it — `quiet` included. */
+    running: boolean;
+    /** What an awaiting task waits on, in sentence case; null when nothing was saved. */
+    awaiting: string | null;
+    /** Runner requests waiting on the user, in sentence case; null when none do. */
+    approvals: string | null;
+    /** The task's mode is tagged autonomous: it runs without permission prompts. */
+    autonomous: boolean;
+    /** The repos its isolated work changed, by path; empty for a group of one. */
+    repos: string[];
+    /** Integration stopped on a conflict: the one isolation state that needs the user. */
+    conflict: {
+        repo: string | null;
+        files: string | null;
+    } | null;
+    /** A conflict repair in flight (ADR-0015) — progress, not a blocker. */
+    repairing: {
+        files: string | null;
+        attempt: {
+            attempt: number;
+            limit: number;
+        } | null;
+    } | null;
+    /** The files a conflict repair was started for; `landed` once the task is integrated. */
+    repaired: {
+        files: string;
+        landed: boolean;
+    } | null;
+    /** The dependencies, by reference, whose work is not merged into the user's branch yet. */
+    mergeGate: string[] | null;
+    /** An ops task changed tracked files in the user's checkout and nothing was committed. */
+    opsChangedFiles: boolean;
+    /** The dependencies, by title, a force start went past the merge gate of. */
+    forcedPastGate: readonly string[] | null;
+    /** The task's dependencies, by reference. */
+    dependencies: string[];
+    /** What the row offers while a plan runs. */
+    actions: TaskRowAction[];
+    /** The one mark its toggle sets. */
+    mark: 'complete' | 'uncomplete';
+    opsEditable: boolean;
+}
+/** The repos a task changed, for a row that names them; none for a group of one. */
+declare const namedRepos: (repos: readonly string[] | undefined) => string[];
+/**
+ * Everything a plan row says about one task, decided once: each surface picks
+ * its own words, glyphs and casing for these facts, and derives none of them.
+ */
+declare function taskRowView(task: TaskRowSubject, context?: TaskRowContext): TaskRowView;
+
+interface Named {
+    id: string;
+    order: number;
+    title: string;
+    subtasks?: readonly Named[];
+}
+/** Each id as "#N title", subtasks included; one the plan no longer holds stays a bare id. */
+declare function titledRefs(ids: readonly string[], tasks: readonly Named[]): string[];
+/**
+ * What removing a task does to the tasks that depend on it, or null when none
+ * do. Named rather than counted: the removal rewrites their dependency lists,
+ * and a bare "Remove task?" would hide that.
+ */
+declare function dependentsNotice(dependents: readonly {
+    order: number;
+    title: string;
+}[]): string | null;
+/**
+ * What a start past a merge gate is asked with (ADR-0020): the work the task
+ * would act without, named. `subject` is how the asking surface refers to the
+ * task — "It" under a title that already names it.
+ */
+declare function pastGateConfirmation(unmerged: readonly string[], subject?: string): string;
+interface NewTaskFields {
+    title: string;
+    description: string;
+    prompt: string;
+    type: 'ai';
+}
+/**
+ * What a hand-added task starts as: an AI task whose description is its title
+ * and whose prompt, unless one was typed, is too. Null for a title with nothing
+ * in it, rather than a nameless task. Assignments are left for the session to
+ * derive from the runner's catalog.
+ */
+declare function newTaskFields(title: string, prompt?: string): NewTaskFields | null;
+
+export { type UsageBlock as $, type ApplyTaskOpsResult as A, type TaskOp as B, CHECKPOINT_TRUNCATE_LENGTH as C, type DiffRow as D, EMPTY_CONVERSATION as E, type TaskRef as F, type GatedConversation as G, type TaskRowAction as H, type TaskRowContext as I, type TaskRowIsolation as J, type TaskRowKind as K, type LocalEntry as L, type MergeGateView as M, NOT_STARTED as N, type OutputPreview as O, type PlanBlock as P, type TaskRowPlacement as Q, type TaskRowSubject as R, type SerializedPlan as S, type TakenPrompt as T, type TaskRowView as U, type TaskStatusKind as V, type ThinkingDisplayBlock as W, type ToolBlock as X, type ToolHeadline as Y, type ToolStatus as Z, type TurnGate as _, type ApprovalBlock as a, aheadOfDraft as a0, applyTaskOps as a1, approvalLabel as a2, awaitingLabel as a3, canMergeTasks as a4, canSetDependencies as a5, canSplitTask as a6, capConflictFiles as a7, classifyOutcome as a8, coalesceTaskLog as a9, runnerToolSubject as aA, serializePlan as aB, serializeTask as aC, serializeTaskStatus as aD, stopTurn as aE, summarizeToolCall as aF, taskRowActions as aG, taskRowView as aH, taskStartedNotice as aI, taskStatusKind as aJ, textHasTaskOps as aK, titledRefs as aL, toTaskLogEvent as aM, toolHeadline as aN, trimToolOutput as aO, truncateCheckpointSummary as aP, unsendAll as aQ, unsendLatest as aR, dependencyCandidates as aa, dependentsNotice as ab, dependentsOf as ac, diffRows as ad, diffStat as ae, diffSummary as af, digestTaskLog as ag, drainNext as ah, executionSummary as ai, followTurn as aj, fromTranscript as ak, hasHiddenDetail as al, holdPrompt as am, isTaskRunning as an, markAction as ao, markRequestFor as ap, namedRepos as aq, newTaskFields as ar, opsEditable as as, outputLines as at, outputPreview as au, parseTaskOpsJson as av, pastGateConfirmation as aw, reduceConversation as ax, reduceTaskLog as ay, replayTaskLog as az, type ApprovalStatus as b, type ConversationInput as c, type ConversationView as d, type DiffRowKind as e, type DiffStat as f, type DisplayBlock as g, EMPTY_HOLD as h, EMPTY_TASK_LOG as i, type EditCatalog as j, type MessageBlock as k, type MessageRole as l, NO_TURN as m, type NewTaskFields as n, type PlanMarkerStatus as o, type PromptHold as p, type SerializedTask as q, type SerializedTaskStatus as r, type SessionBroadcaster as s, type SessionMessage as t, type SessionNotice as u, type SubagentBlock as v, type SubagentChild as w, type SubagentStatus as x, type TaskLogEvent as y, type TaskLogView as z };

package/dist/plan-utils.d.mts

@@ -1,6 +1,7 @@
-export { a as ApprovalBlock, b as ApprovalStatus, C as CHECKPOINT_TRUNCATE_LENGTH, c as ConversationInput, d as ConversationView, D as DiffRow, e as DiffRowKind, f as DiffStat, g as DisplayBlock, E as EMPTY_CONVERSATION, h as EMPTY_HOLD, i as EMPTY_TASK_LOG, G as GatedConversation, L as LocalEntry, j as MessageBlock, k as MessageRole, N as NO_TURN, O as OutputPreview, P as PlanBlock, l as PlanMarkerStatus, m as PromptHold, s as SubagentBlock, t as SubagentChild, u as SubagentStatus, T as TakenPrompt, w as TaskLogView, y as TaskRef, z as ThinkingDisplayBlock, B as ToolBlock, F as ToolHeadline, H as ToolStatus, I as TurnGate, U as UsageBlock, J as aheadOfDraft, Q as canMergeTasks, R as canSetDependencies, V as canSplitTask, W as capConflictFiles, Z as dependencyCandidates, _ as dependentsOf, $ as diffRows, a0 as diffStat, a1 as diffSummary, a3 as drainNext, a5 as followTurn, a6 as fromTranscript, a7 as hasHiddenDetail, a8 as holdPrompt, a9 as outputLines, aa as outputPreview, ac as reduceConversation, ad as reduceTaskLog, ae as replayTaskLog, af as runnerToolSubject, aj as stopTurn, ak as summarizeToolCall, al as taskStartedNotice, ao as toolHeadline, aq as truncateCheckpointSummary, ar as unsendAll, as as unsendLatest } from './plan-utils-CD1Xu65s.mjs';
-import './Task-CoKhvBa1.mjs';
+export { a as ApprovalBlock, b as ApprovalStatus, C as CHECKPOINT_TRUNCATE_LENGTH, c as ConversationInput, d as ConversationView, D as DiffRow, e as DiffRowKind, f as DiffStat, g as DisplayBlock, E as EMPTY_CONVERSATION, h as EMPTY_HOLD, i as EMPTY_TASK_LOG, G as GatedConversation, L as LocalEntry, k as MessageBlock, l as MessageRole, N as NOT_STARTED, m as NO_TURN, n as NewTaskFields, O as OutputPreview, P as PlanBlock, o as PlanMarkerStatus, p as PromptHold, v as SubagentBlock, w as SubagentChild, x as SubagentStatus, T as TakenPrompt, z as TaskLogView, F as TaskRef, H as TaskRowAction, I as TaskRowContext, J as TaskRowIsolation, K as TaskRowKind, Q as TaskRowPlacement, R as TaskRowSubject, U as TaskRowView, V as TaskStatusKind, W as ThinkingDisplayBlock, X as ToolBlock, Y as ToolHeadline, Z as ToolStatus, _ as TurnGate, $ as UsageBlock, a0 as aheadOfDraft, a2 as approvalLabel, a3 as awaitingLabel, a4 as canMergeTasks, a5 as canSetDependencies, a6 as canSplitTask, a7 as capConflictFiles, aa as dependencyCandidates, ab as dependentsNotice, ac as dependentsOf, ad as diffRows, ae as diffStat, af as diffSummary, ah as drainNext, aj as followTurn, ak as fromTranscript, al as hasHiddenDetail, am as holdPrompt, an as isTaskRunning, ao as markAction, ap as markRequestFor, aq as namedRepos, ar as newTaskFields, as as opsEditable, at as outputLines, au as outputPreview, aw as pastGateConfirmation, ax as reduceConversation, ay as reduceTaskLog, az as replayTaskLog, aA as runnerToolSubject, aE as stopTurn, aF as summarizeToolCall, aG as taskRowActions, aH as taskRowView, aI as taskStartedNotice, aJ as taskStatusKind, aL as titledRefs, aN as toolHeadline, aP as truncateCheckpointSummary, aQ as unsendAll, aR as unsendLatest } from './plan-utils-CdW3mxt5.mjs';
+export { taskOrderLabel, taskRef, titledTaskRef } from './order-labels.mjs';
+export { D as DEFAULT_RUNNERS } from './Task-BpzIbunq.mjs';
+import './ModeResolver-DcqAho4y.mjs';
 import 'child_process';
 import 'events';
 import 'zod/v4';
-import './ModeResolver-Cv01ZDd9.mjs';

package/dist/plan-utils.d.ts

@@ -1,6 +1,7 @@
-export { a as ApprovalBlock, b as ApprovalStatus, C as CHECKPOINT_TRUNCATE_LENGTH, c as ConversationInput, d as ConversationView, D as DiffRow, e as DiffRowKind, f as DiffStat, g as DisplayBlock, E as EMPTY_CONVERSATION, h as EMPTY_HOLD, i as EMPTY_TASK_LOG, G as GatedConversation, L as LocalEntry, j as MessageBlock, k as MessageRole, N as NO_TURN, O as OutputPreview, P as PlanBlock, l as PlanMarkerStatus, m as PromptHold, s as SubagentBlock, t as SubagentChild, u as SubagentStatus, T as TakenPrompt, w as TaskLogView, y as TaskRef, z as ThinkingDisplayBlock, B as ToolBlock, F as ToolHeadline, H as ToolStatus, I as TurnGate, U as UsageBlock, J as aheadOfDraft, Q as canMergeTasks, R as canSetDependencies, V as canSplitTask, W as capConflictFiles, Z as dependencyCandidates, _ as dependentsOf, $ as diffRows, a0 as diffStat, a1 as diffSummary, a3 as drainNext, a5 as followTurn, a6 as fromTranscript, a7 as hasHiddenDetail, a8 as holdPrompt, a9 as outputLines, aa as outputPreview, ac as reduceConversation, ad as reduceTaskLog, ae as replayTaskLog, af as runnerToolSubject, aj as stopTurn, ak as summarizeToolCall, al as taskStartedNotice, ao as toolHeadline, aq as truncateCheckpointSummary, ar as unsendAll, as as unsendLatest } from './plan-utils-BdYPRBno.js';
-import './Task-CoKhvBa1.js';
+export { a as ApprovalBlock, b as ApprovalStatus, C as CHECKPOINT_TRUNCATE_LENGTH, c as ConversationInput, d as ConversationView, D as DiffRow, e as DiffRowKind, f as DiffStat, g as DisplayBlock, E as EMPTY_CONVERSATION, h as EMPTY_HOLD, i as EMPTY_TASK_LOG, G as GatedConversation, L as LocalEntry, k as MessageBlock, l as MessageRole, N as NOT_STARTED, m as NO_TURN, n as NewTaskFields, O as OutputPreview, P as PlanBlock, o as PlanMarkerStatus, p as PromptHold, v as SubagentBlock, w as SubagentChild, x as SubagentStatus, T as TakenPrompt, z as TaskLogView, F as TaskRef, H as TaskRowAction, I as TaskRowContext, J as TaskRowIsolation, K as TaskRowKind, Q as TaskRowPlacement, R as TaskRowSubject, U as TaskRowView, V as TaskStatusKind, W as ThinkingDisplayBlock, X as ToolBlock, Y as ToolHeadline, Z as ToolStatus, _ as TurnGate, $ as UsageBlock, a0 as aheadOfDraft, a2 as approvalLabel, a3 as awaitingLabel, a4 as canMergeTasks, a5 as canSetDependencies, a6 as canSplitTask, a7 as capConflictFiles, aa as dependencyCandidates, ab as dependentsNotice, ac as dependentsOf, ad as diffRows, ae as diffStat, af as diffSummary, ah as drainNext, aj as followTurn, ak as fromTranscript, al as hasHiddenDetail, am as holdPrompt, an as isTaskRunning, ao as markAction, ap as markRequestFor, aq as namedRepos, ar as newTaskFields, as as opsEditable, at as outputLines, au as outputPreview, aw as pastGateConfirmation, ax as reduceConversation, ay as reduceTaskLog, az as replayTaskLog, aA as runnerToolSubject, aE as stopTurn, aF as summarizeToolCall, aG as taskRowActions, aH as taskRowView, aI as taskStartedNotice, aJ as taskStatusKind, aL as titledRefs, aN as toolHeadline, aP as truncateCheckpointSummary, aQ as unsendAll, aR as unsendLatest } from './plan-utils-D4Z8UyLL.js';
+export { taskOrderLabel, taskRef, titledTaskRef } from './order-labels.js';
+export { D as DEFAULT_RUNNERS } from './Task-BpzIbunq.js';
+import './ModeResolver-DtfhWeVL.js';
 import 'child_process';
 import 'events';
 import 'zod/v4';
-import './ModeResolver-BEcRAz1c.js';