prjct-cli 0.44.1 → 0.45.3

package/core/commands/command-data.ts

@@ -5,7 +5,7 @@
  * Used by registry for introspection and help display.
  */
 
-import type { CommandMeta, CategoryInfo } from '../types'
+import type { CategoryInfo, CommandMeta } from '../types'
 
 // Category definitions
 export const CATEGORIES: Record<string, CategoryInfo> = {
@@ -38,7 +38,11 @@ export const COMMANDS: CommandMeta[] = [
     implemented: true,
     hasTemplate: true,
     requiresProject: false,
-    features: ['Architect mode for blank projects', 'Auto tech stack recommendation', 'Analyzes existing codebases'],
+    features: [
+      'Architect mode for blank projects',
+      'Auto tech stack recommendation',
+      'Analyzes existing codebases',
+    ],
   },
   {
     name: 'idea',
@@ -60,7 +64,12 @@ export const COMMANDS: CommandMeta[] = [
     implemented: true,
     hasTemplate: true,
     requiresProject: true,
-    features: ['Agentic type classification', '7-phase workflow', 'Git branch management', 'Task breakdown'],
+    features: [
+      'Agentic type classification',
+      '7-phase workflow',
+      'Git branch management',
+      'Task breakdown',
+    ],
   },
   {
     name: 'spec',
@@ -142,6 +151,17 @@ export const COMMANDS: CommandMeta[] = [
     hasTemplate: true,
     requiresProject: true,
   },
+  {
+    name: 'stats',
+    group: 'core',
+    description: 'Value dashboard - token savings, performance, and impact',
+    usage: { claude: '/p:stats', terminal: 'prjct stats' },
+    params: '[--json] [--export]',
+    implemented: true,
+    hasTemplate: true,
+    requiresProject: true,
+    features: ['Token savings tracking', 'Compression metrics', 'Cost estimates', '30-day trends'],
+  },
   {
     name: 'sync',
     group: 'core',
@@ -308,13 +328,34 @@ export const COMMANDS: CommandMeta[] = [
   {
     name: 'context',
     group: 'setup',
-    description: 'Get project context as JSON for Claude templates',
-    usage: { claude: null, terminal: 'prjct context <command> [args]' },
-    params: '<command> [args]',
+    description: 'Smart context filtering tools for AI agents',
+    usage: { claude: null, terminal: 'prjct context <tool> [args]' },
+    params: '<tool> [args]',
     implemented: true,
     hasTemplate: false,
     requiresProject: true,
-    features: ['Returns JSON with project context', 'Runs orchestrator', 'Loads agents and skills'],
+    features: [
+      'files - Find relevant files for a task',
+      'signatures - Extract code structure (~90% compression)',
+      'imports - Analyze dependency graphs',
+      'recent - Find hot files from git history',
+      'summary - Intelligent file summarization',
+    ],
+  },
+  {
+    name: 'uninstall',
+    group: 'setup',
+    description: 'Complete system removal of prjct',
+    usage: { claude: null, terminal: 'prjct uninstall' },
+    params: '[--force] [--backup] [--dry-run]',
+    implemented: true,
+    hasTemplate: false,
+    requiresProject: false,
+    features: [
+      'Removes ~/.prjct-cli/ data',
+      'Cleans CLAUDE.md prjct section',
+      'Uninstalls Homebrew/npm packages',
+      'Backup option before deletion',
+    ],
   },
 ]
-

package/core/commands/commands.ts

@@ -14,24 +14,23 @@
  * - Context: context
  */
 
-import { WorkflowCommands } from './workflow'
-import { PlanningCommands } from './planning'
-import { ShippingCommands } from './shipping'
-import { AnalyticsCommands } from './analytics'
-import { MaintenanceCommands } from './maintenance'
-import { AnalysisCommands } from './analysis'
-import { SetupCommands } from './setup'
-import { ContextCommands } from './context'
-
 import type {
-  CommandResult,
   AgentInfo,
+  AnalyzeOptions,
   Author,
-  DesignOptions,
   CleanupOptions,
+  CommandResult,
+  DesignOptions,
   SetupOptions,
-  AnalyzeOptions
 } from '../types'
+import { AnalysisCommands } from './analysis'
+import { AnalyticsCommands } from './analytics'
+import { ContextCommands } from './context'
+import { MaintenanceCommands } from './maintenance'
+import { PlanningCommands } from './planning'
+import { SetupCommands } from './setup'
+import { ShippingCommands } from './shipping'
+import { WorkflowCommands } from './workflow'
 
 /**
  * PrjctCommands - Combined class with all commands
@@ -84,13 +83,19 @@ class PrjctCommands {
     return this.workflow.pause(reason, projectPath)
   }
 
-  async resume(taskId: string | null = null, projectPath: string = process.cwd()): Promise<CommandResult> {
+  async resume(
+    taskId: string | null = null,
+    projectPath: string = process.cwd()
+  ): Promise<CommandResult> {
     return this.workflow.resume(taskId, projectPath)
   }
 
   // ========== Planning Commands ==========
 
-  async init(idea: string | null = null, projectPath: string = process.cwd()): Promise<CommandResult> {
+  async init(
+    idea: string | null = null,
+    projectPath: string = process.cwd()
+  ): Promise<CommandResult> {
     return this.planning.init(idea, projectPath)
   }
 
@@ -102,7 +107,10 @@ class PrjctCommands {
     return this.planning.idea(description, projectPath)
   }
 
-  async spec(featureName: string | null = null, projectPath: string = process.cwd()): Promise<CommandResult> {
+  async spec(
+    featureName: string | null = null,
+    projectPath: string = process.cwd()
+  ): Promise<CommandResult> {
     return this.planning.spec(featureName, projectPath)
   }
 
@@ -114,7 +122,10 @@ class PrjctCommands {
 
   // ========== Analytics Commands ==========
 
-  async dash(view: string = 'default', projectPath: string = process.cwd()): Promise<CommandResult> {
+  async dash(
+    view: string = 'default',
+    projectPath: string = process.cwd()
+  ): Promise<CommandResult> {
     return this.analytics.dash(view, projectPath)
   }
 
@@ -124,11 +135,18 @@ class PrjctCommands {
 
   // ========== Maintenance Commands ==========
 
-  async cleanup(options: CleanupOptions = {}, projectPath: string = process.cwd()): Promise<CommandResult> {
+  async cleanup(
+    options: CleanupOptions = {},
+    projectPath: string = process.cwd()
+  ): Promise<CommandResult> {
     return this.maintenance.cleanup(options, projectPath)
   }
 
-  async design(target: string | null = null, options: DesignOptions = {}, projectPath: string = process.cwd()): Promise<CommandResult> {
+  async design(
+    target: string | null = null,
+    options: DesignOptions = {},
+    projectPath: string = process.cwd()
+  ): Promise<CommandResult> {
     return this.maintenance.design(target, options, projectPath)
   }
 
@@ -150,17 +168,33 @@ class PrjctCommands {
 
   // ========== Analysis Commands ==========
 
-  async analyze(options: AnalyzeOptions = {}, projectPath: string = process.cwd()): Promise<CommandResult> {
+  async analyze(
+    options: AnalyzeOptions = {},
+    projectPath: string = process.cwd()
+  ): Promise<CommandResult> {
     return this.analysis.analyze(options, projectPath)
   }
 
-  async sync(projectPath: string = process.cwd(), options: { aiTools?: string[] } = {}): Promise<CommandResult> {
+  async sync(
+    projectPath: string = process.cwd(),
+    options: { aiTools?: string[] } = {}
+  ): Promise<CommandResult> {
     return this.analysis.sync(projectPath, options)
   }
 
+  async stats(
+    projectPath: string = process.cwd(),
+    options: { json?: boolean; export?: boolean } = {}
+  ): Promise<CommandResult> {
+    return this.analysis.stats(projectPath, options)
+  }
+
   // ========== Context Commands ==========
 
-  async context(input: string | null = null, projectPath: string = process.cwd()): Promise<CommandResult> {
+  async context(
+    input: string | null = null,
+    projectPath: string = process.cwd()
+  ): Promise<CommandResult> {
     return this.contextCmds.context(input, projectPath)
   }
 
@@ -200,7 +234,11 @@ class PrjctCommands {
     return this.workflow.getGlobalProjectPath(projectPath)
   }
 
-  async logToMemory(projectPath: string, action: string, data: Record<string, unknown>): Promise<void> {
+  async logToMemory(
+    projectPath: string,
+    action: string,
+    data: Record<string, unknown>
+  ): Promise<void> {
     return this.workflow.logToMemory(projectPath, action, data)
   }
 }
@@ -210,4 +248,3 @@ const instance = new PrjctCommands()
 
 export default instance
 export { PrjctCommands }
-

package/core/commands/context.ts

@@ -15,14 +15,14 @@
  * @version 1.0.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import orchestratorExecutor from '../agentic/orchestrator-executor'
 import configManager from '../infrastructure/config-manager'
 import pathManager from '../infrastructure/path-manager'
 import { stateStorage } from '../storage'
-import orchestratorExecutor from '../agentic/orchestrator-executor'
-import { isNotFoundError } from '../types/fs'
 import type { CommandResult } from '../types'
+import { isNotFoundError } from '../types/fs'
 
 // =============================================================================
 // Types

package/core/commands/design.ts

@@ -4,17 +4,10 @@
  * System architecture, API, and component design operations.
  */
 
-import path from 'path'
-
-import type { CommandResult, DesignOptions } from '../types'
-import {
-  pathManager,
-  configManager,
-  fileHelper,
-  dateHelper,
-  out
-} from './base'
+import path from 'node:path'
 import { memoryService } from '../services'
+import type { CommandResult, DesignOptions } from '../types'
+import { configManager, dateHelper, fileHelper, out, pathManager } from './base'
 
 /**
  * /p:design - Design system architecture, APIs, and components

package/core/commands/index.ts

@@ -8,15 +8,12 @@
  * - New: import { commandRegistry } from './commands' → registry.execute('work')
  */
 
+// Types
+export * from '../types'
 // Legacy exports (backwards compat)
 export { default, PrjctCommands } from './commands'
-
-// New registry-based exports
-export { commandRegistry, CommandRegistry } from './registry'
-export type { ExecutionContext, CommandHandler, HandlerFn, CommandMeta } from './registry'
-
 // Command registration (auto-runs on import)
 export { registerAllCommands } from './register'
-
-// Types
-export * from '../types'
+export type { CommandHandler, CommandMeta, ExecutionContext, HandlerFn } from './registry'
+// New registry-based exports
+export { CommandRegistry, commandRegistry } from './registry'

package/core/commands/maintenance.ts

@@ -7,13 +7,13 @@
  * - snapshots: Git-based undo/redo and session recovery
  */
 
-import type { CommandResult, CleanupOptions, DesignOptions } from '../types'
+import type { CleanupOptions, CommandResult, DesignOptions } from '../types'
 import { PrjctCommandsBase } from './base'
 
 // Import individual command functions
 import { cleanup, cleanupMemory, cleanupMemoryInternal } from './cleanup'
 import { design } from './design'
-import { recover, undo, redo, history } from './snapshots'
+import { history, recover, redo, undo } from './snapshots'
 
 /**
  * MaintenanceCommands - Facade class for maintenance operations
@@ -25,7 +25,10 @@ export class MaintenanceCommands extends PrjctCommandsBase {
   _cleanupMemory = cleanupMemory
   _cleanupMemoryInternal = cleanupMemoryInternal
 
-  async cleanup(options: CleanupOptions = {}, projectPath: string = process.cwd()): Promise<CommandResult> {
+  async cleanup(
+    options: CleanupOptions = {},
+    projectPath: string = process.cwd()
+  ): Promise<CommandResult> {
     const initResult = await this.ensureProjectInit(projectPath)
     if (!initResult.success) return initResult
     return cleanup(options, projectPath)
@@ -71,4 +74,4 @@ export class MaintenanceCommands extends PrjctCommandsBase {
 // Re-export individual functions for direct use
 export { cleanup, cleanupMemory, cleanupMemoryInternal } from './cleanup'
 export { design } from './design'
-export { recover, undo, redo, history } from './snapshots'
+export { history, recover, redo, undo } from './snapshots'