Anexim/Mana-Loop
1
1
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

[Medium] [Task] Documentation Inconsistency Report #291

New Issue
Closed
opened 2026-06-07 15:48:06 +02:00 by Anexim · 3 comments
Anexim commented 2026-06-07 15:48:06 +02:00
Owner
Copy Link
Copy Source

Documentation Inconsistency Report

After thoroughly reading all docs in the project (AGENTS.md, GAME_BRIEFING.md, project-structure.txt, dependency-graph.json, circular-deps.txt, and all spec files), the following inconsistencies were found.

🔴 Critical Inconsistencies (Contradictions)

1. Pact Persistence Through Prestige

  • AGENTS.md (line ~155): "Signed pacts do NOT persist through prestige (reset each loop)"
  • GAME_BRIEFING.md (§11 Pact Persistence): States pacts are reset on new loop — consistent with AGENTS.md
  • pact-system-spec.md (§5.2): Contains a direct contradiction — the "Design intent vs. implementation" note says: "The AGENTS.md states 'Signed pacts persist through prestige (bounded by pactSlots).' The current code resets them. This is a known discrepancy." — This is wrong. AGENTS.md actually says the opposite (pacts do NOT persist). The spec misquotes AGENTS.md.

Resolution needed: Fix the misquote in pact-system-spec.md §5.2. AGENTS.md says pacts do NOT persist. The code resetting them is correct behavior, not a discrepancy.

2. pactBinding Prestige Upgrade Definition

  • pact-system-spec.md (§4.2): States "The pactBinding upgrade is referenced in the store logic but is not defined in PRESTIGE_DEF constants. This is a known gap."
  • invoker-spec.md (§10 Known Code Issues): States "pactBinding upgrade — ✅ RESOLVED — Added to PRESTIGE_DEF in prestige.ts"
  • AGENTS.md: Lists pactBinding as one of the 14 prestige upgrades.

Resolution needed: The pact-system-spec.md is outdated. The invoker-spec.md says it's resolved. Need to verify in code and update pact-system-spec.md.

3. pactInterferenceMitigation Prestige Upgrade

  • invoker-spec.md (§10): States "pactInterferenceMitigation — ✅ RESOLVED — Added to PRESTIGE_DEF"
  • AGENTS.md: Lists only 14 prestige upgrades and pactInterferenceMitigation is NOT in the list. The listed upgrades are: manaWell, manaFlow, insightAmp, spireKey, temporalEcho, steadyHand, ancientKnowledge, elementalAttune, spellMemory, guardianPact, quickStart, elemStart, unlockedManaTypeCapacity, pactBinding.
  • GAME_BRIEFING.md (§11): Also lists only the same 14 upgrades, no pactInterferenceMitigation.

Resolution needed: Either add pactInterferenceMitigation to the AGENTS.md and GAME_BRIEFING.md lists (making it 15 upgrades), or remove it from the code if it was added by mistake.

4. Guardian Tier 2 Floor 100 Element

  • GAME_BRIEFING.md (§7 Tier 2 table): Floor 100 guardian element is listed as sand+fire+earth (composite components)
  • pact-system-spec.md (§7.1): Floor 100 element is listed as sand (just the element name)
  • GAME_BRIEFING.md (§7 Tier 2 table): Floor 140 is sand+earth+water (radiantflames) — but radiantflames = light+fire, not sand+earth+water
  • GAME_BRIEFING.md (§7 Tier 2 table): Floor 150 is lightning+fire+air (miasma) — but miasma = air+death, not lightning+fire+air

Resolution needed: The GAME_BRIEFING.md Tier 2 table has incorrect element-to-floor mappings for floors 100, 140, and 150. Need to verify against guardian-data.ts and correct.

5. Guardian Tier 3 Armor Values

  • GAME_BRIEFING.md (§7 Tier 3 table): Lists armor values for exotic guardians (e.g., crystal 35%, stellar 30%, void 35%)
  • pact-system-spec.md (§8.3): Lists different armor values for the same floors (crystal 35%, stellar 30%, void 35% — but different pact times: 19h-26h vs 37h-44h in GAME_BRIEFING.md)

Resolution needed: The pact times in GAME_BRIEFING.md Tier 3 (37h-44h) don't match pact-system-spec.md (19h-26h). The formula 2 + floor(floor/10) gives 19h for floor 170, not 37h. GAME_BRIEFING.md appears to have incorrect values.

6. Guardian Tier 1 Pact Times

  • GAME_BRIEFING.md (§7 Tier 1 table): Pact times are 2h, 4h, 6h, 8h, 10h, 12h, 14h, 16h
  • pact-system-spec.md (§8.1): Pact times are 3h, 4h, 5h, 6h, 7h, 8h, 9h, 10h
  • pact-system-spec.md (§2.3): The formula is requiredTime = guardian.pactTime × (1 - pactAffinity) — but the base pactTime values aren't defined consistently.

Resolution needed: Floor 10 pact time is 2h in GAME_BRIEFING.md but 3h in pact-system-spec.md. Need to verify in code and reconcile.

7. Guardian Tier 1 Armor Values

  • GAME_BRIEFING.md (§7 Tier 1 table): Armor starts at 10% on floor 10, increases by 5% per 10th floor (10%, 15%, 20%, 25%, 30%, 35%, 40%, 45%)
  • pact-system-spec.md (§8.1): Armor values are 10%, 15%, 18%, 25%, 20%, 22%, 25%, 20% — completely different pattern

Resolution needed: Major discrepancy in armor values. GAME_BRIEFING.md has a clean 5% increment pattern, while pact-system-spec.md has irregular values. Need to verify in guardian-data.ts.

8. Number of Equipment Types

  • AGENTS.md: "50 equipment types across 9 categories"
  • GAME_BRIEFING.md (§10): "Total: 43 equipment types across 8 categories"
  • enchanting-spec.md (§6.1): Lists 43 individual equipment types in the capacity table

Resolution needed: AGENTS.md says 50, but the detailed spec and GAME_BRIEFING.md say 43. AGENTS.md needs updating.

9. Number of Disciplines

  • GAME_BRIEFING.md (§9): "64 disciplines total" — but the table shows: 3+21+8+15+4+2+3+1+2+5 = 64 ✓
  • AGENTS.md: Lists the same files but doesn't state a total count
  • attunement-system-spec.md (§6.2): Says "The remaining 47 disciplines are available regardless of attunement status" — 47+17 = 64 ✓

This is actually consistent — but the AGENTS.md doesn't mention the total, which could be clearer.

10. Discipline Stat Bonus Formula

  • AGENTS.md: StatBonus = baseValue × (XP / scalingFactor)^0.65
  • GAME_BRIEFING.md (§9): StatBonus = baseValue × (XP / scalingFactor)^0.65 ✓
  • mana-conversion-spec.md (§4): Uses the same formula for discipline conversion rates ✓

Consistent — no issue.

🟡 Minor Inconsistencies

11. Spire Key Starting Floor Formula

  • spire-climbing-spec.md (§4.1): startFloor = 1 + (spireKey × 2) — spireKey 0 → F1
  • GAME_BRIEFING.md (§11 prestige upgrades): "spireKey — Start at floor +2" — ambiguous whether this means +2 per level or start at floor 2

Clarification needed: The spec is clear (1 + level×2), but the briefing is ambiguous.

12. Room Type Percentages

  • GAME_BRIEFING.md (§6): Lists Puzzle as "20% on every 7th floor"
  • spire-climbing-spec.md (§4.3): Says "Every 7th floor, one room (chosen by seed) → always 'puzzle'" — this is 1 room per 7th floor, not 20%

Resolution needed: GAME_BRIEFING.md says 20% on every 7th floor, but the spec says exactly 1 room is puzzle on every 7th floor. These are different.

13. Puzzle Room Base Time

  • GAME_BRIEFING.md (§6): "up to 24 hours base time"
  • spire-climbing-spec.md (§4.11): Base time scales: 4h (floor≤20), 8h (floor≤50), 16h (floor≤100), 24h (floor>100) — consistent

Actually consistent — no issue.

14. Puzzle Room Progress Rate

  • attunement-system-spec.md (§8): "Progress scales at 1.5–2% per tick base, with attunement bonus of 2.5–3% per relevant attunement level"
  • spire-climbing-spec.md (§4.11): Uses a different formula: base × (1 - totalReduction) where reduction is up to 90%

Clarification needed: The progress rate description in attunement-system-spec is vague (1.5-2% per tick) while the climbing spec has a detailed formula. These might be describing different things.

15. Golem Slot Formula

  • AGENTS.md: "Golem slots: floor(fabricatorLevel / 2), max 5 at level 10 (+2 from Golem Crafting discipline = max 7)"
  • GAME_BRIEFING.md (§11): Same formula, max 7
  • golemancy-spec.md (§2): Same formula, max 7
  • fabricator-spec.md (§9): Same formula, max 5 from attunement + 2 from discipline = 7

Consistent — no issue.

16. Enchantment Design Time

  • AGENTS.md: "Time: 1h + 0.5h per effect slot"
  • enchanting-spec.md (§3.2): time = 1 + 0.5 * stacks — this is per stack, not per effect slot

Resolution needed: AGENTS.md says "per effect slot" but the spec says "per stack". These are different if an effect has multiple stacks.

17. Prepare Stage Time

  • AGENTS.md: "time: 2h + 1h per 50 capacity"
  • enchanting-spec.md (§4.2): time = 2 + floor(equipmentCapacity / 50) — consistent ✓

Consistent — no issue.

18. Apply Stage Time

  • AGENTS.md: "Time: 2h + stacks hours"
  • enchanting-spec.md (§5.2): time = 2 + Σ(stacks) — consistent ✓

Consistent — no issue.

19. Enemy Modifiers — Mage Barrier Recharge

  • GAME_BRIEFING.md (§6): "Up to 40% of max HP, recharges 5%/tick"
  • spire-combat-spec.md (§5.1): "barrier = min(0.4, floor × 0.003); recharges 5%/tick" — consistent ✓

Consistent — no issue.

20. Achievement Count

  • GAME_BRIEFING.md (§13): Lists 24 achievements across 5 categories (9+3+6+3+3)
  • AGENTS.md: Doesn't mention achievement count

No inconsistency — just a missing detail in AGENTS.md.

🟢 Items That Are Consistent (Verified)

  • Mana types: 22 total (7 base + 1 utility + 8 composite + 6 exotic) — consistent across all docs
  • Tick rate: TICK_MS=200ms, HOURS_PER_TICK=0.04 — consistent
  • Incursion: starts day 20, formula min(0.95, (totalHours/maxHours) × 0.95) — consistent
  • Discipline math: StatBonus and ManaDrain formulas — consistent
  • Attunement level scaling: 1.5^(level-1) — consistent
  • Equipment slots: 8 slots — consistent
  • Prestige upgrades: 14 types (assuming pactInterferenceMitigation is an error)
  • Store architecture: 8 Zustand stores — consistent
  • Elemental opposites and counters — consistent across combat specs
  • Golemancy component system (4 cores, 7 frames, 4 mind circuits, 8 enchantments) — consistent

Summary of Action Items

# File to Fix Issue
1 pact-system-spec.md §5.2 Misquotes AGENTS.md — AGENTS.md says pacts do NOT persist
2 pact-system-spec.md §4.2 pactBinding is marked as missing but is resolved per invoker-spec
3 AGENTS.md / GAME_BRIEFING.md Add pactInterferenceMitigation to prestige upgrade list OR remove from code
4 GAME_BRIEFING.md §7 Fix Tier 2 guardian element mappings (floors 100, 140, 150)
5 GAME_BRIEFING.md §7 Fix Tier 3 guardian pact times (37h-44h vs correct 19h-26h)
6 GAME_BRIEFING.md §7 Fix Tier 1 guardian armor values to match spec/code
7 AGENTS.md Update equipment count from 50 to 43
8 GAME_BRIEFING.md §6 Fix puzzle room frequency (20% vs 1 room per 7th floor)
9 AGENTS.md Fix enchantment design time description (per stack, not per effect slot)
10 GAME_BRIEFING.md §11 Clarify spireKey description
# Documentation Inconsistency Report After thoroughly reading all docs in the project (AGENTS.md, GAME_BRIEFING.md, project-structure.txt, dependency-graph.json, circular-deps.txt, and all spec files), the following inconsistencies were found. --- ## 🔴 Critical Inconsistencies (Contradictions) ### 1. Pact Persistence Through Prestige - **AGENTS.md** (line ~155): "Signed pacts do NOT persist through prestige (reset each loop)" - **GAME_BRIEFING.md** (§11 Pact Persistence): States pacts are reset on new loop — consistent with AGENTS.md - **pact-system-spec.md** (§5.2): Contains a **direct contradiction** — the "Design intent vs. implementation" note says: *"The AGENTS.md states 'Signed pacts persist through prestige (bounded by pactSlots).' The current code resets them. This is a known discrepancy."* — This is **wrong**. AGENTS.md actually says the **opposite** (pacts do NOT persist). The spec misquotes AGENTS.md. **Resolution needed**: Fix the misquote in pact-system-spec.md §5.2. AGENTS.md says pacts do NOT persist. The code resetting them is correct behavior, not a discrepancy. ### 2. `pactBinding` Prestige Upgrade Definition - **pact-system-spec.md** (§4.2): States *"The `pactBinding` upgrade is referenced in the store logic but is **not defined** in `PRESTIGE_DEF` constants. This is a known gap."* - **invoker-spec.md** (§10 Known Code Issues): States *"`pactBinding` upgrade — ✅ RESOLVED — Added to `PRESTIGE_DEF` in `prestige.ts`"* - **AGENTS.md**: Lists `pactBinding` as one of the 14 prestige upgrades. **Resolution needed**: The pact-system-spec.md is outdated. The invoker-spec.md says it's resolved. Need to verify in code and update pact-system-spec.md. ### 3. `pactInterferenceMitigation` Prestige Upgrade - **invoker-spec.md** (§10): States *"`pactInterferenceMitigation` — ✅ RESOLVED — Added to `PRESTIGE_DEF`"* - **AGENTS.md**: Lists only 14 prestige upgrades and `pactInterferenceMitigation` is **NOT** in the list. The listed upgrades are: manaWell, manaFlow, insightAmp, spireKey, temporalEcho, steadyHand, ancientKnowledge, elementalAttune, spellMemory, guardianPact, quickStart, elemStart, unlockedManaTypeCapacity, pactBinding. - **GAME_BRIEFING.md** (§11): Also lists only the same 14 upgrades, no `pactInterferenceMitigation`. **Resolution needed**: Either add `pactInterferenceMitigation` to the AGENTS.md and GAME_BRIEFING.md lists (making it 15 upgrades), or remove it from the code if it was added by mistake. ### 4. Guardian Tier 2 Floor 100 Element - **GAME_BRIEFING.md** (§7 Tier 2 table): Floor 100 guardian element is listed as `sand+fire+earth` (composite components) - **pact-system-spec.md** (§7.1): Floor 100 element is listed as `sand` (just the element name) - **GAME_BRIEFING.md** (§7 Tier 2 table): Floor 140 is `sand+earth+water (radiantflames)` — but radiantflames = light+fire, not sand+earth+water - **GAME_BRIEFING.md** (§7 Tier 2 table): Floor 150 is `lightning+fire+air (miasma)` — but miasma = air+death, not lightning+fire+air **Resolution needed**: The GAME_BRIEFING.md Tier 2 table has incorrect element-to-floor mappings for floors 100, 140, and 150. Need to verify against guardian-data.ts and correct. ### 5. Guardian Tier 3 Armor Values - **GAME_BRIEFING.md** (§7 Tier 3 table): Lists armor values for exotic guardians (e.g., crystal 35%, stellar 30%, void 35%) - **pact-system-spec.md** (§8.3): Lists **different** armor values for the same floors (crystal 35%, stellar 30%, void 35% — but different pact times: 19h-26h vs 37h-44h in GAME_BRIEFING.md) **Resolution needed**: The pact times in GAME_BRIEFING.md Tier 3 (37h-44h) don't match pact-system-spec.md (19h-26h). The formula `2 + floor(floor/10)` gives 19h for floor 170, not 37h. GAME_BRIEFING.md appears to have incorrect values. ### 6. Guardian Tier 1 Pact Times - **GAME_BRIEFING.md** (§7 Tier 1 table): Pact times are 2h, 4h, 6h, 8h, 10h, 12h, 14h, 16h - **pact-system-spec.md** (§8.1): Pact times are 3h, 4h, 5h, 6h, 7h, 8h, 9h, 10h - **pact-system-spec.md** (§2.3): The formula is `requiredTime = guardian.pactTime × (1 - pactAffinity)` — but the base `pactTime` values aren't defined consistently. **Resolution needed**: Floor 10 pact time is 2h in GAME_BRIEFING.md but 3h in pact-system-spec.md. Need to verify in code and reconcile. ### 7. Guardian Tier 1 Armor Values - **GAME_BRIEFING.md** (§7 Tier 1 table): Armor starts at 10% on floor 10, increases by 5% per 10th floor (10%, 15%, 20%, 25%, 30%, 35%, 40%, 45%) - **pact-system-spec.md** (§8.1): Armor values are 10%, 15%, 18%, 25%, 20%, 22%, 25%, 20% — completely different pattern **Resolution needed**: Major discrepancy in armor values. GAME_BRIEFING.md has a clean 5% increment pattern, while pact-system-spec.md has irregular values. Need to verify in guardian-data.ts. ### 8. Number of Equipment Types - **AGENTS.md**: "50 equipment types across 9 categories" - **GAME_BRIEFING.md** (§10): "Total: 43 equipment types across 8 categories" - **enchanting-spec.md** (§6.1): Lists 43 individual equipment types in the capacity table **Resolution needed**: AGENTS.md says 50, but the detailed spec and GAME_BRIEFING.md say 43. AGENTS.md needs updating. ### 9. Number of Disciplines - **GAME_BRIEFING.md** (§9): "64 disciplines total" — but the table shows: 3+21+8+15+4+2+3+1+2+5 = 64 ✓ - **AGENTS.md**: Lists the same files but doesn't state a total count - **attunement-system-spec.md** (§6.2): Says "The remaining 47 disciplines are available regardless of attunement status" — 47+17 = 64 ✓ **This is actually consistent** — but the AGENTS.md doesn't mention the total, which could be clearer. ### 10. Discipline Stat Bonus Formula - **AGENTS.md**: `StatBonus = baseValue × (XP / scalingFactor)^0.65` - **GAME_BRIEFING.md** (§9): `StatBonus = baseValue × (XP / scalingFactor)^0.65` ✓ - **mana-conversion-spec.md** (§4): Uses the same formula for discipline conversion rates ✓ **Consistent** — no issue. --- ## 🟡 Minor Inconsistencies ### 11. Spire Key Starting Floor Formula - **spire-climbing-spec.md** (§4.1): `startFloor = 1 + (spireKey × 2)` — spireKey 0 → F1 - **GAME_BRIEFING.md** (§11 prestige upgrades): "spireKey — Start at floor +2" — ambiguous whether this means +2 per level or start at floor 2 **Clarification needed**: The spec is clear (1 + level×2), but the briefing is ambiguous. ### 12. Room Type Percentages - **GAME_BRIEFING.md** (§6): Lists Puzzle as "20% on every 7th floor" - **spire-climbing-spec.md** (§4.3): Says "Every 7th floor, one room (chosen by seed) → always 'puzzle'" — this is 1 room per 7th floor, not 20% **Resolution needed**: GAME_BRIEFING.md says 20% on every 7th floor, but the spec says exactly 1 room is puzzle on every 7th floor. These are different. ### 13. Puzzle Room Base Time - **GAME_BRIEFING.md** (§6): "up to 24 hours base time" - **spire-climbing-spec.md** (§4.11): Base time scales: 4h (floor≤20), 8h (floor≤50), 16h (floor≤100), 24h (floor>100) — consistent **Actually consistent** — no issue. ### 14. Puzzle Room Progress Rate - **attunement-system-spec.md** (§8): "Progress scales at 1.5–2% per tick base, with attunement bonus of 2.5–3% per relevant attunement level" - **spire-climbing-spec.md** (§4.11): Uses a different formula: `base × (1 - totalReduction)` where reduction is up to 90% **Clarification needed**: The progress rate description in attunement-system-spec is vague (1.5-2% per tick) while the climbing spec has a detailed formula. These might be describing different things. ### 15. Golem Slot Formula - **AGENTS.md**: "Golem slots: `floor(fabricatorLevel / 2)`, max 5 at level 10 (+2 from Golem Crafting discipline = max 7)" - **GAME_BRIEFING.md** (§11): Same formula, max 7 - **golemancy-spec.md** (§2): Same formula, max 7 - **fabricator-spec.md** (§9): Same formula, max 5 from attunement + 2 from discipline = 7 **Consistent** — no issue. ### 16. Enchantment Design Time - **AGENTS.md**: "Time: 1h + 0.5h per effect slot" - **enchanting-spec.md** (§3.2): `time = 1 + 0.5 * stacks` — this is per stack, not per effect slot **Resolution needed**: AGENTS.md says "per effect slot" but the spec says "per stack". These are different if an effect has multiple stacks. ### 17. Prepare Stage Time - **AGENTS.md**: "time: `2h + 1h per 50 capacity`" - **enchanting-spec.md** (§4.2): `time = 2 + floor(equipmentCapacity / 50)` — consistent ✓ **Consistent** — no issue. ### 18. Apply Stage Time - **AGENTS.md**: "Time: `2h + stacks` hours" - **enchanting-spec.md** (§5.2): `time = 2 + Σ(stacks)` — consistent ✓ **Consistent** — no issue. ### 19. Enemy Modifiers — Mage Barrier Recharge - **GAME_BRIEFING.md** (§6): "Up to 40% of max HP, recharges 5%/tick" - **spire-combat-spec.md** (§5.1): "`barrier = min(0.4, floor × 0.003)`; recharges 5%/tick" — consistent ✓ **Consistent** — no issue. ### 20. Achievement Count - **GAME_BRIEFING.md** (§13): Lists 24 achievements across 5 categories (9+3+6+3+3) - **AGENTS.md**: Doesn't mention achievement count **No inconsistency** — just a missing detail in AGENTS.md. --- ## 🟢 Items That Are Consistent (Verified) - Mana types: 22 total (7 base + 1 utility + 8 composite + 6 exotic) — consistent across all docs - Tick rate: TICK_MS=200ms, HOURS_PER_TICK=0.04 — consistent - Incursion: starts day 20, formula `min(0.95, (totalHours/maxHours) × 0.95)` — consistent - Discipline math: StatBonus and ManaDrain formulas — consistent - Attunement level scaling: `1.5^(level-1)` — consistent - Equipment slots: 8 slots — consistent - Prestige upgrades: 14 types (assuming pactInterferenceMitigation is an error) - Store architecture: 8 Zustand stores — consistent - Elemental opposites and counters — consistent across combat specs - Golemancy component system (4 cores, 7 frames, 4 mind circuits, 8 enchantments) — consistent --- ## Summary of Action Items | # | File to Fix | Issue | |---|---|---| | 1 | `pact-system-spec.md` §5.2 | Misquotes AGENTS.md — AGENTS.md says pacts do NOT persist | | 2 | `pact-system-spec.md` §4.2 | `pactBinding` is marked as missing but is resolved per invoker-spec | | 3 | `AGENTS.md` / `GAME_BRIEFING.md` | Add `pactInterferenceMitigation` to prestige upgrade list OR remove from code | | 4 | `GAME_BRIEFING.md` §7 | Fix Tier 2 guardian element mappings (floors 100, 140, 150) | | 5 | `GAME_BRIEFING.md` §7 | Fix Tier 3 guardian pact times (37h-44h vs correct 19h-26h) | | 6 | `GAME_BRIEFING.md` §7 | Fix Tier 1 guardian armor values to match spec/code | | 7 | `AGENTS.md` | Update equipment count from 50 to 43 | | 8 | `GAME_BRIEFING.md` §6 | Fix puzzle room frequency (20% vs 1 room per 7th floor) | | 9 | `AGENTS.md` | Fix enchantment design time description (per stack, not per effect slot) | | 10 | `GAME_BRIEFING.md` §11 | Clarify spireKey description |
Anexim added the ai:todo label 2026-06-07 15:48:06 +02:00
n8n-gitea was assigned by Anexim 2026-06-07 15:48:06 +02:00
Anexim commented 2026-06-07 16:01:11 +02:00
Author
Owner
Copy Link
Copy Source

Any time you can use a formula, do so, it keeps the game dynamic and expandable

Any time you can use a formula, do so, it keeps the game dynamic and expandable
Anexim added ai:in-progress and removed ai:todo labels 2026-06-07 16:02:40 +02:00
Anexim commented 2026-06-07 16:02:40 +02:00
Author
Owner
Copy Link
Copy Source

Starting work on documentation inconsistency fixes. Will verify each claim against code and fix systematically.

Starting work on documentation inconsistency fixes. Will verify each claim against code and fix systematically.
Anexim added ai:done and removed ai:in-progress labels 2026-06-07 16:15:20 +02:00
Anexim commented 2026-06-07 16:15:20 +02:00
Author
Owner
Copy Link
Copy Source

All 12 documentation inconsistencies have been fixed and pushed to master (commit e90ae82).

Summary of changes:

  1. pact-system-spec.md §5.2 — Removed fabricated misquote of AGENTS.md. The spec now correctly states that AGENTS.md says pacts do NOT persist, and the code matches this behavior.

  2. pact-system-spec.md §4.2 — Updated stale note about pactBinding being undefined. It is now properly defined in PRESTIGE_DEF with max:5, cost:2000.

  3. pact-system-spec.md §8.2/8.3 — Corrected element tags: floor 140 is sand+earth+water (not radiantflames), floor 150 is lightning+fire+air (not miasma), floor 200 is crystal+stellar+void (not soul+stellar+void).

  4. AGENTS.md + GAME_BRIEFING.md — Added pactInterferenceMitigation to the prestige upgrade lists (now 15 upgrades total, not 14).

  5. GAME_BRIEFING.md §7 Tier 1 — Corrected armor values (10/15/18/25/20/22/25/20%) and pact times (3-10h) to match guardian-data.ts.

  6. GAME_BRIEFING.md §7 Tier 2 — Corrected armor values (30/25/22/28/32/25/28/33%) and pact times (11-18h) to match guardian-data.ts.

  7. GAME_BRIEFING.md §7 Tier 3 — Corrected pact times (19-26h) to match guardian-data.ts formula 2 + floor(floor/10).

  8. GAME_BRIEFING.md §7 — Corrected floor 100 element to sand (not sand+fire+earth).

  9. AGENTS.md — Updated equipment count from "50 across 9 categories" to "43 across 8 categories".

  10. AGENTS.md — Fixed enchantment design time from "per effect slot" to "per stack (summed across all effects)".

  11. GAME_BRIEFING.md §6 — Clarified puzzle room frequency as "1 guaranteed room per 7th floor (seeded)" instead of "20%".

  12. GAME_BRIEFING.md §11 — Clarified spireKey formula as 1 + level × 2.

All changes verified against source code (guardian-data.ts, prestige.ts, equipment-types-data.ts). 1009 tests passing.

All 12 documentation inconsistencies have been fixed and pushed to master (commit e90ae82). **Summary of changes:** 1. **pact-system-spec.md §5.2** — Removed fabricated misquote of AGENTS.md. The spec now correctly states that AGENTS.md says pacts do NOT persist, and the code matches this behavior. 2. **pact-system-spec.md §4.2** — Updated stale note about `pactBinding` being undefined. It is now properly defined in `PRESTIGE_DEF` with max:5, cost:2000. 3. **pact-system-spec.md §8.2/8.3** — Corrected element tags: floor 140 is `sand+earth+water` (not `radiantflames`), floor 150 is `lightning+fire+air` (not `miasma`), floor 200 is `crystal+stellar+void` (not `soul+stellar+void`). 4. **AGENTS.md + GAME_BRIEFING.md** — Added `pactInterferenceMitigation` to the prestige upgrade lists (now 15 upgrades total, not 14). 5. **GAME_BRIEFING.md §7 Tier 1** — Corrected armor values (10/15/18/25/20/22/25/20%) and pact times (3-10h) to match `guardian-data.ts`. 6. **GAME_BRIEFING.md §7 Tier 2** — Corrected armor values (30/25/22/28/32/25/28/33%) and pact times (11-18h) to match `guardian-data.ts`. 7. **GAME_BRIEFING.md §7 Tier 3** — Corrected pact times (19-26h) to match `guardian-data.ts` formula `2 + floor(floor/10)`. 8. **GAME_BRIEFING.md §7** — Corrected floor 100 element to `sand` (not `sand+fire+earth`). 9. **AGENTS.md** — Updated equipment count from "50 across 9 categories" to "43 across 8 categories". 10. **AGENTS.md** — Fixed enchantment design time from "per effect slot" to "per stack (summed across all effects)". 11. **GAME_BRIEFING.md §6** — Clarified puzzle room frequency as "1 guaranteed room per 7th floor (seeded)" instead of "20%". 12. **GAME_BRIEFING.md §11** — Clarified spireKey formula as `1 + level × 2`. All changes verified against source code (`guardian-data.ts`, `prestige.ts`, `equipment-types-data.ts`). 1009 tests passing.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
ai:blocked
ai:done
ai:in-progress
ai:priority:high
priority
 ai:review
ai:todo
No Label ai:done
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
n8n-gitea zhipu Anexim
No Assignees n8n-gitea
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Anexim/Mana-Loop#291
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?