@tea-agent/loop-agent 0.24.11-beta.0 → 0.25.1

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

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

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

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

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

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

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

package/docs/templates/product-line/scaffold-samples/frontend-only/tasks/FE-IMPL-001.yaml

@@ -0,0 +1,85 @@
+schema_version: 1
+id: FE-IMPL-001
+feature_id: F-2099-902
+title: Scaffold sample — frontend-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: frontend-feature
+priority: P2
+risk_level: medium
+capabilities:
+  - interactive-ui
+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:
+    - apps/web/src/sample-frontend/**
+    - docs/progress/F-2099-902/fe/status.md
+    - docs/progress/F-2099-902/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/frontend-only/tasks/task-graph.yaml

@@ -0,0 +1,14 @@
+schema_version: 1
+feature_id: F-2099-902
+nodes:
+  - id: FE-IMPL-001
+    task: FE-IMPL-001.yaml
+    type: frontend-feature
+    depends_on: []
+    produces:
+      - kind: frontend-impl
+        schemaId: frontend-impl-v1
+        path: apps/web/src/sample-frontend
+parallel_policy:
+  max_parallel_tasks: 1
+  disallow_same_file_parallel_writes: true