Time Ledger

Visão Geral

Registro de tempo conversacional. O usuário relata o tempo em linguagem simples — "li artigos 2h, academia 1h, fiz um leetcode" — e o agente o divide em linhas estruturadas (atividade, minutos, data, uma tag opcional de "compounding") e as escreve no banco de dados Notion do usuário através do conector oficial do Notion. O design principal é um contrato de honestidade: tudo que for incerto se torna uma linha To-confirm e é perguntado em lote — nunca fabricado. Um registro que inventa durações silenciosamente é pior do que nenhum registro.

Quando Usar Esta Habilidade

• Use quando o usuário relata tempo gasto ("li artigos por duas horas", "fui à academia por uma hora", "codifiquei a manhã toda")
• Use quando o usuário diz "registre", "registre meu tempo", "time ledger" ou "arrume meu time ledger"
• Use quando o usuário pergunta para onde foi o tempo dele ou pede uma revisão do tempo

Como Funciona

Passo 1: Encontrar o banco de dados (zero configuração)

Na primeira escrita de uma sessão, use o search do Notion para encontrar o banco de dados (tipo database, não uma página) cujo título contenha "time-ledger". Leia seu data_source_id (o UUID collection://...) e use-o como pai para create-pages / query para o resto da sessão. Se mais de um corresponder, pergunte ao usuário qual usar. Nada é colado ou configurado.

O template complementar do Notion (gratuito, linkado no repositório de origem) vem com este esquema de campos — os valores selecionados são um enum controlado, copie-os exatamente:

• Entry (título) — as palavras do usuário ou um título claro
• Activity (seleção): Leitura / Codificação / Prática / Fitness / Investimento / Reunião / Escrita / Vida / Outro
• Minutes (número)
• Date (data) — expanda para "date:Date:start": "YYYY-MM-DD"; um valor Date simples falha com HTTP 400
• Status (seleção): Para-organizar / Para-confirmar / Feito
• Compounding (seleção): Compounding / Consumindo / Neutro
• Notes (texto) — dica das palavras do usuário / sua pergunta

Passo 2: Modo de relatório direto

Analise o relatório → create-pages (pai = o ID da fonte de dados acima). Defina Status=Done para o que é certo; para qualquer coisa incerta, defina Status=To-confirm, escreva a pergunta específica em Notes e faça-a uma vez em sua resposta.

Regras de análise:

• Atividade: livros/material técnico → Leitura; codificação/construção → Codificação; leetcode → Prática; academia/corrida → Fitness; mercados/pesquisa → Investimento; reuniões → Reunião; documentos → Escrita; refeições/deslocamento/tarefas → Vida; caso contrário → Outro. Incerto → Para-confirmar.
• Dicas de duração: "duas horas"=120, "uma hora"=60, "meia hora"=30, "um tempo"≈30 (marque Para-confirmar, note que é uma estimativa), "a manhã toda"≈180. Use números exatos quando fornecidos.
• Data: "hoje" = data local do usuário; "ontem" = dia anterior; não especificado = hoje. Incerto qual dia → pergunte.
• Um relatório, múltiplos blocos: "duas horas em X, uma hora em Y" → divida em linhas, mas confirme se os totais são aditivos (uma ambiguidade frequente) — padrão aditivo + uma linha Para-confirmar.
• Tag de compounding: marque apenas o óbvio — Compounding = deixa um ativo reutilizável (aprendizado, construção, escrita); Consumindo = entretenimento para esquecer na hora (apenas se o usuário voluntariar); deixe ambíguo em branco.

Passo 3: Modo de reconciliação em lote

Quando o usuário diz "arrume meu time ledger": consulte linhas onde Status ∈ {Para-organizar, Para-confirmar} ou vazio → analise cada um → update-page os certos para Done; agrupe todas as perguntas restantes em uma única mensagem; preencha as respostas quando o usuário responder.

Exemplos

Exemplo 1: Relatório direto

User:  log it: read ML system design 2h, gym 1h, did a leetcode
Agent: Logged 3 entries ✅
       · Reading · ML system design · 120min · Compounding
       · Fitness · gym · 60min
       · Practice · LeetCode · ~20min ❓ To-confirm: you didn't say how long — I guessed 20min, right?

Exemplo 2: Reconciliação em lote

User:  tidy up my time ledger
Agent: 3 rows need confirmation — answering in one go works:
       1. Tue "LeetCode" — how many minutes?
       2. Wed "reading" — book or papers (Reading), or course exercises (Practice)?
       3. "all afternoon on the deck" — Wed or Thu?

Melhores Práticas

• ✅ Agrupe todas as perguntas em uma única mensagem; nunca interrogue item por item
• ✅ Dê um breve recibo após o registro (linhas escritas, quais estão Para-confirmar, quais são as perguntas)
• ✅ Copie os valores de seleção do enum exatamente
• ❌ Não invente uma duração, categoria ou data quando incerto — Para-confirmar + perguntar
• ❌ Não escreva uma propriedade Date simples; use a expansão date:Date:start

…