forjajs 2.0.4 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +133 -133
- package/CHANGELOG.md +619 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +64 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +15 -0
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.js +27 -4
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +32 -3
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -157
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/cost-aware-autonomy-budget/spec.md +102 -0
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/spec.md +23 -23
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,70 +1,70 @@
|
|
|
1
|
-
# Tasks: clean-arch-boilerplate
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: approved
|
|
6
|
-
- **Criado em**: 2026-07-18
|
|
7
|
-
|
|
8
|
-
> Decomposição executável. O boilerplate é **conteúdo de template** (código do projeto gerado), não
|
|
9
|
-
> código do framework — não roda na CI do Forja. Escrever para ser referência idiomática correta.
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## T1 — Esqueleto + `shared/`
|
|
14
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: —
|
|
15
|
-
- **Paths**: `boilerplates/06-clean-arch/backend/src/{shared,main.ts,app.module.ts}`
|
|
16
|
-
- **Done**: `Result`/erros de domínio/base VO; `main.ts`/`app.module.ts`; `package.json` + `tsconfig`
|
|
17
|
-
do projeto (com `test:e2e`, `start:dev` etc. — entram na allowlist derivada do SPEC-011).
|
|
18
|
-
|
|
19
|
-
## T2 — Fatia rica: Orders (as 4 camadas) — AC-1/2/3/5
|
|
20
|
-
- **Owner**: Worker · **Estimativa**: M · **Depende de**: T1
|
|
21
|
-
- **Paths**: `.../modules/orders/{domain,application,infrastructure,presentation}/*`, `orders.module.ts`
|
|
22
|
-
- **Done**:
|
|
23
|
-
- [ ] `domain/`: `Order` (agregado, invariantes: não confirma sem estoque, não envia sem pagamento),
|
|
24
|
-
`order-status.vo.ts`, `order.repository.ts` (porta = interface + token). **Zero `@nestjs`/ORM.**
|
|
25
|
-
- [ ] `application/`: `place-order`/`ship-order` use-cases com input/output tipados (contrato legível).
|
|
26
|
-
- [ ] `infrastructure/`: adapter TypeORM implementa a porta + mapper domínio↔orm-entity.
|
|
27
|
-
- [ ] `presentation/`: controller + HTTP DTOs mapeando p/ use-case.
|
|
28
|
-
- [ ] `orders.module.ts`: bind `{ provide: ORDER_REPOSITORY, useClass: TypeOrmOrderRepository }`.
|
|
29
|
-
|
|
30
|
-
## T3 — Teste da invariante sem Nest — AC-8
|
|
31
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T2
|
|
32
|
-
- **Paths**: `.../backend/test/orders/place-order.spec.ts`
|
|
33
|
-
- **Done**: testa a invariante de domínio **instanciando só o agregado** (sem `Test.createTestingModule`,
|
|
34
|
-
sem ORM). É a prova concreta do isolamento — se precisar do Nest, o domínio vazou.
|
|
35
|
-
|
|
36
|
-
## T4 — Caminho enxuto: Products (1 camada) — AC-4
|
|
37
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T1
|
|
38
|
-
- **Paths**: `.../modules/products/*`, `WHEN-CLEAN-WHEN-LEAN.md`
|
|
39
|
-
- **Done**: CRUD controller→repo direto, **sem** use-case/porta; o doc ensina o critério de escolha.
|
|
40
|
-
Kill criteria: se Products virar 4 camadas, a spec falhou.
|
|
41
|
-
|
|
42
|
-
## T5 — Memória por contexto (o vetor de token) — AC-6
|
|
43
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T2, T4
|
|
44
|
-
- **Paths**: `.../memory/30-domains/{orders,products}/context.md`
|
|
45
|
-
- **Done**: cada contexto descrito na linguagem ubíqua — o que o agente lê **antes** do código.
|
|
46
|
-
Orders documenta as invariantes e os use-cases; Products, o CRUD raso.
|
|
47
|
-
|
|
48
|
-
## T6 — Manifesto + catálogo + README — AC-7
|
|
49
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T1-T5
|
|
50
|
-
- **Paths**: `.../boilerplate.manifest.json`, `.../README.md`, `boilerplates/README.md`
|
|
51
|
-
- **Done**: manifesto no schema 1.0 (stack/useCases/commands); entrada no catálogo; README explicando
|
|
52
|
-
a estrutura e apontando o `WHEN-CLEAN-WHEN-LEAN.md`.
|
|
53
|
-
|
|
54
|
-
## T7 — Medir o token (métrica-norte) + ADR-0027 — AC-6/AC-10
|
|
55
|
-
- **Owner**: SDD Architect + Governance · **Estimativa**: P · **Depende de**: T5, T6
|
|
56
|
-
- **Paths**: `memory/90-decisions/0027-*.md`
|
|
57
|
-
- **Done**:
|
|
58
|
-
- [ ] Medir o pacote de contexto de "adicionar uma regra ao contexto orders" aqui vs. no
|
|
59
|
-
`02-saas-starter` flat. **Registrar os números.**
|
|
60
|
-
- [ ] ADR-0027: Clean Architecture calibrada; o porquê da calibração e o resultado da medição.
|
|
61
|
-
Se o token não caiu, o ADR diz isso e recalibra — não maquia.
|
|
62
|
-
|
|
63
|
-
## T8 — Gates (Governance) — AC-9
|
|
64
|
-
- **Owner**: Governance · **Estimativa**: P · **Depende de**: T6
|
|
65
|
-
- **Done**: `release:check` (boilerplate no `files[]`, instala limpo), `tools:doctor` (docs-commands
|
|
66
|
-
não acusa fantasma), `npm test` do Forja verde. spec → `done`.
|
|
67
|
-
|
|
68
|
-
---
|
|
69
|
-
## Handoffs
|
|
70
|
-
Worker (T1-T6), SDD Architect + Governance (T7-T8). `forja agent:route` a cada fronteira (ADR-0005).
|
|
1
|
+
# Tasks: clean-arch-boilerplate
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-07-18
|
|
7
|
+
|
|
8
|
+
> Decomposição executável. O boilerplate é **conteúdo de template** (código do projeto gerado), não
|
|
9
|
+
> código do framework — não roda na CI do Forja. Escrever para ser referência idiomática correta.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## T1 — Esqueleto + `shared/`
|
|
14
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: —
|
|
15
|
+
- **Paths**: `boilerplates/06-clean-arch/backend/src/{shared,main.ts,app.module.ts}`
|
|
16
|
+
- **Done**: `Result`/erros de domínio/base VO; `main.ts`/`app.module.ts`; `package.json` + `tsconfig`
|
|
17
|
+
do projeto (com `test:e2e`, `start:dev` etc. — entram na allowlist derivada do SPEC-011).
|
|
18
|
+
|
|
19
|
+
## T2 — Fatia rica: Orders (as 4 camadas) — AC-1/2/3/5
|
|
20
|
+
- **Owner**: Worker · **Estimativa**: M · **Depende de**: T1
|
|
21
|
+
- **Paths**: `.../modules/orders/{domain,application,infrastructure,presentation}/*`, `orders.module.ts`
|
|
22
|
+
- **Done**:
|
|
23
|
+
- [ ] `domain/`: `Order` (agregado, invariantes: não confirma sem estoque, não envia sem pagamento),
|
|
24
|
+
`order-status.vo.ts`, `order.repository.ts` (porta = interface + token). **Zero `@nestjs`/ORM.**
|
|
25
|
+
- [ ] `application/`: `place-order`/`ship-order` use-cases com input/output tipados (contrato legível).
|
|
26
|
+
- [ ] `infrastructure/`: adapter TypeORM implementa a porta + mapper domínio↔orm-entity.
|
|
27
|
+
- [ ] `presentation/`: controller + HTTP DTOs mapeando p/ use-case.
|
|
28
|
+
- [ ] `orders.module.ts`: bind `{ provide: ORDER_REPOSITORY, useClass: TypeOrmOrderRepository }`.
|
|
29
|
+
|
|
30
|
+
## T3 — Teste da invariante sem Nest — AC-8
|
|
31
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T2
|
|
32
|
+
- **Paths**: `.../backend/test/orders/place-order.spec.ts`
|
|
33
|
+
- **Done**: testa a invariante de domínio **instanciando só o agregado** (sem `Test.createTestingModule`,
|
|
34
|
+
sem ORM). É a prova concreta do isolamento — se precisar do Nest, o domínio vazou.
|
|
35
|
+
|
|
36
|
+
## T4 — Caminho enxuto: Products (1 camada) — AC-4
|
|
37
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T1
|
|
38
|
+
- **Paths**: `.../modules/products/*`, `WHEN-CLEAN-WHEN-LEAN.md`
|
|
39
|
+
- **Done**: CRUD controller→repo direto, **sem** use-case/porta; o doc ensina o critério de escolha.
|
|
40
|
+
Kill criteria: se Products virar 4 camadas, a spec falhou.
|
|
41
|
+
|
|
42
|
+
## T5 — Memória por contexto (o vetor de token) — AC-6
|
|
43
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T2, T4
|
|
44
|
+
- **Paths**: `.../memory/30-domains/{orders,products}/context.md`
|
|
45
|
+
- **Done**: cada contexto descrito na linguagem ubíqua — o que o agente lê **antes** do código.
|
|
46
|
+
Orders documenta as invariantes e os use-cases; Products, o CRUD raso.
|
|
47
|
+
|
|
48
|
+
## T6 — Manifesto + catálogo + README — AC-7
|
|
49
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T1-T5
|
|
50
|
+
- **Paths**: `.../boilerplate.manifest.json`, `.../README.md`, `boilerplates/README.md`
|
|
51
|
+
- **Done**: manifesto no schema 1.0 (stack/useCases/commands); entrada no catálogo; README explicando
|
|
52
|
+
a estrutura e apontando o `WHEN-CLEAN-WHEN-LEAN.md`.
|
|
53
|
+
|
|
54
|
+
## T7 — Medir o token (métrica-norte) + ADR-0027 — AC-6/AC-10
|
|
55
|
+
- **Owner**: SDD Architect + Governance · **Estimativa**: P · **Depende de**: T5, T6
|
|
56
|
+
- **Paths**: `memory/90-decisions/0027-*.md`
|
|
57
|
+
- **Done**:
|
|
58
|
+
- [ ] Medir o pacote de contexto de "adicionar uma regra ao contexto orders" aqui vs. no
|
|
59
|
+
`02-saas-starter` flat. **Registrar os números.**
|
|
60
|
+
- [ ] ADR-0027: Clean Architecture calibrada; o porquê da calibração e o resultado da medição.
|
|
61
|
+
Se o token não caiu, o ADR diz isso e recalibra — não maquia.
|
|
62
|
+
|
|
63
|
+
## T8 — Gates (Governance) — AC-9
|
|
64
|
+
- **Owner**: Governance · **Estimativa**: P · **Depende de**: T6
|
|
65
|
+
- **Done**: `release:check` (boilerplate no `files[]`, instala limpo), `tools:doctor` (docs-commands
|
|
66
|
+
não acusa fantasma), `npm test` do Forja verde. spec → `done`.
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
## Handoffs
|
|
70
|
+
Worker (T1-T6), SDD Architect + Governance (T7-T8). `forja agent:route` a cada fronteira (ADR-0005).
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# Plan: cli-first-operacao
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Status**: approved
|
|
5
|
-
- **Criado em**: 2026-06-02
|
|
6
|
-
|
|
7
|
-
## 1. Abordagem tecnica
|
|
8
|
-
Manter o dashboard existente como opcional e mover a operacao principal para comandos. Corrigir o gerenciador de sprint para funcionar no repositorio raiz, aceitar backlog RICE e expor encerramento de sprint no `package.json`. Ajustar GSD para nao exigir design em fluxo sem UI.
|
|
9
|
-
|
|
10
|
-
## 2. Modulos afetados
|
|
11
|
-
| Caminho | Mudanca | Risco |
|
|
12
|
-
|---|---|---|
|
|
13
|
-
| `scripts/sprint-manager.js` | default para raiz e suporte a tabela RICE | M |
|
|
14
|
-
| `scripts/agent-harness.mjs` | `gsd:check` aceita CLI-only sem brief visual | B |
|
|
15
|
-
| `scripts/dev.mjs` | saida textual mais limpa | B |
|
|
16
|
-
| `scripts/check-standards.js` | `project:check` valida root sem argumento | B |
|
|
17
|
-
| `package.json` | novos aliases de operacao | B |
|
|
18
|
-
| `README.md`, `AGENTS.md`, `docs/*` | documentar CLI-first | B |
|
|
19
|
-
|
|
20
|
-
## 3. Fluxo
|
|
21
|
-
```
|
|
22
|
-
sprint:start/status
|
|
23
|
-
-> context:build
|
|
24
|
-
-> gsd:plan
|
|
25
|
-
-> gsd:handoff spec/plan/implement/review
|
|
26
|
-
-> gsd:check
|
|
27
|
-
-> project:check
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
## 4. Contratos
|
|
31
|
-
- `npm run sprint:start [projeto]`
|
|
32
|
-
- `npm run sprint:status [projeto]`
|
|
33
|
-
- `npm run sprint:complete [projeto]`
|
|
34
|
-
- `npm run gsd:check -- <slug> [brief.md]`
|
|
35
|
-
|
|
36
|
-
Sem `brief.md`, o check considera design como nao aplicavel.
|
|
37
|
-
|
|
38
|
-
## 5. Decisoes
|
|
39
|
-
**D1**: Nao remover o dashboard agora. Ele fica legado/opcional para evitar quebra de scripts e preservar historico.
|
|
40
|
-
|
|
41
|
-
**D2**: Backlog RICE nao e modificado ao iniciar sprint. A sprint recebe uma selecao operacional dos P0/P1.
|
|
42
|
-
|
|
43
|
-
## 6. Dependencias
|
|
44
|
-
- Sem novos pacotes.
|
|
45
|
-
- Sem migracao de banco.
|
|
46
|
-
|
|
47
|
-
## 7. Rollout
|
|
48
|
-
- Documentacao atualizada no README, AGENTS e guia CLI-first.
|
|
49
|
-
- Testes de CLI executados localmente.
|
|
50
|
-
|
|
51
|
-
## 8. Sinais de fracasso
|
|
52
|
-
- Operador ainda precisar abrir web para acompanhar sprint.
|
|
53
|
-
- `gsd:check` bloquear tarefa CLI-only por ausencia de brief visual.
|
|
1
|
+
# Plan: cli-first-operacao
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-06-02
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem tecnica
|
|
8
|
+
Manter o dashboard existente como opcional e mover a operacao principal para comandos. Corrigir o gerenciador de sprint para funcionar no repositorio raiz, aceitar backlog RICE e expor encerramento de sprint no `package.json`. Ajustar GSD para nao exigir design em fluxo sem UI.
|
|
9
|
+
|
|
10
|
+
## 2. Modulos afetados
|
|
11
|
+
| Caminho | Mudanca | Risco |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| `scripts/sprint-manager.js` | default para raiz e suporte a tabela RICE | M |
|
|
14
|
+
| `scripts/agent-harness.mjs` | `gsd:check` aceita CLI-only sem brief visual | B |
|
|
15
|
+
| `scripts/dev.mjs` | saida textual mais limpa | B |
|
|
16
|
+
| `scripts/check-standards.js` | `project:check` valida root sem argumento | B |
|
|
17
|
+
| `package.json` | novos aliases de operacao | B |
|
|
18
|
+
| `README.md`, `AGENTS.md`, `docs/*` | documentar CLI-first | B |
|
|
19
|
+
|
|
20
|
+
## 3. Fluxo
|
|
21
|
+
```
|
|
22
|
+
sprint:start/status
|
|
23
|
+
-> context:build
|
|
24
|
+
-> gsd:plan
|
|
25
|
+
-> gsd:handoff spec/plan/implement/review
|
|
26
|
+
-> gsd:check
|
|
27
|
+
-> project:check
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## 4. Contratos
|
|
31
|
+
- `npm run sprint:start [projeto]`
|
|
32
|
+
- `npm run sprint:status [projeto]`
|
|
33
|
+
- `npm run sprint:complete [projeto]`
|
|
34
|
+
- `npm run gsd:check -- <slug> [brief.md]`
|
|
35
|
+
|
|
36
|
+
Sem `brief.md`, o check considera design como nao aplicavel.
|
|
37
|
+
|
|
38
|
+
## 5. Decisoes
|
|
39
|
+
**D1**: Nao remover o dashboard agora. Ele fica legado/opcional para evitar quebra de scripts e preservar historico.
|
|
40
|
+
|
|
41
|
+
**D2**: Backlog RICE nao e modificado ao iniciar sprint. A sprint recebe uma selecao operacional dos P0/P1.
|
|
42
|
+
|
|
43
|
+
## 6. Dependencias
|
|
44
|
+
- Sem novos pacotes.
|
|
45
|
+
- Sem migracao de banco.
|
|
46
|
+
|
|
47
|
+
## 7. Rollout
|
|
48
|
+
- Documentacao atualizada no README, AGENTS e guia CLI-first.
|
|
49
|
+
- Testes de CLI executados localmente.
|
|
50
|
+
|
|
51
|
+
## 8. Sinais de fracasso
|
|
52
|
+
- Operador ainda precisar abrir web para acompanhar sprint.
|
|
53
|
+
- `gsd:check` bloquear tarefa CLI-only por ausencia de brief visual.
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# Spec: cli-first-operacao
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-CLI-FIRST-001
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: orchestrator
|
|
6
|
-
- **Criado em**: 2026-06-02
|
|
7
|
-
- **Sprint alvo**: refinamento-cli-2026-06
|
|
8
|
-
- **ADRs relacionadas**: ADR-0005, ADR-0007, ADR-0008
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
O projeto tinha forte presenca de dashboard/web e referencias visuais na entrada operacional. Isso poluia a operacao diaria e desviava o uso do objetivo principal: orquestracao, SDD, GSD, sprints e handoffs por comandos.
|
|
12
|
-
|
|
13
|
-
## 2. Proposta de valor
|
|
14
|
-
Operar o framework pelo terminal com sprints, contexto, specs, handoffs, checks e governanca em uma trilha curta e repetivel.
|
|
15
|
-
|
|
16
|
-
## 3. User stories
|
|
17
|
-
- **Como** operador do framework, **quero** acompanhar sprints pelo CLI, **para que** eu nao dependa da web para saber o proximo passo.
|
|
18
|
-
- **Como** Orchestrator, **quero** registrar handoffs GSD pelo CLI, **para que** SDD e governanca tenham rastreabilidade.
|
|
19
|
-
- **Como** Governance, **quero** validar entregas CLI-only sem brief visual, **para que** design nao bloqueie trabalho sem UI.
|
|
20
|
-
|
|
21
|
-
## 4. Criterios de aceite
|
|
22
|
-
- [x] AC-1: `npm run sprint:start/status/complete` funciona no repositorio raiz sem argumento de projeto.
|
|
23
|
-
- [x] AC-2: backlog em tabela RICE gera sprint com itens P0/P1.
|
|
24
|
-
- [x] AC-3: `gsd:check` nao exige brief visual quando a entrega e CLI-only.
|
|
25
|
-
- [x] AC-4: README, AGENTS e docs apontam CLI-first como caminho operacional principal.
|
|
26
|
-
- [x] AC-5: dashboard/web permanece opcional/legado, nao gate operacional.
|
|
27
|
-
- [x] AC-6: `npm run project:check` valida o framework raiz quando chamado sem projeto.
|
|
28
|
-
|
|
29
|
-
## 5. Escopo
|
|
30
|
-
**Dentro**:
|
|
31
|
-
- Scripts de sprint e GSD.
|
|
32
|
-
- Check de governanca do projeto raiz.
|
|
33
|
-
- Documentacao de operacao CLI-first.
|
|
34
|
-
- Reducao de ruido visual no CLI principal.
|
|
35
|
-
|
|
36
|
-
**Fora**:
|
|
37
|
-
- Remover fisicamente o dashboard.
|
|
38
|
-
- Reescrever frontend.
|
|
39
|
-
- Alterar SQLite ou schema de handoffs.
|
|
40
|
-
|
|
41
|
-
## 6. NFRs / restricoes
|
|
42
|
-
- Compatibilidade: manter comandos existentes.
|
|
43
|
-
- Operabilidade: saida de terminal simples, sem depender de browser.
|
|
44
|
-
- Governanca: preservar ADR-0005 e fluxo SDD.
|
|
45
|
-
|
|
46
|
-
## 7. Riscos e mitigacao
|
|
47
|
-
| Risco | Probabilidade | Impacto | Mitigacao |
|
|
48
|
-
|---|---|---|---|
|
|
49
|
-
| Usuarios ainda abrirem dashboard por habito | M | B | README e AGENTS priorizam CLI-first |
|
|
50
|
-
| Sprint duplicar itens de backlog RICE | B | B | Tabela RICE nao e removida; sprint vira selecao operacional |
|
|
51
|
-
|
|
52
|
-
## 8. Metricas de sucesso
|
|
53
|
-
Em 30 dias, 90% das execucoes de sprint e handoff devem ser feitas por CLI, com `gsd:check` e `project:check` usados antes de entrega.
|
|
1
|
+
# Spec: cli-first-operacao
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-CLI-FIRST-001
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: orchestrator
|
|
6
|
+
- **Criado em**: 2026-06-02
|
|
7
|
+
- **Sprint alvo**: refinamento-cli-2026-06
|
|
8
|
+
- **ADRs relacionadas**: ADR-0005, ADR-0007, ADR-0008
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O projeto tinha forte presenca de dashboard/web e referencias visuais na entrada operacional. Isso poluia a operacao diaria e desviava o uso do objetivo principal: orquestracao, SDD, GSD, sprints e handoffs por comandos.
|
|
12
|
+
|
|
13
|
+
## 2. Proposta de valor
|
|
14
|
+
Operar o framework pelo terminal com sprints, contexto, specs, handoffs, checks e governanca em uma trilha curta e repetivel.
|
|
15
|
+
|
|
16
|
+
## 3. User stories
|
|
17
|
+
- **Como** operador do framework, **quero** acompanhar sprints pelo CLI, **para que** eu nao dependa da web para saber o proximo passo.
|
|
18
|
+
- **Como** Orchestrator, **quero** registrar handoffs GSD pelo CLI, **para que** SDD e governanca tenham rastreabilidade.
|
|
19
|
+
- **Como** Governance, **quero** validar entregas CLI-only sem brief visual, **para que** design nao bloqueie trabalho sem UI.
|
|
20
|
+
|
|
21
|
+
## 4. Criterios de aceite
|
|
22
|
+
- [x] AC-1: `npm run sprint:start/status/complete` funciona no repositorio raiz sem argumento de projeto.
|
|
23
|
+
- [x] AC-2: backlog em tabela RICE gera sprint com itens P0/P1.
|
|
24
|
+
- [x] AC-3: `gsd:check` nao exige brief visual quando a entrega e CLI-only.
|
|
25
|
+
- [x] AC-4: README, AGENTS e docs apontam CLI-first como caminho operacional principal.
|
|
26
|
+
- [x] AC-5: dashboard/web permanece opcional/legado, nao gate operacional.
|
|
27
|
+
- [x] AC-6: `npm run project:check` valida o framework raiz quando chamado sem projeto.
|
|
28
|
+
|
|
29
|
+
## 5. Escopo
|
|
30
|
+
**Dentro**:
|
|
31
|
+
- Scripts de sprint e GSD.
|
|
32
|
+
- Check de governanca do projeto raiz.
|
|
33
|
+
- Documentacao de operacao CLI-first.
|
|
34
|
+
- Reducao de ruido visual no CLI principal.
|
|
35
|
+
|
|
36
|
+
**Fora**:
|
|
37
|
+
- Remover fisicamente o dashboard.
|
|
38
|
+
- Reescrever frontend.
|
|
39
|
+
- Alterar SQLite ou schema de handoffs.
|
|
40
|
+
|
|
41
|
+
## 6. NFRs / restricoes
|
|
42
|
+
- Compatibilidade: manter comandos existentes.
|
|
43
|
+
- Operabilidade: saida de terminal simples, sem depender de browser.
|
|
44
|
+
- Governanca: preservar ADR-0005 e fluxo SDD.
|
|
45
|
+
|
|
46
|
+
## 7. Riscos e mitigacao
|
|
47
|
+
| Risco | Probabilidade | Impacto | Mitigacao |
|
|
48
|
+
|---|---|---|---|
|
|
49
|
+
| Usuarios ainda abrirem dashboard por habito | M | B | README e AGENTS priorizam CLI-first |
|
|
50
|
+
| Sprint duplicar itens de backlog RICE | B | B | Tabela RICE nao e removida; sprint vira selecao operacional |
|
|
51
|
+
|
|
52
|
+
## 8. Metricas de sucesso
|
|
53
|
+
Em 30 dias, 90% das execucoes de sprint e handoff devem ser feitas por CLI, com `gsd:check` e `project:check` usados antes de entrega.
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# Tasks: cli-first-operacao
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: done
|
|
6
|
-
- **Criado em**: 2026-06-02
|
|
7
|
-
|
|
8
|
-
## T1 - Corrigir sprint CLI
|
|
9
|
-
- **Owner**: Worker
|
|
10
|
-
- **Estimativa**: P
|
|
11
|
-
- **Depende de**: -
|
|
12
|
-
- **Paths**: `scripts/sprint-manager.js`, `package.json`
|
|
13
|
-
- **Done quando**:
|
|
14
|
-
- [x] sprint funciona no repositorio raiz sem projeto
|
|
15
|
-
- [x] backlog RICE P0/P1 gera itens de sprint
|
|
16
|
-
- [x] `sprint:complete` esta exposto no npm
|
|
17
|
-
|
|
18
|
-
## T2 - Ajustar GSD CLI-only
|
|
19
|
-
- **Owner**: Worker
|
|
20
|
-
- **Estimativa**: P
|
|
21
|
-
- **Depende de**: T1
|
|
22
|
-
- **Paths**: `scripts/agent-harness.mjs`
|
|
23
|
-
- **Done quando**:
|
|
24
|
-
- [x] `gsd:check <slug>` nao falha por ausencia de brief visual
|
|
25
|
-
|
|
26
|
-
## T3 - Reduzir ruido do CLI
|
|
27
|
-
- **Owner**: Worker
|
|
28
|
-
- **Estimativa**: P
|
|
29
|
-
- **Depende de**: -
|
|
30
|
-
- **Paths**: `scripts/dev.mjs`
|
|
31
|
-
- **Done quando**:
|
|
32
|
-
- [x] help e checks usam texto simples
|
|
33
|
-
|
|
34
|
-
## T4 - Documentar operacao
|
|
35
|
-
- **Owner**: Orchestrator
|
|
36
|
-
- **Estimativa**: P
|
|
37
|
-
- **Depende de**: T1, T2
|
|
38
|
-
- **Paths**: `README.md`, `AGENTS.md`, `docs/cli-first-operacao.md`, `docs/quick-reference.md`, `memory/50-orchestration/gsd-harness.md`
|
|
39
|
-
- **Done quando**:
|
|
40
|
-
- [x] CLI-first e caminho principal documentado
|
|
41
|
-
- [x] dashboard descrito como opcional/legado
|
|
42
|
-
|
|
43
|
-
## T5 - Corrigir gate de governanca raiz
|
|
44
|
-
- **Owner**: Governance
|
|
45
|
-
- **Estimativa**: P
|
|
46
|
-
- **Depende de**: T4
|
|
47
|
-
- **Paths**: `scripts/check-standards.js`
|
|
48
|
-
- **Done quando**:
|
|
49
|
-
- [x] `npm run project:check` valida o framework raiz sem exigir nome de projeto
|
|
50
|
-
- [x] saida usa texto simples
|
|
51
|
-
|
|
52
|
-
## Handoffs entre agentes
|
|
53
|
-
Fluxo aplicavel: Product -> SDD Architect -> Worker -> Governance via `npm run gsd:handoff -- <fase> cli-first-operacao`.
|
|
1
|
+
# Tasks: cli-first-operacao
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-06-02
|
|
7
|
+
|
|
8
|
+
## T1 - Corrigir sprint CLI
|
|
9
|
+
- **Owner**: Worker
|
|
10
|
+
- **Estimativa**: P
|
|
11
|
+
- **Depende de**: -
|
|
12
|
+
- **Paths**: `scripts/sprint-manager.js`, `package.json`
|
|
13
|
+
- **Done quando**:
|
|
14
|
+
- [x] sprint funciona no repositorio raiz sem projeto
|
|
15
|
+
- [x] backlog RICE P0/P1 gera itens de sprint
|
|
16
|
+
- [x] `sprint:complete` esta exposto no npm
|
|
17
|
+
|
|
18
|
+
## T2 - Ajustar GSD CLI-only
|
|
19
|
+
- **Owner**: Worker
|
|
20
|
+
- **Estimativa**: P
|
|
21
|
+
- **Depende de**: T1
|
|
22
|
+
- **Paths**: `scripts/agent-harness.mjs`
|
|
23
|
+
- **Done quando**:
|
|
24
|
+
- [x] `gsd:check <slug>` nao falha por ausencia de brief visual
|
|
25
|
+
|
|
26
|
+
## T3 - Reduzir ruido do CLI
|
|
27
|
+
- **Owner**: Worker
|
|
28
|
+
- **Estimativa**: P
|
|
29
|
+
- **Depende de**: -
|
|
30
|
+
- **Paths**: `scripts/dev.mjs`
|
|
31
|
+
- **Done quando**:
|
|
32
|
+
- [x] help e checks usam texto simples
|
|
33
|
+
|
|
34
|
+
## T4 - Documentar operacao
|
|
35
|
+
- **Owner**: Orchestrator
|
|
36
|
+
- **Estimativa**: P
|
|
37
|
+
- **Depende de**: T1, T2
|
|
38
|
+
- **Paths**: `README.md`, `AGENTS.md`, `docs/cli-first-operacao.md`, `docs/quick-reference.md`, `memory/50-orchestration/gsd-harness.md`
|
|
39
|
+
- **Done quando**:
|
|
40
|
+
- [x] CLI-first e caminho principal documentado
|
|
41
|
+
- [x] dashboard descrito como opcional/legado
|
|
42
|
+
|
|
43
|
+
## T5 - Corrigir gate de governanca raiz
|
|
44
|
+
- **Owner**: Governance
|
|
45
|
+
- **Estimativa**: P
|
|
46
|
+
- **Depende de**: T4
|
|
47
|
+
- **Paths**: `scripts/check-standards.js`
|
|
48
|
+
- **Done quando**:
|
|
49
|
+
- [x] `npm run project:check` valida o framework raiz sem exigir nome de projeto
|
|
50
|
+
- [x] saida usa texto simples
|
|
51
|
+
|
|
52
|
+
## Handoffs entre agentes
|
|
53
|
+
Fluxo aplicavel: Product -> SDD Architect -> Worker -> Governance via `npm run gsd:handoff -- <fase> cli-first-operacao`.
|
|
@@ -1,56 +1,56 @@
|
|
|
1
|
-
# Spec: code-context
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-016
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: apk
|
|
6
|
-
- **ADRs relacionadas**: ADR-0009 (economia de token), ADR-0003 (smart-context), ADR-0020 (core/registry)
|
|
7
|
-
|
|
8
|
-
## 1. Problema
|
|
9
|
-
|
|
10
|
-
O `token:economy` mediu a economia real do framework: o `context.md` de um domínio (o mapa) faz o
|
|
11
|
-
contexto mínimo custar **−61%** vs varrer a fatia no frio. Mas essa economia era **potencial, não
|
|
12
|
-
entregue**: o mapa é só um arquivo que alguém precisa lembrar de ler, e ainda montar o contexto na
|
|
13
|
-
mão (mapa + os arquivos certos). A economia medida não vira lever até virar comando.
|
|
14
|
-
|
|
15
|
-
## 2. Proposta de valor
|
|
16
|
-
|
|
17
|
-
Um comando entrega o **pacote de contexto mínimo** de um domínio, pronto para colar, com o custo em
|
|
18
|
-
token à mostra: o −61% deixa de ser medição e vira ferramenta do dia a dia.
|
|
19
|
-
|
|
20
|
-
## 3. User stories
|
|
21
|
-
|
|
22
|
-
- **Como** agente que vai mexer num domínio, **quero** um comando que me dê o mapa + (sob demanda) o
|
|
23
|
-
código da fatia, **para que** eu não pague o custo de explorar a árvore no frio.
|
|
24
|
-
- **Como** dev, **quero** ver o custo em token do pacote, **para que** a economia seja visível e eu
|
|
25
|
-
escolha entre "só o mapa" e "mapa + código".
|
|
26
|
-
|
|
27
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
28
|
-
|
|
29
|
-
- [x] AC-1: `forja code:context <domínio>` imprime o `context.md` do domínio (o mapa), pronto para
|
|
30
|
-
colar, com os tokens do mapa no rodapé.
|
|
31
|
-
- [x] AC-2: `--code` anexa os `.ts` da fatia (`backend/src/modules/<domínio>/`) e soma os tokens.
|
|
32
|
-
- [x] AC-3: `--project <path>` aponta para outro projeto (default: `cwd`). Sem domínio, lista os
|
|
33
|
-
disponíveis; domínio inexistente reprova com a lista.
|
|
34
|
-
- [x] AC-4: A lógica de montagem é pura e testável (`lib/code-context.ts`), com fixtures — sem tocar
|
|
35
|
-
o disco real.
|
|
36
|
-
|
|
37
|
-
## 5. Escopo
|
|
38
|
-
|
|
39
|
-
**Dentro**: o mapa + o código da fatia, com custo em token. Composição com `code:impact` (blast
|
|
40
|
-
radius) documentada, não embutida.
|
|
41
|
-
|
|
42
|
-
**Fora** (explícito):
|
|
43
|
-
- Reindexar/consultar a memória via FTS5 — isso é `context:smart`/`query:universal`; este comando lê
|
|
44
|
-
o mapa direto do disco do projeto.
|
|
45
|
-
- Chamar codegraph internamente — o blast radius fica em `code:impact`, componível (`&&`).
|
|
46
|
-
- Editar ou resumir o código — entrega cru; resumir é decisão do agente que consome.
|
|
47
|
-
|
|
48
|
-
## 6. NFRs / restrições
|
|
49
|
-
|
|
50
|
-
- **Compatibilidade**: comando novo; não muda nada existente.
|
|
51
|
-
- **Sem dependência de rede ou de codegraph** no caminho principal (mapa + código são leitura de disco).
|
|
52
|
-
|
|
53
|
-
## 7. Métricas de sucesso
|
|
54
|
-
|
|
55
|
-
O pacote "só o mapa" de um domínio típico custa uma fração do "mapa + código" — e ambos, uma fração
|
|
56
|
-
de ler a fatia no frio. O `token:economy` já mostra o −61%; este comando o torna acionável.
|
|
1
|
+
# Spec: code-context
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-016
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **ADRs relacionadas**: ADR-0009 (economia de token), ADR-0003 (smart-context), ADR-0020 (core/registry)
|
|
7
|
+
|
|
8
|
+
## 1. Problema
|
|
9
|
+
|
|
10
|
+
O `token:economy` mediu a economia real do framework: o `context.md` de um domínio (o mapa) faz o
|
|
11
|
+
contexto mínimo custar **−61%** vs varrer a fatia no frio. Mas essa economia era **potencial, não
|
|
12
|
+
entregue**: o mapa é só um arquivo que alguém precisa lembrar de ler, e ainda montar o contexto na
|
|
13
|
+
mão (mapa + os arquivos certos). A economia medida não vira lever até virar comando.
|
|
14
|
+
|
|
15
|
+
## 2. Proposta de valor
|
|
16
|
+
|
|
17
|
+
Um comando entrega o **pacote de contexto mínimo** de um domínio, pronto para colar, com o custo em
|
|
18
|
+
token à mostra: o −61% deixa de ser medição e vira ferramenta do dia a dia.
|
|
19
|
+
|
|
20
|
+
## 3. User stories
|
|
21
|
+
|
|
22
|
+
- **Como** agente que vai mexer num domínio, **quero** um comando que me dê o mapa + (sob demanda) o
|
|
23
|
+
código da fatia, **para que** eu não pague o custo de explorar a árvore no frio.
|
|
24
|
+
- **Como** dev, **quero** ver o custo em token do pacote, **para que** a economia seja visível e eu
|
|
25
|
+
escolha entre "só o mapa" e "mapa + código".
|
|
26
|
+
|
|
27
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
28
|
+
|
|
29
|
+
- [x] AC-1: `forja code:context <domínio>` imprime o `context.md` do domínio (o mapa), pronto para
|
|
30
|
+
colar, com os tokens do mapa no rodapé.
|
|
31
|
+
- [x] AC-2: `--code` anexa os `.ts` da fatia (`backend/src/modules/<domínio>/`) e soma os tokens.
|
|
32
|
+
- [x] AC-3: `--project <path>` aponta para outro projeto (default: `cwd`). Sem domínio, lista os
|
|
33
|
+
disponíveis; domínio inexistente reprova com a lista.
|
|
34
|
+
- [x] AC-4: A lógica de montagem é pura e testável (`lib/code-context.ts`), com fixtures — sem tocar
|
|
35
|
+
o disco real.
|
|
36
|
+
|
|
37
|
+
## 5. Escopo
|
|
38
|
+
|
|
39
|
+
**Dentro**: o mapa + o código da fatia, com custo em token. Composição com `code:impact` (blast
|
|
40
|
+
radius) documentada, não embutida.
|
|
41
|
+
|
|
42
|
+
**Fora** (explícito):
|
|
43
|
+
- Reindexar/consultar a memória via FTS5 — isso é `context:smart`/`query:universal`; este comando lê
|
|
44
|
+
o mapa direto do disco do projeto.
|
|
45
|
+
- Chamar codegraph internamente — o blast radius fica em `code:impact`, componível (`&&`).
|
|
46
|
+
- Editar ou resumir o código — entrega cru; resumir é decisão do agente que consome.
|
|
47
|
+
|
|
48
|
+
## 6. NFRs / restrições
|
|
49
|
+
|
|
50
|
+
- **Compatibilidade**: comando novo; não muda nada existente.
|
|
51
|
+
- **Sem dependência de rede ou de codegraph** no caminho principal (mapa + código são leitura de disco).
|
|
52
|
+
|
|
53
|
+
## 7. Métricas de sucesso
|
|
54
|
+
|
|
55
|
+
O pacote "só o mapa" de um domínio típico custa uma fração do "mapa + código" — e ambos, uma fração
|
|
56
|
+
de ler a fatia no frio. O `token:economy` já mostra o −61%; este comando o torna acionável.
|