forjajs 2.0.2 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -317
- package/README.pt-BR.md +345 -323
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.d.ts +1 -0
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -140
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,74 +1,74 @@
|
|
|
1
|
-
# Spec: reestruturacao-forja-v2
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-028
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: apk
|
|
6
|
-
- **Criado em**: 2026-07-01
|
|
7
|
-
- **Sprint alvo**: <S?>
|
|
8
|
-
- **ADRs relacionadas**: ADR-0019 (workspace separado), ADR-0020 (core CLI única)
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
O Forja hoje mistura o **framework** (motor) com os **produtos gerados** dentro do mesmo repositório. A pasta `projects/` é gitignored, a memória universal dos produtos (`memory/30-projects/`, `.memory/sqlite/universal.db`) fica no repo do framework e não há um "canto fixo" claro onde os projetos vão parar. Isso causa:
|
|
12
|
-
- Poluição do worktree do framework com dados de produto.
|
|
13
|
-
- Dificuldade de versionar/backupear produtos separadamente.
|
|
14
|
-
- Ambiguidade sobre onde `init-project` cria o projeto.
|
|
15
|
-
- Risco de apagar memória/specs de produto ao manipular o repo do framework.
|
|
16
|
-
|
|
17
|
-
## 2. Proposta de valor
|
|
18
|
-
Separar o framework Forja do workspace de produção em um diretório fixo (`~/forja-workspace`), tornando o Forja um motor reutilizável que orquestra projetos em um "canto fixo" isolado, com memória, specs e handoffs próprios.
|
|
19
|
-
|
|
20
|
-
## 3. User stories
|
|
21
|
-
- **Como** operador do Forja, **quero** que novos projetos sejam criados em `~/forja-workspace/projects/<nome>`, **para que** o repo do framework permaneça limpo.
|
|
22
|
-
- **Como** desenvolvedor, **quero** que a memória universal dos projetos fique no workspace, **para que** eu possa versionar o framework sem expor dados de produto.
|
|
23
|
-
- **Como** arquiteto, **quero** um comando `forja workspace:init` e `forja project:new`, **para que** o harness GSD seja operado de forma unificada.
|
|
24
|
-
|
|
25
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
26
|
-
|
|
27
|
-
> Verificados em 2026-07-09. A spec estava `approved` com o trabalho já concluído — os checkboxes
|
|
28
|
-
> nunca foram marcados. Auditoria confirmou os 10 critérios contra o código.
|
|
29
|
-
|
|
30
|
-
- [x] AC-1: Workspace padrão `~/forja-workspace` é criado e configurado automaticamente na primeira operação.
|
|
31
|
-
- [x] AC-2: `init-project` cria projetos obrigatoriamente dentro de `~/forja-workspace/projects/<nome>` (não mais dentro do repo do framework).
|
|
32
|
-
- [x] AC-3: Memória universal (SQLite) e `memory/30-projects/` dos produtos são movidos/criados no workspace, não no repo do framework.
|
|
33
|
-
- [x] AC-4: Scripts `sync:universal`, `query:universal`, `context:smart` e `build-smart-context` passam a operar sobre o workspace. — `query-universal-memory.js` não referencia o workspace diretamente; delega a `getDbPath()` de `memory-schema.mjs`, que resolve para `~/forja-workspace/memory/sqlite/universal.db`.
|
|
34
|
-
- [x] AC-5: Novo módulo `lib/workspace.mjs` centraliza a descoberta do workspace (env `FORJA_WORKSPACE` > `.forjarc.json` > default `~/forja-workspace`).
|
|
35
|
-
- [x] AC-6: ~~`npm run dev -- workspace:init`~~ → **interface mudou** para `node bin/forja.mjs workspace:init` (ADR-0020, core CLI única). Comando presente no registry.
|
|
36
|
-
- [x] AC-7: ~~`npm run dev -- project:new <nome>`~~ → **interface mudou** para `node bin/forja.mjs project:new`. Presente no registry, junto de `project:list` e `workspace:project:check`.
|
|
37
|
-
- [x] AC-8: AGENTS.md, README.md, .gitignore, docs/ e ADRs são atualizados para refletir a separação framework/workspace. — ADR-0019 documenta a decisão.
|
|
38
|
-
- [x] AC-9: `project:check` continua passando no framework e passa a aceitar projeto alvo pelo path absoluto/relativo ao workspace.
|
|
39
|
-
- [x] AC-10: Teste de fumaça: criar um projeto de exemplo no workspace e rodar `project:check` sobre ele. — `~/forja-workspace/projects/forja-smoke-test`.
|
|
40
|
-
|
|
41
|
-
## 5. Escopo
|
|
42
|
-
**Dentro**:
|
|
43
|
-
- Definição do workspace `~/forja-workspace` como canto fixo.
|
|
44
|
-
- Refatoração de `init-project.js`, `create-memory-nest-kit.js` e scripts de memória para usar workspace.
|
|
45
|
-
- Criação de `lib/workspace.mjs` (resolução de caminhos).
|
|
46
|
-
- Novos comandos no harness: `workspace:init`, `project:new`, `project:list`.
|
|
47
|
-
- Atualização de documentação (README, AGENTS.md, docs/structure.md, docs/init-project.md).
|
|
48
|
-
- Criação de ADR-0019 (workspace separado).
|
|
49
|
-
- Ajuste de `.gitignore` para ignorar definitivamente `projects/` local e garantir que o workspace não entre no repo.
|
|
50
|
-
|
|
51
|
-
**Fora** (explícito, evita scope creep):
|
|
52
|
-
- Não reescrever o dashboard web agora (apenas ajustar rotas se necessário).
|
|
53
|
-
- Não migrar specs de produto antigas (apenas definir a nova convenção).
|
|
54
|
-
- Não alterar a pipeline SDD/GSD em si (apenas onde os artefatos ficam).
|
|
55
|
-
- Não reinstalar dependências do dashboard/backend.
|
|
56
|
-
|
|
57
|
-
## 6. NFRs / restrições
|
|
58
|
-
- Compatibilidade: não quebrar `npm run project:check` no framework.
|
|
59
|
-
- Segurança: dados de produto nunca devem ser commitados acidentalmente no repo do framework.
|
|
60
|
-
- Portabilidade: workspace configurável via `FORJA_WORKSPACE` ou `.forjarc.json` no home.
|
|
61
|
-
- CLI-first: toda operação deve ser possível por comando.
|
|
62
|
-
|
|
63
|
-
## 7. Riscos e mitigação
|
|
64
|
-
| Risco | Probabilidade | Impacto | Mitigação |
|
|
65
|
-
|---|---|---|---|
|
|
66
|
-
| Perda de dados de projetos antigos em `projects/` | M | A | Não apagar `projects/` existente; adicionar mensagem de migração manual. |
|
|
67
|
-
| Scripts quebrarem por path hardcoded | A | M | Criar `lib/workspace.mjs` e auditar todos os paths. |
|
|
68
|
-
| Usuário confundir repo do framework com workspace | M | M | Documentar claramente; commandos mostram o workspace ativo. |
|
|
69
|
-
| universal.db existente no repo ter dados úteis | B | A | Backup opcional; novo DB é criado no workspace. |
|
|
70
|
-
|
|
71
|
-
## 8. Métricas de sucesso
|
|
72
|
-
- 100% dos novos projetos criados no workspace em 30 dias.
|
|
73
|
-
- Zero commits acidentais de `projects/` ou `.memory/` no repo do framework.
|
|
74
|
-
- `project:check` passando tanto no framework quanto em projeto do workspace.
|
|
1
|
+
# Spec: reestruturacao-forja-v2
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-028
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-07-01
|
|
7
|
+
- **Sprint alvo**: <S?>
|
|
8
|
+
- **ADRs relacionadas**: ADR-0019 (workspace separado), ADR-0020 (core CLI única)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O Forja hoje mistura o **framework** (motor) com os **produtos gerados** dentro do mesmo repositório. A pasta `projects/` é gitignored, a memória universal dos produtos (`memory/30-projects/`, `.memory/sqlite/universal.db`) fica no repo do framework e não há um "canto fixo" claro onde os projetos vão parar. Isso causa:
|
|
12
|
+
- Poluição do worktree do framework com dados de produto.
|
|
13
|
+
- Dificuldade de versionar/backupear produtos separadamente.
|
|
14
|
+
- Ambiguidade sobre onde `init-project` cria o projeto.
|
|
15
|
+
- Risco de apagar memória/specs de produto ao manipular o repo do framework.
|
|
16
|
+
|
|
17
|
+
## 2. Proposta de valor
|
|
18
|
+
Separar o framework Forja do workspace de produção em um diretório fixo (`~/forja-workspace`), tornando o Forja um motor reutilizável que orquestra projetos em um "canto fixo" isolado, com memória, specs e handoffs próprios.
|
|
19
|
+
|
|
20
|
+
## 3. User stories
|
|
21
|
+
- **Como** operador do Forja, **quero** que novos projetos sejam criados em `~/forja-workspace/projects/<nome>`, **para que** o repo do framework permaneça limpo.
|
|
22
|
+
- **Como** desenvolvedor, **quero** que a memória universal dos projetos fique no workspace, **para que** eu possa versionar o framework sem expor dados de produto.
|
|
23
|
+
- **Como** arquiteto, **quero** um comando `forja workspace:init` e `forja project:new`, **para que** o harness GSD seja operado de forma unificada.
|
|
24
|
+
|
|
25
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
26
|
+
|
|
27
|
+
> Verificados em 2026-07-09. A spec estava `approved` com o trabalho já concluído — os checkboxes
|
|
28
|
+
> nunca foram marcados. Auditoria confirmou os 10 critérios contra o código.
|
|
29
|
+
|
|
30
|
+
- [x] AC-1: Workspace padrão `~/forja-workspace` é criado e configurado automaticamente na primeira operação.
|
|
31
|
+
- [x] AC-2: `init-project` cria projetos obrigatoriamente dentro de `~/forja-workspace/projects/<nome>` (não mais dentro do repo do framework).
|
|
32
|
+
- [x] AC-3: Memória universal (SQLite) e `memory/30-projects/` dos produtos são movidos/criados no workspace, não no repo do framework.
|
|
33
|
+
- [x] AC-4: Scripts `sync:universal`, `query:universal`, `context:smart` e `build-smart-context` passam a operar sobre o workspace. — `query-universal-memory.js` não referencia o workspace diretamente; delega a `getDbPath()` de `memory-schema.mjs`, que resolve para `~/forja-workspace/memory/sqlite/universal.db`.
|
|
34
|
+
- [x] AC-5: Novo módulo `lib/workspace.mjs` centraliza a descoberta do workspace (env `FORJA_WORKSPACE` > `.forjarc.json` > default `~/forja-workspace`).
|
|
35
|
+
- [x] AC-6: ~~`npm run dev -- workspace:init`~~ → **interface mudou** para `node bin/forja.mjs workspace:init` (ADR-0020, core CLI única). Comando presente no registry.
|
|
36
|
+
- [x] AC-7: ~~`npm run dev -- project:new <nome>`~~ → **interface mudou** para `node bin/forja.mjs project:new`. Presente no registry, junto de `project:list` e `workspace:project:check`.
|
|
37
|
+
- [x] AC-8: AGENTS.md, README.md, .gitignore, docs/ e ADRs são atualizados para refletir a separação framework/workspace. — ADR-0019 documenta a decisão.
|
|
38
|
+
- [x] AC-9: `project:check` continua passando no framework e passa a aceitar projeto alvo pelo path absoluto/relativo ao workspace.
|
|
39
|
+
- [x] AC-10: Teste de fumaça: criar um projeto de exemplo no workspace e rodar `project:check` sobre ele. — `~/forja-workspace/projects/forja-smoke-test`.
|
|
40
|
+
|
|
41
|
+
## 5. Escopo
|
|
42
|
+
**Dentro**:
|
|
43
|
+
- Definição do workspace `~/forja-workspace` como canto fixo.
|
|
44
|
+
- Refatoração de `init-project.js`, `create-memory-nest-kit.js` e scripts de memória para usar workspace.
|
|
45
|
+
- Criação de `lib/workspace.mjs` (resolução de caminhos).
|
|
46
|
+
- Novos comandos no harness: `workspace:init`, `project:new`, `project:list`.
|
|
47
|
+
- Atualização de documentação (README, AGENTS.md, docs/structure.md, docs/init-project.md).
|
|
48
|
+
- Criação de ADR-0019 (workspace separado).
|
|
49
|
+
- Ajuste de `.gitignore` para ignorar definitivamente `projects/` local e garantir que o workspace não entre no repo.
|
|
50
|
+
|
|
51
|
+
**Fora** (explícito, evita scope creep):
|
|
52
|
+
- Não reescrever o dashboard web agora (apenas ajustar rotas se necessário).
|
|
53
|
+
- Não migrar specs de produto antigas (apenas definir a nova convenção).
|
|
54
|
+
- Não alterar a pipeline SDD/GSD em si (apenas onde os artefatos ficam).
|
|
55
|
+
- Não reinstalar dependências do dashboard/backend.
|
|
56
|
+
|
|
57
|
+
## 6. NFRs / restrições
|
|
58
|
+
- Compatibilidade: não quebrar `npm run project:check` no framework.
|
|
59
|
+
- Segurança: dados de produto nunca devem ser commitados acidentalmente no repo do framework.
|
|
60
|
+
- Portabilidade: workspace configurável via `FORJA_WORKSPACE` ou `.forjarc.json` no home.
|
|
61
|
+
- CLI-first: toda operação deve ser possível por comando.
|
|
62
|
+
|
|
63
|
+
## 7. Riscos e mitigação
|
|
64
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
65
|
+
|---|---|---|---|
|
|
66
|
+
| Perda de dados de projetos antigos em `projects/` | M | A | Não apagar `projects/` existente; adicionar mensagem de migração manual. |
|
|
67
|
+
| Scripts quebrarem por path hardcoded | A | M | Criar `lib/workspace.mjs` e auditar todos os paths. |
|
|
68
|
+
| Usuário confundir repo do framework com workspace | M | M | Documentar claramente; commandos mostram o workspace ativo. |
|
|
69
|
+
| universal.db existente no repo ter dados úteis | B | A | Backup opcional; novo DB é criado no workspace. |
|
|
70
|
+
|
|
71
|
+
## 8. Métricas de sucesso
|
|
72
|
+
- 100% dos novos projetos criados no workspace em 30 dias.
|
|
73
|
+
- Zero commits acidentais de `projects/` ou `.memory/` no repo do framework.
|
|
74
|
+
- `project:check` passando tanto no framework quanto em projeto do workspace.
|
|
@@ -1,113 +1,113 @@
|
|
|
1
|
-
# Tasks: reestruturacao-forja-v2
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: done
|
|
6
|
-
- **Criado em**: 2026-07-01
|
|
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`, ... Sequência reflete ordem de execução padrão (pode ser paralelizada quando indicado).
|
|
11
|
-
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
## T1 — Criar lib/workspace.mjs
|
|
15
|
-
- **Owner**: worker
|
|
16
|
-
- **Estimativa**: P
|
|
17
|
-
- **Depende de**: —
|
|
18
|
-
- **Paths**: `lib/workspace.mjs`
|
|
19
|
-
- **Done quando**:
|
|
20
|
-
- [ ] Resolve workspace via `FORJA_WORKSPACE` > `~/.forjarc.json` > default `~/forja-workspace`.
|
|
21
|
-
- [ ] Exporta helpers: `getWorkspaceRoot`, `getProjectsDir`, `getWorkspaceMemoryDir`, `getWorkspaceDbPath`, `resolveProject`, `initWorkspace`, `getActiveWorkspaceInfo()`.
|
|
22
|
-
- [ ] `initWorkspace()` cria `projects/`, `memory/`, `memory/sqlite/`, `memory/30-projects/`, `specs/`, `.context/`, `.forjarc.json`.
|
|
23
|
-
- [ ] Teste básico: `node -e "import('./lib/workspace.mjs').then(w=>console.log(w.getWorkspaceRoot()))"`.
|
|
24
|
-
|
|
25
|
-
## T2 — Atualizar init-project.js para workspace fixo
|
|
26
|
-
- **Owner**: worker
|
|
27
|
-
- **Estimativa**: M
|
|
28
|
-
- **Depende de**: T1
|
|
29
|
-
- **Paths**: `bin/init-project.js`
|
|
30
|
-
- **Done quando**:
|
|
31
|
-
- [ ] Sempre resolve projeto para `~/forja-workspace/projects/<nome>` (rejeita path relativo/externo).
|
|
32
|
-
- [ ] Remove ambiguidade de `projects/` dentro do repo do framework.
|
|
33
|
-
- [ ] Registra projeto em `~/forja-workspace/memory/30-projects/<nome>.md`.
|
|
34
|
-
- [ ] Copia instruções, emite harness e cria backend como hoje.
|
|
35
|
-
|
|
36
|
-
## T3 — Atualizar scripts de memória universal para workspace
|
|
37
|
-
- **Owner**: worker
|
|
38
|
-
- **Estimativa**: M
|
|
39
|
-
- **Depende de**: T1
|
|
40
|
-
- **Paths**: `scripts/sync-universal-memory.js`, `scripts/query-universal-memory.js`, `scripts/build-smart-context.js`
|
|
41
|
-
- **Done quando**:
|
|
42
|
-
- [ ] Todos leem/escrevem SQLite em `~/forja-workspace/memory/sqlite/universal.db`.
|
|
43
|
-
- [ ] `build-smart-context` gera `.context/smart-context.md` dentro do projeto no workspace.
|
|
44
|
-
- [ ] `sync-universal-memory` indexa `~/forja-workspace/memory/30-projects/` e `~/forja-workspace/projects/<nome>/memory/`.
|
|
45
|
-
|
|
46
|
-
## T4 — Atualizar check-standards.js
|
|
47
|
-
- **Owner**: worker
|
|
48
|
-
- **Estimativa**: P
|
|
49
|
-
- **Depende de**: T2
|
|
50
|
-
- **Paths**: `scripts/check-standards.js`
|
|
51
|
-
- **Done quando**:
|
|
52
|
-
- [ ] Aceita `npm run project:check` no framework (comportamento atual).
|
|
53
|
-
- [ ] Aceita `npm run project:check -- <nome>` resolvendo `~/forja-workspace/projects/<nome>`.
|
|
54
|
-
- [ ] Mensagem clara quando projeto não existe no workspace.
|
|
55
|
-
|
|
56
|
-
## T5 — Adicionar comandos workspace:* e project:* ao harness
|
|
57
|
-
- **Owner**: worker
|
|
58
|
-
- **Estimativa**: M
|
|
59
|
-
- **Depende de**: T1, T2
|
|
60
|
-
- **Paths**: `scripts/agent-harness.mjs`, `package.json`
|
|
61
|
-
- **Done quando**:
|
|
62
|
-
- [ ] `workspace:init` cria estrutura do workspace.
|
|
63
|
-
- [ ] `project:new <nome>` encapsula init-project.js.
|
|
64
|
-
- [ ] `project:list` lista projetos em `~/forja-workspace/projects/`.
|
|
65
|
-
- [ ] `project:check <nome>` valida padrões no projeto do workspace.
|
|
66
|
-
- [ ] Scripts mapeados em `package.json`.
|
|
67
|
-
|
|
68
|
-
## T6 — Ajustar .gitignore e garantir separação
|
|
69
|
-
- **Owner**: worker
|
|
70
|
-
- **Estimativa**: P
|
|
71
|
-
- **Depende de**: T2
|
|
72
|
-
- **Paths**: `.gitignore`
|
|
73
|
-
- **Done quando**:
|
|
74
|
-
- [ ] `projects/` e `projects/**` permanecem ignorados.
|
|
75
|
-
- [ ] Adiciona comentário explicando que projetos de produto vivem no workspace externo.
|
|
76
|
-
- [ ] Garante que `~/forja-workspace` nunca seja trackeado.
|
|
77
|
-
|
|
78
|
-
## T7 — Atualizar documentação
|
|
79
|
-
- **Owner**: worker
|
|
80
|
-
- **Estimativa**: M
|
|
81
|
-
- **Depende de**: T5
|
|
82
|
-
- **Paths**: `README.md`, `AGENTS.md`, `docs/structure.md`, `docs/init-project.md`, `docs/manual-operacional-cli-sdd-gsd.md`
|
|
83
|
-
- **Done quando**:
|
|
84
|
-
- [ ] README explica separação framework/workspace e comando `workspace:init`.
|
|
85
|
-
- [ ] AGENTS.md menciona workspace como canto fixo de produtos.
|
|
86
|
-
- [ ] docs/init-project.md atualizado com `project:new`.
|
|
87
|
-
- [ ] docs/structure.md reflete nova topologia.
|
|
88
|
-
|
|
89
|
-
## T8 — Criar ADR-0019
|
|
90
|
-
- **Owner**: sdd-architect
|
|
91
|
-
- **Estimativa**: P
|
|
92
|
-
- **Depende de**: T1
|
|
93
|
-
- **Paths**: `memory/90-decisions/0019-workspace-separado.md`
|
|
94
|
-
- **Done quando**:
|
|
95
|
-
- [ ] Documenta contexto, decisão, consequências e alternativas rejeitadas.
|
|
96
|
-
- [ ] Referenciado no plan.md.
|
|
97
|
-
|
|
98
|
-
## T9 — Teste de fumaça
|
|
99
|
-
- **Owner**: governance
|
|
100
|
-
- **Estimativa**: P
|
|
101
|
-
- **Depende de**: T2, T3, T4, T5
|
|
102
|
-
- **Paths**: `~/forja-workspace/projects/forja-smoke-test`
|
|
103
|
-
- **Done quando**:
|
|
104
|
-
- [ ] `npm run dev -- workspace:init` executa sem erro.
|
|
105
|
-
- [ ] `npm run dev -- project:new forja-smoke-test --ai claude` cria projeto no workspace.
|
|
106
|
-
- [ ] `npm run project:check -- forja-smoke-test` passa ≥ 70%.
|
|
107
|
-
- [ ] `npm run project:check` no framework continua 100%.
|
|
108
|
-
- [ ] `npm run spec:check` passa.
|
|
109
|
-
|
|
110
|
-
---
|
|
111
|
-
|
|
112
|
-
## Handoffs entre agentes
|
|
113
|
-
Se este conjunto de tasks atravessa papéis (Product → SDD Architect → Worker → Governance), registre handoff via `scripts/append-handoff.mjs` ou tabela `handoffs` do `universal.db` (ADR-0005).
|
|
1
|
+
# Tasks: reestruturacao-forja-v2
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-07-01
|
|
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`, ... Sequência reflete ordem de execução padrão (pode ser paralelizada quando indicado).
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## T1 — Criar lib/workspace.mjs
|
|
15
|
+
- **Owner**: worker
|
|
16
|
+
- **Estimativa**: P
|
|
17
|
+
- **Depende de**: —
|
|
18
|
+
- **Paths**: `lib/workspace.mjs`
|
|
19
|
+
- **Done quando**:
|
|
20
|
+
- [ ] Resolve workspace via `FORJA_WORKSPACE` > `~/.forjarc.json` > default `~/forja-workspace`.
|
|
21
|
+
- [ ] Exporta helpers: `getWorkspaceRoot`, `getProjectsDir`, `getWorkspaceMemoryDir`, `getWorkspaceDbPath`, `resolveProject`, `initWorkspace`, `getActiveWorkspaceInfo()`.
|
|
22
|
+
- [ ] `initWorkspace()` cria `projects/`, `memory/`, `memory/sqlite/`, `memory/30-projects/`, `specs/`, `.context/`, `.forjarc.json`.
|
|
23
|
+
- [ ] Teste básico: `node -e "import('./lib/workspace.mjs').then(w=>console.log(w.getWorkspaceRoot()))"`.
|
|
24
|
+
|
|
25
|
+
## T2 — Atualizar init-project.js para workspace fixo
|
|
26
|
+
- **Owner**: worker
|
|
27
|
+
- **Estimativa**: M
|
|
28
|
+
- **Depende de**: T1
|
|
29
|
+
- **Paths**: `bin/init-project.js`
|
|
30
|
+
- **Done quando**:
|
|
31
|
+
- [ ] Sempre resolve projeto para `~/forja-workspace/projects/<nome>` (rejeita path relativo/externo).
|
|
32
|
+
- [ ] Remove ambiguidade de `projects/` dentro do repo do framework.
|
|
33
|
+
- [ ] Registra projeto em `~/forja-workspace/memory/30-projects/<nome>.md`.
|
|
34
|
+
- [ ] Copia instruções, emite harness e cria backend como hoje.
|
|
35
|
+
|
|
36
|
+
## T3 — Atualizar scripts de memória universal para workspace
|
|
37
|
+
- **Owner**: worker
|
|
38
|
+
- **Estimativa**: M
|
|
39
|
+
- **Depende de**: T1
|
|
40
|
+
- **Paths**: `scripts/sync-universal-memory.js`, `scripts/query-universal-memory.js`, `scripts/build-smart-context.js`
|
|
41
|
+
- **Done quando**:
|
|
42
|
+
- [ ] Todos leem/escrevem SQLite em `~/forja-workspace/memory/sqlite/universal.db`.
|
|
43
|
+
- [ ] `build-smart-context` gera `.context/smart-context.md` dentro do projeto no workspace.
|
|
44
|
+
- [ ] `sync-universal-memory` indexa `~/forja-workspace/memory/30-projects/` e `~/forja-workspace/projects/<nome>/memory/`.
|
|
45
|
+
|
|
46
|
+
## T4 — Atualizar check-standards.js
|
|
47
|
+
- **Owner**: worker
|
|
48
|
+
- **Estimativa**: P
|
|
49
|
+
- **Depende de**: T2
|
|
50
|
+
- **Paths**: `scripts/check-standards.js`
|
|
51
|
+
- **Done quando**:
|
|
52
|
+
- [ ] Aceita `npm run project:check` no framework (comportamento atual).
|
|
53
|
+
- [ ] Aceita `npm run project:check -- <nome>` resolvendo `~/forja-workspace/projects/<nome>`.
|
|
54
|
+
- [ ] Mensagem clara quando projeto não existe no workspace.
|
|
55
|
+
|
|
56
|
+
## T5 — Adicionar comandos workspace:* e project:* ao harness
|
|
57
|
+
- **Owner**: worker
|
|
58
|
+
- **Estimativa**: M
|
|
59
|
+
- **Depende de**: T1, T2
|
|
60
|
+
- **Paths**: `scripts/agent-harness.mjs`, `package.json`
|
|
61
|
+
- **Done quando**:
|
|
62
|
+
- [ ] `workspace:init` cria estrutura do workspace.
|
|
63
|
+
- [ ] `project:new <nome>` encapsula init-project.js.
|
|
64
|
+
- [ ] `project:list` lista projetos em `~/forja-workspace/projects/`.
|
|
65
|
+
- [ ] `project:check <nome>` valida padrões no projeto do workspace.
|
|
66
|
+
- [ ] Scripts mapeados em `package.json`.
|
|
67
|
+
|
|
68
|
+
## T6 — Ajustar .gitignore e garantir separação
|
|
69
|
+
- **Owner**: worker
|
|
70
|
+
- **Estimativa**: P
|
|
71
|
+
- **Depende de**: T2
|
|
72
|
+
- **Paths**: `.gitignore`
|
|
73
|
+
- **Done quando**:
|
|
74
|
+
- [ ] `projects/` e `projects/**` permanecem ignorados.
|
|
75
|
+
- [ ] Adiciona comentário explicando que projetos de produto vivem no workspace externo.
|
|
76
|
+
- [ ] Garante que `~/forja-workspace` nunca seja trackeado.
|
|
77
|
+
|
|
78
|
+
## T7 — Atualizar documentação
|
|
79
|
+
- **Owner**: worker
|
|
80
|
+
- **Estimativa**: M
|
|
81
|
+
- **Depende de**: T5
|
|
82
|
+
- **Paths**: `README.md`, `AGENTS.md`, `docs/structure.md`, `docs/init-project.md`, `docs/manual-operacional-cli-sdd-gsd.md`
|
|
83
|
+
- **Done quando**:
|
|
84
|
+
- [ ] README explica separação framework/workspace e comando `workspace:init`.
|
|
85
|
+
- [ ] AGENTS.md menciona workspace como canto fixo de produtos.
|
|
86
|
+
- [ ] docs/init-project.md atualizado com `project:new`.
|
|
87
|
+
- [ ] docs/structure.md reflete nova topologia.
|
|
88
|
+
|
|
89
|
+
## T8 — Criar ADR-0019
|
|
90
|
+
- **Owner**: sdd-architect
|
|
91
|
+
- **Estimativa**: P
|
|
92
|
+
- **Depende de**: T1
|
|
93
|
+
- **Paths**: `memory/90-decisions/0019-workspace-separado.md`
|
|
94
|
+
- **Done quando**:
|
|
95
|
+
- [ ] Documenta contexto, decisão, consequências e alternativas rejeitadas.
|
|
96
|
+
- [ ] Referenciado no plan.md.
|
|
97
|
+
|
|
98
|
+
## T9 — Teste de fumaça
|
|
99
|
+
- **Owner**: governance
|
|
100
|
+
- **Estimativa**: P
|
|
101
|
+
- **Depende de**: T2, T3, T4, T5
|
|
102
|
+
- **Paths**: `~/forja-workspace/projects/forja-smoke-test`
|
|
103
|
+
- **Done quando**:
|
|
104
|
+
- [ ] `npm run dev -- workspace:init` executa sem erro.
|
|
105
|
+
- [ ] `npm run dev -- project:new forja-smoke-test --ai claude` cria projeto no workspace.
|
|
106
|
+
- [ ] `npm run project:check -- forja-smoke-test` passa ≥ 70%.
|
|
107
|
+
- [ ] `npm run project:check` no framework continua 100%.
|
|
108
|
+
- [ ] `npm run spec:check` passa.
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## Handoffs entre agentes
|
|
113
|
+
Se este conjunto de tasks atravessa papéis (Product → SDD Architect → Worker → Governance), registre handoff via `scripts/append-handoff.mjs` ou tabela `handoffs` do `universal.db` (ADR-0005).
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# Plan: release-auditor-health
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Criado em**: 2026-08-17
|
|
6
|
+
|
|
7
|
+
> Como vamos construir o que a spec define. Sem código aqui, só estrutura e decisões.
|
|
8
|
+
|
|
9
|
+
## 1. Abordagem técnica
|
|
10
|
+
|
|
11
|
+
**Compor, não reimplementar.** O Release Auditor continuará sendo uma persona de julgamento, sem
|
|
12
|
+
probes próprios. Seu procedimento passa a executar `tools:doctor`, que já apresenta
|
|
13
|
+
`lib/core/health.ts`, e só então `release:check --publish`, que preserva o contrato estrito de
|
|
14
|
+
pré-publicação. Um teste lê o prompt como contrato e garante presença, ordem e flags dos comandos.
|
|
15
|
+
|
|
16
|
+
## 2. Módulos afetados
|
|
17
|
+
|
|
18
|
+
| Caminho | Mudança | Risco |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| `.claude/agents/release-auditor.md` | editar procedimento, checks e regras de julgamento | B |
|
|
21
|
+
| `AGENTS.md` | alinhar descrição canônica do papel aos dois gates | B |
|
|
22
|
+
| `test/release-auditor.test.js` | criar teste do contrato do procedimento | B |
|
|
23
|
+
| `memory/40-delivery/current-sprint.md` | substituir candidatos obsoletos pelo item em execução | B |
|
|
24
|
+
|
|
25
|
+
Nenhum módulo executável de health, release ou registry será alterado.
|
|
26
|
+
|
|
27
|
+
## 3. Diagrama de fluxo
|
|
28
|
+
|
|
29
|
+
```text
|
|
30
|
+
Release Auditor
|
|
31
|
+
|
|
|
32
|
+
+--> npm run tools:doctor
|
|
33
|
+
| |
|
|
34
|
+
| +--> critical fail: REPROVADO, parar e reportar fix
|
|
35
|
+
| `--> ok/warn: continuar
|
|
36
|
+
|
|
|
37
|
+
`--> npm run release:check -- --publish
|
|
38
|
+
|
|
|
39
|
+
+--> fail: REPROVADO
|
|
40
|
+
`--> ok: parecer, ressalvas e validade perecível
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## 4. Contratos
|
|
44
|
+
|
|
45
|
+
O contrato público continua sendo CLI existente:
|
|
46
|
+
|
|
47
|
+
```text
|
|
48
|
+
npm run tools:doctor
|
|
49
|
+
npm run release:check -- --publish
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
O primeiro comando deve aparecer antes do segundo. `--publish` é obrigatório. Avisos são lidos e
|
|
53
|
+
relatados, mas apenas falhas críticas bloqueiam. O agente nunca executa `npm publish`.
|
|
54
|
+
|
|
55
|
+
## 5. Decisões e alternativas
|
|
56
|
+
|
|
57
|
+
**D1: Consumir health por `tools:doctor`.** Alternativa rejeitada: importar `runChecks()` num script
|
|
58
|
+
novo para o agente, pois criaria outra superfície executável sem necessidade.
|
|
59
|
+
|
|
60
|
+
**D2: Preservar dois comandos explícitos.** Alternativa rejeitada: trocar por `check:all --full`,
|
|
61
|
+
pois hoje o agregador chama `runReleaseChecks({})` sem `publish: true`; árvore suja seria aviso.
|
|
62
|
+
|
|
63
|
+
**D3: Testar o prompt como contrato.** O teste verifica índices dos comandos no texto, a flag
|
|
64
|
+
`--publish` e a proibição de `npm publish`. Alternativa rejeitada: testar só presença por grep, que
|
|
65
|
+
não detectaria ordem invertida nem enfraquecimento da flag.
|
|
66
|
+
|
|
67
|
+
Nenhuma decisão é estrutural ou irreversível. ADR novo não é necessário; o plano aplica ADR-0023 e
|
|
68
|
+
ADR-0024.
|
|
69
|
+
|
|
70
|
+
## 6. Dependências
|
|
71
|
+
|
|
72
|
+
- **Specs**: SPEC-009/ADR-0023 e SPEC-010/ADR-0024, ambas concluídas.
|
|
73
|
+
- **Pacotes npm**: nenhum.
|
|
74
|
+
- **Migrações de dados/memory**: nenhuma.
|
|
75
|
+
|
|
76
|
+
## 7. Rollout
|
|
77
|
+
|
|
78
|
+
- [x] Feature flag necessária? Não, é procedimento interno de governança.
|
|
79
|
+
- [x] Migração de dados existentes? Não.
|
|
80
|
+
- [x] Doc/persona impactada? Release Auditor e sua descrição canônica em `AGENTS.md`.
|
|
81
|
+
- [x] Rodar teste direcionado, `types:check`, `project:check`, `tools:doctor` e `spec:check`.
|
|
82
|
+
- [x] Registrar handoff para Governance após implementação.
|
|
83
|
+
|
|
84
|
+
## 8. Sinais de fracasso
|
|
85
|
+
|
|
86
|
+
- A solução introduz probe ou lógica de severidade fora de `lib/core/health.ts`.
|
|
87
|
+
- `release:check --publish` deixa de ser obrigatório ou é substituído pelo agregador não estrito.
|
|
88
|
+
- O teste fica acoplado à redação completa do prompt, em vez de somente ao contrato operacional.
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# Spec: release-auditor-health
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-022
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-08-17
|
|
7
|
+
- **Sprint alvo**: framework-root
|
|
8
|
+
- **ADRs relacionadas**: [ADR-0023](../../memory/90-decisions/0023-doctor-como-gate-do-nucleo.md) (saúde compartilhada), [ADR-0024](../../memory/90-decisions/0024-release-gate-tarball.md) (gate do tarball)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O ADR-0023 definiu `lib/core/health.ts` como fonte única da saúde do núcleo e previu três
|
|
12
|
+
consumidores: `tools:doctor`, `SessionStart` e Release Auditor. Os dois primeiros já consomem o
|
|
13
|
+
catálogo; o Release Auditor ainda manda executar apenas `release:check --publish`.
|
|
14
|
+
|
|
15
|
+
Esse gate prova a fronteira do tarball, mas não substitui a saúde do repositório. Ele não executa os
|
|
16
|
+
checks de coerência de documentação e topologia e só alcança parte da saúde indiretamente, por meio
|
|
17
|
+
de comandos de smoke na instalação limpa. Assim, o auditor pode aprovar o pacote sem ter obtido o
|
|
18
|
+
veredito da fonte que o ADR-0023 declarou canônica.
|
|
19
|
+
|
|
20
|
+
O agregador `check:all --full` também não substitui o procedimento de publicação: internamente ele
|
|
21
|
+
roda `release:check` em modo de desenvolvimento, no qual árvore suja é aviso. Pré-publicação exige
|
|
22
|
+
`release:check --publish`, que reprova se o tarball não corresponder a um commit.
|
|
23
|
+
|
|
24
|
+
## 2. Proposta de valor
|
|
25
|
+
Toda auditoria pré-publicação valida primeiro a saúde canônica do núcleo e depois a instalação limpa
|
|
26
|
+
do tarball, sem duplicar probes e sem enfraquecer o contrato de árvore limpa.
|
|
27
|
+
|
|
28
|
+
## 3. User stories
|
|
29
|
+
- **Como** Release Auditor, **quero** consumir o veredito de `tools:doctor` antes do gate do
|
|
30
|
+
tarball, **para que** eu não aprove um release sobre um núcleo incoerente.
|
|
31
|
+
- **Como** mantenedor, **quero** que o procedimento aponte para os gates executáveis existentes,
|
|
32
|
+
**para que** uma nova entrada em `CHECKS[]` seja herdada sem editar o agente.
|
|
33
|
+
- **Como** quem publica, **quero** preservar `release:check --publish`, **para que** uma árvore suja
|
|
34
|
+
continue bloqueando a publicação.
|
|
35
|
+
|
|
36
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
37
|
+
- [x] AC-1: `.claude/agents/release-auditor.md` manda executar `npm run tools:doctor` antes de
|
|
38
|
+
`npm run release:check -- --publish`.
|
|
39
|
+
- [x] AC-2: Falha crítica do doctor reprova a auditoria e impede parecer de aprovação, com a
|
|
40
|
+
correção fornecida pelo próprio check.
|
|
41
|
+
- [x] AC-3: O agente não reimplementa nenhum probe de `lib/core/health.ts`; o catálogo continua
|
|
42
|
+
sendo a única fonte da definição de saúde.
|
|
43
|
+
- [x] AC-4: `release:check -- --publish` permanece obrigatório e separado. `check:all --full` não é
|
|
44
|
+
apresentado como equivalente de pré-publicação enquanto não propagar o modo `publish`.
|
|
45
|
+
- [x] AC-5: A descrição canônica do papel em `AGENTS.md` reflete os dois gates e mantém explícito que
|
|
46
|
+
o auditor não executa `npm publish`.
|
|
47
|
+
- [x] AC-6: Teste automatizado falha se o procedimento perder um dos comandos, inverter sua ordem
|
|
48
|
+
ou remover `--publish`.
|
|
49
|
+
|
|
50
|
+
## 5. Escopo
|
|
51
|
+
**Dentro**:
|
|
52
|
+
- Procedimento e julgamento em `.claude/agents/release-auditor.md`.
|
|
53
|
+
- Descrição canônica do papel em `AGENTS.md`.
|
|
54
|
+
- Teste de contrato do procedimento.
|
|
55
|
+
- Atualização do candidato obsoleto em `memory/40-delivery/current-sprint.md`.
|
|
56
|
+
|
|
57
|
+
**Fora** (explícito, evita scope creep):
|
|
58
|
+
- Alterar `lib/core/health.ts`, seus checks ou severidades.
|
|
59
|
+
- Alterar `lib/core/release.ts` ou incorporar os checks de health ao catálogo de release.
|
|
60
|
+
- Fazer `check:all --full` propagar modo de publicação.
|
|
61
|
+
- Executar ou automatizar `npm publish`.
|
|
62
|
+
- Criar ADR: os contratos necessários já estão decididos nos ADRs 0023 e 0024.
|
|
63
|
+
|
|
64
|
+
## 6. NFRs / restrições
|
|
65
|
+
- **Performance**: o doctor roda antes do gate caro e pode interromper cedo uma auditoria inviável.
|
|
66
|
+
- **Segurança**: nenhuma correção e nenhuma publicação são executadas automaticamente.
|
|
67
|
+
- **Observabilidade**: o parecer cita o gate, o check que falhou e sua correção; não resume falha
|
|
68
|
+
crítica como diagnóstico genérico.
|
|
69
|
+
- **Compatibilidade**: nomes e contratos dos comandos existentes permanecem intactos.
|
|
70
|
+
|
|
71
|
+
## 7. Riscos e mitigação
|
|
72
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
73
|
+
|---|---|---|---|
|
|
74
|
+
| Duplicar checks entre health e release | M | A | Compor comandos existentes; zero probe novo |
|
|
75
|
+
| Trocar por `check:all --full` e aceitar árvore suja | M | A | Manter `release:check --publish` explícito e testado |
|
|
76
|
+
| Doctor tornar o release mais lento | B | B | Gate barato roda antes do empacotamento e falha cedo |
|
|
77
|
+
| Documentação do papel voltar a divergir | M | M | Teste de contrato cobre presença e ordem dos comandos |
|
|
78
|
+
|
|
79
|
+
## 8. Métricas de sucesso
|
|
80
|
+
Nos 30 dias após a entrega, 100% dos pareceres do Release Auditor registrados na trilha executam os
|
|
81
|
+
dois gates; nenhuma aprovação ocorre após `tools:doctor` crítico e nenhuma auditoria de publicação
|
|
82
|
+
usa `release:check` sem `--publish`.
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# Tasks: release-auditor-health
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-08-17
|
|
7
|
+
|
|
8
|
+
> Decomposição executável. A sequência preserva o contrato antes de atualizar a documentação.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## T1 — Fixar o contrato do Release Auditor
|
|
13
|
+
|
|
14
|
+
- **Owner**: Worker
|
|
15
|
+
- **Estimativa**: P
|
|
16
|
+
- **Depende de**: —
|
|
17
|
+
- **Paths**: `test/release-auditor.test.js`
|
|
18
|
+
- **Done quando**:
|
|
19
|
+
- [x] O teste lê `.claude/agents/release-auditor.md` como contrato operacional.
|
|
20
|
+
- [x] Reprova se `npm run tools:doctor` estiver ausente ou depois de
|
|
21
|
+
`npm run release:check -- --publish` (AC-1, AC-6).
|
|
22
|
+
- [x] Reprova se o gate do tarball perder `--publish` (AC-4, AC-6).
|
|
23
|
+
- [x] Reprova se o procedimento autorizar ou executar `npm publish` (AC-5).
|
|
24
|
+
- [x] Não compara o prompt inteiro nem fica acoplado a texto editorial fora desses invariantes.
|
|
25
|
+
|
|
26
|
+
## T2 — Migrar o procedimento do agente
|
|
27
|
+
|
|
28
|
+
- **Owner**: Worker
|
|
29
|
+
- **Estimativa**: P
|
|
30
|
+
- **Depende de**: T1
|
|
31
|
+
- **Paths**: `.claude/agents/release-auditor.md`
|
|
32
|
+
- **Done quando**:
|
|
33
|
+
- [x] O procedimento executa `npm run tools:doctor` antes do gate do tarball (AC-1).
|
|
34
|
+
- [x] Falha crítica do doctor interrompe a auditoria e produz parecer reprovado com o `fix` do
|
|
35
|
+
check; avisos são lidos e relatados sem serem promovidos a falha (AC-2).
|
|
36
|
+
- [x] `npm run release:check -- --publish` permanece obrigatório (AC-4).
|
|
37
|
+
- [x] Não há probe, heurística de saúde ou lista duplicada de checks no prompt (AC-3).
|
|
38
|
+
- [x] A regra de nunca executar `npm publish` permanece explícita (AC-5).
|
|
39
|
+
|
|
40
|
+
## T3 — Alinhar a topologia e a sprint
|
|
41
|
+
|
|
42
|
+
- **Owner**: Worker
|
|
43
|
+
- **Estimativa**: P
|
|
44
|
+
- **Depende de**: T2
|
|
45
|
+
- **Paths**: `AGENTS.md`, `memory/40-delivery/current-sprint.md`
|
|
46
|
+
- **Done quando**:
|
|
47
|
+
- [x] A descrição canônica do Release Auditor cita os dois gates, na ordem correta, e mantém a
|
|
48
|
+
publicação como ato humano (AC-5).
|
|
49
|
+
- [x] O candidato obsoleto de migração do Release Auditor sai de "Próximos candidatos" e a
|
|
50
|
+
SPEC-022 aparece como item da sprint.
|
|
51
|
+
- [x] A informação de que `tools:doctor` ainda não roda no CI é removida, pois `.github/workflows/ci.yml`
|
|
52
|
+
já executa o gate.
|
|
53
|
+
|
|
54
|
+
## T4 — Validação e handoff de governança
|
|
55
|
+
|
|
56
|
+
- **Owner**: Governance
|
|
57
|
+
- **Estimativa**: P
|
|
58
|
+
- **Depende de**: T1, T2, T3
|
|
59
|
+
- **Paths**: `specs/release-auditor-health/spec.md`, `specs/release-auditor-health/tasks.md`
|
|
60
|
+
- **Done quando**:
|
|
61
|
+
- [x] Teste direcionado do Release Auditor passa.
|
|
62
|
+
- [x] `npm run types:check`, `npm run project:check`, `npm run tools:doctor` e
|
|
63
|
+
`npm run spec:check -- release-auditor-health` passam.
|
|
64
|
+
- [x] AC-1 a AC-6 são marcados somente após evidência verificável.
|
|
65
|
+
- [x] Handoff `review` é registrado; Governance emite parecer antes de concluir a spec.
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## Handoffs entre agentes
|
|
70
|
+
|
|
71
|
+
Após aprovação destas tasks, registrar `npm run gsd:handoff -- implement release-auditor-health`.
|
|
72
|
+
Ao concluir T1-T3, registrar `npm run gsd:handoff -- review release-auditor-health` para Governance.
|