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

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

@@ -2455,62 +2455,9 @@ async function buildFrontendHybridDagFromTask(sources) {
                     sourceContext,
                 ].join("\n\n"),
             },
-            {
-                id: "frontend-contract-json-pi",
-                depends_on: [
-                    "frontend-plan-revision-pi",
-                    "frontend-plan-pi",
-                    "frontend-final-design-review-pi",
-                    "frontend-design-review-pi",
-                ],
-                dependsPolicy: "all-or-condition-skip",
-                role: "planner",
-                executor: "pi",
-                complexity: "MED",
-                writePolicy: "read-only",
-                outputMode: "structured-required",
-                retryPolicy: STRUCTURED_REQUIRED_PI_RETRY_POLICY,
-                allowedPaths: readOnlyPaths,
-                forbiddenPaths,
-                skills: FRONTEND_IMPLEMENTATION_SKILLS,
-                outputContract: "Return exactly one JSON object conforming to frontend-implementation-contract-v1. No Markdown, prose, comments, or code fences.",
-                subtask_prompt: [
-                    "Convert the effective reviewed frontend plan into the canonical frontend-implementation-contract-v1 JSON.",
-                    "Use frontend-plan-revision-pi when it is FINISHED; otherwise use frontend-plan-pi. Confirm the effective design review passed before producing the contract.",
-                    "Return only the JSON object. Do not wrap it in Markdown or a code fence. Do not add explanatory text.",
-                    "Preserve all requirement expectedOutcome, interaction trigger/expectedBehavior, target files, verification targets, Mock/API decisions, and Real Integration Gap from the effective plan.",
-                    frontendContractSchemaBlock,
-                    sourceContext,
-                ].join("\n\n"),
-            },
-            {
-                id: "frontend-contract-json-validate-shell",
-                depends_on: ["frontend-contract-json-pi"],
-                role: "verifier",
-                executor: "shell",
-                complexity: "LOW",
-                writePolicy: "read-only",
-                allowedPaths: readOnlyPaths,
-                forbiddenPaths,
-                outputContract: "Validated frontend implementation contract artifact with schema ID and SHA-256.",
-                subtask_prompt: "Materialize and validate the structured frontend contract before prewrite authorization.",
-                shell: {
-                    commands: [],
-                    jsonArtifactGate: {
-                        fromNodeId: "frontend-contract-json-pi",
-                        schemaId: "frontend-implementation-contract-v1",
-                        artifactName: "frontend-implementation-contract.json",
-                        outputDir: "contracts",
-                    },
-                    cwd: ".",
-                    timeoutMs: 60000,
-                },
-            },
             {
                 id: "frontend-prewrite-gate-shell",
                 depends_on: [
-                    "frontend-contract-json-pi",
-                    "frontend-contract-json-validate-shell",
                     "frontend-final-design-review-pi",
                     "frontend-design-review-pi",
                     "frontend-plan-revision-pi",
@@ -2529,8 +2476,8 @@ async function buildFrontendHybridDagFromTask(sources) {
                     commands: [],
                     frontendPrewriteGate: {
                         schemaVersion: 1,
-                        planFromNodeId: "frontend-contract-json-pi",
-                        planFallbackFromNodeIds: ["frontend-plan-revision-pi", "frontend-plan-pi"],
+                        planFromNodeId: "frontend-plan-revision-pi",
+                        planFallbackFromNodeIds: ["frontend-plan-pi"],
                         reviewFromNodeId: "frontend-final-design-review-pi",
                         reviewFallbackFromNodeIds: ["frontend-design-review-pi"],
                         requiredRequirementIds: requirementIds,
@@ -5239,16 +5186,16 @@ export async function requireManagedTaskContractBinding(input) {
         const expectedRevision = state.ref?.revision ?? 0;
         const observedCanonicalHash = state.observedCanonicalHash ?? "<observedCanonicalHash-from-show>";
         const recovery = state.effectiveStatus === "transaction-incomplete"
-            ? `Recover the unfinished transaction first: loop-agent task contract recover --task ${input.taskId} --json`
+            ? `Recover the unfinished transaction first: loop-agent task advance ${input.taskId} --json`
             : [
                 "After reviewing the show JSON, either adopt the current on-disk facts:",
-                `loop-agent task contract adopt --task ${input.taskId} --expected-revision ${expectedRevision} --expected-observed-hash ${observedCanonicalHash} --request-id <unique-request-id> --request-payload-sha256 <sha256-of-this-adopt-request> --json`,
+                `loop-agent task advance ${input.taskId} --from-draft --expected-revision ${expectedRevision} --expected-observed-hash ${observedCanonicalHash} --request-id <unique-request-id> --request-payload-sha256 <sha256-of-this-adopt-request> --json`,
                 "or apply a reviewed draft:",
-                `loop-agent task contract apply --task ${input.taskId} --input <reviewed-draft.json> --expected-revision ${expectedRevision} --expected-observed-hash ${observedCanonicalHash} --request-id <unique-request-id> --request-payload-sha256 <sha256-of-input-file> --json`,
+                `loop-agent task advance ${input.taskId} --from-draft --input <reviewed-draft.json> --expected-revision ${expectedRevision} --expected-observed-hash ${observedCanonicalHash} --request-id <unique-request-id> --request-payload-sha256 <sha256-of-input-file> --json`,
             ].join(" ");
         const err = new Error([
             `dag generate requires managed Task Contract for task ${input.taskId} (effectiveStatus=${state.effectiveStatus})`,
-            `Inspect current state: loop-agent task contract show ${input.taskId} --json`,
+            `Inspect current state: loop-agent task status ${input.taskId} --json`,
             recovery,
             "Do not auto-adopt or auto-apply before confirming the Task Contract facts and concurrency fields.",
         ].join("; "));
@@ -5340,7 +5287,7 @@ async function buildHybridDagForTemplate(sources, template) {
         else if (template === "review-gated-dag")
             spec = buildReviewGatedHybridDag(standard, sources);
         else
-            spec = await buildSupervisedHybridDag(standard, sources);
+            spec = buildSupervisedHybridDag(standard, sources);
     }
     applyProjectGovernanceReview(spec, template, sources);
     // New generate path always emits DagSpec v4 + bindings.
@@ -5774,12 +5721,10 @@ function buildWriteSetGateNode(sources) {
         },
     };
 }
-async function buildSoftVerifyNode(sources) {
+function buildSoftVerifyNode(sources) {
     const implementId = implementationNodeId();
     const strategy = resolveDagVerifyStrategy(sources.taskConfig, "1");
-    const fallbackCommands = sources.repoRoot
-        ? (await discoverFrontendFallbackVerifyCommands(sources.repoRoot)).staticCommands
-        : ["npm run typecheck"];
+    const fallbackCommands = ["npm run typecheck"];
     const focusedIntermediate = sources.verifyCommands?.intermediate.filter((command) => !isFullSuiteVerifyCommand(command));
     const plannedIntermediate = applyMavenVerificationPlanning({
         repoRoot: sources.repoRoot,
@@ -6021,7 +5966,7 @@ function resolveSupervisedConvergence(taskConfig) {
         chainNodeIds: [...SUPERVISED_CONVERGENCE_CHAIN_NODE_IDS],
     };
 }
-async function buildSupervisedHybridDag(standard, sources) {
+function buildSupervisedHybridDag(standard, sources) {
     const contract = getTaskOrThrow(standard, "contract-pi");
     const scoutSrc = getTaskOrThrow(standard, "scout-src");
     const scoutTests = getTaskOrThrow(standard, "scout-tests");
@@ -6073,7 +6018,7 @@ async function buildSupervisedHybridDag(standard, sources) {
                     "final-write-set-audit-format-repair-pi",
                 ],
             }),
-            await buildSoftVerifyNode(sources),
+            buildSoftVerifyNode(sources),
             buildProcessSupervisorNode(sources),
             buildProcessGateNode(sources),
             buildRepairNode(sources),

package/docs/templates/evaluation/agents-map-slim-v1.md

@@ -24,7 +24,7 @@
 - Shell 搜索优先 `rg`，按名找文件优先 `fd`；脚本用 Git Bash / 兼容 Bash。
 - 用 loop-agent 迭代本仓库时，控制器必须来自已发布 npm 包（记录实际版本）；启动后不要中途升级；不要用工作区 `npm link` / `npm run dev` 控制可能改 CLI/runtime/package 的任务。
 - 反复出现的约束固化为文档、脚本、检查、测试或模板；禁止占位实现（除非 contract 标明脚手架）。
-- 非微小实现：`exec-plan` 不能替代 Agent DAG；除非用户要求 one-shot 或计划记录 escape hatch，否则改实现前完成 `new-task`、结构化路径、`dag run-task`、`dag validate` 与 writeSet 审查。
+- 非微小实现：`exec-plan` 不能替代 Agent DAG；除非用户要求 one-shot 或计划记录 escape hatch，否则改实现前完成 `task advance`（结构化路径 + writeSet 审查），不得主会话直接改实现。
 - 不要自行引入外部 SDD/spec-first 等强制平行治理树；以本文件与 `docs/` 为准（ADR 0006）。
 
 ## 开始顺序

package/docs/templates/evaluation/agents-map-verbose-v0.md

@@ -27,7 +27,7 @@
 - 用 loop-agent 迭代本仓库时，控制器必须来自已发布的 npm 安装包；首次安装或有意升级可用 `@tea-agent/loop-agent@latest`，但一次自举任务启动后不要中途升级控制器，并记录 `npm list -g @tea-agent/loop-agent --depth=0` 显示的实际版本。不要用当前工作区的 `npm link` 或 `npm run dev` 控制可能改动 CLI、DAG runtime、executor、package metadata 或 build output 的任务。
 - 反复出现的约束要固化为文档、脚本、检查项、测试或模板。
 - 除非用户明确要求，不要自行引入外部 SDD、spec-first、brainstorming 等方法论的强制设计文档、审批门或专用目录；本仓库的工作流程以本文件和 `docs/` 中的治理规则为准。
-- 对非微小的实现或修复，`exec-plan` 只负责记录 Contract、进度和验证证据，不能替代 Agent DAG。除非用户明确要求 one-shot，或在计划中记录了适用的 escape hatch 与理由，否则在改动实现文件前必须完成 `new-task`、结构化 `allowedPaths` / `forbiddenPaths`、`dag run-task` 和 `dag validate`；随后按已校验的 DAG 执行并审查 writer `writeSet`。
+- 对非微小的实现或修复，`exec-plan` 只负责记录 Contract、进度和验证证据，不能替代 Agent DAG。除非用户明确要求 one-shot，或在计划中记录了适用的 escape hatch 与理由，否则在改动实现文件前必须完成 `task advance`（含结构化 `allowedPaths` / `forbiddenPaths` 与 writeSet 审查）；随后 `--approve-gate` 长跑，不得主会话直接改实现。
 - 禁止占位实现；除非 contract 明确约定为脚手架且标出后续闭环。
 
 ## 开始顺序
@@ -53,7 +53,7 @@
 9. 查看最近提交、相关执行计划、progress/report，确认当前上下文。
 10. 检查 `git status --short --branch`。
 11. 运行本次任务相关的最小基线验证。
-12. 如果用户提到"后端测试"、"接口测试"、"pytest"、"自动化测试"，在任务 `task.json` 中设置 `taskKind: "backend-test"` 再 `dag run-task`；不要用 `--profile backend-test`（CLI 不接受该值，专用模板只走 taskKind）。知识回写用 `taskKind: "knowledge-sync"`（须 `featureId`），图谱开荒用 `taskKind: "knowledge-graph-bootstrap"`。`--profile` 仅表示治理强度：`auto|minimal|standard|reviewed|supervised`。
+12. 如果用户提到"后端测试"、"接口测试"、"pytest"、"自动化测试"，在任务 `task.json` 中设置 `taskKind: "backend-test"` 再 `task advance`；不要用 `--profile backend-test`（CLI 不接受该值，专用模板只走 taskKind）。知识回写用 `taskKind: "knowledge-sync"`（须 `featureId`），图谱开荒用 `taskKind: "knowledge-graph-bootstrap"`。`--profile` 仅表示治理强度：`auto|minimal|standard|reviewed|supervised`。
 13. 如果用户提到"看板"、"observe"、"监控面板"、"启动看板"，使用 `agent-worker console` 启动统一 Operator Console（默认 repo=当前目录、port=8790；兼容入口 `agent-worker console serve --repo . --port 8790`）；`/inspect/` 提供只读检视。`agent-worker observe serve --repo . --port 8787` 仅为兼容入口。
 14. 如果用户要求“合并 `<source>` 到 `<target>`”或“合并 origin/main 到当前分支”，先阅读 `docs/operations/branch-merge-guideline.md`，按影响自动选择快速、标准或深度模式；始终冻结 source SHA、审查双方功能、运行 merge-tree、生成 source-SHA 合并报告，并在提交前再次 fetch 防止主干前进。
 
@@ -88,7 +88,7 @@
 - 优先沿用现有 helper、目录边界和局部模式，再考虑新增抽象。
 - 长期决策写入 `docs/`，不要只留在聊天里。
 - 分支合并遵循 `docs/operations/branch-merge-guideline.md`；快速模式只用于可证明的低风险/no-op 合并，涉及冲突、init/package/runtime/release/public API 时必须升级为标准或深度模式。
-- 后端测试、接口/API 测试、pytest 或明确的后端自动化测试，必须把 `.harness/tasks/<task-id>/task.json` 的 `taskKind` 设置为 `"backend-test"`，不得保留默认 `standard`。`backend-test` 是 `taskKind`，不是 `--profile` 的可选值；`dag run-task` 继续使用 `--profile auto` 选择治理等级。仅说“自动化测试”且前后端不明时，先根据任务源和项目技术栈判断，禁止无条件路由。
+- 后端测试、接口/API 测试、pytest 或明确的后端自动化测试，必须把 `.harness/tasks/<task-id>/task.json` 的 `taskKind` 设置为 `"backend-test"`，不得保留默认 `standard`。`backend-test` 是 `taskKind`，不是 `--profile` 的可选值；`task advance` 继续使用 `--profile auto` 选择治理等级。仅说“自动化测试”且前后端不明时，先根据任务源和项目技术栈判断，禁止无条件路由。
 - 本地 Operator Console：`agent-worker console`（默认 repo=当前目录、port=8790；兼容 `agent-worker console serve --repo . --port 8790`），访问 `http://127.0.0.1:8790/`；其中 `/inspect/` 为只读运行检视。默认绑定本机 `127.0.0.1`；可用 `--host 0.0.0.0` / `--debug`，不要直接暴露到公开网络。端口被占用时不会自动更换，请用 `--port <port>` 显式指定。
 - 面向使用者的新增、修改、删除或修复，应同步更新根目录 `CHANGELOG.md`；保持版本级摘要即可，不写过细技术细节。
 - 面向用户的中文更新日志、README 和说明文档应使用自然、结果导向的表达：先说明用户能获得什么或问题如何改善，保留必要的命令和产品术语，避免逐字翻译、内部实现细节和无意义的中英混杂。

package/docs/templates/harness.schema.json

@@ -63,9 +63,9 @@
               "default": "zh-CN"
             },
             "defaultEntry": {
-              "enum": ["dag run-task", "run-dag"],
+              "enum": ["task advance", "dag execute"],
               "description": "默认 DAG 入口，用于任务 DAG 生成或直接 DAG 执行。",
-              "default": "dag run-task"
+              "default": "task advance"
             },
             "profileRouting": {
               "type": "object",

package/docs/templates/init-managed-agents.md

@@ -33,7 +33,7 @@
 | **允许** | 已发布 `loop-agent` / `agent-worker` CLI；只读 status/doctor/report/inspect/observe；准备 `source/*` 与 `task.json` 边界；human gate；shell 验证与 handoff。 |
 | **禁止** | 绕过 CLI 用宿主 Edit/Write/ApplyPatch 直接改业务实现；CLI/DAG 失败后「救火改文件」；用聊天自述代替 shell 验证。 |
 | **失败时** | `dag doctor` / `dag report` / `dag reconcile-run`（及适用 worker reconcile）；修正任务源/`task.json`/DAG 后经 CLI 重跑。 |
-| **实现写入** | 业务代码 **只** 经受治理 DAG writer（`implement-pi` / `repair-pi`）经 `dag run-task` / `run-dag`。 |
+| **实现写入** | 业务代码 **只** 经受治理 DAG writer（`implement-pi` / `repair-pi`）经 `task advance`（批准 writeSet gate 后长跑）。 |
 
 **永远不要**：`loop-agent` / `agent-worker` 失败 ⇒ 主会话直接改仓库实现。
 
@@ -45,7 +45,7 @@
 | 初始化更新校验 / 检查初始化更新 / loop-agent 初始化更新校验 / loop agent初始化更新校验 | 更新校验 | 只读报告，不写入 |
 | 初始化对齐 / 升级后对齐 / reconcile 初始化 / loop-agent 初始化对齐 | 升级对齐 | 自动应用确定性安全动作；surface 缺失、人工决策、活跃 DAG/Worker 或 Worker 状态无法确认时零写入 |
 | 初始化安全更新 / 应用初始化更新 / loop-agent 初始化安全更新 / loop agent初始化安全更新 | 安全更新 | 先 check-update，再只执行确定性安全动作 |
-| loop-agent 帮我完成 / 帮我实现 / 帮我修复 / 帮我开发 <需求>；使用 loop-agent 完成 <X>；按 loop-agent 流程处理 <X> | 通用需求实现 | 先建任务源与 `task.json.allowedPaths` / `forbiddenPaths`，再 `new-task` → `dag run-task` → `dag validate` → `run-dag`；主会话不得直接修改业务实现 |
+| loop-agent 帮我完成 / 帮我实现 / 帮我修复 / 帮我开发 <需求>；使用 loop-agent 完成 <X>；按 loop-agent 流程处理 <X> | 通用需求实现 | 先提供 PRD 与 `allowedPaths` / `forbiddenPaths` / verify，再 `task advance` → 审查 writeSet gate → `task advance --approve-gate`；主会话不得直接修改业务实现 |
 
 **更新校验（只读）**：只读执行下面命令；**不得自动**执行 `apply-safe` 或模型合并。
 
@@ -85,33 +85,30 @@ pwd → `README.md` → `harness.json` → `__LOOP_AGENT_GOVERNANCE_ROOT__/READM
 ### Agent DAG 路径
 
 ```bash
-loop-agent new-task <task-id> "任务标题"
-# 推荐默认：详细 PRD → import → prepare（无需手写两个 source；默认无 LLM 写 source）
-loop-agent import-prd <task-id> --file <path-to-prd.md>
-# 非微小或跨会话任务（推荐）：loop-agent plan create <plan-id> "<title>"
-loop-agent task source prepare <task-id> \
-  --use-imported-prd \
+loop-agent task advance <task-id> "任务标题" \
+  --prd <path-to-prd.md> \
   --allowed-path "<glob>" \
   --forbidden-path ".harness/**" \
   --verify "typecheck:npm run typecheck" \
-  --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 .
+  --json
+# 审查 writeSet gate digest 后：
+loop-agent task advance <task-id> --approve-gate "write-set-review:<digest>" --json
+loop-agent task status <task-id> --json
+# 非微小或跨会话任务（推荐）：loop-agent plan create <plan-id> "<title>"
 # 有 plan 时收尾：loop-agent plan complete <plan-id> --summary "..."
 ```
 
-`source/需求.md` 与 `source/执行约束.md` 仍必需（M8/M9），但默认由 `task source prepare --apply` 投影生成，而不是主会话手写。有原始 PRD 时优先 `import-prd` 原样归档。`import-prd` / `plan create` 不是 `dag run-task` 的硬依赖。写入前同步 `task.json.allowedPaths` / `task.json.forbiddenPaths` 并审查 writer `writeSet`。
+`source/需求.md` 与 `source/执行约束.md` 仍必需（M8/M9），但默认由 `task advance --prd` 投影生成，而不是主会话手写。`plan create` 不是 `task advance` 的硬依赖。写入前同步 `task.json.allowedPaths` / `task.json.forbiddenPaths` 并审查 writer `writeSet`。高级任意 DagSpec 才用 `dag validate|execute|report`，不进入标准 happy path。
 
-凡是影响项目公共契约、执行入口、交付流水线、自动化/治理、数据模型、安全或权限模型、跨模块行为、用户可见工作流的改动，都必须在编辑实现文件前先创建任务、完成 source prepare（或等价 managed contract）、生成 DAG，并审查 DAG/writeSet。
+凡是影响项目公共契约、执行入口、交付流水线、自动化/治理、数据模型、安全或权限模型、跨模块行为、用户可见工作流的改动，都必须在编辑实现文件前先通过 `task advance` 建立 managed contract / writeSet gate，并审查 gate digest。
 
 ### 任务类型路由（taskKind）
 
 - 用户明确提出后端测试、接口/API 测试、pytest，或语境明确为后端的自动化测试时，必须把 `.harness/tasks/<task-id>/task.json` 的 `taskKind` 设置为 `"backend-test"`，不得保留默认 `standard`。
-- `backend-test` 是 `taskKind`，不是 `--profile` 的可选值；运行 `dag run-task` 时继续使用 `--profile auto`。
+- `backend-test` 是 `taskKind`，不是 `--profile` 的可选值；运行 `task advance` 时继续使用 `--profile auto`。
 - 仅出现“自动化测试”且无法判断前后端时，先阅读任务源与目标项目技术栈再决定，禁止无条件路由到 `backend-test`。
 - 用户提示词明确是前端实现需求（例如前端页面、UI、组件或交互开发）时，必须把 `.harness/tasks/<task-id>/task.json` 的 `taskKind` 设置为 `"frontend-implementation"`，不得保留默认 `standard`。
-- `frontend-implementation` 是 `taskKind`，不是 `--profile` 的可选值；运行 `dag run-task` 时继续使用 `--profile auto`，也可按需显式选择 `minimal` / `standard` / `reviewed` / `supervised`，不要把业务模板名当作 profile。
+- `frontend-implementation` 是 `taskKind`，不是 `--profile` 的可选值；运行 `task advance` 时继续使用 `--profile auto`，也可按需显式选择 `minimal` / `standard` / `reviewed` / `supervised`，不要把业务模板名当作 profile。
 - 前端自动化测试（浏览器/UI 自动化、Playwright、E2E）继续使用 `taskKind: "frontend-test"`，不得设置为 `frontend-implementation`。
 
 ### 运行看板（只读）

package/docs/templates/production-readiness-checklist.md

@@ -23,10 +23,10 @@
 
 ## DAG 主路径
 
-- [ ] 已运行 `loop-agent new-task <task-id> "Task title"` 或 task 已存在
-- [ ] `loop-agent dag run-task <task-id> --profile auto --strict-models --output <dag-path>` 产出 DAG spec
+- [ ] 已运行 `loop-agent task advance <task-id> "Task title" --prd <prd.md> --allowed-path "<glob>" --json`（或 task 已存在且契约就绪）
+- [ ] `task advance` 产出/刷新 `.harness/tasks/<task-id>/dag.json` 并打开 writeSet gate
 - [ ] `loop-agent dag validate --dag <dag-path> --strict-models --strict-governance` 通过
-- [ ] `loop-agent run-dag --dag <dag-path> --cwd .` 产出 run id
+- [ ] `loop-agent task advance <task-id> --approve-gate "write-set-review:<digest>" --json` 产出 run id / lifecycle 事实（advanced arbitrary DAG 才用 `dag execute`）
 - [ ] `loop-agent dag report --run-id <run-id> --markdown` 可读
 - [ ] `loop-agent dag doctor --run-id <run-id>` 能解释失败或 paused run
 

package/harness.json

@@ -6,7 +6,7 @@
   "workflowPolicy": {
     "defaultImplementationWorkflow": "agent-dag",
     "dag": {
-      "defaultEntry": "dag run-task",
+      "defaultEntry": "task advance",
       "outputLanguage": "zh-CN",
       "profileRouting": {
         "minimal": "standard-dag",
@@ -58,9 +58,9 @@
   "executors": {
     "pi": {
       "description": "Pi planning, review, diagnosis, and bounded writing when DAG toolProfile=write",
-      "LOW": {"model": "deepseek/deepseek-v4-flash", "thinking": "high"},
-      "MED": {"model": "deepseek/deepseek-v4-flash", "thinking": "max"},
-      "HIGH": {"model": "deepseek/deepseek-v4-flash", "thinking": "max"}
+      "LOW": "minimax-m3",
+      "MED": "grok-4.5",
+      "HIGH": "gpt-5.6-sol"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tea-agent/loop-agent",
-  "version": "0.26.5-beta.2",
+  "version": "0.27.0",
   "type": "module",
   "bin": {
     "loop-agent": "bin/loop-agent.js",

package/scripts/kb-bootstrap-init-skeleton.sh

@@ -157,7 +157,8 @@ Structured project knowledge (Git is authority).
 bash scripts/kb-bootstrap-init-skeleton.sh --root .
 # edit knowledge/bootstrap/scope.yaml
 # task.json: { "taskKind": "knowledge-graph-bootstrap", ... }
-loop-agent dag run-task <id> --execute --cwd .
+loop-agent task advance <id> --task-kind knowledge-graph-bootstrap --allowed-path "<glob>" --json
+# then: loop-agent task advance <id> --approve-gate "write-set-review:<digest>" --json
 ```
 
 ## Query (Phase A design)

package/scripts/kb-graph-incremental-prepare.mjs

@@ -354,7 +354,7 @@ function main() {
 			"Next:",
 			"```bash",
 			"# task.json: { \"taskKind\": \"knowledge-graph-bootstrap\", ... }",
-			"loop-agent dag run-task <task-id> --execute --cwd .",
+			"loop-agent task advance <task-id> --task-kind knowledge-graph-bootstrap --json  # then --approve-gate",
 			`bash scripts/kb-graph-materialize.sh --root ${args.root}`,
 			"```",
 			"",
@@ -375,7 +375,7 @@ function main() {
 					services: args.services,
 					domains: args.domains,
 				},
-				next: "set task.json.taskKind=knowledge-graph-bootstrap; dag run-task --execute",
+				next: "set task.json.taskKind=knowledge-graph-bootstrap; task advance --json then --approve-gate",
 			},
 			null,
 			2,

package/skills/loop-agent/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: loop-agent
 description: >-
-  Use when implementing features, processing PRDs or requirements, running structured loop-agent workflows, creating harness tasks, using Agent DAG, run-dag, pi-prompt planning/review, cursor-prompt one-shot sidecar intervention, initializing a target project with loop-agent, checking init update status, applying a safe init update, or converging website/governance docs after user-visible changes in loop-agent. Triggers: loop-agent, workflow, structured development, harness task, Agent DAG, docs converge, Converge Docs, 文档收敛, 结构化开发, 工作流, 需求实现, PRD 实现, 初始化 loop-agent, loop agent 初始化, loop agent初始化, loop-agent 初始化, 初始化更新校验, loop agent初始化更新校验, 检查初始化更新, 初始化安全更新, loop agent初始化安全更新, 应用初始化更新. 强路由：loop-agent 帮我完成需求, 帮我实现, 帮我修复, 帮我开发, 使用 loop-agent 完成, 按 loop-agent 流程处理, 通用需求实现；这些表达确定性地进入 Agent DAG/CLI（new-task, dag run-task, dag validate, run-dag），主会话编排而不直接写业务实现.
+  Use when implementing features, processing PRDs or requirements, running structured loop-agent workflows, creating harness tasks, using Agent DAG / task advance lifecycle, pi-prompt planning/review, cursor-prompt one-shot sidecar intervention, initializing a target project with loop-agent, checking init update status, applying a safe init update, or converging website/governance docs after user-visible changes in loop-agent. Triggers: loop-agent, workflow, structured development, harness task, Agent DAG, task advance, task status, dag validate, dag execute, docs converge, Converge Docs, 文档收敛, 结构化开发, 工作流, 需求实现, PRD 实现, 初始化 loop-agent, loop agent 初始化, loop agent初始化, loop-agent 初始化, 初始化更新校验, loop agent初始化更新校验, 检查初始化更新, 初始化安全更新, loop agent初始化安全更新, 应用初始化更新. 强路由：loop-agent 帮我完成需求, 帮我实现, 帮我修复, 帮我开发, 使用 loop-agent 完成, 按 loop-agent 流程处理, 通用需求实现；这些表达确定性地进入 task advance / Agent DAG CLI，主会话编排而不直接写业务实现.
 references:
   - path: references/harness-policy.md
     required: true
@@ -26,24 +26,29 @@ Entry: routing and hard rules. Required details come from frontmatter references
 ## 唯一推荐执行路径
 
 ```bash
-loop-agent new-task <task-id> "Title"
-# PRD-first default: detailed PRD → import-prd → task source prepare --apply
-# no hand-written/LLM source by default
-loop-agent import-prd <task-id> --file <prd.md>
-loop-agent task source prepare <task-id> --use-imported-prd --allowed-path "<glob>" --apply --json
-# plan create for non-trivial work (see references/source-and-plan-practice.md)
-loop-agent dag run-task <task-id> --profile auto --strict-models
-# default draft: .harness/tasks/<task-id>/dag.json
-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 <repo-root>
+# 标准 mutation：task advance（create/import/prepare/generate/validate → writeSet gate）
+loop-agent task advance <task-id> "Title" \
+  --prd <prd.md> \
+  --allowed-path "<glob>" \
+  --forbidden-path ".harness/**" \
+  --verify "typecheck:npm run typecheck" \
+  --json
+
+# 审查 JSON 中的 gate.writeSet / gate.digest 后批准并长跑
+loop-agent task advance <task-id> \
+  --approve-gate "write-set-review:<digest>" \
+  --json
+
+# 可选只读（无 refresh 副作用）
+loop-agent task status <task-id> --json
 ```
 
-执行前审阅 `profileRouting`、`governanceProfile`、writer `writeSet`、`forbiddenPaths`、decision gate mode。
+非微小跨会话任务仍可先 `plan create`（见 references/source-and-plan-practice.md）。主会话只审 gate/writeSet 与验证证据，不拼低层 prepare/run-task/run-dag/promote/closeout 命令串。
 
 ## 进阶主题路由
 
 | 主题 | Reference |
-|---|---|
+| --- | --- |
 | Harness policy、Loop、SePO-lite | `references/harness-policy.md` |
 | Agent DAG topology、writeSet、recovery | `references/hybrid-dag.md` |
 | Operator commands、`agent-worker` | `references/command-reference.md` |

package/skills/loop-agent/references/README.md

@@ -39,7 +39,7 @@ failure handling 与 workflow 细节放在这里，避免主 skill 变成百科
 | `task-workflow.md` | 处理 task source material、task config、repo adapter 或 legacy task 目录布局 |
 | `pi-prompt.md` | 运行短时 one-shot Pi SDK task，且不创建 `.harness/tasks/` |
 | `one-shot-runs.md` | 解释 `.harness/runs/{active,completed,failed}` 的创建条件、生命周期、治理清理与 `promote-run` 关系 |
-| `hybrid-dag.md` | 使用 Agent DAG Level 2 `dag validate` / `run-dag`，Level 3 `dag init-hybrid` / `dag run-task`，或查看 write policy、DAG source-of-truth 规则 |
+| `hybrid-dag.md` | 使用 Agent DAG Level 2 `dag validate` / `dag execute`，Level 3 `dag init-hybrid` / `task advance`，或查看 write policy、DAG source-of-truth 规则 |
 | `pi-subagent-assisted-mode.md` | 启用 `piSubagentMode`，或在 Pi step 内配置 read-only scout / planner / reviewer subagent |
 | `model-routing.md` | 查看或修改 model/provider 默认、profile、routing 或 fallback 行为 |
 | `post-implementation-and-patterns.md` | 处理 post-verify handoff、PRD item 拆分、fast bounded task、quick status 或 Pi timeout |