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,48 +1,48 @@
|
|
|
1
|
-
# 06 — Clean Architecture Calibrada
|
|
2
|
-
|
|
3
|
-
Boilerplate NestJS + TypeScript com **DDD e Clean Architecture onde se paga, e caminho enxuto onde
|
|
4
|
-
não** — a calibração é o ponto, não as camadas.
|
|
5
|
-
|
|
6
|
-
## A ideia em uma frase
|
|
7
|
-
|
|
8
|
-
Camadas custam arquivos e tokens; você paga por elas quando protegem uma regra de negócio, e evita
|
|
9
|
-
quando é CRUD. Este boilerplate mostra **os dois padrões lado a lado** para você ver o critério, não
|
|
10
|
-
decorar dogma. Leia o [`WHEN-CLEAN-WHEN-LEAN.md`](WHEN-CLEAN-WHEN-LEAN.md) — é o coração.
|
|
11
|
-
|
|
12
|
-
## Estrutura
|
|
13
|
-
|
|
14
|
-
```
|
|
15
|
-
backend/src/
|
|
16
|
-
modules/orders/ # FATIA RICA — 4 camadas, porque há invariante de negócio
|
|
17
|
-
domain/ # agregado + value objects + PORTA (interface). Puro: zero @nestjs/ORM
|
|
18
|
-
application/ # use-cases (contratos tipados, legíveis sem a implementação)
|
|
19
|
-
infrastructure/ # adapter TypeORM (implementa a porta) + mapper domínio↔persistência
|
|
20
|
-
presentation/ # controller fino + DTOs HTTP
|
|
21
|
-
modules/products/ # CAMINHO ENXUTO — 1 camada, porque é CRUD sem regra
|
|
22
|
-
shared/ # Result, base de domínio
|
|
23
|
-
backend/test/ # a invariante testada SEM subir o Nest
|
|
24
|
-
memory/30-domains/ # o contexto de cada domínio na linguagem ubíqua (leia antes do código)
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
## A regra de dependência
|
|
28
|
-
|
|
29
|
-
Tudo aponta para **dentro**: `presentation` e `infrastructure` → `application` → `domain`. O domínio
|
|
30
|
-
não importa nada de fora. A infra **implementa** portas que o domínio declara. A inversão acontece no
|
|
31
|
-
módulo, numa linha: `{ provide: ORDER_REPOSITORY, useClass: TypeOrmOrderRepository }`.
|
|
32
|
-
|
|
33
|
-
## Economia de token (ADR-0009)
|
|
34
|
-
|
|
35
|
-
O agente lê `memory/30-domains/<ctx>/context.md` e a **assinatura** do use-case — e sabe o que a
|
|
36
|
-
feature faz sem carregar a implementação. As camadas dão pontos de entrada previsíveis (regra no
|
|
37
|
-
agregado, orquestração no use-case, persistência na infra). Arquitetura como compressão de contexto.
|
|
38
|
-
|
|
39
|
-
## Rodando
|
|
40
|
-
|
|
41
|
-
```bash
|
|
42
|
-
npm install
|
|
43
|
-
npm run start:dev # sobe o Nest (precisa de DATABASE_URL Postgres)
|
|
44
|
-
npm test # roda os testes de domínio — sem Postgres, sem Nest
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
O `npm test` prova a premissa: a invariante do domínio (`test/orders/place-order.spec.ts`) roda
|
|
48
|
-
instanciando só o agregado. Se um teste de regra precisar do framework, o domínio vazou.
|
|
1
|
+
# 06 — Clean Architecture Calibrada
|
|
2
|
+
|
|
3
|
+
Boilerplate NestJS + TypeScript com **DDD e Clean Architecture onde se paga, e caminho enxuto onde
|
|
4
|
+
não** — a calibração é o ponto, não as camadas.
|
|
5
|
+
|
|
6
|
+
## A ideia em uma frase
|
|
7
|
+
|
|
8
|
+
Camadas custam arquivos e tokens; você paga por elas quando protegem uma regra de negócio, e evita
|
|
9
|
+
quando é CRUD. Este boilerplate mostra **os dois padrões lado a lado** para você ver o critério, não
|
|
10
|
+
decorar dogma. Leia o [`WHEN-CLEAN-WHEN-LEAN.md`](WHEN-CLEAN-WHEN-LEAN.md) — é o coração.
|
|
11
|
+
|
|
12
|
+
## Estrutura
|
|
13
|
+
|
|
14
|
+
```
|
|
15
|
+
backend/src/
|
|
16
|
+
modules/orders/ # FATIA RICA — 4 camadas, porque há invariante de negócio
|
|
17
|
+
domain/ # agregado + value objects + PORTA (interface). Puro: zero @nestjs/ORM
|
|
18
|
+
application/ # use-cases (contratos tipados, legíveis sem a implementação)
|
|
19
|
+
infrastructure/ # adapter TypeORM (implementa a porta) + mapper domínio↔persistência
|
|
20
|
+
presentation/ # controller fino + DTOs HTTP
|
|
21
|
+
modules/products/ # CAMINHO ENXUTO — 1 camada, porque é CRUD sem regra
|
|
22
|
+
shared/ # Result, base de domínio
|
|
23
|
+
backend/test/ # a invariante testada SEM subir o Nest
|
|
24
|
+
memory/30-domains/ # o contexto de cada domínio na linguagem ubíqua (leia antes do código)
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## A regra de dependência
|
|
28
|
+
|
|
29
|
+
Tudo aponta para **dentro**: `presentation` e `infrastructure` → `application` → `domain`. O domínio
|
|
30
|
+
não importa nada de fora. A infra **implementa** portas que o domínio declara. A inversão acontece no
|
|
31
|
+
módulo, numa linha: `{ provide: ORDER_REPOSITORY, useClass: TypeOrmOrderRepository }`.
|
|
32
|
+
|
|
33
|
+
## Economia de token (ADR-0009)
|
|
34
|
+
|
|
35
|
+
O agente lê `memory/30-domains/<ctx>/context.md` e a **assinatura** do use-case — e sabe o que a
|
|
36
|
+
feature faz sem carregar a implementação. As camadas dão pontos de entrada previsíveis (regra no
|
|
37
|
+
agregado, orquestração no use-case, persistência na infra). Arquitetura como compressão de contexto.
|
|
38
|
+
|
|
39
|
+
## Rodando
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npm install
|
|
43
|
+
npm run start:dev # sobe o Nest (precisa de DATABASE_URL Postgres)
|
|
44
|
+
npm test # roda os testes de domínio — sem Postgres, sem Nest
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
O `npm test` prova a premissa: a invariante do domínio (`test/orders/place-order.spec.ts`) roda
|
|
48
|
+
instanciando só o agregado. Se um teste de regra precisar do framework, o domínio vazou.
|
|
@@ -1,71 +1,71 @@
|
|
|
1
|
-
# Quando Clean Architecture, quando enxuto
|
|
2
|
-
|
|
3
|
-
Este boilerplate tem **os dois padrões lado a lado, de propósito**:
|
|
4
|
-
|
|
5
|
-
- `modules/orders/` — as quatro camadas (domain / application / infrastructure / presentation).
|
|
6
|
-
- `modules/products/` — uma camada só (controller → repositório direto).
|
|
7
|
-
|
|
8
|
-
Não é inconsistência. É a decisão mais importante da arquitetura, materializada em código: **camadas
|
|
9
|
-
custam tokens e arquivos; você paga por elas quando compram algo, e evita quando não.**
|
|
10
|
-
|
|
11
|
-
## O critério
|
|
12
|
-
|
|
13
|
-
Use o padrão de `orders/` (camadas + porta + use-case) quando **pelo menos uma** for verdade:
|
|
14
|
-
|
|
15
|
-
- Há **invariante de negócio** — uma regra que não pode ser violada em estado nenhum ("não envia sem
|
|
16
|
-
pagamento", "saldo não fica negativo"). A regra precisa de um lar único: o domínio.
|
|
17
|
-
- Há **máquina de estados** — o objeto tem transições legais e ilegais.
|
|
18
|
-
- A regra precisa ser **testada sem subir o framework**, ou sobreviver a troca de infraestrutura.
|
|
19
|
-
- Múltiplos casos de uso operam o mesmo conceito de formas diferentes.
|
|
20
|
-
|
|
21
|
-
Use o padrão de `products/` (uma camada) quando **todas** forem verdade:
|
|
22
|
-
|
|
23
|
-
- É **CRUD** — criar, ler, atualizar, apagar, sem regra além de validação de formato.
|
|
24
|
-
- O "modelo" é a tabela: não há comportamento a proteger.
|
|
25
|
-
- Não há transição de estado que importe.
|
|
26
|
-
|
|
27
|
-
## O que a medição diz (e o que ela desmente)
|
|
28
|
-
|
|
29
|
-
Rode `forja token:economy` — ele mede a **mesma feature** (place + ship, com a invariante "não envia
|
|
30
|
-
sem pagamento") nos dois estilos, por cenário. Os números, hoje, para a fatia `orders`:
|
|
31
|
-
|
|
32
|
-
| Cenário | Clean (camadas) | Flat (uma camada) | Clean vs flat |
|
|
33
|
-
|---|---|---|---|
|
|
34
|
-
| Entender a feature inteira | ~3684 tok (12 arq.) | ~1298 tok (3 arq.) | **+184%** |
|
|
35
|
-
| Mudar a regra de envio (contexto mínimo) | ~1419 tok (3 arq.) | ~910 tok (1 arq.) | **+56%** |
|
|
36
|
-
|
|
37
|
-
**Para uma feature pequena, o clean-arch custa MAIS tokens — nos dois cenários.** A camada cobra
|
|
38
|
-
adiantado, e para duas operações ela não se paga. Se alguém te vendeu "Clean Architecture economiza
|
|
39
|
-
tokens" como regra geral, os números acima desmentem — e tudo bem que desmintam.
|
|
40
|
-
|
|
41
|
-
Então **por que promover `orders` a camadas não é desperdício?** Porque a economia de token não é
|
|
42
|
-
função do total de arquivos; é função do **tamanho da feature e do número de casos de uso**. O ganho
|
|
43
|
-
aparece quando o service flat cresce: com dez casos de uso, mudar uma regra obriga a ler um service
|
|
44
|
-
gordo inteiro (tudo misturado), enquanto no clean o agregado isolado continua pequeno e o `context.md`
|
|
45
|
-
aponta direto para ele. O cruzamento existe; para a `orders` de duas operações, ele ainda não chegou.
|
|
46
|
-
|
|
47
|
-
O que justifica as camadas em `orders` **não é token** — é **isolamento e testabilidade**: a
|
|
48
|
-
invariante tem um lar único, testável sem subir o Nest, e sobrevive à troca de ORM. Token é
|
|
49
|
-
consequência a partir de certa escala, não a razão. Por isso o critério acima fala de invariante e
|
|
50
|
-
máquina de estados, não de contagem de linhas.
|
|
51
|
-
|
|
52
|
-
O `products/` raso segue certo pelo mesmo motivo invertido: um CRUD não tem invariante para isolar,
|
|
53
|
-
então as camadas seriam só custo — de token, medido, e de leitura.
|
|
54
|
-
|
|
55
|
-
## Onde a economia de token realmente está: a memória, não as camadas
|
|
56
|
-
|
|
57
|
-
Se as camadas custam token, de onde vem a economia que o Forja promete? Da **memória persistente**,
|
|
58
|
-
não da arquitetura. O `token:economy` mede também esse eixo: para mexer numa regra da fatia, ler o
|
|
59
|
-
`context.md` (o mapa do domínio) + ir direto ao agregado custa **−61%** vs varrer a fatia inteira no
|
|
60
|
-
frio, sem mapa. E essa economia **compõe**: gerar o projeto do zero é custo único; o mapa poupa a
|
|
61
|
-
cada tarefa futura, pela vida do projeto. É a tese do ADR-0009, agora medida.
|
|
62
|
-
|
|
63
|
-
Ou seja: você paga tokens para levantar o scaffold, e a memória devolve a partir da segunda tarefa.
|
|
64
|
-
As camadas de `orders` são sobre isolamento; a economia de token é da memória. São coisas diferentes,
|
|
65
|
-
e confundi-las foi o erro que a medição corrigiu.
|
|
66
|
-
|
|
67
|
-
## A regra de ouro
|
|
68
|
-
|
|
69
|
-
**Comece enxuto. Promova quando a primeira invariante aparecer.** Um `products/` que ganha uma regra
|
|
70
|
-
de negócio de verdade (ex.: "não pode desativar produto com pedido aberto") é o sinal de promover
|
|
71
|
-
para o padrão de `orders/` — não antes. Arquitetura antecipada é dívida de token paga adiantado.
|
|
1
|
+
# Quando Clean Architecture, quando enxuto
|
|
2
|
+
|
|
3
|
+
Este boilerplate tem **os dois padrões lado a lado, de propósito**:
|
|
4
|
+
|
|
5
|
+
- `modules/orders/` — as quatro camadas (domain / application / infrastructure / presentation).
|
|
6
|
+
- `modules/products/` — uma camada só (controller → repositório direto).
|
|
7
|
+
|
|
8
|
+
Não é inconsistência. É a decisão mais importante da arquitetura, materializada em código: **camadas
|
|
9
|
+
custam tokens e arquivos; você paga por elas quando compram algo, e evita quando não.**
|
|
10
|
+
|
|
11
|
+
## O critério
|
|
12
|
+
|
|
13
|
+
Use o padrão de `orders/` (camadas + porta + use-case) quando **pelo menos uma** for verdade:
|
|
14
|
+
|
|
15
|
+
- Há **invariante de negócio** — uma regra que não pode ser violada em estado nenhum ("não envia sem
|
|
16
|
+
pagamento", "saldo não fica negativo"). A regra precisa de um lar único: o domínio.
|
|
17
|
+
- Há **máquina de estados** — o objeto tem transições legais e ilegais.
|
|
18
|
+
- A regra precisa ser **testada sem subir o framework**, ou sobreviver a troca de infraestrutura.
|
|
19
|
+
- Múltiplos casos de uso operam o mesmo conceito de formas diferentes.
|
|
20
|
+
|
|
21
|
+
Use o padrão de `products/` (uma camada) quando **todas** forem verdade:
|
|
22
|
+
|
|
23
|
+
- É **CRUD** — criar, ler, atualizar, apagar, sem regra além de validação de formato.
|
|
24
|
+
- O "modelo" é a tabela: não há comportamento a proteger.
|
|
25
|
+
- Não há transição de estado que importe.
|
|
26
|
+
|
|
27
|
+
## O que a medição diz (e o que ela desmente)
|
|
28
|
+
|
|
29
|
+
Rode `forja token:economy` — ele mede a **mesma feature** (place + ship, com a invariante "não envia
|
|
30
|
+
sem pagamento") nos dois estilos, por cenário. Os números, hoje, para a fatia `orders`:
|
|
31
|
+
|
|
32
|
+
| Cenário | Clean (camadas) | Flat (uma camada) | Clean vs flat |
|
|
33
|
+
|---|---|---|---|
|
|
34
|
+
| Entender a feature inteira | ~3684 tok (12 arq.) | ~1298 tok (3 arq.) | **+184%** |
|
|
35
|
+
| Mudar a regra de envio (contexto mínimo) | ~1419 tok (3 arq.) | ~910 tok (1 arq.) | **+56%** |
|
|
36
|
+
|
|
37
|
+
**Para uma feature pequena, o clean-arch custa MAIS tokens — nos dois cenários.** A camada cobra
|
|
38
|
+
adiantado, e para duas operações ela não se paga. Se alguém te vendeu "Clean Architecture economiza
|
|
39
|
+
tokens" como regra geral, os números acima desmentem — e tudo bem que desmintam.
|
|
40
|
+
|
|
41
|
+
Então **por que promover `orders` a camadas não é desperdício?** Porque a economia de token não é
|
|
42
|
+
função do total de arquivos; é função do **tamanho da feature e do número de casos de uso**. O ganho
|
|
43
|
+
aparece quando o service flat cresce: com dez casos de uso, mudar uma regra obriga a ler um service
|
|
44
|
+
gordo inteiro (tudo misturado), enquanto no clean o agregado isolado continua pequeno e o `context.md`
|
|
45
|
+
aponta direto para ele. O cruzamento existe; para a `orders` de duas operações, ele ainda não chegou.
|
|
46
|
+
|
|
47
|
+
O que justifica as camadas em `orders` **não é token** — é **isolamento e testabilidade**: a
|
|
48
|
+
invariante tem um lar único, testável sem subir o Nest, e sobrevive à troca de ORM. Token é
|
|
49
|
+
consequência a partir de certa escala, não a razão. Por isso o critério acima fala de invariante e
|
|
50
|
+
máquina de estados, não de contagem de linhas.
|
|
51
|
+
|
|
52
|
+
O `products/` raso segue certo pelo mesmo motivo invertido: um CRUD não tem invariante para isolar,
|
|
53
|
+
então as camadas seriam só custo — de token, medido, e de leitura.
|
|
54
|
+
|
|
55
|
+
## Onde a economia de token realmente está: a memória, não as camadas
|
|
56
|
+
|
|
57
|
+
Se as camadas custam token, de onde vem a economia que o Forja promete? Da **memória persistente**,
|
|
58
|
+
não da arquitetura. O `token:economy` mede também esse eixo: para mexer numa regra da fatia, ler o
|
|
59
|
+
`context.md` (o mapa do domínio) + ir direto ao agregado custa **−61%** vs varrer a fatia inteira no
|
|
60
|
+
frio, sem mapa. E essa economia **compõe**: gerar o projeto do zero é custo único; o mapa poupa a
|
|
61
|
+
cada tarefa futura, pela vida do projeto. É a tese do ADR-0009, agora medida.
|
|
62
|
+
|
|
63
|
+
Ou seja: você paga tokens para levantar o scaffold, e a memória devolve a partir da segunda tarefa.
|
|
64
|
+
As camadas de `orders` são sobre isolamento; a economia de token é da memória. São coisas diferentes,
|
|
65
|
+
e confundi-las foi o erro que a medição corrigiu.
|
|
66
|
+
|
|
67
|
+
## A regra de ouro
|
|
68
|
+
|
|
69
|
+
**Comece enxuto. Promova quando a primeira invariante aparecer.** Um `products/` que ganha uma regra
|
|
70
|
+
de negócio de verdade (ex.: "não pode desativar produto com pedido aberto") é o sinal de promover
|
|
71
|
+
para o padrão de `orders/` — não antes. Arquitetura antecipada é dívida de token paga adiantado.
|
|
@@ -1,43 +1,43 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "clean-arch-backend",
|
|
3
|
-
"version": "0.1.0",
|
|
4
|
-
"private": true,
|
|
5
|
-
"scripts": {
|
|
6
|
-
"build": "nest build",
|
|
7
|
-
"start": "nest start",
|
|
8
|
-
"start:dev": "nest start --watch",
|
|
9
|
-
"start:prod": "node dist/main",
|
|
10
|
-
"lint": "eslint \"src/**/*.ts\" --max-warnings=0",
|
|
11
|
-
"test": "jest",
|
|
12
|
-
"test:watch": "jest --watch",
|
|
13
|
-
"test:cov": "jest --coverage",
|
|
14
|
-
"test:e2e": "jest --config test/jest-e2e.json"
|
|
15
|
-
},
|
|
16
|
-
"dependencies": {
|
|
17
|
-
"@nestjs/common": "^11.0.0",
|
|
18
|
-
"@nestjs/core": "^11.0.0",
|
|
19
|
-
"@nestjs/platform-express": "^11.0.0",
|
|
20
|
-
"@nestjs/typeorm": "^11.0.0",
|
|
21
|
-
"class-transformer": "^0.5.1",
|
|
22
|
-
"class-validator": "^0.14.1",
|
|
23
|
-
"pg": "^8.13.0",
|
|
24
|
-
"reflect-metadata": "^0.2.2",
|
|
25
|
-
"rxjs": "^7.8.1",
|
|
26
|
-
"typeorm": "^0.3.20"
|
|
27
|
-
},
|
|
28
|
-
"devDependencies": {
|
|
29
|
-
"@nestjs/testing": "^11.0.0",
|
|
30
|
-
"@types/jest": "^29.5.0",
|
|
31
|
-
"@types/node": "^22.0.0",
|
|
32
|
-
"jest": "^29.7.0",
|
|
33
|
-
"ts-jest": "^29.2.0",
|
|
34
|
-
"typescript": "^5.6.0"
|
|
35
|
-
},
|
|
36
|
-
"jest": {
|
|
37
|
-
"moduleFileExtensions": ["js", "json", "ts"],
|
|
38
|
-
"rootDir": ".",
|
|
39
|
-
"testRegex": ".*\\.spec\\.ts$",
|
|
40
|
-
"transform": { "^.+\\.ts$": "ts-jest" },
|
|
41
|
-
"testEnvironment": "node"
|
|
42
|
-
}
|
|
43
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "clean-arch-backend",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"private": true,
|
|
5
|
+
"scripts": {
|
|
6
|
+
"build": "nest build",
|
|
7
|
+
"start": "nest start",
|
|
8
|
+
"start:dev": "nest start --watch",
|
|
9
|
+
"start:prod": "node dist/main",
|
|
10
|
+
"lint": "eslint \"src/**/*.ts\" --max-warnings=0",
|
|
11
|
+
"test": "jest",
|
|
12
|
+
"test:watch": "jest --watch",
|
|
13
|
+
"test:cov": "jest --coverage",
|
|
14
|
+
"test:e2e": "jest --config test/jest-e2e.json"
|
|
15
|
+
},
|
|
16
|
+
"dependencies": {
|
|
17
|
+
"@nestjs/common": "^11.0.0",
|
|
18
|
+
"@nestjs/core": "^11.0.0",
|
|
19
|
+
"@nestjs/platform-express": "^11.0.0",
|
|
20
|
+
"@nestjs/typeorm": "^11.0.0",
|
|
21
|
+
"class-transformer": "^0.5.1",
|
|
22
|
+
"class-validator": "^0.14.1",
|
|
23
|
+
"pg": "^8.13.0",
|
|
24
|
+
"reflect-metadata": "^0.2.2",
|
|
25
|
+
"rxjs": "^7.8.1",
|
|
26
|
+
"typeorm": "^0.3.20"
|
|
27
|
+
},
|
|
28
|
+
"devDependencies": {
|
|
29
|
+
"@nestjs/testing": "^11.0.0",
|
|
30
|
+
"@types/jest": "^29.5.0",
|
|
31
|
+
"@types/node": "^22.0.0",
|
|
32
|
+
"jest": "^29.7.0",
|
|
33
|
+
"ts-jest": "^29.2.0",
|
|
34
|
+
"typescript": "^5.6.0"
|
|
35
|
+
},
|
|
36
|
+
"jest": {
|
|
37
|
+
"moduleFileExtensions": ["js", "json", "ts"],
|
|
38
|
+
"rootDir": ".",
|
|
39
|
+
"testRegex": ".*\\.spec\\.ts$",
|
|
40
|
+
"transform": { "^.+\\.ts$": "ts-jest" },
|
|
41
|
+
"testEnvironment": "node"
|
|
42
|
+
}
|
|
43
|
+
}
|
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
import { Module } from '@nestjs/common';
|
|
2
|
-
import { TypeOrmModule } from '@nestjs/typeorm';
|
|
3
|
-
import { OrdersModule } from './modules/orders/orders.module';
|
|
4
|
-
import { ProductsModule } from './modules/products/products.module';
|
|
5
|
-
import { OrderOrmEntity } from './modules/orders/infrastructure/order.orm-entity';
|
|
6
|
-
import { Product } from './modules/products/product.entity';
|
|
7
|
-
|
|
8
|
-
@Module({
|
|
9
|
-
imports: [
|
|
10
|
-
TypeOrmModule.forRoot({
|
|
11
|
-
type: 'postgres',
|
|
12
|
-
url: process.env.DATABASE_URL,
|
|
13
|
-
entities: [OrderOrmEntity, Product],
|
|
14
|
-
synchronize: process.env.NODE_ENV !== 'production', // dev only
|
|
15
|
-
}),
|
|
16
|
-
OrdersModule,
|
|
17
|
-
ProductsModule,
|
|
18
|
-
],
|
|
19
|
-
})
|
|
20
|
-
export class AppModule {}
|
|
1
|
+
import { Module } from '@nestjs/common';
|
|
2
|
+
import { TypeOrmModule } from '@nestjs/typeorm';
|
|
3
|
+
import { OrdersModule } from './modules/orders/orders.module';
|
|
4
|
+
import { ProductsModule } from './modules/products/products.module';
|
|
5
|
+
import { OrderOrmEntity } from './modules/orders/infrastructure/order.orm-entity';
|
|
6
|
+
import { Product } from './modules/products/product.entity';
|
|
7
|
+
|
|
8
|
+
@Module({
|
|
9
|
+
imports: [
|
|
10
|
+
TypeOrmModule.forRoot({
|
|
11
|
+
type: 'postgres',
|
|
12
|
+
url: process.env.DATABASE_URL,
|
|
13
|
+
entities: [OrderOrmEntity, Product],
|
|
14
|
+
synchronize: process.env.NODE_ENV !== 'production', // dev only
|
|
15
|
+
}),
|
|
16
|
+
OrdersModule,
|
|
17
|
+
ProductsModule,
|
|
18
|
+
],
|
|
19
|
+
})
|
|
20
|
+
export class AppModule {}
|
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
import { NestFactory } from '@nestjs/core';
|
|
2
|
-
import { ValidationPipe } from '@nestjs/common';
|
|
3
|
-
import { AppModule } from './app.module';
|
|
4
|
-
|
|
5
|
-
async function bootstrap() {
|
|
6
|
-
const app = await NestFactory.create(AppModule);
|
|
7
|
-
app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true }));
|
|
8
|
-
await app.listen(process.env.PORT ?? 3000);
|
|
9
|
-
}
|
|
10
|
-
bootstrap();
|
|
1
|
+
import { NestFactory } from '@nestjs/core';
|
|
2
|
+
import { ValidationPipe } from '@nestjs/common';
|
|
3
|
+
import { AppModule } from './app.module';
|
|
4
|
+
|
|
5
|
+
async function bootstrap() {
|
|
6
|
+
const app = await NestFactory.create(AppModule);
|
|
7
|
+
app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true }));
|
|
8
|
+
await app.listen(process.env.PORT ?? 3000);
|
|
9
|
+
}
|
|
10
|
+
bootstrap();
|
package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts
CHANGED
|
@@ -1,47 +1,47 @@
|
|
|
1
|
-
import { Inject, Injectable } from '@nestjs/common';
|
|
2
|
-
import { randomUUID } from 'node:crypto';
|
|
3
|
-
import { Order, OrderLine } from '../domain/order.entity';
|
|
4
|
-
import { Money } from '../domain/money.vo';
|
|
5
|
-
import { ORDER_REPOSITORY, OrderRepository } from '../domain/order.repository';
|
|
6
|
-
import { Result } from '../../../shared/result';
|
|
7
|
-
|
|
8
|
-
/**
|
|
9
|
-
* Contratos de entrada/saída — tipados e legíveis. Um agente entende o que o use-case faz pela
|
|
10
|
-
* assinatura, **sem ler o corpo** (AC-5). É a compressão de contexto: o tipo é o resumo.
|
|
11
|
-
*/
|
|
12
|
-
export interface PlaceOrderInput {
|
|
13
|
-
customerId: string;
|
|
14
|
-
items: Array<{ productId: string; unitPriceCents: number; quantity: number }>;
|
|
15
|
-
}
|
|
16
|
-
export interface PlaceOrderOutput {
|
|
17
|
-
orderId: string;
|
|
18
|
-
totalCents: number;
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
/**
|
|
22
|
-
* PlaceOrder — orquestra o domínio + a porta. O use-case não tem regra de negócio própria: ele
|
|
23
|
-
* traduz o input, chama o agregado (que decide), e persiste via porta. A regra ("precisa de itens")
|
|
24
|
-
* é do `Order`, não daqui.
|
|
25
|
-
*/
|
|
26
|
-
@Injectable()
|
|
27
|
-
export class PlaceOrderUseCase {
|
|
28
|
-
// Injeta a PORTA (token), nunca o adapter concreto — a inversão de dependência.
|
|
29
|
-
constructor(@Inject(ORDER_REPOSITORY) private readonly orders: OrderRepository) {}
|
|
30
|
-
|
|
31
|
-
async execute(input: PlaceOrderInput): Promise<Result<PlaceOrderOutput>> {
|
|
32
|
-
const lines: OrderLine[] = input.items.map((i) => ({
|
|
33
|
-
productId: i.productId,
|
|
34
|
-
unitPrice: Money.of(i.unitPriceCents),
|
|
35
|
-
quantity: i.quantity,
|
|
36
|
-
}));
|
|
37
|
-
|
|
38
|
-
const created = Order.place(randomUUID(), input.customerId, lines);
|
|
39
|
-
if (created.isFailure) return Result.fail(created.error!);
|
|
40
|
-
|
|
41
|
-
const order = created.value;
|
|
42
|
-
order.confirm(); // rascunho → confirmado (a máquina de estados do domínio valida)
|
|
43
|
-
await this.orders.save(order);
|
|
44
|
-
|
|
45
|
-
return Result.ok({ orderId: order.id, totalCents: order.total.cents });
|
|
46
|
-
}
|
|
47
|
-
}
|
|
1
|
+
import { Inject, Injectable } from '@nestjs/common';
|
|
2
|
+
import { randomUUID } from 'node:crypto';
|
|
3
|
+
import { Order, OrderLine } from '../domain/order.entity';
|
|
4
|
+
import { Money } from '../domain/money.vo';
|
|
5
|
+
import { ORDER_REPOSITORY, OrderRepository } from '../domain/order.repository';
|
|
6
|
+
import { Result } from '../../../shared/result';
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Contratos de entrada/saída — tipados e legíveis. Um agente entende o que o use-case faz pela
|
|
10
|
+
* assinatura, **sem ler o corpo** (AC-5). É a compressão de contexto: o tipo é o resumo.
|
|
11
|
+
*/
|
|
12
|
+
export interface PlaceOrderInput {
|
|
13
|
+
customerId: string;
|
|
14
|
+
items: Array<{ productId: string; unitPriceCents: number; quantity: number }>;
|
|
15
|
+
}
|
|
16
|
+
export interface PlaceOrderOutput {
|
|
17
|
+
orderId: string;
|
|
18
|
+
totalCents: number;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* PlaceOrder — orquestra o domínio + a porta. O use-case não tem regra de negócio própria: ele
|
|
23
|
+
* traduz o input, chama o agregado (que decide), e persiste via porta. A regra ("precisa de itens")
|
|
24
|
+
* é do `Order`, não daqui.
|
|
25
|
+
*/
|
|
26
|
+
@Injectable()
|
|
27
|
+
export class PlaceOrderUseCase {
|
|
28
|
+
// Injeta a PORTA (token), nunca o adapter concreto — a inversão de dependência.
|
|
29
|
+
constructor(@Inject(ORDER_REPOSITORY) private readonly orders: OrderRepository) {}
|
|
30
|
+
|
|
31
|
+
async execute(input: PlaceOrderInput): Promise<Result<PlaceOrderOutput>> {
|
|
32
|
+
const lines: OrderLine[] = input.items.map((i) => ({
|
|
33
|
+
productId: i.productId,
|
|
34
|
+
unitPrice: Money.of(i.unitPriceCents),
|
|
35
|
+
quantity: i.quantity,
|
|
36
|
+
}));
|
|
37
|
+
|
|
38
|
+
const created = Order.place(randomUUID(), input.customerId, lines);
|
|
39
|
+
if (created.isFailure) return Result.fail(created.error!);
|
|
40
|
+
|
|
41
|
+
const order = created.value;
|
|
42
|
+
order.confirm(); // rascunho → confirmado (a máquina de estados do domínio valida)
|
|
43
|
+
await this.orders.save(order);
|
|
44
|
+
|
|
45
|
+
return Result.ok({ orderId: order.id, totalCents: order.total.cents });
|
|
46
|
+
}
|
|
47
|
+
}
|
package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts
CHANGED
|
@@ -1,28 +1,28 @@
|
|
|
1
|
-
import { Inject, Injectable } from '@nestjs/common';
|
|
2
|
-
import { ORDER_REPOSITORY, OrderRepository } from '../domain/order.repository';
|
|
3
|
-
import { Result } from '../../../shared/result';
|
|
4
|
-
|
|
5
|
-
export interface ShipOrderInput {
|
|
6
|
-
orderId: string;
|
|
7
|
-
}
|
|
8
|
-
|
|
9
|
-
/**
|
|
10
|
-
* ShipOrder — demonstra a invariante-chave passando pelo domínio: `order.ship()` **falha** se o
|
|
11
|
-
* pedido não estiver PAID. O use-case não reimplementa a regra; ele confia no agregado e propaga a
|
|
12
|
-
* falha. A regra "não envia sem pagamento" existe num lugar só: `Order`.
|
|
13
|
-
*/
|
|
14
|
-
@Injectable()
|
|
15
|
-
export class ShipOrderUseCase {
|
|
16
|
-
constructor(@Inject(ORDER_REPOSITORY) private readonly orders: OrderRepository) {}
|
|
17
|
-
|
|
18
|
-
async execute(input: ShipOrderInput): Promise<Result<void>> {
|
|
19
|
-
const order = await this.orders.byId(input.orderId);
|
|
20
|
-
if (!order) return Result.fail('pedido não encontrado');
|
|
21
|
-
|
|
22
|
-
const shipped = order.ship(); // domínio decide: só sai de PAID
|
|
23
|
-
if (shipped.isFailure) return Result.fail(shipped.error!);
|
|
24
|
-
|
|
25
|
-
await this.orders.save(order);
|
|
26
|
-
return Result.ok(undefined);
|
|
27
|
-
}
|
|
28
|
-
}
|
|
1
|
+
import { Inject, Injectable } from '@nestjs/common';
|
|
2
|
+
import { ORDER_REPOSITORY, OrderRepository } from '../domain/order.repository';
|
|
3
|
+
import { Result } from '../../../shared/result';
|
|
4
|
+
|
|
5
|
+
export interface ShipOrderInput {
|
|
6
|
+
orderId: string;
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* ShipOrder — demonstra a invariante-chave passando pelo domínio: `order.ship()` **falha** se o
|
|
11
|
+
* pedido não estiver PAID. O use-case não reimplementa a regra; ele confia no agregado e propaga a
|
|
12
|
+
* falha. A regra "não envia sem pagamento" existe num lugar só: `Order`.
|
|
13
|
+
*/
|
|
14
|
+
@Injectable()
|
|
15
|
+
export class ShipOrderUseCase {
|
|
16
|
+
constructor(@Inject(ORDER_REPOSITORY) private readonly orders: OrderRepository) {}
|
|
17
|
+
|
|
18
|
+
async execute(input: ShipOrderInput): Promise<Result<void>> {
|
|
19
|
+
const order = await this.orders.byId(input.orderId);
|
|
20
|
+
if (!order) return Result.fail('pedido não encontrado');
|
|
21
|
+
|
|
22
|
+
const shipped = order.ship(); // domínio decide: só sai de PAID
|
|
23
|
+
if (shipped.isFailure) return Result.fail(shipped.error!);
|
|
24
|
+
|
|
25
|
+
await this.orders.save(order);
|
|
26
|
+
return Result.ok(undefined);
|
|
27
|
+
}
|
|
28
|
+
}
|
|
@@ -1,30 +1,30 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Money — value object. Imutável, comparado por valor, valida a si mesmo na criação.
|
|
3
|
-
* Zero dependência de framework: é TypeScript puro (o ponto do domínio isolado).
|
|
4
|
-
*/
|
|
5
|
-
export class Money {
|
|
6
|
-
private constructor(public readonly cents: number) {}
|
|
7
|
-
|
|
8
|
-
static of(cents: number): Money {
|
|
9
|
-
if (!Number.isInteger(cents) || cents < 0) {
|
|
10
|
-
throw new Error('Money exige inteiro não-negativo em centavos');
|
|
11
|
-
}
|
|
12
|
-
return new Money(cents);
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
static zero(): Money {
|
|
16
|
-
return new Money(0);
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
plus(other: Money): Money {
|
|
20
|
-
return new Money(this.cents + other.cents);
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
times(qty: number): Money {
|
|
24
|
-
return Money.of(this.cents * qty);
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
isZero(): boolean {
|
|
28
|
-
return this.cents === 0;
|
|
29
|
-
}
|
|
30
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Money — value object. Imutável, comparado por valor, valida a si mesmo na criação.
|
|
3
|
+
* Zero dependência de framework: é TypeScript puro (o ponto do domínio isolado).
|
|
4
|
+
*/
|
|
5
|
+
export class Money {
|
|
6
|
+
private constructor(public readonly cents: number) {}
|
|
7
|
+
|
|
8
|
+
static of(cents: number): Money {
|
|
9
|
+
if (!Number.isInteger(cents) || cents < 0) {
|
|
10
|
+
throw new Error('Money exige inteiro não-negativo em centavos');
|
|
11
|
+
}
|
|
12
|
+
return new Money(cents);
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
static zero(): Money {
|
|
16
|
+
return new Money(0);
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
plus(other: Money): Money {
|
|
20
|
+
return new Money(this.cents + other.cents);
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
times(qty: number): Money {
|
|
24
|
+
return Money.of(this.cents * qty);
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
isZero(): boolean {
|
|
28
|
+
return this.cents === 0;
|
|
29
|
+
}
|
|
30
|
+
}
|