@fermindi/pwn-cli 0.5.0 → 0.7.0

package/templates/workspace/.ai/memory/patterns.md

@@ -1,19 +1,65 @@
-# Codebase Patterns Index
+# Codebase Patterns
 
-This file is an index of patterns documented in `.ai/patterns/`.
-Each entry links to the full pattern file.
+This file documents recurring patterns discovered during development.
 
-## Registered Patterns
+## Format
 
-<!-- AI: Add entries here as you create pattern files -->
-<!-- Format: - [{category}/{name}](.ai/patterns/{category}/{name}.md) - Brief description -->
+Each pattern follows this structure:
 
-_No patterns registered yet._
+```markdown
+## Pattern Category
+
+### Pattern Name
+**Context:** When this pattern applies
+**Pattern:** Code example or description
+**Rationale:** Why this is the better approach
+**Example Location:** Where to find real examples
+```
+
+---
+
+## Add New Patterns
+
+When you discover a useful pattern:
+
+1. Identify the category (Frontend, Backend, Testing, etc.)
+2. Fill in all sections
+3. Add code example if possible
+4. Commit with message: `docs: add pattern - [name]`
+5. Update `patterns/index.md` if this should be auto-applied
+
+---
+
+## Pattern Categories
+
+- **Frontend:** React, TypeScript, styling, component patterns
+- **Backend:** API design, database queries, middleware
+- **Testing:** Unit tests, integration tests, fixtures
+- **Performance:** Caching, memoization, optimization
+- **Security:** Input validation, authentication, authorization
+- **Error Handling:** Exception patterns, recovery strategies
+- **Data Structures:** Modeling domain objects effectively
+
+---
+
+## Template for New Pattern
+
+```markdown
+## [Category]
+
+### [Pattern Name]
+**Context:** (When to use this pattern)
+**Pattern:** (Description or code example)
+**Rationale:** (Why this is better)
+**Example Location:** (Where in codebase)
+```
 
 ---
 
-## How to Add
+## Notes
 
-1. Create pattern file: `.ai/patterns/{category}/{pattern-name}.md`
-2. Add index entry here with link and brief description
-3. Commit both files together
+- Patterns should be language-agnostic when possible
+- Prioritize patterns that prevent common bugs
+- Link related patterns together
+- Update this file as team learns new approaches
+- Archive rarely-used patterns after 3 months of no references

package/templates/workspace/.ai/tasks/active.md

@@ -70,7 +70,7 @@ Highlight 1-3 most important tasks for today.
 
 ## Notes
 
-- Check backlog.md for upcoming work
+- Check prd.json for upcoming stories
 - Move completed tasks to archive or backlog with completion date
 - When stuck, create SPIKE task to investigate
 - Reference decisions from `memory/decisions.md`

package/templates/workspace/.ai/workflows/batch-task.md

@@ -4,103 +4,79 @@ This file defines the template for autonomous batch task execution via the `pwn
 
 ## Overview
 
-Batch task execution allows AI agents to autonomously:
-- Select tasks from backlog
-- Execute work in sequence
+Batch task execution uses `.ai/batch/batch_runner.sh` to autonomously:
+- Read stories from `.ai/tasks/prd.json`
+- Spawn fresh Claude sessions per task
 - Run quality gates (tests, linting, type checking)
-- Commit changes following conventions
-- Continue until backlog depleted or threshold reached
+- Track progress and learnings between iterations
+- Handle retries, rate limits, and circuit breaking
 
 ## Usage
 
 ```bash
-# Execute next available task
-pwn batch
+# Preview next task
+./.ai/batch/batch_runner.sh --dry-run
 
-# Execute specific number of tasks
-pwn batch --count 5
+# Run batch (default 20 iterations)
+./.ai/batch/batch_runner.sh
 
-# Dry-run: show what would execute
-pwn batch --dry-run
+# Custom iteration limit
+./.ai/batch/batch_runner.sh 50
 
-# Execute with specific priority
-pwn batch --priority high
+# Specific phase only
+./.ai/batch/batch_runner.sh --phase 3
 
-# Resume interrupted batch
-pwn batch --resume
+# Via pwn CLI
+pwn batch run
+pwn batch run --dry-run
+pwn batch status
 ```
 
 ## Batch Execution Protocol
 
 ### Phase 1: Task Selection
 
-1. Read `tasks/active.md` for incomplete tasks
-2. If active tasks exist and not blocked, resume
-3. Otherwise, read `tasks/backlog.md`
-4. Select highest priority unblocked task
-5. Verify dependencies are met
-6. Move to `active.md`
+1. Read `tasks/prd.json` for stories
+2. Find next story where `passes == false`
+3. Verify all dependencies have `passes == true`
+4. Apply phase filter if specified
 
 ### Phase 2: Execution
 
-1. Analyze task requirements
-2. Create feature branch: `feature/[task-id]-[slug]`
-3. Execute work following patterns in `patterns/index.md`
-4. Test incrementally during development
-5. Keep commits atomic and descriptive
+1. Build prompt from `.ai/batch/prompt.md` template
+2. Substitute story placeholders ({STORY_ID}, {STORY_TITLE}, etc.)
+3. Spawn: `claude --print --dangerously-skip-permissions -p "<prompt>"`
+4. Capture output to `logs/` for debugging
 
 ### Phase 3: Quality Gates
 
-Before commit, verify:
+Customize `run_quality_gates()` in `batch_runner.sh` for your stack:
 
+**Node.js:**
 ```bash
-# Type checking
-[ ] npm run typecheck || tsc --noEmit
-
-# Linting
-[ ] npm run lint || eslint .
-
-# Unit tests
-[ ] npm run test || jest
-
-# Integration tests (if applicable)
-[ ] npm run test:integration
-
-# Build verification
-[ ] npm run build
+npm test
+npm run lint
+npm run typecheck
+```
 
-# Security scan (if configured)
-[ ] npm run security
+**Python:**
+```bash
+pytest --tb=short
+ruff check src/
+mypy src/ --ignore-missing-imports
 ```
 
 **Gate Strategy:**
 - Fail fast on first error
-- Output clear error message
-- Suggest fix if known
-- Option to skip non-critical gates with `--force`
-
-### Phase 4: Commit & Cleanup
-
-1. Stage all changes: `git add .`
-2. Commit with message format:
-   ```
-   feat: [task-id] - [description]
-
-   - Specific change 1
-   - Specific change 2
-
-   Fixes: [task-id]
-   ```
-3. Push to remote: `git push -u origin feature/[task-id]-[slug]`
-4. Create PR if configured
-5. Update `active.md`: mark complete with date
+- Retry up to 2x with error context fed back to Claude
+- Circuit breaker after 3 consecutive failures
 
-### Phase 5: Completion
+### Phase 4: Completion
 
-1. Verify commit is on remote
-2. Delete local feature branch
-3. Report completion to user
-4. Continue to next task or stop
+1. Mark story as `passes: true` in prd.json
+2. Append learnings to `progress.txt`
+3. Commit prd.json + progress.txt update
+4. Continue to next story
 
 ## Batch Configuration
 

package/templates/workspace/.claude/commands/save.md

@@ -103,50 +103,10 @@ Create a session summary:
 ## Dead Ends
 - DE-XXX: description (if any)
 
-## Patterns Documented
-- [{category}/{name}] - description (if any)
-
 ---
 *Saved: {ISO timestamp}*
 ```
 
-### 6. Pattern Extraction (.ai/patterns/)
-
-Review the entire session and extract patterns. Check each criterion:
-
-1. **User corrected your approach** → Document the correct approach
-2. **You chose between alternatives** → Document what was chosen and why
-3. **Workaround for limitation** → Document the workaround
-4. **Convention established** → Document for consistency
-5. **Repeated approach** → Document to avoid re-deriving
-6. **Non-trivial solution** → Document for future sessions
-
-**For each pattern found:**
-
-1. Create file: `.ai/patterns/{category}/{pattern-name}.md`
-   ```markdown
-   # Pattern Name
-
-   ## Context
-   When to apply this pattern.
-
-   ## Pattern
-   Description or code example.
-
-   ## Rationale
-   Why this approach works better.
-
-   ## Examples
-   - `src/path/file.ts:42`
-   ```
-
-2. Add index entry to `.ai/memory/patterns.md`:
-   ```markdown
-   - [{category}/{name}](.ai/patterns/{category}/{name}.md) - Brief description
-   ```
-
-**If no patterns found:** Confirm "Patterns: no new patterns this session"
-
 ---
 
 ## Output Format
@@ -159,7 +119,6 @@ PWN Save Complete:
 - Tasks: {X} active, {Y} completed
 - Dead Ends: {new count or "no new"}
 - Decisions: {new count or "no new"}
-- Patterns: {new count or "no new"}
 - Archive: .ai/memory/archive/{filename}
 - Last updated: {timestamp}
 ```
@@ -173,7 +132,6 @@ PWN Save Complete:
 3. **decisions.md**: Organized entries with proper DEC-XXX IDs
 4. **active.md**: Only current sprint tasks
 5. **archive/**: One file per session with summary
-6. **patterns/**: One file per pattern, indexed in memory/patterns.md
 
 ---
 

package/cli/codespaces.js

@@ -1,303 +0,0 @@
-import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, chmodSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const cwd = process.cwd();
-
-export default async function codespaces(args) {
-  const subcommand = args[0];
-
-  switch (subcommand) {
-    case 'init':
-      await initCodespaces(args.slice(1));
-      break;
-
-    case 'status':
-      await showStatus();
-      break;
-
-    case 'open':
-      await openCodespace(args.slice(1));
-      break;
-
-    case 'list':
-      await listCodespaces();
-      break;
-
-    default:
-      showHelp();
-  }
-}
-
-function showHelp() {
-  console.log(`
-PWN Codespaces Integration
-
-Usage: pwn codespaces <command> [options]
-
-Commands:
-  init              Add devcontainer config to current project
-  init --minimal    Add minimal devcontainer (no extras)
-  init --docker     Use custom Dockerfile
-  status            Check codespaces configuration
-  open              Open project in GitHub Codespace
-  list              List active codespaces (requires gh CLI)
-
-Examples:
-  pwn codespaces init
-  pwn codespaces init --minimal
-  pwn codespaces open
-  pwn codespaces status
-
-Note: Requires GitHub CLI (gh) for some features.
-      Install: https://cli.github.com/
-`);
-}
-
-async function initCodespaces(args) {
-  const minimal = args.includes('--minimal');
-  const useDockerfile = args.includes('--docker');
-
-  console.log('Setting up Codespaces configuration...\n');
-
-  // Check if .devcontainer already exists
-  const devcontainerDir = join(cwd, '.devcontainer');
-
-  if (existsSync(devcontainerDir)) {
-    if (!args.includes('--force')) {
-      console.log('.devcontainer/ already exists.');
-      console.log('Use --force to overwrite.');
-      return;
-    }
-    console.log('Overwriting existing .devcontainer/...');
-  }
-
-  // Create directory
-  mkdirSync(devcontainerDir, { recursive: true });
-
-  // Copy template files
-  const templateDir = join(__dirname, '..', 'templates', 'codespaces');
-
-  if (minimal) {
-    // Minimal config - just devcontainer.json
-    const minimalConfig = {
-      name: getProjectName(),
-      image: 'mcr.microsoft.com/devcontainers/javascript-node:22',
-      postCreateCommand: 'npm install',
-      forwardPorts: [3000, 5173],
-      remoteUser: 'node'
-    };
-
-    writeFileSync(
-      join(devcontainerDir, 'devcontainer.json'),
-      JSON.stringify(minimalConfig, null, 2)
-    );
-    console.log('Created minimal devcontainer.json');
-
-  } else if (useDockerfile) {
-    // Copy full template with Dockerfile reference
-    const pwmDevcontainerDir = join(__dirname, '..', '.devcontainer');
-
-    cpSync(join(pwmDevcontainerDir, 'Dockerfile'), join(devcontainerDir, 'Dockerfile'));
-    cpSync(join(pwmDevcontainerDir, 'devcontainer.dockerfile.json'), join(devcontainerDir, 'devcontainer.json'));
-    cpSync(join(pwmDevcontainerDir, 'setup-codespace.sh'), join(devcontainerDir, 'setup.sh'));
-
-    console.log('Created devcontainer.json (with Dockerfile)');
-    console.log('Created Dockerfile');
-    console.log('Created setup.sh');
-
-  } else {
-    // Standard setup from templates
-    if (existsSync(templateDir)) {
-      cpSync(join(templateDir, 'devcontainer.json'), join(devcontainerDir, 'devcontainer.json'));
-      cpSync(join(templateDir, 'setup.sh'), join(devcontainerDir, 'setup.sh'));
-    } else {
-      // Fallback: copy from PWN's own devcontainer
-      const pwmDevcontainerDir = join(__dirname, '..', '.devcontainer');
-      cpSync(join(pwmDevcontainerDir, 'devcontainer.json'), join(devcontainerDir, 'devcontainer.json'));
-      cpSync(join(pwmDevcontainerDir, 'setup-codespace.sh'), join(devcontainerDir, 'setup.sh'));
-    }
-
-    // Update project name in devcontainer.json
-    const configPath = join(devcontainerDir, 'devcontainer.json');
-    const config = JSON.parse(readFileSync(configPath, 'utf8'));
-    config.name = getProjectName();
-    writeFileSync(configPath, JSON.stringify(config, null, 2));
-
-    console.log('Created devcontainer.json');
-    console.log('Created setup.sh');
-  }
-
-  // Make setup.sh executable (on Unix systems)
-  try {
-    const setupPath = join(devcontainerDir, 'setup.sh');
-    if (existsSync(setupPath)) {
-      chmodSync(setupPath, '755');
-    }
-  } catch {
-    // Windows doesn't support chmod
-  }
-
-  console.log('\nCodespaces configuration ready!');
-  console.log('\nNext steps:');
-  console.log('  1. Commit the .devcontainer/ folder');
-  console.log('  2. Push to GitHub');
-  console.log('  3. Open in Codespace: gh codespace create');
-  console.log('');
-}
-
-async function showStatus() {
-  console.log('Codespaces Configuration Status\n');
-
-  const devcontainerDir = join(cwd, '.devcontainer');
-  const configPath = join(devcontainerDir, 'devcontainer.json');
-
-  // Check devcontainer
-  if (!existsSync(devcontainerDir)) {
-    console.log('Status: Not configured');
-    console.log('\nRun: pwn codespaces init');
-    return;
-  }
-
-  console.log('Status: Configured');
-  console.log(`Path: ${devcontainerDir}`);
-
-  // Parse config
-  if (existsSync(configPath)) {
-    try {
-      const config = JSON.parse(readFileSync(configPath, 'utf8'));
-      console.log(`\nContainer: ${config.name || 'Unnamed'}`);
-      console.log(`Image: ${config.image || 'Custom Dockerfile'}`);
-
-      if (config.forwardPorts?.length) {
-        console.log(`Ports: ${config.forwardPorts.join(', ')}`);
-      }
-
-      if (config.customizations?.vscode?.extensions?.length) {
-        console.log(`Extensions: ${config.customizations.vscode.extensions.length} configured`);
-      }
-    } catch {
-      console.log('Warning: Could not parse devcontainer.json');
-    }
-  }
-
-  // Check for Dockerfile
-  if (existsSync(join(devcontainerDir, 'Dockerfile'))) {
-    console.log('Dockerfile: Yes (custom build)');
-  }
-
-  // Check for setup script
-  if (existsSync(join(devcontainerDir, 'setup.sh'))) {
-    console.log('Setup script: Yes');
-  }
-
-  // Check if in a codespace
-  if (process.env.PWN_CODESPACE === 'true' || process.env.CODESPACES === 'true') {
-    console.log('\nCurrently running in a Codespace!');
-  }
-
-  // Check GitHub remote
-  try {
-    const remote = execSync('git remote get-url origin', { encoding: 'utf8' }).trim();
-    if (remote.includes('github.com')) {
-      const match = remote.match(/github\.com[:/]([^/]+)\/([^/.]+)/);
-      if (match) {
-        console.log(`\nGitHub: ${match[1]}/${match[2]}`);
-        console.log(`Open: https://github.com/codespaces/new?repo=${match[1]}/${match[2]}`);
-      }
-    }
-  } catch {
-    // Not a git repo or no remote
-  }
-
-  console.log('');
-}
-
-async function openCodespace(args) {
-  // Check for gh CLI
-  try {
-    execSync('gh --version', { stdio: 'ignore' });
-  } catch {
-    console.log('GitHub CLI (gh) not found.');
-    console.log('Install from: https://cli.github.com/');
-    return;
-  }
-
-  // Check auth
-  try {
-    execSync('gh auth status', { stdio: 'ignore' });
-  } catch {
-    console.log('Not authenticated with GitHub CLI.');
-    console.log('Run: gh auth login');
-    return;
-  }
-
-  console.log('Opening project in Codespace...\n');
-
-  try {
-    // Check if there's an existing codespace
-    const existing = execSync('gh codespace list --json name,repository -q ".[] | select(.repository | contains(\\"' + getRepoName() + '\\"))"', {
-      encoding: 'utf8'
-    }).trim();
-
-    if (existing) {
-      console.log('Found existing codespace. Opening...');
-      execSync('gh codespace code', { stdio: 'inherit' });
-    } else {
-      console.log('Creating new codespace...');
-      execSync('gh codespace create --repo ' + getRepoName(), { stdio: 'inherit' });
-    }
-  } catch (error) {
-    console.log('Error:', error.message);
-    console.log('\nTry manually: gh codespace create');
-  }
-}
-
-async function listCodespaces() {
-  try {
-    execSync('gh --version', { stdio: 'ignore' });
-  } catch {
-    console.log('GitHub CLI (gh) not found.');
-    console.log('Install from: https://cli.github.com/');
-    return;
-  }
-
-  console.log('Active Codespaces:\n');
-
-  try {
-    execSync('gh codespace list', { stdio: 'inherit' });
-  } catch {
-    console.log('Could not list codespaces. Make sure you are authenticated.');
-    console.log('Run: gh auth login');
-  }
-}
-
-function getProjectName() {
-  try {
-    const pkgPath = join(cwd, 'package.json');
-    if (existsSync(pkgPath)) {
-      const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-      return pkg.name || 'Development';
-    }
-  } catch {
-    // ignore
-  }
-
-  // Use directory name
-  return cwd.split(/[/\\]/).pop() || 'Development';
-}
-
-function getRepoName() {
-  try {
-    const remote = execSync('git remote get-url origin', { encoding: 'utf8' }).trim();
-    const match = remote.match(/github\.com[:/]([^/]+\/[^/.]+)/);
-    if (match) {
-      return match[1].replace('.git', '');
-    }
-  } catch {
-    // ignore
-  }
-  return '';
-}