@sporesec/arcana 3.0.3 → 4.0.0

package/dist/commands/compact.js

@@ -1,239 +0,0 @@
-import { existsSync, readdirSync, rmSync, statSync } from "node:fs";
-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 = [];
-    const agentFiles = [];
-    const sessionDirs = [];
-    for (const entry of readdirSync(projDir)) {
-        const full = join(projDir, entry);
-        try {
-            const stat = statSync(full);
-            if (stat.isDirectory()) {
-                if (entry === "memory")
-                    continue;
-                sessionDirs.push({
-                    name: entry,
-                    sizeBytes: getDirSize(full),
-                    daysOld: Math.floor((now - stat.mtimeMs) / (1000 * 60 * 60 * 24)),
-                });
-                continue;
-            }
-            if (!entry.endsWith(".jsonl"))
-                continue;
-            const info = {
-                name: entry,
-                sizeBytes: stat.size,
-                daysOld: Math.floor((now - stat.mtimeMs) / (1000 * 60 * 60 * 24)),
-            };
-            if (entry.startsWith("agent-")) {
-                agentFiles.push(info);
-            }
-            else {
-                mainFiles.push(info);
-            }
-        }
-        catch {
-            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);
-    // 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);
-    return { name: projName, mainFiles, agentFiles, sessionDirs, totalBytes, reclaimableBytes };
-}
-function formatBytes(bytes) {
-    if (bytes < 1024)
-        return `${bytes} B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)} KB`;
-    if (bytes < 1024 * 1024 * 1024)
-        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();
-    const dryRun = opts.dryRun ?? false;
-    if (dryRun && !opts.json)
-        console.log(ui.warn("  DRY RUN - no files will be deleted\n"));
-    const projectsDir = join(homedir(), ".claude", "projects");
-    if (!existsSync(projectsDir)) {
-        if (opts.json) {
-            console.log(JSON.stringify({ projects: [], totalReclaimed: 0 }));
-        }
-        else {
-            console.log(ui.dim("  No session data found."));
-            console.log();
-        }
-        return;
-    }
-    const analyses = [];
-    for (const entry of readdirSync(projectsDir)) {
-        const projDir = join(projectsDir, entry);
-        if (!statSync(projDir).isDirectory())
-            continue;
-        if (entry === "memory" || entry.startsWith("."))
-            continue;
-        const analysis = analyzeProject(projDir, entry);
-        if (analysis.totalBytes > 0) {
-            analyses.push(analysis);
-        }
-    }
-    analyses.sort((a, b) => b.totalBytes - a.totalBytes);
-    if (opts.json) {
-        const jsonResult = {
-            projects: analyses.map((a) => ({
-                name: a.name,
-                totalBytes: a.totalBytes,
-                reclaimableBytes: a.reclaimableBytes,
-                mainSessions: a.mainFiles.length,
-                agentLogs: a.agentFiles.length,
-                sessionDirs: a.sessionDirs.length,
-            })),
-            totalReclaimed: dryRun ? 0 : analyses.reduce((s, a) => s + a.reclaimableBytes, 0),
-        };
-        if (!dryRun) {
-            for (const a of analyses) {
-                const projDir = join(projectsDir, a.name);
-                for (const f of a.agentFiles) {
-                    try {
-                        rmSync(join(projDir, f.name), { force: true });
-                    }
-                    catch {
-                        /* skip */
-                    }
-                }
-                for (const d of a.sessionDirs) {
-                    try {
-                        rmSync(join(projDir, d.name), { recursive: true, force: true });
-                    }
-                    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);
-    for (const a of analyses) {
-        if (a.totalBytes < 1024)
-            continue; // Skip tiny projects
-        const truncName = a.name.length > 50 ? a.name.slice(0, 47) + "..." : a.name;
-        console.log(`  ${ui.bold(truncName)}  ${ui.dim(formatBytes(a.totalBytes))}`);
-        // Main sessions
-        const mainSize = a.mainFiles.reduce((s, f) => s + f.sizeBytes, 0);
-        console.log(`    ${ui.success("Keep:")} ${a.mainFiles.length} main session${a.mainFiles.length !== 1 ? "s" : ""} ${ui.dim(`(${formatBytes(mainSize)})`)}`);
-        // Agent logs
-        if (a.agentFiles.length > 0) {
-            const agentSize = a.agentFiles.reduce((s, f) => s + f.sizeBytes, 0);
-            console.log(`    ${ui.warn("Remove:")} ${a.agentFiles.length} agent log${a.agentFiles.length !== 1 ? "s" : ""} ${ui.dim(`(${formatBytes(agentSize)})`)}`);
-            if (!dryRun) {
-                const projDir = join(projectsDir, a.name);
-                for (const f of a.agentFiles) {
-                    try {
-                        rmSync(join(projDir, f.name), { force: true });
-                    }
-                    catch {
-                        /* skip */
-                    }
-                }
-            }
-            totalReclaimed += agentSize;
-        }
-        // Session dirs
-        if (a.sessionDirs.length > 0) {
-            const dirSize = a.sessionDirs.reduce((s, d) => s + d.sizeBytes, 0);
-            if (dirSize > 0) {
-                console.log(`    ${ui.warn("Remove:")} ${a.sessionDirs.length} session dir${a.sessionDirs.length !== 1 ? "s" : ""} ${ui.dim(`(${formatBytes(dirSize)})`)}`);
-                if (!dryRun) {
-                    const projDir = join(projectsDir, a.name);
-                    for (const d of a.sessionDirs) {
-                        try {
-                            rmSync(join(projDir, d.name), { recursive: true, force: true });
-                        }
-                        catch {
-                            /* skip */
-                        }
-                    }
-                }
-                totalReclaimed += dirSize;
-            }
-        }
-        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 && !opts.prune) {
-        console.log(ui.success("  Already compact. No agent logs to remove."));
-    }
-    else {
-        const verb = dryRun ? "Would reclaim" : "Reclaimed";
-        console.log(ui.success(`  ${verb} ${formatBytes(totalReclaimed)} by removing agent logs and session dirs.`));
-        console.log(ui.dim("  Main session files preserved for history."));
-    }
-    console.log();
-}

package/dist/commands/optimize.d.ts

@@ -1,3 +0,0 @@
-export declare function optimizeCommand(opts: {
-    json?: boolean;
-}): Promise<void>;

package/dist/commands/optimize.js

@@ -1,356 +0,0 @@
-import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-import { ui, banner } from "../utils/ui.js";
-import { getInstallDir, getDirSize } from "../utils/fs.js";
-function readSettings() {
-    const settingsPath = join(homedir(), ".claude", "settings.json");
-    if (!existsSync(settingsPath))
-        return null;
-    try {
-        return JSON.parse(readFileSync(settingsPath, "utf-8"));
-    }
-    catch {
-        return null;
-    }
-}
-function checkAutocompact() {
-    const settings = readSettings();
-    if (!settings) {
-        return {
-            area: "Autocompact",
-            status: "suggest",
-            message: "No settings.json found",
-            action: "Set CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=80 in ~/.claude/settings.json env block",
-        };
-    }
-    const env = settings.env;
-    const val = env?.CLAUDE_AUTOCOMPACT_PCT_OVERRIDE;
-    if (!val) {
-        return {
-            area: "Autocompact",
-            status: "suggest",
-            message: "Not configured (defaults to high threshold)",
-            action: "Set to 80 to compact earlier and save tokens",
-        };
-    }
-    const pct = parseInt(val);
-    if (pct <= 70) {
-        return {
-            area: "Autocompact",
-            status: "warn",
-            message: `Set to ${pct}%. Too aggressive, may lose context.`,
-            action: "Raise to 75-80% for better balance",
-        };
-    }
-    if (pct > 85) {
-        return {
-            area: "Autocompact",
-            status: "suggest",
-            message: `Set to ${pct}%. Compaction happens late, less room for reasoning.`,
-            action: "Lower to 80% for better quality (research-backed)",
-        };
-    }
-    return { area: "Autocompact", status: "good", message: `Set to ${pct}% (optimal range)` };
-}
-function checkEffortLevel() {
-    const settings = readSettings();
-    const env = (settings?.env ?? {});
-    const val = env.CLAUDE_CODE_EFFORT_LEVEL;
-    if (!val) {
-        return { area: "Effort level", status: "good", message: "Using default (high)" };
-    }
-    if (val === "low") {
-        return {
-            area: "Effort level",
-            status: "suggest",
-            message: "Set to 'low'. Faster but may miss details.",
-            action: "Use 'medium' for daily work, 'high' for complex tasks",
-        };
-    }
-    if (val === "medium") {
-        return { area: "Effort level", status: "good", message: "Set to 'medium'. Good balance of speed and quality." };
-    }
-    return { area: "Effort level", status: "good", message: `Set to '${val}'` };
-}
-function checkNonEssentialCalls() {
-    const settings = readSettings();
-    const env = (settings?.env ?? {});
-    const val = env.DISABLE_NON_ESSENTIAL_MODEL_CALLS;
-    if (val === "1" || val === "true") {
-        return { area: "Non-essential calls", status: "good", message: "Disabled (saves tokens)" };
-    }
-    return {
-        area: "Non-essential calls",
-        status: "suggest",
-        message: "Not disabled",
-        action: "Set DISABLE_NON_ESSENTIAL_MODEL_CALLS=1 in settings.json env to save tokens",
-    };
-}
-function checkSkillTokenBudget() {
-    const dir = getInstallDir();
-    if (!existsSync(dir)) {
-        return { area: "Skill token budget", status: "good", message: "No skills installed" };
-    }
-    let totalKB = 0;
-    let skillCount = 0;
-    const large = [];
-    for (const entry of readdirSync(dir)) {
-        const skillDir = join(dir, entry);
-        if (!statSync(skillDir).isDirectory())
-            continue;
-        skillCount++;
-        const kb = getDirSize(skillDir) / 1024;
-        totalKB += kb;
-        if (kb > 50)
-            large.push({ name: entry, kb });
-    }
-    const estTokens = Math.round(totalKB * 256);
-    if (totalKB > 500) {
-        large.sort((a, b) => b.kb - a.kb);
-        const topNames = large
-            .slice(0, 3)
-            .map((s) => s.name)
-            .join(", ");
-        return {
-            area: "Skill token budget",
-            status: "warn",
-            message: `${skillCount} skills, ${totalKB.toFixed(0)} KB (~${(estTokens / 1000).toFixed(0)}K tokens). Heavy context load.`,
-            action: `Consider uninstalling rarely used skills. Largest: ${topNames}`,
-        };
-    }
-    if (totalKB > 200) {
-        return {
-            area: "Skill token budget",
-            status: "suggest",
-            message: `${skillCount} skills, ${totalKB.toFixed(0)} KB (~${(estTokens / 1000).toFixed(0)}K tokens)`,
-            action: "Review installed skills with 'arcana list --installed' and remove unused ones",
-        };
-    }
-    return {
-        area: "Skill token budget",
-        status: "good",
-        message: `${skillCount} skills, ${totalKB.toFixed(0)} KB (~${(estTokens / 1000).toFixed(0)}K tokens)`,
-    };
-}
-function checkDiskHealth() {
-    const claudeDir = join(homedir(), ".claude");
-    if (!existsSync(claudeDir)) {
-        return { area: "Disk health", status: "good", message: "No Claude data directory" };
-    }
-    const totalMB = getDirSize(claudeDir) / (1024 * 1024);
-    if (totalMB > 1000) {
-        return {
-            area: "Disk health",
-            status: "warn",
-            message: `${totalMB.toFixed(0)} MB total Claude data`,
-            action: "Run: arcana compact (removes agent logs, keeps sessions)",
-        };
-    }
-    if (totalMB > 500) {
-        return {
-            area: "Disk health",
-            status: "suggest",
-            message: `${totalMB.toFixed(0)} MB total Claude data`,
-            action: "Run: arcana compact",
-        };
-    }
-    return { area: "Disk health", status: "good", message: `${totalMB.toFixed(0)} MB total Claude data` };
-}
-function checkPreCompactHook() {
-    // Check both global and local settings for PreCompact hooks
-    const paths = [join(homedir(), ".claude", "settings.json"), join(homedir(), ".claude", "settings.local.json")];
-    for (const settingsPath of paths) {
-        if (!existsSync(settingsPath))
-            continue;
-        try {
-            const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
-            const hooks = settings?.hooks?.PreCompact;
-            if (hooks && Array.isArray(hooks) && hooks.length > 0) {
-                return { area: "PreCompact hook", status: "good", message: "Installed. Context preserved before compaction." };
-            }
-        }
-        catch {
-            continue;
-        }
-    }
-    return {
-        area: "PreCompact hook",
-        status: "suggest",
-        message: "Not installed. Context is lost during auto-compaction.",
-        action: "Run: arcana init --tool claude (adds PreCompact hook to preserve context)",
-    };
-}
-function checkMemorySize() {
-    const projectsDir = join(homedir(), ".claude", "projects");
-    if (!existsSync(projectsDir)) {
-        return { area: "MEMORY.md sizes", status: "good", message: "No project memory files" };
-    }
-    const oversized = [];
-    for (const entry of readdirSync(projectsDir)) {
-        const memDir = join(projectsDir, entry, "memory");
-        const memFile = join(memDir, "MEMORY.md");
-        if (!existsSync(memFile))
-            continue;
-        try {
-            const content = readFileSync(memFile, "utf-8");
-            const lineCount = content.split("\n").length;
-            if (lineCount > 200) {
-                oversized.push({ project: entry, lines: lineCount });
-            }
-        }
-        catch {
-            continue;
-        }
-    }
-    if (oversized.length === 0) {
-        return { area: "MEMORY.md sizes", status: "good", message: "All under 200 lines (auto-load limit)" };
-    }
-    oversized.sort((a, b) => b.lines - a.lines);
-    const top = oversized[0];
-    return {
-        area: "MEMORY.md sizes",
-        status: "warn",
-        message: `${oversized.length} MEMORY.md file${oversized.length > 1 ? "s" : ""} exceed 200 lines. Only first 200 auto-load. Worst: ${top.project} (${top.lines} lines)`,
-        action: "Trim to 200 lines. Move detailed notes to separate topic files in memory/",
-    };
-}
-function checkAgentBloat() {
-    const projectsDir = join(homedir(), ".claude", "projects");
-    if (!existsSync(projectsDir)) {
-        return { area: "Agent log bloat", status: "good", message: "No session data" };
-    }
-    let agentBytes = 0;
-    let mainBytes = 0;
-    let agentCount = 0;
-    let mainCount = 0;
-    for (const project of readdirSync(projectsDir)) {
-        const projDir = join(projectsDir, project);
-        if (!statSync(projDir).isDirectory())
-            continue;
-        for (const file of readdirSync(projDir)) {
-            if (!file.endsWith(".jsonl"))
-                continue;
-            try {
-                const size = statSync(join(projDir, file)).size;
-                if (file.startsWith("agent-")) {
-                    agentBytes += size;
-                    agentCount++;
-                }
-                else {
-                    mainBytes += size;
-                    mainCount++;
-                }
-            }
-            catch {
-                continue;
-            }
-        }
-    }
-    const totalMB = (agentBytes + mainBytes) / (1024 * 1024);
-    const agentMB = agentBytes / (1024 * 1024);
-    const agentPct = totalMB > 0 ? Math.round((agentMB / totalMB) * 100) : 0;
-    if (agentPct > 70 && agentMB > 50) {
-        return {
-            area: "Agent log bloat",
-            status: "warn",
-            message: `${agentCount} agent logs (${agentMB.toFixed(0)} MB, ${agentPct}% of all logs). ${mainCount} main sessions (${(mainBytes / (1024 * 1024)).toFixed(0)} MB).`,
-            action: "Run: arcana compact (removes agent logs, keeps main sessions)",
-        };
-    }
-    if (agentMB > 20) {
-        return {
-            area: "Agent log bloat",
-            status: "suggest",
-            message: `${agentCount} agent logs (${agentMB.toFixed(0)} MB, ${agentPct}%). ${mainCount} main sessions.`,
-            action: "Run: arcana compact",
-        };
-    }
-    return {
-        area: "Agent log bloat",
-        status: "good",
-        message: `${agentCount} agent logs (${agentMB.toFixed(0)} MB), ${mainCount} main sessions (${(mainBytes / (1024 * 1024)).toFixed(0)} MB)`,
-    };
-}
-function checkLargestSkills() {
-    const dir = getInstallDir();
-    if (!existsSync(dir)) {
-        return { area: "Top skills by size", status: "good", message: "No skills installed" };
-    }
-    const skills = [];
-    for (const entry of readdirSync(dir)) {
-        const skillDir = join(dir, entry);
-        if (!statSync(skillDir).isDirectory())
-            continue;
-        const kb = getDirSize(skillDir) / 1024;
-        skills.push({ name: entry, kb });
-    }
-    if (skills.length === 0) {
-        return { area: "Top skills by size", status: "good", message: "No skills installed" };
-    }
-    skills.sort((a, b) => b.kb - a.kb);
-    const totalKB = skills.reduce((s, sk) => s + sk.kb, 0);
-    const totalMB = totalKB / 1024;
-    const top5 = skills
-        .slice(0, 5)
-        .map((s) => `${s.name} (${s.kb.toFixed(0)} KB)`)
-        .join(", ");
-    if (totalMB > 3) {
-        return {
-            area: "Top skills by size",
-            status: "warn",
-            message: `${skills.length} skills, ${totalMB.toFixed(1)} MB total. Top 5: ${top5}`,
-            action: "Review large skills with 'arcana list --installed'. Uninstall unused ones.",
-        };
-    }
-    if (totalMB > 1.5) {
-        return {
-            area: "Top skills by size",
-            status: "suggest",
-            message: `${skills.length} skills, ${totalMB.toFixed(1)} MB total. Top 5: ${top5}`,
-            action: "Consider removing rarely used skills to save context tokens",
-        };
-    }
-    return {
-        area: "Top skills by size",
-        status: "good",
-        message: `${skills.length} skills, ${totalMB.toFixed(1)} MB total. Top 5: ${top5}`,
-    };
-}
-export async function optimizeCommand(opts) {
-    if (!opts.json) {
-        banner();
-        console.log(ui.bold("  Claude Code Optimization Report\n"));
-    }
-    const recommendations = [
-        checkAutocompact(),
-        checkEffortLevel(),
-        checkNonEssentialCalls(),
-        checkPreCompactHook(),
-        checkSkillTokenBudget(),
-        checkMemorySize(),
-        checkAgentBloat(),
-        checkDiskHealth(),
-        checkLargestSkills(),
-    ];
-    if (opts.json) {
-        console.log(JSON.stringify({ recommendations }, null, 2));
-        return;
-    }
-    for (const rec of recommendations) {
-        const icon = rec.status === "good" ? ui.success("[OK]") : rec.status === "suggest" ? ui.cyan("[>>]") : ui.warn("[!!]");
-        console.log(`  ${icon} ${ui.bold(rec.area)}: ${rec.message}`);
-        if (rec.action) {
-            console.log(ui.dim(`      ${rec.action}`));
-        }
-    }
-    const actionable = recommendations.filter((r) => r.status !== "good");
-    console.log();
-    if (actionable.length === 0) {
-        console.log(ui.success("  Your setup is well optimized."));
-    }
-    else {
-        console.log(ui.dim(`  ${actionable.length} suggestion${actionable.length > 1 ? "s" : ""} to improve token usage and performance.`));
-    }
-    console.log();
-}

package/dist/commands/profile.d.ts

@@ -1,3 +0,0 @@
-export declare function profileCommand(action: string | undefined, name: string | undefined, skills: string[], opts: {
-    json?: boolean;
-}): Promise<void>;