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,92 @@
|
|
|
1
|
+
# Plan: Engineering Graph extensions (ADR/SPEC como nós de primeira classe)
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-09-01
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem técnica
|
|
8
|
+
|
|
9
|
+
Estender `extractDeterministicRelations` (packages/graph) para ler o campo `Status` de ADR e de
|
|
10
|
+
Spec como propriedade dedicada (não `GraphNode.status`/`KnowledgeStatus` — ver AC-1, é um
|
|
11
|
+
vocabulário de domínio diferente). `GraphNodeSpec`/`GraphNode` (packages/contracts) ganham um campo
|
|
12
|
+
opcional `documentStatus?: string` — extensão aditiva, mesmo padrão já usado nesta mesma janela de
|
|
13
|
+
trabalho para `PolicyLimits.maxCostUsd`/`isPathWithinRoot`/`remoteAddress` em `HttpRequest`: nenhum
|
|
14
|
+
consumidor existente quebra, campo ausente = comportamento idêntico ao de hoje.
|
|
15
|
+
|
|
16
|
+
`adr:list`/`adr:show`/`adr:impact`/`adr:graph` são scripts novos (`scripts/adr.ts`), mesmo padrão
|
|
17
|
+
de `scripts/drift-check.ts`: comando de processo, não capability registrada — não escreve em
|
|
18
|
+
projeto, só lê o grafo.
|
|
19
|
+
|
|
20
|
+
## 2. Módulos afetados
|
|
21
|
+
|
|
22
|
+
| Caminho | Mudança | Risco |
|
|
23
|
+
|---|---|---|
|
|
24
|
+
| `packages/graph/src/index.ts` | `extractDeterministicRelations`: ler `- **Status**: <valor>` de ADR e `- **Status**: <valor>` de spec.md, embutir no label do nó | Baixo — aditivo, mesma função já testada |
|
|
25
|
+
| `scripts/adr.ts` | novo — `adr:list`/`adr:show`/`adr:impact`/`adr:graph` | Baixo — só leitura |
|
|
26
|
+
| `lib/core/registry.ts` | registrar os 4 comandos novos | Baixo |
|
|
27
|
+
| `test/graph.test.js` | testes para status de ADR/SPEC no extrator | — |
|
|
28
|
+
| `test/adr-cli.test.js` (novo) | testes de CLI para os 4 comandos | — |
|
|
29
|
+
|
|
30
|
+
## 3. Diagrama de fluxo
|
|
31
|
+
|
|
32
|
+
```text
|
|
33
|
+
memory/90-decisions/*.md ──┐
|
|
34
|
+
specs/*/spec.md ─┼─► extractDeterministicRelations (estendido)
|
|
35
|
+
│ │
|
|
36
|
+
│ ▼
|
|
37
|
+
│ GraphLoop.apply (existente, sem mudança)
|
|
38
|
+
│
|
|
39
|
+
▼
|
|
40
|
+
scripts/adr.ts (list/show/impact/graph)
|
|
41
|
+
│
|
|
42
|
+
▼
|
|
43
|
+
GraphLoop.query()/impact() (existente, sem mudança)
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## 4. Contratos (API/CLI/Schema)
|
|
47
|
+
|
|
48
|
+
```ts
|
|
49
|
+
// packages/contracts/src/index.ts (aditivo)
|
|
50
|
+
export interface GraphNode extends AuditFields {
|
|
51
|
+
// ...campos existentes inalterados...
|
|
52
|
+
readonly documentStatus?: string; // 'accepted'|'proposed'|'superseded'|'deprecated'|'rejected' (ADR) ou 'draft'|'review'|'approved'|'implementing'|'done'|'abandoned' (SPEC) — vocabulário do documento, não confundir com KnowledgeStatus
|
|
53
|
+
}
|
|
54
|
+
export interface GraphNodeSpec {
|
|
55
|
+
// ...campos existentes inalterados...
|
|
56
|
+
readonly documentStatus?: string;
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
adr:list # lista ADRs com status
|
|
62
|
+
adr:show <id> # mostra uma ADR: status, arquivo, resumo de constraints (se houver)
|
|
63
|
+
adr:impact <id> # usa GraphLoop.impact() — nós/arestas alcançáveis
|
|
64
|
+
adr:graph # exporta subgrafo (JSON) de nós ADR/SPEC + vizinhança
|
|
65
|
+
```
|
|
66
|
+
(sem prefixo `forja`/`npm run` aqui — comandos ainda não existem; ver convenção já usada em
|
|
67
|
+
`docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md`)
|
|
68
|
+
|
|
69
|
+
## 5. Decisões e alternativas
|
|
70
|
+
|
|
71
|
+
**D1**: `documentStatus?: string` como campo novo, aditivo, em `GraphNode`/`GraphNodeSpec`.
|
|
72
|
+
Alternativa rejeitada: usar `GraphNode.status` (`KnowledgeStatus`) — explicitamente proibido pela
|
|
73
|
+
spec (AC-1), mistura o ciclo de vida do documento com a epistemologia da aresta. Alternativa
|
|
74
|
+
descartada: embutir no `label` (string) — mais frágil (parse reverso, título com separador
|
|
75
|
+
colidindo) sem nenhuma economia real, já que extensão aditiva de contrato é o padrão já em uso
|
|
76
|
+
nesta mesma janela de trabalho para casos equivalentes.
|
|
77
|
+
|
|
78
|
+
## 6. Dependências
|
|
79
|
+
|
|
80
|
+
- Nenhuma spec bloqueadora. `packages/graph`, `scripts/`, `lib/core/registry.ts` já existentes.
|
|
81
|
+
|
|
82
|
+
## 7. Rollout
|
|
83
|
+
|
|
84
|
+
- [ ] Feature flag necessária? Não — leitura pura, sem side effect em projeto consumidor.
|
|
85
|
+
- [ ] Migração de dados existentes? Não — próxima reindexação (`code:sync`/`drift:check`) já
|
|
86
|
+
popula o status ao reprocessar os documentos.
|
|
87
|
+
- [ ] Doc/persona impactada? `docs/architecture/`, README (comandos novos).
|
|
88
|
+
|
|
89
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
90
|
+
|
|
91
|
+
Se o parse de `label` para extrair status de volta (D1) se mostrar frágil (ADRs com título contendo
|
|
92
|
+
" · ") isso é motivo para promover à alternativa (b) do D1 antes de expandir mais consumidores.
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# Spec: Engineering Graph extensions (ADR/SPEC como nós de primeira classe)
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-032
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprint 1 (ver `../engineering-intelligence/plan.md`)
|
|
8
|
+
- **ADRs relacionadas**: ADR-0078; nenhuma ADR própria esperada — extensão aditiva de vocabulário
|
|
9
|
+
sobre `GraphNode.type`/`GraphEdge.type`, que já são `string` livre em `packages/contracts`.
|
|
10
|
+
|
|
11
|
+
## 1. Problema
|
|
12
|
+
|
|
13
|
+
`extractDeterministicRelations` já cria nós `ADR` a partir do padrão `ADR-\d{4}` encontrado em
|
|
14
|
+
texto, mas trata isso como uma referência solta (uma aresta `DERIVED_FROM` para um nó `ADR` sem
|
|
15
|
+
metadado) — não lê o `## Status` do próprio arquivo de ADR, não sabe se está `accepted`,
|
|
16
|
+
`superseded` ou `deprecated`, e não faz o mesmo para `SPEC-\d{3}`. Sem isso, perguntas como
|
|
17
|
+
"quais componentes uma ADR supersedida ainda governa" não têm resposta estruturada.
|
|
18
|
+
|
|
19
|
+
## 2. Proposta de valor
|
|
20
|
+
|
|
21
|
+
ADRs e Specs passam a ser nós completos do grafo (com status, não só uma referência textual),
|
|
22
|
+
consultáveis via `adr:impact`/`adr:graph` e usados como insumo real do Change Risk Engine
|
|
23
|
+
(SPEC-034) e do Architecture Constitution (SPEC-033).
|
|
24
|
+
|
|
25
|
+
## 3. User stories
|
|
26
|
+
|
|
27
|
+
- **Como** sdd-architect, **quero** `forja adr:impact 0027` mostrando componentes/specs/testes
|
|
28
|
+
afetados, **para que** eu saiba o raio de explosão antes de superseder uma decisão.
|
|
29
|
+
- **Como** governance, **quero** saber que uma ADR está `superseded` sem precisar abrir o arquivo,
|
|
30
|
+
**para que** `architecture:check` não valide contra uma regra morta.
|
|
31
|
+
|
|
32
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
33
|
+
|
|
34
|
+
- [x] AC-1: extensão de `extractDeterministicRelations` (ou uma função irmã dedicada, decisão de
|
|
35
|
+
implementação) lê `- **Status**: <valor>` do frontmatter de ADR (já no formato existente,
|
|
36
|
+
`memory/90-decisions/_template.md`) e do campo `Status` de spec.md (`_templates/spec.md`), e
|
|
37
|
+
grava como propriedade do nó — decisão de implementação: usar `GraphNode.status`
|
|
38
|
+
(`KnowledgeStatus`) é a tentação óbvia mas **errada** (status de ADR — accepted/proposed/
|
|
39
|
+
superseded/deprecated/rejected — é um conceito de domínio diferente de
|
|
40
|
+
verified/inferred/hypothesis/contradicted/unknown, que descreve confiança epistêmica da
|
|
41
|
+
*aresta*, não o ciclo de vida do documento); a spec desta feature deve decidir isso
|
|
42
|
+
explicitamente no `plan.md`, não misturar os dois vocabulários.
|
|
43
|
+
- [x] AC-2: `forja adr:list`/`adr:show <id>` funcionam sobre `memory/90-decisions/` real deste
|
|
44
|
+
repositório.
|
|
45
|
+
- [x] AC-3: `forja adr:impact <id>` usa `GraphLoop.impact()` (já existente, sem reimplementar BFS)
|
|
46
|
+
para listar nós/arestas alcançáveis a partir do nó ADR.
|
|
47
|
+
- [x] AC-4: `forja adr:graph` exporta um subgrafo (JSON) navegável — sem visualização nesta spec
|
|
48
|
+
(Fase posterior, dashboard é consumidor per princípio da visão original).
|
|
49
|
+
- [x] AC-5: mesmo tratamento para `SPEC-\d{3}` (nó `SPEC`, status do template já existente:
|
|
50
|
+
draft/review/approved/implementing/done/abandoned).
|
|
51
|
+
|
|
52
|
+
**Nota de implementação (achado real, fora de escopo desta spec)**: rodar `adr:list`/`show`/
|
|
53
|
+
`impact` contra o repositório real (1014 arquivos rastreados) travou por dezenas de minutos neste
|
|
54
|
+
ambiente — não é bug de lógica (uma fixture isolada com 2 documentos passa em <1s, ver
|
|
55
|
+
`test/adr-cli.test.js`) nem específico deste comando: `GitGraphDocumentSource.listDocuments()` é
|
|
56
|
+
rápido (1 subprocesso `git ls-files` + leitura síncrona de arquivo), mas
|
|
57
|
+
`SqliteGraphStore.saveNode`/`saveEdge`/`saveEvidence` (packages/adapter-sqlite) fazem um `INSERT`
|
|
58
|
+
individual por chamada, sem transação — para ~1000 documentos com múltiplas relações cada, isso é
|
|
59
|
+
plausivelmente dezenas de milhares de writes SQLite não agrupados, cada um com custo de fsync.
|
|
60
|
+
Mesmo padrão usado por `drift:check`/`graph:sync` — não é regressão desta spec, mas um achado real
|
|
61
|
+
que vale uma spec própria de performance (`GraphLoop.apply()` já processa uma `GraphMutation`
|
|
62
|
+
inteira por documento; agrupar os saves de uma mutation numa única transação SQLite é o candidato
|
|
63
|
+
óbvio, não implementado aqui por estar fora do escopo declarado em §5).
|
|
64
|
+
|
|
65
|
+
**Corrigido posteriormente**: `GraphStore` ganhou um método opcional `transaction<T>(fn: () => T):
|
|
66
|
+
T`; `GraphLoop.transaction()` delega pra ele (cai pra só `fn()` quando o store não suporta, ex.
|
|
67
|
+
`InMemoryGraphStore`); `SqliteGraphStore.transaction` implementa com `BEGIN`/`COMMIT`/`ROLLBACK`
|
|
68
|
+
reais (testado, incluindo reversão de fato em erro — `test/adapter-sqlite.test.js`).
|
|
69
|
+
`GraphIndexer.sync()` agora envolve o loop inteiro de `apply()` numa única transação. Medido contra
|
|
70
|
+
este próprio repositório (`adr:list`, mesma máquina, antes/depois via `git stash`): 7,65s → 2,75s,
|
|
71
|
+
tempo de sistema (I/O) caindo de ~3s pra ~0,08s — confirma a causa (fsync por `INSERT`), não só a
|
|
72
|
+
teoria.
|
|
73
|
+
|
|
74
|
+
## 5. Escopo
|
|
75
|
+
|
|
76
|
+
**Dentro**: extração determinística de status de ADR/SPEC; `adr:list`/`adr:show`/`adr:impact`/
|
|
77
|
+
`adr:graph`; nenhuma mudança em `KnowledgeStatus` (contrato existente intocado).
|
|
78
|
+
|
|
79
|
+
**Fora**: visualização gráfica (Fase posterior); extração de `Requirement`/`BusinessRule` como
|
|
80
|
+
nós (a visão original pede, mas este repositório-framework não tem uma fonte de requisitos de
|
|
81
|
+
produto estruturada hoje — fica para quando um projeto consumidor real tiver essa fonte,
|
|
82
|
+
provavelmente via `docs/produto/`); `PullRequest`/`Commit`/`Release` como nós (SPEC-035/Provenance,
|
|
83
|
+
fase seguinte).
|
|
84
|
+
|
|
85
|
+
## 6. NFRs / restrições
|
|
86
|
+
|
|
87
|
+
- Determinístico, sem LLM (mesmo padrão do extrator já existente).
|
|
88
|
+
- Não quebra `extractDeterministicRelations` existente — testes atuais (`test/graph.test.js`)
|
|
89
|
+
continuam passando sem alteração de comportamento para os tipos de nó já existentes.
|
|
90
|
+
|
|
91
|
+
## 7. Riscos e mitigação
|
|
92
|
+
|
|
93
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
94
|
+
|---|---|---|---|
|
|
95
|
+
| Confundir status de documento com `KnowledgeStatus` de epistemologia da aresta | Média (é a armadilha óbvia) | Média (contamina semântica do grafo inteiro) | AC-1 marca a decisão como obrigatória e explícita no plan.md, não implícita no código |
|
|
96
|
+
| `adr:impact` ficar lento em grafos grandes | Baixa neste repositório (~78 ADRs hoje) | Baixa | `GraphLoop.impact()` já tem parâmetro `depth`; reaproveitar, não implementar limite novo |
|
|
97
|
+
|
|
98
|
+
## 8. Métricas de sucesso
|
|
99
|
+
|
|
100
|
+
`forja adr:impact 0020` (core/registry, uma das ADRs mais referenciadas do repositório) retorna um
|
|
101
|
+
conjunto de componentes que um mantenedor confirma como correto, sem falso-negativo óbvio.
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Tasks: Engineering Graph extensions
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## T1 — `documentStatus` no contrato de grafo
|
|
11
|
+
- **Owner**: worker
|
|
12
|
+
- **Estimativa**: P
|
|
13
|
+
- **Depende de**: —
|
|
14
|
+
- **Paths**: `packages/contracts/src/index.ts`
|
|
15
|
+
- **Done quando**:
|
|
16
|
+
- [ ] `GraphNode`/`GraphNodeSpec` ganham `documentStatus?: string`
|
|
17
|
+
- [ ] `npx tsc --noEmit` limpo
|
|
18
|
+
- [ ] nenhum teste existente quebra (campo opcional)
|
|
19
|
+
|
|
20
|
+
## T2 — extrator lê status de ADR e de SPEC
|
|
21
|
+
- **Owner**: worker
|
|
22
|
+
- **Estimativa**: M
|
|
23
|
+
- **Depende de**: T1
|
|
24
|
+
- **Paths**: `packages/graph/src/index.ts`
|
|
25
|
+
- **Done quando**:
|
|
26
|
+
- [ ] `extractDeterministicRelations` popula `documentStatus` do nó ADR a partir de
|
|
27
|
+
`- **Status**: <valor>` no corpo do documento (formato de `memory/90-decisions/_template.md`)
|
|
28
|
+
- [ ] mesmo tratamento para nó `SPEC` a partir do campo `Status` de `specs/_templates/spec.md`
|
|
29
|
+
- [ ] testes em `test/graph.test.js` cobrindo ADR com/sem status e SPEC com/sem status
|
|
30
|
+
- [ ] testes passando
|
|
31
|
+
|
|
32
|
+
## T3 — `scripts/adr.ts`: list/show/impact/graph
|
|
33
|
+
- **Owner**: worker
|
|
34
|
+
- **Estimativa**: M
|
|
35
|
+
- **Depende de**: T2
|
|
36
|
+
- **Paths**: `scripts/adr.ts`, `lib/core/registry.ts`
|
|
37
|
+
- **Done quando**:
|
|
38
|
+
- [ ] `adr:list` lista ADRs reais de `memory/90-decisions/` com status
|
|
39
|
+
- [ ] `adr:show <id>` mostra status, arquivo, e (se houver) o texto de `## Constraints`
|
|
40
|
+
- [ ] `adr:impact <id>` usa `GraphLoop.impact()` já existente, sem reimplementar BFS
|
|
41
|
+
- [ ] `adr:graph` exporta subgrafo JSON de nós ADR/SPEC + vizinhança direta
|
|
42
|
+
- [ ] `forja tools:doctor` (`docs-commands`/`commands-documented`) continua verde após os
|
|
43
|
+
comandos novos serem documentados no README
|
|
44
|
+
|
|
45
|
+
## T4 — testes de CLI + integração com `code:sync`
|
|
46
|
+
- **Owner**: worker
|
|
47
|
+
- **Estimativa**: P
|
|
48
|
+
- **Depende de**: T3
|
|
49
|
+
- **Paths**: `test/adr-cli.test.js` (novo)
|
|
50
|
+
- **Done quando**:
|
|
51
|
+
- [ ] `adr:impact 0020` (ADR real deste repositório) retorna componentes plausíveis
|
|
52
|
+
- [ ] `npm test` verde, `npx tsc --noEmit` limpo
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## Handoffs entre agentes
|
|
57
|
+
|
|
58
|
+
T1→T2→T3→T4 é sequencial (cada uma consome o contrato/dado da anterior); sem handoff de papel
|
|
59
|
+
(tudo cai em `worker`, sem etapa própria de product/architect — spec e plan já aprovados cobrem
|
|
60
|
+
essa decisão).
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
# Spec: Engineering Intelligence / Engineering Twin (master)
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-031
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprints 1-3 (fundação); fases seguintes ficam em specs próprias
|
|
8
|
+
- **ADRs relacionadas**: [ADR-0078](../../memory/90-decisions/0078-forjajs-3-engineering-control-plane.md)
|
|
9
|
+
|
|
10
|
+
> **Spec master.** Não é implementada diretamente — decompõe em
|
|
11
|
+
> [SPEC-032](../engineering-graph-extensions/spec.md) (Engineering Graph),
|
|
12
|
+
> [SPEC-033](../architecture-constitution/spec.md) (Architecture Constitution + drift),
|
|
13
|
+
> [SPEC-034](../change-risk-engine/spec.md) (Change Risk Engine) e
|
|
14
|
+
> [SPEC-035](../engineering-evidence-ledger/spec.md) (Evidence Ledger + façade `forja engineer`).
|
|
15
|
+
> Ver [`docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md`](../../docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md)
|
|
16
|
+
> para a auditoria completa, gap analysis e desenho técnico que fundamentam esta spec.
|
|
17
|
+
|
|
18
|
+
## 1. Problema
|
|
19
|
+
|
|
20
|
+
A Forja hoje orquestra *como* agentes de IA trabalham (processo, memória, aprovação, sandbox) mas
|
|
21
|
+
não entende *por que* o software que eles produzem existe, *se* o que produzem respeita a
|
|
22
|
+
arquitetura pretendida, *qual o risco* de uma mudança antes de ela acontecer, nem *quem/o quê*
|
|
23
|
+
produziu cada linha depois do fato. Essas perguntas hoje só têm resposta manual — um humano lendo
|
|
24
|
+
ADRs, olhando `git blame`, adivinhando risco. Para operar com autonomia supervisionada em escala
|
|
25
|
+
(múltiplos agentes, múltiplos projetos), essas respostas precisam ser estruturadas, auditáveis e
|
|
26
|
+
consultáveis por comando — não tribais.
|
|
27
|
+
|
|
28
|
+
## 2. Proposta de valor
|
|
29
|
+
|
|
30
|
+
A Forja passa a responder, de forma estruturada e com evidência: por que um código existe (SPEC/ADR
|
|
31
|
+
de origem), se uma mudança viola a arquitetura pretendida, qual o risco de uma mudança antes dela
|
|
32
|
+
acontecer, e quem/o quê a produziu. **GitHub guarda o código. A Forja guarda a engenharia.**
|
|
33
|
+
|
|
34
|
+
## 3. User stories
|
|
35
|
+
|
|
36
|
+
- **Como** sdd-architect, **quero** que uma decisão registrada em ADR vire uma regra que o sistema
|
|
37
|
+
verifica sozinho, **para que** "arquitetura documentada" e "arquitetura em vigor" nunca divirjam
|
|
38
|
+
em silêncio.
|
|
39
|
+
- **Como** governance, **quero** um score de risco explicável (não uma caixa-preta) antes de uma
|
|
40
|
+
mudança grande, **para que** eu saiba quando exigir revisão humana em vez de deixar autonomia
|
|
41
|
+
supervisionada seguir sozinha.
|
|
42
|
+
- **Como** desenvolvedor/consultor operando múltiplos projetos, **quero** uma única pergunta
|
|
43
|
+
(`forja engineer "<objetivo>"`) que já traga arquitetura, risco, ADRs relevantes e fluxo
|
|
44
|
+
recomendado, **para que** eu não precise consultar cinco comandos manualmente antes de começar.
|
|
45
|
+
|
|
46
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
47
|
+
|
|
48
|
+
- [x] AC-1: Engineering Graph (SPEC-032) extrai `ADR`/`SPEC` como nós de primeira classe, com
|
|
49
|
+
`status`/`documentStatus` e arestas `DERIVED_FROM`, **sem LLM** (extensão de
|
|
50
|
+
`extractDeterministicRelations`, mesmo padrão determinístico já existente).
|
|
51
|
+
- [x] AC-2: `forja architecture:compile`/`architecture:check`/`architecture:explain` (SPEC-033)
|
|
52
|
+
funcionam sobre pelo menos um ADR real deste repositório com `## Constraints` — validado
|
|
53
|
+
contra ADR-0078.
|
|
54
|
+
- [x] AC-3: `forja risk:assess [ref]` (SPEC-034) produz um score 0-100 com fatores nomeados e
|
|
55
|
+
`evidenceIds` — nunca um número sem explicação. (`[ref]`, não `"<mudança>"` livre — D1 de
|
|
56
|
+
`specs/change-risk-engine/plan.md`: um git ref é verificável, prosa livre exigiria parsing.)
|
|
57
|
+
- [x] AC-4: Risk assessment é **opcionalmente** consumível por `PolicyEngine` via
|
|
58
|
+
`PolicyScope.riskScoreRange`/`PolicyRequest.riskScore` (um `number`, não o assessment
|
|
59
|
+
inteiro) — `packages/policy` nunca importa `@forja/engineering-risk`.
|
|
60
|
+
- [x] AC-5: Evidence Ledger (SPEC-035) produz uma view agregada por run a partir de dados já
|
|
61
|
+
persistidos (`AuditRecord`/`ApprovalRequest`/`RuntimeRun`), sem nova fonte de verdade
|
|
62
|
+
primária.
|
|
63
|
+
- [x] AC-6 (revisado — ver nota): `forja engineer "<objetivo>"` compõe `ContextEngine` +
|
|
64
|
+
`GraphLoop` (ADRs/SPECs relevantes) + `architecture:check` + `RiskEngine` + fluxo
|
|
65
|
+
recomendado, sem reimplementar nenhum. **Não** compõe `DeterministicPlanner`/`PolicyEngine`
|
|
66
|
+
como o texto original desta AC previa — decisão registrada em
|
|
67
|
+
`specs/engineering-evidence-ledger/plan.md` D1: `forja engineer` roda **antes** de existir
|
|
68
|
+
um diff (orienta o início do trabalho), e tanto planejamento quanto decisão de política
|
|
69
|
+
exigem um plano/capability concretos que ainda não existem nesse momento. Compor os dois
|
|
70
|
+
"porque a AC pedia" teria sido invenção, não composição real — proibido por AC-3 de
|
|
71
|
+
SPEC-035.
|
|
72
|
+
- [x] AC-7: nenhum comando existente mudou de assinatura ou comportamento; toda extensão de
|
|
73
|
+
contrato (`documentStatus`, `riskScoreRange`/`riskScore`) foi aditiva — confirmado por
|
|
74
|
+
`npx tsc --noEmit` limpo e pela suíte de testes pré-existente intacta em cada PR.
|
|
75
|
+
|
|
76
|
+
## 5. Escopo
|
|
77
|
+
|
|
78
|
+
**Dentro** (Sprints 1-3, esta spec master):
|
|
79
|
+
- Engineering Graph: vocabulário de nós/arestas de engenharia + extratores determinísticos para
|
|
80
|
+
ADR/SPEC.
|
|
81
|
+
- Architecture Constitution: compile/check/explain, reaproveitando o motor de drift já em
|
|
82
|
+
construção em `specs/drift-sentinel`.
|
|
83
|
+
- Change Risk Engine: fórmula documentada, fatores configuráveis, integração opcional com Policy.
|
|
84
|
+
- Evidence Ledger: view agregada por run.
|
|
85
|
+
- Façade `forja engineer` (versão mínima: contexto + arquitetura + risco + ADRs relevantes +
|
|
86
|
+
fluxo recomendado — **sem** roteamento de agente/seleção de time, que depende de Agent
|
|
87
|
+
Identity/Reputation, fora de escopo aqui).
|
|
88
|
+
|
|
89
|
+
**Fora** (fases seguintes, cada uma com spec própria quando chegar a vez — ver
|
|
90
|
+
`plan.md` desta spec para a ordem):
|
|
91
|
+
- Agent Identity / Agent Reputation / Project Evals / Smart Routing (Fase 3 da visão original).
|
|
92
|
+
- Predictive Change Simulation (Fase 4).
|
|
93
|
+
- AI Code Provenance / `forja blame` / AI-SBOM (Fase 5).
|
|
94
|
+
- Agent Runtime Monitoring / Behavior Anomaly Engine (Fase 5).
|
|
95
|
+
- Learning Loop / Incident → Knowledge / Cross-project Intelligence (Fase 6).
|
|
96
|
+
- Autonomous Maintenance (Fase 7) — só arquitetura preparatória, nunca habilitação automática.
|
|
97
|
+
- Dashboard/visualização do Engineering Graph — core primeiro, UI depois, por princípio explícito
|
|
98
|
+
da visão recebida.
|
|
99
|
+
|
|
100
|
+
## 6. NFRs / restrições
|
|
101
|
+
|
|
102
|
+
- **Local-first**: nenhuma dependência de rede nova.
|
|
103
|
+
- **Determinismo antes de LLM**: extração de ADR/SPEC e cálculo de risco são determinísticos; LLM
|
|
104
|
+
entra só como sugestão opcional revisável por humano (nunca regra `active` direto).
|
|
105
|
+
- **Fail-closed em ambiguidade**: regra de Constitution mal-formada não vira regra `active`
|
|
106
|
+
silenciosamente — fica `proposed` até aprovação.
|
|
107
|
+
- **Compatibilidade**: zero breaking change nesta spec master; qualquer breaking change futuro tem
|
|
108
|
+
ADR próprio (ver ADR-0078, "Negativas/Trade-offs").
|
|
109
|
+
|
|
110
|
+
## 7. Riscos e mitigação
|
|
111
|
+
|
|
112
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
113
|
+
|---|---|---|---|
|
|
114
|
+
| Escopo da visão original (33 features) vazar para dentro desta spec master | Alta se não vigiado | Alta (nunca termina) | Escopo §5 explicitamente limitado a Sprints 1-3; fases seguintes exigem spec própria, não emenda desta |
|
|
115
|
+
| `packages/engineering` virar acoplamento cruzado entre architecture/risk/provenance/identity | Média | Média | `architecture` e `risk` não importam um ao outro (peers, sem acoplamento horizontal). Exceção única e intencional: `evidence` importa tipos de ambos — é o ponto de agregação por design (SPEC-035 AC-1), não um vazamento; import `type`-only, sem runtime coupling |
|
|
116
|
+
| Risk score sem uso real por falta de dado histórico (cold start) | Alta no início | Baixa | `confidence` do assessment reflete isso explicitamente — não é um bloqueador, é um dado honesto |
|
|
117
|
+
|
|
118
|
+
## 8. Métricas de sucesso
|
|
119
|
+
|
|
120
|
+
30 dias após Sprint 3: rodar `forja engineer "<mudança real deste repositório>"` produz uma saída
|
|
121
|
+
com ADRs corretos, risco plausível e nenhuma alucinação de arquitetura que não existe — validado
|
|
122
|
+
por revisão humana em pelo menos 3 mudanças reais consecutivas.
|
|
123
|
+
|
|
124
|
+
**Status na entrega dos Sprints 1-3** (validação imediata, não os 30 dias de uso real — essa
|
|
125
|
+
segunda parte só se acumula com o tempo): `forja engineer` já foi validado sobre um objetivo real
|
|
126
|
+
deste repositório (`specs/engineering-evidence-ledger/spec.md` §8), e `risk:assess` sobre 5 commits
|
|
127
|
+
reais com ordenação de risco aceita em revisão humana (`specs/change-risk-engine/spec.md` §8). Os
|
|
128
|
+
"pelo menos 3 mudanças reais consecutivas" ao longo de 30 dias de uso continuado ficam para quem
|
|
129
|
+
usar a ferramenta a partir daqui — não algo que esta entrega possa provar sozinha no dia do merge.
|
|
130
|
+
|
|
131
|
+
## Apêndice — plano de sprints (não é `plan.md` formal: esta spec ainda está em `draft`, e o
|
|
132
|
+
próprio gate de `spec:check` do Forja recusa `plan.md` antes de `spec: approved` — o rascunho de
|
|
133
|
+
sprints pedido na primeira entrega vive aqui até a aprovação formal, quando então vira `plan.md`
|
|
134
|
+
de verdade)
|
|
135
|
+
|
|
136
|
+
**Abordagem**: bottom-up a partir do Engineering Graph (SPEC-032), porque toda outra peça
|
|
137
|
+
(Constitution, Risk, Evidence) lê ou escreve nele. Cada sprint entrega um comando funcional real
|
|
138
|
+
sobre este próprio repositório antes de passar ao próximo.
|
|
139
|
+
|
|
140
|
+
| Sprint | Specs | Entrega | Prova de sucesso |
|
|
141
|
+
|---|---|---|---|
|
|
142
|
+
| **1** | SPEC-032, SPEC-033 | `ADR`/`SPEC` como nós de primeira classe; `architecture:compile`/`check` sobre `memory/90-decisions/` real, reaproveitando o motor do `drift-sentinel` (SPEC-030) | `architecture:check` neste repo aponta zero violação na linha de base e detecta uma violação injetada de propósito em teste |
|
|
143
|
+
| **2** | SPEC-034 | `risk:assess`/`risk:explain` funcionais; `RiskAssessor` opcionalmente consultado por `PolicyEngine` | score sobre um diff real deste repositório concorda com julgamento humano |
|
|
144
|
+
| **3** | SPEC-035 | view agregada de evidência por run; façade `forja engineer` (contexto + arquitetura + risco + ADRs + fluxo recomendado) | saída de `forja engineer` sobre um objetivo real seria usada sem edição para começar o trabalho |
|
|
145
|
+
|
|
146
|
+
Diagrama:
|
|
147
|
+
|
|
148
|
+
```text
|
|
149
|
+
Sprint 1 Sprint 2 Sprint 3
|
|
150
|
+
Engineering Graph → Change Risk Engine → Evidence Ledger
|
|
151
|
+
Architecture (consome Graph + (agrega dados já
|
|
152
|
+
Constitution Architecture) persistidos)
|
|
153
|
+
│ │ │
|
|
154
|
+
└───────────────────────┴───────────────────────┘
|
|
155
|
+
│
|
|
156
|
+
forja engineer
|
|
157
|
+
(façade, Sprint 3)
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
Decisão registrada (D1): ordem Graph → Constitution → Risk → Evidence, não a ordem alfabética/de
|
|
161
|
+
prioridade P0 da visão original — cada peça depende de contratos que a anterior estabiliza;
|
|
162
|
+
implementar em paralelo geraria retrabalho. Não é estrutural o suficiente para ADR própria (a
|
|
163
|
+
decisão estrutural maior — 3.0 vs. 2.x — já está em ADR-0078).
|
|
164
|
+
|
|
165
|
+
Dependências: specs SPEC-032 a SPEC-035 (todas draft); SPEC-029 (cost-aware-autonomy-budget, done)
|
|
166
|
+
e SPEC-030 (drift-sentinel, base do `architecture:check`) já em implementação nesta mesma janela.
|
|
167
|
+
Nenhum pacote npm novo.
|
|
168
|
+
|
|
169
|
+
Rollout: feature flags `features.engineeringGraph`/`architectureConstitution`/`changeRiskEngine`
|
|
170
|
+
default `false` até cada sprint fechar seus próprios testes; nenhuma migração de dado existente
|
|
171
|
+
(extensão aditiva de vocabulário); docs impactadas — `docs/architecture/`, `AGENTS.md` (papel
|
|
172
|
+
opcional "architecture reviewer"), `DOC-MAP.md`.
|
|
173
|
+
|
|
174
|
+
Kill criteria: se `architecture:check` gerar mais falso-positivo que sinal real sobre este próprio
|
|
175
|
+
repositório depois do Sprint 1, o motor é redesenhado antes de avançar para o Sprint 2 — não
|
|
176
|
+
empilhamos risco em cima de arquitetura que não detecta corretamente. Falta de histórico para
|
|
177
|
+
`confidence` alta no Risk Engine (Sprint 2) é limitação documentada, não kill criteria.
|
package/specs/forja-core/spec.md
CHANGED
|
@@ -1,71 +1,71 @@
|
|
|
1
|
-
# Spec: forja-core
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-025
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: framework-team
|
|
6
|
-
- **Criado em**: 2026-07-06
|
|
7
|
-
- **Sprint alvo**: core-2026-07
|
|
8
|
-
- **ADRs relacionadas**: ADR-0020 (core CLI única), ADR-0019 (workspace separado), ADR-0005 (handoff 7 campos), ADR-0017 (codegraph no GSD)
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
O Forja se apresenta como framework de orquestração, mas os comandos não passam por um núcleo comum. Hoje existem **três dispatchers paralelos**:
|
|
12
|
-
|
|
13
|
-
1. `scripts/agent-harness.mjs` — workspace, GSD, design, code intelligence (com gates próprios).
|
|
14
|
-
2. `scripts/dev.mjs` — context, memória, project:health (registry próprio, duplica `design:*`/`gsd:*`).
|
|
15
|
-
3. `package.json` — ~40 scripts npm apontando direto para 15+ scripts soltos (`spec-cli`, `sprint-manager`, `sync-universal-memory`, `context-ops`, …), inclusive com a chave `project:check` **duplicada** (a primeira definição é silenciosamente descartada pelo npm).
|
|
16
|
-
|
|
17
|
-
Consequências mensuráveis:
|
|
18
|
-
- Nenhuma trilha de auditoria unificada: não dá para responder "quais comandos rodaram nesta feature?" sem grep em N lugares.
|
|
19
|
-
- Gates aplicados de forma desigual: `gsd:check` valida codegraph, mas `spec:tasks` e `sprint:start` não validam nada do processo.
|
|
20
|
-
- O workspace (ADR-0019) é resolvido por alguns comandos e ignorado por outros — um comando de produto pode rodar sem workspace e falhar tarde ou agir no lugar errado.
|
|
21
|
-
- Projetos gerados não são registrados em lugar nenhum: `project:new` cria a pasta e termina; a ficha em `memory/30-projects/` depende de disciplina manual.
|
|
22
|
-
|
|
23
|
-
## 2. Proposta de valor
|
|
24
|
-
Uma **CLI única `forja`** (bin/forja.mjs) vira o core executivo do framework: todo comando passa por um registry declarativo, com gates transversais (workspace, processo) e **trilha de auditoria** append-only. Projetos passam pelo core no nascimento (registro automático de ficha no workspace). Os dispatchers existentes viram implementação interna — nada é reescrito, tudo é roteado.
|
|
25
|
-
|
|
26
|
-
## 3. User stories
|
|
27
|
-
- **Como** operador do Forja, **quero** rodar `forja <comando>` (ou `npm run <alias>`) e ter um único ponto de entrada com help agrupado por domínio, **para que** eu não precise decorar qual script implementa o quê.
|
|
28
|
-
- **Como** governance, **quero** que toda execução de comando seja registrada em `.context/forja-runs.jsonl` (comando, args, exit code, duração), **para que** o review de uma feature tenha trilha de auditoria do processo.
|
|
29
|
-
- **Como** operador, **quero** que comandos de produto falhem cedo e com instrução clara quando o workspace não existe, **para que** nada rode no lugar errado (ADR-0019).
|
|
30
|
-
- **Como** orchestrator, **quero** que `project:new` registre automaticamente a ficha do projeto em `memory/30-projects/` do workspace, **para que** todo projeto nasça rastreado pelo core.
|
|
31
|
-
|
|
32
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
33
|
-
- [ ] AC-1: `node bin/forja.mjs` (sem args) lista todos os comandos agrupados por domínio; `forja <cmd> --help` ou comando desconhecido orienta com exit ≠ 0 no caso de erro.
|
|
34
|
-
- [ ] AC-2: existe `lib/core/registry.mjs` declarativo: cada comando tem domínio, descrição, alvo (script/binário) e gates; teste automatizado garante que todo script referenciado existe.
|
|
35
|
-
- [ ] AC-3: toda execução via core gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback: `.context/` do repo quando não há workspace) com ts, cmd, args, exitCode e durationMs.
|
|
36
|
-
- [ ] AC-4: comandos marcados com gate `workspace` falham cedo com mensagem "rode forja workspace:init" quando o workspace não existe.
|
|
37
|
-
- [ ] AC-5: os scripts npm do `package.json` roteiam pelo core (`node bin/forja.mjs <cmd>`); a chave duplicada `project:check` é eliminada; `forja` entra em `"bin"` do pacote.
|
|
38
|
-
- [ ] AC-6: `project:new` bem-sucedido grava/atualiza ficha do projeto em `<workspace>/memory/30-projects/<nome>.md`.
|
|
39
|
-
- [ ] AC-7: `npm test` cobre registry, help, comando desconhecido e gate de workspace; suíte existente continua verde.
|
|
40
|
-
|
|
41
|
-
## 5. Escopo
|
|
42
|
-
**Dentro**:
|
|
43
|
-
- `bin/forja.mjs` (dispatcher), `lib/core/registry.mjs` (registry + gates)
|
|
44
|
-
- `package.json`: bin `forja`, rewire dos scripts, remoção da duplicata
|
|
45
|
-
- `scripts/agent-harness.mjs`: ficha automática no `project:new`
|
|
46
|
-
- `test/forja-core.test.js`
|
|
47
|
-
- README/DOC-MAP: documentar o core como ponto de entrada
|
|
48
|
-
|
|
49
|
-
**Fora** (explícito, evita scope creep):
|
|
50
|
-
- Reescrever `dev.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. — continuam como implementação; `dev.mjs` fica como alias legado documentado
|
|
51
|
-
- Embutir a CLI `forja` nos projetos gerados (`lib/generators/`) — fase 2, spec própria
|
|
52
|
-
- Dashboard (`dashboard:*`) — front opcional, fora do processo
|
|
53
|
-
- Gravar auditoria no SQLite (JSONL primeiro; promoção a tabela é evolução futura)
|
|
54
|
-
|
|
55
|
-
## 6. NFRs / restrições
|
|
56
|
-
- Zero dependências novas (Node stdlib apenas).
|
|
57
|
-
- Overhead do roteamento imperceptível (< 100ms além do script alvo).
|
|
58
|
-
- Degradação graciosa: auditoria nunca bloqueia o comando (falha de escrita = warning).
|
|
59
|
-
- Compatibilidade: todos os aliases npm atuais continuam funcionando com a mesma semântica.
|
|
60
|
-
- pt-BR em toda saída de CLI.
|
|
61
|
-
|
|
62
|
-
## 7. Riscos e mitigação
|
|
63
|
-
| Risco | Probabilidade | Impacto | Mitigação |
|
|
64
|
-
|---|---|---|---|
|
|
65
|
-
| Duplo spawn (npm → forja → script) mascarar exit codes | B | A | Propagar `status` do filho sempre; testes de exit code |
|
|
66
|
-
| Registry divergir dos scripts reais | M | M | Teste de integridade (todo alvo existe no disco) |
|
|
67
|
-
| Gate de workspace bloquear fluxo legítimo do framework | M | M | Gate só em comandos de domínio de produto; framework roda sem workspace |
|
|
68
|
-
| JSONL de auditoria crescer sem limite | B | B | Arquivo em `.context/` (gitignored); rotação futura via `memory:compress` |
|
|
69
|
-
|
|
70
|
-
## 8. Métricas de sucesso
|
|
71
|
-
30 dias após o release: (a) 100% dos comandos de processo listados no help do core; (b) `forja-runs.jsonl` presente e usado em pelo menos um review de governance; (c) zero projetos criados sem ficha em `30-projects/`.
|
|
1
|
+
# Spec: forja-core
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-025
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: framework-team
|
|
6
|
+
- **Criado em**: 2026-07-06
|
|
7
|
+
- **Sprint alvo**: core-2026-07
|
|
8
|
+
- **ADRs relacionadas**: ADR-0020 (core CLI única), ADR-0019 (workspace separado), ADR-0005 (handoff 7 campos), ADR-0017 (codegraph no GSD)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O Forja se apresenta como framework de orquestração, mas os comandos não passam por um núcleo comum. Hoje existem **três dispatchers paralelos**:
|
|
12
|
+
|
|
13
|
+
1. `scripts/agent-harness.mjs` — workspace, GSD, design, code intelligence (com gates próprios).
|
|
14
|
+
2. `scripts/dev.mjs` — context, memória, project:health (registry próprio, duplica `design:*`/`gsd:*`).
|
|
15
|
+
3. `package.json` — ~40 scripts npm apontando direto para 15+ scripts soltos (`spec-cli`, `sprint-manager`, `sync-universal-memory`, `context-ops`, …), inclusive com a chave `project:check` **duplicada** (a primeira definição é silenciosamente descartada pelo npm).
|
|
16
|
+
|
|
17
|
+
Consequências mensuráveis:
|
|
18
|
+
- Nenhuma trilha de auditoria unificada: não dá para responder "quais comandos rodaram nesta feature?" sem grep em N lugares.
|
|
19
|
+
- Gates aplicados de forma desigual: `gsd:check` valida codegraph, mas `spec:tasks` e `sprint:start` não validam nada do processo.
|
|
20
|
+
- O workspace (ADR-0019) é resolvido por alguns comandos e ignorado por outros — um comando de produto pode rodar sem workspace e falhar tarde ou agir no lugar errado.
|
|
21
|
+
- Projetos gerados não são registrados em lugar nenhum: `project:new` cria a pasta e termina; a ficha em `memory/30-projects/` depende de disciplina manual.
|
|
22
|
+
|
|
23
|
+
## 2. Proposta de valor
|
|
24
|
+
Uma **CLI única `forja`** (bin/forja.mjs) vira o core executivo do framework: todo comando passa por um registry declarativo, com gates transversais (workspace, processo) e **trilha de auditoria** append-only. Projetos passam pelo core no nascimento (registro automático de ficha no workspace). Os dispatchers existentes viram implementação interna — nada é reescrito, tudo é roteado.
|
|
25
|
+
|
|
26
|
+
## 3. User stories
|
|
27
|
+
- **Como** operador do Forja, **quero** rodar `forja <comando>` (ou `npm run <alias>`) e ter um único ponto de entrada com help agrupado por domínio, **para que** eu não precise decorar qual script implementa o quê.
|
|
28
|
+
- **Como** governance, **quero** que toda execução de comando seja registrada em `.context/forja-runs.jsonl` (comando, args, exit code, duração), **para que** o review de uma feature tenha trilha de auditoria do processo.
|
|
29
|
+
- **Como** operador, **quero** que comandos de produto falhem cedo e com instrução clara quando o workspace não existe, **para que** nada rode no lugar errado (ADR-0019).
|
|
30
|
+
- **Como** orchestrator, **quero** que `project:new` registre automaticamente a ficha do projeto em `memory/30-projects/` do workspace, **para que** todo projeto nasça rastreado pelo core.
|
|
31
|
+
|
|
32
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
33
|
+
- [ ] AC-1: `node bin/forja.mjs` (sem args) lista todos os comandos agrupados por domínio; `forja <cmd> --help` ou comando desconhecido orienta com exit ≠ 0 no caso de erro.
|
|
34
|
+
- [ ] AC-2: existe `lib/core/registry.mjs` declarativo: cada comando tem domínio, descrição, alvo (script/binário) e gates; teste automatizado garante que todo script referenciado existe.
|
|
35
|
+
- [ ] AC-3: toda execução via core gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback: `.context/` do repo quando não há workspace) com ts, cmd, args, exitCode e durationMs.
|
|
36
|
+
- [ ] AC-4: comandos marcados com gate `workspace` falham cedo com mensagem "rode forja workspace:init" quando o workspace não existe.
|
|
37
|
+
- [ ] AC-5: os scripts npm do `package.json` roteiam pelo core (`node bin/forja.mjs <cmd>`); a chave duplicada `project:check` é eliminada; `forja` entra em `"bin"` do pacote.
|
|
38
|
+
- [ ] AC-6: `project:new` bem-sucedido grava/atualiza ficha do projeto em `<workspace>/memory/30-projects/<nome>.md`.
|
|
39
|
+
- [ ] AC-7: `npm test` cobre registry, help, comando desconhecido e gate de workspace; suíte existente continua verde.
|
|
40
|
+
|
|
41
|
+
## 5. Escopo
|
|
42
|
+
**Dentro**:
|
|
43
|
+
- `bin/forja.mjs` (dispatcher), `lib/core/registry.mjs` (registry + gates)
|
|
44
|
+
- `package.json`: bin `forja`, rewire dos scripts, remoção da duplicata
|
|
45
|
+
- `scripts/agent-harness.mjs`: ficha automática no `project:new`
|
|
46
|
+
- `test/forja-core.test.js`
|
|
47
|
+
- README/DOC-MAP: documentar o core como ponto de entrada
|
|
48
|
+
|
|
49
|
+
**Fora** (explícito, evita scope creep):
|
|
50
|
+
- Reescrever `dev.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. — continuam como implementação; `dev.mjs` fica como alias legado documentado
|
|
51
|
+
- Embutir a CLI `forja` nos projetos gerados (`lib/generators/`) — fase 2, spec própria
|
|
52
|
+
- Dashboard (`dashboard:*`) — front opcional, fora do processo
|
|
53
|
+
- Gravar auditoria no SQLite (JSONL primeiro; promoção a tabela é evolução futura)
|
|
54
|
+
|
|
55
|
+
## 6. NFRs / restrições
|
|
56
|
+
- Zero dependências novas (Node stdlib apenas).
|
|
57
|
+
- Overhead do roteamento imperceptível (< 100ms além do script alvo).
|
|
58
|
+
- Degradação graciosa: auditoria nunca bloqueia o comando (falha de escrita = warning).
|
|
59
|
+
- Compatibilidade: todos os aliases npm atuais continuam funcionando com a mesma semântica.
|
|
60
|
+
- pt-BR em toda saída de CLI.
|
|
61
|
+
|
|
62
|
+
## 7. Riscos e mitigação
|
|
63
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
64
|
+
|---|---|---|---|
|
|
65
|
+
| Duplo spawn (npm → forja → script) mascarar exit codes | B | A | Propagar `status` do filho sempre; testes de exit code |
|
|
66
|
+
| Registry divergir dos scripts reais | M | M | Teste de integridade (todo alvo existe no disco) |
|
|
67
|
+
| Gate de workspace bloquear fluxo legítimo do framework | M | M | Gate só em comandos de domínio de produto; framework roda sem workspace |
|
|
68
|
+
| JSONL de auditoria crescer sem limite | B | B | Arquivo em `.context/` (gitignored); rotação futura via `memory:compress` |
|
|
69
|
+
|
|
70
|
+
## 8. Métricas de sucesso
|
|
71
|
+
30 dias após o release: (a) 100% dos comandos de processo listados no help do core; (b) `forja-runs.jsonl` presente e usado em pelo menos um review de governance; (c) zero projetos criados sem ficha em `30-projects/`.
|