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
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* cost-economy — SPEC-029 AC-5: `token:economy` mede tokens; isto mede o que realmente importa pra
|
|
4
|
+
* quem paga a conta, dólar. Novo comando (em vez de estender `token:economy` in-place) porque os
|
|
5
|
+
* dois eixos medem coisas diferentes: `token:economy` compara CENÁRIOS sintéticos de fixture
|
|
6
|
+
* (arquitetura clean vs flat, memória quente vs fria — nunca rodou um LLM de verdade). `cost:economy`
|
|
7
|
+
* agrega OBSERVAÇÕES REAIS já gravadas por `forja llm:run` (mesmo `ObservationStore` de `llm:eval`),
|
|
8
|
+
* multiplicadas pela tabela de preço local (`lib/core/model-pricing.json`, AC-3). Reaproveitar o
|
|
9
|
+
* comando de fixture faria "economia de token" parecer "economia de custo" sobre dados que nunca
|
|
10
|
+
* geraram custo real — daí o comando irmão em vez de uma seção dentro de `token:economy`.
|
|
11
|
+
*
|
|
12
|
+
* Escopo por projeto/domínio: cada projeto tem seu próprio workspace/DB (FORJA_WORKSPACE), então
|
|
13
|
+
* rodar `forja cost:economy` dentro do workspace de um projeto já reporta o custo DAQUELE projeto —
|
|
14
|
+
* sem precisar de um campo `projectId` novo em `Observation` (fora do escopo deste spec).
|
|
15
|
+
*
|
|
16
|
+
* Estimativa, não fatura: nomeado explicitamente nos dois formatos de saída (mitigação de risco do
|
|
17
|
+
* SPEC-029 — "confundir custo estimado com custo real cobrado").
|
|
18
|
+
*/
|
|
19
|
+
import fs from 'node:fs';
|
|
20
|
+
import Database from 'better-sqlite3';
|
|
21
|
+
import { SqliteMigrationRunner, SqliteObservationStore } from "../packages/adapter-sqlite/src/index.js";
|
|
22
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath, getWorkspaceInfo } from "../lib/workspace.js";
|
|
23
|
+
import { loadPricingTable, lookupPrice } from "../lib/core/model-pricing.js";
|
|
24
|
+
function main() {
|
|
25
|
+
const info = getWorkspaceInfo();
|
|
26
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
27
|
+
const db = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
28
|
+
new SqliteMigrationRunner(db).apply();
|
|
29
|
+
const store = new SqliteObservationStore(db);
|
|
30
|
+
const observations = store.list();
|
|
31
|
+
db.close();
|
|
32
|
+
const table = loadPricingTable();
|
|
33
|
+
const byModel = new Map();
|
|
34
|
+
let totalCostUsd = 0;
|
|
35
|
+
let unknownPricingCount = 0;
|
|
36
|
+
for (const observation of observations) {
|
|
37
|
+
const model = observation.model ?? '(sem modelo)';
|
|
38
|
+
const priceKnown = lookupPrice(table, observation.model) !== undefined;
|
|
39
|
+
const entry = byModel.get(model) ?? { count: 0, inputTokens: 0, outputTokens: 0, costUsd: 0, priceKnown };
|
|
40
|
+
entry.count += 1;
|
|
41
|
+
entry.inputTokens += observation.inputTokens;
|
|
42
|
+
entry.outputTokens += observation.outputTokens;
|
|
43
|
+
entry.costUsd += observation.cost ?? 0;
|
|
44
|
+
entry.priceKnown = entry.priceKnown || priceKnown;
|
|
45
|
+
byModel.set(model, entry);
|
|
46
|
+
totalCostUsd += observation.cost ?? 0;
|
|
47
|
+
if (!priceKnown)
|
|
48
|
+
unknownPricingCount += 1;
|
|
49
|
+
}
|
|
50
|
+
console.log(`\nCost economy — custo real acumulado (SPEC-029) — workspace: ${info.root}\n`);
|
|
51
|
+
console.log('Estimativa baseada na tabela local de preços (lib/core/model-pricing.json), NÃO a fatura do provider.\n');
|
|
52
|
+
if (observations.length === 0) {
|
|
53
|
+
console.log('Nenhuma observação registrada ainda. Rode `forja llm:run --profile <perfil> --prompt <texto>` para gerar execuções.');
|
|
54
|
+
}
|
|
55
|
+
else {
|
|
56
|
+
const rows = [...byModel.entries()].sort((left, right) => right[1].costUsd - left[1].costUsd);
|
|
57
|
+
for (const [model, entry] of rows) {
|
|
58
|
+
const flag = entry.priceKnown ? '' : ' (preço desconhecido nesta execução — custo pode estar subestimado)';
|
|
59
|
+
console.log(`■ ${model}${flag}`);
|
|
60
|
+
console.log(` execuções: ${entry.count} tokens: ${entry.inputTokens + entry.outputTokens} (in ${entry.inputTokens} / out ${entry.outputTokens})`);
|
|
61
|
+
console.log(` custo estimado: $${entry.costUsd.toFixed(4)}\n`);
|
|
62
|
+
}
|
|
63
|
+
console.log(`Total: $${totalCostUsd.toFixed(4)} estimado em ${observations.length} execução(ões).`);
|
|
64
|
+
if (unknownPricingCount > 0) {
|
|
65
|
+
console.log(`Aviso: ${unknownPricingCount} execução(ões) usaram modelo(s) sem preço na tabela local — custo real total pode ser maior que o mostrado. Atualize lib/core/model-pricing.json (\`forja llm:doctor\` lista os gaps).`);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
if (process.argv.includes('--json')) {
|
|
69
|
+
console.log(JSON.stringify({
|
|
70
|
+
workspace: info.root,
|
|
71
|
+
currency: table.currency,
|
|
72
|
+
totalCostUsd,
|
|
73
|
+
observationCount: observations.length,
|
|
74
|
+
unknownPricingCount,
|
|
75
|
+
byModel: Object.fromEntries(byModel),
|
|
76
|
+
}, null, 2));
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
main();
|
|
@@ -111,7 +111,6 @@ export async function runAutonomyDemo() {
|
|
|
111
111
|
cache: new SqliteContextCache(database),
|
|
112
112
|
}).build({ objective: 'corrigir teste falhando math.test.js', budget, includeContent: true, requireEvidence: false, correlationId });
|
|
113
113
|
const approvals = new ApprovalLedger(new SqliteApprovalStore(database));
|
|
114
|
-
let approved = false;
|
|
115
114
|
const policy = new PolicyEngine({
|
|
116
115
|
rules: [{ id: 'demo-code-write', priority: 100, effect: 'REQUIRE_APPROVAL', reason: 'Alteração de código exige aprovação humana', scope: { agentIds: [agent.id], capabilityIds: ['fixture.code.write'], environments: ['local'], categories: ['write'] } }],
|
|
117
116
|
approvalLedger: approvals,
|
|
@@ -152,14 +151,23 @@ export async function runAutonomyDemo() {
|
|
|
152
151
|
persistence: new SqliteRuntimePersistence(database),
|
|
153
152
|
memory: new GraphExecutionMemory(graph),
|
|
154
153
|
validator: { validate: (run, results) => {
|
|
155
|
-
const
|
|
154
|
+
const allEvidenceIds = results.flatMap((result) => result.evidence.map((item) => item.id));
|
|
155
|
+
const plan = createPlan(run.runId, testFile, [...new Set([...context.references.map((item) => item.id), ...allEvidenceIds])]);
|
|
156
156
|
const successfulResults = results.filter((result) => result.status === 'succeeded');
|
|
157
157
|
const testEvidenceIds = successfulResults.flatMap((result) => result.evidence.map((item) => item.id));
|
|
158
158
|
const testPassed = successfulResults.length > 0;
|
|
159
|
-
|
|
159
|
+
const scopeRespected = run.changedFiles.length === 1 && run.changedFiles[0] === testFile;
|
|
160
|
+
// This fixture has no build/lint/typecheck step, so it only claims what it actually ran
|
|
161
|
+
// (the sandboxed `npm test`) — DeterministicValidator now requires evidence behind every
|
|
162
|
+
// "passed" claim, so fabricating the other checks would just get them rejected.
|
|
163
|
+
return new DeterministicValidator().validate({ plan, changedFiles: run.changedFiles, requiredChecks: ['tests'], checks: [{ name: 'tests', passed: testPassed, evidenceIds: testEvidenceIds }], acceptance: [{ criterion: 'npm test passa na fixture', passed: testPassed, evidenceIds: testEvidenceIds }, { criterion: 'diff contém somente o teste falho', passed: scopeRespected, evidenceIds: scopeRespected ? allEvidenceIds : [] }], correlationId: run.correlationId });
|
|
160
164
|
} },
|
|
161
165
|
});
|
|
162
|
-
|
|
166
|
+
// `policy` is passed through unwrapped: the runtime tags every step of this run with the same
|
|
167
|
+
// stable correlationId (its own runId), so PolicyEngine.authorize() can recognize, on resume,
|
|
168
|
+
// that a human already decided the pending approval for this exact run — rather than needing a
|
|
169
|
+
// hand-rolled bypass that (incorrectly) would have granted ALLOW to every future request too.
|
|
170
|
+
const started = await runtime.start({ objective: 'Corrigir teste falhando na fixture externa', agent, budget, policy, correlationId });
|
|
163
171
|
const awaiting = await runtime.execute(started.runId);
|
|
164
172
|
if (awaiting.state !== 'awaiting_approval')
|
|
165
173
|
throw new Error(`Expected approval gate, got ${awaiting.state}`);
|
|
@@ -167,8 +175,7 @@ export async function runAutonomyDemo() {
|
|
|
167
175
|
if (approval === undefined)
|
|
168
176
|
throw new Error('Approval was not persisted');
|
|
169
177
|
approvals.decide(approval.id, { decision: 'approved', approverId: 'human.demo', decidedAt: now() });
|
|
170
|
-
|
|
171
|
-
const completed = await runtime.resume(started.runId);
|
|
178
|
+
const completed = await runtime.resume(started.runId, policy);
|
|
172
179
|
if (completed.state !== 'completed' || completed.validation?.status !== 'accepted')
|
|
173
180
|
throw new Error(`Runtime did not complete with accepted validation: ${completed.state}/${completed.validation?.status}`);
|
|
174
181
|
const diff = await sandbox.diff(session.id);
|
package/dist/scripts/dev.js
CHANGED
|
@@ -92,19 +92,19 @@ function showHelp() {
|
|
|
92
92
|
console.log(` ${cmd.padEnd(20)} - ${info.desc}`);
|
|
93
93
|
console.log(` ${' '.repeat(20)} Exemplo: npm run dev -- ${info.example}\n`);
|
|
94
94
|
}
|
|
95
|
-
console.log(`Variaveis de ambiente:
|
|
96
|
-
DEBUG=1 - Habilita verbose output
|
|
97
|
-
DRY_RUN=1 - Simula execução sem fazer mudanças
|
|
98
|
-
|
|
99
|
-
Exemplos:
|
|
100
|
-
|
|
101
|
-
npm run dev -- context:build task my-project "payment feature"
|
|
102
|
-
npm run dev -- memory:vacuum
|
|
103
|
-
npm run dev -- memory:sync my-project
|
|
104
|
-
npm run dev -- project:health
|
|
105
|
-
npm run dev -- project:init awesome-app
|
|
106
|
-
DEBUG=1 npm run dev -- project:health
|
|
107
|
-
|
|
95
|
+
console.log(`Variaveis de ambiente:
|
|
96
|
+
DEBUG=1 - Habilita verbose output
|
|
97
|
+
DRY_RUN=1 - Simula execução sem fazer mudanças
|
|
98
|
+
|
|
99
|
+
Exemplos:
|
|
100
|
+
|
|
101
|
+
npm run dev -- context:build task my-project "payment feature"
|
|
102
|
+
npm run dev -- memory:vacuum
|
|
103
|
+
npm run dev -- memory:sync my-project
|
|
104
|
+
npm run dev -- project:health
|
|
105
|
+
npm run dev -- project:init awesome-app
|
|
106
|
+
DEBUG=1 npm run dev -- project:health
|
|
107
|
+
|
|
108
108
|
`);
|
|
109
109
|
}
|
|
110
110
|
/**
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* drift:check — "verified" continua verdade? (SPEC-030)
|
|
4
|
+
*
|
|
5
|
+
* forja drift:check reindexa o workspace e reporta drift estrutural
|
|
6
|
+
* forja drift:check --domain <d> restringe aos documentos cujo path passa por /<d>/
|
|
7
|
+
*
|
|
8
|
+
* Reindexa via o mesmo mecanismo de `graph:sync` (checksum de fonte + extração determinística) e,
|
|
9
|
+
* para cada documento cujo conteúdo mudou, compara as relações `verified` que ele produzia antes
|
|
10
|
+
* com as que produz agora. Uma relação que sumiu vira `stale` (validTo carimbado, sem inventar
|
|
11
|
+
* status novo — GraphLoop já suporta validade temporal). Determinístico, sem LLM, sem rede: é
|
|
12
|
+
* extração + diff, igual ao extrator que já indexa o grafo (AC-4).
|
|
13
|
+
*
|
|
14
|
+
* Não corrige nada sozinho — só sinaliza. Decidir se o código ou a ADR/spec está desatualizada é
|
|
15
|
+
* julgamento humano ou de agente (SPEC-030 §5, fora de escopo deste comando).
|
|
16
|
+
*/
|
|
17
|
+
export {};
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* drift:check — "verified" continua verdade? (SPEC-030)
|
|
4
|
+
*
|
|
5
|
+
* forja drift:check reindexa o workspace e reporta drift estrutural
|
|
6
|
+
* forja drift:check --domain <d> restringe aos documentos cujo path passa por /<d>/
|
|
7
|
+
*
|
|
8
|
+
* Reindexa via o mesmo mecanismo de `graph:sync` (checksum de fonte + extração determinística) e,
|
|
9
|
+
* para cada documento cujo conteúdo mudou, compara as relações `verified` que ele produzia antes
|
|
10
|
+
* com as que produz agora. Uma relação que sumiu vira `stale` (validTo carimbado, sem inventar
|
|
11
|
+
* status novo — GraphLoop já suporta validade temporal). Determinístico, sem LLM, sem rede: é
|
|
12
|
+
* extração + diff, igual ao extrator que já indexa o grafo (AC-4).
|
|
13
|
+
*
|
|
14
|
+
* Não corrige nada sozinho — só sinaliza. Decidir se o código ou a ADR/spec está desatualizada é
|
|
15
|
+
* julgamento humano ou de agente (SPEC-030 §5, fora de escopo deste comando).
|
|
16
|
+
*/
|
|
17
|
+
import fs from 'node:fs';
|
|
18
|
+
import Database from 'better-sqlite3';
|
|
19
|
+
import { checkDrift } from "../lib/drift-sentinel.js";
|
|
20
|
+
import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
|
|
21
|
+
import { GraphLoop } from "../packages/graph/src/index.js";
|
|
22
|
+
import { SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
|
|
23
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
|
|
24
|
+
function arg(name) {
|
|
25
|
+
const i = process.argv.indexOf(name);
|
|
26
|
+
return i >= 0 ? process.argv[i + 1] ?? null : null;
|
|
27
|
+
}
|
|
28
|
+
function printReport(report, domain) {
|
|
29
|
+
console.log(`\nForja drift:check${domain ? ` --domain ${domain}` : ''} — o verified continua verdade?\n`);
|
|
30
|
+
console.log(`${report.documents} documento(s) verificado(s), ${report.unchanged} sem mudança, ${report.drifted} com drift detectado.\n`);
|
|
31
|
+
if (report.details.length === 0) {
|
|
32
|
+
console.log(report.changed > 0
|
|
33
|
+
? `✓ ${report.changed} documento(s) mudaram, mas toda relação verified anterior continua reproduzível.`
|
|
34
|
+
: '✓ nenhum documento mudou desde a última indexação.');
|
|
35
|
+
return;
|
|
36
|
+
}
|
|
37
|
+
for (const drift of report.details) {
|
|
38
|
+
console.log(`✗ ${drift.sourceKey} — ${drift.stale.length} relação(ões) ficaram stale:`);
|
|
39
|
+
for (const relation of drift.stale)
|
|
40
|
+
console.log(` ${relation.type}: ${relation.from} → ${relation.to} — verified antes, não reproduzida pela extração atual`);
|
|
41
|
+
}
|
|
42
|
+
console.log(`\n${report.drifted} documento(s) com drift. As arestas acima ganharam validTo — somem de query()/path()/impact() por padrão, mas continuam auditáveis com o parâmetro --at de quem consultar o grafo.`);
|
|
43
|
+
console.log('drift:check só sinaliza — corrigir a ADR/spec desatualizada ou reverter o código é decisão humana/de agente, não deste comando.');
|
|
44
|
+
}
|
|
45
|
+
async function main() {
|
|
46
|
+
const domain = arg('--domain');
|
|
47
|
+
const graphRoot = process.env.FORJA_GRAPH_ROOT ?? process.cwd();
|
|
48
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
49
|
+
const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
50
|
+
new SqliteMigrationRunner(database).apply();
|
|
51
|
+
const store = new SqliteGraphStore(database);
|
|
52
|
+
const graph = new GraphLoop(store);
|
|
53
|
+
const source = new GitGraphDocumentSource(graphRoot, new SpawnCommandRunner());
|
|
54
|
+
const report = await checkDrift(graph, store, source, domain === null ? {} : { domain });
|
|
55
|
+
database.close();
|
|
56
|
+
printReport(report, domain);
|
|
57
|
+
if (report.drifted > 0)
|
|
58
|
+
process.exit(1);
|
|
59
|
+
}
|
|
60
|
+
main().catch((error) => {
|
|
61
|
+
console.error(`\ndrift:check falhou: ${error instanceof Error ? error.message : String(error)}`);
|
|
62
|
+
process.exit(1);
|
|
63
|
+
});
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* engineer (SPEC-035, estendida por SPEC-042) — façade que compõe o que os Sprints 1-9 já
|
|
4
|
+
* construíram.
|
|
5
|
+
*
|
|
6
|
+
* forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]
|
|
7
|
+
*
|
|
8
|
+
* Ordem de composição (specs/engineering-evidence-ledger/plan.md, +SPEC-042):
|
|
9
|
+
* ContextEngine.build() → GraphLoop.contextRecords() filtrado a ADR/SPEC (SPEC-032) →
|
|
10
|
+
* architecture:check não escopado (SPEC-033) → RiskEngine.assess() só com --ref (SPEC-034,
|
|
11
|
+
* D1: sem diff ainda, não há arquivo pra escopar) → agentes recomendados só com --role
|
|
12
|
+
* (recommendAgent, SPEC-037) → incidentes parecidos (rankIncidentsByQuery, SPEC-041) → fluxo
|
|
13
|
+
* recomendado, parseado da tabela "Etapa → papel → comando" de docs/fluxo.md (D2 — uma fonte de
|
|
14
|
+
* verdade, não copiada aqui).
|
|
15
|
+
*
|
|
16
|
+
* Nenhuma lógica de negócio nova (AC-4/AC-3 de SPEC-035, reafirmado em AC-3 de SPEC-042): cada
|
|
17
|
+
* seção é exatamente o que o subsistema já produziu. Sem síntese de texto livre (AC-3) — não há
|
|
18
|
+
* chamada de LLM em nenhum ponto deste arquivo.
|
|
19
|
+
*/
|
|
20
|
+
export {};
|
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* engineer (SPEC-035, estendida por SPEC-042) — façade que compõe o que os Sprints 1-9 já
|
|
4
|
+
* construíram.
|
|
5
|
+
*
|
|
6
|
+
* forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]
|
|
7
|
+
*
|
|
8
|
+
* Ordem de composição (specs/engineering-evidence-ledger/plan.md, +SPEC-042):
|
|
9
|
+
* ContextEngine.build() → GraphLoop.contextRecords() filtrado a ADR/SPEC (SPEC-032) →
|
|
10
|
+
* architecture:check não escopado (SPEC-033) → RiskEngine.assess() só com --ref (SPEC-034,
|
|
11
|
+
* D1: sem diff ainda, não há arquivo pra escopar) → agentes recomendados só com --role
|
|
12
|
+
* (recommendAgent, SPEC-037) → incidentes parecidos (rankIncidentsByQuery, SPEC-041) → fluxo
|
|
13
|
+
* recomendado, parseado da tabela "Etapa → papel → comando" de docs/fluxo.md (D2 — uma fonte de
|
|
14
|
+
* verdade, não copiada aqui).
|
|
15
|
+
*
|
|
16
|
+
* Nenhuma lógica de negócio nova (AC-4/AC-3 de SPEC-035, reafirmado em AC-3 de SPEC-042): cada
|
|
17
|
+
* seção é exatamente o que o subsistema já produziu. Sem síntese de texto livre (AC-3) — não há
|
|
18
|
+
* chamada de LLM em nenhum ponto deste arquivo.
|
|
19
|
+
*/
|
|
20
|
+
import fs from 'node:fs';
|
|
21
|
+
import path from 'node:path';
|
|
22
|
+
import { randomUUID } from 'node:crypto';
|
|
23
|
+
import Database from 'better-sqlite3';
|
|
24
|
+
import { ContextEngine, GraphContextSource } from "../packages/context/src/index.js";
|
|
25
|
+
import { checkConstitution } from "../packages/engineering/architecture/src/index.js";
|
|
26
|
+
import { assessRisk } from "../packages/engineering/risk/src/index.js";
|
|
27
|
+
import { recommendAgent } from "../packages/engineering/identity/src/index.js";
|
|
28
|
+
import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
|
|
29
|
+
import { GraphIndexer, GraphLoop } from "../packages/graph/src/index.js";
|
|
30
|
+
import { SqliteAgentProfileStore, SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
|
|
31
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
|
|
32
|
+
import { buildRiskInput, changedFiles, graphRoot } from "../lib/core/risk-collect.js";
|
|
33
|
+
import { incidentRecords, rankIncidentsByQuery, titleOf } from "../lib/core/incident-search.js";
|
|
34
|
+
const CONSTITUTION_PATH = '.context/architecture/constitution.json';
|
|
35
|
+
const FLUXO_PATH = 'docs/fluxo.md';
|
|
36
|
+
/** Parseia a tabela "Etapa → papel → comando → capacidade" de docs/fluxo.md — D2 do plan: uma fonte de verdade, não copiada aqui. */
|
|
37
|
+
function recommendedFlow() {
|
|
38
|
+
const file = path.join(graphRoot(), FLUXO_PATH);
|
|
39
|
+
if (!fs.existsSync(file))
|
|
40
|
+
return [];
|
|
41
|
+
const rowPattern = /^\|\s*(\d+)\s*\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|$/gm;
|
|
42
|
+
const steps = [];
|
|
43
|
+
for (const match of fs.readFileSync(file, 'utf8').matchAll(rowPattern)) {
|
|
44
|
+
steps.push({ numero: match[1], etapa: match[2], papel: match[3], comandos: match[4], capacidade: match[5] });
|
|
45
|
+
}
|
|
46
|
+
return steps;
|
|
47
|
+
}
|
|
48
|
+
function relevantAdrs(graph, objective) {
|
|
49
|
+
return graph.contextRecords(objective)
|
|
50
|
+
.filter((record) => /\bADR-\d{4}\b|\bSPEC-\d{3,4}\b/.test(record.content))
|
|
51
|
+
.slice(0, 10)
|
|
52
|
+
.map((record) => ({ content: record.content, relevance: record.relevance }));
|
|
53
|
+
}
|
|
54
|
+
async function buildReport(objective, ref, role) {
|
|
55
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
56
|
+
const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
57
|
+
new SqliteMigrationRunner(database).apply();
|
|
58
|
+
try {
|
|
59
|
+
const store = new SqliteGraphStore(database);
|
|
60
|
+
const graph = new GraphLoop(store);
|
|
61
|
+
await new GraphIndexer(graph).sync(new GitGraphDocumentSource(graphRoot(), new SpawnCommandRunner()));
|
|
62
|
+
const context = await new ContextEngine({
|
|
63
|
+
graph: new GraphContextSource({ searchContext: (o) => graph.contextRecords(o) }),
|
|
64
|
+
// maxItems: 10 — sem isto, um objetivo genérico contra um repositório grande devolve
|
|
65
|
+
// centenas/milhares de candidatos (achado real: "compilar a architecture constitution deste
|
|
66
|
+
// repositório" contra este próprio repositório trouxe 1013). `forja engineer` é pra orientar
|
|
67
|
+
// o início do trabalho, não substituir `context:smart`/`code:query` — os 10 mais relevantes
|
|
68
|
+
// (já ordenados por `ContextEngine.build`) bastam pro humano decidir se e como prosseguir
|
|
69
|
+
// (AC-3/métrica §8); a lista completa continua disponível via os comandos focados.
|
|
70
|
+
}).build({ objective, budget: { inputTokens: 20000, outputTokens: 0, totalTokens: 20000, usedTokens: 0 }, includeContent: true, requireEvidence: false, maxItems: 10 });
|
|
71
|
+
const constitutionFile = path.join(graphRoot(), CONSTITUTION_PATH);
|
|
72
|
+
let architectureCheck;
|
|
73
|
+
if (fs.existsSync(constitutionFile)) {
|
|
74
|
+
const { rules } = JSON.parse(fs.readFileSync(constitutionFile, 'utf8'));
|
|
75
|
+
const edges = store.listEdges().flatMap((edge) => {
|
|
76
|
+
if (edge.type !== 'DEPENDS_ON')
|
|
77
|
+
return [];
|
|
78
|
+
const fromNode = store.getNode(edge.from);
|
|
79
|
+
const toNode = store.getNode(edge.to);
|
|
80
|
+
return fromNode === undefined || toNode === undefined ? [] : [{ fromPath: fromNode.label, targetLabel: toNode.label }];
|
|
81
|
+
});
|
|
82
|
+
architectureCheck = checkConstitution(rules, edges);
|
|
83
|
+
}
|
|
84
|
+
else {
|
|
85
|
+
architectureCheck = { note: 'Constitution não compilada ainda — rode `forja architecture:compile`.' };
|
|
86
|
+
}
|
|
87
|
+
let risk;
|
|
88
|
+
if (ref !== undefined) {
|
|
89
|
+
const paths = changedFiles(ref);
|
|
90
|
+
if (paths.length > 0) {
|
|
91
|
+
const input = await buildRiskInput(paths, database);
|
|
92
|
+
risk = assessRisk(input, { id: randomUUID(), changeId: ref, now: new Date().toISOString() });
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
// Só com --role: nunca inventa um papel que o usuário não informou (AC-1 de SPEC-042).
|
|
96
|
+
const recommendedAgents = role === undefined ? undefined : recommendAgent(new SqliteAgentProfileStore(database).list(), { role });
|
|
97
|
+
// Sempre presente (mesmo vazio) — incidentes parecidos com o objetivo, mesma busca por
|
|
98
|
+
// palavra-chave de `incident:similar` (AC-2 de SPEC-042).
|
|
99
|
+
const similarIncidents = rankIncidentsByQuery(incidentRecords(store), objective)
|
|
100
|
+
.slice(0, 5)
|
|
101
|
+
.map((item) => ({ id: item.record.id, title: titleOf(item.record), relevance: item.relevance }));
|
|
102
|
+
return {
|
|
103
|
+
objective,
|
|
104
|
+
...(ref === undefined ? {} : { ref }),
|
|
105
|
+
...(role === undefined ? {} : { role }),
|
|
106
|
+
context: { references: context.references.length, content: context.content },
|
|
107
|
+
relevantAdrs: relevantAdrs(graph, objective),
|
|
108
|
+
architectureCheck,
|
|
109
|
+
...(risk === undefined ? {} : { risk }),
|
|
110
|
+
...(recommendedAgents === undefined ? {} : { recommendedAgents }),
|
|
111
|
+
similarIncidents,
|
|
112
|
+
recommendedFlow: recommendedFlow(),
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
finally {
|
|
116
|
+
database.close();
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
function printText(report) {
|
|
120
|
+
console.log(`objetivo: ${report.objective}`);
|
|
121
|
+
if (report.ref !== undefined)
|
|
122
|
+
console.log(`ref: ${report.ref}`);
|
|
123
|
+
console.log('');
|
|
124
|
+
console.log(`CONTEXTO (${report.context.references} referência(s) do grafo)`);
|
|
125
|
+
if (report.context.content.length === 0)
|
|
126
|
+
console.log(' (nenhuma referência encontrada — objetivo novo, sem histórico ainda)');
|
|
127
|
+
for (const line of report.context.content)
|
|
128
|
+
console.log(` ${line}`);
|
|
129
|
+
console.log('');
|
|
130
|
+
console.log(`ADRs/SPECs RELEVANTES (${report.relevantAdrs.length})`);
|
|
131
|
+
if (report.relevantAdrs.length === 0)
|
|
132
|
+
console.log(' (nenhuma)');
|
|
133
|
+
for (const adr of report.relevantAdrs)
|
|
134
|
+
console.log(` [${adr.relevance.toFixed(2)}] ${adr.content}`);
|
|
135
|
+
console.log('');
|
|
136
|
+
console.log('ARCHITECTURE CHECK');
|
|
137
|
+
if ('note' in report.architectureCheck) {
|
|
138
|
+
console.log(` ${report.architectureCheck.note}`);
|
|
139
|
+
}
|
|
140
|
+
else {
|
|
141
|
+
console.log(` ${report.architectureCheck.compliant} regra(s) active em conformidade, ${report.architectureCheck.violations.length} violação(ões)`);
|
|
142
|
+
for (const violation of report.architectureCheck.violations)
|
|
143
|
+
console.log(` ${violation.severity.toUpperCase()} ${violation.file} viola ${violation.ruleId}`);
|
|
144
|
+
}
|
|
145
|
+
console.log('');
|
|
146
|
+
console.log('RISCO');
|
|
147
|
+
if (report.risk === undefined) {
|
|
148
|
+
console.log(' sem --ref — nenhuma mudança ainda para avaliar (rode com --ref <commit> quando houver um).');
|
|
149
|
+
}
|
|
150
|
+
else {
|
|
151
|
+
console.log(` score ${report.risk.score}/100 → ${report.risk.autonomyBand} (confidence ${(report.risk.confidence * 100).toFixed(0)}%)`);
|
|
152
|
+
}
|
|
153
|
+
console.log('');
|
|
154
|
+
if (report.recommendedAgents !== undefined) {
|
|
155
|
+
console.log(`AGENTES RECOMENDADOS (role: ${report.role})`);
|
|
156
|
+
if (report.recommendedAgents.length === 0)
|
|
157
|
+
console.log(' (nenhum agente registrado — rode forja agent:register primeiro)');
|
|
158
|
+
for (const item of report.recommendedAgents)
|
|
159
|
+
console.log(` ${item.agentId} score:${item.score} ${item.reasons.join(', ')}`);
|
|
160
|
+
console.log('');
|
|
161
|
+
}
|
|
162
|
+
console.log(`INCIDENTES PARECIDOS (${report.similarIncidents.length})`);
|
|
163
|
+
if (report.similarIncidents.length === 0)
|
|
164
|
+
console.log(' (nenhum)');
|
|
165
|
+
for (const item of report.similarIncidents)
|
|
166
|
+
console.log(` [${item.relevance.toFixed(2)}] ${item.id} ${item.title}`);
|
|
167
|
+
console.log('');
|
|
168
|
+
console.log('FLUXO RECOMENDADO (docs/fluxo.md)');
|
|
169
|
+
for (const step of report.recommendedFlow)
|
|
170
|
+
console.log(` ${step.numero}. ${step.etapa} (${step.papel}) — ${step.comandos}`);
|
|
171
|
+
}
|
|
172
|
+
async function cmdEngineer(args) {
|
|
173
|
+
const json = args.includes('--json');
|
|
174
|
+
const refIndex = args.indexOf('--ref');
|
|
175
|
+
const roleIndex = args.indexOf('--role');
|
|
176
|
+
const ref = refIndex === -1 ? undefined : args[refIndex + 1];
|
|
177
|
+
const role = roleIndex === -1 ? undefined : args[roleIndex + 1];
|
|
178
|
+
// Cada índice só entra em `consumed` quando a flag correspondente foi de fato encontrada — achado
|
|
179
|
+
// real da primeira versão deste arquivo: computar `refIndex + 1` incondicionalmente, mesmo com
|
|
180
|
+
// `refIndex === -1` (valendo 0), engolia o próprio objetivo quando nenhuma flag era passada.
|
|
181
|
+
const consumed = new Set();
|
|
182
|
+
if (refIndex !== -1) {
|
|
183
|
+
consumed.add(refIndex);
|
|
184
|
+
consumed.add(refIndex + 1);
|
|
185
|
+
}
|
|
186
|
+
if (roleIndex !== -1) {
|
|
187
|
+
consumed.add(roleIndex);
|
|
188
|
+
consumed.add(roleIndex + 1);
|
|
189
|
+
}
|
|
190
|
+
const objective = args.find((arg, index) => arg !== '--json' && !consumed.has(index));
|
|
191
|
+
if (!objective) {
|
|
192
|
+
console.error('Uso: forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]');
|
|
193
|
+
process.exitCode = 1;
|
|
194
|
+
return;
|
|
195
|
+
}
|
|
196
|
+
const report = await buildReport(objective, ref, role);
|
|
197
|
+
if (json)
|
|
198
|
+
console.log(JSON.stringify(report, null, 2));
|
|
199
|
+
else
|
|
200
|
+
printText(report);
|
|
201
|
+
}
|
|
202
|
+
async function main() {
|
|
203
|
+
await cmdEngineer(process.argv.slice(2));
|
|
204
|
+
}
|
|
205
|
+
main().catch((error) => {
|
|
206
|
+
console.error(`\nengineer: falhou: ${error instanceof Error ? error.message : String(error)}`);
|
|
207
|
+
process.exitCode = 1;
|
|
208
|
+
});
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* evidence:show (SPEC-035)
|
|
4
|
+
*
|
|
5
|
+
* forja evidence:show <run-id> view agregada de evidência de um run: intent, agente, testes,
|
|
6
|
+
* aprovações, arquivos alterados — tudo já persistido
|
|
7
|
+
*
|
|
8
|
+
* `packages/engineering/evidence` faz o mapeamento puro; este script busca o `RuntimeRun` real
|
|
9
|
+
* (`SqliteRuntimeRunStore`), os `AuditRecord`s cujo `aggregateId` é o run (`SqliteAuditStore`) e as
|
|
10
|
+
* `ApprovalRequest`s cujo `correlationId` é o run (`ApprovalLedger`) — nenhuma tabela nova.
|
|
11
|
+
*/
|
|
12
|
+
export {};
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* evidence:show (SPEC-035)
|
|
4
|
+
*
|
|
5
|
+
* forja evidence:show <run-id> view agregada de evidência de um run: intent, agente, testes,
|
|
6
|
+
* aprovações, arquivos alterados — tudo já persistido
|
|
7
|
+
*
|
|
8
|
+
* `packages/engineering/evidence` faz o mapeamento puro; este script busca o `RuntimeRun` real
|
|
9
|
+
* (`SqliteRuntimeRunStore`), os `AuditRecord`s cujo `aggregateId` é o run (`SqliteAuditStore`) e as
|
|
10
|
+
* `ApprovalRequest`s cujo `correlationId` é o run (`ApprovalLedger`) — nenhuma tabela nova.
|
|
11
|
+
*/
|
|
12
|
+
import fs from 'node:fs';
|
|
13
|
+
import Database from 'better-sqlite3';
|
|
14
|
+
import { buildEvidenceLedger } from "../packages/engineering/evidence/src/index.js";
|
|
15
|
+
import { ApprovalLedger } from "../packages/policy/src/index.js";
|
|
16
|
+
import { SqliteApprovalStore, SqliteAuditStore, SqliteMigrationRunner, SqliteRuntimeRunStore } from "../packages/adapter-sqlite/src/index.js";
|
|
17
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
|
|
18
|
+
function cmdShow([runId]) {
|
|
19
|
+
if (!runId) {
|
|
20
|
+
console.error('Uso: forja evidence:show <run-id>');
|
|
21
|
+
process.exitCode = 1;
|
|
22
|
+
return;
|
|
23
|
+
}
|
|
24
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
25
|
+
const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
26
|
+
new SqliteMigrationRunner(database).apply();
|
|
27
|
+
try {
|
|
28
|
+
const run = new SqliteRuntimeRunStore(database).get(runId);
|
|
29
|
+
if (run === undefined) {
|
|
30
|
+
console.error(`Run não encontrado: ${runId}.`);
|
|
31
|
+
process.exitCode = 1;
|
|
32
|
+
return;
|
|
33
|
+
}
|
|
34
|
+
const auditRecords = new SqliteAuditStore(database).list().filter((record) => record.aggregateId === runId);
|
|
35
|
+
const approvals = new ApprovalLedger(new SqliteApprovalStore(database)).list().filter((request) => request.correlationId === runId);
|
|
36
|
+
const record = buildEvidenceLedger({ run, auditRecords, approvals });
|
|
37
|
+
console.log(JSON.stringify(record, null, 2));
|
|
38
|
+
}
|
|
39
|
+
finally {
|
|
40
|
+
database.close();
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
async function main() {
|
|
44
|
+
const [subcommand, ...rest] = process.argv.slice(2);
|
|
45
|
+
switch (subcommand) {
|
|
46
|
+
case 'show': return cmdShow(rest);
|
|
47
|
+
default:
|
|
48
|
+
console.error('Uso: forja evidence:show <run-id>');
|
|
49
|
+
process.exitCode = 1;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
main().catch((error) => {
|
|
53
|
+
console.error(`\nevidence: falhou: ${error instanceof Error ? error.message : String(error)}`);
|
|
54
|
+
process.exitCode = 1;
|
|
55
|
+
});
|
|
@@ -12,11 +12,11 @@ function extractGlobalLessons() {
|
|
|
12
12
|
console.log('🧠 Extraindo lições aprendidas de todos os projetos para Memória Global...');
|
|
13
13
|
const db = new Database(dbPath, { readonly: true });
|
|
14
14
|
// Busca ADRs (Decisões) de todos os projetos
|
|
15
|
-
const adrs = db.prepare(`
|
|
16
|
-
SELECT n.title, n.content, p.name as project
|
|
17
|
-
FROM memory_nodes n
|
|
18
|
-
JOIN projects p ON p.id = n.project_id
|
|
19
|
-
WHERE n.kind = 'adr'
|
|
15
|
+
const adrs = db.prepare(`
|
|
16
|
+
SELECT n.title, n.content, p.name as project
|
|
17
|
+
FROM memory_nodes n
|
|
18
|
+
JOIN projects p ON p.id = n.project_id
|
|
19
|
+
WHERE n.kind = 'adr'
|
|
20
20
|
`).all();
|
|
21
21
|
let knowledgeBase = `# Base de Conhecimento Compartilhada (Patterns)\n\n`;
|
|
22
22
|
knowledgeBase += `> Gerado automaticamente via Cross-Project Analysis em: ${new Date().toISOString()}\n\n`;
|
package/dist/scripts/gates.d.ts
CHANGED
|
@@ -2,8 +2,12 @@
|
|
|
2
2
|
/**
|
|
3
3
|
* check:all — a bateria inteira de gates do framework, um veredito (SPEC-020).
|
|
4
4
|
*
|
|
5
|
-
* forja check:all
|
|
6
|
-
* forja check:all --full
|
|
5
|
+
* forja check:all coerência (doctor) + projeto gerado (smoke barato)
|
|
6
|
+
* forja check:all --full + tarball (release:check) + build do gerado (smoke --full)
|
|
7
|
+
* forja check:all --with-drift + drift:check (SPEC-030) — opt-in, não roda por padrão (custo de
|
|
8
|
+
* reindexar o workspace inteiro não foi medido em repos grandes)
|
|
9
|
+
* forja check:all --with-architecture + architecture:check (SPEC-033) — mesmo custo de reindexar,
|
|
10
|
+
* mesmo motivo pra ser opt-in
|
|
7
11
|
*
|
|
8
12
|
* Não substitui os gates focados — os agrega. "A casa está coerente?" num comando só.
|
|
9
13
|
*/
|
package/dist/scripts/gates.js
CHANGED
|
@@ -2,8 +2,12 @@
|
|
|
2
2
|
/**
|
|
3
3
|
* check:all — a bateria inteira de gates do framework, um veredito (SPEC-020).
|
|
4
4
|
*
|
|
5
|
-
* forja check:all
|
|
6
|
-
* forja check:all --full
|
|
5
|
+
* forja check:all coerência (doctor) + projeto gerado (smoke barato)
|
|
6
|
+
* forja check:all --full + tarball (release:check) + build do gerado (smoke --full)
|
|
7
|
+
* forja check:all --with-drift + drift:check (SPEC-030) — opt-in, não roda por padrão (custo de
|
|
8
|
+
* reindexar o workspace inteiro não foi medido em repos grandes)
|
|
9
|
+
* forja check:all --with-architecture + architecture:check (SPEC-033) — mesmo custo de reindexar,
|
|
10
|
+
* mesmo motivo pra ser opt-in
|
|
7
11
|
*
|
|
8
12
|
* Não substitui os gates focados — os agrega. "A casa está coerente?" num comando só.
|
|
9
13
|
*/
|
|
@@ -11,10 +15,16 @@ import { runGates, overallStatus } from "../lib/core/gates.js";
|
|
|
11
15
|
const TAG = { ok: 'OK ', warn: 'AVISO', fail: 'FALHA', skipped: '— ' };
|
|
12
16
|
async function main() {
|
|
13
17
|
const full = process.argv.includes('--full');
|
|
14
|
-
|
|
18
|
+
const withDrift = process.argv.includes('--with-drift');
|
|
19
|
+
const withArchitecture = process.argv.includes('--with-architecture');
|
|
20
|
+
console.log(`\nForja check:all${full ? ' (--full)' : ''}${withDrift ? ' (--with-drift)' : ''}${withArchitecture ? ' (--with-architecture)' : ''} — a bateria inteira, um veredito\n`);
|
|
15
21
|
if (full)
|
|
16
22
|
console.log('Inclui os gates caros (empacota o tarball, builda o backend gerado) — leva minutos.\n');
|
|
17
|
-
|
|
23
|
+
if (withDrift)
|
|
24
|
+
console.log('Inclui drift:check (SPEC-030) — reindexa o workspace inteiro por extração determinística.\n');
|
|
25
|
+
if (withArchitecture)
|
|
26
|
+
console.log('Inclui architecture:check (SPEC-033) — mesmo custo de reindexação de drift:check.\n');
|
|
27
|
+
const groups = await runGates({ full, withDrift, withArchitecture });
|
|
18
28
|
for (const g of groups) {
|
|
19
29
|
console.log(`▚ ${g.name}`);
|
|
20
30
|
for (const r of g.results) {
|
|
@@ -17,21 +17,21 @@ function generate() {
|
|
|
17
17
|
md += `| Projeto | ADRs | Summaries | Docs | Última Atividade |\n`;
|
|
18
18
|
md += `|---------|------|-----------|------|-------------------|\n`;
|
|
19
19
|
for (const p of projects) {
|
|
20
|
-
const stats = db.prepare(`
|
|
21
|
-
SELECT
|
|
22
|
-
SUM(CASE WHEN kind = 'adr' THEN 1 ELSE 0 END) as adrs,
|
|
23
|
-
SUM(CASE WHEN kind = 'summary' THEN 1 ELSE 0 END) as summaries,
|
|
24
|
-
COUNT(*) as total,
|
|
25
|
-
MAX(updated_at) as last_update
|
|
26
|
-
FROM memory_nodes
|
|
27
|
-
WHERE project_id = ?
|
|
20
|
+
const stats = db.prepare(`
|
|
21
|
+
SELECT
|
|
22
|
+
SUM(CASE WHEN kind = 'adr' THEN 1 ELSE 0 END) as adrs,
|
|
23
|
+
SUM(CASE WHEN kind = 'summary' THEN 1 ELSE 0 END) as summaries,
|
|
24
|
+
COUNT(*) as total,
|
|
25
|
+
MAX(updated_at) as last_update
|
|
26
|
+
FROM memory_nodes
|
|
27
|
+
WHERE project_id = ?
|
|
28
28
|
`).get(p.id);
|
|
29
29
|
md += `| **${p.name}** | ${stats.adrs} | ${stats.summaries} | ${stats.total} | ${stats.last_update.split('T')[0]} |\n`;
|
|
30
30
|
}
|
|
31
31
|
md += `\n## 🧠 Lições Globais Recentes\n\n`;
|
|
32
|
-
const recentLessons = db.prepare(`
|
|
33
|
-
SELECT title, path FROM memory_nodes
|
|
34
|
-
WHERE kind = 'global' AND path LIKE '%shared-knowledge.md'
|
|
32
|
+
const recentLessons = db.prepare(`
|
|
33
|
+
SELECT title, path FROM memory_nodes
|
|
34
|
+
WHERE kind = 'global' AND path LIKE '%shared-knowledge.md'
|
|
35
35
|
`).get();
|
|
36
36
|
if (recentLessons) {
|
|
37
37
|
md += `- [Clique aqui para ver a Base de Conhecimento Compartilhada](${recentLessons.path})\n`;
|