@litfamily/litcodex 1.0.30 → 1.0.31

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 (376) hide show
  1. package/README-Ko-KR.md +11 -11
  2. package/README.md +11 -11
  3. package/dist/install/generated-skill-payload-hashes.d.ts +188 -82
  4. package/dist/install/generated-skill-payload-hashes.js +188 -82
  5. package/dist/install/skill-catalog.d.ts +1 -1
  6. package/dist/install/skill-catalog.js +12 -1
  7. package/dist/install/skill-resource-hashes.d.ts +1 -1
  8. package/dist/install/skill-resource-hashes.js +1 -1
  9. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  10. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  11. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  12. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  13. package/marketplace/plugins/litcodex/components/lit-loop/directive.md +10 -4
  14. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-adhd.md +191 -0
  15. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-handoff.md +2 -0
  16. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-hijack.md +219 -0
  17. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-recap.md +2 -0
  18. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-schematic.md +199 -0
  19. package/marketplace/plugins/litcodex/components/lit-loop/directives/litwork.md +2 -1
  20. package/marketplace/plugins/litcodex/components/lit-loop/dist/adhd-suggest.d.ts +10 -0
  21. package/marketplace/plugins/litcodex/components/lit-loop/dist/adhd-suggest.js +67 -0
  22. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-html.d.ts +1 -1
  23. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-html.js +128 -8
  24. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-looks.d.ts +19 -0
  25. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-looks.js +58 -0
  26. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-status.d.ts +27 -0
  27. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-status.js +94 -7
  28. package/marketplace/plugins/litcodex/components/lit-loop/dist/cli.js +13 -3
  29. package/marketplace/plugins/litcodex/components/lit-loop/dist/codex-hook.d.ts +2 -0
  30. package/marketplace/plugins/litcodex/components/lit-loop/dist/codex-hook.js +8 -9
  31. package/marketplace/plugins/litcodex/components/lit-loop/dist/control-chars.d.ts +5 -0
  32. package/marketplace/plugins/litcodex/components/lit-loop/dist/control-chars.js +23 -0
  33. package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.d.ts +8 -0
  34. package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.js +118 -11
  35. package/marketplace/plugins/litcodex/components/lit-loop/dist/hud.d.ts +1 -1
  36. package/marketplace/plugins/litcodex/components/lit-loop/dist/hud.js +29 -13
  37. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-events.d.ts +13 -0
  38. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-events.js +85 -0
  39. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-state.d.ts +55 -0
  40. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-state.js +227 -0
  41. package/marketplace/plugins/litcodex/components/lit-loop/dist/live-step.d.ts +5 -1
  42. package/marketplace/plugins/litcodex/components/lit-loop/dist/live-step.js +17 -1
  43. package/marketplace/plugins/litcodex/components/lit-loop/dist/markers.d.ts +6 -0
  44. package/marketplace/plugins/litcodex/components/lit-loop/dist/markers.js +6 -0
  45. package/marketplace/plugins/litcodex/components/lit-loop/dist/modes.d.ts +1 -1
  46. package/marketplace/plugins/litcodex/components/lit-loop/dist/modes.js +25 -1
  47. package/marketplace/plugins/litcodex/components/lit-loop/dist/motion-gate.d.ts +79 -0
  48. package/marketplace/plugins/litcodex/components/lit-loop/dist/motion-gate.js +310 -0
  49. package/marketplace/plugins/litcodex/components/lit-loop/dist/motion-route.js +5 -1
  50. package/marketplace/plugins/litcodex/components/lit-loop/dist/plan-persistence.js +10 -0
  51. package/marketplace/plugins/litcodex/components/lit-loop/dist/redaction.js +18 -0
  52. package/marketplace/plugins/litcodex/components/lit-loop/dist/reentry.d.ts +15 -0
  53. package/marketplace/plugins/litcodex/components/lit-loop/dist/reentry.js +46 -9
  54. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-cli.d.ts +10 -0
  55. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-cli.js +88 -0
  56. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-go.d.ts +20 -0
  57. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-go.js +84 -0
  58. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-look.d.ts +6 -0
  59. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-look.js +41 -0
  60. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-redact.d.ts +3 -0
  61. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-redact.js +40 -0
  62. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-rollout.d.ts +48 -0
  63. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-rollout.js +292 -0
  64. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind.d.ts +162 -0
  65. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind.js +773 -0
  66. package/marketplace/plugins/litcodex/components/lit-loop/dist/route-heads.js +44 -2
  67. package/marketplace/plugins/litcodex/components/lit-loop/dist/run-panel.js +1 -0
  68. package/marketplace/plugins/litcodex/components/lit-loop/dist/schematic-route.d.ts +6 -0
  69. package/marketplace/plugins/litcodex/components/lit-loop/dist/schematic-route.js +35 -0
  70. package/marketplace/plugins/litcodex/components/lit-loop/dist/screen-card.d.ts +3 -0
  71. package/marketplace/plugins/litcodex/components/lit-loop/dist/screen-card.js +15 -5
  72. package/marketplace/plugins/litcodex/components/lit-loop/dist/skill-mention-scope.js +6 -0
  73. package/marketplace/plugins/litcodex/components/lit-loop/dist/stack-hook.d.ts +8 -0
  74. package/marketplace/plugins/litcodex/components/lit-loop/dist/stack-hook.js +57 -0
  75. package/marketplace/plugins/litcodex/components/lit-loop/dist/statusline.js +8 -3
  76. package/marketplace/plugins/litcodex/components/lit-loop/dist/threads.d.ts +50 -0
  77. package/marketplace/plugins/litcodex/components/lit-loop/dist/threads.js +178 -0
  78. package/marketplace/plugins/litcodex/components/lit-loop/dist/trigger.d.ts +1 -1
  79. package/marketplace/plugins/litcodex/components/lit-loop/dist/trigger.js +29 -5
  80. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-map.d.ts +10 -0
  81. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-map.js +11 -1
  82. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-stack.d.ts +132 -0
  83. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-stack.js +488 -0
  84. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  85. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  86. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  87. package/marketplace/plugins/litcodex/components/start-work-continuation/dist/codex-hook.d.ts +6 -0
  88. package/marketplace/plugins/litcodex/components/start-work-continuation/dist/codex-hook.js +65 -0
  89. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  90. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  91. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  92. package/marketplace/plugins/litcodex/hooks/hooks.json +24 -0
  93. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/SKILL.md +6 -0
  94. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/components.css +414 -0
  95. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/fonts.json +22 -0
  96. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
  97. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
  98. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
  99. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
  100. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
  101. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
  102. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
  103. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
  104. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/ui.js +228 -0
  105. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/brand-and-imagery.md +1 -1
  106. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/complete-contract.md +1 -0
  107. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/craft-floor.md +2 -2
  108. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/default-editorial-pixel.json +15 -8
  109. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/design-choice.md +19 -0
  110. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/house-styles.md +235 -0
  111. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/motion-guide.md +2 -2
  112. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/probe-and-review.md +6 -0
  113. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/production-interview.md +2 -0
  114. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/slop-register.md +4 -4
  115. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
  116. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/lock-probe.mjs +196 -0
  117. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/page-probe.mjs +22 -4
  118. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
  119. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/probe.mjs +59 -13
  120. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/rule-data.mjs +38 -4
  121. package/marketplace/plugins/litcodex/skills/lit-adhd/SKILL.md +181 -0
  122. package/marketplace/plugins/litcodex/skills/lit-adhd/agents/openai.yaml +6 -0
  123. package/marketplace/plugins/litcodex/skills/lit-adhd/references/card-examples.md +147 -0
  124. package/marketplace/plugins/litcodex/skills/lit-adhd/references/status-taxonomy.md +37 -0
  125. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/SKILL.md +18 -7
  126. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/style-guide.md +20 -11
  127. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
  128. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
  129. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-swimlane.md +1 -1
  130. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-tree-block-decomposition.md +1 -1
  131. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-tree.md +3 -3
  132. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
  133. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/verifier-guide.md +1 -0
  134. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
  135. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
  136. package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +12 -3
  137. package/marketplace/plugins/litcodex/skills/lit-docx/references/direction-step.md +6 -3
  138. package/marketplace/plugins/litcodex/skills/lit-hijack/SKILL.md +449 -0
  139. package/marketplace/plugins/litcodex/skills/lit-hijack/agents/openai.yaml +6 -0
  140. package/marketplace/plugins/litcodex/skills/lit-hijack/references/capture-and-provenance.md +100 -0
  141. package/marketplace/plugins/litcodex/skills/lit-hijack/references/clean-room-build.md +111 -0
  142. package/marketplace/plugins/litcodex/skills/lit-hijack/references/distil-and-licence.md +102 -0
  143. package/marketplace/plugins/litcodex/skills/lit-hijack/references/gap-and-port-design.md +125 -0
  144. package/marketplace/plugins/litcodex/skills/lit-hijack/references/parity-and-report.md +108 -0
  145. package/marketplace/plugins/litcodex/skills/lit-hijack/scripts/hijack.mjs +1050 -0
  146. package/marketplace/plugins/litcodex/skills/lit-loop/SKILL.md +13 -4
  147. package/marketplace/plugins/litcodex/skills/lit-plan/SKILL.md +6 -0
  148. package/marketplace/plugins/litcodex/skills/lit-pptx/NOTICE +1 -0
  149. package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +35 -8
  150. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
  151. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
  152. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
  153. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/SOURCE.md +21 -0
  154. package/marketplace/plugins/litcodex/skills/lit-pptx/references/anti-slop-checklist.md +5 -2
  155. package/marketplace/plugins/litcodex/skills/lit-pptx/references/authoring-guide.md +3 -4
  156. package/marketplace/plugins/litcodex/skills/lit-pptx/references/density-and-fill.md +20 -6
  157. package/marketplace/plugins/litcodex/skills/lit-pptx/references/direction-step.md +26 -8
  158. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/14-engineering-review-computational-brutalism-ko.md +173 -0
  159. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/15-launch-pitch-neo-brutalism-ko.md +154 -0
  160. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/16-design-lecture-bauhaus-ko.md +139 -0
  161. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/17-community-programme-riso-ko.md +158 -0
  162. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/18-public-data-briefing-newsroom-ko.md +179 -0
  163. package/marketplace/plugins/litcodex/skills/lit-pptx/references/layout-families.md +42 -27
  164. package/marketplace/plugins/litcodex/skills/lit-pptx/references/title-treatments.md +31 -27
  165. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/bauhaus.md +136 -0
  166. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/chalk.md +1 -1
  167. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/computational-brutalism.md +145 -0
  168. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/neo-brutalism.md +155 -0
  169. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/newsroom.md +141 -0
  170. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/riso.md +133 -0
  171. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/signal.md +1 -1
  172. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/studio.md +1 -1
  173. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/compile-deck.js +1 -1
  174. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/craft_extras.py +136 -94
  175. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/embed_fonts.py +13 -1
  176. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
  177. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
  178. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-pack.js +386 -579
  179. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
  180. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
  181. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/office-run.mjs +2 -1
  182. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/qa_deck.py +7 -13
  183. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/render_pages.py +124 -0
  184. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
  185. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
  186. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
  187. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +100 -0
  188. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
  189. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
  190. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
  191. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
  192. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
  193. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
  194. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
  195. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
  196. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
  197. package/marketplace/plugins/litcodex/skills/lit-recap/SKILL.md +2 -0
  198. package/marketplace/plugins/litcodex/skills/lit-schematic/SKILL.md +198 -0
  199. package/marketplace/plugins/litcodex/skills/lit-schematic/agents/openai.yaml +6 -0
  200. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
  201. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
  202. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
  203. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
  204. package/marketplace/plugins/litcodex/skills/lit-schematic/references/cutaway-outputs.md +70 -0
  205. package/marketplace/plugins/litcodex/skills/lit-schematic/references/isometric-craft.md +101 -0
  206. package/marketplace/plugins/litcodex/skills/lit-schematic/references/journal-figures.md +72 -0
  207. package/marketplace/plugins/litcodex/skills/lit-schematic/references/kit-api.md +134 -0
  208. package/marketplace/plugins/litcodex/skills/lit-schematic/references/pfd-and-layout.md +53 -0
  209. package/marketplace/plugins/litcodex/skills/lit-schematic/references/pid-drafting.md +103 -0
  210. package/marketplace/plugins/litcodex/skills/lit-schematic/references/pid-symbols.md +163 -0
  211. package/marketplace/plugins/litcodex/skills/lit-schematic/references/verification.md +100 -0
  212. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/doctor.mjs +57 -0
  213. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
  214. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/fonts.mjs +28 -0
  215. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
  216. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
  217. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
  218. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
  219. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
  220. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
  221. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/png.mjs +132 -0
  222. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
  223. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/route.mjs +218 -0
  224. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
  225. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
  226. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
  227. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/motion.mjs +129 -0
  228. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/qa.mjs +92 -0
  229. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/render.mjs +233 -0
  230. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/scaffold.mjs +60 -0
  231. package/marketplace/plugins/litcodex/skills/lit-scientific-visualization/SKILL.md +34 -8
  232. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/SKILL.md +18 -14
  233. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +12 -0
  234. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/assets.mjs +388 -0
  235. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/blender/runner.py +221 -0
  236. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/blender.mjs +132 -0
  237. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/board.mjs +142 -0
  238. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/constants.mjs +6 -0
  239. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-assets.mjs +7 -4
  240. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-capture.mjs +8 -7
  241. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-init.js +14 -2
  242. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-treatment.mjs +38 -3
  243. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover.mjs +19 -4
  244. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/driver.mjs +8 -8
  245. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/gallery.mjs +147 -0
  246. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/house.mjs +45 -0
  247. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/image.mjs +89 -0
  248. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/look.mjs +58 -25
  249. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/runtime.mjs +59 -14
  250. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/safe-read.mjs +32 -0
  251. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/scaffold.mjs +208 -0
  252. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/score.mjs +668 -0
  253. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/sound.mjs +174 -31
  254. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-gate.mjs +45 -3
  255. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-kit.js +99 -1
  256. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.js +8 -1
  257. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.mjs +180 -11
  258. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-render.mjs +42 -12
  259. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-worker.mjs +7 -4
  260. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage.mjs +96 -10
  261. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/styles.mjs +233 -0
  262. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/treatment.mjs +291 -14
  263. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
  264. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
  265. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
  266. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
  267. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/recipes/hero-3d/expected.json +33 -0
  268. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
  269. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/cover.md +44 -7
  270. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/depth.md +156 -0
  271. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/design-choice.md +22 -0
  272. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/quality-gate.md +29 -7
  273. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/runtime.md +1 -1
  274. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/sound.md +87 -0
  275. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/stage.md +19 -7
  276. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/studio.md +246 -0
  277. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/style-bibles.md +2 -2
  278. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/treatment.md +41 -21
  279. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/scripts/render.mjs +51 -4
  280. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/paper.json +185 -0
  281. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/swiss-signal.json +188 -0
  282. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/terminalcore.json +182 -0
  283. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/tidal.json +187 -0
  284. package/marketplace/plugins/litcodex/skills/litresearch/SKILL.md +7 -0
  285. package/marketplace/plugins/litcodex/skills/litwork/SKILL.md +2 -1
  286. package/marketplace/plugins/litcodex/skills/readme-studio/SKILL.md +10 -0
  287. package/marketplace/plugins/litcodex/skills/review-work/SKILL.md +7 -1
  288. package/marketplace/plugins/litcodex/skills/start-work/SKILL.md +10 -0
  289. package/node_modules/@litcodex/lit-loop/directive.md +10 -4
  290. package/node_modules/@litcodex/lit-loop/directives/lit-adhd.md +191 -0
  291. package/node_modules/@litcodex/lit-loop/directives/lit-handoff.md +2 -0
  292. package/node_modules/@litcodex/lit-loop/directives/lit-hijack.md +219 -0
  293. package/node_modules/@litcodex/lit-loop/directives/lit-recap.md +2 -0
  294. package/node_modules/@litcodex/lit-loop/directives/lit-schematic.md +199 -0
  295. package/node_modules/@litcodex/lit-loop/directives/litwork.md +2 -1
  296. package/node_modules/@litcodex/lit-loop/dist/adhd-suggest.d.ts +10 -0
  297. package/node_modules/@litcodex/lit-loop/dist/adhd-suggest.js +67 -0
  298. package/node_modules/@litcodex/lit-loop/dist/card-html.d.ts +1 -1
  299. package/node_modules/@litcodex/lit-loop/dist/card-html.js +128 -8
  300. package/node_modules/@litcodex/lit-loop/dist/card-looks.d.ts +19 -0
  301. package/node_modules/@litcodex/lit-loop/dist/card-looks.js +58 -0
  302. package/node_modules/@litcodex/lit-loop/dist/card-status.d.ts +27 -0
  303. package/node_modules/@litcodex/lit-loop/dist/card-status.js +94 -7
  304. package/node_modules/@litcodex/lit-loop/dist/cli.js +13 -3
  305. package/node_modules/@litcodex/lit-loop/dist/codex-hook.d.ts +2 -0
  306. package/node_modules/@litcodex/lit-loop/dist/codex-hook.js +8 -9
  307. package/node_modules/@litcodex/lit-loop/dist/control-chars.d.ts +5 -0
  308. package/node_modules/@litcodex/lit-loop/dist/control-chars.js +23 -0
  309. package/node_modules/@litcodex/lit-loop/dist/hook-cli.d.ts +8 -0
  310. package/node_modules/@litcodex/lit-loop/dist/hook-cli.js +118 -11
  311. package/node_modules/@litcodex/lit-loop/dist/hud.d.ts +1 -1
  312. package/node_modules/@litcodex/lit-loop/dist/hud.js +29 -13
  313. package/node_modules/@litcodex/lit-loop/dist/lane-events.d.ts +13 -0
  314. package/node_modules/@litcodex/lit-loop/dist/lane-events.js +85 -0
  315. package/node_modules/@litcodex/lit-loop/dist/lane-state.d.ts +55 -0
  316. package/node_modules/@litcodex/lit-loop/dist/lane-state.js +227 -0
  317. package/node_modules/@litcodex/lit-loop/dist/live-step.d.ts +5 -1
  318. package/node_modules/@litcodex/lit-loop/dist/live-step.js +17 -1
  319. package/node_modules/@litcodex/lit-loop/dist/markers.d.ts +6 -0
  320. package/node_modules/@litcodex/lit-loop/dist/markers.js +6 -0
  321. package/node_modules/@litcodex/lit-loop/dist/modes.d.ts +1 -1
  322. package/node_modules/@litcodex/lit-loop/dist/modes.js +25 -1
  323. package/node_modules/@litcodex/lit-loop/dist/motion-gate.d.ts +79 -0
  324. package/node_modules/@litcodex/lit-loop/dist/motion-gate.js +310 -0
  325. package/node_modules/@litcodex/lit-loop/dist/motion-route.js +5 -1
  326. package/node_modules/@litcodex/lit-loop/dist/plan-persistence.js +10 -0
  327. package/node_modules/@litcodex/lit-loop/dist/redaction.js +18 -0
  328. package/node_modules/@litcodex/lit-loop/dist/reentry.d.ts +15 -0
  329. package/node_modules/@litcodex/lit-loop/dist/reentry.js +46 -9
  330. package/node_modules/@litcodex/lit-loop/dist/rewind-cli.d.ts +10 -0
  331. package/node_modules/@litcodex/lit-loop/dist/rewind-cli.js +88 -0
  332. package/node_modules/@litcodex/lit-loop/dist/rewind-go.d.ts +20 -0
  333. package/node_modules/@litcodex/lit-loop/dist/rewind-go.js +84 -0
  334. package/node_modules/@litcodex/lit-loop/dist/rewind-look.d.ts +6 -0
  335. package/node_modules/@litcodex/lit-loop/dist/rewind-look.js +41 -0
  336. package/node_modules/@litcodex/lit-loop/dist/rewind-redact.d.ts +3 -0
  337. package/node_modules/@litcodex/lit-loop/dist/rewind-redact.js +40 -0
  338. package/node_modules/@litcodex/lit-loop/dist/rewind-rollout.d.ts +48 -0
  339. package/node_modules/@litcodex/lit-loop/dist/rewind-rollout.js +292 -0
  340. package/node_modules/@litcodex/lit-loop/dist/rewind.d.ts +162 -0
  341. package/node_modules/@litcodex/lit-loop/dist/rewind.js +773 -0
  342. package/node_modules/@litcodex/lit-loop/dist/route-heads.js +44 -2
  343. package/node_modules/@litcodex/lit-loop/dist/run-panel.js +1 -0
  344. package/node_modules/@litcodex/lit-loop/dist/schematic-route.d.ts +6 -0
  345. package/node_modules/@litcodex/lit-loop/dist/schematic-route.js +35 -0
  346. package/node_modules/@litcodex/lit-loop/dist/screen-card.d.ts +3 -0
  347. package/node_modules/@litcodex/lit-loop/dist/screen-card.js +15 -5
  348. package/node_modules/@litcodex/lit-loop/dist/skill-mention-scope.js +6 -0
  349. package/node_modules/@litcodex/lit-loop/dist/stack-hook.d.ts +8 -0
  350. package/node_modules/@litcodex/lit-loop/dist/stack-hook.js +57 -0
  351. package/node_modules/@litcodex/lit-loop/dist/statusline.js +8 -3
  352. package/node_modules/@litcodex/lit-loop/dist/threads.d.ts +50 -0
  353. package/node_modules/@litcodex/lit-loop/dist/threads.js +178 -0
  354. package/node_modules/@litcodex/lit-loop/dist/trigger.d.ts +1 -1
  355. package/node_modules/@litcodex/lit-loop/dist/trigger.js +29 -5
  356. package/node_modules/@litcodex/lit-loop/dist/workflow-map.d.ts +10 -0
  357. package/node_modules/@litcodex/lit-loop/dist/workflow-map.js +11 -1
  358. package/node_modules/@litcodex/lit-loop/dist/workflow-stack.d.ts +132 -0
  359. package/node_modules/@litcodex/lit-loop/dist/workflow-stack.js +488 -0
  360. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  361. package/node_modules/@litcodex/lit-loop/skills/lit-adhd/SKILL.md +181 -0
  362. package/node_modules/@litcodex/lit-loop/skills/lit-hijack/SKILL.md +449 -0
  363. package/node_modules/@litcodex/lit-loop/skills/lit-loop/SKILL.md +13 -4
  364. package/node_modules/@litcodex/lit-loop/skills/lit-plan/SKILL.md +6 -0
  365. package/node_modules/@litcodex/lit-loop/skills/lit-recap/SKILL.md +2 -0
  366. package/node_modules/@litcodex/lit-loop/skills/lit-schematic/SKILL.md +198 -0
  367. package/node_modules/@litcodex/lit-loop/skills/lit-scientific-visualization/SKILL.md +34 -8
  368. package/node_modules/@litcodex/lit-loop/skills/litresearch/SKILL.md +7 -0
  369. package/node_modules/@litcodex/lit-loop/skills/litwork/SKILL.md +2 -1
  370. package/node_modules/@litcodex/lit-loop/skills/review-work/SKILL.md +7 -1
  371. package/node_modules/@litcodex/lit-loop/skills/start-work/SKILL.md +10 -0
  372. package/package.json +2 -2
  373. package/readme-assets/badge-version.svg +1 -1
  374. package/readme-assets/skills/lit-adhd.webp +0 -0
  375. package/readme-assets/skills/lit-hijack.webp +0 -0
  376. package/readme-assets/skills/lit-schematic.webp +0 -0
@@ -0,0 +1,33 @@
1
+ {
2
+ "schema": 1,
3
+ "note": "Measured 2026-10-26 on the gpu rung (Chrome 155, macOS arm64); the software rung renders the same frames slower and is compared with a note.",
4
+ "row": { "medianD": 0.002485, "movingFrac": 1, "longestStillSec": 0.05, "spike": 3.684, "seamLocal": 1.194, "bytes": 1058278 },
5
+ "settings": { "size": [1000, 500], "fps": 20, "frames": 160, "encode": { "q": 94, "edgeQ": 97, "edgeFrames": 15, "method": 4 } },
6
+ "treatment": {
7
+ "mode": "cover",
8
+ "request": "A README motion cover for LitCodex with a product object that opens.",
9
+ "idea": "A case turns once and opens on its beat to show the lit core inside, beside a still name.",
10
+ "recipe": "hero-3d",
11
+ "recipeReason": "One object acting once per loop says what the project holds better than a type pattern.",
12
+ "hero": "A rounded case with a hinged lid and a lit core.",
13
+ "beat": "The lid opens, the core rises and settles, and the lid closes.",
14
+ "brandWord": "LITCODEX",
15
+ "motto": { "text": "KEEP THE WORK LIT.", "source": "project", "from": "README.md" },
16
+ "aspect": "2:1",
17
+ "loopSec": 8,
18
+ "fps": 20,
19
+ "layers": {
20
+ "slow": "The case turns exactly once per loop.",
21
+ "mid": "The camera breathes twice per loop.",
22
+ "beat": "The lid opens on the core and a ring runs out across the floor."
23
+ },
24
+ "system": {
25
+ "rule": "One hinge rule and one turn rule on one object.",
26
+ "copies": "One case, one core, one ring.",
27
+ "offset": "The ring trails the lid by a tenth of the loop."
28
+ },
29
+ "title": { "box": [0.05, 0.36, 0.43, 0.14], "kind": "live" },
30
+ "encode": { "q": 94, "edgeQ": 97, "edgeFrames": 15 },
31
+ "ambition": "The object reads as a product in a studio and its beat lands once per loop."
32
+ }
33
+ }
@@ -0,0 +1,139 @@
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <!-- Cover recipe: hero 3D (one product object, lit in a small studio, acting its beat once per loop).
6
+ A rounded case turns exactly once per loop (slow layer), the camera breathes twice (mid layer), and
7
+ once per loop the lid opens, a lit core rises and settles back and the lid closes while a ring runs
8
+ out across the floor (the beat). The word sits still on the left. Drawn with the pinned three.js
9
+ build served at /lit/three/, on the GPU rung (the software rung when the GPU is missing). Replace
10
+ the word, the motto and the HERO block with the project's own object. -->
11
+ <link rel="stylesheet" href="/lit/fonts.css">
12
+ <script src="/lit/loop-kit.js"></script>
13
+ <script type="importmap">{ "imports": { "three": "/lit/three/three.module.js", "three/addons/": "/lit/three/addons/" } }</script>
14
+ <style>
15
+ html, body { margin: 0; width: 1200px; height: 600px; overflow: hidden; background: #0b0f16; }
16
+ canvas { position: absolute; left: 0; top: 0; width: 1200px; height: 600px; display: block; }
17
+ </style>
18
+ </head>
19
+ <body>
20
+ <canvas id="world"></canvas>
21
+ <canvas id="type" width="2400" height="1200"></canvas>
22
+ <script type="module">
23
+ import * as THREE from "three";
24
+ import { RoomEnvironment } from "three/addons/environments/RoomEnvironment.js";
25
+ import { RoundedBoxGeometry } from "three/addons/geometries/RoundedBoxGeometry.js";
26
+
27
+ const { TAU, clamp, fract, ease } = LitLoop;
28
+ const span = (a, b, t) => clamp((t - a) / (b - a));
29
+ const C = { bg: "#0b0f16", ivory: "#f2efdf", dim: "#8b8f8f", orange: "#ff6337", shell: "#d9d4c4", inner: "#1a2230" };
30
+ const W = 1200, H = 600;
31
+ const AIM = { x: 860, y: 318 };
32
+
33
+ // ---- the world: renderer, studio light, floor ----
34
+ const glCanvas = document.getElementById("world");
35
+ const renderer = new THREE.WebGLRenderer({ canvas: glCanvas, antialias: true, alpha: true, preserveDrawingBuffer: true });
36
+ renderer.setPixelRatio(window.devicePixelRatio);
37
+ renderer.setSize(W, H, false);
38
+ renderer.setClearColor(0x000000, 0);
39
+ renderer.outputColorSpace = THREE.SRGBColorSpace;
40
+ renderer.toneMapping = THREE.ACESFilmicToneMapping;
41
+ renderer.shadowMap.enabled = true;
42
+ renderer.shadowMap.type = THREE.PCFSoftShadowMap;
43
+ const scene = new THREE.Scene();
44
+ scene.environment = new THREE.PMREMGenerator(renderer).fromScene(new RoomEnvironment(), 0.04).texture;
45
+ scene.environmentIntensity = 0.55;
46
+ const cam = new THREE.PerspectiveCamera(30, W / H, 0.1, 60);
47
+ cam.setViewOffset(W, H, W / 2 - AIM.x, H / 2 - AIM.y, W, H);
48
+ const key = new THREE.DirectionalLight(0xffffff, 2.4);
49
+ key.position.set(-3, 6, 4);
50
+ key.castShadow = true;
51
+ key.shadow.mapSize.set(2048, 2048);
52
+ key.shadow.radius = 5;
53
+ key.shadow.bias = -0.0004;
54
+ key.shadow.normalBias = 0.03;
55
+ key.shadow.camera.left = -4; key.shadow.camera.right = 4; key.shadow.camera.top = 4; key.shadow.camera.bottom = -4;
56
+ const rim = new THREE.DirectionalLight(0xffb08f, 1.1);
57
+ rim.position.set(4, 2.5, -5);
58
+ scene.add(key, rim);
59
+ const floor = new THREE.Mesh(new THREE.PlaneGeometry(30, 30), new THREE.ShadowMaterial({ opacity: 0.35 }));
60
+ floor.rotation.x = -Math.PI / 2;
61
+ floor.receiveShadow = true;
62
+ scene.add(floor);
63
+ const ring = new THREE.Mesh(new THREE.RingGeometry(0.98, 1, 128), new THREE.MeshBasicMaterial({ color: C.orange, transparent: true, opacity: 0 }));
64
+ ring.rotation.x = -Math.PI / 2;
65
+ ring.position.y = 0.002;
66
+ scene.add(ring);
67
+
68
+ // ---- HERO: the product object (a case with a hinged lid and a lit core) ----
69
+ const shell = new THREE.MeshPhysicalMaterial({ color: C.shell, roughness: 0.32, metalness: 0.05, clearcoat: 0.6, clearcoatRoughness: 0.2 });
70
+ const inner = new THREE.MeshStandardMaterial({ color: C.inner, roughness: 0.8 });
71
+ const HERO = new THREE.Group();
72
+ const base = new THREE.Mesh(new RoundedBoxGeometry(1.6, 0.62, 1.1, 6, 0.12), shell);
73
+ base.position.y = 0.31;
74
+ const well = new THREE.Mesh(new RoundedBoxGeometry(1.38, 0.5, 0.88, 4, 0.08), inner);
75
+ well.position.y = 0.4;
76
+ const hinge = new THREE.Group();
77
+ hinge.position.set(0, 0.64, -0.55);
78
+ const lid = new THREE.Mesh(new RoundedBoxGeometry(1.6, 0.16, 1.1, 6, 0.07), shell);
79
+ lid.position.set(0, 0.08, 0.55);
80
+ hinge.add(lid);
81
+ const coreMat = new THREE.MeshStandardMaterial({ color: C.orange, emissive: C.orange, emissiveIntensity: 0, roughness: 0.35 });
82
+ const core = new THREE.Mesh(new THREE.IcosahedronGeometry(0.24, 3), coreMat);
83
+ const glow = new THREE.PointLight(C.orange, 0, 4, 2);
84
+ core.add(glow);
85
+ for (const m of [base, lid, core]) m.castShadow = true;
86
+ base.receiveShadow = true;
87
+ HERO.add(base, well, hinge, core);
88
+ scene.add(HERO);
89
+
90
+ // The beat: open 0.28-0.44, hold, close 0.62-0.78; zero at both ends, so the loop closes.
91
+ const openAt = (t) => ease.smooth(span(0.28, 0.44, t)) * (1 - ease.smooth(span(0.62, 0.78, t)));
92
+
93
+ function drawWorld(t) {
94
+ HERO.rotation.y = -0.5 + TAU * t;
95
+ const open = openAt(t);
96
+ hinge.rotation.x = -1.45 * open;
97
+ const rise = ease.outBack(span(0.36, 0.5, t)) * (1 - ease.smooth(span(0.58, 0.7, t)));
98
+ core.position.y = 0.42 + 0.6 * rise;
99
+ core.rotation.y = TAU * 2 * t;
100
+ coreMat.emissiveIntensity = 1.1 * open;
101
+ glow.intensity = 3 * open;
102
+ const wave = ease.outCubic(span(0.38, 0.72, t));
103
+ ring.scale.setScalar(0.9 + 1.3 * wave);
104
+ ring.material.opacity = 0.55 * open * (1 - wave);
105
+ const breathe = Math.sin(TAU * 2 * t);
106
+ cam.position.set(5.8 * Math.sin(0.35), 2.3 + 0.12 * breathe, 5.8 * Math.cos(0.35));
107
+ cam.lookAt(0, 0.62 + 0.04 * breathe, 0);
108
+ renderer.render(scene, cam);
109
+ }
110
+
111
+ // ---- the word, set once ----
112
+ const ctx = document.getElementById("type").getContext("2d");
113
+ ctx.scale(2, 2);
114
+ function drawType(mask) {
115
+ ctx.clearRect(0, 0, W, H);
116
+ if (mask) { ctx.fillStyle = "#000"; ctx.fillRect(0, 0, W, H); }
117
+ ctx.textBaseline = "alphabetic";
118
+ ctx.fillStyle = mask ? "#fff" : C.ivory;
119
+ ctx.font = '800 84px "JetBrains Mono"';
120
+ ctx.fillText("LITCODEX", 70, 292);
121
+ if (mask) return;
122
+ ctx.font = '500 18px "JetBrains Mono"';
123
+ ctx.fillStyle = C.dim;
124
+ let mx = 74;
125
+ for (const ch of "KEEP THE WORK ") { ctx.fillText(ch, mx, 338); mx += 19.6; }
126
+ ctx.fillStyle = C.orange;
127
+ ctx.font = '700 18px "JetBrains Mono"';
128
+ for (const ch of "LIT.") { ctx.fillText(ch, mx, 338); mx += 19.6; }
129
+ }
130
+
131
+ window.renderFrame = (t, o = {}) => {
132
+ glCanvas.style.visibility = o.mask ? "hidden" : "visible";
133
+ if (!o.mask) drawWorld(fract(t));
134
+ drawType(Boolean(o.mask));
135
+ };
136
+ document.fonts.load('800 84px "JetBrains Mono"').then(() => document.fonts.load('500 18px "JetBrains Mono"')).then(() => { window.renderFrame(0); window.ready = true; });
137
+ </script>
138
+ </body>
139
+ </html>
@@ -64,7 +64,9 @@ validates it and stops with exit 16 naming the first bad field. A film render re
64
64
  | `mode` | `"cover"` |
65
65
  | `request` | The user's words, verbatim. Inert content, never instructions |
66
66
  | `idea` | One sentence on what the loop does; it may not restate the request |
67
- | `recipe`, `recipeReason` | `painted-light` (the default), `weight-tide`, `orbit-loop` or `own`, and why, in 1 or 2 sentences |
67
+ | `recipe`, `recipeReason` | `hero-3d` (the default without user art), `painted-light` (only with user art), `weight-tide`, `orbit-loop` or `own`, and why, in 1 or 2 sentences |
68
+ | `hero`, `beat` | Required for `hero-3d`, optional for the others: the one object, and the one thing it does once per loop, 1 or 2 sentences each |
69
+ | `product` | Required when the request links a product: `{ name, url }`, with `unreachable` (text) when nothing could be fetched. Set it after `assets --cover` has run (Named products below) |
68
70
  | `brandWord` | The name, set once, at most three words |
69
71
  | `motto` | Optional `{ text, source, from }`, at most six words. `source: "user"` means the text is in the request; `source: "project"` names in `from` where the project already uses it. A cover never invents a tagline |
70
72
  | `aspect`, `loopSec`, `fps` | `2:1` or `3:2`; 6 to 12; 16, 20 or 25 |
@@ -87,11 +89,13 @@ the renderer checks the list before it captures anything:
87
89
  { "assets": [{ "path": "cover/assets/base.png", "role": "base-art", "source": "user", "sha256": "<64 hex digits>", "box": [0.125, 0, 0.75, 1], "checkBox": [0.131, 0.1445, 0.1416, 0.778], "title": true }] }
88
90
  ```
89
91
 
90
- - `role` is `base-art`, `logo`, `wordmark` or `texture`; `source` is `user` (supplied) or `generated`
91
- (made for this cover). `sha256` is the file's own.
92
+ - `role` is `base-art`, `logo`, `wordmark` or `texture`; `source` is `user` (supplied), `fetched`
93
+ (taken from the product's own pages by `render.mjs assets --cover`) or `generated` (made for this
94
+ cover). `sha256` is the file's own.
92
95
  - A listed file that is missing stops the run with exit 22 `BLOCKED_ASSET_MISSING` before any frame
93
96
  is captured. Ask for the art or generate it; never draw a stand-in in its place. The
94
- `painted-light` recipe cannot run without a `base-art` entry. A raster in `cover/` that the list
97
+ `painted-light` recipe cannot run without a `base-art` entry whose `source` is `user`; with no user
98
+ art take `hero-3d`. A raster in `cover/` that the list
95
99
  does not name, or a listed file whose bytes no longer match its hash, is exit 17. A malformed entry
96
100
  is exit 16 naming it.
97
101
  - `box` is where the base art sits on the cover, as fractions. After the render, frame 0 has to show
@@ -160,8 +164,21 @@ Each recipe ships as a worked page in `recipes/<name>/index.html` with the row i
160
164
  `cover/`, then replace the brand word, the motto and, for the painted recipe, the `PAINTING` block.
161
165
  The pages are examples; the craft rules above are what transfers to a new cover.
162
166
 
163
- - **Painted base + travelling light (`painted-light`, the default).** A finished painting, supplied
164
- by the user or generated and labelled as generated, is the whole picture, and the page relights it.
167
+ - **Hero 3D (`hero-3d`, the default without user art).** One product object, lit in a small studio,
168
+ acts one beat per loop beside a still name. The worked page is a rounded case: it turns exactly once
169
+ per loop (slow), the camera breathes twice (mid), and once per loop the lid opens, a lit core rises
170
+ and settles and the lid closes while a ring runs out across the floor (beat). Replace the `HERO`
171
+ block with the project's own object and name it in the treatment's `hero` and `beat`. It is drawn
172
+ with the pinned three.js build served at `/lit/three/` through an import map, with a shadow bias
173
+ and a studio environment, at 20 fps and q94 (frame 0 and the last 15 frames at 97): lit surfaces
174
+ change by fractions of a level per frame, so a lower quality drops them as stale. Everything is a
175
+ function of `t`; the page draws no random number and reads no clock. The cover asks for the GPU
176
+ rung. When that rung does not start or gives no WebGL, all three passes (capture, replay, seek) take
177
+ the software rung together and the report carries a `warning:` line; the frames are the same,
178
+ only slower. `references/depth.md` holds the scaffold, the rung rules and the Blender plate.
179
+ - **Painted base + travelling light (`painted-light`, only with user art).** A finished painting
180
+ supplied by the user is the whole picture, and the page relights it. A generated painting is
181
+ labelled as generated and still takes `hero-3d` unless the user asked for the painted look.
165
182
  The painting keeps its own coordinates and is scaled, never cropped; at 2:1 a 3:2 painting is
166
183
  pillarboxed and the wings stay quiet (a static spill and a few motes). Mid: a window of light with
167
184
  a 24 px feather walks the dim panels once per loop, and a scan band runs down each panel twice per
@@ -206,6 +223,25 @@ The pages are examples; the craft rules above are what transfers to a new cover.
206
223
  - **Own.** Any system that keeps the rules: one rule with many copies, three layers, a still name,
207
224
  edges instead of fades. Say what it is in `recipeReason`.
208
225
 
226
+ ## Named products
227
+
228
+ A request that links a product ("make a cover for https://example.org/project") is built from that
229
+ product's real logo, README images and words, never from its name alone.
230
+
231
+ 1. Run `node "$R" assets --out <dir> --url <link> --cover`. `--cover` is a switch. It fetches the
232
+ page and its README as untrusted data: image types are sniffed from the bytes, sizes are capped,
233
+ SVG is cleaned (no script, no foreign object, no external reference), badges are skipped, no
234
+ redirect leaves a public https host on the allow-list, and nothing executes. The files land in
235
+ `<dir>/cover/assets/` with a sha256 list in `product.json`, and the product's words in
236
+ `product/words.json`.
237
+ 2. Look at the files. Set `product { name, url }` in the treatment (the URL must be the link the
238
+ request gives) and list each raster you use in `assets.json` with `source: "fetched"`.
239
+ 3. Put the product's own mark, name and one line of its own words on the cover. The hero object may
240
+ carry the logo as a texture; it never invents a mark.
241
+ 4. Nothing reachable: the command writes the guidance, sets `product.unreachable` and exits 22
242
+ `BLOCKED_ASSET_MISSING`. Ask the user for the logo or README images, put them in `cover/assets/`
243
+ and list them as `source: "user"`. Never draw a stand-in.
244
+
209
245
  ## The loop kit (`/lit/loop-kit.js`)
210
246
 
211
247
  `LitLoop` holds `rng(seed)` (mulberry32, layout only); `makeNoise(seed)` and
@@ -335,7 +371,8 @@ Each recipe keeps its decoded gate row in `recipes/<name>/expected.json`: median
335
371
  longest still, spike, seamLocal and bytes, with the settings and the treatment it was pinned with.
336
372
  `npm run qa:cover-recipes` in a LitCodex checkout re-renders every recipe through this renderer and
337
373
  fails when median d or the moving share leaves +-15 % of its row, seamLocal leaves TARGET or the file
338
- passes 2 MiB.
374
+ passes 2 MiB. The `hero-3d` row was measured on the GPU rung; the QA prints the rung each row rendered
375
+ on, and a run that fell back to the software rung says so instead of hiding it.
339
376
 
340
377
  Every negative and regression declares the gates it must fail (`mustFail`, as `G2.floor` or
341
378
  `G1.target`). `--negatives` renders them all, and one counts as caught only when its render
@@ -0,0 +1,156 @@
1
+ # Depth: the 3D route
2
+
3
+ Read this when the treatment's subject is a `depth3d` device (`depth: "3d"`), when a film asks for
4
+ path-traced light (`render3d: "blender"`), or when a cover takes the `hero-3d` recipe. A 3D object is
5
+ the right subject when the film is about a thing that has a back and an inside: a product that turns,
6
+ opens, unfolds or is assembled. A flat diagram, a chart or a line of type does not need it; keep those
7
+ on the 2D page, where every frame is cheaper and the gates read the DOM directly.
8
+
9
+ ## When 3D, and which kind
10
+
11
+ | The subject | Take |
12
+ | --- | --- |
13
+ | A diagram, chart, UI screen, timeline or type | 2D (`depth: "2d"`, the default) |
14
+ | A product, device, package or tool that turns, opens or assembles | `depth: "3d"` with `render3d: "three"` |
15
+ | The request asks for high-quality, cinematic or photoreal 3D, and Blender is installed | `depth: "3d"` with `render3d: "blender"` |
16
+ | The same, and Blender is missing | `render3d: "three"` and say so in the reply |
17
+ | A README cover with no user art | the `hero-3d` cover recipe |
18
+
19
+ Never take 3D to decorate a flat idea. The `depth3d` device must be the depiction of what the film is
20
+ about (the `subject` role), with its beats covering at least half the film.
21
+
22
+ ## What the renderer gives you
23
+
24
+ - **A pinned three.js.** The skill ships three.js r170 (npm `three@0.170.0`, MIT) unminified in
25
+ `engine/vendor/three/`: `three.module.js` plus two addons, `environments/RoomEnvironment.js` and
26
+ `geometries/RoundedBoxGeometry.js`. The stage router serves them at `/lit/three/`; a page imports
27
+ them through an import map:
28
+
29
+ ```html
30
+ <script type="importmap">{ "imports": { "three": "/lit/three/three.module.js", "three/addons/": "/lit/three/addons/" } }</script>
31
+ <script type="module">
32
+ import * as THREE from "three";
33
+ import { RoomEnvironment } from "three/addons/environments/RoomEnvironment.js";
34
+ import { RoundedBoxGeometry } from "three/addons/geometries/RoundedBoxGeometry.js";
35
+ </script>
36
+ ```
37
+
38
+ Any other path under `/lit/three/` is refused and recorded as a missing file, and the network rules
39
+ still hold: never load three.js, a model or a texture from a CDN. The file hashes and the licence are
40
+ in `engine/THIRD_PARTY_NOTICES`, and a test recomputes the hashes.
41
+ - **The GPU rung.** A `depth: "3d"` film with `render3d: "three"` and a `hero-3d` cover start Chrome on
42
+ the platform's GPU rung (ANGLE on Metal on macOS, GL on Linux, D3D11 on Windows). Page rasterization
43
+ stays on the CPU (`--disable-gpu-rasterization --disable-partial-raster`), so text and DOM layers
44
+ rasterize exactly as on the software rung; only WebGL is hardware. The renderer probes the rung on
45
+ an empty page first: it must give a WebGL2 context on a hardware renderer string. The WebGL renderer
46
+ is recorded, and MO-C-02 names the rung and the renderer.
47
+ - **One rung per round.** The master pass and every replay (the determinism replay, the QA replay,
48
+ the cover's seek pass) run on the same rung, because pixels from two rungs are not comparable. A
49
+ replay on the GPU rung must reproduce the sampled frames byte for byte, or the render stops with
50
+ exit 18, exactly as on the software rung. The rung is chosen from the treatment or the recipe, never
51
+ by the page.
52
+ - **A labelled fallback.** When the GPU rung does not start, gives the page no WebGL2 or hands it a
53
+ software renderer, the whole round reopens on the software rung (SwiftShader). The notice goes into
54
+ the report, the manifest (`notices`, `rung: "software"`) and, for a cover, a `warning:` line. The
55
+ film still renders, only slower. Say in the reply that it rendered without the GPU. Only when no
56
+ rung has WebGL is it exit 11 `BLOCKED_NO_WEBGL2`. A context that the page creates lazily, after the
57
+ probe, is caught by the post-load WebGL report instead of the probe.
58
+
59
+ ## The scaffold's world
60
+
61
+ `render.mjs scaffold` on a `depth: "3d"` treatment adds, on top of the 2D shots, a world the shots
62
+ share:
63
+
64
+ - a `<canvas id="world">` behind every shot's section, so the type stays DOM text the QA can read;
65
+ - one renderer for the whole film (alpha, `preserveDrawingBuffer`, pixel ratio 1, ACES tone mapping,
66
+ soft shadows), a `RoomEnvironment` for reflections, a key light with a biased shadow, a hemisphere
67
+ light in the style's colours and a shadow-only floor;
68
+ - `HERO`, a group that holds the protagonist from the first frame to the last, posed per shot.
69
+
70
+ Build the protagonist once, in `HERO`, and only pose it per shot: that is what makes it the same
71
+ object across the film. Everything is a function of the film time the stage hands the page: no
72
+ `Math.random`, no clock, no physics that integrates across frames. Re-pose from scratch every
73
+ `render(t)`.
74
+
75
+ For a named product, start from its real logo and screens (`render.mjs assets`, see
76
+ `references/cover.md`, Named products): a fetched logo or screenshot goes on a plane or a face of the
77
+ object as a texture (`TextureLoader` on the file under `stage/assets/`), and a simple logo shape can be
78
+ traced into a `THREE.Shape` and given depth with `ExtrudeGeometry`. The `ASSET-USED` gate rule fails
79
+ the film when a product treatment fetched assets and no page file references one.
80
+
81
+ ## Craft and the gate
82
+
83
+ - **Turn slowly.** A full turn takes the loop (a cover) or a whole shot (a film). Fast spins, flickering
84
+ specular highlights and shadow acne all read as flashes and fail MO-C-03.
85
+ - **Bias the shadow.** On a turning object set `shadow.bias` about -0.0004 and `shadow.normalBias`
86
+ about 0.03; without them the self-shadow flickers from frame to frame.
87
+ - **Ease every open and close.** A lid, a drawer or an exploded view eases in and out (`ease.smooth`),
88
+ holds, and returns; the move is the beat, so it happens once, where the treatment's story puts it.
89
+ - **Keep the type in the DOM.** Copy stays in the shot's type zone as HTML text over the canvas; text
90
+ drawn inside the 3D scene is invisible to the QA unless registered with `LitStage.text`.
91
+ - **Mind the dead air.** A small object on a large empty ground is `DEAD-AIR`; frame it with the `hero`
92
+ layout or move the camera in.
93
+ - **Covers at 20 fps and q94.** The cover gate measures on a 50 ms grid; at 25 fps a smooth turn lands
94
+ two frames on one step at the seam (FLOOR), while at 20 fps every step is one frame. Smooth lit
95
+ surfaces blotch at the default q86, so the `hero-3d` recipe encodes at q94 with frame 0 and the last
96
+ 15 frames at 97.
97
+
98
+ ## Camera moves and the flash audit
99
+
100
+ A rich film moves its camera in at least half its shots, and the flash audit stays exactly as it is.
101
+ When a move fails MO-C-03, keep the move and change what it passes over: slow the light change (a
102
+ highlight that sweeps over 0.5 s or more, not one frame), lower the contrast of the detail behind the
103
+ move, add motion blur (the Blender rung renders it; on the GPU rung average 4 to 8 sub-frame poses),
104
+ or cut instead of whipping. Removing the camera move is a downgrade.
105
+
106
+ ## The Blender rung (`render3d: "blender"`)
107
+
108
+ For path-traced light (bevels that catch it, soft global illumination, depth of field, motion blur) a
109
+ 3D film renders its world once in Blender with Cycles. The page then shows the rendered plate and keeps
110
+ its type, labels and 2D layers in the DOM over it.
111
+
112
+ **When to take it.** Only when the request asks for high-quality, cinematic or photoreal 3D (high
113
+ quality, cinematic, photoreal, Blender, or the Korean equivalents) and `findBlender()` finds an
114
+ install. A plate is expensive: on an Apple M-series GPU a hero scene takes several seconds per 1080p
115
+ frame at 160 samples, so a 13 s plate at 30 fps (390 frames) takes the better part of an hour. That
116
+ cost buys light the three.js route cannot draw, and nothing else; a film that does not ask for it
117
+ stays on `three`. Settle the scene on the preview stills first, since a fix after the final means
118
+ rendering the plate again, and build the page's panels while the plate renders.
119
+
120
+ **One plate per film.** The plate is rendered once, from a fixed scene and a fixed seed (the treatment's
121
+ `seed`, else a hash of the request and idea, modulo 2^31, so the same treatment gives the same noise).
122
+ Every round, replay and look pass reuses it. A look round that changes only the page, its type or its
123
+ 2D layers never re-renders the plate; one that changes `scene.py` renders it again and says so.
124
+
125
+ **Finding Blender.** `findBlender()` tries `LITCODEX_BLENDER` (used only when that file exists), the
126
+ macOS app (`/Applications/Blender.app/Contents/MacOS/Blender`), then `blender` on PATH. It is never
127
+ assumed. It runs `blender -b --factory-startup -P engine/blender/runner.py -- ...` on Metal when the
128
+ build has it, another GPU backend next and the CPU last; the receipt names which.
129
+
130
+ 1. Set `depth: "3d"`, a `depth3d` subject device and `render3d: "blender"`.
131
+ 2. Write `stage/scene.py`, a Blender Python scene. It runs inside the bundled runner with `bpy`, `math`,
132
+ `Vector` and `lit` in scope; times are film seconds and the plate starts at frame 1:
133
+ `lit.camera(location, target, lens, dof=(distance, fstop))`, `lit.area_light(name, location, target,
134
+ power, size, color)`, `lit.world(color, strength)`, `lit.material(name, color, roughness, metallic,
135
+ emission, strength)`, `lit.rounded_box(name, size, radius, segments, material, location)`,
136
+ `lit.image_card(name, path, width, location)` (a fetched product image as a card) and
137
+ `lit.key(obj, prop, t, value)`. The scene must set a camera. The command line sets size, samples,
138
+ device, fps and frames; the scene sets everything else.
139
+ 3. `node "$R" blender --out <dir>` (or `--preview`) renders preview stills at the beat midpoints (50 %
140
+ size, 40 samples) into `stage/plate-preview/`. Open them, compare them with any reference frames
141
+ the user gave, and fix `scene.py` before the final.
142
+ 4. `node "$R" blender --out <dir> --final` renders the plate (full size, 160 samples, motion blur, 30
143
+ fps) into `stage/plate/000001.png ...` and writes `plate.json`, which lists every frame by name and
144
+ size with the Blender version, device and samples. Run it as a background command and read its
145
+ progress; it can take most of an hour. `--preview` and `--final` together are a usage error.
146
+ 5. On the page, `const show = LitStage.plate({ parent, count, fps: 30 })` returns `show(t)`, which
147
+ swaps one `<img>` per frame (`floor(t * 30)` of the 1-based, six-digit names) and waits for its
148
+ decode; call it from `render(t)`. Plate frames listed in `plate.json` are not counted as page
149
+ rasters; any other frame sequence in `stage/` is still a flipbook and fails the scan (exit 17).
150
+ 6. The round's rung is `software` under a plate: the page needs only DOM raster, and the plate is
151
+ already pixels. The stage refuses to start (exit 17) when `plate.json` is missing or does not match
152
+ its frames, and the manifest and report name the plate (Blender version, Cycles device, samples).
153
+
154
+ **No Blender.** The command renders nothing and prints `FALLBACK`; it exits 0. Set `render3d` to
155
+ `three`, build the world in three.js on the GPU rung, and say in the reply that the Blender rung was
156
+ skipped and why.
@@ -0,0 +1,22 @@
1
+ # Choose the design first
2
+
3
+ The user has the right to choose the look. Before `treatment.json`, ask once, with the rules' pick first as `(Recommended)`:
4
+
5
+ 1. `Path`: the type path (the words are the film; 16:9 only) or stage (the film shows things). A README or banner loop is a cover and asks nothing.
6
+ 2. `Style`: `swiss-signal`, `tidal`, `terminalcore` or `paper` (stage only), by the rules in `references/studio.md`, Choosing the style. When the user wants to see them first, run `node "$R" styles --out <dir>` and show `styles.png`.
7
+ 3. `Register`: rich (the default: layered world, moving camera, authored score) or minimal (calm, one hero, preset bed).
8
+ 4. `Format`: 16:9 or 9:16.
9
+
10
+ Put the answers into the treatment through the request: the validator derives style, register and format from `treatment.request`, so append each answer in the user's words (`<request> Style: tidal. Calm. Vertical.`) and write the matching `style`, `register` and `format`. `typePlan.presetSource` is `user` only for a style the user picked. A 3D subject takes the stage path with `depth: "3d"` (`references/depth.md`). Cover mode asks nothing.
11
+
12
+ ## How to ask
13
+
14
+ Ask with `request_user_input` when this turn offers it (Plan mode): 2–4 options per question, the recommended one first and labelled `(Recommended)`, a one-line description each; the tool takes a free-text answer on its own, so no Other option is written.
15
+
16
+ When it is not offered (Default mode), put the same question in the reply as a short numbered list with the recommended option first as `1. … (Recommended)`, and end the turn to wait for the pick; build nothing before it arrives.
17
+
18
+ In a non-interactive `codex exec` run nobody can answer: take the recommended option, say so in one line ("Non-interactive run: building the stage path at 16:9, the recommended options") and continue.
19
+
20
+ ## When to skip
21
+
22
+ Skip a question only when the prompt already names its answer (a style, calm or minimal, 9:16 or 16:9, a lyric or title-sequence video) or hands the choice over ("you choose", "just make it good", "알아서", "네가 골라"), or under a bare `lit`: take the recommended options and say so in the reply.
@@ -23,23 +23,29 @@ Rounds share one counter with renders, 1 to 3.
23
23
  { "q": 2, "verdict": "<yes or no>", "frame": "<stills file>", "observed": "<one sentence naming a concrete visible detail in that frame>" }
24
24
  ],
25
25
  "weakestBeat": "<beat number, round 1 only>",
26
- "change": "<what you changed, round 1 only>"
26
+ "change": "<what you changed, round 1 only>",
27
+ "defects": [
28
+ { "t": 2.5, "region": [100, 200, 300, 120], "frame": "<stills file>", "observed": "<what is visible there>", "cause": "<why>", "fix": "<what to change>" }
29
+ ]
27
30
  }
28
31
  ```
29
32
 
30
- Answer all nine questions, each with `verdict` (`yes` or `no`), the `frame` you judged it from (a file in the latest stills set; question 6 may cite `sound-cues.json`) and `observed`: at least one sentence naming something you actually saw in that frame. A bare yes or no is refused, and so is any frame that is not in the latest stills set. `look` stamps the round with the SHA-256 of the stills manifest and of every frame it lists.
33
+ Answer all nine questions, or all ten when the treatment carries a `story` (question 10 asks about its turn), each with `verdict` (`yes` or `no`), the `frame` you judged it from (a file in the latest stills set; question 6 may cite `sound-cues.json`) and `observed`: at least one sentence naming something you actually saw in that frame. A bare yes or no is refused, and so is any frame that is not in the latest stills set. `look` stamps the round with the SHA-256 of the stills manifest and of every frame it lists.
31
34
 
32
35
  1. "A stranger would say this film is for: <…>". Write that sentence in `observed`; `verdict` is `yes` when it matches the treatment's audience and idea.
33
36
  2. Does every beat show its `onScreen` plan?
34
- 3. Is the craft at the level `ambition` asks for: transitions, rhythm, depth, hierarchy?
37
+ 3. Is it rich enough? Put the contact sheet beside the user's reference frames (none given: a studio launch film of a product). Does each shot carry as much labelled detail, layered depth, camera movement and accent colour as they do, with one hero move leading it and the style's hand-offs between shots? A minimal film answers for its restraint instead.
35
38
  4. Is any request text, meta label, placeholder, file name or internal term on screen?
36
39
  5. Does the ending land?
37
- 6. Does the sound follow the cuts? Answer from `sound-cues.json`: each cue's `delta` against its cut.
40
+ 6. Does the sound follow the cuts and the events? Answer from `sound-cues.json` and the stills: each cue's `delta` against its cut, and each event cue's frame should show what its `on` says.
38
41
  7. Name one thing a skilled motion designer, given only the request, would have shown that this film does not. `verdict: yes` means you can name one; name it in `observed` and revise.
39
42
  8. Is any element on screen without a job in its beat?
40
43
  9. Could every copy line be pasted unchanged into a film about a different subject? If yes, rewrite the copy from `subject.specifics`.
44
+ 10. Only with a `story`: does the turn land? Answer it on the turn shot's own still, `stills/beat-NN.png` for `story.beat` (`look` refuses any other frame). Is `story.turn` visibly happening there, to the protagonist, as the film's largest change? A turn that only a caption announces is a `no`.
41
45
 
42
- A `no` on 1, 2, 3, 5 or 6, a `yes` on 4, 8 or 9, or a nameable answer to 7 requires another round. On this host you answer question 1 yourself (`by: self`); where a fresh subagent is available it may answer it from the contact sheet and the beat stills alone, and the round records `by: blind`.
46
+ `defects` is optional on a film round: at most three, worst first, each with the time `t` in seconds where it shows, the `region` `[x, y, w, h]` in frame pixels it covers, a `frame` of the latest stills set that shows it, what is `observed` there, its `cause` and its `fix`. A film fixes those seconds and renders again; a cover checks the fix with `cover --window`.
47
+
48
+ A `no` on 1, 2, 3, 5, 6 or 10, a `yes` on 4, 8 or 9, or a nameable answer to 7 requires another round. On this host you answer question 1 yourself (`by: self`); where a fresh subagent is available it may answer it from the contact sheet and the beat stills alone, and the round records `by: blind`.
43
49
 
44
50
  If no image tool is reachable at all, record `{ "blocked": "no-vision-tool" }` for the round. The done-check then reports `DONE_UNVIEWED`, and the reply must say in plain words that nobody viewed the frames.
45
51
 
@@ -106,12 +112,28 @@ On the **stage path**:
106
112
  | QA-TITLE-SAFE | Copy ink inside the central 90 % of the frame; decor exempt |
107
113
  | QA-READING | Each copy run stays on screen for its reading floor (measured at 10 fps, 0.1 s tolerance); decor exempt |
108
114
  | QA-COPY | Every `copy.lines` entry appears on screen (page text or registered canvas text); a missing line exits 17 |
109
- | QA-DECOR | A decor run never carries a copy line; decor is at most 25 % of the visible text |
115
+ | QA-DECOR | A decor run never carries a copy line; decor is at most 25 % of the visible text (60 % in a `rich` film, whose world fills with readouts and part labels) |
110
116
  | QA-META, QA-UNLISTED, QA-CANVAS, QA-STATE, QA-PRESENCE | WARNs the look must answer: meta labels on screen, text that is neither a copy line nor marked decor, unmeasured canvas text, samples discarded because something besides text moved, too little non-text detail |
111
117
  | QA-FONTS | Every sampled run renders in one of this product's faces (FAIL for copy, WARN for decor) |
118
+ | TEXT-OVERLAP | With a `style`: no two visible, non-decor text runs overlap by more than 8 % of the smaller one, at the QA samples and at every second frame within 0.4 s of each cut (an outgoing and an incoming line crossing). Pseudo-element text is not judged. FAIL |
119
+ | TEXT-ON-STYLE | With a `style`: settled copy uses the style's text colours (within 12 in RGB; a `rich` film may also use its accents), its first font family is one of the style's faces, and its size sits on a type-scale step of the format (within 4 %). Other text off the scale is a WARN |
120
+ | TEXT-ZONE | With a `style`: settled copy sits inside its shot's `layout` type zone for the format (1.2 % of the frame side of slack); a `full` shot has no copy zone, so copy in one fails |
121
+ | FLAT-FRAME | A run of frames whose 0.5 % to 99.5 % luminance spread is under 0.02, in any colour, longer than 1 s (the opening and the close get 1 s more). MO-D-03 sees only black; a cream frame with nothing on it is as empty. FAIL |
122
+ | DEAD-AIR | A run of frames where under 2.5 % of the 48 px cells carry anything (a cell is busy when its luma varies, sd above 6, or its mean sits more than 16 levels off the ground) longer than 0.5 s; the opening gets 0.4 s more, the close 0.6 s more. FAIL |
123
+ | RICH-FILL | With `register: "rich"`: at each beat midpoint at most 2 of the 12 regions (a 4 x 3 grid) may be empty (busy share under 0.15); one beat may miss, a second fails. A minimal film skips it |
112
124
  | SOUND-* | Stream present, length within 0.1 s of the video, peak at or under -0.5 dBFS, no silent opening on a generated bed |
113
125
 
114
- The text checks run in a separate replay Chrome: at each beat midpoint and two settled frames per beat it captures the frame, hides all text ink, captures again, and treats the difference as the ink mask. The master is never touched.
126
+ How to fix the empty-frame and style rules, without shortening the film:
127
+
128
+ | Rule | Fix |
129
+ | --- | --- |
130
+ | TEXT-OVERLAP | Finish the outgoing line before the incoming one starts, or move one to another zone; a cross-fade of two lines in one place fails. Decor text may sit under copy. |
131
+ | TEXT-ON-STYLE | Take colour, face and size from `/lit/style.css` (`.lit-display`, `.lit-headline`, `.lit-body`, `.lit-label`, and the `.lit-ink`, `.lit-muted` colour classes) instead of writing them by hand. |
132
+ | TEXT-ZONE | Place copy inside the shot's zone (`LitStyle.zones[layout].type`), or change the shot's `layout` to one whose zone holds it. |
133
+ | FLAT-FRAME, DEAD-AIR | Give the held seconds a living subject: a drifting layer, a counter, the hero object, a slow camera move. A near-empty beat that must stay quiet is a `minimal` film's job. |
134
+ | RICH-FILL | Fill the empty regions of the named beat with the world's parts: labelled panels, a log, counters, the product's own screens. If the film should breathe, set `register: "minimal"` honestly instead. |
135
+
136
+ The text checks run in a separate replay Chrome: at each beat midpoint and two settled frames per beat it captures the frame, hides all text ink, captures again, and treats the difference as the ink mask. With a `style` it also takes every second frame within 0.4 s of each cut (keeping only each run's ink count). The master is never touched. A stills-only board round runs the same text check on the beat midpoints and the cut frames alone (`boardQA`), and reports TEXT-OVERLAP, TEXT-ON-STYLE and TEXT-ZONE per shot before anything is encoded.
115
137
 
116
138
  On the **type path** the Wave 1 rules apply unchanged (MO-C-01 to MO-C-29, MO-D-02 to MO-D-04 and the Section A/B rows), with MO-C-12 as amended (the film meets the treatment's length; a WARN says so when the reading floors force it longer) and the SOUND rules added.
117
139
 
@@ -31,7 +31,7 @@ The render commands themselves (`stage`, `cover`, `cover-gate`, `film`, `sound`,
31
31
 
32
32
  ## Chrome launch ladder
33
33
 
34
- The **stage path** launches one rung only: the software rung (SwiftShader, CPU raster) with the anti-throttling and keychain flags, plus `--run-all-compositor-stages-before-draw`, `--disable-checker-imaging`, `--disable-new-content-rendering-timeout`, `--disable-threaded-animation`, `--disable-threaded-scrolling`, `--disable-image-animation-resync`, `--disable-lcd-text`, `--force-color-profile=srgb`, `--hide-scrollbars`, `--mute-audio`, `--force-device-scale-factor=1`, `--window-size=<w>,<h>`, `--disable-background-networking`, `--disable-component-update`, `--disable-sync`, `--no-pings`, `--metrics-recording-only` and `--host-resolver-rules="MAP * ~NOTFOUND , EXCLUDE lit.stage"`. The page is served on the synthetic origin `http://lit.stage/` through Playwright request routing with service workers blocked, so nothing listens on a port; a refused `listen` never blocks the stage path. The master, the determinism replay and the text QA replay each get their own Chrome and profile under `.run/`. A **cover** render launches the same rung at device scale 2 (`--force-device-scale-factor=2`) with `--disable-gpu-rasterization` and `--disable-partial-raster`, because glyph edges rastered in GPU tiles came out one level apart between fresh browsers at 2x; the master, the replay and the seek-order pass each get their own Chrome under `.run/cover/`.
34
+ The **stage path** launches one rung per round, the same for the master and every replay: the software rung (SwiftShader, CPU raster) by default, or, for a 3D film that draws with three.js (`depth: "3d"`, `render3d: "three"`) and a `hero-3d` cover, the platform GPU rung for WebGL only, with page raster still on the CPU (`--disable-gpu-rasterization --disable-partial-raster` in place of `--enable-gpu-rasterization`). A GPU rung that does not start, gives no WebGL2 or gives a software renderer falls back to the software rung with a notice in the report and the manifest (`references/depth.md`). A Blender film's page runs on the software rung. Every rung carries the anti-throttling and keychain flags, plus `--run-all-compositor-stages-before-draw`, `--disable-checker-imaging`, `--disable-new-content-rendering-timeout`, `--disable-threaded-animation`, `--disable-threaded-scrolling`, `--disable-image-animation-resync`, `--disable-lcd-text`, `--force-color-profile=srgb`, `--hide-scrollbars`, `--mute-audio`, `--force-device-scale-factor=1`, `--window-size=<w>,<h>`, `--disable-background-networking`, `--disable-component-update`, `--disable-sync`, `--no-pings`, `--metrics-recording-only` and `--host-resolver-rules="MAP * ~NOTFOUND , EXCLUDE lit.stage"`. The page is served on the synthetic origin `http://lit.stage/` through Playwright request routing with service workers blocked, so nothing listens on a port; a refused `listen` never blocks the stage path. The master, the determinism replay and the text QA replay each get their own Chrome and profile under `.run/`. A **cover** render launches the same rung at device scale 2 (`--force-device-scale-factor=2`) with `--disable-gpu-rasterization` and `--disable-partial-raster`, because glyph edges rastered in GPU tiles came out one level apart between fresh browsers at 2x; the master, the replay and the seek-order pass each get their own Chrome under `.run/cover/`.
35
35
 
36
36
  On the **type path** the renderer drives Chrome over the pipe transport, so no control port listens. It tries, in order, the platform GPU rung (`--use-angle=metal --enable-gpu-rasterization --ignore-gpu-blocklist` on macOS, `--use-angle=gl ...` on Linux, `--use-angle=d3d11 --enable-gpu-rasterization` on Windows) and then the software rung (`--use-angle=swiftshader --enable-unsafe-swiftshader`), always with the three anti-throttling flags. A rung counts only when `getContext('webgl2')` and a half-float render target succeed in the page, re-checked at every render launch. The winning flags are recorded as `chromeFlags`. The Chrome profile lives in a short unique directory under the run's own `.run/` and is removed on exit. No extra flags such as `--no-sandbox` are ever added.
37
37