clavix 5.2.1 → 5.3.0

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

@@ -0,0 +1,88 @@
+/**
+ * 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 * as path from 'path';
+export class UniversalAdapter extends BaseAdapter {
+    config;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    get name() {
+        return this.config.name;
+    }
+    get displayName() {
+        return this.config.displayName;
+    }
+    get directory() {
+        return this.config.directory;
+    }
+    get fileExtension() {
+        return this.config.fileExtension;
+    }
+    /**
+     * Get integration features for command transformation
+     */
+    getIntegrationFeatures() {
+        return {
+            commandFormat: {
+                separator: this.config.features.commandSeparator,
+            },
+        };
+    }
+    /**
+     * Generate the target filename based on config pattern
+     */
+    getTargetFilename(commandName) {
+        const pattern = this.config.filenamePattern;
+        const filename = pattern.replace('{name}', commandName);
+        return `${filename}${this.config.fileExtension}`;
+    }
+    /**
+     * Get full command path
+     */
+    getCommandPath() {
+        return path.join(process.cwd(), this.config.directory);
+    }
+    /**
+     * Check if this adapter's project environment is detected
+     * Required by BaseAdapter abstract class
+     */
+    async detectProject() {
+        const { detection } = this.config;
+        const fs = await import('fs-extra');
+        switch (detection.type) {
+            case 'directory':
+                return fs.pathExists(detection.path);
+            case 'file':
+                return fs.pathExists(detection.path);
+            case 'config':
+                return fs.pathExists(detection.path);
+            default:
+                return false;
+        }
+    }
+    /**
+     * Check if this adapter supports subdirectories
+     */
+    supportsSubdirectories() {
+        return this.config.features.supportsSubdirectories;
+    }
+    /**
+     * Check if this adapter supports frontmatter
+     */
+    supportsFrontmatter() {
+        return this.config.features.supportsFrontmatter;
+    }
+}
+//# sourceMappingURL=universal-adapter.js.map

package/dist/core/command-transformer.d.ts

@@ -3,11 +3,10 @@ import { IntegrationFeatures } from '../types/agent.js';
  * CommandTransformer - Transforms slash command references in template content
  *
  * Handles conversion between command formats:
- * - Colon format: /clavix:fast (Claude Code style - uses subdirectories)
- * - Hyphen format: /clavix-fast (Cursor, Droid style - flat files)
+ * - Colon format: /clavix:improve (Claude Code style - uses subdirectories)
+ * - Hyphen format: /clavix-improve (Cursor, Droid style - flat files)
  *
- * Preserves CLI commands (clavix prompts list) unchanged - only transforms
- * slash commands that start with /clavix:
+ * Only transforms slash commands that start with /clavix:
  *
  * @since v4.8.1
  */
@@ -29,26 +28,26 @@ export declare class CommandTransformer {
      *
      * @example
      * // For Cursor/Droid (hyphen format):
-     * transform('/clavix:fast', { commandFormat: { separator: '-' } })
-     * // Returns: '/clavix-fast'
+     * transform('/clavix:improve', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-improve'
      *
      * @example
      * // For Claude Code (colon format, default):
-     * transform('/clavix:fast', { commandFormat: { separator: ':' } })
-     * // Returns: '/clavix:fast' (unchanged)
+     * transform('/clavix:improve', { commandFormat: { separator: ':' } })
+     * // Returns: '/clavix:improve' (unchanged)
      */
     static transform(content: string, features?: IntegrationFeatures): string;
     /**
      * Get the formatted command name for a specific adapter
      * Useful for generating documentation or references
      *
-     * @param commandName - Base command name (e.g., 'fast', 'execute', 'task-complete')
+     * @param commandName - Base command name (e.g., 'improve', 'prd', 'implement')
      * @param features - Adapter's integration features
-     * @returns Formatted slash command (e.g., '/clavix:fast' or '/clavix-fast')
+     * @returns Formatted slash command (e.g., '/clavix:improve' or '/clavix-improve')
      *
      * @example
-     * formatCommand('execute', { commandFormat: { separator: '-' } })
-     * // Returns: '/clavix-execute'
+     * formatCommand('improve', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-improve'
      */
     static formatCommand(commandName: string, features?: IntegrationFeatures): string;
 }

package/dist/core/command-transformer.js

@@ -2,11 +2,10 @@
  * CommandTransformer - Transforms slash command references in template content
  *
  * Handles conversion between command formats:
- * - Colon format: /clavix:fast (Claude Code style - uses subdirectories)
- * - Hyphen format: /clavix-fast (Cursor, Droid style - flat files)
+ * - Colon format: /clavix:improve (Claude Code style - uses subdirectories)
+ * - Hyphen format: /clavix-improve (Cursor, Droid style - flat files)
  *
- * Preserves CLI commands (clavix prompts list) unchanged - only transforms
- * slash commands that start with /clavix:
+ * Only transforms slash commands that start with /clavix:
  *
  * @since v4.8.1
  */
@@ -28,13 +27,13 @@ export class CommandTransformer {
      *
      * @example
      * // For Cursor/Droid (hyphen format):
-     * transform('/clavix:fast', { commandFormat: { separator: '-' } })
-     * // Returns: '/clavix-fast'
+     * transform('/clavix:improve', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-improve'
      *
      * @example
      * // For Claude Code (colon format, default):
-     * transform('/clavix:fast', { commandFormat: { separator: ':' } })
-     * // Returns: '/clavix:fast' (unchanged)
+     * transform('/clavix:improve', { commandFormat: { separator: ':' } })
+     * // Returns: '/clavix:improve' (unchanged)
      */
     static transform(content, features) {
         const separator = features?.commandFormat?.separator ?? this.DEFAULT_SEPARATOR;
@@ -49,13 +48,13 @@ export class CommandTransformer {
      * Get the formatted command name for a specific adapter
      * Useful for generating documentation or references
      *
-     * @param commandName - Base command name (e.g., 'fast', 'execute', 'task-complete')
+     * @param commandName - Base command name (e.g., 'improve', 'prd', 'implement')
      * @param features - Adapter's integration features
-     * @returns Formatted slash command (e.g., '/clavix:fast' or '/clavix-fast')
+     * @returns Formatted slash command (e.g., '/clavix:improve' or '/clavix-improve')
      *
      * @example
-     * formatCommand('execute', { commandFormat: { separator: '-' } })
-     * // Returns: '/clavix-execute'
+     * formatCommand('improve', { commandFormat: { separator: '-' } })
+     * // Returns: '/clavix-improve'
      */
     static formatCommand(commandName, features) {
         const separator = features?.commandFormat?.separator ?? this.DEFAULT_SEPARATOR;

package/dist/core/doc-injector.d.ts

@@ -31,10 +31,6 @@ export declare class DocInjector {
      * Wrap content with markers
      */
     private static wrapContent;
-    /**
-     * Escape special regex characters
-     */
-    private static escapeRegex;
     /**
      * Basic markdown validation
      */

package/dist/core/doc-injector.js

@@ -1,6 +1,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';
 /**
  * DocInjector - manages injection and updating of managed blocks in documentation files
  */
@@ -28,7 +29,7 @@ export class DocInjector {
             throw new DataError(`File not found: ${filePath}`, 'Set createIfMissing: true to create the file automatically');
         }
         // Build the managed block
-        const blockRegex = new RegExp(`${this.escapeRegex(opts.startMarker)}[\\s\\S]*?${this.escapeRegex(opts.endMarker)}`, 'g');
+        const blockRegex = new RegExp(`${escapeRegex(opts.startMarker)}[\\s\\S]*?${escapeRegex(opts.endMarker)}`, 'g');
         const wrappedContent = this.wrapContent(opts.content, opts.startMarker, opts.endMarker);
         if (blockRegex.test(fileContent)) {
             // Replace existing block
@@ -70,7 +71,7 @@ export class DocInjector {
             return false;
         }
         const content = await FileSystem.readFile(filePath);
-        const blockRegex = new RegExp(`${this.escapeRegex(start)}[\\s\\S]*?${this.escapeRegex(end)}`, 'g');
+        const blockRegex = new RegExp(`${escapeRegex(start)}[\\s\\S]*?${escapeRegex(end)}`, 'g');
         return blockRegex.test(content);
     }
     /**
@@ -83,7 +84,7 @@ export class DocInjector {
             return null;
         }
         const content = await FileSystem.readFile(filePath);
-        const blockRegex = new RegExp(`${this.escapeRegex(start)}([\\s\\S]*?)${this.escapeRegex(end)}`, 'g');
+        const blockRegex = new RegExp(`${escapeRegex(start)}([\\s\\S]*?)${escapeRegex(end)}`, 'g');
         const match = blockRegex.exec(content);
         return match ? match[1].trim() : null;
     }
@@ -97,7 +98,7 @@ export class DocInjector {
             return;
         }
         const content = await FileSystem.readFile(filePath);
-        const blockRegex = new RegExp(`${this.escapeRegex(start)}[\\s\\S]*?${this.escapeRegex(end)}\\n?`, 'g');
+        const blockRegex = new RegExp(`${escapeRegex(start)}[\\s\\S]*?${escapeRegex(end)}\\n?`, 'g');
         if (blockRegex.test(content)) {
             await FileSystem.backup(filePath);
             const updated = content.replace(blockRegex, '');
@@ -110,12 +111,6 @@ export class DocInjector {
     static wrapContent(content, startMarker, endMarker) {
         return `${startMarker}\n${content}\n${endMarker}`;
     }
-    /**
-     * Escape special regex characters
-     */
-    static escapeRegex(str) {
-        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    }
     /**
      * Basic markdown validation
      */

package/dist/core/template-assembler.d.ts

@@ -25,7 +25,7 @@ export interface AssemblyResult {
  * Usage:
  * ```typescript
  * const assembler = new TemplateAssembler('/path/to/templates');
- * const result = await assembler.assembleTemplate('fast.md');
+ * const result = await assembler.assembleTemplate('improve.md');
  * ```
  *
  * Include marker formats:

package/dist/core/template-assembler.js

@@ -9,7 +9,7 @@ import * as path from 'path';
  * Usage:
  * ```typescript
  * const assembler = new TemplateAssembler('/path/to/templates');
- * const result = await assembler.assembleTemplate('fast.md');
+ * const result = await assembler.assembleTemplate('improve.md');
  * ```
  *
  * Include marker formats:

package/dist/templates/agents/agents.md

@@ -73,7 +73,7 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 |---------|---------|
 | `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)
@@ -185,7 +185,6 @@ PRD Creation → Task Planning → Implementation → Archive
 
 **Artifacts stored under `.clavix/`:**
 - `.clavix/outputs/<project>/` - PRDs, tasks, prompts
-- `.clavix/sessions/` - Captured conversations
 - `.clavix/templates/` - Custom overrides
 
 ---

package/dist/templates/agents/copilot-instructions.md

@@ -60,7 +60,7 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 |---------|---------|
 | `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)
@@ -178,7 +178,6 @@ with `/clavix:summarize`. Alternatively, if you have a rough idea, try:
 
 **Artifacts stored under `.clavix/`:**
 - `.clavix/outputs/<project>/` - PRDs, tasks, prompts
-- `.clavix/sessions/` - Captured conversations
 - `.clavix/config.json` - Project configuration
 
 ---

package/dist/templates/agents/octo.md

@@ -123,7 +123,7 @@ Autofix handles edge cases gracefully - let it work.
 |---------|---------|
 | `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/templates/agents/warp.md

@@ -51,7 +51,7 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 |---------|---------|
 | `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 |
 
 ### Slash Commands (Workflows)
@@ -72,7 +72,7 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 
 ### Outputs
 - Project artifacts live under `.clavix/outputs/<project>/`
-- Sessions are stored in `.clavix/sessions/`
+- Saved prompts in `.clavix/outputs/prompts/`
 - Update generated docs/commands any time with `clavix update`
 
 ---

package/dist/templates/instructions/core/file-operations.md

@@ -150,24 +150,28 @@ List created files:
 
 ---
 
-### Timestamped Sessions
+### Timestamped Prompts
 
 ```markdown
-**Step 1: Generate session timestamp**
-Create timestamp: `YYYY-MM-DD-HHMM` format (e.g., `2025-11-24-1430`)
+**Step 1: Generate prompt timestamp**
+Create timestamp: `YYYYMMDD-HHMMSS` format (e.g., `20251124-143022`)
 
-**Step 2: Create session directory**
-```bash
-mkdir -p .clavix/sessions/[timestamp]
-```
+**Step 2: Create prompt file**
+Use the Write tool to create `.clavix/outputs/prompts/std-[timestamp]-[random].md`
+
+---
+id: std-[timestamp]-[random]
+depthUsed: standard|comprehensive
+timestamp: [ISO-8601]
+executed: false
+---
 
-**Step 3: Write session file**
-Use the Write tool to create `.clavix/sessions/[timestamp]/conversation.md`
+# Improved Prompt
 
 [Content here]
 
-**Step 4: Verify**
-Confirm: `.clavix/sessions/[timestamp]/conversation.md` ✓
+**Step 3: Verify**
+Confirm: `.clavix/outputs/prompts/std-[timestamp]-[random].md` ✓
 ```
 
 ---

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

@@ -283,7 +283,7 @@ The generated `tasks.md` will look like:
 - Tasks are automatically optimized for clarity, structure, and actionability
 - Each task is concise and actionable
 - Tasks can reference specific PRD sections
-- Supports mini-PRD outputs from `/clavix:summarize` and session workflows via `--session` or `--active-session`
+- Supports mini-PRD outputs from `/clavix:summarize`
 - You can manually edit tasks.md before implementing
 - Use `--overwrite` flag to regenerate if needed
 
@@ -320,7 +320,6 @@ The generated `tasks.md` will look like:
    - Suggest recovery options:
      - "Generate PRD with `/clavix:prd` for comprehensive planning"
      - "Extract mini-PRD from conversation with `/clavix:summarize`"
-     - "Or use `clavix plan --session <id>` if you have a saved session"
 3. Do NOT proceed with plan generation without PRD
 
 ### Issue: Generated tasks are too granular (100+ tasks)

package/dist/templates/slash-commands/_components/MANIFEST.md

@@ -0,0 +1,81 @@
+# Component Manifest
+
+This document lists all reusable components in the Clavix template system and their usage across slash commands.
+
+## Component Categories
+
+### Agent Protocols
+Core protocols that all AI agents must follow. Shared across most commands.
+
+| Component | Purpose | Used By |
+|-----------|---------|---------|
+| `AGENT_MANUAL.md` | Universal protocols (transparency, mode identification, communication patterns) | All 8 commands |
+| `cli-reference.md` | CLI command reference including removed commands table | improve, prd, plan, implement, verify, archive |
+| `state-awareness.md` | Workflow state detection (mid-PRD, mid-implementation, etc.) | prd, plan, implement, summarize |
+| `supportive-companion.md` | Conversational guidance for start mode | start |
+| `task-blocking.md` | Task execution protocols for implement mode | implement |
+
+### References
+Static reference documentation for AI agents.
+
+| Component | Purpose | Used By |
+|-----------|---------|---------|
+| `quality-dimensions.md` | Explanation of quality scoring dimensions (clarity, efficiency, etc.) | improve, prd, summarize |
+
+### Sections
+Reusable content sections for specific workflows.
+
+| Component | Purpose | Used By |
+|-----------|---------|---------|
+| `conversation-examples.md` | Example conversation patterns for exploration | start |
+| `escalation-factors.md` | When to recommend PRD mode over improve | improve |
+| `improvement-explanations.md` | How to explain quality improvements | improve, summarize |
+| `pattern-impact.md` | What patterns had the biggest impact | improve |
+| `prd-examples.md` | PRD generation examples | prd |
+
+### Troubleshooting
+Recovery patterns for common agent issues.
+
+| Component | Purpose | Used By |
+|-----------|---------|---------|
+| `vibecoder-recovery.md` | Recovery patterns for "vibe coders" who skip instructions | All 8 commands |
+
+## Usage Matrix
+
+| Command | Components Used |
+|---------|----------------|
+| `/clavix:improve` | AGENT_MANUAL, cli-reference, improvement-explanations, quality-dimensions, escalation-factors, pattern-impact |
+| `/clavix:prd` | AGENT_MANUAL, prd-examples, quality-dimensions, state-awareness, cli-reference |
+| `/clavix:plan` | AGENT_MANUAL, state-awareness, cli-reference, vibecoder-recovery |
+| `/clavix:implement` | AGENT_MANUAL, state-awareness, task-blocking, cli-reference, vibecoder-recovery |
+| `/clavix:start` | AGENT_MANUAL, supportive-companion, conversation-examples, vibecoder-recovery |
+| `/clavix:summarize` | AGENT_MANUAL, improvement-explanations, quality-dimensions, state-awareness, vibecoder-recovery |
+| `/clavix:verify` | AGENT_MANUAL, cli-reference, vibecoder-recovery |
+| `/clavix:archive` | AGENT_MANUAL, cli-reference, vibecoder-recovery |
+
+## Include Syntax
+
+Components are included using the `{{INCLUDE:path}}` directive:
+
+```markdown
+{{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
+{{INCLUDE:sections/escalation-factors.md}}
+{{INCLUDE:references/quality-dimensions.md}}
+```
+
+## Guidelines for New Components
+
+1. **Single responsibility**: Each component should have one clear purpose
+2. **Reusability**: Create components when content is used by 2+ commands
+3. **No orphans**: Delete components when no longer referenced
+4. **Update manifest**: Add new components to this manifest
+
+## Maintenance
+
+When adding/removing components:
+1. Update this manifest
+2. Run `npm run build` to verify template assembly
+3. Check that removed components aren't referenced anywhere:
+   ```bash
+   grep -r "INCLUDE:.*component-name" src/templates/
+   ```

package/dist/templates/slash-commands/_components/agent-protocols/AGENT_MANUAL.md

@@ -10,7 +10,7 @@ Clavix v5 follows an **agentic-first architecture**. This means:
 
 1. **You execute workflows directly** using your native tools (Write, Read, Edit, Bash)
 2. **Slash commands are templates** that you read and follow - not CLI commands
-3. **CLI commands are ONLY for setup** (`clavix init`, `clavix update`, `clavix config`)
+3. **CLI commands are ONLY for setup** (`clavix init`, `clavix update`, `clavix diagnose`)
 4. **You save outputs to `.clavix/outputs/`** using your Write tool
 
 **DO NOT:**

package/dist/templates/slash-commands/_components/agent-protocols/cli-reference.md

@@ -26,13 +26,10 @@ These are commands the **user** runs in their terminal to set up Clavix:
 - `--docs-only` - Update only documentation
 - `--commands-only` - Update only slash commands
 
-#### `clavix config get <key>`
-**What it does:** Gets a configuration value
-**Example:** `clavix config get integrations`
-
-#### `clavix config set <key> <value>`
-**What it does:** Updates a configuration value
-**Example:** `clavix config set preferences.verboseLogging true`
+#### `clavix diagnose`
+**What it does:** Runs diagnostic checks on Clavix installation
+**When user runs it:** To troubleshoot issues
+**Reports:** Version, config status, template integrity, integration health
 
 #### `clavix version`
 **What it does:** Shows current Clavix version
@@ -104,15 +101,16 @@ originalPrompt: "the user's original prompt"
 
 ---
 
-### Migration from v4
+### Removed Commands (v4 Legacy)
+
+**IMPORTANT:** These commands were removed in v5. Do NOT try to run them:
 
-If you see references to old CLI commands in conversations, they no longer exist:
+| Removed Command | How Agents Handle This Now |
+|-----------------|---------------------------|
+| `clavix fast/deep` | Use `/clavix:improve` - saves to `.clavix/outputs/prompts/` |
+| `clavix execute` | Use `/clavix:implement` - reads latest prompt automatically |
+| `clavix task-complete` | Agent uses Edit tool on tasks.md directly |
+| `clavix prompts list` | Agent uses Glob/Bash to list `.clavix/outputs/prompts/*.md` |
+| `clavix config` | User can run `clavix init` to reconfigure |
 
-| Old Command | v5 Equivalent |
-|-------------|---------------|
-| `clavix fast/deep "prompt"` | Agent analyzes and saves to `.clavix/outputs/prompts/<id>.md` |
-| `clavix execute --latest` | Agent lists prompts dir, finds newest, reads it |
-| `clavix implement` | Agent follows `/clavix:implement` template |
-| `clavix task-complete <id>` | Agent uses Edit tool on tasks.md |
-| `clavix archive <name>` | Agent moves directory with Bash tool |
-| `clavix prompts list` | Agent lists `.clavix/outputs/prompts/*.md` files |
+**If user asks you to run these commands:** Explain they were removed in v5 and the equivalent workflow.

package/dist/types/adapter-config.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Configuration schema for config-driven adapters
+ * Enables creating adapters from configuration rather than individual classes
+ */
+/**
+ * File extension types supported by adapters
+ */
+export type AdapterFileExtension = '.md' | '.toml';
+/**
+ * Command separator types
+ */
+export type CommandSeparator = ':' | '-';
+/**
+ * Filename pattern for generated command files
+ * - '{name}' - Just the command name (e.g., 'improve.md')
+ * - 'clavix-{name}' - Prefixed (e.g., 'clavix-improve.md')
+ * - 'clavix/{name}' - In subdirectory (e.g., 'clavix/improve.md')
+ */
+export type FilenamePattern = '{name}' | 'clavix-{name}' | 'clavix/{name}';
+/**
+ * Detection method for project environment
+ */
+export interface DetectionConfig {
+    type: 'directory' | 'file' | 'config';
+    path: string;
+}
+/**
+ * Feature flags for adapter capabilities
+ */
+export interface AdapterFeatures {
+    /** Whether the adapter supports subdirectories in command path */
+    supportsSubdirectories: boolean;
+    /** Whether the adapter supports frontmatter in command files */
+    supportsFrontmatter: boolean;
+    /** Whether the adapter supports doc injection (CLAUDE.md, etc.) */
+    supportsDocInjection: boolean;
+    /** Command separator character */
+    commandSeparator: CommandSeparator;
+    /** Argument placeholder for TOML adapters */
+    argumentPlaceholder?: string;
+}
+/**
+ * Full adapter configuration
+ */
+export interface AdapterConfig {
+    /** Internal adapter name (e.g., 'cursor') */
+    name: string;
+    /** Display name for UI (e.g., 'Cursor') */
+    displayName: string;
+    /** Command directory path (e.g., '.cursor/commands') */
+    directory: string;
+    /** File extension for command files */
+    fileExtension: AdapterFileExtension;
+    /** Pattern for generating filenames */
+    filenamePattern: FilenamePattern;
+    /** Feature flags */
+    features: AdapterFeatures;
+    /** Project detection configuration */
+    detection: DetectionConfig;
+    /** Whether this adapter requires special handling (TOML format, doc injection) */
+    specialAdapter?: 'toml' | 'doc-injection';
+    /** For TOML adapters: root directory (e.g., '.gemini') */
+    rootDir?: string;
+}
+/**
+ * Default adapter features for markdown-based adapters
+ */
+export declare const DEFAULT_MD_FEATURES: AdapterFeatures;
+/**
+ * Default adapter features for TOML-based adapters
+ */
+export declare const DEFAULT_TOML_FEATURES: AdapterFeatures;
+//# sourceMappingURL=adapter-config.d.ts.map

package/dist/types/adapter-config.js

@@ -0,0 +1,24 @@
+/**
+ * Configuration schema for config-driven adapters
+ * Enables creating adapters from configuration rather than individual classes
+ */
+/**
+ * Default adapter features for markdown-based adapters
+ */
+export const DEFAULT_MD_FEATURES = {
+    supportsSubdirectories: false,
+    supportsFrontmatter: false,
+    supportsDocInjection: false,
+    commandSeparator: '-',
+};
+/**
+ * Default adapter features for TOML-based adapters
+ */
+export const DEFAULT_TOML_FEATURES = {
+    supportsSubdirectories: true,
+    supportsFrontmatter: false,
+    supportsDocInjection: false,
+    commandSeparator: ':',
+    argumentPlaceholder: '{{args}}',
+};
+//# sourceMappingURL=adapter-config.js.map

package/dist/types/config.js

@@ -1,8 +1,9 @@
 /**
  * Configuration types for Clavix
  */
+import { CLAVIX_VERSION } from '../utils/version.js';
 export const DEFAULT_CONFIG = {
-    version: '5.2.1',
+    version: CLAVIX_VERSION,
     integrations: [],
     templates: {
         prdQuestions: 'default',
@@ -41,7 +42,7 @@ export function migrateConfig(legacy) {
         integrations = [];
     }
     return {
-        version: '3.5.0',
+        version: CLAVIX_VERSION,
         integrations,
         templates: legacy.templates,
         outputs: legacy.outputs,