@litfamily/litcodex 1.0.30 โ†’ 1.0.32

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 (394) hide show
  1. package/README-Ko-KR.md +13 -12
  2. package/README.md +13 -12
  3. package/TRADEMARK.md +12 -0
  4. package/dist/install/generated-skill-payload-hashes.d.ts +188 -82
  5. package/dist/install/generated-skill-payload-hashes.js +188 -82
  6. package/dist/install/skill-catalog.d.ts +1 -1
  7. package/dist/install/skill-catalog.js +12 -1
  8. package/dist/install/skill-resource-hashes.d.ts +1 -1
  9. package/dist/install/skill-resource-hashes.js +1 -1
  10. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  11. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  12. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  13. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  14. package/marketplace/plugins/litcodex/components/lit-loop/directive.md +10 -4
  15. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-adhd.md +194 -0
  16. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-handoff.md +2 -0
  17. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-hijack.md +219 -0
  18. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-plan.md +2 -1
  19. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-recap.md +2 -0
  20. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-schematic.md +199 -0
  21. package/marketplace/plugins/litcodex/components/lit-loop/directives/litwork.md +2 -1
  22. package/marketplace/plugins/litcodex/components/lit-loop/dist/adhd-suggest.d.ts +10 -0
  23. package/marketplace/plugins/litcodex/components/lit-loop/dist/adhd-suggest.js +67 -0
  24. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-html.d.ts +1 -1
  25. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-html.js +128 -8
  26. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-looks.d.ts +19 -0
  27. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-looks.js +58 -0
  28. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-status.d.ts +30 -0
  29. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-status.js +97 -7
  30. package/marketplace/plugins/litcodex/components/lit-loop/dist/cli.js +13 -3
  31. package/marketplace/plugins/litcodex/components/lit-loop/dist/codex-hook.d.ts +2 -0
  32. package/marketplace/plugins/litcodex/components/lit-loop/dist/codex-hook.js +8 -9
  33. package/marketplace/plugins/litcodex/components/lit-loop/dist/control-chars.d.ts +5 -0
  34. package/marketplace/plugins/litcodex/components/lit-loop/dist/control-chars.js +23 -0
  35. package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.d.ts +8 -0
  36. package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.js +126 -13
  37. package/marketplace/plugins/litcodex/components/lit-loop/dist/hud.d.ts +1 -1
  38. package/marketplace/plugins/litcodex/components/lit-loop/dist/hud.js +29 -13
  39. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-events.d.ts +13 -0
  40. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-events.js +85 -0
  41. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-state.d.ts +55 -0
  42. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-state.js +227 -0
  43. package/marketplace/plugins/litcodex/components/lit-loop/dist/live-step.d.ts +5 -1
  44. package/marketplace/plugins/litcodex/components/lit-loop/dist/live-step.js +17 -1
  45. package/marketplace/plugins/litcodex/components/lit-loop/dist/markers.d.ts +6 -0
  46. package/marketplace/plugins/litcodex/components/lit-loop/dist/markers.js +6 -0
  47. package/marketplace/plugins/litcodex/components/lit-loop/dist/modes.d.ts +1 -1
  48. package/marketplace/plugins/litcodex/components/lit-loop/dist/modes.js +25 -1
  49. package/marketplace/plugins/litcodex/components/lit-loop/dist/motion-gate.d.ts +79 -0
  50. package/marketplace/plugins/litcodex/components/lit-loop/dist/motion-gate.js +310 -0
  51. package/marketplace/plugins/litcodex/components/lit-loop/dist/motion-route.js +5 -1
  52. package/marketplace/plugins/litcodex/components/lit-loop/dist/plan-persistence.d.ts +1 -1
  53. package/marketplace/plugins/litcodex/components/lit-loop/dist/plan-persistence.js +38 -2
  54. package/marketplace/plugins/litcodex/components/lit-loop/dist/plan-scope-roots.d.ts +7 -0
  55. package/marketplace/plugins/litcodex/components/lit-loop/dist/plan-scope-roots.js +76 -0
  56. package/marketplace/plugins/litcodex/components/lit-loop/dist/redaction.js +18 -0
  57. package/marketplace/plugins/litcodex/components/lit-loop/dist/reentry.d.ts +15 -0
  58. package/marketplace/plugins/litcodex/components/lit-loop/dist/reentry.js +46 -9
  59. package/marketplace/plugins/litcodex/components/lit-loop/dist/restart-chip.d.ts +6 -0
  60. package/marketplace/plugins/litcodex/components/lit-loop/dist/restart-chip.js +59 -0
  61. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-cli.d.ts +10 -0
  62. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-cli.js +88 -0
  63. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-go.d.ts +20 -0
  64. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-go.js +94 -0
  65. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-look.d.ts +6 -0
  66. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-look.js +41 -0
  67. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-redact.d.ts +3 -0
  68. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-redact.js +40 -0
  69. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-rollout.d.ts +48 -0
  70. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-rollout.js +292 -0
  71. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind.d.ts +168 -0
  72. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind.js +867 -0
  73. package/marketplace/plugins/litcodex/components/lit-loop/dist/route-heads.js +45 -3
  74. package/marketplace/plugins/litcodex/components/lit-loop/dist/run-panel.js +1 -0
  75. package/marketplace/plugins/litcodex/components/lit-loop/dist/schematic-route.d.ts +6 -0
  76. package/marketplace/plugins/litcodex/components/lit-loop/dist/schematic-route.js +35 -0
  77. package/marketplace/plugins/litcodex/components/lit-loop/dist/screen-card.d.ts +3 -0
  78. package/marketplace/plugins/litcodex/components/lit-loop/dist/screen-card.js +15 -5
  79. package/marketplace/plugins/litcodex/components/lit-loop/dist/session-liveness.d.ts +16 -0
  80. package/marketplace/plugins/litcodex/components/lit-loop/dist/session-liveness.js +90 -0
  81. package/marketplace/plugins/litcodex/components/lit-loop/dist/skill-mention-scope.js +6 -0
  82. package/marketplace/plugins/litcodex/components/lit-loop/dist/stack-hook.d.ts +8 -0
  83. package/marketplace/plugins/litcodex/components/lit-loop/dist/stack-hook.js +57 -0
  84. package/marketplace/plugins/litcodex/components/lit-loop/dist/statusline.js +8 -3
  85. package/marketplace/plugins/litcodex/components/lit-loop/dist/threads.d.ts +50 -0
  86. package/marketplace/plugins/litcodex/components/lit-loop/dist/threads.js +183 -0
  87. package/marketplace/plugins/litcodex/components/lit-loop/dist/trigger.d.ts +1 -1
  88. package/marketplace/plugins/litcodex/components/lit-loop/dist/trigger.js +29 -5
  89. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-map.d.ts +10 -0
  90. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-map.js +11 -1
  91. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-stack.d.ts +139 -0
  92. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-stack.js +518 -0
  93. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  94. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  95. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  96. package/marketplace/plugins/litcodex/components/start-work-continuation/dist/codex-hook.d.ts +6 -0
  97. package/marketplace/plugins/litcodex/components/start-work-continuation/dist/codex-hook.js +65 -0
  98. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  99. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  100. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  101. package/marketplace/plugins/litcodex/hooks/hooks.json +24 -0
  102. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/SKILL.md +6 -0
  103. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/components.css +414 -0
  104. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/fonts.json +22 -0
  105. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
  106. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
  107. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
  108. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
  109. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
  110. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
  111. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
  112. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
  113. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/ui.js +228 -0
  114. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/brand-and-imagery.md +1 -1
  115. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/complete-contract.md +1 -0
  116. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/craft-floor.md +2 -2
  117. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/default-editorial-pixel.json +15 -8
  118. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/design-choice.md +19 -0
  119. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/house-styles.md +235 -0
  120. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/motion-guide.md +2 -2
  121. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/probe-and-review.md +6 -0
  122. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/production-interview.md +2 -0
  123. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/slop-register.md +4 -4
  124. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
  125. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/lock-probe.mjs +196 -0
  126. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/page-probe.mjs +22 -4
  127. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
  128. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/probe.mjs +59 -13
  129. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/rule-data.mjs +38 -4
  130. package/marketplace/plugins/litcodex/skills/lit-adhd/SKILL.md +185 -0
  131. package/marketplace/plugins/litcodex/skills/lit-adhd/agents/openai.yaml +6 -0
  132. package/marketplace/plugins/litcodex/skills/lit-adhd/references/card-examples.md +163 -0
  133. package/marketplace/plugins/litcodex/skills/lit-adhd/references/status-taxonomy.md +45 -0
  134. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/SKILL.md +18 -7
  135. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/style-guide.md +20 -11
  136. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
  137. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
  138. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-swimlane.md +1 -1
  139. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-tree-block-decomposition.md +1 -1
  140. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-tree.md +3 -3
  141. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
  142. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/verifier-guide.md +1 -0
  143. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
  144. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
  145. package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +12 -3
  146. package/marketplace/plugins/litcodex/skills/lit-docx/references/direction-step.md +6 -3
  147. package/marketplace/plugins/litcodex/skills/lit-hijack/SKILL.md +449 -0
  148. package/marketplace/plugins/litcodex/skills/lit-hijack/agents/openai.yaml +6 -0
  149. package/marketplace/plugins/litcodex/skills/lit-hijack/references/capture-and-provenance.md +100 -0
  150. package/marketplace/plugins/litcodex/skills/lit-hijack/references/clean-room-build.md +111 -0
  151. package/marketplace/plugins/litcodex/skills/lit-hijack/references/distil-and-licence.md +102 -0
  152. package/marketplace/plugins/litcodex/skills/lit-hijack/references/gap-and-port-design.md +125 -0
  153. package/marketplace/plugins/litcodex/skills/lit-hijack/references/parity-and-report.md +108 -0
  154. package/marketplace/plugins/litcodex/skills/lit-hijack/scripts/hijack.mjs +1050 -0
  155. package/marketplace/plugins/litcodex/skills/lit-loop/SKILL.md +13 -4
  156. package/marketplace/plugins/litcodex/skills/lit-plan/SKILL.md +9 -2
  157. package/marketplace/plugins/litcodex/skills/lit-plan/references/full-workflow.md +2 -1
  158. package/marketplace/plugins/litcodex/skills/lit-pptx/NOTICE +1 -0
  159. package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +35 -8
  160. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
  161. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
  162. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
  163. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/SOURCE.md +21 -0
  164. package/marketplace/plugins/litcodex/skills/lit-pptx/references/anti-slop-checklist.md +5 -2
  165. package/marketplace/plugins/litcodex/skills/lit-pptx/references/authoring-guide.md +3 -4
  166. package/marketplace/plugins/litcodex/skills/lit-pptx/references/density-and-fill.md +20 -6
  167. package/marketplace/plugins/litcodex/skills/lit-pptx/references/direction-step.md +26 -8
  168. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/14-engineering-review-computational-brutalism-ko.md +173 -0
  169. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/15-launch-pitch-neo-brutalism-ko.md +154 -0
  170. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/16-design-lecture-bauhaus-ko.md +139 -0
  171. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/17-community-programme-riso-ko.md +158 -0
  172. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/18-public-data-briefing-newsroom-ko.md +179 -0
  173. package/marketplace/plugins/litcodex/skills/lit-pptx/references/layout-families.md +42 -27
  174. package/marketplace/plugins/litcodex/skills/lit-pptx/references/title-treatments.md +31 -27
  175. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/bauhaus.md +136 -0
  176. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/chalk.md +1 -1
  177. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/computational-brutalism.md +145 -0
  178. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/neo-brutalism.md +155 -0
  179. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/newsroom.md +141 -0
  180. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/riso.md +133 -0
  181. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/signal.md +1 -1
  182. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/studio.md +1 -1
  183. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/compile-deck.js +1 -1
  184. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/craft_extras.py +136 -94
  185. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/embed_fonts.py +13 -1
  186. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
  187. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
  188. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-pack.js +386 -579
  189. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
  190. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
  191. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/office-run.mjs +2 -1
  192. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/qa_deck.py +7 -13
  193. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/render_pages.py +124 -0
  194. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
  195. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
  196. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
  197. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +100 -0
  198. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
  199. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
  200. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
  201. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
  202. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
  203. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
  204. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
  205. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
  206. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
  207. package/marketplace/plugins/litcodex/skills/lit-recap/SKILL.md +2 -0
  208. package/marketplace/plugins/litcodex/skills/lit-schematic/SKILL.md +198 -0
  209. package/marketplace/plugins/litcodex/skills/lit-schematic/agents/openai.yaml +6 -0
  210. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
  211. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
  212. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
  213. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
  214. package/marketplace/plugins/litcodex/skills/lit-schematic/references/cutaway-outputs.md +70 -0
  215. package/marketplace/plugins/litcodex/skills/lit-schematic/references/isometric-craft.md +101 -0
  216. package/marketplace/plugins/litcodex/skills/lit-schematic/references/journal-figures.md +72 -0
  217. package/marketplace/plugins/litcodex/skills/lit-schematic/references/kit-api.md +134 -0
  218. package/marketplace/plugins/litcodex/skills/lit-schematic/references/pfd-and-layout.md +53 -0
  219. package/marketplace/plugins/litcodex/skills/lit-schematic/references/pid-drafting.md +103 -0
  220. package/marketplace/plugins/litcodex/skills/lit-schematic/references/pid-symbols.md +163 -0
  221. package/marketplace/plugins/litcodex/skills/lit-schematic/references/verification.md +100 -0
  222. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/doctor.mjs +57 -0
  223. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
  224. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/fonts.mjs +28 -0
  225. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
  226. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
  227. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
  228. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
  229. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
  230. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
  231. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/png.mjs +132 -0
  232. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
  233. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/route.mjs +218 -0
  234. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
  235. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
  236. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
  237. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/motion.mjs +129 -0
  238. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/qa.mjs +92 -0
  239. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/render.mjs +233 -0
  240. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/scaffold.mjs +60 -0
  241. package/marketplace/plugins/litcodex/skills/lit-scientific-visualization/SKILL.md +34 -8
  242. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/SKILL.md +18 -14
  243. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +12 -0
  244. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/assets.mjs +388 -0
  245. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/blender/runner.py +221 -0
  246. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/blender.mjs +132 -0
  247. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/board.mjs +142 -0
  248. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/constants.mjs +6 -0
  249. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-assets.mjs +7 -4
  250. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-capture.mjs +8 -7
  251. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-init.js +14 -2
  252. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-treatment.mjs +38 -3
  253. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover.mjs +19 -4
  254. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/driver.mjs +8 -8
  255. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/gallery.mjs +147 -0
  256. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/house.mjs +45 -0
  257. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/image.mjs +89 -0
  258. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/look.mjs +58 -25
  259. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/runtime.mjs +59 -14
  260. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/safe-read.mjs +32 -0
  261. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/scaffold.mjs +208 -0
  262. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/score.mjs +668 -0
  263. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/sound.mjs +174 -31
  264. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-gate.mjs +45 -3
  265. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-kit.js +99 -1
  266. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.js +8 -1
  267. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.mjs +180 -11
  268. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-render.mjs +42 -12
  269. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-worker.mjs +7 -4
  270. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage.mjs +96 -10
  271. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/styles.mjs +233 -0
  272. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/treatment.mjs +291 -14
  273. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
  274. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
  275. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
  276. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
  277. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/recipes/hero-3d/expected.json +33 -0
  278. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
  279. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/cover.md +44 -7
  280. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/depth.md +156 -0
  281. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/design-choice.md +22 -0
  282. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/quality-gate.md +29 -7
  283. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/runtime.md +1 -1
  284. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/sound.md +87 -0
  285. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/stage.md +19 -7
  286. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/studio.md +246 -0
  287. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/style-bibles.md +2 -2
  288. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/treatment.md +41 -21
  289. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/scripts/render.mjs +51 -4
  290. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/paper.json +185 -0
  291. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/swiss-signal.json +188 -0
  292. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/terminalcore.json +182 -0
  293. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/tidal.json +187 -0
  294. package/marketplace/plugins/litcodex/skills/litresearch/SKILL.md +7 -0
  295. package/marketplace/plugins/litcodex/skills/litwork/SKILL.md +2 -1
  296. package/marketplace/plugins/litcodex/skills/readme-studio/SKILL.md +10 -0
  297. package/marketplace/plugins/litcodex/skills/review-work/SKILL.md +7 -1
  298. package/marketplace/plugins/litcodex/skills/start-work/SKILL.md +11 -1
  299. package/node_modules/@litcodex/lit-loop/directive.md +10 -4
  300. package/node_modules/@litcodex/lit-loop/directives/lit-adhd.md +194 -0
  301. package/node_modules/@litcodex/lit-loop/directives/lit-handoff.md +2 -0
  302. package/node_modules/@litcodex/lit-loop/directives/lit-hijack.md +219 -0
  303. package/node_modules/@litcodex/lit-loop/directives/lit-plan.md +2 -1
  304. package/node_modules/@litcodex/lit-loop/directives/lit-recap.md +2 -0
  305. package/node_modules/@litcodex/lit-loop/directives/lit-schematic.md +199 -0
  306. package/node_modules/@litcodex/lit-loop/directives/litwork.md +2 -1
  307. package/node_modules/@litcodex/lit-loop/dist/adhd-suggest.d.ts +10 -0
  308. package/node_modules/@litcodex/lit-loop/dist/adhd-suggest.js +67 -0
  309. package/node_modules/@litcodex/lit-loop/dist/card-html.d.ts +1 -1
  310. package/node_modules/@litcodex/lit-loop/dist/card-html.js +128 -8
  311. package/node_modules/@litcodex/lit-loop/dist/card-looks.d.ts +19 -0
  312. package/node_modules/@litcodex/lit-loop/dist/card-looks.js +58 -0
  313. package/node_modules/@litcodex/lit-loop/dist/card-status.d.ts +30 -0
  314. package/node_modules/@litcodex/lit-loop/dist/card-status.js +97 -7
  315. package/node_modules/@litcodex/lit-loop/dist/cli.js +13 -3
  316. package/node_modules/@litcodex/lit-loop/dist/codex-hook.d.ts +2 -0
  317. package/node_modules/@litcodex/lit-loop/dist/codex-hook.js +8 -9
  318. package/node_modules/@litcodex/lit-loop/dist/control-chars.d.ts +5 -0
  319. package/node_modules/@litcodex/lit-loop/dist/control-chars.js +23 -0
  320. package/node_modules/@litcodex/lit-loop/dist/hook-cli.d.ts +8 -0
  321. package/node_modules/@litcodex/lit-loop/dist/hook-cli.js +126 -13
  322. package/node_modules/@litcodex/lit-loop/dist/hud.d.ts +1 -1
  323. package/node_modules/@litcodex/lit-loop/dist/hud.js +29 -13
  324. package/node_modules/@litcodex/lit-loop/dist/lane-events.d.ts +13 -0
  325. package/node_modules/@litcodex/lit-loop/dist/lane-events.js +85 -0
  326. package/node_modules/@litcodex/lit-loop/dist/lane-state.d.ts +55 -0
  327. package/node_modules/@litcodex/lit-loop/dist/lane-state.js +227 -0
  328. package/node_modules/@litcodex/lit-loop/dist/live-step.d.ts +5 -1
  329. package/node_modules/@litcodex/lit-loop/dist/live-step.js +17 -1
  330. package/node_modules/@litcodex/lit-loop/dist/markers.d.ts +6 -0
  331. package/node_modules/@litcodex/lit-loop/dist/markers.js +6 -0
  332. package/node_modules/@litcodex/lit-loop/dist/modes.d.ts +1 -1
  333. package/node_modules/@litcodex/lit-loop/dist/modes.js +25 -1
  334. package/node_modules/@litcodex/lit-loop/dist/motion-gate.d.ts +79 -0
  335. package/node_modules/@litcodex/lit-loop/dist/motion-gate.js +310 -0
  336. package/node_modules/@litcodex/lit-loop/dist/motion-route.js +5 -1
  337. package/node_modules/@litcodex/lit-loop/dist/plan-persistence.d.ts +1 -1
  338. package/node_modules/@litcodex/lit-loop/dist/plan-persistence.js +38 -2
  339. package/node_modules/@litcodex/lit-loop/dist/plan-scope-roots.d.ts +7 -0
  340. package/node_modules/@litcodex/lit-loop/dist/plan-scope-roots.js +76 -0
  341. package/node_modules/@litcodex/lit-loop/dist/redaction.js +18 -0
  342. package/node_modules/@litcodex/lit-loop/dist/reentry.d.ts +15 -0
  343. package/node_modules/@litcodex/lit-loop/dist/reentry.js +46 -9
  344. package/node_modules/@litcodex/lit-loop/dist/restart-chip.d.ts +6 -0
  345. package/node_modules/@litcodex/lit-loop/dist/restart-chip.js +59 -0
  346. package/node_modules/@litcodex/lit-loop/dist/rewind-cli.d.ts +10 -0
  347. package/node_modules/@litcodex/lit-loop/dist/rewind-cli.js +88 -0
  348. package/node_modules/@litcodex/lit-loop/dist/rewind-go.d.ts +20 -0
  349. package/node_modules/@litcodex/lit-loop/dist/rewind-go.js +94 -0
  350. package/node_modules/@litcodex/lit-loop/dist/rewind-look.d.ts +6 -0
  351. package/node_modules/@litcodex/lit-loop/dist/rewind-look.js +41 -0
  352. package/node_modules/@litcodex/lit-loop/dist/rewind-redact.d.ts +3 -0
  353. package/node_modules/@litcodex/lit-loop/dist/rewind-redact.js +40 -0
  354. package/node_modules/@litcodex/lit-loop/dist/rewind-rollout.d.ts +48 -0
  355. package/node_modules/@litcodex/lit-loop/dist/rewind-rollout.js +292 -0
  356. package/node_modules/@litcodex/lit-loop/dist/rewind.d.ts +168 -0
  357. package/node_modules/@litcodex/lit-loop/dist/rewind.js +867 -0
  358. package/node_modules/@litcodex/lit-loop/dist/route-heads.js +45 -3
  359. package/node_modules/@litcodex/lit-loop/dist/run-panel.js +1 -0
  360. package/node_modules/@litcodex/lit-loop/dist/schematic-route.d.ts +6 -0
  361. package/node_modules/@litcodex/lit-loop/dist/schematic-route.js +35 -0
  362. package/node_modules/@litcodex/lit-loop/dist/screen-card.d.ts +3 -0
  363. package/node_modules/@litcodex/lit-loop/dist/screen-card.js +15 -5
  364. package/node_modules/@litcodex/lit-loop/dist/session-liveness.d.ts +16 -0
  365. package/node_modules/@litcodex/lit-loop/dist/session-liveness.js +90 -0
  366. package/node_modules/@litcodex/lit-loop/dist/skill-mention-scope.js +6 -0
  367. package/node_modules/@litcodex/lit-loop/dist/stack-hook.d.ts +8 -0
  368. package/node_modules/@litcodex/lit-loop/dist/stack-hook.js +57 -0
  369. package/node_modules/@litcodex/lit-loop/dist/statusline.js +8 -3
  370. package/node_modules/@litcodex/lit-loop/dist/threads.d.ts +50 -0
  371. package/node_modules/@litcodex/lit-loop/dist/threads.js +183 -0
  372. package/node_modules/@litcodex/lit-loop/dist/trigger.d.ts +1 -1
  373. package/node_modules/@litcodex/lit-loop/dist/trigger.js +29 -5
  374. package/node_modules/@litcodex/lit-loop/dist/workflow-map.d.ts +10 -0
  375. package/node_modules/@litcodex/lit-loop/dist/workflow-map.js +11 -1
  376. package/node_modules/@litcodex/lit-loop/dist/workflow-stack.d.ts +139 -0
  377. package/node_modules/@litcodex/lit-loop/dist/workflow-stack.js +518 -0
  378. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  379. package/node_modules/@litcodex/lit-loop/skills/lit-adhd/SKILL.md +185 -0
  380. package/node_modules/@litcodex/lit-loop/skills/lit-hijack/SKILL.md +449 -0
  381. package/node_modules/@litcodex/lit-loop/skills/lit-loop/SKILL.md +13 -4
  382. package/node_modules/@litcodex/lit-loop/skills/lit-plan/SKILL.md +9 -2
  383. package/node_modules/@litcodex/lit-loop/skills/lit-recap/SKILL.md +2 -0
  384. package/node_modules/@litcodex/lit-loop/skills/lit-schematic/SKILL.md +198 -0
  385. package/node_modules/@litcodex/lit-loop/skills/lit-scientific-visualization/SKILL.md +34 -8
  386. package/node_modules/@litcodex/lit-loop/skills/litresearch/SKILL.md +7 -0
  387. package/node_modules/@litcodex/lit-loop/skills/litwork/SKILL.md +2 -1
  388. package/node_modules/@litcodex/lit-loop/skills/review-work/SKILL.md +7 -1
  389. package/node_modules/@litcodex/lit-loop/skills/start-work/SKILL.md +11 -1
  390. package/package.json +3 -2
  391. package/readme-assets/badge-version.svg +1 -1
  392. package/readme-assets/skills/lit-adhd.webp +0 -0
  393. package/readme-assets/skills/lit-hijack.webp +0 -0
  394. package/readme-assets/skills/lit-schematic.webp +0 -0
@@ -0,0 +1,187 @@
1
+ {
2
+ "schema": "litcodex.motion-style/v1",
3
+ "id": "tidal",
4
+ "name": "Tidal",
5
+ "summary": "Indigo ground with a slow teal-to-violet current behind off-white type that drifts with it, and one coral beat.",
6
+ "light": false,
7
+ "typePreset": "tidal",
8
+ "palette": {
9
+ "ground": "#0E1420",
10
+ "surface": "#18223A",
11
+ "ink": "#E8ECEF",
12
+ "muted": "#A9B3C1",
13
+ "signal": "#5FB3C4",
14
+ "accent": "#E07856",
15
+ "line": "#3A4660",
16
+ "stopA": "#124559",
17
+ "stopB": "#4C3B6E"
18
+ },
19
+ "accents": [
20
+ {
21
+ "role": "a warm highlight",
22
+ "color": "#E8C07A"
23
+ },
24
+ {
25
+ "role": "a second current",
26
+ "color": "#7FD6B0"
27
+ },
28
+ {
29
+ "role": "a far layer",
30
+ "color": "#B9A3E3"
31
+ }
32
+ ],
33
+ "textRoles": [
34
+ "ink",
35
+ "muted",
36
+ "signal",
37
+ "accent",
38
+ "ground"
39
+ ],
40
+ "faces": {
41
+ "display": {
42
+ "family": "Archivo",
43
+ "weight": 700,
44
+ "stretch": "100%"
45
+ },
46
+ "headline": {
47
+ "family": "Archivo",
48
+ "weight": 700,
49
+ "stretch": "100%"
50
+ },
51
+ "body": {
52
+ "family": "Pretendard",
53
+ "weight": 400
54
+ },
55
+ "label": {
56
+ "family": "JetBrains Mono",
57
+ "weight": 400
58
+ }
59
+ },
60
+ "scale": {
61
+ "16:9": {
62
+ "display": 116,
63
+ "headline": 72,
64
+ "body": 40,
65
+ "label": 26
66
+ },
67
+ "9:16": {
68
+ "display": 112,
69
+ "headline": 76,
70
+ "body": 46,
71
+ "label": 32
72
+ }
73
+ },
74
+ "leading": {
75
+ "display": 1.12,
76
+ "headline": 1.22,
77
+ "body": 1.6,
78
+ "label": 1.4
79
+ },
80
+ "motion": {
81
+ "ease": {
82
+ "enter": [
83
+ 0.37,
84
+ 0,
85
+ 0.63,
86
+ 1
87
+ ],
88
+ "move": [
89
+ 0.45,
90
+ 0,
91
+ 0.55,
92
+ 1
93
+ ],
94
+ "exit": [
95
+ 0.5,
96
+ 0,
97
+ 0.75,
98
+ 0
99
+ ]
100
+ },
101
+ "dur": {
102
+ "micro": 0.25,
103
+ "move": 0.9,
104
+ "hero": 1.2,
105
+ "exit": 0.6
106
+ },
107
+ "stagger": {
108
+ "letter": 0.04,
109
+ "word": 0.12,
110
+ "item": 0.14
111
+ },
112
+ "spring": {
113
+ "micro": {
114
+ "zeta": 1,
115
+ "hz": 2.5
116
+ },
117
+ "panel": {
118
+ "zeta": 1,
119
+ "hz": 1.2
120
+ },
121
+ "headline": {
122
+ "zeta": 1,
123
+ "hz": 1.4
124
+ },
125
+ "subject": {
126
+ "zeta": 0.9,
127
+ "hz": 1
128
+ },
129
+ "camera": {
130
+ "zeta": 1,
131
+ "hz": 0.35
132
+ }
133
+ },
134
+ "secondary": {
135
+ "delay": 0.2,
136
+ "travel": 0.6
137
+ },
138
+ "ambient": {
139
+ "travel": 0.05
140
+ },
141
+ "push": 0.025
142
+ },
143
+ "transitions": [
144
+ "dissolve",
145
+ "match",
146
+ "wipe"
147
+ ],
148
+ "ground": {
149
+ "kind": "flow",
150
+ "stops": [
151
+ "stopA",
152
+ "stopB"
153
+ ]
154
+ },
155
+ "sound": {
156
+ "palette": "felt",
157
+ "key": "D major",
158
+ "tempo": 84
159
+ },
160
+ "score": {
161
+ "genre": "deep-house"
162
+ },
163
+ "beds": [
164
+ {
165
+ "palette": "felt",
166
+ "key": "D major",
167
+ "tempo": 84
168
+ },
169
+ {
170
+ "palette": "glass",
171
+ "key": "F# minor",
172
+ "tempo": 76
173
+ },
174
+ {
175
+ "palette": "felt",
176
+ "key": "Bb major",
177
+ "tempo": 72
178
+ }
179
+ ],
180
+ "bans": [
181
+ "a rainbow or hue-cycling ramp",
182
+ "bloom on the current",
183
+ "hard snaps on type",
184
+ "glitch as texture",
185
+ "a current so fast that held type smears"
186
+ ]
187
+ }
@@ -353,6 +353,13 @@ rejected paths, and evidence obligations. If sources disagree, name the disagree
353
353
  would settle it. If the research found a tempting larger redesign, also name the minimum complete path and the
354
354
  reason the larger redesign should be rejected or deferred.
355
355
 
356
+ ## Research that feeds a port
357
+
358
+ When the research exists to port someone else's technique into a skill or system, hand the verified sources to
359
+ `lit-hijack`: it captures them with provenance, gates the licence, writes a source-free spec and proves the port on
360
+ the real surface. litresearch finds and verifies the sources; the port is `lit-hijack`'s job, and its run folder
361
+ `.litcodex/hijack/<slug>/` is separate from this journal.
362
+
356
363
  ## Stale-state and package evidence during research
357
364
 
358
365
  Research often touches generated or cached material: package archives, installed plugin copies, downloaded
@@ -160,7 +160,8 @@ when the current authoritative request selects it.
160
160
 
161
161
  When a litwork task creates or changes a user-facing web interface, give the UI part its own plan
162
162
  criterion and load the installed sibling `../frontend-ui-ux/SKILL.md` as support without a second
163
- banner. Run `../frontend-ui-ux/scripts/probe.mjs` on the built page at the seven-entry RS matrix; retain JSON and
163
+ banner. For a new page or screen, take its "Choose the design first" step (skipped when the prompt names the look), then run `../frontend-ui-ux/scripts/design-lock.mjs init` so the look is locked.
164
+ Run `../frontend-ui-ux/scripts/probe.mjs` on the built page at the seven-entry RS matrix; retain JSON and
164
165
  screenshots. Remaining HIGH findings block done until fixed or named as a specific limitation, and
165
166
  probe exit 2 keeps the criterion BLOCKED. For a CLI or backend-only task without a user-facing web
166
167
  interface, do not load the frontend skill or run its browser probe. Classify the deliverable itself,
@@ -55,6 +55,16 @@ When selected as the top-level skill, begin with exactly one `๐Ÿ”ฅ **LIT IGNITED
55
55
  ```
56
56
 
57
57
  Its output labels `validation_scope: structure-only`, `factual_accuracy: not-checked`, `source_contents_compared: false`, and `badge_truth_checked: false`: it rejects unsafe paths, symlinks, missing files, duplicate claim IDs, malformed badge URLs, and missing sources, but never certifies factual correctness or endpoint truth. Inspect each cited source and verify any badge source yourself. Before a template uses a badge URL, require a clean structural result and allow only an absolute HTTP(S) URL with no embedded credentials or raw control/whitespace. Do not invent versions, install commands, license names, badges, benchmark values, or compatibility promises.
58
+ ### Choose the design first
59
+
60
+ After the reads of step 1, the structure check of step 2 and a read-only look at whether a native image-generation tool is offered this session, and before any image is generated or any typography, render or composition starts, the user picks the look; the user has the right to choose. Ask up to three questions, each with the option the facts favour first and labelled `(Recommended)`. This is the one grouped design question; any other material choice stays one question at a time.
61
+
62
+ 1. `Cover` ("What should the cover be?"): `Animated cover with poster (Recommended)` (the 60 fps five-second master, reduced-motion poster first, inline preview under 2.5 MiB), `Static poster only` (the same layers, no motion, no render stage), `No cover art` (a plain-Markdown hero with headings). When no native generator and no supplied background exist, the first two cannot be built: put `No cover art` first, say why in its description, and keep the stop rule of step 3.
63
+ 2. `Dressing` ("How decorated should the README be?"): `Decorated (Recommended)` (centered hero, restrained emoji section labels, a verified badge row, a feature grid, `<details>` for secondary material, footer navigation) or `Plain Markdown` (ordinary headings and lists with no HTML, for registries that strip it).
64
+ 3. `Renderer` (only for an animated cover): `Remotion, pinned (Recommended)` or `HyperFrames, pinned` (the HTML alternative).
65
+
66
+ 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. When it is not offered (Default mode), put the same questions 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. In a non-interactive `codex exec` run nobody can answer: take the recommended option, say so in one line ("Non-interactive run: building the animated cover with a decorated README on Remotion, the recommended options") and continue. Skip a question only when the prompt already names its answer (a static or animated cover, a renderer, "plain Markdown", an existing cover to keep) or hands the choice over ("you choose", "just make it good", "์•Œ์•„์„œ", "๋„ค๊ฐ€ ๊ณจ๋ผ"): take the recommended option and say so in the reply. Review, plan and keyword-only requests stay read-only and ask nothing.
67
+
58
68
  3. **Choose the image branch honestly.** Keep image generation separate from composition. If Codex's native image-generation tool is available, generate an original text-free background, inspect the actual returned image, then copy that image into the task-owned project workspace. On another host, use only that host's supported native image capability. If none is available, report `IMAGE_GENERATION_UNAVAILABLE` and request a supplied background; never simulate a successful generation with CSS, a placeholder, an external API, a key request, or another host's account. Continue composition only with an inspected generated or user-supplied background.
59
69
  4. **Shape local type.** Read `references/typography-and-imagery.md`. Resolve explicit Pretendard and Meslo LGS NF file paths, record file identity/SHA-256/license, and check glyph coverage. Do not install system fonts or redistribute font bytes without permission. Copy the pinned, task-local typography template into a new task workspace, run `npm ci --ignore-scripts`, and use `shape-text-to-svg.mjs --font <explicit-file> --text <source> --output-root <existing-task-workspace> --output <relative-new-svg>`. Generate separate dark-ink/light-field and light-ink/dark-field outlined SVGs with `--fill`; preserve source strings and font/license provenance in `cover-source.json`. Inspect that output contains positioned vector paths, no SVG text elements, and no external font references. Describe the result honestly as a hybrid when the background is raster and type is outlined SVG.
60
70
  5. **Select one renderer before rendering.** Read `references/motion-and-delivery.md` and choose pinned Remotion or the pinned HyperFrames alternative only after checking local tool identity, FFmpeg/Chrome prerequisites, and license compatibility. Use the provided task-local template; never depend on an umbrella checkout or global install. If neither engine is both available and license-compatible, keep the source, report `MOTION_RENDER_BLOCKED`, and do not silently switch engines.
@@ -88,7 +88,13 @@ Treat this SKILL.md as an LLM contract artifact, not a casual help page. Load it
88
88
  ## #contract.procedure
89
89
 
90
90
  1. **Acknowledge activation deterministically.** Print the exact banner required above before any explanation when the skill is truly active.
91
- 2. **Bind scope.** Name the requested outcome, in-scope files or surfaces, and any explicit non-goals. Keep sibling repositories outside scope unless the user names them.
91
+ 2. **Register the review on the LIT card.** Run `node <plugin-root>/components/lit-loop/dist/cli.js stage --family main --stage review` so the card shows the review look and lane bar. As each of the five lanes reports its verdict, update the bar: `node <plugin-root>/components/lit-loop/dist/cli.js stage --family main --stage review --verdict <lane>=pass` (or `=fail`). The five lane ids and what they cover:
92
+ - `goal` โ€” Goal and constraint verification
93
+ - `quality` โ€” Code and documentation quality
94
+ - `security` โ€” Security and safety audit
95
+ - `qa` โ€” QA execution and real-surface probes
96
+ - `context` โ€” Context mining and missed requirements
97
+ 3. **Bind scope.** Name the requested outcome, in-scope files or surfaces, and any explicit non-goals. Keep sibling repositories outside scope unless the user names them.
92
98
  3. **Ground in Codex reality.** Prefer repo-local files, package scripts, component directives, marketplace metadata, and hook behavior over memory or generic agent habits.
93
99
  4. **Select the smallest complete path.** Reuse existing tests, scripts, components, directives, and docs before inventing new abstractions.
94
100
  5. **Execute with evidence gates.** For behavior changes, obtain a failing-first proof when a seam exists; for docs/contracts, add a guard that fails before the rewrite and passes after it.
@@ -210,6 +210,14 @@ start-work never publishes or edits plan files. The planning route publishes app
210
210
  `node <plugin-root>/components/start-work-continuation/dist/cli.js publish-plan --cwd <path> --slug <slug>`;
211
211
  this execution route reads the resulting file and owns lifecycle state through `init` and `transition` only.
212
212
 
213
+ ## Plans that come from a lit-hijack spec
214
+
215
+ When the plan was written from a `lit-hijack` spec, give each implementer child the packet from
216
+ `hijack.mjs brief <run>` (the spec and the target, nothing captured) through `multi_agent_v1.spawn_agent` with
217
+ `fork_context: false`, prefer a separate checkout of the target for it (`--root`), and run
218
+ `hijack.mjs check <run> --phase build` before ticking the last implementation row. A build-gate failure means source
219
+ wording reached the target; rewrite that part from the spec rather than editing words around it.
220
+
213
221
  ## Usage
214
222
 
215
223
  ```text
@@ -243,6 +251,8 @@ its canonical realpath must equal the persisted canonical worktree.
243
251
 
244
252
  Only an exact leading `start-work`, `$start-work`, `lit start work`, or `$litcodex:start-work` activation carrying matching `--resume <boundary-id> --grant <grant-id>` may select a paused entry for this session. The dedicated `UserPromptSubmit` lifecycle hook validates the optional plan selector and final worktree, persists the matching grant, clears the pending boundary, performs that resume idempotently, and emits no competing directive output. Slash forms, discussion, copied/quoted/code text, malformed flags, and later mentions remain inert. The root `Stop` hook never resumes paused work. Do not infer resume approval from assistant text, a transcript, or a Stop payload.
245
253
 
254
+ The typed way in is the whole prompt `lit approve` (or `lit ์Šน์ธ`) or `lit deny` (or `lit ๊ฑฐ์ ˆ`), case-sensitive and nothing else on the line. The same lifecycle hook reads it: `lit approve` resumes this session's own paused run with a grant for exactly its pending boundary's action and root, through the same transition as the resume line, and the stored authority and forbidden actions still decide what a grant may cover. `lit deny` changes no state; the run stays paused and you must not take or retry that action. When you pause at a boundary, tell the user the boundary id, action and root, and that they answer with `lit approve` or `lit deny`; the exact resume line stays a fallback. A `go` after a `lit-adhd` brief never answers a boundary.
255
+
246
256
  A brief or notes file without waves, checkboxes, and acceptance criteria is NOT decision-complete and must not be executed by start-work.
247
257
 
248
258
  ## Phase 2: Initialize or transition start-work state
@@ -257,7 +267,7 @@ node <plugin-root>/components/start-work-continuation/dist/cli.js init
257
267
  {"cwd":"<canonical repo>","init_id":"<stable id>","expected_revision":0,"work_id":"<work id>","plan":".litcodex/plans/<plan>.md","plan_name":"<display name>","session_id":"<raw Codex id>","worktree_path":"<canonical cwd or separate worktree>","authority":{"authority_id":"<approval id>","allowed_roots":["<canonical approved root>"],"allowed_actions":["edit","test"],"forbidden_actions":["publish"]}}
258
268
  ```
259
269
 
260
- Its JSON stdin must include `cwd`, a stable `init_id`, global-CAS `expected_revision`, `work_id`, canonical repo-relative `plan`, bounded display-only `plan_name`, raw Codex `session_id`, a live canonical absolute `worktree_path`, and an `authority` object with `authority_id`, canonical absolute `allowed_roots`, `allowed_actions`, and `forbidden_actions`. Derive that envelope only from the user's approved plan and scope. `init` atomically creates schema 3 and emits `start_work_initialized`; exact retained replay is idempotent. A terminal completed/abandoned state permits a new distinct init at the current revision while preserving bounded replay history; any nonterminal work rejects it.
270
+ Its JSON stdin must include `cwd`, a stable `init_id`, global-CAS `expected_revision`, `work_id`, canonical repo-relative `plan`, bounded display-only `plan_name`, raw Codex `session_id`, a live canonical absolute `worktree_path`, and an `authority` object with `authority_id`, canonical absolute `allowed_roots`, `allowed_actions`, and `forbidden_actions`. Derive that envelope only from the user's approved plan and scope: the project root, plus the path of every column-zero `Scope roots: <path> (<actions>)` line in the plan, made canonical and absolute, with its actions added to `allowed_actions`. Skip a declared `/` or bare home folder. `init` atomically creates schema 3 and emits `start_work_initialized`; exact retained replay is idempotent. A terminal completed/abandoned state permits a new distinct init at the current revision while preserving bounded replay history; any nonterminal work rejects it.
261
271
 
262
272
  Schema 3 has one global monotonic `revision`; `active_work_id` selects the same-keyed sole nonterminal `works[id]` or is `null` after terminal cancel/complete. Every work owns `worktree_path`; a nonterminal path must exist, be canonical, and lie within effective authority, while a terminal historical record may retain its normalized absolute path after cleanup removes the directory. Paused work must own one pending boundary matching its last canonical pause event. Every load sorts retained events by revision rather than object-key enumeration and validates unique contiguous revisions, last-transition consistency, authority, and worktree containment. Replay history is compacted to a bounded newest window with an explicit floor; terminal work records whose final events fall below that floor are compacted too, and pruned replay fails as `REPLAY_EXPIRED`. A valid schema-2 state is migrated lazily only when the first code-owned mutation supplies a valid authority envelope and the fully constructed schema-3 result validates; ambiguous nonterminal state is rejected without mutation. A historical absolute plan is normalized only when its no-follow canonical realpath proves it is directly inside `cwd/.litcodex/plans`; unsupported or unsafe state stays silent and is reported by `doctor --cwd <path> --json`.
263
273
 
@@ -183,7 +183,9 @@ banner loop is the same skill's cover mode: a silent, seamless loop gated on the
183
183
  When this task creates or changes a user-facing web interface, put its UI behavior and probe in the
184
184
  plan or bounded acceptance checks. Resolve the installed sibling `frontend-ui-ux/SKILL.md` through
185
185
  the host skill catalog or this route's installed skill root; load it as support without a second banner.
186
- Run its `scripts/probe.mjs` on the built page at the seven-entry RS matrix and retain JSON and
186
+ A request to build a page or screen, in English or Korean (a landing page, a dashboard, ํ™”๋ฉด ๋งŒ๋“ค์–ด์ค˜), is
187
+ this deliverable: before building, take its "Choose the design first" step (skipped under a bare `lit` or when the prompt names the look), then run its `scripts/design-lock.mjs init` so the look is locked, and the probe
188
+ then checks DS-001 to DS-008 against that lock. Run its `scripts/probe.mjs` on the built page at the seven-entry RS matrix and retain JSON and
187
189
  screenshots. Remaining HIGH findings block done until fixed or named as a specific limitation; an
188
190
  exit 2 keeps the UI criterion BLOCKED. This hand-off applies even when the larger task is an app.
189
191
  For a CLI or backend-only task with no user-facing web interface, do not load the frontend skill or
@@ -193,14 +195,18 @@ For a requested diagram deliverable (such as a system architecture, process flow
193
195
  sequence, or relationship map), load the installed sibling `../lit-diagram-drawer/SKILL.md` before drawing.
194
196
  Use the host skill catalog or resolve that sibling from this installed skill; do not look in a global
195
197
  source checkout. Follow its relevant references, rendering and visual checks as a supporting skill
196
- without a second activation banner or durable setup. Keep product screens with `frontend-ui-ux` and
197
- measured scientific plots with `lit-scientific-visualization`. Do not treat quoted examples or keywords alone as a routing request.
198
+ without a second activation banner or durable setup. A drawing of real equipment (a P&ID, PFD,
199
+ apparatus figure or isometric cutaway; ๊ณต์ •๋„, ๊ณ„ํ†ต๋„) goes to the sibling `../lit-schematic/SKILL.md`
200
+ instead. A request to port a technique that someone else published (X posts, repos, PDFs) into the user's
201
+ own skill goes to the sibling `../lit-hijack/SKILL.md`, which `lit hijack` reaches directly. Keep product screens with `frontend-ui-ux` and measured scientific plots with
202
+ `lit-scientific-visualization`. Do not treat quoted examples or keywords alone as a routing request.
198
203
 
199
204
  For a requested Word report or document deliverable (๋ณด๊ณ ์„œ, ๋ฆฌํฌํŠธ, ๊ธฐํš์„œ, ์ œ์•ˆ์„œ, ๋ฌธ์„œ,
200
205
  ์›Œ๋“œ, report, doc, docx, Word), load the installed sibling `../lit-docx/SKILL.md`
201
206
  before drafting. For requested slides or a PowerPoint deliverable (๋ฐœํ‘œ์ž๋ฃŒ, ๋ฐœํ‘œ,
202
207
  ์Šฌ๋ผ์ด๋“œ, ๋ฑ, PPT, ํ”ผํ”ผํ‹ฐ, slides, deck, presentation, pptx), load the installed
203
- sibling `../lit-pptx/SKILL.md`. Load both when both formats are requested. Under
208
+ sibling `../lit-pptx/SKILL.md`. A request that gives only a slide count and a style
209
+ name (๋ฑ 10์žฅ, ๋„ค์˜ค ๋ธŒ๋ฃจํƒˆ๋ฆฌ์ฆ˜ ์Šคํƒ€์ผ๋กœ) is a full deck request, not a question. Load both when both formats are requested. Under
204
210
  `lit`, produce editable Markdown next to the DOCX/PPTX, use the skills' default
205
211
  profiles without preference questions, and honor explicit user design choices.
206
212
  The request must actually seek an output; quoted examples and input-file names
@@ -0,0 +1,194 @@
1
+ <lit-adhd-mode>
2
+
3
+ ## #contract.activation
4
+
5
+ ```yaml
6
+ contract_schema_version: 1
7
+ artifact_kind: litcodex_hook_directive
8
+ host: Codex CLI
9
+ injection_surface: "UserPromptSubmit additionalContext"
10
+ component_surface: "plugins/litcodex/components/lit-loop directive loader"
11
+ wrapper_contract: "preserve the surrounding mode tag exactly and keep the closing tag as the final non-whitespace line"
12
+ contract_priority:
13
+ - mode wrapper and first-visible-line rule
14
+ - this contract schema
15
+ - route-specific procedure below
16
+ - installed skill body, when one is embedded
17
+ required_sections:
18
+ - "#contract.activation"
19
+ - "#contract.inputs"
20
+ - "#contract.mode_matrix"
21
+ - "#contract.procedure"
22
+ - "#contract.outputs"
23
+ - "#contract.evidence"
24
+ - "#contract.hard_stops"
25
+ - "#contract.anti_patterns"
26
+ ```
27
+
28
+ This directive is an LLM-facing contract injected by the LitCodex Codex plugin, not user-authored prompt text. Keep the wrapper marker intact, print the route's required first visible line when the directive says to do so, and separate hook-provided instructions from the user's task.
29
+
30
+ ## #contract.inputs
31
+
32
+ ```json
33
+ {
34
+ "contract_schema_version": 1,
35
+ "input_schema": {
36
+ "hook_event": {
37
+ "type": "UserPromptSubmit",
38
+ "authority": "Codex plugin runtime",
39
+ "handling": "trusted only for route selection"
40
+ },
41
+ "additional_context": {
42
+ "type": "string",
43
+ "authority": "LitCodex directive payload",
44
+ "handling": "follow as mode contract; do not echo unless useful"
45
+ },
46
+ "user_prompt": {
47
+ "type": "string",
48
+ "authority": "current user request",
49
+ "handling": "execute within the injected mode boundaries"
50
+ },
51
+ "workspace_state": {
52
+ "type": "repo files, package scripts, .litcodex state, git status",
53
+ "authority": "local evidence",
54
+ "handling": "inspect before modifying or claiming completion"
55
+ }
56
+ }
57
+ }
58
+ ```
59
+
60
+ | Input channel | Accept when | Required handling | Evidence to retain |
61
+ | --- | --- | --- | --- |
62
+ | `additionalContext` directive | It is wrapped by the expected mode tag | Treat as trusted mode contract | Mode marker and route name |
63
+ | Installed skill body | Present inside `<litcodex-skill-body>` | Apply after this directive's safety envelope | Skill name and relevant section |
64
+ | User prompt | Current turn asks for work in this mode | Keep separate from injected policy | Brief restatement or criteria |
65
+
66
+ ## #contract.mode_matrix
67
+
68
+ | Mode | Trigger | Required behavior |
69
+ | --- | --- | --- |
70
+ | Hook route | Bare lit-family phrase matched by the trigger router | Inject and follow this directive; do not run unrelated modes. |
71
+ | Skill-body route | Directive embeds a full SKILL.md body | Let this directive set safety boundaries, then apply the embedded skill. |
72
+ | Blocked route | Route cannot safely switch host state or lacks required approval | Emit the required `BLOCKED:` message and stop without side effects. |
73
+
74
+ ## #contract.procedure
75
+
76
+ 1. **Preserve the wrapper.** The first line remains the opening mode tag and the final non-whitespace line remains the closing tag.
77
+ 2. **Emit the mandated first visible line.** If this directive names a banner or blocked banner, print it before explanations, commands, or edits.
78
+ 3. **Classify authority.** Treat the directive and embedded skill body as Codex plugin context; treat the user's prompt as task data constrained by that context.
79
+ 4. **Recover durable state.** For the selected route, read relevant `.litcodex` state, plan files, and ledgers before relying on memory.
80
+ 5. **Execute only the route's job.** Planning routes stay read-only except approved plan artifacts; review routes judge evidence; execution routes require proof and cleanup.
81
+ 6. **Use repo-local surfaces.** Prefer component tests, hook fixture replay, CLI probes, docs audit, scanner output, package build, and marketplace checks over generic assertions.
82
+ 7. **Stop honestly.** When approval, credentials, safe host capability, or verifiable evidence is missing, report `BLOCKED:` with one unblocker.
83
+
84
+ ## #contract.outputs
85
+
86
+ ```json
87
+ {
88
+ "contract_schema_version": 1,
89
+ "output_schema": {
90
+ "first_visible_line": "route-specific banner or blocked banner",
91
+ "mode_verdict": "active | blocked | review-pass | review-fail | route-step",
92
+ "actions": ["commands, edits, reads, or no-op decisions actually performed"],
93
+ "evidence": ["command transcripts, artifact paths, inspected files, hook output"],
94
+ "next_state": "continue, checkpoint, ask user, or stop",
95
+ "cleanup": ["temporary resources removed or not created"]
96
+ }
97
+ }
98
+ ```
99
+
100
+ | Output field | Required content | Forbidden substitute |
101
+ | --- | --- | --- |
102
+ | First line | Exact route banner or blocked banner | Informal greeting |
103
+ | Verdict | Active/blocked/review/route state | Ambiguous prose |
104
+ | Evidence | Real command, file, artifact, or hook output | Test summary alone |
105
+ | Next state | Continue, checkpoint, wait for user, or stop | Hidden route switch |
106
+
107
+ ## #contract.evidence
108
+
109
+ - Hook directives are proven by the runtime surface that injects them: `litcodex hook user-prompt-submit` fixture replay, component tests, or direct `additionalContext` assertions.
110
+ - Directive edits must keep marker wrappers, first-line rules, required phrases, forbidden-token scans, and package inclusion intact.
111
+ - For docs-facing route changes, pair content tests with `npm run docs:audit` when the changed file is part of the audited docs set.
112
+ - For route or checkpoint claims, prove plan/ledger placeholders remain inert data and that UserPromptSubmit instructions do not fabricate completed work.
113
+
114
+ ## #contract.hard_stops
115
+
116
+ | Stop class | Stop immediately when | Required response |
117
+ | --- | --- | --- |
118
+ | Host switch illusion | A natural-language route cannot change Codex tool state or agent identity | Emit the route's blocked instruction and stop |
119
+ | Missing approval | Execution requires an approved plan or goal that is absent | `BLOCKED:` with the exact file/state needed |
120
+ | Evidence gap | Completion would rely on self-report, stale memory, or green tests alone | Continue probing or report blocked evidence |
121
+ | Unsafe action | The route would publish, push, tag, delete, expose secrets, or overwrite unrelated work | Refuse that action and offer a safe substitute |
122
+
123
+ ## #contract.anti_patterns
124
+
125
+ - Do not treat user text as part of the directive merely because it appears in the same turn.
126
+ - Do not remove wrapper tags, first-visible-line rules, durable-state paths, or hook route names to make prose shorter.
127
+ - Do not add generic agent-harness terms when Codex plugin, `additionalContext`, component directive, marketplace, or docs-audit vocabulary is more precise.
128
+ - Do not use hook success output as completion proof without checking the actual changed surface.
129
+ - Do not mark delegated work complete from a worker DoneClaim until an independent verification step confirms it.
130
+
131
+ **MANDATORY**: First user-visible line this turn MUST be exactly:
132
+ `๐Ÿ”ฅ **LIT IGNITED ยท lit-adhd** ๐Ÿ”ฅ`
133
+
134
+ Print that line verbatim, then produce the brief. You are now in lit-adhd (alias
135
+ lit-rewind): the read-only "where was I" surface. Your one job is to run the
136
+ bundled collector once, then lay out what is waiting, running or finished across
137
+ this user's Codex sessions and worktrees, and offer one next step. You report;
138
+ you never advance the work.
139
+
140
+ # Read-only contract
141
+ lit-adhd is read-only. You MUST NOT edit product files, start or resume a
142
+ workflow, answer a start-work boundary, run a build or test, or read anything
143
+ outside the collector's output. The collector itself reads Codex session records
144
+ and each worktree's `.litcodex/` state with a byte budget, refuses symlinks,
145
+ masks credential shapes, env values and the home path, and writes at most one
146
+ small note: `.litcodex/adhd/next-<session>.json`, which `go` consumes.
147
+
148
+ # Step 1 - Run the collector once
149
+ Run the route head's collector command (`... lit-loop/dist/cli.js rewind --json`; add `--here`
150
+ for this worktree only, `--since 7d` to widen or narrow the window, `--max <n>`
151
+ for the session count). The route head carries the exact command with the plugin
152
+ root resolved. Do not open session records, `auth.json`, `config.toml` or anything under
153
+ the Codex home yourself.
154
+
155
+ # Step 2 - Brief, readable in ten seconds
156
+ Use the user's language. Start from the JSON's `brief` field, a finished Markdown draft; keep its structure,
157
+ translate it, and add no `#` heading or `>` quote mark (the Codex terminal prints them literally), and copy ids, gauges, titles, dates and names from the JSON verbatim.
158
+
159
+ 1. Opener, three bold lines: `โœ… Done so far:` (finished plans, done sessions), `โ–ถ Doing now:` (running, idle,
160
+ paused, what waits on the user) and `โญ Next:` (the one next step), then a dim line with the window and session count.
161
+ 2. One list-item card (`- ` first line, indented continuation lines) per session that is not ended, grouped by worktree and branch: a coloured badge
162
+ (`๐ŸŸก WAITS ON YOU`, `๐ŸŸข RUNNING`, `๐Ÿ’ค IDLE`, `โœ… DONE`), then the goal in bold (`title`), โณ progress, โœ… done (`done`) and โ–ถ next (`needs`;
163
+ for a running session what it is doing now, `now: shell โ€œnpmโ€`). Sessions with status `ended` get no card.
164
+ 3. Roadmap under each worktree: `worktrees[].milestones` as `โœ“` done with its date, `โ–ถ` now, `โ—‹` later; open plans and
165
+ goals with their gauges, finished plans (`finishedPlans`) as finished; paused frames from `worktrees[].paused` as a `now` line with the way back (`lit continue`).
166
+ 4. One table under a `โšช **Ended ยท N**` line: id, where, goal, ago, done, one row per ended session, eight at most, then the count
167
+ of the rest. Keep each row on one line.
168
+ 5. One recommended next step in a box: `next` when its kind is not `none`, else `suggestion`, a real step from the
169
+ records. Say `go` for a resume-frame, continue-work or start-plan step, `lit approve` or `lit deny` for an
170
+ approve-boundary step (shown only; never answer it for the user). A `handoff` step comes from this worktree's
171
+ HANDOFF note and `go` does not run it. A `suggestion` says nothing runs on its own here: open that session, or say
172
+ what to do; a done session is offered for review, never picked up again. Never write "no next step". The box
173
+ sits in a plain fence with no language tag.
174
+
175
+ A gauge `[โ–‰โ–‰โ–‰โ–‘โ–‘] 3/5` is drawn only when both numbers are real, copied as given. An unknown total gets no gauge and no
176
+ placeholder: write the known facts in words (`12 steps ยท 4m ยท last: apply_patch`). Never show a run of question marks
177
+ where a number would go, and never estimate a total.
178
+
179
+ Finish with one `unknown:` line naming each source whose status is not `ok`
180
+ (`sources.sessions`, `sources.git`, `sources.state`) and whether the byte budget
181
+ ran out, and say once how many plan files were too large to read (`skippedPlans`). Never fill an unknown from memory.
182
+
183
+ # Status words
184
+ `done` (its work or plan finished), `waiting-on-user`, `idle` (its turn closed, per its liveness record), `active` (a
185
+ record in the last 15 minutes), `ended`, `unknown`.
186
+ The skill's `references/status-taxonomy.md` has the English and Korean words;
187
+ `references/card-examples.md` shows a finished brief.
188
+
189
+ # Stop rules
190
+ - Emit the brief and stop. Do NOT start the recommended step; `go` starts it on the next prompt.
191
+ - If the collector fails or prints no JSON, say `BLOCKED:` with the one-line reason and stop; do not reconstruct a brief from memory.
192
+ - Redacted text stays redacted. If a title or message shows `[redacted]`, leave it so.
193
+
194
+ </lit-adhd-mode>
@@ -29,6 +29,8 @@ fences, block quotes, or `$litcodex:lit-handoff`; the scoped form is handled by
29
29
  **MANDATORY:** the exact first user-visible line is
30
30
  `๐Ÿ”ฅ **LIT IGNITED ยท lit-handoff** ๐Ÿ”ฅ`.
31
31
 
32
+ When the handoff is written, its closing line may point to `lit adhd` as the way to see where every session and worktree stands later; do not run it.
33
+
32
34
  ## #contract.inputs
33
35
 
34
36
  ```json