clavix 5.5.0 → 5.5.2

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.0",
+  "version": "5.5.2",
   "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",