forjajs 2.0.3 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -339
- package/README.pt-BR.md +345 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +14 -2
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +54 -0
- package/dist/lib/core/registry.js +55 -0
- package/dist/lib/core/release.d.ts +53 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.js +2 -2
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -150
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
- package/dist/scripts/server-persistence-probe.d.ts +0 -1
- package/dist/scripts/server-persistence-probe.js +0 -52
- package/dist/scripts/server-persistence-probe.mjs +0 -52
- /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# Plan: release-auditor-health
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Criado em**: 2026-08-17
|
|
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
|
+
**Compor, não reimplementar.** O Release Auditor continuará sendo uma persona de julgamento, sem
|
|
12
|
+
probes próprios. Seu procedimento passa a executar `tools:doctor`, que já apresenta
|
|
13
|
+
`lib/core/health.ts`, e só então `release:check --publish`, que preserva o contrato estrito de
|
|
14
|
+
pré-publicação. Um teste lê o prompt como contrato e garante presença, ordem e flags dos comandos.
|
|
15
|
+
|
|
16
|
+
## 2. Módulos afetados
|
|
17
|
+
|
|
18
|
+
| Caminho | Mudança | Risco |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| `.claude/agents/release-auditor.md` | editar procedimento, checks e regras de julgamento | B |
|
|
21
|
+
| `AGENTS.md` | alinhar descrição canônica do papel aos dois gates | B |
|
|
22
|
+
| `test/release-auditor.test.js` | criar teste do contrato do procedimento | B |
|
|
23
|
+
| `memory/40-delivery/current-sprint.md` | substituir candidatos obsoletos pelo item em execução | B |
|
|
24
|
+
|
|
25
|
+
Nenhum módulo executável de health, release ou registry será alterado.
|
|
26
|
+
|
|
27
|
+
## 3. Diagrama de fluxo
|
|
28
|
+
|
|
29
|
+
```text
|
|
30
|
+
Release Auditor
|
|
31
|
+
|
|
|
32
|
+
+--> npm run tools:doctor
|
|
33
|
+
| |
|
|
34
|
+
| +--> critical fail: REPROVADO, parar e reportar fix
|
|
35
|
+
| `--> ok/warn: continuar
|
|
36
|
+
|
|
|
37
|
+
`--> npm run release:check -- --publish
|
|
38
|
+
|
|
|
39
|
+
+--> fail: REPROVADO
|
|
40
|
+
`--> ok: parecer, ressalvas e validade perecível
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## 4. Contratos
|
|
44
|
+
|
|
45
|
+
O contrato público continua sendo CLI existente:
|
|
46
|
+
|
|
47
|
+
```text
|
|
48
|
+
npm run tools:doctor
|
|
49
|
+
npm run release:check -- --publish
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
O primeiro comando deve aparecer antes do segundo. `--publish` é obrigatório. Avisos são lidos e
|
|
53
|
+
relatados, mas apenas falhas críticas bloqueiam. O agente nunca executa `npm publish`.
|
|
54
|
+
|
|
55
|
+
## 5. Decisões e alternativas
|
|
56
|
+
|
|
57
|
+
**D1: Consumir health por `tools:doctor`.** Alternativa rejeitada: importar `runChecks()` num script
|
|
58
|
+
novo para o agente, pois criaria outra superfície executável sem necessidade.
|
|
59
|
+
|
|
60
|
+
**D2: Preservar dois comandos explícitos.** Alternativa rejeitada: trocar por `check:all --full`,
|
|
61
|
+
pois hoje o agregador chama `runReleaseChecks({})` sem `publish: true`; árvore suja seria aviso.
|
|
62
|
+
|
|
63
|
+
**D3: Testar o prompt como contrato.** O teste verifica índices dos comandos no texto, a flag
|
|
64
|
+
`--publish` e a proibição de `npm publish`. Alternativa rejeitada: testar só presença por grep, que
|
|
65
|
+
não detectaria ordem invertida nem enfraquecimento da flag.
|
|
66
|
+
|
|
67
|
+
Nenhuma decisão é estrutural ou irreversível. ADR novo não é necessário; o plano aplica ADR-0023 e
|
|
68
|
+
ADR-0024.
|
|
69
|
+
|
|
70
|
+
## 6. Dependências
|
|
71
|
+
|
|
72
|
+
- **Specs**: SPEC-009/ADR-0023 e SPEC-010/ADR-0024, ambas concluídas.
|
|
73
|
+
- **Pacotes npm**: nenhum.
|
|
74
|
+
- **Migrações de dados/memory**: nenhuma.
|
|
75
|
+
|
|
76
|
+
## 7. Rollout
|
|
77
|
+
|
|
78
|
+
- [x] Feature flag necessária? Não, é procedimento interno de governança.
|
|
79
|
+
- [x] Migração de dados existentes? Não.
|
|
80
|
+
- [x] Doc/persona impactada? Release Auditor e sua descrição canônica em `AGENTS.md`.
|
|
81
|
+
- [x] Rodar teste direcionado, `types:check`, `project:check`, `tools:doctor` e `spec:check`.
|
|
82
|
+
- [x] Registrar handoff para Governance após implementação.
|
|
83
|
+
|
|
84
|
+
## 8. Sinais de fracasso
|
|
85
|
+
|
|
86
|
+
- A solução introduz probe ou lógica de severidade fora de `lib/core/health.ts`.
|
|
87
|
+
- `release:check --publish` deixa de ser obrigatório ou é substituído pelo agregador não estrito.
|
|
88
|
+
- O teste fica acoplado à redação completa do prompt, em vez de somente ao contrato operacional.
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# Spec: release-auditor-health
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-022
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-08-17
|
|
7
|
+
- **Sprint alvo**: framework-root
|
|
8
|
+
- **ADRs relacionadas**: [ADR-0023](../../memory/90-decisions/0023-doctor-como-gate-do-nucleo.md) (saúde compartilhada), [ADR-0024](../../memory/90-decisions/0024-release-gate-tarball.md) (gate do tarball)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O ADR-0023 definiu `lib/core/health.ts` como fonte única da saúde do núcleo e previu três
|
|
12
|
+
consumidores: `tools:doctor`, `SessionStart` e Release Auditor. Os dois primeiros já consomem o
|
|
13
|
+
catálogo; o Release Auditor ainda manda executar apenas `release:check --publish`.
|
|
14
|
+
|
|
15
|
+
Esse gate prova a fronteira do tarball, mas não substitui a saúde do repositório. Ele não executa os
|
|
16
|
+
checks de coerência de documentação e topologia e só alcança parte da saúde indiretamente, por meio
|
|
17
|
+
de comandos de smoke na instalação limpa. Assim, o auditor pode aprovar o pacote sem ter obtido o
|
|
18
|
+
veredito da fonte que o ADR-0023 declarou canônica.
|
|
19
|
+
|
|
20
|
+
O agregador `check:all --full` também não substitui o procedimento de publicação: internamente ele
|
|
21
|
+
roda `release:check` em modo de desenvolvimento, no qual árvore suja é aviso. Pré-publicação exige
|
|
22
|
+
`release:check --publish`, que reprova se o tarball não corresponder a um commit.
|
|
23
|
+
|
|
24
|
+
## 2. Proposta de valor
|
|
25
|
+
Toda auditoria pré-publicação valida primeiro a saúde canônica do núcleo e depois a instalação limpa
|
|
26
|
+
do tarball, sem duplicar probes e sem enfraquecer o contrato de árvore limpa.
|
|
27
|
+
|
|
28
|
+
## 3. User stories
|
|
29
|
+
- **Como** Release Auditor, **quero** consumir o veredito de `tools:doctor` antes do gate do
|
|
30
|
+
tarball, **para que** eu não aprove um release sobre um núcleo incoerente.
|
|
31
|
+
- **Como** mantenedor, **quero** que o procedimento aponte para os gates executáveis existentes,
|
|
32
|
+
**para que** uma nova entrada em `CHECKS[]` seja herdada sem editar o agente.
|
|
33
|
+
- **Como** quem publica, **quero** preservar `release:check --publish`, **para que** uma árvore suja
|
|
34
|
+
continue bloqueando a publicação.
|
|
35
|
+
|
|
36
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
37
|
+
- [x] AC-1: `.claude/agents/release-auditor.md` manda executar `npm run tools:doctor` antes de
|
|
38
|
+
`npm run release:check -- --publish`.
|
|
39
|
+
- [x] AC-2: Falha crítica do doctor reprova a auditoria e impede parecer de aprovação, com a
|
|
40
|
+
correção fornecida pelo próprio check.
|
|
41
|
+
- [x] AC-3: O agente não reimplementa nenhum probe de `lib/core/health.ts`; o catálogo continua
|
|
42
|
+
sendo a única fonte da definição de saúde.
|
|
43
|
+
- [x] AC-4: `release:check -- --publish` permanece obrigatório e separado. `check:all --full` não é
|
|
44
|
+
apresentado como equivalente de pré-publicação enquanto não propagar o modo `publish`.
|
|
45
|
+
- [x] AC-5: A descrição canônica do papel em `AGENTS.md` reflete os dois gates e mantém explícito que
|
|
46
|
+
o auditor não executa `npm publish`.
|
|
47
|
+
- [x] AC-6: Teste automatizado falha se o procedimento perder um dos comandos, inverter sua ordem
|
|
48
|
+
ou remover `--publish`.
|
|
49
|
+
|
|
50
|
+
## 5. Escopo
|
|
51
|
+
**Dentro**:
|
|
52
|
+
- Procedimento e julgamento em `.claude/agents/release-auditor.md`.
|
|
53
|
+
- Descrição canônica do papel em `AGENTS.md`.
|
|
54
|
+
- Teste de contrato do procedimento.
|
|
55
|
+
- Atualização do candidato obsoleto em `memory/40-delivery/current-sprint.md`.
|
|
56
|
+
|
|
57
|
+
**Fora** (explícito, evita scope creep):
|
|
58
|
+
- Alterar `lib/core/health.ts`, seus checks ou severidades.
|
|
59
|
+
- Alterar `lib/core/release.ts` ou incorporar os checks de health ao catálogo de release.
|
|
60
|
+
- Fazer `check:all --full` propagar modo de publicação.
|
|
61
|
+
- Executar ou automatizar `npm publish`.
|
|
62
|
+
- Criar ADR: os contratos necessários já estão decididos nos ADRs 0023 e 0024.
|
|
63
|
+
|
|
64
|
+
## 6. NFRs / restrições
|
|
65
|
+
- **Performance**: o doctor roda antes do gate caro e pode interromper cedo uma auditoria inviável.
|
|
66
|
+
- **Segurança**: nenhuma correção e nenhuma publicação são executadas automaticamente.
|
|
67
|
+
- **Observabilidade**: o parecer cita o gate, o check que falhou e sua correção; não resume falha
|
|
68
|
+
crítica como diagnóstico genérico.
|
|
69
|
+
- **Compatibilidade**: nomes e contratos dos comandos existentes permanecem intactos.
|
|
70
|
+
|
|
71
|
+
## 7. Riscos e mitigação
|
|
72
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
73
|
+
|---|---|---|---|
|
|
74
|
+
| Duplicar checks entre health e release | M | A | Compor comandos existentes; zero probe novo |
|
|
75
|
+
| Trocar por `check:all --full` e aceitar árvore suja | M | A | Manter `release:check --publish` explícito e testado |
|
|
76
|
+
| Doctor tornar o release mais lento | B | B | Gate barato roda antes do empacotamento e falha cedo |
|
|
77
|
+
| Documentação do papel voltar a divergir | M | M | Teste de contrato cobre presença e ordem dos comandos |
|
|
78
|
+
|
|
79
|
+
## 8. Métricas de sucesso
|
|
80
|
+
Nos 30 dias após a entrega, 100% dos pareceres do Release Auditor registrados na trilha executam os
|
|
81
|
+
dois gates; nenhuma aprovação ocorre após `tools:doctor` crítico e nenhuma auditoria de publicação
|
|
82
|
+
usa `release:check` sem `--publish`.
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# Tasks: release-auditor-health
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-08-17
|
|
7
|
+
|
|
8
|
+
> Decomposição executável. A sequência preserva o contrato antes de atualizar a documentação.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## T1 — Fixar o contrato do Release Auditor
|
|
13
|
+
|
|
14
|
+
- **Owner**: Worker
|
|
15
|
+
- **Estimativa**: P
|
|
16
|
+
- **Depende de**: —
|
|
17
|
+
- **Paths**: `test/release-auditor.test.js`
|
|
18
|
+
- **Done quando**:
|
|
19
|
+
- [x] O teste lê `.claude/agents/release-auditor.md` como contrato operacional.
|
|
20
|
+
- [x] Reprova se `npm run tools:doctor` estiver ausente ou depois de
|
|
21
|
+
`npm run release:check -- --publish` (AC-1, AC-6).
|
|
22
|
+
- [x] Reprova se o gate do tarball perder `--publish` (AC-4, AC-6).
|
|
23
|
+
- [x] Reprova se o procedimento autorizar ou executar `npm publish` (AC-5).
|
|
24
|
+
- [x] Não compara o prompt inteiro nem fica acoplado a texto editorial fora desses invariantes.
|
|
25
|
+
|
|
26
|
+
## T2 — Migrar o procedimento do agente
|
|
27
|
+
|
|
28
|
+
- **Owner**: Worker
|
|
29
|
+
- **Estimativa**: P
|
|
30
|
+
- **Depende de**: T1
|
|
31
|
+
- **Paths**: `.claude/agents/release-auditor.md`
|
|
32
|
+
- **Done quando**:
|
|
33
|
+
- [x] O procedimento executa `npm run tools:doctor` antes do gate do tarball (AC-1).
|
|
34
|
+
- [x] Falha crítica do doctor interrompe a auditoria e produz parecer reprovado com o `fix` do
|
|
35
|
+
check; avisos são lidos e relatados sem serem promovidos a falha (AC-2).
|
|
36
|
+
- [x] `npm run release:check -- --publish` permanece obrigatório (AC-4).
|
|
37
|
+
- [x] Não há probe, heurística de saúde ou lista duplicada de checks no prompt (AC-3).
|
|
38
|
+
- [x] A regra de nunca executar `npm publish` permanece explícita (AC-5).
|
|
39
|
+
|
|
40
|
+
## T3 — Alinhar a topologia e a sprint
|
|
41
|
+
|
|
42
|
+
- **Owner**: Worker
|
|
43
|
+
- **Estimativa**: P
|
|
44
|
+
- **Depende de**: T2
|
|
45
|
+
- **Paths**: `AGENTS.md`, `memory/40-delivery/current-sprint.md`
|
|
46
|
+
- **Done quando**:
|
|
47
|
+
- [x] A descrição canônica do Release Auditor cita os dois gates, na ordem correta, e mantém a
|
|
48
|
+
publicação como ato humano (AC-5).
|
|
49
|
+
- [x] O candidato obsoleto de migração do Release Auditor sai de "Próximos candidatos" e a
|
|
50
|
+
SPEC-022 aparece como item da sprint.
|
|
51
|
+
- [x] A informação de que `tools:doctor` ainda não roda no CI é removida, pois `.github/workflows/ci.yml`
|
|
52
|
+
já executa o gate.
|
|
53
|
+
|
|
54
|
+
## T4 — Validação e handoff de governança
|
|
55
|
+
|
|
56
|
+
- **Owner**: Governance
|
|
57
|
+
- **Estimativa**: P
|
|
58
|
+
- **Depende de**: T1, T2, T3
|
|
59
|
+
- **Paths**: `specs/release-auditor-health/spec.md`, `specs/release-auditor-health/tasks.md`
|
|
60
|
+
- **Done quando**:
|
|
61
|
+
- [x] Teste direcionado do Release Auditor passa.
|
|
62
|
+
- [x] `npm run types:check`, `npm run project:check`, `npm run tools:doctor` e
|
|
63
|
+
`npm run spec:check -- release-auditor-health` passam.
|
|
64
|
+
- [x] AC-1 a AC-6 são marcados somente após evidência verificável.
|
|
65
|
+
- [x] Handoff `review` é registrado; Governance emite parecer antes de concluir a spec.
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## Handoffs entre agentes
|
|
70
|
+
|
|
71
|
+
Após aprovação destas tasks, registrar `npm run gsd:handoff -- implement release-auditor-health`.
|
|
72
|
+
Ao concluir T1-T3, registrar `npm run gsd:handoff -- review release-auditor-health` para Governance.
|
|
@@ -1,174 +1,174 @@
|
|
|
1
|
-
# Plan: release-gate
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Criado em**: 2026-07-14
|
|
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
|
-
**O runner já existe.** `runChecks({ checks, env })` em `lib/core/health.mjs` foi escrito genérico
|
|
12
|
-
— recebe a lista de checks por parâmetro e já é exercitado com fixtures nos testes. O gate de
|
|
13
|
-
release não precisa de máquina nova: precisa de **outro catálogo de checks** rodando na mesma
|
|
14
|
-
máquina.
|
|
15
|
-
|
|
16
|
-
Então extraímos o runner para `lib/core/checks.mjs` e deixamos dois catálogos: `health.mjs` (o
|
|
17
|
-
núcleo, fronteira *repo*) e `release.mjs` (o tarball, fronteira *pacote publicado*). Mesma
|
|
18
|
-
severidade, mesma cascata, mesmo contrato de `fix`. Uma máquina, duas fronteiras.
|
|
19
|
-
|
|
20
|
-
A diferença essencial em relação ao doctor: o gate de release **não inspeciona; ele instala**. Grep
|
|
21
|
-
não prova ausência — instalação prova. O `release-auditor` já diz isso, e é a razão de o gate ser
|
|
22
|
-
lento e de tudo bem ser lento.
|
|
23
|
-
|
|
24
|
-
## 2. Módulos afetados
|
|
25
|
-
|
|
26
|
-
| Caminho | Mudança | Risco |
|
|
27
|
-
|---|---|---|
|
|
28
|
-
| `lib/core/checks.mjs` | **criar** — runner extraído de `health.mjs` (`runChecks`, `worstStatus`) | M |
|
|
29
|
-
| `lib/core/health.mjs` | editar — passa a importar o runner; re-exporta para não quebrar consumidores | M |
|
|
30
|
-
| `lib/core/release.mjs` | **criar** — catálogo dos checks de tarball | M |
|
|
31
|
-
| `scripts/release-check.mjs` | **criar** — apresentação + exit code | B |
|
|
32
|
-
| `lib/core/registry.mjs` | editar — `release:check` (ADR-0020) | B |
|
|
33
|
-
| `package.json` | editar — `prepublishOnly` | **A** |
|
|
34
|
-
| `.github/workflows/ci.yml` | editar — steps `tools:doctor` e `release:check` | B |
|
|
35
|
-
| `.claude/agents/release-auditor.md` | reescrever — consome o gate, não reimplementa | B |
|
|
36
|
-
| `test/release.test.js` | **criar** — os três bugs históricos como fixture | B |
|
|
37
|
-
|
|
38
|
-
Risco alto no `prepublishOnly`: se ele falhar indevidamente, **ninguém consegue publicar**. É o
|
|
39
|
-
único ponto onde um falso positivo trava a operação inteira em vez de só incomodar.
|
|
40
|
-
|
|
41
|
-
## 3. Diagrama de fluxo
|
|
42
|
-
|
|
43
|
-
```
|
|
44
|
-
npm run release:check [--publish]
|
|
45
|
-
│
|
|
46
|
-
▼
|
|
47
|
-
┌─ preflight ───────────────────────────────────────┐
|
|
48
|
-
│ árvore limpa? --publish → fail senão → warn │ ← v1.1.1 morreu aqui
|
|
49
|
-
└───────────────────────────────────────────────────┘
|
|
50
|
-
│
|
|
51
|
-
▼
|
|
52
|
-
npm pack → /tmp/forja-release-<pid>/
|
|
53
|
-
│
|
|
54
|
-
▼
|
|
55
|
-
npm init + npm i <tgz> (isolado: sem NODE_PATH, sem node_modules do repo)
|
|
56
|
-
│
|
|
57
|
-
▼
|
|
58
|
-
┌──────────── RELEASE_CHECKS[] (lib/core/release.mjs) ──────────┐
|
|
59
|
-
│ id severity o que prova │
|
|
60
|
-
│ tree-clean critical* tarball == commit (*warn sem --publish)
|
|
61
|
-
│ install critical o pacote instala do zero │
|
|
62
|
-
│ registry-scripts critical os 41 comandos existem no tarball │
|
|
63
|
-
│ smoke-commands critical os comandos EXECUTAM (não só help) │
|
|
64
|
-
│ reprova por stderr, não exit code │
|
|
65
|
-
│ deps-declared critical importado ⊆ dependencies │
|
|
66
|
-
│ deps-unused warn dependency que ninguém importa │
|
|
67
|
-
│ imports-resolve critical import relativo resolve no tarball │
|
|
68
|
-
└───────────────────────────────────────────────────────────────┘
|
|
69
|
-
│
|
|
70
|
-
▼
|
|
71
|
-
re-check árvore limpa ← a aprovação é perecível
|
|
72
|
-
│
|
|
73
|
-
▼
|
|
74
|
-
exit 0 / exit 1 + limpa o /tmp
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
## 4. Contratos (API/CLI/Schema)
|
|
78
|
-
|
|
79
|
-
```js
|
|
80
|
-
// lib/core/checks.mjs — o runner, sem opinião sobre o que checa
|
|
81
|
-
export async function runChecks(opts); // { checks, scope, env } -> Result[]
|
|
82
|
-
export function worstStatus(results); // -> 'ok' | 'warn' | 'fail'
|
|
83
|
-
|
|
84
|
-
// lib/core/health.mjs — inalterado para quem consome
|
|
85
|
-
export { runChecks, worstStatus } from './checks.mjs'; // re-export: tools-doctor e o hook seguem iguais
|
|
86
|
-
export const CHECKS; // os 7 do núcleo
|
|
87
|
-
|
|
88
|
-
// lib/core/release.mjs
|
|
89
|
-
export const RELEASE_CHECKS;
|
|
90
|
-
export async function withCleanInstall(fn); // empacota, instala isolado, executa, limpa. Sempre limpa.
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
**CLI**:
|
|
94
|
-
|
|
95
|
-
| Comando | Árvore suja | Uso |
|
|
96
|
-
|---|---|---|
|
|
97
|
-
| `npm run release:check` | `warn` | Dev quer o smoke test sem commitar. Reprova o resto normalmente. |
|
|
98
|
-
| `npm run release:check -- --publish` | **`fail`** | `prepublishOnly` e CI de release. |
|
|
99
|
-
|
|
100
|
-
A distinção existe porque um gate que reprova todo desenvolvimento local vira um gate que se
|
|
101
|
-
contorna — a lição que o CI nos deu na SPEC-009, quando `memory-db` reprovava qualquer clone novo.
|
|
102
|
-
Mas na hora de publicar, árvore suja é **fatal**: foi assim que `otplib` e `qrcode` entraram na
|
|
103
|
-
v1.1.1 sem existirem no git.
|
|
104
|
-
|
|
105
|
-
## 5. Decisões e alternativas
|
|
106
|
-
|
|
107
|
-
**D1: Extrair o runner em vez de duplicá-lo.** `health.mjs` já tem cascata, blindagem de probe e
|
|
108
|
-
`worstStatus` testados. Copiar tudo para `release.mjs` criaria duas máquinas que divergem com o
|
|
109
|
-
tempo — exatamente o defeito que a SPEC-009 matou quando o doctor e o hook divergiram. Alternativa
|
|
110
|
-
rejeitada: `release.mjs` importar de `health.mjs`, deixando o núcleo dono de um runner que não é
|
|
111
|
-
dele.
|
|
112
|
-
|
|
113
|
-
**D2: Instalar, não inspecionar.** O gate faz `npm pack` + `npm i` de verdade. Alternativa
|
|
114
|
-
rejeitada: análise estática do tarball — foi o que eu fiz à mão hoje e produziu **falso positivo
|
|
115
|
-
imediato** (os geradores contêm `import` dentro de template string). Grep não prova ausência.
|
|
116
|
-
|
|
117
|
-
**D3: Template literals são removidos antes do parse.** Onde a análise estática for inevitável
|
|
118
|
-
(`deps-declared`), o conteúdo entre crases é apagado do fonte antes de casar `import`. Os geradores
|
|
119
|
-
*escrevem* código NestJS; não o executam. Sem isso, o check acusa `@nestjs/core` como dependência
|
|
120
|
-
não declarada — e é o bug latente que já existe hoje no `runtime-deps` (AC-11).
|
|
121
|
-
|
|
122
|
-
**D4: Dois modos (`--publish`).** Ver §4. Severidade do `tree-clean` muda com o contexto; o resto
|
|
123
|
-
é idêntico.
|
|
124
|
-
|
|
125
|
-
**D5: A aprovação é perecível.** O `git status` é reconferido **ao final**, porque a auditoria vale
|
|
126
|
-
para o disco no instante em que rodou. Um `npm install` entre o check e o publish invalida tudo — e
|
|
127
|
-
essa foi literalmente a causa da v1.1.1.
|
|
128
|
-
|
|
129
|
-
**D6: O gate nunca publica.** Ele autoriza. `npm publish` continua sendo um ato humano deliberado.
|
|
130
|
-
|
|
131
|
-
**D7: `deps-unused` é `warn`, não `fail`.** Peso morto no tarball incomoda, não quebra. Reprovar um
|
|
132
|
-
release por causa disso é o tipo de rigor que ensina o time a usar `--no-verify`.
|
|
133
|
-
|
|
134
|
-
**D8: `smoke-commands` reprova por padrão no stderr, nunca por exit code.** Numa instalação limpa
|
|
135
|
-
não existe workspace nem `universal.db` — então `query:universal` sai com código ≠ 0 *legitimamente*,
|
|
136
|
-
e `tools:doctor` avisa sobre memória não indexada. Isso é o pacote **funcionando**. O que denuncia
|
|
137
|
-
tarball quebrado é a assinatura do carregamento: `ERR_MODULE_NOT_FOUND`, `ERR_DLOPEN_FAILED`,
|
|
138
|
-
`Cannot find module`. Reprovar por exit code faria o gate reprovar um pacote saudável — é a mesma
|
|
139
|
-
armadilha do `memory-db` na SPEC-009, um nível acima.
|
|
140
|
-
|
|
141
|
-
**D9: `prepublishOnly`, nunca `prepack`.** O gate roda `npm pack`. Amarrá-lo ao `prepack` faria o
|
|
142
|
-
`npm pack` do gate disparar o `prepack`, que chama o gate, que roda `npm pack`… `npm pack` **não**
|
|
143
|
-
dispara `prepublishOnly`, então o hook correto é o único seguro. Vale um comentário no
|
|
144
|
-
`package.json`: a alternativa "óbvia" é uma bomba-relógio.
|
|
145
|
-
|
|
146
|
-
D1 e a mudança de contrato do `prepublishOnly` são estruturais → **ADR-0024**, referenciando
|
|
147
|
-
ADR-0023 (mesma filosofia, fronteira seguinte) e ADR-0021 (a classe que ambos fecham).
|
|
148
|
-
|
|
149
|
-
## 6. Dependências
|
|
150
|
-
|
|
151
|
-
- **Specs**: SPEC-009 (`lib/core/health.mjs` é a base do runner). Já em `done`.
|
|
152
|
-
- **Pacotes npm**: **nenhum novo.** `npm pack`/`npm i` via `child_process`.
|
|
153
|
-
- **Migrações**: nenhuma.
|
|
154
|
-
|
|
155
|
-
## 7. Rollout
|
|
156
|
-
|
|
157
|
-
- [ ] **Ordem**: `checks.mjs` extraído + suíte verde (refactor puro, nada muda de comportamento) →
|
|
158
|
-
`release.mjs` + testes → `release-check.mjs` → CI → `prepublishOnly` **por último**.
|
|
159
|
-
- [x] Doc/persona impactada: `docs/publishing.md`, `CLAUDE.md`, persona **governança**.
|
|
160
|
-
- [ ] **Validar reintroduzindo os três bugs históricos** (better-sqlite3 em devDeps; arquivo fora do
|
|
161
|
-
`files[]`; árvore suja). Cada um deve reprovar. Um gate que nunca viu a falha que promete
|
|
162
|
-
pegar não está testado — está escrito.
|
|
163
|
-
- [ ] `prepublishOnly` entra **depois** de o gate rodar verde no CI por um ciclo. Ele é a única
|
|
164
|
-
peça que, com falso positivo, impede publicar qualquer coisa.
|
|
165
|
-
|
|
166
|
-
## 8. Sinais de fracasso (kill criteria)
|
|
167
|
-
|
|
168
|
-
- **O gate reprova um release saudável.** Um falso positivo no `prepublishOnly` trava a operação
|
|
169
|
-
inteira. Se acontecer uma vez, o `tree-clean` estrito sai do `prepublishOnly` e fica só no CI.
|
|
170
|
-
- **`deps-declared` volta a acusar os geradores.** Se o D3 não bastar, o check é rebaixado a `warn`
|
|
171
|
-
e a cobertura passa a vir do `smoke-commands` (que executa e não mente).
|
|
172
|
-
- **O gate leva minutos.** O custo real não é o `npm pack` — é o `npm i` compilando o
|
|
173
|
-
`better-sqlite3` do zero (o CI já gasta ~1min45 nisso). Se ficar caro demais, o gate sai do fluxo
|
|
174
|
-
de PR e fica só no release: a instalação limpa é inegociável, a frequência não.
|
|
1
|
+
# Plan: release-gate
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Criado em**: 2026-07-14
|
|
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
|
+
**O runner já existe.** `runChecks({ checks, env })` em `lib/core/health.mjs` foi escrito genérico
|
|
12
|
+
— recebe a lista de checks por parâmetro e já é exercitado com fixtures nos testes. O gate de
|
|
13
|
+
release não precisa de máquina nova: precisa de **outro catálogo de checks** rodando na mesma
|
|
14
|
+
máquina.
|
|
15
|
+
|
|
16
|
+
Então extraímos o runner para `lib/core/checks.mjs` e deixamos dois catálogos: `health.mjs` (o
|
|
17
|
+
núcleo, fronteira *repo*) e `release.mjs` (o tarball, fronteira *pacote publicado*). Mesma
|
|
18
|
+
severidade, mesma cascata, mesmo contrato de `fix`. Uma máquina, duas fronteiras.
|
|
19
|
+
|
|
20
|
+
A diferença essencial em relação ao doctor: o gate de release **não inspeciona; ele instala**. Grep
|
|
21
|
+
não prova ausência — instalação prova. O `release-auditor` já diz isso, e é a razão de o gate ser
|
|
22
|
+
lento e de tudo bem ser lento.
|
|
23
|
+
|
|
24
|
+
## 2. Módulos afetados
|
|
25
|
+
|
|
26
|
+
| Caminho | Mudança | Risco |
|
|
27
|
+
|---|---|---|
|
|
28
|
+
| `lib/core/checks.mjs` | **criar** — runner extraído de `health.mjs` (`runChecks`, `worstStatus`) | M |
|
|
29
|
+
| `lib/core/health.mjs` | editar — passa a importar o runner; re-exporta para não quebrar consumidores | M |
|
|
30
|
+
| `lib/core/release.mjs` | **criar** — catálogo dos checks de tarball | M |
|
|
31
|
+
| `scripts/release-check.mjs` | **criar** — apresentação + exit code | B |
|
|
32
|
+
| `lib/core/registry.mjs` | editar — `release:check` (ADR-0020) | B |
|
|
33
|
+
| `package.json` | editar — `prepublishOnly` | **A** |
|
|
34
|
+
| `.github/workflows/ci.yml` | editar — steps `tools:doctor` e `release:check` | B |
|
|
35
|
+
| `.claude/agents/release-auditor.md` | reescrever — consome o gate, não reimplementa | B |
|
|
36
|
+
| `test/release.test.js` | **criar** — os três bugs históricos como fixture | B |
|
|
37
|
+
|
|
38
|
+
Risco alto no `prepublishOnly`: se ele falhar indevidamente, **ninguém consegue publicar**. É o
|
|
39
|
+
único ponto onde um falso positivo trava a operação inteira em vez de só incomodar.
|
|
40
|
+
|
|
41
|
+
## 3. Diagrama de fluxo
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
npm run release:check [--publish]
|
|
45
|
+
│
|
|
46
|
+
▼
|
|
47
|
+
┌─ preflight ───────────────────────────────────────┐
|
|
48
|
+
│ árvore limpa? --publish → fail senão → warn │ ← v1.1.1 morreu aqui
|
|
49
|
+
└───────────────────────────────────────────────────┘
|
|
50
|
+
│
|
|
51
|
+
▼
|
|
52
|
+
npm pack → /tmp/forja-release-<pid>/
|
|
53
|
+
│
|
|
54
|
+
▼
|
|
55
|
+
npm init + npm i <tgz> (isolado: sem NODE_PATH, sem node_modules do repo)
|
|
56
|
+
│
|
|
57
|
+
▼
|
|
58
|
+
┌──────────── RELEASE_CHECKS[] (lib/core/release.mjs) ──────────┐
|
|
59
|
+
│ id severity o que prova │
|
|
60
|
+
│ tree-clean critical* tarball == commit (*warn sem --publish)
|
|
61
|
+
│ install critical o pacote instala do zero │
|
|
62
|
+
│ registry-scripts critical os 41 comandos existem no tarball │
|
|
63
|
+
│ smoke-commands critical os comandos EXECUTAM (não só help) │
|
|
64
|
+
│ reprova por stderr, não exit code │
|
|
65
|
+
│ deps-declared critical importado ⊆ dependencies │
|
|
66
|
+
│ deps-unused warn dependency que ninguém importa │
|
|
67
|
+
│ imports-resolve critical import relativo resolve no tarball │
|
|
68
|
+
└───────────────────────────────────────────────────────────────┘
|
|
69
|
+
│
|
|
70
|
+
▼
|
|
71
|
+
re-check árvore limpa ← a aprovação é perecível
|
|
72
|
+
│
|
|
73
|
+
▼
|
|
74
|
+
exit 0 / exit 1 + limpa o /tmp
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## 4. Contratos (API/CLI/Schema)
|
|
78
|
+
|
|
79
|
+
```js
|
|
80
|
+
// lib/core/checks.mjs — o runner, sem opinião sobre o que checa
|
|
81
|
+
export async function runChecks(opts); // { checks, scope, env } -> Result[]
|
|
82
|
+
export function worstStatus(results); // -> 'ok' | 'warn' | 'fail'
|
|
83
|
+
|
|
84
|
+
// lib/core/health.mjs — inalterado para quem consome
|
|
85
|
+
export { runChecks, worstStatus } from './checks.mjs'; // re-export: tools-doctor e o hook seguem iguais
|
|
86
|
+
export const CHECKS; // os 7 do núcleo
|
|
87
|
+
|
|
88
|
+
// lib/core/release.mjs
|
|
89
|
+
export const RELEASE_CHECKS;
|
|
90
|
+
export async function withCleanInstall(fn); // empacota, instala isolado, executa, limpa. Sempre limpa.
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
**CLI**:
|
|
94
|
+
|
|
95
|
+
| Comando | Árvore suja | Uso |
|
|
96
|
+
|---|---|---|
|
|
97
|
+
| `npm run release:check` | `warn` | Dev quer o smoke test sem commitar. Reprova o resto normalmente. |
|
|
98
|
+
| `npm run release:check -- --publish` | **`fail`** | `prepublishOnly` e CI de release. |
|
|
99
|
+
|
|
100
|
+
A distinção existe porque um gate que reprova todo desenvolvimento local vira um gate que se
|
|
101
|
+
contorna — a lição que o CI nos deu na SPEC-009, quando `memory-db` reprovava qualquer clone novo.
|
|
102
|
+
Mas na hora de publicar, árvore suja é **fatal**: foi assim que `otplib` e `qrcode` entraram na
|
|
103
|
+
v1.1.1 sem existirem no git.
|
|
104
|
+
|
|
105
|
+
## 5. Decisões e alternativas
|
|
106
|
+
|
|
107
|
+
**D1: Extrair o runner em vez de duplicá-lo.** `health.mjs` já tem cascata, blindagem de probe e
|
|
108
|
+
`worstStatus` testados. Copiar tudo para `release.mjs` criaria duas máquinas que divergem com o
|
|
109
|
+
tempo — exatamente o defeito que a SPEC-009 matou quando o doctor e o hook divergiram. Alternativa
|
|
110
|
+
rejeitada: `release.mjs` importar de `health.mjs`, deixando o núcleo dono de um runner que não é
|
|
111
|
+
dele.
|
|
112
|
+
|
|
113
|
+
**D2: Instalar, não inspecionar.** O gate faz `npm pack` + `npm i` de verdade. Alternativa
|
|
114
|
+
rejeitada: análise estática do tarball — foi o que eu fiz à mão hoje e produziu **falso positivo
|
|
115
|
+
imediato** (os geradores contêm `import` dentro de template string). Grep não prova ausência.
|
|
116
|
+
|
|
117
|
+
**D3: Template literals são removidos antes do parse.** Onde a análise estática for inevitável
|
|
118
|
+
(`deps-declared`), o conteúdo entre crases é apagado do fonte antes de casar `import`. Os geradores
|
|
119
|
+
*escrevem* código NestJS; não o executam. Sem isso, o check acusa `@nestjs/core` como dependência
|
|
120
|
+
não declarada — e é o bug latente que já existe hoje no `runtime-deps` (AC-11).
|
|
121
|
+
|
|
122
|
+
**D4: Dois modos (`--publish`).** Ver §4. Severidade do `tree-clean` muda com o contexto; o resto
|
|
123
|
+
é idêntico.
|
|
124
|
+
|
|
125
|
+
**D5: A aprovação é perecível.** O `git status` é reconferido **ao final**, porque a auditoria vale
|
|
126
|
+
para o disco no instante em que rodou. Um `npm install` entre o check e o publish invalida tudo — e
|
|
127
|
+
essa foi literalmente a causa da v1.1.1.
|
|
128
|
+
|
|
129
|
+
**D6: O gate nunca publica.** Ele autoriza. `npm publish` continua sendo um ato humano deliberado.
|
|
130
|
+
|
|
131
|
+
**D7: `deps-unused` é `warn`, não `fail`.** Peso morto no tarball incomoda, não quebra. Reprovar um
|
|
132
|
+
release por causa disso é o tipo de rigor que ensina o time a usar `--no-verify`.
|
|
133
|
+
|
|
134
|
+
**D8: `smoke-commands` reprova por padrão no stderr, nunca por exit code.** Numa instalação limpa
|
|
135
|
+
não existe workspace nem `universal.db` — então `query:universal` sai com código ≠ 0 *legitimamente*,
|
|
136
|
+
e `tools:doctor` avisa sobre memória não indexada. Isso é o pacote **funcionando**. O que denuncia
|
|
137
|
+
tarball quebrado é a assinatura do carregamento: `ERR_MODULE_NOT_FOUND`, `ERR_DLOPEN_FAILED`,
|
|
138
|
+
`Cannot find module`. Reprovar por exit code faria o gate reprovar um pacote saudável — é a mesma
|
|
139
|
+
armadilha do `memory-db` na SPEC-009, um nível acima.
|
|
140
|
+
|
|
141
|
+
**D9: `prepublishOnly`, nunca `prepack`.** O gate roda `npm pack`. Amarrá-lo ao `prepack` faria o
|
|
142
|
+
`npm pack` do gate disparar o `prepack`, que chama o gate, que roda `npm pack`… `npm pack` **não**
|
|
143
|
+
dispara `prepublishOnly`, então o hook correto é o único seguro. Vale um comentário no
|
|
144
|
+
`package.json`: a alternativa "óbvia" é uma bomba-relógio.
|
|
145
|
+
|
|
146
|
+
D1 e a mudança de contrato do `prepublishOnly` são estruturais → **ADR-0024**, referenciando
|
|
147
|
+
ADR-0023 (mesma filosofia, fronteira seguinte) e ADR-0021 (a classe que ambos fecham).
|
|
148
|
+
|
|
149
|
+
## 6. Dependências
|
|
150
|
+
|
|
151
|
+
- **Specs**: SPEC-009 (`lib/core/health.mjs` é a base do runner). Já em `done`.
|
|
152
|
+
- **Pacotes npm**: **nenhum novo.** `npm pack`/`npm i` via `child_process`.
|
|
153
|
+
- **Migrações**: nenhuma.
|
|
154
|
+
|
|
155
|
+
## 7. Rollout
|
|
156
|
+
|
|
157
|
+
- [ ] **Ordem**: `checks.mjs` extraído + suíte verde (refactor puro, nada muda de comportamento) →
|
|
158
|
+
`release.mjs` + testes → `release-check.mjs` → CI → `prepublishOnly` **por último**.
|
|
159
|
+
- [x] Doc/persona impactada: `docs/publishing.md`, `CLAUDE.md`, persona **governança**.
|
|
160
|
+
- [ ] **Validar reintroduzindo os três bugs históricos** (better-sqlite3 em devDeps; arquivo fora do
|
|
161
|
+
`files[]`; árvore suja). Cada um deve reprovar. Um gate que nunca viu a falha que promete
|
|
162
|
+
pegar não está testado — está escrito.
|
|
163
|
+
- [ ] `prepublishOnly` entra **depois** de o gate rodar verde no CI por um ciclo. Ele é a única
|
|
164
|
+
peça que, com falso positivo, impede publicar qualquer coisa.
|
|
165
|
+
|
|
166
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
167
|
+
|
|
168
|
+
- **O gate reprova um release saudável.** Um falso positivo no `prepublishOnly` trava a operação
|
|
169
|
+
inteira. Se acontecer uma vez, o `tree-clean` estrito sai do `prepublishOnly` e fica só no CI.
|
|
170
|
+
- **`deps-declared` volta a acusar os geradores.** Se o D3 não bastar, o check é rebaixado a `warn`
|
|
171
|
+
e a cobertura passa a vir do `smoke-commands` (que executa e não mente).
|
|
172
|
+
- **O gate leva minutos.** O custo real não é o `npm pack` — é o `npm i` compilando o
|
|
173
|
+
`better-sqlite3` do zero (o CI já gasta ~1min45 nisso). Se ficar caro demais, o gate sai do fluxo
|
|
174
|
+
de PR e fica só no release: a instalação limpa é inegociável, a frequência não.
|