OpenCode/History
2
0
Fork 0
Code Issues Pull Requests Actions Activity

feat(#52): dynamic scenario generation (v0.31.0) #53

Merged
kamilkrzywda merged 5 commits from feat/52-dynamic-scenarios into master 2026-10-15 12:29:49 +02:00
Conversation 0 Commits 5 Files Changed 21
+2786 -9
5 Commits
Author SHA1 Message Date
kamilkrzywda 073e916767 chore(#52): v0.31.0 — version bump + changelog
CI / build + unit + e2e (pull_request) Successful in 1m52s
Details
2026-10-15 10:27:41 +00:00
kamilkrzywda 396702b9da feat(#52): dynamic scenario client (form → review → finalize) + e2e 
Additive 'Create scenario' path (v0.31): the home screen's create-scenario
card opens a ScenarioForm (pick one of 3 light era templates + a free-text
description + an editable, era-prefilled start year) whose 'Generate world'
posts the draft request; the CheckpointReview screen shows the generated
world (per-nation stats/territory/relations + backstory) and the advisor's
checkpoint list as an approve/remove checklist, then the player picks a
nation to lead and finalizes into a saved, playable game. Both LLM steps ride
the scenario client (deterministic stub under LLM_STUB=1); a failure toasts
and stays on the current screen. The turn stub and static presets are
untouched. New e2e covers the full deterministic flow (near-future 2035,
remove checkpoint 3, lead Boreas, finalize, one empty jump) and the 3-template
manifest.
 2026-10-15 10:21:53 +00:00
kamilkrzywda 832957c635 feat(#52): wire /api/scenarios routes + dynamic-game jump preset 
- GET /api/scenarios/templates: the 3 era templates (templateStore from
  presets/templates/).
- POST /api/scenarios/draft: generateDraft (template + description + year) ->
  { world, checkpoints } (502 on transport failure / unusable world).
- POST /api/scenarios/commit: finalizeWorld (constrained to approved
  checkpoints, optionally based on the re-sent draft) -> saved GameState,
  returns { id } (a normal game at #/game/<id>).
- scenarioLlm: the deterministic scenario stub under LLM_STUB=1 (distinct
  from the untouched turn stub), the live client otherwise.
- jump route: synthesize a minimal Preset for dynamic games (presetId
  'dynamic', no static file) so their turns run; genuinely-missing static
  presets still 404.

Fixes #52
 2026-10-15 09:50:57 +00:00
kamilkrzywda 68402694c5 feat(#52): scenario generator LLM steps + deterministic stub 
- server/scenario.ts: buildGeneratePrompt / buildRegeneratePrompt, defensive
  parseGenerate / parseRegenerate (fence-strip + balanced-object + validate),
  generateDraft (draft world + advisor checkpoints) and finalizeWorld (final
  world constrained to approved checkpoints -> playable GameState), all over
  the injectable LlmClient with a nudge re-send. SCENARIO_* markers for the
  stub.
- server/stubScenario.ts: deterministic scenario stub transport (fixed 3-nation
  world + checkpoint list; finalize refines stability per approved checkpoint)
  + makeScenarioStubLlmClient. Distinct from and never touching turn stub.ts.
- server/regions.ts: validCountryCodes() accessor (ISO_A3 parents) for draft
  territory validation.
- shared/scenario.ts: worldDraftToGameState now guards a dangling playerNationId
  (falls back to the first nation) so a finalize that drops it stays playable.
- server/scenario.test.ts: 16 tests (prompt builders, defensive parsing,
  generateDraft/finalizeWorld over a fake client + the stub).

Fixes #52
 2026-10-15 09:46:34 +00:00
kamilkrzywda 2191514db1 feat(#52): era templates + shared scenario types/transforms 
- presets/templates/: 3 light era templates (ww2/present/near-future) + index.json
  manifest (id, name, year, eraDescription, suggestedPowers, tensions).
- server/templates.ts: createTemplateStore (mirror of createPresetStore).
- shared/scenario.ts: dependency-free contract for the dynamic scenario path —
  SuggestedPower / EraTemplate / TemplateMeta / WorldNation / ScenarioEvent /
  WorldDraft / Checkpoint types, relationFromScore, validateWorldDraft (pure,
  defensive, never throws), worldDraftToGameState (region-key territory via the
  injected expand resolver, regionStats seeded, clean turn-1 state).
- tests: server/templates.test.ts (manifest order + file shape),
  server/scenario-shared.test.ts (15 cases: validation/clamp/dedup/null +
  transform).

Fixes #52
 2026-10-15 09:37:31 +00:00