@oscharko-dev/keiko-local-knowledge 0.2.0

package/dist/privacy/index.d.ts

@@ -0,0 +1,5 @@
+export type { CapsuleRetentionPolicy, CapsuleAuditEvent, AuditEventSink, RetentionApplyResult, } from "./types.js";
+export { redactDiagnosticMessage } from "./diagnostic-redactor.js";
+export { applyRetentionToCapsule } from "./retention-applier.js";
+export { emitCapsuleAuditEvent, createSqliteAuditSink } from "./audit-emitter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/privacy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/privacy/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/privacy/index.js

@@ -0,0 +1,6 @@
+// Public surface of the privacy / retention / audit layer (Epic #189, Issue #201). The
+// package barrel re-exports this module so consumers can import retention and audit
+// helpers from the top-level `@oscharko-dev/keiko-local-knowledge` entry point.
+export { redactDiagnosticMessage } from "./diagnostic-redactor.js";
+export { applyRetentionToCapsule } from "./retention-applier.js";
+export { emitCapsuleAuditEvent, createSqliteAuditSink } from "./audit-emitter.js";

package/dist/privacy/retention-applier.d.ts

@@ -0,0 +1,5 @@
+import type { KnowledgeCapsuleId } from "@oscharko-dev/keiko-contracts";
+import type { KnowledgeStore } from "../store.js";
+import type { AuditEventSink, CapsuleRetentionPolicy, RetentionApplyResult } from "./types.js";
+export declare function applyRetentionToCapsule(store: KnowledgeStore, capsuleId: KnowledgeCapsuleId, policy: CapsuleRetentionPolicy, now: number, auditSink?: AuditEventSink): RetentionApplyResult;
+//# sourceMappingURL=retention-applier.d.ts.map

package/dist/privacy/retention-applier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-applier.d.ts","sourceRoot":"","sources":["../../src/privacy/retention-applier.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,+BAA+B,CAAC;AAG3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAiE/F,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,cAAc,GACzB,oBAAoB,CA4CtB"}

package/dist/privacy/retention-applier.js

@@ -0,0 +1,88 @@
+// applyRetentionToCapsule — bounded DELETE that prunes a capsule's vectors / extracted
+// text rows older than the policy window. Pure SQL — no side effects beyond these scoped
+// statements. The `WHERE capsule_id = :capsule_id` clauses are load-bearing: the cascade
+// isolation test in `./retention-applier.test.ts` removes the function's ability to delete
+// cross-capsule rows by relying on those clauses to scope each statement.
+//
+// Schema notes (cf. packages/keiko-contracts/src/local-knowledge-schema.ts):
+//   * `vectors.created_at` is the embedding-write timestamp — the right column for the
+//     "vector retention" window.
+//   * `document_texts` contains raw normalized text and is the row count reported as
+//     deletedExtractedTextCount. `parsed_units` has no time column of its own; its cleanup
+//     is keyed off `documents.last_extracted_at` via the same subquery. The chunks/vectors
+//     that hang off the deleted parsed_units cascade via composite FK (chunks →
+//     parsed_units, vectors → chunks).
+//   * Both statements are issued inside a single BEGIN/COMMIT so a crash mid-retention
+//     cannot leave half the policy applied (matches the source/composition lifecycles).
+//   * A missing field on the policy SKIPS the corresponding statement — `undefined` means
+//     "retain indefinitely", per the types.ts contract.
+import { KnowledgeStoreError } from "../errors.js";
+const DAY_MS = 86_400_000;
+const DELETE_OLD_VECTORS_SQL = "DELETE FROM vectors WHERE capsule_id = :capsule_id AND created_at < :cutoff";
+const DELETE_OLD_PARSED_UNITS_SQL = "DELETE FROM parsed_units WHERE capsule_id = :capsule_id AND document_id IN " +
+    "(SELECT id FROM documents WHERE capsule_id = :capsule_id AND last_extracted_at < :cutoff)";
+const DELETE_OLD_DOCUMENT_TEXTS_SQL = "DELETE FROM document_texts WHERE capsule_id = :capsule_id AND document_id IN " +
+    "(SELECT id FROM documents WHERE capsule_id = :capsule_id AND last_extracted_at < :cutoff)";
+function cutoffFor(now, days) {
+    return now - days * DAY_MS;
+}
+function parseRetentionDays(field, value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        throw new KnowledgeStoreError(`${field} must be a finite non-negative number when set`);
+    }
+    return value;
+}
+function runDelete(store, sql, capsuleId, cutoff) {
+    const stmt = store._internal.db.prepare(sql);
+    stmt.run({ capsule_id: capsuleId, cutoff });
+    // Read the change count via `SELECT changes()` so the helper is independent of the
+    // node:sqlite result-shape; the function is connection-scoped and returns the row
+    // count touched by the most recent INSERT/UPDATE/DELETE on that connection.
+    const row = store._internal.db.prepare("SELECT changes() AS changes").get();
+    return row?.changes ?? 0;
+}
+function sourceIdsForCapsule(store, capsuleId) {
+    const rows = store._internal.db
+        .prepare("SELECT id FROM capsule_sources WHERE capsule_id = :capsule_id ORDER BY id ASC")
+        .all({ capsule_id: capsuleId });
+    return rows.map((row) => row.id);
+}
+export function applyRetentionToCapsule(store, capsuleId, policy, now, auditSink) {
+    const retainVectorsDays = parseRetentionDays("retainVectorsDays", policy.retainVectorsDays);
+    const retainExtractedTextDays = parseRetentionDays("retainExtractedTextDays", policy.retainExtractedTextDays);
+    if (retainVectorsDays === undefined && retainExtractedTextDays === undefined) {
+        return { capsuleId, deletedVectorCount: 0, deletedExtractedTextCount: 0, appliedAt: now };
+    }
+    const db = store._internal.db;
+    let deletedVectorCount = 0;
+    let deletedExtractedTextCount = 0;
+    db.exec("BEGIN");
+    try {
+        if (retainVectorsDays !== undefined) {
+            const vectorCutoff = cutoffFor(now, retainVectorsDays);
+            deletedVectorCount = runDelete(store, DELETE_OLD_VECTORS_SQL, capsuleId, vectorCutoff);
+        }
+        if (retainExtractedTextDays !== undefined) {
+            const textCutoff = cutoffFor(now, retainExtractedTextDays);
+            deletedExtractedTextCount = runDelete(store, DELETE_OLD_DOCUMENT_TEXTS_SQL, capsuleId, textCutoff);
+            runDelete(store, DELETE_OLD_PARSED_UNITS_SQL, capsuleId, textCutoff);
+        }
+        db.exec("COMMIT");
+    }
+    catch (error) {
+        db.exec("ROLLBACK");
+        throw error;
+    }
+    const result = { capsuleId, deletedVectorCount, deletedExtractedTextCount, appliedAt: now };
+    auditSink?.emit({
+        kind: "retention-applied",
+        capsuleId,
+        sourceIds: sourceIdsForCapsule(store, capsuleId),
+        deletedVectorCount,
+        deletedExtractedTextCount,
+        occurredAt: now,
+    });
+    return result;
+}

package/dist/privacy/types.d.ts

@@ -0,0 +1,98 @@
+import type { KnowledgeCapsuleId, KnowledgeSourceId } from "@oscharko-dev/keiko-contracts";
+export interface CapsuleRetentionPolicy {
+    readonly retainExtractedTextDays?: number;
+    readonly retainVectorsDays?: number;
+}
+export interface RetentionApplyResult {
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly deletedVectorCount: number;
+    readonly deletedExtractedTextCount: number;
+    readonly appliedAt: number;
+}
+export type CapsuleAuditEvent = CapsuleCreatedEvent | CapsuleDeletedEvent | CapsuleSourceAddedEvent | CapsuleSourceRemovedEvent | IndexingJobStartedEvent | IndexingJobCompletedEvent | IndexingJobFailedEvent | RetentionAppliedEvent | RetrievalPerformedEvent | AnswerContextAssembledEvent | ModelContextSentEvent;
+export interface CapsuleCreatedEvent {
+    readonly kind: "capsule-created";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly occurredAt: number;
+}
+export interface CapsuleDeletedEvent {
+    readonly kind: "capsule-deleted";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly occurredAt: number;
+}
+export interface CapsuleSourceAddedEvent {
+    readonly kind: "source-added";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly sourceId: KnowledgeSourceId;
+    readonly occurredAt: number;
+}
+export interface CapsuleSourceRemovedEvent {
+    readonly kind: "source-removed";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly sourceId: KnowledgeSourceId;
+    readonly occurredAt: number;
+}
+export interface IndexingJobStartedEvent {
+    readonly kind: "indexing-job-started";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly sourceIds: readonly KnowledgeSourceId[];
+    readonly jobId: string;
+    readonly occurredAt: number;
+}
+export interface IndexingJobCompletedEvent {
+    readonly kind: "indexing-job-completed";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly sourceIds: readonly KnowledgeSourceId[];
+    readonly jobId: string;
+    readonly processedDocuments: number;
+    readonly failedDocuments: number;
+    readonly occurredAt: number;
+}
+export interface IndexingJobFailedEvent {
+    readonly kind: "indexing-job-failed";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly sourceIds: readonly KnowledgeSourceId[];
+    readonly jobId: string;
+    readonly errorCode: string;
+    readonly occurredAt: number;
+}
+export interface RetentionAppliedEvent {
+    readonly kind: "retention-applied";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly sourceIds: readonly KnowledgeSourceId[];
+    readonly deletedVectorCount: number;
+    readonly deletedExtractedTextCount: number;
+    readonly occurredAt: number;
+}
+export interface RetrievalPerformedEvent {
+    readonly kind: "retrieval-performed";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly sourceIds: readonly KnowledgeSourceId[];
+    readonly chunkIds: readonly string[];
+    readonly referenceCount: number;
+    readonly noEvidence: boolean;
+    readonly occurredAt: number;
+}
+export interface AnswerContextAssembledEvent {
+    readonly kind: "answer-context-assembled";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly sourceIds: readonly KnowledgeSourceId[];
+    readonly chunkIds: readonly string[];
+    readonly referenceCount: number;
+    readonly citationCount: number;
+    readonly occurredAt: number;
+}
+export interface ModelContextSentEvent {
+    readonly kind: "model-context-sent";
+    readonly capsuleId: KnowledgeCapsuleId;
+    readonly sourceIds: readonly KnowledgeSourceId[];
+    readonly chunkIds: readonly string[];
+    readonly referenceCount: number;
+    readonly citationCount: number;
+    readonly modelId: string;
+    readonly occurredAt: number;
+}
+export interface AuditEventSink {
+    readonly emit: (event: CapsuleAuditEvent) => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/privacy/types.js

@@ -0,0 +1,12 @@
+// Public privacy / retention / audit types for the Local Knowledge Connector (Epic #189,
+// Issue #201). Kept type-only so importing this module costs nothing at runtime. The audit
+// event union deliberately carries ONLY metadata (ids, counts, error codes) — no
+// `excerpt`, `message`, or `text` field that could leak raw extracted content into the
+// audit ledger. Diagnostic-shaped strings (parser errors) flow through `redactDiagnosticMessage`
+// in `./diagnostic-redactor.ts` BEFORE they reach a `parser_diagnostics` row; they are
+// intentionally not part of `CapsuleAuditEvent`.
+//
+// `CapsuleRetentionPolicy` uses optional `readonly` fields so `undefined` (or the absence
+// of the field) means "retain indefinitely". This is enforced by `applyRetentionToCapsule`:
+// a missing field skips the corresponding DELETE entirely.
+export {};

package/dist/qualityIntelligence/capsuleCorpus.d.ts

@@ -0,0 +1,27 @@
+import type { CapsuleSetId, KnowledgeCapsuleId } from "@oscharko-dev/keiko-contracts";
+import type { KnowledgeStore } from "../store.js";
+export interface CapsuleDocumentText {
+    readonly documentId: string;
+    readonly text: string;
+}
+export interface ListCapsuleDocumentTextsOptions {
+    /** Maximum number of documents to return (SQL LIMIT). Defaults to 10 000. */
+    readonly maxDocuments?: number;
+}
+/**
+ * Returns the full normalized text for up to `maxDocuments` indexed documents in a
+ * capsule, ordered by document_id for deterministic output. Documents with empty text
+ * are skipped. Sync — reads the node:sqlite handle directly like the capsule-lifecycle
+ * queries.
+ */
+export declare function listCapsuleDocumentTexts(store: KnowledgeStore, capsuleId: string | KnowledgeCapsuleId, options?: ListCapsuleDocumentTextsOptions): readonly CapsuleDocumentText[];
+/**
+ * Returns the full corpus text for every member capsule of a capsule-set, concatenated in
+ * membership order (ordinal). Each member's documents stay ordered by document_id. An unknown
+ * capsule-set yields an empty list, which the QI ingestion layer maps to QI_CAPSULE_UNAVAILABLE.
+ * Capsule-sets are logical compositions (no own documents), so this fans out over the members and
+ * reuses {@link listCapsuleDocumentTexts} — it does not touch a new storage path (Epic #710,
+ * Issue #716/#717). Sync, like the single-capsule reader.
+ */
+export declare function listCapsuleSetDocumentTexts(store: KnowledgeStore, capsuleSetId: string | CapsuleSetId): readonly CapsuleDocumentText[];
+//# sourceMappingURL=capsuleCorpus.d.ts.map

package/dist/qualityIntelligence/capsuleCorpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsuleCorpus.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/capsuleCorpus.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,WAAW,+BAA+B;IAC9C,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,GAAG,kBAAkB,EACtC,OAAO,GAAE,+BAAoC,GAC5C,SAAS,mBAAmB,EAAE,CAkBhC;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,MAAM,GAAG,YAAY,GAClC,SAAS,mBAAmB,EAAE,CAUhC"}

package/dist/qualityIntelligence/capsuleCorpus.js

@@ -0,0 +1,58 @@
+// capsuleCorpus.ts — synchronous full-corpus reader for QI ingestion (Epic #710, Issue #717).
+//
+// Reads every indexed document text for a capsule from the `document_texts` table. The QI
+// ingestion pipeline uses this to build atoms directly from the corpus (no retrieval query),
+// so knowledge workers can generate test cases from a connected Local Knowledge connector
+// without needing a search query.
+//
+// SYNC: keiko-local-knowledge uses node:sqlite (synchronous API) throughout; this function
+// follows the same pattern used in capsule-lifecycle.ts (_internal.db.prepare().all()).
+import { getCapsuleSet } from "../capsule-set-lifecycle.js";
+// Safe default: caps the in-process document load to prevent unbounded memory
+// consumption on large capsules. Callers may override with a smaller value.
+const DEFAULT_MAX_DOCUMENTS = 10_000;
+/**
+ * Returns the full normalized text for up to `maxDocuments` indexed documents in a
+ * capsule, ordered by document_id for deterministic output. Documents with empty text
+ * are skipped. Sync — reads the node:sqlite handle directly like the capsule-lifecycle
+ * queries.
+ */
+export function listCapsuleDocumentTexts(store, capsuleId, options = {}) {
+    const limit = options.maxDocuments ?? DEFAULT_MAX_DOCUMENTS;
+    const sql = "SELECT document_id, normalized_text FROM document_texts WHERE capsule_id = ? ORDER BY document_id LIMIT ?";
+    const rows = store._internal.db.prepare(sql).all(String(capsuleId), limit);
+    const cipher = store._internal.contentCipher;
+    const result = [];
+    for (const row of rows) {
+        const documentId = row.document_id;
+        const stored = row.normalized_text;
+        if (typeof documentId !== "string" || typeof stored !== "string")
+            continue;
+        // Decrypt at the store boundary so QI ingestion always receives plaintext corpus text.
+        const text = cipher.openText(stored);
+        if (text.length > 0) {
+            result.push({ documentId, text });
+        }
+    }
+    return result;
+}
+/**
+ * Returns the full corpus text for every member capsule of a capsule-set, concatenated in
+ * membership order (ordinal). Each member's documents stay ordered by document_id. An unknown
+ * capsule-set yields an empty list, which the QI ingestion layer maps to QI_CAPSULE_UNAVAILABLE.
+ * Capsule-sets are logical compositions (no own documents), so this fans out over the members and
+ * reuses {@link listCapsuleDocumentTexts} — it does not touch a new storage path (Epic #710,
+ * Issue #716/#717). Sync, like the single-capsule reader.
+ */
+export function listCapsuleSetDocumentTexts(store, capsuleSetId) {
+    const set = getCapsuleSet(store, capsuleSetId);
+    if (set === undefined)
+        return [];
+    const result = [];
+    for (const capsuleId of set.capsuleIds) {
+        for (const doc of listCapsuleDocumentTexts(store, capsuleId)) {
+            result.push(doc);
+        }
+    }
+    return result;
+}

package/dist/qualityIntelligence/index.d.ts

@@ -0,0 +1,3 @@
+export { buildCapsuleSourceEnvelopes, QiHandoffError, type BuildCapsuleEnvelopesInput, type QiHandoffErrorCode, } from "./qiHandoff.js";
+export { listCapsuleDocumentTexts, listCapsuleSetDocumentTexts, type CapsuleDocumentText, } from "./capsuleCorpus.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/qualityIntelligence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/qualityIntelligence/index.js

@@ -0,0 +1,5 @@
+// Public barrel for the local-knowledge → Quality Intelligence handoff (Epic #270,
+// Issue #278). Pure adapter sub-namespace; re-exports the QI capsule-envelope builder
+// and the full-corpus reader added in Epic #710 (Issue #717).
+export { buildCapsuleSourceEnvelopes, QiHandoffError, } from "./qiHandoff.js";
+export { listCapsuleDocumentTexts, listCapsuleSetDocumentTexts, } from "./capsuleCorpus.js";

package/dist/qualityIntelligence/qiHandoff.d.ts

@@ -0,0 +1,36 @@
+import type { RetrievalReference } from "@oscharko-dev/keiko-contracts";
+import { QualityIntelligence } from "@oscharko-dev/keiko-contracts";
+type CapsuleEnvelope = QualityIntelligence.QualityIntelligenceLocalKnowledgeCapsuleEnvelope;
+export type QiHandoffErrorCode = "EMPTY_REFERENCE" | "EMPTY_HASH_TABLE" | "INVALID_INTEGRITY_HASH" | "INVALID_REGISTERED_AT" | "MISSING_INTEGRITY_HASH";
+export declare class QiHandoffError extends Error {
+    readonly code: QiHandoffErrorCode;
+    constructor(code: QiHandoffErrorCode, message: string);
+}
+export interface BuildCapsuleEnvelopesInput {
+    /** ISO 8601 UTC timestamp the consumer captured for envelope provenance. */
+    readonly registeredAt: string;
+    /** Retrieval references from `keiko-local-knowledge` for a single capsule query. */
+    readonly references: readonly RetrievalReference[];
+    /**
+     * SHA-256 hex digest table keyed by the citation chunkId. The adapter rejects any
+     * reference whose chunkId has no matching digest with `MISSING_INTEGRITY_HASH`.
+     */
+    readonly integrityHashByChunkId: Readonly<Record<string, string>>;
+    /**
+     * Caller-pre-validated id prefix. Each envelope id is `${idPrefix}:${chunkId}`. The
+     * contract validator (asQualityIntelligenceSourceEnvelopeId) rejects forbidden
+     * fragments — callers must guarantee the prefix passes those rules.
+     */
+    readonly idPrefix: string;
+}
+/**
+ * Convert a list of `RetrievalReference` into local-knowledge-capsule envelopes. Pure.
+ *
+ * Each envelope's `localRef` is the citation chunkId (an opaque local-knowledge
+ * identifier, never a URL or a path). The envelope display label combines the
+ * capsule's `safeDisplayName` with the chunkId so the audit ledger has a
+ * non-secret descriptor.
+ */
+export declare const buildCapsuleSourceEnvelopes: (input: BuildCapsuleEnvelopesInput) => readonly CapsuleEnvelope[];
+export {};
+//# sourceMappingURL=qiHandoff.d.ts.map

package/dist/qualityIntelligence/qiHandoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qiHandoff.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/qiHandoff.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,KAAK,eAAe,GAAG,mBAAmB,CAAC,gDAAgD,CAAC;AAG5F,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,kBAAkB,GAClB,wBAAwB,GACxB,uBAAuB,GACvB,wBAAwB,CAAC;AAE7B,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,kBAAkB,CAAC;gBAC7B,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM;CAKtD;AA4BD,MAAM,WAAW,0BAA0B;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClE;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,0BAA0B,KAChC,SAAS,eAAe,EAoC1B,CAAC"}

package/dist/qualityIntelligence/qiHandoff.js

@@ -0,0 +1,82 @@
+// Local Knowledge → Quality Intelligence handoff adapter (Epic #270, Issue #278).
+//
+// Pure adapter that turns an existing local-knowledge `RetrievalReference` list (the
+// result of a capsule retrieval) into a list of QI source envelopes with
+// `kind: "local-knowledge-capsule"`. The QI ingestion pipeline then plans / reconciles
+// these envelopes alongside repo-context envelopes through the same source-mix surface.
+//
+// Pure: no IO, no clock reads. The caller supplies a deterministic `registeredAt`
+// timestamp and a per-citation SHA-256 integrity hash. The adapter reuses ONLY
+// existing local-knowledge / contract types — it does not add a new retrieval port.
+//
+// Structurally inspired by Test Intelligence reference (TI) capsule handoffs, but the
+// envelope shape is anchored on the QI contracts surface
+// (@oscharko-dev/keiko-contracts/qualityIntelligence).
+import { QualityIntelligence } from "@oscharko-dev/keiko-contracts";
+const { asQualityIntelligenceSourceEnvelopeId } = QualityIntelligence;
+export class QiHandoffError extends Error {
+    code;
+    constructor(code, message) {
+        super(`[${code}] ${message}`);
+        this.name = "QiHandoffError";
+        this.code = code;
+    }
+}
+const HEX64 = /^[0-9a-f]{64}$/u;
+const ISO_8601 = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?Z$/u;
+const assertHash = (hash) => {
+    if (!HEX64.test(hash)) {
+        throw new QiHandoffError("INVALID_INTEGRITY_HASH", "integrityHashSha256Hex must be 64 lowercase hex chars");
+    }
+};
+const assertRegisteredAt = (timestamp) => {
+    if (!ISO_8601.test(timestamp)) {
+        throw new QiHandoffError("INVALID_REGISTERED_AT", "registeredAt must be ISO 8601 UTC (e.g. 2026-06-05T00:00:00Z)");
+    }
+};
+const clampLabel = (label) => {
+    if (label.length <= 256)
+        return label;
+    return `${label.slice(0, 253)}...`;
+};
+/**
+ * Convert a list of `RetrievalReference` into local-knowledge-capsule envelopes. Pure.
+ *
+ * Each envelope's `localRef` is the citation chunkId (an opaque local-knowledge
+ * identifier, never a URL or a path). The envelope display label combines the
+ * capsule's `safeDisplayName` with the chunkId so the audit ledger has a
+ * non-secret descriptor.
+ */
+export const buildCapsuleSourceEnvelopes = (input) => {
+    if (input.references.length === 0) {
+        throw new QiHandoffError("EMPTY_REFERENCE", "references list must not be empty");
+    }
+    if (Object.keys(input.integrityHashByChunkId).length === 0) {
+        throw new QiHandoffError("EMPTY_HASH_TABLE", "integrityHashByChunkId must not be empty");
+    }
+    assertRegisteredAt(input.registeredAt);
+    const envelopes = [];
+    for (const reference of input.references) {
+        const chunkId = reference.chunkId;
+        const hash = input.integrityHashByChunkId[chunkId];
+        if (typeof hash !== "string") {
+            throw new QiHandoffError("MISSING_INTEGRITY_HASH", `No integrity hash supplied for chunkId "${chunkId}"`);
+        }
+        assertHash(hash);
+        const id = asQualityIntelligenceSourceEnvelopeId(`${input.idPrefix}:${chunkId}`);
+        const safeName = reference.citation.safeDisplayName;
+        const displayLabel = clampLabel(`local-knowledge:${safeName}#${chunkId}`);
+        envelopes.push({
+            id,
+            kind: "local-knowledge-capsule",
+            displayLabel,
+            provenance: {
+                origin: `local-knowledge-capsule:${reference.capsuleId}`,
+                registeredAt: input.registeredAt,
+                integrityHashSha256Hex: hash,
+            },
+            localRef: chunkId,
+        });
+    }
+    return envelopes;
+};

package/dist/retrieval/answer-grounding.d.ts

@@ -0,0 +1,9 @@
+import type { CapsuleAnswerGroundingPolicy, RetrievalReference } from "@oscharko-dev/keiko-contracts";
+export type GroundingDecisionReason = "allowed" | "require-citations-rejected" | "no-evidence-stated";
+export interface GroundingDecision {
+    readonly allow: boolean;
+    readonly reason: GroundingDecisionReason;
+    readonly noEvidence: boolean;
+}
+export declare function validateAnswerGrounding(references: readonly RetrievalReference[], policy: CapsuleAnswerGroundingPolicy): GroundingDecision;
+//# sourceMappingURL=answer-grounding.d.ts.map

package/dist/retrieval/answer-grounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-grounding.d.ts","sourceRoot":"","sources":["../../src/retrieval/answer-grounding.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,4BAA4B,EAC5B,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,4BAA4B,GAC5B,oBAAoB,CAAC;AAEzB,MAAM,WAAW,iBAAiB;IAIhC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IAKzC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,MAAM,EAAE,4BAA4B,GACnC,iBAAiB,CAYnB"}

package/dist/retrieval/answer-grounding.js

@@ -0,0 +1,31 @@
+// Answer-grounding policy decision (Epic #189, Issue #199). Pure function over the
+// retrieval result + the capsule's configured `answerGroundingPolicy`. Lives at the
+// boundary between retrieval and the future #200 Conversation Center integration: the
+// runner uses it to decide whether to release retrieved evidence to the LLM grounding
+// prompt, and the UI layer reads `noEvidence` / `reason` to phrase the user-visible
+// message.
+//
+// Three policies (matching `CapsuleAnswerGroundingPolicy` in contracts):
+//   * "require-citations" — empty refs MUST block; no answer can fire.
+//   * "require-citations-or-state-no-evidence" — empty refs are allowed *if* the caller
+//     surfaces a "no evidence" message; the decision marks `noEvidence: true` so the
+//     caller knows it has to.
+//   * "best-effort" — empty refs are allowed; the LLM may answer without citations.
+//
+// `validateAnswerGrounding` is deliberately a *function*, not a method on a capsule or a
+// store call. No IO, no allocation beyond the returned record. Tests pin every branch.
+export function validateAnswerGrounding(references, policy) {
+    const hasReferences = references.length > 0;
+    if (policy === "require-citations") {
+        if (hasReferences)
+            return { allow: true, reason: "allowed", noEvidence: false };
+        return { allow: false, reason: "require-citations-rejected", noEvidence: true };
+    }
+    if (policy === "require-citations-or-state-no-evidence") {
+        if (hasReferences)
+            return { allow: true, reason: "allowed", noEvidence: false };
+        return { allow: true, reason: "no-evidence-stated", noEvidence: true };
+    }
+    // best-effort
+    return { allow: true, reason: "allowed", noEvidence: !hasReferences };
+}

package/dist/retrieval/context-pack-assembler.d.ts

@@ -0,0 +1,24 @@
+import type { CitationReference, KnowledgeCapsuleId, KnowledgeSourceId, RetrievalReference } from "@oscharko-dev/keiko-contracts";
+export declare const LOCAL_KNOWLEDGE_GROUNDED_CONTEXT_PACK_VERSION: "1";
+export interface LocalKnowledgeGroundedContextScope {
+    readonly capsuleIds: readonly KnowledgeCapsuleId[];
+    readonly sourceIds: readonly KnowledgeSourceId[];
+    readonly capsuleCount: number;
+    readonly sourceCount: number;
+}
+export interface LocalKnowledgeGroundedContextCounts {
+    readonly totalReferences: number;
+    readonly distinctCapsules: number;
+    readonly distinctSources: number;
+}
+export interface LocalKnowledgeGroundedContextPack {
+    readonly schemaVersion: typeof LOCAL_KNOWLEDGE_GROUNDED_CONTEXT_PACK_VERSION;
+    readonly scope: LocalKnowledgeGroundedContextScope;
+    readonly citations: readonly CitationReference[];
+    readonly counts: LocalKnowledgeGroundedContextCounts;
+}
+export interface AssembleGroundedContextOptions {
+    readonly reserved?: never;
+}
+export declare function assembleGroundedContext(references: readonly RetrievalReference[], _options?: AssembleGroundedContextOptions): LocalKnowledgeGroundedContextPack;
+//# sourceMappingURL=context-pack-assembler.d.ts.map

package/dist/retrieval/context-pack-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack-assembler.d.ts","sourceRoot":"","sources":["../../src/retrieval/context-pack-assembler.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAIvC,eAAO,MAAM,6CAA6C,EAAG,GAAY,CAAC;AAE1E,MAAM,WAAW,kCAAkC;IAKjD,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,aAAa,EAAE,OAAO,6CAA6C,CAAC;IAC7E,QAAQ,CAAC,KAAK,EAAE,kCAAkC,CAAC;IAInD,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,mCAAmC,CAAC;CACtD;AAED,MAAM,WAAW,8BAA8B;IAI7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,QAAQ,GAAE,8BAAmC,GAC5C,iCAAiC,CAkBnC"}

package/dist/retrieval/context-pack-assembler.js

@@ -0,0 +1,50 @@
+// Grounded context-pack assembler (Epic #189, Issue #199). Converts a list of
+// `RetrievalReference` (the ranked output of `searchVectorsForScope`) into a
+// `LocalKnowledgeGroundedContextPack` — a deliberately metadata-only projection that the
+// future #200 Conversation Center integration hands to the LLM grounding prompt and the
+// answer surface UI.
+//
+// This pack is structurally distinct from the connected-context layer's
+// `GroundedAnswerContextPackSummary` (in `@oscharko-dev/keiko-contracts/bff-wire`): that
+// one is shaped around `ConnectedContextPack`, scope kinds (workspace-root, directory,
+// files), exploration usage / budget, and uncertainty. Local Knowledge has a different
+// runtime model — capsule-set composition, citation-per-chunk — and a different privacy
+// contract (we never carry raw text in this PR; `outputMode === "raw"` lands in #200
+// where the workspace FS port is wired and we can read the parsed_unit's character
+// span from disk). Keeping the two pack types distinct prevents accidental cross-wiring
+// when the BFF layer eventually surfaces both.
+//
+// The pack is pure data — no IO, no allocation beyond the returned record + its
+// citation array. Sorting and de-duplication are stable on `chunkId` so the pack is
+// byte-identical across runs with the same inputs (load-bearing for the audit ledger).
+// Bumped when the wire shape changes. Consumers (audit ledger, future #200 wire) pin
+// against this literal so an unrecognised pack is rejected at the boundary.
+export const LOCAL_KNOWLEDGE_GROUNDED_CONTEXT_PACK_VERSION = "1";
+export function assembleGroundedContext(references, _options = {}) {
+    const capsuleIds = collectSortedUnique(references.map((r) => r.capsuleId));
+    const sourceIds = collectSortedUnique(references.map((r) => r.citation.sourceId));
+    return {
+        schemaVersion: LOCAL_KNOWLEDGE_GROUNDED_CONTEXT_PACK_VERSION,
+        scope: {
+            capsuleIds,
+            sourceIds,
+            capsuleCount: capsuleIds.length,
+            sourceCount: sourceIds.length,
+        },
+        citations: references.map((r) => r.citation),
+        counts: {
+            totalReferences: references.length,
+            distinctCapsules: capsuleIds.length,
+            distinctSources: sourceIds.length,
+        },
+    };
+}
+function collectSortedUnique(values) {
+    const seen = new Map();
+    for (const value of values) {
+        const key = String(value);
+        if (!seen.has(key))
+            seen.set(key, value);
+    }
+    return [...seen.values()].sort((a, b) => String(a).localeCompare(String(b)));
+}

package/dist/retrieval/index.d.ts

@@ -0,0 +1,6 @@
+export { runLocalKnowledgeRetrieval, type RetrievalDependencies } from "./retrieval-runner.js";
+export { searchVectorsForScope, toScopeInput, type RetrievalScopeInput, type SearchOptions, type SearchOutcome, } from "./scoped-vector-search.js";
+export { assembleGroundedContext, LOCAL_KNOWLEDGE_GROUNDED_CONTEXT_PACK_VERSION, type AssembleGroundedContextOptions, type LocalKnowledgeGroundedContextCounts, type LocalKnowledgeGroundedContextPack, type LocalKnowledgeGroundedContextScope, } from "./context-pack-assembler.js";
+export { validateAnswerGrounding, type GroundingDecision, type GroundingDecisionReason, } from "./answer-grounding.js";
+export { DEFAULT_RETRIEVAL_TOP_K, MAX_RETRIEVAL_TOP_K, RetrievalError, type RetrievalErrorCode, type RetrievalNoEvidenceReason, type RetrievalQuery, type RetrievalResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/retrieval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieval/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,0BAA0B,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE/F,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,uBAAuB,EACvB,6CAA6C,EAC7C,KAAK,8BAA8B,EACnC,KAAK,mCAAmC,EACxC,KAAK,iCAAiC,EACtC,KAAK,kCAAkC,GACxC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC"}

package/dist/retrieval/index.js

@@ -0,0 +1,9 @@
+// Public surface of the retrieval layer (Epic #189, Issue #199). Composed by the
+// package barrel in ../index.ts; consumers outside this package never import from this
+// subdirectory directly (ADR-0019 direction rule 3e + the trust-8 test-support naming
+// convention).
+export { runLocalKnowledgeRetrieval } from "./retrieval-runner.js";
+export { searchVectorsForScope, toScopeInput, } from "./scoped-vector-search.js";
+export { assembleGroundedContext, LOCAL_KNOWLEDGE_GROUNDED_CONTEXT_PACK_VERSION, } from "./context-pack-assembler.js";
+export { validateAnswerGrounding, } from "./answer-grounding.js";
+export { DEFAULT_RETRIEVAL_TOP_K, MAX_RETRIEVAL_TOP_K, RetrievalError, } from "./types.js";

package/dist/retrieval/retrieval-runner.d.ts

@@ -0,0 +1,10 @@
+import type { OpenAIEmbeddingAdapter } from "@oscharko-dev/keiko-model-gateway";
+import type { KnowledgeStore } from "../store.js";
+import { type RetrievalQuery, type RetrievalResult } from "./types.js";
+export interface RetrievalDependencies {
+    readonly store: KnowledgeStore;
+    readonly embeddingAdapter: OpenAIEmbeddingAdapter;
+    readonly signal?: AbortSignal;
+}
+export declare function runLocalKnowledgeRetrieval(deps: RetrievalDependencies, query: RetrievalQuery): Promise<RetrievalResult>;
+//# sourceMappingURL=retrieval-runner.d.ts.map