[codex] Add run save snapshots - #86

Open

CompleteDotTech wants to merge 196 commits into

Gennadiyev:mainfrom

CompleteDotTech:codex/save-snapshots-docs

Commits on Mar 26, 2026

Add relics and potions to map state player summary

CompleteDotTech
and
claude
committed
71322f8
Include map data in all state responses

CompleteDotTech
and
claude
committed
3cec6c4
Include full player data in all state responses

CompleteDotTech
and
claude
committed
8d41088
Add master deck to player state

CompleteDotTech
and
claude
committed
bd6cf9a
Add try-catch around top-level BuildPlayerState to prevent crashes

CompleteDotTech
and
claude
committed
b46b9cc
Derive next map options from graph data when map screen is closed

CompleteDotTech
and
claude
committed
7c1b08b
debug: add _debug_next to diagnose empty next_options
CompleteDotTech
committed
f427a0f
Revert "debug: add _debug_next to diagnose empty next_options"
CompleteDotTech
committed
b40986d
Revert "Derive next map options from graph data when map screen is closed"
CompleteDotTech
committed
3c7f8bf
Add glossary API endpoints for cards, relics, potions, keywords

CompleteDotTech
and
claude
committed
28fc523
Fix glossary: use runState.Players instead of direct pool construction
CompleteDotTech
committed
ac30c2a
Revert "Fix glossary: use runState.Players instead of direct pool construction"
CompleteDotTech
committed
9589606
Revert glossary endpoints — caused mod crash on load
CompleteDotTech
committed
5046512

Commits on Mar 27, 2026

Bind HTTP server to all interfaces when URL ACL is available

CompleteDotTech
and
claude
committed
01b4131

Commits on Mar 29, 2026

Add GET /api/v1/glossary/cards endpoint

CompleteDotTech
and
claude
committed
e992cb3
Add GET /api/v1/glossary/relics endpoint

CompleteDotTech
and
claude
committed
eaf67f0
Add GET /api/v1/glossary/potions endpoint

CompleteDotTech
and
claude
committed
9c8cee1
Add GET /api/v1/glossary/keywords endpoint

CompleteDotTech
and
claude
committed
68b5fdf
Detect main menu options (singleplayer, multiplayer, etc.)

CompleteDotTech
and
claude
committed
76a805c
Add menu screen detection and character select details

CompleteDotTech
and
claude
committed
0678f39
Add menu_select action for programmatic menu navigation

CompleteDotTech
and
claude
committed
88d939f
Add game_over state detection and continue/main_menu actions

CompleteDotTech
and
claude
committed
694a6ec
Add GET /api/v1/profile endpoint

CompleteDotTech
and
claude
committed
468b2cf
Add per-character breakdown to encounter and enemy stats

CompleteDotTech
and
claude
committed
014acff
Exhaust profile data: ancients, epochs, achievements, global stats

CompleteDotTech
and
claude
committed
1853c7b
Add bestiary endpoint and widget

CompleteDotTech
and
claude
committed
cb53a6b
Add gold rewards and monster mapping to bestiary encounters

CompleteDotTech
and
claude
committed
23cf68a
Add timeline epoch data and multiplayer/settings/compendium detection

CompleteDotTech
and
claude
committed
350fe6b
Show completed epochs with era name, separate locked/completed sections

CompleteDotTech
and
claude
committed
dc62748
Fix timeline to use stable ProgressState data instead of hover tips

CompleteDotTech
and
claude
committed
bb0af51
Add timeline_advance action for auto-clicking epoch reveals

CompleteDotTech
and
claude
committed
21cb103
Fix timeline auto-advance: RevealEpoch, confirm, tutorial proceed

CompleteDotTech
and
claude
committed
849cf3e
Add profile management API: list, switch, delete profiles

CompleteDotTech
and
claude
committed
523484c
Add GET /api/v1/settings endpoint

CompleteDotTech
and
claude
committed
ba2d509
Fix profile switch to use proper UI flow like a real player

CompleteDotTech
and
claude
committed
19bd6b2
Detect and dismiss tutorial prompts, handle all FTUE popups

CompleteDotTech
and
claude
committed
821e6a6
Add seed support when embarking on a run

CompleteDotTech
and
claude
committed
8b129d9

Commits on Mar 31, 2026

Merge origin/main into local fork state
CompleteDotTech
committed
86fdf5b

Commits on Apr 3, 2026

Commits on Apr 18, 2026

Merge upstream main into fork
CompleteDotTech
committed
aafabc8

Commits on May 9, 2026

Merge upstream main into fork
CompleteDotTech
committed
fea4700
Add compendium endpoint
CompleteDotTech
committed
c87a11d
Add compendium run identity
CompleteDotTech
committed
f2b80a9
Address compendium review feedback
CompleteDotTech
committed
217159a
Restrict save resolution to active Steam account
CompleteDotTech
committed
82bebee
Probe XDG save data roots
CompleteDotTech
committed
edafee9
Expose read-only metadata MCP tools
CompleteDotTech
committed
4fe201b
Route menu select during multiplayer runs
CompleteDotTech
committed
c1b3a95
Include full card fields in pile state
CompleteDotTech
committed
8cd6382
Use structured route mismatch errors
CompleteDotTech
committed
a583943
Return structured glossary run errors
CompleteDotTech
committed
65eee1f
Avoid obsolete bestiary reflection API
CompleteDotTech
committed
0633f39
Normalize HTTP error response shape
CompleteDotTech
committed
64f61fc
Align Crystal Sphere tool usability flags
CompleteDotTech
committed
44f4550
Include full hand selection card metadata
CompleteDotTech
committed
dbb00be
Document abandon run menu option
CompleteDotTech
committed
d239ce7
Advertise HTTP endpoint index at root
CompleteDotTech
committed
16bfa3f
Expose endpoint index through MCP
CompleteDotTech
committed
a2505ca
Normalize profile no-data error bodies
CompleteDotTech
committed
acc28fc
Add endpoint surface audit script
CompleteDotTech
committed
4012c72
Audit safe POST endpoint validation
CompleteDotTech
committed
cc7610e
Expose upgraded flag for shop cards
CompleteDotTech
committed
5672f95
Expose full event relic option metadata
CompleteDotTech
committed
b657d41
Expose full shop item metadata
CompleteDotTech
committed
55e46bd
Expose full potion reward metadata
CompleteDotTech
committed
fb7167f
Expose full relic reward metadata
CompleteDotTech
committed
b0eff83
Audit MCP action surface coverage
CompleteDotTech
committed
58adf8b
Expose full run deck in player state
CompleteDotTech
committed
76ba661
Show run deck in markdown state
CompleteDotTech
committed
489b57e
Expose full player inventory metadata
CompleteDotTech
committed
1a5f518
Render card keywords and upgrades in markdown
CompleteDotTech
committed
a5f6b17
Audit explicit state response formats
CompleteDotTech
committed
d7dbd50
Render full item metadata in markdown
CompleteDotTech
committed
98db800
Avoid cross-account save fallback
CompleteDotTech
committed
555e381
Normalize markdown item metadata
CompleteDotTech
committed
1be80e1
Audit multiplayer POST guard
CompleteDotTech
committed
9b32200
Normalize state endpoint errors
CompleteDotTech
committed
cd9f2bd
Restrict root endpoint methods
CompleteDotTech
committed
fa0915d
Scope glossary responses to active run
CompleteDotTech
committed
3204d7f
Treat malformed action payloads as bad requests
CompleteDotTech
committed
9574496
Audit GET-only route methods
CompleteDotTech
committed
933968f
Audit state surface coverage
CompleteDotTech
committed
ed96abe
Audit MCP tool documentation
CompleteDotTech
committed
8ec1f4e
Clarify proceed action coverage
CompleteDotTech
committed
df1212d
Validate profile id integer payloads
CompleteDotTech
committed
437c457
Document scoped glossary tools
CompleteDotTech
committed
b158ec1
Exclude item self-tooltips from keywords
CompleteDotTech
committed
25ffd33
Audit keyword glossary item leaks dynamically
CompleteDotTech
committed
be68ce6
Keep scoped endpoint surfaces aligned
CompleteDotTech
committed
98d7503
Include shared pools in active glossary
CompleteDotTech
committed
f801150
Search all save account roots
CompleteDotTech
committed
d9a07f5
Include all shared card pools in glossary
CompleteDotTech
committed
5d38dd2
Expose card upgrade previews in glossary
CompleteDotTech
committed
94bed2d
Expose upgraded card previews in state payloads
CompleteDotTech
committed
54bf98b
Add upgrade previews to shop cards
CompleteDotTech
committed
7ffc394
Align shop proceed state with action behavior
CompleteDotTech
committed
3a3ee6f
Align hand can_play with action guards
CompleteDotTech
committed
838f831
Expose card selection progress state
CompleteDotTech
committed
f9b17c4
Guard card reward selection availability
CompleteDotTech
committed
e8e811c
Align event option availability state
CompleteDotTech
committed
472d7c6
Align rest option availability state
CompleteDotTech
committed
4fe67e6
Align relic selection availability state
CompleteDotTech
committed
c8c9530
Align bundle selection availability state
CompleteDotTech
committed
156b8ad
Expose shop purchase readiness
CompleteDotTech
committed
b75366f
Expose treasure relic claim readiness
CompleteDotTech
committed
f4707cf
Tighten crystal sphere visibility guards
CompleteDotTech
committed
c338ecb
Expose potion use readiness
CompleteDotTech
committed
2320878
Expose combat end turn readiness
CompleteDotTech
committed
a708c7e
Expose multiplayer end turn readiness
CompleteDotTech
committed
dc17fcd
Expose reward claim readiness
CompleteDotTech
committed
07bc7bd
Expose map travel readiness
CompleteDotTech
committed
9ca2b82
Expose potion discard readiness
CompleteDotTech
committed
e6eab0c
Expose enemy targetability state
CompleteDotTech
committed
f80ec8c
Refine enemy-targeted potion readiness
CompleteDotTech
committed
2ba30d1
Harden selection action readiness guards
CompleteDotTech
committed
edcfe99
Gate proceed actions on visible controls
CompleteDotTech
committed
39e4bcd
Expose glossary card star costs
CompleteDotTech
committed
c477a17
Align glossary card upgrade flags
CompleteDotTech
committed
5c048b0
Expose hand card target references
CompleteDotTech
committed
be26e59
Validate missing profile id
CompleteDotTech
committed
66dc3e5
Expose current run context in state
CompleteDotTech
committed
a6b0feb
Expose profile run context
CompleteDotTech
committed
4502325
Expose compendium save context
CompleteDotTech
committed
8817e98
Use mutable event state text
CompleteDotTech
committed
718da1d
Advertise profile save context
CompleteDotTech
committed
b886d57
Expose glossary save context
CompleteDotTech
committed
5612fab
Expose resolved progress paths
CompleteDotTech
committed
d5024e5
Enrich current run context
CompleteDotTech
committed
c5ae36c
Preserve glossary error context
CompleteDotTech
committed
39ff8a6
Shape bestiary metadata response
CompleteDotTech
committed
4f985ac
Harden settings endpoint shape
CompleteDotTech
committed
c5726bc
Shape profiles endpoint response
CompleteDotTech
committed
0cabf0e
Add profile endpoint envelopes
CompleteDotTech
committed
79d0551
Stabilize profile metadata ordering
CompleteDotTech
committed
c95f601
Return HTTP errors for profile actions
CompleteDotTech
committed
74ae42f
Validate state response formats
CompleteDotTech
committed
e378262
Return HTTP errors for action dispatch
CompleteDotTech
committed
1931420
Return HTTP errors for menu dispatch
CompleteDotTech
committed
9ab12b2
Shape API index response
CompleteDotTech
committed
f56c1a4
Expose API index version
CompleteDotTech
committed
1014fe7
Return non-2xx for failed actions
CompleteDotTech
committed
5c6ce11
Preserve MCP structured endpoint errors
CompleteDotTech
committed
4e51a5f
Add state endpoint response envelopes
CompleteDotTech
committed
58edc32
Normalize endpoint save paths
CompleteDotTech
committed
aa3454a
Normalize compendium history path
CompleteDotTech
committed
1698771
Describe endpoint response contexts
CompleteDotTech
committed
6f80057
Code blocking popup action errors
CompleteDotTech
committed
5200398
Code POST validation errors
CompleteDotTech
committed
71f9dde
Code route-level endpoint errors
CompleteDotTech
committed
2e87f86
Return non-2xx read availability errors
CompleteDotTech
committed
715076b
Code read endpoint failure errors
CompleteDotTech
committed
37c3735
Add fallback action error codes
CompleteDotTech
committed
5e87785
Audit static endpoint manifest parity
CompleteDotTech
committed
04f9933
Test MCP endpoint error handling
CompleteDotTech
committed
a7a8d76
Clarify action target and error docs
CompleteDotTech
committed
88885f2
Code timeline manual action errors
CompleteDotTech
committed
09dc7e3
Clarify endpoint error code contract
CompleteDotTech
committed
38c6242
Document glossary run-state errors
CompleteDotTech
committed
43e6a54
Audit MCP route helper parity
CompleteDotTech
committed
359e846
Clarify current run identity availability
CompleteDotTech
committed
418b8a7
Clarify MCP glossary run identity docs
CompleteDotTech
committed
01df37b
Harden glossary keyword tip collection
CompleteDotTech
committed
2792596
Refresh README API index example
CompleteDotTech
committed
2006023
Sort bestiary nested metadata
CompleteDotTech
committed
e7082cb
Test MCP read endpoint error propagation
CompleteDotTech
committed
14f6e0f
Sort glossary item payloads
CompleteDotTech
committed
df6ba7a
Update current run state example
CompleteDotTech
committed
3f28b32
Stabilize glossary keyword ordering
CompleteDotTech
committed
1b136aa
Handle missing run manager in glossary
CompleteDotTech
committed
ba3bd17
Audit legacy profile path normalization
CompleteDotTech
committed
be1fcde
Audit nested settings schema
CompleteDotTech
committed
3fd3eaf
Audit docs for normalized save paths
CompleteDotTech
committed
b5bcd88
Audit glossary item schemas
CompleteDotTech
committed
f5fdd2d
Audit compendium run history section
CompleteDotTech
committed
56a3640
Audit profile stats schemas
CompleteDotTech
committed
2165561
Test MCP profile actions
CompleteDotTech
committed
82855b2
Prioritize method errors before run mode guards
CompleteDotTech
committed
6ad50db
Audit unsupported endpoint methods
CompleteDotTech
committed
c4157f6
Audit profile compendium schemas
CompleteDotTech
committed
8dfd275
Audit card upgrade previews
CompleteDotTech
committed
8400282
Audit live combat state payloads
CompleteDotTech
committed
d7a16a7
Audit active run profile switch guard
CompleteDotTech
committed
363681e
Audit multiplayer route guards
CompleteDotTech
committed
a1be21d
Audit bestiary entry schemas
CompleteDotTech
committed
1a53acf
Audit settings value schemas
CompleteDotTech
committed
e1d2ae5
Audit glossary value schemas
CompleteDotTech
committed
13ec7bb
Audit profile slot schemas
CompleteDotTech
committed
a4f296f
Audit API index schema
CompleteDotTech
committed
71f0e68
Audit safe gameplay validation errors
CompleteDotTech
committed
3f1eb62
Audit current run context schemas
CompleteDotTech
committed
d68eb77
Audit profile value schemas
CompleteDotTech
committed
e51d4a5
Audit compendium run history schemas
CompleteDotTech
committed
625d9a3
Document endpoint contracts
CompleteDotTech
committed
89ab1d0
Add run save snapshots
CompleteDotTech
committed
3538b18
Document snapshot endpoint contracts
CompleteDotTech
committed
b333439