Skip to content

BUTTERFREEZONE.md

Latest commit

 

History

History
465 lines (405 loc) · 33.1 KB

BUTTERFREEZONE.md

File metadata and controls

465 lines (405 loc) · 33.1 KB
Raw

FORGE

FORGE (Feed-Adaptive Oracle & Runtime Generator) is Echelon's feed-native supply side — it turns a structured event stream into prediction-market proposals without human curation. It classifies feeds across five grammar dimensions (cadence, distribution, noise, density, thresholds), selects matching Theatre templates via 13 rule-based matching rules, proposes composed theatres from feed pairs, and emits a versioned ProposalEnvelope (IR). It covers domains where statistical structure in live data is the only reliable classification signal.

Current standing claim ceiling. FORGE can emit a local, content-addressed ConstructAdmissionBundle producer artifact for the narrow BREATH worked path matching the Cycle-113 receiving surface shape — and nothing stronger. The "Release Posture & Claim Ceiling" section below is the authoritative statement and overrides any broader capability implied by the code-map sections (Key Capabilities / Architecture / Interfaces / Module Map). Those sections enumerate what is present in the tree, including legacy / held surfaces from earlier cycles (the ProposalReceipt + ed25519-signing pipeline, the forge-verify CLI, RLMF certificate export, and the ForgeRuntime lifecycle) that are not current product claims.

Key Capabilities

Code map, not a claim ceiling. This section enumerates functions present in the tree — it is a code map, NOT a statement of current product claims. The receipt / ed25519-signing entries (buildReceipt, signReceipt, verifySignature, loadKeyring, getPublicKey, getCodeIdentity, computePolicyHash), the forge-verify CLI, the RLMF certificate export (exportCertificate), and the ForgeRuntime lifecycle are legacy / held surfaces from earlier cycles and are NOT current product claims (0.4.0 scope: no signature production/verification, no certification, no runtime/CLI readiness). canonicalize / sha256 are shared primitives — content-addressing IS in the current ceiling (the bundle digest); their ProposalReceipt use is legacy. The current standing claim is the ConstructAdmissionBundle BREATH producer only — see "Release Posture & Claim Ceiling".

  • classify — 5-dimension feed grammar classifier. Orchestrates all five classifiers and returns a FeedProfile with cadence, distribution, noise, density, and threshold classifications. (src/classifier/feed-grammar.js:34)

  • classifyCadence — Cadence classifier: event_driven / seconds / minutes / hours / multi_cadence / irregular. Uses median inter-event delta, jitter coefficient, and bimodal histogram detection. (src/classifier/cadence.js:129)

  • classifyDistribution — Distribution classifier: bounded_numeric / unbounded_numeric / composite / categorical. Uses bounds, max-growth coefficient, and multimodal histogram analysis. (src/classifier/distribution.js:127)

  • classifyNoise — Noise classifier: spike_driven / steady / mixed / irregular. Uses spike detection, lag-1 autocorrelation, and linear trend t-stat. (src/classifier/noise.js:255)

  • classifyDensity — Density classifier: single_point / single_global_instrument / sparse_network / dense_network / multi_tier. Uses sensor count, coverage metadata, coordinate events, GeoJSON feature count, and multi-tier detection. (src/classifier/density.js:140)

  • classifyThresholds — Threshold classifier: regulatory / physical / statistical / none. Matches histogram breakpoints against EPA AQI, NOAA Kp, and NOAA R regulatory tables. (src/classifier/thresholds.js:199)

  • selectTemplates — Rule-based Theatre template selector. Evaluates all 13 rules against a FeedProfile and returns all fired proposals with confidence scores. Uses greedy matching for duplicate template resolution. (src/selector/template-selector.js:130)

  • evaluateRule — Evaluates a single condition rule against a FeedProfile using dot-path field access and six comparison operators (equals, in, gt, lt, gte, lte). (src/selector/template-selector.js:70)

  • RULES — 13 template selection rules covering three backing specs: 5 TREMOR (seismic), 5 CORONA (space weather), 3 BREATH (air quality). (src/selector/rules.js:35)

  • alignFeeds — Temporal alignment of two event streams within a sliding window. For each event in stream A, finds the nearest event in stream B within ±windowMs. Returns matched pairs only. (src/composer/compose.js:28)

  • detectCausalOrdering — Mean timestamp offset analysis to detect leading/lagging relationship between two aligned feed streams. Returns leader ('A'|'B'|'concurrent') and lag_ms. (src/composer/compose.js:63)

  • proposeComposedTheatre — Three-rule composition engine. Evaluates two classified feeds + their temporal relationship and proposes the Theatre that neither feed would generate alone. Rules: threshold_with_arrival_predictor (bounded + arrival predictor → threshold_gate), co_bounded_divergence (two bounded + concurrent → divergence), cascade_amplifier (spike_driven + bounded → cascade). Returns null if no rule fires. (src/composer/compose.js:118)

  • emitEnvelope — Versioned ProposalEnvelope emitter. Annotates proposals with deterministic proposal_id (SHA-256 dedup key), brier_type, and per-proposal usefulness_score (null when economic filter not invoked). Produces the IR contract consumed by Echelon's admission gate. (src/ir/emit.js:71)

  • computeUsefulness — Scores a Theatre proposal across four dimensions: population_impact, regulatory_relevance, predictability, actionability. Returns a 0–1 composite usefulness score. (src/filter/usefulness.js:113)

  • buildBundle — Evidence bundle constructor: computes quality score, doubt price (uncertainty), settlement assessment, and assembles the full bundle object from a raw feed event. (src/processor/bundles.js:49)

  • getTrustTier / canSettle / validateSettlement — T0–T3 oracle trust enforcement. canSettle returns true only for T0/T1. PurpleAir (T3) enforced as non-settling source. (src/trust/oracle-trust.js:61)

  • exportCertificate (legacy / held — NOT a current product claim) — RLMF training certificate export with Brier score, position history, and calibration bucket. Supports binary and multi-class scoring. (src/rlmf/certificates.js:91)

  • createReplay — Deterministic replay of a recorded feed session. Loads a fixture, replays events with configurable speed, and produces reproducible pipeline output. (src/replay/deterministic.js:84) Legacy receipt / signing / replay-verifier pipeline — code-map only, NOT current product claims (0.4.0 scope: no signature production/verification, no CLI readiness). canonicalize / sha256 are shared primitives whose content-addressing use IS in-ceiling for the bundle digest:

  • buildReceipt — Orchestrates receipt construction: canonicalizes raw input, computes input/output/policy hashes, assembles code identity, and optionally signs. Returns a ProposalReceipt conforming to spec/receipt-v0.json. (src/receipt/receipt-builder.js:24)

  • canonicalize — JCS-subset/v0 canonical JSON serializer. Deterministic key ordering, type-safe value encoding (no undefined, NaN, Infinity). (src/receipt/canonicalize.js)

  • sha256 — SHA-256 hash with sha256: prefix for receipt fields. (src/receipt/hash.js)

  • signReceipt / verifySignature — Ed25519 signing and verification. Fail-closed: throws if no signing key available. Signature format: ed25519: prefixed base64. (src/receipt/sign.js)

  • loadKeyring / getPublicKey — Keyring management for receipt verification. Loads keys/forge-keyring.json. (src/receipt/keyring.js)

  • getCodeIdentity — Returns code identity triple { git_sha, package_lock_sha, node_version } for the receipt builder block. package_lock_sha is null (zero-dep posture). (src/receipt/code-identity.js)

  • computePolicyHash — Hashes the active rule set and regulatory tables to produce the receipt policy.policy_hash field. (src/receipt/policy-hasher.js)

  • forge-verify — Independent replay verifier CLI. Re-runs the pipeline on original input and compares output hash against receipt. Exit codes: 0=MATCH, 1=MISMATCH, 2=ERROR. (bin/forge-verify.js)

  • ForgeConstruct — Top-level construct class. .analyze(fixturePath) runs the classify → select pipeline. (The { receipt: true } ProposalReceipt option and the .getCertificates() RLMF accessor are legacy / held — NOT current product claims.) (src/index.js:37)

Architecture

FORGE follows a linear pipeline: fixture files flow through an ingester, then a 5-dimension classifier, then a rule-based selector that emits Theatre proposals. A parallel processor layer handles evidence bundle construction and trust enforcement. Feed pairs enter the composer for composed Theatre proposals.

Code map, not a claim ceiling. The diagram below traces the full code in the tree, including legacy / held stages. The Receipt Layer (canonicalize → buildReceipt → signReceipt), the forge-verify CLI, ForgeRuntime, and the RLMF nodes are legacy / held surfaces — NOT current product claims (0.4.0 scope: no signature production, no certification, no runtime/CLI readiness). The current standing claim is the ConstructAdmissionBundle BREATH producer only (see "Release Posture & Claim Ceiling"); it is a separate producer path not depicted in this pre-Cycle-002 diagram.

flowchart TD
    input["Fixture / Live Feed"]

    subgraph ingest["Ingester"]
        generic["generic.js — any structured JSON event stream"]
    end

    subgraph classify["Classifier"]
        grammar["feed-grammar.js orchestrates all 5"]
        cadence["cadence"]
        distribution["distribution"]
        noise["noise"]
        density["density"]
        thresholds["thresholds"]
        cadence --> distribution --> noise --> density --> thresholds
    end

    subgraph select["Selector"]
        rules["13 rules × evaluateRule"]
    end

    subgraph compose["Composer"]
        align["alignFeeds"]
        causal["detectCausalOrdering"]
        composed["proposeComposedTheatre"]
        align --> causal --> composed
    end

    subgraph emit["IR Emitter"]
        envelope["emitEnvelope → ProposalEnvelope"]
    end

    subgraph receipt_layer["Receipt Layer"]
        direction LR
        canon["canonicalize"]
        build_r["buildReceipt"]
        sign_r["signReceipt"]
        canon --> build_r --> sign_r
    end

    subgraph process["Processor"]
        bundle["buildBundle"]
        quality["computeQuality"]
        doubt["computeDoubtPrice"]
        settle["assignEvidenceClass"]
        bundle --> quality --> doubt --> settle
    end

    subgraph trust["Trust / Filter"]
        tier["getTrustTier · canSettle"]
        useful["computeUsefulness"]
    end

    subgraph runtime["ForgeRuntime"]
        instantiate["instantiate → theatres"]
        lifecycle["ingestBundle → settle → expire"]
    end

    subgraph rlmf["RLMF"]
        cert["exportCertificate"]
        brier["brierScoreBinary · brierScoreMultiClass"]
    end

    verify["forge-verify CLI"]

    input --> ingest
    ingest -- "events[]" --> classify
    classify -- "FeedProfile" --> select
    classify -- "FeedProfile (×2)" --> compose
    select -- "Proposal[]" --> emit
    compose -- "Proposal" --> emit
    emit -- "ProposalEnvelope" --> receipt_layer
    emit -- "receipt: false" --> runtime
    receipt_layer -- "ProposalReceipt" --> verify
    trust -. "settlement gate" .-> process
    runtime --> process
    process --> rlmf

    style receipt_layer fill:#1a1a2e,stroke:#e94560,color:#fff
    style verify fill:#1a1a2e,stroke:#e94560,color:#fff
    style emit fill:#0f3460,stroke:#16213e,color:#fff
    style trust fill:#533483,stroke:#2b2d42,color:#fff
Loading

Directory structure:

./src
./src/index.js
./src/ingester
./src/ingester/generic.js
./src/classifier
./src/classifier/feed-grammar.js
./src/classifier/cadence.js
./src/classifier/distribution.js
./src/classifier/noise.js
./src/classifier/density.js
./src/classifier/thresholds.js
./src/classifier/data
./src/classifier/data/regulatory-epa-aqi.json
./src/classifier/data/regulatory-noaa-kp.json
./src/classifier/data/regulatory-noaa-r.json
./src/selector
./src/selector/rules.js
./src/selector/template-selector.js
./src/theatres
./src/theatres/threshold-gate.js
./src/theatres/cascade.js
./src/theatres/divergence.js
./src/theatres/regime-shift.js
./src/theatres/anomaly.js
./src/theatres/persistence.js
./src/processor
./src/processor/bundles.js
./src/processor/quality.js
./src/processor/uncertainty.js
./src/processor/settlement.js
./src/trust
./src/trust/oracle-trust.js
./src/trust/adversarial.js
./src/rlmf
./src/rlmf/certificates.js
./src/filter
./src/filter/usefulness.js
./src/composer
./src/composer/compose.js
./src/replay
./src/replay/deterministic.js
./src/ir
./src/ir/emit.js
./src/receipt
./src/receipt/canonicalize.js
./src/receipt/code-identity.js
./src/receipt/hash.js
./src/receipt/keyring.js
./src/receipt/policy-hasher.js
./src/receipt/receipt-builder.js
./src/receipt/sign.js
./src/runtime
./src/runtime/lifecycle.js
./src/adapter
./src/adapter/usgs-live.js
./src/adapter/swpc-live.js
./spec
./bin
./bin/forge-verify.js
./spec/construct.json
./spec/construct.yaml
./spec/proposal-ir.json
./spec/receipt-v0.json
./spec/STABILITY.md
./test
./test/unit
./test/convergence

Interfaces

Construct API

Code map, not a claim ceiling. Rows tagged (legacy) — the ProposalReceipt/signing pipeline (buildReceipt, signReceipt, verifySignature, loadKeyring/getPublicKey, canonicalize), the forge-verify CLI, the RLMF exportCertificate, and ForgeRuntime — are present in the tree but are NOT current product claims (0.4.0 scope: no signature production, no certification, no runtime/CLI readiness). Current standing claim = ConstructAdmissionBundle BREATH producer (see "Release Posture & Claim Ceiling").

Export Type Description
ForgeConstruct Class Main construct. .analyze(fixturePath) → classify → select pipeline. (legacy: .getCertificates() RLMF accessor, { receipt: true } option)
classify Function events[] + options → FeedProfile (5-dimension grammar)
classifyCadence Function events[] → cadence classification
classifyDistribution Function events[] → distribution classification
classifyNoise Function events[] → noise classification
classifyDensity Function events[] → density classification
classifyThresholds Function events[] → threshold classification
selectTemplates Function FeedProfile → Proposal[]
evaluateRule Function FeedProfile + Rule → boolean
RULES Constant 13 template selection rules (TREMOR + CORONA + BREATH)
alignFeeds Function eventsA[] + eventsB[] + windowMs → aligned pairs
detectCausalOrdering Function pairs[] → { leader, lag_ms }
proposeComposedTheatre Function feedProfileA + feedProfileB + alignedPairs + causalOrder → Proposal|null
buildBundle Function rawEvent + config → evidence bundle
computeQuality Function rawEvent → quality score
computeDoubtPrice Function rawEvent → uncertainty model
assignEvidenceClass / canSettleByClass Functions Bundle → evidence class + settlement gate
getTrustTier Function sourceId → 'T0'|'T1'|'T2'|'T3'|'unknown'
canSettle Function tier → boolean (true only for T0/T1)
validateSettlement Function sourceId → { allowed, tier, reason? }
checkAdversarial Function bundle → adversarial detection result
checkChannelConsistency Function bundle → channel consistency result
ECHELON_PROVENANCE_MAP Frozen Constant T0–T3 → provenance + confidence mapping (src/trust/oracle-trust.js)
exportCertificate Function (legacy) theatre + config → RLMF certificate — NOT a current product claim
brierScoreBinary Function (legacy) outcome + probability → Brier score (RLMF convergence tooling)
brierScoreMultiClass Function (legacy) outcome_bucket + distribution → Brier score (RLMF convergence tooling)
computeUsefulness Function proposal + feedProfile → usefulness score (0–1)
emitEnvelope Function feed_id + feed_profile + proposals + options → ProposalEnvelope (IR contract). With receipt: true, returns { envelope, receipt }
buildReceipt Function (legacy) rawInput + envelope + options → ProposalReceipt (spec/receipt-v0.json) — NOT a current product claim
signReceipt Function (legacy) canonicalPayload + privateKeyPem → { signature, key_id } (ed25519) — NOT a current product claim (0.4.0: no signature production)
verifySignature Function (legacy) canonicalPayload + signature + publicKeyPem → boolean — NOT a current product claim
canonicalize Function any JS value → deterministic canonical JSON string (JCS-subset/v0) — shared primitive; content-addressing IS in-ceiling for the bundle digest
loadKeyring / getPublicKey Functions (legacy) Keyring I/O for receipt verification — NOT a current product claim
forge-verify CLI (legacy) node bin/forge-verify.js receipt.json --input input.json → exit 0 (MATCH) / 1 (MISMATCH) / 2 (ERROR) — NOT a current product claim (0.4.0: no CLI readiness)
ForgeRuntime Class (legacy) Theatre lifecycle orchestrator. .instantiate(proposals) → theatre IDs. .ingestBundle() → process evidence. .getCertificates() → RLMF state — NOT a current product claim (0.4.0: no runtime readiness)
createReplay Function fixturePath + options → deterministic replay session
ingest / ingestFile Functions Raw data / file path → events[]
USGSLiveAdapter Class Live USGS seismic feed adapter
classifyUSGSFeed Function feedType → full pipeline on live USGS data

Theatre Templates

Template ID Resolution Brier Type Canonical Use
Threshold Gate threshold_gate binary binary Will metric exceed threshold within window?
Cascade cascade multi_bucket (5) multi_class How many events follow trigger within window?
Divergence divergence binary binary Will source A and B diverge beyond threshold?
Regime Shift regime_shift binary binary Will metric transition from state A to B?
Anomaly anomaly binary binary Will metric deviate beyond σ from baseline?
Persistence persistence binary binary Will condition persist for N consecutive intervals?

Oracle Trust Model

Tier Name Can Settle Brier Discount Canonical Examples
T0 settlement_authority Yes 0% epa_aqs, usgs_reviewed, gfz_kp
T1 official_source Yes 10% airnow, usgs_automatic, swpc_goes
T2 corroboration No — openaq, emsc
T3 signal Never — purpleair, thingspeak

Critical invariant: PurpleAir (T3) may never settle a theatre. Enforced at bundle processing time via canSettle() — not at proposal time.

Module Map

Code map, not a claim ceiling. Rows tagged (legacy) — the ProposalReceipt pipeline (src/receipt/), RLMF export (src/rlmf/), ForgeRuntime (src/runtime/), and the forge-verify CLI (bin/) — enumerate code present in the tree; they are legacy / held, NOT current product claims. Current standing claim = ConstructAdmissionBundle BREATH producer (see "Release Posture & Claim Ceiling"). The ConstructAdmissionBundle producer subsystem (src/bundle/, added Cycle-002) post-dates this map's last full generation and is documented in "Release Posture & Claim Ceiling" rather than here.

Module Files Purpose
src/ingester/ 1 Generic JSON event stream ingester
src/classifier/ 6 + data/ 5-dimension feed grammar (cadence, distribution, noise, density, thresholds + grammar orchestration). Regulatory tables: EPA AQI, NOAA Kp, NOAA R
src/selector/ 2 Rule-based Theatre template selection. 13 rules across 3 backing specs (TREMOR, CORONA, BREATH)
src/theatres/ 6 Theatre template definitions (threshold_gate, cascade, divergence, regime_shift, persistence, anomaly)
src/processor/ 4 Evidence bundle pipeline (quality scoring, doubt pricing, settlement assessment, bundle orchestration)
src/trust/ 2 Oracle trust enforcement (T0–T3 model) + adversarial detection (channel consistency, coordinate drift, peer divergence)
src/rlmf/ 1 (legacy / held — NOT a current product claim) RLMF certificate export (Brier scoring for binary and multi-class, calibration bucket)
src/filter/ 1 Usefulness scoring across four dimensions: population_impact, regulatory_relevance, predictability, actionability
src/composer/ 1 Feed composition: temporal alignment (sliding window), causal ordering (mean offset analysis)
src/replay/ 1 Deterministic replay of recorded feed sessions
src/ir/ 1 Proposal IR envelope emitter — the Echelon integration boundary. (The optional receipt-generation wiring is legacy / held.)
src/receipt/ 7 (legacy / held — NOT a current product claim) ProposalReceipt pipeline: canonicalization (JCS-subset/v0), SHA-256 hashing, policy hashing, code identity, receipt builder, ed25519 signing/verification, keyring management. (canonicalize/sha256 are shared primitives; content-addressing IS in-ceiling for the bundle digest.)
src/runtime/ 1 (legacy / held — NOT a current product claim) ForgeRuntime — theatre lifecycle orchestrator (instantiate, ingest, expire, resolve)
src/adapter/ 2 Live feed adapters (USGS seismic, SWPC space weather)
bin/ 1 (legacy / held — NOT a current product claim) forge-verify — independent replay verifier CLI for ProposalReceipts
spec/ 5 Construct spec, Proposal IR schema, Receipt v0 schema (receipt-v0.json — legacy), stability policy
test/unit/ 36 Unit test suite — 986 tests (node:test, zero dependencies)
test/integration/ 1 (legacy / held) Receipt pipeline E2E tests — round-trip verify for all 3 backing specs
test/convergence/ 3 spec + 5 support Convergence loop: 3 backing specs × raw + anonymized modes (TREMOR, CORONA, BREATH)

Verification

  • Trust Level: L1 — Local
  • 986 unit tests (node --test test/unit/*.spec.js), 1001 total with convergence + integration (npm run test:all: 1001 pass / 0 fail / 267 suites)
  • Zero external dependencies (Node.js 20+ built-in test runner)
  • Regulatory tables: EPA AQI (6 breakpoints), NOAA Kp (9 levels), NOAA R (5 scales)
node --test test/unit/*.spec.js
# ℹ pass 986
# ℹ fail 0

Release Posture & Claim Ceiling

Release: package.json version 0.4.0 (unchanged); latest tag v0.4.0; v0.5.0 absent. Cycle-003 is closed — landed on master (master = origin/master = 3bdc6d5bcec16f781405963dd9dfa334ccb75334). Sprints S06 (classifier robustness) and S07 (structural baseline forecasters) were completed as Cycle-003 deferred carry-forward — implemented, reviewed, audited (both PASS), landed on master, and branch-pruned. M0 ("carry-forward closed") is complete. Cycle-004 planning has not yet started.

Next direction (planning-stage, not yet started). The accepted next direction is Cycle-004 planning for a thin harness, a default-OFF derivation kernel, a selection/census apparatus, pre-registration, and an M3 freeze commit. The Instrument Compiler remains a research north star, not a shipped capability or current product claim. Census execution and candidate-feed data contact are not authorized in Cycle-004.

Proposal IR: envelope ir_version is 0.3.0 — emitted_at renamed to emitted_at_ms (BREAKING, both the IR envelope and the bundle manifest/receipt surfaces) and normalization_trace added (additive, populated producer-provenance array). Bundle manifest ir_version stays 0.2.0 — a separate version domain from the envelope ir_version, by design (no coupling between the two). See spec/STABILITY.md.

Claim ceiling: FORGE can emit a local, content-addressed ConstructAdmissionBundle producer artifact for the narrow BREATH worked path matching the Cycle-113 receiving surface shape — and nothing stronger.

Held gates / non-claims: composed_trust remains reserved / non-emitted / separately gated — no schema key exists, no producer path constructs it (test/unit/composed-trust-do-not-emit.spec.js asserts the non-emission invariant). No populated scoring.* field has shipped. FORGE builds no VerificationReceipt substrate — verification remains Echelon-owned unless a future explicit operator/Tobias ownership decision changes that. The ConstructAdmissionBundle producer makes no Echelon admission, parser-acceptance, certification, or calibration-improvement claim, and produces no signature; it is BREATH-only (no TREMOR/CORONA ConstructAdmissionBundle claim) with no runtime/CLI readiness beyond the producer path itself.

Culture

Naming: FORGE — Feed-Adaptive Oracle & Runtime Generator. Construct names in the Echelon framework describe function, not aspiration.

Principles: The feed is the signal. The market is the measurement. FORGE reads structure from data streams, not semantics — it does not know what a seismic event "means", only that it is spike_driven, unbounded_numeric, and sparse_network. From that grammar, the right Theatre emerges.

Domain metaphor: The Uniswap factory pattern applied to prediction surfaces. Point at any live data feed with a computable ground truth and a meaningful binary or multi-class question, and FORGE finds the Theatre geometry. Domain expertise is encoded once in the rule set; the grammar engine applies it to every new feed automatically.

Convergence loop: FORGE was built against a gradient-based scoring function (TotalScore = TemplateScore + 0.5 × GrammarScore, max 20.5) across three backing specs (TREMOR, CORONA, BREATH). The code exists because the loop converged — not because it was designed top-down.

Quick Start

# No install needed — zero dependencies, Node.js 20+ only
node --test test/unit/*.spec.js          # Run unit tests (986 tests)
node --test test/convergence/*.spec.js   # Run convergence tests
import { ForgeConstruct } from './src/index.js';

const forge = new ForgeConstruct();
const result = await forge.analyze('fixtures/usgs-m4.5-day.json');

console.log(result.proposals);
// [
//   { template: 'threshold_gate', params: { threshold: 5.0, window_hours: 24, ... }, confidence: 0.90 },
//   { template: 'cascade', params: { trigger_threshold: 6.0, bucket_count: 5, ... }, confidence: 0.85 },
//   ...
// ]

console.log(result.feed_profile.cadence.classification);  // 'event_driven'
console.log(result.feed_profile.noise.classification);    // 'spike_driven'
// Feed composition (Loop 5 — composer)
import { alignFeeds, detectCausalOrdering } from './src/index.js';

const pairs = alignFeeds(aqiEvents, windEvents, 300_000);   // ±5 min window
const causal = detectCausalOrdering(pairs);
// { leader: 'B', lag_ms: 3600000 }  → wind leads AQI by ~1h

Manual patch note (2026-07-09). This BUTTERFREEZONE is currently curated by hand, not generated: .claude/scripts/butterfreezone-gen.sh misdetects this repo's project type as framework (it documents the Loa .claude/ scaffolding — skills, personas, loa-hounfour) instead of construct (the FORGE product surface documented above), so its output cannot be used as authority (follow-up: task_cbd4f65a). Two hand passes landed on the cycle-003-carryforward-doc-hygiene slice (see grimoires/loa/a2a/cycle-003/25-cycle-003-carryforward-doc-hygiene-implementation-report.md): pass 1 refreshed version/test/release posture and added "Release Posture & Claim Ceiling"; pass 2 reconciled the older code-map sections against the current claim ceiling.

Reading order for agents: the "Release Posture & Claim Ceiling" section is authoritative and overrides any broader capability implied by the code-map sections (Key Capabilities / Architecture / Interfaces / Module Map). Those sections are a code map of what is in the tree — they include legacy / held surfaces (ProposalReceipt + ed25519 signing, forge-verify CLI, RLMF certificate export, ForgeRuntime lifecycle) that are not current product claims, and they do not yet document the current-claim ConstructAdmissionBundle producer (src/bundle/, added Cycle-002). Some older machine metadata is stale: the ground-truth-meta block below still reflects the last full generator run (1cace7a, 2026-04-11, pre-Cycle-002) and was deliberately left untouched — it does not describe these manual patches and should not be read as current.