clavix 5.6.0 → 5.6.2

package/dist/config/integrations.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "./integrations.schema.json",
+  "version": "1.0.0",
+  "integrations": [
+    {
+      "name": "cursor",
+      "displayName": "Cursor",
+      "directory": ".cursor/rules",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".cursor"
+    },
+    {
+      "name": "windsurf",
+      "displayName": "Windsurf",
+      "directory": ".windsurf/rules",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".windsurf"
+    },
+    {
+      "name": "kilocode",
+      "displayName": "Kilocode",
+      "directory": ".kilocode/rules",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".kilocode"
+    },
+    {
+      "name": "roocode",
+      "displayName": "Roo-Code",
+      "directory": ".roo/rules",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".roo"
+    },
+    {
+      "name": "cline",
+      "displayName": "Cline",
+      "directory": ".clinerules",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".clinerules"
+    },
+    {
+      "name": "droid",
+      "displayName": "Droid",
+      "directory": ".factory/commands",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".factory",
+      "placeholder": "$ARGUMENTS"
+    },
+    {
+      "name": "opencode",
+      "displayName": "OpenCode",
+      "directory": ".opencode/command",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".opencode",
+      "placeholder": "$ARGUMENTS"
+    },
+    {
+      "name": "codebuddy",
+      "displayName": "CodeBuddy",
+      "directory": ".codebuddy/rules",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".codebuddy"
+    },
+    {
+      "name": "amp",
+      "displayName": "Amp",
+      "directory": ".agents/commands",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".agents"
+    },
+    {
+      "name": "crush",
+      "displayName": "Crush",
+      "directory": ".crush/commands",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".crush"
+    },
+    {
+      "name": "codex",
+      "displayName": "Codex CLI",
+      "directory": "~/.codex/prompts",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".codex",
+      "global": true,
+      "placeholder": "$ARGUMENTS"
+    },
+    {
+      "name": "augment",
+      "displayName": "Augment Code",
+      "directory": ".augment/rules",
+      "filenamePattern": "clavix-{name}",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".augment"
+    },
+    {
+      "name": "claude-code",
+      "displayName": "Claude Code",
+      "directory": ".claude/commands/clavix",
+      "filenamePattern": "{name}",
+      "extension": ".md",
+      "separator": ":",
+      "detection": ".claude",
+      "specialAdapter": "doc-injection"
+    },
+    {
+      "name": "gemini",
+      "displayName": "Gemini CLI",
+      "directory": ".gemini/commands/clavix",
+      "filenamePattern": "{name}",
+      "extension": ".toml",
+      "separator": ":",
+      "detection": ".gemini",
+      "specialAdapter": "toml",
+      "rootDir": ".gemini"
+    },
+    {
+      "name": "qwen",
+      "displayName": "Qwen CLI",
+      "directory": ".qwen/commands/clavix",
+      "filenamePattern": "{name}",
+      "extension": ".toml",
+      "separator": ":",
+      "detection": ".qwen",
+      "specialAdapter": "toml",
+      "rootDir": ".qwen"
+    },
+    {
+      "name": "llxprt",
+      "displayName": "LLXpert",
+      "directory": ".llxprt/commands/clavix",
+      "filenamePattern": "{name}",
+      "extension": ".toml",
+      "separator": ":",
+      "detection": ".llxprt",
+      "specialAdapter": "toml",
+      "rootDir": ".llxprt"
+    }
+  ]
+}

package/dist/core/adapter-registry.d.ts

@@ -1,11 +1,11 @@
 /**
  * Adapter Registry - Config-driven adapter definitions
  *
- * This registry provides configuration for all simple adapters that can
- * be represented as pure configuration without custom logic.
+ * This registry loads configuration from integrations.json and transforms
+ * it into AdapterConfig objects used by the adapter system.
  *
- * For adapters requiring custom behavior (TOML format, doc injection),
- * dedicated adapter classes still exist.
+ * The integrations.json file is the single source of truth for all
+ * adapter configurations. See CONTRIBUTING.md for modification guidelines.
  *
  * NOTE: AGENTS.md is a mandatory integration that is always enabled by default.
  * It provides universal agent guidance that all AI tools can read. The AGENTS.md
@@ -13,16 +13,14 @@
  * included by ensureMandatoryIntegrations() in integration-selector.ts.
  *
  * @since v5.3.0
+ * @updated v5.7.0 - Refactored to use integrations.json as source of truth
  */
 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
+ * Loaded from src/config/integrations.json and transformed into AdapterConfig objects.
+ * The JSON file is the single source of truth for integration paths, patterns, and features.
  */
 export declare const ADAPTER_CONFIGS: AdapterConfig[];
 /**

package/dist/core/adapter-registry.js

@@ -1,11 +1,11 @@
 /**
  * Adapter Registry - Config-driven adapter definitions
  *
- * This registry provides configuration for all simple adapters that can
- * be represented as pure configuration without custom logic.
+ * This registry loads configuration from integrations.json and transforms
+ * it into AdapterConfig objects used by the adapter system.
  *
- * For adapters requiring custom behavior (TOML format, doc injection),
- * dedicated adapter classes still exist.
+ * The integrations.json file is the single source of truth for all
+ * adapter configurations. See CONTRIBUTING.md for modification guidelines.
  *
  * NOTE: AGENTS.md is a mandatory integration that is always enabled by default.
  * It provides universal agent guidance that all AI tools can read. The AGENTS.md
@@ -13,179 +13,56 @@
  * included by ensureMandatoryIntegrations() in integration-selector.ts.
  *
  * @since v5.3.0
+ * @updated v5.7.0 - Refactored to use integrations.json as source of truth
  */
+import { createRequire } from 'module';
 import { DEFAULT_MD_FEATURES, DEFAULT_TOML_FEATURES, } from '../types/adapter-config.js';
+// Use createRequire for JSON imports in ESM
+const require = createRequire(import.meta.url);
+const integrations = require('../config/integrations.json');
+/**
+ * Transform JSON config to AdapterConfig
+ */
+function transformConfig(config) {
+    const isToml = config.extension === '.toml';
+    // Build features based on adapter type
+    const features = isToml
+        ? { ...DEFAULT_TOML_FEATURES }
+        : {
+            ...DEFAULT_MD_FEATURES,
+            commandSeparator: config.separator,
+        };
+    // Add placeholder support if specified
+    if (config.placeholder) {
+        features.argumentPlaceholder = config.placeholder;
+    }
+    // Special handling for Claude Code (subdirectories + frontmatter + doc injection)
+    if (config.specialAdapter === 'doc-injection') {
+        features.supportsSubdirectories = true;
+        features.supportsFrontmatter = true;
+        features.supportsDocInjection = true;
+        features.commandSeparator = ':';
+    }
+    return {
+        name: config.name,
+        displayName: config.displayName,
+        directory: config.directory,
+        fileExtension: config.extension,
+        filenamePattern: config.filenamePattern,
+        features,
+        detection: { type: 'directory', path: config.detection },
+        specialAdapter: config.specialAdapter,
+        rootDir: config.rootDir,
+        global: config.global,
+    };
+}
 /**
  * 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
+ * Loaded from src/config/integrations.json and transformed into AdapterConfig objects.
+ * The JSON file is the single source of truth for integration paths, patterns, and features.
  */
-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',
-    },
-];
+export const ADAPTER_CONFIGS = integrations.integrations.map(transformConfig);
 /**
  * Get adapter configuration by name
  */

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

@@ -20,6 +20,10 @@ export declare class UniversalAdapter extends BaseAdapter {
     get name(): string;
     get displayName(): string;
     get directory(): string;
+    /**
+     * Check if this adapter uses global (home directory) installation
+     */
+    get isGlobal(): boolean;
     get fileExtension(): string;
     /**
      * Get integration features for command transformation

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

@@ -12,6 +12,7 @@
  */
 import { BaseAdapter } from './base-adapter.js';
 import * as path from 'path';
+import * as os from 'os';
 export class UniversalAdapter extends BaseAdapter {
     config;
     features;
@@ -34,8 +35,18 @@ export class UniversalAdapter extends BaseAdapter {
         return this.config.displayName;
     }
     get directory() {
+        // Expand ~ to home directory for global adapters
+        if (this.config.directory.startsWith('~/')) {
+            return this.config.directory.replace('~', os.homedir());
+        }
         return this.config.directory;
     }
+    /**
+     * Check if this adapter uses global (home directory) installation
+     */
+    get isGlobal() {
+        return this.config.global ?? false;
+    }
     get fileExtension() {
         return this.config.fileExtension;
     }
@@ -61,6 +72,10 @@ export class UniversalAdapter extends BaseAdapter {
      * Get full command path
      */
     getCommandPath() {
+        // For global adapters, use expanded directory path directly
+        if (this.isGlobal || this.config.directory.startsWith('~/')) {
+            return this.directory; // directory getter already expands ~
+        }
         return path.join(process.cwd(), this.config.directory);
     }
     /**

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

@@ -15,8 +15,10 @@ export type CommandSeparator = ':' | '-';
  * - '{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')
+ *
+ * The pattern should contain '{name}' which will be replaced with the command name.
  */
-export type FilenamePattern = '{name}' | 'clavix-{name}' | 'clavix/{name}';
+export type FilenamePattern = string;
 /**
  * Detection method for project environment
  */
@@ -61,6 +63,8 @@ export interface AdapterConfig {
     specialAdapter?: 'toml' | 'doc-injection';
     /** For TOML adapters: root directory (e.g., '.gemini') */
     rootDir?: string;
+    /** Whether commands should be written to home directory (global installation) */
+    global?: boolean;
 }
 /**
  * Default adapter features for markdown-based adapters

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.6.0",
+  "version": "5.6.2",
   "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",
@@ -17,7 +17,7 @@
     "prebuild": "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/",
+    "copy-templates": "rm -rf dist/templates && copyfiles -u 1 \"src/templates/**/*\" dist/ && copyfiles -u 1 \"src/config/**/*\" dist/",
     "remove-sourcemaps": "find dist -name '*.map' -type f -delete",
     "dev": "node --loader ts-node/esm src/index.ts",
     "test": "NODE_OPTIONS=\"--experimental-vm-modules --no-warnings\" jest",

package/oclif.manifest.json

@@ -1,130 +0,0 @@
-{
-  "commands": {
-    "diagnose": {
-      "aliases": [],
-      "args": {},
-      "description": "Diagnose Clavix installation and configuration",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> # Check setup and report issues"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "diagnose",
-      "pluginAlias": "clavix",
-      "pluginName": "clavix",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "DOC_GENERATORS": [
-        "agents-md",
-        "octo-md",
-        "warp-md",
-        "copilot-instructions"
-      ],
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "cli",
-        "commands",
-        "diagnose.js"
-      ]
-    },
-    "init": {
-      "aliases": [],
-      "args": {},
-      "description": "Initialize Clavix in the current project",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "init",
-      "pluginAlias": "clavix",
-      "pluginName": "clavix",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "cli",
-        "commands",
-        "init.js"
-      ]
-    },
-    "update": {
-      "aliases": [],
-      "args": {},
-      "description": "Update managed blocks and slash commands",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --docs-only",
-        "<%= config.bin %> <%= command.id %> --commands-only"
-      ],
-      "flags": {
-        "docs-only": {
-          "description": "Update only documentation blocks (AGENTS.md, CLAUDE.md, OCTO.md, WARP.md)",
-          "name": "docs-only",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "commands-only": {
-          "description": "Update only slash command files",
-          "name": "commands-only",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "force": {
-          "char": "f",
-          "description": "Force update even if files haven't changed",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "update",
-      "pluginAlias": "clavix",
-      "pluginName": "clavix",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "cli",
-        "commands",
-        "update.js"
-      ]
-    },
-    "version": {
-      "aliases": [],
-      "args": {},
-      "description": "Display Clavix version",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "version",
-      "pluginAlias": "clavix",
-      "pluginName": "clavix",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "cli",
-        "commands",
-        "version.js"
-      ]
-    }
-  },
-  "version": "5.5.2"
-}