@litfamily/lithermes 1.0.0

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 (557) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +186 -0
  3. package/README_Ko-KR.md +188 -0
  4. package/assets/lithermes-plugin/NOTICE.md +46 -0
  5. package/assets/lithermes-plugin/README.md +390 -0
  6. package/assets/lithermes-plugin/__init__.py +589 -0
  7. package/assets/lithermes-plugin/auto_update.py +338 -0
  8. package/assets/lithermes-plugin/bounded_work.py +1120 -0
  9. package/assets/lithermes-plugin/bounded_work_tools.py +115 -0
  10. package/assets/lithermes-plugin/core.py +1813 -0
  11. package/assets/lithermes-plugin/core_commands.py +243 -0
  12. package/assets/lithermes-plugin/core_contexts.py +458 -0
  13. package/assets/lithermes-plugin/core_contract.py +456 -0
  14. package/assets/lithermes-plugin/core_plans.py +418 -0
  15. package/assets/lithermes-plugin/core_reader_args.py +34 -0
  16. package/assets/lithermes-plugin/core_recap_command.py +141 -0
  17. package/assets/lithermes-plugin/core_recap_state.py +175 -0
  18. package/assets/lithermes-plugin/core_review.py +198 -0
  19. package/assets/lithermes-plugin/core_routing.py +641 -0
  20. package/assets/lithermes-plugin/core_runs.py +283 -0
  21. package/assets/lithermes-plugin/core_runtime.py +251 -0
  22. package/assets/lithermes-plugin/core_workflow_commands.py +207 -0
  23. package/assets/lithermes-plugin/deliverable_hedge_guard.py +562 -0
  24. package/assets/lithermes-plugin/diagnostics.py +468 -0
  25. package/assets/lithermes-plugin/handoff.py +97 -0
  26. package/assets/lithermes-plugin/knowledge.py +920 -0
  27. package/assets/lithermes-plugin/knowledge_tools.py +130 -0
  28. package/assets/lithermes-plugin/lit_mark.py +140 -0
  29. package/assets/lithermes-plugin/lit_mark_rows.json +1363 -0
  30. package/assets/lithermes-plugin/litgoal/__init__.py +10 -0
  31. package/assets/lithermes-plugin/litgoal/cli.py +207 -0
  32. package/assets/lithermes-plugin/litgoal/hook.py +81 -0
  33. package/assets/lithermes-plugin/litgoal/model.py +203 -0
  34. package/assets/lithermes-plugin/litgoal/runtime.py +522 -0
  35. package/assets/lithermes-plugin/litgoal/store.py +367 -0
  36. package/assets/lithermes-plugin/litgoal/tools.py +300 -0
  37. package/assets/lithermes-plugin/output-styles/asd-ste100-ko.md +41 -0
  38. package/assets/lithermes-plugin/output-styles/asd-ste100.md +40 -0
  39. package/assets/lithermes-plugin/output-styles/eli5-ko.md +13 -0
  40. package/assets/lithermes-plugin/output-styles/eli5.md +11 -0
  41. package/assets/lithermes-plugin/output_styles.py +62 -0
  42. package/assets/lithermes-plugin/payload-version.json +2107 -0
  43. package/assets/lithermes-plugin/plugin.yaml +16 -0
  44. package/assets/lithermes-plugin/provider_metrics.py +161 -0
  45. package/assets/lithermes-plugin/redaction.py +148 -0
  46. package/assets/lithermes-plugin/rules/__init__.py +55 -0
  47. package/assets/lithermes-plugin/rules/bundled-rules/baseline-discipline.md +20 -0
  48. package/assets/lithermes-plugin/rules/bundled-rules/build-decision-gate.md +19 -0
  49. package/assets/lithermes-plugin/rules/bundled-rules/windows-git-bash.md +17 -0
  50. package/assets/lithermes-plugin/rules/constants.py +122 -0
  51. package/assets/lithermes-plugin/rules/discovery.py +276 -0
  52. package/assets/lithermes-plugin/rules/engine.py +447 -0
  53. package/assets/lithermes-plugin/rules/frontmatter.py +149 -0
  54. package/assets/lithermes-plugin/rules/globmatch.py +333 -0
  55. package/assets/lithermes-plugin/scientific_visualization.py +158 -0
  56. package/assets/lithermes-plugin/session_context.py +8 -0
  57. package/assets/lithermes-plugin/skill_loop.py +2044 -0
  58. package/assets/lithermes-plugin/skill_observer.py +1778 -0
  59. package/assets/lithermes-plugin/skills/autoconference/LICENSE +21 -0
  60. package/assets/lithermes-plugin/skills/autoconference/ORIGIN.json +11 -0
  61. package/assets/lithermes-plugin/skills/autoconference/SKILL.md +163 -0
  62. package/assets/lithermes-plugin/skills/autoconference/assets/conference_template.md +76 -0
  63. package/assets/lithermes-plugin/skills/autoconference/assets/report_template.md +53 -0
  64. package/assets/lithermes-plugin/skills/autoconference/assets/synthesis_template.md +39 -0
  65. package/assets/lithermes-plugin/skills/autoconference/dependencies/autoresearch.md +14 -0
  66. package/assets/lithermes-plugin/skills/autoconference/modes/analyze/SKILL.md +269 -0
  67. package/assets/lithermes-plugin/skills/autoconference/modes/core/SKILL.md +134 -0
  68. package/assets/lithermes-plugin/skills/autoconference/modes/core/convergence-guide.md +162 -0
  69. package/assets/lithermes-plugin/skills/autoconference/modes/core/crash-recovery.md +63 -0
  70. package/assets/lithermes-plugin/skills/autoconference/modes/debate/SKILL.md +383 -0
  71. package/assets/lithermes-plugin/skills/autoconference/modes/plan/SKILL.md +304 -0
  72. package/assets/lithermes-plugin/skills/autoconference/modes/resume/SKILL.md +82 -0
  73. package/assets/lithermes-plugin/skills/autoconference/modes/ship/SKILL.md +78 -0
  74. package/assets/lithermes-plugin/skills/autoconference/modes/survey/SKILL.md +376 -0
  75. package/assets/lithermes-plugin/skills/autoconference/references/agent-prompts.md +110 -0
  76. package/assets/lithermes-plugin/skills/autoconference/references/conference-protocol.md +90 -0
  77. package/assets/lithermes-plugin/skills/autoconference/references/core-principles.md +78 -0
  78. package/assets/lithermes-plugin/skills/autoconference/references/results-logging.md +165 -0
  79. package/assets/lithermes-plugin/skills/autoconference/references/visualization-guide.md +99 -0
  80. package/assets/lithermes-plugin/skills/autoconference/scripts/check_conference.sh +197 -0
  81. package/assets/lithermes-plugin/skills/autoconference/scripts/init_conference.py +489 -0
  82. package/assets/lithermes-plugin/skills/autoconference/scripts/style_presets.py +104 -0
  83. package/assets/lithermes-plugin/skills/autoconference/templates/code-performance.md +59 -0
  84. package/assets/lithermes-plugin/skills/autoconference/templates/debate-mode.md +50 -0
  85. package/assets/lithermes-plugin/skills/autoconference/templates/prompt-optimization.md +58 -0
  86. package/assets/lithermes-plugin/skills/autoconference/templates/quick-conference.md +48 -0
  87. package/assets/lithermes-plugin/skills/autoconference/templates/research-synthesis.md +56 -0
  88. package/assets/lithermes-plugin/skills/autoconference/templates/survey-mode.md +63 -0
  89. package/assets/lithermes-plugin/skills/autoresearch/LICENSE +21 -0
  90. package/assets/lithermes-plugin/skills/autoresearch/ORIGIN.json +11 -0
  91. package/assets/lithermes-plugin/skills/autoresearch/SKILL.md +175 -0
  92. package/assets/lithermes-plugin/skills/autoresearch/assets/report_template.md +50 -0
  93. package/assets/lithermes-plugin/skills/autoresearch/assets/research_template.md +38 -0
  94. package/assets/lithermes-plugin/skills/autoresearch/assets/results_template.tsv +2 -0
  95. package/assets/lithermes-plugin/skills/autoresearch/modes/core/SKILL.md +204 -0
  96. package/assets/lithermes-plugin/skills/autoresearch/modes/core/evaluator-contract.md +108 -0
  97. package/assets/lithermes-plugin/skills/autoresearch/modes/core/stuck-detection.md +102 -0
  98. package/assets/lithermes-plugin/skills/autoresearch/modes/debug/SKILL.md +240 -0
  99. package/assets/lithermes-plugin/skills/autoresearch/modes/debug/investigation-techniques.md +254 -0
  100. package/assets/lithermes-plugin/skills/autoresearch/modes/fix/SKILL.md +176 -0
  101. package/assets/lithermes-plugin/skills/autoresearch/modes/learn/SKILL.md +96 -0
  102. package/assets/lithermes-plugin/skills/autoresearch/modes/plan/SKILL.md +291 -0
  103. package/assets/lithermes-plugin/skills/autoresearch/modes/predict/SKILL.md +271 -0
  104. package/assets/lithermes-plugin/skills/autoresearch/modes/predict/persona-templates.md +227 -0
  105. package/assets/lithermes-plugin/skills/autoresearch/modes/reason/SKILL.md +174 -0
  106. package/assets/lithermes-plugin/skills/autoresearch/modes/scenario/SKILL.md +168 -0
  107. package/assets/lithermes-plugin/skills/autoresearch/modes/scenario/dimensions.md +173 -0
  108. package/assets/lithermes-plugin/skills/autoresearch/modes/security/SKILL.md +287 -0
  109. package/assets/lithermes-plugin/skills/autoresearch/modes/security/owasp-checklist.md +156 -0
  110. package/assets/lithermes-plugin/skills/autoresearch/modes/security/stride-model.md +191 -0
  111. package/assets/lithermes-plugin/skills/autoresearch/modes/ship/SKILL.md +99 -0
  112. package/assets/lithermes-plugin/skills/autoresearch/modes/ship/type-checklists.md +158 -0
  113. package/assets/lithermes-plugin/skills/autoresearch/references/core-principles.md +75 -0
  114. package/assets/lithermes-plugin/skills/autoresearch/references/results-logging.md +55 -0
  115. package/assets/lithermes-plugin/skills/autoresearch/references/visualization-guide.md +90 -0
  116. package/assets/lithermes-plugin/skills/autoresearch/scripts/check_progress.sh +139 -0
  117. package/assets/lithermes-plugin/skills/autoresearch/scripts/init_research.py +219 -0
  118. package/assets/lithermes-plugin/skills/autoresearch/scripts/style_presets.py +104 -0
  119. package/assets/lithermes-plugin/skills/browser-drive/SKILL.md +147 -0
  120. package/assets/lithermes-plugin/skills/browser-drive/scripts/capability_probe.py +528 -0
  121. package/assets/lithermes-plugin/skills/comment-checker/SKILL.md +162 -0
  122. package/assets/lithermes-plugin/skills/debugging/SKILL.md +271 -0
  123. package/assets/lithermes-plugin/skills/debugging/references/methodology/00-setup.md +108 -0
  124. package/assets/lithermes-plugin/skills/debugging/references/methodology/02-investigate.md +122 -0
  125. package/assets/lithermes-plugin/skills/debugging/references/methodology/04-oracle-triple.md +136 -0
  126. package/assets/lithermes-plugin/skills/debugging/references/methodology/05-escalate.md +69 -0
  127. package/assets/lithermes-plugin/skills/debugging/references/methodology/06-fix.md +116 -0
  128. package/assets/lithermes-plugin/skills/debugging/references/methodology/08-qa.md +94 -0
  129. package/assets/lithermes-plugin/skills/debugging/references/methodology/09-cleanup.md +164 -0
  130. package/assets/lithermes-plugin/skills/debugging/references/methodology/partial-runtime-evidence.md +229 -0
  131. package/assets/lithermes-plugin/skills/debugging/references/runtimes/bundled-js-binary.md +415 -0
  132. package/assets/lithermes-plugin/skills/debugging/references/runtimes/go.md +252 -0
  133. package/assets/lithermes-plugin/skills/debugging/references/runtimes/native-binary.md +484 -0
  134. package/assets/lithermes-plugin/skills/debugging/references/runtimes/node.md +260 -0
  135. package/assets/lithermes-plugin/skills/debugging/references/runtimes/python.md +248 -0
  136. package/assets/lithermes-plugin/skills/debugging/references/runtimes/rust.md +234 -0
  137. package/assets/lithermes-plugin/skills/debugging/references/tools/ghidra.md +212 -0
  138. package/assets/lithermes-plugin/skills/debugging/references/tools/playwright-cli.md +194 -0
  139. package/assets/lithermes-plugin/skills/debugging/references/tools/pwndbg.md +263 -0
  140. package/assets/lithermes-plugin/skills/debugging/references/tools/pwntools.md +265 -0
  141. package/assets/lithermes-plugin/skills/deep-interview/SKILL.md +419 -0
  142. package/assets/lithermes-plugin/skills/frontend-ui-ux/SKILL.md +49 -0
  143. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/.gitattributes +2 -0
  144. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/README.md +248 -0
  145. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/_INDEX.md +191 -0
  146. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/airbnb.md +393 -0
  147. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/airtable.md +92 -0
  148. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/apple.md +250 -0
  149. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/aside.md +209 -0
  150. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/binance.md +348 -0
  151. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/bmw.md +183 -0
  152. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/brutalist-skill.md +92 -0
  153. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/bugatti.md +271 -0
  154. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/cal.md +262 -0
  155. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/claude.md +315 -0
  156. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/clay.md +307 -0
  157. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/clickhouse.md +284 -0
  158. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/clone-from-url.md +65 -0
  159. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/cohere.md +269 -0
  160. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/coinbase.md +132 -0
  161. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/composio.md +310 -0
  162. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/cursor.md +312 -0
  163. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/design-system-architecture.md +244 -0
  164. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/elevenlabs.md +268 -0
  165. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/expo.md +284 -0
  166. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/ferrari.md +317 -0
  167. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/figma.md +223 -0
  168. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/framer.md +249 -0
  169. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/gpt-tasteskill.md +74 -0
  170. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/hashicorp.md +281 -0
  171. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/ibm.md +335 -0
  172. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/image-to-code-skill.md +1228 -0
  173. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/imagegen-brandkit.md +798 -0
  174. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/imagegen-frontend-mobile.md +1465 -0
  175. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/imagegen-frontend-web.md +987 -0
  176. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/intercom.md +149 -0
  177. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/kraken.md +128 -0
  178. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/lamborghini.md +291 -0
  179. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/layout-skill.md +107 -0
  180. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/lazyweb.md +77 -0
  181. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/linear.app.md +370 -0
  182. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/lovable.md +301 -0
  183. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/mastercard.md +368 -0
  184. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/meta.md +369 -0
  185. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/minimalist-skill.md +85 -0
  186. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/minimax.md +260 -0
  187. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/mintlify.md +329 -0
  188. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/miro.md +111 -0
  189. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/mistral.ai.md +264 -0
  190. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/mongodb.md +269 -0
  191. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/nike.md +366 -0
  192. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/notion.md +312 -0
  193. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/nvidia.md +296 -0
  194. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/ollama.md +270 -0
  195. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/opencode.ai.md +284 -0
  196. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/output-skill.md +49 -0
  197. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/pinterest.md +233 -0
  198. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/playstation.md +367 -0
  199. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/posthog.md +259 -0
  200. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/raycast.md +271 -0
  201. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/react-dev-tooling-skill.md +230 -0
  202. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/redesign-skill.md +178 -0
  203. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/renault.md +314 -0
  204. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/replicate.md +264 -0
  205. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/resend.md +306 -0
  206. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/revolut.md +188 -0
  207. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/runwayml.md +247 -0
  208. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/sanity.md +360 -0
  209. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/sentry.md +265 -0
  210. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/shopify.md +353 -0
  211. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/soft-skill.md +98 -0
  212. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/spacex.md +197 -0
  213. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/spotify.md +249 -0
  214. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/starbucks.md +583 -0
  215. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/stitch-design-example.md +121 -0
  216. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/stitch-skill.md +184 -0
  217. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/stripe.md +325 -0
  218. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/supabase.md +258 -0
  219. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/superhuman.md +255 -0
  220. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/taste-skill.md +1206 -0
  221. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/tesla.md +289 -0
  222. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/theverge.md +342 -0
  223. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/together.ai.md +266 -0
  224. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/uber.md +298 -0
  225. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/vercel.md +313 -0
  226. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/vodafone.md +426 -0
  227. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/voltagent.md +326 -0
  228. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/warp.md +256 -0
  229. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/webflow.md +95 -0
  230. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/wired.md +281 -0
  231. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/wise.md +176 -0
  232. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/x.ai.md +260 -0
  233. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/design/zapier.md +331 -0
  234. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/EVIDENCE.md +97 -0
  235. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/README.md +48 -0
  236. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/UPSTREAM.md +80 -0
  237. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/lane-a-direction.md +64 -0
  238. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/lane-b-execution.md +65 -0
  239. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/lane-c-review.md +65 -0
  240. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/lane-d-memory.md +83 -0
  241. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/orchestration.md +80 -0
  242. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/routing.md +79 -0
  243. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/LICENSE +21 -0
  244. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/agents/accessibility-reviewer.md +83 -0
  245. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/agents/content-writer.md +132 -0
  246. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/agents/design-builder.md +109 -0
  247. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/agents/design-critic.md +89 -0
  248. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/agents/design-lead.md +113 -0
  249. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/agents/design-scout.md +78 -0
  250. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/agents/design-strategist.md +121 -0
  251. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/agents/heuristic-evaluator.md +268 -0
  252. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/agents/inspiration-scout.md +107 -0
  253. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/agents/motion-designer.md +120 -0
  254. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/accessible-content/reference.md +101 -0
  255. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/adaptive-interfaces/reference.md +109 -0
  256. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/cognitive-accessibility/reference.md +107 -0
  257. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/design-debate/reference.md +199 -0
  258. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/design-debt-tracker/reference.md +174 -0
  259. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/design-handoff/reference.md +125 -0
  260. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/design-md/reference.md +106 -0
  261. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/design-retrospective/reference.md +266 -0
  262. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/design-review/reference.md +123 -0
  263. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/design-system-alignment/reference.md +120 -0
  264. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/designpowers-critique/reference.md +164 -0
  265. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/heuristic-evaluation/reference.md +85 -0
  266. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/inclusive-personas/reference.md +98 -0
  267. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/inspiration-scouting/reference.md +165 -0
  268. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/interaction-design/reference.md +122 -0
  269. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/motion-choreography/reference.md +81 -0
  270. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/research-planning/reference.md +96 -0
  271. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/responsive-patterns/reference.md +77 -0
  272. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/synthetic-user-testing/reference.md +192 -0
  273. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/taste-feedback/reference.md +165 -0
  274. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/taste-report/reference.md +78 -0
  275. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/token-architecture/reference.md +75 -0
  276. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/ui-composition/reference.md +117 -0
  277. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/usability-testing/reference.md +78 -0
  278. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/verification-before-shipping/reference.md +125 -0
  279. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/voice-and-tone/reference.md +79 -0
  280. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/designpowers/vendor/skills/writing-design-plans/reference.md +119 -0
  281. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/perfection/README.md +160 -0
  282. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/perfection/react-perf-tooling.md +127 -0
  283. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/README.md +659 -0
  284. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/charts.csv +26 -0
  285. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/colors.csv +162 -0
  286. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/icons.csv +106 -0
  287. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/landing.csv +35 -0
  288. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/products.csv +162 -0
  289. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/react-performance.csv +45 -0
  290. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/astro.csv +54 -0
  291. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/flutter.csv +53 -0
  292. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/html-tailwind.csv +56 -0
  293. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/jetpack-compose.csv +53 -0
  294. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/nextjs.csv +53 -0
  295. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/nuxt-ui.csv +51 -0
  296. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/nuxtjs.csv +59 -0
  297. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/react-native.csv +52 -0
  298. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/react.csv +54 -0
  299. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/shadcn.csv +61 -0
  300. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/svelte.csv +54 -0
  301. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/swiftui.csv +51 -0
  302. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/stacks/vue.csv +50 -0
  303. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/styles.csv +85 -0
  304. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/typography.csv +74 -0
  305. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/ui-reasoning.csv +162 -0
  306. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/ux-guidelines.csv +100 -0
  307. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/data/web-interface.csv +31 -0
  308. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/scripts/core.py +262 -0
  309. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/scripts/design_system.py +1148 -0
  310. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/corpus/ui-ux-db/scripts/search.py +114 -0
  311. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/legal/ATTRIBUTION.md +217 -0
  312. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/legal/LICENSE +21 -0
  313. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/legal/LICENSE-Apache-2.0.txt +201 -0
  314. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/_canonical-corpus/manifest.json +876 -0
  315. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/adaptive-layout.md +81 -0
  316. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/brand-and-imagery.md +84 -0
  317. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/complete-contract.md +457 -0
  318. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/composition.md +89 -0
  319. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/creative-directions.md +81 -0
  320. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/evidence-review.md +113 -0
  321. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/implementation-platforms.md +92 -0
  322. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/inclusive-interface.md +85 -0
  323. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/interaction-motion.md +87 -0
  324. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/operating-lanes.md +85 -0
  325. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/performance-delivery.md +85 -0
  326. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/product-direction.md +86 -0
  327. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/redesign-playbook.md +91 -0
  328. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/system-foundations.md +82 -0
  329. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/taste-direction.md +86 -0
  330. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/visual-language.md +85 -0
  331. package/assets/lithermes-plugin/skills/frontend-ui-ux/references/visual-reconstruction.md +94 -0
  332. package/assets/lithermes-plugin/skills/frontend-ui-ux/resources/LICENSE +21 -0
  333. package/assets/lithermes-plugin/skills/frontend-ui-ux/resources/PROVENANCE.json +38 -0
  334. package/assets/lithermes-plugin/skills/frontend-ui-ux/resources/THIRD-PARTY-NOTICE.txt +14 -0
  335. package/assets/lithermes-plugin/skills/frontend-ui-ux/resources/design-intelligence.json +1 -0
  336. package/assets/lithermes-plugin/skills/frontend-ui-ux/resources/import-manifest.json +1060 -0
  337. package/assets/lithermes-plugin/skills/frontend-ui-ux/schemas/design-contract-v1alpha1.schema.json +264 -0
  338. package/assets/lithermes-plugin/skills/frontend-ui-ux/schemas/design-contract-v1beta1.schema.json +268 -0
  339. package/assets/lithermes-plugin/skills/frontend-ui-ux/schemas/design-contract-v1beta2.schema.json +280 -0
  340. package/assets/lithermes-plugin/skills/frontend-ui-ux/scripts/design_contract_validation.py +996 -0
  341. package/assets/lithermes-plugin/skills/frontend-ui-ux/scripts/design_intelligence.py +128 -0
  342. package/assets/lithermes-plugin/skills/frontend-ui-ux/scripts/design_runtime.py +98 -0
  343. package/assets/lithermes-plugin/skills/frontend-ui-ux/scripts/import_design_intelligence.py +56 -0
  344. package/assets/lithermes-plugin/skills/frontend-ui-ux/scripts/source_import.py +144 -0
  345. package/assets/lithermes-plugin/skills/frontend-ui-ux/scripts/source_manifest.py +65 -0
  346. package/assets/lithermes-plugin/skills/lit-burnoff/SKILL.md +448 -0
  347. package/assets/lithermes-plugin/skills/lit-burnoff-file/SKILL.md +254 -0
  348. package/assets/lithermes-plugin/skills/lit-code/SKILL.md +609 -0
  349. package/assets/lithermes-plugin/skills/lit-code/references/go/README.md +90 -0
  350. package/assets/lithermes-plugin/skills/lit-code/references/go/backend-stack.md +641 -0
  351. package/assets/lithermes-plugin/skills/lit-code/references/go/bootstrap.md +328 -0
  352. package/assets/lithermes-plugin/skills/lit-code/references/go/bubbletea-v2.md +359 -0
  353. package/assets/lithermes-plugin/skills/lit-code/references/go/cobra-stack.md +468 -0
  354. package/assets/lithermes-plugin/skills/lit-code/references/go/concurrency.md +362 -0
  355. package/assets/lithermes-plugin/skills/lit-code/references/go/data-modeling.md +329 -0
  356. package/assets/lithermes-plugin/skills/lit-code/references/go/error-handling.md +359 -0
  357. package/assets/lithermes-plugin/skills/lit-code/references/go/golangci-strict.md +236 -0
  358. package/assets/lithermes-plugin/skills/lit-code/references/go/grpc-connect.md +375 -0
  359. package/assets/lithermes-plugin/skills/lit-code/references/go/libraries.md +337 -0
  360. package/assets/lithermes-plugin/skills/lit-code/references/go/one-liners.md +202 -0
  361. package/assets/lithermes-plugin/skills/lit-code/references/go/sqlc-pgx.md +471 -0
  362. package/assets/lithermes-plugin/skills/lit-code/references/go/testing.md +467 -0
  363. package/assets/lithermes-plugin/skills/lit-code/references/go/type-patterns.md +298 -0
  364. package/assets/lithermes-plugin/skills/lit-code/references/python/README.md +314 -0
  365. package/assets/lithermes-plugin/skills/lit-code/references/python/async-anyio.md +442 -0
  366. package/assets/lithermes-plugin/skills/lit-code/references/python/data-modeling.md +233 -0
  367. package/assets/lithermes-plugin/skills/lit-code/references/python/data-processing.md +133 -0
  368. package/assets/lithermes-plugin/skills/lit-code/references/python/error-handling.md +218 -0
  369. package/assets/lithermes-plugin/skills/lit-code/references/python/fastapi-stack.md +316 -0
  370. package/assets/lithermes-plugin/skills/lit-code/references/python/httpx2-optimization.md +360 -0
  371. package/assets/lithermes-plugin/skills/lit-code/references/python/libraries.md +307 -0
  372. package/assets/lithermes-plugin/skills/lit-code/references/python/one-liners.md +268 -0
  373. package/assets/lithermes-plugin/skills/lit-code/references/python/orjson-stack.md +378 -0
  374. package/assets/lithermes-plugin/skills/lit-code/references/python/pydantic-ai.md +285 -0
  375. package/assets/lithermes-plugin/skills/lit-code/references/python/pyproject-strict.md +232 -0
  376. package/assets/lithermes-plugin/skills/lit-code/references/python/textual-tui.md +201 -0
  377. package/assets/lithermes-plugin/skills/lit-code/references/python/type-patterns.md +176 -0
  378. package/assets/lithermes-plugin/skills/lit-code/references/rust/README.md +317 -0
  379. package/assets/lithermes-plugin/skills/lit-code/references/rust/async-tokio.md +299 -0
  380. package/assets/lithermes-plugin/skills/lit-code/references/rust/axum-stack.md +467 -0
  381. package/assets/lithermes-plugin/skills/lit-code/references/rust/cargo-strict.md +317 -0
  382. package/assets/lithermes-plugin/skills/lit-code/references/rust/clap-stack.md +409 -0
  383. package/assets/lithermes-plugin/skills/lit-code/references/rust/concurrency.md +375 -0
  384. package/assets/lithermes-plugin/skills/lit-code/references/rust/libraries.md +439 -0
  385. package/assets/lithermes-plugin/skills/lit-code/references/rust/one-liners.md +291 -0
  386. package/assets/lithermes-plugin/skills/lit-code/references/rust/proptest-insta.md +429 -0
  387. package/assets/lithermes-plugin/skills/lit-code/references/rust/type-state.md +354 -0
  388. package/assets/lithermes-plugin/skills/lit-code/references/rust/unsafe-discipline.md +250 -0
  389. package/assets/lithermes-plugin/skills/lit-code/references/rust/zero-cost-safety.md +527 -0
  390. package/assets/lithermes-plugin/skills/lit-code/references/rust-ub/README.md +289 -0
  391. package/assets/lithermes-plugin/skills/lit-code/references/rust-ub/miri-sanitizers-loom.md +411 -0
  392. package/assets/lithermes-plugin/skills/lit-code/references/rust-ub/ub-taxonomy.md +269 -0
  393. package/assets/lithermes-plugin/skills/lit-code/references/typescript/README.md +195 -0
  394. package/assets/lithermes-plugin/skills/lit-code/references/typescript/backend-hono.md +672 -0
  395. package/assets/lithermes-plugin/skills/lit-code/references/typescript/bootstrap.md +199 -0
  396. package/assets/lithermes-plugin/skills/lit-code/references/typescript/data-modeling.md +202 -0
  397. package/assets/lithermes-plugin/skills/lit-code/references/typescript/error-handling.md +169 -0
  398. package/assets/lithermes-plugin/skills/lit-code/references/typescript/tsconfig-strict.md +152 -0
  399. package/assets/lithermes-plugin/skills/lit-code/references/typescript/type-patterns.md +196 -0
  400. package/assets/lithermes-plugin/skills/lit-code/scripts/go/check-no-excuse-rules.sh +173 -0
  401. package/assets/lithermes-plugin/skills/lit-code/scripts/go/new-project.py +138 -0
  402. package/assets/lithermes-plugin/skills/lit-code/scripts/go/templates/.editorconfig +13 -0
  403. package/assets/lithermes-plugin/skills/lit-code/scripts/go/templates/.golangci.yml +95 -0
  404. package/assets/lithermes-plugin/skills/lit-code/scripts/go/templates/AGENTS.md.tmpl +24 -0
  405. package/assets/lithermes-plugin/skills/lit-code/scripts/go/templates/README.md.tmpl +12 -0
  406. package/assets/lithermes-plugin/skills/lit-code/scripts/go/templates/Taskfile.yml +40 -0
  407. package/assets/lithermes-plugin/skills/lit-code/scripts/go/templates/ci.yml +37 -0
  408. package/assets/lithermes-plugin/skills/lit-code/scripts/go/templates/config.go +24 -0
  409. package/assets/lithermes-plugin/skills/lit-code/scripts/go/templates/gitignore +15 -0
  410. package/assets/lithermes-plugin/skills/lit-code/scripts/go/templates/main.go.tmpl +22 -0
  411. package/assets/lithermes-plugin/skills/lit-code/scripts/go/templates/run.go +15 -0
  412. package/assets/lithermes-plugin/skills/lit-code/scripts/python/check-no-excuse-rules.py +687 -0
  413. package/assets/lithermes-plugin/skills/lit-code/scripts/python/new-project.py +172 -0
  414. package/assets/lithermes-plugin/skills/lit-code/scripts/python/new-script.py +116 -0
  415. package/assets/lithermes-plugin/skills/lit-code/scripts/rust/check-no-excuse-rules.py +296 -0
  416. package/assets/lithermes-plugin/skills/lit-code/scripts/rust/check-no-excuse-rules.sh +158 -0
  417. package/assets/lithermes-plugin/skills/lit-code/scripts/rust/new-project.py +175 -0
  418. package/assets/lithermes-plugin/skills/lit-code/scripts/typescript/check-no-excuse-rules.ts +282 -0
  419. package/assets/lithermes-plugin/skills/lit-code/scripts/typescript/new-project.ts +177 -0
  420. package/assets/lithermes-plugin/skills/lit-commit/SKILL.md +242 -0
  421. package/assets/lithermes-plugin/skills/lit-comprehend/SKILL.md +259 -0
  422. package/assets/lithermes-plugin/skills/lit-comprehend/assets/explainer-scaffold.html +123 -0
  423. package/assets/lithermes-plugin/skills/lit-comprehend/references/artifact-template.md +205 -0
  424. package/assets/lithermes-plugin/skills/lit-comprehend/references/micro-worlds.md +139 -0
  425. package/assets/lithermes-plugin/skills/lit-comprehend/scripts/verify-explainer.py +324 -0
  426. package/assets/lithermes-plugin/skills/lit-crucible/SKILL.md +315 -0
  427. package/assets/lithermes-plugin/skills/lit-handoff/ORIGIN.json +23 -0
  428. package/assets/lithermes-plugin/skills/lit-handoff/SKILL.md +145 -0
  429. package/assets/lithermes-plugin/skills/lit-init/SKILL.md +329 -0
  430. package/assets/lithermes-plugin/skills/lit-korean/SKILL.md +237 -0
  431. package/assets/lithermes-plugin/skills/lit-korean/references/quick-rules.md +24 -0
  432. package/assets/lithermes-plugin/skills/lit-korean/references/safety-checklist.md +23 -0
  433. package/assets/lithermes-plugin/skills/lit-plan/SKILL.md +596 -0
  434. package/assets/lithermes-plugin/skills/lit-recap/SKILL.md +183 -0
  435. package/assets/lithermes-plugin/skills/lit-scientific-visualization/ORIGIN.json +32 -0
  436. package/assets/lithermes-plugin/skills/lit-scientific-visualization/SKILL.md +170 -0
  437. package/assets/lithermes-plugin/skills/litgoal/.gitkeep +0 -0
  438. package/assets/lithermes-plugin/skills/litgoal/SKILL.md +372 -0
  439. package/assets/lithermes-plugin/skills/litresearch/ATTRIBUTION.md +50 -0
  440. package/assets/lithermes-plugin/skills/litresearch/SKILL.md +593 -0
  441. package/assets/lithermes-plugin/skills/litwork/SKILL.md +419 -0
  442. package/assets/lithermes-plugin/skills/lsp/SKILL.md +165 -0
  443. package/assets/lithermes-plugin/skills/lsp-setup/SKILL.md +265 -0
  444. package/assets/lithermes-plugin/skills/lsp-setup/references/bash/README.md +68 -0
  445. package/assets/lithermes-plugin/skills/lsp-setup/references/c-cpp/README.md +78 -0
  446. package/assets/lithermes-plugin/skills/lsp-setup/references/csharp/README.md +90 -0
  447. package/assets/lithermes-plugin/skills/lsp-setup/references/dart/README.md +59 -0
  448. package/assets/lithermes-plugin/skills/lsp-setup/references/elixir/README.md +61 -0
  449. package/assets/lithermes-plugin/skills/lsp-setup/references/go/README.md +63 -0
  450. package/assets/lithermes-plugin/skills/lsp-setup/references/haskell/README.md +69 -0
  451. package/assets/lithermes-plugin/skills/lsp-setup/references/java/README.md +70 -0
  452. package/assets/lithermes-plugin/skills/lsp-setup/references/julia/README.md +70 -0
  453. package/assets/lithermes-plugin/skills/lsp-setup/references/kotlin/README.md +72 -0
  454. package/assets/lithermes-plugin/skills/lsp-setup/references/lua/README.md +68 -0
  455. package/assets/lithermes-plugin/skills/lsp-setup/references/php/README.md +61 -0
  456. package/assets/lithermes-plugin/skills/lsp-setup/references/python/README.md +73 -0
  457. package/assets/lithermes-plugin/skills/lsp-setup/references/ruby/README.md +67 -0
  458. package/assets/lithermes-plugin/skills/lsp-setup/references/rust/README.md +65 -0
  459. package/assets/lithermes-plugin/skills/lsp-setup/references/swift/README.md +64 -0
  460. package/assets/lithermes-plugin/skills/lsp-setup/references/terraform/README.md +66 -0
  461. package/assets/lithermes-plugin/skills/lsp-setup/references/typescript/README.md +82 -0
  462. package/assets/lithermes-plugin/skills/lsp-setup/references/yaml/README.md +65 -0
  463. package/assets/lithermes-plugin/skills/lsp-setup/references/zig/README.md +59 -0
  464. package/assets/lithermes-plugin/skills/lsp-setup/scripts/detect-lsp.ts +221 -0
  465. package/assets/lithermes-plugin/skills/lsp-setup/scripts/lsp-server-table.ts +146 -0
  466. package/assets/lithermes-plugin/skills/lsp-setup/scripts/tsconfig.json +18 -0
  467. package/assets/lithermes-plugin/skills/lsp-setup/scripts/verify-lsp.ts +252 -0
  468. package/assets/lithermes-plugin/skills/refactor/SKILL.md +896 -0
  469. package/assets/lithermes-plugin/skills/review-work/SKILL.md +450 -0
  470. package/assets/lithermes-plugin/skills/rules/SKILL.md +194 -0
  471. package/assets/lithermes-plugin/skills/skill-observer/SKILL.md +190 -0
  472. package/assets/lithermes-plugin/skills/skill-observer/references/review-contract.md +77 -0
  473. package/assets/lithermes-plugin/skills/start-work/SKILL.md +550 -0
  474. package/assets/lithermes-plugin/skills/structural-search/SKILL.md +274 -0
  475. package/assets/lithermes-plugin/skills/visual-qa/SKILL.md +48 -0
  476. package/assets/lithermes-plugin/skills/visual-qa/references/capture-playbook.md +133 -0
  477. package/assets/lithermes-plugin/skills/visual-qa/references/complete-contract.md +522 -0
  478. package/assets/lithermes-plugin/skills/visual-qa/schemas/evidence-manifest-v1alpha1.schema.json +135 -0
  479. package/assets/lithermes-plugin/skills/visual-qa/schemas/evidence-manifest-v1beta1.schema.json +110 -0
  480. package/assets/lithermes-plugin/skills/visual-qa/schemas/review-receipt-v1alpha1.schema.json +49 -0
  481. package/assets/lithermes-plugin/skills/visual-qa/scripts/contract_checks.py +71 -0
  482. package/assets/lithermes-plugin/skills/visual-qa/scripts/evidence_contract.py +288 -0
  483. package/assets/lithermes-plugin/skills/visual-qa/scripts/png_runtime.py +379 -0
  484. package/assets/lithermes-plugin/skills/visual-qa/scripts/review_contract.py +151 -0
  485. package/assets/lithermes-plugin/skills/visual-qa/scripts/tier_checks.py +190 -0
  486. package/assets/lithermes-plugin/skills/visual-qa/scripts/tier_contract.py +103 -0
  487. package/assets/lithermes-plugin/skills/visual-qa/scripts/tui_runtime.py +170 -0
  488. package/assets/lithermes-plugin/skills/visual-qa/scripts/visual_contracts.py +31 -0
  489. package/assets/lithermes-plugin/skills/visual-qa/scripts/visual_qa.py +79 -0
  490. package/assets/lithermes-plugin/skills/wikify/LICENSE +21 -0
  491. package/assets/lithermes-plugin/skills/wikify/ORIGIN.json +12 -0
  492. package/assets/lithermes-plugin/skills/wikify/SKILL.md +192 -0
  493. package/assets/lithermes-plugin/skills/wikify/assets/home-template.md +44 -0
  494. package/assets/lithermes-plugin/skills/wikify/assets/maintenance-report-template.md +46 -0
  495. package/assets/lithermes-plugin/skills/wikify/assets/paper-source-note-template.md +138 -0
  496. package/assets/lithermes-plugin/skills/wikify/assets/source-note-template.md +45 -0
  497. package/assets/lithermes-plugin/skills/wikify/assets/wiki-rules-template.md +117 -0
  498. package/assets/lithermes-plugin/skills/wikify/modes/ingest/SKILL.md +24 -0
  499. package/assets/lithermes-plugin/skills/wikify/modes/init/SKILL.md +26 -0
  500. package/assets/lithermes-plugin/skills/wikify/modes/lint/SKILL.md +30 -0
  501. package/assets/lithermes-plugin/skills/wikify/modes/query/SKILL.md +22 -0
  502. package/assets/lithermes-plugin/skills/wikify/modes/save/SKILL.md +32 -0
  503. package/assets/lithermes-plugin/skills/wikify/references/full-contract.md +761 -0
  504. package/assets/lithermes-plugin/uiux_runtime_common.py +117 -0
  505. package/assets/lithermes-plugin/vendor/NOTICE.md +21 -0
  506. package/assets/lithermes-plugin/vendor/handoff/SKILL.md +199 -0
  507. package/assets/lithermes-plugin/vendor/handoff/evals/evals.json +154 -0
  508. package/assets/lithermes-plugin/vendor/handoff/examples/HANDOFF-example-generic-auth-refactor.md +97 -0
  509. package/assets/lithermes-plugin/vendor/handoff/templates/HANDOFF.md +121 -0
  510. package/assets/lithermes-plugin/vendor/licenses/022_handoff-MIT.txt +21 -0
  511. package/assets/lithermes-plugin/vendor/licenses/045_scientific-visualization-MIT.txt +21 -0
  512. package/assets/lithermes-plugin/vendor/provenance/022_handoff.md +16 -0
  513. package/assets/lithermes-plugin/vendor/provenance/045_scientific-visualization.md +18 -0
  514. package/assets/lithermes-plugin/vendor/scientific-visualization/SKILL.md +283 -0
  515. package/assets/lithermes-plugin/vendor/scientific-visualization/assets/color_palettes.py +197 -0
  516. package/assets/lithermes-plugin/vendor/scientific-visualization/assets/nature.mplstyle +75 -0
  517. package/assets/lithermes-plugin/vendor/scientific-visualization/assets/presentation.mplstyle +74 -0
  518. package/assets/lithermes-plugin/vendor/scientific-visualization/assets/publication.mplstyle +78 -0
  519. package/assets/lithermes-plugin/vendor/scientific-visualization/evals/evals.json +158 -0
  520. package/assets/lithermes-plugin/vendor/scientific-visualization/references/color_palettes.md +380 -0
  521. package/assets/lithermes-plugin/vendor/scientific-visualization/references/journal_requirements.md +359 -0
  522. package/assets/lithermes-plugin/vendor/scientific-visualization/references/matplotlib_examples.md +608 -0
  523. package/assets/lithermes-plugin/vendor/scientific-visualization/references/mdanalysis_martini_visualization.md +85 -0
  524. package/assets/lithermes-plugin/vendor/scientific-visualization/references/publication_guidelines.md +217 -0
  525. package/assets/lithermes-plugin/vendor/scientific-visualization/references/seaborn_for_publications.md +293 -0
  526. package/assets/lithermes-plugin/vendor/scientific-visualization/scripts/figure_export.py +238 -0
  527. package/assets/lithermes-plugin/vendor/scientific-visualization/scripts/style_presets.py +467 -0
  528. package/assets/lithermes-plugin/vendor/scientific-visualization/tests/test_figure_export.py +51 -0
  529. package/assets/lithermes-plugin/vendor/scientific-visualization/tests/test_style_presets.py +114 -0
  530. package/bin/lithermes.js +8 -0
  531. package/package.json +58 -0
  532. package/readme-assets/badge-license.svg +1 -0
  533. package/readme-assets/badge-version.svg +1 -0
  534. package/readme-assets/cover.webp +0 -0
  535. package/readme-assets/lithermes-clay-icon.png +0 -0
  536. package/readme-assets/lithermes-wordmark.svg +5 -0
  537. package/src/cli.js +396 -0
  538. package/src/lib/autoUpdate.js +4 -0
  539. package/src/lib/canonicalCorpus.js +436 -0
  540. package/src/lib/check.js +200 -0
  541. package/src/lib/config.js +229 -0
  542. package/src/lib/files.js +126 -0
  543. package/src/lib/hermesDiscovery.js +122 -0
  544. package/src/lib/hud.js +135 -0
  545. package/src/lib/install.js +559 -0
  546. package/src/lib/litMark.js +68 -0
  547. package/src/lib/modelConfig.js +431 -0
  548. package/src/lib/modelConfigBoundary.js +206 -0
  549. package/src/lib/modelPrompt.js +201 -0
  550. package/src/lib/modelRoutePolicy.js +379 -0
  551. package/src/lib/patch.js +153 -0
  552. package/src/lib/skillLoop.js +62 -0
  553. package/src/lib/skillPayload.js +306 -0
  554. package/src/lib/skins.js +274 -0
  555. package/src/lib/spinner.js +193 -0
  556. package/src/lib/updateNotifier.js +1133 -0
  557. package/src/lib/updateNotifierWorker.js +9 -0
@@ -0,0 +1,238 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Figure Export Utilities for Publication-Ready Scientific Figures
4
+
5
+ Exports matplotlib figures in publication-ready formats.
6
+ Default raster DPI is 600 (must be > 500 per project requirements). Vector
7
+ formats remain editable; DPI only affects rasterized artists embedded in them.
8
+ """
9
+
10
+ import matplotlib.pyplot as plt
11
+ from pathlib import Path
12
+ from typing import List, Optional, Union
13
+
14
+
15
+ def save_publication_figure(
16
+ fig: plt.Figure,
17
+ filename: Union[str, Path],
18
+ formats: Optional[List[str]] = None,
19
+ dpi: int = 600,
20
+ transparent: bool = True,
21
+ bbox_inches: str = 'tight',
22
+ pad_inches: float = 0.1,
23
+ facecolor: str = 'white',
24
+ **kwargs
25
+ ) -> List[Path]:
26
+ """
27
+ Save a matplotlib figure in multiple formats with publication-quality settings.
28
+
29
+ Parameters
30
+ ----------
31
+ fig : matplotlib.figure.Figure
32
+ The figure to save
33
+ filename : str or Path
34
+ Base filename (without extension)
35
+ formats : list of str, default ['pdf', 'png']
36
+ List of file formats to save. Options: 'pdf', 'png', 'eps', 'svg', 'tiff'
37
+ dpi : int, default 600
38
+ Resolution for raster formats (png, tiff). Must be > 500.
39
+ transparent : bool, default True
40
+ If True, save with transparent background. Journal-specific exports
41
+ override this to False unless explicitly changed.
42
+ bbox_inches : str, default 'tight'
43
+ Bounding box specification. 'tight' removes excess whitespace
44
+ pad_inches : float, default 0.1
45
+ Padding around the figure when bbox_inches='tight'
46
+ facecolor : str, default 'white'
47
+ Background color (ignored if transparent=True)
48
+ **kwargs
49
+ Additional keyword arguments passed to fig.savefig()
50
+
51
+ Returns
52
+ -------
53
+ list of Path
54
+ List of paths to saved files
55
+ """
56
+ if formats is None:
57
+ formats = ['pdf', 'png']
58
+
59
+ filename = Path(filename)
60
+ base_name = filename.stem
61
+ output_dir = filename.parent
62
+ if not output_dir.exists():
63
+ raise FileNotFoundError(f"Output directory does not exist: {output_dir}")
64
+
65
+ saved_files = []
66
+
67
+ for fmt in formats:
68
+ output_file = output_dir / f"{base_name}.{fmt}"
69
+
70
+ save_kwargs = {
71
+ 'dpi': dpi,
72
+ 'bbox_inches': bbox_inches,
73
+ 'pad_inches': pad_inches,
74
+ 'facecolor': facecolor if not transparent else 'none',
75
+ 'edgecolor': 'none',
76
+ 'transparent': transparent,
77
+ 'format': fmt,
78
+ }
79
+
80
+ save_kwargs.update(kwargs)
81
+
82
+ try:
83
+ fig.savefig(output_file, **save_kwargs)
84
+ saved_files.append(output_file)
85
+ print(f"Saved: {output_file}")
86
+ except Exception as e:
87
+ print(f"Failed to save {output_file}: {e}")
88
+
89
+ return saved_files
90
+
91
+
92
+ def save_for_journal(
93
+ fig: plt.Figure,
94
+ filename: Union[str, Path],
95
+ journal: str,
96
+ figure_type: str = 'combination'
97
+ ) -> List[Path]:
98
+ """
99
+ Save figure with journal-specific requirements.
100
+
101
+ Parameters
102
+ ----------
103
+ fig : matplotlib.figure.Figure
104
+ The figure to save
105
+ filename : str or Path
106
+ Base filename (without extension)
107
+ journal : str
108
+ Journal name. Options: 'nature', 'science', 'cell', 'plos', 'acs', 'ieee'
109
+ figure_type : str, default 'combination'
110
+ Type of figure. Options: 'line_art', 'photo', 'combination'
111
+
112
+ Returns
113
+ -------
114
+ list of Path
115
+ List of paths to saved files
116
+ """
117
+ journal = journal.lower()
118
+
119
+ journal_specs = {
120
+ 'nature': {
121
+ 'line_art': {'formats': ['pdf', 'eps'], 'dpi': 1000},
122
+ 'photo': {'formats': ['tiff'], 'dpi': 600},
123
+ 'combination': {'formats': ['pdf'], 'dpi': 600},
124
+ },
125
+ 'science': {
126
+ 'line_art': {'formats': ['eps', 'pdf'], 'dpi': 1000},
127
+ 'photo': {'formats': ['tiff'], 'dpi': 600},
128
+ 'combination': {'formats': ['eps'], 'dpi': 600},
129
+ },
130
+ 'cell': {
131
+ 'line_art': {'formats': ['pdf', 'eps'], 'dpi': 1000},
132
+ 'photo': {'formats': ['tiff'], 'dpi': 600},
133
+ 'combination': {'formats': ['pdf'], 'dpi': 600},
134
+ },
135
+ 'plos': {
136
+ 'line_art': {'formats': ['pdf', 'eps'], 'dpi': 600},
137
+ 'photo': {'formats': ['tiff', 'png'], 'dpi': 600},
138
+ 'combination': {'formats': ['tiff'], 'dpi': 600},
139
+ },
140
+ 'acs': {
141
+ 'line_art': {'formats': ['tiff', 'pdf'], 'dpi': 600},
142
+ 'photo': {'formats': ['tiff'], 'dpi': 600},
143
+ 'combination': {'formats': ['tiff'], 'dpi': 600},
144
+ },
145
+ 'ieee': {
146
+ 'line_art': {'formats': ['pdf', 'eps'], 'dpi': 600},
147
+ 'photo': {'formats': ['tiff'], 'dpi': 600},
148
+ 'combination': {'formats': ['pdf'], 'dpi': 600},
149
+ },
150
+ }
151
+
152
+ if journal not in journal_specs:
153
+ available = ', '.join(journal_specs.keys())
154
+ raise ValueError(f"Journal '{journal}' not recognized. Available: {available}")
155
+
156
+ if figure_type not in journal_specs[journal]:
157
+ available = ', '.join(journal_specs[journal].keys())
158
+ raise ValueError(f"Figure type '{figure_type}' not valid. Available: {available}")
159
+
160
+ specs = journal_specs[journal][figure_type]
161
+
162
+ return save_publication_figure(
163
+ fig=fig,
164
+ filename=filename,
165
+ formats=specs['formats'],
166
+ dpi=specs['dpi'],
167
+ transparent=False,
168
+ facecolor='white'
169
+ )
170
+
171
+
172
+ def check_figure_size(fig: plt.Figure, journal: str = 'nature') -> dict:
173
+ """
174
+ Check if figure dimensions are appropriate for journal requirements.
175
+
176
+ Parameters
177
+ ----------
178
+ fig : matplotlib.figure.Figure
179
+ The figure to check
180
+ journal : str, default 'nature'
181
+ Journal name
182
+
183
+ Returns
184
+ -------
185
+ dict
186
+ Dictionary with figure dimensions and compliance status
187
+ """
188
+ journal = journal.lower()
189
+
190
+ width_inches, height_inches = fig.get_size_inches()
191
+ width_mm = width_inches * 25.4
192
+ height_mm = height_inches * 25.4
193
+
194
+ specs = {
195
+ 'nature': {'single': 89, 'one_half': 120, 'double': 183, 'max_height': 247},
196
+ 'science': {'single': 55, 'one_half': 120, 'double': 175, 'max_height': 233},
197
+ 'cell': {'single': 85, 'double': 178, 'max_height': 230},
198
+ 'plos': {'single': 83, 'one_half': 114, 'double': 173, 'max_height': 233},
199
+ 'acs': {'single': 82.5, 'double': 178, 'max_height': 247},
200
+ 'ieee': {'single': 89, 'double': 182, 'max_height': 247},
201
+ }
202
+
203
+ if journal not in specs:
204
+ journal_spec = specs['nature']
205
+ else:
206
+ journal_spec = specs[journal]
207
+
208
+ column_type = None
209
+ width_ok = False
210
+
211
+ tolerance = 5 # mm
212
+ for width_name in ('single', 'one_half', 'double'):
213
+ if width_name in journal_spec and abs(width_mm - journal_spec[width_name]) < tolerance:
214
+ column_type = width_name
215
+ width_ok = True
216
+ break
217
+
218
+ height_ok = height_mm <= journal_spec['max_height']
219
+
220
+ result = {
221
+ 'width_inches': width_inches,
222
+ 'height_inches': height_inches,
223
+ 'width_mm': width_mm,
224
+ 'height_mm': height_mm,
225
+ 'journal': journal,
226
+ 'column_type': column_type,
227
+ 'width_ok': width_ok,
228
+ 'height_ok': height_ok,
229
+ 'compliant': width_ok and height_ok,
230
+ 'recommendations': {
231
+ 'single_column_mm': journal_spec['single'],
232
+ 'one_half_column_mm': journal_spec.get('one_half'),
233
+ 'double_column_mm': journal_spec['double'],
234
+ 'max_height_mm': journal_spec['max_height'],
235
+ }
236
+ }
237
+
238
+ return result
@@ -0,0 +1,467 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Matplotlib Style Presets for Publication-Ready Scientific Figures
4
+
5
+ Primary style is set via rcparams(), which configures Pretendard first, Arial
6
+ fallback second, emergency system font fallbacks after that, inward ticks with
7
+ minor ticks visible, grids off, transparent tight generic export, and
8
+ publication-appropriate sizing.
9
+ """
10
+
11
+ import matplotlib.pyplot as plt
12
+ import matplotlib as mpl
13
+ from matplotlib import rcParams
14
+ from matplotlib import font_manager
15
+ from typing import Optional, Dict, Any, Tuple
16
+
17
+
18
+ # Okabe-Ito colorblind-friendly palette
19
+ OKABE_ITO_COLORS = [
20
+ '#E69F00', # Orange
21
+ '#56B4E9', # Sky Blue
22
+ '#009E73', # Bluish Green
23
+ '#F0E442', # Yellow
24
+ '#0072B2', # Blue
25
+ '#D55E00', # Vermillion
26
+ '#CC79A7', # Reddish Purple
27
+ '#000000' # Black
28
+ ]
29
+
30
+ # Paul Tol palettes
31
+ TOL_BRIGHT = ['#4477AA', '#EE6677', '#228833', '#CCBB44', '#66CCEE', '#AA3377', '#BBBBBB']
32
+ TOL_MUTED = ['#332288', '#88CCEE', '#44AA99', '#117733', '#999933', '#DDCC77', '#CC6677', '#882255', '#AA4499']
33
+ TOL_HIGH_CONTRAST = ['#004488', '#DDAA33', '#BB5566']
34
+
35
+ # Wong palette
36
+ WONG_COLORS = ['#000000', '#E69F00', '#56B4E9', '#009E73', '#F0E442', '#0072B2', '#D55E00', '#CC79A7']
37
+
38
+ PREFERRED_FONT_STACK = [
39
+ 'Pretendard',
40
+ 'Arial',
41
+ 'Helvetica',
42
+ 'DejaVu Sans',
43
+ 'AppleGothic',
44
+ 'Noto Sans CJK KR',
45
+ 'Noto Sans CJK SC',
46
+ 'Noto Sans CJK JP',
47
+ 'Malgun Gothic',
48
+ ]
49
+
50
+ JOURNAL_CONFIGS = {
51
+ 'nature': {
52
+ 'widths': {'single': 89, 'one_half': 120, 'double': 183},
53
+ 'max_height': 247,
54
+ 'style': 'nature',
55
+ },
56
+ 'science': {
57
+ 'widths': {'single': 55, 'one_half': 120, 'double': 175},
58
+ 'max_height': 233,
59
+ 'style': 'science',
60
+ },
61
+ 'cell': {
62
+ 'widths': {'single': 85, 'double': 178},
63
+ 'max_height': 230,
64
+ 'style': 'cell',
65
+ },
66
+ 'plos': {
67
+ 'widths': {'single': 83, 'one_half': 114, 'double': 173},
68
+ 'max_height': 233,
69
+ 'style': 'default',
70
+ },
71
+ 'acs': {
72
+ 'widths': {'single': 82.5, 'double': 178},
73
+ 'max_height': 247,
74
+ 'style': 'default',
75
+ },
76
+ 'ieee': {
77
+ 'widths': {'single': 89, 'double': 182},
78
+ 'max_height': 247,
79
+ 'style': 'default',
80
+ },
81
+ }
82
+
83
+
84
+ def _available_preferred_fonts() -> list:
85
+ """Return installed fonts from the preferred publication fallback stack."""
86
+ available_fonts = {f.name for f in font_manager.fontManager.ttflist}
87
+ installed = [name for name in PREFERRED_FONT_STACK if name in available_fonts]
88
+ return installed or PREFERRED_FONT_STACK
89
+
90
+
91
+ def rcparams():
92
+ """
93
+ Apply the canonical publication style. This is the primary style function
94
+ that must be called at the start of every figure script.
95
+
96
+ Sets Pretendard first and Arial fallback second, then emergency system
97
+ fallbacks, inward ticks with minor ticks, and publication-appropriate font
98
+ sizes.
99
+ """
100
+ rcParams['figure.figsize'] = 5, 4
101
+ rcParams['font.family'] = 'sans-serif'
102
+
103
+ rcParams['font.sans-serif'] = _available_preferred_fonts()
104
+ rcParams['pdf.fonttype'] = 42
105
+ rcParams['ps.fonttype'] = 42
106
+ rcParams['svg.fonttype'] = 'none'
107
+
108
+ # Label should be far away from the axes
109
+ rcParams['axes.labelpad'] = 8
110
+ rcParams['xtick.major.pad'] = 7
111
+ rcParams['ytick.major.pad'] = 7
112
+
113
+ # Add minor ticks
114
+ rcParams['xtick.minor.visible'] = True
115
+ rcParams['ytick.minor.visible'] = True
116
+
117
+ # Tick width
118
+ rcParams['xtick.major.width'] = 1
119
+ rcParams['ytick.major.width'] = 1
120
+ rcParams['xtick.minor.width'] = 0.5
121
+ rcParams['ytick.minor.width'] = 0.5
122
+
123
+ # Tick length
124
+ rcParams['xtick.major.size'] = 5
125
+ rcParams['ytick.major.size'] = 5
126
+ rcParams['xtick.minor.size'] = 3
127
+ rcParams['ytick.minor.size'] = 3
128
+
129
+ # Tick color
130
+ rcParams['xtick.color'] = 'black'
131
+ rcParams['ytick.color'] = 'black'
132
+
133
+ rcParams['font.size'] = 14
134
+ rcParams['axes.titlepad'] = 10
135
+ rcParams['axes.titleweight'] = 'normal'
136
+ rcParams['axes.titlesize'] = 18
137
+
138
+ # Axes settings
139
+ rcParams['axes.labelweight'] = 'normal'
140
+ rcParams['xtick.labelsize'] = 12
141
+ rcParams['ytick.labelsize'] = 12
142
+ rcParams['axes.labelsize'] = 16
143
+ rcParams['xtick.direction'] = 'in'
144
+ rcParams['ytick.direction'] = 'in'
145
+
146
+ # Additional publication defaults
147
+ rcParams['axes.linewidth'] = 1
148
+ rcParams['axes.edgecolor'] = 'black'
149
+ rcParams['axes.labelcolor'] = 'black'
150
+ rcParams['axes.axisbelow'] = True
151
+ rcParams['axes.grid'] = False
152
+ rcParams['axes.prop_cycle'] = mpl.cycler(color=OKABE_ITO_COLORS)
153
+
154
+ # Figure
155
+ rcParams['figure.dpi'] = 100
156
+ rcParams['figure.facecolor'] = 'white'
157
+ rcParams['figure.autolayout'] = False
158
+
159
+ # Lines
160
+ rcParams['lines.linewidth'] = 1.5
161
+ rcParams['lines.markersize'] = 5
162
+ rcParams['lines.markeredgewidth'] = 0.5
163
+
164
+ # Legend — black border, fully opaque
165
+ rcParams['legend.fontsize'] = 12
166
+ rcParams['legend.frameon'] = True
167
+ rcParams['legend.edgecolor'] = 'black'
168
+ rcParams['legend.framealpha'] = 1
169
+ rcParams['legend.loc'] = 'best'
170
+
171
+ # Savefig — DPI > 500
172
+ rcParams['savefig.dpi'] = 600
173
+ rcParams['savefig.format'] = 'pdf'
174
+ rcParams['savefig.bbox'] = 'tight'
175
+ rcParams['savefig.pad_inches'] = 0.05
176
+ rcParams['savefig.transparent'] = True
177
+ rcParams['savefig.facecolor'] = 'none'
178
+
179
+ # Image
180
+ rcParams['image.cmap'] = 'viridis'
181
+ rcParams['image.aspect'] = 'auto'
182
+
183
+
184
+ # Keep backward compatibility
185
+ def apply_publication_style(style_name: str = 'default') -> None:
186
+ """
187
+ Apply a pre-configured publication style.
188
+
189
+ Calls rcparams() first, then applies journal-specific overrides.
190
+
191
+ Parameters
192
+ ----------
193
+ style_name : str, default 'default'
194
+ Name of the style to apply. Options:
195
+ - 'default': General publication style (rcparams)
196
+ - 'nature': Nature journal style
197
+ - 'science': Science journal style
198
+ - 'cell': Cell Press style
199
+ - 'minimal': Minimal clean style
200
+ - 'presentation': Larger fonts for presentations
201
+ """
202
+ # Always start from rcparams base
203
+ rcparams()
204
+
205
+ # Style-specific modifications (overlaid on rcparams)
206
+ if style_name == 'nature':
207
+ mpl.rcParams.update({
208
+ 'font.size': 7,
209
+ 'axes.labelsize': 8,
210
+ 'axes.titlesize': 8,
211
+ 'xtick.labelsize': 6,
212
+ 'ytick.labelsize': 6,
213
+ 'legend.fontsize': 6,
214
+ 'savefig.transparent': False,
215
+ 'savefig.facecolor': 'white',
216
+ })
217
+
218
+ elif style_name == 'science':
219
+ mpl.rcParams.update({
220
+ 'font.size': 7,
221
+ 'axes.labelsize': 8,
222
+ 'xtick.labelsize': 6,
223
+ 'ytick.labelsize': 6,
224
+ 'legend.fontsize': 6,
225
+ 'savefig.transparent': False,
226
+ 'savefig.facecolor': 'white',
227
+ })
228
+
229
+ elif style_name == 'cell':
230
+ mpl.rcParams.update({
231
+ 'font.size': 8,
232
+ 'axes.labelsize': 9,
233
+ 'xtick.labelsize': 7,
234
+ 'ytick.labelsize': 7,
235
+ 'legend.fontsize': 7,
236
+ 'savefig.transparent': False,
237
+ 'savefig.facecolor': 'white',
238
+ })
239
+
240
+ elif style_name == 'minimal':
241
+ mpl.rcParams.update({
242
+ 'axes.linewidth': 0.8,
243
+ 'lines.linewidth': 2,
244
+ })
245
+
246
+ elif style_name == 'presentation':
247
+ mpl.rcParams.update({
248
+ 'font.size': 14,
249
+ 'axes.labelsize': 16,
250
+ 'axes.titlesize': 18,
251
+ 'xtick.labelsize': 12,
252
+ 'ytick.labelsize': 12,
253
+ 'legend.fontsize': 12,
254
+ 'axes.linewidth': 1.5,
255
+ 'lines.linewidth': 2.5,
256
+ 'lines.markersize': 8,
257
+ })
258
+
259
+ elif style_name != 'default':
260
+ print(f"Warning: Style '{style_name}' not recognized. Using 'default'.")
261
+
262
+
263
+ def set_color_palette(palette_name: str = 'okabe_ito') -> None:
264
+ """
265
+ Set a colorblind-friendly color palette.
266
+
267
+ Parameters
268
+ ----------
269
+ palette_name : str, default 'okabe_ito'
270
+ Name of the palette. Options:
271
+ 'okabe_ito', 'wong', 'tol_bright', 'tol_muted', 'tol_high_contrast'
272
+ """
273
+ palettes = {
274
+ 'okabe_ito': OKABE_ITO_COLORS,
275
+ 'wong': WONG_COLORS,
276
+ 'tol_bright': TOL_BRIGHT,
277
+ 'tol_muted': TOL_MUTED,
278
+ 'tol_high_contrast': TOL_HIGH_CONTRAST,
279
+ }
280
+
281
+ if palette_name not in palettes:
282
+ available = ', '.join(palettes.keys())
283
+ print(f"Warning: Palette '{palette_name}' not found. Available: {available}")
284
+ palette_name = 'okabe_ito'
285
+
286
+ colors = palettes[palette_name]
287
+ plt.rcParams['axes.prop_cycle'] = plt.cycler(color=colors)
288
+
289
+
290
+ def figure_size_for_journal(
291
+ journal: str,
292
+ figure_width: str = 'single',
293
+ aspect: float = 0.75,
294
+ ) -> Tuple[float, float]:
295
+ """
296
+ Return a journal-safe figure size in inches.
297
+
298
+ Parameters
299
+ ----------
300
+ journal : str
301
+ Journal name: 'nature', 'science', 'cell', 'plos', 'acs', 'ieee'
302
+ figure_width : str, default 'single'
303
+ Figure width: 'single', 'one_half' where supported, or 'double'
304
+ aspect : float, default 0.75
305
+ Height / width ratio before max-height clipping.
306
+ """
307
+ journal = journal.lower()
308
+ if journal not in JOURNAL_CONFIGS:
309
+ available = ', '.join(JOURNAL_CONFIGS.keys())
310
+ raise ValueError(f"Journal '{journal}' not recognized. Available: {available}")
311
+
312
+ config = JOURNAL_CONFIGS[journal]
313
+ widths = config['widths']
314
+ if figure_width not in widths:
315
+ available = ', '.join(widths.keys())
316
+ raise ValueError(f"Figure width '{figure_width}' not valid for {journal}. Available: {available}")
317
+
318
+ width_inches = widths[figure_width] / 25.4
319
+ max_height_inches = config['max_height'] / 25.4
320
+ height_inches = min(width_inches * aspect, max_height_inches)
321
+ return width_inches, height_inches
322
+
323
+
324
+ def configure_for_journal(journal: str, figure_width: str = 'single', aspect: float = 0.75) -> None:
325
+ """
326
+ Configure matplotlib for a specific journal.
327
+
328
+ Calls rcparams() first, then applies journal-specific size and font overrides.
329
+
330
+ Parameters
331
+ ----------
332
+ journal : str
333
+ Journal name: 'nature', 'science', 'cell', 'plos', 'acs', 'ieee'
334
+ figure_width : str, default 'single'
335
+ Figure width: 'single', 'one_half' where supported, or 'double' column
336
+ aspect : float, default 0.75
337
+ Height / width ratio before max-height clipping
338
+ """
339
+ journal = journal.lower()
340
+
341
+ if journal not in JOURNAL_CONFIGS:
342
+ available = ', '.join(JOURNAL_CONFIGS.keys())
343
+ raise ValueError(f"Journal '{journal}' not recognized. Available: {available}")
344
+
345
+ config = JOURNAL_CONFIGS[journal]
346
+
347
+ # Apply style (which calls rcparams() internally)
348
+ apply_publication_style(config['style'])
349
+
350
+ plt.rcParams['figure.figsize'] = figure_size_for_journal(journal, figure_width, aspect)
351
+
352
+
353
+ def ensure_zero_origin_ticks(ax, x: bool = False, y: bool = False, nbins: int = 5) -> None:
354
+ """Ensure axes that start at zero also have their first major tick at zero."""
355
+ locator = mpl.ticker.MaxNLocator(nbins=max(1, nbins - 1))
356
+
357
+ def ticks_from_zero(upper):
358
+ if upper <= 0:
359
+ return [0]
360
+ ticks = [tick for tick in locator.tick_values(0, upper) if 0 <= tick <= upper]
361
+ if not ticks or abs(ticks[0]) > 1e-12:
362
+ ticks.insert(0, 0)
363
+ if ticks[-1] < upper and len(ticks) < nbins + 1:
364
+ ticks.append(upper)
365
+ return ticks
366
+
367
+ if x:
368
+ left, right = ax.get_xlim()
369
+ if abs(left) <= 1e-12:
370
+ ax.set_xticks(ticks_from_zero(right))
371
+ ax.set_xlim(0, right)
372
+
373
+ if y:
374
+ bottom, top = ax.get_ylim()
375
+ if abs(bottom) <= 1e-12:
376
+ ax.set_yticks(ticks_from_zero(top))
377
+ ax.set_ylim(0, top)
378
+
379
+
380
+ def _artist_color(artist):
381
+ if hasattr(artist, 'get_color'):
382
+ return artist.get_color()
383
+ if hasattr(artist, 'get_facecolor'):
384
+ colors = artist.get_facecolor()
385
+ try:
386
+ if len(colors) == 4 and not hasattr(colors[0], '__len__'):
387
+ return tuple(colors)
388
+ if len(colors):
389
+ first = colors[0]
390
+ return tuple(first) if hasattr(first, '__len__') else tuple(colors)
391
+ except TypeError:
392
+ return colors
393
+ return 'black'
394
+
395
+
396
+ def style_legend(ax, color_text: bool = False, outside: bool = False, **kwargs):
397
+ """
398
+ Create a publication-safe legend with black border and optional colored text.
399
+
400
+ Nature-style output should keep legend text black and use colored handles;
401
+ set ``color_text=True`` only when the target style explicitly wants colored
402
+ legend labels.
403
+ """
404
+ legend_kwargs = {
405
+ 'frameon': True,
406
+ 'edgecolor': 'black',
407
+ 'framealpha': 1,
408
+ }
409
+ if outside:
410
+ legend_kwargs.update({'loc': 'center left', 'bbox_to_anchor': (1.02, 0.5), 'borderaxespad': 0})
411
+ legend_kwargs.update(kwargs)
412
+
413
+ legend = ax.legend(**legend_kwargs)
414
+ legend.get_frame().set_edgecolor('black')
415
+ legend.get_frame().set_alpha(1)
416
+ handles = getattr(legend, 'legend_handles', None) or getattr(legend, 'legendHandles', None)
417
+ if handles is None:
418
+ handles, _ = ax.get_legend_handles_labels()
419
+ for text, handle in zip(legend.get_texts(), handles):
420
+ text.set_color(_artist_color(handle) if color_text else 'black')
421
+ return legend
422
+
423
+
424
+ def plot_scatter_only(ax, x, y, **kwargs):
425
+ """
426
+ Plot independent observations as scatter only, with no connecting lines.
427
+
428
+ Use this for unordered observations, replicate clouds, correlations,
429
+ embeddings, and other point data where connecting observations would imply
430
+ a trajectory or interpolation that is not scientifically justified.
431
+ """
432
+ kwargs.setdefault('edgecolors', 'none')
433
+ return ax.scatter(x, y, **kwargs)
434
+
435
+
436
+ def reset_to_default() -> None:
437
+ """Reset matplotlib to default settings."""
438
+ mpl.rcdefaults()
439
+
440
+
441
+ def show_color_palettes() -> None:
442
+ """Display available color palettes for visual inspection."""
443
+ palettes = {
444
+ 'Okabe-Ito': OKABE_ITO_COLORS,
445
+ 'Wong': WONG_COLORS,
446
+ 'Tol Bright': TOL_BRIGHT,
447
+ 'Tol Muted': TOL_MUTED,
448
+ 'Tol High Contrast': TOL_HIGH_CONTRAST,
449
+ }
450
+
451
+ fig, axes = plt.subplots(len(palettes), 1, figsize=(8, len(palettes) * 0.5))
452
+
453
+ for ax, (name, colors) in zip(axes, palettes.items()):
454
+ ax.set_xlim(0, len(colors))
455
+ ax.set_ylim(0, 1)
456
+ ax.set_yticks([])
457
+ ax.set_xticks([])
458
+ ax.set_ylabel(name, fontsize=10)
459
+
460
+ for i, color in enumerate(colors):
461
+ ax.add_patch(plt.Rectangle((i, 0), 1, 1, facecolor=color, edgecolor='black', linewidth=0.5))
462
+ ax.text(i + 0.5, 0.5, color, ha='center', va='center',
463
+ fontsize=7, color='white' if i >= len(colors) - 1 else 'black')
464
+
465
+ fig.suptitle('Colorblind-Friendly Palettes', fontsize=12, fontweight='bold')
466
+ plt.tight_layout()
467
+ plt.show()