@winspan/claude-forge 8.54.3 → 9.2.0

package/dist/knowledge/git-hooks.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @file git-hooks.ts
+ * Git post-commit hook installer / uninstaller for automatic KB staleness marking.
+ *
+ * Four cases handled by installGitHook:
+ *  1. Non-git directory            → skipped-non-git
+ *  2. cf section already present   → already-installed
+ *  3. User hook exists (no cf)     → append cf section, preserve user content
+ *  4. No hook file                 → create new hook file
+ *
+ * uninstallGitHook removes only the cf-managed section, preserving any
+ * user-owned content in the hook file.
+ */
+import { GitHookInstallResult } from './types.js';
+export interface InstallOptions {
+    /** Defaults to `process.cwd()`. */
+    projectRoot?: string;
+    /** Shell command to run on each commit. Defaults to `'cf knowledge update'`. */
+    hookCommand?: string;
+    /** When `false` (default) the result is printed to stdout. */
+    silent?: boolean;
+}
+export interface UninstallResult {
+    action: 'removed' | 'not-installed' | 'skipped-no-cf-section' | 'skipped-non-git';
+    hookPath: string;
+    /** `true` when the cf section was removed but user-owned content was kept. */
+    preservedUserContent?: boolean;
+}
+export interface HookStatus {
+    installed: boolean;
+    hookPath: string | null;
+    isGitRepo: boolean;
+    cfSectionPresent: boolean;
+    /** `true` when the hook file contains content beyond the cf-managed section. */
+    userHasOwnHook: boolean;
+    /** ISO-8601 datetime when the section was installed, if detectable. */
+    installedAt?: string;
+}
+/**
+ * Install the cf-managed section into `.git/hooks/post-commit`.
+ *
+ * Idempotent: calling this multiple times is safe — the second call returns
+ * `already-installed` without modifying the file.
+ *
+ * When the user already has a hook file, the cf section is appended so their
+ * existing logic is fully preserved.
+ */
+export declare function installGitHook(options?: InstallOptions): GitHookInstallResult;
+/**
+ * Remove the cf-managed section from `.git/hooks/post-commit`.
+ *
+ * User-owned hook content is always preserved.  When removing the cf section
+ * leaves no meaningful content behind, the entire hook file is deleted.
+ *
+ * Idempotent: safe to call even when the cf section was never installed.
+ */
+export declare function uninstallGitHook(options?: {
+    projectRoot?: string;
+    silent?: boolean;
+}): UninstallResult;
+/**
+ * Return the current state of the post-commit hook without modifying anything.
+ *
+ * Used by `cf knowledge hook-status` to display a quick diagnostic.
+ */
+export declare function getHookStatus(projectRoot?: string): HookStatus;
+//# sourceMappingURL=git-hooks.d.ts.map

package/dist/knowledge/git-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hooks.d.ts","sourceRoot":"","sources":["../../src/knowledge/git-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAOlD,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,eAAe,GAAG,uBAAuB,GAAG,iBAAiB,CAAC;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gFAAgF;IAChF,cAAc,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2HD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,oBAAoB,CAgDjF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,eAAe,CA2CjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,GAAE,MAAsB,GAAG,UAAU,CA6C7E"}

package/dist/knowledge/git-hooks.js

@@ -0,0 +1,258 @@
+/**
+ * @file git-hooks.ts
+ * Git post-commit hook installer / uninstaller for automatic KB staleness marking.
+ *
+ * Four cases handled by installGitHook:
+ *  1. Non-git directory            → skipped-non-git
+ *  2. cf section already present   → already-installed
+ *  3. User hook exists (no cf)     → append cf section, preserve user content
+ *  4. No hook file                 → create new hook file
+ *
+ * uninstallGitHook removes only the cf-managed section, preserving any
+ * user-owned content in the hook file.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+import * as K from './constants.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Resolve the `.git` directory (or common dir for worktrees / submodules).
+ *
+ * Uses `git rev-parse --git-common-dir` so that worktrees always resolve to
+ * the main repository's `.git`, keeping hooks shared across worktrees.
+ *
+ * Returns `null` when `projectRoot` is not inside any git repository.
+ */
+function resolveGitDir(projectRoot) {
+    try {
+        const result = execSync('git rev-parse --git-common-dir', {
+            cwd: projectRoot,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        })
+            .toString()
+            .trim();
+        return path.isAbsolute(result) ? result : path.resolve(projectRoot, result);
+    }
+    catch {
+        return null;
+    }
+}
+/** Escape a string for safe use inside a `RegExp` constructor. */
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Build the cf-managed block that will be injected into the hook file.
+ *
+ * The command is run in the background so it never blocks the commit itself.
+ */
+function buildCfSection(hookCommand) {
+    return `${K.CF_HOOK_MARKER}
+{
+  ${hookCommand} 2>/dev/null &
+  disown
+} 1>/dev/null
+${K.CF_HOOK_END}`;
+}
+/**
+ * Regex that matches the entire cf-managed block, including surrounding
+ * newlines, so removal leaves no blank-line artefacts.
+ */
+function makeCfBlockRegex() {
+    return new RegExp(`\\n?${escapeRegex(K.CF_HOOK_MARKER)}[\\s\\S]*?${escapeRegex(K.CF_HOOK_END)}\\n?`, 'g');
+}
+/**
+ * Count meaningful (non-blank, non-comment, non-shebang) lines in a string.
+ */
+function countMeaningfulLines(content) {
+    return content
+        .split('\n')
+        .filter((l) => l.trim() && !l.trim().startsWith('#') && !l.match(/^#!/))
+        .length;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Print helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function printInstallResult(result, silent) {
+    if (silent)
+        return;
+    switch (result.action) {
+        case 'created':
+            console.log(`✓ git post-commit hook installed at ${result.hookPath}`);
+            break;
+        case 'appended':
+            console.log(`✓ cf section appended to existing ${result.hookPath} (user hook preserved)`);
+            break;
+        case 'already-installed':
+            console.log(`ℹ️  cf hook already installed at ${result.hookPath}`);
+            break;
+        case 'skipped-non-git':
+            console.log(`ℹ️  Not a git repo — KB auto-update disabled. Use 'cf knowledge update' manually.`);
+            break;
+    }
+}
+function printUninstallResult(result, silent) {
+    if (silent)
+        return;
+    switch (result.action) {
+        case 'removed':
+            if (result.preservedUserContent) {
+                console.log(`✓ cf section removed from ${result.hookPath} (user hook content preserved)`);
+            }
+            else {
+                console.log(`✓ post-commit hook file removed (no remaining user content)`);
+            }
+            break;
+        case 'not-installed':
+            console.log(`ℹ️  No post-commit hook found at ${result.hookPath}`);
+            break;
+        case 'skipped-no-cf-section':
+            console.log(`ℹ️  No cf section found in ${result.hookPath} — nothing to remove`);
+            break;
+        case 'skipped-non-git':
+            console.log(`ℹ️  Not a git repo — nothing to uninstall`);
+            break;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Install the cf-managed section into `.git/hooks/post-commit`.
+ *
+ * Idempotent: calling this multiple times is safe — the second call returns
+ * `already-installed` without modifying the file.
+ *
+ * When the user already has a hook file, the cf section is appended so their
+ * existing logic is fully preserved.
+ */
+export function installGitHook(options = {}) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const hookCommand = options.hookCommand ?? 'cf knowledge update';
+    const silent = options.silent ?? false;
+    const gitDir = resolveGitDir(projectRoot);
+    if (!gitDir) {
+        const result = { action: 'skipped-non-git', hookPath: '' };
+        printInstallResult(result, silent);
+        return result;
+    }
+    const hooksDir = path.join(gitDir, 'hooks');
+    const hookPath = path.join(hooksDir, 'post-commit');
+    const cfSection = buildCfSection(hookCommand);
+    // Ensure the hooks directory exists (bare repos / fresh clones may not have it)
+    fs.mkdirSync(hooksDir, { recursive: true });
+    if (!fs.existsSync(hookPath)) {
+        // Case 4: no hook file — create a new one
+        const content = `#!/usr/bin/env bash\nset -e\n\n${cfSection}\n`;
+        fs.writeFileSync(hookPath, content, { encoding: 'utf-8' });
+        fs.chmodSync(hookPath, 0o755);
+        const result = { action: 'created', hookPath };
+        printInstallResult(result, silent);
+        return result;
+    }
+    const existing = fs.readFileSync(hookPath, 'utf-8');
+    if (existing.includes(K.CF_HOOK_MARKER)) {
+        // Case 2: already installed — idempotent no-op
+        const result = { action: 'already-installed', hookPath };
+        printInstallResult(result, silent);
+        return result;
+    }
+    // Case 3: user has their own hook — append cf section without touching their content
+    const separator = existing.endsWith('\n') ? '' : '\n';
+    fs.appendFileSync(hookPath, `${separator}\n${cfSection}\n`, 'utf-8');
+    const result = {
+        action: 'appended',
+        hookPath,
+        preserved_user_hook: true,
+    };
+    printInstallResult(result, silent);
+    return result;
+}
+/**
+ * Remove the cf-managed section from `.git/hooks/post-commit`.
+ *
+ * User-owned hook content is always preserved.  When removing the cf section
+ * leaves no meaningful content behind, the entire hook file is deleted.
+ *
+ * Idempotent: safe to call even when the cf section was never installed.
+ */
+export function uninstallGitHook(options = {}) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const silent = options.silent ?? false;
+    const gitDir = resolveGitDir(projectRoot);
+    if (!gitDir) {
+        const result = { action: 'skipped-non-git', hookPath: '' };
+        printUninstallResult(result, silent);
+        return result;
+    }
+    const hookPath = path.join(gitDir, 'hooks', 'post-commit');
+    if (!fs.existsSync(hookPath)) {
+        const result = { action: 'not-installed', hookPath };
+        printUninstallResult(result, silent);
+        return result;
+    }
+    const existing = fs.readFileSync(hookPath, 'utf-8');
+    if (!existing.includes(K.CF_HOOK_MARKER)) {
+        const result = { action: 'skipped-no-cf-section', hookPath };
+        printUninstallResult(result, silent);
+        return result;
+    }
+    const cleaned = existing.replace(makeCfBlockRegex(), '');
+    const meaningfulLines = countMeaningfulLines(cleaned);
+    let result;
+    if (meaningfulLines === 0) {
+        // No user-owned logic remains — remove the whole file
+        fs.unlinkSync(hookPath);
+        result = { action: 'removed', hookPath, preservedUserContent: false };
+    }
+    else {
+        // Keep the file with user content intact
+        fs.writeFileSync(hookPath, cleaned.trimEnd() + '\n', 'utf-8');
+        result = { action: 'removed', hookPath, preservedUserContent: true };
+    }
+    printUninstallResult(result, silent);
+    return result;
+}
+/**
+ * Return the current state of the post-commit hook without modifying anything.
+ *
+ * Used by `cf knowledge hook-status` to display a quick diagnostic.
+ */
+export function getHookStatus(projectRoot = process.cwd()) {
+    const gitDir = resolveGitDir(projectRoot);
+    if (!gitDir) {
+        return {
+            installed: false,
+            hookPath: null,
+            isGitRepo: false,
+            cfSectionPresent: false,
+            userHasOwnHook: false,
+        };
+    }
+    const hookPath = path.join(gitDir, 'hooks', 'post-commit');
+    if (!fs.existsSync(hookPath)) {
+        return {
+            installed: false,
+            hookPath,
+            isGitRepo: true,
+            cfSectionPresent: false,
+            userHasOwnHook: false,
+        };
+    }
+    const content = fs.readFileSync(hookPath, 'utf-8');
+    const cfSectionPresent = content.includes(K.CF_HOOK_MARKER);
+    // Check whether the file has user-owned logic beyond the cf section
+    const cleanedOfCf = content.replace(new RegExp(`${escapeRegex(K.CF_HOOK_MARKER)}[\\s\\S]*?${escapeRegex(K.CF_HOOK_END)}`, 'g'), '');
+    const userHasOwnHook = countMeaningfulLines(cleanedOfCf) > 0;
+    return {
+        installed: cfSectionPresent,
+        hookPath,
+        isGitRepo: true,
+        cfSectionPresent,
+        userHasOwnHook,
+    };
+}
+//# sourceMappingURL=git-hooks.js.map

package/dist/knowledge/git-hooks.js.map

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

package/dist/knowledge/module-hash.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @file module-hash.ts
+ * Compute a deterministic content fingerprint for a single KB module.
+ *
+ * Used by `buildKnowledge` (builder.ts) to short-circuit AI compilation when
+ * a module's source content has not changed since the last build.
+ *
+ * ── Hash input面 = AI prompt 输入面 ────────────────────────────────────────
+ * The set of files this module hashes MUST match what `readModuleFiles` in
+ * builder.ts feeds to the AI prompt:
+ *   - recursive walk under `src/<module>/`
+ *   - include  : `*.ts`
+ *   - exclude  : `*.test.ts`, `*.d.ts`, `node_modules/`, dot-directories
+ *
+ * If you change `readModuleFiles`'s filter, mirror the change here or the
+ * cache will give stale hits (or miss too aggressively).
+ *
+ * ── Known limitations (v9.1) ───────────────────────────────────────────────
+ *   - Changes to `prompt.ts` are NOT detected. If you alter the prompt
+ *     template, run `cf knowledge build --apply --force` to bypass the cache.
+ *   - Cross-module dependencies are NOT tracked. Module A may reference
+ *     symbols from module B; if B changes, A's KB page is not invalidated.
+ *     Workaround: `--force`.
+ */
+import type { KBMeta } from './types.js';
+/** Length of the truncated SHA-256 hex digest stored in `KBMeta.pages[*].source_hash`. */
+export declare const MODULE_HASH_LENGTH = 12;
+interface CollectedFile {
+    /** POSIX-style path relative to `moduleDir` (e.g. `handlers/tool-use.ts`). */
+    relPath: string;
+    /** UTF-8 file contents. */
+    content: string;
+}
+/**
+ * Compute a content fingerprint for a single KB module.
+ *
+ * Algorithm:
+ *   1. Collect every `.ts` source file under `moduleDir` matching the
+ *      AI-prompt input filter (see file header).
+ *   2. For each file, compute `sha256("<relPath>|<content>")`.
+ *   3. Sort the per-file digests by relPath (stable across OS readdir order).
+ *   4. Hash `digests.join('\n')` and truncate to `MODULE_HASH_LENGTH`.
+ *
+ * Determinism is the entire point — same bytes => same hash on any OS.
+ */
+export declare function computeModuleHash(moduleDir: string): Promise<string>;
+/**
+ * Recursively gather `.ts` source files under `moduleDir`.
+ *
+ * Exported for tests only — production code should call `computeModuleHash`.
+ *
+ * @internal
+ */
+export declare function collectModuleFiles(moduleDir: string): Promise<CollectedFile[]>;
+/**
+ * Compute a content fingerprint covering the full set of module hashes (and
+ * optionally the tech-stack-related config files).
+ *
+ * Algorithm:
+ *   1. Sort moduleHashes entries by name (stable, OS-independent ordering).
+ *   2. Build lines `<name>|<hash>`; for each provided configFile append a line
+ *      `__<tag>|<sha256short>`.
+ *   3. SHA-256 over `lines.join('\n')` truncated to `MODULE_HASH_LENGTH`.
+ *
+ * Used by `compileCrossModulePages` to detect whether the cross-module pages
+ * (`overview.md`, `architecture.md`, `decisions.md`, `glossary.md`,
+ * `tech-stack.md`) need rebuilding. Any module hash change OR any config file
+ * change → cross hash changes → all 5 pages re-compile.
+ *
+ * @param moduleHashes Map of `modules/<name>.md` → `source_hash`.
+ * @param configFiles  Optional raw contents of `package.json`, `tsconfig.json`,
+ *                     `vitest.config.ts`. Each is hashed with sha256 and the
+ *                     first 12 hex chars are folded into the cross hash.
+ */
+export declare function computeCrossModuleHash(moduleHashes: Map<string, string>, configFiles?: {
+    packageJson?: string;
+    tsconfig?: string;
+    vitest?: string;
+}): string;
+/**
+ * Read `.forge-knowledge/.meta.json` if present, returning `null` on any error
+ * (missing file, malformed JSON, IO failure).
+ *
+ * Used by builder.ts to look up the previous build's per-module hashes.
+ */
+export declare function loadKBMetaSafe(projectRoot: string): KBMeta | null;
+export {};
+//# sourceMappingURL=module-hash.d.ts.map

package/dist/knowledge/module-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-hash.d.ts","sourceRoot":"","sources":["../../src/knowledge/module-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,UAAU,aAAa;IACrB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY1E;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA0CpF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,WAAW,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,MAAM,CAgBR;AAOD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAejE"}

package/dist/knowledge/module-hash.js

@@ -0,0 +1,162 @@
+/**
+ * @file module-hash.ts
+ * Compute a deterministic content fingerprint for a single KB module.
+ *
+ * Used by `buildKnowledge` (builder.ts) to short-circuit AI compilation when
+ * a module's source content has not changed since the last build.
+ *
+ * ── Hash input面 = AI prompt 输入面 ────────────────────────────────────────
+ * The set of files this module hashes MUST match what `readModuleFiles` in
+ * builder.ts feeds to the AI prompt:
+ *   - recursive walk under `src/<module>/`
+ *   - include  : `*.ts`
+ *   - exclude  : `*.test.ts`, `*.d.ts`, `node_modules/`, dot-directories
+ *
+ * If you change `readModuleFiles`'s filter, mirror the change here or the
+ * cache will give stale hits (or miss too aggressively).
+ *
+ * ── Known limitations (v9.1) ───────────────────────────────────────────────
+ *   - Changes to `prompt.ts` are NOT detected. If you alter the prompt
+ *     template, run `cf knowledge build --apply --force` to bypass the cache.
+ *   - Cross-module dependencies are NOT tracked. Module A may reference
+ *     symbols from module B; if B changes, A's KB page is not invalidated.
+ *     Workaround: `--force`.
+ */
+import { createHash } from 'node:crypto';
+import { promises as fs, readFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import * as K from './constants.js';
+/** Length of the truncated SHA-256 hex digest stored in `KBMeta.pages[*].source_hash`. */
+export const MODULE_HASH_LENGTH = 12;
+/**
+ * Compute a content fingerprint for a single KB module.
+ *
+ * Algorithm:
+ *   1. Collect every `.ts` source file under `moduleDir` matching the
+ *      AI-prompt input filter (see file header).
+ *   2. For each file, compute `sha256("<relPath>|<content>")`.
+ *   3. Sort the per-file digests by relPath (stable across OS readdir order).
+ *   4. Hash `digests.join('\n')` and truncate to `MODULE_HASH_LENGTH`.
+ *
+ * Determinism is the entire point — same bytes => same hash on any OS.
+ */
+export async function computeModuleHash(moduleDir) {
+    const files = await collectModuleFiles(moduleDir);
+    files.sort((a, b) => (a.relPath < b.relPath ? -1 : a.relPath > b.relPath ? 1 : 0));
+    const perFileHashes = files.map((f) => createHash('sha256').update(`${f.relPath}|${f.content}`).digest('hex'));
+    return createHash('sha256')
+        .update(perFileHashes.join('\n'))
+        .digest('hex')
+        .slice(0, MODULE_HASH_LENGTH);
+}
+/**
+ * Recursively gather `.ts` source files under `moduleDir`.
+ *
+ * Exported for tests only — production code should call `computeModuleHash`.
+ *
+ * @internal
+ */
+export async function collectModuleFiles(moduleDir) {
+    const out = [];
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = (await fs.readdir(dir, { withFileTypes: true }));
+        }
+        catch {
+            // Directory does not exist or is unreadable — treat as empty.
+            return;
+        }
+        for (const e of entries) {
+            const name = e.name;
+            const full = path.join(dir, name);
+            if (e.isDirectory()) {
+                if (name === 'node_modules' || name.startsWith('.'))
+                    continue;
+                await walk(full);
+            }
+            else if (e.isFile() &&
+                name.endsWith('.ts') &&
+                !name.endsWith('.test.ts') &&
+                !name.endsWith('.d.ts')) {
+                let content;
+                try {
+                    content = await fs.readFile(full, 'utf-8');
+                }
+                catch {
+                    continue; // unreadable file — skip
+                }
+                // Force POSIX separators so Windows builds produce the same hash as
+                // macOS/Linux for the same logical layout.
+                const relPath = path.relative(moduleDir, full).split(path.sep).join('/');
+                out.push({ relPath, content });
+            }
+        }
+    }
+    await walk(moduleDir);
+    return out;
+}
+/**
+ * Compute a content fingerprint covering the full set of module hashes (and
+ * optionally the tech-stack-related config files).
+ *
+ * Algorithm:
+ *   1. Sort moduleHashes entries by name (stable, OS-independent ordering).
+ *   2. Build lines `<name>|<hash>`; for each provided configFile append a line
+ *      `__<tag>|<sha256short>`.
+ *   3. SHA-256 over `lines.join('\n')` truncated to `MODULE_HASH_LENGTH`.
+ *
+ * Used by `compileCrossModulePages` to detect whether the cross-module pages
+ * (`overview.md`, `architecture.md`, `decisions.md`, `glossary.md`,
+ * `tech-stack.md`) need rebuilding. Any module hash change OR any config file
+ * change → cross hash changes → all 5 pages re-compile.
+ *
+ * @param moduleHashes Map of `modules/<name>.md` → `source_hash`.
+ * @param configFiles  Optional raw contents of `package.json`, `tsconfig.json`,
+ *                     `vitest.config.ts`. Each is hashed with sha256 and the
+ *                     first 12 hex chars are folded into the cross hash.
+ */
+export function computeCrossModuleHash(moduleHashes, configFiles) {
+    const sorted = [...moduleHashes.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+    const parts = sorted.map(([name, hash]) => `${name}|${hash}`);
+    if (configFiles) {
+        if (configFiles.packageJson)
+            parts.push(`__pkg|${sha256short(configFiles.packageJson)}`);
+        if (configFiles.tsconfig)
+            parts.push(`__tsc|${sha256short(configFiles.tsconfig)}`);
+        if (configFiles.vitest)
+            parts.push(`__vit|${sha256short(configFiles.vitest)}`);
+    }
+    return createHash('sha256')
+        .update(parts.join('\n'))
+        .digest('hex')
+        .slice(0, MODULE_HASH_LENGTH);
+}
+/** Short SHA-256 (12 hex chars) of an arbitrary string. Internal to cross-module hash. */
+function sha256short(input) {
+    return createHash('sha256').update(input).digest('hex').slice(0, MODULE_HASH_LENGTH);
+}
+/**
+ * Read `.forge-knowledge/.meta.json` if present, returning `null` on any error
+ * (missing file, malformed JSON, IO failure).
+ *
+ * Used by builder.ts to look up the previous build's per-module hashes.
+ */
+export function loadKBMetaSafe(projectRoot) {
+    const metaPath = path.join(projectRoot, K.KB_DIRNAME, K.KB_META_FILE);
+    if (!existsSync(metaPath))
+        return null;
+    try {
+        const raw = readFileSync(metaPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        // Minimal structural check — we only need .pages for cache lookup.
+        if (!parsed || typeof parsed !== 'object' || typeof parsed.pages !== 'object') {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=module-hash.js.map

package/dist/knowledge/module-hash.js.map

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