NestGate Validation Summary

Content-addressed storage primal v0.5.0 — 12,467+ tests, 22 crates, 16 capability domains, 4 transport surfaces, BLAKE3 dedup, primal.announce, BTSP auth

Status

  • 12,467+ tests passing (682 RPC, 11,785+ across 22 workspace packages), 0 failed, 0 clippy warnings
  • v0.5.0: Unified version across all 21 workspace crates (was 4.7.0-dev internal / 0.1.0 workspace / 2.1.0 binary)
  • 22 workspace packages (nestgate-rpc, nestgate-api, nestgate-core, nestgate-config, nestgate-types, nestgate-storage, nestgate-security, nestgate-zfs, nestgate-cache, nestgate-discovery, nestgate-bin, and 11 more)
  • 16 capability domains registered in capability_registry.toml — storage, content, model, templates, session, audit, nat, beacon, bonding, zfs, health, identity, discovery, lifecycle, auth, btsp
  • 4 transport surfaces with full parity: SemanticRouter, isomorphic IPC (UDS), primary UDS dispatch, HTTP JSON-RPC
  • Content-addressed storage (NG-1): BLAKE3 hash-as-key, automatic dedup, optional encrypt-at-rest, provenance metadata sidecars
  • Content manifests (NG-2): versioned path→hash manifests, atomic deploy via content.promote aliases, index.html path normalization
  • MethodGate adopted: Public/Protected method classification, BTSP auth gating
  • primal.announce: JSON-RPC self-registration with biomeOS Neural API on startup (Wave 43)
  • Wave 47 deployment convergence: --socket PATH CLI flag, health.liveness normalized to {"status":"alive","primal":"nestgate"} across all transports
  • Wave 49 ecosystem tightening: plasmidBin sole binary channel documented, genomeBin terminology evolved, 3 dead fuzz targets removed, notify-plasmidbin.yml active
  • aarch64-musl segfault fix (validated): Replaced aarch64-linux-gnu-gcc linker with ld.lld + link-self-contained=yes; binary built, inspected (static ELF, no dynamic deps), and run under QEMU — no segfault. nucleus-aarch64-mixed-tcp cell unblocked
  • Stale socket cleanup: SocketCleanupGuard (RAII), ctrl_c graceful shutdown, PID sidecars
  • Rust 2024 edition, #![forbid(unsafe_code)], clippy::pedantic + clippy::nursery clean
  • cargo deny check bans passing, pure-Rust crypto (no ring, no OpenSSL)
  • Zero unsafe code, bare #[allow] without reason, TODO/FIXME in committed code

Key Capabilities

DomainMethodsTransport ParityStability
contentput, get, exists, list, publish, resolve, promote, collectionsAll 4stable
storagestore, retrieve, list, delete, retrieve_stream, retrieve_rangeAll 4stable
lifecyclestatusAll 4stable
capabilitieslistAll 4stable
authcheck, mode, peer_infoAll 4stable
identitygetAll 4stable
btspcapabilitiesAll 4stable
modelregister, exists, locate, metadataAll 4provisional
zfspool.list, pool.get, pool.health, dataset.list, dataset.get, snapshot.list, healthAll 4provisional

Shadow Run Readiness (Wave 24 S3)

NestGate is the storage backend for the S3 Content Hosting Shadow (vs GitHub Pages). petalTongue is the HTTP-facing edge.

  • 8 content.* methods on all 4 transports (Session 60)
  • Path normalization in content.resolve: //index.html, /about/about/index.html (Session 66)
  • Timing metadata: resolved_in_ms / retrieved_in_ms for TTFB measurement (Session 66)
  • Provenance: content.put accepts source, pipeline, stored_by; content.get returns all metadata (Session 62)
  • Atomic deploy: content.publish + content.promote for blue-green content deployment

Architecture

Browser → petalTongue :8080 (HTTP edge)
       → nestGate content.resolve (content-addressed storage)
       → BLAKE3 hash verification + optional decrypt
       → inline base64 response with content_type + timing

Consuming Springs

SpringConsumption
neuralSpringWeight persistence via storage.* IPC
airSpringNestGate + Squirrel IPC wired
wetSpringContent storage for pipeline outputs
groundSpringNestGate IPC module in src/ipc/ tree

See Also

  • Primal Catalog on primals.eco
  • capability_registry.toml — machine-readable capability surface
  • CHANGELOG.md — full session history