Skip to content

docs: Spec B — engine internal restructure design + plan#40

Merged
rulkens merged 1 commit intomainfrom
spec/engine-internal-restructure
May 7, 2026
Merged

docs: Spec B — engine internal restructure design + plan#40
rulkens merged 1 commit intomainfrom
spec/engine-internal-restructure

Conversation

@rulkens
Copy link
Copy Markdown
Owner

@rulkens rulkens commented May 7, 2026

Summary

Spec + 5-phase implementation plan for the engine internal restructure (the deferred follow-up from Spec A).

  • Goal: engine.ts 2377 → ~1500 lines.
  • Phases (smallest blast first): settings setter table → tween-to-galaxy helper → frame body to runFrame.ts → point-source slot registry → bootstrap IIFE to ordered phases.
  • Bespoke setters and sidecar slots stay inline (YAGNI).
  • Each phase ships independently; each preserves observable behaviour.

Files

  • docs/superpowers/specs/2026-05-08-engine-internal-restructure-design.md
  • docs/superpowers/plans/2026-05-08-engine-internal-restructure.md

Phase 1 implementer dispatched in parallel; this docs PR can merge anytime.

…tation plan

Five-phase plan extracts the 1100-line bootstrap IIFE, the 310-line per-frame
body, the 5-source slot wiring, the 3-call-site tween-to-galaxy duplication,
and the 13-setter dispatch table out of engine.ts.  Bespoke setters and
sidecar slots stay inline.

Target: engine.ts 2377 → ~1500 lines.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented May 7, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
skymap 84e58ea Commit Preview URL

Branch Preview URL
May 07 2026, 11:07 PM

@rulkens rulkens merged commit 891b364 into main May 7, 2026
2 checks passed
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.

1 participant