@balpal4495/quorum 3.0.3 → 3.1.0

package/dist/oracle/bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../modules/oracle/bm25.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAsCtE;AAWD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAY/D"}

package/dist/oracle/bm25.js

@@ -0,0 +1,82 @@
+/**
+ * Lightweight BM25 implementation for Pass 2 re-ranking.
+ *
+ * k1 = 1.5  (term frequency saturation)
+ * b  = 0.75 (length normalization)
+ *
+ * Formula: score(q, d) = Σ IDF(qi) * f(qi, d) * (k1 + 1) / (f(qi, d) + k1 * (1 − b + b * |d| / avgdl))
+ */
+const K1 = 1.5;
+const B = 0.75;
+function tokenize(text) {
+    return text.toLowerCase().match(/\b\w+\b/g) ?? [];
+}
+/** Robertson–Sparck Jones IDF with smoothing. */
+function computeIdf(N, df) {
+    return Math.log(1 + (N - df + 0.5) / (df + 0.5));
+}
+/**
+ * Score each document string against the query using BM25.
+ * Returns a score array parallel to `documents`.
+ */
+export function bm25Score(query, documents) {
+    if (documents.length === 0)
+        return [];
+    const queryTokens = tokenize(query);
+    const docTokenLists = documents.map(tokenize);
+    const totalLength = docTokenLists.reduce((sum, d) => sum + d.length, 0);
+    const avgdl = totalLength / docTokenLists.length;
+    const N = documents.length;
+    // Precompute document frequency for each unique query token
+    const df = new Map();
+    for (const token of queryTokens) {
+        if (!df.has(token)) {
+            df.set(token, docTokenLists.filter(doc => doc.includes(token)).length);
+        }
+    }
+    return docTokenLists.map(docTokenList => {
+        const docLength = docTokenList.length;
+        const tf = new Map();
+        for (const token of docTokenList) {
+            tf.set(token, (tf.get(token) ?? 0) + 1);
+        }
+        let score = 0;
+        for (const token of queryTokens) {
+            const termFreq = tf.get(token) ?? 0;
+            if (termFreq === 0)
+                continue;
+            const idfScore = computeIdf(N, df.get(token) ?? 0);
+            const normTf = (termFreq * (K1 + 1)) /
+                (termFreq + K1 * (1 - B + B * (docLength / avgdl)));
+            score += idfScore * normTf;
+        }
+        return score;
+    });
+}
+const BM25_STOP_WORDS = new Set([
+    "a", "an", "the", "is", "are", "was", "were", "be", "been", "being",
+    "have", "has", "had", "do", "does", "did", "will", "would", "should",
+    "could", "may", "might", "shall", "can", "to", "of", "in", "for", "on",
+    "with", "at", "by", "from", "as", "into", "through", "and", "or", "but",
+    "if", "then", "this", "that", "these", "those", "it", "its", "we", "they",
+    "their", "there", "when", "where", "what", "which", "who", "how", "not", "no",
+]);
+/**
+ * Extract domain terms from Chronicle key insights for Pass 2 query enrichment.
+ * Bridges the vocabulary gap between natural language queries and technical identifiers.
+ * Strips stop words, returns the most frequent distinctive tokens.
+ */
+export function extractDomainTerms(insights) {
+    const allTokens = insights.flatMap(s => tokenize(s));
+    const freq = new Map();
+    for (const token of allTokens) {
+        if (!BM25_STOP_WORDS.has(token) && token.length > 2) {
+            freq.set(token, (freq.get(token) ?? 0) + 1);
+        }
+    }
+    return [...freq.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([token]) => token);
+}
+//# sourceMappingURL=bm25.js.map

package/dist/oracle/bm25.js.map

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

package/dist/oracle/index.d.ts

@@ -0,0 +1,21 @@
+export { query } from "./query.js";
+export { propose, commit } from "./propose.js";
+export type { OracleDeps, VectorStore } from "./types.js";
+export type { OracleResult, QueryOptions, ChronicleEntry, OracleClient, } from "../shared/types.js";
+export { createLanceDBStore } from "./adapters/lance-db.js";
+export { xenovaEmbed, warmEmbedder } from "./adapters/xenova-embedder.js";
+import type { OracleClient } from "../shared/types.js";
+import type { OracleDeps } from "./types.js";
+/**
+ * Create a bound OracleClient from injected deps.
+ * Pass this to Jury and Council — they only need the OracleClient interface,
+ * not the raw Oracle functions.
+ *
+ * @example
+ * const oracle = createOracleClient({
+ *   embedder: xenovaEmbed,
+ *   vectorStore: await createLanceDBStore(".chronicle"),
+ * })
+ */
+export declare function createOracleClient(deps: OracleDeps): OracleClient;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../modules/oracle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC9C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACzD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAI5C;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAMjE"}

package/dist/oracle/index.js

@@ -0,0 +1,25 @@
+export { query } from "./query.js";
+export { propose, commit } from "./propose.js";
+export { createLanceDBStore } from "./adapters/lance-db.js";
+export { xenovaEmbed, warmEmbedder } from "./adapters/xenova-embedder.js";
+import { query } from "./query.js";
+import { propose, commit } from "./propose.js";
+/**
+ * Create a bound OracleClient from injected deps.
+ * Pass this to Jury and Council — they only need the OracleClient interface,
+ * not the raw Oracle functions.
+ *
+ * @example
+ * const oracle = createOracleClient({
+ *   embedder: xenovaEmbed,
+ *   vectorStore: await createLanceDBStore(".chronicle"),
+ * })
+ */
+export function createOracleClient(deps) {
+    return {
+        query: (text, options) => query(text, options ?? {}, deps),
+        propose: entry => propose(entry, deps),
+        commit: proposalId => commit(proposalId, deps),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/oracle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../modules/oracle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAS9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAIzE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE9C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,OAAO;QACL,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,EAAE,IAAI,CAAC;QAC1D,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QACtC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC;KAC/C,CAAA;AACH,CAAC"}

package/dist/oracle/log.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Append a query log entry to .chronicle/query-log.jsonl.
+ * Best-effort — callers should swallow errors from this.
+ */
+export declare function appendQueryLog(entry: Record<string, unknown>, chronicleDir: string): Promise<void>;
+//# sourceMappingURL=log.d.ts.map

package/dist/oracle/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../modules/oracle/log.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/oracle/log.js

@@ -0,0 +1,12 @@
+import { promises as fs } from "fs";
+import path from "path";
+/**
+ * Append a query log entry to .chronicle/query-log.jsonl.
+ * Best-effort — callers should swallow errors from this.
+ */
+export async function appendQueryLog(entry, chronicleDir) {
+    await fs.mkdir(chronicleDir, { recursive: true });
+    const logPath = path.join(chronicleDir, "query-log.jsonl");
+    await fs.appendFile(logPath, JSON.stringify(entry) + "\n", "utf8");
+}
+//# sourceMappingURL=log.js.map

package/dist/oracle/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../modules/oracle/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAA;AACnC,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAA8B,EAC9B,YAAoB;IAEpB,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAA;IAC1D,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAA;AACpE,CAAC"}

package/dist/oracle/propose.d.ts

@@ -0,0 +1,25 @@
+import type { ChronicleEntry, SimilarityWarning } from "../shared/types.js";
+import type { OracleDeps } from "./types.js";
+/**
+ * Propose a new Chronicle entry for human review.
+ * Validates entry quality and checks for similar existing entries before writing.
+ * Writes the entry to .chronicle/proposals/<id>.json — NOT yet indexed.
+ * The proposal sits pending until a human calls commit() to approve it.
+ *
+ * Throws if key_insight is too short/long or affected_areas is empty.
+ * Returns a SimilarityWarning if a near-identical entry already exists —
+ * the human gate should surface this before approving the commit.
+ */
+export declare function propose(entry: Omit<ChronicleEntry, "id" | "timestamp">, deps: OracleDeps): Promise<{
+    proposalId: string;
+    similarity?: SimilarityWarning;
+}>;
+/**
+ * Commit a pending proposal after human approval.
+ * Reads the proposal file, assigns an ID and timestamp, embeds the entry,
+ * upserts it into the vector store, and deletes the proposal file.
+ *
+ * Throws if the proposal does not exist.
+ */
+export declare function commit(proposalId: string, deps: OracleDeps): Promise<ChronicleEntry>;
+//# sourceMappingURL=propose.d.ts.map

package/dist/oracle/propose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../modules/oracle/propose.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAqE5C;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,WAAW,CAAC,EAC/C,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAcjE;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,cAAc,CAAC,CAgDzB"}

package/dist/oracle/propose.js

@@ -0,0 +1,133 @@
+import { promises as fs } from "fs";
+import path from "path";
+import { randomUUID } from "crypto";
+import { exec } from "child_process";
+import { promisify } from "util";
+import { entryText } from "../shared/types.js";
+import { updateSummary } from "./summary.js";
+const execAsync = promisify(exec);
+const INSIGHT_MIN_LENGTH = 20;
+const INSIGHT_MAX_LENGTH = 200;
+const SIMILARITY_WARNING_THRESHOLD = 0.85;
+function validateEntry(entry) {
+    const insight = entry.key_insight?.trim() ?? "";
+    if (insight.length < INSIGHT_MIN_LENGTH) {
+        throw new Error(`key_insight too short (${insight.length} chars, min ${INSIGHT_MIN_LENGTH}). ` +
+            `Write a specific, complete sentence naming the module or area affected.`);
+    }
+    if (insight.length > INSIGHT_MAX_LENGTH) {
+        throw new Error(`key_insight too long (${insight.length} chars, max ${INSIGHT_MAX_LENGTH}). ` +
+            `Distil to a single clear sentence.`);
+    }
+    if (entry.decision !== undefined) {
+        const d = entry.decision.trim();
+        if (d.length < INSIGHT_MIN_LENGTH) {
+            throw new Error(`decision too short (${d.length} chars, min ${INSIGHT_MIN_LENGTH}). ` +
+                `Write a specific, complete sentence describing the decision.`);
+        }
+        if (d.length > INSIGHT_MAX_LENGTH) {
+            throw new Error(`decision too long (${d.length} chars, max ${INSIGHT_MAX_LENGTH}). ` +
+                `Distil to a single clear sentence.`);
+        }
+    }
+    if (!entry.affected_areas || entry.affected_areas.filter(a => a.trim()).length === 0) {
+        throw new Error(`affected_areas must contain at least one non-empty entry.`);
+    }
+    if (entry.confidence < 0 || entry.confidence > 1) {
+        throw new Error(`confidence must be between 0 and 1, got ${entry.confidence}.`);
+    }
+}
+async function checkSimilarity(entry, deps) {
+    try {
+        const text = [entryText(entry), ...entry.affected_areas, ...(entry.scope ?? [])].join(" ");
+        const vector = await deps.embedder(text);
+        const results = await deps.vectorStore.search(vector, 3);
+        if (results.length === 0)
+            return undefined;
+        const top = results[0];
+        if (top.score < SIMILARITY_WARNING_THRESHOLD)
+            return undefined;
+        return {
+            entry: top.entry,
+            score: top.score,
+            // If the existing entry is validated, a near-duplicate is likely a correction
+            warning: top.entry.status === "validated" ? "potential-supersession" : "potential-duplicate",
+        };
+    }
+    catch {
+        // Similarity check is best-effort — never block a proposal because of it
+        return undefined;
+    }
+}
+/**
+ * Propose a new Chronicle entry for human review.
+ * Validates entry quality and checks for similar existing entries before writing.
+ * Writes the entry to .chronicle/proposals/<id>.json — NOT yet indexed.
+ * The proposal sits pending until a human calls commit() to approve it.
+ *
+ * Throws if key_insight is too short/long or affected_areas is empty.
+ * Returns a SimilarityWarning if a near-identical entry already exists —
+ * the human gate should surface this before approving the commit.
+ */
+export async function propose(entry, deps) {
+    validateEntry(entry);
+    const similarity = await checkSimilarity(entry, deps);
+    const chronicleDir = deps.chronicleDir ?? ".chronicle";
+    const proposalsDir = path.join(chronicleDir, "proposals");
+    await fs.mkdir(proposalsDir, { recursive: true });
+    const proposalId = randomUUID();
+    const proposalPath = path.join(proposalsDir, `${proposalId}.json`);
+    await fs.writeFile(proposalPath, JSON.stringify(entry, null, 2), "utf8");
+    return { proposalId, ...(similarity ? { similarity } : {}) };
+}
+/**
+ * Commit a pending proposal after human approval.
+ * Reads the proposal file, assigns an ID and timestamp, embeds the entry,
+ * upserts it into the vector store, and deletes the proposal file.
+ *
+ * Throws if the proposal does not exist.
+ */
+export async function commit(proposalId, deps) {
+    const chronicleDir = deps.chronicleDir ?? ".chronicle";
+    const proposalPath = path.join(chronicleDir, "proposals", `${proposalId}.json`);
+    let raw;
+    try {
+        raw = await fs.readFile(proposalPath, "utf8");
+    }
+    catch {
+        throw new Error(`Proposal not found: ${proposalId}`);
+    }
+    const partial = JSON.parse(raw);
+    const entry = {
+        ...partial,
+        id: randomUUID(),
+        timestamp: new Date().toISOString(),
+    };
+    // Embed the primary text + areas + scope tags for richer retrieval
+    const embeddingText = [entryText(entry), ...entry.affected_areas, ...(entry.scope ?? [])].join(" ");
+    const vector = await deps.embedder(embeddingText);
+    await deps.vectorStore.upsert(entry.id, vector, entry);
+    // Write to committed/ — the git-tracked source of truth shared across the team
+    const committedDir = path.join(chronicleDir, "committed");
+    await fs.mkdir(committedDir, { recursive: true });
+    const committedPath = path.join(committedDir, `${entry.id}.json`);
+    await fs.writeFile(committedPath, JSON.stringify(entry, null, 2), "utf8");
+    // Stage the committed entry for the next git commit — best-effort
+    try {
+        await execAsync(`git add "${committedPath}"`);
+    }
+    catch {
+        // Not in a git repo, or git is unavailable — silently continue
+    }
+    // Rebuild SUMMARY.md — best-effort, never fail a commit
+    try {
+        await updateSummary(chronicleDir);
+    }
+    catch {
+        // Summary generation failure must not fail a commit
+    }
+    // Remove the proposal — it has been committed
+    await fs.unlink(proposalPath);
+    return entry;
+}
+//# sourceMappingURL=propose.js.map

package/dist/oracle/propose.js.map

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

package/dist/oracle/query.d.ts

@@ -0,0 +1,17 @@
+import type { OracleResult, QueryOptions } from "../shared/types.js";
+import type { OracleDeps } from "./types.js";
+/**
+ * Two-pass retrieval with Reciprocal Rank Fusion.
+ *
+ * Pass 1 — vector similarity:
+ *   Embed the query, retrieve top (limit × CANDIDATE_MULTIPLIER) candidates.
+ *
+ * Pass 2 — BM25 re-ranking with query enrichment:
+ *   Extract domain terms from Pass 1 key insights, enrich the query,
+ *   score candidates with BM25, fuse ranks via RRF.
+ *
+ * Results below scoreThreshold are dropped entirely.
+ * All queries are appended to .chronicle/query-log.jsonl.
+ */
+export declare function query(text: string, options: QueryOptions | undefined, deps: OracleDeps): Promise<OracleResult[]>;
+//# sourceMappingURL=query.d.ts.map

package/dist/oracle/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../modules/oracle/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAmB5C;;;;;;;;;;;;GAYG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,YAAK,EAC1B,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CAgEzB"}

package/dist/oracle/query.js

@@ -0,0 +1,106 @@
+import { entryText } from "../shared/types.js";
+import { bm25Score, extractDomainTerms } from "./bm25.js";
+import { appendQueryLog } from "./log.js";
+const DEFAULT_LIMIT = 10;
+const DEFAULT_SCORE_THRESHOLD = 0.031;
+const RRF_K = 60;
+/** Retrieve this many vector candidates before BM25 re-ranking. */
+const CANDIDATE_MULTIPLIER = 3;
+/**
+ * Reciprocal Rank Fusion score.
+ * score = Σ 1 / (k + rank_i) summed across all rank lists.
+ * k = 60 (standard constant).
+ */
+function rrfScore(ranks) {
+    return ranks.reduce((sum, rank) => sum + 1 / (RRF_K + rank), 0);
+}
+/**
+ * Two-pass retrieval with Reciprocal Rank Fusion.
+ *
+ * Pass 1 — vector similarity:
+ *   Embed the query, retrieve top (limit × CANDIDATE_MULTIPLIER) candidates.
+ *
+ * Pass 2 — BM25 re-ranking with query enrichment:
+ *   Extract domain terms from Pass 1 key insights, enrich the query,
+ *   score candidates with BM25, fuse ranks via RRF.
+ *
+ * Results below scoreThreshold are dropped entirely.
+ * All queries are appended to .chronicle/query-log.jsonl.
+ */
+export async function query(text, options = {}, deps) {
+    const { statusFilter, limit = DEFAULT_LIMIT, scoreThreshold = DEFAULT_SCORE_THRESHOLD, } = options;
+    const startTime = Date.now();
+    // ── Pass 1: vector similarity ──────────────────────────────────────────────
+    const queryVector = await deps.embedder(text);
+    const candidateLimit = limit * CANDIDATE_MULTIPLIER;
+    let candidates = await deps.vectorStore.search(queryVector, candidateLimit);
+    // Status filter applied before BM25 to avoid scoring irrelevant entries
+    if (statusFilter && statusFilter.length > 0) {
+        candidates = candidates.filter(c => statusFilter.includes(c.entry.status));
+    }
+    if (candidates.length === 0) {
+        await tryLogQuery(text, [], startTime, deps);
+        return [];
+    }
+    // ── Pass 2: BM25 re-ranking with query enrichment ─────────────────────────
+    const topInsights = candidates
+        .slice(0, Math.min(5, candidates.length))
+        .map(c => entryText(c.entry));
+    const domainTerms = extractDomainTerms(topInsights);
+    const enrichedQuery = domainTerms.length > 0 ? `${text} ${domainTerms.join(" ")}` : text;
+    const documents = candidates.map(c => [entryText(c.entry), ...c.entry.affected_areas, ...(c.entry.scope ?? [])].join(" "));
+    const bm25Scores = bm25Score(enrichedQuery, documents);
+    // Build BM25 rank lookup (index → rank)
+    const bm25RankOf = new Array(candidates.length);
+    bm25Scores
+        .map((score, i) => ({ i, score }))
+        .sort((a, b) => b.score - a.score)
+        .forEach(({ i }, rank) => {
+        bm25RankOf[i] = rank;
+    });
+    // ── RRF fusion ─────────────────────────────────────────────────────────────
+    const fused = candidates.map((candidate, vectorRank) => ({
+        ...candidate.entry,
+        score: rrfScore([vectorRank, bm25RankOf[vectorRank]]),
+    }));
+    fused.sort((a, b) => b.score - a.score);
+    const filtered = fused
+        .filter(r => r.score >= scoreThreshold)
+        .slice(0, limit);
+    const results = assignTiers(filtered);
+    await tryLogQuery(text, results, startTime, deps);
+    return results;
+}
+/**
+ * Assign relevance tiers within the result set using relative rank.
+ * Top ~30% → primary, next ~40% → supporting, remainder → background.
+ * Thresholds are relative so they self-calibrate as Chronicle grows.
+ */
+function assignTiers(results) {
+    const n = results.length;
+    if (n === 0)
+        return [];
+    const primaryCount = Math.max(1, Math.ceil(n * 0.3));
+    const supportingCount = Math.max(1, Math.ceil(n * 0.4));
+    return results.map((r, i) => ({
+        ...r,
+        tier: i < primaryCount ? "primary"
+            : i < primaryCount + supportingCount ? "supporting"
+                : "background",
+    }));
+}
+async function tryLogQuery(text, results, startTime, deps) {
+    try {
+        await appendQueryLog({
+            query: text,
+            results: results.map(r => ({ id: r.id, score: r.score, status: r.status })),
+            resultCount: results.length,
+            durationMs: Date.now() - startTime,
+            timestamp: new Date().toISOString(),
+        }, deps.chronicleDir ?? ".chronicle");
+    }
+    catch {
+        // Query logging is best-effort — never fail a query because of a log write failure
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/oracle/query.js.map

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

package/dist/oracle/summary.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rebuild .chronicle/SUMMARY.md from all committed entries.
+ *
+ * Groups entries by ISO week (most-recent first), then by work_ref within
+ * each week. Shows the last SUMMARY_WEEKS weeks; older entries are omitted
+ * (still fully queryable via Oracle).
+ *
+ * Called by commit() as a best-effort side-effect — never throws.
+ */
+export declare function updateSummary(chronicleDir: string): Promise<void>;
+//# sourceMappingURL=summary.d.ts.map

package/dist/oracle/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../modules/oracle/summary.ts"],"names":[],"mappings":"AAmCA;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEvE"}

package/dist/oracle/summary.js

@@ -0,0 +1,102 @@
+import { promises as fs } from "fs";
+import path from "path";
+import { entryText } from "../shared/types.js";
+const SUMMARY_WEEKS = 12;
+const DIRECTIVE = "<!-- Chronicle Summary v1 — temporal orientation for agents. " +
+    "Use for sequence context; query Oracle by entry ID for full reasoning. -->";
+/**
+ * Returns the ISO week string (YYYY-Www) for a given date.
+ * Uses the ISO 8601 definition: week 1 is the week containing the first Thursday.
+ */
+function isoWeekKey(date) {
+    const d = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+    const day = d.getUTCDay() || 7;
+    d.setUTCDate(d.getUTCDate() + 4 - day);
+    const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+    const week = Math.ceil(((d.getTime() - yearStart.getTime()) / 86_400_000 + 1) / 7);
+    return `${d.getUTCFullYear()}-W${String(week).padStart(2, "0")}`;
+}
+function workRefLabel(entry) {
+    if (!entry.work_ref)
+        return "__none__";
+    const { type, ref } = entry.work_ref;
+    return ref ? `[${type} ${ref}]` : `[${type}]`;
+}
+function renderEntry(entry) {
+    const areas = entry.affected_areas.join(", ");
+    const id = entry.id.slice(0, 8);
+    return `- **[${id}]** ${areas} — \`${entry.status}\` (${entry.confidence.toFixed(2)}) — ${entryText(entry)}`;
+}
+/**
+ * Rebuild .chronicle/SUMMARY.md from all committed entries.
+ *
+ * Groups entries by ISO week (most-recent first), then by work_ref within
+ * each week. Shows the last SUMMARY_WEEKS weeks; older entries are omitted
+ * (still fully queryable via Oracle).
+ *
+ * Called by commit() as a best-effort side-effect — never throws.
+ */
+export async function updateSummary(chronicleDir) {
+    const committedDir = path.join(chronicleDir, "committed");
+    let files;
+    try {
+        files = await fs.readdir(committedDir);
+    }
+    catch {
+        return;
+    }
+    const entries = [];
+    for (const file of files) {
+        if (!file.endsWith(".json"))
+            continue;
+        try {
+            const raw = await fs.readFile(path.join(committedDir, file), "utf8");
+            entries.push(JSON.parse(raw));
+        }
+        catch {
+            // Skip malformed entries
+        }
+    }
+    if (entries.length === 0)
+        return;
+    entries.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    // Group by ISO week
+    const byWeek = new Map();
+    for (const entry of entries) {
+        const week = isoWeekKey(new Date(entry.timestamp));
+        const bucket = byWeek.get(week) ?? [];
+        bucket.push(entry);
+        byWeek.set(week, bucket);
+    }
+    const weeks = [...byWeek.keys()].sort().reverse().slice(0, SUMMARY_WEEKS);
+    const lines = [DIRECTIVE, ""];
+    for (const week of weeks) {
+        lines.push(`## Week ${week}`, "");
+        // Group entries within week by work_ref label
+        const weekEntries = byWeek.get(week);
+        const byWork = new Map();
+        for (const entry of weekEntries) {
+            const key = workRefLabel(entry);
+            const bucket = byWork.get(key) ?? [];
+            bucket.push(entry);
+            byWork.set(key, bucket);
+        }
+        // Labelled work groups first, then ungrouped
+        const workKeys = [...byWork.keys()].sort((a, b) => a === "__none__" ? 1 : b === "__none__" ? -1 : a.localeCompare(b));
+        for (const key of workKeys) {
+            if (key === "__none__") {
+                lines.push(`### (no work context — query Oracle by entry ID for details)`);
+            }
+            else {
+                lines.push(`### ${key}`);
+            }
+            for (const entry of byWork.get(key)) {
+                lines.push(renderEntry(entry));
+            }
+            lines.push("");
+        }
+    }
+    const summaryPath = path.join(chronicleDir, "SUMMARY.md");
+    await fs.writeFile(summaryPath, lines.join("\n"), "utf8");
+}
+//# sourceMappingURL=summary.js.map

package/dist/oracle/summary.js.map

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