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,84 +1,84 @@
|
|
|
1
|
-
# ADR-0028: Governança visível — auditoria consultável + painel estático-gerado
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-19
|
|
5
|
-
- **Autor(es)**: Allan Pablo
|
|
6
|
-
- **Tags**: governance, audit, dashboard, token-economy
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
O core grava toda execução em `.context/forja-runs.jsonl` (ADR-0020): `{ts, cmd, args, exitCode,
|
|
11
|
-
durationMs}`. É o dado mais rico de governança do framework — a resposta viva para *"o processo foi
|
|
12
|
-
seguido? o que reprovou? quanto custou?"* — e era **write-only**. Para saber "quantas vezes o
|
|
13
|
-
`release:check` reprovou", alguém abria um `.jsonl` de centenas de linhas e contava na mão. Dado que
|
|
14
|
-
existe mas não é consultável é dado morto — a mesma classe que a sessão inteira atacou.
|
|
15
|
-
|
|
16
|
-
E faltava superfície visual. A tentativa anterior (SPEC-002) foi **congelada** (ADR-0022) — mas o
|
|
17
|
-
motivo não foi "ser visual": foi ser um **servidor** com rotas que *executavam* processos
|
|
18
|
-
(`POST .../run/:role`), um passivo de manutenção e de segurança. A lição é "sem servidor, sem
|
|
19
|
-
execução", não "sem visual".
|
|
20
|
-
|
|
21
|
-
## Decisão
|
|
22
|
-
|
|
23
|
-
Três comandos no domínio `governanca`, todos passando pelo core:
|
|
24
|
-
|
|
25
|
-
- **`audit:sync`** — projeta o `.jsonl` numa tabela `audit_runs` do `universal.db`. A tabela é
|
|
26
|
-
**projeção reconstruível**; o `.jsonl` segue sendo a fonte de verdade append-only.
|
|
27
|
-
- **`audit:query`** — consulta estruturada (`--failed`, `--cmd`, `--since 7d`).
|
|
28
|
-
- **`governance:dashboard`** — gera um HTML **estático, self-contained** (gates, pipeline SDD,
|
|
29
|
-
auditoria, métricas). Um arquivo, aberto com `file://`. **Não executa nada.**
|
|
30
|
-
|
|
31
|
-
Princípios:
|
|
32
|
-
|
|
33
|
-
- **D1 — A tabela é projeção; o `.jsonl` é a verdade.** Gravar direto no SQLite no core acoplaria
|
|
34
|
-
toda execução ao banco (que pode estar morto, ADR-0021). O log em arquivo é resiliente; a tabela é
|
|
35
|
-
derivada, reconstruível por `audit:sync`.
|
|
36
|
-
- **D2 — Idempotência por `line_hash`**, não por cursor. Hash do conteúdo da linha como PK +
|
|
37
|
-
`INSERT OR IGNORE`. Robusto a re-sync e a truncamento do log.
|
|
38
|
-
- **D3 — SQL estruturado, não FTS5.** O dado é colunar (`cmd`, `exit`, `duração`, `ts`); query por
|
|
39
|
-
coluna responde as perguntas reais. FTS5 seria over-engineering aqui.
|
|
40
|
-
- **D4 — O painel não executa gates.** Mostra os checks de cada catálogo (`health`/`release`) + o
|
|
41
|
-
**último exit** daquele comando na auditoria. Estado real, sem reexecutar — reforça o "sem
|
|
42
|
-
execução" do ADR-0022.
|
|
43
|
-
- **D5 — Comando novo, não estender `project:dashboard`.** Aquele é markdown sobre o ecossistema de
|
|
44
|
-
projetos; este é HTML sobre a saúde do framework. Coexistem.
|
|
45
|
-
- **D6 — Self-contained obrigatório.** CSS inline, zero asset externo, zero `<script>`. Abre com
|
|
46
|
-
`file://`. É o que separa este painel do servidor congelado.
|
|
47
|
-
|
|
48
|
-
## Alternativas consideradas
|
|
49
|
-
|
|
50
|
-
- **Ressuscitar o dashboard-servidor** — rejeitada: é exatamente o que o ADR-0022 congelou.
|
|
51
|
-
Artefato gerado entrega o visual sem o passivo.
|
|
52
|
-
- **Gravar a auditoria direto no SQLite** — rejeitada: acopla execução ao banco e perde a
|
|
53
|
-
resiliência do log em arquivo (D1).
|
|
54
|
-
- **FTS5 na auditoria** — rejeitada: o dado é estruturado; SQL por coluna basta (D3).
|
|
55
|
-
- **O painel executar os gates para mostrar o estado atual** — rejeitada: lento, com efeito
|
|
56
|
-
colateral, e reintroduz "execução" na superfície visual. O último exit da auditoria é estado real
|
|
57
|
-
o suficiente (D4).
|
|
58
|
-
|
|
59
|
-
## Consequências
|
|
60
|
-
|
|
61
|
-
**Positivas**:
|
|
62
|
-
- "Quantas vezes o `release:check` reprovou?" passou de contagem manual a **uma query**. Medido em
|
|
63
|
-
campo na implementação: 34 runs, 9 reprovações (as reprovações reais da própria sessão).
|
|
64
|
-
- O Forja ganha superfície visual **sem** repetir o erro do ADR-0022 — é arquivo, não serviço.
|
|
65
|
-
- O resumo de auditoria que um agente lê é menor em tokens que o `.jsonl` cru — governança visível
|
|
66
|
-
também economiza contexto (ADR-0009).
|
|
67
|
-
|
|
68
|
-
**Negativas / Trade-offs**:
|
|
69
|
-
- O estado dos gates no painel é o *último* exit registrado, não um check ao vivo — pode estar
|
|
70
|
-
defasado se o gate não roda há tempo. É o preço consciente do "sem execução" (D4); quem quer o
|
|
71
|
-
estado agora roda `tools:doctor`.
|
|
72
|
-
- Duas superfícies de "dashboard" (`project:dashboard` markdown + `governance:dashboard` HTML). Uma
|
|
73
|
-
unificação futura é possível, mas fundir agora confundiria dois públicos (D5).
|
|
74
|
-
|
|
75
|
-
## Rastreamento
|
|
76
|
-
|
|
77
|
-
- Implementação: `lib/audit.mjs`, `lib/governance-report.mjs`, `scripts/audit-{sync,query}.mjs`,
|
|
78
|
-
`scripts/governance-dashboard.mjs`, `scripts/memory-schema.mjs` (tabela `audit_runs`)
|
|
79
|
-
- Spec: `specs/governanca-visivel/` (SPEC-014)
|
|
80
|
-
- ADRs relacionadas: ADR-0022 (dashboard congelado — a decisão que este responde corretamente),
|
|
81
|
-
ADR-0020 (o core que grava a auditoria), ADR-0021 (resiliência: log em arquivo > banco), ADR-0009
|
|
82
|
-
(economia de tokens)
|
|
83
|
-
- **Follow-up**: instrumentar custo de token por tarefa (o audit grava duração, não tokens); o painel
|
|
84
|
-
já tem lugar para isso.
|
|
1
|
+
# ADR-0028: Governança visível — auditoria consultável + painel estático-gerado
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-19
|
|
5
|
+
- **Autor(es)**: Allan Pablo
|
|
6
|
+
- **Tags**: governance, audit, dashboard, token-economy
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
O core grava toda execução em `.context/forja-runs.jsonl` (ADR-0020): `{ts, cmd, args, exitCode,
|
|
11
|
+
durationMs}`. É o dado mais rico de governança do framework — a resposta viva para *"o processo foi
|
|
12
|
+
seguido? o que reprovou? quanto custou?"* — e era **write-only**. Para saber "quantas vezes o
|
|
13
|
+
`release:check` reprovou", alguém abria um `.jsonl` de centenas de linhas e contava na mão. Dado que
|
|
14
|
+
existe mas não é consultável é dado morto — a mesma classe que a sessão inteira atacou.
|
|
15
|
+
|
|
16
|
+
E faltava superfície visual. A tentativa anterior (SPEC-002) foi **congelada** (ADR-0022) — mas o
|
|
17
|
+
motivo não foi "ser visual": foi ser um **servidor** com rotas que *executavam* processos
|
|
18
|
+
(`POST .../run/:role`), um passivo de manutenção e de segurança. A lição é "sem servidor, sem
|
|
19
|
+
execução", não "sem visual".
|
|
20
|
+
|
|
21
|
+
## Decisão
|
|
22
|
+
|
|
23
|
+
Três comandos no domínio `governanca`, todos passando pelo core:
|
|
24
|
+
|
|
25
|
+
- **`audit:sync`** — projeta o `.jsonl` numa tabela `audit_runs` do `universal.db`. A tabela é
|
|
26
|
+
**projeção reconstruível**; o `.jsonl` segue sendo a fonte de verdade append-only.
|
|
27
|
+
- **`audit:query`** — consulta estruturada (`--failed`, `--cmd`, `--since 7d`).
|
|
28
|
+
- **`governance:dashboard`** — gera um HTML **estático, self-contained** (gates, pipeline SDD,
|
|
29
|
+
auditoria, métricas). Um arquivo, aberto com `file://`. **Não executa nada.**
|
|
30
|
+
|
|
31
|
+
Princípios:
|
|
32
|
+
|
|
33
|
+
- **D1 — A tabela é projeção; o `.jsonl` é a verdade.** Gravar direto no SQLite no core acoplaria
|
|
34
|
+
toda execução ao banco (que pode estar morto, ADR-0021). O log em arquivo é resiliente; a tabela é
|
|
35
|
+
derivada, reconstruível por `audit:sync`.
|
|
36
|
+
- **D2 — Idempotência por `line_hash`**, não por cursor. Hash do conteúdo da linha como PK +
|
|
37
|
+
`INSERT OR IGNORE`. Robusto a re-sync e a truncamento do log.
|
|
38
|
+
- **D3 — SQL estruturado, não FTS5.** O dado é colunar (`cmd`, `exit`, `duração`, `ts`); query por
|
|
39
|
+
coluna responde as perguntas reais. FTS5 seria over-engineering aqui.
|
|
40
|
+
- **D4 — O painel não executa gates.** Mostra os checks de cada catálogo (`health`/`release`) + o
|
|
41
|
+
**último exit** daquele comando na auditoria. Estado real, sem reexecutar — reforça o "sem
|
|
42
|
+
execução" do ADR-0022.
|
|
43
|
+
- **D5 — Comando novo, não estender `project:dashboard`.** Aquele é markdown sobre o ecossistema de
|
|
44
|
+
projetos; este é HTML sobre a saúde do framework. Coexistem.
|
|
45
|
+
- **D6 — Self-contained obrigatório.** CSS inline, zero asset externo, zero `<script>`. Abre com
|
|
46
|
+
`file://`. É o que separa este painel do servidor congelado.
|
|
47
|
+
|
|
48
|
+
## Alternativas consideradas
|
|
49
|
+
|
|
50
|
+
- **Ressuscitar o dashboard-servidor** — rejeitada: é exatamente o que o ADR-0022 congelou.
|
|
51
|
+
Artefato gerado entrega o visual sem o passivo.
|
|
52
|
+
- **Gravar a auditoria direto no SQLite** — rejeitada: acopla execução ao banco e perde a
|
|
53
|
+
resiliência do log em arquivo (D1).
|
|
54
|
+
- **FTS5 na auditoria** — rejeitada: o dado é estruturado; SQL por coluna basta (D3).
|
|
55
|
+
- **O painel executar os gates para mostrar o estado atual** — rejeitada: lento, com efeito
|
|
56
|
+
colateral, e reintroduz "execução" na superfície visual. O último exit da auditoria é estado real
|
|
57
|
+
o suficiente (D4).
|
|
58
|
+
|
|
59
|
+
## Consequências
|
|
60
|
+
|
|
61
|
+
**Positivas**:
|
|
62
|
+
- "Quantas vezes o `release:check` reprovou?" passou de contagem manual a **uma query**. Medido em
|
|
63
|
+
campo na implementação: 34 runs, 9 reprovações (as reprovações reais da própria sessão).
|
|
64
|
+
- O Forja ganha superfície visual **sem** repetir o erro do ADR-0022 — é arquivo, não serviço.
|
|
65
|
+
- O resumo de auditoria que um agente lê é menor em tokens que o `.jsonl` cru — governança visível
|
|
66
|
+
também economiza contexto (ADR-0009).
|
|
67
|
+
|
|
68
|
+
**Negativas / Trade-offs**:
|
|
69
|
+
- O estado dos gates no painel é o *último* exit registrado, não um check ao vivo — pode estar
|
|
70
|
+
defasado se o gate não roda há tempo. É o preço consciente do "sem execução" (D4); quem quer o
|
|
71
|
+
estado agora roda `tools:doctor`.
|
|
72
|
+
- Duas superfícies de "dashboard" (`project:dashboard` markdown + `governance:dashboard` HTML). Uma
|
|
73
|
+
unificação futura é possível, mas fundir agora confundiria dois públicos (D5).
|
|
74
|
+
|
|
75
|
+
## Rastreamento
|
|
76
|
+
|
|
77
|
+
- Implementação: `lib/audit.mjs`, `lib/governance-report.mjs`, `scripts/audit-{sync,query}.mjs`,
|
|
78
|
+
`scripts/governance-dashboard.mjs`, `scripts/memory-schema.mjs` (tabela `audit_runs`)
|
|
79
|
+
- Spec: `specs/governanca-visivel/` (SPEC-014)
|
|
80
|
+
- ADRs relacionadas: ADR-0022 (dashboard congelado — a decisão que este responde corretamente),
|
|
81
|
+
ADR-0020 (o core que grava a auditoria), ADR-0021 (resiliência: log em arquivo > banco), ADR-0009
|
|
82
|
+
(economia de tokens)
|
|
83
|
+
- **Follow-up**: instrumentar custo de token por tarefa (o audit grava duração, não tokens); o painel
|
|
84
|
+
já tem lugar para isso.
|
|
@@ -1,59 +1,59 @@
|
|
|
1
|
-
# ADR-0029: Gate do projeto gerado (`project:smoke`)
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-19
|
|
5
|
-
- **Autor(es)**: apk
|
|
6
|
-
- **Tags**: quality, gates, generators, sdd
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
O `release:check` (ADR-0024) guarda uma fronteira com evidência: *o repositório mente sobre o
|
|
11
|
-
pacote*. Existe a **mesma classe de bug um nível acima, e estava descoberta**: nada provava que
|
|
12
|
-
`forja project:new` gera um projeto coerente.
|
|
13
|
-
|
|
14
|
-
O gerador escreve a partir de templates — `{{FEATURE}}`, blocos de `scripts`, configs. Cada
|
|
15
|
-
substituição é uma chance de mentira silenciosa: um placeholder que vaza, um `package.json` que não
|
|
16
|
-
parseia, uma estrutura incompleta. O `structure-validator` já sabia *validar* estrutura, mas nada
|
|
17
|
-
*executava* o gerador de ponta a ponta e reprovava. Conhecimento não faltava; execução, sim — o
|
|
18
|
-
mesmo diagnóstico da SPEC-010.
|
|
19
|
-
|
|
20
|
-
## Decisão
|
|
21
|
-
|
|
22
|
-
Criar `project:smoke` (SPEC-015): um gate que **gera um projeto num diretório temporário isolado e o
|
|
23
|
-
inspeciona**, reusando o runner de `checks.ts` — a mesma máquina de probes do doctor e do release.
|
|
24
|
-
|
|
25
|
-
Dois tiers, espelhando o `release:check`:
|
|
26
|
-
|
|
27
|
-
- **Barato (default, roda no CI)**: sem rede. Prova que nenhum placeholder `{{...}}` vazou, que todo
|
|
28
|
-
`package.json` parseia, e que a estrutura passa no `validateProjectStructure`.
|
|
29
|
-
- **`--full` (opt-in, pré-release)**: `npm install` + `npm run build` no backend gerado, num ambiente
|
|
30
|
-
isolado (sem `NODE_PATH`/`npm_config_*` herdados). É o clean-install do release, na saída do gerador.
|
|
31
|
-
|
|
32
|
-
O gerador não sabe que está sendo auditado — o gate só o observa via spawn do entry real
|
|
33
|
-
(`create-memory-nest-kit`), como o release empacota o tarball real.
|
|
34
|
-
|
|
35
|
-
## Alternativas consideradas
|
|
36
|
-
|
|
37
|
-
- **Importar as funções do gerador e chamá-las direto** — rejeitada: testaria as funções, não o
|
|
38
|
-
entry point que o usuário roda. O spawn do orquestrador pega bugs de orquestração também.
|
|
39
|
-
- **Rodar sempre o tier pesado (install+build)** — rejeitada: `npm install` de um NestJS é lento e
|
|
40
|
-
usa rede; um gate que reprova por flakiness de registry se contorna (a lição do CI na SPEC-009).
|
|
41
|
-
Por isso o tier barato é o gate de CI e o `--full` é opt-in.
|
|
42
|
-
- **Pôr no `tools:doctor`** — rejeitada: o doctor é o raio-x barato do núcleo; gerar um projeto tem
|
|
43
|
-
custo. É gate próprio, como o `release:check`.
|
|
44
|
-
|
|
45
|
-
## Consequências
|
|
46
|
-
|
|
47
|
-
**Positivas**:
|
|
48
|
-
- A última fronteira do gerador que vivia por disciplina passa a viver no harness.
|
|
49
|
-
- Reuso total: runner de `checks.ts` + `structure-validator` existente — uma máquina, não duas.
|
|
50
|
-
- O tier barato é rápido o bastante para o CI; o `--full` dá a prova forte antes de publicar.
|
|
51
|
-
|
|
52
|
-
**Negativas / Trade-offs**:
|
|
53
|
-
- Cobre o caminho *default* do gerador; a matriz de boilerplates de stack fica para iteração futura.
|
|
54
|
-
- O `--full` depende de rede — mitigado por ser opt-in, fora do gate de CI.
|
|
55
|
-
|
|
56
|
-
## Rastreamento
|
|
57
|
-
- Implementação: `lib/core/project-smoke.ts`, `scripts/project-smoke.ts`, `test/project-smoke.test.js`
|
|
58
|
-
- Spec: `specs/project-smoke/spec.md` (SPEC-015)
|
|
59
|
-
- ADRs relacionadas: ADR-0024 (gate do tarball — o padrão), ADR-0023 (doctor), ADR-0020 (core/registry)
|
|
1
|
+
# ADR-0029: Gate do projeto gerado (`project:smoke`)
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-19
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: quality, gates, generators, sdd
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
O `release:check` (ADR-0024) guarda uma fronteira com evidência: *o repositório mente sobre o
|
|
11
|
+
pacote*. Existe a **mesma classe de bug um nível acima, e estava descoberta**: nada provava que
|
|
12
|
+
`forja project:new` gera um projeto coerente.
|
|
13
|
+
|
|
14
|
+
O gerador escreve a partir de templates — `{{FEATURE}}`, blocos de `scripts`, configs. Cada
|
|
15
|
+
substituição é uma chance de mentira silenciosa: um placeholder que vaza, um `package.json` que não
|
|
16
|
+
parseia, uma estrutura incompleta. O `structure-validator` já sabia *validar* estrutura, mas nada
|
|
17
|
+
*executava* o gerador de ponta a ponta e reprovava. Conhecimento não faltava; execução, sim — o
|
|
18
|
+
mesmo diagnóstico da SPEC-010.
|
|
19
|
+
|
|
20
|
+
## Decisão
|
|
21
|
+
|
|
22
|
+
Criar `project:smoke` (SPEC-015): um gate que **gera um projeto num diretório temporário isolado e o
|
|
23
|
+
inspeciona**, reusando o runner de `checks.ts` — a mesma máquina de probes do doctor e do release.
|
|
24
|
+
|
|
25
|
+
Dois tiers, espelhando o `release:check`:
|
|
26
|
+
|
|
27
|
+
- **Barato (default, roda no CI)**: sem rede. Prova que nenhum placeholder `{{...}}` vazou, que todo
|
|
28
|
+
`package.json` parseia, e que a estrutura passa no `validateProjectStructure`.
|
|
29
|
+
- **`--full` (opt-in, pré-release)**: `npm install` + `npm run build` no backend gerado, num ambiente
|
|
30
|
+
isolado (sem `NODE_PATH`/`npm_config_*` herdados). É o clean-install do release, na saída do gerador.
|
|
31
|
+
|
|
32
|
+
O gerador não sabe que está sendo auditado — o gate só o observa via spawn do entry real
|
|
33
|
+
(`create-memory-nest-kit`), como o release empacota o tarball real.
|
|
34
|
+
|
|
35
|
+
## Alternativas consideradas
|
|
36
|
+
|
|
37
|
+
- **Importar as funções do gerador e chamá-las direto** — rejeitada: testaria as funções, não o
|
|
38
|
+
entry point que o usuário roda. O spawn do orquestrador pega bugs de orquestração também.
|
|
39
|
+
- **Rodar sempre o tier pesado (install+build)** — rejeitada: `npm install` de um NestJS é lento e
|
|
40
|
+
usa rede; um gate que reprova por flakiness de registry se contorna (a lição do CI na SPEC-009).
|
|
41
|
+
Por isso o tier barato é o gate de CI e o `--full` é opt-in.
|
|
42
|
+
- **Pôr no `tools:doctor`** — rejeitada: o doctor é o raio-x barato do núcleo; gerar um projeto tem
|
|
43
|
+
custo. É gate próprio, como o `release:check`.
|
|
44
|
+
|
|
45
|
+
## Consequências
|
|
46
|
+
|
|
47
|
+
**Positivas**:
|
|
48
|
+
- A última fronteira do gerador que vivia por disciplina passa a viver no harness.
|
|
49
|
+
- Reuso total: runner de `checks.ts` + `structure-validator` existente — uma máquina, não duas.
|
|
50
|
+
- O tier barato é rápido o bastante para o CI; o `--full` dá a prova forte antes de publicar.
|
|
51
|
+
|
|
52
|
+
**Negativas / Trade-offs**:
|
|
53
|
+
- Cobre o caminho *default* do gerador; a matriz de boilerplates de stack fica para iteração futura.
|
|
54
|
+
- O `--full` depende de rede — mitigado por ser opt-in, fora do gate de CI.
|
|
55
|
+
|
|
56
|
+
## Rastreamento
|
|
57
|
+
- Implementação: `lib/core/project-smoke.ts`, `scripts/project-smoke.ts`, `test/project-smoke.test.js`
|
|
58
|
+
- Spec: `specs/project-smoke/spec.md` (SPEC-015)
|
|
59
|
+
- ADRs relacionadas: ADR-0024 (gate do tarball — o padrão), ADR-0023 (doctor), ADR-0020 (core/registry)
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# ADR-0030: O projeto gerado herda os gates do framework
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-19
|
|
5
|
-
- **Autor(es)**: apk
|
|
6
|
-
- **Tags**: generators, gates, memory, governance
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
O framework construiu uma família de invariantes-que-rodam: `project:smoke`, `memory:audit`,
|
|
11
|
-
`adr-refs`, o `release:check`. Mas todos guardam o **framework**. O **projeto do usuário** não
|
|
12
|
-
herdava nenhum — gerava com mapas de memória honestos e, com o tempo, um rename sem atualizar o
|
|
13
|
-
`context.md` fazia o mapa mentir, silenciosamente, sem nada avisar. A economia de token da memória
|
|
14
|
-
(ADR-0009) se degrada, e ninguém percebe. É a mesma classe "vive por disciplina" que o ADR-0021
|
|
15
|
-
combate — só que na máquina do usuário, onde o framework não alcança por gate próprio.
|
|
16
|
-
|
|
17
|
-
## Decisão
|
|
18
|
-
|
|
19
|
-
O gerador **emite um gate self-contained no projeto**: `scripts/check-memory-maps.mjs`, uma versão
|
|
20
|
-
sem dependências do `memory:audit` (coerência mapa↔código: mapa não cita código morto, módulo sem
|
|
21
|
-
mapa avisa). Zero acoplamento ao `forjajs` — Node puro, roda em qualquer CI com `node
|
|
22
|
-
scripts/check-memory-maps.mjs`. O `project:smoke` do framework passa a **verificar que o gate está
|
|
23
|
-
presente** no projeto gerado, fechando o laço: o framework prova que propaga o invariante.
|
|
24
|
-
|
|
25
|
-
A filosofia de invariantes deixa de ser só do mantenedor do Forja e passa a viajar com cada projeto.
|
|
26
|
-
|
|
27
|
-
## Alternativas consideradas
|
|
28
|
-
|
|
29
|
-
- **Projeto depende de `forjajs` e roda `npx forja memory:audit`** — rejeitada: acopla um app NestJS
|
|
30
|
-
ao framework inteiro (e ao `better-sqlite3`), pesado para um gate que é Node puro.
|
|
31
|
-
- **Emitir um workflow `.github/` pronto** — rejeitada (por ora): imporia GitHub Actions a todo
|
|
32
|
-
projeto (alguns usam GitLab/outros). O script é portável; o usuário o pluga no CI que usa. Um
|
|
33
|
-
workflow opcional pode vir em follow-up.
|
|
34
|
-
- **Não propagar (deixar como doc)** — rejeitada: é exatamente o "regra que depende de memória" que
|
|
35
|
-
o framework existe para eliminar.
|
|
36
|
-
|
|
37
|
-
## Consequências
|
|
38
|
-
|
|
39
|
-
**Positivas**:
|
|
40
|
-
- O invariante mapa↔código viaja com o projeto; a economia de token da memória fica protegida na
|
|
41
|
-
máquina do usuário, não só na do framework.
|
|
42
|
-
- Self-contained: sem dependência nova no projeto gerado.
|
|
43
|
-
- `project:smoke` prova a propagação (o gate está presente no output).
|
|
44
|
-
|
|
45
|
-
**Negativas / Trade-offs**:
|
|
46
|
-
- Duplicação de lógica (o `check-memory-maps.mjs` do projeto espelha o `lib/memory-audit.ts`). É o
|
|
47
|
-
preço de projetos independentes; a lógica é pequena e estável.
|
|
48
|
-
- O gate não roda sozinho até o usuário plugá-lo no CI — o script está presente, o wiring é dele.
|
|
49
|
-
|
|
50
|
-
## Rastreamento
|
|
51
|
-
- Implementação: `lib/generators/memory-generator.ts` (emite o script),
|
|
52
|
-
`lib/core/project-smoke.ts` (check `gate-inherited`)
|
|
53
|
-
- ADRs relacionadas: ADR-0009 (economia de token), ADR-0021 (invariante > disciplina), ADR-0029 (project:smoke), SPEC-017 (memory:audit)
|
|
1
|
+
# ADR-0030: O projeto gerado herda os gates do framework
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-19
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: generators, gates, memory, governance
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
O framework construiu uma família de invariantes-que-rodam: `project:smoke`, `memory:audit`,
|
|
11
|
+
`adr-refs`, o `release:check`. Mas todos guardam o **framework**. O **projeto do usuário** não
|
|
12
|
+
herdava nenhum — gerava com mapas de memória honestos e, com o tempo, um rename sem atualizar o
|
|
13
|
+
`context.md` fazia o mapa mentir, silenciosamente, sem nada avisar. A economia de token da memória
|
|
14
|
+
(ADR-0009) se degrada, e ninguém percebe. É a mesma classe "vive por disciplina" que o ADR-0021
|
|
15
|
+
combate — só que na máquina do usuário, onde o framework não alcança por gate próprio.
|
|
16
|
+
|
|
17
|
+
## Decisão
|
|
18
|
+
|
|
19
|
+
O gerador **emite um gate self-contained no projeto**: `scripts/check-memory-maps.mjs`, uma versão
|
|
20
|
+
sem dependências do `memory:audit` (coerência mapa↔código: mapa não cita código morto, módulo sem
|
|
21
|
+
mapa avisa). Zero acoplamento ao `forjajs` — Node puro, roda em qualquer CI com `node
|
|
22
|
+
scripts/check-memory-maps.mjs`. O `project:smoke` do framework passa a **verificar que o gate está
|
|
23
|
+
presente** no projeto gerado, fechando o laço: o framework prova que propaga o invariante.
|
|
24
|
+
|
|
25
|
+
A filosofia de invariantes deixa de ser só do mantenedor do Forja e passa a viajar com cada projeto.
|
|
26
|
+
|
|
27
|
+
## Alternativas consideradas
|
|
28
|
+
|
|
29
|
+
- **Projeto depende de `forjajs` e roda `npx forja memory:audit`** — rejeitada: acopla um app NestJS
|
|
30
|
+
ao framework inteiro (e ao `better-sqlite3`), pesado para um gate que é Node puro.
|
|
31
|
+
- **Emitir um workflow `.github/` pronto** — rejeitada (por ora): imporia GitHub Actions a todo
|
|
32
|
+
projeto (alguns usam GitLab/outros). O script é portável; o usuário o pluga no CI que usa. Um
|
|
33
|
+
workflow opcional pode vir em follow-up.
|
|
34
|
+
- **Não propagar (deixar como doc)** — rejeitada: é exatamente o "regra que depende de memória" que
|
|
35
|
+
o framework existe para eliminar.
|
|
36
|
+
|
|
37
|
+
## Consequências
|
|
38
|
+
|
|
39
|
+
**Positivas**:
|
|
40
|
+
- O invariante mapa↔código viaja com o projeto; a economia de token da memória fica protegida na
|
|
41
|
+
máquina do usuário, não só na do framework.
|
|
42
|
+
- Self-contained: sem dependência nova no projeto gerado.
|
|
43
|
+
- `project:smoke` prova a propagação (o gate está presente no output).
|
|
44
|
+
|
|
45
|
+
**Negativas / Trade-offs**:
|
|
46
|
+
- Duplicação de lógica (o `check-memory-maps.mjs` do projeto espelha o `lib/memory-audit.ts`). É o
|
|
47
|
+
preço de projetos independentes; a lógica é pequena e estável.
|
|
48
|
+
- O gate não roda sozinho até o usuário plugá-lo no CI — o script está presente, o wiring é dele.
|
|
49
|
+
|
|
50
|
+
## Rastreamento
|
|
51
|
+
- Implementação: `lib/generators/memory-generator.ts` (emite o script),
|
|
52
|
+
`lib/core/project-smoke.ts` (check `gate-inherited`)
|
|
53
|
+
- ADRs relacionadas: ADR-0009 (economia de token), ADR-0021 (invariante > disciplina), ADR-0029 (project:smoke), SPEC-017 (memory:audit)
|
|
@@ -1,55 +1,55 @@
|
|
|
1
|
-
# ADR-0031: O motor de orquestração — a cadeia como máquina de estados guardada por gates
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-22
|
|
5
|
-
- **Autor(es)**: apk
|
|
6
|
-
- **Tags**: orchestration, gates, sdd, gsd
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
O nome do framework é orquestração multiagente. A SPEC-019 tornou a topologia *coerente*
|
|
11
|
-
(`agent-topology`), mas coerência não é execução: um fluxo multi-papel vivia em handoffs avulsos e
|
|
12
|
-
na disciplina de quem lembra de rodar os checks entre etapas. Não existia uma cadeia que **roda**,
|
|
13
|
-
gate a gate — o namesake era a última grande superfície por disciplina.
|
|
14
|
-
|
|
15
|
-
A tensão central: **o framework não executa IA autonomamente.** Quem faz o trabalho de cada etapa é
|
|
16
|
-
um agente (sub-agent do Claude Code, outra IA, ou um humano) que pega o handoff.
|
|
17
|
-
|
|
18
|
-
## Decisão
|
|
19
|
-
|
|
20
|
-
O motor é a **máquina de estados da cadeia de handoffs, com transições guardadas por gates** — e
|
|
21
|
-
nada mais (SPEC-021):
|
|
22
|
-
|
|
23
|
-
- `forja orchestrate "<objetivo>" --slug <s>` decompõe na cadeia SDD/GSD determinística
|
|
24
|
-
(spec→plan→tasks→implement→review), abre a 1ª etapa e registra o handoff ADR-0005 do dono.
|
|
25
|
-
- `forja orchestrate:advance <s>` fecha a etapa **só se** (1) o artefato SDD da etapa existe e está
|
|
26
|
-
aprovado e (2) o gate da transição sai verde (`spec:check` / `project:check` / `check:all`).
|
|
27
|
-
Vermelho → a corrida trava com o parecer. Verde → abre a próxima e registra o handoff.
|
|
28
|
-
- Estado em `<cwd>/.context/orchestrate-<slug>.json`; roda onde for invocado (framework como
|
|
29
|
-
dogfood; projetos consumidores por construção, graças ao cwd propagado da v1.6.2).
|
|
30
|
-
|
|
31
|
-
**O framework orquestra e guarda; o agente executa.** Honesto (não finge autonomia de IA) e ainda
|
|
32
|
-
assim um motor real: a cadeia progride por veredito de gate, não por memória.
|
|
33
|
-
|
|
34
|
-
## Alternativas consideradas
|
|
35
|
-
|
|
36
|
-
- **Acionar o sub-agent automaticamente no advance** — adiada: mais mágica, mais acoplamento ao
|
|
37
|
-
Claude Code (fere a promessa multi-IA); será decidida com os dados do uso manual (candidata a 2.0).
|
|
38
|
-
- **Decomposição por LLM (cadeia sob medida)** — adiada: v1 é determinística, provável e auditável.
|
|
39
|
-
- **Só documentar o fluxo (status quo)** — rejeitada: é a "regra que depende de memória" (ADR-0021).
|
|
40
|
-
|
|
41
|
-
## Consequências
|
|
42
|
-
|
|
43
|
-
**Positivas**:
|
|
44
|
-
- Pular etapa é **bloqueado pela máquina** (provado: sem artefato o gate nem roda; draft não passa).
|
|
45
|
-
- Compõe o que existe: spec-cli, agent-router (7 campos), os gates, a auditoria — zero reimplementação.
|
|
46
|
-
- A corrida inteira é reconstruível: estado + handoffs + `forja-runs.jsonl`.
|
|
47
|
-
|
|
48
|
-
**Negativas / Trade-offs**:
|
|
49
|
-
- `advance` manual: o motor não empurra ninguém — cobra quando alguém tenta avançar. É o v1 honesto.
|
|
50
|
-
- Cadeia fixa: features fora do formato SDD (hotfix, chore) não precisam do motor — e não devem usá-lo.
|
|
51
|
-
|
|
52
|
-
## Rastreamento
|
|
53
|
-
- Implementação: `lib/orchestrate.ts`, `scripts/orchestrate.ts`, `test/orchestrate.test.js`
|
|
54
|
-
- Spec: `specs/orchestrate/spec.md` (SPEC-021)
|
|
55
|
-
- ADRs relacionadas: ADR-0005 (handoffs), ADR-0020 (registry), ADR-0021 (invariante > disciplina), SPEC-019 (topologia)
|
|
1
|
+
# ADR-0031: O motor de orquestração — a cadeia como máquina de estados guardada por gates
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-22
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: orchestration, gates, sdd, gsd
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
O nome do framework é orquestração multiagente. A SPEC-019 tornou a topologia *coerente*
|
|
11
|
+
(`agent-topology`), mas coerência não é execução: um fluxo multi-papel vivia em handoffs avulsos e
|
|
12
|
+
na disciplina de quem lembra de rodar os checks entre etapas. Não existia uma cadeia que **roda**,
|
|
13
|
+
gate a gate — o namesake era a última grande superfície por disciplina.
|
|
14
|
+
|
|
15
|
+
A tensão central: **o framework não executa IA autonomamente.** Quem faz o trabalho de cada etapa é
|
|
16
|
+
um agente (sub-agent do Claude Code, outra IA, ou um humano) que pega o handoff.
|
|
17
|
+
|
|
18
|
+
## Decisão
|
|
19
|
+
|
|
20
|
+
O motor é a **máquina de estados da cadeia de handoffs, com transições guardadas por gates** — e
|
|
21
|
+
nada mais (SPEC-021):
|
|
22
|
+
|
|
23
|
+
- `forja orchestrate "<objetivo>" --slug <s>` decompõe na cadeia SDD/GSD determinística
|
|
24
|
+
(spec→plan→tasks→implement→review), abre a 1ª etapa e registra o handoff ADR-0005 do dono.
|
|
25
|
+
- `forja orchestrate:advance <s>` fecha a etapa **só se** (1) o artefato SDD da etapa existe e está
|
|
26
|
+
aprovado e (2) o gate da transição sai verde (`spec:check` / `project:check` / `check:all`).
|
|
27
|
+
Vermelho → a corrida trava com o parecer. Verde → abre a próxima e registra o handoff.
|
|
28
|
+
- Estado em `<cwd>/.context/orchestrate-<slug>.json`; roda onde for invocado (framework como
|
|
29
|
+
dogfood; projetos consumidores por construção, graças ao cwd propagado da v1.6.2).
|
|
30
|
+
|
|
31
|
+
**O framework orquestra e guarda; o agente executa.** Honesto (não finge autonomia de IA) e ainda
|
|
32
|
+
assim um motor real: a cadeia progride por veredito de gate, não por memória.
|
|
33
|
+
|
|
34
|
+
## Alternativas consideradas
|
|
35
|
+
|
|
36
|
+
- **Acionar o sub-agent automaticamente no advance** — adiada: mais mágica, mais acoplamento ao
|
|
37
|
+
Claude Code (fere a promessa multi-IA); será decidida com os dados do uso manual (candidata a 2.0).
|
|
38
|
+
- **Decomposição por LLM (cadeia sob medida)** — adiada: v1 é determinística, provável e auditável.
|
|
39
|
+
- **Só documentar o fluxo (status quo)** — rejeitada: é a "regra que depende de memória" (ADR-0021).
|
|
40
|
+
|
|
41
|
+
## Consequências
|
|
42
|
+
|
|
43
|
+
**Positivas**:
|
|
44
|
+
- Pular etapa é **bloqueado pela máquina** (provado: sem artefato o gate nem roda; draft não passa).
|
|
45
|
+
- Compõe o que existe: spec-cli, agent-router (7 campos), os gates, a auditoria — zero reimplementação.
|
|
46
|
+
- A corrida inteira é reconstruível: estado + handoffs + `forja-runs.jsonl`.
|
|
47
|
+
|
|
48
|
+
**Negativas / Trade-offs**:
|
|
49
|
+
- `advance` manual: o motor não empurra ninguém — cobra quando alguém tenta avançar. É o v1 honesto.
|
|
50
|
+
- Cadeia fixa: features fora do formato SDD (hotfix, chore) não precisam do motor — e não devem usá-lo.
|
|
51
|
+
|
|
52
|
+
## Rastreamento
|
|
53
|
+
- Implementação: `lib/orchestrate.ts`, `scripts/orchestrate.ts`, `test/orchestrate.test.js`
|
|
54
|
+
- Spec: `specs/orchestrate/spec.md` (SPEC-021)
|
|
55
|
+
- ADRs relacionadas: ADR-0005 (handoffs), ADR-0020 (registry), ADR-0021 (invariante > disciplina), SPEC-019 (topologia)
|
|
@@ -1,63 +1,63 @@
|
|
|
1
|
-
# ADR-0032: superfícies do projeto usam `cwd`; recursos do framework usam `__dirname`
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-22
|
|
5
|
-
- **Autor(es)**: apk
|
|
6
|
-
- **Tags**: cli, consumer, dist, invariants, release-gate
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
Uma mesma classe de bug voltou quatro vezes: um comando funciona no repo do framework (onde `cwd`
|
|
11
|
-
e `__dirname/..` coincidem) e quebra no pacote **publicado** de um consumidor, porque resolve as
|
|
12
|
-
superfícies do projeto do usuário por `__dirname`, apontando para `node_modules/forjajs/dist`.
|
|
13
|
-
Já mordeu `spec:new` (v1.6.2, escrevia dentro do pacote), `project:upgrade` (v1.6.0, extensão `.ts`
|
|
14
|
-
cravada) e `project:check` (v1.7.1, auditava o pacote — travou uma corrida do `orchestrate`).
|
|
15
|
-
|
|
16
|
-
Corrigir caso a caso não fecha a classe. Uma auditoria sistemática dos comandos consumer-facing
|
|
17
|
-
revelou **mais três instâncias vivas**, todas escondidas atrás de um `const root = __dirname/..` que
|
|
18
|
-
misturava dois papéis: em `agent-harness` o `gsd:*`/`design:check` gravavam/liam no pacote; em
|
|
19
|
-
`context-ops` o `cmdBudget` resolvia o alvo e o guardrail de travessia contra o pacote. `sprint-manager`
|
|
20
|
-
saiu limpo — ele opera pelo workspace (`resolveProject`/`getWorkspaceRoot`, caminhos absolutos).
|
|
21
|
-
|
|
22
|
-
## Decisão
|
|
23
|
-
|
|
24
|
-
Todo script separa **dois papéis de raiz**, com nomes distintos:
|
|
25
|
-
|
|
26
|
-
- **`root` = recursos do FRAMEWORK** (templates, `design-md/`, `boilerplates/`, `specs/_templates`) —
|
|
27
|
-
resolvidos por `__dirname`, porque viajam dentro do pacote.
|
|
28
|
-
- **`projectRoot = process.cwd()` = o PROJETO do usuário** (`.context/`, `specs/`, `memory/`,
|
|
29
|
-
`.memoryrc.json`, briefs) — onde o comando foi invocado.
|
|
30
|
-
|
|
31
|
-
Cravar `__dirname/..` para uma superfície do projeto é o bug; cravar `cwd` para um recurso do
|
|
32
|
-
framework é o bug espelhado. O nome da variável passa a **declarar** o papel — some o `root`
|
|
33
|
-
ambíguo que dava para ler dos dois jeitos.
|
|
34
|
-
|
|
35
|
-
A regra vira **invariante que roda**: o gate `consumer-project-surfaces` (em `release:check`) empacota,
|
|
36
|
-
instala isolado e EXECUTA `gsd:plan` + `context:budget` no cwd do consumidor, conferindo que o runbook
|
|
37
|
-
cai em `<cwd>/.context/` e que o budget o encontra de lá. Testemunha cruzada e independente do banco.
|
|
38
|
-
|
|
39
|
-
## Alternativas consideradas
|
|
40
|
-
- **Só corrigir os dois novos offenders** — rejeitada: é o caso-a-caso que deixou a classe reabrir.
|
|
41
|
-
- **Um único `root` esperto (heurística cwd-vs-pacote)** — rejeitada: a ambiguidade É o bug; dois
|
|
42
|
-
nomes explícitos custam nada e removem a decisão do call site.
|
|
43
|
-
- **Gate só a nível de fonte (grep de `__dirname`)** — rejeitada como suficiente: `__dirname` é
|
|
44
|
-
legítimo para recursos do framework; só EXECUTAR no mundo do consumidor separa certo de errado.
|
|
45
|
-
|
|
46
|
-
## Consequências
|
|
47
|
-
|
|
48
|
-
**Positivas**:
|
|
49
|
-
- `gsd:*`, `context:*`, `design:check` passam a operar no projeto do consumidor, como já faziam
|
|
50
|
-
`spec:new`/`project:check`.
|
|
51
|
-
- A classe inteira ganha um gate que a reprova antes do publish — não depende de um consumidor relatar.
|
|
52
|
-
- O código fica auto-documentado: `projectRoot` vs `root` diz o papel sem comentário.
|
|
53
|
-
|
|
54
|
-
**Negativas / Trade-offs**:
|
|
55
|
-
- `catalog:*` (varre `boilerplates/`/`design-md/` do framework) só faz sentido rodado do repo; no
|
|
56
|
-
pacote publicado é inócuo — aceitável, é comando de manutenção, não de consumidor.
|
|
57
|
-
- O gate custa um `npm pack` + install por corrida de `release:check` (já era o caso dos outros dois).
|
|
58
|
-
|
|
59
|
-
## Rastreamento
|
|
60
|
-
- Implementação: `scripts/agent-harness.ts`, `scripts/context-ops.ts`, `lib/core/release.ts`
|
|
61
|
-
(`consumerProjectSurfaces`), `test/consumer-project-surfaces.test.js`
|
|
62
|
-
- ADRs relacionadas: ADR-0021 (invariante > disciplina), ADR-0026 (dual-runtime TS), ADR-0031 (motor
|
|
63
|
-
de orquestração — a corrida que o bug do `project:check` travou)
|
|
1
|
+
# ADR-0032: superfícies do projeto usam `cwd`; recursos do framework usam `__dirname`
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-22
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: cli, consumer, dist, invariants, release-gate
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
Uma mesma classe de bug voltou quatro vezes: um comando funciona no repo do framework (onde `cwd`
|
|
11
|
+
e `__dirname/..` coincidem) e quebra no pacote **publicado** de um consumidor, porque resolve as
|
|
12
|
+
superfícies do projeto do usuário por `__dirname`, apontando para `node_modules/forjajs/dist`.
|
|
13
|
+
Já mordeu `spec:new` (v1.6.2, escrevia dentro do pacote), `project:upgrade` (v1.6.0, extensão `.ts`
|
|
14
|
+
cravada) e `project:check` (v1.7.1, auditava o pacote — travou uma corrida do `orchestrate`).
|
|
15
|
+
|
|
16
|
+
Corrigir caso a caso não fecha a classe. Uma auditoria sistemática dos comandos consumer-facing
|
|
17
|
+
revelou **mais três instâncias vivas**, todas escondidas atrás de um `const root = __dirname/..` que
|
|
18
|
+
misturava dois papéis: em `agent-harness` o `gsd:*`/`design:check` gravavam/liam no pacote; em
|
|
19
|
+
`context-ops` o `cmdBudget` resolvia o alvo e o guardrail de travessia contra o pacote. `sprint-manager`
|
|
20
|
+
saiu limpo — ele opera pelo workspace (`resolveProject`/`getWorkspaceRoot`, caminhos absolutos).
|
|
21
|
+
|
|
22
|
+
## Decisão
|
|
23
|
+
|
|
24
|
+
Todo script separa **dois papéis de raiz**, com nomes distintos:
|
|
25
|
+
|
|
26
|
+
- **`root` = recursos do FRAMEWORK** (templates, `design-md/`, `boilerplates/`, `specs/_templates`) —
|
|
27
|
+
resolvidos por `__dirname`, porque viajam dentro do pacote.
|
|
28
|
+
- **`projectRoot = process.cwd()` = o PROJETO do usuário** (`.context/`, `specs/`, `memory/`,
|
|
29
|
+
`.memoryrc.json`, briefs) — onde o comando foi invocado.
|
|
30
|
+
|
|
31
|
+
Cravar `__dirname/..` para uma superfície do projeto é o bug; cravar `cwd` para um recurso do
|
|
32
|
+
framework é o bug espelhado. O nome da variável passa a **declarar** o papel — some o `root`
|
|
33
|
+
ambíguo que dava para ler dos dois jeitos.
|
|
34
|
+
|
|
35
|
+
A regra vira **invariante que roda**: o gate `consumer-project-surfaces` (em `release:check`) empacota,
|
|
36
|
+
instala isolado e EXECUTA `gsd:plan` + `context:budget` no cwd do consumidor, conferindo que o runbook
|
|
37
|
+
cai em `<cwd>/.context/` e que o budget o encontra de lá. Testemunha cruzada e independente do banco.
|
|
38
|
+
|
|
39
|
+
## Alternativas consideradas
|
|
40
|
+
- **Só corrigir os dois novos offenders** — rejeitada: é o caso-a-caso que deixou a classe reabrir.
|
|
41
|
+
- **Um único `root` esperto (heurística cwd-vs-pacote)** — rejeitada: a ambiguidade É o bug; dois
|
|
42
|
+
nomes explícitos custam nada e removem a decisão do call site.
|
|
43
|
+
- **Gate só a nível de fonte (grep de `__dirname`)** — rejeitada como suficiente: `__dirname` é
|
|
44
|
+
legítimo para recursos do framework; só EXECUTAR no mundo do consumidor separa certo de errado.
|
|
45
|
+
|
|
46
|
+
## Consequências
|
|
47
|
+
|
|
48
|
+
**Positivas**:
|
|
49
|
+
- `gsd:*`, `context:*`, `design:check` passam a operar no projeto do consumidor, como já faziam
|
|
50
|
+
`spec:new`/`project:check`.
|
|
51
|
+
- A classe inteira ganha um gate que a reprova antes do publish — não depende de um consumidor relatar.
|
|
52
|
+
- O código fica auto-documentado: `projectRoot` vs `root` diz o papel sem comentário.
|
|
53
|
+
|
|
54
|
+
**Negativas / Trade-offs**:
|
|
55
|
+
- `catalog:*` (varre `boilerplates/`/`design-md/` do framework) só faz sentido rodado do repo; no
|
|
56
|
+
pacote publicado é inócuo — aceitável, é comando de manutenção, não de consumidor.
|
|
57
|
+
- O gate custa um `npm pack` + install por corrida de `release:check` (já era o caso dos outros dois).
|
|
58
|
+
|
|
59
|
+
## Rastreamento
|
|
60
|
+
- Implementação: `scripts/agent-harness.ts`, `scripts/context-ops.ts`, `lib/core/release.ts`
|
|
61
|
+
(`consumerProjectSurfaces`), `test/consumer-project-surfaces.test.js`
|
|
62
|
+
- ADRs relacionadas: ADR-0021 (invariante > disciplina), ADR-0026 (dual-runtime TS), ADR-0031 (motor
|
|
63
|
+
de orquestração — a corrida que o bug do `project:check` travou)
|