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,114 @@
|
|
|
1
|
+
# Spec: Architecture Constitution — ADRs como regras executáveis
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-033
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprint 1
|
|
8
|
+
- **ADRs relacionadas**: ADR-0078; depende de SPEC-032 (nós ADR) e reaproveita o motor de
|
|
9
|
+
comparação "isso que era verdade parou de ser" desenhado em `specs/drift-sentinel/spec.md`
|
|
10
|
+
(SPEC-030).
|
|
11
|
+
|
|
12
|
+
## 1. Problema
|
|
13
|
+
|
|
14
|
+
Uma decisão registrada em ADR (`memory/90-decisions/NNNN-*.md`) hoje só é verificada por um
|
|
15
|
+
humano lembrar de reler o documento. Nada impede que o código viole uma restrição arquitetural
|
|
16
|
+
documentada dias, semanas ou meses atrás, sem que ninguém perceba — a mesma classe de problema que
|
|
17
|
+
`drift-sentinel` resolve para relações genéricas do grafo, aqui aplicada especificamente a
|
|
18
|
+
restrições de arquitetura.
|
|
19
|
+
|
|
20
|
+
## 2. Proposta de valor
|
|
21
|
+
|
|
22
|
+
ADRs com uma seção `## Constraints` em formato estruturado (ver §4) compilam para regras
|
|
23
|
+
executáveis (`.context/architecture/constitution.json`, versionado em git), verificáveis por
|
|
24
|
+
`forja architecture:check` a qualquer momento — inclusive como gate de CI, quando o projeto
|
|
25
|
+
consumidor optar por isso.
|
|
26
|
+
|
|
27
|
+
## 3. User stories
|
|
28
|
+
|
|
29
|
+
- **Como** sdd-architect, **quero** que uma restrição documentada em ADR seja verificada
|
|
30
|
+
automaticamente, **para que** "documentado" e "em vigor" nunca divirjam sem ninguém notar.
|
|
31
|
+
- **Como** governance, **quero** um relatório de violações por severidade, **para que** eu saiba
|
|
32
|
+
quais bloqueiam merge e quais são só aviso.
|
|
33
|
+
- **Como** desenvolvedor, **quero** `architecture:explain <rule-id>` antes de contestar uma
|
|
34
|
+
violação, **para que** eu entenda o porquê sem precisar caçar a ADR original.
|
|
35
|
+
|
|
36
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
37
|
+
|
|
38
|
+
- [x] AC-1: formato de `## Constraints` em ADR é determinístico e documentado (ex.: lista com
|
|
39
|
+
prefixo fixo — `- billing não importa database diretamente` vira
|
|
40
|
+
`{kind: 'forbid_import', patterns: ['**/database/**']}` só quando a frase casa um padrão
|
|
41
|
+
reconhecido; frases que não casam viram regra `proposed` com `confidence < 1`, nunca
|
|
42
|
+
`active` por adivinhação).
|
|
43
|
+
- [x] AC-2: `forja architecture:compile` lê `memory/90-decisions/*.md` com `## Constraints`,
|
|
44
|
+
produz `ArchitectureRule[]`, grava `.context/architecture/constitution.json`.
|
|
45
|
+
- [x] AC-3: `forja architecture:check` compara `constitution.json` contra o Engineering Graph
|
|
46
|
+
(arestas `depends_on`/`imports` já extraídas por `extractDeterministicRelations`) e reporta
|
|
47
|
+
violações com severidade (`info|low|medium|high|critical`), path do arquivo, ADR de origem,
|
|
48
|
+
remediação sugerida.
|
|
49
|
+
- [x] AC-4: `forja architecture:status` resume: N regras ativas, N propostas, última compilação.
|
|
50
|
+
- [x] AC-5: `forja architecture:explain <rule-id>` mostra a ADR de origem, o texto original da
|
|
51
|
+
restrição, e a severidade/razão.
|
|
52
|
+
- [x] AC-6: uma regra `proposed` só vira `active` por `forja architecture:approve <rule-id>`
|
|
53
|
+
(reaproveita `ApprovalLedger` de `packages/policy` — **não** um sistema de aprovação
|
|
54
|
+
paralelo).
|
|
55
|
+
- [x] AC-7: `architecture:check` pode participar de `check:all` como item opcional
|
|
56
|
+
(`--with-architecture`), não obrigatório por padrão (mesma decisão de opt-in já tomada para
|
|
57
|
+
`drift:check` em SPEC-030 AC-5, pelo mesmo motivo: custo em repos grandes ainda não medido).
|
|
58
|
+
|
|
59
|
+
**Nota de implementação (achado real, fora de escopo desta spec)**: testar `architecture:check`
|
|
60
|
+
contra o workspace real (`~/forja-workspace`) expôs um diagnóstico enganoso em `memory-db`
|
|
61
|
+
(`lib/core/health.ts`): o gate reportou "banco existe mas não abre (SQLITE_ERROR) — provavelmente
|
|
62
|
+
corrompido", mas `sqlite3 ... PRAGMA integrity_check` confirmou "ok" — não é corrupção. Causa real:
|
|
63
|
+
`getWorkspaceDbPath()` aponta para o mesmo arquivo físico usado por dois mecanismos independentes —
|
|
64
|
+
`scripts/sync-universal-memory.ts` cria sua própria tabela `memory_nodes` via `CREATE TABLE IF NOT
|
|
65
|
+
EXISTS` fora de qualquer migration, enquanto `adr:*`/`architecture:*` (e o já mergeado `drift:check`,
|
|
66
|
+
SPEC-030) usam `SqliteMigrationRunner` (schema do Engineering Graph/policy/runtime). Os dois são
|
|
67
|
+
aditivos — não há conflito de dados — mas se `sync:universal` nunca rodou nesse workspace, a tabela
|
|
68
|
+
`memory_nodes` simplesmente não existe ainda, e o `SELECT count(*) FROM memory_nodes` do health check
|
|
69
|
+
cai no branch genérico de erro, que rotula como "provavelmente corrompido" em vez de "rode `npm run
|
|
70
|
+
sync:universal`". Nenhum dado foi perdido (o arquivo de teste era novo, criado só pelos meus testes
|
|
71
|
+
desta sprint, removido com segurança). Vale uma correção pontual em `health.ts` para diferenciar
|
|
72
|
+
"tabela ausente" de corrupção de fato — não implementada aqui por estar fora do escopo desta spec.
|
|
73
|
+
|
|
74
|
+
**Corrigido posteriormente**: `lib/core/health.ts`'s `memory-db` agora reconhece
|
|
75
|
+
`"no such table: memory_nodes"` como um caso à parte (`warn`, mesma severidade de "banco nunca
|
|
76
|
+
indexado", com `fix: npm run sync:universal` — que de fato resolve, ao contrário do caso
|
|
77
|
+
CANTOPEN/EACCES) em vez de cair no branch genérico de "provavelmente corrompido". Ver
|
|
78
|
+
`test/health.test.js` e o commit que fecha esta nota.
|
|
79
|
+
|
|
80
|
+
## 5. Escopo
|
|
81
|
+
|
|
82
|
+
**Dentro**: compile/check/status/explain/approve; parser determinístico de `forbid_import`/
|
|
83
|
+
`require_dependency`/`forbid_dependency` (os três tipos de restrição citados no exemplo da visão
|
|
84
|
+
original); severidade configurável.
|
|
85
|
+
|
|
86
|
+
**Fora**: sugestão de regra via LLM (mencionada na visão como "Fase 6+", não nesta spec — ver
|
|
87
|
+
`ArchitectureConstraint` no documento de arquitetura, campo `confidence` já reservado para quando
|
|
88
|
+
isso existir); auto-correção de violação (só reporta, nunca aplica); tipos de constraint além dos
|
|
89
|
+
três listados (ex.: regras de nomenclatura, limites de complexidade) — aditivo depois que os três
|
|
90
|
+
básicos estiverem em produção.
|
|
91
|
+
|
|
92
|
+
## 6. NFRs / restrições
|
|
93
|
+
|
|
94
|
+
- **LLM nunca decide regra `active` sozinho** — princípio de segurança explícito da visão
|
|
95
|
+
original, reforçado pela postura fail-closed já em vigor no resto do framework desde a
|
|
96
|
+
auditoria de 2026-08-31.
|
|
97
|
+
- `constitution.json` é artefato de git, não linha SQLite — precisa ser revisável em PR como
|
|
98
|
+
qualquer outro artefato gerado (mesma categoria de `.context/forja-runs.jsonl`).
|
|
99
|
+
- Falso positivo é o risco central (ver riscos) — parser determinístico só reconhece padrões de
|
|
100
|
+
frase explícitos; qualquer coisa fora do padrão vira `proposed`, nunca `active` por default.
|
|
101
|
+
|
|
102
|
+
## 7. Riscos e mitigação
|
|
103
|
+
|
|
104
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
105
|
+
|---|---|---|---|
|
|
106
|
+
| Parser de linguagem natural de `## Constraints` interpretar errado uma frase | Alta (é a natureza do problema) | Alta (falso positivo em massa) | Vocabulário de frase reconhecida é pequeno e explícito (AC-1); fora do vocabulário = `proposed`, nunca `active` |
|
|
107
|
+
| `architecture:check` virar ruído e ser ignorado | Média | Alta (perde todo o valor) | AC-7 opt-in até o sinal ser medido; kill criteria já registrado no `plan.md` da spec master |
|
|
108
|
+
| Conflito entre duas ADRs com constraints contraditórias | Baixa | Média | `architecture:compile` reporta conflito explicitamente como erro de compilação, não escolhe uma silenciosamente |
|
|
109
|
+
|
|
110
|
+
## 8. Métricas de sucesso
|
|
111
|
+
|
|
112
|
+
Compilar as ADRs reais deste repositório (`memory/90-decisions/`) produz pelo menos uma regra
|
|
113
|
+
`active` verificável, e `architecture:check` roda sem falso positivo sobre o código atual (linha de
|
|
114
|
+
base limpa, igual ao Sprint 1 do plan.md da spec master).
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# Tasks: Architecture Constitution
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## T1 — engine puro: parser + compile + check
|
|
11
|
+
- **Owner**: worker
|
|
12
|
+
- **Estimativa**: G
|
|
13
|
+
- **Depende de**: —
|
|
14
|
+
- **Paths**: `packages/engineering/architecture/src/index.ts`
|
|
15
|
+
- **Done quando**:
|
|
16
|
+
- [ ] `parseConstraintLine` reconhece os 3 padrões (D2 do plan) e retorna `undefined`/confiança
|
|
17
|
+
baixa para qualquer coisa fora do vocabulário
|
|
18
|
+
- [ ] `compileConstitution` produz `ArchitectureRule[]` a partir de ADRs reais com
|
|
19
|
+
`## Constraints`
|
|
20
|
+
- [ ] `checkConstitution` compara regras contra `DependencyEdge[]` e reporta violações com
|
|
21
|
+
severidade e remediação
|
|
22
|
+
- [ ] testes unitários (sem `fs`/rede) cobrindo: padrão reconhecido → confidence 1; padrão
|
|
23
|
+
ambíguo → confidence baixa, nunca `active`; violação injetada é detectada; ausência de
|
|
24
|
+
violação é reportada como `compliant`
|
|
25
|
+
|
|
26
|
+
## T2 — `scripts/architecture.ts`: compile/check/status/explain/approve
|
|
27
|
+
- **Owner**: worker
|
|
28
|
+
- **Estimativa**: M
|
|
29
|
+
- **Depende de**: T1
|
|
30
|
+
- **Paths**: `scripts/architecture.ts`, `lib/core/registry.ts`
|
|
31
|
+
- **Done quando**:
|
|
32
|
+
- [ ] `architecture:compile` lê `memory/90-decisions/*.md` reais e grava
|
|
33
|
+
`.context/architecture/constitution.json`
|
|
34
|
+
- [ ] `architecture:check` roda sobre o grafo real (reindexado como `adr:*`/`drift:check` já
|
|
35
|
+
fazem) e reporta zero violação na linha de base deste repositório
|
|
36
|
+
- [ ] `architecture:status`/`architecture:explain <rule-id>` funcionais
|
|
37
|
+
- [ ] `architecture:approve <rule-id>` reaproveita `ApprovalLedger` (`packages/policy`), sem
|
|
38
|
+
sistema de aprovação paralelo
|
|
39
|
+
- [ ] `forja tools:doctor` continua verde (comandos documentados no README)
|
|
40
|
+
|
|
41
|
+
## T3 — prova sobre dado real + violação injetada em teste
|
|
42
|
+
- **Owner**: worker
|
|
43
|
+
- **Estimativa**: P
|
|
44
|
+
- **Depende de**: T2
|
|
45
|
+
- **Paths**: `memory/90-decisions/0078-forjajs-3-engineering-control-plane.md` (`## Constraints`
|
|
46
|
+
já adicionado), `test/architecture-constitution-cli.test.js` (novo)
|
|
47
|
+
- **Done quando**:
|
|
48
|
+
- [ ] `architecture:compile` + `architecture:check` reais sobre este repositório: 1 regra
|
|
49
|
+
ativa, zero violação
|
|
50
|
+
- [ ] teste de CLI com fixture isolada prova que uma violação real (arquivo importando o que a
|
|
51
|
+
regra proíbe) é detectada com exit code ≠ 0
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## Handoffs entre agentes
|
|
56
|
+
|
|
57
|
+
T1→T2→T3 sequencial. Sem handoff de papel — spec e plan já aprovados cobrem as decisões de
|
|
58
|
+
produto/arquitetura.
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
# Plan: Change Risk Engine
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-09-01
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem técnica
|
|
8
|
+
|
|
9
|
+
Novo bounded context `packages/engineering/risk` (autorizado por ADR-0078), puro domínio — a
|
|
10
|
+
fórmula dos 7 fatores (§9 do doc de arquitetura) roda inteira sobre um `RiskInput` já calculado,
|
|
11
|
+
sem `fs`/rede/SQLite. Quem coleta os números reais é `scripts/risk.ts` (adapter), reaproveitando
|
|
12
|
+
integralmente o que Sprint 1 já construiu: `GraphLoop.impact()` para blast radius,
|
|
13
|
+
`checkConstitution` (SPEC-033) para violações de arquitetura, `SqliteObservationStore` (já
|
|
14
|
+
existente em `packages/adapter-sqlite`) para taxa histórica de falha. Nenhuma tabela SQLite nova.
|
|
15
|
+
|
|
16
|
+
## 2. Módulos afetados
|
|
17
|
+
|
|
18
|
+
| Caminho | Mudança | Risco |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| `packages/engineering/risk/src/index.ts` | novo — `assessRisk`, `explainAssessment`, `createRiskEngine`, pesos/thresholds default | Médio — lógica nova, pura/testável |
|
|
21
|
+
| `scripts/risk.ts` | novo — `risk:assess`/`risk:explain`, coleta blast radius/violações/histórico/testes/serviços reais | Médio — bastante integração, mas cada peça já existe |
|
|
22
|
+
| `lib/core/registry.ts` | 2 comandos novos | Baixo |
|
|
23
|
+
| `packages/policy/src/index.ts` | `PolicyScope.riskScoreRange` + `PolicyRequest.riskScore` (campos aditivos, sem import de `@forja/engineering-risk`) | Baixo — extensão aditiva, mesmo padrão de `maxCostUsd` (SPEC-029) |
|
|
24
|
+
| `test/risk-engine.test.js` (novo) | testes puros do motor: fórmula, confidence, bandas | — |
|
|
25
|
+
| `test/risk-cli.test.js` (novo) | fixture git isolada: `risk:assess`/`risk:explain` ponta a ponta | — |
|
|
26
|
+
| `test/policy.test.js` | +1 teste: `riskScoreRange` na `matches()` | — |
|
|
27
|
+
|
|
28
|
+
## 3. Diagrama de fluxo
|
|
29
|
+
|
|
30
|
+
```text
|
|
31
|
+
git diff --name-only [ref] (scripts/risk.ts, coleta)
|
|
32
|
+
│
|
|
33
|
+
├── GraphLoop.impact(origin) ──────────► blast_radius
|
|
34
|
+
├── checkConstitution (constitution.json + arestas DEPENDS_ON) ─► architecture_violations
|
|
35
|
+
├── heurística de path (secrets/database/deployment) ─────────► security_sensitivity
|
|
36
|
+
├── SqliteObservationStore.list() filtrado por files ──────────► historical_failure_rate
|
|
37
|
+
├── existência de test/<nome>.test.js ──────────────────────────► test_confidence
|
|
38
|
+
├── path casa /migration|schema/ ────────────────────────────────► reversibility
|
|
39
|
+
└── packages/*, apps/* distintos tocados ────────────────────────► deployment_complexity
|
|
40
|
+
│
|
|
41
|
+
▼
|
|
42
|
+
assessRisk(input) [packages/engineering/risk, puro]
|
|
43
|
+
│
|
|
44
|
+
▼
|
|
45
|
+
ChangeRiskAssessment (score, confidence, autonomyBand, factors[])
|
|
46
|
+
│
|
|
47
|
+
▼
|
|
48
|
+
.context/risk/<id>.json (efêmero, mesma categoria de forja-runs.jsonl)
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## 4. Contratos (API/CLI/Schema)
|
|
52
|
+
|
|
53
|
+
```ts
|
|
54
|
+
// packages/engineering/risk/src/index.ts
|
|
55
|
+
export type RiskFactorName = 'blast_radius' | 'architecture_violations' | 'security_sensitivity'
|
|
56
|
+
| 'historical_failure_rate' | 'test_confidence' | 'reversibility' | 'deployment_complexity';
|
|
57
|
+
export type RiskWeights = Readonly<Record<RiskFactorName, number>>;
|
|
58
|
+
export const DEFAULT_RISK_WEIGHTS: RiskWeights; // soma 1.0, pesos do §9 do doc de arquitetura
|
|
59
|
+
export interface AutonomyBandThresholds { readonly autonomous: number; readonly autonomousWithReview: number; readonly supervised: number; }
|
|
60
|
+
export const DEFAULT_AUTONOMY_BAND_THRESHOLDS: AutonomyBandThresholds; // 25/50/75 — >75 = human_in_the_loop
|
|
61
|
+
export type AutonomyBand = 'autonomous' | 'autonomous_with_review' | 'supervised' | 'human_in_the_loop';
|
|
62
|
+
export interface RiskInput { /* 7 métricas cruas + evidenceIds por fator — ver código */ }
|
|
63
|
+
export interface RiskFactorResult { readonly name: RiskFactorName; readonly weight: number; readonly value: number; readonly hasRealData: boolean; readonly evidenceIds: readonly string[]; readonly rationale: string; }
|
|
64
|
+
export interface ChangeRiskAssessment { readonly id: string; readonly changeId: string; readonly createdAt: string; readonly score: number; readonly confidence: number; readonly autonomyBand: AutonomyBand; readonly factors: readonly RiskFactorResult[]; }
|
|
65
|
+
export function assessRisk(input: RiskInput, options: { id: string; changeId: string; now: string; weights?: Partial<RiskWeights>; thresholds?: AutonomyBandThresholds }): ChangeRiskAssessment;
|
|
66
|
+
export function explainAssessment(assessment: ChangeRiskAssessment): string;
|
|
67
|
+
export interface RiskEngine { assess(input: RiskInput, meta: { id: string; changeId: string; now: string }): ChangeRiskAssessment; }
|
|
68
|
+
export function createRiskEngine(config?: { weights?: Partial<RiskWeights>; thresholds?: AutonomyBandThresholds }): RiskEngine;
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
risk:assess [ref] # default: diff do working tree vs. HEAD
|
|
73
|
+
risk:explain <assessment-id>
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
```ts
|
|
77
|
+
// packages/policy/src/index.ts — extensão aditiva
|
|
78
|
+
export interface PolicyScope { /* ...campos existentes... */ readonly riskScoreRange?: readonly [number, number]; }
|
|
79
|
+
export interface PolicyRequest { /* ...campos existentes... */ readonly riskScore?: number; }
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## 5. Decisões e alternativas
|
|
83
|
+
|
|
84
|
+
**D1**: `risk:assess` recebe um **git ref opcional** (`risk:assess [ref]`), não uma string livre em
|
|
85
|
+
linguagem natural. A visão original e o §12 (CLI Plan) escrevem `risk:assess "<mudança>"`, que lido
|
|
86
|
+
literalmente sugeriria parsing de texto — incompatível com o NFR "nenhum fator depende de chamada de
|
|
87
|
+
LLM" e com AC-1 (fatores determinísticos). Sem `ref`, compara o working tree contra `HEAD` (mudança
|
|
88
|
+
não commitada ainda, o caso mais comum ao decidir política antes de commitar); com `ref`, compara
|
|
89
|
+
`<ref>^..<ref>`. Mesma resolução já dada a `adr:impact <id>` (recebe um id concreto, não prosa).
|
|
90
|
+
|
|
91
|
+
**D2**: assessments são persistidos em `.context/risk/<id>.json`, efêmero (fora do git, mesma
|
|
92
|
+
categoria de `.context/forja-runs.jsonl` — já ignorado pelo `.gitignore` existente, nenhuma mudança
|
|
93
|
+
de allowlist necessária, ao contrário de `constitution.json` que é fonte de verdade versionada).
|
|
94
|
+
`risk:explain` lê de volta esse arquivo. Alternativa rejeitada: nova tabela SQLite — violaria a NFR
|
|
95
|
+
"nenhuma tabela SQLite nova" desta spec (§6, redigida pelo próprio autor da spec) sem necessidade;
|
|
96
|
+
um assessment é um artefato de leitura pontual, não algo que precisa de índice/query relacional.
|
|
97
|
+
|
|
98
|
+
**D3**: `PolicyRequest.riskScore` é um `number` simples (0-100), não `ChangeRiskAssessment` completo
|
|
99
|
+
como o texto solto da visão original sugeria. `PolicyEngine` só precisa do score para casar
|
|
100
|
+
`riskScoreRange` — carregar o assessment inteiro obrigaria `packages/policy` a conhecer o shape de
|
|
101
|
+
`ChangeRiskAssessment`, violando AC-5 ("policy não importa `packages/engineering/risk`
|
|
102
|
+
diretamente") por tipo estrutural equivalente a import. Quem quiser o assessment completo já tem
|
|
103
|
+
`risk:explain <id>` ou chama `RiskEngine.assess()` diretamente antes de montar o `PolicyRequest`.
|
|
104
|
+
|
|
105
|
+
**D4**: fatores sem dado real (`historical_failure_rate` em cold start, `test_confidence` quando a
|
|
106
|
+
heurística de arquivo de teste não encontra nada) entram no cálculo com um valor neutro (0 para
|
|
107
|
+
histórico — "sem evidência de falha" não é o mesmo que "sem risco", mas é a leitura mais honesta
|
|
108
|
+
disponível; 0.5 para teste — literalmente "desconhecido") e `hasRealData: false`, nunca são
|
|
109
|
+
omitidos do score. `confidence` cai proporcionalmente (AC-3) em vez de o assessment inteiro falhar
|
|
110
|
+
ou mentir com 100% de confiança.
|
|
111
|
+
|
|
112
|
+
## 6. Dependências
|
|
113
|
+
|
|
114
|
+
- SPEC-032 (Engineering Graph) — `GraphLoop.impact()` para blast radius.
|
|
115
|
+
- SPEC-033 (Architecture Constitution) — `checkConstitution` para o fator de violação; roda com
|
|
116
|
+
zero regras (`architectureViolationCount: 0`) se `constitution.json` ainda não foi compilado,
|
|
117
|
+
não é erro bloqueante.
|
|
118
|
+
- `packages/adapter-sqlite.SqliteObservationStore` (já existente, sem migração nova).
|
|
119
|
+
|
|
120
|
+
## 7. Rollout
|
|
121
|
+
|
|
122
|
+
- [ ] Feature flag necessária? Não — comando novo, opt-in por natureza.
|
|
123
|
+
- [ ] Migração de dados existentes? Não.
|
|
124
|
+
- [ ] Doc/persona impactada? README (comandos novos), `docs/architecture/`.
|
|
125
|
+
|
|
126
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
127
|
+
|
|
128
|
+
Já registrado no apêndice de `specs/engineering-intelligence/spec.md`: se `risk:assess` sobre as 5
|
|
129
|
+
mudanças históricas do §8 do spec não ordenar de acordo com julgamento humano, os pesos/fórmula são
|
|
130
|
+
revisados antes de avançar para o Sprint 3 (Evidence Ledger, que agrega o que Risk já produziu).
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
# Spec: Change Risk Engine
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-034
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprint 2
|
|
8
|
+
- **ADRs relacionadas**: ADR-0078; depende de SPEC-032 (blast radius via grafo) e SPEC-033
|
|
9
|
+
(violação de arquitetura como fator de risco)
|
|
10
|
+
|
|
11
|
+
## 1. Problema
|
|
12
|
+
|
|
13
|
+
Hoje, o único sinal de risco de uma mudança é o `risk: RiskLevel` estático declarado na
|
|
14
|
+
`CapabilityDefinition` (`low|medium|high|critical`) — um valor fixo por capability, não calculado a
|
|
15
|
+
partir da mudança real (quantos arquivos, quantos módulos afetados, se viola arquitetura, se o
|
|
16
|
+
domínio tem histórico de falha). Duas mudanças na mesma capability podem ter risco real muito
|
|
17
|
+
diferente e recebem o mesmo tratamento de política.
|
|
18
|
+
|
|
19
|
+
## 2. Proposta de valor
|
|
20
|
+
|
|
21
|
+
`forja risk:assess "<mudança>"` produz um score 0-100 explicável (fatores nomeados, com evidência),
|
|
22
|
+
que o Policy Engine pode opcionalmente consultar para calibrar a exigência de aprovação além do
|
|
23
|
+
`risk` estático da capability.
|
|
24
|
+
|
|
25
|
+
## 3. User stories
|
|
26
|
+
|
|
27
|
+
- **Como** governance, **quero** um score de risco com fatores visíveis, **para que** eu confie
|
|
28
|
+
na exigência de aprovação em vez de tratá-la como arbitrária.
|
|
29
|
+
- **Como** desenvolvedor, **quero** `risk:explain` mostrando exatamente por que um score saiu alto,
|
|
30
|
+
**para que** eu saiba o que reduzir (mais teste? menos arquivos? revisão de arquitetura?) antes
|
|
31
|
+
de tentar de novo.
|
|
32
|
+
|
|
33
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
34
|
+
|
|
35
|
+
- [x] AC-1: `RiskEngine.assess(input): ChangeRiskAssessment` (interface pura, sem I/O) implementa a
|
|
36
|
+
fórmula documentada em `docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md`
|
|
37
|
+
§9, com os 7 fatores nomeados e pesos default configuráveis.
|
|
38
|
+
- [x] AC-2: cada fator do assessment carrega `evidenceIds` (nós/arestas do grafo, `Observation`s
|
|
39
|
+
históricas) — nenhum score sem rastro de onde veio.
|
|
40
|
+
- [x] AC-3: `confidence` do assessment reflete a fração de fatores com dado real disponível — um
|
|
41
|
+
projeto sem histórico de falha ainda produz um score, mas com confiança visivelmente menor,
|
|
42
|
+
nunca escondida.
|
|
43
|
+
- [x] AC-4: `forja risk:assess [ref]` (CLI, ver D1 do plan — ref de git, não prosa livre) e
|
|
44
|
+
`forja risk:explain <assessment-id>` funcionais.
|
|
45
|
+
- [x] AC-5: interface `RiskAssessor`/`RiskEngine` pequena e opcional — `packages/policy` nunca
|
|
46
|
+
importa `packages/engineering/risk`; `PolicyRequest.riskScore` é um `number` puro (D3 do
|
|
47
|
+
plan), não o assessment inteiro.
|
|
48
|
+
- [x] AC-6: faixas de autonomia (0-25 autonomous / 26-50 autonomous_with_review / 51-75 supervised
|
|
49
|
+
/ 76-100 human_in_the_loop, sugeridas na visão original) são **configuração default**, nunca
|
|
50
|
+
constante fixa no código — mesmo padrão já usado por `RuntimeLimits`/`PolicyLimits`.
|
|
51
|
+
|
|
52
|
+
## 5. Escopo
|
|
53
|
+
|
|
54
|
+
**Dentro**: os 7 fatores documentados em §9 do doc de arquitetura; interface pura `RiskEngine`;
|
|
55
|
+
CLI `risk:assess`/`risk:explain`; interface de consumo opcional pelo Policy Engine.
|
|
56
|
+
|
|
57
|
+
**Fora**: aplicação automática de `REQUIRE_APPROVAL`/`DENY` a partir do score sem uma regra de
|
|
58
|
+
política explícita configurada para isso (o score informa a decisão, não a toma sozinho — decisão
|
|
59
|
+
de política continua sendo do `PolicyEngine`, nunca do `RiskEngine`); UI/heatmap de risco (Fase
|
|
60
|
+
posterior).
|
|
61
|
+
|
|
62
|
+
## 6. NFRs / restrições
|
|
63
|
+
|
|
64
|
+
- Determinístico onde possível; nenhum fator depende de chamada de LLM.
|
|
65
|
+
- `RiskEngine` não tem efeito colateral — é uma função pura sobre dados já coletados em outro
|
|
66
|
+
lugar (grafo, `Observation`, `architecture:check`).
|
|
67
|
+
- Fórmula e pesos vivem em um único lugar documentado (código + este spec) — nunca duplicados.
|
|
68
|
+
|
|
69
|
+
## 7. Riscos e mitigação
|
|
70
|
+
|
|
71
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
72
|
+
|---|---|---|---|
|
|
73
|
+
| Score virar "número mágico" que ninguém entende | Alta se mal implementado | Alta (perde toda a confiança) | AC-2/AC-3 obrigam evidência e confidence em todo assessment, sem exceção |
|
|
74
|
+
| Pesos default não fazerem sentido para todo tipo de projeto | Alta | Média | Pesos configuráveis por projeto desde o dia 1 (AC-1), não hardcoded |
|
|
75
|
+
| Cold start: projeto novo sem `Observation` histórica | Alta em projetos novos | Baixa (é esperado) | `confidence` reduzida é a resposta correta, não um erro ou bloqueio |
|
|
76
|
+
|
|
77
|
+
## 8. Métricas de sucesso
|
|
78
|
+
|
|
79
|
+
Rodar `risk:assess` sobre 5 mudanças históricas reais deste repositório (ex.: a extração do
|
|
80
|
+
`isPathWithinRoot`, a correção do policy approval bypass) produz scores que, em revisão humana,
|
|
81
|
+
ordenam corretamente do menos para o mais arriscado.
|
|
82
|
+
|
|
83
|
+
**Validado**: `risk:assess <ref>` rodado contra 5 commits reais deste repositório (grafo real,
|
|
84
|
+
`.context/architecture/constitution.json` real, sem fixture):
|
|
85
|
+
|
|
86
|
+
| Commit | Descrição | Score |
|
|
87
|
+
|---|---|---|
|
|
88
|
+
| `6f220ed` | refatoração: extrai runner de capability sandboxed reutilizável | 7 |
|
|
89
|
+
| `a950711` | fix de segurança pontual (1 arquivo): argument-injection em `code:impact` | 11 |
|
|
90
|
+
| `1a49682` | docs: remove citação de comando ainda não implementado | 13 |
|
|
91
|
+
| `fdab8e3` | feature nova: `drift:check` (SPEC-030) | 13 |
|
|
92
|
+
| `f678d37` | fix de segurança multi-arquivo: auth do proxy do dashboard, DB shutdown handler | 19 |
|
|
93
|
+
|
|
94
|
+
Ordem (revisão humana, apk): o fix de segurança multi-arquivo fica corretamente no topo; a
|
|
95
|
+
refatoração autocontida (menor blast radius, nada ainda depende do novo helper) fica corretamente
|
|
96
|
+
no fundo. Ordem aceita — sem redesenho de pesos necessário (kill criteria do apêndice de
|
|
97
|
+
`specs/engineering-intelligence/spec.md` não disparado).
|
|
98
|
+
|
|
99
|
+
**Achado real (limitação documentada, não corrigida — heurística determinística, não regressão de
|
|
100
|
+
AC)**: `security_sensitivity` não pegou `f678d37` como sensível, apesar de o commit mexer em
|
|
101
|
+
autenticação (`apps/dashboard/app/api/forja/guard.ts`) e desligamento de banco
|
|
102
|
+
(`apps/server/src/main.ts`). A heurística de `scripts/risk.ts` (`inferSensitiveCategories`) casa só
|
|
103
|
+
substring de path (`secret|credential|\.env`, `adapter-sqlite|migration|database`,
|
|
104
|
+
`deploy|\.github/workflows|Dockerfile`) — nenhum desses arquivos tem esses termos no caminho, então
|
|
105
|
+
o fator não disparou. É determinístico (cumpre a NFR de "nenhum fator depende de LLM") mas tem
|
|
106
|
+
recall baixo para segurança que não está em path óbvio. Não corrigido aqui: exigiria uma heurística
|
|
107
|
+
mais rica (ex.: casar contra `PolicyCategory` já inferida do `capabilityId`/handler tocado, não só
|
|
108
|
+
o path do arquivo) — candidato a uma spec própria de refinamento, fora do escopo desta fundação.
|
|
109
|
+
|
|
110
|
+
**Melhoria posterior (não a correção estrutural completa, uma redução da superfície mais óbvia de
|
|
111
|
+
falso-negativo)**: `SENSITIVE_PATTERNS` (`lib/core/risk-collect.ts`, movida de `scripts/risk.ts` no
|
|
112
|
+
Sprint 6) ganhou `auth|guard|session|token` na categoria `secrets` e `shutdown` na categoria
|
|
113
|
+
`database` — termos adjacentes a controle de acesso/ciclo de vida de credencial e conexão que a
|
|
114
|
+
lista original não cobria. Revalidado contra o mesmo `f678d37`: `security_sensitivity` agora
|
|
115
|
+
detecta `secrets, database` (antes: nenhuma), score final `19/100 → 29/100`, banda de autonomia
|
|
116
|
+
`autonomous → autonomous_with_review` — mais correto pro que o commit de fato fez. **A limitação
|
|
117
|
+
estrutural continua real**: qualquer lista fixa de palavras-chave tem recall limitado por natureza;
|
|
118
|
+
a correção estrutural sugerida na nota original (casar contra `PolicyCategory` inferida do
|
|
119
|
+
handler/capability tocado) segue não implementada e fora do escopo desta fundação.
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# Tasks: Change Risk Engine
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## T1 — engine puro: fórmula + confidence + bandas de autonomia
|
|
11
|
+
- **Owner**: worker
|
|
12
|
+
- **Estimativa**: G
|
|
13
|
+
- **Depende de**: —
|
|
14
|
+
- **Paths**: `packages/engineering/risk/src/index.ts`
|
|
15
|
+
- **Done quando**:
|
|
16
|
+
- [ ] `assessRisk` implementa os 7 fatores com os pesos default de §9 do doc de arquitetura
|
|
17
|
+
(soma 1.0), pesos sobrescrevíveis via `options.weights`
|
|
18
|
+
- [ ] `confidence` = fração de fatores com `hasRealData: true` (AC-3)
|
|
19
|
+
- [ ] `autonomyBand` usa `AutonomyBandThresholds` configurável, default 25/50/75 (AC-6)
|
|
20
|
+
- [ ] cada `RiskFactorResult` carrega `evidenceIds` (passthrough do `RiskInput`, nunca inventado
|
|
21
|
+
pelo engine) — AC-2
|
|
22
|
+
- [ ] testes unitários (sem `fs`/rede): fator sem dado real reduz `confidence` mas não quebra o
|
|
23
|
+
score; pesos customizados mudam o resultado; as 4 bandas de autonomia nos limites exatos
|
|
24
|
+
(25/26/50/51/75/76)
|
|
25
|
+
|
|
26
|
+
## T2 — `scripts/risk.ts`: coleta real + `risk:assess`/`risk:explain`
|
|
27
|
+
- **Owner**: worker
|
|
28
|
+
- **Estimativa**: M
|
|
29
|
+
- **Depende de**: T1
|
|
30
|
+
- **Paths**: `scripts/risk.ts`, `lib/core/registry.ts`
|
|
31
|
+
- **Done quando**:
|
|
32
|
+
- [ ] blast radius via `GraphLoop.impact()` sobre o grafo real (reindexado como
|
|
33
|
+
`adr:*`/`architecture:*` já fazem)
|
|
34
|
+
- [ ] violações de arquitetura via `checkConstitution` sobre `constitution.json` (SPEC-033),
|
|
35
|
+
escopadas aos arquivos alterados
|
|
36
|
+
- [ ] taxa histórica de falha via `SqliteObservationStore.list()` filtrado por `files`
|
|
37
|
+
(cold start = `undefined`, não 0 mentiroso)
|
|
38
|
+
- [ ] `risk:assess [ref]` grava `.context/risk/<id>.json` (D2 do plan) e imprime
|
|
39
|
+
`explainAssessment`
|
|
40
|
+
- [ ] `risk:explain <id>` lê o arquivo de volta
|
|
41
|
+
- [ ] `forja tools:doctor` continua verde (comandos documentados no README)
|
|
42
|
+
|
|
43
|
+
## T3 — integração opcional com Policy Engine
|
|
44
|
+
- **Owner**: worker
|
|
45
|
+
- **Estimativa**: P
|
|
46
|
+
- **Depende de**: T1
|
|
47
|
+
- **Paths**: `packages/policy/src/index.ts`, `test/policy.test.js`
|
|
48
|
+
- **Done quando**:
|
|
49
|
+
- [ ] `PolicyScope.riskScoreRange`/`PolicyRequest.riskScore` (D3 do plan — `number`, não o
|
|
50
|
+
assessment inteiro)
|
|
51
|
+
- [ ] `PolicyEngine.matches()` respeita `riskScoreRange` quando presente, sem quebrar nenhuma
|
|
52
|
+
regra existente que não o declara (campo opcional)
|
|
53
|
+
- [ ] `packages/policy` continua sem importar `packages/engineering/risk` (AC-5, checável por
|
|
54
|
+
`grep -r "engineering-risk\|engineering/risk" packages/policy/src`)
|
|
55
|
+
|
|
56
|
+
## T4 — prova sobre dado real
|
|
57
|
+
- **Owner**: worker
|
|
58
|
+
- **Estimativa**: P
|
|
59
|
+
- **Depende de**: T2
|
|
60
|
+
- **Paths**: `test/risk-cli.test.js` (novo)
|
|
61
|
+
- **Done quando**:
|
|
62
|
+
- [ ] fixture git isolada com 2+ pacotes, uma mudança que toca 1 arquivo: `risk:assess` produz
|
|
63
|
+
score+fatores+confidence coerentes com os dados da fixture (blast radius > 0, sem histórico
|
|
64
|
+
→ `historical_failure_rate.hasRealData === false`)
|
|
65
|
+
- [ ] `risk:explain <id>` recupera o mesmo assessment
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## Handoffs entre agentes
|
|
70
|
+
|
|
71
|
+
T1 → (T2, T3 em paralelo, ambas só dependem de T1) → T4. Sem handoff de papel — spec e plan já
|
|
72
|
+
aprovados cobrem as decisões de produto/arquitetura.
|