@tea-agent/loop-agent 0.24.10 → 0.25.0

package/docs/templates/agent-dag.schema.json

@@ -521,6 +521,15 @@
             "retryOnInvalid": { "type": "boolean", "default": true }
           }
         },
+        "writerOutcomePolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type"],
+          "description": "Fail-closed outcome/diff consistency protocol for bounded Pi writers. The first non-empty assistant line must be IMPLEMENTATION_OUTCOME: changed, already-satisfied, or blocked.",
+          "properties": {
+            "type": { "const": "implementation-outcome-v1" }
+          }
+        },
         "allowedPaths": {
           "type": "array",
           "items": { "type": "string", "minLength": 1 },

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

@@ -250,7 +250,7 @@
         ".harness/dag-runs/**",
         "artifacts/**"
       ],
-      "outputContract": "One scoped pytest execution over Markdown-mapped scripts producing a valid pytest-html report with per-case captured output, self-contained reports/backend-test.html and reports/backend-test.md, plus internal reports/backend-test-facts.md evidence; exit 0/1 with valid evidence continues.",
+      "outputContract": "One scoped pytest execution over Markdown-mapped scripts producing a valid pytest-html report with per-case captured output, self-contained reports/backend-test.html, reports/backend-test.md, reports/backend-test-facts.md, and a deterministic self-contained reports/backend-test-l5-dashboard.html (machine-computed L-5 metrics, no JSON); exit 0/1 with valid evidence continues.",
       "subtask_prompt": "Resolve the final Markdown Automation Notes/自动化映射 to a unique, safe set of testcase/**/test_*.py targets and execute only those scripts exactly once. Prefer the deterministic module one-to-one path when a mapped script is missing but the module stem file exists. Generate a native pytest-html self-contained report, then render the primary self-contained Chinese HTML report from the same pytest-html plus final Markdown case metadata without rerun. Keep 测试结论, quality status, failure overview, and a polished per-case result card with concise scenario, automation test name, result, duration, and redacted bounded HTTP request parameters/response results for both passed and failed cases. Do not render a technical/execution evidence section in HTML; retain auditable paths and hashes in facts.",
       "shell": {
         "commands": [
@@ -283,8 +283,8 @@
         ".harness/dag-runs/**",
         "artifacts/**"
       ],
-      "outputContract": "Final Markdown report and L-5 conclusion under docs/test-reports/**; no JSON.",
-      "subtask_prompt": "Generate the final Markdown report from upstream facts and run-owned environment, advisory case-validation, advisory traceability, pytest-html and HTML evidence. Do not emit JSON.\n\nUse this exact human-facing section order: 测试结论 → 执行概览 → 质量校验 → 失败分析 → 风险与建议 → 证据与 L-5. Put the decision and key numbers first, use compact tables/bullets, and keep headings concise. Do not paste entire upstream reports, duplicate per-case tables already present in facts, or repeat the same evidence in multiple sections; link to paths/hashes and quote only the findings needed for the conclusion.\n\nAlways state the exact PASS/FAIL status and findings from nodes 4 and 6. Their FAIL status does not block pytest, but it must remain visible as a quality/traceability risk and must never be rewritten as PASS.\n\nInclude environment, case quality/review, automation mapping, exact pytest facts, failure classification/analysis, risks, regression recommendations, evidence paths/hashes, coverage availability, and L-5 READY/NOT READY.\n\nNever override Shell/pytest-html facts. L-5 requires pass=100%, AC=100%, automation>=90%, line>=80%, branch>=70%, skipped=0 and no blocking Critical risk.\n\nWrite only under docs/test-reports/**."
+      "outputContract": "Final Markdown report and L-5 conclusion under docs/test-reports/**; the deterministic L-5 dashboard at reports/backend-test-l5-dashboard.html is the authoritative visualization and must be linked, not re-rendered; no JSON.",
+      "subtask_prompt": "Generate the final Markdown report from upstream facts and run-owned environment, advisory case-validation, advisory traceability, pytest-html and HTML evidence. Do not emit JSON.\n\nUse this exact human-facing section order: 测试结论 → 执行概览 → 质量校验 → 失败分析 → 风险与建议 → 证据与 L-5. Put the decision and key numbers first, use compact tables/bullets, and keep headings concise. Do not paste entire upstream reports, duplicate per-case tables already present in facts, or repeat the same evidence in multiple sections; link to paths/hashes and quote only the findings needed for the conclusion.\n\nThe L-5 metrics and visualization are already produced deterministically by node 7 at reports/backend-test-l5-dashboard.html (rendered from computeL5ReportMetrics). Link to that dashboard as the authoritative L-5 view; do not recompute pass/AC/automation/coverage numbers or re-render an HTML dashboard yourself. Quote its L-5 decision verbatim.\n\nAlways state the exact PASS/FAIL status and findings from nodes 4 and 6. Their FAIL status does not block pytest, but it must remain visible as a quality/traceability risk and must never be rewritten as PASS.\n\nInclude environment, case quality/review, automation mapping, exact pytest facts, failure classification/analysis, risks, regression recommendations, evidence paths/hashes, coverage availability, and L-5 READY/NOT READY.\n\nNever override Shell/pytest-html facts. L-5 requires pass=100%, AC=100%, automation>=90%, line>=80%, branch>=70%, skipped=0 and no blocking Critical risk.\n\nWrite only under docs/test-reports/**."
     }
   ],
   "sourceBinding": {

package/docs/templates/frontend-implementation-contract.schema.json

@@ -10,9 +10,9 @@
     "sourceBinding": { "$ref": "#/$defs/sourceBinding" },
     "riskLevel": { "enum": ["small", "standard", "high-risk"] },
     "targets": { "type": "object", "additionalProperties": false, "required": ["files"], "properties": { "files": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/path" } }, "routes": { "type": "array", "items": { "type": "string", "pattern": "^/" } }, "publicApiChanges": { "type": "array", "items": { "type": "string", "minLength": 1 } } } },
-    "requirements": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["id", "implementationTargets", "verificationTargetIds"], "properties": { "id": { "$ref": "#/$defs/requirementId" }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "evidenceGap": { "$ref": "#/$defs/gap" } } } },
+    "requirements": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["id", "expectedOutcome", "implementationTargets", "verificationTargetIds"], "properties": { "id": { "$ref": "#/$defs/requirementId" }, "expectedOutcome": { "type": "string", "minLength": 1 }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "evidenceGap": { "$ref": "#/$defs/gap" } } } },
     "uiStates": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["name", "applicable"], "properties": { "name": { "type": "string", "minLength": 1 }, "applicable": { "type": "boolean" }, "expectedBehavior": { "type": "string", "minLength": 1 }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "notApplicableReason": { "type": "string", "minLength": 1 } }, "allOf": [{ "if": { "properties": { "applicable": { "const": true } }, "required": ["applicable"] }, "then": { "required": ["expectedBehavior", "implementationTargets", "verificationTargetIds"], "properties": { "implementationTargets": { "minItems": 1 }, "verificationTargetIds": { "minItems": 1 } } } }, { "if": { "properties": { "applicable": { "const": false } }, "required": ["applicable"] }, "then": { "required": ["notApplicableReason"] } }] } },
-    "interactions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["name", "implementationTargets", "verificationTargetIds"], "properties": { "name": { "type": "string", "minLength": 1 }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string" } } } } },
+    "interactions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["name", "trigger", "expectedBehavior", "implementationTargets", "verificationTargetIds"], "properties": { "name": { "type": "string", "minLength": 1 }, "trigger": { "type": "string", "minLength": 1 }, "expectedBehavior": { "type": "string", "minLength": 1 }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string" } } } } },
     "mockApi": { "type": "object", "additionalProperties": false, "required": ["strategy", "productionDefaultOff", "activation", "endpoints"], "properties": { "strategy": { "enum": ["native", "browser-intercept", "request-adapter", "not-needed"] }, "productionDefaultOff": { "const": true }, "activation": { "type": "string", "minLength": 1 }, "endpoints": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["method", "path"], "properties": { "method": { "enum": ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"] }, "path": { "type": "string", "pattern": "^/" }, "fixture": { "$ref": "#/$defs/path" }, "consumer": { "$ref": "#/$defs/path" } } } } } },
     "designEvidence": { "type": "object", "additionalProperties": false, "required": ["source", "paths", "conflicts"], "properties": { "source": { "type": "string", "minLength": 1 }, "paths": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "conflicts": { "type": "array", "items": { "type": "string", "minLength": 1 } } } },
     "verificationTargets": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["id", "type", "commandLabel", "file", "requirementIds", "uiStates"], "properties": { "id": { "type": "string", "minLength": 1 }, "type": { "enum": ["static", "unit", "component", "integration", "mock"] }, "commandLabel": { "type": "string", "minLength": 1 }, "file": { "$ref": "#/$defs/path" }, "symbol": { "type": "string", "minLength": 1 }, "requirementIds": { "type": "array", "items": { "$ref": "#/$defs/requirementId" } }, "uiStates": { "type": "array", "items": { "type": "string", "minLength": 1 } } } } },

package/docs/templates/product-line/README.md

@@ -1,6 +1,22 @@
 # Product-line feature packet
 
-Copy this directory for each product feature. Replace angle-bracket placeholders, keep IDs stable, and run:
+**推荐入口（确定性脚手架）：**
+
+```bash
+agent-worker feature scaffold --repo . --template backend-only \
+  --feature-id F-2026-010 --title "..." \
+  --be-path services/example/** \
+  --verify-command "npm run typecheck" --verify-command "npm test"
+agent-worker task validate-feature features/F-2026-010
+```
+
+批量示例见 [`feature-scaffold-batch.example.yaml`](feature-scaffold-batch.example.yaml)。
+
+**生成快照（可读、防漂移，非 dogfood）**见 [`scaffold-samples/`](scaffold-samples/)：`backend-only` / `frontend-only` / `fe-with-api`。刷新：`node --import tsx/esm scripts/generate-scaffold-samples.mjs`；校验：同脚本 `--check` 或 `bash scripts/check-scaffold-samples.sh`。
+
+操作说明以 skill 包内 `skills/agent-worker/references/agent-worker-operator.md` § Feature Packet Scaffold 为准（不依赖 website 是否随包）。
+
+也可手工复制本目录占位文件，替换 angle-bracket placeholders，保持 IDs 稳定，然后运行：
 
 ```bash
 agent-worker task validate-feature <feature-dir>

package/docs/templates/product-line/feature-scaffold-batch.example.yaml

@@ -0,0 +1,31 @@
+# Example batch for: agent-worker feature scaffold --batch <this-file> --repo <repo>
+# Every feature_id must be explicit (v1 does not auto-allocate IDs).
+# Any invalid row fails the whole batch with zero writes.
+
+features:
+  - feature_id: F-2026-010
+    title: Banner 拉取欢迎语
+    template: fe-with-api
+    description: 前端 Banner 调用薄 API 展示欢迎语
+    fe_paths:
+      - apps/web/src/welcome/**
+    be_paths:
+      - services/welcome/**
+    verify_commands:
+      - npm run typecheck
+      - npm test
+    acceptance:
+      - id: AC-001
+        title: 页面展示非空 message
+        given: 欢迎语接口可用
+        when: 用户打开页面
+        then: 页面展示非空 message
+
+  - feature_id: F-2026-011
+    title: 设置页主题切换
+    template: frontend-only
+    fe_paths:
+      - apps/web/src/settings/theme/**
+    verify_commands:
+      - npm run typecheck
+      - npm test

package/docs/templates/product-line/scaffold-samples/README.md

@@ -0,0 +1,36 @@
+# Scaffold samples (generated snapshots)
+
+> **身份**：由 `agent-worker feature scaffold` **同一套 typed builders** 生成的只读快照，供人阅读与防漂移对照。  
+> **不是** 运行中的 dogfood Feature，**不是** 默认模板源（生成器仍以 `src/worker/feature/scaffold.ts` 为准）。  
+> **不要** 复制进 `features/` 当业务 Feature；日常请直接跑 `feature scaffold`。
+
+## 目录
+
+| 子目录 | 模板 | 快照 feature_id |
+| --- | --- | --- |
+| `backend-only/` | pure backend | `F-2099-901` |
+| `frontend-only/` | pure frontend | `F-2099-902` |
+| `fe-with-api/` | contract + BE + FE | `F-2099-903` |
+
+ID 使用 `F-2099-*` 号段，避免与 `features/F-2026-*` dogfood 混淆。
+
+## 刷新 / 校验
+
+```bash
+# 按当前 scaffold 实现重写本目录
+node --import tsx/esm scripts/generate-scaffold-samples.mjs
+
+# CI / 本地：快照必须与当前 builder 一致
+node --import tsx/esm scripts/generate-scaffold-samples.mjs --check
+npx vitest run test/worker/feature/scaffold-samples.test.ts
+```
+
+`scripts/check-repo.sh` 会调用 `--check`。若你改了 scaffold 模板语义，请先 generate 再提交快照。
+
+## 与真实 Packet 的关系
+
+| 路径 | 用途 |
+| --- | --- |
+| 本目录 | 文档可读快照 + 漂移门禁 |
+| `features/F-2026-*` | 仓库内真实 / dogfood Feature |
+| 用户目标仓 `features/F-YYYY-NNN/` | `feature scaffold --repo <target>` 写入处 |

package/docs/templates/product-line/scaffold-samples/backend-only/acceptance.yaml

@@ -0,0 +1,13 @@
+schema_version: 1
+feature_id: F-2099-901
+acceptance:
+  - id: AC-001
+    title: Scaffold sample — backend-only
+    priority: must
+    type: behavior
+    given: 需求与路径边界已冻结
+    when: Feature Packet 内实现任务完成
+    then: 验收目标达成且 verify.commands 通过
+    verification:
+      expected_task_refs:
+        - BE-IMPL-001

package/docs/templates/product-line/scaffold-samples/backend-only/design.md

@@ -0,0 +1,14 @@
+# Design — Scaffold sample — backend-only
+
+## Goals
+
+Generated snapshot for docs/templates/product-line/scaffold-samples. Not a live dogfood Feature.
+
+## Paths
+
+- Backend allowed paths:
+  - `services/sample-backend/**`
+
+## Artifacts
+
+- `BE-IMPL-001` produces `backend-impl`

package/docs/templates/product-line/scaffold-samples/backend-only/feature.yaml

@@ -0,0 +1,3 @@
+schema_version: 1
+feature_id: F-2099-901
+profile: generic

package/docs/templates/product-line/scaffold-samples/backend-only/requirement.md

@@ -0,0 +1,6 @@
+# Scaffold sample — backend-only
+
+Generated snapshot for docs/templates/product-line/scaffold-samples. Not a live dogfood Feature.
+
+Feature ID: `F-2099-901`
+Template: `backend-only`

package/docs/templates/product-line/scaffold-samples/backend-only/tasks/BE-IMPL-001.yaml

@@ -0,0 +1,83 @@
+schema_version: 1
+id: BE-IMPL-001
+feature_id: F-2099-901
+title: Scaffold sample — backend-only — 后端实现
+description: Generated snapshot for
+  docs/templates/product-line/scaffold-samples. Not a live dogfood Feature.
+repo:
+  name: loop-agent
+  path_ref: .
+  default_branch: main
+type: backend-feature
+priority: P2
+risk_level: medium
+depends_on: []
+source_docs:
+  requirement: ../requirement.md
+  acceptance: ../acceptance.yaml
+  design: ../design.md
+acceptance_refs:
+  - AC-001
+scope:
+  goals:
+    - 实现后端变更并满足验收
+  non_goals:
+    - 不扩展到模板外的 Task 节点（无 BE-TEST/FE-TEST/FINAL-VERIFY）
+  assumptions:
+    - verify.commands 由 scaffold 调用方显式提供
+  open_questions: []
+constraints:
+  allowed_paths:
+    - services/sample-backend/**
+    - docs/progress/F-2099-901/be/status.md
+    - docs/progress/F-2099-901/be/**
+  forbidden_paths:
+    - config/prod/**
+    - .env
+    - .env.*
+    - secrets/**
+    - apps/**
+  hard_constraints:
+    - 不读取生产密钥
+    - 不绕过 scaffold 冻结的 depends/produces/consumes
+execution:
+  workflow: agent-dag
+verify:
+  preset: standard
+  mode: serial
+  quota: full
+  commands:
+    - id: verify-1
+      label: npm run typecheck
+      command: npm run typecheck
+      required: true
+      timeout_ms: 300000
+    - id: verify-2
+      label: npm test
+      command: npm test
+      required: true
+      timeout_ms: 300000
+worker:
+  execution_mode: generate-validate-run
+  max_attempts: 1
+  timeout_ms: 7200000
+  require_clean_worktree: true
+  require_human_review: true
+  create_worktree: false
+loop_agent:
+  profile_policy: mapped
+  strict_models: true
+  strict_governance: true
+  max_concurrent: 1
+outputs:
+  required:
+    - dag_json
+    - dag_validate_json
+    - run_record
+    - dag_report_json
+    - shell_verification
+    - closeout_or_failure_handoff
+failure_policy:
+  failed_run_promote: false
+  generate_closeout_draft: true
+  create_followup_task: true

package/docs/templates/product-line/scaffold-samples/backend-only/tasks/task-graph.yaml

@@ -0,0 +1,14 @@
+schema_version: 1
+feature_id: F-2099-901
+nodes:
+  - id: BE-IMPL-001
+    task: BE-IMPL-001.yaml
+    type: backend-feature
+    depends_on: []
+    produces:
+      - kind: backend-impl
+        schemaId: backend-impl-v1
+        path: services/sample-backend
+parallel_policy:
+  max_parallel_tasks: 1
+  disallow_same_file_parallel_writes: true

package/docs/templates/product-line/scaffold-samples/fe-with-api/acceptance.yaml

@@ -0,0 +1,15 @@
+schema_version: 1
+feature_id: F-2099-903
+acceptance:
+  - id: AC-001
+    title: Scaffold sample — fe-with-api
+    priority: must
+    type: behavior
+    given: 需求与路径边界已冻结
+    when: Feature Packet 内实现任务完成
+    then: 验收目标达成且 verify.commands 通过
+    verification:
+      expected_task_refs:
+        - CONTRACT-001
+        - BE-IMPL-001
+        - FE-IMPL-001

package/docs/templates/product-line/scaffold-samples/fe-with-api/design.md

@@ -0,0 +1,18 @@
+# Design — Scaffold sample — fe-with-api
+
+## Goals
+
+Generated snapshot for docs/templates/product-line/scaffold-samples. Not a live dogfood Feature.
+
+## Paths
+
+- Backend allowed paths:
+  - `services/sample-api/**`
+- Frontend allowed paths:
+  - `apps/web/src/sample-api/**`
+- Contract path: `docs/contracts/F-2099-903/api.md`
+
+## Artifacts
+
+- `CONTRACT-001` produces `api-contract`
+- `BE-IMPL-001` / `FE-IMPL-001` consume `api-contract` (only formal consumers)

package/docs/templates/product-line/scaffold-samples/fe-with-api/feature.yaml

@@ -0,0 +1,3 @@
+schema_version: 1
+feature_id: F-2099-903
+profile: generic

package/docs/templates/product-line/scaffold-samples/fe-with-api/requirement.md

@@ -0,0 +1,6 @@
+# Scaffold sample — fe-with-api
+
+Generated snapshot for docs/templates/product-line/scaffold-samples. Not a live dogfood Feature.
+
+Feature ID: `F-2099-903`
+Template: `fe-with-api`

package/docs/templates/product-line/scaffold-samples/fe-with-api/tasks/BE-IMPL-001.yaml

@@ -0,0 +1,84 @@
+schema_version: 1
+id: BE-IMPL-001
+feature_id: F-2099-903
+title: Scaffold sample — fe-with-api — 后端实现
+description: Generated snapshot for
+  docs/templates/product-line/scaffold-samples. Not a live dogfood Feature.
+repo:
+  name: loop-agent
+  path_ref: .
+  default_branch: main
+type: backend-feature
+priority: P2
+risk_level: medium
+depends_on:
+  - CONTRACT-001
+source_docs:
+  requirement: ../requirement.md
+  acceptance: ../acceptance.yaml
+  design: ../design.md
+acceptance_refs:
+  - AC-001
+scope:
+  goals:
+    - 按契约实现后端
+  non_goals:
+    - 不扩展到模板外的 Task 节点（无 BE-TEST/FE-TEST/FINAL-VERIFY）
+  assumptions:
+    - verify.commands 由 scaffold 调用方显式提供
+  open_questions: []
+constraints:
+  allowed_paths:
+    - services/sample-api/**
+    - docs/progress/F-2099-903/be/status.md
+    - docs/progress/F-2099-903/be/**
+  forbidden_paths:
+    - config/prod/**
+    - .env
+    - .env.*
+    - secrets/**
+    - apps/**
+  hard_constraints:
+    - 不读取生产密钥
+    - 不绕过 scaffold 冻结的 depends/produces/consumes
+execution:
+  workflow: agent-dag
+verify:
+  preset: standard
+  mode: serial
+  quota: full
+  commands:
+    - id: verify-1
+      label: npm run typecheck
+      command: npm run typecheck
+      required: true
+      timeout_ms: 300000
+    - id: verify-2
+      label: npm test
+      command: npm test
+      required: true
+      timeout_ms: 300000
+worker:
+  execution_mode: generate-validate-run
+  max_attempts: 1
+  timeout_ms: 7200000
+  require_clean_worktree: true
+  require_human_review: true
+  create_worktree: false
+loop_agent:
+  profile_policy: mapped
+  strict_models: true
+  strict_governance: true
+  max_concurrent: 1
+outputs:
+  required:
+    - dag_json
+    - dag_validate_json
+    - run_record
+    - dag_report_json
+    - shell_verification
+    - closeout_or_failure_handoff
+failure_policy:
+  failed_run_promote: false
+  generate_closeout_draft: true
+  create_followup_task: true

package/docs/templates/product-line/scaffold-samples/fe-with-api/tasks/CONTRACT-001.yaml

@@ -0,0 +1,84 @@
+schema_version: 1
+id: CONTRACT-001
+feature_id: F-2099-903
+title: Scaffold sample — fe-with-api — API 契约
+description: 冻结 docs/contracts/F-2099-903/api.md；正式 consumers 仅为 BE-IMPL-001 与 FE-IMPL-001。
+repo:
+  name: loop-agent
+  path_ref: .
+  default_branch: main
+type: architecture
+priority: P1
+risk_level: low
+depends_on: []
+source_docs:
+  requirement: ../requirement.md
+  acceptance: ../acceptance.yaml
+  design: ../design.md
+acceptance_refs:
+  - AC-001
+scope:
+  goals:
+    - 冻结 API 契约文档
+    - 声明正式 consumers 仅为 BE-IMPL / FE-IMPL
+  non_goals:
+    - 不扩展到模板外的 Task 节点（无 BE-TEST/FE-TEST/FINAL-VERIFY）
+  assumptions:
+    - verify.commands 由 scaffold 调用方显式提供
+  open_questions: []
+constraints:
+  allowed_paths:
+    - docs/contracts/F-2099-903/api.md
+    - docs/progress/F-2099-903/contract/status.md
+    - docs/progress/F-2099-903/contract/**
+  forbidden_paths:
+    - config/prod/**
+    - .env
+    - .env.*
+    - secrets/**
+    - services/**
+    - apps/**
+  hard_constraints:
+    - 不读取生产密钥
+    - 不绕过 scaffold 冻结的 depends/produces/consumes
+execution:
+  workflow: agent-dag
+verify:
+  preset: standard
+  mode: serial
+  quota: full
+  commands:
+    - id: verify-1
+      label: npm run typecheck
+      command: npm run typecheck
+      required: true
+      timeout_ms: 300000
+    - id: verify-2
+      label: npm test
+      command: npm test
+      required: true
+      timeout_ms: 300000
+worker:
+  execution_mode: generate-validate-run
+  max_attempts: 1
+  timeout_ms: 7200000
+  require_clean_worktree: true
+  require_human_review: true
+  create_worktree: false
+loop_agent:
+  profile_policy: mapped
+  strict_models: true
+  strict_governance: true
+  max_concurrent: 1
+outputs:
+  required:
+    - dag_json
+    - dag_validate_json
+    - run_record
+    - dag_report_json
+    - shell_verification
+    - closeout_or_failure_handoff
+failure_policy:
+  failed_run_promote: false
+  generate_closeout_draft: true
+  create_followup_task: true

package/docs/templates/product-line/scaffold-samples/fe-with-api/tasks/FE-IMPL-001.yaml

@@ -0,0 +1,86 @@
+schema_version: 1
+id: FE-IMPL-001
+feature_id: F-2099-903
+title: Scaffold sample — fe-with-api — 前端实现
+description: Generated snapshot for
+  docs/templates/product-line/scaffold-samples. Not a live dogfood Feature.
+repo:
+  name: loop-agent
+  path_ref: .
+  default_branch: main
+type: frontend-feature
+priority: P2
+risk_level: medium
+capabilities:
+  - interactive-ui
+depends_on:
+  - CONTRACT-001
+source_docs:
+  requirement: ../requirement.md
+  acceptance: ../acceptance.yaml
+  design: ../design.md
+acceptance_refs:
+  - AC-001
+scope:
+  goals:
+    - 按契约实现前端
+  non_goals:
+    - 不扩展到模板外的 Task 节点（无 BE-TEST/FE-TEST/FINAL-VERIFY）
+  assumptions:
+    - verify.commands 由 scaffold 调用方显式提供
+  open_questions: []
+constraints:
+  allowed_paths:
+    - apps/web/src/sample-api/**
+    - docs/progress/F-2099-903/fe/status.md
+    - docs/progress/F-2099-903/fe/**
+  forbidden_paths:
+    - config/prod/**
+    - .env
+    - .env.*
+    - secrets/**
+    - services/**
+  hard_constraints:
+    - 不读取生产密钥
+    - 不绕过 scaffold 冻结的 depends/produces/consumes
+execution:
+  workflow: frontend-implementation
+verify:
+  preset: standard
+  mode: serial
+  quota: full
+  commands:
+    - id: verify-1
+      label: npm run typecheck
+      command: npm run typecheck
+      required: true
+      timeout_ms: 300000
+    - id: verify-2
+      label: npm test
+      command: npm test
+      required: true
+      timeout_ms: 300000
+worker:
+  execution_mode: generate-validate-run
+  max_attempts: 1
+  timeout_ms: 7200000
+  require_clean_worktree: true
+  require_human_review: true
+  create_worktree: false
+loop_agent:
+  profile_policy: mapped
+  strict_models: true
+  strict_governance: true
+  max_concurrent: 1
+outputs:
+  required:
+    - dag_json
+    - dag_validate_json
+    - run_record
+    - dag_report_json
+    - shell_verification
+    - closeout_or_failure_handoff
+failure_policy:
+  failed_run_promote: false
+  generate_closeout_draft: true
+  create_followup_task: true

package/docs/templates/product-line/scaffold-samples/fe-with-api/tasks/task-graph.yaml

@@ -0,0 +1,40 @@
+schema_version: 1
+feature_id: F-2099-903
+nodes:
+  - id: CONTRACT-001
+    task: CONTRACT-001.yaml
+    type: architecture
+    depends_on: []
+    produces:
+      - kind: api-contract
+        schemaId: api-contract-v1
+        path: docs/contracts/F-2099-903/api.md
+  - id: BE-IMPL-001
+    task: BE-IMPL-001.yaml
+    type: backend-feature
+    depends_on:
+      - CONTRACT-001
+    consumes:
+      - kind: api-contract
+        schemaId: api-contract-v1
+        producerTaskId: CONTRACT-001
+    produces:
+      - kind: backend-impl
+        schemaId: backend-impl-v1
+        path: services/sample-api
+  - id: FE-IMPL-001
+    task: FE-IMPL-001.yaml
+    type: frontend-feature
+    depends_on:
+      - CONTRACT-001
+    consumes:
+      - kind: api-contract
+        schemaId: api-contract-v1
+        producerTaskId: CONTRACT-001
+    produces:
+      - kind: frontend-impl
+        schemaId: frontend-impl-v1
+        path: apps/web/src/sample-api
+parallel_policy:
+  max_parallel_tasks: 1
+  disallow_same_file_parallel_writes: true

package/docs/templates/product-line/scaffold-samples/frontend-only/acceptance.yaml

@@ -0,0 +1,13 @@
+schema_version: 1
+feature_id: F-2099-902
+acceptance:
+  - id: AC-001
+    title: Scaffold sample — frontend-only
+    priority: must
+    type: behavior
+    given: 需求与路径边界已冻结
+    when: Feature Packet 内实现任务完成
+    then: 验收目标达成且 verify.commands 通过
+    verification:
+      expected_task_refs:
+        - FE-IMPL-001