forjajs 2.0.3 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (701) 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 +68 -59
  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 +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -339
  21. package/README.pt-BR.md +345 -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/dashboard-client.jsx +10 -10
  328. package/dist/bin/create-memory-nest-kit.js +17 -17
  329. package/dist/bin/forja.js +14 -2
  330. package/dist/bin/init-project.js +38 -38
  331. package/dist/lib/audit.js +7 -7
  332. package/dist/lib/context-builder.js +32 -32
  333. package/dist/lib/core/doc-graph.js +6 -4
  334. package/dist/lib/core/registry.d.ts +54 -0
  335. package/dist/lib/core/registry.js +55 -0
  336. package/dist/lib/core/release.d.ts +53 -0
  337. package/dist/lib/core/release.js +5 -1
  338. package/dist/lib/generators/memory-generator.js +700 -698
  339. package/dist/lib/generators/nest-generator.js +398 -398
  340. package/dist/lib/generators/readme-generator.js +180 -180
  341. package/dist/lib/governance-report.js +39 -39
  342. package/dist/lib/project-upgrade.js +1 -1
  343. package/dist/lib/workspace.d.ts +7 -0
  344. package/dist/lib/workspace.js +63 -34
  345. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  346. package/dist/packages/llm/src/index.d.ts +43 -0
  347. package/dist/packages/llm/src/index.js +108 -0
  348. package/dist/scripts/agent-harness.js +66 -64
  349. package/dist/scripts/agent-router.js +20 -20
  350. package/dist/scripts/build-smart-context.js +22 -22
  351. package/dist/scripts/compress-memory.js +8 -8
  352. package/dist/scripts/context-ops.js +29 -29
  353. package/dist/scripts/demo-autonomy.js +2 -2
  354. package/dist/scripts/demo-workspace.d.ts +6 -0
  355. package/dist/scripts/demo-workspace.js +101 -0
  356. package/dist/scripts/dev.js +13 -13
  357. package/dist/scripts/extract-global-knowledge.js +5 -5
  358. package/dist/scripts/generate-dashboard.js +11 -11
  359. package/dist/scripts/llm-fit.js +131 -0
  360. package/dist/scripts/memory-schema.js +48 -48
  361. package/dist/scripts/query-universal-memory.js +13 -13
  362. package/dist/scripts/sprint-manager.js +39 -39
  363. package/dist/scripts/sync-universal-memory.js +63 -50
  364. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  365. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  366. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  367. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  368. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  369. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  370. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  371. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  372. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  373. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  374. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  375. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  376. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  377. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  378. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  379. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  380. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  381. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  382. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  383. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  384. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  385. package/docs/agent-harnesses.md +149 -149
  386. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  387. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  388. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  389. package/docs/archive/FASE2-SUMMARY.md +263 -263
  390. package/docs/archive/FASE3-PROGRESS.md +355 -355
  391. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  392. package/docs/archive/INDICE-MASTER.md +282 -282
  393. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  394. package/docs/archive/README-REFINAMENTO.md +293 -293
  395. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  396. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  397. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  398. package/docs/archive/START-HERE.md +319 -319
  399. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  400. package/docs/archive/examples/v1/AGENTS.md +10 -10
  401. package/docs/archive/examples/v1/README.md +36 -36
  402. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  403. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  404. package/docs/archive/examples/v1/backend/package.json +42 -42
  405. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  406. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  407. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  408. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  409. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  410. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  411. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  412. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  413. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  414. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  415. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  416. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  417. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  418. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  419. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  420. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  421. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  422. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  423. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  424. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  425. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  426. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  427. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  428. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  429. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  430. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  431. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  433. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  434. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  435. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  436. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  437. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  438. package/docs/archive/examples/v2/AGENTS.md +16 -16
  439. package/docs/archive/examples/v2/README.md +35 -35
  440. package/docs/archive/examples/v2/agents/README.md +3 -3
  441. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  442. package/docs/archive/examples/v2/agents/dba.md +4 -4
  443. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  444. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  445. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  446. package/docs/archive/examples/v2/agents/security.md +4 -4
  447. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  448. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  449. package/docs/archive/examples/v2/backend/package.json +42 -42
  450. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  451. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  452. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  453. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  454. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  455. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  456. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  457. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  458. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  459. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  460. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  461. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  462. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  463. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  464. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  465. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  466. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  467. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  468. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  469. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  470. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  471. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  472. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  473. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  474. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  475. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  476. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  477. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  479. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  480. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  481. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  482. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  483. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  484. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  485. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  486. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  487. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  488. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  489. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  490. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  491. package/docs/archive/examples/v2/memory/README.md +8 -8
  492. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  493. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  494. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  495. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  496. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  497. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  498. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  499. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  500. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  501. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  502. package/docs/capacidades-externas.md +86 -86
  503. package/docs/cli-first-operacao.md +74 -74
  504. package/docs/dev-workflow.md +421 -421
  505. package/docs/examples.md +546 -546
  506. package/docs/fluxo.md +103 -103
  507. package/docs/glossary.md +453 -453
  508. package/docs/init-project.md +457 -457
  509. package/docs/llm-fit-loop.md +41 -0
  510. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  511. package/docs/modos-de-operacao.md +52 -0
  512. package/docs/personas/architect/README.md +333 -333
  513. package/docs/personas/developer/README.md +371 -371
  514. package/docs/personas/executive/README.md +172 -172
  515. package/docs/personas/qa/README.md +350 -350
  516. package/docs/processo-projeto.md +138 -138
  517. package/docs/produto/factsheet-marketing.md +151 -0
  518. package/docs/produto/roteiro-demo.md +47 -0
  519. package/docs/publishing.md +377 -377
  520. package/docs/quick-reference.md +409 -409
  521. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  522. package/docs/structure.md +360 -360
  523. package/docs/token-optimization.md +502 -502
  524. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  525. package/memory/00-global/mission.md +15 -15
  526. package/memory/00-global/shared-knowledge.md +8 -8
  527. package/memory/00-global/standards.md +47 -47
  528. package/memory/10-product/personas.md +21 -21
  529. package/memory/10-product/vision.md +27 -27
  530. package/memory/30-projects/README.md +15 -15
  531. package/memory/40-delivery/backlog.md +15 -15
  532. package/memory/40-delivery/current-sprint.md +23 -26
  533. package/memory/50-orchestration/gsd-harness.md +55 -55
  534. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  535. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  536. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  537. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  538. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  539. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  540. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  541. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  542. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  543. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  544. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  545. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  546. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  547. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  548. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  549. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  550. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  551. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  552. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  553. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  554. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  555. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  556. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  557. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  558. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  559. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  560. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  561. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  562. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  563. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  564. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  565. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  566. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  567. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  568. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  569. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  570. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  571. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  572. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  573. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  574. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  575. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  576. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  577. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  578. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  579. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  580. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  581. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  582. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  583. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  584. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  585. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  586. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  587. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  588. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  589. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  590. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  591. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  592. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  593. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  594. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  595. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  596. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  597. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  598. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  599. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  600. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  601. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  602. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  603. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  604. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  605. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  606. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  607. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  608. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  609. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  610. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  611. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  612. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  613. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  614. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  615. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  616. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  617. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  618. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  619. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  620. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  621. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  622. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  623. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  624. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  625. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  626. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  627. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  628. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  629. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  630. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  631. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  632. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  633. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  634. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  635. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  636. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  637. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  638. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  639. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  640. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  641. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  642. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  643. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  644. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  645. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  646. package/memory/90-decisions/_template.md +28 -28
  647. package/package.json +157 -150
  648. package/prompts/context-engineer-agent.md +19 -19
  649. package/prompts/governance-agent.md +16 -16
  650. package/prompts/marketing-agent.md +13 -13
  651. package/prompts/orchestrator-agent.md +18 -18
  652. package/prompts/product-agent.md +13 -13
  653. package/prompts/sdd-architect-agent.md +20 -20
  654. package/specs/README.md +70 -70
  655. package/specs/_templates/plan.md +43 -43
  656. package/specs/_templates/spec.md +43 -43
  657. package/specs/_templates/tasks.md +32 -32
  658. package/specs/clean-arch-boilerplate/plan.md +137 -137
  659. package/specs/clean-arch-boilerplate/spec.md +121 -121
  660. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  661. package/specs/cli-first-operacao/plan.md +53 -53
  662. package/specs/cli-first-operacao/spec.md +53 -53
  663. package/specs/cli-first-operacao/tasks.md +53 -53
  664. package/specs/code-context/spec.md +56 -56
  665. package/specs/coerencia-do-sistema/plan.md +155 -155
  666. package/specs/coerencia-do-sistema/spec.md +123 -123
  667. package/specs/coerencia-do-sistema/tasks.md +115 -115
  668. package/specs/dev-token-assets-db/plan.md +71 -71
  669. package/specs/dev-token-assets-db/spec.md +58 -58
  670. package/specs/dev-token-assets-db/tasks.md +58 -58
  671. package/specs/doctor-do-nucleo/plan.md +165 -165
  672. package/specs/doctor-do-nucleo/spec.md +139 -139
  673. package/specs/doctor-do-nucleo/tasks.md +172 -172
  674. package/specs/forja-core/spec.md +71 -71
  675. package/specs/gates/spec.md +63 -63
  676. package/specs/governanca-visivel/plan.md +122 -122
  677. package/specs/governanca-visivel/spec.md +112 -112
  678. package/specs/governanca-visivel/tasks.md +60 -60
  679. package/specs/harness-codegraph/spec.md +71 -71
  680. package/specs/memory-audit/spec.md +54 -54
  681. package/specs/orchestrate/spec.md +108 -108
  682. package/specs/orchestration-coherent/spec.md +95 -95
  683. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  684. package/specs/project-smoke/spec.md +96 -96
  685. package/specs/project-upgrade/spec.md +58 -58
  686. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  687. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  688. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  689. package/specs/release-auditor-health/plan.md +88 -0
  690. package/specs/release-auditor-health/spec.md +82 -0
  691. package/specs/release-auditor-health/tasks.md +72 -0
  692. package/specs/release-gate/plan.md +174 -174
  693. package/specs/release-gate/spec.md +122 -122
  694. package/specs/release-gate/tasks.md +183 -183
  695. package/specs/ts-migration/plan.md +200 -200
  696. package/specs/ts-migration/spec.md +119 -119
  697. package/specs/ts-migration/tasks.md +110 -110
  698. package/dist/scripts/server-persistence-probe.d.ts +0 -1
  699. package/dist/scripts/server-persistence-probe.js +0 -52
  700. package/dist/scripts/server-persistence-probe.mjs +0 -52
  701. /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
@@ -3,16 +3,16 @@ export const MIGRATIONS = [
3
3
  {
4
4
  version: 1,
5
5
  name: 'core-persistence',
6
- sql: `CREATE TABLE IF NOT EXISTS forja_records (collection TEXT NOT NULL, id TEXT NOT NULL, payload TEXT NOT NULL, updated_at TEXT NOT NULL, PRIMARY KEY (collection, id));
7
- CREATE TABLE IF NOT EXISTS forja_events (id TEXT PRIMARY KEY, aggregate_id TEXT NOT NULL, sequence INTEGER NOT NULL, type TEXT NOT NULL, payload TEXT NOT NULL, idempotency_key TEXT NOT NULL UNIQUE, created_at TEXT NOT NULL);
6
+ sql: `CREATE TABLE IF NOT EXISTS forja_records (collection TEXT NOT NULL, id TEXT NOT NULL, payload TEXT NOT NULL, updated_at TEXT NOT NULL, PRIMARY KEY (collection, id));
7
+ CREATE TABLE IF NOT EXISTS forja_events (id TEXT PRIMARY KEY, aggregate_id TEXT NOT NULL, sequence INTEGER NOT NULL, type TEXT NOT NULL, payload TEXT NOT NULL, idempotency_key TEXT NOT NULL UNIQUE, created_at TEXT NOT NULL);
8
8
  CREATE TABLE IF NOT EXISTS forja_audit (id TEXT PRIMARY KEY, aggregate_id TEXT NOT NULL, action TEXT NOT NULL, outcome TEXT NOT NULL, payload TEXT NOT NULL, created_at TEXT NOT NULL);`,
9
9
  },
10
10
  {
11
11
  version: 2,
12
12
  name: 'runtime-persistence',
13
- sql: `CREATE TABLE IF NOT EXISTS runtime_runs (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
14
- CREATE TABLE IF NOT EXISTS runtime_plans (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
15
- CREATE TABLE IF NOT EXISTS runtime_results (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
13
+ sql: `CREATE TABLE IF NOT EXISTS runtime_runs (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
14
+ CREATE TABLE IF NOT EXISTS runtime_plans (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
15
+ CREATE TABLE IF NOT EXISTS runtime_results (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
16
16
  CREATE TABLE IF NOT EXISTS runtime_state (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);`,
17
17
  },
18
18
  {
@@ -23,13 +23,13 @@ CREATE TABLE IF NOT EXISTS runtime_state (run_id TEXT PRIMARY KEY, payload TEXT
23
23
  {
24
24
  version: 4,
25
25
  name: 'graphloop-persistence',
26
- sql: `CREATE TABLE IF NOT EXISTS graph_nodes (node_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
27
- CREATE TABLE IF NOT EXISTS graph_edges (edge_key TEXT PRIMARY KEY, from_id TEXT NOT NULL, to_id TEXT NOT NULL, edge_type TEXT NOT NULL, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
28
- CREATE TABLE IF NOT EXISTS graph_evidence (evidence_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
29
- CREATE TABLE IF NOT EXISTS graph_sources (source_key TEXT PRIMARY KEY, checksum TEXT NOT NULL, updated_at TEXT NOT NULL);
30
- CREATE TABLE IF NOT EXISTS graph_claims (claim_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
31
- CREATE TABLE IF NOT EXISTS graph_contradictions (contradiction_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
32
- CREATE TABLE IF NOT EXISTS graph_agenda (agenda_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
26
+ sql: `CREATE TABLE IF NOT EXISTS graph_nodes (node_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
27
+ CREATE TABLE IF NOT EXISTS graph_edges (edge_key TEXT PRIMARY KEY, from_id TEXT NOT NULL, to_id TEXT NOT NULL, edge_type TEXT NOT NULL, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
28
+ CREATE TABLE IF NOT EXISTS graph_evidence (evidence_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
29
+ CREATE TABLE IF NOT EXISTS graph_sources (source_key TEXT PRIMARY KEY, checksum TEXT NOT NULL, updated_at TEXT NOT NULL);
30
+ CREATE TABLE IF NOT EXISTS graph_claims (claim_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
31
+ CREATE TABLE IF NOT EXISTS graph_contradictions (contradiction_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
32
+ CREATE TABLE IF NOT EXISTS graph_agenda (agenda_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
33
33
  CREATE TABLE IF NOT EXISTS graph_extraction_runs (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);`,
34
34
  },
35
35
  {
@@ -0,0 +1,43 @@
1
+ export declare const LLM_PROFILE_VERSION = 1;
2
+ export interface LlmProfile {
3
+ readonly provider: string;
4
+ readonly model: string;
5
+ readonly command: string;
6
+ readonly commandArgs?: readonly string[];
7
+ readonly roles: readonly string[];
8
+ readonly taskTypes: readonly string[];
9
+ readonly privacy: 'local' | 'external';
10
+ readonly enabled: boolean;
11
+ }
12
+ export interface LlmProfiles {
13
+ readonly version: typeof LLM_PROFILE_VERSION;
14
+ readonly profiles: Readonly<Record<string, LlmProfile>>;
15
+ }
16
+ export interface LlmExecution {
17
+ readonly executable: string;
18
+ readonly args: readonly string[];
19
+ }
20
+ export interface LlmExecutionResult {
21
+ readonly exitCode: number;
22
+ readonly stdout: string;
23
+ readonly stderr: string;
24
+ readonly durationMs: number;
25
+ readonly errorCode?: string;
26
+ }
27
+ export declare const DEFAULT_LLM_PROFILES: LlmProfiles;
28
+ export declare class LlmProfileError extends Error {
29
+ constructor(message: string);
30
+ }
31
+ export declare function validateProfiles(value: unknown): LlmProfiles;
32
+ export declare function buildLlmExecution(profile: LlmProfile, prompt: string): LlmExecution;
33
+ export declare function runLlm(execution: LlmExecution, cwd: string, timeoutMs?: number): Promise<LlmExecutionResult>;
34
+ export declare function recommendProfile(profiles: LlmProfiles, observations: readonly {
35
+ readonly model?: string;
36
+ readonly outcome: string;
37
+ readonly durationMs: number;
38
+ readonly cost?: number;
39
+ }[], role: string, taskType: string, privacy?: LlmProfile['privacy']): readonly {
40
+ readonly name: string;
41
+ readonly score: number;
42
+ readonly reasons: readonly string[];
43
+ }[];
@@ -0,0 +1,108 @@
1
+ import { spawn } from 'node:child_process';
2
+ export const LLM_PROFILE_VERSION = 1;
3
+ export const DEFAULT_LLM_PROFILES = {
4
+ version: LLM_PROFILE_VERSION,
5
+ profiles: {
6
+ codex: { provider: 'codex', model: 'default', command: 'codex', roles: ['orchestrator', 'worker'], taskTypes: ['orchestration', 'implementation', 'review'], privacy: 'external', enabled: true },
7
+ claude: { provider: 'claude', model: 'default', command: 'claude', roles: ['sdd-architect', 'product'], taskTypes: ['architecture', 'specification', 'analysis'], privacy: 'external', enabled: true },
8
+ gemini: { provider: 'gemini-cli', model: 'default', command: 'gemini', roles: ['context-engineer', 'marketing'], taskTypes: ['research', 'context', 'writing'], privacy: 'external', enabled: true },
9
+ ollama: { provider: 'ollama', model: 'llama3.3', command: 'ollama', roles: [], taskTypes: ['offline', 'sensitive'], privacy: 'local', enabled: false },
10
+ },
11
+ };
12
+ export class LlmProfileError extends Error {
13
+ constructor(message) { super(message); this.name = 'LlmProfileError'; }
14
+ }
15
+ export function validateProfiles(value) {
16
+ if (!isRecord(value) || value.version !== LLM_PROFILE_VERSION || !isRecord(value.profiles))
17
+ throw new LlmProfileError(`profiles must use version ${LLM_PROFILE_VERSION}`);
18
+ const profiles = {};
19
+ for (const [name, profile] of Object.entries(value.profiles))
20
+ profiles[name] = validateProfile(name, profile);
21
+ return { version: LLM_PROFILE_VERSION, profiles };
22
+ }
23
+ export function buildLlmExecution(profile, prompt) {
24
+ if (!profile.enabled)
25
+ throw new LlmProfileError('profile is disabled');
26
+ if (prompt.trim().length === 0)
27
+ throw new LlmProfileError('prompt is required');
28
+ const base = [...(profile.commandArgs ?? [])];
29
+ if (profile.provider === 'codex')
30
+ return { executable: profile.command, args: ['exec', ...base, ...(profile.model === 'default' ? [] : ['--model', profile.model]), '--sandbox', 'read-only', '--ask-for-approval', 'never', prompt] };
31
+ if (profile.provider === 'claude')
32
+ return { executable: profile.command, args: [...base, ...(profile.model === 'default' ? [] : ['--model', profile.model]), '-p', prompt] };
33
+ if (profile.provider === 'gemini-cli')
34
+ return { executable: profile.command, args: [...base, ...(profile.model === 'default' ? [] : ['-m', profile.model]), '-p', prompt] };
35
+ if (profile.provider === 'ollama')
36
+ return { executable: profile.command, args: [...base, 'run', profile.model, prompt] };
37
+ if (profile.provider === 'copilot')
38
+ return { executable: profile.command, args: [...base, 'copilot', 'suggest', '-t', 'shell', prompt] };
39
+ return { executable: profile.command, args: [...base, prompt] };
40
+ }
41
+ export async function runLlm(execution, cwd, timeoutMs = 120_000) {
42
+ const started = Date.now();
43
+ return new Promise((resolve) => {
44
+ let stdout = '';
45
+ let stderr = '';
46
+ let settled = false;
47
+ const finish = (result) => {
48
+ if (settled)
49
+ return;
50
+ settled = true;
51
+ resolve({ ...result, durationMs: Date.now() - started });
52
+ };
53
+ const child = spawn(execution.executable, execution.args, { cwd, shell: false, stdio: ['ignore', 'pipe', 'pipe'] });
54
+ child.stdout.setEncoding('utf8');
55
+ child.stderr.setEncoding('utf8');
56
+ child.stdout.on('data', (chunk) => { stdout += chunk; });
57
+ child.stderr.on('data', (chunk) => { stderr += chunk; });
58
+ const timer = setTimeout(() => { child.kill(); finish({ exitCode: 124, stdout, stderr, errorCode: 'TIMEOUT' }); }, timeoutMs);
59
+ child.on('error', (error) => { clearTimeout(timer); finish({ exitCode: 127, stdout, stderr: `${stderr}${error.message}`, errorCode: 'SPAWN_FAILED' }); });
60
+ child.on('close', (code) => { clearTimeout(timer); finish({ exitCode: code ?? 1, stdout, stderr, ...(code === 0 ? {} : { errorCode: 'COMMAND_FAILED' }) }); });
61
+ });
62
+ }
63
+ export function recommendProfile(profiles, observations, role, taskType, privacy) {
64
+ return Object.entries(profiles.profiles)
65
+ .filter(([, profile]) => profile.enabled && (privacy === undefined || profile.privacy === privacy))
66
+ .map(([name, profile]) => {
67
+ const model = `${profile.provider}:${profile.model}`;
68
+ const samples = observations.filter((value) => value.model === model);
69
+ const succeeded = samples.filter((value) => value.outcome === 'succeeded').length;
70
+ const successRate = samples.length === 0 ? 0 : succeeded / samples.length;
71
+ const score = (profile.roles.includes(role) ? 100 : 0) + (profile.taskTypes.includes(taskType) ? 50 : 0) + Math.round(successRate * 25) + Math.min(samples.length, 10);
72
+ const reasons = [
73
+ ...(profile.roles.includes(role) ? [`role:${role}`] : []),
74
+ ...(profile.taskTypes.includes(taskType) ? [`task:${taskType}`] : []),
75
+ ...(samples.length > 0 ? [`${succeeded}/${samples.length} successful runs`] : ['no local evidence yet']),
76
+ ];
77
+ return { name, score, reasons };
78
+ })
79
+ .sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
80
+ }
81
+ function validateProfile(name, value) {
82
+ if (!/^[a-z0-9][a-z0-9_-]*$/.test(name) || !isRecord(value))
83
+ throw new LlmProfileError(`invalid profile: ${name}`);
84
+ const provider = string(value.provider, 'provider');
85
+ const model = string(value.model, 'model');
86
+ const command = string(value.command, 'command');
87
+ if (/\s/.test(command))
88
+ throw new LlmProfileError(`profile ${name}: command must be one executable; use commandArgs for arguments`);
89
+ const privacy = value.privacy;
90
+ if (privacy !== 'local' && privacy !== 'external')
91
+ throw new LlmProfileError(`profile ${name}: privacy must be local or external`);
92
+ if (typeof value.enabled !== 'boolean')
93
+ throw new LlmProfileError(`profile ${name}: enabled must be boolean`);
94
+ return { provider, model, command, commandArgs: strings(value.commandArgs, 'commandArgs'), roles: strings(value.roles, 'roles'), taskTypes: strings(value.taskTypes, 'taskTypes'), privacy, enabled: value.enabled };
95
+ }
96
+ function strings(value, field) {
97
+ if (value === undefined)
98
+ return [];
99
+ if (!Array.isArray(value) || !value.every((entry) => typeof entry === 'string' && entry.trim().length > 0))
100
+ throw new LlmProfileError(`${field} must be an array of non-empty strings`);
101
+ return [...new Set(value.map((entry) => entry.trim()))];
102
+ }
103
+ function string(value, field) {
104
+ if (typeof value !== 'string' || value.trim().length === 0)
105
+ throw new LlmProfileError(`${field} is required`);
106
+ return value.trim();
107
+ }
108
+ function isRecord(value) { return typeof value === 'object' && value !== null; }
@@ -247,7 +247,8 @@ function cmdHermesHandoff([jsonArg]) {
247
247
  const missing = required.filter((field) => !payload[field] || typeof payload[field] !== 'string');
248
248
  if (missing.length)
249
249
  fail(`Campos ADR-0005 ausentes: ${missing.join(', ')}`);
250
- const result = spawnSync('node', ['scripts/agent-router.mjs', 'append', JSON.stringify(payload)], {
250
+ const router = resolveScript(root, 'scripts/agent-router.mjs');
251
+ const result = spawnSync(process.execPath, [router, 'append', JSON.stringify(payload)], {
251
252
  cwd: root,
252
253
  encoding: 'utf8',
253
254
  });
@@ -258,7 +259,8 @@ function cmdHermesHandoff([jsonArg]) {
258
259
  process.exit(result.status ?? 1);
259
260
  }
260
261
  function appendHandoff(payload) {
261
- const result = spawnSync('node', ['scripts/agent-router.mjs', 'append', JSON.stringify(payload)], {
262
+ const router = resolveScript(root, 'scripts/agent-router.mjs');
263
+ const result = spawnSync(process.execPath, [router, 'append', JSON.stringify(payload)], {
262
264
  cwd: root,
263
265
  encoding: 'utf8',
264
266
  });
@@ -276,39 +278,39 @@ function cmdGsdPlan([slug = 'run', ...goalParts]) {
276
278
  const outFile = path.join(outDir, `gsd-${safeSlug}.md`);
277
279
  const specPath = path.join(projectRoot, 'specs', safeSlug, 'spec.md');
278
280
  const hasSpec = fs.existsSync(specPath);
279
- const content = `# GSD Runbook: ${safeSlug}
280
-
281
- - **Objetivo**: ${goal}
282
- - **Spec**: ${hasSpec ? path.relative(projectRoot, specPath) : 'nao encontrada'}
283
- - **Gerado em**: ${new Date().toISOString()}
284
-
285
- ## Gates
286
-
287
- - [ ] 1. Briefing: nome, objetivo, contexto, usuarios/papeis, riscos, primeira entrega esperada e slug gerado.
288
- - [ ] 2. Estrutura: pastas, memoria, specs, agentes, scripts, dashboard e dependencias conferidos.
289
- - [ ] 3. Sprints: sprint atual, proxima sprint, backlog e metrica 30d definidos.
290
- - [ ] 4. Contexto: \`npm run dev -- context:build task ${safeSlug} "<keyword>"\`.
291
- - [ ] 5. Mapa de impacto: \`npm run code:check\` e \`npm run code:impact <simbolo>\` para o blast radius antes de planejar/editar (ADR-0017).
292
- - [ ] 6. Spec: problema, escopo e AC testaveis em \`specs/${safeSlug}/spec.md\`.
293
- - [ ] 7. Design: brief aprovado via \`npm run dev -- design:check <brief.md>\`.
294
- - [ ] 8. Plano: plan/tasks aprovados quando houver impacto estrutural.
295
- - [ ] 9. Desenvolvimento: ownership de arquivos definido antes do Worker.
296
- - [ ] 10. Validacao: \`npm run dev -- gsd:check ${safeSlug} <brief.md>\` e \`npm test\`.
297
- - [ ] 11. Governance: \`npm run project:check -- <projeto>\` quando houver projeto alvo.
298
-
299
- ## Hermes handoffs sugeridos
300
-
301
- 1. \`npm run gsd:handoff -- spec ${safeSlug}\`
302
- 2. \`npm run gsd:handoff -- plan ${safeSlug}\`
303
- 3. \`npm run gsd:handoff -- implement ${safeSlug}\`
304
- 4. \`npm run gsd:handoff -- review ${safeSlug}\`
305
-
306
- ## Notas
307
-
308
- - Use Hermes para registrar cada passagem com os 7 campos do ADR-0005.
309
- - Antes de editar codigo, rode \`npm run code:impact -- <simbolo>\` para ver chamadores e blast radius (ADR-0017).
310
- - Use \`design-md/MATRIX.md\` para escolher referencia visual antes de construir UI.
311
- - Rode \`npm run gsd:check -- ${safeSlug} <brief.md>\` antes de entregar para Governance.
281
+ const content = `# GSD Runbook: ${safeSlug}
282
+
283
+ - **Objetivo**: ${goal}
284
+ - **Spec**: ${hasSpec ? path.relative(projectRoot, specPath) : 'nao encontrada'}
285
+ - **Gerado em**: ${new Date().toISOString()}
286
+
287
+ ## Gates
288
+
289
+ - [ ] 1. Briefing: nome, objetivo, contexto, usuarios/papeis, riscos, primeira entrega esperada e slug gerado.
290
+ - [ ] 2. Estrutura: pastas, memoria, specs, agentes, scripts, dashboard e dependencias conferidos.
291
+ - [ ] 3. Sprints: sprint atual, proxima sprint, backlog e metrica 30d definidos.
292
+ - [ ] 4. Contexto: \`npm run dev -- context:build task ${safeSlug} "<keyword>"\`.
293
+ - [ ] 5. Mapa de impacto: \`npm run code:check\` e \`npm run code:impact <simbolo>\` para o blast radius antes de planejar/editar (ADR-0017).
294
+ - [ ] 6. Spec: problema, escopo e AC testaveis em \`specs/${safeSlug}/spec.md\`.
295
+ - [ ] 7. Design: brief aprovado via \`npm run dev -- design:check <brief.md>\`.
296
+ - [ ] 8. Plano: plan/tasks aprovados quando houver impacto estrutural.
297
+ - [ ] 9. Desenvolvimento: ownership de arquivos definido antes do Worker.
298
+ - [ ] 10. Validacao: \`npm run dev -- gsd:check ${safeSlug} <brief.md>\` e \`npm test\`.
299
+ - [ ] 11. Governance: \`npm run project:check -- <projeto>\` quando houver projeto alvo.
300
+
301
+ ## Hermes handoffs sugeridos
302
+
303
+ 1. \`npm run gsd:handoff -- spec ${safeSlug}\`
304
+ 2. \`npm run gsd:handoff -- plan ${safeSlug}\`
305
+ 3. \`npm run gsd:handoff -- implement ${safeSlug}\`
306
+ 4. \`npm run gsd:handoff -- review ${safeSlug}\`
307
+
308
+ ## Notas
309
+
310
+ - Use Hermes para registrar cada passagem com os 7 campos do ADR-0005.
311
+ - Antes de editar codigo, rode \`npm run code:impact -- <simbolo>\` para ver chamadores e blast radius (ADR-0017).
312
+ - Use \`design-md/MATRIX.md\` para escolher referencia visual antes de construir UI.
313
+ - Rode \`npm run gsd:check -- ${safeSlug} <brief.md>\` antes de entregar para Governance.
312
314
  `;
313
315
  fs.writeFileSync(outFile, content, 'utf8');
314
316
  console.log(`GSD runbook criado: ${path.relative(projectRoot, outFile)}`);
@@ -458,16 +460,16 @@ function registerProjectCard(name, projectDir, flags) {
458
460
  const cardPath = path.join(cardsDir, `${name}.md`);
459
461
  if (fs.existsSync(cardPath))
460
462
  return;
461
- fs.writeFileSync(cardPath, `# Projeto: ${name}
462
-
463
- - **Status**: ativo
464
- - **Criado em**: ${new Date().toISOString().slice(0, 10)}
465
- - **Path**: ${projectDir}
466
- - **Origem**: forja project:new${flags.length ? ` (${flags.join(' ')})` : ''}
467
-
468
- ## Notas
469
-
470
- - Ficha criada automaticamente pelo core (ADR-0020). Complete com objetivo, stack e métrica 30d.
463
+ fs.writeFileSync(cardPath, `# Projeto: ${name}
464
+
465
+ - **Status**: ativo
466
+ - **Criado em**: ${new Date().toISOString().slice(0, 10)}
467
+ - **Path**: ${projectDir}
468
+ - **Origem**: forja project:new${flags.length ? ` (${flags.join(' ')})` : ''}
469
+
470
+ ## Notas
471
+
472
+ - Ficha criada automaticamente pelo core (ADR-0020). Complete com objetivo, stack e métrica 30d.
471
473
  `, 'utf8');
472
474
  console.log(`Ficha registrada: ${cardPath}`);
473
475
  }
@@ -500,25 +502,25 @@ function cmdProjectCheck([name]) {
500
502
  process.exit(result.status ?? 1);
501
503
  }
502
504
  function showHelp() {
503
- console.log(`Uso: node scripts/agent-harness.mjs <command> [args]
504
-
505
- Workspace:
506
- workspace:init Cria estrutura base do workspace Forja
507
- project:new <nome> Cria projeto no workspace
508
- project:list Lista projetos do workspace
509
- project:check <nome> Valida padroes no projeto do workspace
510
-
511
- Pipeline / Handoffs:
512
- gsd:plan <slug> [objetivo] Cria runbook GSD em .context/
513
- gsd:handoff <fase> <slug> Registra handoff GSD padronizado
514
- gsd:check <slug> [brief.md] Valida gates basicos do runbook
515
- hermes:handoff '<json>' Registra handoff ADR-0005 via agent-router
516
-
517
- Design / Code intelligence:
518
- design:check <brief.md> Valida brief visual local
519
- design:select <surface> [tom] Sugere referencias design-md
520
- code:check Valida indice codegraph (worktree + freshness)
521
- code:impact <simbolo> [depth] Mostra chamadores e blast radius via codegraph
505
+ console.log(`Uso: node scripts/agent-harness.mjs <command> [args]
506
+
507
+ Workspace:
508
+ workspace:init Cria estrutura base do workspace Forja
509
+ project:new <nome> Cria projeto no workspace
510
+ project:list Lista projetos do workspace
511
+ project:check <nome> Valida padroes no projeto do workspace
512
+
513
+ Pipeline / Handoffs:
514
+ gsd:plan <slug> [objetivo] Cria runbook GSD em .context/
515
+ gsd:handoff <fase> <slug> Registra handoff GSD padronizado
516
+ gsd:check <slug> [brief.md] Valida gates basicos do runbook
517
+ hermes:handoff '<json>' Registra handoff ADR-0005 via agent-router
518
+
519
+ Design / Code intelligence:
520
+ design:check <brief.md> Valida brief visual local
521
+ design:select <surface> [tom] Sugere referencias design-md
522
+ code:check Valida indice codegraph (worktree + freshness)
523
+ code:impact <simbolo> [depth] Mostra chamadores e blast radius via codegraph
522
524
  `);
523
525
  }
524
526
  const [command, ...rest] = process.argv.slice(2);
@@ -52,23 +52,23 @@ function openDb() {
52
52
  const db = new Database(dbPath, { timeout: 5000 });
53
53
  db.pragma('busy_timeout = 5000');
54
54
  db.pragma('journal_mode = WAL');
55
- withBusyRetry(() => db.exec(`
56
- CREATE TABLE IF NOT EXISTS handoffs (
57
- id INTEGER PRIMARY KEY AUTOINCREMENT,
58
- created_at TEXT NOT NULL,
59
- from_agent TEXT NOT NULL,
60
- to_agent TEXT NOT NULL,
61
- intent TEXT NOT NULL,
62
- context TEXT NOT NULL,
63
- acceptance TEXT NOT NULL,
64
- constraints TEXT NOT NULL,
65
- return_to TEXT NOT NULL,
66
- spec_slug TEXT,
67
- status TEXT DEFAULT 'open',
68
- payload_json TEXT
69
- );
70
- CREATE INDEX IF NOT EXISTS idx_handoffs_status ON handoffs(status);
71
- CREATE INDEX IF NOT EXISTS idx_handoffs_to ON handoffs(to_agent, status);
55
+ withBusyRetry(() => db.exec(`
56
+ CREATE TABLE IF NOT EXISTS handoffs (
57
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
58
+ created_at TEXT NOT NULL,
59
+ from_agent TEXT NOT NULL,
60
+ to_agent TEXT NOT NULL,
61
+ intent TEXT NOT NULL,
62
+ context TEXT NOT NULL,
63
+ acceptance TEXT NOT NULL,
64
+ constraints TEXT NOT NULL,
65
+ return_to TEXT NOT NULL,
66
+ spec_slug TEXT,
67
+ status TEXT DEFAULT 'open',
68
+ payload_json TEXT
69
+ );
70
+ CREATE INDEX IF NOT EXISTS idx_handoffs_status ON handoffs(status);
71
+ CREATE INDEX IF NOT EXISTS idx_handoffs_to ON handoffs(to_agent, status);
72
72
  `));
73
73
  return db;
74
74
  }
@@ -119,9 +119,9 @@ function cmdAppend(arg) {
119
119
  const raw = arg && arg !== '-' ? arg : readStdin();
120
120
  const h = parsePayload(raw);
121
121
  const db = openDb();
122
- const stmt = db.prepare(`
123
- INSERT INTO handoffs (created_at, from_agent, to_agent, intent, context, acceptance, constraints, return_to, spec_slug, payload_json)
124
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
122
+ const stmt = db.prepare(`
123
+ INSERT INTO handoffs (created_at, from_agent, to_agent, intent, context, acceptance, constraints, return_to, spec_slug, payload_json)
124
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
125
125
  `);
126
126
  const result = withBusyRetry(() => stmt.run(new Date().toISOString(), h.from, h.to, h.intent, h.context, h.acceptance, h.constraints, h.return, h.spec_slug || null, JSON.stringify(h)));
127
127
  console.log(JSON.stringify({ id: result.lastInsertRowid, status: 'open', from: h.from, to: h.to, intent: h.intent }));
@@ -15,36 +15,36 @@ const db = new Database(dbPath, { readonly: true });
15
15
  function getSmartContext() {
16
16
  console.log(`🔍 Construindo contexto inteligente para: ${project} (Busca: ${taskKeyword || 'global'})...`);
17
17
  // 1. Pegar arquivos globais obrigatórios
18
- const globalNodes = db.prepare(`
19
- SELECT title, content, path FROM memory_nodes
20
- WHERE project_id IS NULL AND (path LIKE '%mission.md' OR path LIKE '%standards.md')
18
+ const globalNodes = db.prepare(`
19
+ SELECT title, content, path FROM memory_nodes
20
+ WHERE project_id IS NULL AND (path LIKE '%mission.md' OR path LIKE '%standards.md')
21
21
  `).all();
22
22
  // 2. Pegar arquivos do projeto por keyword ou gerais
23
23
  let projectNodes = [];
24
24
  if (taskKeyword) {
25
- projectNodes = db.prepare(`
26
- SELECT n.title, n.content, n.path
27
- FROM memory_nodes n
28
- JOIN projects p ON p.id = n.project_id
29
- JOIN search_idx s ON s.node_id = n.id
30
- WHERE p.name = ? AND search_idx MATCH ?
31
- LIMIT 10
25
+ projectNodes = db.prepare(`
26
+ SELECT n.title, n.content, n.path
27
+ FROM memory_nodes n
28
+ JOIN projects p ON p.id = n.project_id
29
+ JOIN search_idx s ON s.node_id = n.id
30
+ WHERE p.name = ? AND search_idx MATCH ?
31
+ LIMIT 10
32
32
  `).all(project, taskKeyword);
33
33
  }
34
34
  // 3. Pegar ADRs e Summaries recentes do projeto
35
- const metadata = db.prepare(`
36
- SELECT n.title, n.content, n.path
37
- FROM memory_nodes n
38
- JOIN projects p ON p.id = n.project_id
39
- WHERE p.name = ? AND (n.kind = 'adr' OR n.kind = 'summary' OR n.path LIKE '%vision.md')
40
- ORDER BY n.updated_at DESC LIMIT 5
35
+ const metadata = db.prepare(`
36
+ SELECT n.title, n.content, n.path
37
+ FROM memory_nodes n
38
+ JOIN projects p ON p.id = n.project_id
39
+ WHERE p.name = ? AND (n.kind = 'adr' OR n.kind = 'summary' OR n.path LIKE '%vision.md')
40
+ ORDER BY n.updated_at DESC LIMIT 5
41
41
  `).all(project);
42
- const designIndex = db.prepare(`
43
- SELECT n.title, n.content, n.path
44
- FROM memory_nodes n
45
- JOIN projects p ON p.id = n.project_id
46
- WHERE p.name = ? AND n.kind = 'design' AND n.path LIKE '%/design-md/INDEX.md'
47
- ORDER BY n.updated_at DESC LIMIT 1
42
+ const designIndex = db.prepare(`
43
+ SELECT n.title, n.content, n.path
44
+ FROM memory_nodes n
45
+ JOIN projects p ON p.id = n.project_id
46
+ WHERE p.name = ? AND n.kind = 'design' AND n.path LIKE '%/design-md/INDEX.md'
47
+ ORDER BY n.updated_at DESC LIMIT 1
48
48
  `).all(project);
49
49
  const allNodes = [...globalNodes, ...projectNodes, ...metadata, ...designIndex];
50
50
  let contextPack = `# SMART CONTEXT PACK: ${project.toUpperCase()}\n\n`;
@@ -48,11 +48,11 @@ function archiveOldLogs(dbPath, ageInDays) {
48
48
  const cutoffDate = new Date();
49
49
  cutoffDate.setDate(cutoffDate.getDate() - ageInDays);
50
50
  const oldRuns = db
51
- .prepare(`
52
- SELECT id, project_id, completed_at, log_content
53
- FROM memory_runs
54
- WHERE completed_at < ?
55
- LIMIT 100
51
+ .prepare(`
52
+ SELECT id, project_id, completed_at, log_content
53
+ FROM memory_runs
54
+ WHERE completed_at < ?
55
+ LIMIT 100
56
56
  `)
57
57
  .all(cutoffDate.toISOString());
58
58
  console.log(` Found ${oldRuns.length} old runs to archive`);
@@ -69,9 +69,9 @@ function archiveOldLogs(dbPath, ageInDays) {
69
69
  console.log(` ✅ Archived ${archived} runs`);
70
70
  // 4. Cleanup de índices vazios
71
71
  const emptyNodes = db
72
- .prepare(`
73
- SELECT COUNT(*) as cnt FROM memory_nodes
74
- WHERE content IS NULL OR content = ''
72
+ .prepare(`
73
+ SELECT COUNT(*) as cnt FROM memory_nodes
74
+ WHERE content IS NULL OR content = ''
75
75
  `)
76
76
  .get();
77
77
  if (emptyNodes.cnt > 0) {
@@ -82,9 +82,9 @@ function recordContextRun(kind, slug, filePath, content, limitTokens = null) {
82
82
  const db = openDb();
83
83
  const tokens = estimateTokens(content);
84
84
  const status = limitTokens && tokens > limitTokens ? 'over_budget' : 'ok';
85
- db.prepare(`
86
- INSERT INTO context_runs (created_at, kind, slug, path, bytes, estimated_tokens, limit_tokens, status)
87
- VALUES (?, ?, ?, ?, ?, ?, ?, ?)
85
+ db.prepare(`
86
+ INSERT INTO context_runs (created_at, kind, slug, path, bytes, estimated_tokens, limit_tokens, status)
87
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)
88
88
  `).run(new Date().toISOString(), kind, slug || null, path.relative(projectRoot, filePath), content.length, tokens, limitTokens, status);
89
89
  db.close();
90
90
  }
@@ -99,15 +99,15 @@ function upsertSpecSummary(slug, content) {
99
99
  .filter((part) => !part.endsWith('\n'))
100
100
  .join('\n\n')
101
101
  .slice(0, 3500);
102
- db.prepare(`
103
- INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
104
- VALUES (?, ?, ?, ?, ?, ?)
105
- ON CONFLICT(slug) DO UPDATE SET
106
- status=excluded.status,
107
- title=excluded.title,
108
- summary=excluded.summary,
109
- source_path=excluded.source_path,
110
- updated_at=excluded.updated_at
102
+ db.prepare(`
103
+ INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
104
+ VALUES (?, ?, ?, ?, ?, ?)
105
+ ON CONFLICT(slug) DO UPDATE SET
106
+ status=excluded.status,
107
+ title=excluded.title,
108
+ summary=excluded.summary,
109
+ source_path=excluded.source_path,
110
+ updated_at=excluded.updated_at
111
111
  `).run(slug, status, title, summary, `specs/${slug}/spec.md`, new Date().toISOString());
112
112
  db.close();
113
113
  }
@@ -405,15 +405,15 @@ function cmdAssetCatalog() {
405
405
  }
406
406
  const db = openDb();
407
407
  const now = new Date().toISOString();
408
- const stmt = db.prepare(`
409
- INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
410
- VALUES (?, ?, ?, ?, ?, ?)
411
- ON CONFLICT(path) DO UPDATE SET
412
- type=excluded.type,
413
- name=excluded.name,
414
- summary=excluded.summary,
415
- tags=excluded.tags,
416
- updated_at=excluded.updated_at
408
+ const stmt = db.prepare(`
409
+ INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
410
+ VALUES (?, ?, ?, ?, ?, ?)
411
+ ON CONFLICT(path) DO UPDATE SET
412
+ type=excluded.type,
413
+ name=excluded.name,
414
+ summary=excluded.summary,
415
+ tags=excluded.tags,
416
+ updated_at=excluded.updated_at
417
417
  `);
418
418
  for (const asset of assets) {
419
419
  stmt.run(asset.type, asset.name, asset.path, asset.summary, asset.tags || asset.title, now);
@@ -434,14 +434,14 @@ function cmdAssetCatalog() {
434
434
  console.log(`Asset catalog gerado: ${path.relative(root, outFile)} (${assets.length} assets)`);
435
435
  }
436
436
  function help() {
437
- console.log(`Uso: node scripts/context-ops.mjs <command> [args]
438
-
439
- Comandos:
440
- budget <slug|arquivo> [limite] Mede tokens e falha se passar do limite
441
- sprint-pack Gera .context/sprint-pack.md
442
- agent-brief <role> <slug> Gera brief compacto por papel/feature
443
- asset-catalog Cataloga boilerplates e design-md
444
- manifests Gera manifests JSON para boilerplates/design-md
437
+ console.log(`Uso: node scripts/context-ops.mjs <command> [args]
438
+
439
+ Comandos:
440
+ budget <slug|arquivo> [limite] Mede tokens e falha se passar do limite
441
+ sprint-pack Gera .context/sprint-pack.md
442
+ agent-brief <role> <slug> Gera brief compacto por papel/feature
443
+ asset-catalog Cataloga boilerplates e design-md
444
+ manifests Gera manifests JSON para boilerplates/design-md
445
445
  `);
446
446
  }
447
447
  const [cmd, ...rest] = process.argv.slice(2);
@@ -133,7 +133,7 @@ export async function runAutonomyDemo() {
133
133
  if (!source.includes('assert.equal(add(1, 1), 3)'))
134
134
  throw new Error('Expected failing assertion was not found');
135
135
  fs.writeFileSync(worktreeFile, source.replace('assert.equal(add(1, 1), 3)', 'assert.equal(add(1, 1), 2)'));
136
- const testExecution = await sandbox.execute(session.id, { executable: 'npm', args: ['test'], cwd: session.root });
136
+ const testExecution = await sandbox.execute(session.id, { executable: process.execPath, args: ['--test'], cwd: session.root });
137
137
  if (testExecution.exitCode !== 0)
138
138
  throw new Error(`Fixture tests failed after edit: ${testExecution.stderr || testExecution.stdout}`);
139
139
  const validation = await sandbox.validate(session.id);
@@ -173,7 +173,7 @@ export async function runAutonomyDemo() {
173
173
  throw new Error(`Runtime did not complete with accepted validation: ${completed.state}/${completed.validation?.status}`);
174
174
  const diff = await sandbox.diff(session.id);
175
175
  const promoted = await sandbox.promote(session.id, diff);
176
- const promotedTests = mustCommand('npm', ['test'], fixtureRoot);
176
+ const promotedTests = mustCommand(process.execPath, ['--test'], fixtureRoot);
177
177
  await sandbox.destroy(session.id);
178
178
  const graphAfter = await new GraphIndexer(graph).sync(graphSource);
179
179
  const audit = new SqliteAuditStore(database);
@@ -0,0 +1,6 @@
1
+ export declare function createDemoWorkspace(args?: readonly string[]): Promise<{
2
+ readonly workspace: string;
3
+ readonly project: string;
4
+ readonly handoffs: number;
5
+ readonly observations: number;
6
+ }>;