@tea-agent/loop-agent 0.39.0-beta.1 → 0.39.0-beta.11

package/skills/frontend-bounded-implement/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: frontend-bounded-implement
 description: >-
-  Use only for frontend implementation and repair writers after the canonical
+  Use only for frontend implementation writers after the canonical
   contract gate has authorized a bounded write set.
 ---
 
@@ -11,7 +11,6 @@ description: >-
 
 - For implementation, use the run-owned
   `contracts/frontend-implementation-contract.json`.
-- For repair, also use `contracts/frontend-repair-assessment.json`.
 - Treat requirement `expectedOutcome`, interaction `trigger` /
   `expectedBehavior`, target files, UI states, Mock/API strategy, and verification
   targets as closed decisions. Do not rediscover or reinterpret them.
@@ -25,7 +24,7 @@ description: >-
 - Start the bounded edit after confirming the contract and targets. Optional
   context is not a reason to postpone implementation.
 - If behavior is still ambiguous or a required target is outside `writeSet`, stop
-  with `IMPLEMENTATION_OUTCOME: blocked`; do not compensate with broader scouting.
+  without writing and explain the blocker; do not compensate with broader scouting.
 
 ## Implementation Discipline
 
@@ -39,15 +38,10 @@ description: >-
 - Run only the focused checks already frozen by the task. Leave full verification
   to downstream deterministic nodes.
 
-## Required Outcome
+## Completion Summary
 
-The first non-empty response line must be exactly one of:
-
-- `IMPLEMENTATION_OUTCOME: changed` — a non-empty bounded diff was produced.
-- `IMPLEMENTATION_OUTCOME: already-satisfied` — the contract was already met and
-  no file changed.
-- `IMPLEMENTATION_OUTCOME: blocked` — implementation cannot proceed without
-  guessing or exceeding the write boundary.
-
-Then report changed files, requirements/interactions implemented, tests or focused
-checks attempted, and residual risks. Never report `changed` for an empty diff.
+Briefly report changed files, implemented requirements/interactions, focused checks
+attempted, blockers, and residual risks. This summary is human-readable only: the
+runtime derives implementation state from persisted write events, run delta, write
+guard, requirement coverage, and focused checks. Do not use a mandatory
+`IMPLEMENTATION_OUTCOME:` response-text protocol.

package/skills/frontend-design-review/SKILL.md

@@ -9,31 +9,24 @@ references:
 
 # Frontend Design Review
 
-For frontend design review nodes. Read the checklist; audit contract, scout, Mock
-strategy, effective plan, task bounds, and traceable design evidence.
-Knowledge base, OpenSpec, and `ai_workspace/` are parallel sources. Query the
-knowledge-base connector when available; always search/read `openspec/schemas/**`,
-`openspec/project-specs/**`, and `ai_workspace/**` before accepting conventions.
-Connector format is TODO: never invent results.
+For frontend design review nodes. Read the checklist; audit the canonical contract,
+bound Mock strategy, task bounds, and traceable design evidence supplied by the
+upstream context. Do not rediscover task sources, search specification roots, or
+replace frozen evidence with nearby-code conventions. Use only exact, bound evidence
+paths when additional reading is necessary; never invent connector results.
 
-## Verdict Contract
+## Authoritative Terminal
 
-First non-empty line: exactly `VERDICT: pass` or `VERDICT: request-revision`.
-Any blocker requires request-revision. An initial pass is the effective verdict;
-there is no intermediate first-design shell gate.
+Complete the review with exactly one committed typed tool call:
 
-In standard/full topology, revision and final review run only after initial
-`VERDICT: request-revision`. Verify every Required Plan Correction against the
-complete revision; reject remaining, incomplete, or new gaps. An initial pass uses
-the original plan and skips both conditional nodes.
+- `approve_design` when no blocking design defect remains;
+- `request_design_changes` when a blocker exists. It must include a typed
+  `issueCategory`, at least one `evidenceRef`, and non-empty findings.
 
-Small-risk topology instead removes initial review and revision, then runs
-`frontend-final-design-review-pi` as the sole review of the original plan. Do not
-expect initial findings or a revision there.
-
-The deterministic gate prefers final-review output and falls back to initial review
-only when no current-run final output exists. Existing malformed/non-pass primary
-output fails closed.
+The typed terminal is the only authoritative outcome. Do not require or emit a
+`VERDICT:` line, JSON verdict, revision patch, or a second final-design-review
+verdict. A requested design change ends this run; the recovery controller creates
+any bounded follow-up run from the appropriate phase.
 
 ## Blocking Conditions
 
@@ -51,29 +44,15 @@ Knowledge-base absence is advisory if relevant rules from either openspec
 specification directory were read and applied. Block skipped fallback, unresolved
 conflict, or unresolved UI decisions.
 
-## Method And Output
+## Method And Human-readable Output
 
 Map criteria to steps/files/states/checks, audit paths/evidence, classify Blocking
 or Advisory, and never edit files.
 
 ### Spec Evidence Rules
 
-Run `grep`/`find`, then explicit `read` calls for applicable specs/checklist. Only
-successful paired reads count as “已读取规范文件”; summaries do not. List each path/
-section in `Checked Items`; search/read both openspec specification directories
-before accepting conventions.
-
-```markdown
-VERDICT: pass
-
-## Findings
-- None blocking.
-
-## Required Plan Corrections
-- None.
-
-## Checked Items
-- ...
-```
-
-Each correction names its criterion/section, gap, and exact plan change.
+Read only the canonical contract and any exact evidence paths bound in its upstream
+context. Successful paired reads are the only proof that a specification was read;
+summaries do not substitute for them. A concise human-readable summary may list
+checked items and findings, but it is never a control protocol. Each requested
+change names its criterion/section, gap, and required plan change.

package/skills/frontend-implementation/SKILL.md

@@ -5,12 +5,11 @@ description: >-
 references:
   - path: references/node-contracts.md
     required: true
-    # Compact contract index must stay under skill total budget (~10k with body + other refs).
-    # Headroom above current ~4k file; do not raise alone without checking totalMaxChars.
-    maxChars: 6000
+    # Keep the required node contract intact under the bounded-skill test budget.
+    maxChars: 9000
   - path: references/design-spec.md
     required: true
-    maxChars: 3000
+    maxChars: 3500
   - path: references/code-standards.md
     required: true
     maxChars: 3000

package/skills/frontend-implementation/references/design-spec.md

@@ -6,9 +6,10 @@ Knowledge base, OpenSpec, and `ai_workspace/` are parallel specification sources
 
 1. Attempt the configured component/design knowledge-base query first when a
    connector is available.
-2. Regardless of knowledge-base success/failure/timeout/no-match, also
-   recursively search `openspec/schemas/`, `openspec/project-specs/`, and
-   `ai_workspace/` for index files and relevant content.
+2. Regardless of knowledge-base success/failure/timeout/no-match, use the
+   generation-frozen local-spec capability context and cited candidate set. For
+   unresolved task terms, search the three local roots in a bounded way; do not
+   recursively read every supported file merely because it exists.
 3. Treat relevant matches from both sources as the current project's
    specification for this run.
 4. Only then use component source, tokens, stories, tests, and pages as
@@ -23,10 +24,13 @@ Connector format is TODO; attempt only an available connector, otherwise record
 
 ## openspec Fallback Procedure
 
-- Inspect `<repoRoot>/openspec/schemas/`, `<repoRoot>/openspec/project-specs/`,
-  and `<repoRoot>/ai_workspace/` when present; enumerate supported files recursively.
-- Read indexes first, then search names/content using task, route, component,
-  interaction, theme, token, and state terms.
+- Start with the generation-frozen classified paths and `frontendOpenspec`
+  candidates. Read their indexes or relevant sections first, then use task,
+  route, component, interaction, theme, token, and state terms for bounded
+  local searches under `<repoRoot>/openspec/schemas/`,
+  `<repoRoot>/openspec/project-specs/`, and `<repoRoot>/ai_workspace/`.
+- Do not turn local fallback into a full-directory read. If a searched path is
+  relevant, record why it was selected and read it in context.
 - Read matches in context; a filename-only hit is not a rule.
 - Record search terms, inspected/matched paths, headings or tight line ranges,
   applied rules, and conflicts.
@@ -51,6 +55,7 @@ and conflicts. `openspec fallback` includes terms, paths/headings/lines, rules,
 - Cite knowledge-base or openspec spec evidence for component/token choices;
   label weaker repo fallback.
 - Make deviations and unresolved gaps explicit.
-- Contract `uiComponentChoices[]` per UI purpose: `specified` needs
-  `specReference {path,section,line}`; `new` needs null ref + rationale; never
-  silently replace a spec-defined component.
+- Contract `uiComponentChoices[]` per UI purpose: `specified` needs an OpenSpec
+  `specReference {path,section,line}`; a task-source-mandated `new` component
+  needs a PRD `specReference {path,section,line}` plus rationale; never silently
+  replace a spec-defined component.

package/skills/frontend-implementation/references/node-contracts.md

@@ -5,27 +5,37 @@ Pre-write nodes are read-only. Preserve IDs, labels, commands, language, require
 ## Core nodes
 
 - **`frontend-contract-pi`**: `Scope`, `Non-goals`, `Acceptance Criteria`, `UI States`, `Target Runtime Environment`, `Risks`, `Verification Expectations`; no guessed requirements.
-- **`frontend-scout-pi`**: routes, components, tokens, data/API/Mock, scripts, tests, assets; fact vs inference vs gap. Search+read `openspec/schemas/`, `openspec/project-specs/`, `ai_workspace/` first. Output stack, styling, conventions, state/data, test entry points, reuse, risks.
-- **`frontend-plan-pi` + conditional design loop**: AC → observable `expectedOutcome`; interactions → `trigger`+`expectedBehavior`; include steps, in-bound files, UI states, reuse, deps, Mock/API, frozen verify entrypoints and integration gaps. DAG freezes a protected skeleton (`schemaVersion`, `sourceBinding`, `riskLevel`, `targets.files`, `mockApi.productionDefaultOff`). Model returns a **JSON-only** editable RFC 7386 patch (`frontend-implementation-contract-plan-patch-v1`) plus one `openspec-citations` block. Runtime compiles canonical `frontend-implementation-contract-v1` and archives raw/extracted/normalized/validation candidates; unresolved optional symbols are dropped and audited. No plan prose; gate renders plan.md. IDs+paths ≠ behavior semantics. Applicable UI states need behavior/implementation/verification; non-applicable states need reasons. Active Mock needs frozen commands; `auto` without confirmed capability/command → `not-needed`; `required` without command → generation-time blocked. Only `request-revision` runs revision+final review; small-risk gets one review.
-  - `uiComponentChoices[]` (optional): `{purpose, component, decision, specReference, rationale}`; `specified` needs `specReference{path,section,line}`; `new` needs null ref+rationale.
-- **`frontend-prewrite-gate-shell`**: sole write authorization. Resolve effective plan (revised if revision ran, else original) + review; require exact pass; retain every REQ/BR/AC id; enforce Mock policy; validate schema/source binding+writeSet containment; materialize `contracts/frontend-implementation-contract.json` from the **single** fenced contract block (multiple candidates fail closed `invalid-output`). Fallback only when conditional primary absent; malformed primary fails closed. Generation-time blocked Mock yields one blocking shell node, no writer.
+- **`frontend-contract-pi`**（仅 cited 且候选非空）：在既有 Markdown contract 的末尾输出一个 `frontend-openspec-selection-v1` JSON block，对 generation-frozen specRoots 候选逐一分类为 `required` / `relevant` / `irrelevant`；显式 `requiredReadPaths` 和任务源文件引用必须为 `required`。只读，不改 task.json，不新增节点。
+- **`frontend-scout-pi`**: routes, components, tokens, data/API/Mock, scripts, tests, assets; fact vs inference vs gap. Start from the generation-frozen OpenSpec capability context and contract selection block; then perform bounded task-term searches only for unresolved relevant rules. Do not recursively read every candidate directory. Output stack, styling, conventions, state/data, test entry points, reuse, risks.
+- **`frontend-plan-pi`**: AC → observable `expectedOutcome`; interactions → `trigger`+`expectedBehavior`; include steps, in-bound files, UI states, reuse, deps, Mock/API, frozen verify entrypoints and integration gaps. DAG freezes a protected skeleton (`schemaVersion`, `sourceBinding`, `riskLevel`, `targets.files`, `mockApi.productionDefaultOff`). The model commits the plan decision ledger incrementally through typed `record_*` tools (target-surface / component-choice / state-flow / data-flow / mock-api / design-deviation / dependency) and closes with exactly one `finalize_plan`; narrative prose stays free-form context and is never the compile authority. `frontend-design-policy-shell` assembles the canonical contract from committed facts (validated, fail-closed — no fenced-JSON text parsing) and materializes `frontend-implementation-contract-v1`; unresolved optional symbols are dropped and audited. `frontend-design-policy-shell` deterministically renders plan.md. IDs+paths ≠ behavior semantics. Applicable UI states need behavior/implementation/verification; non-applicable states need reasons. Active Mock needs frozen commands; `auto` without confirmed capability/command → `not-needed`; `required` without command → generation-time blocked.
+  - `uiComponentChoices[]` (optional): `{purpose, component, decision, specReference, rationale}`; `specified` needs an OpenSpec `specReference{path,section,line}`; a task-source-mandated `new` component needs a PRD `specReference{path,section,line}` plus rationale; `reuse-existing` may omit the ref.
+- **`frontend-design-policy-shell`**: read-only deterministic design check (UI coverage, evidence resolvable/fresh, Mock strategy bound to frozen commands, component choice `specReference`, targetPaths boundary, dependency authorization, UI state ownership, requirement coverage); passes by materializing the single authoritative `frontend-implementation-contract-v1`. Blocked ends the run without a model reformat step.
   - `verificationTarget.commandLabel` must be a **frozen command label** from `verifyEvidence.commandLabels`; others fail closed (`invalid-output`). Empty frozen set (no `run.json`) skips check.
   - `mockApi.strategy !== "not-needed"` fails closed when `mockCommandLabels` empty (`no authorized Mock verification commands`).
-  - OpenSpec policy: `task.json.frontendOpenspec.policy` (default `cited`); candidates = `requiredReadPaths` ∪ task-source citations; effective plan must append one fenced `openspec-citations` block (one JSON `{"path","section","line"}` per line). Candidates non-empty but block missing/unparseable → `openspec-citation-block-unparseable`; candidate not cited → `openspec-not-cited`; cited path without read event → `openspec-citation-not-read` (anti-fabrication). Empty candidates skip enforcement. `scan-strict` keeps full-read semantics (`openspec-not-read`); both modes keep `candidate-missing-drift`.
-  - Component conformance: missing `uiComponentChoices` (frozen bucket non-empty + UI-visible work) → `component-choices-missing`; bad/uncited `specReference.path` → `component-spec-reference-invalid` / `component-spec-not-cited`.
-  - revisionPatch mode: revision output is an RFC 7386 merge-patch delta applied on the original canonical contract node (`planFallbackFromNodeIds[0]`); protected skeleton paths remain immutable. Legacy DAGs keep full-contract semantics. Size guard: canonical serialization >64KB → `retryable-invalid` + `contract-too-large`.
-- **`frontend-implement-pi`**: sole regular exclusive writer; uses `frontend-bounded-implement` (not this skill). Stay in `writeSet`; real requests default-on. Atomic handler/intercept/adapter with tests. Stop on forbidden paths/guesses. First line `IMPLEMENTATION_OUTCOME: changed|already-satisfied|blocked`; runtime checks against attributed diff. Optional mock-verify when frozen; static+behavior always; behavior must prove page consumption. `not-needed` keeps real integration pending unless real backend has fresh evidence.
+  - OpenSpec policy: `task.json.frontendOpenspec.policy` (default `cited`); `specRoots` defaults to OpenSpec + ai_workspace and may be fixed during task preparation from an explicitly named normative directory. In cited mode the selector determines the required subset; declared paths/task-source citations cannot be downgraded. Effective plan cites only its required/used specs in one fenced `openspec-citations` block. `scan-strict` keeps full-read semantics (`openspec-not-read`); both modes keep `candidate-missing-drift`.
+  - Component conformance: missing `uiComponentChoices` (frozen bucket non-empty + UI-visible work) → `component-choices-missing`; bad/uncited `specReference.path` → `component-spec-reference-invalid` / `component-spec-not-cited`; at least one `decision=specified` choice must bind to the frozen component/theme bucket → `component-spec-choice-unbound`.
+  - Canonical serialization (UTF-8) >64KB → `retryable-invalid` + `contract-too-large`.
+- **`frontend-writer-admission-shell`**: sole write authorization for `frontend-implement-pi`. Derives and freezes the concrete writeSet (implementation targets ∪ non-static verification target files), pre-writer baseline, and admission digest (Mock strategy, allowed strategies digest, frozen command digest, `productionDefaultOff`, real-integration expectation); writes `contracts/frontend-writer-admission-result.json` (schemaId `frontend-writer-admission-shell-v1`). The scheduler checks before queueing and before executing the writer: only `admitted` releases it, otherwise SKIPPED + `frontend-prewrite-not-authorized`. Admission blocked (`candidate-contract-invalid` / `prewrite-blocked`) is forced `failed` at aggregation.
+- **`frontend-implement-pi`**: sole regular exclusive writer; uses `frontend-bounded-implement` (not this skill). Stay in `writeSet`; real requests default-on. Atomic handler/intercept/adapter with tests. Stop without writing on forbidden paths or unresolved ambiguity. Runtime derives implementation state from persisted write events, run delta, write guard, requirement coverage, and focused checks; any response summary is non-authoritative. Optional mock-verify when frozen; static+behavior always; behavior must prove page consumption. `not-needed` keeps real integration pending unless real backend has fresh evidence.
+
+## Typed terminal protocol
+
+- `frontend-plan-pi` commits incremental `record_*` facts plus one `finalize_plan` (plan).
+- `frontend-design-review-pi` commits `approve_design` | `request_design_changes` (request carries typed issueCategory + evidenceRefs + findings).
+- `frontend-review-pi` commits `approve_review` | `request_review_changes` (request carries typed issueCategory + evidenceRefs + findings).
+- These committed typed tools are the only design/review terminals. They replace
+  `VERDICT:` first-line parsing; response text is human-readable context only.
 
 ## Contract / trace / stages (M1–M2)
 
-- `frontend-verify-assess-shell` runs Mock/static/behavior groups, binds `verificationTargets` to command labels+evidence, writes `frontend-verification-trace.json`+`frontend-repair-assessment.json`; browser/visual stay `not-run`.
-- `frontend-review-context-shell` captures real diff; combines contract, effective trace, repair assessment, diff into `contracts/frontend-review-context.json`.
+- `frontend-verify-shell` runs frozen lint/Mock/static/behavior groups, binds `verificationTargets` to command labels+evidence, writes `frontend-lint-assessment.json` + `frontend-verification-trace.json`; any verification failure is terminal and materializes `frontend-verify-failure-v1` (failureClass / failureOwner / restartPhase) for recovery routing — no same-run repair. Browser/visual stay `not-run`.
+- `frontend-review-context-shell` captures the real diff after the pre-writer baseline; combines contract, lint assessment, effective trace, and diff into `contracts/frontend-review-context.json`.
 - Implement stages: (1) contract confirm (2) tests sync (3) component/UI (4) API/Mock (5) frozen checks (6) diff cleanup. Summary: Contract Ref, Changed Files, Requirements, UI States, Tests, Verification Attempts, Deviations, Residual Risks.
 
-## Repair (M3)
+## Terminal failure & recovery (M3)
 
-Only `eligible=true` runs `frontend-repair-pi` (same writeSet; no re-spec; max 1 attempt) + `frontend-reverify-shell`. No-failure skips both. Non-repairable contract/path/dependency/credential/deploy/spec-unclear failures fail closed.
+Verification, design-review, or final-review failure is terminal — no same-run repair. `frontend-verify-shell` materializes `frontend-verify-failure-v1`; `request_design_changes` / `request_review_changes` block downstream admission/closeout. Recovery routes through the recovery capsule / new-dag; there is no same-run repair branch.
 
 ## Risk & capability (M4–M6)
 
-Deterministic risk, no model; high-risk beats small; supervised never small. Standard/high-risk: 15 top-level nodes; small: 13 (omits revision + final review). Capability seed injects adapters; openspec specs and task sources outrank adapter guidance. A11y: static/component tools only when present; Browser a11y always not-run.
+Deterministic risk, no model; high-risk beats small; supervised never small. Topology by shape: Micro 7 (`frontend-contract-import-shell` → `frontend-writer-admission-shell` → `frontend-implement-pi` → `frontend-verify-shell` → `frontend-review-context-shell` → `frontend-review-pi` → `frontend-closeout-shell`), Small 10 (main chain minus the independent `frontend-design-review-pi`), Standard/High 11 (`frontend-contract-pi` → `frontend-scout-pi` → `frontend-plan-pi` → `frontend-design-policy-shell` → `frontend-design-review-pi` → `frontend-writer-admission-shell` → `frontend-implement-pi` → `frontend-verify-shell` → `frontend-review-context-shell` → `frontend-review-pi` → `frontend-closeout-shell`). Capability seed injects adapters; openspec specs and task sources outrank adapter guidance. A11y: static/component tools only when present; Browser a11y always not-run.

package/skills/frontend-review/SKILL.md

@@ -9,17 +9,27 @@ references:
 
 # Frontend Review
 
-Use for `frontend-review-pi`; read the findings guide first. Required inputs are
-original task/reference material, effective plan/design branch, implementation summary,
-and `contracts/frontend-review-context.json`. That canonical context binds the validated
-implementation contract, effective verification trace, repair assessment, optional
-`frontend-lint-assessment-v1`, and run-owned diff. The diff is authoritative.
+Use for `frontend-review-pi`; read the findings guide first. The required input is
+`contracts/frontend-review-context.json`, its bound diff summary/fragments, and only
+the current source files named by that diff. The canonical context binds the validated
+implementation contract, effective verification trace, optional
+`frontend-lint-assessment-v1`, and run-owned diff. Do not reopen original task sources,
+plans, design-review prose, OpenSpec, or `ai_workspace/`; the bound diff is
+authoritative.
 
-## Verdict Contract
+## Authoritative Terminal
 
-The first non-empty line must be exactly `VERDICT: pass` or
-`VERDICT: request-revision`. Any Critical/Important finding, failed or missing
-required check, forbidden write, or unmet acceptance criterion forces revision.
+Complete the review with exactly one committed typed tool call:
+
+- `approve_review` when no Critical/Important finding remains;
+- `request_review_changes` for a defect, missing required evidence, forbidden
+  write, or unmet acceptance criterion. It must include a typed `issueCategory`,
+  at least one `evidenceRef`, and non-empty findings.
+
+The typed terminal is the only authoritative outcome. Do not require or emit a
+`VERDICT:` line or response-text JSON verdict. A request for review changes ends
+this run and is handled by the recovery controller rather than a same-run repair
+branch.
 
 ## Review Scope
 
@@ -38,11 +48,9 @@ required check, forbidden write, or unmet acceptance criterion forces revision.
   baseline-matched diagnostics on unchanged files, and none on writer-changed files.
   Report debt, never `lint passed`; `failed`/`unavailable` blocks. Typecheck, build,
   and test still require successful final exits.
-- Component/design claims need both knowledge-base and local openspec evidence. Query
-  the connector when available and always read task-relevant files under
-  `<repoRoot>/openspec/schemas/`, `<repoRoot>/openspec/project-specs/`, and `<repoRoot>/ai_workspace/`.
-  Connector format is TODO; never invent evidence. Only successful `read` calls are
-  observable as "已读取规范文件".
+- Evaluate component/design claims against the evidence already bound in the canonical
+  contract and review context. Do not use a repository-wide search or connector query
+  to replace that frozen evidence.
 - Treat shell exit status as authoritative. Do not edit files.
 
 ## Evidence And Output

package/skills/frontend-review/references/review-findings.md

@@ -14,24 +14,23 @@
   `baseline-debt` only with a valid `frontend-lint-assessment-v1`; this is not a
   passed lint result. A changed-file lint diagnostic, new unmatched diagnostic,
   command drift, missing baseline, timeout, or unparseable output is Important.
-- Treat knowledge base, `openspec/schemas/`, `openspec/project-specs/`, and `ai_workspace/` as
-  parallel sources. Record connector/query/source/time plus openspec search terms and
-  matched paths/headings; label fallback or unavailable accurately.
+- Treat the design evidence already bound in the canonical review context as the
+  source of truth. Do not launch a connector query or repository-wide OpenSpec/
+  `ai_workspace` search to replace frozen evidence; label a missing bound evidence
+  reference accurately instead.
 
 ## Review Sequence
 
 1. Establish changed-file inventory and write boundaries.
-2. Compare original requirement with derived contract/constraints.
+2. Compare the bound contract with the approved constraints and cumulative diff.
 3. Map each criterion to code, states, tests, and evidence.
 4. Inspect interactions, state/data/API behavior, failure paths, and regressions.
 5. Check mock selection, contract-to-fixture mapping, activation/default path,
    handler/fixture/adapter and consumer diff, verification, production imports, and
    the real-integration gap.
-6. Check design evidence, responsive/a11y behavior, dependencies, and maintenance.
+6. Check bound design evidence, responsive/a11y behavior, dependencies, and maintenance.
 7. Classify findings and derive the verdict mechanically.
 
-Skipping either directory is Important when design compliance affects acceptance.
-
 ```text
 - [Critical|Important|Minor] path:line — Problem; impact; required correction; evidence.
 ```

package/skills/loop-agent/references/command-reference.md

@@ -100,6 +100,8 @@ loop-agent --help
 ```bash
 loop-agent inspect                                           # 当前 repo（自动检测）
 loop-agent --repo-root /path/to/target-repo inspect           # 指定 repo
+loop-agent inspect next                                      # 当前 npm next 绑定（version / SHA / unpublished commits）
+loop-agent inspect next --json
 ```
 
 ### 健康检查
@@ -132,13 +134,18 @@ SDK 回归或 SDK 可选依赖不可用时用 `cli-only` 诊断。CLI fallback
 
 ```bash
 loop-agent init instructions --repo-root <target-repo>
+loop-agent init model-catalog --repo-root <target-repo> --json
 loop-agent init --repo-root <target-repo> --profile full --merge \
-  --provider deepseek --model deepseek/deepseek-v4-flash
+  --low-model deepseek/deepseek-chat \
+  --med-model deepseek/deepseek-v4-flash \
+  --high-model deepseek/deepseek-v4-pro
 loop-agent init doctor --repo-root <target-repo>
 loop-agent init check-update --repo-root <target-repo> --json
 loop-agent init check-update --repo-root <target-repo> --markdown
 loop-agent init update --repo-root <target-repo> --bootstrap-surface
 loop-agent init update --repo-root <target-repo> --apply-safe
+loop-agent init update --repo-root <target-repo> --apply-safe \
+  --low-model <current-or-selected> --med-model <current-or-selected> --high-model <current-or-selected>
 loop-agent init reconcile --repo-root <target-repo> [--json|--markdown]  # compatibility low-level diagnostic
 loop-agent init upgrade --repo-root <target-repo> --json
 loop-agent init upgrade --repo-root <target-repo> --run-id <run-id> --status --json
@@ -146,13 +153,13 @@ loop-agent init upgrade --repo-root <target-repo> --run-id <run-id> --continue -
 loop-agent init upgrade --repo-root <target-repo> --run-id <run-id> --report --markdown
 ```
 
-fresh init 将精确引用写到 `executors.pi.LOW/MED/HIGH`。fresh `loop-agent init` 会将合格且完整的 `provider/model` 引用投影到 `executors.pi.LOW/MED/HIGH`，即 `executors.pi.LOW`、`executors.pi.MED` 和 `executors.pi.HIGH`。三个 tier 齐全时不会写入 `defaultModel`，也不会恢复或建议旧顶层 routing 字段。
+fresh init 将精确引用写到 `executors.pi.LOW/MED/HIGH`。模型先运行只读 `init model-catalog`：Pi SDK runtime 与 OpenCode 非 verbose 列表由代码确定性发现，只向模型暴露 provider/model、能力/成本/窗口元数据、Pi setup、兼容性与 credential-ready 布尔值，不暴露原始配置和凭据。已有档位仍存在于 Pi 时原样保留，只重选失效/缺失档位；代码在 update 时拒绝替换仍有效档位。Pi 无定义时先向用户补齐必要模型元数据并帮助字段级配置 `models.json`；只有认证缺失时保留 harness 并修复认证。三个 tier 齐全时不会写入 `defaultModel`，也不会恢复旧顶层 routing 字段。
 
 `init check-update` 是只读升级报告，用于发现目标项目是否落后于当前包内初始化 surface。输出会区分 deterministic actions、model merge tasks、human decisions 和 recommended next。`--markdown` 会渲染可直接交给模型执行的合并指引，包含 `allowedPaths`、`forbiddenPaths`、`mergeRules` 和 `verification`。
 
-`init update --bootstrap-surface` 为旧项目写入 `.harness/init-surface.json` 的 `inferred-baseline`，不伪装成历史 recorded baseline。`init update --apply-safe` 只执行确定性安全动作：补缺失文件、创建目录、刷新 managed block；已有但无法确认与当前包一致的文件会进入 model merge tasks，不会被覆盖。模型 merge 只会自动展开不含 tier 或其他旧字段的唯一、完整且可证明等价的旧 `defaultModel: "provider/model"`；顶层 `model`、`models`、`modelProfiles`、`modelRouting`、`verify`、`sequentialWorkflowRole`、部分/对象 tier、bare model、冲突 provider 或未知语义均 fail closed，并保留原始 `harness.json`。
+`init update --bootstrap-surface` 为旧项目写入 `.harness/init-surface.json` 的 `inferred-baseline`，不伪装成历史 recorded baseline。`init update --apply-safe` 只执行确定性安全动作：补缺失文件、创建目录、刷新 managed block；`harness.json` 永不走整文件 `refresh-owned-file`，即使它仍与旧 recorded hash 一致，也只允许字段级确定性迁移或 bounded merge。带完整三档参数的 update 只替换 catalog 已判定失效的档位，仍有效档位的对象形态与 thinking 配置保持不变。模型 merge 只会自动展开不含 tier 或其他旧字段的唯一、完整且可证明等价的旧 `defaultModel: "provider/model"`；其他歧义均 fail closed 并保留原文件。
 
-`init upgrade` 是写入型升级入口：首次运行冻结 controller identity、检查 npm latest、扫描 surface、自动执行安全动作，并把 run facts 持久化到 `.harness/init-upgrades/<run-id>/`。`--status` 与 `--report` 严格只读；`--continue` 会重新核验 identity、当前 hash 与不变量。版本选择、无法判定冲突、凭据、破坏性删除或 active writer 才进入 human decision。普通语义冲突返回具体单文件 `allowedPaths` merge task，主会话必须合并后继续，不能把 `needs-model-merge` 作为完成。默认管理项目级 OpenCode/Pi recovery 与 `.pi/settings.json` nested merge，保留显式 disabled，Pi trust 后才加载；默认不读写 `~/.pi/agent/settings.json`。旧 `init reconcile` 保留为兼容低层诊断。
+`init upgrade` 是写入型升级入口：首次运行冻结 controller identity 与脱敏模型目录，检查 npm latest，并用一次 surface scan 形成完整计划。固定投影按 recorded bytes 确定性增删改；recorded `harness.json` 按属性树增删字段并保留项目值、同步 schema；项目自适应内容由模型决定。多个语义合并在同一计划中串行排队，每次仍只开放一个文件的 `allowedPaths`；接受后直接激活下一项，不重复版本发现/规划，队列清空后只跑一次最终验证。确定性收敛最多两轮。完成态的 verification/report 均有 controller hash anchor，`--status`、`--report` 和已完成 run 的幂等 `--continue` 只读持久化证据，不重新跑项目校验。默认管理项目级 OpenCode/Pi recovery 与 `.pi/settings.json` nested merge，默认不读写 `~/.pi/agent/settings.json`。旧 `init reconcile` 保留为兼容低层诊断。
 
 升级在 managed block 收敛后生成只读 gitignore 迁移评估（`.harness/init-upgrades/<run-id>/gitignore-migration.json`）：inventory 已跟踪的 `.harness/**` 与 `.agents/**`，建议 index-only 命令 `git rm -r --cached --ignore-unmatch .harness` / `.agents`（只改 index、保留工作区文件；`scripts/**` 与 `ai_workspace/loop-agent/**` 永不出现）。`.agents` 已跟踪内容会触发 human-decision 暂停等待审查；非 Git 仓库、git 查询失败或存在 staged 条目时 `status: blocked` 且无命令建议。controller 不自动修改 Git index。
 
@@ -327,6 +334,7 @@ loop-agent dag request-interrupt --run-id <run-id> --request-id <id> --target-op
 loop-agent dag rerun --run-id <run-id> --from-node <node-id> --plan [--json]  # 从节点重跑资格预检（不执行）
 loop-agent dag rerun --run-id <run-id> --from-node <node-id> --plan-hash <sha256> --request-id <key> --reason "..." [--json]  # 安全子图 continuation
 loop-agent dag rerun-task --run-id <run-id> --reason "..." --request-id <key> [--profile auto] [--task-id <id>] [--json]  # standalone 完整任务重跑
+loop-agent dag follow-up <parent-run-id> [--task-id <id>] [--execute] [--profile auto|minimal|standard|reviewed|supervised]  # 将 frontend review 的 request_review_changes findings 物化为下游 frontend task；默认只创建并返回 task advance 命令
 loop-agent dag request-interrupt --run-id <run-id> --request-id <key> --target-operation-id <op-id> --reason-code <code> --reason "..." --expected-runner-pid <pid> --expected-runner-hostname <host> --expected-runner-started-at <ts> --expected-controller-fingerprint <fingerprint>  # 协作式中止：经 Human Gate 登记 interrupt.json，runner 等当前节点安全收敛后再停调度，不直接 SIGKILL
 loop-agent dag reconcile-tasks --glob '<pattern>'         # 仅报告的 task/run/artifact/verify drift audit
 loop-agent dag final-verification <task-id>               # 生成 closeout DAG，closeout artifact 后再 final verify

package/skills/loop-agent/references/hybrid-dag.md

@@ -16,7 +16,7 @@
 
 对于默认 `standard` 任务，生成器先读取 `source/需求.md` 中的结构化任务类型，再结合 `allowedPaths` 与 React/Next/Vue 强工程证据做确定性分类。确认是前端项目且任务不是明确后端、前后端混合、排除前端或仅文档/测试范围时，默认选择 `frontend-implementation` DAG，不依赖需求关键词。分类不会把普通后端实现路由到 `backend-test`；显式 profile、`workflowPolicy` 或 supervised quality gate 只记录治理强度，不把已识别的前端业务 workflow 换回通用模板。
 
-前端专用链保留独立 contract/scout；plan 同时选择 Mock/API 策略并输出结构化 implementation contract。design initial pass 直接使用原计划，只有 request-revision 才运行 revision/final review；small-risk 只执行一次 design review。`frontend-prewrite-gate-shell` 合并生效 verdict、REQ/BR/AC 覆盖、Mock policy 和 contract 物化，是唯一写入授权。实现后 `frontend-verify-assess-shell` 合并 Mock/static/behavior/trace/assessment；只有 `eligible=true` 才运行同 writeSet 的 repair 和 `frontend-reverify-shell`。`frontend-review-context-shell` 绑定真实 diff 与有效验证证据后再 review/closeout。standard/high-risk 为 15 个顶层节点，small-risk 为 13；绿色路径执行 11 个节点、7 次 Pi。生成期 blocked Mock 只生成一个确定性阻塞节点且没有 writer。
+前端专用链保留独立 contract/scout；plan 通过增量 typed `record_*` 工具提交决策账本并以唯一 `finalize_plan` 收口（无 fenced JSON 文本协议）。写授权由 `frontend-design-policy-shell`（确定性设计检查 + 物化唯一 authoritative `frontend-implementation-contract-v1`）与 `frontend-writer-admission-shell`（唯一写入授权：派生并冻结 writeSet、pre-writer baseline、admission digest，`admitted` 才放行 writer）承接；design review 与 final review 的权威终态是 committed typed tool（`approve_design|request_design_changes`、`approve_review|request_review_changes`）。实现后 `frontend-verify-shell` 合并 lint/Mock/static/behavior/trace；任何验证失败都是 terminal，物化 `frontend-verify-failure-v1` 供 recovery 路由，无同 run repair。`frontend-review-context-shell` 绑定真实 diff 与有效验证证据后再 review/closeout。拓扑按 shape 路由：Micro 7 / Small 10 / Standard-High 11 个顶层节点；Standard/High 完整主链为 `frontend-contract-pi` → `frontend-scout-pi` → `frontend-plan-pi` → `frontend-design-policy-shell` → `frontend-design-review-pi` → `frontend-writer-admission-shell` → `frontend-implement-pi` → `frontend-verify-shell` → `frontend-review-context-shell` → `frontend-review-pi` → `frontend-closeout-shell`，Small 去掉独立 `frontend-design-review-pi`，Micro 为 `frontend-contract-import-shell` → `frontend-writer-admission-shell` → `frontend-implement-pi` → `frontend-verify-shell` → `frontend-review-context-shell` → `frontend-review-pi` → `frontend-closeout-shell`。生成期 blocked Mock 只生成一个确定性阻塞节点且没有 writer。
 
 > Backend-test Markdown-first：先由确定性环境 Shell 检查 clean env 中 Python/pytest、常见配置、conftest/fixture、test root、server entry 和 HTML renderer，失败时不消耗模型调用。随后 Pi 生成中文 README 索引与模块用例卡片并独立 Review `testcase/md/**`。第 4 节点只把前置条件、操作步骤、预期结果作为必选章节，并检查 Case ID、业务 AC、步骤/预期和占位措辞；不校验需求来源引用有效性或 Markdown sensitive-shaped 内容。pytest writer 为每次真实接口调用记录脱敏、有界的请求 method/URL/参数摘要和响应 status/body 摘要。第 6 节点只扫描每条 Case 明确映射的 pytest 脚本，同时支持模块级函数和 pytest class 方法，并把缺少请求/响应日志、递归脱敏或有界截断证据记录为 advisory。第 4/6 节点均写 PASS/FAIL findings 而不阻断后续；pytest 仍只运行一次，生成 JUnit，并把 Markdown 名称/场景/脚本映射与同一 JUnit 合成为按测试概览、质量校验、失败概览、用例执行明细和技术证据组织的中文 self-contained HTML 与 Markdown facts。最终 Pi 按固定简洁结构汇总 advisory 状态、执行事实和 L-5 结论。active 流程不要求模型生成 backend-test 业务 JSON。
 
@@ -52,6 +52,13 @@ loop-agent dag execute --dag <temp-dir>/hybrid-dag.json --init-only --canvas-pat
 - 顶层：`objective`、`successCriteria`、`globalConstraints`、`defaults`、`skillsByRole`、`executorModels`
 - 每 node：`role`、`skills`、`writePolicy`、`writeSet`、`piStep`、`shell`、`outputContract`、`executor`（`pi` | `shell` | `static`）；Pi 写入节点额外声明 `toolProfile: "write"`；安全只读 Pi 节点可选声明 `retryPolicy`（生成器自动注入默认值）
 
+**Source binding v2（frontend source fidelity ledger）**：
+
+- `dagSourceBindingSchema` 是 `schemaVersion` discriminated union：v1（`schemaVersion: 1`，strict 拒绝 ledger 字段）与 v2（`schemaVersion: 2`，`ledgerPath`/`ledgerSha256`/`inputDigest`/`requirementToFragments` 全部必填）。
+- 仅 `frontend-implementation` 且存在可解析 requirement/acceptance 引用时产出 v2；绑定完全来自 `task advance` 已持久化的 `source/requirement-ledger.json`（intake/apply/prewrite 同一份受管账本），缺失/损坏/漂移 fail closed（`SOURCE_FIDELITY_LEDGER_MISSING`/`SOURCE_FIDELITY_LEDGER_STALE`），不静默降级为 v1。
+- v1 不得携带 optional ledger 字段冒充 v2；prewrite 门禁对 v2 校验 ledger 字节 sha256、inputDigest 新鲜度与 requirement→fragment 覆盖，任一失败以稳定 `source-fidelity-*` 码阻断 writer。
+- ledger `sourceDocuments[].path` 与 DAG 侧 `serializeDagTaskSourcePath`/`resolveDagTaskSourcePath` 单一边界一致（repo-root relative），路径转换不得二次进入 digest 计算。
+
 **Model 生成 DAG 的 template 卫生**：
 
 - 执行前将所有 `REPLACE/WITH/...` placeholder 换为具体 repo path。

package/skills/playwright-cli/SKILL.md

@@ -25,6 +25,7 @@ close
 goto
 snapshot
 find
+find-unique
 click
 dblclick
 fill
@@ -54,7 +55,7 @@ request
 
 ## 推荐执行流程
 
-使用 `testcase/frontend/rag/context.md` 中已由 environment shell 标记为 `reachable` 的非生产 `baseUrl` 和默认浏览器 session；不得创建 named session。交互前先获取 snapshot，并只使用 snapshot 中可见的 ref 或已知安全 locator。
+使用 `{testRoot}/rag/context.md`（默认 `testcase/frontend/rag/context.md`）中已由 environment shell 标记为 `reachable` 的非生产 `baseUrl` 和默认浏览器 session；不得创建 named session。交互前先获取 snapshot，并只使用 snapshot 中可见的 ref 或已知安全 locator。截图写入当前 case 的 `{evidenceDir}/<caseId>/`，canonical 文件名仍是 `final.png`。
 
 ```text
 playwright-cli open --browser=chrome http://localhost:5173
@@ -71,6 +72,16 @@ playwright-cli close
 普通交互和控制台输出均不能单独取得 passed authority。通过的 case 还需要同一 child 的有序
 controller receipts：successful `open` → successful `find` → successful post-execution cleanup。
 
+### 唯一性断言优先用 find-unique
+
+当语义要求「全页恰好一个」时，用 `playwright-cli find-unique "字面"` 代替人工数命中数：它内部
+执行 find 并在解析命中数 ≠ 1 时以非零退出码失败（零命中/多命中/输出不可解析均 fail），错误
+信息直接给出 `expected exactly 1 match, got N`。它只接受一个文本字面量、不接受 `--regex` 等
+flag。台账中标注 `==1` 的锚点、以及「唯一命中」类 AC 应优先用它；`>=N` 存在性断言仍用
+`find`（find-unique 会拒绝多命中）。controller 会解析两类命令的命中数写入 receipt，finalize
+时用 case 文档声明的 `find "字面" >=N / ==N` 对照 receipt 复核，缺失或不满足会把 passed
+降级为 blocked（assertion-not-receipt-backed），因此声明的断言必须真的执行。
+
 ## 受限证据采集
 
 - UI 状态：先 `snapshot`，完成交互后以成功 `find` 证明用户可见结果。
@@ -91,3 +102,14 @@ controller receipts：successful `open` → successful `find` → successful pos
 当环境、数据、权限、时序、异常路径或响应内容无法用 RAG、已验证 context URL 和 runtime allowlist 证明时，
 写入 `blocked` evidence，并提供具体 `blockedReason`。不要引入替代执行路径，也不要把隐藏状态或
 未观察到的网络结果当作通过证据。
+
+### 唯一控件早停（unique-control-unavailable）
+
+- 适用：AC 点名的具体控件在到达目标状态后的**首个 post-navigation snapshot** 中缺失，且页面没有
+  setup-required 门（如「需先完成 Pi setup」）。
+- 判定：用 case 给出的字面做**单次** `find`；返回 0 命中即为充分证据，直接写
+  `status=blocked`、`blockedReason=unique-control-unavailable`，在 execution.md 中引用该次 find 结果。
+- 禁止：换字面重试、反复 snapshot、绕路导航、多轮探索或请求 rerun。这些都产生无放大的 token
+  成本且不改变结论（Wave 3 教训：反复探测不存在控件耗掉约 717k input tokens）。
+- 若 snapshot 显示存在 setup-required 门或状态前置未满足，按其对应 blockedReason 记录
+  （环境/状态类），不属于本早停。

package/skills/playwright-cli-case-generator/SKILL.md

@@ -13,12 +13,24 @@ description: 根据 FE-test RAG 知识包生成可由受限 playwright_cli runti
 
 ## 输入与边界
 
-- 只读取 `testcase/frontend/rag/context.md`、`coverage-map.md` 与已有 `testcase/frontend/cases/`。
-- 只写 `testcase/frontend/cases/**`；不得回读 PRD、读取 `.harness/`，或写
-  `testcase/frontend/evidence/**`。
+默认产物根是 `testcase/frontend/`。若任务配置了 `frontendTest.testRoot`，把下列路径中的 `testcase/frontend/` 整段替换为该根（不要只替换 `testcase/`）。
+
+- 只读取 `{testRoot}/rag/context.md`、`coverage-map.md` 与已有 `{testRoot}/cases/`。
+- 若存在 `{testRoot}/rag/ui-anchors.md` 锚点台账，必须一并读取并作为 UI 断言的唯一事实源；台账缺失时按 RAG 知识包生成，但不得引用台账外的具体控件字面（缺失信息标 `blocked`）。
+- 只写 `{testRoot}/cases/**`；不得回读 PRD、读取 `.harness/`，或写
+  `{testRoot}/evidence/**`。
 - 所有 API、字段限制、状态流转、数据来源、SLA、URL 与账号要求必须能在 RAG 知识包中追溯。
   缺失信息标记 `blocked` 或“需人工确认”，不得猜测。
 
+### 锚点台账规则（存在 ui-anchors.md 时）
+
+- case 中每条拟通过的 `find "<字面>"` 断言必须能在台账对应「页面 × 状态」节找到
+  状态为 `有效` 的行；台账 `不可断言` / `失效` 行的字面**禁止**作为通过断言。
+- AC 点名的控件在台账对应状态节缺失（0 命中或无行）时，该 AC 的 case 生成
+  `blocked` 语义说明（或从本批剔除该 AC），`blockedReason` 用
+  `unique-control-unavailable`，不得生成探测性步骤反复 find。
+- 台账行备注中的替代断言方案（如拆节点后的短字面二选一）按备注执行。
+
 ## 输出
 
 - 写 `index.md`、`manifest.draft.json`（生成阶段；materialize 会写成 `manifest.json`）与独立 case 文件
@@ -28,10 +40,10 @@ description: 根据 FE-test RAG 知识包生成可由受限 playwright_cli runti
     （例：`FE-LOGIN-001-core`）。禁止把验收标准写成 caseId。
   - `acIds` = **验收标准 ID 列表**，形态 `AC-FE-*` / `AC-*`
     （例：`["AC-FE-001"]`）。禁止把用例 ID 放进 acIds。
-  - `casePath` 必须等于 `testcase/frontend/cases/<caseId>.md`；
-    `evidenceDir` 必须等于 `testcase/frontend/evidence/<caseId>/`。
+  - `casePath` 必须等于 `{casesDir}/<caseId>.md`（默认 `testcase/frontend/cases/<caseId>.md`）；
+    `evidenceDir` 必须等于 `{evidenceDir}/<caseId>/`（默认 `testcase/frontend/evidence/<caseId>/`）。
 - `manifest` 使用 `schemaVersion: 1`，每项只含 `caseId`、`casePath`、`dimension`、`acIds`、
-  `evidenceDir`。所有 ID、路径和 evidenceDir 必须唯一，并位于 `testcase/frontend/` 内。
+  `evidenceDir`。所有 ID、路径和 evidenceDir 必须唯一，并位于 `{testRoot}/` 内。
 - `index.md` 按功能点列出 case、维度、AC、数据依赖、API 映射和预期执行状态。
 
 每个 case 必须包含：
@@ -51,10 +63,19 @@ description: 根据 FE-test RAG 知识包生成可由受限 playwright_cli runti
    占位符仅表示从紧邻其前、最新一次 `snapshot` 输出解析出的真实 `eNN` ref。生成的 case 必须在每次
    引用元素前写明 fresh snapshot；`eX`/`eY` 不是可传给 structured tool 的 literal ref，新的 snapshot
    会使旧 ref 失效，不得复用 stale ref。
-5. 明确的 UI/API 预期与数据清理结果；无法满足的环境或数据依赖必须写为 `blocked`。
+5. **期望命中数不得内联进命令行（硬约束）**：如需声明 find 期望命中数，写在「预期结果」区或
+   列表项的说明文字中（如 “预期唯一命中”）；命令行只写纯命令 `playwright-cli find "<字面>"`。
+   禁止 `find "<字面>">=N`、`≥N`、`（≥N）` 等计数后缀内联进命令 token。
+6. **唯一性断言优先 find-unique**：台账或 AC 标注 `==1`/「唯一命中」的锚点，生成
+   `playwright-cli find-unique "<字面>"`（仅一个文本字面量，无 flag；多命中/零命中即命令失败）；
+   `>=N` 存在性断言仍用 `find`。finalize 会用 case 文档中 `find "字面" >=N / ==N` 声明对照
+   controller receipt 的解析命中数复核，声明的断言未真正执行或命中数不满足会把 passed 降级为
+   blocked（assertion-not-receipt-backed）——因此「测试点」里声明的每个 find 断言都必须在步骤中
+   真实执行且字面完全一致。
+7. 明确的 UI/API 预期与数据清理结果；无法满足的环境或数据依赖必须写为 `blocked`。
 
 所有文件型输出均由 controller 绑定到执行节点提供的
-`testcase/frontend/evidence/<case-id>/` 工作目录。截图一律使用 canonical 语法
+`{evidenceDir}/<case-id>/` 工作目录（默认 `testcase/frontend/evidence/<case-id>/`）。截图一律使用 canonical 语法
 `playwright-cli screenshot --filename final.png`；如确有从最新 snapshot 解析出的真实元素 ref，写为
 `playwright-cli screenshot e5 --filename final.png`。`pdf` 必须写为
 `playwright-cli pdf --filename final.pdf`。`snapshot` 无 filename 时仅返回响应；需要文件时使用

package/dist/worker/console/static/assets/channel-CPF4N7pf.js

@@ -1 +0,0 @@
-import{ag as o,ah as n}from"./mermaid.core-BVjAT9b8.js";const t=(a,r)=>o.lang.round(n.parse(a)[r]);export{t as c};

package/dist/worker/console/static/assets/classDiagram-JCYQIIEL-C2DwA_Y1.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-GF5L2VYU-CPcdNeew.js";import{_ as i}from"./mermaid.core-BVjAT9b8.js";import"./chunk-5VM5RSS4-CtiPlKel.js";import"./chunk-XXDRQBXY-UrVoM9z1.js";import"./chunk-KBJHAD2P-DQ_T-hg8.js";import"./chunk-2GRJ4B5K-K0C744p1.js";import"./index-DTZOKgAn.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};

package/dist/worker/console/static/assets/classDiagram-v2-OCEON4UE-C2DwA_Y1.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-GF5L2VYU-CPcdNeew.js";import{_ as i}from"./mermaid.core-BVjAT9b8.js";import"./chunk-5VM5RSS4-CtiPlKel.js";import"./chunk-XXDRQBXY-UrVoM9z1.js";import"./chunk-KBJHAD2P-DQ_T-hg8.js";import"./chunk-2GRJ4B5K-K0C744p1.js";import"./index-DTZOKgAn.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};