forjajs 2.0.2 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -317
- package/README.pt-BR.md +345 -323
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.d.ts +1 -0
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -140
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
package/specs/forja-core/spec.md
CHANGED
|
@@ -1,71 +1,71 @@
|
|
|
1
|
-
# Spec: forja-core
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-025
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: framework-team
|
|
6
|
-
- **Criado em**: 2026-07-06
|
|
7
|
-
- **Sprint alvo**: core-2026-07
|
|
8
|
-
- **ADRs relacionadas**: ADR-0020 (core CLI única), ADR-0019 (workspace separado), ADR-0005 (handoff 7 campos), ADR-0017 (codegraph no GSD)
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
O Forja se apresenta como framework de orquestração, mas os comandos não passam por um núcleo comum. Hoje existem **três dispatchers paralelos**:
|
|
12
|
-
|
|
13
|
-
1. `scripts/agent-harness.mjs` — workspace, GSD, design, code intelligence (com gates próprios).
|
|
14
|
-
2. `scripts/dev.mjs` — context, memória, project:health (registry próprio, duplica `design:*`/`gsd:*`).
|
|
15
|
-
3. `package.json` — ~40 scripts npm apontando direto para 15+ scripts soltos (`spec-cli`, `sprint-manager`, `sync-universal-memory`, `context-ops`, …), inclusive com a chave `project:check` **duplicada** (a primeira definição é silenciosamente descartada pelo npm).
|
|
16
|
-
|
|
17
|
-
Consequências mensuráveis:
|
|
18
|
-
- Nenhuma trilha de auditoria unificada: não dá para responder "quais comandos rodaram nesta feature?" sem grep em N lugares.
|
|
19
|
-
- Gates aplicados de forma desigual: `gsd:check` valida codegraph, mas `spec:tasks` e `sprint:start` não validam nada do processo.
|
|
20
|
-
- O workspace (ADR-0019) é resolvido por alguns comandos e ignorado por outros — um comando de produto pode rodar sem workspace e falhar tarde ou agir no lugar errado.
|
|
21
|
-
- Projetos gerados não são registrados em lugar nenhum: `project:new` cria a pasta e termina; a ficha em `memory/30-projects/` depende de disciplina manual.
|
|
22
|
-
|
|
23
|
-
## 2. Proposta de valor
|
|
24
|
-
Uma **CLI única `forja`** (bin/forja.mjs) vira o core executivo do framework: todo comando passa por um registry declarativo, com gates transversais (workspace, processo) e **trilha de auditoria** append-only. Projetos passam pelo core no nascimento (registro automático de ficha no workspace). Os dispatchers existentes viram implementação interna — nada é reescrito, tudo é roteado.
|
|
25
|
-
|
|
26
|
-
## 3. User stories
|
|
27
|
-
- **Como** operador do Forja, **quero** rodar `forja <comando>` (ou `npm run <alias>`) e ter um único ponto de entrada com help agrupado por domínio, **para que** eu não precise decorar qual script implementa o quê.
|
|
28
|
-
- **Como** governance, **quero** que toda execução de comando seja registrada em `.context/forja-runs.jsonl` (comando, args, exit code, duração), **para que** o review de uma feature tenha trilha de auditoria do processo.
|
|
29
|
-
- **Como** operador, **quero** que comandos de produto falhem cedo e com instrução clara quando o workspace não existe, **para que** nada rode no lugar errado (ADR-0019).
|
|
30
|
-
- **Como** orchestrator, **quero** que `project:new` registre automaticamente a ficha do projeto em `memory/30-projects/` do workspace, **para que** todo projeto nasça rastreado pelo core.
|
|
31
|
-
|
|
32
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
33
|
-
- [ ] AC-1: `node bin/forja.mjs` (sem args) lista todos os comandos agrupados por domínio; `forja <cmd> --help` ou comando desconhecido orienta com exit ≠ 0 no caso de erro.
|
|
34
|
-
- [ ] AC-2: existe `lib/core/registry.mjs` declarativo: cada comando tem domínio, descrição, alvo (script/binário) e gates; teste automatizado garante que todo script referenciado existe.
|
|
35
|
-
- [ ] AC-3: toda execução via core gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback: `.context/` do repo quando não há workspace) com ts, cmd, args, exitCode e durationMs.
|
|
36
|
-
- [ ] AC-4: comandos marcados com gate `workspace` falham cedo com mensagem "rode forja workspace:init" quando o workspace não existe.
|
|
37
|
-
- [ ] AC-5: os scripts npm do `package.json` roteiam pelo core (`node bin/forja.mjs <cmd>`); a chave duplicada `project:check` é eliminada; `forja` entra em `"bin"` do pacote.
|
|
38
|
-
- [ ] AC-6: `project:new` bem-sucedido grava/atualiza ficha do projeto em `<workspace>/memory/30-projects/<nome>.md`.
|
|
39
|
-
- [ ] AC-7: `npm test` cobre registry, help, comando desconhecido e gate de workspace; suíte existente continua verde.
|
|
40
|
-
|
|
41
|
-
## 5. Escopo
|
|
42
|
-
**Dentro**:
|
|
43
|
-
- `bin/forja.mjs` (dispatcher), `lib/core/registry.mjs` (registry + gates)
|
|
44
|
-
- `package.json`: bin `forja`, rewire dos scripts, remoção da duplicata
|
|
45
|
-
- `scripts/agent-harness.mjs`: ficha automática no `project:new`
|
|
46
|
-
- `test/forja-core.test.js`
|
|
47
|
-
- README/DOC-MAP: documentar o core como ponto de entrada
|
|
48
|
-
|
|
49
|
-
**Fora** (explícito, evita scope creep):
|
|
50
|
-
- Reescrever `dev.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. — continuam como implementação; `dev.mjs` fica como alias legado documentado
|
|
51
|
-
- Embutir a CLI `forja` nos projetos gerados (`lib/generators/`) — fase 2, spec própria
|
|
52
|
-
- Dashboard (`dashboard:*`) — front opcional, fora do processo
|
|
53
|
-
- Gravar auditoria no SQLite (JSONL primeiro; promoção a tabela é evolução futura)
|
|
54
|
-
|
|
55
|
-
## 6. NFRs / restrições
|
|
56
|
-
- Zero dependências novas (Node stdlib apenas).
|
|
57
|
-
- Overhead do roteamento imperceptível (< 100ms além do script alvo).
|
|
58
|
-
- Degradação graciosa: auditoria nunca bloqueia o comando (falha de escrita = warning).
|
|
59
|
-
- Compatibilidade: todos os aliases npm atuais continuam funcionando com a mesma semântica.
|
|
60
|
-
- pt-BR em toda saída de CLI.
|
|
61
|
-
|
|
62
|
-
## 7. Riscos e mitigação
|
|
63
|
-
| Risco | Probabilidade | Impacto | Mitigação |
|
|
64
|
-
|---|---|---|---|
|
|
65
|
-
| Duplo spawn (npm → forja → script) mascarar exit codes | B | A | Propagar `status` do filho sempre; testes de exit code |
|
|
66
|
-
| Registry divergir dos scripts reais | M | M | Teste de integridade (todo alvo existe no disco) |
|
|
67
|
-
| Gate de workspace bloquear fluxo legítimo do framework | M | M | Gate só em comandos de domínio de produto; framework roda sem workspace |
|
|
68
|
-
| JSONL de auditoria crescer sem limite | B | B | Arquivo em `.context/` (gitignored); rotação futura via `memory:compress` |
|
|
69
|
-
|
|
70
|
-
## 8. Métricas de sucesso
|
|
71
|
-
30 dias após o release: (a) 100% dos comandos de processo listados no help do core; (b) `forja-runs.jsonl` presente e usado em pelo menos um review de governance; (c) zero projetos criados sem ficha em `30-projects/`.
|
|
1
|
+
# Spec: forja-core
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-025
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: framework-team
|
|
6
|
+
- **Criado em**: 2026-07-06
|
|
7
|
+
- **Sprint alvo**: core-2026-07
|
|
8
|
+
- **ADRs relacionadas**: ADR-0020 (core CLI única), ADR-0019 (workspace separado), ADR-0005 (handoff 7 campos), ADR-0017 (codegraph no GSD)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O Forja se apresenta como framework de orquestração, mas os comandos não passam por um núcleo comum. Hoje existem **três dispatchers paralelos**:
|
|
12
|
+
|
|
13
|
+
1. `scripts/agent-harness.mjs` — workspace, GSD, design, code intelligence (com gates próprios).
|
|
14
|
+
2. `scripts/dev.mjs` — context, memória, project:health (registry próprio, duplica `design:*`/`gsd:*`).
|
|
15
|
+
3. `package.json` — ~40 scripts npm apontando direto para 15+ scripts soltos (`spec-cli`, `sprint-manager`, `sync-universal-memory`, `context-ops`, …), inclusive com a chave `project:check` **duplicada** (a primeira definição é silenciosamente descartada pelo npm).
|
|
16
|
+
|
|
17
|
+
Consequências mensuráveis:
|
|
18
|
+
- Nenhuma trilha de auditoria unificada: não dá para responder "quais comandos rodaram nesta feature?" sem grep em N lugares.
|
|
19
|
+
- Gates aplicados de forma desigual: `gsd:check` valida codegraph, mas `spec:tasks` e `sprint:start` não validam nada do processo.
|
|
20
|
+
- O workspace (ADR-0019) é resolvido por alguns comandos e ignorado por outros — um comando de produto pode rodar sem workspace e falhar tarde ou agir no lugar errado.
|
|
21
|
+
- Projetos gerados não são registrados em lugar nenhum: `project:new` cria a pasta e termina; a ficha em `memory/30-projects/` depende de disciplina manual.
|
|
22
|
+
|
|
23
|
+
## 2. Proposta de valor
|
|
24
|
+
Uma **CLI única `forja`** (bin/forja.mjs) vira o core executivo do framework: todo comando passa por um registry declarativo, com gates transversais (workspace, processo) e **trilha de auditoria** append-only. Projetos passam pelo core no nascimento (registro automático de ficha no workspace). Os dispatchers existentes viram implementação interna — nada é reescrito, tudo é roteado.
|
|
25
|
+
|
|
26
|
+
## 3. User stories
|
|
27
|
+
- **Como** operador do Forja, **quero** rodar `forja <comando>` (ou `npm run <alias>`) e ter um único ponto de entrada com help agrupado por domínio, **para que** eu não precise decorar qual script implementa o quê.
|
|
28
|
+
- **Como** governance, **quero** que toda execução de comando seja registrada em `.context/forja-runs.jsonl` (comando, args, exit code, duração), **para que** o review de uma feature tenha trilha de auditoria do processo.
|
|
29
|
+
- **Como** operador, **quero** que comandos de produto falhem cedo e com instrução clara quando o workspace não existe, **para que** nada rode no lugar errado (ADR-0019).
|
|
30
|
+
- **Como** orchestrator, **quero** que `project:new` registre automaticamente a ficha do projeto em `memory/30-projects/` do workspace, **para que** todo projeto nasça rastreado pelo core.
|
|
31
|
+
|
|
32
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
33
|
+
- [ ] AC-1: `node bin/forja.mjs` (sem args) lista todos os comandos agrupados por domínio; `forja <cmd> --help` ou comando desconhecido orienta com exit ≠ 0 no caso de erro.
|
|
34
|
+
- [ ] AC-2: existe `lib/core/registry.mjs` declarativo: cada comando tem domínio, descrição, alvo (script/binário) e gates; teste automatizado garante que todo script referenciado existe.
|
|
35
|
+
- [ ] AC-3: toda execução via core gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback: `.context/` do repo quando não há workspace) com ts, cmd, args, exitCode e durationMs.
|
|
36
|
+
- [ ] AC-4: comandos marcados com gate `workspace` falham cedo com mensagem "rode forja workspace:init" quando o workspace não existe.
|
|
37
|
+
- [ ] AC-5: os scripts npm do `package.json` roteiam pelo core (`node bin/forja.mjs <cmd>`); a chave duplicada `project:check` é eliminada; `forja` entra em `"bin"` do pacote.
|
|
38
|
+
- [ ] AC-6: `project:new` bem-sucedido grava/atualiza ficha do projeto em `<workspace>/memory/30-projects/<nome>.md`.
|
|
39
|
+
- [ ] AC-7: `npm test` cobre registry, help, comando desconhecido e gate de workspace; suíte existente continua verde.
|
|
40
|
+
|
|
41
|
+
## 5. Escopo
|
|
42
|
+
**Dentro**:
|
|
43
|
+
- `bin/forja.mjs` (dispatcher), `lib/core/registry.mjs` (registry + gates)
|
|
44
|
+
- `package.json`: bin `forja`, rewire dos scripts, remoção da duplicata
|
|
45
|
+
- `scripts/agent-harness.mjs`: ficha automática no `project:new`
|
|
46
|
+
- `test/forja-core.test.js`
|
|
47
|
+
- README/DOC-MAP: documentar o core como ponto de entrada
|
|
48
|
+
|
|
49
|
+
**Fora** (explícito, evita scope creep):
|
|
50
|
+
- Reescrever `dev.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. — continuam como implementação; `dev.mjs` fica como alias legado documentado
|
|
51
|
+
- Embutir a CLI `forja` nos projetos gerados (`lib/generators/`) — fase 2, spec própria
|
|
52
|
+
- Dashboard (`dashboard:*`) — front opcional, fora do processo
|
|
53
|
+
- Gravar auditoria no SQLite (JSONL primeiro; promoção a tabela é evolução futura)
|
|
54
|
+
|
|
55
|
+
## 6. NFRs / restrições
|
|
56
|
+
- Zero dependências novas (Node stdlib apenas).
|
|
57
|
+
- Overhead do roteamento imperceptível (< 100ms além do script alvo).
|
|
58
|
+
- Degradação graciosa: auditoria nunca bloqueia o comando (falha de escrita = warning).
|
|
59
|
+
- Compatibilidade: todos os aliases npm atuais continuam funcionando com a mesma semântica.
|
|
60
|
+
- pt-BR em toda saída de CLI.
|
|
61
|
+
|
|
62
|
+
## 7. Riscos e mitigação
|
|
63
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
64
|
+
|---|---|---|---|
|
|
65
|
+
| Duplo spawn (npm → forja → script) mascarar exit codes | B | A | Propagar `status` do filho sempre; testes de exit code |
|
|
66
|
+
| Registry divergir dos scripts reais | M | M | Teste de integridade (todo alvo existe no disco) |
|
|
67
|
+
| Gate de workspace bloquear fluxo legítimo do framework | M | M | Gate só em comandos de domínio de produto; framework roda sem workspace |
|
|
68
|
+
| JSONL de auditoria crescer sem limite | B | B | Arquivo em `.context/` (gitignored); rotação futura via `memory:compress` |
|
|
69
|
+
|
|
70
|
+
## 8. Métricas de sucesso
|
|
71
|
+
30 dias após o release: (a) 100% dos comandos de processo listados no help do core; (b) `forja-runs.jsonl` presente e usado em pelo menos um review de governance; (c) zero projetos criados sem ficha em `30-projects/`.
|
package/specs/gates/spec.md
CHANGED
|
@@ -1,63 +1,63 @@
|
|
|
1
|
-
# Spec: gates
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-020
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: apk
|
|
6
|
-
- **ADRs relacionadas**: ADR-0023 (doctor como gate), ADR-0024 (release gate), ADR-0029 (project:smoke), ADR-0020 (core/registry)
|
|
7
|
-
|
|
8
|
-
## 1. Problema
|
|
9
|
-
|
|
10
|
-
O framework acumulou uma família de gates — `tools:doctor` (núcleo + coerência de doc + topologia),
|
|
11
|
-
`release:check` (tarball), `project:smoke` (projeto gerado). Cada um guarda uma fronteira, mas estão
|
|
12
|
-
**espalhados**: ninguém lembra de rodar os três antes de um PR, e a governança do Forja — que existe
|
|
13
|
-
justamente para não depender de memória — depende da memória de quem publica para *invocar* os gates.
|
|
14
|
-
É a mesma ironia do ADR-0021, um nível acima: os gates existem, mas rodá-los ainda é disciplina.
|
|
15
|
-
|
|
16
|
-
## 2. Proposta de valor
|
|
17
|
-
|
|
18
|
-
Um comando roda **todos os gates aplicáveis ao framework** e dá **um veredito só**. "A casa está
|
|
19
|
-
coerente?" deixa de ser quatro comandos lembrados e vira um: `forja check:all`.
|
|
20
|
-
|
|
21
|
-
## 3. User stories
|
|
22
|
-
|
|
23
|
-
- **Como** mantenedor, **quero** um comando que rode a bateria inteira antes do PR, **para que** eu
|
|
24
|
-
não esqueça um gate e descubra a quebra no CI (ou depois).
|
|
25
|
-
- **Como** quem publica, **quero** `--full` que inclua os gates caros (tarball, build do gerado),
|
|
26
|
-
**para que** o pré-release seja um comando, não um checklist.
|
|
27
|
-
|
|
28
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
29
|
-
|
|
30
|
-
- [ ] AC-1: `forja check:all` roda os gates de coerência (o catálogo do `tools:doctor`) **+** o
|
|
31
|
-
`project:smoke` (tier barato) e reporta **um veredito** (exit ≠ 0 se qualquer crítico falhar).
|
|
32
|
-
- [ ] AC-2: `--full` adiciona os gates caros: `release:check` (tarball) e `project:smoke --full`
|
|
33
|
-
(instala + builda o backend gerado).
|
|
34
|
-
- [ ] AC-3: A saída **agrupa por gate** (núcleo & coerência / projeto gerado / tarball) e resume o
|
|
35
|
-
pior status ao final — legível, não um despejo.
|
|
36
|
-
- [ ] AC-4: **Compõe os runners existentes** (`health`, `project-smoke`, `release`) — uma máquina,
|
|
37
|
-
zero reimplementação de check. Reusa `worstStatus` de `checks.ts`.
|
|
38
|
-
- [ ] AC-5: Lógica de composição pura e testável (env/runners injetáveis; teste com fakes que
|
|
39
|
-
devolvem status conhecidos, sem gerar projeto de verdade).
|
|
40
|
-
|
|
41
|
-
## 5. Escopo
|
|
42
|
-
|
|
43
|
-
**Dentro**: compor os gates do framework num comando com veredito único e tiers.
|
|
44
|
-
|
|
45
|
-
**Fora** (explícito):
|
|
46
|
-
- `memory:audit` — é gate de **projeto gerado** (precisa de `memory/30-domains` de produto), não do
|
|
47
|
-
framework. Fica de fora do `check:all` do framework; roda no CI do projeto (ADR-0030).
|
|
48
|
-
- Reimplementar qualquer check — este comando só orquestra os catálogos que já existem.
|
|
49
|
-
- Substituir `tools:doctor`/`release:check`/`project:smoke` — eles seguem existindo, focados; o
|
|
50
|
-
`check:all` é o agregador, não o dono.
|
|
51
|
-
|
|
52
|
-
## 6. NFRs / restrições
|
|
53
|
-
|
|
54
|
-
- **Custo consciente**: o tier barato inclui a geração de um projeto (`project:smoke`) — segundos, sem
|
|
55
|
-
rede. O `--full` é minutos (empacota o tarball, `npm install` do backend). O tier certo para o
|
|
56
|
-
momento certo, como no `release:check`.
|
|
57
|
-
- **Compatibilidade**: comando novo; não muda os gates que agrega.
|
|
58
|
-
|
|
59
|
-
## 7. Métricas de sucesso
|
|
60
|
-
|
|
61
|
-
Um `forja check:all` antes do PR pega uma quebra que passaria (um gate esquecido) — a prova de que
|
|
62
|
-
reunir a bateria num comando valeu. A governança do framework deixa de depender de lembrar quais
|
|
63
|
-
gates rodar.
|
|
1
|
+
# Spec: gates
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-020
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **ADRs relacionadas**: ADR-0023 (doctor como gate), ADR-0024 (release gate), ADR-0029 (project:smoke), ADR-0020 (core/registry)
|
|
7
|
+
|
|
8
|
+
## 1. Problema
|
|
9
|
+
|
|
10
|
+
O framework acumulou uma família de gates — `tools:doctor` (núcleo + coerência de doc + topologia),
|
|
11
|
+
`release:check` (tarball), `project:smoke` (projeto gerado). Cada um guarda uma fronteira, mas estão
|
|
12
|
+
**espalhados**: ninguém lembra de rodar os três antes de um PR, e a governança do Forja — que existe
|
|
13
|
+
justamente para não depender de memória — depende da memória de quem publica para *invocar* os gates.
|
|
14
|
+
É a mesma ironia do ADR-0021, um nível acima: os gates existem, mas rodá-los ainda é disciplina.
|
|
15
|
+
|
|
16
|
+
## 2. Proposta de valor
|
|
17
|
+
|
|
18
|
+
Um comando roda **todos os gates aplicáveis ao framework** e dá **um veredito só**. "A casa está
|
|
19
|
+
coerente?" deixa de ser quatro comandos lembrados e vira um: `forja check:all`.
|
|
20
|
+
|
|
21
|
+
## 3. User stories
|
|
22
|
+
|
|
23
|
+
- **Como** mantenedor, **quero** um comando que rode a bateria inteira antes do PR, **para que** eu
|
|
24
|
+
não esqueça um gate e descubra a quebra no CI (ou depois).
|
|
25
|
+
- **Como** quem publica, **quero** `--full` que inclua os gates caros (tarball, build do gerado),
|
|
26
|
+
**para que** o pré-release seja um comando, não um checklist.
|
|
27
|
+
|
|
28
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
29
|
+
|
|
30
|
+
- [ ] AC-1: `forja check:all` roda os gates de coerência (o catálogo do `tools:doctor`) **+** o
|
|
31
|
+
`project:smoke` (tier barato) e reporta **um veredito** (exit ≠ 0 se qualquer crítico falhar).
|
|
32
|
+
- [ ] AC-2: `--full` adiciona os gates caros: `release:check` (tarball) e `project:smoke --full`
|
|
33
|
+
(instala + builda o backend gerado).
|
|
34
|
+
- [ ] AC-3: A saída **agrupa por gate** (núcleo & coerência / projeto gerado / tarball) e resume o
|
|
35
|
+
pior status ao final — legível, não um despejo.
|
|
36
|
+
- [ ] AC-4: **Compõe os runners existentes** (`health`, `project-smoke`, `release`) — uma máquina,
|
|
37
|
+
zero reimplementação de check. Reusa `worstStatus` de `checks.ts`.
|
|
38
|
+
- [ ] AC-5: Lógica de composição pura e testável (env/runners injetáveis; teste com fakes que
|
|
39
|
+
devolvem status conhecidos, sem gerar projeto de verdade).
|
|
40
|
+
|
|
41
|
+
## 5. Escopo
|
|
42
|
+
|
|
43
|
+
**Dentro**: compor os gates do framework num comando com veredito único e tiers.
|
|
44
|
+
|
|
45
|
+
**Fora** (explícito):
|
|
46
|
+
- `memory:audit` — é gate de **projeto gerado** (precisa de `memory/30-domains` de produto), não do
|
|
47
|
+
framework. Fica de fora do `check:all` do framework; roda no CI do projeto (ADR-0030).
|
|
48
|
+
- Reimplementar qualquer check — este comando só orquestra os catálogos que já existem.
|
|
49
|
+
- Substituir `tools:doctor`/`release:check`/`project:smoke` — eles seguem existindo, focados; o
|
|
50
|
+
`check:all` é o agregador, não o dono.
|
|
51
|
+
|
|
52
|
+
## 6. NFRs / restrições
|
|
53
|
+
|
|
54
|
+
- **Custo consciente**: o tier barato inclui a geração de um projeto (`project:smoke`) — segundos, sem
|
|
55
|
+
rede. O `--full` é minutos (empacota o tarball, `npm install` do backend). O tier certo para o
|
|
56
|
+
momento certo, como no `release:check`.
|
|
57
|
+
- **Compatibilidade**: comando novo; não muda os gates que agrega.
|
|
58
|
+
|
|
59
|
+
## 7. Métricas de sucesso
|
|
60
|
+
|
|
61
|
+
Um `forja check:all` antes do PR pega uma quebra que passaria (um gate esquecido) — a prova de que
|
|
62
|
+
reunir a bateria num comando valeu. A governança do framework deixa de depender de lembrar quais
|
|
63
|
+
gates rodar.
|
|
@@ -1,122 +1,122 @@
|
|
|
1
|
-
# Plan: governanca-visivel
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Criado em**: 2026-07-19
|
|
6
|
-
|
|
7
|
-
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
-
|
|
9
|
-
## 1. Abordagem técnica
|
|
10
|
-
|
|
11
|
-
Três comandos no domínio `governanca`, todos passando pelo core (auditados como os demais):
|
|
12
|
-
|
|
13
|
-
- `audit:sync` — ingest do `.context/forja-runs.jsonl` (fonte de verdade append-only) numa tabela
|
|
14
|
-
`audit_runs` do `universal.db` do workspace. A tabela é **projeção reconstruível**: o `.jsonl`
|
|
15
|
-
manda.
|
|
16
|
-
- `audit:query` — consulta estruturada (`--since`, `--cmd`, `--gate`, `--failed`).
|
|
17
|
-
- `governance:dashboard` — gera um HTML **estático e self-contained** de governança.
|
|
18
|
-
|
|
19
|
-
O painel **não executa nada** — lê specs, ADRs e a tabela de auditoria e escreve um arquivo. É a
|
|
20
|
-
resposta correta ao ADR-0022: o dashboard antigo era servidor com rotas; este é um *artefato*, como
|
|
21
|
-
o `project:dashboard` já é (só que HTML e sobre governança). O design do HTML reaproveita o protótipo
|
|
22
|
-
já validado nesta sessão.
|
|
23
|
-
|
|
24
|
-
## 2. Módulos afetados
|
|
25
|
-
|
|
26
|
-
| Caminho | Mudança | Risco |
|
|
27
|
-
|---|---|---|
|
|
28
|
-
| `scripts/memory-schema.mjs` | criar tabela `audit_runs` (+ índices) | B |
|
|
29
|
-
| `lib/audit.mjs` | **criar** — ingest do jsonl + queries (puro, testável) | M |
|
|
30
|
-
| `scripts/audit-sync.mjs` · `scripts/audit-query.mjs` | **criar** — CLIs finos sobre `lib/audit.mjs` | B |
|
|
31
|
-
| `lib/governance-report.mjs` | **criar** — coleta (specs/ADRs/audit/métricas) + render HTML self-contained | M |
|
|
32
|
-
| `scripts/governance-dashboard.mjs` | **criar** — CLI que escreve o arquivo | B |
|
|
33
|
-
| `lib/core/registry.mjs` | 3 entradas novas (`governanca`) | B |
|
|
34
|
-
| `test/audit.test.js` · `test/governance-report.test.js` | **criar** | B |
|
|
35
|
-
| `memory/90-decisions/0028-*.md` | **criar** — ADR | B |
|
|
36
|
-
|
|
37
|
-
Risco mora na coleta (`governance-report`): ler dados reais sem quebrar quando faltam (repo sem runs,
|
|
38
|
-
sem workspace). A renderização é mecânica; o design já está provado.
|
|
39
|
-
|
|
40
|
-
## 3. Fluxo
|
|
41
|
-
|
|
42
|
-
```
|
|
43
|
-
.context/forja-runs.jsonl ──audit:sync──► audit_runs (universal.db)
|
|
44
|
-
(append-only, verdade) │
|
|
45
|
-
├──► audit:query (--since/--cmd/--failed)
|
|
46
|
-
│
|
|
47
|
-
specs/* + memory/90-decisions/* + registry ─┴──► governance:dashboard
|
|
48
|
-
│
|
|
49
|
-
▼
|
|
50
|
-
governance.html (estático, file://)
|
|
51
|
-
zero rota · zero processo · leitura
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
## 4. Contratos
|
|
55
|
-
|
|
56
|
-
```js
|
|
57
|
-
// lib/audit.mjs — puro, env injetável ({ fs, dbPath, jsonlPath })
|
|
58
|
-
export function syncAudit(env); // jsonl → audit_runs; idempotente. -> { ingested, total }
|
|
59
|
-
export function queryAudit(env, { since, cmd, gate, failed }); // -> Run[]
|
|
60
|
-
export function auditSummary(env); // p/ o painel: { total, fails, byCmd, slowest, recent }
|
|
61
|
-
|
|
62
|
-
// lib/governance-report.mjs — puro, devolve string HTML
|
|
63
|
-
export function collect(env); // { specs, adrs, gates, audit, metrics }
|
|
64
|
-
export function renderHtml(data); // -> HTML self-contained (CSS/JS inline, zero asset externo)
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
**Schema `audit_runs`**: `line_hash TEXT PRIMARY KEY` (idempotência — hash da linha do jsonl),
|
|
68
|
-
`ts TEXT`, `cmd TEXT`, `args TEXT` (json), `exit_code INTEGER`, `duration_ms INTEGER`. Índices em
|
|
69
|
-
`cmd` e `ts`. Sem FTS5: o dado é colunar; query por coluna basta (D3).
|
|
70
|
-
|
|
71
|
-
## 5. Decisões e alternativas
|
|
72
|
-
|
|
73
|
-
**D1: A tabela é projeção; o `.jsonl` é a verdade.** `audit:sync` reconstrói do zero a qualquer
|
|
74
|
-
momento. Alternativa rejeitada: gravar direto no SQLite no core — acoplaria toda execução ao banco
|
|
75
|
-
(e o banco pode estar morto, ADR-0021). O log em arquivo é resiliente; a tabela é derivada.
|
|
76
|
-
|
|
77
|
-
**D2: Idempotência por `line_hash`, não por cursor.** Hash do conteúdo da linha como PK + `INSERT OR
|
|
78
|
-
IGNORE`. Robusto a re-sync e a truncamento do jsonl. Um cursor (contar linhas) quebra se o arquivo
|
|
79
|
-
for reescrito.
|
|
80
|
-
|
|
81
|
-
**D3: SQL estruturado, não FTS5.** O dado é `{cmd, exit, duração, ts}` — colunar. Query por coluna e
|
|
82
|
-
janela de tempo resolve as perguntas reais ("release:check reprovou quantas vezes"). FTS5 seria
|
|
83
|
-
over-engineering aqui; entra só se a busca por texto livre em `args` provar valer.
|
|
84
|
-
|
|
85
|
-
**D4: O painel não executa gates — lê o último resultado da auditoria.** Rodar `tools:doctor`/
|
|
86
|
-
`release:check` na geração seria lento e com efeito colateral. O painel mostra os checks de cada
|
|
87
|
-
catálogo (de `health`/`release`) + o **último exit** daquele comando na auditoria. Estado real, sem
|
|
88
|
-
reexecutar. Reforça o AC-4 (zero processo).
|
|
89
|
-
|
|
90
|
-
**D5: Comando novo, não estender `project:dashboard`.** O `project:dashboard` é markdown sobre o
|
|
91
|
-
ecossistema de projetos; este é HTML sobre a saúde do framework. Fundir confundiria dois públicos.
|
|
92
|
-
Coexistem (spec §5).
|
|
93
|
-
|
|
94
|
-
**D6: HTML self-contained, reaproveitando o protótipo.** CSS/JS inline, zero asset externo — abre com
|
|
95
|
-
`file://`. O design (gates, quadro SDD, métricas, tema claro/escuro) já foi validado como artifact
|
|
96
|
-
nesta sessão; vira template do gerador.
|
|
97
|
-
|
|
98
|
-
D1, D4 e D5 são estruturais → **ADR-0028** (auditoria consultável; painel estático-gerado como a
|
|
99
|
-
resposta correta ao ADR-0022), referenciando ADR-0022, ADR-0020 e ADR-0021.
|
|
100
|
-
|
|
101
|
-
## 6. Dependências
|
|
102
|
-
|
|
103
|
-
- **Specs**: nenhuma bloqueante. Usa o `universal.db` (SPEC-009/reestruturacao) e o audit (ADR-0020).
|
|
104
|
-
- **Pacotes**: **nenhum novo.** `better-sqlite3` (já runtime dep) + `node:fs`. HTML é string.
|
|
105
|
-
- **Migrações**: `audit_runs` é `CREATE TABLE IF NOT EXISTS` — aditivo, sem migração de dado.
|
|
106
|
-
|
|
107
|
-
## 7. Rollout
|
|
108
|
-
|
|
109
|
-
- [ ] Schema `audit_runs` + `lib/audit.mjs` (sync/query/summary) + testes, com env injetável.
|
|
110
|
-
- [ ] `audit:sync` e `audit:query` no registry; provar contra os 255 runs reais do workspace.
|
|
111
|
-
- [ ] `lib/governance-report.mjs` (coleta + render) + `governance:dashboard`; abrir o HTML e conferir.
|
|
112
|
-
- [ ] Degradação (AC-6): sem workspace/db, avisa e segue. Repo sem runs → "sem atividade", não quebra.
|
|
113
|
-
- [ ] ADR-0028; gates (`release:check`, `tools:doctor`, `npm test`).
|
|
114
|
-
|
|
115
|
-
## 8. Sinais de fracasso (kill criteria)
|
|
116
|
-
|
|
117
|
-
- **Qualquer coisa que execute na geração do painel** — se o gerador rodar um gate ou abrir um
|
|
118
|
-
processo, virou a SPEC-002 de novo. O painel só lê e escreve um arquivo (AC-4).
|
|
119
|
-
- **O HTML puxa asset externo** (CDN, fonte, imagem remota) — quebra o "abre com `file://`". Tudo
|
|
120
|
-
inline.
|
|
121
|
-
- **A tabela vira a fonte de verdade** — se alguém passar a gravar só no SQLite e largar o `.jsonl`,
|
|
122
|
-
perdemos a resiliência do log em arquivo (D1). A tabela é sempre derivável.
|
|
1
|
+
# Plan: governanca-visivel
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Criado em**: 2026-07-19
|
|
6
|
+
|
|
7
|
+
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
+
|
|
9
|
+
## 1. Abordagem técnica
|
|
10
|
+
|
|
11
|
+
Três comandos no domínio `governanca`, todos passando pelo core (auditados como os demais):
|
|
12
|
+
|
|
13
|
+
- `audit:sync` — ingest do `.context/forja-runs.jsonl` (fonte de verdade append-only) numa tabela
|
|
14
|
+
`audit_runs` do `universal.db` do workspace. A tabela é **projeção reconstruível**: o `.jsonl`
|
|
15
|
+
manda.
|
|
16
|
+
- `audit:query` — consulta estruturada (`--since`, `--cmd`, `--gate`, `--failed`).
|
|
17
|
+
- `governance:dashboard` — gera um HTML **estático e self-contained** de governança.
|
|
18
|
+
|
|
19
|
+
O painel **não executa nada** — lê specs, ADRs e a tabela de auditoria e escreve um arquivo. É a
|
|
20
|
+
resposta correta ao ADR-0022: o dashboard antigo era servidor com rotas; este é um *artefato*, como
|
|
21
|
+
o `project:dashboard` já é (só que HTML e sobre governança). O design do HTML reaproveita o protótipo
|
|
22
|
+
já validado nesta sessão.
|
|
23
|
+
|
|
24
|
+
## 2. Módulos afetados
|
|
25
|
+
|
|
26
|
+
| Caminho | Mudança | Risco |
|
|
27
|
+
|---|---|---|
|
|
28
|
+
| `scripts/memory-schema.mjs` | criar tabela `audit_runs` (+ índices) | B |
|
|
29
|
+
| `lib/audit.mjs` | **criar** — ingest do jsonl + queries (puro, testável) | M |
|
|
30
|
+
| `scripts/audit-sync.mjs` · `scripts/audit-query.mjs` | **criar** — CLIs finos sobre `lib/audit.mjs` | B |
|
|
31
|
+
| `lib/governance-report.mjs` | **criar** — coleta (specs/ADRs/audit/métricas) + render HTML self-contained | M |
|
|
32
|
+
| `scripts/governance-dashboard.mjs` | **criar** — CLI que escreve o arquivo | B |
|
|
33
|
+
| `lib/core/registry.mjs` | 3 entradas novas (`governanca`) | B |
|
|
34
|
+
| `test/audit.test.js` · `test/governance-report.test.js` | **criar** | B |
|
|
35
|
+
| `memory/90-decisions/0028-*.md` | **criar** — ADR | B |
|
|
36
|
+
|
|
37
|
+
Risco mora na coleta (`governance-report`): ler dados reais sem quebrar quando faltam (repo sem runs,
|
|
38
|
+
sem workspace). A renderização é mecânica; o design já está provado.
|
|
39
|
+
|
|
40
|
+
## 3. Fluxo
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
.context/forja-runs.jsonl ──audit:sync──► audit_runs (universal.db)
|
|
44
|
+
(append-only, verdade) │
|
|
45
|
+
├──► audit:query (--since/--cmd/--failed)
|
|
46
|
+
│
|
|
47
|
+
specs/* + memory/90-decisions/* + registry ─┴──► governance:dashboard
|
|
48
|
+
│
|
|
49
|
+
▼
|
|
50
|
+
governance.html (estático, file://)
|
|
51
|
+
zero rota · zero processo · leitura
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## 4. Contratos
|
|
55
|
+
|
|
56
|
+
```js
|
|
57
|
+
// lib/audit.mjs — puro, env injetável ({ fs, dbPath, jsonlPath })
|
|
58
|
+
export function syncAudit(env); // jsonl → audit_runs; idempotente. -> { ingested, total }
|
|
59
|
+
export function queryAudit(env, { since, cmd, gate, failed }); // -> Run[]
|
|
60
|
+
export function auditSummary(env); // p/ o painel: { total, fails, byCmd, slowest, recent }
|
|
61
|
+
|
|
62
|
+
// lib/governance-report.mjs — puro, devolve string HTML
|
|
63
|
+
export function collect(env); // { specs, adrs, gates, audit, metrics }
|
|
64
|
+
export function renderHtml(data); // -> HTML self-contained (CSS/JS inline, zero asset externo)
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Schema `audit_runs`**: `line_hash TEXT PRIMARY KEY` (idempotência — hash da linha do jsonl),
|
|
68
|
+
`ts TEXT`, `cmd TEXT`, `args TEXT` (json), `exit_code INTEGER`, `duration_ms INTEGER`. Índices em
|
|
69
|
+
`cmd` e `ts`. Sem FTS5: o dado é colunar; query por coluna basta (D3).
|
|
70
|
+
|
|
71
|
+
## 5. Decisões e alternativas
|
|
72
|
+
|
|
73
|
+
**D1: A tabela é projeção; o `.jsonl` é a verdade.** `audit:sync` reconstrói do zero a qualquer
|
|
74
|
+
momento. Alternativa rejeitada: gravar direto no SQLite no core — acoplaria toda execução ao banco
|
|
75
|
+
(e o banco pode estar morto, ADR-0021). O log em arquivo é resiliente; a tabela é derivada.
|
|
76
|
+
|
|
77
|
+
**D2: Idempotência por `line_hash`, não por cursor.** Hash do conteúdo da linha como PK + `INSERT OR
|
|
78
|
+
IGNORE`. Robusto a re-sync e a truncamento do jsonl. Um cursor (contar linhas) quebra se o arquivo
|
|
79
|
+
for reescrito.
|
|
80
|
+
|
|
81
|
+
**D3: SQL estruturado, não FTS5.** O dado é `{cmd, exit, duração, ts}` — colunar. Query por coluna e
|
|
82
|
+
janela de tempo resolve as perguntas reais ("release:check reprovou quantas vezes"). FTS5 seria
|
|
83
|
+
over-engineering aqui; entra só se a busca por texto livre em `args` provar valer.
|
|
84
|
+
|
|
85
|
+
**D4: O painel não executa gates — lê o último resultado da auditoria.** Rodar `tools:doctor`/
|
|
86
|
+
`release:check` na geração seria lento e com efeito colateral. O painel mostra os checks de cada
|
|
87
|
+
catálogo (de `health`/`release`) + o **último exit** daquele comando na auditoria. Estado real, sem
|
|
88
|
+
reexecutar. Reforça o AC-4 (zero processo).
|
|
89
|
+
|
|
90
|
+
**D5: Comando novo, não estender `project:dashboard`.** O `project:dashboard` é markdown sobre o
|
|
91
|
+
ecossistema de projetos; este é HTML sobre a saúde do framework. Fundir confundiria dois públicos.
|
|
92
|
+
Coexistem (spec §5).
|
|
93
|
+
|
|
94
|
+
**D6: HTML self-contained, reaproveitando o protótipo.** CSS/JS inline, zero asset externo — abre com
|
|
95
|
+
`file://`. O design (gates, quadro SDD, métricas, tema claro/escuro) já foi validado como artifact
|
|
96
|
+
nesta sessão; vira template do gerador.
|
|
97
|
+
|
|
98
|
+
D1, D4 e D5 são estruturais → **ADR-0028** (auditoria consultável; painel estático-gerado como a
|
|
99
|
+
resposta correta ao ADR-0022), referenciando ADR-0022, ADR-0020 e ADR-0021.
|
|
100
|
+
|
|
101
|
+
## 6. Dependências
|
|
102
|
+
|
|
103
|
+
- **Specs**: nenhuma bloqueante. Usa o `universal.db` (SPEC-009/reestruturacao) e o audit (ADR-0020).
|
|
104
|
+
- **Pacotes**: **nenhum novo.** `better-sqlite3` (já runtime dep) + `node:fs`. HTML é string.
|
|
105
|
+
- **Migrações**: `audit_runs` é `CREATE TABLE IF NOT EXISTS` — aditivo, sem migração de dado.
|
|
106
|
+
|
|
107
|
+
## 7. Rollout
|
|
108
|
+
|
|
109
|
+
- [ ] Schema `audit_runs` + `lib/audit.mjs` (sync/query/summary) + testes, com env injetável.
|
|
110
|
+
- [ ] `audit:sync` e `audit:query` no registry; provar contra os 255 runs reais do workspace.
|
|
111
|
+
- [ ] `lib/governance-report.mjs` (coleta + render) + `governance:dashboard`; abrir o HTML e conferir.
|
|
112
|
+
- [ ] Degradação (AC-6): sem workspace/db, avisa e segue. Repo sem runs → "sem atividade", não quebra.
|
|
113
|
+
- [ ] ADR-0028; gates (`release:check`, `tools:doctor`, `npm test`).
|
|
114
|
+
|
|
115
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
116
|
+
|
|
117
|
+
- **Qualquer coisa que execute na geração do painel** — se o gerador rodar um gate ou abrir um
|
|
118
|
+
processo, virou a SPEC-002 de novo. O painel só lê e escreve um arquivo (AC-4).
|
|
119
|
+
- **O HTML puxa asset externo** (CDN, fonte, imagem remota) — quebra o "abre com `file://`". Tudo
|
|
120
|
+
inline.
|
|
121
|
+
- **A tabela vira a fonte de verdade** — se alguém passar a gravar só no SQLite e largar o `.jsonl`,
|
|
122
|
+
perdemos a resiliência do log em arquivo (D1). A tabela é sempre derivável.
|