drwily/gogobee
1
0
Fork 0
mirror of https://github.com/prosolis/gogobee.git synced 2026-07-15 08:32:41 +00:00
Code Issues Packages Projects Releases Wiki Activity

Branching zones G1–G4: schema, graph types, legacy compiler, run-state dual-write

Browse Source 
G1 — schema. Adds zone_node + zone_edge tables and three columns to
dnd_zone_run (current_node, visited_nodes, node_choices). Linear
columns stay during the migration; G9 retires them.

G2 — types + validator. New internal/plugin/zone_graph.go defines
ZoneNode/ZoneEdge/ZoneGraph + ZoneNodeKind/ZoneEdgeLockKind. BuildGraph
enforces: exactly one entry, exactly one boss, boss reachable via BFS,
no orphan nodes, no self-loops without explicit opt-in. BuildLinearGraph
synthesizes a chain for legacy zones.

G3 — legacy compiler + dual-mode loader. compileLegacyZoneGraph turns
a ZoneDefinition into a representative linear graph (MaxRooms shape).
loadZoneGraph returns the registered graph if hand-authored (G7+),
else the legacy fallback. compileRunGraph mirrors a per-run RoomSeq
exactly for hot-swap derivations.

G4 — run-state dual-write. DungeonRun gains CurrentNode / VisitedNodes
/ NodeChoices. scanZoneRun reads them and hot-swaps current_node from
current_room when a row predates the migration (deriveLegacyNodeID
matches BuildLinearGraph's "<zone>.r<n>" scheme). startZoneRun and
markRoomCleared write both columns.

No behavior change yet — navigation surface (forks, locked edges,
!zone go) lands in G5.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
prosolis
2026-05-09 14:34:05 -07:00
parent 57b6e009ec
commit a413c92844
4 changed files with 718 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
internal/db/db.go
View File

@@ -306,6 +306,13 @@ func runMigrations(d *sql.DB) error {
`ALTER TABLE player_meta ADD COLUMN title TEXT NOT NULL DEFAULT ''`,
`ALTER TABLE player_meta ADD COLUMN treasures_locked INTEGER NOT NULL DEFAULT 0`,
`ALTER TABLE player_meta ADD COLUMN crafts_succeeded INTEGER NOT NULL DEFAULT 0`,
// Adv 2.0 Phase G1 — branching zone graph run-state columns.
// current_node / visited_nodes / node_choices live alongside the
// legacy current_room / room_seq_json during the migration; the
// linear columns retire in G9 (gogobee_branching_zones_plan.md §2).
`ALTER TABLE dnd_zone_run ADD COLUMN current_node TEXT NOT NULL DEFAULT ''`,
`ALTER TABLE dnd_zone_run ADD COLUMN visited_nodes TEXT NOT NULL DEFAULT '[]'`,
`ALTER TABLE dnd_zone_run ADD COLUMN node_choices TEXT NOT NULL DEFAULT '{}'`,
}
for _, stmt := range columnMigrations {
if _, err := d.Exec(stmt); err != nil {
@@ -1809,6 +1816,39 @@ CREATE TABLE IF NOT EXISTS dnd_known_recipe (
PRIMARY KEY (user_id, recipe_id)
);
-- ── Adv 2.0 Phase G1 — branching zone graph (zones as directed graphs) ────
-- Replaces the linear room_seq_json model with a directed-graph topology.
-- A zone has many nodes (rooms, forks, secrets, boss) and edges connecting
-- them. Edges may be locked behind Perception checks, keys, level gates,
-- or region-clear flags. Authoring lives in Go (registerZoneGraph); these
-- tables are the persisted shape for runtime lookups + future tooling.
-- See gogobee_branching_zones_plan.md §2 for the full schema rationale.
CREATE TABLE IF NOT EXISTS zone_node (
node_id TEXT PRIMARY KEY, -- "crypt_valdris.entry"
zone_id TEXT NOT NULL,
region_id TEXT NOT NULL DEFAULT '', -- empty for single-region zones
kind TEXT NOT NULL, -- entry|exploration|trap|elite|boss|harvest|rest_camp|secret|fork|merge
label TEXT NOT NULL DEFAULT '', -- human-readable for !zone map
is_entry INTEGER NOT NULL DEFAULT 0,
is_boss INTEGER NOT NULL DEFAULT 0,
pos_x INTEGER NOT NULL DEFAULT 0,
pos_y INTEGER NOT NULL DEFAULT 0,
content_json TEXT NOT NULL DEFAULT '{}'
);
CREATE INDEX IF NOT EXISTS idx_zone_node_zone ON zone_node(zone_id);
CREATE TABLE IF NOT EXISTS zone_edge (
edge_id INTEGER PRIMARY KEY AUTOINCREMENT,
zone_id TEXT NOT NULL,
from_node TEXT NOT NULL, -- FK-ish: zone_node.node_id
to_node TEXT NOT NULL, -- FK-ish: zone_node.node_id
lock_kind TEXT NOT NULL DEFAULT 'none', -- none|perception_check|key_required|level_min|region_clear|stat_check
lock_data_json TEXT NOT NULL DEFAULT '{}',
hint TEXT NOT NULL DEFAULT '',
weight INTEGER NOT NULL DEFAULT 1
);
CREATE INDEX IF NOT EXISTS idx_zone_edge_from ON zone_edge(zone_id, from_node);
-- ── Adv 2.0 Phase L2 step 5 — player_meta ──────────────────────────────────
-- Holding pen for non-stat per-user state migrating off adventure_characters
-- (gogobee_legacy_migration.md §2.1). Each L-phase ALTER TABLEs in the