Skip to content

ADR 0002 + phase 1: extract gameContext descriptors, baseline serialization ownership; fix gate baseline drift - #892

Merged
Noisemaker111 merged 6 commits into
mainfrom
claude/gamecontext-refactor-decision-fu8s13
Jul 16, 2026
Merged

Noisemaker111 merged 6 commits into
mainfrom
claude/gamecontext-refactor-decision-fu8s13

Conversation

@Noisemaker111

@Noisemaker111 Noisemaker111 commented Jul 16, 2026

Copy link
Copy Markdown
Owner

What this does

Thins the gameContext.ts god factory by mechanical, behavior-preserving extraction. The deeper public systems/defineSystem authoring model stays tracked in #842 and builds on this substrate — its "systems own save/replication/reset/disposal" criteria are exactly the descriptor lifecycle contract this PR finishes wiring. Full rationale is in the #842 comment thread; no standalone architecture docs (a new CLAUDE.md rule in this PR forbids them — plans live in issues/PRs, durable knowledge in CLAUDE.md/skills/READMEs).

Extraction (behavior-identical, gameContext.ts 2043 → 1404 lines)

  • runtime/descriptors/features.tsFeatureDeps/FeatureBuild/FeatureDescriptor + the 13 opt-in descriptors, moved verbatim.
  • runtime/descriptors/baseline.ts — always-on BaselineDescriptor list owning serialization of entities/stats/store/feed/inventory (replicate+save) and economy/time/pose/possession/motion (save-only). createGameContext composes snapshotModules/saveModules from one descriptor pass; module order (snapshot key order) preserved exactly.
  • runtime/context/combatFx.ts — float text, VFX, telegraphs, hit reactions, effect-with-float wrapper.
  • runtime/context/worldItems.ts — ground-item store + spawn/pickup verbs.
  • runtime/context/registries.ts — card-pile / turn-loop / race-state registries.
  • No public API change; all new exports @internal; export manifest regenerated.

Parity proof: full suite green (4645 pass / 0 fail, incl. gameContextSave, worldSnapshot, worldReplication), check-types-all 0 errors, build green, orphan-ratchet green.

Gate drift fixes (pre-existing red on main, user-authorized)

Known remaining (pre-existing, filed as #893): check-skill-api still reports ~63 orphan primitives that the orphan gate wants baselined while the shrink-only check-orphan-ratchet forbids adding — needs adopting/@internal-ing those primitives; out of scope here.

🤖 Generated with Claude Code

https://claude.ai/code/session_015VP5PE648dXk24vD7x45ki

claude added 3 commits July 16, 2026 18:39
… runtime/descriptors (ADR 0002 phase 1)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015VP5PE648dXk24vD7x45ki
…gate drift)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015VP5PE648dXk24vD7x45ki
…enerate skill api.md

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015VP5PE648dXk24vD7x45ki
@vercel

vercel Bot commented Jul 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
jgengine-web Ignored Ignored Preview Jul 16, 2026 7:17pm

claude added 3 commits July 16, 2026 19:11
…text (ADR 0002 phase 3, first cut)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015VP5PE648dXk24vD7x45ki
… and skills

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015VP5PE648dXk24vD7x45ki
…e in issues/PRs

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015VP5PE648dXk24vD7x45ki
@Noisemaker111
Noisemaker111 merged commit f4ff3ff into main Jul 16, 2026
8 checks passed
@Noisemaker111
Noisemaker111 deleted the claude/gamecontext-refactor-decision-fu8s13 branch July 16, 2026 19:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Skill-size ratchet red on main — 8 SKILL.md files grew past baseline

2 participants