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,117 @@
|
|
|
1
|
+
# Spec: Drift Sentinel — verificação contínua de que o verificado continua verdade
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-030
|
|
4
|
+
- **Status**: implementing
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-08-31
|
|
7
|
+
- **Sprint alvo**: <a definir>
|
|
8
|
+
- **Implementação**: `lib/drift-sentinel.ts` (motor), `scripts/drift-check.ts` (CLI, `forja drift:check
|
|
9
|
+
[--domain <d>]`), `lib/core/drift-gate.ts` + `lib/core/gates.ts`/`scripts/gates.ts`
|
|
10
|
+
(`check:all --with-drift`, AC-5). AC-1 a AC-4 completos, com testes em
|
|
11
|
+
`test/drift-sentinel.test.js`. AC-5 implementado com escopo reduzido: em vez de restruturar
|
|
12
|
+
`runGates`/`CHECKS` para rodar `drift:check` in-process, o gate opt-in chama o comando real via
|
|
13
|
+
subprocess (mesmo padrão de `lib/core/release.ts`/`project-smoke.ts`) e traduz o resultado —
|
|
14
|
+
mantém `check:all` desacoplado do wiring do grafo (SQLite/git) sem tocar o contrato do runner de
|
|
15
|
+
checks. Não marcado `done` porque a métrica de sucesso do §8 (drift genuíno encontrado em projeto
|
|
16
|
+
real, confirmado por humano, 30 dias após o release) ainda não foi observada — só dogfooding
|
|
17
|
+
local contra o próprio monorepo, que não achou drift real algum ainda.
|
|
18
|
+
- **ADRs relacionadas**: nenhuma ainda — nasce da auditoria de segurança de 2026-08-31, que corrigiu
|
|
19
|
+
`packages/graph` para que `status: 'verified'` só venha de fontes de evidência confiáveis
|
|
20
|
+
(`deterministic-extractor`, `sandbox.*`). Este spec é a continuação natural: **verified é um
|
|
21
|
+
instantâneo, não uma garantia permanente.**
|
|
22
|
+
|
|
23
|
+
## 1. Problema
|
|
24
|
+
|
|
25
|
+
O GraphLoop agora distingue de verdade `verified` de `inferred`/`hypothesis` (a auditoria fechou o
|
|
26
|
+
buraco onde qualquer chamador podia se autodeclarar "verificado"). Mas isso resolve só metade do
|
|
27
|
+
problema: **um nó ou aresta `verified` continua marcado `verified` para sempre**, mesmo que o código
|
|
28
|
+
que o originou tenha mudado depois. `GraphIndexer.sync` já é idempotente por checksum de fonte
|
|
29
|
+
(`apply()` pula quando `sourceChecksum` não mudou) — ou seja, **o mecanismo para detectar "isso
|
|
30
|
+
mudou" já existe**. O que falta é: quando um documento muda, nada hoje sinaliza que as
|
|
31
|
+
arestas/evidências antigas derivadas dele podem estar obsoletas até a próxima reindexação, e nada
|
|
32
|
+
compara a nova extração contra a ADR/spec que descrevia o estado anterior. Uma ADR pode descrever uma
|
|
33
|
+
decisão que o código não implementa mais há três sprints, e nada no Forja aponta a divergência — ela
|
|
34
|
+
só aparece quando um humano tropeça nela.
|
|
35
|
+
|
|
36
|
+
## 2. Proposta de valor
|
|
37
|
+
|
|
38
|
+
Um novo comando, `forja drift:check`, reindexa (via `GraphIndexer.sync`, já existente) e classifica
|
|
39
|
+
cada documento em três estados: **inalterado**, **mudou e a extração continua consistente com as
|
|
40
|
+
relações registradas**, ou **mudou e uma relação antes `verified` não é mais reproduzível a partir do
|
|
41
|
+
conteúdo atual** — este último caso é o "drift" que importa: uma ADR, um `DEPENDS_ON`, um `IMPLEMENTS`
|
|
42
|
+
que já foi verdade e hoje não é mais, sem que nada tenha formalmente revogado essa relação.
|
|
43
|
+
|
|
44
|
+
## 3. User stories
|
|
45
|
+
|
|
46
|
+
- **Como** sdd-architect, **quero** saber quando uma ADR descreve algo que o código não faz mais,
|
|
47
|
+
**para que** eu não continue arquitetando em cima de uma premissa que já morreu.
|
|
48
|
+
- **Como** governance, **quero** um relatório de "quantos documentos divergiram desde a última
|
|
49
|
+
verificação", **para que** drift vire um item de rotina (tipo `gsd:check`), não uma surpresa.
|
|
50
|
+
- **Como** consultor com dezenas de projetos gerados pelo Forja, **quero** rodar `drift:check` em lote
|
|
51
|
+
antes de retomar um projeto que não toco há meses, **para que** eu recupere contexto real em vez de
|
|
52
|
+
confiar cegamente em specs/ADRs antigas.
|
|
53
|
+
|
|
54
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
55
|
+
|
|
56
|
+
- [x] AC-1: `forja drift:check [--domain <d>]` roda `GraphIndexer.sync` e, para cada `GraphMutation`
|
|
57
|
+
cujo `sourceChecksum` mudou desde a última indexação, compara as arestas que o documento
|
|
58
|
+
produzia **antes** com as que produz **agora**. *(`checkDrift` em `lib/drift-sentinel.ts`
|
|
59
|
+
reimplementa o laço de `GraphIndexer.sync` — mesma extração + `GraphLoop.apply` — em vez de
|
|
60
|
+
chamá-lo por dentro, porque `sync()` não expõe o "antes" por documento; nenhum dos dois ganhou
|
|
61
|
+
contrato novo, como o §5 já antecipava.)*
|
|
62
|
+
- [x] AC-2: uma aresta que existia com `status: 'verified'` e não é mais produzida pela extração atual
|
|
63
|
+
do mesmo `sourceKey` é marcada `stale` (reaproveitando `validTo` — GraphLoop já suporta validade
|
|
64
|
+
temporal — em vez de inventar um estado novo em `KnowledgeStatus`, que é um contrato versionado
|
|
65
|
+
e não deve crescer sem necessidade real). *(A proveniência "quais arestas este sourceKey
|
|
66
|
+
produziu" também não ganhou campo novo em `GraphEdge` — é derivada do `locator` da evidência,
|
|
67
|
+
`${sourceKey}:${line}`, que `extractDeterministicRelations` já grava.)*
|
|
68
|
+
- [x] AC-3: o comando imprime um relatório: N documentos verificados, M sem mudança, K com drift
|
|
69
|
+
detectado (lista de `sourceKey` + quais relações ficaram `stale`).
|
|
70
|
+
- [x] AC-4: `drift:check` é determinístico e não usa LLM — é extração + diff, igual ao
|
|
71
|
+
`extractDeterministicRelations` que já existe. Nenhuma dependência nova de rede ou modelo.
|
|
72
|
+
- [x] AC-5: `gsd:check`/`check:all` ganham um modo opcional (`--with-drift`, não obrigatório por
|
|
73
|
+
padrão) que inclui `drift:check` na bateria — opcional porque rodar em todo commit seria caro
|
|
74
|
+
demais para repos grandes; ver NFRs. *(Escopo reduzido — ver `Implementação` no cabeçalho: gate
|
|
75
|
+
via subprocess, não integração in-process em `runGates`.)*
|
|
76
|
+
|
|
77
|
+
## 5. Escopo
|
|
78
|
+
|
|
79
|
+
**Dentro**:
|
|
80
|
+
- Comando `drift:check`, reaproveitando `GraphIndexer`/`GraphLoop`/`extractDeterministicRelations`
|
|
81
|
+
como estão (nenhuma mudança de contrato nesses três é necessária além de expor o "antes vs. depois"
|
|
82
|
+
que `apply()` já computa internamente e hoje descarta).
|
|
83
|
+
- Marcação de arestas obsoletas via `validTo` (mecanismo já existente).
|
|
84
|
+
- Relatório CLI.
|
|
85
|
+
|
|
86
|
+
**Fora** (explícito, evita scope creep):
|
|
87
|
+
- **Corrigir automaticamente** o código ou a ADR — o comando só sinaliza; decidir qual lado (código ou
|
|
88
|
+
documento) está desatualizado é julgamento humano ou de agente, não deste comando.
|
|
89
|
+
- Rodar em CI/pre-commit por padrão — fica opt-in (ver AC-5) até haver medição de custo em repos
|
|
90
|
+
grandes.
|
|
91
|
+
- Drift semântico ("a ADR ainda é logicamente verdadeira mas o código foi refatorado") — este spec
|
|
92
|
+
cobre só drift **estrutural**, detectável pelo mesmo extrator determinístico que já indexa o grafo.
|
|
93
|
+
|
|
94
|
+
## 6. NFRs / restrições
|
|
95
|
+
|
|
96
|
+
- **Performance**: `drift:check` não pode ser mais caro que rodar `code:index` duas vezes (é
|
|
97
|
+
essencialmente isso) — sem chamada de LLM, custo é I/O + regex, já provado barato pelo indexador
|
|
98
|
+
existente.
|
|
99
|
+
- **Falso positivo em refactors cosméticos**: renomear uma variável sem mudar a relação semântica não
|
|
100
|
+
deve gerar drift — mitigado porque o extrator já trabalha por relação (`DEPENDS_ON`, `CALLS`,
|
|
101
|
+
`IMPLEMENTS`...), não por hash de linha inteira; um rename que preserva a relação preserva a aresta.
|
|
102
|
+
- **Determinismo antes de LLM** (princípio já declarado na visão do Forja 2.0): este comando não
|
|
103
|
+
introduz nenhuma dependência de modelo.
|
|
104
|
+
|
|
105
|
+
## 7. Riscos e mitigação
|
|
106
|
+
|
|
107
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
108
|
+
|---|---|---|---|
|
|
109
|
+
| Ruído: muito drift cosmético reportado, comando vira "grito de lobo" | Média | Alta (ninguém mais lê o relatório) | Escopo restrito a relações semânticas, não hash de conteúdo bruto (ver NFR acima); medir taxa de falso positivo no dogfooding antes do GO |
|
|
110
|
+
| Confundir `stale` com `contradicted` (que já existe e significa outra coisa — conflito ativo) | Baixa | Média | AC-2 usa `validTo`, não reaproveita `contradicted`; documentar a diferença explicitamente no plan |
|
|
111
|
+
| Escopo crescer para "corrigir automaticamente" | Média | Alta (autonomia não supervisionada mexendo em ADR) | Fora de escopo explícito (§5); qualquer autocorreção é uma spec futura, com gate de aprovação próprio |
|
|
112
|
+
|
|
113
|
+
## 8. Métricas de sucesso
|
|
114
|
+
|
|
115
|
+
30 dias após o release: rodar `drift:check` num projeto real e ativo (não um fixture) resulta em pelo
|
|
116
|
+
menos um drift genuíno encontrado que um humano confirma como real (não falso positivo) — provando que
|
|
117
|
+
o sinal vale o custo de rodar.
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Plan: `forja engineer` — compor recomendação de agente + incidentes parecidos
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-09-01
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem técnica
|
|
8
|
+
|
|
9
|
+
`rankIncidentsByQuery`/`incidentRecords`/`titleOf` (hoje locais a `scripts/incident.ts`) mudam pra
|
|
10
|
+
`lib/core/incident-search.ts` — **não** ficam exportadas de `scripts/incident.ts` (revisado durante
|
|
11
|
+
a implementação, D3): um script tem `main()` executado incondicionalmente ao ser importado (mesmo
|
|
12
|
+
padrão de todo `scripts/*.ts` deste repositório), então `scripts/engineer.ts` importando de
|
|
13
|
+
`scripts/incident.ts` rodaria o `main()` de `incident.ts` como efeito colateral, processando o
|
|
14
|
+
`argv` de `engineer` como se fosse de `incident`. `lib/core/risk-collect.ts` já resolveu exatamente
|
|
15
|
+
esse problema pra `risk`/`engineer`/`simulate` — mesma solução aqui. `scripts/incident.ts` passa a
|
|
16
|
+
*importar* de `lib/core/incident-search.ts`, não a exportar pra ele.
|
|
17
|
+
|
|
18
|
+
`scripts/engineer.ts` importa as três funções + `recommendAgent`/`SqliteAgentProfileStore` (já
|
|
19
|
+
usados em `scripts/agent.ts`, agora também aqui) e adiciona duas seções ao `EngineerReport`.
|
|
20
|
+
|
|
21
|
+
## 2. Módulos afetados
|
|
22
|
+
|
|
23
|
+
| Caminho | Mudança | Risco |
|
|
24
|
+
|---|---|---|
|
|
25
|
+
| `lib/core/incident-search.ts` (novo) | `rankIncidentsByQuery`/`incidentRecords`/`titleOf`, extraídas de `scripts/incident.ts` | Baixo — mesmo padrão já usado por `risk-collect.ts` |
|
|
26
|
+
| `scripts/incident.ts` | passa a importar de `lib/core/incident-search.ts` em vez de definir localmente — comportamento idêntico (refactor puro) | Baixo |
|
|
27
|
+
| `scripts/engineer.ts` | `--role <role>` novo flag; 2 seções novas no relatório | Baixo — só composição |
|
|
28
|
+
| `test/incident-cli.test.js` | nenhuma mudança esperada (comportamento de `incident:similar` idêntico) | — |
|
|
29
|
+
| `test/engineer-cli.test.js` | +testes das 2 seções novas | — |
|
|
30
|
+
|
|
31
|
+
## 3. Contratos
|
|
32
|
+
|
|
33
|
+
```ts
|
|
34
|
+
// lib/core/incident-search.ts
|
|
35
|
+
export interface RankedIncident { readonly record: GraphNode; readonly relevance: number; }
|
|
36
|
+
export function rankIncidentsByQuery(records: readonly GraphNode[], query: string): readonly RankedIncident[];
|
|
37
|
+
export function incidentRecords(store: SqliteGraphStore): readonly GraphNode[];
|
|
38
|
+
export function titleOf(node: GraphNode): string;
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
`EngineerReport` ganha:
|
|
46
|
+
```ts
|
|
47
|
+
readonly recommendedAgents?: readonly { readonly agentId: string; readonly score: number; readonly reasons: readonly string[] }[]; // só com --role
|
|
48
|
+
readonly similarIncidents: readonly { readonly id: string; readonly title: string; readonly relevance: number }[]; // sempre presente, [] se vazio
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## 4. Decisões
|
|
52
|
+
|
|
53
|
+
**D1**: seção de incidentes usa o **objetivo inteiro** como busca (mesmo texto livre já usado por
|
|
54
|
+
`ContextEngine.build`/`GraphLoop.contextRecords` na mesma função) — não um `--query` separado, pra
|
|
55
|
+
não multiplicar flags sem necessidade real; o objetivo já É a busca mais natural.
|
|
56
|
+
|
|
57
|
+
**D2**: `rankIncidentsByQuery` extraída sem alterar `incident:similar` de comportamento — mesmo
|
|
58
|
+
teste de CLI (`test/incident-cli.test.js`) continua valendo como prova de regressão do refactor.
|
|
59
|
+
|
|
60
|
+
**D3** (revisada durante a implementação): a extração vai pra `lib/core/incident-search.ts`, não
|
|
61
|
+
fica exportada de `scripts/incident.ts` como a primeira versão deste plan previa — ver §1, motivo
|
|
62
|
+
completo é o mesmo já documentado no cabeçalho do próprio arquivo novo.
|
|
63
|
+
|
|
64
|
+
## 5. Rollout
|
|
65
|
+
|
|
66
|
+
Sem migração, sem feature flag.
|
|
67
|
+
|
|
68
|
+
## 6. Kill criteria
|
|
69
|
+
|
|
70
|
+
Já coberto pelo princípio geral — se as duas seções novas não ajudarem na prática (§8), removê-las
|
|
71
|
+
é mais barato que mantê-las: nenhuma outra spec depende delas.
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# Spec: `forja engineer` — compor recomendação de agente + incidentes parecidos
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-042
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprint 10 (extensão de composição — todos os Sprints 4-9 da Fase 3-6 já entregam
|
|
8
|
+
sinais que `forja engineer`, de SPEC-035/Sprint 3, ainda não compõe)
|
|
9
|
+
- **ADRs relacionadas**: ADR-0078; depende de SPEC-035 (`forja engineer`), SPEC-037
|
|
10
|
+
(`recommendAgent`), SPEC-041 (`incident:similar`) — todos reaproveitados sem mudança
|
|
11
|
+
|
|
12
|
+
> `forja engineer` (SPEC-035) foi implementada no Sprint 3, antes de `recommendAgent` (SPEC-037,
|
|
13
|
+
> Sprint 5) e `incident:similar` (SPEC-041, Sprint 9) existirem. AC-2 de SPEC-035 já definia a
|
|
14
|
+
> façade como composição extensível ("nenhuma lógica de negócio nova... qualquer decisão real
|
|
15
|
+
> continua nos engines que ela chama") — esta spec é literalmente isso: compor dois sinais que já
|
|
16
|
+
> existem e que a proposta de valor original de `forja engineer` (SPEC-031 §2: "uma única pergunta
|
|
17
|
+
> que já traga arquitetura, risco, ADRs relevantes e fluxo recomendado") já pedia implicitamente,
|
|
18
|
+
> mas que não existiam ainda no Sprint 3.
|
|
19
|
+
|
|
20
|
+
## 1. Problema
|
|
21
|
+
|
|
22
|
+
`forja engineer "<objetivo>"` já compõe contexto, ADRs relevantes, `architecture:check` e risco —
|
|
23
|
+
mas não sugere qual agente registrado é mais adequado pro objetivo, nem mostra incidentes passados
|
|
24
|
+
parecidos, mesmo essas duas capacidades já existindo (`agent:recommend`, `incident:similar`) e
|
|
25
|
+
sendo exatamente o tipo de sinal que orienta o início de um trabalho.
|
|
26
|
+
|
|
27
|
+
## 2. Proposta de valor
|
|
28
|
+
|
|
29
|
+
`forja engineer "<objetivo>" [--role <role>]` passa a incluir, quando aplicável: ranking de agentes
|
|
30
|
+
registrados adequados ao `--role` informado (reaproveita `recommendAgent`, SPEC-037), e incidentes
|
|
31
|
+
passados parecidos com o objetivo (reaproveita a busca por palavra-chave de `incident:similar`,
|
|
32
|
+
SPEC-041) — sem nenhuma lógica nova, só mais composição, exatamente como AC-4 de SPEC-035 já exigia.
|
|
33
|
+
|
|
34
|
+
## 3. User stories
|
|
35
|
+
|
|
36
|
+
- **Como** desenvolvedor/orquestrador, **quero** que `forja engineer` já sugira quem trabalhar e o
|
|
37
|
+
que já aconteceu de parecido, **para que** eu não precise rodar `agent:recommend`/
|
|
38
|
+
`incident:similar` manualmente depois de já ter rodado `engineer`.
|
|
39
|
+
|
|
40
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
41
|
+
|
|
42
|
+
- [x] AC-1: `forja engineer "<objetivo>" --role <role>` inclui uma seção de agentes recomendados
|
|
43
|
+
(reaproveita `recommendAgent`, SPEC-037, sem reimplementar a fórmula de scoring). Sem
|
|
44
|
+
`--role`, a seção não aparece — nunca inventa um papel que o usuário não informou.
|
|
45
|
+
- [x] AC-2: `forja engineer "<objetivo>"` sempre inclui uma seção de incidentes parecidos
|
|
46
|
+
(reaproveita o matching por palavra-chave de `incident:similar`, SPEC-041, exportado do
|
|
47
|
+
mesmo módulo — sem duplicar a lógica de scoring). Vazio quando não há incidente parecido, não
|
|
48
|
+
erro.
|
|
49
|
+
- [x] AC-3: nenhuma lógica nova além de composição/formatação (mesmo princípio de AC-4 de
|
|
50
|
+
SPEC-035) — `recommendAgent`/o matching de incidentes continuam sendo a única fonte de
|
|
51
|
+
verdade de cada score.
|
|
52
|
+
- [x] AC-4: `--json` inclui as duas seções novas estruturadas; texto legível mostra as duas.
|
|
53
|
+
|
|
54
|
+
## 5. Escopo
|
|
55
|
+
|
|
56
|
+
**Dentro**: extensão aditiva de `scripts/engineer.ts` + mover o matching de incidentes de
|
|
57
|
+
`scripts/incident.ts` pra `lib/core/incident-search.ts` (mesmo padrão de `risk-collect.ts`) pra
|
|
58
|
+
reaproveitamento sem duplicar.
|
|
59
|
+
|
|
60
|
+
**Fora**: incluir `detectAnomaly` (SPEC-040) na composição — não se encaixa na mesma pergunta
|
|
61
|
+
("por onde eu começo") que `forja engineer` responde; anomalia é sobre comportamento contínuo de UM
|
|
62
|
+
agente já em operação, não sobre iniciar um objetivo novo (nota já registrada em ADR-0079). Fica de
|
|
63
|
+
fora por não ser a mesma pergunta, não por limitação técnica.
|
|
64
|
+
|
|
65
|
+
## 6. NFRs / restrições
|
|
66
|
+
|
|
67
|
+
- Zero lógica de scoring nova — só import + composição.
|
|
68
|
+
- Zero migration/persistência nova.
|
|
69
|
+
|
|
70
|
+
## 7. Riscos e mitigação
|
|
71
|
+
|
|
72
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
73
|
+
|---|---|---|---|
|
|
74
|
+
| `forja engineer` virar um monólito de composição frágil (toda spec futura quer adicionar uma seção) | Média a longo prazo | Baixa agora (só mais 2 seções) | Mesmo padrão de AC-4/AC-3 de SPEC-035 continua valendo — cada seção nova precisa ser genuinamente "por onde eu começo", não qualquer sinal disponível (ver §5 "Fora" sobre anomalia) |
|
|
75
|
+
|
|
76
|
+
## 8. Métricas de sucesso
|
|
77
|
+
|
|
78
|
+
Rodar `forja engineer` com `--role` sobre os agentes já registrados nos testes de SPEC-037, e sobre
|
|
79
|
+
os incidentes já registrados nos testes de SPEC-041 (reaproveitados como fixture), e confirmar que
|
|
80
|
+
as duas seções aparecem corretamente — revisão humana, mesma metodologia das specs anteriores.
|
|
81
|
+
|
|
82
|
+
**Validado** (`test/engineer-cli.test.js`): agente + incidente reais de fixtures das specs
|
|
83
|
+
anteriores; `engineer --role developer` mostrou a recomendação certa; `engineer "npm hangs..."`
|
|
84
|
+
achou o incidente correspondente e ignorou o não relacionado; sem `--role`, a seção de agentes
|
|
85
|
+
corretamente não aparece; sem nenhum incidente registrado, seção vazia sem erro.
|
|
86
|
+
|
|
87
|
+
**Achados reais corrigidos durante a implementação (não adiados)**:
|
|
88
|
+
|
|
89
|
+
1. **Importar de `scripts/incident.ts` executaria seu `main()` como efeito colateral** (todo
|
|
90
|
+
`scripts/*.ts` roda incondicionalmente ao ser importado, mesmo padrão que motivou
|
|
91
|
+
`lib/core/risk-collect.ts` em SPEC-034/038) — capturado no design antes de qualquer código ser
|
|
92
|
+
escrito, corrigido movendo `rankIncidentsByQuery`/`incidentRecords`/`titleOf` pra
|
|
93
|
+
`lib/core/incident-search.ts` (D3 do plan, revisão de D1/D2 originais).
|
|
94
|
+
2. **Bug de parsing de argumentos**: a primeira versão do parser de `--role` computava
|
|
95
|
+
`roleIndex + 1` incondicionalmente (0 quando `roleIndex === -1`), engolindo o próprio objetivo
|
|
96
|
+
sempre que `--role` não era passado — reproduzido imediatamente ao testar manualmente
|
|
97
|
+
(`forja engineer "<objetivo>"` sem flags devolvia "Uso: ..."). Corrigido: cada índice só entra
|
|
98
|
+
no conjunto de "consumidos" quando a flag correspondente foi de fato encontrada.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Tasks: `forja engineer` — compor recomendação de agente + incidentes parecidos
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## T1 — extrair matching de incidentes + compor em `forja engineer`
|
|
11
|
+
- **Owner**: worker
|
|
12
|
+
- **Estimativa**: M
|
|
13
|
+
- **Depende de**: —
|
|
14
|
+
- **Paths**: `scripts/incident.ts`, `scripts/engineer.ts`
|
|
15
|
+
- **Done quando**:
|
|
16
|
+
- [ ] `rankIncidentsByQuery`/`incidentRecords` exportados, `incident:similar` inalterado em
|
|
17
|
+
comportamento (testes existentes continuam verdes)
|
|
18
|
+
- [ ] `forja engineer --role <role>` inclui agentes recomendados; sem `--role`, seção ausente
|
|
19
|
+
- [ ] `forja engineer` sempre inclui incidentes parecidos (vazio, não erro, se nenhum)
|
|
20
|
+
- [ ] `--json` estrutura as duas seções
|
|
21
|
+
|
|
22
|
+
## T2 — prova
|
|
23
|
+
- **Owner**: worker
|
|
24
|
+
- **Estimativa**: P
|
|
25
|
+
- **Depende de**: T1
|
|
26
|
+
- **Paths**: `test/engineer-cli.test.js`, `test/incident-cli.test.js` (verificação de não-regressão)
|
|
27
|
+
- **Done quando**:
|
|
28
|
+
- [ ] teste com agente registrado + `--role` mostra a recomendação certa
|
|
29
|
+
- [ ] teste com incidente registrado que casa com o objetivo aparece na seção
|
|
30
|
+
- [ ] `test/incident-cli.test.js` continua 100% verde (prova do refactor D2)
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Handoffs entre agentes
|
|
35
|
+
|
|
36
|
+
T1 → T2 sequencial. Sem handoff de papel.
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
# Plan: Engineering Evidence Ledger + `forja engineer` (façade)
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-09-01
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem técnica
|
|
8
|
+
|
|
9
|
+
Dois entregáveis pequenos, ambos composição pura sobre o que já existe — nenhuma tabela SQLite
|
|
10
|
+
nova, nenhuma lógica de decisão nova:
|
|
11
|
+
|
|
12
|
+
1. `packages/engineering/evidence` — `buildEvidenceLedger(input)`, função pura que recebe um
|
|
13
|
+
`RuntimeRun` + `AuditRecord[]`/`ApprovalRequest[]` já filtrados + `ArchitectureCheckReport`/
|
|
14
|
+
`ChangeRiskAssessment` opcionais e devolve o JSON agregado (`run/intent/agent/risk/
|
|
15
|
+
architectureCheck/tests/approvals/commit`). `scripts/evidence.ts` é o adapter (`evidence:show
|
|
16
|
+
<run-id>`) que busca esses dados reais via `SqliteRuntimeRunStore`/`SqliteAuditStore`/
|
|
17
|
+
`ApprovalLedger`.
|
|
18
|
+
2. `scripts/engineer.ts` — `forja engineer "<objetivo>"`, façade que chama, nesta ordem:
|
|
19
|
+
`ContextEngine.build()` (grafo, mesmo padrão de `scripts/demo-autonomy.ts`) →
|
|
20
|
+
`GraphLoop.contextRecords(objetivo)` filtrado a nós ADR/SPEC (SPEC-032, reaproveitado, não uma
|
|
21
|
+
busca nova) → `architecture:check` (não escopado — antes de haver diff, não há arquivo pra
|
|
22
|
+
escopar; ver D1) → `RiskEngine.assess()` (só com `--ref`; ver D1) → fluxo recomendado, parseado
|
|
23
|
+
de `docs/fluxo.md` (D2 — parser, não cópia hardcoded).
|
|
24
|
+
|
|
25
|
+
## 2. Módulos afetados
|
|
26
|
+
|
|
27
|
+
| Caminho | Mudança | Risco |
|
|
28
|
+
|---|---|---|
|
|
29
|
+
| `packages/engineering/evidence/src/index.ts` | novo — `buildEvidenceLedger` | Baixo — mapeamento puro |
|
|
30
|
+
| `scripts/evidence.ts` | novo — `evidence:show <run-id>` | Baixo |
|
|
31
|
+
| `scripts/engineer.ts` | novo — `engineer "<objetivo>" [--ref <ref>] [--json]` | Médio — orquestra 4 subsistemas, mas cada chamada já existe |
|
|
32
|
+
| `lib/core/registry.ts` | 2 comandos novos | Baixo |
|
|
33
|
+
| `test/evidence-ledger.test.js` (novo) | testes puros de `buildEvidenceLedger` | — |
|
|
34
|
+
| `test/engineer-cli.test.js` (novo) | fixture git isolada, `engineer` ponta a ponta | — |
|
|
35
|
+
|
|
36
|
+
## 3. Diagrama de fluxo
|
|
37
|
+
|
|
38
|
+
```text
|
|
39
|
+
forja engineer "<objetivo>" [--ref <ref>]
|
|
40
|
+
│
|
|
41
|
+
├─► ContextEngine.build({ objective, graph: GraphContextSource(graph.contextRecords) })
|
|
42
|
+
├─► graph.contextRecords(objetivo) filtrado a nós ADR/SPEC (SPEC-032)
|
|
43
|
+
├─► architecture:check (constitution.json real, SPEC-033) — não escopado
|
|
44
|
+
├─► RiskEngine.assess() (SPEC-034) — só se --ref foi passado
|
|
45
|
+
└─► fluxo recomendado — parseado da tabela "Etapa → papel → comando" de docs/fluxo.md
|
|
46
|
+
│
|
|
47
|
+
▼
|
|
48
|
+
saída de texto (default) ou --json (AC-3: nunca sintetiza além do que cada
|
|
49
|
+
subsistema já disse)
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## 4. Contratos (API/CLI/Schema)
|
|
53
|
+
|
|
54
|
+
```ts
|
|
55
|
+
// packages/engineering/evidence/src/index.ts
|
|
56
|
+
export interface EvidenceLedgerInput {
|
|
57
|
+
readonly run: RuntimeRun;
|
|
58
|
+
readonly auditRecords: readonly AuditRecord[];
|
|
59
|
+
readonly approvals: readonly ApprovalRequest[];
|
|
60
|
+
readonly architectureCheck?: ArchitectureCheckReport;
|
|
61
|
+
readonly riskAssessment?: ChangeRiskAssessment;
|
|
62
|
+
readonly commit?: string;
|
|
63
|
+
}
|
|
64
|
+
export interface EvidenceLedgerRecord {
|
|
65
|
+
readonly run: { readonly runId: string; readonly state: string; readonly startedAt: string; readonly updatedAt: string; readonly steps: number; readonly changedFiles: readonly string[] };
|
|
66
|
+
readonly intent: string;
|
|
67
|
+
readonly agent: AgentIdentity;
|
|
68
|
+
readonly architectureCheck?: ArchitectureCheckReport;
|
|
69
|
+
readonly risk?: ChangeRiskAssessment;
|
|
70
|
+
readonly tests?: EvaluationResult;
|
|
71
|
+
readonly approvals: readonly ApprovalRequest[];
|
|
72
|
+
readonly commit?: string;
|
|
73
|
+
}
|
|
74
|
+
export function buildEvidenceLedger(input: EvidenceLedgerInput): EvidenceLedgerRecord;
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
evidence:show <run-id>
|
|
79
|
+
engineer "<objetivo>" [--ref <ref>] [--json]
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## 5. Decisões e alternativas
|
|
83
|
+
|
|
84
|
+
**D1**: `forja engineer` roda `architecture:check` **não escopado** (relatório completo, não
|
|
85
|
+
filtrado a arquivos) e só inclui `risk` quando `--ref` é passado explicitamente. A visão original
|
|
86
|
+
lista os dois como parte fixa da composição, mas `forja engineer` roda **antes** de existir um
|
|
87
|
+
diff (é a ferramenta que orienta o início do trabalho) — não há arquivos afetados ainda para
|
|
88
|
+
escopar nenhum dos dois. Alternativa rejeitada: inferir arquivos afetados a partir do texto do
|
|
89
|
+
objetivo (aí sim seria síntese/adivinhação, proibido por AC-3). Quando `--ref` é passado (ex.:
|
|
90
|
+
objetivo já tem uma branch com commits), o risco entra completo, exatamente como `risk:assess`
|
|
91
|
+
computaria.
|
|
92
|
+
|
|
93
|
+
**D2**: o "fluxo recomendado" é **parseado** da tabela "Etapa → papel → comando" existente em
|
|
94
|
+
`docs/fluxo.md`, não copiado/hardcoded em `scripts/engineer.ts`. Só uma fonte de verdade para os 6
|
|
95
|
+
passos SDD/GSD — se `docs/fluxo.md` mudar, `forja engineer` acompanha sem exigir sincronização
|
|
96
|
+
manual. Parser é uma regex sobre linhas de tabela markdown (determinístico, sem LLM).
|
|
97
|
+
|
|
98
|
+
**D3**: `EvidenceLedgerInput` não busca dado nenhum sozinho — é `scripts/evidence.ts`/
|
|
99
|
+
`scripts/engineer.ts` que buscam `RuntimeRun`/`AuditRecord`/`ApprovalRequest` reais e montam o
|
|
100
|
+
input. `buildEvidenceLedger` é só o mapeamento — igual ao par engine-puro/CLI-adapter já usado em
|
|
101
|
+
`packages/engineering/architecture` e `packages/engineering/risk`.
|
|
102
|
+
|
|
103
|
+
## 6. Dependências
|
|
104
|
+
|
|
105
|
+
- SPEC-032 (`GraphLoop.contextRecords`), SPEC-033 (`checkConstitution`), SPEC-034
|
|
106
|
+
(`assessRisk`/`RiskEngine`) — todas já mergeadas/em PR quando este sprint começa.
|
|
107
|
+
- `packages/context.ContextEngine`/`GraphContextSource` (já existentes, mesmo padrão de
|
|
108
|
+
`scripts/demo-autonomy.ts`).
|
|
109
|
+
- `packages/adapter-sqlite.SqliteRuntimeRunStore`/`SqliteAuditStore` (já existentes).
|
|
110
|
+
|
|
111
|
+
## 7. Rollout
|
|
112
|
+
|
|
113
|
+
- [ ] Feature flag necessária? Não.
|
|
114
|
+
- [ ] Migração de dados existentes? Não.
|
|
115
|
+
- [ ] Doc/persona impactada? README (comandos novos).
|
|
116
|
+
|
|
117
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
118
|
+
|
|
119
|
+
Já registrado no apêndice de `specs/engineering-intelligence/spec.md`, §8 deste spec: se a saída de
|
|
120
|
+
`forja engineer` sobre um objetivo real não for usável sem edição, o design da façade (não os
|
|
121
|
+
engines subjacentes, já validados nos Sprints 1-2) é revisado.
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# Spec: Engineering Evidence Ledger + `forja engineer` (façade)
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-035
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprint 3
|
|
8
|
+
- **ADRs relacionadas**: ADR-0078; depende de SPEC-032, SPEC-033, SPEC-034 (a façade compõe as
|
|
9
|
+
três)
|
|
10
|
+
|
|
11
|
+
## 1. Problema
|
|
12
|
+
|
|
13
|
+
`AuditRecord`/`Observation`/`RuntimeRun` já são gravados por run, mas cada um em sua própria
|
|
14
|
+
tabela/stream — não existe uma view única "o que aconteceu neste run, do intent à evidência".
|
|
15
|
+
Separadamente, montar o quadro completo de uma mudança antes de começar (contexto + arquitetura +
|
|
16
|
+
risco + ADRs relevantes) hoje exige rodar vários comandos manualmente.
|
|
17
|
+
|
|
18
|
+
## 2. Proposta de valor
|
|
19
|
+
|
|
20
|
+
Uma view agregada por run (Evidence Ledger) e uma façade única (`forja engineer`) que compõe tudo
|
|
21
|
+
que já existe — sem introduzir nenhuma fonte de dado nova.
|
|
22
|
+
|
|
23
|
+
## 3. User stories
|
|
24
|
+
|
|
25
|
+
- **Como** governance, **quero** um registro append-only por run (`intent`, `agent`, `risk`,
|
|
26
|
+
`architectureCheck`, `tests`, `approvals`, `commit`), **para que** eu audite uma execução sem
|
|
27
|
+
cruzar manualmente quatro tabelas.
|
|
28
|
+
- **Como** desenvolvedor, **quero** `forja engineer "<objetivo>"` trazendo de uma vez arquitetura
|
|
29
|
+
afetada, ADRs relevantes, risco estimado e o fluxo recomendado, **para que** eu comece o trabalho
|
|
30
|
+
já orientado.
|
|
31
|
+
|
|
32
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
33
|
+
|
|
34
|
+
- [x] AC-1: view agregada (função pura sobre `AuditRecord`/`Observation`/`RuntimeRun` já
|
|
35
|
+
persistidos) produz o JSON no formato do exemplo da visão original (`run`, `intent`, `agent`,
|
|
36
|
+
`risk`, `architectureCheck`, `tests`, `approvals`, `commit`) — sem nova tabela SQLite além
|
|
37
|
+
das já existentes.
|
|
38
|
+
- [x] AC-2: `forja engineer "<objetivo>"` compõe, nesta ordem: `ContextEngine.build()` (já
|
|
39
|
+
existente) → `GraphLoop`/ADR relevantes (SPEC-032) → `architecture:check` (SPEC-033;
|
|
40
|
+
não escopado sem `--ref`, ver D1 do plan — não há diff ainda antes do trabalho começar) →
|
|
41
|
+
`RiskEngine.assess()` (SPEC-034, só com `--ref`) → fluxo recomendado (parseado de
|
|
42
|
+
`docs/fluxo.md`, D2 do plan — não reinventado).
|
|
43
|
+
- [x] AC-3: saída de `forja engineer` é estruturada (JSON opcional via `--json`, texto legível por
|
|
44
|
+
padrão) e nunca afirma nada que os componentes subjacentes não afirmaram — sem síntese de
|
|
45
|
+
LLM que possa alucinar arquitetura inexistente.
|
|
46
|
+
- [x] AC-4: nenhuma lógica de negócio nova em `forja engineer` além de composição e formatação —
|
|
47
|
+
qualquer decisão real continua nos engines que ela chama.
|
|
48
|
+
|
|
49
|
+
## 5. Escopo
|
|
50
|
+
|
|
51
|
+
**Dentro**: view agregada de evidência; façade `forja engineer` na versão mínima descrita acima
|
|
52
|
+
(sem seleção de time de agentes, que depende de Agent Identity/Reputation, fora de escopo).
|
|
53
|
+
|
|
54
|
+
**Fora**: seleção/recomendação de agente ou modelo (Fase 3); relatório de release
|
|
55
|
+
(`release:engineering-report`, feature separada da visão original, útil mas não bloqueante para
|
|
56
|
+
esta fundação); qualquer persistência nova — esta spec é puramente uma camada de leitura/composição
|
|
57
|
+
sobre dados que Sprints 1-2 e o framework já existente produzem.
|
|
58
|
+
|
|
59
|
+
## 6. NFRs / restrições
|
|
60
|
+
|
|
61
|
+
- View de evidência é derivável a qualquer momento a partir do que já está persistido — se
|
|
62
|
+
recalculada, produz o mesmo resultado (sem estado próprio para divergir).
|
|
63
|
+
- `forja engineer` nunca é a única fonte de verdade de nada — é sempre um resumo do que os
|
|
64
|
+
componentes subjacentes já disseram, rastreável de volta a cada um.
|
|
65
|
+
|
|
66
|
+
## 7. Riscos e mitigação
|
|
67
|
+
|
|
68
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
69
|
+
|---|---|---|---|
|
|
70
|
+
| `forja engineer` virar um "resumo de LLM" que esconde de onde vieram os fatos | Média (é a tentação óbvia de UX) | Alta (quebra auditabilidade) | AC-3 proíbe síntese que não seja rastreável componente-a-componente |
|
|
71
|
+
| Evidence Ledger duplicar dado já em `AuditRecord`/`Observation` | Baixa se implementado como view | Média (duas fontes de verdade) | AC-1 explicitamente "função pura sobre dados já persistidos", sem gravação própria |
|
|
72
|
+
|
|
73
|
+
## 8. Métricas de sucesso
|
|
74
|
+
|
|
75
|
+
Rodar `forja engineer` para uma mudança real proposta neste repositório produz uma saída que um
|
|
76
|
+
humano usaria sem edição para decidir se e como prosseguir — mesma métrica da spec master, aqui
|
|
77
|
+
verificada no nível do comando específico.
|
|
78
|
+
|
|
79
|
+
**Validado**: `forja engineer "compilar a architecture constitution deste repositório"` rodado
|
|
80
|
+
contra este próprio repositório (grafo real, 1013 arquivos). Produziu contexto relevante (specs e
|
|
81
|
+
testes de SPEC-033), ADRs/SPECs corretos (ADR-0078, SPEC-032/033/034), `architecture:check` real
|
|
82
|
+
(constitution já compilada neste repo) e o fluxo recomendado de `docs/fluxo.md` — utilizável sem
|
|
83
|
+
edição.
|
|
84
|
+
|
|
85
|
+
**Achado real corrigido durante a implementação (não um bug de lógica — um limite de exibição
|
|
86
|
+
ausente)**: a primeira execução sem `maxItems` devolveu **1013** referências de contexto (todo o
|
|
87
|
+
grafo do repositório caiu dentro do orçamento de 20k tokens), tornando a saída inutilizável sem
|
|
88
|
+
edição — o oposto do que esta métrica pede. Corrigido passando `maxItems: 10` para
|
|
89
|
+
`ContextEngine.build()` (as 10 mais relevantes, já ordenadas por `ContextEngine`); a lista completa
|
|
90
|
+
continua disponível via `context:smart`/`code:query`, que `forja engineer` não substitui.
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# Tasks: Engineering Evidence Ledger + `forja engineer`
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## T1 — `buildEvidenceLedger` (view pura) + `evidence:show`
|
|
11
|
+
- **Owner**: worker
|
|
12
|
+
- **Estimativa**: M
|
|
13
|
+
- **Depende de**: —
|
|
14
|
+
- **Paths**: `packages/engineering/evidence/src/index.ts`, `scripts/evidence.ts`, `lib/core/registry.ts`
|
|
15
|
+
- **Done quando**:
|
|
16
|
+
- [ ] `buildEvidenceLedger` mapeia `EvidenceLedgerInput` → `EvidenceLedgerRecord` sem inventar
|
|
17
|
+
nenhum campo que não veio no input (AC-1)
|
|
18
|
+
- [ ] `evidence:show <run-id>` busca `RuntimeRun` real (`SqliteRuntimeRunStore`), `AuditRecord`s
|
|
19
|
+
(`SqliteAuditStore`, filtrado por `aggregateId === runId`), `ApprovalRequest`s
|
|
20
|
+
(`ApprovalLedger`, filtrado por `correlationId === runId`)
|
|
21
|
+
- [ ] testes unitários (sem `fs`/rede): campos opcionais ausentes não aparecem como `null`
|
|
22
|
+
inventado; `run-id` inexistente é erro claro, não JSON vazio
|
|
23
|
+
|
|
24
|
+
## T2 — `forja engineer "<objetivo>"` façade
|
|
25
|
+
- **Owner**: worker
|
|
26
|
+
- **Estimativa**: G
|
|
27
|
+
- **Depende de**: T1 (reaproveita o mesmo padrão engine-puro/CLI-adapter)
|
|
28
|
+
- **Paths**: `scripts/engineer.ts`, `lib/core/registry.ts`
|
|
29
|
+
- **Done quando**:
|
|
30
|
+
- [ ] compõe, na ordem do plan: `ContextEngine.build()` → `contextRecords` filtrado a ADR/SPEC →
|
|
31
|
+
`architecture:check` não escopado → `RiskEngine.assess()` só com `--ref` (D1) → fluxo
|
|
32
|
+
recomendado parseado de `docs/fluxo.md` (D2)
|
|
33
|
+
- [ ] `--json` produz JSON estruturado; sem a flag, texto legível
|
|
34
|
+
- [ ] nenhuma string sintetizada além do que os componentes já disseram (grep manual: sem
|
|
35
|
+
chamada de LLM/heurística de texto livre em `scripts/engineer.ts`)
|
|
36
|
+
- [ ] `forja tools:doctor` continua verde
|
|
37
|
+
|
|
38
|
+
## T3 — prova sobre objetivo real deste repositório
|
|
39
|
+
- **Owner**: worker
|
|
40
|
+
- **Estimativa**: P
|
|
41
|
+
- **Depende de**: T2
|
|
42
|
+
- **Paths**: `test/engineer-cli.test.js` (novo)
|
|
43
|
+
- **Done quando**:
|
|
44
|
+
- [ ] fixture git isolada: `engineer "<objetivo>"` roda ponta a ponta (sem `--ref`) e produz
|
|
45
|
+
texto com todas as seções (contexto, ADRs relevantes, architecture:check, fluxo)
|
|
46
|
+
- [ ] com `--ref`, a seção de risco aparece com score real
|
|
47
|
+
- [ ] `evidence:show` recupera um run persistido de ponta a ponta
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Handoffs entre agentes
|
|
52
|
+
|
|
53
|
+
T1 → T2 → T3 sequencial. Sem handoff de papel — spec e plan já aprovados cobrem as decisões de
|
|
54
|
+
produto/arquitetura.
|