@warpgogol/forge 0.3.1

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

@@ -0,0 +1,418 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Canonical Compass inventory scanning logic. Moved from @warpgogol/site-kernel
+to @warpgogol/forge for full autonomous mode (RFC-0556). Provides file collection,
+workspace detection, layer classification, risk assessment, and compliance checking
+for Compass source-file inventory.</purpose>
+<non-goals>
+  <item>Do not render XML output — that belongs in the compass command handler.</item>
+  <item>Do not register commands — this is a pure utility module.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0348: collapsed to two-block contract (MODULE_CONTRACT + CHANGE_SUMMARY); removed MODULE_MAP, keywords, responsibilities, COMPASS_BLOCK anchors; coverage modes collapsed to standard/none.</item>
+  <item>Post-refactor hardening: exclude src/templates generation inputs from authored Compass requirements.</item>
+  <item>Post-refactor hardening: detect nested packages/os workspaces before deriving Compass layer and workspace name.</item>
+  <item>RFC-0556: moved canonical implementation from @warpgogol/site-kernel to @warpgogol/forge for autonomous mode.</item>
+</CHANGE_SUMMARY>
+*/
+import { readdir, readFile } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { hasGeneratedMarker } from "../../../src/utils/generated-marker.js";
+const SOURCE_EXTENSIONS = new Set([".ts", ".tsx", ".astro", ".js", ".jsx", ".mjs", ".mts", ".css"]);
+const IGNORED_DIRECTORY_NAMES = new Set([
+    ".git",
+    ".turbo",
+    ".astro",
+    ".wrangler",
+    ".vscode",
+    ".cache",
+    "coverage",
+    "dist",
+    "node_modules",
+    "spec",
+    "todo",
+]);
+const DEFAULT_SCAN_ROOTS = ["apps", "packages", "services"];
+const HIGH_RISK_EXACT_RELATIVE_PATHS = new Set([
+    "apps/main/src/content/config.ts",
+    "apps/main/src/middleware.ts",
+    "packages/os/site-kernel/src/cli/index.ts",
+    "packages/os/site-kernel/src/discovery.ts",
+    "packages/os/site-kernel/src/registry.ts",
+    "packages/os/site-kernel/src/runtime.ts",
+    "packages/os/site-kernel/src/types.ts",
+]);
+const REQUIRED_MARKERS = ["<MODULE_CONTRACT>", "<CHANGE_SUMMARY>"];
+function forbiddenMarkerPattern(tagName) {
+    return new RegExp(`<${tagName}\\b`);
+}
+const FORBIDDEN_PATTERNS = [
+    { name: "MODULE_MAP", regex: forbiddenMarkerPattern("MODULE_MAP") },
+    { name: "keywords", regex: forbiddenMarkerPattern("keywords") },
+    { name: "responsibilities", regex: forbiddenMarkerPattern("responsibilities") },
+    { name: "COMPASS_BLOCK", regex: new RegExp(`</?${"COMPASS_BLOCK"}\\b`) },
+];
+function getFlagValues(input, key) {
+    const value = input.flags[key];
+    if (Array.isArray(value)) {
+        return value.filter((entry) => typeof entry === "string");
+    }
+    return typeof value === "string" ? [value] : [];
+}
+function resolveScanRoots(workspaceRoot, input) {
+    const values = getFlagValues(input, "root");
+    const roots = values.length > 0 ? values : DEFAULT_SCAN_ROOTS;
+    return roots.map((value) => resolve(workspaceRoot, value));
+}
+function shouldIgnoreDirectory(name) {
+    if (IGNORED_DIRECTORY_NAMES.has(name)) {
+        return true;
+    }
+    if (name.startsWith("old-")) {
+        return true;
+    }
+    if (name.startsWith("-")) {
+        return true;
+    }
+    return false;
+}
+function hasRelevantExtension(filePath) {
+    for (const extension of SOURCE_EXTENSIONS) {
+        if (filePath.endsWith(extension)) {
+            return true;
+        }
+    }
+    return false;
+}
+async function collectSourceFiles(targetPath) {
+    let stat;
+    try {
+        const { stat: fsStat } = await import("node:fs/promises");
+        stat = await fsStat(targetPath);
+    }
+    catch {
+        return [];
+    }
+    if (stat.isFile()) {
+        return hasRelevantExtension(targetPath) ? [targetPath] : [];
+    }
+    let entries;
+    try {
+        entries = await readdir(targetPath, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const files = [];
+    for (const entry of entries) {
+        const absolutePath = join(targetPath, entry.name);
+        if (entry.isDirectory()) {
+            if (shouldIgnoreDirectory(entry.name)) {
+                continue;
+            }
+            const normalizedPath = absolutePath.replace(/\\/g, "/");
+            if (normalizedPath.endsWith("/src/assets") ||
+                normalizedPath.endsWith("/src/icons/gen") ||
+                normalizedPath.includes("/public/_video") ||
+                normalizedPath.includes("/public/_img")) {
+                continue;
+            }
+            files.push(...(await collectSourceFiles(absolutePath)));
+            continue;
+        }
+        if (entry.isFile() && hasRelevantExtension(absolutePath)) {
+            files.push(absolutePath);
+        }
+    }
+    return files;
+}
+function getRelativeSegments(filePath, workspaceRoot) {
+    return relative(workspaceRoot, filePath).replace(/\\/g, "/").split("/").filter(Boolean);
+}
+function detectWorkspaceKind(segments) {
+    if (segments[0] === "services")
+        return "service";
+    return segments[0] === "packages" ? "package" : "app";
+}
+function detectWorkspaceName(segments) {
+    if (segments[0] === "packages" && segments[1] === "os") {
+        return segments[2] ?? "unknown";
+    }
+    return segments[1] ?? "unknown";
+}
+function getWorkspaceRelativeSegments(segments) {
+    if (segments[0] === "packages" && segments[1] === "os") {
+        return segments.slice(3);
+    }
+    return segments.slice(2);
+}
+function detectLayer(relativePath) {
+    if (relativePath.startsWith("bin/"))
+        return "bin";
+    if (relativePath === "tools/kernel.config.ts")
+        return "tool-config";
+    if (relativePath.startsWith("tools/modules/"))
+        return "tool-module";
+    if (relativePath.startsWith("tools/runtime/"))
+        return "tool-runtime";
+    if (relativePath.startsWith("src/middleware/"))
+        return "middleware";
+    if (relativePath === "src/middleware.ts")
+        return "middleware";
+    if (relativePath.startsWith("src/pages/"))
+        return "page";
+    if (relativePath.startsWith("src/components/"))
+        return "component";
+    if (relativePath.startsWith("src/content/schemas/"))
+        return "schema";
+    if (relativePath.startsWith("src/content/"))
+        return "content";
+    if (relativePath.startsWith("src/styles/"))
+        return "style";
+    if (relativePath.startsWith("src/scripts/"))
+        return "script";
+    if (relativePath.startsWith("src/layouts/"))
+        return "layout";
+    if (relativePath.startsWith("src/utils/"))
+        return "utility";
+    if (relativePath.startsWith("src/configure/"))
+        return "config";
+    if (relativePath.startsWith("test/") ||
+        relativePath.startsWith("src/tests/") ||
+        relativePath.endsWith(".test.ts") ||
+        relativePath.endsWith(".spec.ts"))
+        return "test";
+    if (relativePath.startsWith("src/"))
+        return "source";
+    return "other";
+}
+function detectRiskClass(pathFromRoot, layer) {
+    if (HIGH_RISK_EXACT_RELATIVE_PATHS.has(pathFromRoot)) {
+        return "high";
+    }
+    if (pathFromRoot.includes("/src/scripts/layout-scroll/")) {
+        return "high";
+    }
+    if (pathFromRoot.includes("/src/layouts/")) {
+        return "high";
+    }
+    if (pathFromRoot.includes("/src/middleware/")) {
+        return "high";
+    }
+    if (layer === "tool-runtime" || layer === "tool-config" || layer === "schema") {
+        return "medium";
+    }
+    if (layer === "page" || layer === "component" || layer === "utility" || layer === "script") {
+        return "medium";
+    }
+    return "low";
+}
+function detectComplexity(source) {
+    const nonEmptyLineCount = source.split(/\r?\n/).filter((line) => line.trim().length > 0).length;
+    if (nonEmptyLineCount <= 20 && source.length <= 900) {
+        return "trivial";
+    }
+    return "non-trivial";
+}
+function isSimpleSvgLogoComponent(segments) {
+    return (segments.length >= 4 &&
+        segments[0] === "apps" &&
+        segments[2] === "src" &&
+        segments[3] === "components" &&
+        segments[4] === "logo");
+}
+function detectAuthoringStatus(segments, relativePath, source) {
+    if (hasGeneratedMarker(source)) {
+        return {
+            authoringStatus: "excluded",
+            exclusionReason: "generated-marker",
+        };
+    }
+    if (relativePath.startsWith("src/icons/gen/")) {
+        return {
+            authoringStatus: "excluded",
+            exclusionReason: "generated-icon-tree",
+        };
+    }
+    if (relativePath.startsWith("src/assets/")) {
+        return {
+            authoringStatus: "excluded",
+            exclusionReason: "assets-directory",
+        };
+    }
+    if (isSimpleSvgLogoComponent(segments)) {
+        return {
+            authoringStatus: "excluded",
+            exclusionReason: "svg-component",
+        };
+    }
+    if (relativePath.startsWith("dist/")) {
+        return {
+            authoringStatus: "excluded",
+            exclusionReason: "generated-dist",
+        };
+    }
+    if (/\.generated\.[a-z]+$/i.test(relativePath)) {
+        return {
+            authoringStatus: "excluded",
+            exclusionReason: "generated-file",
+        };
+    }
+    if (relativePath.startsWith("src/templates/")) {
+        return {
+            authoringStatus: "excluded",
+            exclusionReason: "template-source",
+        };
+    }
+    if (relativePath.startsWith("test/") ||
+        relativePath.endsWith(".test.ts") ||
+        relativePath.endsWith(".test.js") ||
+        relativePath.endsWith(".spec.ts") ||
+        relativePath.endsWith(".spec.js")) {
+        return {
+            authoringStatus: "excluded",
+            exclusionReason: "test-file",
+        };
+    }
+    if (segments.includes("bin")) {
+        return {
+            authoringStatus: "excluded",
+            exclusionReason: "bin-entrypoint",
+        };
+    }
+    const isRootFile = !relativePath.includes("/");
+    if (isRootFile &&
+        (relativePath.endsWith(".config.mjs") ||
+            relativePath.endsWith(".config.cjs") ||
+            relativePath.endsWith(".config.js") ||
+            relativePath.endsWith(".config.ts"))) {
+        return {
+            authoringStatus: "excluded",
+            exclusionReason: "framework-config",
+        };
+    }
+    return { authoringStatus: "authored" };
+}
+function detectRequiredScaffolding(authoringStatus) {
+    if (authoringStatus === "excluded") {
+        return "none";
+    }
+    return "standard";
+}
+function extractBlockContent(source, tagName) {
+    const escapedTag = tagName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const match = source.match(new RegExp(`<${escapedTag}>[\\s\\S]*?<\/${escapedTag}>`));
+    return match?.[0] ?? null;
+}
+function countWords(value) {
+    return value.trim().split(/\s+/).filter(Boolean).length;
+}
+function detectComplianceViolations(entry) {
+    if (entry.requiredScaffolding === "none") {
+        return [];
+    }
+    const violations = [];
+    if (!entry.hasModuleContract) {
+        violations.push("missing MODULE_CONTRACT");
+    }
+    else {
+        if (!entry.hasPurpose) {
+            violations.push("purpose missing or < 10 words");
+        }
+        if (!entry.hasNonGoals) {
+            violations.push("no <non-goals> item");
+        }
+    }
+    if (!entry.hasChangeSummary) {
+        violations.push("missing CHANGE_SUMMARY");
+    }
+    if (entry.riskClass === "high" && !entry.hasAiInvariant) {
+        violations.push("missing @ai-invariant (high-risk)");
+    }
+    for (const forbidden of entry.forbiddenPresent) {
+        violations.push(`forbidden: ${forbidden} present`);
+    }
+    return violations;
+}
+function detectMarkup(source) {
+    const hasModuleContract = source.includes(REQUIRED_MARKERS[0]);
+    const hasChangeSummary = source.includes(REQUIRED_MARKERS[1]);
+    const hasAiInvariant = /@ai-invariant\b/.test(source);
+    let hasPurpose = false;
+    let hasNonGoals = false;
+    if (hasModuleContract) {
+        const contractBlock = extractBlockContent(source, "MODULE_CONTRACT");
+        if (contractBlock) {
+            const purposeBlock = extractBlockContent(contractBlock, "purpose");
+            if (purposeBlock) {
+                const purposeText = purposeBlock.replace(/<[^>]+>/g, " ");
+                hasPurpose = countWords(purposeText) >= 10;
+            }
+            const nonGoalsBlock = extractBlockContent(contractBlock, "non-goals");
+            if (nonGoalsBlock) {
+                hasNonGoals = (nonGoalsBlock.match(/<item>/g) ?? []).length >= 1;
+            }
+        }
+    }
+    const forbiddenPresent = [];
+    for (const { name, regex } of FORBIDDEN_PATTERNS) {
+        if (regex.test(source)) {
+            forbiddenPresent.push(name);
+        }
+    }
+    return {
+        hasModuleContract,
+        hasChangeSummary,
+        hasAiInvariant,
+        hasPurpose,
+        hasNonGoals,
+        forbiddenPresent,
+    };
+}
+export async function createCompassInventoryEntries(workspaceRoot, input, scanRoot) {
+    const roots = scanRoot ? [scanRoot] : resolveScanRoots(workspaceRoot, input);
+    const files = (await Promise.all(roots.map((root) => collectSourceFiles(root)))).flat();
+    const entries = [];
+    for (const filePath of files.sort()) {
+        const source = await readFile(filePath, "utf8");
+        const pathFromRoot = relative(workspaceRoot, filePath).replace(/\\/g, "/");
+        const segments = getRelativeSegments(filePath, workspaceRoot);
+        const relativePathWithinWorkspace = getWorkspaceRelativeSegments(segments).join("/");
+        const layer = detectLayer(relativePathWithinWorkspace);
+        const riskClass = detectRiskClass(pathFromRoot, layer);
+        const complexity = detectComplexity(source);
+        const { authoringStatus, exclusionReason } = detectAuthoringStatus(segments, relativePathWithinWorkspace, source);
+        const requiredScaffolding = detectRequiredScaffolding(authoringStatus);
+        const markup = detectMarkup(source);
+        const nonEmptyLineCount = source.split(/\r?\n/).filter((line) => line.trim().length > 0).length;
+        const candidate = {
+            path: pathFromRoot,
+            workspaceKind: detectWorkspaceKind(segments),
+            workspaceName: detectWorkspaceName(segments),
+            layer,
+            extension: segments.length > 0
+                ? segments[segments.length - 1].slice(segments[segments.length - 1].lastIndexOf("."))
+                : "",
+            authoringStatus,
+            exclusionReason,
+            riskClass,
+            complexity,
+            requiredScaffolding,
+            nonEmptyLineCount,
+            hasModuleContract: markup.hasModuleContract,
+            hasChangeSummary: markup.hasChangeSummary,
+            hasAiInvariant: markup.hasAiInvariant,
+            hasPurpose: markup.hasPurpose,
+            hasNonGoals: markup.hasNonGoals,
+            forbiddenPresent: markup.forbiddenPresent,
+            compliant: false,
+            violations: [],
+        };
+        candidate.violations = detectComplianceViolations(candidate);
+        candidate.compliant = candidate.violations.length === 0;
+        entries.push(candidate);
+    }
+    return entries;
+}
+//# sourceMappingURL=compass-inventory.js.map

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

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

package/dist/os/compass/handlers/git-revision.d.ts

@@ -0,0 +1,8 @@
+export declare function getFileRevisionFromHistory(cwd: string, repoPath: string): Promise<number>;
+export interface RevisionByPathResult {
+    revision: number;
+    entityId: string | null;
+    contentHash: string;
+}
+export declare function getRevisionByPath(cwd: string, repoPath: string): Promise<RevisionByPathResult>;
+//# sourceMappingURL=git-revision.d.ts.map

package/dist/os/compass/handlers/git-revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-revision.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/git-revision.ts"],"names":[],"mappings":"AAkCA,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB/F;AAqCD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAmC/B"}

package/dist/os/compass/handlers/git-revision.js

@@ -0,0 +1,99 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Git revision lookup by file path. Moved from @warpgogol/site-kernel-integrity
+to @warpgogol/forge for full autonomous mode (RFC-0556). Provides getRevisionByPath
+with integrity-registry lookup and git-history fallback, plus getFileRevisionFromHistory.</purpose>
+<non-goals>
+  <item>Do not compute a new per-file counter — reuse the existing integrity revision.</item>
+  <item>Do not modify the registry or write any files.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0352: initial implementation of getRevisionByPath helper.</item>
+  <item>RFC-0556: moved from @warpgogol/site-kernel-integrity to @warpgogol/forge for autonomous mode.</item>
+</CHANGE_SUMMARY>
+*/
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { resolve, join } from "node:path";
+const execFileAsync = promisify(execFile);
+const DEFAULT_GIT_TIMEOUT_MS = 15_000;
+async function runGit(cwd, args, timeoutMs = DEFAULT_GIT_TIMEOUT_MS) {
+    const { stdout } = await execFileAsync("git", args, {
+        cwd,
+        maxBuffer: 20 * 1024 * 1024,
+        timeout: timeoutMs,
+    });
+    return stdout.trimEnd();
+}
+export async function getFileRevisionFromHistory(cwd, repoPath) {
+    try {
+        const output = await runGit(cwd, ["log", "--follow", "--diff-filter=AMT", "--format=%H", "--", repoPath], 15_000).catch(() => "");
+        if (!output) {
+            return 1;
+        }
+        const revisions = output.split("\n").filter(Boolean).length;
+        return Math.max(1, revisions);
+    }
+    catch {
+        return 1;
+    }
+}
+async function loadEntitiesById(cwd) {
+    const filePath = join(cwd, ".integrity", "index", "entities.by-id.json");
+    try {
+        const content = await readFile(filePath, "utf8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+async function loadPathsCurrent(cwd) {
+    const filePath = join(cwd, ".integrity", "index", "paths.current.json");
+    try {
+        const content = await readFile(filePath, "utf8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+export async function getRevisionByPath(cwd, repoPath) {
+    const paths = await loadPathsCurrent(cwd);
+    const entityId = paths[repoPath];
+    if (entityId) {
+        const entities = await loadEntitiesById(cwd);
+        const entity = entities[entityId];
+        if (entity) {
+            let contentHash = entity.contentHash;
+            try {
+                const abs = resolve(cwd, repoPath);
+                const content = await readFile(abs, "utf8");
+                contentHash = "sha256-" + createHash("sha256").update(content).digest("hex");
+            }
+            catch {
+                // keep registry hash
+            }
+            return {
+                revision: entity.revision,
+                entityId,
+                contentHash,
+            };
+        }
+    }
+    const revision = await getFileRevisionFromHistory(cwd, repoPath);
+    let contentHash = "";
+    try {
+        const abs = resolve(cwd, repoPath);
+        const content = await readFile(abs, "utf8");
+        contentHash = "sha256-" + createHash("sha256").update(content).digest("hex");
+    }
+    catch {
+        // file may not exist
+    }
+    return { revision, entityId: null, contentHash };
+}
+//# sourceMappingURL=git-revision.js.map

package/dist/os/compass/handlers/git-revision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-revision.js","sourceRoot":"","sources":["../../../../os/compass/handlers/git-revision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;EAcE;AAEF,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAEtC,KAAK,UAAU,MAAM,CAAC,GAAW,EAAE,IAAc,EAAE,YAAoB,sBAAsB;IAC3F,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE;QAClD,GAAG;QACH,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;QAC3B,OAAO,EAAE,SAAS;KACnB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,GAAW,EAAE,QAAgB;IAC5E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,GAAG,EACH,CAAC,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,CAAC,EACvE,MAAM,CACP,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAElB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAiBD,KAAK,UAAU,gBAAgB,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC;IACzE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC;IACxE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAW,EACX,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEjC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBACnC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAC5C,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/E,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ;gBACR,WAAW;aACZ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjE,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACnD,CAAC"}

package/dist/os/compass/handlers/resolve-scan-root.d.ts

@@ -0,0 +1,3 @@
+import type { ForgeCommandInput, ForgeRuntimeContext } from "../../../src/types.ts";
+export declare function resolveCompassScanRoot(input: ForgeCommandInput, context: ForgeRuntimeContext): string | undefined;
+//# sourceMappingURL=resolve-scan-root.d.ts.map

package/dist/os/compass/handlers/resolve-scan-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-scan-root.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/resolve-scan-root.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,MAAM,GAAG,SAAS,CAiCpB"}

package/dist/os/compass/handlers/resolve-scan-root.js

@@ -0,0 +1,41 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Canonical Compass scan-root resolution for all Compass commands.
+Moved from @warpgogol/site-kernel to @warpgogol/forge for full autonomous mode (RFC-0556).</purpose>
+<non-goals>
+  <item>Do not implement Compass scanning or file processing logic here.</item>
+  <item>Do not register commands or modify runtime context.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Introduced as part of RFC-0015 to extend Compass commands to packages/.</item>
+  <item>RFC-0556: moved canonical implementation from @warpgogol/site-kernel to @warpgogol/forge for autonomous mode.</item>
+</CHANGE_SUMMARY>
+*/
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+export function resolveCompassScanRoot(input, context) {
+    const hasPackages = input.flags["packages"] === true;
+    if (context.siteExplicit && hasPackages) {
+        throw new Error("[compass] --site and --packages are mutually exclusive. Use one or the other.");
+    }
+    if (!hasPackages) {
+        return context.site ? context.site.directory : undefined;
+    }
+    const packageName = input.flags["package"];
+    if (!packageName || typeof packageName !== "string") {
+        return resolve(context.workspaceRoot, "packages");
+    }
+    const candidates = [
+        resolve(context.workspaceRoot, "packages", "os", packageName),
+        resolve(context.workspaceRoot, "packages", packageName),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            const srcPath = resolve(candidate, "src");
+            return existsSync(srcPath) ? srcPath : candidate;
+        }
+    }
+    throw new Error(`[compass] Package "${packageName}" not found. Tried:\n${candidates.map((c) => `  ${c}`).join("\n")}`);
+}
+//# sourceMappingURL=resolve-scan-root.js.map

package/dist/os/compass/handlers/resolve-scan-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-scan-root.js","sourceRoot":"","sources":["../../../../os/compass/handlers/resolve-scan-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,UAAU,sBAAsB,CACpC,KAAwB,EACxB,OAA4B;IAE5B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IAErD,IAAI,OAAO,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpD,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,CAAC;QAC7D,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC;KACxD,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,sBAAsB,WAAW,wBAAwB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtG,CAAC;AACJ,CAAC"}

package/dist/os/compass/index.d.ts

@@ -0,0 +1,8 @@
+export { forgeCompassModule } from "./compass.module.ts";
+export { createCompassInventoryEntries, type CompassInventoryEntry, } from "./handlers/compass-inventory.ts";
+export { resolveCompassScanRoot } from "./handlers/resolve-scan-root.ts";
+export { getRevisionByPath, type RevisionByPathResult } from "./handlers/git-revision.ts";
+export { runCompassInventory, runCompassValidation } from "./handlers/compass-inventory-handler.ts";
+export { runCompassAuditPlan, runCompassAuditRecord, runCompassAuditBaseline, runCompassAuditValidate, isAuditDue, } from "./handlers/compass-audit-handler.ts";
+export { runCompassChangeSummaryValidate, runCompassSummaryTrim, classifyChangeSummaryItem, type ChangeSummaryItemClass, } from "./handlers/compass-change-summary-handler.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/os/compass/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/compass/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,6BAA6B,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpG,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,GACX,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,8CAA8C,CAAC"}

package/dist/os/compass/index.js

@@ -0,0 +1,19 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Expose the forge Compass kernel module through a stable package subpath.</purpose>
+<non-goals>
+  <item>Do not implement compass handler logic.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial compass module barrel.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgeCompassModule } from "./compass.module.js";
+export { createCompassInventoryEntries, } from "./handlers/compass-inventory.js";
+export { resolveCompassScanRoot } from "./handlers/resolve-scan-root.js";
+export { getRevisionByPath } from "./handlers/git-revision.js";
+export { runCompassInventory, runCompassValidation } from "./handlers/compass-inventory-handler.js";
+export { runCompassAuditPlan, runCompassAuditRecord, runCompassAuditBaseline, runCompassAuditValidate, isAuditDue, } from "./handlers/compass-audit-handler.js";
+export { runCompassChangeSummaryValidate, runCompassSummaryTrim, classifyChangeSummaryItem, } from "./handlers/compass-change-summary-handler.js";
+//# sourceMappingURL=index.js.map

package/dist/os/compass/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/compass/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,6BAA6B,GAE9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAA6B,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpG,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,GACX,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,EACrB,yBAAyB,GAE1B,MAAM,8CAA8C,CAAC"}