prjct-cli 0.13.3 → 0.15.0

package/CHANGELOG.md

@@ -1,5 +1,111 @@
 # Changelog
 
+## [0.15.0] - 2025-12-15
+
+### Template Optimization - Aggressive Consolidation
+
+Reduced command templates from 39 to 27 through strategic consolidation and elimination of redundancy.
+
+- **Command Consolidation**
+  - `/p:dash` absorbs status, progress, recap (views: default, week, month, compact)
+  - `/p:now` absorbs work, build (single task-start command)
+  - `/p:resume` absorbs recover (--recover flag for abandoned sessions)
+  - `/p:next` adds roadmap view (feature-grouped queue)
+  - `/p:ask` absorbs fix (troubleshooting mode)
+  - `/p:spec` absorbs decision (inline decision logging)
+
+- **Eliminated Redundant Commands**
+  - Removed: work, build, task, status, progress, recap, help
+  - Removed: roadmap, decision, fix, workflow, recover
+  - Total: 12 command templates deleted
+
+- **Auxiliary Template Cleanup**
+  - Merged accessibility.md → ux-ui.md
+  - Merged project-analysis.md → analyze.md
+  - Merged agent-assignment.md → agent-routing.md
+
+- **Template Enhancements**
+  - Agent detection table in now.md
+  - KPI metrics and velocity calculation in dash.md
+  - Recovery mode with 4 options in resume.md
+  - Standardized frontmatter across all templates
+
+- **Registry Updates**
+  - Updated core-commands.ts with consolidated commands
+  - Updated optional-commands.ts with git, test, serve
+
+## [0.14.0] - 2025-12-11
+
+### Actionable Dashboard + Session Recovery
+
+Dashboard is now fully actionable - click any item to execute commands in the terminal.
+
+- **Session Recovery System**
+  - `/p:recover` command to recover abandoned sessions (>8h inactive)
+  - Captures session prompts for context restoration
+  - RecoverCard shows abandoned sessions across all projects
+
+- **Actionable Dashboard Cards**
+  - QueueCard: Start (Play) and Delete (X) buttons always visible
+  - IdeasCard: Convert to Feature (Rocket) and Delete (X) buttons always visible
+  - ExpandButton pattern for "Show more" (DRY with ActivityTimeline)
+  - Click any item → navigate to /code → auto-execute command
+
+- **Click-to-Action Pattern**
+  - URL pattern: `/project/{id}/code?cmd=p.%20now%20"task"`
+  - Auto-executes command on terminal load
+  - Works for: Queue items, Ideas, Roadmap features, NowCard actions
+
+- **NowCard Enhancements**
+  - Done/Pause/Resume action buttons
+  - Project color dot indicator
+
+- **Code Workspace Improvements**
+  - PageHeader component with project context
+  - Auto-command execution from URL params
+
+## [0.13.3] - 2025-12-11
+
+### MomentumWidget + Code Workspace + Weekly Reports
+
+New features for project dashboard and code workspace.
+
+- **MomentumWidget** - Motivational sparkline in `/code` header
+  - 7-day activity visualization (tasks + ships)
+  - Smart color coding: green for streaks/trending up, gray for normal, red only for abandoned (7+ days)
+  - Status messages: "On fire!", "X tasks this week", "Miss you!"
+
+- **Code Workspace** (`/project/[id]/code`)
+  - Full terminal-based project workspace
+  - Command sidebar with workflow commands
+  - Mobile support with floating action button
+
+- **Weekly Reports** (`/project/[id]/reports`)
+  - Generate and preview project progress reports
+  - Printable report view
+
+- **Dashboard Improvements**
+  - "Start working" quick action in project dropdown
+  - Project version displayed in detail page header
+
+- **Bug Fixes**
+  - TechStackBadges: Handle both array and object formats for techStack
+
+## [0.13.2] - 2025-12-10
+
+### Fixed - Remove Migration Gate
+
+- Removed MigrationGate from production build
+- Projects now load directly without migration checks
+
+## [0.13.1] - 2025-12-10
+
+### Fixed - Server Start Mode
+
+- Fixed serve.js to use `start` instead of `start:prod`
+- Restored sidebar collapse functionality
+- Fixed server OOM crash
+
 ## [0.13.0] - 2025-12-10
 
 ### Deep Sync + Cleanup migrations

package/bin/prjct

@@ -6,23 +6,22 @@
  * Auto-setup on first use (like Astro, Vite, etc.)
  */
 
-const { VERSION } = require('../core/utils/version.ts')
-const editorsConfig = require('../core/infrastructure/editors-config.ts').default
+import { VERSION } from '../core/utils/version.ts'
+import editorsConfig from '../core/infrastructure/editors-config.ts'
 
 // Check for special subcommands that bypass normal CLI
 const args = process.argv.slice(2)
+
 if (args[0] === 'dev') {
   // Launch prjct dev environment
-  require('./dev.js')
+  await import('./dev.js')
   process.exitCode = 0
 } else if (args[0] === 'web' || args[0] === 'serve') {
   // Launch prjct web server
-  require('./serve.js')
+  await import('./serve.js')
   process.exitCode = 0
 } else {
-
-// Ensure setup has run for this version
-;(async function ensureSetup() {
+  // Ensure setup has run for this version
   try {
     const lastVersion = await editorsConfig.getLastVersion()
 
@@ -31,18 +30,16 @@ if (args[0] === 'dev') {
       console.log('🔧 One-time setup (v' + VERSION + ')...')
       console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n')
 
-      const setup = require('../core/infrastructure/setup.ts').default
+      const { default: setup } = await import('../core/infrastructure/setup.ts')
       await setup.run()
 
       console.log('✓ Setup complete!\n')
     }
   } catch (error) {
-    console.error('\n⚠️  Setup warning:', error.message)
+    console.error('\n⚠️  Setup warning:', (error as Error).message)
     console.error('You can run setup manually: prjct setup\n')
   }
 
   // Continue to main CLI logic
-  require('../core/index.ts')
-})()
-
-} // end else
+  await import('../core/index.ts')
+}

package/core/agentic/memory-system/semantic-memories.ts

@@ -6,6 +6,7 @@
 import fs from 'fs/promises'
 import path from 'path'
 import pathManager from '../../infrastructure/path-manager'
+import { generateUUID } from '../../schemas'
 import type { Memory, MemoryDatabase, Context } from './types'
 import { MEMORY_TAGS } from './types'
 
@@ -59,7 +60,7 @@ export class SemanticMemories {
     const db = await this.loadMemories(projectId)
 
     const memory: Memory = {
-      id: `mem_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+      id: generateUUID(),
       title,
       content,
       tags,

package/core/agentic/plan-mode/plan-mode.ts

@@ -6,6 +6,7 @@
 import type { Plan, PlanParams, GatheredInfo, ProposedPlan, PlanStep, ApprovalContext, ApprovalPrompt } from './types'
 import { PLAN_STATUS, PLAN_REQUIRED_COMMANDS, DESTRUCTIVE_COMMANDS, PLANNING_TOOLS } from './constants'
 import { generateApprovalPrompt } from './approval'
+import { generateUUID } from '../../schemas'
 
 export class PlanMode {
   activePlans: Map<string, Plan>
@@ -51,7 +52,7 @@ export class PlanMode {
    */
   startPlanning(projectId: string, commandName: string, params: PlanParams): Plan {
     const plan: Plan = {
-      id: `plan_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+      id: generateUUID(),
       projectId,
       command: commandName,
       params,

package/core/agentic/prompt-builder.ts

@@ -11,11 +11,18 @@
 
 import fs from 'fs'
 import path from 'path'
-import stateManager from '../state'
+import { mdStateManager, mdQueueManager } from '../data'
 import { outcomeAnalyzer } from '../outcomes'
-import type { ProjectState } from '../state/types'
+import type { StateJson, QueueJson } from '../schemas/state'
 import type { DetectedPattern } from '../outcomes/analyzer'
 
+// Unified state for prompt context
+interface ProjectState {
+  projectId: string
+  currentTask: StateJson['currentTask']
+  queue: QueueJson['tasks']
+}
+
 interface Frontmatter {
   name?: string
   description?: string
@@ -108,7 +115,7 @@ class PromptBuilder {
   }
 
   /**
-   * Get unified project state with caching.
+   * Get unified project state from MD managers.
    */
   async getProjectState(projectId: string): Promise<ProjectState | null> {
     if (!projectId) return null
@@ -119,7 +126,17 @@ class PromptBuilder {
     }
 
     try {
-      const state = await stateManager.read(projectId)
+      const [stateData, queueData] = await Promise.all([
+        mdStateManager.read(projectId),
+        mdQueueManager.read(projectId)
+      ])
+
+      const state: ProjectState = {
+        projectId,
+        currentTask: stateData.currentTask,
+        queue: queueData.tasks
+      }
+
       this._stateCache.set(projectId, { state, timestamp: Date.now() })
       return state
     } catch {
@@ -128,7 +145,7 @@ class PromptBuilder {
   }
 
   /**
-   * Build auto-injected context from unified state.
+   * Build auto-injected context from MD state.
    * This is automatically added to every prompt.
    */
   async buildInjectedContext(projectId: string): Promise<string | null> {
@@ -148,27 +165,11 @@ class PromptBuilder {
       const elapsed = this.calculateElapsed(state.currentTask.startedAt)
       parts.push(`**Current Task**: ${state.currentTask.description}`)
       parts.push(`- Started: ${elapsed} ago`)
-      if (state.currentTask.agent) {
-        parts.push(`- Agent: ${state.currentTask.agent}`)
-      }
-      if (state.currentTask.pausedAt) {
-        parts.push(`- Status: PAUSED (${state.currentTask.pauseReason || 'no reason'})`)
-      }
     } else {
       parts.push('**Current Task**: None')
     }
     parts.push('')
 
-    // Active feature
-    if (state.activeFeature) {
-      const progress = state.activeFeature.tasksCompleted + state.activeFeature.tasksRemaining
-      const pct = progress > 0
-        ? Math.round((state.activeFeature.tasksCompleted / progress) * 100)
-        : 0
-      parts.push(`**Feature**: ${state.activeFeature.name} (${pct}% complete)`)
-      parts.push(`- Tasks: ${state.activeFeature.tasksCompleted}/${progress}`)
-    }
-
     // Queue summary
     if (state.queue.length > 0) {
       parts.push(`**Queue**: ${state.queue.length} tasks pending`)
@@ -182,18 +183,6 @@ class PromptBuilder {
     }
     parts.push('')
 
-    // Performance stats
-    if (state.stats.tasksToday > 0 || state.stats.streak > 0) {
-      parts.push('**Performance**')
-      parts.push(`- Today: ${state.stats.tasksToday} tasks`)
-      parts.push(`- Velocity: ${state.stats.velocity}`)
-      parts.push(`- Estimate accuracy: ${state.stats.estimateAccuracy}%`)
-      if (state.stats.streak > 1) {
-        parts.push(`- Streak: ${state.stats.streak} days`)
-      }
-      parts.push('')
-    }
-
     // Get detected patterns from outcomes
     try {
       const patterns = await outcomeAnalyzer.detectPatterns(projectId)
@@ -211,16 +200,6 @@ class PromptBuilder {
       // Outcomes not available yet
     }
 
-    // Recent activity
-    if (state.recentActivity.length > 0) {
-      parts.push('**Recent Activity**')
-      for (const activity of state.recentActivity.slice(0, 3)) {
-        const ago = this.calculateElapsed(activity.timestamp)
-        parts.push(`- ${activity.type}: ${activity.description} (${ago} ago)`)
-      }
-      parts.push('')
-    }
-
     parts.push('---')
     parts.push('')
 

package/core/agentic/services.ts

@@ -39,7 +39,7 @@ import contextFilter from './context-filter'
 import validationRules from './validation-rules'
 import agentRouter from './agent-router'
 import smartContext from './smart-context'
-import stateManager from '../state'
+import { mdManagers } from '../data'
 import { outcomeRecorder, outcomeAnalyzer } from '../outcomes'
 import { agentPerformanceTracker } from '../agents'
 
@@ -151,10 +151,10 @@ export interface AgenticServices {
   smartContext: typeof smartContext
 
   /**
-   * State manager - unified project state (read/write state.json)
-   * @see stateManager
+   * MD managers - MD-first state management
+   * @see mdManagers
    */
-  state: typeof stateManager
+  data: typeof mdManagers
 
   /**
    * Outcome recorder - records execution outcomes
@@ -197,7 +197,7 @@ export const services: AgenticServices = {
   validation: validationRules,
   router: agentRouter,
   smartContext: smartContext,
-  state: stateManager,
+  data: mdManagers,
   outcomes: outcomeRecorder,
   outcomeAnalysis: outcomeAnalyzer,
   agentPerformance: agentPerformanceTracker,

package/core/agentic/smart-context.ts

@@ -8,12 +8,17 @@
  * @version 1.0
  */
 
-import stateManager from '../state'
 import { agentPerformanceTracker } from '../agents'
 import { outcomeAnalyzer } from '../outcomes'
-import type { ProjectState } from '../state/types'
 import type { TaskType } from '../agents/types'
 
+// Local interface for context state
+interface ProjectState {
+  projectId: string
+  currentTask: { description: string; startedAt: string } | null
+  queue: { description: string; priority: string }[]
+}
+
 /**
  * Context domain for filtering.
  */

package/core/command-registry/core-commands.ts

@@ -98,14 +98,14 @@ export const CORE_COMMANDS: Command[] = [
   },
 
   {
-    name: 'work',
+    name: 'now',
     category: 'core',
-    description: 'Show current or start new task',
+    description: 'Set or show current task with session tracking',
     usage: {
-      claude: '/p:work ["task"]',
-      terminal: 'prjct work ["task"]',
+      claude: '/p:now ["task"] [estimate]',
+      terminal: 'prjct now ["task"] [estimate]',
     },
-    params: '[task]',
+    params: '[task] [estimate]',
     implemented: true,
     hasTemplate: true,
     requiresInit: true,
@@ -113,9 +113,10 @@ export const CORE_COMMANDS: Command[] = [
     features: [
       'No params -> Show current task',
       'With task -> Start new task',
-      'Auto agent assignment',
-      'Supports task numbers',
-      'Replaces /p:now and /p:build',
+      'Time estimates (2h, 30m, 1d)',
+      'Abandoned session detection',
+      'Auto agent detection',
+      'Session tracking',
     ],
   },
 
@@ -146,36 +147,38 @@ export const CORE_COMMANDS: Command[] = [
   {
     name: 'resume',
     category: 'core',
-    description: 'Resume most recently paused task',
+    description: 'Resume paused task or recover abandoned session',
     usage: {
-      claude: '/p:resume [task_id]',
-      terminal: 'prjct resume [task_id]',
+      claude: '/p:resume [--recover]',
+      terminal: 'prjct resume [--recover]',
     },
-    params: '[task_id]',
+    params: '[task_id] [--recover]',
     implemented: true,
     hasTemplate: true,
     requiresInit: true,
     blockingRules: {
-      check: 'Paused tasks exist',
+      check: 'Paused tasks or abandoned session exists',
       message: 'No paused tasks to resume',
     },
     features: [
       'Resume last paused',
       'Resume specific task',
-      'Resume by number',
       'Calculates active time',
+      'Recovery mode for abandoned sessions',
+      'Close as partial (metrics)',
+      'Save for later reference',
     ],
   },
 
   {
     name: 'next',
     category: 'core',
-    description: 'Show top 5 non-blocking priority tasks',
+    description: 'Show priority queue or roadmap view',
     usage: {
-      claude: '/p:next',
-      terminal: 'prjct next',
+      claude: '/p:next [roadmap]',
+      terminal: 'prjct next [roadmap]',
     },
-    params: null,
+    params: '[roadmap]',
     implemented: true,
     hasTemplate: true,
     requiresInit: true,
@@ -184,10 +187,11 @@ export const CORE_COMMANDS: Command[] = [
       message: 'Shows warning if now.md is active',
     },
     features: [
-      'Filters out blocked tasks',
+      'Priority queue view (default)',
+      'Roadmap view (feature-grouped)',
       'Shows top 5 by priority',
-      'Numbered 1-5 for quick selection',
-      'Warns if active task exists',
+      'Numbered for quick selection',
+      'Velocity calculation',
     ],
   },
 
@@ -277,23 +281,23 @@ export const CORE_COMMANDS: Command[] = [
   },
 
   {
-    name: 'help',
+    name: 'ask',
     category: 'core',
-    description: 'Contextual help and guidance',
+    description: 'Intent translator - helps understand what command to use',
     usage: {
-      claude: '/p:help [topic]',
-      terminal: 'prjct help [topic]',
+      claude: '/p:ask "I want to add dark mode"',
+      terminal: 'prjct ask "I want to add dark mode"',
     },
-    params: '[topic]',
+    params: '<intent>',
     implemented: true,
     hasTemplate: true,
     requiresInit: false,
     blockingRules: null,
     features: [
+      'Natural language intent parsing',
+      'Command flow recommendations',
+      'Troubleshooting guidance',
       'Context-aware suggestions',
-      'Intent to action translator',
-      'Problem solving guidance',
-      'Absorbs ask/suggest/stuck',
     ],
   },
 
@@ -316,4 +320,25 @@ export const CORE_COMMANDS: Command[] = [
       'Refreshes context',
     ],
   },
+
+  {
+    name: 'suggest',
+    category: 'core',
+    description: 'Smart recommendations based on project state',
+    usage: {
+      claude: '/p:suggest',
+      terminal: 'prjct suggest',
+    },
+    params: null,
+    implemented: true,
+    hasTemplate: true,
+    requiresInit: true,
+    blockingRules: null,
+    features: [
+      'Context-aware recommendations',
+      'Momentum-based suggestions',
+      'Next action guidance',
+      'Pattern detection',
+    ],
+  },
 ]

package/core/command-registry/optional-commands.ts

@@ -116,4 +116,68 @@ export const OPTIONAL_COMMANDS: Command[] = [
       'Redo availability count',
     ],
   },
+
+  {
+    name: 'git',
+    category: 'optional',
+    description: 'Smart git operations with context',
+    usage: {
+      claude: '/p:git [operation]',
+      terminal: 'prjct git [operation]',
+    },
+    params: '[operation]',
+    implemented: true,
+    hasTemplate: true,
+    requiresInit: true,
+    blockingRules: null,
+    isOptional: true,
+    features: [
+      'Context-aware commits',
+      'Smart branch naming',
+      'Task-linked commits',
+      'Memory trail logging',
+    ],
+  },
+
+  {
+    name: 'test',
+    category: 'optional',
+    description: 'Run tests with auto-fix',
+    usage: {
+      claude: '/p:test',
+      terminal: 'prjct test',
+    },
+    params: null,
+    implemented: true,
+    hasTemplate: true,
+    requiresInit: true,
+    blockingRules: null,
+    isOptional: true,
+    features: [
+      'Run project tests',
+      'Auto-fix suggestions',
+      'Coverage reporting',
+    ],
+  },
+
+  {
+    name: 'serve',
+    category: 'optional',
+    description: 'Start prjct web server',
+    usage: {
+      claude: '/p:serve',
+      terminal: 'prjct serve',
+    },
+    params: '[port]',
+    implemented: true,
+    hasTemplate: true,
+    requiresInit: true,
+    blockingRules: null,
+    isOptional: true,
+    features: [
+      'Local dashboard server',
+      'API endpoints',
+      'Real-time updates',
+    ],
+  },
 ]

package/core/command-registry/setup-commands.ts

@@ -36,15 +36,30 @@ export const SETUP_COMMANDS: Command[] = [
     blockingRules: null,
   },
 
+  {
+    name: 'migrate',
+    category: 'setup',
+    description: 'Migrate project to UUID format + sync',
+    usage: {
+      claude: '/p:migrate',
+      terminal: null, // Claude-only
+    },
+    params: null,
+    implemented: true,
+    hasTemplate: true,
+    requiresInit: true,
+    blockingRules: null,
+  },
+
   {
     name: 'migrate-all',
     category: 'setup',
-    description: 'Migrate all legacy projects',
+    description: 'Migrate all legacy projects to UUID format',
     usage: {
       claude: '/p:migrate-all',
-      terminal: 'prjct migrate-all [--deep-scan] [--remove-legacy] [--dry-run]',
+      terminal: 'prjct migrate-all [--deep-scan] [--dry-run]',
     },
-    params: '[--deep-scan] [--remove-legacy] [--dry-run]',
+    params: '[--deep-scan] [--dry-run]',
     implemented: true,
     hasTemplate: true,
     requiresInit: false,