@tea-agent/loop-agent 0.13.0-beta.0 → 0.13.0

package/docs/templates/frontend-test-dag.json

@@ -1,23 +1,23 @@
-{
-  "$schema": "./agent-dag.schema.json",
-  "version": 3,
-  "title": "Frontend test RAG DAG template",
-  "runtimeContract": { "schemaVersion": 1, "agentRuntime": "pi-only", "repairWriterProtocol": "explicit-node-v1" },
-  "objective": "Build a frontend test RAG package, generate Markdown cases, execute each case serially through playwright-cli, and retain browser evidence.",
-  "globalConstraints": [
-    "Do not generate pytest or Playwright source code.",
-    "Only use declared isolated test environments; production URLs and real credentials are blocked.",
-    "Every generated browser start command is playwright-cli open --browser=chrome --headed <base-url>.",
-    "Case children execute serially. Persist each case result, logs and browser evidence before the next child starts.",
-    "A token threshold is a post-case stop check, not a model hard token cap; unstarted cases must be recorded as blocked: token-budget-exhausted."
-  ],
-  "tasks": [
-    { "id": "retrieve-frontend-test-context-pi", "depends_on": [], "executor": "pi", "role": "planner", "toolProfile": "write", "complexity": "HIGH", "writePolicy": "exclusive", "writeSet": ["testcase/frontend/rag/**"], "allowedPaths": ["REPLACE/WITH/SOURCE/PATH/**", "testcase/frontend/rag/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "RAG context.md and coverage-map.md.", "subtask_prompt_markdown": "./frontend-test-dag.retrieve-context.prompt.md" },
-    { "id": "generate-frontend-functional-cases-pi", "depends_on": ["retrieve-frontend-test-context-pi"], "executor": "pi", "role": "implementer", "toolProfile": "write", "complexity": "HIGH", "writePolicy": "exclusive", "writeSet": ["testcase/frontend/cases/**"], "allowedPaths": ["testcase/frontend/rag/**", "testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Markdown cases, index.md and manifest.json schemaVersion 1; no test source code.", "subtask_prompt_markdown": "./frontend-test-dag.generate-cases.prompt.md" },
-    { "id": "review-frontend-cases-pi", "depends_on": ["generate-frontend-functional-cases-pi"], "executor": "pi", "role": "reviewer", "complexity": "HIGH", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/rag/**", "testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "First line VERDICT: pass or VERDICT: request-revision; no writes.", "subtask_prompt_markdown": "./frontend-test-dag.review-cases.prompt.md" },
-    { "id": "materialize-frontend-case-manifest-shell", "depends_on": ["review-frontend-cases-pi"], "executor": "shell", "role": "verifier", "complexity": "LOW", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "stdout exactly JSON { cases: [...] } after manifest validation.", "subtask_prompt": "Validate the generated frontend case manifest." },
-    { "id": "execute-frontend-cases-map", "depends_on": ["materialize-frontend-case-manifest-shell"], "executor": "static", "role": "verifier", "complexity": "LOW", "writePolicy": "none", "allowedPaths": [], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Serial aggregate of browser case results.", "subtask_prompt": "Expand the validated manifest into serial browser case children.", "static": { "resultMarkdown": "Frontend case map expansion barrier." }, "dynamicExpansion": { "type": "map_agent", "workflowNodeId": "execute-frontend-cases-map", "itemsFrom": "$.nodes['materialize-frontend-case-manifest-shell'].output.cases", "itemName": "case", "maxItems": 20, "maxExpandedNodes": 20, "childIdPrefix": "execute-frontend-case", "tokenBudget": { "maxTokensPerCase": 20000, "maxTotalTokens": 200000 }, "childTask": { "executor": "pi", "role": "verifier", "skills": ["playwright-cli", "webapp-testing"], "toolProfile": "write", "complexity": "MED", "subtaskPromptTemplate": "Execute {{case.caseId}} from {{case.casePath}} in a fresh Pi session. Use playwright-cli open --browser=chrome --headed <base-url>. Persist result, logs and screenshots/trace/video under {{case.evidenceDir}}; return compact JSON only.", "outputContract": "Compact JSON <=1200 chars.", "writePolicy": "exclusive", "allowedPaths": ["testcase/frontend/cases/{{case.caseId}}.md", "testcase/frontend/rag/context.md", "testcase/frontend/rag/coverage-map.md", "testcase/frontend/evidence/{{case.caseId}}/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "writeSet": ["testcase/frontend/evidence/{{case.caseId}}/**"] } } },
-    { "id": "review-frontend-execution-pi", "depends_on": ["execute-frontend-cases-map"], "executor": "pi", "role": "reviewer", "complexity": "HIGH", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "AC-to-case-to-browser-evidence review.", "subtask_prompt_markdown": "./frontend-test-dag.review-execution.prompt.md" },
-    { "id": "frontend-test-retrospect-pi", "depends_on": ["review-frontend-execution-pi"], "executor": "pi", "role": "closeout", "toolProfile": "write", "complexity": "MED", "writePolicy": "exclusive", "writeSet": ["docs/test-reports/**"], "allowedPaths": ["testcase/frontend/**", "docs/test-reports/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Frontend test retrospective with A/B/C/D rating.", "subtask_prompt_markdown": "./frontend-test-dag.retrospect.prompt.md" }
-  ]
-}
+{
+  "$schema": "./agent-dag.schema.json",
+  "version": 3,
+  "title": "Frontend test RAG DAG template",
+  "runtimeContract": { "schemaVersion": 1, "agentRuntime": "pi-only", "repairWriterProtocol": "explicit-node-v1" },
+  "objective": "Build a frontend test RAG package, generate Markdown cases, execute each case serially through playwright-cli, and retain browser evidence.",
+  "globalConstraints": [
+    "Do not generate pytest or Playwright source code.",
+    "Only use declared isolated test environments; production URLs and real credentials are blocked.",
+    "Every generated browser start command is playwright-cli open --browser=chrome --headed <base-url>.",
+    "Case children execute serially. Persist each case result, logs and browser evidence before the next child starts.",
+    "A token threshold is a post-case stop check, not a model hard token cap; unstarted cases must be recorded as blocked: token-budget-exhausted."
+  ],
+  "tasks": [
+    { "id": "retrieve-frontend-test-context-pi", "depends_on": [], "executor": "pi", "role": "planner", "toolProfile": "write", "complexity": "HIGH", "writePolicy": "exclusive", "writeSet": ["testcase/frontend/rag/**"], "allowedPaths": ["REPLACE/WITH/SOURCE/PATH/**", "testcase/frontend/rag/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "RAG context.md and coverage-map.md.", "subtask_prompt_markdown": "./frontend-test-dag.retrieve-context.prompt.md" },
+    { "id": "generate-frontend-functional-cases-pi", "depends_on": ["retrieve-frontend-test-context-pi"], "executor": "pi", "role": "implementer", "toolProfile": "write", "complexity": "HIGH", "writePolicy": "exclusive", "writeSet": ["testcase/frontend/cases/**"], "allowedPaths": ["testcase/frontend/rag/**", "testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Markdown cases, index.md and manifest.json schemaVersion 1; no test source code.", "subtask_prompt_markdown": "./frontend-test-dag.generate-cases.prompt.md" },
+    { "id": "review-frontend-cases-pi", "depends_on": ["generate-frontend-functional-cases-pi"], "executor": "pi", "role": "reviewer", "complexity": "HIGH", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/rag/**", "testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "First line VERDICT: pass or VERDICT: request-revision; no writes.", "subtask_prompt_markdown": "./frontend-test-dag.review-cases.prompt.md" },
+    { "id": "materialize-frontend-case-manifest-shell", "depends_on": ["review-frontend-cases-pi"], "executor": "shell", "role": "verifier", "complexity": "LOW", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "stdout exactly JSON { cases: [...] } after manifest validation.", "subtask_prompt": "Validate the generated frontend case manifest." },
+    { "id": "execute-frontend-cases-map", "depends_on": ["materialize-frontend-case-manifest-shell"], "executor": "static", "role": "verifier", "complexity": "LOW", "writePolicy": "none", "allowedPaths": [], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Serial aggregate of browser case results.", "subtask_prompt": "Expand the validated manifest into serial browser case children.", "static": { "resultMarkdown": "Frontend case map expansion barrier." }, "dynamicExpansion": { "type": "map_agent", "workflowNodeId": "execute-frontend-cases-map", "itemsFrom": "$.nodes['materialize-frontend-case-manifest-shell'].output.cases", "itemName": "case", "maxItems": 20, "maxExpandedNodes": 20, "childIdPrefix": "execute-frontend-case", "tokenBudget": { "maxTokensPerCase": 20000, "maxTotalTokens": 200000 }, "childTask": { "executor": "pi", "role": "verifier", "skills": ["playwright-cli", "webapp-testing"], "toolProfile": "write", "complexity": "MED", "subtaskPromptTemplate": "Execute {{case.caseId}} from {{case.casePath}} in a fresh Pi session. Use playwright-cli open --browser=chrome --headed <base-url>. Persist result, logs and screenshots/trace/video under {{case.evidenceDir}}; return compact JSON only.", "outputContract": "Compact JSON <=1200 chars.", "writePolicy": "exclusive", "allowedPaths": ["testcase/frontend/cases/{{case.caseId}}.md", "testcase/frontend/rag/context.md", "testcase/frontend/rag/coverage-map.md", "testcase/frontend/evidence/{{case.caseId}}/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "writeSet": ["testcase/frontend/evidence/{{case.caseId}}/**"] } } },
+    { "id": "review-frontend-execution-pi", "depends_on": ["execute-frontend-cases-map"], "executor": "pi", "role": "reviewer", "complexity": "HIGH", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "AC-to-case-to-browser-evidence review.", "subtask_prompt_markdown": "./frontend-test-dag.review-execution.prompt.md" },
+    { "id": "frontend-test-retrospect-pi", "depends_on": ["review-frontend-execution-pi"], "executor": "pi", "role": "closeout", "toolProfile": "write", "complexity": "MED", "writePolicy": "exclusive", "writeSet": ["docs/test-reports/**"], "allowedPaths": ["testcase/frontend/**", "docs/test-reports/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Frontend test retrospective with A/B/C/D rating.", "subtask_prompt_markdown": "./frontend-test-dag.retrospect.prompt.md" }
+  ]
+}

package/docs/templates/frontend-test-dag.retrieve-context.prompt.md

@@ -1,3 +1,3 @@
-# Retrieve frontend test context
-
-Write only `testcase/frontend/rag/context.md` and `coverage-map.md`. Record traceable facts from the task source, routes, components, API/Mock contracts, existing tests and execution contract. Do not invent fields, credentials, limits or test data.
+# Retrieve frontend test context
+
+Write only `testcase/frontend/rag/context.md` and `coverage-map.md`. Record traceable facts from the task source, routes, components, API/Mock contracts, existing tests and execution contract. Do not invent fields, credentials, limits or test data.

package/docs/templates/frontend-test-dag.retrospect.prompt.md

@@ -1,3 +1,3 @@
-# Frontend test retrospective
-
-Write a dated report under `docs/test-reports/` covering case coverage, passed/failed/blocked results, review findings, browser anomalies, residual risks, and an A/B/C/D maturity rating. Blocked cases never count as passed.
+# Frontend test retrospective
+
+Write a dated report under `docs/test-reports/` covering case coverage, passed/failed/blocked results, review findings, browser anomalies, residual risks, and an A/B/C/D maturity rating. Blocked cases never count as passed.

package/docs/templates/frontend-test-dag.review-cases.prompt.md

@@ -1,3 +1,3 @@
-# Review frontend cases
-
-Read the RAG files and Markdown cases only. First line must be `VERDICT: pass` or `VERDICT: request-revision`. Report AC coverage, case independence, evidence completeness, unsafe environment/data dependencies, and manifest issues. The verdict is advisory and does not block browser execution.
+# Review frontend cases
+
+Read the RAG files and Markdown cases only. First line must be `VERDICT: pass` or `VERDICT: request-revision`. Report AC coverage, case independence, evidence completeness, unsafe environment/data dependencies, and manifest issues. The verdict is advisory and does not block browser execution.

package/docs/templates/frontend-test-dag.review-execution.prompt.md

@@ -1,3 +1,3 @@
-# Review frontend execution evidence
-
-Review AC → case → browser-evidence traceability. A passed case needs assertions and screenshot or equivalent browser evidence. Failed and blocked cases need an explicit cause. Treat `token-budget-exhausted` as blocked; do not substitute model conclusions or static checks for browser evidence.
+# Review frontend execution evidence
+
+Review AC → case → browser-evidence traceability. A passed case needs assertions and screenshot or equivalent browser evidence. Failed and blocked cases need an explicit cause. Treat `token-budget-exhausted` as blocked; do not substitute model conclusions or static checks for browser evidence.

package/docs/templates/harness.schema.json

@@ -1,221 +1,221 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://loop-agent.local/schemas/harness.schema.json",
-  "title": "loop-agent Harness Manifest",
-  "description": "面向编辑器的 harness.json JSON Schema。运行时校验仍以 src/governance/manifest-types.ts 中的 Zod harnessManifestSchema 为准。",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["version", "project", "governanceRoot", "entrypoints", "artifacts", "scripts"],
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "description": "IDE 使用的 JSON Schema 引用。该字段只是编辑器 metadata，loop-agent 运行时解析时会忽略。"
-    },
-    "version": {
-      "type": "number",
-      "description": "harness manifest 的 schema 版本。",
-      "default": 1
-    },
-    "project": {
-      "type": "string",
-      "minLength": 1,
-      "description": "便于人类阅读的项目名，不需要与 adapter 名称一致。"
-    },
-    "adapter": {
-      "type": "string",
-      "description": "可选的仓库 adapter id。普通初始化项目使用 loop-agent。"
-    },
-    "governanceRoot": {
-      "type": "string",
-      "minLength": 1,
-      "description": "仓库相对目录，用于存放治理文档、执行计划、报告和模板。",
-      "default": "docs"
-    },
-    "features": {
-      "type": "object",
-      "additionalProperties": false,
-      "description": "可选 harness 能力的 feature flags。",
-      "properties": {
-        "goals": {
-          "type": "boolean",
-          "description": "启用面向目标的长程任务支持。",
-          "default": true
-        }
-      }
-    },
-    "workflowPolicy": {
-      "type": "object",
-      "additionalProperties": false,
-      "description": "面向 agent 实现任务的声明式工作流策略。",
-      "properties": {
-        "defaultImplementationWorkflow": {
-          "enum": ["agent-dag"],
-          "description": "首选实现工作流。新的可恢复工作应使用 agent-dag。",
-          "default": "agent-dag"
-        },
-        "dag": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "outputLanguage": {
-              "enum": ["zh-CN", "en"],
-              "description": "DAG agent 节点的默认输出语言。未配置时使用简体中文；代码、命令和机器契约不翻译。",
-              "default": "zh-CN"
-            },
-            "defaultEntry": {
-              "enum": ["dag run-task", "run-dag"],
-              "description": "默认 DAG 入口，用于任务 DAG 生成或直接 DAG 执行。",
-              "default": "dag run-task"
-            },
-            "profileRouting": {
-              "type": "object",
-              "additionalProperties": false,
-              "description": "将治理 profile 映射到 DAG 生成模板。",
-              "properties": {
-                "minimal": {
-                  "enum": ["standard-dag", "review-gated-dag", "supervised-implementation"],
-                  "description": "minimal 治理 profile 使用的 DAG 生成模板。"
-                },
-                "standard": {
-                  "enum": ["standard-dag", "review-gated-dag", "supervised-implementation"],
-                  "description": "standard 治理 profile 使用的 DAG 生成模板。"
-                },
-                "reviewed": {
-                  "enum": ["standard-dag", "review-gated-dag", "supervised-implementation"],
-                  "description": "reviewed 治理 profile 使用的 DAG 生成模板。"
-                },
-                "supervised": {
-                  "enum": ["standard-dag", "review-gated-dag", "supervised-implementation"],
-                  "description": "supervised 治理 profile 使用的 DAG 生成模板。"
-                }
-              }
-            }
-          }
-        },
-        "humanGatePolicy": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "defaultMode": {
-              "enum": ["record-only", "pause-on-human"],
-              "description": "human decision gate 的默认行为。",
-              "default": "record-only"
-            },
-            "pauseOn": {
-              "type": "array",
-              "description": "需要暂停并等待人类输入的决策风险类别。",
-              "items": { "type": "string", "minLength": 1 },
-              "default": []
-            }
-          }
-        }
-      }
-    },
-    "entrypoints": {
-      "type": "object",
-      "description": "具名的仓库相对文件路径，用作人类和 agent 的入口。",
-      "additionalProperties": { "type": ["string", "null"] },
-      "properties": {
-        "readme": { "type": ["string", "null"], "description": "根 README 入口。" },
-        "agents": { "type": ["string", "null"], "description": "Agent 操作指令入口。" },
-        "governanceIndex": { "type": ["string", "null"], "description": "治理文档索引。" },
-        "principles": { "type": ["string", "null"], "description": "开发原则文档。" },
-        "workflow": { "type": ["string", "null"], "description": "功能工作流文档。" },
-        "verificationMatrix": { "type": ["string", "null"], "description": "验证命令矩阵。" },
-        "loopAgentHarness": { "type": ["string", "null"], "description": "harness runtime 指南。" }
-      }
-    },
-    "artifacts": {
-      "type": "object",
-      "description": "具名的仓库相对目录，用于保存长期治理产物和 runtime 邻近产物。",
-      "additionalProperties": { "type": ["string", "null"] },
-      "properties": {
-        "templatesDir": { "type": ["string", "null"], "description": "治理模板目录。" },
-        "execPlansDir": { "type": ["string", "null"], "description": "执行计划目录。" },
-        "progressDir": { "type": ["string", "null"], "description": "进度交接日志目录。" },
-        "reportsDir": { "type": ["string", "null"], "description": "验证、审计和演化报告目录。" },
-        "decisionsDir": { "type": ["string", "null"], "description": "架构决策记录目录。" },
-        "taskPoolDir": { "type": ["string", "null"], "description": "Worker Task Pool runtime state 目录。" }
-      }
-    },
-    "scripts": {
-      "type": "object",
-      "description": "具名验证与治理脚本。根据具体 key，值可以是仓库相对路径或 shell 命令。",
-      "additionalProperties": { "type": ["string", "null"] },
-      "properties": {
-        "checkRepo": { "type": ["string", "null"], "description": "仓库治理综合检查脚本。" },
-        "checkStructure": { "type": ["string", "null"], "description": "历史结构检查入口；新配置优先使用 checkEngineeringStructure。" },
-        "checkEngineeringStructure": { "type": ["string", "null"], "description": "工程结构检查脚本。" },
-        "checkDocIndex": { "type": ["string", "null"], "description": "docs 索引同步检查脚本。" },
-        "checkDocLinks": { "type": ["string", "null"], "description": "docs 链接检查脚本。" },
-        "checkHarnessRuntimeClean": { "type": ["string", "null"], "description": "harness runtime 目录清洁度检查脚本。" },
-        "checkInitEvolutionNeeded": { "type": ["string", "null"], "description": "初始化能力演化影响分级检查脚本。" },
-        "checkInitSurface": { "type": ["string", "null"], "description": "npm package 和 init projection surface 检查脚本。" },
-        "checkArchitectureBoundaries": { "type": ["string", "null"], "description": "runtime import 边界检查脚本。" },
-        "checkSkillEntry": { "type": ["string", "null"], "description": "repo-local skill 入口完整性检查脚本。" },
-        "ciGovernance": { "type": ["string", "null"], "description": "治理类 CI 检查入口。" },
-        "ciTests": { "type": ["string", "null"], "description": "项目测试入口。" },
-        "ci": { "type": ["string", "null"], "description": "完整 CI 检查入口。" },
-        "quickVerify": { "type": ["string", "null"], "description": "快速验证命令。" },
-        "standardVerify": { "type": ["string", "null"], "description": "标准验证命令。" },
-        "fullVerify": { "type": ["string", "null"], "description": "完整验证命令。" }
-      }
-    },
-    "worktree": {
-      "type": "object",
-      "additionalProperties": false,
-      "description": "loop-agent 管理 worktree 时使用的配置。",
-      "properties": {
-        "rootRelativePath": {
-          "type": "string",
-          "minLength": 1,
-          "default": ".worktrees"
-        }
-      }
-    },
-    "executors": {
-      "type": "object",
-      "description": "按 executor id 分组的执行器配置。受治理 runtime 仅支持 pi；Cursor 仅通过 cursor-prompt sidecar 使用，不得配置在 executors 中。",
-      "additionalProperties": { "$ref": "#/$defs/executor" },
-      "properties": {
-        "pi": { "$ref": "#/$defs/executor" }
-      }
-    }
-  },
-  "$defs": {
-    "workflowPolicyDagTemplate": {
-      "enum": ["standard-dag", "review-gated-dag", "supervised-implementation"],
-      "description": "某个治理 profile 选择的 DAG 生成模板。"
-    },
-    "executor": {
-      "type": "object",
-      "additionalProperties": false,
-      "description": "executor 设置。DAG 模型选择优先读取 LOW/MED/HIGH，其次读取 defaultModel，最后回退到 loop-agent runtime 默认矩阵。字面值 default 表示不覆盖。",
-      "properties": {
-        "description": { "type": "string" },
-        "enabled": { "type": "boolean" },
-        "defaultModel": {
-          "type": "string",
-          "description": "executor 默认模型。设置为 default 或省略时，会继续回退到 loop-agent runtime 默认值。",
-          "default": "default"
-        },
-        "LOW": {
-          "type": "string",
-          "description": "LOW 复杂度 DAG task 的模型覆盖值，优先级高于 defaultModel。"
-        },
-        "MED": {
-          "type": "string",
-          "description": "MED 复杂度 DAG task 的模型覆盖值，优先级高于 defaultModel。"
-        },
-        "HIGH": {
-          "type": "string",
-          "description": "HIGH 复杂度 DAG task 的模型覆盖值，优先级高于 defaultModel。"
-        },
-        "requiresApiKey": {
-          "type": "string",
-          "description": "该 executor 需要的环境变量名，通常用于 Cursor 等可选外部 executor。init update 会剥离过时的 pi.requiresApiKey。"
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://loop-agent.local/schemas/harness.schema.json",
+  "title": "loop-agent Harness Manifest",
+  "description": "面向编辑器的 harness.json JSON Schema。运行时校验仍以 src/governance/manifest-types.ts 中的 Zod harnessManifestSchema 为准。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "project", "governanceRoot", "entrypoints", "artifacts", "scripts"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "IDE 使用的 JSON Schema 引用。该字段只是编辑器 metadata，loop-agent 运行时解析时会忽略。"
+    },
+    "version": {
+      "type": "number",
+      "description": "harness manifest 的 schema 版本。",
+      "default": 1
+    },
+    "project": {
+      "type": "string",
+      "minLength": 1,
+      "description": "便于人类阅读的项目名，不需要与 adapter 名称一致。"
+    },
+    "adapter": {
+      "type": "string",
+      "description": "可选的仓库 adapter id。普通初始化项目使用 loop-agent。"
+    },
+    "governanceRoot": {
+      "type": "string",
+      "minLength": 1,
+      "description": "仓库相对目录，用于存放治理文档、执行计划、报告和模板。",
+      "default": "docs"
+    },
+    "features": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "可选 harness 能力的 feature flags。",
+      "properties": {
+        "goals": {
+          "type": "boolean",
+          "description": "启用面向目标的长程任务支持。",
+          "default": true
+        }
+      }
+    },
+    "workflowPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "面向 agent 实现任务的声明式工作流策略。",
+      "properties": {
+        "defaultImplementationWorkflow": {
+          "enum": ["agent-dag"],
+          "description": "首选实现工作流。新的可恢复工作应使用 agent-dag。",
+          "default": "agent-dag"
+        },
+        "dag": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "outputLanguage": {
+              "enum": ["zh-CN", "en"],
+              "description": "DAG agent 节点的默认输出语言。未配置时使用简体中文；代码、命令和机器契约不翻译。",
+              "default": "zh-CN"
+            },
+            "defaultEntry": {
+              "enum": ["dag run-task", "run-dag"],
+              "description": "默认 DAG 入口，用于任务 DAG 生成或直接 DAG 执行。",
+              "default": "dag run-task"
+            },
+            "profileRouting": {
+              "type": "object",
+              "additionalProperties": false,
+              "description": "将治理 profile 映射到 DAG 生成模板。",
+              "properties": {
+                "minimal": {
+                  "enum": ["standard-dag", "review-gated-dag", "supervised-implementation"],
+                  "description": "minimal 治理 profile 使用的 DAG 生成模板。"
+                },
+                "standard": {
+                  "enum": ["standard-dag", "review-gated-dag", "supervised-implementation"],
+                  "description": "standard 治理 profile 使用的 DAG 生成模板。"
+                },
+                "reviewed": {
+                  "enum": ["standard-dag", "review-gated-dag", "supervised-implementation"],
+                  "description": "reviewed 治理 profile 使用的 DAG 生成模板。"
+                },
+                "supervised": {
+                  "enum": ["standard-dag", "review-gated-dag", "supervised-implementation"],
+                  "description": "supervised 治理 profile 使用的 DAG 生成模板。"
+                }
+              }
+            }
+          }
+        },
+        "humanGatePolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "defaultMode": {
+              "enum": ["record-only", "pause-on-human"],
+              "description": "human decision gate 的默认行为。",
+              "default": "record-only"
+            },
+            "pauseOn": {
+              "type": "array",
+              "description": "需要暂停并等待人类输入的决策风险类别。",
+              "items": { "type": "string", "minLength": 1 },
+              "default": []
+            }
+          }
+        }
+      }
+    },
+    "entrypoints": {
+      "type": "object",
+      "description": "具名的仓库相对文件路径，用作人类和 agent 的入口。",
+      "additionalProperties": { "type": ["string", "null"] },
+      "properties": {
+        "readme": { "type": ["string", "null"], "description": "根 README 入口。" },
+        "agents": { "type": ["string", "null"], "description": "Agent 操作指令入口。" },
+        "governanceIndex": { "type": ["string", "null"], "description": "治理文档索引。" },
+        "principles": { "type": ["string", "null"], "description": "开发原则文档。" },
+        "workflow": { "type": ["string", "null"], "description": "功能工作流文档。" },
+        "verificationMatrix": { "type": ["string", "null"], "description": "验证命令矩阵。" },
+        "loopAgentHarness": { "type": ["string", "null"], "description": "harness runtime 指南。" }
+      }
+    },
+    "artifacts": {
+      "type": "object",
+      "description": "具名的仓库相对目录，用于保存长期治理产物和 runtime 邻近产物。",
+      "additionalProperties": { "type": ["string", "null"] },
+      "properties": {
+        "templatesDir": { "type": ["string", "null"], "description": "治理模板目录。" },
+        "execPlansDir": { "type": ["string", "null"], "description": "执行计划目录。" },
+        "progressDir": { "type": ["string", "null"], "description": "进度交接日志目录。" },
+        "reportsDir": { "type": ["string", "null"], "description": "验证、审计和演化报告目录。" },
+        "decisionsDir": { "type": ["string", "null"], "description": "架构决策记录目录。" },
+        "taskPoolDir": { "type": ["string", "null"], "description": "Worker Task Pool runtime state 目录。" }
+      }
+    },
+    "scripts": {
+      "type": "object",
+      "description": "具名验证与治理脚本。根据具体 key，值可以是仓库相对路径或 shell 命令。",
+      "additionalProperties": { "type": ["string", "null"] },
+      "properties": {
+        "checkRepo": { "type": ["string", "null"], "description": "仓库治理综合检查脚本。" },
+        "checkStructure": { "type": ["string", "null"], "description": "历史结构检查入口；新配置优先使用 checkEngineeringStructure。" },
+        "checkEngineeringStructure": { "type": ["string", "null"], "description": "工程结构检查脚本。" },
+        "checkDocIndex": { "type": ["string", "null"], "description": "docs 索引同步检查脚本。" },
+        "checkDocLinks": { "type": ["string", "null"], "description": "docs 链接检查脚本。" },
+        "checkHarnessRuntimeClean": { "type": ["string", "null"], "description": "harness runtime 目录清洁度检查脚本。" },
+        "checkInitEvolutionNeeded": { "type": ["string", "null"], "description": "初始化能力演化影响分级检查脚本。" },
+        "checkInitSurface": { "type": ["string", "null"], "description": "npm package 和 init projection surface 检查脚本。" },
+        "checkArchitectureBoundaries": { "type": ["string", "null"], "description": "runtime import 边界检查脚本。" },
+        "checkSkillEntry": { "type": ["string", "null"], "description": "repo-local skill 入口完整性检查脚本。" },
+        "ciGovernance": { "type": ["string", "null"], "description": "治理类 CI 检查入口。" },
+        "ciTests": { "type": ["string", "null"], "description": "项目测试入口。" },
+        "ci": { "type": ["string", "null"], "description": "完整 CI 检查入口。" },
+        "quickVerify": { "type": ["string", "null"], "description": "快速验证命令。" },
+        "standardVerify": { "type": ["string", "null"], "description": "标准验证命令。" },
+        "fullVerify": { "type": ["string", "null"], "description": "完整验证命令。" }
+      }
+    },
+    "worktree": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "loop-agent 管理 worktree 时使用的配置。",
+      "properties": {
+        "rootRelativePath": {
+          "type": "string",
+          "minLength": 1,
+          "default": ".worktrees"
+        }
+      }
+    },
+    "executors": {
+      "type": "object",
+      "description": "按 executor id 分组的执行器配置。受治理 runtime 仅支持 pi；Cursor 仅通过 cursor-prompt sidecar 使用，不得配置在 executors 中。",
+      "additionalProperties": { "$ref": "#/$defs/executor" },
+      "properties": {
+        "pi": { "$ref": "#/$defs/executor" }
+      }
+    }
+  },
+  "$defs": {
+    "workflowPolicyDagTemplate": {
+      "enum": ["standard-dag", "review-gated-dag", "supervised-implementation"],
+      "description": "某个治理 profile 选择的 DAG 生成模板。"
+    },
+    "executor": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "executor 设置。DAG 模型选择优先读取 LOW/MED/HIGH，其次读取 defaultModel，最后回退到 loop-agent runtime 默认矩阵。字面值 default 表示不覆盖。",
+      "properties": {
+        "description": { "type": "string" },
+        "enabled": { "type": "boolean" },
+        "defaultModel": {
+          "type": "string",
+          "description": "executor 默认模型。设置为 default 或省略时，会继续回退到 loop-agent runtime 默认值。",
+          "default": "default"
+        },
+        "LOW": {
+          "type": "string",
+          "description": "LOW 复杂度 DAG task 的模型覆盖值，优先级高于 defaultModel。"
+        },
+        "MED": {
+          "type": "string",
+          "description": "MED 复杂度 DAG task 的模型覆盖值，优先级高于 defaultModel。"
+        },
+        "HIGH": {
+          "type": "string",
+          "description": "HIGH 复杂度 DAG task 的模型覆盖值，优先级高于 defaultModel。"
+        },
+        "requiresApiKey": {
+          "type": "string",
+          "description": "该 executor 需要的环境变量名，通常用于 Cursor 等可选外部 executor。init update 会剥离过时的 pi.requiresApiKey。"
+        }
+      }
+    }
+  }
+}