@sienklogic/plan-build-run 2.0.0 → 2.0.1

package/plugins/pbr/templates/codebase/CONCERNS.md.tmpl

@@ -1,93 +1,93 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for CONCERNS.md codebase analysis -->
-# Concerns & Technical Debt
-
-> Analyzed: {date}
-> Severity summary: {n critical, n high, n medium, n low}
-
-## Technical Debt
-
-| # | Area | Issue | Severity | Files | Evidence |
-|---|------|-------|----------|-------|----------|
-| 1 | {area} | {what's wrong} | critical/high/medium/low | {file paths} | {what you saw} |
-| 2 | {area} | {what's wrong} | {severity} | {file paths} | {what you saw} |
-
-### Debt Details
-
-#### TD-1: {Issue Title}
-
-**Severity**: {critical / high / medium / low}
-**Files**: {list of affected files}
-**Description**: {detailed description of the issue}
-**Evidence**: {specific code examples, line numbers}
-**Impact**: {what problems this causes or could cause}
-**Recommendation**: {specific action to fix}
-
-## Known Bugs
-
-| # | Description | Severity | Location | Reproduction |
-|---|-------------|----------|----------|--------------|
-| 1 | {bug description} | {severity} | {file:line} | {how to trigger} |
-
-## Security Considerations
-
-| # | Issue | Severity | Location | Recommendation |
-|---|-------|----------|----------|----------------|
-| 1 | {Missing input validation on API} | high | {src/routes/users.ts} | {Add zod schema validation} |
-| 2 | {Hardcoded secret in source} | critical | {src/config.ts:42} | {Move to environment variable} |
-| 3 | {SQL injection risk} | critical | {src/db/queries.ts:15} | {Use parameterized queries} |
-| 4 | {No rate limiting} | medium | {src/server.ts} | {Add express-rate-limit} |
-| 5 | {No CSRF protection} | medium | {src/routes/} | {Add csrf tokens} |
-
-## Performance Risks
-
-| # | Issue | Location | Impact | Recommendation |
-|---|-------|----------|--------|----------------|
-| 1 | {N+1 query in user list} | {src/routes/users.ts:30} | {Slow page load} | {Use eager loading} |
-| 2 | {No pagination on large queries} | {src/routes/posts.ts:15} | {Memory exhaustion} | {Add cursor pagination} |
-| 3 | {Synchronous file operations} | {src/utils/file.ts} | {Blocks event loop} | {Use async fs methods} |
-
-## Fragile Areas
-
-| # | Area | Why Fragile | Impact of Breaking | Files |
-|---|------|-------------|-------------------|-------|
-| 1 | {Auth middleware} | {Tightly coupled to 5 services} | {All protected routes fail} | {files} |
-| 2 | {Data migration} | {No rollback mechanism} | {Data loss on failure} | {files} |
-
-## Dependency Risks
-
-| Package | Version | Issue | Recommendation |
-|---------|---------|-------|----------------|
-| {package} | {version} | {Deprecated / EOL / Known vulnerability} | {Update to X / Replace with Y} |
-
-## Scaling Limitations
-
-| # | Limitation | When It Breaks | Current State | Fix Approach |
-|---|-----------|---------------|---------------|-------------|
-| 1 | {Single database instance} | {>1000 concurrent users} | {adequate for current load} | {Read replicas} |
-| 2 | {In-memory session store} | {Multiple server instances} | {single instance} | {Redis session store} |
-
-## Missing Infrastructure
-
-| Category | Status | Impact | Priority |
-|----------|--------|--------|----------|
-| Error monitoring | {absent/partial/present} | {bugs go unnoticed} | {high} |
-| Logging | {absent/partial/present} | {hard to debug production} | {high} |
-| CI/CD | {absent/partial/present} | {manual deployments} | {medium} |
-| Automated tests | {absent/partial/present} | {regressions not caught} | {high} |
-| Documentation | {absent/partial/present} | {onboarding difficulty} | {low} |
-| Backup/Recovery | {absent/partial/present} | {data loss risk} | {critical} |
-| Health checks | {absent/partial/present} | {outages not detected} | {medium} |
-
-## Recommendations (Prioritized)
-
-### Critical (Fix Immediately)
-1. {Recommendation with specific action}
-
-### High (Fix Soon)
-1. {Recommendation with specific action}
-
-### Medium (Plan to Fix)
-1. {Recommendation with specific action}
-
-### Low (When Convenient)
-1. {Recommendation with specific action}
+<!-- Source: agents/codebase-mapper.md | Purpose: Output format for CONCERNS.md codebase analysis -->
+# Concerns & Technical Debt
+
+> Analyzed: {date}
+> Severity summary: {n critical, n high, n medium, n low}
+
+## Technical Debt
+
+| # | Area | Issue | Severity | Files | Evidence |
+|---|------|-------|----------|-------|----------|
+| 1 | {area} | {what's wrong} | critical/high/medium/low | {file paths} | {what you saw} |
+| 2 | {area} | {what's wrong} | {severity} | {file paths} | {what you saw} |
+
+### Debt Details
+
+#### TD-1: {Issue Title}
+
+**Severity**: {critical / high / medium / low}
+**Files**: {list of affected files}
+**Description**: {detailed description of the issue}
+**Evidence**: {specific code examples, line numbers}
+**Impact**: {what problems this causes or could cause}
+**Recommendation**: {specific action to fix}
+
+## Known Bugs
+
+| # | Description | Severity | Location | Reproduction |
+|---|-------------|----------|----------|--------------|
+| 1 | {bug description} | {severity} | {file:line} | {how to trigger} |
+
+## Security Considerations
+
+| # | Issue | Severity | Location | Recommendation |
+|---|-------|----------|----------|----------------|
+| 1 | {Missing input validation on API} | high | {src/routes/users.ts} | {Add zod schema validation} |
+| 2 | {Hardcoded secret in source} | critical | {src/config.ts:42} | {Move to environment variable} |
+| 3 | {SQL injection risk} | critical | {src/db/queries.ts:15} | {Use parameterized queries} |
+| 4 | {No rate limiting} | medium | {src/server.ts} | {Add express-rate-limit} |
+| 5 | {No CSRF protection} | medium | {src/routes/} | {Add csrf tokens} |
+
+## Performance Risks
+
+| # | Issue | Location | Impact | Recommendation |
+|---|-------|----------|--------|----------------|
+| 1 | {N+1 query in user list} | {src/routes/users.ts:30} | {Slow page load} | {Use eager loading} |
+| 2 | {No pagination on large queries} | {src/routes/posts.ts:15} | {Memory exhaustion} | {Add cursor pagination} |
+| 3 | {Synchronous file operations} | {src/utils/file.ts} | {Blocks event loop} | {Use async fs methods} |
+
+## Fragile Areas
+
+| # | Area | Why Fragile | Impact of Breaking | Files |
+|---|------|-------------|-------------------|-------|
+| 1 | {Auth middleware} | {Tightly coupled to 5 services} | {All protected routes fail} | {files} |
+| 2 | {Data migration} | {No rollback mechanism} | {Data loss on failure} | {files} |
+
+## Dependency Risks
+
+| Package | Version | Issue | Recommendation |
+|---------|---------|-------|----------------|
+| {package} | {version} | {Deprecated / EOL / Known vulnerability} | {Update to X / Replace with Y} |
+
+## Scaling Limitations
+
+| # | Limitation | When It Breaks | Current State | Fix Approach |
+|---|-----------|---------------|---------------|-------------|
+| 1 | {Single database instance} | {>1000 concurrent users} | {adequate for current load} | {Read replicas} |
+| 2 | {In-memory session store} | {Multiple server instances} | {single instance} | {Redis session store} |
+
+## Missing Infrastructure
+
+| Category | Status | Impact | Priority |
+|----------|--------|--------|----------|
+| Error monitoring | {absent/partial/present} | {bugs go unnoticed} | {high} |
+| Logging | {absent/partial/present} | {hard to debug production} | {high} |
+| CI/CD | {absent/partial/present} | {manual deployments} | {medium} |
+| Automated tests | {absent/partial/present} | {regressions not caught} | {high} |
+| Documentation | {absent/partial/present} | {onboarding difficulty} | {low} |
+| Backup/Recovery | {absent/partial/present} | {data loss risk} | {critical} |
+| Health checks | {absent/partial/present} | {outages not detected} | {medium} |
+
+## Recommendations (Prioritized)
+
+### Critical (Fix Immediately)
+1. {Recommendation with specific action}
+
+### High (Fix Soon)
+1. {Recommendation with specific action}
+
+### Medium (Plan to Fix)
+1. {Recommendation with specific action}
+
+### Low (When Convenient)
+1. {Recommendation with specific action}

package/plugins/pbr/templates/codebase/CONVENTIONS.md.tmpl

@@ -1,104 +1,104 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for CONVENTIONS.md codebase analysis -->
-# Code Conventions
-
-> Analyzed: {date}
-> Based on: {n} files inspected
-
-## Naming Conventions
-
-| Entity | Convention | Example |
-|--------|-----------|---------|
-| Files (components) | {PascalCase.tsx} | `UserProfile.tsx` |
-| Files (utilities) | {camelCase.ts} | `formatDate.ts` |
-| Functions | {camelCase} | `getUserById` |
-| Classes | {PascalCase} | `UserService` |
-| Interfaces | {PascalCase, no I prefix} | `UserProfile` |
-| Types | {PascalCase} | `CreateUserInput` |
-| Constants | {SCREAMING_SNAKE_CASE or camelCase} | `MAX_RETRIES` or `maxRetries` |
-| Enum members | {PascalCase} | `UserRole.Admin` |
-| Environment variables | {SCREAMING_SNAKE_CASE} | `DATABASE_URL` |
-| CSS classes | {kebab-case or camelCase modules} | `user-profile` |
-| Database tables | {snake_case} | `user_profiles` |
-| API endpoints | {kebab-case} | `/api/user-profiles` |
-
-## Code Style
-
-| Aspect | Setting | Config File |
-|--------|---------|-------------|
-| Indentation | {2 spaces / 4 spaces / tabs} | {.editorconfig / .prettierrc} |
-| Quotes | {single / double} | {.prettierrc} |
-| Semicolons | {yes / no} | {.prettierrc} |
-| Trailing commas | {all / es5 / none} | {.prettierrc} |
-| Line width | {80 / 100 / 120} | {.prettierrc} |
-| Line endings | {LF / CRLF} | {.editorconfig} |
-
-## Import Organization
-
-{Observed import order pattern from the codebase}
-
-```{language}
-// 1. Node.js built-in modules
-import path from 'path';
-
-// 2. External packages
-import React from 'react';
-import { z } from 'zod';
-
-// 3. Internal aliases
-import { Button } from '@/components/ui';
-import { useAuth } from '@/hooks/useAuth';
-
-// 4. Relative imports
-import { UserCard } from './UserCard';
-import type { User } from './types';
-
-// 5. Style imports
-import styles from './UserProfile.module.css';
-```
-
-## Function Patterns
-
-### Async Functions
-
-```{language}
-// Pattern used in this codebase: {evidence file:line}
-{actual code pattern from codebase}
-```
-
-### Error Handling
-
-```{language}
-// Pattern used in this codebase: {evidence file:line}
-{actual code pattern from codebase}
-```
-
-### API Route Handlers
-
-```{language}
-// Pattern used in this codebase: {evidence file:line}
-{actual code pattern from codebase}
-```
-
-### React Components
-
-```{language}
-// Pattern used in this codebase: {evidence file:line}
-{actual code pattern from codebase}
-```
-
-## Comment Conventions
-
-| When | Style | Example |
-|------|-------|---------|
-| {Complex logic} | {inline comment} | `// Calculate tax with progressive rates` |
-| {Public API} | {JSDoc} | `/** @param user - The user to validate */` |
-| {Temporary} | {TODO with ticket} | `// TODO(#123): refactor after migration` |
-| {Warning} | {IMPORTANT prefix} | `// IMPORTANT: this must run before auth` |
-
-## Git Conventions
-
-| Aspect | Convention | Example |
-|--------|-----------|---------|
-| Branch naming | {pattern} | `feature/add-user-auth` |
-| Commit format | {conventional commits / custom} | `feat(auth): add login flow` |
-| PR titles | {pattern} | `[Feature] Add user authentication` |
+<!-- Source: agents/codebase-mapper.md | Purpose: Output format for CONVENTIONS.md codebase analysis -->
+# Code Conventions
+
+> Analyzed: {date}
+> Based on: {n} files inspected
+
+## Naming Conventions
+
+| Entity | Convention | Example |
+|--------|-----------|---------|
+| Files (components) | {PascalCase.tsx} | `UserProfile.tsx` |
+| Files (utilities) | {camelCase.ts} | `formatDate.ts` |
+| Functions | {camelCase} | `getUserById` |
+| Classes | {PascalCase} | `UserService` |
+| Interfaces | {PascalCase, no I prefix} | `UserProfile` |
+| Types | {PascalCase} | `CreateUserInput` |
+| Constants | {SCREAMING_SNAKE_CASE or camelCase} | `MAX_RETRIES` or `maxRetries` |
+| Enum members | {PascalCase} | `UserRole.Admin` |
+| Environment variables | {SCREAMING_SNAKE_CASE} | `DATABASE_URL` |
+| CSS classes | {kebab-case or camelCase modules} | `user-profile` |
+| Database tables | {snake_case} | `user_profiles` |
+| API endpoints | {kebab-case} | `/api/user-profiles` |
+
+## Code Style
+
+| Aspect | Setting | Config File |
+|--------|---------|-------------|
+| Indentation | {2 spaces / 4 spaces / tabs} | {.editorconfig / .prettierrc} |
+| Quotes | {single / double} | {.prettierrc} |
+| Semicolons | {yes / no} | {.prettierrc} |
+| Trailing commas | {all / es5 / none} | {.prettierrc} |
+| Line width | {80 / 100 / 120} | {.prettierrc} |
+| Line endings | {LF / CRLF} | {.editorconfig} |
+
+## Import Organization
+
+{Observed import order pattern from the codebase}
+
+```{language}
+// 1. Node.js built-in modules
+import path from 'path';
+
+// 2. External packages
+import React from 'react';
+import { z } from 'zod';
+
+// 3. Internal aliases
+import { Button } from '@/components/ui';
+import { useAuth } from '@/hooks/useAuth';
+
+// 4. Relative imports
+import { UserCard } from './UserCard';
+import type { User } from './types';
+
+// 5. Style imports
+import styles from './UserProfile.module.css';
+```
+
+## Function Patterns
+
+### Async Functions
+
+```{language}
+// Pattern used in this codebase: {evidence file:line}
+{actual code pattern from codebase}
+```
+
+### Error Handling
+
+```{language}
+// Pattern used in this codebase: {evidence file:line}
+{actual code pattern from codebase}
+```
+
+### API Route Handlers
+
+```{language}
+// Pattern used in this codebase: {evidence file:line}
+{actual code pattern from codebase}
+```
+
+### React Components
+
+```{language}
+// Pattern used in this codebase: {evidence file:line}
+{actual code pattern from codebase}
+```
+
+## Comment Conventions
+
+| When | Style | Example |
+|------|-------|---------|
+| {Complex logic} | {inline comment} | `// Calculate tax with progressive rates` |
+| {Public API} | {JSDoc} | `/** @param user - The user to validate */` |
+| {Temporary} | {TODO with ticket} | `// TODO(#123): refactor after migration` |
+| {Warning} | {IMPORTANT prefix} | `// IMPORTANT: this must run before auth` |
+
+## Git Conventions
+
+| Aspect | Convention | Example |
+|--------|-----------|---------|
+| Branch naming | {pattern} | `feature/add-user-auth` |
+| Commit format | {conventional commits / custom} | `feat(auth): add login flow` |
+| PR titles | {pattern} | `[Feature] Add user authentication` |

package/plugins/pbr/templates/codebase/INTEGRATIONS.md.tmpl

@@ -1,78 +1,78 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for INTEGRATIONS.md codebase analysis -->
-# External Integrations
-
-> Analyzed: {date}
-> Total integrations: {n}
-
-## APIs
-
-| Service | Type | Auth Method | Config Var | Used In | Documentation |
-|---------|------|-------------|------------|---------|---------------|
-| {Discord API} | REST | {OAuth2} | DISCORD_TOKEN | {src/integrations/discord.ts} | {URL} |
-| {Stripe} | REST | {API Key} | STRIPE_SECRET_KEY | {src/payments/} | {URL} |
-
-### API Client Patterns
-
-{How API calls are made in this codebase — fetch wrapper? axios instance? SDK?}
-
-```{language}
-// Example from codebase: {file:line}
-{actual code pattern}
-```
-
-## Databases
-
-| Database | Type | ORM/Driver | Config | Schema Location | Migrations |
-|----------|------|-----------|--------|-----------------|------------|
-| {PostgreSQL} | {Relational} | {Prisma} | DATABASE_URL | {prisma/schema.prisma} | {prisma/migrations/} |
-| {Redis} | {Key-value} | {ioredis} | REDIS_URL | - | - |
-
-### Database Patterns
-
-{How database access is structured — repository pattern? direct queries? ORM models?}
-
-## Authentication & Authorization
-
-| Aspect | Implementation | Config | Files |
-|--------|---------------|--------|-------|
-| Method | {JWT / Session / OAuth} | {env vars} | {files} |
-| Provider | {self / Auth0 / Clerk / etc.} | {env vars} | {files} |
-| Storage | {cookie / localStorage / header} | - | {files} |
-| Roles | {admin, user, etc.} | {where defined} | {files} |
-
-## Email/Notifications
-
-| Service | Purpose | Config | Used In |
-|---------|---------|--------|---------|
-| {SendGrid} | {Transactional email} | SENDGRID_KEY | {src/email/} |
-
-## File Storage
-
-| Service | Purpose | Config | Used In |
-|---------|---------|--------|---------|
-| {S3} | {User uploads} | AWS_* vars | {src/storage/} |
-
-## Monitoring & Logging
-
-| Tool | Purpose | Config | Used In |
-|------|---------|--------|---------|
-| {Sentry} | {Error tracking} | SENTRY_DSN | {src/lib/sentry.ts} |
-| {Winston} | {Logging} | - | {src/lib/logger.ts} |
-
-## CI/CD
-
-| Platform | Config | Stages | Deployment |
-|----------|--------|--------|------------|
-| {GitHub Actions} | {.github/workflows/} | {lint, test, build, deploy} | {Vercel / AWS / etc.} |
-
-### Pipeline Details
-
-{Description of the CI/CD pipeline flow}
-
-## Infrastructure
-
-| Component | Provider | Config | Notes |
-|-----------|----------|--------|-------|
-| {Hosting} | {Vercel} | {vercel.json} | {auto-deploy from main} |
-| {DNS} | {Cloudflare} | - | {if relevant} |
-| {CDN} | {included with host} | - | - |
+<!-- Source: agents/codebase-mapper.md | Purpose: Output format for INTEGRATIONS.md codebase analysis -->
+# External Integrations
+
+> Analyzed: {date}
+> Total integrations: {n}
+
+## APIs
+
+| Service | Type | Auth Method | Config Var | Used In | Documentation |
+|---------|------|-------------|------------|---------|---------------|
+| {Discord API} | REST | {OAuth2} | DISCORD_TOKEN | {src/integrations/discord.ts} | {URL} |
+| {Stripe} | REST | {API Key} | STRIPE_SECRET_KEY | {src/payments/} | {URL} |
+
+### API Client Patterns
+
+{How API calls are made in this codebase — fetch wrapper? axios instance? SDK?}
+
+```{language}
+// Example from codebase: {file:line}
+{actual code pattern}
+```
+
+## Databases
+
+| Database | Type | ORM/Driver | Config | Schema Location | Migrations |
+|----------|------|-----------|--------|-----------------|------------|
+| {PostgreSQL} | {Relational} | {Prisma} | DATABASE_URL | {prisma/schema.prisma} | {prisma/migrations/} |
+| {Redis} | {Key-value} | {ioredis} | REDIS_URL | - | - |
+
+### Database Patterns
+
+{How database access is structured — repository pattern? direct queries? ORM models?}
+
+## Authentication & Authorization
+
+| Aspect | Implementation | Config | Files |
+|--------|---------------|--------|-------|
+| Method | {JWT / Session / OAuth} | {env vars} | {files} |
+| Provider | {self / Auth0 / Clerk / etc.} | {env vars} | {files} |
+| Storage | {cookie / localStorage / header} | - | {files} |
+| Roles | {admin, user, etc.} | {where defined} | {files} |
+
+## Email/Notifications
+
+| Service | Purpose | Config | Used In |
+|---------|---------|--------|---------|
+| {SendGrid} | {Transactional email} | SENDGRID_KEY | {src/email/} |
+
+## File Storage
+
+| Service | Purpose | Config | Used In |
+|---------|---------|--------|---------|
+| {S3} | {User uploads} | AWS_* vars | {src/storage/} |
+
+## Monitoring & Logging
+
+| Tool | Purpose | Config | Used In |
+|------|---------|--------|---------|
+| {Sentry} | {Error tracking} | SENTRY_DSN | {src/lib/sentry.ts} |
+| {Winston} | {Logging} | - | {src/lib/logger.ts} |
+
+## CI/CD
+
+| Platform | Config | Stages | Deployment |
+|----------|--------|--------|------------|
+| {GitHub Actions} | {.github/workflows/} | {lint, test, build, deploy} | {Vercel / AWS / etc.} |
+
+### Pipeline Details
+
+{Description of the CI/CD pipeline flow}
+
+## Infrastructure
+
+| Component | Provider | Config | Notes |
+|-----------|----------|--------|-------|
+| {Hosting} | {Vercel} | {vercel.json} | {auto-deploy from main} |
+| {DNS} | {Cloudflare} | - | {if relevant} |
+| {CDN} | {included with host} | - | - |