@sporesec/arcana 3.0.3 → 4.0.0

package/dist/commands/lock.js

@@ -31,21 +31,25 @@ export async function lockCommand(opts) {
     return generateMode(opts.json);
 }
 async function generateMode(json) {
+    /* v8 ignore start */
     if (!json) {
         console.log(renderBanner());
         console.log();
         p.intro(chalk.bold("Generate lockfile"));
     }
+    /* v8 ignore stop */
     const installDir = getInstallDir();
     if (!existsSync(installDir)) {
         if (json) {
             console.log(JSON.stringify({ action: "generate", entries: 0, path: "~/.arcana/arcana-lock.json" }));
+            writeLockfile([]);
+            return;
         }
-        else {
-            p.log.info("No skills installed. Lockfile written with 0 entries.");
-        }
+        /* v8 ignore start */
+        p.log.info("No skills installed. Lockfile written with 0 entries.");
         writeLockfile([]);
         return;
+        /* v8 ignore stop */
     }
     const dirs = readdirSync(installDir).filter((d) => {
         try {
@@ -74,18 +78,21 @@ async function generateMode(json) {
     writeLockfile(entries);
     if (json) {
         console.log(JSON.stringify({ action: "generate", entries: entries.length, path: "~/.arcana/arcana-lock.json" }));
+        return;
     }
-    else {
-        p.log.success(`Lockfile written with ${entries.length} entries.`);
-        p.outro(chalk.dim("~/.arcana/arcana-lock.json"));
-    }
+    /* v8 ignore start */
+    p.log.success(`Lockfile written with ${entries.length} entries.`);
+    p.outro(chalk.dim("~/.arcana/arcana-lock.json"));
+    /* v8 ignore stop */
 }
 async function ciMode(json) {
+    /* v8 ignore start */
     if (!json) {
         console.log(renderBanner());
         console.log();
         p.intro(chalk.bold("Validate lockfile"));
     }
+    /* v8 ignore stop */
     const existing = readLockfile();
     if (existing.length === 0) {
         const lockPath = join(getInstallDir(), "..", "arcana-lock.json");
@@ -99,11 +106,12 @@ async function ciMode(json) {
                     extra: [],
                     error: "No lockfile found",
                 }));
+                process.exit(1);
             }
-            else {
-                printErrorWithHint(new Error("No lockfile found. Run `arcana lock` first to generate one."), true);
-            }
+            /* v8 ignore start */
+            printErrorWithHint(new Error("No lockfile found. Run `arcana lock` first to generate one."), true);
             process.exit(1);
+            /* v8 ignore stop */
         }
     }
     const installDir = getInstallDir();
@@ -146,26 +154,29 @@ async function ciMode(json) {
     const valid = mismatches.length === 0 && missing.length === 0 && extra.length === 0;
     if (json) {
         console.log(JSON.stringify({ action: "ci", valid, mismatches, missing, extra }));
+        if (!valid)
+            process.exit(1);
+        return;
+    }
+    /* v8 ignore start */
+    if (valid) {
+        p.log.success("Lockfile matches installed state.");
+        p.outro(chalk.dim("All entries verified."));
     }
     else {
-        if (valid) {
-            p.log.success("Lockfile matches installed state.");
-            p.outro(chalk.dim("All entries verified."));
+        if (mismatches.length > 0) {
+            p.log.error(`Hash mismatch: ${mismatches.join(", ")}`);
         }
-        else {
-            if (mismatches.length > 0) {
-                p.log.error(`Hash mismatch: ${mismatches.join(", ")}`);
-            }
-            if (missing.length > 0) {
-                p.log.error(`Missing from disk: ${missing.join(", ")}`);
-            }
-            if (extra.length > 0) {
-                p.log.warn(`Extra (not in lockfile): ${extra.join(", ")}`);
-            }
-            p.outro(chalk.dim("Lockfile validation failed."));
+        if (missing.length > 0) {
+            p.log.error(`Missing from disk: ${missing.join(", ")}`);
+        }
+        if (extra.length > 0) {
+            p.log.warn(`Extra (not in lockfile): ${extra.join(", ")}`);
         }
+        p.outro(chalk.dim("Lockfile validation failed."));
     }
     if (!valid) {
         process.exit(1);
     }
+    /* v8 ignore stop */
 }

package/dist/commands/mcp.d.ts

@@ -0,0 +1,4 @@
+export declare function mcpCommand(action: string, name: string | undefined, opts: {
+    tool?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/mcp.js

@@ -0,0 +1,87 @@
+import { ui, banner } from "../utils/ui.js";
+export async function mcpCommand(action, name, opts) {
+    if (action === "list") {
+        const { listRegistry } = await import("../mcp/registry.js");
+        const servers = listRegistry();
+        if (opts.json) {
+            console.log(JSON.stringify(servers));
+            return;
+        }
+        /* v8 ignore start */
+        banner();
+        console.log(ui.bold("  Available MCP Servers\n"));
+        for (const s of servers) {
+            console.log(`  ${ui.success(s.name)} ${s.description}`);
+            console.log(ui.dim(`       ${s.command} ${s.args.join(" ")}`));
+        }
+        console.log();
+        return;
+        /* v8 ignore stop */
+    }
+    if (action === "install") {
+        if (!name) {
+            console.error("Usage: arcana mcp install <name>");
+            process.exit(1);
+        }
+        const { installMcpServer } = await import("../mcp/install.js");
+        const tool = (opts.tool ?? "claude");
+        const result = installMcpServer(name, tool, process.cwd());
+        if (opts.json) {
+            console.log(JSON.stringify(result));
+            return;
+        }
+        /* v8 ignore start */
+        if (result.installed) {
+            console.log(`${ui.success("[OK]")} ${name} configured in ${result.path}`);
+            if (result.error)
+                console.log(ui.dim(`  Note: ${result.error}`));
+        }
+        else {
+            console.log(`${ui.warn("[!!]")} ${result.error}`);
+        }
+        return;
+        /* v8 ignore stop */
+    }
+    if (action === "remove") {
+        if (!name) {
+            console.error("Usage: arcana mcp remove <name>");
+            process.exit(1);
+        }
+        const { removeMcpServer } = await import("../mcp/install.js");
+        const tool = (opts.tool ?? "claude");
+        const ok = removeMcpServer(name, tool, process.cwd());
+        if (opts.json) {
+            console.log(JSON.stringify({ removed: ok, name }));
+            return;
+        }
+        /* v8 ignore start */
+        console.log(ok ? `${ui.success("[OK]")} Removed ${name}` : `${ui.warn("[!!]")} ${name} not found`);
+        return;
+        /* v8 ignore stop */
+    }
+    if (action === "status") {
+        const { listConfiguredServers } = await import("../mcp/install.js");
+        const tool = (opts.tool ?? "claude");
+        const servers = listConfiguredServers(tool, process.cwd());
+        if (opts.json) {
+            console.log(JSON.stringify({ tool, servers }));
+            return;
+        }
+        /* v8 ignore start */
+        banner();
+        console.log(ui.bold(`  MCP Status (${tool})\n`));
+        if (servers.length === 0) {
+            console.log(ui.dim("  No MCP servers configured."));
+        }
+        else {
+            for (const s of servers) {
+                console.log(`  ${ui.success("[OK]")} ${s}`);
+            }
+        }
+        console.log();
+        return;
+        /* v8 ignore stop */
+    }
+    console.error("Usage: arcana mcp <list|install|remove|status> [name]");
+    process.exit(1);
+}

package/dist/commands/outdated.js

@@ -35,10 +35,10 @@ export async function outdatedCommand(opts) {
     if (skills.length === 0) {
         if (opts.json) {
             console.log(JSON.stringify({ outdated: [], upToDate: 0, total: 0 }));
+            process.exit(0);
         }
-        else {
-            console.log("No skills installed.");
-        }
+        /* v8 ignore next 2 */
+        console.log("No skills installed.");
         process.exit(0);
     }
     const providerName = opts.provider ?? loadConfig().defaultProvider;
@@ -51,10 +51,10 @@ export async function outdatedCommand(opts) {
                 upToDate: 0,
                 total: 0,
             }));
+            process.exit(0);
         }
-        else {
-            console.error("No providers configured. Run: arcana providers --add owner/repo");
-        }
+        /* v8 ignore next 2 */
+        console.error("No providers configured. Run: arcana providers --add owner/repo");
         process.exit(0);
     }
     const outdated = [];
@@ -116,6 +116,7 @@ export async function outdatedCommand(opts) {
         console.log(JSON.stringify(result, null, 2));
         process.exit(0);
     }
+    /* v8 ignore start -- display-only console table output */
     // Console output: aligned table
     console.log(`Checked ${result.total} installed skills.`);
     console.log();
@@ -156,4 +157,5 @@ export async function outdatedCommand(opts) {
     console.log();
     console.log(`${outdated.length} outdated, ${upToDate} up to date, ${result.total} total`);
     process.exit(0);
+    /* v8 ignore stop */
 }

package/dist/commands/providers.js

@@ -3,11 +3,13 @@ import { loadConfig, addProvider, removeProvider } from "../utils/config.js";
 import { httpGet } from "../utils/http.js";
 import { parseProviderSlug, clearProviderCache } from "../registry.js";
 export async function providersCommand(opts) {
+    /* v8 ignore next */
     if (!opts.json)
         banner();
     if (opts.add) {
         const { owner, repo } = parseProviderSlug(opts.add);
         const name = `${owner}/${repo}`;
+        /* v8 ignore next */
         const s = opts.json ? noopSpinner() : spinner(`Validating ${opts.add}...`);
         s.start();
         try {
@@ -22,54 +24,58 @@ export async function providersCommand(opts) {
             catch {
                 if (opts.json) {
                     console.log(JSON.stringify({ error: `Could not find marketplace.json at ${opts.add}` }));
+                    process.exit(1);
                 }
-                else {
-                    s.fail(`Could not find marketplace.json at ${opts.add}`);
-                    console.log(ui.dim("  Ensure the repo has .claude-plugin/marketplace.json"));
-                    console.log();
-                }
+                /* v8 ignore start */
+                s.fail(`Could not find marketplace.json at ${opts.add}`);
+                console.log(ui.dim("  Ensure the repo has .claude-plugin/marketplace.json"));
+                console.log();
                 process.exit(1);
+                /* v8 ignore stop */
             }
         }
         addProvider({ name, type: "github", url: opts.add, enabled: true });
         clearProviderCache();
         if (opts.json) {
             console.log(JSON.stringify({ action: "add", provider: name, success: true }));
+            return;
         }
-        else {
-            console.log(ui.success(`  Added provider: ${name}`));
-            console.log(ui.dim(`  Use: arcana list --provider ${name}`));
-            console.log();
-        }
+        /* v8 ignore start */
+        console.log(ui.success(`  Added provider: ${name}`));
+        console.log(ui.dim(`  Use: arcana list --provider ${name}`));
+        console.log();
         return;
+        /* v8 ignore stop */
     }
     if (opts.remove) {
         if (opts.remove === "arcana") {
             if (opts.json) {
                 console.log(JSON.stringify({ error: "Cannot remove the default provider" }));
+                process.exit(1);
             }
-            else {
-                console.log(ui.error("  Cannot remove the default provider."));
-                console.log();
-            }
+            /* v8 ignore start */
+            console.log(ui.error("  Cannot remove the default provider."));
+            console.log();
             process.exit(1);
+            /* v8 ignore stop */
         }
         const removed = removeProvider(opts.remove);
         if (removed)
             clearProviderCache();
         if (opts.json) {
             console.log(JSON.stringify({ action: "remove", provider: opts.remove, success: removed }));
+            return;
+        }
+        /* v8 ignore start */
+        if (removed) {
+            console.log(ui.success(`  Removed provider: ${opts.remove}`));
         }
         else {
-            if (removed) {
-                console.log(ui.success(`  Removed provider: ${opts.remove}`));
-            }
-            else {
-                console.log(ui.error(`  Provider "${opts.remove}" not found.`));
-            }
-            console.log();
+            console.log(ui.error(`  Provider "${opts.remove}" not found.`));
         }
+        console.log();
         return;
+        /* v8 ignore stop */
     }
     const config = loadConfig();
     if (opts.json) {
@@ -84,6 +90,7 @@ export async function providersCommand(opts) {
         }));
         return;
     }
+    /* v8 ignore start */
     console.log(ui.bold("  Configured providers:"));
     console.log();
     const rows = config.providers.map((p) => [
@@ -97,4 +104,5 @@ export async function providersCommand(opts) {
     console.log(ui.dim("  Add:    arcana providers --add owner/repo"));
     console.log(ui.dim("  Remove: arcana providers --remove name"));
     console.log();
+    /* v8 ignore stop */
 }

package/dist/commands/recommend.js

@@ -6,6 +6,7 @@ import { getProviders } from "../registry.js";
 export async function recommendCommand(opts) {
     const cwd = process.cwd();
     const context = detectProjectContext(cwd);
+    /* v8 ignore start */
     if (!opts.json) {
         p.intro(chalk.bold("Smart Recommendations"));
         p.log.step(`Project: ${chalk.cyan(context.name)} (${context.type} / ${context.lang})`);
@@ -16,6 +17,7 @@ export async function recommendCommand(opts) {
             p.log.info(`Rules found: ${context.ruleFiles.join(", ")}`);
         }
     }
+    /* v8 ignore stop */
     // Fetch all skills from providers
     const providers = getProviders(opts.provider);
     const allSkills = [];
@@ -25,18 +27,20 @@ export async function recommendCommand(opts) {
             allSkills.push(...skills);
         }
         catch (err) {
+            /* v8 ignore start */
             if (!opts.json) {
                 p.log.warn(`Could not fetch from ${prov.displayName}: ${err instanceof Error ? err.message : String(err)}`);
             }
+            /* v8 ignore stop */
         }
     }
     if (allSkills.length === 0) {
         if (opts.json) {
             console.log(JSON.stringify({ error: "No skills available" }));
+            process.exit(1);
         }
-        else {
-            p.log.error("No skills available from any provider.");
-        }
+        /* v8 ignore next 2 */
+        p.log.error("No skills available from any provider.");
         process.exit(1);
     }
     // Score and rank
@@ -57,6 +61,7 @@ export async function recommendCommand(opts) {
         console.log(JSON.stringify(output, null, 2));
         return;
     }
+    /* v8 ignore start */
     // Display results
     if (recommended.length > 0) {
         console.log();
@@ -86,11 +91,14 @@ export async function recommendCommand(opts) {
     }
     console.log();
     p.outro(`Install: ${chalk.cyan("arcana install <skill>")}`);
+    /* v8 ignore stop */
 }
+/* v8 ignore start */
 function printVerdict(v) {
     const scoreStr = v.score > 0 ? `+${v.score}` : String(v.score);
     console.log(`    ${chalk.bold(v.skill.padEnd(28))} ${chalk.cyan(scoreStr.padStart(4))}  ${chalk.dim(v.reasons.join(" | "))}`);
 }
+/* v8 ignore stop */
 function formatVerdict(v) {
     return { skill: v.skill, score: v.score, reasons: v.reasons };
 }

package/dist/commands/remember.d.ts

@@ -0,0 +1,12 @@
+export declare function rememberCommand(content: string[], opts: {
+    tag?: string[];
+    json?: boolean;
+}): Promise<void>;
+export declare function recallCommand(query: string[], opts: {
+    all?: boolean;
+    project?: string;
+    json?: boolean;
+}): Promise<void>;
+export declare function forgetCommand(id: string, opts: {
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/remember.js

@@ -0,0 +1,111 @@
+import { basename } from "node:path";
+import { addMemory, searchMemories, listMemories, removeMemory } from "../utils/memory.js";
+import { ui, banner } from "../utils/ui.js";
+export async function rememberCommand(content, opts) {
+    const text = content.join(" ").trim();
+    if (!text) {
+        if (opts.json) {
+            console.log(JSON.stringify({ error: "Provide content to remember" }));
+            process.exit(1);
+        }
+        /* v8 ignore next 2 */
+        console.error('Usage: arcana remember "your fact or preference"');
+        process.exit(1);
+    }
+    const memory = addMemory(text, { tags: opts.tag, project: basename(process.cwd()) });
+    if (opts.json) {
+        console.log(JSON.stringify(memory));
+        return;
+    }
+    /* v8 ignore start */
+    banner();
+    console.log(ui.bold("  Remember\n"));
+    console.log(`  ${ui.success("[OK]")} Saved: "${text}"`);
+    console.log(ui.dim(`       ID: ${memory.id} | Tags: ${memory.tags.join(", ")} | Project: ${memory.project}`));
+    console.log();
+    /* v8 ignore stop */
+}
+export async function recallCommand(query, opts) {
+    if (opts.all) {
+        const memories = listMemories({ project: opts.project });
+        if (opts.json) {
+            console.log(JSON.stringify(memories));
+            return;
+        }
+        /* v8 ignore start */
+        banner();
+        console.log(ui.bold("  Recall\n"));
+        if (memories.length === 0) {
+            console.log(ui.dim('  No memories stored. Use: arcana remember "your fact"'));
+        }
+        else {
+            for (const m of memories) {
+                console.log(`  ${ui.success(m.id)} ${m.content}`);
+                console.log(ui.dim(`       Tags: ${m.tags.join(", ")} | Project: ${m.project ?? "global"} | ${m.created.slice(0, 10)}`));
+            }
+            console.log();
+            console.log(ui.dim(`  ${memories.length} memories total`));
+        }
+        console.log();
+        return;
+        /* v8 ignore stop */
+    }
+    const q = query.join(" ").trim();
+    if (!q) {
+        if (opts.json) {
+            console.log(JSON.stringify({ error: "Provide a search query or use --all" }));
+            process.exit(1);
+        }
+        /* v8 ignore next 2 */
+        console.error('Usage: arcana recall "search query" or arcana recall --all');
+        process.exit(1);
+    }
+    const results = searchMemories(q, { project: opts.project });
+    if (opts.json) {
+        console.log(JSON.stringify(results));
+        return;
+    }
+    /* v8 ignore start */
+    banner();
+    console.log(ui.bold("  Recall\n"));
+    if (results.length === 0) {
+        console.log(ui.dim(`  No memories matching "${q}"`));
+    }
+    else {
+        for (const m of results) {
+            console.log(`  ${ui.success(m.id)} ${m.content}`);
+            console.log(ui.dim(`       Tags: ${m.tags.join(", ")} | Project: ${m.project ?? "global"} | ${m.created.slice(0, 10)}`));
+        }
+        console.log();
+        console.log(ui.dim(`  ${results.length} result${results.length > 1 ? "s" : ""}`));
+    }
+    console.log();
+    /* v8 ignore stop */
+}
+export async function forgetCommand(id, opts) {
+    if (!id) {
+        if (opts.json) {
+            console.log(JSON.stringify({ error: "Provide a memory ID to forget" }));
+            process.exit(1);
+        }
+        /* v8 ignore next 2 */
+        console.error("Usage: arcana forget <id>");
+        process.exit(1);
+    }
+    const removed = removeMemory(id);
+    if (opts.json) {
+        console.log(JSON.stringify({ removed, id }));
+        return;
+    }
+    /* v8 ignore start */
+    banner();
+    console.log(ui.bold("  Forget\n"));
+    if (removed) {
+        console.log(`  ${ui.success("[OK]")} Memory ${id} removed`);
+    }
+    else {
+        console.log(`  ${ui.warn("[!!]")} Memory ${id} not found`);
+    }
+    console.log();
+    /* v8 ignore stop */
+}

package/dist/commands/scan.d.ts

@@ -1,4 +1,6 @@
 export declare function scanCommand(skill: string | undefined, opts: {
     all?: boolean;
     json?: boolean;
+    strict?: boolean;
+    verbose?: boolean;
 }): Promise<void>;