@sporesec/arcana 2.4.0 → 3.0.0

package/dist/commands/compact.js

@@ -3,6 +3,7 @@ import { join } from "node:path";
 import { homedir } from "node:os";
 import { ui, banner } from "../utils/ui.js";
 import { getDirSize } from "../utils/fs.js";
+import { PRUNE_DEFAULT_DAYS, PRUNE_SIZE_THRESHOLD_BYTES, PRUNE_KEEP_NEWEST } from "../constants.js";
 function analyzeProject(projDir, projName) {
     const now = Date.now();
     const mainFiles = [];
@@ -40,12 +41,11 @@ function analyzeProject(projDir, projName) {
             continue;
         }
     }
-    const totalBytes = mainFiles.reduce((s, f) => s + f.sizeBytes, 0)
-        + agentFiles.reduce((s, f) => s + f.sizeBytes, 0)
-        + sessionDirs.reduce((s, d) => s + d.sizeBytes, 0);
+    const totalBytes = mainFiles.reduce((s, f) => s + f.sizeBytes, 0) +
+        agentFiles.reduce((s, f) => s + f.sizeBytes, 0) +
+        sessionDirs.reduce((s, d) => s + d.sizeBytes, 0);
     // Reclaimable: all agent files + all session dirs
-    const reclaimableBytes = agentFiles.reduce((s, f) => s + f.sizeBytes, 0)
-        + sessionDirs.reduce((s, d) => s + d.sizeBytes, 0);
+    const reclaimableBytes = agentFiles.reduce((s, f) => s + f.sizeBytes, 0) + sessionDirs.reduce((s, d) => s + d.sizeBytes, 0);
     return { name: projName, mainFiles, agentFiles, sessionDirs, totalBytes, reclaimableBytes };
 }
 function formatBytes(bytes) {
@@ -57,6 +57,39 @@ function formatBytes(bytes) {
         return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
     return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
 }
+/**
+ * Prune oversized main session files.
+ * Targets files older than pruneDays AND larger than 10 MB.
+ * Always keeps the 3 newest sessions per project regardless.
+ */
+function pruneMainSessions(analyses, projectsDir, pruneDays, dryRun, json) {
+    const pruned = [];
+    let reclaimedBytes = 0;
+    for (const a of analyses) {
+        // Sort main files by age (newest first) to protect the 3 newest
+        const sorted = [...a.mainFiles].sort((x, y) => x.daysOld - y.daysOld);
+        const candidates = sorted.slice(PRUNE_KEEP_NEWEST); // Skip the 3 newest
+        for (const f of candidates) {
+            if (f.daysOld > pruneDays && f.sizeBytes > PRUNE_SIZE_THRESHOLD_BYTES) {
+                const sizeMB = (f.sizeBytes / (1024 * 1024)).toFixed(1);
+                if (!json) {
+                    console.log(`    ${ui.warn("Prune:")} ${f.name} ${ui.dim(`(${sizeMB} MB, ${f.daysOld}d old)`)}`);
+                }
+                if (!dryRun) {
+                    try {
+                        rmSync(join(projectsDir, a.name, f.name), { force: true });
+                    }
+                    catch {
+                        /* skip */
+                    }
+                }
+                pruned.push({ project: a.name, file: f.name, sizeMB, daysOld: f.daysOld });
+                reclaimedBytes += f.sizeBytes;
+            }
+        }
+    }
+    return { pruned, reclaimedBytes };
+}
 export async function compactCommand(opts) {
     if (!opts.json)
         banner();
@@ -89,7 +122,7 @@ export async function compactCommand(opts) {
     analyses.sort((a, b) => b.totalBytes - a.totalBytes);
     if (opts.json) {
         const jsonResult = {
-            projects: analyses.map(a => ({
+            projects: analyses.map((a) => ({
                 name: a.name,
                 totalBytes: a.totalBytes,
                 reclaimableBytes: a.reclaimableBytes,
@@ -99,7 +132,6 @@ export async function compactCommand(opts) {
             })),
             totalReclaimed: dryRun ? 0 : analyses.reduce((s, a) => s + a.reclaimableBytes, 0),
         };
-        console.log(JSON.stringify(jsonResult, null, 2));
         if (!dryRun) {
             for (const a of analyses) {
                 const projDir = join(projectsDir, a.name);
@@ -107,22 +139,36 @@ export async function compactCommand(opts) {
                     try {
                         rmSync(join(projDir, f.name), { force: true });
                     }
-                    catch { /* skip */ }
+                    catch {
+                        /* skip */
+                    }
                 }
                 for (const d of a.sessionDirs) {
                     try {
                         rmSync(join(projDir, d.name), { recursive: true, force: true });
                     }
-                    catch { /* skip */ }
+                    catch {
+                        /* skip */
+                    }
                 }
             }
         }
+        if (opts.prune) {
+            const pruneDays = opts.pruneDays ?? PRUNE_DEFAULT_DAYS;
+            const pruneResult = pruneMainSessions(analyses, projectsDir, pruneDays, dryRun, true);
+            jsonResult.pruned = pruneResult.pruned;
+            jsonResult.prunedBytes = pruneResult.reclaimedBytes;
+            if (!dryRun) {
+                jsonResult.totalReclaimed = jsonResult.totalReclaimed + pruneResult.reclaimedBytes;
+            }
+        }
+        console.log(JSON.stringify(jsonResult, null, 2));
         return;
     }
     if (!opts.json)
         console.log(ui.bold("  Session Compaction Report\n"));
     let totalReclaimed = 0;
-    const hasWork = analyses.some(a => a.reclaimableBytes > 0);
+    const hasWork = analyses.some((a) => a.reclaimableBytes > 0);
     for (const a of analyses) {
         if (a.totalBytes < 1024)
             continue; // Skip tiny projects
@@ -141,7 +187,9 @@ export async function compactCommand(opts) {
                     try {
                         rmSync(join(projDir, f.name), { force: true });
                     }
-                    catch { /* skip */ }
+                    catch {
+                        /* skip */
+                    }
                 }
             }
             totalReclaimed += agentSize;
@@ -157,7 +205,9 @@ export async function compactCommand(opts) {
                         try {
                             rmSync(join(projDir, d.name), { recursive: true, force: true });
                         }
-                        catch { /* skip */ }
+                        catch {
+                            /* skip */
+                        }
                     }
                 }
                 totalReclaimed += dirSize;
@@ -165,8 +215,19 @@ export async function compactCommand(opts) {
         }
         console.log();
     }
+    // Prune oversized main sessions if requested
+    if (opts.prune) {
+        const pruneDays = opts.pruneDays ?? PRUNE_DEFAULT_DAYS;
+        console.log(ui.bold(`  Pruning main sessions (>${pruneDays}d old AND >10 MB, keeping 3 newest per project)\n`));
+        const pruneResult = pruneMainSessions(analyses, projectsDir, pruneDays, dryRun, false);
+        totalReclaimed += pruneResult.reclaimedBytes;
+        if (pruneResult.pruned.length === 0) {
+            console.log(ui.dim("    No oversized sessions to prune."));
+        }
+        console.log();
+    }
     // Summary
-    if (!hasWork) {
+    if (!hasWork && !opts.prune) {
         console.log(ui.success("  Already compact. No agent logs to remove."));
     }
     else {
@@ -176,4 +237,3 @@ export async function compactCommand(opts) {
     }
     console.log();
 }
-//# sourceMappingURL=compact.js.map

package/dist/commands/completions.d.ts

@@ -0,0 +1,3 @@
+export declare function completionsCommand(shell: string, opts: {
+    json?: boolean;
+}): void;

package/dist/commands/completions.js

@@ -0,0 +1,104 @@
+const BASH_COMPLETIONS = `# arcana bash completion
+_arcana_completions() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}"
+  local commands="list install info search providers create validate update uninstall init doctor clean compact stats config audit scan optimize verify lock profile benchmark diff outdated team export import completions"
+
+  if [ "\${COMP_CWORD}" -eq 1 ]; then
+    COMPREPLY=( $(compgen -W "\${commands}" -- "\${cur}") )
+  fi
+}
+complete -F _arcana_completions arcana
+`;
+const ZSH_COMPLETIONS = `#compdef arcana
+_arcana() {
+  local -a commands
+  commands=(
+    'list:List available skills'
+    'install:Install one or more skills'
+    'info:Show skill details'
+    'search:Search for skills'
+    'providers:Manage skill providers'
+    'create:Create a new skill'
+    'validate:Validate skill structure'
+    'update:Update installed skills'
+    'uninstall:Uninstall skills'
+    'init:Initialize arcana in project'
+    'doctor:Check environment'
+    'clean:Remove orphaned data'
+    'compact:Remove agent logs'
+    'stats:Show session analytics'
+    'config:View or modify config'
+    'audit:Audit skill quality'
+    'scan:Scan for security threats'
+    'optimize:Suggest improvements'
+    'verify:Verify skill integrity'
+    'lock:Manage lockfile'
+    'profile:Manage skill profiles'
+    'benchmark:Measure token cost'
+    'diff:Show skill changes'
+    'outdated:List outdated skills'
+    'team:Team skill management'
+    'export:Export skill manifest'
+    'import:Import skills'
+    'completions:Generate shell completions'
+  )
+  _describe 'command' commands
+}
+_arcana
+`;
+const FISH_COMPLETIONS = `# arcana fish completion
+set -l commands list install info search providers create validate update uninstall init doctor clean compact stats config audit scan optimize verify lock profile benchmark diff outdated team export import completions
+complete -c arcana -f
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a list -d "List available skills"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a install -d "Install skills"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a info -d "Show skill details"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a search -d "Search for skills"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a providers -d "Manage providers"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a create -d "Create a skill"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a validate -d "Validate skills"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a update -d "Update skills"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a uninstall -d "Uninstall skills"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a init -d "Initialize arcana"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a doctor -d "Check environment"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a clean -d "Remove orphaned data"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a compact -d "Remove agent logs"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a stats -d "Session analytics"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a config -d "View/modify config"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a audit -d "Audit skill quality"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a scan -d "Security scan"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a optimize -d "Suggest improvements"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a verify -d "Verify integrity"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a lock -d "Manage lockfile"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a profile -d "Skill profiles"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a benchmark -d "Measure token cost"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a diff -d "Show skill changes"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a outdated -d "List outdated skills"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a team -d "Team management"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a export -d "Export manifest"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a import -d "Import skills"
+complete -c arcana -n "not __fish_seen_subcommand_from $commands" -a completions -d "Shell completions"
+`;
+const SHELLS = {
+    bash: BASH_COMPLETIONS,
+    zsh: ZSH_COMPLETIONS,
+    fish: FISH_COMPLETIONS,
+};
+export function completionsCommand(shell, opts) {
+    const supported = Object.keys(SHELLS);
+    if (!supported.includes(shell)) {
+        if (opts.json) {
+            console.log(JSON.stringify({ error: `Unsupported shell: ${shell}`, supported }));
+        }
+        else {
+            console.error(`Unsupported shell: ${shell}`);
+            console.error(`Supported: ${supported.join(", ")}`);
+        }
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify({ shell, script: SHELLS[shell] }));
+    }
+    else {
+        console.log(SHELLS[shell]);
+    }
+}

package/dist/commands/config.d.ts

@@ -1,4 +1,3 @@
 export declare function configCommand(action: string | undefined, value: string | undefined, opts?: {
     json?: boolean;
 }): Promise<void>;
-//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.js

@@ -20,9 +20,15 @@ export async function configCommand(action, value, opts) {
         const envInstallDir = process.env.ARCANA_INSTALL_DIR;
         const envProvider = process.env.ARCANA_DEFAULT_PROVIDER;
         const rows = [
-            [ui.dim("defaultProvider"), config.defaultProvider + (envProvider ? ` ${ui.warn("(overridden by ARCANA_DEFAULT_PROVIDER)")}` : "")],
-            [ui.dim("installDir"), config.installDir + (envInstallDir ? ` ${ui.warn("(overridden by ARCANA_INSTALL_DIR)")}` : "")],
-            [ui.dim("providers"), config.providers.map(p => p.name).join(", ")],
+            [
+                ui.dim("defaultProvider"),
+                config.defaultProvider + (envProvider ? ` ${ui.warn("(overridden by ARCANA_DEFAULT_PROVIDER)")}` : ""),
+            ],
+            [
+                ui.dim("installDir"),
+                config.installDir + (envInstallDir ? ` ${ui.warn("(overridden by ARCANA_INSTALL_DIR)")}` : ""),
+            ],
+            [ui.dim("providers"), config.providers.map((p) => p.name).join(", ")],
         ];
         table(rows);
         console.log();
@@ -58,7 +64,11 @@ export async function configCommand(action, value, opts) {
             }
             catch (err) {
                 if (opts?.json) {
-                    console.log(JSON.stringify({ action: "reset", success: false, error: err instanceof Error ? err.message : "Failed to remove config" }));
+                    console.log(JSON.stringify({
+                        action: "reset",
+                        success: false,
+                        error: err instanceof Error ? err.message : "Failed to remove config",
+                    }));
                 }
                 else {
                     console.log(ui.error(`  Failed to reset config: ${err instanceof Error ? err.message : "unknown error"}`));
@@ -115,7 +125,7 @@ export async function configCommand(action, value, opts) {
         }
     }
     if (key === "defaultProvider") {
-        const providerNames = config.providers.map(p => p.name);
+        const providerNames = config.providers.map((p) => p.name);
         if (!providerNames.includes(value)) {
             console.log(ui.error(`  Provider '${value}' not configured. Add it first with: arcana providers --add owner/repo`));
             console.log();
@@ -132,4 +142,3 @@ export async function configCommand(action, value, opts) {
         console.log();
     }
 }
-//# sourceMappingURL=config.js.map

package/dist/commands/create.d.ts

@@ -1,2 +1 @@
 export declare function createCommand(name: string): Promise<void>;
-//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.js

@@ -65,6 +65,7 @@ export async function createCommand(name) {
                 return "Description is required";
             if (val.length < 10)
                 return "Too short (minimum 10 chars)";
+            return undefined;
         },
     });
     if (p.isCancel(description)) {
@@ -97,4 +98,3 @@ export async function createCommand(name) {
     p.log.info("Edit SKILL.md to add your skill instructions.");
     p.outro(`Next: ${chalk.cyan("arcana validate " + name)}`);
 }
-//# sourceMappingURL=create.js.map

package/dist/commands/diff.d.ts

@@ -0,0 +1,4 @@
+export declare function diffCommand(skill: string, opts: {
+    provider?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/diff.js

@@ -0,0 +1,166 @@
+import { existsSync, readFileSync, readdirSync, lstatSync } from "node:fs";
+import { join } from "node:path";
+import { getInstallDir, readSkillMeta } from "../utils/fs.js";
+import { getProvider } from "../registry.js";
+import { loadConfig } from "../utils/config.js";
+import { validateSlug } from "../utils/validate.js";
+function readDirRecursive(dir) {
+    const results = [];
+    const queue = [{ fullDir: dir, relPrefix: "" }];
+    while (queue.length > 0) {
+        const { fullDir, relPrefix } = queue.pop();
+        let entries;
+        try {
+            entries = readdirSync(fullDir);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const fullPath = join(fullDir, entry);
+            try {
+                const stat = lstatSync(fullPath);
+                if (stat.isSymbolicLink())
+                    continue;
+                const relPath = relPrefix ? `${relPrefix}/${entry}` : entry;
+                if (stat.isDirectory()) {
+                    queue.push({ fullDir: fullPath, relPrefix: relPath });
+                }
+                else {
+                    results.push({
+                        path: relPath,
+                        content: readFileSync(fullPath, "utf-8"),
+                    });
+                }
+            }
+            catch {
+                // skip unreadable entries
+            }
+        }
+    }
+    return results;
+}
+function computeLineDiff(localContent, remoteContent) {
+    const localLines = localContent.split("\n");
+    const remoteLines = remoteContent.split("\n");
+    const localSet = new Set(localLines);
+    const remoteSet = new Set(remoteLines);
+    let linesAdded = 0;
+    let linesRemoved = 0;
+    for (const line of remoteLines) {
+        if (!localSet.has(line)) {
+            linesAdded++;
+        }
+    }
+    for (const line of localLines) {
+        if (!remoteSet.has(line)) {
+            linesRemoved++;
+        }
+    }
+    return { linesAdded, linesRemoved };
+}
+export async function diffCommand(skill, opts) {
+    try {
+        validateSlug(skill, "skill name");
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : "Invalid skill name");
+        process.exit(1);
+    }
+    const installDir = getInstallDir();
+    const skillDir = join(installDir, skill);
+    if (!existsSync(skillDir)) {
+        console.error(`Skill "${skill}" is not installed.`);
+        process.exit(1);
+    }
+    const providerName = opts.provider ?? loadConfig().defaultProvider;
+    const provider = getProvider(providerName);
+    let remoteFiles;
+    try {
+        remoteFiles = await provider.fetch(skill);
+    }
+    catch (err) {
+        console.error(`Failed to fetch remote skill "${skill}": ${err instanceof Error ? err.message : "unknown error"}`);
+        process.exit(1);
+    }
+    const localFiles = readDirRecursive(skillDir);
+    const meta = readSkillMeta(skill);
+    const localVersion = meta?.version ?? "0.0.0";
+    let remoteVersion = "0.0.0";
+    try {
+        const remoteInfo = await provider.info(skill);
+        if (remoteInfo) {
+            remoteVersion = remoteInfo.version;
+        }
+    }
+    catch {
+        // keep default
+    }
+    const localMap = new Map();
+    for (const file of localFiles) {
+        localMap.set(file.path, file.content);
+    }
+    const remoteMap = new Map();
+    for (const file of remoteFiles) {
+        remoteMap.set(file.path, file.content);
+    }
+    const added = [];
+    const removed = [];
+    const modified = [];
+    for (const [path] of remoteMap) {
+        if (!localMap.has(path)) {
+            added.push(path);
+        }
+    }
+    for (const [path] of localMap) {
+        if (!remoteMap.has(path)) {
+            removed.push(path);
+        }
+    }
+    for (const [path, remoteContent] of remoteMap) {
+        const localContent = localMap.get(path);
+        if (localContent !== undefined && localContent !== remoteContent) {
+            const { linesAdded, linesRemoved } = computeLineDiff(localContent, remoteContent);
+            modified.push({ path, linesAdded, linesRemoved });
+        }
+    }
+    const result = {
+        skill,
+        localVersion,
+        remoteVersion,
+        added,
+        removed,
+        modified,
+    };
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    // Console output
+    console.log(`Diff: ${skill}`);
+    console.log(`  Local version:  ${localVersion}`);
+    console.log(`  Remote version: ${remoteVersion}`);
+    console.log();
+    if (added.length === 0 && removed.length === 0 && modified.length === 0) {
+        console.log("  No differences found.");
+        return;
+    }
+    if (added.length > 0) {
+        console.log(`  Added (${added.length}):`);
+        for (const path of added) {
+            console.log(`    + ${path}`);
+        }
+    }
+    if (removed.length > 0) {
+        console.log(`  Removed (${removed.length}):`);
+        for (const path of removed) {
+            console.log(`    - ${path}`);
+        }
+    }
+    if (modified.length > 0) {
+        console.log(`  Modified (${modified.length}):`);
+        for (const entry of modified) {
+            console.log(`    ~ ${entry.path}  (+${entry.linesAdded} / -${entry.linesRemoved})`);
+        }
+    }
+}

package/dist/commands/doctor.d.ts

@@ -3,4 +3,3 @@ export declare function runDoctorChecks(): DoctorCheck[];
 export declare function doctorCommand(opts?: {
     json?: boolean;
 }): Promise<void>;
-//# sourceMappingURL=doctor.d.ts.map