forjajs 2.0.4 → 4.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 +19 -25
- package/.claude/agents/governance.md +19 -55
- package/.claude/agents/marketing.md +19 -24
- package/.claude/agents/orchestrator.md +19 -31
- package/.claude/agents/product.md +19 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +19 -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 +93 -87
- package/.github/copilot-instructions.md +93 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +93 -87
- package/AGENTS.md +137 -134
- package/CHANGELOG.md +656 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +68 -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 +17 -1
- 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/release.js +3 -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/llm/codex-output.d.ts +12 -0
- package/dist/lib/llm/codex-output.js +56 -0
- package/dist/lib/llm/context.d.ts +5 -0
- package/dist/lib/llm/context.js +17 -0
- package/dist/lib/llm/session.d.ts +18 -0
- package/dist/lib/llm/session.js +34 -0
- package/dist/lib/llm/validation.d.ts +37 -0
- package/dist/lib/llm/validation.js +88 -0
- 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/evals/src/index.js +6 -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.d.ts +8 -1
- package/dist/packages/llm/src/index.js +64 -7
- 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 +85 -9
- 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/agent-operating-contract.md +26 -0
- 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/llm-evolution.md +51 -0
- package/docs/llm-fit-loop.md +134 -5
- 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 +49 -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/0080-llm-execution-evidence.md +42 -0
- package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +159 -157
- package/prompts/context-engineer-agent.md +13 -19
- package/prompts/governance-agent.md +13 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +13 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +13 -20
- package/skills/MANIFEST.json +10 -0
- package/skills/llm-provider-routing/SKILL.md +18 -0
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +50 -43
- package/specs/_templates/spec.md +50 -43
- package/specs/_templates/tasks.md +39 -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-instructions-v4/plan.md +8 -0
- package/specs/agent-instructions-v4/spec.md +21 -0
- package/specs/agent-instructions-v4/tasks.md +12 -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/llm-integration-v2/plan.md +55 -0
- package/specs/llm-integration-v2/spec.md +61 -0
- package/specs/llm-integration-v2/tasks.md +28 -0
- package/specs/llm-resume-validation/plan.md +50 -0
- package/specs/llm-resume-validation/spec.md +35 -0
- package/specs/llm-resume-validation/tasks.md +19 -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,115 +1,115 @@
|
|
|
1
|
-
# Tasks: coerencia-do-sistema
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: done
|
|
6
|
-
- **Criado em**: 2026-07-15
|
|
7
|
-
|
|
8
|
-
> Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
|
|
9
|
-
|
|
10
|
-
Ordem do plano §7: o scanner e seus testes primeiro (nada o consome), depois os três checks, depois
|
|
11
|
-
rodar o doctor e corrigir o que ele acusar. O CI pega de graça — `tools:doctor` já é step (ADR-0024).
|
|
12
|
-
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
## T1 — `doc-graph.mjs`: o scanner puro
|
|
16
|
-
- **Owner**: Worker
|
|
17
|
-
- **Estimativa**: M
|
|
18
|
-
- **Depende de**: —
|
|
19
|
-
- **Paths**: `lib/core/doc-graph.mjs`, `test/doc-graph.test.js`
|
|
20
|
-
- **Escopo**: leitura pura, zero juízo de severidade. É a parte difícil — todo o risco da spec mora
|
|
21
|
-
aqui, no não-gerar-falso-positivo.
|
|
22
|
-
- **Done quando**:
|
|
23
|
-
- [ ] `scanCommands(env)` devolve `{ file, line, command }` para cada `forja <cmd>` / `npm run <cmd>`
|
|
24
|
-
onde `<cmd>` tem ao menos um `:` (o discriminador do plano §D4)
|
|
25
|
-
- [ ] `scanLinks(env)` devolve `{ file, line, target }` para links markdown **relativos**; ignora
|
|
26
|
-
`http(s)://` e âncoras (`#sec`). Link para diretório (`memory/90-decisions/`) conta como alvo
|
|
27
|
-
- [ ] `projectCommands(env)` **deriva** a allowlist das keys do bloco `"scripts"` dos
|
|
28
|
-
`lib/generators/*.js` — nunca uma lista literal (plano §D2). Retorna Set
|
|
29
|
-
- [ ] `DOC_SURFACES` exportado; escaneia `docs/` (menos `archive/`), `prompts/`, `.claude/agents/`
|
|
30
|
-
e os `.md` de raiz. **Não** varre `boilerplates/`, `specs/`, `memory/` (plano §D3)
|
|
31
|
-
- [ ] `env` injetável (`{ root, fs }`) no padrão de `checks.mjs`, para os testes não tocarem o disco
|
|
32
|
-
- [ ] `test/doc-graph.test.js`: fixtures cobrindo comando com/sem `:`, link relativo/http/âncora/
|
|
33
|
-
diretório, e a derivação pegando um `"foo:bar"` de um gerador de fixture
|
|
34
|
-
|
|
35
|
-
## T2 — Check `docs-commands` (critical)
|
|
36
|
-
- **Owner**: Worker
|
|
37
|
-
- **Estimativa**: P
|
|
38
|
-
- **Depende de**: T1
|
|
39
|
-
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
40
|
-
- **Done quando**:
|
|
41
|
-
- [ ] `scope: 'repo'`, guardado por `isFrameworkRepo(env)` — não roda numa instalação `forjajs`
|
|
42
|
-
- [ ] Reprova (critical) quando comando citado ∉ `registry ∪ projectCommands` (AC-1, AC-2)
|
|
43
|
-
- [ ] `detail` nomeia `file:line` e o comando ofensor; `fix` diz "renomeie ou remova a citação"
|
|
44
|
-
— nunca "não escreva" (kill criteria do plano §8)
|
|
45
|
-
- [ ] **Teste do falso positivo (AC-2, a prova de fogo)**: doc citando `npm run start:dev` (comando
|
|
46
|
-
do projeto gerado) **não** reprova; doc citando `forja fantasma:x` reprova
|
|
47
|
-
- [ ] Teste: comando real do registry citado passa
|
|
48
|
-
|
|
49
|
-
## T3 — Checks `commands-documented` e `docs-links` (warn)
|
|
50
|
-
- **Owner**: Worker
|
|
51
|
-
- **Estimativa**: P
|
|
52
|
-
- **Depende de**: T1
|
|
53
|
-
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
54
|
-
- **Done quando**:
|
|
55
|
-
- [ ] `commands-documented` (**warn**): comando do registry citado em nenhuma superfície → aviso
|
|
56
|
-
com "documente em algum `.md` ou remova do registry" (AC-3). `worstStatus` não escala warn
|
|
57
|
-
- [ ] `docs-links` (**warn**): link relativo sem alvo → aviso com `file:line` e o alvo (AC-4)
|
|
58
|
-
- [ ] Ambos `scope: 'repo'`, guardados por `isFrameworkRepo`
|
|
59
|
-
- [ ] Teste de cada um nos dois estados (são/quebrado)
|
|
60
|
-
- [ ] Teste garantindo que os três checks novos são `skipped` fora do repo do framework
|
|
61
|
-
|
|
62
|
-
## T4 — Rodar o gate e reconciliar a realidade
|
|
63
|
-
- **Owner**: Worker
|
|
64
|
-
- **Estimativa**: P
|
|
65
|
-
- **Depende de**: T2, T3
|
|
66
|
-
- **Paths**: `docs/`, `README.md`/`README.en.md`, conforme o gate acusar
|
|
67
|
-
- **Escopo**: o primeiro `tools:doctor` com os checks ligados é o teste real — ele deve **concordar
|
|
68
|
-
com as correções manuais** já feitas (a doc foi limpa na v1.1.4), não inventar trabalho novo.
|
|
69
|
-
- **Done quando**:
|
|
70
|
-
- [ ] `forja tools:doctor` roda com os 3 checks e o núcleo fica **verde ou só com warns**
|
|
71
|
-
- [ ] Qualquer `docs-commands` crítico remanescente é corrigido na fonte (renomear/remover citação)
|
|
72
|
-
- [ ] AC-10: `memory:extract` — documentar numa superfície escaneada **ou** remover do registry.
|
|
73
|
-
Decisão de quem conhece o uso; qualquer das duas fecha o `commands-documented` warn
|
|
74
|
-
- [ ] `docs-links` warns zerados ou reduzidos a alvos que se decide criar depois (registrar quais)
|
|
75
|
-
|
|
76
|
-
## T5 — Validação executável do AC-2
|
|
77
|
-
- **Owner**: Worker
|
|
78
|
-
- **Estimativa**: P
|
|
79
|
-
- **Depende de**: T2
|
|
80
|
-
- **Paths**: `test/health.test.js` (ou um teste dedicado)
|
|
81
|
-
- **Escopo**: garantir que a derivação é *real*, não que o teste passou por sorte.
|
|
82
|
-
- **Done quando**:
|
|
83
|
-
- [ ] Teste que injeta um `"foo:bar"` no bloco `scripts` de um gerador de fixture e confirma que
|
|
84
|
-
`docs-commands` passa a **aceitar** `foo:bar` na doc — provando que a allowlist segue o
|
|
85
|
-
gerador, não uma lista congelada (plano §7)
|
|
86
|
-
|
|
87
|
-
## T6 — ADR-0025 e CI
|
|
88
|
-
- **Owner**: SDD Architect + Worker
|
|
89
|
-
- **Estimativa**: P
|
|
90
|
-
- **Depende de**: T2, T3, T4
|
|
91
|
-
- **Paths**: `memory/90-decisions/0025-*.md`, `.github/workflows/ci.yml` (verificar)
|
|
92
|
-
- **Done quando**:
|
|
93
|
-
- [ ] ADR-0025 registra D1 (scanner puro), D2 (allowlist derivada) e D3 (escopo = instrução, não
|
|
94
|
-
histórico); referencia ADR-0023/0024 (a família de gate, terceira fronteira) e ADR-0021
|
|
95
|
-
- [ ] Confirmar que o CI **já** exercita os checks via `tools:doctor` (step do ADR-0024) — não deve
|
|
96
|
-
precisar de mudança no workflow; se precisar, ajustar
|
|
97
|
-
- [ ] `npm test` verde, `spec:check` verde
|
|
98
|
-
|
|
99
|
-
---
|
|
100
|
-
|
|
101
|
-
## Validação final
|
|
102
|
-
- [ ] Renomear um comando do registry num teste e confirmar que `docs-commands` **acusa** a doc que
|
|
103
|
-
ainda usa o nome antigo — a métrica de sucesso da spec (renomear vira ato detectável)
|
|
104
|
-
- [ ] Suíte completa verde; `tools:doctor` verde/warn; spec → `done`
|
|
105
|
-
|
|
106
|
-
## Nota de implementação — o code-span é endurecimento, não requisito
|
|
107
|
-
O plano §4 menciona "só dentro de bloco/span de código". A auditoria manual que originou esta spec
|
|
108
|
-
usou **scan de arquivo inteiro** + discriminador `:` e funcionou — os únicos falsos positivos foram
|
|
109
|
-
os comandos do projeto gerado, tratados pela allowlist (T2). Começar pelo scan de arquivo inteiro; só
|
|
110
|
-
adicionar consciência de code-span **se** T2/T4 revelarem um falso positivo que o `:` não filtre. Não
|
|
111
|
-
construir parser de markdown para um problema que ainda não apareceu (plano §6).
|
|
112
|
-
|
|
113
|
-
## Handoffs entre agentes
|
|
114
|
-
Worker (T1-T5), SDD Architect (T6). Handoff a cada fronteira via `forja agent:route` — 7 campos
|
|
115
|
-
(ADR-0005).
|
|
1
|
+
# Tasks: coerencia-do-sistema
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-07-15
|
|
7
|
+
|
|
8
|
+
> Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
|
|
9
|
+
|
|
10
|
+
Ordem do plano §7: o scanner e seus testes primeiro (nada o consome), depois os três checks, depois
|
|
11
|
+
rodar o doctor e corrigir o que ele acusar. O CI pega de graça — `tools:doctor` já é step (ADR-0024).
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## T1 — `doc-graph.mjs`: o scanner puro
|
|
16
|
+
- **Owner**: Worker
|
|
17
|
+
- **Estimativa**: M
|
|
18
|
+
- **Depende de**: —
|
|
19
|
+
- **Paths**: `lib/core/doc-graph.mjs`, `test/doc-graph.test.js`
|
|
20
|
+
- **Escopo**: leitura pura, zero juízo de severidade. É a parte difícil — todo o risco da spec mora
|
|
21
|
+
aqui, no não-gerar-falso-positivo.
|
|
22
|
+
- **Done quando**:
|
|
23
|
+
- [ ] `scanCommands(env)` devolve `{ file, line, command }` para cada `forja <cmd>` / `npm run <cmd>`
|
|
24
|
+
onde `<cmd>` tem ao menos um `:` (o discriminador do plano §D4)
|
|
25
|
+
- [ ] `scanLinks(env)` devolve `{ file, line, target }` para links markdown **relativos**; ignora
|
|
26
|
+
`http(s)://` e âncoras (`#sec`). Link para diretório (`memory/90-decisions/`) conta como alvo
|
|
27
|
+
- [ ] `projectCommands(env)` **deriva** a allowlist das keys do bloco `"scripts"` dos
|
|
28
|
+
`lib/generators/*.js` — nunca uma lista literal (plano §D2). Retorna Set
|
|
29
|
+
- [ ] `DOC_SURFACES` exportado; escaneia `docs/` (menos `archive/`), `prompts/`, `.claude/agents/`
|
|
30
|
+
e os `.md` de raiz. **Não** varre `boilerplates/`, `specs/`, `memory/` (plano §D3)
|
|
31
|
+
- [ ] `env` injetável (`{ root, fs }`) no padrão de `checks.mjs`, para os testes não tocarem o disco
|
|
32
|
+
- [ ] `test/doc-graph.test.js`: fixtures cobrindo comando com/sem `:`, link relativo/http/âncora/
|
|
33
|
+
diretório, e a derivação pegando um `"foo:bar"` de um gerador de fixture
|
|
34
|
+
|
|
35
|
+
## T2 — Check `docs-commands` (critical)
|
|
36
|
+
- **Owner**: Worker
|
|
37
|
+
- **Estimativa**: P
|
|
38
|
+
- **Depende de**: T1
|
|
39
|
+
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
40
|
+
- **Done quando**:
|
|
41
|
+
- [ ] `scope: 'repo'`, guardado por `isFrameworkRepo(env)` — não roda numa instalação `forjajs`
|
|
42
|
+
- [ ] Reprova (critical) quando comando citado ∉ `registry ∪ projectCommands` (AC-1, AC-2)
|
|
43
|
+
- [ ] `detail` nomeia `file:line` e o comando ofensor; `fix` diz "renomeie ou remova a citação"
|
|
44
|
+
— nunca "não escreva" (kill criteria do plano §8)
|
|
45
|
+
- [ ] **Teste do falso positivo (AC-2, a prova de fogo)**: doc citando `npm run start:dev` (comando
|
|
46
|
+
do projeto gerado) **não** reprova; doc citando `forja fantasma:x` reprova
|
|
47
|
+
- [ ] Teste: comando real do registry citado passa
|
|
48
|
+
|
|
49
|
+
## T3 — Checks `commands-documented` e `docs-links` (warn)
|
|
50
|
+
- **Owner**: Worker
|
|
51
|
+
- **Estimativa**: P
|
|
52
|
+
- **Depende de**: T1
|
|
53
|
+
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
54
|
+
- **Done quando**:
|
|
55
|
+
- [ ] `commands-documented` (**warn**): comando do registry citado em nenhuma superfície → aviso
|
|
56
|
+
com "documente em algum `.md` ou remova do registry" (AC-3). `worstStatus` não escala warn
|
|
57
|
+
- [ ] `docs-links` (**warn**): link relativo sem alvo → aviso com `file:line` e o alvo (AC-4)
|
|
58
|
+
- [ ] Ambos `scope: 'repo'`, guardados por `isFrameworkRepo`
|
|
59
|
+
- [ ] Teste de cada um nos dois estados (são/quebrado)
|
|
60
|
+
- [ ] Teste garantindo que os três checks novos são `skipped` fora do repo do framework
|
|
61
|
+
|
|
62
|
+
## T4 — Rodar o gate e reconciliar a realidade
|
|
63
|
+
- **Owner**: Worker
|
|
64
|
+
- **Estimativa**: P
|
|
65
|
+
- **Depende de**: T2, T3
|
|
66
|
+
- **Paths**: `docs/`, `README.md`/`README.en.md`, conforme o gate acusar
|
|
67
|
+
- **Escopo**: o primeiro `tools:doctor` com os checks ligados é o teste real — ele deve **concordar
|
|
68
|
+
com as correções manuais** já feitas (a doc foi limpa na v1.1.4), não inventar trabalho novo.
|
|
69
|
+
- **Done quando**:
|
|
70
|
+
- [ ] `forja tools:doctor` roda com os 3 checks e o núcleo fica **verde ou só com warns**
|
|
71
|
+
- [ ] Qualquer `docs-commands` crítico remanescente é corrigido na fonte (renomear/remover citação)
|
|
72
|
+
- [ ] AC-10: `memory:extract` — documentar numa superfície escaneada **ou** remover do registry.
|
|
73
|
+
Decisão de quem conhece o uso; qualquer das duas fecha o `commands-documented` warn
|
|
74
|
+
- [ ] `docs-links` warns zerados ou reduzidos a alvos que se decide criar depois (registrar quais)
|
|
75
|
+
|
|
76
|
+
## T5 — Validação executável do AC-2
|
|
77
|
+
- **Owner**: Worker
|
|
78
|
+
- **Estimativa**: P
|
|
79
|
+
- **Depende de**: T2
|
|
80
|
+
- **Paths**: `test/health.test.js` (ou um teste dedicado)
|
|
81
|
+
- **Escopo**: garantir que a derivação é *real*, não que o teste passou por sorte.
|
|
82
|
+
- **Done quando**:
|
|
83
|
+
- [ ] Teste que injeta um `"foo:bar"` no bloco `scripts` de um gerador de fixture e confirma que
|
|
84
|
+
`docs-commands` passa a **aceitar** `foo:bar` na doc — provando que a allowlist segue o
|
|
85
|
+
gerador, não uma lista congelada (plano §7)
|
|
86
|
+
|
|
87
|
+
## T6 — ADR-0025 e CI
|
|
88
|
+
- **Owner**: SDD Architect + Worker
|
|
89
|
+
- **Estimativa**: P
|
|
90
|
+
- **Depende de**: T2, T3, T4
|
|
91
|
+
- **Paths**: `memory/90-decisions/0025-*.md`, `.github/workflows/ci.yml` (verificar)
|
|
92
|
+
- **Done quando**:
|
|
93
|
+
- [ ] ADR-0025 registra D1 (scanner puro), D2 (allowlist derivada) e D3 (escopo = instrução, não
|
|
94
|
+
histórico); referencia ADR-0023/0024 (a família de gate, terceira fronteira) e ADR-0021
|
|
95
|
+
- [ ] Confirmar que o CI **já** exercita os checks via `tools:doctor` (step do ADR-0024) — não deve
|
|
96
|
+
precisar de mudança no workflow; se precisar, ajustar
|
|
97
|
+
- [ ] `npm test` verde, `spec:check` verde
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## Validação final
|
|
102
|
+
- [ ] Renomear um comando do registry num teste e confirmar que `docs-commands` **acusa** a doc que
|
|
103
|
+
ainda usa o nome antigo — a métrica de sucesso da spec (renomear vira ato detectável)
|
|
104
|
+
- [ ] Suíte completa verde; `tools:doctor` verde/warn; spec → `done`
|
|
105
|
+
|
|
106
|
+
## Nota de implementação — o code-span é endurecimento, não requisito
|
|
107
|
+
O plano §4 menciona "só dentro de bloco/span de código". A auditoria manual que originou esta spec
|
|
108
|
+
usou **scan de arquivo inteiro** + discriminador `:` e funcionou — os únicos falsos positivos foram
|
|
109
|
+
os comandos do projeto gerado, tratados pela allowlist (T2). Começar pelo scan de arquivo inteiro; só
|
|
110
|
+
adicionar consciência de code-span **se** T2/T4 revelarem um falso positivo que o `:` não filtre. Não
|
|
111
|
+
construir parser de markdown para um problema que ainda não apareceu (plano §6).
|
|
112
|
+
|
|
113
|
+
## Handoffs entre agentes
|
|
114
|
+
Worker (T1-T5), SDD Architect (T6). Handoff a cada fronteira via `forja agent:route` — 7 campos
|
|
115
|
+
(ADR-0005).
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
# Spec: orçamento de autonomia por custo real (cost-aware autonomy budget)
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-029
|
|
4
|
+
- **Status**: done — AC-1 a AC-6 implementados. Nota de escopo: AC-5 ("por domínio/projeto") foi entregue como custo agregado por MODELO dentro do workspace/DB do projeto (cada projeto já opera seu próprio workspace via `FORJA_WORKSPACE`), não como um campo `projectId` explícito em `Observation` — ver ADR-0077, seção "Alternativas consideradas", para o porquê.
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-08-31
|
|
7
|
+
- **Sprint alvo**: <a definir>
|
|
8
|
+
- **ADRs relacionadas**: ADR-0074 (LLM Fit Loop / adapters de CLI), ADR-0077 (esta spec — orçamento de autonomia por custo real) — este spec estende `PolicyLimits`, que acabou de ganhar enforcement real em `CapabilityRegistry.execute` (auditoria de segurança 2026-08-31)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
|
|
12
|
+
`token:economy` **mede e prova** economia de tokens (~40-60% vs. exploração fria), e o LLM Fit Loop já
|
|
13
|
+
roteia entre múltiplos providers por papel/tarefa. Mas nenhum dos dois fala a língua que realmente
|
|
14
|
+
importa pra quem paga a conta: **dinheiro**. Um profile `codex:default` e um `claude:opus` podem gastar
|
|
15
|
+
o mesmo número de tokens e custar ordens de magnitude diferentes. `PolicyLimits` (`maxTokens`,
|
|
16
|
+
`maxFiles`, `maxDurationMs`, `maxRetries`) não tem noção de custo — uma regra de política não consegue
|
|
17
|
+
dizer "esta categoria de trabalho não pode passar de $2 por execução", mesmo que consiga dizer "não
|
|
18
|
+
pode passar de 5000 tokens". Para quem opera múltiplos produtos/clientes ao mesmo tempo (o usuário
|
|
19
|
+
principal do Forja, por definição do próprio README), isso significa descobrir o estouro de custo só
|
|
20
|
+
na fatura do provider — depois do fato, não antes.
|
|
21
|
+
|
|
22
|
+
## 2. Proposta de valor
|
|
23
|
+
|
|
24
|
+
Toda decisão de política pode declarar um teto de custo real em dólares (`maxCostUsd`), aplicado no
|
|
25
|
+
mesmo ponto onde `maxFiles`/`maxTokens` já são aplicados. `token:economy` ganha uma dimensão de custo
|
|
26
|
+
real (`cost:economy`), calculada a partir de uma tabela de preço por provider — local, versionada no
|
|
27
|
+
repo, sem chamada de rede. **"Economia de tokens" vira "economia de custo"**, mensurável e limitável.
|
|
28
|
+
|
|
29
|
+
## 3. User stories
|
|
30
|
+
|
|
31
|
+
- **Como** consultor rodando produtos de múltiplos clientes ao mesmo tempo, **quero** definir um teto
|
|
32
|
+
de gasto por sprint ou por categoria de risco, **para que** um agente autônomo não estoure orçamento
|
|
33
|
+
usando um provider caro sem eu perceber até tarde.
|
|
34
|
+
- **Como** dono de um projeto pequeno, **quero** ver quanto cada sprint custou de verdade (não só em
|
|
35
|
+
tokens), **para que** eu decida racionalmente qual provider vale o custo pra qual tipo de tarefa.
|
|
36
|
+
- **Como** governance, **quero** que uma execução seja bloqueada (não só logada) quando ultrapassa o
|
|
37
|
+
teto de custo, **para que** o limite seja um freio real, não uma métrica de retrovisor.
|
|
38
|
+
|
|
39
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
40
|
+
|
|
41
|
+
- [x] AC-1: `PolicyLimits` ganha `maxCostUsd?: number`; uma regra `ALLOW_WITH_LIMITS` pode declará-lo.
|
|
42
|
+
`packages/policy/src/index.ts`.
|
|
43
|
+
- [x] AC-2: `CapabilityRegistry.execute` (função `checkLimits`, já existente) recusa a chamada com
|
|
44
|
+
`POLICY_LIMIT_EXCEEDED` quando o custo projetado da execução ultrapassa `maxCostUsd` — mesmo
|
|
45
|
+
padrão hoje usado para `maxFiles`/`maxTokens`. `packages/core/src/index.ts` (`CapabilityExecutionRequest.estimatedCostUsd`,
|
|
46
|
+
calculado pelo chamador — ver ADR-0077).
|
|
47
|
+
- [x] AC-3: existe uma tabela de preço por provider/modelo (`$/1K tokens` input e output, separados),
|
|
48
|
+
versionada em arquivo próprio (`lib/core/model-pricing.json`), carregada localmente — sem
|
|
49
|
+
rede. Loader/validador em `lib/core/model-pricing.ts`.
|
|
50
|
+
- [x] AC-4: quando o provider/modelo de uma execução não está na tabela de preço, a execução **não é
|
|
51
|
+
bloqueada** (fail-open para o enforcement de custo especificamente — divergente do resto do
|
|
52
|
+
framework, e por isso citado explicitamente aqui): ela prossegue e um aviso é registrado
|
|
53
|
+
(`llm:doctor` e o próprio `llm:run` avisam em stderr) pedindo para a tabela ser atualizada. Preço
|
|
54
|
+
desconhecido não vira bloqueio de trabalho legítimo. `llm:doctor` também sinaliza preço `stale`
|
|
55
|
+
(> 90 dias sem revisão).
|
|
56
|
+
- [x] AC-5: `cost:economy` — comando novo (não seção em `token:economy`; ver ADR-0077 para o porquê) —
|
|
57
|
+
reporta custo real acumulado por modelo a partir das observações reais do workspace/projeto
|
|
58
|
+
atual. Narrowing: agregação é por modelo dentro do workspace do projeto, não por um campo
|
|
59
|
+
`projectId` explícito em `Observation` (o workspace já é o limite de projeto — ver ADR-0077).
|
|
60
|
+
- [x] AC-6: `Observation.cost` passa a ser populado com o custo real calculado por `forja llm:run`
|
|
61
|
+
quando o preço é conhecido (permanece `0`, como antes desta spec, quando o preço é desconhecido —
|
|
62
|
+
o aviso descrito no AC-4 cobre esse caso).
|
|
63
|
+
|
|
64
|
+
## 5. Escopo
|
|
65
|
+
|
|
66
|
+
**Dentro**:
|
|
67
|
+
- Extensão de `PolicyLimits`/`PolicyDecision.limits` com `maxCostUsd`.
|
|
68
|
+
- Enforcement em `CapabilityRegistry.checkLimits`.
|
|
69
|
+
- Tabela de preço local, estática, versionada.
|
|
70
|
+
- Cálculo de custo real a partir de tokens de entrada/saída já capturados em `Observation`.
|
|
71
|
+
- Relatório de custo no CLI (`token:economy` estendido ou `cost:economy` novo).
|
|
72
|
+
|
|
73
|
+
**Fora** (explícito, evita scope creep):
|
|
74
|
+
- Integração com billing/API de faturamento real dos providers (Anthropic, OpenAI, etc.) — a tabela é
|
|
75
|
+
estática e mantida manualmente/por PR, não sincronizada automaticamente.
|
|
76
|
+
- Orçamento preditivo ("quanto vai custar antes de rodar") — este spec é sobre limitar e reportar
|
|
77
|
+
custo real medido, não estimar custo futuro.
|
|
78
|
+
- Alertas proativos (Slack, e-mail) — fica para uma spec de notificação, se algum dia existir.
|
|
79
|
+
|
|
80
|
+
## 6. NFRs / restrições
|
|
81
|
+
|
|
82
|
+
- **Local-first**: nenhuma chamada de rede para obter preço — a tabela vive no repo.
|
|
83
|
+
- **Fail-open por design em um ponto específico**: preço desconhecido não bloqueia (ver AC-4) — é a
|
|
84
|
+
única exceção deliberada ao princípio "autonomia supervisionada por padrão"; deve ficar documentada
|
|
85
|
+
como tal na ADR que resultar deste spec, para não ser lida como inconsistência.
|
|
86
|
+
- **Compatibilidade**: `maxCostUsd` é opcional em todo lugar — regras de política existentes sem esse
|
|
87
|
+
campo continuam funcionando exatamente como hoje.
|
|
88
|
+
|
|
89
|
+
## 7. Riscos e mitigação
|
|
90
|
+
|
|
91
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
92
|
+
|---|---|---|---|
|
|
93
|
+
| Tabela de preço desatualizada (provider muda preço) | Alta (preços de LLM mudam com frequência) | Média — custo reportado fica impreciso, não custo real cobrado | Preço tem campo `asOf` (data); `llm:doctor` avisa quando `asOf` está velho demais (ex. > 90 dias) |
|
|
94
|
+
| Confundir "custo estimado" com "custo real cobrado" | Média | Média — decisão de negócio baseada em número errado | Nomear explicitamente nos relatórios ("estimativa baseada em tabela local, não fatura") |
|
|
95
|
+
| Escopo crescer para virar um mini sistema de billing | Média | Alta (vira outro projeto) | Este spec para deliberadamente no cálculo local — qualquer integração com billing real vira spec própria |
|
|
96
|
+
|
|
97
|
+
## 8. Métricas de sucesso
|
|
98
|
+
|
|
99
|
+
30 dias após o release: um usuário consegue responder "quanto cada projeto/sprint custou de verdade
|
|
100
|
+
em dólares" sem sair do Forja e sem abrir o painel de billing de nenhum provider — e pelo menos uma
|
|
101
|
+
execução real foi bloqueada (ou teria sido, em modo relatório) por estourar `maxCostUsd` antes de gerar
|
|
102
|
+
uma surpresa na fatura.
|
|
@@ -1,71 +1,71 @@
|
|
|
1
|
-
# Plan: dev-token-assets-db
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Status**: approved
|
|
5
|
-
- **Criado em**: 2026-06-02
|
|
6
|
-
|
|
7
|
-
## 1. Abordagem tecnica
|
|
8
|
-
Adicionar comandos CLI pequenos e aditivos. `context-ops.mjs` gera artefatos compactos e mede token budget. `memory-schema.mjs` cria tabelas auxiliares no SQLite sem alterar contratos existentes. O catalogo de boilerplates/design e derivado dos arquivos atuais, evitando manutencao manual inicial.
|
|
9
|
-
|
|
10
|
-
## 2. Modulos afetados
|
|
11
|
-
| Caminho | Mudanca | Risco |
|
|
12
|
-
|---|---|---|
|
|
13
|
-
| `scripts/context-ops.mjs` | novo CLI para budget, sprint pack, brief e catalogo | M |
|
|
14
|
-
| `scripts/memory-schema.mjs` | novo schema auxiliar SQLite | M |
|
|
15
|
-
| `package.json` | expor scripts operacionais | B |
|
|
16
|
-
| `docs/manual-operacional-cli-sdd-gsd.md` | orientar nova rotina | B |
|
|
17
|
-
| `.context/` | novos artefatos gerados | B |
|
|
18
|
-
|
|
19
|
-
## 3. Fluxo
|
|
20
|
-
```text
|
|
21
|
-
context:sprint
|
|
22
|
-
-> le sprint, specs, handoffs, ADRs
|
|
23
|
-
-> gera .context/sprint-pack.md
|
|
24
|
-
-> registra context_run no SQLite
|
|
25
|
-
|
|
26
|
-
agent:brief <role> <slug>
|
|
27
|
-
-> le spec/plan/tasks/runbook/handoffs
|
|
28
|
-
-> gera .context/agent-brief-<role>-<slug>.md
|
|
29
|
-
|
|
30
|
-
context:budget <slug|arquivo>
|
|
31
|
-
-> estima tokens
|
|
32
|
-
-> compara com limite
|
|
33
|
-
-> falha se exceder
|
|
34
|
-
|
|
35
|
-
catalog:assets
|
|
36
|
-
-> varre boilerplates/design-md
|
|
37
|
-
-> gera .context/asset-catalog.md
|
|
38
|
-
-> popula asset_catalog
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
## 4. Contratos
|
|
42
|
-
```bash
|
|
43
|
-
npm run memory:schema
|
|
44
|
-
npm run context:budget -- <slug|arquivo> [limite]
|
|
45
|
-
npm run context:sprint
|
|
46
|
-
npm run agent:brief -- <role> <slug>
|
|
47
|
-
npm run catalog:assets
|
|
48
|
-
npm run token:benchmark
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
## 5. Decisoes
|
|
52
|
-
**D1**: Usar SQLite relacional auxiliar em vez de embeddings nesta fase. Motivo: menor complexidade e sem dependencia externa.
|
|
53
|
-
|
|
54
|
-
**D2**: Catalogo gerado, nao escrito manualmente. Motivo: reduz drift.
|
|
55
|
-
|
|
56
|
-
**D3**: Budget por estimativa simples `chars / 4`. Motivo: suficiente para gate operacional e sem dependencia de tokenizer.
|
|
57
|
-
|
|
58
|
-
## 6. Dependencias
|
|
59
|
-
- `better-sqlite3`, ja existente.
|
|
60
|
-
- Sem rede e sem pacotes novos.
|
|
61
|
-
|
|
62
|
-
## 7. Rollout
|
|
63
|
-
- Criar schema auxiliar.
|
|
64
|
-
- Gerar sprint pack e asset catalog.
|
|
65
|
-
- Rodar budget nos novos artefatos.
|
|
66
|
-
- Atualizar manual.
|
|
67
|
-
|
|
68
|
-
## 8. Sinais de fracasso
|
|
69
|
-
- Context pack ultrapassar 8k tokens sem motivo.
|
|
70
|
-
- Agent brief repetir spec inteira.
|
|
71
|
-
- Catalogo exigir manutencao manual constante.
|
|
1
|
+
# Plan: dev-token-assets-db
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-06-02
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem tecnica
|
|
8
|
+
Adicionar comandos CLI pequenos e aditivos. `context-ops.mjs` gera artefatos compactos e mede token budget. `memory-schema.mjs` cria tabelas auxiliares no SQLite sem alterar contratos existentes. O catalogo de boilerplates/design e derivado dos arquivos atuais, evitando manutencao manual inicial.
|
|
9
|
+
|
|
10
|
+
## 2. Modulos afetados
|
|
11
|
+
| Caminho | Mudanca | Risco |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| `scripts/context-ops.mjs` | novo CLI para budget, sprint pack, brief e catalogo | M |
|
|
14
|
+
| `scripts/memory-schema.mjs` | novo schema auxiliar SQLite | M |
|
|
15
|
+
| `package.json` | expor scripts operacionais | B |
|
|
16
|
+
| `docs/manual-operacional-cli-sdd-gsd.md` | orientar nova rotina | B |
|
|
17
|
+
| `.context/` | novos artefatos gerados | B |
|
|
18
|
+
|
|
19
|
+
## 3. Fluxo
|
|
20
|
+
```text
|
|
21
|
+
context:sprint
|
|
22
|
+
-> le sprint, specs, handoffs, ADRs
|
|
23
|
+
-> gera .context/sprint-pack.md
|
|
24
|
+
-> registra context_run no SQLite
|
|
25
|
+
|
|
26
|
+
agent:brief <role> <slug>
|
|
27
|
+
-> le spec/plan/tasks/runbook/handoffs
|
|
28
|
+
-> gera .context/agent-brief-<role>-<slug>.md
|
|
29
|
+
|
|
30
|
+
context:budget <slug|arquivo>
|
|
31
|
+
-> estima tokens
|
|
32
|
+
-> compara com limite
|
|
33
|
+
-> falha se exceder
|
|
34
|
+
|
|
35
|
+
catalog:assets
|
|
36
|
+
-> varre boilerplates/design-md
|
|
37
|
+
-> gera .context/asset-catalog.md
|
|
38
|
+
-> popula asset_catalog
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## 4. Contratos
|
|
42
|
+
```bash
|
|
43
|
+
npm run memory:schema
|
|
44
|
+
npm run context:budget -- <slug|arquivo> [limite]
|
|
45
|
+
npm run context:sprint
|
|
46
|
+
npm run agent:brief -- <role> <slug>
|
|
47
|
+
npm run catalog:assets
|
|
48
|
+
npm run token:benchmark
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## 5. Decisoes
|
|
52
|
+
**D1**: Usar SQLite relacional auxiliar em vez de embeddings nesta fase. Motivo: menor complexidade e sem dependencia externa.
|
|
53
|
+
|
|
54
|
+
**D2**: Catalogo gerado, nao escrito manualmente. Motivo: reduz drift.
|
|
55
|
+
|
|
56
|
+
**D3**: Budget por estimativa simples `chars / 4`. Motivo: suficiente para gate operacional e sem dependencia de tokenizer.
|
|
57
|
+
|
|
58
|
+
## 6. Dependencias
|
|
59
|
+
- `better-sqlite3`, ja existente.
|
|
60
|
+
- Sem rede e sem pacotes novos.
|
|
61
|
+
|
|
62
|
+
## 7. Rollout
|
|
63
|
+
- Criar schema auxiliar.
|
|
64
|
+
- Gerar sprint pack e asset catalog.
|
|
65
|
+
- Rodar budget nos novos artefatos.
|
|
66
|
+
- Atualizar manual.
|
|
67
|
+
|
|
68
|
+
## 8. Sinais de fracasso
|
|
69
|
+
- Context pack ultrapassar 8k tokens sem motivo.
|
|
70
|
+
- Agent brief repetir spec inteira.
|
|
71
|
+
- Catalogo exigir manutencao manual constante.
|
|
@@ -1,58 +1,58 @@
|
|
|
1
|
-
# Spec: dev-token-assets-db
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-DEV-TOKEN-ASSETS-001
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: orchestrator
|
|
6
|
-
- **Criado em**: 2026-06-02
|
|
7
|
-
- **Sprint alvo**: refinamento-cli-2026-06
|
|
8
|
-
- **ADRs relacionadas**: ADR-0003, ADR-0005, ADR-0007, ADR-0008, ADR-0009
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
O framework ja possui SDD, GSD, memoria SQLite, boilerplates e design-md, mas ainda consome contexto demais porque nao ha gate de budget por tarefa, resumo compacto por sprint, brief de agente ou catalogo operacional dos assets. Boilerplates e design system tambem existem como arquivos soltos, sem indice consultavel no banco.
|
|
12
|
-
|
|
13
|
-
## 2. Proposta de valor
|
|
14
|
-
Transformar contexto, boilerplates, referencias de design e metadados de specs em ativos operacionais compactos, consultaveis por CLI e armazenaveis no SQLite, reduzindo tokens e aumentando velocidade de desenvolvimento.
|
|
15
|
-
|
|
16
|
-
## 3. User stories
|
|
17
|
-
- **Como** Orchestrator, **quero** gerar um sprint pack compacto, **para que** qualquer agente comece com contexto minimo suficiente.
|
|
18
|
-
- **Como** Worker, **quero** receber um agent brief por papel e feature, **para que** eu nao precise carregar spec/plan/tasks inteiros sempre.
|
|
19
|
-
- **Como** Governance, **quero** bloquear contextos acima do budget, **para que** a operacao nao desperdice tokens.
|
|
20
|
-
- **Como** Architect, **quero** catalogar boilerplates e referencias de design, **para que** a escolha de base tecnica/visual seja rastreavel.
|
|
21
|
-
- **Como** operador do framework, **quero** metadados no SQLite, **para que** memoria, specs e assets sejam consultaveis sem varrer o repositorio inteiro.
|
|
22
|
-
|
|
23
|
-
## 4. Criterios de aceite
|
|
24
|
-
- [x] AC-1: `npm run context:budget -- <slug|arquivo>` estima tokens e falha acima do limite.
|
|
25
|
-
- [x] AC-2: `npm run context:sprint` gera `.context/sprint-pack.md`.
|
|
26
|
-
- [x] AC-3: `npm run agent:brief -- <role> <slug>` gera brief compacto por papel.
|
|
27
|
-
- [x] AC-4: `npm run catalog:assets` gera catalogo de boilerplates/design-md.
|
|
28
|
-
- [x] AC-5: `npm run memory:schema` cria tabelas auxiliares para summaries, context runs e asset catalog.
|
|
29
|
-
- [x] AC-6: boilerplates tem manifests padronizados com stack, casos de uso, comandos e gates.
|
|
30
|
-
- [x] AC-7: design-md tem tokens/padroes normalizados por superficie.
|
|
31
|
-
- [x] AC-8: `sync:universal` popula tabelas auxiliares automaticamente.
|
|
32
|
-
|
|
33
|
-
## 5. Escopo
|
|
34
|
-
**Dentro**:
|
|
35
|
-
- CLI para budget, sprint pack, agent brief e catalogo.
|
|
36
|
-
- Schema auxiliar SQLite para armazenamento melhor.
|
|
37
|
-
- Documentacao operacional da estrategia.
|
|
38
|
-
|
|
39
|
-
**Fora**:
|
|
40
|
-
- Reescrever todos os boilerplates nesta primeira tranche.
|
|
41
|
-
- Migrar dashboard web.
|
|
42
|
-
- Implementar embeddings vetoriais.
|
|
43
|
-
|
|
44
|
-
## 6. NFRs / restricoes
|
|
45
|
-
- Compatibilidade: manter scripts existentes.
|
|
46
|
-
- Token economy: contextos operacionais devem ficar abaixo de 8k tokens por padrao.
|
|
47
|
-
- Banco: tabelas novas devem ser aditivas, sem quebrar `memory_nodes` ou `handoffs`.
|
|
48
|
-
- Operacao: tudo deve rodar por CLI.
|
|
49
|
-
|
|
50
|
-
## 7. Riscos e mitigacao
|
|
51
|
-
| Risco | Probabilidade | Impacto | Mitigacao |
|
|
52
|
-
|---|---|---|---|
|
|
53
|
-
| Catalogo virar mais uma fonte duplicada | M | M | Gerar via CLI a partir dos arquivos reais |
|
|
54
|
-
| Budget bloquear contexto necessario | M | B | Permitir limite customizado por argumento |
|
|
55
|
-
| Schema auxiliar ficar desssincronizado | M | M | Planejar AC-8 para integrar ao sync |
|
|
56
|
-
|
|
57
|
-
## 8. Metricas de sucesso
|
|
58
|
-
Em 30 dias, reduzir em pelo menos 40% o tamanho medio do contexto inicial por tarefa e manter `context:budget` verde em entregas novas.
|
|
1
|
+
# Spec: dev-token-assets-db
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-DEV-TOKEN-ASSETS-001
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: orchestrator
|
|
6
|
+
- **Criado em**: 2026-06-02
|
|
7
|
+
- **Sprint alvo**: refinamento-cli-2026-06
|
|
8
|
+
- **ADRs relacionadas**: ADR-0003, ADR-0005, ADR-0007, ADR-0008, ADR-0009
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O framework ja possui SDD, GSD, memoria SQLite, boilerplates e design-md, mas ainda consome contexto demais porque nao ha gate de budget por tarefa, resumo compacto por sprint, brief de agente ou catalogo operacional dos assets. Boilerplates e design system tambem existem como arquivos soltos, sem indice consultavel no banco.
|
|
12
|
+
|
|
13
|
+
## 2. Proposta de valor
|
|
14
|
+
Transformar contexto, boilerplates, referencias de design e metadados de specs em ativos operacionais compactos, consultaveis por CLI e armazenaveis no SQLite, reduzindo tokens e aumentando velocidade de desenvolvimento.
|
|
15
|
+
|
|
16
|
+
## 3. User stories
|
|
17
|
+
- **Como** Orchestrator, **quero** gerar um sprint pack compacto, **para que** qualquer agente comece com contexto minimo suficiente.
|
|
18
|
+
- **Como** Worker, **quero** receber um agent brief por papel e feature, **para que** eu nao precise carregar spec/plan/tasks inteiros sempre.
|
|
19
|
+
- **Como** Governance, **quero** bloquear contextos acima do budget, **para que** a operacao nao desperdice tokens.
|
|
20
|
+
- **Como** Architect, **quero** catalogar boilerplates e referencias de design, **para que** a escolha de base tecnica/visual seja rastreavel.
|
|
21
|
+
- **Como** operador do framework, **quero** metadados no SQLite, **para que** memoria, specs e assets sejam consultaveis sem varrer o repositorio inteiro.
|
|
22
|
+
|
|
23
|
+
## 4. Criterios de aceite
|
|
24
|
+
- [x] AC-1: `npm run context:budget -- <slug|arquivo>` estima tokens e falha acima do limite.
|
|
25
|
+
- [x] AC-2: `npm run context:sprint` gera `.context/sprint-pack.md`.
|
|
26
|
+
- [x] AC-3: `npm run agent:brief -- <role> <slug>` gera brief compacto por papel.
|
|
27
|
+
- [x] AC-4: `npm run catalog:assets` gera catalogo de boilerplates/design-md.
|
|
28
|
+
- [x] AC-5: `npm run memory:schema` cria tabelas auxiliares para summaries, context runs e asset catalog.
|
|
29
|
+
- [x] AC-6: boilerplates tem manifests padronizados com stack, casos de uso, comandos e gates.
|
|
30
|
+
- [x] AC-7: design-md tem tokens/padroes normalizados por superficie.
|
|
31
|
+
- [x] AC-8: `sync:universal` popula tabelas auxiliares automaticamente.
|
|
32
|
+
|
|
33
|
+
## 5. Escopo
|
|
34
|
+
**Dentro**:
|
|
35
|
+
- CLI para budget, sprint pack, agent brief e catalogo.
|
|
36
|
+
- Schema auxiliar SQLite para armazenamento melhor.
|
|
37
|
+
- Documentacao operacional da estrategia.
|
|
38
|
+
|
|
39
|
+
**Fora**:
|
|
40
|
+
- Reescrever todos os boilerplates nesta primeira tranche.
|
|
41
|
+
- Migrar dashboard web.
|
|
42
|
+
- Implementar embeddings vetoriais.
|
|
43
|
+
|
|
44
|
+
## 6. NFRs / restricoes
|
|
45
|
+
- Compatibilidade: manter scripts existentes.
|
|
46
|
+
- Token economy: contextos operacionais devem ficar abaixo de 8k tokens por padrao.
|
|
47
|
+
- Banco: tabelas novas devem ser aditivas, sem quebrar `memory_nodes` ou `handoffs`.
|
|
48
|
+
- Operacao: tudo deve rodar por CLI.
|
|
49
|
+
|
|
50
|
+
## 7. Riscos e mitigacao
|
|
51
|
+
| Risco | Probabilidade | Impacto | Mitigacao |
|
|
52
|
+
|---|---|---|---|
|
|
53
|
+
| Catalogo virar mais uma fonte duplicada | M | M | Gerar via CLI a partir dos arquivos reais |
|
|
54
|
+
| Budget bloquear contexto necessario | M | B | Permitir limite customizado por argumento |
|
|
55
|
+
| Schema auxiliar ficar desssincronizado | M | M | Planejar AC-8 para integrar ao sync |
|
|
56
|
+
|
|
57
|
+
## 8. Metricas de sucesso
|
|
58
|
+
Em 30 dias, reduzir em pelo menos 40% o tamanho medio do contexto inicial por tarefa e manter `context:budget` verde em entregas novas.
|