clavix 5.5.1 → 5.6.0

package/dist/utils/agent-error-messages.d.ts

@@ -82,5 +82,30 @@ export declare class AgentErrorMessages {
      * Used by: implement workflow when marking already-done task
      */
     static taskAlreadyCompleted(taskId: string): string;
+    /**
+     * Error: Template not found
+     * Used by: template-loader.ts, commands generating slash commands
+     */
+    static templateNotFound(templateName: string, searchPath?: string): string;
+    /**
+     * Error: Adapter/integration not found
+     * Used by: agent-manager.ts, init.ts
+     */
+    static adapterNotFound(adapterName: string, availableAdapters?: string[]): string;
+    /**
+     * Error: Configuration loading failed
+     * Used by: init.ts, update.ts when .clavix/config.json is invalid
+     */
+    static configLoadFailed(configPath: string, reason?: string): string;
+    /**
+     * Error: Update command failed
+     * Used by: update.ts when template regeneration fails
+     */
+    static updateFailed(reason: string): string;
+    /**
+     * Error: Diagnostic check failed
+     * Used by: diagnose.ts when health check identifies issues
+     */
+    static diagnosticFailed(issues: string[]): string;
 }
 //# sourceMappingURL=agent-error-messages.d.ts.map

package/dist/utils/agent-error-messages.js

@@ -17,7 +17,7 @@ export class AgentErrorMessages {
             'Agent recovery options:\n' +
             '  1. Execute /clavix:prd to generate comprehensive PRD\n' +
             '  2. Execute /clavix:summarize if conversation exists\n\n' +
-            'Select option and execute, then retry this command.');
+            'Select option and run, then retry this command.');
     }
     /**
      * Error: No tasks.md found for specified project
@@ -191,5 +191,73 @@ export class AgentErrorMessages {
             '  3. Check if this was intended\n\n' +
             'No action needed unless forced.');
     }
+    /**
+     * Error: Template not found
+     * Used by: template-loader.ts, commands generating slash commands
+     */
+    static templateNotFound(templateName, searchPath) {
+        const pathInfo = searchPath ? `\nSearch path: ${searchPath}` : '';
+        return (`Template not found: ${templateName}${pathInfo}\n\n` +
+            'Agent recovery options:\n' +
+            "  1. Run 'clavix update' to regenerate templates\n" +
+            '  2. Check if Clavix is installed correctly\n' +
+            '  3. Verify template name is spelled correctly\n\n' +
+            'After recovery, retry the command.');
+    }
+    /**
+     * Error: Adapter/integration not found
+     * Used by: agent-manager.ts, init.ts
+     */
+    static adapterNotFound(adapterName, availableAdapters) {
+        const adapterList = availableAdapters
+            ? '\n\nAvailable adapters:\n' + availableAdapters.map((a) => `  • ${a}`).join('\n')
+            : '';
+        return (`Adapter not found: ${adapterName}${adapterList}\n\n` +
+            'Agent recovery options:\n' +
+            '  1. Check adapter name is spelled correctly\n' +
+            "  2. Run 'clavix diagnose' to see available integrations\n" +
+            '  3. Adapter may have been removed or renamed\n\n' +
+            'Use a valid adapter name and retry.');
+    }
+    /**
+     * Error: Configuration loading failed
+     * Used by: init.ts, update.ts when .clavix/config.json is invalid
+     */
+    static configLoadFailed(configPath, reason) {
+        const reasonInfo = reason ? `\nReason: ${reason}` : '';
+        return (`Failed to load configuration: ${configPath}${reasonInfo}\n\n` +
+            'Agent recovery options:\n' +
+            "  1. Run 'clavix init' to regenerate configuration\n" +
+            '  2. Check .clavix/config.json syntax is valid JSON\n' +
+            '  3. Remove .clavix/ and reinitialize\n\n' +
+            'After fixing configuration, retry the command.');
+    }
+    /**
+     * Error: Update command failed
+     * Used by: update.ts when template regeneration fails
+     */
+    static updateFailed(reason) {
+        return (`Update failed: ${reason}\n\n` +
+            'Agent recovery options:\n' +
+            '  1. Check Clavix is installed correctly: clavix --version\n' +
+            '  2. Verify write permissions in project directory\n' +
+            "  3. Try removing .clavix/ and running 'clavix init'\n\n" +
+            'Fix the underlying issue and retry.');
+    }
+    /**
+     * Error: Diagnostic check failed
+     * Used by: diagnose.ts when health check identifies issues
+     */
+    static diagnosticFailed(issues) {
+        const issueList = issues.map((issue) => `  • ${issue}`).join('\n');
+        return ('Diagnostic check identified issues:\n\n' +
+            issueList +
+            '\n\n' +
+            'Agent recovery options:\n' +
+            "  1. Run 'clavix update' to fix template issues\n" +
+            "  2. Run 'clavix init' to reinitialize configuration\n" +
+            '  3. Check file permissions in project directory\n\n' +
+            'Address issues above and rerun diagnose.');
+    }
 }
 //# sourceMappingURL=agent-error-messages.js.map

package/dist/utils/integration-selector.d.ts

@@ -1,8 +1,20 @@
 import { AgentManager } from '../core/agent-manager.js';
+/**
+ * AGENTS.md is always enabled by default.
+ * It provides universal agent guidance that all AI tools can read.
+ */
+export declare const MANDATORY_INTEGRATION = "agents-md";
 /**
  * Interactive integration selection utility
  * Displays multi-select checkbox for all available integrations
  * Used by both init and config commands
+ *
+ * Note: AGENTS.md is always enabled and not shown in selection
  */
 export declare function selectIntegrations(agentManager: AgentManager, preSelected?: string[]): Promise<string[]>;
+/**
+ * Ensures AGENTS.md is always included in the final integration list.
+ * Call this after selectIntegrations() to enforce mandatory integrations.
+ */
+export declare function ensureMandatoryIntegrations(integrations: string[]): string[];
 //# sourceMappingURL=integration-selector.d.ts.map

package/dist/utils/integration-selector.js

@@ -1,8 +1,15 @@
 import inquirer from 'inquirer';
+/**
+ * AGENTS.md is always enabled by default.
+ * It provides universal agent guidance that all AI tools can read.
+ */
+export const MANDATORY_INTEGRATION = 'agents-md';
 /**
  * Interactive integration selection utility
  * Displays multi-select checkbox for all available integrations
  * Used by both init and config commands
+ *
+ * Note: AGENTS.md is always enabled and not shown in selection
  */
 export async function selectIntegrations(agentManager, preSelected = []) {
     const { selectedIntegrations } = await inquirer.prompt([
@@ -31,8 +38,8 @@ export async function selectIntegrations(agentManager, preSelected = []) {
                 { name: 'Roocode (.roo/clavix/)', value: 'roocode' },
                 { name: 'Windsurf (.windsurf/rules/)', value: 'windsurf' },
                 new inquirer.Separator(),
-                new inquirer.Separator('=== Universal Adapters ==='),
-                { name: 'AGENTS.md (Universal)', value: 'agents-md' },
+                new inquirer.Separator('=== Optional Universal Adapters ==='),
+                // Note: AGENTS.md is always enabled (not shown here)
                 { name: 'GitHub Copilot (.github/copilot-instructions.md)', value: 'copilot-instructions' },
                 { name: 'OCTO.md (Universal)', value: 'octo-md' },
                 { name: 'WARP.md (Universal)', value: 'warp-md' },
@@ -57,4 +64,14 @@ export async function selectIntegrations(agentManager, preSelected = []) {
     ]);
     return selectedIntegrations;
 }
+/**
+ * Ensures AGENTS.md is always included in the final integration list.
+ * Call this after selectIntegrations() to enforce mandatory integrations.
+ */
+export function ensureMandatoryIntegrations(integrations) {
+    if (!integrations.includes(MANDATORY_INTEGRATION)) {
+        return [MANDATORY_INTEGRATION, ...integrations];
+    }
+    return integrations;
+}
 //# sourceMappingURL=integration-selector.js.map

package/dist/utils/toml-templates.js

@@ -1,3 +1,4 @@
+import { DataError } from '../types/errors.js';
 /**
  * Parse TOML-based slash command templates (Gemini/Qwen) and extract metadata.
  * Ensures the resulting prompt body does not include duplicated frontmatter.
@@ -10,13 +11,13 @@ export function parseTomlSlashCommand(content, templateName, integrationName) {
     const descriptionMatch = normalized.match(/^\s*description\s*=\s*(['"])(.*?)\1\s*$/m);
     const promptHeaderMatch = normalized.match(/^\s*prompt\s*=\s*"""/m);
     if (!promptHeaderMatch || promptHeaderMatch.index === undefined) {
-        throw new Error(`Template ${templateName}.toml for ${integrationName} is missing a prompt = """ ... """ block.`);
+        throw new DataError(`Template ${templateName}.toml for ${integrationName} is missing a prompt = """ ... """ block.`, 'Check the template file format. TOML templates require prompt = """...""" syntax.');
     }
     const bodyStart = promptHeaderMatch.index + promptHeaderMatch[0].length;
     const bodyRemainder = normalized.slice(bodyStart);
     const closingIndex = bodyRemainder.indexOf('"""');
     if (closingIndex === -1) {
-        throw new Error(`Template ${templateName}.toml for ${integrationName} does not terminate its prompt = """ ... """ block.`);
+        throw new DataError(`Template ${templateName}.toml for ${integrationName} does not terminate its prompt = """ ... """ block.`, 'Add closing """ to the prompt block.');
     }
     let promptBody = bodyRemainder.slice(0, closingIndex);
     const promptLines = promptBody.split('\n');

package/dist/utils/version.d.ts

@@ -2,11 +2,6 @@
  * Version utility for Clavix
  * Centralizes version reading from package.json
  */
-/**
- * Get the current Clavix version from package.json
- * Returns '0.0.0' if package.json cannot be read
- */
-export declare function getVersion(): Promise<string>;
 /**
  * Get version synchronously (for use in type definitions)
  * Falls back to hardcoded version if file cannot be read

package/dist/utils/version.js

@@ -7,20 +7,6 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-/**
- * Get the current Clavix version from package.json
- * Returns '0.0.0' if package.json cannot be read
- */
-export async function getVersion() {
-    try {
-        const packageJsonPath = path.join(__dirname, '../../package.json');
-        const packageJson = await fs.readJson(packageJsonPath);
-        return packageJson.version || '0.0.0';
-    }
-    catch {
-        return '0.0.0';
-    }
-}
 /**
  * Get version synchronously (for use in type definitions)
  * Falls back to hardcoded version if file cannot be read

package/oclif.manifest.json

@@ -126,5 +126,5 @@
       ]
     }
   },
-  "version": "5.5.0"
+  "version": "5.5.2"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.5.1",
+  "version": "5.6.0",
   "description": "Agentic-first prompt workflows. Markdown templates that teach AI agents how to optimize prompts, create PRDs, and manage implementation.\n\nSLASH COMMANDS (in your AI assistant):\n  /clavix:improve    Optimize prompts with auto-depth\n  /clavix:prd        Generate PRD through questions\n  /clavix:plan       Create task breakdown from PRD\n  /clavix:implement  Execute tasks with progress tracking\n  /clavix:start      Begin conversational session\n  /clavix:summarize  Extract requirements from conversation\n\nWorks with Claude Code, Cursor, Windsurf, and 19+ other AI coding tools.",
   "type": "module",
   "main": "dist/index.js",