Skip to content

feat: add source-backed retained-DOM Flocks adapter - #111

Open
alowpoly wants to merge 2 commits into
mainfrom
flocks
Open

feat: add source-backed retained-DOM Flocks adapter#111
alowpoly wants to merge 2 commits into
mainfrom
flocks

Conversation

@alowpoly

@alowpoly alowpoly commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add a GPL-2.0-or-later, source-pinned port of Really Slick Screensavers Flocks
  • prepare 216 seconds of the exact 4-leader/1000-follower source simulation into bounded retained-DOM desktop and mobile product banks
  • render source-derived six-face triangular bipyramids through PolyCSS with stable roots, flat currentColor lighting, and no runtime geometry or source simulation
  • follow Cyclone's prepared-loading contract: verify/decompress the active block plus eleven successors, materialize the active block plus two successors before clearing loading, and adopt bounded 960-state worker responses in main-thread idle slices
  • add production shell, adapter-scoped deploy/cache integration, independent native state/geometry oracles, full frame-sequence comparison, startup/cadence tooling, and monorepo adapter auditing

Verification

  • pnpm audit:adapters -- --slug flocks — 117/117
  • pnpm verify:source-only --strict — pass
  • pnpm test:flocks — 42/42
  • pnpm prepare:flocks:check — deterministic 458-file tree, digest 758472b6a504df46ec59981e0590b046ec4fad6b54a89aab013d1229e6ce3a0d
  • compiled native state oracle — 6,010 rows, 600 frames, zero failures
  • fresh native/browser sequence on ac8c13e — 45 frames, 14,580 root transforms, zero transform/color mismatches, stable 324 roots/1,944 leaves, zero browser errors
  • desktop cadence, three installed-Chrome runs — presented-frame p95 16.667-16.720 ms; worst DrawFrame 19.016-27.115 ms; zero app long tasks or block waits; 59.949-60.080 Hz publication
  • Cyclone-standard startup horizon — 12 verified/decompressed blocks and three materialized blocks before readiness; 63 worker chunks adopted in 63 idle slices
  • startup median — desktop 1,033.77 ms; mobile profile 599.80 ms
  • maximum initial encoded transfer — desktop 601,215 B; mobile profile 305,342 B
  • maximum resident prepared CSS strings — desktop 15,664,056 B; mobile profile 7,863,196 B
  • 30-second desktop and mobile-profile playback — zero block waits, stale responses, materialization/playback long tasks, browser errors, or retained-DOM drift
  • pnpm build:flocks:deploy && pnpm test:flocks:deploy && pnpm test:site — pass; cache-busted route ready in 986.1 ms with the complete startup horizon and zero request/page/debug errors

Product boundaries

  • desktop product prefix: 324 of 1,004 source bugs
  • mobile product prefix: 164 of 1,004 source bugs
  • root color publication: 12 Hz staggered phases; transforms remain 60 Hz
  • flat face lighting is a documented bounded deviation from source OpenGL lighting
  • the 216-second exact-source bank closes through a documented prepare-only eight-second terminal bridge
  • no landing-page project was added and nothing was deployed to production

Known limitation

A real USB-connected Chrome cadence trace was explicitly skipped and remains unproven. The mobile profile has correctness, startup, payload, residency, and desktop-Chrome evidence, but this PR does not claim physical-device performance qualification.

@netlify

netlify Bot commented Aug 20, 2026

Copy link
Copy Markdown

Deploy Preview for cssgraphics ready!

Name Link
🔨 Latest commit ac8c13e
🔍 Latest deploy log https://app.netlify.com/projects/cssgraphics/deploys/6a86e6876241f800086a1510
😎 Deploy Preview https://deploy-preview-111--cssgraphics.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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