@indigoai-us/cq 0.0.1

package/dist/curiosity/dedup.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Deduplication via normalized Levenshtein distance.
+ *
+ * Two questions are considered duplicates when their normalized similarity
+ * exceeds 0.85 (i.e. normalizedLevenshtein(a, b) > 0.85).
+ */
+/**
+ * Compute the Levenshtein edit distance between two strings.
+ *
+ * Uses the classic O(m*n) dynamic-programming approach with a single-row
+ * optimisation for memory efficiency.
+ */
+export declare function levenshtein(a: string, b: string): number;
+/**
+ * Normalized Levenshtein similarity: 1 - (distance / max_length).
+ *
+ * Returns a value in [0, 1] where 1 means identical strings.
+ * Returns 1 for two empty strings.
+ */
+export declare function normalizedSimilarity(a: string, b: string): number;
+/** Similarity threshold above which two questions are duplicates. */
+export declare const DEDUP_THRESHOLD = 0.85;
+/**
+ * Check whether `question` is a duplicate of any string in `existing`.
+ *
+ * Comparison is case-insensitive and whitespace-normalized.
+ */
+export declare function isDuplicate(question: string, existing: string[]): boolean;
+//# sourceMappingURL=dedup.d.ts.map

package/dist/curiosity/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/curiosity/dedup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA2BxD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,qEAAqE;AACrE,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAKzE"}

package/dist/curiosity/dedup.js

@@ -0,0 +1,64 @@
+/**
+ * Deduplication via normalized Levenshtein distance.
+ *
+ * Two questions are considered duplicates when their normalized similarity
+ * exceeds 0.85 (i.e. normalizedLevenshtein(a, b) > 0.85).
+ */
+/**
+ * Compute the Levenshtein edit distance between two strings.
+ *
+ * Uses the classic O(m*n) dynamic-programming approach with a single-row
+ * optimisation for memory efficiency.
+ */
+export function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    // Previous row of distances (length n+1)
+    let prev = new Array(n + 1);
+    let curr = new Array(n + 1);
+    for (let j = 0; j <= n; j++)
+        prev[j] = j;
+    for (let i = 1; i <= m; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min(prev[j] + 1, // deletion
+            curr[j - 1] + 1, // insertion
+            prev[j - 1] + cost);
+        }
+        [prev, curr] = [curr, prev];
+    }
+    return prev[n];
+}
+/**
+ * Normalized Levenshtein similarity: 1 - (distance / max_length).
+ *
+ * Returns a value in [0, 1] where 1 means identical strings.
+ * Returns 1 for two empty strings.
+ */
+export function normalizedSimilarity(a, b) {
+    const maxLen = Math.max(a.length, b.length);
+    if (maxLen === 0)
+        return 1;
+    return 1 - levenshtein(a, b) / maxLen;
+}
+/** Similarity threshold above which two questions are duplicates. */
+export const DEDUP_THRESHOLD = 0.85;
+/**
+ * Check whether `question` is a duplicate of any string in `existing`.
+ *
+ * Comparison is case-insensitive and whitespace-normalized.
+ */
+export function isDuplicate(question, existing) {
+    const norm = normalize(question);
+    return existing.some((e) => normalizedSimilarity(norm, normalize(e)) > DEDUP_THRESHOLD);
+}
+/** Lowercase and collapse whitespace for fair comparison. */
+function normalize(s) {
+    return s.toLowerCase().replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=dedup.js.map

package/dist/curiosity/dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../src/curiosity/dedup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IAEnB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEtB,yCAAyC;IACzC,IAAI,IAAI,GAAG,IAAI,KAAK,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,IAAI,IAAI,GAAG,IAAI,KAAK,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAChB,IAAI,CAAC,CAAC,CAAE,GAAG,CAAC,EAAQ,WAAW;YAC/B,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,EAAI,YAAY;YAChC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,IAAI,CACpB,CAAC;QACJ,CAAC;QACD,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,IAAI,CAAC,CAAC,CAAE,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,CAAS,EAAE,CAAS;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC;AACxC,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAkB;IAC9D,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC,IAAI,CAClB,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,CAClE,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACrD,CAAC"}

package/dist/curiosity/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Curiosity Queue — priority-based queue for agent-filed questions.
+ *
+ * Uses the same SQLite database as the metadata store (obtained via getDb()).
+ * The curiosity_queue table is created by calling initCuriosityQueue().
+ */
+import type Database from "better-sqlite3";
+import type { CuriosityItem, AddCuriosityInput, StatusCounts } from "./types.js";
+export type { CuriosityItem, AddCuriosityInput, CuriositySource, CuriosityStatus, StatusCounts, } from "./types.js";
+export { levenshtein, normalizedSimilarity, isDuplicate, DEDUP_THRESHOLD } from "./dedup.js";
+/**
+ * Create the curiosity_queue table in the given database.
+ *
+ * Call this after initMetadataDb() — pass the db instance returned by getDb().
+ */
+export declare function initCuriosityQueue(db?: Database.Database): void;
+/**
+ * Add a curiosity item to the queue.
+ *
+ * Rejects duplicates: if a pending item has normalized Levenshtein similarity
+ * > 0.85 with the new question, the insert is skipped and null is returned.
+ */
+export declare function addCuriosity(input: AddCuriosityInput): CuriosityItem | null;
+/**
+ * Fetch pending items ordered by priority DESC, created_at ASC.
+ */
+export declare function fetchPending(limit: number): CuriosityItem[];
+/**
+ * Get a single curiosity item by ID.
+ */
+export declare function getItem(id: number): CuriosityItem | undefined;
+/**
+ * Mark an item as in_progress.
+ */
+export declare function markInProgress(id: number): void;
+/**
+ * Mark an item as completed.
+ */
+export declare function markCompleted(id: number): void;
+/**
+ * Mark an item as failed with an error message.
+ */
+export declare function markFailed(id: number, error: string): void;
+/**
+ * Dismiss a curiosity item.
+ */
+export declare function dismiss(id: number): void;
+/**
+ * Return the count of items per status.
+ */
+export declare function countByStatus(): StatusCounts;
+/**
+ * Remove failed items older than the specified number of days.
+ */
+export declare function pruneFailed(olderThanDays: number): number;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/curiosity/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAEjB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAwB7F;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAG/D;AAoBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,GAAG,IAAI,CA+B3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAO3D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAK7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAK/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAK9C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAK1D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKxC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAmB5C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CASzD"}

package/dist/curiosity/index.js

@@ -0,0 +1,163 @@
+/**
+ * Curiosity Queue — priority-based queue for agent-filed questions.
+ *
+ * Uses the same SQLite database as the metadata store (obtained via getDb()).
+ * The curiosity_queue table is created by calling initCuriosityQueue().
+ */
+import { getDb } from "../metadata/index.js";
+import { isDuplicate } from "./dedup.js";
+export { levenshtein, normalizedSimilarity, isDuplicate, DEDUP_THRESHOLD } from "./dedup.js";
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const CREATE_CURIOSITY_QUEUE = `
+CREATE TABLE IF NOT EXISTS curiosity_queue (
+  id         INTEGER PRIMARY KEY AUTOINCREMENT,
+  question   TEXT    NOT NULL,
+  context    TEXT    NOT NULL DEFAULT '',
+  source     TEXT    NOT NULL,
+  priority   INTEGER NOT NULL DEFAULT 5,
+  status     TEXT    NOT NULL DEFAULT 'pending',
+  error      TEXT,
+  created_at TEXT    NOT NULL,
+  updated_at TEXT    NOT NULL
+);
+`;
+// ---------------------------------------------------------------------------
+// Initialisation
+// ---------------------------------------------------------------------------
+/**
+ * Create the curiosity_queue table in the given database.
+ *
+ * Call this after initMetadataDb() — pass the db instance returned by getDb().
+ */
+export function initCuriosityQueue(db) {
+    const conn = db ?? requireDb();
+    conn.exec(CREATE_CURIOSITY_QUEUE);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function requireDb() {
+    const conn = getDb();
+    if (!conn)
+        throw new Error("Database not initialised — call initMetadataDb first");
+    return conn;
+}
+function now() {
+    return new Date().toISOString();
+}
+// ---------------------------------------------------------------------------
+// CRUD
+// ---------------------------------------------------------------------------
+/**
+ * Add a curiosity item to the queue.
+ *
+ * Rejects duplicates: if a pending item has normalized Levenshtein similarity
+ * > 0.85 with the new question, the insert is skipped and null is returned.
+ */
+export function addCuriosity(input) {
+    const db = requireDb();
+    // Validate priority range
+    if (input.priority < 1 || input.priority > 10) {
+        throw new Error("Priority must be between 1 and 10");
+    }
+    // Dedup against pending items
+    const pendingQuestions = db
+        .prepare("SELECT question FROM curiosity_queue WHERE status = 'pending'")
+        .all();
+    if (isDuplicate(input.question, pendingQuestions.map((r) => r.question))) {
+        return null;
+    }
+    const ts = now();
+    const result = db.prepare(`
+    INSERT INTO curiosity_queue (question, context, source, priority, status, created_at, updated_at)
+    VALUES (@question, @context, @source, @priority, 'pending', @created_at, @updated_at)
+  `).run({
+        question: input.question,
+        context: input.context,
+        source: input.source,
+        priority: input.priority,
+        created_at: ts,
+        updated_at: ts,
+    });
+    return getItem(Number(result.lastInsertRowid));
+}
+/**
+ * Fetch pending items ordered by priority DESC, created_at ASC.
+ */
+export function fetchPending(limit) {
+    const db = requireDb();
+    return db
+        .prepare("SELECT * FROM curiosity_queue WHERE status = 'pending' ORDER BY priority DESC, created_at ASC LIMIT ?")
+        .all(limit);
+}
+/**
+ * Get a single curiosity item by ID.
+ */
+export function getItem(id) {
+    const db = requireDb();
+    return db
+        .prepare("SELECT * FROM curiosity_queue WHERE id = ?")
+        .get(id);
+}
+/**
+ * Mark an item as in_progress.
+ */
+export function markInProgress(id) {
+    const db = requireDb();
+    db.prepare("UPDATE curiosity_queue SET status = 'in_progress', updated_at = ? WHERE id = ?").run(now(), id);
+}
+/**
+ * Mark an item as completed.
+ */
+export function markCompleted(id) {
+    const db = requireDb();
+    db.prepare("UPDATE curiosity_queue SET status = 'completed', updated_at = ? WHERE id = ?").run(now(), id);
+}
+/**
+ * Mark an item as failed with an error message.
+ */
+export function markFailed(id, error) {
+    const db = requireDb();
+    db.prepare("UPDATE curiosity_queue SET status = 'failed', error = ?, updated_at = ? WHERE id = ?").run(error, now(), id);
+}
+/**
+ * Dismiss a curiosity item.
+ */
+export function dismiss(id) {
+    const db = requireDb();
+    db.prepare("UPDATE curiosity_queue SET status = 'dismissed', updated_at = ? WHERE id = ?").run(now(), id);
+}
+/**
+ * Return the count of items per status.
+ */
+export function countByStatus() {
+    const db = requireDb();
+    const rows = db
+        .prepare("SELECT status, COUNT(*) as count FROM curiosity_queue GROUP BY status")
+        .all();
+    const counts = {
+        pending: 0,
+        in_progress: 0,
+        completed: 0,
+        failed: 0,
+        dismissed: 0,
+    };
+    for (const row of rows) {
+        counts[row.status] = row.count;
+    }
+    return counts;
+}
+/**
+ * Remove failed items older than the specified number of days.
+ */
+export function pruneFailed(olderThanDays) {
+    const db = requireDb();
+    const cutoff = new Date(Date.now() - olderThanDays * 86_400_000).toISOString();
+    const result = db
+        .prepare("DELETE FROM curiosity_queue WHERE status = 'failed' AND created_at < ?")
+        .run(cutoff);
+    return result.changes;
+}
+//# sourceMappingURL=index.js.map

package/dist/curiosity/index.js.map

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

package/dist/curiosity/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Curiosity Queue type definitions.
+ */
+/** Valid sources for curiosity items. */
+export type CuriositySource = "observation" | "outcome_gap" | "trend_detection" | "knowledge_gap" | "conversation_insight" | "agent" | "system";
+/** Valid statuses for curiosity items. */
+export type CuriosityStatus = "pending" | "in_progress" | "completed" | "failed" | "dismissed";
+/** A row in the curiosity_queue table. */
+export interface CuriosityItem {
+    id: number;
+    question: string;
+    context: string;
+    source: CuriositySource;
+    priority: number;
+    status: CuriosityStatus;
+    error: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/** Input for adding a new curiosity item. */
+export interface AddCuriosityInput {
+    question: string;
+    context: string;
+    source: CuriositySource;
+    priority: number;
+}
+/** Count of items grouped by status. */
+export type StatusCounts = Record<CuriosityStatus, number>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/curiosity/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yCAAyC;AACzC,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,aAAa,GACb,iBAAiB,GACjB,eAAe,GACf,sBAAsB,GACtB,OAAO,GACP,QAAQ,CAAC;AAEb,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,aAAa,GACb,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC"}

package/dist/curiosity/types.js

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

package/dist/curiosity/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export { initCQ } from "./init.js";
+export type { CQConfig, CQInstance } from "./types.js";
+export { initKnowledgeTree, writeEntry, readEntry, listEntries, listCategories, removeEntry, createCategory, generateIndex, generateIndexRecursive, slugify, } from "./knowledge-tree/index.js";
+export type { KnowledgeEntry, WriteEntryInput, CategoryInfo, KnowledgeFrontmatter, } from "./knowledge-tree/index.js";
+export { initMetadataDb, closeDb, getDb, indexEntry, removeFromIndex, getMetadata, getStaleEntries, } from "./metadata/index.js";
+export type { KnowledgeMetadata } from "./metadata/index.js";
+export { search, rebuildIndex } from "./metadata/search.js";
+export type { SearchResult } from "./metadata/search.js";
+export { initCuriosityQueue, addCuriosity, fetchPending, getItem, markInProgress, markCompleted, markFailed, dismiss, countByStatus, pruneFailed, levenshtein, normalizedSimilarity, isDuplicate, DEDUP_THRESHOLD, } from "./curiosity/index.js";
+export type { CuriosityItem, AddCuriosityInput, CuriositySource, CuriosityStatus, StatusCounts, } from "./curiosity/index.js";
+export { setConfidenceConfig, getConfidenceConfig, getConfidence, recordVerification, recordContradiction, getRefreshCandidates, computeConfidence, daysElapsed, applyContradiction, } from "./confidence/index.js";
+export type { ConfidenceConfig, RefreshCandidate, } from "./confidence/index.js";
+export { createSearchProvider, createModelProvider, OpenAISearchProvider, ClaudeModelProvider, } from "./providers/index.js";
+export type { WebSearchResult, SynthesisResult, SearchProvider, ModelProvider, } from "./providers/index.js";
+export { runPipeline } from "./pipeline/index.js";
+export type { PipelineResult, PipelineOptions, PipelineAction, BudgetCheck, } from "./pipeline/index.js";
+export { vetResource, initResourceTracker, trackResourceUsage, isOverRelied, getDomainUsage, getUnderexploredDomains, getResourceUsage, } from "./vetter/index.js";
+export type { VetResult, VetConfig, QualitySignal, VetRecommendation, ResourceUsage, DomainStats, } from "./vetter/index.js";
+export { initBudgetTables, setBudgetConfig, getBudgetConfig, charge, checkBudget, getDailyBudgetStatus, getTotalBudgetStatus, } from "./budget/index.js";
+export type { BudgetConfig, BudgetCheckResult, BudgetStatus, ChargeType, SelectionStrategy, ScoredEntry, } from "./budget/index.js";
+export { TokenTracker, estimateTokens } from "./budget/index.js";
+export { runOrchestrator, initJobLog, getRecentRuns, } from "./orchestrator/index.js";
+export type { OrchestratorOptions, OrchestratorResult, CuriosityPhaseResult, ProactivePhaseResult, RunLogEntry, SchedulerConfig, } from "./orchestrator/index.js";
+export { startScheduler, stopScheduler, isSchedulerRunning, matchesCron, } from "./orchestrator/scheduler.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,16 @@
+// CQ — Curiosity Queue / Knowledge Loop
+// Main entry point
+export { initCQ } from "./init.js";
+export { initKnowledgeTree, writeEntry, readEntry, listEntries, listCategories, removeEntry, createCategory, generateIndex, generateIndexRecursive, slugify, } from "./knowledge-tree/index.js";
+export { initMetadataDb, closeDb, getDb, indexEntry, removeFromIndex, getMetadata, getStaleEntries, } from "./metadata/index.js";
+export { search, rebuildIndex } from "./metadata/search.js";
+export { initCuriosityQueue, addCuriosity, fetchPending, getItem, markInProgress, markCompleted, markFailed, dismiss, countByStatus, pruneFailed, levenshtein, normalizedSimilarity, isDuplicate, DEDUP_THRESHOLD, } from "./curiosity/index.js";
+export { setConfidenceConfig, getConfidenceConfig, getConfidence, recordVerification, recordContradiction, getRefreshCandidates, computeConfidence, daysElapsed, applyContradiction, } from "./confidence/index.js";
+export { createSearchProvider, createModelProvider, OpenAISearchProvider, ClaudeModelProvider, } from "./providers/index.js";
+export { runPipeline } from "./pipeline/index.js";
+export { vetResource, initResourceTracker, trackResourceUsage, isOverRelied, getDomainUsage, getUnderexploredDomains, getResourceUsage, } from "./vetter/index.js";
+export { initBudgetTables, setBudgetConfig, getBudgetConfig, charge, checkBudget, getDailyBudgetStatus, getTotalBudgetStatus, } from "./budget/index.js";
+export { TokenTracker, estimateTokens } from "./budget/index.js";
+export { runOrchestrator, initJobLog, getRecentRuns, } from "./orchestrator/index.js";
+export { startScheduler, stopScheduler, isSchedulerRunning, matchesCron, } from "./orchestrator/scheduler.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,mBAAmB;AAEnB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,WAAW,EACX,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,OAAO,GACR,MAAM,2BAA2B,CAAC;AASnC,OAAO,EACL,cAAc,EACd,OAAO,EACP,KAAK,EACL,UAAU,EACV,eAAe,EACf,WAAW,EACX,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,cAAc,EACd,aAAa,EACb,UAAU,EACV,OAAO,EACP,aAAa,EACb,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASlD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,MAAM,EACN,WAAW,EACX,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EACL,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,yBAAyB,CAAC;AAWjC,OAAO,EACL,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,6BAA6B,CAAC"}

package/dist/index.test.d.ts

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

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

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

package/dist/index.test.js

@@ -0,0 +1,7 @@
+import { describe, it, expect } from "vitest";
+describe("cq", () => {
+    it("placeholder: package loads", () => {
+        expect(true).toBe(true);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE;IAClB,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CQ Public API — unified initialisation.
+ *
+ * initCQ(config) bootstraps the entire CQ system from a single config object
+ * and returns a CQInstance with access to all subsystems.
+ */
+import type { CQConfig, CQInstance } from "./types.js";
+/**
+ * Initialise the entire CQ system from a single configuration object.
+ *
+ * Opens the SQLite database, creates all required tables, initialises the
+ * knowledge tree directory, and optionally starts the scheduler.
+ *
+ * Call `instance.close()` when done to release all resources.
+ */
+export declare function initCQ(config: CQConfig): Promise<CQInstance>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuFH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMvD;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA6IlE"}

package/dist/init.js

@@ -0,0 +1,153 @@
+/**
+ * CQ Public API — unified initialisation.
+ *
+ * initCQ(config) bootstraps the entire CQ system from a single config object
+ * and returns a CQInstance with access to all subsystems.
+ */
+import { join } from "node:path";
+import { initKnowledgeTree, writeEntry, readEntry, listEntries, listCategories, removeEntry, createCategory, generateIndex, generateIndexRecursive, } from "./knowledge-tree/index.js";
+import { initMetadataDb, closeDb, indexEntry, removeFromIndex, getMetadata, getStaleEntries, } from "./metadata/index.js";
+import { search, rebuildIndex } from "./metadata/search.js";
+import { setConfidenceConfig, getConfidenceConfig, getConfidence, recordVerification, recordContradiction, getRefreshCandidates, } from "./confidence/index.js";
+import { initCuriosityQueue, addCuriosity, fetchPending, getItem, markInProgress, markCompleted, markFailed, dismiss, countByStatus, } from "./curiosity/index.js";
+import { runPipeline } from "./pipeline/index.js";
+import { vetResource, trackResourceUsage, isOverRelied, getDomainUsage, getUnderexploredDomains, getResourceUsage, } from "./vetter/index.js";
+import { initResourceTrackerWithDb } from "./vetter/resource-tracker.js";
+import { initBudgetTables, setBudgetConfig, getBudgetConfig, charge, checkBudget, getDailyBudgetStatus, getTotalBudgetStatus, } from "./budget/index.js";
+import { TokenTracker } from "./budget/token-tracker.js";
+import { runOrchestrator, initJobLog, getRecentRuns, } from "./orchestrator/index.js";
+import { startScheduler, stopScheduler, isSchedulerRunning, } from "./orchestrator/scheduler.js";
+import { createSearchProvider, createModelProvider } from "./providers/index.js";
+// ---------------------------------------------------------------------------
+// initCQ
+// ---------------------------------------------------------------------------
+/**
+ * Initialise the entire CQ system from a single configuration object.
+ *
+ * Opens the SQLite database, creates all required tables, initialises the
+ * knowledge tree directory, and optionally starts the scheduler.
+ *
+ * Call `instance.close()` when done to release all resources.
+ */
+export async function initCQ(config) {
+    const { dataDir } = config;
+    // 1. Initialise knowledge tree directory
+    await initKnowledgeTree(dataDir);
+    // 2. Open SQLite database (metadata store)
+    const dbPath = join(dataDir, "cq.db");
+    const db = initMetadataDb(dbPath);
+    // 3. Initialise subsystem tables
+    initCuriosityQueue(db);
+    initBudgetTables();
+    initResourceTrackerWithDb(db);
+    initJobLog(db);
+    // 4. Apply optional configuration
+    if (config.confidence) {
+        setConfidenceConfig(config.confidence);
+    }
+    if (config.budget) {
+        setBudgetConfig(config.budget);
+    }
+    // 5. Set up providers
+    const searchProvider = config.providers?.search ?? createSearchProvider();
+    const modelProvider = config.providers?.model ?? createModelProvider();
+    // 6. Create token tracker (default 128k budget)
+    const tokenTracker = new TokenTracker(128_000);
+    // 7. Optionally start scheduler
+    if (config.scheduler) {
+        startScheduler({
+            cron: config.scheduler.cron,
+            orchestratorOptions: {
+                db,
+                dataDir,
+                searchProvider,
+                modelProvider,
+            },
+            onComplete: config.scheduler.onComplete,
+            onError: config.scheduler.onError,
+        });
+    }
+    // 8. Build the CQInstance
+    const instance = {
+        knowledge: {
+            initKnowledgeTree,
+            writeEntry,
+            readEntry,
+            listEntries,
+            listCategories,
+            removeEntry,
+            createCategory,
+            generateIndex,
+            generateIndexRecursive,
+        },
+        metadata: {
+            indexEntry,
+            removeFromIndex,
+            getMetadata,
+            getStaleEntries,
+            search,
+            rebuildIndex,
+        },
+        confidence: {
+            setConfidenceConfig,
+            getConfidenceConfig,
+            getConfidence,
+            recordVerification,
+            recordContradiction,
+            getRefreshCandidates,
+        },
+        curiosity: {
+            addCuriosity,
+            fetchPending,
+            getItem,
+            markInProgress,
+            markCompleted,
+            markFailed,
+            dismiss,
+            countByStatus,
+        },
+        pipeline: {
+            runPipeline,
+        },
+        vetter: {
+            vetResource,
+            trackResourceUsage,
+            isOverRelied,
+            getDomainUsage,
+            getUnderexploredDomains,
+            getResourceUsage,
+        },
+        budget: {
+            setBudgetConfig,
+            getBudgetConfig,
+            charge,
+            checkBudget,
+            getDailyBudgetStatus,
+            getTotalBudgetStatus,
+        },
+        tokenTracker,
+        orchestrator: {
+            runOrchestrator,
+            getRecentRuns,
+        },
+        scheduler: {
+            startScheduler,
+            stopScheduler,
+            isSchedulerRunning,
+        },
+        db,
+        dataDir,
+        searchProvider,
+        modelProvider,
+        close() {
+            // Stop scheduler if running
+            if (isSchedulerRunning()) {
+                stopScheduler();
+            }
+            // Close the SQLite database
+            closeDb();
+        },
+    };
+    return instance;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/knowledge-tree/__tests__/knowledge-tree.test.d.ts

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

package/dist/knowledge-tree/__tests__/knowledge-tree.test.d.ts.map

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