@warpgogol/forge 2.1.0 → 2.2.0

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

@@ -0,0 +1,213 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Compass inventory and validation command handlers. Moved from
+@warpgogol/site-kernel-checks to @warpgogol/forge for full autonomous mode (RFC-0556).
+Provides runCompassInventory (XML report generation) and runCompassValidation
+(compliance diagnostics with COMPASS-* rules).</purpose>
+<non-goals>
+  <item>Do not handle raw file parsing or content analysis.</item>
+  <item>Do not manage configuration or orchestration of external services.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0348: v2 two-block contract — XML output updated, compass.validate emits COMPASS-* diagnostics, summary uses standard-required-files.</item>
+  <item>RFC-0350: added COMPASS-TODO-01 diagnostic for unfilled Compass TODO sentinels.</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 INVENTORY_OUTPUT_PATH = "docs/compass-inventory.xml";
+function summarizeInventory(entries) {
+    let authoredFiles = 0;
+    let excludedFiles = 0;
+    let standardRequiredFiles = 0;
+    let compliantFiles = 0;
+    let nonCompliantFiles = 0;
+    for (const entry of entries) {
+        if (entry.authoringStatus === "excluded") {
+            excludedFiles += 1;
+            continue;
+        }
+        authoredFiles += 1;
+        if (entry.requiredScaffolding === "standard")
+            standardRequiredFiles += 1;
+        if (entry.compliant) {
+            compliantFiles += 1;
+        }
+        else {
+            nonCompliantFiles += 1;
+        }
+    }
+    return {
+        scannedFiles: entries.length,
+        authoredFiles,
+        excludedFiles,
+        standardRequiredFiles,
+        compliantFiles,
+        nonCompliantFiles,
+    };
+}
+function escapeXml(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+function renderInventoryXml(entries, summary) {
+    const lines = [];
+    lines.push("<compass-inventory>");
+    lines.push("  <meta>");
+    lines.push("    <document-id>compass-inventory</document-id>");
+    lines.push("    <version>2.0.0</version>");
+    lines.push("    <status>generated</status>");
+    lines.push("    <scope>repository-root</scope>");
+    lines.push(`    <generated-at>null</generated-at>`);
+    lines.push("    <generator>@warpgogol/forge:compass.inventory</generator>");
+    lines.push("  </meta>");
+    lines.push("  <summary>");
+    lines.push(`    <scanned-files>${summary.scannedFiles}</scanned-files>`);
+    lines.push(`    <authored-files>${summary.authoredFiles}</authored-files>`);
+    lines.push(`    <excluded-files>${summary.excludedFiles}</excluded-files>`);
+    lines.push(`    <standard-required-files>${summary.standardRequiredFiles}</standard-required-files>`);
+    lines.push(`    <compliant-files>${summary.compliantFiles}</compliant-files>`);
+    lines.push(`    <non-compliant-files>${summary.nonCompliantFiles}</non-compliant-files>`);
+    lines.push("  </summary>");
+    lines.push("  <entries>");
+    for (const entry of entries) {
+        lines.push(`    <entry path="${escapeXml(entry.path)}" workspace-kind="${entry.workspaceKind}" workspace-name="${escapeXml(entry.workspaceName)}" layer="${escapeXml(entry.layer)}" extension="${escapeXml(entry.extension)}" authoring-status="${entry.authoringStatus}" risk-class="${entry.riskClass}" complexity="${entry.complexity}" required-scaffolding="${entry.requiredScaffolding}" compliant="${entry.compliant ? "true" : "false"}">`);
+        lines.push(`      <non-empty-lines>${entry.nonEmptyLineCount}</non-empty-lines>`);
+        if (entry.exclusionReason) {
+            lines.push(`      <exclusion-reason>${escapeXml(entry.exclusionReason)}</exclusion-reason>`);
+        }
+        lines.push(`      <has-module-contract>${entry.hasModuleContract ? "true" : "false"}</has-module-contract>`);
+        lines.push(`      <has-change-summary>${entry.hasChangeSummary ? "true" : "false"}</has-change-summary>`);
+        lines.push(`      <has-ai-invariant>${entry.hasAiInvariant ? "true" : "false"}</has-ai-invariant>`);
+        lines.push(`      <has-purpose>${entry.hasPurpose ? "true" : "false"}</has-purpose>`);
+        lines.push(`      <has-non-goals>${entry.hasNonGoals ? "true" : "false"}</has-non-goals>`);
+        if (entry.forbiddenPresent.length > 0) {
+            lines.push("      <forbidden-markers>");
+            for (const marker of entry.forbiddenPresent) {
+                lines.push(`        <marker>${escapeXml(marker)}</marker>`);
+            }
+            lines.push("      </forbidden-markers>");
+        }
+        if (entry.violations.length > 0) {
+            lines.push("      <violations>");
+            for (const violation of entry.violations) {
+                lines.push(`        <violation>${escapeXml(violation)}</violation>`);
+            }
+            lines.push("      </violations>");
+        }
+        lines.push("    </entry>");
+    }
+    lines.push("  </entries>");
+    lines.push("</compass-inventory>");
+    lines.push("");
+    return lines.join("\n");
+}
+export async function runCompassInventory(input, context) {
+    const scanRoot = resolveCompassScanRoot(input, context) ?? context.workspaceRoot;
+    const entries = await createCompassInventoryEntries(scanRoot, input);
+    const summary = summarizeInventory(entries);
+    context.logger.info(`[compass.inventory] scanned=${summary.scannedFiles} authored=${summary.authoredFiles} excluded=${summary.excludedFiles} standard=${summary.standardRequiredFiles}`);
+    if (context.dryRun) {
+        context.logger.warn(`[compass.inventory] dry-run active — skipped writing ${INVENTORY_OUTPUT_PATH}`);
+        return {
+            data: { entries: entries.length, outputPath: INVENTORY_OUTPUT_PATH, summary },
+            summary: `[compass.inventory] previewed ${INVENTORY_OUTPUT_PATH}`,
+        };
+    }
+    const xml = renderInventoryXml(entries, summary);
+    const outputPath = resolve(context.workspaceRoot, INVENTORY_OUTPUT_PATH);
+    await writeFileIfChanged(outputPath, xml);
+    return {
+        data: { entries: entries.length, outputPath, summary },
+        summary: `[compass.inventory] ${context.dryRun ? "previewed" : "wrote"} ${INVENTORY_OUTPUT_PATH}`,
+    };
+}
+export async function runCompassValidation(input, context) {
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const entries = await createCompassInventoryEntries(context.workspaceRoot, input, scanRoot);
+    const summary = summarizeInventory(entries);
+    const failures = entries.filter((entry) => entry.authoringStatus === "authored" &&
+        entry.requiredScaffolding !== "none" &&
+        !entry.compliant);
+    const diagnostics = [];
+    for (const failure of failures) {
+        for (const violation of failure.violations) {
+            let ruleId = "COMPASS-CONTRACT-01";
+            let fix = "fix: add a MODULE_CONTRACT block with <purpose> and <non-goals>";
+            if (violation.includes("purpose missing")) {
+                ruleId = "COMPASS-CONTRACT-02";
+                fix = "fix: write a <purpose> of at least 10 words";
+            }
+            else if (violation.includes("non-goals")) {
+                ruleId = "COMPASS-CONTRACT-03";
+                fix = "fix: add at least one <non-goals><item>";
+            }
+            else if (violation.includes("CHANGE_SUMMARY")) {
+                ruleId = "COMPASS-CONTRACT-04";
+                fix = "fix: add a CHANGE_SUMMARY with at least one <item>";
+            }
+            else if (violation.includes("@ai-invariant")) {
+                ruleId = "COMPASS-INVARIANT-01";
+                fix = "fix: add // @ai-invariant capturing the non-obvious constraint";
+            }
+            else if (violation.includes("forbidden")) {
+                ruleId = "COMPASS-FORBIDDEN-01";
+                const marker = violation.replace(/forbidden: ([^ ]+) present/, "$1");
+                fix = `fix: remove ${marker}; run fo-compass-annotate skill`;
+            }
+            context.logger.error(`[compass.validate] ${ruleId}: ${failure.path}: ${violation}`);
+            diagnostics.push({
+                ruleId,
+                severity: "error",
+                file: failure.path,
+                message: violation,
+                fix,
+            });
+        }
+    }
+    const compassTodoLabel = "TODO" + "(compass)";
+    const TODO_COMPASS_RE = new RegExp("TODO" + "\\\\(compass\\\\)");
+    for (const entry of entries) {
+        if (entry.authoringStatus !== "authored" || entry.requiredScaffolding === "none") {
+            continue;
+        }
+        if (!entry.hasModuleContract && !entry.hasChangeSummary) {
+            continue;
+        }
+        const absPath = resolve(context.workspaceRoot, entry.path);
+        const source = await readFile(absPath, "utf8");
+        if (TODO_COMPASS_RE.test(source)) {
+            context.logger.error(`[compass.validate] COMPASS-TODO-01: ${entry.path}: unfilled ${compassTodoLabel} sentinel in Compass block`);
+            diagnostics.push({
+                ruleId: "COMPASS-TODO-01",
+                severity: "error",
+                file: entry.path,
+                message: `Unfilled ${compassTodoLabel} sentinel in Compass block`,
+                fix: `fix: replace the ${compassTodoLabel} sentinel with a real value`,
+            });
+        }
+    }
+    const hasFailures = diagnostics.length > 0;
+    return {
+        data: {
+            checkedFiles: summary.authoredFiles,
+            failures: failures.length,
+            summary,
+            diagnostics,
+        },
+        exitCode: hasFailures ? 1 : 0,
+        summary: hasFailures
+            ? undefined
+            : `[compass.validate] OK (${summary.authoredFiles} authored files checked)`,
+    };
+}
+//# sourceMappingURL=compass-inventory-handler.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type { ForgeCommandInput } from "../../../src/types.ts";
+type CompassWorkspaceKind = "app" | "package" | "service";
+type CompassRiskClass = "high" | "medium" | "low";
+type CompassComplexity = "non-trivial" | "trivial";
+type CompassScaffoldingMode = "standard" | "none";
+type CompassAuthoringStatus = "authored" | "excluded";
+export interface CompassInventoryEntry {
+    path: string;
+    workspaceKind: CompassWorkspaceKind;
+    workspaceName: string;
+    layer: string;
+    extension: string;
+    authoringStatus: CompassAuthoringStatus;
+    exclusionReason?: string;
+    riskClass: CompassRiskClass;
+    complexity: CompassComplexity;
+    requiredScaffolding: CompassScaffoldingMode;
+    nonEmptyLineCount: number;
+    hasModuleContract: boolean;
+    hasChangeSummary: boolean;
+    hasAiInvariant: boolean;
+    hasPurpose: boolean;
+    hasNonGoals: boolean;
+    forbiddenPresent: string[];
+    compliant: boolean;
+    violations: string[];
+}
+export declare function createCompassInventoryEntries(workspaceRoot: string, input: ForgeCommandInput, scanRoot?: string): Promise<CompassInventoryEntry[]>;
+export {};
+//# sourceMappingURL=compass-inventory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compass-inventory.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-inventory.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAuC/D,KAAK,oBAAoB,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAC1D,KAAK,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAClD,KAAK,iBAAiB,GAAG,aAAa,GAAG,SAAS,CAAC;AACnD,KAAK,sBAAsB,GAAG,UAAU,GAAG,MAAM,CAAC;AAClD,KAAK,sBAAsB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,oBAAoB,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,sBAAsB,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,mBAAmB,EAAE,sBAAsB,CAAC;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AA2XD,wBAAsB,6BAA6B,CACjD,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,iBAAiB,EACxB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAmDlC"}