forjajs 2.0.4 → 4.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.
- package/.claude/agents/context-engineer.md +19 -25
- package/.claude/agents/governance.md +19 -55
- package/.claude/agents/marketing.md +19 -24
- package/.claude/agents/orchestrator.md +19 -31
- package/.claude/agents/product.md +19 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +19 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +93 -87
- package/.github/copilot-instructions.md +93 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +93 -87
- package/AGENTS.md +137 -134
- package/CHANGELOG.md +656 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +68 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +17 -1
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/release.js +3 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/llm/codex-output.d.ts +12 -0
- package/dist/lib/llm/codex-output.js +56 -0
- package/dist/lib/llm/context.d.ts +5 -0
- package/dist/lib/llm/context.js +17 -0
- package/dist/lib/llm/session.d.ts +18 -0
- package/dist/lib/llm/session.js +34 -0
- package/dist/lib/llm/validation.d.ts +37 -0
- package/dist/lib/llm/validation.js +88 -0
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/evals/src/index.js +6 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.d.ts +8 -1
- package/dist/packages/llm/src/index.js +64 -7
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +85 -9
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/agent-operating-contract.md +26 -0
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-evolution.md +51 -0
- package/docs/llm-fit-loop.md +134 -5
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/publishing.md +49 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/0080-llm-execution-evidence.md +42 -0
- package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +159 -157
- package/prompts/context-engineer-agent.md +13 -19
- package/prompts/governance-agent.md +13 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +13 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +13 -20
- package/skills/MANIFEST.json +10 -0
- package/skills/llm-provider-routing/SKILL.md +18 -0
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +50 -43
- package/specs/_templates/spec.md +50 -43
- package/specs/_templates/tasks.md +39 -32
- package/specs/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-instructions-v4/plan.md +8 -0
- package/specs/agent-instructions-v4/spec.md +21 -0
- package/specs/agent-instructions-v4/tasks.md +12 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/cost-aware-autonomy-budget/spec.md +102 -0
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/llm-integration-v2/plan.md +55 -0
- package/specs/llm-integration-v2/spec.md +61 -0
- package/specs/llm-integration-v2/tasks.md +28 -0
- package/specs/llm-resume-validation/plan.md +50 -0
- package/specs/llm-resume-validation/spec.md +35 -0
- package/specs/llm-resume-validation/tasks.md +19 -0
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/spec.md +23 -23
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,183 +1,183 @@
|
|
|
1
|
-
# Tasks: release-gate
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: done
|
|
6
|
-
- **Criado em**: 2026-07-14
|
|
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: refactor puro primeiro (nada muda de comportamento), depois o catálogo, depois
|
|
11
|
-
as superfícies. O `prepublishOnly` vai **por último** — é a única peça que, com falso positivo,
|
|
12
|
-
impede publicar qualquer coisa.
|
|
13
|
-
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
## T1 — Extrair o runner para `lib/core/checks.mjs`
|
|
17
|
-
- **Owner**: Worker
|
|
18
|
-
- **Estimativa**: P
|
|
19
|
-
- **Depende de**: —
|
|
20
|
-
- **Paths**: `lib/core/checks.mjs`, `lib/core/health.mjs`, `test/health.test.js`
|
|
21
|
-
- **Escopo**: refactor puro. Nenhum comportamento muda; a suíte existente é o teste.
|
|
22
|
-
- **Done quando**:
|
|
23
|
-
- [ ] `runChecks` e `worstStatus` saem de `health.mjs` para `checks.mjs`, sem alteração de lógica
|
|
24
|
-
- [ ] `health.mjs` **re-exporta** ambos — `tools-doctor` e `hook-session-start` não mudam uma linha
|
|
25
|
-
- [ ] Os 36 testes de `test/health.test.js` passam **sem edição** (se precisarem mudar, não foi
|
|
26
|
-
refactor puro — foi mudança de comportamento disfarçada)
|
|
27
|
-
- [ ] Suíte completa verde
|
|
28
|
-
|
|
29
|
-
## T2 — `withCleanInstall`: empacotar e instalar isolado
|
|
30
|
-
- **Owner**: Worker
|
|
31
|
-
- **Estimativa**: M
|
|
32
|
-
- **Depende de**: T1
|
|
33
|
-
- **Paths**: `lib/core/release.mjs`, `test/release.test.js`
|
|
34
|
-
- **Escopo**: a fundação do gate. Sem instalação real, nada aqui prova nada (D2).
|
|
35
|
-
- **Done quando**:
|
|
36
|
-
- [ ] `npm pack` → diretório temporário fora do repo; `npm init -y` + `npm i <tgz>`
|
|
37
|
-
- [ ] **Isolamento**: sem herdar `NODE_PATH` nem o `node_modules` do repo. Um gate que enxerga o
|
|
38
|
-
repo mente verde (NFR)
|
|
39
|
-
- [ ] Limpa o temporário **sempre**, inclusive em erro (`finally`)
|
|
40
|
-
- [ ] Teste: o diretório temporário some depois da execução, mesmo quando o callback lança
|
|
41
|
-
|
|
42
|
-
## T3 — Checks do tarball: `registry-scripts`, `imports-resolve`
|
|
43
|
-
- **Owner**: Worker
|
|
44
|
-
- **Estimativa**: M
|
|
45
|
-
- **Depende de**: T2
|
|
46
|
-
- **Paths**: `lib/core/release.mjs`, `test/release.test.js`
|
|
47
|
-
- **Done quando**:
|
|
48
|
-
- [ ] `registry-scripts` (critical): todo comando do registry tem seu `node:` presente no tarball.
|
|
49
|
-
Hoje são 41/41 — o gate torna permanente o que hoje é verdade acidental (AC-5)
|
|
50
|
-
- [ ] `imports-resolve` (critical): todo import **relativo** de script publicado resolve dentro do
|
|
51
|
-
tarball (AC-6)
|
|
52
|
-
- [ ] **Template literals apagados antes do parse** (D3): os geradores contêm código NestJS que
|
|
53
|
-
eles *escrevem*, não que executam. Sem isso o check acusa `./app.module` como quebrado —
|
|
54
|
-
já observado em campo
|
|
55
|
-
- [ ] Fixture: tarball com arquivo fora do `files[]` **reprova** (bug real da v1.1.3)
|
|
56
|
-
|
|
57
|
-
## T4 — Checks de dependência: `deps-declared`, `deps-unused`
|
|
58
|
-
- **Owner**: Worker
|
|
59
|
-
- **Estimativa**: M
|
|
60
|
-
- **Depende de**: T2
|
|
61
|
-
- **Paths**: `lib/core/release.mjs`, `test/release.test.js`
|
|
62
|
-
- **Done quando**:
|
|
63
|
-
- [ ] `deps-declared` (critical): todo pacote importado por código sob `files[]` está em
|
|
64
|
-
`dependencies` (AC-6)
|
|
65
|
-
- [ ] `deps-unused` (**warn**, D7): `dependency` que ninguém importa é peso morto no tarball de
|
|
66
|
-
todo usuário — incomoda, não quebra
|
|
67
|
-
- [ ] Template literals apagados antes do parse, aqui também. Sem isso, `@nestjs/core` aparece
|
|
68
|
-
como dependência não declarada
|
|
69
|
-
- [ ] Fixture: `better-sqlite3` movido para `devDependencies` **reprova** (bug real do ADR-0021)
|
|
70
|
-
|
|
71
|
-
## T5 — `smoke-commands`: executar, não listar
|
|
72
|
-
- **Owner**: Worker
|
|
73
|
-
- **Estimativa**: M
|
|
74
|
-
- **Depende de**: T2
|
|
75
|
-
- **Paths**: `lib/core/release.mjs`, `test/release.test.js`
|
|
76
|
-
- **Escopo**: o check mais importante e o mais fácil de errar. O `forja` sem argumentos passa mesmo
|
|
77
|
-
com tudo quebrado — o help não carrega os scripts. Foi assim que a quebra do ADR-0021 se escondeu.
|
|
78
|
-
- **Done quando**:
|
|
79
|
-
- [ ] Executa comandos sem efeito colateral na instalação limpa: help, `tools:doctor`,
|
|
80
|
-
`code:status`, `query:universal` (AC-4)
|
|
81
|
-
- [ ] **Reprova por assinatura no stderr, nunca por exit code** (D8): `ERR_MODULE_NOT_FOUND`,
|
|
82
|
-
`ERR_DLOPEN_FAILED`, `Cannot find module`. Numa instalação limpa não há workspace nem
|
|
83
|
-
`universal.db`, então exit ≠ 0 é o pacote **funcionando** — reprovar ali seria repetir a
|
|
84
|
-
armadilha do `memory-db` na SPEC-009
|
|
85
|
-
- [ ] Teste: comando que sai ≠ 0 por falta de workspace **passa**; comando com
|
|
86
|
-
`ERR_MODULE_NOT_FOUND` **reprova**
|
|
87
|
-
|
|
88
|
-
## T6 — `tree-clean` e os dois modos
|
|
89
|
-
- **Owner**: Worker
|
|
90
|
-
- **Estimativa**: P
|
|
91
|
-
- **Depende de**: T2
|
|
92
|
-
- **Paths**: `lib/core/release.mjs`, `test/release.test.js`
|
|
93
|
-
- **Done quando**:
|
|
94
|
-
- [ ] `git status --short` com qualquer saída: `fail` sob `--publish`, `warn` sem ele (D4)
|
|
95
|
-
- [ ] Roda **antes** de empacotar: auditar um tarball que não é o que será publicado é auditar
|
|
96
|
-
ficção
|
|
97
|
-
- [ ] **Reconferido ao final** (D5): a aprovação é perecível. Um `npm install` entre o check e o
|
|
98
|
-
publish invalida tudo — foi exatamente a causa da v1.1.1
|
|
99
|
-
- [ ] Fixture: árvore suja + `--publish` **reprova** (bug real da v1.1.1)
|
|
100
|
-
|
|
101
|
-
## T7 — `release:check` (CLI + registry)
|
|
102
|
-
- **Owner**: Worker
|
|
103
|
-
- **Estimativa**: P
|
|
104
|
-
- **Depende de**: T3, T4, T5, T6
|
|
105
|
-
- **Paths**: `scripts/release-check.mjs`, `lib/core/registry.mjs`, `package.json`
|
|
106
|
-
- **Done quando**:
|
|
107
|
-
- [ ] Saída com o mesmo vocabulário do `tools:doctor` (OK/AVISO/FALHA + correção ao lado)
|
|
108
|
-
- [ ] `exit 1` se e somente se algum `critical` falhar (AC-1)
|
|
109
|
-
- [ ] Entrada no registry (ADR-0020); `test/forja-core.test.js` verde
|
|
110
|
-
- [ ] Flag `--publish` documentada no help
|
|
111
|
-
|
|
112
|
-
## T8 — Endurecer `runtime-deps` (dívida do ADR-0023)
|
|
113
|
-
- **Owner**: Worker
|
|
114
|
-
- **Estimativa**: P
|
|
115
|
-
- **Depende de**: T1
|
|
116
|
-
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
117
|
-
- **Contexto**: o check que entregamos na SPEC-009 passa **por sorte**. Os geradores contêm
|
|
118
|
-
`import { Module } from '@nestjs/common'` em template string; hoje não quebra porque `@nestjs/*`
|
|
119
|
-
não está nas devDeps. No dia em que estiver, ele trava o gate com falso positivo crítico.
|
|
120
|
-
- **Done quando**:
|
|
121
|
-
- [ ] Template literals apagados antes do parse, como em T3/T4 (AC-11)
|
|
122
|
-
- [ ] Teste com um gerador contendo `import` de devDependency **dentro de crases**: não reprova
|
|
123
|
-
- [ ] Teste com import real de devDependency fora de crases: continua reprovando
|
|
124
|
-
|
|
125
|
-
## T9 — CI: `tools:doctor` e `release:check` como steps
|
|
126
|
-
- **Owner**: Worker
|
|
127
|
-
- **Estimativa**: P
|
|
128
|
-
- **Depende de**: T7
|
|
129
|
-
- **Paths**: `.github/workflows/ci.yml`
|
|
130
|
-
- **Done quando**:
|
|
131
|
-
- [ ] `tools:doctor` vira step (AC-9) — o gate do ADR-0023 existe e hoje **nada o executa**
|
|
132
|
-
- [ ] `release:check` vira step. Roda uma vez (não na matriz inteira): o custo é o `npm i`
|
|
133
|
-
compilando o `better-sqlite3` do zero, e três vezes não prova mais que uma
|
|
134
|
-
- [ ] O CI verde vira a **evidência** do release, no log, em vez de na memória de quem publicou
|
|
135
|
-
|
|
136
|
-
## T10 — ADR-0024 e documentação
|
|
137
|
-
- **Owner**: SDD Architect
|
|
138
|
-
- **Estimativa**: P
|
|
139
|
-
- **Depende de**: T7
|
|
140
|
-
- **Paths**: `memory/90-decisions/0024-*.md`, `docs/publishing.md`, `CLAUDE.md`
|
|
141
|
-
- **Done quando**:
|
|
142
|
-
- [ ] ADR-0024 registra D1 (runner extraído), D8 (stderr, não exit code) e D9 (`prepublishOnly`,
|
|
143
|
-
nunca `prepack`), referenciando ADR-0023 e ADR-0021
|
|
144
|
-
- [ ] Os três bugs históricos citados como evidência — são o argumento da decisão
|
|
145
|
-
- [ ] `docs/publishing.md` passa a mandar rodar o gate, não a confiar no ritual
|
|
146
|
-
|
|
147
|
-
## T11 — `release-auditor` consome o gate
|
|
148
|
-
- **Owner**: Worker
|
|
149
|
-
- **Estimativa**: P
|
|
150
|
-
- **Depende de**: T7
|
|
151
|
-
- **Paths**: `.claude/agents/release-auditor.md`
|
|
152
|
-
- **Done quando**:
|
|
153
|
-
- [ ] O agente **roda `release:check`** e interpreta o resultado, em vez de reimplementar o
|
|
154
|
-
procedimento em prosa (AC-10)
|
|
155
|
-
- [ ] Some o passo-a-passo manual de `npm pack`/`grep`: virou código, e código não esquece
|
|
156
|
-
- [ ] Permanece o que só um agente faz: julgar o que o gate não sabe julgar, e recomendar
|
|
157
|
-
|
|
158
|
-
## T12 — `prepublishOnly` (por último)
|
|
159
|
-
- **Owner**: Governance
|
|
160
|
-
- **Estimativa**: P
|
|
161
|
-
- **Depende de**: T9 verde por um ciclo
|
|
162
|
-
- **Paths**: `package.json`
|
|
163
|
-
- **Escopo**: a peça de risco alto. Com falso positivo aqui, **ninguém publica nada**.
|
|
164
|
-
- **Done quando**:
|
|
165
|
-
- [ ] `"prepublishOnly": "npm run release:check -- --publish"` (AC-8)
|
|
166
|
-
- [ ] Comentário no `package.json`: **nunca** amarrar ao `prepack` — o gate roda `npm pack`, e
|
|
167
|
-
isso seria recursão infinita (D9)
|
|
168
|
-
- [ ] Validado com `npm publish --dry-run`
|
|
169
|
-
- [ ] Só entra **depois** de o gate rodar verde no CI por um ciclo (plano §7)
|
|
170
|
-
|
|
171
|
-
---
|
|
172
|
-
|
|
173
|
-
## Validação final (Governance)
|
|
174
|
-
- [ ] Os **três bugs históricos**, reintroduzidos um a um, reprovam o gate: `better-sqlite3` em
|
|
175
|
-
devDeps (ADR-0021), arquivo fora do `files[]` (v1.1.3), árvore suja no publish (v1.1.1).
|
|
176
|
-
Um gate que nunca viu a falha que promete pegar não está testado — está escrito.
|
|
177
|
-
- [ ] `npm test`, `project:check`, `tools:doctor` e `gitleaks` verdes
|
|
178
|
-
- [ ] Suíte completa verde; spec → `done`
|
|
179
|
-
|
|
180
|
-
## Handoffs entre agentes
|
|
181
|
-
|
|
182
|
-
Worker (T1-T9, T11), SDD Architect (T10), Governance (T12 + validação). Handoff a cada fronteira
|
|
183
|
-
via `npm run agent:route` — 7 campos (ADR-0005).
|
|
1
|
+
# Tasks: release-gate
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-07-14
|
|
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: refactor puro primeiro (nada muda de comportamento), depois o catálogo, depois
|
|
11
|
+
as superfícies. O `prepublishOnly` vai **por último** — é a única peça que, com falso positivo,
|
|
12
|
+
impede publicar qualquer coisa.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## T1 — Extrair o runner para `lib/core/checks.mjs`
|
|
17
|
+
- **Owner**: Worker
|
|
18
|
+
- **Estimativa**: P
|
|
19
|
+
- **Depende de**: —
|
|
20
|
+
- **Paths**: `lib/core/checks.mjs`, `lib/core/health.mjs`, `test/health.test.js`
|
|
21
|
+
- **Escopo**: refactor puro. Nenhum comportamento muda; a suíte existente é o teste.
|
|
22
|
+
- **Done quando**:
|
|
23
|
+
- [ ] `runChecks` e `worstStatus` saem de `health.mjs` para `checks.mjs`, sem alteração de lógica
|
|
24
|
+
- [ ] `health.mjs` **re-exporta** ambos — `tools-doctor` e `hook-session-start` não mudam uma linha
|
|
25
|
+
- [ ] Os 36 testes de `test/health.test.js` passam **sem edição** (se precisarem mudar, não foi
|
|
26
|
+
refactor puro — foi mudança de comportamento disfarçada)
|
|
27
|
+
- [ ] Suíte completa verde
|
|
28
|
+
|
|
29
|
+
## T2 — `withCleanInstall`: empacotar e instalar isolado
|
|
30
|
+
- **Owner**: Worker
|
|
31
|
+
- **Estimativa**: M
|
|
32
|
+
- **Depende de**: T1
|
|
33
|
+
- **Paths**: `lib/core/release.mjs`, `test/release.test.js`
|
|
34
|
+
- **Escopo**: a fundação do gate. Sem instalação real, nada aqui prova nada (D2).
|
|
35
|
+
- **Done quando**:
|
|
36
|
+
- [ ] `npm pack` → diretório temporário fora do repo; `npm init -y` + `npm i <tgz>`
|
|
37
|
+
- [ ] **Isolamento**: sem herdar `NODE_PATH` nem o `node_modules` do repo. Um gate que enxerga o
|
|
38
|
+
repo mente verde (NFR)
|
|
39
|
+
- [ ] Limpa o temporário **sempre**, inclusive em erro (`finally`)
|
|
40
|
+
- [ ] Teste: o diretório temporário some depois da execução, mesmo quando o callback lança
|
|
41
|
+
|
|
42
|
+
## T3 — Checks do tarball: `registry-scripts`, `imports-resolve`
|
|
43
|
+
- **Owner**: Worker
|
|
44
|
+
- **Estimativa**: M
|
|
45
|
+
- **Depende de**: T2
|
|
46
|
+
- **Paths**: `lib/core/release.mjs`, `test/release.test.js`
|
|
47
|
+
- **Done quando**:
|
|
48
|
+
- [ ] `registry-scripts` (critical): todo comando do registry tem seu `node:` presente no tarball.
|
|
49
|
+
Hoje são 41/41 — o gate torna permanente o que hoje é verdade acidental (AC-5)
|
|
50
|
+
- [ ] `imports-resolve` (critical): todo import **relativo** de script publicado resolve dentro do
|
|
51
|
+
tarball (AC-6)
|
|
52
|
+
- [ ] **Template literals apagados antes do parse** (D3): os geradores contêm código NestJS que
|
|
53
|
+
eles *escrevem*, não que executam. Sem isso o check acusa `./app.module` como quebrado —
|
|
54
|
+
já observado em campo
|
|
55
|
+
- [ ] Fixture: tarball com arquivo fora do `files[]` **reprova** (bug real da v1.1.3)
|
|
56
|
+
|
|
57
|
+
## T4 — Checks de dependência: `deps-declared`, `deps-unused`
|
|
58
|
+
- **Owner**: Worker
|
|
59
|
+
- **Estimativa**: M
|
|
60
|
+
- **Depende de**: T2
|
|
61
|
+
- **Paths**: `lib/core/release.mjs`, `test/release.test.js`
|
|
62
|
+
- **Done quando**:
|
|
63
|
+
- [ ] `deps-declared` (critical): todo pacote importado por código sob `files[]` está em
|
|
64
|
+
`dependencies` (AC-6)
|
|
65
|
+
- [ ] `deps-unused` (**warn**, D7): `dependency` que ninguém importa é peso morto no tarball de
|
|
66
|
+
todo usuário — incomoda, não quebra
|
|
67
|
+
- [ ] Template literals apagados antes do parse, aqui também. Sem isso, `@nestjs/core` aparece
|
|
68
|
+
como dependência não declarada
|
|
69
|
+
- [ ] Fixture: `better-sqlite3` movido para `devDependencies` **reprova** (bug real do ADR-0021)
|
|
70
|
+
|
|
71
|
+
## T5 — `smoke-commands`: executar, não listar
|
|
72
|
+
- **Owner**: Worker
|
|
73
|
+
- **Estimativa**: M
|
|
74
|
+
- **Depende de**: T2
|
|
75
|
+
- **Paths**: `lib/core/release.mjs`, `test/release.test.js`
|
|
76
|
+
- **Escopo**: o check mais importante e o mais fácil de errar. O `forja` sem argumentos passa mesmo
|
|
77
|
+
com tudo quebrado — o help não carrega os scripts. Foi assim que a quebra do ADR-0021 se escondeu.
|
|
78
|
+
- **Done quando**:
|
|
79
|
+
- [ ] Executa comandos sem efeito colateral na instalação limpa: help, `tools:doctor`,
|
|
80
|
+
`code:status`, `query:universal` (AC-4)
|
|
81
|
+
- [ ] **Reprova por assinatura no stderr, nunca por exit code** (D8): `ERR_MODULE_NOT_FOUND`,
|
|
82
|
+
`ERR_DLOPEN_FAILED`, `Cannot find module`. Numa instalação limpa não há workspace nem
|
|
83
|
+
`universal.db`, então exit ≠ 0 é o pacote **funcionando** — reprovar ali seria repetir a
|
|
84
|
+
armadilha do `memory-db` na SPEC-009
|
|
85
|
+
- [ ] Teste: comando que sai ≠ 0 por falta de workspace **passa**; comando com
|
|
86
|
+
`ERR_MODULE_NOT_FOUND` **reprova**
|
|
87
|
+
|
|
88
|
+
## T6 — `tree-clean` e os dois modos
|
|
89
|
+
- **Owner**: Worker
|
|
90
|
+
- **Estimativa**: P
|
|
91
|
+
- **Depende de**: T2
|
|
92
|
+
- **Paths**: `lib/core/release.mjs`, `test/release.test.js`
|
|
93
|
+
- **Done quando**:
|
|
94
|
+
- [ ] `git status --short` com qualquer saída: `fail` sob `--publish`, `warn` sem ele (D4)
|
|
95
|
+
- [ ] Roda **antes** de empacotar: auditar um tarball que não é o que será publicado é auditar
|
|
96
|
+
ficção
|
|
97
|
+
- [ ] **Reconferido ao final** (D5): a aprovação é perecível. Um `npm install` entre o check e o
|
|
98
|
+
publish invalida tudo — foi exatamente a causa da v1.1.1
|
|
99
|
+
- [ ] Fixture: árvore suja + `--publish` **reprova** (bug real da v1.1.1)
|
|
100
|
+
|
|
101
|
+
## T7 — `release:check` (CLI + registry)
|
|
102
|
+
- **Owner**: Worker
|
|
103
|
+
- **Estimativa**: P
|
|
104
|
+
- **Depende de**: T3, T4, T5, T6
|
|
105
|
+
- **Paths**: `scripts/release-check.mjs`, `lib/core/registry.mjs`, `package.json`
|
|
106
|
+
- **Done quando**:
|
|
107
|
+
- [ ] Saída com o mesmo vocabulário do `tools:doctor` (OK/AVISO/FALHA + correção ao lado)
|
|
108
|
+
- [ ] `exit 1` se e somente se algum `critical` falhar (AC-1)
|
|
109
|
+
- [ ] Entrada no registry (ADR-0020); `test/forja-core.test.js` verde
|
|
110
|
+
- [ ] Flag `--publish` documentada no help
|
|
111
|
+
|
|
112
|
+
## T8 — Endurecer `runtime-deps` (dívida do ADR-0023)
|
|
113
|
+
- **Owner**: Worker
|
|
114
|
+
- **Estimativa**: P
|
|
115
|
+
- **Depende de**: T1
|
|
116
|
+
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
117
|
+
- **Contexto**: o check que entregamos na SPEC-009 passa **por sorte**. Os geradores contêm
|
|
118
|
+
`import { Module } from '@nestjs/common'` em template string; hoje não quebra porque `@nestjs/*`
|
|
119
|
+
não está nas devDeps. No dia em que estiver, ele trava o gate com falso positivo crítico.
|
|
120
|
+
- **Done quando**:
|
|
121
|
+
- [ ] Template literals apagados antes do parse, como em T3/T4 (AC-11)
|
|
122
|
+
- [ ] Teste com um gerador contendo `import` de devDependency **dentro de crases**: não reprova
|
|
123
|
+
- [ ] Teste com import real de devDependency fora de crases: continua reprovando
|
|
124
|
+
|
|
125
|
+
## T9 — CI: `tools:doctor` e `release:check` como steps
|
|
126
|
+
- **Owner**: Worker
|
|
127
|
+
- **Estimativa**: P
|
|
128
|
+
- **Depende de**: T7
|
|
129
|
+
- **Paths**: `.github/workflows/ci.yml`
|
|
130
|
+
- **Done quando**:
|
|
131
|
+
- [ ] `tools:doctor` vira step (AC-9) — o gate do ADR-0023 existe e hoje **nada o executa**
|
|
132
|
+
- [ ] `release:check` vira step. Roda uma vez (não na matriz inteira): o custo é o `npm i`
|
|
133
|
+
compilando o `better-sqlite3` do zero, e três vezes não prova mais que uma
|
|
134
|
+
- [ ] O CI verde vira a **evidência** do release, no log, em vez de na memória de quem publicou
|
|
135
|
+
|
|
136
|
+
## T10 — ADR-0024 e documentação
|
|
137
|
+
- **Owner**: SDD Architect
|
|
138
|
+
- **Estimativa**: P
|
|
139
|
+
- **Depende de**: T7
|
|
140
|
+
- **Paths**: `memory/90-decisions/0024-*.md`, `docs/publishing.md`, `CLAUDE.md`
|
|
141
|
+
- **Done quando**:
|
|
142
|
+
- [ ] ADR-0024 registra D1 (runner extraído), D8 (stderr, não exit code) e D9 (`prepublishOnly`,
|
|
143
|
+
nunca `prepack`), referenciando ADR-0023 e ADR-0021
|
|
144
|
+
- [ ] Os três bugs históricos citados como evidência — são o argumento da decisão
|
|
145
|
+
- [ ] `docs/publishing.md` passa a mandar rodar o gate, não a confiar no ritual
|
|
146
|
+
|
|
147
|
+
## T11 — `release-auditor` consome o gate
|
|
148
|
+
- **Owner**: Worker
|
|
149
|
+
- **Estimativa**: P
|
|
150
|
+
- **Depende de**: T7
|
|
151
|
+
- **Paths**: `.claude/agents/release-auditor.md`
|
|
152
|
+
- **Done quando**:
|
|
153
|
+
- [ ] O agente **roda `release:check`** e interpreta o resultado, em vez de reimplementar o
|
|
154
|
+
procedimento em prosa (AC-10)
|
|
155
|
+
- [ ] Some o passo-a-passo manual de `npm pack`/`grep`: virou código, e código não esquece
|
|
156
|
+
- [ ] Permanece o que só um agente faz: julgar o que o gate não sabe julgar, e recomendar
|
|
157
|
+
|
|
158
|
+
## T12 — `prepublishOnly` (por último)
|
|
159
|
+
- **Owner**: Governance
|
|
160
|
+
- **Estimativa**: P
|
|
161
|
+
- **Depende de**: T9 verde por um ciclo
|
|
162
|
+
- **Paths**: `package.json`
|
|
163
|
+
- **Escopo**: a peça de risco alto. Com falso positivo aqui, **ninguém publica nada**.
|
|
164
|
+
- **Done quando**:
|
|
165
|
+
- [ ] `"prepublishOnly": "npm run release:check -- --publish"` (AC-8)
|
|
166
|
+
- [ ] Comentário no `package.json`: **nunca** amarrar ao `prepack` — o gate roda `npm pack`, e
|
|
167
|
+
isso seria recursão infinita (D9)
|
|
168
|
+
- [ ] Validado com `npm publish --dry-run`
|
|
169
|
+
- [ ] Só entra **depois** de o gate rodar verde no CI por um ciclo (plano §7)
|
|
170
|
+
|
|
171
|
+
---
|
|
172
|
+
|
|
173
|
+
## Validação final (Governance)
|
|
174
|
+
- [ ] Os **três bugs históricos**, reintroduzidos um a um, reprovam o gate: `better-sqlite3` em
|
|
175
|
+
devDeps (ADR-0021), arquivo fora do `files[]` (v1.1.3), árvore suja no publish (v1.1.1).
|
|
176
|
+
Um gate que nunca viu a falha que promete pegar não está testado — está escrito.
|
|
177
|
+
- [ ] `npm test`, `project:check`, `tools:doctor` e `gitleaks` verdes
|
|
178
|
+
- [ ] Suíte completa verde; spec → `done`
|
|
179
|
+
|
|
180
|
+
## Handoffs entre agentes
|
|
181
|
+
|
|
182
|
+
Worker (T1-T9, T11), SDD Architect (T10), Governance (T12 + validação). Handoff a cada fronteira
|
|
183
|
+
via `npm run agent:route` — 7 campos (ADR-0005).
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Plan: Smart Agent Routing
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-09-01
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem técnica
|
|
8
|
+
|
|
9
|
+
Extensão de `packages/engineering/identity` (mesmo pacote de SPEC-036, não um novo sub-domínio):
|
|
10
|
+
`recommendAgent(profiles, criteria)`, função pura, mesmo estilo de `recommendProfile`
|
|
11
|
+
(`packages/llm`) — soma pontos por critério casado, nunca esconde o porquê. `scripts/agent.ts`
|
|
12
|
+
ganha `agent:recommend`, reaproveitando `SqliteAgentProfileStore.list()` já existente.
|
|
13
|
+
|
|
14
|
+
## 2. Módulos afetados
|
|
15
|
+
|
|
16
|
+
| Caminho | Mudança | Risco |
|
|
17
|
+
|---|---|---|
|
|
18
|
+
| `packages/engineering/identity/src/index.ts` | `recommendAgent` novo | Baixo — função pura pequena |
|
|
19
|
+
| `scripts/agent.ts` | `agent:recommend` novo subcomando | Baixo |
|
|
20
|
+
| `lib/core/registry.ts` | 1 comando novo | Baixo |
|
|
21
|
+
| `test/agent-identity-reputation.test.js` | testes unitários de `recommendAgent` | — |
|
|
22
|
+
| `test/agent-cli.test.js` | teste de CLI de `agent:recommend` | — |
|
|
23
|
+
|
|
24
|
+
## 3. Contratos
|
|
25
|
+
|
|
26
|
+
```ts
|
|
27
|
+
// packages/engineering/identity/src/index.ts
|
|
28
|
+
export interface AgentRecommendation { readonly agentId: string; readonly score: number; readonly reasons: readonly string[]; }
|
|
29
|
+
export function recommendAgent(profiles: readonly AgentProfile2[], criteria: { readonly role: string; readonly domain?: string }): readonly AgentRecommendation[];
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Fórmula (D1): `score = (role === criteria.role ? 100 : 0) + (domain casado em architectureDomains ?
|
|
33
|
+
50 : 0) + (trustLevel ?? 0) * 10` (0-50). Pesos documentados aqui e no código — mesmo princípio de
|
|
34
|
+
`computeReputationScore`/`RiskEngine`. Sem `trustLevel`, o termo de reputação é 0 (não excluído do
|
|
35
|
+
ranking, AC-2) e o motivo declara "sem pontuação ainda".
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
agent:recommend --role <role> [--domain <d>]
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## 4. Decisões
|
|
42
|
+
|
|
43
|
+
**D1**: pesos 100/50/(0-50) espelham a proporção já usada em `recommendProfile` (100 pro papel, 50
|
|
44
|
+
pra tarefa/domínio) — reaproveita a mesma "linguagem de score" em vez de inventar uma nova escala,
|
|
45
|
+
mais fácil de comparar mentalmente entre os dois comandos irmãos.
|
|
46
|
+
|
|
47
|
+
## 5. Rollout
|
|
48
|
+
|
|
49
|
+
Sem migração, sem feature flag — comando novo, opt-in por natureza.
|
|
50
|
+
|
|
51
|
+
## 6. Kill criteria
|
|
52
|
+
|
|
53
|
+
Já coberto pelo mesmo princípio de SPEC-034/036: se o ranking não corresponder a julgamento humano
|
|
54
|
+
sobre dado real, os pesos de D1 são revisados antes de qualquer consumo automático (§5 do spec,
|
|
55
|
+
"Fora").
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# Spec: Smart Agent Routing
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-037
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprint 5 (segundo sprint da Fase 3 — a peça deixada de fora de SPEC-036 §5
|
|
8
|
+
deliberadamente: "consumo depende deste sprint já estar em produção")
|
|
9
|
+
- **ADRs relacionadas**: ADR-0078; depende de SPEC-036 (`AgentProfile2`/`trustLevel` — a fonte de
|
|
10
|
+
reputação que esta spec consome, não recalcula)
|
|
11
|
+
|
|
12
|
+
> Não confundir com `packages/llm.recommendProfile` (ADR-0074, "LLM Fit Loop") — aquele roteia
|
|
13
|
+
> entre **perfis de provider/model** (`codex`/`claude`/`gemini`/`ollama`) por papel/tarefa; esta
|
|
14
|
+
> spec roteia entre **agentes registrados** (`AgentProfile2`, SPEC-036) por papel/domínio/reputação.
|
|
15
|
+
> São dois problemas adjacentes, não o mesmo — por isso esta spec **estende
|
|
16
|
+
> `packages/engineering/identity`** (onde `AgentProfile2`/`computeReputationScore` já vivem), não
|
|
17
|
+
> `packages/llm`. O gap analysis original (`docs/architecture/...` §3) que sugeriu "estender
|
|
18
|
+
> `llm-fit`" previa isso antes de `AgentProfile2` existir; agora que existe, estender o pacote que
|
|
19
|
+
> já tem o dado é a composição certa, não duplicar o dado em `packages/llm`.
|
|
20
|
+
|
|
21
|
+
## 1. Problema
|
|
22
|
+
|
|
23
|
+
`AgentProfile2` (SPEC-036) já tem `trustLevel`/`autonomyLevel` reais, derivados de comportamento —
|
|
24
|
+
mas nada usa esse dado pra recomendar **qual agente registrado** é o mais adequado pra um
|
|
25
|
+
papel/domínio. Hoje a escolha de agente é manual e não considera histórico de confiabilidade.
|
|
26
|
+
|
|
27
|
+
## 2. Proposta de valor
|
|
28
|
+
|
|
29
|
+
`forja agent:recommend --role <role> [--domain <d>]` classifica os agentes já registrados por
|
|
30
|
+
adequação (papel, domínio de arquitetura, reputação), com razões explícitas — nunca um ranking sem
|
|
31
|
+
explicação, mesmo princípio já usado em `risk:assess`/`architecture:check`.
|
|
32
|
+
|
|
33
|
+
## 3. User stories
|
|
34
|
+
|
|
35
|
+
- **Como** governance/orchestrator, **quero** uma recomendação de qual agente registrado atribuir a
|
|
36
|
+
uma tarefa de um papel/domínio específico, **para que** a escolha considere reputação real, não
|
|
37
|
+
só disponibilidade.
|
|
38
|
+
|
|
39
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
40
|
+
|
|
41
|
+
- [x] AC-1: `recommendAgent` (função pura, `packages/engineering/identity`, mesmo pacote de
|
|
42
|
+
`computeReputationScore` — SPEC-036) recebe `readonly AgentProfile2[]` + critério
|
|
43
|
+
(`role`, `domain?`) e devolve um ranking com `score` e `reasons[]` — nunca um número sem
|
|
44
|
+
explicação (mesmo padrão de `recommendProfile`/`risk:assess`).
|
|
45
|
+
- [x] AC-2: agente sem `trustLevel` ainda (nunca rodou `agent:score`) ainda aparece no ranking —
|
|
46
|
+
não é excluído, mas o motivo declara explicitamente "sem pontuação ainda", nunca finge um
|
|
47
|
+
trust level que não existe.
|
|
48
|
+
- [x] AC-3: `forja agent:recommend --role <role> [--domain <d>]` (novo subcomando de
|
|
49
|
+
`scripts/agent.ts` — mesmo domínio de comando de SPEC-036, não um script novo) funcional.
|
|
50
|
+
- [x] AC-4: recomendação é **informação**, não decisão — não bloqueia, não atribui, não chama
|
|
51
|
+
`PolicyEngine`/`RuntimeEngine`. Mesmo princípio de `RiskEngine`/SPEC-034 D3: o score informa,
|
|
52
|
+
quem decide continua sendo o humano/orquestrador.
|
|
53
|
+
|
|
54
|
+
## 5. Escopo
|
|
55
|
+
|
|
56
|
+
**Dentro**: `recommendAgent` (motor puro); `agent:recommend` (CLI).
|
|
57
|
+
|
|
58
|
+
**Fora**: atribuição automática de agente a uma tarefa (decisão continua manual/orquestrador, AC-4);
|
|
59
|
+
routing entre provider/model (`packages/llm.recommendProfile` já existe e não muda aqui);
|
|
60
|
+
`PolicyEngine` consumir a recomendação automaticamente (mesmo raciocínio de SPEC-034/036 — consumo
|
|
61
|
+
é spec própria futura, quando/se fizer sentido).
|
|
62
|
+
|
|
63
|
+
## 6. NFRs / restrições
|
|
64
|
+
|
|
65
|
+
- Determinístico, sem LLM — mesma fórmula de scoring documentada em código e aqui.
|
|
66
|
+
- Reaproveita `AgentProfile2`/`trustLevel` já persistido — nenhum cálculo de reputação novo (isso é
|
|
67
|
+
SPEC-036, não esta spec).
|
|
68
|
+
|
|
69
|
+
## 7. Riscos e mitigação
|
|
70
|
+
|
|
71
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
72
|
+
|---|---|---|---|
|
|
73
|
+
| Confundir com `llm:recommend` (routing de provider/model) | Média (nomes parecidos) | Baixa (confusão, não bug) | Nota explícita no topo desta spec e no código; comandos com prefixos diferentes (`agent:` vs. `llm:`) |
|
|
74
|
+
| Ranking virar decisão automática por acidente | Baixa (mesmo padrão já seguido em RiskEngine) | Alta se acontecesse | AC-4 explícito; nenhum código nesta spec chama `PolicyEngine`/atribui trabalho |
|
|
75
|
+
|
|
76
|
+
## 8. Métricas de sucesso
|
|
77
|
+
|
|
78
|
+
Registrar 2+ agentes com `role`/`architectureDomains`/`trustLevel` diferentes (reaproveitando os
|
|
79
|
+
dados de teste de SPEC-036) e confirmar que `agent:recommend` ordena corretamente por adequação —
|
|
80
|
+
revisão humana, mesma metodologia de SPEC-034/036 §8.
|
|
81
|
+
|
|
82
|
+
**Validado** (`test/agent-cli.test.js`): 3 agentes registrados — `agent-a` (role+domain casados,
|
|
83
|
+
mais reputação real via amostra sintética de SPEC-036: 4 sucessos/1 rollback), `agent-b` (só role),
|
|
84
|
+
`agent-c` (só domain). Ranking saiu `agent-a > agent-b > agent-c`, na ordem esperada por revisão
|
|
85
|
+
humana — nenhum redesenho de pesos necessário (kill criteria do plan não disparado).
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Tasks: Smart Agent Routing
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## T1 — `recommendAgent` (motor puro) + `agent:recommend` (CLI)
|
|
11
|
+
- **Owner**: worker
|
|
12
|
+
- **Estimativa**: P
|
|
13
|
+
- **Depende de**: —
|
|
14
|
+
- **Paths**: `packages/engineering/identity/src/index.ts`, `scripts/agent.ts`, `lib/core/registry.ts`
|
|
15
|
+
- **Done quando**:
|
|
16
|
+
- [ ] `recommendAgent` implementa a fórmula de D1, agente sem `trustLevel` não é excluído (AC-2)
|
|
17
|
+
- [ ] `agent:recommend --role <role> [--domain <d>]` funcional
|
|
18
|
+
- [ ] testes unitários: role casado, domain casado, sem pontuação ainda, ordenação por score
|
|
19
|
+
- [ ] teste de CLI: 2+ agentes registrados com reputações diferentes, ranking correto
|
|
20
|
+
- [ ] `forja tools:doctor` continua verde
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## Handoffs entre agentes
|
|
25
|
+
|
|
26
|
+
Sprint pequeno, sem handoff — T1 é a spec inteira.
|