forjajs 2.0.4 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +19 -25
- package/.claude/agents/governance.md +19 -55
- package/.claude/agents/marketing.md +19 -24
- package/.claude/agents/orchestrator.md +19 -31
- package/.claude/agents/product.md +19 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +19 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +93 -87
- package/.github/copilot-instructions.md +93 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +93 -87
- package/AGENTS.md +137 -134
- package/CHANGELOG.md +656 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +68 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +17 -1
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/release.js +3 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/llm/codex-output.d.ts +12 -0
- package/dist/lib/llm/codex-output.js +56 -0
- package/dist/lib/llm/context.d.ts +5 -0
- package/dist/lib/llm/context.js +17 -0
- package/dist/lib/llm/session.d.ts +18 -0
- package/dist/lib/llm/session.js +34 -0
- package/dist/lib/llm/validation.d.ts +37 -0
- package/dist/lib/llm/validation.js +88 -0
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/evals/src/index.js +6 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.d.ts +8 -1
- package/dist/packages/llm/src/index.js +64 -7
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +85 -9
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/agent-operating-contract.md +26 -0
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-evolution.md +51 -0
- package/docs/llm-fit-loop.md +134 -5
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/publishing.md +49 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/0080-llm-execution-evidence.md +42 -0
- package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +159 -157
- package/prompts/context-engineer-agent.md +13 -19
- package/prompts/governance-agent.md +13 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +13 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +13 -20
- package/skills/MANIFEST.json +10 -0
- package/skills/llm-provider-routing/SKILL.md +18 -0
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +50 -43
- package/specs/_templates/spec.md +50 -43
- package/specs/_templates/tasks.md +39 -32
- package/specs/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-instructions-v4/plan.md +8 -0
- package/specs/agent-instructions-v4/spec.md +21 -0
- package/specs/agent-instructions-v4/tasks.md +12 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/cost-aware-autonomy-budget/spec.md +102 -0
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/llm-integration-v2/plan.md +55 -0
- package/specs/llm-integration-v2/spec.md +61 -0
- package/specs/llm-integration-v2/tasks.md +28 -0
- package/specs/llm-resume-validation/plan.md +50 -0
- package/specs/llm-resume-validation/spec.md +35 -0
- package/specs/llm-resume-validation/tasks.md +19 -0
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/spec.md +23 -23
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* architecture:compile / :check / :status / :explain / :approve (SPEC-033)
|
|
4
|
+
*
|
|
5
|
+
* forja architecture:compile ADRs (## Constraints) → .context/architecture/constitution.json
|
|
6
|
+
* forja architecture:check constitution.json vs. Engineering Graph real
|
|
7
|
+
* forja architecture:status resumo: N regras ativas, N propostas, última compilação
|
|
8
|
+
* forja architecture:explain <id> ADR de origem, texto original, severidade
|
|
9
|
+
* forja architecture:approve <id> promove uma regra proposed a active (via ApprovalLedger)
|
|
10
|
+
*
|
|
11
|
+
* `packages/engineering/architecture` faz o parsing/checagem pura; este script é o adapter que lê
|
|
12
|
+
* `memory/90-decisions/*.md`, escreve `.context/architecture/constitution.json` (versionado em
|
|
13
|
+
* git — revisável em PR, não uma linha de SQLite) e resolve as arestas DEPENDS_ON reais via o
|
|
14
|
+
* mesmo GraphIndexer.sync que `adr:*`/`drift:check` já usam.
|
|
15
|
+
*/
|
|
16
|
+
import fs from 'node:fs';
|
|
17
|
+
import path from 'node:path';
|
|
18
|
+
import Database from 'better-sqlite3';
|
|
19
|
+
import { checkConstitution, compileConstitution, explainRule } from "../packages/engineering/architecture/src/index.js";
|
|
20
|
+
import { ApprovalLedger } from "../packages/policy/src/index.js";
|
|
21
|
+
import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
|
|
22
|
+
import { GraphIndexer, GraphLoop } from "../packages/graph/src/index.js";
|
|
23
|
+
import { SqliteApprovalStore, SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
|
|
24
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
|
|
25
|
+
const CONSTITUTION_PATH = '.context/architecture/constitution.json';
|
|
26
|
+
function graphRoot() {
|
|
27
|
+
return process.env.FORJA_GRAPH_ROOT ?? process.cwd();
|
|
28
|
+
}
|
|
29
|
+
function readAdrDocuments() {
|
|
30
|
+
const dir = path.join(graphRoot(), 'memory', '90-decisions');
|
|
31
|
+
if (!fs.existsSync(dir))
|
|
32
|
+
return [];
|
|
33
|
+
return fs.readdirSync(dir)
|
|
34
|
+
.filter((name) => name.endsWith('.md') && name !== '_template.md')
|
|
35
|
+
.map((name) => ({ source: path.join('memory', '90-decisions', name), content: fs.readFileSync(path.join(dir, name), 'utf8') }));
|
|
36
|
+
}
|
|
37
|
+
function loadConstitution() {
|
|
38
|
+
const file = path.join(graphRoot(), CONSTITUTION_PATH);
|
|
39
|
+
if (!fs.existsSync(file))
|
|
40
|
+
return { rules: [] };
|
|
41
|
+
return JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
42
|
+
}
|
|
43
|
+
function saveConstitution(rules) {
|
|
44
|
+
const file = path.join(graphRoot(), CONSTITUTION_PATH);
|
|
45
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
46
|
+
fs.writeFileSync(file, `${JSON.stringify({ compiledAt: new Date().toISOString(), rules }, null, 2)}\n`);
|
|
47
|
+
}
|
|
48
|
+
function cmdCompile() {
|
|
49
|
+
const adrs = readAdrDocuments();
|
|
50
|
+
const rules = compileConstitution(adrs);
|
|
51
|
+
saveConstitution(rules);
|
|
52
|
+
const active = rules.filter((rule) => rule.status === 'active').length;
|
|
53
|
+
console.log(`Compilado: ${rules.length} regra(s) de ${adrs.length} ADR(s) — ${active} active, ${rules.length - active} proposed.`);
|
|
54
|
+
console.log(`Gravado em ${CONSTITUTION_PATH}`);
|
|
55
|
+
if (rules.length - active > 0)
|
|
56
|
+
console.log('Regras proposed precisam de `architecture:approve <rule-id>` para valer — ver `architecture:status`.');
|
|
57
|
+
}
|
|
58
|
+
async function dependencyEdges() {
|
|
59
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
60
|
+
const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
61
|
+
new SqliteMigrationRunner(database).apply();
|
|
62
|
+
const store = new SqliteGraphStore(database);
|
|
63
|
+
const graph = new GraphLoop(store);
|
|
64
|
+
const source = new GitGraphDocumentSource(graphRoot(), new SpawnCommandRunner());
|
|
65
|
+
await new GraphIndexer(graph).sync(source);
|
|
66
|
+
try {
|
|
67
|
+
const edges = [];
|
|
68
|
+
for (const edge of store.listEdges()) {
|
|
69
|
+
if (edge.type !== 'DEPENDS_ON')
|
|
70
|
+
continue;
|
|
71
|
+
const fromNode = store.getNode(edge.from);
|
|
72
|
+
const toNode = store.getNode(edge.to);
|
|
73
|
+
if (fromNode === undefined || toNode === undefined)
|
|
74
|
+
continue;
|
|
75
|
+
edges.push({ fromPath: fromNode.label, targetLabel: toNode.label });
|
|
76
|
+
}
|
|
77
|
+
return edges;
|
|
78
|
+
}
|
|
79
|
+
finally {
|
|
80
|
+
database.close();
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
async function cmdCheck() {
|
|
84
|
+
const { rules } = loadConstitution();
|
|
85
|
+
if (rules.length === 0) {
|
|
86
|
+
console.log('Nenhuma regra compilada — rode `architecture:compile` primeiro.');
|
|
87
|
+
return;
|
|
88
|
+
}
|
|
89
|
+
const edges = await dependencyEdges();
|
|
90
|
+
const report = checkConstitution(rules, edges);
|
|
91
|
+
console.log(`\nARCHITECTURE DRIFT REPORT\n`);
|
|
92
|
+
console.log(`✓ ${report.compliant} regra(s) active em conformidade\n`);
|
|
93
|
+
if (report.violations.length === 0) {
|
|
94
|
+
console.log('Nenhuma violação.');
|
|
95
|
+
return;
|
|
96
|
+
}
|
|
97
|
+
console.log('VIOLATIONS\n');
|
|
98
|
+
for (const violation of report.violations) {
|
|
99
|
+
console.log(`${violation.severity.toUpperCase()}`);
|
|
100
|
+
console.log(`${violation.file}`);
|
|
101
|
+
console.log(`viola: ${violation.ruleId} (${violation.source})`);
|
|
102
|
+
console.log(`alvo: ${violation.target}`);
|
|
103
|
+
console.log(`remediação: ${violation.remediation}\n`);
|
|
104
|
+
}
|
|
105
|
+
process.exitCode = 1;
|
|
106
|
+
}
|
|
107
|
+
function cmdStatus() {
|
|
108
|
+
const { compiledAt, rules } = loadConstitution();
|
|
109
|
+
const active = rules.filter((rule) => rule.status === 'active');
|
|
110
|
+
const proposed = rules.filter((rule) => rule.status === 'proposed');
|
|
111
|
+
console.log(`Última compilação: ${compiledAt ?? '(nunca — rode architecture:compile)'}`);
|
|
112
|
+
console.log(`${active.length} regra(s) active, ${proposed.length} proposed.\n`);
|
|
113
|
+
for (const rule of active)
|
|
114
|
+
console.log(` active ${rule.id} (${rule.constraint.kind}: ${rule.constraint.target})`);
|
|
115
|
+
for (const rule of proposed)
|
|
116
|
+
console.log(` proposed ${rule.id} (confidence ${rule.confidence}) — precisa de architecture:approve`);
|
|
117
|
+
}
|
|
118
|
+
function cmdExplain([ruleId]) {
|
|
119
|
+
if (!ruleId) {
|
|
120
|
+
console.error('Uso: forja architecture:explain <rule-id>');
|
|
121
|
+
process.exitCode = 1;
|
|
122
|
+
return;
|
|
123
|
+
}
|
|
124
|
+
const { rules } = loadConstitution();
|
|
125
|
+
const rule = explainRule(rules, ruleId);
|
|
126
|
+
if (rule === undefined) {
|
|
127
|
+
console.error(`Regra não encontrada: ${ruleId}. Rode architecture:status para ver os ids.`);
|
|
128
|
+
process.exitCode = 1;
|
|
129
|
+
return;
|
|
130
|
+
}
|
|
131
|
+
console.log(`${rule.id} — ${rule.status} (severidade: ${rule.severity}, confidence: ${rule.confidence})`);
|
|
132
|
+
console.log(`origem: ${rule.source}`);
|
|
133
|
+
console.log(`escopo: ${rule.scope.paths.join(', ')}`);
|
|
134
|
+
console.log(`regra: ${rule.constraint.kind} → ${rule.constraint.target}`);
|
|
135
|
+
console.log(`texto original: "${rule.rationale}"`);
|
|
136
|
+
}
|
|
137
|
+
async function cmdApprove([ruleId]) {
|
|
138
|
+
if (!ruleId) {
|
|
139
|
+
console.error('Uso: forja architecture:approve <rule-id>');
|
|
140
|
+
process.exitCode = 1;
|
|
141
|
+
return;
|
|
142
|
+
}
|
|
143
|
+
const { rules } = loadConstitution();
|
|
144
|
+
const rule = explainRule(rules, ruleId);
|
|
145
|
+
if (rule === undefined) {
|
|
146
|
+
console.error(`Regra não encontrada: ${ruleId}.`);
|
|
147
|
+
process.exitCode = 1;
|
|
148
|
+
return;
|
|
149
|
+
}
|
|
150
|
+
if (rule.status === 'active') {
|
|
151
|
+
console.log(`${ruleId} já está active.`);
|
|
152
|
+
return;
|
|
153
|
+
}
|
|
154
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
155
|
+
const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
156
|
+
new SqliteMigrationRunner(database).apply();
|
|
157
|
+
const ledger = new ApprovalLedger(new SqliteApprovalStore(database));
|
|
158
|
+
const now = new Date().toISOString();
|
|
159
|
+
try {
|
|
160
|
+
const request = ledger.create({ action: 'architecture.rule.approve', justification: `Aprovação manual de regra de Constitution com confidence ${rule.confidence}: "${rule.rationale}"`, impact: `Regra ${ruleId} (${rule.constraint.kind} → ${rule.constraint.target}) passa a bloquear architecture:check`, expiresAt: '2099-01-01T00:00:00.000Z', correlationId: `architecture:${ruleId}` }, now);
|
|
161
|
+
ledger.decide(request.id, { decision: 'approved', approverId: (process.env.USER ?? 'operator'), decidedAt: now });
|
|
162
|
+
}
|
|
163
|
+
finally {
|
|
164
|
+
database.close();
|
|
165
|
+
}
|
|
166
|
+
const updated = rules.map((item) => (item.id === ruleId ? { ...item, status: 'active' } : item));
|
|
167
|
+
saveConstitution(updated);
|
|
168
|
+
console.log(`${ruleId} aprovado e promovido a active. Registrado no ApprovalLedger (correlationId: architecture:${ruleId}).`);
|
|
169
|
+
}
|
|
170
|
+
async function main() {
|
|
171
|
+
const [subcommand, ...rest] = process.argv.slice(2);
|
|
172
|
+
switch (subcommand) {
|
|
173
|
+
case 'compile': return cmdCompile();
|
|
174
|
+
case 'check': return cmdCheck();
|
|
175
|
+
case 'status': return cmdStatus();
|
|
176
|
+
case 'explain': return cmdExplain(rest);
|
|
177
|
+
case 'approve': return cmdApprove(rest);
|
|
178
|
+
default:
|
|
179
|
+
console.error('Uso: forja architecture:<compile|check|status|explain|approve> [args]');
|
|
180
|
+
process.exitCode = 1;
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
main().catch((error) => {
|
|
184
|
+
console.error(`\narchitecture: falhou: ${error instanceof Error ? error.message : String(error)}`);
|
|
185
|
+
process.exitCode = 1;
|
|
186
|
+
});
|
|
@@ -15,36 +15,36 @@ const db = new Database(dbPath, { readonly: true });
|
|
|
15
15
|
function getSmartContext() {
|
|
16
16
|
console.log(`🔍 Construindo contexto inteligente para: ${project} (Busca: ${taskKeyword || 'global'})...`);
|
|
17
17
|
// 1. Pegar arquivos globais obrigatórios
|
|
18
|
-
const globalNodes = db.prepare(`
|
|
19
|
-
SELECT title, content, path FROM memory_nodes
|
|
20
|
-
WHERE project_id IS NULL AND (path LIKE '%mission.md' OR path LIKE '%standards.md')
|
|
18
|
+
const globalNodes = db.prepare(`
|
|
19
|
+
SELECT title, content, path FROM memory_nodes
|
|
20
|
+
WHERE project_id IS NULL AND (path LIKE '%mission.md' OR path LIKE '%standards.md')
|
|
21
21
|
`).all();
|
|
22
22
|
// 2. Pegar arquivos do projeto por keyword ou gerais
|
|
23
23
|
let projectNodes = [];
|
|
24
24
|
if (taskKeyword) {
|
|
25
|
-
projectNodes = db.prepare(`
|
|
26
|
-
SELECT n.title, n.content, n.path
|
|
27
|
-
FROM memory_nodes n
|
|
28
|
-
JOIN projects p ON p.id = n.project_id
|
|
29
|
-
JOIN search_idx s ON s.node_id = n.id
|
|
30
|
-
WHERE p.name = ? AND search_idx MATCH ?
|
|
31
|
-
LIMIT 10
|
|
25
|
+
projectNodes = db.prepare(`
|
|
26
|
+
SELECT n.title, n.content, n.path
|
|
27
|
+
FROM memory_nodes n
|
|
28
|
+
JOIN projects p ON p.id = n.project_id
|
|
29
|
+
JOIN search_idx s ON s.node_id = n.id
|
|
30
|
+
WHERE p.name = ? AND search_idx MATCH ?
|
|
31
|
+
LIMIT 10
|
|
32
32
|
`).all(project, taskKeyword);
|
|
33
33
|
}
|
|
34
34
|
// 3. Pegar ADRs e Summaries recentes do projeto
|
|
35
|
-
const metadata = db.prepare(`
|
|
36
|
-
SELECT n.title, n.content, n.path
|
|
37
|
-
FROM memory_nodes n
|
|
38
|
-
JOIN projects p ON p.id = n.project_id
|
|
39
|
-
WHERE p.name = ? AND (n.kind = 'adr' OR n.kind = 'summary' OR n.path LIKE '%vision.md')
|
|
40
|
-
ORDER BY n.updated_at DESC LIMIT 5
|
|
35
|
+
const metadata = db.prepare(`
|
|
36
|
+
SELECT n.title, n.content, n.path
|
|
37
|
+
FROM memory_nodes n
|
|
38
|
+
JOIN projects p ON p.id = n.project_id
|
|
39
|
+
WHERE p.name = ? AND (n.kind = 'adr' OR n.kind = 'summary' OR n.path LIKE '%vision.md')
|
|
40
|
+
ORDER BY n.updated_at DESC LIMIT 5
|
|
41
41
|
`).all(project);
|
|
42
|
-
const designIndex = db.prepare(`
|
|
43
|
-
SELECT n.title, n.content, n.path
|
|
44
|
-
FROM memory_nodes n
|
|
45
|
-
JOIN projects p ON p.id = n.project_id
|
|
46
|
-
WHERE p.name = ? AND n.kind = 'design' AND n.path LIKE '%/design-md/INDEX.md'
|
|
47
|
-
ORDER BY n.updated_at DESC LIMIT 1
|
|
42
|
+
const designIndex = db.prepare(`
|
|
43
|
+
SELECT n.title, n.content, n.path
|
|
44
|
+
FROM memory_nodes n
|
|
45
|
+
JOIN projects p ON p.id = n.project_id
|
|
46
|
+
WHERE p.name = ? AND n.kind = 'design' AND n.path LIKE '%/design-md/INDEX.md'
|
|
47
|
+
ORDER BY n.updated_at DESC LIMIT 1
|
|
48
48
|
`).all(project);
|
|
49
49
|
const allNodes = [...globalNodes, ...projectNodes, ...metadata, ...designIndex];
|
|
50
50
|
let contextPack = `# SMART CONTEXT PACK: ${project.toUpperCase()}\n\n`;
|
|
@@ -48,11 +48,11 @@ function archiveOldLogs(dbPath, ageInDays) {
|
|
|
48
48
|
const cutoffDate = new Date();
|
|
49
49
|
cutoffDate.setDate(cutoffDate.getDate() - ageInDays);
|
|
50
50
|
const oldRuns = db
|
|
51
|
-
.prepare(`
|
|
52
|
-
SELECT id, project_id, completed_at, log_content
|
|
53
|
-
FROM memory_runs
|
|
54
|
-
WHERE completed_at < ?
|
|
55
|
-
LIMIT 100
|
|
51
|
+
.prepare(`
|
|
52
|
+
SELECT id, project_id, completed_at, log_content
|
|
53
|
+
FROM memory_runs
|
|
54
|
+
WHERE completed_at < ?
|
|
55
|
+
LIMIT 100
|
|
56
56
|
`)
|
|
57
57
|
.all(cutoffDate.toISOString());
|
|
58
58
|
console.log(` Found ${oldRuns.length} old runs to archive`);
|
|
@@ -69,9 +69,9 @@ function archiveOldLogs(dbPath, ageInDays) {
|
|
|
69
69
|
console.log(` ✅ Archived ${archived} runs`);
|
|
70
70
|
// 4. Cleanup de índices vazios
|
|
71
71
|
const emptyNodes = db
|
|
72
|
-
.prepare(`
|
|
73
|
-
SELECT COUNT(*) as cnt FROM memory_nodes
|
|
74
|
-
WHERE content IS NULL OR content = ''
|
|
72
|
+
.prepare(`
|
|
73
|
+
SELECT COUNT(*) as cnt FROM memory_nodes
|
|
74
|
+
WHERE content IS NULL OR content = ''
|
|
75
75
|
`)
|
|
76
76
|
.get();
|
|
77
77
|
if (emptyNodes.cnt > 0) {
|
|
@@ -82,9 +82,9 @@ function recordContextRun(kind, slug, filePath, content, limitTokens = null) {
|
|
|
82
82
|
const db = openDb();
|
|
83
83
|
const tokens = estimateTokens(content);
|
|
84
84
|
const status = limitTokens && tokens > limitTokens ? 'over_budget' : 'ok';
|
|
85
|
-
db.prepare(`
|
|
86
|
-
INSERT INTO context_runs (created_at, kind, slug, path, bytes, estimated_tokens, limit_tokens, status)
|
|
87
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?)
|
|
85
|
+
db.prepare(`
|
|
86
|
+
INSERT INTO context_runs (created_at, kind, slug, path, bytes, estimated_tokens, limit_tokens, status)
|
|
87
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?)
|
|
88
88
|
`).run(new Date().toISOString(), kind, slug || null, path.relative(projectRoot, filePath), content.length, tokens, limitTokens, status);
|
|
89
89
|
db.close();
|
|
90
90
|
}
|
|
@@ -99,15 +99,15 @@ function upsertSpecSummary(slug, content) {
|
|
|
99
99
|
.filter((part) => !part.endsWith('\n'))
|
|
100
100
|
.join('\n\n')
|
|
101
101
|
.slice(0, 3500);
|
|
102
|
-
db.prepare(`
|
|
103
|
-
INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
|
|
104
|
-
VALUES (?, ?, ?, ?, ?, ?)
|
|
105
|
-
ON CONFLICT(slug) DO UPDATE SET
|
|
106
|
-
status=excluded.status,
|
|
107
|
-
title=excluded.title,
|
|
108
|
-
summary=excluded.summary,
|
|
109
|
-
source_path=excluded.source_path,
|
|
110
|
-
updated_at=excluded.updated_at
|
|
102
|
+
db.prepare(`
|
|
103
|
+
INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
|
|
104
|
+
VALUES (?, ?, ?, ?, ?, ?)
|
|
105
|
+
ON CONFLICT(slug) DO UPDATE SET
|
|
106
|
+
status=excluded.status,
|
|
107
|
+
title=excluded.title,
|
|
108
|
+
summary=excluded.summary,
|
|
109
|
+
source_path=excluded.source_path,
|
|
110
|
+
updated_at=excluded.updated_at
|
|
111
111
|
`).run(slug, status, title, summary, `specs/${slug}/spec.md`, new Date().toISOString());
|
|
112
112
|
db.close();
|
|
113
113
|
}
|
|
@@ -405,15 +405,15 @@ function cmdAssetCatalog() {
|
|
|
405
405
|
}
|
|
406
406
|
const db = openDb();
|
|
407
407
|
const now = new Date().toISOString();
|
|
408
|
-
const stmt = db.prepare(`
|
|
409
|
-
INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
|
|
410
|
-
VALUES (?, ?, ?, ?, ?, ?)
|
|
411
|
-
ON CONFLICT(path) DO UPDATE SET
|
|
412
|
-
type=excluded.type,
|
|
413
|
-
name=excluded.name,
|
|
414
|
-
summary=excluded.summary,
|
|
415
|
-
tags=excluded.tags,
|
|
416
|
-
updated_at=excluded.updated_at
|
|
408
|
+
const stmt = db.prepare(`
|
|
409
|
+
INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
|
|
410
|
+
VALUES (?, ?, ?, ?, ?, ?)
|
|
411
|
+
ON CONFLICT(path) DO UPDATE SET
|
|
412
|
+
type=excluded.type,
|
|
413
|
+
name=excluded.name,
|
|
414
|
+
summary=excluded.summary,
|
|
415
|
+
tags=excluded.tags,
|
|
416
|
+
updated_at=excluded.updated_at
|
|
417
417
|
`);
|
|
418
418
|
for (const asset of assets) {
|
|
419
419
|
stmt.run(asset.type, asset.name, asset.path, asset.summary, asset.tags || asset.title, now);
|
|
@@ -434,14 +434,14 @@ function cmdAssetCatalog() {
|
|
|
434
434
|
console.log(`Asset catalog gerado: ${path.relative(root, outFile)} (${assets.length} assets)`);
|
|
435
435
|
}
|
|
436
436
|
function help() {
|
|
437
|
-
console.log(`Uso: node scripts/context-ops.mjs <command> [args]
|
|
438
|
-
|
|
439
|
-
Comandos:
|
|
440
|
-
budget <slug|arquivo> [limite] Mede tokens e falha se passar do limite
|
|
441
|
-
sprint-pack Gera .context/sprint-pack.md
|
|
442
|
-
agent-brief <role> <slug> Gera brief compacto por papel/feature
|
|
443
|
-
asset-catalog Cataloga boilerplates e design-md
|
|
444
|
-
manifests Gera manifests JSON para boilerplates/design-md
|
|
437
|
+
console.log(`Uso: node scripts/context-ops.mjs <command> [args]
|
|
438
|
+
|
|
439
|
+
Comandos:
|
|
440
|
+
budget <slug|arquivo> [limite] Mede tokens e falha se passar do limite
|
|
441
|
+
sprint-pack Gera .context/sprint-pack.md
|
|
442
|
+
agent-brief <role> <slug> Gera brief compacto por papel/feature
|
|
443
|
+
asset-catalog Cataloga boilerplates e design-md
|
|
444
|
+
manifests Gera manifests JSON para boilerplates/design-md
|
|
445
445
|
`);
|
|
446
446
|
}
|
|
447
447
|
const [cmd, ...rest] = process.argv.slice(2);
|
|
@@ -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 {};
|