dd-harness 0.40.1 → 0.41.0

package/dist/artefato.d.ts

@@ -23,13 +23,40 @@ export declare function leArtefato(raiz: string, tipo: TipoDeArtefato): Promise<
     existe: boolean;
     atualizadaEm: string | null;
 }>;
+/** O que o `PUT` devolve. `sem_alteracao`: o texto era igual ao atual e nao virou versao. */
+export type EscritaDeArtefato = {
+    artefato: string;
+    criou: boolean;
+    tamanho: number;
+    versao: number;
+    sem_alteracao: boolean;
+};
 /**
  * Substituicao total, nao append: quem quer acrescentar um paragrafo le, concatena e
  * reenvia. Conteudo vazio e valido e significa "apagar" — a linha fica no banco, guardando
  * quem mexeu por ultimo.
+ *
+ * Toda escrita vira uma versao numerada no servico, e `resumo` e a linha que o historico
+ * guarda sobre ela: o que mudou e por que.
  */
-export declare function escreveArtefato(raiz: string, tipo: TipoDeArtefato, conteudo: string, atualizadaEm: string | null): Promise<{
-    artefato: string;
-    criou: boolean;
+export declare function escreveArtefato(raiz: string, tipo: TipoDeArtefato, conteudo: string, atualizadaEm: string | null, resumo: string): Promise<EscritaDeArtefato>;
+export type VersaoDeArtefato = {
+    versao: number;
+    resumo: string;
+    criada_em: string;
     tamanho: number;
+};
+/**
+ * O historico do artefato: a lista de versoes, da mais recente para a mais antiga. Nao
+ * entra no boot — chega so quando alguem precisa entender por que o texto esta assim.
+ */
+export declare function leVersoesDoArtefato(raiz: string, tipo: TipoDeArtefato): Promise<VersaoDeArtefato[]>;
+/**
+ * Uma linha por versao, e nao tabela: o resumo e texto livre, e um `|` dentro dele
+ * quebraria a tabela markdown que o agente le.
+ */
+export declare function formataHistorico(tipo: TipoDeArtefato, versoes: VersaoDeArtefato[]): string;
+/** O texto integral de uma versao antiga, com o resumo do que ela mudou. */
+export declare function leVersaoDoArtefato(raiz: string, tipo: TipoDeArtefato, versao: number): Promise<Omit<VersaoDeArtefato, "tamanho"> & {
+    conteudo: string;
 }>;

package/dist/artefato.js

@@ -27,8 +27,11 @@ export async function leArtefato(raiz, tipo) {
  * Substituicao total, nao append: quem quer acrescentar um paragrafo le, concatena e
  * reenvia. Conteudo vazio e valido e significa "apagar" — a linha fica no banco, guardando
  * quem mexeu por ultimo.
+ *
+ * Toda escrita vira uma versao numerada no servico, e `resumo` e a linha que o historico
+ * guarda sobre ela: o que mudou e por que.
  */
-export async function escreveArtefato(raiz, tipo, conteudo, atualizadaEm) {
+export async function escreveArtefato(raiz, tipo, conteudo, atualizadaEm, resumo) {
     const { config, token } = await credencial(raiz);
     const resposta = await pede(`${config.api}/api/v1/artefatos`, {
         method: "PUT",
@@ -43,6 +46,7 @@ export async function escreveArtefato(raiz, tipo, conteudo, atualizadaEm) {
             projeto: config.projeto,
             tipo,
             conteudo,
+            resumo,
         }),
     });
     if (!resposta.ok)
@@ -52,3 +56,42 @@ export async function escreveArtefato(raiz, tipo, conteudo, atualizadaEm) {
     });
     return (await jsonDaEscrita(resposta));
 }
+/**
+ * O historico do artefato: a lista de versoes, da mais recente para a mais antiga. Nao
+ * entra no boot — chega so quando alguem precisa entender por que o texto esta assim.
+ */
+export async function leVersoesDoArtefato(raiz, tipo) {
+    const corpo = (await pedeHistorico(raiz, tipo));
+    return corpo.versoes;
+}
+/**
+ * Uma linha por versao, e nao tabela: o resumo e texto livre, e um `|` dentro dele
+ * quebraria a tabela markdown que o agente le.
+ */
+export function formataHistorico(tipo, versoes) {
+    if (versoes.length === 0)
+        return `O ${tipo} ainda não tem versões — nunca foi escrito.`;
+    return [
+        `Histórico do ${tipo} — ${versoes.length} versão(ões), da mais recente para a mais antiga:`,
+        "",
+        ...versoes.map((v, i) => `- v${v.versao}${i === 0 ? " (atual)" : ""} · ${v.criada_em.slice(0, 16).replace("T", " ")} · ` +
+            `${v.tamanho} caractere(s) — ${v.resumo}`),
+    ].join("\n");
+}
+/** O texto integral de uma versao antiga, com o resumo do que ela mudou. */
+export async function leVersaoDoArtefato(raiz, tipo, versao) {
+    return (await pedeHistorico(raiz, tipo, versao));
+}
+async function pedeHistorico(raiz, tipo, versao) {
+    const { config, token } = await credencial(raiz);
+    const url = new URL(`${config.api}/api/v1/artefatos/historico`);
+    url.searchParams.set("tenant", config.tenant);
+    url.searchParams.set("projeto", config.projeto);
+    url.searchParams.set("tipo", tipo);
+    if (versao !== undefined)
+        url.searchParams.set("versao", String(versao));
+    const resposta = await pede(url, { headers: cabecalhos(token) });
+    if (!resposta.ok)
+        await recusa(resposta);
+    return resposta.json();
+}

package/dist/sessao.js

@@ -116,7 +116,7 @@ export function saidaDaGuarda(host, motivo, contexto) {
 }
 // Só ferramentas conhecidas de leitura passam quando o boot falta. Shell não é classificado por regex.
 const LEITURA = /^(Read|Glob|Grep|view_file|list_dir|find_by_name|grep_search|ask_question|AskUserQuestion|request_user_input)$/;
-const LEITURA_MCP = /^mcp__dd[-_]harness__(ler_artefato|ler_roadmap|ler_changelog|listar_skills|ler_skill|ler_memoria|buscar_memoria)$/;
+const LEITURA_MCP = /^mcp__dd[-_]harness__(ler_artefato|ler_historico_artefato|ler_roadmap|ler_changelog|listar_skills|ler_skill|ler_memoria|buscar_memoria)$/;
 /**
  * O que um projeto SEM politica precisa para ganhar uma.
  *

package/package.json

@@ -1,44 +1,44 @@
-{
-  "name": "dd-harness",
-  "version": "0.40.1",
-  "type": "module",
-  "description": "Política, memória e integrações de Claude Code, Codex e Antigravity. CLI sem dependências de runtime.",
-  "license": "UNLICENSED",
-  "author": "Diego Dias",
-  "keywords": [
-    "claude-code",
-    "ai-agents",
-    "memory",
-    "brain",
-    "cli"
-  ],
-  "homepage": "https://dd-harness.vercel.app",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/diegodias93/dd-harness-online.git",
-    "directory": "packages/cli"
-  },
-  "bin": {
-    "dd-harness": "dist/index.js"
-  },
-  "//exports": "Aponta para `dist` porque quem IMPORTA isto em tempo de execucao e o Node, que nao executa TypeScript. Nao aponte para `src`: o Node segue os imports relativos de dentro do arquivo e tenta abrir `./api.js` ao lado do `.ts`, que nao existe. Quem consome no workspace e o `packages/mcp`, e ele compila o fonte do CLI junto (ver o tsconfig.build.json dele) em vez de depender deste campo — assim o build funciona num checkout limpo, sem `dist` previo.",
-  "exports": {
-    "./api": "./dist/api.js",
-    "./buscar": "./dist/buscar.js",
-    "./curar": "./dist/curar.js",
-    "./gravar": "./dist/gravar.js",
-    "./pasta": "./dist/pasta.js",
-    "./projeto": "./dist/projeto.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "engines": {
-    "node": ">=20.3.0"
-  },
-  "scripts": {
-    "typecheck": "tsc -p . --noEmit",
-    "build": "tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run build"
-  }
-}
+{
+  "name": "dd-harness",
+  "version": "0.41.0",
+  "type": "module",
+  "description": "Política, memória e integrações de Claude Code, Codex e Antigravity. CLI sem dependências de runtime.",
+  "license": "UNLICENSED",
+  "author": "Diego Dias",
+  "keywords": [
+    "claude-code",
+    "ai-agents",
+    "memory",
+    "brain",
+    "cli"
+  ],
+  "homepage": "https://dd-harness.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/diegodias93/dd-harness-online.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "dd-harness": "dist/index.js"
+  },
+  "//exports": "Aponta para `dist` porque quem IMPORTA isto em tempo de execucao e o Node, que nao executa TypeScript. Nao aponte para `src`: o Node segue os imports relativos de dentro do arquivo e tenta abrir `./api.js` ao lado do `.ts`, que nao existe. Quem consome no workspace e o `packages/mcp`, e ele compila o fonte do CLI junto (ver o tsconfig.build.json dele) em vez de depender deste campo — assim o build funciona num checkout limpo, sem `dist` previo.",
+  "exports": {
+    "./api": "./dist/api.js",
+    "./buscar": "./dist/buscar.js",
+    "./curar": "./dist/curar.js",
+    "./gravar": "./dist/gravar.js",
+    "./pasta": "./dist/pasta.js",
+    "./projeto": "./dist/projeto.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.3.0"
+  },
+  "scripts": {
+    "typecheck": "tsc -p . --noEmit",
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  }
+}