Merge pull request #11 from sonicfieldlabs/agent/germ-v0.5.0

Release GERM 0.5.0 framework integrations

Author: emeisazam

.env.example

@@ -67,7 +67,7 @@ GERM_COSMOAUDITION_URL=http://127.0.0.1:8797
 GERM_COSMOAUDITION_TIMEOUT_SECONDS=20
 GERM_COSMOAUDITION_MAX_RESPONSE_BYTES=2097152
 
-# Write optional MASA 0.1 interoperability sidecars beside Germ's canonical
+# Write optional MASA 0.2 interoperability sidecars beside Germ's canonical
 # lineage metadata. Set to 0 to disable without changing generation behavior.
 GERM_MASA_SIDECARS=1
 

CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.5.0 — Normalized observation and accountable-memory alignment
+
+- Upgraded the Sonic Matter Framework boundary to MASA 0.2.0 and
+  `masa-processing-request` 0.2.0 while retaining GERM's canonical `sound_id`
+  and optional, non-fatal sidecar behavior.
+- Added preferred `cosmo/modulation/v0.2` support with explicit v0.1 frame
+  compatibility. V0.2 frames must carry a local `cosmo/signal-catalog/v0.2`
+  reference and complete signal metadata, finite normalization ranges, a
+  `[0, 1]` output, clamp behavior, and a stated basis before GERM routes them.
+- Added the bounded `/api/signals` bridge and public
+  `GET /cosmoaudition/signals` endpoint, preserving source filtering while
+  keeping all provider acquisition and credentials inside Cosmoaudition.
+- Added a distinct Hydrosphere Field to the backend manifest, dashboard,
+  provenance, and smoke coverage so marine signals are not folded into
+  atmospheric or geological observations.
+- Preserved catalog normalization through mapping receipts and dashboard
+  provenance. The Mapping Loom now declares its second-stage normalized
+  projection instead of leaving source-range metadata attached to a `[0, 1]`
+  value.
+- Raised the Akousma dependency to Earworm 0.7.0 / schema 1.6 and documented
+  Oída 0.10.0, gateway v0.6, Akousmata 0.7.0, and AKOÚŌ 0.9.2. GERM-created
+  sounds remain cultivation records: accountable auditum data is preserved
+  when supplied, never fabricated as a listening report.
+
 ## 0.4.1 — Sonic Matter Framework contract corrections
 
 - Fixed the Cosmoaudition frame bridge to consume the published

CITATION.cff

@@ -5,8 +5,8 @@ authors:
   - family-names: "Isaza"
     given-names: "eme"
     affiliation: "Sonic Field Labs"
-version: "0.4.1"
-date-released: "2026-08-09"
+version: "0.5.0"
+date-released: "2026-08-11"
 license: "MPL-2.0"
 repository-code: "https://github.com/sonicfieldlabs/germ"
 abstract: "germ is a local generative microsound environment whose generated sounds retain prompts, parents, mutations, listening metadata, and Earworm-compatible lineage."

README.md

@@ -8,12 +8,12 @@ listened to, and traced through lineage. A listening from Oída can become a
 prompt or source in GERM; a successful render can become a descendant in
 Akousmata and return to Oída for another listening.
 
-Current release: `0.4.1`.
+Current release: `0.5.0`.
 
 GERM is part of two Sonic Field Labs constellations: it cultivates within
 [The Listening Stack](https://sonicfield.org/stack) and describes its material
 through the [Sonic Matter Framework](#sonic-matter-framework-integration), whose
-protocol boundary is MASA 0.1.0.
+protocol boundary is MASA 0.2.0.
 
 GERM is an independent Sonic Field Labs project. It can use Stable Audio 3
 providers, but it is not an official Stability AI product.
@@ -100,10 +100,10 @@ promising one universal hardware minimum.
 - Micro/Matter modules for grains, cells, swarms, membranes, spectral tissue,
   quanta, microscope analysis, saved matter profiles, biomes, and incubated
   evolution.
-- A separate Cosmoaudition module category with cosmic, Earth, biosphere,
+- A separate Cosmoaudition module category with cosmic, Earth, hydrosphere, biosphere,
   human-machine, relational, event, semantic, uncertainty, archive, mapping,
   and matter-processing modules.
-- Optional MASA 0.1 sidecars for successful generations and Matter Analysis
+- Optional MASA 0.2 sidecars for successful generations and Matter Analysis
   artifacts. Sonic Lineage `sound_id` remains GERM's canonical identity.
 - Wavetable Forge conversion, prompt, mutation, render, import/export, and
   audition routes.
@@ -139,14 +139,14 @@ inside its cultivation graph:
 
 | Component | Version / contract | Boundary in GERM |
 | --- | --- | --- |
-| [MASA](https://github.com/sonicfieldlabs/MASA) | 0.1.0 (MIT) | Optional descriptive JSON sidecars under `output/masa/`, citing the published canonical schema at `masa.sonicfield.org`. They never replace Sonic Lineage or turn a successful render into a failure. |
-| MASA Processing | `masa-processing-request` 0.1.0 | Every Micro module declares a granular or spectral operation in MASA's engine-neutral terms. GERM states the intention and binds no DSP library. |
+| [MASA](https://github.com/sonicfieldlabs/MASA) | 0.2.0 (MIT) | Optional descriptive JSON sidecars under `output/masa/`, citing the published canonical schema at `masa.sonicfield.org`. They never replace Sonic Lineage or turn a successful render into a failure. |
+| MASA Processing | `masa-processing-request` 0.2.0 | Every Micro module declares a granular or spectral operation in MASA's engine-neutral terms. GERM states the intention and binds no DSP library. |
 | GERM Matter Analysis | — | A bounded local analyzer informed by the shared measured / inferred / unavailable distinction; it is not a claim of listening or a fourth framework project. |
-| [Cosmoaudition](https://github.com/sonicfieldlabs/cosmoaudition) | `cosmo/modulation/v0.1` | A loopback-only, response-bounded HTTP bridge reads source status, snapshots, and modulation frames. GERM never contacts observation providers directly. |
+| [Cosmoaudition](https://github.com/sonicfieldlabs/cosmoaudition) | `cosmo/modulation/v0.2` and `cosmo/signal-catalog/v0.2` | A loopback-only, response-bounded HTTP bridge reads source status, canonical signal definitions, snapshots, and modulation frames. GERM retains v0.1 frame compatibility and never contacts observation providers directly. |
 
 ### Micro modules as MASA processing operations
 
-MASA 0.1.0 carries Roads's granular vocabulary as a protocol layer, so a Micro
+MASA 0.2.0 carries Roads's granular vocabulary as a protocol layer, so a Micro
 module can say what it wants done to matter without naming an engine:
 
 | Micro module | Operation | Character |
@@ -176,12 +176,19 @@ GERM routes. It reads the frame's `controls`, never its bare `values` map:
 a value arrives with the decision that produced it, or it does not arrive.
 Out-of-range or structurally invalid controls are withheld with an explicit
 bridge reason. Frame-level `signals` and `sources` travel beside the routes so
-their source, unit, sphere, epistemic status, and temporal character remain
+their source, unit, sphere, epistemic status, temporal character, signal kind,
+and declared normalization remain
 traceable through `signalId`. Withheld routes and emitted absences are reported
 rather than dropped. Server-Sent Events are deliberately not bridged, because
 this bridge is a bounded request/response client; poll `/cosmoaudition/frame`
 instead.
 
+`GET /cosmoaudition/signals` exposes the source-filterable catalog used by
+Cosmoaudition v0.2. GERM validates its finite input ranges, `[0, 1]` output,
+clipping rule, attribution fields, and epistemic axes before using it. The
+Hydrosphere Field selects marine and hydrological observations without folding
+them into the atmospheric/geological Earth field.
+
 ## Listening Stack integration
 
 **Oída hears. GERM cultivates. Akousmata remembers. AKOÚŌ structures. Earworm
@@ -191,10 +198,10 @@ listening, re-listening, sonic memory, and cultivation.
 
 | Component | Version / contract | GERM integration |
 | --- | --- | --- |
-| [OÍDA](https://github.com/sonicfieldlabs/oida) | 0.9.2 / `oida/gateway/v0.5` | Re-listen to generated sound, derive editable prompts, and retain a listening only when requested. |
-| [Earworm](https://github.com/sonicfieldlabs/earworm) | 0.6.1 / akousma spec v1.5 | Export generation context and preserve provenance, lineage, attributable disagreement resolution, and additive revisions. |
-| [Akousmata](https://github.com/sonicfieldlabs/akousmata) | 0.6.1 | Import remembered sound, prompt, or lineage; write successful generations back as child akousmata. |
-| [AKOÚŌ](https://github.com/sonicfieldlabs/akouo) | 0.9.1 / `akouo/v0.9` | Keeps embodied reports distinct from machine inference while structuring evidence permissions, apparatus, temporal passes, and covenants. |
+| [OÍDA](https://github.com/sonicfieldlabs/oida) | 0.10.0 / `oida/gateway/v0.6` | Re-listen to generated sound, derive editable prompts, and retain a listening only when requested. |
+| [Earworm](https://github.com/sonicfieldlabs/earworm) | 0.7.0 / Akousma spec 1.6 / `earworm/auditum/v2` | Preserve accountable listener types, route decisions, honest absence, disagreement, provenance, lineage, and additive revisions without treating them as equivalent. |
+| [Akousmata](https://github.com/sonicfieldlabs/akousmata) | 0.7.0 | Import remembered sound, prompt, or lineage; write successful generations back as child akousmata and retain supplied auditum blocks. |
+| [AKOÚŌ](https://github.com/sonicfieldlabs/akouo) | 0.9.2 / `akouo/v0.9` | Keeps embodied reports distinct from machine inference while structuring evidence permissions, apparatus, temporal passes, and covenants. |
 | [Algophony](https://github.com/sonicfieldlabs/algophony) | 0.5.2 | Can evaluate lineage-bearing generation batches without changing GERM's generation state. |
 | [ORAM](https://github.com/sonicfieldlabs/oram) | 0.4.1 | Uses the local GERM-compatible generation surface for constrained sound summoning and transformation. |
 

apps/macos/script/build_and_run.sh

@@ -6,8 +6,8 @@ APP_NAME="germ"
 EXECUTABLE_NAME="germ-macos"
 BUNDLE_ID="org.sonicfield.germ"
 MIN_SYSTEM_VERSION="13.0"
-MARKETING_VERSION="0.4.1"
-BUNDLE_VERSION="7"
+MARKETING_VERSION="0.5.0"
+BUNDLE_VERSION="8"
 
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 # Keep the runnable bundle where repository users expect to find apps. The

dashboard/static/app.js

@@ -23,7 +23,7 @@ import {
   cosmoauditionUnitFor,
   cosmoauditionPreviousOutput,
   cosmoauditionMappingSignal,
-} from "./cosmoaudition.js?v=20260731-audit-p1";
+} from "./cosmoaudition.js?v=20260811-v02";
 
 /* Appearance preferences -------------------------------------------------
    Oída and germ share the same warm-neutral surface system. Germ keeps one
@@ -3777,6 +3777,7 @@ function modulatorLabel(modulatorType) {
     cosmo_observation: "Observation Source",
     cosmo_cosmic_field: "Cosmic Field",
     cosmo_earth_field: "Earth Field",
+    cosmo_hydrosphere_field: "Hydrosphere Field",
     cosmo_biosphere_field: "Biosphere Field",
     cosmo_human_machine_field: "Human–Machine Field",
     cosmo_relational_index: "Relational Index",
@@ -4314,6 +4315,9 @@ function normalizeModulatorNode(node) {
     cosmo_earth_field: {
       mode: "fixture", latitude: 4.711, longitude: -74.0721, signalId: "", currentValue: null, available: false, status: "not fetched", sphere: "earth",
     },
+    cosmo_hydrosphere_field: {
+      mode: "fixture", latitude: 4.711, longitude: -74.0721, signalId: "", currentValue: null, available: false, status: "not fetched", sphere: "hydrosphere",
+    },
     cosmo_biosphere_field: {
       mode: "fixture", latitude: 4.711, longitude: -74.0721, signalId: "", currentValue: null, available: false, status: "not fetched", sphere: "biosphere",
     },
@@ -4398,7 +4402,7 @@ function normalizeModulatorNode(node) {
 function cosmoauditionNodeProvenance(node) {
   if (!COSMOAUDITION_MODULATOR_TYPES.has(node?.modulatorType)) return null;
   return {
-    contract: "cosmoaudition-germ/v0.1",
+    contract: "cosmoaudition-germ/v0.2",
     module: node.modulatorType,
     mode: node.config?.mode || "fixture",
     generated_at: node.config?.generatedAt || null,
@@ -4409,6 +4413,8 @@ function cosmoauditionNodeProvenance(node) {
     confidence: node.config?.confidence || null,
     epistemic_status: node.config?.epistemicStatus || null,
     temporal_character: node.config?.temporalCharacter || null,
+    signal_kind: node.config?.signalKind || null,
+    normalization: node.config?.normalization || null,
     mapping_decision: node.config?.mappingDecision || null,
     value: node.config?.available === true ? finiteNumberOrNull(node.config?.currentValue) : null,
     available: node.config?.available === true,
@@ -4501,6 +4507,8 @@ async function refreshCosmoauditionNode(nodeId, { archive = false } = {}) {
       confidence: selected?.confidence || null,
       epistemicStatus: selected?.epistemicStatus || null,
       temporalCharacter: selected?.temporalCharacter || null,
+      signalKind: selected?.signalKind || null,
+      normalization: selected?.normalization || null,
       sphere: selected?.sphere || node.config?.sphere || "all",
       observationCount: signals.length,
       archiveId,
@@ -9908,6 +9916,7 @@ function canvasModulatorNodeMarkup(node, selected, style) {
     cosmo_observation: "Project-neutral local observation signal source.",
     cosmo_cosmic_field: "Cosmic observations as bounded control material.",
     cosmo_earth_field: "Atmospheric and geological observations as bounded control material.",
+    cosmo_hydrosphere_field: "Marine and hydrological observations as bounded control material.",
     cosmo_biosphere_field: "Species and biosphere observations as bounded control material.",
     cosmo_human_machine_field: "Human and machine activity as bounded control material.",
     cosmo_relational_index: "Averages available relations without replacing missing values with zero.",

dashboard/static/cosmoaudition.js

@@ -8,6 +8,7 @@ export const COSMOAUDITION_MODULATOR_TYPES = new Set([
   "cosmo_observation",
   "cosmo_cosmic_field",
   "cosmo_earth_field",
+  "cosmo_hydrosphere_field",
   "cosmo_biosphere_field",
   "cosmo_human_machine_field",
   "cosmo_relational_index",
@@ -37,6 +38,7 @@ export function cosmoauditionSignalMatches(modulatorType, signal = {}) {
   const sphere = String(signal.sphere || "").toLowerCase();
   if (modulatorType === "cosmo_cosmic_field") return sphere === "cosmos";
   if (modulatorType === "cosmo_earth_field") return ["atmosphere", "geosphere"].includes(sphere);
+  if (modulatorType === "cosmo_hydrosphere_field") return sphere === "hydrosphere";
   if (modulatorType === "cosmo_biosphere_field") return sphere === "biosphere";
   if (modulatorType === "cosmo_human_machine_field") return ["human", "machine"].includes(sphere);
   return true;
@@ -111,5 +113,12 @@ export function cosmoauditionMappingSignal(selected) {
     value: normalized,
     normalized,
     unit: "normalized",
+    normalization: {
+      method: "linear",
+      inputRange: [0, 1],
+      outputRange: [0, 1],
+      clipping: "clamp",
+      basis: "GERM maps Cosmoaudition's catalog-normalized projection without reinterpreting its source range.",
+    },
   };
 }

dashboard/static/index.html

@@ -748,6 +748,11 @@ <h3>Microsound Modules</h3>
                             <strong class="source-tool-title">Earth Field</strong>
                             <span class="source-tool-desc">Atmospheric and geological signal relations.</span>
                           </button>
+                          <button class="source-tool-card" type="button" title="Hydrosphere Field" aria-label="Add Hydrosphere Field" data-action="canvas-source-option" data-source="modulator" data-modulator="cosmo_hydrosphere_field">
+                            <span class="source-tool-icon"><svg class="source-tool-svg" viewBox="0 0 24 24" aria-hidden="true"><use href="#sourceIconEnvelope"></use></svg></span>
+                            <strong class="source-tool-title">Hydrosphere Field</strong>
+                            <span class="source-tool-desc">Marine and hydrological signal relations.</span>
+                          </button>
                           <button class="source-tool-card" type="button" title="Biosphere Field" aria-label="Add Biosphere Field" data-action="canvas-source-option" data-source="modulator" data-modulator="cosmo_biosphere_field">
                             <span class="source-tool-icon"><svg class="source-tool-svg" viewBox="0 0 24 24" aria-hidden="true"><use href="#sourceIconEcology"></use></svg></span>
                             <strong class="source-tool-title">Biosphere Field</strong>

docs/api_reference.md

@@ -567,12 +567,26 @@ principle.
 
 ## GET /cosmoaudition/sources
 
+## GET /cosmoaudition/signals
+
+Returns the validated `cosmo/signal-catalog/v0.2` definitions, optionally
+filtered by a bounded comma-separated `sources` list. Catalog entries retain
+source, unit, sphere, epistemic status, temporal character, signal kind, and
+the declared normalization method, ranges, clipping rule, and basis.
+
 ## GET /cosmoaudition/snapshot
 
+## GET /cosmoaudition/modulation
+
+## GET /cosmoaudition/frame
+
 Proxies the corresponding allowlisted Cosmoaudition route through a bounded,
 no-redirect local bridge. Query parameters are `mode=fixture|live`, optional
-`lat`, `lon`, and a bounded comma-separated `sources` list. Bridge failures
-return `available: false` as explicit state rather than fabricated signals.
+`lat`, `lon`, and a bounded comma-separated `sources` list where supported.
+The frame endpoint accepts Cosmoaudition v0.2 and the prior v0.1 contract;
+v0.2 signal metadata and normalization are validated before route resolution.
+Bridge failures return `available: false` as explicit state rather than
+fabricated signals.
 
 ## POST /cosmoaudition/map