clavix 5.2.1 → 5.3.0

package/README.md

@@ -12,7 +12,7 @@
 
 | Version | Highlights | Details |
 | --- | --- | --- |
-| **v5.2.0** (Latest) | Diagnose command, DRY architecture, feature matrix | [Changelog](CHANGELOG.md) |
+| **v5.2.1** (Latest) | Diagnose command, DRY architecture, feature matrix | [Changelog](CHANGELOG.md) |
 | **v5.0.0** | Agentic-first architecture - lean template delivery | [Changelog](CHANGELOG.md#500---2025-01-27) |
 | **v4.12.0** | Final v4 release with full CLI commands | [Changelog](docs/archive/v4-changelog.md) |
 
@@ -113,13 +113,12 @@ clavix update   # After npm update clavix
 
 ## CLI Commands
 
-Clavix v5 has 5 CLI commands (for setup and diagnostics, not workflows):
+Clavix v5 has 4 CLI commands (for setup and diagnostics, not workflows):
 
 | Command | Purpose |
 |---------|---------|
-| `clavix init` | Initialize Clavix in a project |
+| `clavix init` | Initialize or reconfigure Clavix in a project |
 | `clavix update` | Update templates after package update |
-| `clavix config` | Manage configuration |
 | `clavix diagnose` | Check installation and report issues |
 | `clavix version` | Show version |
 

package/dist/cli/commands/diagnose.js

@@ -136,7 +136,7 @@ export default class Diagnose extends Command {
                 return {
                     status: 'warn',
                     message: 'No integrations configured',
-                    details: 'Run `clavix config` to add integrations',
+                    details: 'Run `clavix init` to add integrations',
                 };
             }
             return {

package/dist/cli/commands/init.d.ts

@@ -3,6 +3,10 @@ export default class Init extends Command {
     static description: string;
     static examples: string[];
     run(): Promise<void>;
+    /**
+     * Regenerate commands for existing integrations (update mode)
+     */
+    private regenerateCommands;
     private createDirectoryStructure;
     private generateConfig;
     private generateInstructions;

package/dist/cli/commands/init.js

@@ -21,24 +21,9 @@ export default class Init extends Command {
     async run() {
         console.log(chalk.bold.cyan('\n🚀 Clavix Initialization\n'));
         try {
-            // Check if already initialized
-            if (await FileSystem.exists('.clavix')) {
-                const { reinit } = await inquirer.prompt([
-                    {
-                        type: 'confirm',
-                        name: 'reinit',
-                        message: 'Clavix is already initialized. Reinitialize?',
-                        default: false,
-                    },
-                ]);
-                if (!reinit) {
-                    console.log(chalk.yellow('\n✓ Initialization cancelled\n'));
-                    return;
-                }
-            }
-            // Load existing config if re-initializing
             const agentManager = new AgentManager();
             let existingIntegrations = [];
+            // Load existing config if present
             if (await FileSystem.exists('.clavix/config.json')) {
                 try {
                     const configContent = await FileSystem.readFile('.clavix/config.json');
@@ -49,6 +34,45 @@ export default class Init extends Command {
                     // Ignore parse errors, will use empty array
                 }
             }
+            // Check if already initialized
+            if (await FileSystem.exists('.clavix')) {
+                // Show current state
+                console.log(chalk.cyan('You have existing Clavix configuration:'));
+                if (existingIntegrations.length > 0) {
+                    const displayNames = existingIntegrations.map((name) => {
+                        const adapter = agentManager.getAdapter(name);
+                        return adapter?.displayName || name;
+                    });
+                    console.log(chalk.gray(`  Integrations: ${displayNames.join(', ')}\n`));
+                }
+                else {
+                    console.log(chalk.gray('  Integrations: (none configured)\n'));
+                }
+                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' },
+                        ],
+                    },
+                ]);
+                if (action === 'cancel') {
+                    console.log(chalk.yellow('\n✓ Initialization cancelled\n'));
+                    return;
+                }
+                if (action === 'update') {
+                    // Just regenerate commands for existing integrations
+                    console.log(chalk.cyan('\n📝 Regenerating commands...\n'));
+                    await this.regenerateCommands(agentManager, existingIntegrations);
+                    console.log(chalk.green('\n✅ Commands updated successfully!\n'));
+                    return;
+                }
+                // Continue with reconfiguration flow below
+            }
             // Select integrations using shared utility
             console.log(chalk.gray('Select AI development tools to support:\n'));
             console.log(chalk.gray('(Space to select, Enter to confirm)\n'));
@@ -83,6 +107,32 @@ export default class Init extends Command {
                 if (cleanupAction === 'cleanup') {
                     console.log(chalk.gray('\n🗑️  Cleaning up deselected integrations...'));
                     for (const integrationName of deselectedIntegrations) {
+                        // Handle doc generators (AGENTS.md, OCTO.md, WARP.md, copilot-instructions)
+                        if (integrationName === 'agents-md') {
+                            await DocInjector.removeBlock('AGENTS.md');
+                            console.log(chalk.gray('  ✓ Cleaned AGENTS.md Clavix block'));
+                            continue;
+                        }
+                        if (integrationName === 'octo-md') {
+                            await DocInjector.removeBlock('OCTO.md');
+                            console.log(chalk.gray('  ✓ Cleaned OCTO.md Clavix block'));
+                            continue;
+                        }
+                        if (integrationName === 'warp-md') {
+                            await DocInjector.removeBlock('WARP.md');
+                            console.log(chalk.gray('  ✓ Cleaned WARP.md Clavix block'));
+                            continue;
+                        }
+                        if (integrationName === 'copilot-instructions') {
+                            await DocInjector.removeBlock('.github/copilot-instructions.md');
+                            console.log(chalk.gray('  ✓ Cleaned copilot-instructions.md Clavix block'));
+                            continue;
+                        }
+                        // Handle Claude Code (has CLAUDE.md doc injection)
+                        if (integrationName === 'claude-code') {
+                            await DocInjector.removeBlock('CLAUDE.md');
+                            console.log(chalk.gray('  ✓ Cleaned CLAUDE.md Clavix block'));
+                        }
                         const adapter = agentManager.getAdapter(integrationName);
                         if (adapter) {
                             const removed = await adapter.removeAllCommands();
@@ -247,8 +297,69 @@ export default class Init extends Command {
             throw toError(error);
         }
     }
+    /**
+     * Regenerate commands for existing integrations (update mode)
+     */
+    async regenerateCommands(agentManager, integrations) {
+        for (const integrationName of integrations) {
+            // Handle doc generators (not adapters)
+            if (integrationName === 'agents-md') {
+                console.log(chalk.gray('  ✓ Regenerating AGENTS.md...'));
+                await AgentsMdGenerator.generate();
+                continue;
+            }
+            if (integrationName === 'copilot-instructions') {
+                console.log(chalk.gray('  ✓ Regenerating .github/copilot-instructions.md...'));
+                await CopilotInstructionsGenerator.generate();
+                continue;
+            }
+            if (integrationName === 'octo-md') {
+                console.log(chalk.gray('  ✓ Regenerating OCTO.md...'));
+                await OctoMdGenerator.generate();
+                continue;
+            }
+            if (integrationName === 'warp-md') {
+                console.log(chalk.gray('  ✓ Regenerating WARP.md...'));
+                await WarpMdGenerator.generate();
+                continue;
+            }
+            // Handle regular adapters
+            const adapter = agentManager.getAdapter(integrationName);
+            if (!adapter) {
+                console.log(chalk.yellow(`  ⚠ Unknown integration: ${integrationName}`));
+                continue;
+            }
+            console.log(chalk.gray(`  ✓ Regenerating ${adapter.displayName} commands...`));
+            // Remove existing commands before regenerating
+            const removed = await adapter.removeAllCommands();
+            if (removed > 0) {
+                console.log(chalk.gray(`    Removed ${removed} existing command(s)`));
+            }
+            // Generate slash commands
+            const templates = await this.generateSlashCommands(adapter);
+            // Handle legacy command cleanup (silent in update mode)
+            const commandNames = templates.map((template) => template.name);
+            const legacyFiles = await collectLegacyCommandFiles(adapter, commandNames);
+            if (legacyFiles.length > 0) {
+                for (const file of legacyFiles) {
+                    await FileSystem.remove(file);
+                }
+                console.log(chalk.gray(`    Cleaned ${legacyFiles.length} legacy file(s)`));
+            }
+            // Re-inject documentation blocks (Claude Code only)
+            if (integrationName === 'claude-code') {
+                console.log(chalk.gray('  ✓ Updating CLAUDE.md documentation...'));
+                await this.injectDocumentation(adapter);
+            }
+        }
+        // Regenerate instructions folder if needed
+        if (InstructionsGenerator.needsGeneration(integrations)) {
+            console.log(chalk.gray('\n📁 Updating .clavix/instructions/ reference folder...'));
+            await InstructionsGenerator.generate();
+        }
+    }
     async createDirectoryStructure() {
-        const dirs = ['.clavix', '.clavix/sessions', '.clavix/outputs', '.clavix/templates'];
+        const dirs = ['.clavix', '.clavix/outputs', '.clavix/templates'];
         for (const dir of dirs) {
             await FileSystem.ensureDir(dir);
         }
@@ -274,7 +385,6 @@ Welcome to Clavix! This directory contains your local Clavix configuration and d
 ├── config.json           # Your Clavix configuration
 ├── INSTRUCTIONS.md       # This file
 ├── instructions/         # Workflow instruction files for AI agents
-├── sessions/             # Conversational mode session files
 ├── outputs/
 │   ├── <project-name>/  # Per-project outputs
 │   │   ├── full-prd.md
@@ -293,7 +403,7 @@ Welcome to Clavix! This directory contains your local Clavix configuration and d
 |---------|---------|
 | \`clavix init\` | Initialize Clavix in a project |
 | \`clavix update\` | Update templates after package update |
-| \`clavix config\` | Manage configuration |
+| \`clavix diagnose\` | Check installation health |
 | \`clavix version\` | Show version |
 
 ### Workflow Commands (Slash Commands)
@@ -363,11 +473,7 @@ PRD Creation → Task Planning → Implementation → Archive
 
 Create custom templates in \`.clavix/templates/\` to override defaults.
 
-Edit configuration:
-\`\`\`bash
-clavix config edit      # Opens config.json in $EDITOR
-clavix config set key=value
-\`\`\`
+To reconfigure integrations, run \`clavix init\` again.
 
 ## Need Help?
 

package/dist/cli/commands/update.js

@@ -220,7 +220,7 @@ This project uses Clavix for prompt improvement and PRD generation.
 |---------|---------|
 | \`clavix init\` | Initialize Clavix in a project |
 | \`clavix update\` | Update templates after package update |
-| \`clavix config\` | Manage configuration |
+| \`clavix diagnose\` | Check installation health |
 | \`clavix version\` | Show version |
 
 ### Workflow Commands (Slash Commands)

package/dist/constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Clavix constants and magic values
+ * Centralizes hardcoded values for maintainability
+ */
+export declare const BACKUP_EXTENSION = ".backup";
+export declare const SEPARATOR_WIDTH = 50;
+export declare const SEPARATOR_CHAR = "\u2500";
+export declare const CLAVIX_BLOCK_START = "<!-- CLAVIX:START -->";
+export declare const CLAVIX_BLOCK_END = "<!-- CLAVIX:END -->";
+export declare const WINDSURF_CHAR_LIMIT = 12000;
+export declare const DEPTH_STANDARD = "standard";
+export declare const DEPTH_COMPREHENSIVE = "comprehensive";
+export declare const CLAVIX_CONFIG_DIR = ".clavix";
+export declare const CLAVIX_CONFIG_FILE = "config.json";
+export declare const CLAVIX_OUTPUTS_DIR = "outputs";
+export declare const CLAVIX_PROMPTS_DIR = "prompts";
+export declare const CLAVIX_TEMPLATES_DIR = "templates";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -0,0 +1,24 @@
+/**
+ * Clavix constants and magic values
+ * Centralizes hardcoded values for maintainability
+ */
+// File system
+export const BACKUP_EXTENSION = '.backup';
+// CLI formatting
+export const SEPARATOR_WIDTH = 50;
+export const SEPARATOR_CHAR = '─';
+// Clavix managed block markers
+export const CLAVIX_BLOCK_START = '<!-- CLAVIX:START -->';
+export const CLAVIX_BLOCK_END = '<!-- CLAVIX:END -->';
+// Adapter-specific limits
+export const WINDSURF_CHAR_LIMIT = 12000;
+// Depth terminology (canonical)
+export const DEPTH_STANDARD = 'standard';
+export const DEPTH_COMPREHENSIVE = 'comprehensive';
+// File patterns
+export const CLAVIX_CONFIG_DIR = '.clavix';
+export const CLAVIX_CONFIG_FILE = 'config.json';
+export const CLAVIX_OUTPUTS_DIR = 'outputs';
+export const CLAVIX_PROMPTS_DIR = 'prompts';
+export const CLAVIX_TEMPLATES_DIR = 'templates';
+//# sourceMappingURL=constants.js.map

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/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/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