forjajs 2.0.4 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +133 -133
- package/CHANGELOG.md +619 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +64 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +15 -0
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.js +27 -4
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +32 -3
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -157
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/cost-aware-autonomy-budget/spec.md +102 -0
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/spec.md +23 -23
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,4 +1,16 @@
|
|
|
1
1
|
import { timingSafeEqual } from 'node:crypto';
|
|
2
|
+
/**
|
|
3
|
+
* True for 127.0.0.0/8 and ::1 (with the common ::ffff:-mapped IPv4 form normalized first).
|
|
4
|
+
* `address === undefined` returns false — "unknown" is not "trusted" — but callers that only have
|
|
5
|
+
* a real remote address for genuine network connections (never for direct in-process calls) may
|
|
6
|
+
* choose to treat a missing address as trusted at the call site; this helper stays strict.
|
|
7
|
+
*/
|
|
8
|
+
export function isLoopbackAddress(address) {
|
|
9
|
+
if (address === undefined)
|
|
10
|
+
return false;
|
|
11
|
+
const value = address.startsWith('::ffff:') ? address.slice(7) : address;
|
|
12
|
+
return value === '127.0.0.1' || value === '::1' || value.startsWith('127.');
|
|
13
|
+
}
|
|
2
14
|
export function createBearerAuthenticator(token) {
|
|
3
15
|
if (token.length === 0)
|
|
4
16
|
throw new NestAdapterError('Bearer token is required');
|
|
@@ -38,7 +50,7 @@ export class ForjaNestAdapter {
|
|
|
38
50
|
async handle(request) {
|
|
39
51
|
const correlationId = request.correlationId ?? request.headers['x-correlation-id'] ?? `http:${request.method}:${request.path}`;
|
|
40
52
|
try {
|
|
41
|
-
if (
|
|
53
|
+
if (!(await this.isAuthenticated(request)))
|
|
42
54
|
return { status: 401, headers: { 'content-type': 'application/json; charset=utf-8', 'x-correlation-id': correlationId, 'www-authenticate': 'Bearer' }, body: { error: { code: 'UNAUTHENTICATED', message: 'Local authentication required' } }, correlationId };
|
|
43
55
|
const result = await this.dispatch(request);
|
|
44
56
|
return this.result(correlationId, result);
|
|
@@ -47,6 +59,19 @@ export class ForjaNestAdapter {
|
|
|
47
59
|
return this.error(correlationId, error instanceof Error ? error.message : 'Unknown HTTP adapter error');
|
|
48
60
|
}
|
|
49
61
|
}
|
|
62
|
+
/**
|
|
63
|
+
* Fails closed when no authenticator is configured: previously this meant "allow everyone", which
|
|
64
|
+
* left any request that reached the process (e.g. a container-network or port-forward hop) fully
|
|
65
|
+
* unauthenticated. Now it means "loopback callers only". `remoteAddress` being unset (rather than
|
|
66
|
+
* a real non-loopback address) is treated as an internal/direct call — e.g. dispatched in-process,
|
|
67
|
+
* not received over an actual socket — and stays trusted; a genuine HTTP layer always supplies it
|
|
68
|
+
* (see ForjaLocalAuthGuard, which reads it straight off the raw socket).
|
|
69
|
+
*/
|
|
70
|
+
async isAuthenticated(request) {
|
|
71
|
+
if (this.authenticator === undefined)
|
|
72
|
+
return request.remoteAddress === undefined || isLoopbackAddress(request.remoteAddress);
|
|
73
|
+
return this.authenticator.authenticate(request.headers);
|
|
74
|
+
}
|
|
50
75
|
subscribeSse(listener) {
|
|
51
76
|
if (this.stream === undefined)
|
|
52
77
|
throw new NestAdapterError('Event stream is not configured');
|
|
@@ -1,5 +1,6 @@
|
|
|
1
|
-
import type { AuditRecord, Checkpoint, DomainEvent, EntityId, ExecutionResult, Handoff, Observation, RuntimeRun, SandboxSession, Sprint, Task, RunId } from '../../contracts/src/index.ts';
|
|
1
|
+
import type { AgentProfile2, AuditRecord, Checkpoint, DomainEvent, EntityId, ExecutionResult, Handoff, Observation, RuntimeRun, SandboxSession, Sprint, Task, RunId } from '../../contracts/src/index.ts';
|
|
2
2
|
import type { EventStore } from '../../events/src/index.ts';
|
|
3
|
+
import type { ProvenanceRecord } from '../../engineering/provenance/src/index.ts';
|
|
3
4
|
import type { ApprovalStore } from '../../policy/src/index.ts';
|
|
4
5
|
import type { CheckpointStore, RuntimePersistence, RuntimePlanStep } from '../../runtime/src/index.ts';
|
|
5
6
|
import type { McpAuditEvent, McpAuditSink } from '../../mcp/src/index.ts';
|
|
@@ -89,6 +90,16 @@ export declare class SqliteGraphStore implements GraphStore {
|
|
|
89
90
|
saveEvidence(item: Evidence): void;
|
|
90
91
|
getSourceChecksum(sourceKey: string): string | undefined;
|
|
91
92
|
saveSourceChecksum(sourceKey: string, checksum: string): void;
|
|
93
|
+
/**
|
|
94
|
+
* Achado real de performance (`GraphIndexer.sync` contra ~1000 documentos): sem isto, cada
|
|
95
|
+
* `saveNode`/`saveEdge`/`saveEvidence` era um `INSERT` num commit implícito próprio — dezenas de
|
|
96
|
+
* milhares de fsyncs. Um `BEGIN`/`COMMIT` por chamada externa (não por `INSERT`), com
|
|
97
|
+
* `ROLLBACK` em erro. Contador de profundidade evita `BEGIN` aninhado (SQLite não suporta —
|
|
98
|
+
* chamadas aninhadas de `transaction()`, se algum código futuro fizer isso, só participam da
|
|
99
|
+
* transação já aberta pelo nível mais externo).
|
|
100
|
+
*/
|
|
101
|
+
private transactionDepth;
|
|
102
|
+
transaction<T>(fn: () => T): T;
|
|
92
103
|
private payload;
|
|
93
104
|
private listPayload;
|
|
94
105
|
}
|
|
@@ -104,6 +115,21 @@ export declare class SqliteRuntimeRunStore {
|
|
|
104
115
|
save(value: RuntimeRun): void;
|
|
105
116
|
get(runId: RunId): RuntimeRun | undefined;
|
|
106
117
|
}
|
|
118
|
+
/** SPEC-036 — reaproveita `SqliteJsonRepository` (tabela genérica `forja_records`), sem migration própria (D3 do plan). */
|
|
119
|
+
export declare class SqliteAgentProfileStore {
|
|
120
|
+
private readonly repository;
|
|
121
|
+
constructor(db: SqliteConnection);
|
|
122
|
+
save(value: AgentProfile2): void;
|
|
123
|
+
get(id: EntityId): AgentProfile2 | undefined;
|
|
124
|
+
list(): readonly AgentProfile2[];
|
|
125
|
+
}
|
|
126
|
+
/** SPEC-039 — reaproveita `SqliteJsonRepository`, sem migration própria (mesmo padrão de `SqliteAgentProfileStore`). Chave `${runId}:${file}` — regravar o mesmo run é idempotente, não duplica. */
|
|
127
|
+
export declare class SqliteProvenanceStore {
|
|
128
|
+
private readonly repository;
|
|
129
|
+
constructor(db: SqliteConnection);
|
|
130
|
+
save(value: ProvenanceRecord): void;
|
|
131
|
+
list(): readonly ProvenanceRecord[];
|
|
132
|
+
}
|
|
107
133
|
export declare class SqliteRuntimePersistence implements RuntimePersistence {
|
|
108
134
|
private readonly db;
|
|
109
135
|
constructor(db: SqliteConnection);
|
|
@@ -3,16 +3,16 @@ export const MIGRATIONS = [
|
|
|
3
3
|
{
|
|
4
4
|
version: 1,
|
|
5
5
|
name: 'core-persistence',
|
|
6
|
-
sql: `CREATE TABLE IF NOT EXISTS forja_records (collection TEXT NOT NULL, id TEXT NOT NULL, payload TEXT NOT NULL, updated_at TEXT NOT NULL, PRIMARY KEY (collection, id));
|
|
7
|
-
CREATE TABLE IF NOT EXISTS forja_events (id TEXT PRIMARY KEY, aggregate_id TEXT NOT NULL, sequence INTEGER NOT NULL, type TEXT NOT NULL, payload TEXT NOT NULL, idempotency_key TEXT NOT NULL UNIQUE, created_at TEXT NOT NULL);
|
|
6
|
+
sql: `CREATE TABLE IF NOT EXISTS forja_records (collection TEXT NOT NULL, id TEXT NOT NULL, payload TEXT NOT NULL, updated_at TEXT NOT NULL, PRIMARY KEY (collection, id));
|
|
7
|
+
CREATE TABLE IF NOT EXISTS forja_events (id TEXT PRIMARY KEY, aggregate_id TEXT NOT NULL, sequence INTEGER NOT NULL, type TEXT NOT NULL, payload TEXT NOT NULL, idempotency_key TEXT NOT NULL UNIQUE, created_at TEXT NOT NULL);
|
|
8
8
|
CREATE TABLE IF NOT EXISTS forja_audit (id TEXT PRIMARY KEY, aggregate_id TEXT NOT NULL, action TEXT NOT NULL, outcome TEXT NOT NULL, payload TEXT NOT NULL, created_at TEXT NOT NULL);`,
|
|
9
9
|
},
|
|
10
10
|
{
|
|
11
11
|
version: 2,
|
|
12
12
|
name: 'runtime-persistence',
|
|
13
|
-
sql: `CREATE TABLE IF NOT EXISTS runtime_runs (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
14
|
-
CREATE TABLE IF NOT EXISTS runtime_plans (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
15
|
-
CREATE TABLE IF NOT EXISTS runtime_results (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
13
|
+
sql: `CREATE TABLE IF NOT EXISTS runtime_runs (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
14
|
+
CREATE TABLE IF NOT EXISTS runtime_plans (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
15
|
+
CREATE TABLE IF NOT EXISTS runtime_results (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
16
16
|
CREATE TABLE IF NOT EXISTS runtime_state (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);`,
|
|
17
17
|
},
|
|
18
18
|
{
|
|
@@ -23,13 +23,13 @@ CREATE TABLE IF NOT EXISTS runtime_state (run_id TEXT PRIMARY KEY, payload TEXT
|
|
|
23
23
|
{
|
|
24
24
|
version: 4,
|
|
25
25
|
name: 'graphloop-persistence',
|
|
26
|
-
sql: `CREATE TABLE IF NOT EXISTS graph_nodes (node_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
27
|
-
CREATE TABLE IF NOT EXISTS graph_edges (edge_key TEXT PRIMARY KEY, from_id TEXT NOT NULL, to_id TEXT NOT NULL, edge_type TEXT NOT NULL, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
28
|
-
CREATE TABLE IF NOT EXISTS graph_evidence (evidence_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
29
|
-
CREATE TABLE IF NOT EXISTS graph_sources (source_key TEXT PRIMARY KEY, checksum TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
30
|
-
CREATE TABLE IF NOT EXISTS graph_claims (claim_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
31
|
-
CREATE TABLE IF NOT EXISTS graph_contradictions (contradiction_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
32
|
-
CREATE TABLE IF NOT EXISTS graph_agenda (agenda_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
26
|
+
sql: `CREATE TABLE IF NOT EXISTS graph_nodes (node_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
27
|
+
CREATE TABLE IF NOT EXISTS graph_edges (edge_key TEXT PRIMARY KEY, from_id TEXT NOT NULL, to_id TEXT NOT NULL, edge_type TEXT NOT NULL, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
28
|
+
CREATE TABLE IF NOT EXISTS graph_evidence (evidence_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
29
|
+
CREATE TABLE IF NOT EXISTS graph_sources (source_key TEXT PRIMARY KEY, checksum TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
30
|
+
CREATE TABLE IF NOT EXISTS graph_claims (claim_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
31
|
+
CREATE TABLE IF NOT EXISTS graph_contradictions (contradiction_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
32
|
+
CREATE TABLE IF NOT EXISTS graph_agenda (agenda_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);
|
|
33
33
|
CREATE TABLE IF NOT EXISTS graph_extraction_runs (run_id TEXT PRIMARY KEY, payload TEXT NOT NULL, updated_at TEXT NOT NULL);`,
|
|
34
34
|
},
|
|
35
35
|
{
|
|
@@ -129,6 +129,40 @@ export class SqliteGraphStore {
|
|
|
129
129
|
return isRecord(row) && typeof row.checksum === 'string' ? row.checksum : undefined;
|
|
130
130
|
}
|
|
131
131
|
saveSourceChecksum(sourceKey, checksum) { this.db.prepare('INSERT INTO graph_sources (source_key, checksum, updated_at) VALUES (?, ?, ?) ON CONFLICT(source_key) DO UPDATE SET checksum = excluded.checksum, updated_at = excluded.updated_at').run(sourceKey, checksum, new Date().toISOString()); }
|
|
132
|
+
/**
|
|
133
|
+
* Achado real de performance (`GraphIndexer.sync` contra ~1000 documentos): sem isto, cada
|
|
134
|
+
* `saveNode`/`saveEdge`/`saveEvidence` era um `INSERT` num commit implícito próprio — dezenas de
|
|
135
|
+
* milhares de fsyncs. Um `BEGIN`/`COMMIT` por chamada externa (não por `INSERT`), com
|
|
136
|
+
* `ROLLBACK` em erro. Contador de profundidade evita `BEGIN` aninhado (SQLite não suporta —
|
|
137
|
+
* chamadas aninhadas de `transaction()`, se algum código futuro fizer isso, só participam da
|
|
138
|
+
* transação já aberta pelo nível mais externo).
|
|
139
|
+
*/
|
|
140
|
+
transactionDepth = 0;
|
|
141
|
+
transaction(fn) {
|
|
142
|
+
if (this.transactionDepth > 0) {
|
|
143
|
+
this.transactionDepth += 1;
|
|
144
|
+
try {
|
|
145
|
+
return fn();
|
|
146
|
+
}
|
|
147
|
+
finally {
|
|
148
|
+
this.transactionDepth -= 1;
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
this.transactionDepth = 1;
|
|
152
|
+
this.db.exec('BEGIN');
|
|
153
|
+
try {
|
|
154
|
+
const result = fn();
|
|
155
|
+
this.db.exec('COMMIT');
|
|
156
|
+
return result;
|
|
157
|
+
}
|
|
158
|
+
catch (error) {
|
|
159
|
+
this.db.exec('ROLLBACK');
|
|
160
|
+
throw error;
|
|
161
|
+
}
|
|
162
|
+
finally {
|
|
163
|
+
this.transactionDepth = 0;
|
|
164
|
+
}
|
|
165
|
+
}
|
|
132
166
|
payload(sql, id) {
|
|
133
167
|
const row = this.db.prepare(sql).get(id);
|
|
134
168
|
return isRecord(row) && typeof row.payload === 'string' ? JSON.parse(row.payload) : undefined;
|
|
@@ -154,6 +188,21 @@ export class SqliteRuntimeRunStore {
|
|
|
154
188
|
save(value) { this.repository.put('runtime_run', value.runId, value, value.updatedAt); }
|
|
155
189
|
get(runId) { return this.repository.get('runtime_run', runId); }
|
|
156
190
|
}
|
|
191
|
+
/** SPEC-036 — reaproveita `SqliteJsonRepository` (tabela genérica `forja_records`), sem migration própria (D3 do plan). */
|
|
192
|
+
export class SqliteAgentProfileStore {
|
|
193
|
+
repository;
|
|
194
|
+
constructor(db) { this.repository = new SqliteJsonRepository(db); }
|
|
195
|
+
save(value) { this.repository.put('agent_profile', value.id, value, value.updatedAt); }
|
|
196
|
+
get(id) { return this.repository.get('agent_profile', id); }
|
|
197
|
+
list() { return this.repository.list('agent_profile'); }
|
|
198
|
+
}
|
|
199
|
+
/** SPEC-039 — reaproveita `SqliteJsonRepository`, sem migration própria (mesmo padrão de `SqliteAgentProfileStore`). Chave `${runId}:${file}` — regravar o mesmo run é idempotente, não duplica. */
|
|
200
|
+
export class SqliteProvenanceStore {
|
|
201
|
+
repository;
|
|
202
|
+
constructor(db) { this.repository = new SqliteJsonRepository(db); }
|
|
203
|
+
save(value) { this.repository.put('provenance_record', `${value.runId}:${value.file}`, value, value.recordedAt); }
|
|
204
|
+
list() { return this.repository.list('provenance_record'); }
|
|
205
|
+
}
|
|
157
206
|
export class SqliteRuntimePersistence {
|
|
158
207
|
db;
|
|
159
208
|
constructor(db) { this.db = db; }
|
|
@@ -88,6 +88,28 @@ export interface AgentProfile extends AgentIdentity {
|
|
|
88
88
|
readonly capabilities: readonly CapabilityId[];
|
|
89
89
|
readonly permissions: readonly string[];
|
|
90
90
|
}
|
|
91
|
+
/**
|
|
92
|
+
* Registro persistente de agente (SPEC-036) — `AgentIdentity` continua sendo o tipo efêmero por
|
|
93
|
+
* run (`PolicyRequest`/`RuntimeRun`); este é o registro entre runs, com reputação derivada de
|
|
94
|
+
* comportamento real. `trustLevel`/`autonomyLevel`/`lastScoredAt` só são escritos por
|
|
95
|
+
* `computeReputationScore` (via `agent:score`) — nunca aceitos em `agent:register`.
|
|
96
|
+
*/
|
|
97
|
+
export interface AgentProfile2 extends AuditFields {
|
|
98
|
+
readonly id: EntityId;
|
|
99
|
+
readonly role: string;
|
|
100
|
+
readonly provider?: string;
|
|
101
|
+
readonly model?: string;
|
|
102
|
+
readonly capabilities: readonly string[];
|
|
103
|
+
readonly architectureDomains: readonly string[];
|
|
104
|
+
readonly limits?: {
|
|
105
|
+
readonly maxFiles?: number;
|
|
106
|
+
readonly maxCostUsd?: number;
|
|
107
|
+
readonly maxDurationMs?: number;
|
|
108
|
+
};
|
|
109
|
+
readonly trustLevel?: number;
|
|
110
|
+
readonly autonomyLevel?: 'autonomous' | 'autonomous_with_review' | 'supervised' | 'human_in_the_loop';
|
|
111
|
+
readonly lastScoredAt?: ISO8601;
|
|
112
|
+
}
|
|
91
113
|
export interface PolicyDecision {
|
|
92
114
|
readonly effect: PolicyEffect;
|
|
93
115
|
readonly reason: string;
|
|
@@ -188,6 +210,9 @@ export interface DomainEvent extends AuditFields {
|
|
|
188
210
|
readonly payload: unknown;
|
|
189
211
|
readonly idempotencyKey: string;
|
|
190
212
|
}
|
|
213
|
+
/** `documentStatus` is the source document's own lifecycle (e.g. an ADR's accepted/superseded, a
|
|
214
|
+
* spec's draft/approved) — deliberately not `status: KnowledgeStatus`, which grades the epistemic
|
|
215
|
+
* confidence of a *relation*, not a document's lifecycle. Keep the two vocabularies separate. */
|
|
191
216
|
export interface GraphNode extends AuditFields {
|
|
192
217
|
readonly id: EntityId;
|
|
193
218
|
readonly type: string;
|
|
@@ -195,6 +220,7 @@ export interface GraphNode extends AuditFields {
|
|
|
195
220
|
readonly status: KnowledgeStatus;
|
|
196
221
|
readonly validFrom?: ISO8601;
|
|
197
222
|
readonly validTo?: ISO8601;
|
|
223
|
+
readonly documentStatus?: string;
|
|
198
224
|
}
|
|
199
225
|
export interface GraphEdge extends AuditFields {
|
|
200
226
|
readonly id: EntityId;
|
|
@@ -365,4 +391,11 @@ export declare class ContractValidationError extends Error {
|
|
|
365
391
|
}
|
|
366
392
|
export declare function assertContract(condition: boolean, path: string, message: string): asserts condition;
|
|
367
393
|
export declare function validateTokenBudget(value: TokenBudget): TokenBudget;
|
|
394
|
+
/**
|
|
395
|
+
* True only when `candidate` resolves inside `root` (or equals it). Uses `path.relative` +
|
|
396
|
+
* separator-boundary check rather than `String.startsWith(root)`, which a sibling path
|
|
397
|
+
* (`/root-evil`) or an unresolved `..` segment can satisfy without ever being inside `root`.
|
|
398
|
+
* Both arguments should already be absolute; relative inputs are resolved against `process.cwd()`.
|
|
399
|
+
*/
|
|
400
|
+
export declare function isPathWithinRoot(root: string, candidate: string): boolean;
|
|
368
401
|
export declare function validateCapabilityDefinition(value: CapabilityDefinition): CapabilityDefinition;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
/** Versioned, framework-independent contracts for ForjaJS 2.0. */
|
|
2
|
+
import path from 'node:path';
|
|
2
3
|
export const CONTRACT_VERSION = '2.0';
|
|
3
4
|
export class ContractValidationError extends Error {
|
|
4
5
|
path;
|
|
@@ -15,6 +16,18 @@ export function validateTokenBudget(value) {
|
|
|
15
16
|
assertContract(Number.isInteger(value.usedTokens) && value.usedTokens >= 0 && value.usedTokens <= value.totalTokens, 'budget.usedTokens', 'must be within totalTokens');
|
|
16
17
|
return value;
|
|
17
18
|
}
|
|
19
|
+
/**
|
|
20
|
+
* True only when `candidate` resolves inside `root` (or equals it). Uses `path.relative` +
|
|
21
|
+
* separator-boundary check rather than `String.startsWith(root)`, which a sibling path
|
|
22
|
+
* (`/root-evil`) or an unresolved `..` segment can satisfy without ever being inside `root`.
|
|
23
|
+
* Both arguments should already be absolute; relative inputs are resolved against `process.cwd()`.
|
|
24
|
+
*/
|
|
25
|
+
export function isPathWithinRoot(root, candidate) {
|
|
26
|
+
const resolvedRoot = path.resolve(root);
|
|
27
|
+
const resolvedCandidate = path.resolve(candidate);
|
|
28
|
+
const relative = path.relative(resolvedRoot, resolvedCandidate);
|
|
29
|
+
return relative.length === 0 || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
|
|
30
|
+
}
|
|
18
31
|
export function validateCapabilityDefinition(value) {
|
|
19
32
|
assertContract(value.schemaVersion === CONTRACT_VERSION, 'schemaVersion', `must be ${CONTRACT_VERSION}`);
|
|
20
33
|
assertContract(/^[-a-z0-9]+(?:\.[-a-z0-9]+)+$/.test(value.id), 'id', 'must be a namespaced capability id');
|
|
@@ -14,6 +14,7 @@ export interface CapabilityAuthorizationRequest {
|
|
|
14
14
|
readonly definition: CapabilityDefinition;
|
|
15
15
|
readonly input: CapabilityInput;
|
|
16
16
|
readonly agent: AgentIdentity;
|
|
17
|
+
readonly correlationId?: string;
|
|
17
18
|
readonly projectId?: string;
|
|
18
19
|
readonly environment: string;
|
|
19
20
|
readonly categories: readonly string[];
|
|
@@ -47,6 +48,16 @@ export interface CapabilityExecutionRequest {
|
|
|
47
48
|
readonly files?: readonly string[];
|
|
48
49
|
readonly budget?: TokenBudget;
|
|
49
50
|
readonly approval?: CapabilityAuthorizationRequest['approval'];
|
|
51
|
+
/**
|
|
52
|
+
* Real dollar cost projected for this call (SPEC-029), computed by the CALLER from tokens +
|
|
53
|
+
* a local price table before `execute` runs. `packages/core` deliberately stays decoupled from
|
|
54
|
+
* pricing-table specifics (see docs/architecture/FORJA-2.0-ARCHITECTURE.md, "Direção de
|
|
55
|
+
* dependência") — it only compares this plain number against `PolicyLimits.maxCostUsd`, the same
|
|
56
|
+
* way `budget.totalTokens` is compared against `maxTokens`. Leave undefined when the caller has no
|
|
57
|
+
* price for the model/provider in play (unknown pricing must fail OPEN for cost enforcement
|
|
58
|
+
* specifically — see `checkLimits` — never DENY a legitimate execution over a pricing-table gap).
|
|
59
|
+
*/
|
|
60
|
+
readonly estimatedCostUsd?: number;
|
|
50
61
|
}
|
|
51
62
|
export declare class CapabilityRegistryError extends Error {
|
|
52
63
|
constructor(message: string);
|
|
@@ -58,6 +69,7 @@ export declare class CapabilityRegistry {
|
|
|
58
69
|
list(filter?: CapabilityListFilter): readonly CapabilityDefinition[];
|
|
59
70
|
describe(idOrAlias: string, filter?: CapabilityListFilter): CapabilityDefinition;
|
|
60
71
|
execute(request: CapabilityExecutionRequest): Promise<ExecutionResult>;
|
|
72
|
+
private checkLimits;
|
|
61
73
|
private resolve;
|
|
62
74
|
private tryResolve;
|
|
63
75
|
private isVisible;
|
|
@@ -66,6 +66,7 @@ export class CapabilityRegistry {
|
|
|
66
66
|
definition: registration.definition,
|
|
67
67
|
input: request.input,
|
|
68
68
|
agent: request.agent,
|
|
69
|
+
correlationId: request.correlationId ?? runId,
|
|
69
70
|
projectId: request.projectId,
|
|
70
71
|
environment: request.environment ?? 'local',
|
|
71
72
|
categories: request.categories ?? [],
|
|
@@ -91,6 +92,14 @@ export class CapabilityRegistry {
|
|
|
91
92
|
evidence: [],
|
|
92
93
|
};
|
|
93
94
|
}
|
|
95
|
+
// `ALLOW_WITH_LIMITS` is only meaningful if the limits it carries actually bound the call —
|
|
96
|
+
// otherwise it behaves exactly like ALLOW, silently. maxFiles, maxTokens and maxCostUsd are
|
|
97
|
+
// checked here because all three are already known before the handler runs; maxDurationMs/
|
|
98
|
+
// maxRetries govern the runtime engine's own retry/step loop (RuntimeEngine.limits) rather than
|
|
99
|
+
// a single call.
|
|
100
|
+
const limitError = this.checkLimits(decision, request);
|
|
101
|
+
if (limitError !== undefined)
|
|
102
|
+
return this.failure(runId, timestamps, limitError);
|
|
94
103
|
try {
|
|
95
104
|
const output = await registration.handler(input, { runId, agent: request.agent, definition: registration.definition });
|
|
96
105
|
registration.validateOutput(output.payload);
|
|
@@ -102,6 +111,26 @@ export class CapabilityRegistry {
|
|
|
102
111
|
return this.failure(runId, timestamps, this.toExecutionError('HANDLER_FAILED', error, true));
|
|
103
112
|
}
|
|
104
113
|
}
|
|
114
|
+
checkLimits(decision, request) {
|
|
115
|
+
const limits = decision.limits;
|
|
116
|
+
if (limits === undefined)
|
|
117
|
+
return undefined;
|
|
118
|
+
const fileCount = request.files?.length ?? 0;
|
|
119
|
+
if (limits.maxFiles !== undefined && fileCount > limits.maxFiles) {
|
|
120
|
+
return { code: 'POLICY_LIMIT_EXCEEDED', message: `Policy limit exceeded: ${fileCount} files touched, maxFiles is ${limits.maxFiles}`, retryable: false };
|
|
121
|
+
}
|
|
122
|
+
const requestedTokens = request.budget?.totalTokens ?? 0;
|
|
123
|
+
if (limits.maxTokens !== undefined && requestedTokens > limits.maxTokens) {
|
|
124
|
+
return { code: 'POLICY_LIMIT_EXCEEDED', message: `Policy limit exceeded: budget of ${requestedTokens} tokens exceeds maxTokens ${limits.maxTokens}`, retryable: false };
|
|
125
|
+
}
|
|
126
|
+
// Fail-open by design (SPEC-029, AC-4): when the caller has no estimated cost (unknown
|
|
127
|
+
// provider/model pricing, or a capability that isn't priced at all), maxCostUsd simply isn't
|
|
128
|
+
// enforced for this call — a pricing-table gap must never block otherwise-legitimate work.
|
|
129
|
+
if (limits.maxCostUsd !== undefined && request.estimatedCostUsd !== undefined && request.estimatedCostUsd > limits.maxCostUsd) {
|
|
130
|
+
return { code: 'POLICY_LIMIT_EXCEEDED', message: `Policy limit exceeded: estimated cost $${request.estimatedCostUsd.toFixed(4)} exceeds maxCostUsd $${limits.maxCostUsd}`, retryable: false };
|
|
131
|
+
}
|
|
132
|
+
return undefined;
|
|
133
|
+
}
|
|
105
134
|
resolve(idOrAlias) {
|
|
106
135
|
const id = this.aliases.get(idOrAlias);
|
|
107
136
|
if (id === undefined)
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Architecture Constitution (SPEC-033) — turns an ADR's `## Constraints` section into rules that
|
|
3
|
+
* can be checked against real code, instead of a decision that only a human remembers to reread.
|
|
4
|
+
*
|
|
5
|
+
* Pure domain: no `fs`, no network, no dependency on `GraphLoop`/SQLite. `scripts/architecture.ts`
|
|
6
|
+
* is the adapter that reads ADR files and resolves `DependencyEdge[]` from the real Engineering
|
|
7
|
+
* Graph — this module only parses strings and compares lists, so it's fully unit-testable and
|
|
8
|
+
* reusable from a future MCP tool or the dashboard without dragging in I/O.
|
|
9
|
+
*
|
|
10
|
+
* LLM never decides a rule is `active` (ADR-0078, security principles). The recognized-phrase
|
|
11
|
+
* vocabulary here is small and fixed on purpose: anything outside it produces a `proposed` rule
|
|
12
|
+
* with `confidence < 1`, never `active` — a wrong guess here is a false positive that erodes trust
|
|
13
|
+
* in every future run of `architecture:check`, so silence (staying `proposed`) is the safe default,
|
|
14
|
+
* not a failure.
|
|
15
|
+
*/
|
|
16
|
+
export type ArchitectureConstraintKind = 'forbid_import' | 'require_dependency' | 'forbid_dependency';
|
|
17
|
+
export interface ArchitectureConstraint {
|
|
18
|
+
readonly kind: ArchitectureConstraintKind;
|
|
19
|
+
readonly target: string;
|
|
20
|
+
}
|
|
21
|
+
export type ArchitectureRuleStatus = 'active' | 'proposed';
|
|
22
|
+
export type ArchitectureSeverity = 'info' | 'low' | 'medium' | 'high' | 'critical';
|
|
23
|
+
export interface ArchitectureRule {
|
|
24
|
+
readonly id: string;
|
|
25
|
+
readonly source: string;
|
|
26
|
+
readonly status: ArchitectureRuleStatus;
|
|
27
|
+
readonly scope: {
|
|
28
|
+
readonly paths: readonly string[];
|
|
29
|
+
};
|
|
30
|
+
readonly constraint: ArchitectureConstraint;
|
|
31
|
+
readonly severity: ArchitectureSeverity;
|
|
32
|
+
readonly rationale: string;
|
|
33
|
+
readonly confidence: number;
|
|
34
|
+
}
|
|
35
|
+
/** A real (or hypothesized) import/dependency edge the graph already extracted — file path to a
|
|
36
|
+
* target label (an import specifier, a relative path, or an npm package name). */
|
|
37
|
+
export interface DependencyEdge {
|
|
38
|
+
readonly fromPath: string;
|
|
39
|
+
readonly targetLabel: string;
|
|
40
|
+
}
|
|
41
|
+
export interface ArchitectureViolation {
|
|
42
|
+
readonly ruleId: string;
|
|
43
|
+
readonly severity: ArchitectureSeverity;
|
|
44
|
+
readonly file: string;
|
|
45
|
+
readonly target: string;
|
|
46
|
+
readonly source: string;
|
|
47
|
+
readonly remediation: string;
|
|
48
|
+
}
|
|
49
|
+
export interface ArchitectureCheckReport {
|
|
50
|
+
readonly compliant: number;
|
|
51
|
+
readonly violations: readonly ArchitectureViolation[];
|
|
52
|
+
}
|
|
53
|
+
export interface ParsedConstraintLine {
|
|
54
|
+
readonly constraint: ArchitectureConstraint;
|
|
55
|
+
readonly scopeRaw: string;
|
|
56
|
+
readonly confidence: number;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Parses one bullet from an ADR's `## Constraints` section. Returns `undefined` only when the
|
|
60
|
+
* line isn't a bullet at all; an unrecognized bullet still returns a result, just with
|
|
61
|
+
* `confidence` low enough that `compileConstitution` keeps it `proposed`.
|
|
62
|
+
*/
|
|
63
|
+
export declare function parseConstraintLine(rawLine: string): ParsedConstraintLine | undefined;
|
|
64
|
+
export interface AdrDocument {
|
|
65
|
+
readonly source: string;
|
|
66
|
+
readonly content: string;
|
|
67
|
+
}
|
|
68
|
+
/** Extracts every `## Constraints` section's bullets from a set of ADR documents and compiles
|
|
69
|
+
* them into rules. Deterministic — no LLM, no I/O (the caller reads the files). */
|
|
70
|
+
export declare function compileConstitution(adrs: readonly AdrDocument[]): readonly ArchitectureRule[];
|
|
71
|
+
/**
|
|
72
|
+
* Checks only `active` rules (a `proposed` rule isn't enforced — that's the whole point of the
|
|
73
|
+
* status) against the real dependency edges the caller resolved from the graph.
|
|
74
|
+
*/
|
|
75
|
+
export declare function checkConstitution(rules: readonly ArchitectureRule[], edges: readonly DependencyEdge[]): ArchitectureCheckReport;
|
|
76
|
+
export declare function explainRule(rules: readonly ArchitectureRule[], ruleId: string): ArchitectureRule | undefined;
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Architecture Constitution (SPEC-033) — turns an ADR's `## Constraints` section into rules that
|
|
3
|
+
* can be checked against real code, instead of a decision that only a human remembers to reread.
|
|
4
|
+
*
|
|
5
|
+
* Pure domain: no `fs`, no network, no dependency on `GraphLoop`/SQLite. `scripts/architecture.ts`
|
|
6
|
+
* is the adapter that reads ADR files and resolves `DependencyEdge[]` from the real Engineering
|
|
7
|
+
* Graph — this module only parses strings and compares lists, so it's fully unit-testable and
|
|
8
|
+
* reusable from a future MCP tool or the dashboard without dragging in I/O.
|
|
9
|
+
*
|
|
10
|
+
* LLM never decides a rule is `active` (ADR-0078, security principles). The recognized-phrase
|
|
11
|
+
* vocabulary here is small and fixed on purpose: anything outside it produces a `proposed` rule
|
|
12
|
+
* with `confidence < 1`, never `active` — a wrong guess here is a false positive that erodes trust
|
|
13
|
+
* in every future run of `architecture:check`, so silence (staying `proposed`) is the safe default,
|
|
14
|
+
* not a failure.
|
|
15
|
+
*/
|
|
16
|
+
/** A recognized scope/target must look like a path or package specifier, not an arbitrary noun
|
|
17
|
+
* phrase — this is most of what keeps false positives out (D2, plan.md). */
|
|
18
|
+
function looksLikePathOrPackage(value) {
|
|
19
|
+
return /[\w-]+(\/[\w.-]+)+|^@?[a-z0-9][\w.-]*$/i.test(value) && value.length > 0;
|
|
20
|
+
}
|
|
21
|
+
const PATTERNS = [
|
|
22
|
+
{ kind: 'forbid_import', regex: /^([\w./-]+?)\s+n[ãa]o\s+(?:pode\s+)?depend(?:e|er)\s+de\s+([\w./-]+?)\s*\.?$/i },
|
|
23
|
+
{ kind: 'forbid_import', regex: /^([\w./-]+?)\s+n[ãa]o\s+import(?:a|am)\s+([\w./-]+?)\s*(?:diretamente)?\s*\.?$/i },
|
|
24
|
+
{ kind: 'forbid_dependency', regex: /^([\w./-]+?)\s+n[ãa]o\s+acess(?:a|am)\s+([\w./-]+?)\s*(?:diretamente)?\s*\.?$/i },
|
|
25
|
+
{ kind: 'require_dependency', regex: /^([\w./-]+?)\s+usa(?:m)?\s+([\w./-]+?)\s*\.?$/i },
|
|
26
|
+
];
|
|
27
|
+
/**
|
|
28
|
+
* Parses one bullet from an ADR's `## Constraints` section. Returns `undefined` only when the
|
|
29
|
+
* line isn't a bullet at all; an unrecognized bullet still returns a result, just with
|
|
30
|
+
* `confidence` low enough that `compileConstitution` keeps it `proposed`.
|
|
31
|
+
*/
|
|
32
|
+
export function parseConstraintLine(rawLine) {
|
|
33
|
+
const line = rawLine.trim().replace(/^-\s*/, '');
|
|
34
|
+
if (line.length === 0)
|
|
35
|
+
return undefined;
|
|
36
|
+
for (const { kind, regex } of PATTERNS) {
|
|
37
|
+
const match = regex.exec(line);
|
|
38
|
+
if (match?.[1] === undefined || match[2] === undefined)
|
|
39
|
+
continue;
|
|
40
|
+
const scopeRaw = match[1].trim();
|
|
41
|
+
const target = match[2].trim();
|
|
42
|
+
const confidence = looksLikePathOrPackage(scopeRaw) && looksLikePathOrPackage(target) ? 1 : 0.3;
|
|
43
|
+
return { constraint: { kind, target }, scopeRaw, confidence };
|
|
44
|
+
}
|
|
45
|
+
// No fixed pattern matched at all — still worth surfacing as a low-confidence proposal (an
|
|
46
|
+
// operator can see it in `architecture:status` and either rephrase it or approve it manually),
|
|
47
|
+
// rather than silently dropping the ADR author's intent.
|
|
48
|
+
return { constraint: { kind: 'forbid_dependency', target: line }, scopeRaw: '(não reconhecido)', confidence: 0.1 };
|
|
49
|
+
}
|
|
50
|
+
function toPathPattern(scopeRaw) {
|
|
51
|
+
return scopeRaw.endsWith('/') || scopeRaw.endsWith('*') ? scopeRaw : `${scopeRaw}/**`;
|
|
52
|
+
}
|
|
53
|
+
function severityFor(confidence) {
|
|
54
|
+
return confidence >= 1 ? 'high' : confidence >= 0.5 ? 'medium' : 'info';
|
|
55
|
+
}
|
|
56
|
+
function slug(source, index, constraint) {
|
|
57
|
+
const base = source.replace(/^.*\//, '').replace(/\.md$/, '');
|
|
58
|
+
return `${base}-${constraint.kind}-${index}`;
|
|
59
|
+
}
|
|
60
|
+
/** Extracts every `## Constraints` section's bullets from a set of ADR documents and compiles
|
|
61
|
+
* them into rules. Deterministic — no LLM, no I/O (the caller reads the files). */
|
|
62
|
+
export function compileConstitution(adrs) {
|
|
63
|
+
const rules = [];
|
|
64
|
+
for (const adr of adrs) {
|
|
65
|
+
const section = /## Constraints\n([\s\S]*?)(?:\n## |\n?$)/.exec(adr.content)?.[1];
|
|
66
|
+
if (section === undefined)
|
|
67
|
+
continue;
|
|
68
|
+
const bullets = section.split('\n').map((line) => line.trim()).filter((line) => line.startsWith('- '));
|
|
69
|
+
bullets.forEach((bullet, index) => {
|
|
70
|
+
const parsed = parseConstraintLine(bullet);
|
|
71
|
+
if (parsed === undefined)
|
|
72
|
+
return;
|
|
73
|
+
rules.push({
|
|
74
|
+
id: slug(adr.source, index, parsed.constraint),
|
|
75
|
+
source: adr.source,
|
|
76
|
+
status: parsed.confidence >= 1 ? 'active' : 'proposed',
|
|
77
|
+
scope: { paths: [toPathPattern(parsed.scopeRaw)] },
|
|
78
|
+
constraint: parsed.constraint,
|
|
79
|
+
severity: severityFor(parsed.confidence),
|
|
80
|
+
rationale: bullet.replace(/^-\s*/, ''),
|
|
81
|
+
confidence: parsed.confidence,
|
|
82
|
+
});
|
|
83
|
+
});
|
|
84
|
+
}
|
|
85
|
+
return rules;
|
|
86
|
+
}
|
|
87
|
+
function matchesScope(file, paths) {
|
|
88
|
+
return paths.some((pattern) => {
|
|
89
|
+
const prefix = pattern.replace(/\*+$/, '');
|
|
90
|
+
return file === prefix.replace(/\/$/, '') || file.startsWith(prefix);
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
function matchesTarget(targetLabel, ruleTarget) {
|
|
94
|
+
return targetLabel === ruleTarget || targetLabel.includes(ruleTarget);
|
|
95
|
+
}
|
|
96
|
+
const REMEDIATION = {
|
|
97
|
+
forbid_import: (rule) => `Remova a dependência de "${rule.constraint.target}" em ${rule.scope.paths[0]} — introduza um adapter/porta em vez de importar diretamente (ver ${rule.source}).`,
|
|
98
|
+
forbid_dependency: (rule) => `Remova o acesso a "${rule.constraint.target}" em ${rule.scope.paths[0]} — a ADR de origem (${rule.source}) exige uma camada intermediária.`,
|
|
99
|
+
require_dependency: (rule) => `${rule.scope.paths[0]} deveria depender de "${rule.constraint.target}" segundo ${rule.source}, mas nenhuma aresta correspondente foi encontrada.`,
|
|
100
|
+
};
|
|
101
|
+
/**
|
|
102
|
+
* Checks only `active` rules (a `proposed` rule isn't enforced — that's the whole point of the
|
|
103
|
+
* status) against the real dependency edges the caller resolved from the graph.
|
|
104
|
+
*/
|
|
105
|
+
export function checkConstitution(rules, edges) {
|
|
106
|
+
const violations = [];
|
|
107
|
+
let compliant = 0;
|
|
108
|
+
for (const rule of rules) {
|
|
109
|
+
if (rule.status !== 'active')
|
|
110
|
+
continue;
|
|
111
|
+
if (rule.constraint.kind === 'require_dependency') {
|
|
112
|
+
const satisfied = edges.some((edge) => matchesScope(edge.fromPath, rule.scope.paths) && matchesTarget(edge.targetLabel, rule.constraint.target));
|
|
113
|
+
if (satisfied)
|
|
114
|
+
compliant += 1;
|
|
115
|
+
else
|
|
116
|
+
violations.push({ ruleId: rule.id, severity: rule.severity, file: rule.scope.paths[0] ?? '', target: rule.constraint.target, source: rule.source, remediation: REMEDIATION.require_dependency(rule) });
|
|
117
|
+
continue;
|
|
118
|
+
}
|
|
119
|
+
const offending = edges.filter((edge) => matchesScope(edge.fromPath, rule.scope.paths) && matchesTarget(edge.targetLabel, rule.constraint.target));
|
|
120
|
+
if (offending.length === 0) {
|
|
121
|
+
compliant += 1;
|
|
122
|
+
continue;
|
|
123
|
+
}
|
|
124
|
+
for (const edge of offending)
|
|
125
|
+
violations.push({ ruleId: rule.id, severity: rule.severity, file: edge.fromPath, target: rule.constraint.target, source: rule.source, remediation: REMEDIATION[rule.constraint.kind](rule) });
|
|
126
|
+
}
|
|
127
|
+
return { compliant, violations };
|
|
128
|
+
}
|
|
129
|
+
export function explainRule(rules, ruleId) {
|
|
130
|
+
return rules.find((rule) => rule.id === ruleId);
|
|
131
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forja/engineering-evidence — Engineering Evidence Ledger (SPEC-035).
|
|
3
|
+
*
|
|
4
|
+
* Não é uma fonte de dado nova: `buildEvidenceLedger` é um mapeamento puro sobre um `RuntimeRun`
|
|
5
|
+
* + `AuditRecord`/`ApprovalRequest` já persistidos (packages/contracts, packages/adapter-sqlite)
|
|
6
|
+
* e, opcionalmente, um `ArchitectureCheckReport` (SPEC-033) / `ChangeRiskAssessment` (SPEC-034) já
|
|
7
|
+
* calculados em outro lugar. Nada aqui busca dado sozinho (isso é `scripts/evidence.ts`) e nada
|
|
8
|
+
* aqui inventa um campo que não veio no input — reflete só o que os componentes já disseram (D3
|
|
9
|
+
* do plan, mesmo princípio de AC-3 em `forja engineer`).
|
|
10
|
+
*/
|
|
11
|
+
import type { AgentIdentity, ApprovalRequest, AuditRecord, EvaluationResult, RuntimeRun } from '../../../contracts/src/index.ts';
|
|
12
|
+
import type { ArchitectureCheckReport } from '../../architecture/src/index.ts';
|
|
13
|
+
import type { ChangeRiskAssessment } from '../../risk/src/index.ts';
|
|
14
|
+
export interface EvidenceLedgerInput {
|
|
15
|
+
readonly run: RuntimeRun;
|
|
16
|
+
readonly auditRecords: readonly AuditRecord[];
|
|
17
|
+
readonly approvals: readonly ApprovalRequest[];
|
|
18
|
+
readonly architectureCheck?: ArchitectureCheckReport;
|
|
19
|
+
readonly riskAssessment?: ChangeRiskAssessment;
|
|
20
|
+
readonly commit?: string;
|
|
21
|
+
}
|
|
22
|
+
export interface EvidenceLedgerRunSummary {
|
|
23
|
+
readonly runId: string;
|
|
24
|
+
readonly state: string;
|
|
25
|
+
readonly startedAt: string;
|
|
26
|
+
readonly updatedAt: string;
|
|
27
|
+
readonly steps: number;
|
|
28
|
+
readonly changedFiles: readonly string[];
|
|
29
|
+
}
|
|
30
|
+
export interface EvidenceLedgerRecord {
|
|
31
|
+
readonly run: EvidenceLedgerRunSummary;
|
|
32
|
+
readonly intent: string;
|
|
33
|
+
readonly agent: AgentIdentity;
|
|
34
|
+
readonly architectureCheck?: ArchitectureCheckReport;
|
|
35
|
+
readonly risk?: ChangeRiskAssessment;
|
|
36
|
+
readonly tests?: EvaluationResult;
|
|
37
|
+
readonly auditRecords: readonly AuditRecord[];
|
|
38
|
+
readonly approvals: readonly ApprovalRequest[];
|
|
39
|
+
readonly commit?: string;
|
|
40
|
+
}
|
|
41
|
+
export declare function buildEvidenceLedger(input: EvidenceLedgerInput): EvidenceLedgerRecord;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forja/engineering-evidence — Engineering Evidence Ledger (SPEC-035).
|
|
3
|
+
*
|
|
4
|
+
* Não é uma fonte de dado nova: `buildEvidenceLedger` é um mapeamento puro sobre um `RuntimeRun`
|
|
5
|
+
* + `AuditRecord`/`ApprovalRequest` já persistidos (packages/contracts, packages/adapter-sqlite)
|
|
6
|
+
* e, opcionalmente, um `ArchitectureCheckReport` (SPEC-033) / `ChangeRiskAssessment` (SPEC-034) já
|
|
7
|
+
* calculados em outro lugar. Nada aqui busca dado sozinho (isso é `scripts/evidence.ts`) e nada
|
|
8
|
+
* aqui inventa um campo que não veio no input — reflete só o que os componentes já disseram (D3
|
|
9
|
+
* do plan, mesmo princípio de AC-3 em `forja engineer`).
|
|
10
|
+
*/
|
|
11
|
+
export function buildEvidenceLedger(input) {
|
|
12
|
+
const { run } = input;
|
|
13
|
+
return {
|
|
14
|
+
run: {
|
|
15
|
+
runId: run.runId,
|
|
16
|
+
state: run.state,
|
|
17
|
+
startedAt: run.createdAt,
|
|
18
|
+
updatedAt: run.updatedAt,
|
|
19
|
+
steps: run.steps,
|
|
20
|
+
changedFiles: run.changedFiles,
|
|
21
|
+
},
|
|
22
|
+
intent: run.objective,
|
|
23
|
+
agent: run.agent,
|
|
24
|
+
...(input.architectureCheck === undefined ? {} : { architectureCheck: input.architectureCheck }),
|
|
25
|
+
...(input.riskAssessment === undefined ? {} : { risk: input.riskAssessment }),
|
|
26
|
+
...(run.validation === undefined ? {} : { tests: run.validation }),
|
|
27
|
+
auditRecords: input.auditRecords,
|
|
28
|
+
approvals: input.approvals,
|
|
29
|
+
...(input.commit === undefined ? {} : { commit: input.commit }),
|
|
30
|
+
};
|
|
31
|
+
}
|