# Vegvísir — TODO

Derived from [vegvisir-spec.md](vegvisir-spec.md). Phases are roughly sequential; content digitization (Phase 0) blocks coding on anything that consumes those tables.

## Phase 0 — Content Digitization (blocks build)

Markdown tables authored in `docs/`, used once at compile time, then deleted. Reflavored to the Norse setting where content is Glorantha-specific; mechanical structure stays RQG-derived.

- [ ] Define markdown table structure/conventions (headers, column format) for all seed files — spec Open Question 1
- [x] Flavour/encounter tables (`norse_encounter_tables.md`, `random-encounter-tables.md` exist — confirm format matches conventions once defined)
- [ ] Ability Results Table
- [ ] Resistance Table
- [ ] Movement rates / travel rules tables
- [ ] NPC generation tables (six rolled fields, per existing narrative-app spec)
- [ ] Spirit Magic spell list (Stef digitizes Magic book before coding starts)
- [ ] Kinship/pantheon content (replaces Gloranthan cults) + per-Kinship Rune Magic spell lists
- [ ] Homeland regions (Stef's regions replacing Dragon Pass homelands, with characteristic/skill modifiers)
- [ ] Family History event tables (Stef's calendar/history, RQG year-by-year roll structure)
- [ ] Occupation table (reflavored names, RQG-derived modifiers/structure)
- [ ] Personality Trait pair list — confirm final opposed pairs and starting-score method (rolled vs. assigned) — spec Open Question 7

## Phase 1 — Project Scaffolding & Data Compilation

- [ ] Project scaffolding (TypeScript app; decide runtime/UI framework, storage approach)
- [ ] One-time compile script: markdown → typed TS data files (`*.generated.ts`, marked do-not-edit)
- [ ] Compile all table categories: flavour tables, movement rates, NPC tables, Spirit Magic, Rune Magic, Occupation, Personality Trait pairs, Ability Results Table, Resistance Table
- [ ] Hand-written lookup/resolution modules importing generated data (table roll functions, movement rate lookup, Resistance Table lookup, Ability Results lookup) — kept separate from generated files
- [ ] Delete source markdown after compile; document re-compile workflow for future table changes

## Phase 2 — Character Generator + Editable Sheet

RQG chargen sequence with setting substitutions. Distinct subsystem; GM layer reads from the sheet it produces.

- [ ] Chargen engine following RQG sequence:
  - [ ] 1. Homeland (Stef's regions)
  - [ ] 2. Family History (year-by-year event rolls, Stef's calendar)
  - [ ] 3. Rune Affinities (tied into characteristic modifiers per RQG)
  - [ ] 4. Characteristics (STR, CON, SIZ, INT, POW, DEX, CHA) + derived stats: MP, HP + hit locations, Healing Rate, Damage Bonus, Max ENC, Strike Rank, Skill Category Modifiers
  - [ ] 5. Occupation (reflavored table)
  - [ ] 6. Kinship (grants Common Rune Magic access + Rune point pool)
  - [ ] 7. Personal Skill Bonuses
  - [ ] 8. Other Information (gender, name, age, handedness, scars, family, tribe/settlement/clan, heirloom, reputation, movement)
  - [ ] 9. Passions (directed %, e.g. Loyalty/Hate/Love)
  - [ ] 10. Personality Traits (Pendragon-style opposed pairs, each pair scored to 20)
- [ ] Persistent, mutable character sheet — every roll user-editable/re-rollable after generation (not one-shot)
- [ ] Character persistence across sessions

## Phase 3 — GM Layer (encounter resolution)

Deterministic RQG mechanics, reading from the active character sheet(s).

- [ ] Skill checks via Ability Results Table (pass/fail with degree of success, brief outcome)
- [ ] Opposed checks vs NPCs/environment via full Resistance Table
- [ ] Full combat resolution: strike ranks, hit locations, damage, round-by-round to an outcome
- [ ] Augmentation from Passions (boost/hinder per RQG rules)
- [ ] Personality Trait checks for ambiguous character behavior mid-resolution
- [ ] Spirit Magic casting during resolution (MP cost per RQG)
- [ ] Rune Magic casting (Rune points from Kinship pool)
- [ ] Reaction rolls
- [ ] (Out of scope v1, flag as future: Sorcery, Divine Intervention)

## Phase 4 — Flavour Roller, Scene Types & Favourites

- [ ] Roll engine: 3–4 mixed-category options per roll (encounter / cultural detail / NPC quirk), tagged by scene type + danger level
- [ ] Manual-pick scene types: Combat/Danger, Social/NPC (Travel and Tavern/Settlement are driven by Phases 5–6)
- [ ] Pick-one-or-none flow → hand picked option to GM layer for resolution
- [ ] Favourites: save resolved results, persistent across sessions, grouped by scene type, danger tag carried through for filtering
- [ ] Favourites browser (viewable list, grouped by scene type)
- [ ] Export: downloadable markdown dump of favourites, grouped by scene type

## Phase 5 — World Model

- [ ] Locations: name, type (Settlement / Wilderness Point / Dungeon / Landmark → maps to scene types), freeform features/tags
- [ ] Districts (settlement sub-locations): name, danger level (none/low/med/high), district-scoped NPC pool
- [ ] District encounter checks: manually triggered, chance weighted by danger level (defaults none 0% / low 15% / med 35% / high 60%, tunable in config)
- [ ] Paths: from/to, distance (km), mode of travel, danger level, terrain notes
- [ ] Travel time computation: distance ÷ RQG movement rate for mode (from compiled data, not hardcoded)
- [ ] Multi-leg routing through intermediate locations when no direct path exists (sum time across legs)
- [ ] NPCs scoped to location or district; both random draw and browsable list presentations

## Phase 6 — Journey Flow

- [ ] Origin/destination/mode selection UI (mode changeable per leg)
- [ ] Route resolution + total travel time display
- [ ] Open-road legs: fixed cadence, one encounter roll per day of travel
- [ ] In-settlement: manual per-district checks (danger-weighted, from Phase 5)
- [ ] Triggered rolls surface mixed flavour options tagged by scene type (derived from location/path type) + danger level
- [ ] Resolution + save flow wired through GM layer and favourites as usual

## Phase 7 — Narration Layer (optional, last)

- [ ] Ollama integration: mechanical result → prose paragraph via OpenAI-compatible endpoint (`localhost:11434`), model name configurable
- [ ] Plain templated-text fallback when Ollama unreachable or output unusable
- [ ] Keep all mechanical resolution deterministic — LLM narrates only

## Open Questions (resolve before/during build)

- [ ] Markdown table structure for seed files, incl. new RQG-derived tables (Rune Magic, Occupation, Resistance Table, Ability Results Table)
- [ ] Homeland/Kinship/Occupation replacement content from Stef (alongside digitization)
- [ ] Personality Trait pair final set + starting-score generation method

## Explicitly Out of Scope (v1)

- Fresh OCR/extraction from the physical book
- Chat-style generation / conversational interface
- Category selection separate from scene type
- Sorcery, Divine Intervention
- Glorantha as setting (RQG is mechanics source only)