prizmkit 1.1.154 → 1.1.156

package/src/scaffold.js

@@ -13,7 +13,8 @@ import path from 'path';
 import { readFileSync } from 'fs';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { dirname, join } from 'path';
-import { execSync } from 'child_process';
+import { execFileSync, execSync } from 'child_process';
+import os from 'os';
 import {
   loadMetadata,
   getTemplatesDir,
@@ -1373,6 +1374,19 @@ export async function installPlaywrightCli(projectRoot, dryRun) {
 // OpenCLI 安装
 // ============================================================
 
+/**
+ * Side-effect-free OpenCLI presence check. Running OpenCLI itself is unsafe here:
+ * browser-oriented commands such as `opencli doctor` create a live browser session.
+ */
+function isOpenCliAvailable() {
+  try {
+    execFileSync(os.platform() === 'win32' ? 'where.exe' : 'which', ['opencli'], { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 /**
  * 安装 opencli（全局 npm 包）
  * 用于浏览器交互验证，复用 Chrome 已登录会话（OAuth/SSO/第三方集成）
@@ -1383,12 +1397,11 @@ export async function installOpenCli(projectRoot, dryRun, autoDownload = true) {
     return;
   }
 
-  // Check if already installed
-  try {
-    execSync('opencli --version', { stdio: 'pipe' });
+  // Detect the executable without running it. This keeps repeated PrizmKit
+  // installs/upgrades idempotent and avoids starting an OpenCLI browser session.
+  if (isOpenCliAvailable()) {
     console.log(chalk.green('      ✓ opencli (already installed)'));
-  } catch {
-    // Not installed, install it
+  } else {
     try {
       console.log(chalk.blue('      ⏳ Installing @jackwener/opencli globally...'));
       execSync('npm install -g @jackwener/opencli@latest', { stdio: 'pipe', timeout: 120000 });
@@ -1400,22 +1413,20 @@ export async function installOpenCli(projectRoot, dryRun, autoDownload = true) {
     }
   }
 
-  // Verify opencli connectivity — Chrome Browser Bridge extension is a manual install
-  try {
-    const doctorOutput = execSync('opencli doctor 2>&1', { stdio: 'pipe', timeout: 15000 }).toString();
-    if (doctorOutput.includes('[MISSING] Extension') || doctorOutput.includes('[FAIL] Connectivity')) {
-      console.log(chalk.yellow('      ⚠ Chrome Browser Bridge extension is NOT connected'));
-
-      if (autoDownload) {
-        await downloadOpenCliExtension();
-      } else {
-        printOpenCliManualSteps();
-      }
-    } else {
-      console.log(chalk.green('      ✓ opencli connectivity verified'));
-    }
-  } catch {
-    // doctor command itself failed — already warned about install issues
+  // Check only PrizmKit's downloaded extension files. Connectivity checks are
+  // intentionally user-initiated because `opencli doctor` opens a browser tab.
+  const extensionManifest = path.join(
+    process.env.HOME || process.env.USERPROFILE || '.',
+    '.opencli',
+    'extension',
+    'manifest.json',
+  );
+  if (fs.pathExistsSync(extensionManifest)) {
+    console.log(chalk.green('      ✓ OpenCLI extension files (already downloaded)'));
+  } else if (autoDownload) {
+    await downloadOpenCliExtension();
+  } else {
+    printOpenCliManualSteps();
   }
 }
 

package/bundled/dev-pipeline/templates/sections/bugfix-artifacts.md

@@ -1,16 +0,0 @@
-## Bug Fix Artifacts Directory
-
-Use only this durable artifact directory for this bug fix:
-
-```text
-.prizmkit/bugfix/{{BUG_ID}}/
-├── spec.md
-├── plan.md
-├── context-snapshot.md
-├── review-report.md
-├── fix-report.md
-├── failure-log.md
-└── workflow-checkpoint.json
-```
-
-Do not write bugfix artifacts under feature or refactor artifact directories.

package/bundled/dev-pipeline/templates/sections/bugfix-session-status.md

@@ -1,31 +0,0 @@
-### Step 3: Report Session Status
-
-Before exiting, write the session status file:
-
-`{{SESSION_STATUS_PATH}}`
-
-```json
-{
-  "session_id": "{{SESSION_ID}}",
-  "bug_id": "{{BUG_ID}}",
-  "status": "<success|partial|failed>",
-  "completed_phases": [1, 2, 3, 4],
-  "current_phase": 4,
-  "checkpoint_reached": "<current checkpoint step>",
-  "fast_path": false,
-  "errors": [],
-  "can_resume": false,
-  "resume_from_phase": null,
-  "artifacts": {
-    "spec_path": ".prizmkit/bugfix/{{BUG_ID}}/spec.md",
-    "plan_path": ".prizmkit/bugfix/{{BUG_ID}}/plan.md",
-    "fix_report_path": ".prizmkit/bugfix/{{BUG_ID}}/fix-report.md"
-  },
-  "git_commit": "<commit hash or null>",
-  "traps_updated": false,
-  "manual_verification_policy": "{{MANUAL_VERIFICATION_POLICY}}",
-  "timestamp": "{{TIMESTAMP}}"
-}
-```
-
-For manual/hybrid verification, record the selected automated verification method and evidence in `manual_verification_policy`; never use a partial stop solely because the plan labels verification as manual or hybrid.

package/bundled/dev-pipeline/templates/sections/critical-paths-agent.md

@@ -1,7 +0,0 @@
-## Critical Paths
-
-| Resource | Path |
-|----------|------|
-| Feature Artifacts Dir | `.prizmkit/specs/{{FEATURE_SLUG}}/` |
-| Context Snapshot | `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` |
-| Project Root | {{PROJECT_ROOT}} |

package/bundled/dev-pipeline/templates/sections/critical-paths-lite.md

@@ -1,7 +0,0 @@
-## Critical Paths
-
-| Resource | Path |
-|----------|------|
-| Feature Artifacts Dir | `.prizmkit/specs/{{FEATURE_SLUG}}/` |
-| Context Snapshot | `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` |
-| Project Root | {{PROJECT_ROOT}} |

package/bundled/dev-pipeline/templates/sections/directory-convention-agent.md

@@ -1,9 +0,0 @@
-## PrizmKit Directory Convention
-
-```
-.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md  ← Main Agent writes Sections 1-4 + Implementation Log
-.prizmkit/specs/{{FEATURE_SLUG}}/plan.md              ← includes Tasks section
-.prizmkit/specs/{{FEATURE_SLUG}}/review-report.md     ← Main Agent writes Code Review progress and Final Result
-```
-
-**`context-snapshot.md`** is the implementation knowledge base and remains append-only after initial creation. Code Review writes only `review-report.md`; it does not append separate Review Notes to the context snapshot.

package/bundled/dev-pipeline/templates/sections/directory-convention-lite.md

@@ -1,6 +0,0 @@
-## PrizmKit Directory Convention
-
-```
-.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md
-.prizmkit/specs/{{FEATURE_SLUG}}/plan.md              ← includes Tasks section
-```

package/bundled/dev-pipeline/templates/sections/headless-commit-authorization.md

@@ -1,15 +0,0 @@
-### Headless Commit Authorization
-
-This pipeline session is non-interactive. Do not ask questions, wait for user input, or request commit confirmation.
-
-The pipeline launch has already authorized local commits for this task. Invoke `/prizmkit-committer` with the pipeline-managed execution context:
-
-```json
-{
-  "mode": "l4-headless",
-  "owner": "prizmkit-l4",
-  "local_commit_authorized": true
-}
-```
-
-The committer must still verify every lifecycle gate, inspect the intended diff, generate a Conventional Commit message, stage only intended files, create the local commit, and verify it. Remote publication is controlled by the runtime after the local commit; do not make a publication decision in this session. If the execution context is absent or invalid, mark the task blocked and exit; do not ask the user.

package/bundled/dev-pipeline/templates/sections/phase-commit.md

@@ -1,61 +0,0 @@
-### Architecture Sync & Commit (SINGLE COMMIT)
-
-**a.** Run `/prizmkit-retrospective` — maintains `.prizmkit/prizm-docs/` (architecture index):
-1. **Structural sync**: Use `git diff --cached --name-status` to locate changed modules, update KEY_FILES/INTERFACES/DEPENDENCIES/file counts in affected `.prizmkit/prizm-docs/` files
-2. **Architecture knowledge** (feature sessions only): Extract TRAPS/RULES/DECISIONS from completed work into `.prizmkit/prizm-docs/`
-3. **Detail-doc coverage check**: For any module/sub-module with source files created or significantly modified in this session but no detail `.prizm` doc — evaluate whether one is warranted and create it when needed. The current session has the best context for accurate KEY_FILES, TRAPS, and DECISIONS.
-4. Stage doc changes: `git add .prizmkit/prizm-docs/`
-⚠️ Do NOT commit here. Only stage.
-
-**b.** Stage all feature code explicitly (NEVER use `git add -A` or `git add .`):
-```bash
-git add <specific-files-created-or-modified>
-git add .prizmkit/prizm-docs/
-```
-
-**c.** Run `/prizmkit-committer` → THE ONLY commit for this feature:
-`feat({{FEATURE_ID}}): {{FEATURE_TITLE}}`
-This single commit includes: feature code + tests + .prizmkit/prizm-docs/ updates.
-- MANDATORY: commit must be done via `/prizmkit-committer` skill. Do NOT run manual `git add`/`git commit` as a substitute.
-- Do NOT run `update-feature-status.py` here — the pipeline runner handles feature-list.json updates automatically after session exit.
-
-**d.** Final verification:
-```bash
-git status --short
-```
-Working tree MUST be clean after this step. If any feature-related files remain, stage them explicitly and amend the SAME commit with `git commit --amend --no-edit`; do NOT create a separate commit.
-
-**e.** Write completion summary for downstream dependency context:
-
-Write `.prizmkit/specs/{{FEATURE_SLUG}}/completion-summary.json` with the key changes from this session. This file is NOT committed to git — the pipeline runner reads it to propagate context to dependent features.
-
-```json
-{
-  "completion_notes": [
-    "<each item: one key change, API, model, or integration point that downstream features may need>",
-    "Example: Added User model (id, email, password_hash, display_name) in prisma/schema.prisma",
-    "Example: POST /api/auth/register and POST /api/auth/login endpoints in src/api/auth.ts",
-    "Example: Auth middleware in src/middleware/auth.ts — validates JWT on protected routes"
-  ]
-}
-```
-
-Rules for writing completion notes:
-- Focus on **what downstream features need to know**: new APIs, models, exported functions, key file paths
-- Each note should be self-contained and concise (one line, under 120 characters preferred)
-- Include 3-8 notes covering the most important changes
-- Do NOT include test files, config changes, or internal implementation details unless they affect other features
-- If this feature has no downstream dependents, still write the summary (it serves as documentation)
-
-
-
-### TERMINAL STOP — Commit Completed
-
-After all of the following are true, the session is **TERMINAL**:
-
-- `/prizmkit-committer` has completed
-- `git status --short` is clean (except ignored/local-only pipeline artifacts)
-- `.prizmkit/specs/{{FEATURE_SLUG}}/completion-summary.json` is written
-- the `prizmkit-committer` checkpoint is marked `completed`
-
-At that point, stop immediately. Do **not** process delayed normal-work results, edit files, amend the commit, or start any new tool calls. Code Review must end its optional Reviewer lifecycle before Final Result, so no independent-review response remains pending. Any normal-work result that arrives after S09 is completed is follow-up work for a later session, not part of this feature commit.

package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-agent-suffix.md

@@ -1,24 +0,0 @@
-   - **Section 3 — Key TRAPS & RULES**: extract only relevant TRAPS/RULES from the loaded Prizm docs. Do NOT copy complete documentation files — the orchestrator already loaded them.
-   - **Section 4 — File Manifest**: For each file, list: path, why needed, and a **key-content summary** so you do NOT need to re-read the file. Format depends on file type:
-     - **Code files** (JS/TS/Python/Go): function signatures. Example: `config` (Zod object), `loadConfig(path)→Config`.
-     - **Shell scripts** (`.sh`): command-line args, key behavior branches, sourced libs, critical line ranges. Example: `args: --feature-id; sources lib/common.sh; lines 120-180 worktree logic`.
-     - **Config/manifest** (`package.json`, `tsconfig.json`, `.env`): key scripts/fields/deps/env vars. Example: `scripts:{dev,test}, deps:{vitest}, env:USE_WORKTREE`.
-     - **Docs/README**: section headings + 2-3 relevant sections only.
-     - **Test files**: test names + what each tests (1 line each).
-     Format:
-     ### Files to Modify
-     | File | Why Needed | Key Content Summary |
-     |------|-----------|---------------------|
-     | `<src>/config.js` | Add config layer | `config`, `configSchema`, `loadConfig(p)→Config` |
-     | `dev-pipeline/run-feature.sh` | Remove shell entry | args:--feature-id; lines 120-180 worktree |
-
-     ### Files for Reference
-     | File | Why Needed | Key Content Summary |
-     |------|-----------|---------------------|
-     | `<src>/permission-guard.js` | Perm check | `checkPermission(uid,cmd)→bool` |
-     | `package.json` | Test cmd+deps | scripts:{test:vitest}, deps:{vitest} |
-
-     ### Known TRAPS (from .prizmkit/prizm-docs/)
-     - <trap entries extracted from the loaded Prizm docs>
-
-

package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-lite-suffix.md

@@ -1,12 +0,0 @@
-   - **Section 3 — Key TRAPS & RULES**: extract only relevant TRAPS/RULES from the loaded Prizm docs that apply to files in this scope. Do NOT copy complete documentation files.
-   - **Section 4 — File Manifest**: For each relevant file, list path, why needed, key interface signatures. Use table format:
-
-     ### Files to Modify
-     | File | Why Needed | Key Interfaces |
-     |------|-----------|----------------|
-
-     ### Files for Reference
-     | File | Why Needed | Key Interfaces |
-     |------|-----------|----------------|
-
-

package/bundled/dev-pipeline/templates/sections/phase-implement-agent.md

@@ -1,44 +0,0 @@
-### Implement — Plan Execution
-
-Execute the reviewed plan through the active implementation skill. The skill and runtime determine the execution topology; preserve the shared artifact directory, active checkout, and task checkpoints.
-
-Before starting, check plan.md Tasks:
-```bash
-{{RUNTIME_HELPER_CMD}} text count .prizmkit/specs/{{FEATURE_SLUG}}/plan.md --pattern "- [ ]"
-```
-- If result is `0` (all tasks already `[x]`) → **SKIP to Review**.
-- If non-zero → execute the remaining tasks below.
-
-**Build artifacts rule**: After any build/compile command, ensure output is in `.gitignore`. Never commit binaries/build output.
-
-**3a.** Run `/prizmkit-implement` directly:
-- Continue from the `spec.md` / `plan.md` / `context-snapshot.md` content you created in Phase 1-2; do not re-read self-authored artifacts just because implementation starts
-- Re-read `plan.md` or `context-snapshot.md` only when resuming/continuing, when current context was compacted or lost, or when task checkbox state may have changed outside this session
-- Follow the implementation skill's current execution and delegation contract
-- Use context-snapshot.md Section 4 File Manifest for targeted source reads; avoid re-reading source files already summarized there unless they changed after the snapshot
-- Implements task-by-task, marking each `[x]` immediately
-- Remember to update checkpoints after finishing a series of tasks
-
-**3b. Focused checks only (no test gate here)**:
-- During implementation, do not run mandatory periodic or full-suite tests.
-- If a tiny targeted check is needed to understand a local failure, run only the smallest relevant command and capture output to `/tmp/test-out.txt`.
-- The scoped feature test gate runs after code review; do not declare implementation success based on an early full-suite run.
-
-**3c. Verification Gate Self-Check (BLOCKING — before declaring implement done)**:
-For each Verification Gate from the Task Contract, write one evidence line to Implementation Log:
-```
-### Gate Evidence
-- [x] G1: <gate text> — Evidence: <test name / file:line / fixture path>
-- [ ] G3: <gate text> — BLOCKED: <reason>  ← no evidence = BLOCKED, not success
-```
-
-**3d.** Append `## Implementation Log` (with Gate Evidence) to `context-snapshot.md`:
-- files changed/created
-- key decisions
-- deviations from plan
-- test results
-- Gate Evidence section
-- unresolved blockers
-
-**CP-2**: All tasks `[x]`, Implementation Log written with Gate Evidence, and blocked gates documented in `failure-log.md`. Test execution is deferred until after code review.
-

package/bundled/dev-pipeline/templates/sections/phase-implement-lite.md

@@ -1,25 +0,0 @@
-### Implement
-
-**Protocol references**:
-- Follow Context Budget Rules §8 for scaffold/generated files.
-- Follow Context Budget Rules §9 before package install/build commands that resolve dependencies.
-- Follow Context Budget Rules §10 after build/compile commands.
-
-**3a.** Run `/prizmkit-implement` — this handles the implementation cycle:
-- Continue from the plan/context you just created; do not re-read self-authored artifacts just because implementation starts
-- Re-read plan.md or `context-snapshot.md` only when resuming/continuing, when current context was compacted or lost, or when task checkbox state may have changed outside this session
-- If implementation is delegated to a subagent, the subagent must read `plan.md` and `context-snapshot.md` before editing
-- Uses context from `context-snapshot.md` (Prizm docs, TRAPS, file manifest) for targeted source reads; avoid re-reading source files already summarized there unless they changed after the snapshot
-- Implements task-by-task, marking each `[x]` immediately
-- Creates/updates detail `.prizm` docs when creating new modules or significantly modifying existing ones — AI selectively decides which modules warrant detail documentation based on complexity and importance
-- Does not run the scoped/full test gate; testing happens after code review in the PrizmKit Test phase
-- Writes '## Implementation Log' to `context-snapshot.md`
-
-**3b.** After implement completes, verify:
-1. All tasks in plan.md are `[x]`
-2. Verify each Verification Gate from the Task Contract using code/file evidence already in context — do NOT re-read files you already wrote
-3. If any gate is unmet or blocked, write `failure-log.md` and stop for recovery
-
-**CP-2**: Implementation may proceed only when all tasks are `[x]` and blocked gates are documented in `failure-log.md`. Test execution is deferred until after code review.
-
-

package/bundled/dev-pipeline/templates/sections/phase-plan-agent.md

@@ -1,20 +0,0 @@
-### Plan & Tasks
-
-```bash
-{{RUNTIME_HELPER_CMD}} artifact exists .prizmkit/specs/{{FEATURE_SLUG}}/plan.md
-```
-
-If missing, run `/prizmkit-plan` with `artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/` to generate `plan.md`:
-- The plan.md should include: architecture — components, interfaces, data flow, files to create/modify, testing approach, and a Tasks section with `[ ]` checkboxes ordered by dependency.
-- Resolve uncertain requirements from the feature description, existing code, and conservative existing-project patterns.
-
-**Database Design Gate** (if feature involves data persistence — new tables, schema changes, new entities):
-Before proceeding past CP-1, verify:
-1. Plan.md Data Model section references existing schema/model files (scan for `*.prisma`, `*.sql`, `migrations/`, `models/`, `*.entity.*` files; read them if not already in context-snapshot)
-2. All new tables/fields follow existing naming conventions, ID strategy, timestamp patterns, and constraint style
-3. No unresolved data model uncertainty remains in the Data Model section — resolve by reading existing code and making a conservative choice that matches existing patterns. Document the resolution in plan.md.
-4. If a DB design decision genuinely cannot be resolved from existing code alone, document the assumption made and flag it in the Implementation Log for user review.
-
-**CP-1**: plan.md exists with Tasks section.
-
-

package/bundled/dev-pipeline/templates/sections/phase-plan-lite.md

@@ -1,20 +0,0 @@
-### Plan & Tasks
-
-```bash
-{{RUNTIME_HELPER_CMD}} artifact exists .prizmkit/specs/{{FEATURE_SLUG}}
-```
-
-If plan.md missing, run `/prizmkit-plan` with `artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/`:
-- Pass the Objective and Verification Gates from the Task Contract as input
-- The plan.md should include: key components, data flow, files to create/modify, and a Tasks section with `[ ]` checkboxes (each task = one implementable unit). Keep under 80 lines.
-- Resolve uncertain requirements from the feature description, existing code, and conservative existing-project patterns.
-
-**Database Design Gate** (if feature involves data persistence — new tables, schema changes, new entities):
-Before proceeding past CP-1:
-1. Scan for existing schema files (`*.prisma`, `*.sql`, `migrations/`, `models/`, `*.entity.*`) and read them
-2. Ensure new tables/fields follow existing naming conventions and constraint patterns
-3. Resolve all uncertain DB design decisions before writing Tasks — document choices in plan.md
-
-**CP-1**: plan.md exists with Tasks section.
-
-

package/bundled/dev-pipeline/templates/sections/phase-review-agent.md

@@ -1,20 +0,0 @@
-### Review — Code Review
-
-Review the completed implementation before the scoped feature test gate runs. Use `artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/` so `/prizmkit-code-review` can read the spec, plan, context snapshot, implementation log, and current diff. Follow the skill's current review contract for review execution, repairs, verification, evidence, and handoff. Do not invoke another review skill or add a second review path outside that contract.
-
-Missing required evidence, an unsafe repair, a failed verification, or failure to converge by the contract's review limit produces `NEEDS_FIXES`.
-
-**Gate Check — Final Review Result**:
-
-```bash
-{{RUNTIME_HELPER_CMD}} text final-verdict .prizmkit/specs/{{FEATURE_SLUG}}/review-report.md
-```
-
-Handle the marker:
-
-- `REVIEW_PASS` → proceed to next phase.
-- `REVIEW_NEEDS_FIXES` → log unresolved findings and follow the task failure policy; do not externally restart the review loop.
-- `REVIEW_INCOMPLETE` or `REVIEW_INVALID` → inspect the append-only progress once, write `failure-log.md`, and stop. Do not treat an old or incidental verdict as completion and do not synthesize a passing result outside the skill.
-
-**CP-3**: Review has a valid Final Result and `review-report.md` preserves this execution's progress.
-

package/bundled/dev-pipeline/templates/sections/refactor-artifacts.md

@@ -1,17 +0,0 @@
-## Refactor Artifacts Directory
-
-Use only this durable artifact directory for this refactor:
-
-```text
-.prizmkit/refactor/{{REFACTOR_ID}}/
-├── spec.md
-├── plan.md
-├── context-snapshot.md
-├── review-report.md
-├── refactor-report.md
-├── completion-summary.json
-├── failure-log.md
-└── workflow-checkpoint.json
-```
-
-Do not write refactor artifacts under feature or bugfix artifact directories.

package/bundled/dev-pipeline/templates/sections/refactor-session-status.md

@@ -1,28 +0,0 @@
-### Step 3: Report Session Status
-
-Before exiting, write the session status file:
-
-`{{SESSION_STATUS_PATH}}`
-
-```json
-{
-  "session_id": "{{SESSION_ID}}",
-  "refactor_id": "{{REFACTOR_ID}}",
-  "status": "<success|partial|failed>",
-  "completed_phases": [1, 2, 3, 4],
-  "current_phase": 4,
-  "checkpoint_reached": "<current checkpoint step>",
-  "errors": [],
-  "can_resume": false,
-  "resume_from_phase": null,
-  "artifacts": {
-    "spec_path": ".prizmkit/refactor/{{REFACTOR_ID}}/spec.md",
-    "plan_path": ".prizmkit/refactor/{{REFACTOR_ID}}/plan.md",
-    "report_path": ".prizmkit/refactor/{{REFACTOR_ID}}/refactor-report.md",
-    "completion_summary_path": ".prizmkit/refactor/{{REFACTOR_ID}}/completion-summary.json"
-  },
-  "git_commit": "<commit hash>",
-  "behavior_preserved": true,
-  "timestamp": "{{TIMESTAMP}}"
-}
-```

package/bundled/dev-pipeline/templates/sections/test-failure-recovery-agent.md

@@ -1,52 +0,0 @@
-## Test Failure Recovery Protocol
-
-Use this protocol whenever the post-review PrizmKit Test gate fails. Its purpose is to distinguish tolerated pre-existing failures from blockers introduced by this session.
-
-### Failure Classes
-
-| Class | Meaning | Required Action | May Continue? |
-|-------|---------|-----------------|---------------|
-| Baseline failure | Existed before this session | Document in the Implementation Log or `failure-log.md` | Yes |
-| New regression | Introduced by this session | Fix before reporting success | No |
-| Brittle test | Test expectation/setup is wrong for the intended behavior | Fix the test or environment setup, then rerun | Only after fixed or documented as blocked |
-| Environment/tooling failure | External tool, network, install, or local environment prevents verification | Document in `failure-log.md` with impact on gates | Only if no Verification Gate is blocked |
-
-### Recovery Loop
-
-1. Run tests and record: failing test names, failure count, and class for each failure.
-2. Compare with `BASELINE_FAILURES`; never blame baseline failures on this feature.
-3. Fix new regressions and brittle tests while progress is being made.
-4. Stop after a plateau: same failure count and same failing tests for 3 consecutive rounds.
-5. If failures decrease, reset the plateau counter.
-
-### Hard Round Cap (BLOCKING)
-
-After **6 total test-fix rounds**, STOP trial-and-error. Write failure-log listing all hypotheses tried. Switch to: locate an anchor with `{{RUNTIME_HELPER_CMD}} text search <file> --pattern "<anchor>" --json`, read one bounded relevant source section with the platform file-reading tool (never full Read), understand control flow, rewrite failing block in one shot. Do NOT exceed 7 total rounds.
-
-### Success Rule
-
-Proceed to retrospective/commit only when:
-
-1. all new regressions are fixed;
-2. baseline failures are documented;
-3. every Verification Gate is verified.
-
-Blocked gates are not success. If any gate cannot be verified, follow the Blocked Rule.
-
-### Blocked Rule
-
-If a remaining failure prevents any Verification Gate from being verified, the feature is incomplete. Write `failure-log.md` and do not report success.
-
-### Failure Capture Format
-
-```markdown
-## Test Failures Encountered
-
-- **Test**: [test name/path]
-  - Root Cause: [explanation]
-  - Category: [baseline failure | new regression | brittle test | environment/tooling]
-  - Rounds Attempted: [N rounds, plateau at round M]
-  - Status: [fixed | still failing | blocked]
-
-- **Impact on Verification Gates**: [verified | not affected | blocked + reason]
-```

package/bundled/dev-pipeline/templates/sections/test-failure-recovery-lite.md

@@ -1,52 +0,0 @@
-## Test Failure Recovery Protocol
-
-Use this protocol whenever the post-review PrizmKit Test gate fails. Its purpose is to distinguish tolerated pre-existing failures from blockers introduced by this session.
-
-### Failure Classes
-
-| Class | Meaning | Required Action | May Continue? |
-|-------|---------|-----------------|---------------|
-| Baseline failure | Existed before this session | Document in Implementation Log | Yes |
-| New regression | Introduced by this session | Fix before reporting success | No |
-| Brittle test | Test expectation/setup is wrong for the intended behavior | Fix the test or environment setup, then rerun | Only after fixed or documented as blocked |
-| Environment/tooling failure | External tool, network, install, or local environment prevents verification | Document in `failure-log.md` with impact on gates | Only if no Verification Gate is blocked |
-
-### Recovery Loop
-
-1. Run tests and record: failing test names, failure count, and class for each failure.
-2. Compare with `BASELINE_FAILURES`; never blame baseline failures on this feature.
-3. Fix new regressions and brittle tests while progress is being made.
-4. Stop after a plateau: same failure count and same failing tests for 3 consecutive rounds.
-5. If failures decrease, reset the plateau counter.
-
-### Hard Round Cap (BLOCKING)
-
-After **6 total test-fix rounds**, STOP trial-and-error. Write failure-log listing all hypotheses tried. Switch to: locate an anchor with `{{RUNTIME_HELPER_CMD}} text search <file> --pattern "<anchor>" --json`, read one bounded relevant source section with the platform file-reading tool (never full Read), understand control flow, rewrite failing block in one shot. Do NOT exceed 7 total rounds.
-
-### Success Rule
-
-Proceed only when:
-
-1. all new regressions are fixed;
-2. baseline failures are documented;
-3. every Verification Gate is verified.
-
-Blocked gates are not success. If any gate cannot be verified, follow the Blocked Rule.
-
-### Blocked Rule
-
-If a remaining failure prevents any Verification Gate from being verified, the feature is incomplete. Write `failure-log.md` and do not report success.
-
-### Failure Capture Format
-
-```markdown
-## Test Failures Encountered
-
-- **Test**: [test name/path]
-  - Root Cause: [explanation]
-  - Category: [baseline failure | new regression | brittle test | environment/tooling]
-  - Rounds Attempted: [N rounds, plateau at round M]
-  - Status: [fixed | still failing | blocked]
-
-- **Impact on Verification Gates**: [verified | not affected | blocked + reason]
-```