v0.9.4: cross-ecosystem absorption — pathway learner, manifest discovery, proptest

- is_timeout_likely() + is_application_error(): IpcPhase helpers (sweetGrass)
- OrExit wired into main.rs startup validation (bind address, lifecycle)
- operation_dependencies + cost_estimates in capability.list (Pathway Learner)
- extract_capabilities(): parse partner capability.list (4 formats)
- Manifest discovery: $XDG_RUNTIME_DIR/ecoPrimals/*.json fallback (rhizoCrypt S16)
- Proptest: 4 property-based tests for IpcPhase, extract_rpc_error, DispatchOutcome
- deny.toml wildcards=deny (ecosystem standard)
- NeuralAPI IPC evolved to structured Ipc { phase, message }
- Docs: 123 files, 1221 tests, 90.89% function coverage

Made-with: Cursor

Author: southgate

CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.4] - 2026-03-16
+
+### Added
+- **`is_timeout_likely()`**: IpcPhase helper for timeout detection (sweetGrass alignment).
+- **`is_application_error()`**: IpcPhase helper for JSON-RPC error classification.
+- **`OrExit` wired into main.rs**: Startup validation uses zero-panic `or_exit()` for bind address and lifecycle init.
+- **`operation_dependencies` + `cost_estimates`**: Top-level DAG and cost metadata in `capability.list` for Pathway Learner.
+- **`extract_capabilities()`**: Parse partner primals' `capability.list` responses (4 formats: flat, object, nested, combined).
+- **Manifest discovery**: `$XDG_RUNTIME_DIR/ecoPrimals/*.json` fallback for local primal discovery (rhizoCrypt S16 pattern).
+- **Proptest**: Property-based tests for `IpcPhase`, `extract_rpc_error`, `DispatchOutcome`, JSON-RPC types (4 property tests).
+
+### Changed
+- **`deny.toml wildcards = "deny"`**: Tightened from `"warn"` to match groundSpring/wetSpring/healthSpring standard.
+- **NeuralAPI IPC errors**: `register_with_neural_api()` and `deregister_from_neural_api()` evolved from `Network(format!(...))` to structured `Ipc { phase, message }`.
+- **Attestation provider IPC**: `DiscoveredAttestationProvider::jsonrpc_call()` evolved to structured IPC errors with `extract_rpc_error()`.
+- **Stale "stubbed call" doc**: `waypoint.rs` comment corrected to "requests attestation from the capability registry".
+
+### Metrics
+- Tests: 1,221 passing (up from 1,206)
+- Coverage: 88.74% line / 84.51% region / 90.89% function
+- Clippy: 0 warnings (pedantic + nursery, all features)
+- Doc warnings: 0
+- Unsafe in production: 0
+- Max file size: 955 lines (all 123 files under 1,000)
+- Source files: 123 `.rs` files (up from 122)
+- deny.toml: wildcards = "deny" (ecosystem standard)
+- License: AGPL-3.0-or-later
+
 ## [0.9.3] - 2026-03-16
 
 ### Added
@@ -732,6 +760,7 @@ spine.append(entry)?;
 
 ---
 
+[0.9.4]: https://github.com/ecoPrimals/loamSpine/compare/v0.9.3...v0.9.4
 [0.9.3]: https://github.com/ecoPrimals/loamSpine/compare/v0.9.2...v0.9.3
 [0.9.2]: https://github.com/ecoPrimals/loamSpine/compare/v0.9.1...v0.9.2
 [0.9.1]: https://github.com/ecoPrimals/loamSpine/compare/v0.9.0...v0.9.1

CONTRIBUTING.md

@@ -15,7 +15,7 @@ Thank you for your interest in contributing to LoamSpine! This document provides
 ### Code Quality
 - **Zero Unsafe in Production**: `#![deny(unsafe_code)]` on production code; test modules prefer `temp-env` over raw `unsafe` env mutations, with `#[expect(unsafe_code, reason)]` where needed (migrated from `#[allow(unsafe_code)]`)
 - **Pedantic Linting**: `clippy::pedantic` and `clippy::nursery` must pass
-- **High Coverage**: Aim for 90%+ function coverage (current: 91.03%, 1,206 tests)
+- **High Coverage**: Aim for 90%+ function coverage (current: 90.89%, 1,221 tests)
 - **File Size**: Keep files under 1000 lines; refactor smartly, not just split
 - **Modular Design**: Use domain-specific modules (see `service/` pattern)
 - **Zero-Copy**: Use `bytes::Bytes` for network buffers when possible
@@ -43,7 +43,7 @@ Thank you for your interest in contributing to LoamSpine! This document provides
 # Build
 cargo build
 
-# Test (1,206 tests)
+# Test (1,221 tests)
 cargo test --workspace
 
 # Linting (must pass, zero warnings)
@@ -293,16 +293,16 @@ Look for issues labeled `good-first-issue`:
 
 | Metric | Value |
 |--------|-------|
-| Version | 0.9.3 |
+| Version | 0.9.4 |
 | Edition | 2024 |
-| Tests | 1,206 |
-| Coverage | 91.03% function / 88.91% line (llvm-cov) |
+| Tests | 1,221 |
+| Coverage | 90.89% function / 88.74% line / 84.51% region (llvm-cov) |
 | Max File Size | 955 lines (all < 1000) |
 | Clippy | pedantic + nursery (0 warnings) |
 | Unsafe Code | 0 in production (`#![deny(unsafe_code)]`) |
 | Lint Exceptions | 0 `#[allow]` in production (all `#[expect(reason)]`) |
 | License | AGPL-3.0-or-later |
-| SPDX Headers | All 121 source files |
+| SPDX Headers | All 123 source files |
 | ecoBin | Zero C dependencies (pure Rust) |
 | cargo deny | bans, licenses, sources pass |
 | UniBin | `loamspine server` subcommand |

Cargo.toml

@@ -7,7 +7,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.9.3"
+version = "0.9.4"
 edition = "2024"
 license = "AGPL-3.0-or-later"
 repository = "https://github.com/ecoPrimals/loamSpine"

README.md

@@ -3,9 +3,9 @@
 **Permanence Layer -- Selective Memory & Loam Certificates**
 
 [![License](https://img.shields.io/badge/license-AGPL--3.0--or--later-blue)]()
-[![Version](https://img.shields.io/badge/version-0.9.3-blue)]()
-[![Tests](https://img.shields.io/badge/tests-1%2C206%20passing-brightgreen)]()
-[![Coverage](https://img.shields.io/badge/coverage-91.03%25%20function-brightgreen)]()
+[![Version](https://img.shields.io/badge/version-0.9.4-blue)]()
+[![Tests](https://img.shields.io/badge/tests-1%2C221%20passing-brightgreen)]()
+[![Coverage](https://img.shields.io/badge/coverage-90.89%25%20function-brightgreen)]()
 [![Unsafe](https://img.shields.io/badge/unsafe-ZERO%20production-red)]()
 [![Edition](https://img.shields.io/badge/edition-2024-blue)]()
 [![ecoBin](https://img.shields.io/badge/ecoBin-compliant-green)]()
@@ -167,15 +167,15 @@ LoamSpine discovers services at runtime via **infant discovery** (zero knowledge
 
 | Metric | Value |
 |--------|-------|
-| **Version** | 0.9.3 |
+| **Version** | 0.9.4 |
 | **Edition** | 2024 |
-| **Tests** | 1,206 passing |
-| **Coverage** | 91.03% function / 88.91% line (llvm-cov) |
+| **Tests** | 1,221 passing |
+| **Coverage** | 90.89% function / 88.74% line / 84.51% region (llvm-cov) |
 | **Clippy** | 0 warnings (pedantic + nursery, `-D warnings`) |
 | **Unsafe Code** | 0 in production (`#![deny(unsafe_code)]`) |
 | **Lint Exceptions** | 0 `#[allow]` in production (all `#[expect(reason)]`) |
-| **Max File Size** | 955 lines (all 122 files < 1000) |
-| **Source Files** | 122 `.rs` files across 2 crates + binary |
+| **Max File Size** | 955 lines (all 123 files < 1000) |
+| **Source Files** | 123 `.rs` files across 2 crates + binary |
 | **License** | AGPL-3.0-or-later |
 | **SPDX Headers** | All source files |
 | **ecoBin** | Zero C dependencies (pure Rust) |

STATUS.md

@@ -2,7 +2,7 @@
 
 # Implementation Status
 
-**Current Version**: 0.9.3  
+**Current Version**: 0.9.4  
 **Last Updated**: March 16, 2026
 
 ---
@@ -46,13 +46,13 @@ This document tracks implementation progress against the specification suite in
 
 | Metric | Target | Current |
 |--------|--------|---------|
-| Tests | — | 1,206 |
-| Coverage (llvm-cov) | 90%+ | 88.91% line / 84.61% region / 91.03% function |
+| Tests | — | 1,221 |
+| Coverage (llvm-cov) | 90%+ | 88.74% line / 84.51% region / 90.89% function |
 | `unsafe` in production | 0 | 0 (`#![deny(unsafe_code)]`) |
 | Clippy pedantic+nursery | 0 | 0 |
 | Doc warnings | 0 | 0 |
-| Max file size | < 1000 lines | 955 max (all 122 files under 1000) |
-| Source files | — | 122 `.rs` files |
+| Max file size | < 1000 lines | 955 max (all 123 files under 1000) |
+| Source files | — | 123 `.rs` files |
 | Edition | 2024 | 2024 |
 | `#[allow]` in production | 0 | 0 (all migrated to `#[expect(reason)]`) |
 
@@ -64,12 +64,12 @@ This document tracks implementation progress against the specification suite in
 |----------|--------|-------|
 | UniBin | PASS | `loamspine server`, `capabilities`, `socket` subcommands |
 | ecoBin | PASS | Zero C deps in default features; blake3 `pure` mode; musl cross-compile CI |
-| AGPL-3.0-or-later | PASS | SPDX headers on all 122 source files |
+| AGPL-3.0-or-later | PASS | SPDX headers on all 123 source files |
 | Scyborg license | PASS | `CertificateType::scyborg_license()`, metadata builders, schema constants |
 | Semantic naming | PASS | `{domain}.{operation}` per wateringHole standard |
 | Zero-copy | PASS | `Did` → `Arc<str>`, `Bytes` for payloads, `Cow<'static, str>` for config, zero-alloc JSON-RPC dispatch, `[u8; 24]` stack keys for storage, `entry.clone()` eliminated — `tip_entry()` zero-copy persistence |
 | MockTransport | PASS | `cfg(test|testing)` gated — no mock code in production binary |
-| File size limit | PASS | All 122 files under 1000 lines (max: 955). Certificate service smart-refactored (906 → 380+367+193). |
+| File size limit | PASS | All 123 files under 1000 lines (max: 955). Certificate service smart-refactored (906 → 380+367+193). |
 
 ---
 

WHATS_NEXT.md

@@ -2,7 +2,7 @@
 
 # Development Roadmap
 
-**Current Version**: 0.9.3  
+**Current Version**: 0.9.4  
 **Last Updated**: March 16, 2026
 
 ---
@@ -117,11 +117,25 @@
 
 ---
 
-## v0.9.4 Targets
+## v0.9.4 Completed (March 16, 2026)
+
+- **`is_timeout_likely()` + `is_application_error()`** — IpcPhase helpers matching sweetGrass pattern
+- **`OrExit` wired into main.rs** — Zero-panic startup validation for bind address and lifecycle init
+- **`operation_dependencies` + `cost_estimates`** — Top-level DAG/cost metadata in capability.list for Pathway Learner
+- **`extract_capabilities()`** — Parse partner capability.list responses (4 formats: flat, object, nested, combined)
+- **Manifest discovery** — `$XDG_RUNTIME_DIR/ecoPrimals/*.json` fallback (rhizoCrypt S16 pattern)
+- **Proptest** — 4 property-based tests for IpcPhase, extract_rpc_error, DispatchOutcome
+- **`deny.toml wildcards = "deny"`** — Tightened to match ecosystem standard
+- **NeuralAPI IPC evolution** — Registration/deregistration/attestation evolved to structured `Ipc { phase, message }`
+- **Coverage**: 90.89% function / 88.74% line / 84.51% region (1,221 tests)
+- **Source files**: 122 → 123 (added `discovery/manifest.rs`). All under 1000 lines (max: 955).
+
+---
+
+## v0.9.5 Targets
 
-- **Wire `DispatchOutcome`** into JSON-RPC dispatch (currently defined but not yet used in handler)
-- **Wire `OrExit`** into `main.rs` startup validation
 - **Wire `StreamItem`** into provenance trio pipeline coordination
+- **Wire `DispatchOutcome`** into JSON-RPC server dispatch
 - **90%+ line coverage** — Storage backend error-path tests (redb 73.6%, sled 76.9%, sqlite 77-79%, cli_signer 74.6%)
 - **Signing capability middleware** — Signature verification on RPC layer (capability-discovered)
 - **Showcase demos** — Expand from ~10% to full coverage

bin/loamspine-service/main.rs

@@ -34,6 +34,7 @@ use loam_spine_api::{LoamSpineRpcService, run_jsonrpc_server, run_tarpc_server};
 use loam_spine_core::LoamSpineService;
 use loam_spine_core::config::LoamSpineConfig;
 use loam_spine_core::constants::network;
+use loam_spine_core::error::OrExit;
 use loam_spine_core::service::LifecycleManager;
 use tracing::{error, info};
 
@@ -132,11 +133,14 @@ async fn run_server(
     let service = LoamSpineService::new();
     let config = LoamSpineConfig::default();
     let mut lifecycle = LifecycleManager::new(service.clone(), config);
-    lifecycle.start().await?;
+    lifecycle
+        .start()
+        .await
+        .or_exit("Failed to start lifecycle manager");
 
     let rpc_service = LoamSpineRpcService::new(service);
 
-    let ip: IpAddr = resolved_bind.parse()?;
+    let ip: IpAddr = resolved_bind.parse().or_exit("Invalid bind address");
     let tarpc_addr = SocketAddr::new(ip, resolved_tarpc_port);
     let jsonrpc_addr = SocketAddr::new(ip, resolved_jsonrpc_port);