Pod Ecosystem: boschetto come catalogo, pod come unità di distribuzione

Stato: bozza di implementazione — seed 0.9.0, ridge 0.2.0, grove ~30 lib Obiettivo: grove come catalogo curato di pods (lib/app/tool/game), pod come Rust crate equivalente — src o bin per target/profile; seed si risolve prima nella cache centrale ~/.seed//usr/local/seed e solo successivamente su site.

1. Concetti

• Grove: un indice (seed/docs/book/libs-reference.md:42) di pods con name@x.y.z, kind (lib app tool), capabilities, platforms, interface_hash. Non compila; elenca solo.
• Pod: name@ver + kind + emit (src lib bin) + target (linux-x86_64 macos-aarch64 * generico) + profile (debug release). src = seed.toml + src/lib.sd + sdi; bin = libPOD.so/a + POD.sdi + build.json.
• Risoluzione: use "pod" → seed.lock (pod@ver sha256 emit) → cache centrale ~/.seed//usr/local/seed → GET /archive/ab/cd/sha256 (seed-site/src/registry.sd:504).

2. Layout centrale ~/.seed (utente) e /usr/local/seed (sistema, sudo)

• ~/.seed/src/<pod>/<ver>/<sha256>/ — immutabile src (seed.toml + src/ + sdi + interface_hash da 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 in il digest, come in seed/seed:25).
• ~/.seed/manifest.json + per progetto seed.lock (pod = "ridge" version = "^0.2" sha256 = "ab12...").
• ~/.seed 700, /usr/local/seed 755 root:staff (install_layout in seed/tools/seed_tooling.py:2333 fa già system → /usr/local/bin ecc.; estendere a src/bin).

seed install utente rispetto al sistema

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

3. Controllo delle versioni della cache (senza conflitti)

• ~/.seed/bin/ridge/0.2.1/ab12/linux-x86_64/debug/ e .../0.3.0/cd34/... coesistere; seed.lock perni ver+sha256, LD_LIBRARY_PATH/rpath punta all'esatto ver. soname libridge.so.0.2/0.3 evita DT_NEEDED collisioni.
• interface_hash cambiamenti (rowcodec V3 0b114783) → nuovo sha256 → perdere e ricompilare solo quelli interessati pod.

4. Catena degli strumenti e library_store

• seed build non scrive ./target; library_store registra in ~/.seed/bin/... digitato da pod@ver+target+profile+interface_hash+SEED_CODE_SPLIT.
• debug e release condividono src ma mantengono bin separato per profile.

5. Registro seed-site

• archive/ab/cd/<sha256> è già indirizzato per contenuto (seed-site/src/registry.sd:504), index/<name>.json + catalog.json con interface_hash e 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. Passi successivi (2 settimane)

1. deterministico seed.lock + seed update
2. finale site_db pg (ridge_open → pg_site_db quando SEED_SITE_USE_PG=1)
3. promote_prod.sh con automatico human-reviewed dopo translate_i18n.py