Ecossistema Pod – bosque como catálogo, pod como unidade de distribuição

Status: rascunho de implementação — seed 0.9.0, ridge 0.2.0, grove ~30 bibliotecas Objetivo: grove como um catálogo com curadoria de pods (lib/app/tool/game), pod como Rust equivalente a crate — src ou bin por target/profile; seed é resolvido primeiro no cache central ~/.seed//usr/local/seed e somente depois no site.

1. Conceitos

• Grove: um índice (seed/docs/book/libs-reference.md:42) de pods com name@x.y.z, kind (lib app tool), capabilities, platforms, interface_hash. Não compila; apenas lista.
• Pod: name@ver + kind + emit (src lib bin) + target (linux-x86_64 macos-aarch64 * genérico) + profile (debug release). src = seed.toml + src/lib.sd + sdi; bin = libPOD.so/a + POD.sdi + build.json.
• Resolução: use "pod" → seed.lock (pod@ver sha256 emit) → cache central ~/.seed//usr/local/seed → GET /archive/ab/cd/sha256 (seed-site/src/registry.sd:504).

2. Layout central ~/.seed (usuário) e /usr/local/seed (sistema, sudo)

• ~/.seed/src/<pod>/<ver>/<sha256>/ — src imutável (seed.toml + src/ + sdi + interface_hash de seed/compiler/llvm/src/driver/library_store.c).
• ~/.seed/bin/<pod>/<ver>/<sha256>/<target>/<profile>/ — libPOD.so/a + POD.sdi + build.json (target + profile + interface_hash + SEED_CODE_SPLIT em o resumo, como em seed/seed:25).
• ~/.seed/manifest.json + seed.lock por projeto (pod = "ridge" version = "^0.2" sha256 = "ab12...").
• ~/.seed 700, /usr/local/seed 755 root:staff (install_layout em seed/tools/seed_tooling.py:2333 já faz system → /usr/local/bin etc.; estender para src/bin).

seed install usuário versus sistema

• seed install pod@^0.2[:target] → falha ~/.seed/src → GET /archive/... → compila em ~/.seed/bin/... (central, não ./target).
• sudo seed install pod@^0.2 (EUID==0) → /usr/local/seed/src|bin (install -o root:staff), SUDO_USER preservado para ~/.seed/credentials.toml (seed/compiler/llvm/src/driver/toolchain.c:1681).

3. Versionamento de cache (sem conflitos)

• ~/.seed/bin/ridge/0.2.1/ab12/linux-x86_64/debug/ e .../0.3.0/cd34/... coexistir; seed.lock alfinetes ver+sha256, LD_LIBRARY_PATH/rpath aponta para o exato ver. soname libridge.so.0.2/0.3 evita DT_NEEDED colisões.
• interface_hash mudanças (rowcodec V3 0b114783) → novo sha256 → perder e recompilar apenas os afetados pod.

4. Conjunto de ferramentas e library_store

• seed build não grava ./target; library_store registra em ~/.seed/bin/... codificados por pod@ver+target+profile+interface_hash+SEED_CODE_SPLIT.
• debug contra release compartilhar src mas mantenha-se separado bin por profile.

5. Registro seed-site

• archive/ab/cd/<sha256> já tem endereçamento de conteúdo (seed-site/src/registry.sd:504), index/<name>.json + catalog.json com interface_hash e yank/deprecated.
• GET /api/toolchain/latest (seed-site/src/main.sd:50) com {"schema":1,"version":"0.9.0","files":{"linux-x86-64":{...}}} + interface_hash.

6. Próximas etapas (2 semanas)

1. determinístico seed.lock + seed update
2. final site_db pg (ridge_open → pg_site_db quando SEED_SITE_USE_PG=1)
3. promote_prod.sh com human-reviewed automático após translate_i18n.py