@agentic15.com/agentic15-claude-zen 4.1.6 → 4.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic15.com/agentic15-claude-zen",
-  "version": "4.1.6",
+  "version": "4.2.0",
   "description": "Structured AI-assisted development framework for Claude Code with enforced quality standards",
   "main": "src/index.js",
   "bin": {

package/src/cli/CommitCommand.js

@@ -267,6 +267,11 @@ export class CommitCommand {
       if (taskInTracker) {
         taskInTracker.status = 'completed';
         taskInTracker.completedAt = new Date().toISOString();
+
+        // Clear active task and update statistics
+        tracker.activeTask = null;
+        this.updateStatistics(tracker);
+
         writeFileSync(trackerPath, JSON.stringify(tracker, null, 2));
         console.log(`\n✅ Marked ${task.id} as completed`);
       }
@@ -276,6 +281,20 @@ export class CommitCommand {
     }
   }
 
+  static updateStatistics(tracker) {
+    const completed = tracker.taskFiles.filter(t => t.status === 'completed').length;
+    const inProgress = tracker.taskFiles.filter(t => t.status === 'in_progress').length;
+    const pending = tracker.taskFiles.filter(t => t.status === 'pending').length;
+    const totalTasks = tracker.taskFiles.length;
+
+    tracker.statistics = {
+      totalTasks,
+      completed,
+      inProgress,
+      pending
+    };
+  }
+
   static displaySummary(task, prUrl, tracker) {
     console.log('\n┌─────────────────────────────────────────┐');
     console.log('│  ✅ Commit Workflow Complete           │');

package/src/cli/PlanCommand.js

@@ -1,282 +1,291 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'fs';
-import { join } from 'path';
-import readline from 'readline';
-
-export class PlanCommand {
-  static async handle(description) {
-    // Check if plan already exists
-    const activePlanPath = join(process.cwd(), '.claude', 'ACTIVE-PLAN');
-
-    if (existsSync(activePlanPath)) {
-      const planId = readFileSync(activePlanPath, 'utf-8').trim();
-      const planPath = join(process.cwd(), '.claude', 'plans', planId);
-      const projectPlanPath = join(planPath, 'PROJECT-PLAN.json');
-
-      // Check if plan file exists
-      if (existsSync(projectPlanPath)) {
-        // Plan exists, check if it's locked
-        const lockedPath = join(planPath, '.plan-locked');
-
-        if (existsSync(lockedPath)) {
-          console.log('\n⚠️  Plan already locked');
-          console.log(`   Plan: ${planId}\n`);
-          this.showPlanStatus(planId);
-          process.exit(0);
-        }
-
-        // Plan exists but not locked - lock it
-        console.log('\n📋 Found existing plan, locking it...\n');
-        return this.lockPlan(planId);
-      } else {
-        // Requirements exist but plan not created yet
-        console.log('\n⚠️  Waiting for PROJECT-PLAN.json');
-        console.log(`   Tell Claude: "Create the project plan"\n`);
-        process.exit(0);
-      }
-    }
-
-    // No plan exists - create new one
-    if (!description) {
-      // No description provided - enter interactive mode
-      console.log('\n📝 Interactive Requirements Mode');
-      console.log('━'.repeat(70));
-      console.log('Enter your project requirements below.');
-      console.log('You can paste multiple lines, URLs, or write detailed specs.');
-      console.log('Press Ctrl+D (Mac/Linux) or Ctrl+Z then Enter (Windows) when done.\n');
-
-      description = await this.promptMultilineInput();
-
-      if (!description || description.trim().length === 0) {
-        console.log('\n❌ No requirements provided\n');
-        process.exit(1);
-      }
-    }
-
-    return this.generatePlan(description);
-  }
-
-  static async promptMultilineInput() {
-    return new Promise((resolve) => {
-      const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout
-      });
-
-      let lines = [];
-
-      rl.on('line', (line) => {
-        lines.push(line);
-      });
-
-      rl.on('close', () => {
-        resolve(lines.join('\n'));
-      });
-    });
-  }
-
-  static generatePlan(description) {
-    console.log('\n📋 Generating new plan...\n');
-
-    try {
-      // Create plan ID
-      const planId = this.getNextPlanId();
-      const planPath = join(process.cwd(), '.claude', 'plans', planId);
-
-      // Create plan directory
-      mkdirSync(planPath, { recursive: true });
-
-      // Create PROJECT-REQUIREMENTS.txt
-      const requirementsPath = join(planPath, 'PROJECT-REQUIREMENTS.txt');
-      const requirementsContent = `PROJECT REQUIREMENTS
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-${description}
-
-Generated: ${new Date().toISOString()}
-PLAN ID: ${planId}
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-INSTRUCTIONS FOR CLAUDE
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Please analyze the requirements above and create a comprehensive project plan.
-
-1. Read the PLAN-SCHEMA.json to understand the plan structure
-2. Read the PROJECT-PLAN-TEMPLATE.json for the format
-3. Create a PROJECT-PLAN.json file in this directory with:
-   - Clear project/subproject/milestone hierarchy
-   - Detailed tasks with IDs (TASK-001, TASK-002, etc.)
-   - Proper dependencies between tasks
-   - Realistic time estimates
-   - Phases: design, implementation, testing, deployment
-   - Completion criteria for each task
-
-4. Structure the plan to follow these phases:
-   - DESIGN: Architecture, UI/UX, database schema
-   - IMPLEMENTATION: Core features, API, frontend
-   - TESTING: Unit tests, integration tests, E2E tests
-   - DEPLOYMENT: Build, CI/CD, documentation
-
-5. Ensure tasks are:
-   - Granular (2-8 hours each)
-   - Clearly defined with specific deliverables
-   - Properly sequenced with dependencies
-   - Grouped logically by feature/component
-
-6. After creating the plan, tell the user to run:
-   npx agentic15 plan
-
-This will lock the plan and generate the task tracker.
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-GENERATED: ${new Date().toISOString()}
-`;
-
-      writeFileSync(requirementsPath, requirementsContent);
-
-      // Set as active plan
-      const claudeDir = join(process.cwd(), '.claude');
-      if (!existsSync(claudeDir)) {
-        mkdirSync(claudeDir, { recursive: true });
-      }
-      const activePlanPath = join(claudeDir, 'ACTIVE-PLAN');
-      writeFileSync(activePlanPath, planId);
-
-      console.log(`✅ Plan requirements created: ${planId}`);
-      console.log(`   Location: .claude/plans/${planId}/PROJECT-REQUIREMENTS.txt\n`);
-      console.log('💡 Next steps:');
-      console.log(`   1. Tell Claude: "Create the project plan"`);
-      console.log(`   2. When Claude is done, run: npx agentic15 plan\n`);
-    } catch (error) {
-      console.log(`\n❌ Failed to generate plan: ${error.message}\n`);
-      process.exit(1);
-    }
-  }
-
-  static lockPlan(planId) {
-    console.log(`📋 Locking plan: ${planId}\n`);
-
-    try {
-      const planPath = join(process.cwd(), '.claude', 'plans', planId);
-      const projectPlanPath = join(planPath, 'PROJECT-PLAN.json');
-
-      // Verify PROJECT-PLAN.json exists
-      if (!existsSync(projectPlanPath)) {
-        console.log('\n❌ PROJECT-PLAN.json not found');
-        console.log('   Tell Claude to create the plan first\n');
-        process.exit(1);
-      }
-
-      // Read the plan
-      const plan = JSON.parse(readFileSync(projectPlanPath, 'utf-8'));
-
-      // Extract tasks from plan
-      const tasks = [];
-      this.extractTasks(plan, tasks);
-
-      // Create task files
-      const tasksDir = join(planPath, 'tasks');
-      if (!existsSync(tasksDir)) {
-        mkdirSync(tasksDir, { recursive: true });
-      }
-
-      // Write individual task files
-      tasks.forEach(task => {
-        const taskPath = join(tasksDir, `${task.id}.json`);
-        writeFileSync(taskPath, JSON.stringify(task, null, 2));
-      });
-
-      // Create task tracker
-      const tracker = {
-        planId,
-        lockedAt: new Date().toISOString(),
-        taskFiles: tasks.map(task => ({
-          id: task.id,
-          title: task.title,
-          phase: task.phase || 'implementation',
-          status: 'pending',
-          description: task.description
-        }))
-      };
-
-      const trackerPath = join(planPath, 'TASK-TRACKER.json');
-      writeFileSync(trackerPath, JSON.stringify(tracker, null, 2));
-
-      // Mark as locked
-      const lockedPath = join(planPath, '.plan-locked');
-      writeFileSync(lockedPath, new Date().toISOString());
-
-      console.log('✅ Plan locked successfully\n');
-      this.showPlanStatus(planId);
-      console.log('💡 Next step: npx agentic15 task next\n');
-    } catch (error) {
-      console.log(`\n❌ Failed to lock plan: ${error.message}\n`);
-      process.exit(1);
-    }
-  }
-
-  static extractTasks(obj, tasks) {
-    // Recursively extract all tasks from the plan structure
-    if (obj.tasks && Array.isArray(obj.tasks)) {
-      tasks.push(...obj.tasks);
-    }
-
-    // Check nested structures
-    if (obj.milestones && Array.isArray(obj.milestones)) {
-      obj.milestones.forEach(milestone => this.extractTasks(milestone, tasks));
-    }
-
-    if (obj.subprojects && Array.isArray(obj.subprojects)) {
-      obj.subprojects.forEach(subproject => this.extractTasks(subproject, tasks));
-    }
-
-    if (obj.projects && Array.isArray(obj.projects)) {
-      obj.projects.forEach(project => this.extractTasks(project, tasks));
-    }
-
-    // Handle singular 'project' at root level (v2.0 schema)
-    if (obj.project && typeof obj.project === 'object') {
-      this.extractTasks(obj.project, tasks);
-    }
-  }
-
-  static getNextPlanId() {
-    const plansDir = join(process.cwd(), '.claude', 'plans');
-
-    if (!existsSync(plansDir)) {
-      mkdirSync(plansDir, { recursive: true });
-    }
-
-    const existingPlans = readdirSync(plansDir)
-      .filter(name => name.match(/^plan-\d{3}-/i))
-      .map(name => parseInt(name.match(/^plan-(\d{3})-/i)[1]))
-      .filter(num => !isNaN(num));
-
-    const nextNum = existingPlans.length > 0 ? Math.max(...existingPlans) + 1 : 1;
-
-    return `plan-${String(nextNum).padStart(3, '0')}-generated`;
-  }
-
-  static showPlanStatus(planId) {
-    const trackerPath = join(process.cwd(), '.claude', 'plans', planId, 'TASK-TRACKER.json');
-
-    if (!existsSync(trackerPath)) {
-      return;
-    }
-
-    try {
-      const tracker = JSON.parse(readFileSync(trackerPath, 'utf-8'));
-
-      const total = tracker.taskFiles.length;
-      const completed = tracker.taskFiles.filter(t => t.status === 'completed').length;
-      const pending = tracker.taskFiles.filter(t => t.status === 'pending').length;
-
-      console.log('📊 Plan Status:');
-      console.log(`   Total Tasks: ${total}`);
-      console.log(`   Completed:   ${completed}`);
-      console.log(`   Pending:     ${pending}\n`);
-    } catch (e) {
-      // Ignore errors
-    }
-  }
-}
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'fs';
+import { join, basename } from 'path';
+import readline from 'readline';
+
+export class PlanCommand {
+  static async handle(description) {
+    // Check if plan already exists
+    const activePlanPath = join(process.cwd(), '.claude', 'ACTIVE-PLAN');
+
+    if (existsSync(activePlanPath)) {
+      const planId = readFileSync(activePlanPath, 'utf-8').trim();
+      const planPath = join(process.cwd(), '.claude', 'plans', planId);
+      const projectPlanPath = join(planPath, 'PROJECT-PLAN.json');
+
+      // Check if plan file exists
+      if (existsSync(projectPlanPath)) {
+        // Plan exists, check if it's locked
+        const lockedPath = join(planPath, '.plan-locked');
+
+        if (existsSync(lockedPath)) {
+          console.log('\n⚠️  Plan already locked');
+          console.log(`   Plan: ${planId}\n`);
+          this.showPlanStatus(planId);
+          process.exit(0);
+        }
+
+        // Plan exists but not locked - lock it
+        console.log('\n📋 Found existing plan, locking it...\n');
+        return this.lockPlan(planId);
+      } else {
+        // Requirements exist but plan not created yet
+        console.log('\n⚠️  Waiting for PROJECT-PLAN.json');
+        console.log(`   Tell Claude: "Create the project plan"\n`);
+        process.exit(0);
+      }
+    }
+
+    // No plan exists - create new one
+    if (!description) {
+      // No description provided - enter interactive mode
+      console.log('\n📝 Interactive Requirements Mode');
+      console.log('━'.repeat(70));
+      console.log('Enter your project requirements below.');
+      console.log('You can paste multiple lines, URLs, or write detailed specs.');
+      console.log('Press Ctrl+D (Mac/Linux) or Ctrl+Z then Enter (Windows) when done.\n');
+
+      description = await this.promptMultilineInput();
+
+      if (!description || description.trim().length === 0) {
+        console.log('\n❌ No requirements provided\n');
+        process.exit(1);
+      }
+    }
+
+    return this.generatePlan(description);
+  }
+
+  static async promptMultilineInput() {
+    return new Promise((resolve) => {
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+
+      let lines = [];
+
+      rl.on('line', (line) => {
+        lines.push(line);
+      });
+
+      rl.on('close', () => {
+        resolve(lines.join('\n'));
+      });
+    });
+  }
+
+  static generatePlan(description) {
+    console.log('\n📋 Generating new plan...\n');
+
+    try {
+      // Create plan ID
+      const planId = this.getNextPlanId();
+      const planPath = join(process.cwd(), '.claude', 'plans', planId);
+
+      // Create plan directory
+      mkdirSync(planPath, { recursive: true });
+
+      // Create PROJECT-REQUIREMENTS.txt
+      const requirementsPath = join(planPath, 'PROJECT-REQUIREMENTS.txt');
+      const requirementsContent = `PROJECT REQUIREMENTS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+${description}
+
+Generated: ${new Date().toISOString()}
+PLAN ID: ${planId}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+INSTRUCTIONS FOR CLAUDE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Please analyze the requirements above and create a comprehensive project plan.
+
+1. Read the PLAN-SCHEMA.json to understand the plan structure
+2. Read the PROJECT-PLAN-TEMPLATE.json for the format
+3. Create a PROJECT-PLAN.json file in this directory with:
+   - Clear project/subproject/milestone hierarchy
+   - Detailed tasks with IDs (TASK-001, TASK-002, etc.)
+   - Proper dependencies between tasks
+   - Realistic time estimates
+   - Phases: design, implementation, testing, deployment
+   - Completion criteria for each task
+
+4. Structure the plan to follow these phases:
+   - DESIGN: Architecture, UI/UX, database schema
+   - IMPLEMENTATION: Core features, API, frontend
+   - TESTING: Unit tests, integration tests, E2E tests
+   - DEPLOYMENT: Build, CI/CD, documentation
+
+5. Ensure tasks are:
+   - Granular (2-8 hours each)
+   - Clearly defined with specific deliverables
+   - Properly sequenced with dependencies
+   - Grouped logically by feature/component
+
+6. After creating the plan, tell the user to run:
+   npx agentic15 plan
+
+This will lock the plan and generate the task tracker.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+GENERATED: ${new Date().toISOString()}
+`;
+
+      writeFileSync(requirementsPath, requirementsContent);
+
+      // Set as active plan
+      const claudeDir = join(process.cwd(), '.claude');
+      if (!existsSync(claudeDir)) {
+        mkdirSync(claudeDir, { recursive: true });
+      }
+      const activePlanPath = join(claudeDir, 'ACTIVE-PLAN');
+      writeFileSync(activePlanPath, planId);
+
+      console.log(`✅ Plan requirements created: ${planId}`);
+      console.log(`   Location: .claude/plans/${planId}/PROJECT-REQUIREMENTS.txt\n`);
+      console.log('💡 Next steps:');
+      console.log(`   1. Tell Claude: "Create the project plan"`);
+      console.log(`   2. When Claude is done, run: npx agentic15 plan\n`);
+    } catch (error) {
+      console.log(`\n❌ Failed to generate plan: ${error.message}\n`);
+      process.exit(1);
+    }
+  }
+
+  static lockPlan(planId) {
+    console.log(`📋 Locking plan: ${planId}\n`);
+
+    try {
+      const planPath = join(process.cwd(), '.claude', 'plans', planId);
+      const projectPlanPath = join(planPath, 'PROJECT-PLAN.json');
+
+      // Verify PROJECT-PLAN.json exists
+      if (!existsSync(projectPlanPath)) {
+        console.log('\n❌ PROJECT-PLAN.json not found');
+        console.log('   Tell Claude to create the plan first\n');
+        process.exit(1);
+      }
+
+      // Read the plan
+      const plan = JSON.parse(readFileSync(projectPlanPath, 'utf-8'));
+
+      // Extract tasks from plan
+      const tasks = [];
+      this.extractTasks(plan, tasks);
+
+      // Create task files
+      const tasksDir = join(planPath, 'tasks');
+      if (!existsSync(tasksDir)) {
+        mkdirSync(tasksDir, { recursive: true });
+      }
+
+      // Write individual task files
+      tasks.forEach(task => {
+        const taskPath = join(tasksDir, `${task.id}.json`);
+        writeFileSync(taskPath, JSON.stringify(task, null, 2));
+      });
+
+      // Create task tracker
+      const projectName = basename(process.cwd());
+      const tracker = {
+        planId,
+        projectName,
+        activeTask: null,
+        lockedAt: new Date().toISOString(),
+        statistics: {
+          totalTasks: tasks.length,
+          completed: 0,
+          inProgress: 0,
+          pending: tasks.length
+        },
+        taskFiles: tasks.map(task => ({
+          id: task.id,
+          title: task.title,
+          phase: task.phase || 'implementation',
+          status: 'pending',
+          description: task.description
+        }))
+      };
+
+      const trackerPath = join(planPath, 'TASK-TRACKER.json');
+      writeFileSync(trackerPath, JSON.stringify(tracker, null, 2));
+
+      // Mark as locked
+      const lockedPath = join(planPath, '.plan-locked');
+      writeFileSync(lockedPath, new Date().toISOString());
+
+      console.log('✅ Plan locked successfully\n');
+      this.showPlanStatus(planId);
+      console.log('💡 Next step: npx agentic15 task next\n');
+    } catch (error) {
+      console.log(`\n❌ Failed to lock plan: ${error.message}\n`);
+      process.exit(1);
+    }
+  }
+
+  static extractTasks(obj, tasks) {
+    // Recursively extract all tasks from the plan structure
+    if (obj.tasks && Array.isArray(obj.tasks)) {
+      tasks.push(...obj.tasks);
+    }
+
+    // Check nested structures
+    if (obj.milestones && Array.isArray(obj.milestones)) {
+      obj.milestones.forEach(milestone => this.extractTasks(milestone, tasks));
+    }
+
+    if (obj.subprojects && Array.isArray(obj.subprojects)) {
+      obj.subprojects.forEach(subproject => this.extractTasks(subproject, tasks));
+    }
+
+    if (obj.projects && Array.isArray(obj.projects)) {
+      obj.projects.forEach(project => this.extractTasks(project, tasks));
+    }
+
+    // Handle singular 'project' at root level (v2.0 schema)
+    if (obj.project && typeof obj.project === 'object') {
+      this.extractTasks(obj.project, tasks);
+    }
+  }
+
+  static getNextPlanId() {
+    const plansDir = join(process.cwd(), '.claude', 'plans');
+
+    if (!existsSync(plansDir)) {
+      mkdirSync(plansDir, { recursive: true });
+    }
+
+    const existingPlans = readdirSync(plansDir)
+      .filter(name => name.match(/^plan-\d{3}-/i))
+      .map(name => parseInt(name.match(/^plan-(\d{3})-/i)[1]))
+      .filter(num => !isNaN(num));
+
+    const nextNum = existingPlans.length > 0 ? Math.max(...existingPlans) + 1 : 1;
+
+    return `plan-${String(nextNum).padStart(3, '0')}-generated`;
+  }
+
+  static showPlanStatus(planId) {
+    const trackerPath = join(process.cwd(), '.claude', 'plans', planId, 'TASK-TRACKER.json');
+
+    if (!existsSync(trackerPath)) {
+      return;
+    }
+
+    try {
+      const tracker = JSON.parse(readFileSync(trackerPath, 'utf-8'));
+
+      const total = tracker.taskFiles.length;
+      const completed = tracker.taskFiles.filter(t => t.status === 'completed').length;
+      const pending = tracker.taskFiles.filter(t => t.status === 'pending').length;
+
+      console.log('📊 Plan Status:');
+      console.log(`   Total Tasks: ${total}`);
+      console.log(`   Completed:   ${completed}`);
+      console.log(`   Pending:     ${pending}\n`);
+    } catch (e) {
+      // Ignore errors
+    }
+  }
+}

package/src/cli/TaskCommand.js

@@ -1,287 +1,305 @@
-import { execSync } from 'child_process';
-import { readFileSync, writeFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import { GitHubClient } from '../core/GitHubClient.js';
-import { GitHubConfig } from '../core/GitHubConfig.js';
-import { TaskIssueMapper } from '../core/TaskIssueMapper.js';
-
-export class TaskCommand {
-  static async handle(action, taskId) {
-    switch (action) {
-      case 'start':
-        return this.startTask(taskId);
-      case 'next':
-        return this.startNext();
-      case 'status':
-        return this.showStatus();
-      default:
-        console.log(`\n❌ Unknown action: ${action}`);
-        console.log('   Valid actions: start, next, status\n');
-        process.exit(1);
-    }
-  }
-
-  static async startTask(taskId) {
-    if (!taskId) {
-      console.log('\n❌ Task ID required for "start" action');
-      console.log('   Usage: agentic15 task start TASK-001\n');
-      process.exit(1);
-    }
-
-    // Verify git remote is configured
-    this.validateGitRemote();
-
-    // Load task tracker
-    const tracker = this.loadTracker();
-    const task = tracker.taskFiles.find(t => t.id === taskId);
-
-    if (!task) {
-      console.log(`\n❌ Task not found: ${taskId}\n`);
-      process.exit(1);
-    }
-
-    if (task.status === 'completed') {
-      console.log(`\n⚠️  Task ${taskId} is already completed\n`);
-      process.exit(1);
-    }
-
-    // Check if another task is in progress
-    const inProgress = tracker.taskFiles.find(t => t.status === 'in_progress');
-    if (inProgress && inProgress.id !== taskId) {
-      console.log(`\n⚠️  Task ${inProgress.id} is already in progress`);
-      console.log(`   Complete it first with: agentic15 commit\n`);
-      process.exit(1);
-    }
-
-    // Create feature branch
-    const branchName = `feature/${taskId.toLowerCase()}`;
-    try {
-      execSync(`git checkout -b ${branchName}`, { stdio: 'inherit' });
-    } catch (error) {
-      // Branch might already exist
-      try {
-        execSync(`git checkout ${branchName}`, { stdio: 'inherit' });
-      } catch (e) {
-        console.log(`\n❌ Failed to create/checkout branch: ${branchName}\n`);
-        process.exit(1);
-      }
-    }
-
-    // Update task status
-    task.status = 'in_progress';
-    task.startedAt = new Date().toISOString();
-    this.saveTracker(tracker);
-
-    // Create GitHub issue if enabled
-    let githubIssue = null;
-    const config = new GitHubConfig(process.cwd());
-    if (config.isAutoCreateEnabled()) {
-      githubIssue = await this.createGitHubIssue(task, config);
-    }
-
-    // Display task details
-    this.displayTaskDetails(task, githubIssue, tracker);
-  }
-
-  static async startNext() {
-    const tracker = this.loadTracker();
-
-    // Find next pending task
-    const nextTask = tracker.taskFiles.find(t => t.status === 'pending');
-
-    if (!nextTask) {
-      console.log('\n✅ No more pending tasks!\n');
-      const completed = tracker.taskFiles.filter(t => t.status === 'completed').length;
-      const total = tracker.taskFiles.length;
-      console.log(`   Progress: ${completed}/${total} tasks completed\n`);
-      process.exit(0);
-    }
-
-    console.log(`\n▶️  Auto-starting next task: ${nextTask.id}\n`);
-    return this.startTask(nextTask.id);
-  }
-
-  static showStatus() {
-    const tracker = this.loadTracker();
-
-    const inProgress = tracker.taskFiles.find(t => t.status === 'in_progress');
-    const completed = tracker.taskFiles.filter(t => t.status === 'completed').length;
-    const pending = tracker.taskFiles.filter(t => t.status === 'pending').length;
-    const total = tracker.taskFiles.length;
-
-    console.log('\n📊 Task Status\n');
-    console.log(`   Plan: ${tracker.planId}`);
-    console.log(`   Progress: ${completed}/${total} completed (${pending} pending)\n`);
-
-    if (inProgress) {
-      console.log(`   🔄 Currently working on: ${inProgress.id}`);
-      console.log(`   📌 ${inProgress.title}`);
-
-      // Show changed files
-      try {
-        const diff = execSync('git diff --name-only', { encoding: 'utf-8' });
-        if (diff.trim()) {
-          console.log(`\n   📝 Changed files:`);
-          diff.trim().split('\n').forEach(file => {
-            console.log(`      - ${file}`);
-          });
-        }
-      } catch (e) {
-        // Ignore
-      }
-    } else {
-      console.log('   ℹ️  No task currently in progress');
-      console.log(`   Run: agentic15 task next\n`);
-    }
-
-    console.log('');
-  }
-
-  static async createGitHubIssue(task, config) {
-    try {
-      const client = new GitHubClient(
-        config.getToken(),
-        config.getRepoInfo().owner,
-        config.getRepoInfo().repo
-      );
-
-      if (!client.isConfigured()) {
-        console.log('\n⚠️  GitHub not configured. Skipping issue creation.');
-        console.log('   Run: agentic15 auth setup\n');
-        return null;
-      }
-
-      // Load full task details
-      const taskPath = this.getTaskPath(task.id);
-      const taskData = JSON.parse(readFileSync(taskPath, 'utf-8'));
-
-      const title = TaskIssueMapper.taskToIssueTitle(taskData);
-      const body = TaskIssueMapper.taskToIssueBody(taskData);
-      const labels = TaskIssueMapper.taskStatusToLabels(taskData.status || 'pending', taskData.phase);
-      const issueNumber = await client.createIssue(title, body, labels);
-
-      if (issueNumber) {
-        // Save issue number to task
-        taskData.githubIssue = issueNumber;
-        writeFileSync(taskPath, JSON.stringify(taskData, null, 2));
-
-        console.log(`\n✓ Created GitHub issue #${issueNumber}`);
-        const repoInfo = config.getRepoInfo();
-        console.log(`  https://github.com/${repoInfo.owner}/${repoInfo.repo}/issues/${issueNumber}\n`);
-
-        return issueNumber;
-      }
-    } catch (error) {
-      console.log(`\n⚠️  Failed to create GitHub issue: ${error.message}\n`);
-    }
-
-    return null;
-  }
-
-  static displayTaskDetails(task, githubIssue, tracker) {
-    console.log(`\n✅ Started task: ${task.id}`);
-    console.log(`📋 Plan: ${tracker.planId}\n`);
-    console.log(`📌 ${task.title}`);
-
-    if (task.description) {
-      console.log(`📝 ${task.description}\n`);
-    }
-
-    if (task.phase) {
-      console.log(`🔧 Phase: ${task.phase}`);
-    }
-
-    if (githubIssue) {
-      const config = new GitHubConfig(process.cwd());
-      const repoInfo = config.getRepoInfo();
-      console.log(`🔗 GitHub Issue: https://github.com/${repoInfo.owner}/${repoInfo.repo}/issues/${githubIssue}`);
-    }
-
-    // Load full task for completion criteria
-    try {
-      const taskPath = this.getTaskPath(task.id);
-      const taskData = JSON.parse(readFileSync(taskPath, 'utf-8'));
-
-      if (taskData.completionCriteria && taskData.completionCriteria.length > 0) {
-        console.log(`\n✓ Completion criteria:`);
-        taskData.completionCriteria.forEach((criteria, idx) => {
-          console.log(`  ${idx + 1}. ${criteria}`);
-        });
-      }
-    } catch (e) {
-      // Ignore
-    }
-
-    console.log(`\n💡 Next steps:`);
-    console.log(`   1. Tell Claude: "Write code for ${task.id}"`);
-    console.log(`   2. When done: agentic15 commit\n`);
-  }
-
-  static loadTracker() {
-    const activePlanPath = join(process.cwd(), '.claude', 'ACTIVE-PLAN');
-
-    if (!existsSync(activePlanPath)) {
-      console.log('\n❌ No active plan found');
-      console.log('   Run: agentic15 plan "project description"\n');
-      process.exit(1);
-    }
-
-    const planId = readFileSync(activePlanPath, 'utf-8').trim();
-    const trackerPath = join(process.cwd(), '.claude', 'plans', planId, 'TASK-TRACKER.json');
-
-    if (!existsSync(trackerPath)) {
-      console.log('\n❌ Task tracker not found');
-      console.log('   Run: agentic15 plan\n');
-      process.exit(1);
-    }
-
-    return JSON.parse(readFileSync(trackerPath, 'utf-8'));
-  }
-
-  static saveTracker(tracker) {
-    const activePlanPath = join(process.cwd(), '.claude', 'ACTIVE-PLAN');
-    const planId = readFileSync(activePlanPath, 'utf-8').trim();
-    const trackerPath = join(process.cwd(), '.claude', 'plans', planId, 'TASK-TRACKER.json');
-
-    writeFileSync(trackerPath, JSON.stringify(tracker, null, 2));
-  }
-
-  static getTaskPath(taskId) {
-    const activePlanPath = join(process.cwd(), '.claude', 'ACTIVE-PLAN');
-    const planId = readFileSync(activePlanPath, 'utf-8').trim();
-    return join(process.cwd(), '.claude', 'plans', planId, 'tasks', `${taskId}.json`);
-  }
-
-  static validateGitRemote() {
-    try {
-      // Check if git remote origin exists
-      const remote = execSync('git remote get-url origin', { encoding: 'utf-8', stdio: 'pipe' }).trim();
-
-      if (!remote || remote.length === 0) {
-        throw new Error('No remote URL');
-      }
-
-      // Validate it's a GitHub URL
-      if (!remote.includes('github.com')) {
-        console.log('\n⚠️  Warning: Remote is not a GitHub repository');
-        console.log(`   Remote URL: ${remote}`);
-        console.log('   GitHub integration features may not work.\n');
-      }
-    } catch (error) {
-      console.log('\n❌ Git remote "origin" is not configured');
-      console.log('\n   Before starting tasks, you must link your project to a GitHub repository:');
-      console.log('\n   1. Create a GitHub repository:');
-      console.log('      gh repo create OWNER/REPO --public (or --private)');
-      console.log('\n   2. Link it to your local project:');
-      console.log('      git remote add origin https://github.com/OWNER/REPO.git');
-      console.log('\n   3. Push your initial code:');
-      console.log('      git branch -M main');
-      console.log('      git add .');
-      console.log('      git commit -m "Initial commit"');
-      console.log('      git push -u origin main');
-      console.log('\n   4. Then start your task:');
-      console.log('      npx agentic15 task next\n');
-      process.exit(1);
-    }
-  }
-}
+import { execSync } from 'child_process';
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { GitHubClient } from '../core/GitHubClient.js';
+import { GitHubConfig } from '../core/GitHubConfig.js';
+import { TaskIssueMapper } from '../core/TaskIssueMapper.js';
+
+export class TaskCommand {
+  static async handle(action, taskId) {
+    switch (action) {
+      case 'start':
+        return this.startTask(taskId);
+      case 'next':
+        return this.startNext();
+      case 'status':
+        return this.showStatus();
+      default:
+        console.log(`\n❌ Unknown action: ${action}`);
+        console.log('   Valid actions: start, next, status\n');
+        process.exit(1);
+    }
+  }
+
+  static async startTask(taskId) {
+    if (!taskId) {
+      console.log('\n❌ Task ID required for "start" action');
+      console.log('   Usage: agentic15 task start TASK-001\n');
+      process.exit(1);
+    }
+
+    // Verify git remote is configured
+    this.validateGitRemote();
+
+    // Load task tracker
+    const tracker = this.loadTracker();
+    const task = tracker.taskFiles.find(t => t.id === taskId);
+
+    if (!task) {
+      console.log(`\n❌ Task not found: ${taskId}\n`);
+      process.exit(1);
+    }
+
+    if (task.status === 'completed') {
+      console.log(`\n⚠️  Task ${taskId} is already completed\n`);
+      process.exit(1);
+    }
+
+    // Check if another task is in progress
+    const inProgress = tracker.taskFiles.find(t => t.status === 'in_progress');
+    if (inProgress && inProgress.id !== taskId) {
+      console.log(`\n⚠️  Task ${inProgress.id} is already in progress`);
+      console.log(`   Complete it first with: agentic15 commit\n`);
+      process.exit(1);
+    }
+
+    // Create feature branch
+    const branchName = `feature/${taskId.toLowerCase()}`;
+    try {
+      execSync(`git checkout -b ${branchName}`, { stdio: 'inherit' });
+    } catch (error) {
+      // Branch might already exist
+      try {
+        execSync(`git checkout ${branchName}`, { stdio: 'inherit' });
+      } catch (e) {
+        console.log(`\n❌ Failed to create/checkout branch: ${branchName}\n`);
+        process.exit(1);
+      }
+    }
+
+    // Update task status
+    task.status = 'in_progress';
+    task.startedAt = new Date().toISOString();
+
+    // Update tracker metadata
+    tracker.activeTask = task.id;
+    this.updateStatistics(tracker);
+    this.saveTracker(tracker);
+
+    // Create GitHub issue if enabled
+    let githubIssue = null;
+    const config = new GitHubConfig(process.cwd());
+    if (config.isAutoCreateEnabled()) {
+      githubIssue = await this.createGitHubIssue(task, config);
+    }
+
+    // Display task details
+    this.displayTaskDetails(task, githubIssue, tracker);
+  }
+
+  static async startNext() {
+    const tracker = this.loadTracker();
+
+    // Find next pending task
+    const nextTask = tracker.taskFiles.find(t => t.status === 'pending');
+
+    if (!nextTask) {
+      console.log('\n✅ No more pending tasks!\n');
+      const completed = tracker.taskFiles.filter(t => t.status === 'completed').length;
+      const total = tracker.taskFiles.length;
+      console.log(`   Progress: ${completed}/${total} tasks completed\n`);
+      process.exit(0);
+    }
+
+    console.log(`\n▶️  Auto-starting next task: ${nextTask.id}\n`);
+    return this.startTask(nextTask.id);
+  }
+
+  static showStatus() {
+    const tracker = this.loadTracker();
+
+    const inProgress = tracker.taskFiles.find(t => t.status === 'in_progress');
+    const completed = tracker.taskFiles.filter(t => t.status === 'completed').length;
+    const pending = tracker.taskFiles.filter(t => t.status === 'pending').length;
+    const total = tracker.taskFiles.length;
+
+    console.log('\n📊 Task Status\n');
+    console.log(`   Plan: ${tracker.planId}`);
+    console.log(`   Progress: ${completed}/${total} completed (${pending} pending)\n`);
+
+    if (inProgress) {
+      console.log(`   🔄 Currently working on: ${inProgress.id}`);
+      console.log(`   📌 ${inProgress.title}`);
+
+      // Show changed files
+      try {
+        const diff = execSync('git diff --name-only', { encoding: 'utf-8' });
+        if (diff.trim()) {
+          console.log(`\n   📝 Changed files:`);
+          diff.trim().split('\n').forEach(file => {
+            console.log(`      - ${file}`);
+          });
+        }
+      } catch (e) {
+        // Ignore
+      }
+    } else {
+      console.log('   ℹ️  No task currently in progress');
+      console.log(`   Run: agentic15 task next\n`);
+    }
+
+    console.log('');
+  }
+
+  static async createGitHubIssue(task, config) {
+    try {
+      const client = new GitHubClient(
+        config.getToken(),
+        config.getRepoInfo().owner,
+        config.getRepoInfo().repo
+      );
+
+      if (!client.isConfigured()) {
+        console.log('\n⚠️  GitHub not configured. Skipping issue creation.');
+        console.log('   Run: agentic15 auth setup\n');
+        return null;
+      }
+
+      // Load full task details
+      const taskPath = this.getTaskPath(task.id);
+      const taskData = JSON.parse(readFileSync(taskPath, 'utf-8'));
+
+      const title = TaskIssueMapper.taskToIssueTitle(taskData);
+      const body = TaskIssueMapper.taskToIssueBody(taskData);
+      const labels = TaskIssueMapper.taskStatusToLabels(taskData.status || 'pending', taskData.phase);
+      const issueNumber = await client.createIssue(title, body, labels);
+
+      if (issueNumber) {
+        // Save issue number to task
+        taskData.githubIssue = issueNumber;
+        writeFileSync(taskPath, JSON.stringify(taskData, null, 2));
+
+        console.log(`\n✓ Created GitHub issue #${issueNumber}`);
+        const repoInfo = config.getRepoInfo();
+        console.log(`  https://github.com/${repoInfo.owner}/${repoInfo.repo}/issues/${issueNumber}\n`);
+
+        return issueNumber;
+      }
+    } catch (error) {
+      console.log(`\n⚠️  Failed to create GitHub issue: ${error.message}\n`);
+    }
+
+    return null;
+  }
+
+  static displayTaskDetails(task, githubIssue, tracker) {
+    console.log(`\n✅ Started task: ${task.id}`);
+    console.log(`📋 Plan: ${tracker.planId}\n`);
+    console.log(`📌 ${task.title}`);
+
+    if (task.description) {
+      console.log(`📝 ${task.description}\n`);
+    }
+
+    if (task.phase) {
+      console.log(`🔧 Phase: ${task.phase}`);
+    }
+
+    if (githubIssue) {
+      const config = new GitHubConfig(process.cwd());
+      const repoInfo = config.getRepoInfo();
+      console.log(`🔗 GitHub Issue: https://github.com/${repoInfo.owner}/${repoInfo.repo}/issues/${githubIssue}`);
+    }
+
+    // Load full task for completion criteria
+    try {
+      const taskPath = this.getTaskPath(task.id);
+      const taskData = JSON.parse(readFileSync(taskPath, 'utf-8'));
+
+      if (taskData.completionCriteria && taskData.completionCriteria.length > 0) {
+        console.log(`\n✓ Completion criteria:`);
+        taskData.completionCriteria.forEach((criteria, idx) => {
+          console.log(`  ${idx + 1}. ${criteria}`);
+        });
+      }
+    } catch (e) {
+      // Ignore
+    }
+
+    console.log(`\n💡 Next steps:`);
+    console.log(`   1. Tell Claude: "Write code for ${task.id}"`);
+    console.log(`   2. When done: agentic15 commit\n`);
+  }
+
+  static loadTracker() {
+    const activePlanPath = join(process.cwd(), '.claude', 'ACTIVE-PLAN');
+
+    if (!existsSync(activePlanPath)) {
+      console.log('\n❌ No active plan found');
+      console.log('   Run: agentic15 plan "project description"\n');
+      process.exit(1);
+    }
+
+    const planId = readFileSync(activePlanPath, 'utf-8').trim();
+    const trackerPath = join(process.cwd(), '.claude', 'plans', planId, 'TASK-TRACKER.json');
+
+    if (!existsSync(trackerPath)) {
+      console.log('\n❌ Task tracker not found');
+      console.log('   Run: agentic15 plan\n');
+      process.exit(1);
+    }
+
+    return JSON.parse(readFileSync(trackerPath, 'utf-8'));
+  }
+
+  static saveTracker(tracker) {
+    const activePlanPath = join(process.cwd(), '.claude', 'ACTIVE-PLAN');
+    const planId = readFileSync(activePlanPath, 'utf-8').trim();
+    const trackerPath = join(process.cwd(), '.claude', 'plans', planId, 'TASK-TRACKER.json');
+
+    writeFileSync(trackerPath, JSON.stringify(tracker, null, 2));
+  }
+
+  static updateStatistics(tracker) {
+    const completed = tracker.taskFiles.filter(t => t.status === 'completed').length;
+    const inProgress = tracker.taskFiles.filter(t => t.status === 'in_progress').length;
+    const pending = tracker.taskFiles.filter(t => t.status === 'pending').length;
+    const totalTasks = tracker.taskFiles.length;
+
+    tracker.statistics = {
+      totalTasks,
+      completed,
+      inProgress,
+      pending
+    };
+  }
+
+  static getTaskPath(taskId) {
+    const activePlanPath = join(process.cwd(), '.claude', 'ACTIVE-PLAN');
+    const planId = readFileSync(activePlanPath, 'utf-8').trim();
+    return join(process.cwd(), '.claude', 'plans', planId, 'tasks', `${taskId}.json`);
+  }
+
+  static validateGitRemote() {
+    try {
+      // Check if git remote origin exists
+      const remote = execSync('git remote get-url origin', { encoding: 'utf-8', stdio: 'pipe' }).trim();
+
+      if (!remote || remote.length === 0) {
+        throw new Error('No remote URL');
+      }
+
+      // Validate it's a GitHub URL
+      if (!remote.includes('github.com')) {
+        console.log('\n⚠️  Warning: Remote is not a GitHub repository');
+        console.log(`   Remote URL: ${remote}`);
+        console.log('   GitHub integration features may not work.\n');
+      }
+    } catch (error) {
+      console.log('\n❌ Git remote "origin" is not configured');
+      console.log('\n   Before starting tasks, you must link your project to a GitHub repository:');
+      console.log('\n   1. Create a GitHub repository:');
+      console.log('      gh repo create OWNER/REPO --public (or --private)');
+      console.log('\n   2. Link it to your local project:');
+      console.log('      git remote add origin https://github.com/OWNER/REPO.git');
+      console.log('\n   3. Push your initial code:');
+      console.log('      git branch -M main');
+      console.log('      git add .');
+      console.log('      git commit -m "Initial commit"');
+      console.log('      git push -u origin main');
+      console.log('\n   4. Then start your task:');
+      console.log('      npx agentic15 task next\n');
+      process.exit(1);
+    }
+  }
+}

package/templates/.claude/settings.json

@@ -34,16 +34,12 @@
       "Edit(./.claude/hooks/**)",
       "Write(./.claude/hooks/**)",
       "Edit(./.claude/TASK-TRACKER.json)",
-      "Read(./.claude/POST-INSTALL.md)",
-      "Read(./docs/**)",
       "Bash(agentic15:*)",
       "Bash(npx agentic15:*)",
       "Bash(git:*)",
       "Bash(gh:*)",
       "Bash(npm run task:*)",
       "Bash(npm run plan:*)",
-      "Bash(curl:*)",
-      "Bash(wget:*)",
       "Bash(rm -rf:*)",
       "Bash(sudo:*)",
       "Bash(npm install:*)",
@@ -58,9 +54,7 @@
       "Bash(node ./scripts/**)",
       "Bash(node ./Agent/db/**)",
       "Bash(bash ./scripts/**)",
-      "Bash(sh ./scripts/**)",
-      "WebFetch",
-      "WebSearch"
+      "Bash(sh ./scripts/**)"
     ]
   },
   "sandbox": {