prjct-cli 0.8.4 → 0.8.8

package/core/infrastructure/setup.js

@@ -0,0 +1,185 @@
+const { execSync } = require('child_process')
+const installer = require('./command-installer')
+const migrator = require('./migrator')
+const legacyDetector = require('./legacy-installer-detector')
+const editorsConfig = require('./editors-config')
+const { VERSION } = require('../utils/version')
+
+/**
+ * Setup Module - Core installation logic
+ *
+ * Executes ALL setup needed for prjct-cli:
+ * 1. Detect and clean legacy installation (curl-based)
+ * 2. Install Claude Code CLI if missing
+ * 3. Sync commands to ~/.claude/commands/p/
+ * 4. Install global config ~/.claude/CLAUDE.md
+ * 5. Migrate legacy projects automatically
+ * 6. Save version in editors-config
+ *
+ * This module is called from:
+ * - core/index.js (on first CLI use)
+ * - scripts/postinstall.js (if npm scripts are enabled)
+ *
+ * @version 0.8.8
+ */
+
+// Colors
+const GREEN = '\x1b[32m'
+const YELLOW = '\x1b[33m'
+const MAGENTA = '\x1b[35m'
+const BOLD = '\x1b[1m'
+const DIM = '\x1b[2m'
+const NC = '\x1b[0m'
+
+/**
+ * Check if Claude Code CLI is installed
+ */
+async function hasClaudeCodeCLI() {
+  try {
+    execSync('which claude', { stdio: 'ignore' })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Install Claude Code CLI
+ */
+async function installClaudeCode() {
+  try {
+    console.log(`${YELLOW}📦 Claude Code not found. Installing...${NC}`)
+    console.log('')
+    execSync('npm install -g @anthropic-ai/claude-code', { stdio: 'inherit' })
+    console.log('')
+    console.log(`${GREEN}✓${NC} Claude Code installed successfully`)
+    console.log('')
+    return true
+  } catch (error) {
+    console.log(`${YELLOW}⚠️  Failed to install Claude Code: ${error.message}${NC}`)
+    console.log(`${DIM}Please install manually: npm install -g @anthropic-ai/claude-code${NC}`)
+    console.log('')
+    return false
+  }
+}
+
+/**
+ * Main setup function
+ */
+async function run() {
+  const results = {
+    legacyCleaned: false,
+    legacyProjectsMigrated: 0,
+    claudeInstalled: false,
+    commandsAdded: 0,
+    commandsUpdated: 0,
+    configAction: null,
+    projectsMigrated: 0
+  }
+
+  // Step 0: Detect and clean legacy curl installation
+  const needsLegacyCleanup = await legacyDetector.needsCleanup()
+  if (needsLegacyCleanup) {
+    const cleanupResult = await legacyDetector.performCleanup({ verbose: true })
+    results.legacyCleaned = cleanupResult.success
+    results.legacyProjectsMigrated = cleanupResult.steps.projectsMigrated
+  }
+
+  // Step 1: Ensure Claude Code CLI is installed
+  const hasClaude = await hasClaudeCodeCLI()
+
+  if (!hasClaude) {
+    const installed = await installClaudeCode()
+    if (installed) {
+      results.claudeInstalled = true
+    } else {
+      throw new Error('Claude Code installation failed')
+    }
+  }
+
+  // Step 2: Detect Claude directory (for commands)
+  const claudeDetected = await installer.detectClaude()
+
+  if (claudeDetected) {
+    // Step 3: Sync commands
+    const syncResult = await installer.syncCommands()
+
+    if (syncResult.success) {
+      results.commandsAdded = syncResult.added
+      results.commandsUpdated = syncResult.updated
+    }
+
+    // Step 4: Install global configuration
+    const configResult = await installer.installGlobalConfig()
+
+    if (configResult.success) {
+      results.configAction = configResult.action
+    }
+
+    // Step 5: Migrate legacy projects automatically
+    const migrationResult = await migrator.migrateAll({
+      deepScan: false,
+      cleanupLegacy: true,
+      dryRun: false
+    })
+
+    if (migrationResult.successfullyMigrated > 0) {
+      results.projectsMigrated = migrationResult.successfullyMigrated
+    }
+  }
+
+  // Step 6: Save version in editors-config
+  await editorsConfig.saveConfig(VERSION, installer.getInstallPath())
+
+  // Show results
+  showResults(results)
+
+  return results
+}
+
+/**
+ * Show setup results
+ */
+function showResults(results) {
+  console.log('')
+
+  // Show what was done
+  if (results.legacyCleaned) {
+    console.log(`   ${GREEN}✓${NC} Legacy curl installation cleaned up`)
+    if (results.legacyProjectsMigrated > 0) {
+      console.log(`   ${GREEN}✓${NC} ${results.legacyProjectsMigrated} project(s) migrated from legacy`)
+    }
+  }
+
+  if (results.claudeInstalled) {
+    console.log(`   ${GREEN}✓${NC} Claude Code CLI installed`)
+  } else {
+    console.log(`   ${GREEN}✓${NC} Claude Code CLI found`)
+  }
+
+  const totalCommands = results.commandsAdded + results.commandsUpdated
+  if (totalCommands > 0) {
+    const parts = []
+    if (results.commandsAdded > 0) parts.push(`${results.commandsAdded} new`)
+    if (results.commandsUpdated > 0) parts.push(`${results.commandsUpdated} updated`)
+    console.log(`   ${GREEN}✓${NC} Commands synced (${parts.join(', ')})`)
+  } else {
+    console.log(`   ${GREEN}✓${NC} Commands up to date`)
+  }
+
+  if (results.configAction === 'created') {
+    console.log(`   ${GREEN}✓${NC} Global config created`)
+  } else if (results.configAction === 'updated') {
+    console.log(`   ${GREEN}✓${NC} Global config updated`)
+  } else if (results.configAction === 'appended') {
+    console.log(`   ${GREEN}✓${NC} Global config merged`)
+  }
+
+  if (results.projectsMigrated > 0) {
+    console.log(`   ${GREEN}✓${NC} ${results.projectsMigrated} projects migrated to global storage`)
+  }
+
+  console.log('')
+}
+
+module.exports = { run }

package/core/utils/jsonl-helper.js

@@ -1,4 +1,7 @@
 const fs = require('fs').promises
+const fsSync = require('fs')
+const readline = require('readline')
+const path = require('path')
 
 /**
  * JSONL Helper - Centralized JSONL parsing and writing
@@ -190,6 +193,134 @@ async function isJsonLinesEmpty(filePath) {
   return count === 0
 }
 
+/**
+ * Read JSONL file with streaming (memory-efficient for large files)
+ * Only reads last N lines instead of loading entire file
+ *
+ * @param {string} filePath - Path to JSONL file
+ * @param {number} maxLines - Maximum lines to read (default: 1000)
+ * @returns {Promise<Array<Object>>} - Array of parsed objects (last N lines)
+ */
+async function readJsonLinesStreaming(filePath, maxLines = 1000) {
+  try {
+    const fileStream = fsSync.createReadStream(filePath)
+    const rl = readline.createInterface({
+      input: fileStream,
+      crlfDelay: Infinity,
+    })
+
+    const lines = []
+
+    for await (const line of rl) {
+      if (line.trim()) {
+        try {
+          lines.push(JSON.parse(line))
+        } catch {
+          // Skip malformed lines
+        }
+
+        // Keep only last maxLines
+        if (lines.length > maxLines) {
+          lines.shift()
+        }
+      }
+    }
+
+    return lines
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      return []
+    }
+    throw error
+  }
+}
+
+/**
+ * Get file size in MB
+ *
+ * @param {string} filePath - Path to file
+ * @returns {Promise<number>} - File size in MB
+ */
+async function getFileSizeMB(filePath) {
+  try {
+    const stats = await fs.stat(filePath)
+    return stats.size / (1024 * 1024)
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      return 0
+    }
+    throw error
+  }
+}
+
+/**
+ * Rotate JSONL file if it exceeds size limit
+ * Moves large file to archive with timestamp
+ *
+ * @param {string} filePath - Path to JSONL file
+ * @param {number} maxSizeMB - Maximum size in MB before rotation (default: 10)
+ * @returns {Promise<boolean>} - True if rotated, false if not needed
+ */
+async function rotateJsonLinesIfNeeded(filePath, maxSizeMB = 10) {
+  const sizeMB = await getFileSizeMB(filePath)
+
+  if (sizeMB < maxSizeMB) {
+    return false // No rotation needed
+  }
+
+  // Generate archive filename with timestamp
+  const timestamp = new Date().toISOString().split('T')[0] // YYYY-MM-DD
+  const dir = path.dirname(filePath)
+  const ext = path.extname(filePath)
+  const base = path.basename(filePath, ext)
+  const archivePath = path.join(dir, `${base}-${timestamp}${ext}`)
+
+  // Move file to archive
+  await fs.rename(filePath, archivePath)
+
+  console.log(`📦 Rotated ${path.basename(filePath)} (${sizeMB.toFixed(1)}MB) → ${path.basename(archivePath)}`)
+
+  return true
+}
+
+/**
+ * Append JSON line with automatic rotation
+ * Checks file size before append and rotates if needed
+ *
+ * @param {string} filePath - Path to JSONL file
+ * @param {Object} object - Object to append
+ * @param {number} maxSizeMB - Maximum size before rotation (default: 10)
+ * @returns {Promise<void>}
+ */
+async function appendJsonLineWithRotation(filePath, object, maxSizeMB = 10) {
+  // Rotate if needed (before appending)
+  await rotateJsonLinesIfNeeded(filePath, maxSizeMB)
+
+  // Append normally
+  await appendJsonLine(filePath, object)
+}
+
+/**
+ * Warn if file is large before reading
+ * Returns size and whether it's considered large
+ *
+ * @param {string} filePath - Path to file
+ * @param {number} warnThresholdMB - Threshold in MB to warn (default: 50)
+ * @returns {Promise<{sizeMB: number, isLarge: boolean}>}
+ */
+async function checkFileSizeWarning(filePath, warnThresholdMB = 50) {
+  const sizeMB = await getFileSizeMB(filePath)
+  const isLarge = sizeMB > warnThresholdMB
+
+  if (isLarge) {
+    console.warn(
+      `⚠️  Large file detected: ${path.basename(filePath)} (${sizeMB.toFixed(1)}MB). Reading may use significant memory.`
+    )
+  }
+
+  return { sizeMB, isLarge }
+}
+
 module.exports = {
   parseJsonLines,
   stringifyJsonLines,
@@ -203,4 +334,10 @@ module.exports = {
   getFirstJsonLines,
   mergeJsonLines,
   isJsonLinesEmpty,
+  // NEW: Memory-efficient functions
+  readJsonLinesStreaming,
+  getFileSizeMB,
+  rotateJsonLinesIfNeeded,
+  appendJsonLineWithRotation,
+  checkFileSizeWarning,
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.8.4",
+  "version": "0.8.8",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.js",
   "bin": {

package/scripts/install.sh

@@ -9,22 +9,59 @@
 YELLOW='\033[1;33m'
 CYAN='\033[0;36m'
 GREEN='\033[0;32m'
+RED='\033[0;31m'
+BOLD='\033[1m'
+DIM='\033[2m'
 NC='\033[0m'
 
+# Check if legacy installation exists
+LEGACY_DIR="$HOME/.prjct-cli"
+HAS_LEGACY=false
+LEGACY_VERSION="unknown"
+
+if [ -d "$LEGACY_DIR" ]; then
+  # Check if it's a git clone (legacy curl install)
+  if [ -d "$LEGACY_DIR/.git" ]; then
+    HAS_LEGACY=true
+    if [ -f "$LEGACY_DIR/package.json" ]; then
+      LEGACY_VERSION=$(grep -o '"version":[[:space:]]*"[^"]*"' "$LEGACY_DIR/package.json" | head -1 | cut -d'"' -f4)
+    fi
+  fi
+fi
+
 echo ""
 echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
 echo -e "${YELLOW}⚠️  This installation method is DEPRECATED${NC}"
 echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
 echo ""
-echo -e "Please use npm instead:"
-echo ""
-echo -e "  ${GREEN}npm install -g prjct-cli${NC}"
-echo ""
-echo -e "Benefits of npm installation:"
-echo -e "  • ${CYAN}Automatic setup${NC} - No manual configuration needed"
-echo -e "  • ${CYAN}Auto-migration${NC} - Legacy projects migrated automatically"
-echo -e "  • ${CYAN}Beautiful ASCII art${NC} - See the installation success"
+
+if [ "$HAS_LEGACY" = true ]; then
+  echo -e "${RED}⚠️  Legacy curl installation detected!${NC}"
+  echo ""
+  echo -e "   ${DIM}Version: ${LEGACY_VERSION}${NC}"
+  echo -e "   ${DIM}Location: ~/.prjct-cli/${NC}"
+  echo ""
+  echo -e "${CYAN}Migration Required:${NC}"
+  echo ""
+  echo -e "  1. ${BOLD}Install via npm:${NC}"
+  echo -e "     ${GREEN}npm install -g prjct-cli${NC}"
+  echo ""
+  echo -e "  2. ${BOLD}Automatic cleanup:${NC}"
+  echo -e "     ${DIM}Legacy installation will be cleaned automatically${NC}"
+  echo -e "     ${DIM}Your project data will be preserved${NC}"
+  echo ""
+else
+  echo -e "${CYAN}Please install using npm:${NC}"
+  echo ""
+  echo -e "  ${GREEN}npm install -g prjct-cli${NC}"
+  echo ""
+fi
+
+echo -e "${BOLD}Benefits of npm installation:${NC}"
+echo -e "  • ${CYAN}Automatic cleanup${NC} - Removes old curl installations"
+echo -e "  • ${CYAN}Data preservation${NC} - Your projects are migrated safely"
 echo -e "  • ${CYAN}Easy updates${NC} - Just npm update -g prjct-cli"
+echo -e "  • ${CYAN}Proper versioning${NC} - npm handles everything"
 echo ""
 echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
 echo ""

package/scripts/postinstall.js

@@ -1,114 +1,35 @@
 #!/usr/bin/env node
 
 /**
- * Post-install hook for prjct-cli
+ * Post-install hook for prjct-cli (OPTIONAL)
  *
- * Runs automatically after npm install -g prjct-cli
+ * Attempts to run setup if npm scripts are enabled.
+ * If it fails or doesn't run, no problem - setup will run
+ * automatically on first CLI use (like Astro, Vite, etc.)
  *
- * 1. Detects if global install
- * 2. Installs Claude Code CLI if not found (automatic)
- * 3. Installs/syncs commands to ~/.claude/commands/p/
- * 4. Installs/updates global config to ~/.claude/CLAUDE.md
- * 5. Migrates all legacy projects automatically
- * 6. Shows success message with results
+ * This hook is an optimization but NOT critical.
  *
- * ZERO MANUAL STEPS - Everything is automatic
- *
- * @version 0.8.4
+ * @version 0.8.8
  */
 
 const path = require('path')
-const { execSync } = require('child_process')
-const installer = require('../core/infrastructure/command-installer')
-const migrator = require('../core/infrastructure/migrator')
-const { VERSION } = require('../core/utils/version')
-
-// Colors for terminal output
-const CYAN = '\x1b[36m'
-const GREEN = '\x1b[32m'
-const YELLOW = '\x1b[33m'
-const MAGENTA = '\x1b[35m'
-const WHITE = '\x1b[37m'
-const BOLD = '\x1b[1m'
-const DIM = '\x1b[2m'
-const NC = '\x1b[0m' // No Color
+const setup = require('../core/infrastructure/setup')
 
 async function main() {
   try {
     // Detect if this is a global install
-    const isGlobal = await detectGlobalInstall()
+    const isGlobal = detectGlobalInstall()
 
     if (!isGlobal) {
       // Skip postinstall for local development installs
-      console.log(`${DIM}Skipping post-install (local development)${NC}`)
       return
     }
 
-    console.log('')
-    console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
-    console.log(`${BOLD}${CYAN}🚀 Setting up prjct-cli v${VERSION}${NC}`)
-    console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
-    console.log('')
-
-    const results = {
-      claudeInstalled: false,
-      commandsAdded: 0,
-      commandsUpdated: 0,
-      configAction: null,
-      projectsMigrated: 0
-    }
-
-    // Step 1: Ensure Claude Code CLI is installed
-    const hasClaude = await hasClaudeCodeCLI()
-
-    if (!hasClaude) {
-      const installed = await installClaudeCode()
-      if (installed) {
-        results.claudeInstalled = true
-      } else {
-        // Cannot continue without Claude Code
-        showFailureMessage()
-        return
-      }
-    }
-
-    // Step 2: Detect Claude directory (for commands)
-    const claudeDetected = await installer.detectClaude()
-
-    if (claudeDetected) {
-      // Step 3: Sync commands
-      const syncResult = await installer.syncCommands()
-
-      if (syncResult.success) {
-        results.commandsAdded = syncResult.added
-        results.commandsUpdated = syncResult.updated
-      }
-
-      // Step 4: Install global configuration
-      const configResult = await installer.installGlobalConfig()
-
-      if (configResult.success) {
-        results.configAction = configResult.action
-      }
-
-      // Step 5: Migrate legacy projects automatically
-      const migrationResult = await migrator.migrateAll({
-        deepScan: false,
-        cleanupLegacy: true,
-        dryRun: false
-      })
-
-      if (migrationResult.successfullyMigrated > 0) {
-        results.projectsMigrated = migrationResult.successfullyMigrated
-      }
-    }
-
-    // Show final success message
-    showSuccessMessage(results)
+    // Run setup (all logic is in core/infrastructure/setup.js)
+    await setup.run()
 
   } catch (error) {
-    console.error(`${YELLOW}⚠️  Post-install error: ${error.message}${NC}`)
-    console.error(`${DIM}You can run 'prjct setup' manually later${NC}`)
+    // Silent failure - setup will run on first use anyway
     // Don't fail the install if post-install has issues
     process.exit(0)
   }
@@ -117,7 +38,7 @@ async function main() {
 /**
  * Detect if this is a global npm install
  */
-async function detectGlobalInstall() {
+function detectGlobalInstall() {
   // Check if we're being installed globally
   const npmConfig = process.env.npm_config_global
   if (npmConfig === 'true') {
@@ -137,118 +58,6 @@ async function detectGlobalInstall() {
   return globalPaths.some(globalPath => installPath.includes(globalPath))
 }
 
-/**
- * Check if Claude Code CLI is installed
- */
-async function hasClaudeCodeCLI() {
-  try {
-    execSync('which claude', { stdio: 'ignore' })
-    return true
-  } catch {
-    return false
-  }
-}
-
-/**
- * Install Claude Code CLI
- */
-async function installClaudeCode() {
-  try {
-    console.log(`${YELLOW}📦 Claude Code not found. Installing...${NC}`)
-    console.log('')
-    execSync('npm install -g @anthropic-ai/claude-code', { stdio: 'inherit' })
-    console.log('')
-    console.log(`${GREEN}✓${NC} Claude Code installed successfully`)
-    console.log('')
-    return true
-  } catch (error) {
-    console.log(`${YELLOW}⚠️  Failed to install Claude Code: ${error.message}${NC}`)
-    console.log(`${DIM}Please install manually: npm install -g @anthropic-ai/claude-code${NC}`)
-    console.log('')
-    return false
-  }
-}
-
-/**
- * Show success message with results
- */
-function showSuccessMessage(results) {
-  console.log('')
-  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
-  console.log('')
-  console.log(`   ${BOLD}${CYAN}██████╗ ██████╗      ██╗ ██████╗████████╗${NC}`)
-  console.log(`   ${BOLD}${CYAN}██╔══██╗██╔══██╗     ██║██╔════╝╚══██╔══╝${NC}`)
-  console.log(`   ${BOLD}${CYAN}██████╔╝██████╔╝     ██║██║        ██║${NC}`)
-  console.log(`   ${BOLD}${CYAN}██╔═══╝ ██╔══██╗██   ██║██║        ██║${NC}`)
-  console.log(`   ${BOLD}${CYAN}██║     ██║  ██║╚█████╔╝╚██████╗   ██║${NC}`)
-  console.log(`   ${BOLD}${CYAN}╚═╝     ╚═╝  ╚═╝ ╚════╝  ╚═════╝   ╚═╝${NC}`)
-  console.log('')
-  console.log(`        ${BOLD}${GREEN}v${VERSION} READY!${NC}`)
-  console.log('')
-  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
-  console.log('')
-
-  // Show what was done
-  if (results.claudeInstalled) {
-    console.log(`   ${GREEN}✓${NC} Claude Code CLI installed`)
-  } else {
-    console.log(`   ${GREEN}✓${NC} Claude Code CLI found`)
-  }
-
-  const totalCommands = results.commandsAdded + results.commandsUpdated
-  if (totalCommands > 0) {
-    const parts = []
-    if (results.commandsAdded > 0) parts.push(`${results.commandsAdded} new`)
-    if (results.commandsUpdated > 0) parts.push(`${results.commandsUpdated} updated`)
-    console.log(`   ${GREEN}✓${NC} Commands synced (${parts.join(', ')})`)
-  } else {
-    console.log(`   ${GREEN}✓${NC} Commands up to date`)
-  }
-
-  if (results.configAction === 'created') {
-    console.log(`   ${GREEN}✓${NC} Global config created`)
-  } else if (results.configAction === 'updated') {
-    console.log(`   ${GREEN}✓${NC} Global config updated`)
-  } else if (results.configAction === 'appended') {
-    console.log(`   ${GREEN}✓${NC} Global config merged`)
-  }
-
-  if (results.projectsMigrated > 0) {
-    console.log(`   ${GREEN}✓${NC} ${results.projectsMigrated} projects migrated to global storage`)
-  }
-
-  console.log('')
-  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
-  console.log('')
-  console.log(`${BOLD}Next steps:${NC}`)
-  console.log(`  ${DIM}cd your-project${NC}`)
-  console.log(`  ${GREEN}/p:init${NC}`)
-  console.log('')
-  console.log(`${BOLD}${MAGENTA}Happy shipping! 🚀${NC}`)
-  console.log('')
-}
-
-/**
- * Show failure message
- */
-function showFailureMessage() {
-  console.log('')
-  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
-  console.log('')
-  console.log(`${YELLOW}⚠️  Setup incomplete${NC}`)
-  console.log('')
-  console.log(`Claude Code is required for prjct-cli.`)
-  console.log('')
-  console.log(`Please install manually:`)
-  console.log(`  ${GREEN}npm install -g @anthropic-ai/claude-code${NC}`)
-  console.log('')
-  console.log(`Then run:`)
-  console.log(`  ${GREEN}prjct setup${NC}`)
-  console.log('')
-  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
-  console.log('')
-}
-
 // Run if executed directly
 if (require.main === module) {
   main().catch(error => {

package/templates/agents/AGENTS.md

@@ -167,13 +167,13 @@ Semantic understanding, not pattern matching.
 
 | Intent     | Command    | Examples                                     |
 | ---------- | ---------- | -------------------------------------------- |
-| Start task | `/p:now`   | "work on X", "starting API", "voy a hacer X" |
-| Finish     | `/p:done`  | "done", "finished", "terminé", "listo"       |
+| Start task | `/p:now`   | "work on X", "starting API", "begin auth"    |
+| Finish     | `/p:done`  | "done", "finished", "completed", "all set"   |
 | Ship       | `/p:ship`  | "ship this", "deploy X", "it's ready"        |
 | Idea       | `/p:idea`  | "I have an idea", "what if we..."            |
 | Progress   | `/p:recap` | "show progress", "how am I doing"            |
 | Stuck      | `/p:stuck` | "I'm stuck", "help with X"                   |
-| Next       | `/p:next`  | "what's next", "qué sigue"                   |
+| Next       | `/p:next`  | "what's next", "show queue", "priority list" |
 
 **Any language works** - if you understand intent, execute the command.