@winspan/claude-forge 8.54.4 → 9.12.0

package/dist/knowledge/tools/knowledge-get-page.js.map

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

package/dist/knowledge/tools/knowledge-query.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @file knowledge-query.ts
+ * MCP tool: `knowledge_query`
+ *
+ * Wrap `queryKnowledge` from `../query.ts` with an MCP-friendly contract:
+ *   - Structured input parameters with sensible defaults
+ *   - Friendly degradation when KB is not built (`ok: true, pages: [], kb_not_built: true`)
+ *   - Preview truncation when `include_content` is false
+ *
+ * See `docs/design/2026-05-19/1100-knowledge-mcp-tools-spec.md` §2.1.
+ */
+import type { RepoMapSymbol } from '../repo-map.js';
+import type { SQLiteStorage } from '../../core/storage/sqlite.js';
+export interface KnowledgeQueryParams {
+    /** Free-text query (min 1 char). */
+    query: string;
+    /** Max number of page hits to return (1-10, default 3). */
+    max_results?: number;
+    /** Whether to also return repo-map symbol hits (default true). */
+    include_repo_map?: boolean;
+    /** Whether to return full markdown content (default false; only preview is returned). */
+    include_content?: boolean;
+}
+export interface KnowledgeQueryPageHit {
+    name: string;
+    title: string;
+    score: number;
+    matched_keywords: string[];
+    matched_in: ('title' | 'content' | 'refs')[];
+    /** Page kind: 'module' (modules/X.md) or 'cross' (root-level cross-module page). */
+    kind: 'module' | 'cross';
+    /** First ~500 chars of markdown. Present when `include_content=false`. */
+    preview?: string;
+    /** Full markdown. Present when `include_content=true`. */
+    content?: string;
+    refs_count: number;
+    generated_at: string;
+    source_hash: string;
+}
+export interface KnowledgeQueryResult {
+    ok: true;
+    query: string;
+    total_pages_scanned: number;
+    pages: KnowledgeQueryPageHit[];
+    /** Present when `include_repo_map=true` and at least one symbol matched. */
+    repo_map_hits?: RepoMapSymbol[];
+    /** Present only when KB is not built. */
+    kb_not_built?: true;
+    /** Free-text hint accompanying `kb_not_built` or no-token situations. */
+    hint?: string;
+    /** Free-text note used when the query tokenises to nothing. */
+    note?: string;
+}
+/** Optional execution context (forward-compatible with future storage / session needs). */
+export interface KnowledgeQueryContext {
+    projectRoot?: string;
+    sessionId?: string;
+    /**
+     * Optional storage handle for telemetry (v9.5+).
+     *
+     * When supplied, the inner `queryKnowledge` call appends a row to
+     * `kb_query_log`. MCP wrapper passes it through (since v0 P0 fix); other
+     * callers (daemon-internal / unit tests) may omit it. Failures swallowed
+     * fail-silent — telemetry MUST NEVER break the query.
+     */
+    storage?: SQLiteStorage;
+}
+/**
+ * Run a keyword search against the local KB.
+ *
+ * Returns `ok: true` even when the KB is missing or nothing matched — callers
+ * should treat empty `pages` as a normal outcome, not an error.
+ *
+ * @throws when the underlying file IO blows up (rare; caught by the MCP layer).
+ */
+export declare function knowledgeQuery(params: KnowledgeQueryParams, context?: KnowledgeQueryContext): Promise<KnowledgeQueryResult>;
+//# sourceMappingURL=knowledge-query.d.ts.map

package/dist/knowledge/tools/knowledge-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-query.d.ts","sourceRoot":"","sources":["../../../src/knowledge/tools/knowledge-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AASlE,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IAEd,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,yFAAyF;IACzF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,CAAC,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC;IAC7C,oFAAoF;IACpF,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;IAChC,yCAAyC;IACzC,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAMD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAmF/B"}

package/dist/knowledge/tools/knowledge-query.js

@@ -0,0 +1,104 @@
+/**
+ * @file knowledge-query.ts
+ * MCP tool: `knowledge_query`
+ *
+ * Wrap `queryKnowledge` from `../query.ts` with an MCP-friendly contract:
+ *   - Structured input parameters with sensible defaults
+ *   - Friendly degradation when KB is not built (`ok: true, pages: [], kb_not_built: true`)
+ *   - Preview truncation when `include_content` is false
+ *
+ * See `docs/design/2026-05-19/1100-knowledge-mcp-tools-spec.md` §2.1.
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+import { queryKnowledge } from '../query.js';
+import * as K from '../constants.js';
+import { logger } from '../../core/utils/logger.js';
+/** Length of the page-preview snippet returned when `include_content=false`. */
+const PREVIEW_BYTES = 500;
+// ─────────────────────────────────────────────────────────────────────────────
+// Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Run a keyword search against the local KB.
+ *
+ * Returns `ok: true` even when the KB is missing or nothing matched — callers
+ * should treat empty `pages` as a normal outcome, not an error.
+ *
+ * @throws when the underlying file IO blows up (rare; caught by the MCP layer).
+ */
+export async function knowledgeQuery(params, context = {}) {
+    const projectRoot = context.projectRoot ?? process.cwd();
+    const kbDir = path.join(projectRoot, K.KB_DIRNAME);
+    const maxResults = params.max_results ?? 3;
+    const includeRepoMap = params.include_repo_map !== false; // default true
+    const includeContent = params.include_content === true; // default false
+    logger.info(`[knowledge_query] query="${params.query}" max=${maxResults} repo_map=${includeRepoMap} content=${includeContent}` +
+        (context.sessionId ? ` session=${context.sessionId}` : ''));
+    // ── Friendly degradation when KB is not built ──────────────────────────────
+    if (!fs.existsSync(kbDir)) {
+        return {
+            ok: true,
+            query: params.query,
+            total_pages_scanned: 0,
+            pages: [],
+            kb_not_built: true,
+            hint: 'Knowledge base not built. Run: cf knowledge build --apply',
+        };
+    }
+    const inner = await queryKnowledge(params.query, {
+        projectRoot,
+        maxResults,
+        includeRepoMap,
+        storage: context.storage,
+    });
+    // ── Tokeniser yielded nothing (e.g. only stop-words) ───────────────────────
+    if (inner.pages.length === 0 && inner.total_pages_scanned > 0) {
+        // Distinguish "nothing matched" (still ok) from "no tokens at all".
+        // We can't tell here whether tokenisation succeeded; but since `pages=[]`
+        // and total_pages_scanned > 0 is a normal "no hits" outcome, we only add
+        // a hint if the raw query collapses to all-whitespace / single-char.
+        const trimmed = params.query.trim();
+        if (trimmed.length < 2) {
+            return {
+                ok: true,
+                query: params.query,
+                total_pages_scanned: inner.total_pages_scanned,
+                pages: [],
+                note: 'query yielded no tokens (too short or all stop-words)',
+            };
+        }
+    }
+    // ── Shape page hits ────────────────────────────────────────────────────────
+    const pages = inner.pages.map((hit) => {
+        const base = {
+            name: hit.page.name,
+            title: hit.page.title,
+            score: hit.score,
+            matched_keywords: hit.matched_keywords,
+            matched_in: hit.matched_in,
+            kind: hit.page.name.includes('/') ? 'module' : 'cross',
+            refs_count: hit.page.refs.length,
+            generated_at: hit.page.generated_at,
+            source_hash: hit.page.source_hash,
+        };
+        if (includeContent) {
+            base.content = hit.page.content;
+        }
+        else {
+            base.preview = hit.page.content.slice(0, PREVIEW_BYTES);
+        }
+        return base;
+    });
+    const result = {
+        ok: true,
+        query: params.query,
+        total_pages_scanned: inner.total_pages_scanned,
+        pages,
+    };
+    if (includeRepoMap && inner.repo_map_hits && inner.repo_map_hits.length > 0) {
+        result.repo_map_hits = inner.repo_map_hits;
+    }
+    return result;
+}
+//# sourceMappingURL=knowledge-query.js.map

package/dist/knowledge/tools/knowledge-query.js.map

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

package/dist/knowledge/tools/repo-map-lookup.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @file repo-map-lookup.ts
+ * MCP tool: `repo_map_lookup`
+ *
+ * Look up repo-map symbols by exact name, substring, or module prefix.
+ *
+ * See spec §2.3.
+ */
+import { type RepoMapSymbol, type RepoMapSymbolKind } from '../repo-map.js';
+export interface RepoMapLookupParams {
+    /** Exact symbol name (e.g. "SocketServer.start"). */
+    symbol?: string;
+    /** Case-insensitive substring of symbol name. */
+    symbol_contains?: string;
+    /** `src/<module>/` prefix filter (e.g. "daemon"). */
+    module?: string;
+    /** Restrict to a specific symbol kind. */
+    kind?: RepoMapSymbolKind;
+    /** Max results (1-50, default 20). */
+    max_results?: number;
+}
+export type RepoMapLookupMode = 'symbol_exact' | 'symbol_contains' | 'module';
+export type RepoMapLookupResult = {
+    ok: true;
+    mode: RepoMapLookupMode;
+    total: number;
+    truncated: boolean;
+    symbols: RepoMapSymbol[];
+    repo_map_meta: {
+        generated_at: string;
+        source_hash: string;
+        file_count: number;
+        symbol_count: number;
+    };
+} | {
+    ok: false;
+    error: 'repo_map_not_built' | 'invalid_params';
+    hint?: string;
+};
+export interface RepoMapLookupContext {
+    projectRoot?: string;
+    sessionId?: string;
+}
+export declare function repoMapLookup(params: RepoMapLookupParams, context?: RepoMapLookupContext): Promise<RepoMapLookupResult>;
+//# sourceMappingURL=repo-map-lookup.d.ts.map

package/dist/knowledge/tools/repo-map-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-map-lookup.d.ts","sourceRoot":"","sources":["../../../src/knowledge/tools/repo-map-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAUxB,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAE9E,MAAM,MAAM,mBAAmB,GAC3B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,aAAa,EAAE;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,oBAAoB,GAAG,gBAAgB,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAkE9B"}

package/dist/knowledge/tools/repo-map-lookup.js

@@ -0,0 +1,82 @@
+/**
+ * @file repo-map-lookup.ts
+ * MCP tool: `repo_map_lookup`
+ *
+ * Look up repo-map symbols by exact name, substring, or module prefix.
+ *
+ * See spec §2.3.
+ */
+import path from 'node:path';
+import { loadRepoMap, lookupSymbol, filterByModule, } from '../repo-map.js';
+import * as K from '../constants.js';
+import { logger } from '../../core/utils/logger.js';
+const DEFAULT_MAX_RESULTS = 20;
+// ─────────────────────────────────────────────────────────────────────────────
+// Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+export async function repoMapLookup(params, context = {}) {
+    const projectRoot = context.projectRoot ?? process.cwd();
+    const kbDir = path.join(projectRoot, K.KB_DIRNAME);
+    const maxResults = params.max_results ?? DEFAULT_MAX_RESULTS;
+    logger.info(`[repo_map_lookup] symbol="${params.symbol ?? ''}" contains="${params.symbol_contains ?? ''}" module="${params.module ?? ''}" kind=${params.kind ?? '-'} max=${maxResults}` +
+        (context.sessionId ? ` session=${context.sessionId}` : ''));
+    // ── At-least-one-query-param guard (also enforced by zod refine at MCP layer)
+    if (!params.symbol && !params.symbol_contains && !params.module) {
+        return {
+            ok: false,
+            error: 'invalid_params',
+            hint: 'Provide at least one of symbol / symbol_contains / module',
+        };
+    }
+    const repoMap = loadRepoMap(kbDir);
+    if (!repoMap) {
+        return {
+            ok: false,
+            error: 'repo_map_not_built',
+            hint: 'Run: cf knowledge build --apply',
+        };
+    }
+    // ── Decide mode (priority: symbol > symbol_contains > module) ─────────────
+    let mode;
+    let candidates;
+    if (params.symbol) {
+        mode = 'symbol_exact';
+        const hit = lookupSymbol(repoMap, params.symbol);
+        candidates = hit ? [hit] : [];
+    }
+    else if (params.symbol_contains) {
+        mode = 'symbol_contains';
+        const needle = params.symbol_contains.toLowerCase();
+        candidates = repoMap.symbols.filter((s) => s.name.toLowerCase().includes(needle));
+    }
+    else {
+        // module
+        mode = 'module';
+        candidates = filterByModule(repoMap, params.module);
+    }
+    // ── Optional kind filter ──────────────────────────────────────────────────
+    if (params.kind) {
+        candidates = candidates.filter((s) => s.kind === params.kind);
+    }
+    // ── Truncate ──────────────────────────────────────────────────────────────
+    const totalBeforeTruncate = candidates.length;
+    const symbols = candidates.slice(0, maxResults);
+    const truncated = totalBeforeTruncate > symbols.length;
+    return {
+        ok: true,
+        mode,
+        total: totalBeforeTruncate,
+        truncated,
+        symbols,
+        repo_map_meta: extractMeta(repoMap),
+    };
+}
+function extractMeta(repoMap) {
+    return {
+        generated_at: repoMap.generated_at,
+        source_hash: repoMap.source_hash,
+        file_count: repoMap.file_count,
+        symbol_count: repoMap.symbol_count,
+    };
+}
+//# sourceMappingURL=repo-map-lookup.js.map

package/dist/knowledge/tools/repo-map-lookup.js.map

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

package/dist/knowledge/types.d.ts

@@ -0,0 +1,269 @@
+/**
+ * @file types.ts
+ * Knowledge Base (KB) shared type definitions.
+ *
+ * Two-layer architecture:
+ *  - Static layer  → RepoMap / RepoMapSymbol  (TypeScript Compiler API)
+ *  - AI layer      → KBPage / KBMeta          (LLM-compiled markdown)
+ */
+/**
+ * A single symbol (class, function, method, etc.) extracted from the source
+ * tree by the TypeScript Compiler API.
+ *
+ * `file` is always relative to the project's `src/` directory so that paths
+ * remain portable across machines.
+ */
+export interface RepoMapSymbol {
+    /** File path relative to `src/` (e.g. `daemon/handlers/tool-use.ts`). */
+    file: string;
+    /** 1-based line number where the symbol declaration starts. */
+    line: number;
+    /** Symbol kind as recognised by the TypeScript Compiler API. */
+    kind: 'class' | 'function' | 'method' | 'interface' | 'type' | 'const' | 'enum';
+    /**
+     * Fully-qualified symbol name.
+     * Methods are written as `ClassName.methodName` (e.g. `SocketServer.start`).
+     */
+    name: string;
+    /** Complete type signature without the body (e.g. `function start(port: number): Promise<void>`). */
+    signature: string;
+    /** Whether the symbol carries an `export` modifier. */
+    exports: boolean;
+    /**
+     * Leading JSDoc comment, if present.
+     * Truncated to 200 characters to keep the repo-map compact.
+     */
+    docComment?: string;
+}
+/**
+ * The complete repo-map produced by a single static-analysis run.
+ *
+ * Stored as `.forge-knowledge/repo-map.json`.  A new map is generated
+ * whenever the git HEAD changes (detected via `source_hash`).
+ */
+export interface RepoMap {
+    /** Format version. */
+    version: '1.0';
+    /** ISO-8601 datetime when this map was generated. */
+    generated_at: string;
+    /** `git rev-parse --short HEAD` at generation time. */
+    source_hash: string;
+    /** All symbols found across the scanned files. */
+    symbols: RepoMapSymbol[];
+    /** Total number of source files scanned. */
+    file_count: number;
+    /** Total number of symbols extracted. */
+    symbol_count: number;
+}
+/**
+ * A source-code reference embedded inside a KB page.
+ *
+ * References anchor KB content to exact file locations so that staleness
+ * can be detected when the underlying code changes.
+ */
+export interface KBRef {
+    /** File path relative to project root (e.g. `src/daemon/server.ts`). */
+    file: string;
+    /** 1-based starting line number. */
+    lineStart: number;
+    /** 1-based ending line number (inclusive), if the reference spans a range. */
+    lineEnd?: number;
+    /**
+     * Qualified symbol name at this location (e.g. `SocketServer.start`).
+     * Populated when the reference was resolved against the repo-map.
+     */
+    symbol?: string;
+}
+/**
+ * A single AI-compiled knowledge page.
+ *
+ * Pages live under `.forge-knowledge/modules/<name>` or as root pages
+ * like `.forge-knowledge/overview.md`.
+ *
+ * The `name` field doubles as the page's unique key and its relative path
+ * within `.forge-knowledge/` (e.g. `modules/daemon.md`).
+ */
+export interface KBPage {
+    /** Relative path within `.forge-knowledge/` (e.g. `modules/daemon.md`). */
+    name: string;
+    /** Human-readable page title (e.g. `Daemon Module`). */
+    title: string;
+    /** Full page content as markdown. */
+    content: string;
+    /** Source-code references cited in the content. */
+    refs: KBRef[];
+    /** ISO-8601 datetime when this page was generated. */
+    generated_at: string;
+    /** `git rev-parse --short HEAD` when this page was generated. */
+    source_hash: string;
+    /** Identifier of the AI model that compiled this page (e.g. `claude-sonnet-4-6`). */
+    ai_model?: string;
+    /**
+     * Audit status of this page against the current source tree.
+     * - `ok`    – all refs resolve and line-content matches.
+     * - `stale` – one or more refs have drifted or the source hash differs.
+     * - `error` – page file is unreadable or structurally invalid.
+     */
+    audit_status?: 'ok' | 'stale' | 'error';
+}
+/**
+ * Top-level metadata file stored at `.forge-knowledge/.meta.json`.
+ *
+ * Acts as an index over all KB pages so that staleness checks and incremental
+ * rebuilds can be performed without reading every page file.
+ */
+export interface KBMeta {
+    /** Format version. */
+    version: '1.0';
+    /** ISO-8601 datetime when this metadata was last written. */
+    generated_at: string;
+    /** `git rev-parse --short HEAD` at the time of the last full build. */
+    source_hash: string;
+    /**
+     * Per-page metadata keyed by the page's `name` field
+     * (e.g. `"modules/daemon.md"`).
+     */
+    pages: Record<string, {
+        /** Source files that were fed to the AI when compiling this page. */
+        source_files: string[];
+        /**
+         * Module content fingerprint at page-generation time.
+         *
+         * v9.1+: SHA-256 (truncated 12 chars) of the module's source files —
+         * computed by `computeModuleHash` in module-hash.ts. Drives the
+         * incremental-build cache: a matching hash means the module's source
+         * has not changed and AI compilation can be skipped.
+         *
+         * v9.0 legacy values are git short hashes (`git rev-parse --short HEAD`);
+         * they will never match a v9.1+ content hash, triggering a one-time
+         * full rebuild on first upgrade. This is the expected migration path.
+         *
+         * Special sentinels:
+         *   - `'unknown'`     — page compiled but AI returned no usable output
+         *                       (transient; overwritten by writeMetadata's
+         *                       failure-protection branch).
+         *   - `'build-failed'` — AI compilation failed AND no prior hash was
+         *                        available; guarantees the next build retries.
+         */
+        source_hash: string;
+        /** AI model identifier used to compile this page. */
+        ai_model: string;
+        /** Number of `KBRef` entries in the page. */
+        refs_count: number;
+        /** Audit status as of the last `cf kb audit` run. */
+        audit_status: 'ok' | 'stale' | 'error';
+    }>;
+}
+/** Severity level for a validation diagnostic. */
+export type ValidationSeverity = 'error' | 'warn' | 'info';
+/**
+ * A single diagnostic issue produced by reference validation.
+ */
+export interface ValidationIssue {
+    /** Issue severity. */
+    severity: ValidationSeverity;
+    /** Human-readable description of the issue. */
+    msg: string;
+    /**
+     * Zero-based index into `KBPage.refs` that triggered this issue.
+     * Absent for page-level (non-ref) diagnostics.
+     */
+    refIndex?: number;
+    /** Source file path implicated in the issue, if applicable. */
+    file?: string;
+    /** Line number implicated in the issue, if applicable. */
+    line?: number;
+}
+/**
+ * The aggregated result of validating all `KBRef` entries in a single page.
+ */
+export interface ValidationResult {
+    /** `true` when no `error`-severity issues were found. */
+    valid: boolean;
+    /** All issues discovered during validation, sorted by severity. */
+    issues: ValidationIssue[];
+    /** Total number of refs examined. */
+    refsTotal: number;
+    /** Number of refs that resolved cleanly. */
+    refsValid: number;
+}
+/**
+ * The full report produced by `cf kb build`.
+ *
+ * In `dry-run` mode the report is written to
+ * `~/.claude-forge/knowledge-build-report.md` but no page files are touched.
+ * In `apply` mode the pages are written to `.forge-knowledge/` and the report
+ * is also persisted for auditing.
+ */
+export interface BuildReport {
+    /** Whether the build was a preview or a live run. */
+    mode: 'dry-run' | 'apply';
+    /** ISO-8601 datetime when the build ran. */
+    generated_at: string;
+    /** AI model used to compile pages. */
+    ai_model: string;
+    /** Per-page results. */
+    pages: Array<{
+        /** Page name (same as `KBPage.name`). */
+        name: string;
+        /** The compiled page content and metadata. */
+        page: KBPage;
+        /** Reference-validation result for this page. */
+        validation: ValidationResult;
+        /**
+         * `true` when validation passed and the page is safe to write to disk.
+         * Always `false` in `dry-run` mode.
+         */
+        ready_to_apply: boolean;
+    }>;
+    /** Total number of pages processed. */
+    total_pages: number;
+    /** Total number of refs across all pages. */
+    total_refs: number;
+    /** Total number of validation issues (all severities). */
+    total_issues: number;
+}
+/**
+ * The result returned by a KB query (used by `cf kb query` and the spawn-agent
+ * context-injection path).
+ */
+export interface QueryResult {
+    /** KB pages that matched the query. */
+    pages: KBPage[];
+    /**
+     * Repo-map symbols that matched the query terms (populated when the static
+     * layer is also searched).
+     */
+    repo_map_hits?: RepoMapSymbol[];
+    /** The original query string. */
+    query: string;
+    /**
+     * Strategy used to match results.
+     * - `keyword`   – simple full-text substring match.
+     * - `pageindex` – page-name / title index lookup.
+     * - `hybrid`    – combined keyword + pageindex.
+     */
+    match_strategy: 'keyword' | 'pageindex' | 'hybrid';
+}
+/**
+ * The result returned after attempting to install the `post-commit` git hook
+ * for automatic KB staleness marking.
+ */
+export interface GitHookInstallResult {
+    /**
+     * What action was taken:
+     * - `created`            – hook file did not exist; a new file was created.
+     * - `appended`           – hook file existed; our snippet was appended.
+     * - `already-installed`  – our marker was already present; nothing changed.
+     * - `skipped-non-git`    – the current directory is not a git repository.
+     */
+    action: 'created' | 'appended' | 'already-installed' | 'skipped-non-git';
+    /** Absolute path to the hook file. */
+    hookPath: string;
+    /**
+     * `true` when an existing user hook was detected and preserved (hook was
+     * appended rather than overwritten).
+     */
+    preserved_user_hook?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/knowledge/types.d.ts.map

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

package/dist/knowledge/types.js

@@ -0,0 +1,10 @@
+/**
+ * @file types.ts
+ * Knowledge Base (KB) shared type definitions.
+ *
+ * Two-layer architecture:
+ *  - Static layer  → RepoMap / RepoMapSymbol  (TypeScript Compiler API)
+ *  - AI layer      → KBPage / KBMeta          (LLM-compiled markdown)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/knowledge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}