clavix 4.8.0 → 4.8.1

package/dist/core/adapters/amp-adapter.d.ts

@@ -13,6 +13,9 @@ export declare class AmpAdapter extends BaseAdapter {
         supportsSubdirectories: boolean;
         supportsFrontmatter: boolean;
         supportsExecutableCommands: boolean;
+        commandFormat: {
+            separator: "-";
+        };
     };
     /**
      * Detect if Amp is available in the project

package/dist/core/adapters/amp-adapter.js

@@ -14,6 +14,7 @@ export class AmpAdapter extends BaseAdapter {
         supportsSubdirectories: false,
         supportsFrontmatter: false,
         supportsExecutableCommands: true,
+        commandFormat: { separator: '-' },
     };
     /**
      * Detect if Amp is available in the project

package/dist/core/adapters/cline-adapter.d.ts

@@ -19,6 +19,9 @@ export declare class ClineAdapter extends BaseAdapter {
     readonly features: {
         supportsSubdirectories: boolean;
         supportsFrontmatter: boolean;
+        commandFormat: {
+            separator: "-";
+        };
     };
     /**
      * Detect if Cline is available in the project

package/dist/core/adapters/cline-adapter.js

@@ -20,6 +20,7 @@ export class ClineAdapter extends BaseAdapter {
     features = {
         supportsSubdirectories: false,
         supportsFrontmatter: false,
+        commandFormat: { separator: '-' },
     };
     /**
      * Detect if Cline is available in the project

package/dist/core/adapters/codebuddy-adapter.d.ts

@@ -14,6 +14,9 @@ export declare class CodeBuddyAdapter extends BaseAdapter {
         supportsFrontmatter: boolean;
         argumentPlaceholder: string;
         frontmatterFields: string[];
+        commandFormat: {
+            separator: "-";
+        };
     };
     detectProject(): Promise<boolean>;
     getCommandPath(): string;

package/dist/core/adapters/codebuddy-adapter.js

@@ -16,6 +16,7 @@ export class CodeBuddyAdapter extends BaseAdapter {
         supportsFrontmatter: true,
         argumentPlaceholder: '$1',
         frontmatterFields: ['description', 'argument-hint'],
+        commandFormat: { separator: '-' },
     };
     async detectProject() {
         if (await FileSystem.exists('.codebuddy')) {

package/dist/core/adapters/codex-adapter.d.ts

@@ -14,6 +14,9 @@ export declare class CodexAdapter extends BaseAdapter {
         supportsFrontmatter: boolean;
         argumentPlaceholder: string;
         frontmatterFields: string[];
+        commandFormat: {
+            separator: "-";
+        };
     };
     detectProject(): Promise<boolean>;
     getCommandPath(): string;

package/dist/core/adapters/codex-adapter.js

@@ -16,6 +16,7 @@ export class CodexAdapter extends BaseAdapter {
         supportsFrontmatter: true,
         argumentPlaceholder: '$ARGUMENTS',
         frontmatterFields: ['description', 'argument-hint'],
+        commandFormat: { separator: '-' },
     };
     async detectProject() {
         const codexDir = path.join(this.getHomeDir(), '.codex');

package/dist/core/adapters/cursor-adapter.d.ts

@@ -11,6 +11,9 @@ export declare class CursorAdapter extends BaseAdapter {
     readonly features: {
         supportsSubdirectories: boolean;
         supportsFrontmatter: boolean;
+        commandFormat: {
+            separator: "-";
+        };
     };
     /**
      * Detect if Cursor is available in the project

package/dist/core/adapters/cursor-adapter.js

@@ -12,6 +12,7 @@ export class CursorAdapter extends BaseAdapter {
     features = {
         supportsSubdirectories: false,
         supportsFrontmatter: false,
+        commandFormat: { separator: '-' },
     };
     /**
      * Detect if Cursor is available in the project

package/dist/core/adapters/droid-adapter.d.ts

@@ -15,6 +15,9 @@ export declare class DroidAdapter extends BaseAdapter {
         supportsFrontmatter: boolean;
         frontmatterFields: string[];
         argumentPlaceholder: string;
+        commandFormat: {
+            separator: "-";
+        };
     };
     /**
      * Detect if Droid CLI is available in the project

package/dist/core/adapters/droid-adapter.js

@@ -15,6 +15,7 @@ export class DroidAdapter extends BaseAdapter {
         supportsFrontmatter: true,
         frontmatterFields: ['description', 'argument-hint'],
         argumentPlaceholder: '$ARGUMENTS',
+        commandFormat: { separator: '-' },
     };
     /**
      * Detect if Droid CLI is available in the project

package/dist/core/adapters/instructions-generator.js

@@ -1,5 +1,6 @@
 import { FileSystem } from '../../utils/file-system.js';
 import { TemplateAssembler } from '../template-assembler.js';
+import { CommandTransformer } from '../command-transformer.js';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
@@ -79,17 +80,23 @@ export class InstructionsGenerator {
         // Copy all .md files from canonical, resolving includes
         const entries = await FileSystem.readdir(canonicalPath, { withFileTypes: true });
         const mdFiles = entries.filter((f) => f.isFile() && f.name.endsWith('.md'));
+        // v4.8.1: Generic integrations use hyphen format for slash commands
+        const genericFeatures = { commandFormat: { separator: '-' } };
         for (const file of mdFiles) {
             const destPath = path.join(workflowsTarget, file.name);
             try {
                 // v4.5: Use TemplateAssembler to resolve {{INCLUDE:}} markers
                 const result = await assembler.assembleTemplate(file.name);
-                await FileSystem.writeFileAtomic(destPath, result.content);
+                // v4.8.1: Transform command references to hyphen format for generic integrations
+                const transformedContent = CommandTransformer.transform(result.content, genericFeatures);
+                await FileSystem.writeFileAtomic(destPath, transformedContent);
             }
             catch {
                 // Fallback: copy without include resolution if assembly fails
                 const srcPath = path.join(canonicalPath, file.name);
-                const content = await FileSystem.readFile(srcPath);
+                let content = await FileSystem.readFile(srcPath);
+                // v4.8.1: Still transform command references in fallback path
+                content = CommandTransformer.transform(content, genericFeatures);
                 await FileSystem.writeFileAtomic(destPath, content);
             }
         }

package/dist/core/adapters/kilocode-adapter.d.ts

@@ -19,6 +19,9 @@ export declare class KilocodeAdapter extends BaseAdapter {
     readonly features: {
         supportsSubdirectories: boolean;
         supportsFrontmatter: boolean;
+        commandFormat: {
+            separator: "-";
+        };
     };
     /**
      * Detect if Kilocode is available in the project

package/dist/core/adapters/kilocode-adapter.js

@@ -20,6 +20,7 @@ export class KilocodeAdapter extends BaseAdapter {
     features = {
         supportsSubdirectories: false,
         supportsFrontmatter: false,
+        commandFormat: { separator: '-' },
     };
     /**
      * Detect if Kilocode is available in the project

package/dist/core/adapters/opencode-adapter.d.ts

@@ -15,6 +15,9 @@ export declare class OpenCodeAdapter extends BaseAdapter {
         supportsFrontmatter: boolean;
         frontmatterFields: string[];
         argumentPlaceholder: string;
+        commandFormat: {
+            separator: "-";
+        };
     };
     /**
      * Detect if OpenCode is available in the project

package/dist/core/adapters/opencode-adapter.js

@@ -15,6 +15,7 @@ export class OpenCodeAdapter extends BaseAdapter {
         supportsFrontmatter: true,
         frontmatterFields: ['description', 'agent', 'model'],
         argumentPlaceholder: '$ARGUMENTS',
+        commandFormat: { separator: '-' },
     };
     /**
      * Detect if OpenCode is available in the project

package/dist/core/adapters/roocode-adapter.d.ts

@@ -20,6 +20,9 @@ export declare class RoocodeAdapter extends BaseAdapter {
     readonly features: {
         supportsSubdirectories: boolean;
         supportsFrontmatter: boolean;
+        commandFormat: {
+            separator: "-";
+        };
     };
     /**
      * Detect if Roocode is available in the project

package/dist/core/adapters/roocode-adapter.js

@@ -20,6 +20,7 @@ export class RoocodeAdapter extends BaseAdapter {
     features = {
         supportsSubdirectories: false,
         supportsFrontmatter: true,
+        commandFormat: { separator: '-' },
     };
     /**
      * Detect if Roocode is available in the project

package/dist/core/adapters/windsurf-adapter.d.ts

@@ -19,6 +19,9 @@ export declare class WindsurfAdapter extends BaseAdapter {
     readonly features: {
         supportsSubdirectories: boolean;
         supportsFrontmatter: boolean;
+        commandFormat: {
+            separator: "-";
+        };
     };
     /**
      * Detect if Windsurf is available in the project

package/dist/core/adapters/windsurf-adapter.js

@@ -20,6 +20,7 @@ export class WindsurfAdapter extends BaseAdapter {
     features = {
         supportsSubdirectories: true,
         supportsFrontmatter: false,
+        commandFormat: { separator: '-' },
     };
     /**
      * Detect if Windsurf is available in the project

package/dist/core/command-transformer.d.ts

@@ -0,0 +1,55 @@
+import { IntegrationFeatures } from '../types/agent.js';
+/**
+ * CommandTransformer - Transforms slash command references in template content
+ *
+ * Handles conversion between command formats:
+ * - Colon format: /clavix:fast (Claude Code style - uses subdirectories)
+ * - Hyphen format: /clavix-fast (Cursor, Droid style - flat files)
+ *
+ * Preserves CLI commands (clavix prompts list) unchanged - only transforms
+ * slash commands that start with /clavix:
+ *
+ * @since v4.8.1
+ */
+export declare class CommandTransformer {
+    /**
+     * Matches /clavix:commandname pattern
+     * Supports hyphenated commands like task-complete
+     * Does NOT match CLI usage (no leading slash)
+     */
+    private static readonly SLASH_COMMAND_PATTERN;
+    /** Default command format (canonical/Claude Code style) */
+    private static readonly DEFAULT_SEPARATOR;
+    /**
+     * Transform slash command references in content based on adapter's command format
+     *
+     * @param content - Template content with canonical /clavix:command references
+     * @param features - Adapter's integration features (may include commandFormat)
+     * @returns Transformed content with correct command format
+     *
+     * @example
+     * // For Cursor/Droid (hyphen format):
+     * transform('/clavix:fast', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-fast'
+     *
+     * @example
+     * // For Claude Code (colon format, default):
+     * transform('/clavix:fast', { commandFormat: { separator: ':' } })
+     * // Returns: '/clavix:fast' (unchanged)
+     */
+    static transform(content: string, features?: IntegrationFeatures): string;
+    /**
+     * Get the formatted command name for a specific adapter
+     * Useful for generating documentation or references
+     *
+     * @param commandName - Base command name (e.g., 'fast', 'execute', 'task-complete')
+     * @param features - Adapter's integration features
+     * @returns Formatted slash command (e.g., '/clavix:fast' or '/clavix-fast')
+     *
+     * @example
+     * formatCommand('execute', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-execute'
+     */
+    static formatCommand(commandName: string, features?: IntegrationFeatures): string;
+}
+//# sourceMappingURL=command-transformer.d.ts.map

package/dist/core/command-transformer.js

@@ -0,0 +1,65 @@
+/**
+ * CommandTransformer - Transforms slash command references in template content
+ *
+ * Handles conversion between command formats:
+ * - Colon format: /clavix:fast (Claude Code style - uses subdirectories)
+ * - Hyphen format: /clavix-fast (Cursor, Droid style - flat files)
+ *
+ * Preserves CLI commands (clavix prompts list) unchanged - only transforms
+ * slash commands that start with /clavix:
+ *
+ * @since v4.8.1
+ */
+export class CommandTransformer {
+    /**
+     * Matches /clavix:commandname pattern
+     * Supports hyphenated commands like task-complete
+     * Does NOT match CLI usage (no leading slash)
+     */
+    static SLASH_COMMAND_PATTERN = /\/clavix:(\w+(?:-\w+)*)/g;
+    /** Default command format (canonical/Claude Code style) */
+    static DEFAULT_SEPARATOR = ':';
+    /**
+     * Transform slash command references in content based on adapter's command format
+     *
+     * @param content - Template content with canonical /clavix:command references
+     * @param features - Adapter's integration features (may include commandFormat)
+     * @returns Transformed content with correct command format
+     *
+     * @example
+     * // For Cursor/Droid (hyphen format):
+     * transform('/clavix:fast', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-fast'
+     *
+     * @example
+     * // For Claude Code (colon format, default):
+     * transform('/clavix:fast', { commandFormat: { separator: ':' } })
+     * // Returns: '/clavix:fast' (unchanged)
+     */
+    static transform(content, features) {
+        const separator = features?.commandFormat?.separator ?? this.DEFAULT_SEPARATOR;
+        // If using canonical format (colon), no transformation needed
+        if (separator === ':') {
+            return content;
+        }
+        // Transform /clavix:command to /clavix-command (or other separator)
+        return content.replace(this.SLASH_COMMAND_PATTERN, `/clavix${separator}$1`);
+    }
+    /**
+     * Get the formatted command name for a specific adapter
+     * Useful for generating documentation or references
+     *
+     * @param commandName - Base command name (e.g., 'fast', 'execute', 'task-complete')
+     * @param features - Adapter's integration features
+     * @returns Formatted slash command (e.g., '/clavix:fast' or '/clavix-fast')
+     *
+     * @example
+     * formatCommand('execute', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-execute'
+     */
+    static formatCommand(commandName, features) {
+        const separator = features?.commandFormat?.separator ?? this.DEFAULT_SEPARATOR;
+        return `/clavix${separator}${commandName}`;
+    }
+}
+//# sourceMappingURL=command-transformer.js.map

package/dist/types/agent.d.ts

@@ -21,6 +21,10 @@ export interface IntegrationFeatures {
     supportsSubdirectories?: boolean;
     argumentPlaceholder?: string;
     frontmatterFields?: string[];
+    /** Command format for slash command references in templates. Default: colon (:) */
+    commandFormat?: {
+        separator: ':' | '-';
+    };
 }
 /**
  * @deprecated Use IntegrationFeatures instead. Will be removed in v4.0.0

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

@@ -1,3 +1,3 @@
 import { AgentAdapter, CommandTemplate } from '../types/agent.js';
-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

@@ -3,6 +3,7 @@ import { fileURLToPath } from 'url';
 import { dirname } from 'path';
 import { FileSystem } from './file-system.js';
 import { TemplateAssembler } from '../core/template-assembler.js';
+import { CommandTransformer } from '../core/command-transformer.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // v4.0: Singleton assembler instance for caching
@@ -14,7 +15,7 @@ function getAssembler() {
     }
     return assemblerInstance;
 }
-export async function loadCommandTemplates(_adapter) {
+export async function loadCommandTemplates(adapter) {
     // Load from canonical template source (always .md files)
     const templatesDir = getCanonicalTemplatesDirectory();
     const files = await FileSystem.listFiles(templatesDir);
@@ -42,6 +43,9 @@ export async function loadCommandTemplates(_adapter) {
                 console.warn(`Template assembly warning for ${file}:`, error);
             }
         }
+        // v4.8.1: Transform command references based on adapter format
+        // Converts /clavix:command to /clavix-command for flat-file integrations
+        content = CommandTransformer.transform(content, adapter.features);
         // Clean content from markdown
         const cleanContent = stripFrontmatter(content);
         templates.push({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "4.8.0",
+  "version": "4.8.1",
   "description": "Clavix Intelligence™ for AI coding. Automatically optimizes prompts with intent detection, quality assessment, and adaptive patterns—no framework to learn. Works with Claude Code, Cursor, Windsurf, and 19+ other AI coding tools.",
   "type": "module",
   "main": "dist/index.js",