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,442 @@
|
|
|
1
|
+
# ForjaJS 3.0 — Engineering Intelligence / Engineering Twin — Architecture
|
|
2
|
+
|
|
3
|
+
- **Status**: draft — primeira entrega (auditoria + arquitetura proposta), sem implementação
|
|
4
|
+
- **Autor**: apk (com assistência do Forja Engineer via Claude)
|
|
5
|
+
- **Criado em**: 2026-09-01
|
|
6
|
+
- **ADR principal**: [ADR-0078](../../memory/90-decisions/0078-forjajs-3-engineering-control-plane.md)
|
|
7
|
+
- **Spec master**: [SPEC-031 — Engineering Intelligence](../../specs/engineering-intelligence/spec.md)
|
|
8
|
+
|
|
9
|
+
> Este documento é o produto da "primeira entrega" pedida antes de qualquer código: auditoria do
|
|
10
|
+
> estado atual, gap analysis, arquitetura proposta e plano de sprints. Nenhuma das 33 features
|
|
11
|
+
> listadas na visão original foi implementada a partir deste documento — ele existe para decidir
|
|
12
|
+
> **o que construir e em que ordem**, não para documentar o que já foi construído.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## 1. Current State — o que a Forja já é
|
|
17
|
+
|
|
18
|
+
A Forja 2.0 já é, hoje, uma plataforma real (não um protótipo) com os seguintes componentes
|
|
19
|
+
verificados em código, não em documentação:
|
|
20
|
+
|
|
21
|
+
| Pacote | O que já faz | Linhas (aprox.) |
|
|
22
|
+
|---|---|---|
|
|
23
|
+
| `packages/contracts` | Contratos versionados (`CONTRACT_VERSION = '2.0'`), `KnowledgeStatus`, `PolicyEffect`, `ExecutionState`, `SandboxState`, `GraphNode`/`GraphEdge`/`Evidence`, `RuntimeRun`, `ApprovalRequest`, `Sprint`/`Task`/`Handoff`, `Observation`, `ControlPlaneMetrics`, `EvaluationReport`, e (desde a auditoria de 2026-08-31) `isPathWithinRoot` | ~145 |
|
|
24
|
+
| `packages/graph` | **GraphLoop**: nós/arestas com `status: verified\|inferred\|hypothesis\|contradicted\|unknown`, validade temporal (`validFrom`/`validTo`), evidência ligada a aresta, `path()`/`impact()`/`contradictions()`/`agenda()`/`contextRecords()`. `GraphIndexer.sync()` é idempotente por checksum de fonte. `extractDeterministicRelations()` extrai `DEPENDS_ON`/`CALLS`/`IMPLEMENTS`/`DERIVED_FROM` (ADR)/`CONTAINS` (task)/`ASSIGNED_TO` (agent)/`VALIDATES` (test) por regex determinístico — **sem LLM**. Desde a auditoria, `status: 'verified'` só é aceito de fontes de evidência confiáveis (allowlist configurável) | ~410 |
|
|
25
|
+
| `packages/policy` | `PolicyEngine`: regras com `scope` (agente/role/capability/projeto/ambiente/risco/categoria/`pathPrefixes`), efeitos `ALLOW\|ALLOW_WITH_LIMITS\|REQUIRE_APPROVAL\|DENY`, `limits` (`maxTokens`/`maxFiles`/`maxDurationMs`/`maxRetries`, agora **aplicados de verdade**, não só computados), `ApprovalLedger` com resolução por `correlationId` (aprovar uma vez resolve o retry, não fica pedindo pra sempre) | ~230 |
|
|
26
|
+
| `packages/core` | `CapabilityRegistry`: registro de capabilities com `definition` (risco, side effects, permissões, timeout, retry), `execute()` chama `policy.authorize()` antes do handler, aplica `decision.limits` | ~240 |
|
|
27
|
+
| `packages/runtime` | `RuntimeEngine`: máquina de estados (`created→planning→running→awaiting_approval→validating→completed\|blocked\|failed`), checkpoint/retomada via SQLite, limites globais (`maxSteps`/`maxTokens`/`maxFiles`/`maxDurationMs`/`maxRetries`) | ~345 |
|
|
28
|
+
| `packages/validator` | `DeterministicValidator`: agrega checks/critérios de aceite, computa `scope` automaticamente contra `allowedFiles` do plano, **exige evidência para qualquer "passed"** (desde a auditoria) | ~95 |
|
|
29
|
+
| `packages/orchestration` | `SprintEngine`/`TaskEngine`/`HandoffEngine`: sprint→task→handoff com 7 campos obrigatórios (ADR-0005), guarda de concorrência otimista, teto de handoffs por `correlationId` | ~265 |
|
|
30
|
+
| `packages/sandbox` | `SandboxEngine`: máquina de estados `created→prepared→executing→validating→ready_to_promote→promoted\|rejected\|rolled_back→destroyed`. Desde hoje, `runSandboxedCapability()` empacota o ciclo completo em uma chamada reutilizável | ~220 |
|
|
31
|
+
| `packages/adapter-git` | `GitWorktreeBackend` (isolamento real via `git worktree`), `GitPatchApplier`, `SpawnCommandRunner` sem herdar env por padrão | ~150 |
|
|
32
|
+
| `packages/adapter-sqlite` | Stores SQLite para cada engine acima — memória, aprovações, sandbox, runtime, orquestração, auditoria, observações, grafo | ~300 |
|
|
33
|
+
| `packages/adapter-nest` | Adapter HTTP local (`ForjaNestAdapter`), autenticação **fail-closed a loopback** quando sem token (desde a auditoria) | ~130 |
|
|
34
|
+
| `packages/context` | `ContextEngine`: seleciona candidatos por relevância, deduplica por checksum, respeita orçamento de tokens, cacheia | ~175 |
|
|
35
|
+
| `packages/mcp` | Servidor MCP com ferramentas `forja_capability_execute`, `forja_handoff_create`, `forja_context_build`, `forja_memory_query`, `forja_graph_query`, `forja_code_impact`, `forja_task_next`, `forja_spec_check`, `forja_test_run`, `forja_execution_validate` — todas passam por `authorize()` desde a auditoria | ~260 |
|
|
36
|
+
| `packages/plugin-sdk` | `PluginRegistry`, manifesto com `permissions` explícitas, `PluginContext` que aplica `requirePermission()` antes de qualquer chamada ao host | ~90 |
|
|
37
|
+
| `packages/observability` | `ObservabilityRecorder`, `ControlPlane` (métricas agregadas: runs, sucesso, tokens, custo, evidência) | ~155 |
|
|
38
|
+
| `packages/events` | `EventBus` com idempotência, dead-letter, offsets — já é o barramento de eventos do sistema | ~150 |
|
|
39
|
+
| `packages/evals` | `EvaluationEngine`: agrega `Observation[]` em `EvaluationReport` por escopo (`run\|agent\|task\|sprint\|capability\|model\|strategy\|workspace`) | ~75 |
|
|
40
|
+
| `packages/planner` | `DeterministicPlanner`: decompõe objetivo em plano com dependências, risco, orçamento — **sem LLM** | ~90 |
|
|
41
|
+
| `apps/cli` | CLI real (`bin/forja.ts`) roteando ~50 comandos; nenhuma capability registrada aqui escreve em arquivos de projeto (todas são leitura, `context_run_record`, `handoff_record` ou `graph_write` — bookkeeping do framework, não edição de código) | — |
|
|
42
|
+
| `apps/server` | NestJS + REST/SSE, controle de acesso, fecha SQLite no shutdown | — |
|
|
43
|
+
| `apps/dashboard` | Next.js, proxy autenticado para o server, sem lógica de autorização própria | — |
|
|
44
|
+
| `apps/worker` | Processo separado para jobs longos | — |
|
|
45
|
+
| `scripts/demo-autonomy.ts` | **Prova end-to-end real** do ciclo completo: contexto → plano → política → aprovação humana → sandbox real (git worktree) → validação → promoção → grafo → sprint/task/handoff → evento — hoje o único lugar que fecha o círculo inteiro | — |
|
|
46
|
+
|
|
47
|
+
**O que isso significa**: a Forja já tem — implementados e testados, não apenas desenhados — quatro
|
|
48
|
+
das cinco peças que a visão de "Engineering Control Plane" precisa: um motor de política com
|
|
49
|
+
aprovação, um runtime supervisionado com checkpoint, um grafo de conhecimento com evidência e
|
|
50
|
+
validade temporal, e um sandbox real. **O que falta não é reinventar essas peças — é estender o
|
|
51
|
+
grafo para cobrir engenharia (não só código) e construir três motores novos por cima delas**
|
|
52
|
+
(Constitution, Risk, Provenance) mais um pouco de identidade/reputação de agente.
|
|
53
|
+
|
|
54
|
+
## 2. Target State — o que a visão pede
|
|
55
|
+
|
|
56
|
+
Resumo dos 33 blocos da visão, agrupados pelas 5 perguntas que a Forja deveria conseguir responder
|
|
57
|
+
de forma estruturada e auditável ao final da evolução (ver §12 do documento original):
|
|
58
|
+
|
|
59
|
+
1. **Por que o código existe** → Engineering Graph liga código a SPEC/ADR/Requirement.
|
|
60
|
+
2. **A mudança viola a arquitetura** → Architecture Constitution + `architecture:check`.
|
|
61
|
+
3. **Qual o risco** → Change Risk Engine + Risk-Based Autonomy (integrado ao Policy Engine já
|
|
62
|
+
existente, não um sistema paralelo).
|
|
63
|
+
4. **Quem/o quê mudou isso** → AI Code Provenance (`forja blame`) + Agent Identity.
|
|
64
|
+
5. **A Forja aprende com o passado** → Learning Loop + Incident Graph + Agent Reputation.
|
|
65
|
+
|
|
66
|
+
## 3. Gap Analysis
|
|
67
|
+
|
|
68
|
+
| Capacidade pedida | Situação real | Classificação |
|
|
69
|
+
|---|---|---|
|
|
70
|
+
| Engineering Graph (nós Code/ADR/Spec/Agent/Run/Test/Incident/PR) | `GraphLoop` já é um grafo genérico com evidência e validade temporal; só faltam os **tipos de nó/aresta** de engenharia (ADR, SPEC, Agent, Run, Incident, PR) e os extratores que os populam | **Estender**, não recriar |
|
|
71
|
+
| Architecture Constitution | Não existe. `extractDeterministicRelations` já prova que extração determinística de ADR funciona (regex por `ADR-\d{4}`) — é a base para extrair `## Constraints` de forma determinística | **Construir**, reaproveitando o extrator |
|
|
72
|
+
| Architecture Drift Detection (`architecture:check`) | `specs/drift-sentinel` (em implementação nesta mesma sessão) já resolve a versão genérica ("uma relação verificada parou de ser reproduzida") — Architecture Drift é esse mesmo motor aplicado especificamente a regras da Constitution | **Compor** drift-sentinel + Constitution, não duplicar |
|
|
73
|
+
| Change Risk Engine | Não existe motor de score. Mas todos os insumos já existem: `GraphLoop.impact()` (blast radius), `EvaluationReport`/`Observation` (taxa histórica de falha), `PolicyEngine` (categoria/risco por regra) | **Construir**, compondo dados existentes |
|
|
74
|
+
| Risk-Based Autonomy | `PolicyEngine` já tem `ALLOW\|ALLOW_WITH_LIMITS\|REQUIRE_APPROVAL\|DENY` e `approvalRequiredRisks` configurável por `RiskLevel` | **Estender** `RiskLevel`/regras, não criar motor de decisão paralelo |
|
|
75
|
+
| Predictive Change Simulation (`forja simulate`) | `SandboxEngine` + `GitWorktreeBackend` + `runSandboxedCapability` (hoje) já são exatamente "aplicar em worktree isolado, testar, decidir promover ou descartar" | **Compor** sandbox + risk engine + architecture:check |
|
|
76
|
+
| ADR Graph / Decision Impact | `extractDeterministicRelations` já cria nós `ADR` e aresta `DERIVED_FROM` a partir de `ADR-\d{4}` no texto | **Estender** com status (`accepted/proposed/deprecated/superseded`) e `adr:impact` usando `GraphLoop.impact()` que já existe |
|
|
77
|
+
| `forja engineer` (façade) | Nada equivalente hoje — mas é literalmente uma composição de `ContextEngine` + `DeterministicPlanner` + `GraphLoop` + Risk Engine (novo) + `PolicyEngine`, todos já existentes | **Construir só a façade**, proibido reimplementar qualquer peça |
|
|
78
|
+
| Agent Identity | `AgentIdentity` já existe como tipo (`id`, `role`, `autonomy`) mas é efêmero — não é uma entidade persistida com histórico | **Estender** o contrato + persistência, não trocar o conceito |
|
|
79
|
+
| Agent Reputation / Project Evals | `EvaluationEngine`/`EvaluationReport` já agregam `Observation[]` por `scope: 'agent' \| 'model' \| ...` — a agregação existe, falta só o *report* voltado a reputação e o comando `agent:score` | **Estender**, não recriar |
|
|
80
|
+
| Smart Agent Routing | `scripts/llm-fit.ts`/`llm:recommend`/`llm:profiles` já fazem roteamento determinístico por papel/tarefa sem custo de rede ("LLM Fit Loop", ADR-0074) — é precisamente o esqueleto de Smart Routing | **Estender** com dados de reputação, não substituir |
|
|
81
|
+
| AI Code Provenance (`forja blame`) | `Observation` já tem `model`, `agentId`, `runId`, `inputHash`, `contextRefs` — falta ligar linha de código a `Observation`, o que exige um novo tipo de aresta no grafo (`GENERATED_BY`) | **Construir**, dado que os campos-fonte já existem |
|
|
82
|
+
| AI-SBOM | Não existe, mas é um relatório derivado do grafo de provenance — nenhuma nova fonte de dado, só agregação | **Construir** por cima do grafo |
|
|
83
|
+
| Agent Runtime Monitoring / Anomaly Engine | Não existe. `PolicyEngine` já é o lugar certo para acoplar (política decide, não o LLM) | **Construir**, mas *dentro* de Policy, não paralelo |
|
|
84
|
+
| Learning Loop / Incident → Knowledge | Não existe. `GraphLoop` + evidência já dão a base; falta o tipo de nó `Incident` e o fluxo de sugestão (nunca aplicação automática) | **Construir**, reaproveitando grafo + approvals |
|
|
85
|
+
| Autonomous Maintenance | Não existe nada além da base (`RuntimeEngine` + `PolicyEngine` + `SandboxEngine` já provam o ciclo supervisionado de ponta a ponta via `demo-autonomy.ts`) | **Fase 7** — arquitetar o caminho, não habilitar agora |
|
|
86
|
+
| Engineering API (`packages/engineering`, etc.) | Não existe como pacote — mas o padrão "domain core sem framework" já é a convenção de todo `packages/*` hoje | **Construir seguindo o padrão existente** |
|
|
87
|
+
| Provider-agnostic model layer | Já existe: `packages/llm` roteia por CLI adapter, sem acoplamento a um provider | **Nada a fazer** — só não violar |
|
|
88
|
+
|
|
89
|
+
**Conclusão do gap analysis**: nenhuma das 33 features exige reescrever nada que já existe. Todas
|
|
90
|
+
se apoiam em três extensões de contrato (tipos de nó/aresta no grafo, campos em `AgentIdentity`,
|
|
91
|
+
campos em `PolicyRule`) e quatro motores novos (Constitution, Risk, Provenance, Identity/Reputation)
|
|
92
|
+
que **compõem** engines existentes em vez de duplicá-las.
|
|
93
|
+
|
|
94
|
+
## 4. Bounded Contexts propostos
|
|
95
|
+
|
|
96
|
+
Novo pacote: **`packages/engineering`** — não um pacote monolítico, mas um diretório com
|
|
97
|
+
sub-bounded-contexts próprios, cada um seguindo a mesma regra que já rege `packages/core`,
|
|
98
|
+
`packages/policy` etc.: **framework-independent, importa só `packages/contracts` e (quando preciso)
|
|
99
|
+
`packages/graph`**.
|
|
100
|
+
|
|
101
|
+
```text
|
|
102
|
+
packages/engineering/
|
|
103
|
+
architecture/ ArchitectureEngine — compila Constitution, roda architecture:check
|
|
104
|
+
risk/ RiskEngine — score de mudança, fórmula configurável
|
|
105
|
+
provenance/ ProvenanceEngine — liga código a Observation/Run/Agent
|
|
106
|
+
identity/ AgentIdentityService, AgentReputationService
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
Por que um pacote com sub-diretórios e não quatro pacotes `@forja/architecture`,
|
|
110
|
+
`@forja/risk`, etc.? Porque os quatro comportam contratos e regras de negócio da MESMA camada
|
|
111
|
+
(bounded contexts irmãos, não em cadeia de dependência um do outro) e crescem juntos nas mesmas
|
|
112
|
+
sprints (Fase 1). Divergir em pacotes separados antes de qualquer um deles estabilizar é
|
|
113
|
+
over-engineering — `packages/policy`/`packages/core`/`packages/runtime` só viraram pacotes
|
|
114
|
+
separados depois que a fronteira entre eles já estava provada em uso real (ADR-0020). Fica como
|
|
115
|
+
critério explícito de follow-up: se `engineering/risk` crescer a ponto de precisar de sua própria
|
|
116
|
+
release/versão independente de `engineering/architecture`, aí sim vira `packages/risk` — decisão
|
|
117
|
+
adiada de propósito, não ignorada.
|
|
118
|
+
|
|
119
|
+
`packages/engineering` depende de `packages/contracts` e `packages/graph` (para ler/escrever nós de
|
|
120
|
+
engenharia). **Não depende de `packages/policy`** — é o inverso: `PolicyEngine` opcionalmente
|
|
121
|
+
consulta um `RiskEngine` via uma interface pequena (`RiskAssessor`), não o contrário, preservando a
|
|
122
|
+
direção de dependência do ADR-0020 (`policy` não sabe de `engineering`; `engineering` não sabe de
|
|
123
|
+
`policy` — quem os compõe é a camada de aplicação, ex.: `forja engineer`).
|
|
124
|
+
|
|
125
|
+
## 5. Arquitetura proposta
|
|
126
|
+
|
|
127
|
+
```text
|
|
128
|
+
packages/contracts
|
|
129
|
+
│
|
|
130
|
+
packages/graph ◄──────────────┐
|
|
131
|
+
│ │
|
|
132
|
+
packages/engineering │
|
|
133
|
+
(architecture, risk, │
|
|
134
|
+
provenance, identity) │
|
|
135
|
+
│ │
|
|
136
|
+
┌────────────┼────────────┐ │
|
|
137
|
+
│ │ │ │
|
|
138
|
+
packages/policy packages/planner │ │
|
|
139
|
+
│ │ │ │
|
|
140
|
+
└────────────┼────────────┘ │
|
|
141
|
+
│ │
|
|
142
|
+
packages/orchestration │
|
|
143
|
+
│ │
|
|
144
|
+
packages/runtime │
|
|
145
|
+
│ │
|
|
146
|
+
apps/cli · apps/server · packages/mcp ──────┘
|
|
147
|
+
(adapters — cada um compõe os engines,
|
|
148
|
+
nenhum reimplementa lógica)
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
`packages/engineering` senta **entre** `graph` e `policy`/`planner`, na mesma posição de domínio
|
|
152
|
+
independente de framework descrita em `docs/architecture/FORJA-2.0-ARCHITECTURE.md` — mesma direção
|
|
153
|
+
de dependência (interfaces externas → adapters → application → domain core), estendida com uma
|
|
154
|
+
camada de domínio a mais.
|
|
155
|
+
|
|
156
|
+
## 6. Data Model — extensões de contrato
|
|
157
|
+
|
|
158
|
+
Em `packages/contracts/src/index.ts`, aditivo (nunca remove campo existente — SPEC-012/`noImplicitAny`
|
|
159
|
+
já provou que este repo trata mudança de contrato como ratchet, não como reescrita):
|
|
160
|
+
|
|
161
|
+
```ts
|
|
162
|
+
// Novos tipos de nó de engenharia — reaproveitam GraphNode.type (string livre) e
|
|
163
|
+
// GraphNode.status (KnowledgeStatus) já existentes. Não é um novo contrato de nó,
|
|
164
|
+
// é um VOCABULÁRIO de `type` documentado — igual o extractDeterministicRelations
|
|
165
|
+
// já faz hoje com 'Project'|'Document'|'File'|'Symbol'|'ADR'|'Task'|'Agent'|'Test'.
|
|
166
|
+
export const ENGINEERING_NODE_TYPES = [
|
|
167
|
+
'ADR', 'SPEC', 'Requirement', 'BusinessRule', // já parcial (ADR)
|
|
168
|
+
'Module', 'Class', 'Function', 'API', 'Worker', 'Table', // já parcial (File/Symbol)
|
|
169
|
+
'Agent', 'Model', 'Run', 'Context', 'Tool', 'Capability', // Agent já existe
|
|
170
|
+
'Test', 'Evaluation', 'Failure', 'Incident', // Test já existe
|
|
171
|
+
'Commit', 'Branch', 'PullRequest', 'Release',
|
|
172
|
+
'Approval', 'Policy', 'Risk', 'Evidence',
|
|
173
|
+
] as const;
|
|
174
|
+
|
|
175
|
+
export const ENGINEERING_EDGE_TYPES = [
|
|
176
|
+
'implements', 'depends_on', 'calls', 'imports', 'reads', 'writes', // parcial (DEPENDS_ON/CALLS)
|
|
177
|
+
'defined_by', 'governed_by', 'violates', 'supersedes',
|
|
178
|
+
'generated_by', 'reviewed_by', 'approved_by',
|
|
179
|
+
'tested_by', 'failed_by',
|
|
180
|
+
'changed_by', 'introduced_by', 'fixed_by',
|
|
181
|
+
'affects', 'impacts', 'observed_in', 'deployed_in',
|
|
182
|
+
] as const;
|
|
183
|
+
|
|
184
|
+
// Identidade de agente persistente — hoje AgentIdentity é efêmero (só id/role/autonomy).
|
|
185
|
+
export interface AgentProfile2 extends AuditFields {
|
|
186
|
+
readonly id: EntityId; // forja://agents/<slug>
|
|
187
|
+
readonly role: string;
|
|
188
|
+
readonly provider?: string;
|
|
189
|
+
readonly model?: string;
|
|
190
|
+
readonly capabilities: readonly string[];
|
|
191
|
+
readonly trustLevel: number; // 0-5, derivado por AgentReputationService — nunca setado à mão
|
|
192
|
+
readonly autonomyLevel: 'autonomous' | 'autonomous_with_review' | 'supervised' | 'human_in_the_loop';
|
|
193
|
+
readonly architectureDomains: readonly string[];
|
|
194
|
+
readonly limits?: { readonly maxFiles?: number; readonly maxCostUsd?: number; readonly maxDurationMs?: number };
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
// Regra de Architecture Constitution
|
|
198
|
+
export interface ArchitectureRule {
|
|
199
|
+
readonly id: string;
|
|
200
|
+
readonly source: string; // ex.: 'memory/90-decisions/0042-....md'
|
|
201
|
+
readonly sourceType: 'adr' | 'spec' | 'manual';
|
|
202
|
+
readonly status: 'active' | 'superseded' | 'proposed';
|
|
203
|
+
readonly scope: { readonly paths: readonly string[] };
|
|
204
|
+
readonly constraint: ArchitectureConstraint;
|
|
205
|
+
readonly severity: 'info' | 'low' | 'medium' | 'high' | 'critical';
|
|
206
|
+
readonly rationale: string;
|
|
207
|
+
readonly confidence: number; // 1.0 para regra explícita; < 1.0 só quando sourceType sugere via LLM e AINDA não foi aprovada por humano
|
|
208
|
+
}
|
|
209
|
+
export type ArchitectureConstraint =
|
|
210
|
+
| { readonly kind: 'forbid_import'; readonly patterns: readonly string[] }
|
|
211
|
+
| { readonly kind: 'require_dependency'; readonly symbols: readonly string[] }
|
|
212
|
+
| { readonly kind: 'forbid_dependency'; readonly symbols: readonly string[] };
|
|
213
|
+
|
|
214
|
+
// Risk score — nunca mágico, sempre com fatores nomeados (ver SPEC-035)
|
|
215
|
+
export interface ChangeRiskAssessment {
|
|
216
|
+
readonly score: number; // 0-100
|
|
217
|
+
readonly confidence: number; // 0-1
|
|
218
|
+
readonly factors: readonly { readonly name: string; readonly weight: number; readonly value: number; readonly evidenceIds: readonly EntityId[] }[];
|
|
219
|
+
readonly recommendedControls: readonly string[];
|
|
220
|
+
}
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
Nenhum desses tipos precisa de tabela SQLite nova além do que `adapter-sqlite` já tem para
|
|
224
|
+
`GraphNode`/`GraphEdge`/`Evidence` — `ArchitectureRule` e `ChangeRiskAssessment` são **derivados em
|
|
225
|
+
tempo de leitura** (compilados/computados), não persistidos como fonte de verdade primária; o que
|
|
226
|
+
é persistido é o artefato compilado (`.context/architecture/constitution.json`, versionado em git,
|
|
227
|
+
não em SQLite — decisão explícita, ver §9).
|
|
228
|
+
|
|
229
|
+
## 7. Engineering Graph Model — nós e arestas novos, concretamente
|
|
230
|
+
|
|
231
|
+
Extração determinística (sem LLM) a partir de fontes já lidas hoje pelo `GraphIndexer`:
|
|
232
|
+
|
|
233
|
+
| Documento fonte | Extrator | Nó(s) produzido(s) | Aresta(s) |
|
|
234
|
+
|---|---|---|---|
|
|
235
|
+
| `memory/90-decisions/NNNN-*.md` | já existe (`ADR-\d{4}` regex) — **estender** para ler `## Constraints` como lista determinística | `ADR` (com `status` do frontmatter, hoje ignorado — precisa passar a ler) | `governed_by` do módulo em `scope.paths` para o ADR |
|
|
236
|
+
| `specs/*/spec.md` | novo, mesmo padrão regex (`SPEC-\d{3}`, `## Escopo`) | `SPEC` | `implements` do módulo pra SPEC; `derived_from` da SPEC pro ADR referenciado |
|
|
237
|
+
| `.context/forja-runs.jsonl` / SQLite `runtime_*` | novo — já é dado estruturado, não precisa regex | `Run`, `Agent` (já existe), `Capability` (já existe via `GraphExecutionMemory`) | `generated_by` |
|
|
238
|
+
| `git log` (via `adapter-git`, já usado por `code:sync`) | novo, reaproveita `SpawnCommandRunner` já existente | `Commit` | `changed_by`, `introduced_by` |
|
|
239
|
+
| `test/*.test.js` | já parcial (`describe`/`it`/`test` regex existe) | `Test` (já existe) | `tested_by` |
|
|
240
|
+
|
|
241
|
+
**Importante — nada disso precisa de LLM.** O padrão do `extractDeterministicRelations` já provou
|
|
242
|
+
(código em produção, testado) que regex + parsing estruturado cobre ADR/SPEC/Task/Test/Agent/ADR.
|
|
243
|
+
LLM entra só como **sugestão opcional** de regra ambígua (§8), nunca como fonte de verdade do grafo.
|
|
244
|
+
|
|
245
|
+
## 8. Architecture Constitution — design
|
|
246
|
+
|
|
247
|
+
Pipeline: `memory/90-decisions/*.md` (fonte legível por humano) → parser determinístico de
|
|
248
|
+
`## Constraints` (mesma técnica regex do extrator de grafo) → `ArchitectureRule[]` → compilado em
|
|
249
|
+
`.context/architecture/constitution.json` (versionado em git, revisável em PR como qualquer outro
|
|
250
|
+
artefato gerado — mesmo padrão de `.context/forja-runs.jsonl`).
|
|
251
|
+
|
|
252
|
+
Comandos propostos (nenhum existe ainda — nomenclatura sem prefixo `forja`, ver §12):
|
|
253
|
+
|
|
254
|
+
- `architecture:compile` — ADRs → `constitution.json` (determinístico)
|
|
255
|
+
- `architecture:check` — `constitution.json` vs. CodeGraph vs. código atual
|
|
256
|
+
- `architecture:status` — resumo: N regras ativas, última compilação
|
|
257
|
+
- `architecture:explain <rule-id>` — por que essa regra existe, qual ADR, qual severidade
|
|
258
|
+
|
|
259
|
+
`architecture:compile` **nunca** usa LLM para gerar uma regra `active` diretamente. Fluxo com LLM
|
|
260
|
+
(opcional, Fase 6+): quando um ADR tem `## Constraints` mal-formado ou ambíguo, o parser
|
|
261
|
+
determinístico produz uma regra com `confidence < 1.0` e `status: 'proposed'`; só passa a `active`
|
|
262
|
+
depois de `architecture:approve <rule-id>` (comando proposto, ver §12; reaproveita `ApprovalLedger` — **não** um sistema
|
|
263
|
+
de aprovação paralelo).
|
|
264
|
+
|
|
265
|
+
`architecture:check` reaproveita o mesmo motor de "isso que era verdade parou de ser" que o
|
|
266
|
+
`drift:check` (SPEC-030, em implementação nesta sessão) já constrói — arquitetura é um caso
|
|
267
|
+
particular de drift: a fonte é `constitution.json` em vez de um documento livre, e a comparação é
|
|
268
|
+
contra imports/dependências reais (via `CodeGraph`/`extractDeterministicRelations`, que já produz
|
|
269
|
+
arestas `DEPENDS_ON`) em vez de contra uma relação semântica textual qualquer.
|
|
270
|
+
|
|
271
|
+
## 9. Change Risk Engine — design
|
|
272
|
+
|
|
273
|
+
Fórmula inicial, documentada e com pesos configuráveis (nunca hardcoded sem explicação — pedido
|
|
274
|
+
explícito da visão):
|
|
275
|
+
|
|
276
|
+
```ts
|
|
277
|
+
interface RiskFactor { readonly name: string; readonly weight: number; readonly compute: (input: RiskInput) => number /* 0-1 */; }
|
|
278
|
+
|
|
279
|
+
const DEFAULT_RISK_FACTORS: readonly RiskFactor[] = [
|
|
280
|
+
{ name: 'blast_radius', weight: 0.20, compute: /* GraphLoop.impact(origin).nodes.length, normalizado */ },
|
|
281
|
+
{ name: 'architecture_violations', weight: 0.20, compute: /* count de architecture:check reprovado no diff */ },
|
|
282
|
+
{ name: 'security_sensitivity',weight: 0.15, compute: /* categorias 'secrets'|'database'|'deployment' tocadas, já vocabulário de PolicyCategory */ },
|
|
283
|
+
{ name: 'historical_failure_rate', weight: 0.15, compute: /* EvaluationReport do domínio/capability afetado */ },
|
|
284
|
+
{ name: 'test_confidence', weight: 0.10, compute: /* cobertura de teste dos arquivos afetados, inverso */ },
|
|
285
|
+
{ name: 'reversibility', weight: 0.10, compute: /* migration/schema change = baixa reversibilidade */ },
|
|
286
|
+
{ name: 'deployment_complexity', weight: 0.10, compute: /* número de serviços/apps afetados */ },
|
|
287
|
+
];
|
|
288
|
+
|
|
289
|
+
score = round(100 * Σ(factor.weight * factor.compute(input)))
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
Todo fator carrega `evidenceIds` (nós/arestas do grafo, `Observation`s) — nunca um número solto.
|
|
293
|
+
`confidence` do assessment é a fração de fatores que tiveram dado real disponível (ex.: sem
|
|
294
|
+
histórico de falha nesse domínio ainda → esse fator entra com peso mas confiança reduzida,
|
|
295
|
+
declarado, não escondido).
|
|
296
|
+
|
|
297
|
+
Integração com `PolicyEngine` (§ visão original, Feature 4): **sem** motor de decisão paralelo.
|
|
298
|
+
`RiskLevel` (`'low'|'medium'|'high'|'critical'`) já é o vocabulário do `PolicyRule.scope.risks` e
|
|
299
|
+
de `approvalRequiredRisks` — a mudança é permitir que `PolicyRequest` opcionalmente carregue um
|
|
300
|
+
`riskScore: ChangeRiskAssessment` calculado por `RiskEngine` (interface pequena, injetada, igual
|
|
301
|
+
`request.policy` já é injetado hoje), e que uma regra de política possa referenciar faixas de score
|
|
302
|
+
(`scope.riskScoreRange?: [number, number]`) além de `risks: RiskLevel[]`. As faixas 0-25/26-50/51-
|
|
303
|
+
75/76-100 sugeridas na visão viram os **valores default** de configuração, nunca constantes fixas
|
|
304
|
+
no código — mesmo princípio já usado em `RuntimeLimits`/`PolicyLimits` (default object, sempre
|
|
305
|
+
sobrescrevível).
|
|
306
|
+
|
|
307
|
+
## 10. Engineering Evidence Ledger
|
|
308
|
+
|
|
309
|
+
Não é um sistema novo — é `Evidence`/`AuditRecord` (já existem em `packages/contracts`) mais
|
|
310
|
+
`SqliteAuditStore`/`SqliteObservationStore` (já existem em `packages/adapter-sqlite`), com um
|
|
311
|
+
formato de **exportação** append-only por run (o JSON de exemplo na visão — `run/intent/agent/risk/
|
|
312
|
+
architectureCheck/tests/approvals/commit`) construído a partir de dados que já são gravados hoje em
|
|
313
|
+
tabelas separadas. O trabalho real aqui é uma **view agregada**, não uma nova fonte de dado.
|
|
314
|
+
|
|
315
|
+
## 11. API Contracts (packages/engineering)
|
|
316
|
+
|
|
317
|
+
```ts
|
|
318
|
+
// packages/engineering/architecture/src/index.ts
|
|
319
|
+
export interface ArchitectureEngine {
|
|
320
|
+
compile(sources: { adrs: readonly string[]; specs: readonly string[] }): readonly ArchitectureRule[];
|
|
321
|
+
check(rules: readonly ArchitectureRule[], graph: GraphLoop): ArchitectureCheckReport;
|
|
322
|
+
explain(ruleId: string, rules: readonly ArchitectureRule[]): ArchitectureRuleExplanation;
|
|
323
|
+
}
|
|
324
|
+
|
|
325
|
+
// packages/engineering/risk/src/index.ts
|
|
326
|
+
export interface RiskEngine {
|
|
327
|
+
assess(input: RiskInput): ChangeRiskAssessment;
|
|
328
|
+
}
|
|
329
|
+
// Consumido opcionalmente por PolicyEngine via uma interface local pequena — PolicyEngine não
|
|
330
|
+
// importa @forja/engineering-risk, só uma interface estrutural (mesmo padrão de CapabilityPolicy
|
|
331
|
+
// hoje: PolicyEngine satisfaz a interface por forma, não por import direto).
|
|
332
|
+
|
|
333
|
+
// packages/engineering/provenance/src/index.ts
|
|
334
|
+
export interface ProvenanceEngine {
|
|
335
|
+
recordGeneration(input: { readonly files: readonly string[]; readonly lines?: readonly [number, number][]; readonly runId: RunId; readonly agentId: EntityId }): void;
|
|
336
|
+
blame(file: string, lineRange?: readonly [number, number]): readonly ProvenanceRecord[];
|
|
337
|
+
}
|
|
338
|
+
|
|
339
|
+
// packages/engineering/identity/src/index.ts
|
|
340
|
+
export interface AgentIdentityService { register(profile: AgentProfileInput): AgentProfile2; get(id: EntityId): AgentProfile2 | undefined; }
|
|
341
|
+
export interface AgentReputationService { score(agentId: EntityId, domain?: string): AgentReputationScore; }
|
|
342
|
+
```
|
|
343
|
+
|
|
344
|
+
Cada um é **puro domínio** (sem `fs`/`spawnSync`/rede) — os adapters (`apps/cli`, `packages/mcp`,
|
|
345
|
+
`apps/server`) é que ligam a fontes reais (arquivos ADR, git log, SQLite).
|
|
346
|
+
|
|
347
|
+
## 12. CLI Plan
|
|
348
|
+
|
|
349
|
+
Sem explosão de comandos — agrupado por domínio, uma façade principal (`engineer`) por cima do
|
|
350
|
+
resto. **Nenhum comando abaixo existe ainda** — esta é a superfície proposta para os Sprints 1-3;
|
|
351
|
+
por isso a tabela usa nome do comando sem o prefixo `forja`/`npm run` (convenção deste repositório
|
|
352
|
+
para citação de comando *proposto*, não real — ver `lib/core/doc-graph.ts`, `DOC_SURFACES`: `docs/`
|
|
353
|
+
é superfície que orienta o agente *agora*, então só cita comando que já existe no registry;
|
|
354
|
+
comando proposto pertence à spec que o define, referenciada na coluna "Spec").
|
|
355
|
+
|
|
356
|
+
| Domínio | Comando proposto | Spec |
|
|
357
|
+
|---|---|---|
|
|
358
|
+
| Façade | `engineer "<objetivo>"` — compõe tudo abaixo | SPEC-035 |
|
|
359
|
+
| Arquitetura | `architecture:compile` / `:check` / `:status` / `:explain <rule-id>` / `:approve <rule-id>` | SPEC-033 |
|
|
360
|
+
| Risco | `risk:assess "<mudança>"` / `:explain <assessment-id>` | SPEC-034 |
|
|
361
|
+
| ADR | `adr:list` / `:show <id>` / `:impact <id>` / `:graph` | SPEC-032 |
|
|
362
|
+
| Agente | `agent:list` / `:show` / `:score` / `:history` | Fase 3 (fora desta spec master) |
|
|
363
|
+
| Proveniência | `provenance:blame <arquivo>` / `:generate` (AI-SBOM) | Fase 5 (fora desta spec master) |
|
|
364
|
+
| Outros | `simulate "<mudança>"`, `explain <alvo>`, `timeline` | Fases 4/2 (fora desta spec master) |
|
|
365
|
+
|
|
366
|
+
`eval:*`, `route`, `learn:*`, `watch` ficam para Fases 3/6/7 — não fazem parte da primeira entrega
|
|
367
|
+
de comandos (P0).
|
|
368
|
+
|
|
369
|
+
## 13. Events
|
|
370
|
+
|
|
371
|
+
Novos eventos no `EventBus` já existente (`packages/events`), sem barramento paralelo:
|
|
372
|
+
|
|
373
|
+
```text
|
|
374
|
+
architecture.compiled architecture.violation_detected
|
|
375
|
+
change.risk_assessed
|
|
376
|
+
agent.identity_registered agent.reputation_updated
|
|
377
|
+
provenance.recorded
|
|
378
|
+
simulation.completed
|
|
379
|
+
incident.detected learning.proposed
|
|
380
|
+
```
|
|
381
|
+
|
|
382
|
+
## 14. Persistence
|
|
383
|
+
|
|
384
|
+
SQLite local-first, como todo o resto do framework. `constitution.json` é a única exceção
|
|
385
|
+
deliberada (artefato versionado em git, não em SQLite) — mesma categoria de `.context/forja-runs.jsonl`:
|
|
386
|
+
precisa ser revisável em PR por humano, não só consultável por comando.
|
|
387
|
+
|
|
388
|
+
## 15. Security
|
|
389
|
+
|
|
390
|
+
Segue os princípios já estabelecidos e reforçados pela auditoria de 2026-08-31: local-first,
|
|
391
|
+
fail-closed em ambiguidade, LLM nunca é fonte de verdade para segurança crítica (Constitution:
|
|
392
|
+
regra `active` só de parser determinístico ou aprovação humana explícita — nunca de sugestão de
|
|
393
|
+
LLM direto).
|
|
394
|
+
|
|
395
|
+
## 16. Policy Integration
|
|
396
|
+
|
|
397
|
+
Detalhado em §9. Resumo: `RiskEngine` é consumido por `PolicyEngine`, nunca o substitui.
|
|
398
|
+
|
|
399
|
+
## 17. Migration Strategy / Compatibility
|
|
400
|
+
|
|
401
|
+
Toda extensão de contrato é aditiva (campos opcionais). Nenhum comando existente muda de
|
|
402
|
+
comportamento. `ENGINEERING_NODE_TYPES`/`ENGINEERING_EDGE_TYPES` são vocabulário adicional sobre o
|
|
403
|
+
`type: string` já livre de `GraphNode`/`GraphEdge` — zero migração de dado existente necessária.
|
|
404
|
+
|
|
405
|
+
## 18. Test Strategy
|
|
406
|
+
|
|
407
|
+
Mesmo padrão do resto do repo: `node --test`, sem mocking framework, fixtures de fake
|
|
408
|
+
store/backend (ver `test/sandbox.test.js` para o padrão de referência). `ArchitectureEngine`/
|
|
409
|
+
`RiskEngine` são puros — testáveis sem I/O. Testes negativos obrigatórios para: regra de
|
|
410
|
+
Constitution mal-formada, risco com fator sem dado (confidence reduzida, não erro), Constitution
|
|
411
|
+
compilada de ADR sem `## Constraints` (vazio, não crash).
|
|
412
|
+
|
|
413
|
+
## 19. Release Plan
|
|
414
|
+
|
|
415
|
+
Ver `specs/engineering-intelligence/plan.md` para o detalhamento em sprints — resumo:
|
|
416
|
+
|
|
417
|
+
- **Sprint 1**: `packages/engineering/architecture` (Constitution compile/check/explain) +
|
|
418
|
+
extração de `ADR`/`SPEC` no grafo.
|
|
419
|
+
- **Sprint 2**: `packages/engineering/risk` (RiskEngine) + integração `PolicyEngine`.
|
|
420
|
+
- **Sprint 3**: Evidence Ledger (view agregada) + `forja engineer` (façade mínima, sem routing/
|
|
421
|
+
identity ainda).
|
|
422
|
+
- Fases 2-7 da visão original ficam para specs subsequentes, quebradas quando Sprint 1-3 estiver
|
|
423
|
+
em produção e puder informar as decisões de design das fases seguintes (Agent Identity, em
|
|
424
|
+
particular, se beneficia de já ter dados reais de `RiskEngine`/`ArchitectureEngine` rodando).
|
|
425
|
+
|
|
426
|
+
## 20. Riscos
|
|
427
|
+
|
|
428
|
+
| Risco | Mitigação |
|
|
429
|
+
|---|---|
|
|
430
|
+
| `packages/engineering` virar um monólito acoplado | Sub-diretórios com fronteira de interface clara desde o dia 1 (§4); nenhum dos quatro importa os outros três diretamente |
|
|
431
|
+
| Risk score "mágico" sem explicação | Fórmula documentada em código E neste doc (§9); todo `ChangeRiskAssessment` carrega `factors[]` com `evidenceIds` |
|
|
432
|
+
| Architecture Constitution virar fonte de falso-positivo (ruído) | Reaproveita a mesma mitigação já desenhada para drift-sentinel: comparação por relação semântica (import/depend), não por hash de texto |
|
|
433
|
+
| Confundir sugestão de LLM com regra ativa | `confidence`/`status: 'proposed'` obrigatórios em qualquer regra não-determinística; `active` só por parser ou aprovação humana |
|
|
434
|
+
|
|
435
|
+
## 21. Open Questions
|
|
436
|
+
|
|
437
|
+
1. `AgentProfile2` é um nome provisório — o contrato final substitui ou convive com
|
|
438
|
+
`AgentIdentity` atual? (Decisão de ADR-0078, marcada como aberta até Sprint 3.)
|
|
439
|
+
2. `constitution.json` versionado em git — e se dois branches compilarem regras conflitantes?
|
|
440
|
+
Fica para o design de `architecture:compile` (Sprint 1), não bloqueia a arquitetura geral.
|
|
441
|
+
3. Onde mora o limite entre "Change Risk Engine" e "Policy Engine" quando os dois crescerem —
|
|
442
|
+
revisar depois que `RiskEngine` tiver uso real (Sprint 2 retro).
|