@tea-agent/loop-agent 0.26.5-beta.1 → 0.27.0

package/dist/cli/help.js

@@ -22,13 +22,12 @@ export function formatCommandTierSummary(manifest = CODE_AGENT_COMMAND_MANIFEST)
         .map((entry) => entry.name)
         .join(", ");
     return [
-        "Recommended DAG path:",
-        "  1. new-task <task-id> [title]",
-        "  2. import-prd <task-id> --file <detailed-prd>   # PRD-first recommended",
-        "  3. task source prepare <task-id> --use-imported-prd --allowed-path <glob> --apply",
-        "  4. dag run-task <task-id> --profile auto --strict-models",
-        "  5. run-dag --dag <path> --cwd <repo-root>",
-        "Operator recovery/closeout: dag status/report/doctor/closeout-draft",
+        "Recommended task lifecycle (single mutation + single read):",
+        "  1. task advance <task-id> [title] --prd <prd.md> --allowed-path <glob> --verify <label:command> --json",
+        "  2. review writeSet gate digest from JSON",
+        "  3. task advance <task-id> --approve-gate write-set-review:<digest> --json",
+        "  4. task status <task-id> --json   # optional read-only",
+        "Advanced DAG authoring/forensics: dag validate|execute|report|workflow-* (not the standard happy path)",
         `Primary commands: ${primary}`,
         `Operator commands: ${operator}`,
         compatibility ? `Legacy compatibility commands: ${compatibility}` : "",

package/dist/cli/program.js

@@ -3,7 +3,6 @@ import { fileURLToPath } from "node:url";
 import { Command } from "commander";
 import { readPackageVersion } from "../shared/package-metadata.js";
 import { resolveAdapter } from "../adapters/index.js";
-import { runCloseout } from "../commands/closeout.js";
 import { runCoverageAudit } from "../commands/coverage-audit.js";
 import { runCoverageReport } from "../commands/coverage-report.js";
 import { parseCursorPromptArgs, printCursorPromptUsage, runCursorPrompt, } from "../commands/cursor-prompt.js";
@@ -17,7 +16,6 @@ import { runDagRerun } from "../commands/dag-rerun.js";
 import { runDagReject } from "../commands/dag-reject.js";
 import { runDagCloseoutDraft, runDagReport } from "../commands/dag-report.js";
 import { runDagResume } from "../commands/dag-resume.js";
-import { runDagRunTask } from "../commands/dag-run-task.js";
 import { runDagValidate } from "../commands/dag-validate.js";
 import { runDagWorkflowCompile } from "../commands/dag-workflow-compile.js";
 import { runDagWorkflowPlan } from "../commands/dag-workflow-plan.js";
@@ -38,21 +36,17 @@ import { runInstructions } from "../commands/instructions.js";
 import { runKnowledge } from "../commands/knowledge.js";
 import { runLoop } from "../commands/loop.js";
 import { runLoopBenchmark } from "../commands/loop-benchmark.js";
-import { runNewTask } from "../commands/new-task.js";
-import { runImportPrd } from "../commands/import-prd.js";
-import { runTaskContract } from "../commands/task-contract.js";
-import { runTaskSourcePrepare } from "../commands/task-source-prepare.js";
+import { runTaskAdvance } from "../commands/task-advance.js";
+import { runTaskStatus } from "../commands/task-status.js";
 import { runOperator } from "../commands/operator.js";
 import { runPiReuseBenchmark } from "../commands/pi-reuse-benchmark.js";
 import { parsePiPromptArgs, printPiPromptUsage, runPiPrompt, } from "../commands/pi-prompt.js";
 import { runPlanList } from "../commands/plan-list.js";
 import { runPlanCheck, runPlanComplete, runPlanCreate, } from "../commands/plan.js";
-import { runPromoteRun } from "../commands/promote-run.js";
 import { runReferenceIndex } from "../commands/reference-index.js";
 import { runRunDag } from "../commands/run-dag.js";
 import { runSpine } from "../commands/spine.js";
 import { runStats } from "../commands/stats.js";
-import { runStatus } from "../commands/status.js";
 import { runStudyInit } from "../commands/study-init.js";
 import { runWorkflowCommand } from "../commands/workflow.js";
 import { runWorktreeCreate } from "../commands/worktree-create.js";
@@ -116,6 +110,17 @@ async function dispatchRegisteredCommand(commandObject, defaultRepoRoot, rawArgs
     };
     await runCommanderAction(ctx, command, subcommand, rest);
 }
+async function runTaskCommand(repoRoot, subcommand, rest) {
+    if (subcommand === "advance") {
+        await runTaskAdvance(repoRoot, rest);
+        return;
+    }
+    if (subcommand === "status") {
+        await runTaskStatus(repoRoot, rest);
+        return;
+    }
+    throw new Error("usage: task <advance|status> ...");
+}
 async function runCommanderAction(ctx, command, subcommand, rest) {
     switch (command) {
         case "inspect":
@@ -127,63 +132,16 @@ async function runCommanderAction(ctx, command, subcommand, rest) {
         case "docs":
             await runDocsCommand(ctx.repoRoot, subcommand, rest);
             return;
-        case "new-task": {
-            const [taskId, ...titleParts] = [subcommand, ...rest];
-            if (!taskId)
-                throw new Error("taskId required");
-            await runNewTask(ctx.repoRoot, taskId, titleParts.join(" ") || undefined);
-            return;
-        }
-        case "import-prd":
-            await runImportPrd(ctx.repoRoot, compactArgs([subcommand, ...rest]));
-            return;
         case "task": {
-            if (subcommand === "contract") {
-                const [contractSub, ...contractRest] = rest;
-                const allowed = [
-                    "show",
-                    "validate",
-                    "diff",
-                    "apply",
-                    "adopt",
-                    "doctor",
-                    "recover",
-                ];
-                if (!contractSub ||
-                    !allowed.includes(contractSub)) {
-                    throw new Error(`usage: task contract <${allowed.join("|")}> ...`);
-                }
-                await runTaskContract(ctx.repoRoot, [contractSub, ...contractRest]);
-                return;
-            }
-            if (subcommand === "source") {
-                const [sourceSub, ...sourceRest] = rest;
-                if (sourceSub !== "prepare") {
-                    throw new Error("usage: task source <prepare> ...");
-                }
-                await runTaskSourcePrepare(ctx.repoRoot, sourceRest);
-                return;
-            }
-            throw new Error("usage: task <contract|source> ...");
+            await runTaskCommand(ctx.repoRoot, subcommand, rest);
+            return;
         }
         case "operator":
             await runOperator(ctx.repoRoot, compactArgs([subcommand, ...rest]));
             return;
-        case "status": {
-            if (!subcommand)
-                throw new Error("taskId required");
-            await runStatus(ctx.repoRoot, subcommand);
-            return;
-        }
         case "instructions":
             await runInstructions(ctx.repoRoot, compactArgs([subcommand, ...rest]));
             return;
-        case "promote-run":
-            await runPromoteRun(ctx.repoRoot, compactArgs([subcommand, ...rest]));
-            return;
-        case "closeout":
-            await runCloseout(ctx.repoRoot, compactArgs([subcommand, ...rest]));
-            return;
         case "stats":
             await runStats(ctx.repoRoot, compactArgs([subcommand, ...rest]));
             return;
@@ -240,9 +198,6 @@ async function runCommanderAction(ctx, command, subcommand, rest) {
         case "dag":
             await runDagAction(ctx.repoRoot, subcommand, rest);
             return;
-        case "run-dag":
-            await runRunDag(ctx.repoRoot, compactArgs([subcommand, ...rest]));
-            return;
         case "workflow":
             await runWorkflowCommand(ctx.repoRoot, compactArgs([subcommand, ...rest]));
             return;
@@ -364,8 +319,8 @@ async function runDagAction(repoRoot, subcommand, rest) {
         case "doctor":
             await runDagDoctor(repoRoot, args);
             return;
-        case "run-task":
-            await runDagRunTask(repoRoot, args);
+        case "execute":
+            await runRunDag(repoRoot, args);
             return;
         case "report":
             await runDagReport(repoRoot, args);
@@ -401,7 +356,7 @@ async function runDagAction(repoRoot, subcommand, rest) {
             throw new Error("usage: dag decision <inspect|validate> --run-id <id> [--node-id <node-id>]");
         }
         default:
-            throw new Error("usage: dag <init-hybrid|run-task|validate|workflow-plan|workflow-validate|workflow-compile|approve|reject|resume|status|doctor|report|closeout-draft|reconcile-run|rerun|rerun-task|reconcile-tasks|final-verification|decision> ...");
+            throw new Error("usage: dag <init-hybrid|execute|validate|workflow-plan|workflow-validate|workflow-compile|approve|reject|resume|status|doctor|report|closeout-draft|reconcile-run|rerun|rerun-task|reconcile-tasks|final-verification|decision> ...");
     }
 }
 function compactArgs(args) {
@@ -431,7 +386,8 @@ function createRawArgsCommand(name, description, defaultRepoRoot) {
 }
 function addRawSubcommands(parent, subcommands, defaultRepoRoot) {
     for (const subcommand of subcommands) {
-        parent.addCommand(createRawArgsCommand(subcommand, `${parent.name()} ${subcommand}`, defaultRepoRoot));
+        const command = createRawArgsCommand(subcommand, `${parent.name()} ${subcommand}`, defaultRepoRoot);
+        parent.addCommand(command);
     }
 }
 function addStandaloneSubcommands(parent, subcommands, handler) {
@@ -464,9 +420,9 @@ function configureDagValidate(command) {
         .option("--forbid-executor <executor>", "forbid executor", (value, previous = []) => [...previous, value])
         .option("--spine-task <task-id>", "run spine audit for task id");
 }
-function configureRunDag(command) {
+function configureDagExecute(command) {
     command
-        .description("Execute a reviewed Agent DAG spec")
+        .description("Advanced: execute an arbitrary DagSpec JSON (standard task path uses task advance)")
         .option("--dag <path>", "DAG spec path")
         .option("-C, --cwd <dir>", "working directory")
         .option("--init-only", "initialize run artifacts without executing")
@@ -480,22 +436,6 @@ function configureRunDag(command) {
         .option("--canvases-dir <dir>", "canvas output directory")
         .option("--events-jsonl <path>", "append DAG node events to a JSONL file");
 }
-function configureDagRunTask(command) {
-    command
-        .description("Create and optionally execute a DAG for a task")
-        .option("-o, --output <path>", "output DAG path")
-        .option("--profile <profile>", "auto|minimal|standard|reviewed|supervised")
-        .option("--strict-models", "fail on model routing warnings")
-        .option("--execute", "execute after creating the DAG")
-        .option("--init-only", "initialize run artifacts without executing")
-        .option("--dry-run", "validate and plan without executing")
-        .option("--cwd <dir>", "working directory")
-        .option("--max-concurrent <n>", "maximum concurrent nodes")
-        .option("--run-id <id>", "run id")
-        .option("--canvas-path <path>", "absolute canvas output path")
-        .option("--canvas <name>", "canvas name")
-        .option("--canvases-dir <dir>", "canvas output directory");
-}
 function optionTokens(command) {
     const tokens = [];
     const options = command.opts();
@@ -562,10 +502,10 @@ function addDagCommand(program, defaultRepoRoot) {
     configureDagValidate(validate);
     replaceActionWithOptionAwareDispatch(validate, defaultRepoRoot);
     dag.addCommand(validate);
-    const runTask = createRawArgsCommand("run-task", "Create and optionally execute a DAG for a task", defaultRepoRoot);
-    configureDagRunTask(runTask);
-    replaceActionWithOptionAwareDispatch(runTask, defaultRepoRoot);
-    dag.addCommand(runTask);
+    const execute = createRawArgsCommand("execute", "Advanced: execute an arbitrary DagSpec JSON", defaultRepoRoot);
+    configureDagExecute(execute);
+    replaceActionWithOptionAwareDispatch(execute, defaultRepoRoot);
+    dag.addCommand(execute);
     const decision = new Command("decision").description("DAG decision envelope commands");
     addRawSubcommands(decision, ["inspect", "validate"], defaultRepoRoot);
     dag.addCommand(decision);
@@ -673,10 +613,6 @@ export function buildLoopAgentProgram(options) {
             continue;
         }
         const command = createRawArgsCommand(entry.name, entry.intent, options.defaultRepoRoot);
-        if (entry.name === "run-dag") {
-            configureRunDag(command);
-            replaceActionWithOptionAwareDispatch(command, options.defaultRepoRoot);
-        }
         if (entry.subcommands)
             addRawSubcommands(command, entry.subcommands, options.defaultRepoRoot);
         if (entry.name === "task") {

package/dist/cli/update/policy.js

@@ -1,6 +1,5 @@
 import semver from "semver";
 const CONTROLLER_SENSITIVE_COMMANDS = new Set([
-    "run-dag",
     "dag",
     "loop",
     "delegate",

package/dist/commands/dag-final-verification.js

@@ -65,7 +65,7 @@ export async function runDagFinalVerification(repoRoot, rawArgs) {
         next: [
             `Review ${result.outputPath}`,
             `npm run dev -- dag validate --dag ${result.outputPath} --strict-models --strict-governance`,
-            `npm run dev -- run-dag --dag ${result.outputPath} --cwd ${repoRoot}`,
+            `npm run dev -- dag execute --dag ${result.outputPath} --cwd ${repoRoot}`,
         ],
     }, null, 2));
 }

package/dist/commands/dag-init-hybrid.js

@@ -51,7 +51,7 @@ export async function runDagInitHybrid(repoRoot, rawArgs) {
         next: [
             `Review ${result.outputPath}`,
             `npm run dev -- dag validate --dag ${result.outputPath}`,
-            "Use run-dag --dry-run only when you intentionally need an active run snapshot.",
+            "Use dag execute --dry-run only when you intentionally need an active run snapshot.",
         ],
     }, null, 2));
 }

package/dist/commands/delegate.js

@@ -64,9 +64,9 @@ export function printDelegateNextSteps(taskId, result) {
         `  worktree: ${result.worktreePath}`,
         `  Next — generate, validate, and run DAG in the worktree:`,
         `    cd ${JSON.stringify(result.worktreePath)}`,
-        `    loop-agent --repo-root ${JSON.stringify(result.worktreePath)} dag run-task ${taskId} --profile auto --strict-models`,
+        `    loop-agent --repo-root ${JSON.stringify(result.worktreePath)} task advance ${taskId} --profile auto --json`,
         `    loop-agent dag validate --dag ${JSON.stringify(dagPath)} --strict-models --strict-governance`,
-        `    loop-agent run-dag --dag ${JSON.stringify(dagPath)} --cwd ${JSON.stringify(result.worktreePath)}`,
+        `    loop-agent dag execute --dag ${JSON.stringify(dagPath)} --cwd ${JSON.stringify(result.worktreePath)}`,
         `  Or: loop-agent delegate ${taskId} --auto-run`,
         `  After work completes:`,
         `    loop-agent harvest ${taskId}`,

package/dist/commands/init.js

@@ -446,7 +446,7 @@ check_skill "agent-worker" "references/agent-worker-operator.md"
 # against the whole skill file so host auto-discovery phrasing cannot drift.
 loop_agent_skill=".agents/skills/loop-agent/SKILL.md"
 loop_agent_text="$(tr '[:upper:]' '[:lower:]' < "\${loop_agent_skill}")"
-for term in "loop-agent 帮我完成" "帮我实现" "帮我修复" "帮我开发" "agent dag" "new-task" "dag run-task" "dag validate" "run-dag"; do
+for term in "loop-agent 帮我完成" "帮我实现" "帮我修复" "帮我开发" "agent dag" "task advance" "task status" "dag validate" "dag execute"; do
   if [[ "\${loop_agent_text}" != *"\${term}"* ]]; then
     echo "skill entry 检查失败（loop-agent）：description 缺少触发/路由词 \${term}" >&2
     exit 1
@@ -1810,16 +1810,17 @@ function buildManagedReadmeBlock(input) {
         "默认使用 Agent DAG 作为实现工作流：",
         "",
         "```bash",
-        'loop-agent new-task <task-id> "任务标题"',
-        "# 推荐：详细 PRD → import-prd → task source prepare --apply（无需手写两 source）",
-        "# loop-agent import-prd <task-id> --file <prd.md>",
-        'loop-agent task source prepare <task-id> --use-imported-prd --allowed-path "<glob>" --apply --json',
-        "loop-agent dag run-task <task-id> --profile auto --strict-models",
-        "loop-agent dag validate --dag .harness/tasks/<task-id>/dag.json --strict-models --strict-governance",
-        "loop-agent run-dag --dag .harness/tasks/<task-id>/dag.json --cwd .",
+        'loop-agent task advance <task-id> "任务标题" \\',
+        "  --prd <prd.md> \\",
+        '  --allowed-path "<glob>" \\',
+        '  --verify "typecheck:npm run typecheck" \\',
+        "  --json",
+        "# 审查 writeSet gate digest 后：",
+        'loop-agent task advance <task-id> --approve-gate "write-set-review:<digest>" --json',
+        "loop-agent task status <task-id> --json",
         "```",
         "",
-        `详细工作流见 \`${input.governanceRoot}/feature-workflow.md\`；验证矩阵见 \`${input.governanceRoot}/verification-matrix.md\`。任务 source 仍必需（\`source/需求.md\` / \`source/执行约束.md\`），默认由 \`task source prepare --apply\` 从详细 PRD 确定性派生，而不是主会话手写或 LLM 写 md。`,
+        `详细工作流见 \`${input.governanceRoot}/feature-workflow.md\`；验证矩阵见 \`${input.governanceRoot}/verification-matrix.md\`。任务 source 仍必需（\`source/需求.md\` / \`source/执行约束.md\`），默认由 \`task advance --prd\` 从详细 PRD 确定性派生，而不是主会话手写或 LLM 写 md。高级任意 DagSpec 才用 \`dag validate|execute|report\`，不进入标准 happy path。`,
         "",
         "执行后使用 `loop-agent dag report --run-id <run-id> --markdown` 和 `loop-agent dag doctor --run-id <run-id> --markdown` 读取事实与诊断失败。失败 run 不做成功式 closeout；使用 `loop-agent dag closeout-draft --run-id <run-id>` 生成 failure handoff。",
         "",
@@ -2043,13 +2044,14 @@ function buildTargetFeatureWorkflow(input) {
         "## Agent DAG Path",
         "",
         "```bash",
-        'loop-agent new-task <task-id> "Task title"',
-        "# Preferred: detailed PRD → import-prd → task source prepare --apply",
-        "# loop-agent import-prd <task-id> --file <prd.md>",
-        'loop-agent task source prepare <task-id> --use-imported-prd --allowed-path "<glob>" --apply --json',
-        "loop-agent dag run-task <task-id> --profile auto --strict-models",
-        "loop-agent dag validate --dag .harness/tasks/<task-id>/dag.json --strict-models --strict-governance",
-        "loop-agent run-dag --dag .harness/tasks/<task-id>/dag.json --cwd .",
+        'loop-agent task advance <task-id> "Task title" \\',
+        "  --prd <prd.md> \\",
+        '  --allowed-path "<glob>" \\',
+        '  --verify "typecheck:npm run typecheck" \\',
+        "  --json",
+        "# Review writeSet gate digest, then:",
+        'loop-agent task advance <task-id> --approve-gate "write-set-review:<digest>" --json',
+        "loop-agent task status <task-id> --json",
         "```",
         "",
         DAG_HARD_GATE_TRIGGER,
@@ -2082,7 +2084,7 @@ function buildTargetFeatureWorkflow(input) {
         "```bash",
         "loop-agent knowledge graph-init --product-name <name>",
         "# edit knowledge/bootstrap/scope.yaml, then:",
-        "loop-agent dag run-task <task-id>   # taskKind: knowledge-graph-bootstrap",
+        "loop-agent task advance <task-id> --task-kind knowledge-graph-bootstrap --json",
         "loop-agent knowledge query --mode by_feature --feature F-2026-004 --json",
         "loop-agent knowledge query --mode by_id --id SVC-order --json",
         'loop-agent knowledge query --mode search --text "keyword" --json',
@@ -2156,14 +2158,14 @@ function buildTargetLoopAgentHarness(input) {
         "",
         "## Default Workflow",
         "",
-        "Use `loop-agent new-task`, `loop-agent dag run-task`, `loop-agent dag validate`, and `loop-agent run-dag` for non-trivial implementation work.",
+        "Use `loop-agent task advance` / `loop-agent task status` for non-trivial implementation work; advanced arbitrary DagSpec uses `loop-agent dag execute`.",
         "",
         "## Adaptive Liveness",
         "",
         "- Healthy Pi nodes are no longer stopped by a fixed 30-minute deadline. The default 4h absolute max is a final safety bound and cannot be extended by synthetic heartbeats.",
         "- Runner heartbeat proves only the runner lease. Provider, tool, or output activity records meaningful progress; prolonged inactivity can surface as `quiet`, `suspected-stall`, `probing`, or `needs-attention` in `dag status`, `dag doctor`, and Observe.",
         "- A silent transport is aborted in a controlled way. `termination-unconfirmed` means the old attempt may still exist, so loop-agent fails closed and does not start an automatic retry; inspect the run before any operator recovery.",
-        "- `agent-worker` does not set an outer `run-dag` wall-clock by default. An explicit `worker.timeout_ms` remains a hard timeout.",
+        "- `agent-worker` does not set an outer `task advance` / `dag execute` wall-clock by default. An explicit `worker.timeout_ms` remains a hard timeout.",
         "",
         "## Operator Recovery",
         "",

package/dist/commands/run-dag-progress.js

@@ -59,7 +59,7 @@ export function createRunDagProgressObserver(options = {}) {
     let timer;
     const emit = (message) => {
         try {
-            write(`[run-dag] ${message}\n`);
+            write(`[dag execute] ${message}\n`);
         }
         catch {
             // Progress is a derived CLI view and must never decide DAG execution.

package/dist/commands/status.js

@@ -1,8 +1,8 @@
-import { getTaskDir, getTaskPaths, getTaskStatus, loadTaskConfig, refreshSourceState, } from '../task/runtime.js';
-import { getArtifactPath } from '../shared/artifacts-core.js';
-import { buildTaskReadModel } from '../task/read-model.js';
+import { getTaskDir, getTaskPaths, getTaskStatus, loadTaskConfig, } from "../task/runtime.js";
+import { getArtifactPath } from "../shared/artifacts-core.js";
+import { buildTaskReadModel } from "../task/read-model.js";
 export async function runStatus(repoRoot, taskId) {
-    await refreshSourceState(repoRoot, taskId);
+    // Read-only: do not refresh/repair/migrate. Mutations belong to task advance.
     const state = await getTaskStatus(repoRoot, taskId);
     const taskConfig = await loadTaskConfig(repoRoot, taskId);
     const taskDir = getTaskDir(repoRoot, taskId);
@@ -12,17 +12,17 @@ export async function runStatus(repoRoot, taskId) {
         taskId,
         taskDir,
         taskRoot: taskDir,
-        sourceOfTruth: 'task',
+        sourceOfTruth: "task",
         artifactPaths: {
             taskConfig: taskPaths.taskConfigPath,
             workflowState: taskPaths.statePath,
             sourceDir: taskPaths.sourceDir,
             artifactsDir: `${taskDir}/artifacts`,
-            analysis: getArtifactPath(taskDir, 'analyze'),
-            plan: getArtifactPath(taskDir, 'plan'),
-            modifyLog: getArtifactPath(taskDir, 'implement'),
-            verifyResult: getArtifactPath(taskDir, 'verify'),
-            retrospective: getArtifactPath(taskDir, 'retrospective'),
+            analysis: getArtifactPath(taskDir, "analyze"),
+            plan: getArtifactPath(taskDir, "plan"),
+            modifyLog: getArtifactPath(taskDir, "implement"),
+            verifyResult: getArtifactPath(taskDir, "verify"),
+            retrospective: getArtifactPath(taskDir, "retrospective"),
         },
         runRefs: {
             oneShotRuns: readModel.runRefs.oneShotRuns,
@@ -30,7 +30,7 @@ export async function runStatus(repoRoot, taskId) {
         },
         readModel,
         actionContext: {
-            mode: 'dag',
+            mode: "dag",
             allowedEditRoots: taskConfig.allowedPaths,
             forbiddenPaths: taskConfig.forbiddenPaths,
             constraints: taskConfig.hardConstraints,
@@ -40,17 +40,18 @@ export async function runStatus(repoRoot, taskId) {
         status: state.status,
         complexity: taskConfig.complexity,
         maxFixLoops: taskConfig.maxFixLoops,
-        verifyEnv: taskConfig.verifyEnv ?? 'clean',
+        verifyEnv: taskConfig.verifyEnv ?? "clean",
         maxGoalContinuationsPerRun: taskConfig.maxGoalContinuationsPerRun ?? 5,
         goal: state.goal,
         sourceState: state.sourceState,
         completedSteps: state.completedSteps,
         decisionLogSize: state.decisionLog.length,
         artifacts: state.artifacts,
-        nextActions: [
-            readModel.nextAction.command,
-            `npm run dev -- instructions dag-draft --task ${taskId} --json`,
-        ],
-        nextSuggestedCommand: readModel.nextAction.command,
+        // Prefer task advance/status; keep single next action (no parallel command arrays).
+        next: {
+            kind: "advance-or-status",
+            command: readModel.nextAction.command,
+            reason: readModel.nextAction.reason,
+        },
     }, null, 2));
 }

package/dist/commands/study-init.js

@@ -120,8 +120,8 @@ export async function runStudyInit(repoRoot, args) {
         next: [
             'edit source/需求.md and source/执行约束.md',
             indexed
-                ? `npm run dev -- dag run-task ${options.taskId} --profile auto --strict-models`
-                : `npm run dev -- reference index ${options.taskId}; npm run dev -- dag run-task ${options.taskId} --profile auto --strict-models`,
+                ? `npm run dev -- task advance ${options.taskId} --profile auto --json`
+                : `npm run dev -- reference index ${options.taskId}; npm run dev -- task advance ${options.taskId} --profile auto --json`,
         ],
     }, null, 2));
 }