forjajs 2.0.4 → 3.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 +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 +50 -50
- 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 +133 -133
- package/CHANGELOG.md +619 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +64 -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 +15 -0
- 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/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/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/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.js +27 -4
- 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 +32 -3
- 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/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/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 +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 +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/_template.md +28 -28
- package/package.json +157 -157
- 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/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-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/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,60 +1,60 @@
|
|
|
1
|
-
# Tasks: governanca-visivel
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: done
|
|
6
|
-
- **Criado em**: 2026-07-19
|
|
7
|
-
|
|
8
|
-
> Ordem: dado consultável primeiro (audit), painel depois (que lê o audit). Env injetável em toda a
|
|
9
|
-
> lógica pura, para os testes não tocarem o workspace real.
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## T1 — Schema + `lib/audit.mjs`
|
|
14
|
-
- **Owner**: Worker · **Estimativa**: M · **Depende de**: —
|
|
15
|
-
- **Paths**: `scripts/memory-schema.mjs`, `lib/audit.mjs`, `test/audit.test.js`
|
|
16
|
-
- **Done**:
|
|
17
|
-
- [ ] Tabela `audit_runs` (`line_hash` PK, `ts`, `cmd`, `args`, `exit_code`, `duration_ms`; índices em `cmd`/`ts`).
|
|
18
|
-
- [ ] `syncAudit(env)`: lê o jsonl, `INSERT OR IGNORE` por `line_hash` — idempotente (AC-1). Linha malformada é pulada, não derruba.
|
|
19
|
-
- [ ] `queryAudit(env, {since,cmd,gate,failed})` e `auditSummary(env)` (total, fails, byCmd, slowest, recent) — AC-2.
|
|
20
|
-
- [ ] `env` injetável (`fs`/`dbPath`/`jsonlPath`); testes com jsonl de fixture, incl. idempotência e linha corrompida.
|
|
21
|
-
|
|
22
|
-
## T2 — `audit:sync` + `audit:query` (registry)
|
|
23
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T1
|
|
24
|
-
- **Paths**: `scripts/audit-sync.mjs`, `scripts/audit-query.mjs`, `lib/core/registry.mjs`
|
|
25
|
-
- **Done**:
|
|
26
|
-
- [ ] CLIs finos sobre `lib/audit.mjs`; entradas no registry (domínio `governanca`), passam pelo core.
|
|
27
|
-
- [ ] Degradam sem workspace/db: avisam com `sync:universal`/`audit:sync`, não estouram (AC-6).
|
|
28
|
-
- [ ] **Prova real**: `audit:sync` ingere os 255 runs do workspace; `audit:query --failed` e `--cmd release:check` respondem.
|
|
29
|
-
|
|
30
|
-
## T3 — `lib/governance-report.mjs` (coleta + render)
|
|
31
|
-
- **Owner**: Worker · **Estimativa**: M · **Depende de**: T1
|
|
32
|
-
- **Paths**: `lib/governance-report.mjs`, `test/governance-report.test.js`
|
|
33
|
-
- **Done**:
|
|
34
|
-
- [ ] `collect(env)`: specs (status por stage), ADRs (contagem/lista de `memory/90-decisions`), gates (checks de `health`/`release` + último exit da auditoria — **sem reexecutar**, D4), métricas (comandos do registry).
|
|
35
|
-
- [ ] `renderHtml(data)`: HTML **self-contained** — CSS/JS inline, **zero asset externo** (AC-3/AC-4). Tema claro/escuro. Reaproveita o design do protótipo.
|
|
36
|
-
- [ ] Dado real, não fixture (AC-5): repo sem runs → seção "sem atividade", não quebra.
|
|
37
|
-
- [ ] Teste: `renderHtml` não emite `http`/`src=`/`@import` externo; `collect` degrada sem db.
|
|
38
|
-
|
|
39
|
-
## T4 — `governance:dashboard` (registry)
|
|
40
|
-
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T3
|
|
41
|
-
- **Paths**: `scripts/governance-dashboard.mjs`, `lib/core/registry.mjs`
|
|
42
|
-
- **Done**:
|
|
43
|
-
- [ ] Escreve o HTML num arquivo (default `<workspace>/.context/governance.html`), reporta o caminho.
|
|
44
|
-
- [ ] **Zero execução** na geração — só lê e escreve (AC-4 / kill criteria). Entrada no registry.
|
|
45
|
-
- [ ] **Prova real**: gera o arquivo, abre e confere que os gates/SDD/auditoria refletem o repo.
|
|
46
|
-
|
|
47
|
-
## T5 — ADR-0028
|
|
48
|
-
- **Owner**: SDD Architect · **Estimativa**: P · **Depende de**: T2, T4
|
|
49
|
-
- **Paths**: `memory/90-decisions/0028-*.md`
|
|
50
|
-
- **Done**: registra D1 (tabela = projeção), D4 (painel não executa), D5 (comando novo); referencia
|
|
51
|
-
ADR-0022 (a resposta correta ao dashboard congelado), ADR-0020, ADR-0021.
|
|
52
|
-
|
|
53
|
-
## T6 — Gates (Governance)
|
|
54
|
-
- **Owner**: Governance · **Estimativa**: P · **Depende de**: T2, T4, T5
|
|
55
|
-
- **Done**: `release:check` (scripts no `files[]`), `tools:doctor` (docs-commands não acusa fantasma
|
|
56
|
-
nos comandos novos), `npm test` verde. spec → `done`.
|
|
57
|
-
|
|
58
|
-
---
|
|
59
|
-
## Handoffs
|
|
60
|
-
Worker (T1-T4), SDD Architect (T5), Governance (T6). `forja agent:route` a cada fronteira (ADR-0005).
|
|
1
|
+
# Tasks: governanca-visivel
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
- **Criado em**: 2026-07-19
|
|
7
|
+
|
|
8
|
+
> Ordem: dado consultável primeiro (audit), painel depois (que lê o audit). Env injetável em toda a
|
|
9
|
+
> lógica pura, para os testes não tocarem o workspace real.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## T1 — Schema + `lib/audit.mjs`
|
|
14
|
+
- **Owner**: Worker · **Estimativa**: M · **Depende de**: —
|
|
15
|
+
- **Paths**: `scripts/memory-schema.mjs`, `lib/audit.mjs`, `test/audit.test.js`
|
|
16
|
+
- **Done**:
|
|
17
|
+
- [ ] Tabela `audit_runs` (`line_hash` PK, `ts`, `cmd`, `args`, `exit_code`, `duration_ms`; índices em `cmd`/`ts`).
|
|
18
|
+
- [ ] `syncAudit(env)`: lê o jsonl, `INSERT OR IGNORE` por `line_hash` — idempotente (AC-1). Linha malformada é pulada, não derruba.
|
|
19
|
+
- [ ] `queryAudit(env, {since,cmd,gate,failed})` e `auditSummary(env)` (total, fails, byCmd, slowest, recent) — AC-2.
|
|
20
|
+
- [ ] `env` injetável (`fs`/`dbPath`/`jsonlPath`); testes com jsonl de fixture, incl. idempotência e linha corrompida.
|
|
21
|
+
|
|
22
|
+
## T2 — `audit:sync` + `audit:query` (registry)
|
|
23
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T1
|
|
24
|
+
- **Paths**: `scripts/audit-sync.mjs`, `scripts/audit-query.mjs`, `lib/core/registry.mjs`
|
|
25
|
+
- **Done**:
|
|
26
|
+
- [ ] CLIs finos sobre `lib/audit.mjs`; entradas no registry (domínio `governanca`), passam pelo core.
|
|
27
|
+
- [ ] Degradam sem workspace/db: avisam com `sync:universal`/`audit:sync`, não estouram (AC-6).
|
|
28
|
+
- [ ] **Prova real**: `audit:sync` ingere os 255 runs do workspace; `audit:query --failed` e `--cmd release:check` respondem.
|
|
29
|
+
|
|
30
|
+
## T3 — `lib/governance-report.mjs` (coleta + render)
|
|
31
|
+
- **Owner**: Worker · **Estimativa**: M · **Depende de**: T1
|
|
32
|
+
- **Paths**: `lib/governance-report.mjs`, `test/governance-report.test.js`
|
|
33
|
+
- **Done**:
|
|
34
|
+
- [ ] `collect(env)`: specs (status por stage), ADRs (contagem/lista de `memory/90-decisions`), gates (checks de `health`/`release` + último exit da auditoria — **sem reexecutar**, D4), métricas (comandos do registry).
|
|
35
|
+
- [ ] `renderHtml(data)`: HTML **self-contained** — CSS/JS inline, **zero asset externo** (AC-3/AC-4). Tema claro/escuro. Reaproveita o design do protótipo.
|
|
36
|
+
- [ ] Dado real, não fixture (AC-5): repo sem runs → seção "sem atividade", não quebra.
|
|
37
|
+
- [ ] Teste: `renderHtml` não emite `http`/`src=`/`@import` externo; `collect` degrada sem db.
|
|
38
|
+
|
|
39
|
+
## T4 — `governance:dashboard` (registry)
|
|
40
|
+
- **Owner**: Worker · **Estimativa**: P · **Depende de**: T3
|
|
41
|
+
- **Paths**: `scripts/governance-dashboard.mjs`, `lib/core/registry.mjs`
|
|
42
|
+
- **Done**:
|
|
43
|
+
- [ ] Escreve o HTML num arquivo (default `<workspace>/.context/governance.html`), reporta o caminho.
|
|
44
|
+
- [ ] **Zero execução** na geração — só lê e escreve (AC-4 / kill criteria). Entrada no registry.
|
|
45
|
+
- [ ] **Prova real**: gera o arquivo, abre e confere que os gates/SDD/auditoria refletem o repo.
|
|
46
|
+
|
|
47
|
+
## T5 — ADR-0028
|
|
48
|
+
- **Owner**: SDD Architect · **Estimativa**: P · **Depende de**: T2, T4
|
|
49
|
+
- **Paths**: `memory/90-decisions/0028-*.md`
|
|
50
|
+
- **Done**: registra D1 (tabela = projeção), D4 (painel não executa), D5 (comando novo); referencia
|
|
51
|
+
ADR-0022 (a resposta correta ao dashboard congelado), ADR-0020, ADR-0021.
|
|
52
|
+
|
|
53
|
+
## T6 — Gates (Governance)
|
|
54
|
+
- **Owner**: Governance · **Estimativa**: P · **Depende de**: T2, T4, T5
|
|
55
|
+
- **Done**: `release:check` (scripts no `files[]`), `tools:doctor` (docs-commands não acusa fantasma
|
|
56
|
+
nos comandos novos), `npm test` verde. spec → `done`.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
## Handoffs
|
|
60
|
+
Worker (T1-T4), SDD Architect (T5), Governance (T6). `forja agent:route` a cada fronteira (ADR-0005).
|
|
@@ -1,71 +1,71 @@
|
|
|
1
|
-
# Spec: harness-codegraph
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-024
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: framework-team
|
|
6
|
-
- **Criado em**: 2026-06-27
|
|
7
|
-
- **Sprint alvo**: harness-2026-06
|
|
8
|
-
- **ADRs relacionadas**: ADR-0017 (codegraph no harness GSD), ADR-0018 (ferramentas de processo)
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
O harness GSD/Hermes está sólido (10 gates, handoffs de 7 campos), mas três furos impedem que ele seja a base confiável dos próximos projetos:
|
|
12
|
-
|
|
13
|
-
1. **Codegraph é uma integração pendurada.** Está instalado (`~/.local/bin/codegraph`), com MCP em `.mcp.json` e scripts `code:*`, mas **nenhum gate do GSD e nenhum papel o usa**. O Worker recebe "implemente `tasks.md`" sem nunca consultar o blast radius de um símbolo antes de editar.
|
|
14
|
-
2. **O índice codegraph apontava para o worktree errado** (`2-Projeto-Agents` pai em vez de `projects/forja`), retornando símbolos da árvore errada — silenciosamente.
|
|
15
|
-
3. **O gerador (`bin/init-project.js` + `lib/generators/`) não emite nada disso.** Projetos novos não herdam `.mcp.json`, scripts `code:*`, o `agent-harness.mjs` nem os gates GSD. A estrutura morre no framework-raiz.
|
|
16
|
-
|
|
17
|
-
Mede-se hoje a dor pela ausência: zero consultas codegraph nos handoffs registrados, zero gates de código, e `codegraph status` emitindo warning de worktree.
|
|
18
|
-
|
|
19
|
-
## 2. Proposta de valor
|
|
20
|
-
O codegraph vira **passo verificável do fluxo GSD** (mapa de impacto antes de implementar, freshness no gate de governança), e todo projeto gerado herda o harness completo — codegraph, `code:*`, GSD e ferramentas de processo — sem configuração manual.
|
|
21
|
-
|
|
22
|
-
## 3. User stories
|
|
23
|
-
- **Como** SDD Architect, **quero** rodar `code:impact <símbolo>` para ver chamadores e blast radius, **para que** o `plan.md` liste módulos afetados com evidência, não chute
|
|
24
|
-
- **Como** Worker, **quero** que o runbook GSD me obrigue a mapear impacto antes de editar, **para que** eu não quebre chamadores fora do escopo
|
|
25
|
-
- **Como** Governance, **quero** que `gsd:check` falhe se o índice codegraph estiver no worktree errado ou defasado, **para que** consultas de código sejam confiáveis no review
|
|
26
|
-
- **Como** usuário gerando projeto novo, **quero** que `init-project` já entregue `.mcp.json` + `code:*` + GSD, **para que** o novo projeto nasça com o harness completo
|
|
27
|
-
- **Como** Governance, **quero** um `tools:doctor` que detecta ferramentas de processo (codegraph, gitleaks, ast-grep, lefthook), **para que** eu saiba o que está disponível antes de exigir um gate
|
|
28
|
-
|
|
29
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
30
|
-
- [x] AC-1: `npm run code:check` valida que o índice codegraph existe, pertence a este worktree e não está defasado; exit≠0 caso contrário
|
|
31
|
-
- [x] AC-2: `npm run code:impact <símbolo>` retorna chamadores + arquivos afetados (via codegraph), com fallback claro se o binário não existir
|
|
32
|
-
- [x] AC-3: o runbook gerado por `gsd:plan` inclui um gate "Mapa de impacto (codegraph)" entre Contexto e Plano
|
|
33
|
-
- [x] AC-4: `gsd:check` inclui um gate de freshness/worktree do codegraph (não-bloqueante se codegraph ausente, bloqueante se índice for de outro worktree)
|
|
34
|
-
- [x] AC-5: `init-project` emite no projeto gerado: `.mcp.json` (codegraph), scripts `code:*` e `gsd:*` no `package.json`, e `scripts/agent-harness.mjs`
|
|
35
|
-
- [x] AC-6: `npm run tools:doctor` lista status (instalado/ausente) de codegraph, gitleaks, ast-grep, lefthook, markdownlint
|
|
36
|
-
- [x] AC-7: sub-agents `sdd-architect` e `governance` (+ prompts) instruem uso de codegraph; docs (`AGENTS.md`, `agent-harnesses.md`, `gsd-harness.md`, manual) atualizadas
|
|
37
|
-
- [x] AC-8: `npm test` cobre `code:check`/`code:impact`/`tools:doctor` com degradação graciosa quando binários ausentes
|
|
38
|
-
|
|
39
|
-
## 5. Escopo
|
|
40
|
-
**Dentro**:
|
|
41
|
-
- `scripts/agent-harness.mjs`: comandos `code:impact`, `code:check`
|
|
42
|
-
- `scripts/tools-doctor.mjs`: doctor de ferramentas de processo
|
|
43
|
-
- `package.json`: scripts `code:impact`, `code:check`, `tools:doctor`
|
|
44
|
-
- Template do runbook GSD + lógica do `gsd:check`
|
|
45
|
-
- `bin/init-project.js` / `lib/generators/`: emissão do harness no projeto gerado
|
|
46
|
-
- `.claude/agents/` + `prompts/` (sdd-architect, governance)
|
|
47
|
-
- Docs: `AGENTS.md`, `docs/agent-harnesses.md`, `memory/50-orchestration/gsd-harness.md`, manual
|
|
48
|
-
- ADR-0017 e ADR-0018
|
|
49
|
-
|
|
50
|
-
**Fora** (explícito, evita scope creep):
|
|
51
|
-
- Reescrever o codegraph ou criar índice próprio (usamos o binário externo)
|
|
52
|
-
- Instalar automaticamente gitleaks/ast-grep/lefthook (apenas detectar + documentar)
|
|
53
|
-
- Tornar design:check obrigatório em fluxo CLI-only (mantém ADR vigente)
|
|
54
|
-
- Mexer em `projects/` (apps reais, off-limits)
|
|
55
|
-
|
|
56
|
-
## 6. NFRs / restrições
|
|
57
|
-
- Degradação graciosa: nenhum comando novo pode quebrar o fluxo quando codegraph/ferramentas externas não estão instaladas — deve avisar e seguir
|
|
58
|
-
- Determinístico: `code:check`/`tools:doctor` não dependem de rede
|
|
59
|
-
- Compatibilidade: não quebra `init-project.js` para quem não usa codegraph; `.mcp.json` é aditivo
|
|
60
|
-
- pt-BR em toda saída de CLI
|
|
61
|
-
|
|
62
|
-
## 7. Riscos e mitigação
|
|
63
|
-
| Risco | Probabilidade | Impacto | Mitigação |
|
|
64
|
-
|---|---|---|---|
|
|
65
|
-
| codegraph ausente no ambiente do usuário | M | M | `code:*` degrada com aviso; gate não-bloqueante quando binário falta |
|
|
66
|
-
| Falso bloqueio por índice "defasado" | M | A | Heurística por mtime + warning de worktree do próprio codegraph, nunca por hash de cada arquivo |
|
|
67
|
-
| Gerador inchar projetos que não querem codegraph | B | M | `.mcp.json` e gates são aditivos e documentados como opcionais |
|
|
68
|
-
| Acoplar harness a versão específica do codegraph CLI | M | M | Usar só `init/status/sync` + MCP; parsear saída de forma tolerante |
|
|
69
|
-
|
|
70
|
-
## 8. Métricas de sucesso
|
|
71
|
-
30 dias após o release: (a) 100% dos projetos novos gerados saem com `.mcp.json` + `code:*` + GSD; (b) `gsd:check` passando inclui o gate codegraph; (c) pelo menos os papéis Architect/Worker referenciam `code:impact` nos handoffs de implementação registrados no SQLite.
|
|
1
|
+
# Spec: harness-codegraph
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-024
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: framework-team
|
|
6
|
+
- **Criado em**: 2026-06-27
|
|
7
|
+
- **Sprint alvo**: harness-2026-06
|
|
8
|
+
- **ADRs relacionadas**: ADR-0017 (codegraph no harness GSD), ADR-0018 (ferramentas de processo)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
O harness GSD/Hermes está sólido (10 gates, handoffs de 7 campos), mas três furos impedem que ele seja a base confiável dos próximos projetos:
|
|
12
|
+
|
|
13
|
+
1. **Codegraph é uma integração pendurada.** Está instalado (`~/.local/bin/codegraph`), com MCP em `.mcp.json` e scripts `code:*`, mas **nenhum gate do GSD e nenhum papel o usa**. O Worker recebe "implemente `tasks.md`" sem nunca consultar o blast radius de um símbolo antes de editar.
|
|
14
|
+
2. **O índice codegraph apontava para o worktree errado** (`2-Projeto-Agents` pai em vez de `projects/forja`), retornando símbolos da árvore errada — silenciosamente.
|
|
15
|
+
3. **O gerador (`bin/init-project.js` + `lib/generators/`) não emite nada disso.** Projetos novos não herdam `.mcp.json`, scripts `code:*`, o `agent-harness.mjs` nem os gates GSD. A estrutura morre no framework-raiz.
|
|
16
|
+
|
|
17
|
+
Mede-se hoje a dor pela ausência: zero consultas codegraph nos handoffs registrados, zero gates de código, e `codegraph status` emitindo warning de worktree.
|
|
18
|
+
|
|
19
|
+
## 2. Proposta de valor
|
|
20
|
+
O codegraph vira **passo verificável do fluxo GSD** (mapa de impacto antes de implementar, freshness no gate de governança), e todo projeto gerado herda o harness completo — codegraph, `code:*`, GSD e ferramentas de processo — sem configuração manual.
|
|
21
|
+
|
|
22
|
+
## 3. User stories
|
|
23
|
+
- **Como** SDD Architect, **quero** rodar `code:impact <símbolo>` para ver chamadores e blast radius, **para que** o `plan.md` liste módulos afetados com evidência, não chute
|
|
24
|
+
- **Como** Worker, **quero** que o runbook GSD me obrigue a mapear impacto antes de editar, **para que** eu não quebre chamadores fora do escopo
|
|
25
|
+
- **Como** Governance, **quero** que `gsd:check` falhe se o índice codegraph estiver no worktree errado ou defasado, **para que** consultas de código sejam confiáveis no review
|
|
26
|
+
- **Como** usuário gerando projeto novo, **quero** que `init-project` já entregue `.mcp.json` + `code:*` + GSD, **para que** o novo projeto nasça com o harness completo
|
|
27
|
+
- **Como** Governance, **quero** um `tools:doctor` que detecta ferramentas de processo (codegraph, gitleaks, ast-grep, lefthook), **para que** eu saiba o que está disponível antes de exigir um gate
|
|
28
|
+
|
|
29
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
30
|
+
- [x] AC-1: `npm run code:check` valida que o índice codegraph existe, pertence a este worktree e não está defasado; exit≠0 caso contrário
|
|
31
|
+
- [x] AC-2: `npm run code:impact <símbolo>` retorna chamadores + arquivos afetados (via codegraph), com fallback claro se o binário não existir
|
|
32
|
+
- [x] AC-3: o runbook gerado por `gsd:plan` inclui um gate "Mapa de impacto (codegraph)" entre Contexto e Plano
|
|
33
|
+
- [x] AC-4: `gsd:check` inclui um gate de freshness/worktree do codegraph (não-bloqueante se codegraph ausente, bloqueante se índice for de outro worktree)
|
|
34
|
+
- [x] AC-5: `init-project` emite no projeto gerado: `.mcp.json` (codegraph), scripts `code:*` e `gsd:*` no `package.json`, e `scripts/agent-harness.mjs`
|
|
35
|
+
- [x] AC-6: `npm run tools:doctor` lista status (instalado/ausente) de codegraph, gitleaks, ast-grep, lefthook, markdownlint
|
|
36
|
+
- [x] AC-7: sub-agents `sdd-architect` e `governance` (+ prompts) instruem uso de codegraph; docs (`AGENTS.md`, `agent-harnesses.md`, `gsd-harness.md`, manual) atualizadas
|
|
37
|
+
- [x] AC-8: `npm test` cobre `code:check`/`code:impact`/`tools:doctor` com degradação graciosa quando binários ausentes
|
|
38
|
+
|
|
39
|
+
## 5. Escopo
|
|
40
|
+
**Dentro**:
|
|
41
|
+
- `scripts/agent-harness.mjs`: comandos `code:impact`, `code:check`
|
|
42
|
+
- `scripts/tools-doctor.mjs`: doctor de ferramentas de processo
|
|
43
|
+
- `package.json`: scripts `code:impact`, `code:check`, `tools:doctor`
|
|
44
|
+
- Template do runbook GSD + lógica do `gsd:check`
|
|
45
|
+
- `bin/init-project.js` / `lib/generators/`: emissão do harness no projeto gerado
|
|
46
|
+
- `.claude/agents/` + `prompts/` (sdd-architect, governance)
|
|
47
|
+
- Docs: `AGENTS.md`, `docs/agent-harnesses.md`, `memory/50-orchestration/gsd-harness.md`, manual
|
|
48
|
+
- ADR-0017 e ADR-0018
|
|
49
|
+
|
|
50
|
+
**Fora** (explícito, evita scope creep):
|
|
51
|
+
- Reescrever o codegraph ou criar índice próprio (usamos o binário externo)
|
|
52
|
+
- Instalar automaticamente gitleaks/ast-grep/lefthook (apenas detectar + documentar)
|
|
53
|
+
- Tornar design:check obrigatório em fluxo CLI-only (mantém ADR vigente)
|
|
54
|
+
- Mexer em `projects/` (apps reais, off-limits)
|
|
55
|
+
|
|
56
|
+
## 6. NFRs / restrições
|
|
57
|
+
- Degradação graciosa: nenhum comando novo pode quebrar o fluxo quando codegraph/ferramentas externas não estão instaladas — deve avisar e seguir
|
|
58
|
+
- Determinístico: `code:check`/`tools:doctor` não dependem de rede
|
|
59
|
+
- Compatibilidade: não quebra `init-project.js` para quem não usa codegraph; `.mcp.json` é aditivo
|
|
60
|
+
- pt-BR em toda saída de CLI
|
|
61
|
+
|
|
62
|
+
## 7. Riscos e mitigação
|
|
63
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
64
|
+
|---|---|---|---|
|
|
65
|
+
| codegraph ausente no ambiente do usuário | M | M | `code:*` degrada com aviso; gate não-bloqueante quando binário falta |
|
|
66
|
+
| Falso bloqueio por índice "defasado" | M | A | Heurística por mtime + warning de worktree do próprio codegraph, nunca por hash de cada arquivo |
|
|
67
|
+
| Gerador inchar projetos que não querem codegraph | B | M | `.mcp.json` e gates são aditivos e documentados como opcionais |
|
|
68
|
+
| Acoplar harness a versão específica do codegraph CLI | M | M | Usar só `init/status/sync` + MCP; parsear saída de forma tolerante |
|
|
69
|
+
|
|
70
|
+
## 8. Métricas de sucesso
|
|
71
|
+
30 dias após o release: (a) 100% dos projetos novos gerados saem com `.mcp.json` + `code:*` + GSD; (b) `gsd:check` passando inclui o gate codegraph; (c) pelo menos os papéis Architect/Worker referenciam `code:impact` nos handoffs de implementação registrados no SQLite.
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# Plan: Learning Loop — Registro de Incidentes + Sugestão por Similaridade
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-09-01
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem técnica
|
|
8
|
+
|
|
9
|
+
Nenhum pacote novo em `packages/engineering` — `GraphNode.type` já é vocabulário livre e
|
|
10
|
+
`GraphLoop.upsertNode`/`addEvidence` já fazem tudo que o registro precisa. `scripts/incident.ts` é
|
|
11
|
+
puramente um adapter: grava um nó `Incident` + evidência via `GraphLoop` (mesmo `SqliteGraphStore`
|
|
12
|
+
compartilhado de `adr:*`/`architecture:*`), e implementa o matching por palavra-chave de
|
|
13
|
+
`incident:similar` diretamente (função pequena e local, não uma dependência de
|
|
14
|
+
`GraphLoop.contextRecords` — D1).
|
|
15
|
+
|
|
16
|
+
## 2. Módulos afetados
|
|
17
|
+
|
|
18
|
+
| Caminho | Mudança | Risco |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| `scripts/incident.ts` | novo — `incident:record`/`:list`/`:similar` | Baixo — composição de `GraphLoop` já existente |
|
|
21
|
+
| `lib/core/registry.ts` | 3 comandos novos | Baixo |
|
|
22
|
+
| `test/incident-cli.test.js` (novo) | fixture isolada, ciclo completo | — |
|
|
23
|
+
|
|
24
|
+
## 3. Contratos
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
incident:record --title <t> [--description <d>]
|
|
28
|
+
incident:list
|
|
29
|
+
incident:similar "<busca>"
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## 4. Decisões
|
|
33
|
+
|
|
34
|
+
**D1**: `incident:similar` implementa seu próprio matching por palavra-chave local (mesmo estilo de
|
|
35
|
+
`GraphLoop.contextRecords`: normaliza pra minúsculo, quebra em termos, conta sobreposição,
|
|
36
|
+
`relevance = matches / totalTerms`), em vez de reaproveitar `contextRecords` diretamente.
|
|
37
|
+
`contextRecords` casa contra **arestas** (`from.label + type + to.label`); nós `Incident` desta
|
|
38
|
+
versão não têm aresta nenhuma (§5 do spec, "Fora" — linkagem fica pra depois), então
|
|
39
|
+
`contextRecords` nunca encontraria um nó sem aresta. Reimplementar o mesmo *estilo* de matching
|
|
40
|
+
sobre nós (não arestas) é a única forma de a busca funcionar nesta versão, sem duplicar a lógica de
|
|
41
|
+
extração de relação que `contextRecords` de fato tem (essa parte não é copiada, só o padrão de
|
|
42
|
+
scoring por sobreposição de termos, que é trivial e não vale abstrair numa função compartilhada por
|
|
43
|
+
uma linha de código).
|
|
44
|
+
|
|
45
|
+
**D2**: `Incident.label` carrega `título + '\n' + descrição` concatenados (não um campo separado —
|
|
46
|
+
`GraphNodeSpec` não tem campo de descrição livre além de `label`). Alternativa considerada: guardar
|
|
47
|
+
a descrição como uma segunda `Evidence`/nota — rejeitada por adicionar uma peça de dado sem
|
|
48
|
+
necessidade real nesta versão mínima; `label` já é uma string livre, suficiente pro matching de
|
|
49
|
+
AC-3.
|
|
50
|
+
|
|
51
|
+
## 5. Rollout
|
|
52
|
+
|
|
53
|
+
Sem migração, sem feature flag.
|
|
54
|
+
|
|
55
|
+
## 6. Kill criteria
|
|
56
|
+
|
|
57
|
+
Já coberto pelo mesmo princípio das specs anteriores — se `incident:similar` não corresponder a
|
|
58
|
+
julgamento humano sobre os incidentes de teste, o scoring é revisado antes de qualquer extensão
|
|
59
|
+
futura (linkagem de grafo, cross-project).
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
# Spec: Learning Loop — Registro de Incidentes + Sugestão por Similaridade
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-041
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprint 9 (primeiro sprint da Fase 6 da visão original — Learning Loop /
|
|
8
|
+
Incident → Knowledge; Cross-project Intelligence fica de fora, ver §5)
|
|
9
|
+
- **ADRs relacionadas**: ADR-0078; depende de `packages/graph.GraphLoop` (já existente —
|
|
10
|
+
`upsertNode`/`addEvidence`/`upsertEdge` reaproveitados sem mudança)
|
|
11
|
+
|
|
12
|
+
> Gap analysis original (`docs/architecture/...` §3): "`GraphLoop` + evidência já dão a base; falta
|
|
13
|
+
> o tipo de nó `Incident` e o fluxo de sugestão (nunca aplicação automática) — Construir,
|
|
14
|
+
> reaproveitando grafo + approvals." `GraphNode.type` já é vocabulário livre (o próprio doc já lista
|
|
15
|
+
> `Incident` em `ENGINEERING_NODE_TYPES` §6) — não precisa de contrato novo, só de um adapter que
|
|
16
|
+
> grava/consulta esse tipo.
|
|
17
|
+
|
|
18
|
+
## 1. Problema
|
|
19
|
+
|
|
20
|
+
Nada registra incidentes de forma consultável, nem sugere "isso já aconteceu antes" quando um novo
|
|
21
|
+
problema se parece com um antigo — cada incidente é resolvido isoladamente, sem acumular
|
|
22
|
+
conhecimento reconsultável.
|
|
23
|
+
|
|
24
|
+
## 2. Proposta de valor
|
|
25
|
+
|
|
26
|
+
`forja incident:record --title <t> [--description <d>]` registra um incidente no Engineering Graph
|
|
27
|
+
já existente; `forja incident:similar "<busca>"` sugere incidentes passados parecidos — sugestão
|
|
28
|
+
por palavra-chave, determinística, nunca aplica nada sozinha.
|
|
29
|
+
|
|
30
|
+
## 3. User stories
|
|
31
|
+
|
|
32
|
+
- **Como** governance, **quero** registrar um incidente de forma estruturada, **para que** ele vire
|
|
33
|
+
conhecimento consultável, não conhecimento tribal.
|
|
34
|
+
- **Como** desenvolvedor investigando um problema, **quero** ver incidentes parecidos já resolvidos,
|
|
35
|
+
**para que** eu não resolva o mesmo problema do zero toda vez.
|
|
36
|
+
|
|
37
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
38
|
+
|
|
39
|
+
- [x] AC-1: `forja incident:record --title <t> [--description <d>]` grava um nó `Incident` real no
|
|
40
|
+
Engineering Graph (`GraphLoop.upsertNode`+`addEvidence`, já existentes) — mesmo armazenamento
|
|
41
|
+
compartilhado já usado por `adr:*`/`architecture:*` (`SqliteGraphStore`), sem tabela nova.
|
|
42
|
+
- [x] AC-2: `forja incident:list` lista os incidentes registrados, mais recentes primeiro.
|
|
43
|
+
- [x] AC-3: `forja incident:similar "<busca>"` classifica incidentes registrados por sobreposição de
|
|
44
|
+
palavras-chave contra título+descrição — determinístico (mesmo estilo de matching já usado em
|
|
45
|
+
`GraphLoop.contextRecords`), sem LLM, sem inventar semântica que o texto não sustenta.
|
|
46
|
+
- [x] AC-4: **nunca aplicação automática** — nenhum comando desta spec chama `PolicyEngine`,
|
|
47
|
+
modifica arquivo, ou sugere uma correção como se fosse certeza. `incident:similar` é sempre
|
|
48
|
+
leitura/sugestão, nunca decisão.
|
|
49
|
+
- [x] AC-5: incidente sem nenhuma busca ainda registrada devolve lista vazia (não erro) em
|
|
50
|
+
`incident:similar`.
|
|
51
|
+
|
|
52
|
+
## 5. Escopo
|
|
53
|
+
|
|
54
|
+
**Dentro**: `incident:record`/`:list`/`:similar` — registro + sugestão por palavra-chave.
|
|
55
|
+
|
|
56
|
+
**Fora** (spec própria futura, mesmo princípio de escopo já usado nas specs anteriores):
|
|
57
|
+
- Vincular automaticamente um incidente a ADRs/arquivos/evidência (`--related-adr` etc.) — versão
|
|
58
|
+
mínima desta spec não faz linkagem de grafo além do próprio nó `Incident`+evidência de quem
|
|
59
|
+
registrou; linkagem exigiria resolver ids de nós já indexados (mesmo custo de reindexação de
|
|
60
|
+
`adr:*`), fora do escopo desta primeira entrega.
|
|
61
|
+
- "Lições aprendidas" geradas automaticamente (resumo/causa raiz sugerida por LLM) — proibido pelo
|
|
62
|
+
mesmo princípio de "determinístico antes de LLM" de toda a fundação; um humano escreve a
|
|
63
|
+
descrição, o sistema só indexa e sugere por palavra-chave.
|
|
64
|
+
- Cross-project Intelligence (correlacionar incidentes entre múltiplos projetos/repositórios) — este
|
|
65
|
+
workspace é de um único projeto; múltiplos projetos exigem uma fonte de dado que não existe hoje
|
|
66
|
+
(workspace compartilhado entre repos), fora de escopo.
|
|
67
|
+
|
|
68
|
+
## 6. NFRs / restrições
|
|
69
|
+
|
|
70
|
+
- Determinístico — nenhum LLM/ML em nenhum ponto; matching por palavra-chave, mesmo estilo já usado
|
|
71
|
+
em `GraphLoop.contextRecords`.
|
|
72
|
+
- Zero migration SQLite nova — reaproveita `SqliteGraphStore` já existente.
|
|
73
|
+
- Evidência de quem registrou (`source: 'forja.cli'`, fonte confiável já reconhecida por
|
|
74
|
+
`GraphLoop.addEvidence` — ver `DEFAULT_TRUSTED_EVIDENCE_SOURCES`) mantém o nó `verified`, não
|
|
75
|
+
`inferred` — é um humano registrando via CLI, ação deliberada, não uma inferência de agente.
|
|
76
|
+
|
|
77
|
+
## 7. Riscos e mitigação
|
|
78
|
+
|
|
79
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
80
|
+
|---|---|---|---|
|
|
81
|
+
| `incident:similar` prometer entendimento semântico que não tem (é só palavra-chave) | Média (nome "similar" sugere mais) | Baixa (decepção, não dado errado) | AC-3 explícito; saída indica o score de sobreposição, não uma alegação de "causa igual" |
|
|
82
|
+
| Incidentes virarem uma lista sem uso (write-only) | Média se a busca não for útil | Baixa | `incident:similar` é o consumidor imediato — não é write-only por design |
|
|
83
|
+
|
|
84
|
+
## 8. Métricas de sucesso
|
|
85
|
+
|
|
86
|
+
Registrar 2+ incidentes reais ou sintéticos documentados como tais, com um par claramente parecido
|
|
87
|
+
e um claramente diferente, e confirmar que `incident:similar` ordena corretamente — revisão humana,
|
|
88
|
+
mesma metodologia das specs anteriores.
|
|
89
|
+
|
|
90
|
+
**Validado** (`test/incident-cli.test.js`): 3 incidentes registrados, 2 deles reais achados desta
|
|
91
|
+
mesma sessão (SQLite writes não em lote, de SPEC-032; `sandboxEnvironment` sem `HOME`, de SPEC-038)
|
|
92
|
+
mais 1 claramente não relacionado (build de frontend). `incident:similar` de cada busca achou
|
|
93
|
+
exatamente o incidente correspondente, sem falso-positivo do incidente não relacionado.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Tasks: Learning Loop — Registro de Incidentes + Sugestão por Similaridade
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## T1 — `scripts/incident.ts`: record/list/similar
|
|
11
|
+
- **Owner**: worker
|
|
12
|
+
- **Estimativa**: M
|
|
13
|
+
- **Depende de**: —
|
|
14
|
+
- **Paths**: `scripts/incident.ts`, `lib/core/registry.ts`
|
|
15
|
+
- **Done quando**:
|
|
16
|
+
- [ ] `incident:record` grava nó `Incident` + evidência (`source: 'forja.cli'`) via `GraphLoop`,
|
|
17
|
+
sem migration nova
|
|
18
|
+
- [ ] `incident:list` lista mais recentes primeiro
|
|
19
|
+
- [ ] `incident:similar` implementa o matching de D1, nunca aplica nada (AC-4)
|
|
20
|
+
- [ ] `forja tools:doctor` continua verde
|
|
21
|
+
|
|
22
|
+
## T2 — prova sobre incidentes reais/sintéticos documentados
|
|
23
|
+
- **Owner**: worker
|
|
24
|
+
- **Estimativa**: P
|
|
25
|
+
- **Depende de**: T1
|
|
26
|
+
- **Paths**: `test/incident-cli.test.js` (novo)
|
|
27
|
+
- **Done quando**:
|
|
28
|
+
- [ ] 3 incidentes registrados (2 parecidos, 1 diferente), `incident:similar` ordena
|
|
29
|
+
corretamente
|
|
30
|
+
- [ ] `incident:similar` sem nenhum incidente registrado devolve vazio, não erro (AC-5)
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Handoffs entre agentes
|
|
35
|
+
|
|
36
|
+
T1 → T2 sequencial. Sem handoff de papel.
|
|
@@ -1,54 +1,54 @@
|
|
|
1
|
-
# Spec: memory-audit
|
|
2
|
-
|
|
3
|
-
- **ID**: SPEC-017
|
|
4
|
-
- **Status**: done
|
|
5
|
-
- **Owner**: apk
|
|
6
|
-
- **ADRs relacionadas**: ADR-0009 (economia de token), ADR-0025 (coerência da doc — a mesma classe), ADR-0020 (core/registry)
|
|
7
|
-
|
|
8
|
-
## 1. Problema
|
|
9
|
-
|
|
10
|
-
A economia de token do Forja é o `context.md` como mapa do domínio (`token:economy` mede −61%). Mas
|
|
11
|
-
o mapa cita paths de código — "a regra mora em `domain/order.entity.ts`", "teste em
|
|
12
|
-
`test/orders/place-order.spec.ts`". Quando o código é renomeado ou movido e o mapa não acompanha, o
|
|
13
|
-
mapa passa a **mentir com confiança**: um agente lê o lugar errado, paga o custo, e chega à conclusão
|
|
14
|
-
errada. Um mapa desatualizado é *pior* que mapa nenhum. Nada verifica isso hoje — vive de disciplina.
|
|
15
|
-
|
|
16
|
-
## 2. Proposta de valor
|
|
17
|
-
|
|
18
|
-
O mapa deixa de poder mentir em silêncio: **todo path de código citado num `context.md` é conferido**,
|
|
19
|
-
e uma referência pendurada reprova. É o `adr-refs` (ADR-0025) aplicado aos mapas de memória.
|
|
20
|
-
|
|
21
|
-
## 3. User stories
|
|
22
|
-
|
|
23
|
-
- **Como** dev de um projeto gerado, **quero** um comando que reprove quando um mapa aponta para
|
|
24
|
-
arquivo que não existe mais, **para que** a economia de token da memória não se volte contra mim.
|
|
25
|
-
- **Como** CI de um projeto, **quero** rodar isso como gate, **para que** um rename sem atualizar o
|
|
26
|
-
mapa não passe batido.
|
|
27
|
-
|
|
28
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
29
|
-
|
|
30
|
-
- [x] AC-1: `forja memory:audit` varre `memory/30-domains/*/context.md`, extrai os paths de código
|
|
31
|
-
citados (entre crases, com `/` e terminando em `.ts`) e reprova (exit ≠ 0) se algum não existe.
|
|
32
|
-
- [x] AC-2: Resolve o path em múltiplas bases (relativo ao módulo, ao `backend/`, à raiz) — um mesmo
|
|
33
|
-
mapa cita as duas convenções (`domain/x.ts` e `test/x.spec.ts`).
|
|
34
|
-
- [x] AC-3: `--project <path>` aponta para outro projeto (default: `cwd`).
|
|
35
|
-
- [x] AC-4: Lógica pura e testável (`lib/memory-audit.ts`); reusa `domainsOf` de `code-context`.
|
|
36
|
-
|
|
37
|
-
## 5. Escopo
|
|
38
|
-
|
|
39
|
-
**Dentro**: conferir paths de código `.ts` citados nos mapas de domínio.
|
|
40
|
-
|
|
41
|
-
**Fora** (explícito):
|
|
42
|
-
- Validar que o *conteúdo* do mapa (a linguagem ubíqua, as regras) ainda bate com o código — isso é
|
|
43
|
-
julgamento, não path. Este gate pega o path pendurado, que é o sinal barato e objetivo.
|
|
44
|
-
- Rodar dentro do `project:smoke` — lá o projeto é recém-gerado, o mapa é fresco por definição. A
|
|
45
|
-
divergência mapa↔código acontece com o tempo, num projeto existente; é aí que este comando roda.
|
|
46
|
-
|
|
47
|
-
## 6. NFRs / restrições
|
|
48
|
-
|
|
49
|
-
- **Compatibilidade**: comando novo; não muda nada. Sem rede, sem codegraph — leitura de disco.
|
|
50
|
-
|
|
51
|
-
## 7. Métricas de sucesso
|
|
52
|
-
|
|
53
|
-
Pelo menos um rename sem atualização de mapa pego antes do merge num projeto real — a prova de que a
|
|
54
|
-
fronteira estava descoberta.
|
|
1
|
+
# Spec: memory-audit
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-017
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **ADRs relacionadas**: ADR-0009 (economia de token), ADR-0025 (coerência da doc — a mesma classe), ADR-0020 (core/registry)
|
|
7
|
+
|
|
8
|
+
## 1. Problema
|
|
9
|
+
|
|
10
|
+
A economia de token do Forja é o `context.md` como mapa do domínio (`token:economy` mede −61%). Mas
|
|
11
|
+
o mapa cita paths de código — "a regra mora em `domain/order.entity.ts`", "teste em
|
|
12
|
+
`test/orders/place-order.spec.ts`". Quando o código é renomeado ou movido e o mapa não acompanha, o
|
|
13
|
+
mapa passa a **mentir com confiança**: um agente lê o lugar errado, paga o custo, e chega à conclusão
|
|
14
|
+
errada. Um mapa desatualizado é *pior* que mapa nenhum. Nada verifica isso hoje — vive de disciplina.
|
|
15
|
+
|
|
16
|
+
## 2. Proposta de valor
|
|
17
|
+
|
|
18
|
+
O mapa deixa de poder mentir em silêncio: **todo path de código citado num `context.md` é conferido**,
|
|
19
|
+
e uma referência pendurada reprova. É o `adr-refs` (ADR-0025) aplicado aos mapas de memória.
|
|
20
|
+
|
|
21
|
+
## 3. User stories
|
|
22
|
+
|
|
23
|
+
- **Como** dev de um projeto gerado, **quero** um comando que reprove quando um mapa aponta para
|
|
24
|
+
arquivo que não existe mais, **para que** a economia de token da memória não se volte contra mim.
|
|
25
|
+
- **Como** CI de um projeto, **quero** rodar isso como gate, **para que** um rename sem atualizar o
|
|
26
|
+
mapa não passe batido.
|
|
27
|
+
|
|
28
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
29
|
+
|
|
30
|
+
- [x] AC-1: `forja memory:audit` varre `memory/30-domains/*/context.md`, extrai os paths de código
|
|
31
|
+
citados (entre crases, com `/` e terminando em `.ts`) e reprova (exit ≠ 0) se algum não existe.
|
|
32
|
+
- [x] AC-2: Resolve o path em múltiplas bases (relativo ao módulo, ao `backend/`, à raiz) — um mesmo
|
|
33
|
+
mapa cita as duas convenções (`domain/x.ts` e `test/x.spec.ts`).
|
|
34
|
+
- [x] AC-3: `--project <path>` aponta para outro projeto (default: `cwd`).
|
|
35
|
+
- [x] AC-4: Lógica pura e testável (`lib/memory-audit.ts`); reusa `domainsOf` de `code-context`.
|
|
36
|
+
|
|
37
|
+
## 5. Escopo
|
|
38
|
+
|
|
39
|
+
**Dentro**: conferir paths de código `.ts` citados nos mapas de domínio.
|
|
40
|
+
|
|
41
|
+
**Fora** (explícito):
|
|
42
|
+
- Validar que o *conteúdo* do mapa (a linguagem ubíqua, as regras) ainda bate com o código — isso é
|
|
43
|
+
julgamento, não path. Este gate pega o path pendurado, que é o sinal barato e objetivo.
|
|
44
|
+
- Rodar dentro do `project:smoke` — lá o projeto é recém-gerado, o mapa é fresco por definição. A
|
|
45
|
+
divergência mapa↔código acontece com o tempo, num projeto existente; é aí que este comando roda.
|
|
46
|
+
|
|
47
|
+
## 6. NFRs / restrições
|
|
48
|
+
|
|
49
|
+
- **Compatibilidade**: comando novo; não muda nada. Sem rede, sem codegraph — leitura de disco.
|
|
50
|
+
|
|
51
|
+
## 7. Métricas de sucesso
|
|
52
|
+
|
|
53
|
+
Pelo menos um rename sem atualização de mapa pego antes do merge num projeto real — a prova de que a
|
|
54
|
+
fronteira estava descoberta.
|