Relatório de Linha do Tempo

Gere uma análise narrativa abrangente do histórico completo de desenvolvimento de um projeto usando a linha do tempo de memória persistente do claude-mem.

Quando Usar

Use quando os usuários pedirem:

• "Escreva um relatório de linha do tempo"
• "Jornada em [projeto]"
• "Analise meu histórico de projeto"
• "Relatório completo do projeto"
• "Resuma todo o histórico de desenvolvimento"
• "Qual é a história deste projeto?"

Pré-requisitos

O worker do claude-mem deve estar em execução. O projeto deve ter observações do claude-mem registradas.

Resolva a porta do worker (faça isso uma vez no início e reutilize $WORKER_PORT em todas as chamadas curl abaixo):

WORKER_PORT="${CLAUDE_MEM_WORKER_PORT:-$(node -e "const fs=require('fs'),p=require('path'),os=require('os');const uid=(typeof process.getuid==='function'?process.getuid():77);const fallback=String(37700+(uid%100));try{const s=JSON.parse(fs.readFileSync(p.join(os.homedir(),'.claude-mem','settings.json'),'utf-8'));process.stdout.write(String(s.CLAUDE_MEM_WORKER_PORT||fallback));}catch{process.stdout.write(fallback);}" 2>/dev/null)}"

Isso honra o ambiente CLAUDE_MEM_WORKER_PORT, depois ~/.claude-mem/settings.json, e então recorre ao padrão por UID 37700 + (uid % 100) — combinando como o próprio worker escolhe sua porta. Necessário para configurações de várias contas (#2101) e qualquer usuário que tenha substituído a porta padrão (#2103).

Fluxo de Trabalho

Etapa 1: Determinar o Nome do Projeto

Pergunte ao usuário qual projeto analisar se não for óbvio pelo contexto. O nome do projeto é tipicamente o nome do diretório do projeto (por exemplo, "tokyo", "meu-app"). Se o usuário disser "este projeto", use o nome base do diretório de trabalho atual.

Detecção de Worktree: Antes de usar o nome base do diretório, verifique se o diretório atual é um git worktree. Em um worktree, a fonte de dados é o projeto pai, não o diretório do worktree em si. Execute:

git_dir=$(git rev-parse --git-dir 2>/dev/null)
git_common_dir=$(git rev-parse --git-common-dir 2>/dev/null)
if [ "$git_dir" != "$git_common_dir" ]; then
  # We're in a worktree — resolve the parent project name
  parent_project=$(basename "$(dirname "$git_common_dir")")
  echo "Worktree detected. Parent project: $parent_project"
else
  parent_project=$(basename "$PWD")
fi
echo "$parent_project"

Se um worktree for detectado, use $parent_project (o nome base do repositório pai) como o nome do projeto para todas as chamadas de API. Informe o usuário: "Git worktree detectado. Usando o projeto pai '[nome]' como fonte de dados."

Etapa 2: Buscar a Linha do Tempo Completa

Use Bash para buscar a linha do tempo completa da API do worker claude-mem:

curl -s "http://localhost:${WORKER_PORT}/api/context/inject?project=PROJECT_NAME&full=true"

Isso retorna toda a linha do tempo comprimida — cada observação, limite de sessão e resumo em todo o histórico completo do projeto. A resposta é markdown pré-formatado otimizado para consumo de LLM.

Estimativas de tokens: O tamanho da linha do tempo completa depende do histórico do projeto:

• Projeto pequeno (< 1.000 observações): ~20-50K tokens
• Projeto médio (1.000-10.000 observações): ~50-300K tokens
• Projeto grande (10.000-35.000 observações): ~300-750K tokens

Se a resposta estiver vazia ou retornar um erro, o worker pode não estar em execução ou o nome do projeto pode estar incorreto. Tente curl -s "http://localhost:${WORKER_PORT}/api/search?query=*&limit=1" para verificar se o worker está saudável.

Etapa 3: Estimar a Contagem de Tokens

Antes de prosseguir, estime a contagem de tokens da linha do tempo buscada (aproximadamente 1 token por 4 caracteres). Relate isso ao usuário:

Timeline fetched: ~X observations, estimated ~Yk tokens.
This analysis will consume approximately Yk input tokens + ~5-10k output tokens.
Proceed? (y/n)

Aguarde a confirmação do usuário antes de continuar se a linha do tempo exceder 100K tokens.

Etapa 4: Analisar com um Subagente

Implante um Agente (usando a ferramenta Task) com a linha do tempo completa e o seguinte prompt de análise. Passe a linha do tempo COMPLETA como contexto para o agente. O agente também deve ser instruído a consultar o banco de dados SQLite em ~/.claude-mem/claude-mem.db para a seção Token Economics.

Prompt do Agente:

Você é um historiador técnico analisando a linha do tempo completa de desenvolvimento de um projeto de software do sistema de memória persistente do claude-mem. A linha do tempo abaixo contém cada observação, limite de sessão e resumo registrado em todo o histórico do projeto.


…