@litfamily/litgravity 0.1.1 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +46 -0
- package/README.md +19 -3
- package/README_ko-KR.md +19 -3
- package/TRADEMARK.md +12 -0
- package/package.json +3 -2
- package/plugin/hooks/lib/lanes.mjs +65 -0
- package/plugin/hooks/lib/liveness.mjs +81 -0
- package/plugin/hooks/lib/motion.mjs +34 -5
- package/plugin/hooks/lib/reentry.mjs +7 -0
- package/plugin/hooks/lib/rewind/brief.mjs +364 -0
- package/plugin/hooks/lib/rewind/collect.mjs +359 -0
- package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
- package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
- package/plugin/hooks/lib/rewind/redact.mjs +60 -0
- package/plugin/hooks/lib/rewind/transcripts.mjs +214 -0
- package/plugin/hooks/lib/routes.mjs +79 -5
- package/plugin/hooks/lib/workflow-stack.mjs +213 -0
- package/plugin/hooks/post-tool-use.mjs +39 -1
- package/plugin/hooks/pre-invocation.mjs +93 -2
- package/plugin/hooks/session-start.mjs +26 -3
- package/plugin/hooks/stop.mjs +55 -6
- package/plugin/hud/looks.mjs +29 -0
- package/plugin/hud/render.mjs +277 -12
- package/plugin/plugin.json +1 -1
- package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
- package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
- package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
- package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
- package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
- package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
- package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
- package/plugin/skills/lit-adhd/SKILL.md +160 -0
- package/plugin/skills/lit-adhd/references/card-examples.md +107 -0
- package/plugin/skills/lit-adhd/references/status-taxonomy.md +34 -0
- package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
- package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
- package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
- package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
- package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
- package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
- package/plugin/skills/lit-docx/SKILL.md +3 -3
- package/plugin/skills/lit-handoff/SKILL.md +1 -0
- package/plugin/skills/lit-hijack/SKILL.md +263 -0
- package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
- package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
- package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
- package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
- package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
- package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
- package/plugin/skills/lit-plan/SKILL.md +3 -2
- package/plugin/skills/lit-plan/references/plan-contract.md +12 -1
- package/plugin/skills/lit-plan/scripts/check-plan.mjs +39 -3
- package/plugin/skills/lit-plan/templates/plan.md +3 -0
- package/plugin/skills/lit-pptx/SKILL.md +8 -8
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
- package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
- package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
- package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
- package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
- package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
- package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
- package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
- package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
- package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
- package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
- package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
- package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
- package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
- package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
- package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
- package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
- package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
- package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
- package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
- package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
- package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
- package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
- package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
- package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
- package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
- package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
- package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
- package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
- package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
- package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
- package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
- package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
- package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
- package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
- package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
- package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
- package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
- package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
- package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
- package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
- package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
- package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
- package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
- package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
- package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
- package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
- package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
- package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
- package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
- package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
- package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
- package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
- package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
- package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
- package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
- package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
- package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
- package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
- package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
- package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
- package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
- package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
- package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
- package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
- package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
- package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
- package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
- package/plugin/skills/lit-schematic/SKILL.md +114 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
- package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
- package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
- package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
- package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
- package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
- package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
- package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
- package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
- package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
- package/plugin/skills/lit-schematic/references/verification.md +100 -0
- package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
- package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
- package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
- package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
- package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
- package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
- package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
- package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
- package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
- package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
- package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
- package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
- package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
- package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
- package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
- package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
- package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
- package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
- package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
- package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
- package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
- package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
- package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
- package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
- package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
- package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
- package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
- package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
- package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
- package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
- package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
- package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
- package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
- package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
- package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
- package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
- package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
- package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
- package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
- package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
- package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
- package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
- package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
- package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
- package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
- package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
- package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
- package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
- package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
- package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
- package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
- package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
- package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
- package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
- package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
- package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
- package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
- package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
- package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
- package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
- package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
- package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
- package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
- package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
- package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
- package/plugin/skills/litresearch/SKILL.md +1 -0
- package/plugin/skills/readme-studio/SKILL.md +2 -0
- package/plugin/skills/review-work/SKILL.md +1 -1
- package/plugin/skills/start-work/SKILL.md +2 -2
|
@@ -1,100 +1,70 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
A type-path film is finished in rounds. Each round looks before it encodes, so the expensive full render
|
|
4
|
-
runs on a brief whose frames have already been seen. The round counter (1 to 3, `MAX_ROUNDS`) is the same
|
|
5
|
-
one the look rounds in `references/look.md` use.
|
|
1
|
+
# Craft loop and QA gate
|
|
6
2
|
|
|
7
3
|
## One round (MO-C-15)
|
|
8
4
|
|
|
9
|
-
|
|
10
|
-
checks the treatment, runs the pre-flight (fonts present and hash-verified, every glyph covered, the
|
|
11
|
-
timeline valid) and writes the beat stills, one transition strip per cut and a contact sheet into
|
|
12
|
-
`<dir>/stills/`. Nothing is encoded in this step.
|
|
13
|
-
2. **Look.** Open every file listed in `<dir>/stills/index.json` with `read_file`. Answer the look
|
|
14
|
-
questions: no type clipped at the frame edge, no empty frame at a cut, every line legible at its size,
|
|
15
|
-
only the preset's palette, the accent used at most once, no working title, file name or uninvited index
|
|
16
|
-
on screen. Record the round with `motion.mjs look --out <dir> --round N --answers <file>`.
|
|
17
|
-
3. **Fix.** Change the brief where a still is wrong: another scene, another preset, tighter copy. When the
|
|
18
|
-
brief changed, run step 1 again.
|
|
19
|
-
4. **Full render.** `motion.mjs make <dir>/brief.json --out <dir> --round N` renders the master with its
|
|
20
|
-
sound bed, the preview, the poster, the reduced-motion still, a determinism re-render in a second
|
|
21
|
-
process, a perf run of at least 120 frames, and the full gate into `gate-report.txt`.
|
|
22
|
-
5. **Read the verdict.** Exit 13 means a rule failed. Read `gate-report.txt`, fix the named rule, and
|
|
23
|
-
start the next round at step 1. `motion.mjs gate <dir>` reruns the gate alone on an existing render.
|
|
24
|
-
|
|
25
|
-
## When to stop (MO-C-16)
|
|
26
|
-
|
|
27
|
-
- **Done:** a valid treatment, the line `QA gate: PASS`, and at least two recorded look rounds, the first
|
|
28
|
-
a stills round that names its change and the last stamped with the stills of the final full render. The
|
|
29
|
-
LitGravity Stop hook checks this through `engine/node/done.mjs` and the `read_file` calls it saw.
|
|
30
|
-
- **Round 3 still failing:** stop. Report the failing rules and what each round changed. The film and
|
|
31
|
-
its exports stay under their names for the user to judge, with one exception below.
|
|
32
|
-
- **Flash audit failed (MO-C-03), in any round:** the master, preview, poster and reduced-motion still
|
|
33
|
-
move into `<dir>/withheld/`. They are diagnostics, and nobody receives them, even as a draft. The
|
|
34
|
-
reply says the render is withheld until the flashes are fixed.
|
|
35
|
-
- **Blocked environment** (exit 10, 11, 12, 14 or 15): stop at once and name the fix. More rounds cannot
|
|
36
|
-
supply a missing browser, encoder or runtime.
|
|
37
|
-
- **Perf alone (MO-D-02):** a frame-time failure by itself still delivers the film, with the report.
|
|
38
|
-
- **Never** answer a failure by shortening the film, dropping a shot or switching the sound off.
|
|
39
|
-
|
|
40
|
-
## The flash audit (MO-C-03)
|
|
5
|
+
Rounds share one counter (1-3) with the look rounds in `look.md`.
|
|
41
6
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
7
|
+
1. `make brief.json --out <dir> --round N --stills-only`: treatment check, pre-flight gate (fonts,
|
|
8
|
+
glyph coverage, timeline), the beat stills, one transition strip per cut, the contact sheet and the
|
|
9
|
+
storyboard `board.png` in `<dir>/stills/`. Nothing is encoded yet. The brief carries no `style`: the
|
|
10
|
+
treatment's style decides the preset.
|
|
11
|
+
2. **Look.** Open every file the stills index lists with the Read tool and answer the look questions
|
|
12
|
+
in `look.md`: nothing clipped at the edges, no empty frame at a cut, type legible at its size, the
|
|
13
|
+
preset's palette and nothing else, the accent at most once, no working title or index on screen.
|
|
14
|
+
Record the round with `look --round N`.
|
|
15
|
+
3. Fix the brief (a different scene, a different style, better copy) where a still is wrong; rerun
|
|
16
|
+
step 1 when you changed it.
|
|
17
|
+
4. `make brief.json --out <dir> --round N`: master with the sound bed, preview, poster,
|
|
18
|
+
reduced-motion still, a second-process determinism re-render, a perf run and the full gate.
|
|
19
|
+
5. On exit 13 read `gate-report.txt`, fix the named rule, and start the next round from step 1.
|
|
52
20
|
|
|
53
|
-
##
|
|
21
|
+
## Stop conditions (MO-C-16)
|
|
54
22
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
23
|
+
- Done follows `look.md`: gate PASS, a valid treatment, at least two look rounds (the round-1
|
|
24
|
+
stills round with its change, then a last round on the final full render's stills).
|
|
25
|
+
- Round 3 still failing: stop and report the failed rules and what each round changed. The film
|
|
26
|
+
and exports are kept at their names for the user's judgment, except after a flash-audit FAIL.
|
|
27
|
+
- **Flash-audit (MO-C-03) FAIL in any round:** the MP4, preview, poster and still move to
|
|
28
|
+
`withheld/`. They are diagnostics, never deliverables, not even as a draft. Say the render is
|
|
29
|
+
withheld pending a fix.
|
|
30
|
+
- A blocked environment (exit 10, 11, 12, 14, 15): stop at once and name the fix; more rounds cannot
|
|
31
|
+
repair a missing host tool.
|
|
32
|
+
- A frame-time (MO-D-02) FAIL alone still delivers the film with the report.
|
|
33
|
+
- Never answer a failure by shortening the film, dropping a shot, or switching the sound to none.
|
|
61
34
|
|
|
62
35
|
## Gate table
|
|
63
36
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
a render pass.
|
|
37
|
+
Numbers marked provisional are the spec's proposed defaults, implemented as written until the
|
|
38
|
+
user signs them off; the report labels them.
|
|
67
39
|
|
|
68
|
-
| Rule | Threshold |
|
|
40
|
+
| Rule | Threshold | Typical fix |
|
|
69
41
|
| --- | --- | --- |
|
|
70
|
-
| MO-C-01
|
|
71
|
-
| MO-C-02 WebGL2 | renderer recorded;
|
|
72
|
-
| MO-C-03 flash |
|
|
73
|
-
| MO-C-04 title-safe | every glyph
|
|
74
|
-
| MO-C-05 action-safe (provisional) |
|
|
75
|
-
| MO-C-06 contrast (provisional) | 4.5:1, or 3:1 at
|
|
76
|
-
| MO-C-07/08 reading time (provisional) | the floor in
|
|
77
|
-
| MO-A-13 eojeol |
|
|
78
|
-
| MO-A-15 /
|
|
79
|
-
| MO-C-09 / MO-A-25 determinism | identical `rgbaSha256` in a second process; seeked
|
|
80
|
-
| MO-C-10/11/12
|
|
81
|
-
| MO-C-13 sizes (provisional) | preview
|
|
82
|
-
| MO-C-14 reduced-motion still (provisional) | present
|
|
83
|
-
| MO-C-25 tracking (provisional) | display
|
|
84
|
-
| MO-
|
|
85
|
-
| MO-C-
|
|
86
|
-
| MO-C-
|
|
87
|
-
| MO-
|
|
88
|
-
| MO-D-
|
|
89
|
-
| MO-D-
|
|
90
|
-
| MO-
|
|
91
|
-
| MO-
|
|
92
|
-
| MO-A-33, MO-A-58, MO-A-37..41 | Hangul only in the Pretendard pair or Galmuri; post overrides in range, invert only on cuts and held two beats; every export and a canonical timeline present | |
|
|
42
|
+
| MO-C-01 GLSL presence | every frame covered by a look pass that drew | never remove the preset's passes |
|
|
43
|
+
| MO-C-02 WebGL2 tier | renderer recorded; software GL labelled | none (environment) |
|
|
44
|
+
| MO-C-03 flash audit | <= 3 general and <= 3 red flashes in every 1 s window, master (non-looping) and preview (looping); excursion method, 640x360 window | fewer, slower large changes; no full-frame flips |
|
|
45
|
+
| MO-C-04 title-safe | every glyph bbox inside x 96–1824, y 54–1026 | shorter line, smaller size |
|
|
46
|
+
| MO-C-05 action-safe (provisional) | non-glyph marks inside x 48–1872, y 27–1053 | move the mark |
|
|
47
|
+
| MO-C-06 contrast (provisional size rule) | 4.5:1, or 3:1 at >= 32 px (>= 25 px bold) | use the type colour, not the signal, for small text |
|
|
48
|
+
| MO-C-07/08 reading time (provisional) | the floor function in type-craft.md | fewer words per shot, or `hold` |
|
|
49
|
+
| MO-A-13 eojeol | reveals are whole eojeol / items | keep items whole |
|
|
50
|
+
| MO-A-15 / 16 beat | cuts within 1 frame of a beat; shots >= 2 beats | engine-generated; check custom `hold` |
|
|
51
|
+
| MO-C-09 / MO-A-25 determinism | byte-identical `rgbaSha256` in a second process; seeked equals sequential | a scene read a clock or random: fix the scene |
|
|
52
|
+
| MO-C-10/11/12 | >= 1920x1080, >= 30 fps, >= 3 s; ffprobe yuv420p / bt709 / tv | engine-set |
|
|
53
|
+
| MO-C-13 sizes (provisional) | preview <= 3 MB, poster <= 1 MB; MP4 warn > 100 MB / 10 s | the preview ladder steps down itself |
|
|
54
|
+
| MO-C-14 reduced-motion still (provisional) | present; ink >= 0.9x the final text frame | end on a settled end card |
|
|
55
|
+
| MO-C-25 tracking (provisional) | display >= -0.04 em; machine voice never negative | |
|
|
56
|
+
| MO-C-26 line height | >= 1.5 Latin / 1.6 Korean for 2+ lines | |
|
|
57
|
+
| MO-C-27 measure | Latin paragraph cards 60–75 ch | |
|
|
58
|
+
| MO-C-29 accent (provisional) | <= 1 signal + 1 accent saturated cluster; accent in one entry, <= 10% of frames | remove the extra colour |
|
|
59
|
+
| MO-D-02 perf (provisional) | p95 <= 40 ms (hardware) / 250 ms (software) at samples 1 over >= 120 frames, each timed as the next frame of a sequence | lower octaves; never withholds |
|
|
60
|
+
| MO-D-03 empty frames (provisional) | no empty near-black run longer than 2x the minimum hold (+1 s at the ends) | a scene that failed to paint |
|
|
61
|
+
| MO-D-04 glyphs (provisional) | every character in its run's font | change the text or style |
|
|
62
|
+
| MO-SH-01..11 | seed formula, event budget, glitch/surge/flicker caps, dither seed per shot, guides off, <= 2 terminal layers, software downgrade | engine-enforced; report any FAIL as an engine defect |
|
|
63
|
+
| MO-A-33, MO-FT-04, MO-A-58 | Hangul weights from the lit-pptx pair only; no tracking or width motion on Hangul; post overrides in range, invert only on cuts | |
|
|
93
64
|
|
|
94
|
-
##
|
|
65
|
+
## Report (MO-C-17)
|
|
95
66
|
|
|
96
|
-
`gate-report.txt`
|
|
97
|
-
WebGL2 tier, one line per
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
asks for detail, and never soften a FAIL into a pass.
|
|
67
|
+
`gate-report.txt` starts with the fixed render-report block (outputs, preset and why, duration,
|
|
68
|
+
passes, WebGL2 tier, one line per MO-C-01..14 rule, rounds, frames viewed from `look.json`), then one line each for
|
|
69
|
+
MO-C-25/26/27/29 and MO-D-02/03/04, then every other enforced rule. Quote its verdict line and any
|
|
70
|
+
FAIL lines to the user; do not paraphrase a FAIL into a pass.
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# Depth: the 3D route
|
|
2
|
+
|
|
3
|
+
Read this when the treatment's subject is a `depth3d` device (`depth: "3d"`), or when a cover takes
|
|
4
|
+
the `hero-3d` recipe. A drawn 3D object is the right subject when the film is about a thing that has
|
|
5
|
+
a back and an inside: a product that turns, opens, unfolds or is assembled. A flat diagram, a chart or
|
|
6
|
+
type does not need it; keep those on the 2D page.
|
|
7
|
+
|
|
8
|
+
## What the renderer gives you
|
|
9
|
+
|
|
10
|
+
- **A pinned three.js.** The skill ships three.js r170 (npm `three@0.170.0`, MIT) in
|
|
11
|
+
`engine/vendor/three/`: the unminified `three.module.js` plus two addons,
|
|
12
|
+
`environments/RoomEnvironment.js` and `geometries/RoundedBoxGeometry.js`. The renderer serves them at
|
|
13
|
+
`/lit/three/`; a page imports them through an import map:
|
|
14
|
+
|
|
15
|
+
```html
|
|
16
|
+
<script type="importmap">{ "imports": { "three": "/lit/three/three.module.js", "three/addons/": "/lit/three/addons/" } }</script>
|
|
17
|
+
<script type="module">
|
|
18
|
+
import * as THREE from "three";
|
|
19
|
+
import { RoomEnvironment } from "three/addons/environments/RoomEnvironment.js";
|
|
20
|
+
</script>
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Any other path under `/lit/three/` is refused as a missing file, and the network rules still hold:
|
|
24
|
+
never load three.js, a model or a texture from a CDN. The file hashes and the licence are in
|
|
25
|
+
`engine/THIRD_PARTY_NOTICES`.
|
|
26
|
+
- **The GPU rung.** A `depth: 3d` film and a `hero-3d` cover start Chrome on the platform's GPU rung
|
|
27
|
+
(ANGLE on Metal on macOS, GL on Linux, D3D11 on Windows), with GPU rasterization of the page
|
|
28
|
+
itself still off. The renderer records the WebGL renderer string, and the gate's WebGL line names
|
|
29
|
+
the rung and the renderer. The same determinism replay runs as on the software rung: a fresh
|
|
30
|
+
browser on the same rung must reproduce the sampled frames pixel for pixel, or the render stops with
|
|
31
|
+
exit 18. On an Apple M-series Mac the 3D test page and the `hero-3d` cover replayed identically.
|
|
32
|
+
- **A labelled fallback.** When the GPU rung cannot start, or starts without WebGL, the render
|
|
33
|
+
reopens on the software rung (SwiftShader), adds a warning to the report and the manifest naming
|
|
34
|
+
the reason, and records `rung: "software"`. The film still renders, more slowly. Say in the reply
|
|
35
|
+
that it rendered without the GPU. Only when neither rung has WebGL is it exit 11.
|
|
36
|
+
|
|
37
|
+
The rung is chosen from the treatment (`depth`) or the cover recipe, never by the page.
|
|
38
|
+
|
|
39
|
+
## The scaffold's world
|
|
40
|
+
|
|
41
|
+
`motion.mjs scaffold` on a `depth: 3d` treatment adds, on top of the 2D shots:
|
|
42
|
+
|
|
43
|
+
- `<canvas id="world">` behind every shot's section, so the type stays DOM text the QA can read;
|
|
44
|
+
- one renderer for the whole film (alpha, `preserveDrawingBuffer`, pixel ratio 1, ACES tone mapping,
|
|
45
|
+
soft shadows), a `RoomEnvironment` for reflections, a key light with a biased shadow, a hemisphere
|
|
46
|
+
light in the style's colours and a shadow-only floor;
|
|
47
|
+
- `HERO`, a group that holds the protagonist from the first frame to the last;
|
|
48
|
+
- `aim(layout)`, which offsets the camera so the world origin lands on the centre of the shot's subject
|
|
49
|
+
zone; a `hero` layout shot therefore fills the frame and a `split` shot keeps the object on its side;
|
|
50
|
+
- `WORLD[i](s, hero, cam, t)`, one function per shot that poses the hero, the camera and anything else
|
|
51
|
+
as a function of the shot (`s.p`, `s.local`, `s.enter(...)`).
|
|
52
|
+
|
|
53
|
+
Build the protagonist once, in `HERO`, and only pose it per shot: that is what makes it the same
|
|
54
|
+
object across the film. For a named product, start from its real logo and screens: a fetched logo or
|
|
55
|
+
screenshot goes on a plane or a face of the object as a texture (`TextureLoader` on the file under
|
|
56
|
+
`stage/assets/`); a simple logo shape can be traced into a `THREE.Shape` and given depth with
|
|
57
|
+
`ExtrudeGeometry`.
|
|
58
|
+
|
|
59
|
+
## Craft and the gate
|
|
60
|
+
|
|
61
|
+
- **Turn slowly.** A full turn takes the loop (a cover) or a whole shot (a film). Fast spins, a flicker
|
|
62
|
+
of specular highlights and shadow acne all read as flashes and fail MO-C-03.
|
|
63
|
+
- **Bias the shadow.** On a turning object set `shadow.bias` about -0.0004 and `shadow.normalBias`
|
|
64
|
+
about 0.03; without them the self-shadow flickers frame to frame.
|
|
65
|
+
- **Ease every open and close.** A lid, a drawer or an exploded view eases in and out (`ease.smooth`),
|
|
66
|
+
holds, and returns; the move is the beat, so it happens once, where the treatment's story puts it.
|
|
67
|
+
- **Keep the type in the DOM.** Copy stays in the shot's type zone as HTML text over the canvas;
|
|
68
|
+
text drawn inside the 3D scene is invisible to the QA unless registered with `LitStage.text`.
|
|
69
|
+
- **Mind the dead air.** A small object on a large empty ground is `DEAD-AIR`; frame it with the
|
|
70
|
+
`hero` layout or move the camera in.
|
|
71
|
+
- **Covers at 20 fps.** The cover gate measures on a 50 ms grid; at 25 fps a smooth turn lands two
|
|
72
|
+
frames on one step at the seam (FLOOR), at 20 fps every step is one frame (TARGET). Encode at q94:
|
|
73
|
+
smooth light surfaces blotch at the default q86.
|
|
74
|
+
|
|
75
|
+
## Camera moves and the flash audit
|
|
76
|
+
|
|
77
|
+
A rich film moves its camera in at least half its shots, and the flash audit stays exactly as it is.
|
|
78
|
+
When a move fails MO-C-03, keep the move and change what it passes over: slow the light change (a
|
|
79
|
+
highlight that sweeps over 0.5 s or more, not a frame), lower the contrast of the detail behind the
|
|
80
|
+
move, add motion blur (the Blender rung renders it; on the GPU rung average 4-8 sub-frame poses), or cut
|
|
81
|
+
instead of whipping. Removing the camera move is a downgrade.
|
|
82
|
+
|
|
83
|
+
## The Blender rung (`render3d: "blender"`)
|
|
84
|
+
|
|
85
|
+
For path-traced light (bevels that catch it, soft global illumination, depth of field, motion blur) a
|
|
86
|
+
3D film can render its world in Blender with Cycles. The page then shows the rendered plate and keeps
|
|
87
|
+
its type, labels and 2D layers in the DOM over it.
|
|
88
|
+
|
|
89
|
+
Take this rung when the request asks for high-quality, cinematic or photoreal 3D (고퀄리티, 고품질,
|
|
90
|
+
시네마틱, 실사, cinematic, photoreal, high-quality, Blender) and Blender is installed: `scaffold` prints
|
|
91
|
+
`BLENDER:` with the path when both hold. On an Apple M-series GPU a full hero scene rendered at 8-10 s
|
|
92
|
+
per 1080p frame at 160 samples, so a 13 s plate (390 frames) takes about an hour. Settle the scene on
|
|
93
|
+
the preview stills first, since a fix after the final means rendering the plate again, and build the
|
|
94
|
+
page's panels while it renders.
|
|
95
|
+
|
|
96
|
+
1. Set `depth: 3d`, a `depth3d` subject and `render3d: "blender"`.
|
|
97
|
+
2. Write `stage/scene.py`, a Blender Python scene. It runs inside the bundled runner with `bpy`,
|
|
98
|
+
`math`, `Vector` and `lit` in scope; times are film seconds and the plate starts at frame 1:
|
|
99
|
+
`lit.camera(location, target, lens, dof=(distance, fstop))`, `lit.area_light(name, location, target,
|
|
100
|
+
power, size, color)`, `lit.world(color, strength)`, `lit.material(name, color, roughness, metallic,
|
|
101
|
+
emission, strength)`, `lit.rounded_box(name, size, radius, segments, material, location)`,
|
|
102
|
+
`lit.image_card(name, path, width, location)` (a fetched product image as a card) and
|
|
103
|
+
`lit.key(obj, prop, t, value)`. The scene must set a camera. The command line sets size, samples,
|
|
104
|
+
device, fps and frames; the scene sets everything else.
|
|
105
|
+
3. `motion.mjs blender --out <dir>` renders preview stills at the beat midpoints (50 %, 40 samples) into
|
|
106
|
+
`stage/plate-preview/`. Open them, compare them with any reference frames the user gave, and fix
|
|
107
|
+
`scene.py` before the final.
|
|
108
|
+
4. `motion.mjs blender --out <dir> --final` renders the plate (full size, 160 samples, motion blur,
|
|
109
|
+
30 fps, `stage/plate/000001.png ...`) detached with a progress file; it can take most of an hour.
|
|
110
|
+
It writes `plate.json`, which lists every frame by name and size with the Blender version, device and
|
|
111
|
+
samples. Listed plate frames are not counted as page rasters; any other frame sequence is still a
|
|
112
|
+
flipbook (exit 17).
|
|
113
|
+
5. On the page, `const show = LitStage.plate({ parent, count, fps: 30 })` returns `show(t)`; call it from
|
|
114
|
+
`render(t)`. The page renders on the software rung, and the stage refuses to start (exit 17) when the
|
|
115
|
+
plate is missing or does not cover the film.
|
|
116
|
+
|
|
117
|
+
Blender is found from `LITGRAVITY_BLENDER` (used only if it exists), the macOS app
|
|
118
|
+
(`/Applications/Blender.app/Contents/MacOS/Blender`) or `blender` on PATH, and runs as `blender -b
|
|
119
|
+
--factory-startup -P runner.py -- ...`, on Metal on Apple silicon, another GPU backend next, the CPU
|
|
120
|
+
last; the receipt says which. Without Blender the command renders nothing and prints `FALLBACK`: set
|
|
121
|
+
`render3d` to `three`, build the world in three.js on the GPU rung, and say so in the reply. The report
|
|
122
|
+
and manifest name the plate (Blender version, Cycles device, samples).
|
|
@@ -1,157 +1,122 @@
|
|
|
1
|
-
# Look rounds and
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
what is visible there.
|
|
39
|
-
|
|
40
|
-
1. **Who is it for?** Write down the sentence a stranger would say. Get it blind when you can: spawn
|
|
41
|
-
a read-only child with `invoke_subagent` (`TypeName` `quality-reviewer`), hand it only
|
|
42
|
-
the contact sheet and the beat stills, never the request or the treatment, and record its sentence
|
|
43
|
-
verbatim with `by: "blind"`. If no child can run, answer it yourself with `by: "self"`. The
|
|
44
|
-
verdict says whether that sentence matches the treatment's audience and subject.
|
|
45
|
-
2. Does every beat show what its `onScreen` plan promised?
|
|
46
|
-
3. Is the craft at the level `ambition` asks for: transitions, rhythm, depth, hierarchy?
|
|
47
|
-
4. Is any request text, label, placeholder, file name or internal term on screen?
|
|
1
|
+
# Look rounds and Done
|
|
2
|
+
|
|
3
|
+
A gate PASS says the film is safe and legible. It does not say the film is good. The look rounds are
|
|
4
|
+
where you judge the pixels against the treatment, and the done-check will not accept a film nobody
|
|
5
|
+
looked at. A cover loop has its own nine questions, its own stills (the decoded contact sheet with
|
|
6
|
+
its frame-difference plot, the poster and the seam pair) and its own done; see `cover.md`.
|
|
7
|
+
|
|
8
|
+
## Viewing pixels
|
|
9
|
+
|
|
10
|
+
Only files you open with the Read tool count as viewed. OCR, pixel statistics and file listings may
|
|
11
|
+
be written down as `aids`, but they never count as looking. Every render (stills-only or full)
|
|
12
|
+
writes the stills set into `<dir>/stills/`, listed in `stills/index.json`:
|
|
13
|
+
|
|
14
|
+
- `board.png`: the storyboard, one keyframe per shot with its time, layout, hand-off and hero move
|
|
15
|
+
(`studio.md`); on the stage path it carries the board check's verdict;
|
|
16
|
+
- `beat-NN.png`: the frame at each beat's midpoint, full size;
|
|
17
|
+
- `strip-NN.png`: one transition strip per cut, the frames 6 before, at and 6 after the cut;
|
|
18
|
+
- `sheet.png`: a 12-frame contact sheet across the film;
|
|
19
|
+
- after a full render, the delivered `poster.png` is listed too.
|
|
20
|
+
|
|
21
|
+
If no image tool can be reached, record the round with `look --round N --blocked no-vision-tool`.
|
|
22
|
+
The done-check then ends as `DONE_UNVIEWED`, and the reply must say in plain words that nobody
|
|
23
|
+
viewed the frames.
|
|
24
|
+
|
|
25
|
+
## Questions
|
|
26
|
+
|
|
27
|
+
Answer all ten every round. Each answer names the frame it is about and what you saw there.
|
|
28
|
+
|
|
29
|
+
1. A stranger would say this film is for: `<…>`. Ask a fresh subagent (the Agent tool) with only the
|
|
30
|
+
contact sheet and the beat stills, never the request or the treatment, and record its sentence
|
|
31
|
+
verbatim with `by: blind`. If no subagent can run, answer it yourself with `by: self`.
|
|
32
|
+
2. Does every beat show its `onScreen` plan?
|
|
33
|
+
3. Is it rich enough? Put the contact sheet beside the user's reference frames (none given: a studio
|
|
34
|
+
launch film of a product). Does each shot carry as much labelled detail, layered depth, camera
|
|
35
|
+
movement and accent colour as they do, with one hero move leading it and the style's hand-offs?
|
|
36
|
+
A minimal film answers for its restraint instead.
|
|
37
|
+
4. Is any request text, meta label, placeholder, file name or internal term on screen?
|
|
48
38
|
5. Does the ending land?
|
|
49
|
-
6. Does the sound follow the cuts? Answer from `sound-cues.json
|
|
39
|
+
6. Does the sound follow the cuts and the events? Answer it from `sound-cues.json` and the stills:
|
|
40
|
+
each event cue's frame should show what its `on` says.
|
|
50
41
|
7. Name one thing a skilled motion designer, given only the request, would have shown that this film
|
|
51
|
-
does not,
|
|
42
|
+
does not: a part, a label, a layer, a camera move, a sound. If you can name one, add it and revise.
|
|
52
43
|
8. Is any element on screen without a job in its beat?
|
|
53
|
-
9. Could every copy line
|
|
54
|
-
from `subject.specifics`.
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
A cover round answers eight different questions, because a loop fails in different ways.
|
|
44
|
+
9. Could every copy line be pasted unchanged into a film about a different subject? If yes, rewrite
|
|
45
|
+
the copy from `subject.specifics`.
|
|
46
|
+
10. Does the turn land? Answer it on the turn shot's still, `stills/beat-NN.png` for `story.beat`
|
|
47
|
+
(`look` refuses any other frame): is `story.turn` visibly happening there, to the protagonist, as
|
|
48
|
+
the film's largest change? A turn that only a caption announces is a `no`.
|
|
59
49
|
|
|
60
|
-
|
|
61
|
-
2. Does the seam vanish in the decoded file (`seam.png`, and the right end of the plot)?
|
|
62
|
-
3. Does it still move after encoding, with no region that freezes and then pops?
|
|
63
|
-
4. Is the brand word present, legible and in place in every frame, never faded or swapped?
|
|
64
|
-
5. Can you see all three speed layers: a slow perpetual one, a mid swell, and beat events?
|
|
65
|
-
6. Does anything read as a slide, a card swap, a title fade or an end card, or does light wash in
|
|
66
|
-
place instead of travelling as an edge?
|
|
67
|
-
7. Is any glyph, glint or glow damaged: a block of colour, a dark disc, a visible box?
|
|
68
|
-
8. Name one thing a skilled motion designer would add or remove, or answer `none`.
|
|
50
|
+
## Answers file
|
|
69
51
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
```bash
|
|
75
|
-
node "$SKILL_ROOT/scripts/motion.mjs" look --out <dir> --round <N> --answers <file>
|
|
76
|
-
```
|
|
52
|
+
Write the answers to a JSON file and record them with
|
|
53
|
+
`node "$SKILL_ROOT/scripts/motion.mjs" look --out <dir> --round <N> --answers <file>`.
|
|
54
|
+
The values below are placeholders; `look` refuses them.
|
|
77
55
|
|
|
78
56
|
```json
|
|
79
57
|
{
|
|
80
58
|
"viewed": ["stills/sheet.png", "stills/beat-01.png", "stills/strip-01.png"],
|
|
81
|
-
"weakestBeat":
|
|
82
|
-
"change": "<
|
|
59
|
+
"weakestBeat": "<beat index; round 1>",
|
|
60
|
+
"change": "<what you changed after round 1>",
|
|
83
61
|
"aids": ["<optional notes that are not looking>"],
|
|
84
62
|
"answers": [
|
|
85
|
-
{ "q": 1, "verdict": "yes", "by": "blind", "sentence": "<the stranger's sentence, verbatim>",
|
|
86
|
-
|
|
87
|
-
{ "q": 7, "verdict": "none", "frame": "stills/beat-03.png", "observed": "<what you saw>" }
|
|
63
|
+
{ "q": 1, "verdict": "<yes or no: does the stranger's sentence match the film's audience and subject>", "by": "<blind or self>", "sentence": "<the stranger's sentence, verbatim>", "frame": "stills/sheet.png", "observed": "<a concrete visible detail in that frame>" },
|
|
64
|
+
{ "q": 7, "verdict": "<none or named>", "frame": "<a listed still>", "observed": "<what a skilled designer would have shown, or the detail that shows nothing is missing>" }
|
|
88
65
|
]
|
|
89
66
|
}
|
|
90
67
|
```
|
|
91
68
|
|
|
92
|
-
`
|
|
93
|
-
`
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
answers is refused.
|
|
103
|
-
- Film question 1 also carries `by` (`blind` or `self`) and the stranger's `sentence`.
|
|
104
|
-
- Round 1 of a film names `weakestBeat` (an integer index). Round 1 of either mode names `change`, at
|
|
105
|
-
least 12 characters.
|
|
106
|
-
- `defects` belongs to covers only: at most three per round, each `{ t, region, frame, observed,
|
|
107
|
-
cause, fix }`, with `t` inside the loop, `region` in whole cover pixels on the cover, and `frame` in
|
|
108
|
-
the current set. A film round with `defects` is refused. The cover reference explains how a defect
|
|
109
|
-
leads to a `--window` re-render.
|
|
110
|
-
|
|
111
|
-
The recorded round is stamped with the SHA-256 of `stills/index.json` and of every frame it names, so
|
|
112
|
-
the done-check can tell a look at the final render from a look at an earlier one.
|
|
69
|
+
- `viewed` lists every stills file you opened with Read this round, paths relative to `<dir>`.
|
|
70
|
+
- `verdict` is `yes` or `no` for questions 1–6 and 8–10, and `none` or `named` for question 7.
|
|
71
|
+
- `observed` is at least one sentence naming a concrete visible detail in `frame`; a bare yes or no
|
|
72
|
+
is refused, and so is the same sentence used for two answers.
|
|
73
|
+
- `look` refuses a frame that is not in the latest stills set, and stamps the round with the SHA-256
|
|
74
|
+
of `stills/index.json` and of every listed frame.
|
|
75
|
+
- `defects` (optional, at most three, worst first) name what the eye found:
|
|
76
|
+
`{ "t": <seconds>, "region": [x, y, w, h], "frame": "<a still>", "observed": "...", "cause": "...", "fix": "..." }`,
|
|
77
|
+
`t` inside the film and `region` inside the frame in pixels. Fix those seconds and render the board
|
|
78
|
+
again before the full render.
|
|
113
79
|
|
|
114
80
|
## Rounds
|
|
115
81
|
|
|
116
|
-
Rounds share one counter with the renders,
|
|
117
|
-
the latest stills set to be round N.
|
|
82
|
+
Rounds share one counter with the renders, 1 to 3.
|
|
118
83
|
|
|
119
|
-
- **
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
- **After round 3**, deliver anyway and state each open item plainly in the reply.
|
|
84
|
+
- **Round 1** is always the board round: render with `--stills-only`, fix any board-check failure,
|
|
85
|
+
look at the board and the stills, and record `weakestBeat` and `change`, then make that change before
|
|
86
|
+
the full render. A preview (`preview: true`) is done here.
|
|
87
|
+
- A `no` on questions 1, 2, 3, 5, 6 or 10, a `yes` on 4, 8 or 9, or a `named` question 7 needs another
|
|
88
|
+
round: fix it, render again, look again.
|
|
89
|
+
- There are at most 3 rounds. After round 3, deliver with the open items stated plainly.
|
|
126
90
|
|
|
127
91
|
## Done
|
|
128
92
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
round
|
|
93
|
+
Done needs all of:
|
|
94
|
+
|
|
95
|
+
- a valid treatment;
|
|
96
|
+
- gate PASS;
|
|
97
|
+
- at least 2 look rounds: round 1 on a stills-only render with a `change`, then a last round;
|
|
98
|
+
- the last round stamped with the stills manifest of the final full render (`look` after the render,
|
|
99
|
+
never before);
|
|
100
|
+
- the last round's `viewed` covering the board, the poster, the contact sheet, every beat still and
|
|
101
|
+
every transition strip, each of them opened with the Read tool in this session;
|
|
102
|
+
- the last round free of revise answers, or round 3 with its open items said in the reply.
|
|
135
103
|
|
|
136
|
-
The Stop hook
|
|
137
|
-
|
|
138
|
-
what the user can run to finish it. A blocked render (exit 10, 11, 12, 14, 15, 21 or 22) goes straight
|
|
139
|
-
to that notice. A finished film or cover with a downgrade, an open look item, a generated asset or
|
|
140
|
-
`DONE_UNVIEWED` holds once so that the reply says so.
|
|
104
|
+
The Stop hook checks every item and holds the turn with a named reason. A missing, unreadable or
|
|
105
|
+
outdated `treatment.json` or `look.json` is a named reason, never a pass.
|
|
141
106
|
|
|
142
107
|
## Never downgrade to pass
|
|
143
108
|
|
|
144
|
-
Do not answer a failure by shortening the film,
|
|
145
|
-
sound to `none`,
|
|
146
|
-
scrim behind the text, a larger size, a
|
|
147
|
-
randomness. The done-check compares the final treatment with the first valid one and records
|
|
148
|
-
|
|
149
|
-
`none` without
|
|
150
|
-
name it.
|
|
109
|
+
Do not answer a gate failure by shortening the film, removing a beat, removing the subject device,
|
|
110
|
+
switching `sound.mode` to `none`, switching `path` to `type`, or deleting effects. Fix the cause
|
|
111
|
+
instead: a scrim behind the text, a larger size, a placement inside the safe area, slower timing,
|
|
112
|
+
seeded randomness. The done-check compares the final treatment with the first valid one and records
|
|
113
|
+
`downgraded` when `durationSec` dropped by more than 20 %, the subject covers fewer beats, the sound
|
|
114
|
+
became `none` without a user request, or the path moved from stage to type. The reply must say so.
|
|
151
115
|
|
|
152
|
-
##
|
|
116
|
+
## Reply
|
|
153
117
|
|
|
154
|
-
Keep the activation line where it is
|
|
155
|
-
one line on the defaults chosen; a label on every
|
|
156
|
-
|
|
157
|
-
the
|
|
118
|
+
Keep the activation line where it is; below it there is no second banner and no emoji. Plain words,
|
|
119
|
+
no internal names: one line on the defaults chosen; a label on every invention and on generated
|
|
120
|
+
sound; one plain line on what was checked (flash safety, legibility, the style, the frames looked at); where
|
|
121
|
+
the storyboard and the copy live and the one command that re-renders it; and any downgraded item or
|
|
122
|
+
open look item.
|