Ghostlight/notes/fresh-workspace-handoff.md
2026-08-23 00:16:04 +02:00

11 KiB

Ghostlight Fresh Workspace Handoff

Updated: 2026-08-22

This is the compact re-entry packet. It records current authority, deployed truth, proof, and the next decision. Git history owns chronology; the system map and architecture documents own detail.

Immediate Re-entry Instruction

Do not continue implementation automatically from a rehydrate-only request. Reconstruct the current authority map, report the next gate, and wait for the requested scope. Do not trust this file for the exact live HEAD. Git commands own volatile workspace identity and the release witness owns deployed identity.

  1. Work from F:\Projects\Ghostlight.
  2. Run git status --short, git log -1 --oneline, and npm run state:status.
  3. Read state/map.yaml (current_status first), then notes/ghostlight-current-system-map.md.
  4. Read the architecture document for the organ being changed. Do not infer runtime authority from workspace HEAD or from this handoff.
  5. For deployment, SSH, firewall, Idunn, Odin, Heimdall, or host work, consult F:\Projects\gamecult-ops before acting.

Mission and current product shape

Ghostlight Dungeon is a persistent, Vault-grounded narrative simulation. It addresses dreamlike world reconstruction, unearned NPC knowledge, inert scene participants, consequence-free player claims, and worlds that wait passively for the player.

The hosted forge supports persistent DM-led Session Zero and bounded co-op for one to eight Heimdall-authenticated players. The approved brief compiles into a stable world with actor-bound membership, private character state, fiction-first d20 resolution, persistent locations and institutions, multiresolution Gestalt agency, offscreen strategic activity, knowledge-filtered news, and actor-filtered Eve/CultMesh surfaces.

The immediate product gate is human multiplayer proof, not another foundation rewrite.

Authority map

  • SessionZeroKernel is the sole owner of pre-publication drafts, members, channels, boundaries, decisions, approvals, and the final approved digest. It separately owns the complete model-invocation audit and the exact active preview proof set; campaign publication may consume only the latter.
  • Each campaign WorldKernel mailbox is the sole owner of canonical world state and revision. Player commands, NPC proposals, ticks, travel, waits, imports, reloads, and contract amendments share its validated atomic commit path.
  • Ghostlight owns the generalized Projector → Persona → Interpreter membrane. Projectors, Personas, Interpreters, retrieval, narration, dice previews, and browsers may propose or project; none may commit canonical state.
  • Canonical actors, institutions, Gestalts, member deltas, knowledge, topology, and relationships persist independently of the derived simulation cover. Arena cells never become synthetic collective actors or union knowledge.
  • Heimdall owns account identity. campaign_membership.v1 binds an authenticated member to exactly one canonical actor.
  • Eve owns editable bindings, command invocation, command receipts, plugin composition, and lowering. Ghostlight publishes one stable ghostlight.play surface; the browser is a thin provider host and never owns login, Session Zero, campaign, governance, or receipt semantics.
  • Heimdall's gamecult.heimdall.access plugin renders anonymous and identity state. Sensitive begin, completion, refresh, and logout operations cross its private CultNet command plane; the browser retains only an opaque attempt handle and Ghostlight retains only its own hashed app session.
  • VoidBot owns Vault retrieval and evidence. Ghostlight stores exact evidence receipts, not a rival semantic index.
  • Idunn owns deployment and same-release daemon continuity. Odin owns discovery. Nginx owns the public crossing. None owns campaign mutation.
  • Epiphany consumes Ghostlight's pinned projection crate while retaining her own Mind and consequence authority. Her runtime is adjacent swarm capacity, not a Ghostlight state owner or current dependency.

Exact live Ghostlight body

Yggdrasil is production. The Starfire writer and its old tunnel are stopped. Do not start both writers.

  • Executable release: 41a1950f1dcb2215b07cee484151ca5f09a59a10
  • Executable SHA-256: b4544027e9ce19e17aae53b27abe146c96006e667c8f7d3d92b45c6545024050
  • Eve release: 23eaf32eae76204357c1406b4a7d01bcece6b815
  • Service: ghostlight-dungeon.service, running as ghostlight:ghostlight
  • Listener: Yggdrasil loopback 127.0.0.1:8831
  • Public route: https://yggdrasil.gamecult.org/ghostlight/
  • Vault retrieval: local VoidBot at 127.0.0.1:17875/mcp
  • Stored state at the last witness: seven campaigns and one Session Zero draft
  • Provider state: OpenRouter stealth/ox-alpha startup inference ready; logical fast/capable classes map to the physical model at the provider port
  • Access witness: anonymous Eve gate 200; canonical heimdall.auth.begin accepted through Odin-discovered Heimdall; no actor or campaign state in the anonymous surface. A retained Heimdall grant completed fresh authentication, and the authenticated Ghostlight app session survived exact release replacement. Scheduled refresh now uses a fresh private-command identity per attempt, accepts Heimdall's refresh-specific signed claim/session receipt, and rotates the locally wrapped claim without returning the browser to the access gate.

Manifest, embedded commit, executable hash, typed health, persistent stores, restart recovery, public crossing, and anonymous rejection agree.

Deployment and discovery truth

Idunn, Odin, and Heimdall release identity is operational truth owned by gamecult-ops; verify their current witnesses there rather than trusting an old commit copied into this handoff. At the 2026-08-22 Ghostlight witness, Idunn, Odin discovery, and Heimdall's private access plane were live. Idunn's health clock preserves millisecond timestamps; the former same-second false “health vanished” transitions are gone.

Idunn selects the newest executable- or build-affecting commit reachable from the admitted ref. Documentation, notes, state receipts, and root Markdown do not cause a deployment. The root actuator proves the selected commit is an ancestor of the admitted ref and verifies the exact installed witness after activation. Therefore later Ghostlight documentation commits do not displace release 257b642….

Epiphany capacity gate

Epiphany is adjacent capacity, not a Ghostlight runtime dependency. Idunn reported successful admission of source 785213ec297a6bb784f16e1705b0431bc82faf61 on 2026-08-22, but the legacy epiphany-ox4-heartbeat, epiphany-ox4-persona, and epiphany-ox4-swarm units subsequently reported inactive/failed. Rehydrate in Epiphany and gamecult-ops before assuming usable swarm capacity. Do not manually launch her or coordinate deployment by cross-task exclusivity messages.

Current proof

  • Idunn's exact 41a1950… release gate passed 171 Linux package tests; the daemon is healthy with zero restarts and the deployment brake re-engaged.
  • Live refresh pressure reproduced and removed two contract faults: reuse of a private-command idempotency key across separately sealed attempts, and validation of a refresh receipt as if it carried the initial-login account summary. The old due session refreshed after deployment, emitted no refresh failure across the next scheduler pulse, and the same browser cookie still projected Session Zero revision 18 after daemon replacement.
  • Adversarial Session Zero play proved that counters retire stale typed proposals before a replacement, generated openings and roles are optional, and transcript-only blank drafts cannot enter world compilation.
  • One authenticated Session Zero canary survived exact-build restarts, retrieved grounded Aetheria evidence, preserved typed state across malformed model output, and completed a Mars/Zhestokost follow-up without borrowing the First Exodus cast or geometry.
  • The solo player journey proved compilation, canonical player identity, private assessment, server-side roll, wait, restart, fork, export, reset, and continuity.
  • The 24-subject Gestalt matrix covers budgets 1, 4, 8, and 32 exactly once.
  • The strict nested-refugee golden preserves Mira Venn's exact identity and private delta through a budget-one rival arena, nested migration, background activity, folding, and later rematerialization.
  • A budget-8/provider-parallelism-8 strategic wave covered every subject, committed material background activity, and did not puppet the player.

Acceptance witnesses live under F:\GameCult\GhostlightDungeon\acceptance. Operational release and rollback truth remains in gamecult-ops.

Next action

  1. Resume the authenticated Mars/Hellas canary, compile the custom start, and pressure live action/continuity paths.
  2. Run a two-person Yggdrasil Session Zero and bounded shared-scene canary using separate Heimdall accounts.
  3. Then run the eight-account roster, privacy, actor-binding, pooled-budget, unanimous-approval, unanimous-time/travel, stale-command, and restart smoke.
  4. Continue human pressure on multiresolution Gestalt agency: meaningful background surprises, exact attributed rival activity inside arenas, information boundaries, nested fission/folding, migration, and return encounters.

Do not weaken actor custody, private projection, unanimous approval, knowledge gates, no-puppeting, or atomic-wave invariants to make the smoke pass. Do not gate this testing on Epiphany unless the test explicitly exercises her capacity.

Essential references

  • MVP authority: docs/architecture/ghostlight-dungeon-mvp.md
  • Interface authority: docs/architecture/ghostlight-eve-native-interface.md
  • Gestalt authority: docs/architecture/ghostlight-multiresolution-agency.md
  • Live system map: notes/ghostlight-current-system-map.md
  • Implementation program: notes/ghostlight-implementation-plan.md
  • Human-readable state: state/map.yaml
  • Machine-managed research state: state/ghostlight-state.cultcache.jsonl
  • Operations: F:\Projects\gamecult-ops

Re-entry warnings

  • A prompt, transcript, browser surface, model receipt, or derived simulation cover is not canonical world state.
  • A green local test is not deployment truth; verify exact manifest, witness, process, health, and public behavior.
  • Do not infer executable drift from docs-only Git drift.
  • Do not revive Starfire's retired writer or VoidBot/Qdrant writers.
  • Do not launch multiple tasks to “watch” one deployment. The owning operation returns one terminal receipt upward; task chat is not a lock service.
  • Keep this file compact. Distill current steering here and leave chronology in Git, receipts, and the deeper maps.