clavix 5.8.0 → 5.8.1

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

@@ -11,7 +11,6 @@ export default class Init extends Command {
     private generateConfig;
     private generateInstructions;
     private generateSlashCommands;
-    private handleLegacyCommands;
     private injectDocumentation;
     private extractClavixBlock;
     private generateQuickstart;

package/dist/cli/commands/init.js

@@ -17,7 +17,6 @@ import { DEFAULT_CONFIG } from '../../types/config.js';
 import { GeminiAdapter } from '../../core/adapters/gemini-adapter.js';
 import { QwenAdapter } from '../../core/adapters/qwen-adapter.js';
 import { loadCommandTemplates } from '../../utils/template-loader.js';
-import { collectLegacyCommandFiles } from '../../utils/legacy-command-cleanup.js';
 import { CLAVIX_BLOCK_START, CLAVIX_BLOCK_END } from '../../constants.js';
 import { validateUserConfig } from '../../utils/schemas.js';
 export default class Init extends Command {
@@ -274,7 +273,6 @@ export default class Init extends Command {
                 }
                 // Generate slash commands
                 const generatedTemplates = await this.generateSlashCommands(adapter);
-                await this.handleLegacyCommands(adapter, generatedTemplates);
                 if (adapter.name === 'gemini' || adapter.name === 'qwen') {
                     const commandPath = adapter.getCommandPath();
                     const isNamespaced = commandPath.endsWith(path.join('commands', 'clavix'));
@@ -379,16 +377,7 @@ export default class Init extends Command {
                 this.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);
-                }
-                this.log(chalk.gray(`    Cleaned ${legacyFiles.length} legacy file(s)`));
-            }
+            await this.generateSlashCommands(adapter);
             // Re-inject documentation blocks (Claude Code only)
             if (integrationName === 'claude-code') {
                 this.log(chalk.gray('  ✓ Updating CLAUDE.md documentation...'));
@@ -543,36 +532,6 @@ To reconfigure integrations, run \`clavix init\` again.
         await adapter.generateCommands(templates);
         return templates;
     }
-    async handleLegacyCommands(adapter, templates) {
-        const commandNames = templates.map((template) => template.name);
-        const legacyFiles = await collectLegacyCommandFiles(adapter, commandNames);
-        if (legacyFiles.length === 0) {
-            return;
-        }
-        const relativePaths = legacyFiles
-            .map((file) => path.relative(process.cwd(), file))
-            .sort((a, b) => a.localeCompare(b));
-        this.log(chalk.gray(`    ⚠ Found ${relativePaths.length} deprecated command file(s):`));
-        for (const file of relativePaths) {
-            this.log(chalk.gray(`      • ${file}`));
-        }
-        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,
-            },
-        ]);
-        if (!removeLegacy) {
-            this.log(chalk.gray('    ⊗ Kept legacy files (deprecated naming retained)'));
-            return;
-        }
-        for (const file of legacyFiles) {
-            await FileSystem.remove(file);
-            this.log(chalk.gray(`    ✓ Removed ${path.relative(process.cwd(), file)}`));
-        }
-    }
     async injectDocumentation(adapter) {
         // Inject AGENTS.md
         const agentsContent = DocInjector.getDefaultAgentsContent();

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

@@ -10,7 +10,6 @@ export default class Update extends Command {
     run(): Promise<void>;
     private updateDocumentation;
     private updateCommands;
-    private handleLegacyCommands;
     private getAgentsContent;
     private getClaudeContent;
     private hasUpToDateBlock;

package/dist/cli/commands/update.js

@@ -1,6 +1,5 @@
 import { Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
-import inquirer from 'inquirer';
 import fs from 'fs-extra';
 import * as path from 'path';
 import { DocInjector } from '../../core/doc-injector.js';
@@ -9,7 +8,6 @@ import { AgentsMdGenerator } from '../../core/adapters/agents-md-generator.js';
 import { OctoMdGenerator } from '../../core/adapters/octo-md-generator.js';
 import { WarpMdGenerator } from '../../core/adapters/warp-md-generator.js';
 import { InstructionsGenerator } from '../../core/adapters/instructions-generator.js';
-import { collectLegacyCommandFiles } from '../../utils/legacy-command-cleanup.js';
 import { CLAVIX_BLOCK_START, CLAVIX_BLOCK_END } from '../../constants.js';
 import { validateUserConfig, formatZodErrors } from '../../utils/schemas.js';
 export default class Update extends Command {
@@ -187,7 +185,7 @@ export default class Update extends Command {
         }
         return updated;
     }
-    async updateCommands(adapter, force) {
+    async updateCommands(adapter, _force) {
         this.log(chalk.cyan(`\n🔧 Updating slash commands for ${adapter.displayName}...`));
         // Remove all existing commands first (force regeneration)
         const removed = await adapter.removeAllCommands();
@@ -204,47 +202,7 @@ export default class Update extends Command {
         // Generate fresh commands from templates
         await adapter.generateCommands(templates);
         this.log(chalk.gray(`  ✓ Generated ${templates.length} command(s)`));
-        // Handle legacy commands (cleanup old naming patterns)
-        const commandNames = templates.map((t) => t.name);
-        const legacyRemoved = await this.handleLegacyCommands(adapter, commandNames, force);
-        return removed + templates.length + legacyRemoved;
-    }
-    async handleLegacyCommands(adapter, commandNames, force) {
-        if (commandNames.length === 0) {
-            return 0;
-        }
-        const legacyFiles = await collectLegacyCommandFiles(adapter, commandNames);
-        if (legacyFiles.length === 0) {
-            return 0;
-        }
-        const relativePaths = legacyFiles
-            .map((file) => path.relative(process.cwd(), file))
-            .sort((a, b) => a.localeCompare(b));
-        this.log(chalk.gray(`  ⚠ Found ${relativePaths.length} deprecated command file(s):`));
-        for (const file of relativePaths) {
-            this.log(chalk.gray(`    • ${file}`));
-        }
-        if (!force) {
-            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,
-                },
-            ]);
-            if (!removeLegacy) {
-                this.log(chalk.gray('  ⊗ Kept legacy files (deprecated naming retained)'));
-                return 0;
-            }
-        }
-        let removed = 0;
-        for (const file of legacyFiles) {
-            await fs.remove(file);
-            this.log(chalk.gray(`  ✓ Removed ${path.relative(process.cwd(), file)}`));
-            removed++;
-        }
-        return removed;
+        return removed + templates.length;
     }
     getAgentsContent() {
         return `## Clavix Integration

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

@@ -7,17 +7,4 @@ import type { AgentAdapter, CommandTemplate } from '../../../types/agent.js';
  * Returns the generated templates
  */
 export declare function generateSlashCommands(adapter: AgentAdapter): Promise<CommandTemplate[]>;
-/**
- * Collect and optionally remove legacy command files
- * Returns paths of legacy files found
- */
-export declare function collectLegacyFiles(adapter: AgentAdapter, templates: CommandTemplate[]): Promise<string[]>;
-/**
- * Remove legacy command files
- */
-export declare function removeLegacyFiles(files: string[]): Promise<void>;
-/**
- * Get relative paths for legacy files (for display)
- */
-export declare function getLegacyRelativePaths(files: string[]): string[];
 //# sourceMappingURL=commands.d.ts.map

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

@@ -1,10 +1,7 @@
 /**
  * Slash command generation for Clavix initialization
  */
-import * as path from 'path';
-import { FileSystem } from '../../../utils/file-system.js';
 import { loadCommandTemplates } from '../../../utils/template-loader.js';
-import { collectLegacyCommandFiles } from '../../../utils/legacy-command-cleanup.js';
 /**
  * Generate slash commands for an adapter
  * Returns the generated templates
@@ -14,26 +11,4 @@ export async function generateSlashCommands(adapter) {
     await adapter.generateCommands(templates);
     return templates;
 }
-/**
- * Collect and optionally remove legacy command files
- * Returns paths of legacy files found
- */
-export async function collectLegacyFiles(adapter, templates) {
-    const commandNames = templates.map((template) => template.name);
-    return collectLegacyCommandFiles(adapter, commandNames);
-}
-/**
- * Remove legacy command files
- */
-export async function removeLegacyFiles(files) {
-    for (const file of files) {
-        await FileSystem.remove(file);
-    }
-}
-/**
- * Get relative paths for legacy files (for display)
- */
-export function getLegacyRelativePaths(files) {
-    return files.map((file) => path.relative(process.cwd(), file)).sort((a, b) => a.localeCompare(b));
-}
 //# sourceMappingURL=commands.js.map

package/dist/templates/slash-commands/_canonical/archive.md

@@ -274,11 +274,14 @@ Result: Project permanently deleted
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
 
+### Workflow State Detection
+{{INCLUDE:agent-protocols/state-awareness.md}}
+
 ### CLI Reference
 {{INCLUDE:agent-protocols/cli-reference.md}}
 

package/dist/templates/slash-commands/_canonical/implement.md

@@ -524,7 +524,7 @@ I'll explain what's wrong and what you might need to do:
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/improve.md

@@ -522,7 +522,7 @@ Wait for the user to decide what to do next.
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/plan.md

@@ -219,7 +219,7 @@ Present the plan and ask:
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/prd.md

@@ -344,7 +344,7 @@ The validation ensures generated PRDs are immediately usable for AI consumption
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
@@ -361,6 +361,9 @@ The validation ensures generated PRDs are immediately usable for AI consumption
 ### CLI Reference
 {{INCLUDE:agent-protocols/cli-reference.md}}
 
+### Recovery Patterns
+{{INCLUDE:troubleshooting/vibecoder-recovery.md}}
+
 ---
 
 ## Troubleshooting

package/dist/templates/slash-commands/_canonical/refine.md

@@ -415,7 +415,7 @@ I'll update the PRD and add this to the refinement history. Confirm?
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
@@ -429,6 +429,9 @@ I'll update the PRD and add this to the refinement history. Confirm?
 ### Workflow State Detection
 {{INCLUDE:agent-protocols/state-awareness.md}}
 
+### Recovery Patterns
+{{INCLUDE:troubleshooting/vibecoder-recovery.md}}
+
 ---
 
 ## Workflow Navigation

package/dist/templates/slash-commands/_canonical/start.md

@@ -226,11 +226,17 @@ The goal is natural exploration of requirements, not a rigid questionnaire. Foll
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
 
+### Workflow State Detection
+{{INCLUDE:agent-protocols/state-awareness.md}}
+
+### CLI Reference
+{{INCLUDE:agent-protocols/cli-reference.md}}
+
 ### Conversational Companion
 {{INCLUDE:agent-protocols/supportive-companion.md}}
 

package/dist/templates/slash-commands/_canonical/summarize.md

@@ -401,7 +401,7 @@ The `/clavix:summarize` command extracts requirements from exploratory conversat
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
@@ -415,6 +415,9 @@ The `/clavix:summarize` command extracts requirements from exploratory conversat
 ### Workflow State Detection
 {{INCLUDE:agent-protocols/state-awareness.md}}
 
+### CLI Reference
+{{INCLUDE:agent-protocols/cli-reference.md}}
+
 ### Recovery Patterns
 {{INCLUDE:troubleshooting/vibecoder-recovery.md}}
 

package/dist/templates/slash-commands/_canonical/verify.md

@@ -123,7 +123,7 @@ Implementation: BLOCKED - I'll analyze and report, not modify or fix
 
 ----
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.8.0",
+  "version": "5.8.1",
   "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  /clavix:refine     Refine existing PRD or prompt\n  /clavix:verify     Verify implementation against requirements\n  /clavix:archive    Archive completed projects\n\nWorks with Claude Code, Cursor, Windsurf, and 20 AI coding tools.",
   "type": "module",
   "main": "dist/index.js",

package/dist/utils/legacy-command-cleanup.d.ts

@@ -1,19 +0,0 @@
-/**
- * Legacy Command Cleanup Utility
- *
- * This module handles cleanup of old command naming patterns from previous
- * Clavix versions. It identifies files using deprecated naming conventions
- * and assists in migration to the current standard.
- *
- * Handles cleanup of:
- * - fast.md, deep.md (replaced by improve.md in v4.11+)
- * - Old naming patterns (clavix-{name} vs {name})
- * - Subdirectory migration for Cline and Claude Code
- *
- * This module will be removed when v4->v5 migration support ends.
- *
- * @since v4.12.0
- */
-import { AgentAdapter } from '../types/agent.js';
-export declare function collectLegacyCommandFiles(adapter: AgentAdapter, commandNames: string[]): Promise<string[]>;
-//# sourceMappingURL=legacy-command-cleanup.d.ts.map

package/dist/utils/legacy-command-cleanup.js

@@ -1,99 +0,0 @@
-/**
- * Legacy Command Cleanup Utility
- *
- * This module handles cleanup of old command naming patterns from previous
- * Clavix versions. It identifies files using deprecated naming conventions
- * and assists in migration to the current standard.
- *
- * Handles cleanup of:
- * - fast.md, deep.md (replaced by improve.md in v4.11+)
- * - Old naming patterns (clavix-{name} vs {name})
- * - Subdirectory migration for Cline and Claude Code
- *
- * This module will be removed when v4->v5 migration support ends.
- *
- * @since v4.12.0
- */
-import * as path from 'path';
-import { FileSystem } from './file-system.js';
-/**
- * v4.12: Deprecated commands that have been replaced
- * - fast → improve (unified with auto-depth)
- * - deep → improve --comprehensive
- */
-const DEPRECATED_COMMANDS = ['fast', 'deep'];
-export async function collectLegacyCommandFiles(adapter, commandNames) {
-    const legacyPaths = new Set();
-    const extension = adapter.fileExtension;
-    const commandDir = path.resolve(adapter.getCommandPath());
-    // v4.12: Clean up deprecated fast/deep commands
-    for (const deprecatedName of DEPRECATED_COMMANDS) {
-        // Check for various naming patterns across adapters
-        const candidates = [
-            path.resolve(commandDir, `${deprecatedName}${extension}`),
-            path.resolve(commandDir, `clavix-${deprecatedName}${extension}`),
-            path.resolve(commandDir, `clavix:${deprecatedName}${extension}`),
-        ];
-        // For Claude Code with subdirectory structure
-        if (adapter.name === 'claude-code') {
-            const clavixDir = path.resolve(commandDir, 'clavix');
-            candidates.push(path.resolve(clavixDir, `${deprecatedName}${extension}`), path.resolve(clavixDir, `clavix-${deprecatedName}${extension}`));
-        }
-        for (const candidate of candidates) {
-            if (await FileSystem.exists(candidate)) {
-                legacyPaths.add(candidate);
-            }
-        }
-    }
-    for (const name of commandNames) {
-        const newFilePath = path.resolve(commandDir, adapter.getTargetFilename(name));
-        const defaultFilePath = path.resolve(commandDir, `${name}${extension}`);
-        if (adapter.name === 'cline') {
-            const oldDir = path.resolve('.cline', 'workflows');
-            const oldCandidates = [
-                path.join(oldDir, `${name}${extension}`),
-                path.join(oldDir, `clavix-${name}${extension}`),
-            ];
-            for (const candidate of oldCandidates) {
-                const resolvedCandidate = path.resolve(candidate);
-                if (resolvedCandidate !== newFilePath && (await FileSystem.exists(resolvedCandidate))) {
-                    legacyPaths.add(resolvedCandidate);
-                }
-            }
-            if (defaultFilePath !== newFilePath && (await FileSystem.exists(defaultFilePath))) {
-                legacyPaths.add(defaultFilePath);
-            }
-            continue;
-        }
-        if (adapter.name === 'gemini' || adapter.name === 'qwen') {
-            const namespaced = commandDir.endsWith(path.join('commands', 'clavix'));
-            if (!namespaced &&
-                defaultFilePath !== newFilePath &&
-                (await FileSystem.exists(defaultFilePath))) {
-                legacyPaths.add(defaultFilePath);
-            }
-        }
-        else if (defaultFilePath !== newFilePath && (await FileSystem.exists(defaultFilePath))) {
-            legacyPaths.add(defaultFilePath);
-        }
-    }
-    if (adapter.name === 'claude-code') {
-        const commandsDir = path.resolve('.claude', 'commands');
-        const colonFiles = await FileSystem.listFiles(commandsDir, /^clavix:.*\.md$/);
-        for (const file of colonFiles) {
-            legacyPaths.add(path.resolve(path.join(commandsDir, file)));
-        }
-        const clavixDir = path.resolve(commandsDir, 'clavix');
-        const hyphenFiles = await FileSystem.listFiles(clavixDir, /^clavix-.*\.md$/);
-        for (const file of hyphenFiles) {
-            legacyPaths.add(path.resolve(path.join(clavixDir, file)));
-        }
-        // Remove task-complete.md (CLI-only command, not a user-facing slash command)
-        const taskCompleteFile = path.resolve(clavixDir, 'task-complete.md');
-        if (await FileSystem.exists(taskCompleteFile)) {
-            legacyPaths.add(taskCompleteFile);
-        }
-    }
-    return Array.from(legacyPaths);
-}
-//# sourceMappingURL=legacy-command-cleanup.js.map