@litfamily/litgravity 0.1.0 → 0.1.2

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.
Files changed (248) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +72 -17
  3. package/README_ko-KR.md +72 -17
  4. package/package.json +1 -1
  5. package/plugin/hooks/lib/lanes.mjs +65 -0
  6. package/plugin/hooks/lib/motion.mjs +34 -5
  7. package/plugin/hooks/lib/reentry.mjs +7 -0
  8. package/plugin/hooks/lib/rewind/brief.mjs +332 -0
  9. package/plugin/hooks/lib/rewind/collect.mjs +328 -0
  10. package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
  11. package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
  12. package/plugin/hooks/lib/rewind/redact.mjs +60 -0
  13. package/plugin/hooks/lib/rewind/transcripts.mjs +211 -0
  14. package/plugin/hooks/lib/routes.mjs +79 -5
  15. package/plugin/hooks/lib/workflow-stack.mjs +213 -0
  16. package/plugin/hooks/post-tool-use.mjs +37 -1
  17. package/plugin/hooks/pre-invocation.mjs +91 -2
  18. package/plugin/hooks/session-start.mjs +26 -3
  19. package/plugin/hooks/stop.mjs +22 -2
  20. package/plugin/hud/looks.mjs +29 -0
  21. package/plugin/hud/render.mjs +234 -12
  22. package/plugin/plugin.json +1 -1
  23. package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
  24. package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
  25. package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
  26. package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
  27. package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
  28. package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
  29. package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
  30. package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
  31. package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
  32. package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
  33. package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
  34. package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
  35. package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
  36. package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
  37. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
  38. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
  39. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
  40. package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
  41. package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
  42. package/plugin/skills/lit-adhd/SKILL.md +157 -0
  43. package/plugin/skills/lit-adhd/references/card-examples.md +101 -0
  44. package/plugin/skills/lit-adhd/references/status-taxonomy.md +32 -0
  45. package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
  46. package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
  47. package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
  48. package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
  49. package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
  50. package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
  51. package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
  52. package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
  53. package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
  54. package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
  55. package/plugin/skills/lit-docx/SKILL.md +3 -3
  56. package/plugin/skills/lit-handoff/SKILL.md +1 -0
  57. package/plugin/skills/lit-hijack/SKILL.md +263 -0
  58. package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
  59. package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
  60. package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
  61. package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
  62. package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
  63. package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
  64. package/plugin/skills/lit-plan/SKILL.md +1 -1
  65. package/plugin/skills/lit-pptx/SKILL.md +8 -8
  66. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
  67. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
  68. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
  69. package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
  70. package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
  71. package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
  72. package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
  73. package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
  74. package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
  75. package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
  76. package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
  77. package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
  78. package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
  79. package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
  80. package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
  81. package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
  82. package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
  83. package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
  84. package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
  85. package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
  86. package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
  87. package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
  88. package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
  89. package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
  90. package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
  91. package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
  92. package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
  93. package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
  94. package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
  95. package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
  96. package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
  97. package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
  98. package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
  99. package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
  100. package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
  101. package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
  102. package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
  103. package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
  104. package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
  105. package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
  106. package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
  107. package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
  108. package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
  109. package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
  110. package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
  111. package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
  112. package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
  113. package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
  114. package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
  115. package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
  116. package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
  117. package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
  118. package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
  119. package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
  120. package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
  121. package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
  122. package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
  123. package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
  124. package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
  125. package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
  126. package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
  127. package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
  128. package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
  129. package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
  130. package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
  131. package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
  132. package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
  133. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
  134. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
  135. package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
  136. package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
  137. package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
  138. package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
  139. package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
  140. package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
  141. package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
  142. package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
  143. package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
  144. package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
  145. package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
  146. package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
  147. package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
  148. package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
  149. package/plugin/skills/lit-schematic/SKILL.md +114 -0
  150. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
  151. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
  152. package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
  153. package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
  154. package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
  155. package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
  156. package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
  157. package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
  158. package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
  159. package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
  160. package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
  161. package/plugin/skills/lit-schematic/references/verification.md +100 -0
  162. package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
  163. package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
  164. package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
  165. package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
  166. package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
  167. package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
  168. package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
  169. package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
  170. package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
  171. package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
  172. package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
  173. package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
  174. package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
  175. package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
  176. package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
  177. package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
  178. package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
  179. package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
  180. package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
  181. package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
  182. package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
  183. package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
  184. package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
  185. package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
  186. package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
  187. package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
  188. package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
  189. package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
  190. package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
  191. package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
  192. package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
  193. package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
  194. package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
  195. package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
  196. package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
  197. package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
  198. package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
  199. package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
  200. package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
  201. package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
  202. package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
  203. package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
  204. package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
  205. package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
  206. package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
  207. package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
  208. package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
  209. package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
  210. package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
  211. package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
  212. package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
  213. package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
  214. package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
  215. package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
  216. package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
  217. package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
  218. package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
  219. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
  220. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
  221. package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
  222. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
  223. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
  224. package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
  225. package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
  226. package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
  227. package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
  228. package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
  229. package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
  230. package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
  231. package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
  232. package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
  233. package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
  234. package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
  235. package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
  236. package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
  237. package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
  238. package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
  239. package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
  240. package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
  241. package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
  242. package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
  243. package/plugin/skills/litresearch/SKILL.md +1 -0
  244. package/plugin/skills/readme-studio/SKILL.md +2 -0
  245. package/plugin/skills/readme-studio/templates/hyperframes-cover/package-lock.json +3 -3
  246. package/plugin/skills/readme-studio/templates/remotion-cover/package-lock.json +3 -3
  247. package/plugin/skills/review-work/SKILL.md +1 -1
  248. package/plugin/skills/start-work/SKILL.md +1 -1
@@ -1,100 +1,70 @@
1
- # Type-path craft loop and QA gate
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
- 1. **Stills.** `node "$SKILL_ROOT/scripts/motion.mjs" make <dir>/brief.json --out <dir> --round N --stills-only`
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
- The audit follows the WCAG 2.3.1 excursion method (`engine/core/flash.mjs`) and runs on the exact bytes
43
- handed to the encoder. Each frame is averaged onto a 320x180 grid of 6x6 px cells (transposed for a
44
- portrait frame). A cell registers a transition when its luminance moves at least 0.1 away from the
45
- extreme it reached since its last transition while the darker side is below 0.8. A frame-level
46
- transition exists when the cells that moved one way within the last three frames cover more than 25 % of
47
- some 640x360 window, the ten-degree field. Saturated red runs the same method on (R − G − B) × 320 with a
48
- step of 20. A flash is a pair of opposite transitions inside one second, and the limit is three general
49
- and three red flashes in every one-second window. The master is audited as a film that ends, the preview
50
- as a loop that wraps. Separately, MO-SH-04a fails any single frame where 25 % of the cells jump by 0.1 or
51
- more at once.
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
- ## Contrast (MO-C-06)
21
+ ## Stop conditions (MO-C-16)
54
22
 
55
- Contrast is measured on rendered pixels (`engine/core/contrast.mjs`). The foreground is the median
56
- linear luminance under the glyph mask eroded by one pixel (the 5th and 95th percentiles for a gradient
57
- fill). The background is sampled between the 5th and 95th percentiles inside the text box grown by a
58
- quarter of the cap height and outside the mask dilated by two pixels. The worst pairing counts. In
59
- terminalcore the boxes are first carried through the crt curvature, so a curved window edge is not mistaken
60
- for a label's background.
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
- Rules marked provisional use the motion spec's proposed defaults, implemented exactly as written while
65
- they wait for sign-off; the report labels them. Never tune a number in `engine/core/constants.mjs` to make
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 | Usual fix |
40
+ | Rule | Threshold | Typical fix |
69
41
  | --- | --- | --- |
70
- | MO-C-01 look coverage | every frame inside a pass range whose pass issued a draw | keep the preset's passes |
71
- | MO-C-02 WebGL2 | renderer recorded; a software renderer labelled and announced | environment only |
72
- | MO-C-03 flash | ≤ 3 general and ≤ 3 red flashes per second, master and preview | fewer, slower large changes; no full-frame flips |
73
- | MO-C-04 title-safe | every glyph box inside x 96–1824, y 54–1026 | shorter line or smaller size |
74
- | MO-C-05 action-safe (provisional) | every non-glyph mark inside x 48–1872, y 27–1053 | move the mark |
75
- | MO-C-06 contrast (provisional) | 4.5:1, or 3:1 at ≥ 32 px (≥ 25 px at 700) | small text in the type colour |
76
- | MO-C-07/08 reading time (provisional) | the floor in `references/type-craft.md` | fewer words per shot, or a longer `hold` |
77
- | MO-A-13 eojeol | every reveal step a whole eojeol or item | keep units whole |
78
- | MO-A-15 / MO-A-16 beats | cuts within one frame of a beat; every shot at least two beats | engine-made; check custom holds |
79
- | MO-C-09 / MO-A-25 determinism | identical `rgbaSha256` in a second process; seeked frames equal sequential ones | a scene read a clock or unseeded random |
80
- | MO-C-10/11/12 format | ≥ 1920x1080, ≥ 30 fps, ≥ 3 s; yuv420p, bt709, tv range; warns past 90 s | engine-set |
81
- | MO-C-13 sizes (provisional) | preview ≤ 3 MB, poster ≤ 1 MB; MP4 warns past 100 MB per 10 s | the preview ladder steps down by itself |
82
- | MO-C-14 reduced-motion still (provisional) | present, with ink ≥ 0.9 × the last text frame | end on a settled end card |
83
- | MO-C-25 tracking (provisional) | display ≥ −0.04 em; machine voice never negative | |
84
- | MO-FT-04 Hangul | no tracking or width motion on a Hangul run | |
85
- | MO-C-26 line height | ≥ 1.5 Latin, ≥ 1.6 CJK for two lines or more | |
86
- | MO-C-27 measure | Latin paragraph cards 60–75 characters; Korean 30–45 advisory | |
87
- | MO-C-29 colour (provisional) | at most two saturated clusters (signal and accent); the accent in one timeline entry and ≤ 10 % of frames | drop the extra colour |
88
- | MO-D-02 perf (provisional) | p95 frame time ≤ 40 ms on hardware, ≤ 250 ms on software GL, over ≥ 120 frames | lower samples or tidal octaves; never withholds |
89
- | MO-D-03 empty frames (provisional) | no near-black run longer than twice the minimum hold (plus 1 s at either end) | a scene that failed to paint |
90
- | MO-D-04 glyphs (provisional) | every codepoint in its run's font | change text or preset |
91
- | MO-SH-01..11 | pass seeds, the two-events-per-second budget, glitch, surge and flicker caps, dither seed per shot, guides off, ≤ 2 terminal layers, the software downgrade | engine-enforced; a FAIL is an engine defect to report |
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
- ## The report (MO-C-17)
65
+ ## Report (MO-C-17)
95
66
 
96
- `gate-report.txt` opens with a fixed block: the outputs, the preset and why, the duration, the passes, the
97
- WebGL2 tier, one line per rule MO-C-01 to MO-C-14, the rounds, and the frames viewed according to
98
- `look.json`. Then come MO-C-25, 26, 27 and 29, MO-D-02, 03 and 04, and every other enforced rule. Its
99
- verdict line is `QA gate: PASS` or a failure line. Quote the verdict and every FAIL line when the user
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 the done-check
2
-
3
- The gate tells you a film is safe to watch and its words can be read. It cannot tell you the film is
4
- any good, and it cannot see a glint that turned a letter into a coloured block. Look rounds are where
5
- you open the rendered pixels, judge them against the treatment, and write down what you saw. The
6
- done-check refuses a film or a cover that nobody looked at, and in LitGravity it can tell whether you
7
- really opened the images.
8
-
9
- ## What counts as looking
10
-
11
- Only an image you open with `read_file` counts. While the `lit-typographic-motion` route is active,
12
- LitGravity's PostToolUse hook records the path of every `read_file` call (`view_file` on older builds), and the Stop hook compares the
13
- `viewed` list of your last round against those paths. A file you list without opening is named in
14
- the hold reason. OCR, pixel statistics, a directory listing or a description from another tool can
15
- be written into `aids`; they help, and they never count as viewing.
16
-
17
- Every render writes its stills into `<dir>/stills/` and lists them in `stills/index.json`:
18
-
19
- - **Film, stage or type path:** `beat-NN.png` (each beat at its midpoint, full size), `strip-NN.png`
20
- (one strip per cut: frames 6 before, at, and 6 after the cut), `sheet.png` (12 frames across the
21
- film), and after a full render the delivered `poster.png`.
22
- - **Cover:** `sheet.png` (12 decoded frames over the frame-difference plot), `poster.png` (frame 0),
23
- `seam.png` (the last frame beside frame 0) and `frame-00.png` to `frame-11.png`. See
24
- `references/cover.md`.
25
-
26
- If `read_file` cannot show you an image in this session, record the round as blocked:
27
-
28
- ```bash
29
- node "$SKILL_ROOT/scripts/motion.mjs" look --out <dir> --round <N> --blocked no-vision-tool
30
- ```
31
-
32
- The best the result can then reach is `DONE_UNVIEWED`, and the reply has to say in plain words that
33
- nobody looked at the frames.
34
-
35
- ## The film questions
36
-
37
- Answer all nine in every film round. Each answer names one file of the current stills set and says
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, or answer `none`.
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 move unchanged into a film about another subject? If so, rewrite the copy
54
- from `subject.specifics`.
55
-
56
- ## The cover questions
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
- 1. Is something moving in every half-second window (the plot never lies flat on the red dashes)?
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
- ## The answers file
71
-
72
- Write the answers as JSON and record them:
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": 2,
82
- "change": "<the change you make after this round>",
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
- "frame": "stills/sheet.png", "observed": "<a concrete visible detail in that frame>" },
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
- `look` (engine/node/look.mjs) checks the file against the latest stills set and refuses, with a
93
- `LOOK_REFUSED` line, anything that does not hold:
94
-
95
- - `viewed` is a non-empty list of stills files, paths relative to `<dir>`, each one in the current
96
- `stills/index.json` and present on disk.
97
- - `answers` covers every question exactly once. `verdict` is `yes` or `no`, except for the last
98
- question (film 7, cover 8), which takes `none` or `named`.
99
- - Every answer's `frame` is in the current stills set, and its `observed` is a real sentence about
100
- something visible: at least 20 characters and four words in Latin script, or 12 characters with
101
- eight Hangul syllables. A bare verdict word, a `<placeholder>` or the same sentence used for two
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, from 1 to 3, and only move forward. `look --round N` needs
117
- the latest stills set to be round N.
82
+ Rounds share one counter with the renders, 1 to 3.
118
83
 
119
- - **Film round 1** is always a stills round: render with `--round 1 --stills-only`, look, name the
120
- weakest beat and the change, then make the change.
121
- - **Cover round 1** is a full cover render followed by a look that names the change.
122
- - **Another round is needed** when a film answer is `no` on 1, 2, 3, 5 or 6, `yes` on 4, 8 or 9, or
123
- `named` on 7; or when a cover answer is `no` on 1 to 5, `yes` on 6 or 7, or `named` on 8. Fix the
124
- cause, render again, look again.
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
- For a film, done needs every one of these: a valid treatment that has not changed since the last full
130
- render; `gate-report.txt` reading `QA gate: PASS`; a full render after any stills-only one; at least
131
- two look rounds, the first a stills round that names a change; the last round stamped with the final
132
- render's stills; that round's `viewed` covering the poster, the sheet, every beat still and every
133
- strip, each one opened with `read_file`; and no answer in the last round asking for more unless it is
134
- round 3. A cover is done on its own terms, listed in `references/cover.md`.
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 evaluates this for the last output folder of the turn. It holds the turn with the
137
- named reasons at most twice, then asks the reply to say plainly that the work is not done, why, and
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, dropping a beat or the subject device, switching
145
- sound to `none`, moving from the stage path to the type path, or deleting effects. Fix the cause: a
146
- scrim behind the text, a larger size, a position inside the safe area, slower timing, seeded
147
- randomness. The done-check compares the final treatment with the first valid one and records a
148
- downgrade when the duration fell by more than 20 %, the subject covers fewer beats, the sound became
149
- `none` without the user asking for silence, or the path moved from stage to type. The reply must
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
- ## The reply
116
+ ## Reply
153
117
 
154
- Keep the activation line where it is, with no second banner and no emoji under it. In plain words:
155
- one line on the defaults chosen; a label on every invented subject, every generated sound and every
156
- generated asset; one line on what was checked (flash safety, legibility, the frames looked at); where
157
- the output lives and the one command that renders it again; and every downgrade or open look item.
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.