Obsidian Vault

Kodama Vault (PRIMARY)

• Web: https://vault.kodama.solutions (basic auth: admin / senha pessoal)
• Stack: Astro 6 + Starlight 0.38 (read-only static site)
• Repo GitHub: https://github.com/kodama1/vault
• Local clone: C:\Users\User\kodama-vault\ (origin = GitHub)
• VPS deploy: /home/vault-site/ (clone via SSH deploy key, build Docker)
• Container: vault-site (nginx alpine serving Astro static), porta interna 3002, nginx host proxy + basic auth + LE HTTPS
• MCP: filesystem MCP vault aponta pra C:\Users\User\kodama-vault\

Estrutura repo

.
├── brain/              # CONTEÚDO markdown (single source of truth)
│   ├── projects/{lunacrm,watcha}/
│   ├── agents/
│   ├── memory/         # auto-memory mirror
│   ├── skills/
│   ├── MOC.md          # Map of Content
│   └── Welcome.md
├── site/               # Astro Starlight
│   ├── astro.config.mjs
│   ├── src/content.config.ts
│   ├── scripts/sync-content.mjs   # copia brain/ → src/content/docs/, normaliza frontmatter
│   └── src/styles/custom.css
├── Dockerfile          # multi-stage Node build → nginx alpine
├── docker-compose.yml
├── nginx.conf          # config interna container
└── .github/workflows/deploy.yml   # CI deploy (precisa secrets)

Workflow edita → site atualizado

1. Edita .md em brain/ (qualquer pasta) — local ou via Claude Code
2. Stop hook auto-commita + push pra GitHub (origin)
3. Manual hoje: SSH VPS → cd /home/vault-site && git pull && docker compose up -d --build
4. TODO: GitHub Actions auto-deploy (precisa secrets VPS_HOST/VPS_USER/VPS_SSH_KEY configurados)

Frontmatter convention

• title: (Starlight requer) — sync script normaliza titulo: → title: automático
• Outros campos custom são stripados pelo sync script (Starlight schema é estrito)
• Body markdown preservado integralmente

Notas técnicas

• Astro 6 + Starlight 0.38 estável (versões anteriores tinham bug zod 4 no 404)
• Sync script (site/scripts/sync-content.mjs) roda em prebuild, copia brain → docs
• Pagefind search built-in (Starlight)
• Dark mode auto
• Site é read-only — pra editar mobile, usa GitHub web editor

Substituiu

• SilverBullet (removido — bug treeview, sem editor mobile valia rebuild)
• Obsidian local Documents/Obsidian Vault/ (legacy, não usar mais)