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
|
@@ -16,54 +16,54 @@ function ensureSchema({ silent = false } = {}) {
|
|
|
16
16
|
const db = new Database(dbPath, { timeout: 5000 });
|
|
17
17
|
db.pragma('busy_timeout = 5000');
|
|
18
18
|
db.pragma('journal_mode = WAL');
|
|
19
|
-
db.exec(`
|
|
20
|
-
CREATE TABLE IF NOT EXISTS spec_summaries (
|
|
21
|
-
slug TEXT PRIMARY KEY,
|
|
22
|
-
status TEXT,
|
|
23
|
-
title TEXT,
|
|
24
|
-
summary TEXT NOT NULL,
|
|
25
|
-
source_path TEXT NOT NULL,
|
|
26
|
-
updated_at TEXT NOT NULL
|
|
27
|
-
);
|
|
28
|
-
|
|
29
|
-
CREATE TABLE IF NOT EXISTS context_runs (
|
|
30
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
31
|
-
created_at TEXT NOT NULL,
|
|
32
|
-
kind TEXT NOT NULL,
|
|
33
|
-
slug TEXT,
|
|
34
|
-
path TEXT NOT NULL,
|
|
35
|
-
bytes INTEGER NOT NULL,
|
|
36
|
-
estimated_tokens INTEGER NOT NULL,
|
|
37
|
-
limit_tokens INTEGER,
|
|
38
|
-
status TEXT NOT NULL
|
|
39
|
-
);
|
|
40
|
-
|
|
41
|
-
CREATE TABLE IF NOT EXISTS asset_catalog (
|
|
42
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
43
|
-
type TEXT NOT NULL,
|
|
44
|
-
name TEXT NOT NULL,
|
|
45
|
-
path TEXT NOT NULL UNIQUE,
|
|
46
|
-
summary TEXT,
|
|
47
|
-
tags TEXT,
|
|
48
|
-
updated_at TEXT NOT NULL
|
|
49
|
-
);
|
|
50
|
-
|
|
51
|
-
-- Projecao consultavel do audit trail (.context/forja-runs.jsonl), SPEC-014. O jsonl e a
|
|
52
|
-
-- fonte de verdade append-only; esta tabela e reconstruivel por audit:sync. line_hash (hash
|
|
53
|
-
-- do conteudo da linha) da idempotencia: re-sync nao duplica.
|
|
54
|
-
CREATE TABLE IF NOT EXISTS audit_runs (
|
|
55
|
-
line_hash TEXT PRIMARY KEY,
|
|
56
|
-
ts TEXT,
|
|
57
|
-
cmd TEXT,
|
|
58
|
-
args TEXT,
|
|
59
|
-
exit_code INTEGER,
|
|
60
|
-
duration_ms INTEGER
|
|
61
|
-
);
|
|
62
|
-
|
|
63
|
-
CREATE INDEX IF NOT EXISTS idx_context_runs_kind_slug ON context_runs(kind, slug);
|
|
64
|
-
CREATE INDEX IF NOT EXISTS idx_asset_catalog_type_name ON asset_catalog(type, name);
|
|
65
|
-
CREATE INDEX IF NOT EXISTS idx_audit_runs_cmd ON audit_runs(cmd);
|
|
66
|
-
CREATE INDEX IF NOT EXISTS idx_audit_runs_ts ON audit_runs(ts);
|
|
19
|
+
db.exec(`
|
|
20
|
+
CREATE TABLE IF NOT EXISTS spec_summaries (
|
|
21
|
+
slug TEXT PRIMARY KEY,
|
|
22
|
+
status TEXT,
|
|
23
|
+
title TEXT,
|
|
24
|
+
summary TEXT NOT NULL,
|
|
25
|
+
source_path TEXT NOT NULL,
|
|
26
|
+
updated_at TEXT NOT NULL
|
|
27
|
+
);
|
|
28
|
+
|
|
29
|
+
CREATE TABLE IF NOT EXISTS context_runs (
|
|
30
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
31
|
+
created_at TEXT NOT NULL,
|
|
32
|
+
kind TEXT NOT NULL,
|
|
33
|
+
slug TEXT,
|
|
34
|
+
path TEXT NOT NULL,
|
|
35
|
+
bytes INTEGER NOT NULL,
|
|
36
|
+
estimated_tokens INTEGER NOT NULL,
|
|
37
|
+
limit_tokens INTEGER,
|
|
38
|
+
status TEXT NOT NULL
|
|
39
|
+
);
|
|
40
|
+
|
|
41
|
+
CREATE TABLE IF NOT EXISTS asset_catalog (
|
|
42
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
43
|
+
type TEXT NOT NULL,
|
|
44
|
+
name TEXT NOT NULL,
|
|
45
|
+
path TEXT NOT NULL UNIQUE,
|
|
46
|
+
summary TEXT,
|
|
47
|
+
tags TEXT,
|
|
48
|
+
updated_at TEXT NOT NULL
|
|
49
|
+
);
|
|
50
|
+
|
|
51
|
+
-- Projecao consultavel do audit trail (.context/forja-runs.jsonl), SPEC-014. O jsonl e a
|
|
52
|
+
-- fonte de verdade append-only; esta tabela e reconstruivel por audit:sync. line_hash (hash
|
|
53
|
+
-- do conteudo da linha) da idempotencia: re-sync nao duplica.
|
|
54
|
+
CREATE TABLE IF NOT EXISTS audit_runs (
|
|
55
|
+
line_hash TEXT PRIMARY KEY,
|
|
56
|
+
ts TEXT,
|
|
57
|
+
cmd TEXT,
|
|
58
|
+
args TEXT,
|
|
59
|
+
exit_code INTEGER,
|
|
60
|
+
duration_ms INTEGER
|
|
61
|
+
);
|
|
62
|
+
|
|
63
|
+
CREATE INDEX IF NOT EXISTS idx_context_runs_kind_slug ON context_runs(kind, slug);
|
|
64
|
+
CREATE INDEX IF NOT EXISTS idx_asset_catalog_type_name ON asset_catalog(type, name);
|
|
65
|
+
CREATE INDEX IF NOT EXISTS idx_audit_runs_cmd ON audit_runs(cmd);
|
|
66
|
+
CREATE INDEX IF NOT EXISTS idx_audit_runs_ts ON audit_runs(ts);
|
|
67
67
|
`);
|
|
68
68
|
db.close();
|
|
69
69
|
if (!silent)
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* provenance:record / blame / sbom (SPEC-039)
|
|
4
|
+
*
|
|
5
|
+
* forja provenance:record <run-id> extrai proveniência de um RuntimeRun já persistido e grava
|
|
6
|
+
* forja blame <file> histórico de proveniência de um arquivo, mais recente primeiro
|
|
7
|
+
* forja sbom [--json] relatório agregado por agente
|
|
8
|
+
*
|
|
9
|
+
* `packages/engineering/provenance` faz o mapeamento puro (`extractProvenance`); este script busca
|
|
10
|
+
* o `RuntimeRun` real (`SqliteRuntimeRunStore`, já existente) e persiste via `SqliteProvenanceStore`
|
|
11
|
+
* (reaproveita `SqliteJsonRepository`, sem migration nova). Granularidade é arquivo, não linha —
|
|
12
|
+
* ver AC-2 da spec: nenhuma fonte de dado real deste repositório rastreia hunks de linha por run.
|
|
13
|
+
*/
|
|
14
|
+
export {};
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* provenance:record / blame / sbom (SPEC-039)
|
|
4
|
+
*
|
|
5
|
+
* forja provenance:record <run-id> extrai proveniência de um RuntimeRun já persistido e grava
|
|
6
|
+
* forja blame <file> histórico de proveniência de um arquivo, mais recente primeiro
|
|
7
|
+
* forja sbom [--json] relatório agregado por agente
|
|
8
|
+
*
|
|
9
|
+
* `packages/engineering/provenance` faz o mapeamento puro (`extractProvenance`); este script busca
|
|
10
|
+
* o `RuntimeRun` real (`SqliteRuntimeRunStore`, já existente) e persiste via `SqliteProvenanceStore`
|
|
11
|
+
* (reaproveita `SqliteJsonRepository`, sem migration nova). Granularidade é arquivo, não linha —
|
|
12
|
+
* ver AC-2 da spec: nenhuma fonte de dado real deste repositório rastreia hunks de linha por run.
|
|
13
|
+
*/
|
|
14
|
+
import fs from 'node:fs';
|
|
15
|
+
import Database from 'better-sqlite3';
|
|
16
|
+
import { extractProvenance } from "../packages/engineering/provenance/src/index.js";
|
|
17
|
+
import { SqliteMigrationRunner, SqliteProvenanceStore, SqliteRuntimeRunStore } from "../packages/adapter-sqlite/src/index.js";
|
|
18
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
|
|
19
|
+
function openDatabase() {
|
|
20
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
21
|
+
const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
22
|
+
new SqliteMigrationRunner(database).apply();
|
|
23
|
+
return database;
|
|
24
|
+
}
|
|
25
|
+
function cmdRecord([runId]) {
|
|
26
|
+
if (!runId) {
|
|
27
|
+
console.error('Uso: forja provenance:record <run-id>');
|
|
28
|
+
process.exitCode = 1;
|
|
29
|
+
return;
|
|
30
|
+
}
|
|
31
|
+
const database = openDatabase();
|
|
32
|
+
try {
|
|
33
|
+
const run = new SqliteRuntimeRunStore(database).get(runId);
|
|
34
|
+
if (run === undefined) {
|
|
35
|
+
console.error(`Run não encontrado: ${runId}.`);
|
|
36
|
+
process.exitCode = 1;
|
|
37
|
+
return;
|
|
38
|
+
}
|
|
39
|
+
const records = extractProvenance(run);
|
|
40
|
+
const store = new SqliteProvenanceStore(database);
|
|
41
|
+
for (const record of records)
|
|
42
|
+
store.save(record);
|
|
43
|
+
console.log(`${records.length} registro(s) de proveniência gravado(s) para ${runId} (${records.map((r) => r.file).join(', ') || '(nenhum arquivo alterado)'})`);
|
|
44
|
+
}
|
|
45
|
+
finally {
|
|
46
|
+
database.close();
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
function cmdBlame([file]) {
|
|
50
|
+
if (!file) {
|
|
51
|
+
console.error('Uso: forja blame <file>');
|
|
52
|
+
process.exitCode = 1;
|
|
53
|
+
return;
|
|
54
|
+
}
|
|
55
|
+
const database = openDatabase();
|
|
56
|
+
try {
|
|
57
|
+
const records = new SqliteProvenanceStore(database).list().filter((record) => record.file === file).sort((left, right) => right.recordedAt.localeCompare(left.recordedAt));
|
|
58
|
+
if (records.length === 0) {
|
|
59
|
+
console.log(`Nenhum registro de proveniência para ${file} ainda (granularidade de arquivo, não linha — rode forja provenance:record <run-id> primeiro).`);
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
62
|
+
for (const record of records)
|
|
63
|
+
console.log(`${record.recordedAt} ${record.agentName} (${record.agentId}) run:${record.runId}`);
|
|
64
|
+
}
|
|
65
|
+
finally {
|
|
66
|
+
database.close();
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
function cmdSbom(args) {
|
|
70
|
+
const json = args.includes('--json');
|
|
71
|
+
const database = openDatabase();
|
|
72
|
+
try {
|
|
73
|
+
const records = new SqliteProvenanceStore(database).list();
|
|
74
|
+
const byAgent = new Map();
|
|
75
|
+
for (const record of records) {
|
|
76
|
+
const entry = byAgent.get(record.agentId) ?? { agentId: record.agentId, agentName: record.agentName, files: new Set() };
|
|
77
|
+
entry.files.add(record.file);
|
|
78
|
+
byAgent.set(record.agentId, entry);
|
|
79
|
+
}
|
|
80
|
+
const report = [...byAgent.values()].map((entry) => ({ agentId: entry.agentId, agentName: entry.agentName, fileCount: entry.files.size, files: [...entry.files].sort() })).sort((left, right) => right.fileCount - left.fileCount);
|
|
81
|
+
if (json) {
|
|
82
|
+
console.log(JSON.stringify({ totalRecords: records.length, byAgent: report }, null, 2));
|
|
83
|
+
return;
|
|
84
|
+
}
|
|
85
|
+
if (report.length === 0) {
|
|
86
|
+
console.log('Nenhum registro de proveniência ainda — rode forja provenance:record <run-id> primeiro.');
|
|
87
|
+
return;
|
|
88
|
+
}
|
|
89
|
+
console.log(`AI-SBOM — ${records.length} registro(s) de proveniência, ${report.length} agente(s)\n`);
|
|
90
|
+
for (const entry of report) {
|
|
91
|
+
console.log(`${entry.agentName} (${entry.agentId}) — ${entry.fileCount} arquivo(s)`);
|
|
92
|
+
for (const file of entry.files)
|
|
93
|
+
console.log(` ${file}`);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
finally {
|
|
97
|
+
database.close();
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
async function main() {
|
|
101
|
+
const [subcommand, ...rest] = process.argv.slice(2);
|
|
102
|
+
switch (subcommand) {
|
|
103
|
+
case 'record': return cmdRecord(rest);
|
|
104
|
+
case 'blame': return cmdBlame(rest);
|
|
105
|
+
case 'sbom': return cmdSbom(rest);
|
|
106
|
+
default:
|
|
107
|
+
console.error('Uso: forja provenance:record <run-id> | forja blame <file> | forja sbom [--json]');
|
|
108
|
+
process.exitCode = 1;
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
main().catch((error) => {
|
|
112
|
+
console.error(`\nprovenance: falhou: ${error instanceof Error ? error.message : String(error)}`);
|
|
113
|
+
process.exitCode = 1;
|
|
114
|
+
});
|
|
@@ -10,19 +10,19 @@ if (!query) {
|
|
|
10
10
|
process.exit(0);
|
|
11
11
|
}
|
|
12
12
|
const db = new Database(dbPath, { readonly: true });
|
|
13
|
-
const search = db.prepare(`
|
|
14
|
-
SELECT
|
|
15
|
-
n.path,
|
|
16
|
-
n.kind,
|
|
17
|
-
n.title,
|
|
18
|
-
p.name as project,
|
|
19
|
-
snippet(search_idx, 2, '>', '<', '...', 20) as snippet
|
|
20
|
-
FROM search_idx
|
|
21
|
-
JOIN memory_nodes n ON n.id = search_idx.node_id
|
|
22
|
-
LEFT JOIN projects p ON p.id = n.project_id
|
|
23
|
-
WHERE search_idx MATCH ?
|
|
24
|
-
ORDER BY rank
|
|
25
|
-
LIMIT ?
|
|
13
|
+
const search = db.prepare(`
|
|
14
|
+
SELECT
|
|
15
|
+
n.path,
|
|
16
|
+
n.kind,
|
|
17
|
+
n.title,
|
|
18
|
+
p.name as project,
|
|
19
|
+
snippet(search_idx, 2, '>', '<', '...', 20) as snippet
|
|
20
|
+
FROM search_idx
|
|
21
|
+
JOIN memory_nodes n ON n.id = search_idx.node_id
|
|
22
|
+
LEFT JOIN projects p ON p.id = n.project_id
|
|
23
|
+
WHERE search_idx MATCH ?
|
|
24
|
+
ORDER BY rank
|
|
25
|
+
LIMIT ?
|
|
26
26
|
`);
|
|
27
27
|
try {
|
|
28
28
|
const results = search.all(query, limit);
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* risk:assess / risk:explain (SPEC-034)
|
|
4
|
+
*
|
|
5
|
+
* forja risk:assess [ref] score de risco 0-100 sobre o diff de <ref> (default: working tree vs HEAD)
|
|
6
|
+
* forja risk:explain <id> reexibe um assessment já calculado, com todos os fatores
|
|
7
|
+
*
|
|
8
|
+
* `packages/engineering/risk` faz o cálculo puro (7 fatores, pesos configuráveis, D1-D4 do plan);
|
|
9
|
+
* `lib/core/risk-collect.ts` coleta os números reais (grafo, constitution, histórico) — reaproveitado
|
|
10
|
+
* também por `scripts/engineer.ts` (SPEC-035), daí viver em `lib/core` e não aqui. Este script só
|
|
11
|
+
* cuida do ciclo de vida do assessment em si: diff via git, persistência efêmera
|
|
12
|
+
* (`.context/risk/<id>.json`, mesma categoria de `.context/forja-runs.jsonl` — fora do git, D2 do
|
|
13
|
+
* plan de SPEC-034), e a CLI.
|
|
14
|
+
*/
|
|
15
|
+
export {};
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* risk:assess / risk:explain (SPEC-034)
|
|
4
|
+
*
|
|
5
|
+
* forja risk:assess [ref] score de risco 0-100 sobre o diff de <ref> (default: working tree vs HEAD)
|
|
6
|
+
* forja risk:explain <id> reexibe um assessment já calculado, com todos os fatores
|
|
7
|
+
*
|
|
8
|
+
* `packages/engineering/risk` faz o cálculo puro (7 fatores, pesos configuráveis, D1-D4 do plan);
|
|
9
|
+
* `lib/core/risk-collect.ts` coleta os números reais (grafo, constitution, histórico) — reaproveitado
|
|
10
|
+
* também por `scripts/engineer.ts` (SPEC-035), daí viver em `lib/core` e não aqui. Este script só
|
|
11
|
+
* cuida do ciclo de vida do assessment em si: diff via git, persistência efêmera
|
|
12
|
+
* (`.context/risk/<id>.json`, mesma categoria de `.context/forja-runs.jsonl` — fora do git, D2 do
|
|
13
|
+
* plan de SPEC-034), e a CLI.
|
|
14
|
+
*/
|
|
15
|
+
import fs from 'node:fs';
|
|
16
|
+
import path from 'node:path';
|
|
17
|
+
import { randomUUID } from 'node:crypto';
|
|
18
|
+
import Database from 'better-sqlite3';
|
|
19
|
+
import { assessRisk, explainAssessment } from "../packages/engineering/risk/src/index.js";
|
|
20
|
+
import { SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
|
|
21
|
+
import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
|
|
22
|
+
import { buildRiskInput, changedFiles, graphRoot } from "../lib/core/risk-collect.js";
|
|
23
|
+
const RISK_DIR = '.context/risk';
|
|
24
|
+
function assessmentPath(id) {
|
|
25
|
+
return path.join(graphRoot(), RISK_DIR, `${id}.json`);
|
|
26
|
+
}
|
|
27
|
+
function saveAssessment(assessment) {
|
|
28
|
+
fs.mkdirSync(path.join(graphRoot(), RISK_DIR), { recursive: true });
|
|
29
|
+
fs.writeFileSync(assessmentPath(assessment.id), `${JSON.stringify(assessment, null, 2)}\n`);
|
|
30
|
+
}
|
|
31
|
+
async function cmdAssess([ref]) {
|
|
32
|
+
const paths = changedFiles(ref);
|
|
33
|
+
if (paths.length === 0) {
|
|
34
|
+
console.log('Nenhum arquivo alterado — nada para avaliar (compare contra HEAD, ou passe um ref de commit).');
|
|
35
|
+
return;
|
|
36
|
+
}
|
|
37
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
38
|
+
const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
39
|
+
new SqliteMigrationRunner(database).apply();
|
|
40
|
+
let input;
|
|
41
|
+
try {
|
|
42
|
+
input = await buildRiskInput(paths, database);
|
|
43
|
+
}
|
|
44
|
+
finally {
|
|
45
|
+
database.close();
|
|
46
|
+
}
|
|
47
|
+
const id = randomUUID();
|
|
48
|
+
const assessment = assessRisk(input, { id, changeId: ref ?? 'working-tree', now: new Date().toISOString() });
|
|
49
|
+
saveAssessment(assessment);
|
|
50
|
+
console.log(explainAssessment(assessment));
|
|
51
|
+
console.log(`\n${paths.length} arquivo(s) avaliado(s). Assessment salvo — forja risk:explain ${id}`);
|
|
52
|
+
}
|
|
53
|
+
function cmdExplain([id]) {
|
|
54
|
+
if (!id) {
|
|
55
|
+
console.error('Uso: forja risk:explain <assessment-id>');
|
|
56
|
+
process.exitCode = 1;
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
const file = assessmentPath(id);
|
|
60
|
+
if (!fs.existsSync(file)) {
|
|
61
|
+
console.error(`Assessment não encontrado: ${id}. Rode forja risk:assess primeiro.`);
|
|
62
|
+
process.exitCode = 1;
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
const assessment = JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
66
|
+
console.log(explainAssessment(assessment));
|
|
67
|
+
}
|
|
68
|
+
async function main() {
|
|
69
|
+
const [subcommand, ...rest] = process.argv.slice(2);
|
|
70
|
+
switch (subcommand) {
|
|
71
|
+
case 'assess': return cmdAssess(rest);
|
|
72
|
+
case 'explain': return cmdExplain(rest);
|
|
73
|
+
default:
|
|
74
|
+
console.error('Uso: forja risk:<assess|explain> [args]');
|
|
75
|
+
process.exitCode = 1;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
main().catch((error) => {
|
|
79
|
+
console.error(`\nrisk: falhou: ${error instanceof Error ? error.message : String(error)}`);
|
|
80
|
+
process.exitCode = 1;
|
|
81
|
+
});
|
|
@@ -0,0 +1,20 @@
|
|
|
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
|
+
export {};
|
|
@@ -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}.`);
|