prjct-cli 0.45.0 → 0.45.4

package/core/wizard/onboarding.ts

@@ -0,0 +1,633 @@
+/**
+ * OnboardingWizard - Interactive first-run setup experience
+ *
+ * Guides new users through project setup in ~60 seconds:
+ * 1. Project type detection + confirmation
+ * 2. AI agent selection (multi-select)
+ * 3. Stack confirmation
+ * 4. Preferences collection
+ * 5. Generation + summary
+ */
+
+import chalk from 'chalk'
+import prompts from 'prompts'
+import out from '../utils/output'
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type ProjectType =
+  | 'web-app'
+  | 'api-backend'
+  | 'fullstack'
+  | 'cli-tool'
+  | 'library'
+  | 'monorepo'
+  | 'unknown'
+
+export type AIAgent = 'claude' | 'cursor' | 'windsurf' | 'copilot' | 'gemini'
+
+export interface DetectedStack {
+  language: string
+  framework?: string
+  runtime?: string
+  packageManager?: string
+  technologies: string[]
+}
+
+export interface WizardPreferences {
+  verbosity: 'minimal' | 'normal' | 'verbose'
+  autoSync: boolean
+  telemetry: boolean
+}
+
+export interface WizardResult {
+  projectType: ProjectType
+  agents: AIAgent[]
+  stack: DetectedStack
+  preferences: WizardPreferences
+  skipped: boolean
+}
+
+export interface WizardStep {
+  id: string
+  title: string
+  run: () => Promise<boolean> // Returns true if should continue, false to abort
+}
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+const PROJECT_TYPES: { value: ProjectType; title: string; description: string }[] = [
+  { value: 'web-app', title: 'Web Application', description: 'React, Vue, Angular, Next.js, etc.' },
+  {
+    value: 'api-backend',
+    title: 'API / Backend Service',
+    description: 'Express, Hono, FastAPI, etc.',
+  },
+  {
+    value: 'fullstack',
+    title: 'Full-Stack (Monorepo)',
+    description: 'Frontend + Backend in one repo',
+  },
+  { value: 'cli-tool', title: 'CLI Tool', description: 'Command-line application' },
+  { value: 'library', title: 'Library / Package', description: 'Reusable npm/pip/cargo package' },
+  {
+    value: 'monorepo',
+    title: 'Monorepo (Multiple Projects)',
+    description: 'Turborepo, Nx, Lerna, etc.',
+  },
+]
+
+const AI_AGENTS: { value: AIAgent; title: string; description: string }[] = [
+  { value: 'claude', title: 'Claude Code', description: "Anthropic's Claude in VS Code/CLI" },
+  { value: 'cursor', title: 'Cursor', description: 'AI-first code editor' },
+  { value: 'windsurf', title: 'Windsurf', description: "Codeium's AI IDE" },
+  { value: 'copilot', title: 'GitHub Copilot', description: "GitHub's AI pair programmer" },
+  { value: 'gemini', title: 'Gemini CLI', description: "Google's Gemini in terminal" },
+]
+
+// ============================================================================
+// OnboardingWizard Class
+// ============================================================================
+
+export class OnboardingWizard {
+  private projectPath: string
+  private currentStep: number = 0
+  private totalSteps: number = 5
+  private aborted: boolean = false
+
+  // Collected data
+  private detectedType: ProjectType = 'unknown'
+  private confirmedType: ProjectType = 'unknown'
+  private selectedAgents: AIAgent[] = []
+  private detectedStack: DetectedStack = { language: 'Unknown', technologies: [] }
+  private confirmedStack: DetectedStack = { language: 'Unknown', technologies: [] }
+  private preferences: WizardPreferences = {
+    verbosity: 'normal',
+    autoSync: true,
+    telemetry: false,
+  }
+
+  constructor(projectPath: string = process.cwd()) {
+    this.projectPath = projectPath
+
+    // Handle Ctrl+C gracefully
+    prompts.override({})
+  }
+
+  // ==========================================================================
+  // Public API
+  // ==========================================================================
+
+  /**
+   * Run the full wizard flow
+   */
+  async run(): Promise<WizardResult> {
+    this.printWelcome()
+
+    const steps: WizardStep[] = [
+      { id: 'project-type', title: 'Project Type', run: () => this.stepProjectType() },
+      { id: 'ai-agents', title: 'AI Agents', run: () => this.stepAIAgents() },
+      { id: 'stack', title: 'Stack Confirmation', run: () => this.stepStack() },
+      { id: 'preferences', title: 'Preferences', run: () => this.stepPreferences() },
+      { id: 'summary', title: 'Summary', run: () => this.stepSummary() },
+    ]
+
+    for (const step of steps) {
+      this.currentStep++
+      this.printStepHeader(step.title)
+
+      const shouldContinue = await step.run()
+
+      if (!shouldContinue || this.aborted) {
+        return this.buildResult(true)
+      }
+    }
+
+    return this.buildResult(false)
+  }
+
+  /**
+   * Run in non-interactive mode (--yes flag)
+   * Uses all auto-detected values without prompting
+   */
+  async runNonInteractive(): Promise<WizardResult> {
+    out.spin('Auto-detecting project configuration...')
+
+    // Auto-detect everything
+    this.detectedType = await this.detectProjectType()
+    this.confirmedType = this.detectedType
+    this.selectedAgents = ['claude'] // Default to Claude
+    this.detectedStack = await this.detectStack()
+    this.confirmedStack = this.detectedStack
+    // Use default preferences
+
+    out.done('Configuration detected')
+
+    return this.buildResult(false)
+  }
+
+  // ==========================================================================
+  // Step Implementations
+  // ==========================================================================
+
+  /**
+   * Step 1: Project Type Detection + Confirmation
+   */
+  private async stepProjectType(): Promise<boolean> {
+    this.detectedType = await this.detectProjectType()
+
+    const response = await prompts(
+      {
+        type: 'select',
+        name: 'projectType',
+        message:
+          this.detectedType !== 'unknown'
+            ? `Detected: ${this.getProjectTypeLabel(this.detectedType)}. Is this correct?`
+            : 'What type of project is this?',
+        choices: PROJECT_TYPES.map((pt) => ({
+          title: pt.title,
+          description: pt.description,
+          value: pt.value,
+          selected: pt.value === this.detectedType,
+        })),
+        initial: PROJECT_TYPES.findIndex((pt) => pt.value === this.detectedType),
+      },
+      { onCancel: () => this.handleCancel() }
+    )
+
+    if (this.aborted) return false
+
+    this.confirmedType = response.projectType || this.detectedType
+    return true
+  }
+
+  /**
+   * Step 2: AI Agent Selection (multi-select)
+   */
+  private async stepAIAgents(): Promise<boolean> {
+    const detectedAgents = await this.detectInstalledAgents()
+
+    const response = await prompts(
+      {
+        type: 'multiselect',
+        name: 'agents',
+        message: 'Which AI agents do you use?',
+        choices: AI_AGENTS.map((agent) => ({
+          title: agent.title,
+          description: agent.description,
+          value: agent.value,
+          selected: detectedAgents.includes(agent.value),
+        })),
+        hint: '- Space to select, Enter to confirm',
+        instructions: false,
+        min: 1,
+      },
+      { onCancel: () => this.handleCancel() }
+    )
+
+    if (this.aborted) return false
+
+    this.selectedAgents = response.agents || ['claude']
+    return true
+  }
+
+  /**
+   * Step 3: Stack Detection + Confirmation
+   */
+  private async stepStack(): Promise<boolean> {
+    this.detectedStack = await this.detectStack()
+
+    const stackDisplay = this.formatStackDisplay(this.detectedStack)
+    console.log(chalk.dim(`\n  Detected: ${stackDisplay}\n`))
+
+    const response = await prompts(
+      {
+        type: 'confirm',
+        name: 'confirmed',
+        message: 'Is this stack correct?',
+        initial: true,
+      },
+      { onCancel: () => this.handleCancel() }
+    )
+
+    if (this.aborted) return false
+
+    if (response.confirmed) {
+      this.confirmedStack = this.detectedStack
+    } else {
+      // Allow manual override
+      const manualResponse = await prompts(
+        [
+          {
+            type: 'text',
+            name: 'language',
+            message: 'Primary language:',
+            initial: this.detectedStack.language,
+          },
+          {
+            type: 'text',
+            name: 'framework',
+            message: 'Framework (optional):',
+            initial: this.detectedStack.framework || '',
+          },
+        ],
+        { onCancel: () => this.handleCancel() }
+      )
+
+      if (this.aborted) return false
+
+      this.confirmedStack = {
+        ...this.detectedStack,
+        language: manualResponse.language || this.detectedStack.language,
+        framework: manualResponse.framework || undefined,
+      }
+    }
+
+    return true
+  }
+
+  /**
+   * Step 4: Preferences Collection
+   */
+  private async stepPreferences(): Promise<boolean> {
+    const response = await prompts(
+      [
+        {
+          type: 'select',
+          name: 'verbosity',
+          message: 'Output verbosity:',
+          choices: [
+            { title: 'Minimal', description: 'Essential output only', value: 'minimal' },
+            { title: 'Normal (Recommended)', description: 'Balanced information', value: 'normal' },
+            { title: 'Verbose', description: 'Detailed logging', value: 'verbose' },
+          ],
+          initial: 1,
+        },
+        {
+          type: 'confirm',
+          name: 'autoSync',
+          message: 'Auto-sync context on file changes?',
+          initial: true,
+        },
+      ],
+      { onCancel: () => this.handleCancel() }
+    )
+
+    if (this.aborted) return false
+
+    this.preferences = {
+      verbosity: response.verbosity || 'normal',
+      autoSync: response.autoSync ?? true,
+      telemetry: false, // Default off, can be enabled later
+    }
+
+    return true
+  }
+
+  /**
+   * Step 5: Summary + Generation
+   */
+  private async stepSummary(): Promise<boolean> {
+    console.log('')
+    console.log(chalk.bold('  Configuration Summary'))
+    console.log(chalk.dim(`  ${'─'.repeat(40)}`))
+    console.log(`  ${chalk.cyan('Project Type:')} ${this.getProjectTypeLabel(this.confirmedType)}`)
+    console.log(
+      `  ${chalk.cyan('AI Agents:')} ${this.selectedAgents.map((a) => this.getAgentLabel(a)).join(', ')}`
+    )
+    console.log(`  ${chalk.cyan('Stack:')} ${this.formatStackDisplay(this.confirmedStack)}`)
+    console.log(`  ${chalk.cyan('Verbosity:')} ${this.preferences.verbosity}`)
+    console.log(`  ${chalk.cyan('Auto-sync:')} ${this.preferences.autoSync ? 'Yes' : 'No'}`)
+    console.log('')
+
+    const response = await prompts(
+      {
+        type: 'confirm',
+        name: 'proceed',
+        message: 'Generate configuration with these settings?',
+        initial: true,
+      },
+      { onCancel: () => this.handleCancel() }
+    )
+
+    if (this.aborted || !response.proceed) {
+      return false
+    }
+
+    return true
+  }
+
+  // ==========================================================================
+  // Detection Methods
+  // ==========================================================================
+
+  /**
+   * Detect project type from file system
+   */
+  async detectProjectType(): Promise<ProjectType> {
+    const fs = await import('node:fs/promises')
+    const path = await import('node:path')
+
+    try {
+      const files = await fs.readdir(this.projectPath)
+
+      // Check for monorepo indicators
+      if (
+        files.includes('turbo.json') ||
+        files.includes('lerna.json') ||
+        files.includes('nx.json')
+      ) {
+        return 'monorepo'
+      }
+
+      // Check for package.json
+      if (files.includes('package.json')) {
+        const pkgPath = path.join(this.projectPath, 'package.json')
+        const pkgContent = await fs.readFile(pkgPath, 'utf-8')
+        const pkg = JSON.parse(pkgContent)
+
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies }
+
+        // CLI tool indicators
+        if (pkg.bin) return 'cli-tool'
+
+        // Library indicators
+        if (pkg.main && !deps.react && !deps.vue && !deps.angular && !deps.express && !deps.hono) {
+          return 'library'
+        }
+
+        // Full-stack indicators
+        if ((deps.react || deps.vue) && (deps.express || deps.hono || deps.fastify)) {
+          return 'fullstack'
+        }
+
+        // Frontend indicators
+        if (deps.react || deps.vue || deps['@angular/core'] || deps.next || deps.nuxt) {
+          return 'web-app'
+        }
+
+        // Backend indicators
+        if (deps.express || deps.hono || deps.fastify || deps.koa || deps.nestjs) {
+          return 'api-backend'
+        }
+      }
+
+      // Python project detection
+      if (files.includes('pyproject.toml') || files.includes('setup.py')) {
+        const hasServer = files.some((f) => ['main.py', 'app.py', 'server.py'].includes(f))
+        return hasServer ? 'api-backend' : 'library'
+      }
+
+      // Go project detection
+      if (files.includes('go.mod')) {
+        return files.includes('main.go') ? 'cli-tool' : 'library'
+      }
+
+      // Rust project detection
+      if (files.includes('Cargo.toml')) {
+        return 'cli-tool' // Most Rust CLIs
+      }
+
+      return 'unknown'
+    } catch {
+      return 'unknown'
+    }
+  }
+
+  /**
+   * Detect installed AI agents from config files
+   */
+  async detectInstalledAgents(): Promise<AIAgent[]> {
+    const fs = await import('node:fs/promises')
+    const path = await import('node:path')
+    const os = await import('node:os')
+
+    const agents: AIAgent[] = []
+
+    // Claude Code: Check ~/.claude directory
+    try {
+      await fs.access(path.join(os.homedir(), '.claude'))
+      agents.push('claude')
+    } catch {
+      /* not installed */
+    }
+
+    // Cursor: Check for .cursorrules in project
+    try {
+      await fs.access(path.join(this.projectPath, '.cursorrules'))
+      agents.push('cursor')
+    } catch {
+      /* not installed */
+    }
+
+    // Windsurf: Check for .windsurfrules
+    try {
+      await fs.access(path.join(this.projectPath, '.windsurfrules'))
+      agents.push('windsurf')
+    } catch {
+      /* not installed */
+    }
+
+    // Copilot: Check for .github/copilot-instructions.md
+    try {
+      await fs.access(path.join(this.projectPath, '.github', 'copilot-instructions.md'))
+      agents.push('copilot')
+    } catch {
+      /* not installed */
+    }
+
+    // Gemini: Check ~/.gemini
+    try {
+      await fs.access(path.join(os.homedir(), '.gemini'))
+      agents.push('gemini')
+    } catch {
+      /* not installed */
+    }
+
+    // Default to Claude if nothing detected
+    return agents.length > 0 ? agents : ['claude']
+  }
+
+  /**
+   * Detect tech stack from project files
+   */
+  async detectStack(): Promise<DetectedStack> {
+    const fs = await import('node:fs/promises')
+    const path = await import('node:path')
+
+    const stack: DetectedStack = {
+      language: 'Unknown',
+      technologies: [],
+    }
+
+    try {
+      const files = await fs.readdir(this.projectPath)
+
+      // Language detection
+      if (files.includes('package.json')) {
+        const pkgPath = path.join(this.projectPath, 'package.json')
+        const pkgContent = await fs.readFile(pkgPath, 'utf-8')
+        const pkg = JSON.parse(pkgContent)
+
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies }
+
+        // TypeScript check
+        stack.language = deps.typescript ? 'TypeScript' : 'JavaScript'
+
+        // Framework detection
+        if (deps.next) stack.framework = 'Next.js'
+        else if (deps.nuxt) stack.framework = 'Nuxt'
+        else if (deps.react) stack.framework = 'React'
+        else if (deps.vue) stack.framework = 'Vue'
+        else if (deps['@angular/core']) stack.framework = 'Angular'
+        else if (deps.express) stack.framework = 'Express'
+        else if (deps.hono) stack.framework = 'Hono'
+        else if (deps.fastify) stack.framework = 'Fastify'
+        else if (deps.nestjs || deps['@nestjs/core']) stack.framework = 'NestJS'
+
+        // Runtime detection
+        if (deps.bun || deps['@types/bun']) stack.runtime = 'Bun'
+        else if (pkg.engines?.bun) stack.runtime = 'Bun'
+        else stack.runtime = 'Node.js'
+
+        // Package manager detection
+        if (files.includes('bun.lockb')) stack.packageManager = 'Bun'
+        else if (files.includes('pnpm-lock.yaml')) stack.packageManager = 'pnpm'
+        else if (files.includes('yarn.lock')) stack.packageManager = 'Yarn'
+        else if (files.includes('package-lock.json')) stack.packageManager = 'npm'
+
+        // Additional technologies
+        if (deps.prisma || deps['@prisma/client']) stack.technologies.push('Prisma')
+        if (deps.drizzle || deps['drizzle-orm']) stack.technologies.push('Drizzle')
+        if (deps.tailwindcss) stack.technologies.push('Tailwind CSS')
+        if (deps.zod) stack.technologies.push('Zod')
+        if (deps.trpc || deps['@trpc/server']) stack.technologies.push('tRPC')
+      } else if (files.includes('pyproject.toml') || files.includes('requirements.txt')) {
+        stack.language = 'Python'
+        // Could parse pyproject.toml for framework detection
+      } else if (files.includes('go.mod')) {
+        stack.language = 'Go'
+      } else if (files.includes('Cargo.toml')) {
+        stack.language = 'Rust'
+      } else if (files.includes('pom.xml') || files.includes('build.gradle')) {
+        stack.language = 'Java'
+      }
+
+      return stack
+    } catch {
+      return stack
+    }
+  }
+
+  // ==========================================================================
+  // Helper Methods
+  // ==========================================================================
+
+  private printWelcome(): void {
+    console.log('')
+    console.log(chalk.bold.cyan('  Welcome to prjct-cli!'))
+    console.log(chalk.dim("  Let's set up your project in 60 seconds."))
+    console.log('')
+  }
+
+  private printStepHeader(title: string): void {
+    console.log('')
+    console.log(chalk.dim(`  Step ${this.currentStep}/${this.totalSteps}: ${title}`))
+    console.log('')
+  }
+
+  private handleCancel(): void {
+    this.aborted = true
+    console.log(chalk.yellow('\n  Setup cancelled. Run again anytime.\n'))
+  }
+
+  private getProjectTypeLabel(type: ProjectType): string {
+    return PROJECT_TYPES.find((pt) => pt.value === type)?.title || 'Unknown'
+  }
+
+  private getAgentLabel(agent: AIAgent): string {
+    return AI_AGENTS.find((a) => a.value === agent)?.title || agent
+  }
+
+  private formatStackDisplay(stack: DetectedStack): string {
+    const parts = [stack.language]
+    if (stack.framework) parts.push(stack.framework)
+    if (stack.runtime && stack.runtime !== 'Node.js') parts.push(stack.runtime)
+    if (stack.technologies.length > 0) {
+      parts.push(`+ ${stack.technologies.slice(0, 3).join(', ')}`)
+    }
+    return parts.join(' / ')
+  }
+
+  private buildResult(skipped: boolean): WizardResult {
+    return {
+      projectType: this.confirmedType,
+      agents: this.selectedAgents,
+      stack: this.confirmedStack,
+      preferences: this.preferences,
+      skipped,
+    }
+  }
+
+  // ==========================================================================
+  // Getters for external access
+  // ==========================================================================
+
+  getSelectedAgents(): AIAgent[] {
+    return this.selectedAgents
+  }
+
+  getConfirmedStack(): DetectedStack {
+    return this.confirmedStack
+  }
+
+  getPreferences(): WizardPreferences {
+    return this.preferences
+  }
+}
+
+export default OnboardingWizard

package/core/workflow/state-machine.ts

@@ -34,27 +34,27 @@ interface TransitionResult {
 const WORKFLOW_STATES: Record<WorkflowState, StateDefinition> = {
   idle: {
     transitions: ['task', 'next'],
-    prompt: "p. task <description>  Start working",
+    prompt: 'p. task <description>  Start working',
     description: 'No active task',
   },
   working: {
     transitions: ['done', 'pause'],
-    prompt: "p. done  Complete task  |  p. pause  Switch context",
+    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",
+    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",
+    prompt: 'p. ship  Ship it  |  p. task <next>  Start next',
     description: 'Task completed',
   },
   shipped: {
     transitions: ['task', 'next'],
-    prompt: "p. task <description>  Start new task",
+    prompt: 'p. task <description>  Start new task',
     description: 'Feature shipped',
   },
 }
@@ -103,7 +103,7 @@ export class WorkflowStateMachine {
     }
 
     // Build helpful error message
-    const validCommands = stateConfig.transitions.map(c => `p. ${c}`).join(', ')
+    const validCommands = stateConfig.transitions.map((c) => `p. ${c}`).join(', ')
 
     return {
       valid: false,
@@ -160,7 +160,7 @@ export class WorkflowStateMachine {
    */
   formatNextSteps(state: WorkflowState): string[] {
     const stateConfig = WORKFLOW_STATES[state]
-    return stateConfig.transitions.map(cmd => {
+    return stateConfig.transitions.map((cmd) => {
       switch (cmd) {
         case 'task':
           return 'p. task <desc>  Start new task'