docs: fix documentation inconsistencies (issue #291)

- Fix pact-system-spec.md §5.2: Remove misquote of AGENTS.md (pacts do NOT persist)
- Fix pact-system-spec.md §4.2: Update pactBinding note (now resolved in code)
- Fix pact-system-spec.md §8.2/8.3: Correct floor 140/150/200 element tags
- Add pactInterferenceMitigation to AGENTS.md and GAME_BRIEFING.md (15 upgrades)
- Fix GAME_BRIEFING.md §7: Correct Tier 1 armor values and pact times
- Fix GAME_BRIEFING.md §7: Correct Tier 2 armor values and pact times
- Fix GAME_BRIEFING.md §7: Correct Tier 3 pact times
- Fix GAME_BRIEFING.md §7: Correct floor 100 element (sand, not sand+fire+earth)
- Fix AGENTS.md: Update equipment count from 50 to 43
- Fix AGENTS.md: Fix enchantment design time (per stack, not per effect slot)
- Fix GAME_BRIEFING.md §6: Clarify puzzle room frequency (guaranteed per 7th floor)
- Fix GAME_BRIEFING.md §11: Clarify spireKey formula (1 + level × 2)

docs/GAME_BRIEFING.md

@@ -1,7 +1,7 @@
 # Mana-Loop: Comprehensive Game Briefing Document
 
 **Document Version:** 4.0
-**Updated:** Post-refactoring — 22 mana types, 8-tier guardian system, 64 disciplines, 14 prestige upgrades, 43 equipment types, 8 Zustand stores, localStorage-only
+**Updated:** Post-refactoring — 22 mana types, 8-tier guardian system, 64 disciplines, 15 prestige upgrades, 43 equipment types, 8 Zustand stores, localStorage-only
 
 ---
 
@@ -224,7 +224,7 @@ HP = floor(5000 × (floor/10) ^ (1.1 + floor/200))
 | Room Type | Chance | Description |
 |-----------|--------|-------------|
 | **Guardian** | Every 10th floor | Boss encounter |
-| **Puzzle** | 100% on every 7th floor (except guardian floors) | Attunement-themed trial |
+| **Puzzle** | 1 guaranteed room per 7th floor (seeded, except guardian floors) | Attunement-themed trial |
 | **Swarm** | ~12% | 3–7 weak enemies |
 | **Speed** | ~10% | Single enemy with elevated dodge chance |
 | **Combat** | ~68% (default) | Single enemy, normal combat |
@@ -354,51 +354,51 @@ Shadow Glass ↔ Light
 
 | Floor | Name | Element | Armor | Pact Mult | Pact Cost | Pact Time |
 |-------|------|---------|-------|-----------|-----------|-----------|
-| 10 | Ignis Prime | fire | 10% | 1.5× | formula | 2h |
+| 10 | Ignis Prime | fire | 10% | 1.5× | formula | 3h |
 | 20 | Aqua Regia | water | 15% | 1.75× | formula | 4h |
-| 30 | Ventus Rex | air | 20% | 2.0× | formula | 6h |
-| 40 | Terra Firma | earth | 25% | 2.25× | formula | 8h |
-| 50 | Lux Aeterna | light | 30% | 2.5× | formula | 10h |
-| 60 | Umbra Mortis | dark | 35% | 2.75× | formula | 12h |
-| 70 | Mors Ultima | death | 40% | 3.0× | formula | 14h |
-| 80 | Vinculum Arcana | transference | 45% | 3.25× | formula | 16h |
+| 30 | Ventus Rex | air | 18% | 2.0× | formula | 5h |
+| 40 | Terra Firma | earth | 25% | 2.25× | formula | 6h |
+| 50 | Lux Aeterna | light | 20% | 2.5× | formula | 7h |
+| 60 | Umbra Mortis | dark | 22% | 2.75× | formula | 8h |
+| 70 | Mors Ultima | death | 25% | 3.0× | formula | 9h |
+| 80 | Vinculum Arcana | transference | 20% | 3.25× | formula | 10h |
 
 **Tier 1 Formulas:**
 - Pact Cost: `floor(hp × 0.3 + power × 5 + hp × armor × 0.5 + shield × 2 + hp × barrier × 0.3)`
 - Pact Time: `2 + floor(floor / 10)` hours
-- Armor: Starts at 10% on floor 10, increases by 5% per 10th floor
+- Armor: Non-uniform per guardian (see guardian-data.ts for exact values)
 
 #### Tier 2 — Composite Elements (Floors 90–160)
 
 | Floor | Element | Armor | Pact Mult | Pact Cost | Pact Time |
 |-------|---------|-------|-----------|-----------|-----------|
-| 90 | metal | 50% | 3.5× | formula | 18h |
-| 100 | sand+fire+earth | 55% | 3.75× | formula | 20h |
-| 110 | lightning | 60% | 4.0× | formula | 22h |
-| 120 | frost | 65% | 4.25× | formula | 24h |
-| 130 | metal+fire+earth (blackflame) | 70% | 4.5× | formula | 26h |
-| 140 | sand+earth+water (radiantflames) | 75% | 4.75× | formula | 28h |
-| 150 | lightning+fire+air (miasma) | 80% | 5.0× | formula | 30h |
-| 160 | shadowglass | 85% | 5.25× | formula | 32h |
+| 90 | metal | 30% | 3.5× | formula | 11h |
+| 100 | sand | 25% | 3.75× | formula | 12h |
+| 110 | lightning | 22% | 4.0× | formula | 13h |
+| 120 | frost | 28% | 4.25× | formula | 14h |
+| 130 | metal+fire+earth (blackflame) | 32% | 4.5× | formula | 15h |
+| 140 | sand+earth+water (radiantflames) | 25% | 4.75× | formula | 16h |
+| 150 | lightning+fire+air (miasma) | 28% | 5.0× | formula | 17h |
+| 160 | shadowglass | 33% | 5.25× | formula | 18h |
 
 **Tier 2 Formulas:**
 - Pact Cost: Same formula as Tier 1
 - Pact Time: `2 + floor(floor / 10)` hours
-- Armor: Starts at 50% on floor 90, increases by 5% per 10th floor (capped at 90%)
-- Note: Floor 100 guardian element is `sand+fire+earth` (composite components), Floor 140 is `sand+earth+water`, Floor 150 is `lightning+fire+air`
+- Armor: Non-uniform per guardian (see guardian-data.ts for exact values)
+- Note: Floor 100 guardian element is `sand`, Floor 140 is `sand+earth+water`, Floor 150 is `lightning+fire+air`
 
 #### Tier 3 — Exotic Elements (Floors 170–240)
 
 | Floor | Element | Armor | Pact Mult | Pact Cost | Pact Time |
 |-------|---------|-------|-----------|-----------|-----------|
-| 170 | crystal | 35% | 5.5× | formula | 37h |
-| 180 | stellar | 30% | 6.0× | formula | 38h |
-| 190 | void | 35% | 6.5× | formula | 39h |
-| 200 | crystal+stellar+void | 35% | 7.0× | formula | 40h |
-| 210 | soul+time+plasma | 32% | 7.5× | formula | 41h |
-| 220 | plasma | 28% | 8.0× | formula | 42h |
-| 230 | crystal+stellar+void | 40% | 8.5× | formula | 43h |
-| 240 | soul+time+plasma | 42% | 9.0× | formula | 44h |
+| 170 | crystal | 35% | 5.5× | formula | 19h |
+| 180 | stellar | 30% | 6.0× | formula | 20h |
+| 190 | void | 35% | 6.5× | formula | 21h |
+| 200 | crystal+stellar+void | 35% | 7.0× | formula | 22h |
+| 210 | soul+time+plasma | 32% | 7.5× | formula | 23h |
+| 220 | plasma | 28% | 8.0× | formula | 24h |
+| 230 | crystal+stellar+void | 40% | 8.5× | formula | 25h |
+| 240 | soul+time+plasma | 42% | 9.0× | formula | 26h |
 
 **Tier 3 Formulas:**
 - Pact Cost: Same formula as Tier 1
@@ -817,7 +817,7 @@ finalInsight = floor(baseInsight × mult)
 | `manaWell` | Mana Well | +500 starting max mana | 5 | 500 |
 | `manaFlow` | Mana Flow | +0.5 regen/sec permanently | 10 | 750 |
 | `insightAmp` | Insight Amp | +25% insight gain | 4 | 1500 |
-| `spireKey` | Spire Key | Start at floor +2 | 5 | 4000 |
+| `spireKey` | Spire Key | Start at floor `1 + level × 2` (e.g. level 1 → floor 3) | 5 | 4000 |
 | `temporalEcho` | Temporal Echo | +10% mana generation | 5 | 3000 |
 | `steadyHand` | Steady Hand | -15% durability loss | 5 | 1200 |
 | `ancientKnowledge` | Ancient Knowledge | Start with blueprint discovered | 5 | 2000 |
@@ -828,6 +828,7 @@ finalInsight = floor(baseInsight × mult)
 | `elemStart` | Elem. Start | Start with 5 of each unlocked element | 3 | 800 |
 | `unlockedManaTypeCapacity` | Mana Type Capacity | +10 capacity for selected mana type | 5 | 1000 |
 | `pactBinding` | Pact Binding | +1 pact slot per level | 5 | 2000 |
+| `pactInterferenceMitigation` | Pact Interference Mitigation | Reduces pact interference penalty | 10 | 1500 |
 
 ### Pact Persistence
 - Signed pacts do **NOT** persist through prestige — the player must re-defeat Guardians and re-sign pacts each loop.
@@ -1126,5 +1127,5 @@ The following systems no longer exist and should not be re-introduced:
 
 ---
 
-*Document Version: 5.0 — Updated: 8 stores, 22 mana types, 64 disciplines, 14 prestige upgrades, 43 equipment types, component-based golemancy, 8-tier guardians, localStorage-only*
+*Document Version: 5.0 — Updated: 8 stores, 22 mana types, 64 disciplines, 15 prestige upgrades, 43 equipment types, component-based golemancy, 8-tier guardians, localStorage-only*
 *End of Game Briefing Document*