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
|
@@ -116,3 +116,62 @@ export class SandboxEngine {
|
|
|
116
116
|
checksum(value) { return createHash('sha256').update(JSON.stringify({ files: [...value.files].sort(), additions: value.additions, deletions: value.deletions, evidenceIds: [...value.evidenceIds].sort() })).digest('hex'); }
|
|
117
117
|
audit(correlationId, value) { const now = new Date().toISOString(); return { ...value, schemaVersion: CONTRACT_VERSION, createdAt: now, updatedAt: now, correlationId }; }
|
|
118
118
|
}
|
|
119
|
+
/**
|
|
120
|
+
* The create→prepare→work→validate→diff→promote(-or-reject/rollback)→destroy lifecycle, as a
|
|
121
|
+
* single call instead of hand-rolled per call site. Extracted from `scripts/demo-autonomy.ts`,
|
|
122
|
+
* which proved the pattern for one capability (`fixture.code.write`) — this is that same pattern
|
|
123
|
+
* made reusable, so a future capability that edits real project files has a paved, tested path to
|
|
124
|
+
* real isolation instead of either reinventing this state machine or (as every capability
|
|
125
|
+
* registered in `apps/cli/src/index.ts` does today) skipping isolation entirely because none of
|
|
126
|
+
* them currently write to project source — see docs/security/2026-08-31 audit for why that's
|
|
127
|
+
* currently fine and when it stops being fine: the moment a capability's handler starts writing
|
|
128
|
+
* to arbitrary project files, it needs to go through this, not straight `fs`/`spawnSync` on the
|
|
129
|
+
* live tree.
|
|
130
|
+
*
|
|
131
|
+
* Always destroys the session before returning, on every outcome — a caller never has to remember
|
|
132
|
+
* cleanup. Never throws for a rejected/failed *validation* (that's a normal outcome, reported via
|
|
133
|
+
* the return value); only rethrows if `options.work` itself throws, after best-effort cleanup.
|
|
134
|
+
*
|
|
135
|
+
* `options.work` must call `sandbox.execute(session.id, ...)` (on the same `sandbox` passed in
|
|
136
|
+
* `options.sandbox`) at least once before returning: `SandboxEngine.validate()` requires the
|
|
137
|
+
* session to already be in the `'validating'` state, and only `execute()` puts it there — this
|
|
138
|
+
* mirrors `demo-autonomy.ts`'s own capability handler, which always runs its verification command
|
|
139
|
+
* (`npm test` in the worktree) before considering the edit done. Writing files without ever
|
|
140
|
+
* calling `execute()` is a caller error, not something this helper can validate away.
|
|
141
|
+
*/
|
|
142
|
+
export async function runSandboxedCapability(options) {
|
|
143
|
+
const { sandbox } = options;
|
|
144
|
+
const session = await sandbox.create({ runId: options.runId, root: options.root, backend: options.backend, correlationId: options.correlationId });
|
|
145
|
+
try {
|
|
146
|
+
await sandbox.prepare(session.id);
|
|
147
|
+
const workResult = await options.work(session);
|
|
148
|
+
const validation = await sandbox.validate(session.id);
|
|
149
|
+
if (validation.status !== 'accepted') {
|
|
150
|
+
// `validate()` already moved the session to 'rejected' when validation.status is itself
|
|
151
|
+
// 'rejected'; for 'blocked'/'inconclusive' it stays 'validating', so reject() is still a
|
|
152
|
+
// valid transition. Try it either way and ignore the "already rejected" case.
|
|
153
|
+
try {
|
|
154
|
+
await sandbox.reject(session.id);
|
|
155
|
+
}
|
|
156
|
+
catch { /* already in a terminal reject state */ }
|
|
157
|
+
const destroyed = await sandbox.destroy(session.id);
|
|
158
|
+
return { session: destroyed, outcome: 'rejected', workResult, validation };
|
|
159
|
+
}
|
|
160
|
+
const diff = await sandbox.diff(session.id);
|
|
161
|
+
await sandbox.promote(session.id, diff);
|
|
162
|
+
const destroyed = await sandbox.destroy(session.id);
|
|
163
|
+
return { session: destroyed, outcome: 'promoted', workResult, validation, diff };
|
|
164
|
+
}
|
|
165
|
+
catch (error) {
|
|
166
|
+
try {
|
|
167
|
+
await sandbox.reject(session.id);
|
|
168
|
+
}
|
|
169
|
+
catch { /* already in a terminal reject state */ }
|
|
170
|
+
let destroyed = session;
|
|
171
|
+
try {
|
|
172
|
+
destroyed = await sandbox.destroy(session.id);
|
|
173
|
+
}
|
|
174
|
+
catch { /* best-effort — nothing more we can do */ }
|
|
175
|
+
return { session: destroyed, outcome: 'failed', error };
|
|
176
|
+
}
|
|
177
|
+
}
|
|
@@ -31,6 +31,14 @@ export declare class ValidatorError extends Error {
|
|
|
31
31
|
constructor(message: string);
|
|
32
32
|
}
|
|
33
33
|
export declare class DeterministicValidator {
|
|
34
|
+
/**
|
|
35
|
+
* A `passed: true` claim with no evidenceIds is unsubstantiated: this validator has no way to
|
|
36
|
+
* confirm the check actually ran (it never executes build/test/lint/typecheck itself — it only
|
|
37
|
+
* aggregates what the caller reports), so an evidence-free "passed" is treated as not passed
|
|
38
|
+
* rather than taken on faith. The internally-computed `scope` check is exempt: it's derived
|
|
39
|
+
* here from `changedFiles`/`plan`, not asserted by the caller, so it needs no evidence pointer.
|
|
40
|
+
*/
|
|
41
|
+
private substantiated;
|
|
34
42
|
validate(request: ValidationRequest): EvaluationResult;
|
|
35
43
|
private summary;
|
|
36
44
|
}
|
|
@@ -6,16 +6,31 @@ export class ValidatorError extends Error {
|
|
|
6
6
|
}
|
|
7
7
|
}
|
|
8
8
|
export class DeterministicValidator {
|
|
9
|
+
/**
|
|
10
|
+
* A `passed: true` claim with no evidenceIds is unsubstantiated: this validator has no way to
|
|
11
|
+
* confirm the check actually ran (it never executes build/test/lint/typecheck itself — it only
|
|
12
|
+
* aggregates what the caller reports), so an evidence-free "passed" is treated as not passed
|
|
13
|
+
* rather than taken on faith. The internally-computed `scope` check is exempt: it's derived
|
|
14
|
+
* here from `changedFiles`/`plan`, not asserted by the caller, so it needs no evidence pointer.
|
|
15
|
+
*/
|
|
16
|
+
substantiated(item) {
|
|
17
|
+
return item.passed && item.evidenceIds.length > 0;
|
|
18
|
+
}
|
|
9
19
|
validate(request) {
|
|
10
20
|
const required = request.requiredChecks ?? ['build', 'tests', 'lint', 'typecheck'];
|
|
11
|
-
const
|
|
21
|
+
const scopeCheckName = 'scope';
|
|
12
22
|
const allowedFiles = request.plan.steps.flatMap((step) => step.allowedFiles);
|
|
13
23
|
const outOfScope = request.changedFiles.filter((file) => !allowedFiles.some((allowed) => allowed === file || allowed === '*' || (allowed.endsWith('/') && file.startsWith(allowed))));
|
|
14
|
-
|
|
24
|
+
const scopeCheck = { name: scopeCheckName, passed: outOfScope.length === 0, evidenceIds: [], detail: outOfScope.length === 0 ? 'All changed files are within plan scope' : `Out of scope: ${outOfScope.join(', ')}` };
|
|
25
|
+
const checks = [...request.checks, scopeCheck];
|
|
26
|
+
// A validation that reports zero checks and zero acceptance results proves nothing, no matter
|
|
27
|
+
// how empty `requiredChecks` is set — without this, an empty `checks`/`acceptance`/
|
|
28
|
+
// `requiredChecks` trio sails straight through every other condition below as "accepted".
|
|
29
|
+
const noWorkReported = request.checks.length === 0 && request.acceptance.length === 0;
|
|
15
30
|
const missingChecks = required.filter((name) => !request.checks.some((check) => check.name === name));
|
|
16
|
-
const failedChecks = checks.filter((check) => !check.passed);
|
|
31
|
+
const failedChecks = checks.filter((check) => check.name === scopeCheckName ? !check.passed : !this.substantiated(check));
|
|
17
32
|
const missingAcceptance = request.plan.steps.flatMap((step) => step.acceptanceCriteria).filter((criterion) => !request.acceptance.some((result) => result.criterion === criterion));
|
|
18
|
-
const failedAcceptance = request.acceptance.filter((result) => !result
|
|
33
|
+
const failedAcceptance = request.acceptance.filter((result) => !this.substantiated(result));
|
|
19
34
|
const contradictions = request.contradictions ?? [];
|
|
20
35
|
const securityFindings = request.securityFindings ?? [];
|
|
21
36
|
const severeSecurity = securityFindings.filter((finding) => finding.severity === 'high' || finding.severity === 'critical');
|
|
@@ -30,7 +45,7 @@ export class DeterministicValidator {
|
|
|
30
45
|
status = 'blocked';
|
|
31
46
|
else if (outOfScope.length > 0 || failedChecks.length > 0 || failedAcceptance.length > 0 || contradictions.length > 0 || severeSecurity.length > 0)
|
|
32
47
|
status = 'rejected';
|
|
33
|
-
else if (missingChecks.length > 0 || missingAcceptance.length > 0)
|
|
48
|
+
else if (missingChecks.length > 0 || missingAcceptance.length > 0 || noWorkReported)
|
|
34
49
|
status = 'inconclusive';
|
|
35
50
|
const now = new Date().toISOString();
|
|
36
51
|
return {
|
|
@@ -40,7 +55,7 @@ export class DeterministicValidator {
|
|
|
40
55
|
correlationId: request.correlationId ?? request.plan.id,
|
|
41
56
|
status,
|
|
42
57
|
checks: [
|
|
43
|
-
...checks.map(({ name, passed, evidenceIds }) => ({ name, passed, evidenceIds })),
|
|
58
|
+
...checks.map(({ name, passed, evidenceIds }) => ({ name, passed: name === scopeCheckName ? passed : this.substantiated({ passed, evidenceIds }), evidenceIds })),
|
|
44
59
|
{ name: 'acceptance', passed: failedAcceptance.length === 0 && missingAcceptance.length === 0, evidenceIds: request.acceptance.flatMap((result) => result.evidenceIds) },
|
|
45
60
|
{ name: 'contradictions', passed: contradictions.length === 0, evidenceIds: contradictions.flatMap((item) => item.evidenceIds) },
|
|
46
61
|
{ name: 'security', passed: severeSecurity.length === 0, evidenceIds: severeSecurity.flatMap((item) => item.evidenceIds) },
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* adr:list / adr:show / adr:impact / adr:graph (SPEC-032)
|
|
4
|
+
*
|
|
5
|
+
* forja adr:list lista ADRs com status
|
|
6
|
+
* forja adr:show <id> mostra uma ADR: status, arquivo, constraints (se houver)
|
|
7
|
+
* forja adr:impact <id> componentes/documentos alcançáveis a partir da ADR
|
|
8
|
+
* forja adr:graph [<id>] subgrafo (JSON) de nós ADR/SPEC + vizinhança direta
|
|
9
|
+
*
|
|
10
|
+
* Reindexa o workspace pelo mesmo mecanismo de `graph:sync`/`drift:check` (checksum de fonte +
|
|
11
|
+
* extração determinística) antes de consultar — mesma escolha de `drift:check`, para não exigir
|
|
12
|
+
* que o operador lembre de rodar `code:sync` antes. `<id>` aceita `0020` ou `ADR-0020`
|
|
13
|
+
* indiferentemente.
|
|
14
|
+
*
|
|
15
|
+
* Só leitura: nenhum destes comandos escreve em arquivo de projeto (SPEC-032 §5).
|
|
16
|
+
*/
|
|
17
|
+
export {};
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* adr:list / adr:show / adr:impact / adr:graph (SPEC-032)
|
|
4
|
+
*
|
|
5
|
+
* forja adr:list lista ADRs com status
|
|
6
|
+
* forja adr:show <id> mostra uma ADR: status, arquivo, constraints (se houver)
|
|
7
|
+
* forja adr:impact <id> componentes/documentos alcançáveis a partir da ADR
|
|
8
|
+
* forja adr:graph [<id>] subgrafo (JSON) de nós ADR/SPEC + vizinhança direta
|
|
9
|
+
*
|
|
10
|
+
* Reindexa o workspace pelo mesmo mecanismo de `graph:sync`/`drift:check` (checksum de fonte +
|
|
11
|
+
* extração determinística) antes de consultar — mesma escolha de `drift:check`, para não exigir
|
|
12
|
+
* que o operador lembre de rodar `code:sync` antes. `<id>` aceita `0020` ou `ADR-0020`
|
|
13
|
+
* indiferentemente.
|
|
14
|
+
*
|
|
15
|
+
* Só leitura: nenhum destes comandos escreve em arquivo de projeto (SPEC-032 §5).
|
|
16
|
+
*/
|
|
17
|
+
import fs from 'node:fs';
|
|
18
|
+
import path from 'node:path';
|
|
19
|
+
import Database from 'better-sqlite3';
|
|
20
|
+
import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
|
|
21
|
+
import { GraphIndexer, GraphLoop } from "../packages/graph/src/index.js";
|
|
22
|
+
import { SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
|
|
23
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
|
|
24
|
+
function normalizeAdrId(raw) {
|
|
25
|
+
const digits = /(\d{4})/.exec(raw)?.[1];
|
|
26
|
+
return digits === undefined ? raw : `ADR-${digits}`;
|
|
27
|
+
}
|
|
28
|
+
function adrFile(id) {
|
|
29
|
+
const digits = /(\d{4})/.exec(id)?.[1];
|
|
30
|
+
if (digits === undefined)
|
|
31
|
+
return undefined;
|
|
32
|
+
const dir = path.join(process.env.FORJA_GRAPH_ROOT ?? process.cwd(), 'memory', '90-decisions');
|
|
33
|
+
if (!fs.existsSync(dir))
|
|
34
|
+
return undefined;
|
|
35
|
+
const match = fs.readdirSync(dir).find((name) => name.startsWith(`${digits}-`));
|
|
36
|
+
return match === undefined ? undefined : path.join(dir, match);
|
|
37
|
+
}
|
|
38
|
+
function constraintsOf(file) {
|
|
39
|
+
const content = fs.readFileSync(file, 'utf8');
|
|
40
|
+
const section = /## Constraints\n([\s\S]*?)(?:\n## |\n?$)/.exec(content)?.[1];
|
|
41
|
+
if (section === undefined)
|
|
42
|
+
return [];
|
|
43
|
+
return section.split('\n').map((line) => line.trim()).filter((line) => line.startsWith('- '));
|
|
44
|
+
}
|
|
45
|
+
async function withGraph(fn) {
|
|
46
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
47
|
+
const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
48
|
+
new SqliteMigrationRunner(database).apply();
|
|
49
|
+
const store = new SqliteGraphStore(database);
|
|
50
|
+
const graph = new GraphLoop(store);
|
|
51
|
+
const source = new GitGraphDocumentSource(process.env.FORJA_GRAPH_ROOT ?? process.cwd(), new SpawnCommandRunner());
|
|
52
|
+
await new GraphIndexer(graph).sync(source);
|
|
53
|
+
try {
|
|
54
|
+
return await fn(graph, store);
|
|
55
|
+
}
|
|
56
|
+
finally {
|
|
57
|
+
database.close();
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
async function cmdList() {
|
|
61
|
+
await withGraph((graph) => {
|
|
62
|
+
const adrs = [...graph.query({ type: 'ADR' })].sort((left, right) => left.label.localeCompare(right.label));
|
|
63
|
+
if (adrs.length === 0) {
|
|
64
|
+
console.log('Nenhuma ADR encontrada no grafo.');
|
|
65
|
+
return;
|
|
66
|
+
}
|
|
67
|
+
console.log(`${adrs.length} ADR(s):\n`);
|
|
68
|
+
for (const node of adrs)
|
|
69
|
+
console.log(`${node.label}\t${node.documentStatus ?? '(status desconhecido)'}`);
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
async function cmdShow([rawId]) {
|
|
73
|
+
if (!rawId) {
|
|
74
|
+
console.error('Uso: forja adr:show <id>');
|
|
75
|
+
process.exit(1);
|
|
76
|
+
}
|
|
77
|
+
const id = normalizeAdrId(rawId);
|
|
78
|
+
await withGraph((graph) => {
|
|
79
|
+
const node = graph.query({ type: 'ADR' }).find((item) => item.label === id);
|
|
80
|
+
if (node === undefined) {
|
|
81
|
+
console.error(`ADR não encontrada no grafo: ${id}`);
|
|
82
|
+
process.exit(1);
|
|
83
|
+
return;
|
|
84
|
+
}
|
|
85
|
+
const file = adrFile(id);
|
|
86
|
+
console.log(`${node.label} — ${node.documentStatus ?? '(status desconhecido)'}`);
|
|
87
|
+
console.log(`arquivo: ${file ?? '(não encontrado em memory/90-decisions)'}`);
|
|
88
|
+
if (file !== undefined) {
|
|
89
|
+
const constraints = constraintsOf(file);
|
|
90
|
+
if (constraints.length > 0) {
|
|
91
|
+
console.log('\nConstraints:');
|
|
92
|
+
for (const line of constraints)
|
|
93
|
+
console.log(` ${line}`);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
async function cmdImpact([rawId, depthArg]) {
|
|
99
|
+
if (!rawId) {
|
|
100
|
+
console.error('Uso: forja adr:impact <id> [profundidade]');
|
|
101
|
+
process.exit(1);
|
|
102
|
+
}
|
|
103
|
+
const id = normalizeAdrId(rawId);
|
|
104
|
+
const depth = Number.parseInt(depthArg ?? '', 10) || 2;
|
|
105
|
+
await withGraph((graph) => {
|
|
106
|
+
const node = graph.query({ type: 'ADR' }).find((item) => item.label === id);
|
|
107
|
+
if (node === undefined) {
|
|
108
|
+
console.error(`ADR não encontrada no grafo: ${id}`);
|
|
109
|
+
process.exit(1);
|
|
110
|
+
return;
|
|
111
|
+
}
|
|
112
|
+
const impact = graph.impact(node.id, depth, 'incoming'); // incoming: quem DEPENDS_ON/DERIVED_FROM/governed_by aponta PARA a ADR
|
|
113
|
+
console.log(`Impacto de ${id} (profundidade ${depth}):\n`);
|
|
114
|
+
console.log(`${impact.nodes.length - 1} nó(s) alcançável(is), ${impact.edges.length} aresta(s):\n`);
|
|
115
|
+
for (const n of impact.nodes)
|
|
116
|
+
if (n.id !== node.id)
|
|
117
|
+
console.log(` ${n.type}\t${n.label}`);
|
|
118
|
+
});
|
|
119
|
+
}
|
|
120
|
+
async function cmdGraph([rawId]) {
|
|
121
|
+
await withGraph((graph) => {
|
|
122
|
+
if (rawId) {
|
|
123
|
+
const id = normalizeAdrId(rawId);
|
|
124
|
+
const node = [...graph.query({ type: 'ADR' }), ...graph.query({ type: 'SPEC' })].find((item) => item.label === id);
|
|
125
|
+
if (node === undefined) {
|
|
126
|
+
console.error(`Não encontrado no grafo: ${id}`);
|
|
127
|
+
process.exit(1);
|
|
128
|
+
return;
|
|
129
|
+
}
|
|
130
|
+
console.log(JSON.stringify(graph.impact(node.id, 1, 'both'), null, 2));
|
|
131
|
+
return;
|
|
132
|
+
}
|
|
133
|
+
const nodes = [...graph.query({ type: 'ADR' }), ...graph.query({ type: 'SPEC' })];
|
|
134
|
+
console.log(JSON.stringify({ nodes }, null, 2));
|
|
135
|
+
});
|
|
136
|
+
}
|
|
137
|
+
async function main() {
|
|
138
|
+
const [subcommand, ...rest] = process.argv.slice(2);
|
|
139
|
+
switch (subcommand) {
|
|
140
|
+
case 'list': return cmdList();
|
|
141
|
+
case 'show': return cmdShow(rest);
|
|
142
|
+
case 'impact': return cmdImpact(rest);
|
|
143
|
+
case 'graph': return cmdGraph(rest);
|
|
144
|
+
default:
|
|
145
|
+
console.error('Uso: forja adr:<list|show|impact|graph> [args]');
|
|
146
|
+
process.exit(1);
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
main().catch((error) => {
|
|
150
|
+
console.error(`\nadr: falhou: ${error instanceof Error ? error.message : String(error)}`);
|
|
151
|
+
process.exit(1);
|
|
152
|
+
});
|
|
@@ -5,6 +5,7 @@ import { spawnSync } from 'node:child_process';
|
|
|
5
5
|
import { fileURLToPath } from 'node:url';
|
|
6
6
|
import { initWorkspace, getWorkspaceInfo, listProjects, resolveProject, getWorkspaceProjectsMemoryDir, } from "../lib/workspace.js";
|
|
7
7
|
import { resolveScript } from "../lib/core/registry.js";
|
|
8
|
+
import { isPathWithinRoot } from "../packages/contracts/src/index.js";
|
|
8
9
|
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
9
10
|
// `root` = recursos do FRAMEWORK (ex.: design:* lê design-md/) — resolvidos por __dirname.
|
|
10
11
|
// `projectRoot` = o PROJETO do usuário (gsd:* opera em specs/ e .context/ dele) — onde foi invocado.
|
|
@@ -77,7 +78,7 @@ function readText(file) {
|
|
|
77
78
|
// O brief do `design:check` é do PROJETO do usuário (cwd), não do pacote — a âncora e o guardrail
|
|
78
79
|
// de travessia são o projectRoot. Cravar `root` rejeitava o brief do consumidor ("fora do projeto").
|
|
79
80
|
const full = path.resolve(projectRoot, file);
|
|
80
|
-
if (!
|
|
81
|
+
if (!isPathWithinRoot(projectRoot, full))
|
|
81
82
|
fail(`Caminho fora do projeto: ${file}`);
|
|
82
83
|
if (!fs.existsSync(full))
|
|
83
84
|
fail(`Arquivo nao encontrado: ${file}`);
|
|
@@ -178,6 +179,13 @@ function cmdCodeCheck() {
|
|
|
178
179
|
function cmdCodeImpact([symbol, depthArg]) {
|
|
179
180
|
if (!symbol)
|
|
180
181
|
fail('Uso: agent-harness code:impact <simbolo> [profundidade]');
|
|
182
|
+
// `symbol` vira um elemento de argv passado direto para o binário `codegraph` — não há shell
|
|
183
|
+
// envolvido no caminho normal, então não é injeção de comando, mas um valor começando com `-`
|
|
184
|
+
// ainda pode ser lido como flag pelo `codegraph` em vez de símbolo posicional (injeção de
|
|
185
|
+
// argumento). O comando roda a partir de texto que pode ter vindo de um agente de IA, então
|
|
186
|
+
// vale recusar cedo em vez de confiar no parser do binário externo.
|
|
187
|
+
if (symbol.startsWith('-'))
|
|
188
|
+
fail(`Simbolo invalido (nao pode comecar com '-'): ${symbol}`);
|
|
181
189
|
const res0 = runCodegraph(['status', '--json']);
|
|
182
190
|
if (res0.missing) {
|
|
183
191
|
console.log('Codegraph nao instalado. Sem mapa de impacto automatico.');
|
|
@@ -278,39 +286,39 @@ function cmdGsdPlan([slug = 'run', ...goalParts]) {
|
|
|
278
286
|
const outFile = path.join(outDir, `gsd-${safeSlug}.md`);
|
|
279
287
|
const specPath = path.join(projectRoot, 'specs', safeSlug, 'spec.md');
|
|
280
288
|
const hasSpec = fs.existsSync(specPath);
|
|
281
|
-
const content = `# GSD Runbook: ${safeSlug}
|
|
282
|
-
|
|
283
|
-
- **Objetivo**: ${goal}
|
|
284
|
-
- **Spec**: ${hasSpec ? path.relative(projectRoot, specPath) : 'nao encontrada'}
|
|
285
|
-
- **Gerado em**: ${new Date().toISOString()}
|
|
286
|
-
|
|
287
|
-
## Gates
|
|
288
|
-
|
|
289
|
-
- [ ] 1. Briefing: nome, objetivo, contexto, usuarios/papeis, riscos, primeira entrega esperada e slug gerado.
|
|
290
|
-
- [ ] 2. Estrutura: pastas, memoria, specs, agentes, scripts, dashboard e dependencias conferidos.
|
|
291
|
-
- [ ] 3. Sprints: sprint atual, proxima sprint, backlog e metrica 30d definidos.
|
|
292
|
-
- [ ] 4. Contexto: \`npm run dev -- context:build task ${safeSlug} "<keyword>"\`.
|
|
293
|
-
- [ ] 5. Mapa de impacto: \`npm run code:check\` e \`npm run code:impact <simbolo>\` para o blast radius antes de planejar/editar (ADR-0017).
|
|
294
|
-
- [ ] 6. Spec: problema, escopo e AC testaveis em \`specs/${safeSlug}/spec.md\`.
|
|
295
|
-
- [ ] 7. Design: brief aprovado via \`npm run dev -- design:check <brief.md>\`.
|
|
296
|
-
- [ ] 8. Plano: plan/tasks aprovados quando houver impacto estrutural.
|
|
297
|
-
- [ ] 9. Desenvolvimento: ownership de arquivos definido antes do Worker.
|
|
298
|
-
- [ ] 10. Validacao: \`npm run dev -- gsd:check ${safeSlug} <brief.md>\` e \`npm test\`.
|
|
299
|
-
- [ ] 11. Governance: \`npm run project:check -- <projeto>\` quando houver projeto alvo.
|
|
300
|
-
|
|
301
|
-
## Hermes handoffs sugeridos
|
|
302
|
-
|
|
303
|
-
1. \`npm run gsd:handoff -- spec ${safeSlug}\`
|
|
304
|
-
2. \`npm run gsd:handoff -- plan ${safeSlug}\`
|
|
305
|
-
3. \`npm run gsd:handoff -- implement ${safeSlug}\`
|
|
306
|
-
4. \`npm run gsd:handoff -- review ${safeSlug}\`
|
|
307
|
-
|
|
308
|
-
## Notas
|
|
309
|
-
|
|
310
|
-
- Use Hermes para registrar cada passagem com os 7 campos do ADR-0005.
|
|
311
|
-
- Antes de editar codigo, rode \`npm run code:impact -- <simbolo>\` para ver chamadores e blast radius (ADR-0017).
|
|
312
|
-
- Use \`design-md/MATRIX.md\` para escolher referencia visual antes de construir UI.
|
|
313
|
-
- Rode \`npm run gsd:check -- ${safeSlug} <brief.md>\` antes de entregar para Governance.
|
|
289
|
+
const content = `# GSD Runbook: ${safeSlug}
|
|
290
|
+
|
|
291
|
+
- **Objetivo**: ${goal}
|
|
292
|
+
- **Spec**: ${hasSpec ? path.relative(projectRoot, specPath) : 'nao encontrada'}
|
|
293
|
+
- **Gerado em**: ${new Date().toISOString()}
|
|
294
|
+
|
|
295
|
+
## Gates
|
|
296
|
+
|
|
297
|
+
- [ ] 1. Briefing: nome, objetivo, contexto, usuarios/papeis, riscos, primeira entrega esperada e slug gerado.
|
|
298
|
+
- [ ] 2. Estrutura: pastas, memoria, specs, agentes, scripts, dashboard e dependencias conferidos.
|
|
299
|
+
- [ ] 3. Sprints: sprint atual, proxima sprint, backlog e metrica 30d definidos.
|
|
300
|
+
- [ ] 4. Contexto: \`npm run dev -- context:build task ${safeSlug} "<keyword>"\`.
|
|
301
|
+
- [ ] 5. Mapa de impacto: \`npm run code:check\` e \`npm run code:impact <simbolo>\` para o blast radius antes de planejar/editar (ADR-0017).
|
|
302
|
+
- [ ] 6. Spec: problema, escopo e AC testaveis em \`specs/${safeSlug}/spec.md\`.
|
|
303
|
+
- [ ] 7. Design: brief aprovado via \`npm run dev -- design:check <brief.md>\`.
|
|
304
|
+
- [ ] 8. Plano: plan/tasks aprovados quando houver impacto estrutural.
|
|
305
|
+
- [ ] 9. Desenvolvimento: ownership de arquivos definido antes do Worker.
|
|
306
|
+
- [ ] 10. Validacao: \`npm run dev -- gsd:check ${safeSlug} <brief.md>\` e \`npm test\`.
|
|
307
|
+
- [ ] 11. Governance: \`npm run project:check -- <projeto>\` quando houver projeto alvo.
|
|
308
|
+
|
|
309
|
+
## Hermes handoffs sugeridos
|
|
310
|
+
|
|
311
|
+
1. \`npm run gsd:handoff -- spec ${safeSlug}\`
|
|
312
|
+
2. \`npm run gsd:handoff -- plan ${safeSlug}\`
|
|
313
|
+
3. \`npm run gsd:handoff -- implement ${safeSlug}\`
|
|
314
|
+
4. \`npm run gsd:handoff -- review ${safeSlug}\`
|
|
315
|
+
|
|
316
|
+
## Notas
|
|
317
|
+
|
|
318
|
+
- Use Hermes para registrar cada passagem com os 7 campos do ADR-0005.
|
|
319
|
+
- Antes de editar codigo, rode \`npm run code:impact -- <simbolo>\` para ver chamadores e blast radius (ADR-0017).
|
|
320
|
+
- Use \`design-md/MATRIX.md\` para escolher referencia visual antes de construir UI.
|
|
321
|
+
- Rode \`npm run gsd:check -- ${safeSlug} <brief.md>\` antes de entregar para Governance.
|
|
314
322
|
`;
|
|
315
323
|
fs.writeFileSync(outFile, content, 'utf8');
|
|
316
324
|
console.log(`GSD runbook criado: ${path.relative(projectRoot, outFile)}`);
|
|
@@ -392,7 +400,7 @@ function cmdGsdCheck([slug, briefPath]) {
|
|
|
392
400
|
const fullBrief = path.resolve(root, briefPath);
|
|
393
401
|
let ok = false;
|
|
394
402
|
let detail = briefPath;
|
|
395
|
-
if (
|
|
403
|
+
if (isPathWithinRoot(root, fullBrief) && fs.existsSync(fullBrief)) {
|
|
396
404
|
const content = fs.readFileSync(fullBrief, 'utf8');
|
|
397
405
|
const missing = DESIGN_REQUIRED.filter((needle) => !content.includes(needle));
|
|
398
406
|
const placeholders = (content.match(/<[^>\n]+>/g) || []).length;
|
|
@@ -460,16 +468,16 @@ function registerProjectCard(name, projectDir, flags) {
|
|
|
460
468
|
const cardPath = path.join(cardsDir, `${name}.md`);
|
|
461
469
|
if (fs.existsSync(cardPath))
|
|
462
470
|
return;
|
|
463
|
-
fs.writeFileSync(cardPath, `# Projeto: ${name}
|
|
464
|
-
|
|
465
|
-
- **Status**: ativo
|
|
466
|
-
- **Criado em**: ${new Date().toISOString().slice(0, 10)}
|
|
467
|
-
- **Path**: ${projectDir}
|
|
468
|
-
- **Origem**: forja project:new${flags.length ? ` (${flags.join(' ')})` : ''}
|
|
469
|
-
|
|
470
|
-
## Notas
|
|
471
|
-
|
|
472
|
-
- Ficha criada automaticamente pelo core (ADR-0020). Complete com objetivo, stack e métrica 30d.
|
|
471
|
+
fs.writeFileSync(cardPath, `# Projeto: ${name}
|
|
472
|
+
|
|
473
|
+
- **Status**: ativo
|
|
474
|
+
- **Criado em**: ${new Date().toISOString().slice(0, 10)}
|
|
475
|
+
- **Path**: ${projectDir}
|
|
476
|
+
- **Origem**: forja project:new${flags.length ? ` (${flags.join(' ')})` : ''}
|
|
477
|
+
|
|
478
|
+
## Notas
|
|
479
|
+
|
|
480
|
+
- Ficha criada automaticamente pelo core (ADR-0020). Complete com objetivo, stack e métrica 30d.
|
|
473
481
|
`, 'utf8');
|
|
474
482
|
console.log(`Ficha registrada: ${cardPath}`);
|
|
475
483
|
}
|
|
@@ -502,25 +510,25 @@ function cmdProjectCheck([name]) {
|
|
|
502
510
|
process.exit(result.status ?? 1);
|
|
503
511
|
}
|
|
504
512
|
function showHelp() {
|
|
505
|
-
console.log(`Uso: node scripts/agent-harness.mjs <command> [args]
|
|
506
|
-
|
|
507
|
-
Workspace:
|
|
508
|
-
workspace:init Cria estrutura base do workspace Forja
|
|
509
|
-
project:new <nome> Cria projeto no workspace
|
|
510
|
-
project:list Lista projetos do workspace
|
|
511
|
-
project:check <nome> Valida padroes no projeto do workspace
|
|
512
|
-
|
|
513
|
-
Pipeline / Handoffs:
|
|
514
|
-
gsd:plan <slug> [objetivo] Cria runbook GSD em .context/
|
|
515
|
-
gsd:handoff <fase> <slug> Registra handoff GSD padronizado
|
|
516
|
-
gsd:check <slug> [brief.md] Valida gates basicos do runbook
|
|
517
|
-
hermes:handoff '<json>' Registra handoff ADR-0005 via agent-router
|
|
518
|
-
|
|
519
|
-
Design / Code intelligence:
|
|
520
|
-
design:check <brief.md> Valida brief visual local
|
|
521
|
-
design:select <surface> [tom] Sugere referencias design-md
|
|
522
|
-
code:check Valida indice codegraph (worktree + freshness)
|
|
523
|
-
code:impact <simbolo> [depth] Mostra chamadores e blast radius via codegraph
|
|
513
|
+
console.log(`Uso: node scripts/agent-harness.mjs <command> [args]
|
|
514
|
+
|
|
515
|
+
Workspace:
|
|
516
|
+
workspace:init Cria estrutura base do workspace Forja
|
|
517
|
+
project:new <nome> Cria projeto no workspace
|
|
518
|
+
project:list Lista projetos do workspace
|
|
519
|
+
project:check <nome> Valida padroes no projeto do workspace
|
|
520
|
+
|
|
521
|
+
Pipeline / Handoffs:
|
|
522
|
+
gsd:plan <slug> [objetivo] Cria runbook GSD em .context/
|
|
523
|
+
gsd:handoff <fase> <slug> Registra handoff GSD padronizado
|
|
524
|
+
gsd:check <slug> [brief.md] Valida gates basicos do runbook
|
|
525
|
+
hermes:handoff '<json>' Registra handoff ADR-0005 via agent-router
|
|
526
|
+
|
|
527
|
+
Design / Code intelligence:
|
|
528
|
+
design:check <brief.md> Valida brief visual local
|
|
529
|
+
design:select <surface> [tom] Sugere referencias design-md
|
|
530
|
+
code:check Valida indice codegraph (worktree + freshness)
|
|
531
|
+
code:impact <simbolo> [depth] Mostra chamadores e blast radius via codegraph
|
|
524
532
|
`);
|
|
525
533
|
}
|
|
526
534
|
const [command, ...rest] = process.argv.slice(2);
|
|
@@ -52,23 +52,23 @@ function openDb() {
|
|
|
52
52
|
const db = new Database(dbPath, { timeout: 5000 });
|
|
53
53
|
db.pragma('busy_timeout = 5000');
|
|
54
54
|
db.pragma('journal_mode = WAL');
|
|
55
|
-
withBusyRetry(() => db.exec(`
|
|
56
|
-
CREATE TABLE IF NOT EXISTS handoffs (
|
|
57
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
58
|
-
created_at TEXT NOT NULL,
|
|
59
|
-
from_agent TEXT NOT NULL,
|
|
60
|
-
to_agent TEXT NOT NULL,
|
|
61
|
-
intent TEXT NOT NULL,
|
|
62
|
-
context TEXT NOT NULL,
|
|
63
|
-
acceptance TEXT NOT NULL,
|
|
64
|
-
constraints TEXT NOT NULL,
|
|
65
|
-
return_to TEXT NOT NULL,
|
|
66
|
-
spec_slug TEXT,
|
|
67
|
-
status TEXT DEFAULT 'open',
|
|
68
|
-
payload_json TEXT
|
|
69
|
-
);
|
|
70
|
-
CREATE INDEX IF NOT EXISTS idx_handoffs_status ON handoffs(status);
|
|
71
|
-
CREATE INDEX IF NOT EXISTS idx_handoffs_to ON handoffs(to_agent, status);
|
|
55
|
+
withBusyRetry(() => db.exec(`
|
|
56
|
+
CREATE TABLE IF NOT EXISTS handoffs (
|
|
57
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
58
|
+
created_at TEXT NOT NULL,
|
|
59
|
+
from_agent TEXT NOT NULL,
|
|
60
|
+
to_agent TEXT NOT NULL,
|
|
61
|
+
intent TEXT NOT NULL,
|
|
62
|
+
context TEXT NOT NULL,
|
|
63
|
+
acceptance TEXT NOT NULL,
|
|
64
|
+
constraints TEXT NOT NULL,
|
|
65
|
+
return_to TEXT NOT NULL,
|
|
66
|
+
spec_slug TEXT,
|
|
67
|
+
status TEXT DEFAULT 'open',
|
|
68
|
+
payload_json TEXT
|
|
69
|
+
);
|
|
70
|
+
CREATE INDEX IF NOT EXISTS idx_handoffs_status ON handoffs(status);
|
|
71
|
+
CREATE INDEX IF NOT EXISTS idx_handoffs_to ON handoffs(to_agent, status);
|
|
72
72
|
`));
|
|
73
73
|
return db;
|
|
74
74
|
}
|
|
@@ -119,9 +119,9 @@ function cmdAppend(arg) {
|
|
|
119
119
|
const raw = arg && arg !== '-' ? arg : readStdin();
|
|
120
120
|
const h = parsePayload(raw);
|
|
121
121
|
const db = openDb();
|
|
122
|
-
const stmt = db.prepare(`
|
|
123
|
-
INSERT INTO handoffs (created_at, from_agent, to_agent, intent, context, acceptance, constraints, return_to, spec_slug, payload_json)
|
|
124
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
|
|
122
|
+
const stmt = db.prepare(`
|
|
123
|
+
INSERT INTO handoffs (created_at, from_agent, to_agent, intent, context, acceptance, constraints, return_to, spec_slug, payload_json)
|
|
124
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
|
|
125
125
|
`);
|
|
126
126
|
const result = withBusyRetry(() => stmt.run(new Date().toISOString(), h.from, h.to, h.intent, h.context, h.acceptance, h.constraints, h.return, h.spec_slug || null, JSON.stringify(h)));
|
|
127
127
|
console.log(JSON.stringify({ id: result.lastInsertRowid, status: 'open', from: h.from, to: h.to, intent: h.intent }));
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* agent:register / :list / :show / :score / :history / :recommend / :monitor
|
|
4
|
+
* (SPEC-036, SPEC-037, SPEC-040)
|
|
5
|
+
*
|
|
6
|
+
* forja agent:register <id> --role <role> [--provider <p>] [--model <m>]
|
|
7
|
+
* [--capabilities <c1,c2>] [--domains <d1,d2>]
|
|
8
|
+
* [--max-files <n>] [--max-cost-usd <n>]
|
|
9
|
+
* forja agent:list todos os agentes registrados, com trustLevel se já pontuado
|
|
10
|
+
* forja agent:show <id> detalhe de um agente
|
|
11
|
+
* forja agent:score <id> [--domain <d>] computa e persiste trustLevel/autonomyLevel via Observation reais
|
|
12
|
+
* forja agent:history <id> Observations do agente, mais recentes primeiro
|
|
13
|
+
* forja agent:recommend --role <role> [--domain <d>] ranking de agentes registrados por
|
|
14
|
+
* adequação — informação, não atribuição (SPEC-037 AC-4)
|
|
15
|
+
* forja agent:monitor <id> [--window-hours <n>] compara comportamento recente (últimas <n>h,
|
|
16
|
+
* default 24) contra a linha de base histórica —
|
|
17
|
+
* informação, nunca bloqueia nada sozinho (SPEC-040 AC-5)
|
|
18
|
+
*
|
|
19
|
+
* `packages/engineering/identity` faz o cálculo puro (computeReputationScore, recommendAgent);
|
|
20
|
+
* `packages/engineering/monitoring` faz a comparação pura (detectAnomaly). Este script busca
|
|
21
|
+
* `Observation`s reais (`SqliteObservationStore`, já existente), monta o `EvaluationReport` via
|
|
22
|
+
* `EvaluationEngine` (`packages/evals`, já existente — nenhuma métrica reimplementada aqui) e
|
|
23
|
+
* persiste `AgentProfile2` (`SqliteAgentProfileStore`, sem migration nova — D3 do plan de
|
|
24
|
+
* SPEC-036). `agent:register` deliberadamente não tem flag de trust-level/autonomy-level — só
|
|
25
|
+
* `agent:score` escreve esses campos (D2 do plan, AC-1/AC-3 de SPEC-036).
|
|
26
|
+
*/
|
|
27
|
+
export {};
|