prjct-cli 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [1.2.1] - 2026-02-06
+
+### Bug Fixes
+
+- replace raw ANSI codes with chalk library (PRJ-132) (#111)
+- replace raw ANSI codes with chalk library (PRJ-132)
+
+
 ## [1.2.0] - 2026-02-06
 
 ### Features
@@ -56,6 +64,46 @@ Hook configuration saved to `project.json` for persistence across sessions.
 **How to use:** Run `prjct hooks install` in any prjct project
 **Breaking changes:** None
 
+## [1.1.2] - 2026-02-05
+
+### Fixed
+
+- **Replace raw ANSI codes with chalk library (PRJ-132)**: Replaced ~60 raw ANSI escape codes across 7 files with chalk library calls
+
+### Implementation Details
+
+Replaced all raw ANSI color/formatting constants (`\x1b[32m`, `\x1b[1m`, etc.) with chalk equivalents (`chalk.green()`, `chalk.bold()`, etc.) in:
+- `bin/prjct.ts` — version display, provider status, welcome message
+- `core/index.ts` — version display, provider status
+- `core/cli/start.ts` — gradient banner using `chalk.rgb()`, setup UI
+- `core/utils/subtask-table.ts` — color palette as chalk functions, progress display
+- `core/utils/help.ts` — all help formatting
+- `core/workflow/workflow-preferences.ts` — hook status display
+- `core/infrastructure/setup.ts` — installation messages
+
+Terminal control sequences (cursor movement, hide/show) kept as raw ANSI since chalk only handles colors/formatting.
+
+### Learnings
+
+- `chalk.rgb(R,G,B)` replaces `\x1b[38;2;R;G;Bm` for true-color support
+- Chalk functions can be stored as array values and called dynamically (useful for color palettes)
+- `chalk.bold.white()` chains work for compound styling
+- Terminal control sequences (`\x1b[?25l`, cursor movement) must stay raw — chalk doesn't handle them
+
+### Test Plan
+
+#### For QA
+1. Run `prjct --version` — verify colored output with provider status
+2. Run `prjct help` — verify formatted help with colors
+3. Run `prjct start --force` — verify gradient banner and colored UI
+4. Set `NO_COLOR=1` and repeat above — verify all color is suppressed
+5. Run `bun run build && bun run typecheck` — verify zero errors
+
+#### For Users
+**What changed:** Terminal colors now use the chalk library instead of raw ANSI codes
+**How to use:** No change — colors appear the same but now respect `NO_COLOR` env variable
+**Breaking changes:** None
+
 ## [1.1.1] - 2026-02-06
 
 ### Bug Fixes

package/bin/prjct.ts

@@ -11,6 +11,7 @@
 import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
+import chalk from 'chalk'
 import { detectAllProviders } from '../core/infrastructure/ai-provider'
 import configManager from '../core/infrastructure/config-manager'
 import editorsConfig from '../core/infrastructure/editors-config'
@@ -61,12 +62,7 @@ if (isQuietMode) {
   setQuietMode(true)
 }
 
-// Colors for output
-const CYAN = '\x1b[36m'
-const YELLOW = '\x1b[33m'
-const DIM = '\x1b[2m'
-const BOLD = '\x1b[1m'
-const RESET = '\x1b[0m'
+// Colors for output (chalk respects NO_COLOR env)
 
 if (args[0] === 'start' || args[0] === 'setup') {
   // Interactive setup with beautiful UI
@@ -206,52 +202,50 @@ if (args[0] === 'start' || args[0] === 'setup') {
   const windsurfDetected = fs.existsSync(path.join(cwd, '.windsurf'))
   const windsurfConfigured = fs.existsSync(path.join(cwd, '.windsurf', 'rules', 'prjct.md'))
 
-  const GREEN = '\x1b[32m'
-
   console.log(`
-${CYAN}p/${RESET} prjct v${VERSION}
-${DIM}Context layer for AI coding agents${RESET}
+${chalk.cyan('p/')} prjct v${VERSION}
+${chalk.dim('Context layer for AI coding agents')}
 
-${DIM}Providers:${RESET}`)
+${chalk.dim('Providers:')}`)
 
   // Claude status
   if (detection.claude.installed) {
-    const status = claudeConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● installed${RESET}`
+    const status = claudeConfigured ? chalk.green('✓ ready') : chalk.yellow('● installed')
     const ver = detection.claude.version ? ` (v${detection.claude.version})` : ''
-    console.log(`  Claude Code   ${status}${DIM}${ver}${RESET}`)
+    console.log(`  Claude Code   ${status}${chalk.dim(ver)}`)
   } else {
-    console.log(`  Claude Code   ${DIM}○ not installed${RESET}`)
+    console.log(`  Claude Code   ${chalk.dim('○ not installed')}`)
   }
 
   // Gemini status
   if (detection.gemini.installed) {
-    const status = geminiConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● installed${RESET}`
+    const status = geminiConfigured ? chalk.green('✓ ready') : chalk.yellow('● installed')
     const ver = detection.gemini.version ? ` (v${detection.gemini.version})` : ''
-    console.log(`  Gemini CLI    ${status}${DIM}${ver}${RESET}`)
+    console.log(`  Gemini CLI    ${status}${chalk.dim(ver)}`)
   } else {
-    console.log(`  Gemini CLI    ${DIM}○ not installed${RESET}`)
+    console.log(`  Gemini CLI    ${chalk.dim('○ not installed')}`)
   }
 
   // Cursor status (project-level)
   if (cursorDetected) {
-    const status = cursorConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● detected${RESET}`
-    console.log(`  Cursor IDE    ${status}${DIM} (project)${RESET}`)
+    const status = cursorConfigured ? chalk.green('✓ ready') : chalk.yellow('● detected')
+    console.log(`  Cursor IDE    ${status}${chalk.dim(' (project)')}`)
   } else {
-    console.log(`  Cursor IDE    ${DIM}○ not detected${RESET}`)
+    console.log(`  Cursor IDE    ${chalk.dim('○ not detected')}`)
   }
 
   // Windsurf status (project-level)
   if (windsurfDetected) {
-    const status = windsurfConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● detected${RESET}`
-    console.log(`  Windsurf IDE  ${status}${DIM} (project)${RESET}`)
+    const status = windsurfConfigured ? chalk.green('✓ ready') : chalk.yellow('● detected')
+    console.log(`  Windsurf IDE  ${status}${chalk.dim(' (project)')}`)
   } else {
-    console.log(`  Windsurf IDE  ${DIM}○ not detected${RESET}`)
+    console.log(`  Windsurf IDE  ${chalk.dim('○ not detected')}`)
   }
 
   console.log(`
-${DIM}Run 'prjct start' to configure (CLI providers)${RESET}
-${DIM}Run 'prjct init' to configure (Cursor/Windsurf IDE)${RESET}
-${CYAN}https://prjct.app${RESET}
+${chalk.dim("Run 'prjct start' to configure (CLI providers)")}
+${chalk.dim("Run 'prjct init' to configure (Cursor/Windsurf IDE)")}
+${chalk.cyan('https://prjct.app')}
 `)
 } else {
   // Check if setup has been done
@@ -261,12 +255,12 @@ ${CYAN}https://prjct.app${RESET}
   if (!fs.existsSync(configPath) || !routersInstalled) {
     // First time - prompt to run start
     console.log(`
-${CYAN}${BOLD}  Welcome to prjct!${RESET}
+${chalk.cyan.bold('  Welcome to prjct!')}
 
-  Run ${BOLD}prjct start${RESET} to configure your AI providers.
+  Run ${chalk.bold('prjct start')} to configure your AI providers.
 
-  ${DIM}This is a one-time setup that lets you choose between
-  Claude Code, Gemini CLI, or both.${RESET}
+  ${chalk.dim(`This is a one-time setup that lets you choose between
+  Claude Code, Gemini CLI, or both.`)}
 `)
     process.exitCode = 0
   } else {
@@ -275,7 +269,7 @@ ${CYAN}${BOLD}  Welcome to prjct!${RESET}
       const lastVersion = await editorsConfig.getLastVersion()
 
       if (lastVersion && lastVersion !== VERSION) {
-        console.log(`\n${YELLOW}ℹ${RESET} Updating prjct v${lastVersion} → v${VERSION}...\n`)
+        console.log(`\n${chalk.yellow('ℹ')} Updating prjct v${lastVersion} → v${VERSION}...\n`)
 
         const { default: setup } = await import('../core/infrastructure/setup')
         await setup.run()

package/core/cli/start.ts

@@ -12,46 +12,35 @@ import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
 import readline from 'node:readline'
+import chalk from 'chalk'
 import { detectAllProviders, Providers } from '../infrastructure/ai-provider'
 import type { AIProviderName } from '../types/provider'
 import { VERSION } from '../utils/version'
 
-// Colors
-const RESET = '\x1b[0m'
-const BOLD = '\x1b[1m'
-const DIM = '\x1b[2m'
-const GREEN = '\x1b[32m'
-const YELLOW = '\x1b[33m'
-const _BLUE = '\x1b[34m'
-const _MAGENTA = '\x1b[35m'
-const CYAN = '\x1b[36m'
-const WHITE = '\x1b[37m'
-const _BG_BLUE = '\x1b[44m'
-
 // True color gradient (cyan -> blue -> purple -> pink)
-const G1 = '\x1b[38;2;0;255;255m' // Cyan
-const G2 = '\x1b[38;2;80;180;255m' // Sky blue
-const G3 = '\x1b[38;2;140;120;255m' // Blue-purple
-const G4 = '\x1b[38;2;200;80;220m' // Purple
-const G5 = '\x1b[38;2;255;80;180m' // Pink
+const G1 = chalk.rgb(0, 255, 255)
+const G2 = chalk.rgb(80, 180, 255)
+const G3 = chalk.rgb(140, 120, 255)
+const G4 = chalk.rgb(200, 80, 220)
+const G5 = chalk.rgb(255, 80, 180)
 
 // Large block letters - PRJCT (7 lines tall)
 const BANNER = `
 
-${G1} ██████╗ ${G2} ██████╗ ${G3}     ██╗${G4} ██████╗${G5}████████╗${RESET}
-${G1} ██╔══██╗${G2} ██╔══██╗${G3}     ██║${G4}██╔════╝${G5}╚══██╔══╝${RESET}
-${G1} ██████╔╝${G2} ██████╔╝${G3}     ██║${G4}██║     ${G5}   ██║   ${RESET}
-${G1} ██╔═══╝ ${G2} ██╔══██╗${G3}██   ██║${G4}██║     ${G5}   ██║   ${RESET}
-${G1} ██║     ${G2} ██║  ██║${G3}╚█████╔╝${G4}╚██████╗${G5}   ██║   ${RESET}
-${G1} ╚═╝     ${G2} ╚═╝  ╚═╝${G3} ╚════╝ ${G4} ╚═════╝${G5}   ╚═╝   ${RESET}
+${G1(' ██████╗ ')}${G2(' ██████╗ ')}${G3('     ██╗')}${G4(' ██████╗')}${G5('████████╗')}
+${G1(' ██╔══██╗')}${G2(' ██╔══██╗')}${G3('     ██║')}${G4('██╔════╝')}${G5('╚══██╔══╝')}
+${G1(' ██████╔╝')}${G2(' ██████╔╝')}${G3('     ██║')}${G4('██║     ')}${G5('   ██║   ')}
+${G1(' ██╔═══╝ ')}${G2(' ██╔══██╗')}${G3('██   ██║')}${G4('██║     ')}${G5('   ██║   ')}
+${G1(' ██║     ')}${G2(' ██║  ██║')}${G3('╚█████╔╝')}${G4('╚██████╗')}${G5('   ██║   ')}
+${G1(' ╚═╝     ')}${G2(' ╚═╝  ╚═╝')}${G3(' ╚════╝ ')}${G4(' ╚═════╝')}${G5('   ╚═╝   ')}
 
 `
 
-const WELCOME_BOX = `  ${WHITE}Context Layer for AI Agents${RESET}  ${DIM}v${VERSION}${RESET}
+const WELCOME_BOX = `  ${chalk.white('Context Layer for AI Agents')}  ${chalk.dim(`v${VERSION}`)}
 
-  ${DIM}Project context layer for AI coding agents.
-  Works with Claude Code, Gemini CLI, and more.${RESET}
-  ${CYAN}https://prjct.app${RESET}
+  ${chalk.dim(`Project context layer for AI coding agents.
+  Works with Claude Code, Gemini CLI, and more.`)}
+  ${chalk.cyan('https://prjct.app')}
 `
 
 interface ProviderOption {
@@ -85,17 +74,14 @@ function showBanner(): void {
  * Show provider selection UI
  */
 function showProviderSelection(options: ProviderOption[], currentIndex: number): void {
-  console.log(`\n${BOLD}  Select AI providers to configure:${RESET}\n`)
-  console.log(`  ${DIM}(Use arrow keys to navigate, space to toggle, enter to confirm)${RESET}\n`)
+  console.log(`\n${chalk.bold('  Select AI providers to configure:')}\n`)
+  console.log(`  ${chalk.dim('(Use arrow keys to navigate, space to toggle, enter to confirm)')}\n`)
 
   options.forEach((option, index) => {
-    const cursor = index === currentIndex ? `${CYAN}❯${RESET}` : ' '
-    const checkbox = option.selected ? `${GREEN}[✓]${RESET}` : `${DIM}[ ]${RESET}`
-    const status = option.installed
-      ? `${GREEN}(installed)${RESET}`
-      : `${YELLOW}(will install)${RESET}`
-    const name =
-      index === currentIndex ? `${BOLD}${option.displayName}${RESET}` : option.displayName
+    const cursor = index === currentIndex ? chalk.cyan('❯') : ' '
+    const checkbox = option.selected ? chalk.green('[✓]') : chalk.dim('[ ]')
+    const status = option.installed ? chalk.green('(installed)') : chalk.yellow('(will install)')
+    const name = index === currentIndex ? chalk.bold(option.displayName) : option.displayName
 
     console.log(`  ${cursor} ${checkbox} ${name} ${status}`)
   })
@@ -131,10 +117,10 @@ async function selectProviders(): Promise<AIProviderName[]> {
 
   // Non-interactive mode: auto-select detected providers
   if (!process.stdin.isTTY) {
-    console.log(`\n${BOLD}  Detected providers:${RESET}\n`)
+    console.log(`\n${chalk.bold('  Detected providers:')}\n`)
     options.forEach((option) => {
       if (option.installed) {
-        console.log(`  ${GREEN}✓${RESET} ${option.displayName}`)
+        console.log(`  ${chalk.green('✓')} ${option.displayName}`)
       }
     })
     console.log('')
@@ -230,7 +216,7 @@ async function installRouter(provider: AIProviderName): Promise<boolean> {
     return false
   } catch (error) {
     console.error(
-      `  ${YELLOW}⚠${RESET} Failed to install ${provider} router: ${(error as Error).message}`
+      `  ${chalk.yellow('⚠')} Failed to install ${provider} router: ${(error as Error).message}`
     )
     return false
   }
@@ -294,7 +280,7 @@ async function installGlobalConfig(provider: AIProviderName): Promise<boolean> {
     return false
   } catch (error) {
     console.error(
-      `  ${YELLOW}⚠${RESET} Failed to install ${provider} config: ${(error as Error).message}`
+      `  ${chalk.yellow('⚠')} Failed to install ${provider} config: ${(error as Error).message}`
     )
     return false
   }
@@ -324,27 +310,27 @@ async function saveSetupConfig(providers: AIProviderName[]): Promise<void> {
  * Show completion message
  */
 function showCompletion(providers: AIProviderName[]): void {
-  console.log(`\n${GREEN}${BOLD}  ✓ Setup complete!${RESET}\n`)
+  console.log(`\n${chalk.green.bold('  ✓ Setup complete!')}\n`)
 
-  console.log(`  ${DIM}Configured providers:${RESET}`)
+  console.log(`  ${chalk.dim('Configured providers:')}`)
   providers.forEach((p) => {
     const config = Providers[p]
-    console.log(`    ${GREEN}✓${RESET} ${config.displayName}`)
+    console.log(`    ${chalk.green('✓')} ${config.displayName}`)
   })
 
   console.log(`
-  ${BOLD}Next steps:${RESET}
+  ${chalk.bold('Next steps:')}
 
-  ${CYAN}1.${RESET} Navigate to your project directory
-  ${CYAN}2.${RESET} Run ${BOLD}p. init${RESET} to initialize prjct for that project
-  ${CYAN}3.${RESET} Start tracking with ${BOLD}p. task "your task"${RESET}
+  ${chalk.cyan('1.')} Navigate to your project directory
+  ${chalk.cyan('2.')} Run ${chalk.bold('p. init')} to initialize prjct for that project
+  ${chalk.cyan('3.')} Start tracking with ${chalk.bold('p. task "your task"')}
 
-  ${DIM}Tips:${RESET}
-  ${DIM}•${RESET} Use ${BOLD}p. sync${RESET} to analyze your codebase
-  ${DIM}•${RESET} Use ${BOLD}p. done${RESET} to complete tasks
-  ${DIM}•${RESET} Use ${BOLD}p. ship${RESET} to create PRs
+  ${chalk.dim('Tips:')}
+  ${chalk.dim('•')} Use ${chalk.bold('p. sync')} to analyze your codebase
+  ${chalk.dim('•')} Use ${chalk.bold('p. done')} to complete tasks
+  ${chalk.dim('•')} Use ${chalk.bold('p. ship')} to create PRs
 
-  ${DIM}Learn more: https://prjct.app/docs${RESET}
+  ${chalk.dim('Learn more: https://prjct.app/docs')}
 `)
 }
 
@@ -359,8 +345,8 @@ export async function runStart(): Promise<void> {
   if (fs.existsSync(configPath)) {
     const existing = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
     if (existing.version === VERSION) {
-      console.log(`  ${YELLOW}ℹ${RESET} Already configured for v${VERSION}`)
-      console.log(`  ${DIM}Run with --force to reconfigure${RESET}\n`)
+      console.log(`  ${chalk.yellow('ℹ')} Already configured for v${VERSION}`)
+      console.log(`  ${chalk.dim('Run with --force to reconfigure')}\n`)
 
       if (!process.argv.includes('--force')) {
         return
@@ -371,22 +357,22 @@ export async function runStart(): Promise<void> {
   // Select providers
   const selectedProviders = await selectProviders()
 
-  console.log(`\n  ${CYAN}Setting up...${RESET}\n`)
+  console.log(`\n  ${chalk.cyan('Setting up...')}\n`)
 
   // Install for each selected provider
   for (const provider of selectedProviders) {
     const config = Providers[provider]
-    process.stdout.write(`  ${DIM}•${RESET} ${config.displayName}... `)
+    process.stdout.write(`  ${chalk.dim('•')} ${config.displayName}... `)
 
     const routerOk = await installRouter(provider)
     const configOk = await installGlobalConfig(provider)
 
     if (routerOk && configOk) {
-      console.log(`${GREEN}✓${RESET}`)
+      console.log(chalk.green('✓'))
     } else if (routerOk || configOk) {
-      console.log(`${YELLOW}partial${RESET}`)
+      console.log(chalk.yellow('partial'))
     } else {
-      console.log(`${YELLOW}skipped${RESET}`)
+      console.log(chalk.yellow('skipped'))
     }
   }
 

package/core/index.ts

@@ -10,6 +10,7 @@ import './commands/register' // Ensure commands are registered
 import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
+import chalk from 'chalk'
 import type { CommandMeta } from './commands/registry'
 import { detectAllProviders, detectAntigravity } from './infrastructure/ai-provider'
 import out from './utils/output'
@@ -195,12 +196,7 @@ function parseCommandArgs(_cmd: CommandMeta, rawArgs: string[]): ParsedCommandAr
   return { parsedArgs, options }
 }
 
-// Colors for version display
-const CYAN = '\x1b[36m'
-const GREEN = '\x1b[32m'
-const YELLOW = '\x1b[33m'
-const DIM = '\x1b[2m'
-const RESET = '\x1b[0m'
+// Colors via chalk (respects NO_COLOR env)
 
 /**
  * Display version with provider status
@@ -219,53 +215,53 @@ function displayVersion(version: string): void {
   const cursorExists = fs.existsSync(path.join(process.cwd(), '.cursor'))
 
   console.log(`
-${CYAN}p/${RESET} prjct v${version}
-${DIM}Context layer for AI coding agents${RESET}
+${chalk.cyan('p/')} prjct v${version}
+${chalk.dim('Context layer for AI coding agents')}
 
-${DIM}Providers:${RESET}`)
+${chalk.dim('Providers:')}`)
 
   // Claude status
   if (detection.claude.installed) {
-    const status = claudeConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● installed${RESET}`
+    const status = claudeConfigured ? chalk.green('✓ ready') : chalk.yellow('● installed')
     const ver = detection.claude.version ? ` (v${detection.claude.version})` : ''
-    console.log(`  Claude Code   ${status}${DIM}${ver}${RESET}`)
+    console.log(`  Claude Code   ${status}${chalk.dim(ver)}`)
   } else {
-    console.log(`  Claude Code   ${DIM}○ not installed${RESET}`)
+    console.log(`  Claude Code   ${chalk.dim('○ not installed')}`)
   }
 
   // Gemini status
   if (detection.gemini.installed) {
-    const status = geminiConfigured ? `${GREEN}✓ ready${RESET}` : `${YELLOW}● installed${RESET}`
+    const status = geminiConfigured ? chalk.green('✓ ready') : chalk.yellow('● installed')
     const ver = detection.gemini.version ? ` (v${detection.gemini.version})` : ''
-    console.log(`  Gemini CLI    ${status}${DIM}${ver}${RESET}`)
+    console.log(`  Gemini CLI    ${status}${chalk.dim(ver)}`)
   } else {
-    console.log(`  Gemini CLI    ${DIM}○ not installed${RESET}`)
+    console.log(`  Gemini CLI    ${chalk.dim('○ not installed')}`)
   }
 
   // Antigravity status (global, skills-based)
   const antigravityDetection = detectAntigravity()
   if (antigravityDetection.installed) {
     const status = antigravityDetection.skillInstalled
-      ? `${GREEN}✓ ready${RESET}`
-      : `${YELLOW}● detected${RESET}`
-    const hint = antigravityDetection.skillInstalled ? '' : ` ${DIM}(run prjct start)${RESET}`
+      ? chalk.green('✓ ready')
+      : chalk.yellow('● detected')
+    const hint = antigravityDetection.skillInstalled ? '' : ` ${chalk.dim('(run prjct start)')}`
     console.log(`  Antigravity   ${status}${hint}`)
   } else {
-    console.log(`  Antigravity   ${DIM}○ not installed${RESET}`)
+    console.log(`  Antigravity   ${chalk.dim('○ not installed')}`)
   }
 
   // Cursor status (project-level, but shown in same format)
   if (cursorConfigured) {
-    console.log(`  Cursor IDE    ${GREEN}✓ ready${RESET} ${DIM}(use /sync, /task)${RESET}`)
+    console.log(`  Cursor IDE    ${chalk.green('✓ ready')} ${chalk.dim('(use /sync, /task)')}`)
   } else if (cursorExists) {
-    console.log(`  Cursor IDE    ${YELLOW}● detected${RESET} ${DIM}(run prjct init)${RESET}`)
+    console.log(`  Cursor IDE    ${chalk.yellow('● detected')} ${chalk.dim('(run prjct init)')}`)
   } else {
-    console.log(`  Cursor IDE    ${DIM}○ no .cursor/ folder${RESET}`)
+    console.log(`  Cursor IDE    ${chalk.dim('○ no .cursor/ folder')}`)
   }
 
   console.log(`
-${DIM}Run 'prjct start' for Claude/Gemini, 'prjct init' for Cursor${RESET}
-${CYAN}https://prjct.app${RESET}
+${chalk.dim("Run 'prjct start' for Claude/Gemini, 'prjct init' for Cursor")}
+${chalk.cyan('https://prjct.app')}
 `)
 }
 

package/core/infrastructure/setup.ts

@@ -21,6 +21,7 @@ import { execSync } from 'node:child_process'
 import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
+import chalk from 'chalk'
 import { getTimeout } from '../constants'
 import { dependencyValidator } from '../services/dependency-validator'
 import { isNotFoundError } from '../types/fs'
@@ -36,12 +37,6 @@ import {
 import installer from './command-installer'
 import editorsConfig from './editors-config'
 
-// Colors
-const GREEN = '\x1b[32m'
-const YELLOW = '\x1b[33m'
-const DIM = '\x1b[2m'
-const NC = '\x1b[0m'
-
 interface ProviderSetupResult {
   provider: AIProviderName
   cliInstalled: boolean
@@ -77,20 +72,22 @@ async function installAICLI(provider: AIProviderConfig): Promise<boolean> {
 
   // PRJ-114: Check npm availability first
   if (!dependencyValidator.isAvailable('npm')) {
-    console.log(`${YELLOW}⚠️  npm is not available${NC}`)
+    console.log(`${chalk.yellow('⚠️  npm is not available')}`)
     console.log('')
-    console.log(`${DIM}Install ${provider.displayName} using one of:${NC}`)
-    console.log(`${DIM}  • Install Node.js: https://nodejs.org${NC}`)
+    console.log(`${chalk.dim(`Install ${provider.displayName} using one of:`)}`)
+    console.log(chalk.dim('  • Install Node.js: https://nodejs.org'))
     console.log(
-      `${DIM}  • Use Homebrew: brew install ${provider.name === 'claude' ? 'claude' : 'gemini'}${NC}`
+      chalk.dim(
+        `  • Use Homebrew: brew install ${provider.name === 'claude' ? 'claude' : 'gemini'}`
+      )
     )
-    console.log(`${DIM}  • Use npx directly: npx ${packageName}${NC}`)
+    console.log(chalk.dim(`  • Use npx directly: npx ${packageName}`))
     console.log('')
     return false
   }
 
   try {
-    console.log(`${YELLOW}📦 ${provider.displayName} not found. Installing...${NC}`)
+    console.log(chalk.yellow(`📦 ${provider.displayName} not found. Installing...`))
     console.log('')
     // PRJ-111: Add timeout to npm install (default: 2 minutes, configurable via PRJCT_TIMEOUT_NPM_INSTALL)
     execSync(`npm install -g ${packageName}`, {
@@ -98,7 +95,7 @@ async function installAICLI(provider: AIProviderConfig): Promise<boolean> {
       timeout: getTimeout('NPM_INSTALL'),
     })
     console.log('')
-    console.log(`${GREEN}✓${NC} ${provider.displayName} installed successfully`)
+    console.log(`${chalk.green('✓')} ${provider.displayName} installed successfully`)
     console.log('')
     return true
   } catch (error) {
@@ -106,21 +103,21 @@ async function installAICLI(provider: AIProviderConfig): Promise<boolean> {
     const isTimeout = err.killed && err.signal === 'SIGTERM'
 
     if (isTimeout) {
-      console.log(`${YELLOW}⚠️  Installation timed out for ${provider.displayName}${NC}`)
+      console.log(chalk.yellow(`⚠️  Installation timed out for ${provider.displayName}`))
       console.log('')
-      console.log(`${DIM}The npm install took too long. Try:${NC}`)
-      console.log(`${DIM}  • Set PRJCT_TIMEOUT_NPM_INSTALL=300000 for 5 minutes${NC}`)
-      console.log(`${DIM}  • Run manually: npm install -g ${packageName}${NC}`)
+      console.log(chalk.dim('The npm install took too long. Try:'))
+      console.log(chalk.dim('  • Set PRJCT_TIMEOUT_NPM_INSTALL=300000 for 5 minutes'))
+      console.log(chalk.dim(`  • Run manually: npm install -g ${packageName}`))
     } else {
-      console.log(`${YELLOW}⚠️  Failed to install ${provider.displayName}: ${err.message}${NC}`)
+      console.log(chalk.yellow(`⚠️  Failed to install ${provider.displayName}: ${err.message}`))
     }
     console.log('')
-    console.log(`${DIM}Alternative installation methods:${NC}`)
-    console.log(`${DIM}  • npm:  npm install -g ${packageName}${NC}`)
-    console.log(`${DIM}  • yarn: yarn global add ${packageName}${NC}`)
-    console.log(`${DIM}  • pnpm: pnpm add -g ${packageName}${NC}`)
+    console.log(chalk.dim('Alternative installation methods:'))
+    console.log(chalk.dim(`  • npm:  npm install -g ${packageName}`))
+    console.log(chalk.dim(`  • yarn: yarn global add ${packageName}`))
+    console.log(chalk.dim(`  • pnpm: pnpm add -g ${packageName}`))
     console.log(
-      `${DIM}  • brew: brew install ${provider.name === 'claude' ? 'claude' : 'gemini'}${NC}`
+      chalk.dim(`  • brew: brew install ${provider.name === 'claude' ? 'claude' : 'gemini'}`)
     )
     console.log('')
     return false
@@ -232,7 +229,7 @@ export async function run(): Promise<SetupResults> {
   if (antigravityDetection.installed) {
     const antigravityResult = await installAntigravitySkill()
     if (antigravityResult.success) {
-      console.log(`   ${GREEN}✓${NC} Antigravity skill installed`)
+      console.log(`   ${chalk.green('✓')} Antigravity skill installed`)
     }
   }
 
@@ -733,7 +730,7 @@ async function migrateProjectsCliVersion(): Promise<void> {
     }
 
     if (migrated > 0) {
-      console.log(`   ${GREEN}✓${NC} Updated ${migrated} project(s) to v${VERSION}`)
+      console.log(`   ${chalk.green('✓')} Updated ${migrated} project(s) to v${VERSION}`)
     }
   } catch (error) {
     // Silently fail if projects directory doesn't exist
@@ -1029,9 +1026,9 @@ function showResults(results: ProviderSetupResult, provider: AIProviderConfig):
   console.log('')
 
   if (results.cliInstalled) {
-    console.log(`   ${GREEN}✓${NC} ${provider.displayName} CLI installed`)
+    console.log(`   ${chalk.green('✓')} ${provider.displayName} CLI installed`)
   } else {
-    console.log(`   ${GREEN}✓${NC} ${provider.displayName} CLI found`)
+    console.log(`   ${chalk.green('✓')} ${provider.displayName} CLI found`)
   }
 
   const totalCommands = results.commandsAdded + results.commandsUpdated
@@ -1039,17 +1036,17 @@ function showResults(results: ProviderSetupResult, provider: AIProviderConfig):
     const parts: string[] = []
     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(', ')})`)
+    console.log(`   ${chalk.green('✓')} Commands synced (${parts.join(', ')})`)
   } else {
-    console.log(`   ${GREEN}✓${NC} Commands up to date`)
+    console.log(`   ${chalk.green('✓')} Commands up to date`)
   }
 
   if (results.configAction === 'created') {
-    console.log(`   ${GREEN}✓${NC} Global config created (${provider.contextFile})`)
+    console.log(`   ${chalk.green('✓')} Global config created (${provider.contextFile})`)
   } else if (results.configAction === 'updated') {
-    console.log(`   ${GREEN}✓${NC} Global config updated (${provider.contextFile})`)
+    console.log(`   ${chalk.green('✓')} Global config updated (${provider.contextFile})`)
   } else if (results.configAction === 'appended') {
-    console.log(`   ${GREEN}✓${NC} Global config merged (${provider.contextFile})`)
+    console.log(`   ${chalk.green('✓')} Global config merged (${provider.contextFile})`)
   }
 
   console.log('')

package/core/schemas/ideas.ts

@@ -33,7 +33,7 @@ export const TechStackSchema = z.object({
 
 export const IdeaModuleSchema = z.object({
   name: z.string(), // "Multi-tenant"
-  description: z.string(), // "Empresas con RLS estricto"
+  description: z.string(), // "Strict RLS for organizations"
 })
 
 export const IdeaRoleSchema = z.object({