forjajs 2.0.4 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +34 -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 +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +133 -133
- package/CHANGELOG.md +619 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +64 -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 +15 -0
- 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/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/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/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.js +27 -4
- 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 +32 -3
- 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/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/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 +377 -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/_template.md +28 -28
- package/package.json +157 -157
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -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-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/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
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# ADR-0077: orçamento de autonomia por custo real (maxCostUsd)
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-09-01
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: policy, cost, observability, cli, llm
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
`PolicyLimits` (`maxTokens`, `maxFiles`, `maxDurationMs`, `maxRetries`) ganhou enforcement real em
|
|
11
|
+
`CapabilityRegistry.checkLimits` na auditoria de segurança de 2026-08-31 (ADR-0074 cita o contexto do
|
|
12
|
+
LLM Fit Loop que motiva isso). Nenhum desses limites fala em dinheiro: um profile `codex:default` e um
|
|
13
|
+
`claude:opus` podem gastar o mesmo número de tokens e custar ordens de magnitude diferentes. Quem opera
|
|
14
|
+
múltiplos produtos/clientes ao mesmo tempo (o usuário principal do Forja) só descobre o estouro de
|
|
15
|
+
custo na fatura do provider — depois do fato. Ver SPEC-029 para o problema completo, ACs e riscos.
|
|
16
|
+
|
|
17
|
+
Duas perguntas estruturais tinham que ser respondidas antes de codificar:
|
|
18
|
+
|
|
19
|
+
1. Onde mora o cálculo de custo, dado que `packages/core`/`policy`/`contracts` não podem importar uma
|
|
20
|
+
tabela de preço específica de provider (ver `docs/architecture/FORJA-2.0-ARCHITECTURE.md`, "Direção
|
|
21
|
+
de dependência" — domain core não conhece adapters)?
|
|
22
|
+
2. O que fazer quando o provider/modelo de uma execução não está na tabela de preço local?
|
|
23
|
+
|
|
24
|
+
## Decisão
|
|
25
|
+
|
|
26
|
+
**Cálculo de custo fica fora do domain core.** `CapabilityExecutionRequest` (packages/core) ganha um
|
|
27
|
+
campo opcional `estimatedCostUsd?: number`, calculado pelo CHAMADOR (o script/adapter que já sabe qual
|
|
28
|
+
modelo está em jogo) e só comparado contra `PolicyLimits.maxCostUsd` em `checkLimits` — o mesmo padrão
|
|
29
|
+
já usado para `budget.totalTokens` vs. `maxTokens`. `packages/core` nunca importa `lib/core/model-pricing.ts`
|
|
30
|
+
nem sabe o que é um "provider".
|
|
31
|
+
|
|
32
|
+
**Preço desconhecido é fail-open, e só para custo.** Quando o chamador não tem preço para o
|
|
33
|
+
provider/modelo (`estimatedCostUsd` ausente), `checkLimits` NÃO aplica `maxCostUsd` para aquela
|
|
34
|
+
chamada — a execução segue. Isto é uma exceção deliberada ao princípio "autonomia supervisionada por
|
|
35
|
+
padrão" que rege o resto do framework (onde a ausência de informação tende a bloquear, não liberar).
|
|
36
|
+
A justificativa: uma tabela de preço desatualizada ou incompleta é um problema de MANUTENÇÃO da tabela,
|
|
37
|
+
não um sinal de que o trabalho é ilegítimo — bloquear trabalho legítimo por um gap de catalogação é
|
|
38
|
+
pior que reportar um custo impreciso. O aviso (não o bloqueio) é o instrumento certo aqui: `forja
|
|
39
|
+
llm:doctor` reporta `pricing.known`/`pricing.stale` por profile, e `forja llm:run` avisa em stderr
|
|
40
|
+
quando grava uma observação sem custo computado.
|
|
41
|
+
|
|
42
|
+
**Tabela de preço local, versionada, com `asOf` por entrada.** `lib/core/model-pricing.json` +
|
|
43
|
+
`lib/core/model-pricing.ts` (loader/validador/calculadora puros, só fs — sem rede). Cada entrada carrega
|
|
44
|
+
`asOf`; `isPriceStale` (> 90 dias) alimenta o aviso de `llm:doctor` — mitigação direta do risco "tabela
|
|
45
|
+
desatualizada" do SPEC-029.
|
|
46
|
+
|
|
47
|
+
**Relatório é comando novo (`cost:economy`), não seção em `token:economy`.** `token:economy` mede
|
|
48
|
+
CENÁRIOS SINTÉTICOS de fixture (clean vs. flat, memória quente vs. fria) — nunca rodou um LLM de
|
|
49
|
+
verdade. `cost:economy` agrega OBSERVAÇÕES REAIS do `ObservationStore` (o mesmo que `llm:eval` usa),
|
|
50
|
+
multiplicadas pela tabela de preço. Misturar os dois faria "economia de token" parecer "economia de
|
|
51
|
+
custo" sobre números que nunca geraram custo real.
|
|
52
|
+
|
|
53
|
+
## Alternativas consideradas
|
|
54
|
+
|
|
55
|
+
- **`packages/policy` importa a tabela de preço diretamente**: rejeitada — viola a direção de
|
|
56
|
+
dependência (domain core conhecendo pricing de provider, um detalhe de adapter).
|
|
57
|
+
- **Preço desconhecido bloqueia (fail-closed, como o resto do framework)**: rejeitada — transformaria
|
|
58
|
+
todo gap de manutenção da tabela em um incidente de produção, para um dado que é explicitamente
|
|
59
|
+
local/estático/não-sincronizado (ver "Fora" do SPEC-029). Documentado aqui como a ÚNICA exceção
|
|
60
|
+
deliberada ao fail-closed padrão, para não ser lida como inconsistência.
|
|
61
|
+
- **Estender `token:economy` in-place com uma seção de custo**: rejeitada — os dois eixos medem coisas
|
|
62
|
+
diferentes (fixture sintética vs. observação real); um comando irmão mantém a distinção honesta.
|
|
63
|
+
- **`Observation` ganha `projectId` para permitir "custo por projeto" literal**: adiada — cada projeto
|
|
64
|
+
já opera seu próprio workspace/DB (`FORJA_WORKSPACE`), então rodar `cost:economy` dentro do workspace
|
|
65
|
+
de um projeto já escopa o relatório a ele. Um campo `projectId` explícito em `Observation` é uma
|
|
66
|
+
mudança de contrato maior que o SPEC-029 não pede; fica para spec própria se a separação por
|
|
67
|
+
workspace se mostrar insuficiente.
|
|
68
|
+
|
|
69
|
+
## Consequências
|
|
70
|
+
|
|
71
|
+
**Positivas**:
|
|
72
|
+
- `maxCostUsd` é opcional em todo lugar — regras de política existentes continuam funcionando sem
|
|
73
|
+
qualquer mudança (compatibilidade, NFR do SPEC-029).
|
|
74
|
+
- Nenhum pacote do domain core passa a conhecer preços de provider; a tabela pode mudar sem tocar
|
|
75
|
+
`packages/policy` ou `packages/core`.
|
|
76
|
+
- `llm:doctor` e `llm:run` já avisam sobre gaps de preço antes que virem surpresa de fatura.
|
|
77
|
+
|
|
78
|
+
**Negativas / Trade-offs**:
|
|
79
|
+
- Enforcement de `maxCostUsd` só é efetivo quando o CHAMADOR calcula e passa `estimatedCostUsd` —
|
|
80
|
+
capabilities que não passam por essa plumbing (a maioria dos comandos legados do CLI, que ainda não
|
|
81
|
+
passam por `CapabilityRegistry.execute`) não têm o limite aplicado automaticamente.
|
|
82
|
+
- "Preço desconhecido não bloqueia" significa que um `maxCostUsd` agressivo pode ser silenciosamente
|
|
83
|
+
ineficaz contra um provider fora da tabela — mitigado pelo aviso, não pelo bloqueio.
|
|
84
|
+
- `cost:economy` reporta por modelo, não por domínio/projeto explícito dentro de um mesmo workspace
|
|
85
|
+
(ver alternativa adiada acima).
|
|
86
|
+
|
|
87
|
+
## Rastreamento
|
|
88
|
+
|
|
89
|
+
- Implementação: `packages/policy/src/index.ts`, `packages/core/src/index.ts`,
|
|
90
|
+
`lib/core/model-pricing.ts`, `lib/core/model-pricing.json`, `scripts/llm-fit.ts`,
|
|
91
|
+
`scripts/cost-economy.ts`, `lib/core/registry.ts`
|
|
92
|
+
- Testes: `test/policy.test.js`, `test/policy-registry.integration.test.js`,
|
|
93
|
+
`test/model-pricing.test.js`, `test/cost-economy.test.js`
|
|
94
|
+
- Spec: `specs/cost-aware-autonomy-budget/spec.md` (SPEC-029)
|
|
95
|
+
- ADRs relacionadas: ADR-0074 (LLM Fit Loop / adapters de CLI)
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
# ADR-0078: ForjaJS 3.0 — de framework de agentes a Engineering Control Plane
|
|
2
|
+
|
|
3
|
+
- **Status**: proposed
|
|
4
|
+
- **Data**: 2026-09-01
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: architecture, vision, graph, policy, engineering-intelligence
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
A Forja 2.0 prova, em código real (não em documentação), quatro capacidades: um motor de política
|
|
11
|
+
com aprovação supervisionada (`packages/policy`), um runtime com checkpoint e retomada
|
|
12
|
+
(`packages/runtime`), um grafo de conhecimento com evidência e validade temporal
|
|
13
|
+
(`packages/graph`), e um sandbox real via git worktree (`packages/sandbox`,
|
|
14
|
+
`runSandboxedCapability`). `scripts/demo-autonomy.ts` fecha o ciclo de ponta a ponta.
|
|
15
|
+
|
|
16
|
+
A visão recebida propõe estender isso para um "Engineering Control Plane": a Forja passa a
|
|
17
|
+
entender não só código, mas **por que** o software existe (specs, requisitos), **como deveria
|
|
18
|
+
funcionar** (ADRs, arquitetura), **quem/o quê o mudou** (agentes, modelos, runs), e **o que
|
|
19
|
+
aconteceu depois** (incidentes, regressões). Isso é uma mudança de escopo real — de "orquestra
|
|
20
|
+
agentes com processo e memória" para "governa engenharia de software feita por agentes,
|
|
21
|
+
independente de que agente/modelo a fez".
|
|
22
|
+
|
|
23
|
+
A questão que este ADR decide: **isso é uma extensão incremental (2.x) ou uma mudança de versão
|
|
24
|
+
maior (3.0)?**
|
|
25
|
+
|
|
26
|
+
## Decisão
|
|
27
|
+
|
|
28
|
+
**É ForjaJS 3.0.** Critério: uma mudança de versão maior é justificada quando o **modelo mental**
|
|
29
|
+
do produto muda, não quando a superfície de comando cresce. 2.0 já foi essa mudança uma vez (ADR
|
|
30
|
+
implícito em `docs/vision/FORJA-2.0-VISION.md`: de CLI 1.x para "plataforma local-first"). A
|
|
31
|
+
mudança agora é da mesma ordem: de "orquestra o trabalho de agentes de IA" para "é a fonte de
|
|
32
|
+
verdade de por que o sistema existe e se comporta como deveria, com ou sem IA envolvida" — o grafo
|
|
33
|
+
deixa de ser CodeGraph (código) e passa a ser Engineering Graph (produto + arquitetura + código +
|
|
34
|
+
runtime + histórico). Isso é incompatível com o critério "2.x incremental" porque nenhuma feature
|
|
35
|
+
isolada da visão é 3.0 — é o **conjunto**, com o grafo como eixo central de todas elas, que muda o
|
|
36
|
+
que a Forja *é*.
|
|
37
|
+
|
|
38
|
+
Consequência prática: as extensões de contrato descritas em
|
|
39
|
+
[`docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md`](../../docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md)
|
|
40
|
+
são aditivas (nenhum campo removido, nenhum comando quebrado) — 3.0 aqui é sobre *posicionamento e
|
|
41
|
+
modelo mental*, não sobre breaking changes de API. A Forja continua podendo ser descrita, ao final
|
|
42
|
+
da migração, sem versão nova de `CONTRACT_VERSION` forçada por isso sozinho; se algum sprint
|
|
43
|
+
subsequente exigir de fato um breaking change de contrato, esse será o gatilho para
|
|
44
|
+
`CONTRACT_VERSION = '3.0'`, decidido separadamente quando (e se) acontecer.
|
|
45
|
+
|
|
46
|
+
**Não** construímos nenhuma das 33 features da visão original diretamente. Este ADR autoriza:
|
|
47
|
+
|
|
48
|
+
1. Um novo bounded context, `packages/engineering/{architecture,risk,provenance,identity}`,
|
|
49
|
+
seguindo a mesma regra de independência de framework de todo `packages/*` hoje (ADR-0020).
|
|
50
|
+
2. Extensão aditiva de `packages/contracts`: vocabulário de tipos de nó/aresta de engenharia sobre
|
|
51
|
+
o `GraphNode.type`/`GraphEdge.type` já livres (nenhum novo contrato de grafo), `ArchitectureRule`,
|
|
52
|
+
`ChangeRiskAssessment`, `AgentProfile2` (nome provisório).
|
|
53
|
+
3. Composição, nunca duplicação, de `PolicyEngine`, `GraphLoop`, `SandboxEngine`, `ContextEngine`,
|
|
54
|
+
`EvaluationEngine`, `EventBus` já existentes.
|
|
55
|
+
4. Uma ordem de implementação em 3 sprints imediatos (Constitution → Risk Engine → Evidence Ledger
|
|
56
|
+
+ façade `forja engineer`), com as fases seguintes da visão original (Provenance, Identity,
|
|
57
|
+
Simulation, Learning Loop, Autonomous Maintenance) especificadas só depois que essas três
|
|
58
|
+
estiverem em produção — ver `specs/engineering-intelligence/plan.md`.
|
|
59
|
+
|
|
60
|
+
## Alternativas consideradas
|
|
61
|
+
|
|
62
|
+
- **Tratar como 2.x incremental** (uma feature de cada vez, sem ADR guarda-chuva) — rejeitada
|
|
63
|
+
porque a visão pede explicitamente um documento de arquitetura e um ADR principal antes de
|
|
64
|
+
qualquer código, e porque o próprio critério acima (mudança de modelo mental, não de superfície)
|
|
65
|
+
não se sustenta como "incremental".
|
|
66
|
+
- **Reescrever o framework do zero em torno do Engineering Graph** — rejeitada explicitamente pela
|
|
67
|
+
visão recebida ("Não: reescreva o framework do zero... remova funcionalidades existentes") e pelo
|
|
68
|
+
gap analysis: nenhuma peça existente precisa ser substituída, só estendida.
|
|
69
|
+
- **Um pacote monolítico `packages/engineering`** (sem sub-diretórios com fronteira própria) —
|
|
70
|
+
rejeitada porque Risk/Architecture/Provenance/Identity têm ritmos de mudança diferentes e
|
|
71
|
+
acoplá-los cedo repete o erro que `packages/core`/`policy`/`runtime` já evitaram ao se separar só
|
|
72
|
+
depois que a fronteira entre eles estava provada em uso real.
|
|
73
|
+
- **Motor de decisão de autonomia paralelo ao `PolicyEngine`** (Risk-Based Autonomy como sistema
|
|
74
|
+
próprio) — rejeitada; `PolicyEngine` já tem o vocabulário certo (`RiskLevel`,
|
|
75
|
+
`approvalRequiredRisks`, `ALLOW_WITH_LIMITS`/`REQUIRE_APPROVAL`) e passa a receber um assessment
|
|
76
|
+
de risco opcional em vez de ganhar um substituto.
|
|
77
|
+
|
|
78
|
+
## Consequências
|
|
79
|
+
|
|
80
|
+
**Positivas**:
|
|
81
|
+
- Nenhum código existente muda de comportamento até que os sprints da Fase 1 comecem a consumir os
|
|
82
|
+
novos engines — risco de regressão zero na primeira entrega (que é só planejamento).
|
|
83
|
+
- O gap analysis (ver documento de arquitetura) mostra que ~80% dos "insumos" das 33 features já
|
|
84
|
+
existem no código de hoje — o trabalho real é composição e três motores novos, não uma
|
|
85
|
+
reescrita.
|
|
86
|
+
- `drift-sentinel` (SPEC-030) e `cost-aware-autonomy-budget` (SPEC-029), já em implementação nesta
|
|
87
|
+
mesma janela de trabalho, acabam sendo peças legítimas de Fase 1/Fase 3 desta visão maior
|
|
88
|
+
(Architecture Drift Detection e Cost Intelligence, respectivamente) — não é trabalho descartado.
|
|
89
|
+
|
|
90
|
+
**Negativas / Trade-offs**:
|
|
91
|
+
- O escopo total da visão (33 features, 7 fases) é grande demais para qualquer sprint único — este
|
|
92
|
+
ADR autoriza só a fundação (§19 do documento de arquitetura); fases posteriores exigirão ADRs e
|
|
93
|
+
specs próprias quando chegar a vez delas, o que significa esta decisão fica deliberadamente
|
|
94
|
+
incompleta até lá.
|
|
95
|
+
- `AgentProfile2` como nome provisório é uma dívida de nomenclatura assumida conscientemente —
|
|
96
|
+
ver Open Question #1 no documento de arquitetura, a resolver até o fim do Sprint 3.
|
|
97
|
+
- Adicionar um bounded context novo (`packages/engineering`) aumenta a superfície do monorepo;
|
|
98
|
+
mitigado por manter os quatro sub-domínios sem imports cruzados entre si desde o primeiro commit.
|
|
99
|
+
|
|
100
|
+
## Constraints
|
|
101
|
+
|
|
102
|
+
Regra real, checável hoje (não hipotética) — a primeira que `architecture:compile` (SPEC-033)
|
|
103
|
+
compila deste repositório: `packages/policy` é domínio puro (ADR-0020), nunca deveria depender de
|
|
104
|
+
um driver de persistência concreto.
|
|
105
|
+
|
|
106
|
+
- packages/policy não depende de better-sqlite3
|
|
107
|
+
|
|
108
|
+
## Rastreamento
|
|
109
|
+
|
|
110
|
+
- Documento de arquitetura: `docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md`
|
|
111
|
+
- Spec master: `specs/engineering-intelligence/spec.md` (SPEC-031)
|
|
112
|
+
- Specs de fundação: `specs/engineering-graph-extensions/` (SPEC-032),
|
|
113
|
+
`specs/architecture-constitution/` (SPEC-033), `specs/change-risk-engine/` (SPEC-034),
|
|
114
|
+
`specs/engineering-evidence-ledger/` (SPEC-035)
|
|
115
|
+
- ADRs relacionadas: ADR-0005 (handoff 7 campos), ADR-0019 (workspace), ADR-0020 (core/registry),
|
|
116
|
+
ADR-0072 (limites de segurança do sandbox), ADR-0074 (LLM Fit Loop)
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
# ADR-0079: Autonomous Maintenance — postura de prontidão, sem habilitação automática
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-09-01
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: engineering-control-plane, policy, autonomy, sdd
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
A visão original do ForjaJS 3.0 lista "Autonomous Maintenance" (Fase 7) como a fase final do
|
|
11
|
+
roadmap de 33 features, com uma instrução explícita: "só arquitetura preparatória, nunca habilitação
|
|
12
|
+
automática". Os Sprints 1-9 (SPEC-032 a SPEC-041, ADR-0078) já entregaram, de forma independente e
|
|
13
|
+
cada um com sua própria evidência real, todos os componentes que uma decisão de manutenção autônoma
|
|
14
|
+
precisaria consultar:
|
|
15
|
+
|
|
16
|
+
- **Risco** (`RiskEngine`/`assessRisk`, SPEC-034) — score 0-100 explicável de uma mudança.
|
|
17
|
+
- **Arquitetura** (`checkConstitution`, SPEC-033) — se a mudança viola uma regra derivada de ADR.
|
|
18
|
+
- **Reputação do agente** (`computeReputationScore`, SPEC-036) — confiabilidade derivada de
|
|
19
|
+
comportamento real, nunca auto-declarada.
|
|
20
|
+
- **Recomendação de agente** (`recommendAgent`, SPEC-037) — adequação de um agente a um papel.
|
|
21
|
+
- **Simulação preditiva** (`forja simulate`, SPEC-038) — teste+arquitetura+risco num worktree
|
|
22
|
+
isolado, com recomendação `promote`/`review`/`discard`.
|
|
23
|
+
- **Proveniência** (`extractProvenance`, SPEC-039) — quem/qual agente produziu um arquivo.
|
|
24
|
+
- **Anomalia de comportamento** (`detectAnomaly`, SPEC-040) — desvio do comportamento recente de um
|
|
25
|
+
agente contra sua própria linha de base.
|
|
26
|
+
- **Incidentes e sugestão por similaridade** (`incident:similar`, SPEC-041) — conhecimento
|
|
27
|
+
reconsultável de problemas passados.
|
|
28
|
+
|
|
29
|
+
Todos os seis primeiros já têm um ponto de integração real e testado com `PolicyEngine`: `RiskLevel`
|
|
30
|
+
(nativo), `riskScoreRange`/`riskScore` (SPEC-034), `anomalyScoreRange`/`anomalyScore` (SPEC-040) —
|
|
31
|
+
sempre como `number` puro que uma regra de política pode consultar, nunca como um motor de decisão
|
|
32
|
+
paralelo (mesmo princípio repetido em toda a fundação, D3 de SPEC-034).
|
|
33
|
+
|
|
34
|
+
O que falta pra "Autonomous Maintenance" de verdade — um agente detectar um problema, corrigi-lo e
|
|
35
|
+
promover a correção **sem** aprovação humana — não é mais peças de dado. É a composição de tudo
|
|
36
|
+
isso numa decisão de política real que permita `ALLOW`/`ALLOW_WITH_LIMITS` sem `REQUIRE_APPROVAL`
|
|
37
|
+
mesmo em cenários de risco não-trivial. Essa é exatamente a linha que a visão original pede pra não
|
|
38
|
+
cruzar ainda.
|
|
39
|
+
|
|
40
|
+
## Decisão
|
|
41
|
+
|
|
42
|
+
**Fase 7 fica em prontidão arquitetural, não em implementação.** Nenhuma regra de `PolicyEngine`
|
|
43
|
+
neste repositório usa `riskScoreRange`/`anomalyScoreRange` pra conceder `ALLOW`/`ALLOW_WITH_LIMITS`
|
|
44
|
+
sem aprovação — as duas capacidades existem (SPEC-034, SPEC-040) e são consultáveis, mas nenhuma
|
|
45
|
+
regra real as conecta a uma autonomia maior. Compor os sinais já existentes num fluxo de decisão é
|
|
46
|
+
trabalho de composição pura (nenhum motor novo, mesmo padrão de `forja engineer`/`forja simulate`),
|
|
47
|
+
mas a regra de política que permitiria a aplicação automática de uma correção **exige aprovação
|
|
48
|
+
humana explícita antes de existir**, não só antes de rodar.
|
|
49
|
+
|
|
50
|
+
Guardrails que qualquer spec futura de "Autonomous Maintenance" real precisa manter, sem exceção
|
|
51
|
+
(cada um já é um princípio já seguido em alguma spec anterior, não uma invenção desta ADR):
|
|
52
|
+
|
|
53
|
+
1. **Fail-closed em ambiguidade** — dado insuficiente (confidence baixa em qualquer um dos sete
|
|
54
|
+
sinais acima) nunca vira permissão, sempre vira `REQUIRE_APPROVAL`/`human_in_the_loop` (mesmo
|
|
55
|
+
princípio de AC-3 de SPEC-036, AC-2 de SPEC-040).
|
|
56
|
+
2. **Nenhum motor de decisão paralelo** — a decisão de aplicar ou não uma correção continua sendo
|
|
57
|
+
do `PolicyEngine` (regras existentes, aditivas), nunca de um "orquestrador de manutenção" que
|
|
58
|
+
decide por fora da política (mesmo princípio já resolvido pra risco/anomalia, D3 de SPEC-034).
|
|
59
|
+
3. **Simulação antes de qualquer promoção real** — `forja simulate` (SPEC-038) já prova que testar
|
|
60
|
+
uma mudança num worktree isolado antes de decidir é viável e rápido; nenhuma correção autônoma
|
|
61
|
+
deveria pular essa etapa, mesmo com todos os sinais favoráveis.
|
|
62
|
+
4. **Reversibilidade obrigatória** — qualquer aplicação automática precisa de um caminho de
|
|
63
|
+
rollback real (`SandboxEngine.rollback`, já existente) testado antes de a regra existir, não
|
|
64
|
+
depois do primeiro incidente.
|
|
65
|
+
5. **Nenhum LLM como fonte de verdade de decisão crítica** — os sete sinais acima são todos
|
|
66
|
+
determinísticos; se uma spec futura quiser LLM em algum ponto do fluxo, ele entra como sugestão
|
|
67
|
+
revisável (`status: 'proposed'`, `confidence < 1`), nunca como regra `active`/decisão automática
|
|
68
|
+
— mesmo padrão já estabelecido em `architecture:compile` (SPEC-033) e em toda a fundação.
|
|
69
|
+
6. **Auditoria completa e correlacionável** — `AuditRecord`/`Evidence`/`ProvenanceRecord`
|
|
70
|
+
(SPEC-039) já dão o rastro; qualquer aplicação automática precisa gravar evidência suficiente
|
|
71
|
+
pra reconstruir "por que o sistema decidiu isso" sem depender de memória humana.
|
|
72
|
+
|
|
73
|
+
## Alternativas consideradas
|
|
74
|
+
|
|
75
|
+
- **Implementar uma regra de política real que já habilita alguma forma de auto-aplicação de baixo
|
|
76
|
+
risco** (ex.: só para mudanças com `riskScore` muito baixo e `trustLevel` muito alto) — rejeitada
|
|
77
|
+
porque cruzaria exatamente a linha que a visão original pede pra não cruzar nesta fase ("nunca
|
|
78
|
+
habilitação automática"), e porque este workspace não acumulou dado real suficiente (histórico de
|
|
79
|
+
`Observation`/incidentes) pra validar que os limiares escolhidos seriam seguros na prática, não só
|
|
80
|
+
em teoria.
|
|
81
|
+
- **Não escrever nada pra Fase 7** — rejeitada porque a visão original pede explicitamente
|
|
82
|
+
"arquitetar o caminho" mesmo sem habilitar; documentar os guardrails agora, enquanto o desenho de
|
|
83
|
+
cada peça está fresco, é mais barato e mais correto do que reconstruir esse raciocínio do zero
|
|
84
|
+
quando (e se) uma spec futura decidir implementar de verdade.
|
|
85
|
+
|
|
86
|
+
## Consequências
|
|
87
|
+
|
|
88
|
+
**Positivas**:
|
|
89
|
+
- Fecha o roadmap de 33 features da visão original ForjaJS 3.0 até onde é honestamente
|
|
90
|
+
implementável neste workspace — nada fica "esquecido", cada item tem uma decisão explícita
|
|
91
|
+
(implementado, ou por que não).
|
|
92
|
+
- Qualquer spec futura de manutenção autônoma real começa com os guardrails já escritos, em vez de
|
|
93
|
+
precisar redescobri-los.
|
|
94
|
+
|
|
95
|
+
**Negativas / Trade-offs**:
|
|
96
|
+
- Nenhuma automação de manutenção acontece a partir desta ADR — é puramente preparatório, por
|
|
97
|
+
desenho explícito da visão original, não uma limitação técnica.
|
|
98
|
+
|
|
99
|
+
## Rastreamento
|
|
100
|
+
- Implementação: nenhuma (ADR de prontidão/prep — sem código associado, por desenho)
|
|
101
|
+
- Specs relacionadas: SPEC-032 a SPEC-041 (todos os componentes compostos aqui)
|
|
102
|
+
- ADRs relacionadas: ADR-0078 (decisão estrutural 3.0), ADR-0020 (domínio puro de `packages/policy`)
|
|
@@ -1,28 +1,28 @@
|
|
|
1
|
-
# ADR-XXXX: <título curto>
|
|
2
|
-
|
|
3
|
-
- **Status**: proposed | accepted | superseded by ADR-YYYY | deprecated
|
|
4
|
-
- **Data**: YYYY-MM-DD
|
|
5
|
-
- **Autor(es)**: <nome>
|
|
6
|
-
- **Tags**: <ex: security, memory, sdd, orchestration>
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
<O que motivou esta decisão? Qual o problema? Quais restrições existem?>
|
|
10
|
-
|
|
11
|
-
## Decisão
|
|
12
|
-
<O que foi decidido, no imperativo. Direto ao ponto.>
|
|
13
|
-
|
|
14
|
-
## Alternativas consideradas
|
|
15
|
-
- **Opção A**: <descrição> — rejeitada porque <razão>
|
|
16
|
-
- **Opção B**: <descrição> — rejeitada porque <razão>
|
|
17
|
-
|
|
18
|
-
## Consequências
|
|
19
|
-
**Positivas**:
|
|
20
|
-
- ...
|
|
21
|
-
|
|
22
|
-
**Negativas / Trade-offs**:
|
|
23
|
-
- ...
|
|
24
|
-
|
|
25
|
-
## Rastreamento
|
|
26
|
-
- Implementação: `<paths>`
|
|
27
|
-
- Issues/PRs: `<refs>`
|
|
28
|
-
- ADRs relacionadas: `<refs>`
|
|
1
|
+
# ADR-XXXX: <título curto>
|
|
2
|
+
|
|
3
|
+
- **Status**: proposed | accepted | superseded by ADR-YYYY | deprecated
|
|
4
|
+
- **Data**: YYYY-MM-DD
|
|
5
|
+
- **Autor(es)**: <nome>
|
|
6
|
+
- **Tags**: <ex: security, memory, sdd, orchestration>
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
<O que motivou esta decisão? Qual o problema? Quais restrições existem?>
|
|
10
|
+
|
|
11
|
+
## Decisão
|
|
12
|
+
<O que foi decidido, no imperativo. Direto ao ponto.>
|
|
13
|
+
|
|
14
|
+
## Alternativas consideradas
|
|
15
|
+
- **Opção A**: <descrição> — rejeitada porque <razão>
|
|
16
|
+
- **Opção B**: <descrição> — rejeitada porque <razão>
|
|
17
|
+
|
|
18
|
+
## Consequências
|
|
19
|
+
**Positivas**:
|
|
20
|
+
- ...
|
|
21
|
+
|
|
22
|
+
**Negativas / Trade-offs**:
|
|
23
|
+
- ...
|
|
24
|
+
|
|
25
|
+
## Rastreamento
|
|
26
|
+
- Implementação: `<paths>`
|
|
27
|
+
- Issues/PRs: `<refs>`
|
|
28
|
+
- ADRs relacionadas: `<refs>`
|