prjct-cli 0.8.8 → 0.9.2

package/core/command-registry.js

@@ -8,7 +8,7 @@
  * - CLAUDE.md (AI assistant instructions)
  * - scripts/validate-commands.js (validation)
  *
- * @version 0.8.0 - Conversational interface with zero memorization
+ * @version 0.9.0 - Simplified commands with pause/resume and intelligent idea development
  */
 
 const COMMANDS = [
@@ -38,137 +38,129 @@ const COMMANDS = [
     ],
   },
 
-  // 2. Feature with Roadmap (NEW - replaces idea)
+  // 2. Idea Development - Transform ideas into complete architectures
   {
-    name: 'feature',
+    name: 'idea',
     category: 'core',
-    description: 'Add feature with value analysis, roadmap, and task breakdown',
+    description: 'Transform ideas into complete technical architectures',
     usage: {
-      claude: '/p:feature "add unit testing"',
-      terminal: 'prjct feature "add unit testing"',
+      claude: '/p:idea "build a CRM with AI"',
+      terminal: 'prjct idea "build a CRM with AI"',
     },
     params: '<description>',
     implemented: true,
     hasTemplate: true,
-    icon: 'Package',
+    icon: 'Lightbulb',
     requiresInit: true,
     blockingRules: null,
     features: [
-      'Value analysis (impact/effort/timing)',
-      'Auto roadmap generation',
-      'Task breakdown',
-      'Auto-start first task',
-      'Timing recommendations',
+      'Simple ideas → Quick capture',
+      'Complex ideas → Full architecture',
+      'Interactive discovery process',
+      'Tech stack recommendation',
+      'Complete roadmap generation',
+      'Database schema design',
+      'API specification',
     ],
   },
 
-  // DEPRECATED: Use /p:feature instead
+  // 3. Feature with Roadmap
   {
-    name: 'idea',
-    category: 'deprecated',
-    description: '[DEPRECATED] Use /p:feature instead',
-    usage: {
-      claude: null,
-      terminal: null,
-    },
-    params: '<text>',
-    implemented: false,
-    hasTemplate: true,
-    icon: 'Lightbulb',
-    requiresInit: true,
-    blockingRules: null,
-    deprecated: true,
-    replacedBy: 'feature',
-  },
-
-  // 3. Strategic Roadmap
-  {
-    name: 'roadmap',
+    name: 'feature',
     category: 'core',
-    description: 'Strategic planning with ASCII logic maps',
+    description: 'Add feature with value analysis, roadmap, and task breakdown',
     usage: {
-      claude: '/p:roadmap',
-      terminal: 'prjct roadmap',
+      claude: '/p:feature "add unit testing"',
+      terminal: 'prjct feature "add unit testing"',
     },
-    params: null,
+    params: '<description>',
     implemented: true,
     hasTemplate: true,
-    icon: 'Map',
+    icon: 'Package',
     requiresInit: true,
     blockingRules: null,
     features: [
-      'ASCII logic maps (not mermaid)',
-      'Shows approved ideas',
-      'Implementation status',
-      'Dependencies visualization',
+      'Value analysis (impact/effort/timing)',
+      'Auto roadmap generation',
+      'Task breakdown',
+      'Auto-start first task',
+      'Timing recommendations',
     ],
   },
 
-  // 4. Status Dashboard
+  // 4. Work - Unified task management (replaces now + build)
   {
-    name: 'status',
+    name: 'work',
     category: 'core',
-    description: 'KPI dashboard with ASCII graphics',
+    description: 'Show current or start new task',
     usage: {
-      claude: '/p:status',
-      terminal: 'prjct status',
+      claude: '/p:work ["task"]',
+      terminal: 'prjct work ["task"]',
     },
-    params: null,
+    params: '[task]',
     implemented: true,
     hasTemplate: true,
-    icon: 'BarChart3',
+    icon: 'Target',
     requiresInit: true,
     blockingRules: null,
     features: [
-      'ASCII progress bars',
-      'Task completion metrics',
-      'Current focus display',
-      'Time tracking',
-      'Visual KPI dashboard',
+      'No params → Show current task',
+      'With task → Start new task',
+      'Auto agent assignment',
+      'Supports task numbers',
+      'Replaces /p:now and /p:build',
     ],
   },
 
-  // 5. Current Task
+  // 5. Pause - Pause active task
   {
-    name: 'now',
+    name: 'pause',
     category: 'core',
-    description: 'Show current working task',
+    description: 'Pause active task to handle interruption',
     usage: {
-      claude: '/p:now',
-      terminal: 'prjct now',
+      claude: '/p:pause ["reason"]',
+      terminal: 'prjct pause ["reason"]',
     },
-    params: null,
+    params: '[reason]',
     implemented: true,
     hasTemplate: true,
-    icon: 'Target',
+    icon: 'Pause',
     requiresInit: true,
-    blockingRules: null,
+    blockingRules: {
+      check: 'Active task exists',
+      message: 'No active task to pause',
+    },
+    features: [
+      'Preserves task context',
+      'Optional pause reason',
+      'Tracks paused duration',
+      'Allows multiple paused tasks',
+    ],
   },
 
-  // 6. Build (Start Task)
+  // 6. Resume - Resume paused task
   {
-    name: 'build',
+    name: 'resume',
     category: 'core',
-    description: 'Start task with agent assignment and tracking',
+    description: 'Resume most recently paused task',
     usage: {
-      claude: '/p:build "implement auth"',
-      terminal: 'prjct build "implement auth"',
+      claude: '/p:resume [task_id]',
+      terminal: 'prjct resume [task_id]',
     },
-    params: '<task> | [1-5]',
+    params: '[task_id]',
     implemented: true,
     hasTemplate: true,
     icon: 'Play',
     requiresInit: true,
     blockingRules: {
-      check: 'now.md must be empty',
-      message: 'Complete current task with /p:done first',
+      check: 'Paused tasks exist',
+      message: 'No paused tasks to resume',
     },
     features: [
-      'Agent assignment (auto or manual)',
-      'GitHub dev tracking',
-      'Time estimation by complexity',
-      'Start time tracking',
-      'Moves to now.md with metadata',
+      'Resume last paused',
+      'Resume specific task',
+      'Resume by number',
+      'Calculates active time',
     ],
   },
 
@@ -267,97 +259,77 @@ const COMMANDS = [
     ],
   },
 
-  // 11. Ask - Intent to Action
+  // 11. Dashboard - Unified project view (replaces status, recap, progress, roadmap)
   {
-    name: 'ask',
+    name: 'dash',
     category: 'core',
-    description: 'Conversational intent to action translator',
+    description: 'Unified dashboard - status, progress, and roadmap',
     usage: {
-      claude: '/p:ask "what you want to do"',
-      terminal: 'prjct ask "what you want to do"',
+      claude: '/p:dash [view]',
+      terminal: 'prjct dash [view]',
     },
-    params: '<description>',
+    params: '[week|month|roadmap|compact]',
     implemented: true,
     hasTemplate: true,
-    icon: 'MessageCircle',
-    requiresInit: false, // Can work before init to guide setup
+    icon: 'BarChart3',
+    requiresInit: true,
     blockingRules: null,
     features: [
-      'Natural language understanding',
-      'Recommends command flow',
-      'Educational explanations',
-      'Interactive confirmation',
-      'Works in any language',
+      'Project overview',
+      'Weekly/monthly progress',
+      'Roadmap view',
+      'ASCII graphics',
+      'Replaces 4 commands',
     ],
   },
 
-  // 12. Suggest - Context-Aware Recommendations
+  // 12. Help - Enhanced contextual help (absorbs ask, suggest, stuck)
   {
-    name: 'suggest',
+    name: 'help',
     category: 'core',
-    description: 'Context-aware next steps suggestions',
+    description: 'Contextual help and guidance',
     usage: {
-      claude: '/p:suggest',
-      terminal: 'prjct suggest',
+      claude: '/p:help [topic]',
+      terminal: 'prjct help [topic]',
     },
-    params: null,
+    params: '[topic]',
     implemented: true,
     hasTemplate: true,
-    icon: 'Lightbulb',
-    requiresInit: true,
+    icon: 'HelpCircle',
+    requiresInit: false,
     blockingRules: null,
     features: [
-      'Analyzes project state',
-      'Recommends actions',
-      'Urgency detection',
-      'Momentum tracking',
-      'Personalized suggestions',
+      'Context-aware suggestions',
+      'Intent to action translator',
+      'Problem solving guidance',
+      'Absorbs ask/suggest/stuck',
     ],
   },
 
-  // 13. Architect Execute
+  // 13. Sync - Sync project state
   {
-    name: 'architect',
+    name: 'sync',
     category: 'core',
-    description: 'Execute architect plan and generate code',
+    description: 'Sync project state and update workflow agents',
     usage: {
-      claude: '/p:architect execute',
-      terminal: 'prjct architect execute',
+      claude: '/p:sync',
+      terminal: 'prjct sync',
     },
-    params: 'execute',
+    params: null,
     implemented: true,
-    hasTemplate: false,
-    icon: 'Hammer',
+    hasTemplate: true,
+    icon: 'RefreshCw',
     requiresInit: true,
     blockingRules: null,
     features: [
-      'Reads architect-session.md plan',
-      'Generates code structure',
-      'Uses Context7 for documentation',
-      'Language-agnostic implementation',
+      'Syncs project state',
+      'Updates dynamic agents',
+      'Refreshes context',
     ],
   },
 
   // ===== OPTIONAL COMMANDS (Advanced features) =====
 
-  // DEPRECATED: Workflow is now automatic in /p:ship
-  {
-    name: 'workflow',
-    category: 'deprecated',
-    description: '[DEPRECATED] Workflow is now automatic in /p:ship',
-    usage: {
-      claude: null,
-      terminal: null,
-    },
-    params: null,
-    implemented: false,
-    hasTemplate: true,
-    icon: 'GitBranch',
-    requiresInit: true,
-    blockingRules: null,
-    deprecated: true,
-    replacedBy: 'ship',
-  },
   {
     name: 'design',
     category: 'optional',
@@ -390,22 +362,6 @@ const COMMANDS = [
     blockingRules: null,
     isOptional: true,
   },
-  {
-    name: 'stuck',
-    category: 'optional',
-    description: 'Get contextual help with problems',
-    usage: {
-      claude: '/p:stuck "CORS error in API calls"',
-      terminal: 'prjct stuck "CORS error in API calls"',
-    },
-    params: '<issue description>',
-    implemented: true,
-    hasTemplate: true,
-    icon: 'HelpCircle',
-    requiresInit: true,
-    blockingRules: null,
-    isOptional: true,
-  },
   {
     name: 'analyze',
     category: 'optional',
@@ -422,22 +378,6 @@ const COMMANDS = [
     blockingRules: null,
     isOptional: true,
   },
-  {
-    name: 'sync',
-    category: 'optional',
-    description: 'Sync project state and update workflow agents',
-    usage: {
-      claude: '/p:sync',
-      terminal: 'prjct sync',
-    },
-    params: null,
-    implemented: true,
-    hasTemplate: true,
-    icon: 'RefreshCw',
-    requiresInit: true,
-    blockingRules: null,
-    isOptional: true,
-  },
 
   // ===== SETUP COMMANDS (Not part of daily workflow) =====
   {
@@ -494,7 +434,7 @@ const CATEGORIES = {
   core: {
     title: 'Core Workflow',
     icon: 'Zap',
-    description: '13 essential commands for daily development workflow',
+    description: '13 essential commands for daily development workflow (simplified)',
     order: 1,
   },
   optional: {

package/core/domain/agent-generator.js

@@ -3,71 +3,82 @@ const path = require('path')
 const os = require('os')
 
 /**
- * AgentGenerator - Dynamic agent generation for prjct-cli
- *
- * 100% AGENTIC - Claude decides which agents to create based on project analysis.
- * NO predetermined patterns, NO if/else logic, NO assumptions.
- *
- * @version 0.6.0 - Fully agentic refactor
+ * AgentGenerator - Universal Dynamic Agent Generation
+ * Optimized for minimal context usage
+ * @version 1.0.0
  */
 class AgentGenerator {
   constructor(projectId = null) {
     this.projectId = projectId
-
-    // Agents are stored in global project directory
-    if (projectId) {
-      this.outputDir = path.join(os.homedir(), '.prjct-cli', 'projects', projectId, 'agents')
-    } else {
-      // Fallback for backwards compatibility
-      this.outputDir = path.join(os.homedir(), '.prjct-cli', 'agents')
-    }
+    this.outputDir = projectId
+      ? path.join(os.homedir(), '.prjct-cli', 'projects', projectId, 'agents')
+      : path.join(os.homedir(), '.prjct-cli', 'agents')
   }
 
   /**
-   * Generate a single agent dynamically
-   * Claude (the LLM) decides which agents to create based on project analysis
-   *
-   * @param {string} agentName - Descriptive name (e.g., 'go-backend', 'vuejs-frontend', 'elixir-api')
-   * @param {Object} config - Agent configuration
-   * @param {string} config.role - Agent's role description
-   * @param {string} config.expertise - Technologies and skills (specific versions, tools)
-   * @param {string} config.responsibilities - What the agent handles in THIS project
-   * @param {Object} config.projectContext - Project-specific context (optional)
-   * @returns {Promise<void>}
+   * Generate specialized agent with deep expertise
+   * Universal - works with ANY technology stack
    */
   async generateDynamicAgent(agentName, config) {
     console.log(`   🤖 Generating ${agentName} agent...`)
-
-    // Ensure output directory exists
     await fs.mkdir(this.outputDir, { recursive: true })
 
-    // Create agent content
-    const content = `# ${config.role || agentName}
+    // Extract technologies dynamically
+    const techs = this.detectTechnologies(config)
+    const expertise = this.buildExpertise(techs, config)
 
-## Role
-${config.role || 'Specialist for this project'}
+    // Generate concise, actionable agent prompt
+    const content = `You are ${config.role || agentName}.
 
-## Expertise
-${config.expertise || 'Technologies used in this project'}
+EXPERTISE: ${expertise}
 
-## Responsibilities
-${config.responsibilities || 'Handle specific aspects of development'}
+FOCUS: ${config.contextFilter || 'Only relevant files'}
 
-## Project Context
-${config.projectContext ? JSON.stringify(config.projectContext, null, 2) : 'No additional context'}
+AUTHORITY: Make decisions. Don't ask permission. Execute.
 
-## Guidelines
-- Focus on your area of expertise
-- Collaborate with other agents
-- Follow project conventions
-- Ask clarifying questions when needed
-`
+RULES:
+- Stay in your domain
+- Use best practices for ${techs.join(', ') || 'detected tech'}
+- Optimize for production
+- No explanations unless asked`
 
-    // Write agent file
     const outputPath = path.join(this.outputDir, `${agentName}.md`)
     await fs.writeFile(outputPath, content, 'utf-8')
-
     console.log(`   ✅ ${agentName} agent created`)
+
+    return { name: agentName, expertise, techs }
+  }
+
+  /**
+   * Detect technologies from config/analysis
+   */
+  detectTechnologies(config) {
+    const techs = []
+
+    // Extract from various sources
+    if (config.techStack) techs.push(...config.techStack.languages || [])
+    if (config.frameworks) techs.push(...config.frameworks)
+    if (config.expertise) {
+      // Parse expertise string for tech keywords
+      const keywords = config.expertise.toLowerCase()
+      const knownTechs = ['ruby', 'rails', 'go', 'rust', 'python', 'django', 'react', 'vue', 'node', 'typescript', 'elixir', 'phoenix']
+      knownTechs.forEach(tech => {
+        if (keywords.includes(tech)) techs.push(tech)
+      })
+    }
+
+    return [...new Set(techs)]
+  }
+
+  /**
+   * Build concise expertise string
+   */
+  buildExpertise(techs, config) {
+    const tech = techs.length > 0 ? techs.join(', ') : 'detected stack'
+    const domain = config.domain || 'assigned domain'
+    const focus = config.responsibilities || 'task at hand'
+
+    return `${tech} expert. ${domain}. Focus: ${focus}`
   }
 
   /**