clavix 2.3.0 → 2.4.0

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

@@ -0,0 +1,90 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiAdapter = void 0;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const base_adapter_1 = require("./base-adapter");
+const file_system_1 = require("../../utils/file-system");
+/**
+ * Gemini CLI adapter
+ * Commands stored as TOML files under .gemini/commands/clavix by default
+ */
+class GeminiAdapter extends base_adapter_1.BaseAdapter {
+    constructor(options = {}) {
+        super();
+        this.options = options;
+        this.name = 'gemini';
+        this.displayName = 'Gemini CLI';
+        this.fileExtension = '.toml';
+        this.features = {
+            supportsSubdirectories: true,
+            supportsFrontmatter: false,
+            argumentPlaceholder: '{{args}}',
+        };
+    }
+    get directory() {
+        const useNamespace = this.options.useNamespace ?? true;
+        return useNamespace ? path.join('.gemini', 'commands', 'clavix') : path.join('.gemini', 'commands');
+    }
+    async detectProject() {
+        if (await file_system_1.FileSystem.exists('.gemini')) {
+            return true;
+        }
+        const homePath = path.join(this.getHomeDir(), '.gemini');
+        return await file_system_1.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();
+    }
+}
+exports.GeminiAdapter = GeminiAdapter;
+//# sourceMappingURL=gemini-adapter.js.map

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

@@ -0,0 +1,34 @@
+import { BaseAdapter } from './base-adapter';
+/**
+ * Kilocode adapter
+ * Workflows stored in .kilocode/workflows/ (flat structure, no subdirectories)
+ * Slash command format: /[name.md] (includes .md extension)
+ *
+ * Features:
+ * - Simple markdown with step-by-step instructions
+ * - Supports built-in tools and MCP integrations
+ * - Project-specific workflows only
+ *
+ * Reference: https://kilocode.ai/docs/features/slash-commands/workflows
+ */
+export declare class KilocodeAdapter extends BaseAdapter {
+    readonly name = "kilocode";
+    readonly displayName = "Kilocode";
+    readonly directory = ".kilocode/workflows";
+    readonly fileExtension = ".md";
+    readonly features: {
+        supportsSubdirectories: boolean;
+        supportsFrontmatter: boolean;
+    };
+    /**
+     * Detect if Kilocode is available in the project
+     * Checks for .kilocode directory
+     */
+    detectProject(): Promise<boolean>;
+    /**
+     * Get command path for Kilocode
+     */
+    getCommandPath(): string;
+    getTargetFilename(name: string): string;
+}
+//# sourceMappingURL=kilocode-adapter.d.ts.map

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

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KilocodeAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+const file_system_1 = require("../../utils/file-system");
+/**
+ * Kilocode adapter
+ * Workflows stored in .kilocode/workflows/ (flat structure, no subdirectories)
+ * Slash command format: /[name.md] (includes .md extension)
+ *
+ * Features:
+ * - Simple markdown with step-by-step instructions
+ * - Supports built-in tools and MCP integrations
+ * - Project-specific workflows only
+ *
+ * Reference: https://kilocode.ai/docs/features/slash-commands/workflows
+ */
+class KilocodeAdapter extends base_adapter_1.BaseAdapter {
+    constructor() {
+        super(...arguments);
+        this.name = 'kilocode';
+        this.displayName = 'Kilocode';
+        this.directory = '.kilocode/workflows';
+        this.fileExtension = '.md';
+        this.features = {
+            supportsSubdirectories: false,
+            supportsFrontmatter: false,
+        };
+        // Uses default formatCommand and generateCommands from BaseAdapter
+    }
+    /**
+     * Detect if Kilocode is available in the project
+     * Checks for .kilocode directory
+     */
+    async detectProject() {
+        return await file_system_1.FileSystem.exists('.kilocode');
+    }
+    /**
+     * Get command path for Kilocode
+     */
+    getCommandPath() {
+        return this.directory;
+    }
+    getTargetFilename(name) {
+        return `clavix-${name}${this.fileExtension}`;
+    }
+}
+exports.KilocodeAdapter = KilocodeAdapter;
+//# sourceMappingURL=kilocode-adapter.js.map

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

@@ -0,0 +1,26 @@
+/**
+ * Generator for Octofriend OCTO.md file
+ * Provides workflow instructions optimized for Octofriend capabilities
+ */
+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
+     */
+    static hasClavixBlock(): Promise<boolean>;
+}
+//# sourceMappingURL=octo-md-generator.d.ts.map

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

@@ -0,0 +1,102 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OctoMdGenerator = void 0;
+const file_system_1 = require("../../utils/file-system");
+const path = __importStar(require("path"));
+/**
+ * Generator for Octofriend OCTO.md file
+ * Provides workflow instructions optimized for Octofriend capabilities
+ */
+class OctoMdGenerator {
+    /**
+     * 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 file_system_1.FileSystem.exists(templatePath))) {
+            throw new Error(`OCTO.md template not found at ${templatePath}`);
+        }
+        const template = await file_system_1.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 file_system_1.FileSystem.exists(filePath)) {
+            fileContent = await file_system_1.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 file_system_1.FileSystem.writeFileAtomic(filePath, fileContent);
+    }
+    /**
+     * Escape special regex characters
+     */
+    static escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * Check if OCTO.md has Clavix block
+     */
+    static async hasClavixBlock() {
+        if (!(await file_system_1.FileSystem.exists(this.TARGET_FILE))) {
+            return false;
+        }
+        const content = await file_system_1.FileSystem.readFile(this.TARGET_FILE);
+        return content.includes(this.START_MARKER);
+    }
+}
+exports.OctoMdGenerator = OctoMdGenerator;
+OctoMdGenerator.TARGET_FILE = 'OCTO.md';
+OctoMdGenerator.START_MARKER = '<!-- CLAVIX:START -->';
+OctoMdGenerator.END_MARKER = '<!-- CLAVIX:END -->';
+//# sourceMappingURL=octo-md-generator.js.map

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

@@ -0,0 +1,33 @@
+import { BaseAdapter } from './base-adapter';
+import { CommandTemplate } from '../../types/agent';
+/**
+ * OpenCode adapter
+ * Commands stored in .opencode/command/ with frontmatter
+ * Uses $ARGUMENTS, $1, $2 placeholders
+ */
+export declare class OpenCodeAdapter extends BaseAdapter {
+    readonly name = "opencode";
+    readonly displayName = "OpenCode";
+    readonly directory = ".opencode/command";
+    readonly fileExtension = ".md";
+    readonly features: {
+        supportsSubdirectories: boolean;
+        supportsFrontmatter: boolean;
+        frontmatterFields: string[];
+        argumentPlaceholder: string;
+    };
+    /**
+     * Detect if OpenCode is available in the project
+     */
+    detectProject(): Promise<boolean>;
+    /**
+     * Get command path for OpenCode
+     */
+    getCommandPath(): string;
+    getTargetFilename(name: string): string;
+    /**
+     * Format command with frontmatter for OpenCode
+     */
+    protected formatCommand(template: CommandTemplate): string;
+}
+//# sourceMappingURL=opencode-adapter.d.ts.map

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

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenCodeAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+const file_system_1 = require("../../utils/file-system");
+/**
+ * OpenCode adapter
+ * Commands stored in .opencode/command/ with frontmatter
+ * Uses $ARGUMENTS, $1, $2 placeholders
+ */
+class OpenCodeAdapter extends base_adapter_1.BaseAdapter {
+    constructor() {
+        super(...arguments);
+        this.name = 'opencode';
+        this.displayName = 'OpenCode';
+        this.directory = '.opencode/command';
+        this.fileExtension = '.md';
+        this.features = {
+            supportsSubdirectories: false,
+            supportsFrontmatter: true,
+            frontmatterFields: ['description', 'agent', 'model'],
+            argumentPlaceholder: '$ARGUMENTS',
+        };
+    }
+    /**
+     * Detect if OpenCode is available in the project
+     */
+    async detectProject() {
+        return await file_system_1.FileSystem.exists('.opencode');
+    }
+    /**
+     * Get command path for OpenCode
+     */
+    getCommandPath() {
+        return this.directory;
+    }
+    getTargetFilename(name) {
+        return `clavix-${name}${this.fileExtension}`;
+    }
+    /**
+     * Format command with frontmatter for OpenCode
+     */
+    formatCommand(template) {
+        // Add frontmatter
+        const frontmatter = `---
+description: ${template.description}
+---
+
+`;
+        // Replace generic argument placeholder with $ARGUMENTS
+        const content = template.content.replace(/\{\{ARGS\}\}/g, '$ARGUMENTS');
+        return frontmatter + content;
+    }
+}
+exports.OpenCodeAdapter = OpenCodeAdapter;
+//# sourceMappingURL=opencode-adapter.js.map

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

@@ -0,0 +1,27 @@
+import { BaseAdapter } from './base-adapter';
+import { CommandTemplate } from '../../types/agent';
+/**
+ * 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;
+    };
+    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 2/adapters/qwen-adapter.js

@@ -0,0 +1,90 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QwenAdapter = void 0;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const base_adapter_1 = require("./base-adapter");
+const file_system_1 = require("../../utils/file-system");
+/**
+ * Qwen Code CLI adapter
+ * Commands stored as TOML files under .qwen/commands/clavix by default
+ */
+class QwenAdapter extends base_adapter_1.BaseAdapter {
+    constructor(options = {}) {
+        super();
+        this.options = options;
+        this.name = 'qwen';
+        this.displayName = 'Qwen Code';
+        this.fileExtension = '.toml';
+        this.features = {
+            supportsSubdirectories: true,
+            supportsFrontmatter: false,
+            argumentPlaceholder: '{{args}}',
+        };
+    }
+    get directory() {
+        const useNamespace = this.options.useNamespace ?? true;
+        return useNamespace ? path.join('.qwen', 'commands', 'clavix') : path.join('.qwen', 'commands');
+    }
+    async detectProject() {
+        if (await file_system_1.FileSystem.exists('.qwen')) {
+            return true;
+        }
+        const homePath = path.join(this.getHomeDir(), '.qwen');
+        return await file_system_1.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();
+    }
+}
+exports.QwenAdapter = QwenAdapter;
+//# sourceMappingURL=qwen-adapter.js.map

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

@@ -0,0 +1,40 @@
+import { BaseAdapter } from './base-adapter';
+import { CommandTemplate } from '../../types/agent';
+/**
+ * Roocode adapter
+ * Commands stored in .roo/commands/ (flat structure, no subdirectories)
+ * Slash command format: /[name] (no .md extension, auto-converts to lowercase/dashes)
+ *
+ * Features:
+ * - Supports optional frontmatter (description, argument-hint)
+ * - Command names automatically processed: lowercase, spaces→dashes, special chars removed
+ * - Project commands override global commands
+ *
+ * Reference: https://docs.roocode.com/features/slash-commands
+ */
+export declare class RoocodeAdapter extends BaseAdapter {
+    readonly name = "roocode";
+    readonly displayName = "Roocode";
+    readonly directory = ".roo/commands";
+    readonly fileExtension = ".md";
+    readonly features: {
+        supportsSubdirectories: boolean;
+        supportsFrontmatter: boolean;
+    };
+    /**
+     * Detect if Roocode is available in the project
+     * Checks for .roo directory
+     */
+    detectProject(): Promise<boolean>;
+    /**
+     * Get command path for Roocode
+     */
+    getCommandPath(): string;
+    getTargetFilename(name: string): string;
+    /**
+     * Format command content for Roocode
+     * Adds frontmatter with description and argument-hint if not already present
+     */
+    protected formatCommand(template: CommandTemplate): string;
+}
+//# sourceMappingURL=roocode-adapter.d.ts.map

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

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoocodeAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+const file_system_1 = require("../../utils/file-system");
+/**
+ * Roocode adapter
+ * Commands stored in .roo/commands/ (flat structure, no subdirectories)
+ * Slash command format: /[name] (no .md extension, auto-converts to lowercase/dashes)
+ *
+ * Features:
+ * - Supports optional frontmatter (description, argument-hint)
+ * - Command names automatically processed: lowercase, spaces→dashes, special chars removed
+ * - Project commands override global commands
+ *
+ * Reference: https://docs.roocode.com/features/slash-commands
+ */
+class RoocodeAdapter extends base_adapter_1.BaseAdapter {
+    constructor() {
+        super(...arguments);
+        this.name = 'roocode';
+        this.displayName = 'Roocode';
+        this.directory = '.roo/commands';
+        this.fileExtension = '.md';
+        this.features = {
+            supportsSubdirectories: false,
+            supportsFrontmatter: true,
+        };
+    }
+    /**
+     * Detect if Roocode is available in the project
+     * Checks for .roo directory
+     */
+    async detectProject() {
+        return await file_system_1.FileSystem.exists('.roo');
+    }
+    /**
+     * Get command path for Roocode
+     */
+    getCommandPath() {
+        return this.directory;
+    }
+    getTargetFilename(name) {
+        return `clavix-${name}${this.fileExtension}`;
+    }
+    /**
+     * Format command content for Roocode
+     * Adds frontmatter with description and argument-hint if not already present
+     */
+    formatCommand(template) {
+        const content = template.content;
+        // Check if frontmatter already exists
+        if (content.trim().startsWith('---')) {
+            // Frontmatter already exists, use as-is
+            return content;
+        }
+        // Add Roocode-specific frontmatter
+        const frontmatter = `---
+description: ${template.description || `Clavix ${template.name} command`}
+argument-hint: <prompt>
+---
+
+`;
+        return frontmatter + content;
+    }
+}
+exports.RoocodeAdapter = RoocodeAdapter;
+//# sourceMappingURL=roocode-adapter.js.map

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

@@ -0,0 +1,17 @@
+/**
+ * Generator for Warp WARP.md file
+ * Provides workflow instructions optimized for Warp users
+ */
+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;
+    static hasClavixBlock(): Promise<boolean>;
+}
+//# sourceMappingURL=warp-md-generator.d.ts.map