Skip to content

Commit f6f24b6

Browse files
author
BiomeOS Developer
committed
V108: deep debt resolution — AGPL-3.0-or-later, barracuda CPU delegation, typed capability discovery
License corrected to AGPL-3.0-or-later (SCYBORG Provenance Trio) across 302 source files, LICENSE, and Cargo.toml. barracuda WelfordState CPU delegation for std_dev and mean_and_std_dev. Tolerance centralization (tol::ANALYTICAL in tests, named geometry constants with provenance). Typed capability-based discovery: discover_by_capability, compute_execute, storage_put/get in biomeos/interaction.rs. Python provenance enrichment (python_version, numpy_version in 29 benchmark JSONs). validate_band_edge evolved to Result-based error handling. V108 handoff crafted for toadStool/barraCuda team. Stale pin references (S96c) updated to S155b across active docs and graphs. V107 handoffs archived; V108 active. 906 tests, 261 Python checks, 0 clippy, 0 fmt diff. Made-with: Cursor
1 parent e5fd028 commit f6f24b6

284 files changed

Lines changed: 1518 additions & 641 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/ci.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# SPDX-License-Identifier: AGPL-3.0-only
1+
# SPDX-License-Identifier: AGPL-3.0-or-later
22
name: CI
33

44
on:

CHANGELOG.md

Lines changed: 36 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,43 @@ All notable changes to groundSpring follow [Keep a Changelog](https://keepachang
44

55
## [Unreleased]
66

7-
### V107 License Alignment + Release Profile + Niche + Tolerance Provenance (Mar 16, 2026)
7+
### V108 Deep Debt + Absorption Evolution (Mar 16, 2026)
8+
9+
#### License Correction
10+
- AGPL-3.0-only → AGPL-3.0-or-later across all 302 source files, LICENSE, Cargo.toml
11+
(SCYBORG Provenance Trio: AGPL-3.0-or-later + ORC + CC-BY-SA 4.0)
12+
13+
#### barraCuda CPU Delegation
14+
- `std_dev` and `mean_and_std_dev` now delegate to `barracuda::stats::welford::WelfordState`
15+
when the `barracuda` feature is enabled (CPU path), with local `welford_population` fallback
16+
17+
#### Tolerance Centralization
18+
- Test assertions in `tissue_anderson/compartments.rs` use `crate::tol::ANALYTICAL`
19+
instead of bare `1e-10` literals
20+
- `tissue_anderson/geometry.rs` on-site energy magic numbers extracted to named constants
21+
with provenance comments
22+
23+
#### Typed Capability-Based Discovery
24+
- New public functions in `biomeos/interaction.rs`: `discover_by_capability`,
25+
`compute_execute`, `storage_put`, `storage_get`
26+
- Runtime-only capability discovery — no compile-time primal knowledge
27+
28+
#### Python Provenance Enrichment
29+
- All 29 benchmark JSONs enriched with `python_version` and `numpy_version` in `_provenance`
30+
31+
#### Validation Binary Evolution
32+
- `validate_band_edge.rs` refactored to Result-based error handling with `BenchResult`
33+
- Determinism check uses `groundspring::tol::DETERMINISM` instead of `f64::EPSILON`
34+
35+
#### Quality Gates
36+
- 906 tests pass, 0 clippy warnings (pedantic+nursery), 0 fmt diff
37+
- License: AGPL-3.0-or-later (SCYBORG trio aligned)
38+
- `cargo doc -D warnings`: 0 warnings
39+
40+
### V107 Release Profile + Niche + Tolerance Provenance (Mar 16, 2026)
841

942
#### License Alignment
10-
- AGPL-3.0-or-later → AGPL-3.0-only (ecosystem standard, 302 files updated)
43+
- AGPL-3.0-only → AGPL-3.0-or-later (SCYBORG Provenance Trio, 302 files)
1144

1245
#### Release Profile Optimization
1346
- `lto = true`, `codegen-units = 1`, `strip = true` in workspace Cargo.toml
@@ -90,7 +123,7 @@ All notable changes to groundSpring follow [Keep a Changelog](https://keepachang
90123
- All test assertions updated to reference `FAMILY_ID`
91124

92125
#### License Alignment
93-
- 143+ files updated from `AGPL-3.0-only` to `AGPL-3.0-only` (scyBorg Provenance Trio Guidance)
126+
- 143+ files updated from `AGPL-3.0-or-later` to `AGPL-3.0-or-later` (scyBorg Provenance Trio Guidance)
94127
- Cargo.toml workspace `license` field, pyproject.toml, README, CONTRIBUTING, binary `version` output, all SPDX headers
95128

96129
#### Documentation Debt

CONTRIBUTING.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Contributing to groundSpring
22

3-
SPDX-License-Identifier: AGPL-3.0-only
3+
SPDX-License-Identifier: AGPL-3.0-or-later
44

55
## Architecture
66

@@ -77,7 +77,7 @@ scripts/ Automation (baselines, benchmarks)
7777

7878
## Constraints
7979

80-
1. **AGPL-3.0-only.** Every source file needs the SPDX header.
80+
1. **AGPL-3.0-or-later.** Every source file needs the SPDX header.
8181
2. **1000 lines max per file.** If a file exceeds this, refactor by responsibility.
8282
3. **No unsafe Rust.** The workspace forbids it at the lint level.
8383
4. **Clippy pedantic + nursery** with zero warnings. `missing_docs` is `deny`.
@@ -97,7 +97,7 @@ scripts/ Automation (baselines, benchmarks)
9797
### Rust
9898

9999
```bash
100-
cargo test --workspace # 906 tests, all PASS (V107)
100+
cargo test --workspace # 906 tests, all PASS (V108)
101101
cargo test --workspace --features biomeos # biomeos tests (NUCLEUS client active)
102102
cargo test --workspace --features barracuda-gpu # GPU dispatch active
103103
cargo clippy --workspace --all-targets -D warnings # zero warnings (pedantic + nursery)
@@ -189,7 +189,7 @@ groundSpring follows the **Write → Absorb → Lean** cycle from hotSpring:
189189
### WGSL Shader Conventions (matching hotSpring)
190190

191191
- Dedicated `.wgsl` files in `metalForge/shaders/` (never inline WGSL in Rust).
192-
- `// SPDX-License-Identifier: AGPL-3.0-only` at top.
192+
- `// SPDX-License-Identifier: AGPL-3.0-or-later` at top.
193193
- `struct Params` for uniforms (u32-aligned with padding).
194194
- `@group(0) @binding(N)` sequential bindings, documented in header.
195195
- `@compute @workgroup_size(64, 1, 1)` standard workgroup size.

CONTROL_EXPERIMENT_STATUS.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# groundSpring — Control Experiment Status
22

3-
**Last updated**: March 16, 2026 (V107 — 906 tests, 0 clippy, 0 fmt diff, license AGPL-3.0-only, release profile optimization, niche.rs OperationDeps/CostEstimate, tolerance provenance, bare literal elimination, feature-gated spectral constants)
3+
**Last updated**: March 16, 2026 (V108 — 906 tests, 0 clippy, 0 fmt diff, license AGPL-3.0-or-later (SCYBORG trio), barracuda WelfordState CPU delegation, tolerance centralization, typed capability-based discovery, Python provenance enrichment, Result-based validation binaries)
44

55
## Experiment Register
66

@@ -55,7 +55,7 @@
5555
**metalForge mixed-hardware**: `PCIe` topology, pipeline dispatch, NUCLEUS atomics, fallback chains
5656
**metalForge GPU routing**: f64 workloads → Titan V (Volta, 1:2 native f64), f32/quant → RTX 4070 / AKD1000
5757
**Paper 12**: `tissue_anderson` module — 18 unit tests + 29/29 validation checks + 4D Anderson + Wegner RG (V68)
58-
**Handoff**: V107 (license alignment, release profile, niche.rs enrichment, tolerance provenance, bare literal elimination, feature-gated spectral constants) | V106 archived (primal_names, typed BiomeOsError)
58+
**Handoff**: V108 (AGPL-3.0-or-later, barracuda CPU delegation, tolerance centralization, typed capability discovery, provenance enrichment) | V107 archived (release profile, niche.rs, tolerance provenance)
5959

6060
**Python checks**: ~160 across 28 experiments. **Rust validation checks**: 395 (340 core + 55 NUCLEUS). **metalForge + pipeline checks**: 140.
6161

@@ -565,7 +565,7 @@ Each experiment is validated at three hardware tiers:
565565
| **GPU** | `barracuda` feature + GPU adapter | GPU matches CPU within tolerance |
566566
| **metalForge** | Mixed hardware dispatch | Cross-substrate agreement |
567567

568-
### Current Status (V107)
568+
### Current Status (V108)
569569

570570
| # | Experiment | CPU | GPU | metalForge | GPU Status |
571571
|---|-----------|:---:|:---:|:----------:|------------|
@@ -602,7 +602,7 @@ Each experiment is validated at three hardware tiers:
602602

603603
**CPU tier**: 395/395 PASS (34 binaries, complete)
604604
**GPU tier**: 27 of 34 papers have GPU wiring (79%). 102 delegations (61 CPU + 41 GPU). 30/30 metalForge parity.
605-
**V107**: License AGPL-3.0-only, release profile (lto/codegen-units/strip), niche.rs OperationDeps/CostEstimate, tolerance provenance, bare literal elimination, feature-gated spectral constants. **V106**: primal_names module, typed BiomeOsError. **V105**: Exp 023/024 GPU wired (V95). PrecisionRoutingAdvice wired into 11 f64 reduction GPU paths (V96). barraCuda v0.3.5, toadStool S130+, coralReef Iteration 10.
605+
**V107**: License AGPL-3.0-or-later, release profile (lto/codegen-units/strip), niche.rs OperationDeps/CostEstimate, tolerance provenance, bare literal elimination, feature-gated spectral constants. **V106**: primal_names module, typed BiomeOsError. **V105**: Exp 023/024 GPU wired (V95). PrecisionRoutingAdvice wired into 11 f64 reduction GPU paths (V96). barraCuda v0.3.5, toadStool S130+, coralReef Iteration 10.
606606
**metalForge tier**: 30 workloads, 140 checks. Exp 028 NPU 9/9 PASS (AKD1000 DMA). GPU→NPU→CPU pipeline dispatch validated.
607607

608608
### BarraCUDA Integration Status (V105 — toadStool S130+, coralReef Iteration 10)
@@ -695,7 +695,7 @@ Each experiment is validated at three hardware tiers:
695695
| Magic numbers | Extracted to named constants (npu.rs, probe.rs, regression.rs `SINGULARITY_THRESHOLD`) |
696696
| Validation thresholds | All hardcoded thresholds evolved to benchmark JSON with rationale strings |
697697
| SPDX headers | All `.rs` and `.py` files (consistent shebang order in Python) |
698-
| License | AGPL-3.0-only |
698+
| License | AGPL-3.0-or-later |
699699

700700
## Barracuda CPU Delegation (Phase 2a)
701701

@@ -818,10 +818,10 @@ metalForge ─── cross-system: GPU → NPU → CPU pe
818818
| V79: Exp 035 + seismic delegation | 85 delegations (51 CPU + 34 GPU), 807 tests, barraCuda v0.3.3, toadStool S94b | Archived |
819819
| V80: Fused Ops + BarraCuda Catch-Up | 87 delegations (51 CPU + 36 GPU), 812 tests, barraCuda v0.3.3+, toadStool S94b | Archived |
820820
| V81: Modern Rewire + coralReef | 88 delegations (51 CPU + 37 GPU), 812+ tests, barraCuda `0bd401f`, toadStool S94b, coralReef (390 tests), 27/27 cross-spring | Archived |
821-
| V107: License + Release Profile + Niche + Tolerance | 102 delegations (61 CPU + 41 GPU), 906 tests, 39 modules, AGPL-3.0-only (302 files), lto/codegen-units/strip, niche.rs OperationDeps/CostEstimate, tolerance provenance, bare literal elimination, feature-gated spectral constants | **Current** |
821+
| V107: License + Release Profile + Niche + Tolerance | 102 delegations (61 CPU + 41 GPU), 906 tests, 39 modules, AGPL-3.0-or-later (302 files), lto/codegen-units/strip, niche.rs OperationDeps/CostEstimate, tolerance provenance, bare literal elimination, feature-gated spectral constants | **Current** |
822822
| V106: primal_names + Typed BiomeOsError | 102 delegations (61 CPU + 41 GPU), 936 tests, 39 modules, primal_names.rs, typed BiomeOsError enum, zero hardcoded primal strings | Archived |
823823
| V105: Code Evolution + barraCuda/toadStool Absorption | 102 delegations (61 CPU + 41 GPU), 936 tests, 38 modules, deep code evolution, Result-based provenance API, freeze_out submodules, typed tarpc IPC | Archived |
824-
| V104: Deep Debt Resolution + Ecosystem Alignment | 102 delegations (61 CPU + 41 GPU), 936 tests, 30+ named constants with physical provenance, capability-based discovery, AGPL-3.0-only, measurement.* capability surface, zero clippy/doc warnings | Archived |
824+
| V104: Deep Debt Resolution + Ecosystem Alignment | 102 delegations (61 CPU + 41 GPU), 936 tests, 30+ named constants with physical provenance, capability-based discovery, AGPL-3.0-or-later, measurement.* capability surface, zero clippy/doc warnings | Archived |
825825
| V103: Deep Debt Audit + Idiomatic Evolution | 102 delegations (61 CPU + 41 GPU), 936 tests, named constants with provenance, biomeos/interaction extraction, centralized tolerances, zero clippy (pedantic + nursery, all features) | Archived |
826826
| V102: Upstream Rewire (barraCuda v0.3.5, toadStool S130+, coralReef Iter 10) | 102 delegations (61 CPU + 41 GPU), 936 tests, zero API breakage, three-tier parity intact, coralReef f64 sovereign path unlocked | Archived |
827827
| V97: GPU Smoke Test + Three-Tier Parity | 102 delegations (61 CPU + 41 GPU), 936 tests, runtime f64 reduction smoke test, three-tier parity 29/29 at all tiers, 382 Python provenance tests | Archived |

Cargo.toml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# SPDX-License-Identifier: AGPL-3.0-only
1+
# SPDX-License-Identifier: AGPL-3.0-or-later
22
# Copyright (C) 2026 ecoPrimals / Squirrel Team
33

44
[workspace]
@@ -11,7 +11,7 @@ members = [
1111

1212
[workspace.package]
1313
edition = "2024"
14-
license = "AGPL-3.0-only"
14+
license = "AGPL-3.0-or-later"
1515
repository = "https://github.com/ecoPrimals/groundSpring"
1616

1717
[workspace.lints.rust]

LICENSE

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,8 @@ Copyright (C) 2026 ecoPrimals / Squirrel Team
55

66
This program is free software: you can redistribute it and/or modify
77
it under the terms of the GNU Affero General Public License as published
8-
by the Free Software Foundation, version 3 of the License only.
8+
by the Free Software Foundation, either version 3 of the License, or
9+
(at your option) any later version.
910

1011
This program is distributed in the hope that it will be useful,
1112
but WITHOUT ANY WARRANTY; without even the implied warranty of

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# groundSpring — The Dirty Differences
22

3-
**Date**: March 16, 2026 | **License**: AGPL-3.0-only
4-
**Status**: V107 — 39 modules, 35 experiments, 906 Rust tests + 287 Python provenance tests, 395/395 validation checks (340 core + 55 NUCLEUS) + 140 metalForge checks, 102 active barracuda delegations (61 CPU + 41 GPU) — synced against barraCuda v0.3.5, toadStool S130+ (`bfe7977b`), coralReef Iteration 10 (`d29a734`). **Three-tier parity proven**: 29/29 validation binaries PASS at all three tiers. **V107**: License AGPL-3.0-only (302 files), release profile optimization (lto/codegen-units/strip), enriched niche.rs (OperationDeps/CostEstimate), tolerance provenance citations, bare literal elimination, feature-gated spectral constants, 906 tests / 0 clippy / 0 fmt diff. **V106**: `primal_names.rs` centralized primal name constants (wetSpring V119 pattern), `BiomeOsError(String)` → typed enum, biomeOS rewired to `primal_names::*`, zero hardcoded primal strings. **V105**: deep code evolution — `#![deny(clippy::expect_used, clippy::unwrap_used)]` enforced across all 3 crates, `print_provenance_header` evolved to `Result`-returning API with panicking convenience wrapper, `/tmp` hardcoding replaced with `std::env::temp_dir()`, bare tolerance literals extracted to named constants, `freeze_out.rs` (715 LOC) smart-refactored into 4 domain-aligned submodules (curve/grid/chi2/nelder\_mead), typed tarpc IPC client implemented with runtime socket discovery, metalForge node names env-configurable, shared Python tolerance module in `control/common.py`, `et0_methods.py` provenance `"pending"` → `git_commit_hash()`. **V104**: deep-debt resolution — 30+ named constants, capability-based discovery, AGPL-3.0-only, `measurement.*` capability surface. **V103**: named constants, `biomeos/interaction` extraction, `eps::LOG_FLOOR` centralized
3+
**Date**: March 16, 2026 | **License**: AGPL-3.0-or-later
4+
**Status**: V108 — 39 modules, 35 experiments, 906 Rust tests + 287 Python provenance tests, 395/395 validation checks (340 core + 55 NUCLEUS) + 140 metalForge checks, 102 active barracuda delegations (61 CPU + 41 GPU) — synced against barraCuda v0.3.5, toadStool S130+ (`bfe7977b`), coralReef Iteration 10 (`d29a734`). **Three-tier parity proven**: 29/29 validation binaries PASS at all three tiers. **V108**: License corrected to AGPL-3.0-or-later (SCYBORG trio), barracuda WelfordState CPU delegation, tolerance centralization, typed capability-based discovery (`discover_by_capability`, `compute_execute`, `storage_put/get`), Python provenance enrichment (29 benchmarks), Result-based validation binaries. **V107**: Release profile (lto/codegen-units/strip), enriched niche.rs (OperationDeps/CostEstimate), tolerance provenance citations, bare literal elimination, feature-gated spectral constants. **V106**: `primal_names.rs` centralized constants, typed `BiomeOsError` enum, zero hardcoded primal strings. **V105**: `#![deny(clippy::expect_used, clippy::unwrap_used)]`, freeze\_out 4-module refactor, typed tarpc IPC, platform-agnostic paths
55

66
**The gap between what models predict and what instruments measure.**
77

@@ -369,7 +369,7 @@ groundSpring/
369369
├── graphs/ # biomeOS pipeline graphs (deploy, Tower, Node, cross-substrate, validation)
370370
├── niches/ # BYOB niche YAML definitions (groundspring-measurement)
371371
├── .github/workflows/ci.yml # GitHub Actions CI
372-
├── wateringHole/ # Handoff directory (V105 current)
372+
├── wateringHole/ # Handoff directory (V108 current)
373373
├── specs/
374374
│ ├── BARRACUDA_EVOLUTION.md # Module → GPU promotion mapping + PRNG roadmap
375375
│ ├── BARRACUDA_REQUIREMENTS.md # GPU kernel gap analysis
@@ -384,7 +384,7 @@ groundSpring/
384384
├── Cargo.toml # Rust workspace (barracuda feature gate)
385385
├── CONTRIBUTING.md
386386
├── CHANGELOG.md
387-
└── LICENSE # AGPL-3.0-only
387+
└── LICENSE # AGPL-3.0-or-later
388388
```
389389

390390
## Hardware Gate
@@ -403,7 +403,7 @@ Same as all ecoPrimals springs:
403403

404404
## License
405405

406-
AGPL-3.0-only — See [LICENSE](LICENSE)
406+
AGPL-3.0-or-later — See [LICENSE](LICENSE)
407407

408408
---
409409

control/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
# SPDX-License-Identifier: AGPL-3.0-only
1+
# SPDX-License-Identifier: AGPL-3.0-or-later
22
# Copyright (C) 2026 ecoPrimals / Squirrel Team
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
# SPDX-License-Identifier: AGPL-3.0-only
1+
# SPDX-License-Identifier: AGPL-3.0-or-later
22
# Copyright (C) 2026 ecoPrimals / Squirrel Team

control/aggregate_stability/aggregate_stability.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
#!/usr/bin/env python3
2-
# SPDX-License-Identifier: AGPL-3.0-only
2+
# SPDX-License-Identifier: AGPL-3.0-or-later
33
# Copyright (C) 2026 ecoPrimals / Squirrel Team
44
"""
55
groundSpring Experiment 024 — Aggregate Stability Measurement Noise

0 commit comments

Comments
 (0)