@warpgogol/forge 2.1.0 → 2.3.0

package/dist/os/core/handlers/determinism-check.js

@@ -0,0 +1,289 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.determinism.check — verify artifact determinism by building twice and comparing output hashes. Profile-driven via determinism.inputs glob patterns.</purpose>
+<non-goals>
+  <item>Do not implement build or validate logic — those are separate handlers.</item>
+  <item>Do not import from @warpgogol/* in autonomous modules — os/core/ may import from @warpgogol/*.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0678: initial forge.determinism.check handler with profile resolution, --dry-run, --artifact, cache, and double-build hash comparison.</item>
+</CHANGE_SUMMARY>
+*/
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join, relative, dirname } from "node:path";
+import { createHash } from "node:crypto";
+import { loadWorkspaceDeps } from "./workspace-deps.js";
+import { resolveActiveProfile, resolveLifecycleFlags } from "./profile-resolve.js";
+const execAsync = promisify(exec);
+function globToRegex(pattern) {
+    let regex = "";
+    let i = 0;
+    while (i < pattern.length) {
+        const char = pattern[i];
+        if (char === "*") {
+            if (pattern[i + 1] === "*") {
+                regex += ".*";
+                i += 2;
+                if (pattern[i] === "/")
+                    i++;
+            }
+            else {
+                regex += "[^/]*";
+                i++;
+            }
+        }
+        else if (char === "?") {
+            regex += "[^/]";
+            i++;
+        }
+        else if (".+^${}()|[]\\".includes(char)) {
+            regex += "\\" + char;
+            i++;
+        }
+        else {
+            regex += char;
+            i++;
+        }
+    }
+    return new RegExp("^" + regex + "$");
+}
+function matchesGlob(filePath, patterns) {
+    return patterns.some((pattern) => globToRegex(pattern).test(filePath));
+}
+async function computeInputHash(workspaceRoot, inputPatterns) {
+    const { collectFiles, byteHashFile } = await loadWorkspaceDeps();
+    const allFiles = await collectFiles(workspaceRoot, {
+        ignore: (name) => name.startsWith("-") ||
+            name.startsWith("old-") ||
+            name === "node_modules" ||
+            name === "dist" ||
+            name === ".turbo" ||
+            name === ".cache" ||
+            name === ".git",
+    });
+    const matched = allFiles
+        .map((abs) => relative(workspaceRoot, abs))
+        .filter((rel) => matchesGlob(rel, inputPatterns))
+        .sort();
+    const hasher = createHash("sha256");
+    for (const relPath of matched) {
+        const absPath = join(workspaceRoot, relPath);
+        const fileHash = await byteHashFile(absPath);
+        hasher.update(relPath + "\0" + fileHash + "\0");
+    }
+    return `sha256:${hasher.digest("hex")}`;
+}
+async function readCache(cachePath) {
+    try {
+        const content = await readFile(cachePath, "utf8");
+        return JSON.parse(content);
+    }
+    catch {
+        return { entries: {} };
+    }
+}
+async function writeCache(cachePath, cache) {
+    const dir = dirname(cachePath);
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+    await writeFile(cachePath, JSON.stringify(cache, null, 2) + "\n", "utf8");
+}
+export async function runDeterminismCheck(input, context) {
+    const { workspaceRoot, logger } = context;
+    const { dryRun, profileIdOverride } = resolveLifecycleFlags(input, context);
+    const artifactFilter = typeof input.flags["artifact"] === "string" ? input.flags["artifact"] : undefined;
+    const resolved = resolveActiveProfile(workspaceRoot, context.forgeRoot, profileIdOverride);
+    if (!resolved) {
+        return {
+            data: {
+                command: "forge.determinism.check",
+                profileId: "",
+                artifacts: [],
+                allDeterministic: false,
+            },
+            exitCode: 1,
+            summary: "No active profile found. Set `profile` in forge.yaml or use --profile <id>.",
+            nextSteps: [{ action: "Set profile in forge.yaml or use --profile <id>", kind: "required" }],
+        };
+    }
+    const { profile } = resolved;
+    if (!profile.artifacts || profile.artifacts.length === 0) {
+        return {
+            data: {
+                command: "forge.determinism.check",
+                profileId: profile.id,
+                artifacts: [],
+                allDeterministic: false,
+            },
+            exitCode: 1,
+            summary: `Profile ${profile.id} does not declare any artifacts.`,
+            nextSteps: [{ action: `Add artifacts section to profile ${profile.id}`, kind: "required" }],
+        };
+    }
+    if (artifactFilter) {
+        const found = profile.artifacts.find((a) => a.id === artifactFilter);
+        if (!found) {
+            return {
+                data: {
+                    command: "forge.determinism.check",
+                    profileId: profile.id,
+                    artifacts: [],
+                    allDeterministic: false,
+                },
+                exitCode: 1,
+                summary: `Artifact ${artifactFilter} not declared in profile ${profile.id}.`,
+                nextSteps: [{ action: `Check artifacts in profile ${profile.id}`, kind: "required" }],
+            };
+        }
+    }
+    const artifactsToCheck = artifactFilter
+        ? profile.artifacts.filter((a) => a.id === artifactFilter)
+        : profile.artifacts;
+    const hashableArtifacts = artifactsToCheck.filter((a) => a.determinism?.hashable === true);
+    if (hashableArtifacts.length === 0) {
+        return {
+            data: {
+                command: "forge.determinism.check",
+                profileId: profile.id,
+                artifacts: [],
+                allDeterministic: true,
+            },
+            exitCode: 0,
+            summary: `Profile ${profile.id} has no hashable artifacts — nothing to check.`,
+        };
+    }
+    if (dryRun) {
+        const items = hashableArtifacts.map((a) => ({
+            artifactId: a.id,
+            inputs: a.determinism.inputs,
+        }));
+        logger.info(`[dry-run] forge.determinism.check — profile: ${profile.id}`);
+        for (const item of items) {
+            logger.info(`  ${item.artifactId}: inputs=${item.inputs.join(", ")}`);
+        }
+        return {
+            data: {
+                command: "forge.determinism.check",
+                profileId: profile.id,
+                artifacts: items.map((item) => ({
+                    artifactId: item.artifactId,
+                    hashable: true,
+                    inputs: item.inputs,
+                    inputHash: "",
+                    firstBuildHash: null,
+                    secondBuildHash: null,
+                    deterministic: true,
+                    cached: false,
+                })),
+                allDeterministic: true,
+            },
+            summary: `[dry-run] ${items.length} hashable artifact(s) resolved`,
+        };
+    }
+    const cachePath = join(workspaceRoot, "dist", ".determinism-cache.json");
+    const cache = await readCache(cachePath);
+    const results = [];
+    for (const artifact of hashableArtifacts) {
+        const determinism = artifact.determinism;
+        const produceCommand = artifact.produce?.command ?? "";
+        const outputPath = artifact.produce?.output ?? "";
+        if (!produceCommand || !outputPath) {
+            results.push({
+                artifactId: artifact.id,
+                hashable: true,
+                inputs: determinism.inputs,
+                inputHash: "",
+                firstBuildHash: null,
+                secondBuildHash: null,
+                deterministic: false,
+                cached: false,
+                error: "Artifact has no produce.command or produce.output — cannot verify determinism",
+            });
+            logger.error(`  ${artifact.id}: no produce command or output`);
+            continue;
+        }
+        const inputHash = await computeInputHash(workspaceRoot, determinism.inputs);
+        const cacheKey = `${artifact.id}:${inputHash}:${produceCommand}`;
+        const cachedEntry = cache.entries[cacheKey];
+        if (cachedEntry) {
+            results.push({
+                artifactId: artifact.id,
+                hashable: true,
+                inputs: determinism.inputs,
+                inputHash,
+                firstBuildHash: cachedEntry.outputHash,
+                secondBuildHash: cachedEntry.outputHash,
+                deterministic: cachedEntry.deterministic,
+                cached: true,
+            });
+            logger.success(`  ${artifact.id}: cached (deterministic=${cachedEntry.deterministic})`);
+            continue;
+        }
+        const absOutputPath = join(workspaceRoot, outputPath);
+        try {
+            const { byteHashFile } = await loadWorkspaceDeps();
+            await execAsync(produceCommand, { cwd: workspaceRoot, timeout: 60_000 });
+            const firstHash = await byteHashFile(absOutputPath);
+            await execAsync(produceCommand, { cwd: workspaceRoot, timeout: 60_000 });
+            const secondHash = await byteHashFile(absOutputPath);
+            const deterministic = firstHash === secondHash;
+            results.push({
+                artifactId: artifact.id,
+                hashable: true,
+                inputs: determinism.inputs,
+                inputHash,
+                firstBuildHash: firstHash,
+                secondBuildHash: secondHash,
+                deterministic,
+                cached: false,
+            });
+            cache.entries[cacheKey] = {
+                inputHash,
+                produceCommand,
+                outputHash: firstHash,
+                deterministic,
+            };
+            if (deterministic) {
+                logger.success(`  ${artifact.id}: deterministic`);
+            }
+            else {
+                logger.error(`  ${artifact.id}: NON-DETERMINISTIC (hashes differ)`);
+            }
+        }
+        catch (err) {
+            const e = err;
+            results.push({
+                artifactId: artifact.id,
+                hashable: true,
+                inputs: determinism.inputs,
+                inputHash,
+                firstBuildHash: null,
+                secondBuildHash: null,
+                deterministic: false,
+                cached: false,
+                error: e.stderr ?? e.message,
+            });
+            logger.error(`  ${artifact.id}: build failed (${e.message})`);
+        }
+    }
+    await writeCache(cachePath, cache);
+    const allDeterministic = results.every((r) => r.deterministic);
+    return {
+        data: {
+            command: "forge.determinism.check",
+            profileId: profile.id,
+            artifacts: results,
+            allDeterministic,
+        },
+        exitCode: allDeterministic ? 0 : 1,
+        summary: allDeterministic
+            ? `forge.determinism.check: all ${results.length} artifact(s) deterministic`
+            : `forge.determinism.check: ${results.filter((r) => !r.deterministic).length} artifact(s) non-deterministic`,
+    };
+}
+//# sourceMappingURL=determinism-check.js.map

package/dist/os/core/handlers/determinism-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"determinism-check.js","sourceRoot":"","sources":["../../../../os/core/handlers/determinism-check.ts"],"names":[],"mappings":"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"}

package/dist/os/core/handlers/dev.d.ts

@@ -0,0 +1,10 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export interface ForgeDevResult {
+    command: "forge.dev";
+    profileId: string;
+    devServerCommand: string;
+    port?: number;
+    exitCode: number;
+}
+export declare function runDev(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<ForgeDevResult>>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/os/core/handlers/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../../os/core/handlers/dev.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,MAAM,CAC1B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,CA8F7C"}

package/dist/os/core/handlers/dev.js

@@ -0,0 +1,102 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.dev — start the dev/preview server declared in the active stack profile. Supports --dry-run to print the resolved command without executing.</purpose>
+<non-goals>
+  <item>Do not implement build or validate logic — those are separate handlers.</item>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0674: initial forge.dev handler with profile resolution, --dry-run, and SIGINT handling.</item>
+</CHANGE_SUMMARY>
+*/
+import { spawn } from "node:child_process";
+import { resolveActiveProfile, resolveLifecycleFlags } from "./profile-resolve.js";
+export async function runDev(input, context) {
+    const { workspaceRoot, logger } = context;
+    const { dryRun, profileIdOverride } = resolveLifecycleFlags(input, context);
+    const resolved = resolveActiveProfile(workspaceRoot, context.forgeRoot, profileIdOverride);
+    if (!resolved) {
+        return {
+            data: {
+                command: "forge.dev",
+                profileId: "",
+                devServerCommand: "",
+                exitCode: 1,
+            },
+            exitCode: 1,
+            summary: "No active profile found. Set `profile` in forge.yaml or use --profile <id>.",
+            nextSteps: [{ action: "Set profile in forge.yaml or use --profile <id>", kind: "required" }],
+        };
+    }
+    const { profile } = resolved;
+    if (!profile.devServer) {
+        return {
+            data: {
+                command: "forge.dev",
+                profileId: profile.id,
+                devServerCommand: "",
+                exitCode: 1,
+            },
+            exitCode: 1,
+            summary: `Profile ${profile.id} does not declare a devServer.`,
+            nextSteps: [{ action: `Add devServer section to profile ${profile.id}`, kind: "required" }],
+        };
+    }
+    const { command, port } = profile.devServer;
+    if (dryRun) {
+        logger.info(`[dry-run] forge.dev — profile: ${profile.id}`);
+        logger.info(`  command: ${command}`);
+        if (port)
+            logger.info(`  port: ${port}`);
+        return {
+            data: {
+                command: "forge.dev",
+                profileId: profile.id,
+                devServerCommand: command,
+                port,
+                exitCode: 0,
+            },
+            summary: `[dry-run] ${command}`,
+        };
+    }
+    return new Promise((resolve) => {
+        const child = spawn(command, {
+            shell: true,
+            stdio: "inherit",
+            cwd: workspaceRoot,
+        });
+        const onSigint = () => {
+            child.kill("SIGINT");
+        };
+        process.once("SIGINT", onSigint);
+        child.on("close", (code) => {
+            process.removeListener("SIGINT", onSigint);
+            resolve({
+                data: {
+                    command: "forge.dev",
+                    profileId: profile.id,
+                    devServerCommand: command,
+                    port,
+                    exitCode: code ?? 0,
+                },
+                summary: `forge.dev exited with code ${code ?? 0}`,
+            });
+        });
+        child.on("error", (err) => {
+            process.removeListener("SIGINT", onSigint);
+            resolve({
+                data: {
+                    command: "forge.dev",
+                    profileId: profile.id,
+                    devServerCommand: command,
+                    port,
+                    exitCode: 1,
+                },
+                exitCode: 1,
+                summary: `forge.dev failed: ${err.message}`,
+            });
+        });
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/os/core/handlers/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../../../os/core/handlers/dev.ts"],"names":[],"mappings":"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"}

package/dist/os/core/handlers/knowledge-compact.d.ts

@@ -0,0 +1,4 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+import { type CompactReport } from "../../../src/knowledge/compact.ts";
+export declare function runKnowledgeCompact(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<CompactReport>>;
+//# sourceMappingURL=knowledge-compact.d.ts.map

package/dist/os/core/handlers/knowledge-compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-compact.d.ts","sourceRoot":"","sources":["../../../../os/core/handlers/knowledge-compact.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,mCAAmC,CAAC;AA2E3C,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CA4I5C"}

package/dist/os/core/handlers/knowledge-compact.js

@@ -0,0 +1,198 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Command handler for forge.skill.knowledge.compact — wraps pure compaction functions in the kernel command contract (RFC-0662).</purpose>
+<non-goals>
+  <item>Do not implement planning logic — that lives in src/knowledge/compact.ts.</item>
+  <item>Do not import from @warpgogol/* — os/core may use dynamic imports but this handler stays forge-internal.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0662: initial knowledge compaction command handler.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { FORGE_SKILLS, discoverPackSkills } from "../../../src/registry.js";
+import { loadForgeConfig } from "../../../src/config/forge-config.js";
+import { resolveForgeRoot } from "../../../src/config/forge-config.js";
+import { planCompaction, executeCompaction, resolveRetentionDays, resolveStaleDays, } from "../../../src/knowledge/compact.js";
+import { parseKnowledgeFile } from "../../../src/knowledge/parse.js";
+function discoverSkillKnowledgeFiles(workspaceRoot, skillName, all) {
+    const result = [];
+    const config = loadForgeConfig(workspaceRoot);
+    // Resolve forge root
+    let forgeRoot;
+    try {
+        forgeRoot = resolveForgeRoot(workspaceRoot);
+    }
+    catch {
+        return result;
+    }
+    // Collect forge skills. skill.path is relative to forgeRoot and already
+    // includes the "skills/" prefix (see init.ts / skill-validate.ts).
+    for (const skill of FORGE_SKILLS) {
+        if (skillName && skill.name !== skillName)
+            continue;
+        if (!skill.knowledge || skill.knowledge.length === 0)
+            continue;
+        const skillDir = path.dirname(path.join(forgeRoot, skill.path));
+        const files = skill.knowledge
+            .map((f) => path.join(skillDir, f))
+            .filter((f) => {
+            try {
+                return fs.existsSync(f);
+            }
+            catch {
+                return false;
+            }
+        });
+        if (files.length > 0) {
+            result.push({ skill: skill.name, files });
+        }
+    }
+    // Collect pack skills if --all or if --skill matches a pack skill
+    if (all || (skillName && !result.some((r) => r.skill === skillName))) {
+        const packSkills = discoverPackSkills(workspaceRoot, config);
+        for (const skill of packSkills) {
+            if (skillName && skill.name !== skillName)
+                continue;
+            if (!skill.knowledge || skill.knowledge.length === 0)
+                continue;
+            const packDir = path.resolve(workspaceRoot, skill.dir);
+            const skillDir = path.dirname(path.join(packDir, skill.path));
+            const files = skill.knowledge
+                .map((f) => path.join(skillDir, f))
+                .filter((f) => {
+                try {
+                    return fs.existsSync(f);
+                }
+                catch {
+                    return false;
+                }
+            });
+            if (files.length > 0) {
+                result.push({ skill: skill.name, files });
+            }
+        }
+    }
+    return result;
+}
+export async function runKnowledgeCompact(input, context) {
+    const { flags } = input;
+    const skillName = typeof flags["skill"] === "string" ? flags["skill"] : undefined;
+    // --all is consumed by the site-kernel CLI (consumeCommonFlags) before the
+    // command runs, so the command-level switch is --all-skills.
+    const all = flags["all-skills"] === true;
+    const dryRun = context.dryRun || flags["dry-run"] === true;
+    const json = flags["json"] === true;
+    // Validate exactly one of --skill / --all
+    if (!skillName && !all) {
+        return {
+            data: {
+                command: "forge.skill.knowledge.compact",
+                status: "fail",
+                dryRun,
+                files: [],
+                totals: { archived: 0, markedStale: 0, legacyFiles: 0 },
+                errors: ["Exactly one of --skill <name> or --all-skills is required."],
+            },
+            exitCode: 1,
+            summary: "Error: --skill or --all-skills is required.",
+        };
+    }
+    if (skillName && all) {
+        return {
+            data: {
+                command: "forge.skill.knowledge.compact",
+                status: "fail",
+                dryRun,
+                files: [],
+                totals: { archived: 0, markedStale: 0, legacyFiles: 0 },
+                errors: ["--skill and --all-skills are mutually exclusive."],
+            },
+            exitCode: 1,
+            summary: "Error: --skill and --all-skills are mutually exclusive.",
+        };
+    }
+    // Resolve retention and stale days
+    const flagRetention = typeof flags["retention-days"] === "string" ? Number(flags["retention-days"]) : undefined;
+    const flagStale = typeof flags["stale-days"] === "string" ? Number(flags["stale-days"]) : undefined;
+    const retentionDays = flagRetention !== undefined && flagRetention > 0 && Number.isInteger(flagRetention)
+        ? flagRetention
+        : resolveRetentionDays(context.workspaceRoot);
+    const staleDays = flagStale !== undefined && flagStale > 0 && Number.isInteger(flagStale)
+        ? flagStale
+        : resolveStaleDays(context.workspaceRoot);
+    // Discover target skills and their knowledge files
+    const skillFiles = discoverSkillKnowledgeFiles(context.workspaceRoot, skillName, all);
+    if (skillFiles.length === 0) {
+        const summary = skillName
+            ? `Skill "${skillName}" has no knowledge files to compact.`
+            : "No skills with knowledge files found.";
+        return {
+            data: {
+                command: "forge.skill.knowledge.compact",
+                status: "pass",
+                dryRun,
+                files: [],
+                totals: { archived: 0, markedStale: 0, legacyFiles: 0 },
+            },
+            exitCode: 0,
+            summary,
+        };
+    }
+    // Parse all knowledge files
+    const today = new Date().toISOString().slice(0, 10);
+    const allParsed = [];
+    const fileToSkill = new Map();
+    for (const { skill, files } of skillFiles) {
+        for (const file of files) {
+            const parsed = parseKnowledgeFile(file);
+            allParsed.push(parsed);
+            fileToSkill.set(file, skill);
+        }
+    }
+    // Plan compaction
+    const plans = planCompaction(allParsed, { retentionDays, staleDays, today });
+    // Execute compaction
+    const report = executeCompaction(plans, dryRun);
+    // Group by skill for output
+    const skillsOutput = skillFiles.map(({ skill, files }) => {
+        const skillFileResults = report.files.filter((r) => files.includes(r.file));
+        return {
+            skill,
+            files: skillFileResults.map((r) => ({
+                file: path.basename(r.file),
+                actions: r.actions,
+                legacySectionCount: r.legacySectionCount,
+            })),
+        };
+    });
+    const groupedReport = {
+        ...report,
+        skills: skillsOutput,
+    };
+    const exitCode = report.status === "pass" ? 0 : 1;
+    const summary = dryRun
+        ? `[dry-run] forge.skill.knowledge.compact: ${report.totals.archived} would archive, ${report.totals.markedStale} would mark stale, ${report.totals.legacyFiles} legacy file(s)`
+        : `forge.skill.knowledge.compact: ${report.totals.archived} archived, ${report.totals.markedStale} marked stale, ${report.totals.legacyFiles} legacy file(s)`;
+    if (context.outputFormat === "pretty" && !json) {
+        context.logger.section("Knowledge Compaction");
+        for (const skill of skillsOutput) {
+            context.logger.info(`Skill: ${skill.skill}`);
+            for (const file of skill.files) {
+                context.logger.info(`  ${file.file}: ${file.actions.length} action(s), ${file.legacySectionCount} legacy section(s)`);
+                for (const action of file.actions) {
+                    context.logger.info(`    ${action.kind}: ${action.entryId} — ${action.reason}`);
+                }
+            }
+        }
+        context.logger.info(`Totals: ${report.totals.archived} archived, ${report.totals.markedStale} marked stale, ${report.totals.legacyFiles} legacy file(s)`);
+    }
+    return {
+        data: groupedReport,
+        exitCode,
+        summary,
+    };
+}
+//# sourceMappingURL=knowledge-compact.js.map

package/dist/os/core/handlers/knowledge-compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-compact.js","sourceRoot":"","sources":["../../../../os/core/handlers/knowledge-compact.ts"],"names":[],"mappings":"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"}