forjajs 2.0.4 → 4.0.0
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 +19 -25
- package/.claude/agents/governance.md +19 -55
- package/.claude/agents/marketing.md +19 -24
- package/.claude/agents/orchestrator.md +19 -31
- package/.claude/agents/product.md +19 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +19 -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 +93 -87
- package/.github/copilot-instructions.md +93 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +93 -87
- package/AGENTS.md +137 -134
- package/CHANGELOG.md +656 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +68 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -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/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +17 -1
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/release.js +3 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/llm/codex-output.d.ts +12 -0
- package/dist/lib/llm/codex-output.js +56 -0
- package/dist/lib/llm/context.d.ts +5 -0
- package/dist/lib/llm/context.js +17 -0
- package/dist/lib/llm/session.d.ts +18 -0
- package/dist/lib/llm/session.js +34 -0
- package/dist/lib/llm/validation.d.ts +37 -0
- package/dist/lib/llm/validation.js +88 -0
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/evals/src/index.js +6 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.d.ts +8 -1
- package/dist/packages/llm/src/index.js +64 -7
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- 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/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +85 -9
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- 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/agent-operating-contract.md +26 -0
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- 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-evolution.md +51 -0
- package/docs/llm-fit-loop.md +134 -5
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- 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/publishing.md +49 -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 +20 -20
- 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/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/0080-llm-execution-evidence.md +42 -0
- package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +159 -157
- package/prompts/context-engineer-agent.md +13 -19
- package/prompts/governance-agent.md +13 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +13 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +13 -20
- package/skills/MANIFEST.json +10 -0
- package/skills/llm-provider-routing/SKILL.md +18 -0
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +50 -43
- package/specs/_templates/spec.md +50 -43
- package/specs/_templates/tasks.md +39 -32
- package/specs/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-instructions-v4/plan.md +8 -0
- package/specs/agent-instructions-v4/spec.md +21 -0
- package/specs/agent-instructions-v4/tasks.md +12 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- 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/cost-aware-autonomy-budget/spec.md +102 -0
- 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/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- 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/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/llm-integration-v2/plan.md +55 -0
- package/specs/llm-integration-v2/spec.md +61 -0
- package/specs/llm-integration-v2/tasks.md +28 -0
- package/specs/llm-resume-validation/plan.md +50 -0
- package/specs/llm-resume-validation/spec.md +35 -0
- package/specs/llm-resume-validation/tasks.md +19 -0
- 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/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- 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/spec.md +23 -23
- 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/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,111 +1,111 @@
|
|
|
1
|
-
# ADR-0021: Guardrails de harness e dependência de runtime explícita
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-09
|
|
5
|
-
- **Autor(es)**: Allan Pablo
|
|
6
|
-
- **Tags**: harness, hooks, npm, memory, governance
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
Três falhas silenciosas foram encontradas com o framework já publicado como `forjajs` no npm.
|
|
11
|
-
As três compartilham a mesma natureza: **erram sem avisar**. Nenhuma quebrava um teste,
|
|
12
|
-
nenhuma aparecia no `git status`, e todas produziam trabalho errado com aparência de trabalho certo.
|
|
13
|
-
|
|
14
|
-
1. **`.mcp.json` com path absoluto obsoleto.** O codegraph era iniciado com
|
|
15
|
-
`-p /home/apk/.../2-Projeto-Agents/projects/forja`, uma cópia parada no commit `282c265`
|
|
16
|
-
(anterior ao ADR-0020). Consequência: `bin/forja.mjs` e `lib/core/` — o core inteiro que o
|
|
17
|
-
`CLAUDE.md` manda todo agente usar — eram invisíveis ao índice. Qualquer `codegraph_explore`
|
|
18
|
-
respondia sobre código morto, com confiança. O path também era versionado, quebrando para
|
|
19
|
-
qualquer outro contribuidor.
|
|
20
|
-
|
|
21
|
-
2. **`better-sqlite3` como `devDependency`.** Dez scripts sob `files[]` a importam
|
|
22
|
-
estaticamente, e o pacote declarava zero `dependencies`. Numa instalação limpa
|
|
23
|
-
(`npm i -g forjajs`), `query:universal`, `sync:universal`, `context:smart`, `agent:route`,
|
|
24
|
-
`memory:compress` e `project:dashboard` estouravam com `ERR_MODULE_NOT_FOUND`. O `forja`
|
|
25
|
-
sem argumentos funcionava — o help não carrega os scripts — o que mascarava a quebra.
|
|
26
|
-
|
|
27
|
-
3. **Regras de repositório existiam só como prosa.** `projects/` é declarado off-limits no
|
|
28
|
-
`CLAUDE.md`, e a invariante do ADR-0020 ("comando novo = entrada no registry") era validada
|
|
29
|
-
apenas no pre-commit via lefthook, que é opt-in. Ambas dependiam de a IA lembrar. Uma regra
|
|
30
|
-
que depende de memória não é uma regra; é uma sugestão.
|
|
31
|
-
|
|
32
|
-
4. **Índice FTS5 cruzado com o conteúdo errado.** `sync-universal-memory.js` obtinha o id do nó
|
|
33
|
-
recém-gravado via `result.lastInsertRowid || SELECT id ...`. Num `INSERT ... ON CONFLICT DO
|
|
34
|
-
UPDATE` que *atualiza*, o SQLite não redefine `lastInsertRowid` — mantém o id do último INSERT
|
|
35
|
-
da conexão. Sendo truthy, o fallback nunca disparava. Toda execução com um insert seguido de
|
|
36
|
-
updates gravava o conteúdo de um documento sob o `node_id` de outro. Efeito medido: o ADR-0021
|
|
37
|
-
indexado com o corpo de "Harnesses: Hermes e GSD"; `query:universal "registry"` não encontrava
|
|
38
|
-
o ADR-0020; 135 linhas órfãs acumuladas. Como `query:universal` é o **primeiro passo** da
|
|
39
|
-
economia de tokens do ADR-0009, o framework vinha alimentando os agentes com o documento
|
|
40
|
-
errado — sem erro, sem log, sem sintoma.
|
|
41
|
-
|
|
42
|
-
## Decisão
|
|
43
|
-
|
|
44
|
-
Mover a aplicação das regras do texto para o harness, e a verificação da publicação da leitura
|
|
45
|
-
para a execução.
|
|
46
|
-
|
|
47
|
-
- **`.mcp.json` sem `-p`.** Em modo MCP o codegraph resolve o projeto pelo `rootUri` do cliente.
|
|
48
|
-
Remover o path elimina a classe inteira de erro em vez de corrigir uma instância.
|
|
49
|
-
- **`better-sqlite3` em `dependencies`.** É dependência de runtime; era só declaração errada.
|
|
50
|
-
- **`PreToolUse` → `scripts/hook-guard-paths.mjs`.** Bloqueia escrita em `projects/` e
|
|
51
|
-
`docs/archive/` com exit 2, devolvendo o motivo e a alternativa. Falha aberta.
|
|
52
|
-
- **`PostToolUse` → `scripts/hook-post-edit.mjs`.** Ao editar `lib/core/registry.mjs` ou
|
|
53
|
-
`package.json`, roda `test/forja-core.test.js` na hora. A quebra chega junto da edição que
|
|
54
|
-
a causou, não commits depois.
|
|
55
|
-
- **`SessionStart` resiliente e honesto.** Todo acesso a SQLite passa a ser lazy — o hook
|
|
56
|
-
degradava para stack trace sem `node_modules`. Além disso, passa a avisar quando `memory/`
|
|
57
|
-
mudou depois do último `sync:universal`: índice defasado é a versão local do problema (1).
|
|
58
|
-
- **`RETURNING id` no upsert de `memory_nodes`.** Devolve a linha realmente afetada, inserida ou
|
|
59
|
-
atualizada, eliminando a dependência de `lastInsertRowid`. O sync passa a purgar linhas órfãs
|
|
60
|
-
do `search_idx` ao final, e o `title` volta a ser atualizado no conflito.
|
|
61
|
-
- **Subagent `release-auditor`.** Audita o pacote instalando o tarball de verdade e exercitando
|
|
62
|
-
comandos reais. Proibido aprovar por leitura de código. Exige árvore git limpa antes e depois:
|
|
63
|
-
`npm publish` empacota o **disco**, não o commit, e sua aprovação é perecível. A v1.1.1 saiu
|
|
64
|
-
publicada com `otplib` e `qrcode` em `dependencies` — instalados na árvore de trabalho para
|
|
65
|
-
gerar o código OTP do 2FA, nunca commitados, nunca importados por linha alguma do projeto.
|
|
66
|
-
A auditoria havia passado minutos antes, sobre um disco que deixou de existir.
|
|
67
|
-
- **Skills `new-adr` e `new-command`.** Os dois rituais do repo viram etapas executáveis.
|
|
68
|
-
|
|
69
|
-
## Alternativas consideradas
|
|
70
|
-
|
|
71
|
-
- **Path relativo (`-p .`) no `.mcp.json`** — rejeitada porque ainda depende do `cwd` do processo
|
|
72
|
-
do servidor, que não é contratual. Omitir a flag delega ao protocolo, que é.
|
|
73
|
-
- **`better-sqlite3` como `optionalDependency` com degradação** — rejeitada porque a memória
|
|
74
|
-
hierárquica com FTS5 é a proposta central do Forja, não um extra. Um `forjajs` sem memória
|
|
75
|
-
não é uma instalação degradada; é uma instalação errada.
|
|
76
|
-
- **Manter as regras no `CLAUDE.md` e confiar na leitura do agente** — rejeitada por evidência:
|
|
77
|
-
as regras já estavam escritas e ainda assim o índice ficou apontando para a árvore errada por
|
|
78
|
-
mais de uma semana.
|
|
79
|
-
- **Rodar a suíte inteira no `PostToolUse`** — rejeitada por custo. O gate é `forja-core.test.js`,
|
|
80
|
-
um arquivo, poucos segundos. Um hook lento é um hook que alguém desliga.
|
|
81
|
-
- **Reconstruir o `search_idx` do zero a cada sync** — rejeitada porque esconderia a causa. O
|
|
82
|
-
índice ficaria correto sem que o upsert deixasse de devolver o id errado, e o próximo consumidor
|
|
83
|
-
de `lastInsertRowid` reencontraria o mesmo bug.
|
|
84
|
-
|
|
85
|
-
## Consequências
|
|
86
|
-
|
|
87
|
-
**Positivas**:
|
|
88
|
-
- O pacote publicado passa a funcionar numa instalação limpa — verificado via `npm pack` + install.
|
|
89
|
-
- `query:universal` volta a devolver o documento que casou com a busca. Medido: 709 pares
|
|
90
|
-
título↔conteúdo alinhados, 0 cruzados, 0 órfãos (antes: 3 cruzados, 135 órfãos).
|
|
91
|
-
- Violações de `projects/` e do registry tornam-se impossíveis, não improváveis.
|
|
92
|
-
- O índice de memória defasado passa a se anunciar em vez de responder errado calado.
|
|
93
|
-
- Contribuidores externos clonam e o codegraph indexa o repo certo, sem editar nada.
|
|
94
|
-
|
|
95
|
-
**Negativas / Trade-offs**:
|
|
96
|
-
- `npm i forjajs` agora compila/baixa um módulo nativo (`better-sqlite3`): instalação mais lenta
|
|
97
|
-
e sujeita a prebuilds por plataforma. É o preço de o produto funcionar.
|
|
98
|
-
- O hook `PostToolUse` acrescenta poucos segundos a cada edição de `registry.mjs` ou `package.json`.
|
|
99
|
-
- Guardrails têm escape hatch (`FORJA_GUARD=0`, `FORJA_HOOK_TEST=0`). Um guard sem escape vira
|
|
100
|
-
um guard contornado por caminhos piores.
|
|
101
|
-
- `.claude/skills/` entra em `files[]`, aumentando o tarball.
|
|
102
|
-
|
|
103
|
-
## Rastreamento
|
|
104
|
-
- Implementação: `.mcp.json`, `package.json`, `.claude/settings.json`,
|
|
105
|
-
`scripts/sync-universal-memory.js`, `scripts/hook-guard-paths.mjs`, `scripts/hook-post-edit.mjs`,
|
|
106
|
-
`scripts/hook-session-start.mjs`, `.claude/agents/release-auditor.md`,
|
|
107
|
-
`.claude/skills/new-adr/`, `.claude/skills/new-command/`
|
|
108
|
-
- Testes: `test/hooks.test.js`, `test/memory-index.test.js`
|
|
109
|
-
- ADRs relacionadas: ADR-0009 (economia de tokens — a corrupção do FTS a invalidava na prática),
|
|
110
|
-
ADR-0017 (codegraph no harness), ADR-0018 (ferramentas de processo),
|
|
111
|
-
ADR-0019 (workspace separado), ADR-0020 (forja core CLI única)
|
|
1
|
+
# ADR-0021: Guardrails de harness e dependência de runtime explícita
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-09
|
|
5
|
+
- **Autor(es)**: Allan Pablo
|
|
6
|
+
- **Tags**: harness, hooks, npm, memory, governance
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
Três falhas silenciosas foram encontradas com o framework já publicado como `forjajs` no npm.
|
|
11
|
+
As três compartilham a mesma natureza: **erram sem avisar**. Nenhuma quebrava um teste,
|
|
12
|
+
nenhuma aparecia no `git status`, e todas produziam trabalho errado com aparência de trabalho certo.
|
|
13
|
+
|
|
14
|
+
1. **`.mcp.json` com path absoluto obsoleto.** O codegraph era iniciado com
|
|
15
|
+
`-p /home/apk/.../2-Projeto-Agents/projects/forja`, uma cópia parada no commit `282c265`
|
|
16
|
+
(anterior ao ADR-0020). Consequência: `bin/forja.mjs` e `lib/core/` — o core inteiro que o
|
|
17
|
+
`CLAUDE.md` manda todo agente usar — eram invisíveis ao índice. Qualquer `codegraph_explore`
|
|
18
|
+
respondia sobre código morto, com confiança. O path também era versionado, quebrando para
|
|
19
|
+
qualquer outro contribuidor.
|
|
20
|
+
|
|
21
|
+
2. **`better-sqlite3` como `devDependency`.** Dez scripts sob `files[]` a importam
|
|
22
|
+
estaticamente, e o pacote declarava zero `dependencies`. Numa instalação limpa
|
|
23
|
+
(`npm i -g forjajs`), `query:universal`, `sync:universal`, `context:smart`, `agent:route`,
|
|
24
|
+
`memory:compress` e `project:dashboard` estouravam com `ERR_MODULE_NOT_FOUND`. O `forja`
|
|
25
|
+
sem argumentos funcionava — o help não carrega os scripts — o que mascarava a quebra.
|
|
26
|
+
|
|
27
|
+
3. **Regras de repositório existiam só como prosa.** `projects/` é declarado off-limits no
|
|
28
|
+
`CLAUDE.md`, e a invariante do ADR-0020 ("comando novo = entrada no registry") era validada
|
|
29
|
+
apenas no pre-commit via lefthook, que é opt-in. Ambas dependiam de a IA lembrar. Uma regra
|
|
30
|
+
que depende de memória não é uma regra; é uma sugestão.
|
|
31
|
+
|
|
32
|
+
4. **Índice FTS5 cruzado com o conteúdo errado.** `sync-universal-memory.js` obtinha o id do nó
|
|
33
|
+
recém-gravado via `result.lastInsertRowid || SELECT id ...`. Num `INSERT ... ON CONFLICT DO
|
|
34
|
+
UPDATE` que *atualiza*, o SQLite não redefine `lastInsertRowid` — mantém o id do último INSERT
|
|
35
|
+
da conexão. Sendo truthy, o fallback nunca disparava. Toda execução com um insert seguido de
|
|
36
|
+
updates gravava o conteúdo de um documento sob o `node_id` de outro. Efeito medido: o ADR-0021
|
|
37
|
+
indexado com o corpo de "Harnesses: Hermes e GSD"; `query:universal "registry"` não encontrava
|
|
38
|
+
o ADR-0020; 135 linhas órfãs acumuladas. Como `query:universal` é o **primeiro passo** da
|
|
39
|
+
economia de tokens do ADR-0009, o framework vinha alimentando os agentes com o documento
|
|
40
|
+
errado — sem erro, sem log, sem sintoma.
|
|
41
|
+
|
|
42
|
+
## Decisão
|
|
43
|
+
|
|
44
|
+
Mover a aplicação das regras do texto para o harness, e a verificação da publicação da leitura
|
|
45
|
+
para a execução.
|
|
46
|
+
|
|
47
|
+
- **`.mcp.json` sem `-p`.** Em modo MCP o codegraph resolve o projeto pelo `rootUri` do cliente.
|
|
48
|
+
Remover o path elimina a classe inteira de erro em vez de corrigir uma instância.
|
|
49
|
+
- **`better-sqlite3` em `dependencies`.** É dependência de runtime; era só declaração errada.
|
|
50
|
+
- **`PreToolUse` → `scripts/hook-guard-paths.mjs`.** Bloqueia escrita em `projects/` e
|
|
51
|
+
`docs/archive/` com exit 2, devolvendo o motivo e a alternativa. Falha aberta.
|
|
52
|
+
- **`PostToolUse` → `scripts/hook-post-edit.mjs`.** Ao editar `lib/core/registry.mjs` ou
|
|
53
|
+
`package.json`, roda `test/forja-core.test.js` na hora. A quebra chega junto da edição que
|
|
54
|
+
a causou, não commits depois.
|
|
55
|
+
- **`SessionStart` resiliente e honesto.** Todo acesso a SQLite passa a ser lazy — o hook
|
|
56
|
+
degradava para stack trace sem `node_modules`. Além disso, passa a avisar quando `memory/`
|
|
57
|
+
mudou depois do último `sync:universal`: índice defasado é a versão local do problema (1).
|
|
58
|
+
- **`RETURNING id` no upsert de `memory_nodes`.** Devolve a linha realmente afetada, inserida ou
|
|
59
|
+
atualizada, eliminando a dependência de `lastInsertRowid`. O sync passa a purgar linhas órfãs
|
|
60
|
+
do `search_idx` ao final, e o `title` volta a ser atualizado no conflito.
|
|
61
|
+
- **Subagent `release-auditor`.** Audita o pacote instalando o tarball de verdade e exercitando
|
|
62
|
+
comandos reais. Proibido aprovar por leitura de código. Exige árvore git limpa antes e depois:
|
|
63
|
+
`npm publish` empacota o **disco**, não o commit, e sua aprovação é perecível. A v1.1.1 saiu
|
|
64
|
+
publicada com `otplib` e `qrcode` em `dependencies` — instalados na árvore de trabalho para
|
|
65
|
+
gerar o código OTP do 2FA, nunca commitados, nunca importados por linha alguma do projeto.
|
|
66
|
+
A auditoria havia passado minutos antes, sobre um disco que deixou de existir.
|
|
67
|
+
- **Skills `new-adr` e `new-command`.** Os dois rituais do repo viram etapas executáveis.
|
|
68
|
+
|
|
69
|
+
## Alternativas consideradas
|
|
70
|
+
|
|
71
|
+
- **Path relativo (`-p .`) no `.mcp.json`** — rejeitada porque ainda depende do `cwd` do processo
|
|
72
|
+
do servidor, que não é contratual. Omitir a flag delega ao protocolo, que é.
|
|
73
|
+
- **`better-sqlite3` como `optionalDependency` com degradação** — rejeitada porque a memória
|
|
74
|
+
hierárquica com FTS5 é a proposta central do Forja, não um extra. Um `forjajs` sem memória
|
|
75
|
+
não é uma instalação degradada; é uma instalação errada.
|
|
76
|
+
- **Manter as regras no `CLAUDE.md` e confiar na leitura do agente** — rejeitada por evidência:
|
|
77
|
+
as regras já estavam escritas e ainda assim o índice ficou apontando para a árvore errada por
|
|
78
|
+
mais de uma semana.
|
|
79
|
+
- **Rodar a suíte inteira no `PostToolUse`** — rejeitada por custo. O gate é `forja-core.test.js`,
|
|
80
|
+
um arquivo, poucos segundos. Um hook lento é um hook que alguém desliga.
|
|
81
|
+
- **Reconstruir o `search_idx` do zero a cada sync** — rejeitada porque esconderia a causa. O
|
|
82
|
+
índice ficaria correto sem que o upsert deixasse de devolver o id errado, e o próximo consumidor
|
|
83
|
+
de `lastInsertRowid` reencontraria o mesmo bug.
|
|
84
|
+
|
|
85
|
+
## Consequências
|
|
86
|
+
|
|
87
|
+
**Positivas**:
|
|
88
|
+
- O pacote publicado passa a funcionar numa instalação limpa — verificado via `npm pack` + install.
|
|
89
|
+
- `query:universal` volta a devolver o documento que casou com a busca. Medido: 709 pares
|
|
90
|
+
título↔conteúdo alinhados, 0 cruzados, 0 órfãos (antes: 3 cruzados, 135 órfãos).
|
|
91
|
+
- Violações de `projects/` e do registry tornam-se impossíveis, não improváveis.
|
|
92
|
+
- O índice de memória defasado passa a se anunciar em vez de responder errado calado.
|
|
93
|
+
- Contribuidores externos clonam e o codegraph indexa o repo certo, sem editar nada.
|
|
94
|
+
|
|
95
|
+
**Negativas / Trade-offs**:
|
|
96
|
+
- `npm i forjajs` agora compila/baixa um módulo nativo (`better-sqlite3`): instalação mais lenta
|
|
97
|
+
e sujeita a prebuilds por plataforma. É o preço de o produto funcionar.
|
|
98
|
+
- O hook `PostToolUse` acrescenta poucos segundos a cada edição de `registry.mjs` ou `package.json`.
|
|
99
|
+
- Guardrails têm escape hatch (`FORJA_GUARD=0`, `FORJA_HOOK_TEST=0`). Um guard sem escape vira
|
|
100
|
+
um guard contornado por caminhos piores.
|
|
101
|
+
- `.claude/skills/` entra em `files[]`, aumentando o tarball.
|
|
102
|
+
|
|
103
|
+
## Rastreamento
|
|
104
|
+
- Implementação: `.mcp.json`, `package.json`, `.claude/settings.json`,
|
|
105
|
+
`scripts/sync-universal-memory.js`, `scripts/hook-guard-paths.mjs`, `scripts/hook-post-edit.mjs`,
|
|
106
|
+
`scripts/hook-session-start.mjs`, `.claude/agents/release-auditor.md`,
|
|
107
|
+
`.claude/skills/new-adr/`, `.claude/skills/new-command/`
|
|
108
|
+
- Testes: `test/hooks.test.js`, `test/memory-index.test.js`
|
|
109
|
+
- ADRs relacionadas: ADR-0009 (economia de tokens — a corrupção do FTS a invalidava na prática),
|
|
110
|
+
ADR-0017 (codegraph no harness), ADR-0018 (ferramentas de processo),
|
|
111
|
+
ADR-0019 (workspace separado), ADR-0020 (forja core CLI única)
|
|
@@ -1,101 +1,101 @@
|
|
|
1
|
-
# ADR-0022: Congelar o dashboard web
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-09
|
|
5
|
-
- **Autor(es)**: apk
|
|
6
|
-
- **Tags**: dashboard, cli, release, security, sdd
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
O dashboard web (`dashboard/`, SPEC-002) foi implementado por inteiro: 15 rotas Fastify,
|
|
11
|
-
12 telas React, 68 testes verdes, bundle de 190KB gzip. Entrou no repositório no commit
|
|
12
|
-
`b732e08` ("Forja v1.1 — release público inicial", 2026-07-06) e **nunca recebeu uma única
|
|
13
|
-
iteração** nos 12 commits seguintes. Não foi abandonado após uso — nasceu sem uso.
|
|
14
|
-
|
|
15
|
-
Três problemas concretos motivaram a decisão:
|
|
16
|
-
|
|
17
|
-
1. **Bug de release já publicado.** O `files[]` do `package.json` nunca incluiu `dashboard/`,
|
|
18
|
-
mas incluía `docs/dashboard.md`, e o `package.json` publicado trazia o script
|
|
19
|
-
`"dashboard": "cd dashboard && npm start"`. O `README.md` documentava o comando. Resultado:
|
|
20
|
-
quem instalou o `forja` v1.1.2 do npm recebeu a documentação e o comando, mas não o código.
|
|
21
|
-
O comando quebra. O `release-auditor` não pegou porque valida o que os binários importam,
|
|
22
|
-
não o que a documentação promete.
|
|
23
|
-
|
|
24
|
-
2. **Segunda fonte de verdade para comandos, já divergente.** O ADR-0020 estabeleceu que todo
|
|
25
|
-
comando de processo passa pelo core (`bin/forja.mjs` + `lib/core/registry.mjs`), com gates
|
|
26
|
-
transversais e auditoria em `.context/forja-runs.jsonl`. O dashboard mantém sua própria
|
|
27
|
-
`COMMAND_ALLOWLIST` hard-coded (decisão D4 da SPEC-002, por razões legítimas de segurança).
|
|
28
|
-
Na auditoria de 2026-07-09: o registry tem 41 comandos, a allowlist expõe 11, e
|
|
29
|
-
**`context:build` existe na allowlist mas não no registry** — executa via
|
|
30
|
-
`node scripts/dev.mjs context:build`, contornando os gates e a trilha de auditoria do core.
|
|
31
|
-
Um comando disparado pelo botão do dashboard não aparece na auditoria.
|
|
32
|
-
|
|
33
|
-
3. **A documentação pública descrevia errado a superfície.** O `README.md` chamava o dashboard
|
|
34
|
-
de "visão opcional read-only". Ele expõe `POST /api/workflow/:project/run/:role` (dispara
|
|
35
|
-
execução de papéis), além de mutações em status de specs, notas de projeto e comandos.
|
|
36
|
-
A auditoria de RCE prevista na T12 da SPEC-002 nunca foi executada, e teria coberto apenas
|
|
37
|
-
`/api/commands` — as rotas `workflow` e `stacks` sequer existiam quando aquela task foi escrita.
|
|
38
|
-
|
|
39
|
-
## Decisão
|
|
40
|
-
|
|
41
|
-
**Congelar o dashboard.** O código permanece em `dashboard/`, versionado e com os testes
|
|
42
|
-
passando, mas deixa de ser superfície pública e de ser tratado como parte do produto:
|
|
43
|
-
|
|
44
|
-
- `docs/dashboard.md` e `specs/agent-dashboard/` saem do `files[]` do pacote npm.
|
|
45
|
-
- Os cinco scripts `dashboard*` saem do `package.json` do root (o `package.json` é publicado
|
|
46
|
-
inteiro; não há como ter script "só local").
|
|
47
|
-
- `README.md` e `DOC-MAP.md` deixam de prometer o dashboard ao usuário do npm.
|
|
48
|
-
- SPEC-002 passa a `abandoned`. O status `parked` não existe no `spec-cli`
|
|
49
|
-
(`draft|review|approved|implementing|done|abandoned`), e `abandoned` é o único que não mente.
|
|
50
|
-
|
|
51
|
-
**Não unificar `registry` ↔ `allowlist` agora.** Era o caminho tecnicamente correto se o
|
|
52
|
-
dashboard tivesse futuro. Sem consumidor, seria infraestrutura elegante sustentando código
|
|
53
|
-
que ninguém roda. O `context:build` fantasma deixa de causar dano ao ser congelado junto.
|
|
54
|
-
|
|
55
|
-
## Alternativas consideradas
|
|
56
|
-
|
|
57
|
-
- **Arquivar de vez** (mover para `docs/archive/`, fechar a spec como wontfix) — rejeitada
|
|
58
|
-
porque descarta 69 arquivos funcionais e testados por uma decisão reversível. O custo de
|
|
59
|
-
manter o código parado no repo é próximo de zero, uma vez removido das superfícies públicas.
|
|
60
|
-
- **Reviver: derivar a allowlist do registry** (campo `exposedToDashboard` + schema de args,
|
|
61
|
-
publicar `dashboard/` no `files[]`, auditar `workflow`/`stacks`) — rejeitada *por ora*
|
|
62
|
-
porque o dashboard nunca teve um usuário. Construir a infraestrutura antes da demanda inverte
|
|
63
|
-
a ordem. Continua sendo o caminho certo **se** a demanda aparecer; ver "Condições de retomada".
|
|
64
|
-
- **Manter como está** — rejeitada porque deixa um comando quebrado publicado no npm e um
|
|
65
|
-
bypass da auditoria do ADR-0020 em pé.
|
|
66
|
-
|
|
67
|
-
## Consequências
|
|
68
|
-
|
|
69
|
-
**Positivas**:
|
|
70
|
-
- O pacote npm para de prometer um comando que não funciona.
|
|
71
|
-
- Some a segunda fonte de verdade para comandos; o `bin/forja.mjs` volta a ser a única.
|
|
72
|
-
- O bypass de auditoria do `context:build` deixa de ser alcançável.
|
|
73
|
-
- A documentação pública passa a descrever a realidade (CLI-first, sem front).
|
|
74
|
-
- Zero manutenção contínua: o código congelado não drifta porque não é superfície.
|
|
75
|
-
|
|
76
|
-
**Negativas / Trade-offs**:
|
|
77
|
-
- 69 arquivos funcionais ficam parados no repositório. É dívida visível, mas inerte.
|
|
78
|
-
- Quem clonar o repo vê uma pasta `dashboard/` sem entrada óbvia; mitigado por
|
|
79
|
-
`dashboard/README.md` explicando o estado e como subir manualmente.
|
|
80
|
-
- Se a demanda por uma interface visual voltar, parte do trabalho de reconciliação
|
|
81
|
-
(rotas novas × allowlist × registry) terá crescido no intervalo.
|
|
82
|
-
|
|
83
|
-
## Condições de retomada
|
|
84
|
-
|
|
85
|
-
Descongelar exige, nesta ordem:
|
|
86
|
-
|
|
87
|
-
1. Um usuário real e um caso de uso que o CLI não atenda. Sem isso, não retomar.
|
|
88
|
-
2. Derivar a allowlist do registry — comando novo entra em `lib/core/registry.mjs` com
|
|
89
|
-
`exposedToDashboard: true` e schema de args declarado. Preserva a garantia do D4
|
|
90
|
-
(nada dinâmico, nada de regex, tudo em código) e mata a classe de bugs de sincronização.
|
|
91
|
-
3. Auditoria de segurança das rotas mutáveis, com escopo explícito em `/api/commands`,
|
|
92
|
-
`/api/workflow/:project/run/:role` e `/api/stacks` — não apenas a primeira, como previa a T12.
|
|
93
|
-
4. Incluir `dashboard/` no `files[]` **antes** de voltar a documentá-lo publicamente.
|
|
94
|
-
|
|
95
|
-
## Rastreamento
|
|
96
|
-
|
|
97
|
-
- Implementação congelada: `dashboard/` (15 rotas, 12 telas, 68 testes)
|
|
98
|
-
- Spec: `specs/agent-dashboard/` (status `abandoned`)
|
|
99
|
-
- Docs: `docs/dashboard.md` (mantido no repo, fora do tarball)
|
|
100
|
-
- ADRs relacionadas: ADR-0020 (core CLI única — cuja fronteira o dashboard violava),
|
|
101
|
-
ADR-0021 (guardrails de harness)
|
|
1
|
+
# ADR-0022: Congelar o dashboard web
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-09
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: dashboard, cli, release, security, sdd
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
O dashboard web (`dashboard/`, SPEC-002) foi implementado por inteiro: 15 rotas Fastify,
|
|
11
|
+
12 telas React, 68 testes verdes, bundle de 190KB gzip. Entrou no repositório no commit
|
|
12
|
+
`b732e08` ("Forja v1.1 — release público inicial", 2026-07-06) e **nunca recebeu uma única
|
|
13
|
+
iteração** nos 12 commits seguintes. Não foi abandonado após uso — nasceu sem uso.
|
|
14
|
+
|
|
15
|
+
Três problemas concretos motivaram a decisão:
|
|
16
|
+
|
|
17
|
+
1. **Bug de release já publicado.** O `files[]` do `package.json` nunca incluiu `dashboard/`,
|
|
18
|
+
mas incluía `docs/dashboard.md`, e o `package.json` publicado trazia o script
|
|
19
|
+
`"dashboard": "cd dashboard && npm start"`. O `README.md` documentava o comando. Resultado:
|
|
20
|
+
quem instalou o `forja` v1.1.2 do npm recebeu a documentação e o comando, mas não o código.
|
|
21
|
+
O comando quebra. O `release-auditor` não pegou porque valida o que os binários importam,
|
|
22
|
+
não o que a documentação promete.
|
|
23
|
+
|
|
24
|
+
2. **Segunda fonte de verdade para comandos, já divergente.** O ADR-0020 estabeleceu que todo
|
|
25
|
+
comando de processo passa pelo core (`bin/forja.mjs` + `lib/core/registry.mjs`), com gates
|
|
26
|
+
transversais e auditoria em `.context/forja-runs.jsonl`. O dashboard mantém sua própria
|
|
27
|
+
`COMMAND_ALLOWLIST` hard-coded (decisão D4 da SPEC-002, por razões legítimas de segurança).
|
|
28
|
+
Na auditoria de 2026-07-09: o registry tem 41 comandos, a allowlist expõe 11, e
|
|
29
|
+
**`context:build` existe na allowlist mas não no registry** — executa via
|
|
30
|
+
`node scripts/dev.mjs context:build`, contornando os gates e a trilha de auditoria do core.
|
|
31
|
+
Um comando disparado pelo botão do dashboard não aparece na auditoria.
|
|
32
|
+
|
|
33
|
+
3. **A documentação pública descrevia errado a superfície.** O `README.md` chamava o dashboard
|
|
34
|
+
de "visão opcional read-only". Ele expõe `POST /api/workflow/:project/run/:role` (dispara
|
|
35
|
+
execução de papéis), além de mutações em status de specs, notas de projeto e comandos.
|
|
36
|
+
A auditoria de RCE prevista na T12 da SPEC-002 nunca foi executada, e teria coberto apenas
|
|
37
|
+
`/api/commands` — as rotas `workflow` e `stacks` sequer existiam quando aquela task foi escrita.
|
|
38
|
+
|
|
39
|
+
## Decisão
|
|
40
|
+
|
|
41
|
+
**Congelar o dashboard.** O código permanece em `dashboard/`, versionado e com os testes
|
|
42
|
+
passando, mas deixa de ser superfície pública e de ser tratado como parte do produto:
|
|
43
|
+
|
|
44
|
+
- `docs/dashboard.md` e `specs/agent-dashboard/` saem do `files[]` do pacote npm.
|
|
45
|
+
- Os cinco scripts `dashboard*` saem do `package.json` do root (o `package.json` é publicado
|
|
46
|
+
inteiro; não há como ter script "só local").
|
|
47
|
+
- `README.md` e `DOC-MAP.md` deixam de prometer o dashboard ao usuário do npm.
|
|
48
|
+
- SPEC-002 passa a `abandoned`. O status `parked` não existe no `spec-cli`
|
|
49
|
+
(`draft|review|approved|implementing|done|abandoned`), e `abandoned` é o único que não mente.
|
|
50
|
+
|
|
51
|
+
**Não unificar `registry` ↔ `allowlist` agora.** Era o caminho tecnicamente correto se o
|
|
52
|
+
dashboard tivesse futuro. Sem consumidor, seria infraestrutura elegante sustentando código
|
|
53
|
+
que ninguém roda. O `context:build` fantasma deixa de causar dano ao ser congelado junto.
|
|
54
|
+
|
|
55
|
+
## Alternativas consideradas
|
|
56
|
+
|
|
57
|
+
- **Arquivar de vez** (mover para `docs/archive/`, fechar a spec como wontfix) — rejeitada
|
|
58
|
+
porque descarta 69 arquivos funcionais e testados por uma decisão reversível. O custo de
|
|
59
|
+
manter o código parado no repo é próximo de zero, uma vez removido das superfícies públicas.
|
|
60
|
+
- **Reviver: derivar a allowlist do registry** (campo `exposedToDashboard` + schema de args,
|
|
61
|
+
publicar `dashboard/` no `files[]`, auditar `workflow`/`stacks`) — rejeitada *por ora*
|
|
62
|
+
porque o dashboard nunca teve um usuário. Construir a infraestrutura antes da demanda inverte
|
|
63
|
+
a ordem. Continua sendo o caminho certo **se** a demanda aparecer; ver "Condições de retomada".
|
|
64
|
+
- **Manter como está** — rejeitada porque deixa um comando quebrado publicado no npm e um
|
|
65
|
+
bypass da auditoria do ADR-0020 em pé.
|
|
66
|
+
|
|
67
|
+
## Consequências
|
|
68
|
+
|
|
69
|
+
**Positivas**:
|
|
70
|
+
- O pacote npm para de prometer um comando que não funciona.
|
|
71
|
+
- Some a segunda fonte de verdade para comandos; o `bin/forja.mjs` volta a ser a única.
|
|
72
|
+
- O bypass de auditoria do `context:build` deixa de ser alcançável.
|
|
73
|
+
- A documentação pública passa a descrever a realidade (CLI-first, sem front).
|
|
74
|
+
- Zero manutenção contínua: o código congelado não drifta porque não é superfície.
|
|
75
|
+
|
|
76
|
+
**Negativas / Trade-offs**:
|
|
77
|
+
- 69 arquivos funcionais ficam parados no repositório. É dívida visível, mas inerte.
|
|
78
|
+
- Quem clonar o repo vê uma pasta `dashboard/` sem entrada óbvia; mitigado por
|
|
79
|
+
`dashboard/README.md` explicando o estado e como subir manualmente.
|
|
80
|
+
- Se a demanda por uma interface visual voltar, parte do trabalho de reconciliação
|
|
81
|
+
(rotas novas × allowlist × registry) terá crescido no intervalo.
|
|
82
|
+
|
|
83
|
+
## Condições de retomada
|
|
84
|
+
|
|
85
|
+
Descongelar exige, nesta ordem:
|
|
86
|
+
|
|
87
|
+
1. Um usuário real e um caso de uso que o CLI não atenda. Sem isso, não retomar.
|
|
88
|
+
2. Derivar a allowlist do registry — comando novo entra em `lib/core/registry.mjs` com
|
|
89
|
+
`exposedToDashboard: true` e schema de args declarado. Preserva a garantia do D4
|
|
90
|
+
(nada dinâmico, nada de regex, tudo em código) e mata a classe de bugs de sincronização.
|
|
91
|
+
3. Auditoria de segurança das rotas mutáveis, com escopo explícito em `/api/commands`,
|
|
92
|
+
`/api/workflow/:project/run/:role` e `/api/stacks` — não apenas a primeira, como previa a T12.
|
|
93
|
+
4. Incluir `dashboard/` no `files[]` **antes** de voltar a documentá-lo publicamente.
|
|
94
|
+
|
|
95
|
+
## Rastreamento
|
|
96
|
+
|
|
97
|
+
- Implementação congelada: `dashboard/` (15 rotas, 12 telas, 68 testes)
|
|
98
|
+
- Spec: `specs/agent-dashboard/` (status `abandoned`)
|
|
99
|
+
- Docs: `docs/dashboard.md` (mantido no repo, fora do tarball)
|
|
100
|
+
- ADRs relacionadas: ADR-0020 (core CLI única — cuja fronteira o dashboard violava),
|
|
101
|
+
ADR-0021 (guardrails de harness)
|