@seanhogg/builderforce-memory 2026.10.27 → 2026.10.29

package/dist/knowledge/partitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitions.js","sourceRoot":"","sources":["../../src/knowledge/partitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACrC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACtB,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;gBACvC,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;gBACrC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC;;gBAAM,EAAE,IAAI,OAAO,CAAC;QACzB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG;YAAE,EAAE,IAAI,MAAM,CAAC;aAC/B,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACnC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAAC,EAAE,IAAI,KAAK,CAAC;gBAAC,SAAS;YAAC,CAAC;YACzC,EAAE,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAC3E,CAAC,GAAG,KAAK,CAAC;QACd,CAAC;;YAAM,EAAE,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9B,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACvB,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAY;IAChD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAsB;IAC5D,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAAE,SAAS;QAC1D,IAAI,IAAI,CAAC,EAAE,KAAK,gBAAgB;YAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,GAAsB;IAC7D,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,gBAAgB,CAAC,CAAC;IAC9G,OAAO,IAAI,EAAE,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAwB,EAAE,EAAsB,EAAE,GAAsB;IAC9F,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3E,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC;IAC/B,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IACpD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC7F,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAmB,EAAE,QAAkB;IAClE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC9F,MAAM,IAAI,GAAG,CAAC,GAAW,EAAS,EAAE,GAAG,MAAM,IAAI,SAAS,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACxF,MAAM,CAAC,GAAG,QAAmC,CAAC;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAAE,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAqB,CAAC,CAAC,YAAY,CAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC9E,MAAM,CAAC,GAAG,GAAqC,CAAC;QAChD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;QAC5E,IAAI,OAAO,CAAE,CAAC,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAE,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,cAAc,CAAC,iCAAiC,CAAC,CAAC;QACtG,IAAI,OAAO,CAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC;YAAE,IAAI,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAC;QACtH,MAAM,KAAK,GAAG,CAAE,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC;YAC3E,IAAI,CAAC,cAAc,CAAC,mCAAmC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,CAAE,CAAC,IAAI,CAAW,EAAE,KAAK,EAAE,CAAE,CAAC,OAAO,CAAW,EAAE,KAAK,EAAE,CAAC,GAAI,KAAkB,CAAC,EAAE,CAAC;IACrG,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjD,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC,MAAM;QAAE,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACzE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5B,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC5G,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAmC,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,SAAS,IAAI,6BAA6B,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,IAAI,CAAC,SAAS,IAAI,gCAAgC,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAI,EAAe,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/dist/knowledge/plan.d.ts

@@ -0,0 +1,33 @@
+/**
+ * knowledge/plan.ts — `planReview`: the confirm chip's numbers (PRD 38 §4.3).
+ *
+ * A walk plus a manifest diff by hash, nothing more: a file whose hash is unchanged is
+ * never read. The only reads are the ignore files (`.gitignore`, `.builderforce/ignore`)
+ * when the listing has them. Binary files (by extension), oversized files and files no
+ * pack accepts are skipped with a reason.
+ */
+import type { IngestManifest } from '../ingest/types.js';
+import type { DirectorySource, KnowledgePack, ReviewPlan } from './model.js';
+/** ≈ bytes per judged section, for the estimate (the plan does not read changed files). */
+export declare const AVG_SECTION_BYTES = 1500;
+export interface PlanOptions {
+    /** Per-file size cap in bytes. Default 2 MB. */
+    maxFileBytes?: number;
+}
+export interface PlannedFile {
+    path: string;
+    hash: string;
+    size: number;
+    pack: string;
+    changed: boolean;
+}
+export interface PlanDetail {
+    plan: ReviewPlan;
+    /** Every included file (changed and unchanged), sorted by path. */
+    files: PlannedFile[];
+    /** The manifest's prior `path → hash`. */
+    prior: Map<string, string>;
+}
+export declare function planReview(source: DirectorySource, manifest: IngestManifest, packs: KnowledgePack[], opts?: PlanOptions): Promise<ReviewPlan>;
+export declare function planDetail(source: DirectorySource, manifest: IngestManifest, packs: readonly KnowledgePack[], opts?: PlanOptions): Promise<PlanDetail>;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/knowledge/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO7E,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAItC,MAAM,WAAW,WAAW;IACxB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,mEAAmE;IACnE,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,0CAA0C;IAC1C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,wBAAsB,UAAU,CAC5B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,aAAa,EAAE,EACtB,IAAI,GAAE,WAAgB,GACvB,OAAO,CAAC,UAAU,CAAC,CAErB;AAED,wBAAsB,UAAU,CAC5B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,IAAI,GAAE,WAAgB,GACvB,OAAO,CAAC,UAAU,CAAC,CAyDrB"}

package/dist/knowledge/plan.js

@@ -0,0 +1,89 @@
+/**
+ * knowledge/plan.ts — `planReview`: the confirm chip's numbers (PRD 38 §4.3).
+ *
+ * A walk plus a manifest diff by hash, nothing more: a file whose hash is unchanged is
+ * never read. The only reads are the ignore files (`.gitignore`, `.builderforce/ignore`)
+ * when the listing has them. Binary files (by extension), oversized files and files no
+ * pack accepts are skipped with a reason.
+ */
+import { composePacks, DEFAULT_MAX_FILE_BYTES, filesManifestKey, IGNORE_FILES, ignoreMatcher, isBinaryPath, manifestMap, stubSource, } from './sources.js';
+import { compareStr, sortBy } from './refs.js';
+/** ≈ bytes per judged section, for the estimate (the plan does not read changed files). */
+export const AVG_SECTION_BYTES = 1500;
+/** ≈ one compare call per this many judged sections when contradictions are asked for. */
+const SECTIONS_PER_COMPARE = 10;
+export async function planReview(source, manifest, packs, opts = {}) {
+    return (await planDetail(source, manifest, packs, opts)).plan;
+}
+export async function planDetail(source, manifest, packs, opts = {}) {
+    const maxBytes = opts.maxFileBytes ?? DEFAULT_MAX_FILE_BYTES;
+    const listed = [];
+    for await (const entry of source.list())
+        listed.push({ ...entry, path: entry.path.replace(/\\/g, '/').replace(/^\.?\//, '') });
+    const entries = sortBy(listed, (e) => e.path);
+    const ignoreTexts = [];
+    for (const name of IGNORE_FILES) {
+        if (!entries.some((e) => e.path === name))
+            continue;
+        const doc = await source.read(name);
+        if (doc.content.kind === 'text')
+            ignoreTexts.push(doc.content.text);
+    }
+    const ignored = ignoreMatcher(ignoreTexts);
+    const composed = composePacks(packs);
+    const prior = await manifestMap(manifest, filesManifestKey(source.rootId));
+    const packById = new Map(packs.map((p) => [p.id, p]));
+    const files = [];
+    const skipped = [];
+    const byPack = {};
+    let estimatedSections = 0;
+    let compareSections = 0;
+    for (const e of entries) {
+        if (ignored(e.path)) {
+            skipped.push({ path: e.path, reason: 'ignored' });
+            continue;
+        }
+        if (isBinaryPath(e.path)) {
+            skipped.push({ path: e.path, reason: 'binary' });
+            continue;
+        }
+        if (e.size > maxBytes) {
+            skipped.push({ path: e.path, reason: 'too-large' });
+            continue;
+        }
+        const hit = composed.resolve(stubSource(e.path));
+        if (!hit) {
+            skipped.push({ path: e.path, reason: 'no-pack' });
+            continue;
+        }
+        const changed = prior.get(e.path) !== e.hash;
+        files.push({ path: e.path, hash: e.hash, size: e.size, pack: hit.pack.id, changed });
+        byPack[hit.pack.id] = (byPack[hit.pack.id] ?? 0) + 1;
+        const spec = packById.get(hit.pack.id)?.judgement;
+        if (changed && spec && (spec.claims || spec.entities)) {
+            const sections = Math.max(1, Math.ceil(e.size / AVG_SECTION_BYTES));
+            estimatedSections += sections;
+            if (spec.contradictions)
+                compareSections += sections;
+        }
+    }
+    const present = new Set(entries.map((e) => e.path));
+    const removed = [...prior.keys()].filter((p) => !present.has(p)).sort(compareStr);
+    const changed = files.filter((f) => f.changed).map((f) => f.path);
+    const sortedByPack = Object.fromEntries(Object.keys(byPack).sort(compareStr).map((k) => [k, byPack[k]]));
+    return {
+        plan: {
+            rootId: source.rootId,
+            files: files.length,
+            byPack: sortedByPack,
+            unchanged: files.length - changed.length,
+            changed,
+            removed,
+            skipped,
+            estimatedModelCalls: estimatedSections + Math.ceil(compareSections / SECTIONS_PER_COMPARE),
+        },
+        files,
+        prior,
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/knowledge/plan.js.map

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

package/dist/knowledge/refs.d.ts

@@ -0,0 +1,40 @@
+/**
+ * knowledge/refs.ts — the NodeRef grammar and the deterministic primitives every
+ * knowledge module shares (ordering, canonical JSON, entity keys).
+ *
+ * Pure and import-free of `ingest` runtime code, so ingest's extractors can use it
+ * without an import cycle.
+ *
+ *   src:${rootId}::${path}            a source file (or an area: a directory path)
+ *   src:${rootId}::${path}#${slug}    a section of a source
+ *   ent:${pack}:${normalizedName}     an entity (also its project_facts key)
+ *   fact:${key}                       any other fact (claims: fact:claim:${hash})
+ */
+import type { NodeRef } from './model.js';
+/** Code-unit ordering — never `localeCompare`, whose result depends on the host's ICU. */
+export declare function compareStr(a: string, b: string): number;
+export declare function srcRef(rootId: string, path: string): NodeRef;
+/** The root-relative path of a `src:` ref (the section suffix dropped), else undefined. */
+export declare function pathOfRef(ref: string): string | undefined;
+/** The ref of the file a `src:` ref belongs to (itself for a file). */
+export declare function fileRefOf(ref: NodeRef): NodeRef;
+/** The node ref of a stored fact key: `ent:` keys are refs already; the rest are `fact:`. */
+export declare function factRef(key: string): NodeRef;
+/** The stored fact key of a fact/entity ref (inverse of {@link factRef}). */
+export declare function factKeyOf(ref: NodeRef): string | undefined;
+/**
+ * The normalized key of a name: NFKC, case-folded, punctuation stripped (dashes,
+ * underscores and slashes read as spaces so `run-store` and `run store` agree),
+ * whitespace collapsed.
+ */
+export declare function normalizeKey(name: string): string;
+/** A heading slug: the normalized key with spaces as dashes. */
+export declare function slugOf(text: string): string;
+export declare function basenameOf(path: string): string;
+/** Rounds to 6 decimals so floating noise never reaches the JSON. */
+export declare function round6(n: number): number;
+/** JSON with object keys sorted and `undefined` members dropped — the canonical form for digests. */
+export declare function canonicalJson(value: unknown): string;
+/** Sorts a copy by the given string keys, in order. */
+export declare function sortBy<T>(items: readonly T[], ...keys: Array<(t: T) => string>): T[];
+//# sourceMappingURL=refs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/knowledge/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOzD;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAG/C;AAED,6FAA6F;AAC7F,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAaD,uDAAuD;AACvD,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAQpF"}

package/dist/knowledge/refs.js

@@ -0,0 +1,102 @@
+/**
+ * knowledge/refs.ts — the NodeRef grammar and the deterministic primitives every
+ * knowledge module shares (ordering, canonical JSON, entity keys).
+ *
+ * Pure and import-free of `ingest` runtime code, so ingest's extractors can use it
+ * without an import cycle.
+ *
+ *   src:${rootId}::${path}            a source file (or an area: a directory path)
+ *   src:${rootId}::${path}#${slug}    a section of a source
+ *   ent:${pack}:${normalizedName}     an entity (also its project_facts key)
+ *   fact:${key}                       any other fact (claims: fact:claim:${hash})
+ */
+/** Code-unit ordering — never `localeCompare`, whose result depends on the host's ICU. */
+export function compareStr(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+export function srcRef(rootId, path) {
+    return `src:${rootId}::${path}`;
+}
+/** The root-relative path of a `src:` ref (the section suffix dropped), else undefined. */
+export function pathOfRef(ref) {
+    if (!ref.startsWith('src:'))
+        return undefined;
+    const at = ref.indexOf('::');
+    if (at < 0)
+        return undefined;
+    const rest = ref.slice(at + 2);
+    const hash = rest.indexOf('#');
+    return hash < 0 ? rest : rest.slice(0, hash);
+}
+/** The ref of the file a `src:` ref belongs to (itself for a file). */
+export function fileRefOf(ref) {
+    const hash = ref.startsWith('src:') ? ref.indexOf('#', ref.indexOf('::')) : -1;
+    return hash < 0 ? ref : ref.slice(0, hash);
+}
+/** The node ref of a stored fact key: `ent:` keys are refs already; the rest are `fact:`. */
+export function factRef(key) {
+    return key.startsWith('ent:') ? key : `fact:${key}`;
+}
+/** The stored fact key of a fact/entity ref (inverse of {@link factRef}). */
+export function factKeyOf(ref) {
+    if (ref.startsWith('ent:'))
+        return ref;
+    if (ref.startsWith('fact:'))
+        return ref.slice(5);
+    return undefined;
+}
+/**
+ * The normalized key of a name: NFKC, case-folded, punctuation stripped (dashes,
+ * underscores and slashes read as spaces so `run-store` and `run store` agree),
+ * whitespace collapsed.
+ */
+export function normalizeKey(name) {
+    return name
+        .normalize('NFKC')
+        .toLowerCase()
+        .replace(/[\p{Pd}\p{Pc}/\\]+/gu, ' ')
+        .replace(/[\p{P}\p{S}]+/gu, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** A heading slug: the normalized key with spaces as dashes. */
+export function slugOf(text) {
+    return normalizeKey(text).replace(/ /g, '-') || 'section';
+}
+export function basenameOf(path) {
+    const i = path.lastIndexOf('/');
+    return i < 0 ? path : path.slice(i + 1);
+}
+/** Rounds to 6 decimals so floating noise never reaches the JSON. */
+export function round6(n) {
+    return Math.round(n * 1e6) / 1e6;
+}
+/** JSON with object keys sorted and `undefined` members dropped — the canonical form for digests. */
+export function canonicalJson(value) {
+    return JSON.stringify(sortKeys(value));
+}
+function sortKeys(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeys);
+    if (value === null || typeof value !== 'object')
+        return value;
+    const out = {};
+    for (const key of Object.keys(value).sort(compareStr)) {
+        const v = value[key];
+        if (v !== undefined)
+            out[key] = sortKeys(v);
+    }
+    return out;
+}
+/** Sorts a copy by the given string keys, in order. */
+export function sortBy(items, ...keys) {
+    return [...items].sort((a, b) => {
+        for (const key of keys) {
+            const c = compareStr(key(a), key(b));
+            if (c !== 0)
+                return c;
+        }
+        return 0;
+    });
+}
+//# sourceMappingURL=refs.js.map

package/dist/knowledge/refs.js.map

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

package/dist/knowledge/resolve.d.ts

@@ -0,0 +1,35 @@
+/**
+ * knowledge/resolve.ts — deterministic entity resolution (PRD 38 §4.3).
+ *
+ *   • Exact: names whose normalized keys ({@link normalizeKey}) are equal are ONE entity.
+ *   • Near: pairs the knowledge index calls similar become `possible-same` findings for a
+ *     person to judge. They are never merged automatically.
+ */
+import type { Finding, NodeRef } from './model.js';
+import type { SimilarPair } from '../retrieval/knowledge-index/types.js';
+import { normalizeKey } from './refs.js';
+export { normalizeKey };
+export interface ResolvedEntity {
+    key: string;
+    /** The canonical ref (the smallest of the group). */
+    ref: NodeRef;
+    /** Every ref with this key, sorted. */
+    refs: NodeRef[];
+}
+/** Groups refs by exact normalized key. Empty keys are ignored. Sorted by key. */
+export declare function resolveEntities(entries: ReadonlyArray<{
+    ref: NodeRef;
+    key: string;
+}>): ResolvedEntity[];
+/** Normalized key → canonical ref, for an extractor's `ctx.knownKeys`. */
+export declare function knownKeysOf(resolved: readonly ResolvedEntity[]): Map<string, NodeRef>;
+/**
+ * `possible-same` findings from near-duplicate pairs between two DIFFERENT entities (pairs
+ * already merged by key, or naming a non-entity, are not reported).
+ */
+export declare function possibleSameFindings(pairs: readonly SimilarPair[], pack?: string): Finding[];
+/** The name part of `ent:<pack>:<name>`. */
+export declare function entityName(ref: string): string;
+/** The stored key of an entity named `name` in `pack`. */
+export declare function entityKey(pack: string, name: string): NodeRef;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/knowledge/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,EAAc,YAAY,EAAU,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,GAAG,EAAE,OAAO,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,cAAc,EAAE,CAavG;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAErF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,SAAW,GAAG,OAAO,EAAE,CAiB9F;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/dist/knowledge/resolve.js

@@ -0,0 +1,67 @@
+/**
+ * knowledge/resolve.ts — deterministic entity resolution (PRD 38 §4.3).
+ *
+ *   • Exact: names whose normalized keys ({@link normalizeKey}) are equal are ONE entity.
+ *   • Near: pairs the knowledge index calls similar become `possible-same` findings for a
+ *     person to judge. They are never merged automatically.
+ */
+import { hashText } from '../ingest/hash.js';
+import { compareStr, normalizeKey, round6 } from './refs.js';
+export { normalizeKey };
+/** Groups refs by exact normalized key. Empty keys are ignored. Sorted by key. */
+export function resolveEntities(entries) {
+    const groups = new Map();
+    for (const { ref, key } of entries) {
+        const k = normalizeKey(key);
+        if (!k)
+            continue;
+        let g = groups.get(k);
+        if (!g)
+            groups.set(k, (g = new Set()));
+        g.add(ref);
+    }
+    return [...groups.keys()].sort(compareStr).map((key) => {
+        const refs = [...groups.get(key)].sort(compareStr);
+        return { key, ref: refs[0], refs };
+    });
+}
+/** Normalized key → canonical ref, for an extractor's `ctx.knownKeys`. */
+export function knownKeysOf(resolved) {
+    return new Map(resolved.map((r) => [r.key, r.ref]));
+}
+/**
+ * `possible-same` findings from near-duplicate pairs between two DIFFERENT entities (pairs
+ * already merged by key, or naming a non-entity, are not reported).
+ */
+export function possibleSameFindings(pairs, pack = 'memory') {
+    const seen = new Set();
+    const out = [];
+    for (const p of pairs) {
+        if (!p.a.startsWith('ent:') || !p.b.startsWith('ent:') || p.a === p.b)
+            continue;
+        const [a, b] = compareStr(p.a, p.b) <= 0 ? [p.a, p.b] : [p.b, p.a];
+        if (normalizeKey(entityName(a)) === normalizeKey(entityName(b)))
+            continue;
+        const id = `possible-same:${hashText(`${a}\u0000${b}`)}`;
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        out.push({
+            id, kind: 'possible-same', pack, nodes: [a, b], severity: 'info',
+            params: { similarity: round6(p.similarity) },
+            requestKey: 'knowledgeGraph.fix.possibleSame',
+        });
+    }
+    return out.sort((x, y) => compareStr(x.id, y.id));
+}
+/** The name part of `ent:<pack>:<name>`. */
+export function entityName(ref) {
+    const rest = ref.startsWith('ent:') ? ref.slice(4) : ref;
+    const colon = rest.indexOf(':');
+    return colon < 0 ? rest : rest.slice(colon + 1);
+}
+/** The stored key of an entity named `name` in `pack`. */
+export function entityKey(pack, name) {
+    return `ent:${pack}:${normalizeKey(name)}`;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/knowledge/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/knowledge/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,CAAC;AAUxB,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAAC,OAAqD;IACjF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,KAAK,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACnD,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,WAAW,CAAC,QAAmC;IAC3D,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAU,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA6B,EAAE,IAAI,GAAG,QAAQ;IAC/E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,SAAS;QAChF,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAAE,SAAS;QAC1E,MAAM,EAAE,GAAG,iBAAiB,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;QACzD,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC;YACL,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAY,EAAE,CAAY,CAAC,EAAE,QAAQ,EAAE,MAAM;YACtF,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE;YAC5C,UAAU,EAAE,iCAAiC;SAChD,CAAC,CAAC;IACP,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,UAAU,CAAC,GAAW;IAClC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAY;IAChD,OAAO,OAAO,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/knowledge/review.d.ts

@@ -0,0 +1,23 @@
+/**
+ * knowledge/review.ts — `reviewDirectory`: point it at a folder and it learns what the
+ * folder says (PRD 38 §4.3).
+ *
+ *   plan (walk + manifest diff) → per changed file: read · parse (the ONE ParserRegistry,
+ *   composed from the packs) · extract (cached by content hash) · judge (changed sections
+ *   of judged kinds, within budget) · write · markStale → analyzers → compare near-duplicate
+ *   claims → manifest + scope digest.
+ *
+ * Store judgement, compute perception: only `model` facts and relations are written —
+ * `extracted` output goes to the extracted cache, never to memory ({@link assertStoredBatch}).
+ * Abort is honoured between files; a file is written whole or not at all. A file whose
+ * sections were cut by the budget stays "changed" in the manifest, so continuing re-plans it
+ * and judges only the sections not judged yet.
+ */
+import type { ReviewArgs, ReviewReport, StoredFact, StoredRelation } from './model.js';
+/** Throws if a batch carries `extracted` items — perception is never memory. */
+export declare function assertStoredBatch(batch: {
+    facts: readonly StoredFact[];
+    relations: readonly StoredRelation[];
+}): void;
+export declare function reviewDirectory(args: ReviewArgs): Promise<ReviewReport>;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/knowledge/review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAC6D,UAAU,EAAE,YAAY,EAC7F,UAAU,EAAE,cAAc,EAC7B,MAAM,YAAY,CAAC;AAcpB,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,GAAG,IAAI,CAGrH;AA8DD,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAqI7E"}