@sienklogic/plan-build-run 2.0.0 → 2.0.1

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

@@ -1,78 +1,78 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for STACK.md codebase analysis -->
-# Technology Stack
-
-> Analyzed: {date}
-> Project: {project name from package.json or directory}
-
-## Languages & Runtime
-
-| Language | Version | Config | Notes |
-|----------|---------|--------|-------|
-| TypeScript | {version from tsconfig target or dep} | `tsconfig.json` | {strict mode? path aliases?} |
-| Node.js | {version from engines or .nvmrc} | `.nvmrc` / `package.json engines` | {LTS?} |
-
-## Frameworks
-
-| Framework | Version | Role | Entry Point | Config |
-|-----------|---------|------|-------------|--------|
-| {Next.js} | {14.x} | {Web framework} | {src/app/} | {next.config.js} |
-| {Express} | {4.x} | {API server} | {src/server.ts} | - |
-
-## Key Dependencies
-
-### Production Dependencies
-
-| Package | Version | Purpose | Used In |
-|---------|---------|---------|---------|
-| {prisma} | {5.x} | {ORM / database} | {src/db/} |
-| {zod} | {3.x} | {Validation} | {src/validators/} |
-
-### Development Dependencies
-
-| Package | Version | Purpose | Config |
-|---------|---------|---------|--------|
-| {jest} | {29.x} | {Testing} | {jest.config.ts} |
-| {eslint} | {8.x} | {Linting} | {.eslintrc.js} |
-
-## Build & Tooling
-
-| Tool | Config File | Purpose | Commands |
-|------|-------------|---------|----------|
-| {TypeScript} | `tsconfig.json` | {Compilation} | `npx tsc --noEmit` |
-| {ESLint} | `.eslintrc.js` | {Linting} | `npm run lint` |
-| {Prettier} | `.prettierrc` | {Formatting} | `npm run format` |
-| {Jest} | `jest.config.ts` | {Testing} | `npm test` |
-
-## Package Manager
-
-- **Manager**: {npm / yarn / pnpm / bun}
-- **Lock file**: {package-lock.json / yarn.lock / pnpm-lock.yaml}
-- **Workspaces**: {yes/no, if yes: list workspace paths}
-
-## Environment Configuration
-
-| Variable | Required | Default | Purpose | Where Used |
-|----------|----------|---------|---------|------------|
-| DATABASE_URL | YES | - | Database connection | {src/db/} |
-| {VAR_NAME} | {YES/NO} | {value} | {purpose} | {files} |
-
-**Template**: {`.env.example` exists? Y/N}
-
-## Platform Requirements
-
-| Requirement | Value | Source |
-|------------|-------|--------|
-| Node version | {>=18} | {package.json engines} |
-| OS | {any / linux only / etc.} | {evidence} |
-| Memory | {if specified} | {evidence} |
-| External services | {list databases, caches, etc.} | {docker-compose, docs} |
-
-## Scripts
-
-| Script | Command | Purpose |
-|--------|---------|---------|
-| `dev` | {command} | {Start dev server} |
-| `build` | {command} | {Build for production} |
-| `test` | {command} | {Run tests} |
-| `lint` | {command} | {Run linter} |
-| {others} | {command} | {purpose} |
+<!-- Source: agents/codebase-mapper.md | Purpose: Output format for STACK.md codebase analysis -->
+# Technology Stack
+
+> Analyzed: {date}
+> Project: {project name from package.json or directory}
+
+## Languages & Runtime
+
+| Language | Version | Config | Notes |
+|----------|---------|--------|-------|
+| TypeScript | {version from tsconfig target or dep} | `tsconfig.json` | {strict mode? path aliases?} |
+| Node.js | {version from engines or .nvmrc} | `.nvmrc` / `package.json engines` | {LTS?} |
+
+## Frameworks
+
+| Framework | Version | Role | Entry Point | Config |
+|-----------|---------|------|-------------|--------|
+| {Next.js} | {14.x} | {Web framework} | {src/app/} | {next.config.js} |
+| {Express} | {4.x} | {API server} | {src/server.ts} | - |
+
+## Key Dependencies
+
+### Production Dependencies
+
+| Package | Version | Purpose | Used In |
+|---------|---------|---------|---------|
+| {prisma} | {5.x} | {ORM / database} | {src/db/} |
+| {zod} | {3.x} | {Validation} | {src/validators/} |
+
+### Development Dependencies
+
+| Package | Version | Purpose | Config |
+|---------|---------|---------|--------|
+| {jest} | {29.x} | {Testing} | {jest.config.ts} |
+| {eslint} | {8.x} | {Linting} | {.eslintrc.js} |
+
+## Build & Tooling
+
+| Tool | Config File | Purpose | Commands |
+|------|-------------|---------|----------|
+| {TypeScript} | `tsconfig.json` | {Compilation} | `npx tsc --noEmit` |
+| {ESLint} | `.eslintrc.js` | {Linting} | `npm run lint` |
+| {Prettier} | `.prettierrc` | {Formatting} | `npm run format` |
+| {Jest} | `jest.config.ts` | {Testing} | `npm test` |
+
+## Package Manager
+
+- **Manager**: {npm / yarn / pnpm / bun}
+- **Lock file**: {package-lock.json / yarn.lock / pnpm-lock.yaml}
+- **Workspaces**: {yes/no, if yes: list workspace paths}
+
+## Environment Configuration
+
+| Variable | Required | Default | Purpose | Where Used |
+|----------|----------|---------|---------|------------|
+| DATABASE_URL | YES | - | Database connection | {src/db/} |
+| {VAR_NAME} | {YES/NO} | {value} | {purpose} | {files} |
+
+**Template**: {`.env.example` exists? Y/N}
+
+## Platform Requirements
+
+| Requirement | Value | Source |
+|------------|-------|--------|
+| Node version | {>=18} | {package.json engines} |
+| OS | {any / linux only / etc.} | {evidence} |
+| Memory | {if specified} | {evidence} |
+| External services | {list databases, caches, etc.} | {docker-compose, docs} |
+
+## Scripts
+
+| Script | Command | Purpose |
+|--------|---------|---------|
+| `dev` | {command} | {Start dev server} |
+| `build` | {command} | {Build for production} |
+| `test` | {command} | {Run tests} |
+| `lint` | {command} | {Run linter} |
+| {others} | {command} | {purpose} |

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

@@ -1,80 +1,80 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for STRUCTURE.md codebase analysis -->
-# Project Structure
-
-> Analyzed: {date}
-
-## Directory Layout
-
-```
-{project_root}/
-├── src/                          # Source code
-│   ├── app/                      # {Purpose: Next.js App Router pages}
-│   │   ├── api/                  # {API route handlers}
-│   │   ├── (auth)/               # {Auth-related pages}
-│   │   └── layout.tsx            # {Root layout}
-│   ├── components/               # {Shared UI components}
-│   │   ├── ui/                   # {Primitive UI components}
-│   │   └── features/             # {Feature-specific components}
-│   ├── lib/                      # {Shared utilities and configurations}
-│   ├── services/                 # {Business logic}
-│   ├── models/                   # {Data models / types}
-│   ├── hooks/                    # {Custom React hooks}
-│   └── styles/                   # {Global styles}
-├── prisma/                       # {Database schema and migrations}
-├── public/                       # {Static assets}
-├── tests/                        # {Test files}
-├── docs/                         # {Documentation}
-└── scripts/                      # {Build/deploy scripts}
-```
-
-## File Naming Conventions
-
-| Type | Pattern | Example |
-|------|---------|---------|
-| React components | {PascalCase.tsx} | `UserProfile.tsx` |
-| Hooks | {camelCase.ts, use* prefix} | `useAuth.ts` |
-| Utilities | {camelCase.ts} | `formatDate.ts` |
-| Types | {PascalCase.ts or types.ts} | `User.ts`, `types.ts` |
-| Tests | {*.test.ts or *.spec.ts} | `UserProfile.test.tsx` |
-| API routes | {route.ts in directory} | `app/api/users/route.ts` |
-| Config | {lowercase with dots} | `jest.config.ts` |
-| Constants | {UPPER_CASE or camelCase} | `constants.ts` |
-
-## Module Boundaries
-
-{How the code is organized into modules/features and what the boundaries are}
-
-| Module | Directory | Responsibility | Dependencies |
-|--------|-----------|---------------|-------------|
-| {Auth} | {src/auth/} | {Authentication & session} | {Database, Config} |
-| {Users} | {src/users/} | {User CRUD} | {Auth, Database} |
-
-## Import Patterns
-
-{How imports are organized in this codebase}
-
-```{language}
-// Standard import order observed in this project:
-// {example from actual codebase}
-```
-
-### Path Aliases
-
-| Alias | Maps To | Config |
-|-------|---------|--------|
-| `@/` | `src/` | `tsconfig.json paths` |
-| `@components/` | `src/components/` | `tsconfig.json paths` |
-
-## Where to Add Code
-
-| Type of Code | Location | Convention | Example |
-|-------------|----------|------------|---------|
-| New API route | `src/app/api/{resource}/route.ts` | {pattern} | {example} |
-| New component | `src/components/{feature}/` | {pattern} | {example} |
-| New service | `src/services/` | {pattern} | {example} |
-| New model | `src/models/` | {pattern} | {example} |
-| New test | `{co-located or tests/}` | {pattern} | {example} |
-| New utility | `src/lib/` or `src/utils/` | {pattern} | {example} |
-| New hook | `src/hooks/` | {pattern} | {example} |
-| New migration | `prisma/migrations/` | `npx prisma migrate dev` | - |
-| New env var | `.env` + `.env.example` | {pattern} | {example} |
+<!-- Source: agents/codebase-mapper.md | Purpose: Output format for STRUCTURE.md codebase analysis -->
+# Project Structure
+
+> Analyzed: {date}
+
+## Directory Layout
+
+```
+{project_root}/
+├── src/                          # Source code
+│   ├── app/                      # {Purpose: Next.js App Router pages}
+│   │   ├── api/                  # {API route handlers}
+│   │   ├── (auth)/               # {Auth-related pages}
+│   │   └── layout.tsx            # {Root layout}
+│   ├── components/               # {Shared UI components}
+│   │   ├── ui/                   # {Primitive UI components}
+│   │   └── features/             # {Feature-specific components}
+│   ├── lib/                      # {Shared utilities and configurations}
+│   ├── services/                 # {Business logic}
+│   ├── models/                   # {Data models / types}
+│   ├── hooks/                    # {Custom React hooks}
+│   └── styles/                   # {Global styles}
+├── prisma/                       # {Database schema and migrations}
+├── public/                       # {Static assets}
+├── tests/                        # {Test files}
+├── docs/                         # {Documentation}
+└── scripts/                      # {Build/deploy scripts}
+```
+
+## File Naming Conventions
+
+| Type | Pattern | Example |
+|------|---------|---------|
+| React components | {PascalCase.tsx} | `UserProfile.tsx` |
+| Hooks | {camelCase.ts, use* prefix} | `useAuth.ts` |
+| Utilities | {camelCase.ts} | `formatDate.ts` |
+| Types | {PascalCase.ts or types.ts} | `User.ts`, `types.ts` |
+| Tests | {*.test.ts or *.spec.ts} | `UserProfile.test.tsx` |
+| API routes | {route.ts in directory} | `app/api/users/route.ts` |
+| Config | {lowercase with dots} | `jest.config.ts` |
+| Constants | {UPPER_CASE or camelCase} | `constants.ts` |
+
+## Module Boundaries
+
+{How the code is organized into modules/features and what the boundaries are}
+
+| Module | Directory | Responsibility | Dependencies |
+|--------|-----------|---------------|-------------|
+| {Auth} | {src/auth/} | {Authentication & session} | {Database, Config} |
+| {Users} | {src/users/} | {User CRUD} | {Auth, Database} |
+
+## Import Patterns
+
+{How imports are organized in this codebase}
+
+```{language}
+// Standard import order observed in this project:
+// {example from actual codebase}
+```
+
+### Path Aliases
+
+| Alias | Maps To | Config |
+|-------|---------|--------|
+| `@/` | `src/` | `tsconfig.json paths` |
+| `@components/` | `src/components/` | `tsconfig.json paths` |
+
+## Where to Add Code
+
+| Type of Code | Location | Convention | Example |
+|-------------|----------|------------|---------|
+| New API route | `src/app/api/{resource}/route.ts` | {pattern} | {example} |
+| New component | `src/components/{feature}/` | {pattern} | {example} |
+| New service | `src/services/` | {pattern} | {example} |
+| New model | `src/models/` | {pattern} | {example} |
+| New test | `{co-located or tests/}` | {pattern} | {example} |
+| New utility | `src/lib/` or `src/utils/` | {pattern} | {example} |
+| New hook | `src/hooks/` | {pattern} | {example} |
+| New migration | `prisma/migrations/` | `npx prisma migrate dev` | - |
+| New env var | `.env` + `.env.example` | {pattern} | {example} |

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

@@ -1,107 +1,107 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for TESTING.md codebase analysis -->
-# Testing Infrastructure
-
-> Analyzed: {date}
-> Test files found: {n}
-> Coverage: {percentage if configured}
-
-## Framework
-
-| Aspect | Value | Config |
-|--------|-------|--------|
-| Test runner | {Jest / Vitest / pytest / etc.} | {config file path} |
-| Assertion library | {built-in / chai / etc.} | - |
-| Mocking | {jest.mock / vitest.mock / unittest.mock} | - |
-| Coverage tool | {c8 / istanbul / coverage.py} | {config} |
-
-## Running Tests
-
-```bash
-# All tests
-{npm test}
-
-# Specific file
-{npm test -- path/to/file}
-
-# Watch mode
-{npm run test:watch}
-
-# Coverage
-{npm run test:coverage}
-
-# Specific pattern
-{npm test -- --grep "pattern"}
-```
-
-## Test Organization
-
-| Aspect | Pattern | Example |
-|--------|---------|---------|
-| Location | {co-located / separate directory} | `src/auth/auth.test.ts` or `tests/auth.test.ts` |
-| File naming | {.test.ts / .spec.ts / test_.py} | `UserService.test.ts` |
-| Describe blocks | {module/function/feature} | `describe('UserService')` |
-| Test naming | {should X / it X / test_X} | `it('should return user by id')` |
-
-## Test Structure Pattern
-
-```{language}
-// Pattern used in this codebase: {evidence file:line}
-{actual test structure from codebase}
-```
-
-## Mocking Patterns
-
-### External Services
-
-```{language}
-// How external services are mocked: {evidence file:line}
-{actual mock pattern from codebase}
-```
-
-### Database
-
-```{language}
-// How database is mocked/seeded: {evidence file:line}
-{actual pattern from codebase}
-```
-
-### API Calls
-
-```{language}
-// How API calls are mocked: {evidence file:line}
-{actual pattern from codebase}
-```
-
-## Fixtures & Test Data
-
-| Type | Location | Pattern |
-|------|----------|---------|
-| {Factories} | {tests/factories/} | {createUser(), createPost()} |
-| {Fixtures} | {tests/fixtures/} | {JSON files} |
-| {Seeds} | {prisma/seed.ts} | {Prisma seed script} |
-
-## Coverage Configuration
-
-| Setting | Value |
-|---------|-------|
-| Threshold | {if configured: line %, branch %, function %} |
-| Include | {file patterns} |
-| Exclude | {file patterns} |
-| Reporter | {text / html / lcov} |
-
-## E2E Testing
-
-| Aspect | Value | Config |
-|--------|-------|--------|
-| Framework | {Playwright / Cypress / none} | {config file} |
-| Location | {e2e/ or tests/e2e/} | - |
-| Base URL | {config} | - |
-
-## Testing Gaps
-
-| Area | Has Tests | Notes |
-|------|-----------|-------|
-| {Unit tests} | {YES/NO/PARTIAL} | {coverage details} |
-| {Integration tests} | {YES/NO/PARTIAL} | {coverage details} |
-| {E2E tests} | {YES/NO/PARTIAL} | {coverage details} |
-| {API tests} | {YES/NO/PARTIAL} | {coverage details} |
+<!-- Source: agents/codebase-mapper.md | Purpose: Output format for TESTING.md codebase analysis -->
+# Testing Infrastructure
+
+> Analyzed: {date}
+> Test files found: {n}
+> Coverage: {percentage if configured}
+
+## Framework
+
+| Aspect | Value | Config |
+|--------|-------|--------|
+| Test runner | {Jest / Vitest / pytest / etc.} | {config file path} |
+| Assertion library | {built-in / chai / etc.} | - |
+| Mocking | {jest.mock / vitest.mock / unittest.mock} | - |
+| Coverage tool | {c8 / istanbul / coverage.py} | {config} |
+
+## Running Tests
+
+```bash
+# All tests
+{npm test}
+
+# Specific file
+{npm test -- path/to/file}
+
+# Watch mode
+{npm run test:watch}
+
+# Coverage
+{npm run test:coverage}
+
+# Specific pattern
+{npm test -- --grep "pattern"}
+```
+
+## Test Organization
+
+| Aspect | Pattern | Example |
+|--------|---------|---------|
+| Location | {co-located / separate directory} | `src/auth/auth.test.ts` or `tests/auth.test.ts` |
+| File naming | {.test.ts / .spec.ts / test_.py} | `UserService.test.ts` |
+| Describe blocks | {module/function/feature} | `describe('UserService')` |
+| Test naming | {should X / it X / test_X} | `it('should return user by id')` |
+
+## Test Structure Pattern
+
+```{language}
+// Pattern used in this codebase: {evidence file:line}
+{actual test structure from codebase}
+```
+
+## Mocking Patterns
+
+### External Services
+
+```{language}
+// How external services are mocked: {evidence file:line}
+{actual mock pattern from codebase}
+```
+
+### Database
+
+```{language}
+// How database is mocked/seeded: {evidence file:line}
+{actual pattern from codebase}
+```
+
+### API Calls
+
+```{language}
+// How API calls are mocked: {evidence file:line}
+{actual pattern from codebase}
+```
+
+## Fixtures & Test Data
+
+| Type | Location | Pattern |
+|------|----------|---------|
+| {Factories} | {tests/factories/} | {createUser(), createPost()} |
+| {Fixtures} | {tests/fixtures/} | {JSON files} |
+| {Seeds} | {prisma/seed.ts} | {Prisma seed script} |
+
+## Coverage Configuration
+
+| Setting | Value |
+|---------|-------|
+| Threshold | {if configured: line %, branch %, function %} |
+| Include | {file patterns} |
+| Exclude | {file patterns} |
+| Reporter | {text / html / lcov} |
+
+## E2E Testing
+
+| Aspect | Value | Config |
+|--------|-------|--------|
+| Framework | {Playwright / Cypress / none} | {config file} |
+| Location | {e2e/ or tests/e2e/} | - |
+| Base URL | {config} | - |
+
+## Testing Gaps
+
+| Area | Has Tests | Notes |
+|------|-----------|-------|
+| {Unit tests} | {YES/NO/PARTIAL} | {coverage details} |
+| {Integration tests} | {YES/NO/PARTIAL} | {coverage details} |
+| {E2E tests} | {YES/NO/PARTIAL} | {coverage details} |
+| {API tests} | {YES/NO/PARTIAL} | {coverage details} |