wehub-resource-sync
85453da49f
regression / regression-shards (style-16-prod style-9-prod style-17-prod iframe-render-compat variables-prod mp4-h265-sdr, shard-4) (push) Has been cancelled
regression / regression-shards (style-4-prod style-11-prod style-2-prod animejs-adapter typegpu-adapter parallel-capture-regression, shard-5) (push) Has been cancelled
regression / regression-shards (style-7-prod style-8-prod style-10-prod css-spinner-render-compat webm-transparency mp4-h264-sdr webm-vp9, shard-3) (push) Has been cancelled
regression / regression-shards (sub-composition-video style-18-prod raf-ball-render-compat font-variant-numeric sub-comp-t0 sub-comp-id-selector, shard-7) (push) Has been cancelled
Windows render verification / Detect changes (push) Has been cancelled
Windows render verification / Preflight (lint + format) (push) Has been cancelled
Windows render verification / Render on windows-latest (push) Has been cancelled
Windows render verification / Tests on windows-latest (push) Has been cancelled
CI / Detect changes (push) Has been cancelled
CI / Build (push) Has been cancelled
CI / Lint (push) Has been cancelled
CI / Fallow audit (push) Has been cancelled
CI / Format (push) Has been cancelled
CI / Typecheck (push) Has been cancelled
CI / Test (push) Has been cancelled
CI / Producer: integration tests (push) Has been cancelled
CI / Producer: unit tests (push) Has been cancelled
CI / File size check (push) Has been cancelled
CI / Test: skills (push) Has been cancelled
CI / Skills: manifest in sync (push) Has been cancelled
CI / CLI: npx shim (macos-latest) (push) Has been cancelled
CI / CLI: npx shim (ubuntu-latest) (push) Has been cancelled
CI / CLI: npx shim (windows-latest) (push) Has been cancelled
CI / SDK: unit + contract + smoke (push) Has been cancelled
CI / Test: runtime contract (push) Has been cancelled
CI / Studio: load smoke (push) Has been cancelled
CI / Smoke: global install (push) Has been cancelled
CI / CLI smoke (required) (push) Has been cancelled
CI / Semantic PR title (push) Has been cancelled
Player perf / Detect changes (push) Has been cancelled
Player perf / Preflight (lint + format) (push) Has been cancelled
Player perf / player-perf (push) Has been cancelled
Player perf / Perf: drift (push) Has been cancelled
Player perf / Perf: fps (push) Has been cancelled
Player perf / Perf: parity (push) Has been cancelled
Player perf / Perf: scrub (push) Has been cancelled
Player perf / Perf: load (push) Has been cancelled
preview-regression / Detect changes (push) Has been cancelled
preview-regression / Preflight (lint + format) (push) Has been cancelled
preview-regression / Preview parity (push) Has been cancelled
preview-regression / preview-regression (push) Has been cancelled
regression / regression (push) Has been cancelled
regression / Detect changes (push) Has been cancelled
regression / Preflight (lint + format) (push) Has been cancelled
regression / regression-shards (hdr-regression style-5-prod style-3-prod mov-prores, shard-1) (push) Has been cancelled
regression / regression-shards (overlay-montage-prod style-12-prod chat missing-host-comp-id png-sequence portrait-edge-bleed, shard-6) (push) Has been cancelled
regression / regression-shards (style-13-prod style-6-prod vignelli-stacking gsap-letters-render-compat audio-mux-parity, shard-8) (push) Has been cancelled
regression / regression-shards (style-15-prod hdr-hlg-regression style-1-prod many-cuts vfr-screen-recording render-symlinked-assets, shard-2) (push) Has been cancelled
CodeQL / Analyze (actions) (push) Has been cancelled
CodeQL / Analyze (javascript-typescript) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Docs / Validate docs (push) Has been cancelled
Sync skills to ClawHub / Publish changed skills (push) Has been cancelled
2.8 KiB
2.8 KiB
PORTING — turning a cap_fx3 demo into a first-class theme DNA
One theme at a time. The demo is the spec; the engine is the law.
Inputs
- Demo:
~/Downloads/cap_fx3/<tNN_name>/— index.html (bg: scene-reaction + apex setpiece), rail.html (fg alpha: body + furniture + front fx), postfx.json, final_fx.mp4 + strip.png (ground truth of how it should look). - Engine:
scripts/make-theme.cjs— read the header + the existing paradigms (rail/panel/poem/takeover) and setpieces (detonation/decode/drawon/assembly/ colorflip/cpslam/coverword/settle) before writing anything.
Process
- DECOMPOSE the demo: body paradigm? body entrance/exit verbs? hero setpiece? front fx? plate budget? linkages? Map each piece to an existing registry entry or mark it NEW.
- EXTEND the engine for the NEW pieces only — port the demo's GSAP logic into
generator functions, parameterized (sizes, colors, counts, seeds become DNA
params). Registries stay generic: paradigms/setpieces are the unit of code,
the DNA json is the unit of identity. Match the file's existing code style.
node --check scripts/make-theme.cjsafter every edit. - WRITE
themes/<name>.json(drop the tNN_ prefix). voice/when/register/fonts/ palette/body/hero/fx/plate/linkages — follow anchor.json + ordnance.json shape. - VERIFY on the rooftop fixture:
- scaffold:
mkdir ~/Downloads/port_<name>+ symlink source.mp4 / frames_fg / frames_bg + cp matte.fps transcript.json safe-zones.json from~/Downloads/cap_multi/rooftop/(frames_bg from~/Downloads/cap_fx/_frames_bg). - theme.json: same lines/hero the demo used (read its rail.html data).
node scripts/make-theme.cjs <dir>→preview-frames.cjs <dir> <4 key times>→ READ the previews; compare against the demo's strip.png. Iterate ≤3 rounds.- full render:
bash scripts/render-theme.sh <dir>→ extract a 12-frame strip around the apex → view → compare to the demo strip. Small deviations OK, note them; the THEME must read identically at a glance.
- scaffold:
- REGRESSION: recompile one prior theme project (e.g.
~/Downloads/cap_anchor, plus the previous port in this batch) — make-theme must still compile and a 2-frame preview must look unchanged. - REGISTER: add the identity row to CATALOG.md (voice/when/needs, author → make-theme) and a line in themes/README.md if it has one.
Hard rules
- The CONTRACT.md disciplines apply verbatim (determinism, physics doctrine,
body stability, apex-owns-frame, equal-length keyframes, fonts whitelist,
≤ DUR scheduling):
~/Downloads/cap_fx3/CONTRACT.md. - Never edit existing setpieces'/paradigms' behavior unless fixing a bug — existing themes must not change appearance.
- Do NOT commit; the orchestrator reviews and commits per batch.