forjajs 2.0.3 → 2.0.4
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 +68 -59
- 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 +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -339
- package/README.pt-BR.md +345 -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/dashboard-client.jsx +10 -10
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +14 -2
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +54 -0
- package/dist/lib/core/registry.js +55 -0
- package/dist/lib/core/release.d.ts +53 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- 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/demo-autonomy.js +2 -2
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- 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/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/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- 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/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- 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 +23 -26
- 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/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -150
- 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/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/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/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/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/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/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- 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/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
- package/dist/scripts/server-persistence-probe.d.ts +0 -1
- package/dist/scripts/server-persistence-probe.js +0 -52
- package/dist/scripts/server-persistence-probe.mjs +0 -52
- /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
|
@@ -1,95 +1,95 @@
|
|
|
1
|
-
# Spec: orchestration-coherent
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-019
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: apk
|
|
6
|
-
- **ADRs relacionadas**: ADR-0021 (invariante > disciplina), ADR-0025 (coerência da doc — a mesma classe), ADR-0005 (handoff 7 campos), ADR-0020 (core/registry)
|
|
7
|
-
|
|
8
|
-
## 1. Problema
|
|
9
|
-
|
|
10
|
-
O nome do repositório é **orquestração multiagente** — e é a parte **menos harnessed** do framework.
|
|
11
|
-
A topologia de quem-orquestra-quem é descrita em **três lugares independentes**, e nada garante que
|
|
12
|
-
concordem:
|
|
13
|
-
|
|
14
|
-
1. `AGENTS.md` — a prosa: os papéis e a topologia.
|
|
15
|
-
2. `scripts/agent-router.ts` (`VALID_AGENTS`) — o código: para quem um handoff pode ser roteado.
|
|
16
|
-
3. `.claude/agents/*.md` — os sub-agents executáveis: quem, de fato, faz o trabalho.
|
|
17
|
-
|
|
18
|
-
Três descrições da mesma coisa divergem em silêncio. **E já divergem hoje** (medido antes de escrever
|
|
19
|
-
esta spec — a mesma prova que o `adr-refs` deu):
|
|
20
|
-
|
|
21
|
-
- **`worker`** está no `VALID_AGENTS` e no `AGENTS.md`, mas **não tem** `.claude/agent`. Um papel que
|
|
22
|
-
recebe handoff sem definição executável — prosa que o código não implementa.
|
|
23
|
-
- **`release-auditor`** é um sub-agent executável, mas **não está** no `VALID_AGENTS`. Um agente para
|
|
24
|
-
o qual o router não consegue rotear — implementação que a orquestração não alcança.
|
|
25
|
-
- **`architect`** (AGENTS.md) vs **`sdd-architect`** (router/agents) — o mesmo papel com dois nomes.
|
|
26
|
-
|
|
27
|
-
Pelo critério do ADR-0021, isto não é orquestração: é sugestão. A topologia vive por disciplina, e
|
|
28
|
-
está silenciosamente incoerente **agora**. Não é conhecimento que falta — é execução.
|
|
29
|
-
|
|
30
|
-
## 2. Proposta de valor
|
|
31
|
-
|
|
32
|
-
A topologia de agentes deixa de poder divergir em silêncio: **as três fontes de verdade
|
|
33
|
-
(AGENTS.md ↔ router ↔ .claude/agents) são conferidas por um gate**. Um papel sem agente executável,
|
|
34
|
-
um agente sem rota, um nome divergente — tudo reprova. A orquestração descrita passa a ser a
|
|
35
|
-
orquestração implementada.
|
|
36
|
-
|
|
37
|
-
## 3. User stories
|
|
38
|
-
|
|
39
|
-
- **Como** mantenedor, **quero** que um papel citado na topologia sem sub-agent executável **reprove**,
|
|
40
|
-
**para que** a orquestração não prometa um agente que não existe.
|
|
41
|
-
- **Como** mantenedor, **quero** que um sub-agent para o qual o router não roteia seja apontado,
|
|
42
|
-
**para que** eu não tenha implementação órfã que a orquestração nunca aciona.
|
|
43
|
-
- **Como** governança, **quero** rodar isso no `tools:doctor`, **para que** a coerência da topologia
|
|
44
|
-
seja um artefato verificável, não uma afirmação no README.
|
|
45
|
-
|
|
46
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
47
|
-
|
|
48
|
-
- [ ] AC-1: Um check `agent-topology` (no catálogo do `tools:doctor`, via runner de `checks.ts`)
|
|
49
|
-
cruza as três fontes e **reprova** (ou avisa) quando divergem:
|
|
50
|
-
- papel roteável (`VALID_AGENTS`, menos `user`) **sem** `.claude/agents/<papel>.md` → o router
|
|
51
|
-
promete um destino que não tem executor;
|
|
52
|
-
- `.claude/agents/<x>.md` que **não** está em `VALID_AGENTS` → agente executável que ninguém roteia;
|
|
53
|
-
- papel citado no `AGENTS.md` que não bate com nenhuma das outras fontes → prosa órfã.
|
|
54
|
-
- [ ] AC-2: `user` é reconhecido como destino válido de handoff **sem** exigir um agent (é o humano —
|
|
55
|
-
não tem `.claude/agent`, e tudo bem).
|
|
56
|
-
- [ ] AC-3: O check roda no `tools:doctor` e reporta as divergências reais que já existem hoje
|
|
57
|
-
(`worker`, `release-auditor`, `architect`/`sdd-architect`) — a prova de que a fronteira estava
|
|
58
|
-
descoberta.
|
|
59
|
-
- [ ] AC-4: Fechada a incoerência: cada divergência resolvida (criar o agent, ajustar o router, ou
|
|
60
|
-
alinhar o nome) até o check ficar verde — decidido caso a caso, não no atacado.
|
|
61
|
-
- [ ] AC-5: Lógica pura e testável (extrai a topologia de fontes injetáveis; testes com fixtures).
|
|
62
|
-
|
|
63
|
-
## 5. Escopo
|
|
64
|
-
|
|
65
|
-
**Dentro**: conferir a **coerência estrutural** da topologia — os nomes de papéis/agentes batem entre
|
|
66
|
-
as três fontes.
|
|
67
|
-
|
|
68
|
-
**Fora** (explícito — a fronteira honesta):
|
|
69
|
-
- **Rodar os agentes de IA autonomamente.** O framework não executa um loop de IA; quem aciona os
|
|
70
|
-
sub-agents é o Claude Code, no uso. Este gate prova que a topologia é *coerente e acionável*, não
|
|
71
|
-
que a IA fez um bom trabalho. "Provar que a orquestração produz bom output" não é harness — é
|
|
72
|
-
julgamento, e fica fora.
|
|
73
|
-
- Validar o *conteúdo* de cada `.claude/agent` (o prompt está bom?) — é qualidade, não topologia.
|
|
74
|
-
- Um motor de execução de handoffs em cadeia (state machine que dirige o fluxo) — pode ser SPEC
|
|
75
|
-
futura; esta fecha a **coerência**, o pré-requisito de qualquer execução.
|
|
76
|
-
|
|
77
|
-
## 6. NFRs / restrições
|
|
78
|
-
|
|
79
|
-
- **Compatibilidade**: só lê as três fontes; não muda o comportamento do router nem dos agents.
|
|
80
|
-
- **Severidade honesta**: divergência que quebra a orquestração (papel roteável sem executor) =
|
|
81
|
-
provável `critical`/`warn` a decidir no plan; nome divergente = `warn`. A calibração fica para o
|
|
82
|
-
plan, à luz do que as divergências reais pedem.
|
|
83
|
-
|
|
84
|
-
## 7. Riscos e mitigação
|
|
85
|
-
|
|
86
|
-
| Risco | Prob. | Impacto | Mitigação |
|
|
87
|
-
|---|---|---|---|
|
|
88
|
-
| O check vira ruído (muitos avisos aceitáveis) | M | M | severidade calibrada no plan; `user` e casos legítimos isentos (AC-2) |
|
|
89
|
-
| Alinhar os nomes quebra referências em prosa | B | M | AC-4 resolve caso a caso, com o gate confirmando cada passo |
|
|
90
|
-
|
|
91
|
-
## 8. Métricas de sucesso
|
|
92
|
-
|
|
93
|
-
As três divergências de hoje (`worker`, `release-auditor`, `architect`/`sdd-architect`) resolvidas, o
|
|
94
|
-
`agent-topology` verde no `tools:doctor`, e uma futura divergência (um agent novo sem rota, um papel
|
|
95
|
-
renomeado) pega pelo gate antes do merge. A orquestração descrita = a orquestração implementada.
|
|
1
|
+
# Spec: orchestration-coherent
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-019
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **ADRs relacionadas**: ADR-0021 (invariante > disciplina), ADR-0025 (coerência da doc — a mesma classe), ADR-0005 (handoff 7 campos), ADR-0020 (core/registry)
|
|
7
|
+
|
|
8
|
+
## 1. Problema
|
|
9
|
+
|
|
10
|
+
O nome do repositório é **orquestração multiagente** — e é a parte **menos harnessed** do framework.
|
|
11
|
+
A topologia de quem-orquestra-quem é descrita em **três lugares independentes**, e nada garante que
|
|
12
|
+
concordem:
|
|
13
|
+
|
|
14
|
+
1. `AGENTS.md` — a prosa: os papéis e a topologia.
|
|
15
|
+
2. `scripts/agent-router.ts` (`VALID_AGENTS`) — o código: para quem um handoff pode ser roteado.
|
|
16
|
+
3. `.claude/agents/*.md` — os sub-agents executáveis: quem, de fato, faz o trabalho.
|
|
17
|
+
|
|
18
|
+
Três descrições da mesma coisa divergem em silêncio. **E já divergem hoje** (medido antes de escrever
|
|
19
|
+
esta spec — a mesma prova que o `adr-refs` deu):
|
|
20
|
+
|
|
21
|
+
- **`worker`** está no `VALID_AGENTS` e no `AGENTS.md`, mas **não tem** `.claude/agent`. Um papel que
|
|
22
|
+
recebe handoff sem definição executável — prosa que o código não implementa.
|
|
23
|
+
- **`release-auditor`** é um sub-agent executável, mas **não está** no `VALID_AGENTS`. Um agente para
|
|
24
|
+
o qual o router não consegue rotear — implementação que a orquestração não alcança.
|
|
25
|
+
- **`architect`** (AGENTS.md) vs **`sdd-architect`** (router/agents) — o mesmo papel com dois nomes.
|
|
26
|
+
|
|
27
|
+
Pelo critério do ADR-0021, isto não é orquestração: é sugestão. A topologia vive por disciplina, e
|
|
28
|
+
está silenciosamente incoerente **agora**. Não é conhecimento que falta — é execução.
|
|
29
|
+
|
|
30
|
+
## 2. Proposta de valor
|
|
31
|
+
|
|
32
|
+
A topologia de agentes deixa de poder divergir em silêncio: **as três fontes de verdade
|
|
33
|
+
(AGENTS.md ↔ router ↔ .claude/agents) são conferidas por um gate**. Um papel sem agente executável,
|
|
34
|
+
um agente sem rota, um nome divergente — tudo reprova. A orquestração descrita passa a ser a
|
|
35
|
+
orquestração implementada.
|
|
36
|
+
|
|
37
|
+
## 3. User stories
|
|
38
|
+
|
|
39
|
+
- **Como** mantenedor, **quero** que um papel citado na topologia sem sub-agent executável **reprove**,
|
|
40
|
+
**para que** a orquestração não prometa um agente que não existe.
|
|
41
|
+
- **Como** mantenedor, **quero** que um sub-agent para o qual o router não roteia seja apontado,
|
|
42
|
+
**para que** eu não tenha implementação órfã que a orquestração nunca aciona.
|
|
43
|
+
- **Como** governança, **quero** rodar isso no `tools:doctor`, **para que** a coerência da topologia
|
|
44
|
+
seja um artefato verificável, não uma afirmação no README.
|
|
45
|
+
|
|
46
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
47
|
+
|
|
48
|
+
- [ ] AC-1: Um check `agent-topology` (no catálogo do `tools:doctor`, via runner de `checks.ts`)
|
|
49
|
+
cruza as três fontes e **reprova** (ou avisa) quando divergem:
|
|
50
|
+
- papel roteável (`VALID_AGENTS`, menos `user`) **sem** `.claude/agents/<papel>.md` → o router
|
|
51
|
+
promete um destino que não tem executor;
|
|
52
|
+
- `.claude/agents/<x>.md` que **não** está em `VALID_AGENTS` → agente executável que ninguém roteia;
|
|
53
|
+
- papel citado no `AGENTS.md` que não bate com nenhuma das outras fontes → prosa órfã.
|
|
54
|
+
- [ ] AC-2: `user` é reconhecido como destino válido de handoff **sem** exigir um agent (é o humano —
|
|
55
|
+
não tem `.claude/agent`, e tudo bem).
|
|
56
|
+
- [ ] AC-3: O check roda no `tools:doctor` e reporta as divergências reais que já existem hoje
|
|
57
|
+
(`worker`, `release-auditor`, `architect`/`sdd-architect`) — a prova de que a fronteira estava
|
|
58
|
+
descoberta.
|
|
59
|
+
- [ ] AC-4: Fechada a incoerência: cada divergência resolvida (criar o agent, ajustar o router, ou
|
|
60
|
+
alinhar o nome) até o check ficar verde — decidido caso a caso, não no atacado.
|
|
61
|
+
- [ ] AC-5: Lógica pura e testável (extrai a topologia de fontes injetáveis; testes com fixtures).
|
|
62
|
+
|
|
63
|
+
## 5. Escopo
|
|
64
|
+
|
|
65
|
+
**Dentro**: conferir a **coerência estrutural** da topologia — os nomes de papéis/agentes batem entre
|
|
66
|
+
as três fontes.
|
|
67
|
+
|
|
68
|
+
**Fora** (explícito — a fronteira honesta):
|
|
69
|
+
- **Rodar os agentes de IA autonomamente.** O framework não executa um loop de IA; quem aciona os
|
|
70
|
+
sub-agents é o Claude Code, no uso. Este gate prova que a topologia é *coerente e acionável*, não
|
|
71
|
+
que a IA fez um bom trabalho. "Provar que a orquestração produz bom output" não é harness — é
|
|
72
|
+
julgamento, e fica fora.
|
|
73
|
+
- Validar o *conteúdo* de cada `.claude/agent` (o prompt está bom?) — é qualidade, não topologia.
|
|
74
|
+
- Um motor de execução de handoffs em cadeia (state machine que dirige o fluxo) — pode ser SPEC
|
|
75
|
+
futura; esta fecha a **coerência**, o pré-requisito de qualquer execução.
|
|
76
|
+
|
|
77
|
+
## 6. NFRs / restrições
|
|
78
|
+
|
|
79
|
+
- **Compatibilidade**: só lê as três fontes; não muda o comportamento do router nem dos agents.
|
|
80
|
+
- **Severidade honesta**: divergência que quebra a orquestração (papel roteável sem executor) =
|
|
81
|
+
provável `critical`/`warn` a decidir no plan; nome divergente = `warn`. A calibração fica para o
|
|
82
|
+
plan, à luz do que as divergências reais pedem.
|
|
83
|
+
|
|
84
|
+
## 7. Riscos e mitigação
|
|
85
|
+
|
|
86
|
+
| Risco | Prob. | Impacto | Mitigação |
|
|
87
|
+
|---|---|---|---|
|
|
88
|
+
| O check vira ruído (muitos avisos aceitáveis) | M | M | severidade calibrada no plan; `user` e casos legítimos isentos (AC-2) |
|
|
89
|
+
| Alinhar os nomes quebra referências em prosa | B | M | AC-4 resolve caso a caso, com o gate confirmando cada passo |
|
|
90
|
+
|
|
91
|
+
## 8. Métricas de sucesso
|
|
92
|
+
|
|
93
|
+
As três divergências de hoje (`worker`, `release-auditor`, `architect`/`sdd-architect`) resolvidas, o
|
|
94
|
+
`agent-topology` verde no `tools:doctor`, e uma futura divergência (um agent novo sem rota, um papel
|
|
95
|
+
renomeado) pega pelo gate antes do merge. A orquestração descrita = a orquestração implementada.
|
|
@@ -1,61 +1,61 @@
|
|
|
1
|
-
# Spec: pipeline-sdd-e-orquestracao
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-001
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: framework-team
|
|
6
|
-
- **Criado em**: 2026-05-10
|
|
7
|
-
- **Sprint alvo**: refator-2026-05
|
|
8
|
-
- **ADRs relacionadas**: ADR-0007 (SDD), ADR-0008 (sub-agents executáveis)
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
O framework declara "spec-driven" e "orquestração" no AGENTS.md mas não há mecânica: nenhum comando força spec antes de código, e os 6 papéis de AGENTS.md não têm sub-agents executáveis em `.claude/agents/`. Handoffs vivem como markdown manual em `memory/50-orchestration/handoffs/`. Resultado: cada agente reinventa formato, retrabalho alto, decisões perdidas.
|
|
12
|
-
|
|
13
|
-
## 2. Proposta de valor
|
|
14
|
-
Toda feature não-trivial passa por `spec → plan → tasks` validado por CLI, e tarefas são roteadas para sub-agents Claude com handoff rastreável em SQLite. Spec-driven e orquestração deixam de ser slogans.
|
|
15
|
-
|
|
16
|
-
## 3. User stories
|
|
17
|
-
- **Como** Product Agent, **quero** rascunhar uma spec em 5 min com template, **para que** o backlog tenha entrada estruturada
|
|
18
|
-
- **Como** SDD Architect, **quero** que `spec:plan` só funcione com spec aprovada, **para que** ninguém pule etapa
|
|
19
|
-
- **Como** Worker, **quero** receber handoff com 7 campos via tabela SQLite, **para que** eu não pesque contexto em markdown
|
|
20
|
-
- **Como** Governance Agent, **quero** rodar `project:check` que falha se há código novo sem spec ativa, **para que** dívida não se acumule
|
|
21
|
-
|
|
22
|
-
## 4. Critérios de aceite
|
|
23
|
-
- [x] AC-1: `npm run spec:new <feature>` cria diretório com spec.md preenchido a partir do template
|
|
24
|
-
- [x] AC-2: `npm run spec:plan` e `spec:tasks` só rodam se a fase anterior está `approved+`
|
|
25
|
-
- [x] AC-3: `npm run spec:check` lista status de todas as features e falha com exit≠0 se inconsistente
|
|
26
|
-
- [ ] AC-4: `.claude/agents/*.md` para 6 papéis funcionando como sub-agents
|
|
27
|
-
- [ ] AC-5: handoffs registrados em tabela SQLite (`universal.db.handoffs`) com 7 campos da ADR-0005
|
|
28
|
-
- [ ] AC-6: `agent:route` aceita handoff e dispara sub-agent correspondente
|
|
29
|
-
- [ ] AC-7: hook `UserPromptSubmit` injeta smart-context automaticamente
|
|
30
|
-
|
|
31
|
-
## 5. Escopo
|
|
32
|
-
**Dentro**:
|
|
33
|
-
- CLI `spec-cli.mjs` (new/plan/tasks/check)
|
|
34
|
-
- Templates em `specs/_templates/`
|
|
35
|
-
- 6 sub-agents em `.claude/agents/`
|
|
36
|
-
- Tabela `handoffs` no `universal.db` + script `agent-router.mjs`
|
|
37
|
-
- Hooks em `.claude/settings.json`
|
|
38
|
-
|
|
39
|
-
**Fora**:
|
|
40
|
-
- Embeddings semânticos (mantém FTS5)
|
|
41
|
-
- UI/dashboard interativo de specs
|
|
42
|
-
- Migrar handoffs antigos em markdown — só novos
|
|
43
|
-
- Sub-agents para outros provedores (Copilot, Gemini) — só Claude nesta rodada
|
|
44
|
-
|
|
45
|
-
## 6. NFRs
|
|
46
|
-
- Performance: `spec:check` < 500ms em 100 specs
|
|
47
|
-
- Compatibilidade: scripts npm existentes não quebram
|
|
48
|
-
- Segurança: nenhum script gera token/secret embedido
|
|
49
|
-
- Observabilidade: cada invocação de sub-agent loga em `60-runs/`
|
|
50
|
-
|
|
51
|
-
## 7. Riscos
|
|
52
|
-
| Risco | P | I | Mitigação |
|
|
53
|
-
|---|---|---|---|
|
|
54
|
-
| Hook UserPromptSubmit causa latência | M | M | Cache por hash do prompt + cap de bytes |
|
|
55
|
-
| Sub-agents disputam contexto | B | A | Roteamento explícito via handoff, sem broadcast |
|
|
56
|
-
| SDD vira burocracia | M | A | Lista clara em README de "quando NÃO precisa de spec" |
|
|
57
|
-
|
|
58
|
-
## 8. Métricas de sucesso (30d)
|
|
59
|
-
- ≥80% das features novas atravessam o pipeline completo
|
|
60
|
-
- 0 PRs mergeados com `spec:check` falhando
|
|
61
|
-
- Tempo médio spec→tasks < 1 dia
|
|
1
|
+
# Spec: pipeline-sdd-e-orquestracao
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-001
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: framework-team
|
|
6
|
+
- **Criado em**: 2026-05-10
|
|
7
|
+
- **Sprint alvo**: refator-2026-05
|
|
8
|
+
- **ADRs relacionadas**: ADR-0007 (SDD), ADR-0008 (sub-agents executáveis)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O framework declara "spec-driven" e "orquestração" no AGENTS.md mas não há mecânica: nenhum comando força spec antes de código, e os 6 papéis de AGENTS.md não têm sub-agents executáveis em `.claude/agents/`. Handoffs vivem como markdown manual em `memory/50-orchestration/handoffs/`. Resultado: cada agente reinventa formato, retrabalho alto, decisões perdidas.
|
|
12
|
+
|
|
13
|
+
## 2. Proposta de valor
|
|
14
|
+
Toda feature não-trivial passa por `spec → plan → tasks` validado por CLI, e tarefas são roteadas para sub-agents Claude com handoff rastreável em SQLite. Spec-driven e orquestração deixam de ser slogans.
|
|
15
|
+
|
|
16
|
+
## 3. User stories
|
|
17
|
+
- **Como** Product Agent, **quero** rascunhar uma spec em 5 min com template, **para que** o backlog tenha entrada estruturada
|
|
18
|
+
- **Como** SDD Architect, **quero** que `spec:plan` só funcione com spec aprovada, **para que** ninguém pule etapa
|
|
19
|
+
- **Como** Worker, **quero** receber handoff com 7 campos via tabela SQLite, **para que** eu não pesque contexto em markdown
|
|
20
|
+
- **Como** Governance Agent, **quero** rodar `project:check` que falha se há código novo sem spec ativa, **para que** dívida não se acumule
|
|
21
|
+
|
|
22
|
+
## 4. Critérios de aceite
|
|
23
|
+
- [x] AC-1: `npm run spec:new <feature>` cria diretório com spec.md preenchido a partir do template
|
|
24
|
+
- [x] AC-2: `npm run spec:plan` e `spec:tasks` só rodam se a fase anterior está `approved+`
|
|
25
|
+
- [x] AC-3: `npm run spec:check` lista status de todas as features e falha com exit≠0 se inconsistente
|
|
26
|
+
- [ ] AC-4: `.claude/agents/*.md` para 6 papéis funcionando como sub-agents
|
|
27
|
+
- [ ] AC-5: handoffs registrados em tabela SQLite (`universal.db.handoffs`) com 7 campos da ADR-0005
|
|
28
|
+
- [ ] AC-6: `agent:route` aceita handoff e dispara sub-agent correspondente
|
|
29
|
+
- [ ] AC-7: hook `UserPromptSubmit` injeta smart-context automaticamente
|
|
30
|
+
|
|
31
|
+
## 5. Escopo
|
|
32
|
+
**Dentro**:
|
|
33
|
+
- CLI `spec-cli.mjs` (new/plan/tasks/check)
|
|
34
|
+
- Templates em `specs/_templates/`
|
|
35
|
+
- 6 sub-agents em `.claude/agents/`
|
|
36
|
+
- Tabela `handoffs` no `universal.db` + script `agent-router.mjs`
|
|
37
|
+
- Hooks em `.claude/settings.json`
|
|
38
|
+
|
|
39
|
+
**Fora**:
|
|
40
|
+
- Embeddings semânticos (mantém FTS5)
|
|
41
|
+
- UI/dashboard interativo de specs
|
|
42
|
+
- Migrar handoffs antigos em markdown — só novos
|
|
43
|
+
- Sub-agents para outros provedores (Copilot, Gemini) — só Claude nesta rodada
|
|
44
|
+
|
|
45
|
+
## 6. NFRs
|
|
46
|
+
- Performance: `spec:check` < 500ms em 100 specs
|
|
47
|
+
- Compatibilidade: scripts npm existentes não quebram
|
|
48
|
+
- Segurança: nenhum script gera token/secret embedido
|
|
49
|
+
- Observabilidade: cada invocação de sub-agent loga em `60-runs/`
|
|
50
|
+
|
|
51
|
+
## 7. Riscos
|
|
52
|
+
| Risco | P | I | Mitigação |
|
|
53
|
+
|---|---|---|---|
|
|
54
|
+
| Hook UserPromptSubmit causa latência | M | M | Cache por hash do prompt + cap de bytes |
|
|
55
|
+
| Sub-agents disputam contexto | B | A | Roteamento explícito via handoff, sem broadcast |
|
|
56
|
+
| SDD vira burocracia | M | A | Lista clara em README de "quando NÃO precisa de spec" |
|
|
57
|
+
|
|
58
|
+
## 8. Métricas de sucesso (30d)
|
|
59
|
+
- ≥80% das features novas atravessam o pipeline completo
|
|
60
|
+
- 0 PRs mergeados com `spec:check` falhando
|
|
61
|
+
- Tempo médio spec→tasks < 1 dia
|
|
@@ -1,96 +1,96 @@
|
|
|
1
|
-
# Spec: project-smoke
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-015
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: apk
|
|
6
|
-
- **Criado em**: 2026-07-19
|
|
7
|
-
- **ADRs relacionadas**: [ADR-0024](../../memory/90-decisions/0024-release-gate.md) (gate do tarball — o padrão), [ADR-0023](../../memory/90-decisions/0023-doctor-como-gate-do-nucleo.md) (doctor), [ADR-0020](../../memory/90-decisions/0020-forja-core-cli-unica.md) (core/registry)
|
|
8
|
-
|
|
9
|
-
## 1. Problema
|
|
10
|
-
|
|
11
|
-
O `release:check` guarda uma fronteira: **o repositório mente sobre o pacote**. Existe a *mesma
|
|
12
|
-
classe de bug um nível acima*, e ela está **descoberta**: nada prova que `forja project:new` gera um
|
|
13
|
-
projeto que de fato **é coerente e roda**.
|
|
14
|
-
|
|
15
|
-
O gerador escreve arquivos a partir de templates (`{{FEATURE}}`, `{{ID}}`, blocos de `scripts`, configs
|
|
16
|
-
multi-IA). Cada um desses é uma oportunidade de mentira silenciosa:
|
|
17
|
-
|
|
18
|
-
- um placeholder `{{...}}` que vaza para o output porque o gerador esqueceu de substituir;
|
|
19
|
-
- um `package.json` gerado que não é JSON válido, ou sem os scripts que os docs prometem;
|
|
20
|
-
- a estrutura de memória incompleta (falta um diretório crítico que o resto assume);
|
|
21
|
-
- no limite: o projeto gerado simplesmente **não buildar**.
|
|
22
|
-
|
|
23
|
-
Hoje só descobrimos isso quando um usuário gera um projeto e ele quebra — exatamente o modo de falha
|
|
24
|
-
que o `release:check` existe para eliminar, só que na saída do gerador em vez do tarball. **Não é
|
|
25
|
-
conhecimento que falta** (o `structure-validator` já sabe validar estrutura). **É execução**: nada
|
|
26
|
-
roda o gerador de ponta a ponta e reprova.
|
|
27
|
-
|
|
28
|
-
## 2. Proposta de valor
|
|
29
|
-
|
|
30
|
-
Gerar um projeto deixa de ser um ato de fé: **nenhuma mudança no gerador passa sem prova de que o
|
|
31
|
-
projeto gerado é coerente**, e a prova é gerada pelo harness — não pela lembrança de quem tocou no
|
|
32
|
-
template.
|
|
33
|
-
|
|
34
|
-
## 3. User stories
|
|
35
|
-
|
|
36
|
-
- **Como** quem mantém o gerador, **quero** que uma mudança que quebra o output **reprove no CI**,
|
|
37
|
-
**para que** eu não descubra pela issue de um usuário.
|
|
38
|
-
- **Como** usuário do `forjajs`, **quero** que `forja project:new` me entregue um projeto sem
|
|
39
|
-
placeholders vazados nem `package.json` quebrado, **para que** eu não perca a primeira hora
|
|
40
|
-
depurando o scaffold em vez do meu produto.
|
|
41
|
-
- **Como** governança, **quero** a evidência de que o projeto gerado buildar **no log do CI**,
|
|
42
|
-
**para que** "o gerador funciona" seja um artefato verificável e não uma afirmação.
|
|
43
|
-
|
|
44
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
45
|
-
|
|
46
|
-
- [ ] AC-1: Existe `forja project:smoke` (entrada no registry, ADR-0020) que **gera um projeto num
|
|
47
|
-
diretório temporário isolado** e reprova com exit ≠ 0 em qualquer falha abaixo. Limpa o tmp
|
|
48
|
-
sempre, inclusive quando um check lança.
|
|
49
|
-
- [ ] AC-2: **Zero placeholder vazado.** Nenhum arquivo gerado contém `{{...}}` não substituído.
|
|
50
|
-
É o bug mais barato de introduzir e o mais visível para o usuário.
|
|
51
|
-
- [ ] AC-3: **Todo `package.json` gerado é JSON válido** e contém os scripts que o gerador anuncia.
|
|
52
|
-
- [ ] AC-4: **Estrutura íntegra.** `validateProjectStructure` do projeto gerado passa (reusa o
|
|
53
|
-
`structure-validator` existente — uma máquina, não duas).
|
|
54
|
-
- [ ] AC-5: **Modo `--full` (opt-in): o projeto buildar de verdade.** `npm install` + `npm run build`
|
|
55
|
-
no backend gerado, num ambiente isolado. É o análogo do clean-install do `release:check`:
|
|
56
|
-
caro, roda antes de release, não a cada commit.
|
|
57
|
-
- [ ] AC-6: **Reusa o runner de `checks.mjs`.** O `project:smoke` é um catálogo novo consumido pelo
|
|
58
|
-
mesmo runner do doctor/release — mesma máquina de probes, `severity`, cascata por `dependsOn`.
|
|
59
|
-
- [ ] AC-7: O gate roda no CI (tier barato) e o `tools:doctor` **não** o executa (custo alto; é um
|
|
60
|
-
gate próprio, como o `release:check`).
|
|
61
|
-
|
|
62
|
-
## 5. Escopo
|
|
63
|
-
|
|
64
|
-
**Dentro**:
|
|
65
|
-
- Comando `project:smoke` + catálogo `lib/core/project-smoke.mjs`.
|
|
66
|
-
- Isolamento em tmp + limpeza garantida (padrão do `withCleanInstall`).
|
|
67
|
-
- Tier barato (placeholders, JSON, estrutura) no CI; tier `--full` (install+build) opt-in.
|
|
68
|
-
|
|
69
|
-
**Fora** (explícito):
|
|
70
|
-
- Rodar a suíte de testes do projeto gerado (`npm test`) — fica para uma iteração futura; build já
|
|
71
|
-
prova que os imports resolvem.
|
|
72
|
-
- Validar os boilerplates de stack individualmente (`api-rest`, `saas`, …) — este gate cobre o
|
|
73
|
-
caminho default do gerador; a matriz de stacks é escopo à parte.
|
|
74
|
-
- Publicar o projeto gerado em qualquer lugar.
|
|
75
|
-
|
|
76
|
-
## 6. NFRs / restrições
|
|
77
|
-
|
|
78
|
-
- **Compatibilidade**: não muda o comportamento de `init-project`/`create-memory-nest-kit` — só os
|
|
79
|
-
observa. O gerador não sabe que está sendo auditado.
|
|
80
|
-
- **Isolamento**: o tier `--full` roda `npm install` fora do repo, com o ambiente limpo (sem
|
|
81
|
-
`NODE_PATH`/`npm_config_*` herdados — a lição do `release:check`).
|
|
82
|
-
- **Custo**: o tier barato roda em segundos (sem rede); o `--full` é minutos (baixa NestJS).
|
|
83
|
-
|
|
84
|
-
## 7. Riscos e mitigação
|
|
85
|
-
|
|
86
|
-
| Risco | Probabilidade | Impacto | Mitigação |
|
|
87
|
-
|---|---|---|---|
|
|
88
|
-
| `--full` flaky por rede (npm registry) | M | M | tier barato é o gate de CI; `--full` é opt-in/pré-release, como o clean-install |
|
|
89
|
-
| Gerador tem efeitos colaterais fora do tmp | B | A | gerar sempre com destino explícito no tmp; o teste falha alto se escrever fora |
|
|
90
|
-
| Duplicar lógica de validação | B | M | reusar `structure-validator` e o runner de `checks.mjs` — AC-4/AC-6 |
|
|
91
|
-
|
|
92
|
-
## 8. Métricas de sucesso
|
|
93
|
-
|
|
94
|
-
30 dias após o release: **pelo menos uma regressão do gerador pega pelo gate antes do merge** (a
|
|
95
|
-
prova de que a fronteira estava mesmo descoberta), e **zero issue de usuário sobre scaffold quebrado**
|
|
96
|
-
(placeholder vazado, `package.json` inválido).
|
|
1
|
+
# Spec: project-smoke
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-015
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-07-19
|
|
7
|
+
- **ADRs relacionadas**: [ADR-0024](../../memory/90-decisions/0024-release-gate.md) (gate do tarball — o padrão), [ADR-0023](../../memory/90-decisions/0023-doctor-como-gate-do-nucleo.md) (doctor), [ADR-0020](../../memory/90-decisions/0020-forja-core-cli-unica.md) (core/registry)
|
|
8
|
+
|
|
9
|
+
## 1. Problema
|
|
10
|
+
|
|
11
|
+
O `release:check` guarda uma fronteira: **o repositório mente sobre o pacote**. Existe a *mesma
|
|
12
|
+
classe de bug um nível acima*, e ela está **descoberta**: nada prova que `forja project:new` gera um
|
|
13
|
+
projeto que de fato **é coerente e roda**.
|
|
14
|
+
|
|
15
|
+
O gerador escreve arquivos a partir de templates (`{{FEATURE}}`, `{{ID}}`, blocos de `scripts`, configs
|
|
16
|
+
multi-IA). Cada um desses é uma oportunidade de mentira silenciosa:
|
|
17
|
+
|
|
18
|
+
- um placeholder `{{...}}` que vaza para o output porque o gerador esqueceu de substituir;
|
|
19
|
+
- um `package.json` gerado que não é JSON válido, ou sem os scripts que os docs prometem;
|
|
20
|
+
- a estrutura de memória incompleta (falta um diretório crítico que o resto assume);
|
|
21
|
+
- no limite: o projeto gerado simplesmente **não buildar**.
|
|
22
|
+
|
|
23
|
+
Hoje só descobrimos isso quando um usuário gera um projeto e ele quebra — exatamente o modo de falha
|
|
24
|
+
que o `release:check` existe para eliminar, só que na saída do gerador em vez do tarball. **Não é
|
|
25
|
+
conhecimento que falta** (o `structure-validator` já sabe validar estrutura). **É execução**: nada
|
|
26
|
+
roda o gerador de ponta a ponta e reprova.
|
|
27
|
+
|
|
28
|
+
## 2. Proposta de valor
|
|
29
|
+
|
|
30
|
+
Gerar um projeto deixa de ser um ato de fé: **nenhuma mudança no gerador passa sem prova de que o
|
|
31
|
+
projeto gerado é coerente**, e a prova é gerada pelo harness — não pela lembrança de quem tocou no
|
|
32
|
+
template.
|
|
33
|
+
|
|
34
|
+
## 3. User stories
|
|
35
|
+
|
|
36
|
+
- **Como** quem mantém o gerador, **quero** que uma mudança que quebra o output **reprove no CI**,
|
|
37
|
+
**para que** eu não descubra pela issue de um usuário.
|
|
38
|
+
- **Como** usuário do `forjajs`, **quero** que `forja project:new` me entregue um projeto sem
|
|
39
|
+
placeholders vazados nem `package.json` quebrado, **para que** eu não perca a primeira hora
|
|
40
|
+
depurando o scaffold em vez do meu produto.
|
|
41
|
+
- **Como** governança, **quero** a evidência de que o projeto gerado buildar **no log do CI**,
|
|
42
|
+
**para que** "o gerador funciona" seja um artefato verificável e não uma afirmação.
|
|
43
|
+
|
|
44
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
45
|
+
|
|
46
|
+
- [ ] AC-1: Existe `forja project:smoke` (entrada no registry, ADR-0020) que **gera um projeto num
|
|
47
|
+
diretório temporário isolado** e reprova com exit ≠ 0 em qualquer falha abaixo. Limpa o tmp
|
|
48
|
+
sempre, inclusive quando um check lança.
|
|
49
|
+
- [ ] AC-2: **Zero placeholder vazado.** Nenhum arquivo gerado contém `{{...}}` não substituído.
|
|
50
|
+
É o bug mais barato de introduzir e o mais visível para o usuário.
|
|
51
|
+
- [ ] AC-3: **Todo `package.json` gerado é JSON válido** e contém os scripts que o gerador anuncia.
|
|
52
|
+
- [ ] AC-4: **Estrutura íntegra.** `validateProjectStructure` do projeto gerado passa (reusa o
|
|
53
|
+
`structure-validator` existente — uma máquina, não duas).
|
|
54
|
+
- [ ] AC-5: **Modo `--full` (opt-in): o projeto buildar de verdade.** `npm install` + `npm run build`
|
|
55
|
+
no backend gerado, num ambiente isolado. É o análogo do clean-install do `release:check`:
|
|
56
|
+
caro, roda antes de release, não a cada commit.
|
|
57
|
+
- [ ] AC-6: **Reusa o runner de `checks.mjs`.** O `project:smoke` é um catálogo novo consumido pelo
|
|
58
|
+
mesmo runner do doctor/release — mesma máquina de probes, `severity`, cascata por `dependsOn`.
|
|
59
|
+
- [ ] AC-7: O gate roda no CI (tier barato) e o `tools:doctor` **não** o executa (custo alto; é um
|
|
60
|
+
gate próprio, como o `release:check`).
|
|
61
|
+
|
|
62
|
+
## 5. Escopo
|
|
63
|
+
|
|
64
|
+
**Dentro**:
|
|
65
|
+
- Comando `project:smoke` + catálogo `lib/core/project-smoke.mjs`.
|
|
66
|
+
- Isolamento em tmp + limpeza garantida (padrão do `withCleanInstall`).
|
|
67
|
+
- Tier barato (placeholders, JSON, estrutura) no CI; tier `--full` (install+build) opt-in.
|
|
68
|
+
|
|
69
|
+
**Fora** (explícito):
|
|
70
|
+
- Rodar a suíte de testes do projeto gerado (`npm test`) — fica para uma iteração futura; build já
|
|
71
|
+
prova que os imports resolvem.
|
|
72
|
+
- Validar os boilerplates de stack individualmente (`api-rest`, `saas`, …) — este gate cobre o
|
|
73
|
+
caminho default do gerador; a matriz de stacks é escopo à parte.
|
|
74
|
+
- Publicar o projeto gerado em qualquer lugar.
|
|
75
|
+
|
|
76
|
+
## 6. NFRs / restrições
|
|
77
|
+
|
|
78
|
+
- **Compatibilidade**: não muda o comportamento de `init-project`/`create-memory-nest-kit` — só os
|
|
79
|
+
observa. O gerador não sabe que está sendo auditado.
|
|
80
|
+
- **Isolamento**: o tier `--full` roda `npm install` fora do repo, com o ambiente limpo (sem
|
|
81
|
+
`NODE_PATH`/`npm_config_*` herdados — a lição do `release:check`).
|
|
82
|
+
- **Custo**: o tier barato roda em segundos (sem rede); o `--full` é minutos (baixa NestJS).
|
|
83
|
+
|
|
84
|
+
## 7. Riscos e mitigação
|
|
85
|
+
|
|
86
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
87
|
+
|---|---|---|---|
|
|
88
|
+
| `--full` flaky por rede (npm registry) | M | M | tier barato é o gate de CI; `--full` é opt-in/pré-release, como o clean-install |
|
|
89
|
+
| Gerador tem efeitos colaterais fora do tmp | B | A | gerar sempre com destino explícito no tmp; o teste falha alto se escrever fora |
|
|
90
|
+
| Duplicar lógica de validação | B | M | reusar `structure-validator` e o runner de `checks.mjs` — AC-4/AC-6 |
|
|
91
|
+
|
|
92
|
+
## 8. Métricas de sucesso
|
|
93
|
+
|
|
94
|
+
30 dias após o release: **pelo menos uma regressão do gerador pega pelo gate antes do merge** (a
|
|
95
|
+
prova de que a fronteira estava mesmo descoberta), e **zero issue de usuário sobre scaffold quebrado**
|
|
96
|
+
(placeholder vazado, `package.json` inválido).
|
|
@@ -1,58 +1,58 @@
|
|
|
1
|
-
# Spec: project-upgrade
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-018
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: apk
|
|
6
|
-
- **ADRs relacionadas**: ADR-0020 (core/registry), ADR-0024 (isolamento em tmp — o padrão do gate)
|
|
7
|
-
|
|
8
|
-
## 1. Problema
|
|
9
|
-
|
|
10
|
-
O framework **gera** projetos, mas nunca soube **atualizar** um já gerado. Quando o Forja evolui —
|
|
11
|
-
uma pasta de memória nova (`70-summaries/`), um agent novo, um config multi-IA novo — quem gerou numa
|
|
12
|
-
versão antiga fica preso nela. A única saída era regerar (e perder o código) ou copiar peças na mão
|
|
13
|
-
(e esquecer quais). É a metade que falta de todo scaffolder.
|
|
14
|
-
|
|
15
|
-
## 2. Proposta de valor
|
|
16
|
-
|
|
17
|
-
Um projeto gerado consegue **incorporar as peças novas do scaffold** sem regerar e sem risco: o
|
|
18
|
-
comando traz o que falta, e **nunca** toca no que já existe (onde mora a edição do usuário).
|
|
19
|
-
|
|
20
|
-
## 3. User stories
|
|
21
|
-
|
|
22
|
-
- **Como** dono de um projeto gerado numa versão antiga, **quero** puxar as peças novas do framework,
|
|
23
|
-
**para que** eu não fique preso na versão em que gerei nem perca meu código regerando.
|
|
24
|
-
- **Como** dev cauteloso, **quero** um dry-run antes de qualquer escrita, **para que** eu veja
|
|
25
|
-
exatamente o que será adicionado.
|
|
26
|
-
|
|
27
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
28
|
-
|
|
29
|
-
- [x] AC-1: `forja project:upgrade` gera um scaffold fresco num tmp isolado, faz o diff contra o
|
|
30
|
-
projeto e lista **só os arquivos que faltam** (dry-run por padrão).
|
|
31
|
-
- [x] AC-2: **Aditivo, nunca sobrescreve.** Um arquivo que já existe no projeto não é listado nem
|
|
32
|
-
tocado — é território do usuário. Provado em teste (edição preservada sob `--apply`).
|
|
33
|
-
- [x] AC-3: `--apply` copia as peças novas, criando diretórios; reporta quantas.
|
|
34
|
-
- [x] AC-4: `--project <path>` (default `cwd`); reprova cedo se o alvo não parece um projeto Forja
|
|
35
|
-
(sem `AGENTS.md`). Limpa o tmp sempre.
|
|
36
|
-
- [x] AC-5: Lógica pura e testável (`lib/project-upgrade.ts`), com fixtures.
|
|
37
|
-
|
|
38
|
-
## 5. Escopo
|
|
39
|
-
|
|
40
|
-
**Dentro**: adicionar arquivos de scaffold ausentes (memória, agents, prompts, skills, configs).
|
|
41
|
-
|
|
42
|
-
**Fora** (explícito — a fronteira de segurança):
|
|
43
|
-
- **Sobrescrever ou fazer merge de arquivos existentes.** É onde vive a edição do usuário; MVP nunca
|
|
44
|
-
toca. Um "upgrade com 3-way merge" é trabalho de outra spec, com muito mais risco.
|
|
45
|
-
- Migrar dados (memória indexada, `.context`) — são runtime, ficam de fora do diff.
|
|
46
|
-
- Atualizar `package.json`/dependências do backend — é código do usuário.
|
|
47
|
-
|
|
48
|
-
## 6. NFRs / restrições
|
|
49
|
-
|
|
50
|
-
- **Segurança acima de tudo**: additive-only é a invariante. `applyUpgrade` reconfere `existsSync`
|
|
51
|
-
antes de cada cópia (paranoia: jamais sobrescreve).
|
|
52
|
-
- **Isolamento**: o scaffold fresco nasce num tmp com ambiente limpo (`NODE_PATH`/`npm_config_*`
|
|
53
|
-
removidos — a lição do `release:check`), e o tmp é limpo sempre.
|
|
54
|
-
|
|
55
|
-
## 7. Métricas de sucesso
|
|
56
|
-
|
|
57
|
-
Um projeto gerado numa versão antiga incorpora as peças de uma versão nova sem perder nenhuma linha
|
|
58
|
-
de código do usuário — e o dono revê o diff antes de commitar.
|
|
1
|
+
# Spec: project-upgrade
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-018
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **ADRs relacionadas**: ADR-0020 (core/registry), ADR-0024 (isolamento em tmp — o padrão do gate)
|
|
7
|
+
|
|
8
|
+
## 1. Problema
|
|
9
|
+
|
|
10
|
+
O framework **gera** projetos, mas nunca soube **atualizar** um já gerado. Quando o Forja evolui —
|
|
11
|
+
uma pasta de memória nova (`70-summaries/`), um agent novo, um config multi-IA novo — quem gerou numa
|
|
12
|
+
versão antiga fica preso nela. A única saída era regerar (e perder o código) ou copiar peças na mão
|
|
13
|
+
(e esquecer quais). É a metade que falta de todo scaffolder.
|
|
14
|
+
|
|
15
|
+
## 2. Proposta de valor
|
|
16
|
+
|
|
17
|
+
Um projeto gerado consegue **incorporar as peças novas do scaffold** sem regerar e sem risco: o
|
|
18
|
+
comando traz o que falta, e **nunca** toca no que já existe (onde mora a edição do usuário).
|
|
19
|
+
|
|
20
|
+
## 3. User stories
|
|
21
|
+
|
|
22
|
+
- **Como** dono de um projeto gerado numa versão antiga, **quero** puxar as peças novas do framework,
|
|
23
|
+
**para que** eu não fique preso na versão em que gerei nem perca meu código regerando.
|
|
24
|
+
- **Como** dev cauteloso, **quero** um dry-run antes de qualquer escrita, **para que** eu veja
|
|
25
|
+
exatamente o que será adicionado.
|
|
26
|
+
|
|
27
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
28
|
+
|
|
29
|
+
- [x] AC-1: `forja project:upgrade` gera um scaffold fresco num tmp isolado, faz o diff contra o
|
|
30
|
+
projeto e lista **só os arquivos que faltam** (dry-run por padrão).
|
|
31
|
+
- [x] AC-2: **Aditivo, nunca sobrescreve.** Um arquivo que já existe no projeto não é listado nem
|
|
32
|
+
tocado — é território do usuário. Provado em teste (edição preservada sob `--apply`).
|
|
33
|
+
- [x] AC-3: `--apply` copia as peças novas, criando diretórios; reporta quantas.
|
|
34
|
+
- [x] AC-4: `--project <path>` (default `cwd`); reprova cedo se o alvo não parece um projeto Forja
|
|
35
|
+
(sem `AGENTS.md`). Limpa o tmp sempre.
|
|
36
|
+
- [x] AC-5: Lógica pura e testável (`lib/project-upgrade.ts`), com fixtures.
|
|
37
|
+
|
|
38
|
+
## 5. Escopo
|
|
39
|
+
|
|
40
|
+
**Dentro**: adicionar arquivos de scaffold ausentes (memória, agents, prompts, skills, configs).
|
|
41
|
+
|
|
42
|
+
**Fora** (explícito — a fronteira de segurança):
|
|
43
|
+
- **Sobrescrever ou fazer merge de arquivos existentes.** É onde vive a edição do usuário; MVP nunca
|
|
44
|
+
toca. Um "upgrade com 3-way merge" é trabalho de outra spec, com muito mais risco.
|
|
45
|
+
- Migrar dados (memória indexada, `.context`) — são runtime, ficam de fora do diff.
|
|
46
|
+
- Atualizar `package.json`/dependências do backend — é código do usuário.
|
|
47
|
+
|
|
48
|
+
## 6. NFRs / restrições
|
|
49
|
+
|
|
50
|
+
- **Segurança acima de tudo**: additive-only é a invariante. `applyUpgrade` reconfere `existsSync`
|
|
51
|
+
antes de cada cópia (paranoia: jamais sobrescreve).
|
|
52
|
+
- **Isolamento**: o scaffold fresco nasce num tmp com ambiente limpo (`NODE_PATH`/`npm_config_*`
|
|
53
|
+
removidos — a lição do `release:check`), e o tmp é limpo sempre.
|
|
54
|
+
|
|
55
|
+
## 7. Métricas de sucesso
|
|
56
|
+
|
|
57
|
+
Um projeto gerado numa versão antiga incorpora as peças de uma versão nova sem perder nenhuma linha
|
|
58
|
+
de código do usuário — e o dono revê o diff antes de commitar.
|