@ordewell/core 0.5.4 → 0.5.5

package/dist/plan-utils-CtB3_Ovf.d.mts

@@ -1,329 +0,0 @@
-import { q as IsolationTaskStatus, P as PlanIsolation, F as RunnerId, a as DiscoveredModel, T as Task, L as LegacyPlanState, Q as QueuedMessage, a3 as Verdict, J as TaskIsolation, d as IsolationHandoff, k as IsolationMergeResult, z as ResearchStep, B as ResearchStepOutcome } from './Task-BxQkPlXO.mjs';
-import { R as RunnerModeInfo } from './ModeResolver-DVJ7HV3k.mjs';
-import { A as ApprovalKind, e as ApprovalSource } from './ApprovalPolicy-BVhGdECT.mjs';
-
-/** A conflict's files as one surface shows them: every one, up to `max`, then how many more. */
-declare function capConflictFiles(files: string[], max?: number): string;
-/** A task record as ADR-0013 persisted it, for one repository. */
-interface Adr0013TaskRecord {
-    taskId: string;
-    order: number;
-    title: string;
-    branch: string;
-    worktree: string;
-    status: IsolationTaskStatus;
-    linked: string[];
-}
-/** A run as ADR-0013 persisted it (0.4.23): one repository, its refs on the run itself. */
-interface Adr0013IsolationRun {
-    id: string;
-    workspaceRoot: string;
-    baseRef: string;
-    baseBranch?: string;
-    integrationBranch: string;
-    tasks: Record<string, Adr0013TaskRecord>;
-}
-interface Adr0013PlanIsolation {
-    run: Adr0013IsolationRun;
-    resolvers: Record<string, string>;
-}
-/**
- * A persisted plan isolation in today's shape. A run saved in the ADR-0013
- * format — recognised by its own `integrationBranch` — becomes a group of one
- * at `.`, keeping its branches, so a session saved by 0.4.23 resumes and hands
- * off exactly as it would have.
- */
-declare function migratePlanIsolation(state: PlanIsolation | Adr0013PlanIsolation): PlanIsolation;
-
-/**
- * The catalog a model/task-mode edit is checked against — the same discovered
- * models and manifest modes the planner was shown in the per-turn catalog
- * block (`PlannerConversation.catalogBlock`), so a refusal here can never name something
- * as invalid that the planner was never told about, or vice versa.
- */
-interface EditCatalog {
-    modelsByRunner: Partial<Record<RunnerId, DiscoveredModel[]>>;
-    runnerModes: Partial<Record<RunnerId, RunnerModeInfo[]>>;
-    /** Raw (unfiltered) allowlist, keyed by runner — the same shape `coerceAssignments` takes. */
-    perRunnerAllowlist?: Partial<Record<RunnerId, string[]>>;
-}
-
-/**
- * Targeted task edits emitted by the planner conversation (the 'task_ops'
- * ConversationTurn). Task references accept a task id, a "#<order>" ref, or a
- * bare order number — cheap models rarely echo UUIDs correctly.
- */
-type TaskOp = {
-    op: 'update';
-    taskId: string;
-    changes: Partial<Task>;
-} | {
-    op: 'add';
-    task: Partial<Task>;
-    handle?: string;
-} | {
-    op: 'remove';
-    taskId: string;
-} | {
-    op: 'reorder';
-    taskIds: string[];
-} | {
-    op: 'merge';
-    taskIds: string[];
-    merged: Partial<Task>;
-    handle?: string;
-} | {
-    op: 'split';
-    taskId: string;
-    parts: Partial<Task>[];
-    handle?: string;
-} | {
-    op: 'rearm';
-    taskId: string;
-    changes?: Partial<Task>;
-};
-declare function textHasTaskOps(text: string): boolean;
-/** Parse a `{"taskOps":[...]}` reply. Throws PlanParseError when the JSON is unusable. */
-declare function parseTaskOpsJson(text: string): TaskOp[];
-interface ApplyTaskOpsResult {
-    ok: boolean;
-    tasks: Task[];
-    errors: string[];
-    /** Human-readable summary of what changed, for the chat transcript. */
-    summary: string[];
-}
-/**
- * Pre-flight check for a merge: would collapsing the selected tasks into one
- * (rewiring every dependent of any selected task to the survivor) keep the
- * dependency graph valid? Rejects locked tasks and merges whose rewiring would
- * introduce a cycle. Display order is NOT checked here — neither
- * consecutiveness (a UI concern) nor a dependency the merge pulls out of order,
- * which {@link applyTaskOps} repairs; refusing on order would make this
- * pre-flight stricter than the applier it stands in for.
- */
-declare function canMergeTasks(tasks: Task[], selectedIds: string[]): {
-    ok: boolean;
-    error?: string;
-};
-/**
- * The shape the dependency helpers below read. Structural rather than `Task`,
- * because the TUI projects tasks into its own `TaskView`: a surface's
- * dependency picker and the API's validation must agree on which dependencies
- * are legal, and a signature only core can satisfy would have forced the TUI
- * to keep a second copy of the rule.
- */
-interface TaskRef {
-    id: string;
-    order: number;
-    title: string;
-    dependencies: string[];
-}
-/** The tasks listing `taskId` as a dependency — exactly what removing it detaches. */
-declare function dependentsOf<T extends Pick<TaskRef, 'id' | 'dependencies'>>(tasks: T[], taskId: string): T[];
-/**
- * The tasks that may become dependencies of `taskId`: those displayed before it.
- *
- * Offering only earlier tasks is what keeps a hand-edited graph valid without a
- * cycle check — dependencies then only ever point backwards in display order,
- * the same invariant `applyTaskOps` enforces. Omit `taskId` for a task that does
- * not exist yet: it lands last, so every current task is a candidate.
- */
-declare function dependencyCandidates<T extends Pick<TaskRef, 'id' | 'order'>>(tasks: T[], taskId?: string): T[];
-/** Pre-flight check for a hand-edited dependency list: every id exists and comes earlier. */
-declare function canSetDependencies<T extends TaskRef>(tasks: T[], taskId: string, dependencies: string[]): {
-    ok: boolean;
-    error?: string;
-};
-/** Pre-flight check for a split: the task exists and is not locked by execution. */
-declare function canSplitTask(tasks: Task[], taskId: string): {
-    ok: boolean;
-    error?: string;
-};
-/**
- * Apply task ops to a snapshot of the plan, atomically: either every op
- * applies and the result validates (deps resolve, no cycles, running and
- * completed tasks untouched), or nothing is returned and `errors` explains
- * why. The caller commits `tasks` on ok.
- */
-declare function applyTaskOps(currentTasks: Task[], ops: TaskOp[], runners: RunnerId[], catalog?: EditCatalog): ApplyTaskOpsResult;
-
-type SerializedTaskStatus = {
-    id: string;
-    status: string;
-    verdict: {
-        outcome: 'pass' | 'fail';
-        reason: string;
-        checks: Verdict['checks'];
-    } | null;
-    /** Advisory silence timestamp from VerdictEngine — not part of task status semantics. */
-    idleSince?: string | null;
-    /** Absent unless the plan has an isolation run, so a shared-root plan's updates are unchanged. */
-    isolation?: TaskIsolation;
-};
-type SerializedTask = {
-    id: string;
-    order: number;
-    title: string;
-    type: string;
-    description: string;
-    dependencies: string[];
-    assignedRunner: RunnerId;
-    assignedModel: Task['assignedModel'] | null;
-    taskMode: string;
-    prompt: string | null;
-    subtasks: SerializedTask[];
-    userSteps: Task['userSteps'];
-    thinkingEffort: Task['thinkingEffort'];
-    autonomy: Task['autonomy'];
-    sliceType: Task['sliceType'];
-    userStoriesCovered: Task['userStoriesCovered'];
-};
-type SerializedPlan = {
-    tasks: SerializedTask[];
-    runners: RunnerId[];
-    generatedAt: string;
-    conversationHistory?: LegacyPlanState['conversationHistory'];
-    prdMarkdown?: string;
-    queuedMessages?: QueuedMessage[];
-};
-type SessionMessage = {
-    type: 'plan_generated';
-    plan: SerializedPlan;
-    goal: string;
-    runners: RunnerId[];
-} | {
-    type: 'planner_message';
-    content: string;
-    timestamp: string;
-} | {
-    type: 'status_update';
-    tasks: SerializedTaskStatus[];
-} | {
-    type: 'review_needed';
-    tasks: SerializedTask[];
-} | {
-    type: 'review_approved';
-} | {
-    type: 'checkpoint';
-    taskId: string;
-    taskTitle: string;
-    summary: string;
-} | {
-    type: 'execution_complete';
-    summary: {
-        total: number;
-        completed: number;
-        failed: number;
-    };
-} | {
-    type: 'execution_stopped';
-} | {
-    type: 'queue_ready';
-} | {
-    type: 'task_updated';
-    taskId: string;
-    changes: Record<string, unknown>;
-} | {
-    type: 'task_started';
-    taskId: string;
-    order: number;
-    title: string;
-    runner: RunnerId;
-    modelId?: string;
-} | {
-    type: 'task_output';
-    taskId: string;
-    text: string;
-} | {
-    type: 'isolation_blocked';
-    reason: 'dirty';
-    repos?: string[];
-    message: string;
-} | {
-    type: 'isolation_handoff';
-    repos: IsolationHandoff['repos'];
-    landed: IsolationHandoff['landed'];
-} | {
-    type: 'isolation_merge';
-    result: IsolationMergeResult;
-} | {
-    type: 'plan_thinking';
-    text: string;
-} | {
-    type: 'planner_liveness';
-} | {
-    type: 'research_step';
-    tool: string;
-    toolLabel?: string;
-    args: string;
-    subagentId?: string;
-    toolCallId?: string;
-} | {
-    type: 'plan_token';
-    token: string;
-} | {
-    type: 'research_step_done';
-    step: ResearchStep;
-    subagentId?: string;
-} | {
-    type: 'approval_request';
-    id: string;
-    kind: ApprovalKind;
-    subject: string;
-    scope: string;
-    detail?: string;
-} | {
-    type: 'approval_settled';
-    id: string;
-    granted: boolean;
-} | {
-    type: 'approval_decided';
-    kind: ApprovalKind;
-    subject: string;
-    scope: string;
-    detail?: string;
-    granted: boolean;
-    source: Exclude<ApprovalSource, 'asked'>;
-};
-/**
- * A line a run wants the user to read — how it isolates, what it shares. Not a
- * {@link SessionMessage}: hosts that show notices as toasts already do, and
- * widening the union would break every exhaustive switch over it. A host with
- * no toast channel (the daemon) hands these to its clients by its own means.
- */
-type SessionNotice = {
-    type: 'notice';
-    level: 'info' | 'warn';
-    message: string;
-};
-type SessionBroadcaster = (msg: SessionMessage) => void;
-declare function serializeTask(t: Task): SerializedTask;
-declare function serializeTaskStatus(t: Task, idleSince?: string | null, isolation?: TaskIsolation | null): SerializedTaskStatus;
-declare function serializePlan(plan: LegacyPlanState): SerializedPlan;
-declare function executionSummary(tasks: Task[]): {
-    total: number;
-    completed: number;
-    failed: number;
-};
-declare const CHECKPOINT_TRUNCATE_LENGTH = 120;
-/** Truncate a checkpoint summary to a single line of at most CHECKPOINT_TRUNCATE_LENGTH chars. */
-declare function truncateCheckpointSummary(summary: string): string;
-
-/**
- * @param toolLabel The agent's own name for the tool, when a harness planner
- * produced the call (ADR-0009). It replaces the member name in the summary, so
- * the timeline says `Edit` rather than the catch-all `agent_tool` — and says
- * `WebFetch` rather than claiming a shell command ran.
- */
-declare function summarizeToolCall(tool: string, argsJson: string, toolLabel?: string): string;
-/**
- * Classify a tool outcome from its result text and success flag, so a surface
- * can render a refused `rm` or a denied `npm test` distinctly from a
- * successful run without re-deriving the refusal signatures per surface. The
- * refusal/denial strings come from `commandPolicy.ts`, `BaseFileSystem.ts`,
- * and the research-subagent wrapper — keeping the matching here means the
- * signatures stay in one place alongside the human summary.
- */
-declare function classifyOutcome(success: boolean, output: string): ResearchStepOutcome;
-
-export { type Adr0013IsolationRun as A, CHECKPOINT_TRUNCATE_LENGTH as C, type SerializedPlan as S, type TaskOp as T, type Adr0013PlanIsolation as a, type Adr0013TaskRecord as b, type ApplyTaskOpsResult as c, type SerializedTask as d, type SerializedTaskStatus as e, type SessionBroadcaster as f, type SessionMessage as g, type SessionNotice as h, type TaskRef as i, applyTaskOps as j, canMergeTasks as k, canSetDependencies as l, canSplitTask as m, capConflictFiles as n, classifyOutcome as o, dependencyCandidates as p, dependentsOf as q, executionSummary as r, migratePlanIsolation as s, parseTaskOpsJson as t, serializePlan as u, serializeTask as v, serializeTaskStatus as w, summarizeToolCall as x, textHasTaskOps as y, truncateCheckpointSummary as z };