npm - dd-harness-mcp - Versions diffs - 0.8.0 → 0.9.0 - Mend

dd-harness-mcp 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/cli/src/index.js CHANGED Viewed

@@ -33,55 +33,55 @@ import { subiuOWorker } from "./worker.js";
  * em repositorio alheio tem que envelhecer bem, e cada dependencia e uma chance de nao
  * envelhecer.
  */
-const AJUDA = `dd-harness — a política e o Brain do projeto, no serviço
-  dd-harness start                  numa pasta vazia: conduz tudo (login,
-                                     espaço, projeto, config) numa tacada
-  dd-harness login --token <token> [--api <url>]
-                                     guarda a credencial desta máquina
-  dd-harness projeto <slug> --nome "<nome>" [--tenant <t>] [--api <url>]
-                                     cria o projeto no serviço (antes do init)
-  dd-harness init --tenant <t> --projeto <p> [--api <url>]
-                                     prepara o repositório (config + CLAUDE.md)
-  dd-harness pasta <slug> --definicao "o que entra e o que não entra"
-                                     cria a pasta que o gravar exige
-  dd-harness gravar <arquivo.md>     registra uma memória a partir de um markdown
-  dd-harness editar <arquivo.md>     corrige o que já está gravado
-  dd-harness arquivar <pasta>/<slug> --motivo <obsoleta|incorreta|fora_dos_filtros>
-                     [--substituida-por <pasta>/<slug>]
-                                     tira de circulação sem apagar
-  dd-harness buscar "<pergunta>"     acha memória por relevância, não por arquivo
-  dd-harness ler <pasta>/<slug>      imprime a memória inteira, no formato de gravar
-  dd-harness reancorar <pasta>/<slug> --de "<alvo>" --para "<alvo>"
-                                     troca o alvo de uma âncora que mudou de lugar
-  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 [--hook]       imprime a política do serviço
-                                     saída 0 = veio; 3 = projeto sem política;
-                                     1 = não consegui buscar
-                                     --hook: fala o protocolo do SessionStart do
-                                     Claude Code, para pôr a política no contexto
-  dd-harness --help
-  dd-harness --version              qual binário está instalado nesta máquina
-Nada do dd-harness fica em disco: a política chega pelo hook de sessão, e a
-memória pela busca, na hora.
+const AJUDA = `dd-harness — a política e o Brain do projeto, no serviço
+  dd-harness start                  numa pasta vazia: conduz tudo (login,
+                                     espaço, projeto, config) numa tacada
+  dd-harness login --token <token> [--api <url>]
+                                     guarda a credencial desta máquina
+  dd-harness projeto <slug> --nome "<nome>" [--tenant <t>] [--api <url>]
+                                     cria o projeto no serviço (antes do init)
+  dd-harness init --tenant <t> --projeto <p> [--api <url>]
+                                     prepara o repositório (config + CLAUDE.md)
+  dd-harness pasta <slug> --definicao "o que entra e o que não entra"
+                                     cria a pasta que o gravar exige
+  dd-harness gravar <arquivo.md>     registra uma memória a partir de um markdown
+  dd-harness editar <arquivo.md>     corrige o que já está gravado
+  dd-harness arquivar <pasta>/<slug> --motivo <obsoleta|incorreta|fora_dos_filtros>
+                     [--substituida-por <pasta>/<slug>]
+                                     tira de circulação sem apagar
+  dd-harness buscar "<pergunta>"     acha memória por relevância, não por arquivo
+  dd-harness ler <pasta>/<slug>      imprime a memória inteira, no formato de gravar
+  dd-harness reancorar <pasta>/<slug> --de "<alvo>" --para "<alvo>"
+                                     troca o alvo de uma âncora que mudou de lugar
+  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 [--hook]       imprime a política do serviço
+                                     saída 0 = veio; 3 = projeto sem política;
+                                     1 = não consegui buscar
+                                     --hook: fala o protocolo do SessionStart do
+                                     Claude Code, para pôr a política no contexto
+  dd-harness --help
+  dd-harness --version              qual binário está instalado nesta máquina
+Nada do dd-harness fica em disco: a política chega pelo hook de sessão, e a
+memória pela busca, na hora.
 `;
 /**
  * Os ganchos sao IMPRESSOS, nunca instalados. `.git/hooks` nao e versionado e nao e
  * nosso: escrever la dentro sem a pessoa pedir e o mesmo tipo de invasao que
  * sobrescrever o CLAUDE.md dela. Quem cola, decide.
  */
-const GANCHOS = `
-Opcional — o gancho que devolve a memória ao code review:
-  .git/hooks/post-commit   (avisa quais memórias falam do que você mudou)
-    #!/bin/sh
-    dd-harness check --commit "$(git rev-parse HEAD)" || true
-Termina em sucesso mesmo com deriva: avisa, não bloqueia.
-O hook da política (\`dd-harness politica --hook\`) é outra coisa, e não é
+const GANCHOS = `
+Opcional — o gancho que devolve a memória ao code review:
+  .git/hooks/post-commit   (avisa quais memórias falam do que você mudou)
+    #!/bin/sh
+    dd-harness check --commit "$(git rev-parse HEAD)" || true
+Termina em sucesso mesmo com deriva: avisa, não bloqueia.
+O hook da política (\`dd-harness politica --hook\`) é outra coisa, e não é
 opcional — \`dd-harness init\` imprime a linha para o \`.claude/settings.json\`.`;
 function argumento(argv, nome) {
     const i = argv.indexOf(`--${nome}`);
@@ -151,6 +151,10 @@ function tentaAbrirNavegador(url) {
         // Segue sem navegador — a URL impressa antes desta chamada ja resolve.
     }
 }
+/** Token no terminal aparece mascarado: o prefixo basta para reconhecer, o segredo nao precisa ser lido em voz alta. */
+function mascara(token) {
+    return token.length <= 16 ? "***" : `${token.slice(0, 12)}...${token.slice(-4)}`;
+}
 /**
  * `dd-harness start` — o wizard para pasta vazia.
  *
@@ -185,13 +189,27 @@ async function comandoStart() {
             "novo — start segue mesmo assim, mas pode faltar correção.\n");
     }
     // 1. Credencial. Sem ela nada do resto e possivel — nem listar tenant.
+    // O estado aparece SEMPRE, mesmo quando ja existe credencial: antes o passo era
+    // pulado em silencio, e quem rodava `start` com um token velho (ou de outra conta)
+    // nao tinha como perceber — o wizard so falhava depois, ao listar espacos.
     let token = await leToken(API_PADRAO);
+    if (token) {
+        console.log(`Credencial: ${mascara(token)} (${API_PADRAO})`);
+        const troca = await pergunta("Usar esta credencial? [S/n]: ");
+        if (/^n/i.test(troca))
+            token = null;
+    }
     if (!token) {
-        console.log(`Sem credencial salva para ${API_PADRAO}.`);
-        token = await pergunta("Cole o token pessoal (crie um em /tokens na interface): ");
+        const url = `${API_PADRAO}/tokens`;
+        console.log(`\nCrie um token pessoal em ${url} — abrindo no navegador...`);
+        tentaAbrirNavegador(url);
+        token = await pergunta("Cole o token aqui: ");
+        if (!token)
+            throw new Error("sem token não dá para seguir: `start` fala com o serviço em todos os passos.");
         await guardaToken(API_PADRAO, token);
-        console.log("Credencial guardada.\n");
+        console.log("Credencial guardada.");
     }
+    console.log("");
     // 2. Espaco (tenant). Criar um e ato de dono — nunca por aqui — mas ESCOLHER entre
     // os que ja existem e so leitura, e e o que faltava para nao exigir o slug de memoria.
     let tenants = await listaTenants(API_PADRAO, token);
@@ -203,18 +221,28 @@ async function comandoStart() {
         tenants = await listaTenants(API_PADRAO, token);
     }
     const tenant = await escolha("\nEscolha um espaço:", tenants.map((t) => ({ rotulo: `${t.nome} (${t.slug})`, valor: t.slug })));
-    // 3. Projeto. Criar e subordinado a estar num espaco — isso o CLI ja faz sozinho.
-    const nomeSugerido = process.cwd().split(/[\\/]/).pop() ?? "meu-projeto";
+    // 3. Projeto. Criar e subordinado a estar num espaco - isso o CLI ja faz sozinho.
+    // A pasta se chama `tiktok-drawer`; o projeto se chama `TikTok Drawer`. Sugerir o
+    // nome da pasta cru fazia o wizard propor um identificador onde se pede um titulo —
+    // e o slug, que e quem precisa daquele formato, ja sai daqui de baixo sozinho.
+    const pasta = process.cwd().split(/[\\/]/).pop() ?? "meu-projeto";
+    const nomeSugerido = pasta
+        .replace(/[-_]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/\b\w/g, (c) => c.toUpperCase()) || "Meu Projeto";
     const nome = (await pergunta(`\nNome do projeto [${nomeSugerido}]: `)) || nomeSugerido;
-    // Nome so com caracteres especiais (ex: "!!!") normaliza para string vazia — o
-    // fallback evita sugerir slug vazio, que o servidor recusaria com erro confuso.
-    const slugSugerido = nome
+    // O slug sai do nome, sem perguntar: e identificador, nao escolha editorial, e quem
+    // esta comecando nao tem como saber que ele vira a chave do `.dd-harness.json`.
+    // Nome so com caracteres especiais (ex: "!!!") normaliza para string vazia - o
+    // fallback evita slug vazio, que o servidor recusaria com erro confuso.
+    const slugDoProjeto = nome
         .toLowerCase()
         .normalize("NFD")
         .replace(/[̀-ͯ]/g, "")
         .replace(/[^a-z0-9]+/g, "-")
         .replace(/^-+|-+$/g, "") || "meu-projeto";
-    const slugDoProjeto = (await pergunta(`Identificador curto (slug) [${slugSugerido}]: `)) || slugSugerido;
+    console.log(`Identificador: ${slugDoProjeto}`);
     const resultadoProjeto = await criaProjeto(process.cwd(), slugDoProjeto, nome, {
         tenant,
         api: API_PADRAO,

package/dist/mcp/src/index.js CHANGED Viewed

@@ -294,4 +294,35 @@ Conteúdo vazio é válido e significa apagar o artefato.`,
     });
     return server;
 }
-serveStdio(criaServidor);
+/**
+ * `--help` / `--version` respondem e SAEM. Sem isto, qualquer invocacao com argumento
+ * caia no `serveStdio` e ficava esperando stdin para sempre — e foi assim que o
+ * aquecedor de cache do `dd-harness start` (que chamava `npx -y dd-harness-mcp --help`
+ * so para forcar o download) travou o wizard inteiro depois que o shebang passou a
+ * deixar o servidor subir de verdade.
+ */
+const args = process.argv.slice(2);
+if (args.includes("--help") || args.includes("-h")) {
+    console.log(`dd-harness-mcp — servidor MCP do dd-harness (fala por stdio, nao por terminal)
+Nao se roda a mao: quem o inicia e o host MCP (Claude Code, Codex, Cursor), pela
+declaracao em \`.mcp.json\`. Sem um host do outro lado ele fica esperando mensagem
+no stdin, que e o comportamento correto de um servidor stdio.
+  --help      esta mensagem
+  --version   a versao instalada
+Para declarar no seu repositorio, rode \`dd-harness start\`.`);
+}
+else if (args.includes("--version") || args.includes("-V")) {
+    const { readFile } = await import("node:fs/promises");
+    const { fileURLToPath } = await import("node:url");
+    const { dirname, join } = await import("node:path");
+    // `dist/mcp/src/index.js` -> tres niveis ate a raiz do pacote.
+    const aqui = dirname(fileURLToPath(import.meta.url));
+    const lido = await readFile(join(aqui, "..", "..", "..", "package.json"), "utf8");
+    console.log(JSON.parse(lido).version ?? "desconhecida");
+}
+else {
+    serveStdio(criaServidor);
+}

package/package.json CHANGED Viewed

@@ -1,40 +1,40 @@
-{
-  "name": "dd-harness-mcp",
-  "version": "0.8.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 `npx -y dd-harness-mcp` numa cache limpa antes de publicar — NAO com `node dist/mcp/src/index.js`: rodar pelo caminho direto passa mesmo quando o pacote instalado esta quebrado, porque o defeito mora no shim que o npm gera. Sem o shebang em `src/index.ts` o shim `.cmd` do Windows chama o `.js` sem `node` na frente, e o servidor morre limpo (exit 0, em silencio) antes do handshake — o cliente so ve CONNECTION_CLOSED.",
-  "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"
-  }
-}
+{
+  "name": "dd-harness-mcp",
+  "version": "0.9.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 `npx -y dd-harness-mcp` numa cache limpa antes de publicar — NAO com `node dist/mcp/src/index.js`: rodar pelo caminho direto passa mesmo quando o pacote instalado esta quebrado, porque o defeito mora no shim que o npm gera. Sem o shebang em `src/index.ts` o shim `.cmd` do Windows chama o `.js` sem `node` na frente, e o servidor morre limpo (exit 0, em silencio) antes do handshake — o cliente so ve CONNECTION_CLOSED.",
+  "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"
+  }
+}