@the-bearded-bear/claude-craft 9.2.0 → 9.2.1

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/Dev/i18n/base/Angular/rules/00-project-context.md.template +1 -1
  2. package/Dev/i18n/base/Angular/rules/03-coding-standards.md +17 -16
  3. package/Dev/i18n/base/Angular/rules/06-tooling.md +2 -2
  4. package/Dev/i18n/base/CSharp/rules/06-tooling.md +8 -6
  5. package/Dev/i18n/base/Common/hooks/scripts/block-dangerous-commands.sh +93 -48
  6. package/Dev/i18n/base/Common/hooks/scripts/guard-network.sh +58 -0
  7. package/Dev/i18n/base/Common/hooks/scripts/lib/hook-io.sh +181 -0
  8. package/Dev/i18n/base/Common/hooks/scripts/notify-slack.sh +21 -32
  9. package/Dev/i18n/base/Common/hooks/scripts/output-filter.sh +23 -0
  10. package/Dev/i18n/base/Common/hooks/scripts/output-size-hint.sh +19 -0
  11. package/Dev/i18n/base/Common/hooks/scripts/post-edit-lint.sh +29 -53
  12. package/Dev/i18n/base/Common/hooks/scripts/post-tool-failure.sh +50 -0
  13. package/Dev/i18n/base/Common/hooks/scripts/pre-commit-check.sh +59 -63
  14. package/Dev/i18n/base/Common/hooks/scripts/pre-compact.sh +52 -0
  15. package/Dev/i18n/base/Common/hooks/scripts/protect-sensitive-files.sh +16 -0
  16. package/Dev/i18n/base/Common/hooks/scripts/quality-gate.sh +49 -92
  17. package/Dev/i18n/base/Common/hooks/scripts/session-end.sh +51 -0
  18. package/Dev/i18n/base/Common/hooks/scripts/session-init.sh +45 -69
  19. package/Dev/i18n/base/Common/hooks/templates/examples/README.md +59 -0
  20. package/Dev/i18n/base/Common/hooks/templates/examples/auto-format.json +18 -0
  21. package/Dev/i18n/base/Common/hooks/templates/examples/block-dangerous-commands.json +18 -0
  22. package/Dev/i18n/base/Common/hooks/templates/examples/context-reinject.json +28 -0
  23. package/Dev/i18n/base/Common/hooks/templates/examples/output-filter.json +18 -0
  24. package/Dev/i18n/base/Common/hooks/templates/examples/pre-compact.json +18 -0
  25. package/Dev/i18n/base/Common/hooks/templates/examples/protect-files.json +18 -0
  26. package/Dev/i18n/base/Common/hooks/templates/examples/security-block.json +18 -0
  27. package/Dev/i18n/base/Common/hooks/templates/examples/stop-hook.json +16 -0
  28. package/Dev/i18n/base/Common/hooks/templates/examples/user-prompt-submit.json +16 -0
  29. package/Dev/i18n/base/Common/hooks/templates/hooks.default.json +72 -0
  30. package/Dev/i18n/base/Common/hooks/templates/{settings-hooks.json → hooks.full.json} +22 -23
  31. package/Dev/i18n/base/Common/hooks/templates/hooks.memory.json +62 -0
  32. package/Dev/i18n/base/Common/templates/AGENTS.md.template +1 -1
  33. package/Dev/i18n/base/Common/templates/settings.json.template +46 -0
  34. package/Dev/i18n/base/Flutter/rules/00-project-context.md.template +9 -9
  35. package/Dev/i18n/base/Laravel/checks/code-quality.md +1 -1
  36. package/Dev/i18n/base/Laravel/rules/00-project-context.md.template +2 -2
  37. package/Dev/i18n/base/Laravel/rules/06-tooling.md +10 -8
  38. package/Dev/i18n/base/Laravel/rules/07-testing-laravel.md +2 -0
  39. package/Dev/i18n/base/Laravel/rules/08-quality-tools.md +2 -2
  40. package/Dev/i18n/base/PHP/rules/00-project-context.md.template +2 -2
  41. package/Dev/i18n/base/Tauri/rules/02-architecture-tauri.md +1 -0
  42. package/Dev/i18n/base/Vercel/checks/all.md +1 -1
  43. package/Dev/i18n/base/Vercel/checks/architecture.md +1 -1
  44. package/Dev/i18n/base/Vercel/rules/02-architecture-vercel.md +4 -2
  45. package/Dev/i18n/base/Vercel/rules/06-tooling.md +7 -5
  46. package/Dev/i18n/base/Vercel/rules/11-security-vercel.md +1 -1
  47. package/Dev/i18n/base/Vite/rules/06-tooling.md +2 -1
  48. package/Dev/i18n/base/Vite/rules/08-quality-tools.md +1 -1
  49. package/Dev/i18n/base/VueJS/rules/06-tooling.md +3 -3
  50. package/Dev/i18n/base/VueJS/rules/07-testing-vuejs.md +9 -8
  51. package/Dev/i18n/base/VueJS/rules/08-quality-tools.md +1 -1
  52. package/Dev/i18n/base/WordPress/checklists/new-feature.md +59 -0
  53. package/Dev/i18n/base/WordPress/checklists/pre-commit.md +125 -0
  54. package/Dev/i18n/base/WordPress/checks/all.md +257 -0
  55. package/Dev/i18n/base/WordPress/checks/architecture.md +157 -0
  56. package/Dev/i18n/base/WordPress/checks/code-quality.md +158 -0
  57. package/Dev/i18n/base/WordPress/checks/security.md +158 -0
  58. package/Dev/i18n/base/WordPress/checks/testing.md +157 -0
  59. package/Dev/i18n/base/WordPress/commands/check.md +28 -0
  60. package/Dev/i18n/base/WordPress/rules/00-project-context.md.template +169 -0
  61. package/Dev/i18n/base/WordPress/rules/02-architecture-wordpress.md +174 -0
  62. package/Dev/i18n/base/WordPress/rules/03-coding-standards.md +98 -0
  63. package/Dev/i18n/base/WordPress/rules/06-tooling.md +146 -0
  64. package/Dev/i18n/base/WordPress/rules/07-testing-wordpress.md +150 -0
  65. package/Dev/i18n/base/WordPress/rules/08-quality-tools.md +161 -0
  66. package/Dev/i18n/base/WordPress/rules/11-security-wordpress.md +175 -0
  67. package/Dev/i18n/base/WordPress/skills/woocommerce/REFERENCE.md +214 -0
  68. package/Dev/i18n/base/WordPress/skills/woocommerce/SKILL.md +40 -0
  69. package/Dev/i18n/base/WordPress/skills/woocommerce/checklist.md +66 -0
  70. package/Dev/i18n/base/WordPress/templates/block.md +235 -0
  71. package/Dev/i18n/base/WordPress/templates/plugin-bootstrap.md +215 -0
  72. package/Dev/i18n/base/WordPress/templates/rest-endpoint.md +246 -0
  73. package/Dev/i18n/de/Angular/CLAUDE.md.template +2 -1
  74. package/Dev/i18n/de/Angular/agents/angular-reviewer.md +23 -7
  75. package/Dev/i18n/de/Common/agents/devops-engineer.md +1 -1
  76. package/Dev/i18n/de/Common/agents/migration-specialist.md +1 -1
  77. package/Dev/i18n/de/Common/commands/ralph-run.md +3 -3
  78. package/Dev/i18n/de/Common/commands/setup-rtk.md +2 -9
  79. package/Dev/i18n/de/Common/hooks/HOOKS-QUICKSTART.md +33 -45
  80. package/Dev/i18n/de/Common/rules/04-solid-principles.md +2 -2
  81. package/Dev/i18n/de/Common/rules/09-git-workflow.md +7 -1
  82. package/Dev/i18n/de/Common/rules/10-documentation.md +2 -2
  83. package/Dev/i18n/de/Common/rules/11-security.md +12 -12
  84. package/Dev/i18n/de/Common/rules/12-context-management.md +5 -3
  85. package/Dev/i18n/de/Flutter/commands/analyze-performance.md +1 -1
  86. package/Dev/i18n/de/Flutter/rules/06-tooling.md +6 -2
  87. package/Dev/i18n/de/Flutter/rules/11-security-flutter.md +1 -1
  88. package/Dev/i18n/de/PHP/rules/03-coding-standards.md +10 -0
  89. package/Dev/i18n/de/PHP/rules/06-tooling.md +7 -3
  90. package/Dev/i18n/de/Paperclip/CLAUDE.md.template +2 -2
  91. package/Dev/i18n/de/Paperclip/README.md +1 -1
  92. package/Dev/i18n/de/Paperclip/checks/security.md +1 -0
  93. package/Dev/i18n/de/Paperclip/rules/11-security-paperclip.md +3 -1
  94. package/Dev/i18n/de/Python/agents/python-reviewer.md +1 -1
  95. package/Dev/i18n/de/Python/checks/code-quality.md +4 -4
  96. package/Dev/i18n/de/Python/checks/security.md +2 -2
  97. package/Dev/i18n/de/Python/checks/testing.md +2 -2
  98. package/Dev/i18n/de/Python/rules/02-architecture.md +1 -8
  99. package/Dev/i18n/de/Python/rules/03-coding-standards.md +16 -5
  100. package/Dev/i18n/de/Python/templates/repository.md +2 -2
  101. package/Dev/i18n/de/React/rules/02-architecture.md +17 -20
  102. package/Dev/i18n/de/React/rules/03-coding-standards.md +15 -16
  103. package/Dev/i18n/de/React/templates/component.md +11 -9
  104. package/Dev/i18n/de/ReactNative/agents/reactnative-reviewer.md +4 -4
  105. package/Dev/i18n/de/ReactNative/rules/06-tooling.md +15 -14
  106. package/Dev/i18n/de/ReactNative/rules/14-navigation.md +2 -0
  107. package/Dev/i18n/de/Ruby/agents/ruby-reviewer.md +1 -1
  108. package/Dev/i18n/de/Ruby/rules/06-tooling.md +2 -2
  109. package/Dev/i18n/de/Ruby/rules/11-security-ruby.md +13 -1
  110. package/Dev/i18n/de/Rust/rules/03-coding-standards.md +1 -1
  111. package/Dev/i18n/de/Rust/rules/11-security-rust.md +1 -1
  112. package/Dev/i18n/de/Symfony/adr/README.md +1 -1
  113. package/Dev/i18n/de/Symfony/checks/code-quality.md +2 -2
  114. package/Dev/i18n/de/Symfony/rules/03-coding-standards.md +15 -0
  115. package/Dev/i18n/de/Symfony/rules/06-docker-hadolint.md +1 -1
  116. package/Dev/i18n/de/Symfony/rules/08-quality-tools.md +1 -3
  117. package/Dev/i18n/de/Symfony/rules/15-doctrine-extensions.md +5 -5
  118. package/Dev/i18n/de/Symfony/rules/16-i18n.md +1 -1
  119. package/Dev/i18n/de/Symfony/templates/README.md +1 -1
  120. package/Dev/i18n/de/Tauri/agents/tauri-reviewer.md +3 -0
  121. package/Dev/i18n/de/Vercel/agents/vercel-reviewer.md +1 -0
  122. package/Dev/i18n/de/Vercel/checks/all.md +1 -1
  123. package/Dev/i18n/de/Vite/agents/vite-reviewer.md +11 -11
  124. package/Dev/i18n/de/WordPress/CLAUDE.md.template +100 -0
  125. package/Dev/i18n/de/WordPress/agents/wordpress-reviewer.md +350 -0
  126. package/Dev/i18n/de/WordPress/checks/all.md +242 -0
  127. package/Dev/i18n/de/WordPress/commands/check.md +28 -0
  128. package/Dev/i18n/en/Angular/CLAUDE.md.template +3 -2
  129. package/Dev/i18n/en/Angular/agents/angular-reviewer.md +23 -7
  130. package/Dev/i18n/en/Common/agents/devops-engineer.md +1 -1
  131. package/Dev/i18n/en/Common/agents/migration-specialist.md +1 -1
  132. package/Dev/i18n/en/Common/commands/ralph-run.md +3 -3
  133. package/Dev/i18n/en/Common/commands/setup-rtk.md +2 -9
  134. package/Dev/i18n/en/Common/hooks/HOOKS-QUICKSTART.md +31 -43
  135. package/Dev/i18n/en/Common/rules/04-solid-principles.md +2 -2
  136. package/Dev/i18n/en/Common/rules/09-git-workflow.md +7 -1
  137. package/Dev/i18n/en/Common/rules/10-documentation.md +2 -2
  138. package/Dev/i18n/en/Common/rules/11-security.md +12 -12
  139. package/Dev/i18n/en/Common/rules/12-context-management.md +5 -3
  140. package/Dev/i18n/en/Flutter/commands/analyze-performance.md +1 -1
  141. package/Dev/i18n/en/Flutter/rules/06-tooling.md +6 -2
  142. package/Dev/i18n/en/Flutter/rules/11-security-flutter.md +1 -1
  143. package/Dev/i18n/en/Laravel/CLAUDE.md.template +1 -1
  144. package/Dev/i18n/en/Laravel/agents/laravel-reviewer.md +3 -3
  145. package/Dev/i18n/en/PHP/rules/03-coding-standards.md +10 -0
  146. package/Dev/i18n/en/PHP/rules/06-tooling.md +7 -3
  147. package/Dev/i18n/en/Paperclip/CLAUDE.md.template +2 -2
  148. package/Dev/i18n/en/Paperclip/README.md +1 -1
  149. package/Dev/i18n/en/Paperclip/checks/security.md +1 -0
  150. package/Dev/i18n/en/Paperclip/rules/11-security-paperclip.md +3 -1
  151. package/Dev/i18n/en/Python/agents/python-reviewer.md +1 -1
  152. package/Dev/i18n/en/Python/checks/code-quality.md +4 -4
  153. package/Dev/i18n/en/Python/checks/security.md +2 -2
  154. package/Dev/i18n/en/Python/checks/testing.md +2 -2
  155. package/Dev/i18n/en/Python/rules/02-architecture.md +1 -8
  156. package/Dev/i18n/en/Python/rules/03-coding-standards.md +16 -5
  157. package/Dev/i18n/en/Python/templates/repository.md +2 -2
  158. package/Dev/i18n/en/React/rules/02-architecture.md +17 -20
  159. package/Dev/i18n/en/React/rules/03-coding-standards.md +15 -16
  160. package/Dev/i18n/en/React/templates/component.md +11 -9
  161. package/Dev/i18n/en/ReactNative/agents/reactnative-reviewer.md +4 -4
  162. package/Dev/i18n/en/ReactNative/rules/02-architecture.md +4 -4
  163. package/Dev/i18n/en/ReactNative/rules/06-tooling.md +15 -14
  164. package/Dev/i18n/en/ReactNative/rules/07-testing-reactnative.md +1 -1
  165. package/Dev/i18n/en/ReactNative/rules/14-navigation.md +2 -0
  166. package/Dev/i18n/en/Ruby/agents/ruby-reviewer.md +1 -1
  167. package/Dev/i18n/en/Ruby/rules/06-tooling.md +2 -2
  168. package/Dev/i18n/en/Ruby/rules/11-security-ruby.md +13 -1
  169. package/Dev/i18n/en/Rust/rules/03-coding-standards.md +1 -1
  170. package/Dev/i18n/en/Rust/rules/11-security-rust.md +1 -1
  171. package/Dev/i18n/en/Symfony/adr/README.md +1 -1
  172. package/Dev/i18n/en/Symfony/checks/code-quality.md +2 -2
  173. package/Dev/i18n/en/Symfony/rules/03-coding-standards.md +15 -0
  174. package/Dev/i18n/en/Symfony/rules/06-docker-hadolint.md +1 -1
  175. package/Dev/i18n/en/Symfony/rules/08-quality-tools.md +1 -3
  176. package/Dev/i18n/en/Symfony/rules/15-doctrine-extensions.md +5 -5
  177. package/Dev/i18n/en/Symfony/rules/16-i18n.md +1 -1
  178. package/Dev/i18n/en/Symfony/templates/README.md +1 -1
  179. package/Dev/i18n/en/Tauri/agents/tauri-reviewer.md +3 -0
  180. package/Dev/i18n/en/Vercel/agents/vercel-reviewer.md +1 -0
  181. package/Dev/i18n/en/Vercel/checks/all.md +1 -1
  182. package/Dev/i18n/en/Vite/agents/vite-reviewer.md +11 -11
  183. package/Dev/i18n/en/WordPress/CLAUDE.md.template +100 -0
  184. package/Dev/i18n/en/WordPress/agents/wordpress-reviewer.md +350 -0
  185. package/Dev/i18n/en/WordPress/checks/all.md +241 -0
  186. package/Dev/i18n/en/WordPress/commands/check.md +28 -0
  187. package/Dev/i18n/es/Angular/CLAUDE.md.template +3 -2
  188. package/Dev/i18n/es/Angular/agents/angular-reviewer.md +23 -7
  189. package/Dev/i18n/es/Common/agents/devops-engineer.md +1 -1
  190. package/Dev/i18n/es/Common/agents/migration-specialist.md +1 -1
  191. package/Dev/i18n/es/Common/commands/ralph-run.md +3 -3
  192. package/Dev/i18n/es/Common/commands/setup-rtk.md +2 -9
  193. package/Dev/i18n/es/Common/hooks/HOOKS-QUICKSTART.md +33 -45
  194. package/Dev/i18n/es/Common/rules/04-solid-principles.md +2 -2
  195. package/Dev/i18n/es/Common/rules/09-git-workflow.md +7 -1
  196. package/Dev/i18n/es/Common/rules/10-documentation.md +2 -2
  197. package/Dev/i18n/es/Common/rules/11-security.md +12 -12
  198. package/Dev/i18n/es/Common/rules/12-context-management.md +5 -3
  199. package/Dev/i18n/es/Flutter/commands/analyze-performance.md +1 -1
  200. package/Dev/i18n/es/Flutter/rules/06-tooling.md +6 -2
  201. package/Dev/i18n/es/Flutter/rules/11-security-flutter.md +1 -1
  202. package/Dev/i18n/es/Laravel/agents/laravel-reviewer.md +2 -2
  203. package/Dev/i18n/es/PHP/rules/03-coding-standards.md +10 -0
  204. package/Dev/i18n/es/PHP/rules/06-tooling.md +7 -3
  205. package/Dev/i18n/es/Paperclip/CLAUDE.md.template +2 -2
  206. package/Dev/i18n/es/Paperclip/README.md +1 -1
  207. package/Dev/i18n/es/Paperclip/checks/security.md +1 -0
  208. package/Dev/i18n/es/Paperclip/rules/11-security-paperclip.md +3 -1
  209. package/Dev/i18n/es/Python/agents/python-reviewer.md +1 -1
  210. package/Dev/i18n/es/Python/checks/code-quality.md +4 -4
  211. package/Dev/i18n/es/Python/checks/security.md +2 -2
  212. package/Dev/i18n/es/Python/checks/testing.md +2 -2
  213. package/Dev/i18n/es/Python/rules/02-architecture.md +1 -8
  214. package/Dev/i18n/es/Python/rules/03-coding-standards.md +16 -5
  215. package/Dev/i18n/es/Python/templates/repository.md +2 -2
  216. package/Dev/i18n/es/React/rules/03-coding-standards.md +15 -16
  217. package/Dev/i18n/es/React/templates/component.md +11 -9
  218. package/Dev/i18n/es/ReactNative/agents/reactnative-reviewer.md +4 -4
  219. package/Dev/i18n/es/ReactNative/rules/06-tooling.md +15 -14
  220. package/Dev/i18n/es/ReactNative/rules/14-navigation.md +2 -0
  221. package/Dev/i18n/es/Ruby/agents/ruby-reviewer.md +1 -1
  222. package/Dev/i18n/es/Ruby/rules/06-tooling.md +2 -2
  223. package/Dev/i18n/es/Ruby/rules/11-security-ruby.md +13 -1
  224. package/Dev/i18n/es/Rust/rules/03-coding-standards.md +1 -1
  225. package/Dev/i18n/es/Rust/rules/11-security-rust.md +1 -1
  226. package/Dev/i18n/es/Symfony/adr/README.md +1 -1
  227. package/Dev/i18n/es/Symfony/checks/code-quality.md +2 -2
  228. package/Dev/i18n/es/Symfony/rules/03-coding-standards.md +15 -0
  229. package/Dev/i18n/es/Symfony/rules/06-docker-hadolint.md +1 -1
  230. package/Dev/i18n/es/Symfony/rules/08-quality-tools.md +1 -3
  231. package/Dev/i18n/es/Symfony/rules/15-doctrine-extensions.md +5 -5
  232. package/Dev/i18n/es/Symfony/rules/16-i18n.md +1 -1
  233. package/Dev/i18n/es/Symfony/templates/README.md +1 -1
  234. package/Dev/i18n/es/Tauri/agents/tauri-reviewer.md +3 -0
  235. package/Dev/i18n/es/Vercel/agents/vercel-reviewer.md +2 -1
  236. package/Dev/i18n/es/Vercel/checks/all.md +1 -1
  237. package/Dev/i18n/es/Vite/agents/vite-reviewer.md +11 -11
  238. package/Dev/i18n/es/WordPress/CLAUDE.md.template +100 -0
  239. package/Dev/i18n/es/WordPress/agents/wordpress-reviewer.md +350 -0
  240. package/Dev/i18n/es/WordPress/checks/all.md +241 -0
  241. package/Dev/i18n/es/WordPress/commands/check.md +28 -0
  242. package/Dev/i18n/fr/Angular/CLAUDE.md.template +3 -2
  243. package/Dev/i18n/fr/Angular/agents/angular-reviewer.md +23 -7
  244. package/Dev/i18n/fr/Common/agents/devops-engineer.md +1 -1
  245. package/Dev/i18n/fr/Common/agents/migration-specialist.md +1 -1
  246. package/Dev/i18n/fr/Common/commands/ralph-run.md +3 -3
  247. package/Dev/i18n/fr/Common/commands/setup-rtk.md +2 -9
  248. package/Dev/i18n/fr/Common/hooks/HOOKS-QUICKSTART.md +32 -44
  249. package/Dev/i18n/fr/Common/rules/04-solid-principles.md +2 -2
  250. package/Dev/i18n/fr/Common/rules/09-git-workflow.md +7 -1
  251. package/Dev/i18n/fr/Common/rules/10-documentation.md +2 -2
  252. package/Dev/i18n/fr/Common/rules/11-security.md +12 -12
  253. package/Dev/i18n/fr/Common/rules/12-context-management.md +5 -3
  254. package/Dev/i18n/fr/Flutter/commands/analyze-performance.md +1 -1
  255. package/Dev/i18n/fr/Flutter/rules/02-architecture.md +4 -4
  256. package/Dev/i18n/fr/Flutter/rules/06-tooling.md +6 -2
  257. package/Dev/i18n/fr/Flutter/rules/11-security-flutter.md +1 -1
  258. package/Dev/i18n/fr/Laravel/CLAUDE.md.template +1 -1
  259. package/Dev/i18n/fr/Laravel/agents/laravel-reviewer.md +3 -3
  260. package/Dev/i18n/fr/PHP/rules/03-coding-standards.md +10 -0
  261. package/Dev/i18n/fr/PHP/rules/06-tooling.md +7 -3
  262. package/Dev/i18n/fr/Paperclip/CLAUDE.md.template +2 -2
  263. package/Dev/i18n/fr/Paperclip/README.md +1 -1
  264. package/Dev/i18n/fr/Paperclip/checks/security.md +1 -0
  265. package/Dev/i18n/fr/Paperclip/rules/11-security-paperclip.md +3 -1
  266. package/Dev/i18n/fr/Python/agents/python-reviewer.md +1 -1
  267. package/Dev/i18n/fr/Python/checks/code-quality.md +4 -4
  268. package/Dev/i18n/fr/Python/checks/security.md +2 -2
  269. package/Dev/i18n/fr/Python/checks/testing.md +2 -2
  270. package/Dev/i18n/fr/Python/commands/dependency-audit.md +1 -2
  271. package/Dev/i18n/fr/Python/commands/generate-endpoint.md +7 -11
  272. package/Dev/i18n/fr/Python/commands/generate-model.md +6 -6
  273. package/Dev/i18n/fr/Python/rules/02-architecture.md +9 -24
  274. package/Dev/i18n/fr/Python/rules/03-coding-standards.md +19 -7
  275. package/Dev/i18n/fr/Python/templates/repository.md +9 -10
  276. package/Dev/i18n/fr/React/commands/generate-component.md +52 -51
  277. package/Dev/i18n/fr/React/rules/02-architecture.md +17 -20
  278. package/Dev/i18n/fr/React/rules/03-coding-standards.md +15 -16
  279. package/Dev/i18n/fr/React/templates/component.md +11 -9
  280. package/Dev/i18n/fr/ReactNative/agents/reactnative-reviewer.md +4 -4
  281. package/Dev/i18n/fr/ReactNative/rules/06-tooling.md +15 -14
  282. package/Dev/i18n/fr/ReactNative/rules/14-navigation.md +2 -0
  283. package/Dev/i18n/fr/Ruby/agents/ruby-reviewer.md +1 -1
  284. package/Dev/i18n/fr/Ruby/rules/06-tooling.md +2 -2
  285. package/Dev/i18n/fr/Ruby/rules/11-security-ruby.md +13 -1
  286. package/Dev/i18n/fr/Rust/rules/03-coding-standards.md +1 -1
  287. package/Dev/i18n/fr/Rust/rules/11-security-rust.md +1 -1
  288. package/Dev/i18n/fr/Symfony/adr/README.md +1 -1
  289. package/Dev/i18n/fr/Symfony/checks/code-quality.md +2 -2
  290. package/Dev/i18n/fr/Symfony/rules/03-coding-standards.md +15 -0
  291. package/Dev/i18n/fr/Symfony/rules/06-docker-hadolint.md +1 -1
  292. package/Dev/i18n/fr/Symfony/rules/08-quality-tools.md +1 -3
  293. package/Dev/i18n/fr/Symfony/rules/15-doctrine-extensions.md +5 -5
  294. package/Dev/i18n/fr/Symfony/rules/16-i18n.md +1 -1
  295. package/Dev/i18n/fr/Symfony/templates/README.md +1 -1
  296. package/Dev/i18n/fr/Tauri/agents/tauri-reviewer.md +3 -0
  297. package/Dev/i18n/fr/Vercel/agents/vercel-reviewer.md +1 -0
  298. package/Dev/i18n/fr/Vercel/checks/all.md +1 -1
  299. package/Dev/i18n/fr/Vite/agents/vite-reviewer.md +11 -11
  300. package/Dev/i18n/fr/WordPress/CLAUDE.md.template +100 -0
  301. package/Dev/i18n/fr/WordPress/agents/wordpress-reviewer.md +350 -0
  302. package/Dev/i18n/fr/WordPress/checks/all.md +242 -0
  303. package/Dev/i18n/fr/WordPress/commands/check.md +28 -0
  304. package/Dev/i18n/pt/Angular/CLAUDE.md.template +3 -2
  305. package/Dev/i18n/pt/Angular/agents/angular-reviewer.md +23 -7
  306. package/Dev/i18n/pt/Common/agents/devops-engineer.md +1 -1
  307. package/Dev/i18n/pt/Common/agents/migration-specialist.md +1 -1
  308. package/Dev/i18n/pt/Common/commands/ralph-run.md +3 -3
  309. package/Dev/i18n/pt/Common/commands/setup-rtk.md +2 -9
  310. package/Dev/i18n/pt/Common/hooks/HOOKS-QUICKSTART.md +33 -45
  311. package/Dev/i18n/pt/Common/rules/04-solid-principles.md +2 -2
  312. package/Dev/i18n/pt/Common/rules/09-git-workflow.md +7 -1
  313. package/Dev/i18n/pt/Common/rules/10-documentation.md +2 -2
  314. package/Dev/i18n/pt/Common/rules/11-security.md +12 -12
  315. package/Dev/i18n/pt/Common/rules/12-context-management.md +5 -3
  316. package/Dev/i18n/pt/Flutter/commands/analyze-performance.md +1 -1
  317. package/Dev/i18n/pt/Flutter/rules/06-tooling.md +6 -2
  318. package/Dev/i18n/pt/Flutter/rules/11-security-flutter.md +1 -1
  319. package/Dev/i18n/pt/Laravel/agents/laravel-reviewer.md +2 -2
  320. package/Dev/i18n/pt/PHP/rules/03-coding-standards.md +10 -0
  321. package/Dev/i18n/pt/PHP/rules/06-tooling.md +7 -3
  322. package/Dev/i18n/pt/Paperclip/CLAUDE.md.template +2 -2
  323. package/Dev/i18n/pt/Paperclip/README.md +1 -1
  324. package/Dev/i18n/pt/Paperclip/checks/security.md +1 -0
  325. package/Dev/i18n/pt/Paperclip/rules/11-security-paperclip.md +3 -1
  326. package/Dev/i18n/pt/Python/agents/python-reviewer.md +1 -1
  327. package/Dev/i18n/pt/Python/checks/code-quality.md +4 -4
  328. package/Dev/i18n/pt/Python/checks/security.md +2 -2
  329. package/Dev/i18n/pt/Python/checks/testing.md +2 -2
  330. package/Dev/i18n/pt/Python/rules/02-architecture.md +1 -8
  331. package/Dev/i18n/pt/Python/rules/03-coding-standards.md +16 -5
  332. package/Dev/i18n/pt/Python/templates/repository.md +2 -2
  333. package/Dev/i18n/pt/React/rules/02-architecture.md +17 -20
  334. package/Dev/i18n/pt/React/rules/03-coding-standards.md +15 -16
  335. package/Dev/i18n/pt/React/templates/component.md +12 -10
  336. package/Dev/i18n/pt/ReactNative/agents/reactnative-reviewer.md +4 -4
  337. package/Dev/i18n/pt/ReactNative/rules/06-tooling.md +15 -14
  338. package/Dev/i18n/pt/ReactNative/rules/14-navigation.md +2 -0
  339. package/Dev/i18n/pt/Ruby/agents/ruby-reviewer.md +1 -1
  340. package/Dev/i18n/pt/Ruby/rules/06-tooling.md +2 -2
  341. package/Dev/i18n/pt/Ruby/rules/11-security-ruby.md +13 -1
  342. package/Dev/i18n/pt/Rust/rules/03-coding-standards.md +1 -1
  343. package/Dev/i18n/pt/Rust/rules/11-security-rust.md +1 -1
  344. package/Dev/i18n/pt/Symfony/adr/README.md +1 -1
  345. package/Dev/i18n/pt/Symfony/checks/code-quality.md +2 -2
  346. package/Dev/i18n/pt/Symfony/rules/03-coding-standards.md +15 -0
  347. package/Dev/i18n/pt/Symfony/rules/06-docker-hadolint.md +1 -1
  348. package/Dev/i18n/pt/Symfony/rules/08-quality-tools.md +1 -3
  349. package/Dev/i18n/pt/Symfony/rules/15-doctrine-extensions.md +5 -5
  350. package/Dev/i18n/pt/Symfony/rules/16-i18n.md +1 -1
  351. package/Dev/i18n/pt/Symfony/templates/README.md +1 -1
  352. package/Dev/i18n/pt/Tauri/agents/tauri-reviewer.md +3 -0
  353. package/Dev/i18n/pt/Vercel/agents/vercel-reviewer.md +1 -0
  354. package/Dev/i18n/pt/Vercel/checks/all.md +1 -1
  355. package/Dev/i18n/pt/Vite/agents/vite-reviewer.md +11 -11
  356. package/Dev/i18n/pt/WordPress/CLAUDE.md.template +100 -0
  357. package/Dev/i18n/pt/WordPress/agents/wordpress-reviewer.md +350 -0
  358. package/Dev/i18n/pt/WordPress/checks/all.md +241 -0
  359. package/Dev/i18n/pt/WordPress/commands/check.md +28 -0
  360. package/Dev/scripts/check-config.sh +1 -1
  361. package/Dev/scripts/install-common-rules.sh +65 -0
  362. package/Dev/scripts/install-from-config.sh +3 -0
  363. package/Dev/scripts/install-paperclip-rules.sh +1 -1
  364. package/Dev/scripts/install-wordpress-rules.sh +153 -0
  365. package/Dev/scripts/lib/merge-hooks.mjs +110 -0
  366. package/Dev/scripts/memory-lifecycle/README.md +10 -9
  367. package/Dev/scripts/memory-lifecycle/_db.sh +1 -1
  368. package/Dev/scripts/memory-lifecycle/post-tool.sh +1 -1
  369. package/Dev/scripts/memory-lifecycle/pre-compact.sh +5 -5
  370. package/Dev/scripts/memory-lifecycle/prompt-submit.sh +1 -1
  371. package/Dev/scripts/memory-lifecycle/session-end.sh +1 -1
  372. package/Dev/scripts/memory-lifecycle/session-start.sh +5 -4
  373. package/Dev/stack-profiles/wordpress/permissions.txt +10 -0
  374. package/Dev/stack-profiles/wordpress/quality.md +4 -0
  375. package/Dev/stack-profiles/wordpress/stack.txt +2 -0
  376. package/Infra/i18n/de/Ansible/agents/ansible-architect.md +3 -1
  377. package/Infra/i18n/de/Ansible/agents/ansible-debug.md +1 -0
  378. package/Infra/i18n/de/Ansible/agents/ansible-deployment.md +3 -0
  379. package/Infra/i18n/de/Ansible/agents/ansible-security.md +2 -0
  380. package/Infra/i18n/de/Ansible/commands/security-audit.md +1 -1
  381. package/Infra/i18n/de/Coolify/agents/coolify-debug.md +1 -0
  382. package/Infra/i18n/de/Coolify/agents/coolify-deployment.md +5 -1
  383. package/Infra/i18n/de/Coolify/commands/coolify-debug.md +1 -0
  384. package/Infra/i18n/de/Coolify/commands/coolify-deploy.md +1 -0
  385. package/Infra/i18n/de/FrankenPHP/agents/frankenphp-architect.md +4 -2
  386. package/Infra/i18n/de/FrankenPHP/agents/frankenphp-deployment.md +2 -2
  387. package/Infra/i18n/de/FrankenPHP/agents/frankenphp-security.md +1 -1
  388. package/Infra/i18n/de/FrankenPHP/commands/deploy-setup.md +1 -1
  389. package/Infra/i18n/de/Hcloud/agents/hcloud-architect.md +16 -14
  390. package/Infra/i18n/de/Hcloud/agents/hcloud-cost.md +11 -9
  391. package/Infra/i18n/de/Hcloud/agents/hcloud-deployment.md +1 -1
  392. package/Infra/i18n/de/Hcloud/agents/hcloud-security.md +1 -1
  393. package/Infra/i18n/de/Hcloud/commands/architecture.md +2 -2
  394. package/Infra/i18n/de/Hcloud/commands/debug.md +3 -3
  395. package/Infra/i18n/de/Kubernetes/agents/kubernetes-architect.md +4 -0
  396. package/Infra/i18n/de/Kubernetes/agents/kubernetes-deployment.md +31 -0
  397. package/Infra/i18n/de/Kubernetes/agents/kubernetes-security.md +5 -1
  398. package/Infra/i18n/de/OpenTofu/agents/opentofu-architect.md +3 -1
  399. package/Infra/i18n/de/OpenTofu/agents/opentofu-deployment.md +2 -2
  400. package/Infra/i18n/de/OpenTofu/agents/opentofu-security.md +5 -5
  401. package/Infra/i18n/de/OpenTofu/commands/security-audit.md +1 -1
  402. package/Infra/i18n/de/PgBouncer/agents/pgbouncer-architect.md +1 -0
  403. package/Infra/i18n/de/PgBouncer/agents/pgbouncer-deployment.md +3 -3
  404. package/Infra/i18n/de/PgBouncer/agents/pgbouncer-monitoring.md +1 -1
  405. package/Infra/i18n/de/PgBouncer/commands/deploy-setup.md +1 -1
  406. package/Infra/i18n/en/Ansible/agents/ansible-architect.md +3 -1
  407. package/Infra/i18n/en/Ansible/agents/ansible-debug.md +1 -0
  408. package/Infra/i18n/en/Ansible/agents/ansible-deployment.md +3 -0
  409. package/Infra/i18n/en/Ansible/agents/ansible-security.md +2 -0
  410. package/Infra/i18n/en/Ansible/commands/security-audit.md +1 -1
  411. package/Infra/i18n/en/Coolify/agents/coolify-debug.md +1 -0
  412. package/Infra/i18n/en/Coolify/agents/coolify-deployment.md +5 -1
  413. package/Infra/i18n/en/Coolify/commands/coolify-debug.md +1 -0
  414. package/Infra/i18n/en/Coolify/commands/coolify-deploy.md +1 -0
  415. package/Infra/i18n/en/FrankenPHP/agents/frankenphp-architect.md +4 -2
  416. package/Infra/i18n/en/FrankenPHP/agents/frankenphp-deployment.md +2 -2
  417. package/Infra/i18n/en/FrankenPHP/agents/frankenphp-security.md +1 -1
  418. package/Infra/i18n/en/FrankenPHP/commands/deploy-setup.md +1 -1
  419. package/Infra/i18n/en/Hcloud/agents/hcloud-architect.md +10 -8
  420. package/Infra/i18n/en/Hcloud/agents/hcloud-cost.md +11 -9
  421. package/Infra/i18n/en/Hcloud/agents/hcloud-deployment.md +1 -1
  422. package/Infra/i18n/en/Kubernetes/agents/kubernetes-architect.md +4 -0
  423. package/Infra/i18n/en/Kubernetes/agents/kubernetes-deployment.md +31 -0
  424. package/Infra/i18n/en/Kubernetes/agents/kubernetes-security.md +5 -1
  425. package/Infra/i18n/en/OpenTofu/agents/opentofu-architect.md +3 -1
  426. package/Infra/i18n/en/OpenTofu/agents/opentofu-deployment.md +2 -2
  427. package/Infra/i18n/en/OpenTofu/agents/opentofu-security.md +5 -5
  428. package/Infra/i18n/en/OpenTofu/commands/security-audit.md +1 -1
  429. package/Infra/i18n/en/PgBouncer/agents/pgbouncer-architect.md +1 -0
  430. package/Infra/i18n/en/PgBouncer/agents/pgbouncer-deployment.md +3 -3
  431. package/Infra/i18n/en/PgBouncer/agents/pgbouncer-monitoring.md +1 -1
  432. package/Infra/i18n/en/PgBouncer/commands/deploy-setup.md +1 -1
  433. package/Infra/i18n/es/Ansible/agents/ansible-architect.md +3 -1
  434. package/Infra/i18n/es/Ansible/agents/ansible-debug.md +1 -0
  435. package/Infra/i18n/es/Ansible/agents/ansible-deployment.md +3 -0
  436. package/Infra/i18n/es/Ansible/agents/ansible-security.md +2 -0
  437. package/Infra/i18n/es/Ansible/commands/security-audit.md +1 -1
  438. package/Infra/i18n/es/Coolify/agents/coolify-debug.md +1 -0
  439. package/Infra/i18n/es/Coolify/agents/coolify-deployment.md +5 -1
  440. package/Infra/i18n/es/Coolify/commands/coolify-debug.md +1 -0
  441. package/Infra/i18n/es/Coolify/commands/coolify-deploy.md +1 -0
  442. package/Infra/i18n/es/FrankenPHP/agents/frankenphp-architect.md +4 -2
  443. package/Infra/i18n/es/FrankenPHP/agents/frankenphp-deployment.md +2 -2
  444. package/Infra/i18n/es/FrankenPHP/agents/frankenphp-security.md +1 -1
  445. package/Infra/i18n/es/FrankenPHP/commands/deploy-setup.md +1 -1
  446. package/Infra/i18n/es/Hcloud/agents/hcloud-architect.md +11 -9
  447. package/Infra/i18n/es/Hcloud/agents/hcloud-cost.md +11 -9
  448. package/Infra/i18n/es/Hcloud/agents/hcloud-deployment.md +1 -1
  449. package/Infra/i18n/es/Hcloud/commands/debug.md +1 -1
  450. package/Infra/i18n/es/Kubernetes/agents/kubernetes-architect.md +4 -0
  451. package/Infra/i18n/es/Kubernetes/agents/kubernetes-deployment.md +31 -0
  452. package/Infra/i18n/es/Kubernetes/agents/kubernetes-security.md +5 -1
  453. package/Infra/i18n/es/OpenTofu/agents/opentofu-architect.md +3 -1
  454. package/Infra/i18n/es/OpenTofu/agents/opentofu-deployment.md +2 -2
  455. package/Infra/i18n/es/OpenTofu/agents/opentofu-security.md +5 -5
  456. package/Infra/i18n/es/OpenTofu/commands/security-audit.md +1 -1
  457. package/Infra/i18n/es/PgBouncer/agents/pgbouncer-architect.md +1 -0
  458. package/Infra/i18n/es/PgBouncer/agents/pgbouncer-deployment.md +3 -3
  459. package/Infra/i18n/es/PgBouncer/agents/pgbouncer-monitoring.md +1 -1
  460. package/Infra/i18n/es/PgBouncer/commands/deploy-setup.md +1 -1
  461. package/Infra/i18n/fr/Ansible/agents/ansible-architect.md +3 -1
  462. package/Infra/i18n/fr/Ansible/agents/ansible-debug.md +1 -0
  463. package/Infra/i18n/fr/Ansible/agents/ansible-deployment.md +3 -0
  464. package/Infra/i18n/fr/Ansible/agents/ansible-security.md +2 -0
  465. package/Infra/i18n/fr/Ansible/commands/security-audit.md +1 -1
  466. package/Infra/i18n/fr/Coolify/agents/coolify-debug.md +1 -0
  467. package/Infra/i18n/fr/Coolify/agents/coolify-deployment.md +5 -1
  468. package/Infra/i18n/fr/Coolify/commands/coolify-debug.md +1 -0
  469. package/Infra/i18n/fr/Coolify/commands/coolify-deploy.md +1 -0
  470. package/Infra/i18n/fr/FrankenPHP/agents/frankenphp-architect.md +4 -2
  471. package/Infra/i18n/fr/FrankenPHP/agents/frankenphp-deployment.md +2 -2
  472. package/Infra/i18n/fr/FrankenPHP/agents/frankenphp-security.md +1 -1
  473. package/Infra/i18n/fr/FrankenPHP/commands/deploy-setup.md +1 -1
  474. package/Infra/i18n/fr/Hcloud/agents/hcloud-architect.md +7 -5
  475. package/Infra/i18n/fr/Hcloud/agents/hcloud-cost.md +11 -9
  476. package/Infra/i18n/fr/Hcloud/agents/hcloud-deployment.md +1 -1
  477. package/Infra/i18n/fr/Kubernetes/agents/kubernetes-architect.md +4 -0
  478. package/Infra/i18n/fr/Kubernetes/agents/kubernetes-deployment.md +31 -0
  479. package/Infra/i18n/fr/Kubernetes/agents/kubernetes-security.md +5 -1
  480. package/Infra/i18n/fr/OpenTofu/agents/opentofu-architect.md +3 -1
  481. package/Infra/i18n/fr/OpenTofu/agents/opentofu-deployment.md +2 -2
  482. package/Infra/i18n/fr/OpenTofu/agents/opentofu-security.md +5 -5
  483. package/Infra/i18n/fr/OpenTofu/commands/security-audit.md +1 -1
  484. package/Infra/i18n/fr/PgBouncer/agents/pgbouncer-architect.md +1 -0
  485. package/Infra/i18n/fr/PgBouncer/agents/pgbouncer-deployment.md +3 -3
  486. package/Infra/i18n/fr/PgBouncer/agents/pgbouncer-monitoring.md +1 -1
  487. package/Infra/i18n/fr/PgBouncer/commands/deploy-setup.md +1 -1
  488. package/Infra/i18n/pt/Ansible/agents/ansible-architect.md +3 -1
  489. package/Infra/i18n/pt/Ansible/agents/ansible-debug.md +1 -0
  490. package/Infra/i18n/pt/Ansible/agents/ansible-deployment.md +3 -0
  491. package/Infra/i18n/pt/Ansible/agents/ansible-security.md +2 -0
  492. package/Infra/i18n/pt/Ansible/commands/security-audit.md +1 -1
  493. package/Infra/i18n/pt/Coolify/agents/coolify-debug.md +1 -0
  494. package/Infra/i18n/pt/Coolify/agents/coolify-deployment.md +5 -1
  495. package/Infra/i18n/pt/Coolify/commands/coolify-debug.md +1 -0
  496. package/Infra/i18n/pt/Coolify/commands/coolify-deploy.md +1 -0
  497. package/Infra/i18n/pt/FrankenPHP/agents/frankenphp-architect.md +4 -2
  498. package/Infra/i18n/pt/FrankenPHP/agents/frankenphp-deployment.md +2 -2
  499. package/Infra/i18n/pt/FrankenPHP/agents/frankenphp-security.md +1 -1
  500. package/Infra/i18n/pt/FrankenPHP/commands/deploy-setup.md +1 -1
  501. package/Infra/i18n/pt/Hcloud/agents/hcloud-architect.md +9 -7
  502. package/Infra/i18n/pt/Hcloud/agents/hcloud-cost.md +11 -9
  503. package/Infra/i18n/pt/Hcloud/agents/hcloud-deployment.md +1 -1
  504. package/Infra/i18n/pt/Hcloud/commands/architecture.md +1 -1
  505. package/Infra/i18n/pt/Hcloud/commands/debug.md +1 -1
  506. package/Infra/i18n/pt/Kubernetes/agents/kubernetes-architect.md +4 -0
  507. package/Infra/i18n/pt/Kubernetes/agents/kubernetes-deployment.md +31 -0
  508. package/Infra/i18n/pt/Kubernetes/agents/kubernetes-security.md +5 -1
  509. package/Infra/i18n/pt/OpenTofu/agents/opentofu-architect.md +3 -1
  510. package/Infra/i18n/pt/OpenTofu/agents/opentofu-deployment.md +2 -2
  511. package/Infra/i18n/pt/OpenTofu/agents/opentofu-security.md +5 -5
  512. package/Infra/i18n/pt/OpenTofu/commands/security-audit.md +1 -1
  513. package/Infra/i18n/pt/PgBouncer/agents/pgbouncer-architect.md +1 -0
  514. package/Infra/i18n/pt/PgBouncer/agents/pgbouncer-deployment.md +3 -3
  515. package/Infra/i18n/pt/PgBouncer/agents/pgbouncer-monitoring.md +1 -1
  516. package/Infra/i18n/pt/PgBouncer/commands/deploy-setup.md +1 -1
  517. package/README.md +27 -15
  518. package/Tools/PluginExport/export-plugin.sh +15 -17
  519. package/Tools/Ralph/README.md +17 -7
  520. package/Tools/Ralph/hooks/lib/ralph-common.sh +101 -0
  521. package/Tools/Ralph/hooks/pre-tool-context.sh +28 -0
  522. package/Tools/Ralph/hooks/session-restore.sh +94 -0
  523. package/Tools/Ralph/hooks/stop-dod-gate.sh +60 -0
  524. package/Tools/Ralph/lib/hooks-generator.sh +109 -93
  525. package/bundles/cursor/.cursorrules +11 -10
  526. package/bundles/windsurf/.windsurfrules +11 -10
  527. package/cli/index.js +1 -0
  528. package/cli/lib/doctor.js +4 -3
  529. package/cli/lib/help.js +1 -0
  530. package/cli/lib/installer.js +1 -1
  531. package/cli/lib/parse-args.js +12 -0
  532. package/cli/lib/tech-registry.js +15 -5
  533. package/package.json +2 -1
  534. package/Dev/i18n/de/Common/hooks/scripts/post-tool-failure.sh +0 -89
  535. package/Dev/i18n/de/Common/hooks/scripts/pre-compact.sh +0 -53
  536. package/Dev/i18n/de/Common/hooks/scripts/session-end.sh +0 -98
  537. package/Dev/i18n/de/Common/templates/settings.json.template +0 -128
  538. package/Dev/i18n/en/Common/hooks/scripts/post-tool-failure.sh +0 -89
  539. package/Dev/i18n/en/Common/hooks/scripts/pre-compact.sh +0 -53
  540. package/Dev/i18n/en/Common/hooks/scripts/session-end.sh +0 -98
  541. package/Dev/i18n/en/Common/templates/settings.json.template +0 -128
  542. package/Dev/i18n/es/Common/hooks/scripts/post-tool-failure.sh +0 -89
  543. package/Dev/i18n/es/Common/hooks/scripts/pre-compact.sh +0 -53
  544. package/Dev/i18n/es/Common/hooks/scripts/session-end.sh +0 -98
  545. package/Dev/i18n/es/Common/templates/settings.json.template +0 -128
  546. package/Dev/i18n/fr/Common/hooks/scripts/post-tool-failure.sh +0 -88
  547. package/Dev/i18n/fr/Common/hooks/scripts/pre-compact.sh +0 -53
  548. package/Dev/i18n/fr/Common/hooks/scripts/session-end.sh +0 -98
  549. package/Dev/i18n/fr/Common/templates/settings.json.template +0 -128
  550. package/Dev/i18n/pt/Common/hooks/scripts/post-tool-failure.sh +0 -89
  551. package/Dev/i18n/pt/Common/hooks/scripts/pre-compact.sh +0 -53
  552. package/Dev/i18n/pt/Common/hooks/scripts/session-end.sh +0 -98
  553. package/Dev/i18n/pt/Common/templates/settings.json.template +0 -128
  554. package/Tools/Ralph/.ralph/hooks/pre-tool-context.sh +0 -100
  555. package/Tools/Ralph/.ralph/hooks/session-restore.sh +0 -118
  556. package/Tools/Ralph/.ralph/hooks/status-injector.sh +0 -147
  557. package/Tools/Ralph/.ralph/hooks/stop-dod-gate.sh +0 -137
@@ -33,7 +33,7 @@ A seguranca e uma **prioridade absoluta**. Este documento apresenta os principio
33
33
  > **Fonte:** [OWASP Top 10:2025](https://owasp.org/Top10/2025/) — publicado novembro 2025.
34
34
  > Principais mudancas vs 2021: SSRF consolidado em A01, Security Misconfiguration sobe para A02, Software Supply Chain Failures novo em A03 (absorve o antigo "Vulnerable and Outdated Components"), Software or Data Integrity Failures em A08, Mishandling of Exceptional Conditions novo em A10.
35
35
 
36
- > **Listas relacionadas:** OWASP Top 10 for Agentic Applications 2026 (publicado em 2025-12-09) e OWASP Top 10 for LLM Applications 2025 ([genai.owasp.org](https://genai.owasp.org/)) para codigo de agentes IA/LLM; OWASP ASVS 5.0.0 para requisitos de verificacao.
36
+ > **Listas relacionadas:** OWASP Top 10 for Agentic Applications 2026 (publicado em 2025-12-09) e OWASP Top 10 for LLM Applications 2026 ([genai.owasp.org](https://genai.owasp.org/home/resources/owasp-genai-llm-top-10-2026/)) para codigo de agentes IA/LLM; OWASP ASVS 5.0.0 para requisitos de verificacao.
37
37
 
38
38
  ### A01. Broken Access Control (inclui SSRF consolidado)
39
39
 
@@ -143,7 +143,7 @@ RISCO
143
143
  - Credential stuffing possivel
144
144
 
145
145
  PROTECAO
146
- - Politica de senhas fortes (min 12 caracteres)
146
+ - Politica de senhas fortes (NIST 800-63B-4: ≥ 15 caracteres sozinha, ≥ 8 com MFA)
147
147
  - MFA para acessos sensiveis
148
148
  - Expiracao de sessoes
149
149
  - Rate limiting no login
@@ -251,9 +251,9 @@ Preferir VALIDACAO (rejeitar) a SANITIZACAO (transformar)
251
251
 
252
252
  ```
253
253
  Regras OWASP 2026:
254
- - Minimo 12 caracteres
255
- - Maiusculas, minusculas, numeros, especiais
256
- - Nao estar em listas de senhas comprometidas
254
+ - Mínimo de 15 caracteres se a senha for o único fator (NIST SP 800-63B-4 SHALL), 8 se usada apenas dentro de um MFA; aceitar pelo menos 64 caracteres
255
+ - Sem regras de composição (NIST: SHALL NOT) — sem maiúsculas/dígitos/especiais obrigatórios
256
+ - Verificar contra uma blocklist de senhas comuns ou comprometidas (NIST SHALL)
257
257
  - Hash com Argon2id (minimo OWASP 19 MiB RAM, t=2, p=1; recomendacao interna 128 MiB RAM, t≥3, p=1)
258
258
  - NUNCA MD5/SHA1 ; bcrypt apenas como alternativa legacy se Argon2id/scrypt nao estiverem disponiveis (work factor OWASP ≥ 10; ≥ 12 aqui)
259
259
  - Salt unico por usuario (gerenciado pelo Argon2id)
@@ -267,7 +267,7 @@ hash = sha1(password + "static_salt")
267
267
  hash = bcrypt.hash(password, costFactor=12) // Nao usar em novo codigo
268
268
  ```
269
269
 
270
- Fontes: [Argon2id OWASP 2026](https://guptadeepak.com/the-complete-guide-to-password-hashing-argon2-vs-bcrypt-vs-scrypt-vs-pbkdf2-2026/)
270
+ Fontes: [OWASP Password Storage Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html), [NIST SP 800-63B-4](https://pages.nist.gov/800-63-4/sp800-63b.html)
271
271
 
272
272
  ### Sessoes
273
273
 
@@ -308,7 +308,7 @@ jwt.sign(payload, ed25519PrivateKey, {
308
308
  })
309
309
  ```
310
310
 
311
- Fontes: [JWT Best Practices 2026](https://duendesoftware.com/learn/best-practices-using-jwts-with-web-and-mobile-apps), [RFC 9449 DPoP](https://datatracker.ietf.org/doc/html/rfc9449)
311
+ Fontes: [RFC 8725 JWT BCP](https://www.rfc-editor.org/rfc/rfc8725), [RFC 9449 DPoP](https://datatracker.ietf.org/doc/html/rfc9449)
312
312
 
313
313
  ### Multi-Factor Authentication (MFA)
314
314
 
@@ -484,7 +484,7 @@ Content-Security-Policy:
484
484
 
485
485
  ## Supply Chain
486
486
 
487
- > **Referencia:** [Supply Chain Security 2026](https://kawaldeepsingh.medium.com/practical-software-supply-chain-security-2026-sboms-signing-slsa-reproducible-builds-a-0416cfac32dc)
487
+ > **Referencia:** [SLSA 1.2](https://slsa.dev/spec/v1.2/), [CycloneDX](https://cyclonedx.org/specification/overview/)
488
488
 
489
489
  ### SLSA 1.2 (Supply-chain Levels for Software Artifacts)
490
490
 
@@ -701,12 +701,12 @@ Antes de instalar um servidor MCP de terceiros:
701
701
  - **OWASP Top 10:2025:** [owasp.org/Top10/2025/](https://owasp.org/Top10/2025/)
702
702
  - **OWASP Cheat Sheets:** [cheatsheetseries.owasp.org](https://cheatsheetseries.owasp.org/)
703
703
  - **CWE Top 25:** [cwe.mitre.org/top25](https://cwe.mitre.org/top25/)
704
- - **NIST Guidelines:** [nist.gov](https://www.nist.gov/cyberframework)
705
- - **Argon2id 2026:** [Guia completo](https://guptadeepak.com/the-complete-guide-to-password-hashing-argon2-vs-bcrypt-vs-scrypt-vs-pbkdf2-2026/)
704
+ - **NIST SP 800-63B-4:** [pages.nist.gov](https://pages.nist.gov/800-63-4/sp800-63b.html)
705
+ - **OWASP Password Storage Cheat Sheet:** [cheatsheetseries.owasp.org](https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html)
706
706
  - **RFC 9449 DPoP:** [datatracker.ietf.org](https://datatracker.ietf.org/doc/html/rfc9449)
707
- - **JWT Best Practices 2026:** [duendesoftware.com](https://duendesoftware.com/learn/best-practices-using-jwts-with-web-and-mobile-apps)
707
+ - **RFC 8725 JWT BCP:** [rfc-editor.org](https://www.rfc-editor.org/rfc/rfc8725)
708
708
  - **HTTP Security Headers 2026:** [thibautprobst.fr](https://thibautprobst.fr/en/posts/http-security-headers/)
709
- - **Supply Chain 2026:** [kawaldeepsingh.medium.com](https://kawaldeepsingh.medium.com/practical-software-supply-chain-security-2026-sboms-signing-slsa-reproducible-builds-a-0416cfac32dc)
709
+ - **SLSA 1.2 / CycloneDX:** [slsa.dev](https://slsa.dev/spec/v1.2/), [cyclonedx.org](https://cyclonedx.org/specification/overview/)
710
710
 
711
711
  ---
712
712
 
@@ -176,6 +176,8 @@ Esses campos permitem otimizar os custos e o escopo dos sub-agentes.
176
176
 
177
177
  O Claude Code compacta automaticamente o contexto quando se aproxima dos limites da janela. Mensagens antigas sao resumidas para liberar espaco.
178
178
 
179
+ > **Histórico append-only (Opus 5.5, Fable 5.x, Mythos 5.x):** modificar uma mensagem anterior, reconstruir `system` ou `tools`, ou resumir turnos antigos no lugar invalida os blocos de thinking seguintes. Acrescentar ao final do histórico em vez de reescrevê-lo. Fonte: [prompting best practices](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices).
180
+
179
181
  ### Compactacao proativa
180
182
 
181
183
  A partir de 70% de contexto usado, executar `/compact` proativamente para evitar uma compactacao automatica nao controlada.
@@ -362,8 +364,8 @@ Ajustar o nível de esforço do modelo de acordo com a complexidade da tarefa:
362
364
 
363
365
  > **O esforço não troca de modelo:** ajusta a profundidade de raciocínio do modelo atual; o modelo é escolhido com `/model`. Pares recomendados: `low` com Haiku 5.5, `medium` com Sonnet 5.5, `high`/`xhigh` com Opus 5.5.
364
366
 
365
- > **Esforço padrão por modelo:** medium no Opus 5.5 e Haiku 5.5; high no Sonnet 5.5, Fable 5.1 e modelos legacy.
366
- > **Fable 5.1** (`claude-fable-5-1`, $10/$50 por Mtok) é um modelo atual, adequado para agentes criativos/narrativos. **Mythos** tem disponibilidade limitada (apenas Cyber Verification Program).
367
+ > **Esforço padrão por modelo:** medium no Opus 5.5 e Haiku 5.5; high no Sonnet 5.5, Fable 5.2 e modelos legacy.
368
+ > **Fable 5.2** (`claude-fable-5-2`, $8/$40 por Mtok) é o modelo Fable atual, adequado para agentes criativos/narrativos; Fable 5.1 e Fable 5 continuam disponíveis (legacy). No Fable 5.2 (como no Mythos 5.2) o raciocínio está sempre ativo (apenas modo adaptive): para reduzi-lo, baixe o esforço — uma instrução «responda diretamente» não basta a partir de `medium`. **Mythos** tem disponibilidade limitada (apenas Cyber Verification Program). A leitura de cache custa 5 % do preço de entrada no Opus/Sonnet 5.5 e 2,5 % no Fable 5.x e Mythos 5.x.
367
369
 
368
370
  ### Alerta de inatividade (v2.1.84+)
369
371
 
@@ -500,7 +502,7 @@ Durante a compactacao, sempre preservar:
500
502
  | `CLAUDE_CODE_DISABLE_NESTED_SESSION_ID` | `1` num runner self-hosted: `claude -p` executado dentro de uma sessão reutiliza o ID e a transcrição dessa sessão (comportamento anterior à v2.1.317) |
501
503
  | `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` | `1` interrompe a obtenção de feature flags sem desativar a telemetria; cada flag usa seu valor padrão embutido (v2.1.319+) |
502
504
  | `CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND` | `1` faz o Claude Code aguardar uma tarefa MCP dentro da chamada de ferramenta em vez de movê-la para segundo plano (v2.1.319+) |
503
- | `permissions.denyInsteadOfPrompting` (setting) | `true`: uma chamada que aguardaria um prompt de permissão é negada e o turno continua — terminal, sub-agentes, teammates (v2.1.319+) |
505
+ | `permissions.denyInsteadOfPrompting` (setting) | `true`: uma chamada que aguardaria um prompt de permissão é negada e o turno continua — terminal, sub-agentes, teammates; respeitado apenas a partir de `~/.claude/settings.json` ou `--settings`, não de um arquivo de projeto (v2.1.319+) |
504
506
  | `ENABLE_PROMPT_CACHING_1H` / `FORCE_PROMPT_CACHING_5M` | Ampliar/forçar o prompt caching (−40 % em sessões repetitivas) |
505
507
  | `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Definir como `1` para desativar a memória automática |
506
508
 
@@ -105,7 +105,7 @@ ListView.builder(
105
105
  itemCount: items.length,
106
106
  itemBuilder: (context, index) => ItemWidget(item: items[index]),
107
107
  // Otimizações adicionais
108
- cacheExtent: 500, // Pré-renderização
108
+ scrollCacheExtent: const ScrollCacheExtent.pixels(500), // Pré-renderização
109
109
  addAutomaticKeepAlives: false, // Se não precisar manter o estado
110
110
  )
111
111
 
@@ -570,18 +570,22 @@ Flutter 3.47 requer **AGP 9.0+**. Atualizar `android/build.gradle`:
570
570
  // android/build.gradle
571
571
  buildscript {
572
572
  dependencies {
573
- classpath 'com.android.tools.build:gradle:9.0.0' // AGP 9
573
+ classpath 'com.android.tools.build:gradle:9.1.0' // AGP 9.1 (KGP 2.4.0, Java 17+)
574
574
  }
575
575
  }
576
576
  ```
577
577
 
578
578
  ```properties
579
579
  # android/gradle/wrapper/gradle-wrapper.properties
580
- distributionUrl=https\://services.gradle.org/distributions/gradle-9.0-bin.zip
580
+ distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-bin.zip
581
581
  ```
582
582
 
583
583
  **Breaking AGP 9:** `android.enableR8.fullMode=true` por padrão (proguard mais agressivo); verificar regras de keep para reflexão.
584
584
 
585
+ **Matriz Android verificada (Flutter 3.47):** Java 17 no mínimo, KGP 2.4.0, AGP 9.1.0, Gradle 9.3.1; valores padrão `flutter.compileSdkVersion` / `flutter.targetSdkVersion` = API 36, `flutter.minSdkVersion` = API 24. iOS mínimo 15 e macOS mínimo 12; o Xcode 27 exige o ciclo de vida `UIScene` (um app sem UIScene não inicia). **Segurança:** usar Flutter ≥ 3.47.8, que bloqueia as chaves de CA eMudhra comprometidas (GHSA-frr6-h895-5pxp). Fontes: https://blog.flutter.dev (what's new in Flutter 3.47), https://docs.flutter.dev/release/release-notes.
586
+
587
+ **Xcode (Flutter 3.47):** `flutter doctor` exige Xcode 15 no mínimo e recomenda Xcode 16 (`packages/flutter_tools/lib/src/macos/xcode.dart`, tag 3.47.0); a documentação oficial pede "a versão mais recente" e menciona o Xcode 27 (simulador renomeado para Device Hub). **Compatibilidade `freezed` 4.0.3 / `json_serializable` 6.15.2:** compatíveis (pub.dev), `analyzer` comum 14.x (`>=14.0.0 <15.0.0` no freezed, `>=10.0.0 <15.0.0` no json_serializable), `source_gen` 4.x, `build` 4-5 e `json_annotation` 4.12.x.
588
+
585
589
  ### Deprecações Material / Cupertino (Flutter 3.47)
586
590
 
587
591
  Vários componentes legacy estão deprecados:
@@ -7,7 +7,7 @@
7
7
  ```dart
8
8
  // pubspec.yaml
9
9
  dependencies:
10
- flutter_secure_storage: ^9.0.0
10
+ flutter_secure_storage: ^11.2.0
11
11
 
12
12
  // Uso
13
13
  class SecureStorageService {
@@ -319,7 +319,7 @@ $key = config('services.stripe.key');
319
319
 
320
320
  | Criterio | Pontos |
321
321
  |----------|--------|
322
- | PHPStan level 8+, Pint configurado, zero dd()/dump() | 6 |
322
+ | PHPStan level 10, Pint configurado, zero dd()/dump() | 6 |
323
323
  | Features PHP 8.5 (readonly, enums, match, named args) | 5 |
324
324
  | Convencoes Laravel respeitadas (nomenclatura, estrutura) | 5 |
325
325
  | config() ao inves de env(), Eloquent casts e scopes | 4 |
@@ -740,7 +740,7 @@ class OrderController extends Controller
740
740
 
741
741
  | Ferramenta | Uso |
742
742
  |------------|-----|
743
- | **PHPStan** level 8+ | Analise estatica estrita |
743
+ | **PHPStan** level 10 | Analise estatica estrita |
744
744
  | **Laravel Pint** | Formatacao PSR-12 / Laravel |
745
745
  | **Pest PHP** | Testes unitarios e feature |
746
746
  | **Laravel Telescope** | Debug em desenvolvimento |
@@ -319,6 +319,16 @@ class User
319
319
 
320
320
  ## Type Declarations
321
321
 
322
+ ### PHP 8.5 — Novidades e depreciações
323
+
324
+ - Cast `(void)`: marca um valor de retorno como ignorado de propósito e silencia o aviso de `#[\NoDiscard]`.
325
+ - `#[\Override]` agora pode ser aplicado a propriedades.
326
+ - `Closure::getCurrent()` retorna a closure em execução (recursão sem `use (&$fn)`).
327
+ - `curl_share_init_persistent(array $share_options)`: handle de compartilhamento persistente entre requisições (reutilização de DNS/conexões); `CURL_LOCK_DATA_COOKIE` é proibido (`ValueError`).
328
+ - `__sleep()` / `__wakeup()` estão em depreciação suave (soft-deprecated): implementar `__serialize()` / `__unserialize()`. Também depreciados: o operador backtick, os casts `(boolean)`/`(integer)`/`(double)`/`(binary)`, `case X;`, `null` como offset de array.
329
+
330
+ Fonte: https://www.php.net/manual/en/migration85.php
331
+
322
332
  ### Strict Types
323
333
 
324
334
  ```php
@@ -1,5 +1,9 @@
1
1
  # PHP Development Tools
2
2
 
3
+ > **Nível de patch:** visar PHP ≥ 8.5.12 (22 out. 2026), que inclui correções de segurança (Core GHSA-w8hw-w9fx-j79w e GHSA-6wmf-4rv5-p3rp, Lexbor, Opcache, SOAP, etc.). Fonte: https://www.php.net/ChangeLog-8.php#8.5.12
4
+
5
+ > **PHP 8.6 (a acompanhar):** 8.6.0 está em RC5 (não estável, ainda fora das versões suportadas); continuar mirando 8.5.x. Fonte: https://www.php.net/supported-versions.php
6
+
3
7
  ## Composer - Dependency Management
4
8
 
5
9
  ### Essential Commands
@@ -51,9 +55,9 @@ composer validate
51
55
  "psr/container": "^2.0"
52
56
  },
53
57
  "require-dev": {
54
- "phpstan/phpstan": "^2.0",
55
- "friendsofphp/php-cs-fixer": "^3.0",
56
- "rector/rector": "^2.4",
58
+ "phpstan/phpstan": "^2.3",
59
+ "friendsofphp/php-cs-fixer": "^3.95",
60
+ "rector/rector": "^2.8",
57
61
  "pestphp/pest": "^5.3"
58
62
  },
59
63
  "autoload": {
@@ -4,8 +4,8 @@
4
4
 
5
5
  ## O Que (Stack & Estrutura)
6
6
 
7
- **Stack**: Node.js 24.11+ LTS, TypeScript 5.x (strict), React 19+, Vitest 4.1+, pnpm 9.15+, PostgreSQL 15+
8
- **Paperclip**: 2026.1012.0+ (MIT) — https://docs.paperclip.ing/
7
+ **Stack**: Node.js 24.11+ LTS, TypeScript 5.x (strict), React 19+, Vitest 5.0+, pnpm 9.15+, PostgreSQL 15+
8
+ **Paperclip**: 2026.1106.0+ (MIT) — https://docs.paperclip.ing/
9
9
 
10
10
  **Paperclip é um sistema de duas camadas**: um plano de controle (server + web + DB) que possui todo o estado de governança, e adaptadores que executam trabalho e reportam de volta. Adaptadores nunca decidem orçamentos ou aprovações.
11
11
 
@@ -15,7 +15,7 @@ Este diretório contém as regras, comandos, skills e templates do Claude-Craft
15
15
  | React | 19+ (web UI) |
16
16
  | Vitest | 4.1+ |
17
17
  | PostgreSQL | 15+ (or embedded for dev) |
18
- | Paperclip | 2026.1012.0+ |
18
+ | Paperclip | 2026.1106.0+ |
19
19
 
20
20
  ## O que há aqui
21
21
 
@@ -32,6 +32,7 @@ Grep para padrões suspeitos: `req.body.companyId`, `req.query.companyId`, `WHER
32
32
  ### 4. Orçamentos (limites rígidos)
33
33
 
34
34
  - [ ] Existe um teste que verifica que `BUDGET_EXCEEDED` é retornado quando um agente excede seu orçamento
35
+ - [ ] O uso sem tarifa (modelos sem preço) é revisado: desde 2026.1023.0 a configuração `unpricedUsagePolicy` da política de orçamento (uso sem tarifa) vale `block` por padrão, então os orçamentos bloqueiam em vez de continuar silenciosamente; nunca mudá-la para `allow` sem uma decisão orçamentária explícita
35
36
  - [ ] Nenhum caminho de código incrementa consumo além de `budgetTokens` silenciosamente
36
37
  - [ ] Mudanças de orçamento emitem eventos de atividade
37
38
 
@@ -141,7 +141,7 @@ Ajuste fontes script/style CSP se a UI requer CDNs especificos; caso contrario m
141
141
  - [ ] Activity log append-only, forcado DB onde possivel
142
142
  - [ ] Kill switch + plugin disable testados
143
143
 
144
- ## Notas de atualização: mudanças incompatíveis (2026.916.0 a 2026.1012.0)
144
+ ## Notas de atualização: mudanças incompatíveis (2026.916.0 a 2026.1106.0)
145
145
 
146
146
  Verificado nas notas de versão oficiais do GitHub (paperclipai/paperclip).
147
147
 
@@ -149,6 +149,8 @@ Verificado nas notas de versão oficiais do GitHub (paperclipai/paperclip).
149
149
  - **2026.1001.0**: o broker Composio legacy foi aposentado (sem migração automática; substituto: Composio Connect atrás do flag `enableMcpAggregators`). Os harnesses de execução passam a **full auto por padrão**: ACPX/Claude `approve-all`, OpenCode `allow`, Codex `never` (sem pausas de aprovação). Para manter os portões de aprovação do provedor, definir explicitamente um modo restritivo por agente: `acpxPermissionMode` (`approve-paperclip`, `approve-reads` ou `deny-all`) ou `opencodePermissionMode` (`ask` ou `deny`). As aprovações governadas do Paperclip continuam valendo.
150
150
  - **2026.1005.0**: `PAPERCLIP_CLOUD_UI_SNIPPET` / `PAPERCLIP_CLOUD_UI_SNIPPET_B64` não injetam mais HTML (migrar a integração para uma contribuição de UI de plugin); uma @-menção em um comentário de tarefa é apenas contexto e não inicia mais um run (somente atribuição explícita ou pedidos de revisão iniciam).
151
151
  - **2026.1012.0**: os locks de restauração de workspace agora são locks de arquivo SQLite em `<instance root>/locks/directory-merge/`: parar todos os processos antigos de servidor e worker antes de atualizar ou reverter; tool grants com seletores desconhecidos ou restrições malformadas agora negam o acesso (revisar os grants personalizados).
152
+ - **2026.1023.0**: o preset do papel Operator passa de uma única permissão (`tasks:assign`) para catorze (os Operators existentes as recebem na inicialização: revisar quem possui o papel); convidar um Admin agora exige aprovação de entrada e convidar um Owner exige também o gerenciamento de permissões de membros; os bots de revisão do GitHub passam para trás da configuração experimental `enableGitHubReviewBots` (desativada por padrão); os orçamentos agora bloqueiam por padrão o uso sem tarifa (a configuração `unpricedUsagePolicy` da política de orçamento (uso sem tarifa) vale `block` por padrão; `allow` mantém os runs em andamento); proprietários e admins não veem mais as tarefas privadas por padrão (leitura «break-glass» auditada com `?breakGlass=true`) e a leitura direta de uma tarefa privada por um não membro retorna `404`; tarefas e projetos privados (compartilhados com pessoas e agentes nomeados; invisíveis em listas, busca, transcrições e plugins para os demais); cada agente recebe um par de chaves Ed25519 persistente, cifrado em repouso (`PAPERCLIP_AGENT_KEY_ID`, `PAPERCLIP_AGENT_PUBLIC_KEY`, `PAPERCLIP_AGENT_PRIVATE_KEY` para processos gerenciados: nunca registrar a chave privada); gateways de modelo BYO via Connectors (OpenRouter, Amazon Bedrock, Google Gemini, endpoints Responses/Messages/Chat Completions).
153
+ - **2026.1106.0**: o experimento Pipelines foi removido (comandos CLI `pipelines`, permissão `pipelines:write`; um valor `enablePipelines` armazenado é ignorado); falhas de run não chegam mais ao Sentry por padrão (definir `PAPERCLIP_SENTRY_RUN_FAILURES` como `unexpected` ou `all` para continuar reportando); o endpoint do histórico de runs retorna 200 linhas por padrão e no máximo 1.000 (passar um `limit` explícito); `paperclipai agent instructions-file:delete` exige `--yes`; os novos agentes usam por padrão o Paperclip Runner em hosts qualificados, que exige GNU libc 2.39 ou superior no Linux (caso contrário, usar a opção «Legacy runner» em Advanced); GitHub Copilot passa a ser um harness nativo (CLI 1.0.88, token do GitHub salvo); a observabilidade dos agentes pode ser exportada para Braintrust ou um endpoint OTLP HTTP personalizado (Company Settings → General → Agent observability, desativada por padrão).
152
154
 
153
155
  ---
154
156
 
@@ -14,7 +14,7 @@ skills: [solid-principles, testing-python, security]
14
14
 
15
15
  ## Identidade
16
16
 
17
- Sou um especialista em revisao de codigo Python 3.14+ com foco em aplicacoes FastAPI. Minha abordagem visa os erros especificos do Python: chamadas bloqueantes em codigo async, a cobertura de type hints com Pydantic v2, a gestao de sessoes SQLAlchemy, e os anti-patterns classicos do Python (argumentos mutaveis por padrao, estado global). Nao faco uma auditoria generica -- detecto o que provoca deadlocks, vazamentos de memoria ou bugs sutis em producao.
17
+ Sou um especialista em revisao de codigo Python 3.14+ com foco em aplicacoes FastAPI. Minha abordagem visa os erros especificos do Python: chamadas bloqueantes em codigo async, a cobertura de type hints com Pydantic v2, a gestao de sessoes SQLAlchemy, e os anti-patterns classicos do Python (argumentos mutaveis por padrao, estado global). Nao faco uma auditoria generica -- detecto o que provoca deadlocks, vazamentos de memoria ou bugs sutis em producao. Também conheço as novidades do Python 3.15 (estável desde 9 de outubro de 2026): imports preguiçosos explícitos (PEP 810), `frozendict`, `sentinel` e o pacote `profiling`.
18
18
 
19
19
  ## Sistema de pontuacao (100 pontos)
20
20
 
@@ -22,7 +22,7 @@ Verificar conformidade com convenções Python:
22
22
  - [ ] Espaços: ao redor de operadores, após vírgulas
23
23
  - [ ] Docstrings: presentes para módulos, classes, funções públicas
24
24
 
25
- **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.11 python -m flake8 /app --max-line-length=88`
25
+ **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.15 python -m flake8 /app --max-line-length=88`
26
26
 
27
27
  **Referência**: `rules/03-coding-standards.md` seção "PEP 8 Compliance"
28
28
 
@@ -35,7 +35,7 @@ Verificar uso de tipagem estática:
35
35
  - [ ] Uso de `typing` para tipos complexos (Optional, Union, List, Dict)
36
36
  - [ ] Sem erros de MyPy em modo strict
37
37
 
38
- **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.11 python -m mypy /app --strict`
38
+ **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.15 python -m mypy /app --strict`
39
39
 
40
40
  **Referência**: `rules/03-coding-standards.md` seção "Type Hints"
41
41
 
@@ -48,7 +48,7 @@ Analisar código com Ruff (substitui Flake8, isort, pydocstyle):
48
48
  - [ ] Complexidade ciclomática aceitável (<10)
49
49
  - [ ] Regras de segurança respeitadas (regras S)
50
50
 
51
- **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.11 pip install ruff && ruff check /app`
51
+ **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.15 pip install ruff && ruff check /app`
52
52
 
53
53
  **Referência**: `rules/06-tooling.md` seção "Linting and Formatting"
54
54
 
@@ -60,7 +60,7 @@ Verificar consistência de formatação:
60
60
  - [ ] Sem diferenças após `black --check`
61
61
  - [ ] Comprimento de linha consistente (88 caracteres)
62
62
 
63
- **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.11 pip install black && black --check /app`
63
+ **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.15 pip install black && black --check /app`
64
64
 
65
65
  **Referência**: `rules/06-tooling.md` seção "Code Formatting"
66
66
 
@@ -22,7 +22,7 @@ Escanear código com Bandit para detectar vulnerabilidades:
22
22
  - [ ] Sem injeção de comando shell
23
23
  - [ ] Criptografia segura (não MD5/SHA1)
24
24
 
25
- **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.11 sh -c "pip install bandit && bandit -r /app -f json"`
25
+ **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.15 sh -c "pip install bandit && bandit -r /app -f json"`
26
26
 
27
27
  **Referência**: `rules/06-tooling.md` seção "Security Analysis"
28
28
 
@@ -67,7 +67,7 @@ Analisar dependências para vulnerabilidades conhecidas:
67
67
  - [ ] Uso de `pip-audit` ou `safety`
68
68
  - [ ] Sem dependências obsoletas
69
69
 
70
- **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.11 sh -c "pip install pip-audit && pip-audit --requirement /app/requirements.txt"`
70
+ **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.15 sh -c "pip install pip-audit && pip-audit --requirement /app/requirements.txt"`
71
71
 
72
72
  **Referência**: `rules/06-tooling.md` seção "Dependency Management"
73
73
 
@@ -32,7 +32,7 @@ Medir cobertura de testes:
32
32
  - [ ] Arquivos críticos a 100%
33
33
  - [ ] Configuração de cobertura em pyproject.toml
34
34
 
35
- **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.11 sh -c "pip install pytest pytest-cov && pytest /app --cov=/app --cov-report=term-missing"`
35
+ **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.15 sh -c "pip install pytest pytest-cov && pytest /app --cov=/app --cov-report=term-missing"`
36
36
 
37
37
  **Referência**: `rules/07-testing.md` seção "Code Coverage"
38
38
 
@@ -91,7 +91,7 @@ Analisar performance dos testes:
91
91
  - [ ] Configuração Pytest em pyproject.toml
92
92
  - [ ] CI/CD com execução automática de testes
93
93
 
94
- **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.11 sh -c "pip install pytest && pytest /app -v --duration=10"`
94
+ **Comando**: Executar `docker run --rm -v $(pwd):/app python:3.15 sh -c "pip install pytest && pytest /app -v --duration=10"`
95
95
 
96
96
  **Referência**: `rules/07-testing.md` seção "Test Performance"
97
97
 
@@ -217,11 +217,8 @@ Entidades são objetos com uma identidade única.
217
217
 
218
218
  ```python
219
219
  # src/myproject/domain/entities/user.py
220
- from __future__ import annotations
221
-
222
220
  from dataclasses import dataclass, field
223
221
  from datetime import datetime
224
- from typing import Optional
225
222
  from uuid import UUID, uuid4
226
223
 
227
224
  from myproject.domain.value_objects.email import Email
@@ -242,7 +239,7 @@ class User:
242
239
  name: str = field(default="")
243
240
  is_active: bool = field(default=True)
244
241
  created_at: datetime = field(default_factory=datetime.utcnow)
245
- updated_at: Optional[datetime] = field(default=None)
242
+ updated_at: datetime | None = field(default=None)
246
243
 
247
244
  # Eventos de domínio (padrão Event Sourcing)
248
245
  _events: list = field(default_factory=list, init=False, repr=False)
@@ -314,8 +311,6 @@ Value objects são imutáveis e definidos por seus atributos.
314
311
 
315
312
  ```python
316
313
  # src/myproject/domain/value_objects/email.py
317
- from __future__ import annotations
318
-
319
314
  from dataclasses import dataclass
320
315
  from email_validator import validate_email, EmailNotValidError
321
316
 
@@ -359,8 +354,6 @@ class Email:
359
354
 
360
355
 
361
356
  # src/myproject/domain/value_objects/money.py
362
- from __future__ import annotations
363
-
364
357
  from dataclasses import dataclass
365
358
  from decimal import Decimal, ROUND_HALF_UP
366
359
  from typing import Union
@@ -67,7 +67,7 @@ Use docstrings estilo Google para todos os módulos, classes e funções públic
67
67
  def calculate_order_total(
68
68
  items: list[OrderItem],
69
69
  tax_rate: Decimal,
70
- discount: Optional[Decimal] = None
70
+ discount: Decimal | None = None
71
71
  ) -> Money:
72
72
  """
73
73
  Calcula o valor total de um pedido.
@@ -103,7 +103,7 @@ Tipifique todos os parâmetros de função e valores de retorno.
103
103
  ### Tipos Básicos
104
104
 
105
105
  ```python
106
- from typing import Optional, Union
106
+ from typing import Union
107
107
  from decimal import Decimal
108
108
  from datetime import datetime
109
109
 
@@ -118,7 +118,7 @@ def process_user(
118
118
  pass
119
119
 
120
120
  # Optional (nullable)
121
- def find_user(user_id: str) -> Optional[User]:
121
+ def find_user(user_id: str) -> User | None:
122
122
  """Retorna User ou None se não encontrado."""
123
123
  pass
124
124
 
@@ -192,7 +192,7 @@ T = TypeVar('T')
192
192
  class Repository(Generic[T]):
193
193
  """Repositório genérico."""
194
194
 
195
- def find_by_id(self, entity_id: str) -> Optional[T]:
195
+ def find_by_id(self, entity_id: str) -> T | None:
196
196
  pass
197
197
 
198
198
  def save(self, entity: T) -> T:
@@ -203,6 +203,18 @@ user_repo: Repository[User] = UserRepository()
203
203
  product_repo: Repository[Product] = ProductRepository()
204
204
  ```
205
205
 
206
+ ### Novidades do Python 3.15
207
+
208
+ O Python 3.15 (estável desde 9 de outubro de 2026) traz, entre outras coisas:
209
+ - **PEP 810**: imports preguiçosos explícitos (`lazy import json`, apenas no nível do módulo).
210
+ - **PEP 814** (`frozendict`): dicionário imutável nativo.
211
+ - **PEP 661** (`sentinel`): tipo nativo para valores sentinela únicos (substitui os `_MISSING = object()` artesanais).
212
+ - **PEP 686 / PEP 798**: UTF-8 por padrão em `open()` sem `encoding`; desempacotamento `*` / `**` em compreensões.
213
+ - **PEP 799** (`profiling`): `profiling.tracing` (antes `cProfile`, mantido como alias) e `profiling.sampling` (profiler estatístico Tachyon); o módulo `profile` está obsoleto (remoção no 3.17).
214
+ - **`re.prefixmatch()`**: nome explícito de `re.match()`, agora "soft deprecated".
215
+
216
+ Source: docs.python.org/3.15/whatsnew/3.15.html
217
+
206
218
  ## Tratamento de Erros
207
219
 
208
220
  ### Exceções Específicas
@@ -382,7 +394,6 @@ src/myproject/
382
394
  import os
383
395
  import sys
384
396
  from datetime import datetime
385
- from typing import Optional
386
397
 
387
398
  # 2. Terceiros
388
399
  from fastapi import FastAPI
@@ -20,7 +20,7 @@ O padrão Repository:
20
20
  # src/myproject/domain/repositories/[entity]_repository.py
21
21
  """Interface para repository de [Entity]."""
22
22
 
23
- from typing import Optional, Protocol
23
+ from typing import Protocol
24
24
  from uuid import UUID
25
25
 
26
26
  from myproject.domain.entities.[entity] import [Entity]
@@ -54,7 +54,7 @@ class [Entity]Repository(Protocol):
54
54
  """
55
55
  ...
56
56
 
57
- def find_by_id(self, entity_id: UUID) -> Optional[[Entity]]:
57
+ def find_by_id(self, entity_id: UUID) -> [Entity] | None:
58
58
  """
59
59
  Encontrar [entity] por ID.
60
60
 
@@ -272,33 +272,30 @@ export const Button: FC<ButtonProps> = ({
272
272
 
273
273
  ```typescript
274
274
  // components/atoms/Input/Input.tsx
275
- import { FC, InputHTMLAttributes, forwardRef } from 'react';
275
+ import { InputHTMLAttributes, Ref } from 'react';
276
276
  import { cn } from '@/utils/classnames';
277
277
 
278
278
  export interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
279
279
  error?: boolean;
280
280
  fullWidth?: boolean;
281
+ ref?: Ref<HTMLInputElement>; // React 19: ref is a regular prop
281
282
  }
282
283
 
283
- export const Input = forwardRef<HTMLInputElement, InputProps>(
284
- ({ error, fullWidth, className, ...props }, ref) => {
285
- return (
286
- <input
287
- ref={ref}
288
- className={cn(
289
- 'px-3 py-2 border rounded-md outline-none transition-colors',
290
- 'focus:ring-2 focus:ring-blue-500',
291
- error && 'border-red-500 focus:ring-red-500',
292
- fullWidth && 'w-full',
293
- className
294
- )}
295
- {...props}
296
- />
297
- );
298
- }
299
- );
300
-
301
- Input.displayName = 'Input';
284
+ export const Input = ({ error, fullWidth, className, ref, ...props }: InputProps) => {
285
+ return (
286
+ <input
287
+ ref={ref}
288
+ className={cn(
289
+ 'px-3 py-2 border rounded-md outline-none transition-colors',
290
+ 'focus:ring-2 focus:ring-blue-500',
291
+ error && 'border-red-500 focus:ring-red-500',
292
+ fullWidth && 'w-full',
293
+ className
294
+ )}
295
+ {...props}
296
+ />
297
+ );
298
+ };
302
299
  ```
303
300
 
304
301
  #### 2. Moléculas
@@ -512,30 +512,29 @@ export const UserCardCustom: FC<UserCardProps> = memo(
512
512
  );
513
513
  ```
514
514
 
515
- ### 3. forwardRef para Refs
515
+ ### 3. `ref` como prop (React 19+; `forwardRef` é legacy)
516
+
517
+ No React 19, `ref` é uma prop comum e o `forwardRef` não é mais necessário (legacy, mantido apenas para compatibilidade com React 17/18). Fonte: [react.dev/reference/react/forwardRef](https://react.dev/reference/react/forwardRef).
516
518
 
517
519
  ```typescript
518
- import { forwardRef, InputHTMLAttributes } from 'react';
520
+ import { InputHTMLAttributes, Ref } from 'react';
519
521
 
520
522
  interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
521
523
  label?: string;
522
524
  error?: string;
525
+ ref?: Ref<HTMLInputElement>;
523
526
  }
524
527
 
525
- // Componente com forwardRef
526
- export const Input = forwardRef<HTMLInputElement, InputProps>(
527
- ({ label, error, ...props }, ref) => {
528
- return (
529
- <div>
530
- {label && <label>{label}</label>}
531
- <input ref={ref} {...props} />
532
- {error && <span>{error}</span>}
533
- </div>
534
- );
535
- }
536
- );
537
-
538
- Input.displayName = 'Input';
528
+ // Componente com `ref` como prop (React 19)
529
+ export const Input = ({ label, error, ref, ...props }: InputProps) => {
530
+ return (
531
+ <div>
532
+ {label && <label>{label}</label>}
533
+ <input ref={ref} {...props} />
534
+ {error && <span>{error}</span>}
535
+ </div>
536
+ );
537
+ };
539
538
 
540
539
  // Uso
541
540
  const MyForm = () => {
@@ -119,33 +119,35 @@ export const ComponentName: FC<ComponentNameProps> = ({
119
119
  };
120
120
  ```
121
121
 
122
- ## Com forwardRef
122
+ ## Com `ref` como prop (React 19)
123
123
 
124
124
  ```typescript
125
- import { forwardRef, ButtonHTMLAttributes } from 'react';
125
+ import { ButtonHTMLAttributes, Ref } from 'react';
126
126
  import { cn } from '@/utils/classnames';
127
127
 
128
128
  interface ComponentNameProps
129
129
  extends ButtonHTMLAttributes<HTMLButtonElement> {
130
130
  variant?: 'primary' | 'secondary';
131
+ ref?: Ref<HTMLButtonElement>;
131
132
  }
132
133
 
133
- export const ComponentName = forwardRef<
134
- HTMLButtonElement,
135
- ComponentNameProps
136
- >(({ variant = 'primary', className, children, ...props }, ref) => {
134
+ export const ComponentName = ({
135
+ variant = 'primary',
136
+ className,
137
+ children,
138
+ ref,
139
+ ...props
140
+ }: ComponentNameProps) => {
137
141
  return (
138
142
  <button
139
143
  ref={ref}
140
- className={cn('classes-base', `variant-${variant}`, className)}
144
+ className={cn('base-classes', `variant-${variant}`, className)}
141
145
  {...props}
142
146
  >
143
147
  {children}
144
148
  </button>
145
149
  );
146
- });
147
-
148
- ComponentName.displayName = 'ComponentName';
150
+ };
149
151
  ```
150
152
 
151
153
  ## Padrao Container/Presenter