@sporesec/arcana 3.0.3 → 4.0.0

package/dist/commands/clean.js

@@ -28,17 +28,80 @@ function isAgentLog(filename) {
     return filename.startsWith("agent-") && filename.endsWith(".jsonl");
 }
 export async function cleanCommand(opts) {
+    // --trim: session bloat trimming (large tool results, base64)
+    if (opts.trim) {
+        const { findLatestSession } = await import("../utils/sessions.js");
+        const { analyzeSession, trimSession } = await import("../session/trim.js");
+        const sessionPath = findLatestSession(process.cwd());
+        if (!sessionPath) {
+            if (opts.json) {
+                console.log(JSON.stringify({ error: "No session found" }));
+                return;
+            }
+            /* v8 ignore start */
+            console.log(`${ui.warn("[!!]")} No session found for current project.`);
+            return;
+            /* v8 ignore stop */
+        }
+        if (opts.dryRun) {
+            const analysis = analyzeSession(sessionPath);
+            if (opts.json) {
+                console.log(JSON.stringify(analysis));
+                return;
+            }
+            /* v8 ignore start */
+            banner();
+            console.log(ui.bold("  Trim Analysis (dry run)\n"));
+            console.log(`  Original: ${(analysis.originalBytes / 1024).toFixed(0)} KB (${analysis.originalLines} lines)`);
+            console.log(`  Would trim: ${(analysis.savedBytes / 1024).toFixed(0)} KB (${analysis.savedPct}%)`);
+            console.log(`  Tool results > 500 chars: ${analysis.toolResultsTrimmed}`);
+            console.log(`  Base64 images: ${analysis.base64Removed}`);
+            console.log();
+            return;
+            /* v8 ignore stop */
+        }
+        const trimmed = trimSession(sessionPath);
+        if (!trimmed) {
+            if (opts.json) {
+                console.log(JSON.stringify({ error: "Trim failed" }));
+                return;
+            }
+            /* v8 ignore start */
+            console.log(`${ui.warn("[!!]")} Trim failed.`);
+            return;
+            /* v8 ignore stop */
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ ...trimmed.result, destPath: trimmed.destPath }));
+            return;
+        }
+        /* v8 ignore start */
+        banner();
+        console.log(ui.bold("  Session Trim\n"));
+        console.log(`  ${ui.success("[OK]")} Saved ${(trimmed.result.savedBytes / 1024).toFixed(0)} KB (${trimmed.result.savedPct}%)`);
+        console.log(`  Tool results trimmed: ${trimmed.result.toolResultsTrimmed}`);
+        console.log(`  Base64 removed: ${trimmed.result.base64Removed}`);
+        console.log(ui.dim(`  Trimmed copy: ${trimmed.destPath}`));
+        console.log(ui.dim("  Original session unchanged."));
+        console.log();
+        return;
+        /* v8 ignore stop */
+    }
+    /* v8 ignore start */
     if (!opts.json)
         banner();
+    /* v8 ignore stop */
     const dryRun = opts.dryRun ?? false;
     const aggressive = opts.aggressive ?? false;
     const keepDays = opts.keepDays ?? MAIN_LOG_MAX_AGE_DAYS;
     const agentKeepDays = aggressive ? 0 : AGENT_LOG_MAX_AGE_DAYS;
     const mainKeepDays = aggressive ? 0 : keepDays;
+    /* v8 ignore start */
     if (dryRun && !opts.json)
         console.log(ui.warn("  DRY RUN - no files will be deleted\n"));
     if (aggressive && !opts.json)
         console.log(ui.warn("  AGGRESSIVE MODE - all session logs will be targeted\n"));
+    /* v8 ignore stop */
     const result = {
         dryRun,
         actions: 0,
@@ -51,6 +114,7 @@ export async function cleanCommand(opts) {
     };
     // 1. Clean broken symlinks
     const failedSymlinks = [];
+    /* v8 ignore next */
     if (!opts.json)
         console.log(ui.bold("  Symlinks"));
     for (const link of listSymlinks().filter((s) => s.broken)) {
@@ -59,20 +123,24 @@ export async function cleanCommand(opts) {
                 rmSync(link.fullPath);
             }
             catch (err) {
+                /* v8 ignore next 4 */
                 if (!opts.json)
                     console.log(`  ${ui.warn("  Could not remove:")} ${link.name} ${ui.dim(`(${err instanceof Error ? err.message : "unknown"})`)}`);
                 failedSymlinks.push(link.name);
                 continue;
             }
         }
+        /* v8 ignore next */
         if (!opts.json)
             console.log(`  ${ui.dim("  Remove broken:")} ${link.name}`);
         result.removedSymlinks.push(link.name);
         result.actions++;
     }
+    /* v8 ignore next */
     if (result.removedSymlinks.length === 0 && !opts.json)
         console.log(ui.dim("    No broken symlinks"));
     // 2. Clean orphaned + stale project dirs
+    /* v8 ignore next */
     if (!opts.json)
         console.log(ui.bold("\n  Project Data"));
     const projectsDir = join(homedir(), ".claude", "projects");
@@ -104,6 +172,7 @@ export async function cleanCommand(opts) {
                 const reason = orphaned ? "orphaned (source deleted)" : `stale (${Math.floor(daysOld)}d old)`;
                 if (!dryRun)
                     rmSync(projDir, { recursive: true, force: true });
+                /* v8 ignore next */
                 if (!opts.json)
                     console.log(`    ${ui.dim("Remove:")} ${entry} ${ui.dim(`(${mb} MB, ${reason})`)}`);
                 result.removedProjects.push({ name: entry, sizeMB: mb, reason });
@@ -111,18 +180,21 @@ export async function cleanCommand(opts) {
             }
         }
     }
+    /* v8 ignore next */
     if (result.removedProjects.length === 0 && !opts.json)
         console.log(ui.dim("    No orphaned or stale projects"));
     // 3. Tiered session log cleanup
     // - Agent logs (agent-*.jsonl): delete after 7 days (never resumed, bulk of bloat)
     // - Main sessions (UUID.jsonl): delete after 30 days (configurable with --keep-days)
     // - Aggressive mode: delete everything regardless of age
+    /* v8 ignore start */
     if (!opts.json) {
         console.log(ui.bold("\n  Session Logs"));
         if (!aggressive) {
             console.log(ui.dim(`    Agent logs: remove >${agentKeepDays}d | Main sessions: remove >${mainKeepDays}d`));
         }
     }
+    /* v8 ignore stop */
     let logCount = 0;
     if (existsSync(projectsDir)) {
         const now = Date.now();
@@ -159,6 +231,7 @@ export async function cleanCommand(opts) {
                         }
                     }
                     const reason = isAgent ? "agent log" : "main session";
+                    /* v8 ignore next 4 */
                     if (!opts.json)
                         console.log(`    ${ui.dim("Remove:")} ${entry}/${file} ${ui.dim(`(${sizeMB.toFixed(1)} MB, ${Math.floor(daysOld)}d, ${reason})`)}`);
                     result.removedSessionLogs.push({
@@ -191,6 +264,7 @@ export async function cleanCommand(opts) {
                         if (!dryRun)
                             rmSync(subPath, { recursive: true, force: true });
                         const mb = (size / (1024 * 1024)).toFixed(1);
+                        /* v8 ignore next 4 */
                         if (!opts.json)
                             console.log(`    ${ui.dim("Remove:")} ${entry}/${sub}/ ${ui.dim(`(${mb} MB, ${Math.floor(daysOld)}d, session dir)`)}`);
                         result.removedSessionLogs.push({
@@ -210,9 +284,11 @@ export async function cleanCommand(opts) {
             }
         }
     }
+    /* v8 ignore next */
     if (logCount === 0 && !opts.json)
         console.log(ui.dim("    No session logs to trim"));
     // 4. Purge auxiliary directories
+    /* v8 ignore next */
     if (!opts.json)
         console.log(ui.bold("\n  Auxiliary Data"));
     const claudeDir = join(homedir(), ".claude");
@@ -226,11 +302,13 @@ export async function cleanCommand(opts) {
         const mb = (size / (1024 * 1024)).toFixed(1);
         const reclaimed = dryRun ? size : purgeDir(dir, false);
         result.reclaimedBytes += reclaimed;
+        /* v8 ignore next */
         if (!opts.json)
             console.log(`    ${ui.dim("Purge:")} ${dirName}/ ${ui.dim(`(${mb} MB)`)}`);
         result.purgedDirs.push({ name: dirName, sizeMB: mb });
         result.actions++;
     }
+    /* v8 ignore next */
     if (result.purgedDirs.length === 0 && !opts.json)
         console.log(ui.dim("    All clean"));
     // 5. Clear action history
@@ -263,6 +341,7 @@ export async function cleanCommand(opts) {
         }, null, 2));
         return;
     }
+    /* v8 ignore start */
     console.log();
     const mb = (result.reclaimedBytes / (1024 * 1024)).toFixed(1);
     const verb = dryRun ? "Would reclaim" : "Reclaimed";
@@ -273,4 +352,5 @@ export async function cleanCommand(opts) {
         console.log(ui.success("  Nothing to clean."));
     }
     console.log();
+    /* v8 ignore stop */
 }

package/dist/commands/compress.d.ts

@@ -0,0 +1,5 @@
+export declare function compressCommand(command: string[], opts: {
+    stdin?: boolean;
+    tool?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/compress.js

@@ -0,0 +1,38 @@
+import { compress, compressionStats, recordCompression } from "../compress/index.js";
+export async function compressCommand(command, opts) {
+    let input;
+    if (opts.stdin) {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        input = Buffer.concat(chunks).toString("utf-8");
+    }
+    else if (command.length > 0) {
+        const { execSync } = await import("node:child_process");
+        try {
+            input = execSync(command.join(" "), {
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"],
+                maxBuffer: 10 * 1024 * 1024,
+            });
+        }
+        catch (err) {
+            input = err.stdout ?? "" + (err.stderr ?? "");
+        }
+    }
+    else {
+        console.error("Usage: arcana compress <command> or echo ... | arcana compress --stdin --tool git");
+        process.exit(1);
+        return;
+    }
+    const tool = opts.tool ?? command[0] ?? "unknown";
+    const compressed = compress(input, tool);
+    const stats = compressionStats(input, compressed);
+    recordCompression(tool, stats.originalTokens, stats.compressedTokens);
+    if (opts.json) {
+        console.log(JSON.stringify(stats));
+    }
+    else {
+        process.stdout.write(compressed);
+    }
+}

package/dist/commands/config.js

@@ -6,9 +6,11 @@ import { ui, banner, table } from "../utils/ui.js";
 import { clearProviderCache } from "../registry.js";
 const VALID_KEYS = ["defaultProvider", "installDir"];
 export async function configCommand(action, value, opts) {
+    /* v8 ignore start */
     if (!opts?.json) {
         banner();
     }
+    /* v8 ignore stop */
     // arcana config list (or no args)
     if (!action || action === "list") {
         const config = loadConfig();
@@ -16,6 +18,7 @@ export async function configCommand(action, value, opts) {
             console.log(JSON.stringify({ config }));
             return;
         }
+        /* v8 ignore start */
         console.log(ui.bold("  Configuration\n"));
         const envInstallDir = process.env.ARCANA_INSTALL_DIR;
         const envProvider = process.env.ARCANA_DEFAULT_PROVIDER;
@@ -37,22 +40,26 @@ export async function configCommand(action, value, opts) {
         console.log(ui.dim(`  ${existsSync(configPath) ? "Custom config" : "Using defaults"}`));
         console.log();
         return;
+        /* v8 ignore stop */
     }
     // arcana config path
     if (action === "path") {
+        /* v8 ignore start */
         if (value && !opts?.json) {
             console.log(ui.warn(`  'path' does not take a value (ignoring "${value}")`));
         }
+        /* v8 ignore stop */
         const configPath = join(homedir(), ".arcana", "config.json");
         if (opts?.json) {
             console.log(JSON.stringify({ path: configPath, exists: existsSync(configPath) }));
+            return;
         }
-        else {
-            console.log(`  ${configPath}`);
-            console.log(ui.dim(`  ${existsSync(configPath) ? "Custom config" : "Using defaults (file does not exist)"}`));
-            console.log();
-        }
+        /* v8 ignore start */
+        console.log(`  ${configPath}`);
+        console.log(ui.dim(`  ${existsSync(configPath) ? "Custom config" : "Using defaults (file does not exist)"}`));
+        console.log();
         return;
+        /* v8 ignore stop */
     }
     // arcana config reset
     if (action === "reset") {
@@ -69,35 +76,38 @@ export async function configCommand(action, value, opts) {
                         success: false,
                         error: err instanceof Error ? err.message : "Failed to remove config",
                     }));
+                    process.exit(1);
                 }
-                else {
-                    console.log(ui.error(`  Failed to reset config: ${err instanceof Error ? err.message : "unknown error"}`));
-                    console.log();
-                }
+                /* v8 ignore start */
+                console.log(ui.error(`  Failed to reset config: ${err instanceof Error ? err.message : "unknown error"}`));
+                console.log();
                 process.exit(1);
+                /* v8 ignore stop */
             }
             clearProviderCache();
         }
         if (opts?.json) {
             console.log(JSON.stringify({ action: "reset", success: true, existed }));
+            return;
         }
-        else {
-            console.log(existed ? ui.success("  Config reset to defaults") : ui.dim("  Already using defaults"));
-            console.log();
-        }
+        /* v8 ignore start */
+        console.log(existed ? ui.success("  Config reset to defaults") : ui.dim("  Already using defaults"));
+        console.log();
         return;
+        /* v8 ignore stop */
     }
     // arcana config <key> [value]
     if (!VALID_KEYS.includes(action)) {
         if (opts?.json) {
             console.log(JSON.stringify({ error: `Unknown config key: ${action}`, validKeys: [...VALID_KEYS] }));
+            process.exit(1);
         }
-        else {
-            console.log(ui.error(`  Unknown config key: ${action}`));
-            console.log(ui.dim(`  Valid keys: ${VALID_KEYS.join(", ")}`));
-            console.log();
-        }
+        /* v8 ignore start */
+        console.log(ui.error(`  Unknown config key: ${action}`));
+        console.log(ui.dim(`  Valid keys: ${VALID_KEYS.join(", ")}`));
+        console.log();
         process.exit(1);
+        /* v8 ignore stop */
     }
     const config = loadConfig();
     const key = action;
@@ -105,14 +115,16 @@ export async function configCommand(action, value, opts) {
         // Get value
         if (opts?.json) {
             console.log(JSON.stringify({ action: "get", key, value: config[key] }));
+            return;
         }
-        else {
-            console.log(`  ${key} = ${config[key]}`);
-            console.log();
-        }
+        /* v8 ignore start */
+        console.log(`  ${key} = ${config[key]}`);
+        console.log();
         return;
+        /* v8 ignore stop */
     }
     // Set value
+    /* v8 ignore start */
     if (key === "installDir") {
         if (value === "") {
             console.log(ui.error("  installDir cannot be empty"));
@@ -132,13 +144,15 @@ export async function configCommand(action, value, opts) {
             process.exit(1);
         }
     }
+    /* v8 ignore stop */
     config[key] = value;
     saveConfig(config);
     if (opts?.json) {
         console.log(JSON.stringify({ action: "set", key, value }));
+        return;
     }
-    else {
-        console.log(ui.success(`  Set ${key} = ${value}`));
-        console.log();
-    }
+    /* v8 ignore start */
+    console.log(ui.success(`  Set ${key} = ${value}`));
+    console.log();
+    /* v8 ignore stop */
 }

package/dist/commands/create.js

@@ -43,6 +43,7 @@ const good = "example";
 See \`references/\` for detailed documentation.
 `;
 }
+/* v8 ignore start */
 export async function createCommand(name) {
     console.log(renderBanner());
     console.log();
@@ -98,3 +99,4 @@ export async function createCommand(name) {
     p.log.info("Edit SKILL.md to add your skill instructions.");
     p.outro(`Next: ${chalk.cyan("arcana validate " + name)}`);
 }
+/* v8 ignore stop */

package/dist/commands/curate.d.ts

@@ -0,0 +1,39 @@
+export interface CuratedSkill {
+    name: string;
+    score: number;
+    tokens: number;
+    reasons: string[];
+}
+export interface CurationResult {
+    selected: CuratedSkill[];
+    skipped: {
+        name: string;
+        reason: string;
+    }[];
+    totalTokens: number;
+    budgetTokens: number;
+    budgetPct: number;
+}
+/**
+ * Curate skills for context: rank by relevance, greedily fill token budget.
+ * Uses existing rankSkills() from scoring.ts and readSkillContent() from load.ts.
+ */
+export declare function curateForContext(cwd: string, opts: {
+    budgetPct?: number;
+    model?: string;
+    forceInclude?: string[];
+}): CurationResult;
+/**
+ * Generate _active.md with curated skill content.
+ * Writes to ~/.agents/skills/_active.md.
+ */
+export declare function regenerateActive(opts?: {
+    budgetPct?: number;
+    model?: string;
+}): CurationResult;
+export declare function curateCommand(opts: {
+    json?: boolean;
+    budget?: number;
+    model?: string;
+    include?: string[];
+}): Promise<void>;

package/dist/commands/curate.js

@@ -0,0 +1,222 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { getInstallDir } from "../utils/fs.js";
+import { atomicWriteSync } from "../utils/atomic.js";
+import { detectProjectContext } from "../utils/project-context.js";
+import { rankSkills } from "../utils/scoring.js";
+import { readSkillContent } from "./load.js";
+import { ACTIVE_FILENAME, CONTEXT_BUDGET_PCT, MODEL_CONTEXTS, TOKENS_PER_KB } from "../constants.js";
+import { recordCuration } from "../utils/usage.js";
+import { ui, banner } from "../utils/ui.js";
+import { getInstalledNames } from "../interactive/helpers.js";
+/** Resolve model context window size. */
+function resolveModelContext(model) {
+    if (!model)
+        return MODEL_CONTEXTS["default"];
+    // Try exact match first, then prefix match
+    if (MODEL_CONTEXTS[model] !== undefined)
+        return MODEL_CONTEXTS[model];
+    const key = Object.keys(MODEL_CONTEXTS).find((k) => model.startsWith(k));
+    return key ? MODEL_CONTEXTS[key] : MODEL_CONTEXTS["default"];
+}
+/** Estimate token count from byte size. */
+function estimateTokens(bytes) {
+    return Math.round((bytes / 1024) * TOKENS_PER_KB);
+}
+/**
+ * Curate skills for context: rank by relevance, greedily fill token budget.
+ * Uses existing rankSkills() from scoring.ts and readSkillContent() from load.ts.
+ */
+export function curateForContext(cwd, opts) {
+    const context = detectProjectContext(cwd);
+    const installedNames = getInstalledNames();
+    if (installedNames.length === 0) {
+        return { selected: [], skipped: [], totalTokens: 0, budgetTokens: 0, budgetPct: 0 };
+    }
+    // Build SkillInfo stubs for ranking (only installed skills)
+    const skillInfos = installedNames.map((name) => ({
+        name,
+        description: "",
+        version: "0.0.0",
+        source: "local",
+        tags: context.tags.length > 0 ? [...context.tags] : undefined,
+    }));
+    // Get marketplace data for better scoring if available
+    const ranked = rankSkills(skillInfos, context);
+    const modelContext = resolveModelContext(opts.model);
+    const budgetPct = opts.budgetPct ?? CONTEXT_BUDGET_PCT;
+    const budgetTokens = Math.floor((modelContext * budgetPct) / 100);
+    const selected = [];
+    const skipped = [];
+    let totalTokens = 0;
+    // Force-included skills go first
+    const forceInclude = opts.forceInclude ?? [];
+    for (const name of forceInclude) {
+        if (!installedNames.includes(name))
+            continue;
+        const content = readSkillContent(name);
+        if (!content)
+            continue;
+        const tokens = estimateTokens(content.bytes);
+        if (totalTokens + tokens > budgetTokens) {
+            skipped.push({ name, reason: `Force-included but exceeds budget (${tokens} tokens)` });
+            continue;
+        }
+        totalTokens += tokens;
+        selected.push({ name, score: 999, tokens, reasons: ["Force-included"] });
+    }
+    // Fill remaining budget with ranked skills
+    for (const verdict of ranked) {
+        if (verdict.verdict === "skip" || verdict.verdict === "conflict")
+            continue;
+        if (selected.some((s) => s.name === verdict.skill))
+            continue; // already force-included
+        if (!installedNames.includes(verdict.skill))
+            continue;
+        const content = readSkillContent(verdict.skill);
+        if (!content) {
+            skipped.push({ name: verdict.skill, reason: "Content unreadable" });
+            continue;
+        }
+        const tokens = estimateTokens(content.bytes);
+        if (totalTokens + tokens > budgetTokens) {
+            skipped.push({ name: verdict.skill, reason: `Over budget (+${tokens} tokens)` });
+            continue;
+        }
+        totalTokens += tokens;
+        selected.push({
+            name: verdict.skill,
+            score: verdict.score,
+            tokens,
+            reasons: verdict.reasons,
+        });
+    }
+    return { selected, skipped, totalTokens, budgetTokens, budgetPct };
+}
+/**
+ * Generate _active.md with curated skill content.
+ * Writes to ~/.agents/skills/_active.md.
+ */
+export function regenerateActive(opts) {
+    const result = curateForContext(process.cwd(), opts ?? {});
+    const installDir = getInstallDir();
+    if (!existsSync(installDir))
+        mkdirSync(installDir, { recursive: true });
+    const parts = [];
+    parts.push(`# Active Skills (${result.selected.length})`);
+    parts.push("");
+    parts.push(`Budget: ${result.totalTokens.toLocaleString()} / ${result.budgetTokens.toLocaleString()} tokens (${result.budgetPct}% of context)`);
+    parts.push(`Curated for project at: ${process.cwd()}`);
+    parts.push(`Generated: ${new Date().toISOString()}`);
+    parts.push("");
+    parts.push("---");
+    parts.push("");
+    for (const skill of result.selected) {
+        const content = readSkillContent(skill.name);
+        if (!content)
+            continue;
+        parts.push(content.content);
+        parts.push("");
+        parts.push("---");
+        parts.push("");
+    }
+    const activePath = join(installDir, ACTIVE_FILENAME);
+    atomicWriteSync(activePath, parts.join("\n"), 0o644);
+    // Record usage for each curated skill
+    for (const skill of result.selected) {
+        try {
+            recordCuration(skill.name);
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    return result;
+}
+export async function curateCommand(opts) {
+    /* v8 ignore start */
+    if (!opts.json) {
+        banner();
+        console.log(ui.bold("  Context Curation\n"));
+    }
+    /* v8 ignore stop */
+    const result = curateForContext(process.cwd(), {
+        budgetPct: opts.budget,
+        model: opts.model,
+        forceInclude: opts.include,
+    });
+    if (result.selected.length === 0 && getInstalledNames().length === 0) {
+        if (opts.json) {
+            console.log(JSON.stringify({ error: "No skills installed" }));
+        }
+        else {
+            /* v8 ignore next */
+            console.log(ui.dim("  No skills installed. Run: arcana install --all"));
+        }
+        /* v8 ignore next */
+        console.log();
+        return;
+    }
+    // Write _active.md
+    const installDir = getInstallDir();
+    if (!existsSync(installDir))
+        mkdirSync(installDir, { recursive: true });
+    const parts = [];
+    parts.push(`# Active Skills (${result.selected.length})`);
+    parts.push("");
+    parts.push(`Budget: ${result.totalTokens.toLocaleString()} / ${result.budgetTokens.toLocaleString()} tokens (${result.budgetPct}% of context)`);
+    parts.push(`Curated for project at: ${process.cwd()}`);
+    parts.push(`Generated: ${new Date().toISOString()}`);
+    parts.push("");
+    parts.push("---");
+    parts.push("");
+    for (const skill of result.selected) {
+        const content = readSkillContent(skill.name);
+        if (!content)
+            continue;
+        parts.push(content.content);
+        parts.push("");
+        parts.push("---");
+        parts.push("");
+    }
+    const activePath = join(installDir, ACTIVE_FILENAME);
+    atomicWriteSync(activePath, parts.join("\n"), 0o644);
+    if (opts.json) {
+        console.log(JSON.stringify({
+            selected: result.selected,
+            skipped: result.skipped,
+            totalTokens: result.totalTokens,
+            budgetTokens: result.budgetTokens,
+            path: activePath,
+        }));
+        return;
+    }
+    /* v8 ignore start */
+    // Display results
+    const budgetBar = Math.round((result.totalTokens / result.budgetTokens) * 20);
+    const bar = ui.success("█".repeat(budgetBar)) + ui.dim("░".repeat(20 - budgetBar));
+    console.log(`  ${bar} ${result.totalTokens.toLocaleString()} / ${result.budgetTokens.toLocaleString()} tokens`);
+    console.log();
+    for (const skill of result.selected) {
+        const pct = Math.round((skill.tokens / result.budgetTokens) * 100);
+        console.log(`  ${ui.success("[OK]")} ${skill.name} (${skill.tokens.toLocaleString()} tokens, ${pct}%)`);
+        if (skill.reasons.length > 0) {
+            console.log(ui.dim(`       ${skill.reasons.join(", ")}`));
+        }
+    }
+    if (result.skipped.length > 0) {
+        console.log();
+        console.log(ui.dim("  Skipped:"));
+        for (const skip of result.skipped.slice(0, 5)) {
+            console.log(ui.dim(`    ${skip.name}: ${skip.reason}`));
+        }
+        if (result.skipped.length > 5) {
+            console.log(ui.dim(`    ...and ${result.skipped.length - 5} more`));
+        }
+    }
+    console.log();
+    console.log(ui.dim(`  Written to: ${activePath}`));
+    console.log(ui.dim("  Agents read this file automatically for project-relevant skills."));
+    console.log();
+    /* v8 ignore stop */
+}

package/dist/commands/diff.js

@@ -136,6 +136,7 @@ export async function diffCommand(skill, opts) {
         console.log(JSON.stringify(result, null, 2));
         return;
     }
+    /* v8 ignore start */
     // Console output
     console.log(`Diff: ${skill}`);
     console.log(`  Local version:  ${localVersion}`);
@@ -163,4 +164,5 @@ export async function diffCommand(skill, opts) {
             console.log(`    ~ ${entry.path}  (+${entry.linesAdded} / -${entry.linesRemoved})`);
         }
     }
+    /* v8 ignore stop */
 }

package/dist/commands/doctor.d.ts

@@ -2,4 +2,5 @@ import type { DoctorCheck } from "../types.js";
 export declare function runDoctorChecks(): DoctorCheck[];
 export declare function doctorCommand(opts?: {
     json?: boolean;
+    fix?: boolean;
 }): Promise<void>;