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,114 +1,114 @@
|
|
|
1
|
-
# ADR-0023: Doctor como gate do núcleo, não relatório de ferramentas
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-13
|
|
5
|
-
- **Autor(es)**: Allan Pablo
|
|
6
|
-
- **Tags**: harness, governance, memory, hooks, diagnostics
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
O ADR-0021 nomeou uma classe de falha do framework: erros que **erram sem avisar** — nenhum teste
|
|
11
|
-
quebra, nada aparece no `git status`, e o resultado é trabalho errado com aparência de trabalho
|
|
12
|
-
certo. Quatro casos foram corrigidos individualmente.
|
|
13
|
-
|
|
14
|
-
Em 2026-07-13 apareceu o quinto, e ele revelou por que corrigir caso a caso não fecha a classe.
|
|
15
|
-
|
|
16
|
-
Com o `better-sqlite3` compilado contra o ABI do Node 24 num runtime Node 26, a memória universal
|
|
17
|
-
morreu inteira: `query:universal`, `sync:universal`, `context:smart`, `agent:route`,
|
|
18
|
-
`memory:compress` e `project:dashboard`, todos inoperantes. A aposta nº 1 da visão — *"memória que
|
|
19
|
-
sobrevive"* — simplesmente não existia. As três superfícies de diagnóstico reagiram assim:
|
|
20
|
-
|
|
21
|
-
| Superfície | O que fez |
|
|
22
|
-
|---|---|
|
|
23
|
-
| `tools:doctor` | Reportou `2/5 ferramentas disponíveis` e saiu com **exit 0** |
|
|
24
|
-
| `SessionStart` | Detectou, mas prescreveu `npm install` — que **não** recompila binário nativo |
|
|
25
|
-
| `npm test` | Stack trace cru de `ERR_DLOPEN_FAILED` |
|
|
26
|
-
|
|
27
|
-
A correção real era `npm rebuild better-sqlite3`.
|
|
28
|
-
|
|
29
|
-
Dois problemas estruturais, não um bug:
|
|
30
|
-
|
|
31
|
-
1. **O doctor auditava o que não importa.** Ele checava cinco ferramentas *opcionais*, sobre as
|
|
32
|
-
quais ele mesmo declarava: *"o fluxo nunca trava por elas"*. Era cego para tudo que trava. Um
|
|
33
|
-
raio-x que só olha o que não pode quebrar.
|
|
34
|
-
2. **Cada superfície tinha heurística própria.** O hook resolvia a saúde da memória com um
|
|
35
|
-
`catch { return null }` que colapsava *sem `node_modules`*, *ABI incompatível* e *banco ausente*
|
|
36
|
-
no mesmo `null` — e então prescrevia a correção de apenas uma das três. Um operador seguindo a
|
|
37
|
-
instrução do próprio framework não consertaria nada, e concluiria que o problema era outro.
|
|
38
|
-
Uma prescrição errada é pior que silêncio: consome o tempo do operador e ainda desvia a
|
|
39
|
-
investigação.
|
|
40
|
-
|
|
41
|
-
## Decisão
|
|
42
|
-
|
|
43
|
-
**O doctor passa a ser o gate do núcleo. As três superfícies passam a ler a mesma fonte.**
|
|
44
|
-
|
|
45
|
-
- **`lib/core/health.mjs`** — os checks viram **dados** (`CHECKS[]`), com um runner que os executa
|
|
46
|
-
e devolve resultados estruturados. `tools:doctor`, `SessionStart` e (futuramente) o
|
|
47
|
-
`release-auditor` são apenas apresentação. Nenhuma superfície volta a ter heurística local.
|
|
48
|
-
- **Probes classificam a causa; o runner nunca colapsa em booleano.** `ERR_DLOPEN_FAILED` →
|
|
49
|
-
`npm rebuild better-sqlite3`. `ERR_MODULE_NOT_FOUND` → `npm install`. Banco ausente →
|
|
50
|
-
`npm run sync:universal`. Causas distintas, correções distintas.
|
|
51
|
-
- **Cascata via `dependsOn`.** Um check cuja dependência falhou é `skipped`, não `fail`. Com o ABI
|
|
52
|
-
quebrado, os checks de memória não têm o que observar; reportá-los como falha multiplicaria uma
|
|
53
|
-
causa em três linhas vermelhas e esconderia a raiz. **Uma causa, uma linha vermelha.**
|
|
54
|
-
- **Dois contratos de exit code.** Núcleo crítico quebrado → `exit 1`. Ferramenta opcional ausente
|
|
55
|
-
→ `exit 0`, preservando o ADR-0018 à risca. Só `critical` trava: `workspace` ausente e Node fora
|
|
56
|
-
do `engines` são avisos, porque não impedem trabalho.
|
|
57
|
-
- **Ausente ≠ quebrado.** Num clone novo — ou num CI — a memória simplesmente nunca foi indexada.
|
|
58
|
-
Isso é o ponto de partida de qualquer instalação, não uma falha, e um comando resolve. `memory-db`
|
|
59
|
-
distingue *não indexado* (aviso) de *existe mas não abre* (crítico). A primeira versão tratava os
|
|
60
|
-
dois como crítico e o CI reprovou de imediato: um gate que reprova todo mundo no primeiro dia é um
|
|
61
|
-
gate em que ninguém confia.
|
|
62
|
-
- **`scope: repo | runtime`.** `runtime-deps` e `mcp-json` — que convertem em gate executável dois
|
|
63
|
-
invariantes que o ADR-0021 corrigiu à mão — só rodam dentro do repo do framework. Numa instalação
|
|
64
|
-
`npm i -g forjajs` não há `devDependencies` nem `.mcp.json`, e rodá-los produziria falso positivo
|
|
65
|
-
crítico na máquina do usuário final.
|
|
66
|
-
- **`spec:new` mantém a allow-list do `.gitignore`.** Descoberto durante a implementação: `/specs/*`
|
|
67
|
-
é ignorado e as specs do framework entram por lista manual, então **toda spec nova nascia
|
|
68
|
-
invisível ao git** — inclusive a desta ADR. Aplicando o princípio do próprio ADR-0021 ("mover a
|
|
69
|
-
aplicação das regras do texto para o harness"), o comando passa a manter a lista.
|
|
70
|
-
|
|
71
|
-
## Alternativas consideradas
|
|
72
|
-
|
|
73
|
-
- **Melhorar só a mensagem do hook** — rejeitada: produziria uma prescrição *genérica*, e o
|
|
74
|
-
problema foi exatamente uma prescrição genérica aplicada a um caso específico. A causa era o
|
|
75
|
-
`catch` que apagava a informação, não o texto.
|
|
76
|
-
- **Doctor com `--fix` que roda `npm rebuild` sozinho** — rejeitada: executar comandos de build sem
|
|
77
|
-
consentimento é a classe de risco oposta à que este ADR fecha. O doctor diagnostica e prescreve.
|
|
78
|
-
- **Fazer o índice defasado reprovar (`critical`)** — rejeitada: um gate que trava por aquilo que
|
|
79
|
-
não impede trabalho é um gate que se aprende a ignorar, e aí ele para de proteger do que importa.
|
|
80
|
-
- **Check `spec-allowlist` avisando que a spec está fora do `.gitignore`** — rejeitada em favor de
|
|
81
|
-
o `spec:new` manter a lista: trocaria uma falha silenciosa por um lembrete recorrente. Eliminar a
|
|
82
|
-
classe de erro é melhor que reportá-la.
|
|
83
|
-
- **Um novo comando (`core:doctor`) separado** — rejeitada: dois doctores é como se chega a duas
|
|
84
|
-
verdades divergentes sobre o mesmo sistema, que é precisamente o defeito que este ADR corrige.
|
|
85
|
-
|
|
86
|
-
## Consequências
|
|
87
|
-
|
|
88
|
-
**Positivas**:
|
|
89
|
-
- A quebra do núcleo aparece no **primeiro** comando executado, com a correção certa ao lado — não
|
|
90
|
-
num sintoma indireto trinta minutos depois.
|
|
91
|
-
- Os invariantes do ADR-0021 ganham cobertura executável. Regressão em `.mcp.json` ou nas deps de
|
|
92
|
-
runtime passa a reprovar o gate, em vez de reaparecer em produção.
|
|
93
|
-
- Uma só definição de "saudável". O hook e o doctor não podem mais divergir, porque leem a mesma
|
|
94
|
-
lista.
|
|
95
|
-
- Check novo = entrada nova em `CHECKS[]`, e as três superfícies o ganham de graça.
|
|
96
|
-
|
|
97
|
-
**Negativas / Trade-offs**:
|
|
98
|
-
- `tools:doctor` pode agora **reprovar** (exit 1). Um ambiente já quebrado passa a falhar
|
|
99
|
-
explicitamente onde antes passava calado — é o objetivo, mas muda o contrato de quem o usasse em
|
|
100
|
-
script.
|
|
101
|
-
- `runtime-deps` usa parser estático conservador: import dinâmico não conta. Trocamos cobertura por
|
|
102
|
-
ausência de falso positivo, deliberadamente — um crítico que mente é pior que um warning honesto.
|
|
103
|
-
- O `SessionStart` ganhou uma dependência a mais no caminho quente. Mitigado por rodar só
|
|
104
|
-
`scope: 'runtime'` e nunca lançar: se a própria lib de health não carregar, o hook segue com o
|
|
105
|
-
resto do briefing.
|
|
106
|
-
|
|
107
|
-
## Rastreamento
|
|
108
|
-
|
|
109
|
-
- Implementação: `lib/core/health.mjs`, `scripts/tools-doctor.mjs`, `scripts/hook-session-start.mjs`,
|
|
110
|
-
`scripts/spec-cli.mjs`, `test/health.test.js`
|
|
111
|
-
- Spec: `specs/doctor-do-nucleo/` (SPEC-009)
|
|
112
|
-
- ADRs relacionadas: ADR-0018 (ferramentas de processo — estendido), ADR-0021 (guardrails de
|
|
113
|
-
harness — a classe de falha que este fecha), ADR-0020 (core/registry), ADR-0009 (economia de
|
|
114
|
-
tokens: `query:universal` é o primeiro passo, e índice defasado o corrompe em silêncio)
|
|
1
|
+
# ADR-0023: Doctor como gate do núcleo, não relatório de ferramentas
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-13
|
|
5
|
+
- **Autor(es)**: Allan Pablo
|
|
6
|
+
- **Tags**: harness, governance, memory, hooks, diagnostics
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
O ADR-0021 nomeou uma classe de falha do framework: erros que **erram sem avisar** — nenhum teste
|
|
11
|
+
quebra, nada aparece no `git status`, e o resultado é trabalho errado com aparência de trabalho
|
|
12
|
+
certo. Quatro casos foram corrigidos individualmente.
|
|
13
|
+
|
|
14
|
+
Em 2026-07-13 apareceu o quinto, e ele revelou por que corrigir caso a caso não fecha a classe.
|
|
15
|
+
|
|
16
|
+
Com o `better-sqlite3` compilado contra o ABI do Node 24 num runtime Node 26, a memória universal
|
|
17
|
+
morreu inteira: `query:universal`, `sync:universal`, `context:smart`, `agent:route`,
|
|
18
|
+
`memory:compress` e `project:dashboard`, todos inoperantes. A aposta nº 1 da visão — *"memória que
|
|
19
|
+
sobrevive"* — simplesmente não existia. As três superfícies de diagnóstico reagiram assim:
|
|
20
|
+
|
|
21
|
+
| Superfície | O que fez |
|
|
22
|
+
|---|---|
|
|
23
|
+
| `tools:doctor` | Reportou `2/5 ferramentas disponíveis` e saiu com **exit 0** |
|
|
24
|
+
| `SessionStart` | Detectou, mas prescreveu `npm install` — que **não** recompila binário nativo |
|
|
25
|
+
| `npm test` | Stack trace cru de `ERR_DLOPEN_FAILED` |
|
|
26
|
+
|
|
27
|
+
A correção real era `npm rebuild better-sqlite3`.
|
|
28
|
+
|
|
29
|
+
Dois problemas estruturais, não um bug:
|
|
30
|
+
|
|
31
|
+
1. **O doctor auditava o que não importa.** Ele checava cinco ferramentas *opcionais*, sobre as
|
|
32
|
+
quais ele mesmo declarava: *"o fluxo nunca trava por elas"*. Era cego para tudo que trava. Um
|
|
33
|
+
raio-x que só olha o que não pode quebrar.
|
|
34
|
+
2. **Cada superfície tinha heurística própria.** O hook resolvia a saúde da memória com um
|
|
35
|
+
`catch { return null }` que colapsava *sem `node_modules`*, *ABI incompatível* e *banco ausente*
|
|
36
|
+
no mesmo `null` — e então prescrevia a correção de apenas uma das três. Um operador seguindo a
|
|
37
|
+
instrução do próprio framework não consertaria nada, e concluiria que o problema era outro.
|
|
38
|
+
Uma prescrição errada é pior que silêncio: consome o tempo do operador e ainda desvia a
|
|
39
|
+
investigação.
|
|
40
|
+
|
|
41
|
+
## Decisão
|
|
42
|
+
|
|
43
|
+
**O doctor passa a ser o gate do núcleo. As três superfícies passam a ler a mesma fonte.**
|
|
44
|
+
|
|
45
|
+
- **`lib/core/health.mjs`** — os checks viram **dados** (`CHECKS[]`), com um runner que os executa
|
|
46
|
+
e devolve resultados estruturados. `tools:doctor`, `SessionStart` e (futuramente) o
|
|
47
|
+
`release-auditor` são apenas apresentação. Nenhuma superfície volta a ter heurística local.
|
|
48
|
+
- **Probes classificam a causa; o runner nunca colapsa em booleano.** `ERR_DLOPEN_FAILED` →
|
|
49
|
+
`npm rebuild better-sqlite3`. `ERR_MODULE_NOT_FOUND` → `npm install`. Banco ausente →
|
|
50
|
+
`npm run sync:universal`. Causas distintas, correções distintas.
|
|
51
|
+
- **Cascata via `dependsOn`.** Um check cuja dependência falhou é `skipped`, não `fail`. Com o ABI
|
|
52
|
+
quebrado, os checks de memória não têm o que observar; reportá-los como falha multiplicaria uma
|
|
53
|
+
causa em três linhas vermelhas e esconderia a raiz. **Uma causa, uma linha vermelha.**
|
|
54
|
+
- **Dois contratos de exit code.** Núcleo crítico quebrado → `exit 1`. Ferramenta opcional ausente
|
|
55
|
+
→ `exit 0`, preservando o ADR-0018 à risca. Só `critical` trava: `workspace` ausente e Node fora
|
|
56
|
+
do `engines` são avisos, porque não impedem trabalho.
|
|
57
|
+
- **Ausente ≠ quebrado.** Num clone novo — ou num CI — a memória simplesmente nunca foi indexada.
|
|
58
|
+
Isso é o ponto de partida de qualquer instalação, não uma falha, e um comando resolve. `memory-db`
|
|
59
|
+
distingue *não indexado* (aviso) de *existe mas não abre* (crítico). A primeira versão tratava os
|
|
60
|
+
dois como crítico e o CI reprovou de imediato: um gate que reprova todo mundo no primeiro dia é um
|
|
61
|
+
gate em que ninguém confia.
|
|
62
|
+
- **`scope: repo | runtime`.** `runtime-deps` e `mcp-json` — que convertem em gate executável dois
|
|
63
|
+
invariantes que o ADR-0021 corrigiu à mão — só rodam dentro do repo do framework. Numa instalação
|
|
64
|
+
`npm i -g forjajs` não há `devDependencies` nem `.mcp.json`, e rodá-los produziria falso positivo
|
|
65
|
+
crítico na máquina do usuário final.
|
|
66
|
+
- **`spec:new` mantém a allow-list do `.gitignore`.** Descoberto durante a implementação: `/specs/*`
|
|
67
|
+
é ignorado e as specs do framework entram por lista manual, então **toda spec nova nascia
|
|
68
|
+
invisível ao git** — inclusive a desta ADR. Aplicando o princípio do próprio ADR-0021 ("mover a
|
|
69
|
+
aplicação das regras do texto para o harness"), o comando passa a manter a lista.
|
|
70
|
+
|
|
71
|
+
## Alternativas consideradas
|
|
72
|
+
|
|
73
|
+
- **Melhorar só a mensagem do hook** — rejeitada: produziria uma prescrição *genérica*, e o
|
|
74
|
+
problema foi exatamente uma prescrição genérica aplicada a um caso específico. A causa era o
|
|
75
|
+
`catch` que apagava a informação, não o texto.
|
|
76
|
+
- **Doctor com `--fix` que roda `npm rebuild` sozinho** — rejeitada: executar comandos de build sem
|
|
77
|
+
consentimento é a classe de risco oposta à que este ADR fecha. O doctor diagnostica e prescreve.
|
|
78
|
+
- **Fazer o índice defasado reprovar (`critical`)** — rejeitada: um gate que trava por aquilo que
|
|
79
|
+
não impede trabalho é um gate que se aprende a ignorar, e aí ele para de proteger do que importa.
|
|
80
|
+
- **Check `spec-allowlist` avisando que a spec está fora do `.gitignore`** — rejeitada em favor de
|
|
81
|
+
o `spec:new` manter a lista: trocaria uma falha silenciosa por um lembrete recorrente. Eliminar a
|
|
82
|
+
classe de erro é melhor que reportá-la.
|
|
83
|
+
- **Um novo comando (`core:doctor`) separado** — rejeitada: dois doctores é como se chega a duas
|
|
84
|
+
verdades divergentes sobre o mesmo sistema, que é precisamente o defeito que este ADR corrige.
|
|
85
|
+
|
|
86
|
+
## Consequências
|
|
87
|
+
|
|
88
|
+
**Positivas**:
|
|
89
|
+
- A quebra do núcleo aparece no **primeiro** comando executado, com a correção certa ao lado — não
|
|
90
|
+
num sintoma indireto trinta minutos depois.
|
|
91
|
+
- Os invariantes do ADR-0021 ganham cobertura executável. Regressão em `.mcp.json` ou nas deps de
|
|
92
|
+
runtime passa a reprovar o gate, em vez de reaparecer em produção.
|
|
93
|
+
- Uma só definição de "saudável". O hook e o doctor não podem mais divergir, porque leem a mesma
|
|
94
|
+
lista.
|
|
95
|
+
- Check novo = entrada nova em `CHECKS[]`, e as três superfícies o ganham de graça.
|
|
96
|
+
|
|
97
|
+
**Negativas / Trade-offs**:
|
|
98
|
+
- `tools:doctor` pode agora **reprovar** (exit 1). Um ambiente já quebrado passa a falhar
|
|
99
|
+
explicitamente onde antes passava calado — é o objetivo, mas muda o contrato de quem o usasse em
|
|
100
|
+
script.
|
|
101
|
+
- `runtime-deps` usa parser estático conservador: import dinâmico não conta. Trocamos cobertura por
|
|
102
|
+
ausência de falso positivo, deliberadamente — um crítico que mente é pior que um warning honesto.
|
|
103
|
+
- O `SessionStart` ganhou uma dependência a mais no caminho quente. Mitigado por rodar só
|
|
104
|
+
`scope: 'runtime'` e nunca lançar: se a própria lib de health não carregar, o hook segue com o
|
|
105
|
+
resto do briefing.
|
|
106
|
+
|
|
107
|
+
## Rastreamento
|
|
108
|
+
|
|
109
|
+
- Implementação: `lib/core/health.mjs`, `scripts/tools-doctor.mjs`, `scripts/hook-session-start.mjs`,
|
|
110
|
+
`scripts/spec-cli.mjs`, `test/health.test.js`
|
|
111
|
+
- Spec: `specs/doctor-do-nucleo/` (SPEC-009)
|
|
112
|
+
- ADRs relacionadas: ADR-0018 (ferramentas de processo — estendido), ADR-0021 (guardrails de
|
|
113
|
+
harness — a classe de falha que este fecha), ADR-0020 (core/registry), ADR-0009 (economia de
|
|
114
|
+
tokens: `query:universal` é o primeiro passo, e índice defasado o corrompe em silêncio)
|
|
@@ -1,103 +1,103 @@
|
|
|
1
|
-
# ADR-0024: Gate do tarball — o repositório mente sobre o pacote
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-14
|
|
5
|
-
- **Autor(es)**: Allan Pablo
|
|
6
|
-
- **Tags**: release, governance, npm, harness, ci
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
O ADR-0023 fechou a classe "erra sem avisar" **dentro do repositório**. Fora dele, na fronteira do
|
|
11
|
-
pacote publicado, a mesma classe seguia intacta — e já tinha cobrado três vezes:
|
|
12
|
-
|
|
13
|
-
| Onde | O que foi publicado | Consequência |
|
|
14
|
-
|---|---|---|
|
|
15
|
-
| ADR-0021 §2 | `better-sqlite3` como `devDependency` | Dez comandos com `ERR_MODULE_NOT_FOUND` numa instalação limpa. O `forja` sem argumentos funcionava — o help não carrega os scripts — e isso mascarou a quebra. |
|
|
16
|
-
| v1.1.1 | `otplib` e `qrcode` no tarball, **sem jamais existirem no git** | `npm publish` empacota o *disco*, não o commit. Um `npm install` casual entre a auditoria e o publish reescreveu o `package.json`. |
|
|
17
|
-
| v1.1.3 | `docs/dashboard.md` e o script `npm run dashboard`, sem a pasta `dashboard/` | Quem instalava recebia a documentação e o comando, sem o código. |
|
|
18
|
-
|
|
19
|
-
Três releases, três bugs, uma raiz: **no repo tudo resolve.** `node_modules` tem as devDeps, todo
|
|
20
|
-
arquivo está presente, o `cwd` é a raiz. Nada disso vale para quem roda `npm i -g forjajs`. Todos
|
|
21
|
-
os três foram descobertos *depois* do publish, na máquina de quem instalou.
|
|
22
|
-
|
|
23
|
-
O agente `.claude/agents/release-auditor.md` já descrevia essa classe com precisão cirúrgica — as
|
|
24
|
-
quatro variantes, o procedimento, os comandos exatos. **Não era conhecimento que faltava; era
|
|
25
|
-
execução.** Ele é um agente: prosa, opt-in, invocado por quem lembrar. Pelo critério do próprio
|
|
26
|
-
ADR-0021 — *"uma regra que depende de memória não é uma regra; é uma sugestão"* — aquilo não era
|
|
27
|
-
gate. Era a última fronteira do framework que ainda funcionava por disciplina.
|
|
28
|
-
|
|
29
|
-
## Decisão
|
|
30
|
-
|
|
31
|
-
**`release:check`**: o gate empacota, instala num diretório isolado, executa os comandos e reprova.
|
|
32
|
-
|
|
33
|
-
- **Grep não prova ausência; instalação prova.** O gate roda `npm pack` + `npm install` de verdade,
|
|
34
|
-
fora do repo, sem herdar `NODE_PATH` nem o `node_modules` vizinho. Um gate que enxerga o repo
|
|
35
|
-
mente verde.
|
|
36
|
-
- **Executar, não listar.** O `forja` sem argumentos passa mesmo com tudo quebrado. O gate roda
|
|
37
|
-
comandos reais (`tools:doctor`, `code:status`, `query:universal`) na instalação limpa.
|
|
38
|
-
- **Reprovar por assinatura de loader, nunca por exit code.** Numa instalação limpa não há workspace
|
|
39
|
-
nem `universal.db`, então `query:universal` sai com código ≠ 0 *legitimamente* — isso é o pacote
|
|
40
|
-
**funcionando**. O que denuncia tarball quebrado é `ERR_MODULE_NOT_FOUND` / `ERR_DLOPEN_FAILED`.
|
|
41
|
-
Reprovar por exit code reprovaria todo pacote saudável.
|
|
42
|
-
- **Dois modos.** Árvore suja é `warn` em dev (senão o gate é contornado) e `fail` sob `--publish`
|
|
43
|
-
(senão repete-se a v1.1.1).
|
|
44
|
-
- **A aprovação é perecível.** A árvore é reconferida ao final: vale para aquele disco, naquele
|
|
45
|
-
instante. Um `npm install` entre o check e o publish invalida tudo.
|
|
46
|
-
- **O runner é o mesmo do doctor.** `lib/core/checks.mjs` foi *extraído* de `health.mjs`, não
|
|
47
|
-
copiado. Duas máquinas iguais divergem com o tempo — e divergência entre superfícies que deveriam
|
|
48
|
-
concordar é exatamente o defeito que o ADR-0023 matou. Uma máquina, dois catálogos: `health.mjs`
|
|
49
|
-
guarda o repo, `release.mjs` guarda o tarball.
|
|
50
|
-
- **O que o Forja *escreve* não é o que o Forja *executa*.** Duas camadas de defesa contra essa
|
|
51
|
-
confusão, ambas descobertas em campo:
|
|
52
|
-
1. `stripTemplateLiterals` — os geradores emitem `import { INestApplication } from
|
|
53
|
-
'@nestjs/common'` dentro de crases. Como a linha começa com `import`, o parser casava.
|
|
54
|
-
2. Só `bin/`, `lib/` e `scripts/` contam como código. `boilerplates/` também é publicado e também
|
|
55
|
-
é `.js`, mas é **conteúdo**: o `next.config.js` de um boilerplate importa `next`, dependência
|
|
56
|
-
do projeto do *usuário*. Na primeira execução real, o gate exigiu `npm i -S next` no framework.
|
|
57
|
-
- **O gate nunca publica.** Ele autoriza; `npm publish` continua sendo um ato humano deliberado.
|
|
58
|
-
- **`prepublishOnly`, jamais `prepack`.** O gate roda `npm pack`. Amarrá-lo ao `prepack` faria o
|
|
59
|
-
`npm pack` do gate disparar o `prepack`, que chama o gate, que roda `npm pack`… `npm pack` **não**
|
|
60
|
-
dispara `prepublishOnly`, e é por isso que ele é o único hook seguro.
|
|
61
|
-
|
|
62
|
-
## Alternativas consideradas
|
|
63
|
-
|
|
64
|
-
- **Manter o `release-auditor` como agente** — rejeitada: é o estado atual, e ele não impediu
|
|
65
|
-
nenhum dos três bugs. Conhecimento correto que ninguém executa no momento certo é decoração.
|
|
66
|
-
- **Análise estática do tarball, sem instalar** — rejeitada: foi tentada à mão durante o estudo e
|
|
67
|
-
produziu falso positivo em minutos (imports dentro de template literal). Grep não distingue código
|
|
68
|
-
de texto; o interpretador distingue.
|
|
69
|
-
- **`--fix` que corrige `files[]`/`dependencies` sozinho** — rejeitada, mesma razão do ADR-0023: o
|
|
70
|
-
gate diagnostica e prescreve. Editar o manifesto de publicação sem consentimento é a classe de
|
|
71
|
-
risco oposta.
|
|
72
|
-
- **`deps-unused` como `critical`** — rejeitada: peso morto no tarball incomoda, não quebra.
|
|
73
|
-
Reprovar um release por isso ensina o time a usar `--no-verify`.
|
|
74
|
-
- **Rodar o gate na matriz de três Nodes** — rejeitada: o custo é o `npm install` compilando o
|
|
75
|
-
`better-sqlite3` do zero, e instalar três vezes não prova mais que instalar uma. O `tools:doctor`
|
|
76
|
-
é que roda na matriz — o `native-abi` só faz sentido contra várias versões.
|
|
77
|
-
|
|
78
|
-
## Consequências
|
|
79
|
-
|
|
80
|
-
**Positivas**:
|
|
81
|
-
- Os três bugs históricos foram **reintroduzidos um a um e o gate reprovou os três**. Um gate que
|
|
82
|
-
nunca viu a falha que promete pegar não está testado — está escrito. Este viu.
|
|
83
|
-
- A evidência do release passa a viver no log do CI, e não na memória de quem publicou.
|
|
84
|
-
- `release:check` e `tools:doctor` compartilham runner, vocabulário e contrato de exit code. Check
|
|
85
|
-
novo é entrada nova num catálogo.
|
|
86
|
-
|
|
87
|
-
**Negativas / Trade-offs**:
|
|
88
|
-
- O gate é **lento** (dezenas de segundos): o custo é o build nativo do `better-sqlite3` na
|
|
89
|
-
instalação limpa. Aceito — roda antes de publicar e no CI, nunca no pre-commit.
|
|
90
|
-
- `prepublishOnly` é a peça de risco alto: um falso positivo ali **impede publicar qualquer coisa**.
|
|
91
|
-
Por isso entrou por último, depois de o gate rodar verde no CI. Se reprovar um release saudável
|
|
92
|
-
uma única vez, o `tree-clean` estrito sai do `prepublishOnly` e fica só no CI.
|
|
93
|
-
- A análise estática é conservadora por escolha: import dinâmico e template literal não contam.
|
|
94
|
-
Trocamos cobertura por ausência de falso positivo — um crítico que mente é pior que um warning
|
|
95
|
-
honesto. A cobertura real vem do `smoke-commands`, que executa e não opina.
|
|
96
|
-
|
|
97
|
-
## Rastreamento
|
|
98
|
-
|
|
99
|
-
- Implementação: `lib/core/checks.mjs` (runner), `lib/core/release.mjs` (catálogo),
|
|
100
|
-
`scripts/release-check.mjs`, `.github/workflows/ci.yml`, `test/release.test.js`
|
|
101
|
-
- Spec: `specs/release-gate/` (SPEC-010)
|
|
102
|
-
- ADRs relacionadas: ADR-0023 (mesma filosofia, fronteira anterior), ADR-0021 (a classe que ambos
|
|
103
|
-
fecham), ADR-0020 (registry), ADR-0018 (ferramentas de processo)
|
|
1
|
+
# ADR-0024: Gate do tarball — o repositório mente sobre o pacote
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-14
|
|
5
|
+
- **Autor(es)**: Allan Pablo
|
|
6
|
+
- **Tags**: release, governance, npm, harness, ci
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
O ADR-0023 fechou a classe "erra sem avisar" **dentro do repositório**. Fora dele, na fronteira do
|
|
11
|
+
pacote publicado, a mesma classe seguia intacta — e já tinha cobrado três vezes:
|
|
12
|
+
|
|
13
|
+
| Onde | O que foi publicado | Consequência |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| ADR-0021 §2 | `better-sqlite3` como `devDependency` | Dez comandos com `ERR_MODULE_NOT_FOUND` numa instalação limpa. O `forja` sem argumentos funcionava — o help não carrega os scripts — e isso mascarou a quebra. |
|
|
16
|
+
| v1.1.1 | `otplib` e `qrcode` no tarball, **sem jamais existirem no git** | `npm publish` empacota o *disco*, não o commit. Um `npm install` casual entre a auditoria e o publish reescreveu o `package.json`. |
|
|
17
|
+
| v1.1.3 | `docs/dashboard.md` e o script `npm run dashboard`, sem a pasta `dashboard/` | Quem instalava recebia a documentação e o comando, sem o código. |
|
|
18
|
+
|
|
19
|
+
Três releases, três bugs, uma raiz: **no repo tudo resolve.** `node_modules` tem as devDeps, todo
|
|
20
|
+
arquivo está presente, o `cwd` é a raiz. Nada disso vale para quem roda `npm i -g forjajs`. Todos
|
|
21
|
+
os três foram descobertos *depois* do publish, na máquina de quem instalou.
|
|
22
|
+
|
|
23
|
+
O agente `.claude/agents/release-auditor.md` já descrevia essa classe com precisão cirúrgica — as
|
|
24
|
+
quatro variantes, o procedimento, os comandos exatos. **Não era conhecimento que faltava; era
|
|
25
|
+
execução.** Ele é um agente: prosa, opt-in, invocado por quem lembrar. Pelo critério do próprio
|
|
26
|
+
ADR-0021 — *"uma regra que depende de memória não é uma regra; é uma sugestão"* — aquilo não era
|
|
27
|
+
gate. Era a última fronteira do framework que ainda funcionava por disciplina.
|
|
28
|
+
|
|
29
|
+
## Decisão
|
|
30
|
+
|
|
31
|
+
**`release:check`**: o gate empacota, instala num diretório isolado, executa os comandos e reprova.
|
|
32
|
+
|
|
33
|
+
- **Grep não prova ausência; instalação prova.** O gate roda `npm pack` + `npm install` de verdade,
|
|
34
|
+
fora do repo, sem herdar `NODE_PATH` nem o `node_modules` vizinho. Um gate que enxerga o repo
|
|
35
|
+
mente verde.
|
|
36
|
+
- **Executar, não listar.** O `forja` sem argumentos passa mesmo com tudo quebrado. O gate roda
|
|
37
|
+
comandos reais (`tools:doctor`, `code:status`, `query:universal`) na instalação limpa.
|
|
38
|
+
- **Reprovar por assinatura de loader, nunca por exit code.** Numa instalação limpa não há workspace
|
|
39
|
+
nem `universal.db`, então `query:universal` sai com código ≠ 0 *legitimamente* — isso é o pacote
|
|
40
|
+
**funcionando**. O que denuncia tarball quebrado é `ERR_MODULE_NOT_FOUND` / `ERR_DLOPEN_FAILED`.
|
|
41
|
+
Reprovar por exit code reprovaria todo pacote saudável.
|
|
42
|
+
- **Dois modos.** Árvore suja é `warn` em dev (senão o gate é contornado) e `fail` sob `--publish`
|
|
43
|
+
(senão repete-se a v1.1.1).
|
|
44
|
+
- **A aprovação é perecível.** A árvore é reconferida ao final: vale para aquele disco, naquele
|
|
45
|
+
instante. Um `npm install` entre o check e o publish invalida tudo.
|
|
46
|
+
- **O runner é o mesmo do doctor.** `lib/core/checks.mjs` foi *extraído* de `health.mjs`, não
|
|
47
|
+
copiado. Duas máquinas iguais divergem com o tempo — e divergência entre superfícies que deveriam
|
|
48
|
+
concordar é exatamente o defeito que o ADR-0023 matou. Uma máquina, dois catálogos: `health.mjs`
|
|
49
|
+
guarda o repo, `release.mjs` guarda o tarball.
|
|
50
|
+
- **O que o Forja *escreve* não é o que o Forja *executa*.** Duas camadas de defesa contra essa
|
|
51
|
+
confusão, ambas descobertas em campo:
|
|
52
|
+
1. `stripTemplateLiterals` — os geradores emitem `import { INestApplication } from
|
|
53
|
+
'@nestjs/common'` dentro de crases. Como a linha começa com `import`, o parser casava.
|
|
54
|
+
2. Só `bin/`, `lib/` e `scripts/` contam como código. `boilerplates/` também é publicado e também
|
|
55
|
+
é `.js`, mas é **conteúdo**: o `next.config.js` de um boilerplate importa `next`, dependência
|
|
56
|
+
do projeto do *usuário*. Na primeira execução real, o gate exigiu `npm i -S next` no framework.
|
|
57
|
+
- **O gate nunca publica.** Ele autoriza; `npm publish` continua sendo um ato humano deliberado.
|
|
58
|
+
- **`prepublishOnly`, jamais `prepack`.** O gate roda `npm pack`. Amarrá-lo ao `prepack` faria o
|
|
59
|
+
`npm pack` do gate disparar o `prepack`, que chama o gate, que roda `npm pack`… `npm pack` **não**
|
|
60
|
+
dispara `prepublishOnly`, e é por isso que ele é o único hook seguro.
|
|
61
|
+
|
|
62
|
+
## Alternativas consideradas
|
|
63
|
+
|
|
64
|
+
- **Manter o `release-auditor` como agente** — rejeitada: é o estado atual, e ele não impediu
|
|
65
|
+
nenhum dos três bugs. Conhecimento correto que ninguém executa no momento certo é decoração.
|
|
66
|
+
- **Análise estática do tarball, sem instalar** — rejeitada: foi tentada à mão durante o estudo e
|
|
67
|
+
produziu falso positivo em minutos (imports dentro de template literal). Grep não distingue código
|
|
68
|
+
de texto; o interpretador distingue.
|
|
69
|
+
- **`--fix` que corrige `files[]`/`dependencies` sozinho** — rejeitada, mesma razão do ADR-0023: o
|
|
70
|
+
gate diagnostica e prescreve. Editar o manifesto de publicação sem consentimento é a classe de
|
|
71
|
+
risco oposta.
|
|
72
|
+
- **`deps-unused` como `critical`** — rejeitada: peso morto no tarball incomoda, não quebra.
|
|
73
|
+
Reprovar um release por isso ensina o time a usar `--no-verify`.
|
|
74
|
+
- **Rodar o gate na matriz de três Nodes** — rejeitada: o custo é o `npm install` compilando o
|
|
75
|
+
`better-sqlite3` do zero, e instalar três vezes não prova mais que instalar uma. O `tools:doctor`
|
|
76
|
+
é que roda na matriz — o `native-abi` só faz sentido contra várias versões.
|
|
77
|
+
|
|
78
|
+
## Consequências
|
|
79
|
+
|
|
80
|
+
**Positivas**:
|
|
81
|
+
- Os três bugs históricos foram **reintroduzidos um a um e o gate reprovou os três**. Um gate que
|
|
82
|
+
nunca viu a falha que promete pegar não está testado — está escrito. Este viu.
|
|
83
|
+
- A evidência do release passa a viver no log do CI, e não na memória de quem publicou.
|
|
84
|
+
- `release:check` e `tools:doctor` compartilham runner, vocabulário e contrato de exit code. Check
|
|
85
|
+
novo é entrada nova num catálogo.
|
|
86
|
+
|
|
87
|
+
**Negativas / Trade-offs**:
|
|
88
|
+
- O gate é **lento** (dezenas de segundos): o custo é o build nativo do `better-sqlite3` na
|
|
89
|
+
instalação limpa. Aceito — roda antes de publicar e no CI, nunca no pre-commit.
|
|
90
|
+
- `prepublishOnly` é a peça de risco alto: um falso positivo ali **impede publicar qualquer coisa**.
|
|
91
|
+
Por isso entrou por último, depois de o gate rodar verde no CI. Se reprovar um release saudável
|
|
92
|
+
uma única vez, o `tree-clean` estrito sai do `prepublishOnly` e fica só no CI.
|
|
93
|
+
- A análise estática é conservadora por escolha: import dinâmico e template literal não contam.
|
|
94
|
+
Trocamos cobertura por ausência de falso positivo — um crítico que mente é pior que um warning
|
|
95
|
+
honesto. A cobertura real vem do `smoke-commands`, que executa e não opina.
|
|
96
|
+
|
|
97
|
+
## Rastreamento
|
|
98
|
+
|
|
99
|
+
- Implementação: `lib/core/checks.mjs` (runner), `lib/core/release.mjs` (catálogo),
|
|
100
|
+
`scripts/release-check.mjs`, `.github/workflows/ci.yml`, `test/release.test.js`
|
|
101
|
+
- Spec: `specs/release-gate/` (SPEC-010)
|
|
102
|
+
- ADRs relacionadas: ADR-0023 (mesma filosofia, fronteira anterior), ADR-0021 (a classe que ambos
|
|
103
|
+
fecham), ADR-0020 (registry), ADR-0018 (ferramentas de processo)
|