clavix 5.4.0 → 5.5.0

package/README.md

@@ -12,9 +12,8 @@
 
 | Version | Highlights | Details |
 | --- | --- | --- |
-| **v5.2.1** (Latest) | Diagnose command, DRY architecture, feature matrix | [Changelog](CHANGELOG.md) |
+| **v5.5.0** (Latest) | Architecture cleanup, consolidated adapters, documentation overhaul | [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) |
 
 **Requirements:** Node.js >= 18.0.0
 
@@ -129,7 +128,6 @@ Clavix v5 has 4 CLI commands (for setup and diagnostics, not workflows):
 - Integrations: [docs/integrations.md](docs/integrations.md)
 - How it works: [docs/how-it-works.md](docs/how-it-works.md)
 - Philosophy: [docs/philosophy.md](docs/philosophy.md)
-- v4 Architecture (archived): [docs/archive/v4-architecture.md](docs/archive/v4-architecture.md)
 
 ## Requirements
 

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

@@ -50,10 +50,5 @@ export declare abstract class BaseAdapter implements AgentAdapter {
      * Override if integration needs doc injection (like Claude Code)
      */
     injectDocumentation(_blocks: ManagedBlock[]): Promise<void>;
-    /**
-     * Escape special regex characters
-     * @deprecated Use escapeRegex from utils/string-utils.js directly
-     */
-    protected escapeRegex(str: string): string;
 }
 //# sourceMappingURL=base-adapter.d.ts.map

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

@@ -1,7 +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';
+import { logger } from '../../utils/logger.js';
 /**
  * Base adapter class with shared logic for all integrations
  * Ensures consistency and reduces code duplication
@@ -82,7 +82,7 @@ export class BaseAdapter {
             }
             catch (error) {
                 // Log warning but continue with other files
-                console.warn(`Failed to remove ${filePath}: ${error}`);
+                logger.warn(`Failed to remove ${filePath}: ${error}`);
             }
         }
         // Also remove clavix/ subdirectory if it exists (legacy cleanup)
@@ -93,7 +93,7 @@ export class BaseAdapter {
                 removed++;
             }
             catch (error) {
-                console.warn(`Failed to remove ${clavixSubdir}: ${error}`);
+                logger.warn(`Failed to remove ${clavixSubdir}: ${error}`);
             }
         }
         return removed;
@@ -145,12 +145,5 @@ export class BaseAdapter {
         // Default: no documentation injection
         // Override in subclasses if needed
     }
-    /**
-     * Escape special regex characters
-     * @deprecated Use escapeRegex from utils/string-utils.js directly
-     */
-    escapeRegex(str) {
-        return escapeRegex(str);
-    }
 }
 //# sourceMappingURL=base-adapter.js.map

package/dist/core/adapters/claude-code-adapter.js

@@ -2,6 +2,7 @@ import * as path from 'path';
 import { BaseAdapter } from './base-adapter.js';
 import { FileSystem } from '../../utils/file-system.js';
 import { IntegrationError } from '../../types/errors.js';
+import { escapeRegex } from '../../utils/string-utils.js';
 /**
  * Claude Code agent adapter
  */
@@ -65,7 +66,7 @@ export class ClaudeCodeAdapter extends BaseAdapter {
             const dir = path.dirname(fullPath);
             await FileSystem.ensureDir(dir);
         }
-        const blockRegex = new RegExp(`${this.escapeRegex(startMarker)}[\\s\\S]*?${this.escapeRegex(endMarker)}`, 'g');
+        const blockRegex = new RegExp(`${escapeRegex(startMarker)}[\\s\\S]*?${escapeRegex(endMarker)}`, 'g');
         const wrappedContent = `${startMarker}\n${content}\n${endMarker}`;
         if (blockRegex.test(fileContent)) {
             // Replace existing block

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

@@ -15,6 +15,7 @@ import { AdapterConfig } from '../../types/adapter-config.js';
 import { IntegrationFeatures } from '../../types/agent.js';
 export declare class UniversalAdapter extends BaseAdapter {
     private config;
+    readonly features: IntegrationFeatures;
     constructor(config: AdapterConfig);
     get name(): string;
     get displayName(): string;

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

@@ -14,9 +14,18 @@ import { BaseAdapter } from './base-adapter.js';
 import * as path from 'path';
 export class UniversalAdapter extends BaseAdapter {
     config;
+    features;
     constructor(config) {
         super();
         this.config = config;
+        // Set features from config for interface compatibility
+        this.features = {
+            supportsSubdirectories: config.features.supportsSubdirectories,
+            supportsFrontmatter: config.features.supportsFrontmatter,
+            commandFormat: {
+                separator: config.features.commandSeparator,
+            },
+        };
     }
     get name() {
         return this.config.name;

package/dist/core/agent-manager.d.ts

@@ -1,6 +1,11 @@
 import { AgentAdapter, ValidationResult } from '../types/agent.js';
 /**
  * Agent Manager - handles agent detection and registration
+ *
+ * Uses factory pattern with ADAPTER_CONFIGS for simple adapters,
+ * while keeping dedicated classes for special adapters (TOML, doc injection).
+ *
+ * @since v5.5.0 - Refactored to use config-driven factory pattern
  */
 export declare class AgentManager {
     private adapters;

package/dist/core/agent-manager.js

@@ -1,43 +1,33 @@
 import { ClaudeCodeAdapter } from './adapters/claude-code-adapter.js';
-import { CursorAdapter } from './adapters/cursor-adapter.js';
-import { DroidAdapter } from './adapters/droid-adapter.js';
-import { OpenCodeAdapter } from './adapters/opencode-adapter.js';
-import { AmpAdapter } from './adapters/amp-adapter.js';
-import { CrushAdapter } from './adapters/crush-adapter.js';
-import { WindsurfAdapter } from './adapters/windsurf-adapter.js';
-import { KilocodeAdapter } from './adapters/kilocode-adapter.js';
-import { ClineAdapter } from './adapters/cline-adapter.js';
-import { RoocodeAdapter } from './adapters/roocode-adapter.js';
-import { IntegrationError } from '../types/errors.js';
-import { CodeBuddyAdapter } from './adapters/codebuddy-adapter.js';
 import { GeminiAdapter } from './adapters/gemini-adapter.js';
 import { QwenAdapter } from './adapters/qwen-adapter.js';
-import { CodexAdapter } from './adapters/codex-adapter.js';
-import { AugmentAdapter } from './adapters/augment-adapter.js';
 import { LlxprtAdapter } from './adapters/llxprt-adapter.js';
+import { UniversalAdapter } from './adapters/universal-adapter.js';
+import { getSimpleAdapters } from './adapter-registry.js';
+import { IntegrationError } from '../types/errors.js';
 /**
  * Agent Manager - handles agent detection and registration
+ *
+ * Uses factory pattern with ADAPTER_CONFIGS for simple adapters,
+ * while keeping dedicated classes for special adapters (TOML, doc injection).
+ *
+ * @since v5.5.0 - Refactored to use config-driven factory pattern
  */
 export class AgentManager {
     adapters = new Map();
     constructor() {
-        // Register all built-in adapters
-        this.registerAdapter(new ClaudeCodeAdapter());
-        this.registerAdapter(new CursorAdapter());
-        this.registerAdapter(new DroidAdapter());
-        this.registerAdapter(new OpenCodeAdapter());
-        this.registerAdapter(new AmpAdapter());
-        this.registerAdapter(new CrushAdapter());
-        this.registerAdapter(new WindsurfAdapter());
-        this.registerAdapter(new KilocodeAdapter());
-        this.registerAdapter(new LlxprtAdapter());
-        this.registerAdapter(new ClineAdapter());
-        this.registerAdapter(new RoocodeAdapter());
-        this.registerAdapter(new AugmentAdapter());
-        this.registerAdapter(new CodeBuddyAdapter());
-        this.registerAdapter(new GeminiAdapter());
-        this.registerAdapter(new QwenAdapter());
-        this.registerAdapter(new CodexAdapter());
+        // Register special adapters (require custom logic)
+        this.registerAdapter(new ClaudeCodeAdapter()); // Doc injection
+        this.registerAdapter(new GeminiAdapter()); // TOML format
+        this.registerAdapter(new QwenAdapter()); // TOML format
+        this.registerAdapter(new LlxprtAdapter()); // TOML format
+        // Register simple adapters from config (using UniversalAdapter factory)
+        for (const config of getSimpleAdapters()) {
+            // Skip adapters that have special handlers registered above
+            if (this.adapters.has(config.name))
+                continue;
+            this.registerAdapter(new UniversalAdapter(config));
+        }
     }
     /**
      * Register a new agent adapter

package/dist/core/doc-injector.js

@@ -2,6 +2,7 @@ import * as path from 'path';
 import { FileSystem } from '../utils/file-system.js';
 import { DataError } from '../types/errors.js';
 import { escapeRegex } from '../utils/string-utils.js';
+import { logger } from '../utils/logger.js';
 /**
  * DocInjector - manages injection and updating of managed blocks in documentation files
  */
@@ -124,7 +125,7 @@ export class DocInjector {
         const openBrackets = (content.match(/\[/g) || []).length;
         const closeBrackets = (content.match(/\]/g) || []).length;
         if (openBrackets !== closeBrackets) {
-            console.warn('Warning: Unbalanced brackets in markdown');
+            logger.warn('Unbalanced brackets in markdown');
         }
     }
     /**

package/dist/utils/template-loader.js

@@ -4,6 +4,7 @@ import { dirname } from 'path';
 import { FileSystem } from './file-system.js';
 import { TemplateAssembler } from '../core/template-assembler.js';
 import { CommandTransformer } from '../core/command-transformer.js';
+import { DataError } from '../types/errors.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // v4.0: Singleton assembler instance for caching
@@ -39,8 +40,8 @@ export async function loadCommandTemplates(adapter) {
                 content = result.content;
             }
             catch (error) {
-                // If assembly fails, use original content
-                console.warn(`Template assembly warning for ${file}:`, error);
+                // Template assembly failures are critical - throw typed error
+                throw new DataError(`Template assembly failed for ${file}: ${error}`, `Check that all {{INCLUDE:}} references exist in templates directory`);
             }
         }
         // v4.8.1: Transform command references based on adapter format

package/oclif.manifest.json

@@ -126,5 +126,5 @@
       ]
     }
   },
-  "version": "5.4.0"
+  "version": "5.5.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.4.0",
+  "version": "5.5.0",
   "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",