clavix 5.1.1 → 5.3.0

package/dist/core/adapter-registry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Adapter Registry - Config-driven adapter definitions
+ *
+ * This registry provides configuration for all simple adapters that can
+ * be represented as pure configuration without custom logic.
+ *
+ * For adapters requiring custom behavior (TOML format, doc injection),
+ * dedicated adapter classes still exist.
+ *
+ * @since v5.3.0
+ */
+import { AdapterConfig } from '../types/adapter-config.js';
+/**
+ * Registry of all adapter configurations
+ *
+ * These configurations describe how each adapter behaves:
+ * - Where commands are stored
+ * - File extension and naming pattern
+ * - Feature support (subdirectories, frontmatter, etc.)
+ * - Detection method for project environment
+ */
+export declare const ADAPTER_CONFIGS: AdapterConfig[];
+/**
+ * Get adapter configuration by name
+ */
+export declare function getAdapterConfig(name: string): AdapterConfig | undefined;
+/**
+ * Get all adapter configurations
+ */
+export declare function getAllAdapterConfigs(): AdapterConfig[];
+/**
+ * Get adapters that require special handling
+ */
+export declare function getSpecialAdapters(): AdapterConfig[];
+/**
+ * Get simple adapters (can use UniversalAdapter)
+ */
+export declare function getSimpleAdapters(): AdapterConfig[];
+//# sourceMappingURL=adapter-registry.d.ts.map

package/dist/core/adapter-registry.js

@@ -0,0 +1,208 @@
+/**
+ * Adapter Registry - Config-driven adapter definitions
+ *
+ * This registry provides configuration for all simple adapters that can
+ * be represented as pure configuration without custom logic.
+ *
+ * For adapters requiring custom behavior (TOML format, doc injection),
+ * dedicated adapter classes still exist.
+ *
+ * @since v5.3.0
+ */
+import { DEFAULT_MD_FEATURES, DEFAULT_TOML_FEATURES, } from '../types/adapter-config.js';
+/**
+ * Registry of all adapter configurations
+ *
+ * These configurations describe how each adapter behaves:
+ * - Where commands are stored
+ * - File extension and naming pattern
+ * - Feature support (subdirectories, frontmatter, etc.)
+ * - Detection method for project environment
+ */
+export const ADAPTER_CONFIGS = [
+    // IDE Extensions (Markdown-based)
+    {
+        name: 'cursor',
+        displayName: 'Cursor',
+        directory: '.cursor/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.cursor' },
+    },
+    {
+        name: 'windsurf',
+        displayName: 'Windsurf',
+        directory: '.windsurf/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.windsurf' },
+    },
+    {
+        name: 'kilocode',
+        displayName: 'Kilocode',
+        directory: '.kilocode/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.kilocode' },
+    },
+    {
+        name: 'roocode',
+        displayName: 'Roo-Code',
+        directory: '.roo/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.roo' },
+    },
+    {
+        name: 'cline',
+        displayName: 'Cline',
+        directory: '.cline/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.cline' },
+    },
+    {
+        name: 'droid',
+        displayName: 'Droid',
+        directory: '.droid/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.droid' },
+    },
+    {
+        name: 'opencode',
+        displayName: 'OpenCode',
+        directory: '.opencode/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.opencode' },
+    },
+    {
+        name: 'crush',
+        displayName: 'Crush',
+        directory: '.crush/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.crush' },
+    },
+    {
+        name: 'codex',
+        displayName: 'Codex CLI',
+        directory: '.codex/instructions',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.codex' },
+    },
+    {
+        name: 'codebuddy',
+        displayName: 'CodeBuddy',
+        directory: '.codebuddy/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.codebuddy' },
+    },
+    {
+        name: 'amp',
+        displayName: 'Amp',
+        directory: '.amp/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.amp' },
+    },
+    {
+        name: 'augment',
+        displayName: 'Augment Code',
+        directory: '.augment/rules',
+        fileExtension: '.md',
+        filenamePattern: 'clavix-{name}',
+        features: { ...DEFAULT_MD_FEATURES },
+        detection: { type: 'directory', path: '.augment' },
+    },
+    // Claude Code (requires doc injection - special adapter kept)
+    {
+        name: 'claude-code',
+        displayName: 'Claude Code',
+        directory: '.claude/commands/clavix',
+        fileExtension: '.md',
+        filenamePattern: '{name}',
+        features: {
+            ...DEFAULT_MD_FEATURES,
+            supportsSubdirectories: true,
+            supportsFrontmatter: true,
+            supportsDocInjection: true,
+            commandSeparator: ':',
+        },
+        detection: { type: 'directory', path: '.claude' },
+        specialAdapter: 'doc-injection',
+    },
+    // TOML-based adapters (require special formatting - special adapter kept)
+    {
+        name: 'gemini',
+        displayName: 'Gemini CLI',
+        directory: '.gemini/commands/clavix',
+        fileExtension: '.toml',
+        filenamePattern: '{name}',
+        features: { ...DEFAULT_TOML_FEATURES },
+        detection: { type: 'directory', path: '.gemini' },
+        specialAdapter: 'toml',
+        rootDir: '.gemini',
+    },
+    {
+        name: 'qwen',
+        displayName: 'Qwen CLI',
+        directory: '.qwen/commands/clavix',
+        fileExtension: '.toml',
+        filenamePattern: '{name}',
+        features: { ...DEFAULT_TOML_FEATURES },
+        detection: { type: 'directory', path: '.qwen' },
+        specialAdapter: 'toml',
+        rootDir: '.qwen',
+    },
+    {
+        name: 'llxprt',
+        displayName: 'LLXpert',
+        directory: '.llxprt/commands/clavix',
+        fileExtension: '.toml',
+        filenamePattern: '{name}',
+        features: { ...DEFAULT_TOML_FEATURES },
+        detection: { type: 'directory', path: '.llxprt' },
+        specialAdapter: 'toml',
+        rootDir: '.llxprt',
+    },
+];
+/**
+ * Get adapter configuration by name
+ */
+export function getAdapterConfig(name) {
+    return ADAPTER_CONFIGS.find((config) => config.name === name);
+}
+/**
+ * Get all adapter configurations
+ */
+export function getAllAdapterConfigs() {
+    return [...ADAPTER_CONFIGS];
+}
+/**
+ * Get adapters that require special handling
+ */
+export function getSpecialAdapters() {
+    return ADAPTER_CONFIGS.filter((config) => config.specialAdapter !== undefined);
+}
+/**
+ * Get simple adapters (can use UniversalAdapter)
+ */
+export function getSimpleAdapters() {
+    return ADAPTER_CONFIGS.filter((config) => config.specialAdapter === undefined);
+}
+//# sourceMappingURL=adapter-registry.js.map

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

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

package/dist/core/adapters/agents-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 AgentsMdGenerator {
     static TARGET_FILE = 'AGENTS.md';
-    static START_MARKER = '<!-- CLAVIX:START -->';
-    static END_MARKER = '<!-- CLAVIX:END -->';
     /**
      * Generate or update AGENTS.md with Clavix workflows
      */
     static async generate() {
         const templatePath = path.join(__dirname, '../../templates/agents/agents.md');
-        // Check if template exists
         if (!(await FileSystem.exists(templatePath))) {
             throw new Error(`AGENTS.md template not found at ${templatePath}`);
         }
         const template = await FileSystem.readFile(templatePath);
-        // Inject into AGENTS.md using managed blocks
-        await this.injectManagedBlock(this.TARGET_FILE, template);
-    }
-    /**
-     * Inject or update managed block in AGENTS.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, // Template is pre-validated
+        });
     }
     /**
      * Check if AGENTS.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=agents-md-generator.js.map

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

@@ -52,6 +52,7 @@ export declare abstract class BaseAdapter implements AgentAdapter {
     injectDocumentation(_blocks: ManagedBlock[]): Promise<void>;
     /**
      * Escape special regex characters
+     * @deprecated Use escapeRegex from utils/string-utils.js directly
      */
     protected escapeRegex(str: string): string;
 }

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

@@ -1,6 +1,7 @@
 import * as path from 'path';
 import { FileSystem } from '../../utils/file-system.js';
 import { IntegrationError } from '../../types/errors.js';
+import { escapeRegex } from '../../utils/string-utils.js';
 /**
  * Base adapter class with shared logic for all integrations
  * Ensures consistency and reduces code duplication
@@ -135,9 +136,10 @@ export class BaseAdapter {
     }
     /**
      * Escape special regex characters
+     * @deprecated Use escapeRegex from utils/string-utils.js directly
      */
     escapeRegex(str) {
-        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return escapeRegex(str);
     }
 }
 //# sourceMappingURL=base-adapter.js.map

package/dist/core/adapters/copilot-instructions-generator.d.ts

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

package/dist/core/adapters/copilot-instructions-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,62 +11,27 @@ const __dirname = dirname(__filename);
  */
 export class CopilotInstructionsGenerator {
     static TARGET_FILE = '.github/copilot-instructions.md';
-    static START_MARKER = '<!-- CLAVIX:START -->';
-    static END_MARKER = '<!-- CLAVIX:END -->';
     /**
      * Generate or update .github/copilot-instructions.md with Clavix workflows
      */
     static async generate() {
         const templatePath = path.join(__dirname, '../../templates/agents/copilot-instructions.md');
-        // Check if template exists
         if (!(await FileSystem.exists(templatePath))) {
             throw new Error(`Copilot instructions template not found at ${templatePath}`);
         }
         const template = await FileSystem.readFile(templatePath);
         // Ensure .github directory exists
         await FileSystem.ensureDir('.github');
-        // Inject into .github/copilot-instructions.md using managed blocks
-        await this.injectManagedBlock(this.TARGET_FILE, template);
-    }
-    /**
-     * Inject or update managed block in .github/copilot-instructions.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 .github/copilot-instructions.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=copilot-instructions-generator.js.map

package/dist/core/adapters/gemini-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';
 /**
  * Gemini CLI adapter
  * Commands stored as TOML files under .gemini/commands/clavix by default
  */
-export declare class GeminiAdapter extends BaseAdapter {
-    private readonly options;
-    readonly name = "gemini";
-    readonly displayName = "Gemini CLI";
-    readonly fileExtension = ".toml";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        argumentPlaceholder: string;
-    };
+export declare class GeminiAdapter 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=gemini-adapter.d.ts.map

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

@@ -1,56 +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';
 /**
  * Gemini CLI adapter
  * Commands stored as TOML files under .gemini/commands/clavix by default
  */
-export class GeminiAdapter extends BaseAdapter {
-    options;
-    name = 'gemini';
-    displayName = 'Gemini CLI';
-    fileExtension = '.toml';
-    features = {
-        supportsSubdirectories: true,
-        supportsFrontmatter: false,
-        argumentPlaceholder: '{{args}}',
-    };
+export class GeminiAdapter extends TomlFormattingAdapter {
     constructor(options = {}) {
-        super();
-        this.options = options;
-    }
-    get directory() {
-        const useNamespace = this.options.useNamespace ?? true;
-        return useNamespace
-            ? path.join('.gemini', 'commands', 'clavix')
-            : path.join('.gemini', 'commands');
-    }
-    async detectProject() {
-        if (await FileSystem.exists('.gemini')) {
-            return true;
-        }
-        const homePath = path.join(this.getHomeDir(), '.gemini');
-        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: 'gemini',
+            displayName: 'Gemini CLI',
+            rootDir: '.gemini',
+        }, options);
     }
 }
 //# sourceMappingURL=gemini-adapter.js.map

package/dist/core/adapters/llxprt-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';
 /**
  * LLXPRT adapter
  * Commands stored as TOML files under .llxprt/commands/clavix by default
  */
-export declare class LlxprtAdapter extends BaseAdapter {
-    private readonly options;
-    readonly name = "llxprt";
-    readonly displayName = "LLXPRT";
-    readonly fileExtension = ".toml";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        argumentPlaceholder: string;
-    };
+export declare class LlxprtAdapter 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=llxprt-adapter.d.ts.map

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

@@ -1,56 +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';
 /**
  * LLXPRT adapter
  * Commands stored as TOML files under .llxprt/commands/clavix by default
  */
-export class LlxprtAdapter extends BaseAdapter {
-    options;
-    name = 'llxprt';
-    displayName = 'LLXPRT';
-    fileExtension = '.toml';
-    features = {
-        supportsSubdirectories: true,
-        supportsFrontmatter: false,
-        argumentPlaceholder: '{{args}}',
-    };
+export class LlxprtAdapter extends TomlFormattingAdapter {
     constructor(options = {}) {
-        super();
-        this.options = options;
-    }
-    get directory() {
-        const useNamespace = this.options.useNamespace ?? true;
-        return useNamespace
-            ? path.join('.llxprt', 'commands', 'clavix')
-            : path.join('.llxprt', 'commands');
-    }
-    async detectProject() {
-        if (await FileSystem.exists('.llxprt')) {
-            return true;
-        }
-        const homePath = path.join(this.getHomeDir(), '.llxprt');
-        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: 'llxprt',
+            displayName: 'LLXPRT',
+            rootDir: '.llxprt',
+        }, options);
     }
 }
 //# sourceMappingURL=llxprt-adapter.js.map