@indigoai-us/cq 0.0.1

package/dist/budget/token-tracker.js

@@ -0,0 +1,152 @@
+/**
+ * Token Tracker — runtime context window budget management.
+ *
+ * Tracks token usage for knowledge entries loaded into an LLM context window.
+ * Supports multiple selection strategies for fitting entries within a budget.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Estimate token count from content length (~4 chars per token). */
+export function estimateTokens(content) {
+    return Math.ceil(content.length / 4);
+}
+// ---------------------------------------------------------------------------
+// TokenTracker
+// ---------------------------------------------------------------------------
+/**
+ * Manages a token budget for loading knowledge entries into a context window.
+ *
+ * Not backed by SQLite — this is a purely in-memory runtime tracker.
+ */
+export class TokenTracker {
+    maxTokens;
+    used = 0;
+    reserved = new Map();
+    constructor(maxTokens) {
+        if (maxTokens <= 0) {
+            throw new Error("maxTokens must be a positive number");
+        }
+        this.maxTokens = maxTokens;
+    }
+    /** Key for deduplication in the reserved map. */
+    entryKey(entry) {
+        return `${entry.category}/${entry.slug}`;
+    }
+    /** Current available tokens. */
+    get remaining() {
+        return this.maxTokens - this.used;
+    }
+    /** Check whether an entry's content fits in the remaining budget. */
+    wouldFit(entry) {
+        const tokens = estimateTokens(entry.content);
+        return tokens <= this.remaining;
+    }
+    /**
+     * Reserve tokens for an entry, deducting from the remaining budget.
+     * Throws if the entry would exceed the budget.
+     * No-op if the entry is already reserved.
+     */
+    reserve(entry) {
+        const key = this.entryKey(entry);
+        if (this.reserved.has(key))
+            return;
+        const tokens = estimateTokens(entry.content);
+        if (tokens > this.remaining) {
+            throw new Error(`Cannot reserve ${tokens} tokens for "${key}" — only ${this.remaining} remaining`);
+        }
+        this.reserved.set(key, tokens);
+        this.used += tokens;
+    }
+    /**
+     * Release tokens previously reserved for an entry, returning them to the budget.
+     * No-op if the entry is not currently reserved.
+     */
+    release(entry) {
+        const key = this.entryKey(entry);
+        const tokens = this.reserved.get(key);
+        if (tokens === undefined)
+            return;
+        this.reserved.delete(key);
+        this.used -= tokens;
+    }
+    /**
+     * Select entries that fit within the remaining budget using the given strategy.
+     *
+     * @param entries - Scored entries to consider.
+     * @param strategy - Selection strategy.
+     * @returns Entries selected to fit within budget, ordered by strategy priority.
+     */
+    selectEntries(entries, strategy) {
+        const sorted = this.sortByStrategy([...entries], strategy);
+        const selected = [];
+        let budget = this.remaining;
+        for (const { entry } of sorted) {
+            const tokens = estimateTokens(entry.content);
+            if (tokens <= budget) {
+                selected.push(entry);
+                budget -= tokens;
+            }
+        }
+        return selected;
+    }
+    // -------------------------------------------------------------------------
+    // Strategy sorting
+    // -------------------------------------------------------------------------
+    sortByStrategy(entries, strategy) {
+        switch (strategy) {
+            case "highest_confidence":
+                return entries.sort((a, b) => (b.confidence ?? 0) - (a.confidence ?? 0));
+            case "most_relevant":
+                return entries.sort((a, b) => (b.relevance ?? 0) - (a.relevance ?? 0));
+            case "balanced":
+                return this.balancedSort(entries);
+        }
+    }
+    /**
+     * Balanced strategy: interleave entries from different categories,
+     * sorted within each category by a combined confidence + relevance score.
+     */
+    balancedSort(entries) {
+        // Score each entry by averaging confidence and relevance (whichever are available).
+        const scored = entries.map((e) => {
+            const c = e.confidence ?? 0;
+            const r = e.relevance ?? 0;
+            const hasC = e.confidence !== undefined;
+            const hasR = e.relevance !== undefined;
+            const score = hasC && hasR ? (c + r) / 2 : hasC ? c : hasR ? r : 0;
+            return { scored: e, score, category: e.entry.category };
+        });
+        // Group by category.
+        const byCategory = new Map();
+        for (const item of scored) {
+            const list = byCategory.get(item.category) ?? [];
+            list.push(item);
+            byCategory.set(item.category, list);
+        }
+        // Sort each category's entries by score descending.
+        for (const list of byCategory.values()) {
+            list.sort((a, b) => b.score - a.score);
+        }
+        // Round-robin across categories.
+        const result = [];
+        const categoryQueues = [...byCategory.values()];
+        // Sort category groups by best score so highest-scoring categories go first.
+        categoryQueues.sort((a, b) => (b[0]?.score ?? 0) - (a[0]?.score ?? 0));
+        let exhausted = 0;
+        const indices = categoryQueues.map(() => 0);
+        while (exhausted < categoryQueues.length) {
+            for (let i = 0; i < categoryQueues.length; i++) {
+                const queue = categoryQueues[i];
+                if (indices[i] < queue.length) {
+                    result.push(queue[indices[i]].scored);
+                    indices[i]++;
+                    if (indices[i] >= queue.length)
+                        exhausted++;
+                }
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=token-tracker.js.map

package/dist/budget/token-tracker.js.map

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

package/dist/budget/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Budget tracker type definitions.
+ */
+/** Configurable cost defaults and spending limits. */
+export interface BudgetConfig {
+    /** Maximum spend per calendar day (UTC), in USD. */
+    dailyLimitUsd: number;
+    /** Optional lifetime spending cap, in USD. */
+    totalLimitUsd?: number;
+    /** Estimated cost per web search, in USD. Default 0.03. */
+    searchCostUsd: number;
+    /** Estimated cost per synthesis call, in USD. Default 0.01. */
+    synthesisCostUsd: number;
+    /** Estimated cost per vetting call, in USD. Default 0.005. */
+    vetCostUsd: number;
+}
+/** Charge type recorded in the research_budget table. */
+export type ChargeType = "search" | "synthesis" | "vetting" | "other";
+/** Result of a budget check — indicates whether a charge is allowed. */
+export interface BudgetCheckResult {
+    /** Whether the estimated charge fits within remaining limits. */
+    allowed: boolean;
+    /** Remaining budget for the current day (UTC). */
+    remainingUsd: number;
+    /** Amount spent today (UTC). */
+    dailyUsedUsd: number;
+    /** Lifetime total spent. */
+    totalUsedUsd: number;
+    /** Human-readable reason when not allowed. */
+    reason?: string;
+}
+/** Daily or total budget usage summary. */
+export interface BudgetStatus {
+    /** Amount spent in the scope (daily or total). */
+    usedUsd: number;
+    /** Configured limit for the scope (may be undefined for total if uncapped). */
+    limitUsd?: number;
+    /** Remaining budget (limitUsd - usedUsd), or undefined if uncapped. */
+    remainingUsd?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/budget/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtE,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/budget/types.js

@@ -0,0 +1,5 @@
+/**
+ * Budget tracker type definitions.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/budget/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/budget/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/confidence/__tests__/confidence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=confidence.test.d.ts.map

package/dist/confidence/__tests__/confidence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.test.d.ts","sourceRoot":"","sources":["../../../src/confidence/__tests__/confidence.test.ts"],"names":[],"mappings":""}

package/dist/confidence/__tests__/confidence.test.js

@@ -0,0 +1,336 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { initMetadataDb, closeDb, getDb, indexEntry } from "../../metadata/index.js";
+import { setConfidenceConfig, getConfidenceConfig, getConfidence, recordVerification, recordContradiction, getRefreshCandidates, computeConfidence, daysElapsed, applyContradiction, } from "../index.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeEntry(overrides = {}) {
+    return {
+        category: "trends",
+        slug: "ai-agents",
+        title: "AI Agent Landscape",
+        tags: ["ai"],
+        created: "2025-01-01T00:00:00.000Z",
+        updated: "2025-06-01T00:00:00.000Z",
+        content: "AI agents are rapidly evolving.",
+        ...overrides,
+    };
+}
+/** Return an ISO string offset by the given number of days from a base. */
+function addDays(base, days) {
+    const d = new Date(base);
+    d.setTime(d.getTime() + days * 24 * 60 * 60 * 1000);
+    return d.toISOString();
+}
+const BASE_TIME = "2025-06-01T00:00:00.000Z";
+beforeEach(() => {
+    initMetadataDb(":memory:");
+});
+afterEach(() => {
+    closeDb();
+});
+// ---------------------------------------------------------------------------
+// Pure erosion functions
+// ---------------------------------------------------------------------------
+describe("daysElapsed", () => {
+    it("returns 0 for same timestamp", () => {
+        expect(daysElapsed(BASE_TIME, BASE_TIME)).toBe(0);
+    });
+    it("computes fractional days", () => {
+        const twelveHoursLater = addDays(BASE_TIME, 0.5);
+        expect(daysElapsed(BASE_TIME, twelveHoursLater)).toBeCloseTo(0.5, 5);
+    });
+    it("returns 0 when end is before start", () => {
+        const earlier = addDays(BASE_TIME, -1);
+        expect(daysElapsed(BASE_TIME, earlier)).toBe(0);
+    });
+});
+describe("computeConfidence", () => {
+    it("returns stored confidence when no time has elapsed", () => {
+        expect(computeConfidence(0.8, BASE_TIME, 0.05, 0.1, BASE_TIME)).toBe(0.8);
+    });
+    it("decays linearly over time", () => {
+        const tenDaysLater = addDays(BASE_TIME, 10);
+        // 0.8 - (10 * 0.05) = 0.3
+        expect(computeConfidence(0.8, BASE_TIME, 0.05, 0.1, tenDaysLater)).toBeCloseTo(0.3, 10);
+    });
+    it("enforces minimum confidence floor", () => {
+        const thirtyDaysLater = addDays(BASE_TIME, 30);
+        // 0.8 - (30 * 0.05) = -0.7 → clamped to 0.1
+        expect(computeConfidence(0.8, BASE_TIME, 0.05, 0.1, thirtyDaysLater)).toBe(0.1);
+    });
+    it("handles zero erosion rate", () => {
+        const yearLater = addDays(BASE_TIME, 365);
+        expect(computeConfidence(0.8, BASE_TIME, 0, 0.1, yearLater)).toBe(0.8);
+    });
+});
+describe("applyContradiction", () => {
+    it("drops confidence by severity", () => {
+        expect(applyContradiction(0.8, 0.3, 0.1)).toBeCloseTo(0.5, 10);
+    });
+    it("enforces minimum confidence floor", () => {
+        expect(applyContradiction(0.3, 0.5, 0.1)).toBe(0.1);
+    });
+});
+// ---------------------------------------------------------------------------
+// Config storage
+// ---------------------------------------------------------------------------
+describe("setConfidenceConfig / getConfidenceConfig", () => {
+    it("returns defaults when no config has been set", () => {
+        const config = getConfidenceConfig();
+        expect(config.min_confidence).toBe(0.1);
+        expect(config.refresh_threshold).toBe(0.4);
+        expect(config.initial_confidence).toBe(0.8);
+        expect(config.default_rate).toBe(0.02);
+        expect(config.erosion_rates).toEqual({});
+    });
+    it("stores and retrieves a custom config", () => {
+        const custom = {
+            erosion_rates: { trends: 0.05, brand: 0.005 },
+            default_rate: 0.01,
+            min_confidence: 0.05,
+            refresh_threshold: 0.3,
+            initial_confidence: 0.9,
+        };
+        setConfidenceConfig(custom);
+        const config = getConfidenceConfig();
+        expect(config.erosion_rates).toEqual({ trends: 0.05, brand: 0.005 });
+        expect(config.default_rate).toBe(0.01);
+        expect(config.min_confidence).toBe(0.05);
+        expect(config.refresh_threshold).toBe(0.3);
+        expect(config.initial_confidence).toBe(0.9);
+    });
+    it("overwrites previous config on re-set", () => {
+        setConfidenceConfig({ default_rate: 0.01 });
+        setConfidenceConfig({ default_rate: 0.03 });
+        expect(getConfidenceConfig().default_rate).toBe(0.03);
+    });
+    it("merges partial config with defaults", () => {
+        setConfidenceConfig({ default_rate: 0.07 });
+        const config = getConfidenceConfig();
+        expect(config.default_rate).toBe(0.07);
+        expect(config.min_confidence).toBe(0.1); // default preserved
+    });
+});
+// ---------------------------------------------------------------------------
+// getConfidence
+// ---------------------------------------------------------------------------
+describe("getConfidence", () => {
+    it("returns undefined for non-existent entry", () => {
+        expect(getConfidence("missing", "nothing")).toBeUndefined();
+    });
+    it("returns stored confidence when no time has elapsed", () => {
+        indexEntry(makeEntry());
+        // indexEntry sets confidence to 1.0 and last_verified_at to ~now
+        const now = new Date().toISOString();
+        const c = getConfidence("trends", "ai-agents", now);
+        expect(c).toBeCloseTo(1.0, 1);
+    });
+    it("applies time decay using category-specific erosion rate", () => {
+        setConfidenceConfig({
+            erosion_rates: { trends: 0.05 },
+            min_confidence: 0.1,
+        });
+        indexEntry(makeEntry());
+        // Simulate 10 days later
+        const tenDaysLater = addDays(new Date().toISOString(), 10);
+        const c = getConfidence("trends", "ai-agents", tenDaysLater);
+        // 1.0 - (10 * 0.05) = 0.5
+        expect(c).toBeCloseTo(0.5, 1);
+    });
+    it("uses default_rate when no category-specific rate exists", () => {
+        setConfidenceConfig({
+            erosion_rates: {},
+            default_rate: 0.1,
+            min_confidence: 0.1,
+        });
+        indexEntry(makeEntry({ category: "misc", slug: "test" }));
+        const tenDaysLater = addDays(new Date().toISOString(), 10);
+        // 1.0 - (10 * 0.1) = 0.0 → clamped to 0.1
+        const c = getConfidence("misc", "test", tenDaysLater);
+        expect(c).toBe(0.1);
+    });
+    it("uses entry-level erosion_rate when set on the row", () => {
+        setConfidenceConfig({
+            erosion_rates: { trends: 0.05 },
+            default_rate: 0.02,
+            min_confidence: 0.1,
+        });
+        indexEntry(makeEntry());
+        // Override erosion_rate directly on the row
+        const db = getDb();
+        db.prepare("UPDATE knowledge_meta SET erosion_rate = 0.2 WHERE slug = 'ai-agents'").run();
+        const fiveDaysLater = addDays(new Date().toISOString(), 5);
+        // 1.0 - (5 * 0.2) = 0.0 → clamped to 0.1
+        const c = getConfidence("trends", "ai-agents", fiveDaysLater);
+        expect(c).toBe(0.1);
+    });
+    it("never returns below min_confidence", () => {
+        setConfidenceConfig({ default_rate: 0.5, min_confidence: 0.15 });
+        indexEntry(makeEntry());
+        const hundredDaysLater = addDays(new Date().toISOString(), 100);
+        const c = getConfidence("trends", "ai-agents", hundredDaysLater);
+        expect(c).toBe(0.15);
+    });
+    it("throws if db not initialised", () => {
+        closeDb();
+        expect(() => getConfidence("a", "b")).toThrow("Metadata DB not initialised");
+    });
+});
+// ---------------------------------------------------------------------------
+// recordVerification
+// ---------------------------------------------------------------------------
+describe("recordVerification", () => {
+    it("restores confidence to initial_confidence", () => {
+        setConfidenceConfig({ initial_confidence: 0.9, default_rate: 0.1, min_confidence: 0.1 });
+        indexEntry(makeEntry());
+        // Drop confidence via contradiction first
+        recordContradiction("trends", "ai-agents", 0.5);
+        const now = new Date().toISOString();
+        recordVerification("trends", "ai-agents", undefined, now);
+        const c = getConfidence("trends", "ai-agents", now);
+        expect(c).toBeCloseTo(0.9, 5);
+    });
+    it("allows custom confidence value", () => {
+        indexEntry(makeEntry());
+        const now = new Date().toISOString();
+        recordVerification("trends", "ai-agents", 0.95, now);
+        const c = getConfidence("trends", "ai-agents", now);
+        expect(c).toBeCloseTo(0.95, 5);
+    });
+    it("resets the decay clock (last_verified_at)", () => {
+        setConfidenceConfig({ default_rate: 0.1, min_confidence: 0.1 });
+        indexEntry(makeEntry());
+        // After 5 days, confidence would be 0.5 without verification
+        const fiveDaysLater = addDays(new Date().toISOString(), 5);
+        // Verify at day 5 — resets the clock
+        recordVerification("trends", "ai-agents", undefined, fiveDaysLater);
+        // Check at day 5 — should be freshly restored
+        const c = getConfidence("trends", "ai-agents", fiveDaysLater);
+        expect(c).toBeCloseTo(0.8, 1); // default initial_confidence
+    });
+    it("throws for non-existent entry", () => {
+        expect(() => recordVerification("missing", "nope")).toThrow("Entry not found");
+    });
+    it("throws if db not initialised", () => {
+        closeDb();
+        expect(() => recordVerification("a", "b")).toThrow("Metadata DB not initialised");
+    });
+});
+// ---------------------------------------------------------------------------
+// recordContradiction
+// ---------------------------------------------------------------------------
+describe("recordContradiction", () => {
+    it("drops stored confidence by severity amount", () => {
+        indexEntry(makeEntry()); // confidence = 1.0
+        const now = new Date().toISOString();
+        recordContradiction("trends", "ai-agents", 0.3, now);
+        const c = getConfidence("trends", "ai-agents", now);
+        expect(c).toBeCloseTo(0.7, 5);
+    });
+    it("enforces min_confidence floor", () => {
+        setConfidenceConfig({ min_confidence: 0.15 });
+        indexEntry(makeEntry()); // confidence = 1.0
+        const now = new Date().toISOString();
+        recordContradiction("trends", "ai-agents", 0.95, now);
+        const c = getConfidence("trends", "ai-agents", now);
+        expect(c).toBe(0.15);
+    });
+    it("stacks with time decay", () => {
+        setConfidenceConfig({ default_rate: 0.05, min_confidence: 0.1 });
+        indexEntry(makeEntry()); // confidence = 1.0
+        const now = new Date().toISOString();
+        // Contradiction drops stored confidence: 1.0 - 0.3 = 0.7
+        recordContradiction("trends", "ai-agents", 0.3, now);
+        // After 4 more days: 0.7 - (4 * 0.05) = 0.5
+        const fourDaysLater = addDays(now, 4);
+        const c = getConfidence("trends", "ai-agents", fourDaysLater);
+        expect(c).toBeCloseTo(0.5, 1);
+    });
+    it("throws for non-existent entry", () => {
+        expect(() => recordContradiction("missing", "nope", 0.5)).toThrow("Entry not found");
+    });
+    it("throws if db not initialised", () => {
+        closeDb();
+        expect(() => recordContradiction("a", "b", 0.5)).toThrow("Metadata DB not initialised");
+    });
+});
+// ---------------------------------------------------------------------------
+// getRefreshCandidates
+// ---------------------------------------------------------------------------
+describe("getRefreshCandidates", () => {
+    it("returns entries below refresh threshold", () => {
+        setConfidenceConfig({
+            erosion_rates: { trends: 0.05 },
+            default_rate: 0.02,
+            refresh_threshold: 0.4,
+            min_confidence: 0.1,
+        });
+        indexEntry(makeEntry({ slug: "fast-decay", category: "trends" }));
+        indexEntry(makeEntry({ slug: "slow-decay", category: "brand" }));
+        // 15 days later:
+        // trends/fast-decay: 1.0 - (15 * 0.05) = 0.25 < 0.4 -> candidate
+        // brand/slow-decay: 1.0 - (15 * 0.02) = 0.70 >= 0.4 -> not candidate
+        const now = new Date().toISOString();
+        const fifteenDaysLater = addDays(now, 15);
+        const candidates = getRefreshCandidates(undefined, fifteenDaysLater);
+        expect(candidates).toHaveLength(1);
+        expect(candidates[0].slug).toBe("fast-decay");
+        expect(candidates[0].computed_confidence).toBeCloseTo(0.25, 1);
+    });
+    it("orders by computed confidence ascending (most stale first)", () => {
+        setConfidenceConfig({
+            default_rate: 0.05,
+            refresh_threshold: 0.5,
+            min_confidence: 0.1,
+        });
+        indexEntry(makeEntry({ slug: "a", category: "c1" }));
+        indexEntry(makeEntry({ slug: "b", category: "c2" }));
+        // Drop b's stored confidence so it's worse off
+        recordContradiction("c2", "b", 0.3);
+        const now = new Date().toISOString();
+        const twelveDaysLater = addDays(now, 12);
+        // c1/a: 1.0 - (12 * 0.05) = 0.4 < 0.5
+        // c2/b: 0.7 - (12 * 0.05) = 0.1 < 0.5
+        const candidates = getRefreshCandidates(undefined, twelveDaysLater);
+        expect(candidates.length).toBeGreaterThanOrEqual(2);
+        expect(candidates[0].slug).toBe("b"); // lowest first
+    });
+    it("respects limit parameter", () => {
+        setConfidenceConfig({ default_rate: 0.1, refresh_threshold: 0.95, min_confidence: 0.1 });
+        indexEntry(makeEntry({ slug: "x", category: "a" }));
+        indexEntry(makeEntry({ slug: "y", category: "b" }));
+        indexEntry(makeEntry({ slug: "z", category: "c" }));
+        // 2 days later: 1.0 - (2 * 0.1) = 0.8 < 0.95, all 3 qualify
+        const twoDaysLater = addDays(new Date().toISOString(), 2);
+        const candidates = getRefreshCandidates(2, twoDaysLater);
+        expect(candidates).toHaveLength(2);
+    });
+    it("returns empty array when all entries are above threshold", () => {
+        setConfidenceConfig({ default_rate: 0.001, refresh_threshold: 0.4 });
+        indexEntry(makeEntry());
+        const now = new Date().toISOString();
+        const candidates = getRefreshCandidates(undefined, now);
+        expect(candidates).toHaveLength(0);
+    });
+    it("includes correct metadata in each candidate", () => {
+        setConfidenceConfig({ default_rate: 0.1, refresh_threshold: 0.9, min_confidence: 0.1 });
+        indexEntry(makeEntry());
+        const twoDaysLater = addDays(new Date().toISOString(), 2);
+        const candidates = getRefreshCandidates(undefined, twoDaysLater);
+        expect(candidates).toHaveLength(1);
+        const c = candidates[0];
+        expect(c.category).toBe("trends");
+        expect(c.slug).toBe("ai-agents");
+        expect(c.title).toBe("AI Agent Landscape");
+        expect(c.stored_confidence).toBe(1.0);
+        expect(c.computed_confidence).toBeCloseTo(0.8, 1);
+        expect(typeof c.last_verified_at).toBe("string");
+        expect(typeof c.erosion_rate).toBe("number");
+    });
+    it("throws if db not initialised", () => {
+        closeDb();
+        expect(() => getRefreshCandidates()).toThrow("Metadata DB not initialised");
+    });
+});
+//# sourceMappingURL=confidence.test.js.map

package/dist/confidence/__tests__/confidence.test.js.map

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

package/dist/confidence/erosion.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Pure functions for time-based confidence erosion.
+ *
+ * Confidence decays linearly over time but never drops below a configured floor.
+ * Decay is computed at read time — stored confidence only changes on verification
+ * or contradiction events.
+ */
+/**
+ * Calculate the number of days elapsed between two ISO 8601 timestamps.
+ * Returns 0 if end is before start.
+ */
+export declare function daysElapsed(start: string, now: string): number;
+/**
+ * Compute current confidence after applying linear time decay.
+ *
+ * Formula: confidence = max(minConfidence, storedConfidence - (daysElapsed * erosionRate))
+ *
+ * @param storedConfidence - The confidence value stored in the database
+ * @param lastVerifiedAt - ISO 8601 timestamp of last verification
+ * @param erosionRate - Daily decay rate (e.g. 0.05 = 5% per day)
+ * @param minConfidence - Confidence floor (values never go below this)
+ * @param now - Current time as ISO 8601 string
+ */
+export declare function computeConfidence(storedConfidence: number, lastVerifiedAt: string, erosionRate: number, minConfidence: number, now: string): number;
+/**
+ * Compute confidence after applying a contradiction drop.
+ *
+ * @param currentConfidence - Current confidence (before drop)
+ * @param severity - Amount to subtract (e.g. 0.3 for a major contradiction)
+ * @param minConfidence - Confidence floor
+ */
+export declare function applyContradiction(currentConfidence: number, severity: number, minConfidence: number): number;
+//# sourceMappingURL=erosion.d.ts.map

package/dist/confidence/erosion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erosion.d.ts","sourceRoot":"","sources":["../../src/confidence/erosion.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,GACV,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,MAAM,CAER"}