forjajs 2.0.4 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +133 -133
- package/CHANGELOG.md +619 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +64 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +15 -0
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.js +27 -4
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +32 -3
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -157
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/cost-aware-autonomy-budget/spec.md +102 -0
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/spec.md +23 -23
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
# ADR-0057 — GraphLoop e approvals no dashboard por portas do Control Plane
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: A interface precisava tornar relações e aprovações operacionais sem reproduzir algoritmos do domínio nem criar decisões no cliente.
|
|
6
|
-
- **Decisão**: O adapter Nest expõe consulta de nós, impacto e listagem de approvals; o dashboard renderiza nós/status e impacto sob demanda, além de listar decisões pendentes/finais. GraphLoop continua no pacote de domínio e Policy continua no backend.
|
|
7
|
-
- **Regras**:
|
|
8
|
-
- toda relação exibida vem da API e preserva status/evidência do GraphLoop;
|
|
9
|
-
- impacto exige um ID de origem explícito;
|
|
10
|
-
- approvals são somente leitura nesta fatia; decisão deve usar identidade/aprovador configurado;
|
|
11
|
-
- nenhuma heurística de grafo é executada no React;
|
|
12
|
-
- endpoints entram na allowlist do proxy, nunca em proxy genérico.
|
|
13
|
-
- **Alternativas rejeitadas**: importar GraphLoop para o browser; renderizar arestas inventadas; aprovar sem identidade explícita; consultar SQLite no dashboard.
|
|
14
|
-
- **Consequências**: A UI já permite inspeção operacional básica offline/remota. Visualização espacial avançada, evidências detalhadas e fluxo de aprovação autenticado continuam etapas posteriores.
|
|
15
|
-
- **Evidências**: `packages/adapter-nest/src/index.ts`, `packages/policy/src/index.ts`, `apps/dashboard/app/dashboard-client.tsx`, `apps/dashboard/app/api/forja/[...path]/route.ts`, 265 testes.
|
|
1
|
+
# ADR-0057 — GraphLoop e approvals no dashboard por portas do Control Plane
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: A interface precisava tornar relações e aprovações operacionais sem reproduzir algoritmos do domínio nem criar decisões no cliente.
|
|
6
|
+
- **Decisão**: O adapter Nest expõe consulta de nós, impacto e listagem de approvals; o dashboard renderiza nós/status e impacto sob demanda, além de listar decisões pendentes/finais. GraphLoop continua no pacote de domínio e Policy continua no backend.
|
|
7
|
+
- **Regras**:
|
|
8
|
+
- toda relação exibida vem da API e preserva status/evidência do GraphLoop;
|
|
9
|
+
- impacto exige um ID de origem explícito;
|
|
10
|
+
- approvals são somente leitura nesta fatia; decisão deve usar identidade/aprovador configurado;
|
|
11
|
+
- nenhuma heurística de grafo é executada no React;
|
|
12
|
+
- endpoints entram na allowlist do proxy, nunca em proxy genérico.
|
|
13
|
+
- **Alternativas rejeitadas**: importar GraphLoop para o browser; renderizar arestas inventadas; aprovar sem identidade explícita; consultar SQLite no dashboard.
|
|
14
|
+
- **Consequências**: A UI já permite inspeção operacional básica offline/remota. Visualização espacial avançada, evidências detalhadas e fluxo de aprovação autenticado continuam etapas posteriores.
|
|
15
|
+
- **Evidências**: `packages/adapter-nest/src/index.ts`, `packages/policy/src/index.ts`, `apps/dashboard/app/dashboard-client.tsx`, `apps/dashboard/app/api/forja/[...path]/route.ts`, 265 testes.
|
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
# ADR-0058 — Decisão de approval com identidade server-side
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: O dashboard precisava responder approvals sem permitir que o cliente escolhesse ou falsificasse o aprovador.
|
|
6
|
-
- **Decisão**: O cliente envia somente `approved` ou `rejected`. O Route Handler valida o valor, exige `FORJA_APPROVER_ID`, injeta o aprovador e timestamp, e encaminha a decisão ao Control Plane usando o token server-side.
|
|
7
|
-
- **Regras**:
|
|
8
|
-
- ausência de `FORJA_APPROVER_ID` retorna configuração indisponível;
|
|
9
|
-
- qualquer decisão fora do enum é rejeitada;
|
|
10
|
-
- o valor de `approverId` vindo do cliente é ignorado;
|
|
11
|
-
- Policy/ApprovalLedger continuam responsáveis por validade, expiração e idempotência semântica;
|
|
12
|
-
- a UI não exibe nem recebe segredo de autenticação.
|
|
13
|
-
- **Alternativas rejeitadas**: aceitar aprovador no body do browser; usar identidade fixa inventada; aprovar automaticamente quando não houver configuração.
|
|
14
|
-
- **Consequências**: O dashboard operacional exige configuração explícita do ambiente para decidir approvals. Listagem continua possível sem identidade de decisão.
|
|
15
|
-
- **Evidências**: `apps/dashboard/app/api/forja/approval.ts`, `apps/dashboard/app/api/forja/[...path]/route.ts`, `apps/dashboard/app/dashboard-client.tsx`, `test/dashboard-approval.test.js`, 267 testes.
|
|
1
|
+
# ADR-0058 — Decisão de approval com identidade server-side
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: O dashboard precisava responder approvals sem permitir que o cliente escolhesse ou falsificasse o aprovador.
|
|
6
|
+
- **Decisão**: O cliente envia somente `approved` ou `rejected`. O Route Handler valida o valor, exige `FORJA_APPROVER_ID`, injeta o aprovador e timestamp, e encaminha a decisão ao Control Plane usando o token server-side.
|
|
7
|
+
- **Regras**:
|
|
8
|
+
- ausência de `FORJA_APPROVER_ID` retorna configuração indisponível;
|
|
9
|
+
- qualquer decisão fora do enum é rejeitada;
|
|
10
|
+
- o valor de `approverId` vindo do cliente é ignorado;
|
|
11
|
+
- Policy/ApprovalLedger continuam responsáveis por validade, expiração e idempotência semântica;
|
|
12
|
+
- a UI não exibe nem recebe segredo de autenticação.
|
|
13
|
+
- **Alternativas rejeitadas**: aceitar aprovador no body do browser; usar identidade fixa inventada; aprovar automaticamente quando não houver configuração.
|
|
14
|
+
- **Consequências**: O dashboard operacional exige configuração explícita do ambiente para decidir approvals. Listagem continua possível sem identidade de decisão.
|
|
15
|
+
- **Evidências**: `apps/dashboard/app/api/forja/approval.ts`, `apps/dashboard/app/api/forja/[...path]/route.ts`, `apps/dashboard/app/dashboard-client.tsx`, `test/dashboard-approval.test.js`, 267 testes.
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# ADR-0059 — CLI como adaptador transitório do Capability Registry
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: o Forja possuía o registry declarativo de comandos em `lib/core/registry.ts` e o
|
|
6
|
-
`CapabilityRegistry` executável em `packages/core`, sem uma ponte operacional entre ambos.
|
|
7
|
-
- **Decisão**: migrar comandos por fatias para `apps/cli/src/index.ts`. Cada capability declara
|
|
8
|
-
contrato, validação, política, alias legado e handler injetado. O binário da CLI somente adapta
|
|
9
|
-
argumentos, invoca o registry e registra o resultado; comandos não migrados preservam o dispatch
|
|
10
|
-
declarativo durante a transição.
|
|
11
|
-
- **Consequências**: CLI, descoberta e execução passam a compartilhar `ExecutionResult`, validação
|
|
12
|
-
e autorização nos comandos migrados. A auditoria JSONL permanece no core executivo até o
|
|
13
|
-
armazenamento de auditoria persistente ser integrado em sprint posterior.
|
|
14
|
-
- **Fora desta decisão**: persistência do runtime, MCP nativo, GraphLoop, sandbox e migração dos
|
|
15
|
-
demais comandos.
|
|
16
|
-
- **Evidência**: `docs/2x/IMPLEMENTATION-AUDIT.md`, `apps/cli/src/index.ts` e
|
|
17
|
-
`test/cli-capability-adapter.test.js`.
|
|
1
|
+
# ADR-0059 — CLI como adaptador transitório do Capability Registry
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o Forja possuía o registry declarativo de comandos em `lib/core/registry.ts` e o
|
|
6
|
+
`CapabilityRegistry` executável em `packages/core`, sem uma ponte operacional entre ambos.
|
|
7
|
+
- **Decisão**: migrar comandos por fatias para `apps/cli/src/index.ts`. Cada capability declara
|
|
8
|
+
contrato, validação, política, alias legado e handler injetado. O binário da CLI somente adapta
|
|
9
|
+
argumentos, invoca o registry e registra o resultado; comandos não migrados preservam o dispatch
|
|
10
|
+
declarativo durante a transição.
|
|
11
|
+
- **Consequências**: CLI, descoberta e execução passam a compartilhar `ExecutionResult`, validação
|
|
12
|
+
e autorização nos comandos migrados. A auditoria JSONL permanece no core executivo até o
|
|
13
|
+
armazenamento de auditoria persistente ser integrado em sprint posterior.
|
|
14
|
+
- **Fora desta decisão**: persistência do runtime, MCP nativo, GraphLoop, sandbox e migração dos
|
|
15
|
+
demais comandos.
|
|
16
|
+
- **Evidência**: `docs/2x/IMPLEMENTATION-AUDIT.md`, `apps/cli/src/index.ts` e
|
|
17
|
+
`test/cli-capability-adapter.test.js`.
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# ADR-0060 — Persistência do Runtime por porta e recuperação explícita
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: `RuntimeEngine` mantinha runs, planos, resultados e cursor em `Map`s. Checkpoints
|
|
6
|
-
SQLite já existiam, mas não eram suficientes para recriar o engine após reinício.
|
|
7
|
-
- **Decisão**: o domínio expõe `RuntimePersistence` com operações para run, plano, resultados e
|
|
8
|
-
cursor. `SqliteRuntimePersistence` implementa a porta usando migração versionada e payloads JSON
|
|
9
|
-
em tabelas próprias. A recuperação recebe a policy ativa explicitamente; funções e dependências
|
|
10
|
-
executáveis nunca são serializadas.
|
|
11
|
-
- **Consequências**: uma nova instância pode recuperar uma execução pausada e continuar do cursor
|
|
12
|
-
persistido. O Runtime permanece independente de SQLite. A persistência síncrona é adequada para
|
|
13
|
-
o backend local-first inicial e a porta permite adapter assíncrono futuro.
|
|
14
|
-
- **Alternativas rejeitadas**: serializar policy/handlers; depender apenas de checkpoints; acoplar
|
|
15
|
-
`packages/runtime` ao driver SQLite.
|
|
16
|
-
- **Evidência**: `packages/runtime/src/index.ts`, `packages/adapter-sqlite/src/index.ts` e
|
|
17
|
-
`test/runtime.test.js`.
|
|
1
|
+
# ADR-0060 — Persistência do Runtime por porta e recuperação explícita
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: `RuntimeEngine` mantinha runs, planos, resultados e cursor em `Map`s. Checkpoints
|
|
6
|
+
SQLite já existiam, mas não eram suficientes para recriar o engine após reinício.
|
|
7
|
+
- **Decisão**: o domínio expõe `RuntimePersistence` com operações para run, plano, resultados e
|
|
8
|
+
cursor. `SqliteRuntimePersistence` implementa a porta usando migração versionada e payloads JSON
|
|
9
|
+
em tabelas próprias. A recuperação recebe a policy ativa explicitamente; funções e dependências
|
|
10
|
+
executáveis nunca são serializadas.
|
|
11
|
+
- **Consequências**: uma nova instância pode recuperar uma execução pausada e continuar do cursor
|
|
12
|
+
persistido. O Runtime permanece independente de SQLite. A persistência síncrona é adequada para
|
|
13
|
+
o backend local-first inicial e a porta permite adapter assíncrono futuro.
|
|
14
|
+
- **Alternativas rejeitadas**: serializar policy/handlers; depender apenas de checkpoints; acoplar
|
|
15
|
+
`packages/runtime` ao driver SQLite.
|
|
16
|
+
- **Evidência**: `packages/runtime/src/index.ts`, `packages/adapter-sqlite/src/index.ts` e
|
|
17
|
+
`test/runtime.test.js`.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
# ADR-0061 — MCP dinâmico sobre o Registry e transporte stdio local
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: o adapter MCP possuía ferramentas fixas e executava capabilities quando o
|
|
6
|
-
consumidor fornecia um registry, mas não expunha `describe` nem descoberta dinâmica dos aliases.
|
|
7
|
-
- **Decisão**: manter ferramentas operacionais fixas para recursos do Forja e adicionar uma
|
|
8
|
-
ferramenta derivada para cada capability visível (`forja_capability_<id>`), além de
|
|
9
|
-
`forja_capability_describe`. `forja mcp:start` fornece transporte JSON-RPC local por stdio e
|
|
10
|
-
delega todas as chamadas ao `McpServer`.
|
|
11
|
-
- **Consequências**: clientes podem descobrir o catálogo sem documentação humana e executar pelo
|
|
12
|
-
mesmo registry usado pela CLI. O transporte não conhece handlers nem implementa regras de
|
|
13
|
-
autorização; schemas detalhados permanecem nos validadores do registry.
|
|
14
|
-
- **Alternativas rejeitadas**: lista manual de cada capability; handler MCP duplicado; servidor
|
|
15
|
-
remoto obrigatório nesta etapa.
|
|
16
|
-
- **Evidência**: `packages/mcp/src/index.ts`, `bin/forja.ts`, `test/mcp.test.js` e o smoke stdio.
|
|
1
|
+
# ADR-0061 — MCP dinâmico sobre o Registry e transporte stdio local
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o adapter MCP possuía ferramentas fixas e executava capabilities quando o
|
|
6
|
+
consumidor fornecia um registry, mas não expunha `describe` nem descoberta dinâmica dos aliases.
|
|
7
|
+
- **Decisão**: manter ferramentas operacionais fixas para recursos do Forja e adicionar uma
|
|
8
|
+
ferramenta derivada para cada capability visível (`forja_capability_<id>`), além de
|
|
9
|
+
`forja_capability_describe`. `forja mcp:start` fornece transporte JSON-RPC local por stdio e
|
|
10
|
+
delega todas as chamadas ao `McpServer`.
|
|
11
|
+
- **Consequências**: clientes podem descobrir o catálogo sem documentação humana e executar pelo
|
|
12
|
+
mesmo registry usado pela CLI. O transporte não conhece handlers nem implementa regras de
|
|
13
|
+
autorização; schemas detalhados permanecem nos validadores do registry.
|
|
14
|
+
- **Alternativas rejeitadas**: lista manual de cada capability; handler MCP duplicado; servidor
|
|
15
|
+
remoto obrigatório nesta etapa.
|
|
16
|
+
- **Evidência**: `packages/mcp/src/index.ts`, `bin/forja.ts`, `test/mcp.test.js` e o smoke stdio.
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# ADR-0062 — Catálogo oficial compartilhado e persistência de approvals/auditoria
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: o server criava `CapabilityRegistry` vazio e approvals/auditoria MCP ficavam em
|
|
6
|
-
memória ou sem sink persistente.
|
|
7
|
-
- **Decisão**: o server constrói o catálogo usando `registerCliCapabilities` e o runner legado
|
|
8
|
-
compartilhado. `ApprovalLedger` recebe a porta `ApprovalStore`, implementada pelo SQLite. MCP
|
|
9
|
-
recebe `McpAuditSink`, adaptado para `SqliteAuditStore`; falha de auditoria não interrompe a
|
|
10
|
-
operação, mas é responsabilidade do sink expor saúde própria.
|
|
11
|
-
- **Consequências**: CLI e server descobrem os mesmos IDs e compartilham handlers; approvals
|
|
12
|
-
sobrevivem a reinício; chamadas MCP deixam trilha persistente. O catálogo ainda é composto em
|
|
13
|
-
memória no boot, enquanto persistência de definições fica adiada.
|
|
14
|
-
- **Alternativas rejeitadas**: catálogo manual separado no server; ledger de approvals duplicado;
|
|
15
|
-
auditoria somente em memória.
|
|
16
|
-
- **Evidência**: `apps/server/src/main.ts`, `packages/policy/src/index.ts`,
|
|
17
|
-
`packages/adapter-sqlite/src/index.ts` e testes Sprint 5.
|
|
1
|
+
# ADR-0062 — Catálogo oficial compartilhado e persistência de approvals/auditoria
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o server criava `CapabilityRegistry` vazio e approvals/auditoria MCP ficavam em
|
|
6
|
+
memória ou sem sink persistente.
|
|
7
|
+
- **Decisão**: o server constrói o catálogo usando `registerCliCapabilities` e o runner legado
|
|
8
|
+
compartilhado. `ApprovalLedger` recebe a porta `ApprovalStore`, implementada pelo SQLite. MCP
|
|
9
|
+
recebe `McpAuditSink`, adaptado para `SqliteAuditStore`; falha de auditoria não interrompe a
|
|
10
|
+
operação, mas é responsabilidade do sink expor saúde própria.
|
|
11
|
+
- **Consequências**: CLI e server descobrem os mesmos IDs e compartilham handlers; approvals
|
|
12
|
+
sobrevivem a reinício; chamadas MCP deixam trilha persistente. O catálogo ainda é composto em
|
|
13
|
+
memória no boot, enquanto persistência de definições fica adiada.
|
|
14
|
+
- **Alternativas rejeitadas**: catálogo manual separado no server; ledger de approvals duplicado;
|
|
15
|
+
auditoria somente em memória.
|
|
16
|
+
- **Evidência**: `apps/server/src/main.ts`, `packages/policy/src/index.ts`,
|
|
17
|
+
`packages/adapter-sqlite/src/index.ts` e testes Sprint 5.
|
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
# ADR-0063 — Event Bus SQLite e prova E2E determinística
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: o Event Bus tinha append, retries e idempotência apenas em memória;
|
|
6
|
-
o server publicava eventos somente no stream SSE e não havia uma prova integrada
|
|
7
|
-
do ciclo supervisionado.
|
|
8
|
-
- **Decisão**: o `EventBus` hidrata idempotência e sequências a partir de qualquer
|
|
9
|
-
`EventStore` antes do primeiro append/list. O bootstrap NestJS usa
|
|
10
|
-
`SqliteEventStore` no banco local e encaminha publicações do Control Plane para
|
|
11
|
-
SSE e persistência. A prova operacional usa capability, sandbox e validator
|
|
12
|
-
determinísticos, sem LLM.
|
|
13
|
-
- **Consequências**: eventos de domínio sobrevivem ao reinício e não duplicam por
|
|
14
|
-
idempotency key; a entrega SSE continua local e efêmera; subscriptions e dead
|
|
15
|
-
letters ainda não são duráveis entre processos.
|
|
16
|
-
- **Alternativas rejeitadas**: broker externo nesta fase; catálogo paralelo de
|
|
17
|
-
eventos; prova baseada em chamada real de modelo.
|
|
18
|
-
- **Evidência**: `packages/events/src/index.ts`, `apps/server/src/main.ts`,
|
|
19
|
-
`test/events-scheduler.test.js` e `test/autonomy-e2e.test.js`.
|
|
1
|
+
# ADR-0063 — Event Bus SQLite e prova E2E determinística
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o Event Bus tinha append, retries e idempotência apenas em memória;
|
|
6
|
+
o server publicava eventos somente no stream SSE e não havia uma prova integrada
|
|
7
|
+
do ciclo supervisionado.
|
|
8
|
+
- **Decisão**: o `EventBus` hidrata idempotência e sequências a partir de qualquer
|
|
9
|
+
`EventStore` antes do primeiro append/list. O bootstrap NestJS usa
|
|
10
|
+
`SqliteEventStore` no banco local e encaminha publicações do Control Plane para
|
|
11
|
+
SSE e persistência. A prova operacional usa capability, sandbox e validator
|
|
12
|
+
determinísticos, sem LLM.
|
|
13
|
+
- **Consequências**: eventos de domínio sobrevivem ao reinício e não duplicam por
|
|
14
|
+
idempotency key; a entrega SSE continua local e efêmera; subscriptions e dead
|
|
15
|
+
letters ainda não são duráveis entre processos.
|
|
16
|
+
- **Alternativas rejeitadas**: broker externo nesta fase; catálogo paralelo de
|
|
17
|
+
eventos; prova baseada em chamada real de modelo.
|
|
18
|
+
- **Evidência**: `packages/events/src/index.ts`, `apps/server/src/main.ts`,
|
|
19
|
+
`test/events-scheduler.test.js` e `test/autonomy-e2e.test.js`.
|
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
# ADR-0064 — GraphLoop com porta de store e SQLite oficial
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: o GraphLoop validava evidências, relações e checksums, mas o
|
|
6
|
-
store padrão era composto apenas por `Map`, fazendo nós e arestas desaparecerem
|
|
7
|
-
após reinício.
|
|
8
|
-
- **Decisão**: o domínio define `GraphStore` síncrono. `InMemoryGraphStore`
|
|
9
|
-
permanece para testes e `SqliteGraphStore` implementa a distribuição oficial.
|
|
10
|
-
A migração v4 cria tabelas dedicadas para nós, arestas, evidências, fontes e
|
|
11
|
-
futuras claims/contradições/agenda/extractions. O server compartilha a mesma
|
|
12
|
-
instância persistente entre MCP e Runtime.
|
|
13
|
-
- **Consequências**: consultas e sincronização incremental sobrevivem a reinício;
|
|
14
|
-
a política de “toda aresta tem endpoints e evidência” continua no core. O
|
|
15
|
-
schema das entidades futuras existe, mas seus engines ainda não persistem
|
|
16
|
-
automaticamente.
|
|
17
|
-
- **Alternativas rejeitadas**: importar SQLite no domínio; substituir a API por
|
|
18
|
-
operações assíncronas nesta fase; manter o server em memória.
|
|
19
|
-
- **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-sqlite/src/index.ts`,
|
|
20
|
-
`apps/server/src/main.ts` e testes da Sprint 7.
|
|
1
|
+
# ADR-0064 — GraphLoop com porta de store e SQLite oficial
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o GraphLoop validava evidências, relações e checksums, mas o
|
|
6
|
+
store padrão era composto apenas por `Map`, fazendo nós e arestas desaparecerem
|
|
7
|
+
após reinício.
|
|
8
|
+
- **Decisão**: o domínio define `GraphStore` síncrono. `InMemoryGraphStore`
|
|
9
|
+
permanece para testes e `SqliteGraphStore` implementa a distribuição oficial.
|
|
10
|
+
A migração v4 cria tabelas dedicadas para nós, arestas, evidências, fontes e
|
|
11
|
+
futuras claims/contradições/agenda/extractions. O server compartilha a mesma
|
|
12
|
+
instância persistente entre MCP e Runtime.
|
|
13
|
+
- **Consequências**: consultas e sincronização incremental sobrevivem a reinício;
|
|
14
|
+
a política de “toda aresta tem endpoints e evidência” continua no core. O
|
|
15
|
+
schema das entidades futuras existe, mas seus engines ainda não persistem
|
|
16
|
+
automaticamente.
|
|
17
|
+
- **Alternativas rejeitadas**: importar SQLite no domínio; substituir a API por
|
|
18
|
+
operações assíncronas nesta fase; manter o server em memória.
|
|
19
|
+
- **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-sqlite/src/index.ts`,
|
|
20
|
+
`apps/server/src/main.ts` e testes da Sprint 7.
|
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
# ADR-0065 — GraphLoop como fonte determinística do Context Engine
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: o Context Engine tinha uma porta genérica de fontes, mas o
|
|
6
|
-
server não a compunha com o GraphLoop persistente; o cache padrão era apenas
|
|
7
|
-
em memória.
|
|
8
|
-
- **Decisão**: `GraphContextSource` adapta uma porta `searchContext` e o
|
|
9
|
-
GraphLoop retorna relações ativas que tenham evidência e coincidam
|
|
10
|
-
deterministicamente com termos do objetivo. `SqliteContextCache` persiste o
|
|
11
|
-
conteúdo por checksum. O bootstrap compartilha o banco entre GraphLoop,
|
|
12
|
-
Context Engine, MCP e Runtime.
|
|
13
|
-
- **Consequências**: contexto mínimo pode ser recuperado offline, com referências
|
|
14
|
-
auditáveis, cache e orçamento. A busca é lexical e compacta; embeddings,
|
|
15
|
-
trechos de arquivos e sumarização ficam para fases posteriores.
|
|
16
|
-
- **Alternativas rejeitadas**: chamar LLM para busca; importar SQLite no pacote
|
|
17
|
-
context; duplicar uma busca de grafo dentro do MCP.
|
|
18
|
-
- **Evidência**: `packages/context/src/index.ts`, `packages/graph/src/index.ts`,
|
|
19
|
-
`packages/adapter-sqlite/src/index.ts`, `apps/server/src/main.ts` e testes da
|
|
20
|
-
Sprint 8.
|
|
1
|
+
# ADR-0065 — GraphLoop como fonte determinística do Context Engine
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o Context Engine tinha uma porta genérica de fontes, mas o
|
|
6
|
+
server não a compunha com o GraphLoop persistente; o cache padrão era apenas
|
|
7
|
+
em memória.
|
|
8
|
+
- **Decisão**: `GraphContextSource` adapta uma porta `searchContext` e o
|
|
9
|
+
GraphLoop retorna relações ativas que tenham evidência e coincidam
|
|
10
|
+
deterministicamente com termos do objetivo. `SqliteContextCache` persiste o
|
|
11
|
+
conteúdo por checksum. O bootstrap compartilha o banco entre GraphLoop,
|
|
12
|
+
Context Engine, MCP e Runtime.
|
|
13
|
+
- **Consequências**: contexto mínimo pode ser recuperado offline, com referências
|
|
14
|
+
auditáveis, cache e orçamento. A busca é lexical e compacta; embeddings,
|
|
15
|
+
trechos de arquivos e sumarização ficam para fases posteriores.
|
|
16
|
+
- **Alternativas rejeitadas**: chamar LLM para busca; importar SQLite no pacote
|
|
17
|
+
context; duplicar uma busca de grafo dentro do MCP.
|
|
18
|
+
- **Evidência**: `packages/context/src/index.ts`, `packages/graph/src/index.ts`,
|
|
19
|
+
`packages/adapter-sqlite/src/index.ts`, `apps/server/src/main.ts` e testes da
|
|
20
|
+
Sprint 8.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
# ADR-0066 — Extração determinística incremental do GraphLoop
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: o extractor inicial cobria somente imports e links Markdown,
|
|
6
|
-
deixando specs, ADRs, tarefas, handoffs, testes e manifests fora do grafo.
|
|
7
|
-
- **Decisão**: ampliar o extractor por padrões explícitos e auditáveis: símbolos,
|
|
8
|
-
chamadas, referências ADR, checkboxes, agentes de handoff, testes e dependências
|
|
9
|
-
de manifest. Cada relação usa uma evidência com locator de linha e é aplicada
|
|
10
|
-
pela mesma mutation com checksum.
|
|
11
|
-
- **Consequências**: consultas de impacto e contexto ganham relações offline sem
|
|
12
|
-
custo de LLM. A resolução semântica completa de TypeScript, aliases, commits e
|
|
13
|
-
diffs permanece fora do extractor lexical.
|
|
14
|
-
- **Alternativas rejeitadas**: inferência por LLM para relações determinísticas;
|
|
15
|
-
parser completo obrigatório nesta etapa; aceitar arestas sem evidência.
|
|
16
|
-
- **Evidência**: `packages/graph/src/index.ts` e `test/graph.test.js`.
|
|
1
|
+
# ADR-0066 — Extração determinística incremental do GraphLoop
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o extractor inicial cobria somente imports e links Markdown,
|
|
6
|
+
deixando specs, ADRs, tarefas, handoffs, testes e manifests fora do grafo.
|
|
7
|
+
- **Decisão**: ampliar o extractor por padrões explícitos e auditáveis: símbolos,
|
|
8
|
+
chamadas, referências ADR, checkboxes, agentes de handoff, testes e dependências
|
|
9
|
+
de manifest. Cada relação usa uma evidência com locator de linha e é aplicada
|
|
10
|
+
pela mesma mutation com checksum.
|
|
11
|
+
- **Consequências**: consultas de impacto e contexto ganham relações offline sem
|
|
12
|
+
custo de LLM. A resolução semântica completa de TypeScript, aliases, commits e
|
|
13
|
+
diffs permanece fora do extractor lexical.
|
|
14
|
+
- **Alternativas rejeitadas**: inferência por LLM para relações determinísticas;
|
|
15
|
+
parser completo obrigatório nesta etapa; aceitar arestas sem evidência.
|
|
16
|
+
- **Evidência**: `packages/graph/src/index.ts` e `test/graph.test.js`.
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# ADR-0067 — Indexação GraphLoop por fonte Git e capability `graph.sync`
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: extractors determinísticos existiam, mas não havia uma operação
|
|
6
|
-
incremental que lesse o workspace e aplicasse mutations ao GraphLoop.
|
|
7
|
-
- **Decisão**: `GraphIndexer` recebe uma porta `GraphDocumentSource`; o adapter
|
|
8
|
-
`GitGraphDocumentSource` usa `git ls-files` e leitura local limitada; a
|
|
9
|
-
capability `graph.sync` executa o indexador, retorna contagens estruturadas e
|
|
10
|
-
gera evidência. O server compõe essa capability sobre `SqliteGraphStore`.
|
|
11
|
-
- **Consequências**: indexação local é reproduzível, incremental e sem LLM;
|
|
12
|
-
arquivos ignorados ficam fora. Remoções, commits e diffs exigem uma próxima
|
|
13
|
-
evolução para não introduzir poda ou histórico incorreto nesta fase.
|
|
14
|
-
- **Alternativas rejeitadas**: varrer recursivamente sem respeitar `.gitignore`;
|
|
15
|
-
indexar conteúdo binário; criar um segundo registry específico para o grafo.
|
|
16
|
-
- **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-git/src/index.ts`,
|
|
17
|
-
`apps/cli/src/index.ts`, `apps/server/src/main.ts` e testes Sprint 10.
|
|
1
|
+
# ADR-0067 — Indexação GraphLoop por fonte Git e capability `graph.sync`
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: extractors determinísticos existiam, mas não havia uma operação
|
|
6
|
+
incremental que lesse o workspace e aplicasse mutations ao GraphLoop.
|
|
7
|
+
- **Decisão**: `GraphIndexer` recebe uma porta `GraphDocumentSource`; o adapter
|
|
8
|
+
`GitGraphDocumentSource` usa `git ls-files` e leitura local limitada; a
|
|
9
|
+
capability `graph.sync` executa o indexador, retorna contagens estruturadas e
|
|
10
|
+
gera evidência. O server compõe essa capability sobre `SqliteGraphStore`.
|
|
11
|
+
- **Consequências**: indexação local é reproduzível, incremental e sem LLM;
|
|
12
|
+
arquivos ignorados ficam fora. Remoções, commits e diffs exigem uma próxima
|
|
13
|
+
evolução para não introduzir poda ou histórico incorreto nesta fase.
|
|
14
|
+
- **Alternativas rejeitadas**: varrer recursivamente sem respeitar `.gitignore`;
|
|
15
|
+
indexar conteúdo binário; criar um segundo registry específico para o grafo.
|
|
16
|
+
- **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-git/src/index.ts`,
|
|
17
|
+
`apps/cli/src/index.ts`, `apps/server/src/main.ts` e testes Sprint 10.
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# ADR-0068 — Graph sync compartilhado entre CLI e MCP
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-08-01
|
|
5
|
-
- **Contexto**: `graph.sync` estava registrável no server, mas o dispatch
|
|
6
|
-
standalone e o MCP stdio ainda criavam somente o catálogo legado.
|
|
7
|
-
- **Decisão**: `graph:sync` declara `capability: graph.sync` no registry do core;
|
|
8
|
-
o adaptador CLI recebe uma composição opcional GraphLoop + Git source e registra
|
|
9
|
-
o mesmo handler. O MCP stdio usa essa composição e descobre a ferramenta
|
|
10
|
-
dinâmica automaticamente. O resultado inclui contagens, arquivos e duração.
|
|
11
|
-
- **Consequências**: CLI, MCP e server compartilham execução e policy; a CLI
|
|
12
|
-
mantém um resumo humano e o envelope JSON. O banco local é aberto pela
|
|
13
|
-
composição do processo e usa as migrações existentes.
|
|
14
|
-
- **Alternativas rejeitadas**: duplicar um handler em `bin/forja`; manter lista
|
|
15
|
-
manual de ferramenta MCP; indexar sem `.gitignore`.
|
|
16
|
-
- **Evidência**: `lib/core/registry.ts`, `apps/cli/src/index.ts`, `bin/forja.ts`,
|
|
17
|
-
`packages/graph/src/index.ts` e testes Sprint 11.
|
|
1
|
+
# ADR-0068 — Graph sync compartilhado entre CLI e MCP
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: `graph.sync` estava registrável no server, mas o dispatch
|
|
6
|
+
standalone e o MCP stdio ainda criavam somente o catálogo legado.
|
|
7
|
+
- **Decisão**: `graph:sync` declara `capability: graph.sync` no registry do core;
|
|
8
|
+
o adaptador CLI recebe uma composição opcional GraphLoop + Git source e registra
|
|
9
|
+
o mesmo handler. O MCP stdio usa essa composição e descobre a ferramenta
|
|
10
|
+
dinâmica automaticamente. O resultado inclui contagens, arquivos e duração.
|
|
11
|
+
- **Consequências**: CLI, MCP e server compartilham execução e policy; a CLI
|
|
12
|
+
mantém um resumo humano e o envelope JSON. O banco local é aberto pela
|
|
13
|
+
composição do processo e usa as migrações existentes.
|
|
14
|
+
- **Alternativas rejeitadas**: duplicar um handler em `bin/forja`; manter lista
|
|
15
|
+
manual de ferramenta MCP; indexar sem `.gitignore`.
|
|
16
|
+
- **Evidência**: `lib/core/registry.ts`, `apps/cli/src/index.ts`, `bin/forja.ts`,
|
|
17
|
+
`packages/graph/src/index.ts` e testes Sprint 11.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
# ADR-0069 — Demonstração de autonomia com sandbox Git real
|
|
2
|
-
|
|
3
|
-
- **Status:** aceito
|
|
4
|
-
- **Data:** 2026-08-01
|
|
5
|
-
- **Decisão:** o caminho demonstrável de autonomia deve usar uma fixture externa, Git
|
|
6
|
-
worktree real, comandos reais, aprovação persistida, Validator independente e
|
|
7
|
-
promoção explícita. O agente da fixture pode ser determinístico para manter a prova
|
|
8
|
-
offline e repetível.
|
|
9
|
-
- **Motivo:** os testes anteriores validavam o contrato do sandbox, mas usavam store e
|
|
10
|
-
backend simulados; isso não comprovava isolamento, subprocesso, diff ou promoção.
|
|
11
|
-
- **Consequências:** `npm run demo:autonomy` é uma prova operacional e não depende de
|
|
12
|
-
LLM. O cenário usa um teste Node nativo para evitar instalação de dependências na
|
|
13
|
-
fixture e deixa SQLite, Git e npm observáveis.
|
|
14
|
-
- **Evidências:** `scripts/demo-autonomy.ts` e `test/demo-autonomy.test.js`.
|
|
15
|
-
- **Próximos passos:** repetir a mesma composição no MCP stdio e no bootstrap oficial
|
|
16
|
-
do servidor; adicionar rollback e cenários de caos.
|
|
1
|
+
# ADR-0069 — Demonstração de autonomia com sandbox Git real
|
|
2
|
+
|
|
3
|
+
- **Status:** aceito
|
|
4
|
+
- **Data:** 2026-08-01
|
|
5
|
+
- **Decisão:** o caminho demonstrável de autonomia deve usar uma fixture externa, Git
|
|
6
|
+
worktree real, comandos reais, aprovação persistida, Validator independente e
|
|
7
|
+
promoção explícita. O agente da fixture pode ser determinístico para manter a prova
|
|
8
|
+
offline e repetível.
|
|
9
|
+
- **Motivo:** os testes anteriores validavam o contrato do sandbox, mas usavam store e
|
|
10
|
+
backend simulados; isso não comprovava isolamento, subprocesso, diff ou promoção.
|
|
11
|
+
- **Consequências:** `npm run demo:autonomy` é uma prova operacional e não depende de
|
|
12
|
+
LLM. O cenário usa um teste Node nativo para evitar instalação de dependências na
|
|
13
|
+
fixture e deixa SQLite, Git e npm observáveis.
|
|
14
|
+
- **Evidências:** `scripts/demo-autonomy.ts` e `test/demo-autonomy.test.js`.
|
|
15
|
+
- **Próximos passos:** repetir a mesma composição no MCP stdio e no bootstrap oficial
|
|
16
|
+
do servidor; adicionar rollback e cenários de caos.
|
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
# ADR-0070 — MCP stdio como transporte testado por processo real
|
|
2
|
-
|
|
3
|
-
- **Status:** aceito
|
|
4
|
-
- **Decisão:** o transporte MCP local usa JSON-RPC delimitado por newline em
|
|
5
|
-
stdin/stdout; logs operacionais não podem ocupar stdout. Notificações sem `id`
|
|
6
|
-
não recebem resposta. EOF é o shutdown normal.
|
|
7
|
-
- **Motivo:** testes unitários do adapter não provavam compatibilidade do processo
|
|
8
|
-
lançado pelo usuário nem isolamento do canal de protocolo.
|
|
9
|
-
- **Consequências:** o teste inicia o binário real, envia mensagens em sequência e
|
|
10
|
-
rejeita stdout não parseável; diagnósticos devem usar stderr.
|
|
11
|
-
- **Evidência:** `test/mcp-stdio.test.js`.
|
|
1
|
+
# ADR-0070 — MCP stdio como transporte testado por processo real
|
|
2
|
+
|
|
3
|
+
- **Status:** aceito
|
|
4
|
+
- **Decisão:** o transporte MCP local usa JSON-RPC delimitado por newline em
|
|
5
|
+
stdin/stdout; logs operacionais não podem ocupar stdout. Notificações sem `id`
|
|
6
|
+
não recebem resposta. EOF é o shutdown normal.
|
|
7
|
+
- **Motivo:** testes unitários do adapter não provavam compatibilidade do processo
|
|
8
|
+
lançado pelo usuário nem isolamento do canal de protocolo.
|
|
9
|
+
- **Consequências:** o teste inicia o binário real, envia mensagens em sequência e
|
|
10
|
+
rejeita stdout não parseável; diagnósticos devem usar stderr.
|
|
11
|
+
- **Evidência:** `test/mcp-stdio.test.js`.
|
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
# ADR-0071 — Bootstrap Nest com persistência SQLite completa
|
|
2
|
-
|
|
3
|
-
- **Status:** aceito
|
|
4
|
-
- **Decisão:** o bootstrap oficial injeta `SqliteRuntimePersistence`,
|
|
5
|
-
`SqliteGraphStore`, `SqliteApprovalStore`, `SqliteEventStore`,
|
|
6
|
-
`SqliteContextCache`, `SqliteOrchestrationStore` e `SqliteObservationStore`.
|
|
7
|
-
Stores em memória ficam restritos a defaults de testes e composição isolada.
|
|
8
|
-
- **Motivo:** a composição anterior persistia runtime, approvals, eventos, grafo e
|
|
9
|
-
contexto, mas criava orquestração e observabilidade em memória.
|
|
10
|
-
- **Consequências:** Sprint/Task/Handoff e métricas sobrevivem ao restart; shutdown
|
|
11
|
-
deve drenar publicações assíncronas do Event Bus antes de fechar SQLite.
|
|
12
|
-
- **Evidência:** `apps/server/src/main.ts` e `test/server-persistence.test.js`.
|
|
1
|
+
# ADR-0071 — Bootstrap Nest com persistência SQLite completa
|
|
2
|
+
|
|
3
|
+
- **Status:** aceito
|
|
4
|
+
- **Decisão:** o bootstrap oficial injeta `SqliteRuntimePersistence`,
|
|
5
|
+
`SqliteGraphStore`, `SqliteApprovalStore`, `SqliteEventStore`,
|
|
6
|
+
`SqliteContextCache`, `SqliteOrchestrationStore` e `SqliteObservationStore`.
|
|
7
|
+
Stores em memória ficam restritos a defaults de testes e composição isolada.
|
|
8
|
+
- **Motivo:** a composição anterior persistia runtime, approvals, eventos, grafo e
|
|
9
|
+
contexto, mas criava orquestração e observabilidade em memória.
|
|
10
|
+
- **Consequências:** Sprint/Task/Handoff e métricas sobrevivem ao restart; shutdown
|
|
11
|
+
deve drenar publicações assíncronas do Event Bus antes de fechar SQLite.
|
|
12
|
+
- **Evidência:** `apps/server/src/main.ts` e `test/server-persistence.test.js`.
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
# ADR-0072 — Limites de ambiente e caminho no adapter Git
|
|
2
|
-
|
|
3
|
-
- **Status:** aceito
|
|
4
|
-
- **Decisão:** `SpawnCommandRunner` herda apenas variáveis operacionais mínimas
|
|
5
|
-
(`PATH`, temporários e `NODE_PATH`) e permite overrides explícitos. O
|
|
6
|
-
`GitGraphDocumentSource` rejeita locators que escapem da raiz resolvida.
|
|
7
|
-
- **Motivo:** comandos de sandbox não devem copiar secrets do processo e fontes
|
|
8
|
-
Git não devem transformar um locator malicioso em leitura fora do workspace.
|
|
9
|
-
- **Evidência:** testes de segurança em `test/adapter-git.test.js`.
|
|
1
|
+
# ADR-0072 — Limites de ambiente e caminho no adapter Git
|
|
2
|
+
|
|
3
|
+
- **Status:** aceito
|
|
4
|
+
- **Decisão:** `SpawnCommandRunner` herda apenas variáveis operacionais mínimas
|
|
5
|
+
(`PATH`, temporários e `NODE_PATH`) e permite overrides explícitos. O
|
|
6
|
+
`GitGraphDocumentSource` rejeita locators que escapem da raiz resolvida.
|
|
7
|
+
- **Motivo:** comandos de sandbox não devem copiar secrets do processo e fontes
|
|
8
|
+
Git não devem transformar um locator malicioso em leitura fora do workspace.
|
|
9
|
+
- **Evidência:** testes de segurança em `test/adapter-git.test.js`.
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# ADR-0073 — Última milha: rollback, benchmark e plugins permissionados
|
|
2
|
-
|
|
3
|
-
## Status
|
|
4
|
-
|
|
5
|
-
Accepted
|
|
6
|
-
|
|
7
|
-
## Contexto
|
|
8
|
-
|
|
9
|
-
O ForjaJS já comprovava promoção de uma alteração em Git worktree, contexto com cache e isolamento de plugins, mas não possuía uma operação de rollback formal, um artefato de benchmark estável nem plugins oficiais registráveis.
|
|
10
|
-
|
|
11
|
-
## Decisão
|
|
12
|
-
|
|
13
|
-
Adicionar `rollback` ao contrato `SandboxBackend` e ao `SandboxEngine`, com estado terminal `rolled_back`. O backend Git reverte o patch binário na raiz do repositório através do mesmo `PatchApplier` usado na promoção. O benchmark de contexto emite JSON determinístico com checksum e estimativa documentada de tokens. GitHub e Docker são manifests oficiais mínimos; handlers de rede/daemon são injetados pelo host e nunca implícitos.
|
|
14
|
-
|
|
15
|
-
## Consequências
|
|
16
|
-
|
|
17
|
-
Rollback permanece explícito e auditável. A medição pode ser reproduzida em CI, mas tokens continuam uma estimativa bytes/4. Os plugins são extensíveis e permissionados, porém não afirmam uma integração externa até que um adapter real seja fornecido.
|
|
1
|
+
# ADR-0073 — Última milha: rollback, benchmark e plugins permissionados
|
|
2
|
+
|
|
3
|
+
## Status
|
|
4
|
+
|
|
5
|
+
Accepted
|
|
6
|
+
|
|
7
|
+
## Contexto
|
|
8
|
+
|
|
9
|
+
O ForjaJS já comprovava promoção de uma alteração em Git worktree, contexto com cache e isolamento de plugins, mas não possuía uma operação de rollback formal, um artefato de benchmark estável nem plugins oficiais registráveis.
|
|
10
|
+
|
|
11
|
+
## Decisão
|
|
12
|
+
|
|
13
|
+
Adicionar `rollback` ao contrato `SandboxBackend` e ao `SandboxEngine`, com estado terminal `rolled_back`. O backend Git reverte o patch binário na raiz do repositório através do mesmo `PatchApplier` usado na promoção. O benchmark de contexto emite JSON determinístico com checksum e estimativa documentada de tokens. GitHub e Docker são manifests oficiais mínimos; handlers de rede/daemon são injetados pelo host e nunca implícitos.
|
|
14
|
+
|
|
15
|
+
## Consequências
|
|
16
|
+
|
|
17
|
+
Rollback permanece explícito e auditável. A medição pode ser reproduzida em CI, mas tokens continuam uma estimativa bytes/4. Os plugins são extensíveis e permissionados, porém não afirmam uma integração externa até que um adapter real seja fornecido.
|