@sienklogic/plan-build-run 2.0.0 → 2.0.2

package/plugins/pbr/templates/INTEGRATION-REPORT.md.tmpl

@@ -1,151 +1,151 @@
-<!-- Source: agents/integration-checker.md | Purpose: Output format for cross-phase integration verification reports -->
-
-```markdown
-# Integration Verification Report
-
-> Verified: {date}
-> Phases checked: {comma-separated list of phase IDs}
-> Status: **{INTEGRATED | GAPS_FOUND}**
-
-## Phase Dependency Graph
-
-```
-Phase 01 (Setup) ──provides──→ Phase 02 (Auth)
-Phase 01 (Setup) ──provides──→ Phase 03 (Core)
-Phase 02 (Auth)  ──provides──→ Phase 03 (Core)
-Phase 02 (Auth)  ──provides──→ Phase 04 (Frontend)
-Phase 03 (Core)  ──provides──→ Phase 04 (Frontend)
-```
-
-## 1. Export/Import Wiring
-
-### Export Status Summary
-
-| Phase | Total Exports | Consumed | Orphaned | Unused Imports | Mismatched |
-|-------|--------------|----------|----------|---------------|------------|
-| 01 | {n} | {n} | {n} | {n} | {n} |
-| 02 | {n} | {n} | {n} | {n} | {n} |
-
-### Detailed Export Map
-
-| Export | Source Phase | Source File:Line | Consumer(s) | Status |
-|--------|------------|-----------------|-------------|--------|
-| DatabaseConnection | 01 | src/db/conn.ts:5 | Phase 02, 03 | CONSUMED |
-| ConfigLoader | 01 | src/config/index.ts:12 | Phase 03 | CONSUMED |
-| ThemeProvider | 04 | src/theme/provider.tsx:8 | - | ORPHANED |
-
-### Orphaned Exports (created but never used)
-
-| Export | Phase | File | Line | Likely Intended Consumer |
-|--------|-------|------|------|------------------------|
-| {name} | {phase} | {file} | {line} | {best guess or "unknown"} |
-
-### Unused Imports (imported but symbol never called)
-
-| File | Imported Symbol | Source Module | Line |
-|------|----------------|--------------|------|
-| {file} | {symbol} | {module} | {line} |
-
-## 2. API Coverage
-
-### Route Coverage Matrix
-
-| Route | Method | Handler | Frontend Caller | Auth | Status |
-|-------|--------|---------|----------------|------|--------|
-| /api/users | GET | users.ts:12 | UserList.tsx:34 | YES | COVERED |
-| /api/users/:id | DELETE | users.ts:45 | - | YES | NO_CALLER |
-| /api/settings | PUT | - | Settings.tsx:22 | - | NO_HANDLER |
-
-### Uncovered Routes (backend exists, no frontend caller)
-
-| Route | Method | Handler | Possible Reason |
-|-------|--------|---------|----------------|
-| {route} | {method} | {file:line} | {guess: future feature, admin only, etc.} |
-
-### Missing Handlers (frontend calls, no backend route)
-
-| Frontend File | Calls | Expected Route | Expected Method |
-|--------------|-------|---------------|----------------|
-| {file} | fetch('/api/X') | /api/X | GET |
-
-## 3. Auth Protection
-
-### Route Protection Summary
-
-| Category | Total | Protected | Unprotected | Status |
-|----------|-------|-----------|-------------|--------|
-| API Routes | {n} | {n} | {n} | {OK/ISSUES} |
-| Pages | {n} | {n} | {n} | {OK/ISSUES} |
-| Public Routes | {n} | - | {n} | OK |
-
-### Unprotected Routes (SECURITY ISSUES)
-
-| Route | Method | Handler | Should Protect | Evidence |
-|-------|--------|---------|---------------|----------|
-| {route} | {method} | {file:line} | YES | No auth middleware in chain |
-
-### Auth Flow Completeness
-
-| Step | Status | Evidence |
-|------|--------|----------|
-| Login form exists | {YES/NO} | {file:line} |
-| Auth API called | {YES/NO} | {file:line} |
-| Token/session created | {YES/NO} | {file:line} |
-| Token sent with requests | {YES/NO} | {file:line} |
-| Auth middleware applied | {YES/NO} | {file:line} |
-| Unauthorized redirect | {YES/NO} | {file:line} |
-
-## 4. End-to-End Flows
-
-### Flow 1: {Flow Name} - {STATUS}
-
-| Step | Description | Component | Exists | Connected to Next | Evidence |
-|------|------------|-----------|--------|-------------------|----------|
-| 1 | {step desc} | {file} | YES | YES | import at L12, call at L45 |
-| 2 | {step desc} | {file} | YES | NO | handler exists but not called |
-| 3 | {step desc} | - | NO | - | File not found |
-
-**Break point**: {If BROKEN, where exactly the chain breaks}
-**Impact**: {What user action fails because of this break}
-
-### Flow 2: {Flow Name} - {STATUS}
-...
-
-## 5. Integration Issues Summary
-
-### Critical Issues (system cannot function)
-
-1. **{Issue}**: {description with evidence}
-   - Impact: {what breaks}
-   - Fix: {recommended action}
-
-### Warnings (partial functionality)
-
-1. **{Issue}**: {description with evidence}
-   - Impact: {what's degraded}
-   - Fix: {recommended action}
-
-### Info (cleanup opportunities)
-
-1. **{Issue}**: {description}
-   - Fix: {recommended action}
-
-## 6. Integration Score
-
-| Category | Items Checked | Passed | Failed | Score |
-|----------|--------------|--------|--------|-------|
-| Export wiring | {n} | {n} | {n} | {%} |
-| API coverage | {n} | {n} | {n} | {%} |
-| Auth protection | {n} | {n} | {n} | {%} |
-| E2E flows | {n} | {n} | {n} | {%} |
-| **Overall** | {n} | {n} | {n} | **{%}** |
-
-## Recommendations
-
-{Prioritized list of actions to fix integration issues}
-
-1. **[CRITICAL]** {Most important fix}
-2. **[CRITICAL]** {Second most important}
-3. **[WARNING]** {Important but not blocking}
-4. ...
-```
+<!-- Source: agents/integration-checker.md | Purpose: Output format for cross-phase integration verification reports -->
+
+```markdown
+# Integration Verification Report
+
+> Verified: {date}
+> Phases checked: {comma-separated list of phase IDs}
+> Status: **{INTEGRATED | GAPS_FOUND}**
+
+## Phase Dependency Graph
+
+```
+Phase 01 (Setup) ──provides──→ Phase 02 (Auth)
+Phase 01 (Setup) ──provides──→ Phase 03 (Core)
+Phase 02 (Auth)  ──provides──→ Phase 03 (Core)
+Phase 02 (Auth)  ──provides──→ Phase 04 (Frontend)
+Phase 03 (Core)  ──provides──→ Phase 04 (Frontend)
+```
+
+## 1. Export/Import Wiring
+
+### Export Status Summary
+
+| Phase | Total Exports | Consumed | Orphaned | Unused Imports | Mismatched |
+|-------|--------------|----------|----------|---------------|------------|
+| 01 | {n} | {n} | {n} | {n} | {n} |
+| 02 | {n} | {n} | {n} | {n} | {n} |
+
+### Detailed Export Map
+
+| Export | Source Phase | Source File:Line | Consumer(s) | Status |
+|--------|------------|-----------------|-------------|--------|
+| DatabaseConnection | 01 | src/db/conn.ts:5 | Phase 02, 03 | CONSUMED |
+| ConfigLoader | 01 | src/config/index.ts:12 | Phase 03 | CONSUMED |
+| ThemeProvider | 04 | src/theme/provider.tsx:8 | - | ORPHANED |
+
+### Orphaned Exports (created but never used)
+
+| Export | Phase | File | Line | Likely Intended Consumer |
+|--------|-------|------|------|------------------------|
+| {name} | {phase} | {file} | {line} | {best guess or "unknown"} |
+
+### Unused Imports (imported but symbol never called)
+
+| File | Imported Symbol | Source Module | Line |
+|------|----------------|--------------|------|
+| {file} | {symbol} | {module} | {line} |
+
+## 2. API Coverage
+
+### Route Coverage Matrix
+
+| Route | Method | Handler | Frontend Caller | Auth | Status |
+|-------|--------|---------|----------------|------|--------|
+| /api/users | GET | users.ts:12 | UserList.tsx:34 | YES | COVERED |
+| /api/users/:id | DELETE | users.ts:45 | - | YES | NO_CALLER |
+| /api/settings | PUT | - | Settings.tsx:22 | - | NO_HANDLER |
+
+### Uncovered Routes (backend exists, no frontend caller)
+
+| Route | Method | Handler | Possible Reason |
+|-------|--------|---------|----------------|
+| {route} | {method} | {file:line} | {guess: future feature, admin only, etc.} |
+
+### Missing Handlers (frontend calls, no backend route)
+
+| Frontend File | Calls | Expected Route | Expected Method |
+|--------------|-------|---------------|----------------|
+| {file} | fetch('/api/X') | /api/X | GET |
+
+## 3. Auth Protection
+
+### Route Protection Summary
+
+| Category | Total | Protected | Unprotected | Status |
+|----------|-------|-----------|-------------|--------|
+| API Routes | {n} | {n} | {n} | {OK/ISSUES} |
+| Pages | {n} | {n} | {n} | {OK/ISSUES} |
+| Public Routes | {n} | - | {n} | OK |
+
+### Unprotected Routes (SECURITY ISSUES)
+
+| Route | Method | Handler | Should Protect | Evidence |
+|-------|--------|---------|---------------|----------|
+| {route} | {method} | {file:line} | YES | No auth middleware in chain |
+
+### Auth Flow Completeness
+
+| Step | Status | Evidence |
+|------|--------|----------|
+| Login form exists | {YES/NO} | {file:line} |
+| Auth API called | {YES/NO} | {file:line} |
+| Token/session created | {YES/NO} | {file:line} |
+| Token sent with requests | {YES/NO} | {file:line} |
+| Auth middleware applied | {YES/NO} | {file:line} |
+| Unauthorized redirect | {YES/NO} | {file:line} |
+
+## 4. End-to-End Flows
+
+### Flow 1: {Flow Name} - {STATUS}
+
+| Step | Description | Component | Exists | Connected to Next | Evidence |
+|------|------------|-----------|--------|-------------------|----------|
+| 1 | {step desc} | {file} | YES | YES | import at L12, call at L45 |
+| 2 | {step desc} | {file} | YES | NO | handler exists but not called |
+| 3 | {step desc} | - | NO | - | File not found |
+
+**Break point**: {If BROKEN, where exactly the chain breaks}
+**Impact**: {What user action fails because of this break}
+
+### Flow 2: {Flow Name} - {STATUS}
+...
+
+## 5. Integration Issues Summary
+
+### Critical Issues (system cannot function)
+
+1. **{Issue}**: {description with evidence}
+   - Impact: {what breaks}
+   - Fix: {recommended action}
+
+### Warnings (partial functionality)
+
+1. **{Issue}**: {description with evidence}
+   - Impact: {what's degraded}
+   - Fix: {recommended action}
+
+### Info (cleanup opportunities)
+
+1. **{Issue}**: {description}
+   - Fix: {recommended action}
+
+## 6. Integration Score
+
+| Category | Items Checked | Passed | Failed | Score |
+|----------|--------------|--------|--------|-------|
+| Export wiring | {n} | {n} | {n} | {%} |
+| API coverage | {n} | {n} | {n} | {%} |
+| Auth protection | {n} | {n} | {n} | {%} |
+| E2E flows | {n} | {n} | {n} | {%} |
+| **Overall** | {n} | {n} | {n} | **{%}** |
+
+## Recommendations
+
+{Prioritized list of actions to fix integration issues}
+
+1. **[CRITICAL]** {Most important fix}
+2. **[CRITICAL]** {Second most important}
+3. **[WARNING]** {Important but not blocking}
+4. ...
+```

package/plugins/pbr/templates/RESEARCH-SUMMARY.md.tmpl

@@ -1,97 +1,97 @@
-# Research Summary
-
-> Synthesized: {date}
-> Input documents: {count}
-> Sources: {list of document names/paths}
-
-## Executive Summary
-
-{3-5 sentences maximum. What was researched, the single most important conclusion, and the recommended approach. This paragraph should give a planner enough context to start planning without reading further.}
-
-## Recommended Stack
-
-{Only include if project-level synthesis. For phase-level, skip this section.}
-
-| Layer | Choice | Version | Confidence | Alternatives | Source |
-|-------|--------|---------|------------|-------------|--------|
-| Runtime | {Node.js} | {20.x} | HIGH | {Bun, Deno} | {Doc A, Doc B} |
-| Framework | {Next.js} | {14.x} | HIGH | {Remix, Astro} | {Doc A} |
-| Database | {PostgreSQL} | {16.x} | HIGH | {MySQL} | {Doc A, Doc C} |
-| ORM | {Prisma} | {5.x} | MEDIUM | {Drizzle, TypeORM} | {Doc B} |
-| Auth | {NextAuth.js} | {5.x} | MEDIUM | {Clerk, Auth0} | {Doc A} |
-| Hosting | {Vercel} | - | MEDIUM | {AWS, Railway} | {Doc C} |
-| Testing | {Vitest} | {1.x} | HIGH | {Jest} | {Doc B} |
-
-### Stack Rationale
-
-{Brief explanation of why this combination. 2-3 sentences.}
-
-## Architecture Recommendations
-
-{Key architectural decisions informed by research. Use bullet points.}
-
-- **Pattern**: {Recommended pattern with rationale}
-- **Data flow**: {How data should move through the system}
-- **Separation**: {How to organize the code}
-- **State**: {How to manage state}
-
-## Key Patterns
-
-{Patterns to follow during implementation.}
-
-| Pattern | When to Use | Example |
-|---------|------------|---------|
-| {Repository} | {Database access} | {Brief code hint} |
-| {Middleware} | {Auth, logging, validation} | {Brief code hint} |
-| {DTO validation} | {API input/output} | {Zod schemas} |
-
-## Pitfalls & Warnings
-
-{Ranked by severity. These are the things most likely to cause problems.}
-
-| # | Pitfall | Severity | Source | Mitigation |
-|---|---------|----------|--------|------------|
-| 1 | {Most critical pitfall} | CRITICAL | {Doc A} | {How to avoid} |
-| 2 | {Second pitfall} | HIGH | {Doc B, Doc C} | {How to avoid} |
-| 3 | {Third pitfall} | MEDIUM | {Doc A} | {How to avoid} |
-
-## Contradictions Resolved
-
-{Where input documents disagreed and how it was resolved.}
-
-| Topic | Position A | Position B | Resolution | Basis |
-|-------|-----------|-----------|------------|-------|
-| {Database} | PostgreSQL (Doc A, C) | MongoDB (Doc B) | PostgreSQL | Majority + S2 source |
-| {Auth} | JWT (Doc A, B) | Sessions (Doc C) | JWT | Majority + better for API |
-
-{If any contradictions could not be resolved:}
-
-### Unresolved: {Topic}
-
-**Options**: {A} vs {B}
-**Trade-offs**: {A is better for X, B is better for Y}
-**Recommendation**: {best guess} `[NEEDS DECISION]`
-
-## Open Questions
-
-{Things that none of the research documents could definitively answer.}
-
-1. {Question} -- Impact: {what planning/implementation is blocked by this}
-2. {Question} -- Impact: {what planning/implementation is blocked by this}
-
-## Additional Notes
-
-{P3 (Nice to Know) items. Brief bullet points only.}
-
-- {Performance tip from Doc A}
-- {Future consideration from Doc C}
-- {Alternative approach worth noting from Doc B}
-
-## Sources
-
-{Consolidated source list from all input documents.}
-
-| # | Document | Key Contribution | Confidence |
-|---|----------|-----------------|------------|
-| 1 | {path/name} | {what it contributed} | {overall confidence} |
-| 2 | {path/name} | {what it contributed} | {overall confidence} |
+# Research Summary
+
+> Synthesized: {date}
+> Input documents: {count}
+> Sources: {list of document names/paths}
+
+## Executive Summary
+
+{3-5 sentences maximum. What was researched, the single most important conclusion, and the recommended approach. This paragraph should give a planner enough context to start planning without reading further.}
+
+## Recommended Stack
+
+{Only include if project-level synthesis. For phase-level, skip this section.}
+
+| Layer | Choice | Version | Confidence | Alternatives | Source |
+|-------|--------|---------|------------|-------------|--------|
+| Runtime | {Node.js} | {20.x} | HIGH | {Bun, Deno} | {Doc A, Doc B} |
+| Framework | {Next.js} | {14.x} | HIGH | {Remix, Astro} | {Doc A} |
+| Database | {PostgreSQL} | {16.x} | HIGH | {MySQL} | {Doc A, Doc C} |
+| ORM | {Prisma} | {5.x} | MEDIUM | {Drizzle, TypeORM} | {Doc B} |
+| Auth | {NextAuth.js} | {5.x} | MEDIUM | {Clerk, Auth0} | {Doc A} |
+| Hosting | {Vercel} | - | MEDIUM | {AWS, Railway} | {Doc C} |
+| Testing | {Vitest} | {1.x} | HIGH | {Jest} | {Doc B} |
+
+### Stack Rationale
+
+{Brief explanation of why this combination. 2-3 sentences.}
+
+## Architecture Recommendations
+
+{Key architectural decisions informed by research. Use bullet points.}
+
+- **Pattern**: {Recommended pattern with rationale}
+- **Data flow**: {How data should move through the system}
+- **Separation**: {How to organize the code}
+- **State**: {How to manage state}
+
+## Key Patterns
+
+{Patterns to follow during implementation.}
+
+| Pattern | When to Use | Example |
+|---------|------------|---------|
+| {Repository} | {Database access} | {Brief code hint} |
+| {Middleware} | {Auth, logging, validation} | {Brief code hint} |
+| {DTO validation} | {API input/output} | {Zod schemas} |
+
+## Pitfalls & Warnings
+
+{Ranked by severity. These are the things most likely to cause problems.}
+
+| # | Pitfall | Severity | Source | Mitigation |
+|---|---------|----------|--------|------------|
+| 1 | {Most critical pitfall} | CRITICAL | {Doc A} | {How to avoid} |
+| 2 | {Second pitfall} | HIGH | {Doc B, Doc C} | {How to avoid} |
+| 3 | {Third pitfall} | MEDIUM | {Doc A} | {How to avoid} |
+
+## Contradictions Resolved
+
+{Where input documents disagreed and how it was resolved.}
+
+| Topic | Position A | Position B | Resolution | Basis |
+|-------|-----------|-----------|------------|-------|
+| {Database} | PostgreSQL (Doc A, C) | MongoDB (Doc B) | PostgreSQL | Majority + S2 source |
+| {Auth} | JWT (Doc A, B) | Sessions (Doc C) | JWT | Majority + better for API |
+
+{If any contradictions could not be resolved:}
+
+### Unresolved: {Topic}
+
+**Options**: {A} vs {B}
+**Trade-offs**: {A is better for X, B is better for Y}
+**Recommendation**: {best guess} `[NEEDS DECISION]`
+
+## Open Questions
+
+{Things that none of the research documents could definitively answer.}
+
+1. {Question} -- Impact: {what planning/implementation is blocked by this}
+2. {Question} -- Impact: {what planning/implementation is blocked by this}
+
+## Additional Notes
+
+{P3 (Nice to Know) items. Brief bullet points only.}
+
+- {Performance tip from Doc A}
+- {Future consideration from Doc C}
+- {Alternative approach worth noting from Doc B}
+
+## Sources
+
+{Consolidated source list from all input documents.}
+
+| # | Document | Key Contribution | Confidence |
+|---|----------|-----------------|------------|
+| 1 | {path/name} | {what it contributed} | {overall confidence} |
+| 2 | {path/name} | {what it contributed} | {overall confidence} |

package/plugins/pbr/templates/ROADMAP.md.tmpl

@@ -1,40 +1,40 @@
-# Project Roadmap
-
-> Generated: {date}
-> Total phases: {n}
-> Estimated plans: {n}
-
-## Phase Overview
-
-| Phase | Name | Goal | Plans | Wave | Status |
-|-------|------|------|-------|------|--------|
-| 01 | Project Setup | Development environment ready | 2 | 1 | pending |
-| 02 | Authentication | Users can sign in | 3 | 1 | pending |
-| 03 | Core Models | Data layer complete | 4 | 2 | pending |
-| ... | ... | ... | ... | ... | ... |
-
-## Dependency Graph
-
-```
-Phase 01 ──→ Phase 02 ──→ Phase 04
-         └──→ Phase 03 ──→ Phase 05
-                       └──→ Phase 04
-```
-
-## Phase Details
-
-### Phase 01: Project Setup
-
-**Goal**: {goal statement}
-**Must-Haves**:
-- {truth 1}
-- {truth 2}
-
-**Planned Plans**:
-1. {plan name} (Wave 1, autonomous)
-2. {plan name} (Wave 1, autonomous)
-
-**Dependencies**: None (starting phase)
-
-### Phase 02: Authentication
-...
+# Project Roadmap
+
+> Generated: {date}
+> Total phases: {n}
+> Estimated plans: {n}
+
+## Phase Overview
+
+| Phase | Name | Goal | Plans | Wave | Status |
+|-------|------|------|-------|------|--------|
+| 01 | Project Setup | Development environment ready | 2 | 1 | pending |
+| 02 | Authentication | Users can sign in | 3 | 1 | pending |
+| 03 | Core Models | Data layer complete | 4 | 2 | pending |
+| ... | ... | ... | ... | ... | ... |
+
+## Dependency Graph
+
+```
+Phase 01 ──→ Phase 02 ──→ Phase 04
+         └──→ Phase 03 ──→ Phase 05
+                       └──→ Phase 04
+```
+
+## Phase Details
+
+### Phase 01: Project Setup
+
+**Goal**: {goal statement}
+**Must-Haves**:
+- {truth 1}
+- {truth 2}
+
+**Planned Plans**:
+1. {plan name} (Wave 1, autonomous)
+2. {plan name} (Wave 1, autonomous)
+
+**Dependencies**: None (starting phase)
+
+### Phase 02: Authentication
+...