forjajs 2.0.4 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +19 -25
- package/.claude/agents/governance.md +19 -55
- package/.claude/agents/marketing.md +19 -24
- package/.claude/agents/orchestrator.md +19 -31
- package/.claude/agents/product.md +19 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +19 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +93 -87
- package/.github/copilot-instructions.md +93 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +93 -87
- package/AGENTS.md +137 -134
- package/CHANGELOG.md +656 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +68 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +17 -1
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/release.js +3 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/llm/codex-output.d.ts +12 -0
- package/dist/lib/llm/codex-output.js +56 -0
- package/dist/lib/llm/context.d.ts +5 -0
- package/dist/lib/llm/context.js +17 -0
- package/dist/lib/llm/session.d.ts +18 -0
- package/dist/lib/llm/session.js +34 -0
- package/dist/lib/llm/validation.d.ts +37 -0
- package/dist/lib/llm/validation.js +88 -0
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/evals/src/index.js +6 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.d.ts +8 -1
- package/dist/packages/llm/src/index.js +64 -7
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +85 -9
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/agent-operating-contract.md +26 -0
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-evolution.md +51 -0
- package/docs/llm-fit-loop.md +134 -5
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/publishing.md +49 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/0080-llm-execution-evidence.md +42 -0
- package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +159 -157
- package/prompts/context-engineer-agent.md +13 -19
- package/prompts/governance-agent.md +13 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +13 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +13 -20
- package/skills/MANIFEST.json +10 -0
- package/skills/llm-provider-routing/SKILL.md +18 -0
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +50 -43
- package/specs/_templates/spec.md +50 -43
- package/specs/_templates/tasks.md +39 -32
- package/specs/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-instructions-v4/plan.md +8 -0
- package/specs/agent-instructions-v4/spec.md +21 -0
- package/specs/agent-instructions-v4/tasks.md +12 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/cost-aware-autonomy-budget/spec.md +102 -0
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/llm-integration-v2/plan.md +55 -0
- package/specs/llm-integration-v2/spec.md +61 -0
- package/specs/llm-integration-v2/tasks.md +28 -0
- package/specs/llm-resume-validation/plan.md +50 -0
- package/specs/llm-resume-validation/spec.md +35 -0
- package/specs/llm-resume-validation/tasks.md +19 -0
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/spec.md +23 -23
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -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 {};
|
|
@@ -0,0 +1,249 @@
|
|
|
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
|
+
import fs from 'node:fs';
|
|
28
|
+
import Database from 'better-sqlite3';
|
|
29
|
+
import { computeReputationScore, recommendAgent } from "../packages/engineering/identity/src/index.js";
|
|
30
|
+
import { detectAnomaly } from "../packages/engineering/monitoring/src/index.js";
|
|
31
|
+
import { EvaluationEngine } from "../packages/evals/src/index.js";
|
|
32
|
+
import { SqliteAgentProfileStore, SqliteMigrationRunner, SqliteObservationStore } from "../packages/adapter-sqlite/src/index.js";
|
|
33
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
|
|
34
|
+
function flag(args, name) {
|
|
35
|
+
const index = args.indexOf(name);
|
|
36
|
+
return index === -1 ? undefined : args[index + 1];
|
|
37
|
+
}
|
|
38
|
+
function list(value) {
|
|
39
|
+
return value === undefined ? [] : value.split(',').map((item) => item.trim()).filter((item) => item.length > 0);
|
|
40
|
+
}
|
|
41
|
+
function openDatabase() {
|
|
42
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
43
|
+
const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
44
|
+
new SqliteMigrationRunner(database).apply();
|
|
45
|
+
return database;
|
|
46
|
+
}
|
|
47
|
+
function cmdRegister(args) {
|
|
48
|
+
const [id] = args;
|
|
49
|
+
const role = flag(args, '--role');
|
|
50
|
+
if (!id || !role) {
|
|
51
|
+
console.error('Uso: forja agent:register <id> --role <role> [--provider <p>] [--model <m>] [--capabilities <c1,c2>] [--domains <d1,d2>] [--max-files <n>] [--max-cost-usd <n>]');
|
|
52
|
+
process.exitCode = 1;
|
|
53
|
+
return;
|
|
54
|
+
}
|
|
55
|
+
const database = openDatabase();
|
|
56
|
+
try {
|
|
57
|
+
const store = new SqliteAgentProfileStore(database);
|
|
58
|
+
const existing = store.get(id);
|
|
59
|
+
const now = new Date().toISOString();
|
|
60
|
+
const maxFiles = flag(args, '--max-files');
|
|
61
|
+
const maxCostUsd = flag(args, '--max-cost-usd');
|
|
62
|
+
const limits = maxFiles === undefined && maxCostUsd === undefined ? undefined : {
|
|
63
|
+
...(maxFiles === undefined ? {} : { maxFiles: Number(maxFiles) }),
|
|
64
|
+
...(maxCostUsd === undefined ? {} : { maxCostUsd: Number(maxCostUsd) }),
|
|
65
|
+
};
|
|
66
|
+
const profile = {
|
|
67
|
+
schemaVersion: '2.0', createdAt: existing?.createdAt ?? now, updatedAt: now, correlationId: `agent:${id}`,
|
|
68
|
+
id: id, role,
|
|
69
|
+
provider: flag(args, '--provider'), model: flag(args, '--model'),
|
|
70
|
+
capabilities: list(flag(args, '--capabilities')), architectureDomains: list(flag(args, '--domains')),
|
|
71
|
+
limits,
|
|
72
|
+
// trustLevel/autonomyLevel/lastScoredAt: nunca setados aqui (D2) — preserva o que já existia
|
|
73
|
+
// (registrar de novo não deve apagar a última pontuação).
|
|
74
|
+
trustLevel: existing?.trustLevel, autonomyLevel: existing?.autonomyLevel, lastScoredAt: existing?.lastScoredAt,
|
|
75
|
+
};
|
|
76
|
+
store.save(profile);
|
|
77
|
+
console.log(`${existing === undefined ? 'Registrado' : 'Atualizado'}: ${id} (role: ${role})`);
|
|
78
|
+
}
|
|
79
|
+
finally {
|
|
80
|
+
database.close();
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
function cmdList() {
|
|
84
|
+
const database = openDatabase();
|
|
85
|
+
try {
|
|
86
|
+
const profiles = new SqliteAgentProfileStore(database).list();
|
|
87
|
+
if (profiles.length === 0) {
|
|
88
|
+
console.log('Nenhum agente registrado — rode `forja agent:register <id> --role <role>` primeiro.');
|
|
89
|
+
return;
|
|
90
|
+
}
|
|
91
|
+
for (const profile of profiles) {
|
|
92
|
+
const trust = profile.trustLevel === undefined ? '(sem pontuação — rode agent:score)' : `trustLevel ${profile.trustLevel}/5 (${profile.autonomyLevel})`;
|
|
93
|
+
console.log(`${profile.id} role:${profile.role} ${trust}`);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
finally {
|
|
97
|
+
database.close();
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
function cmdShow([id]) {
|
|
101
|
+
if (!id) {
|
|
102
|
+
console.error('Uso: forja agent:show <id>');
|
|
103
|
+
process.exitCode = 1;
|
|
104
|
+
return;
|
|
105
|
+
}
|
|
106
|
+
const database = openDatabase();
|
|
107
|
+
try {
|
|
108
|
+
const profile = new SqliteAgentProfileStore(database).get(id);
|
|
109
|
+
if (profile === undefined) {
|
|
110
|
+
console.error(`Agente não encontrado: ${id}. Rode forja agent:register primeiro.`);
|
|
111
|
+
process.exitCode = 1;
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
console.log(JSON.stringify(profile, null, 2));
|
|
115
|
+
}
|
|
116
|
+
finally {
|
|
117
|
+
database.close();
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
async function cmdScore(args) {
|
|
121
|
+
const [id] = args;
|
|
122
|
+
const domain = flag(args, '--domain');
|
|
123
|
+
if (!id) {
|
|
124
|
+
console.error('Uso: forja agent:score <id> [--domain <d>]');
|
|
125
|
+
process.exitCode = 1;
|
|
126
|
+
return;
|
|
127
|
+
}
|
|
128
|
+
const database = openDatabase();
|
|
129
|
+
try {
|
|
130
|
+
const profileStore = new SqliteAgentProfileStore(database);
|
|
131
|
+
const profile = profileStore.get(id);
|
|
132
|
+
if (profile === undefined) {
|
|
133
|
+
console.error(`Agente não encontrado: ${id}. Rode forja agent:register primeiro.`);
|
|
134
|
+
process.exitCode = 1;
|
|
135
|
+
return;
|
|
136
|
+
}
|
|
137
|
+
const observations = new SqliteObservationStore(database).list().filter((observation) => observation.agentId === id && (domain === undefined || observation.capabilityId === domain));
|
|
138
|
+
const engine = new EvaluationEngine({ list: () => observations });
|
|
139
|
+
const report = await engine.evaluate({ scope: 'agent', scopeId: id, observations });
|
|
140
|
+
const score = computeReputationScore(report, { agentId: id, domain });
|
|
141
|
+
const now = new Date().toISOString();
|
|
142
|
+
profileStore.save({ ...profile, trustLevel: score.trustLevel, autonomyLevel: score.autonomyLevel, lastScoredAt: now, updatedAt: now });
|
|
143
|
+
console.log(`${id}${domain === undefined ? '' : ` (domain: ${domain})`} — trustLevel ${score.trustLevel}/5 → ${score.autonomyLevel}`);
|
|
144
|
+
console.log(`confidence ${(score.confidence * 100).toFixed(0)}% (amostra: ${score.sampleSize} observation(s))`);
|
|
145
|
+
for (const [name, value] of Object.entries(score.metrics))
|
|
146
|
+
console.log(` ${name}: ${value}`);
|
|
147
|
+
if (score.sampleSize === 0)
|
|
148
|
+
console.log('\nSem Observation ainda para este agente — score é o piso conservador (cold start, AC-3).');
|
|
149
|
+
}
|
|
150
|
+
finally {
|
|
151
|
+
database.close();
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
function cmdHistory([id]) {
|
|
155
|
+
if (!id) {
|
|
156
|
+
console.error('Uso: forja agent:history <id>');
|
|
157
|
+
process.exitCode = 1;
|
|
158
|
+
return;
|
|
159
|
+
}
|
|
160
|
+
const database = openDatabase();
|
|
161
|
+
try {
|
|
162
|
+
const observations = new SqliteObservationStore(database).list().filter((observation) => observation.agentId === id).sort((left, right) => right.createdAt.localeCompare(left.createdAt));
|
|
163
|
+
if (observations.length === 0) {
|
|
164
|
+
console.log(`Nenhuma Observation para ${id} ainda.`);
|
|
165
|
+
return;
|
|
166
|
+
}
|
|
167
|
+
for (const observation of observations)
|
|
168
|
+
console.log(`${observation.createdAt} ${observation.outcome.padEnd(12)} ${observation.capabilityId ?? '(sem capability)'} ${observation.id}`);
|
|
169
|
+
}
|
|
170
|
+
finally {
|
|
171
|
+
database.close();
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
function cmdRecommend(args) {
|
|
175
|
+
const role = flag(args, '--role');
|
|
176
|
+
const domain = flag(args, '--domain');
|
|
177
|
+
if (!role) {
|
|
178
|
+
console.error('Uso: forja agent:recommend --role <role> [--domain <d>]');
|
|
179
|
+
process.exitCode = 1;
|
|
180
|
+
return;
|
|
181
|
+
}
|
|
182
|
+
const database = openDatabase();
|
|
183
|
+
try {
|
|
184
|
+
const profiles = new SqliteAgentProfileStore(database).list();
|
|
185
|
+
if (profiles.length === 0) {
|
|
186
|
+
console.log('Nenhum agente registrado — rode `forja agent:register <id> --role <role>` primeiro.');
|
|
187
|
+
return;
|
|
188
|
+
}
|
|
189
|
+
const ranking = recommendAgent(profiles, { role, domain });
|
|
190
|
+
for (const item of ranking)
|
|
191
|
+
console.log(`${item.agentId} score:${item.score} ${item.reasons.join(', ')}`);
|
|
192
|
+
console.log('\n(informação, não atribuição — a escolha final continua manual/do orquestrador, SPEC-037 AC-4)');
|
|
193
|
+
}
|
|
194
|
+
finally {
|
|
195
|
+
database.close();
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
async function cmdMonitor(args) {
|
|
199
|
+
const [id] = args;
|
|
200
|
+
const windowHours = Number(flag(args, '--window-hours') ?? '24');
|
|
201
|
+
if (!id) {
|
|
202
|
+
console.error('Uso: forja agent:monitor <id> [--window-hours <n>]');
|
|
203
|
+
process.exitCode = 1;
|
|
204
|
+
return;
|
|
205
|
+
}
|
|
206
|
+
if (!Number.isFinite(windowHours) || windowHours <= 0) {
|
|
207
|
+
console.error('--window-hours deve ser um número positivo');
|
|
208
|
+
process.exitCode = 1;
|
|
209
|
+
return;
|
|
210
|
+
}
|
|
211
|
+
const database = openDatabase();
|
|
212
|
+
try {
|
|
213
|
+
const cutoff = new Date(Date.now() - windowHours * 60 * 60 * 1000).toISOString();
|
|
214
|
+
const allObservations = new SqliteObservationStore(database).list().filter((observation) => observation.agentId === id);
|
|
215
|
+
const baselineObservations = allObservations.filter((observation) => observation.createdAt < cutoff);
|
|
216
|
+
const recentObservations = allObservations.filter((observation) => observation.createdAt >= cutoff);
|
|
217
|
+
const engine = new EvaluationEngine({ list: () => [] });
|
|
218
|
+
const baseline = await engine.evaluate({ scope: 'agent', scopeId: id, observations: baselineObservations });
|
|
219
|
+
const recent = await engine.evaluate({ scope: 'agent', scopeId: id, observations: recentObservations });
|
|
220
|
+
const assessment = detectAnomaly(id, baseline, recent);
|
|
221
|
+
console.log(`${id} — janela de ${windowHours}h: score de anomalia ${assessment.score}/100 (confidence ${(assessment.confidence * 100).toFixed(0)}%)`);
|
|
222
|
+
console.log(`linha de base: ${baselineObservations.length} observation(s) | recente: ${recentObservations.length} observation(s)`);
|
|
223
|
+
for (const signal of assessment.signals)
|
|
224
|
+
console.log(` ${signal.metric}: ${signal.baseline.toFixed(2)} → ${signal.recent.toFixed(2)} (Δ${signal.delta >= 0 ? '+' : ''}${signal.delta.toFixed(2)})`);
|
|
225
|
+
console.log('\n(informação, não decisão automática — nenhum bloqueio ou aprovação foi disparado, SPEC-040 AC-5)');
|
|
226
|
+
}
|
|
227
|
+
finally {
|
|
228
|
+
database.close();
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
async function main() {
|
|
232
|
+
const [subcommand, ...rest] = process.argv.slice(2);
|
|
233
|
+
switch (subcommand) {
|
|
234
|
+
case 'register': return cmdRegister(rest);
|
|
235
|
+
case 'list': return cmdList();
|
|
236
|
+
case 'show': return cmdShow(rest);
|
|
237
|
+
case 'score': return cmdScore(rest);
|
|
238
|
+
case 'history': return cmdHistory(rest);
|
|
239
|
+
case 'recommend': return cmdRecommend(rest);
|
|
240
|
+
case 'monitor': return cmdMonitor(rest);
|
|
241
|
+
default:
|
|
242
|
+
console.error('Uso: forja agent:<register|list|show|score|history|recommend|monitor> [args]');
|
|
243
|
+
process.exitCode = 1;
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
main().catch((error) => {
|
|
247
|
+
console.error(`\nagent: falhou: ${error instanceof Error ? error.message : String(error)}`);
|
|
248
|
+
process.exitCode = 1;
|
|
249
|
+
});
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* architecture:compile / :check / :status / :explain / :approve (SPEC-033)
|
|
4
|
+
*
|
|
5
|
+
* forja architecture:compile ADRs (## Constraints) → .context/architecture/constitution.json
|
|
6
|
+
* forja architecture:check constitution.json vs. Engineering Graph real
|
|
7
|
+
* forja architecture:status resumo: N regras ativas, N propostas, última compilação
|
|
8
|
+
* forja architecture:explain <id> ADR de origem, texto original, severidade
|
|
9
|
+
* forja architecture:approve <id> promove uma regra proposed a active (via ApprovalLedger)
|
|
10
|
+
*
|
|
11
|
+
* `packages/engineering/architecture` faz o parsing/checagem pura; este script é o adapter que lê
|
|
12
|
+
* `memory/90-decisions/*.md`, escreve `.context/architecture/constitution.json` (versionado em
|
|
13
|
+
* git — revisável em PR, não uma linha de SQLite) e resolve as arestas DEPENDS_ON reais via o
|
|
14
|
+
* mesmo GraphIndexer.sync que `adr:*`/`drift:check` já usam.
|
|
15
|
+
*/
|
|
16
|
+
export {};
|