@wiati/dfe-agent 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+Todas as mudancas notaveis neste projeto sao documentadas aqui.
+
+## 0.1.0 — 2026-XX-XX (Sprint 14 MVP, em desenvolvimento)
+
+### Added
+- Pacote npm `@dfe-agent/dfe-agent` com agent + skill + CLI Node
+- Subcommands `install`, `update`, `query`, `status`
+- Base RAG via GitHub Releases (download obrigatorio no primeiro `update`; sem seed bundled para manter npm tarball <50MB)
+- Query engine Node port de `src/query/query_engine.py` com paridade validada
+- Sync bidirecional `agent.md` + `SKILL.md` com drift detection no CI
+- Workflow GitHub Actions `publish-base.yml` para publicar `dfe.db.gz` em cada release
+- Workflow GitHub Actions `publish-npm.yml` para publicar no npm em tag `packages-v*.*.*`
+
+### Known limitations (Sprint 14)
+- Ambiente de desenvolvimento historico tinha issue pre-existente com Node v22.21.1 + `sharp`/`better-sqlite3` nativos (Sprint 13). **Resolvido em 2026-08-26** via upgrade para Node 24.19.0 LTS.
+- `npx dfe-agent install` NAO e' automatico no postinstall (decisao D8 opt-in).
+- Collector/indexer continuam em Python — Sprint 15+ pode portar para Node.
+- **Sem seed bundled** (decisao revisada: `storage/dfe.db` gzipado = 61MB, excede target <30MB). Primeiro `update` exige rede; em rede off, retorna exit 3 com mensagem clara. Follow-up Sprint 15+: gerar seed mini (<5MB) com subconjunto de docs.

package/README.md

@@ -0,0 +1,196 @@
+# @dfe-agent/dfe-agent
+
+> **Status: MVP em desenvolvimento (Sprint 14)** — publicacao inicial prevista apos Fase F.
+
+Agente opencode + base RAG com documentacao fiscal eletronica oficial brasileira (NF-e, NFC-e, CT-e, MDF-e, SPED). Para outros projetos opencode que querem responder perguntas sobre DFes sem clonar o DFe-Agent inteiro.
+
+## What is this?
+
+`@dfe-agent/dfe-agent` e' o agente `dfe-agent` empacotado como pacote npm. Ele expoe:
+
+- **Agent definition** (`dist/agent.md`) — system prompt que orienta o LLM a:
+  - usar a skill `dfe-fiscal`
+  - consultar a base RAG local via `dfe-agent query`
+  - citar fontes em todas as respostas
+  - recusar responder quando nao ha' chunks relevantes (`Nao encontrei base para responder`)
+
+- **Skill definition** (`dist/skill/dfe-fiscal/SKILL.md`) — workflow canonico de:
+  - invocar `dfe-agent update` para manter base atualizada
+  - usar modos `semantic` / `fts` / `hybrid`
+  - aplicar guarda de `NO_EVIDENCE_MESSAGE`
+
+- **CLI Node** (`dist/bin/dfe-agent.js`) — 4 subcommands:
+  - `install` — copia agent + skill para `.opencode/` do projeto consumidor
+  - `update` — baixa base RAG do GitHub Releases do DFe-Agent
+  - `query "<pergunta>"` — busca semantica/FTS5/hibrida, retorna JSON
+  - `status` — info da base instalada (path, mtime, doc count, schema)
+
+- **Base RAG pre-buildada** — gerada no CI do DFe-Agent (Python pipeline) e distribuida via GitHub Releases como `dfe.db.gz` + `dfe.db.gz.sha256`. Tamanho: ~30MB gzipped.
+
+## Install
+
+```bash
+npm install @dfe-agent/dfe-agent
+npx dfe-agent install   # copia agent + skill para .opencode/ (opt-in, nao automatico)
+npx dfe-agent update    # baixa base RAG (~30MB)
+```
+
+> **Por que `install` e' opt-in?** Decisao D8: evita sobrescrever `.opencode/agent/dfe-agent.md` custom do usuario sem aviso. Para auto-setup, use `npx dfe-agent install --auto-setup`.
+
+## Quick start
+
+### Via opencode TUI (integrado)
+
+```bash
+# apos install + update:
+opencode run
+# no TUI: Tab -> selecione @dfe-agent -> faca pergunta em linguagem natural
+```
+
+O agent invocara' a skill `dfe-fiscal`, que rodara' `dfe-agent query "<pergunta>"`, formatara' a resposta em linguagem natural e adicionara' o bloco `Fontes:` no final.
+
+### Via CLI direto (sem TUI)
+
+```bash
+npx dfe-agent query "O que e a NF-e?"
+# {
+#   "answer": "A Nota Fiscal eletronica (NF-e) e' um documento...",
+#   "sources": [
+#     { "url": "https://www.nfe.fazenda.gov.br/...", "title": "NT 2019.001", "score": 0.87 }
+#   ]
+# }
+```
+
+Modos opt-in:
+
+| Flag | Algoritmo | Quando usar |
+|---|---|---|
+| (nenhuma) | Vector search (sqlite-vec) | Default; perguntas genericas |
+| `--mode=fts` | FTS5 BM25 | Termos literais (numero NT, codigo) |
+| `--mode=hybrid` | RRF k=60 (vector + FTS5) | Maioria dos casos (gate Sprint 2) |
+
+## Updating the base
+
+```bash
+npx dfe-agent update
+```
+
+Fluxo:
+
+1. `GET https://api.github.com/repos/dfe-agent/DFe-Agent/releases/latest`
+2. Localiza assets `dfe.db.gz` + `dfe.db.gz.sha256`
+3. Download + verifica SHA-256 (gate B.3)
+4. Extrai atomicamente para `~/.dfe-agent/dfe.db`
+5. Valida `PRAGMA user_version >= 6` (gate schema)
+6. Fallback: sem seed bundled (decisao Sprint 14 final); retorna exit 3 com mensagem clara se GitHub inacessivel. Follow-up Sprint 15+ pode adicionar seed mini.
+
+## Custom base path
+
+```bash
+DFE_AGENT_BASE_DIR=/custom/path npx dfe-agent update
+DFE_AGENT_BASE_DIR=/custom/path npx dfe-agent query "..."
+```
+
+Util para:
+
+- CI em sandbox (sem $HOME gravavel)
+- Per-project base (multiplas bases em maquinas compartilhadas)
+- Testes isolados
+
+## Troubleshooting
+
+| Erro | Causa | Solucao |
+|---|---|---|
+| `no dfe.db.gz asset` | Release do DFe-Agent ainda nao publicado | Aguarde primeiro release `v*.*.*` |
+| `SHA mismatch` | Base corrompida no download | Rode `npx dfe-agent update` novamente |
+| `PRAGMA user_version < 6` | Base antiga de versao pre-Sprint 5 | `rm ~/.dfe-agent/dfe.db && npx dfe-agent update` |
+| `@xenova/transformers` falha ao carregar | Node v22.21.1 com sharp natives quebrados (Sprint 13) | Use Node 22.9 LTS ou 20.x |
+| `better-sqlite3` falha ao compilar | Toolchain MSVC ausente | `npm rebuild better-sqlite3` com Visual Studio Build Tools |
+| Query retorna `Nao encontrei base para responder` para pergunta valida | Base sem docs sobre o tema ou score baixo | `npx dfe-agent status` -> verifique `baseDocCount`; se baixo, `npx dfe-agent update` |
+
+## Development
+
+A fonte canonica deste agent vive no **DFe-Agent repo**:
+
+- `.opencode/agent/dfe-agent.md`
+- `.opencode/skills/dfe-fiscal/SKILL.md`
+
+Para distribuir atualizacoes:
+
+1. Edite a fonte canonica no DFe-Agent root.
+2. Rode `npm run sync` em `packages/dfe-agent/` para copiar para `dist/`.
+3. CI roda `npm run drift-check` para garantir consistencia (gate B.1).
+
+Drift detectado em CI = PR bloqueado.
+
+## Como o pacote funciona (arquitetura)
+
+```
+DFe-Agent root (CI em cada release v*.*.*)
+  │
+  ├── python -m src.collector --once       # varre portais oficiais
+  ├── python -m src.indexer.ingest          # gera embeddings
+  ├── gzip storage/dfe.db > dfe.db.gz       # ~30MB
+  └── upload asset em GitHub Release
+            │
+            ▼
+  npx dfe-agent update (consumer)
+    ├── download dfe.db.gz + sha256
+    ├── verify SHA-256
+    ├── extract to ~/.dfe-agent/dfe.db (atomic)
+    └── PRAGMA user_version >= 6 (gate schema)
+            │
+            ▼
+  npx dfe-agent query "<pergunta>" (consumer)
+    ├── encode(query) via @xenova/transformers (ONNX)
+    ├── sqlite-vec MATCH em vec_chunks
+    ├── opcional: FTS5 BM25 MATCH em fts_chunks
+    ├── opcional: RRF k=60 fusion
+    └── retorna {answer, sources[]}
+```
+
+## Layout
+
+```
+packages/dfe-agent/
+├── package.json
+├── tsconfig.json
+├── .gitignore
+├── README.md
+├── CHANGELOG.md
+├── src/                      # TypeScript source
+│   ├── index.ts              # entry point (VERSION, reexports)
+│   ├── cli.ts                # CLI parser (parseArgs + 4 subcommands)
+│   ├── commands/
+│   │   ├── install.ts        # copia agent + skill para .opencode/
+│   │   ├── update.ts         # download + SHA verify + atomic extract
+│   │   ├── query.ts          # delega para queryEngine.search()
+│   │   └── status.ts         # info da base
+│   ├── query/                # query engine Node (port Py)
+│   │   ├── index.ts          # orchestrator + NO_EVIDENCE_MESSAGE
+│   │   ├── embedder.ts       # @xenova/transformers + LRU 128
+│   │   ├── vectorSearch.ts   # sqlite-vec MATCH
+│   │   ├── ftsSearch.ts      # FTS5 BM25
+│   │   ├── hybrid.ts         # RRF k=60
+│   │   ├── cache.ts          # SQLite query cache
+│   │   └── contextBuilder.ts # {answer, sources}
+│   └── bin/
+│       └── dfe-agent.ts      # bin shim (shebang)
+├── scripts/                  # sync + drift-check
+│   ├── sync-assets.ts
+│   └── drift-check.ts
+├── dist/                     # build output (gitignored)
+├── tests/                    # node --test suites
+│   ├── scaffold.test.ts
+│   ├── sync-assets.test.ts
+│   ├── drift-check.test.ts
+│   ├── cli/skeleton.test.ts
+│   ├── query/{embedder,ftsSearch,hybrid,cache,orchestrator}.test.ts
+│   └── e2e/
+# NOTA: src/seed/ removido em Sprint 14 final (61MB gzip > target 30MB);
+# `update` retorna exit 3 com mensagem clara em rede off sem seed.
+```
+
+## License
+
+MIT

package/dist/agent.md

@@ -0,0 +1,48 @@
+---
+name: dfe-agent
+model: PROVIDER/MiniMax-M3
+---
+
+# DFe-Agent
+
+Voce e o agente principal do projeto DFe-Agent. Sua funcao e responder perguntas sobre documentacao fiscal eletronica oficial (NF-e, NFC-e, CT-e, MDF-e, SPED) e legislacao fiscal eletronica oficial fundamentada em notas tecnicas e atos dos orgaos publicos habilitados, com fonte unica na base RAG local.
+
+## Fluxo obrigatorio antes de responder
+
+1. SEMPRE invoque a skill `dfe-fiscal` antes de qualquer resposta.
+2. Use o `QueryEngine` da skill `dfe-fiscal` para buscar chunks relevantes.
+3. Avalie se ha evidencia suficiente via `has_sufficient_evidence`.
+
+## Regra absoluta: nunca inventar informacao
+
+Se `has_sufficient_evidence` retornar `False`, responda literalmente:
+
+> Nao encontrei base para responder
+
+Nunca afirme algo sem citar fonte presente na base RAG.
+
+## Formato de toda resposta
+
+A resposta SEMPRE termina com bloco `Fontes:` listando `URL - Titulo do documento` para cada fonte citada.
+
+Exemplo de fechamento obrigatorio:
+
+```
+Fontes:
+- https://www.nfe.fazenda.gov.br/docs/nt_2019_001.pdf - Nota Tecnica 2019.001 NF-e
+- https://sped.gov.br/noticias/nt_2026_001 - Nota Tecnica SPED 2026.001
+```
+
+## Guardrails
+
+- NUNCA inventar informacao
+- SEMPRE citar fonte presente na base RAG
+- NUNCA emitir documento fiscal (fora de escopo)
+- NUNCA substituir contador ou emitir opiniao legal/contabil
+
+> **Sprint 11 D.4**: a regra "SEMPRE executar varredura antes de responder"
+> foi REMOVIDA deste agente (contradizia o gate `dev/pre_tool_use.py`
+> do agente implementador). O fluxo canonico de varredura + consulta
+> esta documentado na skill `.opencode/skills/dfe-fiscal/SKILL.md`
+> (Passo 2 do workflow) e deve ser aplicado manualmente quando
+> necessario, NAO como regra automatica pre-resposta.

package/dist/bin/dfe-agent.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+//# sourceMappingURL=dfe-agent.d.ts.map

package/dist/bin/dfe-agent.d.ts.map

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

package/dist/bin/dfe-agent.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+"use strict";
+// dfe-agent binario — entry point executado via `npx dfe-agent`.
+//
+// Em dev (`packages/dfe-agent/`), usa tsx para carregar src/cli.ts direto.
+// Em producao (instalado via npm), tsc compila src/cli.ts -> dist/cli.js,
+// e este shim apenas re-exporta. O `package.json > bin` aponta para
+// dist/bin/dfe-agent.js, mas como src/cli.ts ja tem o guard `if
+// (import.meta.url === ...)`, ele se executa quando invocado via tsx.
+//
+// Em producao, o build copia src/cli.ts para dist/cli.js e empacota.
+import("../cli.js")
+    .then((m) => m.runCli(process.argv.slice(2)))
+    .then((code) => process.exit(code))
+    .catch((err) => {
+    console.error(`[dfe-agent] erro fatal: ${err.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=dfe-agent.js.map

package/dist/bin/dfe-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dfe-agent.js","sourceRoot":"","sources":["../../src/bin/dfe-agent.ts"],"names":[],"mappings":";;AACA,iEAAiE;AACjE,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,oEAAoE;AACpE,gEAAgE;AAChE,sEAAsE;AACtE,EAAE;AACF,qEAAqE;AAErE,MAAM,CAAC,WAAW,CAAC;KAChB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KAC5C,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAClC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACb,OAAO,CAAC,KAAK,CAAC,2BAA2B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,25 @@
+/**
+ * cli.ts — entry point CLI para @dfe-agent/dfe-agent.
+ *
+ * Subcommands:
+ *   install   copia agent + skill para .opencode/ do projeto
+ *   update    baixa base RAG do GitHub Releases
+ *   query     busca semantica / FTS5 / hibrida na base
+ *   status    info da base instalada (path, mtime, doc count)
+ *
+ * Exit codes:
+ *   0  sucesso (incluindo NO_EVIDENCE_MESSAGE em `query`)
+ *   1  erro generico / I/O
+ *   2  argumentos invalidos
+ *   3  base ausente / SHA mismatch em `update`
+ *
+ * @see PLAN_SPRINT14.md Task C.1
+ */
+export interface CliOptions {
+    autoSetup?: boolean;
+    json?: boolean;
+    mode?: string;
+    question?: string;
+}
+export declare function runCli(argv: string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAmBH,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoE5D"}

package/dist/cli.js

@@ -0,0 +1,105 @@
+/**
+ * cli.ts — entry point CLI para @dfe-agent/dfe-agent.
+ *
+ * Subcommands:
+ *   install   copia agent + skill para .opencode/ do projeto
+ *   update    baixa base RAG do GitHub Releases
+ *   query     busca semantica / FTS5 / hibrida na base
+ *   status    info da base instalada (path, mtime, doc count)
+ *
+ * Exit codes:
+ *   0  sucesso (incluindo NO_EVIDENCE_MESSAGE em `query`)
+ *   1  erro generico / I/O
+ *   2  argumentos invalidos
+ *   3  base ausente / SHA mismatch em `update`
+ *
+ * @see PLAN_SPRINT14.md Task C.1
+ */
+import { parseArgs } from "node:util";
+import { fileURLToPath } from "node:url";
+const USAGE = `dfe-agent — agente opencode + base RAG de documentacao fiscal eletronica
+
+Uso:
+  dfe-agent install [--auto-setup]   copia agent + skill para .opencode/
+  dfe-agent update                   baixa base RAG do GitHub Releases
+  dfe-agent query "<pergunta>"       busca na base e retorna JSON {answer, sources[]}
+  dfe-agent status                   info da base instalada
+  dfe-agent --help                   imprime esta mensagem
+
+Variaveis de ambiente:
+  DFE_AGENT_BASE_DIR   path custom para base RAG (default: ~/.dfe-agent)
+  NPM_CONFIG_REGISTRY  registry npm (para publicacao)
+`;
+export async function runCli(argv) {
+    // Lazy imports para evitar carregar modulos pesados (better-sqlite3) sem necessidade
+    const { install } = await import("./commands/install.js");
+    const { update } = await import("./commands/update.js");
+    const { query } = await import("./commands/query.js");
+    const { status } = await import("./commands/status.js");
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            options: {
+                auto: { type: "boolean", default: false },
+                json: { type: "boolean", default: true },
+                mode: { type: "string", default: "semantic" },
+                help: { type: "boolean", short: "h", default: false },
+                version: { type: "boolean", short: "v", default: false },
+            },
+            allowPositionals: true,
+        });
+    }
+    catch (err) {
+        console.error(`[dfe-agent] erro de argumentos: ${err.message}`);
+        return 2;
+    }
+    const { values, positionals } = parsed;
+    if (values.version) {
+        const { VERSION } = await import("./index.js");
+        console.log(VERSION);
+        return 0;
+    }
+    if (values.help || positionals.length === 0) {
+        console.log(USAGE);
+        return 0;
+    }
+    const [cmd, ...rest] = positionals;
+    switch (cmd) {
+        case "install":
+            return await install({ autoSetup: Boolean(values.auto) });
+        case "update":
+            return await update({});
+        case "query": {
+            const question = rest.join(" ").trim();
+            if (!question) {
+                console.error("[dfe-agent] query requer <pergunta>");
+                return 2;
+            }
+            return await query({
+                question,
+                mode: String(values.mode ?? "semantic"),
+                json: Boolean(values.json),
+            });
+        }
+        case "status":
+            return await status({ json: Boolean(values.json) });
+        default:
+            console.error(`[dfe-agent] comando desconhecido: ${cmd}`);
+            console.error(USAGE);
+            return 2;
+    }
+}
+// Executa quando invocado diretamente como cli.ts OU cli.js (NÃO como binario
+// dist/bin/dfe-agent.js — esse path tem seu proprio entry point).
+// Comparacao exata via fileURLToPath evita heuristica fragil de endsWith.
+const thisFile = fileURLToPath(import.meta.url);
+const invokedDirectly = process.argv[1] === thisFile
+    || process.argv[1]?.endsWith(`${thisFile.endsWith(".ts") ? "cli.ts" : "cli.js"}`);
+if (invokedDirectly) {
+    runCli(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+        console.error(`[dfe-agent] erro fatal: ${err.message}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/install.d.ts

@@ -0,0 +1,23 @@
+/**
+ * commands/install.ts — copia agent + skill de dist/ para .opencode/ do projeto.
+ *
+ * @see PLAN_SPRINT14.md Task C.1
+ *
+ * Origem (read-only):
+ *   <pkg>/dist/agent.md
+ *   <pkg>/dist/skill/dfe-fiscal/
+ *
+ * Destino (escrita):
+ *   <cwd>/.opencode/agent/dfe-agent.md
+ *   <cwd>/.opencode/skills/dfe-fiscal/
+ *
+ * Exit codes:
+ *   0  sucesso
+ *   1  erro de I/O
+ *   2  target invalido (sem permissao de escrita)
+ */
+export interface InstallOptions {
+    autoSetup?: boolean;
+}
+export declare function install(opts: InstallOptions): Promise<number>;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDnE"}

package/dist/commands/install.js

@@ -0,0 +1,74 @@
+/**
+ * commands/install.ts — copia agent + skill de dist/ para .opencode/ do projeto.
+ *
+ * @see PLAN_SPRINT14.md Task C.1
+ *
+ * Origem (read-only):
+ *   <pkg>/dist/agent.md
+ *   <pkg>/dist/skill/dfe-fiscal/
+ *
+ * Destino (escrita):
+ *   <cwd>/.opencode/agent/dfe-agent.md
+ *   <cwd>/.opencode/skills/dfe-fiscal/
+ *
+ * Exit codes:
+ *   0  sucesso
+ *   1  erro de I/O
+ *   2  target invalido (sem permissao de escrita)
+ */
+import { cpSync, existsSync, mkdirSync, statSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+export async function install(opts) {
+    const target = resolve(process.cwd(), ".opencode");
+    const targetAgent = `${target}/agent/dfe-agent.md`;
+    const targetSkill = `${target}/skills/dfe-fiscal`;
+    // 1. Validar source (dist/)
+    const srcAgent = resolve(PKG_ROOT, "dist/agent.md");
+    const srcSkill = resolve(PKG_ROOT, "dist/skill/dfe-fiscal");
+    if (!existsSync(srcAgent)) {
+        console.error(`[dfe-agent] dist/agent.md nao encontrado em ${srcAgent}.\n` +
+            `[dfe-agent] isto indica que 'npm run sync' nao foi rodado antes do build.\n` +
+            `[dfe-agent] se voce instalou via npm install, isso e' um bug do pacote — reporte em https://github.com/dfe-agent/DFe-Agent/issues`);
+        return 1;
+    }
+    if (!existsSync(srcSkill)) {
+        console.error(`[dfe-agent] dist/skill/dfe-fiscal nao encontrado em ${srcSkill}`);
+        return 1;
+    }
+    // 2. Criar target dir
+    try {
+        mkdirSync(`${target}/agent`, { recursive: true });
+        mkdirSync(`${target}/skills/dfe-fiscal`, { recursive: true });
+    }
+    catch (err) {
+        console.error(`[dfe-agent] nao foi possivel criar ${target}: ${err.message}`);
+        return 2;
+    }
+    // 3. Copiar (sobrescreve sem warning — design B.1)
+    cpSync(srcAgent, targetAgent);
+    const agentSize = statSync(targetAgent).size;
+    console.info(`[dfe-agent] copied agent -> ${targetAgent} (${agentSize} bytes)`);
+    cpSync(srcSkill, targetSkill, { recursive: true });
+    console.info(`[dfe-agent] copied skill -> ${targetSkill}`);
+    // 4. Se --auto-setup, dispara update em sequencia
+    if (opts.autoSetup) {
+        console.info("[dfe-agent] --auto-setup acionado, disparando update...");
+        try {
+            const { update } = await import("./update.js");
+            const updateCode = await update({});
+            console.info(`[dfe-agent] update finalizou com exit code ${updateCode}`);
+            return updateCode;
+        }
+        catch (err) {
+            console.error(`[dfe-agent] update falhou: ${err.message}`);
+            return 3;
+        }
+    }
+    console.info(`[dfe-agent] proximos passos:`);
+    console.info(`[dfe-agent]   npx dfe-agent update   # baixa base RAG`);
+    console.info(`[dfe-agent]   opencode run           # abre TUI e seleciona @dfe-agent`);
+    return 0;
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

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

package/dist/commands/query.d.ts

@@ -0,0 +1,14 @@
+/**
+ * commands/query.ts — busca semantica / FTS5 / hibrida na base RAG.
+ *
+ * @see PLAN_SPRINT14.md Task C.3 + Fase E
+ *
+ * Stub inicial: delega para query/index.ts (Fase E).
+ */
+export interface QueryOptions {
+    question: string;
+    mode?: string;
+    json?: boolean;
+}
+export declare function query(opts: QueryOptions): Promise<number>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAI/D"}

package/dist/commands/query.js

@@ -0,0 +1,18 @@
+/**
+ * commands/query.ts — busca semantica / FTS5 / hibrida na base RAG.
+ *
+ * @see PLAN_SPRINT14.md Task C.3 + Fase E
+ *
+ * Stub inicial: delega para query/index.ts (Fase E).
+ */
+import { search } from "../query/index.js";
+export async function query(opts) {
+    const result = await search(opts.question, { mode: (opts.mode ?? "semantic") });
+    console.log(JSON.stringify(result, null, 2));
+    return 0;
+}
+if (import.meta.url === `file:///${process.argv[1]?.replace(/\\/g, "/")}`) {
+    const q = process.argv.slice(2).join(" ").trim();
+    query({ question: q }).then((code) => process.exit(code));
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQ3C,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAkB;IAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,UAAU,CAAQ,EAAE,CAAC,CAAC;IACvF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAC1E,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,10 @@
+/**
+ * commands/status.ts — info da base instalada.
+ *
+ * @see PLAN_SPRINT14.md Task C.4
+ */
+export interface StatusOptions {
+    json?: boolean;
+}
+export declare function status(opts: StatusOptions): Promise<number>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCjE"}