@wiati/dfe-agent 0.1.0

package/dist/commands/status.js

@@ -0,0 +1,58 @@
+/**
+ * commands/status.ts — info da base instalada.
+ *
+ * @see PLAN_SPRINT14.md Task C.4
+ */
+import { existsSync, statSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { homedir, tmpdir } from "node:os";
+import { fileURLToPath } from "node:url";
+const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+import { VERSION } from "../index.js";
+export async function status(opts) {
+    const baseDir = process.env.DFE_AGENT_BASE_DIR
+        ?? process.env.HOME
+        ?? homedir()
+        ?? tmpdir();
+    const dbPath = resolve(baseDir, "dfe.db");
+    const info = {
+        version: VERSION,
+        packageName: "@wiati/dfe-agent",
+        basePath: dbPath,
+        baseExists: existsSync(dbPath),
+    };
+    if (info.baseExists) {
+        const mtime = statSync(dbPath).mtime;
+        info.baseMtime = mtime.toISOString();
+        info.baseSizeBytes = statSync(dbPath).size;
+        info.baseEmbeddingModel = process.env.DFE_EMBEDDING_MODEL
+            ?? "paraphrase-multilingual-MiniLM-L12-v2";
+        // Best-effort: contar docs (ESM: usa dynamic import; nunca `require`)
+        try {
+            const { default: Database } = await import("better-sqlite3");
+            const handle = new Database(dbPath, { readonly: true });
+            const row = handle.prepare("SELECT COUNT(*) as c FROM documents").get();
+            info.baseDocCount = row.c;
+            const uv = handle.prepare("PRAGMA user_version").get();
+            info.baseSchemaVersion = uv.user_version;
+            handle.close();
+        }
+        catch (err) {
+            info.baseQueryError = err.message;
+        }
+    }
+    else {
+        info.hint = "rode 'dfe-agent update' para baixar a base";
+    }
+    console.log(JSON.stringify(info, null, 2));
+    return 0;
+}
+const invokedDirectly = process.argv[1]?.endsWith("status.ts")
+    || process.argv[1]?.endsWith("status.js");
+if (invokedDirectly) {
+    status({}).then((code) => process.exit(code), (err) => {
+        console.error(`[dfe-agent] erro fatal: ${err.message}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAMtC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAmB;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB;WACzC,OAAO,CAAC,GAAG,CAAC,IAAI;WAChB,OAAO,EAAE;WACT,MAAM,EAAE,CAAC;IACd,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE1C,MAAM,IAAI,GAA4B;QACpC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC;KAC/B,CAAC;IAEF,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;QAC3C,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB;eACpD,uCAAuC,CAAC;QAE7C,sEAAsE;QACtE,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,GAAG,EAAmB,CAAC;YACzF,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC;YAC1B,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAA8B,CAAC;YACnF,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC,YAAY,CAAC;YACzC,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,cAAc,GAAI,GAAa,CAAC,OAAO,CAAC;QAC/C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,IAAI,GAAG,4CAA4C,CAAC;IAC3D,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,eAAe,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC;OACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC5C,IAAI,eAAe,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CACb,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,GAAG,EAAE,EAAE;QACN,OAAO,CAAC,KAAK,CAAC,2BAA4B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/commands/update.d.ts

@@ -0,0 +1,26 @@
+/**
+ * commands/update.ts — baixa base RAG do GitHub Releases e popula ~/.dfe-agent/dfe.db.
+ *
+ * @see PLAN_SPRINT14.md Task C.2
+ *
+ * Fluxo:
+ *   1. fetch GitHub Releases API (latest release em dfe-agent/DFe-Agent)
+ *   2. localizar assets: dfe.db.gz + dfe.db.gz.sha256
+ *   3. download gz + sha256
+ *   4. verificar SHA-256 (gate B.3)
+ *   5. extrair atomicamente para ~/.dfe-agent/dfe.db (ou $DFE_AGENT_BASE_DIR)
+ *   6. validar schema via PRAGMA user_version >= 6
+ *
+ * Fallback: se GitHub inacessivel, usa seed bundled em dist/seed/dfe.db.gz.
+ *
+ * Exit codes:
+ *   0  sucesso
+ *   1  erro generico
+ *   3  SHA mismatch / sem asset / rede off sem seed
+ */
+export interface UpdateOptions {
+    /** Override base path (default: $DFE_AGENT_BASE_DIR ou ~/.dfe-agent). Usado por testes. */
+    baseDirOverride?: string;
+}
+export declare function update(opts: UpdateOptions): Promise<number>;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAsBH,MAAM,WAAW,aAAa;IAC5B,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAsDD,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAqEjE"}

package/dist/commands/update.js

@@ -0,0 +1,144 @@
+/**
+ * commands/update.ts — baixa base RAG do GitHub Releases e popula ~/.dfe-agent/dfe.db.
+ *
+ * @see PLAN_SPRINT14.md Task C.2
+ *
+ * Fluxo:
+ *   1. fetch GitHub Releases API (latest release em dfe-agent/DFe-Agent)
+ *   2. localizar assets: dfe.db.gz + dfe.db.gz.sha256
+ *   3. download gz + sha256
+ *   4. verificar SHA-256 (gate B.3)
+ *   5. extrair atomicamente para ~/.dfe-agent/dfe.db (ou $DFE_AGENT_BASE_DIR)
+ *   6. validar schema via PRAGMA user_version >= 6
+ *
+ * Fallback: se GitHub inacessivel, usa seed bundled em dist/seed/dfe.db.gz.
+ *
+ * Exit codes:
+ *   0  sucesso
+ *   1  erro generico
+ *   3  SHA mismatch / sem asset / rede off sem seed
+ */
+import { createHash } from "node:crypto";
+import { gunzipSync } from "node:zlib";
+import { existsSync, writeFileSync, renameSync, mkdirSync, readFileSync, } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { tmpdir, homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+const GH_REPO = process.env.DFE_AGENT_GH_REPO ?? "dfe-agent/DFe-Agent";
+const GH_API = `https://api.github.com/repos/${GH_REPO}/releases/latest`;
+const ASSET_DB = "dfe.db.gz";
+const ASSET_SHA = "dfe.db.gz.sha256";
+function resolveBaseDir() {
+    return process.env.DFE_AGENT_BASE_DIR
+        ?? process.env.HOME
+        ?? homedir()
+        ?? tmpdir();
+}
+async function fetchJson(url, token) {
+    const headers = {
+        "User-Agent": "dfe-agent-cli/0.1.0",
+        Accept: "application/vnd.github+json",
+    };
+    if (token)
+        headers["Authorization"] = `Bearer ${token}`;
+    const r = await fetch(url, { headers });
+    if (!r.ok)
+        throw new Error(`GitHub API ${r.status} ${r.statusText}`);
+    return r.json();
+}
+async function downloadBuffer(url, token) {
+    const headers = {
+        "User-Agent": "dfe-agent-cli/0.1.0",
+    };
+    if (token)
+        headers["Authorization"] = `Bearer ${token}`;
+    const r = await fetch(url, { headers });
+    if (!r.ok)
+        throw new Error(`download ${url} -> ${r.status}`);
+    return Buffer.from(await r.arrayBuffer());
+}
+function writeAtomic(path, data) {
+    const tmp = `${path}.tmp`;
+    writeFileSync(tmp, data);
+    renameSync(tmp, path);
+}
+function fallbackToSeed(dbPath) {
+    const seedPath = resolve(PKG_ROOT, "dist/seed/dfe.db.gz");
+    if (!existsSync(seedPath)) {
+        console.error(`[dfe-agent] rede off e sem seed bundled em ${seedPath}.\n` +
+            `[dfe-agent] aguarde o proximo release do DFe-Agent ou rode com rede.`);
+        return 3;
+    }
+    console.warn(`[dfe-agent] rede off — usando seed bundled (snapshot antigo)`);
+    const gz = readFileSync(seedPath);
+    const db = gunzipSync(gz);
+    mkdirSync(dirname(dbPath), { recursive: true });
+    writeAtomic(dbPath, db);
+    console.info(`[dfe-agent] base (seed) -> ${dbPath} (${db.length} bytes)`);
+    return 0;
+}
+export async function update(opts) {
+    const baseDir = opts.baseDirOverride ?? resolveBaseDir();
+    const dbPath = resolve(baseDir, "dfe.db");
+    mkdirSync(baseDir, { recursive: true });
+    // 1. fetch release metadata
+    let release;
+    try {
+        release = await fetchJson(GH_API, process.env.GITHUB_TOKEN);
+    }
+    catch (err) {
+        console.warn(`[dfe-agent] GitHub API inacessivel: ${err.message}`);
+        return fallbackToSeed(dbPath);
+    }
+    // 2. localizar assets
+    const dbAsset = release.assets?.find((a) => a.name === ASSET_DB);
+    const shaAsset = release.assets?.find((a) => a.name === ASSET_SHA);
+    if (!dbAsset || !shaAsset) {
+        console.error(`[dfe-agent] release sem assets ${ASSET_DB} / ${ASSET_SHA}`);
+        return 3;
+    }
+    // 3. download
+    let gz;
+    let expectedSha;
+    try {
+        [gz, expectedSha] = await Promise.all([
+            downloadBuffer(dbAsset.browser_download_url, process.env.GITHUB_TOKEN),
+            downloadBuffer(shaAsset.browser_download_url, process.env.GITHUB_TOKEN).then((b) => b.toString().trim()),
+        ]);
+    }
+    catch (err) {
+        console.warn(`[dfe-agent] download falhou: ${err.message}`);
+        return fallbackToSeed(dbPath);
+    }
+    // 4. verify SHA-256
+    const actualSha = createHash("sha256").update(gz).digest("hex");
+    if (actualSha !== expectedSha) {
+        console.error(`[dfe-agent] SHA mismatch: expected ${expectedSha}, got ${actualSha}`);
+        return 3;
+    }
+    // 5. atomic write
+    const db = gunzipSync(gz);
+    writeAtomic(dbPath, db);
+    // 6. validate schema (best-effort)
+    //    Import lazy para nao quebrar quando better-sqlite3 nao compila
+    try {
+        const Database = (await import("better-sqlite3")).default;
+        const sqliteVec = await import("sqlite-vec");
+        const handle = new Database(dbPath, { readonly: true });
+        sqliteVec.load(handle);
+        const uv = handle.prepare("PRAGMA user_version").get();
+        handle.close();
+        if (uv.user_version < 6) {
+            console.error(`[dfe-agent] base com schema antigo (user_version=${uv.user_version} < 6)`);
+            return 3;
+        }
+    }
+    catch (err) {
+        console.warn(`[dfe-agent] nao foi possivel validar schema: ${err.message}`);
+        // nao falha o update — arquivo ja foi escrito com SHA valido
+    }
+    console.info(`[dfe-agent] base atualizada: ${dbPath} (${db.length} bytes, sha=${actualSha.slice(0, 16)}...)`);
+    return 0;
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export declare const VERSION = "0.1.0";
+export declare const PACKAGE_NAME = "@wiati/dfe-agent";
+export { runCli } from "./cli.js";
+export { search } from "./query/index.js";
+export { NO_EVIDENCE_MESSAGE } from "./query/index.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":"AAGA,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,YAAY,qBAAqB,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// @dfe-agent/dfe-agent — entry point
+// Documentado em PLAN_SPRINT14.md Task A.1 (Sprint 14)
+export const VERSION = "0.1.0";
+export const PACKAGE_NAME = "@wiati/dfe-agent";
+export { runCli } from "./cli.js";
+export { search } from "./query/index.js";
+export { NO_EVIDENCE_MESSAGE } from "./query/index.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,qCAAqC;AACrC,uDAAuD;AAEvD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/query/cache.d.ts

@@ -0,0 +1,38 @@
+/**
+ * cache.ts — cache SQLite de embeddings de query.
+ *
+ * @see PLAN_SPRINT14.md Task E.4 + Sprint 13 I13.2 (QueryEmbeddingCache)
+ *
+ * Persiste em `<baseDir>/cache.db`. Chave = sha256(model|mode|q_normalized).
+ *
+ * HIT na 2a chamada idêntica (mesmo modelo + mesmo mode + mesma query
+ * normalizada) NAO invoca o embedder. Gate Sprint 13 + canonico em
+ * src/query/embedding_cache.py.
+ */
+import type { Database as BetterSqlite3Database } from "better-sqlite3";
+export declare const QUERY_CACHE_SCHEMA = "\n  CREATE TABLE IF NOT EXISTS query_cache (\n    query_hash   TEXT PRIMARY KEY,\n    embedding    BLOB NOT NULL,\n    model        TEXT NOT NULL,\n    mode         TEXT NOT NULL,\n    created_at   TEXT NOT NULL DEFAULT (datetime('now'))\n  )\n";
+export interface QueryCacheOptions {
+    model?: string;
+}
+export declare class QueryCache {
+    private readonly model;
+    private readonly handle;
+    constructor(handle: BetterSqlite3Database, opts?: QueryCacheOptions);
+    /**
+     * Busca embedding em cache. Retorna null em miss.
+     */
+    get(mode: string, question: string): Float32Array | null;
+    /**
+     * Persiste embedding. INSERT OR REPLACE para idempotencia.
+     */
+    set(mode: string, question: string, embedding: Float32Array): void;
+    /**
+     * Limpa cache (util apos troca de modelo).
+     */
+    clear(): void;
+    /**
+     * Estatisticas: numero de entradas.
+     */
+    size(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/query/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAExE,eAAO,MAAM,kBAAkB,yPAQ9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,MAAM,EAAE,qBAAqB,EAAE,IAAI,GAAE,iBAAsB;IAQvE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAUxD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI;IAWlE;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;CAMf"}

package/dist/query/cache.js

@@ -0,0 +1,80 @@
+/**
+ * cache.ts — cache SQLite de embeddings de query.
+ *
+ * @see PLAN_SPRINT14.md Task E.4 + Sprint 13 I13.2 (QueryEmbeddingCache)
+ *
+ * Persiste em `<baseDir>/cache.db`. Chave = sha256(model|mode|q_normalized).
+ *
+ * HIT na 2a chamada idêntica (mesmo modelo + mesmo mode + mesma query
+ * normalizada) NAO invoca o embedder. Gate Sprint 13 + canonico em
+ * src/query/embedding_cache.py.
+ */
+import { createHash } from "node:crypto";
+export const QUERY_CACHE_SCHEMA = `
+  CREATE TABLE IF NOT EXISTS query_cache (
+    query_hash   TEXT PRIMARY KEY,
+    embedding    BLOB NOT NULL,
+    model        TEXT NOT NULL,
+    mode         TEXT NOT NULL,
+    created_at   TEXT NOT NULL DEFAULT (datetime('now'))
+  )
+`;
+function normalizeQuery(q) {
+    return q.trim().toLowerCase();
+}
+function hashKey(model, mode, q) {
+    return createHash("sha256")
+        .update(`${model}|${mode}|${normalizeQuery(q)}`)
+        .digest("hex");
+}
+export class QueryCache {
+    model;
+    handle;
+    constructor(handle, opts = {}) {
+        this.handle = handle;
+        this.model = opts.model
+            ?? process.env.DFE_EMBEDDING_MODEL
+            ?? "paraphrase-multilingual-MiniLM-L12-v2";
+        handle.exec(QUERY_CACHE_SCHEMA);
+    }
+    /**
+     * Busca embedding em cache. Retorna null em miss.
+     */
+    get(mode, question) {
+        const key = hashKey(this.model, mode, question);
+        const row = this.handle
+            .prepare("SELECT embedding FROM query_cache WHERE query_hash = ?")
+            .get(key);
+        if (!row)
+            return null;
+        const buf = row.embedding;
+        return new Float32Array(buf.buffer, buf.byteOffset, buf.byteLength / 4);
+    }
+    /**
+     * Persiste embedding. INSERT OR REPLACE para idempotencia.
+     */
+    set(mode, question, embedding) {
+        const key = hashKey(this.model, mode, question);
+        const buf = Buffer.from(embedding.buffer);
+        this.handle
+            .prepare(`INSERT OR REPLACE INTO query_cache (query_hash, embedding, model, mode)
+         VALUES (?, ?, ?, ?)`)
+            .run(key, buf, this.model, mode);
+    }
+    /**
+     * Limpa cache (util apos troca de modelo).
+     */
+    clear() {
+        this.handle.exec("DELETE FROM query_cache");
+    }
+    /**
+     * Estatisticas: numero de entradas.
+     */
+    size() {
+        const row = this.handle
+            .prepare("SELECT COUNT(*) AS c FROM query_cache")
+            .get();
+        return row.c;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/query/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/query/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;CAQjC,CAAC;AAMF,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,OAAO,CAAC,KAAa,EAAE,IAAY,EAAE,CAAS;IACrD,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,OAAO,UAAU;IACJ,KAAK,CAAS;IACd,MAAM,CAAwB;IAE/C,YAAY,MAA6B,EAAE,OAA0B,EAAE;QACrE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;eAClB,OAAO,CAAC,GAAG,CAAC,mBAAmB;eAC/B,uCAAuC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY,EAAE,QAAgB;QAChC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM;aACpB,OAAO,CAAC,wDAAwD,CAAC;aACjE,GAAG,CAAC,GAAG,CAAsC,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC;QAC1B,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAE,SAAuB;QACzD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM;aACR,OAAO,CACN;6BACqB,CACtB;aACA,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,IAAI;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM;aACpB,OAAO,CAAC,uCAAuC,CAAC;aAChD,GAAG,EAAmB,CAAC;QAC1B,OAAO,GAAG,CAAC,CAAC,CAAC;IACf,CAAC;CACF"}

package/dist/query/constants.d.ts

@@ -0,0 +1,20 @@
+/**
+ * constants.ts — constantes canonicas do query engine.
+ *
+ * Separado de index.ts para evitar ciclos de import com contextBuilder.
+ *
+ * NO_EVIDENCE_MESSAGE: string canonica que sinaliza ausencia de chunks.
+ *   - Gate dfe-rules.md #4 + convencoes-gerais.md
+ *   - NUNCA duplique este literal
+ *   - Espelha `src/query/context_builder.py` no Py
+ *
+ * SUPPORTED_MODES: union type dos modos de busca opt-in.
+ */
+export declare const NO_EVIDENCE_MESSAGE = "Nao encontrei base para responder";
+export declare const SUPPORTED_MODES: readonly ["semantic", "fts", "hybrid"];
+export type SearchMode = (typeof SUPPORTED_MODES)[number];
+export declare const DEFAULT_TOP_K = 5;
+export declare const MIN_RELEVANCE_SCORE = 0.5;
+export declare const RECENCY_WEIGHT = 0.3;
+export declare const RECENCY_HALF_LIFE_DAYS = 180;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/query/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,mBAAmB,sCAAsC,CAAC;AAEvE,eAAO,MAAM,eAAe,wCAAyC,CAAC;AACtE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAG1D,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,sBAAsB,MAAQ,CAAC"}

package/dist/query/constants.js

@@ -0,0 +1,20 @@
+/**
+ * constants.ts — constantes canonicas do query engine.
+ *
+ * Separado de index.ts para evitar ciclos de import com contextBuilder.
+ *
+ * NO_EVIDENCE_MESSAGE: string canonica que sinaliza ausencia de chunks.
+ *   - Gate dfe-rules.md #4 + convencoes-gerais.md
+ *   - NUNCA duplique este literal
+ *   - Espelha `src/query/context_builder.py` no Py
+ *
+ * SUPPORTED_MODES: union type dos modos de busca opt-in.
+ */
+export const NO_EVIDENCE_MESSAGE = "Nao encontrei base para responder";
+export const SUPPORTED_MODES = ["semantic", "fts", "hybrid"];
+// Defaults alinhados com src/query/constants.py (gate paridade Py ↔Node)
+export const DEFAULT_TOP_K = 5;
+export const MIN_RELEVANCE_SCORE = 0.5;
+export const RECENCY_WEIGHT = 0.3;
+export const RECENCY_HALF_LIFE_DAYS = 180.0;
+//# sourceMappingURL=constants.js.map

package/dist/query/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/query/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,mCAAmC,CAAC;AAEvE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAGtE,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC"}

package/dist/query/contextBuilder.d.ts

@@ -0,0 +1,40 @@
+/**
+ * contextBuilder.ts — monta o contexto final (answer + sources).
+ *
+ * @see PLAN_SPRINT14.md Task E.5
+ *
+ * Constante NO_EVIDENCE_MESSAGE canonica em `src/query/index.ts` (mesma
+ * string em src/query/context_builder.py do Py). NUNCA duplique o literal
+ * em outro arquivo — gate dfe-rules.md #4 + convencoes-gerais.md.
+ */
+import type { Source } from "./index.js";
+export interface HydratedChunk {
+    chunk_id: number;
+    doc_id: number;
+    text: string;
+    url: string;
+    title: string;
+    score: number;
+    published_at?: string | null;
+}
+export interface ContextResult {
+    answer: string;
+    sources: Source[];
+}
+/**
+ * Heuristica de evidencia suficiente (gate dfe-rules.md #4 + paridade Py).
+ *
+ * Convencao Py (`src/query/context_builder.py:60-71`): olhamos apenas o
+ * PRIMEIRO chunk (mais relevante no ranking). Se ele nao atinge o minimo,
+ * qualquer outro posterior tera score menor.
+ *
+ * Antes da Sprint 14.1, Node usava `Math.max(...)` que retornava True em
+ * cenarios com 1 chunk bom + N chunks ruins, divergindo do Py. Corrigido
+ * para paridade.
+ */
+export declare function hasSufficientEvidence(chunks: HydratedChunk[]): boolean;
+/**
+ * Constroi o contexto final: dedup por URL, ordena por score, monta answer.
+ */
+export declare function buildContext(chunks: HydratedChunk[]): ContextResult;
+//# sourceMappingURL=contextBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextBuilder.d.ts","sourceRoot":"","sources":["../../src/query/contextBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAGtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,CA4BnE"}

package/dist/query/contextBuilder.js

@@ -0,0 +1,54 @@
+/**
+ * contextBuilder.ts — monta o contexto final (answer + sources).
+ *
+ * @see PLAN_SPRINT14.md Task E.5
+ *
+ * Constante NO_EVIDENCE_MESSAGE canonica em `src/query/index.ts` (mesma
+ * string em src/query/context_builder.py do Py). NUNCA duplique o literal
+ * em outro arquivo — gate dfe-rules.md #4 + convencoes-gerais.md.
+ */
+import { NO_EVIDENCE_MESSAGE, MIN_RELEVANCE_SCORE } from "./constants.js";
+/**
+ * Heuristica de evidencia suficiente (gate dfe-rules.md #4 + paridade Py).
+ *
+ * Convencao Py (`src/query/context_builder.py:60-71`): olhamos apenas o
+ * PRIMEIRO chunk (mais relevante no ranking). Se ele nao atinge o minimo,
+ * qualquer outro posterior tera score menor.
+ *
+ * Antes da Sprint 14.1, Node usava `Math.max(...)` que retornava True em
+ * cenarios com 1 chunk bom + N chunks ruins, divergindo do Py. Corrigido
+ * para paridade.
+ */
+export function hasSufficientEvidence(chunks) {
+    if (chunks.length === 0)
+        return false;
+    return chunks[0].score >= MIN_RELEVANCE_SCORE;
+}
+/**
+ * Constroi o contexto final: dedup por URL, ordena por score, monta answer.
+ */
+export function buildContext(chunks) {
+    if (!hasSufficientEvidence(chunks)) {
+        return {
+            answer: NO_EVIDENCE_MESSAGE,
+            sources: [],
+        };
+    }
+    // Dedup por URL (preferir chunk com maior score)
+    const byUrl = new Map();
+    for (const c of chunks) {
+        const existing = byUrl.get(c.url);
+        if (!existing || c.score > existing.score) {
+            byUrl.set(c.url, c);
+        }
+    }
+    const sorted = Array.from(byUrl.values()).sort((a, b) => b.score - a.score);
+    const sources = sorted.map((c) => ({
+        url: c.url,
+        title: c.title,
+        score: c.score,
+    }));
+    const answer = sorted.map((c) => c.text).join("\n\n---\n\n");
+    return { answer, sources };
+}
+//# sourceMappingURL=contextBuilder.js.map

package/dist/query/contextBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextBuilder.js","sourceRoot":"","sources":["../../src/query/contextBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAkB1E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,mBAAmB,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAuB;IAClD,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,MAAM,EAAE,mBAAmB;YAC3B,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC1C,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE5E,MAAM,OAAO,GAAa,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,KAAK;KACf,CAAC,CAAC,CAAC;IAEJ,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE7D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/query/embedder.d.ts

@@ -0,0 +1,30 @@
+/**
+ * embedder.ts — wrapper de @xenova/transformers com LRU cache em memoria.
+ *
+ * @see PLAN_SPRINT14.md Task E.1
+ *
+ * Decisao D6: modelo canonico e `paraphrase-multilingual-MiniLM-L12-v2`
+ * (mesmo do DFe-Agent Py via sentence-transformers). Drift entre Py e Node
+ * deve ser < 0.01 (gate D.7 validado por tests/integration/test_embedding_parity).
+ *
+ * LRU 128: cobre uso interativo; descarta entradas mais antigas.
+ */
+export declare const EMBEDDING_MODEL_NAME = "Xenova/paraphrase-multilingual-MiniLM-L12-v2";
+export declare const EMBEDDING_DIMENSION = 384;
+export interface EmbeddingCacheEntry {
+    vec: Float32Array;
+    hash: string;
+}
+/**
+ * Codifica `text` em vetor 384-d (cosine-normalized).
+ *
+ * Cache LRU: 2a chamada com mesmo texto retorna o mesmo Float32Array sem
+ * nova inferencia.
+ *
+ * @throws se o modelo nao conseguir carregar (problema conhecido: Node
+ *         v22.21.1 com sharp/better-sqlite3 nativos; ver Sprint 13).
+ */
+export declare function encode(text: string): Promise<Float32Array>;
+export declare function clearCache(): void;
+export declare function cacheSize(): number;
+//# sourceMappingURL=embedder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../../src/query/embedder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,eAAO,MAAM,oBAAoB,iDAAa,CAAC;AAC/C,eAAO,MAAM,mBAAmB,MAAgB,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,YAAY,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAoBD;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBhE;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC"}