@warpgogol/forge 0.3.1

package/dist/os/compass/handlers/compass-audit-handler.js

@@ -0,0 +1,238 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Compass audit command handlers (plan, record, baseline, validate).
+Moved from @warpgogol/site-kernel-checks to @warpgogol/forge for full autonomous
+mode (RFC-0556). Drives per-file semantic-truth auditing on a revision cadence (RFC-0352).</purpose>
+<non-goals>
+  <item>Do not perform semantic comparison inside a command — commands are deterministic; the code-vs-prose judgment is the agent's.</item>
+  <item>Do not call an LLM or read any API key.</item>
+  <item>Do not replace compass.validate — this adds a heavy truth audit on top.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0352: initial implementation of compass.audit.plan, compass.audit.record, compass.audit.baseline, compass.audit.validate.</item>
+  <item>RFC-0556: moved from @warpgogol/site-kernel-checks to @warpgogol/forge for autonomous mode.</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile } from "node:fs/promises";
+import { resolve, relative } from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { createCompassInventoryEntries } from "./compass-inventory.js";
+import { resolveCompassScanRoot } from "./resolve-scan-root.js";
+import { getRevisionByPath } from "./git-revision.js";
+import { writeFileAtomic } from "../../../src/utils/fs-atomic.js";
+import { buildGeneratedHeader } from "../../../src/utils/generated-marker.js";
+import { parse as yamlParse, stringify as yamlStringify } from "yaml";
+const execFileAsync = promisify(execFile);
+const LEDGER_PATH = "docs/compass-audit-ledger.generated.yaml";
+const DEFAULT_THRESHOLD = 30;
+function resolveRevisionThreshold(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const parsed = typeof value === "number" ? value : Number(String(value));
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
+}
+export function isAuditDue(current, audited, threshold) {
+    if (audited === null)
+        return true;
+    return current - audited >= threshold;
+}
+const LEDGER_ADVISORY = { ownerCommand: "compass.audit.record" };
+function withLedgerAdvisory(ledger) {
+    return {
+        revisionThreshold: ledger.revisionThreshold ?? DEFAULT_THRESHOLD,
+        entries: Array.isArray(ledger.entries) ? ledger.entries : [],
+    };
+}
+async function loadLedger(workspaceRoot) {
+    const abs = resolve(workspaceRoot, LEDGER_PATH);
+    try {
+        const content = await readFile(abs, "utf8");
+        return withLedgerAdvisory(yamlParse(content));
+    }
+    catch {
+        return withLedgerAdvisory({});
+    }
+}
+async function saveLedger(workspaceRoot, ledger) {
+    const normalized = withLedgerAdvisory(ledger);
+    normalized.entries.sort((a, b) => a.path.localeCompare(b.path));
+    const abs = resolve(workspaceRoot, LEDGER_PATH);
+    const header = buildGeneratedHeader({
+        ownerCommand: "compass.audit.record",
+        filePath: LEDGER_PATH,
+    });
+    const yaml = header + yamlStringify(normalized) + "\n";
+    await writeFileAtomic(abs, yaml);
+}
+function extractBlock(source, tagName) {
+    const match = source.match(new RegExp(`<${tagName}>[\\s\\S]*?<\\/${tagName}>`));
+    return match?.[0] ?? "";
+}
+async function getGitUser(workspaceRoot) {
+    try {
+        const { stdout } = await execFileAsync("git", ["config", "user.name"], {
+            cwd: workspaceRoot,
+        });
+        return `human:${stdout.trim()}`;
+    }
+    catch {
+        return "human:unknown";
+    }
+}
+function getAuthoredEntries(entries) {
+    return entries.filter((e) => e.authoringStatus === "authored" && e.requiredScaffolding !== "none");
+}
+export async function runCompassAuditPlan(input, context) {
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const entries = await createCompassInventoryEntries(context.workspaceRoot, input, scanRoot);
+    const authored = getAuthoredEntries(entries);
+    const ledger = await loadLedger(context.workspaceRoot);
+    const threshold = resolveRevisionThreshold(input.flags["threshold"], ledger.revisionThreshold);
+    const ledgerMap = new Map();
+    for (const e of ledger.entries) {
+        ledgerMap.set(e.path, e);
+    }
+    const items = [];
+    for (const entry of authored) {
+        const ledgerEntry = ledgerMap.get(entry.path);
+        const auditedRevision = ledgerEntry?.auditedRevision ?? null;
+        const { revision: currentRevision } = await getRevisionByPath(context.workspaceRoot, entry.path);
+        if (!isAuditDue(currentRevision, auditedRevision, threshold)) {
+            continue;
+        }
+        const absPath = resolve(context.workspaceRoot, entry.path);
+        const source = await readFile(absPath, "utf8");
+        const moduleContract = extractBlock(source, "MODULE_CONTRACT");
+        const changeSummary = extractBlock(source, "CHANGE_SUMMARY");
+        items.push({
+            path: entry.path,
+            currentRevision,
+            auditedRevision,
+            reason: auditedRevision === null ? "never-audited" : "revision-threshold-crossed",
+            moduleContract,
+            changeSummary,
+        });
+    }
+    items.sort((a, b) => a.path.localeCompare(b.path));
+    context.logger.info(`[compass.audit.plan] threshold=${threshold}, due=${items.length}`);
+    return {
+        data: { threshold, dueCount: items.length, items },
+        exitCode: 0,
+        summary: `[compass.audit.plan] ${items.length} files due for audit (threshold=${threshold})`,
+    };
+}
+export async function runCompassAuditRecord(input, context) {
+    const rawFilePath = input.flags["file"];
+    const verdict = input.flags["verdict"];
+    const agentFlag = input.flags["agent"];
+    if (!rawFilePath) {
+        context.logger.error("[compass.audit.record] --file is required");
+        return { exitCode: 1, data: { path: "", action: "recorded" } };
+    }
+    if (!verdict || !["pass", "repaired", "baseline"].includes(verdict)) {
+        context.logger.error("[compass.audit.record] --verdict must be pass|repaired|baseline");
+        return { exitCode: 1, data: { path: rawFilePath, action: "recorded" } };
+    }
+    const filePath = relative(context.workspaceRoot, resolve(process.cwd(), rawFilePath));
+    const { revision, entityId, contentHash } = await getRevisionByPath(context.workspaceRoot, filePath);
+    const agent = agentFlag ?? (await getGitUser(context.workspaceRoot));
+    const ledger = await loadLedger(context.workspaceRoot);
+    const existingIdx = ledger.entries.findIndex((e) => e.path === filePath);
+    const entry = {
+        path: filePath,
+        entityId: entityId ?? "",
+        auditedRevision: revision,
+        auditedHash: contentHash,
+        auditedAt: new Date().toISOString(),
+        verdict,
+        agent,
+    };
+    if (existingIdx >= 0) {
+        ledger.entries[existingIdx] = entry;
+    }
+    else {
+        ledger.entries.push(entry);
+    }
+    if (!context.dryRun) {
+        await saveLedger(context.workspaceRoot, ledger);
+    }
+    context.logger.info(`[compass.audit.record] ${filePath}: verdict=${verdict}, revision=${revision}, agent=${agent}`);
+    return {
+        data: { path: filePath, action: "recorded" },
+        exitCode: 0,
+        summary: `[compass.audit.record] ${filePath}: ${verdict} at revision ${revision}`,
+    };
+}
+export async function runCompassAuditBaseline(input, context) {
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const entries = await createCompassInventoryEntries(context.workspaceRoot, input, scanRoot);
+    const authored = getAuthoredEntries(entries);
+    const ledger = await loadLedger(context.workspaceRoot);
+    const existingPaths = new Set(ledger.entries.map((e) => e.path));
+    let seededCount = 0;
+    for (const entry of authored) {
+        if (existingPaths.has(entry.path)) {
+            continue;
+        }
+        const { revision, entityId, contentHash } = await getRevisionByPath(context.workspaceRoot, entry.path);
+        ledger.entries.push({
+            path: entry.path,
+            entityId: entityId ?? "",
+            auditedRevision: revision,
+            auditedHash: contentHash,
+            auditedAt: new Date().toISOString(),
+            verdict: "baseline",
+            agent: "system:baseline",
+        });
+        seededCount++;
+    }
+    ledger.entries.sort((a, b) => a.path.localeCompare(b.path));
+    if (!context.dryRun) {
+        await saveLedger(context.workspaceRoot, ledger);
+    }
+    context.logger.info(`[compass.audit.baseline] seeded=${seededCount}, total=${ledger.entries.length}`);
+    return {
+        data: { seeded: seededCount, total: ledger.entries.length },
+        exitCode: 0,
+        summary: `[compass.audit.baseline] seeded ${seededCount} entries (total: ${ledger.entries.length})`,
+    };
+}
+export async function runCompassAuditValidate(input, context) {
+    const strict = input.flags["strict"] === true;
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const entries = await createCompassInventoryEntries(context.workspaceRoot, input, scanRoot);
+    const authored = getAuthoredEntries(entries);
+    const ledger = await loadLedger(context.workspaceRoot);
+    const ledgerMap = new Map();
+    for (const e of ledger.entries) {
+        ledgerMap.set(e.path, e);
+    }
+    const diagnostics = [];
+    for (const entry of authored) {
+        const ledgerEntry = ledgerMap.get(entry.path);
+        const auditedRevision = ledgerEntry?.auditedRevision ?? null;
+        const { revision: currentRevision } = await getRevisionByPath(context.workspaceRoot, entry.path);
+        if (!isAuditDue(currentRevision, auditedRevision, ledger.revisionThreshold)) {
+            continue;
+        }
+        const severity = strict ? "error" : "warning";
+        context.logger[strict ? "error" : "warn"](`[compass.audit.validate] COMPASS-AUDIT-01: ${entry.path}: audit overdue (current=${currentRevision}, audited=${auditedRevision ?? "never"}, threshold=${ledger.revisionThreshold})`);
+        diagnostics.push({
+            ruleId: "COMPASS-AUDIT-01",
+            severity,
+            file: entry.path,
+            message: `Compass audit overdue: ${currentRevision - (auditedRevision ?? 0)} revisions since last audit (threshold=${ledger.revisionThreshold})`,
+            fix: "fix: run compass.audit.plan, reconcile the blocks with the code, then compass.audit.record",
+        });
+    }
+    const dueCount = diagnostics.length;
+    const hasErrors = strict && dueCount > 0;
+    return {
+        data: { strict, dueCount, diagnostics },
+        exitCode: hasErrors ? 1 : 0,
+        summary: dueCount > 0 ? undefined : `[compass.audit.validate] OK (0 files overdue)`,
+    };
+}
+//# sourceMappingURL=compass-audit-handler.js.map

package/dist/os/compass/handlers/compass-audit-handler.js.map

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

package/dist/os/compass/handlers/compass-change-summary-handler.d.ts

@@ -0,0 +1,19 @@
+import type { Diagnostic, ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export type ChangeSummaryItemClass = "protected" | "boilerplate" | "unprotected";
+export declare function classifyChangeSummaryItem(text: string): ChangeSummaryItemClass;
+export declare function runCompassChangeSummaryValidate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    command: string;
+    status: "pass" | "fail";
+    diagnostics: Diagnostic[];
+    checkedFiles: number;
+}>>;
+export declare function runCompassSummaryTrim(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    command: string;
+    status: "ok";
+    files: Array<{
+        path: string;
+        removed: string[];
+        kept: number;
+    }>;
+}>>;
+//# sourceMappingURL=compass-change-summary-handler.d.ts.map

package/dist/os/compass/handlers/compass-change-summary-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass-change-summary-handler.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-change-summary-handler.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;AAEjF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAI9E;AAgCD,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CACH,CA0EA;AAID,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE,CAAC,CACH,CAsGA"}

package/dist/os/compass/handlers/compass-change-summary-handler.js

@@ -0,0 +1,205 @@
+/*
+<MODULE_CONTRACT>
+<purpose>CHANGE_SUMMARY classification, validation, and deterministic tidy logic
+per RFC-0349. Moved from @warpgogol/site-kernel-checks to @warpgogol/forge for full
+autonomous mode (RFC-0556). Provides compass.changesummary.validate and compass.summary.trim.</purpose>
+<non-goals>
+  <item>Do not audit truthfulness of CHANGE_SUMMARY items against code — that is RFC-0352.</item>
+  <item>Do not delete protected (RFC/code-referencing) items under any circumstance.</item>
+  <item>Do not use an LLM — classification and tidy are purely deterministic.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0349: initial implementation of classifyChangeSummaryItem, compass.changesummary.validate, and compass.changesummary.tidy.</item>
+  <item>RFC-0538: renamed compass.changesummary.tidy to compass.summary.trim, raised cap from 3 unprotected to 30 total items, aligned validate cap to 30 total.</item>
+  <item>RFC-0556: moved from @warpgogol/site-kernel-checks to @warpgogol/forge for autonomous mode.</item>
+</CHANGE_SUMMARY>
+*/
+import { resolve } from "node:path";
+import { readFile } from "node:fs/promises";
+import { createCompassInventoryEntries } from "./compass-inventory.js";
+import { resolveCompassScanRoot } from "./resolve-scan-root.js";
+import { writeFileIfChanged } from "../../../src/utils/fs-idempotent.js";
+const PROTECTED_RE = /\b([A-Z][A-Z0-9]*-)+\d+\b/;
+const BOILERPLATE_RE = /^(Wave\s+\d|Backfill\b|Annotate Compass|Annotation revision|Initial creation|Compass scaffolding|Created as part of|Enhance .* with Compass)/i;
+export function classifyChangeSummaryItem(text) {
+    if (PROTECTED_RE.test(text))
+        return "protected";
+    if (BOILERPLATE_RE.test(text.trim()))
+        return "boilerplate";
+    return "unprotected";
+}
+function extractChangeSummaryBlock(source) {
+    const match = source.match(/<CHANGE_SUMMARY>[\s\S]*?<\/CHANGE_SUMMARY>/);
+    return match?.[0] ?? null;
+}
+function extractItems(block) {
+    const items = [];
+    const re = /<item>([\s\S]*?)<\/item>/g;
+    let m;
+    while ((m = re.exec(block)) !== null) {
+        items.push(m[1].trim());
+    }
+    return items;
+}
+function rebuildChangeSummaryBlock(items) {
+    const lines = ["<CHANGE_SUMMARY>"];
+    for (const item of items) {
+        lines.push(`  <item>${item}</item>`);
+    }
+    lines.push("</CHANGE_SUMMARY>");
+    return lines.join("\n");
+}
+function replaceChangeSummaryBlock(source, newBlock) {
+    return source.replace(/<CHANGE_SUMMARY>[\s\S]*?<\/CHANGE_SUMMARY>/, newBlock);
+}
+const MAX_TOTAL_ITEMS = 30;
+export async function runCompassChangeSummaryValidate(input, context) {
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const entries = await createCompassInventoryEntries(context.workspaceRoot, input, scanRoot);
+    const diagnostics = [];
+    let checkedFiles = 0;
+    for (const entry of entries) {
+        if (entry.authoringStatus !== "authored" || entry.requiredScaffolding === "none") {
+            continue;
+        }
+        checkedFiles++;
+        if (!entry.hasChangeSummary) {
+            continue;
+        }
+        const absPath = resolve(context.workspaceRoot, entry.path);
+        const source = await readFile(absPath, "utf8");
+        const block = extractChangeSummaryBlock(source);
+        if (!block)
+            continue;
+        const items = extractItems(block);
+        let hasBoilerplate = false;
+        let totalItems = 0;
+        for (const item of items) {
+            const cls = classifyChangeSummaryItem(item);
+            if (cls === "boilerplate") {
+                hasBoilerplate = true;
+            }
+            totalItems++;
+        }
+        if (hasBoilerplate) {
+            diagnostics.push({
+                ruleId: "COMPASS-CS-01",
+                severity: "error",
+                file: entry.path,
+                message: "CHANGE_SUMMARY contains a boilerplate item",
+                fixHint: "fix: run compass.summary.trim",
+            });
+        }
+        if (totalItems > MAX_TOTAL_ITEMS) {
+            diagnostics.push({
+                ruleId: "COMPASS-CS-02",
+                severity: "error",
+                file: entry.path,
+                message: `CHANGE_SUMMARY has ${totalItems} total items (cap is ${MAX_TOTAL_ITEMS})`,
+                fixHint: `fix: run compass.summary.trim (cap is ${MAX_TOTAL_ITEMS} total items)`,
+            });
+        }
+    }
+    const failed = diagnostics.length > 0;
+    for (const d of diagnostics) {
+        context.logger.error(`[compass.changesummary.validate] ${d.ruleId}: ${d.file}: ${d.message}`);
+    }
+    return {
+        data: {
+            command: "compass.changesummary.validate",
+            status: failed ? "fail" : "pass",
+            diagnostics,
+            checkedFiles,
+        },
+        exitCode: failed ? 1 : 0,
+        summary: failed
+            ? undefined
+            : `[compass.changesummary.validate] OK (${checkedFiles} authored files checked)`,
+    };
+}
+const TRIM_FALLBACK_ITEM = "Tidied by compass.summary.trim; see git history for prior entries.";
+export async function runCompassSummaryTrim(input, context) {
+    if (context.dryRun) {
+        context.logger.info(`[compass.summary.trim] dry-run active — will not apply changes`);
+    }
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const entries = await createCompassInventoryEntries(context.workspaceRoot, input, scanRoot);
+    const results = [];
+    for (const entry of entries) {
+        if (entry.authoringStatus !== "authored" || entry.requiredScaffolding === "none") {
+            continue;
+        }
+        if (!entry.hasChangeSummary) {
+            continue;
+        }
+        const absPath = resolve(context.workspaceRoot, entry.path);
+        const source = await readFile(absPath, "utf8");
+        const block = extractChangeSummaryBlock(source);
+        if (!block)
+            continue;
+        const items = extractItems(block);
+        const keptItems = [];
+        const removedItems = [];
+        const unprotectedItems = [];
+        for (let i = 0; i < items.length; i++) {
+            const text = items[i];
+            const cls = classifyChangeSummaryItem(text);
+            if (cls === "protected") {
+                keptItems.push(text);
+            }
+            else if (cls === "boilerplate") {
+                removedItems.push(text);
+            }
+            else {
+                unprotectedItems.push({ index: i, text });
+            }
+        }
+        const protectedCount = keptItems.length;
+        const maxUnprotectedToKeep = Math.max(0, MAX_TOTAL_ITEMS - protectedCount);
+        const unprotectedToKeep = unprotectedItems.slice(-maxUnprotectedToKeep);
+        const unprotectedToRemove = unprotectedItems.slice(0, -maxUnprotectedToKeep);
+        for (const item of unprotectedToRemove) {
+            removedItems.push(item.text);
+        }
+        const keepSet = new Set();
+        for (const item of unprotectedToKeep) {
+            keepSet.add(item.text);
+        }
+        const finalItems = [];
+        const protectedTexts = new Set(keptItems);
+        const unprotectedTexts = new Set(unprotectedToKeep.map((u) => u.text));
+        for (const originalItem of items) {
+            if (protectedTexts.has(originalItem) || unprotectedTexts.has(originalItem)) {
+                finalItems.push(originalItem);
+            }
+        }
+        if (finalItems.length === 0) {
+            finalItems.push(TRIM_FALLBACK_ITEM);
+        }
+        const newBlock = rebuildChangeSummaryBlock(finalItems);
+        const transformed = replaceChangeSummaryBlock(source, newBlock);
+        if (transformed === source) {
+            continue;
+        }
+        if (!context.dryRun) {
+            await writeFileIfChanged(absPath, transformed);
+        }
+        context.logger.info(`[compass.summary.trim] trimmed: ${entry.path} (removed ${removedItems.length}, kept ${finalItems.length})`);
+        results.push({
+            path: entry.path,
+            removed: removedItems,
+            kept: finalItems.length,
+        });
+    }
+    return {
+        data: {
+            command: "compass.summary.trim",
+            status: "ok",
+            files: results,
+        },
+        exitCode: 0,
+        summary: `[compass.summary.trim] files=${results.length}, removed=${results.reduce((sum, r) => sum + r.removed.length, 0)}`,
+    };
+}
+//# sourceMappingURL=compass-change-summary-handler.js.map

package/dist/os/compass/handlers/compass-change-summary-handler.js.map

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

package/dist/os/compass/handlers/compass-inventory-handler.d.ts

@@ -0,0 +1,28 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+interface CompassInventorySummary {
+    scannedFiles: number;
+    authoredFiles: number;
+    excludedFiles: number;
+    standardRequiredFiles: number;
+    compliantFiles: number;
+    nonCompliantFiles: number;
+}
+export declare function runCompassInventory(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    entries: number;
+    outputPath: string;
+    summary: CompassInventorySummary;
+}>>;
+export declare function runCompassValidation(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    checkedFiles: number;
+    failures: number;
+    summary: CompassInventorySummary;
+    diagnostics: Array<{
+        ruleId: string;
+        severity: string;
+        file: string;
+        message: string;
+        fix: string;
+    }>;
+}>>;
+export {};
+//# sourceMappingURL=compass-inventory-handler.d.ts.map

package/dist/os/compass/handlers/compass-inventory-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass-inventory-handler.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-inventory-handler.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAI/B,UAAU,uBAAuB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAgHD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,uBAAuB,CAAA;CAAE,CAAC,CAC9F,CA2BA;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,uBAAuB,CAAC;IACjC,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;CACJ,CAAC,CACH,CA6FA"}