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

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

@@ -2,7 +2,7 @@
 
 ## Purpose
 
-Use this prompt for a **test retrospective** node: `executor: "pi"`, `role: "closeout"`, `toolProfile: "write"`, `writePolicy: "exclusive"`. The closeout agent reads upstream review reports and pytest execution results, then generates a retrospective report with an objective maturity rating.
+Use this prompt for a **test retrospective** node: `executor: "pi"`, `role: "closeout"`, `toolProfile: "write"`, `writePolicy: "exclusive"`. The closeout agent reads **Backend Test Result v1** (and classification), then generates a retrospective report with an objective maturity rating.
 
 Do **not** create a new executor type. This is a standard `executor: pi` writer node.
 
@@ -11,7 +11,7 @@ Do **not** create a new executor type. This is a standard `executor: pi` writer
 ```json
 {
   "id": "test-retrospect-pi",
-  "depends_on": ["execute-backend-pytest-shell"],
+  "depends_on": ["classify-backend-test-result-pi"],
   "complexity": "MED",
   "executor": "pi",
   "role": "closeout",
@@ -20,7 +20,7 @@ Do **not** create a new executor type. This is a standard `executor: pi` writer
   "writeSet": ["docs/test-reports/**"],
   "allowedPaths": ["docs/test-reports/**"],
   "forbiddenPaths": [".harness/**", "artifacts/**"],
-  "outputContract": "Markdown retrospective report under docs/test-reports/ with coverage summary, review findings, pytest results, and maturity rating (A/B/C/D).",
+  "outputContract": "Markdown retrospective report under docs/test-reports/ with coverage summary, review findings, Result v1 stats, classification, and maturity rating (A/B/C/D).",
   "subtask_prompt_markdown": "./backend-test-dag.retrospect.prompt.md"
 }
 ```
@@ -29,7 +29,9 @@ Do **not** create a new executor type. This is a standard `executor: pi` writer
 
 You are the Backend Test DAG **test retrospective** agent.
 
-Your job is to read upstream outputs (review report + pytest results) and generate a retrospective report with a maturity rating. Write the report under `docs/test-reports/` only. Stay within `writeSet`. Do not write root `artifacts/**`.
+Your job is to read upstream Result v1 + classification (+ review report) and generate a retrospective report with a maturity rating. Write the report under `docs/test-reports/` only. Stay within `writeSet`. Do not write root `artifacts/**`.
+
+This node runs on **both pass and assertion-fail** paths (after parse + classify). Final task success is decided later by `backend-test-outcome-gate-shell` using Result v1 shell facts only — **never** rewrite a failed result as passed in this report.
 
 ### Output Steps (do in order)
 
@@ -38,28 +40,40 @@ Your job is to read upstream outputs (review report + pytest results) and genera
 
 ### Inputs
 
-1. **Review report** — `review-backend-cases-pi` output (VERDICT, findings, coverage assessment).
-2. **Pytest output** — `execute-backend-pytest-shell` stdout/stderr and exit code.
-3. **HTML report** — `reports/backend-test-report.html` (if generated).
+1. **Result v1 (authoritative stats)** — `$HARNESS_DAG_RUN_DIR/contracts/backend-test-result.json`
+   Use `passed` / `failed` / `error` / `skipped` / `outcome` / `failures[]` / `pytestExitCode` only from this artifact.
+2. **Case Manifest v1 (authoritative AC coverage)** — `$HARNESS_DAG_RUN_DIR/contracts/backend-test-case-manifest.json`
+   Use `coverageSummary.acCoverageRatio`, `coveredAcCount`, `explicitAcCount`, case counts only from this artifact.
+3. **Classification** — `classify-backend-test-result-pi` JSON (`category`, `confidence`, `evidence`). Interpretive only; does not override outcome.
+4. **Review report** — `review-backend-cases-pi` output (VERDICT, findings, coverage assessment).
+5. Optional secondary: execute stdout markers / JUnit path (do not re-parse logs for counts when Result v1 exists).
 
 Do NOT re-read source documents. Use upstream outputs only.
 
+### Stats authority
+
+- Pass rate = `passed / (passed + failed + error)` when denominator > 0 (skipped excluded from denominator unless Result documents otherwise) — **Result v1 only**.
+- AC coverage = `coverageSummary.acCoverageRatio` from Case Manifest v1 only (do **not** recompute or invent percentages).
+- Failed case table rows must match `failures[]` from Result v1.
+- If Result v1 `outcome` is not `passed`, the retrospective **must not** claim overall success.
+
 ### Maturity Rating Criteria
 
-| Rating | Coverage | Pass Rate | Review Findings |
-|--------|----------|-----------|-----------------|
-| **A** | 100% acceptance criteria covered | 100% pytest pass | No Critical or Important findings |
-| **B** | ≥80% acceptance criteria covered | ≥90% pytest pass | Only Informational findings |
-| **C** | ≥60% acceptance criteria covered | ≥70% pytest pass | No Critical findings (Important allowed) |
+| Rating | Coverage (manifest) | Pass Rate (Result v1) | Review Findings |
+|--------|---------------------|------------------------|-----------------|
+| **A** | `acCoverageRatio` = 1 | 100% pytest pass | No Critical or Important findings |
+| **B** | `acCoverageRatio` ≥ 0.8 | ≥90% pytest pass | Only Informational findings |
+| **C** | `acCoverageRatio` ≥ 0.6 | ≥70% pytest pass | No Critical findings (Important allowed) |
 | **D** | Below C thresholds | Below C thresholds | Or any Critical finding unresolved |
 
 #### Rating Rules
 
-- **Coverage** = (acceptance criteria with ≥1 covering test case) / (total acceptance criteria) × 100%
-- **Pass rate** = (passed pytest functions) / (total non-skipped pytest functions) × 100%
+- **Coverage** from Case Manifest `coverageSummary` only (deterministic gate product).
+- **Pass rate** from Result v1 only (not guessed from logs).
 - If `review-backend-cases-pi` returned `VERDICT: request-revision` and revision was not completed, cap at **D**.
-- If pytest exit code is non-zero and >30% tests failed, cap at **D** regardless of coverage.
-- Skipped tests (`@pytest.mark.skip`) count as "not covered" for pass rate but not as failures.
+- If Result v1 shows >30% failed+error among executed tests, cap at **D** regardless of coverage.
+- Skipped tests count as "not covered" for pass rate but not as failures.
+- Collection/command/report errors → cap at **D** and record classification (not ProductBug by default).
 
 ### Report Structure
 
@@ -71,6 +85,8 @@ Write the report as a Markdown file named `backend-test-retrospect-<date>.md` un
 **Date:** <YYYY-MM-DD>
 **Task:** <task-id>
 **Maturity Rating:** <A|B|C|D>
+**Result outcome:** <from Result v1>
+**Classification:** <from classify JSON>
 
 ## 1. Test Coverage Summary
 
@@ -79,43 +95,41 @@ Write the report as a Markdown file named `backend-test-retrospect-<date>.md` un
 | Total acceptance criteria | N |
 | Covered by test cases | N (X%) |
 | Total functional test cases | N |
-| Positive path cases | N |
-| Negative path cases | N |
-| Boundary cases | N |
 
-## 2. Automation Results
+## 2. Automation Results (from Result v1)
 
 | Metric | Value |
 |--------|-------|
-| Total pytest functions | N |
+| Total tests | N |
 | Passed | N |
 | Failed | N |
+| Error | N |
 | Skipped | N |
 | Pass rate | X% |
 | Pytest exit code | N |
+| Outcome | … |
+| Execution status | … |
 
 ### Failed Test Analysis
 
-| Test Case ID | Function | Failure Reason | Root Cause |
-|--------------|----------|----------------|------------|
-| ... | ... | ... | ... |
+| Test Case / Function | Message (truncated) | Classification |
+|----------------------|-------------------|----------------|
+| ... | ... | ... |
 
 ## 3. Review Findings
 
 | Severity | Finding | Status |
 |----------|---------|--------|
-| Critical | ... | Resolved / Unresolved |
-| Important | ... | Resolved / Unresolved |
-| Informational | ... | Resolved / Unresolved |
+| … | … | … |
 
 ## 4. Maturity Rating Rationale
 
-Explain which threshold was met or missed, and why the specific rating was assigned.
+Explain which threshold was met or missed.
 
 ## 5. Recommendations
 
-- Actionable items for improving the rating in the next iteration.
-- Specific gaps to close (uncovered criteria, flaky tests, missing negative paths).
+- Actionable items for the next iteration.
+- Do not propose changing production code solely to greenwash tests.
 ```
 
 ### Output Shape (after rating line)

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

@@ -11,7 +11,7 @@ Do **not** create `executor: reviewer`. Reviewer is a **role** on `executor: pi`
 ```json
 {
   "id": "review-backend-cases-pi",
-  "depends_on": ["generate-backend-functional-cases-pi"],
+  "depends_on": ["backend-test-case-manifest-shell", "backend-test-analysis-contract-shell"],
   "complexity": "HIGH",
   "executor": "pi",
   "role": "reviewer",
@@ -40,10 +40,11 @@ No preamble, heading, or blank lines before the verdict line.
 
 ### Inputs to Review
 
-1. **Acceptance criteria** — from upstream `analyze-inputs-pi` output (AC-001, AC-002, ...).
-2. **Generated test cases** — files under `testcase/md/`.
+1. **Acceptance criteria / analysis** — from the validated Backend Test Analysis v1 artifact materialized by `backend-test-analysis-contract-shell` (`contracts/backend-test-analysis.json` under the current DAG run). Do not treat free-form Markdown from `analyze-inputs-pi` as the contract.
+2. **Case Manifest v1** — `contracts/backend-test-case-manifest.json` (schemaId `backend-test-case-manifest-v1`). Prefer `coverageSummary` and caseId↔acIds from this artifact; do not invent coverage percentages.
+3. **Generated test cases** — files under `testcase/md/`.
 
-Do NOT re-read source documents. Use upstream outputs only.
+Do NOT re-read source documents. Use the validated analysis artifact, case manifest, and generated cases only.
 
 ### Review Checklist
 
@@ -54,15 +55,16 @@ Do NOT re-read source documents. Use upstream outputs only.
 | **Negative path coverage** | Error/exception scenarios (invalid input, not found, state violations) | Important |
 | **Boundary conditions** | Edge cases (empty input, max length, edge values) | Important |
 | **State transitions** | Illegal state changes covered | Important |
-| **Requirement traceability** | Each acceptance criterion (AC-xxx) maps to at least one test case ID | Critical |
+| **Requirement traceability** | Each acceptance criterion (AC-xxx) maps to at least one test case ID (manifest coverageSummary or evidenceGaps) | Critical |
+| **Manifest consistency** | Markdown cases align with Case Manifest v1 caseId/acIds | Critical |
 | **Case structure** | Each case has: ID, Title, Precondition, Steps, Expected Result | Important |
 | **No duplicate IDs** | All test case IDs are unique across files | Critical |
 
 ### Conditional Coverage (check ONLY if mentioned in upstream analysis)
 
-- **Authentication coverage**: check ONLY if `analyze-inputs-pi` mentions auth mechanism (JWT, OAuth2, API Key, etc.)
-- **Timeout coverage**: check ONLY if `analyze-inputs-pi` mentions timeout handling or degradation strategy
-- If not mentioned in upstream analysis, do NOT flag as missing
+- **Authentication coverage**: check ONLY if the validated analysis artifact mentions auth mechanism (JWT, OAuth2, API Key, etc.)
+- **Timeout coverage**: check ONLY if the validated analysis artifact mentions timeout handling or degradation strategy
+- If not mentioned in the validated analysis artifact, do NOT flag as missing
 
 ### Verdict Rules
 

package/docs/templates/backend-test-execution.schema.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://tea-agent.dev/schemas/backend-test-execution-v1.json",
+  "title": "Backend Test Execution v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "framework",
+    "runner",
+    "testRoot",
+    "workingDirectory",
+    "report",
+    "targetMode",
+    "existingFixtures",
+    "authenticationMode",
+    "requiredEnvNames",
+    "dataIsolation",
+    "evidenceGaps",
+    "evidenceRefs"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "framework": { "const": "pytest" },
+    "runner": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "commandParts": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "frozenCommandHints": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "testRoot": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Repo-relative posix path; no absolute form or .. segments"
+    },
+    "workingDirectory": {
+      "type": "string",
+      "minLength": 1,
+      "default": "."
+    },
+    "report": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["format", "relativeHint"],
+      "properties": {
+        "format": { "const": "junit" },
+        "relativeHint": { "type": "string", "minLength": 1 }
+      }
+    },
+    "targetMode": {
+      "enum": ["in-process", "external-running-service", "managed-command"]
+    },
+    "baseUrlEnvName": {
+      "type": "string",
+      "pattern": "^[A-Z_][A-Z0-9_]*$"
+    },
+    "readiness": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "description"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "description": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "existingFixtures": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "sourcePath", "kind"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "sourcePath": { "type": "string", "minLength": 1 },
+          "kind": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "authenticationMode": { "type": "string", "minLength": 1 },
+    "requiredEnvNames": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[A-Z_][A-Z0-9_]*$"
+      }
+    },
+    "dataIsolation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode"],
+      "properties": {
+        "mode": { "type": "string", "minLength": 1 },
+        "evidence": { "type": "string", "minLength": 1 }
+      }
+    },
+    "managedCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "start": { "type": "string", "minLength": 1 },
+        "stop": { "type": "string", "minLength": 1 },
+        "sourceRef": { "type": "string", "minLength": 1 }
+      }
+    },
+    "evidenceGaps": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["description"],
+        "properties": {
+          "description": { "type": "string", "minLength": 1 },
+          "sourceRef": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "evidenceRefs": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/docs/templates/backend-test-result.schema.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://tea-agent.dev/schemas/backend-test-result-v1.json",
+  "title": "Backend Test Result v1",
+  "description": "Run-owned pytest result artifact. Task Pool may consume outcome, counts, failures[], executionStatus, collectionStatus, pytestExitCode, and junit refs. Auto follow-up is out of scope for M2.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "executionStatus",
+    "pytestExitCode",
+    "collectionStatus",
+    "tests",
+    "passed",
+    "failed",
+    "error",
+    "skipped",
+    "junit",
+    "commandSummary",
+    "failures",
+    "outcome"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "executionStatus": {
+      "type": "string",
+      "enum": ["completed", "collection-error", "command-error", "report-error"],
+      "description": "Process-level status. Task Pool: do not treat collection-error/command-error as ProductBug."
+    },
+    "pytestExitCode": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 255,
+      "description": "Raw pytest process exit code (0/1 are node-success when JUnit exists)."
+    },
+    "collectionStatus": {
+      "type": "string",
+      "enum": ["ok", "error", "unknown", "skipped"]
+    },
+    "tests": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Task Pool: total tests = passed+failed+error+skipped"
+    },
+    "passed": { "type": "integer", "minimum": 0 },
+    "failed": { "type": "integer", "minimum": 0 },
+    "error": { "type": "integer", "minimum": 0 },
+    "skipped": { "type": "integer", "minimum": 0 },
+    "durationMs": { "type": "number", "minimum": 0 },
+    "junit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["relativePath", "sha256"],
+      "properties": {
+        "relativePath": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*(?:^|/)\\.(?:/|$))(?!.*\\\\)(?!.*//).+$",
+          "description": "Run-dir relative POSIX path without absolute form, backslashes, dot segments, or parent traversal (e.g. reports/backend-test-junit.xml)"
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        }
+      }
+    },
+    "commandSummary": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Non-secret command summary only"
+    },
+    "failures": {
+      "type": "array",
+      "description": "Truncated failure/error summaries for triage (Task Pool consumable).",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["classname", "name", "message"],
+        "properties": {
+          "classname": { "type": "string", "minLength": 1 },
+          "name": { "type": "string", "minLength": 1 },
+          "message": { "type": "string", "minLength": 1 },
+          "kind": { "type": "string", "enum": ["failure", "error"], "default": "failure" }
+        }
+      }
+    },
+    "outcome": {
+      "type": "string",
+      "enum": [
+        "passed",
+        "completed-with-failures",
+        "collection-error",
+        "command-error",
+        "report-error"
+      ],
+      "description": "Authoritative shell-facing outcome for backend-test-outcome-gate-shell. Retrospective must not override."
+    }
+  }
+}

package/docs/templates/branch-merge-report.md

@@ -0,0 +1,93 @@
+# Branch Merge Report — `<source-ref>` into `<target-branch>` at `<source-short-sha>`
+
+Date: `<YYYY-MM-DD>`
+Target branch: `<target-branch>`
+Target before merge: `<full SHA>`
+Source: `<source-ref>@<full SHA>`
+Merge base: `<full SHA>`
+Merge commit: `<full SHA or follow-up commit reference>`
+
+## Naming Convention
+
+Use `YYYY-MM-DD-origin-<source>-into-<target>-<source-short-sha>.md` under `docs/reports/`. Replace `/` and other path separators in branch names with `-`. The source short SHA distinguishes repeated merges on the same day.
+
+## Pre-merge Inspection
+
+- Divergence: `<target-only count>` target-only commits / `<source-only count>` source-only commits.
+- Dry run: `git merge-tree --write-tree --messages <target> <source>`.
+- Predicted conflicts: `<count and files>`.
+- Baseline verification: `<commands and results>`.
+
+## Incoming Capabilities
+
+| Capability | Key files / contracts | Expected user or runtime result | Verification |
+| --- | --- | --- | --- |
+| `<incoming capability>` | `<paths>` | `<behavior>` | `<test/smoke>` |
+
+## Target-branch Capabilities to Preserve
+
+| Capability | Key files / contracts | Preservation risk | Verification |
+| --- | --- | --- | --- |
+| `<target capability>` | `<paths>` | `<possible overwrite>` | `<test/smoke>` |
+
+## Conflict Resolution
+
+| File | Conflict type | Incoming concern | Target concern | Resolution | Evidence |
+| --- | --- | --- | --- | --- | --- |
+| `<path>` | `content/rename-delete/add-add` | `<incoming behavior>` | `<target behavior>` | `<combined decision>` | `<test/diff>` |
+
+If there were no textual conflicts, write `No textual conflicts` and continue with the automatic-merge review below.
+
+## Automatic-merge Semantic Review
+
+Record overlapping or high-risk files that Git merged without conflict. These are common places for silent feature loss.
+
+| File / area | Why high risk | Incoming behavior retained | Target behavior retained | Evidence |
+| --- | --- | --- | --- | --- |
+| `<path>` | `<shared imports/topology/config>` | `<incoming proof>` | `<target proof>` | `<tests/search>` |
+
+## Functional Impact Matrix
+
+| Feature | Before merge | After merge | Deleted or weakened? | Notes |
+| --- | --- | --- | --- | --- |
+| `<feature>` | `<baseline>` | `<result>` | `No/Yes` | `<details>` |
+
+## Init and Update Impact
+
+- Changed init/package surface: `<paths or none>`.
+- Fresh full init result: `<result>`.
+- `init check-update` result: `<result>`.
+- `init update --apply-safe` recovery result: `<result>`.
+- Manifest or init implementation updates made: `<details or none>`.
+
+## Package Surface Impact
+
+- `npm pack --dry-run --ignore-scripts --json`: `<file count>` files.
+- Added package paths: `<paths>`.
+- Removed package paths: `<paths or none>`.
+- Unexpected files or missing required files: `<details or none>`.
+
+## Verification
+
+| Command | Result | Capability covered |
+| --- | --- | --- |
+| `npm run typecheck` | `<pass/fail>` | TypeScript integration |
+| `npm test` | `<pass/fail>` | Full regression |
+| `npm run build` | `<pass/fail>` | Build/package inputs |
+| `bash scripts/check-repo.sh` | `<pass/fail>` | Governance and init surface |
+| `npm run docs:build` | `<pass/fail>` | User documentation |
+| `npm pack --dry-run --ignore-scripts --json` | `<pass/fail>` | Published files |
+
+Add focused tests and real init/update/browser/CLI smokes required by the merged capabilities.
+
+## Residual Risk
+
+- `<unverified external environment, performance, migration, or compatibility risk>`
+
+## Rollback and Investigation Pointers
+
+- Merge commit: `<SHA>`.
+- Conflict files: `<paths>`.
+- First tests to run if a feature appears missing: `<commands>`.
+- Safe rollback strategy: prefer `git revert -m 1 <merge-commit>` after review; do not use destructive reset on shared work.
+

package/docs/templates/frontend-design-contract.md

@@ -20,6 +20,15 @@ TODO
 
 TODO
 
+## Mock / API 策略
+
+- 接口文档或 schema：TODO
+- 策略：`native | browser-intercept | request-adapter | not-needed | blocked`
+- endpoint / fixture / UI 状态映射：TODO
+- 显式启用方式与 production 默认关闭边界：TODO
+- DAG 已固化的验证入口：TODO
+- Real Integration Gap 与后端就绪后的复验：TODO
+
 ## 样式与设计系统映射
 
 TODO

package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md

@@ -0,0 +1,17 @@
+# Failure fixture: type / build error
+
+- **fixtureId**: `fe-fail-type-build-error`
+- **triggerSignal**: `frontend-static-verify-shell` 非零（tsc 或 build 失败）
+- **expectedGateBehavior**: static 失败阻断 behavior/review 成功路径；不得 closeout pass
+- **repairable (M3 预标注)**: `repairable`（局部类型/导入修复）
+- **Browser**: 不得宣称 Browser 证据
+
+## 场景
+
+Writer 引入错误 prop 类型或缺失导出，导致 typecheck/build 失败。
+
+## 期望
+
+- 新鲜 stdout/stderr 归档
+- review 不得在 static 失败时 VERDICT: pass
+- M3：可进入 bounded repair；M0 仅记录

package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md

@@ -0,0 +1,16 @@
+# Failure fixture: unit/component test fail
+
+- **fixtureId**: `fe-fail-unit-component-test`
+- **triggerSignal**: `frontend-behavior-verify-shell` 非零（vitest 断言失败）
+- **expectedGateBehavior**: behavior 失败 → review 不得 pass；closeout 阻断
+- **repairable (M3 预标注)**: `repairable`
+- **Browser**: not-run；不得用「应在浏览器正常」抵消
+
+## 场景
+
+组件测试期望文案/状态与实现不一致。
+
+## 期望
+
+- 失败命令为生成期冻结入口
+- 禁止删测 / `.skip` 伪装通过（review 应标 Important）

package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md

@@ -0,0 +1,16 @@
+# Failure fixture: fixture schema drift vs API contract
+
+- **fixtureId**: `fe-fail-fixture-schema-drift`
+- **triggerSignal**: Mock fixture 字段与接口文档冲突；design gate 或 review 发现；或 mock 专项测试失败
+- **expectedGateBehavior**: design request-revision 或 review request-revision；不得发明字段硬通过
+- **repairable (M3 预标注)**: `non-repairable` 若根因是 spec 冲突未裁决；局部拼写且 contract 已明确时可为 repairable
+- **Browser**: not-run
+
+## 场景
+
+Handler 返回 `userName` 而契约为 `name`。
+
+## 期望
+
+- Mock assess / design 要求 contract-aligned
+- closeout 不得宣称真实联调成功

package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md

@@ -0,0 +1,16 @@
+# Failure fixture: missing loading/empty/error state
+
+- **fixtureId**: `fe-fail-missing-ui-states`
+- **triggerSignal**: plan/design 或 review 发现 applicable 异步列表缺少 loading/empty/error
+- **expectedGateBehavior**: first/final design 应 request-revision；若漏到实现则 review request-revision
+- **repairable (M3 预标注)**: `repairable`（补状态 UI + 测试）
+- **Browser**: not-run
+
+## 场景
+
+仅实现 success 列表渲染。
+
+## 期望
+
+- design checklist 含 UI States
+- M1 合同将强制 applicable states 映射

package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md

@@ -0,0 +1,16 @@
+# Failure fixture: forbidden write / writeSet expansion attempt
+
+- **fixtureId**: `fe-fail-forbidden-write`
+- **triggerSignal**: writer 试图修改 writeSet 外路径或 forbiddenPaths（如 `src/**` 任务写入 `package.json`）
+- **expectedGateBehavior**: write-guard 拒绝；run 失败或 NeedsAction；不得当成功 closeout
+- **repairable (M3 预标注)**: `non-repairable`（路径/authority；不得靠 repair 扩大 writeSet）
+- **Browser**: not-run
+
+## 场景
+
+实现中「顺手」改根配置或越界文档。
+
+## 期望
+
+- exclusive writeSet 强制
+- M0 eval 计入 `forbidden_write_count`

package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md

@@ -0,0 +1,16 @@
+# Failure fixture: unapproved dependency add
+
+- **fixtureId**: `fe-fail-unapproved-dependency`
+- **triggerSignal**: diff 出现未授权 `package.json` / lockfile 依赖新增
+- **expectedGateBehavior**: design 应预先拒绝；若发生则 review Important + request-revision；任务 forbidden 含 package 时 write-guard 阻断
+- **repairable (M3 预标注)**: `non-repairable`（依赖策略/人工批准）
+- **Browser**: not-run
+
+## 场景
+
+为方便引入大型 UI 库未在计划 Dependency Policy 批准。
+
+## 期望
+
+- 计入 `unapproved_dependency_count`
+- 不得以 build 通过单独放行