prjct-cli 1.22.0 → 1.23.0

package/core/commands/setup.ts

@@ -1,280 +0,0 @@
-/**
- * Setup Commands: start, setup, installStatusLine, showAsciiArt
- */
-
-import fs from 'node:fs/promises'
-import path from 'node:path'
-import chalk from 'chalk'
-import commandInstaller from '../infrastructure/command-installer'
-import pathManager from '../infrastructure/path-manager'
-import type { CommandResult, SetupOptions } from '../types'
-import { getErrorMessage } from '../types/fs'
-import { fileExists } from '../utils/fs-helpers'
-import { VERSION } from '../utils/version'
-import { PrjctCommandsBase } from './base'
-
-export class SetupCommands extends PrjctCommandsBase {
-  /**
-   * First-time setup - Install commands to editors
-   */
-  async start(): Promise<CommandResult> {
-    const aiProvider = require('../infrastructure/ai-provider')
-    const activeProvider = await aiProvider.getActiveProvider()
-
-    console.log(`🚀 Setting up prjct for ${activeProvider.displayName}...\n`)
-
-    const status = await commandInstaller.checkInstallation()
-
-    if (!status.claudeDetected) {
-      // Note: variable name is legacy, checks active provider
-      return {
-        success: false,
-        message:
-          `❌ ${activeProvider.displayName} not detected.\n\nPlease install it first:\n` +
-          `  - ${activeProvider.displayName}: ${activeProvider.docsUrl}`,
-      }
-    }
-
-    console.log('📦 Installing /p:* commands...')
-    const result = await commandInstaller.installCommands()
-
-    if (!result.success) {
-      return {
-        success: false,
-        message: `❌ Installation failed: ${result.error}`,
-      }
-    }
-
-    console.log(
-      `\n✅ Installed ${result.installed?.length ?? 0} commands to:\n   ${pathManager.getDisplayPath(result.path || '')}`
-    )
-
-    if ((result.errors?.length ?? 0) > 0) {
-      console.log(`\n⚠️  ${result.errors?.length ?? 0} errors:`)
-      for (const e of result.errors ?? []) {
-        console.log(`   - ${e.file}: ${e.error}`)
-      }
-    }
-
-    console.log('\n🎉 Setup complete!')
-    console.log('\nNext steps:')
-    console.log(`  1. Open ${activeProvider.displayName}`)
-    console.log('  2. Navigate to your project')
-    console.log('  3. Run: /p:init') // This might need adjustment for Gemini (p init) but /p:init is likely fine for now or we can make it dynamic
-
-    return {
-      success: true,
-      message: '',
-    }
-  }
-
-  /**
-   * Reconfigure editor installations
-   */
-  async setup(options: SetupOptions = {}): Promise<CommandResult> {
-    console.log('🔧 Reconfiguring prjct...\n')
-
-    if (options.force) {
-      console.log('🗑️  Removing existing installation...')
-      await commandInstaller.uninstallCommands()
-    }
-
-    console.log('📦 Installing /p:* commands...')
-    const result = await commandInstaller.updateCommands()
-
-    if (!result.success) {
-      return {
-        success: false,
-        message: `❌ Setup failed: ${result.error}`,
-      }
-    }
-
-    console.log(`\n✅ Installed ${result.installed?.length ?? 0} commands`)
-
-    if ((result.errors?.length ?? 0) > 0) {
-      console.log(`\n⚠️  ${result.errors?.length ?? 0} errors:`)
-      for (const e of result.errors ?? []) {
-        console.log(`   - ${e.file}: ${e.error}`)
-      }
-    }
-
-    console.log('\n📝 Installing global configuration...')
-    const configResult = await commandInstaller.installGlobalConfig()
-    const displayPath = configResult.path
-      ? pathManager.getDisplayPath(configResult.path)
-      : 'global config'
-
-    if (configResult.success) {
-      if (configResult.action === 'created') {
-        console.log(`✅ Created ${displayPath}`)
-      } else if (configResult.action === 'updated') {
-        console.log(`✅ Updated ${displayPath}`)
-      } else if (configResult.action === 'appended') {
-        console.log(`✅ Added prjct config to ${displayPath}`)
-      }
-    } else {
-      console.log(`⚠️  ${configResult.error}`)
-    }
-
-    const aiProvider = require('../infrastructure/ai-provider')
-    const activeProvider = await aiProvider.getActiveProvider()
-
-    // Status line is currently Claude-only
-    if (activeProvider.name === 'claude') {
-      console.log('\n⚡ Installing status line...')
-      const statusLineResult = await this.installStatusLine()
-      if (statusLineResult.success) {
-        console.log('✅ Status line configured')
-      } else {
-        console.log(`⚠️  ${statusLineResult.error}`)
-      }
-    }
-
-    console.log('\n🎉 Setup complete!\n')
-
-    this.showAsciiArt()
-
-    return {
-      success: true,
-      message: '',
-    }
-  }
-
-  /**
-   * Install status line script and configure settings.json
-   */
-  async installStatusLine(): Promise<{ success: boolean; error?: string }> {
-    try {
-      // Note: This method is currently Claude-specific
-      const claudeDir = pathManager.getClaudeDir()
-      const settingsPath = pathManager.getClaudeSettingsPath()
-      const statusLinePath = path.join(claudeDir, 'prjct-statusline.sh')
-
-      // Version is embedded at install time
-      const scriptContent = `#!/bin/bash
-# prjct Status Line for Claude Code
-# Shows version update notifications and current task
-
-# Current CLI version (embedded at install time)
-CLI_VERSION="${VERSION}"
-
-# Read JSON context from stdin (provided by Claude Code)
-read -r json
-
-# Extract cwd from JSON
-CWD=$(echo "$json" | grep -o '"cwd"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"cwd"[[:space:]]*:[[:space:]]*"\\([^"]*\\)".*/\\1/')
-
-# Check if this is a prjct project
-CONFIG="$CWD/.prjct/prjct.config.json"
-if [[ -f "$CONFIG" ]]; then
-  # Extract projectId
-  PROJECT_ID=$(grep -o '"projectId"[[:space:]]*:[[:space:]]*"[^"]*"' "$CONFIG" | sed 's/.*"projectId"[[:space:]]*:[[:space:]]*"\\([^"]*\\)".*/\\1/')
-
-  if [[ -n "$PROJECT_ID" ]]; then
-    PROJECT_JSON="$HOME/.prjct-cli/projects/$PROJECT_ID/project.json"
-
-    # Check version mismatch
-    if [[ -f "$PROJECT_JSON" ]]; then
-      PROJECT_VERSION=$(grep -o '"cliVersion"[[:space:]]*:[[:space:]]*"[^"]*"' "$PROJECT_JSON" | sed 's/.*"cliVersion"[[:space:]]*:[[:space:]]*"\\([^"]*\\)".*/\\1/')
-
-      # If no cliVersion or different version, show update notice
-      if [[ -z "$PROJECT_VERSION" ]] || [[ "$PROJECT_VERSION" != "$CLI_VERSION" ]]; then
-        echo "⚠️ prjct v$CLI_VERSION available! Run /p:sync"
-        exit 0
-      fi
-    else
-      # No project.json means project needs sync
-      echo "⚠️ prjct v$CLI_VERSION available! Run /p:sync"
-      exit 0
-    fi
-
-    # Show current task if exists
-    STATE="$HOME/.prjct-cli/projects/$PROJECT_ID/storage/state.json"
-    if [[ -f "$STATE" ]]; then
-      TASK=$(grep -o '"description"[[:space:]]*:[[:space:]]*"[^"]*"' "$STATE" | head -1 | sed 's/.*"description"[[:space:]]*:[[:space:]]*"\\([^"]*\\)".*/\\1/')
-      STATUS=$(grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' "$STATE" | head -1 | sed 's/.*"status"[[:space:]]*:[[:space:]]*"\\([^"]*\\)".*/\\1/')
-
-      if [[ -n "$TASK" ]] && [[ "$STATUS" == "active" ]]; then
-        # Truncate task to 40 chars
-        TASK_SHORT="\${TASK:0:40}"
-        [[ \${#TASK} -gt 40 ]] && TASK_SHORT="$TASK_SHORT..."
-        echo "🎯 $TASK_SHORT"
-        exit 0
-      fi
-    fi
-  fi
-fi
-
-# Default: show prjct branding
-echo "⚡ prjct"
-`
-      await fs.writeFile(statusLinePath, scriptContent, { mode: 0o755 })
-
-      let settings: Record<string, unknown> = {}
-      if (await fileExists(settingsPath)) {
-        try {
-          settings = JSON.parse(await fs.readFile(settingsPath, 'utf8'))
-        } catch (_error) {
-          // Invalid JSON, start fresh
-        }
-      }
-
-      settings.statusLine = {
-        type: 'command',
-        command: statusLinePath,
-      }
-
-      await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2))
-
-      return { success: true }
-    } catch (error) {
-      return { success: false, error: getErrorMessage(error) }
-    }
-  }
-
-  /**
-   * Show beautiful ASCII art with quick start
-   */
-  showAsciiArt(): void {
-    console.log(chalk.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-    console.log('')
-    console.log(chalk.bold.cyan('   ██████╗ ██████╗      ██╗ ██████╗████████╗'))
-    console.log(chalk.bold.cyan('   ██╔══██╗██╔══██╗     ██║██╔════╝╚══██╔══╝'))
-    console.log(chalk.bold.cyan('   ██████╔╝██████╔╝     ██║██║        ██║'))
-    console.log(chalk.bold.cyan('   ██╔═══╝ ██╔══██╗██   ██║██║        ██║'))
-    console.log(chalk.bold.cyan('   ██║     ██║  ██║╚█████╔╝╚██████╗   ██║'))
-    console.log(chalk.bold.cyan('   ╚═╝     ╚═╝  ╚═╝ ╚════╝  ╚═════╝   ╚═╝'))
-    console.log('')
-    console.log(
-      `   ${chalk.bold.cyan('prjct')}${chalk.magenta('/')}${chalk.green('cli')}  ${chalk.dim.white(`v${VERSION} installed`)}`
-    )
-    console.log('')
-    console.log(`   ${chalk.yellow('⚡')} Ship faster with zero friction`)
-    console.log(`   ${chalk.green('📝')} From idea to technical tasks in minutes`)
-    console.log(`   ${chalk.cyan('🤖')} Perfect context for AI agents`)
-    console.log('')
-    console.log(chalk.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-    console.log('')
-    console.log(chalk.bold.cyan('🚀 Quick Start'))
-    console.log(chalk.dim('─────────────────────────────────────────────────'))
-    console.log('')
-    console.log(`  ${chalk.bold('1.')} Initialize your project:`)
-    console.log(`     ${chalk.green('cd your-project && prjct init')}`)
-    console.log('')
-    console.log(`  ${chalk.bold('2.')} Start your first task:`)
-    console.log(`     ${chalk.green('prjct task "build auth"')}`)
-    console.log('')
-    console.log(`  ${chalk.bold('3.')} Ship & celebrate:`)
-    console.log(`     ${chalk.green('prjct ship "user login"')}`)
-    console.log('')
-    console.log(chalk.dim('─────────────────────────────────────────────────'))
-    console.log('')
-    console.log(`  ${chalk.dim('Documentation:')} ${chalk.cyan('https://prjct.app')}`)
-    console.log(
-      `  ${chalk.dim('Report issues:')} ${chalk.cyan('https://github.com/jlopezlira/prjct-cli/issues')}`
-    )
-    console.log('')
-    console.log(chalk.bold.magenta('Happy shipping! 🚀'))
-    console.log('')
-  }
-}

package/core/commands/shipping.ts

@@ -1,267 +0,0 @@
-/**
- * Shipping Commands: ship and related helpers
- * Write-Through Architecture: JSON → MD → Event
- */
-
-import path from 'node:path'
-import memorySystem from '../agentic/memory-system'
-import { shippedStorage, stateStorage } from '../storage'
-import type { CommandResult } from '../types'
-import { getErrorMessage, isNotFoundError } from '../types/fs'
-import { showNextSteps } from '../utils/next-steps'
-import { detectProjectCommands } from '../utils/project-commands'
-import { runWorkflowHooks } from '../workflow/workflow-preferences'
-import { configManager, dateHelper, fileHelper, out, PrjctCommandsBase, toolRegistry } from './base'
-
-export class ShippingCommands extends PrjctCommandsBase {
-  /**
-   * Run a command and capture exit code without throwing.
-   *
-   * Reason: `toolRegistry.Bash` swallows non-zero exits into stderr; we still want a reliable success flag.
-   */
-  private async _runWithExitCode(command: string): Promise<{ exitCode: number; output: string }> {
-    const bash = toolRegistry.get('Bash')!
-    const escaped = command.replace(/"/g, '\\"')
-    const wrapped = `bash -lc "set +e; ${escaped} 2>&1; echo __EXIT:$?"`
-    const result = (await bash(wrapped)) as { stdout: string; stderr: string }
-    const output = `${result.stdout}\n${result.stderr}`.trim()
-
-    const lines = output.split('\n')
-    let marker: string | undefined
-    for (let i = lines.length - 1; i >= 0; i--) {
-      if (lines[i].startsWith('__EXIT:')) {
-        marker = lines[i]
-        break
-      }
-    }
-    const exitCode = marker ? Number(marker.replace('__EXIT:', '').trim()) : 1
-
-    // Remove marker from output for cleaner logs
-    const cleaned = output
-      .split('\n')
-      .filter((line) => !line.startsWith('__EXIT:'))
-      .join('\n')
-      .trim()
-
-    return { exitCode: Number.isFinite(exitCode) ? exitCode : 1, output: cleaned }
-  }
-
-  /**
-   * /p:ship - Ship feature with complete automated workflow
-   */
-  async ship(
-    feature: string | null,
-    projectPath: string = process.cwd(),
-    options: { skipHooks?: boolean } = {}
-  ): Promise<CommandResult> {
-    try {
-      const initResult = await this.ensureProjectInit(projectPath)
-      if (!initResult.success) return initResult
-
-      const projectId = await configManager.getProjectId(projectPath)
-      if (!projectId) {
-        out.failWithHint('NO_PROJECT_ID')
-        return { success: false, error: 'No project ID found' }
-      }
-
-      let featureName = feature
-      if (!featureName) {
-        // Read from storage (JSON is source of truth)
-        const currentTask = await stateStorage.getCurrentTask(projectId)
-        featureName = currentTask?.description || 'current work'
-      }
-
-      // Run before_ship hooks (using memory-based preferences)
-      const beforeResult = await runWorkflowHooks(projectId, 'before', 'ship', {
-        projectPath,
-        skipHooks: options.skipHooks,
-      })
-      if (!beforeResult.success) {
-        return { success: false, error: `Hook failed: ${beforeResult.failed}` }
-      }
-
-      // Ship steps with progress indicator
-      out.step(1, 5, `Linting ${featureName}...`)
-      const lintResult = await this._runLint(projectPath)
-
-      out.step(2, 5, 'Running tests...')
-      const testResult = await this._runTests(projectPath)
-
-      out.step(3, 5, 'Updating version...')
-      const newVersion = await this._bumpVersion(projectPath)
-      await this._updateChangelog(featureName, newVersion, projectPath)
-
-      out.step(4, 5, 'Committing...')
-      const commitResult = await this._createShipCommit(featureName, projectPath)
-
-      if (commitResult.success) {
-        out.step(5, 5, 'Pushing...')
-        await this._gitPush(projectPath)
-      }
-
-      // Write-through: Record shipped feature (JSON → MD → Event)
-      await shippedStorage.addShipped(projectId, {
-        name: featureName,
-        version: newVersion,
-      })
-
-      await this.logToMemory(projectPath, 'feature_shipped', {
-        feature: featureName,
-        version: newVersion,
-        timestamp: dateHelper.getTimestamp(),
-      })
-
-      await memorySystem.learnDecision(projectId, 'commit_footer', 'prjct', 'ship')
-
-      if (testResult.success) {
-        await memorySystem.recordDecision(projectId, 'test_before_ship', 'true', 'ship')
-      }
-
-      const isQuickShip = !lintResult.success || !testResult.success
-      if (isQuickShip) {
-        await memorySystem.recordWorkflow(projectId, 'quick_ship', {
-          description: 'Ship without full checks',
-          feature_type: featureName.toLowerCase().includes('doc') ? 'docs' : 'other',
-        })
-      }
-
-      // Run after_ship hooks
-      await runWorkflowHooks(projectId, 'after', 'ship', {
-        projectPath,
-        skipHooks: options.skipHooks,
-      })
-
-      out.done(`v${newVersion} shipped`)
-      showNextSteps('ship')
-
-      return { success: true, feature: featureName, version: newVersion }
-    } catch (error) {
-      out.fail(getErrorMessage(error))
-      return { success: false, error: getErrorMessage(error) }
-    }
-  }
-
-  /**
-   * Run lint checks
-   */
-  async _runLint(projectPath: string): Promise<{ success: boolean; message: string }> {
-    try {
-      const detected = await detectProjectCommands(projectPath)
-      if (!detected.lint) return { success: true, message: 'skipped (no lint detected)' }
-
-      const { exitCode } = await this._runWithExitCode(detected.lint.command)
-      return { success: exitCode === 0, message: exitCode === 0 ? 'passed' : 'failed' }
-    } catch (error) {
-      // Lint detection/execution failed - skip gracefully
-      if (isNotFoundError(error)) {
-        return { success: true, message: 'skipped (lint not found)' }
-      }
-      return { success: true, message: 'skipped (lint detection failed)' }
-    }
-  }
-
-  /**
-   * Run tests
-   */
-  async _runTests(projectPath: string): Promise<{ success: boolean; message: string }> {
-    try {
-      const detected = await detectProjectCommands(projectPath)
-      if (!detected.test) return { success: true, message: 'skipped (no tests detected)' }
-
-      const { exitCode } = await this._runWithExitCode(detected.test.command)
-      return { success: exitCode === 0, message: exitCode === 0 ? 'passed' : 'failed' }
-    } catch (error) {
-      // Test detection/execution failed - skip gracefully
-      if (isNotFoundError(error)) {
-        return { success: true, message: 'skipped (tests not found)' }
-      }
-      return { success: true, message: 'skipped (test detection failed)' }
-    }
-  }
-
-  /**
-   * Bump version
-   */
-  async _bumpVersion(projectPath: string): Promise<string> {
-    try {
-      const pkgPath = path.join(projectPath, 'package.json')
-      const pkg = await fileHelper.readJson<{ version?: string }>(pkgPath, { version: '0.0.0' })
-      const oldVersion = pkg?.version || '0.0.0'
-      const [major, minor, patch] = oldVersion.split('.').map(Number)
-      const newVersion = `${major}.${minor}.${patch + 1}`
-      if (pkg) {
-        pkg.version = newVersion
-        await fileHelper.writeJson(pkgPath, pkg)
-      }
-      return newVersion
-    } catch (error) {
-      // No package.json or parse error - return default version
-      if (isNotFoundError(error) || error instanceof SyntaxError) {
-        return '0.0.1'
-      }
-      throw error
-    }
-  }
-
-  /**
-   * Update CHANGELOG
-   */
-  async _updateChangelog(feature: string, version: string, projectPath: string): Promise<void> {
-    try {
-      const changelogPath = path.join(projectPath, 'CHANGELOG.md')
-      const changelog = await fileHelper.readFile(changelogPath, '# Changelog\n\n')
-
-      const entry = `## [${version}] - ${dateHelper.formatDate(new Date())}\n\n### Added\n- ${feature}\n\n`
-      const updated = changelog.replace('# Changelog\n\n', `# Changelog\n\n${entry}`)
-
-      await fileHelper.writeFile(changelogPath, updated)
-    } catch (error) {
-      // CHANGELOG doesn't exist or can't be written - warn but continue
-      if (isNotFoundError(error)) {
-        console.error('   Warning: CHANGELOG.md not found')
-      } else {
-        console.error('   Warning: Could not update CHANGELOG')
-      }
-    }
-  }
-
-  /**
-   * Create git commit for ship
-   */
-  async _createShipCommit(
-    feature: string,
-    _projectPath: string
-  ): Promise<{ success: boolean; message: string }> {
-    try {
-      await toolRegistry.get('Bash')!('git add .')
-
-      const commitMsg = `feat: ${feature}\n\nGenerated with [p/](https://www.prjct.app/)`
-
-      await toolRegistry.get('Bash')!(`git commit -m "${commitMsg.replace(/"/g, '\\"')}"`)
-
-      return { success: true, message: 'Committed' }
-    } catch (error) {
-      // Git commit failed - likely no changes or not a repo
-      if (isNotFoundError(error)) {
-        return { success: false, message: 'Git not found' }
-      }
-      return { success: false, message: 'No changes to commit' }
-    }
-  }
-
-  /**
-   * Push to remote
-   */
-  async _gitPush(_projectPath: string): Promise<{ success: boolean; message: string }> {
-    try {
-      await toolRegistry.get('Bash')!('git push')
-      return { success: true, message: 'Pushed to remote' }
-    } catch (error) {
-      // Git push failed - no remote, auth issue, or git not found
-      if (isNotFoundError(error)) {
-        return { success: false, message: 'Git not found' }
-      }
-      return { success: false, message: 'Push failed (no remote or auth issue)' }
-    }
-  }
-}