@oscharko-dev/keiko 0.2.0-beta.5 → 0.2.0-beta.7

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/discovery/extract.js

@@ -137,6 +137,21 @@ function persistFailureRow(deps, params, documentId, document, diagnostic, now)
         throw cause;
     }
 }
+// GRD-010: decide whether to persist a cascade-deleting failure row. A TRANSIENT IO failure
+// (READ_FAILED / STAT_FAILED) on an incremental refresh must NOT destroy a previously-good index
+// — persisting overwrites the document row and CASCADE-deletes its chunks+vectors. When a prior
+// NON-failed row exists, skip persistence so a momentary lock / NFS hiccup / permission flap
+// preserves retrievable content (the orchestrator then reports a non-destructive skip). Permanent
+// failures (MALFORMED_INPUT, PARSER_FAILED, OVERSIZED_FILE, …) and first-time failures still persist.
+function shouldPersistFailureRow(deps, params, documentId, error, optionPersist) {
+    if (!optionPersist)
+        return false;
+    const isTransient = error.code === "READ_FAILED" || error.code === "STAT_FAILED";
+    if (!isTransient)
+        return true;
+    const existing = readExistingDocumentRow(deps.store._internal.db, params.capsuleId, documentId);
+    return existing === undefined || existing.status === "failed";
+}
 function buildFailureResult(deps, params, documentId, error, options = { persist: true }) {
     const now = deps.store._internal.now;
     const redactedMessage = redactMessage(error.message, params.source);
@@ -159,7 +174,7 @@ function buildFailureResult(deps, params, documentId, error, options = { persist
         status: "failed",
         safeDisplayName: safeDisplay(params.file.relativePath),
     };
-    if (options.persist) {
+    if (shouldPersistFailureRow(deps, params, documentId, error, options.persist)) {
         persistFailureRow(deps, params, documentId, document, diagnostic, now);
     }
     const outcome = {
@@ -337,36 +352,23 @@ function selectedRelativePath(policy, rawRelativePath) {
     }
     return relativePath;
 }
-function resolveTargetPath(deps, params) {
-    const policy = deriveScopePolicy(params.source.scope);
-    if ("code" in policy) {
-        return targetError(policy, false);
-    }
-    const relativePath = selectedRelativePath(policy, params.file.relativePath);
-    if (typeof relativePath !== "string") {
-        return relativePath;
-    }
-    const root = policy.rootPath;
-    const absolute = joinAbs(root, relativePath);
-    let real;
+function resolveRealPathTarget(deps, path, relativePath, message) {
     try {
-        real = deps.fs.realPath(absolute);
+        return deps.fs.realPath(path);
     }
     catch {
-        return targetError({
-            code: "READ_FAILED",
-            message: "realPath failed for selected file",
-            relativePath,
-        }, true);
+        return targetError({ code: "READ_FAILED", message, relativePath }, true);
     }
-    if (!isContained(root, real)) {
+}
+function containedRealFileTarget(realRoot, real, relativePath) {
+    if (!isContained(realRoot, real)) {
         return targetError({
             code: "PATH_ESCAPE",
             message: `realpath escapes scope root: ${relativePath}`,
             relativePath,
         }, true);
     }
-    const realRelativePath = toPosixRelative(root, real);
+    const realRelativePath = toPosixRelative(realRoot, real);
     if (isDenied(realRelativePath)) {
         return targetError({
             code: "READ_FAILED",
@@ -374,6 +376,28 @@ function resolveTargetPath(deps, params) {
             relativePath,
         }, true);
     }
+    return undefined;
+}
+function resolveTargetPath(deps, params) {
+    const policy = deriveScopePolicy(params.source.scope);
+    if ("code" in policy) {
+        return targetError(policy, false);
+    }
+    const relativePath = selectedRelativePath(policy, params.file.relativePath);
+    if (typeof relativePath !== "string") {
+        return relativePath;
+    }
+    const root = policy.rootPath;
+    const absolute = joinAbs(root, relativePath);
+    const realRoot = resolveRealPathTarget(deps, root, relativePath, "realPath failed for selected source root");
+    if (typeof realRoot !== "string")
+        return realRoot;
+    const real = resolveRealPathTarget(deps, absolute, relativePath, "realPath failed for selected file");
+    if (typeof real !== "string")
+        return real;
+    const containmentError = containedRealFileTarget(realRoot, real, relativePath);
+    if (containmentError !== undefined)
+        return containmentError;
     // Normalise to forward slashes so subsequent IO calls (readFileBytes, stat) receive
     // a consistent path even when realPath returned a Windows backslash path.
     return { absolutePath: normaliseSep(real), requestedAbsolutePath: absolute, relativePath };

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/discovery/media-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-type.d.ts","sourceRoot":"","sources":["../../src/discovery/media-type.ts"],"names":[],"mappings":"AA+CA,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGvD"}
+{"version":3,"file":"media-type.d.ts","sourceRoot":"","sources":["../../src/discovery/media-type.ts"],"names":[],"mappings":"AAgDA,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/discovery/media-type.js

@@ -38,6 +38,7 @@ const MEDIA_TYPES = Object.freeze({
     // unsupported binaries (the unsupported adapter still classifies these explicitly)
     pdf: "application/pdf",
     docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
     png: "image/png",
     jpg: "image/jpeg",
     jpeg: "image/jpeg",

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/discovery/walk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/discovery/walk.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,+BAA+B,CAAC;AAIhF,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAMpB,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAoT/D,wBAAiB,UAAU,CACzB,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,gBAA4C,GACpD,SAAS,CAAC,SAAS,CAAC,CAYtB"}
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/discovery/walk.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,+BAA+B,CAAC;AAIhF,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAMpB,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAqT/D,wBAAiB,UAAU,CACzB,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,gBAA4C,GACpD,SAAS,CAAC,SAAS,CAAC,CAoBtB"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/discovery/walk.js

@@ -185,7 +185,7 @@ function* yieldFileIfAllowed(ctx, absolutePath, relativePath) {
     if (real === undefined) {
         return;
     }
-    if (!isContained(ctx.bounds.rootPath, real)) {
+    if (!isContained(ctx.realRootPath, real)) {
         yield {
             kind: "error",
             error: {
@@ -196,7 +196,7 @@ function* yieldFileIfAllowed(ctx, absolutePath, relativePath) {
         };
         return;
     }
-    const realRel = toPosixRelative(ctx.bounds.rootPath, real);
+    const realRel = toPosixRelative(ctx.realRootPath, real);
     if (isDeniedRelativePath(realRel)) {
         return;
     }
@@ -285,7 +285,15 @@ export function* walkSource(fs, scope, options = DEFAULT_DISCOVERY_OPTIONS) {
         yield { kind: "error", error: bounds };
         return;
     }
-    const ctx = { fs, bounds, options, filesYielded: 0 };
+    const realRootPath = safeRealPath(fs, bounds.rootPath);
+    if (realRootPath === undefined) {
+        yield {
+            kind: "error",
+            error: { code: "READ_FAILED", message: "realPath failed for selected source root" },
+        };
+        return;
+    }
+    const ctx = { fs, bounds, realRootPath, options, filesYielded: 0 };
     if (scope.kind === "files") {
         yield* walkFilesScope(ctx, scope.files);
         return;

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/dimensions.d.ts

@@ -2,6 +2,8 @@ import type { ChunkId, KnowledgeCapsuleId, RetrievalReference } from "@oscharko-
 import type { ParsedUnit } from "@oscharko-dev/keiko-contracts";
 export declare function scoreRecall(returned: readonly RetrievalReference[], expected: readonly ChunkId[]): number;
 export declare function scorePrecision(returned: readonly RetrievalReference[], expected: readonly ChunkId[]): number;
+export declare function scoreMeanReciprocalRank(returned: readonly RetrievalReference[], expected: readonly ChunkId[]): number;
+export declare function scoreNdcg(returned: readonly RetrievalReference[], expected: readonly ChunkId[]): number;
 export declare function scoreSourceIsolation(returned: readonly RetrievalReference[], scopeCapsuleIds: readonly KnowledgeCapsuleId[]): number;
 type CitationRequirementKey = "page" | "section" | "json-path" | "csv-row" | "html-block" | "unsupported-media";
 export declare function scoreCitationQuality(references: readonly RetrievalReference[], chunkUnitKinds: ReadonlyMap<string, CitationRequirementKey>): number;

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/dimensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/evaluations/dimensions.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAMhE,wBAAgB,WAAW,CACzB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,MAAM,CASR;AAKD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,MAAM,CASR;AASD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,eAAe,EAAE,SAAS,kBAAkB,EAAE,GAC7C,MAAM,CAQR;AAcD,KAAK,sBAAsB,GACvB,MAAM,GACN,SAAS,GACT,WAAW,GACX,SAAS,GACT,YAAY,GACZ,mBAAmB,CAAC;AAyCxB,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAC1D,MAAM,CAeR;AAID,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,GAAG,sBAAsB,CAEnF;AAED,YAAY,EAAE,sBAAsB,EAAE,CAAC;AAOvC,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,OAAO,EACzB,kBAAkB,EAAE,OAAO,EAC3B,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,CAAC,GAAG,CAAC,CAMP;AAQD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7C,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,CAWR"}
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/evaluations/dimensions.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAMhE,wBAAgB,WAAW,CACzB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,MAAM,CASR;AAKD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,MAAM,CASR;AAMD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,MAAM,CAUR;AAQD,wBAAgB,SAAS,CACvB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,MAAM,CAiBR;AASD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,eAAe,EAAE,SAAS,kBAAkB,EAAE,GAC7C,MAAM,CAQR;AAcD,KAAK,sBAAsB,GACvB,MAAM,GACN,SAAS,GACT,WAAW,GACX,SAAS,GACT,YAAY,GACZ,mBAAmB,CAAC;AAyCxB,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAC1D,MAAM,CAeR;AAID,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,GAAG,sBAAsB,CAEnF;AAED,YAAY,EAAE,sBAAsB,EAAE,CAAC;AAOvC,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,OAAO,EACzB,kBAAkB,EAAE,OAAO,EAC3B,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,CAAC,GAAG,CAAC,CAMP;AAQD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7C,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,CAWR"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/dimensions.js

@@ -45,6 +45,48 @@ export function scorePrecision(returned, expected) {
     }
     return hits / returned.length;
 }
+// ─── Ranking quality ────────────────────────────────────────────────────────
+// MRR captures how quickly the first relevant chunk appears. Recall/precision alone can pass even
+// when a relevant chunk is buried late in the retrieved list; MRR makes that regression visible.
+export function scoreMeanReciprocalRank(returned, expected) {
+    if (expected.length === 0)
+        return 1;
+    const expectedIds = new Set();
+    for (const id of expected)
+        expectedIds.add(String(id));
+    for (let index = 0; index < returned.length; index += 1) {
+        if (expectedIds.has(String(returned[index]?.chunkId))) {
+            return 1 / (index + 1);
+        }
+    }
+    return 0;
+}
+function discountedGain(rankIndex) {
+    return 1 / Math.log2(rankIndex + 2);
+}
+// Binary relevance nDCG@returned.length. This rewards relevant chunks appearing earlier while
+// staying deterministic and independent of model-judged graded relevance.
+export function scoreNdcg(returned, expected) {
+    if (expected.length === 0)
+        return 1;
+    if (returned.length === 0)
+        return 0;
+    const expectedIds = new Set();
+    for (const id of expected)
+        expectedIds.add(String(id));
+    let dcg = 0;
+    for (let index = 0; index < returned.length; index += 1) {
+        if (expectedIds.has(String(returned[index]?.chunkId))) {
+            dcg += discountedGain(index);
+        }
+    }
+    const idealCount = Math.min(expectedIds.size, returned.length);
+    let ideal = 0;
+    for (let index = 0; index < idealCount; index += 1) {
+        ideal += discountedGain(index);
+    }
+    return ideal === 0 ? 0 : dcg / ideal;
+}
 // ─── Source isolation ────────────────────────────────────────────────────────
 // A retrieval is source-isolated iff every returned reference belongs to a capsule that is
 // in `scopeCapsuleIds`. A single leak across the capsule boundary drops the score to 0 —

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/evaluations/fixtures.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAGV,sBAAsB,EAGvB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,uBAAuB,EAAE,sBAKrC,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,sBAK5C,CAAC;AAEF,eAAO,MAAM,gBAAgB,IAAM,CAAC;AAepC,eAAO,MAAM,kBAAkB,EAAE,oBAiDhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,oBAqFjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBA+C/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,oBAiDnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,oBA2EpC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBA2E/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,oBAoE9B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,oBAgJnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,oBAiDlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBA8C/B,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,oBA6ExC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,SAAS,oBAAoB,EAY9C,CAAC"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/evaluations/fixtures.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAGV,sBAAsB,EAGvB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,uBAAuB,EAAE,sBAKrC,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,sBAK5C,CAAC;AAEF,eAAO,MAAM,gBAAgB,IAAM,CAAC;AAepC,eAAO,MAAM,kBAAkB,EAAE,oBAiDhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,oBAqFjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBA+C/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,oBAiDnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,oBA2EpC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBA2E/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,oBAoE9B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,oBAkLnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,oBAiDlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBA8C/B,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,oBA6ExC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,SAAS,oBAAoB,EAY9C,CAAC"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/fixtures.js

@@ -553,6 +553,32 @@ export const structuredFileFixture = {
                                 },
                             ],
                         },
+                        {
+                            id: documentId("doc-xlsx"),
+                            safeDisplayName: "controls.xlsx",
+                            mediaType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+                            parserId: "xlsx",
+                            parsedUnits: [
+                                {
+                                    id: "xlsx-row-17",
+                                    unit: {
+                                        kind: "csv-row",
+                                        tableName: "Controls",
+                                        rowIndex: 16,
+                                        characterStart: 0,
+                                        characterEnd: 64,
+                                    },
+                                },
+                            ],
+                            chunks: [
+                                {
+                                    id: chunkId("c-xlsx"),
+                                    text: "xlsx control row body",
+                                    topic: "xlsx-topic",
+                                    parsedUnitId: "xlsx-row-17",
+                                },
+                            ],
+                        },
                         {
                             id: documentId("doc-html"),
                             safeDisplayName: "guide.html",
@@ -632,6 +658,14 @@ export const structuredFileFixture = {
             expectedChunkIds: [chunkId("c-section")],
             topK: 1,
         },
+        {
+            id: "q-xlsx",
+            text: "find the xlsx control row",
+            topic: "xlsx-topic",
+            scope: { kind: "capsule", capsuleId: capsuleId("cap-structured") },
+            expectedChunkIds: [chunkId("c-xlsx")],
+            topK: 1,
+        },
     ],
 };
 export const contextBudgetFixture = {

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/index.d.ts

@@ -1,5 +1,5 @@
 export { ALL_FIXTURES, EVAL_EMBEDDING_IDENTITY, EVAL_TOPIC_BOOST, ambiguousQueryFixture, broadQueryDiversityFixture, contextBudgetFixture, multiCapsuleFixture, multiPageFixture, noEvidenceFixture, singleTopicFixture, staleIndexFixture, structuredFileFixture, sourceIsolationFixture, wrongScopeFixture, } from "./fixtures.js";
-export { citationRequirementForUnit, scoreCitationQuality, scoreContextBudgetFit, scoreNoEvidenceAccuracy, scorePrecision, scoreRecall, scoreSourceIsolation, type CitationRequirementKey, } from "./dimensions.js";
+export { citationRequirementForUnit, scoreCitationQuality, scoreContextBudgetFit, scoreMeanReciprocalRank, scoreNdcg, scoreNoEvidenceAccuracy, scorePrecision, scoreRecall, scoreSourceIsolation, type CitationRequirementKey, } from "./dimensions.js";
 export { createScriptedEmbeddingAdapter, fnv1a32, withTopicMarker, type ScriptedEmbeddingAdapterOptions, } from "./scripted-embedding-adapter.js";
 export { renderRetrievalEvalQualityGateReport } from "./report.js";
 export { runRetrievalEval, type RunRetrievalEvalDeps } from "./runner.js";

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/evaluations/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,8BAA8B,EAC9B,OAAO,EACP,eAAe,EACf,KAAK,+BAA+B,GACrC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,oCAAoC,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/evaluations/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,SAAS,EACT,uBAAuB,EACvB,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,8BAA8B,EAC9B,OAAO,EACP,eAAe,EACf,KAAK,+BAA+B,GACrC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,oCAAoC,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/index.js

@@ -3,7 +3,7 @@
 // import from this subdirectory directly (ADR-0019 direction rule 3e + the trust-8
 // test-support naming convention).
 export { ALL_FIXTURES, EVAL_EMBEDDING_IDENTITY, EVAL_TOPIC_BOOST, ambiguousQueryFixture, broadQueryDiversityFixture, contextBudgetFixture, multiCapsuleFixture, multiPageFixture, noEvidenceFixture, singleTopicFixture, staleIndexFixture, structuredFileFixture, sourceIsolationFixture, wrongScopeFixture, } from "./fixtures.js";
-export { citationRequirementForUnit, scoreCitationQuality, scoreContextBudgetFit, scoreNoEvidenceAccuracy, scorePrecision, scoreRecall, scoreSourceIsolation, } from "./dimensions.js";
+export { citationRequirementForUnit, scoreCitationQuality, scoreContextBudgetFit, scoreMeanReciprocalRank, scoreNdcg, scoreNoEvidenceAccuracy, scorePrecision, scoreRecall, scoreSourceIsolation, } from "./dimensions.js";
 export { createScriptedEmbeddingAdapter, fnv1a32, withTopicMarker, } from "./scripted-embedding-adapter.js";
 export { renderRetrievalEvalQualityGateReport } from "./report.js";
 export { runRetrievalEval } from "./runner.js";

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/evaluations/report.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAMzD,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,SAAS,sBAAsB,EAAE,GAC5C,MAAM,CAuBR"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/evaluations/report.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAMzD,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,SAAS,sBAAsB,EAAE,GAC5C,MAAM,CAwBR"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/report.js

@@ -8,23 +8,24 @@ export function renderRetrievalEvalQualityGateReport(scorecards) {
     const header = [
         "# Local Knowledge Retrieval Quality Gate",
         "",
-        "| Fixture | Recall | Precision | Isolation | Citation | No-evidence | Context budget | Latency | Pass |",
-        "| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | --- |",
+        "| Fixture | Recall | Precision | MRR | nDCG | Isolation | Citation | No-evidence | Context budget | Latency | Pass |",
+        "| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | --- |",
     ];
     const rows = scorecards.map((scorecard) => {
         const d = scorecard.dimensions;
-        return [
-            `| ${scorecard.fixtureId}`,
+        return `| ${[
+            scorecard.fixtureId,
             format(d.recall),
             format(d.precision),
+            format(d.meanReciprocalRank),
+            format(d.ndcg),
             format(d.sourceIsolation),
             format(d.citationQuality),
             format(d.noEvidenceAccuracy),
             format(d.contextBudgetFit),
             format(d.latencyMs),
             scorecard.passed ? "PASS" : "FAIL",
-            "|",
-        ].join(" | ");
+        ].join(" | ")} |`;
     });
     return [...header, ...rows].join("\n");
 }

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/evaluations/runner.ts"],"names":[],"mappings":"AA2CA,OAAO,KAAK,EAEV,6BAA6B,EAE7B,oBAAoB,EAEpB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,oBAAoB;IAGnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAG5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAGxB,QAAQ,CAAC,UAAU,CAAC,EAAE,6BAA6B,CAAC;CACrD;AA0OD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAkBjC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/evaluations/runner.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAEV,6BAA6B,EAE7B,oBAAoB,EAEpB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,oBAAoB;IAGnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAG5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAGxB,QAAQ,CAAC,UAAU,CAAC,EAAE,6BAA6B,CAAC;CACrD;AAkPD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAkBjC"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/runner.js

@@ -20,7 +20,7 @@ import { join } from "node:path";
 import { embedChunkBatch } from "../indexing/embedding-batcher.js";
 import { runLocalKnowledgeRetrieval } from "../retrieval/index.js";
 import { openKnowledgeStore } from "../store.js";
-import { scoreCitationQuality, scoreContextBudgetFit, scoreNoEvidenceAccuracy, scorePrecision, scoreRecall, scoreSourceIsolation, } from "./dimensions.js";
+import { scoreCitationQuality, scoreContextBudgetFit, scoreMeanReciprocalRank, scoreNdcg, scoreNoEvidenceAccuracy, scorePrecision, scoreRecall, scoreSourceIsolation, } from "./dimensions.js";
 import { seedFixture } from "./runner-seed.js";
 import { createScriptedEmbeddingAdapter, withTopicMarker } from "./scripted-embedding-adapter.js";
 import { PASS_THRESHOLDS } from "./types.js";
@@ -109,6 +109,8 @@ async function runOneQuery(store, query, seeded, now) {
         scores: {
             recall: scoreRecall(result.references, expected),
             precision: scorePrecision(result.references, expected),
+            meanReciprocalRank: scoreMeanReciprocalRank(result.references, expected),
+            ndcg: scoreNdcg(result.references, expected),
             sourceIsolation: scoreSourceIsolation(result.references, scopeCapsuleIds(query)),
             citationQuality: scoreCitationQuality(result.references, seeded.chunkUnitKinds),
             noEvidenceAccuracy: scoreNoEvidenceAccuracy(result.noEvidence, expectedNoEvidence, result.reason, query.expectedNoEvidenceReason),
@@ -149,6 +151,8 @@ function buildScorecard(fixture, runId, perQuery, modelJudged) {
     const dimensions = {
         recall: meanOf(perQuery.map((q) => q.scores.recall)),
         precision: meanOf(perQuery.map((q) => q.scores.precision)),
+        meanReciprocalRank: meanOf(perQuery.map((q) => q.scores.meanReciprocalRank)),
+        ndcg: meanOf(perQuery.map((q) => q.scores.ndcg)),
         sourceIsolation: meanOf(perQuery.map((q) => q.scores.sourceIsolation)),
         citationQuality: meanOf(perQuery.map((q) => q.scores.citationQuality)),
         noEvidenceAccuracy: meanOf(perQuery.map((q) => q.scores.noEvidenceAccuracy)),
@@ -157,6 +161,8 @@ function buildScorecard(fixture, runId, perQuery, modelJudged) {
     };
     const passed = dimensions.recall >= PASS_THRESHOLDS.recall &&
         dimensions.precision >= PASS_THRESHOLDS.precision &&
+        dimensions.meanReciprocalRank >= PASS_THRESHOLDS.meanReciprocalRank &&
+        dimensions.ndcg >= PASS_THRESHOLDS.ndcg &&
         dimensions.sourceIsolation >= PASS_THRESHOLDS.sourceIsolation &&
         dimensions.citationQuality >= PASS_THRESHOLDS.citationQuality &&
         dimensions.noEvidenceAccuracy >= PASS_THRESHOLDS.noEvidenceAccuracy &&

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/types.d.ts

@@ -72,6 +72,8 @@ export interface RetrievalEvalFixture {
 export interface RetrievalEvalDimensionScores {
     readonly recall: number;
     readonly precision: number;
+    readonly meanReciprocalRank: number;
+    readonly ndcg: number;
     readonly sourceIsolation: number;
     readonly citationQuality: number;
     readonly noEvidenceAccuracy: number;
@@ -103,6 +105,8 @@ export interface RetrievalEvalScorecard {
 export interface RetrievalEvalThresholds {
     readonly recall: number;
     readonly precision: number;
+    readonly meanReciprocalRank: number;
+    readonly ndcg: number;
     readonly sourceIsolation: number;
     readonly citationQuality: number;
     readonly noEvidenceAccuracy: number;

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/evaluations/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/evaluations/types.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,4BAA4B,EAC5B,OAAO,EACP,UAAU,EACV,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACX,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAQ3F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAKtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAGxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,0BAA0B,GAClC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,YAAY,CAAC,GACzD,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,EAAE,YAAY,CAAC,GAC5D,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,EAAE,YAAY,CAAC,GAC9D,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,EAAE,YAAY,CAAC,GAC5D,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,EAAE,YAAY,CAAC,GAC/D,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC,EAAE,YAAY,CAAC,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAGpB,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;CAC3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;IAC7D,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;CAC7C;AAKD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAA;CAAE,GACpE;IACE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACpD,CAAC;AAEN,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAItB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,yBAAyB,CAAC;IAE9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAIvB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAItC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;CAC1D;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACjD;AAOD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAGlC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,yBAAyB,CAAC;CAC7C;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,OAAO,CAAC,8BAA8B,CAAC,CAAC;CACnG;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,8BAA8B,CAAC;CACvD;AAOD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,eAAO,MAAM,eAAe,EAAE,uBAS5B,CAAC"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/evaluations/types.js

@@ -18,6 +18,8 @@
 export const PASS_THRESHOLDS = Object.freeze({
     recall: 0.9,
     precision: 0.8,
+    meanReciprocalRank: 0.9,
+    ndcg: 0.9,
     sourceIsolation: 1.0,
     citationQuality: 0.9,
     noEvidenceAccuracy: 1.0,

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/index.d.ts

@@ -5,7 +5,7 @@ export { openKnowledgeStore, type KnowledgeStoreKeyProvider, type KnowledgeStore
 export { createCapsule, deleteCapsule, getCapsule, listCapsules, updateCapsuleState, updateCapsuleDetails, type CapsuleDetailsPatch, type CreateCapsuleInput, } from "./capsule-lifecycle.js";
 export { addSourceToCapsule, listCapsuleSources, removeSourceFromCapsule, type AddCapsuleSourceInput, } from "./source-lifecycle.js";
 export { createCapsuleSet, deleteCapsuleSet, getCapsuleSet, listCapsuleSets, type CreateCapsuleSetInput, } from "./capsule-set-lifecycle.js";
-export { DEFAULT_MAX_BYTES, DEFAULT_MAX_NESTING_DEPTH, DEFAULT_MAX_OBJECTS, DEFAULT_MAX_UNITS, DEFAULT_TIMEOUT_MS, PARSER_ERROR_CODES, buildParserOptions, createDefaultParserRegistry, createParserRegistry, csvParser, docxParser, htmlParser, jsonParser, pdfParser, registerParser, resolveParser, textParser, unsupportedParser, type AsyncParserAdapter, type ParserAdapter, type ParserCapability, type ParserErrorCode, type ParserOptions, type ParserRegistry, type ParserResolution, type ParserSelectionInput, } from "./parsers/index.js";
+export { DEFAULT_MAX_BYTES, DEFAULT_MAX_NESTING_DEPTH, DEFAULT_MAX_OBJECTS, DEFAULT_MAX_UNITS, DEFAULT_TIMEOUT_MS, PARSER_ERROR_CODES, buildParserOptions, createDefaultParserRegistry, createParserRegistry, csvParser, docxParser, htmlParser, jsonParser, pdfParser, registerParser, resolveParser, textParser, unsupportedParser, xlsxParser, type AsyncParserAdapter, type ParserAdapter, type ParserCapability, type ParserErrorCode, type ParserOptions, type ParserRegistry, type ParserResolution, type ParserSelectionInput, } from "./parsers/index.js";
 export { createOcrPipelineParser, nullOcrAdapter, type OcrAdapter, type OcrPageResult, type OcrPipelineAdapter, } from "./parsers/ocr/index.js";
 export { DEFAULT_DISCOVERY_OPTIONS, discoverAndExtract, documentIdFor, extensionOf, extractDocument, mediaTypeFor, walkSource, type DiscoverAndExtractDeps, type DiscoverAndExtractParams, type DiscoveredFile, type DiscoveryError, type DiscoveryErrorCode, type DiscoveryOptions, type ExtractDocumentDeps, type ExtractDocumentParams, type ExtractionEvent, type ExtractionOutcome, type ExtractionResult, type WalkYield, } from "./discovery/index.js";
 export * from "./indexing/index.js";

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/index.d.ts.map

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

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/index.js

@@ -18,7 +18,7 @@ export { openKnowledgeStore, } from "./store.js";
 export { createCapsule, deleteCapsule, getCapsule, listCapsules, updateCapsuleState, updateCapsuleDetails, } from "./capsule-lifecycle.js";
 export { addSourceToCapsule, listCapsuleSources, removeSourceFromCapsule, } from "./source-lifecycle.js";
 export { createCapsuleSet, deleteCapsuleSet, getCapsuleSet, listCapsuleSets, } from "./capsule-set-lifecycle.js";
-export { DEFAULT_MAX_BYTES, DEFAULT_MAX_NESTING_DEPTH, DEFAULT_MAX_OBJECTS, DEFAULT_MAX_UNITS, DEFAULT_TIMEOUT_MS, PARSER_ERROR_CODES, buildParserOptions, createDefaultParserRegistry, createParserRegistry, csvParser, docxParser, htmlParser, jsonParser, pdfParser, registerParser, resolveParser, textParser, unsupportedParser, } from "./parsers/index.js";
+export { DEFAULT_MAX_BYTES, DEFAULT_MAX_NESTING_DEPTH, DEFAULT_MAX_OBJECTS, DEFAULT_MAX_UNITS, DEFAULT_TIMEOUT_MS, PARSER_ERROR_CODES, buildParserOptions, createDefaultParserRegistry, createParserRegistry, csvParser, docxParser, htmlParser, jsonParser, pdfParser, registerParser, resolveParser, textParser, unsupportedParser, xlsxParser, } from "./parsers/index.js";
 // OCR adapter seam (Issue #202).
 export { createOcrPipelineParser, nullOcrAdapter, } from "./parsers/ocr/index.js";
 export { DEFAULT_DISCOVERY_OPTIONS, discoverAndExtract, documentIdFor, extensionOf, extractDocument, mediaTypeFor, walkSource, } from "./discovery/index.js";

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/indexing/embedding-batcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding-batcher.d.ts","sourceRoot":"","sources":["../../src/indexing/embedding-batcher.ts"],"names":[],"mappings":"AA6BA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAuUpB,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA0B3B"}
+{"version":3,"file":"embedding-batcher.d.ts","sourceRoot":"","sources":["../../src/indexing/embedding-batcher.ts"],"names":[],"mappings":"AA8BA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAsdpB,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA0B3B"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/indexing/embedding-batcher.js

@@ -113,6 +113,113 @@ async function embedChunkWithRetry(options, chunk) {
     }
     return outcome;
 }
+// ─── Array-batch embedding (#189 GRD-004) ────────────────────────────────────
+// When the adapter exposes `requestBatch`, embed many unique chunks per HTTP round-trip.
+// Items per request are bounded so a single response stays well under the gateway's 10 MB
+// JSON cap (96 × 3072 float32 ≈ 4.4 MB) and inside provider per-request token limits.
+const BATCH_ITEM_CAP = 96;
+const BATCH_CHAR_CAP = 120_000;
+function groupIntoBatches(requests) {
+    const batches = [];
+    let current = [];
+    let currentChars = 0;
+    for (const request of requests) {
+        const len = request.representative.text.length;
+        if (current.length > 0 &&
+            (current.length >= BATCH_ITEM_CAP || currentChars + len > BATCH_CHAR_CAP)) {
+            batches.push(current);
+            current = [];
+            currentChars = 0;
+        }
+        current.push(request);
+        currentChars += len;
+    }
+    if (current.length > 0)
+        batches.push(current);
+    return batches;
+}
+function isTransientBatchOutcome(outcome) {
+    return !outcome.ok && TRANSIENT_EMBED_KINDS.has(outcome.kind);
+}
+function errorFromKind(kind) {
+    return { code: "EMBEDDING_ADAPTER_FAILED", message: `embedding adapter returned ${kind}` };
+}
+async function embedArrayBatchWithRetry(options, inputs) {
+    const adapter = options.adapter;
+    const requestBatch = adapter.requestBatch;
+    if (requestBatch === undefined) {
+        return { ok: false, kind: "transport" };
+    }
+    const base = {
+        endpoint: adapter.endpoint,
+        apiKey: adapter.apiKey,
+        ...(adapter.apiKeyHeaderName !== undefined
+            ? { apiKeyHeaderName: adapter.apiKeyHeaderName }
+            : {}),
+        modelId: options.pinnedIdentity.modelId,
+        inputs,
+        ...(options.signal !== undefined ? { signal: options.signal } : {}),
+    };
+    const retry = resolveRetry(options.retry);
+    let outcome = await requestBatch(base);
+    for (let attempt = 1; attempt <= retry.maxRetries; attempt += 1) {
+        if (!isTransientBatchOutcome(outcome) || options.signal?.aborted === true) {
+            return outcome;
+        }
+        try {
+            await retry.sleep(backoffMs(attempt, retry.baseDelayMs), options.signal);
+        }
+        catch {
+            return outcome; // aborted mid-backoff; the abort gate converts this to CANCELLED
+        }
+        outcome = await requestBatch(base);
+    }
+    return outcome;
+}
+// Apply the per-vector identity gate exactly as the scalar path does. Order-independent:
+// once `state.identityFailure` is set, embedChunkBatch persists nothing, so which concurrent
+// batch first observes the drift is irrelevant to the outcome.
+function gateVectorOutcome(representative, success, options, state) {
+    if (state.identityFailure !== undefined) {
+        return { ok: false, chunk: representative, error: state.identityFailure };
+    }
+    const observed = identityFromAdapter(options.pinnedIdentity, success);
+    const compat = assertCompatibleEmbeddingIdentity(options.pinnedIdentity, observed);
+    if (!compat.ok) {
+        state.identityFailure = {
+            code: "INCOMPATIBLE_EMBEDDING_IDENTITY",
+            message: compat.safeMessage,
+        };
+        return { ok: false, chunk: representative, error: state.identityFailure };
+    }
+    return { ok: true, chunk: representative, success };
+}
+async function embedUniqueBatch(batch, options, state) {
+    if (state.identityFailure !== undefined) {
+        const failure = state.identityFailure;
+        return batch.map((r) => ({ ok: false, chunk: r.representative, error: failure }));
+    }
+    const abortError = checkAbort(options.signal);
+    if (abortError !== undefined) {
+        return batch.map((r) => ({ ok: false, chunk: r.representative, error: abortError }));
+    }
+    const outcome = await embedArrayBatchWithRetry(options, batch.map((r) => r.representative.text));
+    if (!outcome.ok) {
+        const error = errorFromKind(outcome.kind);
+        return batch.map((r) => ({ ok: false, chunk: r.representative, error }));
+    }
+    return batch.map((request, i) => {
+        const success = outcome.value[i];
+        if (success === undefined) {
+            return {
+                ok: false,
+                chunk: request.representative,
+                error: errorFromKind("invalid-response"),
+            };
+        }
+        return gateVectorOutcome(request.representative, success, options, state);
+    });
+}
 // ─── Identity verification ───────────────────────────────────────────────────
 function identityFromAdapter(pinned, success) {
     // `provider` and `vectorMetric` are not echoed by the OpenAI API response — they come from
@@ -208,9 +315,20 @@ function expandUniqueOutcomes(uniqueRequests, uniqueOutcomes) {
 async function buildChunkOutcomes(chunks, options) {
     const state = { identityFailure: undefined };
     const uniqueRequests = dedupeEmbeddingRequests(chunks);
-    const uniqueOutcomes = await runBounded(uniqueRequests, options.concurrency, async (request) => {
-        return buildUniqueChunkOutcome(request, options, state);
-    });
+    let uniqueOutcomes;
+    if (typeof options.adapter.requestBatch === "function") {
+        // Array-batch path: collapse the unique requests into ceil(N / itemCap) HTTP calls,
+        // run those calls with bounded concurrency, then flatten back into request order.
+        const batches = groupIntoBatches(uniqueRequests);
+        const batchOutcomes = await runBounded(batches, options.concurrency, async (batch) => embedUniqueBatch(batch, options, state));
+        uniqueOutcomes = batchOutcomes.flat();
+    }
+    else {
+        // Scalar fallback (adapters/stubs without `requestBatch`): one HTTP call per unique chunk.
+        uniqueOutcomes = await runBounded(uniqueRequests, options.concurrency, async (request) => {
+            return buildUniqueChunkOutcome(request, options, state);
+        });
+    }
     const outcomes = expandUniqueOutcomes(uniqueRequests, uniqueOutcomes);
     return state.identityFailure === undefined
         ? { outcomes }

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/indexing/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/indexing/orchestrator.ts"],"names":[],"mappings":"AA0EA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AA4lCpB,wBAAuB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAAC,aAAa,CAAC,CA2B5F"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/indexing/orchestrator.ts"],"names":[],"mappings":"AA0EA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AA6nCpB,wBAAuB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAAC,aAAa,CAAC,CA2B5F"}