clavix 2.4.1 → 2.4.3

package/bin/clavix.js

@@ -1,15 +1,24 @@
 #!/usr/bin/env node
 
+// Disable debug mode (stack traces) unless explicitly requested via DEBUG env var
+if (!process.env.DEBUG) {
+  require('@oclif/core').settings.debug = false;
+}
+
+// Custom error handler to suppress stack traces
+async function handleError(error) {
+  // For CLIError, show only the formatted message
+  if (error.oclif && error.oclif.exit !== undefined) {
+    // Format error message (hints are now included in error.message)
+    console.error(' ›   Error: ' + error.message);
+    process.exit(error.oclif.exit);
+  }
+
+  // For other errors, use default handler
+  const { handle } = require('@oclif/core');
+  return handle(error);
+}
+
 require('../dist/index.js')
   .run()
-  .catch((error) => {
-    // ExitError from OCLIF is thrown when this.error() is called
-    // It already displays the error message, so we just exit with the code
-    if (error.oclif && error.oclif.exit !== undefined) {
-      process.exit(error.oclif.exit);
-    }
-
-    // For other errors, display them
-    console.error(error);
-    process.exit(1);
-  });
+  .catch(handleError);

package/dist/cli/commands/implement.js

@@ -67,9 +67,7 @@ class Implement extends core_1.Command {
                 const prdPath = await manager.findPrdDirectory(flags.project);
                 tasksPath = path.join(prdPath, 'tasks.md');
                 if (!(await fs.pathExists(tasksPath))) {
-                    this.error(chalk_1.default.red('Error: No tasks.md found!') +
-                        '\n\n' +
-                        chalk_1.default.yellow('Hint: Run ') + chalk_1.default.cyan('clavix plan') + chalk_1.default.yellow(' first to generate task breakdown'));
+                    this.error('No tasks.md found\n\nHint: Run "clavix plan" first to generate task breakdown');
                 }
                 console.log(chalk_1.default.dim(`Found: ${tasksPath}\n`));
             }
@@ -187,13 +185,7 @@ class Implement extends core_1.Command {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'An unexpected error occurred';
-            let fullMessage = chalk_1.default.red(`Error: ${errorMessage}`);
-            // Provide helpful hints
-            if (error instanceof Error && error.message.includes('tasks.md')) {
-                fullMessage += '\n\n' + chalk_1.default.yellow('Hint: Make sure you have generated a task plan first') +
-                    '\n' + chalk_1.default.gray('Run ') + chalk_1.default.cyan('clavix plan') + chalk_1.default.gray(' to create tasks.md');
-            }
-            this.error(fullMessage);
+            this.error(errorMessage);
         }
     }
     /**
@@ -240,9 +232,7 @@ class Implement extends core_1.Command {
         }
         // No PRD projects found
         if (prdProjects.length === 0) {
-            this.error(chalk_1.default.yellow('Warning: No PRD projects found in .clavix/outputs/') +
-                '\n\n' +
-                chalk_1.default.gray('Hint: Create a PRD first using ') + chalk_1.default.cyan('clavix prd'));
+            this.error('No PRD projects found in .clavix/outputs/\n\nHint: Create a PRD first using: clavix prd');
         }
         // Only one PRD - auto-select
         if (prdProjects.length === 1) {
@@ -325,7 +315,7 @@ class Implement extends core_1.Command {
             }
             catch (error) {
                 const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-                this.error(chalk_1.default.red(`Error running clavix plan: ${errorMessage}`));
+                this.error(`Running clavix plan failed: ${errorMessage}`);
             }
         }
         else {

package/dist/cli/commands/plan.js

@@ -69,9 +69,11 @@ class Plan extends core_1.Command {
             if (!prdPath) {
                 selectedProject = await this.resolveProjectDirectory(manager, flags.project);
                 if (!selectedProject) {
-                    this.error(chalk_1.default.red('Error: No PRD projects found in .clavix/outputs/') +
-                        '\n\n' +
-                        chalk_1.default.gray("Hint: Run 'clavix prd' to generate a PRD, 'clavix summarize' to create a mini-PRD, or use 'clavix plan --session <id>'"));
+                    this.error('No PRD projects found in .clavix/outputs/\n\n' +
+                        'Hints:\n' +
+                        '  • Run "clavix prd" to generate a PRD\n' +
+                        '  • Run "clavix summarize" to create a mini-PRD\n' +
+                        '  • Use "clavix plan --session <id>" to plan from a session');
                 }
                 prdPath = selectedProject.path;
                 projectName = selectedProject.name;
@@ -91,14 +93,16 @@ class Plan extends core_1.Command {
             console.log(chalk_1.default.dim('Looking for PRD artifacts...'));
             const availableSources = await manager.detectAvailableSources(prdPath);
             if (availableSources.length === 0) {
-                this.error(chalk_1.default.red('Error: No PRD artifacts found in this directory') +
-                    '\n\n' +
-                    chalk_1.default.gray('Hint: Generate a PRD with clavix prd, run clavix summarize, or supply a session via --session'));
+                this.error('No PRD artifacts found in this directory\n\n' +
+                    'Hints:\n' +
+                    '  • Generate a PRD with: clavix prd\n' +
+                    '  • Create a mini-PRD with: clavix summarize\n' +
+                    '  • Plan from a session with: clavix plan --session <id>');
             }
             if (sourcePreference !== 'auto' && !availableSources.includes(sourcePreference)) {
-                this.error(chalk_1.default.red(`Error: Preferred source "${sourcePreference}" not found in ${prdPath}`) +
-                    '\n\n' +
-                    chalk_1.default.gray(`Hint: Available sources: ${availableSources.join(', ') || 'none'}. Override with --source`));
+                this.error(`Preferred source "${sourcePreference}" not found in ${prdPath}\n\n` +
+                    `Available sources: ${availableSources.join(', ') || 'none'}\n` +
+                    'Hint: Override with --source flag');
             }
             if (availableSources.length > 1 && sourcePreference === 'auto') {
                 console.log(chalk_1.default.dim(`Found multiple sources (${availableSources.join(', ')}). Selecting best match...`));
@@ -159,26 +163,7 @@ class Plan extends core_1.Command {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'An unexpected error occurred';
-            let fullMessage = chalk_1.default.red(`Error: ${errorMessage}`);
-            if (error instanceof Error) {
-                if (error.message.includes('Session has no messages')) {
-                    fullMessage += '\n\n' + chalk_1.default.gray('Hint: Add conversation messages with clavix start before running plan --session');
-                }
-                else if (error.message.includes('Session not found')) {
-                    fullMessage += '\n\n' + chalk_1.default.gray('Hint: Check the session ID with clavix list');
-                }
-                else if (error.message.includes('No active session')) {
-                    fullMessage += '\n\n' + chalk_1.default.gray('Hint: Start a session with clavix start before using --active-session');
-                }
-                else if (error.message.includes('PRD project not found')) {
-                    fullMessage += '\n\n' + chalk_1.default.gray("Hint: Run 'clavix list' to see available outputs or specify a valid project name");
-                }
-                else if (error.message.includes('No PRD')) {
-                    fullMessage += '\n\n' + chalk_1.default.yellow('Hint: Create a PRD first') +
-                        '\n' + chalk_1.default.gray('Run ') + chalk_1.default.cyan('clavix prd') + chalk_1.default.gray(' to generate a new PRD');
-                }
-            }
-            this.error(fullMessage);
+            this.error(errorMessage);
         }
     }
     validateSessionFlags(session, activeSession) {

package/dist/cli/commands/prd.js

@@ -138,7 +138,7 @@ class Prd extends core_1.Command {
                 if (answer && answer.toString().trim() && question) {
                     const submitResult = engine.submitAnswer(question.id, answer);
                     if (submitResult !== true) {
-                        console.log(chalk_1.default.red(`\nError: ${submitResult}\n`));
+                        console.log(chalk_1.default.red(`\n${submitResult}\n`));
                         continue; // Ask again
                     }
                     answers[question.id] = answer;
@@ -173,7 +173,7 @@ class Prd extends core_1.Command {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'An unexpected error occurred';
-            this.error(chalk_1.default.red(`Error: ${errorMessage}`));
+            this.error(errorMessage);
         }
     }
     /**

package/dist/cli/commands/start.js

@@ -72,7 +72,7 @@ class Start extends core_1.Command {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'An unexpected error occurred';
-            this.error(chalk_1.default.red(`Error: ${errorMessage}`));
+            this.error(errorMessage);
         }
     }
     /**

package/dist/cli/commands/summarize.js

@@ -56,28 +56,25 @@ class Summarize extends core_1.Command {
                 console.log(chalk_1.default.dim(`Loading session ${args.sessionId}...\n`));
                 session = await manager.getSession(args.sessionId);
                 if (!session) {
-                    this.error(chalk_1.default.red(`Error: Session not found: ${args.sessionId}`));
+                    this.error(`Session not found: ${args.sessionId}`);
                 }
             }
             else if (flags.active) {
                 console.log(chalk_1.default.dim('Loading most recent active session...\n'));
                 session = await manager.getActiveSession();
                 if (!session) {
-                    this.error(chalk_1.default.red('Error: No active session found') +
-                        '\n\n' +
-                        chalk_1.default.gray('Hint: Use ') + chalk_1.default.cyan('clavix list') + chalk_1.default.gray(' to see all sessions'));
+                    this.error('No active session found\n\nHint: Use "clavix list" to see all sessions');
                 }
             }
             else {
                 // Try to get active session by default
                 session = await manager.getActiveSession();
                 if (!session) {
-                    this.error(chalk_1.default.yellow('Warning: No active session found') +
-                        '\n\n' +
-                        chalk_1.default.gray('Usage:') +
-                        '\n' + chalk_1.default.gray('  • ') + chalk_1.default.cyan('clavix summarize <session-id>') + chalk_1.default.gray(' - Summarize specific session') +
-                        '\n' + chalk_1.default.gray('  • ') + chalk_1.default.cyan('clavix summarize --active') + chalk_1.default.gray(' - Summarize most recent active session') +
-                        '\n' + chalk_1.default.gray('  • ') + chalk_1.default.cyan('clavix list') + chalk_1.default.gray(' - View all sessions'));
+                    this.error('No active session found\n\n' +
+                        'Usage:\n' +
+                        '  • clavix summarize <session-id> - Summarize specific session\n' +
+                        '  • clavix summarize --active - Summarize most recent active session\n' +
+                        '  • clavix list - View all sessions');
                 }
             }
             // Display session info
@@ -89,7 +86,7 @@ class Summarize extends core_1.Command {
             console.log();
             // Check if session has messages
             if (session.messages.length === 0) {
-                this.error(chalk_1.default.yellow('Warning: Session has no messages to analyze'));
+                this.error('Session has no messages to analyze');
             }
             // Analyze conversation
             console.log(chalk_1.default.dim('Analyzing conversation...\n'));
@@ -138,7 +135,7 @@ class Summarize extends core_1.Command {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'An unexpected error occurred';
-            this.error(chalk_1.default.red(`Error: ${errorMessage}`));
+            this.error(errorMessage);
         }
     }
     /**

package/dist/index.js

@@ -4,19 +4,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.run = run;
 const core_1 = require("@oclif/core");
 async function run(argv) {
+    // Disable debug mode (stack traces) unless explicitly requested via DEBUG env var
+    if (!process.env.DEBUG) {
+        core_1.settings.debug = false;
+    }
     return (0, core_1.run)(argv);
 }
 // Run if called directly
 if (require.main === module) {
-    run().catch((error) => {
-        // ExitError from OCLIF is thrown when this.error() is called
-        // It already displays the error message, so we just exit with the code
-        if (error.oclif && error.oclif.exit !== undefined) {
-            process.exit(error.oclif.exit);
-        }
-        // For other errors, display them
-        console.error(error);
-        process.exit(1);
-    });
+    run().catch(core_1.handle);
 }
 //# sourceMappingURL=index.js.map

package/dist/utils/template-loader.d.ts

@@ -1,3 +1,3 @@
 import { AgentAdapter, CommandTemplate } from '../types/agent';
-export declare function loadCommandTemplates(adapter: AgentAdapter): Promise<CommandTemplate[]>;
+export declare function loadCommandTemplates(_adapter: AgentAdapter): Promise<CommandTemplate[]>;
 //# sourceMappingURL=template-loader.d.ts.map

package/dist/utils/template-loader.js

@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadCommandTemplates = loadCommandTemplates;
 const path = __importStar(require("path"));
 const file_system_1 = require("./file-system");
-async function loadCommandTemplates(adapter) {
+async function loadCommandTemplates(_adapter) {
     // Load from canonical template source (always .md files)
     const templatesDir = getCanonicalTemplatesDirectory();
     const files = await file_system_1.FileSystem.listFiles(templatesDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "description": "Transform vague ideas into production-ready prompts. CLI tool using the CLEAR framework to analyze, improve, and generate PRDs for AI coding assistants (Claude Code, Cursor, Windsurf, and more)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",