@oscharko-dev/keiko 0.2.0-beta.3 → 0.2.0-beta.4

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

@@ -8,7 +8,7 @@
 //   * deleteCapsule relies on the schema's ON DELETE CASCADE chain (#265). Removing the
 //     CASCADE clause from any dependent table will either throw an FK violation (when
 //     foreign_keys=ON catches a leftover) or leave orphan rows the cascade test catches.
-import { DELETE_CAPSULE_SQL, } from "@oscharko-dev/keiko-contracts";
+import { DELETE_CAPSULE_SQL, isSafeStorageReference, isSafeDisplaySummary, } from "@oscharko-dev/keiko-contracts";
 import { KnowledgeNotFoundError, KnowledgeStoreError } from "./errors.js";
 const INSERT_CAPSULE_SQL = [
     "INSERT INTO capsules (",
@@ -52,6 +52,27 @@ function parseTags(json) {
         return [];
     return parsed.filter((entry) => typeof entry === "string");
 }
+function assertSafeDisplayField(field, value) {
+    if (value.trim().length === 0 || !isSafeDisplaySummary(value)) {
+        throw new KnowledgeStoreError(`${field} must be a browser-safe non-empty string`);
+    }
+}
+function assertSafeOptionalDisplayField(field, value) {
+    if (value !== undefined && !isSafeDisplaySummary(value)) {
+        throw new KnowledgeStoreError(`${field} must be browser-safe when set`);
+    }
+}
+function assertSafeCreateCapsuleInput(input) {
+    assertSafeDisplayField("displayName", input.displayName);
+    assertSafeOptionalDisplayField("description", input.description);
+    assertSafeOptionalDisplayField("sourceRoutingInstructions", input.sourceRoutingInstructions);
+    for (const tag of input.tags) {
+        assertSafeDisplayField("tag", tag);
+    }
+    if (!isSafeStorageReference(input.storageReference)) {
+        throw new KnowledgeStoreError("storageReference must be a safe relative path");
+    }
+}
 function listSourceIdsFor(store, capsuleId) {
     const rows = store._internal.db.prepare(SELECT_SOURCE_IDS_FOR_CAPSULE_SQL).all({ c: capsuleId });
     return rows.map((row) => row.id);
@@ -103,6 +124,7 @@ function withOptionalCapsuleFields(base, row) {
     return result;
 }
 export function createCapsule(store, input, auditSink) {
+    assertSafeCreateCapsuleInput(input);
     const now = store._internal.now();
     const params = {
         id: input.id,
@@ -195,10 +217,12 @@ export function updateCapsuleDetails(store, id, patch) {
     const assignments = [];
     const params = { id, now: store._internal.now() };
     if (patch.displayName !== undefined) {
+        assertSafeDisplayField("displayName", patch.displayName);
         assignments.push("display_name = :displayName");
         params.displayName = patch.displayName;
     }
     if (patch.description !== undefined) {
+        assertSafeOptionalDisplayField("description", patch.description);
         assignments.push("description = :description");
         params.description = patch.description;
     }

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/capsule-set-lifecycle.d.ts

@@ -1,4 +1,4 @@
-import type { CapsuleSet, CapsuleSetId, KnowledgeCapsuleId } from "@oscharko-dev/keiko-contracts";
+import { type CapsuleSet, type CapsuleSetId, type KnowledgeCapsuleId } from "@oscharko-dev/keiko-contracts";
 import type { KnowledgeStore } from "./store.js";
 export interface CreateCapsuleSetInput {
     readonly id: CapsuleSetId;

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/capsule-set-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capsule-set-lifecycle.d.ts","sourceRoot":"","sources":["../src/capsule-set-lifecycle.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGlG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACpD;AA4ED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,MAAM,GACV,IAAI,CAkBN;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,qBAAqB,GAAG,UAAU,CAsBhG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,CAQ7F;AAOD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,UAAU,EAAE,CAe5E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,GAAG,IAAI,CAiB9E"}
+{"version":3,"file":"capsule-set-lifecycle.d.ts","sourceRoot":"","sources":["../src/capsule-set-lifecycle.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACpD;AAwFD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,MAAM,GACV,IAAI,CAuBN;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,qBAAqB,GAAG,UAAU,CAsBhG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,CAQ7F;AAOD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,UAAU,EAAE,CAe5E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,GAAG,IAAI,CAiB9E"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/capsule-set-lifecycle.js

@@ -9,11 +9,22 @@
 // payload `{displayName, description?, tags, composedAt}`. Members live in their declared
 // table. Deleting a capsule cascades to the membership row via the FK from #265; this
 // module does not need to chase it.
+import { isSafeDisplaySummary, } from "@oscharko-dev/keiko-contracts";
 import { KnowledgeNotFoundError, KnowledgeStoreError } from "./errors.js";
 const META_PREFIX = "capsule_set:";
 function metaKey(id) {
     return `${META_PREFIX}${String(id)}`;
 }
+function assertSafeDisplayField(field, value) {
+    if (value.trim().length === 0 || !isSafeDisplaySummary(value)) {
+        throw new KnowledgeStoreError(`${field} must be a browser-safe non-empty string`);
+    }
+}
+function assertSafeOptionalDisplayField(field, value) {
+    if (value !== undefined && !isSafeDisplaySummary(value)) {
+        throw new KnowledgeStoreError(`${field} must be browser-safe when set`);
+    }
+}
 function parseMeta(value, id) {
     const parsed = JSON.parse(value);
     if (typeof parsed !== "object" || parsed === null) {
@@ -58,6 +69,11 @@ function metaToCapsuleSet(id, payload, capsuleIds) {
 // wraps it in its own transaction) and by runComposeTransaction (which needs to combine the
 // set creation and audit writes in one atomic outer transaction).
 export function createCapsuleSetWithinTxn(store, input, now) {
+    assertSafeDisplayField("displayName", input.displayName);
+    assertSafeOptionalDisplayField("description", input.description);
+    for (const tag of input.tags) {
+        assertSafeDisplayField("tag", tag);
+    }
     const db = store._internal.db;
     const payload = {
         displayName: input.displayName,

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/chunking/chunker-persist.d.ts

@@ -10,11 +10,13 @@ export interface ChunkInsertRow {
     readonly tokenCount: number;
     readonly safeExcerptHash: string;
     readonly chunkingStrategyVersion: string;
+    readonly characterStart: number;
+    readonly characterEnd: number;
 }
 export declare function insertChunkRow(db: DatabaseSync, row: ChunkInsertRow): void;
 export declare function deleteChunksForDocument(db: DatabaseSync, capsuleId: KnowledgeCapsuleId, documentId: DocumentId): void;
 export declare function countChunksForDocument(db: DatabaseSync, capsuleId: KnowledgeCapsuleId, documentId: DocumentId): number;
-export declare function hasStaleChunksForDocument(db: DatabaseSync, capsuleId: KnowledgeCapsuleId, documentId: DocumentId): boolean;
+export declare function hasStaleChunksForDocument(db: DatabaseSync, capsuleId: KnowledgeCapsuleId, documentId: DocumentId, chunkingStrategyVersion?: string): boolean;
 export declare function selectDocumentSourceId(db: DatabaseSync, capsuleId: KnowledgeCapsuleId, documentId: DocumentId): KnowledgeSourceId | undefined;
 export interface ParsedUnitRow {
     readonly id: string;

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/chunking/chunker-persist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunker-persist.d.ts","sourceRoot":"","sources":["../../src/chunking/chunker-persist.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmChD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAY1E;AAED,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,UAAU,GACrB,IAAI,CAEN;AAMD,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,UAAU,GACrB,MAAM,CAKR;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,UAAU,GACrB,OAAO,CAOT;AAMD,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,UAAU,GACrB,iBAAiB,GAAG,SAAS,CAK/B;AAKD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,UAAU,GACrB,SAAS,aAAa,EAAE,CAK1B"}
+{"version":3,"file":"chunker-persist.d.ts","sourceRoot":"","sources":["../../src/chunking/chunker-persist.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAqChD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IAIzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAc1E;AAED,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,UAAU,GACrB,IAAI,CAEN;AAMD,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,UAAU,GACrB,MAAM,CAKR;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,UAAU,EACtB,uBAAuB,GAAE,MAAsC,GAC9D,OAAO,CAOT;AAMD,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,UAAU,GACrB,iBAAiB,GAAG,SAAS,CAK/B;AAKD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,UAAU,GACrB,SAAS,aAAa,EAAE,CAK1B"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/chunking/chunker-persist.js

@@ -3,14 +3,16 @@
 // `chunker-runner.ts`. The runner is the only module that issues transactions for chunks —
 // mirrors the `discovery/persist.ts` boundary convention so a per-document failure rolls
 // back exactly the rows from that document.
-import { CHUNKING_STRATEGY_VERSION } from "./types.js";
+import { DEFAULT_CHUNKING_STRATEGY_KEY } from "./types.js";
 const INSERT_CHUNK_SQL = [
     "INSERT INTO chunks (",
     "  id, capsule_id, source_id, document_id, parsed_unit_id,",
-    "  order_index, token_count, safe_excerpt_hash, chunking_strategy_version",
+    "  order_index, token_count, safe_excerpt_hash, chunking_strategy_version,",
+    "  character_start, character_end",
     ") VALUES (",
     "  :id, :capsule_id, :source_id, :document_id, :parsed_unit_id,",
-    "  :order_index, :token_count, :safe_excerpt_hash, :chunking_strategy_version",
+    "  :order_index, :token_count, :safe_excerpt_hash, :chunking_strategy_version,",
+    "  :character_start, :character_end",
     ")",
 ].join(" ");
 const DELETE_CHUNKS_FOR_DOCUMENT_SQL = "DELETE FROM chunks WHERE capsule_id = :c AND document_id = :d";
@@ -39,6 +41,8 @@ export function insertChunkRow(db, row) {
         token_count: row.tokenCount,
         safe_excerpt_hash: row.safeExcerptHash,
         chunking_strategy_version: row.chunkingStrategyVersion,
+        character_start: row.characterStart,
+        character_end: row.characterEnd,
     });
 }
 export function deleteChunksForDocument(db, capsuleId, documentId) {
@@ -48,11 +52,11 @@ export function countChunksForDocument(db, capsuleId, documentId) {
     const row = db.prepare(COUNT_CHUNKS_FOR_DOCUMENT_SQL).get({ c: capsuleId, d: documentId });
     return typeof row?.n === "number" ? row.n : 0;
 }
-export function hasStaleChunksForDocument(db, capsuleId, documentId) {
+export function hasStaleChunksForDocument(db, capsuleId, documentId, chunkingStrategyVersion = DEFAULT_CHUNKING_STRATEGY_KEY) {
     const row = db.prepare(COUNT_STALE_CHUNKS_FOR_DOCUMENT_SQL).get({
         c: capsuleId,
         d: documentId,
-        v: CHUNKING_STRATEGY_VERSION,
+        v: chunkingStrategyVersion,
     });
     return (row?.n ?? 0) > 0;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"chunker-runner.d.ts","sourceRoot":"","sources":["../../src/chunking/chunker-runner.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgO5F,wBAAgB,aAAa,CAC3B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,eAAe,GACxB,mBAAmB,CAkCrB"}
+{"version":3,"file":"chunker-runner.d.ts","sourceRoot":"","sources":["../../src/chunking/chunker-runner.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA0P5F,wBAAgB,aAAa,CAC3B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,eAAe,GACxB,mBAAmB,CAkCrB"}

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

@@ -7,9 +7,9 @@
 // Idempotency: with `force: false` (default) and existing chunks already in the table,
 // the runner is a no-op and returns `skippedExisting: true`. With `force: true`, prior
 // chunks are deleted at the start of the transaction.
-import { chunkParsedUnit } from "./chunker.js";
+import { chunkParsedUnit, chunkingStrategyKey, resolveChunkingOptions } from "./chunker.js";
 import { countChunksForDocument, deleteChunksForDocument, hasStaleChunksForDocument, insertChunkRow, selectDocumentSourceId, selectParsedUnitsForDocument, } from "./chunker-persist.js";
-import { CHUNKING_STRATEGY_VERSION, ChunkingError } from "./types.js";
+import { ChunkingError } from "./types.js";
 // ─── Row → ParsedUnit reconstitution ──────────────────────────────────────────
 // The parsed_units table is the canonical write surface for #194. We re-hydrate the
 // discriminant union here so the pure chunker stays unaware of SQLite. Defensive: any
@@ -123,14 +123,26 @@ function throwIfAborted(signal) {
 function composeChunkId(documentId, parsedUnitRowId, orderIndex) {
     return `${String(documentId)}#${parsedUnitRowId}#c${String(orderIndex)}`;
 }
+function documentMaxChunks(options) {
+    return resolveChunkingOptions(options).maxChunks;
+}
+function optionsWithRemainingChunkBudget(options, remaining) {
+    return options === undefined ? { maxChunks: remaining } : { ...options, maxChunks: remaining };
+}
 function persistAllChunks(store, ctx, rows, options, signal) {
     const db = store._internal.db;
     const chunkIds = [];
+    const maxChunks = documentMaxChunks(options);
+    const strategyKey = chunkingStrategyKey(options);
     let orderIndex = 0;
     for (const row of rows) {
         throwIfAborted(signal);
+        const remaining = maxChunks - chunkIds.length;
+        if (remaining <= 0) {
+            throw new ChunkingError(`chunkDocument exceeded maxChunks ${String(maxChunks)}`);
+        }
         const unit = rowToParsedUnit(row, ctx.documentId);
-        const chunks = chunkParsedUnit(unit, ctx.sourceText, options);
+        const chunks = chunkParsedUnit(unit, ctx.sourceText, optionsWithRemainingChunkBudget(options, remaining));
         for (const chunk of chunks) {
             const id = composeChunkId(ctx.documentId, row.id, orderIndex);
             insertChunkRow(db, {
@@ -142,7 +154,9 @@ function persistAllChunks(store, ctx, rows, options, signal) {
                 orderIndex,
                 tokenCount: chunk.tokenCount,
                 safeExcerptHash: chunk.safeExcerptHash,
-                chunkingStrategyVersion: CHUNKING_STRATEGY_VERSION,
+                chunkingStrategyVersion: strategyKey,
+                characterStart: chunk.characterStart,
+                characterEnd: chunk.characterEnd,
             });
             chunkIds.push(id);
             orderIndex += 1;
@@ -150,12 +164,13 @@ function persistAllChunks(store, ctx, rows, options, signal) {
     }
     return chunkIds;
 }
-function loadChunkingPreflight(store, capsuleId, documentId) {
+function loadChunkingPreflight(store, capsuleId, documentId, options) {
     const db = store._internal.db;
     const existingCount = countChunksForDocument(db, capsuleId, documentId);
     return {
         existingCount,
-        staleChunks: existingCount > 0 && hasStaleChunksForDocument(db, capsuleId, documentId),
+        staleChunks: existingCount > 0 &&
+            hasStaleChunksForDocument(db, capsuleId, documentId, chunkingStrategyKey(options)),
     };
 }
 function assertDocumentSourceMatches(store, capsuleId, documentId, sourceId) {
@@ -174,7 +189,7 @@ export function chunkDocument(store, params, options) {
     const { capsuleId, sourceId, documentId, sourceText, force, signal } = params;
     throwIfAborted(signal);
     const db = store._internal.db;
-    const preflight = loadChunkingPreflight(store, capsuleId, documentId);
+    const preflight = loadChunkingPreflight(store, capsuleId, documentId, options);
     assertDocumentSourceMatches(store, capsuleId, documentId, sourceId);
     if (shouldReuseExistingChunks(preflight, force)) {
         return { capsuleId, documentId, chunkIds: [], skippedExisting: true };

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

@@ -1,4 +1,7 @@
 import type { ParsedUnit } from "@oscharko-dev/keiko-contracts";
-import type { ChunkingOptions, ChunkingResult } from "./types.js";
+import type { ChunkingOptions, ChunkingResult, ResolvedChunkingOptions } from "./types.js";
+export declare function resolveChunkingOptions(options: ChunkingOptions | undefined): ResolvedChunkingOptions;
+export declare function chunkingStrategyKey(options: ChunkingOptions | undefined): string;
+export declare function chunkDedupeKey(text: string): string | undefined;
 export declare function chunkParsedUnit(unit: ParsedUnit, sourceText: string, options?: ChunkingOptions): readonly ChunkingResult[];
 //# sourceMappingURL=chunker.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/chunking/chunker.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAGf,MAAM,YAAY,CAAC;AAqEpB,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,SAAS,cAAc,EAAE,CAoB3B"}
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/chunking/chunker.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EAExB,MAAM,YAAY,CAAC;AAiCpB,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,GAAG,SAAS,GACnC,uBAAuB,CAgBzB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAWhF;AAuBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK/D;AAuDD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,SAAS,cAAc,EAAE,CAyB3B"}

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

@@ -20,14 +20,44 @@
 //      tradeoff is intentional and documented.
 import { createHash } from "node:crypto";
 import { charsForTokenBudget } from "./token-estimator.js";
-import { DEFAULT_MAX_TOKENS, DEFAULT_MIN_TOKENS, DEFAULT_OVERLAP_TOKENS } from "./types.js";
+import { ChunkingError, DEFAULT_CHUNKING_STRATEGY_KEY, DEFAULT_MAX_CHUNKS, DEFAULT_MAX_TOKENS, DEFAULT_MIN_TOKENS, DEFAULT_OVERLAP_TOKENS, MAX_CHUNK_TOKENS, MAX_OVERLAP_TOKENS, CHUNKING_STRATEGY_VERSION, } from "./types.js";
 import { defaultTokenEstimator } from "./token-estimator.js";
-function resolveOptions(options) {
-    const maxTokens = options?.maxTokens ?? DEFAULT_MAX_TOKENS;
-    const minTokens = options?.minTokens ?? DEFAULT_MIN_TOKENS;
-    const overlapTokens = options?.overlapTokens ?? DEFAULT_OVERLAP_TOKENS;
+const WHITESPACE_PATTERN = /\s+/gu;
+const INFORMATIVE_CHARACTER_PATTERN = /[\p{L}\p{N}]/u;
+function positiveInteger(raw, fallback, field) {
+    const value = raw ?? fallback;
+    if (!Number.isFinite(value) || value < 1) {
+        throw new ChunkingError(`${field} must be a positive finite integer`);
+    }
+    return Math.floor(value);
+}
+function nonNegativeInteger(raw, fallback, field) {
+    const value = raw ?? fallback;
+    if (!Number.isFinite(value) || value < 0) {
+        throw new ChunkingError(`${field} must be a non-negative finite integer`);
+    }
+    return Math.floor(value);
+}
+export function resolveChunkingOptions(options) {
+    const maxTokens = Math.min(positiveInteger(options?.maxTokens, DEFAULT_MAX_TOKENS, "maxTokens"), MAX_CHUNK_TOKENS);
+    const minTokens = nonNegativeInteger(options?.minTokens, DEFAULT_MIN_TOKENS, "minTokens");
+    const overlapTokens = Math.min(nonNegativeInteger(options?.overlapTokens, DEFAULT_OVERLAP_TOKENS, "overlapTokens"), MAX_OVERLAP_TOKENS);
+    const maxChunks = Math.min(positiveInteger(options?.maxChunks, DEFAULT_MAX_CHUNKS, "maxChunks"), DEFAULT_MAX_CHUNKS);
     const tokenEstimator = options?.tokenEstimator ?? defaultTokenEstimator;
-    return { maxTokens, minTokens, overlapTokens, tokenEstimator };
+    return { maxTokens, minTokens, overlapTokens, maxChunks, tokenEstimator };
+}
+export function chunkingStrategyKey(options) {
+    if (options === undefined)
+        return DEFAULT_CHUNKING_STRATEGY_KEY;
+    const resolved = resolveChunkingOptions(options);
+    return [
+        CHUNKING_STRATEGY_VERSION,
+        `max=${String(resolved.maxTokens)}`,
+        `min=${String(resolved.minTokens)}`,
+        `overlap=${String(resolved.overlapTokens)}`,
+        `limit=${String(resolved.maxChunks)}`,
+        options.tokenEstimator === undefined ? "estimator=default" : "estimator=custom",
+    ].join("|");
 }
 function spanForUnit(unit, sourceLength) {
     if (unit.kind === "unsupported-media")
@@ -41,8 +71,21 @@ function spanForUnit(unit, sourceLength) {
 function hashExcerpt(text) {
     return createHash("sha256").update(text, "utf8").digest("hex");
 }
+function normaliseChunkText(text) {
+    return text.normalize("NFKC").replace(WHITESPACE_PATTERN, " ").trim();
+}
+export function chunkDedupeKey(text) {
+    const normalised = normaliseChunkText(text);
+    if (normalised.length === 0)
+        return undefined;
+    if (!INFORMATIVE_CHARACTER_PATTERN.test(normalised))
+        return undefined;
+    return hashExcerpt(normalised);
+}
 function buildChunk(sourceText, start, end, estimator) {
     const excerpt = sourceText.slice(start, end);
+    if (chunkDedupeKey(excerpt) === undefined)
+        return undefined;
     return {
         characterStart: start,
         characterEnd: end,
@@ -64,21 +107,30 @@ function shouldEmitSingleChunk(excerpt, resolved) {
     // produces one chunk so we never drop content (spec edge case: "Single tiny unit").
     return resolved.tokenEstimator(excerpt) <= resolved.maxTokens;
 }
+function pushChunk(chunks, chunk, maxChunks) {
+    if (chunk === undefined)
+        return;
+    if (chunks.length >= maxChunks) {
+        throw new ChunkingError(`chunkParsedUnit exceeded maxChunks ${String(maxChunks)}`);
+    }
+    chunks.push(chunk);
+}
 export function chunkParsedUnit(unit, sourceText, options) {
-    const resolved = resolveOptions(options);
+    const resolved = resolveChunkingOptions(options);
     const span = spanForUnit(unit, sourceText.length);
     if (span === undefined)
         return [];
     const excerpt = sourceText.slice(span.start, span.end);
     if (shouldEmitSingleChunk(excerpt, resolved)) {
-        return [buildChunk(sourceText, span.start, span.end, resolved.tokenEstimator)];
+        const chunk = buildChunk(sourceText, span.start, span.end, resolved.tokenEstimator);
+        return chunk === undefined ? [] : [chunk];
     }
     const { maxChars, stride } = computeStepSizes(resolved);
     const chunks = [];
     let cursor = span.start;
     while (cursor < span.end) {
         const end = Math.min(cursor + maxChars, span.end);
-        chunks.push(buildChunk(sourceText, cursor, end, resolved.tokenEstimator));
+        pushChunk(chunks, buildChunk(sourceText, cursor, end, resolved.tokenEstimator), resolved.maxChunks);
         if (end >= span.end)
             break;
         cursor += stride;

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/chunking/citation-mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"citation-mapper.d.ts","sourceRoot":"","sources":["../../src/chunking/citation-mapper.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,iBAAiB,EAEjB,kBAAkB,EAEnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkMlD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE,YAAY,GAC3B,iBAAiB,GAAG,IAAI,CAc1B"}
+{"version":3,"file":"citation-mapper.d.ts","sourceRoot":"","sources":["../../src/chunking/citation-mapper.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,iBAAiB,EAEjB,kBAAkB,EAEnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAyOlD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE,YAAY,GAC3B,iBAAiB,GAAG,IAAI,CAc1B"}

package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/chunking/citation-mapper.js

@@ -13,15 +13,17 @@
 //        - kind=page: copy pageNumber/pageLabel + characterStart/End directly.
 //        - kind=section: copy sectionPath + characterStart/End directly.
 //        - kind=html-block: copy headingPath + characterStart/End.
-//        - other kinds (json-path, csv-row, unsupported-media): characterStart/End only.
+//        - kind=json-path: copy jsonPointer + characterStart/End.
+//        - kind=csv-row: copy tableName/rowIndex + characterStart/End.
+//        - other kinds (unsupported-media): characterStart/End only.
 //      THEN: if the parsed_unit's span overlaps any persisted `pages` row, attach that
 //      page's pageNumber/pageLabel — section units inside a paged document still
 //      surface a citation page number.
 //   4. Document row provides safeDisplayName + sourceId.
-const SELECT_CHUNK_SQL = "SELECT id, capsule_id, source_id, document_id, parsed_unit_id FROM chunks WHERE capsule_id = :c AND id = :id";
+const SELECT_CHUNK_SQL = "SELECT id, capsule_id, source_id, document_id, parsed_unit_id, character_start, character_end FROM chunks WHERE capsule_id = :c AND id = :id";
 const SELECT_PARSED_UNIT_SQL = [
     "SELECT kind, page_number, page_label, section_path_json,",
-    "  heading_path_json, character_start, character_end",
+    "  heading_path_json, json_pointer, table_name, row_index, character_start, character_end",
     "FROM parsed_units",
     "WHERE capsule_id = :c AND id = :id",
 ].join(" ");
@@ -62,43 +64,66 @@ function parseStringArray(raw) {
     }
     return parsed;
 }
-function hopFieldsForUnit(unit) {
-    const characterStart = unit.character_start ?? undefined;
-    const characterEnd = unit.character_end ?? undefined;
-    if (unit.kind === "page") {
-        return {
+function baseHopFields(unit) {
+    return {
+        pageNumber: undefined,
+        pageLabel: undefined,
+        sectionPath: undefined,
+        jsonPointer: undefined,
+        tableName: undefined,
+        rowIndex: undefined,
+        characterStart: unit.character_start ?? undefined,
+        characterEnd: unit.character_end ?? undefined,
+    };
+}
+const HOP_FIELDS_BY_KIND = new Map([
+    [
+        "page",
+        (unit, base) => ({
+            ...base,
             pageNumber: unit.page_number ?? undefined,
             pageLabel: unit.page_label ?? undefined,
-            sectionPath: undefined,
-            characterStart,
-            characterEnd,
-        };
-    }
-    if (unit.kind === "section") {
-        return {
-            pageNumber: undefined,
-            pageLabel: undefined,
+        }),
+    ],
+    [
+        "section",
+        (unit, base) => ({
+            ...base,
             sectionPath: parseStringArray(unit.section_path_json),
-            characterStart,
-            characterEnd,
-        };
-    }
-    if (unit.kind === "html-block") {
-        return {
-            pageNumber: undefined,
-            pageLabel: undefined,
+        }),
+    ],
+    [
+        "html-block",
+        (unit, base) => ({
+            ...base,
             sectionPath: parseStringArray(unit.heading_path_json),
-            characterStart,
-            characterEnd,
-        };
-    }
-    // json-path / csv-row / unsupported-media — character offsets only when present.
+        }),
+    ],
+    [
+        "json-path",
+        (unit, base) => ({
+            ...base,
+            jsonPointer: unit.json_pointer ?? undefined,
+        }),
+    ],
+    [
+        "csv-row",
+        (unit, base) => ({
+            ...base,
+            tableName: unit.table_name ?? undefined,
+            rowIndex: unit.row_index ?? undefined,
+        }),
+    ],
+]);
+function hopFieldsForUnit(unit) {
+    const base = baseHopFields(unit);
+    return HOP_FIELDS_BY_KIND.get(unit.kind)?.(unit, base) ?? base;
+}
+function applyChunkSpan(hop, chunk) {
     return {
-        pageNumber: undefined,
-        pageLabel: undefined,
-        sectionPath: undefined,
-        characterStart,
-        characterEnd,
+        ...hop,
+        characterStart: chunk.character_start ?? hop.characterStart,
+        characterEnd: chunk.character_end ?? hop.characterEnd,
     };
 }
 function attachPageHop(db, capsuleId, documentId, hop) {
@@ -128,6 +153,9 @@ function buildCitation(chunk, document, hop, chunkId, capsuleId) {
         ...(hop.pageNumber !== undefined ? { pageNumber: hop.pageNumber } : {}),
         ...(hop.pageLabel !== undefined ? { pageLabel: hop.pageLabel } : {}),
         ...(hop.sectionPath !== undefined ? { sectionPath: hop.sectionPath } : {}),
+        ...(hop.jsonPointer !== undefined ? { jsonPointer: hop.jsonPointer } : {}),
+        ...(hop.tableName !== undefined ? { tableName: hop.tableName } : {}),
+        ...(hop.rowIndex !== undefined ? { rowIndex: hop.rowIndex } : {}),
         ...(hop.characterStart !== undefined ? { characterStart: hop.characterStart } : {}),
         ...(hop.characterEnd !== undefined ? { characterEnd: hop.characterEnd } : {}),
     };
@@ -146,7 +174,7 @@ export function mapChunkToCitation(store, capsuleId, chunkId, _capsuleSetId) {
     const document = fetchDocumentRow(db, capsuleId, chunk.document_id);
     if (document === undefined)
         return null;
-    const baseHop = hopFieldsForUnit(unit);
+    const baseHop = applyChunkSpan(hopFieldsForUnit(unit), chunk);
     const hop = attachPageHop(db, capsuleId, chunk.document_id, baseHop);
     return buildCitation(chunk, document, hop, chunkId, capsuleId);
 }

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

@@ -1,6 +1,6 @@
-export { chunkParsedUnit } from "./chunker.js";
+export { chunkDedupeKey, chunkParsedUnit, chunkingStrategyKey, resolveChunkingOptions, } from "./chunker.js";
 export { chunkDocument } from "./chunker-runner.js";
 export { mapChunkToCitation } from "./citation-mapper.js";
 export { defaultTokenEstimator, charsForTokenBudget } from "./token-estimator.js";
-export { CHUNKING_STRATEGY_VERSION, ChunkingError, DEFAULT_MAX_TOKENS, DEFAULT_MIN_TOKENS, DEFAULT_OVERLAP_TOKENS, type ChunkDocumentParams, type ChunkDocumentResult, type ChunkingOptions, type ChunkingResult, type ResolvedChunkingOptions, type TokenEstimator, } from "./types.js";
+export { CHUNKING_STRATEGY_VERSION, ChunkingError, DEFAULT_CHUNKING_STRATEGY_KEY, DEFAULT_MAX_CHUNKS, DEFAULT_MAX_TOKENS, DEFAULT_MIN_TOKENS, DEFAULT_OVERLAP_TOKENS, MAX_CHUNK_TOKENS, MAX_OVERLAP_TOKENS, type ChunkDocumentParams, type ChunkDocumentResult, type ChunkingOptions, type ChunkingResult, type ResolvedChunkingOptions, type TokenEstimator, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chunking/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chunking/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}

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

@@ -1,8 +1,8 @@
 // Barrel for the chunking layer (Epic #189, Issue #195). Composed by the package barrel
 // in ../index.ts; consumers outside the package never import from this subdirectory
 // directly (ADR-0019 direction rule 3e + the trust-8 test-support naming convention).
-export { chunkParsedUnit } from "./chunker.js";
+export { chunkDedupeKey, chunkParsedUnit, chunkingStrategyKey, resolveChunkingOptions, } from "./chunker.js";
 export { chunkDocument } from "./chunker-runner.js";
 export { mapChunkToCitation } from "./citation-mapper.js";
 export { defaultTokenEstimator, charsForTokenBudget } from "./token-estimator.js";
-export { CHUNKING_STRATEGY_VERSION, ChunkingError, DEFAULT_MAX_TOKENS, DEFAULT_MIN_TOKENS, DEFAULT_OVERLAP_TOKENS, } from "./types.js";
+export { CHUNKING_STRATEGY_VERSION, ChunkingError, DEFAULT_CHUNKING_STRATEGY_KEY, DEFAULT_MAX_CHUNKS, DEFAULT_MAX_TOKENS, DEFAULT_MIN_TOKENS, DEFAULT_OVERLAP_TOKENS, MAX_CHUNK_TOKENS, MAX_OVERLAP_TOKENS, } from "./types.js";

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

@@ -5,16 +5,22 @@ export interface ChunkingOptions {
     readonly maxTokens?: number;
     readonly minTokens?: number;
     readonly overlapTokens?: number;
+    readonly maxChunks?: number;
     readonly tokenEstimator?: TokenEstimator;
 }
 export declare const DEFAULT_MAX_TOKENS = 400;
 export declare const DEFAULT_MIN_TOKENS = 64;
 export declare const DEFAULT_OVERLAP_TOKENS = 32;
-export declare const CHUNKING_STRATEGY_VERSION: "issue-195-v1";
+export declare const DEFAULT_MAX_CHUNKS = 50000;
+export declare const MAX_CHUNK_TOKENS = 2048;
+export declare const MAX_OVERLAP_TOKENS = 1024;
+export declare const CHUNKING_STRATEGY_VERSION: "issue-195-v2";
+export declare const DEFAULT_CHUNKING_STRATEGY_KEY: `issue-195-v2|max=${string}|min=${string}|overlap=${string}|limit=${string}|estimator=default`;
 export interface ResolvedChunkingOptions {
     readonly maxTokens: number;
     readonly minTokens: number;
     readonly overlapTokens: number;
+    readonly maxChunks: number;
     readonly tokenEstimator: TokenEstimator;
 }
 export interface ChunkDocumentParams {

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/chunking/types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAGD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,yBAAyB,EAAG,cAAuB,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAID,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAIhC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAEtC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAKD,qBAAa,aAAc,SAAQ,mBAAmB;IACpD,SAAyB,IAAI,EAAE,MAAM,CAAmB;CACzD;AAKD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/chunking/types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAGD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AACtC,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AACxC,eAAO,MAAM,yBAAyB,EAAG,cAAuB,CAAC;AACjE,eAAO,MAAM,6BAA6B,gGACmK,CAAC;AAE9M,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAID,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAIhC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAEtC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAKD,qBAAa,aAAc,SAAQ,mBAAmB;IACpD,SAAyB,IAAI,EAAE,MAAM,CAAmB;CACzD;AAKD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC"}

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

@@ -13,7 +13,11 @@ import { KnowledgeStoreError } from "../errors.js";
 export const DEFAULT_MAX_TOKENS = 400;
 export const DEFAULT_MIN_TOKENS = 64;
 export const DEFAULT_OVERLAP_TOKENS = 32;
-export const CHUNKING_STRATEGY_VERSION = "issue-195-v1";
+export const DEFAULT_MAX_CHUNKS = 50_000;
+export const MAX_CHUNK_TOKENS = 2_048;
+export const MAX_OVERLAP_TOKENS = 1_024;
+export const CHUNKING_STRATEGY_VERSION = "issue-195-v2";
+export const DEFAULT_CHUNKING_STRATEGY_KEY = `${CHUNKING_STRATEGY_VERSION}|max=${String(DEFAULT_MAX_TOKENS)}|min=${String(DEFAULT_MIN_TOKENS)}|overlap=${String(DEFAULT_OVERLAP_TOKENS)}|limit=${String(DEFAULT_MAX_CHUNKS)}|estimator=default`;
 // Distinct from KnowledgeStoreError so a test asserting "chunking guard fail-closed" cannot
 // accidentally accept any other error class. Extends KnowledgeStoreError so callers that
 // only catch the parent class still see the failure.

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

@@ -1,4 +1,4 @@
-import type { CapsuleSet, CapsuleSetId, KnowledgeCapsuleId, KnowledgeSourceId, KnowledgeSourceScopeKind } from "@oscharko-dev/keiko-contracts";
+import { type CapsuleSet, type CapsuleSetId, type KnowledgeCapsuleId, type KnowledgeSourceId, type KnowledgeSourceScopeKind } from "@oscharko-dev/keiko-contracts";
 import { type AddCapsuleSourceInput } from "./source-lifecycle.js";
 import type { KnowledgeStore } from "./store.js";
 export type CompositionErrorCode = "empty-source-batch" | "duplicate-source-in-batch" | "source-already-linked" | "empty-capsule-list" | "duplicate-capsule-in-batch";

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

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