exonous 0.0.0-stage → 2.10.4

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 (385) hide show
  1. package/README.md +100 -2
  2. package/assets/THIRD-PARTY-NOTICES.md +29 -0
  3. package/assets/adapters/opencode/exonous.js +54 -0
  4. package/assets/agents/exo-backend.md +22 -0
  5. package/assets/agents/exo-cto.md +22 -0
  6. package/assets/agents/exo-data-ai.md +22 -0
  7. package/assets/agents/exo-designer.md +22 -0
  8. package/assets/agents/exo-devops.md +22 -0
  9. package/assets/agents/exo-frontend.md +22 -0
  10. package/assets/agents/exo-infra.md +22 -0
  11. package/assets/agents/exo-mobile.md +22 -0
  12. package/assets/agents/exo-pm.md +22 -0
  13. package/assets/agents/exo-qa.md +22 -0
  14. package/assets/agents/exo-researcher.md +22 -0
  15. package/assets/agents/exo-security.md +22 -0
  16. package/assets/agents/roster.json +209 -0
  17. package/assets/agents/taxis.js +189 -0
  18. package/assets/editors/cursor/frontend-skills.mdc +27 -0
  19. package/assets/editors/hooks/cursor/hooks.json +11 -0
  20. package/assets/machine/PR-TEMPLATE.md +21 -0
  21. package/assets/machine/hooks/anamnesis.cjs +61 -0
  22. package/assets/machine/hooks/ethos.cjs +48 -0
  23. package/assets/machine/hooks/kairos.cjs +46 -0
  24. package/assets/machine/hooks/lib/cli-options.cjs +133 -0
  25. package/assets/machine/hooks/lib/memory.cjs +488 -0
  26. package/assets/machine/hooks/lib/metron.cjs +52 -0
  27. package/assets/machine/hooks/lib/paths.cjs +99 -0
  28. package/assets/machine/hooks/lib/payload.cjs +81 -0
  29. package/assets/machine/hooks/lib/pr-template-validate.cjs +103 -0
  30. package/assets/machine/hooks/lib/release.cjs +58 -0
  31. package/assets/machine/hooks/lib/repo.cjs +138 -0
  32. package/assets/machine/hooks/lib/sanitize.cjs +37 -0
  33. package/assets/machine/hooks/lib/selfupdate.cjs +354 -0
  34. package/assets/machine/hooks/lib/shell.cjs +722 -0
  35. package/assets/machine/hooks/lib/template.cjs +70 -0
  36. package/assets/machine/hooks/lib/token.cjs +110 -0
  37. package/assets/machine/hooks/lib/validate-pr-body.cjs +21 -0
  38. package/assets/machine/hooks/pyle.cjs +302 -0
  39. package/assets/rules/nomos.md +59 -0
  40. package/assets/rules/praxis.md +38 -0
  41. package/assets/skills/code-review/SKILL.md +124 -0
  42. package/assets/skills/commit-changes/SKILL.md +49 -0
  43. package/assets/skills/deliver/SKILL.md +114 -0
  44. package/assets/skills/deliver/references/parallel.md +37 -0
  45. package/assets/skills/doc/SKILL.md +140 -0
  46. package/assets/skills/doc/doc.mjs +277 -0
  47. package/assets/skills/issue-board/SKILL.md +84 -0
  48. package/assets/skills/issue-board/board.mjs +389 -0
  49. package/assets/skills/issue-board/config.example.json +9 -0
  50. package/assets/skills/issue-board/render.py +189 -0
  51. package/assets/skills/make-pr/SKILL.md +24 -0
  52. package/assets/skills/native-ui/SKILL.md +67 -0
  53. package/assets/skills/native-ui/reference/apple.md +180 -0
  54. package/assets/skills/native-ui/reference/mobile-feel.md +221 -0
  55. package/assets/skills/native-ui/reference/swift.md +289 -0
  56. package/assets/skills/project-memory/SKILL.md +59 -0
  57. package/assets/skills/project-memory/config.example.json +4 -0
  58. package/assets/skills/project-memory/project-memory.mjs +478 -0
  59. package/assets/skills/security-review/SKILL.md +102 -0
  60. package/assets/skills/session-handoff/SKILL.md +23 -0
  61. package/assets/skills/session-handoff/config.example.json +3 -0
  62. package/assets/skills/ui-design/SKILL.md +75 -0
  63. package/assets/skills/ui-design/reference/adapt.md +151 -0
  64. package/assets/skills/ui-design/reference/adapt.native.md +35 -0
  65. package/assets/skills/ui-design/reference/android.md +50 -0
  66. package/assets/skills/ui-design/reference/animate.md +87 -0
  67. package/assets/skills/ui-design/reference/audit.md +76 -0
  68. package/assets/skills/ui-design/reference/audit.native.md +126 -0
  69. package/assets/skills/ui-design/reference/bolder.md +33 -0
  70. package/assets/skills/ui-design/reference/clarify.md +84 -0
  71. package/assets/skills/ui-design/reference/colorize.md +86 -0
  72. package/assets/skills/ui-design/reference/craft-floor.md +25 -0
  73. package/assets/skills/ui-design/reference/critique.md +345 -0
  74. package/assets/skills/ui-design/reference/degraded/asset-producer.md +35 -0
  75. package/assets/skills/ui-design/reference/degraded/documenter.md +23 -0
  76. package/assets/skills/ui-design/reference/degraded/finish-reviewer.md +43 -0
  77. package/assets/skills/ui-design/reference/degraded/manual-edit-applier.md +56 -0
  78. package/assets/skills/ui-design/reference/delight.md +63 -0
  79. package/assets/skills/ui-design/reference/distill.md +98 -0
  80. package/assets/skills/ui-design/reference/doctor.md +49 -0
  81. package/assets/skills/ui-design/reference/document.md +273 -0
  82. package/assets/skills/ui-design/reference/extract.md +52 -0
  83. package/assets/skills/ui-design/reference/harden.md +122 -0
  84. package/assets/skills/ui-design/reference/hooks.md +114 -0
  85. package/assets/skills/ui-design/reference/init.md +47 -0
  86. package/assets/skills/ui-design/reference/ios.md +55 -0
  87. package/assets/skills/ui-design/reference/layout.md +81 -0
  88. package/assets/skills/ui-design/reference/live-setup.md +75 -0
  89. package/assets/skills/ui-design/reference/live.md +326 -0
  90. package/assets/skills/ui-design/reference/new-work.md +350 -0
  91. package/assets/skills/ui-design/reference/onboard.md +85 -0
  92. package/assets/skills/ui-design/reference/operate.md +29 -0
  93. package/assets/skills/ui-design/reference/optimize.md +101 -0
  94. package/assets/skills/ui-design/reference/overdrive.md +83 -0
  95. package/assets/skills/ui-design/reference/polish.md +77 -0
  96. package/assets/skills/ui-design/reference/quieter.md +95 -0
  97. package/assets/skills/ui-design/reference/routing.md +37 -0
  98. package/assets/skills/ui-design/reference/shape.md +43 -0
  99. package/assets/skills/ui-design/reference/styles/brutalist.md +45 -0
  100. package/assets/skills/ui-design/reference/styles/design-md.md +70 -0
  101. package/assets/skills/ui-design/reference/styles/direction.md +95 -0
  102. package/assets/skills/ui-design/reference/styles/full-output.md +42 -0
  103. package/assets/skills/ui-design/reference/styles/minimalist.md +64 -0
  104. package/assets/skills/ui-design/reference/styles/premium.md +65 -0
  105. package/assets/skills/ui-design/reference/styles/redesign.md +59 -0
  106. package/assets/skills/ui-design/reference/typeset.md +73 -0
  107. package/assets/skills/ui-design/reference/visualize.md +156 -0
  108. package/assets/skills/ui-design/scripts/ENGINE-LICENSE +191 -0
  109. package/assets/skills/ui-design/scripts/VERSION +1 -0
  110. package/assets/skills/ui-design/scripts/bin/darwin-arm64/impeccable +0 -0
  111. package/assets/skills/ui-design/scripts/command-metadata.json +94 -0
  112. package/assets/skills/ui-design/scripts/data/font-index-failures.json +121 -0
  113. package/assets/skills/ui-design/scripts/data/font-index.json +1 -0
  114. package/assets/skills/ui-design/scripts/impeccable +206 -0
  115. package/assets/skills/ui-design/scripts/impeccable.cmd +214 -0
  116. package/assets/skills/ui-design/scripts/live-browser-dom.js +167 -0
  117. package/assets/skills/ui-design/scripts/live-browser-ignores.js +242 -0
  118. package/assets/skills/ui-design/scripts/live-browser-session.js +144 -0
  119. package/assets/skills/ui-design/scripts/live-browser.js +12990 -0
  120. package/assets/skills/ui-design/scripts/modern-screenshot.umd.js +14 -0
  121. package/assets/skills/ui-design/scripts/ui-design +6 -0
  122. package/assets/skills/ui-design/scripts/ui-design.cmd +3 -0
  123. package/assets/skills/ui-design/scripts/ui-design.mjs +124 -0
  124. package/assets/skills/ui-mockup/SKILL.md +68 -0
  125. package/assets/skills/ui-mockup/reference/brandkit.md +101 -0
  126. package/assets/skills/ui-mockup/reference/image-to-code.md +83 -0
  127. package/assets/skills/ui-mockup/reference/mobile-comps.md +94 -0
  128. package/assets/skills/ui-mockup/reference/web-comps.md +83 -0
  129. package/assets/skills/ui-motion/SKILL.md +112 -0
  130. package/assets/skills/ui-motion/reference/expo.md +224 -0
  131. package/assets/skills/ui-motion/reference/opportunities.md +81 -0
  132. package/assets/skills/ui-motion/reference/prototype.md +238 -0
  133. package/assets/skills/ui-motion/reference/review.md +163 -0
  134. package/assets/skills/ui-motion/reference/toasts.md +144 -0
  135. package/assets/skills/ui-motion/reference/ui-libraries.md +71 -0
  136. package/assets/skills/ui-motion/reference/vocabulary.md +130 -0
  137. package/assets/skills/ui-motion/reference/web.md +294 -0
  138. package/assets/skills/ui-patterns/SKILL.md +105 -0
  139. package/assets/skills/ui-patterns/references/stacks/html-tailwind.md +40 -0
  140. package/assets/skills/ui-patterns/references/stacks/nextjs.md +52 -0
  141. package/assets/skills/ui-patterns/references/stacks/nuxt.md +100 -0
  142. package/assets/skills/ui-patterns/references/stacks/react-native.md +48 -0
  143. package/assets/skills/ui-patterns/references/stacks/react.md +49 -0
  144. package/assets/skills/ui-patterns/references/stacks/shadcn.md +57 -0
  145. package/assets/skills/ui-patterns/references/stacks/vue.md +37 -0
  146. package/assets/techne/.claude-plugin/marketplace.json +31 -0
  147. package/assets/techne/.claude-plugin/plugin.json +24 -0
  148. package/assets/techne/.mcp.json +8 -0
  149. package/assets/techne/commands/build-fix.md +48 -0
  150. package/assets/techne/commands/refactor-clean.md +46 -0
  151. package/assets/techne/commands/test-coverage.md +42 -0
  152. package/assets/techne/hooks/hooks.json +49 -0
  153. package/assets/techne/rules/angular/coding-style.md +49 -0
  154. package/assets/techne/rules/angular/hooks.md +23 -0
  155. package/assets/techne/rules/angular/patterns.md +48 -0
  156. package/assets/techne/rules/angular/security.md +26 -0
  157. package/assets/techne/rules/angular/testing.md +46 -0
  158. package/assets/techne/rules/arkts/coding-style.md +63 -0
  159. package/assets/techne/rules/arkts/hooks.md +38 -0
  160. package/assets/techne/rules/arkts/patterns.md +42 -0
  161. package/assets/techne/rules/arkts/security.md +35 -0
  162. package/assets/techne/rules/arkts/testing.md +39 -0
  163. package/assets/techne/rules/common/agents.md +6 -0
  164. package/assets/techne/rules/common/code-review.md +15 -0
  165. package/assets/techne/rules/common/coding-style.md +13 -0
  166. package/assets/techne/rules/common/development-workflow.md +5 -0
  167. package/assets/techne/rules/common/git-workflow.md +30 -0
  168. package/assets/techne/rules/common/hooks.md +7 -0
  169. package/assets/techne/rules/common/patterns.md +3 -0
  170. package/assets/techne/rules/common/performance.md +3 -0
  171. package/assets/techne/rules/common/security.md +5 -0
  172. package/assets/techne/rules/common/testing.md +3 -0
  173. package/assets/techne/rules/cpp/coding-style.md +31 -0
  174. package/assets/techne/rules/cpp/hooks.md +26 -0
  175. package/assets/techne/rules/cpp/patterns.md +31 -0
  176. package/assets/techne/rules/cpp/security.md +37 -0
  177. package/assets/techne/rules/cpp/testing.md +31 -0
  178. package/assets/techne/rules/csharp/coding-style.md +30 -0
  179. package/assets/techne/rules/csharp/hooks.md +24 -0
  180. package/assets/techne/rules/csharp/patterns.md +28 -0
  181. package/assets/techne/rules/csharp/security.md +32 -0
  182. package/assets/techne/rules/csharp/testing.md +27 -0
  183. package/assets/techne/rules/dart/coding-style.md +47 -0
  184. package/assets/techne/rules/dart/hooks.md +26 -0
  185. package/assets/techne/rules/dart/patterns.md +38 -0
  186. package/assets/techne/rules/dart/security.md +44 -0
  187. package/assets/techne/rules/dart/testing.md +39 -0
  188. package/assets/techne/rules/fsharp/coding-style.md +34 -0
  189. package/assets/techne/rules/fsharp/hooks.md +25 -0
  190. package/assets/techne/rules/fsharp/patterns.md +43 -0
  191. package/assets/techne/rules/fsharp/security.md +32 -0
  192. package/assets/techne/rules/fsharp/testing.md +27 -0
  193. package/assets/techne/rules/golang/coding-style.md +30 -0
  194. package/assets/techne/rules/golang/hooks.md +17 -0
  195. package/assets/techne/rules/golang/patterns.md +43 -0
  196. package/assets/techne/rules/golang/security.md +33 -0
  197. package/assets/techne/rules/golang/testing.md +20 -0
  198. package/assets/techne/rules/java/coding-style.md +51 -0
  199. package/assets/techne/rules/java/hooks.md +18 -0
  200. package/assets/techne/rules/java/patterns.md +55 -0
  201. package/assets/techne/rules/java/security.md +33 -0
  202. package/assets/techne/rules/java/testing.md +33 -0
  203. package/assets/techne/rules/kotlin/coding-style.md +50 -0
  204. package/assets/techne/rules/kotlin/hooks.md +17 -0
  205. package/assets/techne/rules/kotlin/patterns.md +44 -0
  206. package/assets/techne/rules/kotlin/security.md +34 -0
  207. package/assets/techne/rules/kotlin/testing.md +38 -0
  208. package/assets/techne/rules/nuxt/coding-style.md +20 -0
  209. package/assets/techne/rules/nuxt/hooks.md +16 -0
  210. package/assets/techne/rules/nuxt/patterns.md +46 -0
  211. package/assets/techne/rules/nuxt/security.md +19 -0
  212. package/assets/techne/rules/nuxt/testing.md +15 -0
  213. package/assets/techne/rules/perl/coding-style.md +33 -0
  214. package/assets/techne/rules/perl/hooks.md +22 -0
  215. package/assets/techne/rules/perl/patterns.md +43 -0
  216. package/assets/techne/rules/perl/security.md +39 -0
  217. package/assets/techne/rules/perl/testing.md +42 -0
  218. package/assets/techne/rules/php/coding-style.md +30 -0
  219. package/assets/techne/rules/php/hooks.md +24 -0
  220. package/assets/techne/rules/php/patterns.md +26 -0
  221. package/assets/techne/rules/php/security.md +27 -0
  222. package/assets/techne/rules/php/testing.md +28 -0
  223. package/assets/techne/rules/python/coding-style.md +38 -0
  224. package/assets/techne/rules/python/fastapi.md +57 -0
  225. package/assets/techne/rules/python/hooks.md +19 -0
  226. package/assets/techne/rules/python/patterns.md +37 -0
  227. package/assets/techne/rules/python/security.md +26 -0
  228. package/assets/techne/rules/python/testing.md +32 -0
  229. package/assets/techne/rules/react/coding-style.md +24 -0
  230. package/assets/techne/rules/react/hooks.md +62 -0
  231. package/assets/techne/rules/react/patterns.md +48 -0
  232. package/assets/techne/rules/react/security.md +45 -0
  233. package/assets/techne/rules/react/testing.md +42 -0
  234. package/assets/techne/rules/react-native/accessibility.md +14 -0
  235. package/assets/techne/rules/react-native/coding-style.md +16 -0
  236. package/assets/techne/rules/react-native/hooks.md +16 -0
  237. package/assets/techne/rules/react-native/patterns.md +18 -0
  238. package/assets/techne/rules/react-native/performance.md +14 -0
  239. package/assets/techne/rules/react-native/production-readiness.md +16 -0
  240. package/assets/techne/rules/react-native/security.md +16 -0
  241. package/assets/techne/rules/react-native/testing.md +14 -0
  242. package/assets/techne/rules/ruby/coding-style.md +40 -0
  243. package/assets/techne/rules/ruby/hooks.md +33 -0
  244. package/assets/techne/rules/ruby/patterns.md +33 -0
  245. package/assets/techne/rules/ruby/security.md +39 -0
  246. package/assets/techne/rules/ruby/testing.md +35 -0
  247. package/assets/techne/rules/rust/coding-style.md +41 -0
  248. package/assets/techne/rules/rust/hooks.md +16 -0
  249. package/assets/techne/rules/rust/patterns.md +42 -0
  250. package/assets/techne/rules/rust/security.md +33 -0
  251. package/assets/techne/rules/rust/testing.md +30 -0
  252. package/assets/techne/rules/swift/coding-style.md +30 -0
  253. package/assets/techne/rules/swift/hooks.md +20 -0
  254. package/assets/techne/rules/swift/patterns.md +30 -0
  255. package/assets/techne/rules/swift/security.md +22 -0
  256. package/assets/techne/rules/swift/testing.md +28 -0
  257. package/assets/techne/rules/typescript/coding-style.md +38 -0
  258. package/assets/techne/rules/typescript/hooks.md +14 -0
  259. package/assets/techne/rules/typescript/patterns.md +12 -0
  260. package/assets/techne/rules/typescript/security.md +14 -0
  261. package/assets/techne/rules/typescript/testing.md +12 -0
  262. package/assets/techne/rules/vue/coding-style.md +19 -0
  263. package/assets/techne/rules/vue/hooks.md +13 -0
  264. package/assets/techne/rules/vue/patterns.md +29 -0
  265. package/assets/techne/rules/vue/security.md +11 -0
  266. package/assets/techne/rules/vue/testing.md +11 -0
  267. package/assets/techne/rules/web/coding-style.md +25 -0
  268. package/assets/techne/rules/web/design-quality.md +21 -0
  269. package/assets/techne/rules/web/hooks.md +39 -0
  270. package/assets/techne/rules/web/patterns.md +23 -0
  271. package/assets/techne/rules/web/performance.md +25 -0
  272. package/assets/techne/rules/web/security.md +23 -0
  273. package/assets/techne/rules/web/testing.md +21 -0
  274. package/assets/techne/scripts/hooks/config-guard.js +50 -0
  275. package/assets/techne/scripts/hooks/edit-tracker.js +26 -0
  276. package/assets/techne/scripts/hooks/lib/shell.js +204 -0
  277. package/assets/techne/scripts/hooks/no-verify-guard.js +205 -0
  278. package/assets/techne/scripts/hooks/run.js +92 -0
  279. package/assets/techne/scripts/hooks/stop-checks.js +136 -0
  280. package/assets/techne/skills/angular/SKILL.md +34 -0
  281. package/assets/techne/skills/angular/reference/components-and-templates.md +63 -0
  282. package/assets/techne/skills/angular/reference/dependency-injection.md +44 -0
  283. package/assets/techne/skills/angular/reference/forms.md +97 -0
  284. package/assets/techne/skills/angular/reference/routing.md +50 -0
  285. package/assets/techne/skills/angular/reference/signals-and-state.md +59 -0
  286. package/assets/techne/skills/angular/reference/styling-motion-a11y.md +54 -0
  287. package/assets/techne/skills/angular/reference/testing.md +52 -0
  288. package/assets/techne/skills/angular/reference/tooling.md +31 -0
  289. package/assets/techne/skills/cpp/SKILL.md +27 -0
  290. package/assets/techne/skills/cpp/reference/coding-standards.md +160 -0
  291. package/assets/techne/skills/databases/SKILL.md +35 -0
  292. package/assets/techne/skills/databases/reference/clickhouse.md +102 -0
  293. package/assets/techne/skills/databases/reference/migrations.md +94 -0
  294. package/assets/techne/skills/databases/reference/mysql.md +101 -0
  295. package/assets/techne/skills/databases/reference/postgres.md +72 -0
  296. package/assets/techne/skills/databases/reference/prisma.md +105 -0
  297. package/assets/techne/skills/databases/reference/redis.md +108 -0
  298. package/assets/techne/skills/delivery/SKILL.md +35 -0
  299. package/assets/techne/skills/delivery/reference/deployment-patterns.md +58 -0
  300. package/assets/techne/skills/delivery/reference/docker-patterns.md +77 -0
  301. package/assets/techne/skills/delivery/reference/git-workflow.md +64 -0
  302. package/assets/techne/skills/delivery/reference/github-ops.md +67 -0
  303. package/assets/techne/skills/delivery/reference/jira-integration.md +53 -0
  304. package/assets/techne/skills/delivery/reference/kubernetes-patterns.md +67 -0
  305. package/assets/techne/skills/dotnet/SKILL.md +27 -0
  306. package/assets/techne/skills/dotnet/reference/dotnet-core.md +131 -0
  307. package/assets/techne/skills/flutter/SKILL.md +29 -0
  308. package/assets/techne/skills/flutter/reference/code-review.md +76 -0
  309. package/assets/techne/skills/flutter/reference/patterns.md +201 -0
  310. package/assets/techne/skills/go/SKILL.md +28 -0
  311. package/assets/techne/skills/go/reference/patterns.md +87 -0
  312. package/assets/techne/skills/go/reference/testing.md +142 -0
  313. package/assets/techne/skills/java/SKILL.md +29 -0
  314. package/assets/techne/skills/java/reference/java-standards.md +117 -0
  315. package/assets/techne/skills/java/reference/springboot.md +108 -0
  316. package/assets/techne/skills/kotlin/SKILL.md +35 -0
  317. package/assets/techne/skills/kotlin/reference/android-clean-architecture.md +115 -0
  318. package/assets/techne/skills/kotlin/reference/compose-multiplatform-patterns.md +113 -0
  319. package/assets/techne/skills/kotlin/reference/kotlin-coroutines-flows.md +93 -0
  320. package/assets/techne/skills/kotlin/reference/kotlin-patterns.md +74 -0
  321. package/assets/techne/skills/kotlin/reference/kotlin-testing.md +115 -0
  322. package/assets/techne/skills/ml/SKILL.md +34 -0
  323. package/assets/techne/skills/ml/reference/ai-regression-testing.md +99 -0
  324. package/assets/techne/skills/ml/reference/cost-aware-llm-pipeline.md +133 -0
  325. package/assets/techne/skills/ml/reference/eval-harness.md +94 -0
  326. package/assets/techne/skills/ml/reference/mle-workflow.md +177 -0
  327. package/assets/techne/skills/ml/reference/prompt-optimizer.md +107 -0
  328. package/assets/techne/skills/ml/reference/pytorch-patterns.md +164 -0
  329. package/assets/techne/skills/php/SKILL.md +27 -0
  330. package/assets/techne/skills/php/reference/laravel.md +142 -0
  331. package/assets/techne/skills/python/SKILL.md +33 -0
  332. package/assets/techne/skills/python/reference/django.md +104 -0
  333. package/assets/techne/skills/python/reference/fastapi.md +118 -0
  334. package/assets/techne/skills/python/reference/python-core.md +88 -0
  335. package/assets/techne/skills/python/reference/python-testing.md +105 -0
  336. package/assets/techne/skills/quality/SKILL.md +34 -0
  337. package/assets/techne/skills/quality/reference/benchmark.md +55 -0
  338. package/assets/techne/skills/quality/reference/browser-qa.md +60 -0
  339. package/assets/techne/skills/quality/reference/coding-standards.md +88 -0
  340. package/assets/techne/skills/quality/reference/e2e-testing.md +99 -0
  341. package/assets/techne/skills/quality/reference/tdd-workflow.md +89 -0
  342. package/assets/techne/skills/quality/reference/verification-loop.md +80 -0
  343. package/assets/techne/skills/react/SKILL.md +30 -0
  344. package/assets/techne/skills/react/reference/nextjs-turbopack.md +42 -0
  345. package/assets/techne/skills/react/reference/react-patterns.md +139 -0
  346. package/assets/techne/skills/react/reference/react-performance.md +101 -0
  347. package/assets/techne/skills/react/reference/react-testing.md +139 -0
  348. package/assets/techne/skills/react-native/SKILL.md +28 -0
  349. package/assets/techne/skills/react-native/reference/expo-patterns.md +196 -0
  350. package/assets/techne/skills/research/SKILL.md +35 -0
  351. package/assets/techne/skills/research/reference/architecture-decision-records.md +65 -0
  352. package/assets/techne/skills/research/reference/codebase-onboarding.md +44 -0
  353. package/assets/techne/skills/research/reference/deep-research.md +50 -0
  354. package/assets/techne/skills/research/reference/iterative-retrieval.md +62 -0
  355. package/assets/techne/skills/research/reference/product-lens.md +38 -0
  356. package/assets/techne/skills/research/reference/search-first.md +50 -0
  357. package/assets/techne/skills/rust/SKILL.md +28 -0
  358. package/assets/techne/skills/rust/reference/patterns.md +108 -0
  359. package/assets/techne/skills/rust/reference/testing.md +142 -0
  360. package/assets/techne/skills/services/SKILL.md +32 -0
  361. package/assets/techne/skills/services/reference/api-contracts.md +139 -0
  362. package/assets/techne/skills/services/reference/backend-layers.md +95 -0
  363. package/assets/techne/skills/services/reference/errors-and-resilience.md +146 -0
  364. package/assets/techne/skills/services/reference/hexagonal-boundaries.md +93 -0
  365. package/assets/techne/skills/services/reference/mcp-servers.md +50 -0
  366. package/assets/techne/skills/services/reference/nestjs.md +96 -0
  367. package/assets/techne/skills/swift/SKILL.md +29 -0
  368. package/assets/techne/skills/swift/reference/concurrency.md +83 -0
  369. package/assets/techne/skills/swift/reference/swiftui.md +139 -0
  370. package/assets/techne/skills/vue/SKILL.md +29 -0
  371. package/assets/techne/skills/vue/reference/nuxt4-patterns.md +90 -0
  372. package/assets/techne/skills/vue/reference/ui-to-vue.md +90 -0
  373. package/assets/techne/skills/vue/reference/vue-patterns.md +151 -0
  374. package/assets/techne/skills/web/SKILL.md +30 -0
  375. package/assets/techne/skills/web/reference/bun-runtime.md +55 -0
  376. package/assets/techne/skills/web/reference/frontend-patterns.md +54 -0
  377. package/assets/techne/skills/web/reference/seo.md +77 -0
  378. package/assets/techne/skills/web/reference/vite-patterns.md +96 -0
  379. package/bin/native.cjs +30 -0
  380. package/native/aarch64-apple-darwin/exonous +0 -0
  381. package/native/aarch64-unknown-linux-gnu/exonous +0 -0
  382. package/native/x86_64-apple-darwin/exonous +0 -0
  383. package/native/x86_64-pc-windows-msvc/exonous.exe +0 -0
  384. package/native/x86_64-unknown-linux-gnu/exonous +0 -0
  385. package/package.json +1 -6
@@ -0,0 +1,389 @@
1
+ #!/usr/bin/env node
2
+ // issue-board: busca as issues abertas de um GitHub Project (v2), junta com a
3
+ // classificação sugerida pelo agente e desenha tabelas no terminal.
4
+ // Sem dependências: só Node >= 18 e o gh CLI autenticado.
5
+
6
+ import { execFileSync } from 'node:child_process'
7
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
8
+ import { dirname, join } from 'node:path'
9
+ import { fileURLToPath } from 'node:url'
10
+
11
+ const HERE = dirname(fileURLToPath(import.meta.url))
12
+ const PRIORITIES = ['P0', 'P1', 'P2', 'P3']
13
+ const DIFFICULTIES = ['1', '2', '3']
14
+ const BODY_LIMIT = 1500
15
+ const EXIT_AUTH = 2
16
+ const EXIT_CONFIG = 3
17
+ const EXIT_NO_GH = 4
18
+ const BOOLEAN_FLAGS = new Set(['all', 'color', 'no-color', 'json'])
19
+ const MIN_TITLE_WIDTH = 20
20
+
21
+ const DEFAULT_FIELDS = { status: 'Status', priority: 'Priority', size: 'Size', group: '' }
22
+ const DEFAULT_TYPES = [
23
+ { id: 'bug', name: 'Bug', hint: 'algo que funcionava ou deveria funcionar e não funciona' },
24
+ { id: 'feature', name: 'Feature', hint: 'comportamento novo pedido' },
25
+ { id: 'front', name: 'Interface', hint: 'telas, layout, mensagens, UX' },
26
+ { id: 'dados', name: 'Dados', hint: 'dado errado, perdido, migração, consistência' },
27
+ { id: 'performance', name: 'Performance', hint: 'lentidão, dado atrasado, consumo de recurso' },
28
+ { id: 'seguranca', name: 'Segurança', hint: 'auth, permissão, vazamento, segredo' },
29
+ { id: 'infra', name: 'Infra', hint: 'deploy, CI, cloud, banco, observabilidade' },
30
+ { id: 'outros', name: 'Outros', hint: 'docs, ferramentas de dev, decisões' },
31
+ ]
32
+ // Valores comuns dos campos de prioridade e tamanho; config.priorityMap / sizeMap estendem.
33
+ const DEFAULT_PRIORITY_MAP = { p0: 'P0', urgent: 'P0', critical: 'P0', p1: 'P1', high: 'P1', p2: 'P2', medium: 'P2', p3: 'P3', low: 'P3' }
34
+ const DEFAULT_SIZE_MAP = { xs: 1, s: 1, small: 1, m: 2, medium: 2, l: 3, large: 3, xl: 3 }
35
+ const DIFFICULTY_LABEL = { 1: 'Fácil', 2: 'Média', 3: 'Difícil' }
36
+
37
+ function fail(message, code = 1) {
38
+ process.stderr.write(`${message}\n`)
39
+ process.exit(code)
40
+ }
41
+
42
+ function readJson(path, fallback) {
43
+ if (!existsSync(path)) return fallback
44
+ return JSON.parse(readFileSync(path, 'utf8'))
45
+ }
46
+
47
+ function writeJson(path, value) {
48
+ mkdirSync(dirname(path), { recursive: true })
49
+ writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`)
50
+ }
51
+
52
+ // Minúsculas e sem acento, para "facil" casar com "Fácil".
53
+ function fold(value) {
54
+ return String(value).normalize('NFD').replace(/\p{M}/gu, '').toLowerCase()
55
+ }
56
+
57
+ function lowerKeys(map) {
58
+ return Object.fromEntries(Object.entries(map || {}).map(([k, v]) => [k.toLowerCase(), v]))
59
+ }
60
+
61
+ function loadConfig(flags) {
62
+ const file = readJson(join(HERE, 'config.json'), {})
63
+ const config = {
64
+ owner: flags.owner || file.owner,
65
+ projectNumber: Number(flags['project-number'] || file.projectNumber),
66
+ fields: { ...DEFAULT_FIELDS, ...file.fields },
67
+ doneStatuses: file.doneStatuses || ['Done'],
68
+ types: file.types?.length ? file.types : DEFAULT_TYPES,
69
+ priorityMap: { ...DEFAULT_PRIORITY_MAP, ...lowerKeys(file.priorityMap) },
70
+ sizeMap: { ...DEFAULT_SIZE_MAP, ...lowerKeys(file.sizeMap) },
71
+ }
72
+ if (!config.owner || !config.projectNumber) {
73
+ fail('Board não definido. Preencha owner e projectNumber em config.json (veja config.example.json) ou passe --owner e --project-number.', EXIT_CONFIG)
74
+ }
75
+ if (!/^[A-Za-z0-9-]+$/.test(config.owner) || !Number.isInteger(config.projectNumber) || config.projectNumber < 1) {
76
+ fail(`Board inválido: owner "${config.owner}", projectNumber "${config.projectNumber}".`, EXIT_CONFIG)
77
+ }
78
+ for (const [value, difficulty] of Object.entries(config.sizeMap)) {
79
+ if (![1, 2, 3].includes(difficulty)) fail(`sizeMap: "${value}" deve apontar para 1, 2 ou 3.`, EXIT_CONFIG)
80
+ }
81
+ for (const [value, priority] of Object.entries(config.priorityMap)) {
82
+ if (!PRIORITIES.includes(priority)) fail(`priorityMap: "${value}" deve apontar para P0..P3.`, EXIT_CONFIG)
83
+ }
84
+ config.dataDir = join(HERE, 'data', `${config.owner}-${config.projectNumber}`)
85
+ return config
86
+ }
87
+
88
+ function gh(args) {
89
+ return execFileSync('gh', args, { encoding: 'utf8', maxBuffer: 64 * 1024 * 1024, stdio: ['ignore', 'pipe', 'pipe'] })
90
+ }
91
+
92
+ function requireAuth() {
93
+ try {
94
+ return gh(['api', 'user', '-q', '.login']).trim()
95
+ } catch (err) {
96
+ if (err.code === 'ENOENT') fail('gh CLI não encontrado. Instale: https://cli.github.com', EXIT_NO_GH)
97
+ fail(
98
+ 'gh não está autenticado no github.com. Rode no prompt do Claude Code:\n' +
99
+ ' ! gh auth login -s read:project\n' +
100
+ `e depois execute o comando de novo. (${String(err.stderr || err.message).trim()})`,
101
+ EXIT_AUTH,
102
+ )
103
+ }
104
+ }
105
+
106
+ function parseArgs(argv) {
107
+ const flags = {}
108
+ const positional = []
109
+ for (let i = 0; i < argv.length; i++) {
110
+ const arg = argv[i]
111
+ if (!arg.startsWith('--')) {
112
+ positional.push(arg)
113
+ continue
114
+ }
115
+ const eq = arg.indexOf('=')
116
+ const key = eq === -1 ? arg.slice(2) : arg.slice(2, eq)
117
+ if (eq !== -1) flags[key] = arg.slice(eq + 1)
118
+ else if (!BOOLEAN_FLAGS.has(key) && argv[i + 1] && !argv[i + 1].startsWith('--')) flags[key] = argv[++i]
119
+ else flags[key] = true
120
+ }
121
+ return { flags, positional }
122
+ }
123
+
124
+ // O project pode pertencer a uma organização ou a um usuário.
125
+ const queryFor = (ownerKind) => `query($owner:String!,$num:Int!,$cursor:String){${ownerKind}(login:$owner){projectV2(number:$num){
126
+ items(first:100,after:$cursor){pageInfo{hasNextPage endCursor} nodes{
127
+ fieldValues(first:30){nodes{... on ProjectV2ItemFieldSingleSelectValue{name field{... on ProjectV2FieldCommon{name}}}}}
128
+ content{... on Issue{number title state url body updatedAt repository{nameWithOwner}
129
+ assignees(first:10){nodes{login}} labels(first:20){nodes{name}}}}
130
+ }}}}}`
131
+
132
+ function fetchPage(config, ownerKind, cursor) {
133
+ const args = ['api', 'graphql', '-f', `query=${queryFor(ownerKind)}`, '-f', `owner=${config.owner}`, '-F', `num=${config.projectNumber}`]
134
+ if (cursor) args.push('-f', `cursor=${cursor}`)
135
+ try {
136
+ return JSON.parse(gh(args)).data?.[ownerKind]?.projectV2?.items ?? null
137
+ } catch (err) {
138
+ const stderr = String(err.stderr || err.message)
139
+ if (/read:project|INSUFFICIENT_SCOPES/i.test(stderr)) {
140
+ fail('O token do gh não tem o escopo read:project. Rode:\n ! gh auth refresh -s read:project', EXIT_AUTH)
141
+ }
142
+ // Owner do tipo errado (org vs. usuário) responde NOT_FOUND: tratamos como ausência.
143
+ if (/NOT_FOUND|Could not resolve/i.test(stderr)) return null
144
+ fail(`Falha ao ler o project: ${stderr.trim()}`)
145
+ }
146
+ }
147
+
148
+ function fetchItems(config) {
149
+ // A primeira página também descobre se o owner é organização ou usuário.
150
+ const orgPage = fetchPage(config, 'organization', null)
151
+ const ownerKind = orgPage ? 'organization' : 'user'
152
+ let firstPage = orgPage || fetchPage(config, 'user', null)
153
+ const items = []
154
+ let cursor = null
155
+ do {
156
+ const conn = firstPage || fetchPage(config, ownerKind, cursor)
157
+ firstPage = null
158
+ if (!conn) fail(`Project ${config.owner}#${config.projectNumber} não encontrado ou sem acesso. Liste os disponíveis com: gh project list --owner ${config.owner}`)
159
+ items.push(...conn.nodes)
160
+ cursor = conn.pageInfo.hasNextPage ? conn.pageInfo.endCursor : null
161
+ } while (cursor)
162
+ return items
163
+ }
164
+
165
+ function normalize(node, fields) {
166
+ const c = node.content
167
+ if (!c?.number || c.state !== 'OPEN') return null
168
+ const values = {}
169
+ for (const v of node.fieldValues.nodes) {
170
+ if (v?.field?.name) values[v.field.name] = v.name
171
+ }
172
+ return {
173
+ key: `${c.repository.nameWithOwner}#${c.number}`,
174
+ repo: c.repository.nameWithOwner.split('/')[1],
175
+ number: c.number,
176
+ title: c.title,
177
+ url: c.url,
178
+ updatedAt: c.updatedAt,
179
+ assignees: c.assignees.nodes.map((a) => a.login),
180
+ labels: c.labels.nodes.map((l) => l.name),
181
+ body: (c.body || '').replace(/<img[^>]*>/g, '[imagem]').slice(0, BODY_LIMIT),
182
+ status: values[fields.status] || '',
183
+ group: fields.group ? values[fields.group] || '' : '',
184
+ boardPriority: values[fields.priority] || '',
185
+ boardSize: values[fields.size] || '',
186
+ }
187
+ }
188
+
189
+ function cmdFetch(config, flags) {
190
+ const me = requireAuth()
191
+ const done = new Set(config.doneStatuses)
192
+ const all = fetchItems(config)
193
+ .map((n) => normalize(n, config.fields))
194
+ .filter((i) => i && !done.has(i.status))
195
+ const mine = all.filter((i) => i.assignees.includes(me))
196
+ writeJson(join(config.dataDir, 'items.json'), { fetchedAt: new Date().toISOString(), me, items: all })
197
+ const classes = readJson(join(config.dataDir, 'classification.json'), {})
198
+ const scope = flags.all ? all : mine
199
+ const pending = scope.filter((i) => !classes[i.key]).length
200
+ console.log(`Board ${config.owner}#${config.projectNumber}: ${all.length} issues abertas, ${mine.length} atribuídas a ${me}. Sem classificação no escopo: ${pending}.`)
201
+ }
202
+
203
+ function scopeItems(config, flags) {
204
+ const data = readJson(join(config.dataDir, 'items.json'), null)
205
+ if (!data) fail('Nada em cache para esse board. Rode "fetch" antes.')
206
+ if (flags.user === true) fail('--user precisa de um login.')
207
+ const wanted = flags.user || data.me
208
+ return flags.all ? data.items : data.items.filter((i) => i.assignees.includes(wanted))
209
+ }
210
+
211
+ function cmdPending(config, flags) {
212
+ const classes = readJson(join(config.dataDir, 'classification.json'), {})
213
+ const pending = scopeItems(config, flags)
214
+ .filter((i) => !classes[i.key])
215
+ .map(({ key, title, labels, status, group, boardPriority, boardSize, body }) => ({ key, title, labels, status, group, boardPriority, boardSize, body }))
216
+ console.log(JSON.stringify({ types: config.types, issues: pending }, null, 2))
217
+ }
218
+
219
+ function cmdClassify(config, positional) {
220
+ const file = positional[0]
221
+ if (!file) fail('Uso: classify <arquivo.json>')
222
+ const typeIds = new Set(config.types.map((t) => t.id))
223
+ const entries = JSON.parse(readFileSync(file, 'utf8'))
224
+ if (!Array.isArray(entries)) fail('O arquivo precisa ser um array de {key, type, priority, difficulty, note?}.')
225
+ const path = join(config.dataDir, 'classification.json')
226
+ const classes = readJson(path, {})
227
+ const errors = []
228
+ for (const e of entries) {
229
+ if (typeof e?.key !== 'string' || !e.key.includes('#')) errors.push(`entrada sem key válida: ${JSON.stringify(e)}`)
230
+ else if (!typeIds.has(e.type)) errors.push(`${e.key}: type "${e.type}" não existe nos tipos configurados`)
231
+ else if (!PRIORITIES.includes(e.priority)) errors.push(`${e.key}: priority deve ser P0..P3`)
232
+ else if (!DIFFICULTIES.includes(String(e.difficulty))) errors.push(`${e.key}: difficulty deve ser 1, 2 ou 3`)
233
+ else classes[e.key] = { type: e.type, priority: e.priority, difficulty: Number(e.difficulty), note: e.note || '' }
234
+ }
235
+ if (errors.length) fail(`Nada gravado. Corrija:\n${errors.join('\n')}`)
236
+ writeJson(path, classes)
237
+ console.log(`${entries.length} classificações gravadas.`)
238
+ }
239
+
240
+ // ---------- render ----------
241
+
242
+ function resolve(item, classes, config) {
243
+ const c = classes[item.key] || {}
244
+ // Valor preenchido no board e fora do mapa aparece cru: o campo não está vazio.
245
+ const boardP = config.priorityMap[item.boardPriority.toLowerCase()] || item.boardPriority
246
+ const boardD = config.sizeMap[item.boardSize.toLowerCase()] || 0
247
+ return {
248
+ ...item,
249
+ typeId: c.type || '',
250
+ type: config.types.find((t) => t.id === c.type)?.name || 'Sem tipo',
251
+ priority: boardP || c.priority || '—',
252
+ prioritySuggested: !boardP && Boolean(c.priority),
253
+ difficulty: boardD || c.difficulty || 0,
254
+ difficultySuggested: !boardD && Boolean(c.difficulty),
255
+ note: c.note || '',
256
+ }
257
+ }
258
+
259
+ function makePaint(enabled) {
260
+ const code = (n) => (s) => (enabled ? `\x1b[${n}m${s}\x1b[0m` : s)
261
+ return { red: code('31;1'), yellow: code('33;1'), cyan: code('36'), gray: code('90'), bold: code('1'), dim: code('2') }
262
+ }
263
+
264
+ function pad(text, width) {
265
+ const chars = [...String(text)]
266
+ if (chars.length > width) return `${chars.slice(0, width - 1).join('')}…`
267
+ return chars.join('') + ' '.repeat(width - chars.length)
268
+ }
269
+
270
+ function table(rows, columns, paint) {
271
+ const line = (l, m, r) => l + columns.map((c) => '─'.repeat(c.width + 2)).join(m) + r
272
+ const out = [line('┌', '┬', '┐')]
273
+ out.push('│' + columns.map((c) => ` ${paint.bold(pad(c.label, c.width))} `).join('│') + '│')
274
+ out.push(line('├', '┼', '┤'))
275
+ for (const row of rows) {
276
+ out.push('│' + columns.map((c) => ` ${c.color ? c.color(row, pad(c.get(row), c.width)) : pad(c.get(row), c.width)} `).join('│') + '│')
277
+ }
278
+ out.push(line('└', '┴', '┘'))
279
+ return out.join('\n')
280
+ }
281
+
282
+ function priorityColor(paint) {
283
+ return (row, text) => ({ P0: paint.red, P1: paint.yellow, P2: paint.cyan, P3: paint.gray })[row.priority]?.(text) ?? text
284
+ }
285
+
286
+ const GROUPS = {
287
+ tipo: (r) => r.type,
288
+ prioridade: (r) => r.priority,
289
+ dificuldade: (r) => DIFFICULTY_LABEL[r.difficulty] || 'Sem dificuldade',
290
+ campo: (r) => r.group || '(vazio)',
291
+ status: (r) => r.status || 'Sem status',
292
+ repo: (r) => r.repo,
293
+ }
294
+
295
+ const rank = (p) => (PRIORITIES.includes(p) ? PRIORITIES.indexOf(p) : 9)
296
+
297
+ // Filtra, agrupa e ordena: a mesma visão serve à tabela ANSI e ao --json do render.py.
298
+ function buildView(config, flags) {
299
+ const classes = readJson(join(config.dataDir, 'classification.json'), {})
300
+ const list = (v) => (typeof v === 'string' ? v.split(',').map((s) => fold(s.trim())) : null)
301
+ const filters = [
302
+ [list(flags.prioridade), (r) => r.priority],
303
+ [list(flags.dificuldade), (r) => DIFFICULTY_LABEL[r.difficulty] || ''],
304
+ [list(flags.tipo), (r) => `${r.typeId} ${r.type}`],
305
+ [list(flags.campo), (r) => r.group],
306
+ [list(flags.repo), (r) => r.repo],
307
+ [list(flags.status), (r) => r.status],
308
+ ]
309
+ const rows = scopeItems(config, flags)
310
+ .map((i) => resolve(i, classes, config))
311
+ .filter((r) => filters.every(([want, get]) => !want || want.some((w) => fold(get(r)).includes(w))))
312
+ const groupBy = GROUPS[flags.por] ? flags.por : 'tipo'
313
+ const order = groupBy === 'tipo' ? [...config.types.map((t) => t.name), 'Sem tipo'] : null
314
+ const groups = new Map()
315
+ for (const r of rows) {
316
+ const g = GROUPS[groupBy](r)
317
+ groups.set(g, [...(groups.get(g) || []), r])
318
+ }
319
+ const names = [...groups.keys()].sort((a, b) => (order ? order.indexOf(a) - order.indexOf(b) : String(a).localeCompare(String(b))))
320
+ return {
321
+ board: `${config.owner}#${config.projectNumber}`,
322
+ user: flags.all ? null : flags.user || readJson(join(config.dataDir, 'items.json'), {}).me || null,
323
+ groupBy,
324
+ groupField: config.fields.group || null,
325
+ total: rows.length,
326
+ counts: Object.fromEntries(PRIORITIES.map((p) => [p, rows.filter((r) => r.priority === p).length])),
327
+ groups: names.map((name) => ({
328
+ name,
329
+ rows: groups
330
+ .get(name)
331
+ .sort((a, b) => rank(a.priority) - rank(b.priority) || (a.difficulty || 9) - (b.difficulty || 9))
332
+ .map(({ key, repo, number, title, url, status, group, type, priority, prioritySuggested, difficulty, difficultySuggested, note }) => ({
333
+ key, repo, number, title, url, status, group, type, priority, prioritySuggested, difficulty, difficultySuggested, note,
334
+ })),
335
+ })),
336
+ }
337
+ }
338
+
339
+ function cmdRender(config, flags) {
340
+ const view = buildView(config, flags)
341
+ if (flags.json) {
342
+ console.log(JSON.stringify(view))
343
+ return
344
+ }
345
+ const paint = makePaint(flags.color === true || (flags['no-color'] === undefined && process.stdout.isTTY))
346
+ if (!view.total) {
347
+ console.log('Nenhuma issue nesse escopo. Tente --all para ver o board inteiro.')
348
+ return
349
+ }
350
+
351
+ const counts = PRIORITIES.map((p) => `${p} ${view.counts[p]}`).join(' · ')
352
+ console.log(paint.bold(`${view.total} issues | ${counts}`))
353
+ console.log(paint.dim('Dificuldade ■□□ fácil ■■□ média ■■■ difícil ~ = sugestão do agente (campo vazio no board)\n'))
354
+
355
+ const width = Math.max(60, Math.min(Number(flags.width) || process.stdout.columns || 140, 180))
356
+ const title = { label: 'Título', width: 0, get: (r) => (r.note ? `${r.title} [${r.note}]` : r.title) }
357
+ const columns = [
358
+ { label: 'Pri', width: 4, get: (r) => r.priority + (r.prioritySuggested ? '~' : ''), color: priorityColor(paint) },
359
+ { label: 'Dif', width: 5, get: (r) => (r.difficulty ? '■'.repeat(r.difficulty) + '□'.repeat(3 - r.difficulty) : '—') + (r.difficultySuggested ? '~' : '') },
360
+ { label: 'ID', width: 5, get: (r) => `#${r.number}` },
361
+ { label: 'Repo', width: 19, get: (r) => r.repo },
362
+ title,
363
+ { label: 'Status', width: 12, get: (r) => r.status || '—' },
364
+ ]
365
+ const optional = []
366
+ if (view.groupField) optional.push({ label: view.groupField, width: 10, get: (r) => r.group || '—' })
367
+ if (view.groupBy !== 'tipo') optional.push({ label: 'Tipo', width: 18, get: (r) => r.type })
368
+ const spare = (cols) => width - cols.reduce((sum, c) => sum + c.width + 3, 0) - 1
369
+ // Terminal estreito: a coluna opcional sai antes de o título ficar ilegível.
370
+ for (const col of optional) {
371
+ if (spare([...columns, col]) >= MIN_TITLE_WIDTH) columns.push(col)
372
+ }
373
+ title.width = Math.max(MIN_TITLE_WIDTH, spare(columns))
374
+
375
+ for (const group of view.groups) {
376
+ console.log(paint.bold(`▌ ${group.name} (${group.rows.length})`))
377
+ console.log(table(group.rows, columns, paint))
378
+ console.log('')
379
+ }
380
+ }
381
+
382
+ const { flags, positional } = parseArgs(process.argv.slice(2))
383
+ const command = positional.shift()
384
+ const commands = { fetch: cmdFetch, pending: cmdPending, classify: (c) => cmdClassify(c, positional), render: cmdRender }
385
+ if (!commands[command]) {
386
+ fail('Uso: node board.mjs <fetch|pending|classify|render> [--owner x --project-number n] [--all] [--user login] [--por tipo|prioridade|dificuldade|campo|status|repo] [--prioridade P0,P1] [--dificuldade fácil] [--tipo bug] [--campo valor] [--repo nome] [--status ready] [--width n] [--color|--no-color] [--json]')
387
+ }
388
+ if (command === 'fetch') requireAuth()
389
+ commands[command](loadConfig(flags), flags)
@@ -0,0 +1,9 @@
1
+ {
2
+ "owner": "sua-org-ou-usuario",
3
+ "projectNumber": 1,
4
+ "fields": { "status": "Status", "priority": "Priority", "size": "Size", "group": "" },
5
+ "doneStatuses": ["Done"],
6
+ "priorityMap": {},
7
+ "sizeMap": {},
8
+ "types": []
9
+ }
@@ -0,0 +1,189 @@
1
+ #!/usr/bin/env python3
2
+ """Desenha o board com rich, a partir de `node board.mjs render --json`.
3
+
4
+ Aceita as mesmas flags do `render` do board.mjs (--all, --por, --prioridade...).
5
+ Sem o pacote rich, cai no render ANSI do board.mjs.
6
+ """
7
+
8
+ import json
9
+ import shutil
10
+ import subprocess
11
+ import sys
12
+ import unicodedata
13
+ from pathlib import Path
14
+
15
+ HERE = Path(__file__).resolve().parent
16
+ BOARD = HERE / "board.mjs"
17
+ WIDTH_WHEN_PIPED = 160
18
+ MIN_TITLE_WIDTH = 24
19
+
20
+ PRIORITY_STYLE = {
21
+ "P0": "bold white on red3",
22
+ "P1": "bold black on gold3",
23
+ "P2": "bold black on steel_blue1",
24
+ "P3": "white on grey37",
25
+ }
26
+ DIFFICULTY_STYLE = {1: "green3", 2: "gold3", 3: "red3"}
27
+ # Casado por trecho, sem acento: "Ready to Dev" e "Not ready" caem em "ready".
28
+ STATUS_STYLE = [
29
+ ("progress", "bold dodger_blue2"),
30
+ ("review", "bold magenta"),
31
+ ("ready", "green3"),
32
+ ("backlog", "grey50"),
33
+ ("block", "bold red3"),
34
+ ("done", "grey50"),
35
+ ]
36
+
37
+
38
+ def fold(value):
39
+ text = unicodedata.normalize("NFD", str(value))
40
+ return "".join(ch for ch in text if unicodedata.category(ch) != "Mn").lower()
41
+
42
+
43
+ def run_board(args):
44
+ node = shutil.which("node")
45
+ if not node:
46
+ sys.exit("node não encontrado: o board.mjs precisa de Node 18+.")
47
+ return subprocess.run([node, str(BOARD), "render", *args], capture_output=True, text=True, encoding="utf-8")
48
+
49
+
50
+ def fallback(args, reason):
51
+ sys.stderr.write(f"{reason} Usando o render do board.mjs.\n")
52
+ node = shutil.which("node")
53
+ if not node:
54
+ sys.exit("node não encontrado: o board.mjs precisa de Node 18+.")
55
+ sys.exit(subprocess.call([node, str(BOARD), "render", *args]))
56
+
57
+
58
+ def priority_cell(row, Text):
59
+ priority = row["priority"]
60
+ cell = Text(f" {priority} ", style=PRIORITY_STYLE.get(priority, "bold"))
61
+ if row["prioritySuggested"]:
62
+ cell.append(" ~", style="dim")
63
+ return cell
64
+
65
+
66
+ def difficulty_cell(row, Text):
67
+ level = row["difficulty"]
68
+ if not level:
69
+ return Text("—", style="dim")
70
+ cell = Text("●" * level, style=DIFFICULTY_STYLE[level])
71
+ cell.append("○" * (3 - level), style="grey42")
72
+ if row["difficultySuggested"]:
73
+ cell.append(" ~", style="dim")
74
+ return cell
75
+
76
+
77
+ def id_cell(row, Text):
78
+ style = f"link {row['url']}" if row.get("url") else ""
79
+ return Text(f"#{row['number']}", style=f"{style} bold".strip())
80
+
81
+
82
+ def title_cell(row, Text):
83
+ cell = Text(row["title"])
84
+ if row["note"]:
85
+ cell.append(f" {row['note']}", style="italic grey58")
86
+ return cell
87
+
88
+
89
+ def status_cell(row, Text):
90
+ status = row["status"] or "—"
91
+ style = next((s for key, s in STATUS_STYLE if key in fold(status)), "")
92
+ return Text(status, style=style)
93
+
94
+
95
+ def header(view, Text, Panel):
96
+ body = Text()
97
+ body.append(f"{view['total']} issues", style="bold")
98
+ for priority, count in view["counts"].items():
99
+ body.append(" ")
100
+ body.append(f" {priority} ", style=PRIORITY_STYLE[priority])
101
+ body.append(f" {count}", style="bold")
102
+ body.append("\n")
103
+ body.append("Dificuldade ", style="dim")
104
+ for level, label in ((1, "fácil"), (2, "média"), (3, "difícil")):
105
+ body.append("●" * level, style=DIFFICULTY_STYLE[level])
106
+ body.append("○" * (3 - level), style="grey42")
107
+ body.append(f" {label} ", style="dim")
108
+ body.append("~ sugestão do agente (campo vazio no board)", style="dim")
109
+ who = view["user"] or "board inteiro"
110
+ return Panel(body, title=f"[bold]Board {view['board']}[/] · {who}", title_align="left", border_style="grey50", expand=False)
111
+
112
+
113
+ def group_table(view, group, Table, Text, box):
114
+ table = Table(
115
+ title=f"[bold]{group['name']}[/] [grey58]({len(group['rows'])})[/]",
116
+ title_justify="left",
117
+ box=box.ROUNDED,
118
+ border_style="grey42",
119
+ header_style="bold grey85",
120
+ expand=True,
121
+ pad_edge=True,
122
+ )
123
+ table.add_column("Pri", no_wrap=True, width=6)
124
+ table.add_column("Dif", no_wrap=True, width=5)
125
+ table.add_column("ID", no_wrap=True, justify="right")
126
+ table.add_column("Repo", no_wrap=True, style="grey70")
127
+ table.add_column("Título", no_wrap=True, overflow="ellipsis", min_width=MIN_TITLE_WIDTH, ratio=1)
128
+ table.add_column("Status", no_wrap=True)
129
+ if view["groupField"]:
130
+ table.add_column(view["groupField"], no_wrap=True, style="grey70")
131
+ if view["groupBy"] != "tipo":
132
+ table.add_column("Tipo", no_wrap=True, style="grey70")
133
+ for row in group["rows"]:
134
+ cells = [
135
+ priority_cell(row, Text),
136
+ difficulty_cell(row, Text),
137
+ id_cell(row, Text),
138
+ row["repo"],
139
+ title_cell(row, Text),
140
+ status_cell(row, Text),
141
+ ]
142
+ if view["groupField"]:
143
+ cells.append(row["group"] or "—")
144
+ if view["groupBy"] != "tipo":
145
+ cells.append(row["type"])
146
+ table.add_row(*cells)
147
+ return table
148
+
149
+
150
+ def main():
151
+ for stream in (sys.stdout, sys.stderr):
152
+ if hasattr(stream, "reconfigure"):
153
+ stream.reconfigure(encoding="utf-8")
154
+ args = sys.argv[1:]
155
+ try:
156
+ from rich import box
157
+ from rich.console import Console
158
+ from rich.panel import Panel
159
+ from rich.table import Table
160
+ from rich.text import Text
161
+ except ImportError:
162
+ fallback(args, "Pacote rich não instalado (pip install rich).")
163
+
164
+ no_color = "--no-color" in args
165
+ board_args = [a for a in args if a not in ("--color", "--no-color")] + ["--json"]
166
+ result = run_board(board_args)
167
+ if result.returncode != 0:
168
+ sys.stderr.write(result.stderr)
169
+ sys.exit(result.returncode)
170
+ view = json.loads(result.stdout)
171
+
172
+ piped = not sys.stdout.isatty()
173
+ console = Console(
174
+ width=WIDTH_WHEN_PIPED if piped else None,
175
+ no_color=no_color,
176
+ force_terminal=True if "--color" in args else None,
177
+ legacy_windows=False,
178
+ )
179
+ if not view["total"]:
180
+ console.print("Nenhuma issue nesse escopo. Tente [bold]--all[/] para ver o board inteiro.")
181
+ return
182
+ console.print(header(view, Text, Panel))
183
+ for group in view["groups"]:
184
+ console.print()
185
+ console.print(group_table(view, group, Table, Text, box))
186
+
187
+
188
+ if __name__ == "__main__":
189
+ main()
@@ -0,0 +1,24 @@
1
+ ---
2
+ name: make-pr
3
+ description: Abre PR da branch atual com base detectada, template do projeto, texto humano em PT-BR e handoff compacto após sucesso. Use para "abrir PR", "make-pr" ou "criar pull request".
4
+ model: sonnet
5
+ ---
6
+
7
+ 1. Confirme que a branch não é `main`/`master`, está limpa e publicada/atualizada no origin. Trabalho pendente: use `/commit-changes` quando autorizado, ou informe o impedimento.
8
+ 2. Resolva `<base>` nesta ordem; nunca assuma `main`:
9
+ - Base explícita em `$ARGUMENTS`: respeite-a.
10
+ - `hotfix/*` ou `revert/*`: produção (`main`, ou `master` se for a disponível).
11
+ - Após `git fetch origin --quiet --prune`, compare as branches remotas com `HEAD` usando `git merge-base` e `git rev-list --count <merge-base>..HEAD`. Escolha a menor distância, excluindo a branch atual e `origin/HEAD`. Empate: `develop`, default do origin, `main`, `master`, demais em ordem alfabética. Isso preserva PRs empilhadas.
12
+ - Sem candidata: `develop` se existir no origin; senão default via `gh repo view --json defaultBranchRef -q .defaultBranchRef.name`.
13
+ - Base automática `main`/`master` com `develop` existente: use `develop`, exceto em `hotfix/*`, `revert/*`, `release/*`.
14
+ Informe a base e o motivo antes de criar.
15
+ 3. Leia `git log origin/<base>..HEAD --oneline`, `git diff --stat origin/<base>...HEAD` e os hunks relevantes. Conte `git diff --name-only origin/<base>...HEAD`: máximo 30 arquivos. Acima disso, proponha divisão coesa antes de abrir PRs menores/empilhadas.
16
+ 4. Execute `exonous template`. Escreva um corpo humano, conciso e em PT-BR, com todos os títulos na ordem do template. No padrão: `## Resumo`, `## Principais mudanças`, `## Arquitetura & implementação`, `## Antes → Agora`, `## Roteiro de teste`. Seção inaplicável mantém título e `_N/A — não aplicável a esta mudança_`. Relate apenas validação observada; sem menção a agentes/IA, créditos ou coautoria. Título convencional em inglês (`type: short description`); `$ARGUMENTS` pode orientar título/contexto.
17
+ 5. Execute `exonous draft-path`, grave o corpo nesse caminho literal e execute `exonous validate-pr <draft-path>`. Corrija falhas antes de continuar.
18
+ 6. Execute como comando isolado (opcionalmente após um `cd <dir> &&`):
19
+ `gh pr create --base <base> --head <current-branch> --title "<title>" --body-file <draft-path>`
20
+ Gate bloqueou: leia a razão, rode `exonous workflow pr`, corrija e tente novamente. Falha do `gh`: reporte; não grave handoff de PR criada.
21
+ 7. **Só após sucesso do `gh`**, preserve a URL retornada e grave silenciosamente um JSON temporário privado com:
22
+ `{"v":1,"k":"pr","g":[["pr","url","<URL retornada>"],["pr","did","<principal mudança concreta>"],["pr","proof","<comando e resultado realmente observado; ou validação pendente>"],["pr","next","<próxima ação concreta>"]]}`
23
+ Resuma o que foi feito em uma tripla `did` curta e concreta. Use valores únicos e referências curtas, sem nós redundantes, narrativa ou segredos. Execute `exonous handoff save --body-file <temporário>`. O helper acrescenta instante/repo/branch/HEAD e salva no único vault central existente. Capture o resultado sem mostrá-lo; `no-vault`, helper ausente ou erro de gravação não transforma a PR criada em falha nem pede/cria vault.
24
+ 8. Remova apenas os temporários desta execução (corpo e handoff). Retorne a URL da PR, sem anúncio adicional sobre o handoff.