clavix 5.1.1 → 5.3.0

package/dist/core/adapters/octo-md-generator.d.ts

@@ -4,20 +4,10 @@
  */
 export declare class OctoMdGenerator {
     static readonly TARGET_FILE = "OCTO.md";
-    static readonly START_MARKER = "<!-- CLAVIX:START -->";
-    static readonly END_MARKER = "<!-- CLAVIX:END -->";
     /**
      * Generate or update OCTO.md with Clavix workflows
      */
     static generate(): Promise<void>;
-    /**
-     * Inject or update managed block in OCTO.md
-     */
-    private static injectManagedBlock;
-    /**
-     * Escape special regex characters
-     */
-    private static escapeRegex;
     /**
      * Check if OCTO.md has Clavix block
      */

package/dist/core/adapters/octo-md-generator.js

@@ -1,7 +1,8 @@
-import { FileSystem } from '../../utils/file-system.js';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
+import { FileSystem } from '../../utils/file-system.js';
+import { DocInjector } from '../doc-injector.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /**
@@ -10,60 +11,25 @@ const __dirname = dirname(__filename);
  */
 export class OctoMdGenerator {
     static TARGET_FILE = 'OCTO.md';
-    static START_MARKER = '<!-- CLAVIX:START -->';
-    static END_MARKER = '<!-- CLAVIX:END -->';
     /**
      * Generate or update OCTO.md with Clavix workflows
      */
     static async generate() {
         const templatePath = path.join(__dirname, '../../templates/agents/octo.md');
-        // Check if template exists
         if (!(await FileSystem.exists(templatePath))) {
             throw new Error(`OCTO.md template not found at ${templatePath}`);
         }
         const template = await FileSystem.readFile(templatePath);
-        // Inject into OCTO.md using managed blocks
-        await this.injectManagedBlock(this.TARGET_FILE, template);
-    }
-    /**
-     * Inject or update managed block in OCTO.md
-     */
-    static async injectManagedBlock(filePath, content) {
-        let fileContent = '';
-        // Read existing file or start with empty content
-        if (await FileSystem.exists(filePath)) {
-            fileContent = await FileSystem.readFile(filePath);
-        }
-        const blockRegex = new RegExp(`${this.escapeRegex(this.START_MARKER)}[\\s\\S]*?${this.escapeRegex(this.END_MARKER)}`, 'g');
-        const wrappedContent = `${this.START_MARKER}\n${content}\n${this.END_MARKER}`;
-        if (blockRegex.test(fileContent)) {
-            // Replace existing block
-            fileContent = fileContent.replace(blockRegex, wrappedContent);
-        }
-        else {
-            // Append new block
-            if (fileContent && !fileContent.endsWith('\n\n')) {
-                fileContent += '\n\n';
-            }
-            fileContent += wrappedContent + '\n';
-        }
-        await FileSystem.writeFileAtomic(filePath, fileContent);
-    }
-    /**
-     * Escape special regex characters
-     */
-    static escapeRegex(str) {
-        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        await DocInjector.injectBlock(this.TARGET_FILE, template, {
+            createIfMissing: true,
+            validateMarkdown: false,
+        });
     }
     /**
      * Check if OCTO.md has Clavix block
      */
     static async hasClavixBlock() {
-        if (!(await FileSystem.exists(this.TARGET_FILE))) {
-            return false;
-        }
-        const content = await FileSystem.readFile(this.TARGET_FILE);
-        return content.includes(this.START_MARKER);
+        return DocInjector.hasBlock(this.TARGET_FILE);
     }
 }
 //# sourceMappingURL=octo-md-generator.js.map

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

@@ -1,27 +1,11 @@
-import { BaseAdapter } from './base-adapter.js';
-import { CommandTemplate } from '../../types/agent.js';
+import { TomlFormattingAdapter } from './toml-formatting-adapter.js';
 /**
  * Qwen Code CLI adapter
  * Commands stored as TOML files under .qwen/commands/clavix by default
  */
-export declare class QwenAdapter extends BaseAdapter {
-    private readonly options;
-    readonly name = "qwen";
-    readonly displayName = "Qwen Code";
-    readonly fileExtension = ".toml";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        argumentPlaceholder: string;
-    };
+export declare class QwenAdapter extends TomlFormattingAdapter {
     constructor(options?: {
         useNamespace?: boolean;
     });
-    get directory(): string;
-    detectProject(): Promise<boolean>;
-    getCommandPath(): string;
-    getTargetFilename(name: string): string;
-    protected formatCommand(template: CommandTemplate): string;
-    private getHomeDir;
 }
 //# sourceMappingURL=qwen-adapter.d.ts.map

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

@@ -1,54 +1,15 @@
-import * as os from 'os';
-import * as path from 'path';
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
+import { TomlFormattingAdapter } from './toml-formatting-adapter.js';
 /**
  * Qwen Code CLI adapter
  * Commands stored as TOML files under .qwen/commands/clavix by default
  */
-export class QwenAdapter extends BaseAdapter {
-    options;
-    name = 'qwen';
-    displayName = 'Qwen Code';
-    fileExtension = '.toml';
-    features = {
-        supportsSubdirectories: true,
-        supportsFrontmatter: false,
-        argumentPlaceholder: '{{args}}',
-    };
+export class QwenAdapter extends TomlFormattingAdapter {
     constructor(options = {}) {
-        super();
-        this.options = options;
-    }
-    get directory() {
-        const useNamespace = this.options.useNamespace ?? true;
-        return useNamespace ? path.join('.qwen', 'commands', 'clavix') : path.join('.qwen', 'commands');
-    }
-    async detectProject() {
-        if (await FileSystem.exists('.qwen')) {
-            return true;
-        }
-        const homePath = path.join(this.getHomeDir(), '.qwen');
-        return await FileSystem.exists(homePath);
-    }
-    getCommandPath() {
-        return this.directory;
-    }
-    getTargetFilename(name) {
-        const commandPath = this.getCommandPath();
-        const namespaced = commandPath.endsWith(path.join('commands', 'clavix'));
-        const baseName = namespaced ? name : `clavix-${name}`;
-        return `${baseName}${this.fileExtension}`;
-    }
-    formatCommand(template) {
-        const description = template.description.trim().length > 0
-            ? `description = ${JSON.stringify(template.description)}\n\n`
-            : '';
-        const content = template.content.replace(/\{\{ARGS\}\}/g, '{{args}}');
-        return `${description}prompt = """\n${content}\n"""\n`;
-    }
-    getHomeDir() {
-        return process.env.CLAVIX_HOME_OVERRIDE || os.homedir();
+        super({
+            name: 'qwen',
+            displayName: 'Qwen Code',
+            rootDir: '.qwen',
+        }, options);
     }
 }
 //# sourceMappingURL=qwen-adapter.js.map

package/dist/core/adapters/toml-formatting-adapter.d.ts

@@ -0,0 +1,50 @@
+import { BaseAdapter } from './base-adapter.js';
+import { CommandTemplate } from '../../types/agent.js';
+/**
+ * Configuration for TOML-based adapters
+ */
+export interface TomlAdapterConfig {
+    /** Internal adapter name (e.g., 'gemini') */
+    name: string;
+    /** Display name for UI (e.g., 'Gemini CLI') */
+    displayName: string;
+    /** Root directory name (e.g., '.gemini') */
+    rootDir: string;
+    /** Whether to use namespace subdirectory by default */
+    useNamespace?: boolean;
+}
+/**
+ * Base adapter for TOML-formatted command files
+ * Used by Gemini CLI, Qwen Code, LLXPRT, and similar tools
+ *
+ * Handles:
+ * - TOML file format with description and prompt fields
+ * - {{args}} placeholder conversion
+ * - Namespace subdirectories (e.g., .gemini/commands/clavix/)
+ * - Home directory detection for global installations
+ */
+export declare abstract class TomlFormattingAdapter extends BaseAdapter {
+    readonly fileExtension = ".toml";
+    readonly features: {
+        supportsSubdirectories: boolean;
+        supportsFrontmatter: boolean;
+        argumentPlaceholder: string;
+    };
+    protected readonly config: TomlAdapterConfig;
+    constructor(config: TomlAdapterConfig, options?: {
+        useNamespace?: boolean;
+    });
+    get name(): string;
+    get displayName(): string;
+    get directory(): string;
+    detectProject(): Promise<boolean>;
+    getCommandPath(): string;
+    getTargetFilename(name: string): string;
+    /**
+     * Format command as TOML with description and prompt fields
+     * Converts {{ARGS}} placeholder to {{args}} for TOML tools
+     */
+    protected formatCommand(template: CommandTemplate): string;
+    protected getHomeDir(): string;
+}
+//# sourceMappingURL=toml-formatting-adapter.d.ts.map

package/dist/core/adapters/toml-formatting-adapter.js

@@ -0,0 +1,74 @@
+import * as os from 'os';
+import * as path from 'path';
+import { BaseAdapter } from './base-adapter.js';
+import { FileSystem } from '../../utils/file-system.js';
+/**
+ * Base adapter for TOML-formatted command files
+ * Used by Gemini CLI, Qwen Code, LLXPRT, and similar tools
+ *
+ * Handles:
+ * - TOML file format with description and prompt fields
+ * - {{args}} placeholder conversion
+ * - Namespace subdirectories (e.g., .gemini/commands/clavix/)
+ * - Home directory detection for global installations
+ */
+export class TomlFormattingAdapter extends BaseAdapter {
+    fileExtension = '.toml';
+    features = {
+        supportsSubdirectories: true,
+        supportsFrontmatter: false,
+        argumentPlaceholder: '{{args}}',
+    };
+    config;
+    constructor(config, options = {}) {
+        super();
+        this.config = {
+            ...config,
+            useNamespace: options.useNamespace ?? config.useNamespace ?? true,
+        };
+    }
+    get name() {
+        return this.config.name;
+    }
+    get displayName() {
+        return this.config.displayName;
+    }
+    get directory() {
+        return this.config.useNamespace
+            ? path.join(this.config.rootDir, 'commands', 'clavix')
+            : path.join(this.config.rootDir, 'commands');
+    }
+    async detectProject() {
+        // Check local project directory
+        if (await FileSystem.exists(this.config.rootDir)) {
+            return true;
+        }
+        // Check home directory for global installation
+        const homePath = path.join(this.getHomeDir(), this.config.rootDir);
+        return await FileSystem.exists(homePath);
+    }
+    getCommandPath() {
+        return this.directory;
+    }
+    getTargetFilename(name) {
+        const commandPath = this.getCommandPath();
+        const namespaced = commandPath.endsWith(path.join('commands', 'clavix'));
+        const baseName = namespaced ? name : `clavix-${name}`;
+        return `${baseName}${this.fileExtension}`;
+    }
+    /**
+     * Format command as TOML with description and prompt fields
+     * Converts {{ARGS}} placeholder to {{args}} for TOML tools
+     */
+    formatCommand(template) {
+        const description = template.description.trim().length > 0
+            ? `description = ${JSON.stringify(template.description)}\n\n`
+            : '';
+        const content = template.content.replace(/\{\{ARGS\}\}/g, '{{args}}');
+        return `${description}prompt = """\n${content}\n"""\n`;
+    }
+    getHomeDir() {
+        return process.env.CLAVIX_HOME_OVERRIDE || os.homedir();
+    }
+}
+//# sourceMappingURL=toml-formatting-adapter.js.map

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

@@ -0,0 +1,49 @@
+/**
+ * UniversalAdapter - Config-driven adapter implementation
+ *
+ * This adapter can handle any simple adapter by accepting configuration
+ * at construction time. It provides the same interface as dedicated
+ * adapter classes but derives all behavior from AdapterConfig.
+ *
+ * For adapters requiring custom logic (TOML formatting, doc injection),
+ * dedicated adapter classes should be used instead.
+ *
+ * @since v5.3.0
+ */
+import { BaseAdapter } from './base-adapter.js';
+import { AdapterConfig } from '../../types/adapter-config.js';
+import { IntegrationFeatures } from '../../types/agent.js';
+export declare class UniversalAdapter extends BaseAdapter {
+    private config;
+    constructor(config: AdapterConfig);
+    get name(): string;
+    get displayName(): string;
+    get directory(): string;
+    get fileExtension(): string;
+    /**
+     * Get integration features for command transformation
+     */
+    getIntegrationFeatures(): IntegrationFeatures;
+    /**
+     * Generate the target filename based on config pattern
+     */
+    getTargetFilename(commandName: string): string;
+    /**
+     * Get full command path
+     */
+    getCommandPath(): string;
+    /**
+     * Check if this adapter's project environment is detected
+     * Required by BaseAdapter abstract class
+     */
+    detectProject(): Promise<boolean>;
+    /**
+     * Check if this adapter supports subdirectories
+     */
+    supportsSubdirectories(): boolean;
+    /**
+     * Check if this adapter supports frontmatter
+     */
+    supportsFrontmatter(): boolean;
+}
+//# sourceMappingURL=universal-adapter.d.ts.map

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

@@ -0,0 +1,88 @@
+/**
+ * UniversalAdapter - Config-driven adapter implementation
+ *
+ * This adapter can handle any simple adapter by accepting configuration
+ * at construction time. It provides the same interface as dedicated
+ * adapter classes but derives all behavior from AdapterConfig.
+ *
+ * For adapters requiring custom logic (TOML formatting, doc injection),
+ * dedicated adapter classes should be used instead.
+ *
+ * @since v5.3.0
+ */
+import { BaseAdapter } from './base-adapter.js';
+import * as path from 'path';
+export class UniversalAdapter extends BaseAdapter {
+    config;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    get name() {
+        return this.config.name;
+    }
+    get displayName() {
+        return this.config.displayName;
+    }
+    get directory() {
+        return this.config.directory;
+    }
+    get fileExtension() {
+        return this.config.fileExtension;
+    }
+    /**
+     * Get integration features for command transformation
+     */
+    getIntegrationFeatures() {
+        return {
+            commandFormat: {
+                separator: this.config.features.commandSeparator,
+            },
+        };
+    }
+    /**
+     * Generate the target filename based on config pattern
+     */
+    getTargetFilename(commandName) {
+        const pattern = this.config.filenamePattern;
+        const filename = pattern.replace('{name}', commandName);
+        return `${filename}${this.config.fileExtension}`;
+    }
+    /**
+     * Get full command path
+     */
+    getCommandPath() {
+        return path.join(process.cwd(), this.config.directory);
+    }
+    /**
+     * Check if this adapter's project environment is detected
+     * Required by BaseAdapter abstract class
+     */
+    async detectProject() {
+        const { detection } = this.config;
+        const fs = await import('fs-extra');
+        switch (detection.type) {
+            case 'directory':
+                return fs.pathExists(detection.path);
+            case 'file':
+                return fs.pathExists(detection.path);
+            case 'config':
+                return fs.pathExists(detection.path);
+            default:
+                return false;
+        }
+    }
+    /**
+     * Check if this adapter supports subdirectories
+     */
+    supportsSubdirectories() {
+        return this.config.features.supportsSubdirectories;
+    }
+    /**
+     * Check if this adapter supports frontmatter
+     */
+    supportsFrontmatter() {
+        return this.config.features.supportsFrontmatter;
+    }
+}
+//# sourceMappingURL=universal-adapter.js.map

package/dist/core/adapters/warp-md-generator.d.ts

@@ -4,14 +4,13 @@
  */
 export declare class WarpMdGenerator {
     static readonly TARGET_FILE = "WARP.md";
-    static readonly START_MARKER = "<!-- CLAVIX:START -->";
-    static readonly END_MARKER = "<!-- CLAVIX:END -->";
     /**
      * Generate or update WARP.md with Clavix workflows
      */
     static generate(): Promise<void>;
-    private static injectManagedBlock;
-    private static escapeRegex;
+    /**
+     * Check if WARP.md has Clavix block
+     */
     static hasClavixBlock(): Promise<boolean>;
 }
 //# sourceMappingURL=warp-md-generator.d.ts.map

package/dist/core/adapters/warp-md-generator.js

@@ -1,7 +1,8 @@
-import { FileSystem } from '../../utils/file-system.js';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
+import { FileSystem } from '../../utils/file-system.js';
+import { DocInjector } from '../doc-injector.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /**
@@ -10,8 +11,6 @@ const __dirname = dirname(__filename);
  */
 export class WarpMdGenerator {
     static TARGET_FILE = 'WARP.md';
-    static START_MARKER = '<!-- CLAVIX:START -->';
-    static END_MARKER = '<!-- CLAVIX:END -->';
     /**
      * Generate or update WARP.md with Clavix workflows
      */
@@ -21,35 +20,16 @@ export class WarpMdGenerator {
             throw new Error(`WARP.md template not found at ${templatePath}`);
         }
         const template = await FileSystem.readFile(templatePath);
-        await this.injectManagedBlock(this.TARGET_FILE, template);
-    }
-    static async injectManagedBlock(filePath, content) {
-        let fileContent = '';
-        if (await FileSystem.exists(filePath)) {
-            fileContent = await FileSystem.readFile(filePath);
-        }
-        const blockRegex = new RegExp(`${this.escapeRegex(this.START_MARKER)}[\\s\\S]*?${this.escapeRegex(this.END_MARKER)}`, 'g');
-        const wrappedContent = `${this.START_MARKER}\n${content}\n${this.END_MARKER}`;
-        if (blockRegex.test(fileContent)) {
-            fileContent = fileContent.replace(blockRegex, wrappedContent);
-        }
-        else {
-            if (fileContent && !fileContent.endsWith('\n\n')) {
-                fileContent += '\n\n';
-            }
-            fileContent += wrappedContent + '\n';
-        }
-        await FileSystem.writeFileAtomic(filePath, fileContent);
-    }
-    static escapeRegex(str) {
-        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        await DocInjector.injectBlock(this.TARGET_FILE, template, {
+            createIfMissing: true,
+            validateMarkdown: false,
+        });
     }
+    /**
+     * Check if WARP.md has Clavix block
+     */
     static async hasClavixBlock() {
-        if (!(await FileSystem.exists(this.TARGET_FILE))) {
-            return false;
-        }
-        const content = await FileSystem.readFile(this.TARGET_FILE);
-        return content.includes(this.START_MARKER);
+        return DocInjector.hasBlock(this.TARGET_FILE);
     }
 }
 //# sourceMappingURL=warp-md-generator.js.map

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

@@ -3,11 +3,10 @@ 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)
+ * - Colon format: /clavix:improve (Claude Code style - uses subdirectories)
+ * - Hyphen format: /clavix-improve (Cursor, Droid style - flat files)
  *
- * Preserves CLI commands (clavix prompts list) unchanged - only transforms
- * slash commands that start with /clavix:
+ * Only transforms slash commands that start with /clavix:
  *
  * @since v4.8.1
  */
@@ -29,26 +28,26 @@ export declare class CommandTransformer {
      *
      * @example
      * // For Cursor/Droid (hyphen format):
-     * transform('/clavix:fast', { commandFormat: { separator: '-' } })
-     * // Returns: '/clavix-fast'
+     * transform('/clavix:improve', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-improve'
      *
      * @example
      * // For Claude Code (colon format, default):
-     * transform('/clavix:fast', { commandFormat: { separator: ':' } })
-     * // Returns: '/clavix:fast' (unchanged)
+     * transform('/clavix:improve', { commandFormat: { separator: ':' } })
+     * // Returns: '/clavix:improve' (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 commandName - Base command name (e.g., 'improve', 'prd', 'implement')
      * @param features - Adapter's integration features
-     * @returns Formatted slash command (e.g., '/clavix:fast' or '/clavix-fast')
+     * @returns Formatted slash command (e.g., '/clavix:improve' or '/clavix-improve')
      *
      * @example
-     * formatCommand('execute', { commandFormat: { separator: '-' } })
-     * // Returns: '/clavix-execute'
+     * formatCommand('improve', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-improve'
      */
     static formatCommand(commandName: string, features?: IntegrationFeatures): string;
 }

package/dist/core/command-transformer.js

@@ -2,11 +2,10 @@
  * 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)
+ * - Colon format: /clavix:improve (Claude Code style - uses subdirectories)
+ * - Hyphen format: /clavix-improve (Cursor, Droid style - flat files)
  *
- * Preserves CLI commands (clavix prompts list) unchanged - only transforms
- * slash commands that start with /clavix:
+ * Only transforms slash commands that start with /clavix:
  *
  * @since v4.8.1
  */
@@ -28,13 +27,13 @@ export class CommandTransformer {
      *
      * @example
      * // For Cursor/Droid (hyphen format):
-     * transform('/clavix:fast', { commandFormat: { separator: '-' } })
-     * // Returns: '/clavix-fast'
+     * transform('/clavix:improve', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-improve'
      *
      * @example
      * // For Claude Code (colon format, default):
-     * transform('/clavix:fast', { commandFormat: { separator: ':' } })
-     * // Returns: '/clavix:fast' (unchanged)
+     * transform('/clavix:improve', { commandFormat: { separator: ':' } })
+     * // Returns: '/clavix:improve' (unchanged)
      */
     static transform(content, features) {
         const separator = features?.commandFormat?.separator ?? this.DEFAULT_SEPARATOR;
@@ -49,13 +48,13 @@ export class CommandTransformer {
      * 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 commandName - Base command name (e.g., 'improve', 'prd', 'implement')
      * @param features - Adapter's integration features
-     * @returns Formatted slash command (e.g., '/clavix:fast' or '/clavix-fast')
+     * @returns Formatted slash command (e.g., '/clavix:improve' or '/clavix-improve')
      *
      * @example
-     * formatCommand('execute', { commandFormat: { separator: '-' } })
-     * // Returns: '/clavix-execute'
+     * formatCommand('improve', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-improve'
      */
     static formatCommand(commandName, features) {
         const separator = features?.commandFormat?.separator ?? this.DEFAULT_SEPARATOR;

package/dist/core/doc-injector.d.ts

@@ -31,10 +31,6 @@ export declare class DocInjector {
      * Wrap content with markers
      */
     private static wrapContent;
-    /**
-     * Escape special regex characters
-     */
-    private static escapeRegex;
     /**
      * Basic markdown validation
      */