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
|
@@ -1,172 +1,172 @@
|
|
|
1
|
-
# Tasks: doctor-do-nucleo
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: done
|
|
6
|
-
- **Criado em**: 2026-07-13
|
|
7
|
-
|
|
8
|
-
> Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
|
|
9
|
-
|
|
10
|
-
Convenção de IDs: `T1`, `T2`, … A sequência reflete a **ordem de merge do plano §7**: a lib e os
|
|
11
|
-
testes primeiro (nada a consome ainda), depois as superfícies, e o hook por último — é o de maior
|
|
12
|
-
risco e o único que roda em toda sessão.
|
|
13
|
-
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
## T1 — Runner e contrato de `lib/core/health.mjs`
|
|
17
|
-
- **Owner**: Worker
|
|
18
|
-
- **Estimativa**: M
|
|
19
|
-
- **Depende de**: —
|
|
20
|
-
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
21
|
-
- **Escopo**: o esqueleto sem nenhum probe real — `CHECKS[]` vazio ou com um probe de fixture.
|
|
22
|
-
- **Done quando**:
|
|
23
|
-
- [x] `runChecks({ scope, env })` e `worstStatus(results)` exportados conforme plano §4 (AC-1)
|
|
24
|
-
- [x] Cascata: check com `dependsOn` que falhou é reportado `skipped`, nunca `fail`
|
|
25
|
-
- [x] Runner blinda o probe: probe que **lança** vira `fail` com o erro no `detail`, e o runner
|
|
26
|
-
continua os demais — nunca propaga exceção (NFR de resiliência)
|
|
27
|
-
- [x] `worstStatus` só devolve `fail` para `critical`; `warn` nunca escala
|
|
28
|
-
- [x] `env` injetável (`{ root, importModule, fs, workspace }`) com default real (D5)
|
|
29
|
-
- [x] `test/health.test.js` cobre cascata, blindagem e `worstStatus` com probes de fixture
|
|
30
|
-
- [x] Zero dependências novas (plano §6)
|
|
31
|
-
|
|
32
|
-
## T2 — Probes de memória: `native-abi`, `memory-db`, `memory-fresh`
|
|
33
|
-
- **Owner**: Worker
|
|
34
|
-
- **Estimativa**: M
|
|
35
|
-
- **Depende de**: T1
|
|
36
|
-
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
37
|
-
- **Escopo**: os três checks que teriam pego a quebra de hoje. É o núcleo do núcleo.
|
|
38
|
-
- **Done quando**:
|
|
39
|
-
- [x] `native-abi` (critical) classifica por `err.code`, **não** por string de mensagem (risco da
|
|
40
|
-
spec): `ERR_DLOPEN_FAILED` → `npm rebuild better-sqlite3`; `ERR_MODULE_NOT_FOUND` →
|
|
41
|
-
`npm install` (AC-3)
|
|
42
|
-
- [x] `memory-db` (critical, `dependsOn: native-abi`) distingue **ausente** de **inacessível**,
|
|
43
|
-
cada um com sua correção (AC-4)
|
|
44
|
-
- [x] `memory-fresh` (**warn**, `dependsOn: memory-db`): `memory/` alterado depois do último sync
|
|
45
|
-
→ `npm run sync:universal`. Reaproveita a lógica de `newestMemoryMtime` que hoje vive no
|
|
46
|
-
hook (AC-4)
|
|
47
|
-
- [x] Teste do ABI quebrado injeta `env.importModule` que lança `ERR_DLOPEN_FAILED` — sem mock de
|
|
48
|
-
módulo, sem corromper `node_modules` (D5)
|
|
49
|
-
- [x] Cada probe testado nos dois estados: são e quebrado (AC-9)
|
|
50
|
-
|
|
51
|
-
## T3 — Probes de ambiente: `workspace`, `node-engines`
|
|
52
|
-
- **Owner**: Worker
|
|
53
|
-
- **Estimativa**: P
|
|
54
|
-
- **Depende de**: T1
|
|
55
|
-
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
56
|
-
- **Done quando**:
|
|
57
|
-
- [x] `workspace` (**warn**, D4) usa `getWorkspaceInfo()` de `lib/workspace.mjs`; se não resolve
|
|
58
|
-
para diretório existente → `npm run workspace:init`. Reporta também a **origem** da
|
|
59
|
-
resolução (`FORJA_WORKSPACE` / `~/.forjarc.json` / default), que é metade do diagnóstico
|
|
60
|
-
quando o workspace certo existe mas não é o que está sendo usado (AC-5)
|
|
61
|
-
- [x] `node-engines` (**warn**) compara `process.versions.node` com `engines.node` do
|
|
62
|
-
`package.json`
|
|
63
|
-
- [x] Ambos testados nos dois estados via `env.fs` / `env.workspace` injetados
|
|
64
|
-
|
|
65
|
-
## T4 — Probes de regressão do repo: `runtime-deps`, `mcp-json`
|
|
66
|
-
- **Owner**: Worker
|
|
67
|
-
- **Estimativa**: M
|
|
68
|
-
- **Depende de**: T1
|
|
69
|
-
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
70
|
-
- **Escopo**: converte em gate executável os dois invariantes que o ADR-0021 corrigiu à mão e que
|
|
71
|
-
hoje podem reincidir sem que nada perceba.
|
|
72
|
-
- **Done quando**:
|
|
73
|
-
- [x] Ambos com `scope: 'repo'` — **não** rodam fora do repo do framework, onde produziriam falso
|
|
74
|
-
positivo crítico na máquina do usuário final (D3). Detecção: `.git` + `package.json` com
|
|
75
|
-
`name: forjajs`
|
|
76
|
-
- [x] `runtime-deps` (critical): todo módulo importado **estaticamente** por script sob `files[]`
|
|
77
|
-
está em `dependencies`, não em `devDependencies` (AC-6). Parser **conservador**: import
|
|
78
|
-
dinâmico ou não resolvido → `warn`, nunca `fail` (risco da spec)
|
|
79
|
-
- [x] `mcp-json` (critical): nenhum path absoluto versionado em `.mcp.json` (AC-7)
|
|
80
|
-
- [x] Teste com fixture de `package.json`/`.mcp.json` quebrados, via `env.fs` e `env.root`
|
|
81
|
-
- [x] Teste garantindo que ambos são `skipped` quando `scope: 'runtime'`
|
|
82
|
-
|
|
83
|
-
## T5 — `tools:doctor` consome a lib e vira gate
|
|
84
|
-
- **Owner**: Worker
|
|
85
|
-
- **Estimativa**: M
|
|
86
|
-
- **Depende de**: T2, T3, T4
|
|
87
|
-
- **Paths**: `scripts/tools-doctor.mjs`
|
|
88
|
-
- **Done quando**:
|
|
89
|
-
- [x] Duas seções na saída: **Núcleo** e **Ferramentas** (AC-2)
|
|
90
|
-
- [x] `exit 1` **se e somente se** algum check `critical` do núcleo falhar. Ferramenta opcional
|
|
91
|
-
ausente segue `exit 0` — contrato do ADR-0018 preservado (AC-2, D4)
|
|
92
|
-
- [x] `TOOLS[]` das cinco ferramentas opcionais permanece intocado (spec §5, fora de escopo)
|
|
93
|
-
- [x] Cada falha imprime o comando de correção ao lado
|
|
94
|
-
- [x] Roda em < 2s (NFR)
|
|
95
|
-
- [x] Funciona **sem `node_modules`** — é justamente aí que ele mais importa (NFR)
|
|
96
|
-
|
|
97
|
-
## T6 — `SessionStart` consome a lib e perde a heurística própria
|
|
98
|
-
- **Owner**: Worker
|
|
99
|
-
- **Estimativa**: M
|
|
100
|
-
- **Depende de**: T2, T3
|
|
101
|
-
- **Paths**: `scripts/hook-session-start.mjs`
|
|
102
|
-
- **Escopo**: a task de maior risco. O hook roda em toda sessão e o ADR-0021 o marcou como "nunca
|
|
103
|
-
pode derrubar a sessão".
|
|
104
|
-
- **Done quando**:
|
|
105
|
-
- [x] `resolveDbPath()` e `staleIndex()` **deixam de existir** — o `catch { return null }` que
|
|
106
|
-
colapsa três causas distintas é a raiz do problema (plano §1)
|
|
107
|
-
- [x] A prescrição errada (`npm install` para ABI quebrado, linha 91) não existe mais no código
|
|
108
|
-
(AC-8)
|
|
109
|
-
- [x] Chama `runChecks({ scope: 'runtime' })` — zero heurística própria (AC-8)
|
|
110
|
-
- [x] **Sempre `exit 0`**: o hook reporta, nunca trava a sessão (ADR-0021)
|
|
111
|
-
- [x] Cabe com folga no timeout de 5s; se não couber, ver kill criteria do plano §8
|
|
112
|
-
- [x] `test/hooks.test.js` estendido: sem `node_modules` o hook degrada, não estoura
|
|
113
|
-
|
|
114
|
-
## T7 — ADR-0023
|
|
115
|
-
- **Owner**: SDD Architect
|
|
116
|
-
- **Estimativa**: P
|
|
117
|
-
- **Depende de**: T5, T6
|
|
118
|
-
- **Paths**: `memory/90-decisions/0023-doctor-como-gate-do-nucleo.md`
|
|
119
|
-
- **Done quando**:
|
|
120
|
-
- [x] Registra D1 (checks como dados), D3 (`scope` repo/runtime) e a mudança de contrato do exit
|
|
121
|
-
code (AC-10)
|
|
122
|
-
- [x] Referencia ADR-0018 (que estende) e ADR-0021 (a classe de falha que fecha)
|
|
123
|
-
- [x] Segue `memory/90-decisions/_template.md`
|
|
124
|
-
|
|
125
|
-
## T8 — Registry e documentação
|
|
126
|
-
- **Owner**: Worker
|
|
127
|
-
- **Estimativa**: P
|
|
128
|
-
- **Depende de**: T5
|
|
129
|
-
- **Paths**: `lib/core/registry.mjs`, `CLAUDE.md`, `docs/`
|
|
130
|
-
- **Done quando**:
|
|
131
|
-
- [x] `desc` do `tools:doctor` no registry reflete o novo papel (deixa de ser só "ferramentas de
|
|
132
|
-
processo")
|
|
133
|
-
- [x] `CLAUDE.md` e `docs/` onde o comando é descrito como "raio-x de ferramentas"
|
|
134
|
-
- [x] `npm test` verde, incluindo `test/forja-core.test.js` (integridade do registry, ADR-0020)
|
|
135
|
-
|
|
136
|
-
## T9 — Validação no cenário real
|
|
137
|
-
- **Owner**: Governance
|
|
138
|
-
- **Estimativa**: P
|
|
139
|
-
- **Depende de**: T5, T6, T7, T8
|
|
140
|
-
- **Paths**: —
|
|
141
|
-
- **Done quando**:
|
|
142
|
-
- [x] `tools:doctor` roda sob um Node de **major diferente** e reporta o ABI quebrado com a
|
|
143
|
-
prescrição certa. Um doctor de ABI que nunca viu um ABI quebrado não está testado, está
|
|
144
|
-
escrito (plano §7)
|
|
145
|
-
- [x] `npm run project:check` e `npm test` verdes
|
|
146
|
-
- [x] `gitleaks detect --no-banner` limpo
|
|
147
|
-
- [x] Suíte completa verde (AC-9); spec → `done`
|
|
148
|
-
|
|
149
|
-
## T10 — `spec:new` mantém a allow-list do `.gitignore`
|
|
150
|
-
- **Owner**: Worker
|
|
151
|
-
- **Estimativa**: P
|
|
152
|
-
- **Depende de**: — *(independente da lib; pode ir primeiro)*
|
|
153
|
-
- **Paths**: `scripts/spec-cli.mjs`, `test/spec-cli.test.js`
|
|
154
|
-
- **Contexto**: descoberto ao escrever o plano. O `.gitignore` ignora `/specs/*` e mantém uma
|
|
155
|
-
allow-list manual; **toda spec nova do framework nasce invisível ao git**. Aconteceu com esta
|
|
156
|
-
própria spec. Emenda de 2026-07-13 à spec (AC-11).
|
|
157
|
-
- **Done quando**:
|
|
158
|
-
- [x] `spec:new <slug>` acrescenta `!/specs/<slug>` ao bloco de allow-list do `.gitignore`
|
|
159
|
-
- [x] **Idempotente**: rodar duas vezes não duplica a linha
|
|
160
|
-
- [x] Insere **dentro do bloco existente** (após a última `!/specs/…`), não no fim do arquivo —
|
|
161
|
-
as regras seguintes do `.gitignore` dependem da ordem
|
|
162
|
-
- [x] Se o bloco não existir (ou o `.gitignore` sumir), **não falha** a criação da spec: avisa e
|
|
163
|
-
segue. Criar spec é o trabalho; manter o gitignore é o efeito colateral
|
|
164
|
-
- [x] Teste: cria spec num `.gitignore` de fixture e verifica a linha, a idempotência e a posição
|
|
165
|
-
- [x] `git status` mostra a spec recém-criada, sem passo manual (AC-11)
|
|
166
|
-
|
|
167
|
-
---
|
|
168
|
-
|
|
169
|
-
## Handoffs entre agentes
|
|
170
|
-
|
|
171
|
-
Este conjunto atravessa Worker (T1-T6, T8, T10), SDD Architect (T7) e Governance (T9). Registrar
|
|
172
|
-
handoff a cada fronteira via `npm run agent:route` — 7 campos obrigatórios (ADR-0005).
|
|
1
|
+
# Tasks: doctor-do-nucleo
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-07-13
|
|
7
|
+
|
|
8
|
+
> Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
|
|
9
|
+
|
|
10
|
+
Convenção de IDs: `T1`, `T2`, … A sequência reflete a **ordem de merge do plano §7**: a lib e os
|
|
11
|
+
testes primeiro (nada a consome ainda), depois as superfícies, e o hook por último — é o de maior
|
|
12
|
+
risco e o único que roda em toda sessão.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## T1 — Runner e contrato de `lib/core/health.mjs`
|
|
17
|
+
- **Owner**: Worker
|
|
18
|
+
- **Estimativa**: M
|
|
19
|
+
- **Depende de**: —
|
|
20
|
+
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
21
|
+
- **Escopo**: o esqueleto sem nenhum probe real — `CHECKS[]` vazio ou com um probe de fixture.
|
|
22
|
+
- **Done quando**:
|
|
23
|
+
- [x] `runChecks({ scope, env })` e `worstStatus(results)` exportados conforme plano §4 (AC-1)
|
|
24
|
+
- [x] Cascata: check com `dependsOn` que falhou é reportado `skipped`, nunca `fail`
|
|
25
|
+
- [x] Runner blinda o probe: probe que **lança** vira `fail` com o erro no `detail`, e o runner
|
|
26
|
+
continua os demais — nunca propaga exceção (NFR de resiliência)
|
|
27
|
+
- [x] `worstStatus` só devolve `fail` para `critical`; `warn` nunca escala
|
|
28
|
+
- [x] `env` injetável (`{ root, importModule, fs, workspace }`) com default real (D5)
|
|
29
|
+
- [x] `test/health.test.js` cobre cascata, blindagem e `worstStatus` com probes de fixture
|
|
30
|
+
- [x] Zero dependências novas (plano §6)
|
|
31
|
+
|
|
32
|
+
## T2 — Probes de memória: `native-abi`, `memory-db`, `memory-fresh`
|
|
33
|
+
- **Owner**: Worker
|
|
34
|
+
- **Estimativa**: M
|
|
35
|
+
- **Depende de**: T1
|
|
36
|
+
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
37
|
+
- **Escopo**: os três checks que teriam pego a quebra de hoje. É o núcleo do núcleo.
|
|
38
|
+
- **Done quando**:
|
|
39
|
+
- [x] `native-abi` (critical) classifica por `err.code`, **não** por string de mensagem (risco da
|
|
40
|
+
spec): `ERR_DLOPEN_FAILED` → `npm rebuild better-sqlite3`; `ERR_MODULE_NOT_FOUND` →
|
|
41
|
+
`npm install` (AC-3)
|
|
42
|
+
- [x] `memory-db` (critical, `dependsOn: native-abi`) distingue **ausente** de **inacessível**,
|
|
43
|
+
cada um com sua correção (AC-4)
|
|
44
|
+
- [x] `memory-fresh` (**warn**, `dependsOn: memory-db`): `memory/` alterado depois do último sync
|
|
45
|
+
→ `npm run sync:universal`. Reaproveita a lógica de `newestMemoryMtime` que hoje vive no
|
|
46
|
+
hook (AC-4)
|
|
47
|
+
- [x] Teste do ABI quebrado injeta `env.importModule` que lança `ERR_DLOPEN_FAILED` — sem mock de
|
|
48
|
+
módulo, sem corromper `node_modules` (D5)
|
|
49
|
+
- [x] Cada probe testado nos dois estados: são e quebrado (AC-9)
|
|
50
|
+
|
|
51
|
+
## T3 — Probes de ambiente: `workspace`, `node-engines`
|
|
52
|
+
- **Owner**: Worker
|
|
53
|
+
- **Estimativa**: P
|
|
54
|
+
- **Depende de**: T1
|
|
55
|
+
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
56
|
+
- **Done quando**:
|
|
57
|
+
- [x] `workspace` (**warn**, D4) usa `getWorkspaceInfo()` de `lib/workspace.mjs`; se não resolve
|
|
58
|
+
para diretório existente → `npm run workspace:init`. Reporta também a **origem** da
|
|
59
|
+
resolução (`FORJA_WORKSPACE` / `~/.forjarc.json` / default), que é metade do diagnóstico
|
|
60
|
+
quando o workspace certo existe mas não é o que está sendo usado (AC-5)
|
|
61
|
+
- [x] `node-engines` (**warn**) compara `process.versions.node` com `engines.node` do
|
|
62
|
+
`package.json`
|
|
63
|
+
- [x] Ambos testados nos dois estados via `env.fs` / `env.workspace` injetados
|
|
64
|
+
|
|
65
|
+
## T4 — Probes de regressão do repo: `runtime-deps`, `mcp-json`
|
|
66
|
+
- **Owner**: Worker
|
|
67
|
+
- **Estimativa**: M
|
|
68
|
+
- **Depende de**: T1
|
|
69
|
+
- **Paths**: `lib/core/health.mjs`, `test/health.test.js`
|
|
70
|
+
- **Escopo**: converte em gate executável os dois invariantes que o ADR-0021 corrigiu à mão e que
|
|
71
|
+
hoje podem reincidir sem que nada perceba.
|
|
72
|
+
- **Done quando**:
|
|
73
|
+
- [x] Ambos com `scope: 'repo'` — **não** rodam fora do repo do framework, onde produziriam falso
|
|
74
|
+
positivo crítico na máquina do usuário final (D3). Detecção: `.git` + `package.json` com
|
|
75
|
+
`name: forjajs`
|
|
76
|
+
- [x] `runtime-deps` (critical): todo módulo importado **estaticamente** por script sob `files[]`
|
|
77
|
+
está em `dependencies`, não em `devDependencies` (AC-6). Parser **conservador**: import
|
|
78
|
+
dinâmico ou não resolvido → `warn`, nunca `fail` (risco da spec)
|
|
79
|
+
- [x] `mcp-json` (critical): nenhum path absoluto versionado em `.mcp.json` (AC-7)
|
|
80
|
+
- [x] Teste com fixture de `package.json`/`.mcp.json` quebrados, via `env.fs` e `env.root`
|
|
81
|
+
- [x] Teste garantindo que ambos são `skipped` quando `scope: 'runtime'`
|
|
82
|
+
|
|
83
|
+
## T5 — `tools:doctor` consome a lib e vira gate
|
|
84
|
+
- **Owner**: Worker
|
|
85
|
+
- **Estimativa**: M
|
|
86
|
+
- **Depende de**: T2, T3, T4
|
|
87
|
+
- **Paths**: `scripts/tools-doctor.mjs`
|
|
88
|
+
- **Done quando**:
|
|
89
|
+
- [x] Duas seções na saída: **Núcleo** e **Ferramentas** (AC-2)
|
|
90
|
+
- [x] `exit 1` **se e somente se** algum check `critical` do núcleo falhar. Ferramenta opcional
|
|
91
|
+
ausente segue `exit 0` — contrato do ADR-0018 preservado (AC-2, D4)
|
|
92
|
+
- [x] `TOOLS[]` das cinco ferramentas opcionais permanece intocado (spec §5, fora de escopo)
|
|
93
|
+
- [x] Cada falha imprime o comando de correção ao lado
|
|
94
|
+
- [x] Roda em < 2s (NFR)
|
|
95
|
+
- [x] Funciona **sem `node_modules`** — é justamente aí que ele mais importa (NFR)
|
|
96
|
+
|
|
97
|
+
## T6 — `SessionStart` consome a lib e perde a heurística própria
|
|
98
|
+
- **Owner**: Worker
|
|
99
|
+
- **Estimativa**: M
|
|
100
|
+
- **Depende de**: T2, T3
|
|
101
|
+
- **Paths**: `scripts/hook-session-start.mjs`
|
|
102
|
+
- **Escopo**: a task de maior risco. O hook roda em toda sessão e o ADR-0021 o marcou como "nunca
|
|
103
|
+
pode derrubar a sessão".
|
|
104
|
+
- **Done quando**:
|
|
105
|
+
- [x] `resolveDbPath()` e `staleIndex()` **deixam de existir** — o `catch { return null }` que
|
|
106
|
+
colapsa três causas distintas é a raiz do problema (plano §1)
|
|
107
|
+
- [x] A prescrição errada (`npm install` para ABI quebrado, linha 91) não existe mais no código
|
|
108
|
+
(AC-8)
|
|
109
|
+
- [x] Chama `runChecks({ scope: 'runtime' })` — zero heurística própria (AC-8)
|
|
110
|
+
- [x] **Sempre `exit 0`**: o hook reporta, nunca trava a sessão (ADR-0021)
|
|
111
|
+
- [x] Cabe com folga no timeout de 5s; se não couber, ver kill criteria do plano §8
|
|
112
|
+
- [x] `test/hooks.test.js` estendido: sem `node_modules` o hook degrada, não estoura
|
|
113
|
+
|
|
114
|
+
## T7 — ADR-0023
|
|
115
|
+
- **Owner**: SDD Architect
|
|
116
|
+
- **Estimativa**: P
|
|
117
|
+
- **Depende de**: T5, T6
|
|
118
|
+
- **Paths**: `memory/90-decisions/0023-doctor-como-gate-do-nucleo.md`
|
|
119
|
+
- **Done quando**:
|
|
120
|
+
- [x] Registra D1 (checks como dados), D3 (`scope` repo/runtime) e a mudança de contrato do exit
|
|
121
|
+
code (AC-10)
|
|
122
|
+
- [x] Referencia ADR-0018 (que estende) e ADR-0021 (a classe de falha que fecha)
|
|
123
|
+
- [x] Segue `memory/90-decisions/_template.md`
|
|
124
|
+
|
|
125
|
+
## T8 — Registry e documentação
|
|
126
|
+
- **Owner**: Worker
|
|
127
|
+
- **Estimativa**: P
|
|
128
|
+
- **Depende de**: T5
|
|
129
|
+
- **Paths**: `lib/core/registry.mjs`, `CLAUDE.md`, `docs/`
|
|
130
|
+
- **Done quando**:
|
|
131
|
+
- [x] `desc` do `tools:doctor` no registry reflete o novo papel (deixa de ser só "ferramentas de
|
|
132
|
+
processo")
|
|
133
|
+
- [x] `CLAUDE.md` e `docs/` onde o comando é descrito como "raio-x de ferramentas"
|
|
134
|
+
- [x] `npm test` verde, incluindo `test/forja-core.test.js` (integridade do registry, ADR-0020)
|
|
135
|
+
|
|
136
|
+
## T9 — Validação no cenário real
|
|
137
|
+
- **Owner**: Governance
|
|
138
|
+
- **Estimativa**: P
|
|
139
|
+
- **Depende de**: T5, T6, T7, T8
|
|
140
|
+
- **Paths**: —
|
|
141
|
+
- **Done quando**:
|
|
142
|
+
- [x] `tools:doctor` roda sob um Node de **major diferente** e reporta o ABI quebrado com a
|
|
143
|
+
prescrição certa. Um doctor de ABI que nunca viu um ABI quebrado não está testado, está
|
|
144
|
+
escrito (plano §7)
|
|
145
|
+
- [x] `npm run project:check` e `npm test` verdes
|
|
146
|
+
- [x] `gitleaks detect --no-banner` limpo
|
|
147
|
+
- [x] Suíte completa verde (AC-9); spec → `done`
|
|
148
|
+
|
|
149
|
+
## T10 — `spec:new` mantém a allow-list do `.gitignore`
|
|
150
|
+
- **Owner**: Worker
|
|
151
|
+
- **Estimativa**: P
|
|
152
|
+
- **Depende de**: — *(independente da lib; pode ir primeiro)*
|
|
153
|
+
- **Paths**: `scripts/spec-cli.mjs`, `test/spec-cli.test.js`
|
|
154
|
+
- **Contexto**: descoberto ao escrever o plano. O `.gitignore` ignora `/specs/*` e mantém uma
|
|
155
|
+
allow-list manual; **toda spec nova do framework nasce invisível ao git**. Aconteceu com esta
|
|
156
|
+
própria spec. Emenda de 2026-07-13 à spec (AC-11).
|
|
157
|
+
- **Done quando**:
|
|
158
|
+
- [x] `spec:new <slug>` acrescenta `!/specs/<slug>` ao bloco de allow-list do `.gitignore`
|
|
159
|
+
- [x] **Idempotente**: rodar duas vezes não duplica a linha
|
|
160
|
+
- [x] Insere **dentro do bloco existente** (após a última `!/specs/…`), não no fim do arquivo —
|
|
161
|
+
as regras seguintes do `.gitignore` dependem da ordem
|
|
162
|
+
- [x] Se o bloco não existir (ou o `.gitignore` sumir), **não falha** a criação da spec: avisa e
|
|
163
|
+
segue. Criar spec é o trabalho; manter o gitignore é o efeito colateral
|
|
164
|
+
- [x] Teste: cria spec num `.gitignore` de fixture e verifica a linha, a idempotência e a posição
|
|
165
|
+
- [x] `git status` mostra a spec recém-criada, sem passo manual (AC-11)
|
|
166
|
+
|
|
167
|
+
---
|
|
168
|
+
|
|
169
|
+
## Handoffs entre agentes
|
|
170
|
+
|
|
171
|
+
Este conjunto atravessa Worker (T1-T6, T8, T10), SDD Architect (T7) e Governance (T9). Registrar
|
|
172
|
+
handoff a cada fronteira via `npm run agent:route` — 7 campos obrigatórios (ADR-0005).
|
package/specs/forja-core/spec.md
CHANGED
|
@@ -1,71 +1,71 @@
|
|
|
1
|
-
# Spec: forja-core
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-025
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: framework-team
|
|
6
|
-
- **Criado em**: 2026-07-06
|
|
7
|
-
- **Sprint alvo**: core-2026-07
|
|
8
|
-
- **ADRs relacionadas**: ADR-0020 (core CLI única), ADR-0019 (workspace separado), ADR-0005 (handoff 7 campos), ADR-0017 (codegraph no GSD)
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
O Forja se apresenta como framework de orquestração, mas os comandos não passam por um núcleo comum. Hoje existem **três dispatchers paralelos**:
|
|
12
|
-
|
|
13
|
-
1. `scripts/agent-harness.mjs` — workspace, GSD, design, code intelligence (com gates próprios).
|
|
14
|
-
2. `scripts/dev.mjs` — context, memória, project:health (registry próprio, duplica `design:*`/`gsd:*`).
|
|
15
|
-
3. `package.json` — ~40 scripts npm apontando direto para 15+ scripts soltos (`spec-cli`, `sprint-manager`, `sync-universal-memory`, `context-ops`, …), inclusive com a chave `project:check` **duplicada** (a primeira definição é silenciosamente descartada pelo npm).
|
|
16
|
-
|
|
17
|
-
Consequências mensuráveis:
|
|
18
|
-
- Nenhuma trilha de auditoria unificada: não dá para responder "quais comandos rodaram nesta feature?" sem grep em N lugares.
|
|
19
|
-
- Gates aplicados de forma desigual: `gsd:check` valida codegraph, mas `spec:tasks` e `sprint:start` não validam nada do processo.
|
|
20
|
-
- O workspace (ADR-0019) é resolvido por alguns comandos e ignorado por outros — um comando de produto pode rodar sem workspace e falhar tarde ou agir no lugar errado.
|
|
21
|
-
- Projetos gerados não são registrados em lugar nenhum: `project:new` cria a pasta e termina; a ficha em `memory/30-projects/` depende de disciplina manual.
|
|
22
|
-
|
|
23
|
-
## 2. Proposta de valor
|
|
24
|
-
Uma **CLI única `forja`** (bin/forja.mjs) vira o core executivo do framework: todo comando passa por um registry declarativo, com gates transversais (workspace, processo) e **trilha de auditoria** append-only. Projetos passam pelo core no nascimento (registro automático de ficha no workspace). Os dispatchers existentes viram implementação interna — nada é reescrito, tudo é roteado.
|
|
25
|
-
|
|
26
|
-
## 3. User stories
|
|
27
|
-
- **Como** operador do Forja, **quero** rodar `forja <comando>` (ou `npm run <alias>`) e ter um único ponto de entrada com help agrupado por domínio, **para que** eu não precise decorar qual script implementa o quê.
|
|
28
|
-
- **Como** governance, **quero** que toda execução de comando seja registrada em `.context/forja-runs.jsonl` (comando, args, exit code, duração), **para que** o review de uma feature tenha trilha de auditoria do processo.
|
|
29
|
-
- **Como** operador, **quero** que comandos de produto falhem cedo e com instrução clara quando o workspace não existe, **para que** nada rode no lugar errado (ADR-0019).
|
|
30
|
-
- **Como** orchestrator, **quero** que `project:new` registre automaticamente a ficha do projeto em `memory/30-projects/` do workspace, **para que** todo projeto nasça rastreado pelo core.
|
|
31
|
-
|
|
32
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
33
|
-
- [ ] AC-1: `node bin/forja.mjs` (sem args) lista todos os comandos agrupados por domínio; `forja <cmd> --help` ou comando desconhecido orienta com exit ≠ 0 no caso de erro.
|
|
34
|
-
- [ ] AC-2: existe `lib/core/registry.mjs` declarativo: cada comando tem domínio, descrição, alvo (script/binário) e gates; teste automatizado garante que todo script referenciado existe.
|
|
35
|
-
- [ ] AC-3: toda execução via core gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback: `.context/` do repo quando não há workspace) com ts, cmd, args, exitCode e durationMs.
|
|
36
|
-
- [ ] AC-4: comandos marcados com gate `workspace` falham cedo com mensagem "rode forja workspace:init" quando o workspace não existe.
|
|
37
|
-
- [ ] AC-5: os scripts npm do `package.json` roteiam pelo core (`node bin/forja.mjs <cmd>`); a chave duplicada `project:check` é eliminada; `forja` entra em `"bin"` do pacote.
|
|
38
|
-
- [ ] AC-6: `project:new` bem-sucedido grava/atualiza ficha do projeto em `<workspace>/memory/30-projects/<nome>.md`.
|
|
39
|
-
- [ ] AC-7: `npm test` cobre registry, help, comando desconhecido e gate de workspace; suíte existente continua verde.
|
|
40
|
-
|
|
41
|
-
## 5. Escopo
|
|
42
|
-
**Dentro**:
|
|
43
|
-
- `bin/forja.mjs` (dispatcher), `lib/core/registry.mjs` (registry + gates)
|
|
44
|
-
- `package.json`: bin `forja`, rewire dos scripts, remoção da duplicata
|
|
45
|
-
- `scripts/agent-harness.mjs`: ficha automática no `project:new`
|
|
46
|
-
- `test/forja-core.test.js`
|
|
47
|
-
- README/DOC-MAP: documentar o core como ponto de entrada
|
|
48
|
-
|
|
49
|
-
**Fora** (explícito, evita scope creep):
|
|
50
|
-
- Reescrever `dev.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. — continuam como implementação; `dev.mjs` fica como alias legado documentado
|
|
51
|
-
- Embutir a CLI `forja` nos projetos gerados (`lib/generators/`) — fase 2, spec própria
|
|
52
|
-
- Dashboard (`dashboard:*`) — front opcional, fora do processo
|
|
53
|
-
- Gravar auditoria no SQLite (JSONL primeiro; promoção a tabela é evolução futura)
|
|
54
|
-
|
|
55
|
-
## 6. NFRs / restrições
|
|
56
|
-
- Zero dependências novas (Node stdlib apenas).
|
|
57
|
-
- Overhead do roteamento imperceptível (< 100ms além do script alvo).
|
|
58
|
-
- Degradação graciosa: auditoria nunca bloqueia o comando (falha de escrita = warning).
|
|
59
|
-
- Compatibilidade: todos os aliases npm atuais continuam funcionando com a mesma semântica.
|
|
60
|
-
- pt-BR em toda saída de CLI.
|
|
61
|
-
|
|
62
|
-
## 7. Riscos e mitigação
|
|
63
|
-
| Risco | Probabilidade | Impacto | Mitigação |
|
|
64
|
-
|---|---|---|---|
|
|
65
|
-
| Duplo spawn (npm → forja → script) mascarar exit codes | B | A | Propagar `status` do filho sempre; testes de exit code |
|
|
66
|
-
| Registry divergir dos scripts reais | M | M | Teste de integridade (todo alvo existe no disco) |
|
|
67
|
-
| Gate de workspace bloquear fluxo legítimo do framework | M | M | Gate só em comandos de domínio de produto; framework roda sem workspace |
|
|
68
|
-
| JSONL de auditoria crescer sem limite | B | B | Arquivo em `.context/` (gitignored); rotação futura via `memory:compress` |
|
|
69
|
-
|
|
70
|
-
## 8. Métricas de sucesso
|
|
71
|
-
30 dias após o release: (a) 100% dos comandos de processo listados no help do core; (b) `forja-runs.jsonl` presente e usado em pelo menos um review de governance; (c) zero projetos criados sem ficha em `30-projects/`.
|
|
1
|
+
# Spec: forja-core
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-025
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: framework-team
|
|
6
|
+
- **Criado em**: 2026-07-06
|
|
7
|
+
- **Sprint alvo**: core-2026-07
|
|
8
|
+
- **ADRs relacionadas**: ADR-0020 (core CLI única), ADR-0019 (workspace separado), ADR-0005 (handoff 7 campos), ADR-0017 (codegraph no GSD)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O Forja se apresenta como framework de orquestração, mas os comandos não passam por um núcleo comum. Hoje existem **três dispatchers paralelos**:
|
|
12
|
+
|
|
13
|
+
1. `scripts/agent-harness.mjs` — workspace, GSD, design, code intelligence (com gates próprios).
|
|
14
|
+
2. `scripts/dev.mjs` — context, memória, project:health (registry próprio, duplica `design:*`/`gsd:*`).
|
|
15
|
+
3. `package.json` — ~40 scripts npm apontando direto para 15+ scripts soltos (`spec-cli`, `sprint-manager`, `sync-universal-memory`, `context-ops`, …), inclusive com a chave `project:check` **duplicada** (a primeira definição é silenciosamente descartada pelo npm).
|
|
16
|
+
|
|
17
|
+
Consequências mensuráveis:
|
|
18
|
+
- Nenhuma trilha de auditoria unificada: não dá para responder "quais comandos rodaram nesta feature?" sem grep em N lugares.
|
|
19
|
+
- Gates aplicados de forma desigual: `gsd:check` valida codegraph, mas `spec:tasks` e `sprint:start` não validam nada do processo.
|
|
20
|
+
- O workspace (ADR-0019) é resolvido por alguns comandos e ignorado por outros — um comando de produto pode rodar sem workspace e falhar tarde ou agir no lugar errado.
|
|
21
|
+
- Projetos gerados não são registrados em lugar nenhum: `project:new` cria a pasta e termina; a ficha em `memory/30-projects/` depende de disciplina manual.
|
|
22
|
+
|
|
23
|
+
## 2. Proposta de valor
|
|
24
|
+
Uma **CLI única `forja`** (bin/forja.mjs) vira o core executivo do framework: todo comando passa por um registry declarativo, com gates transversais (workspace, processo) e **trilha de auditoria** append-only. Projetos passam pelo core no nascimento (registro automático de ficha no workspace). Os dispatchers existentes viram implementação interna — nada é reescrito, tudo é roteado.
|
|
25
|
+
|
|
26
|
+
## 3. User stories
|
|
27
|
+
- **Como** operador do Forja, **quero** rodar `forja <comando>` (ou `npm run <alias>`) e ter um único ponto de entrada com help agrupado por domínio, **para que** eu não precise decorar qual script implementa o quê.
|
|
28
|
+
- **Como** governance, **quero** que toda execução de comando seja registrada em `.context/forja-runs.jsonl` (comando, args, exit code, duração), **para que** o review de uma feature tenha trilha de auditoria do processo.
|
|
29
|
+
- **Como** operador, **quero** que comandos de produto falhem cedo e com instrução clara quando o workspace não existe, **para que** nada rode no lugar errado (ADR-0019).
|
|
30
|
+
- **Como** orchestrator, **quero** que `project:new` registre automaticamente a ficha do projeto em `memory/30-projects/` do workspace, **para que** todo projeto nasça rastreado pelo core.
|
|
31
|
+
|
|
32
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
33
|
+
- [ ] AC-1: `node bin/forja.mjs` (sem args) lista todos os comandos agrupados por domínio; `forja <cmd> --help` ou comando desconhecido orienta com exit ≠ 0 no caso de erro.
|
|
34
|
+
- [ ] AC-2: existe `lib/core/registry.mjs` declarativo: cada comando tem domínio, descrição, alvo (script/binário) e gates; teste automatizado garante que todo script referenciado existe.
|
|
35
|
+
- [ ] AC-3: toda execução via core gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback: `.context/` do repo quando não há workspace) com ts, cmd, args, exitCode e durationMs.
|
|
36
|
+
- [ ] AC-4: comandos marcados com gate `workspace` falham cedo com mensagem "rode forja workspace:init" quando o workspace não existe.
|
|
37
|
+
- [ ] AC-5: os scripts npm do `package.json` roteiam pelo core (`node bin/forja.mjs <cmd>`); a chave duplicada `project:check` é eliminada; `forja` entra em `"bin"` do pacote.
|
|
38
|
+
- [ ] AC-6: `project:new` bem-sucedido grava/atualiza ficha do projeto em `<workspace>/memory/30-projects/<nome>.md`.
|
|
39
|
+
- [ ] AC-7: `npm test` cobre registry, help, comando desconhecido e gate de workspace; suíte existente continua verde.
|
|
40
|
+
|
|
41
|
+
## 5. Escopo
|
|
42
|
+
**Dentro**:
|
|
43
|
+
- `bin/forja.mjs` (dispatcher), `lib/core/registry.mjs` (registry + gates)
|
|
44
|
+
- `package.json`: bin `forja`, rewire dos scripts, remoção da duplicata
|
|
45
|
+
- `scripts/agent-harness.mjs`: ficha automática no `project:new`
|
|
46
|
+
- `test/forja-core.test.js`
|
|
47
|
+
- README/DOC-MAP: documentar o core como ponto de entrada
|
|
48
|
+
|
|
49
|
+
**Fora** (explícito, evita scope creep):
|
|
50
|
+
- Reescrever `dev.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. — continuam como implementação; `dev.mjs` fica como alias legado documentado
|
|
51
|
+
- Embutir a CLI `forja` nos projetos gerados (`lib/generators/`) — fase 2, spec própria
|
|
52
|
+
- Dashboard (`dashboard:*`) — front opcional, fora do processo
|
|
53
|
+
- Gravar auditoria no SQLite (JSONL primeiro; promoção a tabela é evolução futura)
|
|
54
|
+
|
|
55
|
+
## 6. NFRs / restrições
|
|
56
|
+
- Zero dependências novas (Node stdlib apenas).
|
|
57
|
+
- Overhead do roteamento imperceptível (< 100ms além do script alvo).
|
|
58
|
+
- Degradação graciosa: auditoria nunca bloqueia o comando (falha de escrita = warning).
|
|
59
|
+
- Compatibilidade: todos os aliases npm atuais continuam funcionando com a mesma semântica.
|
|
60
|
+
- pt-BR em toda saída de CLI.
|
|
61
|
+
|
|
62
|
+
## 7. Riscos e mitigação
|
|
63
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
64
|
+
|---|---|---|---|
|
|
65
|
+
| Duplo spawn (npm → forja → script) mascarar exit codes | B | A | Propagar `status` do filho sempre; testes de exit code |
|
|
66
|
+
| Registry divergir dos scripts reais | M | M | Teste de integridade (todo alvo existe no disco) |
|
|
67
|
+
| Gate de workspace bloquear fluxo legítimo do framework | M | M | Gate só em comandos de domínio de produto; framework roda sem workspace |
|
|
68
|
+
| JSONL de auditoria crescer sem limite | B | B | Arquivo em `.context/` (gitignored); rotação futura via `memory:compress` |
|
|
69
|
+
|
|
70
|
+
## 8. Métricas de sucesso
|
|
71
|
+
30 dias após o release: (a) 100% dos comandos de processo listados no help do core; (b) `forja-runs.jsonl` presente e usado em pelo menos um review de governance; (c) zero projetos criados sem ficha em `30-projects/`.
|
package/specs/gates/spec.md
CHANGED
|
@@ -1,63 +1,63 @@
|
|
|
1
|
-
# Spec: gates
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-020
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: apk
|
|
6
|
-
- **ADRs relacionadas**: ADR-0023 (doctor como gate), ADR-0024 (release gate), ADR-0029 (project:smoke), ADR-0020 (core/registry)
|
|
7
|
-
|
|
8
|
-
## 1. Problema
|
|
9
|
-
|
|
10
|
-
O framework acumulou uma família de gates — `tools:doctor` (núcleo + coerência de doc + topologia),
|
|
11
|
-
`release:check` (tarball), `project:smoke` (projeto gerado). Cada um guarda uma fronteira, mas estão
|
|
12
|
-
**espalhados**: ninguém lembra de rodar os três antes de um PR, e a governança do Forja — que existe
|
|
13
|
-
justamente para não depender de memória — depende da memória de quem publica para *invocar* os gates.
|
|
14
|
-
É a mesma ironia do ADR-0021, um nível acima: os gates existem, mas rodá-los ainda é disciplina.
|
|
15
|
-
|
|
16
|
-
## 2. Proposta de valor
|
|
17
|
-
|
|
18
|
-
Um comando roda **todos os gates aplicáveis ao framework** e dá **um veredito só**. "A casa está
|
|
19
|
-
coerente?" deixa de ser quatro comandos lembrados e vira um: `forja check:all`.
|
|
20
|
-
|
|
21
|
-
## 3. User stories
|
|
22
|
-
|
|
23
|
-
- **Como** mantenedor, **quero** um comando que rode a bateria inteira antes do PR, **para que** eu
|
|
24
|
-
não esqueça um gate e descubra a quebra no CI (ou depois).
|
|
25
|
-
- **Como** quem publica, **quero** `--full` que inclua os gates caros (tarball, build do gerado),
|
|
26
|
-
**para que** o pré-release seja um comando, não um checklist.
|
|
27
|
-
|
|
28
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
29
|
-
|
|
30
|
-
- [ ] AC-1: `forja check:all` roda os gates de coerência (o catálogo do `tools:doctor`) **+** o
|
|
31
|
-
`project:smoke` (tier barato) e reporta **um veredito** (exit ≠ 0 se qualquer crítico falhar).
|
|
32
|
-
- [ ] AC-2: `--full` adiciona os gates caros: `release:check` (tarball) e `project:smoke --full`
|
|
33
|
-
(instala + builda o backend gerado).
|
|
34
|
-
- [ ] AC-3: A saída **agrupa por gate** (núcleo & coerência / projeto gerado / tarball) e resume o
|
|
35
|
-
pior status ao final — legível, não um despejo.
|
|
36
|
-
- [ ] AC-4: **Compõe os runners existentes** (`health`, `project-smoke`, `release`) — uma máquina,
|
|
37
|
-
zero reimplementação de check. Reusa `worstStatus` de `checks.ts`.
|
|
38
|
-
- [ ] AC-5: Lógica de composição pura e testável (env/runners injetáveis; teste com fakes que
|
|
39
|
-
devolvem status conhecidos, sem gerar projeto de verdade).
|
|
40
|
-
|
|
41
|
-
## 5. Escopo
|
|
42
|
-
|
|
43
|
-
**Dentro**: compor os gates do framework num comando com veredito único e tiers.
|
|
44
|
-
|
|
45
|
-
**Fora** (explícito):
|
|
46
|
-
- `memory:audit` — é gate de **projeto gerado** (precisa de `memory/30-domains` de produto), não do
|
|
47
|
-
framework. Fica de fora do `check:all` do framework; roda no CI do projeto (ADR-0030).
|
|
48
|
-
- Reimplementar qualquer check — este comando só orquestra os catálogos que já existem.
|
|
49
|
-
- Substituir `tools:doctor`/`release:check`/`project:smoke` — eles seguem existindo, focados; o
|
|
50
|
-
`check:all` é o agregador, não o dono.
|
|
51
|
-
|
|
52
|
-
## 6. NFRs / restrições
|
|
53
|
-
|
|
54
|
-
- **Custo consciente**: o tier barato inclui a geração de um projeto (`project:smoke`) — segundos, sem
|
|
55
|
-
rede. O `--full` é minutos (empacota o tarball, `npm install` do backend). O tier certo para o
|
|
56
|
-
momento certo, como no `release:check`.
|
|
57
|
-
- **Compatibilidade**: comando novo; não muda os gates que agrega.
|
|
58
|
-
|
|
59
|
-
## 7. Métricas de sucesso
|
|
60
|
-
|
|
61
|
-
Um `forja check:all` antes do PR pega uma quebra que passaria (um gate esquecido) — a prova de que
|
|
62
|
-
reunir a bateria num comando valeu. A governança do framework deixa de depender de lembrar quais
|
|
63
|
-
gates rodar.
|
|
1
|
+
# Spec: gates
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-020
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **ADRs relacionadas**: ADR-0023 (doctor como gate), ADR-0024 (release gate), ADR-0029 (project:smoke), ADR-0020 (core/registry)
|
|
7
|
+
|
|
8
|
+
## 1. Problema
|
|
9
|
+
|
|
10
|
+
O framework acumulou uma família de gates — `tools:doctor` (núcleo + coerência de doc + topologia),
|
|
11
|
+
`release:check` (tarball), `project:smoke` (projeto gerado). Cada um guarda uma fronteira, mas estão
|
|
12
|
+
**espalhados**: ninguém lembra de rodar os três antes de um PR, e a governança do Forja — que existe
|
|
13
|
+
justamente para não depender de memória — depende da memória de quem publica para *invocar* os gates.
|
|
14
|
+
É a mesma ironia do ADR-0021, um nível acima: os gates existem, mas rodá-los ainda é disciplina.
|
|
15
|
+
|
|
16
|
+
## 2. Proposta de valor
|
|
17
|
+
|
|
18
|
+
Um comando roda **todos os gates aplicáveis ao framework** e dá **um veredito só**. "A casa está
|
|
19
|
+
coerente?" deixa de ser quatro comandos lembrados e vira um: `forja check:all`.
|
|
20
|
+
|
|
21
|
+
## 3. User stories
|
|
22
|
+
|
|
23
|
+
- **Como** mantenedor, **quero** um comando que rode a bateria inteira antes do PR, **para que** eu
|
|
24
|
+
não esqueça um gate e descubra a quebra no CI (ou depois).
|
|
25
|
+
- **Como** quem publica, **quero** `--full` que inclua os gates caros (tarball, build do gerado),
|
|
26
|
+
**para que** o pré-release seja um comando, não um checklist.
|
|
27
|
+
|
|
28
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
29
|
+
|
|
30
|
+
- [ ] AC-1: `forja check:all` roda os gates de coerência (o catálogo do `tools:doctor`) **+** o
|
|
31
|
+
`project:smoke` (tier barato) e reporta **um veredito** (exit ≠ 0 se qualquer crítico falhar).
|
|
32
|
+
- [ ] AC-2: `--full` adiciona os gates caros: `release:check` (tarball) e `project:smoke --full`
|
|
33
|
+
(instala + builda o backend gerado).
|
|
34
|
+
- [ ] AC-3: A saída **agrupa por gate** (núcleo & coerência / projeto gerado / tarball) e resume o
|
|
35
|
+
pior status ao final — legível, não um despejo.
|
|
36
|
+
- [ ] AC-4: **Compõe os runners existentes** (`health`, `project-smoke`, `release`) — uma máquina,
|
|
37
|
+
zero reimplementação de check. Reusa `worstStatus` de `checks.ts`.
|
|
38
|
+
- [ ] AC-5: Lógica de composição pura e testável (env/runners injetáveis; teste com fakes que
|
|
39
|
+
devolvem status conhecidos, sem gerar projeto de verdade).
|
|
40
|
+
|
|
41
|
+
## 5. Escopo
|
|
42
|
+
|
|
43
|
+
**Dentro**: compor os gates do framework num comando com veredito único e tiers.
|
|
44
|
+
|
|
45
|
+
**Fora** (explícito):
|
|
46
|
+
- `memory:audit` — é gate de **projeto gerado** (precisa de `memory/30-domains` de produto), não do
|
|
47
|
+
framework. Fica de fora do `check:all` do framework; roda no CI do projeto (ADR-0030).
|
|
48
|
+
- Reimplementar qualquer check — este comando só orquestra os catálogos que já existem.
|
|
49
|
+
- Substituir `tools:doctor`/`release:check`/`project:smoke` — eles seguem existindo, focados; o
|
|
50
|
+
`check:all` é o agregador, não o dono.
|
|
51
|
+
|
|
52
|
+
## 6. NFRs / restrições
|
|
53
|
+
|
|
54
|
+
- **Custo consciente**: o tier barato inclui a geração de um projeto (`project:smoke`) — segundos, sem
|
|
55
|
+
rede. O `--full` é minutos (empacota o tarball, `npm install` do backend). O tier certo para o
|
|
56
|
+
momento certo, como no `release:check`.
|
|
57
|
+
- **Compatibilidade**: comando novo; não muda os gates que agrega.
|
|
58
|
+
|
|
59
|
+
## 7. Métricas de sucesso
|
|
60
|
+
|
|
61
|
+
Um `forja check:all` antes do PR pega uma quebra que passaria (um gate esquecido) — a prova de que
|
|
62
|
+
reunir a bateria num comando valeu. A governança do framework deixa de depender de lembrar quais
|
|
63
|
+
gates rodar.
|