Skip to content

Commit a3c481c

Browse files
BiomeOS Developercursoragent
andcommitted
docs: freshen root docs to Wave 107 state
CONTEXT: 1,533→1,614 tests, 193→199 files, 44→47 methods, add trust methods. CONTRIBUTING: update test count. STATUS/WHATS_NEXT: date to June 10, add Wave 107 ACK entry. CHANGELOG: add BTSP idiomatic evolution (Option<&String>→Option<&str>). KNOWN_ISSUES: date to June 10. sporeprint: date to June 10. cargo clean: 7.0 GiB reclaimed. Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent a57e9e0 commit a3c481c

7 files changed

Lines changed: 16 additions & 9 deletions

File tree

CHANGELOG.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
99

1010
## [0.9.16] - 2026-04-08
1111

12+
### Changed (June 8, 2026 — Idiomatic Evolution)
13+
14+
- **BTSP session key decode**: `Option<&String>``Option<&str>` (last `&String` anti-pattern eliminated). Callers evolved from `.as_ref()` to `.as_deref()`.
15+
1216
### Added (June 8, 2026 — Wave 101: Transport Endpoint Adoption)
1317

1418
- **`TransportEndpoint`**: Local wire-compatible implementation of sourDough's `TransportEndpoint` standard (`#[serde(tag = "transport")]``uds`, `tcp`, `mesh_relay` variants). No cross-primal dependency — the wire format is the contract.

CONTEXT.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -26,12 +26,12 @@ when they need to commit, verify, or query permanent records.
2626
- **Deployment:** musl-static (x86_64 + aarch64), 4.3M stripped — plasmidBin / benchScale ready
2727
- **Communication:** JSON-RPC 2.0 over platform-agnostic IPC (Unix sockets)
2828
- **License:** AGPL-3.0-or-later + ORC + CC-BY-SA-4.0 (scyBorg triple)
29-
- **Tests:** 1,533 (all concurrent, ~3s, zero flaky)
30-
- **Coverage:** 90.92% line / 89.09% branch / 92.92% region
29+
- **Tests:** 1,614 (all concurrent, ~3s, zero flaky)
30+
- **Coverage:** 90.9% line
3131
- **Unsafe:** 0 (`#![forbid(unsafe_code)]`)
3232
- **MSRV:** Rust 2024 edition (1.85+)
3333
- **Version:** 0.9.16
34-
- **Source files:** 193 `.rs` files across 3 workspace crates (`loam-spine-core`, `loam-spine-api`, `loamspine-service`)
34+
- **Source files:** 199 `.rs` files across 3 workspace crates (`loam-spine-core`, `loam-spine-api`, `loamspine-service`)
3535
- **Production crypto adapters:** `JsonRpcCryptoSigner` and `JsonRpcCryptoVerifier` implement the signing capability via JSON-RPC `crypto.sign_ed25519` / `crypto.verify_ed25519` per `CRYPTO_WIRE_CONTRACT.md` (see `crates/loam-spine-core/src/traits/crypto_provider.rs`). `CliSigner` remains the development fallback.
3636

3737
## Key Capabilities (JSON-RPC methods)
@@ -44,14 +44,15 @@ when they need to commit, verify, or query permanent records.
4444
- `anchor.publish`, `anchor.publish_batch`, `anchor.verify` — Public chain anchoring (single + aggregate Merkle batch)
4545
- `proof.generate_inclusion`, `proof.verify_inclusion` — Merkle inclusion proofs
4646
- `bonding.ledger.store`, `bonding.ledger.retrieve`, `bonding.ledger.list` — Ionic bond persistence
47+
- `trust.anchor`, `trust.query`, `trust.event_count` — Cross-gate trust event anchoring
4748
- `btsp.negotiate`, `btsp.capabilities` — BTSP cipher negotiation
4849
- `auth.check`, `auth.mode`, `auth.peer_info` — JH-0 access control
4950
- `lifecycle.status`, `primal.announce` — Lifecycle + self-registration
5051
- `health.check`, `health.liveness`, `health.readiness` — Health probes
5152
- `capabilities.list`, `identity.get` — Capability discovery (Wire Standard L3)
5253
- `tools.list`, `tools.call` — MCP tool discovery and invocation
5354
- `permanence.*` (4) — Legacy naming compat
54-
- **44 methods total** (38 stable, 2 evolving, 4 compat). Storage backends: redb (default) and in-memory.
55+
- **47 methods total** (41 stable, 2 evolving, 4 compat). Storage backends: redb (default) and in-memory.
5556

5657
## What This Does NOT Do
5758

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Thank you for your interest in contributing to LoamSpine! This document provides
1717
### Code Quality
1818
- **Zero Unsafe in Production**: `#![forbid(unsafe_code)]` workspace-wide; test modules use inner/outer function pattern for env injection
1919
- **Pedantic Linting**: `clippy::pedantic` and `clippy::nursery` must pass
20-
- **High Coverage**: Aim for 90%+ line coverage (current: 90.92% line / 92.92% region, 1,533 tests)
20+
- **High Coverage**: Aim for 90%+ line coverage (current: 90.9% line, 1,614 tests)
2121
- **File Size**: Keep files under 1000 lines; refactor smartly, not just split
2222
- **Modular Design**: Use domain-specific modules (see `service/` pattern)
2323
- **Zero-Copy**: Use `bytes::Bytes` for network buffers when possible

KNOWN_ISSUES.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# Known Issues
44

5-
**Last Updated**: May 29, 2026
5+
**Last Updated**: June 10, 2026
66

77
---
88

STATUS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# Implementation Status
44

55
**Current Version**: 0.9.16
6-
**Last Updated**: June 8, 2026
6+
**Last Updated**: June 10, 2026
77

88
---
99

WHATS_NEXT.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,14 @@
33
# Development Roadmap
44

55
**Current Version**: 0.9.16
6-
**Last Updated**: June 8, 2026
6+
**Last Updated**: June 10, 2026
77

88
---
99

1010
## Documentation changelog
1111

12+
- **June 10, 2026****Wave 107 ACK**: No action items for loamSpine. Socket hygiene verified clean (XDG_RUNTIME_DIR, zero `/tmp` violations, `ProtectSystem=strict` compatible). BTSP `Option<&String>``Option<&str>` idiomatic evolution. 1,614 tests, 199 source files.
13+
1214
- **June 8, 2026****Wave 101: Transport Endpoint Adoption**: Local `TransportEndpoint` type (wire-compatible with sourDough canonical standard) in `transport/endpoint.rs`. `TRANSPORT_ENDPOINT` env acceptance wired in `main.rs`. 14 new tests. loamSpine transport status: DONE (LOCAL pattern, no cross-primal deps). 1,614 tests, 199 source files.
1315

1416
- **June 5, 2026****Wave 78 Parity: Capability Registry**: `config/capability_registry.toml` created — 19 domains, 47 operations, 6 consumed capabilities. Machine-readable biomeOS overlay following sweetGrass/biomeOS/petalTongue convention. Wave 78 parity item RESOLVED.

sporeprint/validation-summary.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
+++
22
title = "loamSpine Validation Summary"
33
description = "Permanence ledger — 1,614 tests, 47 JSON-RPC methods, 199 source files, append-only Spines, Loam Certificates (Novel Ferment Transcripts), inclusion proofs, public chain anchoring, aggregate batch anchoring, cross-gate trust ledger IPC, TransportEndpoint adoption, capability_registry.toml"
4-
date = 2026-06-08
4+
date = 2026-06-10
55

66
[taxonomies]
77
primals = ["loamspine"]

0 commit comments

Comments
 (0)