Skip to content

docs(core): document + pin the ×3 cascading-flux weighting (closes #2546) - #2631

Merged
squid-protocol merged 1 commit into
mainfrom
docs/2546-flux-weighting-documented
Sep 1, 2026
Merged

docs(core): document + pin the ×3 cascading-flux weighting (closes #2546)#2631
squid-protocol merged 1 commit into
mainfrom
docs/2546-flux-weighting-documented

Conversation

@squid-protocol

Copy link
Copy Markdown
Owner

Summary

Behavior-preserving resolution of #2546's own ask (half 1: "document it"). No measured number
changes anywhere
— this makes the deliberate ×3 weighting visible, correctly described, and
pinned so it can't drift silently.

The corpus's original description was subtly wrong and is corrected here: the weighting is a
150-character proximity radius per mutation within the same function
(correlate_scoped), not a blanket per-function branch-context toggle — corpus probe functions
were just shorter than the radius. Raw counts were always recoverable
(recorded − 2 × amplified_cascading_flux, surfaced per file in the audit report's
"Contextual Mitigations & Amplifications"); now that's written down.

Changes

  • spatial_correlation.py — full semantics block at Block 6 (The OOM Bomb): scope, the
    recoverable-raw formula, the prism/detector: string-literal shielding is selective by signal family (if/try/open count inside a literal, eval does not) #2535 phantom-trigger caveat, corpus provenance.
  • core/README.md — new "Proximity correlations" table documenting all six silent
    dampener/amplifier pairs (radii, multipliers, telemetry keys — including the ×100
    exfiltration amplifier and ×5 race amplifier no doc mentioned), flux row in detail.
  • tests/core_engine/test_spatial_correlation.py — 5 micro-repro pins: ×3 within radius
    same-function; ×1 with no branch / branch beyond 150 chars / branch across a function
    boundary; multi-mutation accounting with a raw-recovery assertion.

Full core suite 588 passed; audit_check all clear. Zero golden-master impact.

What this deliberately does NOT do

Half 2 — phantom branch context from branch keywords inside unshielded string literals
tripling real nearby mutations — stays with #2535, per the issue. That's where the rosetta
corpus's state_mutation medians (and high_risk_execution/io/doc) actually move.
After this merges, the corpus ledger entry state-flux-branch-weighting gets its semantics
corrected and the per-language tracking issues' state_mutation residuals re-point to #2535
alone.

Cross-repo

🤖 Generated with Claude Code

https://claude.ai/code/session_01BsVATdyMPhUoAUNBKbMUVi

Behavior-preserving resolution of #2546's ask (half 1). The state_mutation
x3 weighting was invisible outside the source and mis-described by the
corpus that discovered it: it is a 150-char proximity radius per mutation
WITHIN the same function (correlate_scoped), not a blanket per-function
branch-context toggle.

- spatial_correlation.py: full semantics comment at Block 6 (scope, the
  recoverable-raw formula via amplified_cascading_flux, the #2535 phantom-
  trigger caveat).
- core/README.md: new "Proximity correlations" table documenting ALL six
  dampener/amplifier pairs (radii, multipliers, telemetry keys) -- the flux
  row in detail.
- tests/core_engine/test_spatial_correlation.py: 5 micro-repro pins --
  x3 within radius same-function; x1 with no branch / beyond 150 chars /
  cross-function; per-mutation accounting with raw-recovery assertion.

No parsing or scoring change: zero golden-master impact. Half 2 (phantom
branch context from unshielded string literals) deliberately remains with
#2535 -- that is where the corpus's state_mutation medians actually move.

Closes #2546

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BsVATdyMPhUoAUNBKbMUVi
@squid-protocol squid-protocol added core-engine Modifications to the central physics and parsing engine documentation Updates to standard operating procedures, guides, or wiki metrics Heuristics, risk exposures, and topological math updates labels Sep 1, 2026
@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

🐦‍⬛ Muninn Security Scan

✅ No security issues found.

🐦‍⬛ Powered by Muninn · Skald Lab

@squid-protocol
squid-protocol merged commit 813f7f5 into main Sep 1, 2026
65 checks passed
@squid-protocol
squid-protocol deleted the docs/2546-flux-weighting-documented branch September 1, 2026 17:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

core-engine Modifications to the central physics and parsing engine documentation Updates to standard operating procedures, guides, or wiki metrics Heuristics, risk exposures, and topological math updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant