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
50 lines
2.8 KiB
Markdown
50 lines
2.8 KiB
Markdown
# 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
|
|
|
|
1. 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.
|
|
2. 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.cjs` after every edit.
|
|
3. WRITE `themes/<name>.json` (drop the tNN\_ prefix). voice/when/register/fonts/
|
|
palette/body/hero/fx/plate/linkages — follow anchor.json + ordnance.json shape.
|
|
4. 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.
|
|
5. 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.
|
|
6. 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.
|