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,39 +1,39 @@
|
|
|
1
|
-
# Sprint 2 — Expandir a migração CLI → Capability Registry
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Migrar três comandos de processo para o mesmo adapter da Sprint 1, cobrindo validação de specs,
|
|
6
|
-
consulta de sprint e registro de handoff.
|
|
7
|
-
|
|
8
|
-
## Escopo
|
|
9
|
-
|
|
10
|
-
- `spec:check` → `spec.validate`;
|
|
11
|
-
- `sprint:status` → `sprint.status`;
|
|
12
|
-
- `gsd:handoff` → `handoff.create`;
|
|
13
|
-
- schemas determinísticos e aliases legados;
|
|
14
|
-
- policy para a escrita auditável de handoff;
|
|
15
|
-
- testes de equivalência, validação e bloqueio de input;
|
|
16
|
-
- documentação e atualização do mapa de implementação.
|
|
17
|
-
|
|
18
|
-
Fora do escopo: persistência de runtime, MCP nativo, GraphLoop, sandbox e autonomia.
|
|
19
|
-
|
|
20
|
-
## Critérios de aceite
|
|
21
|
-
|
|
22
|
-
1. Os três IDs aparecem em `capabilities:list` e são descritos por ID ou alias.
|
|
23
|
-
2. Argumentos posicionais legados são convertidos para payloads validados.
|
|
24
|
-
3. `spec:check` e `sprint:status` permanecem operações de leitura.
|
|
25
|
-
4. `gsd:handoff` declara permissão/efeito de escrita e passa pelo Policy Engine.
|
|
26
|
-
5. Entrada inválida não chama o handler.
|
|
27
|
-
6. Toda execução produz `ExecutionResult` e evidência `forja.cli`.
|
|
28
|
-
7. A suíte determinística e o typecheck permanecem verdes.
|
|
29
|
-
|
|
30
|
-
## Impacto
|
|
31
|
-
|
|
32
|
-
Arquivos afetados: `apps/cli/src/index.ts`, testes do adapter, auditoria e documentação. O
|
|
33
|
-
dispatch legado permanece como fallback para comandos ainda não migrados.
|
|
34
|
-
|
|
35
|
-
## Hipóteses
|
|
36
|
-
|
|
37
|
-
- A saída textual dos scripts existentes permanece a fonte de compatibilidade.
|
|
38
|
-
- Handoff é uma operação de baixo risco quando limitado ao registro local e governado por policy.
|
|
39
|
-
- A persistência definitiva do ledger pertence à integração do Runtime, não a esta fatia.
|
|
1
|
+
# Sprint 2 — Expandir a migração CLI → Capability Registry
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Migrar três comandos de processo para o mesmo adapter da Sprint 1, cobrindo validação de specs,
|
|
6
|
+
consulta de sprint e registro de handoff.
|
|
7
|
+
|
|
8
|
+
## Escopo
|
|
9
|
+
|
|
10
|
+
- `spec:check` → `spec.validate`;
|
|
11
|
+
- `sprint:status` → `sprint.status`;
|
|
12
|
+
- `gsd:handoff` → `handoff.create`;
|
|
13
|
+
- schemas determinísticos e aliases legados;
|
|
14
|
+
- policy para a escrita auditável de handoff;
|
|
15
|
+
- testes de equivalência, validação e bloqueio de input;
|
|
16
|
+
- documentação e atualização do mapa de implementação.
|
|
17
|
+
|
|
18
|
+
Fora do escopo: persistência de runtime, MCP nativo, GraphLoop, sandbox e autonomia.
|
|
19
|
+
|
|
20
|
+
## Critérios de aceite
|
|
21
|
+
|
|
22
|
+
1. Os três IDs aparecem em `capabilities:list` e são descritos por ID ou alias.
|
|
23
|
+
2. Argumentos posicionais legados são convertidos para payloads validados.
|
|
24
|
+
3. `spec:check` e `sprint:status` permanecem operações de leitura.
|
|
25
|
+
4. `gsd:handoff` declara permissão/efeito de escrita e passa pelo Policy Engine.
|
|
26
|
+
5. Entrada inválida não chama o handler.
|
|
27
|
+
6. Toda execução produz `ExecutionResult` e evidência `forja.cli`.
|
|
28
|
+
7. A suíte determinística e o typecheck permanecem verdes.
|
|
29
|
+
|
|
30
|
+
## Impacto
|
|
31
|
+
|
|
32
|
+
Arquivos afetados: `apps/cli/src/index.ts`, testes do adapter, auditoria e documentação. O
|
|
33
|
+
dispatch legado permanece como fallback para comandos ainda não migrados.
|
|
34
|
+
|
|
35
|
+
## Hipóteses
|
|
36
|
+
|
|
37
|
+
- A saída textual dos scripts existentes permanece a fonte de compatibilidade.
|
|
38
|
+
- Handoff é uma operação de baixo risco quando limitado ao registro local e governado por policy.
|
|
39
|
+
- A persistência definitiva do ledger pertence à integração do Runtime, não a esta fatia.
|
|
@@ -1,42 +1,42 @@
|
|
|
1
|
-
# Sprint 3 — Runtime persistente e retomável
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Fazer o Runtime sobreviver ao encerramento do processo, preservando execução, plano, resultados,
|
|
6
|
-
cursor, orçamento, evidências e checkpoints em SQLite.
|
|
7
|
-
|
|
8
|
-
## Escopo
|
|
9
|
-
|
|
10
|
-
- porta `RuntimePersistence` independente de banco;
|
|
11
|
-
- tabelas SQLite versionadas para runs, planos, resultados e estado;
|
|
12
|
-
- `SqliteRuntimePersistence` no adapter oficial;
|
|
13
|
-
- recuperação explícita com policy fornecida novamente;
|
|
14
|
-
- backend NestJS usando SQLite no bootstrap oficial;
|
|
15
|
-
- teste de pausa → fechamento do banco → novo engine → retomada;
|
|
16
|
-
- migração idempotente e não destrutiva.
|
|
17
|
-
|
|
18
|
-
Fora do escopo: persistência de approvals, GraphLoop, sandbox, MCP nativo e execução paralela.
|
|
19
|
-
|
|
20
|
-
## Critérios de aceite
|
|
21
|
-
|
|
22
|
-
1. `RuntimeEngine` persiste alterações sem importar SQLite.
|
|
23
|
-
2. Plano, resultados e próximo passo são recuperáveis por `runId`.
|
|
24
|
-
3. Uma execução pausada pode ser retomada por uma nova instância do engine.
|
|
25
|
-
4. Policy não é serializada como código; a recuperação exige policy ativa do processo.
|
|
26
|
-
5. Bootstrap NestJS inicializa migrações e usa SQLite por padrão.
|
|
27
|
-
6. Migrações podem ser reaplicadas sem duplicar estruturas ou dados.
|
|
28
|
-
7. Testes existentes e teste de reinício passam.
|
|
29
|
-
|
|
30
|
-
## Impacto
|
|
31
|
-
|
|
32
|
-
Afetados: `packages/runtime`, `packages/adapter-sqlite`, `apps/server` e testes. Nenhum pacote de
|
|
33
|
-
domínio conhece `better-sqlite3` ou SQL.
|
|
34
|
-
|
|
35
|
-
## Riscos e hipóteses
|
|
36
|
-
|
|
37
|
-
- O processo deve fornecer a mesma policy/configuração ao recuperar uma execução; políticas não
|
|
38
|
-
são serializadas como funções.
|
|
39
|
-
- Persistência síncrona do adapter SQLite é aceitável para a primeira distribuição local-first;
|
|
40
|
-
backend assíncrono substituível permanece possível pela porta.
|
|
41
|
-
- Cancelamento durante uma capability em andamento continua dependente do handler e não é
|
|
42
|
-
interrompido à força.
|
|
1
|
+
# Sprint 3 — Runtime persistente e retomável
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Fazer o Runtime sobreviver ao encerramento do processo, preservando execução, plano, resultados,
|
|
6
|
+
cursor, orçamento, evidências e checkpoints em SQLite.
|
|
7
|
+
|
|
8
|
+
## Escopo
|
|
9
|
+
|
|
10
|
+
- porta `RuntimePersistence` independente de banco;
|
|
11
|
+
- tabelas SQLite versionadas para runs, planos, resultados e estado;
|
|
12
|
+
- `SqliteRuntimePersistence` no adapter oficial;
|
|
13
|
+
- recuperação explícita com policy fornecida novamente;
|
|
14
|
+
- backend NestJS usando SQLite no bootstrap oficial;
|
|
15
|
+
- teste de pausa → fechamento do banco → novo engine → retomada;
|
|
16
|
+
- migração idempotente e não destrutiva.
|
|
17
|
+
|
|
18
|
+
Fora do escopo: persistência de approvals, GraphLoop, sandbox, MCP nativo e execução paralela.
|
|
19
|
+
|
|
20
|
+
## Critérios de aceite
|
|
21
|
+
|
|
22
|
+
1. `RuntimeEngine` persiste alterações sem importar SQLite.
|
|
23
|
+
2. Plano, resultados e próximo passo são recuperáveis por `runId`.
|
|
24
|
+
3. Uma execução pausada pode ser retomada por uma nova instância do engine.
|
|
25
|
+
4. Policy não é serializada como código; a recuperação exige policy ativa do processo.
|
|
26
|
+
5. Bootstrap NestJS inicializa migrações e usa SQLite por padrão.
|
|
27
|
+
6. Migrações podem ser reaplicadas sem duplicar estruturas ou dados.
|
|
28
|
+
7. Testes existentes e teste de reinício passam.
|
|
29
|
+
|
|
30
|
+
## Impacto
|
|
31
|
+
|
|
32
|
+
Afetados: `packages/runtime`, `packages/adapter-sqlite`, `apps/server` e testes. Nenhum pacote de
|
|
33
|
+
domínio conhece `better-sqlite3` ou SQL.
|
|
34
|
+
|
|
35
|
+
## Riscos e hipóteses
|
|
36
|
+
|
|
37
|
+
- O processo deve fornecer a mesma policy/configuração ao recuperar uma execução; políticas não
|
|
38
|
+
são serializadas como funções.
|
|
39
|
+
- Persistência síncrona do adapter SQLite é aceitável para a primeira distribuição local-first;
|
|
40
|
+
backend assíncrono substituível permanece possível pela porta.
|
|
41
|
+
- Cancelamento durante uma capability em andamento continua dependente do handler e não é
|
|
42
|
+
interrompido à força.
|
|
@@ -1,35 +1,35 @@
|
|
|
1
|
-
# Sprint 4 — MCP nativo sobre o Capability Registry
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Disponibilizar o catálogo de capabilities por MCP sem duplicar ferramentas, handlers ou regras de
|
|
6
|
-
policy, incluindo um transporte local JSON-RPC por stdio.
|
|
7
|
-
|
|
8
|
-
## Escopo
|
|
9
|
-
|
|
10
|
-
- `forja mcp:start`;
|
|
11
|
-
- `tools/list`, `tools/call`, `resources/list`, `resources/read` e `initialize`;
|
|
12
|
-
- `forja_capability_describe`;
|
|
13
|
-
- ferramentas dinâmicas derivadas dos IDs visíveis no registry;
|
|
14
|
-
- execução dinâmica delegada ao mesmo `CapabilityRegistry`;
|
|
15
|
-
- identidade e permissões MCP locais;
|
|
16
|
-
- testes do adapter e smoke test stdio.
|
|
17
|
-
|
|
18
|
-
Fora do escopo: transporte HTTP/SSE MCP, autenticação remota, GraphLoop persistente e aprovação
|
|
19
|
-
interativa de ações críticas.
|
|
20
|
-
|
|
21
|
-
## Critérios de aceite
|
|
22
|
-
|
|
23
|
-
1. `mcp:start` responde JSON-RPC por linha sem depender de provedor externo.
|
|
24
|
-
2. `tools/list` contém ferramentas fixas e uma ferramenta derivada por capability visível.
|
|
25
|
-
3. `forja_capability_describe` retorna a definição versionada do registry.
|
|
26
|
-
4. Execução dinâmica retorna `ExecutionResult` e passa pelo Policy Engine.
|
|
27
|
-
5. Recursos MCP continuam disponíveis e erros são normalizados.
|
|
28
|
-
6. Nenhuma regra de domínio é implementada dentro do transporte stdio.
|
|
29
|
-
|
|
30
|
-
## Riscos e hipóteses
|
|
31
|
-
|
|
32
|
-
- O transporte stdio implementa o subconjunto local necessário para a operação do Forja; clientes
|
|
33
|
-
que exigirem recursos MCP adicionais ficam para uma sprint própria.
|
|
34
|
-
- Schemas de payload específicos ainda são genéricos porque `CapabilityDefinition` não carrega um
|
|
35
|
-
schema de input serializável; a validação definitiva continua no registry.
|
|
1
|
+
# Sprint 4 — MCP nativo sobre o Capability Registry
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Disponibilizar o catálogo de capabilities por MCP sem duplicar ferramentas, handlers ou regras de
|
|
6
|
+
policy, incluindo um transporte local JSON-RPC por stdio.
|
|
7
|
+
|
|
8
|
+
## Escopo
|
|
9
|
+
|
|
10
|
+
- `forja mcp:start`;
|
|
11
|
+
- `tools/list`, `tools/call`, `resources/list`, `resources/read` e `initialize`;
|
|
12
|
+
- `forja_capability_describe`;
|
|
13
|
+
- ferramentas dinâmicas derivadas dos IDs visíveis no registry;
|
|
14
|
+
- execução dinâmica delegada ao mesmo `CapabilityRegistry`;
|
|
15
|
+
- identidade e permissões MCP locais;
|
|
16
|
+
- testes do adapter e smoke test stdio.
|
|
17
|
+
|
|
18
|
+
Fora do escopo: transporte HTTP/SSE MCP, autenticação remota, GraphLoop persistente e aprovação
|
|
19
|
+
interativa de ações críticas.
|
|
20
|
+
|
|
21
|
+
## Critérios de aceite
|
|
22
|
+
|
|
23
|
+
1. `mcp:start` responde JSON-RPC por linha sem depender de provedor externo.
|
|
24
|
+
2. `tools/list` contém ferramentas fixas e uma ferramenta derivada por capability visível.
|
|
25
|
+
3. `forja_capability_describe` retorna a definição versionada do registry.
|
|
26
|
+
4. Execução dinâmica retorna `ExecutionResult` e passa pelo Policy Engine.
|
|
27
|
+
5. Recursos MCP continuam disponíveis e erros são normalizados.
|
|
28
|
+
6. Nenhuma regra de domínio é implementada dentro do transporte stdio.
|
|
29
|
+
|
|
30
|
+
## Riscos e hipóteses
|
|
31
|
+
|
|
32
|
+
- O transporte stdio implementa o subconjunto local necessário para a operação do Forja; clientes
|
|
33
|
+
que exigirem recursos MCP adicionais ficam para uma sprint própria.
|
|
34
|
+
- Schemas de payload específicos ainda são genéricos porque `CapabilityDefinition` não carrega um
|
|
35
|
+
schema de input serializável; a validação definitiva continua no registry.
|
|
@@ -1,31 +1,31 @@
|
|
|
1
|
-
# Sprint 5 — Catálogo padrão, approvals e auditoria MCP
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Fechar a composição oficial do server sobre o mesmo catálogo da CLI e tornar approvals e chamadas
|
|
6
|
-
MCP duráveis e auditáveis em SQLite.
|
|
7
|
-
|
|
8
|
-
## Entregas
|
|
9
|
-
|
|
10
|
-
- `createDefaultCapabilityRegistry` no server com as seis capabilities migradas;
|
|
11
|
-
- `ApprovalStore` no Policy Engine;
|
|
12
|
-
- `SqliteApprovalStore` e migração SQLite v3;
|
|
13
|
-
- `McpAuditSink` e `SqliteMcpAuditSink`;
|
|
14
|
-
- auditoria de sucesso, falha e ferramenta inexistente;
|
|
15
|
-
- server inicializando catálogo, approvals e auditoria no banco do workspace.
|
|
16
|
-
|
|
17
|
-
## Critérios de aceite
|
|
18
|
-
|
|
19
|
-
1. Server e CLI descobrem os mesmos seis IDs.
|
|
20
|
-
2. Approval criado antes do reinício pode ser consultado e decidido depois.
|
|
21
|
-
3. Chamada MCP gera registro de auditoria sem derrubar o transporte se o sink falhar.
|
|
22
|
-
4. Migrações v1–v3 são idempotentes e não destrutivas.
|
|
23
|
-
5. Policy continua bloqueando ações fora do escopo.
|
|
24
|
-
6. Testes, build e release gate passam.
|
|
25
|
-
|
|
26
|
-
## Hipóteses e riscos
|
|
27
|
-
|
|
28
|
-
- O catálogo padrão usa os handlers determinísticos existentes; capabilities futuras devem ser
|
|
29
|
-
registradas no mesmo ponto de composição.
|
|
30
|
-
- A auditoria MCP usa `SqliteAuditStore` existente e não cria um ledger paralelo.
|
|
31
|
-
- `ApprovalLedger` mantém API síncrona nesta primeira distribuição local-first.
|
|
1
|
+
# Sprint 5 — Catálogo padrão, approvals e auditoria MCP
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Fechar a composição oficial do server sobre o mesmo catálogo da CLI e tornar approvals e chamadas
|
|
6
|
+
MCP duráveis e auditáveis em SQLite.
|
|
7
|
+
|
|
8
|
+
## Entregas
|
|
9
|
+
|
|
10
|
+
- `createDefaultCapabilityRegistry` no server com as seis capabilities migradas;
|
|
11
|
+
- `ApprovalStore` no Policy Engine;
|
|
12
|
+
- `SqliteApprovalStore` e migração SQLite v3;
|
|
13
|
+
- `McpAuditSink` e `SqliteMcpAuditSink`;
|
|
14
|
+
- auditoria de sucesso, falha e ferramenta inexistente;
|
|
15
|
+
- server inicializando catálogo, approvals e auditoria no banco do workspace.
|
|
16
|
+
|
|
17
|
+
## Critérios de aceite
|
|
18
|
+
|
|
19
|
+
1. Server e CLI descobrem os mesmos seis IDs.
|
|
20
|
+
2. Approval criado antes do reinício pode ser consultado e decidido depois.
|
|
21
|
+
3. Chamada MCP gera registro de auditoria sem derrubar o transporte se o sink falhar.
|
|
22
|
+
4. Migrações v1–v3 são idempotentes e não destrutivas.
|
|
23
|
+
5. Policy continua bloqueando ações fora do escopo.
|
|
24
|
+
6. Testes, build e release gate passam.
|
|
25
|
+
|
|
26
|
+
## Hipóteses e riscos
|
|
27
|
+
|
|
28
|
+
- O catálogo padrão usa os handlers determinísticos existentes; capabilities futuras devem ser
|
|
29
|
+
registradas no mesmo ponto de composição.
|
|
30
|
+
- A auditoria MCP usa `SqliteAuditStore` existente e não cria um ledger paralelo.
|
|
31
|
+
- `ApprovalLedger` mantém API síncrona nesta primeira distribuição local-first.
|
|
@@ -1,55 +1,55 @@
|
|
|
1
|
-
# Sprint 6 — Eventos persistentes e prova operacional
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Conectar o Event Bus ao server oficial com log SQLite append-only e comprovar,
|
|
6
|
-
em um cenário determinístico, o fluxo supervisionado approval → sandbox →
|
|
7
|
-
runtime → validator → evento persistido.
|
|
8
|
-
|
|
9
|
-
## Escopo
|
|
10
|
-
|
|
11
|
-
- hidratação do Event Bus a partir do store ao iniciar;
|
|
12
|
-
- idempotência e sequência por aggregate após reinício;
|
|
13
|
-
- persistência de eventos publicados pelo Control Plane no SQLite do workspace;
|
|
14
|
-
- prova E2E sem provedor de LLM, usando capability e sandbox simuladas;
|
|
15
|
-
- teste de aprovação, retomada, validação e registro de `execution.completed`.
|
|
16
|
-
|
|
17
|
-
## Fora do escopo
|
|
18
|
-
|
|
19
|
-
- substituir o stream SSE em memória por broker externo;
|
|
20
|
-
- persistir subscriptions e dead letters entre processos;
|
|
21
|
-
- implementar o backend Git worktree real;
|
|
22
|
-
- integrar GraphLoop SQLite ou dashboard operacional.
|
|
23
|
-
|
|
24
|
-
## Tarefas verificáveis
|
|
25
|
-
|
|
26
|
-
1. Carregar eventos existentes antes de gerar sequência ou aceitar idempotency key.
|
|
27
|
-
2. Instanciar `EventBus(SqliteEventStore)` no bootstrap NestJS.
|
|
28
|
-
3. Encaminhar eventos do Control Plane para SSE e log durável.
|
|
29
|
-
4. Executar a fixture de teste falho com aprovação humana e sandbox isolada.
|
|
30
|
-
5. Validar aceitação independentemente do handler implementador.
|
|
31
|
-
6. Rodar testes, typecheck, build e release gate.
|
|
32
|
-
|
|
33
|
-
## Critérios de aceite
|
|
34
|
-
|
|
35
|
-
- duas instâncias do Event Bus sobre o mesmo SQLite preservam sequência e
|
|
36
|
-
idempotência;
|
|
37
|
-
- server inicializa runtime, approvals, MCP audit e eventos no mesmo banco;
|
|
38
|
-
- a prova E2E termina somente após aprovação e validator `accepted`;
|
|
39
|
-
- a prova registra um evento `execution.completed` persistido;
|
|
40
|
-
- nenhum teste depende de LLM, rede ou estado externo;
|
|
41
|
-
- documentação e ADR registram limites conhecidos.
|
|
42
|
-
|
|
43
|
-
## Evidências esperadas
|
|
44
|
-
|
|
45
|
-
- `test/events-scheduler.test.js`;
|
|
46
|
-
- `test/autonomy-e2e.test.js`;
|
|
47
|
-
- `packages/events/src/index.ts`;
|
|
48
|
-
- `apps/server/src/main.ts`;
|
|
49
|
-
- saída de `npm test`, `tsc --noEmit`, `npm run build` e
|
|
50
|
-
`npm run release:check`.
|
|
51
|
-
|
|
52
|
-
## Próxima dependência
|
|
53
|
-
|
|
54
|
-
A próxima sprint deve persistir o GraphLoop e ligar suas evidências ao mesmo
|
|
55
|
-
fluxo de execução, mantendo o Event Bus como trilha de integração.
|
|
1
|
+
# Sprint 6 — Eventos persistentes e prova operacional
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Conectar o Event Bus ao server oficial com log SQLite append-only e comprovar,
|
|
6
|
+
em um cenário determinístico, o fluxo supervisionado approval → sandbox →
|
|
7
|
+
runtime → validator → evento persistido.
|
|
8
|
+
|
|
9
|
+
## Escopo
|
|
10
|
+
|
|
11
|
+
- hidratação do Event Bus a partir do store ao iniciar;
|
|
12
|
+
- idempotência e sequência por aggregate após reinício;
|
|
13
|
+
- persistência de eventos publicados pelo Control Plane no SQLite do workspace;
|
|
14
|
+
- prova E2E sem provedor de LLM, usando capability e sandbox simuladas;
|
|
15
|
+
- teste de aprovação, retomada, validação e registro de `execution.completed`.
|
|
16
|
+
|
|
17
|
+
## Fora do escopo
|
|
18
|
+
|
|
19
|
+
- substituir o stream SSE em memória por broker externo;
|
|
20
|
+
- persistir subscriptions e dead letters entre processos;
|
|
21
|
+
- implementar o backend Git worktree real;
|
|
22
|
+
- integrar GraphLoop SQLite ou dashboard operacional.
|
|
23
|
+
|
|
24
|
+
## Tarefas verificáveis
|
|
25
|
+
|
|
26
|
+
1. Carregar eventos existentes antes de gerar sequência ou aceitar idempotency key.
|
|
27
|
+
2. Instanciar `EventBus(SqliteEventStore)` no bootstrap NestJS.
|
|
28
|
+
3. Encaminhar eventos do Control Plane para SSE e log durável.
|
|
29
|
+
4. Executar a fixture de teste falho com aprovação humana e sandbox isolada.
|
|
30
|
+
5. Validar aceitação independentemente do handler implementador.
|
|
31
|
+
6. Rodar testes, typecheck, build e release gate.
|
|
32
|
+
|
|
33
|
+
## Critérios de aceite
|
|
34
|
+
|
|
35
|
+
- duas instâncias do Event Bus sobre o mesmo SQLite preservam sequência e
|
|
36
|
+
idempotência;
|
|
37
|
+
- server inicializa runtime, approvals, MCP audit e eventos no mesmo banco;
|
|
38
|
+
- a prova E2E termina somente após aprovação e validator `accepted`;
|
|
39
|
+
- a prova registra um evento `execution.completed` persistido;
|
|
40
|
+
- nenhum teste depende de LLM, rede ou estado externo;
|
|
41
|
+
- documentação e ADR registram limites conhecidos.
|
|
42
|
+
|
|
43
|
+
## Evidências esperadas
|
|
44
|
+
|
|
45
|
+
- `test/events-scheduler.test.js`;
|
|
46
|
+
- `test/autonomy-e2e.test.js`;
|
|
47
|
+
- `packages/events/src/index.ts`;
|
|
48
|
+
- `apps/server/src/main.ts`;
|
|
49
|
+
- saída de `npm test`, `tsc --noEmit`, `npm run build` e
|
|
50
|
+
`npm run release:check`.
|
|
51
|
+
|
|
52
|
+
## Próxima dependência
|
|
53
|
+
|
|
54
|
+
A próxima sprint deve persistir o GraphLoop e ligar suas evidências ao mesmo
|
|
55
|
+
fluxo de execução, mantendo o Event Bus como trilha de integração.
|
|
@@ -1,60 +1,60 @@
|
|
|
1
|
-
# Sprint 7 — GraphLoop persistente e evidências de execução
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Substituir o store oficial em memória do GraphLoop por uma porta de domínio com
|
|
6
|
-
adapter SQLite, preservar as invariantes de evidência e checksum e registrar no
|
|
7
|
-
grafo as relações produzidas por execuções do Runtime.
|
|
8
|
-
|
|
9
|
-
## Análise de impacto
|
|
10
|
-
|
|
11
|
-
- `packages/graph`: passa a depender de `GraphStore`, sem conhecer SQLite.
|
|
12
|
-
- `packages/adapter-sqlite`: recebe migração v4 e `SqliteGraphStore`.
|
|
13
|
-
- `apps/server`: compõe MCP e Runtime com o mesmo GraphLoop SQLite.
|
|
14
|
-
- `packages/runtime`: não é alterado conceitualmente; usa a porta existente
|
|
15
|
-
`RuntimeMemory` por meio de um adapter em `packages/graph`.
|
|
16
|
-
- Context Engine permanece consumindo fontes por porta; a seleção semântica
|
|
17
|
-
completa sobre nós e trechos é escopo posterior.
|
|
18
|
-
|
|
19
|
-
## Escopo
|
|
20
|
-
|
|
21
|
-
- nós, arestas, evidências e checksums de origem persistidos;
|
|
22
|
-
- tabelas preparatórias para claims, contradições, agenda e extrações;
|
|
23
|
-
- recuperação após reconstrução do `GraphLoop`;
|
|
24
|
-
- consultas, path e impacto sobre dados SQLite;
|
|
25
|
-
- memória de execução com relação `Execution PRODUCES Capability` auditada.
|
|
26
|
-
|
|
27
|
-
## Fora do escopo
|
|
28
|
-
|
|
29
|
-
- banco externo ou consultas assíncronas;
|
|
30
|
-
- inferência por LLM;
|
|
31
|
-
- detecção avançada de contradições além das regras existentes;
|
|
32
|
-
- indexação automática de todo workspace no bootstrap;
|
|
33
|
-
- dashboard novo.
|
|
34
|
-
|
|
35
|
-
## Critérios de aceite
|
|
36
|
-
|
|
37
|
-
1. Migrações v1–v4 são idempotentes e não destrutivas.
|
|
38
|
-
2. `SqliteGraphStore` satisfaz a porta usada pelo domínio e não importa NestJS.
|
|
39
|
-
3. Nós, evidências, arestas e checksum sobrevivem à recriação do GraphLoop.
|
|
40
|
-
4. A segunda aplicação da mesma fonte é ignorada por checksum.
|
|
41
|
-
5. Nenhuma aresta é salva sem endpoints e evidência existente.
|
|
42
|
-
6. Runtime pode registrar uma execução como relação verificável no grafo.
|
|
43
|
-
7. Server usa o GraphLoop SQLite para MCP e Runtime.
|
|
44
|
-
|
|
45
|
-
## Hipóteses e riscos
|
|
46
|
-
|
|
47
|
-
- A API síncrona atual do GraphLoop é mantida para preservar os consumidores
|
|
48
|
-
existentes e adequar-se ao SQLite local.
|
|
49
|
-
- Tabelas de claims/contradições/agenda/extractions são fundação de schema, não
|
|
50
|
-
significam que seus engines estejam persistentes nesta sprint.
|
|
51
|
-
- A prova de execução registra evidências já produzidas pelo handler; não cria
|
|
52
|
-
evidência artificial para ações sem prova.
|
|
53
|
-
|
|
54
|
-
## Evidências
|
|
55
|
-
|
|
56
|
-
- `packages/graph/src/index.ts`;
|
|
57
|
-
- `packages/adapter-sqlite/src/index.ts`;
|
|
58
|
-
- `apps/server/src/main.ts`;
|
|
59
|
-
- `test/graph.test.js`;
|
|
60
|
-
- `test/adapter-sqlite.test.js`.
|
|
1
|
+
# Sprint 7 — GraphLoop persistente e evidências de execução
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Substituir o store oficial em memória do GraphLoop por uma porta de domínio com
|
|
6
|
+
adapter SQLite, preservar as invariantes de evidência e checksum e registrar no
|
|
7
|
+
grafo as relações produzidas por execuções do Runtime.
|
|
8
|
+
|
|
9
|
+
## Análise de impacto
|
|
10
|
+
|
|
11
|
+
- `packages/graph`: passa a depender de `GraphStore`, sem conhecer SQLite.
|
|
12
|
+
- `packages/adapter-sqlite`: recebe migração v4 e `SqliteGraphStore`.
|
|
13
|
+
- `apps/server`: compõe MCP e Runtime com o mesmo GraphLoop SQLite.
|
|
14
|
+
- `packages/runtime`: não é alterado conceitualmente; usa a porta existente
|
|
15
|
+
`RuntimeMemory` por meio de um adapter em `packages/graph`.
|
|
16
|
+
- Context Engine permanece consumindo fontes por porta; a seleção semântica
|
|
17
|
+
completa sobre nós e trechos é escopo posterior.
|
|
18
|
+
|
|
19
|
+
## Escopo
|
|
20
|
+
|
|
21
|
+
- nós, arestas, evidências e checksums de origem persistidos;
|
|
22
|
+
- tabelas preparatórias para claims, contradições, agenda e extrações;
|
|
23
|
+
- recuperação após reconstrução do `GraphLoop`;
|
|
24
|
+
- consultas, path e impacto sobre dados SQLite;
|
|
25
|
+
- memória de execução com relação `Execution PRODUCES Capability` auditada.
|
|
26
|
+
|
|
27
|
+
## Fora do escopo
|
|
28
|
+
|
|
29
|
+
- banco externo ou consultas assíncronas;
|
|
30
|
+
- inferência por LLM;
|
|
31
|
+
- detecção avançada de contradições além das regras existentes;
|
|
32
|
+
- indexação automática de todo workspace no bootstrap;
|
|
33
|
+
- dashboard novo.
|
|
34
|
+
|
|
35
|
+
## Critérios de aceite
|
|
36
|
+
|
|
37
|
+
1. Migrações v1–v4 são idempotentes e não destrutivas.
|
|
38
|
+
2. `SqliteGraphStore` satisfaz a porta usada pelo domínio e não importa NestJS.
|
|
39
|
+
3. Nós, evidências, arestas e checksum sobrevivem à recriação do GraphLoop.
|
|
40
|
+
4. A segunda aplicação da mesma fonte é ignorada por checksum.
|
|
41
|
+
5. Nenhuma aresta é salva sem endpoints e evidência existente.
|
|
42
|
+
6. Runtime pode registrar uma execução como relação verificável no grafo.
|
|
43
|
+
7. Server usa o GraphLoop SQLite para MCP e Runtime.
|
|
44
|
+
|
|
45
|
+
## Hipóteses e riscos
|
|
46
|
+
|
|
47
|
+
- A API síncrona atual do GraphLoop é mantida para preservar os consumidores
|
|
48
|
+
existentes e adequar-se ao SQLite local.
|
|
49
|
+
- Tabelas de claims/contradições/agenda/extractions são fundação de schema, não
|
|
50
|
+
significam que seus engines estejam persistentes nesta sprint.
|
|
51
|
+
- A prova de execução registra evidências já produzidas pelo handler; não cria
|
|
52
|
+
evidência artificial para ações sem prova.
|
|
53
|
+
|
|
54
|
+
## Evidências
|
|
55
|
+
|
|
56
|
+
- `packages/graph/src/index.ts`;
|
|
57
|
+
- `packages/adapter-sqlite/src/index.ts`;
|
|
58
|
+
- `apps/server/src/main.ts`;
|
|
59
|
+
- `test/graph.test.js`;
|
|
60
|
+
- `test/adapter-sqlite.test.js`.
|