forjajs 2.0.4 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (798) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +50 -50
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +133 -133
  16. package/CHANGELOG.md +619 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +64 -60
  19. package/LICENSE +21 -21
  20. package/README.md +404 -343
  21. package/README.pt-BR.md +374 -345
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
  328. package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
  329. package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
  330. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  331. package/dist/apps/server/src/forja-nest.module.js +9 -4
  332. package/dist/apps/server/src/main.js +10 -1
  333. package/dist/bin/create-memory-nest-kit.js +17 -17
  334. package/dist/bin/init-project.js +38 -38
  335. package/dist/lib/audit.js +7 -7
  336. package/dist/lib/code-context.js +6 -0
  337. package/dist/lib/context-builder.js +32 -32
  338. package/dist/lib/core/architecture-gate.d.ts +20 -0
  339. package/dist/lib/core/architecture-gate.js +60 -0
  340. package/dist/lib/core/drift-gate.d.ts +18 -0
  341. package/dist/lib/core/drift-gate.js +55 -0
  342. package/dist/lib/core/gates.d.ts +9 -2
  343. package/dist/lib/core/gates.js +13 -2
  344. package/dist/lib/core/health.js +15 -0
  345. package/dist/lib/core/incident-search.d.ts +19 -0
  346. package/dist/lib/core/incident-search.js +32 -0
  347. package/dist/lib/core/model-pricing.d.ts +31 -0
  348. package/dist/lib/core/model-pricing.js +74 -0
  349. package/dist/lib/core/registry.d.ts +194 -0
  350. package/dist/lib/core/registry.js +194 -0
  351. package/dist/lib/core/release.d.ts +194 -0
  352. package/dist/lib/core/risk-collect.d.ts +19 -0
  353. package/dist/lib/core/risk-collect.js +173 -0
  354. package/dist/lib/drift-sentinel.d.ts +59 -0
  355. package/dist/lib/drift-sentinel.js +126 -0
  356. package/dist/lib/generators/memory-generator.js +691 -691
  357. package/dist/lib/generators/nest-generator.js +412 -398
  358. package/dist/lib/generators/readme-generator.js +180 -180
  359. package/dist/lib/governance-report.js +39 -39
  360. package/dist/lib/workspace.js +29 -29
  361. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  362. package/dist/packages/adapter-git/src/index.js +11 -6
  363. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  364. package/dist/packages/adapter-nest/src/index.js +26 -1
  365. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  366. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  367. package/dist/packages/contracts/src/index.d.ts +33 -0
  368. package/dist/packages/contracts/src/index.js +13 -0
  369. package/dist/packages/core/src/index.d.ts +12 -0
  370. package/dist/packages/core/src/index.js +29 -0
  371. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  372. package/dist/packages/engineering/architecture/src/index.js +131 -0
  373. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  374. package/dist/packages/engineering/evidence/src/index.js +31 -0
  375. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  376. package/dist/packages/engineering/identity/src/index.js +88 -0
  377. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  378. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  379. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  380. package/dist/packages/engineering/provenance/src/index.js +21 -0
  381. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  382. package/dist/packages/engineering/risk/src/index.js +120 -0
  383. package/dist/packages/graph/src/index.d.ts +23 -1
  384. package/dist/packages/graph/src/index.js +88 -15
  385. package/dist/packages/llm/src/index.js +27 -4
  386. package/dist/packages/mcp/src/index.js +27 -8
  387. package/dist/packages/orchestration/src/index.d.ts +11 -1
  388. package/dist/packages/orchestration/src/index.js +34 -7
  389. package/dist/packages/policy/src/index.d.ts +40 -0
  390. package/dist/packages/policy/src/index.js +39 -4
  391. package/dist/packages/runtime/src/index.js +3 -0
  392. package/dist/packages/sandbox/src/index.d.ts +47 -0
  393. package/dist/packages/sandbox/src/index.js +59 -0
  394. package/dist/packages/validator/src/index.d.ts +8 -0
  395. package/dist/packages/validator/src/index.js +21 -6
  396. package/dist/scripts/adr.d.ts +17 -0
  397. package/dist/scripts/adr.js +152 -0
  398. package/dist/scripts/agent-harness.js +72 -64
  399. package/dist/scripts/agent-router.js +20 -20
  400. package/dist/scripts/agent.d.ts +27 -0
  401. package/dist/scripts/agent.js +249 -0
  402. package/dist/scripts/architecture.d.ts +16 -0
  403. package/dist/scripts/architecture.js +186 -0
  404. package/dist/scripts/build-smart-context.js +22 -22
  405. package/dist/scripts/compress-memory.js +8 -8
  406. package/dist/scripts/context-ops.js +29 -29
  407. package/dist/scripts/cost-economy.d.ts +2 -0
  408. package/dist/scripts/cost-economy.js +79 -0
  409. package/dist/scripts/demo-autonomy.js +13 -6
  410. package/dist/scripts/dev.js +13 -13
  411. package/dist/scripts/drift-check.d.ts +17 -0
  412. package/dist/scripts/drift-check.js +63 -0
  413. package/dist/scripts/engineer.d.ts +20 -0
  414. package/dist/scripts/engineer.js +208 -0
  415. package/dist/scripts/evidence.d.ts +12 -0
  416. package/dist/scripts/evidence.js +55 -0
  417. package/dist/scripts/extract-global-knowledge.js +5 -5
  418. package/dist/scripts/gates.d.ts +6 -2
  419. package/dist/scripts/gates.js +14 -4
  420. package/dist/scripts/generate-dashboard.js +11 -11
  421. package/dist/scripts/incident.d.ts +19 -0
  422. package/dist/scripts/incident.js +103 -0
  423. package/dist/scripts/llm-fit.js +32 -3
  424. package/dist/scripts/memory-schema.js +48 -48
  425. package/dist/scripts/provenance.d.ts +14 -0
  426. package/dist/scripts/provenance.js +114 -0
  427. package/dist/scripts/query-universal-memory.js +13 -13
  428. package/dist/scripts/risk.d.ts +15 -0
  429. package/dist/scripts/risk.js +81 -0
  430. package/dist/scripts/simulate.d.ts +20 -0
  431. package/dist/scripts/simulate.js +150 -0
  432. package/dist/scripts/sprint-manager.js +39 -39
  433. package/dist/scripts/sync-universal-memory.js +44 -44
  434. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  435. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  436. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  437. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  438. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  439. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  440. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  441. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  442. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  443. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  444. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  445. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  446. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  447. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  448. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  449. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  450. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  451. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  452. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  453. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  454. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  455. package/docs/agent-harnesses.md +149 -149
  456. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  457. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  458. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  459. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  460. package/docs/archive/FASE2-SUMMARY.md +263 -263
  461. package/docs/archive/FASE3-PROGRESS.md +355 -355
  462. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  463. package/docs/archive/INDICE-MASTER.md +282 -282
  464. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  465. package/docs/archive/README-REFINAMENTO.md +293 -293
  466. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  467. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  468. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  469. package/docs/archive/START-HERE.md +319 -319
  470. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  471. package/docs/archive/examples/v1/AGENTS.md +10 -10
  472. package/docs/archive/examples/v1/README.md +36 -36
  473. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  474. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  475. package/docs/archive/examples/v1/backend/package.json +42 -42
  476. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  477. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  478. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  479. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  480. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  481. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  482. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  483. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  484. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  485. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  486. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  487. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  488. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  489. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  490. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  491. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  492. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  493. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  494. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  495. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  496. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  497. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  498. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  499. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  501. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  502. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  503. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  504. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  505. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  506. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  507. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  508. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  509. package/docs/archive/examples/v2/AGENTS.md +16 -16
  510. package/docs/archive/examples/v2/README.md +35 -35
  511. package/docs/archive/examples/v2/agents/README.md +3 -3
  512. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  513. package/docs/archive/examples/v2/agents/dba.md +4 -4
  514. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  515. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  516. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  517. package/docs/archive/examples/v2/agents/security.md +4 -4
  518. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  519. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  520. package/docs/archive/examples/v2/backend/package.json +42 -42
  521. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  522. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  523. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  524. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  525. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  526. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  527. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  528. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  529. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  530. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  531. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  532. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  533. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  534. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  535. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  536. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  537. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  538. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  539. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  540. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  541. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  542. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  543. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  544. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  545. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  547. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  548. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  549. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  550. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  551. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  552. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  553. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  554. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  555. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  556. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  557. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  558. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  559. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  560. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  561. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  562. package/docs/archive/examples/v2/memory/README.md +8 -8
  563. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  564. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  565. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  566. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  567. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  568. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  569. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  570. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  571. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  572. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  573. package/docs/capacidades-externas.md +86 -86
  574. package/docs/cli-first-operacao.md +74 -74
  575. package/docs/dev-workflow.md +421 -421
  576. package/docs/examples.md +546 -546
  577. package/docs/fluxo.md +103 -103
  578. package/docs/glossary.md +453 -453
  579. package/docs/init-project.md +457 -457
  580. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  581. package/docs/personas/architect/README.md +333 -333
  582. package/docs/personas/developer/README.md +371 -371
  583. package/docs/personas/executive/README.md +172 -172
  584. package/docs/personas/qa/README.md +350 -350
  585. package/docs/processo-projeto.md +138 -138
  586. package/docs/publishing.md +377 -377
  587. package/docs/quick-reference.md +409 -409
  588. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  589. package/docs/structure.md +360 -360
  590. package/docs/token-optimization.md +502 -502
  591. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  592. package/memory/00-global/mission.md +15 -15
  593. package/memory/00-global/shared-knowledge.md +8 -8
  594. package/memory/00-global/standards.md +47 -47
  595. package/memory/10-product/personas.md +21 -21
  596. package/memory/10-product/vision.md +27 -27
  597. package/memory/30-projects/README.md +15 -15
  598. package/memory/40-delivery/backlog.md +15 -15
  599. package/memory/40-delivery/current-sprint.md +20 -20
  600. package/memory/50-orchestration/gsd-harness.md +55 -55
  601. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  602. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  603. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  604. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  605. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  606. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  607. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  608. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  609. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  610. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  611. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  612. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  613. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  614. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  615. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  616. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  617. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  618. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  619. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  620. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  621. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  622. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  623. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  624. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  625. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  626. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  627. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  628. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  630. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  631. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  632. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  633. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  634. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  635. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  637. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  638. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  639. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  640. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  641. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  642. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  643. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  644. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  645. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  646. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  647. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  648. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  649. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  650. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  651. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  652. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  653. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  654. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  655. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  656. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  657. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  658. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  659. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  660. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  661. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  662. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  663. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  664. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  665. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  666. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  667. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  668. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  669. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  670. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  671. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  672. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  673. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  674. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  675. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  676. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  677. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  678. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  679. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  680. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  681. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  682. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  683. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  684. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  685. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  686. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  687. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  688. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  689. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  690. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  691. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  692. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  693. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  694. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  695. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  696. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  697. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  698. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  699. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  700. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  701. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  702. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  703. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  704. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  705. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  706. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  707. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  708. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  709. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  710. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  711. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  712. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  713. package/memory/90-decisions/_template.md +28 -28
  714. package/package.json +157 -157
  715. package/prompts/context-engineer-agent.md +19 -19
  716. package/prompts/governance-agent.md +16 -16
  717. package/prompts/marketing-agent.md +13 -13
  718. package/prompts/orchestrator-agent.md +18 -18
  719. package/prompts/product-agent.md +13 -13
  720. package/prompts/sdd-architect-agent.md +20 -20
  721. package/specs/README.md +70 -70
  722. package/specs/_templates/plan.md +43 -43
  723. package/specs/_templates/spec.md +43 -43
  724. package/specs/_templates/tasks.md +32 -32
  725. package/specs/agent-identity-reputation/plan.md +133 -0
  726. package/specs/agent-identity-reputation/spec.md +125 -0
  727. package/specs/agent-identity-reputation/tasks.md +51 -0
  728. package/specs/agent-runtime-monitoring/plan.md +78 -0
  729. package/specs/agent-runtime-monitoring/spec.md +92 -0
  730. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  731. package/specs/ai-code-provenance/plan.md +71 -0
  732. package/specs/ai-code-provenance/spec.md +97 -0
  733. package/specs/ai-code-provenance/tasks.md +39 -0
  734. package/specs/architecture-constitution/plan.md +110 -0
  735. package/specs/architecture-constitution/spec.md +114 -0
  736. package/specs/architecture-constitution/tasks.md +58 -0
  737. package/specs/change-risk-engine/plan.md +130 -0
  738. package/specs/change-risk-engine/spec.md +119 -0
  739. package/specs/change-risk-engine/tasks.md +72 -0
  740. package/specs/clean-arch-boilerplate/plan.md +137 -137
  741. package/specs/clean-arch-boilerplate/spec.md +121 -121
  742. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  743. package/specs/cli-first-operacao/plan.md +53 -53
  744. package/specs/cli-first-operacao/spec.md +53 -53
  745. package/specs/cli-first-operacao/tasks.md +53 -53
  746. package/specs/code-context/spec.md +56 -56
  747. package/specs/coerencia-do-sistema/plan.md +155 -155
  748. package/specs/coerencia-do-sistema/spec.md +123 -123
  749. package/specs/coerencia-do-sistema/tasks.md +115 -115
  750. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  751. package/specs/dev-token-assets-db/plan.md +71 -71
  752. package/specs/dev-token-assets-db/spec.md +58 -58
  753. package/specs/dev-token-assets-db/tasks.md +58 -58
  754. package/specs/doctor-do-nucleo/plan.md +165 -165
  755. package/specs/doctor-do-nucleo/spec.md +139 -139
  756. package/specs/doctor-do-nucleo/tasks.md +172 -172
  757. package/specs/drift-sentinel/spec.md +117 -0
  758. package/specs/engineer-facade-extension/plan.md +71 -0
  759. package/specs/engineer-facade-extension/spec.md +98 -0
  760. package/specs/engineer-facade-extension/tasks.md +36 -0
  761. package/specs/engineering-evidence-ledger/plan.md +121 -0
  762. package/specs/engineering-evidence-ledger/spec.md +90 -0
  763. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  764. package/specs/engineering-graph-extensions/plan.md +92 -0
  765. package/specs/engineering-graph-extensions/spec.md +101 -0
  766. package/specs/engineering-graph-extensions/tasks.md +60 -0
  767. package/specs/engineering-intelligence/spec.md +177 -0
  768. package/specs/forja-core/spec.md +71 -71
  769. package/specs/gates/spec.md +63 -63
  770. package/specs/governanca-visivel/plan.md +122 -122
  771. package/specs/governanca-visivel/spec.md +112 -112
  772. package/specs/governanca-visivel/tasks.md +60 -60
  773. package/specs/harness-codegraph/spec.md +71 -71
  774. package/specs/learning-loop-incidents/plan.md +59 -0
  775. package/specs/learning-loop-incidents/spec.md +93 -0
  776. package/specs/learning-loop-incidents/tasks.md +36 -0
  777. package/specs/memory-audit/spec.md +54 -54
  778. package/specs/orchestrate/spec.md +108 -108
  779. package/specs/orchestration-coherent/spec.md +95 -95
  780. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  781. package/specs/predictive-change-simulation/plan.md +109 -0
  782. package/specs/predictive-change-simulation/spec.md +107 -0
  783. package/specs/predictive-change-simulation/tasks.md +41 -0
  784. package/specs/project-smoke/spec.md +96 -96
  785. package/specs/project-upgrade/spec.md +58 -58
  786. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  787. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  788. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  789. package/specs/release-auditor-health/spec.md +23 -23
  790. package/specs/release-gate/plan.md +174 -174
  791. package/specs/release-gate/spec.md +122 -122
  792. package/specs/release-gate/tasks.md +183 -183
  793. package/specs/smart-agent-routing/plan.md +55 -0
  794. package/specs/smart-agent-routing/spec.md +85 -0
  795. package/specs/smart-agent-routing/tasks.md +26 -0
  796. package/specs/ts-migration/plan.md +200 -200
  797. package/specs/ts-migration/spec.md +119 -119
  798. package/specs/ts-migration/tasks.md +110 -110
@@ -1,115 +1,115 @@
1
- # Tasks: coerencia-do-sistema
2
-
3
- - **Spec**: ./spec.md
4
- - **Plan**: ./plan.md
5
- - **Status**: done
6
- - **Criado em**: 2026-07-15
7
-
8
- > Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
9
-
10
- Ordem do plano §7: o scanner e seus testes primeiro (nada o consome), depois os três checks, depois
11
- rodar o doctor e corrigir o que ele acusar. O CI pega de graça — `tools:doctor` já é step (ADR-0024).
12
-
13
- ---
14
-
15
- ## T1 — `doc-graph.mjs`: o scanner puro
16
- - **Owner**: Worker
17
- - **Estimativa**: M
18
- - **Depende de**: —
19
- - **Paths**: `lib/core/doc-graph.mjs`, `test/doc-graph.test.js`
20
- - **Escopo**: leitura pura, zero juízo de severidade. É a parte difícil — todo o risco da spec mora
21
- aqui, no não-gerar-falso-positivo.
22
- - **Done quando**:
23
- - [ ] `scanCommands(env)` devolve `{ file, line, command }` para cada `forja <cmd>` / `npm run <cmd>`
24
- onde `<cmd>` tem ao menos um `:` (o discriminador do plano §D4)
25
- - [ ] `scanLinks(env)` devolve `{ file, line, target }` para links markdown **relativos**; ignora
26
- `http(s)://` e âncoras (`#sec`). Link para diretório (`memory/90-decisions/`) conta como alvo
27
- - [ ] `projectCommands(env)` **deriva** a allowlist das keys do bloco `"scripts"` dos
28
- `lib/generators/*.js` — nunca uma lista literal (plano §D2). Retorna Set
29
- - [ ] `DOC_SURFACES` exportado; escaneia `docs/` (menos `archive/`), `prompts/`, `.claude/agents/`
30
- e os `.md` de raiz. **Não** varre `boilerplates/`, `specs/`, `memory/` (plano §D3)
31
- - [ ] `env` injetável (`{ root, fs }`) no padrão de `checks.mjs`, para os testes não tocarem o disco
32
- - [ ] `test/doc-graph.test.js`: fixtures cobrindo comando com/sem `:`, link relativo/http/âncora/
33
- diretório, e a derivação pegando um `"foo:bar"` de um gerador de fixture
34
-
35
- ## T2 — Check `docs-commands` (critical)
36
- - **Owner**: Worker
37
- - **Estimativa**: P
38
- - **Depende de**: T1
39
- - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
40
- - **Done quando**:
41
- - [ ] `scope: 'repo'`, guardado por `isFrameworkRepo(env)` — não roda numa instalação `forjajs`
42
- - [ ] Reprova (critical) quando comando citado ∉ `registry ∪ projectCommands` (AC-1, AC-2)
43
- - [ ] `detail` nomeia `file:line` e o comando ofensor; `fix` diz "renomeie ou remova a citação"
44
- — nunca "não escreva" (kill criteria do plano §8)
45
- - [ ] **Teste do falso positivo (AC-2, a prova de fogo)**: doc citando `npm run start:dev` (comando
46
- do projeto gerado) **não** reprova; doc citando `forja fantasma:x` reprova
47
- - [ ] Teste: comando real do registry citado passa
48
-
49
- ## T3 — Checks `commands-documented` e `docs-links` (warn)
50
- - **Owner**: Worker
51
- - **Estimativa**: P
52
- - **Depende de**: T1
53
- - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
54
- - **Done quando**:
55
- - [ ] `commands-documented` (**warn**): comando do registry citado em nenhuma superfície → aviso
56
- com "documente em algum `.md` ou remova do registry" (AC-3). `worstStatus` não escala warn
57
- - [ ] `docs-links` (**warn**): link relativo sem alvo → aviso com `file:line` e o alvo (AC-4)
58
- - [ ] Ambos `scope: 'repo'`, guardados por `isFrameworkRepo`
59
- - [ ] Teste de cada um nos dois estados (são/quebrado)
60
- - [ ] Teste garantindo que os três checks novos são `skipped` fora do repo do framework
61
-
62
- ## T4 — Rodar o gate e reconciliar a realidade
63
- - **Owner**: Worker
64
- - **Estimativa**: P
65
- - **Depende de**: T2, T3
66
- - **Paths**: `docs/`, `README.md`/`README.en.md`, conforme o gate acusar
67
- - **Escopo**: o primeiro `tools:doctor` com os checks ligados é o teste real — ele deve **concordar
68
- com as correções manuais** já feitas (a doc foi limpa na v1.1.4), não inventar trabalho novo.
69
- - **Done quando**:
70
- - [ ] `forja tools:doctor` roda com os 3 checks e o núcleo fica **verde ou só com warns**
71
- - [ ] Qualquer `docs-commands` crítico remanescente é corrigido na fonte (renomear/remover citação)
72
- - [ ] AC-10: `memory:extract` — documentar numa superfície escaneada **ou** remover do registry.
73
- Decisão de quem conhece o uso; qualquer das duas fecha o `commands-documented` warn
74
- - [ ] `docs-links` warns zerados ou reduzidos a alvos que se decide criar depois (registrar quais)
75
-
76
- ## T5 — Validação executável do AC-2
77
- - **Owner**: Worker
78
- - **Estimativa**: P
79
- - **Depende de**: T2
80
- - **Paths**: `test/health.test.js` (ou um teste dedicado)
81
- - **Escopo**: garantir que a derivação é *real*, não que o teste passou por sorte.
82
- - **Done quando**:
83
- - [ ] Teste que injeta um `"foo:bar"` no bloco `scripts` de um gerador de fixture e confirma que
84
- `docs-commands` passa a **aceitar** `foo:bar` na doc — provando que a allowlist segue o
85
- gerador, não uma lista congelada (plano §7)
86
-
87
- ## T6 — ADR-0025 e CI
88
- - **Owner**: SDD Architect + Worker
89
- - **Estimativa**: P
90
- - **Depende de**: T2, T3, T4
91
- - **Paths**: `memory/90-decisions/0025-*.md`, `.github/workflows/ci.yml` (verificar)
92
- - **Done quando**:
93
- - [ ] ADR-0025 registra D1 (scanner puro), D2 (allowlist derivada) e D3 (escopo = instrução, não
94
- histórico); referencia ADR-0023/0024 (a família de gate, terceira fronteira) e ADR-0021
95
- - [ ] Confirmar que o CI **já** exercita os checks via `tools:doctor` (step do ADR-0024) — não deve
96
- precisar de mudança no workflow; se precisar, ajustar
97
- - [ ] `npm test` verde, `spec:check` verde
98
-
99
- ---
100
-
101
- ## Validação final
102
- - [ ] Renomear um comando do registry num teste e confirmar que `docs-commands` **acusa** a doc que
103
- ainda usa o nome antigo — a métrica de sucesso da spec (renomear vira ato detectável)
104
- - [ ] Suíte completa verde; `tools:doctor` verde/warn; spec → `done`
105
-
106
- ## Nota de implementação — o code-span é endurecimento, não requisito
107
- O plano §4 menciona "só dentro de bloco/span de código". A auditoria manual que originou esta spec
108
- usou **scan de arquivo inteiro** + discriminador `:` e funcionou — os únicos falsos positivos foram
109
- os comandos do projeto gerado, tratados pela allowlist (T2). Começar pelo scan de arquivo inteiro; só
110
- adicionar consciência de code-span **se** T2/T4 revelarem um falso positivo que o `:` não filtre. Não
111
- construir parser de markdown para um problema que ainda não apareceu (plano §6).
112
-
113
- ## Handoffs entre agentes
114
- Worker (T1-T5), SDD Architect (T6). Handoff a cada fronteira via `forja agent:route` — 7 campos
115
- (ADR-0005).
1
+ # Tasks: coerencia-do-sistema
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: done
6
+ - **Criado em**: 2026-07-15
7
+
8
+ > Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
9
+
10
+ Ordem do plano §7: o scanner e seus testes primeiro (nada o consome), depois os três checks, depois
11
+ rodar o doctor e corrigir o que ele acusar. O CI pega de graça — `tools:doctor` já é step (ADR-0024).
12
+
13
+ ---
14
+
15
+ ## T1 — `doc-graph.mjs`: o scanner puro
16
+ - **Owner**: Worker
17
+ - **Estimativa**: M
18
+ - **Depende de**: —
19
+ - **Paths**: `lib/core/doc-graph.mjs`, `test/doc-graph.test.js`
20
+ - **Escopo**: leitura pura, zero juízo de severidade. É a parte difícil — todo o risco da spec mora
21
+ aqui, no não-gerar-falso-positivo.
22
+ - **Done quando**:
23
+ - [ ] `scanCommands(env)` devolve `{ file, line, command }` para cada `forja <cmd>` / `npm run <cmd>`
24
+ onde `<cmd>` tem ao menos um `:` (o discriminador do plano §D4)
25
+ - [ ] `scanLinks(env)` devolve `{ file, line, target }` para links markdown **relativos**; ignora
26
+ `http(s)://` e âncoras (`#sec`). Link para diretório (`memory/90-decisions/`) conta como alvo
27
+ - [ ] `projectCommands(env)` **deriva** a allowlist das keys do bloco `"scripts"` dos
28
+ `lib/generators/*.js` — nunca uma lista literal (plano §D2). Retorna Set
29
+ - [ ] `DOC_SURFACES` exportado; escaneia `docs/` (menos `archive/`), `prompts/`, `.claude/agents/`
30
+ e os `.md` de raiz. **Não** varre `boilerplates/`, `specs/`, `memory/` (plano §D3)
31
+ - [ ] `env` injetável (`{ root, fs }`) no padrão de `checks.mjs`, para os testes não tocarem o disco
32
+ - [ ] `test/doc-graph.test.js`: fixtures cobrindo comando com/sem `:`, link relativo/http/âncora/
33
+ diretório, e a derivação pegando um `"foo:bar"` de um gerador de fixture
34
+
35
+ ## T2 — Check `docs-commands` (critical)
36
+ - **Owner**: Worker
37
+ - **Estimativa**: P
38
+ - **Depende de**: T1
39
+ - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
40
+ - **Done quando**:
41
+ - [ ] `scope: 'repo'`, guardado por `isFrameworkRepo(env)` — não roda numa instalação `forjajs`
42
+ - [ ] Reprova (critical) quando comando citado ∉ `registry ∪ projectCommands` (AC-1, AC-2)
43
+ - [ ] `detail` nomeia `file:line` e o comando ofensor; `fix` diz "renomeie ou remova a citação"
44
+ — nunca "não escreva" (kill criteria do plano §8)
45
+ - [ ] **Teste do falso positivo (AC-2, a prova de fogo)**: doc citando `npm run start:dev` (comando
46
+ do projeto gerado) **não** reprova; doc citando `forja fantasma:x` reprova
47
+ - [ ] Teste: comando real do registry citado passa
48
+
49
+ ## T3 — Checks `commands-documented` e `docs-links` (warn)
50
+ - **Owner**: Worker
51
+ - **Estimativa**: P
52
+ - **Depende de**: T1
53
+ - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
54
+ - **Done quando**:
55
+ - [ ] `commands-documented` (**warn**): comando do registry citado em nenhuma superfície → aviso
56
+ com "documente em algum `.md` ou remova do registry" (AC-3). `worstStatus` não escala warn
57
+ - [ ] `docs-links` (**warn**): link relativo sem alvo → aviso com `file:line` e o alvo (AC-4)
58
+ - [ ] Ambos `scope: 'repo'`, guardados por `isFrameworkRepo`
59
+ - [ ] Teste de cada um nos dois estados (são/quebrado)
60
+ - [ ] Teste garantindo que os três checks novos são `skipped` fora do repo do framework
61
+
62
+ ## T4 — Rodar o gate e reconciliar a realidade
63
+ - **Owner**: Worker
64
+ - **Estimativa**: P
65
+ - **Depende de**: T2, T3
66
+ - **Paths**: `docs/`, `README.md`/`README.en.md`, conforme o gate acusar
67
+ - **Escopo**: o primeiro `tools:doctor` com os checks ligados é o teste real — ele deve **concordar
68
+ com as correções manuais** já feitas (a doc foi limpa na v1.1.4), não inventar trabalho novo.
69
+ - **Done quando**:
70
+ - [ ] `forja tools:doctor` roda com os 3 checks e o núcleo fica **verde ou só com warns**
71
+ - [ ] Qualquer `docs-commands` crítico remanescente é corrigido na fonte (renomear/remover citação)
72
+ - [ ] AC-10: `memory:extract` — documentar numa superfície escaneada **ou** remover do registry.
73
+ Decisão de quem conhece o uso; qualquer das duas fecha o `commands-documented` warn
74
+ - [ ] `docs-links` warns zerados ou reduzidos a alvos que se decide criar depois (registrar quais)
75
+
76
+ ## T5 — Validação executável do AC-2
77
+ - **Owner**: Worker
78
+ - **Estimativa**: P
79
+ - **Depende de**: T2
80
+ - **Paths**: `test/health.test.js` (ou um teste dedicado)
81
+ - **Escopo**: garantir que a derivação é *real*, não que o teste passou por sorte.
82
+ - **Done quando**:
83
+ - [ ] Teste que injeta um `"foo:bar"` no bloco `scripts` de um gerador de fixture e confirma que
84
+ `docs-commands` passa a **aceitar** `foo:bar` na doc — provando que a allowlist segue o
85
+ gerador, não uma lista congelada (plano §7)
86
+
87
+ ## T6 — ADR-0025 e CI
88
+ - **Owner**: SDD Architect + Worker
89
+ - **Estimativa**: P
90
+ - **Depende de**: T2, T3, T4
91
+ - **Paths**: `memory/90-decisions/0025-*.md`, `.github/workflows/ci.yml` (verificar)
92
+ - **Done quando**:
93
+ - [ ] ADR-0025 registra D1 (scanner puro), D2 (allowlist derivada) e D3 (escopo = instrução, não
94
+ histórico); referencia ADR-0023/0024 (a família de gate, terceira fronteira) e ADR-0021
95
+ - [ ] Confirmar que o CI **já** exercita os checks via `tools:doctor` (step do ADR-0024) — não deve
96
+ precisar de mudança no workflow; se precisar, ajustar
97
+ - [ ] `npm test` verde, `spec:check` verde
98
+
99
+ ---
100
+
101
+ ## Validação final
102
+ - [ ] Renomear um comando do registry num teste e confirmar que `docs-commands` **acusa** a doc que
103
+ ainda usa o nome antigo — a métrica de sucesso da spec (renomear vira ato detectável)
104
+ - [ ] Suíte completa verde; `tools:doctor` verde/warn; spec → `done`
105
+
106
+ ## Nota de implementação — o code-span é endurecimento, não requisito
107
+ O plano §4 menciona "só dentro de bloco/span de código". A auditoria manual que originou esta spec
108
+ usou **scan de arquivo inteiro** + discriminador `:` e funcionou — os únicos falsos positivos foram
109
+ os comandos do projeto gerado, tratados pela allowlist (T2). Começar pelo scan de arquivo inteiro; só
110
+ adicionar consciência de code-span **se** T2/T4 revelarem um falso positivo que o `:` não filtre. Não
111
+ construir parser de markdown para um problema que ainda não apareceu (plano §6).
112
+
113
+ ## Handoffs entre agentes
114
+ Worker (T1-T5), SDD Architect (T6). Handoff a cada fronteira via `forja agent:route` — 7 campos
115
+ (ADR-0005).
@@ -0,0 +1,102 @@
1
+ # Spec: orçamento de autonomia por custo real (cost-aware autonomy budget)
2
+
3
+ - **ID**: SPEC-029
4
+ - **Status**: done — AC-1 a AC-6 implementados. Nota de escopo: AC-5 ("por domínio/projeto") foi entregue como custo agregado por MODELO dentro do workspace/DB do projeto (cada projeto já opera seu próprio workspace via `FORJA_WORKSPACE`), não como um campo `projectId` explícito em `Observation` — ver ADR-0077, seção "Alternativas consideradas", para o porquê.
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-08-31
7
+ - **Sprint alvo**: <a definir>
8
+ - **ADRs relacionadas**: ADR-0074 (LLM Fit Loop / adapters de CLI), ADR-0077 (esta spec — orçamento de autonomia por custo real) — este spec estende `PolicyLimits`, que acabou de ganhar enforcement real em `CapabilityRegistry.execute` (auditoria de segurança 2026-08-31)
9
+
10
+ ## 1. Problema
11
+
12
+ `token:economy` **mede e prova** economia de tokens (~40-60% vs. exploração fria), e o LLM Fit Loop já
13
+ roteia entre múltiplos providers por papel/tarefa. Mas nenhum dos dois fala a língua que realmente
14
+ importa pra quem paga a conta: **dinheiro**. Um profile `codex:default` e um `claude:opus` podem gastar
15
+ o mesmo número de tokens e custar ordens de magnitude diferentes. `PolicyLimits` (`maxTokens`,
16
+ `maxFiles`, `maxDurationMs`, `maxRetries`) não tem noção de custo — uma regra de política não consegue
17
+ dizer "esta categoria de trabalho não pode passar de $2 por execução", mesmo que consiga dizer "não
18
+ pode passar de 5000 tokens". Para quem opera múltiplos produtos/clientes ao mesmo tempo (o usuário
19
+ principal do Forja, por definição do próprio README), isso significa descobrir o estouro de custo só
20
+ na fatura do provider — depois do fato, não antes.
21
+
22
+ ## 2. Proposta de valor
23
+
24
+ Toda decisão de política pode declarar um teto de custo real em dólares (`maxCostUsd`), aplicado no
25
+ mesmo ponto onde `maxFiles`/`maxTokens` já são aplicados. `token:economy` ganha uma dimensão de custo
26
+ real (`cost:economy`), calculada a partir de uma tabela de preço por provider — local, versionada no
27
+ repo, sem chamada de rede. **"Economia de tokens" vira "economia de custo"**, mensurável e limitável.
28
+
29
+ ## 3. User stories
30
+
31
+ - **Como** consultor rodando produtos de múltiplos clientes ao mesmo tempo, **quero** definir um teto
32
+ de gasto por sprint ou por categoria de risco, **para que** um agente autônomo não estoure orçamento
33
+ usando um provider caro sem eu perceber até tarde.
34
+ - **Como** dono de um projeto pequeno, **quero** ver quanto cada sprint custou de verdade (não só em
35
+ tokens), **para que** eu decida racionalmente qual provider vale o custo pra qual tipo de tarefa.
36
+ - **Como** governance, **quero** que uma execução seja bloqueada (não só logada) quando ultrapassa o
37
+ teto de custo, **para que** o limite seja um freio real, não uma métrica de retrovisor.
38
+
39
+ ## 4. Critérios de aceite (Definition of Done)
40
+
41
+ - [x] AC-1: `PolicyLimits` ganha `maxCostUsd?: number`; uma regra `ALLOW_WITH_LIMITS` pode declará-lo.
42
+ `packages/policy/src/index.ts`.
43
+ - [x] AC-2: `CapabilityRegistry.execute` (função `checkLimits`, já existente) recusa a chamada com
44
+ `POLICY_LIMIT_EXCEEDED` quando o custo projetado da execução ultrapassa `maxCostUsd` — mesmo
45
+ padrão hoje usado para `maxFiles`/`maxTokens`. `packages/core/src/index.ts` (`CapabilityExecutionRequest.estimatedCostUsd`,
46
+ calculado pelo chamador — ver ADR-0077).
47
+ - [x] AC-3: existe uma tabela de preço por provider/modelo (`$/1K tokens` input e output, separados),
48
+ versionada em arquivo próprio (`lib/core/model-pricing.json`), carregada localmente — sem
49
+ rede. Loader/validador em `lib/core/model-pricing.ts`.
50
+ - [x] AC-4: quando o provider/modelo de uma execução não está na tabela de preço, a execução **não é
51
+ bloqueada** (fail-open para o enforcement de custo especificamente — divergente do resto do
52
+ framework, e por isso citado explicitamente aqui): ela prossegue e um aviso é registrado
53
+ (`llm:doctor` e o próprio `llm:run` avisam em stderr) pedindo para a tabela ser atualizada. Preço
54
+ desconhecido não vira bloqueio de trabalho legítimo. `llm:doctor` também sinaliza preço `stale`
55
+ (> 90 dias sem revisão).
56
+ - [x] AC-5: `cost:economy` — comando novo (não seção em `token:economy`; ver ADR-0077 para o porquê) —
57
+ reporta custo real acumulado por modelo a partir das observações reais do workspace/projeto
58
+ atual. Narrowing: agregação é por modelo dentro do workspace do projeto, não por um campo
59
+ `projectId` explícito em `Observation` (o workspace já é o limite de projeto — ver ADR-0077).
60
+ - [x] AC-6: `Observation.cost` passa a ser populado com o custo real calculado por `forja llm:run`
61
+ quando o preço é conhecido (permanece `0`, como antes desta spec, quando o preço é desconhecido —
62
+ o aviso descrito no AC-4 cobre esse caso).
63
+
64
+ ## 5. Escopo
65
+
66
+ **Dentro**:
67
+ - Extensão de `PolicyLimits`/`PolicyDecision.limits` com `maxCostUsd`.
68
+ - Enforcement em `CapabilityRegistry.checkLimits`.
69
+ - Tabela de preço local, estática, versionada.
70
+ - Cálculo de custo real a partir de tokens de entrada/saída já capturados em `Observation`.
71
+ - Relatório de custo no CLI (`token:economy` estendido ou `cost:economy` novo).
72
+
73
+ **Fora** (explícito, evita scope creep):
74
+ - Integração com billing/API de faturamento real dos providers (Anthropic, OpenAI, etc.) — a tabela é
75
+ estática e mantida manualmente/por PR, não sincronizada automaticamente.
76
+ - Orçamento preditivo ("quanto vai custar antes de rodar") — este spec é sobre limitar e reportar
77
+ custo real medido, não estimar custo futuro.
78
+ - Alertas proativos (Slack, e-mail) — fica para uma spec de notificação, se algum dia existir.
79
+
80
+ ## 6. NFRs / restrições
81
+
82
+ - **Local-first**: nenhuma chamada de rede para obter preço — a tabela vive no repo.
83
+ - **Fail-open por design em um ponto específico**: preço desconhecido não bloqueia (ver AC-4) — é a
84
+ única exceção deliberada ao princípio "autonomia supervisionada por padrão"; deve ficar documentada
85
+ como tal na ADR que resultar deste spec, para não ser lida como inconsistência.
86
+ - **Compatibilidade**: `maxCostUsd` é opcional em todo lugar — regras de política existentes sem esse
87
+ campo continuam funcionando exatamente como hoje.
88
+
89
+ ## 7. Riscos e mitigação
90
+
91
+ | Risco | Probabilidade | Impacto | Mitigação |
92
+ |---|---|---|---|
93
+ | Tabela de preço desatualizada (provider muda preço) | Alta (preços de LLM mudam com frequência) | Média — custo reportado fica impreciso, não custo real cobrado | Preço tem campo `asOf` (data); `llm:doctor` avisa quando `asOf` está velho demais (ex. > 90 dias) |
94
+ | Confundir "custo estimado" com "custo real cobrado" | Média | Média — decisão de negócio baseada em número errado | Nomear explicitamente nos relatórios ("estimativa baseada em tabela local, não fatura") |
95
+ | Escopo crescer para virar um mini sistema de billing | Média | Alta (vira outro projeto) | Este spec para deliberadamente no cálculo local — qualquer integração com billing real vira spec própria |
96
+
97
+ ## 8. Métricas de sucesso
98
+
99
+ 30 dias após o release: um usuário consegue responder "quanto cada projeto/sprint custou de verdade
100
+ em dólares" sem sair do Forja e sem abrir o painel de billing de nenhum provider — e pelo menos uma
101
+ execução real foi bloqueada (ou teria sido, em modo relatório) por estourar `maxCostUsd` antes de gerar
102
+ uma surpresa na fatura.
@@ -1,71 +1,71 @@
1
- # Plan: dev-token-assets-db
2
-
3
- - **Spec**: ./spec.md
4
- - **Status**: approved
5
- - **Criado em**: 2026-06-02
6
-
7
- ## 1. Abordagem tecnica
8
- Adicionar comandos CLI pequenos e aditivos. `context-ops.mjs` gera artefatos compactos e mede token budget. `memory-schema.mjs` cria tabelas auxiliares no SQLite sem alterar contratos existentes. O catalogo de boilerplates/design e derivado dos arquivos atuais, evitando manutencao manual inicial.
9
-
10
- ## 2. Modulos afetados
11
- | Caminho | Mudanca | Risco |
12
- |---|---|---|
13
- | `scripts/context-ops.mjs` | novo CLI para budget, sprint pack, brief e catalogo | M |
14
- | `scripts/memory-schema.mjs` | novo schema auxiliar SQLite | M |
15
- | `package.json` | expor scripts operacionais | B |
16
- | `docs/manual-operacional-cli-sdd-gsd.md` | orientar nova rotina | B |
17
- | `.context/` | novos artefatos gerados | B |
18
-
19
- ## 3. Fluxo
20
- ```text
21
- context:sprint
22
- -> le sprint, specs, handoffs, ADRs
23
- -> gera .context/sprint-pack.md
24
- -> registra context_run no SQLite
25
-
26
- agent:brief <role> <slug>
27
- -> le spec/plan/tasks/runbook/handoffs
28
- -> gera .context/agent-brief-<role>-<slug>.md
29
-
30
- context:budget <slug|arquivo>
31
- -> estima tokens
32
- -> compara com limite
33
- -> falha se exceder
34
-
35
- catalog:assets
36
- -> varre boilerplates/design-md
37
- -> gera .context/asset-catalog.md
38
- -> popula asset_catalog
39
- ```
40
-
41
- ## 4. Contratos
42
- ```bash
43
- npm run memory:schema
44
- npm run context:budget -- <slug|arquivo> [limite]
45
- npm run context:sprint
46
- npm run agent:brief -- <role> <slug>
47
- npm run catalog:assets
48
- npm run token:benchmark
49
- ```
50
-
51
- ## 5. Decisoes
52
- **D1**: Usar SQLite relacional auxiliar em vez de embeddings nesta fase. Motivo: menor complexidade e sem dependencia externa.
53
-
54
- **D2**: Catalogo gerado, nao escrito manualmente. Motivo: reduz drift.
55
-
56
- **D3**: Budget por estimativa simples `chars / 4`. Motivo: suficiente para gate operacional e sem dependencia de tokenizer.
57
-
58
- ## 6. Dependencias
59
- - `better-sqlite3`, ja existente.
60
- - Sem rede e sem pacotes novos.
61
-
62
- ## 7. Rollout
63
- - Criar schema auxiliar.
64
- - Gerar sprint pack e asset catalog.
65
- - Rodar budget nos novos artefatos.
66
- - Atualizar manual.
67
-
68
- ## 8. Sinais de fracasso
69
- - Context pack ultrapassar 8k tokens sem motivo.
70
- - Agent brief repetir spec inteira.
71
- - Catalogo exigir manutencao manual constante.
1
+ # Plan: dev-token-assets-db
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Status**: approved
5
+ - **Criado em**: 2026-06-02
6
+
7
+ ## 1. Abordagem tecnica
8
+ Adicionar comandos CLI pequenos e aditivos. `context-ops.mjs` gera artefatos compactos e mede token budget. `memory-schema.mjs` cria tabelas auxiliares no SQLite sem alterar contratos existentes. O catalogo de boilerplates/design e derivado dos arquivos atuais, evitando manutencao manual inicial.
9
+
10
+ ## 2. Modulos afetados
11
+ | Caminho | Mudanca | Risco |
12
+ |---|---|---|
13
+ | `scripts/context-ops.mjs` | novo CLI para budget, sprint pack, brief e catalogo | M |
14
+ | `scripts/memory-schema.mjs` | novo schema auxiliar SQLite | M |
15
+ | `package.json` | expor scripts operacionais | B |
16
+ | `docs/manual-operacional-cli-sdd-gsd.md` | orientar nova rotina | B |
17
+ | `.context/` | novos artefatos gerados | B |
18
+
19
+ ## 3. Fluxo
20
+ ```text
21
+ context:sprint
22
+ -> le sprint, specs, handoffs, ADRs
23
+ -> gera .context/sprint-pack.md
24
+ -> registra context_run no SQLite
25
+
26
+ agent:brief <role> <slug>
27
+ -> le spec/plan/tasks/runbook/handoffs
28
+ -> gera .context/agent-brief-<role>-<slug>.md
29
+
30
+ context:budget <slug|arquivo>
31
+ -> estima tokens
32
+ -> compara com limite
33
+ -> falha se exceder
34
+
35
+ catalog:assets
36
+ -> varre boilerplates/design-md
37
+ -> gera .context/asset-catalog.md
38
+ -> popula asset_catalog
39
+ ```
40
+
41
+ ## 4. Contratos
42
+ ```bash
43
+ npm run memory:schema
44
+ npm run context:budget -- <slug|arquivo> [limite]
45
+ npm run context:sprint
46
+ npm run agent:brief -- <role> <slug>
47
+ npm run catalog:assets
48
+ npm run token:benchmark
49
+ ```
50
+
51
+ ## 5. Decisoes
52
+ **D1**: Usar SQLite relacional auxiliar em vez de embeddings nesta fase. Motivo: menor complexidade e sem dependencia externa.
53
+
54
+ **D2**: Catalogo gerado, nao escrito manualmente. Motivo: reduz drift.
55
+
56
+ **D3**: Budget por estimativa simples `chars / 4`. Motivo: suficiente para gate operacional e sem dependencia de tokenizer.
57
+
58
+ ## 6. Dependencias
59
+ - `better-sqlite3`, ja existente.
60
+ - Sem rede e sem pacotes novos.
61
+
62
+ ## 7. Rollout
63
+ - Criar schema auxiliar.
64
+ - Gerar sprint pack e asset catalog.
65
+ - Rodar budget nos novos artefatos.
66
+ - Atualizar manual.
67
+
68
+ ## 8. Sinais de fracasso
69
+ - Context pack ultrapassar 8k tokens sem motivo.
70
+ - Agent brief repetir spec inteira.
71
+ - Catalogo exigir manutencao manual constante.
@@ -1,58 +1,58 @@
1
- # Spec: dev-token-assets-db
2
-
3
- - **ID**: SPEC-DEV-TOKEN-ASSETS-001
4
- - **Status**: done
5
- - **Owner**: orchestrator
6
- - **Criado em**: 2026-06-02
7
- - **Sprint alvo**: refinamento-cli-2026-06
8
- - **ADRs relacionadas**: ADR-0003, ADR-0005, ADR-0007, ADR-0008, ADR-0009
9
-
10
- ## 1. Problema
11
- O framework ja possui SDD, GSD, memoria SQLite, boilerplates e design-md, mas ainda consome contexto demais porque nao ha gate de budget por tarefa, resumo compacto por sprint, brief de agente ou catalogo operacional dos assets. Boilerplates e design system tambem existem como arquivos soltos, sem indice consultavel no banco.
12
-
13
- ## 2. Proposta de valor
14
- Transformar contexto, boilerplates, referencias de design e metadados de specs em ativos operacionais compactos, consultaveis por CLI e armazenaveis no SQLite, reduzindo tokens e aumentando velocidade de desenvolvimento.
15
-
16
- ## 3. User stories
17
- - **Como** Orchestrator, **quero** gerar um sprint pack compacto, **para que** qualquer agente comece com contexto minimo suficiente.
18
- - **Como** Worker, **quero** receber um agent brief por papel e feature, **para que** eu nao precise carregar spec/plan/tasks inteiros sempre.
19
- - **Como** Governance, **quero** bloquear contextos acima do budget, **para que** a operacao nao desperdice tokens.
20
- - **Como** Architect, **quero** catalogar boilerplates e referencias de design, **para que** a escolha de base tecnica/visual seja rastreavel.
21
- - **Como** operador do framework, **quero** metadados no SQLite, **para que** memoria, specs e assets sejam consultaveis sem varrer o repositorio inteiro.
22
-
23
- ## 4. Criterios de aceite
24
- - [x] AC-1: `npm run context:budget -- <slug|arquivo>` estima tokens e falha acima do limite.
25
- - [x] AC-2: `npm run context:sprint` gera `.context/sprint-pack.md`.
26
- - [x] AC-3: `npm run agent:brief -- <role> <slug>` gera brief compacto por papel.
27
- - [x] AC-4: `npm run catalog:assets` gera catalogo de boilerplates/design-md.
28
- - [x] AC-5: `npm run memory:schema` cria tabelas auxiliares para summaries, context runs e asset catalog.
29
- - [x] AC-6: boilerplates tem manifests padronizados com stack, casos de uso, comandos e gates.
30
- - [x] AC-7: design-md tem tokens/padroes normalizados por superficie.
31
- - [x] AC-8: `sync:universal` popula tabelas auxiliares automaticamente.
32
-
33
- ## 5. Escopo
34
- **Dentro**:
35
- - CLI para budget, sprint pack, agent brief e catalogo.
36
- - Schema auxiliar SQLite para armazenamento melhor.
37
- - Documentacao operacional da estrategia.
38
-
39
- **Fora**:
40
- - Reescrever todos os boilerplates nesta primeira tranche.
41
- - Migrar dashboard web.
42
- - Implementar embeddings vetoriais.
43
-
44
- ## 6. NFRs / restricoes
45
- - Compatibilidade: manter scripts existentes.
46
- - Token economy: contextos operacionais devem ficar abaixo de 8k tokens por padrao.
47
- - Banco: tabelas novas devem ser aditivas, sem quebrar `memory_nodes` ou `handoffs`.
48
- - Operacao: tudo deve rodar por CLI.
49
-
50
- ## 7. Riscos e mitigacao
51
- | Risco | Probabilidade | Impacto | Mitigacao |
52
- |---|---|---|---|
53
- | Catalogo virar mais uma fonte duplicada | M | M | Gerar via CLI a partir dos arquivos reais |
54
- | Budget bloquear contexto necessario | M | B | Permitir limite customizado por argumento |
55
- | Schema auxiliar ficar desssincronizado | M | M | Planejar AC-8 para integrar ao sync |
56
-
57
- ## 8. Metricas de sucesso
58
- Em 30 dias, reduzir em pelo menos 40% o tamanho medio do contexto inicial por tarefa e manter `context:budget` verde em entregas novas.
1
+ # Spec: dev-token-assets-db
2
+
3
+ - **ID**: SPEC-DEV-TOKEN-ASSETS-001
4
+ - **Status**: done
5
+ - **Owner**: orchestrator
6
+ - **Criado em**: 2026-06-02
7
+ - **Sprint alvo**: refinamento-cli-2026-06
8
+ - **ADRs relacionadas**: ADR-0003, ADR-0005, ADR-0007, ADR-0008, ADR-0009
9
+
10
+ ## 1. Problema
11
+ O framework ja possui SDD, GSD, memoria SQLite, boilerplates e design-md, mas ainda consome contexto demais porque nao ha gate de budget por tarefa, resumo compacto por sprint, brief de agente ou catalogo operacional dos assets. Boilerplates e design system tambem existem como arquivos soltos, sem indice consultavel no banco.
12
+
13
+ ## 2. Proposta de valor
14
+ Transformar contexto, boilerplates, referencias de design e metadados de specs em ativos operacionais compactos, consultaveis por CLI e armazenaveis no SQLite, reduzindo tokens e aumentando velocidade de desenvolvimento.
15
+
16
+ ## 3. User stories
17
+ - **Como** Orchestrator, **quero** gerar um sprint pack compacto, **para que** qualquer agente comece com contexto minimo suficiente.
18
+ - **Como** Worker, **quero** receber um agent brief por papel e feature, **para que** eu nao precise carregar spec/plan/tasks inteiros sempre.
19
+ - **Como** Governance, **quero** bloquear contextos acima do budget, **para que** a operacao nao desperdice tokens.
20
+ - **Como** Architect, **quero** catalogar boilerplates e referencias de design, **para que** a escolha de base tecnica/visual seja rastreavel.
21
+ - **Como** operador do framework, **quero** metadados no SQLite, **para que** memoria, specs e assets sejam consultaveis sem varrer o repositorio inteiro.
22
+
23
+ ## 4. Criterios de aceite
24
+ - [x] AC-1: `npm run context:budget -- <slug|arquivo>` estima tokens e falha acima do limite.
25
+ - [x] AC-2: `npm run context:sprint` gera `.context/sprint-pack.md`.
26
+ - [x] AC-3: `npm run agent:brief -- <role> <slug>` gera brief compacto por papel.
27
+ - [x] AC-4: `npm run catalog:assets` gera catalogo de boilerplates/design-md.
28
+ - [x] AC-5: `npm run memory:schema` cria tabelas auxiliares para summaries, context runs e asset catalog.
29
+ - [x] AC-6: boilerplates tem manifests padronizados com stack, casos de uso, comandos e gates.
30
+ - [x] AC-7: design-md tem tokens/padroes normalizados por superficie.
31
+ - [x] AC-8: `sync:universal` popula tabelas auxiliares automaticamente.
32
+
33
+ ## 5. Escopo
34
+ **Dentro**:
35
+ - CLI para budget, sprint pack, agent brief e catalogo.
36
+ - Schema auxiliar SQLite para armazenamento melhor.
37
+ - Documentacao operacional da estrategia.
38
+
39
+ **Fora**:
40
+ - Reescrever todos os boilerplates nesta primeira tranche.
41
+ - Migrar dashboard web.
42
+ - Implementar embeddings vetoriais.
43
+
44
+ ## 6. NFRs / restricoes
45
+ - Compatibilidade: manter scripts existentes.
46
+ - Token economy: contextos operacionais devem ficar abaixo de 8k tokens por padrao.
47
+ - Banco: tabelas novas devem ser aditivas, sem quebrar `memory_nodes` ou `handoffs`.
48
+ - Operacao: tudo deve rodar por CLI.
49
+
50
+ ## 7. Riscos e mitigacao
51
+ | Risco | Probabilidade | Impacto | Mitigacao |
52
+ |---|---|---|---|
53
+ | Catalogo virar mais uma fonte duplicada | M | M | Gerar via CLI a partir dos arquivos reais |
54
+ | Budget bloquear contexto necessario | M | B | Permitir limite customizado por argumento |
55
+ | Schema auxiliar ficar desssincronizado | M | M | Planejar AC-8 para integrar ao sync |
56
+
57
+ ## 8. Metricas de sucesso
58
+ Em 30 dias, reduzir em pelo menos 40% o tamanho medio do contexto inicial por tarefa e manter `context:budget` verde em entregas novas.