cc-agentic-framework 1.14.1

package/dist/commands/openclaw/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/commands/openclaw/export.ts"],"names":[],"mappings":"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"}

package/dist/commands/openclaw/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * OpenClaw Commands
+ */
+import { Command } from "commander";
+export declare function createOpenclawCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/openclaw/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/openclaw/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,qBAAqB,IAAI,OAAO,CAQ/C"}

package/dist/commands/openclaw/index.js

@@ -0,0 +1,11 @@
+/**
+ * OpenClaw Commands
+ */
+import { Command } from "commander";
+import { createOpenclawExportCommand } from "./export.js";
+export function createOpenclawCommand() {
+    const cmd = new Command("openclaw").description("OpenClaw integration commands");
+    cmd.addCommand(createOpenclawExportCommand());
+    return cmd;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/openclaw/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/openclaw/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAC7C,+BAA+B,CAChC,CAAC;IAEF,GAAG,CAAC,UAAU,CAAC,2BAA2B,EAAE,CAAC,CAAC;IAE9C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/planning/create-plan.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Planning Create Plan Command
+ *
+ * CLI command for creating new plan folders with auto-numbering and templates.
+ * Integrates with SkillTemplateEngine for skill-based template rendering.
+ *
+ * Usage:
+ *   agentic-framework planning create-plan --name my-plan --category framework
+ *   agentic-framework planning create-plan --name auth-refactor --category apm-r --dry-run
+ *   agentic-framework planning create-plan --name my-plan --use-skill-templates
+ *
+ * @module commands/planning/create-plan
+ */
+import { Command } from 'commander';
+/**
+ * Create the create-plan command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createCreatePlanCommand(): Command;
+//# sourceMappingURL=create-plan.d.ts.map

package/dist/commands/planning/create-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-plan.d.ts","sourceRoot":"","sources":["../../../src/commands/planning/create-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAoBjD"}

package/dist/commands/planning/create-plan.js

@@ -0,0 +1,74 @@
+/**
+ * Planning Create Plan Command
+ *
+ * CLI command for creating new plan folders with auto-numbering and templates.
+ * Integrates with SkillTemplateEngine for skill-based template rendering.
+ *
+ * Usage:
+ *   agentic-framework planning create-plan --name my-plan --category framework
+ *   agentic-framework planning create-plan --name auth-refactor --category apm-r --dry-run
+ *   agentic-framework planning create-plan --name my-plan --use-skill-templates
+ *
+ * @module commands/planning/create-plan
+ */
+import { Command } from 'commander';
+import { createPlan } from '../../lib/planning/plan-creator.js';
+import { CliContext } from '../../lib/cli-context.js';
+import { recordCLICommand } from '../../lib/telemetry/instrumentation/cli-instrumentation.js';
+/**
+ * Create the create-plan command.
+ *
+ * @returns Commander command instance
+ */
+export function createCreatePlanCommand() {
+    const command = new Command('create-plan');
+    command
+        .description('Create a new plan folder with auto-numbering and templates')
+        .option('-n, --name <name>', 'Plan name in kebab-case (e.g., "my-plan-name")')
+        .option('-c, --category <category>', 'Plan category (e.g., "framework", "apm-r")', 'framework')
+        .option('--dry-run', 'Preview what would be created without creating files', false)
+        .option('-p, --path <path>', 'Project root path', '.')
+        .action(async (cmdOptions) => {
+        try {
+            await runCreatePlanCommand(cmdOptions);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`\nError: ${errorMessage}\n`);
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Run the create-plan command.
+ *
+ * @param cmdOptions - Command options
+ */
+async function runCreatePlanCommand(cmdOptions) {
+    const startTime = Date.now();
+    const { name, category, dryRun, path: pathOption, } = cmdOptions;
+    // Validate required options
+    if (!name) {
+        throw new Error('Plan name is required. Use --name <name> to specify it.');
+    }
+    // Use CliContext for project detection and path resolution
+    // If explicit path is provided (and not '.'), use it; otherwise auto-detect
+    const ctx = pathOption && pathOption !== '.'
+        ? await CliContext.create({ path: pathOption })
+        : await CliContext.require();
+    // Get plans directory from path resolver
+    const plansDir = ctx.paths.getPlanPath(category);
+    // Create the plan using project root from context
+    const result = await createPlan(name, category, ctx.projectRoot, dryRun, plansDir);
+    // Record telemetry
+    const durationMs = Date.now() - startTime;
+    recordCLICommand('planning', 'create-plan', { name, category, dryRun }, { plan_id: result.planId, path: result.planPath }, durationMs, result.success).catch(() => { });
+    // Output result
+    console.log(result.message);
+    // Exit with error code if failed
+    if (!result.success) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=create-plan.js.map

package/dist/commands/planning/create-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-plan.js","sourceRoot":"","sources":["../../../src/commands/planning/create-plan.ts"],"names":[],"mappings":"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"}

package/dist/commands/planning/validate-plan.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Planning Validate Plan Command
+ *
+ * CLI command for validating plan structure and content against schema and custom rules.
+ *
+ * Usage:
+ *   agentic-framework planning validate-plan --path ./ai/plans/framework/001-my-plan
+ *   agentic-framework planning validate-plan --path ./ai/plans --strict
+ *
+ * @module commands/planning/validate-plan
+ */
+import { Command } from 'commander';
+/**
+ * Create the validate-plan command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createValidatePlanCommand(): Command;
+//# sourceMappingURL=validate-plan.d.ts.map

package/dist/commands/planning/validate-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-plan.d.ts","sourceRoot":"","sources":["../../../src/commands/planning/validate-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCpC;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAkBnD"}

package/dist/commands/planning/validate-plan.js

@@ -0,0 +1,276 @@
+/**
+ * Planning Validate Plan Command
+ *
+ * CLI command for validating plan structure and content against schema and custom rules.
+ *
+ * Usage:
+ *   agentic-framework planning validate-plan --path ./ai/plans/framework/001-my-plan
+ *   agentic-framework planning validate-plan --path ./ai/plans --strict
+ *
+ * @module commands/planning/validate-plan
+ */
+import { Command } from 'commander';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import fg from 'fast-glob';
+import matter from 'gray-matter';
+import { validateWithSchema } from '../../lib/validation/schema-validator.js';
+import { formatReport, mergeReports, } from '../../lib/validation/validation-report.js';
+import { validatePlanRules, validatePlanContent, } from '../../lib/validation/rules/plan-rules.js';
+import chalk from 'chalk';
+import { CliContext } from '../../lib/cli-context.js';
+import { recordCLICommand } from '../../lib/telemetry/instrumentation/cli-instrumentation.js';
+// Use different variable names to avoid conflict with CommonJS globals in Jest
+const currentFilePath = fileURLToPath(import.meta.url);
+const currentDirPath = path.dirname(currentFilePath);
+/**
+ * Create the validate-plan command.
+ *
+ * @returns Commander command instance
+ */
+export function createValidatePlanCommand() {
+    const command = new Command('validate-plan');
+    command
+        .description('Validate plan structure and content against schema and best practices')
+        .option('-p, --path <path>', 'Path to plan file or folder (searches for PLAN.md files)', '.')
+        .option('-s, --strict', 'Exit with error code on warnings (not just errors)', false)
+        .action(async (cmdOptions) => {
+        try {
+            await runValidatePlanCommand(cmdOptions);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(`\nError: ${errorMessage}\n`));
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Run the validate-plan command.
+ *
+ * @param options - Command options
+ */
+async function runValidatePlanCommand(options) {
+    const startTime = Date.now();
+    const { path: searchPath, strict } = options;
+    // Use CliContext to get project root for schema resolution
+    // Try to get context but don't require it - validation can work with explicit paths
+    let projectRoot;
+    try {
+        const ctx = await CliContext.create();
+        projectRoot = ctx.projectRoot;
+    }
+    catch {
+        projectRoot = process.cwd();
+    }
+    // Resolve search path
+    const resolvedPath = path.resolve(searchPath);
+    // Check if path exists
+    if (!(await fs.pathExists(resolvedPath))) {
+        throw new Error(`Path does not exist: ${resolvedPath}`);
+    }
+    // Find PLAN.md files
+    const planFiles = await findPlanFiles(resolvedPath);
+    if (planFiles.length === 0) {
+        console.log(chalk.yellow('\nNo PLAN.md files found in the specified path.\n'));
+        process.exit(0);
+    }
+    console.log(chalk.blue(`\nFound ${planFiles.length} plan file(s) to validate...\n`));
+    // Get schema path using project root from context
+    const schemaPath = await getSchemaPath(projectRoot);
+    if (!schemaPath) {
+        throw new Error('Plan schema not found. Expected at framework/modules/planning/schemas/plan.schema.json');
+    }
+    // Validate each plan file
+    const allReports = [];
+    for (const planFile of planFiles) {
+        console.log(chalk.cyan(`Validating: ${path.relative(projectRoot, planFile)}`));
+        const report = await validatePlanFile(planFile, schemaPath);
+        allReports.push(report);
+    }
+    // Merge all reports
+    const finalReport = mergeReports(...allReports);
+    // Output results
+    console.log('\n' + chalk.bold('='.repeat(60)));
+    console.log(chalk.bold('Validation Results'));
+    console.log(chalk.bold('='.repeat(60)) + '\n');
+    // Determine validation result
+    const hasErrors = finalReport.summary.errors > 0;
+    const hasWarnings = finalReport.summary.warnings > 0;
+    const isValid = finalReport.valid && finalReport.issues.length === 0;
+    // Record telemetry
+    const durationMs = Date.now() - startTime;
+    recordCLICommand('planning', 'validate-plan', { path: searchPath, strict }, { valid: !hasErrors, errors: finalReport.summary.errors }, durationMs, !hasErrors).catch(() => { });
+    if (isValid) {
+        console.log(chalk.green('✓ All plans passed validation with no issues!\n'));
+        process.exit(0);
+    }
+    // Format and display report
+    const formattedReport = formatReport(finalReport);
+    console.log(formattedReport);
+    if (hasErrors) {
+        console.log(chalk.red('\n✗ Validation failed with errors.\n'));
+        process.exit(1);
+    }
+    else if (hasWarnings && strict) {
+        console.log(chalk.yellow('\n⚠ Validation completed with warnings (strict mode enabled).\n'));
+        process.exit(1);
+    }
+    else if (hasWarnings) {
+        console.log(chalk.yellow('\n⚠ Validation completed with warnings.\n'));
+        process.exit(0);
+    }
+    else {
+        console.log(chalk.green('\n✓ Validation passed.\n'));
+        process.exit(0);
+    }
+}
+/**
+ * Find all PLAN.md files in the given path
+ *
+ * @param searchPath - Path to search (file or directory)
+ * @returns Array of PLAN.md file paths
+ */
+async function findPlanFiles(searchPath) {
+    const stat = await fs.stat(searchPath);
+    if (stat.isFile()) {
+        // If it's a file, check if it's PLAN.md
+        if (path.basename(searchPath) === 'PLAN.md') {
+            return [searchPath];
+        }
+        throw new Error(`Specified file is not PLAN.md: ${searchPath}`);
+    }
+    // If it's a directory, search for all PLAN.md files
+    const planFiles = await fg('**/PLAN.md', {
+        cwd: searchPath,
+        absolute: true,
+        ignore: ['**/node_modules/**', '**/.git/**', '**/dist/**'],
+    });
+    return planFiles;
+}
+/**
+ * Get path to plan schema file
+ *
+ * @param projectRoot - Project root path from CliContext
+ * @returns Path to schema or null if not found
+ */
+async function getSchemaPath(projectRoot) {
+    // Try to find schema relative to project root (from CliContext) first
+    const possiblePaths = [
+        // Primary: project root from CliContext
+        path.join(projectRoot, 'framework/modules/planning/schemas/plan.schema.json'),
+        // Fallback paths for different project structures
+        path.join(projectRoot, '../modules/planning/schemas/plan.schema.json'),
+        path.join(projectRoot, '../../modules/planning/schemas/plan.schema.json'),
+        // For when running from installed package
+        path.join(currentDirPath, '../../../framework/modules/planning/schemas/plan.schema.json'),
+        path.join(currentDirPath, '../../../../modules/planning/schemas/plan.schema.json'),
+    ];
+    for (const schemaPath of possiblePaths) {
+        if (await fs.pathExists(schemaPath)) {
+            return schemaPath;
+        }
+    }
+    return null;
+}
+/**
+ * Normalize frontmatter data by converting Date objects to ISO date strings.
+ * YAML parsers interpret unquoted dates like `2025-12-29` as Date objects,
+ * but our schema expects strings. This function converts them to be user-friendly.
+ *
+ * @param data - Raw frontmatter data from YAML parser
+ * @returns Normalized data with Date objects converted to strings
+ */
+function normalizeFrontmatter(data) {
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (value instanceof Date) {
+            // Convert Date to ISO date string (YYYY-MM-DD)
+            result[key] = value.toISOString().split('T')[0];
+        }
+        else if (Array.isArray(value)) {
+            // Recursively normalize array elements
+            result[key] = value.map((item) => item && typeof item === 'object' && !(item instanceof Date)
+                ? normalizeFrontmatter(item)
+                : item instanceof Date
+                    ? item.toISOString().split('T')[0]
+                    : item);
+        }
+        else if (value && typeof value === 'object') {
+            // Recursively normalize nested objects
+            result[key] = normalizeFrontmatter(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Validate a single plan file
+ *
+ * @param planFile - Path to PLAN.md file
+ * @param schemaPath - Path to plan schema
+ * @returns Validation report
+ */
+async function validatePlanFile(planFile, schemaPath) {
+    try {
+        // Read and parse the plan file
+        const fileContent = await fs.readFile(planFile, 'utf-8');
+        const parsed = matter(fileContent);
+        // Normalize frontmatter: convert Date objects to ISO date strings
+        // YAML parsers interpret unquoted dates like `2025-12-29` as Date objects
+        const frontmatter = normalizeFrontmatter(parsed.data);
+        const content = parsed.content;
+        // Validate frontmatter against schema
+        const schemaReport = await validateWithSchema(frontmatter, schemaPath);
+        // Fix schema report locations: replace schema path with the actual plan file path
+        schemaReport.issues = schemaReport.issues.map((issue) => ({
+            ...issue,
+            location: { file: planFile, ...(issue.location?.line ? { line: issue.location.line } : {}) },
+        }));
+        // Apply custom validation rules to frontmatter
+        const rulesIssues = validatePlanRules(frontmatter, planFile);
+        const rulesReport = {
+            valid: rulesIssues.filter((i) => i.severity === 'error').length === 0,
+            issues: rulesIssues,
+            summary: {
+                errors: rulesIssues.filter((i) => i.severity === 'error').length,
+                warnings: rulesIssues.filter((i) => i.severity === 'warning').length,
+                info: rulesIssues.filter((i) => i.severity === 'info').length,
+            },
+        };
+        // Validate markdown content
+        const contentIssues = validatePlanContent(content, planFile);
+        const contentReport = {
+            valid: contentIssues.filter((i) => i.severity === 'error').length === 0,
+            issues: contentIssues,
+            summary: {
+                errors: contentIssues.filter((i) => i.severity === 'error').length,
+                warnings: contentIssues.filter((i) => i.severity === 'warning').length,
+                info: contentIssues.filter((i) => i.severity === 'info').length,
+            },
+        };
+        // Merge all reports
+        return mergeReports(schemaReport, rulesReport, contentReport);
+    }
+    catch (error) {
+        // Return error report if file can't be read/parsed
+        return {
+            valid: false,
+            issues: [
+                {
+                    severity: 'error',
+                    code: 'FILE_READ_ERROR',
+                    message: `Failed to read or parse plan file: ${error instanceof Error ? error.message : String(error)}`,
+                    location: { file: planFile },
+                    suggestion: 'Ensure the file exists and contains valid YAML frontmatter',
+                },
+            ],
+            summary: { errors: 1, warnings: 0, info: 0 },
+        };
+    }
+}
+//# sourceMappingURL=validate-plan.js.map

package/dist/commands/planning/validate-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-plan.js","sourceRoot":"","sources":["../../../src/commands/planning/validate-plan.ts"],"names":[],"mappings":"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"}

package/dist/commands/remove.d.ts

@@ -0,0 +1,8 @@
+interface RemoveOptions {
+    path: string;
+    force: boolean;
+    dryRun?: boolean;
+}
+export declare function removeCommand(moduleName: string, options: RemoveOptions): Promise<void>;
+export {};
+//# sourceMappingURL=remove.d.ts.map

package/dist/commands/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAWA,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6K7F"}

package/dist/commands/remove.js

@@ -0,0 +1,157 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import { loadModule, getOptionalDependents } from '../lib/module-loader.js';
+import { ManifestManager } from '../lib/manifest-manager.js';
+import { generateRegistries } from '../lib/registry-generator.js';
+import { recordCLICommand } from '../lib/telemetry/instrumentation/cli-instrumentation.js';
+import { CleanupEngine } from '../lib/cleanup-engine.js';
+export async function removeCommand(moduleName, options) {
+    const startTime = Date.now();
+    const projectPath = path.resolve(options.path);
+    console.log(chalk.blue(`\nRemoving module: ${moduleName}\n`));
+    // Validate project exists
+    if (!await fs.pathExists(path.join(projectPath, 'CLAUDE.md'))) {
+        console.error(chalk.red('Error: Not an Agentic Framework project (CLAUDE.md not found)'));
+        process.exit(1);
+    }
+    // Special handling for core module removal
+    if (moduleName === 'core') {
+        const optionalDependents = await getOptionalDependents('core');
+        console.log(chalk.yellow('\nWarning: Removing core module will affect functionality:\n'));
+        console.log(chalk.dim('  - Framework management agents (ai-framework-manager, etc.) will be removed'));
+        console.log(chalk.dim('  - Shared skills (verifying-quality, committing-code) will be removed'));
+        if (optionalDependents.length > 0) {
+            console.log(chalk.dim(`  - The following modules have optional dependency on core:`));
+            for (const dep of optionalDependents) {
+                console.log(chalk.dim(`    • ${dep}`));
+            }
+        }
+        console.log('');
+    }
+    // Load module before preview
+    const module = await loadModule(moduleName);
+    // Initialize CleanupEngine
+    const cleanupEngine = new CleanupEngine(projectPath, options.dryRun || false);
+    // Preview cleanup
+    const preview = await cleanupEngine.previewCleanup(module);
+    // Show preview
+    const hasArtifacts = preview.agents.length > 0 ||
+        preview.skills.length > 0 ||
+        preview.templates.length > 0 ||
+        preview.schemas.length > 0 ||
+        preview.scripts.length > 0;
+    if (hasArtifacts) {
+        console.log(chalk.bold('\nArtifacts to be removed:'));
+        if (preview.agents.length > 0) {
+            console.log(chalk.dim(`  Agents: ${preview.agents.length} (${preview.agents.join(', ')})`));
+        }
+        if (preview.skills.length > 0) {
+            console.log(chalk.dim(`  Skills: ${preview.skills.length} (${preview.skills.join(', ')})`));
+        }
+        if (preview.templates.length > 0) {
+            console.log(chalk.dim(`  Templates: ${preview.templates.join(', ')}`));
+        }
+        if (preview.schemas.length > 0) {
+            console.log(chalk.dim(`  Schemas: ${preview.schemas.join(', ')}`));
+        }
+        if (preview.scripts.length > 0) {
+            console.log(chalk.dim(`  Scripts: ${preview.scripts.join(', ')}`));
+        }
+    }
+    else {
+        console.log(chalk.dim('\nNo artifacts found to remove (module may have already been cleaned up).'));
+    }
+    // Show warnings
+    if (preview.warnings.length > 0) {
+        console.log(chalk.yellow('\n⚠️  Warnings:'));
+        preview.warnings.forEach(w => console.log(chalk.yellow(`  - ${w}`)));
+    }
+    // If dry-run, exit here
+    if (options.dryRun) {
+        console.log(chalk.cyan('\n[Dry run mode - no changes made]'));
+        return;
+    }
+    // Confirm removal
+    if (!options.force) {
+        // Check if stdin is a TTY - inquirer requires interactive terminal
+        if (!process.stdin.isTTY) {
+            console.error(chalk.red('\nError: Interactive confirmation requires a TTY terminal.'));
+            console.error(chalk.dim('Use --force flag to skip confirmation in non-interactive environments.'));
+            process.exit(1);
+        }
+        console.log(''); // Add spacing before prompt
+        const { confirm } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: `Are you sure you want to remove module '${moduleName}'?`,
+                default: false,
+            },
+        ]);
+        if (!confirm) {
+            console.log('Removal cancelled');
+            process.exit(0);
+        }
+    }
+    // Execute cleanup
+    const spinner = ora(`Removing module artifacts: ${moduleName}...`).start();
+    try {
+        const result = await cleanupEngine.cleanupModule(module);
+        const totalRemoved = result.files.length + result.directories.length;
+        spinner.succeed(`Module artifacts removed: ${totalRemoved} items`);
+    }
+    catch (error) {
+        spinner.fail(`Failed to remove module artifacts: ${moduleName}`);
+        throw error;
+    }
+    // Update manifest and registries
+    const manifestManager = new ManifestManager(projectPath);
+    // Update manifest
+    spinner.start('Updating manifest...');
+    try {
+        if (await manifestManager.exists()) {
+            await manifestManager.removeModule(moduleName);
+            spinner.succeed('Manifest updated');
+        }
+        else {
+            spinner.warn('No manifest found - skipping manifest update');
+        }
+    }
+    catch (error) {
+        spinner.fail('Failed to update manifest');
+        throw error;
+    }
+    // Update registries
+    spinner.start('Updating registries...');
+    try {
+        if (await manifestManager.exists()) {
+            const manifest = await manifestManager.read();
+            const installedModuleIds = Object.keys(manifest.modules);
+            // Load all remaining installed modules to regenerate registries
+            const installedModules = await Promise.all(installedModuleIds.map(async (id) => {
+                try {
+                    return await loadModule(id);
+                }
+                catch {
+                    return null;
+                }
+            }));
+            // Filter out any modules that failed to load
+            const validModules = installedModules.filter((m) => m !== null);
+            await generateRegistries(projectPath, validModules);
+        }
+        spinner.succeed('Registries updated');
+    }
+    catch (error) {
+        spinner.fail('Failed to update registries');
+        throw error;
+    }
+    console.log(chalk.green(`\n✓ Module '${moduleName}' removed successfully!\n`));
+    // Record telemetry
+    const durationMs = Date.now() - startTime;
+    recordCLICommand('remove', undefined, { path: options.path, force: options.force, dryRun: options.dryRun }, { module_removed: moduleName }, durationMs, true).catch(() => { });
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"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"}