@agentic15.com/agentic15-claude-zen 2.0.6 → 3.0.2

package/CHANGELOG.md

@@ -1,11 +1,304 @@
-# Changelog
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Copyright 2024-2025 agentic15.com
+
+## [3.0.2] - 2025-12-25
+
+### Summary
+Publishing update - no code changes from v3.0.1.
+
+This release publishes the interactive requirements mode to npm registry.
+
+## [3.0.1] - 2025-12-25
+
+### Summary
+Patch release to publish the interactive requirements mode feature to npm.
+
+This release makes v3.0.0 officially available on npm with the interactive mode feature fully documented and tested.
+
+## [3.0.0] - 2025-12-25
 
-All notable changes to this project will be documented in this file.
+### 🎉 MAJOR RELEASE - Complete CLI Architecture Transformation
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+This is a **major breaking release** that fundamentally transforms the framework from npm script-based workflows to a pure CLI-driven architecture. The package has been completely rewritten, tested, and optimized for production use.
 
-Copyright 2024-2025 agentic15.com
+### 🆕 Interactive Requirements Mode
+
+Running `npx agentic15 plan` without arguments now enters **interactive mode**:
+- Type or paste requirements of any length
+- Include URLs, detailed specs, multiple paragraphs
+- Press Ctrl+D (Mac/Linux) or Ctrl+Z+Enter (Windows) to save
+- No shell escaping or quote issues
+- Perfect for complex corporate websites, detailed project specs
+
+**Example**:
+```bash
+npx agentic15 plan
+# Paste your requirements...
+# Press Ctrl+D when done
+```
+
+### 💥 Breaking Changes
+
+**CRITICAL**: This release is **NOT backward compatible** with v1.x or v2.x workflows.
+
+1. **All npm scripts removed** - Use `npx agentic15 <command>` instead
+   - ❌ `npm run plan:generate` → ✅ `npx agentic15 plan "description"`
+   - ❌ `npm run plan:init` → ✅ `npx agentic15 plan` (auto-locks)
+   - ❌ `npm run task:start` → ✅ `npx agentic15 task next`
+   - ❌ No task:done - Status auto-detected by CLI
+
+2. **No obfuscated/minified code** - Ships pure ESM source code
+   - Removed 248KB of minified v1.x code
+   - Transparent, auditable codebase
+   - Easier debugging and contributions
+
+3. **Built-in plan logic** - No external script dependencies
+   - Plan generation/locking logic moved into PlanCommand class
+   - No npm script wrapper required
+   - Single command for entire workflow
+
+4. **v2.0 schema support** - Updated PROJECT-PLAN.json structure
+   - Root level uses `project` (singular) instead of `projects` (plural)
+   - Compatible with PROJECT-PLAN-TEMPLATE.json format
+   - Recursive task extraction from nested structures
+
+### ✨ What's New
+
+#### CLI Commands (All New)
+```bash
+npx agentic15 auth              # One-time GitHub setup
+npx agentic15 plan "desc"       # Generate plan requirements
+npx agentic15 plan              # Lock plan (if PROJECT-PLAN.json exists)
+npx agentic15 task next         # Auto-start next pending task
+npx agentic15 task start ID     # Start specific task
+npx agentic15 commit            # Test, commit, push, create PR
+npx agentic15 status            # Show current progress
+```
+
+#### GitHub Integration
+- ✅ Issue templates (.github/ISSUE_TEMPLATE/task.md)
+- ✅ PR templates (.github/PULL_REQUEST_TEMPLATE.md)
+- ✅ CLI uses templates for consistent formatting
+- ✅ Auto-generated issues follow standard structure
+- ✅ Auto-generated PRs follow standard structure
+
+#### Quality Improvements
+- 📦 Package size: 46.0 kB compressed (down from 294KB)
+- 📁 Total files: 52 (down from 67)
+- 🧪 Black box tested - 5 critical bugs found and fixed
+- ✅ All core workflows verified end-to-end
+- 📚 Complete documentation with workflow diagrams
+
+### 🐛 Critical Bug Fixes (Found During Testing)
+
+All bugs discovered and fixed during comprehensive black box testing:
+
+1. **Import Path Error** (bin/create-agentic15-claude-zen.js:179)
+   - Fixed: dist/index.js → src/index.js
+
+2. **Template Path Error** (src/core/TemplateManager.js:32)
+   - Fixed: Added '../..' to reach package root from src/core/
+
+3. **Obsolete Method Call** (src/core/ProjectInitializer.js)
+   - Removed: extractBundledFiles() call (tried to copy non-existent scripts)
+
+4. **Schema Compatibility** (src/cli/PlanCommand.js:207-210)
+   - Added: Support for v2.0 schema with singular 'project' at root
+
+5. **Wrong Method Reference** (src/cli/TaskCommand.js:155-158)
+   - Fixed: Now calls correct TaskIssueMapper.taskToIssueTitle/Body/Labels methods
+
+### 📊 Testing & Verification
+
+- ✅ **Test Repository**: https://github.com/agentic15/agentic15-test-v2
+- ✅ **Project Creation**: Templates, dependencies, git, hooks
+- ✅ **Plan Generation**: Requirements file, plan ID, ACTIVE-PLAN
+- ✅ **Plan Locking**: Task extraction (3/3 tasks verified)
+- ✅ **Task Management**: Auto-start next task, feature branch creation
+- ✅ **Git Workflow**: Feature branches, status tracking
+
+### 🎯 Migration Guide (v1.x/v2.x → v3.0.0)
+
+**Before (v1.x/v2.x)**:
+```bash
+npm run plan:generate "Build calculator"
+# Claude creates plan
+echo "plan-001-generated" > .claude/ACTIVE-PLAN
+npm run plan:init
+npm run task:start TASK-001
+# Write code
+npm run task:done
+```
+
+**After (v3.0.0)**:
+```bash
+npx agentic15 plan "Build calculator"
+# Claude creates plan
+npx agentic15 plan
+npx agentic15 task next
+# Write code
+npx agentic15 commit
+```
+
+### 📦 Package Details
+
+- **Size**: 46.0 kB compressed, 177.7 kB unpacked
+- **Files**: 52
+- **Architecture**: Pure ESM modules
+- **Node**: >=18.0.0
+- **Dependencies**: @octokit/rest@20.0.2, commander@12.1.0
+
+### 🚀 Upgrade Instructions
+
+**New Projects** (Recommended):
+```bash
+npx @agentic15.com/agentic15-claude-zen@3.0.0 my-project
+cd my-project
+npx agentic15 auth
+npx agentic15 plan "Your project description"
+```
+
+**Existing Projects** (Requires Manual Migration):
+1. Update package: `npm install @agentic15.com/agentic15-claude-zen@3.0.0`
+2. Run auth setup: `npx agentic15 auth`
+3. Replace all npm run task:* with npx agentic15 commands
+4. Update any automation scripts
+
+### 🎓 Documentation
+
+- README.md: Quick start guide
+- WORKFLOWS.md: Complete workflow documentation with mermaid diagrams
+- CHANGELOG.md: Detailed version history (this file)
+- .claude/POST-INSTALL.md: Instructions for Claude
+
+### ⚠️ Known Limitations
+
+- GitHub integration requires valid Personal Access Token
+- PR creation requires GitHub CLI (gh) installed
+- Windows users: Use quotes around package name in PowerShell
+
+---
+
+## [2.0.9] - 2025-12-25
+
+### Changed
+- **BREAKING**: Removed obfuscated scripts directory (contained old v1.x minified code)
+- **BREAKING**: Removed npm scripts (plan:generate, plan:init) - no longer needed
+- Refactored PlanCommand.js to have plan generation/locking logic built-in (no external scripts)
+- Package now uses ONLY CLI commands as documented in WORKFLOWS.md
+- Package size: 45.7 kB compressed, 176.5 kB unpacked (52 files)
+- TaskIssueMapper now follows .github/ISSUE_TEMPLATE/task.md structure for consistency
+- CommitCommand now follows .github/PULL_REQUEST_TEMPLATE.md structure for PRs
+- Updated onboarding instructions to show v2.0 CLI commands (removed outdated npm scripts)
+
+### Added
+- GitHub issue and PR templates (.github/ISSUE_TEMPLATE/task.md, PULL_REQUEST_TEMPLATE.md)
+- CLI now uses templates for consistent issue/PR formatting
+- Built-in plan generation logic in PlanCommand class
+- Built-in plan locking logic with task extraction
+- Support for v2.0 schema (singular 'project' at root) in extractTasks()
+- Standardized issue body format with sections: Task Description, Completion Criteria, Dependencies, Phase
+- Standardized PR body format with sections: Task, Description, Changes, Testing, Notes
+
+### Fixed
+- **BUG #1**: Incorrect import path in bin/create-agentic15-claude-zen.js (dist/index.js → src/index.js)
+- **BUG #2**: Wrong template path in TemplateManager.js (needed to go up 2 levels from src/core/)
+- **BUG #3**: Removed obsolete extractBundledFiles() call (tried to copy non-existent scripts)
+- **BUG #4**: extractTasks() now handles v2.0 schema with singular 'project' key
+- **BUG #5**: TaskCommand.js calls correct TaskIssueMapper methods (not non-existent mapTaskToIssue)
+
+### Removed
+- All obfuscated v1.x scripts (19 files, ~248KB of minified code)
+- npm run plan:* commands from templates
+- extractBundledFiles() method call from ProjectInitializer
+
+### Testing
+- Black box testing completed with 5 bugs found and fixed
+- Successfully tested: project creation, auth setup, plan generation, plan locking, task extraction, feature branch creation
+- Test repository: https://github.com/agentic15/agentic15-test-v2
+
+## [2.0.8] - 2025-12-25
+
+### Changed
+- Removed entire dist/ folder (48 minified files)
+- Changed to ship source code only (no minification)
+- Updated package.json main entry from dist/index.js to src/index.js
+- Removed all build/minification scripts
+
+### Fixed
+- Fixed obfuscated/minified code showing wrong v1.x commands
+
+## [2.0.7] - 2025-12-25
+
+### Removed
+- Deleted CLAUDE.md (1,100+ lines of obsolete v1.x documentation)
+- Deleted ONBOARDING.md (86 lines of obsolete v1.x onboarding)
+
+### Changed
+- Updated templates/README.md with v2.0 commands
+
+## [2.0.6] - 2025-12-25
+
+### Changed
+- Added PowerShell syntax to README.md and WORKFLOWS.md
+- PowerShell requires quotes: `npx "@agentic15.com/agentic15-claude-zen" my-project`
+
+## [2.0.5] - 2025-12-25
+
+### Changed
+- Simplified README.md from 307 lines to 68 lines
+- README now just points to WORKFLOWS.md for detailed workflows
+
+## [2.0.4] - 2025-12-25
+
+### Fixed
+- Fixed package README.md with broken documentation links
+- Removed references to deleted docs/ folder
+
+## [2.0.3] - 2025-12-25
+
+### Changed
+- Further simplified README.md to match WORKFLOWS.md style
+- Consolidated all workflow documentation
+
+## [2.0.2] - 2025-12-25
+
+### Changed
+- Simplified README.md to focus on quick start and command reference
+- All detailed workflows now in WORKFLOWS.md
+
+## [2.0.1] - 2025-12-25
+
+### Changed
+- Updated package README with correct v2.0 commands
+- Fixed mermaid diagram syntax errors in WORKFLOWS.md
+
+## [2.0.0] - 2025-12-25
+
+### Added
+- CLI-based architecture (`npx agentic15` commands)
+- Dedicated agentic15 CLI binary for all automation
+- Single WORKFLOWS.md with mermaid diagrams
+- Visual testing feedback loop
+- Auto-generated commit messages
+- Feature branch workflow with PRs
+- GitHub issue/PR integration
+
+### Removed
+- All npm run task:* commands (replaced by CLI)
+- 9 workflow documentation files (3,526 lines)
+- docs/ folder
+
+### Changed
+- Workflow now requires feature branches + PRs (no direct main commits)
+- Simplified documentation to <20 line POST-INSTALL.md + WORKFLOWS.md
+- Commit messages auto-generated as [TASK-XXX] title
 
 ## [1.0.1] - 2025-12-24
 

package/README.md

@@ -9,19 +9,32 @@ AI-Assisted Development Framework with Automated Workflows
 
 ## Quick Start
 
+**Step 1: Create Project**
 ```bash
 # Bash/Mac/Linux
 npx @agentic15.com/agentic15-claude-zen my-project
 
 # PowerShell (Windows)
 npx "@agentic15.com/agentic15-claude-zen" my-project
+```
 
-# Then
+**Step 2: Use CLI Inside Project**
+```bash
 cd my-project
-npx agentic15 auth
-npx agentic15 plan "Build a todo app"
+npx agentic15 auth                    # One-time GitHub setup
+npx agentic15 plan                    # Enter interactive mode
+# Type/paste your requirements, press Ctrl+D when done
+npx agentic15 task next               # Start first task
+npx agentic15 commit                  # Test, commit, push, PR
 ```
 
+> **Note**: Project creation uses the full package name `@agentic15.com/agentic15-claude-zen`.
+> Once inside your project, use the short command `agentic15` for all workflows.
+>
+> **Tip**: `npx agentic15 plan` without arguments enters interactive mode where you can
+> paste long requirements, URLs, and detailed specs. Press Ctrl+D (Mac/Linux) or
+> Ctrl+Z+Enter (Windows) to save.
+
 **See [WORKFLOWS.md](WORKFLOWS.md) for complete workflows.**
 
 ---

package/bin/create-agentic15-claude-zen.js

@@ -176,7 +176,7 @@ async function main() {
 
   // Import and run initialization
   try {
-    const { initializeProject } = await import('../dist/index.js');
+    const { initializeProject } = await import('../src/index.js');
     await initializeProject(projectName, targetDir, { initGit, installDeps });
 
     console.log('\n✅ Project created successfully!\n');

package/package.json

@@ -1,19 +1,17 @@
 {
   "name": "@agentic15.com/agentic15-claude-zen",
-  "version": "2.0.6",
+  "version": "3.0.2",
   "description": "Structured AI-assisted development framework for Claude Code with enforced quality standards",
-  "main": "dist/index.js",
+  "main": "src/index.js",
   "bin": {
     "agentic15-claude-zen": "./bin/create-agentic15-claude-zen.js",
     "agentic15": "./bin/agentic15.js"
   },
   "type": "module",
   "scripts": {
-    "build": "node esbuild.config.js",
     "test": "node test/integration.test.js",
     "test:e2e": "node test/e2e-verification.test.js",
-    "test:site": "node test/verify-test-site.js",
-    "prepublishOnly": "npm run build"
+    "test:site": "node test/verify-test-site.js"
   },
   "keywords": [
     "agentic15",
@@ -44,7 +42,6 @@
   "files": [
     "bin/",
     "src/",
-    "dist/",
     "templates/",
     "templates/.gitignore",
     "README.md",

package/src/cli/CommitCommand.js

@@ -178,13 +178,29 @@ export class CommitCommand {
         taskData = task;
       }
 
-      // Build PR body
-      let prBody = taskData.description || '';
+      // Build PR body following .github/PULL_REQUEST_TEMPLATE.md structure
+      let prBody = `## Task\n\n`;
 
       if (taskData.githubIssue) {
-        prBody += `\n\nCloses #${taskData.githubIssue}`;
+        prBody += `Closes #${taskData.githubIssue}\n\n`;
+      } else {
+        prBody += `${task.id}\n\n`;
       }
 
+      prBody += `## Description\n\n`;
+      prBody += `${taskData.description || task.description || commitMessage}\n\n`;
+
+      prBody += `## Changes\n\n`;
+      prBody += `- Implemented ${task.title}\n\n`;
+
+      prBody += `## Testing\n\n`;
+      prBody += `- [x] Unit tests pass (\`npm test\`)\n`;
+      prBody += `- [ ] Visual tests pass (if applicable) (\`npx playwright test\`)\n`;
+      prBody += `- [ ] Code follows project conventions\n\n`;
+
+      prBody += `## Notes\n\n`;
+      prBody += `Auto-generated by Agentic15 Claude Zen`;
+
       // Create PR using gh CLI
       const prCommand = `gh pr create --title "${commitMessage}" --body "${prBody}" --base ${mainBranch}`;
       const prOutput = execSync(prCommand, { encoding: 'utf-8' });

package/src/cli/PlanCommand.js

@@ -1,6 +1,6 @@
-import { execSync } from 'child_process';
 import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'fs';
 import { join } from 'path';
+import readline from 'readline';
 
 export class PlanCommand {
   static async handle(description) {
@@ -37,43 +37,117 @@ export class PlanCommand {
 
     // No plan exists - create new one
     if (!description) {
-      console.log('\n❌ Project description required');
-      console.log('   Usage: agentic15 plan "Build a calculator app"\n');
-      process.exit(1);
+      // 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,
+        terminal: false
+      });
+
+      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 {
-      // Run plan:generate script
-      execSync(`npm run plan:generate "${description}"`, { stdio: 'inherit' });
+      // Create plan ID
+      const planId = this.getNextPlanId();
+      const planPath = join(process.cwd(), '.claude', 'plans', planId);
 
-      // Find the generated plan
-      const plansDir = join(process.cwd(), '.claude', 'plans');
-      const plans = readdirSync(plansDir)
-        .filter(name => name.startsWith('plan-') && name.includes('-generated'));
+      // Create plan directory
+      mkdirSync(planPath, { recursive: true });
 
-      if (plans.length === 0) {
-        console.log('\n❌ Failed to generate plan\n');
-        process.exit(1);
-      }
+      // Create PROJECT-REQUIREMENTS.txt
+      const requirementsPath = join(planPath, 'PROJECT-REQUIREMENTS.txt');
+      const requirementsContent = `PROJECT REQUIREMENTS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+${description}
 
-      // Use the most recent generated plan
-      const planId = plans[plans.length - 1];
+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 activePlanPath = join(process.cwd(), '.claude', '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(`\n✅ Plan requirements created: ${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: agentic15 plan\n`);
+      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);
@@ -84,20 +158,106 @@ export class PlanCommand {
     console.log(`📋 Locking plan: ${planId}\n`);
 
     try {
-      // Run plan:init script
-      execSync('npm run plan:init', { stdio: 'inherit' });
+      const planPath = join(process.cwd(), '.claude', 'plans', planId);
+      const projectPlanPath = join(planPath, 'PROJECT-PLAN.json');
 
-      console.log('\n✅ Plan locked successfully\n');
+      // 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);
+      }
 
-      this.showPlanStatus(planId);
+      // 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));
 
-      console.log('💡 Next step: agentic15 task next\n');
+      // 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');
 

package/src/cli/TaskCommand.js

@@ -152,7 +152,9 @@ export class TaskCommand {
       const taskPath = this.getTaskPath(task.id);
       const taskData = JSON.parse(readFileSync(taskPath, 'utf-8'));
 
-      const { title, body, labels } = TaskIssueMapper.mapTaskToIssue(taskData);
+      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) {