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
package/dist/bin/init-project.js
CHANGED
|
@@ -293,16 +293,16 @@ async function step02CopyInstructions(projectDir, opts) {
|
|
|
293
293
|
copied++;
|
|
294
294
|
}
|
|
295
295
|
// Criar INDEX
|
|
296
|
-
const indexContent = `# IA Assistants Configuration
|
|
297
|
-
|
|
298
|
-
Este diretório contém instruções específicas para cada IA assistant.
|
|
299
|
-
|
|
300
|
-
## Gestão de Cotas & Alternância
|
|
301
|
-
Para trocar de IA (ex: se acabar a cota), use o arquivo [models.json](./models.json) para identificar o próximo motor na fila de fallback.
|
|
302
|
-
|
|
303
|
-
## IAs Configuradas
|
|
304
|
-
|
|
305
|
-
${opts.ai.map((ai) => `- [${ai.toUpperCase()}](./${ai}.md)`).join('\n')}
|
|
296
|
+
const indexContent = `# IA Assistants Configuration
|
|
297
|
+
|
|
298
|
+
Este diretório contém instruções específicas para cada IA assistant.
|
|
299
|
+
|
|
300
|
+
## Gestão de Cotas & Alternância
|
|
301
|
+
Para trocar de IA (ex: se acabar a cota), use o arquivo [models.json](./models.json) para identificar o próximo motor na fila de fallback.
|
|
302
|
+
|
|
303
|
+
## IAs Configuradas
|
|
304
|
+
|
|
305
|
+
${opts.ai.map((ai) => `- [${ai.toUpperCase()}](./${ai}.md)`).join('\n')}
|
|
306
306
|
`;
|
|
307
307
|
fs.writeFileSync(path.join(instructionsDir, 'README.md'), indexContent);
|
|
308
308
|
// Criar models.json para interoperabilidade
|
|
@@ -434,34 +434,34 @@ async function step07ShowNextSteps(projectDir, opts) {
|
|
|
434
434
|
async function main() {
|
|
435
435
|
const { projectName, projectPath, opts } = parseArgs();
|
|
436
436
|
if (!projectName && !opts.interactive) {
|
|
437
|
-
console.log(`
|
|
438
|
-
init-project v0.6.0 (Workspace separado)
|
|
439
|
-
|
|
440
|
-
Cria projetos de produto no workspace Forja (padrão: ~/forja-workspace/projects).
|
|
441
|
-
O repositório do framework permanece isolado.
|
|
442
|
-
|
|
443
|
-
Uso: node bin/init-project.js <project-name> [opções]
|
|
444
|
-
|
|
445
|
-
Opções:
|
|
446
|
-
--ai <list> IAs para configurar (padrão: copilot,claude,gemini,codex)
|
|
447
|
-
--skip-backend Pula instalação do backend NestJS
|
|
448
|
-
--skip-db Pula inicialização do SQLite
|
|
449
|
-
--skip-git Pula inicialização do Git
|
|
450
|
-
--skip-design Pula cópia da biblioteca design-md
|
|
451
|
-
--interactive Modo interativo
|
|
452
|
-
--verbose Output detalhado
|
|
453
|
-
|
|
454
|
-
Workspace:
|
|
455
|
-
O caminho é resolvido por prioridade:
|
|
456
|
-
1. Variável de ambiente FORJA_WORKSPACE
|
|
457
|
-
2. Campo workspaceRoot em ~/.forjarc.json
|
|
458
|
-
3. Padrão: ~/forja-workspace
|
|
459
|
-
|
|
460
|
-
Exemplos:
|
|
461
|
-
node bin/init-project.js meu-projeto
|
|
462
|
-
node bin/init-project.js meu-projeto --ai copilot,claude
|
|
463
|
-
node bin/init-project.js meu-projeto --skip-backend
|
|
464
|
-
node bin/init-project.js --interactive
|
|
437
|
+
console.log(`
|
|
438
|
+
init-project v0.6.0 (Workspace separado)
|
|
439
|
+
|
|
440
|
+
Cria projetos de produto no workspace Forja (padrão: ~/forja-workspace/projects).
|
|
441
|
+
O repositório do framework permanece isolado.
|
|
442
|
+
|
|
443
|
+
Uso: node bin/init-project.js <project-name> [opções]
|
|
444
|
+
|
|
445
|
+
Opções:
|
|
446
|
+
--ai <list> IAs para configurar (padrão: copilot,claude,gemini,codex)
|
|
447
|
+
--skip-backend Pula instalação do backend NestJS
|
|
448
|
+
--skip-db Pula inicialização do SQLite
|
|
449
|
+
--skip-git Pula inicialização do Git
|
|
450
|
+
--skip-design Pula cópia da biblioteca design-md
|
|
451
|
+
--interactive Modo interativo
|
|
452
|
+
--verbose Output detalhado
|
|
453
|
+
|
|
454
|
+
Workspace:
|
|
455
|
+
O caminho é resolvido por prioridade:
|
|
456
|
+
1. Variável de ambiente FORJA_WORKSPACE
|
|
457
|
+
2. Campo workspaceRoot em ~/.forjarc.json
|
|
458
|
+
3. Padrão: ~/forja-workspace
|
|
459
|
+
|
|
460
|
+
Exemplos:
|
|
461
|
+
node bin/init-project.js meu-projeto
|
|
462
|
+
node bin/init-project.js meu-projeto --ai copilot,claude
|
|
463
|
+
node bin/init-project.js meu-projeto --skip-backend
|
|
464
|
+
node bin/init-project.js --interactive
|
|
465
465
|
`);
|
|
466
466
|
process.exit(0);
|
|
467
467
|
}
|
package/dist/lib/audit.js
CHANGED
|
@@ -32,9 +32,9 @@ async function openDb(env) {
|
|
|
32
32
|
const db = new Database(env.dbPath);
|
|
33
33
|
// Auto-suficiente: cria a própria tabela no db que abre. Idempotente, e desacopla o audit do
|
|
34
34
|
// ensureSchema do workspace — é o que torna a lógica testável contra um db temporário.
|
|
35
|
-
db.exec(`CREATE TABLE IF NOT EXISTS audit_runs (
|
|
36
|
-
line_hash TEXT PRIMARY KEY, ts TEXT, cmd TEXT, args TEXT,
|
|
37
|
-
exit_code INTEGER, duration_ms INTEGER
|
|
35
|
+
db.exec(`CREATE TABLE IF NOT EXISTS audit_runs (
|
|
36
|
+
line_hash TEXT PRIMARY KEY, ts TEXT, cmd TEXT, args TEXT,
|
|
37
|
+
exit_code INTEGER, duration_ms INTEGER
|
|
38
38
|
)`);
|
|
39
39
|
return db;
|
|
40
40
|
}
|
|
@@ -50,7 +50,7 @@ export async function syncAudit(env = defaultEnv()) {
|
|
|
50
50
|
}
|
|
51
51
|
const lines = env.fs.readFileSync(env.jsonlPath, 'utf8').split('\n').filter((l) => l.trim());
|
|
52
52
|
const db = await openDb(env);
|
|
53
|
-
const insert = db.prepare(`INSERT OR IGNORE INTO audit_runs (line_hash, ts, cmd, args, exit_code, duration_ms)
|
|
53
|
+
const insert = db.prepare(`INSERT OR IGNORE INTO audit_runs (line_hash, ts, cmd, args, exit_code, duration_ms)
|
|
54
54
|
VALUES (@line_hash, @ts, @cmd, @args, @exit_code, @duration_ms)`);
|
|
55
55
|
let ingested = 0;
|
|
56
56
|
let skipped = 0;
|
|
@@ -112,8 +112,8 @@ export async function queryAudit(env = defaultEnv(), opts = {}) {
|
|
|
112
112
|
}
|
|
113
113
|
if (opts.failed)
|
|
114
114
|
where.push('exit_code != 0');
|
|
115
|
-
const sql = `SELECT ts, cmd, args, exit_code AS exitCode, duration_ms AS durationMs
|
|
116
|
-
FROM audit_runs ${where.length ? 'WHERE ' + where.join(' AND ') : ''}
|
|
115
|
+
const sql = `SELECT ts, cmd, args, exit_code AS exitCode, duration_ms AS durationMs
|
|
116
|
+
FROM audit_runs ${where.length ? 'WHERE ' + where.join(' AND ') : ''}
|
|
117
117
|
ORDER BY ts DESC`;
|
|
118
118
|
const rows = db.prepare(sql).all(params);
|
|
119
119
|
db.close();
|
|
@@ -127,7 +127,7 @@ export async function auditSummary(env = defaultEnv()) {
|
|
|
127
127
|
const db = await openDb(env);
|
|
128
128
|
const total = db.prepare('SELECT count(*) AS n FROM audit_runs').get().n;
|
|
129
129
|
const fails = db.prepare('SELECT count(*) AS n FROM audit_runs WHERE exit_code != 0').get().n;
|
|
130
|
-
const byCmd = db.prepare(`SELECT cmd, count(*) AS runs, sum(exit_code != 0) AS fails, round(avg(duration_ms)) AS avgMs
|
|
130
|
+
const byCmd = db.prepare(`SELECT cmd, count(*) AS runs, sum(exit_code != 0) AS fails, round(avg(duration_ms)) AS avgMs
|
|
131
131
|
FROM audit_runs GROUP BY cmd ORDER BY runs DESC`).all();
|
|
132
132
|
const slowest = db.prepare('SELECT cmd, max(duration_ms) AS ms FROM audit_runs GROUP BY cmd ORDER BY ms DESC LIMIT 5').all();
|
|
133
133
|
const recent = db.prepare('SELECT ts, cmd, exit_code AS exitCode, duration_ms AS durationMs FROM audit_runs ORDER BY ts DESC LIMIT 12').all();
|
package/dist/lib/code-context.js
CHANGED
|
@@ -72,6 +72,12 @@ function moduleFiles(projectRoot, domain, env) {
|
|
|
72
72
|
* a exploração. Com `includeCode`, anexa o código da fatia — o que se lê ao *editar*.
|
|
73
73
|
*/
|
|
74
74
|
export function buildContextPack({ projectRoot, domain, includeCode = false }, env = defaultFsEnv) {
|
|
75
|
+
// Allowlist against the domains the project actually declares (memory/30-domains/*) — rejects early
|
|
76
|
+
// rather than sanitizing, since it's information this function already has and a traversal payload
|
|
77
|
+
// (e.g. "../../etc") can never literally equal one of those directory names.
|
|
78
|
+
if (!domainsOf(projectRoot, env).includes(domain)) {
|
|
79
|
+
return { domain, found: false, mapPath: null, map: null, mapTokens: 0, code: [], codeTokens: 0, totalTokens: 0 };
|
|
80
|
+
}
|
|
75
81
|
const mapPath = path.join(projectRoot, 'memory', '30-domains', domain, 'context.md');
|
|
76
82
|
let map = null;
|
|
77
83
|
try {
|
|
@@ -89,16 +89,16 @@ export class ContextBuilder {
|
|
|
89
89
|
*/
|
|
90
90
|
_getGlobalNodes() {
|
|
91
91
|
try {
|
|
92
|
-
const stmt = this.db.prepare(`
|
|
93
|
-
SELECT title, content, path FROM memory_nodes
|
|
94
|
-
WHERE project_id IS NULL
|
|
95
|
-
AND (
|
|
96
|
-
path LIKE '%mission.md'
|
|
97
|
-
OR path LIKE '%standards.md'
|
|
98
|
-
OR path LIKE '%ADR-%'
|
|
99
|
-
)
|
|
100
|
-
ORDER BY updated_at DESC
|
|
101
|
-
LIMIT 10
|
|
92
|
+
const stmt = this.db.prepare(`
|
|
93
|
+
SELECT title, content, path FROM memory_nodes
|
|
94
|
+
WHERE project_id IS NULL
|
|
95
|
+
AND (
|
|
96
|
+
path LIKE '%mission.md'
|
|
97
|
+
OR path LIKE '%standards.md'
|
|
98
|
+
OR path LIKE '%ADR-%'
|
|
99
|
+
)
|
|
100
|
+
ORDER BY updated_at DESC
|
|
101
|
+
LIMIT 10
|
|
102
102
|
`);
|
|
103
103
|
return stmt.all() || [];
|
|
104
104
|
}
|
|
@@ -112,19 +112,19 @@ export class ContextBuilder {
|
|
|
112
112
|
*/
|
|
113
113
|
_getDomainNodes(project) {
|
|
114
114
|
try {
|
|
115
|
-
const stmt = this.db.prepare(`
|
|
116
|
-
SELECT DISTINCT n.title, n.content, n.path
|
|
117
|
-
FROM memory_nodes n
|
|
118
|
-
JOIN projects p ON p.id = n.project_id
|
|
119
|
-
WHERE p.name = ?
|
|
120
|
-
AND (
|
|
121
|
-
n.path LIKE '%vision.md'
|
|
122
|
-
OR n.path LIKE '%design%'
|
|
123
|
-
OR n.path LIKE '%rules.md'
|
|
124
|
-
OR n.path LIKE '%summary%'
|
|
125
|
-
)
|
|
126
|
-
ORDER BY n.updated_at DESC
|
|
127
|
-
LIMIT 15
|
|
115
|
+
const stmt = this.db.prepare(`
|
|
116
|
+
SELECT DISTINCT n.title, n.content, n.path
|
|
117
|
+
FROM memory_nodes n
|
|
118
|
+
JOIN projects p ON p.id = n.project_id
|
|
119
|
+
WHERE p.name = ?
|
|
120
|
+
AND (
|
|
121
|
+
n.path LIKE '%vision.md'
|
|
122
|
+
OR n.path LIKE '%design%'
|
|
123
|
+
OR n.path LIKE '%rules.md'
|
|
124
|
+
OR n.path LIKE '%summary%'
|
|
125
|
+
)
|
|
126
|
+
ORDER BY n.updated_at DESC
|
|
127
|
+
LIMIT 15
|
|
128
128
|
`);
|
|
129
129
|
return stmt.all(project) || [];
|
|
130
130
|
}
|
|
@@ -138,15 +138,15 @@ export class ContextBuilder {
|
|
|
138
138
|
*/
|
|
139
139
|
_getTaskNodes(project, keyword) {
|
|
140
140
|
try {
|
|
141
|
-
const stmt = this.db.prepare(`
|
|
142
|
-
SELECT DISTINCT n.title, n.content, n.path
|
|
143
|
-
FROM memory_nodes n
|
|
144
|
-
JOIN projects p ON p.id = n.project_id
|
|
145
|
-
LEFT JOIN search_idx s ON s.node_id = n.id
|
|
146
|
-
WHERE p.name = ?
|
|
147
|
-
AND (n.content LIKE ? OR s.content MATCH ?)
|
|
148
|
-
ORDER BY n.updated_at DESC
|
|
149
|
-
LIMIT 20
|
|
141
|
+
const stmt = this.db.prepare(`
|
|
142
|
+
SELECT DISTINCT n.title, n.content, n.path
|
|
143
|
+
FROM memory_nodes n
|
|
144
|
+
JOIN projects p ON p.id = n.project_id
|
|
145
|
+
LEFT JOIN search_idx s ON s.node_id = n.id
|
|
146
|
+
WHERE p.name = ?
|
|
147
|
+
AND (n.content LIKE ? OR s.content MATCH ?)
|
|
148
|
+
ORDER BY n.updated_at DESC
|
|
149
|
+
LIMIT 20
|
|
150
150
|
`);
|
|
151
151
|
const pattern = `%${keyword}%`;
|
|
152
152
|
return stmt.all(project, pattern, keyword) || [];
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/core/architecture-gate.ts — ponte opt-in entre `architecture:check` (SPEC-033) e `check:all`
|
|
3
|
+
* (AC-7).
|
|
4
|
+
*
|
|
5
|
+
* Mesmo padrão de `lib/core/drift-gate.ts`: chama o comando real via subprocess em vez de
|
|
6
|
+
* reimportar os internals, e traduz o resultado num `Result` do runner de gates. `architecture:check`
|
|
7
|
+
* reindexa o workspace inteiro (mesmo custo de `drift:check`/`graph:sync`) — por isso opt-in
|
|
8
|
+
* (`--with-architecture`), não o comportamento padrão de `check:all`.
|
|
9
|
+
*
|
|
10
|
+
* `severity: 'critical'` on a violation (not `'warn'` like the drift-gate — the gate runner's own
|
|
11
|
+
* `Severity` type is only `'critical' | 'warn'`, a coarser vocabulary than `ArchitectureSeverity`):
|
|
12
|
+
* a violation only exists because a rule reached `active` — either the deterministic parser had
|
|
13
|
+
* confidence 1, or a human explicitly ran `architecture:approve`. Unlike drift (which signals
|
|
14
|
+
* something for review, no prior judgment of right/wrong), an `active` rule is by definition a
|
|
15
|
+
* decision someone already confirmed should be respected — violating it is a real failure, not an
|
|
16
|
+
* invitation to review, so (unlike drift) it's allowed to escalate `check:all`'s verdict to `fail`.
|
|
17
|
+
*/
|
|
18
|
+
import type { Result } from './checks.ts';
|
|
19
|
+
/** Roda `architecture:check` num subprocesso e traduz o resultado num `Result` de gate. */
|
|
20
|
+
export declare function runArchitectureGate(): Promise<Result[]>;
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/core/architecture-gate.ts — ponte opt-in entre `architecture:check` (SPEC-033) e `check:all`
|
|
3
|
+
* (AC-7).
|
|
4
|
+
*
|
|
5
|
+
* Mesmo padrão de `lib/core/drift-gate.ts`: chama o comando real via subprocess em vez de
|
|
6
|
+
* reimportar os internals, e traduz o resultado num `Result` do runner de gates. `architecture:check`
|
|
7
|
+
* reindexa o workspace inteiro (mesmo custo de `drift:check`/`graph:sync`) — por isso opt-in
|
|
8
|
+
* (`--with-architecture`), não o comportamento padrão de `check:all`.
|
|
9
|
+
*
|
|
10
|
+
* `severity: 'critical'` on a violation (not `'warn'` like the drift-gate — the gate runner's own
|
|
11
|
+
* `Severity` type is only `'critical' | 'warn'`, a coarser vocabulary than `ArchitectureSeverity`):
|
|
12
|
+
* a violation only exists because a rule reached `active` — either the deterministic parser had
|
|
13
|
+
* confidence 1, or a human explicitly ran `architecture:approve`. Unlike drift (which signals
|
|
14
|
+
* something for review, no prior judgment of right/wrong), an `active` rule is by definition a
|
|
15
|
+
* decision someone already confirmed should be respected — violating it is a real failure, not an
|
|
16
|
+
* invitation to review, so (unlike drift) it's allowed to escalate `check:all`'s verdict to `fail`.
|
|
17
|
+
*/
|
|
18
|
+
import { spawnSync } from 'node:child_process';
|
|
19
|
+
import path from 'node:path';
|
|
20
|
+
import { fileURLToPath } from 'node:url';
|
|
21
|
+
import { resolveScript } from "./registry.js";
|
|
22
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
23
|
+
const repoRoot = path.resolve(path.dirname(__filename), '..', '..');
|
|
24
|
+
const ID = 'architecture-check';
|
|
25
|
+
const TITLE = 'architecture:check — o código respeita a Constitution compilada (SPEC-033, opt-in)';
|
|
26
|
+
/** Cada violação imprime sua própria linha de severidade (ver cmdCheck em scripts/architecture.ts)
|
|
27
|
+
* — contar essas linhas é mais direto que reanalisar o relatório inteiro aqui. */
|
|
28
|
+
function violationCountFrom(stdout) {
|
|
29
|
+
return stdout.split('\n').filter((line) => /^(INFO|LOW|MEDIUM|HIGH|CRITICAL)$/.test(line.trim())).length;
|
|
30
|
+
}
|
|
31
|
+
/** Roda `architecture:check` num subprocesso e traduz o resultado num `Result` de gate. */
|
|
32
|
+
export async function runArchitectureGate() {
|
|
33
|
+
const script = resolveScript(repoRoot, 'scripts/architecture.ts');
|
|
34
|
+
const result = spawnSync('node', [script, 'check'], { cwd: process.cwd(), encoding: 'utf8' });
|
|
35
|
+
const stdout = result.stdout ?? '';
|
|
36
|
+
if (result.error !== undefined || (result.status !== 0 && result.status !== 1)) {
|
|
37
|
+
return [{
|
|
38
|
+
id: ID,
|
|
39
|
+
title: TITLE,
|
|
40
|
+
severity: 'critical',
|
|
41
|
+
status: 'fail',
|
|
42
|
+
detail: `architecture:check não rodou: ${result.stderr || result.error?.message || `exit ${result.status}`}`,
|
|
43
|
+
fix: 'rode `forja architecture:check` diretamente para depurar; se nunca compilado, rode `forja architecture:compile` primeiro',
|
|
44
|
+
}];
|
|
45
|
+
}
|
|
46
|
+
if (stdout.includes('Nenhuma regra compilada')) {
|
|
47
|
+
return [{ id: ID, title: TITLE, severity: 'critical', status: 'warn', detail: 'nenhuma Constitution compilada ainda — rode `forja architecture:compile`', fix: '`forja architecture:compile`' }];
|
|
48
|
+
}
|
|
49
|
+
if (result.status === 1) {
|
|
50
|
+
return [{
|
|
51
|
+
id: ID,
|
|
52
|
+
title: TITLE,
|
|
53
|
+
severity: 'critical',
|
|
54
|
+
status: 'fail',
|
|
55
|
+
detail: `${violationCountFrom(stdout)} violação(ões) de arquitetura encontrada(s)`,
|
|
56
|
+
fix: '`forja architecture:check` para o relatório completo, com remediação sugerida por violação',
|
|
57
|
+
}];
|
|
58
|
+
}
|
|
59
|
+
return [{ id: ID, title: TITLE, severity: 'critical', status: 'ok', detail: 'código em conformidade com toda regra active da Constitution', fix: null }];
|
|
60
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/core/drift-gate.ts — ponte opt-in entre `drift:check` (SPEC-030) e `check:all` (AC-5).
|
|
3
|
+
*
|
|
4
|
+
* `drift:check` reindexa o workspace inteiro por extração determinística — o mesmo custo de rodar
|
|
5
|
+
* `graph:sync`/`code:index` uma vez a mais (ver NFR do spec). Rodar isso em **todo** `check:all`
|
|
6
|
+
* (e, por extensão, em todo commit/CI) seria caro demais para repos grandes sem medição prévia de
|
|
7
|
+
* custo — por isso AC-5 pede opt-in (`--with-drift`), nunca o comportamento padrão.
|
|
8
|
+
*
|
|
9
|
+
* Este módulo não reimplementa `drift:check`: chama o comando real via subprocess (mesmo padrão de
|
|
10
|
+
* `lib/core/release.ts`/`project-smoke.ts`, que também compõem gates via `execFileSync` em vez de
|
|
11
|
+
* importar os internals uns dos outros) e traduz a saída num `Result` do runner de gates
|
|
12
|
+
* (`lib/core/checks.ts`). `severity: 'warn'` é deliberado: drift é sinal para revisão humana/de
|
|
13
|
+
* agente, não uma falha que deve travar `check:all` (SPEC-030 §5 — o comando só sinaliza, nunca
|
|
14
|
+
* corrige ou bloqueia sozinho).
|
|
15
|
+
*/
|
|
16
|
+
import type { Result } from './checks.ts';
|
|
17
|
+
/** Roda `drift:check` num subprocesso e traduz o resultado num `Result` de gate. */
|
|
18
|
+
export declare function runDriftGate(): Promise<Result[]>;
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/core/drift-gate.ts — ponte opt-in entre `drift:check` (SPEC-030) e `check:all` (AC-5).
|
|
3
|
+
*
|
|
4
|
+
* `drift:check` reindexa o workspace inteiro por extração determinística — o mesmo custo de rodar
|
|
5
|
+
* `graph:sync`/`code:index` uma vez a mais (ver NFR do spec). Rodar isso em **todo** `check:all`
|
|
6
|
+
* (e, por extensão, em todo commit/CI) seria caro demais para repos grandes sem medição prévia de
|
|
7
|
+
* custo — por isso AC-5 pede opt-in (`--with-drift`), nunca o comportamento padrão.
|
|
8
|
+
*
|
|
9
|
+
* Este módulo não reimplementa `drift:check`: chama o comando real via subprocess (mesmo padrão de
|
|
10
|
+
* `lib/core/release.ts`/`project-smoke.ts`, que também compõem gates via `execFileSync` em vez de
|
|
11
|
+
* importar os internals uns dos outros) e traduz a saída num `Result` do runner de gates
|
|
12
|
+
* (`lib/core/checks.ts`). `severity: 'warn'` é deliberado: drift é sinal para revisão humana/de
|
|
13
|
+
* agente, não uma falha que deve travar `check:all` (SPEC-030 §5 — o comando só sinaliza, nunca
|
|
14
|
+
* corrige ou bloqueia sozinho).
|
|
15
|
+
*/
|
|
16
|
+
import { spawnSync } from 'node:child_process';
|
|
17
|
+
import path from 'node:path';
|
|
18
|
+
import { fileURLToPath } from 'node:url';
|
|
19
|
+
import { resolveScript } from "./registry.js";
|
|
20
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
21
|
+
const repoRoot = path.resolve(path.dirname(__filename), '..', '..');
|
|
22
|
+
const ID = 'drift-check';
|
|
23
|
+
const TITLE = 'drift:check — o verified continua verdade (SPEC-030, opt-in)';
|
|
24
|
+
function driftCountFrom(stdout) {
|
|
25
|
+
return /(\d+) com drift detectado/.exec(stdout)?.[1] ?? '?';
|
|
26
|
+
}
|
|
27
|
+
/** Roda `drift:check` num subprocesso e traduz o resultado num `Result` de gate. */
|
|
28
|
+
export async function runDriftGate() {
|
|
29
|
+
const script = resolveScript(repoRoot, 'scripts/drift-check.ts');
|
|
30
|
+
const result = spawnSync('node', [script], { cwd: process.cwd(), encoding: 'utf8' });
|
|
31
|
+
const stdout = result.stdout ?? '';
|
|
32
|
+
// exit 0 = sem drift, exit 1 = drift detectado (ambos "o comando rodou"); qualquer outro código —
|
|
33
|
+
// ou erro ao spawnar — é falha de infraestrutura do gate em si, não um veredito sobre o grafo.
|
|
34
|
+
if (result.error !== undefined || (result.status !== 0 && result.status !== 1)) {
|
|
35
|
+
return [{
|
|
36
|
+
id: ID,
|
|
37
|
+
title: TITLE,
|
|
38
|
+
severity: 'warn',
|
|
39
|
+
status: 'fail',
|
|
40
|
+
detail: `drift:check não rodou: ${result.stderr || result.error?.message || `exit ${result.status}`}`,
|
|
41
|
+
fix: 'rode `forja drift:check` diretamente para depurar',
|
|
42
|
+
}];
|
|
43
|
+
}
|
|
44
|
+
if (result.status === 1) {
|
|
45
|
+
return [{
|
|
46
|
+
id: ID,
|
|
47
|
+
title: TITLE,
|
|
48
|
+
severity: 'warn',
|
|
49
|
+
status: 'warn',
|
|
50
|
+
detail: `${driftCountFrom(stdout)} documento(s) com relação(ões) verified que a extração atual não reproduz mais`,
|
|
51
|
+
fix: '`forja drift:check` para o relatório completo — corrigir o código ou a ADR/spec desatualizada é decisão humana/de agente',
|
|
52
|
+
}];
|
|
53
|
+
}
|
|
54
|
+
return [{ id: ID, title: TITLE, severity: 'warn', status: 'ok', detail: 'nenhuma relação verified ficou stale desde a última indexação', fix: null }];
|
|
55
|
+
}
|
package/dist/lib/core/gates.d.ts
CHANGED
|
@@ -20,15 +20,22 @@ export interface GatesDeps {
|
|
|
20
20
|
full: boolean;
|
|
21
21
|
}) => Promise<any[]>;
|
|
22
22
|
release?: () => Promise<any[]>;
|
|
23
|
+
drift?: () => Promise<any[]>;
|
|
24
|
+
architecture?: () => Promise<any[]>;
|
|
23
25
|
}
|
|
24
26
|
/**
|
|
25
27
|
* Roda os gates aplicáveis ao framework e devolve os resultados agrupados por gate.
|
|
26
28
|
*
|
|
27
29
|
* Tier barato (default): coerência (doctor) + projeto gerado (smoke barato). `--full` adiciona os
|
|
28
|
-
* caros: o tarball (release) e o build do gerado (smoke --full).
|
|
30
|
+
* caros: o tarball (release) e o build do gerado (smoke --full). `--with-drift` (SPEC-030 AC-5) é
|
|
31
|
+
* um terceiro eixo, independente de `full`: reindexa o workspace inteiro por extração
|
|
32
|
+
* determinística — não é caro na mesma escala do tarball, mas também não é grátis o bastante para
|
|
33
|
+
* rodar em todo commit sem medição, daí opt-in em vez de padrão.
|
|
29
34
|
*/
|
|
30
|
-
export declare function runGates({ full, deps }?: {
|
|
35
|
+
export declare function runGates({ full, withDrift, withArchitecture, deps }?: {
|
|
31
36
|
full?: boolean;
|
|
37
|
+
withDrift?: boolean;
|
|
38
|
+
withArchitecture?: boolean;
|
|
32
39
|
deps?: GatesDeps;
|
|
33
40
|
}): Promise<GateGroup[]>;
|
|
34
41
|
/** O pior status entre todos os gates — o veredito único. */
|
package/dist/lib/core/gates.js
CHANGED
|
@@ -11,21 +11,32 @@
|
|
|
11
11
|
import { runChecks as runHealthChecks, worstStatus } from "./health.js";
|
|
12
12
|
import { runProjectSmoke } from "./project-smoke.js";
|
|
13
13
|
import { runReleaseChecks } from "./release.js";
|
|
14
|
+
import { runDriftGate } from "./drift-gate.js";
|
|
15
|
+
import { runArchitectureGate } from "./architecture-gate.js";
|
|
14
16
|
/**
|
|
15
17
|
* Roda os gates aplicáveis ao framework e devolve os resultados agrupados por gate.
|
|
16
18
|
*
|
|
17
19
|
* Tier barato (default): coerência (doctor) + projeto gerado (smoke barato). `--full` adiciona os
|
|
18
|
-
* caros: o tarball (release) e o build do gerado (smoke --full).
|
|
20
|
+
* caros: o tarball (release) e o build do gerado (smoke --full). `--with-drift` (SPEC-030 AC-5) é
|
|
21
|
+
* um terceiro eixo, independente de `full`: reindexa o workspace inteiro por extração
|
|
22
|
+
* determinística — não é caro na mesma escala do tarball, mas também não é grátis o bastante para
|
|
23
|
+
* rodar em todo commit sem medição, daí opt-in em vez de padrão.
|
|
19
24
|
*/
|
|
20
|
-
export async function runGates({ full = false, deps = {} } = {}) {
|
|
25
|
+
export async function runGates({ full = false, withDrift = false, withArchitecture = false, deps = {} } = {}) {
|
|
21
26
|
const health = deps.health ?? (() => runHealthChecks());
|
|
22
27
|
const smoke = deps.smoke ?? ((o) => runProjectSmoke(o));
|
|
23
28
|
const release = deps.release ?? (() => runReleaseChecks({}));
|
|
29
|
+
const drift = deps.drift ?? (() => runDriftGate());
|
|
30
|
+
const architecture = deps.architecture ?? (() => runArchitectureGate());
|
|
24
31
|
const groups = [];
|
|
25
32
|
groups.push({ name: 'núcleo & coerência', results: await health() });
|
|
26
33
|
groups.push({ name: 'projeto gerado', results: await smoke({ full }) });
|
|
27
34
|
if (full)
|
|
28
35
|
groups.push({ name: 'tarball (instalação limpa)', results: await release() });
|
|
36
|
+
if (withDrift)
|
|
37
|
+
groups.push({ name: 'drift sentinel (opt-in, SPEC-030)', results: await drift() });
|
|
38
|
+
if (withArchitecture)
|
|
39
|
+
groups.push({ name: 'architecture constitution (opt-in, SPEC-033)', results: await architecture() });
|
|
29
40
|
return groups;
|
|
30
41
|
}
|
|
31
42
|
/** O pior status entre todos os gates — o veredito único. */
|
package/dist/lib/core/health.js
CHANGED
|
@@ -171,6 +171,21 @@ const memoryDb = {
|
|
|
171
171
|
fix: 'aguarde o processo concorrente liberar o lock e rode de novo',
|
|
172
172
|
};
|
|
173
173
|
}
|
|
174
|
+
// "no such table: memory_nodes" (achado real, SPEC-032/033): `getWorkspaceDbPath()` é
|
|
175
|
+
// compartilhado por dois mecanismos de schema independentes — `sync:universal` cria
|
|
176
|
+
// `memory_nodes` por conta própria, enquanto `drift:check`/`adr:*`/`architecture:*`/
|
|
177
|
+
// `agent:*`/`incident:*` usam `SqliteMigrationRunner` (schema do Engineering Graph), que
|
|
178
|
+
// nunca cria essa tabela. Um workspace onde só os comandos de grafo já rodaram tem um banco
|
|
179
|
+
// são, só sem essa tabela específica ainda — SQLITE_ERROR genérico, não corrupção. Mesmo
|
|
180
|
+
// `code` (`SQLITE_ERROR`) cobre outros erros de SQL também, então o texto da mensagem é o
|
|
181
|
+
// único sinal confiável aqui — `PRAGMA integrity_check` confirmaria são se alguém checasse.
|
|
182
|
+
if (asErrno(err).message?.includes('no such table: memory_nodes')) {
|
|
183
|
+
return {
|
|
184
|
+
status: 'warn',
|
|
185
|
+
detail: `banco existe mas ainda não foi sincronizado (tabela memory_nodes ausente) — comum se só drift:check/adr:*/architecture:*/agent:*/incident:* já rodaram neste workspace`,
|
|
186
|
+
fix: 'npm run sync:universal',
|
|
187
|
+
};
|
|
188
|
+
}
|
|
174
189
|
// Só o que sobra — SQLITE_CORRUPT, SQLITE_NOTADB, o resto — é integridade. Aí sim reindexar.
|
|
175
190
|
return {
|
|
176
191
|
status: 'fail',
|
|
@@ -459,7 +474,8 @@ const docsCommands = {
|
|
|
459
474
|
if (!isFrameworkRepo(env)) {
|
|
460
475
|
return { status: 'ok', detail: 'fora do repo do framework — não se aplica', fix: null };
|
|
461
476
|
}
|
|
462
|
-
const
|
|
477
|
+
const pkg = JSON.parse(env.fs.readFileSync(path.join(env.root, 'package.json'), 'utf8'));
|
|
478
|
+
const known = new Set([...Object.keys(COMMANDS), ...CLI_INTERFACE_COMMANDS, ...projectCommands(env), ...Object.keys(pkg.scripts || {})]);
|
|
463
479
|
const ghosts = scanCommands(env).filter((c) => !known.has(c.command));
|
|
464
480
|
if (ghosts.length) {
|
|
465
481
|
const amostra = ghosts.slice(0, 5).map((g) => `${g.command} (${g.file}:${g.line})`).join(', ');
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/core/incident-search.ts — busca de incidentes por palavra-chave (SPEC-041, reaproveitada por
|
|
3
|
+
* SPEC-042).
|
|
4
|
+
*
|
|
5
|
+
* Extraído pra `lib/core` (mesmo padrão de `risk-collect.ts`) em vez de ficar em
|
|
6
|
+
* `scripts/incident.ts`: um script tem `main()` executado incondicionalmente ao ser importado — um
|
|
7
|
+
* `import` de `scripts/engineer.ts` pra `scripts/incident.ts` rodaria o `main()` de `incident.ts`
|
|
8
|
+
* como efeito colateral, processando o `argv` errado. Lógica compartilhada entre comandos sempre
|
|
9
|
+
* vive em `lib/core`/`packages/*`, nunca em outro `scripts/*.ts`.
|
|
10
|
+
*/
|
|
11
|
+
import type { GraphNode } from '../../packages/contracts/src/index.ts';
|
|
12
|
+
import type { SqliteGraphStore } from '../../packages/adapter-sqlite/src/index.ts';
|
|
13
|
+
export declare function incidentRecords(store: SqliteGraphStore): readonly GraphNode[];
|
|
14
|
+
export declare function titleOf(node: GraphNode): string;
|
|
15
|
+
export interface RankedIncident {
|
|
16
|
+
readonly record: GraphNode;
|
|
17
|
+
readonly relevance: number;
|
|
18
|
+
}
|
|
19
|
+
export declare function rankIncidentsByQuery(records: readonly GraphNode[], query: string): readonly RankedIncident[];
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/core/incident-search.ts — busca de incidentes por palavra-chave (SPEC-041, reaproveitada por
|
|
3
|
+
* SPEC-042).
|
|
4
|
+
*
|
|
5
|
+
* Extraído pra `lib/core` (mesmo padrão de `risk-collect.ts`) em vez de ficar em
|
|
6
|
+
* `scripts/incident.ts`: um script tem `main()` executado incondicionalmente ao ser importado — um
|
|
7
|
+
* `import` de `scripts/engineer.ts` pra `scripts/incident.ts` rodaria o `main()` de `incident.ts`
|
|
8
|
+
* como efeito colateral, processando o `argv` errado. Lógica compartilhada entre comandos sempre
|
|
9
|
+
* vive em `lib/core`/`packages/*`, nunca em outro `scripts/*.ts`.
|
|
10
|
+
*/
|
|
11
|
+
export function incidentRecords(store) {
|
|
12
|
+
return store.listNodes().filter((node) => node.type === 'Incident').sort((left, right) => right.createdAt.localeCompare(left.createdAt));
|
|
13
|
+
}
|
|
14
|
+
export function titleOf(node) {
|
|
15
|
+
return node.label.split('\n')[0];
|
|
16
|
+
}
|
|
17
|
+
const STOPWORDS = new Set(['o', 'a', 'os', 'as', 'de', 'do', 'da', 'em', 'um', 'uma', 'e', 'que', 'para', 'com', 'não']);
|
|
18
|
+
function terms(text) {
|
|
19
|
+
return text.toLowerCase().split(/[^a-z0-9áéíóúâêôãõç]+/).filter((term) => term.length > 1 && !STOPWORDS.has(term));
|
|
20
|
+
}
|
|
21
|
+
export function rankIncidentsByQuery(records, query) {
|
|
22
|
+
const queryTerms = terms(query);
|
|
23
|
+
return records
|
|
24
|
+
.map((record) => {
|
|
25
|
+
const recordTerms = new Set(terms(record.label));
|
|
26
|
+
const matches = queryTerms.filter((term) => recordTerms.has(term)).length;
|
|
27
|
+
return { record, matches, relevance: queryTerms.length === 0 ? 0 : matches / queryTerms.length };
|
|
28
|
+
})
|
|
29
|
+
.filter((item) => item.matches > 0)
|
|
30
|
+
.map(({ record, relevance }) => ({ record, relevance }))
|
|
31
|
+
.sort((left, right) => right.relevance - left.relevance || left.record.id.localeCompare(right.record.id));
|
|
32
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
export declare const DEFAULT_PRICING_PATH: string;
|
|
2
|
+
/** Dias após os quais um preço não revisado é considerado velho (risco do SPEC-029: "asOf > 90 dias"). */
|
|
3
|
+
export declare const STALE_PRICE_MAX_AGE_DAYS = 90;
|
|
4
|
+
export interface ModelPrice {
|
|
5
|
+
readonly inputPer1kUsd: number;
|
|
6
|
+
readonly outputPer1kUsd: number;
|
|
7
|
+
/** Data (YYYY-MM-DD) em que este preço foi conferido pela última vez. */
|
|
8
|
+
readonly asOf: string;
|
|
9
|
+
}
|
|
10
|
+
export interface PricingTable {
|
|
11
|
+
readonly version: number;
|
|
12
|
+
readonly currency: 'USD';
|
|
13
|
+
/** Chave: `${provider}:${model}` — o mesmo formato já usado em `Observation.model` (ver LlmProfile). */
|
|
14
|
+
readonly prices: Readonly<Record<string, ModelPrice>>;
|
|
15
|
+
}
|
|
16
|
+
export declare class ModelPricingError extends Error {
|
|
17
|
+
constructor(message: string);
|
|
18
|
+
}
|
|
19
|
+
/** Lê e valida a tabela local. Sem rede — só filesystem (NFR local-first do SPEC-029). */
|
|
20
|
+
export declare function loadPricingTable(filePath?: string): PricingTable;
|
|
21
|
+
export declare function validatePricingTable(value: unknown, source?: string): PricingTable;
|
|
22
|
+
/** `undefined` quando o provider/modelo não está na tabela — nunca lança (AC-4: preço desconhecido não bloqueia). */
|
|
23
|
+
export declare function lookupPrice(table: PricingTable, model: string | undefined): ModelPrice | undefined;
|
|
24
|
+
/**
|
|
25
|
+
* Custo real estimado em USD para `model`, a partir de tokens de entrada/saída já capturados
|
|
26
|
+
* (ex.: `Observation.inputTokens`/`outputTokens`). `undefined` quando o preço é desconhecido —
|
|
27
|
+
* o chamador decide entre seguir sem custo computado (fail-open, AC-4) ou logar um aviso.
|
|
28
|
+
*/
|
|
29
|
+
export declare function computeCostUsd(table: PricingTable, model: string | undefined, inputTokens: number, outputTokens: number): number | undefined;
|
|
30
|
+
/** True quando `price.asOf` está mais velho que `maxAgeDays` em relação a `now` (mitigação de risco do SPEC-029). */
|
|
31
|
+
export declare function isPriceStale(price: ModelPrice, now?: Date, maxAgeDays?: number): boolean;
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/core/model-pricing.ts — tabela de preço local, versionada (SPEC-029, AC-3).
|
|
3
|
+
*
|
|
4
|
+
* Local-first por design (NFR do spec): nenhuma chamada de rede. `lib/core/model-pricing.json` é
|
|
5
|
+
* mantido manualmente/por PR, não sincronizado com o billing real de nenhum provider — ver "Fora"
|
|
6
|
+
* do SPEC-029. Cada entrada carrega `asOf` porque preço de LLM muda com frequência (risco do spec);
|
|
7
|
+
* `pricingWarnings` abaixo é o que alimenta o aviso de "tabela desatualizada" em `forja llm:doctor`.
|
|
8
|
+
*
|
|
9
|
+
* Preço desconhecido nunca lança: `lookupPrice`/`computeCostUsd` devolvem `undefined` (AC-4). Quem
|
|
10
|
+
* chama decide o que fazer com isso — normalmente: seguir a execução e avisar, nunca bloquear.
|
|
11
|
+
*/
|
|
12
|
+
import fs from 'node:fs';
|
|
13
|
+
import path from 'node:path';
|
|
14
|
+
import { fileURLToPath } from 'node:url';
|
|
15
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
16
|
+
const __dirname = path.dirname(__filename);
|
|
17
|
+
export const DEFAULT_PRICING_PATH = path.join(__dirname, 'model-pricing.json');
|
|
18
|
+
/** Dias após os quais um preço não revisado é considerado velho (risco do SPEC-029: "asOf > 90 dias"). */
|
|
19
|
+
export const STALE_PRICE_MAX_AGE_DAYS = 90;
|
|
20
|
+
export class ModelPricingError extends Error {
|
|
21
|
+
constructor(message) { super(message); this.name = 'ModelPricingError'; }
|
|
22
|
+
}
|
|
23
|
+
/** Lê e valida a tabela local. Sem rede — só filesystem (NFR local-first do SPEC-029). */
|
|
24
|
+
export function loadPricingTable(filePath = DEFAULT_PRICING_PATH) {
|
|
25
|
+
let raw;
|
|
26
|
+
try {
|
|
27
|
+
raw = JSON.parse(fs.readFileSync(filePath, 'utf8'));
|
|
28
|
+
}
|
|
29
|
+
catch (error) {
|
|
30
|
+
throw new ModelPricingError(`Falha ao ler tabela de preço (${filePath}): ${error instanceof Error ? error.message : 'erro desconhecido'}`);
|
|
31
|
+
}
|
|
32
|
+
return validatePricingTable(raw, filePath);
|
|
33
|
+
}
|
|
34
|
+
export function validatePricingTable(value, source = '<inline>') {
|
|
35
|
+
if (!isRecord(value) || typeof value.version !== 'number' || value.currency !== 'USD' || !isRecord(value.prices)) {
|
|
36
|
+
throw new ModelPricingError(`Tabela de preço inválida (${source}): esperado { version, currency: 'USD', prices }`);
|
|
37
|
+
}
|
|
38
|
+
const prices = {};
|
|
39
|
+
for (const [model, entry] of Object.entries(value.prices))
|
|
40
|
+
prices[model] = validatePrice(model, entry, source);
|
|
41
|
+
return { version: value.version, currency: 'USD', prices };
|
|
42
|
+
}
|
|
43
|
+
function validatePrice(model, value, source) {
|
|
44
|
+
if (!isRecord(value) || typeof value.inputPer1kUsd !== 'number' || value.inputPer1kUsd < 0 || typeof value.outputPer1kUsd !== 'number' || value.outputPer1kUsd < 0 || typeof value.asOf !== 'string' || value.asOf.trim().length === 0) {
|
|
45
|
+
throw new ModelPricingError(`Preço inválido para "${model}" (${source}): esperado { inputPer1kUsd >= 0, outputPer1kUsd >= 0, asOf }`);
|
|
46
|
+
}
|
|
47
|
+
return { inputPer1kUsd: value.inputPer1kUsd, outputPer1kUsd: value.outputPer1kUsd, asOf: value.asOf };
|
|
48
|
+
}
|
|
49
|
+
/** `undefined` quando o provider/modelo não está na tabela — nunca lança (AC-4: preço desconhecido não bloqueia). */
|
|
50
|
+
export function lookupPrice(table, model) {
|
|
51
|
+
if (model === undefined)
|
|
52
|
+
return undefined;
|
|
53
|
+
return table.prices[model];
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Custo real estimado em USD para `model`, a partir de tokens de entrada/saída já capturados
|
|
57
|
+
* (ex.: `Observation.inputTokens`/`outputTokens`). `undefined` quando o preço é desconhecido —
|
|
58
|
+
* o chamador decide entre seguir sem custo computado (fail-open, AC-4) ou logar um aviso.
|
|
59
|
+
*/
|
|
60
|
+
export function computeCostUsd(table, model, inputTokens, outputTokens) {
|
|
61
|
+
const price = lookupPrice(table, model);
|
|
62
|
+
if (price === undefined)
|
|
63
|
+
return undefined;
|
|
64
|
+
return (inputTokens / 1000) * price.inputPer1kUsd + (outputTokens / 1000) * price.outputPer1kUsd;
|
|
65
|
+
}
|
|
66
|
+
/** True quando `price.asOf` está mais velho que `maxAgeDays` em relação a `now` (mitigação de risco do SPEC-029). */
|
|
67
|
+
export function isPriceStale(price, now = new Date(), maxAgeDays = STALE_PRICE_MAX_AGE_DAYS) {
|
|
68
|
+
const asOf = new Date(price.asOf);
|
|
69
|
+
if (Number.isNaN(asOf.getTime()))
|
|
70
|
+
return true;
|
|
71
|
+
const ageDays = (now.getTime() - asOf.getTime()) / (1000 * 60 * 60 * 24);
|
|
72
|
+
return ageDays > maxAgeDays;
|
|
73
|
+
}
|
|
74
|
+
function isRecord(value) { return typeof value === 'object' && value !== null; }
|