@warpgogol/forge 4.1.6 → 4.2.1

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":"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"}

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":"AAkBA,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,CAuDpB"}

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

@@ -0,0 +1,57 @@
+/*
+<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>
+  <item>RFC-0617: added --workpiece flag for mission workpiece directory scanning.</item>
+</CHANGE_SUMMARY>
+*/
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+export function resolveCompassScanRoot(input, context) {
+    const hasPackages = input.flags["packages"] === true;
+    const workpiecePath = input.flags["workpiece"];
+    const hasWorkpiece = typeof workpiecePath === "string" && workpiecePath.length > 0;
+    if (hasWorkpiece && hasPackages) {
+        throw new Error("[compass] --workpiece and --packages are mutually exclusive. Use one or the other.");
+    }
+    if (hasWorkpiece && context.siteExplicit) {
+        throw new Error("[compass] --workpiece and --site are mutually exclusive. Use one or the other.");
+    }
+    if (hasWorkpiece) {
+        const resolved = resolve(context.workspaceRoot, workpiecePath);
+        if (!existsSync(resolved)) {
+            throw new Error(`[compass] workpiece path not found: ${workpiecePath}`);
+        }
+        return resolved;
+    }
+    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;;;;;;;;;;;;;;EAcE;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;IACrD,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IAEnF,IAAI,YAAY,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,aAAuB,CAAC,CAAC;QACzE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,aAAa,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,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"}

package/dist/os/core/core.module.d.ts

@@ -0,0 +1,3 @@
+import type { ForgeModule } from "../../src/forge-module.ts";
+export declare function createForgeCoreModule(): Promise<ForgeModule>;
+//# sourceMappingURL=core.module.d.ts.map

package/dist/os/core/core.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.module.d.ts","sourceRoot":"","sources":["../../../os/core/core.module.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAgB7D,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,WAAW,CAAC,CA85BlE"}