token-trace-manager 0.7.0 → 0.7.1

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "Proxy local universal de rastreio de tokens/custo para TUIs de código, com labels por ticket e dashboard local",
-    "version": "0.7.0"
+    "version": "0.7.1"
   },
   "plugins": [
     {
       "name": "ttm",
       "source": "./",
       "description": "Proxy local universal de rastreio de tokens/custo para TUIs de código (Claude Code, Codex, OpenCode, Gemini CLI, Kilo...), com labels por ticket e dashboard local.",
-      "version": "0.7.0",
+      "version": "0.7.1",
       "category": "productivity"
     }
   ]

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ttm",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Proxy local universal de rastreio de tokens/custo para TUIs de código (Claude Code, Codex, OpenCode, Gemini CLI, Kilo...), com labels por ticket e dashboard local.",
   "author": {
     "name": "Mpaape"

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 Mudanças notáveis deste projeto. Formato: [Keep a Changelog](https://keepachangelog.com/), [semver](https://semver.org/).
 
+## [0.7.1] - 2026-07-09
+
+### Fixed
+- Roteamento de labels por URL agora é inequívoco: tickets continuam em `/{target}/PROJ-123/...`, e slugs descritivos usam `/{target}/-/{slug}/...`, sem roubar paths hifenizados reais do upstream.
+- Payloads redigem recursivamente campos secretos em bodies JSON (`api_key`, `access_token`, `authorization`, `client_secret`, etc.) antes de gravar `payloads/*.json`.
+- `/api/summary` sem `since` volta a usar o default documentado de `30d`.
+- `ttm config` redige `otel.headers` antes de imprimir a configuração.
+- `ttm audit --since all` aceita `all` sem gerar data inválida.
+- MCP reporta a versão real do pacote e `ttm_set_label` sem `label` não limpa mais o estado por acidente.
+- `ttm link codex` cria um provider `ttm` completo quando `~/.codex/config.toml` existe mas ainda não tem provider ativo.
+
+### Changed
+- SQLite inicializa com WAL, `busy_timeout` e índices adicionais para reduzir colisões entre daemon, auditoria e consultas.
+- Erros reais de schema/migração SQLite deixam de cair silenciosamente para o backend JSON; fallback JSON fica restrito a runtimes sem `node:sqlite` ou ao hook de teste.
+- E2E ampliado para 154 asserções cobrindo as regressões acima, backend JSON, redaction de body e smoke de CLI.
+
 ## [0.7.0] - 2026-07-08
 
 ### Added

package/README.md

@@ -16,7 +16,8 @@ Um único daemon local intercepta as chamadas de API de todas as suas ferramenta
  Claude Code ──┐                          ┌──> api.anthropic.com
  Codex ────────┤   proxyURL               ├──> api.openai.com
  OpenCode ─────┼─> http://127.0.0.1:25519 ┼──> generativelanguage.googleapis.com
- Gemini CLI ───┤   /{target}/{TICKET?}/…  ├──> openrouter.ai/api
+ Gemini CLI ───┤  /{target}/{TICKET?}/…   ├──> openrouter.ai/api
+                │  /{target}/-/{slug}/…   │
  Kilo, etc ────┘        │                 └──> (targets customizados)
                         │ tee (só metadados de usage)
                         v
@@ -26,48 +27,38 @@ Um único daemon local intercepta as chamadas de API de todas as suas ferramenta
 ```
 
 - **targetUrl** — a URL real do provedor que o TUI chamaria sem proxy (já vem preenchida para `anthropic`, `openai`, `gemini` e `openrouter`; adicione outras no config).
-- **proxyURL** — `http://127.0.0.1:25519`. O primeiro segmento do path escolhe o target; um segundo segmento opcional no formato `TICKET-123` vira o label daquela chamada.
+- **proxyURL** — `http://127.0.0.1:25519`. O primeiro segmento do path escolhe o target; um segundo segmento opcional no formato `TICKET-123` vira o label daquela chamada. Para labels descritivos que não são ticket, use a forma explícita `/{target}/-/{slug}/...`, sem ambiguidade com o path real do provedor.
 
 ## Instalação
 
-Escolha o caminho pelo seu caso — cada um é completo e autossuficiente.
+> Pré-requisito: **Node ≥ 22.5**. Sem dependências, sem build — é Node puro.
 
-### Caminho A — uso o Claude Code (plugin, recomendado)
-
-```
-1.  /plugin marketplace add cloud104/token-trace-manager
-2.  /plugin install ttm@token-trace-manager
-3.  Reinicie o Claude Code                                (plugins carregam na inicialização)
-4.  /ttm:setup                                            (sobe o daemon e, com sua aprovação,
-                                                            aponta o ANTHROPIC_BASE_URL pro proxy)
-5.  Reinicie o Claude Code de novo                        (a env var só vale pra sessão nova)
+```bash
+npm install -g token-trace-manager   # 1. instala o bin `ttm`
+ttm start                            # 2. sobe o daemon (porta 25519, só 127.0.0.1)
+ttm link claude-code                 # 3. insere o ttm no meio do seu TUI
+ttm status                           #    pronto — daemon rodando
 ```
 
-São **dois reinícios** mesmo — um para o plugin carregar, outro para a env var valer. Só na primeira vez; depois é só usar. Valide com `/ttm:status`: se aparecer o daemon rodando e as chamadas contando, está pronto. Os comandos disponíveis: `/ttm:setup`, `/ttm:status`, `/ttm:link`, `/ttm:dashboard`, `/ttm:config`.
-
-Quer rastrear outros TUIs além do Claude Code? O daemon já é o mesmo — só falta apontar cada ferramenta: `/ttm:setup codex` (ou `opencode`, `gemini-cli`...) mostra o snippet.
+`ttm link` suporta `claude-code`, `codex`, `opencode`, `gemini-cli`. Ele descobre a base URL que o TUI já usa, vira upstream dela e reescreve a config do TUI pra passar pelo ttm. Depois, é só usar o TUI normalmente — cada chamada conta tokens.
 
-### Caminho B — qualquer outro TUI (standalone, sem Claude Code)
+![ttm — instala e roda em 4 comandos](.github/assets/ttm-demo.gif)
 
-```bash
-npm install -g token-trace-manager   # instala o bin `ttm` (Node ≥ 22.5)
-
-ttm start                            # 1. sobe o daemon (idempotente)
-ttm link claude-code                 # 2. descobre a base URL do TUI e se insere no meio
-                                     #    (use: claude-code, codex, opencode, gemini-cli)
-ttm status                           # 3. confirma que está de pé
-```
+> **Já redireciona pra um compatível-anthropic (z.ai/GLM/...)?** O `ttm link` **preserva** seu redirect — ele descobre pra onde você aponta, vira upstream disso, e reescreve a config do TUI. Continua batendo no mesmo lugar, só que com contagem de tokens.
 
-> **Já redireciona pra um compatível-anthropic (z.ai/GLM/...)?** O `ttm link` **preserva** o seu redirect — ele descobre pra onde você aponta, vira upstream disso, e reescreve a config do TUI pra passar pelo ttm. Continua batendo no mesmo lugar, só que com contagem de tokens.
+<details>
+<summary><strong>Outros caminhos</strong> (sem npm, plugin do Claude Code, etc.)</summary>
 
-Sem npm? Funciona pelo git também:
+**Sem npm — via git:**
 ```bash
 git clone https://github.com/cloud104/token-trace-manager
 cd token-trace-manager
-npm link                             # deixa `ttm` no PATH (sem isso, use `node bin/ttm.mjs`)
+npm link            # deixa `ttm` no PATH (sem isso, use `node bin/ttm.mjs`)
 ```
 
-Requer Node ≥ 22.5 (SQLite nativo via `node:sqlite`). Sem dependências — é Node puro.
+**Plugin do Claude Code (`/plugin install`):** exige que o repo seja **público** (`/plugin marketplace add cloud104/token-trace-manager` clona o repo). Enquanto o repo estiver privado, use o caminho do `npm` acima — funciona pro Claude Code também, e o `ttm link claude-code` cuida de tudo (inclusive do redirect). Não há perda de função: as tools MCP (`ttm_status`, `ttm_set_label`, `ttm_usage_summary`) ficam disponíveis em qualquer TUI compatível com MCP via `.mcp.json`.
+
+</details>
 
 ## No dia a dia
 
@@ -143,11 +134,11 @@ período: 24h — 1 chamadas, 42.9k tokens, $0.52
   TESTE-1                  42.9k tok      $0.52  (1 chamadas)
 ```
 
-Se apareceu, está tudo validado de uma vez: daemon de pé, passthrough com sua autenticação intacta, extração de usage, atribuição por label e custo calculado. Abra `http://127.0.0.1:25519/dashboard` para ver no navegador. (Para testar os internos sem rede: `npm test` — 40 asserções contra um upstream fake.)
+Se apareceu, está tudo validado de uma vez: daemon de pé, passthrough com sua autenticação intacta, extração de usage, atribuição por label e custo calculado. Abra `http://127.0.0.1:25519/dashboard` para ver no navegador. (Para testar os internos sem rede: `npm test` — 154 asserções contra um upstream fake.)
 
 ## Configurando cada TUI
 
-O padrão é sempre o mesmo: trocar a base URL da ferramenta de `targetUrl` (a URL padrão do provedor) para `proxyURL/{target}`. Com um ticket no path (`proxyURL/{target}/PROJ-123`), todo o tráfego daquela configuração é atribuído ao ticket. `ttm setup <tui>` imprime o snippet da sua porta atual.
+O padrão é sempre o mesmo: trocar a base URL da ferramenta de `targetUrl` (a URL padrão do provedor) para `proxyURL/{target}`. Com um ticket no path (`proxyURL/{target}/PROJ-123`), todo o tráfego daquela configuração é atribuído ao ticket. Para slug descritivo, use `proxyURL/{target}/-/meu-slug`. `ttm setup <tui>` imprime o snippet da sua porta atual.
 
 ### Claude Code
 `targetUrl` padrão: `https://api.anthropic.com` — override por env var `ANTHROPIC_BASE_URL` (precisa existir **antes** do processo iniciar):
@@ -267,7 +258,7 @@ O modo padrão (backend proprietário do Copilot) não é rastreável.
 
 Duas formas, combináveis:
 
-1. **Na URL** (recomendado, por repo/branch): `http://127.0.0.1:25519/anthropic/PROJ-123` — tudo que passar por essa configuração cai no `PROJ-123`. Ideal via `.claude/settings.json` por repositório, ou um `opencode.json` por projeto.
+1. **Na URL** (recomendado, por repo/branch): `http://127.0.0.1:25519/anthropic/PROJ-123` — tudo que passar por essa configuração cai no `PROJ-123`. Para um label que não é ticket, use `http://127.0.0.1:25519/anthropic/-/meu-slug`. Ideal via `.claude/settings.json` por repositório, ou um `opencode.json` por projeto.
 2. **Label padrão global**: `ttm label PROJ-123` (ou tool MCP `ttm_set_label`, ou `/ttm:link PROJ-123` no Claude Code) — vale para todo tráfego **sem** label na URL, de qualquer TUI, até trocar. `ttm label none` limpa.
 
 Chamadas sem nenhum label aparecem no dashboard como "Sem label" — nada se perde.
@@ -359,7 +350,7 @@ Arquivo: `~/.claude/plugins/data/token-trace-manager/config.json` (criado sob de
 node test/e2e.mjs
 ```
 
-Sobe um upstream fake + o daemon real e valida: passthrough de streaming e não-streaming nos 4 protocolos, labels por URL e por padrão, normalização de tokens (cache/reasoning), cálculo de custo, injeção+filtragem de `include_usage`, endpoints locais, dashboard, privacidade (nenhuma chave ou conteúdo persistido) e as regressões da revisão adversarial (XSS via User-Agent, corrupção por `$'` no template, rotas herdadas de protótipo, erros de protocolo MCP). 81+ asserções, cobrindo também retenção/rollups, contexto repo/branch, relabel retroativo, sessionização de traces e o exportador OTel.
+Sobe um upstream fake + o daemon real e valida: passthrough de streaming e não-streaming nos 4 protocolos, labels por URL e por padrão, normalização de tokens (cache/reasoning), cálculo de custo, injeção+filtragem de `include_usage`, endpoints locais, dashboard, privacidade (headers e segredos no body não persistem) e regressões adversariais (XSS via User-Agent, corrupção por `$'` no template, rotas herdadas de protótipo, paths hifenizados, erros de protocolo MCP). 150+ asserções, cobrindo também retenção/rollups, contexto repo/branch, relabel retroativo, sessionização de traces, backend JSON e o exportador OTel.
 
 ## Upgrade
 

package/bin/ttm.mjs

@@ -9,6 +9,7 @@ import { readConfig, writeConfig, setTarget, removeTarget, validateConfig, KNOWN
 import { ensureDaemon, stopDaemon, daemonHealth, fetchDaemon } from '../lib/daemon-client.mjs'
 import { linkTui, unlinkTui } from '../lib/link.mjs'
 import { PRICING_LAST_UPDATED } from '../lib/pricing.mjs'
+import { sinceToIso } from '../lib/report-data.mjs'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
@@ -59,6 +60,14 @@ function fmtTok(n) {
 
 const fmtUsd = n => '$' + (n || 0).toFixed(2)
 
+function printableConfig(cfg) {
+  const out = JSON.parse(JSON.stringify(cfg))
+  if (out.otel?.headers) {
+    out.otel.headers = Object.fromEntries(Object.keys(out.otel.headers).map(k => [k, '[REDACTED]']))
+  }
+  return out
+}
+
 async function main() {
   const [cmd, ...args] = process.argv.slice(2)
   const cfg = readConfig()
@@ -131,9 +140,7 @@ async function main() {
     case 'audit': {
       const { runAudit } = await import('../lib/audit.mjs')
       const since = flag(args, '--since', null)
-      const sinceIso = since
-        ? new Date(Date.now() - parseInt(since, 10) * (since.endsWith('h') ? 3600000 : 86400000)).toISOString()
-        : null
+      const sinceIso = sinceToIso(since)
       const r = await runAudit({ sinceIso })
       console.log(`auditoria (${since ?? 'tudo'}) — ${r.eventCount} eventos\n`)
       console.log(`[1] matemática interna (custo = tokens x taxas gravadas na hora da chamada)`)
@@ -262,7 +269,7 @@ async function main() {
         console.log(`target "${name}" -> ${url} [protocolo: ${protocol}${envVar ? `, env: ${envVar}` : ''}]`)
         return
       }
-      console.log(JSON.stringify({ ...cfg, pricingLastUpdated: PRICING_LAST_UPDATED }, null, 2))
+      console.log(JSON.stringify(printableConfig({ ...cfg, pricingLastUpdated: PRICING_LAST_UPDATED }), null, 2))
       return
     }
 

package/commands/setup.md

@@ -3,7 +3,7 @@ description: Configura o Claude Code (ou mostra o snippet de outro TUI) para pas
 argument-hint: "[claude-code | codex | opencode | gemini-cli | kilo | ...]"
 ---
 
-O objetivo é apontar a base URL do TUI para o proxy local (`http://127.0.0.1:<porta>/<target>[/<TICKET-123>]`). Chame `ttm_status` para obter a porta e os targets atuais.
+O objetivo é apontar a base URL do TUI para o proxy local (`http://127.0.0.1:<porta>/<target>[/<TICKET-123>]`; para slug descritivo use `/<target>/-/<slug>`). Chame `ttm_status` para obter a porta e os targets atuais.
 
 **Se `$ARGUMENTS` for vazio ou `claude-code`** — o TUI é o próprio Claude Code:
 1. Explique que a variável `ANTHROPIC_BASE_URL` precisa estar definida ANTES do Claude Code iniciar, então a mudança só vale para sessões novas.

package/lib/daemon-client.mjs

@@ -50,7 +50,10 @@ export async function ensureDaemon() {
   // Daemon de uma versão antiga ainda de pé após upgrade: template/dados
   // ficariam inconsistentes — reinicia com o código novo automaticamente.
   if (health) {
-    await stopDaemon()
+    const stopped = await stopDaemon()
+    if (!stopped.stopped || stopped.graceful === false) {
+      throw new Error(`daemon antigo (pid ${health.pid}) não parou com segurança: ${stopped.reason ?? 'timeout aguardando saída'}`)
+    }
     const h = await spawnDaemon()
     return { started: true, restartedFrom: health.version, health: h }
   }

package/lib/daemon.mjs

@@ -8,10 +8,11 @@
 //    storePayloads estiver ligado (default: ligado) — chaves de API nunca,
 //    em nenhuma hipótese, vão parar lá.
 //
-// Roteamento: http://127.0.0.1:PORT/{target}/{label?}/{caminho-upstream}
-//   target : chave em config.targets (anthropic, openai, gemini, ...)
-//   label  : segmento opcional estilo PROJ-123 para atribuir o custo
-//   resto  : caminho repassado ao targetUrl do provedor
+// Roteamento:
+//   http://127.0.0.1:PORT/{target}/{TICKET-123}/{caminho-upstream}
+//   http://127.0.0.1:PORT/{target}/-/{label-slug}/{caminho-upstream}
+// O ticket curto continua conveniente; labels descritivos usam "/-/" para não
+// roubar segmentos reais do path do provedor (ex: /api-v2/chat/completions).
 
 import fs from 'node:fs'
 import http from 'node:http'
@@ -32,12 +33,10 @@ const VERSION = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.j
 
 // Label = qualquer identificador de tarefa: ticket real (PROJ-123) OU slug
 // descritivo (TCW-poc-proxy-contabilizacao-custo-ia) — não exige card já criado.
-// Exige AO MENOS UM hífen: é a assinatura que distingue um label de um
-// segmento normal de path do provedor (v1, v1beta, messages, models, ...),
-// nenhum dos quais tem hífen — sem isso o roteamento interpretaria "v1" como
-// label e quebraria toda chamada sem label explícito na URL.
 const LABEL_RE = /^[A-Za-z][A-Za-z0-9]*(?:-[A-Za-z0-9]+)+$/
+const TICKET_LABEL_RE = /^[A-Za-z][A-Za-z0-9]*-\d+$/
 const LABEL_MAX_LEN = 120
+const SECRET_KEY_RE = /(?:api[_-]?key|access[_-]?token|auth(?:orization)?|auth[_-]?token|bearer[_-]?token|client[_-]?secret|refresh[_-]?token|id[_-]?token|password|secret|credential)/i
 const HOP_BY_HOP = new Set([
   'connection',
   'keep-alive',
@@ -53,6 +52,67 @@ const MAX_JSON_CAPTURE = 32 * 1024 * 1024
 
 const startedAt = Date.now()
 
+function isValidLabel(label) {
+  return typeof label === 'string' && label.length > 0 && label.length <= LABEL_MAX_LEN && LABEL_RE.test(label)
+}
+
+function invalidLabelMessage(label, action = 'inválido') {
+  return `label "${label ?? ''}" ${action} (ex: PROJ-123 ou /-/um-slug-descritivo, até ${LABEL_MAX_LEN} caracteres)`
+}
+
+function parseProxyRoute(segments, search) {
+  let label = null
+  let restIdx = 1
+  const second = segments[1]
+
+  if (second === '-') {
+    const explicit = segments[2]
+    if (!isValidLabel(explicit)) return { error: invalidLabelMessage(explicit) }
+    label = explicit.toUpperCase()
+    restIdx = 3
+  } else if (second && TICKET_LABEL_RE.test(second)) {
+    if (second.length > LABEL_MAX_LEN) return { error: invalidLabelMessage(second) }
+    label = second.toUpperCase()
+    restIdx = 2
+  }
+
+  return {
+    label,
+    upstreamPath: '/' + segments.slice(restIdx).join('/') + search,
+  }
+}
+
+function redactRawSecrets(text) {
+  return text
+    .replace(/("(?:api[_-]?key|access[_-]?token|auth(?:orization)?|auth[_-]?token|client[_-]?secret|password|secret)"\s*:\s*")([^"]*)(")/gi, '$1[REDACTED]$3')
+    .replace(/\b(api[_-]?key|access[_-]?token|authorization|auth[_-]?token|client[_-]?secret|password|secret)\s*[:=]\s*([^\s&;,]+)/gi, '$1=[REDACTED]')
+}
+
+function redactSecrets(value, seen = new WeakSet()) {
+  if (!value || typeof value !== 'object') return value
+  if (seen.has(value)) return '[Circular]'
+  seen.add(value)
+  if (Array.isArray(value)) return value.map(v => redactSecrets(v, seen))
+
+  const out = {}
+  for (const [k, v] of Object.entries(value)) {
+    out[k] = SECRET_KEY_RE.test(k) ? '[REDACTED]' : redactSecrets(v, seen)
+  }
+  return out
+}
+
+function payloadRequestFromBody(requestBody) {
+  if (requestBody.length > 4 * 1024 * 1024) {
+    return { _truncado: true, _bytes: requestBody.length }
+  }
+  const text = requestBody.toString('utf8')
+  try {
+    return redactSecrets(JSON.parse(text))
+  } catch {
+    return { _raw: redactRawSecrets(text).slice(0, 1024 * 1024) }
+  }
+}
+
 function sendJson(res, status, obj) {
   const body = JSON.stringify(obj)
   res.writeHead(status, { 'content-type': 'application/json', 'content-length': Buffer.byteLength(body) })
@@ -101,8 +161,8 @@ async function handleLocal(req, res, pathname, searchParams) {
         })
       }
       const label = payload.label ?? null
-      if (label !== null && (label.length > LABEL_MAX_LEN || !LABEL_RE.test(label))) {
-        return sendJson(res, 400, { error: `label "${label}" inválido (ex: PROJ-123 ou um-slug-descritivo, até ${LABEL_MAX_LEN} caracteres)` })
+      if (label !== null && !isValidLabel(label)) {
+        return sendJson(res, 400, { error: invalidLabelMessage(label) })
       }
       const normalized = label ? label.toUpperCase() : null
       await setKv('default_label', normalized)
@@ -227,7 +287,7 @@ async function handleLocal(req, res, pathname, searchParams) {
       let label = payload.label ?? null
       if (label !== null) {
         if (label.length > LABEL_MAX_LEN || !LABEL_RE.test(label)) {
-          return sendJson(res, 400, { error: `label "${label}" inválido para deleção (ex: PROJ-123 ou um-slug-descritivo)` })
+          return sendJson(res, 400, { error: invalidLabelMessage(label, 'inválido para deleção') })
         }
         label = label.toUpperCase()
       }
@@ -469,16 +529,6 @@ async function proxyRequest(req, res, cfg, targetName, label, upstreamPath) {
                 if (!storePayloads || !id) return
                 // Conteúdo da chamada para inspeção (segue a retenção; SEM
                 // headers — chaves de API nunca tocam o disco)
-                let request
-                if (requestBody.length > 4 * 1024 * 1024) {
-                  request = { _truncado: true, _bytes: requestBody.length }
-                } else {
-                  try {
-                    request = JSON.parse(requestBody.toString('utf8'))
-                  } catch {
-                    request = { _raw: requestBody.toString('utf8').slice(0, 1024 * 1024) }
-                  }
-                }
                 fs.writeFileSync(
                   payloadPath(id),
                   JSON.stringify({
@@ -486,7 +536,7 @@ async function proxyRequest(req, res, cfg, targetName, label, upstreamPath) {
                     ts: evRecord.ts ?? new Date().toISOString(),
                     label: evRecord.label,
                     model: evRecord.model,
-                    request,
+                    request: payloadRequestFromBody(requestBody),
                     response: { text: u.text || null },
                   }),
                 )
@@ -535,14 +585,9 @@ export function createDaemonServer() {
         return await handleLocal(req, res, parsed.pathname, parsed.searchParams)
       }
 
-      let label = null
-      let restIdx = 1
-      if (segments.length > 1 && LABEL_RE.test(segments[1])) {
-        label = segments[1].toUpperCase()
-        restIdx = 2
-      }
-      const upstreamPath = '/' + segments.slice(restIdx).join('/') + parsed.search
-      await proxyRequest(req, res, cfg, first, label, upstreamPath)
+      const route = parseProxyRoute(segments, parsed.search)
+      if (route.error) return sendJson(res, 400, { error: route.error })
+      await proxyRequest(req, res, cfg, first, route.label, route.upstreamPath)
     } catch (err) {
       if (!res.headersSent) sendJson(res, 500, { error: err.message })
       else res.destroy()

package/lib/db.mjs

@@ -58,6 +58,8 @@ CREATE TABLE IF NOT EXISTS usage_events (
 );
 CREATE INDEX IF NOT EXISTS idx_usage_events_ts ON usage_events(ts);
 CREATE INDEX IF NOT EXISTS idx_usage_events_label ON usage_events(label);
+CREATE INDEX IF NOT EXISTS idx_usage_events_target ON usage_events(target);
+CREATE INDEX IF NOT EXISTS idx_usage_events_label_ts ON usage_events(label, ts);
 
 CREATE TABLE IF NOT EXISTS kv (
   key   TEXT PRIMARY KEY,
@@ -83,6 +85,8 @@ CREATE TABLE IF NOT EXISTS daily_rollups (
   events              INTEGER DEFAULT 0,
   PRIMARY KEY (day, label, target, model, client)
 );
+CREATE INDEX IF NOT EXISTS idx_daily_rollups_day ON daily_rollups(day);
+CREATE INDEX IF NOT EXISTS idx_daily_rollups_label_day ON daily_rollups(label, day);
 `
 
 // Migração aditiva: bases criadas por versões antigas ganham as colunas novas.
@@ -110,26 +114,38 @@ function migrate(db) {
 
 let backend = null // { kind: 'sqlite', db } | { kind: 'json', file }
 
+function jsonBackend() {
+  const file = path.join(dataDir(), 'ttm-events.json')
+  if (!fs.existsSync(file)) {
+    fs.writeFileSync(file, JSON.stringify({ nextId: 1, events: [], kv: {} }, null, 2))
+  }
+  backend = { kind: 'json', file }
+  return backend
+}
+
 async function getBackend() {
   if (backend) return backend
+  if (process.env.TTM_FORCE_JSON_BACKEND === '1') return jsonBackend()
+
+  let DatabaseSync
+  try {
+    ;({ DatabaseSync } = await import('node:sqlite'))
+  } catch (err) {
+    // Fallback JSON existe só quando o runtime não oferece node:sqlite.
+    if (err?.code === 'ERR_UNKNOWN_BUILTIN_MODULE' || /node:sqlite/.test(err?.message || '')) return jsonBackend()
+    throw err
+  }
+
+  const db = new DatabaseSync(path.join(dataDir(), 'ttm.sqlite'))
   try {
-    const { DatabaseSync } = await import('node:sqlite')
-    const db = new DatabaseSync(path.join(dataDir(), 'ttm.sqlite'))
+    db.exec('PRAGMA journal_mode=WAL; PRAGMA synchronous=NORMAL; PRAGMA busy_timeout=5000')
     db.exec(SCHEMA)
     migrate(db)
-    backend = { kind: 'sqlite', db }
   } catch (err) {
-    // Fallback JSON existe para Node < 22.5 (sem node:sqlite). Qualquer outro
-    // erro (schema/migração) precisa aparecer — nunca trocar de backend mudo.
-    if (err?.code !== 'ERR_UNKNOWN_BUILTIN_MODULE' && !/node:sqlite/.test(err?.message || '')) {
-      process.stderr.write(`ttm: sqlite indisponível (${err.message}) — usando fallback JSON\n`)
-    }
-    const file = path.join(dataDir(), 'ttm-events.json')
-    if (!fs.existsSync(file)) {
-      fs.writeFileSync(file, JSON.stringify({ nextId: 1, events: [], kv: {} }, null, 2))
-    }
-    backend = { kind: 'json', file }
+    try { db.close() } catch {}
+    throw new Error(`sqlite falhou ao inicializar/migrar: ${err.message}`)
   }
+  backend = { kind: 'sqlite', db }
   return backend
 }
 
@@ -354,12 +370,22 @@ export async function listRollups({ sinceDay, label } = {}) {
   const b = await getBackend()
   let rows
   if (b.kind === 'sqlite') {
-    rows = b.db.prepare('SELECT * FROM daily_rollups').all()
+    const where = []
+    const params = []
+    if (sinceDay) {
+      where.push('day >= ?')
+      params.push(sinceDay)
+    }
+    if (label) {
+      where.push('label = ?')
+      params.push(label)
+    }
+    rows = b.db.prepare('SELECT * FROM daily_rollups' + (where.length ? ' WHERE ' + where.join(' AND ') : '')).all(...params)
   } else {
     rows = Object.values(readJson(b.file).rollups || {})
   }
-  if (sinceDay) rows = rows.filter(r => r.day >= sinceDay)
-  if (label) rows = rows.filter(r => (r.label || '') === label) // '' interno = sem label; filtro '' não chega aqui (guard truthy)
+  if (b.kind !== 'sqlite' && sinceDay) rows = rows.filter(r => r.day >= sinceDay)
+  if (b.kind !== 'sqlite' && label) rows = rows.filter(r => (r.label || '') === label) // '' interno = sem label; filtro '' não chega aqui (guard truthy)
   return rows
 }
 

package/lib/mcp-server.mjs

@@ -5,11 +5,16 @@
 // OpenCode (opencode.json "mcp"), etc. Garante o daemon do proxy de pé.
 
 import { execFileSync } from 'node:child_process'
+import fs from 'node:fs'
 import path from 'node:path'
 import readline from 'node:readline'
+import { fileURLToPath } from 'node:url'
 import { readConfig } from './config.mjs'
 import { ensureDaemon, daemonHealth, fetchDaemon } from './daemon-client.mjs'
 
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const VERSION = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8')).version
+
 // O servidor MCP roda DENTRO do ambiente do TUI (cwd = projeto do usuário) —
 // é daqui que repo/branch são detectados e viram tags nos traces.
 function detectContext() {
@@ -29,7 +34,7 @@ function detectContext() {
 
 const TICKET_RE = /[A-Z][A-Z0-9]+-\d+/i
 
-const SERVER_INFO = { name: 'token-trace-manager', version: '0.6.0' }
+const SERVER_INFO = { name: 'token-trace-manager', version: VERSION }
 // Negociação (spec): se a versão pedida está na lista, ecoa; senão responde
 // com a nossa mais recente (não é erro — o client decide se desconecta).
 const SUPPORTED_PROTOCOL_VERSIONS = ['2025-11-25', '2025-06-18', '2024-11-05']
@@ -153,6 +158,7 @@ async function callTool(name, args) {
     }
     case 'ttm_set_label': {
       await ensureDaemon()
+      if (!Object.hasOwn(args, 'label')) throw new Error('label é obrigatório; passe string ou null para limpar')
       const r = await fetchDaemon('/api/label', { method: 'POST', body: { label: args.label ?? null } })
       return { defaultLabel: r.defaultLabel }
     }

package/lib/report-data.mjs

@@ -1,6 +1,6 @@
 import { listUsageEvents, listRollups } from './db.mjs'
 
-function sinceToIso(since) {
+export function sinceToIso(since) {
   if (!since || since === 'all') return null
   if (/^\d{4}-\d{2}-\d{2}/.test(since)) return since
   const m = /^(\d+)([dh])$/.exec(since)
@@ -10,6 +10,7 @@ function sinceToIso(since) {
 }
 
 export async function buildReport({ since = '30d', label = null } = {}) {
+  since = since ?? '30d'
   if (label) label = label.toUpperCase() // labels são armazenados em maiúsculas
   const sinceIso = sinceToIso(since)
   const rows = await listUsageEvents({ since: sinceIso, label })

package/lib/setup-snippets.mjs

@@ -21,7 +21,8 @@ export function setupSnippet(tui, cfg) {
   Para desfazer:  ttm unlink claude-code
 
   Manual (sem auto-link): setar ANTHROPIC_BASE_URL=${P}/anthropic
-  (ou ${P}/anthropic/PROJ-123 p/ ticket embutido). Apontar pra host !=
+  (ou ${P}/anthropic/PROJ-123 p/ ticket embutido; para slug descritivo,
+  use ${P}/anthropic/-/meu-slug). Apontar pra host !=
   api.anthropic.com desativa o Remote Control do Claude Code (v2.1.196+).
   Auth continua passando intacta.`,
 
@@ -41,6 +42,7 @@ export function setupSnippet(tui, cfg) {
     wire_api = "responses"
     env_key = "OPENAI_API_KEY"
   (com ticket: base_url = "${P}/openai/PROJ-123/v1")
+  (com slug: base_url = "${P}/openai/-/meu-slug/v1")
   Prefira model_providers a openai_base_url/OPENAI_BASE_URL — há releases do
   Codex com bug que ignora essas formas (issue #16719).`,
 
@@ -59,7 +61,8 @@ export function setupSnippet(tui, cfg) {
         "openai":    { "options": { "baseURL": "${P}/openai/v1" } }
       }
     }
-  (com ticket: "baseURL": "${P}/anthropic/PROJ-123")`,
+  (com ticket: "baseURL": "${P}/anthropic/PROJ-123";
+   com slug: "baseURL": "${P}/anthropic/-/meu-slug")`,
 
     'gemini-cli': `Gemini CLI (Google) — caminho primário: auto-link:
 
@@ -73,7 +76,8 @@ export function setupSnippet(tui, cfg) {
   Manual: env vars (http:// permitido para 127.0.0.1):
     export GEMINI_API_KEY=sua-chave
     export GOOGLE_GEMINI_BASE_URL="${P}/gemini"
-  (com ticket: export GOOGLE_GEMINI_BASE_URL="${P}/gemini/PROJ-123")
+  (com ticket: export GOOGLE_GEMINI_BASE_URL="${P}/gemini/PROJ-123";
+   com slug: export GOOGLE_GEMINI_BASE_URL="${P}/gemini/-/meu-slug")
   Limitação: só o modo API key é rastreável. No login OAuth pessoal o Gemini
   CLI usa o backend interno Code Assist, que essa variável não afeta.`,
 
@@ -178,7 +182,7 @@ export function setupSnippet(tui, cfg) {
     return (
       `TUIs suportados: ${Object.keys(snippets).join(', ')}\n\n` +
       `Uso: ttm setup <tui>\n` +
-      `Padrão geral: aponte a base URL da ferramenta para ${P}/{target}[/{TICKET-123}]\n` +
+      `Padrão geral: aponte a base URL da ferramenta para ${P}/{target}[/{TICKET-123}] ou ${P}/{target}/-/{slug}\n` +
       `targets: ${Object.keys(cfg.targets).join(', ')}`
     )
   }

package/lib/tui-config.mjs

@@ -100,6 +100,20 @@ function tomlTopLevelKey(text, key) {
   return null
 }
 
+function tomlSetTopLevelKey(text, key, value) {
+  const lines = text.split('\n')
+  let firstSection = lines.findIndex(line => /^\s*\[[^\]]+\]\s*$/.test(line))
+  if (firstSection === -1) firstSection = lines.length
+  for (let i = 0; i < firstSection; i++) {
+    if (new RegExp(`^\\s*${key}\\s*=`).test(lines[i])) {
+      lines[i] = `${key} = "${value}"`
+      return lines.join('\n')
+    }
+  }
+  lines.splice(firstSection, 0, `${key} = "${value}"`, '')
+  return lines.join('\n')
+}
+
 function tomlSectionKey(text, section, key) {
   const sections = parseTomlSections(text)
   const s = sections.find(x => x.header === section)
@@ -274,14 +288,14 @@ export function discoverTui(tui, { cwd = process.cwd() } = {}) {
       tui,
       baseUrl: base ?? null,
       source: base ? 'config.toml' : 'default',
-      canWriteBack: Boolean(section),
+      canWriteBack: true,
       writeTarget: p,
       repoWriteTarget: null,
       envVar,
       authEnv,
       protocol: 'openai',
       defaultUpstream: DEFAULT_UPSTREAM[tui],
-      tomlSection: section,
+      tomlSection: section ?? 'model_providers.ttm',
     }
   }
 
@@ -369,6 +383,12 @@ export function writeTuiBaseUrl(tui, newUrl, { writeTarget, cwd = process.cwd()
     } catch {
       txt = `model_provider = "ttm"\n\n[${section}]\nname = "OpenAI via ttm"\nwire_api = "responses"\nenv_key = "OPENAI_API_KEY"\n`
     }
+    if (section === 'model_providers.ttm') {
+      txt = tomlSetTopLevelKey(txt, 'model_provider', 'ttm')
+      txt = tomlSetSectionKey(txt, section, 'name', 'OpenAI via ttm')
+      txt = tomlSetSectionKey(txt, section, 'wire_api', 'responses')
+      txt = tomlSetSectionKey(txt, section, 'env_key', 'OPENAI_API_KEY')
+    }
     txt = tomlSetSectionKey(txt, section, 'base_url', newUrl)
     fs.mkdirSync(path.dirname(writeTarget), { recursive: true })
     fs.writeFileSync(writeTarget, txt)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-trace-manager",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "private": false,
   "type": "module",
   "description": "Proxy local universal de rastreio de tokens de LLM para TUIs de código (Claude Code, Codex, OpenCode, Gemini CLI, Kilo...), com labels por tarefa, dashboard local e auto-link que preserva redirects prévios (z.ai/GLM/...).",