aicm 0.14.3 → 0.14.5

package/dist/cli.js

@@ -19,6 +19,7 @@ async function runCli() {
         "--version": Boolean,
         "--ci": Boolean,
         "--verbose": Boolean,
+        "--dry-run": Boolean,
         "-h": "--help",
         "-v": "--version",
     }, {
@@ -42,7 +43,7 @@ async function runCli() {
                 (0, init_1.initCommand)();
                 break;
             case "install":
-                await (0, install_1.installCommand)(args["--ci"], args["--verbose"]);
+                await (0, install_1.installCommand)(args["--ci"], args["--verbose"], args["--dry-run"]);
                 break;
             case "list":
                 await (0, list_1.listCommand)();
@@ -74,10 +75,12 @@ ${chalk_1.default.bold("OPTIONS")}
   -v, --version       Show version number
   --ci                Run in CI environments (default: \`false\`)
   --verbose           Show detailed output and stack traces for debugging
+  --dry-run           Simulate installation without writing files, useful for validating presets in CI
 
 ${chalk_1.default.bold("EXAMPLES")}
   $ aicm init
   $ aicm install
+  $ aicm install --dry-run
   $ aicm list
 `);
 }

package/dist/commands/install.d.ts

@@ -16,6 +16,10 @@ export interface InstallOptions {
      * Show verbose output during installation
      */
     verbose?: boolean;
+    /**
+     * Perform a dry run without writing any files
+     */
+    dryRun?: boolean;
 }
 /**
  * Result of the install operation
@@ -49,4 +53,4 @@ export declare function install(options?: InstallOptions): Promise<InstallResult
 /**
  * CLI command wrapper for install
  */
-export declare function installCommand(installOnCI?: boolean, verbose?: boolean): Promise<void>;
+export declare function installCommand(installOnCI?: boolean, verbose?: boolean, dryRun?: boolean): Promise<void>;

package/dist/commands/install.js

@@ -323,11 +323,13 @@ async function installPackage(options = {}) {
             }
         }
         try {
-            // Write rules to targets
-            writeRulesToTargets(rules, config.targets);
-            // Write MCP servers
-            if (mcpServers && Object.keys(mcpServers).length > 0) {
-                writeMcpServersToTargets(mcpServers, config.targets, cwd);
+            if (!options.dryRun) {
+                // Write rules to targets
+                writeRulesToTargets(rules, config.targets);
+                // Write MCP servers
+                if (mcpServers && Object.keys(mcpServers).length > 0) {
+                    writeMcpServersToTargets(mcpServers, config.targets, cwd);
+                }
             }
             return {
                 success: true,
@@ -387,7 +389,7 @@ async function installWorkspacesPackages(packages, options = {}) {
 /**
  * Install rules across multiple packages in a workspace
  */
-async function installWorkspaces(cwd, installOnCI, verbose = false) {
+async function installWorkspaces(cwd, installOnCI, verbose = false, dryRun = false) {
     return (0, working_directory_1.withWorkingDirectory)(cwd, async () => {
         if (verbose) {
             console.log(chalk_1.default.blue("🔍 Discovering packages..."));
@@ -420,6 +422,7 @@ async function installWorkspaces(cwd, installOnCI, verbose = false) {
         const result = await installWorkspacesPackages(packages, {
             installOnCI,
             verbose,
+            dryRun,
         });
         if (verbose) {
             result.packages.forEach((pkg) => {
@@ -448,7 +451,6 @@ async function installWorkspaces(cwd, installOnCI, verbose = false) {
                 packagesCount: result.packages.length,
             };
         }
-        console.log(`Successfully installed ${result.totalRuleCount} rules across ${result.packages.length} packages`);
         return {
             success: true,
             installedRuleCount: result.totalRuleCount,
@@ -482,7 +484,7 @@ async function install(options = {}) {
         const shouldUseWorkspaces = (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.config.workspaces) ||
             (!resolvedConfig && (0, config_1.detectWorkspacesFromPackageJson)(cwd));
         if (shouldUseWorkspaces) {
-            return await installWorkspaces(cwd, installOnCI, options.verbose);
+            return await installWorkspaces(cwd, installOnCI, options.verbose, options.dryRun);
         }
         return installPackage(options);
     });
@@ -490,18 +492,27 @@ async function install(options = {}) {
 /**
  * CLI command wrapper for install
  */
-async function installCommand(installOnCI, verbose) {
+async function installCommand(installOnCI, verbose, dryRun) {
     var _a;
-    const result = await install({ installOnCI, verbose });
+    const result = await install({ installOnCI, verbose, dryRun });
     if (!result.success) {
         throw (_a = result.error) !== null && _a !== void 0 ? _a : new Error("Installation failed with unknown error");
     }
     else {
-        if (result.packagesCount > 1) {
-            console.log(`Successfully installed ${result.installedRuleCount} rules across ${result.packagesCount} packages`);
+        const rulesInstalledMessage = `${result.installedRuleCount} rule${result.installedRuleCount === 1 ? "" : "s"}`;
+        if (dryRun) {
+            if (result.packagesCount > 1) {
+                console.log(`Dry run: validated ${rulesInstalledMessage} across ${result.packagesCount} packages`);
+            }
+            else {
+                console.log(`Dry run: validated ${rulesInstalledMessage}`);
+            }
+        }
+        else if (result.packagesCount > 1) {
+            console.log(`Successfully installed ${rulesInstalledMessage} across ${result.packagesCount} packages`);
         }
         else {
-            console.log("Rules installation completed");
+            console.log(`Successfully installed ${rulesInstalledMessage}`);
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aicm",
-  "version": "0.14.3",
+  "version": "0.14.5",
   "description": "A TypeScript CLI tool for managing AI IDE rules across different projects and teams",
   "main": "dist/api.js",
   "types": "dist/api.d.ts",
@@ -56,13 +56,13 @@
     "watch": "tsc --watch",
     "start": "node dist/bin/aicm.js",
     "dev": "ts-node src/bin/aicm.ts",
-    "test": "jest",
+    "test": "pnpm build && jest",
     "test:watch": "jest --watch",
     "test:all": "npm run build && npm run test",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "lint": "eslint",
     "version": "auto-changelog -p && git add CHANGELOG.md",
-    "release": "np --no-tests"
+    "release": "np"
   }
 }

package/dist/api_v2.d.ts

@@ -1,9 +0,0 @@
-import { InstallOptions, InstallResult } from "./commands/install";
-/**
- * Install AICM rules based on configuration (v2)
- * @param options Installation options
- * @returns Result of the install operation
- */
-export declare function install(options?: InstallOptions): Promise<InstallResult>;
-export type { InstallOptions, InstallResult } from "./commands/install";
-export type { ResolvedConfig, Config, RuleFile, MCPServers, } from "./utils/config";

package/dist/api_v2.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.install = install;
-const install_1 = require("./commands/install");
-/**
- * Install AICM rules based on configuration (v2)
- * @param options Installation options
- * @returns Result of the install operation
- */
-async function install(options = {}) {
-    return (0, install_1.install)(options);
-}

package/dist/bin/aicm_v2.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/bin/aicm_v2.js

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const cli_v2_1 = require("../cli_v2");
-(0, cli_v2_1.runCliV2)().catch((error) => {
-    console.error(error);
-    process.exit(1);
-});

package/dist/cli_v2.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export declare function runCliV2(): Promise<void>;

package/dist/cli_v2.js

@@ -1,94 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runCliV2 = runCliV2;
-const arg_1 = __importDefault(require("arg"));
-const chalk_1 = __importDefault(require("chalk"));
-const init_1 = require("./commands/init");
-const install_1 = require("./commands/install");
-const list_1 = require("./commands/list");
-// Define version from package.json
-// eslint-disable-next-line @typescript-eslint/no-require-imports
-const pkg = require("../package.json");
-async function runCliV2() {
-    const args = (0, arg_1.default)({
-        "--help": Boolean,
-        "--version": Boolean,
-        "--ci": Boolean,
-        "--verbose": Boolean,
-        "-h": "--help",
-        "-v": "--version",
-    }, {
-        permissive: true,
-        argv: process.argv.slice(2),
-    });
-    // Show version
-    if (args["--version"]) {
-        console.log(pkg.version);
-        process.exit(0);
-    }
-    // Show help
-    if (args["--help"]) {
-        showHelp();
-        process.exit(0);
-    }
-    const command = args._.length > 0 ? args._[0] : null;
-    try {
-        switch (command) {
-            case "init":
-                (0, init_1.initCommand)();
-                break;
-            case "install":
-                await (0, install_1.installCommand)(args["--ci"], args["--verbose"]);
-                break;
-            case "list":
-                await (0, list_1.listCommand)();
-                break;
-            default:
-                showHelp();
-                break;
-        }
-    }
-    catch (error) {
-        logError(error, args["--verbose"]);
-        process.exit(1);
-    }
-}
-function showHelp() {
-    console.log(`
-${chalk_1.default.bold("aicm v2")} - A CLI tool for managing AI IDE configurations (v2)
-
-${chalk_1.default.bold("USAGE")}
-  $ aicm-v2 [command] [options]
-
-${chalk_1.default.bold("COMMANDS")}
-  init                Initialize a new aicm configuration file
-  install             Install rules from configured sources
-  list                List all configured rules and their status
-
-${chalk_1.default.bold("OPTIONS")}
-  -h, --help          Show this help message
-  -v, --version       Show version number
-  --ci                Run in CI environments (default: \`false\`)
-  --verbose           Show detailed output and stack traces for debugging
-
-${chalk_1.default.bold("EXAMPLES")}
-  $ aicm-v2 init
-  $ aicm-v2 install
-  $ aicm-v2 list
-`);
-}
-function logError(error, verbose) {
-    if (error instanceof Error) {
-        console.error(chalk_1.default.red(`Error: ${error.message}`));
-        if (verbose && error.stack) {
-            console.error(chalk_1.default.gray(error.stack));
-        }
-    }
-    else {
-        console.error(chalk_1.default.red(`Error: ${String(error)}`));
-    }
-}

package/dist/commands/install/install-package.d.ts

@@ -1,53 +0,0 @@
-import { NormalizedConfig } from "../../types";
-/**
- * Options for the install functions
- */
-export interface InstallOptions {
-    /**
-     * Base directory to use instead of process.cwd()
-     */
-    cwd?: string;
-    /**
-     * Custom config object to use instead of loading from file
-     */
-    config?: NormalizedConfig;
-    /**
-     * allow installation on CI environments
-     */
-    installOnCI?: boolean;
-    /**
-     * Show verbose output during installation
-     */
-    verbose?: boolean;
-}
-/**
- * Result of the install operation
- */
-export interface InstallResult {
-    /**
-     * Whether the operation was successful
-     */
-    success: boolean;
-    /**
-     * Error message if the operation failed
-     */
-    error?: string;
-    /**
-     * Error stack trace for debugging (when available)
-     */
-    errorStack?: string;
-    /**
-     * Number of rules installed
-     */
-    installedRuleCount: number;
-    /**
-     * Number of packages installed
-     */
-    packagesCount: number;
-}
-/**
- * Install rules for a single package (used within workspaces and standalone installs)
- * @param options Install options
- * @returns Result of the install operation
- */
-export declare function installPackage(options?: InstallOptions): Promise<InstallResult>;

package/dist/commands/install/install-package.js

@@ -1,122 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.installPackage = installPackage;
-const chalk_1 = __importDefault(require("chalk"));
-const config_1 = require("../../utils/config");
-const rule_detector_1 = require("../../utils/rule-detector");
-const working_directory_1 = require("../../utils/working-directory");
-const rule_collector_1 = require("../../utils/rule-collector");
-const rule_writer_1 = require("../../utils/rule-writer");
-const mcp_writer_1 = require("../../utils/mcp-writer");
-const glob_handler_1 = require("../../utils/glob-handler");
-/**
- * Install rules for a single package (used within workspaces and standalone installs)
- * @param options Install options
- * @returns Result of the install operation
- */
-async function installPackage(options = {}) {
-    const cwd = options.cwd || process.cwd();
-    return (0, working_directory_1.withWorkingDirectory)(cwd, async () => {
-        const config = options.config || (await (0, config_1.getConfig)());
-        const ruleCollection = (0, rule_collector_1.initRuleCollection)();
-        if (!config) {
-            return {
-                success: false,
-                error: "Configuration file not found",
-                installedRuleCount: 0,
-                packagesCount: 0,
-            };
-        }
-        // Check if rules are defined (either directly or through presets)
-        if (!config.rules || Object.keys(config.rules).length === 0) {
-            // If there are no presets defined either, show a message
-            if (!config.presets || config.presets.length === 0) {
-                return {
-                    success: false,
-                    error: "No rules defined in configuration",
-                    installedRuleCount: 0,
-                    packagesCount: 0,
-                };
-            }
-        }
-        let expandedRules;
-        try {
-            const expansion = await (0, glob_handler_1.expandRulesGlobPatterns)(config.rules, cwd);
-            expandedRules = expansion.expandedRules;
-            if (options.verbose) {
-                for (const [expandedKey, originalPattern] of Object.entries(expansion.globSources)) {
-                    console.log(chalk_1.default.gray(`  Pattern "${originalPattern}" → ${expandedKey}`));
-                }
-            }
-        }
-        catch (error) {
-            const errorMessage = `Error expanding glob patterns: ${error instanceof Error ? error.message : String(error)}`;
-            return {
-                success: false,
-                error: errorMessage,
-                errorStack: error instanceof Error ? error.stack : undefined,
-                installedRuleCount: 0,
-                packagesCount: 0,
-            };
-        }
-        let hasErrors = false;
-        const errorMessages = [];
-        let firstErrorStack;
-        let installedRuleCount = 0;
-        for (const [name, source] of Object.entries(expandedRules)) {
-            const ruleType = (0, rule_detector_1.detectRuleType)(source);
-            const ruleBasePath = (0, config_1.getRuleSource)(config, name);
-            const originalPresetPath = (0, config_1.getOriginalPresetPath)(config, name);
-            try {
-                let ruleContent;
-                switch (ruleType) {
-                    case "npm":
-                        ruleContent = (0, rule_collector_1.collectNpmRule)(name, source);
-                        break;
-                    case "local":
-                        ruleContent = (0, rule_collector_1.collectLocalRule)(name, source, ruleBasePath);
-                        break;
-                    default:
-                        errorMessages.push(`Unknown rule type: ${ruleType}`);
-                        continue;
-                }
-                if (originalPresetPath) {
-                    ruleContent.presetPath = originalPresetPath;
-                }
-                (0, rule_collector_1.addRuleToCollection)(ruleCollection, ruleContent, config.ides);
-                installedRuleCount++;
-            }
-            catch (e) {
-                hasErrors = true;
-                const errorMessage = `Error processing rule ${name}: ${e instanceof Error ? e.message : String(e)}`;
-                errorMessages.push(errorMessage);
-                // Keep the first error stack trace
-                if (!firstErrorStack && e instanceof Error && e.stack) {
-                    firstErrorStack = e.stack;
-                }
-            }
-        }
-        if (hasErrors) {
-            return {
-                success: false,
-                error: errorMessages.join("; "),
-                errorStack: firstErrorStack,
-                installedRuleCount,
-                packagesCount: 0,
-            };
-        }
-        (0, rule_writer_1.writeRulesToTargets)(ruleCollection);
-        if (config.mcpServers) {
-            const filteredMcpServers = Object.fromEntries(Object.entries(config.mcpServers).filter(([, v]) => v !== false));
-            (0, mcp_writer_1.writeMcpServersToTargets)(filteredMcpServers, config.ides, cwd);
-        }
-        return {
-            success: true,
-            installedRuleCount,
-            packagesCount: 1,
-        };
-    });
-}

package/dist/commands/install/install-single-package.d.ts

@@ -1,53 +0,0 @@
-import { NormalizedConfig } from "../../types";
-/**
- * Options for the install functions
- */
-export interface InstallOptions {
-    /**
-     * Base directory to use instead of process.cwd()
-     */
-    cwd?: string;
-    /**
-     * Custom config object to use instead of loading from file
-     */
-    config?: NormalizedConfig;
-    /**
-     * allow installation on CI environments
-     */
-    installOnCI?: boolean;
-    /**
-     * Show verbose output during installation
-     */
-    verbose?: boolean;
-}
-/**
- * Result of the install operation
- */
-export interface InstallResult {
-    /**
-     * Whether the operation was successful
-     */
-    success: boolean;
-    /**
-     * Error message if the operation failed
-     */
-    error?: string;
-    /**
-     * Error stack trace for debugging (when available)
-     */
-    errorStack?: string;
-    /**
-     * Number of rules installed
-     */
-    installedRuleCount: number;
-    /**
-     * Number of packages installed
-     */
-    packagesCount: number;
-}
-/**
- * Core single package installation logic
- * @param options Install options
- * @returns Result of the install operation
- */
-export declare function installSinglePackage(options?: InstallOptions): Promise<InstallResult>;

package/dist/commands/install/install-single-package.js

@@ -1,139 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.installSinglePackage = installSinglePackage;
-const chalk_1 = __importDefault(require("chalk"));
-const config_1 = require("../../utils/config");
-const rule_detector_1 = require("../../utils/rule-detector");
-const rule_collector_1 = require("../../utils/rule-collector");
-const rule_writer_1 = require("../../utils/rule-writer");
-const mcp_writer_1 = require("../../utils/mcp-writer");
-const glob_handler_1 = require("../../utils/glob-handler");
-/**
- * Helper function to execute a function within a specific working directory
- * and ensure the original directory is always restored
- */
-async function withWorkingDirectory(targetDir, fn) {
-    const originalCwd = process.cwd();
-    if (targetDir !== originalCwd) {
-        process.chdir(targetDir);
-    }
-    try {
-        return await fn();
-    }
-    finally {
-        if (targetDir !== originalCwd) {
-            process.chdir(originalCwd);
-        }
-    }
-}
-/**
- * Core single package installation logic
- * @param options Install options
- * @returns Result of the install operation
- */
-async function installSinglePackage(options = {}) {
-    const cwd = options.cwd || process.cwd();
-    return withWorkingDirectory(cwd, async () => {
-        const config = options.config || (0, config_1.getConfig)();
-        const ruleCollection = (0, rule_collector_1.initRuleCollection)();
-        if (!config) {
-            return {
-                success: false,
-                error: "Configuration file not found",
-                installedRuleCount: 0,
-                packagesCount: 0,
-            };
-        }
-        // Check if rules are defined (either directly or through presets)
-        if (!config.rules || Object.keys(config.rules).length === 0) {
-            // If there are no presets defined either, show a message
-            if (!config.presets || config.presets.length === 0) {
-                return {
-                    success: false,
-                    error: "No rules defined in configuration",
-                    installedRuleCount: 0,
-                    packagesCount: 0,
-                };
-            }
-        }
-        let expandedRules;
-        try {
-            const expansion = await (0, glob_handler_1.expandRulesGlobPatterns)(config.rules, cwd);
-            expandedRules = expansion.expandedRules;
-            if (options.verbose) {
-                for (const [expandedKey, originalPattern] of Object.entries(expansion.globSources)) {
-                    console.log(chalk_1.default.gray(`  Pattern "${originalPattern}" → ${expandedKey}`));
-                }
-            }
-        }
-        catch (error) {
-            const errorMessage = `Error expanding glob patterns: ${error instanceof Error ? error.message : String(error)}`;
-            return {
-                success: false,
-                error: errorMessage,
-                errorStack: error instanceof Error ? error.stack : undefined,
-                installedRuleCount: 0,
-                packagesCount: 0,
-            };
-        }
-        let hasErrors = false;
-        const errorMessages = [];
-        let firstErrorStack;
-        let installedRuleCount = 0;
-        for (const [name, source] of Object.entries(expandedRules)) {
-            const ruleType = (0, rule_detector_1.detectRuleType)(source);
-            const ruleBasePath = (0, config_1.getRuleSource)(config, name);
-            const originalPresetPath = (0, config_1.getOriginalPresetPath)(config, name);
-            try {
-                let ruleContent;
-                switch (ruleType) {
-                    case "npm":
-                        ruleContent = (0, rule_collector_1.collectNpmRule)(name, source);
-                        break;
-                    case "local":
-                        ruleContent = (0, rule_collector_1.collectLocalRule)(name, source, ruleBasePath);
-                        break;
-                    default:
-                        errorMessages.push(`Unknown rule type: ${ruleType}`);
-                        continue;
-                }
-                if (originalPresetPath) {
-                    ruleContent.presetPath = originalPresetPath;
-                }
-                (0, rule_collector_1.addRuleToCollection)(ruleCollection, ruleContent, config.ides);
-                installedRuleCount++;
-            }
-            catch (e) {
-                hasErrors = true;
-                const errorMessage = `Error processing rule ${name}: ${e instanceof Error ? e.message : String(e)}`;
-                errorMessages.push(errorMessage);
-                // Keep the first error stack trace
-                if (!firstErrorStack && e instanceof Error && e.stack) {
-                    firstErrorStack = e.stack;
-                }
-            }
-        }
-        if (hasErrors) {
-            return {
-                success: false,
-                error: errorMessages.join("; "),
-                errorStack: firstErrorStack,
-                installedRuleCount,
-                packagesCount: 0,
-            };
-        }
-        (0, rule_writer_1.writeRulesToTargets)(ruleCollection);
-        if (config.mcpServers) {
-            const filteredMcpServers = Object.fromEntries(Object.entries(config.mcpServers).filter(([, v]) => v !== false));
-            (0, mcp_writer_1.writeMcpServersToTargets)(filteredMcpServers, config.ides, cwd);
-        }
-        return {
-            success: true,
-            installedRuleCount,
-            packagesCount: 1,
-        };
-    });
-}

package/dist/commands/install/install-workspaces.d.ts

@@ -1,9 +0,0 @@
-import { InstallResult } from "./install-package";
-/**
- * Install rules across multiple packages in a workspace
- * @param cwd The current working directory
- * @param installOnCI Whether to install on CI environments
- * @param verbose Whether to show verbose output
- * @returns Result of the install operation
- */
-export declare function installWorkspaces(cwd: string, installOnCI: boolean, verbose?: boolean): Promise<InstallResult>;