prjct-cli 1.1.1 → 1.2.1

package/core/utils/help.ts

@@ -7,17 +7,10 @@
  * @module utils/help
  */
 
+import chalk from 'chalk'
 import { CATEGORIES, COMMANDS } from '../commands/command-data'
 import { VERSION } from './version'
 
-// ANSI colors
-const CYAN = '\x1b[36m'
-const DIM = '\x1b[2m'
-const BOLD = '\x1b[1m'
-const RESET = '\x1b[0m'
-const GREEN = '\x1b[32m'
-const YELLOW = '\x1b[33m'
-
 /**
  * Terminal commands that run directly in the shell
  */
@@ -43,6 +36,12 @@ const TERMINAL_COMMANDS = [
     example: 'prjct watch',
     options: ['--verbose', '--debounce=<ms>', '--interval=<sec>'],
   },
+  {
+    name: 'hooks',
+    description: 'Manage git hooks for auto-sync',
+    example: 'prjct hooks install',
+    subcommands: ['install', 'uninstall', 'status'],
+  },
   {
     name: 'doctor',
     description: 'Check system health and dependencies',
@@ -90,22 +89,24 @@ export function formatMainHelp(): string {
 
   // Header
   lines.push('')
-  lines.push(`${CYAN}${BOLD}prjct${RESET} v${VERSION} - Context layer for AI coding agents`)
-  lines.push(`${DIM}Works with Claude Code, Gemini CLI, Cursor, Windsurf, and more.${RESET}`)
+  lines.push(`${chalk.cyan.bold('prjct')} v${VERSION} - Context layer for AI coding agents`)
+  lines.push(chalk.dim('Works with Claude Code, Gemini CLI, Cursor, Windsurf, and more.'))
   lines.push('')
 
   // Quick Start
-  lines.push(`${BOLD}QUICK START${RESET}`)
-  lines.push(`${DIM}${'─'.repeat(60)}${RESET}`)
-  lines.push(`  ${GREEN}1.${RESET} prjct start              ${DIM}# Configure AI providers${RESET}`)
-  lines.push(`  ${GREEN}2.${RESET} cd my-project && prjct init`)
-  lines.push(`  ${GREEN}3.${RESET} Open in Claude Code / Gemini CLI / Cursor`)
-  lines.push(`  ${GREEN}4.${RESET} p. sync                  ${DIM}# Analyze project${RESET}`)
+  lines.push(chalk.bold('QUICK START'))
+  lines.push(chalk.dim('─'.repeat(60)))
+  lines.push(
+    `  ${chalk.green('1.')} prjct start              ${chalk.dim('# Configure AI providers')}`
+  )
+  lines.push(`  ${chalk.green('2.')} cd my-project && prjct init`)
+  lines.push(`  ${chalk.green('3.')} Open in Claude Code / Gemini CLI / Cursor`)
+  lines.push(`  ${chalk.green('4.')} p. sync                  ${chalk.dim('# Analyze project')}`)
   lines.push('')
 
   // Terminal Commands
-  lines.push(`${BOLD}TERMINAL COMMANDS${RESET}`)
-  lines.push(`${DIM}${'─'.repeat(60)}${RESET}`)
+  lines.push(chalk.bold('TERMINAL COMMANDS'))
+  lines.push(chalk.dim('─'.repeat(60)))
   for (const cmd of TERMINAL_COMMANDS) {
     const name = `prjct ${cmd.name}`.padEnd(22)
     lines.push(`  ${name} ${cmd.description}`)
@@ -113,10 +114,10 @@ export function formatMainHelp(): string {
   lines.push('')
 
   // AI Agent Commands
-  lines.push(`${BOLD}AI AGENT COMMANDS${RESET} ${DIM}(inside Claude/Gemini/Cursor)${RESET}`)
-  lines.push(`${DIM}${'─'.repeat(60)}${RESET}`)
+  lines.push(`${chalk.bold('AI AGENT COMMANDS')} ${chalk.dim('(inside Claude/Gemini/Cursor)')}`)
+  lines.push(chalk.dim('─'.repeat(60)))
   lines.push(`  ${'Command'.padEnd(22)} Description`)
-  lines.push(`  ${DIM}${'─'.repeat(56)}${RESET}`)
+  lines.push(`  ${chalk.dim('─'.repeat(56))}`)
 
   // Core commands
   const coreCommands = COMMANDS.filter((c) => c.group === 'core' && c.usage?.claude)
@@ -124,22 +125,24 @@ export function formatMainHelp(): string {
     const usage = `p. ${cmd.name}`.padEnd(22)
     lines.push(`  ${usage} ${cmd.description}`)
   }
-  lines.push(`  ${DIM}... and ${coreCommands.length - 10} more (run 'prjct help commands')${RESET}`)
+  lines.push(
+    `  ${chalk.dim(`... and ${coreCommands.length - 10} more (run 'prjct help commands')`)}`
+  )
   lines.push('')
 
   // Global Flags
-  lines.push(`${BOLD}FLAGS${RESET}`)
-  lines.push(`${DIM}${'─'.repeat(60)}${RESET}`)
+  lines.push(chalk.bold('FLAGS'))
+  lines.push(chalk.dim('─'.repeat(60)))
   for (const flag of GLOBAL_FLAGS) {
     lines.push(`  ${flag.flag.padEnd(22)} ${flag.description}`)
   }
   lines.push('')
 
   // More Info
-  lines.push(`${BOLD}MORE INFO${RESET}`)
-  lines.push(`${DIM}${'─'.repeat(60)}${RESET}`)
-  lines.push(`  Documentation:  ${CYAN}https://prjct.app${RESET}`)
-  lines.push(`  GitHub:         ${CYAN}https://github.com/jlopezlira/prjct-cli${RESET}`)
+  lines.push(chalk.bold('MORE INFO'))
+  lines.push(chalk.dim('─'.repeat(60)))
+  lines.push(`  Documentation:  ${chalk.cyan('https://prjct.app')}`)
+  lines.push(`  GitHub:         ${chalk.cyan('https://github.com/jlopezlira/prjct-cli')}`)
   lines.push(`  Per-command:    prjct help <command>`)
   lines.push('')
 
@@ -156,15 +159,15 @@ export function formatTerminalCommandHelp(commandName: string): string | null {
   const lines: string[] = []
 
   lines.push('')
-  lines.push(`${CYAN}${BOLD}prjct ${cmd.name}${RESET} - ${cmd.description}`)
+  lines.push(`${chalk.cyan.bold(`prjct ${cmd.name}`)} - ${cmd.description}`)
   lines.push('')
 
-  lines.push(`${BOLD}USAGE${RESET}`)
+  lines.push(chalk.bold('USAGE'))
   lines.push(`  ${cmd.example}`)
   lines.push('')
 
   if (cmd.options) {
-    lines.push(`${BOLD}OPTIONS${RESET}`)
+    lines.push(chalk.bold('OPTIONS'))
     for (const opt of cmd.options) {
       lines.push(`  ${opt}`)
     }
@@ -172,7 +175,7 @@ export function formatTerminalCommandHelp(commandName: string): string | null {
   }
 
   if (cmd.subcommands) {
-    lines.push(`${BOLD}SUBCOMMANDS${RESET}`)
+    lines.push(chalk.bold('SUBCOMMANDS'))
     for (const sub of cmd.subcommands) {
       lines.push(`  ${sub}`)
     }
@@ -192,10 +195,10 @@ export function formatAgentCommandHelp(commandName: string): string | null {
   const lines: string[] = []
 
   lines.push('')
-  lines.push(`${CYAN}${BOLD}p. ${cmd.name}${RESET} - ${cmd.description}`)
+  lines.push(`${chalk.cyan.bold(`p. ${cmd.name}`)} - ${cmd.description}`)
   lines.push('')
 
-  lines.push(`${BOLD}USAGE${RESET}`)
+  lines.push(chalk.bold('USAGE'))
   if (cmd.usage?.claude) {
     lines.push(`  Claude/Gemini:  ${cmd.usage.claude.replace('/p:', 'p. ')}`)
   }
@@ -205,13 +208,13 @@ export function formatAgentCommandHelp(commandName: string): string | null {
   lines.push('')
 
   if (cmd.params) {
-    lines.push(`${BOLD}PARAMETERS${RESET}`)
+    lines.push(chalk.bold('PARAMETERS'))
     lines.push(`  ${cmd.params}`)
     lines.push('')
   }
 
   if (cmd.features && cmd.features.length > 0) {
-    lines.push(`${BOLD}FEATURES${RESET}`)
+    lines.push(chalk.bold('FEATURES'))
     for (const feature of cmd.features) {
       lines.push(`  • ${feature}`)
     }
@@ -219,17 +222,17 @@ export function formatAgentCommandHelp(commandName: string): string | null {
   }
 
   if (cmd.blockingRules) {
-    lines.push(`${BOLD}REQUIREMENTS${RESET}`)
-    lines.push(`  ${YELLOW}⚠${RESET} ${cmd.blockingRules.check}`)
+    lines.push(chalk.bold('REQUIREMENTS'))
+    lines.push(`  ${chalk.yellow('⚠')} ${cmd.blockingRules.check}`)
     lines.push('')
   }
 
   // Category info
   const category = CATEGORIES[cmd.group]
   if (category) {
-    lines.push(`${DIM}Category: ${category.title}${RESET}`)
+    lines.push(chalk.dim(`Category: ${category.title}`))
     if (cmd.isOptional) {
-      lines.push(`${DIM}This is an optional command.${RESET}`)
+      lines.push(chalk.dim('This is an optional command.'))
     }
     lines.push('')
   }
@@ -251,7 +254,7 @@ export function formatCommandHelp(commandName: string): string {
 
   // Command not found
   return `
-${YELLOW}Command '${commandName}' not found.${RESET}
+${chalk.yellow(`Command '${commandName}' not found.`)}
 
 Run 'prjct help' to see all available commands.
 `
@@ -264,7 +267,7 @@ export function formatCommandList(): string {
   const lines: string[] = []
 
   lines.push('')
-  lines.push(`${CYAN}${BOLD}All Commands${RESET}`)
+  lines.push(chalk.cyan.bold('All Commands'))
   lines.push('')
 
   // Group by category
@@ -275,9 +278,9 @@ export function formatCommandList(): string {
     if (categoryCommands.length === 0) continue
 
     lines.push(
-      `${BOLD}${category.title}${RESET} ${DIM}(${categoryCommands.length} commands)${RESET}`
+      `${chalk.bold(category.title)} ${chalk.dim(`(${categoryCommands.length} commands)`)}`
     )
-    lines.push(`${DIM}${category.description}${RESET}`)
+    lines.push(chalk.dim(category.description))
     lines.push('')
 
     for (const cmd of categoryCommands) {
@@ -289,7 +292,7 @@ export function formatCommandList(): string {
     lines.push('')
   }
 
-  lines.push(`${DIM}Run 'prjct help <command>' for detailed help on a specific command.${RESET}`)
+  lines.push(chalk.dim("Run 'prjct help <command>' for detailed help on a specific command."))
   lines.push('')
 
   return lines.join('\n')

package/core/utils/subtask-table.ts

@@ -8,32 +8,25 @@
  * @module utils/subtask-table
  */
 
-// ANSI codes
-const RESET = '\x1b[0m'
-const BOLD = '\x1b[1m'
-const DIM = '\x1b[2m'
-const GREEN = '\x1b[32m'
-const YELLOW = '\x1b[33m'
-const WHITE = '\x1b[37m'
-const GRAY = '\x1b[90m'
+import chalk from 'chalk'
 
 // Color palette for domains (cycle through these)
 const DOMAIN_COLOR_PALETTE = [
-  '\x1b[36m', // Cyan
-  '\x1b[35m', // Magenta
-  '\x1b[33m', // Yellow
-  '\x1b[34m', // Blue
-  '\x1b[32m', // Green
-  '\x1b[91m', // Light Red
-  '\x1b[95m', // Light Magenta
-  '\x1b[96m', // Light Cyan
+  chalk.cyan,
+  chalk.magenta,
+  chalk.yellow,
+  chalk.blue,
+  chalk.green,
+  chalk.redBright,
+  chalk.magentaBright,
+  chalk.cyanBright,
 ]
 
 /**
  * Get consistent color for a domain name using hash
  * Same domain name always returns same color
  */
-function getDomainColor(domain: string): string {
+function getDomainColor(domain: string): (text: string) => string {
   let hash = 0
   for (const char of domain) {
     hash = (hash << 5) - hash + char.charCodeAt(0)
@@ -43,7 +36,7 @@ function getDomainColor(domain: string): string {
   return DOMAIN_COLOR_PALETTE[index]
 }
 
-// Hide/show cursor
+// Terminal control sequences (not colors - chalk doesn't handle these)
 const HIDE_CURSOR = '\x1b[?25l'
 const SHOW_CURSOR = '\x1b[?25h'
 
@@ -67,9 +60,9 @@ function formatSubtaskLine(
   subtask: SubtaskDisplay,
   spinnerFrame: string = '▶'
 ): string {
-  const num = `${DIM}${String(index + 1).padStart(2)}${RESET}`
-  const domainColor = getDomainColor(subtask.domain)
-  const domain = `${domainColor}${subtask.domain.padEnd(10)}${RESET}`
+  const num = chalk.dim(String(index + 1).padStart(2))
+  const domainColorFn = getDomainColor(subtask.domain)
+  const domain = domainColorFn(subtask.domain.padEnd(10))
   const desc =
     subtask.description.length > 32
       ? `${subtask.description.slice(0, 29)}...`
@@ -78,22 +71,22 @@ function formatSubtaskLine(
   let status: string
   switch (subtask.status) {
     case 'completed':
-      status = `${GREEN}✓ Complete${RESET}`
+      status = chalk.green('✓ Complete')
       break
     case 'in_progress':
-      status = `${YELLOW}${spinnerFrame} Working...${RESET}`
+      status = chalk.yellow(`${spinnerFrame} Working...`)
       break
     case 'pending':
-      status = `${GRAY}○ Pending${RESET}`
+      status = chalk.gray('○ Pending')
       break
     case 'failed':
-      status = `\x1b[31m✗ Failed${RESET}`
+      status = chalk.red('✗ Failed')
       break
     case 'blocked':
-      status = `${GRAY}⊘ Blocked${RESET}`
+      status = chalk.gray('⊘ Blocked')
       break
     default:
-      status = `${GRAY}○ ${subtask.status}${RESET}`
+      status = chalk.gray(`○ ${subtask.status}`)
   }
 
   return `  ${num}   ${domain} ${desc}  ${status}`
@@ -108,8 +101,8 @@ export function renderSubtaskProgress(subtasks: SubtaskDisplay[]): string {
   const lines: string[] = []
 
   lines.push('')
-  lines.push(`  ${BOLD}${WHITE}SUBTASK PROGRESS${RESET}`)
-  lines.push(`  ${DIM}${'─'.repeat(58)}${RESET}`)
+  lines.push(`  ${chalk.bold.white('SUBTASK PROGRESS')}`)
+  lines.push(`  ${chalk.dim('─'.repeat(58))}`)
 
   for (let i = 0; i < subtasks.length; i++) {
     lines.push(formatSubtaskLine(i, subtasks[i]))
@@ -141,8 +134,8 @@ export function createSubtaskAnimation(subtasks: SubtaskDisplay[]) {
     const lines: string[] = []
 
     lines.push('')
-    lines.push(`  ${BOLD}${WHITE}SUBTASK PROGRESS${RESET}`)
-    lines.push(`  ${DIM}${'─'.repeat(58)}${RESET}`)
+    lines.push(`  ${chalk.bold.white('SUBTASK PROGRESS')}`)
+    lines.push(`  ${chalk.dim('─'.repeat(58))}`)
 
     for (let i = 0; i < subtasks.length; i++) {
       lines.push(formatSubtaskLine(i, subtasks[i], spinnerFrame))
@@ -204,8 +197,8 @@ export function createSubtaskAnimation(subtasks: SubtaskDisplay[]) {
       // Print final state with static icons
       const finalLines: string[] = []
       finalLines.push('')
-      finalLines.push(`  ${BOLD}${WHITE}SUBTASK PROGRESS${RESET}`)
-      finalLines.push(`  ${DIM}${'─'.repeat(58)}${RESET}`)
+      finalLines.push(`  ${chalk.bold.white('SUBTASK PROGRESS')}`)
+      finalLines.push(`  ${chalk.dim('─'.repeat(58))}`)
       for (let i = 0; i < subtasks.length; i++) {
         finalLines.push(formatSubtaskLine(i, subtasks[i], '▶'))
       }
@@ -226,7 +219,7 @@ export function createSubtaskAnimation(subtasks: SubtaskDisplay[]) {
  * Output: "Progress: 2/4 subtasks complete"
  */
 export function renderProgressLine(completed: number, total: number): string {
-  return `  ${DIM}Progress:${RESET} ${completed}/${total} subtasks complete`
+  return `  ${chalk.dim('Progress:')} ${completed}/${total} subtasks complete`
 }
 
 // Legacy exports for backwards compatibility

package/core/workflow/workflow-preferences.ts

@@ -15,17 +15,11 @@
 
 import { exec } from 'node:child_process'
 import { promisify } from 'node:util'
+import chalk from 'chalk'
 import memorySystem from '../agentic/memory-system'
 
 const execAsync = promisify(exec)
 
-// ANSI colors
-const DIM = '\x1b[2m'
-const GREEN = '\x1b[32m'
-const RED = '\x1b[31m'
-const YELLOW = '\x1b[33m'
-const RESET = '\x1b[0m'
-
 export type PreferenceScope = 'permanent' | 'session' | 'once'
 export type HookPhase = 'before' | 'after' | 'skip'
 export type HookCommand = 'task' | 'done' | 'ship' | 'sync'
@@ -169,7 +163,7 @@ export async function runWorkflowHooks(
     oncePreferences.delete(key)
   }
 
-  console.log(`\n${DIM}Running ${phase}-${command}: ${action}${RESET}`)
+  console.log(`\n${chalk.dim(`Running ${phase}-${command}: ${action}`)}`)
 
   try {
     const startTime = Date.now()
@@ -180,12 +174,12 @@ export async function runWorkflowHooks(
     })
     const elapsed = Date.now() - startTime
     const timeStr = elapsed > 1000 ? `${(elapsed / 1000).toFixed(1)}s` : `${elapsed}ms`
-    console.log(`${GREEN}✓${RESET} ${DIM}(${timeStr})${RESET}`)
+    console.log(`${chalk.green('✓')} ${chalk.dim(`(${timeStr})`)}`)
     return { success: true }
   } catch (error) {
-    console.log(`${RED}✗ failed${RESET}`)
+    console.log(chalk.red('✗ failed'))
     const errorMessage = (error as Error).message || 'Unknown error'
-    console.log(`${DIM}${errorMessage.split('\n')[0]}${RESET}`)
+    console.log(chalk.dim(errorMessage.split('\n')[0]))
     return { success: false, failed: action, output: errorMessage }
   }
 }
@@ -270,7 +264,7 @@ export function formatWorkflowPreferences(
   }>
 ): string {
   if (preferences.length === 0) {
-    return `${DIM}No workflow preferences configured.${RESET}\n\nSet one: "p. workflow antes de ship corre los tests"`
+    return `${chalk.dim('No workflow preferences configured.')}\n\nSet one: "p. workflow antes de ship corre los tests"`
   }
 
   const lines: string[] = ['', 'WORKFLOW PREFERENCES', '────────────────────────────']
@@ -278,17 +272,17 @@ export function formatWorkflowPreferences(
   for (const pref of preferences) {
     const scopeBadge =
       pref.scope === 'permanent'
-        ? `${GREEN}permanent${RESET}`
+        ? chalk.green('permanent')
         : pref.scope === 'session'
-          ? `${YELLOW}session${RESET}`
-          : `${DIM}once${RESET}`
+          ? chalk.yellow('session')
+          : chalk.dim('once')
 
     lines.push(`  [${scopeBadge}] ${pref.key.padEnd(15)} → ${pref.action}`)
   }
 
   lines.push('')
-  lines.push(`${DIM}Modify: "p. workflow antes de ship corre npm test"${RESET}`)
-  lines.push(`${DIM}Remove: "p. workflow quita el hook de ship"${RESET}`)
+  lines.push(chalk.dim('Modify: "p. workflow antes de ship corre npm test"'))
+  lines.push(chalk.dim('Remove: "p. workflow quita el hook de ship"'))
 
   return lines.join('\n')
 }