dd-harness 0.1.0 → 0.1.1

package/dist/check.js

@@ -72,7 +72,7 @@ export async function check(raiz, commit) {
         ? memoriasTocadas(brain, await caminhosDoCommit(raiz, commit))
         : [];
     if (medicoes.length === 0) {
-        return { medidas: 0, ausentes: [], novas: 0, base: 0, jaAbertas: 0, tocadas };
+        return { medidas: 0, ausentes: [], novas: 0, base: 0, jaAbertas: 0, fechadas: 0, tocadas };
     }
     const envio = await fetch(`${config.api}/api/v1/deriva`, {
         method: "POST",
@@ -97,6 +97,7 @@ export async function check(raiz, commit) {
         novas: julgamento.novas,
         base: julgamento.base,
         jaAbertas: julgamento.ja_abertas,
+        fechadas: julgamento.fechadas ?? 0,
         tocadas,
     };
 }

package/dist/gravar.js

@@ -0,0 +1,111 @@
+import { readFile } from "node:fs/promises";
+import { leConfigDoRepo, leToken } from "./config.js";
+const OBRIGATORIOS = ["name", "titulo", "description", "pasta"];
+/** Frontmatter simples: `chave: valor` por linha. Sem lib de YAML — nao ha aninhamento. */
+function leFrontmatter(texto) {
+    const linhas = texto.replace(/\r\n/g, "\n").split("\n");
+    if (linhas[0]?.trim() !== "---") {
+        throw new Error("o arquivo precisa começar com `---` e um frontmatter.");
+    }
+    const fim = linhas.indexOf("---", 1);
+    if (fim === -1)
+        throw new Error("frontmatter sem `---` de fechamento.");
+    const campos = new Map();
+    for (const linha of linhas.slice(1, fim)) {
+        const corte = linha.indexOf(":");
+        if (corte === -1)
+            continue;
+        campos.set(linha.slice(0, corte).trim(), linha.slice(corte + 1).trim());
+    }
+    return { campos, resto: linhas.slice(fim + 1).join("\n") };
+}
+/** `**Dano:** texto` — devolve o texto, sem o rotulo. */
+function filtro(corpo, rotulo) {
+    const achado = corpo.match(new RegExp(`\\*\\*${rotulo}:\\*\\*\\s*([\\s\\S]*?)(?=\\n\\s*\\n\\*\\*|\\n## |$)`, "i"));
+    const valor = achado?.[1]?.trim() ?? "";
+    if (!valor)
+        throw new Error(`falta o filtro **${rotulo}:** no arquivo.`);
+    return valor;
+}
+/** Itens de lista da secao de ancoras, com ou sem crase em volta. */
+function ancorasDe(texto) {
+    const secao = texto.split(/\n##\s+[ÂA]ncoras\s*\n/i)[1];
+    if (!secao)
+        return [];
+    return secao
+        .split("\n")
+        .map((l) => l.match(/^\s*[-*]\s+(.+?)\s*$/)?.[1])
+        .filter((v) => Boolean(v))
+        .map((v) => v.replace(/^`|`$/g, "").trim())
+        .filter(Boolean);
+}
+export function interpreta(texto) {
+    const { campos, resto } = leFrontmatter(texto);
+    for (const chave of OBRIGATORIOS) {
+        if (!campos.get(chave))
+            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)
+        throw new Error("falta a seção `## Os três filtros`.");
+    const corpo = resto
+        .slice(0, corte)
+        .replace(/<!--[\s\S]*?-->/g, "")
+        .trim();
+    if (!corpo)
+        throw new Error("o corpo da memória está vazio.");
+    const cauda = resto.slice(corte);
+    const tambem = campos.get("projetos") ?? "";
+    return {
+        slug: campos.get("name"),
+        titulo: campos.get("titulo"),
+        resumo: campos.get("description"),
+        pasta: campos.get("pasta"),
+        corpo,
+        dano: filtro(cauda, "Dano"),
+        invisibilidade: filtro(cauda, "Invisibilidade"),
+        externalidade: filtro(cauda, "Externalidade"),
+        ancoras: ancorasDe(cauda),
+        tambemEm: tambem
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean),
+    };
+}
+export async function grava(raiz, caminho) {
+    const config = await leConfigDoRepo(raiz);
+    const token = await leToken(config.api);
+    if (!token) {
+        throw new Error(`sem credencial para ${config.api}. Rode \`dd-harness login --token <token>\`.`);
+    }
+    const memoria = interpreta(await readFile(caminho, "utf8"));
+    const resposta = await fetch(`${config.api}/api/v1/memorias`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
+        body: JSON.stringify({
+            tenant: config.tenant,
+            projeto: config.projeto,
+            pasta: memoria.pasta,
+            slug: memoria.slug,
+            titulo: memoria.titulo,
+            resumo: memoria.resumo,
+            corpo: memoria.corpo,
+            dano: memoria.dano,
+            invisibilidade: memoria.invisibilidade,
+            externalidade: memoria.externalidade,
+            ancoras: memoria.ancoras,
+            tambem_em: memoria.tambemEm,
+        }),
+    });
+    if (!resposta.ok) {
+        const { erro } = (await resposta.json().catch(() => ({})));
+        throw new Error(erro ?? `a API respondeu ${resposta.status}.`);
+    }
+    const { endereco } = (await resposta.json());
+    return {
+        endereco,
+        ancoras: memoria.ancoras.length,
+        projetos: 1 + memoria.tambemEm.length,
+    };
+}

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { check, status } from "./check.js";
 import { leConfigDoRepo, guardaToken } from "./config.js";
+import { grava } from "./gravar.js";
 import { init } from "./init.js";
 import { LINHA_DE_IMPORT } from "./materializa.js";
 import { sync } from "./sync.js";
@@ -17,6 +18,7 @@ const AJUDA = `dd-harness — materializa política, briefing e Brain no reposit
   dd-harness init --tenant <t> --projeto <p> [--api <url>]
                                      prepara o repositório (config + CLAUDE.md)
   dd-harness login --token <token>   guarda a credencial desta máquina
+  dd-harness gravar <arquivo.md>     registra uma memória a partir de um markdown
   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 que espera julgamento
@@ -142,7 +144,12 @@ async function comandoCheck(argv) {
     if (r.jaAbertas > 0) {
         console.log(`${r.jaAbertas} já estava(m) aberta(s) — nada novo, só o carimbo.`);
     }
-    if (!r.ausentes.length && r.novas === 0 && r.jaAbertas === 0) {
+    // Reverter uma mudanca fecha a observacao que ela abriu. Anunciar isso importa: sem a
+    // linha, a fila encolhe sem explicacao e quem olha o `status` acha que perdeu algo.
+    if (r.fechadas > 0) {
+        console.log(`${r.fechadas} deriva(s) fechada(s): o alvo voltou a bater com a linha de base.`);
+    }
+    if (!r.ausentes.length && r.novas === 0 && r.jaAbertas === 0 && r.fechadas === 0) {
         console.log("nenhuma deriva: o mundo ainda bate com o que as memórias dizem.");
     }
     // O cruzamento com o diff e outra coisa que deriva: e "voce acabou de mexer no que
@@ -177,6 +184,22 @@ async function comandoStatus() {
             console.log(`  ${m.pasta}/${m.memoria} — ${m.titulo}`);
     }
 }
+/**
+ * O agente escreve o arquivo — que e o que ele ja fazia no modelo file-based — e este
+ * comando o transforma em requisicao. O arquivo nao fica no repositorio: quem
+ * materializa e o `sync`, a partir do servico, para nao existir copia escrita a mao ao
+ * lado da copia gerada.
+ */
+async function comandoGravar(argv) {
+    const caminho = argv[0];
+    if (!caminho || caminho.startsWith("-")) {
+        throw new Error("uso: dd-harness gravar <arquivo.md>");
+    }
+    const r = await grava(process.cwd(), caminho);
+    console.log(`gravado  ${r.endereco}`);
+    console.log(`  ${r.ancoras} âncora(s), valendo para ${r.projetos} projeto(s).` +
+        " Rode `dd-harness sync` para materializar.");
+}
 async function principal() {
     const [comando, ...resto] = process.argv.slice(2);
     switch (comando) {
@@ -184,6 +207,8 @@ async function principal() {
             return comandoInit(resto);
         case "login":
             return comandoLogin(resto);
+        case "gravar":
+            return comandoGravar(resto);
         case "sync":
             return comandoSync();
         case "check":

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "dd-harness",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "Materializa politica, briefing e Brain do dd-harness no repositorio. Sem dependencia: fetch, crypto e fs sao do Node.",
   "license": "UNLICENSED",
   "author": "Diego Dias",
-  "keywords": ["claude-code", "ai-agents", "memory", "brain", "cli"],
+  "keywords": [
+    "claude-code",
+    "ai-agents",
+    "memory",
+    "brain",
+    "cli"
+  ],
   "homepage": "https://dd-harness.vercel.app",
   "repository": {
     "type": "git",
@@ -15,7 +21,9 @@
   "bin": {
     "dd-harness": "dist/index.js"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "engines": {
     "node": ">=20"
   },