maestro-flow 0.5.36 → 0.5.38

package/dist/src/utils/cli-format.js

@@ -62,33 +62,44 @@ export function truncateForHistory(s, max) {
     return s.length <= max ? s : s.substring(0, max) + '\u2026[truncated]';
 }
 /**
- * Extract the first body line containing a query term, prefixed with its
- * line number (e.g. "L12: matched context..."). Used by wiki/search output
- * to show the matched context rather than only the summary.
+ * Extract the best-matching body line for a query, prefixed with its line
+ * number (e.g. "L12: matched context..."). Scores lines by query-term
+ * coverage so multi-term queries surface the most informative line.
  */
-export function extractSnippet(body, query, maxLen = 50, highlight = false) {
+export function extractSnippet(body, query, maxLen = 80, highlight = false) {
     if (!body || !query)
         return null;
-    const lower = body.toLowerCase();
     const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
-    for (const term of terms) {
-        const idx = lower.indexOf(term);
-        if (idx === -1)
+    if (terms.length === 0)
+        return null;
+    const lines = body.split('\n');
+    let bestIdx = -1;
+    let bestScore = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (!trimmed)
             continue;
-        let line = 1;
-        for (let i = 0; i < idx; i++)
-            if (body[i] === '\n')
-                line++;
-        const ls = body.lastIndexOf('\n', idx) + 1;
-        const le = body.indexOf('\n', idx);
-        let raw = body.slice(ls, le === -1 ? body.length : le).trim();
-        if (raw.length > maxLen)
-            raw = raw.slice(0, maxLen) + '...';
-        if (highlight)
-            raw = highlightTerms(raw, terms);
-        return `L${line}: ${raw}`;
+        const lower = trimmed.toLowerCase();
+        let score = 0;
+        for (const term of terms) {
+            if (lower.includes(term))
+                score++;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestIdx = i;
+        }
     }
-    return null;
+    if (bestIdx === -1)
+        return null;
+    let raw = lines[bestIdx].trim();
+    raw = raw.replace(/^#+\s+/, '');
+    raw = raw.replace(/^[-*]\s+/, '');
+    if (raw.length > maxLen)
+        raw = raw.slice(0, maxLen) + '...';
+    if (highlight)
+        raw = highlightTerms(raw, terms);
+    return `L${bestIdx + 1}: ${raw}`;
 }
 export function highlightTerms(text, terms) {
     if (!terms.length)

package/dist/src/utils/cli-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-format.js","sourceRoot":"","sources":["../../../src/utils/cli-format.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-format.js","sourceRoot":"","sources":["../../../src/utils/cli-format.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/update-notices.js

@@ -347,4 +347,16 @@ registerNotice({
     ],
     actions: [],
 });
+registerNotice({
+    version: '0.5.38',
+    title: 'Dashboard 入口恢复 + Install TUI 重构 + 反漂移防护',
+    highlights: [
+        '恢复 maestro view/stop 命令，前端 dashboard 入口重新启用',
+        'install TUI 重构：平台驱动安装 + update 迁移修复',
+        '新增 manage-drift-realign 命令 + maestro timeline CLI',
+        'ralph 反漂移 4 层防护 + 目标热修改 --amend',
+        'codex 完整移植 re-grounding 子系统',
+    ],
+    actions: [],
+});
 //# sourceMappingURL=update-notices.js.map

package/dist/src/utils/update-notices.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-notices.js","sourceRoot":"","sources":["../../../src/utils/update-notices.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update-notices.js","sourceRoot":"","sources":["../../../src/utils/update-notices.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maestro-flow",
-  "version": "0.5.36",
+  "version": "0.5.38",
   "description": "Intent-driven workflow orchestration for multi-agent AI development with adaptive lifecycle engine and self-reinforcing knowledge graph",
   "type": "module",
   "imports": {

package/shared/agent-types.ts

@@ -31,6 +31,8 @@ export interface AgentConfig {
   approvalMode?: 'suggest' | 'auto';
   baseUrl?: string;
   apiKey?: string;
+  /** API format for api-explore: 'openai' (default) or 'anthropic' */
+  format?: 'openai' | 'anthropic';
   settingsFile?: string;
   /** Path to .env file for loading environment variables before spawn */
   envFile?: string;

package/workflows/agy-instructions.md

@@ -1,122 +1,161 @@
-# Maestro for Antigravity CLI
+# Codex Code Guidelines
 
-- **Coding Philosophy**: @~/.maestro/workflows/coding-philosophy.md
-
-## Delegate & CLI
 
 - **Delegate Usage**: @~/.maestro/workflows/delegate-usage.md
+- **Explore Usage**: @~/.maestro/workflows/explore-usage.md
 - **CLI Endpoints Config**: @~/.maestro/cli-tools.json
 
 **Strictly follow the cli-tools.json configuration**
 
-## Antigravity Tool Priority
-
-When choosing between equivalent tools, prefer the agy native primitives over shell fallbacks:
-
-| Need | Prefer | Fallback |
-|------|--------|----------|
-| Read a file | `view_file(AbsolutePath, StartLine, EndLine)` | `run_command("Get-Content ...")` |
-| Read external URL | `read_url_content(Url)` | `run_command("curl ...")` |
-| Create / overwrite file | `write_to_file(TargetFile, CodeContent, Overwrite)` | n/a |
-| Single-block edit | `replace_file_content(TargetFile, StartLine, EndLine, TargetContent, ReplacementContent)` | n/a |
-| Multi-block edit on same file | `multi_replace_file_content(TargetFile, ReplacementChunks=[...])` | repeated `replace_file_content` |
-| Search text | `grep_search(SearchPath, Query, IsRegex, Includes)` | `run_command("rg ...")` |
-| List directory | `list_dir(DirectoryPath)` | `run_command("ls ...")` |
-| Execute shell | `run_command(CommandLine, Cwd, WaitMsBeforeAsync)` | n/a |
-| Web search | `search_web(query, domain)` | n/a |
-| Ask user | `ask_question(questions=[{question, options, is_multi_select}])` | n/a |
-
-Always pass `Cwd` to `run_command`; do not rely on inherited shell cwd. On Windows, set UTF-8 in PowerShell before chained commands:
-
-```powershell
-[Console]::InputEncoding  = [Text.UTF8Encoding]::new($false)
-[Console]::OutputEncoding = [Text.UTF8Encoding]::new($false)
-chcp 65001 > $null
-```
-
-## Sub-Agent Orchestration (Two Phases)
+## Explore Priority
 
-Antigravity uses an explicit two-phase model for sub-agents — unlike Claude's single `Agent(...)` call:
+`maestro explore` takes priority over Glob, Grep, and Read. When locating files or searching code patterns, call `maestro explore` first and stop to wait for results.
 
-1. **Define**: declare the sub-agent type once per session (idempotent within a session)
-   ```
-   define_subagent(
-     name="team-worker",
-     description="Generic role-spec worker",
-     system_prompt="<contents of antigravity-cli/agents/team-worker.md>",
-     enable_write_tools=true,
-     enable_mcp_tools=true,
-     enable_subagent_tools=false
-   )
-   ```
+# Coding Philosophy
 
-2. **Invoke**: spawn one or more instances; capture the returned ConversationId for later messaging
-   ```
-   invoke_subagent([
-     { TypeName: "team-worker",
-       Role:     "<concrete role label>",
-       Prompt:   "<task-specific instructions>",
-       Workspace: "inherit"            # inherit | branch | share
-     }
-   ])
-   ```
+## Core Beliefs
 
-**Workspace modes**:
-- `inherit` — share the parent's working directory (default; matches Claude semantics)
-- `branch` — independent filesystem branch (useful for parallel waves that must not collide)
-- `share` — explicit cross-worker sharing (rare; use only when workers must atomically see each other's writes)
+- **Pursue good taste** - Eliminate edge cases to make code logic natural and elegant
+- **Embrace extreme simplicity** - Complexity is the root of all evil
+- **Be pragmatic** - Code must solve real-world problems, not hypothetical ones
+- **Data structures first** - Bad programmers worry about code; good programmers worry about data structures
+- **Never break backward compatibility** - Existing functionality is sacred and inviolable
+- **Incremental progress over big bangs** - Small changes that compile and pass tests
+- **Learning from existing code** - Study and plan before implementing
+- **Clear intent over clever code** - Be boring and obvious
+- **Follow existing code style** - Match import patterns, naming conventions, and formatting of existing codebase
+- **Minimize changes** - Only modify what's directly required; avoid refactoring, adding features, or "improving" code beyond the request
+- **No unsolicited documentation** - NEVER generate reports, documentation files, or summaries without explicit user request. If required, save to .workflow/.scratchpad/
 
-**Inter-agent messaging**: `send_message(Recipient=<ConversationId>, Message=<text>)`. The Recipient must be a ConversationId returned by `invoke_subagent`, never a role name.
+## Simplicity Means
 
-**Background OS tasks vs sub-agents**: `manage_task` handles `run_command` async instances (list / kill / status / send_input). Do **not** repurpose it for named task tracking — use `.workflow/tasks/<id>.json` files instead.
+- Single responsibility per function/class
+- Avoid premature abstractions
+- No clever tricks - choose the boring solution
+- If you need to explain it, it's too complex
 
-## Cross-Skill Invocation
+## Fix, Don't Hide
 
-Agent-internal chaining uses the **inline-execute** pattern:
+**Solve problems, don't silence symptoms** - Skipped tests, `@ts-ignore`, empty catch, `as any`, excessive timeouts = hiding bugs, not fixing them
 
-```
-view_file(AbsolutePath="<agy-skills-dir>/<target-skill>/SKILL.md") + execute inline (args: "...")
-```
+**NEVER**:
+- Make assumptions - verify with existing code
+- Generate reports, summaries, or documentation files without explicit user request
+- Use suppression mechanisms (`skip`, `ignore`, `disable`) without fixing root cause
 
-`<agy-skills-dir>` resolves to:
-- global install: `~/.gemini/antigravity-cli/skills/`
-- workspace install: `<project>/.agents/skills/`
+**ALWAYS**:
+- Plan complex tasks thoroughly before implementation
+- Generate task decomposition for multi-module work (>3 modules or >5 subtasks)
+- Track progress using TODO checklists for complex tasks
+- Validate planning documents before starting development
+- Commit working code incrementally
+- Update plan documentation and progress tracking as you go
+- Learn from existing implementations
+- Stop after 3 failed attempts and reassess
+- **Edit fallback**: When Edit tool fails 2+ times on same file, try Bash sed/awk first, then Write to recreate if still failing
 
-The agent reads the target SKILL.md, treats its body as additional instructions, and executes them in the same conversation context. Args are passed conceptually as input variables — substitute them when running the loaded instructions.
+## Learning the Codebase
 
-User-initiated invocation uses `/skills`.
+- Find 3 similar features/components
+- Identify common patterns and conventions
+- Use same libraries/utilities when possible
+- Follow existing test patterns
 
-## Cross-Worker Coordination
+## Tooling
 
-Antigravity has no built-in message bus. For shared logs across workers, write JSONL lines to `.workflow/.team/<session>/.msg/messages.jsonl`:
+- Use project's existing build system
+- Use project's test framework
+- Use project's formatter/linter settings
+- Don't introduce new tools without strong justification
 
-- Log:   `write_to_file(TargetFile=".workflow/.team/<session>/.msg/messages.jsonl", CodeContent="<json line>\n", Overwrite=false)`
-- Read:  `view_file(AbsolutePath=".workflow/.team/<session>/.msg/messages.jsonl")` then filter client-side
-- Status snapshot: write `<session>/.msg/state.json` and read with `view_file`
+## Content Uniqueness Rules
 
-For point-to-point delivery, use `send_message` directly.
+- **Each layer owns its abstraction level** - no content sharing between layers
+- **Reference, don't duplicate** - point to other layers, never copy content
+- **Maintain perspective** - each layer sees the system at its appropriate scale
+- **Avoid implementation creep** - higher layers stay architectural
 
-## Code Diagnostics
+# Context Requirements
 
-- **Prefer `mcp__ide__getDiagnostics`** for code error checking over shell-based TypeScript compilation when the MCP channel is available.
+Before implementation, always:
+- Identify 3+ existing similar patterns
+- Map dependencies and integration points
+- Understand testing framework and coding conventions
 
 ## Knowledge System
 
-### Search — Query Before Acting
+**Gate rule: On any coding/modification/debugging task, run `maestro search` + `maestro load` BEFORE reading code or editing files.**
+
+### Required (every task, no exceptions)
+
+```bash
+# Search relevant knowledge (1-3 keywords, multiple short queries beat one long one)
+maestro search "<topic phrase>"
+
+# Load specs for the task type
+maestro load --type spec --category coding    # coding tasks
+maestro load --type spec --category arch      # architecture decisions
+maestro load --type spec --category test      # test writing
+maestro load --type spec --category ui        # UI work
+```
+
+**Query rules:**
+- Use **1-3 core keywords** per query — never dump all context into one search
+- Separate concepts from symbols: `maestro search "topology layout"` + `maestro search "DetailedTopologySVG" --code`
+- Add as needed: `maestro search "query" --kg` (KG full-source), `maestro kg callers <fn>` (call chain), `maestro kg context <node>` (node context)
+
+```bash
+# ❌ Bad: keyword dump
+maestro search "topology display frontend DetailedTopologySVG elk"
 
-**Before planning or implementing any task, search wiki and spec first** — the knowledge base contains reusable methods, tools, and hard-won experience. Load the right knowledge at the right time: search before you plan, load relevant entries before you implement, and revisit when you hit unfamiliar territory mid-task.
+# ✅ Good: targeted multi-search + spec load
+maestro search "topology layout"
+maestro search "DetailedTopologySVG" --code
+maestro load --type spec --category coding
+```
+
+### Load & Search reference
+
+```bash
+maestro load --type <type> [--list] [--category <cat>] [--keyword <word>] [--id <id>]
+maestro search "<query>" [--type <type>] [--category <cat>] [--code] [--kg] [--json]
+```
+
+**`--category` values** (for `--type spec`): `coding`, `arch`, `debug`, `test`, `review`, `learning`, `ui`
+**`--keyword`**: free-text filter on title/body/tags — use to narrow within a category
+
+**`--type` values**: `spec`, `knowhow`, `domain`, `issue`, `session`, `scratch`, `note`, `project`, `roadmap`
 
-When tackling unfamiliar domains or cross-cutting concerns, search existing knowledge first:
-- `maestro spec load --category <cat>` — load rules by category (coding/arch/debug/test/review/learning)
-- `maestro spec load --keyword <kw>` — cross-category keyword match
-- `maestro wiki search "<query>"` — full-text search across all knowhow
-- `maestro wiki list --category <cat>` → `maestro wiki load <id>` — browse then load full detail
+| Action | Command |
+|--------|---------|
+| Load coding specs | `maestro load --type spec --category coding` |
+| Load arch specs with keyword | `maestro load --type spec --category arch --keyword auth` |
+| List sessions | `maestro load --type session --list` |
+| Load specific knowhow | `maestro load --type knowhow --id <id>` |
+| Search sessions | `maestro search "query" --type session` |
+| Code graph search | `maestro search "symbol" --code` |
+| KG full-source search | `maestro search "query" --kg` |
 
-### Record — Capture Knowledge
+### Record
 
-When execution surfaces non-obvious knowledge (decisions, root causes, pitfalls, patterns), persist it:
+| What | Command |
+|------|---------|
+| Spec | `/spec-add <category> "title" "content" --keywords kw1,kw2 --description "summary"` |
+| Knowhow | `/manage-knowhow-capture` (`--spec-category <cat>` to bridge into agent injection) |
+
+Category routing: decisions→`arch`, patterns→`coding`, pitfalls→`debug`/`learning`, rules→`review`, tests→`test`.
+
+### Confidence & Conflict Marking
+
+When search results conflict with current context, **mark the entry**:
+
+```bash
+maestro spec conflict mark <file> <line> --note "<reason>"
+maestro spec conflict list
+```
 
-- **Spec entry** (short rule/constraint) → `/spec-add <category> "title" "content" --keywords kw1,kw2 --description "summary"`
-- **Knowhow document** (detailed recipe/template/decision/reference) → `/manage-knowhow-capture`
+Levels: `high` (verified) → `medium` (default) → `low` (stale) → `contested` (conflict detected).
 
-Category routing: decisions→`arch`, patterns→`coding`, pitfalls→`debug`/`learning`, rules→`review`, test strategy→`test`.
+- `contested` → sorted last during injection, labeled `[CONTESTED]` with conflict note
+- `low` → labeled `[LOW CONFIDENCE]`
+- Resolution handled by `/manage-knowledge-audit`

package/workflows/analyze.md

@@ -316,7 +316,7 @@ Append initial Intent Coverage Check to discussion.md.
 
 **Step 4.6: Baseline Confidence Scoring**
 
-Dimensions = the 6 analysis dimensions. Factors (weights): findings_depth(.30), evidence_strength(.25), coverage_breadth(.20), user_validation(.15), consistency(.10). Score each factor per dimension from Round 1 results. Append baseline confidence table to discussion.md. Thresholds: <60% 继续深入 | 60-80% 需用户确认收敛 | >80% 建议收敛.
+Dimensions = the 6 analysis dimensions. Factors (weights): findings_depth(.30), evidence_strength(.25), coverage_breadth(.20), user_validation(.15), consistency(.10). Score each factor per dimension from Round 1 results. Append baseline confidence table to discussion.md. Thresholds: <60% 继续深入 | 60-80% 需用户确认收敛 | >80% → proceed to synthesis (REQUIRED convergence threshold).
 
 ### Step 5: Interactive Discussion Loop
 
@@ -764,7 +764,7 @@ Replaceable blocks (overwritten each round):
 | Error | Resolution |
 |-------|------------|
 | cli-explore-agent fails | Retry once. If still fails: log W001 warning in discussion.md, flag all subsequent decisions as LOW CONFIDENCE (evidence gap), continue with available context |
-| CLI timeout | Retry with shorter prompt, or skip perspective |
+| CLI timeout | Retry with shorter prompt; if still fails, mark perspective [LOW CONFIDENCE] (evidence gap) in discussion.md and continue |
 | Max rounds reached | Force synthesis, offer continuation |
 | No relevant findings | Broaden search, ask user for clarification |
 | Session folder conflict | Append timestamp suffix |

package/workflows/auto-test.md

@@ -26,6 +26,7 @@ Only Step 2 diverges (scenario source). Everything else is shared.
 
 **Load specs:**
 ```
+# MANDATORY, NOT SUBSTITUTABLE by manual Read/Grep
 specs_test = maestro spec load --category test
 specs_arch = maestro spec load --category arch
 ```
@@ -348,7 +349,7 @@ Build layer-L{N}-write.csv:
   prev_context = findings from completed prior-layer scenarios (cross-layer propagation)
 ```
 
-#### 5b. Parallel Test Writing via spawn_agents_on_csv
+#### 5b. Parallel Test Writing via spawn_agents_on_csv — MANDATORY, NOT SUBSTITUTABLE
 
 ```javascript
 spawn_agents_on_csv({
@@ -385,6 +386,8 @@ Merge write-results into master state. Delete temp CSV. Proceed to next layer or
 
 **If `--max-iter 1`:** After all layers written and run once, jump directly to Step 8 (single-pass mode, replaces test-gen behavior). Skip Steps 6-7.
 
+**GATE Step 5→6**: write-results merged into master state BEFORE execution; REQUIRED: `.tests/auto-test/.csv-session/layer-L*-write-results.csv` merged and temp CSV deleted; BLOCKED if write-results missing or unmerged.
+
 ---
 
 ### Step 6: Execute (Progressive Layers)
@@ -424,6 +427,7 @@ OUTER LOOP (max_iter iterations):
          Build diagnosis-iter-{N}.csv:
            Columns: id, scenario_id, layer, test_file, error_detail, expected, actual, target_file, source_context
 
+         # MANDATORY, NOT SUBSTITUTABLE by manual Read/Grep
          spawn_agents_on_csv({
            csv_path: `.tests/auto-test/.csv-session/diagnosis-iter-${iter}.csv`,
            id_column: "id",
@@ -612,6 +616,8 @@ Scored after each REFLECT step. Dimensions (5): scenario_coverage, test_quality,
 | `.tests/business/business-test-report.json` | `.tests/auto-test/report.json` (source_route: "spec") |
 | `.tests/business/business-test-summary.md` | `.tests/auto-test/traceability.md` (conditional) |
 
+**GATE Step 8→9**: Glob `.tests/auto-test/report.json` MUST exist before Step 9 post-processing; BLOCKED if missing.
+
 ---
 
 ### Step 9: Post-Processing & Routing

package/workflows/blueprint.md

@@ -14,6 +14,9 @@ brainstorm (parallel) → blueprint → analyze → plan
 P0: Spec Study → P1: Discovery → P1.5: Req Expansion → P2: Product Brief → P3: PRD → P4: Architecture → P5: Epics → P6: Readiness Check
 
 P6 gate: Pass (>=80%) → Handoff | Review (60-79%) → Handoff w/caveats | Fail (<60%) → P6.5 Auto-Fix (max 2 iter) → re-check
+
+GATE P2→P3: REQUIRED `product-brief.md` written with ≥5 glossary terms in `glossary.json`; BLOCKED if `product-brief.md` missing or glossary < 5 terms.
+GATE P3→P4: REQUIRED `requirements/_index.md` written with MoSCoW priority table; BLOCKED if `_index.md` missing or MoSCoW table absent.
 ```
 
 ## Arguments
@@ -103,7 +106,7 @@ Session ID: BLP-{slug}-{YYYY-MM-DD}
 Output dir: .workflow/blueprint/{session_id}/
 ```
 
-**Step 2.3: Seed Analysis via CLI**
+**Step 2.3: Seed Analysis via CLI** — MANDATORY, NOT SUBSTITUTABLE
 - Spawn CLI analysis to extract: problem_statement, target_users, domain, constraints, dimensions (3-5)
 - Assess complexity: simple (1-2 components) / moderate (3-5) / complex (6+)
 - For context-package input: enrich with feature decomposition data
@@ -160,7 +163,7 @@ Generate product brief through multi-perspective CLI analysis.
 - Read discovery-context.json (if codebase detected)
 - For context-package input: read context-package.json domain and requirements sections
 
-**Step 4.2: Multi-CLI Parallel Analysis (3 perspectives)**
+**Step 4.2: Multi-CLI Parallel Analysis (3 perspectives)** — MANDATORY, NOT SUBSTITUTABLE
 
 | Perspective | Role | Focus |
 |-------------|------|-------|
@@ -189,7 +192,7 @@ Generate product brief through multi-perspective CLI analysis.
 
 Generate detailed PRD with functional/non-functional requirements.
 
-**Step 5.1: Requirement Expansion via CLI**
+**Step 5.1: Requirement Expansion via CLI** — MANDATORY, NOT SUBSTITUTABLE
 - For each product brief goal, generate 3-7 functional requirements
 - Each requirement: REQ-NNN ID, title, description, user story, 2-4 acceptance criteria
 - Generate non-functional requirements: performance, security, scalability, usability
@@ -214,12 +217,12 @@ Generate detailed PRD with functional/non-functional requirements.
 
 Generate architecture decisions, component design, and technology selections.
 
-**Step 6.1: Architecture Analysis via CLI (role: review)**
+**Step 6.1: Architecture Analysis via CLI (role: review)** — MANDATORY, NOT SUBSTITUTABLE
 - System architecture style with justification
 - Core components and responsibilities
 - Component interaction diagram (Mermaid graph TD)
 - Technology stack: languages, frameworks, databases, infrastructure
-- 2-4 Architecture Decision Records (ADRs): context, decision, alternatives, consequences
+- 2-4 Architecture Decision Records (ADRs): context, decision, alternatives, consequences, evidence_source
 - Data model: entities and relationships (Mermaid erDiagram)
 - Security architecture: auth, authorization, data protection
 - **State machine**: ASCII diagram + transition table for lifecycle entities (service/platform type)
@@ -230,7 +233,7 @@ Generate architecture decisions, component design, and technology selections.
 - Glossary injection for terminology consistency
 - If `apiResearchContext` is set: inject as "External API Research" context
 
-**Step 6.2: Architecture Review via CLI (role: review)**
+**Step 6.2: Architecture Review via CLI (role: review)** — MANDATORY, NOT SUBSTITUTABLE
 - Challenge each ADR, identify scalability bottlenecks
 - Assess security gaps, evaluate technology choices
 - Rate overall quality 1-5
@@ -252,7 +255,7 @@ Generate architecture decisions, component design, and technology selections.
 
 Decompose specification into executable Epics and Stories.
 
-**Step 7.1: Epic Decomposition via CLI**
+**Step 7.1: Epic Decomposition via CLI** — MANDATORY, NOT SUBSTITUTABLE
 - Group requirements into logical Epics (EPIC-NNN IDs). Epic count is unconstrained — downstream workflows will merge Epics into minimal phases via the minimum-phase principle.
 - Tag MVP subset
 - For each Epic: 2-5 Stories in "As a...I want...So that..." format
@@ -280,7 +283,7 @@ Decompose specification into executable Epics and Stories.
 
 Validate specification package and provide execution handoff.
 
-**Step 8.1: Cross-Document Validation via CLI**
+**Step 8.1: Cross-Document Validation via CLI** — MANDATORY, NOT SUBSTITUTABLE
 Score on 4 dimensions (25% each):
 1. **Completeness**: all required sections present with substantive content
 2. **Consistency**: terminology uniform (glossary compliance), scope containment, non-goals respected
@@ -390,14 +393,14 @@ Resume: `-c` reads blueprint-config.json, resumes from first incomplete phase.
 | Phase | Error | Blocking? | Action |
 |-------|-------|-----------|--------|
 | Phase 1 | Empty input | Yes | Error and exit |
-| Phase 1 | CLI analysis fails | No | Basic parsing fallback |
-| Phase 1.5 | Gap analysis fails | No | Skip to basic prompts |
-| Phase 2 | Single CLI fails | No | Continue with available |
-| Phase 3 | Gemini fails | No | Codex fallback |
-| Phase 4 | Review fails | No | Skip review |
-| Phase 5 | Story generation fails | No | Generate epics only |
-| Phase 6 | Validation fails | No | Partial report |
-| Phase 6.5 | Max iterations (2) | No | Force handoff |
-| Step 2.5 | External research fails | No | apiResearchContext = null, continue |
-
-CLI Fallback Chain: Role-based resolution → degraded mode (local only)
+| Phase 1 | CLI analysis fails | No | Basic parsing fallback; flag seed_analysis as [LOW CONFIDENCE] (CLI analysis unavailable) |
+| Phase 1.5 | Gap analysis fails | No | Skip to basic prompts; flag refined-requirements.json as [LOW CONFIDENCE] (no gap analysis) |
+| Phase 2 | Single CLI fails | No | Continue with available; flag product-brief.md as [LOW CONFIDENCE] (missing perspective) |
+| Phase 3 | Gemini fails | No | Codex fallback; flag affected REQ-NNN.md as [LOW CONFIDENCE] (model fallback) |
+| Phase 4 | Review fails | No | Skip review; flag ADR-NNN.md as [LOW CONFIDENCE] (no peer review) |
+| Phase 5 | Story generation fails | No | Generate epics only; flag EPIC-NNN.md stories as [LOW CONFIDENCE] (stories incomplete) |
+| Phase 6 | Validation fails | No | Partial report; flag readiness-report.md as [LOW CONFIDENCE] (validation incomplete) |
+| Phase 6.5 | Max iterations (2) | No | Force handoff; flag readiness-report.md as [LOW CONFIDENCE] (auto-fix exhausted) |
+| Step 2.5 | External research fails | No | apiResearchContext = null, continue; flag apiResearchContext as [LOW CONFIDENCE] (no external research) |
+
+CLI Fallback Chain: Role-based resolution → degraded mode (local only); flag affected phase artifacts as [LOW CONFIDENCE] (CLI unavailable, local-only analysis)