@pentoshi/clai 4.11.7 → 4.11.9

package/dist/agent/plan/context-message.js

@@ -0,0 +1,91 @@
+import { readyPlanTasks } from "../../store/plan.js";
+export function planContextMessage(plan, approved) {
+    const lines = [];
+    lines.push(`ACTIVE PLAN for this session (goal: ${plan.goal}, status: ${plan.status}):`);
+    if (plan.detail.trim())
+        lines.push(plan.detail.trim());
+    lines.push("Tasks:");
+    plan.tasks.forEach((t, i) => {
+        const aliasHint = t.aliases?.length && t.aliases[0] !== t.id
+            ? ` [aliases: ${t.aliases.slice(0, 3).join(", ")}]`
+            : "";
+        const dependencyHint = t.dependencies?.length
+            ? ` [depends: ${t.dependencies.join(", ")}]`
+            : "";
+        const resourceHint = t.resourceLocks?.length
+            ? ` [locks: ${t.resourceLocks.join(", ")}]`
+            : "";
+        const acceptanceHint = t.acceptanceCriteria?.trim()
+            ? ` [acceptance: ${t.acceptanceCriteria.trim()}]`
+            : "";
+        const hierarchyHint = t.parentTaskId ? ` [child of ${t.parentTaskId}]` : "";
+        const jobHint = t.jobId
+            ? ` [responder job=${t.jobId}${t.processId ? ` pid=${t.processId}` : ""}]`
+            : "";
+        lines.push(`  ${i + 1}. [${t.id}] (${t.state}) ${t.title}${hierarchyHint}${jobHint}${aliasHint}${dependencyHint}${resourceHint}${acceptanceHint}`);
+    });
+    lines.push("task.update taskId MUST be t1, t2, … from this list (or a listed alias). Use task.add for newly discovered work; it is placed before unfinished report creation. Use task.move with position/beforeTaskId/afterTaskId to rearrange work without changing ids or evidence. Responder-owned job tasks advance automatically; never task.update them. After analyzing a delivered Responder result, job.read its job or notification before finalizing.");
+    if (plan.meta?.projectRoot) {
+        lines.push(`project_root: ${plan.meta.projectRoot}`);
+    }
+    if (plan.meta?.packageManager) {
+        lines.push(`package_manager: ${plan.meta.packageManager}`);
+    }
+    if (approved) {
+        const inProgress = plan.tasks.find((task) => task.state === "in_progress" && !task.responderOwned);
+        const failed = plan.tasks.find((task) => task.state === "failed" && !task.responderOwned);
+        const firstPending = readyPlanTasks(plan)[0];
+        const hasOpenWork = plan.tasks.some((task) => !task.responderOwned &&
+            (task.state === "in_progress" ||
+                task.state === "pending" ||
+                task.state === "failed"));
+        lines.push("The user APPROVED this plan. Execute it NOW. Tasks are checkpoints — you still own the user's requested boundary. Their states are authoritative for tracked work, but a completed phase is not completion of an explicitly requested whole roadmap/program.");
+        if (inProgress) {
+            lines.push(`RESUME TASK ${inProgress.id} (${inProgress.title}) — it was started but interrupted. ` +
+                "Retry what was in progress; do NOT restart completed work from scratch. " +
+                "Do NOT re-do tasks already marked done.");
+        }
+        else if (failed) {
+            lines.push(`RETRY FAILED TASK ${failed.id} (${failed.title}) — reopen it (task.update in_progress), ` +
+                "fix the root cause, then re-verify before marking done. Do NOT re-do tasks already marked done.");
+        }
+        else if (firstPending) {
+            lines.push(`START WITH TASK ${firstPending.id} (${firstPending.title}). ` +
+                "Do NOT re-do tasks already marked done.");
+        }
+        if (hasOpenWork) {
+            lines.push("FIRST THIS TURN — reconcile with this task list before doing anything else. It persists across abort and " +
+                "compaction, is re-injected here every turn, and is the CURRENT source of truth for what is done vs pending. " +
+                "It OVERRIDES any 'current state', 'remaining work', 'ready to…', or completion wording in the compacted memory " +
+                "summary; when the summary and these task states disagree, trust these task states.");
+            lines.push("Let task states identify the current foreground outcome and avoid rediscovering settled work. Read that task's " +
+                "artifacts plus only the prior evidence needed for its dependencies. One foreground task stays in_progress for " +
+                "state integrity, but the plan is a living outcome map rather than an inflexible script: if evidence exposes " +
+                "required work or invalidates priority, add the discovery, return the current task to pending when necessary, " +
+                "and deliberately open the new highest-priority ready task. Preserve completed evidence and never re-scan the " +
+                "whole project merely to recover status. You may stop with open tasks only when genuinely blocked, told to stop, " +
+                "or waiting on declared external work; report the exact remainder honestly.");
+        }
+        lines.push("Flow: task.update in_progress → pursue the task's outcome using the evidence-appropriate method → WAIT for and READ every result → " +
+            "verify its acceptance evidence → mark done only when the outcome holds → open the next ready task. " +
+            "A launched command is not evidence of completion, and one successful path may not cover the task's relevant edge, integration, or regression surface. " +
+            "Capture unrelated or newly required discoveries with task.add; do not silently broaden scope or discard them. " +
+            "A durable background launch creates a Responder-owned child task: launch high-value slow work early only when independent work remains, and never busy-poll or duplicate it. " +
+            "If only Responder-owned child tasks remain, yield honestly; Responder will inject the durable completion. " +
+            "Durable evidence beside a task survives resume; reuse it rather than repeating confirmed work. " +
+            "Independent read-only lookups may parallelize when their results do not depend on each other. " +
+            "If a tool fails, interpret why, revise the hypothesis or environment, and retry with a materially improved approach instead of ritual repetition. " +
+            "Before finalizing, reconcile every requested acceptance criterion, task, affected surface, and material residual uncertainty. " +
+            "For software, use applicable automated and runtime/integration proof. For security, use remote target evidence and explicit attack-surface residuals. " +
+            "Do not re-open done tasks.");
+    }
+    else {
+        lines.push("This plan is NOT yet approved — do not execute tasks (no scaffold/write/install/exploit). " +
+            "User free-text is PLAN REVISION feedback, not approval — even if it sounds like an instruction. " +
+            "On revision: call plan.create with the COMPLETE intended checklist (drop obsolete tasks; " +
+            "matching titles keep stable ids). Be decisive — one coherent rewrite, then STOP. " +
+            "User may Accept, Discard, View, or Suggest changes (or /implement / /discard).");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=context-message.js.map

package/dist/agent/plan/context-message.js.map

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

package/dist/agent/plan/handle-plan-tool.d.ts

@@ -0,0 +1,24 @@
+import type { SessionPlan } from "../../store/plan.js";
+import type { ToolCall } from "../../types.js";
+import type { LoopGuard } from "../loop-guard.js";
+import type { SessionPolicy } from "../session-policy.js";
+import { looksLikeRunOnlyGoal, normalizePlanTaskEntries, resolvePlanTaskId, slugifyTaskId, titlesMatchForPlan } from "./normalization.js";
+export { looksLikeRunOnlyGoal, normalizePlanTaskEntries, resolvePlanTaskId, slugifyTaskId, titlesMatchForPlan };
+export type { NormalizedPlanTask } from "./normalization.js";
+export declare function normalizeCodingPlanTasks(_kind: string, _goal: string, _detail: string, tasks: string[]): string[];
+export declare function renderPlanForTerminal(plan: SessionPlan): string;
+export interface PlanToolResult {
+    handled: boolean;
+    ok: boolean;
+    plan?: SessionPlan | undefined;
+    cleared?: boolean | undefined;
+    display: string;
+    modelNote: string;
+    reminder?: boolean | undefined;
+    toast?: string | undefined;
+}
+export declare function handlePlanTool(call: ToolCall, session: SessionPolicy, ctx: {
+    loopGuard: LoopGuard;
+    step: number;
+    autoApprove?: boolean;
+}): Promise<PlanToolResult>;

package/dist/agent/plan/handle-plan-tool.js

@@ -0,0 +1,310 @@
+import { isPlanSuccessful, isPlanTerminal, loadPlan, markTask, mutatePlan, readyPlanTasks } from "../../store/plan.js";
+import { evaluateTaskTransition } from "../../store/task-transitions.js";
+import { renderPlanChecklist } from "../../ui/plan-pane.js";
+import { buildDependencyReminder, dependencyToast } from "../task-sync.js";
+import chalk from "chalk";
+import { looksLikeRunOnlyGoal, normalizePlanTaskEntries, resolvePlanTaskId, slugifyTaskId, titlesMatchForPlan } from "./normalization.js";
+import { handlePlanCreate } from "./actions/plan-create.js";
+import { handlePlanClear } from "./actions/plan-clear.js";
+import { handleTaskMove } from "./actions/task-move.js";
+import { handleTaskAdd } from "./actions/task-add.js";
+export { looksLikeRunOnlyGoal, normalizePlanTaskEntries, resolvePlanTaskId, slugifyTaskId, titlesMatchForPlan };
+export function normalizeCodingPlanTasks(_kind, _goal, _detail, tasks) {
+    return [...tasks];
+}
+export function renderPlanForTerminal(plan) {
+    return renderPlanChecklist(plan);
+}
+export async function handlePlanTool(call, session, ctx) {
+    const autoApprove = Boolean(ctx.autoApprove);
+    void ctx.loopGuard;
+    void ctx.step;
+    if (!session.pendingDependency)
+        session.pendingDependency = { value: undefined };
+    if (!session.pendingTaskBatch)
+        session.pendingTaskBatch = { value: undefined };
+    if (call.name === "plan.create") {
+        return handlePlanCreate(call, session, autoApprove);
+    }
+    if (call.name === "plan.clear") {
+        return handlePlanClear(call, session, autoApprove);
+    }
+    const plan = await loadPlan(session.sessionId).catch(() => undefined);
+    if (!plan) {
+        return {
+            handled: true,
+            ok: false,
+            display: chalk.red(`  ✗ ${call.name}: no active plan — call plan.create first\n`),
+            modelNote: `${call.name} failed: there is no active plan. Call plan.create first.`,
+        };
+    }
+    if (call.name === "task.move") {
+        return handleTaskMove(call, session, autoApprove, plan);
+    }
+    if (call.name === "task.add") {
+        return handleTaskAdd(call, session, autoApprove, plan);
+    }
+    const taskIdRaw = typeof call.args.taskId === "string"
+        ? call.args.taskId
+        : typeof call.args.id === "string"
+            ? call.args.id
+            : "";
+    const stateRaw = typeof call.args.state === "string" ? call.args.state : "";
+    const note = typeof call.args.note === "string" ? call.args.note : undefined;
+    const validStates = [
+        "pending",
+        "in_progress",
+        "done",
+        "failed",
+        "skipped",
+    ];
+    if (!validStates.includes(stateRaw)) {
+        return {
+            handled: true,
+            ok: false,
+            display: chalk.red(`  ✗ task.update: state must be one of ${validStates.join(", ")}\n`),
+            modelNote: `task.update failed: state must be one of ${validStates.join(", ")}.`,
+        };
+    }
+    const taskId = resolvePlanTaskId(plan, taskIdRaw) ?? taskIdRaw;
+    const taskTarget = plan.tasks.find((task) => task.id === taskId);
+    if (taskTarget?.responderOwned) {
+        return {
+            handled: true,
+            ok: false,
+            display: chalk.yellow(`  ⚠ task.update: [${taskId}] is owned by Responder job ${taskTarget.jobId ?? "?"}\n`),
+            modelNote: `task.update held: [${taskId}] is a Responder-owned background-job subtask. ` +
+                `Do not change it manually; continue independent work or yield. Responder will advance it from the real process result and wake you when analysis is actionable.`,
+        };
+    }
+    let dependencyWarning;
+    let dependencyWarningToast;
+    if (stateRaw === "in_progress") {
+        const target = plan.tasks.find((task) => task.id === taskId);
+        const ready = readyPlanTasks(plan).some((task) => task.id === taskId);
+        const retryingFailedTask = target?.state === "failed";
+        if (target?.state === "done" || target?.state === "skipped") {
+            const nextPending = readyPlanTasks(plan)[0];
+            const nextHint = nextPending
+                ? ` Continue with task.update {taskId:"${nextPending.id}", state:"in_progress"} ("${nextPending.title}").`
+                : " All ready work is finished — write the final summary if needed.";
+            return {
+                handled: true,
+                ok: false,
+                display: chalk.red(`  ✗ task.update: [${taskId}] is already ${target.state} — do not re-open\n`),
+                modelNote: `task.update failed: [${taskId}] is already ${target.state}. ` +
+                    `Do not re-run completed tasks.${nextHint}`,
+            };
+        }
+        if (target?.state !== "in_progress") {
+            const otherActive = plan.tasks.find((task) => task.id !== taskId &&
+                task.state === "in_progress" &&
+                !task.responderOwned);
+            if (otherActive) {
+                return {
+                    handled: true,
+                    ok: false,
+                    display: chalk.red(`  ✗ task.update: [${otherActive.id}] is still in progress — only one foreground task may be active\n`),
+                    modelNote: `task.update failed: [${otherActive.id}] "${otherActive.title}" is still in_progress. ` +
+                        `Defer it first with task.update {taskId:"${otherActive.id}", state:"pending"} (or finish it with "done"; use "failed"/"skipped" with a reason), then open [${taskId}]. ` +
+                        `Exactly one foreground task may be active at a time; Responder-owned subtasks are exempt.`,
+                };
+            }
+            const incompleteDependencies = (target?.dependencies ?? []).filter((dependency) => {
+                const dependencyTask = plan.tasks.find((task) => task.id === dependency);
+                return !dependencyTask || (dependencyTask.state !== "done" && dependencyTask.state !== "skipped");
+            });
+            const heldLocks = new Set(plan.tasks
+                .filter((task) => task.state === "in_progress" && task.id !== taskId)
+                .flatMap((task) => task.resourceLocks ?? []));
+            const conflictingLocks = (target?.resourceLocks ?? []).filter((lock) => heldLocks.has(lock));
+            if (target &&
+                incompleteDependencies.length > 0 &&
+                !retryingFailedTask &&
+                conflictingLocks.length === 0) {
+                dependencyWarning = buildDependencyReminder({
+                    taskId,
+                    title: target.title,
+                    targetState: stateRaw,
+                    blockers: incompleteDependencies.map((id) => ({
+                        id,
+                        title: plan.tasks.find((task) => task.id === id)?.title ?? "",
+                    })),
+                });
+                dependencyWarningToast = dependencyToast(taskId);
+            }
+            else if ((!ready && !retryingFailedTask) || conflictingLocks.length > 0) {
+                const nextReady = readyPlanTasks(plan)[0];
+                return {
+                    handled: true,
+                    ok: false,
+                    display: chalk.red(`  ✗ task.update: [${taskId}] is not dependency/resource ready\n`),
+                    modelNote: `task.update failed: [${taskId}] is not ready. ` +
+                        (incompleteDependencies.length ? `Incomplete dependencies: ${incompleteDependencies.join(", ")}. ` : "") +
+                        (conflictingLocks.length ? `Resources currently locked: ${conflictingLocks.join(", ")}. ` : "") +
+                        (nextReady
+                            ? `Open the next ready task first: ${nextReady.id} ("${nextReady.title}").`
+                            : ""),
+                };
+            }
+        }
+        if (retryingFailedTask && target)
+            target.evidence = undefined;
+    }
+    if (stateRaw === "done") {
+        const target = plan.tasks.find((task) => task.id === taskId);
+        const incompleteDependencies = (target?.dependencies ?? []).filter((dependency) => {
+            const dependencyTask = plan.tasks.find((task) => task.id === dependency);
+            return !dependencyTask || (dependencyTask.state !== "done" && dependencyTask.state !== "skipped");
+        });
+        if (incompleteDependencies.length > 0) {
+            return {
+                handled: true,
+                ok: false,
+                display: chalk.red(`  ✗ task.update: cannot complete [${taskId}] before dependencies\n`),
+                modelNote: `task.update failed: earlier task/dependency ${incompleteDependencies.join(", ")} is not complete for [${taskId}].`,
+            };
+        }
+        if (target && target.state !== "in_progress") {
+            if (target.state === "pending" && incompleteDependencies.length === 0) {
+                const opened = markTask(plan, taskId, "in_progress", note);
+                if (!opened) {
+                    return {
+                        handled: true,
+                        ok: false,
+                        display: chalk.red(`  ✗ task.update: could not auto-open [${taskId}] before completion\n`),
+                        modelNote: `task.update failed: could not auto-open pending [${taskId}].`,
+                    };
+                }
+            }
+            else if (target.state === "failed") {
+                return {
+                    handled: true,
+                    ok: false,
+                    display: chalk.red(`  ✗ task.update: [${taskId}] is failed — retry with in_progress first\n`),
+                    modelNote: `task.update failed: [${taskId}] is failed. ` +
+                        `Call task.update {taskId:"${taskId}", state:"in_progress"} to retry, then mark done after recovery work.`,
+                };
+            }
+            else {
+                const nextReady = readyPlanTasks(plan)[0];
+                return {
+                    handled: true,
+                    ok: false,
+                    display: chalk.red(`  ✗ task.update: [${taskId}] must be in_progress before completion\n`),
+                    modelNote: `task.update failed: [${taskId}] is ${target.state}. ` +
+                        "Start or retry it, perform fresh work, then mark it done." +
+                        (nextReady
+                            ? ` Open next ready: ${nextReady.id} ("${nextReady.title}").`
+                            : ""),
+                };
+            }
+        }
+    }
+    const transitionTarget = plan.tasks.find((task) => task.id === taskId);
+    if (transitionTarget) {
+        const verdict = evaluateTaskTransition(transitionTarget.state, stateRaw);
+        if (!verdict.allowed) {
+            const nextReady = readyPlanTasks(plan)[0];
+            return {
+                handled: true,
+                ok: false,
+                display: chalk.red(`  ✗ task.update: [${taskId}] ${transitionTarget.state} → ${stateRaw} is not a valid transition\n`),
+                modelNote: `task.update failed: [${taskId}] ${verdict.reason}. ` +
+                    (nextReady
+                        ? `Continue with ${nextReady.id} ("${nextReady.title}").`
+                        : "All ready work is finished — write the final summary if needed."),
+            };
+        }
+    }
+    const ok = markTask(plan, taskId, stateRaw, note);
+    if (!ok) {
+        const idMap = plan.tasks
+            .map((t) => `${t.id}="${t.title}"` +
+            (t.aliases?.length ? ` (also: ${t.aliases.join(", ")})` : ""))
+            .join("; ");
+        return {
+            handled: true,
+            ok: false,
+            display: chalk.red(`  ✗ task.update: unknown taskId "${taskIdRaw}" (have: ${plan.tasks.map((t) => t.id).join(", ")})\n`),
+            modelNote: `task.update failed: unknown taskId "${taskIdRaw}". ` +
+                `Valid ids (use these, not title text): ${idMap}.`,
+        };
+    }
+    if (plan.status === "draft" || plan.status === "approved") {
+        plan.status = "in_progress";
+    }
+    const terminal = isPlanTerminal(plan);
+    const successful = isPlanSuccessful(plan);
+    if (terminal)
+        plan.status = successful ? "completed" : "abandoned";
+    const committedStates = new Map(plan.tasks.map((task) => [
+        task.id,
+        { state: task.state, note: task.note },
+    ]));
+    await mutatePlan(plan.sessionId, (draft) => {
+        for (const task of draft.tasks) {
+            const desired = committedStates.get(task.id);
+            if (!desired)
+                continue;
+            if (task.responderOwned)
+                continue;
+            task.state = desired.state;
+            if (desired.note !== undefined)
+                task.note = desired.note;
+        }
+        draft.status = plan.status;
+        return true;
+    }).catch(() => undefined);
+    const checklist = renderPlanForTerminal(plan);
+    const nextPending = readyPlanTasks(plan)[0];
+    let modelNote;
+    if (successful) {
+        modelNote =
+            "Task updated. All required tasks succeeded or were explicitly skipped. Verify the result and give your final summary. " +
+                "If a dev server was started: report URL, port, job id, and that it is still running.";
+    }
+    else if (terminal) {
+        const failed = plan.tasks.filter((task) => task.state === "failed");
+        modelNote =
+            `Task updated. The plan is terminal but NOT successful: ${failed.length} task(s) failed. ` +
+                "Do not claim completion. Report a failed/partial outcome with the failed tasks and remaining user outcome.";
+    }
+    else if (stateRaw === "done" && nextPending) {
+        modelNote =
+            `Task [${taskId}] marked done after verified work. ` +
+                `NEXT: open only the next task with task.update {taskId:"${nextPending.id}", state:"in_progress"}, ` +
+                `then do work for "${nextPending.title}" only. Wait for tool results before marking that one done. ` +
+                "Do not batch later tasks. Do not start a later task's tools early.";
+    }
+    else if (stateRaw === "in_progress") {
+        modelNote =
+            `Task [${taskId}] is now in_progress and owns the foreground outcome. Choose the method from current evidence, ` +
+                `read each result, and keep working until the task's acceptance evidence holds. Capture newly discovered required ` +
+                `work with task.add. If a discovery must preempt this task, move [${taskId}] back to pending before opening the ` +
+                `higher-priority task; otherwise preserve focus and avoid starting unrelated later work. Mark done only after verification.`;
+    }
+    else if (stateRaw === "pending") {
+        modelNote =
+            `Task [${taskId}] is pending. If you deferred it to switch priorities, ` +
+                `explicitly open the intended task with task.update {taskId:"...", state:"in_progress"} before doing work.`;
+    }
+    else {
+        modelNote = "Task updated. Continue with the next pending task.";
+    }
+    return {
+        handled: true,
+        ok: true,
+        plan,
+        display: checklist +
+            "\n" +
+            (dependencyWarning
+                ? chalk.yellow(`  ⚠ ${dependencyWarning}\n`)
+                : ""),
+        modelNote: dependencyWarning
+            ? `${dependencyWarning}\n${modelNote}`
+            : modelNote,
+        ...(dependencyWarningToast ? { toast: dependencyWarningToast } : {}),
+    };
+}
+//# sourceMappingURL=handle-plan-tool.js.map

package/dist/agent/plan/handle-plan-tool.js.map

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

package/dist/agent/plan/normalization.d.ts

@@ -0,0 +1,19 @@
+import type { SessionPlan } from "../../store/plan.js";
+export declare function titlesMatchForPlan(a: string, b: string): boolean;
+export declare function looksLikeRunOnlyGoal(goal: string, detail: string): boolean;
+export declare function nextTaskId(existingIds: string[]): string;
+export declare function normalizePlanGoal(args: Record<string, unknown>): string;
+export declare function normalizePlanDetail(args: Record<string, unknown>): string;
+export declare function normalizePlanKind(args: Record<string, unknown>): string;
+export declare function normalizeTaskTitle(t: unknown): string;
+export declare function slugifyTaskId(text: string): string;
+export interface NormalizedPlanTask {
+    title: string;
+    aliases: string[];
+    dependencies: string[];
+    dependenciesSpecified: boolean;
+    resourceLocks: string[];
+    acceptanceCriteria?: string | undefined;
+}
+export declare function normalizePlanTaskEntries(args: Record<string, unknown>): NormalizedPlanTask[];
+export declare function resolvePlanTaskId(plan: SessionPlan, taskId: string): string | undefined;

package/dist/agent/plan/normalization.js

@@ -0,0 +1,175 @@
+import { isBareTaskIdTitle } from "../../store/plan.js";
+export function titlesMatchForPlan(a, b) {
+    const t1 = a.trim().toLowerCase();
+    const t2 = b.trim().toLowerCase();
+    return (t1 === t2 ||
+        (t1.length > 8 && t2.length > 8 && (t1.includes(t2) || t2.includes(t1))));
+}
+export function looksLikeRunOnlyGoal(goal, detail) {
+    const blob = `${goal} ${detail}`.toLowerCase();
+    if (!/\b(run|start|launch|serve|dev\s*server|npm\s+run\s+dev)\b/.test(blob)) {
+        return false;
+    }
+    if (/\b(scaffold|create|build|implement|add feature|from scratch|new app)\b/.test(blob)) {
+        return false;
+    }
+    return /\b(existing|already|the app|dev server|server|verify|test it|open it)\b/.test(blob)
+        || /^(run|start)\b/.test(blob.trim());
+}
+export function nextTaskId(existingIds) {
+    let max = 0;
+    for (const id of existingIds) {
+        const m = /^t(\d+)$/i.exec(id);
+        if (m)
+            max = Math.max(max, Number(m[1]));
+    }
+    return `t${max + 1}`;
+}
+export function normalizePlanGoal(args) {
+    const raw = args.goal ?? args.objective ?? args.title ?? args.name;
+    if (typeof raw === "string")
+        return raw.trim();
+    if (raw && typeof raw === "object") {
+        const o = raw;
+        for (const k of ["title", "text", "goal", "name", "summary"]) {
+            if (typeof o[k] === "string" && o[k].toString().trim()) {
+                return String(o[k]).trim();
+            }
+        }
+    }
+    return "";
+}
+export function normalizePlanDetail(args) {
+    const raw = args.detail ?? args.description ?? args.approach ?? args.notes;
+    if (typeof raw === "string")
+        return raw.trim();
+    if (Array.isArray(raw)) {
+        return raw
+            .map((x) => (typeof x === "string" ? x : JSON.stringify(x)))
+            .join("\n")
+            .trim();
+    }
+    return "";
+}
+export function normalizePlanKind(args) {
+    const raw = args.kind ?? args.type ?? args.category;
+    if (typeof raw === "string" && raw.trim())
+        return raw.trim().toLowerCase();
+    return "general";
+}
+export function normalizeTaskTitle(t) {
+    if (typeof t === "string")
+        return t.trim();
+    if (typeof t === "number" && Number.isFinite(t))
+        return String(t);
+    if (t && typeof t === "object") {
+        const o = t;
+        for (const k of [
+            "title",
+            "task",
+            "name",
+            "text",
+            "description",
+            "label",
+            "step",
+            "summary",
+        ]) {
+            if (typeof o[k] === "string" && o[k].toString().trim()) {
+                return String(o[k]).trim();
+            }
+        }
+    }
+    return "";
+}
+export function slugifyTaskId(text) {
+    return text
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .slice(0, 64);
+}
+export function normalizePlanTaskEntries(args) {
+    const raw = args.tasks ?? args.steps ?? args.checklist ?? args.items ?? args.todos;
+    if (typeof raw === "string") {
+        return raw
+            .split(/\n|;|(?:,\s*(?=[A-Z0-9\-]))/)
+            .map((s) => s.replace(/^\s*[-*\d.)]+\s*/, "").trim())
+            .filter(Boolean)
+            .map((title) => ({
+            title,
+            aliases: [],
+            dependencies: [],
+            dependenciesSpecified: false,
+            resourceLocks: [],
+        }));
+    }
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .map((t) => {
+        const title = normalizeTaskTitle(t);
+        if (!title || isBareTaskIdTitle(title))
+            return null;
+        const aliases = [];
+        if (t && typeof t === "object") {
+            const o = t;
+            for (const k of ["id", "taskId", "key", "slug"]) {
+                if (typeof o[k] === "string" && o[k].toString().trim()) {
+                    aliases.push(String(o[k]).trim());
+                }
+            }
+            if (typeof o.name === "string" &&
+                o.name.trim() &&
+                o.name.trim().toLowerCase() !== title.toLowerCase()) {
+                aliases.push(o.name.trim());
+            }
+        }
+        const slug = slugifyTaskId(title);
+        if (slug && !aliases.includes(slug))
+            aliases.push(slug);
+        const object = t && typeof t === "object" ? t : {};
+        const stringArray = (value) => Array.isArray(value)
+            ? [...new Set(value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean))]
+            : [];
+        const rawAcceptance = object.acceptance ??
+            object.acceptanceCriteria ??
+            object.successCriteria ??
+            object.verify;
+        const acceptanceCriteria = typeof rawAcceptance === "string"
+            ? rawAcceptance.trim()
+            : Array.isArray(rawAcceptance)
+                ? rawAcceptance
+                    .filter((item) => typeof item === "string")
+                    .map((item) => item.trim())
+                    .filter(Boolean)
+                    .join("; ")
+                : "";
+        return {
+            title,
+            aliases: [...new Set(aliases)],
+            dependencies: stringArray(object.dependencies ?? object.dependsOn),
+            dependenciesSpecified: Object.prototype.hasOwnProperty.call(object, "dependencies") ||
+                Object.prototype.hasOwnProperty.call(object, "dependsOn"),
+            resourceLocks: stringArray(object.resourceLocks ?? object.resources),
+            ...(acceptanceCriteria ? { acceptanceCriteria } : {}),
+        };
+    })
+        .filter((x) => Boolean(x));
+}
+export function resolvePlanTaskId(plan, taskId) {
+    const raw = taskId.trim();
+    if (!raw)
+        return undefined;
+    if (plan.tasks.some((t) => t.id === raw))
+        return raw;
+    const lower = raw.toLowerCase();
+    const slug = slugifyTaskId(raw);
+    for (const t of plan.tasks) {
+        if (t.aliases?.some((a) => a === raw || a.toLowerCase() === lower)) {
+            return t.id;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=normalization.js.map