prjct-cli 0.8.6 → 0.9.1

package/core/agentic/tool-registry.js

@@ -9,6 +9,7 @@ const path = require('path')
 const { promisify } = require('util')
 const { exec: execCallback } = require('child_process')
 const exec = promisify(execCallback)
+const dateHelper = require('../utils/date-helper')
 
 class ToolRegistry {
   constructor() {
@@ -17,6 +18,9 @@ class ToolRegistry {
       Write: this.write.bind(this),
       Bash: this.bash.bind(this),
       Exec: this.bash.bind(this), // Alias
+      GetTimestamp: this.getTimestamp.bind(this),
+      GetDate: this.getDate.bind(this),
+      GetDateTime: this.getDateTime.bind(this),
     }
   }
 
@@ -112,6 +116,37 @@ class ToolRegistry {
       return []
     }
   }
+
+  /**
+   * Get current system timestamp (ISO format)
+   * LLM MUST use this instead of generating timestamps
+   * @returns {Promise<string>} ISO timestamp (e.g., "2025-10-07T14:30:00.000Z")
+   */
+  async getTimestamp() {
+    return dateHelper.getTimestamp()
+  }
+
+  /**
+   * Get current system date (YYYY-MM-DD)
+   * LLM MUST use this instead of generating dates
+   * @returns {Promise<string>} Date string (e.g., "2025-10-07")
+   */
+  async getDate() {
+    return dateHelper.getTodayKey()
+  }
+
+  /**
+   * Get current system date/time components
+   * @returns {Promise<Object>} Date components {timestamp, date, year, month, day}
+   */
+  async getDateTime() {
+    const now = new Date()
+    return {
+      timestamp: dateHelper.getTimestamp(),
+      date: dateHelper.getTodayKey(),
+      ...dateHelper.getYearMonthDay(now),
+    }
+  }
 }
 
 module.exports = new ToolRegistry()

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/commands.js

@@ -1126,6 +1126,81 @@ class PrjctCommands {
    * /p:design - Design system architecture, APIs, and components
    * AGENTIC EXECUTION
    */
+  /**
+   * Memory cleanup helper
+   * Rotates large JSONL files, archives old sessions, reports disk usage
+   * @private
+   */
+  async _cleanupMemory(projectPath) {
+    const projectId = await configManager.getProjectId(projectPath)
+    const globalPath = pathManager.getGlobalProjectPath(projectId)
+
+    console.log('📊 Analyzing disk usage...\n')
+
+    const results = {
+      rotated: [],
+      archived: [],
+      totalSize: 0,
+      freedSpace: 0,
+    }
+
+    // 1. Check and rotate large JSONL files
+    const jsonlFiles = [
+      pathManager.getFilePath(projectId, 'memory', 'context.jsonl'),
+      pathManager.getFilePath(projectId, 'progress', 'shipped.md'),
+      pathManager.getFilePath(projectId, 'planning', 'ideas.md'),
+    ]
+
+    for (const filePath of jsonlFiles) {
+      try {
+        const sizeMB = await jsonlHelper.getFileSizeMB(filePath)
+        if (sizeMB > 0) {
+          results.totalSize += sizeMB
+
+          const rotated = await jsonlHelper.rotateJsonLinesIfNeeded(filePath, 10)
+          if (rotated) {
+            results.rotated.push(path.basename(filePath))
+            results.freedSpace += sizeMB
+          }
+        }
+      } catch (error) {
+        // File doesn't exist, skip
+      }
+    }
+
+    // 2. Report disk usage
+    console.log('💾 Disk Usage Report:\n')
+    console.log(`   Total size: ${results.totalSize.toFixed(2)}MB`)
+    console.log(`   Rotated files: ${results.rotated.length}`)
+
+    if (results.rotated.length > 0) {
+      console.log(`   Freed space: ${results.freedSpace.toFixed(2)}MB\n`)
+      results.rotated.forEach((file) => console.log(`   ✓ ${file}`))
+    } else {
+      console.log('   ✓ No rotation needed - all files under 10MB\n')
+    }
+
+    // 3. Suggestions
+    console.log('\n💡 Recommendations:\n')
+    console.log('   1. Claude Code: Compact conversation regularly')
+    console.log('   2. Exclude from Spotlight: System Settings → Privacy')
+    console.log('   3. Clear npm cache: npm cache clean --force\n')
+
+    return { success: true, results }
+  }
+
+  /**
+   * Internal cleanup helper for memory during normal cleanup
+   * @private
+   */
+  async _cleanupMemoryInternal(projectPath) {
+    const projectId = await configManager.getProjectId(projectPath)
+
+    // Silently rotate large files
+    const memoryPath = pathManager.getFilePath(projectId, 'memory', 'context.jsonl')
+    await jsonlHelper.rotateJsonLinesIfNeeded(memoryPath, 10)
+  }
+
   async design(target = null, options = {}, projectPath = process.cwd()) {
     try {
       const initResult = await this.ensureProjectInit(projectPath)
@@ -1575,6 +1650,13 @@ Process flow for ${target}.
       const initResult = await this.ensureProjectInit(projectPath)
       if (!initResult.success) return initResult
 
+      const isMemoryMode = _options.memory === true || _options.type === 'memory'
+
+      if (isMemoryMode) {
+        console.log('🧹 Memory cleanup...\n')
+        return await this._cleanupMemory(projectPath)
+      }
+
       console.log('🧹 Cleaning up project...\n')
 
       const context = await contextBuilder.build(projectPath)
@@ -1649,6 +1731,8 @@ Process flow for ${target}.
       console.log('✅ Cleanup complete!\n')
       cleaned.forEach((item) => console.log(`   • ${item}`))
 
+      await this._cleanupMemoryInternal(projectPath)
+
       await this.logToMemory(projectPath, 'cleanup_performed', {
         items: cleaned.length,
         timestamp: dateHelper.getTimestamp(),