RippleLogic is the decision engine inside MathGov: a rights-first, tail-risk-aware, auditable framework for choosing between real-world options when many people, systems, and future consequences are affected. The v9.6.4 release includes the core canon, SGP v4.7.1, ripple.md v2.2, Agent System v9.2, Aligners Sheet v2.5, ProofPack Alpha v0.4, and a pilot localization pack for Nepal, Vietnam, and New Zealand.
RippleLogic helps answer one question: What is the best choice when a decision affects many people, systems, risks, and future outcomes?
A normal decision process asks what is cheapest, fastest, or most beneficial to one actor. RippleLogic first asks what must not be violated, what could go catastrophically wrong, and how the decision ripples through wider systems.
Use the city example opposite to understand the logic before opening any technical workbook.
Read the canon, download the release package, or open the Aligners Sheet only after the basic decision flow is clear.
RippleLogic does not jump straight to "which is cheaper?" It checks:
Estimated time to first understanding: 5–10 minutes. Best first read: Canon.docx, Sections 1–3.
Every decision passes through five levels in strict order. Later scoring cannot rescue an option that fails an earlier rights, risk, or containment gate.
Scoring is performed on a canonical −1 to +1 scale across all 49 cells — 7 union scopes × 7 welfare dimensions. Only options that pass the NCRC, TRC, and Containment gates reach this stage.
| Scope ╲ Dimension | D1 Material | D2 Health | D3 Social | D4 Knowledge | D5 Agency | D6 Meaning | D7 Environment |
|---|---|---|---|---|---|---|---|
| U1 Self | |||||||
| U2 Household | |||||||
| U3 Community | |||||||
| U4 Organization | |||||||
| U5 Polity | |||||||
| U6 Humanity / CMIU | |||||||
| U7 Biosphere |
Each cell scored on [−1, +1]. Aggregate RLS rank derived from weighted sum of admissible-option cells. Workbook: Aligners Sheet v2.5.
Your choices ripple outward through nested scopes of connection. RippleLogic tracks impact across all seven union scopes and optimizes only after rights, risk, and containment constraints are satisfied.
The v9.6.4 line is deliberately bounded. It is strong enough for structured human-supervised Tier-2 pilot preparation, while explicitly refusing overclaims.
These are not failures — they are explicit, integrity-preserving boundaries. Honest scoping is a feature of the framework, not a limitation.
Boundary statement: RippleLogic supports better human decision-making. It does not replace human responsibility, law, legal review, democratic accountability, or local stakeholder participation.
Use GitHub as the source of truth. Convenience ZIPs are packaged for quick access; canonical identity is controlled by release filenames, manifests, and SHA-256 hashes.
Best starting point for most users. Includes the core canon, all companions, ProofPack Alpha, pilot readiness memo, localization template, and all three country starter annexes in one ZIP.
Core v9.6.4 canon and synchronized companion set: SGP v4.7.1, ripple.md v2.2, Agent System v9.2, Aligners Sheet v2.5, release manifests, and SHA-256 checksums.
The public release page, tag v9.6.4_2026-05-01, release notes, all assets, and full source tree. Canonical source of truth for verification.
Use the release manifests and SHA256SUMS to verify exact byte identity of every artifact and avoid stale or unofficial variants. Required step for any pilot deployment.
shasum -a 256 <file>. On Windows: Get-FileHash <file> -Algorithm SHA256. Always verify before deploying in a pilot context.
The current release includes the governing canon, the moral-status interface, the assurance wrapper, the AI/agent-control layer, the workbook companion, and the pilot localization pack.
Defines NCRC, TRC, Containment, RLS, UCI/HOI, the 49-cell welfare matrix, PCC audit structure, PLSS local-scope rules, SGP binding interface, tier boundaries, and non-overclaiming rules.
A conservative protocol for estimating welfare-relevant moral patienthood across biological and artificial substrates. Separates protection, plateau status, raw measurement, and governance authority.
The portable alignment contract for documenting scope, evidence, Decision Notes, contestability, conformance, recourse, and auditability. Wraps deployments without overriding the canon.
Defines how AI agents, assistants, and tool-using systems operate under RippleLogic constraints: hard controls, No External Instructions, operator authentication, permissions, audit logs, security, refusal, and repair.
Spreadsheet companion for training, demonstration, replay, and reviewer walkthroughs. Includes the 49-cell scoring surface. Worked-run exemplar only — not the final production validator.
Includes a Pilot Readiness Memo, Localization Annex Template, and starter annexes for three jurisdictions. Supports bounded supervised Tier-2 pilot preparation only. Not legal approval.
The v9.6.4 release includes starter materials for bounded supervised Tier-2 public-sector testing. Each country annex is intentionally non-exhaustive and requires local legal, policy, technical, translation, and stakeholder review before use.
Starter focus: municipal service redesign, disaster preparedness, public procurement, education, health-service prioritization, and digital-service review. Special attention given to caste dimensions, geographic remoteness, recourse pathway design, and vulnerable group protections.
Starter focus: administrative digitization, public-sector AI procurement, institutional workflow redesign, infrastructure prioritization, and bounded environmental resilience planning. Local legal review controls all operational use of this annex.
Starter focus: local government planning, public procurement, institutional AI governance, infrastructure resilience, environmental planning, and Treaty of Waitangi-sensitive stakeholder mapping where relevant. Legal and tikanga review required.
Reusable template for adapting RippleLogic to any jurisdiction, institution, decision class, reviewer chain, and recourse pathway. Complete this template before any serious pilot use. It defines the minimum required local configuration.
A simple first-use loop before the full canon. Name the decision, list options, identify who is affected, check rights, check worst-case risks, check system effects, choose, record, and review.
Historical releases remain available in the archive. v9.0 and earlier lines are lineage artifacts unless a downstream run explicitly pins to them.
releases/v9.6.4_2026-05-01/ — subdirectories: core, pilot-localization, archives, manifests. Prior lines: v9.5, v9.0, v8.6, v8.5.3, v8.1, v7.4.5.