Economy kernel — tokens como recurso contábil

Módulos: platformforge/tokensave/ (index FTS5, budget, packs),
platformforge/economy/ (rtk, caveman, routing, engine),
platformforge/knowledge/ (source registry com freshness) e
platformforge/agents/contextpack.py (packs por escopo de grafo).

Verbos

platformforge knowledge                        # freshness do source registry
platformforge tokens index                     # indexa árvore em .platformforge/index.db
platformforge tokens search "<termo>"          # FTS5
platformforge tokens pack --task "<t>" --input-budget 4000
platformforge tokens delta --since <hash>      # pack incremental p/ follow-up
platformforge tokens stats | tokens ledger     # uso e ledger
platformforge rtk compact --command "cmd" < saida.txt   # spans colapsados
platformforge rtk expand --start S --end E              # lazy expand
platformforge caveman <file> --mode off|lite|full|auto  # compressão lossless
platformforge route '{"task":"...","risk":"low"}'       # TaskSignal → classe
platformforge economy                          # relatório do engine
platformforge agents bench                     # estratégias de rota comparadas (projeção)

Disciplina

• Context pack é byte-bounded (--input-budget) — excedente vira
  truncated, nunca estoura silenciosamente.
• RTK nunca perde dados: spans colapsados restauram via rtk expand.
• Route é recomendação de classe, não enforce — tokens ledger registra a
  escolha real pra calibrar.
• Dedupe é por content hash — mesmo fato observado duas vezes = um slot.
• Pack de agente nunca carrega o repo inteiro: Task → Graph scope → Evidence → ContextPack (budget classes tiny→critical; exaustão vira
  partial, nunca sucesso silencioso).
• Follow-up recebe previous_hash + delta — reuse conta como
  cache_reuse no ledger.