Marko

Núcleo auditável de um gestor quantitativo pessoal orientado a passivos. A versão 0.3.2 cobre Accounting/Policy, dados ponto-no-tempo, baselines, validação, persistência append-only, ciclos shadow rastreáveis, uma superfície pública estritamente de leitura e empacotamento verificável. O Marko não recomenda nem executa investimentos reais.

Demonstração pública

• Marko Console: React/TypeScript/PWA, somente leitura;
• Marko Read API: FastAPI sob /api/v1, somente GET;
• Neon em gru1: banco exclusivamente sintético, com Neon Auth habilitada.

Os deploys são demonstrativos e usam exclusivamente dados sintéticos. A infraestrutura ter Neon Auth habilitada não equivale a autenticação efetiva da aplicação. Dados financeiros reais continuam proibidos até existir autenticação aplicada ponta a ponta e um IPS privado aprovado.

O desenvolvimento é público. O estado atual, o roadmap, o changelog, o diário de desenvolvimento, as issues e as discussões mostram o que foi concluído, o que falhou e o que vem depois.

Campanha prospectiva (capital virtual)

O protocolo aprovado compara cinco modelos com US$ 10.000 cada, de 14/09/2026 a 14/03/2027, com três benchmarks independentes. Não se somam carteiras alternativas. Cotações e relatórios ficam em repositório operacional privado, sem alterar a demonstração pública.

uv sync --group dev --extra experiment
uv run --frozen --extra experiment python -m marko.experiment run --config config/shadow-usd-2026.toml --state-dir /caminho/privado/state
uv run --frozen --extra experiment python -m marko.experiment verify --config config/shadow-usd-2026.toml --state-dir /caminho/privado/state

O comando exige checkout limpo: o commit e o lock de dependências ficam congelados no manifesto. Há coleta Yahoo/yfinance, calendário NYSE, custos de 5 bps por lado e distribuições em recebíveis não reinvestidos. Recuperação que cruza split não normalizado é bloqueada explicitamente. Nenhuma ordem real é enviada; valor final é marcado a mercado, não lucro realizado.

Orçamento de APIs zero. Regras diárias não são IA; revisores Codex usam a assinatura local quando máquina, autenticação e quota permitem. Propostas de código não são promovidas automaticamente. A rotina remota e seus relatórios não dependem desses pareceres, mas mostram sua ausência.

Desenvolvimento local

uv sync --group dev
uv run pytest
uv run ruff check .
uv run mypy
uv build

uv run marko status
uv run marko fetch-bcb 1178 --start 2026-08-18 --end 2026-08-19 --unit "% a.a."
uv run marko fetch-sidra IPCA --table 1737 --variable 2266 --period "last 1"
uv run marko fetch-tesouro buy_rate --start 2026-08-19 --end 2026-08-19

Persistência opcional:

uv sync --group dev --extra persistence
export MARKO_DATABASE_URL='postgresql://usuario:senha@host/marko'
uv run marko db-migrate
export MARKO_BACKUP_ENCRYPTION_KEY='<chave-base64-de-32-bytes>'
uv run marko backup --private var/private/backup.json
uv run marko backup-verify var/private/backup.json

Console:

cd apps/console
npm ci
npm run typecheck
npm test
npm run build

Mapas

• Handoff completo para GPT Pro
• Contexto do domínio
• Arquitetura
• Roadmap
• Invariantes
• Classificação e fronteira de dados
• Accounting
• Casos dourados contábeis
• Data Gateway
• Portfolio Lab
• Decision Engine
• Persistência e shadow readiness
• Auditoria dos upstreams
• Spikes quantitativos

Os snapshots dos projetos estudados ficam em /home/pedro/repo/marko-references e são fixados por upstreams.lock.json.

Dados pessoais e financeiros reais não pertencem ao repositório. Use MARKO_CASE_PATH ou config/personal-case.local.toml; o arquivo versionado é apenas um exemplo sintético.