clavix 5.6.4 → 5.6.5

package/dist/cli/helpers/init/prompts.js

@@ -0,0 +1,97 @@
+/**
+ * Inquirer prompts for Clavix initialization
+ */
+import inquirer from 'inquirer';
+/**
+ * Prompt for action when Clavix is already initialized
+ */
+export async function promptExistingConfigAction() {
+    const { action } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'action',
+            message: 'What would you like to do?',
+            choices: [
+                { name: 'Reconfigure integrations', value: 'reconfigure' },
+                { name: 'Update existing (regenerate commands)', value: 'update' },
+                { name: 'Cancel', value: 'cancel' },
+            ],
+        },
+    ]);
+    return action;
+}
+/**
+ * Prompt for what to do with deselected integrations
+ */
+export async function promptDeselectedAction() {
+    const { cleanupAction } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'cleanupAction',
+            message: 'What would you like to do with these integrations?',
+            choices: [
+                { name: 'Clean up (remove all command files)', value: 'cleanup' },
+                { name: 'Keep (also update their commands)', value: 'update' },
+                { name: 'Skip (leave as-is)', value: 'skip' },
+            ],
+        },
+    ]);
+    return cleanupAction;
+}
+/**
+ * Prompt for Codex CLI confirmation
+ */
+export async function promptCodexConfirmation(codexPath) {
+    const { confirmCodex } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'confirmCodex',
+            message: `Codex commands will be generated at ${codexPath}. Continue?`,
+            default: true,
+        },
+    ]);
+    return confirmCodex;
+}
+/**
+ * Prompt for namespace usage (Gemini/Qwen)
+ */
+export async function promptNamespaceUsage(adapterDisplayName, defaultPath) {
+    const { useNamespace } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'useNamespace',
+            message: `Store ${adapterDisplayName} commands under ${defaultPath}? (Produces /clavix:<command> shortcuts)`,
+            default: true,
+        },
+    ]);
+    return useNamespace;
+}
+/**
+ * Prompt for continuing despite validation errors
+ */
+export async function promptContinueAnyway() {
+    const { continueAnyway } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'continueAnyway',
+            message: 'Continue anyway?',
+            default: false,
+        },
+    ]);
+    return continueAnyway;
+}
+/**
+ * Prompt for removing legacy command files
+ */
+export async function promptRemoveLegacy(adapter) {
+    const { removeLegacy } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'removeLegacy',
+            message: `Remove deprecated files for ${adapter.displayName}? Functionality is unchanged; filenames are being standardized.`,
+            default: true,
+        },
+    ]);
+    return removeLegacy;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/templates/agents/octo.md

@@ -135,6 +135,7 @@ Autofix handles edge cases gracefully - let it work.
 | `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
 | `/clavix:start` | Begin conversational session |
 | `/clavix:summarize` | Extract requirements from conversation |
+| `/clavix:refine` | Refine existing PRD or saved prompt |
 
 ### Agentic Utilities (Project Management)
 | Utility | Purpose |

package/dist/templates/agents/warp.md

@@ -63,6 +63,7 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 | `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
 | `/clavix:start` | Begin conversational session |
 | `/clavix:summarize` | Extract requirements from conversation |
+| `/clavix:refine` | Refine existing PRD or saved prompt |
 
 ### Agentic Utilities (Project Management)
 | Utility | Purpose |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.6.4",
+  "version": "5.6.5",
   "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",
@@ -13,8 +13,9 @@
     "./package.json": "./package.json"
   },
   "scripts": {
+    "clean": "rm -rf dist",
     "validate:consistency": "node --loader ts-node/esm scripts/validate-consistency.ts",
-    "prebuild": "npm run validate:consistency",
+    "prebuild": "npm run clean && npm run validate:consistency",
     "build": "tsc && npm run copy-templates",
     "build:prod": "npm run build && npm run remove-sourcemaps",
     "copy-templates": "rm -rf dist/templates && copyfiles -u 1 \"src/templates/**/*\" dist/ && copyfiles -u 1 \"src/config/**/*\" dist/",

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

@@ -1,30 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-/**
- * Amp adapter
- * Commands stored in .agents/commands/ (simple markdown, no frontmatter)
- * Supports executable commands (experimental)
- */
-export declare class AmpAdapter extends BaseAdapter {
-    readonly name = "amp";
-    readonly displayName = "Amp";
-    readonly directory = ".agents/commands";
-    readonly fileExtension = ".md";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        supportsExecutableCommands: boolean;
-        commandFormat: {
-            separator: "-";
-        };
-    };
-    /**
-     * Detect if Amp is available in the project
-     */
-    detectProject(): Promise<boolean>;
-    /**
-     * Get command path for Amp
-     */
-    getCommandPath(): string;
-    getTargetFilename(name: string): string;
-}
-//# sourceMappingURL=amp-adapter.d.ts.map

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

@@ -1,35 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
-/**
- * Amp adapter
- * Commands stored in .agents/commands/ (simple markdown, no frontmatter)
- * Supports executable commands (experimental)
- */
-export class AmpAdapter extends BaseAdapter {
-    name = 'amp';
-    displayName = 'Amp';
-    directory = '.agents/commands';
-    fileExtension = '.md';
-    features = {
-        supportsSubdirectories: false,
-        supportsFrontmatter: false,
-        supportsExecutableCommands: true,
-        commandFormat: { separator: '-' },
-    };
-    /**
-     * Detect if Amp is available in the project
-     */
-    async detectProject() {
-        return await FileSystem.exists('.agents');
-    }
-    /**
-     * Get command path for Amp
-     */
-    getCommandPath() {
-        return this.directory;
-    }
-    getTargetFilename(name) {
-        return `clavix-${name}${this.fileExtension}`;
-    }
-}
-//# sourceMappingURL=amp-adapter.js.map

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

@@ -1,22 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-import { CommandTemplate } from '../../types/agent.js';
-/**
- * Augment CLI adapter
- * Commands stored in .augment/commands/clavix with optional subdirectories
- */
-export declare class AugmentAdapter extends BaseAdapter {
-    readonly name = "augment";
-    readonly displayName = "Augment CLI";
-    readonly directory = ".augment/commands/clavix";
-    readonly fileExtension = ".md";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        frontmatterFields: string[];
-    };
-    detectProject(): Promise<boolean>;
-    getCommandPath(): string;
-    protected formatCommand(template: CommandTemplate): string;
-    private getHomeDir;
-}
-//# sourceMappingURL=augment-adapter.d.ts.map

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

@@ -1,37 +0,0 @@
-import * as os from 'os';
-import * as path from 'path';
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
-/**
- * Augment CLI adapter
- * Commands stored in .augment/commands/clavix with optional subdirectories
- */
-export class AugmentAdapter extends BaseAdapter {
-    name = 'augment';
-    displayName = 'Augment CLI';
-    directory = '.augment/commands/clavix';
-    fileExtension = '.md';
-    features = {
-        supportsSubdirectories: true,
-        supportsFrontmatter: true,
-        frontmatterFields: ['description', 'argument-hint', 'model'],
-    };
-    async detectProject() {
-        if (await FileSystem.exists('.augment')) {
-            return true;
-        }
-        const homeAugmentDir = path.join(this.getHomeDir(), '.augment');
-        return FileSystem.exists(homeAugmentDir);
-    }
-    getCommandPath() {
-        return this.directory;
-    }
-    formatCommand(template) {
-        const frontmatter = `---\ndescription: ${template.description}\nargument-hint: [prompt]\n---\n\n`;
-        return frontmatter + template.content;
-    }
-    getHomeDir() {
-        return process.env.CLAVIX_HOME_OVERRIDE || os.homedir();
-    }
-}
-//# sourceMappingURL=augment-adapter.js.map

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

@@ -1,37 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-/**
- * Cline adapter
- * Workflows stored in .cline/workflows/ (flat structure, no subdirectories)
- * Slash command format: /<name.md> (includes .md extension with leading slash)
- *
- * Features:
- * - Lives alongside Cline Rules
- * - Clear step-by-step instructions in markdown
- * - Supports built-in tools, CLI utilities, and MCP integrations
- *
- * Reference: https://docs.cline.bot/features/slash-commands/workflows
- */
-export declare class ClineAdapter extends BaseAdapter {
-    readonly name = "cline";
-    readonly displayName = "Cline";
-    readonly directory = ".clinerules/workflows";
-    readonly fileExtension = ".md";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        commandFormat: {
-            separator: "-";
-        };
-    };
-    /**
-     * Detect if Cline is available in the project
-     * Checks for .cline directory
-     */
-    detectProject(): Promise<boolean>;
-    /**
-     * Get command path for Cline
-     */
-    getCommandPath(): string;
-    getTargetFilename(name: string): string;
-}
-//# sourceMappingURL=cline-adapter.d.ts.map

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

@@ -1,45 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
-/**
- * Cline adapter
- * Workflows stored in .cline/workflows/ (flat structure, no subdirectories)
- * Slash command format: /<name.md> (includes .md extension with leading slash)
- *
- * Features:
- * - Lives alongside Cline Rules
- * - Clear step-by-step instructions in markdown
- * - Supports built-in tools, CLI utilities, and MCP integrations
- *
- * Reference: https://docs.cline.bot/features/slash-commands/workflows
- */
-export class ClineAdapter extends BaseAdapter {
-    name = 'cline';
-    displayName = 'Cline';
-    directory = '.clinerules/workflows';
-    fileExtension = '.md';
-    features = {
-        supportsSubdirectories: false,
-        supportsFrontmatter: false,
-        commandFormat: { separator: '-' },
-    };
-    /**
-     * Detect if Cline is available in the project
-     * Checks for .cline directory
-     */
-    async detectProject() {
-        if (await FileSystem.exists('.clinerules')) {
-            return true;
-        }
-        return await FileSystem.exists('.cline');
-    }
-    /**
-     * Get command path for Cline
-     */
-    getCommandPath() {
-        return this.directory;
-    }
-    getTargetFilename(name) {
-        return `clavix-${name}${this.fileExtension}`;
-    }
-}
-//# sourceMappingURL=cline-adapter.js.map

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

@@ -1,27 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-import { CommandTemplate } from '../../types/agent.js';
-/**
- * CodeBuddy CLI adapter
- * Commands stored in .codebuddy/commands with YAML frontmatter
- */
-export declare class CodeBuddyAdapter extends BaseAdapter {
-    readonly name = "codebuddy";
-    readonly displayName = "CodeBuddy";
-    readonly directory = ".codebuddy/commands";
-    readonly fileExtension = ".md";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        argumentPlaceholder: string;
-        frontmatterFields: string[];
-        commandFormat: {
-            separator: "-";
-        };
-    };
-    detectProject(): Promise<boolean>;
-    getCommandPath(): string;
-    getTargetFilename(name: string): string;
-    protected formatCommand(template: CommandTemplate): string;
-    private getHomeDir;
-}
-//# sourceMappingURL=codebuddy-adapter.d.ts.map

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

@@ -1,43 +0,0 @@
-import * as os from 'os';
-import * as path from 'path';
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
-/**
- * CodeBuddy CLI adapter
- * Commands stored in .codebuddy/commands with YAML frontmatter
- */
-export class CodeBuddyAdapter extends BaseAdapter {
-    name = 'codebuddy';
-    displayName = 'CodeBuddy';
-    directory = '.codebuddy/commands';
-    fileExtension = '.md';
-    features = {
-        supportsSubdirectories: false,
-        supportsFrontmatter: true,
-        argumentPlaceholder: '$1',
-        frontmatterFields: ['description', 'argument-hint'],
-        commandFormat: { separator: '-' },
-    };
-    async detectProject() {
-        if (await FileSystem.exists('.codebuddy')) {
-            return true;
-        }
-        const homePath = path.join(this.getHomeDir(), '.codebuddy');
-        return await FileSystem.exists(homePath);
-    }
-    getCommandPath() {
-        return this.directory;
-    }
-    getTargetFilename(name) {
-        return `clavix-${name}${this.fileExtension}`;
-    }
-    formatCommand(template) {
-        const frontmatter = `---\ndescription: ${template.description}\nargument-hint: [prompt]\n---\n\n`;
-        const content = template.content.replace(/\{\{ARGS\}\}/g, '$1');
-        return frontmatter + content;
-    }
-    getHomeDir() {
-        return process.env.CLAVIX_HOME_OVERRIDE || os.homedir();
-    }
-}
-//# sourceMappingURL=codebuddy-adapter.js.map

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

@@ -1,27 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-import { CommandTemplate } from '../../types/agent.js';
-/**
- * Codex CLI adapter
- * Commands stored globally under ~/.codex/prompts
- */
-export declare class CodexAdapter extends BaseAdapter {
-    readonly name = "codex";
-    readonly displayName = "Codex CLI";
-    readonly directory = "~/.codex/prompts";
-    readonly fileExtension = ".md";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        argumentPlaceholder: string;
-        frontmatterFields: string[];
-        commandFormat: {
-            separator: "-";
-        };
-    };
-    detectProject(): Promise<boolean>;
-    getCommandPath(): string;
-    getTargetFilename(name: string): string;
-    protected formatCommand(template: CommandTemplate): string;
-    private getHomeDir;
-}
-//# sourceMappingURL=codex-adapter.d.ts.map

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

@@ -1,40 +0,0 @@
-import * as os from 'os';
-import * as path from 'path';
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
-/**
- * Codex CLI adapter
- * Commands stored globally under ~/.codex/prompts
- */
-export class CodexAdapter extends BaseAdapter {
-    name = 'codex';
-    displayName = 'Codex CLI';
-    directory = '~/.codex/prompts';
-    fileExtension = '.md';
-    features = {
-        supportsSubdirectories: false,
-        supportsFrontmatter: true,
-        argumentPlaceholder: '$ARGUMENTS',
-        frontmatterFields: ['description', 'argument-hint'],
-        commandFormat: { separator: '-' },
-    };
-    async detectProject() {
-        const codexDir = path.join(this.getHomeDir(), '.codex');
-        return await FileSystem.exists(codexDir);
-    }
-    getCommandPath() {
-        return path.join(this.getHomeDir(), '.codex', 'prompts');
-    }
-    getTargetFilename(name) {
-        return `clavix-${name}${this.fileExtension}`;
-    }
-    formatCommand(template) {
-        const frontmatter = `---\ndescription: ${template.description}\nargument-hint: [prompt]\n---\n\n`;
-        const content = template.content.replace(/\{\{ARGS\}\}/g, '$ARGUMENTS');
-        return frontmatter + content;
-    }
-    getHomeDir() {
-        return process.env.CLAVIX_HOME_OVERRIDE || os.homedir();
-    }
-}
-//# sourceMappingURL=codex-adapter.js.map

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

@@ -1,35 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-import { CommandTemplate } from '../../types/agent.js';
-/**
- * Crush CLI adapter
- * Commands stored in .crush/commands/clavix/ (supports subdirectories)
- * Uses $PROMPT placeholder for user input (Crush-specific syntax)
- *
- * Reference: https://github.com/charmbracelet/crush/blob/main/COMMANDS.md
- */
-export declare class CrushAdapter extends BaseAdapter {
-    readonly name = "crush";
-    readonly displayName = "Crush CLI";
-    readonly directory = ".crush/commands/clavix";
-    readonly fileExtension = ".md";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        argumentPlaceholder: string;
-    };
-    /**
-     * Detect if Crush is available in the project
-     * Checks for .crush directory (project-level commands)
-     */
-    detectProject(): Promise<boolean>;
-    /**
-     * Get command path for Crush
-     */
-    getCommandPath(): string;
-    /**
-     * Format command content for Crush
-     * Replaces generic {{ARGS}} placeholder with Crush-specific $PROMPT
-     */
-    protected formatCommand(template: CommandTemplate): string;
-}
-//# sourceMappingURL=crush-adapter.d.ts.map

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

@@ -1,42 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
-/**
- * Crush CLI adapter
- * Commands stored in .crush/commands/clavix/ (supports subdirectories)
- * Uses $PROMPT placeholder for user input (Crush-specific syntax)
- *
- * Reference: https://github.com/charmbracelet/crush/blob/main/COMMANDS.md
- */
-export class CrushAdapter extends BaseAdapter {
-    name = 'crush';
-    displayName = 'Crush CLI';
-    directory = '.crush/commands/clavix';
-    fileExtension = '.md';
-    features = {
-        supportsSubdirectories: true,
-        supportsFrontmatter: false,
-        argumentPlaceholder: '$PROMPT',
-    };
-    /**
-     * Detect if Crush is available in the project
-     * Checks for .crush directory (project-level commands)
-     */
-    async detectProject() {
-        return await FileSystem.exists('.crush');
-    }
-    /**
-     * Get command path for Crush
-     */
-    getCommandPath() {
-        return this.directory;
-    }
-    /**
-     * Format command content for Crush
-     * Replaces generic {{ARGS}} placeholder with Crush-specific $PROMPT
-     */
-    formatCommand(template) {
-        // Replace Clavix generic placeholder with Crush placeholder
-        return template.content.replace(/\{\{ARGS\}\}/g, '$PROMPT');
-    }
-}
-//# sourceMappingURL=crush-adapter.js.map

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

@@ -1,28 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-/**
- * Cursor IDE adapter
- * Commands are stored in .cursor/commands/ (flat structure, no subdirectories)
- */
-export declare class CursorAdapter extends BaseAdapter {
-    readonly name = "cursor";
-    readonly displayName = "Cursor";
-    readonly directory = ".cursor/commands";
-    readonly fileExtension = ".md";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        commandFormat: {
-            separator: "-";
-        };
-    };
-    /**
-     * Detect if Cursor is available in the project
-     */
-    detectProject(): Promise<boolean>;
-    /**
-     * Get command path for Cursor
-     */
-    getCommandPath(): string;
-    getTargetFilename(name: string): string;
-}
-//# sourceMappingURL=cursor-adapter.d.ts.map

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

@@ -1,33 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
-/**
- * Cursor IDE adapter
- * Commands are stored in .cursor/commands/ (flat structure, no subdirectories)
- */
-export class CursorAdapter extends BaseAdapter {
-    name = 'cursor';
-    displayName = 'Cursor';
-    directory = '.cursor/commands';
-    fileExtension = '.md';
-    features = {
-        supportsSubdirectories: false,
-        supportsFrontmatter: false,
-        commandFormat: { separator: '-' },
-    };
-    /**
-     * Detect if Cursor is available in the project
-     */
-    async detectProject() {
-        return await FileSystem.exists('.cursor');
-    }
-    /**
-     * Get command path for Cursor
-     */
-    getCommandPath() {
-        return this.directory;
-    }
-    getTargetFilename(name) {
-        return `clavix-${name}${this.fileExtension}`;
-    }
-}
-//# sourceMappingURL=cursor-adapter.js.map

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

@@ -1,36 +0,0 @@
-import { BaseAdapter } from './base-adapter.js';
-import { CommandTemplate } from '../../types/agent.js';
-/**
- * Droid CLI adapter (Factory.ai)
- * Commands stored in .factory/commands/ with YAML frontmatter
- * Uses $ARGUMENTS placeholder for command arguments
- */
-export declare class DroidAdapter extends BaseAdapter {
-    readonly name = "droid";
-    readonly displayName = "Droid CLI";
-    readonly directory = ".factory/commands";
-    readonly fileExtension = ".md";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        frontmatterFields: string[];
-        argumentPlaceholder: string;
-        commandFormat: {
-            separator: "-";
-        };
-    };
-    /**
-     * Detect if Droid CLI is available in the project
-     */
-    detectProject(): Promise<boolean>;
-    /**
-     * Get command path for Droid CLI
-     */
-    getCommandPath(): string;
-    getTargetFilename(name: string): string;
-    /**
-     * Format command with YAML frontmatter for Droid CLI
-     */
-    protected formatCommand(template: CommandTemplate): string;
-}
-//# sourceMappingURL=droid-adapter.d.ts.map