dd-harness-mcp 0.1.0 → 0.1.2

package/dist/cli/src/argv.js

@@ -0,0 +1,27 @@
+/**
+ * Leitura de argumentos da linha de comando.
+ *
+ * Vive fora do `index.ts` porque aquele modulo executa o CLI ao ser importado
+ * (`principal()` no topo) — teste que o importasse rodaria o programa inteiro.
+ */
+/**
+ * Os termos livres de uma consulta, sem os pares `--flag valor`.
+ *
+ * Filtrar so o que comeca com `--` deixava o VALOR da flag para tras, e ele entrava na
+ * consulta: `buscar "efeito" --limite 2` virava a pergunta `"efeito 2"`. A busca roda, a
+ * resposta parece valida e responde a outra coisa — quem chamou nao tem como notar.
+ */
+export function termosDaConsulta(argv) {
+    const termos = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const atual = argv[i];
+        if (atual.startsWith("--")) {
+            // `--flag=valor` carrega o valor no proprio token; `--flag valor` consome o proximo.
+            if (!atual.includes("="))
+                i += 1;
+            continue;
+        }
+        termos.push(atual);
+    }
+    return termos.join(" ").trim();
+}

package/dist/cli/src/check.js

@@ -72,6 +72,7 @@ export async function status(raiz) {
         vencidas: ativas
             .filter((m) => m.revisar_ate && new Date(m.revisar_ate).getTime() < agora)
             .map((m) => ({ pasta: m.pasta, memoria: m.slug, titulo: m.titulo })),
+        travadasNaFila: brain.travadas_na_fila ?? 0,
     };
 }
 export async function check(raiz, commit) {

package/dist/cli/src/diff.js

@@ -30,6 +30,11 @@ export async function caminhosDoCommit(raiz, commit) {
 /**
  * Cruza caminhos com ancoras. A ancora casa quando e o proprio caminho ou quando e um
  * diretorio que o contem — `supabase/migrations` tem que casar com a migration nova.
+ *
+ * Ancora de trecho (`arquivo.js#alvo`) casa pelo ARQUIVO: o `git diff-tree` devolve
+ * caminho puro, nunca com `#`, entao comparar o valor inteiro nao casava nunca — e em
+ * silencio, porque nao casar e resultado valido. O alvo continua no `Tocada.ancora`, que
+ * e o que a mensagem mostra: quem le precisa saber qual trecho a memoria guarda.
  */
 export function memoriasTocadas(brain, caminhos) {
     const tocadas = [];
@@ -37,7 +42,8 @@ export function memoriasTocadas(brain, caminhos) {
         if (memoria.status !== "ativa")
             continue;
         for (const ancora of memoria.ancoras) {
-            const casa = caminhos.some((c) => c === ancora.valor || c.startsWith(`${ancora.valor}/`));
+            const alvo = ancora.valor.split("#")[0];
+            const casa = caminhos.some((c) => c === alvo || c.startsWith(`${alvo}/`));
             if (casa) {
                 tocadas.push({
                     pasta: memoria.pasta,

package/dist/cli/src/gravar.js

@@ -46,9 +46,18 @@ export function interpreta(texto) {
             throw new Error(`frontmatter sem \`${chave}\`.`);
     }
     // O corpo vai ate a secao dos filtros; dali para baixo e metadado, nao conteudo.
-    const corte = resto.search(/\n##\s+Os tr[êe]s filtros\s*\n/i);
-    if (corte === -1)
+    const cabecalhoDosFiltros = /\n##\s+Os tr[êe]s filtros\s*\n/gi;
+    const ocorrencias = [...resto.matchAll(cabecalhoDosFiltros)];
+    if (ocorrencias.length === 0)
         throw new Error("falta a seção `## Os três filtros`.");
+    // Duas ocorrencias tornam o arquivo ambiguo: cortar na primeira trunca o corpo (e os
+    // filtros ainda saem certos da segunda, entao grava e perde dado sem avisar), e cortar
+    // na ultima escolheria em silencio qual secao e a de verdade. Recusar diz o que houve.
+    if (ocorrencias.length > 1) {
+        throw new Error("a seção `## Os três filtros` aparece mais de uma vez — deixe só a real, " +
+            "ou reescreva a citação no corpo (por exemplo, entre crases).");
+    }
+    const corte = ocorrencias[0].index;
     const corpo = resto
         .slice(0, corte)
         .replace(/<!--[\s\S]*?-->/g, "")

package/dist/cli/src/index.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
+import { termosDaConsulta } from "./argv.js";
 import { check, status } from "./check.js";
 import { leConfigDoRepo, guardaToken } from "./config.js";
 import { grava } from "./gravar.js";
 import { init, SUGESTAO_MCP } from "./init.js";
 import { LINHA_DE_IMPORT } from "./materializa.js";
+import { buscaPolitica } from "./politica.js";
 import { busca } from "./buscar.js";
 import { arquiva, edita } from "./curar.js";
 import { criaPasta } from "./pasta.js";
@@ -36,6 +38,9 @@ const AJUDA = `dd-harness — materializa política, briefing e Brain no reposit
   dd-harness sync                    escreve os artefatos em disco
   dd-harness check [--commit <sha>]  mede as âncoras e reporta a deriva
   dd-harness status                  só lê: o tamanho do Brain e o que espera julgamento
+  dd-harness politica                imprime a política do serviço (para o hook de sessão)
+                                     saída 0 = veio; 3 = projeto sem política;
+                                     1 = não consegui buscar
   dd-harness --help
 
 O gerado vive em dd-harness/. Na raiz fica só o seu CLAUDE.md, que importa a
@@ -164,7 +169,7 @@ async function comandoArquivar(argv) {
     console.log("  foi para o histórico, não foi apagada. Rode `dd-harness sync`.");
 }
 async function comandoBuscar(argv) {
-    const consulta = argv.filter((a) => !a.startsWith("--")).join(" ").trim();
+    const consulta = termosDaConsulta(argv);
     if (!consulta)
         throw new Error('uso: dd-harness buscar "<pergunta>"');
     const limite = Number(argumento(argv, "limite")) || undefined;
@@ -261,6 +266,27 @@ async function comandoCheck(argv) {
         }
     }
 }
+/**
+ * Imprime a politica no stdout, para o hook `SessionStart` injetar no contexto.
+ *
+ * Os codigos de saida sao o contrato com o hook, e existem para separar duas coisas que
+ * um "falhou" generico colapsaria: projeto novo (que precisa de briefing) de politica
+ * inalcancavel (que precisa PARAR a sessao). Mudar estes numeros quebra o hook.
+ */
+async function comandoPolitica() {
+    const r = await buscaPolitica(process.cwd());
+    if (r.estado === "ok") {
+        console.log(r.conteudo);
+        return;
+    }
+    if (r.estado === "sem-politica") {
+        console.error("Este projeto ainda não tem política — nunca foi briefado. Rode `/briefar`.");
+        process.exitCode = 3;
+        return;
+    }
+    console.error(`não consegui buscar a política: ${r.motivo}`);
+    process.exitCode = 1;
+}
 async function comandoStatus() {
     const r = await status(process.cwd());
     // O acervo vem primeiro, e sempre: e a resposta para "o que ha no Brain deste projeto?",
@@ -276,6 +302,14 @@ async function comandoStatus() {
             (arquivadas ? ` e ${arquivadas} arquivada(s)` : "") +
             (detalhe ? ` — ${detalhe}` : ""));
     }
+    // Antes do early return abaixo: fila travada nao e "julgamento esperando", e sumiria
+    // justamente na sessao mais comum — a que nao tem deriva nem vencida.
+    if (r.travadasNaFila > 0) {
+        console.log("");
+        console.log(`AVISO: ${r.travadasNaFila} memória(s) desistiram de ser indexadas e não entram na busca semântica.`);
+        console.log("  O indexador tentou 5 vezes e parou. Rode `pnpm worker --reindexar`;");
+        console.log("  se repetir, o motivo está em `embedding_queue.ultimo_erro`.");
+    }
     if (!r.comDeriva.length && !r.vencidas.length) {
         console.log("Nada esperando julgamento.");
         return;
@@ -366,6 +400,8 @@ async function principal() {
             return comandoCheck(resto);
         case "status":
             return comandoStatus();
+        case "politica":
+            return comandoPolitica();
         case "--help":
         case "-h":
         case undefined:

package/dist/cli/src/politica.js

@@ -0,0 +1,35 @@
+import { cabecalhos, credencial, pede } from "./api.js";
+export async function buscaPolitica(raiz) {
+    let config;
+    try {
+        config = await credencial(raiz);
+    }
+    catch (erro) {
+        // Sem `.dd-harness.json` ou sem token nao da para nem perguntar. E inalcancavel, nao
+        // "sem politica": a politica pode muito bem existir do outro lado.
+        return { estado: "inalcancavel", motivo: mensagem(erro) };
+    }
+    const url = new URL(`${config.config.api}/api/v1/artefatos`);
+    url.searchParams.set("tenant", config.config.tenant);
+    url.searchParams.set("projeto", config.config.projeto);
+    try {
+        const resposta = await pede(url, { headers: cabecalhos(config.token) });
+        if (!resposta.ok) {
+            const { erro } = (await resposta.json().catch(() => ({})));
+            return {
+                estado: "inalcancavel",
+                motivo: erro ?? `a API respondeu ${resposta.status}.`,
+            };
+        }
+        const payload = (await resposta.json());
+        const conteudo = payload.politica?.trim();
+        // Vazio e nulo sao a mesma coisa aqui, e os dois significam "nunca foi escrita".
+        if (!conteudo)
+            return { estado: "sem-politica" };
+        return { estado: "ok", conteudo };
+    }
+    catch (erro) {
+        return { estado: "inalcancavel", motivo: mensagem(erro) };
+    }
+}
+const mensagem = (erro) => erro instanceof Error ? erro.message : String(erro);

package/package.json

@@ -1,41 +1,40 @@
-{
-  "name": "dd-harness-mcp",
-  "version": "0.1.0",
-  "type": "module",
-  "description": "Servidor MCP do dd-harness: o agente consulta e grava memoria como ferramenta, sem passar por arquivo.",
-  "license": "UNLICENSED",
-  "author": "Diego Dias",
-  "keywords": [
-    "claude-code",
-    "mcp",
-    "model-context-protocol",
-    "ai-agents",
-    "memory"
-  ],
-  "homepage": "https://dd-harness.vercel.app",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/diegodias93/dd-harness-online.git",
-    "directory": "packages/mcp"
-  },
-  "//bin": "`dist/mcp/src/` e nao `dist/` porque o build abrange dois diretorios (este pacote e o fonte do CLI), e o `rootDir` comum e `packages/`. Conferir com `node dist/mcp/src/index.js` antes de publicar: caminho errado aqui instala e quebra no primeiro uso.",
-  "bin": {
-    "dd-harness-mcp": "dist/mcp/src/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/server": "^2.0.0",
-    "dd-harness": "workspace:*",
-    "zod": "^4.5.4"
-  },
-  "scripts": {
-    "typecheck": "tsc -p . --noEmit",
-    "build": "tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run build"
-  }
-}
+{
+  "name": "dd-harness-mcp",
+  "version": "0.1.2",
+  "type": "module",
+  "description": "Servidor MCP do dd-harness: o agente consulta e grava memoria como ferramenta, sem passar por arquivo.",
+  "license": "UNLICENSED",
+  "author": "Diego Dias",
+  "keywords": [
+    "claude-code",
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "memory"
+  ],
+  "homepage": "https://dd-harness.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/diegodias93/dd-harness-online.git",
+    "directory": "packages/mcp"
+  },
+  "//bin": "`dist/mcp/src/` e nao `dist/` porque o build abrange dois diretorios (este pacote e o fonte do CLI), e o `rootDir` comum e `packages/`. Conferir com `node dist/mcp/src/index.js` antes de publicar: caminho errado aqui instala e quebra no primeiro uso.",
+  "bin": {
+    "dd-harness-mcp": "dist/mcp/src/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
+    "zod": "^4.5.4"
+  },
+  "scripts": {
+    "typecheck": "tsc -p . --noEmit",
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  }
+}