prjct-cli 0.49.0 → 0.50.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.50.0] - 2026-01-30
+
+### Features
+
+- Unified output system with new methods - PRJ-130 (#76)
+
+
+## [0.50.0] - 2026-01-30
+
+### Added
+
+- **Unified output system with new methods** (PRJ-130)
+  - Added `ICONS` constant for centralized icon definitions
+  - New methods: `info()`, `debug()`, `success()`, `list()`, `table()`, `box()`
+  - `debug()` only shows output when `DEBUG=1`
+  - Refactored existing methods to use `ICONS` for consistency
+
+
 ## [0.49.0] - 2026-01-30
 
 ### Features

package/core/utils/output.ts

@@ -1,9 +1,11 @@
 /**
- * Minimal Output System for prjct-cli
+ * Unified Output System for prjct-cli
  * Spinner while working → Single line result
  * With prjct branding
  *
  * Supports --quiet mode for CI/CD and scripting
+ *
+ * @see PRJ-130
  */
 
 import chalk from 'chalk'
@@ -14,6 +16,22 @@ import { getError } from './error-messages'
 const _FRAMES = branding.spinner.frames
 const SPEED = branding.spinner.speed
 
+/**
+ * Centralized icons for consistent output
+ */
+export const ICONS = {
+  success: chalk.green('✓'),
+  fail: chalk.red('✗'),
+  warn: chalk.yellow('⚠'),
+  info: chalk.blue('ℹ'),
+  debug: chalk.dim('🔧'),
+  bullet: chalk.dim('•'),
+  arrow: chalk.dim('→'),
+  check: chalk.green('✓'),
+  cross: chalk.red('✗'),
+  spinner: chalk.cyan('◐'),
+} as const
+
 let interval: ReturnType<typeof setInterval> | null = null
 let frame = 0
 
@@ -57,6 +75,12 @@ interface Output {
   fail(msg: string): Output
   failWithHint(error: ErrorWithHint | ErrorCode): Output
   warn(msg: string): Output
+  info(msg: string): Output
+  debug(msg: string): Output
+  success(msg: string, metrics?: OutputMetrics): Output
+  list(items: string[], options?: { bullet?: string; indent?: number }): Output
+  table(rows: Array<Record<string, string | number>>, options?: { header?: boolean }): Output
+  box(title: string, content: string): Output
   stop(): Output
   step(current: number, total: number, msg: string): Output
   progress(current: number, total: number, msg?: string): Output
@@ -99,7 +123,7 @@ const out: Output = {
           suffix = chalk.dim(` [${parts.join(' | ')}]`)
         }
       }
-      console.log(`${chalk.green('✓')} ${truncate(msg, 50)}${suffix}`)
+      console.log(`${ICONS.success} ${truncate(msg, 50)}${suffix}`)
     }
     return this
   },
@@ -107,7 +131,7 @@ const out: Output = {
   // Errors go to stderr even in quiet mode
   fail(msg: string) {
     this.stop()
-    console.error(`${chalk.red('✗')} ${truncate(msg, 65)}`)
+    console.error(`${ICONS.fail} ${truncate(msg, 65)}`)
     return this
   },
 
@@ -116,7 +140,7 @@ const out: Output = {
     this.stop()
     const err = typeof error === 'string' ? getError(error) : error
     console.error()
-    console.error(`${chalk.red('✗')} ${err.message}`)
+    console.error(`${ICONS.fail} ${err.message}`)
     if (err.file) {
       console.error(chalk.dim(`  File: ${err.file}`))
     }
@@ -132,7 +156,91 @@ const out: Output = {
 
   warn(msg: string) {
     this.stop()
-    if (!quietMode) console.log(`${chalk.yellow('⚠')} ${truncate(msg, 65)}`)
+    if (!quietMode) console.log(`${ICONS.warn} ${truncate(msg, 65)}`)
+    return this
+  },
+
+  // Informational message
+  info(msg: string) {
+    this.stop()
+    if (!quietMode) console.log(`${ICONS.info} ${msg}`)
+    return this
+  },
+
+  // Debug message (only if DEBUG=1 or DEBUG=true)
+  debug(msg: string) {
+    this.stop()
+    const debugEnabled = process.env.DEBUG === '1' || process.env.DEBUG === 'true'
+    if (!quietMode && debugEnabled) {
+      console.log(`${ICONS.debug} ${chalk.dim(msg)}`)
+    }
+    return this
+  },
+
+  // Alias for done - explicit success indicator
+  success(msg: string, metrics?: OutputMetrics) {
+    return this.done(msg, metrics)
+  },
+
+  // Bulleted list
+  list(items: string[], options: { bullet?: string; indent?: number } = {}) {
+    this.stop()
+    if (quietMode) return this
+    const bullet = options.bullet || ICONS.bullet
+    const indent = ' '.repeat(options.indent || 0)
+    for (const item of items) {
+      console.log(`${indent}${bullet} ${item}`)
+    }
+    return this
+  },
+
+  // Simple table output
+  table(rows: Array<Record<string, string | number>>, options: { header?: boolean } = {}) {
+    this.stop()
+    if (quietMode || rows.length === 0) return this
+
+    const keys = Object.keys(rows[0])
+    const colWidths: Record<string, number> = {}
+
+    // Calculate column widths
+    for (const key of keys) {
+      colWidths[key] = key.length
+      for (const row of rows) {
+        const val = String(row[key] ?? '')
+        if (val.length > colWidths[key]) colWidths[key] = val.length
+      }
+    }
+
+    // Print header if requested
+    if (options.header !== false) {
+      const headerLine = keys.map((k) => k.padEnd(colWidths[k])).join('  ')
+      console.log(chalk.dim(headerLine))
+      console.log(chalk.dim('─'.repeat(headerLine.length)))
+    }
+
+    // Print rows
+    for (const row of rows) {
+      const line = keys.map((k) => String(row[k] ?? '').padEnd(colWidths[k])).join('  ')
+      console.log(line)
+    }
+    return this
+  },
+
+  // Boxed content
+  box(title: string, content: string) {
+    this.stop()
+    if (quietMode) return this
+    const lines = content.split('\n')
+    const maxLen = Math.max(title.length, ...lines.map((l) => l.length))
+    const border = '─'.repeat(maxLen + 2)
+
+    console.log(chalk.dim(`┌${border}┐`))
+    console.log(chalk.dim('│') + ` ${chalk.bold(title.padEnd(maxLen))} ` + chalk.dim('│'))
+    console.log(chalk.dim(`├${border}┤`))
+    for (const line of lines) {
+      console.log(chalk.dim('│') + ` ${line.padEnd(maxLen)} ` + chalk.dim('│'))
+    }
+    console.log(chalk.dim(`└${border}┘`))
     return this
   },
 

package/dist/bin/prjct.mjs

@@ -2065,6 +2065,7 @@ var init_error_messages = __esm({
 var output_exports = {};
 __export(output_exports, {
   ERRORS: () => ERRORS,
+  ICONS: () => ICONS,
   createError: () => createError,
   default: () => output_default,
   getError: () => getError,
@@ -2078,7 +2079,7 @@ function setQuietMode(enabled) {
 function isQuietMode() {
   return quietMode;
 }
-var _FRAMES, SPEED, interval, frame, quietMode, truncate, clear, out, output_default;
+var _FRAMES, SPEED, ICONS, interval, frame, quietMode, truncate, clear, out, output_default;
 var init_output = __esm({
   "core/utils/output.ts"() {
     "use strict";
@@ -2087,6 +2088,18 @@ var init_output = __esm({
     init_error_messages();
     _FRAMES = branding_default.spinner.frames;
     SPEED = branding_default.spinner.speed;
+    ICONS = {
+      success: chalk2.green("\u2713"),
+      fail: chalk2.red("\u2717"),
+      warn: chalk2.yellow("\u26A0"),
+      info: chalk2.blue("\u2139"),
+      debug: chalk2.dim("\u{1F527}"),
+      bullet: chalk2.dim("\u2022"),
+      arrow: chalk2.dim("\u2192"),
+      check: chalk2.green("\u2713"),
+      cross: chalk2.red("\u2717"),
+      spinner: chalk2.cyan("\u25D0")
+    };
     interval = null;
     frame = 0;
     quietMode = false;
@@ -2127,14 +2140,14 @@ var init_output = __esm({
               suffix = chalk2.dim(` [${parts.join(" | ")}]`);
             }
           }
-          console.log(`${chalk2.green("\u2713")} ${truncate(msg, 50)}${suffix}`);
+          console.log(`${ICONS.success} ${truncate(msg, 50)}${suffix}`);
         }
         return this;
       },
       // Errors go to stderr even in quiet mode
       fail(msg) {
         this.stop();
-        console.error(`${chalk2.red("\u2717")} ${truncate(msg, 65)}`);
+        console.error(`${ICONS.fail} ${truncate(msg, 65)}`);
         return this;
       },
       // Rich error with context and recovery hint
@@ -2142,7 +2155,7 @@ var init_output = __esm({
         this.stop();
         const err = typeof error === "string" ? getError(error) : error;
         console.error();
-        console.error(`${chalk2.red("\u2717")} ${err.message}`);
+        console.error(`${ICONS.fail} ${err.message}`);
         if (err.file) {
           console.error(chalk2.dim(`  File: ${err.file}`));
         }
@@ -2157,7 +2170,77 @@ var init_output = __esm({
       },
       warn(msg) {
         this.stop();
-        if (!quietMode) console.log(`${chalk2.yellow("\u26A0")} ${truncate(msg, 65)}`);
+        if (!quietMode) console.log(`${ICONS.warn} ${truncate(msg, 65)}`);
+        return this;
+      },
+      // Informational message
+      info(msg) {
+        this.stop();
+        if (!quietMode) console.log(`${ICONS.info} ${msg}`);
+        return this;
+      },
+      // Debug message (only if DEBUG=1 or DEBUG=true)
+      debug(msg) {
+        this.stop();
+        const debugEnabled = process.env.DEBUG === "1" || process.env.DEBUG === "true";
+        if (!quietMode && debugEnabled) {
+          console.log(`${ICONS.debug} ${chalk2.dim(msg)}`);
+        }
+        return this;
+      },
+      // Alias for done - explicit success indicator
+      success(msg, metrics) {
+        return this.done(msg, metrics);
+      },
+      // Bulleted list
+      list(items, options = {}) {
+        this.stop();
+        if (quietMode) return this;
+        const bullet = options.bullet || ICONS.bullet;
+        const indent = " ".repeat(options.indent || 0);
+        for (const item of items) {
+          console.log(`${indent}${bullet} ${item}`);
+        }
+        return this;
+      },
+      // Simple table output
+      table(rows, options = {}) {
+        this.stop();
+        if (quietMode || rows.length === 0) return this;
+        const keys = Object.keys(rows[0]);
+        const colWidths = {};
+        for (const key of keys) {
+          colWidths[key] = key.length;
+          for (const row of rows) {
+            const val = String(row[key] ?? "");
+            if (val.length > colWidths[key]) colWidths[key] = val.length;
+          }
+        }
+        if (options.header !== false) {
+          const headerLine = keys.map((k) => k.padEnd(colWidths[k])).join("  ");
+          console.log(chalk2.dim(headerLine));
+          console.log(chalk2.dim("\u2500".repeat(headerLine.length)));
+        }
+        for (const row of rows) {
+          const line = keys.map((k) => String(row[k] ?? "").padEnd(colWidths[k])).join("  ");
+          console.log(line);
+        }
+        return this;
+      },
+      // Boxed content
+      box(title, content) {
+        this.stop();
+        if (quietMode) return this;
+        const lines = content.split("\n");
+        const maxLen = Math.max(title.length, ...lines.map((l) => l.length));
+        const border = "\u2500".repeat(maxLen + 2);
+        console.log(chalk2.dim(`\u250C${border}\u2510`));
+        console.log(chalk2.dim("\u2502") + ` ${chalk2.bold(title.padEnd(maxLen))} ` + chalk2.dim("\u2502"));
+        console.log(chalk2.dim(`\u251C${border}\u2524`));
+        for (const line of lines) {
+          console.log(chalk2.dim("\u2502") + ` ${line.padEnd(maxLen)} ` + chalk2.dim("\u2502"));
+        }
+        console.log(chalk2.dim(`\u2514${border}\u2518`));
         return this;
       },
       stop() {
@@ -24220,7 +24303,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.49.0",
+      version: "0.50.0",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {