@fermindi/pwn-cli 0.6.0 → 0.7.0

package/cli/backlog.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { hasWorkspace } from '../src/core/state.js';
+import { parsePrdTasks } from '../src/services/batch-service.js';
+import { listTaskFiles } from '../src/services/batch-runner.js';
+import { startViewer, printPlain } from '../src/ui/backlog-viewer.js';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+export default async function backlogCommand(args = []) {
+  if (args.includes('--help') || args.includes('-h')) {
+    showHelp();
+    return;
+  }
+
+  if (!hasWorkspace()) {
+    console.log('❌ No PWN workspace found\n');
+    console.log('   Run: pwn inject');
+    process.exit(1);
+  }
+
+  const cwd = process.cwd();
+  const stories = parsePrdTasks(cwd);
+  const taskFiles = listTaskFiles(cwd);
+
+  // Read project name from prd.json
+  let project = 'project';
+  const prdPath = join(cwd, '.ai', 'tasks', 'prd.json');
+  if (existsSync(prdPath)) {
+    try {
+      const prd = JSON.parse(readFileSync(prdPath, 'utf8'));
+      project = prd.project || project;
+    } catch {}
+  }
+
+  const noInteractive = args.includes('--no-interactive') || !process.stdout.isTTY;
+
+  if (noInteractive) {
+    printPlain({ project, stories, taskFiles });
+  } else {
+    await startViewer({ project, stories, taskFiles });
+  }
+}
+
+function showHelp() {
+  console.log('📋 PWN Backlog Viewer\n');
+  console.log('Usage: pwn backlog [options]\n');
+  console.log('Options:');
+  console.log('  --no-interactive    Plain text output (for CI/piping)');
+  console.log('  --help, -h          Show this help\n');
+  console.log('Keybindings (list view):');
+  console.log('  ↑/k        Move up');
+  console.log('  ↓/j        Move down');
+  console.log('  Enter      Open full detail view');
+  console.log('  Home/End   First/last story');
+  console.log('  q/Ctrl+C   Quit\n');
+  console.log('Keybindings (detail view):');
+  console.log('  ↑/k ↓/j    Scroll content');
+  console.log('  ←/→        Previous/next story');
+  console.log('  Esc/Bksp   Back to list');
+}

package/cli/batch.js

@@ -1,6 +1,4 @@
 #!/usr/bin/env node
-import { execSync } from 'child_process';
-import { join } from 'path';
 import * as batch from '../src/services/batch-service.js';
 import { hasWorkspace } from '../src/core/state.js';
 
@@ -29,16 +27,14 @@ export default async function batchCommand(args = []) {
     return showConfig();
   }
 
+  if (subcommand === 'tasks') {
+    return showTasks(args.slice(1));
+  }
+
   if (subcommand === 'run') {
-    const runnerPath = join(process.cwd(), '.ai', 'batch', 'batch_runner.sh');
-    try {
-      execSync(`bash ${runnerPath} ${args.slice(1).join(' ')}`, {
-        cwd: process.cwd(),
-        stdio: 'inherit'
-      });
-    } catch (error) {
-      process.exit(error.status || 1);
-    }
+    const runArgs = parseRunOptions(args.slice(1));
+    const { runBatch } = await import('../src/services/batch-runner.js');
+    await runBatch(runArgs, process.cwd());
     return;
   }
 
@@ -94,6 +90,31 @@ function parseOptions(args) {
   return options;
 }
 
+/**
+ * Parse options for `pwn batch run`
+ */
+function parseRunOptions(args) {
+  const options = {};
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    if (arg === '--dry-run') {
+      options.dryRun = true;
+    } else if (arg === '--phase') {
+      options.phase = args[++i];
+    } else if (arg === '--no-plan') {
+      options.noPlan = true;
+    } else if (arg === '--rate-limit-wait') {
+      options.rateLimitWait = parseInt(args[++i], 10);
+    } else if (/^\d+$/.test(arg)) {
+      options.maxIterations = parseInt(arg, 10);
+    }
+  }
+
+  return options;
+}
+
 /**
  * Show batch status
  */
@@ -167,8 +188,6 @@ function showConfig() {
   console.log(`   Create PR: ${config.create_pr ? 'Yes' : 'No'}`);
   console.log(`   Branch Format: ${config.branch_format}`);
   console.log(`   Commit Format: ${config.commit_format}`);
-  console.log(`\n   Notify Complete: ${config.notify_on_complete ? 'Yes' : 'No'}`);
-  console.log(`   Notify Error: ${config.notify_on_error ? 'Yes' : 'No'}`);
   console.log('\n📁 Config location: .ai/state.json (batch_config)');
 }
 
@@ -308,6 +327,67 @@ async function resumeBatch(options) {
   console.log(`   Completed: ${result.completed?.length || 0} tasks`);
 }
 
+/**
+ * Show task files from .ai/batch/tasks/
+ */
+async function showTasks(args) {
+  const { listTaskFiles, deleteTaskFile } = await import('../src/services/batch-runner.js');
+  const cwd = process.cwd();
+  const failedOnly = args.includes('--failed');
+  const cleanMode = args.includes('--clean');
+
+  if (cleanMode) {
+    const completed = listTaskFiles(cwd, { statusFilter: 'completed' });
+    if (completed.length === 0) {
+      console.log('No completed task files to clean.');
+      return;
+    }
+    let cleaned = 0;
+    for (const task of completed) {
+      if (deleteTaskFile(task.id, cwd)) cleaned++;
+    }
+    console.log(`Cleaned ${cleaned} completed task file(s).`);
+    return;
+  }
+
+  const filter = failedOnly ? { statusFilter: 'failed' } : {};
+  const tasks = listTaskFiles(cwd, filter);
+
+  if (tasks.length === 0) {
+    console.log(failedOnly ? 'No failed tasks.' : 'No task files found.');
+    return;
+  }
+
+  const title = failedOnly ? 'Failed Tasks' : 'Batch Task Files';
+  console.log(`\n${title}\n`);
+
+  for (const task of tasks) {
+    const statusColor = task.status === 'completed' ? 'green'
+      : task.status === 'failed' ? 'red'
+      : 'yellow';
+    const statusLabel = chalk[statusColor](task.status.toUpperCase());
+    const complexity = task.complexity ? ` [${task.complexity}]` : '';
+    const estimate = task.estimated_time_seconds
+      ? ` ~${Math.round(task.estimated_time_seconds)}s`
+      : '';
+
+    console.log(`  ${task.id}: ${task.title}`);
+    console.log(`    Status: ${statusLabel}${complexity}${estimate}`);
+
+    if (task.status === 'failed' && task.failure_reason) {
+      const reason = task.failure_reason.length > 120
+        ? task.failure_reason.slice(0, 120) + '...'
+        : task.failure_reason;
+      console.log(`    Reason: ${chalk.dim(reason)}`);
+    }
+
+    if (task.plan && task.plan.length > 0 && task.plan[0] !== 'fallback - no plan available') {
+      console.log(`    Plan: ${chalk.dim(task.plan.join(' → '))}`);
+    }
+    console.log('');
+  }
+}
+
 /**
  * Show help
  */
@@ -316,7 +396,8 @@ function showHelp() {
   console.log('Usage: pwn batch [command] [options]\n');
   console.log('Commands:');
   console.log('  (default)              Execute next available task(s)');
-  console.log('  run                    Run batch_runner.sh (autonomous loop)');
+  console.log('  run                    Run autonomous batch loop (Node.js TUI)');
+  console.log('  tasks                  List batch task files');
   console.log('  status                 Show batch status');
   console.log('  config                 Show batch configuration\n');
   console.log('Options:');
@@ -329,12 +410,18 @@ function showHelp() {
   console.log('  --continue             Continue on errors');
   console.log('  --no-commit            Skip auto-commit');
   console.log('  --no-branch            Skip branch creation');
+  console.log('  --no-plan              Skip planning phase (use fixed 10min timeout)');
+  console.log('  --rate-limit-wait <s>  Seconds to wait on rate limit (default: 1800)');
   console.log('  --help, -h             Show this help\n');
   console.log('Examples:');
   console.log('  pwn batch                    # Execute next task');
   console.log('  pwn batch run                # Run autonomous batch loop');
   console.log('  pwn batch run --dry-run      # Preview next story');
   console.log('  pwn batch run --phase 3      # Run specific phase');
+  console.log('  pwn batch run --no-plan      # Skip planning, fixed timeout');
+  console.log('  pwn batch tasks              # List all task files');
+  console.log('  pwn batch tasks --failed     # Show only failed tasks');
+  console.log('  pwn batch tasks --clean      # Delete completed task files');
   console.log('  pwn batch --count 5          # Execute 5 tasks');
   console.log('  pwn batch --dry-run          # Preview execution');
   console.log('  pwn batch --resume           # Resume paused batch');

package/cli/index.js

@@ -22,31 +22,24 @@ if (!command || command === '--help' || command === '-h') {
   console.log('Commands:');
   console.log('  inject              Inject .ai/ workspace into current project');
   console.log('  update              Update PWN framework files to latest version');
-  console.log('  migrate             Migrate existing AI files to PWN structure');
   console.log('  save                Save session context to memory');
   console.log('  status              Show workspace status');
   console.log('  validate            Validate workspace structure');
-  console.log('  notify              Send notifications (test, send, config)');
+  console.log('  backlog             Interactive backlog viewer (prd.json)');
   console.log('  batch               Execute tasks (batch run = autonomous loop)');
-  console.log('  mode                Manage session mode (interactive/batch)');
   console.log('  patterns            Manage patterns and triggers');
   console.log('  knowledge           Knowledge lifecycle management');
-  console.log('  codespaces          GitHub Codespaces integration');
   console.log('  --version, -v       Show version');
   console.log('  --help, -h          Show help\n');
   console.log('Options:');
   console.log('  inject --force      Overwrite existing .ai/ directory');
   console.log('  update --dry-run    Preview update without changes');
-  console.log('  migrate --dry-run   Preview migration without changes');
   console.log('  save --message=X    Save with custom summary');
   console.log('  validate --verbose  Show detailed structure report');
-  console.log('  notify test [ch]    Test notification channel');
   console.log('  batch run           Run autonomous batch loop');
-  console.log('  mode batch --max-tasks=3  Configure batch mode');
   console.log('  patterns eval <f>   Evaluate triggers for file');
-  console.log('  knowledge status    Show knowledge system status');
-  console.log('  codespaces init     Add devcontainer config\n');
-  console.log('Documentation: https://github.com/anthropics/pwn');
+  console.log('  knowledge status    Show knowledge system status\n');
+  console.log('Documentation: https://github.com/fermindi/pwn');
   process.exit(0);
 }
 
@@ -62,11 +55,6 @@ switch (command) {
     await update(args);
     break;
 
-  case 'migrate':
-    const { default: migrate } = await import('./migrate.js');
-    await migrate(args);
-    break;
-
   case 'save':
     const { default: save } = await import('./save.js');
     await save(args);
@@ -82,9 +70,9 @@ switch (command) {
     await validate(args);
     break;
 
-  case 'notify':
-    const { default: notify } = await import('./notify.js');
-    await notify(args);
+  case 'backlog':
+    const { default: backlogCmd } = await import('./backlog.js');
+    await backlogCmd(args);
     break;
 
   case 'batch':
@@ -92,11 +80,6 @@ switch (command) {
     await batchCmd(args);
     break;
 
-  case 'mode':
-    const { default: modeCmd } = await import('./mode.js');
-    await modeCmd(args);
-    break;
-
   case 'patterns':
     const { default: patternsCmd } = await import('./patterns.js');
     await patternsCmd(args);
@@ -107,13 +90,8 @@ switch (command) {
     await knowledgeCmd(args);
     break;
 
-  case 'codespaces':
-    const { default: codespacesCmd } = await import('./codespaces.js');
-    await codespacesCmd(args);
-    break;
-
   default:
-    console.log(`❌ Unknown command: ${command}`);
+    console.log(`Unknown command: ${command}`);
     console.log('   Run: pwn --help');
     process.exit(1);
 }

package/cli/inject.js

@@ -1,6 +1,4 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
 import { inject, detectKnownAIFiles } from '../src/core/inject.js';
 
 export default async function injectCommand(args = []) {
@@ -22,17 +20,11 @@ export default async function injectCommand(args = []) {
       console.log(`      Type: ${file.type} - ${file.description}`);
     }
 
-    if (migratable.length > 0) {
-      console.log('\n   🔄 Run "pwn migrate" to automatically migrate content:');
-      console.log('      pwn migrate --dry-run   # Preview changes');
-      console.log('      pwn migrate             # Execute migration\n');
-    } else {
-      console.log('\n   💡 Consider migrating content manually to .ai/ structure:');
-      console.log('      - Instructions  → .ai/agents/claude.md');
-      console.log('      - Decisions     → .ai/memory/decisions.md');
-      console.log('      - Patterns      → .ai/memory/patterns.md');
-      console.log('      - Tasks         → .ai/tasks/active.md\n');
-    }
+    console.log('\n   💡 Consider migrating content manually to .ai/ structure:');
+    console.log('      - Instructions  → .ai/agents/claude.md');
+    console.log('      - Decisions     → .ai/memory/decisions.md');
+    console.log('      - Patterns      → .ai/memory/patterns.md');
+    console.log('      - Tasks         → .ai/tasks/active.md\n');
   }
 
   if (!result.success) {
@@ -63,30 +55,13 @@ export default async function injectCommand(args = []) {
   console.log('   ├── memory/         (decisions, patterns, dead-ends)');
   console.log('   ├── tasks/          (active work, prd.json)');
   console.log('   ├── patterns/       (auto-applied patterns)');
-  console.log('   ├── batch/          (batch runner, prompts)
-   ├── workflows/      (batch execution)');
+  console.log('   ├── batch/          (batch runner, prompts)');
+  console.log('   ├── workflows/      (batch execution)');
   console.log('   ├── agents/         (AI agent configs)');
-  console.log('   └── config/         (notifications, etc)');
+  console.log('   └── config/         (project config)');
   console.log('   .claude/');
   console.log('   └── commands/       (slash commands: /save)\n');
 
-  // Show ntfy topic if generated
-  const notifyPath = join(process.cwd(), '.ai', 'config', 'notifications.json');
-  if (existsSync(notifyPath)) {
-    try {
-      const config = JSON.parse(readFileSync(notifyPath, 'utf8'));
-      const topic = config.channels?.ntfy?.topic;
-      if (topic && !topic.includes('your-unique')) {
-        console.log('🔔 Notifications:');
-        console.log(`   ntfy topic: ${topic}`);
-        console.log(`   Subscribe:  https://ntfy.sh/${topic}`);
-        console.log('   Enable:     Edit .ai/config/notifications.json\n');
-      }
-    } catch {
-      // Ignore
-    }
-  }
-
   console.log('📖 Next steps:');
   console.log('   1. Read: .ai/README.md');
   console.log('   2. Start working with AI assistance\n');

package/cli/update.js

@@ -2,7 +2,7 @@
 import { existsSync, readFileSync, writeFileSync, cpSync, renameSync, mkdirSync, readdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
-import { convertBacklogToPrd } from '../src/services/batch-service.js';
+import { convertBacklogToPrd, detectAvailableGates } from '../src/services/batch-service.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -18,10 +18,8 @@ const FRAMEWORK_FILES = [
   'patterns/backend/backend.template.md',
   'patterns/universal/universal.template.md',
   'workflows/batch-task.md',
-  'batch/batch_runner.sh',
   'batch/prompt.md',
   'batch/progress.txt',
-  'batch/prd_status.sh',
   'config/README.md',
   'README.md',
 ];
@@ -31,7 +29,6 @@ const FRAMEWORK_FILES = [
  */
 const CLAUDE_COMMANDS = [
   'save.md',
-  'mode.md',
 ];
 
 /**
@@ -46,7 +43,6 @@ const USER_FILES = [
   'tasks/active.md',
   'tasks/prd.json',
   'state.json',
-  'config/notifications.json',
 ];
 
 export default async function updateCommand(args = []) {
@@ -262,25 +258,6 @@ export default async function updateCommand(args = []) {
     }
   }
 
-  // Update .claude/settings.json (hooks) - only if doesn't exist (user config)
-  const claudeSettingsTemplate = join(__dirname, '../templates/workspace/.claude/settings.json');
-  const claudeSettingsTarget = join(cwd, '.claude', 'settings.json');
-
-  if (existsSync(claudeSettingsTemplate) && !existsSync(claudeSettingsTarget)) {
-    if (dryRun) {
-      console.log(`   📝 Would create: .claude/settings.json (notification hooks)`);
-    } else {
-      const claudeDir = join(cwd, '.claude');
-      if (!existsSync(claudeDir)) {
-        mkdirSync(claudeDir, { recursive: true });
-      }
-      const templateContent = readFileSync(claudeSettingsTemplate, 'utf8');
-      writeFileSync(claudeSettingsTarget, templateContent);
-      console.log(`   📝 Created: .claude/settings.json (notification hooks)`);
-    }
-    updated.push('.claude/settings.json');
-  }
-
   // Update state.json with new version
   if (!dryRun && existsSync(statePath)) {
     try {
@@ -293,6 +270,36 @@ export default async function updateCommand(args = []) {
     }
   }
 
+  // Re-detect quality gates and update skip_gates
+  if (!dryRun) {
+    const gates = detectAvailableGates(cwd);
+    console.log('\n⚙️  Quality Gates Detection');
+    for (const gate of gates.available) {
+      console.log(`   ✅ ${gate.padEnd(12)} ${gates.details[gate]}`);
+    }
+    for (const gate of gates.missing) {
+      console.log(`   ⚠️  ${gate.padEnd(12)} not detected`);
+    }
+    if (gates.missing.length > 0) {
+      console.log(`   → Auto-configured skip_gates: ${JSON.stringify(gates.missing)}`);
+    } else {
+      console.log(`   → All gates available`);
+    }
+
+    // Update skip_gates in state.json
+    if (existsSync(statePath)) {
+      try {
+        const state = JSON.parse(readFileSync(statePath, 'utf8'));
+        if (!state.batch_config) state.batch_config = {};
+        state.batch_config.skip_gates = gates.missing;
+        state.last_updated = new Date().toISOString();
+        writeFileSync(statePath, JSON.stringify(state, null, 2));
+      } catch {
+        // Ignore
+      }
+    }
+  }
+
   // Summary
   console.log('');
   if (updated.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fermindi/pwn-cli",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Professional AI Workspace - Inject structured memory and automation into any project for AI-powered development",
   "type": "module",
   "bin": {
@@ -14,7 +14,6 @@
     "./core/validate": "./src/core/validate.js",
     "./core/workspace": "./src/core/workspace.js",
     "./services/batch": "./src/services/batch-service.js",
-    "./services/notifications": "./src/services/notification-service.js",
     "./patterns/registry": "./src/patterns/registry.js",
     "./patterns/triggers": "./src/patterns/triggers.js",
     "./knowledge/lifecycle": "./src/knowledge/lifecycle.js",
@@ -47,7 +46,7 @@
     "memory",
     "decisions",
     "batch",
-    "codespaces",
+    "claude-code",
     "developer-tools",
     "productivity"
   ],
@@ -66,5 +65,9 @@
   },
   "devDependencies": {
     "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "ora": "^9.3.0"
   }
 }

package/src/core/inject.js

@@ -1,9 +1,9 @@
 import { existsSync, cpSync, renameSync, readFileSync, appendFileSync, writeFileSync, readdirSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
-import { randomUUID } from 'crypto';
 import { initState } from './state.js';
-import { convertBacklogToPrd } from '../services/batch-service.js';
+import { convertBacklogToPrd, detectAvailableGates } from '../services/batch-service.js';
+import { updateState } from './state.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -175,18 +175,24 @@ export async function inject(options = {}) {
       renameSync(templateState, stateFile);
     }
 
-    // Rename notifications.template.json → notifications.json and generate unique topic
-    const templateNotify = join(targetDir, 'config', 'notifications.template.json');
-    const notifyFile = join(targetDir, 'config', 'notifications.json');
-
-    if (existsSync(templateNotify)) {
-      renameSync(templateNotify, notifyFile);
-      initNotifications(notifyFile);
-    }
-
     // Initialize state.json with current user
     initState(cwd);
 
+    // Detect available quality gates and auto-configure skip_gates
+    const gates = detectAvailableGates(cwd);
+    log('\n⚙️  Quality Gates Detection');
+    for (const gate of gates.available) {
+      log(`   ✅ ${gate.padEnd(12)} ${gates.details[gate]}`);
+    }
+    for (const gate of gates.missing) {
+      log(`   ⚠️  ${gate.padEnd(12)} not detected`);
+    }
+    if (gates.missing.length > 0) {
+      log(`   → Auto-configured skip_gates: ${JSON.stringify(gates.missing)}`);
+      updateState({ batch_config: { skip_gates: gates.missing } }, cwd);
+    }
+    log('');
+
     // Write migrated prd.json (from backlog.md) if available
     if (migratedPrd) {
       const prdPath = join(targetDir, 'tasks', 'prd.json');
@@ -242,15 +248,6 @@ export async function inject(options = {}) {
         }
       }
 
-      // Copy settings.json with hooks (if doesn't exist)
-      const settingsSource = join(claudeTemplateDir, 'settings.json');
-      const settingsTarget = join(claudeDir, 'settings.json');
-      if (existsSync(settingsSource) && !existsSync(settingsTarget)) {
-        cpSync(settingsSource, settingsTarget);
-        if (!silent) {
-          console.log('📝 Created .claude/settings.json with notification hooks');
-        }
-      }
     }
 
     // Backup other AI files (not CLAUDE.md) to .ai/
@@ -280,24 +277,6 @@ export async function inject(options = {}) {
   }
 }
 
-/**
- * Initialize notifications.json with unique topic
- * @param {string} notifyFile - Path to notifications.json
- */
-function initNotifications(notifyFile) {
-  try {
-    const content = readFileSync(notifyFile, 'utf8');
-    const config = JSON.parse(content);
-
-    // Generate unique topic ID
-    const uniqueId = randomUUID().split('-')[0]; // First segment: 8 chars
-    config.channels.ntfy.topic = `pwn-${uniqueId}`;
-
-    writeFileSync(notifyFile, JSON.stringify(config, null, 2));
-  } catch {
-    // Ignore errors - notifications will use defaults
-  }
-}
 
 /**
  * Backup existing AI files to .ai/ root with ~ prefix
@@ -351,7 +330,7 @@ function updateGitignore(cwd, silent = false) {
   }
 
   if (!gitignoreContent.includes('.ai/state.json')) {
-    const pwnSection = '\n# PWN\n.ai/state.json\n.ai/config/notifications.json\n';
+    const pwnSection = '\n# PWN\n.ai/state.json\n';
     appendFileSync(gitignorePath, pwnSection);
     if (!silent) {
       console.log('📝 Updated .gitignore');

package/src/core/state.js

@@ -95,7 +95,6 @@ export function initState(cwd = process.cwd()) {
   const state = {
     developer: getGitUser(),
     session_started: new Date().toISOString(),
-    session_mode: 'interactive',
     current_task: null,
     context_loaded: [],
     batch_config: { ...DEFAULT_BATCH_CONFIG }

package/src/core/validate.js

@@ -27,10 +27,8 @@ const REQUIRED_STRUCTURE = {
     'tasks/prd.json'
   ],
   batchFiles: [
-    'batch/batch_runner.sh',
     'batch/prompt.md',
-    'batch/progress.txt',
-    'batch/prd_status.sh'
+    'batch/progress.txt'
   ],
   agentFiles: [
     'agents/README.md',

package/src/index.js

@@ -5,7 +5,6 @@ export { validate } from './core/validate.js';
 export { getWorkspaceInfo } from './core/workspace.js';
 
 // Services
-export * as notifications from './services/notification-service.js';
 export * as batch from './services/batch-service.js';
 
 // Patterns