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

package/CHANGELOG.md

@@ -1,11 +1,189 @@
-# 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
+# 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
+
+### 🎉 MAJOR RELEASE - Complete CLI Architecture Transformation
+
+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.
+
+### 🆕 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
 

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/package.json

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

package/src/cli/PlanCommand.js

@@ -1,5 +1,6 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'fs';
 import { join } from 'path';
+import readline from 'readline';
 
 export class PlanCommand {
   static async handle(description) {
@@ -36,14 +37,44 @@ 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');
 

package/src/core/ProjectInitializer.js

@@ -83,7 +83,7 @@ export class ProjectInitializer {
     console.log('\n   Complete workflow documentation with examples.\n');
     console.log('🚀 QUICK START:');
     console.log('  1. npx agentic15 auth');
-    console.log('  2. npx agentic15 plan "Your project description"');
+    console.log('  2. npx agentic15 plan (interactive - paste requirements, Ctrl+D)');
     console.log('  3. Tell Claude: "Create the project plan"');
     console.log('  4. npx agentic15 plan (locks the plan)');
     console.log('  5. npx agentic15 task next');