forjajs 2.0.2 → 2.0.4
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 +68 -59
- 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 +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -317
- package/README.pt-BR.md +345 -323
- 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/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.d.ts +1 -0
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
- 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 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- 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/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-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- 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/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- 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 +23 -26
- 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 -0
- 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 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- 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 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -140
- 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/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/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/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/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/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/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- 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/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,132 +1,40 @@
|
|
|
1
|
-
# ForjaJS 2.x —
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
| Event Bus/Scheduler | sim | server/worker/testes | Event Bus no server usa SQLite; scheduler ainda separado | sim | parcial |
|
|
42
|
-
| Observabilidade/Control Plane | sim | server/dashboard | memória por padrão | sim | parcial |
|
|
43
|
-
| NestJS adapter/server | sim | server bootstrap | não | sim | parcial |
|
|
44
|
-
| Next.js dashboard | sim | consulta API/proxy | remoto | sim | parcial |
|
|
45
|
-
|
|
46
|
-
## Achados principais
|
|
47
|
-
|
|
48
|
-
1. O registry declarativo legado (`COMMANDS`) contém o comportamento público da
|
|
49
|
-
CLI: domínio, descrição, script, argumentos e gates. Ele não produz
|
|
50
|
-
`CapabilityDefinition` nem passa pelo `CapabilityRegistry`.
|
|
51
|
-
2. O `CapabilityRegistry` valida, autoriza e normaliza `ExecutionResult`, mas
|
|
52
|
-
não conhece comandos legados e não possui um catálogo padrão registrado.
|
|
53
|
-
3. A Sprint 5 corrigiu a composição do server: `apps/server/src/main.ts` agora
|
|
54
|
-
registra o mesmo catálogo de seis capabilities da CLI e inicializa approvals
|
|
55
|
-
e auditoria MCP no SQLite.
|
|
56
|
-
4. MCP e SDK já possuem superfícies sobre capabilities, mas dependem de um
|
|
57
|
-
registry preenchido pelo consumidor.
|
|
58
|
-
5. Os três comandos da Sprint 1 possuem handlers determinísticos existentes:
|
|
59
|
-
`tools:doctor` em `scripts/tools-doctor.ts`, `code:impact` em
|
|
60
|
-
`scripts/agent-harness.ts` e `context:budget` em `scripts/context-ops.ts`.
|
|
61
|
-
6. A auditoria transversal existente em `bin/forja.ts` registra comando, args,
|
|
62
|
-
exit code e duração, mas não registra `runId`, `capabilityId` ou o envelope
|
|
63
|
-
completo de `ExecutionResult`.
|
|
64
|
-
7. A Sprint 3 adicionou a porta `RuntimePersistence`, o adapter SQLite e a
|
|
65
|
-
recuperação explícita por policy; approvals e execução distribuída continuam pendentes.
|
|
66
|
-
8. A Sprint 4 adicionou `forja_capability_describe`, ferramentas derivadas do registry e o
|
|
67
|
-
transporte local `mcp:start`; a Sprint 5 completou o catálogo padrão do server.
|
|
68
|
-
9. A Sprint 5 passou o catálogo CLI, approvals e auditoria MCP para a composição oficial do
|
|
69
|
-
server; approvals e auditoria MCP usam SQLite.
|
|
70
|
-
10. A Sprint 6 tornou o Event Bus restart-safe sobre `SqliteEventStore` e adicionou uma prova
|
|
71
|
-
E2E determinística; GraphLoop persistente e sandbox Git worktree continuam pendentes.
|
|
72
|
-
11. A Sprint 7 extraiu `GraphStore`, adicionou `SqliteGraphStore` e ligou o mesmo grafo persistente
|
|
73
|
-
ao MCP e à memória de execução; Context Engine e engines de contradição/agenda ainda não estão
|
|
74
|
-
plenamente ligados ao store.
|
|
75
|
-
12. A Sprint 8 ligou `GraphContextSource` e `SqliteContextCache` ao bootstrap oficial; a relevância
|
|
76
|
-
de grafo é lexical e determinística, enquanto trechos de arquivos e busca semântica continuam
|
|
77
|
-
fora do escopo.
|
|
78
|
-
13. A Sprint 9 ampliou o extractor determinístico para símbolos, chamadas, ADRs, tarefas, handoffs,
|
|
79
|
-
testes e manifests; resolução semântica completa, commits e diffs ainda requerem extractors
|
|
80
|
-
específicos.
|
|
81
|
-
14. A Sprint 10 adicionou `GraphIndexer`, `GitGraphDocumentSource` e a capability `graph.sync`;
|
|
82
|
-
a composição oficial usa o GraphLoop SQLite, mas poda de remoções e histórico de commits ainda
|
|
83
|
-
estão pendentes.
|
|
84
|
-
15. A Sprint 11 expôs `graph.sync` no registry/CLI standalone e no MCP stdio, com métricas de
|
|
85
|
-
documentos, nós, arestas, arquivos e duração; observações persistentes do Control Plane ainda
|
|
86
|
-
são uma pendência distinta.
|
|
87
|
-
|
|
88
|
-
## Mapa inicial comando → capability
|
|
89
|
-
|
|
90
|
-
| Comando legado | Capability alvo | Prova Sprint 1 |
|
|
91
|
-
| --- | --- | ---: |
|
|
92
|
-
| `tools:doctor` | `system.doctor` | sim |
|
|
93
|
-
| `code:impact` | `code.impact` | sim |
|
|
94
|
-
| `context:budget` | `context.budget` | sim |
|
|
95
|
-
| `spec:new` | `spec.create` | próxima |
|
|
96
|
-
| `spec:check` | `spec.validate` | sim, Sprint 2 |
|
|
97
|
-
| `sprint:start` | `sprint.start` | próxima |
|
|
98
|
-
| `sprint:status` | `sprint.status` | sim, Sprint 2 |
|
|
99
|
-
| `gsd:handoff` | `handoff.create` | sim, Sprint 2 |
|
|
100
|
-
| `context:smart` | `context.build` | próxima |
|
|
101
|
-
| `memory:compress` | `memory.compact` | próxima |
|
|
102
|
-
|
|
103
|
-
O restante do mapa é mantido como backlog de migração; nesta sprint nenhum
|
|
104
|
-
comando não comprovado será apresentado como integrado.
|
|
105
|
-
|
|
106
|
-
## Hipóteses e informações ausentes
|
|
107
|
-
|
|
108
|
-
- A compatibilidade de saída textual dos três comandos deve ser preservada;
|
|
109
|
-
`--json` adicionará o envelope estruturado sem remover o modo humano.
|
|
110
|
-
- Os handlers legados continuam sendo a fonte determinística de execução nesta
|
|
111
|
-
sprint; a unificação elimina o registry paralelo, não reescreve os handlers.
|
|
112
|
-
- A persistência de approvals, eventos de runtime e execução distribuída permanece fora do
|
|
113
|
-
escopo após a Sprint 3.
|
|
114
|
-
- O contrato atual não possui um campo específico para argumentos de CLI; o
|
|
115
|
-
payload validado da capability carregará esses argumentos.
|
|
116
|
-
|
|
117
|
-
## Decisão de escopo
|
|
118
|
-
|
|
119
|
-
Implementar um adapter na aplicação CLI que registra três capabilities no
|
|
120
|
-
`CapabilityRegistry`, delega os handlers legados por uma porta injetada e usa
|
|
121
|
-
`PolicyEngine` antes da execução. `bin/forja.ts` continuará adaptando comandos
|
|
122
|
-
não migrados durante a transição, mas os três comandos de prova não terão lógica
|
|
123
|
-
duplicada de negócio.
|
|
124
|
-
|
|
125
|
-
## Riscos
|
|
126
|
-
|
|
127
|
-
- Alterar o dispatch pode mudar mensagens ou códigos de saída; testes de
|
|
128
|
-
equivalência devem comparar modo textual e modo JSON.
|
|
129
|
-
- `code:impact` depende de `codegraph` e tem fallback manual; o adapter não pode
|
|
130
|
-
transformar ausência de ferramenta em sucesso falso.
|
|
131
|
-
- `context:budget` grava uma medição no SQLite; a política deve declarar o
|
|
132
|
-
efeito de banco, mesmo sendo uma operação determinística.
|
|
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.
|
|
@@ -1,54 +1,54 @@
|
|
|
1
|
-
# Sprint 10 — Indexação incremental de workspace/Git
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Transformar os extractors do GraphLoop em uma operação utilizável: listar
|
|
6
|
-
arquivos rastreáveis do workspace, gerar mutations determinísticas e expor o
|
|
7
|
-
processo como capability `graph.sync`.
|
|
8
|
-
|
|
9
|
-
## Fluxo
|
|
10
|
-
|
|
11
|
-
```text
|
|
12
|
-
GitWorkspaceSource
|
|
13
|
-
↓
|
|
14
|
-
GraphIndexer
|
|
15
|
-
↓
|
|
16
|
-
extractDeterministicRelations
|
|
17
|
-
↓
|
|
18
|
-
GraphLoop.apply (checksum)
|
|
19
|
-
↓
|
|
20
|
-
SqliteGraphStore
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
## Escopo
|
|
24
|
-
|
|
25
|
-
- `git ls-files --cached --others --exclude-standard -z` como fonte local;
|
|
26
|
-
- arquivos TypeScript/JavaScript/JSON/Markdown/YAML;
|
|
27
|
-
- exclusão de `.git`, `node_modules`, `dist`, `coverage`, binários e arquivos
|
|
28
|
-
maiores que 1 MB;
|
|
29
|
-
- indexação incremental por locator/checksum;
|
|
30
|
-
- capability `graph.sync` com `ExecutionResult` e evidência;
|
|
31
|
-
- composição da capability no server oficial.
|
|
32
|
-
|
|
33
|
-
## Critérios de aceite
|
|
34
|
-
|
|
35
|
-
1. Arquivos ignorados e não indexáveis não entram na fonte.
|
|
36
|
-
2. Uma sincronização repetida retorna `skipped` sem duplicar arestas.
|
|
37
|
-
3. Falha do Git é retornada como erro, não como sucesso vazio.
|
|
38
|
-
4. A capability valida input antes do handler e exige permissão de escrita.
|
|
39
|
-
5. O server registra `graph.sync` sobre o GraphLoop SQLite.
|
|
40
|
-
6. A operação continua offline e não usa LLM.
|
|
41
|
-
|
|
42
|
-
## Limites
|
|
43
|
-
|
|
44
|
-
- arquivos removidos não são podados automaticamente nesta sprint;
|
|
45
|
-
- commits e diffs não são entidades extraídas ainda;
|
|
46
|
-
- `git ls-files` exige um repositório válido para a fonte oficial.
|
|
47
|
-
|
|
48
|
-
## Evidências
|
|
49
|
-
|
|
50
|
-
- `packages/graph/src/index.ts`;
|
|
51
|
-
- `packages/adapter-git/src/index.ts`;
|
|
52
|
-
- `apps/cli/src/index.ts`;
|
|
53
|
-
- `apps/server/src/main.ts`;
|
|
54
|
-
- testes de GraphIndexer, adapter Git e capability.
|
|
1
|
+
# Sprint 10 — Indexação incremental de workspace/Git
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Transformar os extractors do GraphLoop em uma operação utilizável: listar
|
|
6
|
+
arquivos rastreáveis do workspace, gerar mutations determinísticas e expor o
|
|
7
|
+
processo como capability `graph.sync`.
|
|
8
|
+
|
|
9
|
+
## Fluxo
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
GitWorkspaceSource
|
|
13
|
+
↓
|
|
14
|
+
GraphIndexer
|
|
15
|
+
↓
|
|
16
|
+
extractDeterministicRelations
|
|
17
|
+
↓
|
|
18
|
+
GraphLoop.apply (checksum)
|
|
19
|
+
↓
|
|
20
|
+
SqliteGraphStore
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Escopo
|
|
24
|
+
|
|
25
|
+
- `git ls-files --cached --others --exclude-standard -z` como fonte local;
|
|
26
|
+
- arquivos TypeScript/JavaScript/JSON/Markdown/YAML;
|
|
27
|
+
- exclusão de `.git`, `node_modules`, `dist`, `coverage`, binários e arquivos
|
|
28
|
+
maiores que 1 MB;
|
|
29
|
+
- indexação incremental por locator/checksum;
|
|
30
|
+
- capability `graph.sync` com `ExecutionResult` e evidência;
|
|
31
|
+
- composição da capability no server oficial.
|
|
32
|
+
|
|
33
|
+
## Critérios de aceite
|
|
34
|
+
|
|
35
|
+
1. Arquivos ignorados e não indexáveis não entram na fonte.
|
|
36
|
+
2. Uma sincronização repetida retorna `skipped` sem duplicar arestas.
|
|
37
|
+
3. Falha do Git é retornada como erro, não como sucesso vazio.
|
|
38
|
+
4. A capability valida input antes do handler e exige permissão de escrita.
|
|
39
|
+
5. O server registra `graph.sync` sobre o GraphLoop SQLite.
|
|
40
|
+
6. A operação continua offline e não usa LLM.
|
|
41
|
+
|
|
42
|
+
## Limites
|
|
43
|
+
|
|
44
|
+
- arquivos removidos não são podados automaticamente nesta sprint;
|
|
45
|
+
- commits e diffs não são entidades extraídas ainda;
|
|
46
|
+
- `git ls-files` exige um repositório válido para a fonte oficial.
|
|
47
|
+
|
|
48
|
+
## Evidências
|
|
49
|
+
|
|
50
|
+
- `packages/graph/src/index.ts`;
|
|
51
|
+
- `packages/adapter-git/src/index.ts`;
|
|
52
|
+
- `apps/cli/src/index.ts`;
|
|
53
|
+
- `apps/server/src/main.ts`;
|
|
54
|
+
- testes de GraphIndexer, adapter Git e capability.
|
|
@@ -1,38 +1,38 @@
|
|
|
1
|
-
# Sprint 11 — Graph sync na CLI, MCP e observabilidade
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Tornar `graph.sync` uma capability operável pela CLI standalone e pelo MCP
|
|
6
|
-
stdio, mantendo um único handler e registrando contagens, arquivos e duração.
|
|
7
|
-
|
|
8
|
-
## Escopo
|
|
9
|
-
|
|
10
|
-
- alias declarativo `graph:sync` no registry do core;
|
|
11
|
-
- `capabilities:list`, `capabilities:describe` e `capability:execute` com
|
|
12
|
-
`graph.sync`;
|
|
13
|
-
- `mcp:start` descobrindo a ferramenta dinâmica pelo registry;
|
|
14
|
-
- composição local GraphLoop + SQLite + Git reutilizada pelos adaptadores;
|
|
15
|
-
- saída humana resumida e saída JSON estruturada;
|
|
16
|
-
- métricas `documents`, `indexed`, `skipped`, `nodes`, `edges`, `files` e
|
|
17
|
-
`durationMs` no resultado e no registro de auditoria CLI.
|
|
18
|
-
|
|
19
|
-
## Critérios de aceite
|
|
20
|
-
|
|
21
|
-
1. `graph.sync` aparece em `forja capabilities:list --json`.
|
|
22
|
-
2. `forja graph:sync --json` indexa o repositório atual sem LLM.
|
|
23
|
-
3. Reexecução usa checksum e informa documentos ignorados.
|
|
24
|
-
4. MCP stdio deriva a ferramenta a partir do registry, sem lista duplicada.
|
|
25
|
-
5. Policy exige permissão `write` para a capability.
|
|
26
|
-
6. Falhas do Git retornam `ExecutionResult` falho.
|
|
27
|
-
7. Testes, typecheck, build e release gate passam.
|
|
28
|
-
|
|
29
|
-
## Evidência operacional
|
|
30
|
-
|
|
31
|
-
No workspace temporário da Sprint 11, a CLI descobriu `graph.sync` e a execução
|
|
32
|
-
indexou 867 documentos em 8,9s, retornando contagens estruturadas.
|
|
33
|
-
|
|
34
|
-
## Limites
|
|
35
|
-
|
|
36
|
-
- CLI não faz poda de arquivos removidos;
|
|
37
|
-
- observabilidade detalhada fica no envelope/auditoria CLI; persistência de
|
|
38
|
-
observações do Control Plane para essa ação será consolidada em sprint futura.
|
|
1
|
+
# Sprint 11 — Graph sync na CLI, MCP e observabilidade
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Tornar `graph.sync` uma capability operável pela CLI standalone e pelo MCP
|
|
6
|
+
stdio, mantendo um único handler e registrando contagens, arquivos e duração.
|
|
7
|
+
|
|
8
|
+
## Escopo
|
|
9
|
+
|
|
10
|
+
- alias declarativo `graph:sync` no registry do core;
|
|
11
|
+
- `capabilities:list`, `capabilities:describe` e `capability:execute` com
|
|
12
|
+
`graph.sync`;
|
|
13
|
+
- `mcp:start` descobrindo a ferramenta dinâmica pelo registry;
|
|
14
|
+
- composição local GraphLoop + SQLite + Git reutilizada pelos adaptadores;
|
|
15
|
+
- saída humana resumida e saída JSON estruturada;
|
|
16
|
+
- métricas `documents`, `indexed`, `skipped`, `nodes`, `edges`, `files` e
|
|
17
|
+
`durationMs` no resultado e no registro de auditoria CLI.
|
|
18
|
+
|
|
19
|
+
## Critérios de aceite
|
|
20
|
+
|
|
21
|
+
1. `graph.sync` aparece em `forja capabilities:list --json`.
|
|
22
|
+
2. `forja graph:sync --json` indexa o repositório atual sem LLM.
|
|
23
|
+
3. Reexecução usa checksum e informa documentos ignorados.
|
|
24
|
+
4. MCP stdio deriva a ferramenta a partir do registry, sem lista duplicada.
|
|
25
|
+
5. Policy exige permissão `write` para a capability.
|
|
26
|
+
6. Falhas do Git retornam `ExecutionResult` falho.
|
|
27
|
+
7. Testes, typecheck, build e release gate passam.
|
|
28
|
+
|
|
29
|
+
## Evidência operacional
|
|
30
|
+
|
|
31
|
+
No workspace temporário da Sprint 11, a CLI descobriu `graph.sync` e a execução
|
|
32
|
+
indexou 867 documentos em 8,9s, retornando contagens estruturadas.
|
|
33
|
+
|
|
34
|
+
## Limites
|
|
35
|
+
|
|
36
|
+
- CLI não faz poda de arquivos removidos;
|
|
37
|
+
- observabilidade detalhada fica no envelope/auditoria CLI; persistência de
|
|
38
|
+
observações do Control Plane para essa ação será consolidada em sprint futura.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Sprint 12 — Prova de autonomia supervisionada real
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Substituir a prova E2E simulada por uma demonstração repetível que usa fixture externa,
|
|
6
|
+
Git worktree, arquivo real, teste real, aprovação persistida, promoção real e estado
|
|
7
|
+
auditável em SQLite.
|
|
8
|
+
|
|
9
|
+
## Escopo
|
|
10
|
+
|
|
11
|
+
- `npm run demo:autonomy`;
|
|
12
|
+
- agente simulado determinístico, sem provedor LLM;
|
|
13
|
+
- Context Engine e GraphLoop antes do plano;
|
|
14
|
+
- Policy Engine e `ApprovalLedger` antes da escrita;
|
|
15
|
+
- `GitWorktreeBackend` no caminho principal;
|
|
16
|
+
- Validator independente antes da promoção;
|
|
17
|
+
- Sprint, Task, Handoff, Event Bus e auditoria persistidos.
|
|
18
|
+
|
|
19
|
+
## Critérios de aceite
|
|
20
|
+
|
|
21
|
+
- fixture é criada fora do repositório do framework;
|
|
22
|
+
- teste inicia falhando e termina passando após edição na worktree;
|
|
23
|
+
- workspace principal da fixture só muda na promoção explícita;
|
|
24
|
+
- aprovação, run, checkpoint, sandbox, evento e handoff sobrevivem no SQLite;
|
|
25
|
+
- GraphLoop recebe evidências e relações da execução;
|
|
26
|
+
- Validator retorna `accepted` antes de `promote`;
|
|
27
|
+
- teste automatizado repete o fluxo e limpa seus artefatos temporários.
|
|
28
|
+
|
|
29
|
+
## Fora do escopo
|
|
30
|
+
|
|
31
|
+
MCP stdio real, composição de servidor após restart abrupto, rollback automatizado,
|
|
32
|
+
contradições avançadas, plugins oficiais e benchmark comparativo de tokens. São as
|
|
33
|
+
próximas sprints de fechamento 10/10.
|
|
34
|
+
|
|
35
|
+
## Evidências
|
|
36
|
+
|
|
37
|
+
- `scripts/demo-autonomy.ts`;
|
|
38
|
+
- `test/demo-autonomy.test.js`;
|
|
39
|
+
- `npm run demo:autonomy`;
|
|
40
|
+
- saída observada: validação `accepted`, uma alteração promovida, 18 nós e 14 arestas.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Sprint 13 — MCP stdio real
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Provar que clientes externos conseguem iniciar `forja mcp:start`, negociar o
|
|
6
|
+
protocolo JSON-RPC por stdio, descobrir tools, descrever e executar capability,
|
|
7
|
+
ler resource e encerrar sem perder o contrato de transporte.
|
|
8
|
+
|
|
9
|
+
## Critérios de aceite
|
|
10
|
+
|
|
11
|
+
- processo MCP real é iniciado por `node bin/forja.ts mcp:start`;
|
|
12
|
+
- cada resposta é JSON-RPC válido em stdout;
|
|
13
|
+
- stdout não contém logs não-JSON e stderr permanece limpo no caminho feliz;
|
|
14
|
+
- `initialize`, `notifications/initialized`, `tools/list`, `tools/call`,
|
|
15
|
+
`resources/list` e `resources/read` funcionam;
|
|
16
|
+
- execução retorna `ExecutionResult` estruturado;
|
|
17
|
+
- EOF encerra o servidor com exit code 0.
|
|
18
|
+
|
|
19
|
+
## Evidência
|
|
20
|
+
|
|
21
|
+
`test/mcp-stdio.test.js` executa um cliente filho real contra o transporte.
|
|
22
|
+
|
|
23
|
+
## Próximo passo
|
|
24
|
+
|
|
25
|
+
Compor o mesmo transporte no servidor oficial e provar reinício abrupto com
|
|
26
|
+
runtime, approval, context cache e GraphLoop persistidos.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Sprint 14 — Composição oficial persistente e restart
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Provar que o backend Nest oficial compõe os adapters SQLite e recupera estado
|
|
6
|
+
operacional depois que a primeira composição é encerrada e uma segunda é criada.
|
|
7
|
+
|
|
8
|
+
## Critérios de aceite
|
|
9
|
+
|
|
10
|
+
- RuntimeRun e plano são recuperáveis;
|
|
11
|
+
- approval pendente permanece disponível;
|
|
12
|
+
- checkpoint/runtime state são lidos pelo novo processo;
|
|
13
|
+
- Context cache, GraphLoop e Event Bus preservam dados;
|
|
14
|
+
- Sprint/Task/Handoff e Observabilidade usam stores SQLite no bootstrap;
|
|
15
|
+
- build estrito e probe em processo separado passam.
|
|
16
|
+
|
|
17
|
+
## Evidência
|
|
18
|
+
|
|
19
|
+
`test/server-persistence.test.js` inicia `test/server-persistence-probe.mjs` com
|
|
20
|
+
`node --import tsx`; o probe cria duas composições oficiais contra o mesmo arquivo
|
|
21
|
+
SQLite e confirma run `awaiting_approval`, approval, contexto, grafo, eventos e
|
|
22
|
+
observações após o fechamento da primeira conexão.
|
|
23
|
+
|
|
24
|
+
## Risco conhecido
|
|
25
|
+
|
|
26
|
+
Eventos publicados pelo Control Plane são assíncronos; o lifecycle oficial deve
|
|
27
|
+
adicionar drain explícito antes de shutdown gracioso. O probe aguarda o flush para
|
|
28
|
+
não confundir essa fronteira com perda de dados.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Sprint 15 — Caos determinístico e hardening de segurança
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Transformar falhas previsíveis em estados auditáveis, sem perder evidência nem
|
|
6
|
+
permitir que entradas externas escapem do escopo da execução.
|
|
7
|
+
|
|
8
|
+
## Entregas
|
|
9
|
+
|
|
10
|
+
- approval expirada e reutilização recusadas;
|
|
11
|
+
- corrupção de payload SQLite falha explicitamente;
|
|
12
|
+
- policy continua deny-by-default;
|
|
13
|
+
- caminhos Graph/Git fora da raiz são ignorados;
|
|
14
|
+
- sandbox não herda secrets arbitrários do ambiente;
|
|
15
|
+
- testes MCP stdio cobrem payload/protocolo em processo real.
|
|
16
|
+
|
|
17
|
+
## Fora do escopo desta fatia
|
|
18
|
+
|
|
19
|
+
Docker escape review, plugins maliciosos, lock SQLite sob concorrência,
|
|
20
|
+
checkpoint rollback automático, fuzzing de payload e benchmark de tokens. Esses
|
|
21
|
+
casos continuam como bloqueios de release 10/10, embora os gates básicos já
|
|
22
|
+
estejam cobertos.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Sprint 16 — Última milha verificável
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Fechar três lacunas objetivas da avaliação 10/10 sem criar novos módulos: rollback explícito do sandbox, benchmark reproduzível de contexto e plugins oficiais permissionados.
|
|
6
|
+
|
|
7
|
+
## Escopo
|
|
8
|
+
|
|
9
|
+
- `promoted → rolled_back` no contrato e no `SandboxEngine`;
|
|
10
|
+
- reversão de patch real no `GitWorktreeBackend`;
|
|
11
|
+
- benchmark JSON determinístico em `npm run benchmark:context`;
|
|
12
|
+
- manifests oficiais `@forja/plugin-github` e `@forja/plugin-docker`;
|
|
13
|
+
- testes de contrato, rollback, benchmark e isolamento de permissões.
|
|
14
|
+
|
|
15
|
+
## Critérios de aceite
|
|
16
|
+
|
|
17
|
+
- rollback rejeita sessão que não foi promovida;
|
|
18
|
+
- Git recebe o patch reverso antes da limpeza da worktree;
|
|
19
|
+
- benchmark mede baseline, contexto selecionado, checksum, cache hit e economia;
|
|
20
|
+
- plugins são descobertos pelo `PluginRegistry` e não acessam serviços sem permissão;
|
|
21
|
+
- `npm test -- --test-concurrency=1`, build e `git diff --check` passam.
|
|
22
|
+
|
|
23
|
+
## Fora do escopo
|
|
24
|
+
|
|
25
|
+
Integrações de rede com GitHub, execução de Docker e rollback automático de qualquer comando externo. Esses handlers dependem de adapters do host e continuam governados pelo Policy Engine.
|