@sporesec/arcana 3.0.2 → 4.0.0

package/dist/cli.js

@@ -1,17 +1,17 @@
 import { createRequire } from "node:module";
 import { Command } from "commander";
 import { ui } from "./utils/ui.js";
+import { COMMANDS } from "./command-defs.js";
 const require = createRequire(import.meta.url);
 const pkg = require("../package.json");
 export function createCli() {
     const program = new Command();
     program.name("arcana").description("Universal AI development CLI").version(pkg.version);
-    // Store default help formatter before overriding
+    // Custom help formatter for root command
     const defaultFormatHelp = program.createHelp().formatHelp.bind(program.createHelp());
     program.configureHelp({
         formatHelp: (cmd, helper) => {
             if (cmd.name() === "arcana") {
-                // Lazy import to avoid loading help.ts at startup for subcommands
                 const { buildCustomHelp } = require("./utils/help.js");
                 return buildCustomHelp(pkg.version);
             }
@@ -29,11 +29,12 @@ export function createCli() {
             console.error();
         },
     });
+    // Default action: interactive menu or help
     program.argument("[command]", "", "").action(async (cmd) => {
         if (cmd) {
             console.error();
             console.error(ui.error("  Error: ") + `unknown command '${cmd}'`);
-            const { findClosestCommand } = await import("./command-registry.js");
+            const { findClosestCommand } = await import("./command-defs.js");
             const match = findClosestCommand(cmd);
             if (match) {
                 console.error(ui.dim(`  Did you mean '${match}'?`));
@@ -43,7 +44,6 @@ export function createCli() {
             process.exit(1);
         }
         const { isFirstRun, showWelcome, markInitialized, buildCustomHelp } = await import("./utils/help.js");
-        // Non-TTY (CI, pipes): print static help
         if (!process.stdout.isTTY) {
             console.log(buildCustomHelp(pkg.version));
             return;
@@ -55,299 +55,26 @@ export function createCli() {
         const { showInteractiveMenu } = await import("./interactive/index.js");
         await showInteractiveMenu(pkg.version);
     });
-    program
-        .command("list")
-        .description("List available skills")
-        .option("-p, --provider <name>", "Provider to list from")
-        .option("-a, --all", "List from all providers")
-        .option("--installed", "Show only installed skills")
-        .option("--no-cache", "Bypass skill cache")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nExamples:\n  arcana list\n  arcana list --installed\n  arcana list --all --no-cache")
-        .action(async (opts) => {
-        const { listCommand } = await import("./commands/list.js");
-        return listCommand(opts);
-    });
-    program
-        .command("install [skills...]")
-        .description("Install one or more skills")
-        .option("-p, --provider <name>", "Provider to install from")
-        .option("-a, --all", "Install all skills")
-        .option("-f, --force", "Reinstall even if already installed")
-        .option("--dry-run", "Show what would be installed without installing")
-        .option("-j, --json", "Output as JSON")
-        .option("--no-check", "Skip conflict detection")
-        .addHelpText("after", "\nExamples:\n  arcana install code-reviewer\n  arcana install skill1 skill2 skill3\n  arcana install --all --force")
-        .action(async (skills, opts) => {
-        const { installCommand } = await import("./commands/install.js");
-        return installCommand(skills, opts);
-    });
-    program
-        .command("info <skill>")
-        .description("Show skill details")
-        .option("-p, --provider <name>", "Provider to search")
-        .option("-j, --json", "Output as JSON")
-        .action(async (skill, opts) => {
-        const { infoCommand } = await import("./commands/info.js");
-        return infoCommand(skill, opts);
-    });
-    program
-        .command("search <query>")
-        .description("Search for skills across providers")
-        .option("-p, --provider <name>", "Limit search to provider")
-        .option("--no-cache", "Bypass skill cache")
-        .option("-t, --tag <tag>", "Filter by tech stack tag")
-        .option("-s, --smart", "Context-aware ranking (uses project detection)")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", '\nExamples:\n  arcana search testing\n  arcana search "code review"\n  arcana search react --tag typescript\n  arcana search api --smart')
-        .action(async (query, opts) => {
-        const { searchCommand } = await import("./commands/search.js");
-        return searchCommand(query, opts);
-    });
-    program
-        .command("providers")
-        .description("Manage skill providers")
-        .option("--add <owner/repo>", "Add a GitHub provider")
-        .option("--remove <name>", "Remove a provider")
-        .option("--json", "Output as JSON")
-        .action(async (opts) => {
-        const { providersCommand } = await import("./commands/providers.js");
-        return providersCommand(opts);
-    });
-    program
-        .command("create <name>")
-        .description("Create a new skill from template")
-        .action(async (name) => {
-        const { createCommand } = await import("./commands/create.js");
-        return createCommand(name);
-    });
-    program
-        .command("validate [skill]")
-        .description("Validate skill structure and metadata")
-        .option("-a, --all", "Validate all installed skills")
-        .option("-f, --fix", "Auto-fix common issues")
-        .option("-j, --json", "Output as JSON")
-        .option("--source <dir>", "Validate from source directory instead of install dir")
-        .option("--cross", "Run cross-validation (marketplace sync, companions, orphans)")
-        .option("--min-score <n>", "Minimum quality score (0-100), fail if any skill scores below", parseInt)
-        .action(async (skill, opts) => {
-        const { validateCommand } = await import("./commands/validate.js");
-        return validateCommand(skill, opts);
-    });
-    program
-        .command("update [skills...]")
-        .description("Update installed skills")
-        .option("-a, --all", "Update all installed skills")
-        .option("-p, --provider <name>", "Update from specific provider")
-        .option("-n, --dry-run", "Show what would be updated without updating")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nExamples:\n  arcana update code-reviewer\n  arcana update skill1 skill2\n  arcana update --all --dry-run")
-        .action(async (skills, opts) => {
-        const { updateCommand } = await import("./commands/update.js");
-        return updateCommand(skills, opts);
-    });
-    program
-        .command("uninstall [skills...]")
-        .description("Uninstall one or more skills")
-        .option("-y, --yes", "Skip confirmation prompt")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nExamples:\n  arcana uninstall code-reviewer\n  arcana uninstall skill1 skill2 --yes")
-        .action(async (skills, opts) => {
-        const { uninstallCommand } = await import("./commands/uninstall.js");
-        return uninstallCommand(skills, opts);
-    });
-    program
-        .command("init")
-        .description("Initialize arcana in current project")
-        .option("-t, --tool <name>", "Target tool (claude, cursor, codex, gemini, antigravity, windsurf, aider, all)")
-        .action(async (opts) => {
-        const { initCommand } = await import("./commands/init.js");
-        return initCommand(opts);
-    });
-    program
-        .command("doctor")
-        .description("Check environment and diagnose issues")
-        .option("-j, --json", "Output as JSON")
-        .action(async (opts) => {
-        const { doctorCommand } = await import("./commands/doctor.js");
-        return doctorCommand(opts);
-    });
-    program
-        .command("clean")
-        .description("Remove orphaned data, old session logs, and temp files")
-        .option("-n, --dry-run", "Show what would be removed without deleting")
-        .option("--aggressive", "Delete all session logs regardless of age")
-        .option("--keep-days <days>", "Keep main session logs newer than N days (default: 30)", parseInt)
-        .option("--json", "Output as JSON")
-        .action(async (opts) => {
-        const { cleanCommand } = await import("./commands/clean.js");
-        return cleanCommand(opts);
-    });
-    program
-        .command("compact")
-        .description("Remove agent logs while preserving main session history")
-        .option("-n, --dry-run", "Show what would be removed without deleting")
-        .option("--prune", "Also prune oversized main sessions (>14d old AND >10 MB)")
-        .option("--prune-days <days>", "Override prune age threshold (default: 14)", parseInt)
-        .option("-j, --json", "Output as JSON")
-        .action(async (opts) => {
-        const { compactCommand } = await import("./commands/compact.js");
-        return compactCommand(opts);
-    });
-    program
-        .command("stats")
-        .description("Show session analytics and token usage")
-        .option("-j, --json", "Output as JSON")
-        .action(async (opts) => {
-        const { statsCommand } = await import("./commands/stats.js");
-        return statsCommand(opts);
-    });
-    program
-        .command("config [action] [value]")
-        .description("View or modify arcana configuration")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nExamples:\n  arcana config\n  arcana config path\n  arcana config defaultProvider arcana\n  arcana config reset")
-        .action(async (action, value, opts) => {
-        const { configCommand } = await import("./commands/config.js");
-        return configCommand(action, value, opts);
-    });
-    program
-        .command("audit [skill]")
-        .description("Audit skill quality (code examples, BAD/GOOD pairs, structure)")
-        .option("-a, --all", "Audit all installed skills")
-        .option("-j, --json", "Output as JSON")
-        .option("--source <dir>", "Audit from source directory instead of install dir")
-        .action(async (skill, opts) => {
-        const { auditCommand } = await import("./commands/audit.js");
-        return auditCommand(skill, opts);
-    });
-    program
-        .command("scan [skill]")
-        .description("Scan skills for security threats (prompt injection, malware, credential theft)")
-        .option("-a, --all", "Scan all installed skills")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nExamples:\n  arcana scan code-reviewer\n  arcana scan --all\n  arcana scan --all --json")
-        .action(async (skill, opts) => {
-        const { scanCommand } = await import("./commands/scan.js");
-        return scanCommand(skill, opts);
-    });
-    program
-        .command("optimize")
-        .description("Analyze Claude Code setup and suggest token/performance improvements")
-        .option("-j, --json", "Output as JSON")
-        .action(async (opts) => {
-        const { optimizeCommand } = await import("./commands/optimize.js");
-        return optimizeCommand(opts);
-    });
-    // === Security ===
-    program
-        .command("verify [skill]")
-        .description("Verify installed skill integrity against lockfile")
-        .option("-a, --all", "Verify all installed skills")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nExamples:\n  arcana verify code-reviewer\n  arcana verify --all\n  arcana verify --all --json")
-        .action(async (skill, opts) => {
-        const { verifyCommand } = await import("./commands/verify.js");
-        return verifyCommand(skill, opts);
-    });
-    program
-        .command("lock")
-        .description("Generate or validate lockfile from installed skills")
-        .option("--ci", "Validate lockfile matches installed skills (CI mode)")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nExamples:\n  arcana lock\n  arcana lock --ci\n  arcana lock --json")
-        .action(async (opts) => {
-        const { lockCommand } = await import("./commands/lock.js");
-        return lockCommand(opts);
-    });
-    // === Performance & Inspection ===
-    program
-        .command("benchmark [skill]")
-        .description("Measure token cost of installed skills")
-        .option("-a, --all", "Benchmark all installed skills")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nExamples:\n  arcana benchmark code-reviewer\n  arcana benchmark --all")
-        .action(async (skill, opts) => {
-        const { benchmarkCommand } = await import("./commands/benchmark.js");
-        return benchmarkCommand(skill, opts);
-    });
-    program
-        .command("diff <skill>")
-        .description("Show changes between installed and remote skill version")
-        .option("-p, --provider <name>", "Provider to compare against")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nExamples:\n  arcana diff code-reviewer\n  arcana diff code-reviewer --json")
-        .action(async (skill, opts) => {
-        const { diffCommand } = await import("./commands/diff.js");
-        return diffCommand(skill, opts);
-    });
-    program
-        .command("outdated")
-        .description("List skills with newer versions available")
-        .option("-p, --provider <name>", "Check against specific provider")
-        .option("-j, --json", "Output as JSON")
-        .action(async (opts) => {
-        const { outdatedCommand } = await import("./commands/outdated.js");
-        return outdatedCommand(opts);
-    });
-    // === Workflow & Team ===
-    program
-        .command("profile [action] [name] [skills...]")
-        .description("Manage skill profiles (named sets of skills)")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nActions:\n  list          List all profiles (default)\n  create <name> Create a profile\n  delete <name> Delete a profile\n  show <name>   Show skills in a profile\n  apply <name>  Install all skills from a profile\n\nExamples:\n  arcana profile create security scan verify audit\n  arcana profile apply security")
-        .action(async (action, name, skills, opts) => {
-        const { profileCommand } = await import("./commands/profile.js");
-        return profileCommand(action, name, skills, opts);
-    });
-    program
-        .command("team [action] [skill]")
-        .description("Manage shared team skill configuration")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nActions:\n  init          Create .arcana/team.json\n  sync          Install skills from team config\n  add <skill>   Add a skill to team config\n  remove <skill> Remove a skill from team config\n\nExamples:\n  arcana team init\n  arcana team add code-reviewer\n  arcana team sync")
-        .action(async (action, skill, opts) => {
-        const { teamCommand } = await import("./commands/team.js");
-        return teamCommand(action, skill, opts);
-    });
-    program
-        .command("export")
-        .description("Export installed skills as a manifest")
-        .option("--sbom", "Export as SPDX-lite software bill of materials")
-        .option("-j, --json", "Output as JSON (default)")
-        .action(async (opts) => {
-        const { exportCommand } = await import("./commands/export-cmd.js");
-        return exportCommand(opts);
-    });
-    program
-        .command("import <file>")
-        .description("Import and install skills from a manifest file")
-        .option("-f, --force", "Reinstall even if already installed")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nExamples:\n  arcana import manifest.json\n  arcana import manifest.json --force")
-        .action(async (file, opts) => {
-        const { importCommand } = await import("./commands/import-cmd.js");
-        return importCommand(file, opts);
-    });
-    program
-        .command("completions <shell>")
-        .description("Generate shell completion scripts")
-        .option("-j, --json", "Output as JSON")
-        .addHelpText("after", "\nSupported shells: bash, zsh, fish\n\nExamples:\n  arcana completions bash >> ~/.bashrc\n  arcana completions zsh >> ~/.zshrc\n  arcana completions fish > ~/.config/fish/completions/arcana.fish")
-        .action(async (shell, opts) => {
-        const { completionsCommand } = await import("./commands/completions.js");
-        return completionsCommand(shell, opts);
-    });
-    // ── Smart Recommendations ──────────────────────────────────────
-    program
-        .command("recommend")
-        .description("Get smart skill recommendations for current project")
-        .option("-j, --json", "Output as JSON")
-        .option("-l, --limit <n>", "Max results per category", parseInt)
-        .option("-p, --provider <name>", "Limit to provider")
-        .addHelpText("after", "\nExamples:\n  arcana recommend\n  arcana recommend --json\n  arcana recommend --limit 5")
-        .action(async (opts) => {
-        const { recommendCommand } = await import("./commands/recommend.js");
-        return recommendCommand(opts);
-    });
+    // Register all commands from definitions
+    for (const def of COMMANDS) {
+        const cmd = program.command(def.command).description(def.description);
+        if (def.allowUnknownOption)
+            cmd.allowUnknownOption(true);
+        for (const opt of def.options ?? []) {
+            if (opt.parseAs === "int") {
+                cmd.option(opt.flags, opt.description, parseInt);
+            }
+            else {
+                cmd.option(opt.flags, opt.description);
+            }
+        }
+        if (def.helpText)
+            cmd.addHelpText("after", def.helpText);
+        cmd.action(async (...args) => {
+            const mod = (await import(def.module));
+            // Commander passes: [positionalArgs..., opts, Command] — strip Command
+            return mod[def.handler](...args.slice(0, -1));
+        });
+    }
     return program;
 }

package/dist/command-defs.d.ts

@@ -0,0 +1,28 @@
+export interface CommandOption {
+    flags: string;
+    description: string;
+    parseAs?: "int";
+}
+export interface CommandDef {
+    /** Commander command string, e.g. "install [skills...]" or "info <skill>" */
+    command: string;
+    description: string;
+    group: string;
+    options?: CommandOption[];
+    helpText?: string;
+    /** Module path for lazy import (relative to src/) */
+    module: string;
+    /** Export name of the handler function */
+    handler: string;
+    allowUnknownOption?: boolean;
+}
+export declare const COMMANDS: CommandDef[];
+export declare function getCommandNames(): string[];
+export declare function getGroupedCommands(): Record<string, {
+    name: string;
+    usage: string;
+    description: string;
+    group: string;
+}[]>;
+export declare function findClosestCommand(input: string): string | undefined;
+export declare function getCliReference(): string;