v2 : conception ultracode + moteur de formules porté en TS

- Blueprint définitif (docs/dev/BLUEPRINT-V2.md + JSON) : panel 4 visions + 3 juges, corpus doctrinal (Mon nom est personne, Une économie du don, SejeteralO), 4 critiques d'intégration, 3 vérificateurs, réparations - Corpus d'intention + lectures brutes archivés - Moteur porté Python→TS pur : threshold (inertie WoT, Smith, ComTech), nuancé 6 niveaux, DSL modeParams — 45 tests vitest, parité croisée vérifiée (Forgeron W=7224 T=120 ⇒ 94) - Contrat de domaine v2 (types/domain.ts) + lexique UI (lexicon.ts) - vitest + idb-keyval en dépendances Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-11 05:59:33 +02:00
parent 172eab4c7c
commit 53d8752e40
17 changed files with 5641 additions and 3 deletions
@@ -0,0 +1,174 @@
+/**
+ * Ported from backend/app/tests/test_threshold.py — every pytest case
+ * exists here with the same expected values. Exact integer expectations
+ * were cross-checked by executing the Python engine (backend/.venv).
+ *
+ * Real-world reference case:
+ *   Vote Engagement Forgeron v2.0.0 (Feb 2026)
+ *   wotSize=7224, votesFor=97, votesAgainst=23, total=120
+ *   params M=50, B=0.1, G=0.2 => threshold=94 => adopted (97 >= 94)
+ */
+import { describe, expect, it } from 'vitest'
+import { smithThreshold, techcommThreshold, wotThreshold } from '../../app/engine/threshold'
+
+// ---------------------------------------------------------------------------
+// WoT threshold: real-world vote Forgeron
+// ---------------------------------------------------------------------------
+
+describe('wotThreshold — Forgeron reference case', () => {
+  it('forgeron vote passes (97 for out of 120 total, wot=7224)', () => {
+    const threshold = wotThreshold(7224, 120, 50, 0.1, 0.2)
+    // With low participation (120/7224 ~ 1.66%), near-unanimity is required.
+    // The historical threshold was 94, and 97 >= 94.
+    expect(97).toBeGreaterThanOrEqual(threshold)
+    // The threshold should be high relative to total votes (inertia effect)
+    expect(threshold).toBeGreaterThan(60)
+  })
+
+  it('forgeron threshold value is in a reasonable range', () => {
+    const threshold = wotThreshold(7224, 120, 50, 0.1, 0.2)
+    // At ~1.66% participation, inertia should push threshold close to 78-95%
+    // of total votes.
+    expect(threshold).toBeGreaterThanOrEqual(80)
+    expect(threshold).toBeLessThanOrEqual(120)
+  })
+
+  it('forgeron threshold is exactly 94 (Python cross-check)', () => {
+    expect(wotThreshold(7224, 120, 50, 0.1, 0.2)).toBe(94)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// WoT threshold: low participation
+// ---------------------------------------------------------------------------
+
+describe('wotThreshold — low participation', () => {
+  it('10 votes out of 7224 requires near-unanimity', () => {
+    const threshold = wotThreshold(7224, 10, 50, 0.1, 0.2)
+    // With participation ratio 10/7224 ~ 0.14%, threshold should be
+    // very close to totalVotes (near-unanimity).
+    expect(threshold).toBeGreaterThanOrEqual(9)
+    expect(threshold).toBeLessThanOrEqual(10)
+    // Python cross-check: exact value
+    expect(threshold).toBe(9)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// WoT threshold: high participation
+// ---------------------------------------------------------------------------
+
+describe('wotThreshold — high participation', () => {
+  it('3000 votes out of 7224 approaches simple majority', () => {
+    const threshold = wotThreshold(7224, 3000, 50, 0.1, 0.2)
+    // With ~42% participation, the inertia factor diminishes.
+    const simpleMajority = Math.ceil(3000 * 0.5)
+    expect(threshold).toBeGreaterThanOrEqual(simpleMajority)
+    // Should be noticeably less than near-unanimity
+    expect(threshold).toBeLessThan(2700)
+    // Python cross-check: exact value
+    expect(threshold).toBe(1742)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// WoT threshold: edge cases
+// ---------------------------------------------------------------------------
+
+describe('wotThreshold — edge cases', () => {
+  it('zero total votes => ceil(C + B^W)', () => {
+    const threshold = wotThreshold(7224, 0, 50, 0.1, 0.2)
+    // B^W = 0.1^7224 is effectively 0
+    const expected = Math.ceil(0.0 + 0.1 ** 7224)
+    expect(threshold).toBe(expected)
+    expect(threshold).toBe(0)
+  })
+
+  it('throws on wotSize = 0', () => {
+    expect(() => wotThreshold(0, 10)).toThrow(/wotSize/)
+  })
+
+  it('throws on negative totalVotes', () => {
+    expect(() => wotThreshold(100, -1)).toThrow(/totalVotes/)
+  })
+
+  it('throws on majorityPct out of range', () => {
+    expect(() => wotThreshold(100, 10, 150)).toThrow(/majorityPct/)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// WoT threshold: Python↔TS parity (values executed from backend/.venv)
+// ---------------------------------------------------------------------------
+
+describe('wotThreshold — Python parity cases', () => {
+  it('T > W (100 wot, 150 votes) => 69', () => {
+    expect(wotThreshold(100, 150, 50, 0.1, 0.2)).toBe(69)
+  })
+
+  it('T = W (full participation) => simple majority 50', () => {
+    expect(wotThreshold(100, 100, 50, 0.1, 0.2)).toBe(50)
+  })
+
+  it('constantBase C=10 on Forgeron numbers => 96', () => {
+    expect(wotThreshold(7224, 120, 50, 0.1, 0.2, 10.0)).toBe(96)
+  })
+
+  it('majorityPct 80 on Forgeron numbers => 110', () => {
+    expect(wotThreshold(7224, 120, 80, 0.1, 0.2)).toBe(110)
+  })
+
+  it('minimal corpus W=1, T=1 => 1', () => {
+    expect(wotThreshold(1, 1, 50, 0.1, 0.2)).toBe(1)
+  })
+
+  it('W=10, T=5 => 3', () => {
+    expect(wotThreshold(10, 5, 50, 0.1, 0.2)).toBe(3)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// Smith threshold
+// ---------------------------------------------------------------------------
+
+describe('smithThreshold — ceil(smithSize ^ S)', () => {
+  it('smithSize=20, exponent=0.1 => ceil(20^0.1) = 2', () => {
+    const result = smithThreshold(20, 0.1)
+    expect(result).toBe(Math.ceil(20 ** 0.1))
+    // 20^0.1 ~ 1.35, ceil => 2
+    expect(result).toBe(2)
+  })
+
+  it('smithSize=1 => ceil(1^0.1) = 1', () => {
+    expect(smithThreshold(1, 0.1)).toBe(1)
+  })
+
+  it('throws on smithSize = 0', () => {
+    expect(() => smithThreshold(0)).toThrow()
+  })
+
+  it('smithSize=1000, exponent=0.5 => 32 (Python cross-check)', () => {
+    expect(smithThreshold(1000, 0.5)).toBe(32)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// TechComm threshold
+// ---------------------------------------------------------------------------
+
+describe('techcommThreshold — ceil(cotecSize ^ T)', () => {
+  it('cotecSize=5, exponent=0.1 => ceil(5^0.1) = 2', () => {
+    const result = techcommThreshold(5, 0.1)
+    expect(result).toBe(Math.ceil(5 ** 0.1))
+    // 5^0.1 ~ 1.175, ceil => 2
+    expect(result).toBe(2)
+  })
+
+  it('cotecSize=1 => 1', () => {
+    expect(techcommThreshold(1, 0.1)).toBe(1)
+  })
+
+  it('throws on cotecSize = 0', () => {
+    expect(() => techcommThreshold(0)).toThrow()
+  })
+})