forjajs 2.0.2 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -317
- package/README.pt-BR.md +345 -323
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.d.ts +1 -0
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
- 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 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
- 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 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- 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 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -140
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -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.
|
|
@@ -1,58 +1,58 @@
|
|
|
1
|
-
# Tasks: dev-token-assets-db
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: done
|
|
6
|
-
- **Criado em**: 2026-06-02
|
|
7
|
-
|
|
8
|
-
## T1 - Schema auxiliar de memoria
|
|
9
|
-
- **Owner**: Worker
|
|
10
|
-
- **Estimativa**: P
|
|
11
|
-
- **Depende de**: -
|
|
12
|
-
- **Paths**: `scripts/memory-schema.mjs`
|
|
13
|
-
- **Done quando**:
|
|
14
|
-
- [x] cria `spec_summaries`
|
|
15
|
-
- [x] cria `context_runs`
|
|
16
|
-
- [x] cria `asset_catalog`
|
|
17
|
-
|
|
18
|
-
## T2 - Operacoes de contexto/token
|
|
19
|
-
- **Owner**: Worker
|
|
20
|
-
- **Estimativa**: M
|
|
21
|
-
- **Depende de**: T1
|
|
22
|
-
- **Paths**: `scripts/context-ops.mjs`, `package.json`
|
|
23
|
-
- **Done quando**:
|
|
24
|
-
- [x] `context:budget` mede tokens
|
|
25
|
-
- [x] `context:sprint` gera sprint pack
|
|
26
|
-
- [x] `agent:brief` gera brief por papel/slug
|
|
27
|
-
- [x] `catalog:assets` cataloga boilerplates/design-md
|
|
28
|
-
- [x] `token:benchmark` esta exposto
|
|
29
|
-
|
|
30
|
-
## T3 - Melhorar boilerplates
|
|
31
|
-
- **Owner**: SDD Architect
|
|
32
|
-
- **Estimativa**: M
|
|
33
|
-
- **Depende de**: T2
|
|
34
|
-
- **Paths**: `boilerplates/**`
|
|
35
|
-
- **Done quando**:
|
|
36
|
-
- [x] cada boilerplate tem manifesto padrao
|
|
37
|
-
- [x] cada manifesto descreve stack, comandos, gates, tokens e casos de uso
|
|
38
|
-
|
|
39
|
-
## T4 - Melhorar design system
|
|
40
|
-
- **Owner**: SDD Architect
|
|
41
|
-
- **Estimativa**: M
|
|
42
|
-
- **Depende de**: T2
|
|
43
|
-
- **Paths**: `design-md/**`
|
|
44
|
-
- **Done quando**:
|
|
45
|
-
- [x] referencias tem metadados normalizados por superficie
|
|
46
|
-
- [x] tokens visuais recomendados ficam consultaveis pelo catalogo
|
|
47
|
-
|
|
48
|
-
## T5 - Integrar sync do banco
|
|
49
|
-
- **Owner**: Worker
|
|
50
|
-
- **Estimativa**: M
|
|
51
|
-
- **Depende de**: T1, T2
|
|
52
|
-
- **Paths**: `scripts/sync-universal-memory.js`
|
|
53
|
-
- **Done quando**:
|
|
54
|
-
- [x] sync popula tabelas auxiliares sem comando separado
|
|
55
|
-
- [x] schema continua aditivo e compativel
|
|
56
|
-
|
|
57
|
-
## Handoffs entre agentes
|
|
58
|
-
Use `npm run gsd:handoff -- implement dev-token-assets-db` para primeira tranche e `npm run gsd:handoff -- review dev-token-assets-db` antes de governanca.
|
|
1
|
+
# Tasks: dev-token-assets-db
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-06-02
|
|
7
|
+
|
|
8
|
+
## T1 - Schema auxiliar de memoria
|
|
9
|
+
- **Owner**: Worker
|
|
10
|
+
- **Estimativa**: P
|
|
11
|
+
- **Depende de**: -
|
|
12
|
+
- **Paths**: `scripts/memory-schema.mjs`
|
|
13
|
+
- **Done quando**:
|
|
14
|
+
- [x] cria `spec_summaries`
|
|
15
|
+
- [x] cria `context_runs`
|
|
16
|
+
- [x] cria `asset_catalog`
|
|
17
|
+
|
|
18
|
+
## T2 - Operacoes de contexto/token
|
|
19
|
+
- **Owner**: Worker
|
|
20
|
+
- **Estimativa**: M
|
|
21
|
+
- **Depende de**: T1
|
|
22
|
+
- **Paths**: `scripts/context-ops.mjs`, `package.json`
|
|
23
|
+
- **Done quando**:
|
|
24
|
+
- [x] `context:budget` mede tokens
|
|
25
|
+
- [x] `context:sprint` gera sprint pack
|
|
26
|
+
- [x] `agent:brief` gera brief por papel/slug
|
|
27
|
+
- [x] `catalog:assets` cataloga boilerplates/design-md
|
|
28
|
+
- [x] `token:benchmark` esta exposto
|
|
29
|
+
|
|
30
|
+
## T3 - Melhorar boilerplates
|
|
31
|
+
- **Owner**: SDD Architect
|
|
32
|
+
- **Estimativa**: M
|
|
33
|
+
- **Depende de**: T2
|
|
34
|
+
- **Paths**: `boilerplates/**`
|
|
35
|
+
- **Done quando**:
|
|
36
|
+
- [x] cada boilerplate tem manifesto padrao
|
|
37
|
+
- [x] cada manifesto descreve stack, comandos, gates, tokens e casos de uso
|
|
38
|
+
|
|
39
|
+
## T4 - Melhorar design system
|
|
40
|
+
- **Owner**: SDD Architect
|
|
41
|
+
- **Estimativa**: M
|
|
42
|
+
- **Depende de**: T2
|
|
43
|
+
- **Paths**: `design-md/**`
|
|
44
|
+
- **Done quando**:
|
|
45
|
+
- [x] referencias tem metadados normalizados por superficie
|
|
46
|
+
- [x] tokens visuais recomendados ficam consultaveis pelo catalogo
|
|
47
|
+
|
|
48
|
+
## T5 - Integrar sync do banco
|
|
49
|
+
- **Owner**: Worker
|
|
50
|
+
- **Estimativa**: M
|
|
51
|
+
- **Depende de**: T1, T2
|
|
52
|
+
- **Paths**: `scripts/sync-universal-memory.js`
|
|
53
|
+
- **Done quando**:
|
|
54
|
+
- [x] sync popula tabelas auxiliares sem comando separado
|
|
55
|
+
- [x] schema continua aditivo e compativel
|
|
56
|
+
|
|
57
|
+
## Handoffs entre agentes
|
|
58
|
+
Use `npm run gsd:handoff -- implement dev-token-assets-db` para primeira tranche e `npm run gsd:handoff -- review dev-token-assets-db` antes de governanca.
|
|
@@ -1,165 +1,165 @@
|
|
|
1
|
-
# Plan: doctor-do-nucleo
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Criado em**: 2026-07-13
|
|
6
|
-
|
|
7
|
-
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
-
|
|
9
|
-
## 1. Abordagem técnica
|
|
10
|
-
|
|
11
|
-
**Extend, não rewrite.** O `tools-doctor.mjs` já tem a forma certa — uma lista declarativa
|
|
12
|
-
(`TOOLS[]`) percorrida por um runner burro. Erramos no *conteúdo* da lista, não na estrutura.
|
|
13
|
-
|
|
14
|
-
Extraímos os checks para `lib/core/health.mjs` como **dados** (`CHECKS[]`), com um runner que os
|
|
15
|
-
executa e devolve resultados estruturados. O `tools-doctor` vira uma das três superfícies de
|
|
16
|
-
apresentação; `SessionStart` vira outra. Nenhuma superfície tem heurística própria — é justamente
|
|
17
|
-
isso que permitiu, hoje, uma delas prescrever a correção errada sozinha.
|
|
18
|
-
|
|
19
|
-
A mudança central de comportamento é **parar de colapsar causas distintas num booleano**. Hoje
|
|
20
|
-
`hook-session-start.mjs:38-45` faz `catch { return null }`, engolindo *sem `node_modules`*,
|
|
21
|
-
*ABI incompatível* e *banco ausente* no mesmo `null` — e a linha 91 prescreve a correção de apenas
|
|
22
|
-
uma das três. Cada probe passa a **classificar a causa** e devolver a correção dela.
|
|
23
|
-
|
|
24
|
-
## 2. Módulos afetados
|
|
25
|
-
|
|
26
|
-
| Caminho | Mudança | Risco |
|
|
27
|
-
|---|---|---|
|
|
28
|
-
| `lib/core/health.mjs` | **criar** — `CHECKS[]` + runner. Fonte única de verdade | M |
|
|
29
|
-
| `scripts/tools-doctor.mjs` | editar — consome a lib; ganha seção Núcleo + exit code | M |
|
|
30
|
-
| `scripts/hook-session-start.mjs` | editar — remove heurística própria (`resolveDbPath`, `staleIndex`) e a prescrição errada | A |
|
|
31
|
-
| `lib/core/registry.mjs` | editar — `desc` do `tools:doctor` reflete o novo papel | B |
|
|
32
|
-
| `scripts/spec-cli.mjs` | editar — `spec:new` mantém a allow-list do `.gitignore` (AC-11) | B |
|
|
33
|
-
| `test/health.test.js` | **criar** — cada check nos dois estados | B |
|
|
34
|
-
| `memory/90-decisions/0023-doctor-como-gate-do-nucleo.md` | **criar** — ADR | B |
|
|
35
|
-
| `CLAUDE.md`, `docs/` | editar — `tools:doctor` deixa de ser "raio-x de ferramentas" | B |
|
|
36
|
-
|
|
37
|
-
Risco alto no hook: ele roda em **toda** sessão e o ADR-0021 já o marcou como "nunca pode derrubar
|
|
38
|
-
a sessão". Qualquer regressão ali é sentida imediatamente e em todo lugar.
|
|
39
|
-
|
|
40
|
-
## 3. Diagrama de fluxo
|
|
41
|
-
|
|
42
|
-
```
|
|
43
|
-
tools:doctor ────┐
|
|
44
|
-
SessionStart ────┼──► lib/core/health.mjs :: runChecks({ scope })
|
|
45
|
-
release-auditor ─┘ │
|
|
46
|
-
▼
|
|
47
|
-
┌──────────────── CHECKS[] (declarativo) ────────────────┐
|
|
48
|
-
│ id severity scope dependsOn │
|
|
49
|
-
│ native-abi critical runtime — │
|
|
50
|
-
│ memory-db critical runtime native-abi │
|
|
51
|
-
│ memory-fresh warn runtime memory-db │
|
|
52
|
-
│ workspace warn runtime — │
|
|
53
|
-
│ node-engines warn runtime — │
|
|
54
|
-
│ runtime-deps critical repo — │
|
|
55
|
-
│ mcp-json critical repo — │
|
|
56
|
-
└────────────────────────────────────────────────────────┘
|
|
57
|
-
│
|
|
58
|
-
Result[] { id, status, detail, fix, severity }
|
|
59
|
-
│
|
|
60
|
-
┌───────────────────┴───────────────────┐
|
|
61
|
-
▼ ▼
|
|
62
|
-
doctor: 2 seções + exit(1) se hook: só scope=runtime,
|
|
63
|
-
algum critical falhou sempre exit(0), warn no contexto
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
**Cascata (`dependsOn`)** é o que evita o pior modo de falha de um diagnóstico: com o ABI quebrado,
|
|
67
|
-
`memory-db` e `memory-fresh` também falhariam, e o operador veria **três** erros sem saber qual é a
|
|
68
|
-
raiz. Um check cujo `dependsOn` falhou é reportado como `skipped`, não como `fail`. Uma causa, uma
|
|
69
|
-
linha vermelha, uma correção.
|
|
70
|
-
|
|
71
|
-
## 4. Contratos (API/CLI/Schema)
|
|
72
|
-
|
|
73
|
-
```js
|
|
74
|
-
// lib/core/health.mjs
|
|
75
|
-
|
|
76
|
-
/** @typedef {'critical'|'warn'} Severity */
|
|
77
|
-
/** @typedef {'runtime'|'repo'} Scope */
|
|
78
|
-
/** @typedef {'ok'|'warn'|'fail'|'skipped'} Status */
|
|
79
|
-
/** @typedef {{ id, title, severity: Severity, scope: Scope, dependsOn?: string, probe }} Check */
|
|
80
|
-
/** @typedef {{ id, title, severity, status: Status, detail: string, fix: string|null }} Result */
|
|
81
|
-
|
|
82
|
-
export const CHECKS;
|
|
83
|
-
|
|
84
|
-
/** Executa os checks. `scope: 'runtime'` roda só os baratos e portáveis (hook). */
|
|
85
|
-
export async function runChecks(opts); // { scope = 'all', env } -> Promise<Result[]>
|
|
86
|
-
|
|
87
|
-
/** 'fail' se algum critical falhou; senão 'warn' se houver warn; senão 'ok'. */
|
|
88
|
-
export function worstStatus(results); // -> 'ok' | 'warn' | 'fail'
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
O `probe` recebe um **ambiente injetável** (`env = { root, importModule, fs, workspace }`) e devolve
|
|
92
|
-
`{ status, detail, fix }`. Nunca lança: o runner o envolve em try/catch e converte exceção
|
|
93
|
-
inesperada em `fail` — um check que estoura ao diagnosticar é pior que check nenhum (NFR).
|
|
94
|
-
|
|
95
|
-
**CLI** — `tools:doctor` mantém nome e entrada no registry (ADR-0020). Muda o contrato de saída:
|
|
96
|
-
|
|
97
|
-
| Situação | Antes | Depois |
|
|
98
|
-
|---|---|---|
|
|
99
|
-
| Tudo são | `exit 0` | `exit 0` |
|
|
100
|
-
| Ferramenta opcional ausente | `exit 0` | `exit 0` *(ADR-0018 preservado)* |
|
|
101
|
-
| Índice defasado / workspace ausente | — | `exit 0` + aviso |
|
|
102
|
-
| **Núcleo quebrado** | `exit 0` | **`exit 1`** + correção |
|
|
103
|
-
|
|
104
|
-
## 5. Decisões e alternativas
|
|
105
|
-
|
|
106
|
-
**D1: Checks como dados, não como funções que imprimem.** Permite três superfícies com uma lógica
|
|
107
|
-
só. Alternativa rejeitada: cada superfície chama helpers e formata do seu jeito — é literalmente o
|
|
108
|
-
que temos hoje, e é a causa da divergência entre o que o doctor diz e o que o hook diz.
|
|
109
|
-
|
|
110
|
-
**D2: Probes classificam a causa; o runner nunca colapsa em booleano.** `ERR_DLOPEN_FAILED` →
|
|
111
|
-
`npm rebuild better-sqlite3`. `ERR_MODULE_NOT_FOUND` → `npm install`. Banco ausente →
|
|
112
|
-
`npm run sync:universal`. Alternativa rejeitada: manter `catch → null` e só melhorar o texto da
|
|
113
|
-
mensagem — daria uma prescrição *genérica*, e o problema de hoje foi precisamente uma prescrição
|
|
114
|
-
genérica aplicada a um caso específico.
|
|
115
|
-
|
|
116
|
-
**D3: `scope: repo | runtime`.** `runtime-deps` e `mcp-json` são checks de **regressão do
|
|
117
|
-
repositório** — não fazem sentido numa instalação `npm i -g forjajs`, onde não há `devDependencies`
|
|
118
|
-
instaladas nem `.mcp.json` versionado. Rodá-los fora do repo produziria falso positivo crítico no
|
|
119
|
-
ambiente do usuário final. Detecção: presença de `.git` + `package.json` com `name: forjajs`.
|
|
120
|
-
|
|
121
|
-
**D4: Só `critical` trava.** `workspace` ausente e `node-engines` abaixo do declarado entram como
|
|
122
|
-
`warn`, não `fail` — o framework funciona sem workspace (só `project:new` não). Um gate que reprova
|
|
123
|
-
o que não impede trabalho é um gate que se aprende a ignorar (risco nº 1 da spec).
|
|
124
|
-
|
|
125
|
-
**D5: Injeção de dependência no probe (`env`).** Testar ABI quebrada exigiria mockar o loader de
|
|
126
|
-
módulos do Node. Com `env.importModule` injetável, o teste passa uma função que lança
|
|
127
|
-
`ERR_DLOPEN_FAILED` e verifica a prescrição — sem mock de módulo, sem corromper `node_modules`.
|
|
128
|
-
|
|
129
|
-
**D6: Doctor diagnostica, não conserta.** Sem `--fix`. Rodar `npm rebuild` sem consentimento é a
|
|
130
|
-
classe de risco oposta à que estamos consertando (spec §5, fora de escopo).
|
|
131
|
-
|
|
132
|
-
D1, D3 e a mudança de contrato de exit code são estruturais → **ADR-0023**
|
|
133
|
-
(`memory/90-decisions/0023-doctor-como-gate-do-nucleo.md`), referenciando ADR-0018 (que ele estende)
|
|
134
|
-
e ADR-0021 (a classe de falha que ele fecha).
|
|
135
|
-
|
|
136
|
-
## 6. Dependências
|
|
137
|
-
|
|
138
|
-
- **Specs**: nenhuma. Fecha a classe do ADR-0021; não depende de spec aberta.
|
|
139
|
-
- **Pacotes npm**: **nenhum novo.** Tudo com `node:fs`, `node:path` e o `better-sqlite3` que já é
|
|
140
|
-
`dependency`. Adicionar dependência a um módulo cujo propósito é funcionar quando as dependências
|
|
141
|
-
quebram seria autodestrutivo.
|
|
142
|
-
- **Migrações**: nenhuma. Nada de schema, nada de dado.
|
|
143
|
-
|
|
144
|
-
## 7. Rollout
|
|
145
|
-
|
|
146
|
-
- [ ] Feature flag necessária? **Não.** A mudança é aditiva, exceto pelo exit code — que só passa a
|
|
147
|
-
falhar em ambiente que **já está** quebrado.
|
|
148
|
-
- [ ] Migração de dados existentes? **Não.**
|
|
149
|
-
- [x] Doc/persona impactada? `CLAUDE.md` (tabela de comandos) e `docs/` onde `tools:doctor` é
|
|
150
|
-
descrito como "raio-x de ferramentas". Persona **qa/governança** ganha gate novo.
|
|
151
|
-
- [ ] **Ordem de merge**: `lib/core/health.mjs` + testes primeiro (nada consome ainda), depois as
|
|
152
|
-
superfícies. O hook por último — é o de maior risco e o único que roda sempre.
|
|
153
|
-
- [ ] Validar com `npm run tools:doctor` num Node de major diferente (o cenário de hoje) **antes**
|
|
154
|
-
de fechar. Um doctor de ABI que nunca viu um ABI quebrado não está testado, está escrito.
|
|
155
|
-
|
|
156
|
-
## 8. Sinais de fracasso (kill criteria)
|
|
157
|
-
|
|
158
|
-
- **O hook fica lento ou instável.** Ele roda em toda sessão e não pode derrubá-la (ADR-0021). Se
|
|
159
|
-
`runChecks({ scope: 'runtime' })` não couber com folga no timeout de 5s, o hook volta a ter
|
|
160
|
-
caminho próprio (mínimo, ainda consumindo a lib) em vez de arrastarmos o custo para toda sessão.
|
|
161
|
-
- **`runtime-deps` vira ruído.** Se o parser estático de imports gerar falso positivo crítico mais
|
|
162
|
-
de uma vez, ele é rebaixado a `warn` — a spec já prevê isso no risco, e um crítico que mente é
|
|
163
|
-
pior que um warning honesto.
|
|
164
|
-
- **O operador passa a rodar `tools:doctor` já sabendo o resultado.** Se o gate vira ritual, erramos
|
|
165
|
-
a calibragem de severidade e voltamos a D4.
|
|
1
|
+
# Plan: doctor-do-nucleo
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Criado em**: 2026-07-13
|
|
6
|
+
|
|
7
|
+
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
+
|
|
9
|
+
## 1. Abordagem técnica
|
|
10
|
+
|
|
11
|
+
**Extend, não rewrite.** O `tools-doctor.mjs` já tem a forma certa — uma lista declarativa
|
|
12
|
+
(`TOOLS[]`) percorrida por um runner burro. Erramos no *conteúdo* da lista, não na estrutura.
|
|
13
|
+
|
|
14
|
+
Extraímos os checks para `lib/core/health.mjs` como **dados** (`CHECKS[]`), com um runner que os
|
|
15
|
+
executa e devolve resultados estruturados. O `tools-doctor` vira uma das três superfícies de
|
|
16
|
+
apresentação; `SessionStart` vira outra. Nenhuma superfície tem heurística própria — é justamente
|
|
17
|
+
isso que permitiu, hoje, uma delas prescrever a correção errada sozinha.
|
|
18
|
+
|
|
19
|
+
A mudança central de comportamento é **parar de colapsar causas distintas num booleano**. Hoje
|
|
20
|
+
`hook-session-start.mjs:38-45` faz `catch { return null }`, engolindo *sem `node_modules`*,
|
|
21
|
+
*ABI incompatível* e *banco ausente* no mesmo `null` — e a linha 91 prescreve a correção de apenas
|
|
22
|
+
uma das três. Cada probe passa a **classificar a causa** e devolver a correção dela.
|
|
23
|
+
|
|
24
|
+
## 2. Módulos afetados
|
|
25
|
+
|
|
26
|
+
| Caminho | Mudança | Risco |
|
|
27
|
+
|---|---|---|
|
|
28
|
+
| `lib/core/health.mjs` | **criar** — `CHECKS[]` + runner. Fonte única de verdade | M |
|
|
29
|
+
| `scripts/tools-doctor.mjs` | editar — consome a lib; ganha seção Núcleo + exit code | M |
|
|
30
|
+
| `scripts/hook-session-start.mjs` | editar — remove heurística própria (`resolveDbPath`, `staleIndex`) e a prescrição errada | A |
|
|
31
|
+
| `lib/core/registry.mjs` | editar — `desc` do `tools:doctor` reflete o novo papel | B |
|
|
32
|
+
| `scripts/spec-cli.mjs` | editar — `spec:new` mantém a allow-list do `.gitignore` (AC-11) | B |
|
|
33
|
+
| `test/health.test.js` | **criar** — cada check nos dois estados | B |
|
|
34
|
+
| `memory/90-decisions/0023-doctor-como-gate-do-nucleo.md` | **criar** — ADR | B |
|
|
35
|
+
| `CLAUDE.md`, `docs/` | editar — `tools:doctor` deixa de ser "raio-x de ferramentas" | B |
|
|
36
|
+
|
|
37
|
+
Risco alto no hook: ele roda em **toda** sessão e o ADR-0021 já o marcou como "nunca pode derrubar
|
|
38
|
+
a sessão". Qualquer regressão ali é sentida imediatamente e em todo lugar.
|
|
39
|
+
|
|
40
|
+
## 3. Diagrama de fluxo
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
tools:doctor ────┐
|
|
44
|
+
SessionStart ────┼──► lib/core/health.mjs :: runChecks({ scope })
|
|
45
|
+
release-auditor ─┘ │
|
|
46
|
+
▼
|
|
47
|
+
┌──────────────── CHECKS[] (declarativo) ────────────────┐
|
|
48
|
+
│ id severity scope dependsOn │
|
|
49
|
+
│ native-abi critical runtime — │
|
|
50
|
+
│ memory-db critical runtime native-abi │
|
|
51
|
+
│ memory-fresh warn runtime memory-db │
|
|
52
|
+
│ workspace warn runtime — │
|
|
53
|
+
│ node-engines warn runtime — │
|
|
54
|
+
│ runtime-deps critical repo — │
|
|
55
|
+
│ mcp-json critical repo — │
|
|
56
|
+
└────────────────────────────────────────────────────────┘
|
|
57
|
+
│
|
|
58
|
+
Result[] { id, status, detail, fix, severity }
|
|
59
|
+
│
|
|
60
|
+
┌───────────────────┴───────────────────┐
|
|
61
|
+
▼ ▼
|
|
62
|
+
doctor: 2 seções + exit(1) se hook: só scope=runtime,
|
|
63
|
+
algum critical falhou sempre exit(0), warn no contexto
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**Cascata (`dependsOn`)** é o que evita o pior modo de falha de um diagnóstico: com o ABI quebrado,
|
|
67
|
+
`memory-db` e `memory-fresh` também falhariam, e o operador veria **três** erros sem saber qual é a
|
|
68
|
+
raiz. Um check cujo `dependsOn` falhou é reportado como `skipped`, não como `fail`. Uma causa, uma
|
|
69
|
+
linha vermelha, uma correção.
|
|
70
|
+
|
|
71
|
+
## 4. Contratos (API/CLI/Schema)
|
|
72
|
+
|
|
73
|
+
```js
|
|
74
|
+
// lib/core/health.mjs
|
|
75
|
+
|
|
76
|
+
/** @typedef {'critical'|'warn'} Severity */
|
|
77
|
+
/** @typedef {'runtime'|'repo'} Scope */
|
|
78
|
+
/** @typedef {'ok'|'warn'|'fail'|'skipped'} Status */
|
|
79
|
+
/** @typedef {{ id, title, severity: Severity, scope: Scope, dependsOn?: string, probe }} Check */
|
|
80
|
+
/** @typedef {{ id, title, severity, status: Status, detail: string, fix: string|null }} Result */
|
|
81
|
+
|
|
82
|
+
export const CHECKS;
|
|
83
|
+
|
|
84
|
+
/** Executa os checks. `scope: 'runtime'` roda só os baratos e portáveis (hook). */
|
|
85
|
+
export async function runChecks(opts); // { scope = 'all', env } -> Promise<Result[]>
|
|
86
|
+
|
|
87
|
+
/** 'fail' se algum critical falhou; senão 'warn' se houver warn; senão 'ok'. */
|
|
88
|
+
export function worstStatus(results); // -> 'ok' | 'warn' | 'fail'
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
O `probe` recebe um **ambiente injetável** (`env = { root, importModule, fs, workspace }`) e devolve
|
|
92
|
+
`{ status, detail, fix }`. Nunca lança: o runner o envolve em try/catch e converte exceção
|
|
93
|
+
inesperada em `fail` — um check que estoura ao diagnosticar é pior que check nenhum (NFR).
|
|
94
|
+
|
|
95
|
+
**CLI** — `tools:doctor` mantém nome e entrada no registry (ADR-0020). Muda o contrato de saída:
|
|
96
|
+
|
|
97
|
+
| Situação | Antes | Depois |
|
|
98
|
+
|---|---|---|
|
|
99
|
+
| Tudo são | `exit 0` | `exit 0` |
|
|
100
|
+
| Ferramenta opcional ausente | `exit 0` | `exit 0` *(ADR-0018 preservado)* |
|
|
101
|
+
| Índice defasado / workspace ausente | — | `exit 0` + aviso |
|
|
102
|
+
| **Núcleo quebrado** | `exit 0` | **`exit 1`** + correção |
|
|
103
|
+
|
|
104
|
+
## 5. Decisões e alternativas
|
|
105
|
+
|
|
106
|
+
**D1: Checks como dados, não como funções que imprimem.** Permite três superfícies com uma lógica
|
|
107
|
+
só. Alternativa rejeitada: cada superfície chama helpers e formata do seu jeito — é literalmente o
|
|
108
|
+
que temos hoje, e é a causa da divergência entre o que o doctor diz e o que o hook diz.
|
|
109
|
+
|
|
110
|
+
**D2: Probes classificam a causa; o runner nunca colapsa em booleano.** `ERR_DLOPEN_FAILED` →
|
|
111
|
+
`npm rebuild better-sqlite3`. `ERR_MODULE_NOT_FOUND` → `npm install`. Banco ausente →
|
|
112
|
+
`npm run sync:universal`. Alternativa rejeitada: manter `catch → null` e só melhorar o texto da
|
|
113
|
+
mensagem — daria uma prescrição *genérica*, e o problema de hoje foi precisamente uma prescrição
|
|
114
|
+
genérica aplicada a um caso específico.
|
|
115
|
+
|
|
116
|
+
**D3: `scope: repo | runtime`.** `runtime-deps` e `mcp-json` são checks de **regressão do
|
|
117
|
+
repositório** — não fazem sentido numa instalação `npm i -g forjajs`, onde não há `devDependencies`
|
|
118
|
+
instaladas nem `.mcp.json` versionado. Rodá-los fora do repo produziria falso positivo crítico no
|
|
119
|
+
ambiente do usuário final. Detecção: presença de `.git` + `package.json` com `name: forjajs`.
|
|
120
|
+
|
|
121
|
+
**D4: Só `critical` trava.** `workspace` ausente e `node-engines` abaixo do declarado entram como
|
|
122
|
+
`warn`, não `fail` — o framework funciona sem workspace (só `project:new` não). Um gate que reprova
|
|
123
|
+
o que não impede trabalho é um gate que se aprende a ignorar (risco nº 1 da spec).
|
|
124
|
+
|
|
125
|
+
**D5: Injeção de dependência no probe (`env`).** Testar ABI quebrada exigiria mockar o loader de
|
|
126
|
+
módulos do Node. Com `env.importModule` injetável, o teste passa uma função que lança
|
|
127
|
+
`ERR_DLOPEN_FAILED` e verifica a prescrição — sem mock de módulo, sem corromper `node_modules`.
|
|
128
|
+
|
|
129
|
+
**D6: Doctor diagnostica, não conserta.** Sem `--fix`. Rodar `npm rebuild` sem consentimento é a
|
|
130
|
+
classe de risco oposta à que estamos consertando (spec §5, fora de escopo).
|
|
131
|
+
|
|
132
|
+
D1, D3 e a mudança de contrato de exit code são estruturais → **ADR-0023**
|
|
133
|
+
(`memory/90-decisions/0023-doctor-como-gate-do-nucleo.md`), referenciando ADR-0018 (que ele estende)
|
|
134
|
+
e ADR-0021 (a classe de falha que ele fecha).
|
|
135
|
+
|
|
136
|
+
## 6. Dependências
|
|
137
|
+
|
|
138
|
+
- **Specs**: nenhuma. Fecha a classe do ADR-0021; não depende de spec aberta.
|
|
139
|
+
- **Pacotes npm**: **nenhum novo.** Tudo com `node:fs`, `node:path` e o `better-sqlite3` que já é
|
|
140
|
+
`dependency`. Adicionar dependência a um módulo cujo propósito é funcionar quando as dependências
|
|
141
|
+
quebram seria autodestrutivo.
|
|
142
|
+
- **Migrações**: nenhuma. Nada de schema, nada de dado.
|
|
143
|
+
|
|
144
|
+
## 7. Rollout
|
|
145
|
+
|
|
146
|
+
- [ ] Feature flag necessária? **Não.** A mudança é aditiva, exceto pelo exit code — que só passa a
|
|
147
|
+
falhar em ambiente que **já está** quebrado.
|
|
148
|
+
- [ ] Migração de dados existentes? **Não.**
|
|
149
|
+
- [x] Doc/persona impactada? `CLAUDE.md` (tabela de comandos) e `docs/` onde `tools:doctor` é
|
|
150
|
+
descrito como "raio-x de ferramentas". Persona **qa/governança** ganha gate novo.
|
|
151
|
+
- [ ] **Ordem de merge**: `lib/core/health.mjs` + testes primeiro (nada consome ainda), depois as
|
|
152
|
+
superfícies. O hook por último — é o de maior risco e o único que roda sempre.
|
|
153
|
+
- [ ] Validar com `npm run tools:doctor` num Node de major diferente (o cenário de hoje) **antes**
|
|
154
|
+
de fechar. Um doctor de ABI que nunca viu um ABI quebrado não está testado, está escrito.
|
|
155
|
+
|
|
156
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
157
|
+
|
|
158
|
+
- **O hook fica lento ou instável.** Ele roda em toda sessão e não pode derrubá-la (ADR-0021). Se
|
|
159
|
+
`runChecks({ scope: 'runtime' })` não couber com folga no timeout de 5s, o hook volta a ter
|
|
160
|
+
caminho próprio (mínimo, ainda consumindo a lib) em vez de arrastarmos o custo para toda sessão.
|
|
161
|
+
- **`runtime-deps` vira ruído.** Se o parser estático de imports gerar falso positivo crítico mais
|
|
162
|
+
de uma vez, ele é rebaixado a `warn` — a spec já prevê isso no risco, e um crítico que mente é
|
|
163
|
+
pior que um warning honesto.
|
|
164
|
+
- **O operador passa a rodar `tools:doctor` já sabendo o resultado.** Se o gate vira ritual, erramos
|
|
165
|
+
a calibragem de severidade e voltamos a D4.
|