dd-harness 0.11.0 → 0.13.0

package/dist/index.js

@@ -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/package.json

@@ -1,44 +1,44 @@
-{
-  "name": "dd-harness",
-  "version": "0.11.0",
-  "type": "module",
-  "description": "Cliente do dd-harness: politica no inicio da sessao, e memoria por busca — nada em disco. Sem dependencia: fetch, crypto e fs sao do Node.",
-  "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"
-  },
-  "scripts": {
-    "typecheck": "tsc -p . --noEmit",
-    "build": "tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run build"
-  }
-}
+{
+  "name": "dd-harness",
+  "version": "0.13.0",
+  "type": "module",
+  "description": "Cliente do dd-harness: politica no inicio da sessao, e memoria por busca — nada em disco. Sem dependencia: fetch, crypto e fs sao do Node.",
+  "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"
+  },
+  "scripts": {
+    "typecheck": "tsc -p . --noEmit",
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  }
+}