Ecosistema Pod: arboleda como catálogo, pod como unidad de distribución

Estado: borrador de implementación — seed 0.9.0, ridge 0.2.0, grove ~30 bibliotecas Objetivo: grove como catálogo seleccionado de pods (lib/app/tool/game), pod como equivalente de Rust crate — src o bin por target/profile; seed se resuelve primero en el caché central ~/.seed//usr/local/seed y solo luego en site.

1. Conceptos

• Grove: un índice (seed/docs/book/libs-reference.md:42) de pods con name@x.y.z, kind (lib app tool), capabilities, platforms, interface_hash. No compila; solo enumera.
• 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.
• Resolución: use "pod" → seed.lock (pod@ver sha256 emit) → caché central ~/.seed//usr/local/seed → GET /archive/ab/cd/sha256 (seed-site/src/registry.sd:504).

2. Diseño central ~/.seed (usuario) y /usr/local/seed (sistema, sudo)

• ~/.seed/src/<pod>/<ver>/<sha256>/ — inmutable src (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 en el resumen, como en seed/seed:25).
• ~/.seed/manifest.json + por proyecto seed.lock (pod = "ridge" version = "^0.2" sha256 = "ab12...").
• ~/.seed 700, /usr/local/seed 755 root:staff (install_layout en seed/tools/seed_tooling.py:2333 ya lo hace system → /usr/local/bin etc.; extender a src/bin).

seed install usuario vs sistema

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

3. Control de versiones de caché (libre de conflictos)

• ~/.seed/bin/ridge/0.2.1/ab12/linux-x86_64/debug/ y .../0.3.0/cd34/... coexistir; seed.lock alfileres ver+sha256, LD_LIBRARY_PATH/rpath apunta a lo exacto ver. soname libridge.so.0.2/0.3 evita DT_NEEDED colisiones.
• interface_hash cambios (rowcodec V3 0b114783) → nuevo sha256 → perder y volver a compilar solo los afectados pod.

4. Cadena de herramientas y library_store

• seed build no escribe ./target; library_store registra en ~/.seed/bin/... con la clave pod@ver+target+profile+interface_hash+SEED_CODE_SPLIT.
• debug vs release comparten src pero mantienen bin por separado por profile.

5. Registro seed-site

• archive/ab/cd/<sha256> ya tiene la dirección de contenido (seed-site/src/registry.sd:504), index/<name>.json + catalog.json con interface_hash y yank/deprecated.
• GET /api/toolchain/latest (seed-site/src/main.sd:50) con {"schema":1,"version":"0.9.0","files":{"linux-x86-64":{...}}} + interface_hash.

6. Próximos pasos (2 semanas)

1. determinista seed.lock + seed update
2. final site_db pg (ridge_open → pg_site_db cuando SEED_SITE_USE_PG=1)
3. promote_prod.sh con human-reviewed automático después de translate_i18n.py