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
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* simulate (SPEC-038) — Predictive Change Simulation.
|
|
4
|
+
*
|
|
5
|
+
* forja simulate <ref> [--command "npm test"] [--json]
|
|
6
|
+
*
|
|
7
|
+
* Composição pura de engines já existentes (gap analysis §3 do doc de arquitetura): `SandboxEngine`
|
|
8
|
+
* + `GitWorktreeBackend` (isolamento real, packages/sandbox+adapter-git) para checar out `<ref>`
|
|
9
|
+
* num worktree isolado e rodar o comando de teste; `checkConstitution` (SPEC-033) + `assessRisk`
|
|
10
|
+
* (SPEC-034, via `lib/core/risk-collect.ts`) para avaliar o estado resultante. Nada disso é lógica
|
|
11
|
+
* nova — só orquestração.
|
|
12
|
+
*
|
|
13
|
+
* Ciclo do sandbox (D1 do plan): create→prepare→execute→reject→destroy. `promote()` **nunca** é
|
|
14
|
+
* chamado neste arquivo — a única escrita na árvore real é a remoção do próprio worktree (AC-3).
|
|
15
|
+
*
|
|
16
|
+
* Grafo/SQLite da simulação são temporários (`mkdtemp`, D3 do plan) — nunca `getWorkspaceDbPath()`,
|
|
17
|
+
* pra não contaminar o Engineering Graph persistente com o estado de um ref que pode nunca ser
|
|
18
|
+
* integrado (AC-2).
|
|
19
|
+
*/
|
|
20
|
+
import fs from 'node:fs';
|
|
21
|
+
import os from 'node:os';
|
|
22
|
+
import path from 'node:path';
|
|
23
|
+
import { randomUUID } from 'node:crypto';
|
|
24
|
+
import Database from 'better-sqlite3';
|
|
25
|
+
import { checkConstitution } from "../packages/engineering/architecture/src/index.js";
|
|
26
|
+
import { assessRisk } from "../packages/engineering/risk/src/index.js";
|
|
27
|
+
import { SandboxEngine, InMemorySandboxStore } from "../packages/sandbox/src/index.js";
|
|
28
|
+
import { GitWorktreeBackend, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
|
|
29
|
+
import { GitGraphDocumentSource } from "../packages/adapter-git/src/index.js";
|
|
30
|
+
import { GraphIndexer, GraphLoop } from "../packages/graph/src/index.js";
|
|
31
|
+
import { SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
|
|
32
|
+
import { buildRiskInput, changedFiles } from "../lib/core/risk-collect.js";
|
|
33
|
+
const CONSTITUTION_PATH = '.context/architecture/constitution.json';
|
|
34
|
+
function repoRoot() {
|
|
35
|
+
return process.env.FORJA_GRAPH_ROOT ?? process.cwd();
|
|
36
|
+
}
|
|
37
|
+
/** Roda `buildRiskInput`/`checkConstitution` contra `worktreeRoot`, isolado do workspace real (D3). */
|
|
38
|
+
async function assessWorktree(worktreeRoot, paths) {
|
|
39
|
+
const tempBase = fs.mkdtempSync(path.join(os.tmpdir(), 'forja-simulate-db-'));
|
|
40
|
+
const database = new Database(path.join(tempBase, 'simulate.db'));
|
|
41
|
+
new SqliteMigrationRunner(database).apply();
|
|
42
|
+
const previousGraphRoot = process.env.FORJA_GRAPH_ROOT;
|
|
43
|
+
try {
|
|
44
|
+
process.env.FORJA_GRAPH_ROOT = worktreeRoot;
|
|
45
|
+
const store = new SqliteGraphStore(database);
|
|
46
|
+
const graph = new GraphLoop(store);
|
|
47
|
+
await new GraphIndexer(graph).sync(new GitGraphDocumentSource(worktreeRoot, new SpawnCommandRunner()));
|
|
48
|
+
let architectureCheck;
|
|
49
|
+
const constitutionFile = path.join(worktreeRoot, CONSTITUTION_PATH);
|
|
50
|
+
if (fs.existsSync(constitutionFile)) {
|
|
51
|
+
const { rules } = JSON.parse(fs.readFileSync(constitutionFile, 'utf8'));
|
|
52
|
+
const edges = store.listEdges().flatMap((edge) => {
|
|
53
|
+
if (edge.type !== 'DEPENDS_ON')
|
|
54
|
+
return [];
|
|
55
|
+
const fromNode = store.getNode(edge.from);
|
|
56
|
+
const toNode = store.getNode(edge.to);
|
|
57
|
+
return fromNode === undefined || toNode === undefined ? [] : [{ fromPath: fromNode.label, targetLabel: toNode.label }];
|
|
58
|
+
});
|
|
59
|
+
architectureCheck = checkConstitution(rules, edges);
|
|
60
|
+
}
|
|
61
|
+
else {
|
|
62
|
+
architectureCheck = { note: 'Constitution não compilada no ref simulado.' };
|
|
63
|
+
}
|
|
64
|
+
const riskInput = await buildRiskInput(paths, database);
|
|
65
|
+
const risk = assessRisk(riskInput, { id: randomUUID(), changeId: 'simulation', now: new Date().toISOString() });
|
|
66
|
+
return { architectureCheck, risk };
|
|
67
|
+
}
|
|
68
|
+
finally {
|
|
69
|
+
process.env.FORJA_GRAPH_ROOT = previousGraphRoot;
|
|
70
|
+
database.close();
|
|
71
|
+
fs.rmSync(tempBase, { recursive: true, force: true });
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
function recommendationFor(testPassed, architectureCheck, risk) {
|
|
75
|
+
if (!testPassed)
|
|
76
|
+
return 'discard';
|
|
77
|
+
const hasViolation = 'violations' in architectureCheck && architectureCheck.violations.length > 0;
|
|
78
|
+
if (hasViolation)
|
|
79
|
+
return 'review';
|
|
80
|
+
if (risk.autonomyBand === 'supervised' || risk.autonomyBand === 'human_in_the_loop')
|
|
81
|
+
return 'review';
|
|
82
|
+
return 'promote';
|
|
83
|
+
}
|
|
84
|
+
async function cmdSimulate(args) {
|
|
85
|
+
const json = args.includes('--json');
|
|
86
|
+
const commandIndex = args.indexOf('--command');
|
|
87
|
+
const testCommand = commandIndex === -1 ? 'npm test' : args[commandIndex + 1];
|
|
88
|
+
const ref = args.filter((arg, index) => arg !== '--json' && (commandIndex === -1 || (index !== commandIndex && index !== commandIndex + 1)))[0];
|
|
89
|
+
if (!ref) {
|
|
90
|
+
console.error('Uso: forja simulate <ref> [--command "npm test"] [--json]');
|
|
91
|
+
process.exitCode = 1;
|
|
92
|
+
return;
|
|
93
|
+
}
|
|
94
|
+
const paths = changedFiles(ref);
|
|
95
|
+
const runner = new SpawnCommandRunner();
|
|
96
|
+
const patchApplier = { apply: () => { throw new Error('simulate nunca promove — patchApplier.apply não deveria ser chamado'); }, revert: () => { } };
|
|
97
|
+
const sandbox = new SandboxEngine(new InMemorySandboxStore(), new GitWorktreeBackend(runner, { repositoryRoot: repoRoot(), sourceRef: ref, patchApplier }));
|
|
98
|
+
const tempBase = fs.mkdtempSync(path.join(os.tmpdir(), 'forja-simulate-'));
|
|
99
|
+
const worktreeRoot = path.join(tempBase, 'worktree');
|
|
100
|
+
const runId = randomUUID();
|
|
101
|
+
const session = await sandbox.create({ runId, root: worktreeRoot });
|
|
102
|
+
try {
|
|
103
|
+
await sandbox.prepare(session.id);
|
|
104
|
+
const [executable, ...cmdArgs] = testCommand.split(' ');
|
|
105
|
+
const execution = await sandbox.execute(session.id, { executable, args: cmdArgs, cwd: worktreeRoot });
|
|
106
|
+
const testResult = { exitCode: execution.exitCode, durationMs: execution.durationMs, passed: execution.exitCode === 0 };
|
|
107
|
+
const { architectureCheck, risk } = await assessWorktree(worktreeRoot, paths);
|
|
108
|
+
const recommendation = recommendationFor(testResult.passed, architectureCheck, risk);
|
|
109
|
+
const report = { ref, changedFiles: paths, testCommand, testResult, architectureCheck, risk, recommendation };
|
|
110
|
+
if (json)
|
|
111
|
+
console.log(JSON.stringify(report, null, 2));
|
|
112
|
+
else
|
|
113
|
+
printText(report);
|
|
114
|
+
}
|
|
115
|
+
finally {
|
|
116
|
+
// best-effort — reject() pode já ter deixado a sessão num estado terminal se execute() lançou,
|
|
117
|
+
// e destroy() pode achar o worktree já removido pelo reject(); nenhum dos dois é fatal aqui. O
|
|
118
|
+
// erro é logado (não silenciado) porque uma falha real de cleanup deixaria um worktree/branch
|
|
119
|
+
// órfão na árvore real — algo que vale saber, mesmo sem abortar a simulação por causa disso.
|
|
120
|
+
await sandbox.reject(session.id).catch((error) => { console.error(`simulate: aviso — reject do sandbox falhou: ${error instanceof Error ? error.message : String(error)}`); });
|
|
121
|
+
await sandbox.destroy(session.id).catch((error) => { console.error(`simulate: aviso — destroy do sandbox falhou: ${error instanceof Error ? error.message : String(error)}`); });
|
|
122
|
+
fs.rmSync(tempBase, { recursive: true, force: true });
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
function printText(report) {
|
|
126
|
+
console.log(`simulate ${report.ref}`);
|
|
127
|
+
console.log(`${report.changedFiles.length} arquivo(s) alterado(s)`);
|
|
128
|
+
console.log('');
|
|
129
|
+
console.log(`teste (${report.testCommand}): ${report.testResult.passed ? 'PASSOU' : 'FALHOU'} (exit ${report.testResult.exitCode}, ${report.testResult.durationMs}ms)`);
|
|
130
|
+
console.log('');
|
|
131
|
+
console.log('ARCHITECTURE CHECK');
|
|
132
|
+
if ('note' in report.architectureCheck)
|
|
133
|
+
console.log(` ${report.architectureCheck.note}`);
|
|
134
|
+
else {
|
|
135
|
+
console.log(` ${report.architectureCheck.compliant} regra(s) active em conformidade, ${report.architectureCheck.violations.length} violação(ões)`);
|
|
136
|
+
for (const violation of report.architectureCheck.violations)
|
|
137
|
+
console.log(` ${violation.severity.toUpperCase()} ${violation.file} viola ${violation.ruleId}`);
|
|
138
|
+
}
|
|
139
|
+
console.log('');
|
|
140
|
+
console.log(`RISCO: score ${report.risk.score}/100 → ${report.risk.autonomyBand} (confidence ${(report.risk.confidence * 100).toFixed(0)}%)`);
|
|
141
|
+
console.log('');
|
|
142
|
+
console.log(`RECOMENDAÇÃO: ${report.recommendation.toUpperCase()} — informação, não decisão automática (nenhuma mudança foi aplicada à árvore real)`);
|
|
143
|
+
}
|
|
144
|
+
async function main() {
|
|
145
|
+
await cmdSimulate(process.argv.slice(2));
|
|
146
|
+
}
|
|
147
|
+
main().catch((error) => {
|
|
148
|
+
console.error(`\nsimulate: falhou: ${error instanceof Error ? error.message : String(error)}`);
|
|
149
|
+
process.exitCode = 1;
|
|
150
|
+
});
|
|
@@ -58,24 +58,24 @@ function startSprint() {
|
|
|
58
58
|
}
|
|
59
59
|
if (toSprint.length === 0)
|
|
60
60
|
return console.log('Nada para mover para a sprint.');
|
|
61
|
-
const sprintContent = `# Sprint Atual
|
|
62
|
-
|
|
63
|
-
## Projeto
|
|
64
|
-
${projectLabel}
|
|
65
|
-
|
|
66
|
-
## Objetivos
|
|
67
|
-
- Completar itens P0/P1 do backlog com handoffs GSD registrados.
|
|
68
|
-
|
|
69
|
-
## Itens da Sprint
|
|
70
|
-
${toSprint.join('\n')}
|
|
71
|
-
|
|
72
|
-
## Ritual CLI
|
|
73
|
-
- Planejar: npm run gsd:plan -- <slug> "<objetivo>"
|
|
74
|
-
- Handoff spec: npm run gsd:handoff -- spec <slug>
|
|
75
|
-
- Handoff plan: npm run gsd:handoff -- plan <slug>
|
|
76
|
-
- Handoff implement: npm run gsd:handoff -- implement <slug>
|
|
77
|
-
- Validar: npm run gsd:check -- <slug>
|
|
78
|
-
- Governanca: npm run project:check
|
|
61
|
+
const sprintContent = `# Sprint Atual
|
|
62
|
+
|
|
63
|
+
## Projeto
|
|
64
|
+
${projectLabel}
|
|
65
|
+
|
|
66
|
+
## Objetivos
|
|
67
|
+
- Completar itens P0/P1 do backlog com handoffs GSD registrados.
|
|
68
|
+
|
|
69
|
+
## Itens da Sprint
|
|
70
|
+
${toSprint.join('\n')}
|
|
71
|
+
|
|
72
|
+
## Ritual CLI
|
|
73
|
+
- Planejar: npm run gsd:plan -- <slug> "<objetivo>"
|
|
74
|
+
- Handoff spec: npm run gsd:handoff -- spec <slug>
|
|
75
|
+
- Handoff plan: npm run gsd:handoff -- plan <slug>
|
|
76
|
+
- Handoff implement: npm run gsd:handoff -- implement <slug>
|
|
77
|
+
- Validar: npm run gsd:check -- <slug>
|
|
78
|
+
- Governanca: npm run project:check
|
|
79
79
|
`;
|
|
80
80
|
fs.writeFileSync(sprintFile, sprintContent, 'utf8');
|
|
81
81
|
if (hasChecklistPriority)
|
|
@@ -142,29 +142,29 @@ function completeSprint() {
|
|
|
142
142
|
const now = new Date();
|
|
143
143
|
const stamp = now.toISOString().replace(/[:]/g, '-');
|
|
144
144
|
const reportFile = path.join(runsDir, `sprint-close-${stamp}.md`);
|
|
145
|
-
const report = `# Fechamento de Sprint
|
|
146
|
-
|
|
147
|
-
## Projeto
|
|
148
|
-
${projectLabel}
|
|
149
|
-
|
|
150
|
-
## Data
|
|
151
|
-
${now.toISOString()}
|
|
152
|
-
|
|
153
|
-
## Entregas concluídas (${done.length})
|
|
154
|
-
${done.length ? done.map((item) => `- ${item}`).join('\n') : '- Nenhuma'}
|
|
155
|
-
|
|
156
|
-
## Pendências realocadas para backlog (${pending.length})
|
|
157
|
-
${pending.length ? pending.map((item) => `- ${item}`).join('\n') : '- Nenhuma'}
|
|
145
|
+
const report = `# Fechamento de Sprint
|
|
146
|
+
|
|
147
|
+
## Projeto
|
|
148
|
+
${projectLabel}
|
|
149
|
+
|
|
150
|
+
## Data
|
|
151
|
+
${now.toISOString()}
|
|
152
|
+
|
|
153
|
+
## Entregas concluídas (${done.length})
|
|
154
|
+
${done.length ? done.map((item) => `- ${item}`).join('\n') : '- Nenhuma'}
|
|
155
|
+
|
|
156
|
+
## Pendências realocadas para backlog (${pending.length})
|
|
157
|
+
${pending.length ? pending.map((item) => `- ${item}`).join('\n') : '- Nenhuma'}
|
|
158
158
|
`;
|
|
159
159
|
fs.writeFileSync(reportFile, report, 'utf8');
|
|
160
|
-
const resetSprint = `# Sprint Atual
|
|
161
|
-
|
|
162
|
-
## Status
|
|
163
|
-
- Encerrada em ${now.toISOString()}
|
|
164
|
-
- Nova sprint ainda não iniciada.
|
|
165
|
-
|
|
166
|
-
## Próximo passo
|
|
167
|
-
- Execute: node scripts/sprint-manager.js start ${projectDir === root ? '' : project}
|
|
160
|
+
const resetSprint = `# Sprint Atual
|
|
161
|
+
|
|
162
|
+
## Status
|
|
163
|
+
- Encerrada em ${now.toISOString()}
|
|
164
|
+
- Nova sprint ainda não iniciada.
|
|
165
|
+
|
|
166
|
+
## Próximo passo
|
|
167
|
+
- Execute: node scripts/sprint-manager.js start ${projectDir === root ? '' : project}
|
|
168
168
|
`;
|
|
169
169
|
fs.writeFileSync(sprintFile, resetSprint, 'utf8');
|
|
170
170
|
console.log(`Sprint encerrada para ${projectLabel}.`);
|
|
@@ -18,32 +18,32 @@ const onlyProject = projectArgIndex >= 0 ? args[projectArgIndex + 1] : null;
|
|
|
18
18
|
const syncGlobal = !onlyProject || args.includes('--global');
|
|
19
19
|
const syncProjects = !args.includes('--global') || Boolean(onlyProject);
|
|
20
20
|
// Schema simplificado para a Memória Universal
|
|
21
|
-
const schema = `
|
|
22
|
-
CREATE TABLE IF NOT EXISTS projects (
|
|
23
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
24
|
-
name TEXT NOT NULL UNIQUE,
|
|
25
|
-
path TEXT NOT NULL,
|
|
26
|
-
created_at TEXT NOT NULL
|
|
27
|
-
);
|
|
28
|
-
|
|
29
|
-
CREATE TABLE IF NOT EXISTS memory_nodes (
|
|
30
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
31
|
-
project_id INTEGER, -- NULL se for global
|
|
32
|
-
path TEXT NOT NULL UNIQUE,
|
|
33
|
-
kind TEXT NOT NULL, -- 'global', 'project', 'domain', 'adr', 'summary'
|
|
34
|
-
title TEXT,
|
|
35
|
-
content TEXT NOT NULL,
|
|
36
|
-
content_hash TEXT NOT NULL,
|
|
37
|
-
updated_at TEXT NOT NULL,
|
|
38
|
-
FOREIGN KEY(project_id) REFERENCES projects(id) ON DELETE CASCADE
|
|
39
|
-
);
|
|
40
|
-
|
|
41
|
-
CREATE VIRTUAL TABLE IF NOT EXISTS search_idx USING fts5(
|
|
42
|
-
node_id UNINDEXED,
|
|
43
|
-
title,
|
|
44
|
-
content,
|
|
45
|
-
tokenize='porter'
|
|
46
|
-
);
|
|
21
|
+
const schema = `
|
|
22
|
+
CREATE TABLE IF NOT EXISTS projects (
|
|
23
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
24
|
+
name TEXT NOT NULL UNIQUE,
|
|
25
|
+
path TEXT NOT NULL,
|
|
26
|
+
created_at TEXT NOT NULL
|
|
27
|
+
);
|
|
28
|
+
|
|
29
|
+
CREATE TABLE IF NOT EXISTS memory_nodes (
|
|
30
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
31
|
+
project_id INTEGER, -- NULL se for global
|
|
32
|
+
path TEXT NOT NULL UNIQUE,
|
|
33
|
+
kind TEXT NOT NULL, -- 'global', 'project', 'domain', 'adr', 'summary'
|
|
34
|
+
title TEXT,
|
|
35
|
+
content TEXT NOT NULL,
|
|
36
|
+
content_hash TEXT NOT NULL,
|
|
37
|
+
updated_at TEXT NOT NULL,
|
|
38
|
+
FOREIGN KEY(project_id) REFERENCES projects(id) ON DELETE CASCADE
|
|
39
|
+
);
|
|
40
|
+
|
|
41
|
+
CREATE VIRTUAL TABLE IF NOT EXISTS search_idx USING fts5(
|
|
42
|
+
node_id UNINDEXED,
|
|
43
|
+
title,
|
|
44
|
+
content,
|
|
45
|
+
tokenize='porter'
|
|
46
|
+
);
|
|
47
47
|
`;
|
|
48
48
|
function log(msg, level = 'info') {
|
|
49
49
|
const prefix = { info: 'INFO', success: 'OK', warn: 'WARN', error: 'ERROR' }[level] || 'INFO';
|
|
@@ -82,25 +82,25 @@ const getProjectId = db.prepare('SELECT id FROM projects WHERE name = ?');
|
|
|
82
82
|
const deleteFts = db.prepare('DELETE FROM search_idx WHERE node_id = ?');
|
|
83
83
|
const insertFts = db.prepare('INSERT INTO search_idx (node_id, title, content) VALUES (?, ?, ?)');
|
|
84
84
|
const purgeFtsOrphans = db.prepare('DELETE FROM search_idx WHERE node_id NOT IN (SELECT id FROM memory_nodes)');
|
|
85
|
-
const upsertSpecSummary = db.prepare(`
|
|
86
|
-
INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
|
|
87
|
-
VALUES (?, ?, ?, ?, ?, ?)
|
|
88
|
-
ON CONFLICT(slug) DO UPDATE SET
|
|
89
|
-
status=excluded.status,
|
|
90
|
-
title=excluded.title,
|
|
91
|
-
summary=excluded.summary,
|
|
92
|
-
source_path=excluded.source_path,
|
|
93
|
-
updated_at=excluded.updated_at
|
|
85
|
+
const upsertSpecSummary = db.prepare(`
|
|
86
|
+
INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
|
|
87
|
+
VALUES (?, ?, ?, ?, ?, ?)
|
|
88
|
+
ON CONFLICT(slug) DO UPDATE SET
|
|
89
|
+
status=excluded.status,
|
|
90
|
+
title=excluded.title,
|
|
91
|
+
summary=excluded.summary,
|
|
92
|
+
source_path=excluded.source_path,
|
|
93
|
+
updated_at=excluded.updated_at
|
|
94
94
|
`);
|
|
95
|
-
const upsertAsset = db.prepare(`
|
|
96
|
-
INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
|
|
97
|
-
VALUES (?, ?, ?, ?, ?, ?)
|
|
98
|
-
ON CONFLICT(path) DO UPDATE SET
|
|
99
|
-
type=excluded.type,
|
|
100
|
-
name=excluded.name,
|
|
101
|
-
summary=excluded.summary,
|
|
102
|
-
tags=excluded.tags,
|
|
103
|
-
updated_at=excluded.updated_at
|
|
95
|
+
const upsertAsset = db.prepare(`
|
|
96
|
+
INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
|
|
97
|
+
VALUES (?, ?, ?, ?, ?, ?)
|
|
98
|
+
ON CONFLICT(path) DO UPDATE SET
|
|
99
|
+
type=excluded.type,
|
|
100
|
+
name=excluded.name,
|
|
101
|
+
summary=excluded.summary,
|
|
102
|
+
tags=excluded.tags,
|
|
103
|
+
updated_at=excluded.updated_at
|
|
104
104
|
`);
|
|
105
105
|
const now = new Date().toISOString();
|
|
106
106
|
function getKind(relPath) {
|
|
@@ -1,35 +1,35 @@
|
|
|
1
|
-
# CLI como adaptador do Capability Registry
|
|
2
|
-
|
|
3
|
-
Sprint 1 unifica os três comandos de prova abaixo com o registry executável. O comando legado
|
|
4
|
-
continua disponível como alias; a lógica é executada por um handler injetado no adaptador, e não
|
|
5
|
-
por uma implementação paralela no CLI.
|
|
6
|
-
|
|
7
|
-
| Comando legado | Capability | Input | Observação |
|
|
8
|
-
| --- | --- | --- | --- |
|
|
9
|
-
| `tools:doctor` | `system.doctor` | `{}` | diagnóstico local determinístico |
|
|
10
|
-
| `code:impact <symbol> [depth]` | `code.impact` | `{ symbol, depth? }` | depth entre 1 e 10 |
|
|
11
|
-
| `context:budget <target> [limitTokens]` | `context.budget` | `{ target, limitTokens? }` | limite positivo |
|
|
12
|
-
| `spec:check [feature]` | `spec.validate` | `{ feature? }` | valida uma spec ou todas |
|
|
13
|
-
| `sprint:status [project]` | `sprint.status` | `{ project? }` | consulta a sprint atual |
|
|
14
|
-
| `gsd:handoff <phase> <slug> [context]` | `handoff.create` | `{ phase, slug, context? }` | grava handoff local governado |
|
|
15
|
-
|
|
16
|
-
## Descoberta e execução
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
forja capabilities:list --json
|
|
20
|
-
forja capabilities:describe code.impact --json
|
|
21
|
-
forja capability:execute code.impact --input '{"symbol":"CapabilityRegistry","depth":2}' --json
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
Os três comandos legados também aceitam `--json` e retornam o mesmo `ExecutionResult` versionado:
|
|
25
|
-
|
|
26
|
-
```bash
|
|
27
|
-
forja tools:doctor --json
|
|
28
|
-
forja code:impact CapabilityRegistry 2 --json
|
|
29
|
-
forja context:budget docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md 10000 --json
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
O envelope inclui `runId`, `correlationId`, `status`, `output`, `evidence` e erro normalizado
|
|
33
|
-
quando aplicável. Entrada inválida é rejeitada antes do handler; política é avaliada pelo
|
|
34
|
-
`CapabilityRegistry` antes da execução. Comandos ainda não migrados permanecem no dispatch
|
|
35
|
-
legado durante a migração progressiva.
|
|
1
|
+
# CLI como adaptador do Capability Registry
|
|
2
|
+
|
|
3
|
+
Sprint 1 unifica os três comandos de prova abaixo com o registry executável. O comando legado
|
|
4
|
+
continua disponível como alias; a lógica é executada por um handler injetado no adaptador, e não
|
|
5
|
+
por uma implementação paralela no CLI.
|
|
6
|
+
|
|
7
|
+
| Comando legado | Capability | Input | Observação |
|
|
8
|
+
| --- | --- | --- | --- |
|
|
9
|
+
| `tools:doctor` | `system.doctor` | `{}` | diagnóstico local determinístico |
|
|
10
|
+
| `code:impact <symbol> [depth]` | `code.impact` | `{ symbol, depth? }` | depth entre 1 e 10 |
|
|
11
|
+
| `context:budget <target> [limitTokens]` | `context.budget` | `{ target, limitTokens? }` | limite positivo |
|
|
12
|
+
| `spec:check [feature]` | `spec.validate` | `{ feature? }` | valida uma spec ou todas |
|
|
13
|
+
| `sprint:status [project]` | `sprint.status` | `{ project? }` | consulta a sprint atual |
|
|
14
|
+
| `gsd:handoff <phase> <slug> [context]` | `handoff.create` | `{ phase, slug, context? }` | grava handoff local governado |
|
|
15
|
+
|
|
16
|
+
## Descoberta e execução
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
forja capabilities:list --json
|
|
20
|
+
forja capabilities:describe code.impact --json
|
|
21
|
+
forja capability:execute code.impact --input '{"symbol":"CapabilityRegistry","depth":2}' --json
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Os três comandos legados também aceitam `--json` e retornam o mesmo `ExecutionResult` versionado:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
forja tools:doctor --json
|
|
28
|
+
forja code:impact CapabilityRegistry 2 --json
|
|
29
|
+
forja context:budget docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md 10000 --json
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
O envelope inclui `runId`, `correlationId`, `status`, `output`, `evidence` e erro normalizado
|
|
33
|
+
quando aplicável. Entrada inválida é rejeitada antes do handler; política é avaliada pelo
|
|
34
|
+
`CapabilityRegistry` antes da execução. Comandos ainda não migrados permanecem no dispatch
|
|
35
|
+
legado durante a migração progressiva.
|
|
@@ -1,40 +1,40 @@
|
|
|
1
|
-
# ForjaJS 2.x — Implementation audit
|
|
2
|
-
|
|
3
|
-
Auditoria realizada em 2026-08-02 sobre o código executável e os testes do repositório. “Existe” só foi marcado quando há implementação; “produção” só quando a composição oficial ou o caminho CLI é exercitado.
|
|
4
|
-
|
|
5
|
-
| Componente | Existe | Integrado | Persistente | Testado | Produção |
|
|
6
|
-
| --- | ---: | ---: | ---: | ---: | ---: |
|
|
7
|
-
| Contratos versionados | sim | sim | n/a | sim | sim |
|
|
8
|
-
| Capability Registry | sim | sim | n/a | sim | sim |
|
|
9
|
-
| CLI adapter | sim | sim | n/a | sim | sim |
|
|
10
|
-
| Runtime | sim | sim | sim | sim | sim |
|
|
11
|
-
| Policy/approvals | sim | sim | sim | sim | sim |
|
|
12
|
-
| Sprint/Task/Handoff | sim | sim | sim | sim | sim |
|
|
13
|
-
| Context Engine | sim | sim | sim | sim | sim |
|
|
14
|
-
| GraphLoop | sim | sim | sim | sim | sim |
|
|
15
|
-
| Sandbox Git worktree | sim | sim | sessão | sim | sim |
|
|
16
|
-
| Sandbox rollback | sim | sim | sessão | sim | sim |
|
|
17
|
-
| Validator | sim | sim | n/a | sim | sim |
|
|
18
|
-
| Event Bus/Scheduler | sim | sim | sim | sim | sim |
|
|
19
|
-
| MCP stdio | sim | sim | n/a | sim | sim |
|
|
20
|
-
| SDK | sim | sim | n/a | sim | sim |
|
|
21
|
-
| Nest adapter/control plane | sim | sim | sim | sim | sim |
|
|
22
|
-
| Dashboard | sim | sim | via API | sim | parcial |
|
|
23
|
-
| Observability/Evals | sim | sim | sim | sim | sim |
|
|
24
|
-
| Plugin SDK | sim | sim | n/a | sim | sim |
|
|
25
|
-
| GitHub/Docker official boundaries | sim | não há handler externo | n/a | sim | boundary |
|
|
26
|
-
|
|
27
|
-
## Evidências executadas
|
|
28
|
-
|
|
29
|
-
- `npm run demo:autonomy`: fixture externa, worktree Git, alteração real, `npm test`, diff, promoção, SQLite, GraphLoop e handoff.
|
|
30
|
-
- `test/mcp-stdio.test.js`: transporte JSON-RPC por processo filho, stdout limpo, tools/resources e shutdown.
|
|
31
|
-
- `test/server-persistence.test.js`: composição oficial SQLite, encerramento/recriação e recuperação de runtime, approval, contexto, grafo, evento e observação.
|
|
32
|
-
- `test/sandbox.test.js` e `test/adapter-git.test.js`: promoção e rollback explícitos.
|
|
33
|
-
- `test/context-benchmark.test.js`: benchmark determinístico; execução observada nesta árvore: baseline 214.549 tokens estimados, contexto selecionado 9.175, redução 95,72%, cache hit 1 e cobertura de evidência 1.
|
|
34
|
-
- `npm test -- --test-concurrency=1`: 300/300 aprovados.
|
|
35
|
-
- `npm run build`: aprovado.
|
|
36
|
-
- `git diff --check`: aprovado.
|
|
37
|
-
|
|
38
|
-
## Limites honestos
|
|
39
|
-
|
|
40
|
-
Os plugins oficiais são boundaries permissionados, não clientes GitHub/Docker completos. O dashboard é superfície de supervisão e não foi usado como dependência do fluxo CLI-first. A estimativa de tokens é um proxy determinístico bytes/4, não telemetria de um provedor de modelo. Essas limitações impedem afirmar que todos os cenários externos são 10/10; o fluxo local-first comprovado está fechado.
|
|
1
|
+
# ForjaJS 2.x — Implementation audit
|
|
2
|
+
|
|
3
|
+
Auditoria realizada em 2026-08-02 sobre o código executável e os testes do repositório. “Existe” só foi marcado quando há implementação; “produção” só quando a composição oficial ou o caminho CLI é exercitado.
|
|
4
|
+
|
|
5
|
+
| Componente | Existe | Integrado | Persistente | Testado | Produção |
|
|
6
|
+
| --- | ---: | ---: | ---: | ---: | ---: |
|
|
7
|
+
| Contratos versionados | sim | sim | n/a | sim | sim |
|
|
8
|
+
| Capability Registry | sim | sim | n/a | sim | sim |
|
|
9
|
+
| CLI adapter | sim | sim | n/a | sim | sim |
|
|
10
|
+
| Runtime | sim | sim | sim | sim | sim |
|
|
11
|
+
| Policy/approvals | sim | sim | sim | sim | sim |
|
|
12
|
+
| Sprint/Task/Handoff | sim | sim | sim | sim | sim |
|
|
13
|
+
| Context Engine | sim | sim | sim | sim | sim |
|
|
14
|
+
| GraphLoop | sim | sim | sim | sim | sim |
|
|
15
|
+
| Sandbox Git worktree | sim | sim | sessão | sim | sim |
|
|
16
|
+
| Sandbox rollback | sim | sim | sessão | sim | sim |
|
|
17
|
+
| Validator | sim | sim | n/a | sim | sim |
|
|
18
|
+
| Event Bus/Scheduler | sim | sim | sim | sim | sim |
|
|
19
|
+
| MCP stdio | sim | sim | n/a | sim | sim |
|
|
20
|
+
| SDK | sim | sim | n/a | sim | sim |
|
|
21
|
+
| Nest adapter/control plane | sim | sim | sim | sim | sim |
|
|
22
|
+
| Dashboard | sim | sim | via API | sim | parcial |
|
|
23
|
+
| Observability/Evals | sim | sim | sim | sim | sim |
|
|
24
|
+
| Plugin SDK | sim | sim | n/a | sim | sim |
|
|
25
|
+
| GitHub/Docker official boundaries | sim | não há handler externo | n/a | sim | boundary |
|
|
26
|
+
|
|
27
|
+
## Evidências executadas
|
|
28
|
+
|
|
29
|
+
- `npm run demo:autonomy`: fixture externa, worktree Git, alteração real, `npm test`, diff, promoção, SQLite, GraphLoop e handoff.
|
|
30
|
+
- `test/mcp-stdio.test.js`: transporte JSON-RPC por processo filho, stdout limpo, tools/resources e shutdown.
|
|
31
|
+
- `test/server-persistence.test.js`: composição oficial SQLite, encerramento/recriação e recuperação de runtime, approval, contexto, grafo, evento e observação.
|
|
32
|
+
- `test/sandbox.test.js` e `test/adapter-git.test.js`: promoção e rollback explícitos.
|
|
33
|
+
- `test/context-benchmark.test.js`: benchmark determinístico; execução observada nesta árvore: baseline 214.549 tokens estimados, contexto selecionado 9.175, redução 95,72%, cache hit 1 e cobertura de evidência 1.
|
|
34
|
+
- `npm test -- --test-concurrency=1`: 300/300 aprovados.
|
|
35
|
+
- `npm run build`: aprovado.
|
|
36
|
+
- `git diff --check`: aprovado.
|
|
37
|
+
|
|
38
|
+
## Limites honestos
|
|
39
|
+
|
|
40
|
+
Os plugins oficiais são boundaries permissionados, não clientes GitHub/Docker completos. O dashboard é superfície de supervisão e não foi usado como dependência do fluxo CLI-first. A estimativa de tokens é um proxy determinístico bytes/4, não telemetria de um provedor de modelo. Essas limitações impedem afirmar que todos os cenários externos são 10/10; o fluxo local-first comprovado está fechado.
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# Sprint 1 — Unificar CLI e Capability Registry
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Fazer três comandos legados passarem pelo mesmo registry, validação, policy e
|
|
6
|
-
envelope `ExecutionResult`, preservando a saída humana existente.
|
|
7
|
-
|
|
8
|
-
## Escopo
|
|
9
|
-
|
|
10
|
-
Incluído:
|
|
11
|
-
|
|
12
|
-
- adapter CLI;
|
|
13
|
-
- mapa comando → capability para o catálogo inicial;
|
|
14
|
-
- schemas determinísticos de entrada;
|
|
15
|
-
- `system.doctor`, `code.impact`, `context.budget`;
|
|
16
|
-
- `capabilities:list`, `capabilities:describe` e
|
|
17
|
-
`capability:execute` em JSON;
|
|
18
|
-
- correlation ID e auditoria do resultado;
|
|
19
|
-
- testes de equivalência e rejeição de entrada.
|
|
20
|
-
|
|
21
|
-
Excluído:
|
|
22
|
-
|
|
23
|
-
- persistência do Runtime;
|
|
24
|
-
- MCP nativo;
|
|
25
|
-
- GraphLoop SQLite;
|
|
26
|
-
- sandbox/autonomia ponta a ponta;
|
|
27
|
-
- migração dos demais comandos.
|
|
28
|
-
|
|
29
|
-
## Impacto
|
|
30
|
-
|
|
31
|
-
Arquivos esperados: `apps/cli/`, `bin/forja.ts`, contratos/testes e
|
|
32
|
-
documentação. O domínio em `packages/core` permanece independente de processo,
|
|
33
|
-
CLI e framework.
|
|
34
|
-
|
|
35
|
-
## Critérios de aceite
|
|
36
|
-
|
|
37
|
-
1. Os três comandos são descobertos por capability ID e alias.
|
|
38
|
-
2. `forja capabilities:list --json` retorna definições versionadas.
|
|
39
|
-
3. `forja capabilities:describe code.impact --json` retorna o contrato.
|
|
40
|
-
4. Entradas inválidas são recusadas antes do handler.
|
|
41
|
-
5. `forja capability:execute code.impact --input '{...}' --json` retorna
|
|
42
|
-
`ExecutionResult` com `runId`, `correlationId`, status e evidência.
|
|
43
|
-
6. O modo textual dos três comandos preserva o comportamento legado.
|
|
44
|
-
7. Policy negada não chama o handler.
|
|
45
|
-
8. O gate de testes determinísticos passa sem alterar comandos fora do escopo.
|
|
46
|
-
|
|
47
|
-
## Status de execução — 2026-08-01
|
|
48
|
-
|
|
49
|
-
Concluído para os três comandos de prova. O adapter está em `apps/cli/src/index.ts`, o dispatch
|
|
50
|
-
integrado está em `bin/forja.ts` e os testes estão em `test/cli-capability-adapter.test.js`.
|
|
51
|
-
`tools:doctor`, `context:budget` e `code:impact` foram executados com `--json` em workspace
|
|
52
|
-
temporário; os envelopes observados continham `runId`, `correlationId`, status, payload e
|
|
53
|
-
evidência. Os demais comandos permanecem fora do escopo desta sprint.
|
|
1
|
+
# Sprint 1 — Unificar CLI e Capability Registry
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Fazer três comandos legados passarem pelo mesmo registry, validação, policy e
|
|
6
|
+
envelope `ExecutionResult`, preservando a saída humana existente.
|
|
7
|
+
|
|
8
|
+
## Escopo
|
|
9
|
+
|
|
10
|
+
Incluído:
|
|
11
|
+
|
|
12
|
+
- adapter CLI;
|
|
13
|
+
- mapa comando → capability para o catálogo inicial;
|
|
14
|
+
- schemas determinísticos de entrada;
|
|
15
|
+
- `system.doctor`, `code.impact`, `context.budget`;
|
|
16
|
+
- `capabilities:list`, `capabilities:describe` e
|
|
17
|
+
`capability:execute` em JSON;
|
|
18
|
+
- correlation ID e auditoria do resultado;
|
|
19
|
+
- testes de equivalência e rejeição de entrada.
|
|
20
|
+
|
|
21
|
+
Excluído:
|
|
22
|
+
|
|
23
|
+
- persistência do Runtime;
|
|
24
|
+
- MCP nativo;
|
|
25
|
+
- GraphLoop SQLite;
|
|
26
|
+
- sandbox/autonomia ponta a ponta;
|
|
27
|
+
- migração dos demais comandos.
|
|
28
|
+
|
|
29
|
+
## Impacto
|
|
30
|
+
|
|
31
|
+
Arquivos esperados: `apps/cli/`, `bin/forja.ts`, contratos/testes e
|
|
32
|
+
documentação. O domínio em `packages/core` permanece independente de processo,
|
|
33
|
+
CLI e framework.
|
|
34
|
+
|
|
35
|
+
## Critérios de aceite
|
|
36
|
+
|
|
37
|
+
1. Os três comandos são descobertos por capability ID e alias.
|
|
38
|
+
2. `forja capabilities:list --json` retorna definições versionadas.
|
|
39
|
+
3. `forja capabilities:describe code.impact --json` retorna o contrato.
|
|
40
|
+
4. Entradas inválidas são recusadas antes do handler.
|
|
41
|
+
5. `forja capability:execute code.impact --input '{...}' --json` retorna
|
|
42
|
+
`ExecutionResult` com `runId`, `correlationId`, status e evidência.
|
|
43
|
+
6. O modo textual dos três comandos preserva o comportamento legado.
|
|
44
|
+
7. Policy negada não chama o handler.
|
|
45
|
+
8. O gate de testes determinísticos passa sem alterar comandos fora do escopo.
|
|
46
|
+
|
|
47
|
+
## Status de execução — 2026-08-01
|
|
48
|
+
|
|
49
|
+
Concluído para os três comandos de prova. O adapter está em `apps/cli/src/index.ts`, o dispatch
|
|
50
|
+
integrado está em `bin/forja.ts` e os testes estão em `test/cli-capability-adapter.test.js`.
|
|
51
|
+
`tools:doctor`, `context:budget` e `code:impact` foram executados com `--json` em workspace
|
|
52
|
+
temporário; os envelopes observados continham `runId`, `correlationId`, status, payload e
|
|
53
|
+
evidência. Os demais comandos permanecem fora do escopo desta sprint.
|