Écosystème de pods : bosquet comme catalogue, pod comme unité de distribution

Statut : version préliminaire d'implémentation — seed 0.9.0, ridge 0.2.0, grove ~30 libs Objectif : grove comme un catalogue organisé de pods (lib/app/tool/game), pod comme le Rust crate équivalent - src ou bin par target/profile; seed se résout en premier dans le cache central ~/.seed//usr/local/seed et alors seulement sur le site.

1. Concepts

• Grove: un index (seed/docs/book/libs-reference.md:42) de pods avec name@x.y.z, kind (lib app tool), capabilities, platforms, interface_hash. Il ne compile pas ; il ne fait que lister.
• Possule : name@ver + kind + emit (src lib bin) + target (linux-x86_64 macos-aarch64 * générique) + profile (debug release). src = seed.toml + src/lib.sd + sdi; bin = libPOD.so/a + POD.sdi + build.json.
• Résolution : 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. Disposition centrale ~/.seed (utilisateur) et /usr/local/seed (système, sudo)

• ~/.seed/src/<pod>/<ver>/<sha256>/ — src immuable (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 dans le résumé, comme dans seed/seed:25).
• ~/.seed/manifest.json + par projet seed.lock (pod = "ridge" version = "^0.2" sha256 = "ab12...").
• ~/.seed 700, /usr/local/seed 755 root:staff (install_layout dans seed/tools/seed_tooling.py:2333 fait déjà system → /usr/local/bin etc. ; étendre à src/bin).

seed install utilisateur par rapport au système

• seed install pod@^0.2[:target] → ~/.seed/src manqué → GET /archive/... → se compile en ~/.seed/bin/... (central, pas ./target).
• sudo seed install pod@^0.2 (EUID==0) → /usr/local/seed/src|bin (install -o root:staff), SUDO_USER conservé pour ~/.seed/credentials.toml (seed/compiler/llvm/src/driver/toolchain.c:1681).

3. Gestion des versions du cache (sans conflit)

• ~/.seed/bin/ridge/0.2.1/ab12/linux-x86_64/debug/ et .../0.3.0/cd34/... coexister; seed.lock épingles ver+sha256, LD_LIBRARY_PATH/rpath indique exactement ver. soname libridge.so.0.2/0.3 évite DT_NEEDED collisions.
• interface_hash changements (rowcodec V3 0b114783) → nouveau sha256 → manquer et recompiler uniquement les éléments concernés pod.

4. Chaîne d'outils et library_store

• seed build n'écrit pas ./target; library_store enregistre dans ~/.seed/bin/... saisi par pod@ver+target+profile+interface_hash+SEED_CODE_SPLIT.
• debug et release partagent src mais conservent bin distincts par profile.

5. Registre seed-site

• archive/ab/cd/<sha256> est déjà adressé par contenu (seed-site/src/registry.sd:504), index/<name>.json + catalog.json avec interface_hash et yank/deprecated.
• GET /api/toolchain/latest (seed-site/src/main.sd:50) avec {"schema":1,"version":"0.9.0","files":{"linux-x86-64":{...}}} + interface_hash.

6. Prochaines étapes (2 semaines)

1. déterministe seed.lock + seed update
2. final site_db pg (ridge_open → pg_site_db lorsque SEED_SITE_USE_PG=1)
3. promote_prod.sh avec human-reviewed automatique après translate_i18n.py