clavix 5.2.1 → 5.3.0

package/dist/utils/error-utils.d.ts

@@ -32,6 +32,10 @@ interface NodeJSError extends Error {
  * Type guard to check if error is a NodeJS error with code property
  */
 export declare function isNodeError(error: unknown): error is NodeJSError;
+/**
+ * Check if error is a permission error (EACCES or EPERM)
+ */
+export declare function isPermissionError(error: unknown): boolean;
 export declare function handleCliError(error: unknown, defaultHandler: (err: unknown) => Promise<void>, exitFn?: (code: number) => void): Promise<void>;
 export {};
 //# sourceMappingURL=error-utils.d.ts.map

package/dist/utils/error-utils.js

@@ -63,6 +63,12 @@ export function toError(error) {
 export function isNodeError(error) {
     return isError(error) && 'code' in error && typeof error.code === 'string';
 }
+/**
+ * Check if error is a permission error (EACCES or EPERM)
+ */
+export function isPermissionError(error) {
+    return isNodeError(error) && (error.code === 'EACCES' || error.code === 'EPERM');
+}
 export async function handleCliError(error, defaultHandler, exitFn = process.exit) {
     // Type guard for OCLIF errors
     const isOclifError = (err) => {

package/dist/utils/file-system.js

@@ -1,6 +1,7 @@
 import fs from 'fs-extra';
 import * as path from 'path';
 import { PermissionError, DataError } from '../types/errors.js';
+import { isPermissionError, toError } from './error-utils.js';
 /**
  * FileSystem utility class for safe file operations
  */
@@ -34,8 +35,7 @@ export class FileSystem {
                     throw new DataError('Failed to write file and restore backup', `Check file permissions for ${fullPath}`);
                 }
             }
-            const { isNodeError, toError } = await import('./error-utils.js');
-            if (isNodeError(error) && (error.code === 'EACCES' || error.code === 'EPERM')) {
+            if (isPermissionError(error)) {
                 throw new PermissionError(`Permission denied: Cannot write to ${filePath}`, 'Try running with appropriate permissions or check file ownership');
             }
             throw toError(error);
@@ -53,8 +53,7 @@ export class FileSystem {
             return await fs.readFile(fullPath, 'utf-8');
         }
         catch (error) {
-            const { isNodeError, toError } = await import('./error-utils.js');
-            if (isNodeError(error) && (error.code === 'EACCES' || error.code === 'EPERM')) {
+            if (isPermissionError(error)) {
                 throw new PermissionError(`Permission denied: Cannot read ${filePath}`, 'Check file permissions');
             }
             throw toError(error);
@@ -69,8 +68,7 @@ export class FileSystem {
             await fs.ensureDir(fullPath);
         }
         catch (error) {
-            const { isNodeError, toError } = await import('./error-utils.js');
-            if (isNodeError(error) && (error.code === 'EACCES' || error.code === 'EPERM')) {
+            if (isPermissionError(error)) {
                 throw new PermissionError(`Permission denied: Cannot create directory ${dirPath}`, 'Check parent directory permissions');
             }
             throw toError(error);
@@ -162,8 +160,7 @@ export class FileSystem {
             return files;
         }
         catch (error) {
-            const { isNodeError, toError } = await import('./error-utils.js');
-            if (isNodeError(error) && (error.code === 'EACCES' || error.code === 'EPERM')) {
+            if (isPermissionError(error)) {
                 throw new PermissionError(`Permission denied: Cannot read directory ${dirPath}`, 'Check directory permissions');
             }
             throw toError(error);
@@ -179,8 +176,7 @@ export class FileSystem {
             await fs.copy(srcPath, destPath);
         }
         catch (error) {
-            const { isNodeError, toError } = await import('./error-utils.js');
-            if (isNodeError(error) && (error.code === 'EACCES' || error.code === 'EPERM')) {
+            if (isPermissionError(error)) {
                 throw new PermissionError(`Permission denied: Cannot copy from ${src} to ${dest}`, 'Check file permissions');
             }
             throw toError(error);
@@ -197,8 +193,7 @@ export class FileSystem {
             }
         }
         catch (error) {
-            const { isNodeError, toError } = await import('./error-utils.js');
-            if (isNodeError(error) && (error.code === 'EACCES' || error.code === 'EPERM')) {
+            if (isPermissionError(error)) {
                 throw new PermissionError(`Permission denied: Cannot remove ${filePath}`, 'Check file permissions');
             }
             throw toError(error);

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

@@ -1,3 +1,17 @@
+/**
+ * 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.
+ *
+ * @deprecated This module is scheduled for removal in v6.0.0.
+ * By that version, all legacy naming patterns should be fully migrated.
+ * After v6.0.0, the cleanup functionality will no longer be needed as
+ * the transition period will be complete.
+ *
+ * @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,3 +1,17 @@
+/**
+ * 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.
+ *
+ * @deprecated This module is scheduled for removal in v6.0.0.
+ * By that version, all legacy naming patterns should be fully migrated.
+ * After v6.0.0, the cleanup functionality will no longer be needed as
+ * the transition period will be complete.
+ *
+ * @since v4.12.0
+ */
 import * as path from 'path';
 import { FileSystem } from './file-system.js';
 /**

package/dist/utils/logger.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Centralized logging utility for Clavix
+ * Respects DEBUG environment variable for verbose output
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Logger utility with consistent formatting
+ */
+export declare const logger: {
+    /**
+     * Debug messages - only shown when DEBUG=true
+     */
+    debug: (message: string, ...args: unknown[]) => void;
+    /**
+     * Informational messages
+     */
+    info: (message: string, ...args: unknown[]) => void;
+    /**
+     * Warning messages
+     */
+    warn: (message: string, ...args: unknown[]) => void;
+    /**
+     * Error messages
+     */
+    error: (message: string, ...args: unknown[]) => void;
+    /**
+     * Log with specific level
+     */
+    log: (level: LogLevel, message: string, ...args: unknown[]) => void;
+};
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.js

@@ -0,0 +1,56 @@
+/**
+ * Centralized logging utility for Clavix
+ * Respects DEBUG environment variable for verbose output
+ */
+const isDebug = () => process.env.DEBUG === 'true' || process.env.DEBUG === '1';
+/**
+ * Logger utility with consistent formatting
+ */
+export const logger = {
+    /**
+     * Debug messages - only shown when DEBUG=true
+     */
+    debug: (message, ...args) => {
+        if (isDebug()) {
+            console.log(`[DEBUG] ${message}`, ...args);
+        }
+    },
+    /**
+     * Informational messages
+     */
+    info: (message, ...args) => {
+        console.log(message, ...args);
+    },
+    /**
+     * Warning messages
+     */
+    warn: (message, ...args) => {
+        console.warn(`[WARN] ${message}`, ...args);
+    },
+    /**
+     * Error messages
+     */
+    error: (message, ...args) => {
+        console.error(`[ERROR] ${message}`, ...args);
+    },
+    /**
+     * Log with specific level
+     */
+    log: (level, message, ...args) => {
+        switch (level) {
+            case 'debug':
+                logger.debug(message, ...args);
+                break;
+            case 'info':
+                logger.info(message, ...args);
+                break;
+            case 'warn':
+                logger.warn(message, ...args);
+                break;
+            case 'error':
+                logger.error(message, ...args);
+                break;
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/string-utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * String utility functions for Clavix
+ */
+/**
+ * Escape special characters in a string for use in a regular expression
+ * @param str - The string to escape
+ * @returns The escaped string safe for use in RegExp
+ */
+export declare function escapeRegex(str: string): string;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/utils/string-utils.js

@@ -0,0 +1,12 @@
+/**
+ * String utility functions for Clavix
+ */
+/**
+ * Escape special characters in a string for use in a regular expression
+ * @param str - The string to escape
+ * @returns The escaped string safe for use in RegExp
+ */
+export function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=string-utils.js.map

package/dist/utils/version.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Version utility for Clavix
+ * Centralizes version reading from package.json
+ */
+/**
+ * Get the current Clavix version from package.json
+ * Returns '0.0.0' if package.json cannot be read
+ */
+export declare function getVersion(): Promise<string>;
+/**
+ * Get version synchronously (for use in type definitions)
+ * Falls back to hardcoded version if file cannot be read
+ */
+export declare function getVersionSync(): string;
+/**
+ * Current version constant (set at module load time)
+ * Use this when you need a static version value
+ */
+export declare const CLAVIX_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.js

@@ -0,0 +1,43 @@
+/**
+ * Version utility for Clavix
+ * Centralizes version reading from package.json
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Get the current Clavix version from package.json
+ * Returns '0.0.0' if package.json cannot be read
+ */
+export async function getVersion() {
+    try {
+        const packageJsonPath = path.join(__dirname, '../../package.json');
+        const packageJson = await fs.readJson(packageJsonPath);
+        return packageJson.version || '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Get version synchronously (for use in type definitions)
+ * Falls back to hardcoded version if file cannot be read
+ */
+export function getVersionSync() {
+    try {
+        const packageJsonPath = path.join(__dirname, '../../package.json');
+        const packageJson = fs.readJsonSync(packageJsonPath);
+        return packageJson.version || '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Current version constant (set at module load time)
+ * Use this when you need a static version value
+ */
+export const CLAVIX_VERSION = getVersionSync();
+//# sourceMappingURL=version.js.map

package/oclif.manifest.json

@@ -0,0 +1,130 @@
+{
+  "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.2.1"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.2.1",
+  "version": "5.3.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",

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

@@ -1,28 +0,0 @@
-import { Command } from '@oclif/core';
-export default class Config extends Command {
-    static description: string;
-    static examples: string[];
-    static args: {
-        action: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
-        key: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
-        value: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
-    };
-    static flags: {};
-    run(): Promise<void>;
-    private showInteractiveMenu;
-    private manageIntegrations;
-    private addIntegrations;
-    private removeIntegrations;
-    private replaceIntegrations;
-    private getConfig;
-    private setConfig;
-    private editConfig;
-    private resetConfig;
-    private editPreferences;
-    private loadConfig;
-    private saveConfig;
-    private displayConfig;
-    private getNestedValue;
-    private setNestedValue;
-}
-//# sourceMappingURL=config.d.ts.map