@indigoai-us/cq 0.0.1

package/dist/metadata/index.js

@@ -0,0 +1,108 @@
+/**
+ * Metadata Store — SQLite-backed metadata tracking for knowledge entries.
+ *
+ * Tracks confidence scores, token counts, erosion rates, and timestamps
+ * alongside the knowledge tree.
+ */
+import Database from "better-sqlite3";
+import { CREATE_KNOWLEDGE_META, CREATE_KNOWLEDGE_FTS } from "./schema.js";
+// ---------------------------------------------------------------------------
+// Database lifecycle
+// ---------------------------------------------------------------------------
+let db = null;
+/** Initialise (or open) the metadata SQLite database with WAL journaling. */
+export function initMetadataDb(dbPath) {
+    db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.exec(CREATE_KNOWLEDGE_META);
+    db.exec(CREATE_KNOWLEDGE_FTS);
+    return db;
+}
+/** Close the database connection. */
+export function closeDb() {
+    if (db) {
+        db.close();
+        db = null;
+    }
+}
+/** Return the current database instance (mainly for testing). */
+export function getDb() {
+    return db;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Estimate token count from content (~4 chars per token). */
+function estimateTokens(content) {
+    return Math.ceil(content.length / 4);
+}
+/** Count sources — 1 if entry has a source URL, 0 otherwise. */
+function countSources(entry) {
+    return entry.source ? 1 : 0;
+}
+// ---------------------------------------------------------------------------
+// CRUD operations
+// ---------------------------------------------------------------------------
+/**
+ * Index (upsert) a KnowledgeEntry into the metadata store.
+ *
+ * Sets confidence to 1.0 and resets last_verified_at on every write.
+ */
+export function indexEntry(entry) {
+    if (!db)
+        throw new Error("Metadata DB not initialised — call initMetadataDb first");
+    const now = new Date().toISOString();
+    const stmt = db.prepare(`
+    INSERT INTO knowledge_meta (slug, category, title, confidence, created_at, updated_at, last_verified_at, erosion_rate, token_count, source_count)
+    VALUES (@slug, @category, @title, @confidence, @created_at, @updated_at, @last_verified_at, @erosion_rate, @token_count, @source_count)
+    ON CONFLICT (category, slug) DO UPDATE SET
+      title           = @title,
+      confidence      = @confidence,
+      updated_at      = @updated_at,
+      last_verified_at = @last_verified_at,
+      erosion_rate    = @erosion_rate,
+      token_count     = @token_count,
+      source_count    = @source_count
+  `);
+    stmt.run({
+        slug: entry.slug,
+        category: entry.category,
+        title: entry.title,
+        confidence: 1.0,
+        created_at: entry.created,
+        updated_at: now,
+        last_verified_at: now,
+        erosion_rate: 0.0,
+        token_count: estimateTokens(entry.content),
+        source_count: countSources(entry),
+    });
+    // Sync FTS index: delete old row (if any) then insert fresh content.
+    db.prepare("DELETE FROM knowledge_fts WHERE category = ? AND slug = ?").run(entry.category, entry.slug);
+    db.prepare(`
+    INSERT INTO knowledge_fts (category, slug, title, content, tags_json)
+    VALUES (?, ?, ?, ?, ?)
+  `).run(entry.category, entry.slug, entry.title, entry.content, JSON.stringify(entry.tags));
+}
+/** Remove metadata for a specific entry. */
+export function removeFromIndex(category, slug) {
+    if (!db)
+        throw new Error("Metadata DB not initialised — call initMetadataDb first");
+    db.prepare("DELETE FROM knowledge_meta WHERE category = ? AND slug = ?").run(category, slug);
+    db.prepare("DELETE FROM knowledge_fts WHERE category = ? AND slug = ?").run(category, slug);
+}
+/** Retrieve metadata for a specific entry, or undefined if not found. */
+export function getMetadata(category, slug) {
+    if (!db)
+        throw new Error("Metadata DB not initialised — call initMetadataDb first");
+    const stmt = db.prepare("SELECT * FROM knowledge_meta WHERE category = ? AND slug = ?");
+    const row = stmt.get(category, slug);
+    return row;
+}
+/** Return all entries with confidence at or below the given threshold. */
+export function getStaleEntries(threshold) {
+    if (!db)
+        throw new Error("Metadata DB not initialised — call initMetadataDb first");
+    const stmt = db.prepare("SELECT * FROM knowledge_meta WHERE confidence <= ? ORDER BY confidence ASC");
+    return stmt.all(threshold);
+}
+//# sourceMappingURL=index.js.map

package/dist/metadata/index.js.map

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

package/dist/metadata/schema.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SQLite schema definitions for the metadata store.
+ */
+/** SQL to create the knowledge_meta table. */
+export declare const CREATE_KNOWLEDGE_META = "\nCREATE TABLE IF NOT EXISTS knowledge_meta (\n  slug            TEXT    NOT NULL,\n  category        TEXT    NOT NULL,\n  title           TEXT    NOT NULL,\n  confidence      REAL    NOT NULL DEFAULT 1.0,\n  created_at      TEXT    NOT NULL,\n  updated_at      TEXT    NOT NULL,\n  last_verified_at TEXT   NOT NULL,\n  erosion_rate    REAL    NOT NULL DEFAULT 0.0,\n  token_count     INTEGER NOT NULL DEFAULT 0,\n  source_count    INTEGER NOT NULL DEFAULT 0,\n  PRIMARY KEY (category, slug)\n);\n";
+/** SQL to create the FTS5 virtual table for full-text search. */
+export declare const CREATE_KNOWLEDGE_FTS = "\nCREATE VIRTUAL TABLE IF NOT EXISTS knowledge_fts USING fts5(\n  category,\n  slug,\n  title,\n  content,\n  tags_json,\n  tokenize = 'porter unicode61'\n);\n";
+//# sourceMappingURL=schema.d.ts.map

package/dist/metadata/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/metadata/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,sfAcjC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,oKAShC,CAAC"}

package/dist/metadata/schema.js

@@ -0,0 +1,31 @@
+/**
+ * SQLite schema definitions for the metadata store.
+ */
+/** SQL to create the knowledge_meta table. */
+export const CREATE_KNOWLEDGE_META = `
+CREATE TABLE IF NOT EXISTS knowledge_meta (
+  slug            TEXT    NOT NULL,
+  category        TEXT    NOT NULL,
+  title           TEXT    NOT NULL,
+  confidence      REAL    NOT NULL DEFAULT 1.0,
+  created_at      TEXT    NOT NULL,
+  updated_at      TEXT    NOT NULL,
+  last_verified_at TEXT   NOT NULL,
+  erosion_rate    REAL    NOT NULL DEFAULT 0.0,
+  token_count     INTEGER NOT NULL DEFAULT 0,
+  source_count    INTEGER NOT NULL DEFAULT 0,
+  PRIMARY KEY (category, slug)
+);
+`;
+/** SQL to create the FTS5 virtual table for full-text search. */
+export const CREATE_KNOWLEDGE_FTS = `
+CREATE VIRTUAL TABLE IF NOT EXISTS knowledge_fts USING fts5(
+  category,
+  slug,
+  title,
+  content,
+  tags_json,
+  tokenize = 'porter unicode61'
+);
+`;
+//# sourceMappingURL=schema.js.map

package/dist/metadata/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/metadata/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;CAcpC,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;CASnC,CAAC"}

package/dist/metadata/search.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Full-text search over the knowledge base using FTS5 with BM25 ranking.
+ */
+import type { KnowledgeEntry } from "../knowledge-tree/types.js";
+/** A single search result with ranking metadata. */
+export interface SearchResult {
+    category: string;
+    slug: string;
+    title: string;
+    snippet: string;
+    rank: number;
+}
+/**
+ * Search the knowledge base using FTS5 full-text search with BM25 ranking.
+ *
+ * @param query - FTS5 query string (supports AND, OR, NOT, prefix*, "phrases")
+ * @param limit - Maximum number of results to return (default 10)
+ * @returns Ranked search results ordered by relevance (best first)
+ */
+export declare function search(query: string, limit?: number): SearchResult[];
+/**
+ * Drop and rebuild the FTS index from a full set of knowledge entries.
+ *
+ * Useful for reindexing after bulk changes or recovering from corruption.
+ */
+export declare function rebuildIndex(entries: KnowledgeEntry[]): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/metadata/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/metadata/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAOjE,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE,CAkBhE;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI,CAwB5D"}

package/dist/metadata/search.js

@@ -0,0 +1,57 @@
+/**
+ * Full-text search over the knowledge base using FTS5 with BM25 ranking.
+ */
+import { getDb } from "./index.js";
+// ---------------------------------------------------------------------------
+// Search
+// ---------------------------------------------------------------------------
+/**
+ * Search the knowledge base using FTS5 full-text search with BM25 ranking.
+ *
+ * @param query - FTS5 query string (supports AND, OR, NOT, prefix*, "phrases")
+ * @param limit - Maximum number of results to return (default 10)
+ * @returns Ranked search results ordered by relevance (best first)
+ */
+export function search(query, limit = 10) {
+    const db = getDb();
+    if (!db)
+        throw new Error("Metadata DB not initialised — call initMetadataDb first");
+    const stmt = db.prepare(`
+    SELECT
+      category,
+      slug,
+      title,
+      snippet(knowledge_fts, 3, '<mark>', '</mark>', '...', 64) AS snippet,
+      bm25(knowledge_fts, 2.0, 1.0, 5.0, 10.0, 1.0) AS rank
+    FROM knowledge_fts
+    WHERE knowledge_fts MATCH ?
+    ORDER BY rank
+    LIMIT ?
+  `);
+    return stmt.all(query, limit);
+}
+// ---------------------------------------------------------------------------
+// Rebuild
+// ---------------------------------------------------------------------------
+/**
+ * Drop and rebuild the FTS index from a full set of knowledge entries.
+ *
+ * Useful for reindexing after bulk changes or recovering from corruption.
+ */
+export function rebuildIndex(entries) {
+    const db = getDb();
+    if (!db)
+        throw new Error("Metadata DB not initialised — call initMetadataDb first");
+    const dropAndRebuild = db.transaction(() => {
+        db.exec("DELETE FROM knowledge_fts");
+        const insert = db.prepare(`
+      INSERT INTO knowledge_fts (category, slug, title, content, tags_json)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        for (const entry of entries) {
+            insert.run(entry.category, entry.slug, entry.title, entry.content, JSON.stringify(entry.tags));
+        }
+    });
+    dropAndRebuild();
+}
+//# sourceMappingURL=search.js.map

package/dist/metadata/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/metadata/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAenC,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;IAC9C,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAEpF,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;GAWvB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAmB,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAyB;IACpD,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAEpF,MAAM,cAAc,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACzC,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAErC,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC;;;KAGzB,CAAC,CAAC;QAEH,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CACR,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,OAAO,EACb,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAC3B,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,cAAc,EAAE,CAAC;AACnB,CAAC"}

package/dist/metadata/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Metadata store type definitions.
+ */
+/** A row in the knowledge_meta table. */
+export interface KnowledgeMetadata {
+    slug: string;
+    category: string;
+    title: string;
+    confidence: number;
+    created_at: string;
+    updated_at: string;
+    last_verified_at: string;
+    erosion_rate: number;
+    token_count: number;
+    source_count: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metadata/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/metadata/types.js

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

package/dist/metadata/types.js.map

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

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

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

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

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

package/dist/orchestrator/__tests__/orchestrator.test.js

@@ -0,0 +1,354 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { initMetadataDb, closeDb } from "../../metadata/index.js";
+import { initCuriosityQueue, addCuriosity, fetchPending } from "../../curiosity/index.js";
+import { initKnowledgeTree, writeEntry } from "../../knowledge-tree/index.js";
+import { initBudgetTables, setBudgetConfig, charge } from "../../budget/index.js";
+import { setConfidenceConfig } from "../../confidence/index.js";
+import { runOrchestrator, getRecentRuns } from "../index.js";
+import { matchesCron, startScheduler, stopScheduler, isSchedulerRunning } from "../scheduler.js";
+// ---------------------------------------------------------------------------
+// Mock providers
+// ---------------------------------------------------------------------------
+class MockSearchProvider {
+    name = "mock-search";
+    _lastCost = 0;
+    callCount = 0;
+    async search() {
+        this.callCount++;
+        this._lastCost = 0.01;
+        return [
+            {
+                title: "Result for query",
+                url: "https://example.com/result",
+                snippet: "A detailed search result with enough content to pass vetting.",
+                content: "Comprehensive content about the topic with sufficient detail for synthesis.",
+            },
+        ];
+    }
+    lastCallCostUsd() {
+        return this._lastCost;
+    }
+}
+class MockModelProvider {
+    name = "mock-model";
+    _lastCost = 0;
+    callCount = 0;
+    async synthesize(question, searchResults) {
+        this.callCount++;
+        this._lastCost = 0.005;
+        return {
+            title: `Synthesised: ${question.slice(0, 50)}`,
+            category: "technology",
+            content: `Answer synthesised from ${searchResults.length} sources about ${question}.`,
+            tags: ["research"],
+            source: searchResults[0]?.url ?? "unknown",
+            confidence: 0.85,
+        };
+    }
+    async categorize(_content, categories) {
+        this._lastCost = 0.001;
+        return categories[0] ?? "general";
+    }
+    lastCallCostUsd() {
+        return this._lastCost;
+    }
+}
+// ---------------------------------------------------------------------------
+// Test setup
+// ---------------------------------------------------------------------------
+let tmpDir;
+let dataDir;
+let db;
+beforeEach(async () => {
+    tmpDir = await mkdtemp(join(tmpdir(), "cq-orchestrator-test-"));
+    dataDir = join(tmpDir, "knowledge");
+    await initKnowledgeTree(dataDir);
+    db = initMetadataDb(":memory:");
+    initCuriosityQueue(db);
+    initBudgetTables();
+    setBudgetConfig({ dailyLimitUsd: 5.0 });
+});
+afterEach(async () => {
+    stopScheduler();
+    closeDb();
+    await rm(tmpDir, { recursive: true, force: true });
+});
+function makeOptions(overrides = {}) {
+    return {
+        db,
+        dataDir,
+        searchProvider: new MockSearchProvider(),
+        modelProvider: new MockModelProvider(),
+        ...overrides,
+    };
+}
+const DISTINCT_QUESTIONS = [
+    "What is quantum computing and how does it work?",
+    "How do black holes form in outer space?",
+    "What causes the Northern Lights aurora borealis?",
+    "How does CRISPR gene editing technology function?",
+    "What is the theory of general relativity?",
+];
+function addTestItems(count) {
+    for (let i = 0; i < count; i++) {
+        addCuriosity({
+            question: DISTINCT_QUESTIONS[i % DISTINCT_QUESTIONS.length],
+            context: `Test context ${i}`,
+            source: "agent",
+            priority: 10 - i,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// runOrchestrator — two-phase execution
+// ---------------------------------------------------------------------------
+describe("runOrchestrator — Phase 1 (Curiosity)", () => {
+    it("processes pending curiosity items", async () => {
+        addTestItems(3);
+        const result = await runOrchestrator(makeOptions());
+        expect(result.status).toBe("completed");
+        expect(result.phases.curiosity.processed).toBe(3);
+        expect(result.phases.curiosity.succeeded).toBe(3);
+        expect(result.phases.curiosity.failed).toBe(0);
+        expect(result.totalDurationMs).toBeGreaterThanOrEqual(0);
+        expect(result.runDate).toBeDefined();
+    });
+    it("respects maxCuriosityItems limit", async () => {
+        addTestItems(5);
+        const result = await runOrchestrator(makeOptions({ maxCuriosityItems: 2 }));
+        expect(result.phases.curiosity.processed).toBe(2);
+        // Should still have 3 pending
+        const remaining = fetchPending(10);
+        expect(remaining.length).toBe(3);
+    });
+    it("returns completed with zero items when queue is empty", async () => {
+        const result = await runOrchestrator(makeOptions());
+        expect(result.status).toBe("completed");
+        expect(result.phases.curiosity.processed).toBe(0);
+        expect(result.phases.curiosity.succeeded).toBe(0);
+    });
+    it("tracks cost across items", async () => {
+        addTestItems(2);
+        const result = await runOrchestrator(makeOptions());
+        expect(result.phases.curiosity.costUsd).toBeGreaterThan(0);
+        expect(result.totalBudgetUsedUsd).toBeGreaterThan(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// Budget exhaustion
+// ---------------------------------------------------------------------------
+describe("runOrchestrator — budget exhaustion", () => {
+    it("stops processing when budget is exhausted", async () => {
+        // Set budget so low that only 1–2 items can run (each costs ~$0.015)
+        setBudgetConfig({ dailyLimitUsd: 0.02 });
+        addTestItems(5);
+        const result = await runOrchestrator(makeOptions());
+        // Should process fewer than all 5
+        const total = result.phases.curiosity.processed + result.phases.curiosity.skipped;
+        expect(total).toBeLessThanOrEqual(5);
+        expect(result.phases.curiosity.processed).toBeLessThan(5);
+    });
+    it("skips Phase 2 when budget below proactive minimum", async () => {
+        // Set budget just enough for Phase 1 but not Phase 2
+        setBudgetConfig({ dailyLimitUsd: 0.05 });
+        addTestItems(1);
+        const result = await runOrchestrator(makeOptions({ proactiveMinBudgetUsd: 10.0 }));
+        expect(result.phases.proactive).toBeNull();
+    });
+});
+// ---------------------------------------------------------------------------
+// Phase 2 (Proactive)
+// ---------------------------------------------------------------------------
+describe("runOrchestrator — Phase 2 (Proactive)", () => {
+    it("refreshes low-confidence entries", async () => {
+        // Create a knowledge entry and manually set its confidence low
+        await writeEntry(dataDir, {
+            category: "technology",
+            title: "Outdated knowledge",
+            content: "This is old content that needs refreshing.",
+            tags: ["old"],
+        });
+        // Index it with low confidence
+        db.prepare(`
+      INSERT INTO knowledge_meta (slug, category, title, confidence, created_at, updated_at, last_verified_at, erosion_rate, token_count, source_count)
+      VALUES ('outdated-knowledge', 'technology', 'Outdated knowledge', 0.1, '2025-01-01T00:00:00Z', '2025-01-01T00:00:00Z', '2025-01-01T00:00:00Z', 0.02, 100, 1)
+    `).run();
+        setConfidenceConfig({ refresh_threshold: 0.4, default_rate: 0.02 });
+        const result = await runOrchestrator(makeOptions());
+        // Phase 2 should have run
+        expect(result.phases.proactive).not.toBeNull();
+        expect(result.phases.proactive.refreshed).toBeGreaterThanOrEqual(0);
+    });
+    it("fills thin categories", async () => {
+        // Create a category with only 1 entry (below default threshold of 3)
+        await writeEntry(dataDir, {
+            category: "sparse-topic",
+            title: "Only entry",
+            content: "This is the only entry in this thin category.",
+            tags: [],
+        });
+        const result = await runOrchestrator(makeOptions({ thinCategoryThreshold: 3 }));
+        expect(result.phases.proactive).not.toBeNull();
+        expect(result.phases.proactive.thinCategoryFilled).toBeGreaterThanOrEqual(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// Run log
+// ---------------------------------------------------------------------------
+describe("research_job_log", () => {
+    it("records run history", async () => {
+        addTestItems(2);
+        await runOrchestrator(makeOptions());
+        const runs = getRecentRuns(db, 5);
+        expect(runs.length).toBe(1);
+        expect(runs[0].status).toBe("completed");
+        expect(runs[0].phase1_processed).toBe(2);
+        expect(runs[0].total_cost_usd).toBeGreaterThan(0);
+        expect(runs[0].duration_ms).toBeGreaterThanOrEqual(0);
+        expect(runs[0].run_date).toBeDefined();
+        expect(runs[0].created_at).toBeDefined();
+    });
+    it("records multiple runs in order", async () => {
+        addTestItems(1);
+        await runOrchestrator(makeOptions());
+        addTestItems(1);
+        await runOrchestrator(makeOptions());
+        const runs = getRecentRuns(db, 10);
+        expect(runs.length).toBe(2);
+        // Most recent first
+        expect(runs[0].created_at >= runs[1].created_at).toBe(true);
+    });
+    it("respects limit parameter", async () => {
+        addTestItems(1);
+        await runOrchestrator(makeOptions());
+        addTestItems(1);
+        await runOrchestrator(makeOptions());
+        addTestItems(1);
+        await runOrchestrator(makeOptions());
+        const runs = getRecentRuns(db, 2);
+        expect(runs.length).toBe(2);
+    });
+    it("records error for failed runs", async () => {
+        // Pre-exhaust budget by charging more than the limit
+        setBudgetConfig({ dailyLimitUsd: 1.0 });
+        charge("other", 1.5);
+        addTestItems(3);
+        await runOrchestrator(makeOptions());
+        const runs = getRecentRuns(db, 1);
+        expect(runs.length).toBe(1);
+        // All items should be skipped since budget is already over limit
+        expect(runs[0].phase1_processed).toBe(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// OrchestratorResult shape
+// ---------------------------------------------------------------------------
+describe("OrchestratorResult shape", () => {
+    it("has all required fields", async () => {
+        addTestItems(1);
+        const result = await runOrchestrator(makeOptions());
+        expect(result).toHaveProperty("runDate");
+        expect(result).toHaveProperty("status");
+        expect(result).toHaveProperty("phases");
+        expect(result).toHaveProperty("phases.curiosity");
+        expect(result).toHaveProperty("totalDurationMs");
+        expect(result).toHaveProperty("totalBudgetUsedUsd");
+        expect(result.phases.curiosity).toHaveProperty("processed");
+        expect(result.phases.curiosity).toHaveProperty("succeeded");
+        expect(result.phases.curiosity).toHaveProperty("failed");
+        expect(result.phases.curiosity).toHaveProperty("skipped");
+        expect(result.phases.curiosity).toHaveProperty("costUsd");
+    });
+});
+// ---------------------------------------------------------------------------
+// matchesCron
+// ---------------------------------------------------------------------------
+describe("matchesCron", () => {
+    it("matches wildcard pattern", () => {
+        const date = new Date(2025, 5, 15, 10, 30); // June 15, 10:30
+        expect(matchesCron("* * *", date)).toBe(true);
+    });
+    it("matches exact time", () => {
+        const date = new Date(2025, 0, 1, 3, 0); // Jan 1, 3:00 AM
+        expect(matchesCron("0 3 *", date)).toBe(true);
+    });
+    it("rejects non-matching minute", () => {
+        const date = new Date(2025, 0, 1, 3, 15);
+        expect(matchesCron("0 3 *", date)).toBe(false);
+    });
+    it("rejects non-matching hour", () => {
+        const date = new Date(2025, 0, 1, 5, 0);
+        expect(matchesCron("0 3 *", date)).toBe(false);
+    });
+    it("matches specific day of month", () => {
+        const date = new Date(2025, 0, 15, 0, 0);
+        expect(matchesCron("0 0 15", date)).toBe(true);
+    });
+    it("rejects non-matching day of month", () => {
+        const date = new Date(2025, 0, 14, 0, 0);
+        expect(matchesCron("0 0 15", date)).toBe(false);
+    });
+    it("supports comma-separated values", () => {
+        const date6am = new Date(2025, 0, 1, 6, 0);
+        const date18pm = new Date(2025, 0, 1, 18, 0);
+        const date12pm = new Date(2025, 0, 1, 12, 0);
+        expect(matchesCron("0 6,18 *", date6am)).toBe(true);
+        expect(matchesCron("0 6,18 *", date18pm)).toBe(true);
+        expect(matchesCron("0 6,18 *", date12pm)).toBe(false);
+    });
+    it("throws on invalid cron expression", () => {
+        expect(() => matchesCron("0 3", new Date())).toThrow("Invalid cron expression");
+        expect(() => matchesCron("0 3 * *", new Date())).toThrow("Invalid cron expression");
+    });
+});
+// ---------------------------------------------------------------------------
+// Scheduler
+// ---------------------------------------------------------------------------
+describe("scheduler", () => {
+    afterEach(() => {
+        stopScheduler();
+    });
+    it("starts and reports running state", () => {
+        expect(isSchedulerRunning()).toBe(false);
+        startScheduler({
+            cron: "0 3 *",
+            orchestratorOptions: makeOptions(),
+        });
+        expect(isSchedulerRunning()).toBe(true);
+    });
+    it("stops and reports not running", () => {
+        startScheduler({
+            cron: "0 3 *",
+            orchestratorOptions: makeOptions(),
+        });
+        stopScheduler();
+        expect(isSchedulerRunning()).toBe(false);
+    });
+    it("throws when starting an already-running scheduler", () => {
+        startScheduler({
+            cron: "0 3 *",
+            orchestratorOptions: makeOptions(),
+        });
+        expect(() => startScheduler({
+            cron: "0 3 *",
+            orchestratorOptions: makeOptions(),
+        })).toThrow("already running");
+    });
+    it("can be restarted after stopping", () => {
+        startScheduler({
+            cron: "0 3 *",
+            orchestratorOptions: makeOptions(),
+        });
+        stopScheduler();
+        // Should not throw
+        startScheduler({
+            cron: "0 3 *",
+            orchestratorOptions: makeOptions(),
+        });
+        expect(isSchedulerRunning()).toBe(true);
+    });
+});
+//# sourceMappingURL=orchestrator.test.js.map