prjct-cli 0.42.0 → 0.44.1

package/core/services/sync-service.ts

@@ -22,6 +22,14 @@ import { promisify } from 'util'
 import pathManager from '../infrastructure/path-manager'
 import configManager from '../infrastructure/config-manager'
 import dateHelper from '../utils/date-helper'
+import {
+  generateAIToolContexts,
+  DEFAULT_AI_TOOLS,
+  resolveToolIds,
+  detectInstalledTools,
+  type ProjectContext,
+  type GenerateResult,
+} from '../ai-tools'
 
 const execAsync = promisify(exec)
 
@@ -77,6 +85,12 @@ interface AgentInfo {
   skill?: string
 }
 
+interface AIToolResult {
+  toolId: string
+  outputFile: string
+  success: boolean
+}
+
 interface SyncResult {
   success: boolean
   projectId: string
@@ -88,9 +102,14 @@ interface SyncResult {
   agents: AgentInfo[]
   skills: { agent: string; skill: string }[]
   contextFiles: string[]
+  aiTools: AIToolResult[]
   error?: string
 }
 
+interface SyncOptions {
+  aiTools?: string[]  // AI tools to generate context for (default: claude, cursor)
+}
+
 // ============================================================================
 // SYNC SERVICE
 // ============================================================================
@@ -108,9 +127,22 @@ class SyncService {
   /**
    * Main sync method - does everything in one call
    */
-  async sync(projectPath: string = process.cwd()): Promise<SyncResult> {
+  async sync(projectPath: string = process.cwd(), options: SyncOptions = {}): Promise<SyncResult> {
     this.projectPath = projectPath
 
+    // Resolve AI tools: supports 'auto', 'all', or specific list
+    let aiToolIds: string[]
+    if (!options.aiTools || options.aiTools.length === 0) {
+      aiToolIds = DEFAULT_AI_TOOLS
+    } else if (options.aiTools[0] === 'auto') {
+      aiToolIds = detectInstalledTools(projectPath)
+      if (aiToolIds.length === 0) aiToolIds = ['claude'] // fallback
+    } else if (options.aiTools[0] === 'all') {
+      aiToolIds = resolveToolIds('all', projectPath)
+    } else {
+      aiToolIds = options.aiTools
+    }
+
     try {
       // 1. Get project config
       this.projectId = await configManager.getProjectId(projectPath)
@@ -126,6 +158,7 @@ class SyncService {
           agents: [],
           skills: [],
           contextFiles: [],
+          aiTools: [],
           error: 'No prjct project. Run p. init first.',
         }
       }
@@ -147,13 +180,41 @@ class SyncService {
       const skills = this.configureSkills(agents)
       const contextFiles = await this.generateContextFiles(git, stats, commands, agents)
 
-      // 5. Update project.json
+      // 5. Generate AI tool context files (multi-agent output)
+      const projectContext: ProjectContext = {
+        projectId: this.projectId,
+        name: stats.name,
+        version: stats.version,
+        ecosystem: stats.ecosystem,
+        projectType: stats.projectType,
+        languages: stats.languages,
+        frameworks: stats.frameworks,
+        repoPath: this.projectPath,
+        branch: git.branch,
+        fileCount: stats.fileCount,
+        commits: git.commits,
+        hasChanges: git.hasChanges,
+        commands,
+        agents: {
+          workflow: agents.filter(a => a.type === 'workflow').map(a => a.name),
+          domain: agents.filter(a => a.type === 'domain').map(a => a.name),
+        },
+      }
+
+      const aiToolResults = await generateAIToolContexts(
+        projectContext,
+        this.globalPath,
+        this.projectPath,
+        aiToolIds
+      )
+
+      // 6. Update project.json
       await this.updateProjectJson(git, stats)
 
-      // 6. Update state.json with enterprise fields
+      // 7. Update state.json with enterprise fields
       await this.updateStateJson(stats, stack)
 
-      // 7. Log to memory
+      // 8. Log to memory
       await this.logToMemory(git, stats)
 
       return {
@@ -167,6 +228,11 @@ class SyncService {
         agents,
         skills,
         contextFiles,
+        aiTools: aiToolResults.map(r => ({
+          toolId: r.toolId,
+          outputFile: r.outputFile,
+          success: r.success,
+        })),
       }
     } catch (error) {
       return {
@@ -180,6 +246,7 @@ class SyncService {
         agents: [],
         skills: [],
         contextFiles: [],
+        aiTools: [],
         error: (error as Error).message,
       }
     }

package/core/utils/agent-stream.ts

@@ -0,0 +1,138 @@
+/**
+ * Agent Activity Stream
+ *
+ * Shows real-time agent activity during task execution.
+ * Provides visibility into which agents are working and what they're doing.
+ */
+
+import chalk from 'chalk'
+
+/**
+ * Domain icons for visual identification
+ */
+const DOMAIN_ICONS: Record<string, string> = {
+  database: '💾',
+  backend: '🔧',
+  frontend: '📦',
+  testing: '🧪',
+  devops: '🚀',
+  uxui: '🎨',
+  security: '🔒',
+  docs: '📝',
+  api: '🌐',
+  default: '⚡',
+}
+
+/**
+ * Get icon for a domain
+ */
+function getIcon(domain: string): string {
+  return DOMAIN_ICONS[domain.toLowerCase()] || DOMAIN_ICONS.default
+}
+
+/**
+ * Agent Stream - Visual activity tracker
+ */
+class AgentStream {
+  private currentAgent: string | null = null
+  private startTime: number = 0
+  private quiet: boolean = false
+
+  /**
+   * Set quiet mode (no output)
+   */
+  setQuiet(quiet: boolean): void {
+    this.quiet = quiet
+  }
+
+  /**
+   * Show orchestration start
+   */
+  orchestrate(domains: string[]): void {
+    if (this.quiet) return
+    console.log(chalk.cyan(`\n🎯 Orchestrating: ${domains.join(', ')} domains detected\n`))
+  }
+
+  /**
+   * Start an agent activity block
+   */
+  startAgent(name: string, domain: string, description?: string): void {
+    if (this.quiet) return
+
+    this.currentAgent = name
+    this.startTime = Date.now()
+
+    const icon = getIcon(domain)
+    console.log(chalk.cyan(`┌─ ${icon} ${name} (${domain})`))
+
+    if (description) {
+      console.log(chalk.dim(`│  ${description}`))
+    }
+  }
+
+  /**
+   * Show progress within current agent
+   */
+  progress(message: string): void {
+    if (this.quiet || !this.currentAgent) return
+    console.log(chalk.dim(`│  └── ${message}`))
+  }
+
+  /**
+   * Show multiple progress items
+   */
+  progressList(items: string[]): void {
+    if (this.quiet || !this.currentAgent) return
+    for (const item of items) {
+      console.log(chalk.dim(`│  └── ${item}`))
+    }
+  }
+
+  /**
+   * End current agent block
+   */
+  endAgent(success: boolean = true): void {
+    if (this.quiet || !this.currentAgent) return
+
+    const duration = Date.now() - this.startTime
+    const durationStr = this.formatDuration(duration)
+
+    const icon = success ? chalk.green('✓') : chalk.red('✗')
+    const status = success ? 'Complete' : 'Failed'
+
+    console.log(`└─ ${icon} ${status} ${chalk.dim(`(${durationStr})`)}\n`)
+    this.currentAgent = null
+  }
+
+  /**
+   * Show a simple status line (no block)
+   */
+  status(icon: string, message: string): void {
+    if (this.quiet) return
+    console.log(`${icon} ${message}`)
+  }
+
+  /**
+   * Show task completion summary
+   */
+  complete(taskName: string, totalDuration?: number): void {
+    if (this.quiet) return
+
+    const durationStr = totalDuration ? ` ${chalk.dim(`[${this.formatDuration(totalDuration)}]`)}` : ''
+    console.log(chalk.green(`✅ ${taskName}${durationStr}`))
+  }
+
+  /**
+   * Format duration in human-readable form
+   */
+  private formatDuration(ms: number): string {
+    if (ms < 1000) return `${ms}ms`
+    const seconds = (ms / 1000).toFixed(1)
+    return `${seconds}s`
+  }
+}
+
+// Singleton instance
+export const agentStream = new AgentStream()
+
+export default agentStream

package/core/utils/branding.ts

@@ -65,9 +65,8 @@ const branding: Branding = {
     footer: '⚡ prjct'
   },
 
-  // Default Git commit footer (Claude - for backward compatibility)
-  commitFooter: `🤖 Generated with [p/](https://www.prjct.app/)
-Designed for [Claude](https://www.anthropic.com/claude)`,
+  // Default Git commit footer (generic)
+  commitFooter: `Generated with [p/](https://www.prjct.app/)`,
 
   // URLs
   urls: {

package/core/utils/next-steps.ts

@@ -0,0 +1,95 @@
+/**
+ * Next Steps - Show explicit guidance after each command
+ *
+ * Uses the workflow state machine to show valid commands
+ * for the current state.
+ */
+
+import chalk from 'chalk'
+import { workflowStateMachine, type WorkflowState } from '../workflow/state-machine'
+
+interface NextStep {
+  cmd: string
+  desc: string
+}
+
+/**
+ * Command descriptions for display
+ */
+const CMD_DESCRIPTIONS: Record<string, string> = {
+  task: 'Start new task',
+  done: 'Complete current task',
+  pause: 'Pause and switch context',
+  resume: 'Continue paused task',
+  ship: 'Ship the feature',
+  next: 'View task queue',
+  sync: 'Analyze project',
+  bug: 'Report a bug',
+  idea: 'Capture an idea',
+}
+
+/**
+ * Map command to resulting workflow state
+ */
+const COMMAND_TO_STATE: Record<string, WorkflowState> = {
+  task: 'working',
+  done: 'completed',
+  'done-subtask': 'working', // Still working on subtasks
+  pause: 'paused',
+  resume: 'working',
+  ship: 'shipped',
+  next: 'idle',
+  sync: 'idle',
+  init: 'idle',
+  bug: 'working',
+  idea: 'idle',
+}
+
+/**
+ * Show next steps after a command
+ */
+export function showNextSteps(command: string, options: { quiet?: boolean } = {}): void {
+  if (options.quiet) return
+
+  // Get the state after this command
+  const resultingState = COMMAND_TO_STATE[command] || 'idle'
+
+  // Get valid commands for that state
+  const validCommands = workflowStateMachine.getValidCommands(resultingState)
+
+  if (validCommands.length === 0) return
+
+  const steps: NextStep[] = validCommands.map(cmd => ({
+    cmd: `p. ${cmd}`,
+    desc: CMD_DESCRIPTIONS[cmd] || cmd,
+  }))
+
+  console.log(chalk.dim('\nNext:'))
+  for (const step of steps) {
+    const cmd = chalk.cyan(step.cmd.padEnd(12))
+    console.log(chalk.dim(`  ${cmd} → ${step.desc}`))
+  }
+}
+
+/**
+ * Get next steps for a command (for programmatic use)
+ */
+export function getNextSteps(command: string): NextStep[] {
+  const resultingState = COMMAND_TO_STATE[command] || 'idle'
+  const validCommands = workflowStateMachine.getValidCommands(resultingState)
+
+  return validCommands.map(cmd => ({
+    cmd: `p. ${cmd}`,
+    desc: CMD_DESCRIPTIONS[cmd] || cmd,
+  }))
+}
+
+/**
+ * Show current state info
+ */
+export function showStateInfo(state: WorkflowState): void {
+  const info = workflowStateMachine.getStateInfo(state)
+  console.log(chalk.dim(`📍 State: ${chalk.white(state.toUpperCase())} - ${info.description}`))
+}
+
+export default { showNextSteps, getNextSteps, showStateInfo }

package/core/utils/output.ts

@@ -26,6 +26,8 @@ interface Output {
   fail(msg: string): Output
   warn(msg: string): Output
   stop(): Output
+  step(current: number, total: number, msg: string): Output
+  progress(current: number, total: number, msg?: string): Output
 }
 
 const out: Output = {
@@ -75,6 +77,30 @@ const out: Output = {
       clear()
     }
     return this
+  },
+
+  // Step counter: [3/7] Running tests...
+  step(current: number, total: number, msg: string) {
+    this.stop()
+    const counter = chalk.dim(`[${current}/${total}]`)
+    interval = setInterval(() => {
+      process.stdout.write(`\r${branding.cli.spin(frame++, `${counter} ${truncate(msg, 35)}`)}`)
+    }, SPEED)
+    return this
+  },
+
+  // Progress bar: [████░░░░] 50% Analyzing...
+  progress(current: number, total: number, msg?: string) {
+    this.stop()
+    const percent = Math.round((current / total) * 100)
+    const filled = Math.round(percent / 10)
+    const empty = 10 - filled
+    const bar = chalk.cyan('█'.repeat(filled)) + chalk.dim('░'.repeat(empty))
+    const text = msg ? ` ${truncate(msg, 25)}` : ''
+    interval = setInterval(() => {
+      process.stdout.write(`\r${branding.cli.spin(frame++, `[${bar}] ${percent}%${text}`)}`)
+    }, SPEED)
+    return this
   }
 }
 

package/core/workflow/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Workflow Module
+ * State machine and transition management for prjct workflow.
+ */
+
+export * from './state-machine'

package/core/workflow/state-machine.ts

@@ -0,0 +1,185 @@
+/**
+ * Workflow State Machine
+ * Explicit states with valid transitions for prjct workflow.
+ *
+ * States: idle → working → completed → shipped
+ *         ↓↑
+ *       paused
+ */
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export type WorkflowState = 'idle' | 'working' | 'paused' | 'completed' | 'shipped'
+
+export type WorkflowCommand = 'task' | 'done' | 'pause' | 'resume' | 'ship' | 'next'
+
+interface StateDefinition {
+  transitions: WorkflowCommand[]
+  prompt: string
+  description: string
+}
+
+interface TransitionResult {
+  valid: boolean
+  error?: string
+  suggestion?: string
+}
+
+// =============================================================================
+// State Definitions
+// =============================================================================
+
+const WORKFLOW_STATES: Record<WorkflowState, StateDefinition> = {
+  idle: {
+    transitions: ['task', 'next'],
+    prompt: "p. task <description>  Start working",
+    description: 'No active task',
+  },
+  working: {
+    transitions: ['done', 'pause'],
+    prompt: "p. done  Complete task  |  p. pause  Switch context",
+    description: 'Task in progress',
+  },
+  paused: {
+    transitions: ['resume', 'task'],
+    prompt: "p. resume  Continue  |  p. task <new>  Start different",
+    description: 'Task paused',
+  },
+  completed: {
+    transitions: ['ship', 'task', 'next'],
+    prompt: "p. ship  Ship it  |  p. task <next>  Start next",
+    description: 'Task completed',
+  },
+  shipped: {
+    transitions: ['task', 'next'],
+    prompt: "p. task <description>  Start new task",
+    description: 'Feature shipped',
+  },
+}
+
+// =============================================================================
+// State Machine
+// =============================================================================
+
+export class WorkflowStateMachine {
+  /**
+   * Get current state from storage state
+   */
+  getCurrentState(storageState: { currentTask?: { status?: string } | null }): WorkflowState {
+    const task = storageState?.currentTask
+
+    if (!task) {
+      return 'idle'
+    }
+
+    const status = task.status?.toLowerCase()
+
+    switch (status) {
+      case 'in_progress':
+      case 'working':
+        return 'working'
+      case 'paused':
+        return 'paused'
+      case 'completed':
+      case 'done':
+        return 'completed'
+      case 'shipped':
+        return 'shipped'
+      default:
+        return task ? 'working' : 'idle'
+    }
+  }
+
+  /**
+   * Check if a command is valid for the current state
+   */
+  canTransition(currentState: WorkflowState, command: WorkflowCommand): TransitionResult {
+    const stateConfig = WORKFLOW_STATES[currentState]
+
+    if (stateConfig.transitions.includes(command)) {
+      return { valid: true }
+    }
+
+    // Build helpful error message
+    const validCommands = stateConfig.transitions.map(c => `p. ${c}`).join(', ')
+
+    return {
+      valid: false,
+      error: `Cannot run 'p. ${command}' in ${currentState} state`,
+      suggestion: `Valid commands: ${validCommands}`,
+    }
+  }
+
+  /**
+   * Get the next state after a command
+   */
+  getNextState(currentState: WorkflowState, command: WorkflowCommand): WorkflowState {
+    switch (command) {
+      case 'task':
+        return 'working'
+      case 'done':
+        return 'completed'
+      case 'pause':
+        return 'paused'
+      case 'resume':
+        return 'working'
+      case 'ship':
+        return 'shipped'
+      case 'next':
+        return currentState // next doesn't change state
+      default:
+        return currentState
+    }
+  }
+
+  /**
+   * Get state definition
+   */
+  getStateInfo(state: WorkflowState): StateDefinition {
+    return WORKFLOW_STATES[state]
+  }
+
+  /**
+   * Get prompt for current state
+   */
+  getPrompt(state: WorkflowState): string {
+    return WORKFLOW_STATES[state].prompt
+  }
+
+  /**
+   * Get valid commands for current state
+   */
+  getValidCommands(state: WorkflowState): WorkflowCommand[] {
+    return WORKFLOW_STATES[state].transitions
+  }
+
+  /**
+   * Format next steps for display
+   */
+  formatNextSteps(state: WorkflowState): string[] {
+    const stateConfig = WORKFLOW_STATES[state]
+    return stateConfig.transitions.map(cmd => {
+      switch (cmd) {
+        case 'task':
+          return 'p. task <desc>  Start new task'
+        case 'done':
+          return 'p. done         Complete current task'
+        case 'pause':
+          return 'p. pause        Pause and switch context'
+        case 'resume':
+          return 'p. resume       Continue paused task'
+        case 'ship':
+          return 'p. ship         Ship the feature'
+        case 'next':
+          return 'p. next         View task queue'
+        default:
+          return `p. ${cmd}`
+      }
+    })
+  }
+}
+
+// Singleton
+export const workflowStateMachine = new WorkflowStateMachine()