@litfamily/litgravity 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (251) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/README.md +19 -3
  3. package/README_ko-KR.md +19 -3
  4. package/TRADEMARK.md +12 -0
  5. package/package.json +3 -2
  6. package/plugin/hooks/lib/lanes.mjs +65 -0
  7. package/plugin/hooks/lib/liveness.mjs +81 -0
  8. package/plugin/hooks/lib/motion.mjs +34 -5
  9. package/plugin/hooks/lib/reentry.mjs +7 -0
  10. package/plugin/hooks/lib/rewind/brief.mjs +364 -0
  11. package/plugin/hooks/lib/rewind/collect.mjs +359 -0
  12. package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
  13. package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
  14. package/plugin/hooks/lib/rewind/redact.mjs +60 -0
  15. package/plugin/hooks/lib/rewind/transcripts.mjs +214 -0
  16. package/plugin/hooks/lib/routes.mjs +79 -5
  17. package/plugin/hooks/lib/workflow-stack.mjs +213 -0
  18. package/plugin/hooks/post-tool-use.mjs +39 -1
  19. package/plugin/hooks/pre-invocation.mjs +93 -2
  20. package/plugin/hooks/session-start.mjs +26 -3
  21. package/plugin/hooks/stop.mjs +55 -6
  22. package/plugin/hud/looks.mjs +29 -0
  23. package/plugin/hud/render.mjs +277 -12
  24. package/plugin/plugin.json +1 -1
  25. package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
  26. package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
  27. package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
  28. package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
  29. package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
  30. package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
  31. package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
  32. package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
  33. package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
  34. package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
  35. package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
  36. package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
  37. package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
  38. package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
  39. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
  40. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
  41. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
  42. package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
  43. package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
  44. package/plugin/skills/lit-adhd/SKILL.md +160 -0
  45. package/plugin/skills/lit-adhd/references/card-examples.md +107 -0
  46. package/plugin/skills/lit-adhd/references/status-taxonomy.md +34 -0
  47. package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
  48. package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
  49. package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
  50. package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
  51. package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
  52. package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
  53. package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
  54. package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
  55. package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
  56. package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
  57. package/plugin/skills/lit-docx/SKILL.md +3 -3
  58. package/plugin/skills/lit-handoff/SKILL.md +1 -0
  59. package/plugin/skills/lit-hijack/SKILL.md +263 -0
  60. package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
  61. package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
  62. package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
  63. package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
  64. package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
  65. package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
  66. package/plugin/skills/lit-plan/SKILL.md +3 -2
  67. package/plugin/skills/lit-plan/references/plan-contract.md +12 -1
  68. package/plugin/skills/lit-plan/scripts/check-plan.mjs +39 -3
  69. package/plugin/skills/lit-plan/templates/plan.md +3 -0
  70. package/plugin/skills/lit-pptx/SKILL.md +8 -8
  71. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
  72. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
  73. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
  74. package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
  75. package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
  76. package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
  77. package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
  78. package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
  79. package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
  80. package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
  81. package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
  82. package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
  83. package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
  84. package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
  85. package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
  86. package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
  87. package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
  88. package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
  89. package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
  90. package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
  91. package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
  92. package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
  93. package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
  94. package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
  95. package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
  96. package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
  97. package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
  98. package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
  99. package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
  100. package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
  101. package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
  102. package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
  103. package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
  104. package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
  105. package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
  106. package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
  107. package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
  108. package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
  109. package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
  110. package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
  111. package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
  112. package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
  113. package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
  114. package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
  115. package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
  116. package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
  117. package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
  118. package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
  119. package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
  120. package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
  121. package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
  122. package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
  123. package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
  124. package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
  125. package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
  126. package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
  127. package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
  128. package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
  129. package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
  130. package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
  131. package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
  132. package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
  133. package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
  134. package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
  135. package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
  136. package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
  137. package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
  138. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
  139. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
  140. package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
  141. package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
  142. package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
  143. package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
  144. package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
  145. package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
  146. package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
  147. package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
  148. package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
  149. package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
  150. package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
  151. package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
  152. package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
  153. package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
  154. package/plugin/skills/lit-schematic/SKILL.md +114 -0
  155. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
  156. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
  157. package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
  158. package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
  159. package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
  160. package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
  161. package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
  162. package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
  163. package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
  164. package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
  165. package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
  166. package/plugin/skills/lit-schematic/references/verification.md +100 -0
  167. package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
  168. package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
  169. package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
  170. package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
  171. package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
  172. package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
  173. package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
  174. package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
  175. package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
  176. package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
  177. package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
  178. package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
  179. package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
  180. package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
  181. package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
  182. package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
  183. package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
  184. package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
  185. package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
  186. package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
  187. package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
  188. package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
  189. package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
  190. package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
  191. package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
  192. package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
  193. package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
  194. package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
  195. package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
  196. package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
  197. package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
  198. package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
  199. package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
  200. package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
  201. package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
  202. package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
  203. package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
  204. package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
  205. package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
  206. package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
  207. package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
  208. package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
  209. package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
  210. package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
  211. package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
  212. package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
  213. package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
  214. package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
  215. package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
  216. package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
  217. package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
  218. package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
  219. package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
  220. package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
  221. package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
  222. package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
  223. package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
  224. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
  225. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
  226. package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
  227. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
  228. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
  229. package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
  230. package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
  231. package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
  232. package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
  233. package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
  234. package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
  235. package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
  236. package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
  237. package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
  238. package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
  239. package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
  240. package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
  241. package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
  242. package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
  243. package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
  244. package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
  245. package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
  246. package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
  247. package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
  248. package/plugin/skills/litresearch/SKILL.md +1 -0
  249. package/plugin/skills/readme-studio/SKILL.md +2 -0
  250. package/plugin/skills/review-work/SKILL.md +1 -1
  251. package/plugin/skills/start-work/SKILL.md +2 -2
@@ -1,157 +1,131 @@
1
- # Anti-slop checklist
1
+ # Anti-Slop Checklist for PPTX Outputs
2
2
 
3
- A deck reads as machine-made when it carries the same reflexes a hundred other decks carry: a stripe
4
- down the card edge, a row of identical tiles, a hero number with no source, a title that is a verdict.
5
- This checklist turns those reflexes into checks. Part A says what the gate measures and with which
6
- threshold, part B lists the laws judged by eye on the rendered pages, part C gives the copy rules.
7
- Run the gate first, then read every rendered page, because a passing gate means no known defect and
8
- says nothing about how the deck reads.
3
+ Run after building any deck. Palette, faces, radius and decoration come from the chosen tonality pack (or the named legacy template); this checklist holds for all of them.
9
4
 
10
- ```sh
11
- python3 "$SKILL_ROOT/scripts/qa_deck.py" out.pptx # exit 0 is required
12
- python3 "$SKILL_ROOT/scripts/qa_deck.py" out.pptx --sibling other.pptx # OF-116, two tonalities of one source
13
- python3 "$SKILL_ROOT/scripts/layout_inventory.py" out.pptx --issues-only
14
- python3 "$SKILL_ROOT/scripts/render_pages.py" out.pptx --out-dir renders --pages 8
15
- ```
5
+ ## Automated checks
6
+ - `python3 "$SKILL_ROOT/scripts/qa_deck.py" output.pptx` — honest gate: overflow/overlap/off-slide + WCAG contrast + anti-slop terms + objective executive/research OOXML checks (exit non-zero = FAIL).
7
+ - `python3 "$SKILL_ROOT/scripts/layout_inventory.py" output.pptx --issues-only` — geometry issues only.
8
+ - A clean gate means **no known defects, not that the deck looks good** — render and eyeball every slide (next section).
16
9
 
17
- The report is JSON. `failure_reasons` lists what fails the gate; `craft_floor.advisories` lists the
18
- MEDIUM findings, which are reported and do not fail; `anti_slop.review_warnings` lists soft terms.
10
+ ## Human-eye checks
19
11
 
20
- ## A. What the gate measures
12
+ ### Slide-level
13
+ - Every slide has a real, specific title (not placeholder text).
14
+ - Accent colors are semantic, not decorative.
15
+ - No slide looks like a spreadsheet pasted without editing.
21
16
 
22
- ### A1. Stages and what fails each
17
+ ### Table-level
18
+ - Header row visually distinct; numeric columns right-aligned.
19
+ - Units in headers, not repeated per row; totals obvious but not over-decorated.
23
20
 
24
- | Stage | Source | Fails when |
25
- |---|---|---|
26
- | package integrity | `ooxml_integrity.py` | the package does not open, a relationship is dangling, an attribute holds NaN |
27
- | text hygiene | `validate_pptx.py` | a hard forbidden term, an unfilled default placeholder, a Calibri or Aptos run, a slide with no title; slop score above 10 |
28
- | layout | `layout_inventory.py` | text spills out of its frame, runs past the canvas, or a box leaves the slide |
29
- | contrast | `qa_deck.py` | an explicit-colour run is under 4.5:1 on its real fill, or under 3:1 when it is large (18 pt, or bold from 14 pt) |
30
- | overlap | `qa_deck.py` | a picture or table is drawn over other content, or two text frames collide by more than 0.06 in on both axes |
31
- | objective quality | `qa_deck.py` | a side stripe, a run under 6 pt, a covered figure or table, a figure without caption and source, an appendix link without a hyperlink |
32
- | deck craft | `deck_craft.py` | `sparse_slide`, `table_only_deck`, `off_slide_shape`, `stray_box`, `placeholder_text`, `long_foreign_note` |
33
- | craft floor | `craft_extras.py` | any HIGH finding among OF-101 to OF-119 |
34
-
35
- ### A2. Deck craft
36
-
37
- | Id | Threshold | Fix |
38
- |---|---|---|
39
- | `sparse_slide` | content fills under 45 % of the area below the title | a chart, a figure row or a fuller table with its takeaway; or merge with a neighbour |
40
- | `table_only_deck` | three or more content slides, at least two tables, tables on 60 % or more, no chart | draw a numeric series as `::: chart` |
41
- | `off_slide_shape` | a shape runs 0.03 in past the canvas and is not a full-canvas ground | pull it inside |
42
- | `stray_box` | an outlined rectangle of 1 sq in or more, no fill, nothing inside | delete it or put the message in a tinted callout |
43
- | `placeholder_text` | `[제품명]`, `XXX`, `TBD`, `TODO`, `○○`, `{{...}}`, `____` | fill with a real value labelled as an example |
44
- | `long_foreign_note` | on a Korean deck, a source line of 60 Latin letters or more | write sources short and in Korean (agency, document, year) |
45
-
46
- A bracket that holds a digit (`[1]`, `[S3]`) is a citation marker, and a Markdown link is read for its
47
- label only.
48
-
49
- ### A3. The craft floor, OF-101 to OF-119
50
-
51
- HIGH findings fail the gate; MEDIUM findings are advisories.
52
-
53
- | Id | Rule | Threshold | Fix |
54
- |---|---|---|---|
55
- | OF-101 | one accent hue family per slide | solid fills clustered in 20-degree hue families; content slide: 2 is MEDIUM, 3 is HIGH; display slide: 3 and 4 | move the extra fills to neutrals |
56
- | OF-102 | body measure | wrapped lines over 90 characters (38 when half the letters are Hangul) are HIGH; under 10 characters across 3 lines or more is MEDIUM | narrow the box or split the text; widen a column |
57
- | OF-103 | numeric table columns right-aligned | 70 % numeric cells over 2 rows or more; an explicit left or centre is HIGH, an inherited alignment MEDIUM | align the cells to the right |
58
- | OF-104 | concentric radius | inner radius equals outer radius minus the frame's padding, within 0.02 in | set the inner radius from the outer one |
59
- | OF-105 | gap between cards at least twice the gap inside a card | MEDIUM until its calibration promotes it | space the cards apart or tighten the contents |
60
- | OF-106 | no gradient-filled text | any gradient run fill | solid colour; emphasise with weight or size |
61
- | OF-107 | no glow | any glow effect | solid fill or a thin neutral shadow |
62
- | OF-108 | no emoji bullet | an emoji `buChar` | the template's bullet |
63
- | OF-109 | no tall empty band | a slide or a card with one empty band over 35 % is HIGH, 25 % to 35 % MEDIUM; cards in one row count the smallest trailing band | fill the band, shrink the region, merge slides |
64
- | OF-110 | title variety, each treatment drawn as named | a deck of 8 slides or more needs 3 treatments and no more than the variance allows (variance 1-3: 2, 4: 3, 5-6: 4, 7 and up: 5); a title that matches none of the eight is HIGH | map slide jobs to treatments (`title-treatments.md`) |
65
- | OF-111 | composition variety | on content slides no title zone x partition x dominant content above 40 %, and at least ceil(0.6 x content slides) distinct ones, capped at 5 | change the family on repeated slides |
66
- | OF-112 | the body is used | per slide against the density cap (0.28, 0.24, 0.20, 0.16, 0.12 for density 1-2, 3-4, 5-6, 7-8, 9-10) as MEDIUM; the deck median over 0.20 is HIGH | `density-and-fill.md` |
67
- | OF-113 | one frame per treatment | titles under one treatment differ by 1 pt or less (a bottom title by its bottom edge) | fix the source and leave the title where the treatment puts it |
68
- | OF-114 | titles are labels | Korean last word with a sentence ending, English final period or finite verb | name the topic; the claim opens the body |
69
- | OF-115 | no region left empty | a bottom title ends 12 pt or more above the floor; a side rail or a takeaway column over 40 % empty; a title panel or a plate with an empty page | close the column with takeaways, source or values |
70
- | OF-116 | with `--sibling`, another tonality draws another skeleton | at least 2 of the content slides differ in title zone or partition (1 when the deck has fewer than 4) | give the alternative its own structure |
71
- | OF-117 | no light figure on a dark ground | a picture over 50 % near-white on a ground of luminance 0.25 or less | a `.dark` copy beside the file, or a native chart |
72
- | OF-118 | a bold run-in label keeps its separator | `**요약** text` with no colon, dash or closing mark | write `**요약:**`; the engine adds the colon in body bullets |
73
- | OF-119 | an agenda title carries no numeral | `agenda` drawn under `kicker-numeral` | let the rows carry the numbers |
74
-
75
- On a legacy template OF-110, OF-111 and the OF-112 median report at MEDIUM and OF-114 reports at MEDIUM:
76
- naming that template asked for its single look. OF-109 still stops a hollow slide.
77
-
78
- ### A4. Objective evidence checks
79
-
80
- | Check | Rule |
81
- |---|---|
82
- | text size floor | every explicit run is 6 pt or larger; the ramps keep body at 13-14 pt, labels and table cells at 11-12, sources at 9-10 (compact and reading steps) |
83
- | side stripe | a narrow filled bar (0.15 in wide or less, 70 % of the card's height or more) on a card's vertical edge fails; a full-width structural rule does not |
84
- | figure and table occlusion | no content shape drawn above a declared figure or any table by 0.08 sq in or more and 3 % of its area or more |
85
- | evidence binding | a picture whose description reads `Figure`, `Evidence`, `Source capture`, `그림`, `도표`, `근거` needs a nearby caption with a number and a `Source:` or `출처:` |
86
- | appendix links | on a slide that says Appendix or 부록, every DOI, canonical-link or raw URL field carries a real external hyperlink; write `[원문](https://...)` in the cell |
87
- | default fonts | Calibri and Aptos runs raise the slop score by 15; the packs set Pretendard or A2Z |
88
- | distinct fills | more than 8 distinct solid fills raise the slop score by 10 |
89
-
90
- ## B. Laws judged by eye
91
-
92
- These hold in every tonality. Where a law depends on the direction (radius, display size, decoration),
93
- the tonality pack sets the value and the law says where to look. The pack loader itself refuses a
94
- pack whose text pairs fall under 4.5:1, whose series colours fall under 3:1 on the ground, whose
95
- radius is not 0 or 6, or that mixes more than two font families.
96
-
97
- ### Surfaces and marks
98
- - [ ] Mark an item with a hairline above it, a flat tint or a real numeral. A coloured stripe down one
99
- card edge is the reflex this checklist exists to remove (A4).
100
- - [ ] One surface carries one edge: an outline or a soft shadow. An outlined box with nothing inside is
101
- clutter (`stray_box`).
102
- - [ ] Corners follow the pack (`radius` 0 or 6) on every surface; a fully rounded shape is a small tag.
21
+ ### KPI / metrics
22
+ - Primary metric is the largest element; delta color is consistent deck-wide; labels are secondary. ≤ 1 accent + optional delta color.
23
+
24
+ ### Text hygiene
25
+ - No `TBD`/`TODO`/placeholder/AI-hype wording (gated by `scripts/forbidden-terms.json`).
26
+ - Source notes exist for external numbers/charts. Headers are specific (avoid bare "Value"/"Metric"/"Score").
27
+
28
+ ### Executive/research copy: hard fail vs review-only
29
+
30
+ - **Hard fail:** authoring/process trace (`본 슬라이드는…`, `슬라이드 7은…`, `최종본에서 걸러냈다`) and unresolved placeholders (`[자사 확인 필요]`, `[출처 확인 필요]`, `[작성 중]`).
31
+ - **Review-only:** unsupported absolutes (`논문이 없다`, `없다는 것이 발견`), empty rhetoric (`판이 굳었다`, `전제로 깐다`), command-like planning (`닫아야 할 게이트`, `역전 금지`), unexplained RAM/FTO/CNKI/코퍼스/전이원, and arbitrary dates or day counts without an approved source.
32
+ - Review-only findings must be recorded and rewritten where warranted, but they do not become brittle automated failures. Prefer “검토한 데이터베이스 범위에서는 확인되지 않았다” and expand specialist terms on first use.
33
+
34
+ ## Visual design laws
35
+
36
+ These are judged by eye on the rendered pages, after the automated checks pass. They hold for every
37
+ tonality; where a law depends on the direction (radius, display size, which decoration is allowed),
38
+ the tonality pack sets the value and the law says where to look.
39
+
40
+ ### Bans that hold in every direction
41
+ - [ ] A coloured stripe down one edge of a card is never an accent. Mark the item with a hairline
42
+ above it, a flat tint, or a real numeral beside it instead.
43
+ - [ ] One surface gets one edge: an outline or a soft shadow, never both. An outlined box with
44
+ nothing in it is clutter, not structure. The one exception is a pack that draws a hard offset
45
+ shadow (`shadow:` in the pack, Neo-Brutalism): every surface there takes the border and the
46
+ shadow together, with no blur, and no other shadow appears in the deck.
47
+ - [ ] Corners follow the pack (`radius` 0 or 6) on every surface of the deck; fully rounded shapes
48
+ are for small tags only.
103
49
  - [ ] A row of identical cards is a filler pattern. Vary the span, let one element lead, or set the
104
50
  points as a list or a comparison.
105
- - [ ] Ordinals (`01 02 03`) and small labels above titles appear where the order is real.
106
- - [ ] A large number is the slide's evidence, with label, unit, basis and source.
107
- - [ ] Group with space and hairlines. A card inside a card, or a card around everything, adds a layer
108
- with no information.
109
- - [ ] Grounds are flat. Gradients, blobs, glows, mesh and noise come from nowhere on a tonality deck.
110
-
111
- ### Colour
112
- - [ ] Body text and captions reach 4.5:1 on the fill they sit on; large text and structural lines
113
- reach 3:1.
114
- - [ ] Grey text sits on the ground or surface; on a coloured fill use that fill's `on-field` or
115
- `accent-deep` role.
116
- - [ ] Deltas carry a sign and an arrow (`▲ +12%`, `▼ −8%`) beside their colour.
117
- - [ ] The accent covers about a tenth of a content slide and means one thing across the deck. Every
118
- colour is a pack role.
51
+ - [ ] Ordinals (`01 · 02 · 03`) and small labels above titles appear only where the order is real.
52
+ - [ ] A large number appears only when it is the slide's evidence, sourced and labelled.
53
+ - [ ] No card inside a card and no card around everything; group with space and hairlines.
54
+ - [ ] Flat grounds only: no gradients, blobs, glows, mesh or noise textures, no hand-drawn marks.
55
+ Bands, rails and colour fields come from the pack's decoration list, plus any kinds the deck adds
56
+ from the shared set with `decoration:` in its front matter.
57
+
58
+ ### Colour inside the pack
59
+ - [ ] Body text and captions reach 4.5:1 on the fill they actually sit on; large text and structural
60
+ lines reach 3:1 (`qa_deck.py` measures the pairs).
61
+ - [ ] Grey text never sits on a coloured fill; use the fill's own `on-field` or `accent-deep` role.
62
+ A colour never carries meaning alone: deltas also carry ▲/▼ and a sign.
63
+ - [ ] Each accent hue means one thing across the deck; a slide carries at most four accent hue
64
+ families (OF-101 fails at five). Every colour comes from the pack's roles; no one-off hex per slide.
119
65
 
120
66
  ### Type
121
- - [ ] Pretendard Regular and Bold by default; A2Z when the user or source asks (`faces: a2z`), with at
122
- most three faces from two families.
123
- - [ ] One ramp per deck (presented, reading or compact), at most four sizes on a slide, and no two sizes
124
- within a few points of each other.
125
- - [ ] A figure is set at title size at most (no hero step) with its label, unit, basis and source.
126
- - [ ] Titles are topic labels (OF-114). Headings run at line height 1.1 to 1.15 and body at 1.3 to 1.4.
127
- - [ ] A title wraps on a 어절 boundary; the last line holds more than one word.
67
+ - [ ] Pretendard Regular and Bold by default; A2Z only when the user or the source asks
68
+ (`faces: a2z`), then at most three faces from two families, A2Z weights chosen by family name.
69
+ - [ ] One ramp per deck (presented or reading), at most four sizes on a slide, no near-equal pairs.
70
+ Cover, section and statement titles take the hero step when they fit (`hero: false` turns it off);
71
+ a figure is set at title size at most, with its label, unit, basis and source.
72
+ - [ ] Titles and subtitles are topic labels, never declarative sentences (OF-114); the claim opens
73
+ the body.
74
+ - [ ] Headings at 1.1-1.2 line height, body at 1.3-1.45 (Korean at the loose end).
75
+ - [ ] No single word alone on a title's last line; break by hand at a 어절 boundary.
128
76
 
129
77
  ### Layout and hierarchy
130
- - [ ] At a squint the slide shows one primary element and its groups, about twice the next level.
131
- - [ ] Groups hold at most four items. Gaps come from one scale (6, 12, 18, 24, 36, 48, 72 pt), tighter
132
- inside a group than between groups, with one alignment edge per region.
133
- - [ ] Every line, box and field carries information or structure.
134
- - [ ] The title treatment matches the slide's job, and each treatment keeps one frame.
135
- - [ ] The body reaches toward the floor on content slides.
136
-
137
- ## C. Copy
138
-
139
- - [ ] Every slide has a specific title; a slide that offers only "개요" or "Overview" gets a subject.
140
- - [ ] Headers name what they hold; "Value", "Metric" and "Score" alone are unspecific.
141
- - [ ] External numbers and charts carry a source line (`출처:` or `Source:`) as the last block.
142
- - [ ] A table header row is visually distinct, units sit in headers, totals are bold without extra
143
- decoration.
144
- - [ ] A KPI row has one primary metric; the delta colour is the same across the deck.
145
-
146
- **Hard terms** (fail through `scripts/forbidden-terms.json`): `click to add title|subtitle|text`,
147
- `content goes here`, `your logo`, `placeholder`, `lorem ipsum`, `tbd`, `fixme`, `todo`, and the process
148
- traces `본 슬라이드는`, `슬라이드 7은`, `최종본에서 걸러냈다`, `[자사 확인 필요]`, `[출처 확인 필요]`, `[작성 중]`.
149
-
150
- **Soft terms** (reported as review warnings, rewritten where the sentence earns it): `revolutionary`,
151
- `cutting-edge`, `seamless`, `innovative`, `world-class`, `best-in-class`, `transformative`,
152
- `next-generation`, `game-changing`, `state-of-the-art`, `AI-powered`, `unlock`, `empower`, `synergy`,
153
- `holistic`, `paradigm shift`, `frictionless`, and the Korean review items `없다는 것이 발견`,
154
- `판이 굳었다`, `전제로 깐다`, `닫아야 할 게이트`, `역전 금지`, `논문이 없다`, plus unexplained
155
- `RAM`, `FTO`, `CNKI`, `코퍼스`, `전이원`. Rewrite an absolute such as "논문이 없다" as the scope that
156
- was checked ("검토한 데이터베이스 범위에서는 확인되지 않았다"), expand a specialist term on first use,
157
- and give a date or a day count only from an approved source.
78
+ - [ ] At a squint each slide shows one primary element and its groups.
79
+ - [ ] One primary element per slide, about twice the next level; a long group splits into labelled
80
+ sub-groups rather than losing items.
81
+ - [ ] Gaps come from one scale (6, 12, 18, 24, 36, 48, 72 pt), smaller inside a group than between
82
+ groups; one alignment edge per region.
83
+ - [ ] Every line, box and field carries information or structure; anything else goes.
84
+ - [ ] The title treatment matches the slide's job, and every title sits in the slide grid's one
85
+ title zone whatever its treatment or tonality (`title-treatments.md`).
86
+ - [ ] The body reaches toward the floor on content slides (`density-and-fill.md`).
87
+
88
+ ### Craft-floor checks (enforced by `scripts/craft_extras.py` through `qa_deck.py`)
89
+
90
+ - [ ] OF-101: at most four accent hue families on a slide; five fail, with no advisory step below.
91
+ - [ ] OF-102: wrapped body lines stay at or under 90 characters (38 for Korean); a column under 10 characters over 3+ lines is advisory.
92
+ - [ ] OF-103: every numeric table column is right-aligned; an inherited alignment is advisory.
93
+ - [ ] OF-104: a symmetric nested frame keeps inner radius = outer radius minus padding.
94
+ - [ ] OF-105: the gap between cards is at least twice the smallest gap between two shapes inside a card (a shape's inset to its own card edge is padding and does not count). Advisory (MEDIUM) until the family's calibration re-run promotes it.
95
+ - [ ] OF-106 / OF-107 / OF-108: no gradient-filled text, no glow, no emoji bullets.
96
+ - [ ] OF-109: no single empty band over 35% of the content area or of a card (25 to 35% is advisory); in a row of equal-height cards the row counts its smallest trailing band. Fill it, shrink the region, or merge slides.
97
+ - [ ] OF-110: a deck of eight or more slides uses at least three title treatments and no more than its variance allows; every title is one of the eight treatments and is drawn as the treatment its name says.
98
+ - [ ] OF-111: content slides do not share one composition (title zone × body partition × dominant content) on more than 40 % of them, and show at least ceil(0.6 × content slides) distinct ones, capped at 5.
99
+ - [ ] OF-112: the median empty band under the body's last block stays at or under 0.20; a slide over its density cap is an advisory.
100
+ - [ ] OF-113: every content title sits on the slide grid's one title frame and every statement on the display frame, within 1 pt, whatever the treatment.
101
+ - [ ] OF-116 (with `--sibling`): the same source under another tonality puts each slide's title and body in the same places.
102
+ - [ ] OF-115: no region stands empty: a takeaway column that runs as long as the chart, table or picture beside it (its largest empty band, not its last block: a source strip at the foot does not hide the band above it, and a chart's values table under the takeaways belongs to the column), a picture drawn as tall as its column allows, a title panel as tall as its text, and no plate under an empty page.
103
+ - [ ] OF-116: run `qa_deck.py deck.pptx --sibling other.pptx` when two tonalities of one source are offered; their skeletons (title zone and partition per content slide) must differ on at least two content slides (one on a deck of fewer than four).
104
+ - [ ] OF-117: no mostly-white figure picture on a dark tonality; give it a `.dark` variant or draw it as a native chart.
105
+ - [ ] OF-118: a bold run-in label is followed by its separator ("**요약:** …"); the engine adds the colon when the source leaves it out, so a finding means the label was set by hand.
106
+ - [ ] OF-119: an agenda title stands without a numeral beside it; the agenda's rows carry the numbers.
107
+ - [ ] OF-120: a hard offset shadow (an outer shadow with no blur) appears only in a pack whose `qa:` block sets `offset-shadow: true`, and such a pack never mixes a soft shadow in.
108
+
109
+ ### Pack allowances (`qa:` in pack.yaml)
110
+
111
+ A direction may need one rule widened, and only through its own pack. The gate reads the `qa:`
112
+ block of the pack the deck stamp names; any other deck keeps the defaults. The registry refuses an
113
+ unknown key or a value out of range.
114
+
115
+ | Key | Range | Effect |
116
+ |---|---|---|
117
+ | `accent-families` | 5-6 | accent hue families a content slide may carry before OF-101 fails (default 4; the limit only widens) |
118
+ | `display-accent-families` | 5-6 | the same for cover, section, statement and closing slides (default 4) |
119
+ | `offset-shadow` | true | OF-120 passes the pack's hard shadow; needs `shadow:` in the pack |
120
+
121
+ Contrast floors, the body size floor and every other check stay as they are for every pack.
122
+ - [ ] On a legacy template OF-110, OF-111 and the OF-112 median are advisories, because the user asked for that template's single look.
123
+
124
+ ### Objective evidence checks
125
+
126
+ - [ ] No explicit run is below the absolute 6pt floor. Primary reading text remains ≥12pt; captions/sources may use 6–10.5pt.
127
+ - [ ] No colored vertical side-stripe is attached to a card. A full-width structural rule is not a side stripe.
128
+ - [ ] A picture or table is not materially covered by a later text/image/table object.
129
+ - [ ] A picture declared as `figure`, `evidence`, or `source capture` has a visible adjacent numbered caption and `Source:`/`출처:`.
130
+ - [ ] Every appendix DOI, canonical-link, or raw-URL field contains an actual external OOXML hyperlink relationship; detection does not depend on a special “link available” phrase.
131
+ - [ ] Thumbnail review still judges hierarchy, whitespace, chart intuitiveness, executive tone, and whether caption/source/interpretation read as one group.