forjajs 2.0.2 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -317
- package/README.pt-BR.md +345 -323
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.d.ts +1 -0
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -140
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,273 +1,273 @@
|
|
|
1
|
-
# Análise de impacto — Fundação ForjaJS 2.0
|
|
2
|
-
|
|
3
|
-
- **Data**: 2026-07-31
|
|
4
|
-
- **Escopo**: visão, arquitetura, contratos públicos e typecheck
|
|
5
|
-
- **Base**: ForjaJS 1.7.3, ADR-0003, ADR-0005, ADR-0019, ADR-0020, ADR-0027
|
|
6
|
-
|
|
7
|
-
## Contratos afetados
|
|
8
|
-
|
|
9
|
-
| Área | Impacto atual | Decisão nesta fatia |
|
|
10
|
-
| --- | --- | --- |
|
|
11
|
-
| CLI 1.x | Nenhuma API alterada | Mantida como caminho legado |
|
|
12
|
-
| Workspace | Nenhuma alteração de resolução | Mantido conforme ADR-0019 |
|
|
13
|
-
| Memória SQLite | Nenhuma migração | Adapter fica para fase posterior |
|
|
14
|
-
| Handoffs | Nenhuma alteração no router | Contrato 2.0 é aditivo |
|
|
15
|
-
| TypeScript | Novo escopo `packages/**/*` | Typecheck do domínio entra no gate |
|
|
16
|
-
| Publicação npm | Pacotes 2.0 ainda não publicados | Empacotamento será tratado com monorepo |
|
|
17
|
-
|
|
18
|
-
## Dependências e blast radius
|
|
19
|
-
|
|
20
|
-
O único arquivo existente alterado é `tsconfig.json`, adicionando o diretório de pacotes ao
|
|
21
|
-
typecheck. `lib/`, `scripts/`, `bin/`, registry e CLI não foram alterados. Os novos contratos não
|
|
22
|
-
importam código existente nem dependências externas; portanto não há ciclo ou efeito runtime na
|
|
23
|
-
CLI 1.x.
|
|
24
|
-
|
|
25
|
-
## Hipóteses
|
|
26
|
-
|
|
27
|
-
- Node 20+ continuará sendo o runtime mínimo do pacote publicado; desenvolvimento pode usar o
|
|
28
|
-
suporte nativo a TypeScript já adotado pelo projeto.
|
|
29
|
-
- `packages/contracts` será a fonte canônica antes de schemas serem derivados para MCP/REST.
|
|
30
|
-
- A escolha de biblioteca de schema (ou implementação própria) permanece aberta; esta fatia usa
|
|
31
|
-
validação determinística mínima sem introduzir dependência.
|
|
32
|
-
- IDs continuarão sendo strings opacas no transporte, representadas por brands no TypeScript.
|
|
33
|
-
|
|
34
|
-
## Informações ausentes
|
|
35
|
-
|
|
36
|
-
- estratégia final de workspace/package manager;
|
|
37
|
-
- formato de persistência e migrações 2.0;
|
|
38
|
-
- protocolo exato de execução de handlers;
|
|
39
|
-
- biblioteca de schema runtime e biblioteca de testes de integração;
|
|
40
|
-
- política de compatibilidade semântica entre versões de contrato;
|
|
41
|
-
- requisitos de autenticação local do server.
|
|
42
|
-
|
|
43
|
-
## Riscos
|
|
44
|
-
|
|
45
|
-
- Os contratos ainda não cobrem invariantes de cada bounded context.
|
|
46
|
-
- `unknown` em payloads é intencional nesta etapa, mas cada capability deverá fornecer schema
|
|
47
|
-
específico antes de execução.
|
|
48
|
-
- A existência de apenas dois ADRs 2.0 não fecha a governança completa; ADRs de runtime, policy,
|
|
49
|
-
GraphLoop, sandbox, eventos, adapters e UI ainda precisam ser aprovadas.
|
|
50
|
-
|
|
51
|
-
## Atualização da unidade Registry (2026-07-31)
|
|
52
|
-
|
|
53
|
-
`packages/core` foi criado com registry em memória, aliases, descoberta filtrada por agente,
|
|
54
|
-
validação de input antes do handler, autorização por uma porta de Policy Engine, suporte a
|
|
55
|
-
handlers síncronos/assíncronos e `ExecutionResult` normalizado. Não há persistência nem adapter.
|
|
56
|
-
|
|
57
|
-
## Atualização da unidade Policy (2026-07-31)
|
|
58
|
-
|
|
59
|
-
`packages/policy` foi criado com default deny, regras por agente, papel, capability, projeto,
|
|
60
|
-
ambiente, risco, categoria e prefixo de arquivo; precedência determinística; limites; exigência
|
|
61
|
-
de aprovação para risco crítico; e ledger de aprovações em memória. A fronteira Registry → Policy
|
|
62
|
-
foi testada sem acoplamento de pacote: o contexto de execução é transportado por uma porta comum.
|
|
63
|
-
|
|
64
|
-
O ledger não é persistente nesta etapa. O adapter SQLite e a auditoria durável ficam para o
|
|
65
|
-
Runtime Controlado.
|
|
66
|
-
|
|
67
|
-
## Atualização da unidade Runtime (2026-07-31)
|
|
68
|
-
|
|
69
|
-
`packages/runtime` foi criado com planner, validator, checkpoint store e memory writer como
|
|
70
|
-
portas. O motor controla estados, limites de passos/tokens/arquivos/tempo/retries, execução
|
|
71
|
-
sequencial (`maxParallel=1` nesta primeira implementação), pausa, retomada, cancelamento e
|
|
72
|
-
validação independente. O estado é em memória; a persistência durável permanece pendente.
|
|
73
|
-
|
|
74
|
-
## Atualização das unidades Events/Scheduler (2026-07-31)
|
|
75
|
-
|
|
76
|
-
`packages/events` fornece log append-only por porta, sequência por aggregate, deduplicação por
|
|
77
|
-
idempotency key, consumidores com retry e dead-letter. `packages/scheduler` fornece one-shot,
|
|
78
|
-
cron UTC de cinco campos, condição, evento, cancelamento, retries, idempotência por slot e limite
|
|
79
|
-
de concorrência. As implementações atuais são determinísticas e em memória; `adapter-sqlite` e a
|
|
80
|
-
integração de relógio/eventos ficam para a camada de adapters.
|
|
81
|
-
|
|
82
|
-
## Atualização da unidade Context (2026-07-31)
|
|
83
|
-
|
|
84
|
-
`packages/context` consulta memória e GraphLoop por portas, descarta evidência obsoleta ou
|
|
85
|
-
contradita, ordena por relevância, deduplica por checksum, limita itens e tokens, mantém cache
|
|
86
|
-
por checksum e permite expansão sob demanda. `ContextPackage` agora expõe métricas de candidatos,
|
|
87
|
-
seleção, deduplicação, cache, tokens usados e tokens não utilizados. Não há busca SQL, diff ou LLM
|
|
88
|
-
dentro do Engine.
|
|
89
|
-
|
|
90
|
-
## Atualização da unidade GraphLoop (2026-07-31)
|
|
91
|
-
|
|
92
|
-
`packages/graph` fornece nós, arestas, evidências, status, validade temporal, upsert idempotente,
|
|
93
|
-
paths, impacto, contradições, agenda e sincronização incremental por checksum de fonte. Arestas
|
|
94
|
-
sem endpoints ou evidência são rejeitadas. Imports e links Markdown são extraídos deterministicamente;
|
|
95
|
-
CodeGraph continua separado e pode alimentar mutations por adapter. O store atual é em memória.
|
|
96
|
-
|
|
97
|
-
## Atualização das unidades Planner/Validator (2026-07-31)
|
|
98
|
-
|
|
99
|
-
`packages/planner` produz planos determinísticos com três etapas mínimas, dependências do grafo,
|
|
100
|
-
evidências de contexto, risco, critérios e orçamento dividido. `packages/validator` verifica
|
|
101
|
-
checks obrigatórios, escopo de arquivos, critérios de aceitação, contradições, blockers e achados
|
|
102
|
-
de segurança, retornando `accepted`, `rejected`, `inconclusive` ou `blocked`. Nenhum dos dois
|
|
103
|
-
executa comandos ou depende do implementador.
|
|
104
|
-
|
|
105
|
-
## Próxima unidade verificável
|
|
106
|
-
|
|
107
|
-
Criar `packages/orchestration` para Sprint, Task e Handoff, com persistência por porta, estados,
|
|
108
|
-
orçamento, retomada, compactação e atualização do GraphLoop.
|
|
109
|
-
|
|
110
|
-
## Atualização da unidade Orchestration (2026-07-31)
|
|
111
|
-
|
|
112
|
-
`packages/orchestration` implementa `SprintEngine`, `TaskEngine` e `HandoffEngine` sobre a porta
|
|
113
|
-
`OrchestrationStore`. A implementação de referência é em memória e não conhece SQLite, NestJS ou
|
|
114
|
-
Next.js. Tasks só avançam quando as dependências estão concluídas; conclusões de Task e Sprint
|
|
115
|
-
exigem um `CompletionValidator` independente retornando `accepted`. Handoffs exigem objetivo,
|
|
116
|
-
aceite e evidências, removem itens duplicados e rejeitam seções acima dos limites definidos.
|
|
117
|
-
`GraphRecorder` registra Sprint, Task e Handoff com relações e evidências, deixando a persistência
|
|
118
|
-
do GraphLoop para o adapter apropriado.
|
|
119
|
-
|
|
120
|
-
O contrato de Sprint passou a explicitar `risks`, `taskIds` e `evidenceIds`; Task passou a
|
|
121
|
-
explicitar `evidenceIds`. A alteração é aditiva e permanece compatível com a direção de
|
|
122
|
-
dependências do domínio.
|
|
123
|
-
|
|
124
|
-
## Atualização da unidade Sandbox (2026-07-31)
|
|
125
|
-
|
|
126
|
-
`packages/sandbox` fornece `SandboxEngine` com ciclo explícito `create → prepare → execute →
|
|
127
|
-
validate → diff → promote/reject → destroy`. O engine depende de `SandboxStore` e
|
|
128
|
-
`SandboxBackend`; não executa subprocessos, não acessa filesystem e não importa Git. Promoção
|
|
129
|
-
exige validação aceita e um diff pertencente à mesma sessão. Falhas de execução levam a estado
|
|
130
|
-
`failed`, e destruição é registrada como estado terminal.
|
|
131
|
-
|
|
132
|
-
`packages/adapter-git` implementa o backend inicial por `CommandRunner` e `PatchApplier`. O
|
|
133
|
-
adapter traduz worktree, status, execução, `git diff --check`, diff numstat/name-only, aplicação
|
|
134
|
-
de patch e remoção de worktree. O adapter não é chamado diretamente pelo domínio e não foi
|
|
135
|
-
executado contra o repositório durante os testes; seus comandos foram verificados com runner
|
|
136
|
-
determinístico.
|
|
137
|
-
|
|
138
|
-
## Atualização da unidade Adapter SQLite (2026-07-31)
|
|
139
|
-
|
|
140
|
-
`packages/adapter-sqlite` fornece `SqliteConnection`, `SqliteMigrationRunner` e repositórios para
|
|
141
|
-
Orchestration, Sandbox, Checkpoint, Runtime Run, Event Bus e Auditoria. A migração inicial cria
|
|
142
|
-
tabelas de registros JSON, eventos append-only, auditoria e controle de versão. Migrações já
|
|
143
|
-
aplicadas são ignoradas por versão; eventos usam chave de idempotência no SQLite. O adapter não
|
|
144
|
-
é importado pelo domínio e não escolhe o driver: `better-sqlite3` pode ser ligado na composição
|
|
145
|
-
externa por duck typing da conexão.
|
|
146
|
-
|
|
147
|
-
## Atualização da unidade MCP (2026-07-31)
|
|
148
|
-
|
|
149
|
-
`packages/mcp` implementa `McpServer` como adaptador fino. As ferramentas delegam para Registry,
|
|
150
|
-
Context, GraphLoop, Memory, Task, Handoff e portas de validação/testes; não duplicam regras de
|
|
151
|
-
negócio. A identidade do agente é transportada nas operações de Registry e Policy é aplicada ao
|
|
152
|
-
handoff por `McpPolicy`. Erros são normalizados em resultados estruturados com código, mensagem e
|
|
153
|
-
`isError`.
|
|
154
|
-
|
|
155
|
-
O servidor anuncia os sete URIs oficiais de recursos; dados são fornecidos por providers externos.
|
|
156
|
-
Quando um provider não existe, o recurso informa explicitamente indisponibilidade. Nenhum dado de
|
|
157
|
-
workspace é inventado pelo adapter.
|
|
158
|
-
|
|
159
|
-
## Atualização da unidade Backend Nest (2026-07-31)
|
|
160
|
-
|
|
161
|
-
`packages/adapter-nest` fornece a fronteira HTTP verificável: rotas REST para health, capabilities,
|
|
162
|
-
contexto, GraphLoop, tasks, handoffs e MCP; correlation IDs; erros HTTP normalizados; SSE por
|
|
163
|
-
`EventStream`; autenticação local por porta; e documento OpenAPI 3.1. `apps/server` compõe essa
|
|
164
|
-
fronteira em `ForjaServerApplication` e expõe os módulos oficiais.
|
|
165
|
-
|
|
166
|
-
NestJS agora está instalado no workspace. `apps/server/src/app.module.ts`,
|
|
167
|
-
`forja-nest.module.ts` e `main.ts` fornecem o módulo dinâmico, controller, guard local, SSE e
|
|
168
|
-
Swagger reais. Como decorators não são executados pelo Node strip-only, o gate do bootstrap é
|
|
169
|
-
`npm run build` seguido de smoke test sobre `dist`; os testes nativos continuam cobrindo o adapter
|
|
170
|
-
sem exigir compilação prévia. Nenhuma regra de domínio foi colocada nessa composição.
|
|
171
|
-
|
|
172
|
-
## Atualização da unidade SDK (2026-07-31)
|
|
173
|
-
|
|
174
|
-
`packages/sdk` fornece `ForjaSdk` sobre a porta `SdkTransport`, sem importar NestJS, Express ou
|
|
175
|
-
um cliente HTTP concreto. A superfície cobre descoberta e execução de capabilities, contexto,
|
|
176
|
-
GraphLoop, próxima task, Sprint/Task/Handoff, runtime, approvals, métricas e subscription de
|
|
177
|
-
eventos. O SDK preserva headers de autenticação/correlation, serializa queries e transforma
|
|
178
|
-
respostas HTTP não-2xx em `SdkError` com status e corpo.
|
|
179
|
-
|
|
180
|
-
Rotas ainda não expostas pelo controller atual (runtime, approvals, métricas e criação de
|
|
181
|
-
Sprint/Task) permanecem contratos de cliente para a próxima fatia do Control Plane; não foram
|
|
182
|
-
tratadas como implementadas apenas por existirem no SDK.
|
|
183
|
-
|
|
184
|
-
## Atualização da unidade Observability/Control Plane (2026-07-31)
|
|
185
|
-
|
|
186
|
-
`packages/observability` registra observações por trace, run, agente, task, sprint e capability,
|
|
187
|
-
incluindo hashes de entrada, refs de contexto, tokens, duração, custo, ferramentas, arquivos,
|
|
188
|
-
comandos, validação, outcome e erro. `ControlPlane` calcula métricas de sucesso, bloqueio,
|
|
189
|
-
tokens, duração, custo e cobertura de evidência.
|
|
190
|
-
|
|
191
|
-
`packages/adapter-sqlite` agora fornece `SqliteObservationStore`. `packages/adapter-nest` expõe
|
|
192
|
-
`/api/control-plane/metrics` e `/api/observability/observations` por `ControlPlanePort`; a
|
|
193
|
-
agregação continua fora do controller. Runtime, approvals e CRUD de Sprint/Task ainda exigem
|
|
194
|
-
serviços de aplicação específicos.
|
|
195
|
-
|
|
196
|
-
## Atualização da unidade Control Plane operacional (2026-07-31)
|
|
197
|
-
|
|
198
|
-
`ControlPlaneServices` agora define portas explícitas para Runtime, Sprint, Task, Handoff e
|
|
199
|
-
Approvals. `apps/server/src/main.ts` compõe as engines reais de Sprint/Task/Handoff e
|
|
200
|
-
`ApprovalLedger`, e `packages/adapter-nest` expõe as rotas de criação/transição/decisão. Eventos
|
|
201
|
-
de observação são convertidos para `InMemoryEventStream` e chegam ao endpoint SSE.
|
|
202
|
-
|
|
203
|
-
Runtime possui rotas e portas, mas continua sem composição padrão no bootstrap porque exige um
|
|
204
|
-
planner, validator e policy executáveis. Um runtime sem capabilities planejadas ou sem validação
|
|
205
|
-
independente seria uma falsa conclusão e permanece bloqueado por decisão arquitetural.
|
|
206
|
-
|
|
207
|
-
## Atualização da unidade Runtime Control Plane (2026-07-31)
|
|
208
|
-
|
|
209
|
-
`DefaultRuntimeApplication` agora compõe `RuntimeEngine` com planner determinístico baseado em
|
|
210
|
-
etapas explícitas da requisição, validator independente que exige sucesso e evidência em todas as
|
|
211
|
-
etapas, `PolicyEngine` read-only/local e transporte de categorias, arquivos, ambiente e budget
|
|
212
|
-
para o Registry. Runtime expõe start/get/execute/pause/resume/cancel pelo Control Plane.
|
|
213
|
-
|
|
214
|
-
O smoke test executou uma capability `read` em sandbox lógico, terminou `completed/accepted` e
|
|
215
|
-
gerou duas observações de Control Plane. Escritas continuam bloqueadas pela política padrão.
|
|
216
|
-
|
|
217
|
-
## Atualização da unidade Evaluation Engine e Plugin SDK (2026-07-31)
|
|
218
|
-
|
|
219
|
-
`packages/evals` consome observações do Control Plane e produz `EvaluationReport` versionado com
|
|
220
|
-
taxa de sucesso, retrabalho/cache, tokens por task, etapas sem atividade, ausência de evidência,
|
|
221
|
-
rollback, uso de contexto, tokens e custo. A avaliação não chama LLM e mantém os IDs das
|
|
222
|
-
observações no relatório.
|
|
223
|
-
|
|
224
|
-
`packages/plugin-sdk` define manifesto com permissões, capabilities, eventos, migrations,
|
|
225
|
-
extensões e compatibilidade. `PluginRegistry` rejeita IDs duplicados e entrega um contexto com
|
|
226
|
-
checagem de permissão por operação. O SDK não concede acesso direto a filesystem, processo ou
|
|
227
|
-
persistência; dashboard e migrations permanecem metadados até suas políticas de host existirem.
|
|
228
|
-
|
|
229
|
-
## Atualização da unidade Worker e Dashboard boundary (2026-07-31)
|
|
230
|
-
|
|
231
|
-
`apps/worker` compõe Event Bus, Scheduler, ObservationStore/Recorder e Evaluation Engine para
|
|
232
|
-
permitir processamento assíncrono determinístico. O worker não recebe executor de capability por
|
|
233
|
-
fora do Runtime/Policy.
|
|
234
|
-
|
|
235
|
-
`apps/dashboard` fornece o view model operacional mínimo: snapshot de métricas/observações e ações
|
|
236
|
-
de pausa, cancelamento e aprovação delegadas ao Control Plane. A casca Next.js/React, Query e SSE
|
|
237
|
-
remoto ainda é pendência explícita; nenhum componente visual foi inventado como se já existisse.
|
|
238
|
-
|
|
239
|
-
## Atualização da unidade Dashboard Next.js (2026-07-31)
|
|
240
|
-
|
|
241
|
-
`apps/dashboard` agora possui distribuição Next.js/React com App Router, layout, Overview, métricas,
|
|
242
|
-
observações recentes, atualização manual e revalidação por SSE. A tela usa REST para obter o estado
|
|
243
|
-
do Control Plane e não importa persistência, Policy, Runtime ou GraphLoop.
|
|
244
|
-
|
|
245
|
-
O build usa `outputFileTracingRoot` na raiz do monorepo e passou em produção. Autenticação de
|
|
246
|
-
usuário, TanStack Query, filtros/inspeção visual do GraphLoop e comandos de aprovação ainda são
|
|
247
|
-
incrementos pendentes; o dashboard não é considerado completo por esta casca inicial.
|
|
248
|
-
|
|
249
|
-
## Atualização da unidade Dashboard proxy/auth/query (2026-08-01)
|
|
250
|
-
|
|
251
|
-
O dashboard agora usa TanStack Query para cache e invalidação do snapshot. Um Route Handler
|
|
252
|
-
server-side encaminha somente endpoints allowlisted ao backend; `FORJA_AUTH_TOKEN` não é exposto ao
|
|
253
|
-
cliente. SSE apenas invalida o cache remoto.
|
|
254
|
-
|
|
255
|
-
`createBearerAuthenticator` foi centralizado no adapter Nest com comparação constante e o bootstrap
|
|
256
|
-
usa `FORJA_AUTH_TOKEN` quando definido. O modo sem token continua local/offline, mas implantação
|
|
257
|
-
operacional deve configurar autenticação. A suíte passou serialmente; testes paralelos que alteram
|
|
258
|
-
PATH/processos continuam sujeitos a interferência ambiental.
|
|
259
|
-
|
|
260
|
-
## Atualização da unidade GraphLoop e Approvals no dashboard (2026-08-01)
|
|
261
|
-
|
|
262
|
-
O adapter Nest agora expõe listagem de approvals e o bootstrap conecta a lista do `ApprovalLedger`.
|
|
263
|
-
O GraphLoop padrão é composto no MCP do servidor, permitindo consulta de nós e impacto sem LLM.
|
|
264
|
-
|
|
265
|
-
O dashboard renderiza os nós retornados, seus status, impacto sob demanda e a fila de approvals.
|
|
266
|
-
Decisões de aprovação permanecem fora desta tela até haver identidade/aprovador configurado;
|
|
267
|
-
nenhuma relação ou decisão é sintetizada no cliente.
|
|
268
|
-
|
|
269
|
-
## Atualização da unidade Approval server-side (2026-08-01)
|
|
270
|
-
|
|
271
|
-
O dashboard agora permite aprovar/rejeitar somente quando `FORJA_APPROVER_ID` está configurado no
|
|
272
|
-
servidor. O browser envia apenas a decisão; o proxy valida o enum, injeta identidade e timestamp e
|
|
273
|
-
encaminha ao `ApprovalLedger`. Configuração ausente não gera fallback permissivo.
|
|
1
|
+
# Análise de impacto — Fundação ForjaJS 2.0
|
|
2
|
+
|
|
3
|
+
- **Data**: 2026-07-31
|
|
4
|
+
- **Escopo**: visão, arquitetura, contratos públicos e typecheck
|
|
5
|
+
- **Base**: ForjaJS 1.7.3, ADR-0003, ADR-0005, ADR-0019, ADR-0020, ADR-0027
|
|
6
|
+
|
|
7
|
+
## Contratos afetados
|
|
8
|
+
|
|
9
|
+
| Área | Impacto atual | Decisão nesta fatia |
|
|
10
|
+
| --- | --- | --- |
|
|
11
|
+
| CLI 1.x | Nenhuma API alterada | Mantida como caminho legado |
|
|
12
|
+
| Workspace | Nenhuma alteração de resolução | Mantido conforme ADR-0019 |
|
|
13
|
+
| Memória SQLite | Nenhuma migração | Adapter fica para fase posterior |
|
|
14
|
+
| Handoffs | Nenhuma alteração no router | Contrato 2.0 é aditivo |
|
|
15
|
+
| TypeScript | Novo escopo `packages/**/*` | Typecheck do domínio entra no gate |
|
|
16
|
+
| Publicação npm | Pacotes 2.0 ainda não publicados | Empacotamento será tratado com monorepo |
|
|
17
|
+
|
|
18
|
+
## Dependências e blast radius
|
|
19
|
+
|
|
20
|
+
O único arquivo existente alterado é `tsconfig.json`, adicionando o diretório de pacotes ao
|
|
21
|
+
typecheck. `lib/`, `scripts/`, `bin/`, registry e CLI não foram alterados. Os novos contratos não
|
|
22
|
+
importam código existente nem dependências externas; portanto não há ciclo ou efeito runtime na
|
|
23
|
+
CLI 1.x.
|
|
24
|
+
|
|
25
|
+
## Hipóteses
|
|
26
|
+
|
|
27
|
+
- Node 20+ continuará sendo o runtime mínimo do pacote publicado; desenvolvimento pode usar o
|
|
28
|
+
suporte nativo a TypeScript já adotado pelo projeto.
|
|
29
|
+
- `packages/contracts` será a fonte canônica antes de schemas serem derivados para MCP/REST.
|
|
30
|
+
- A escolha de biblioteca de schema (ou implementação própria) permanece aberta; esta fatia usa
|
|
31
|
+
validação determinística mínima sem introduzir dependência.
|
|
32
|
+
- IDs continuarão sendo strings opacas no transporte, representadas por brands no TypeScript.
|
|
33
|
+
|
|
34
|
+
## Informações ausentes
|
|
35
|
+
|
|
36
|
+
- estratégia final de workspace/package manager;
|
|
37
|
+
- formato de persistência e migrações 2.0;
|
|
38
|
+
- protocolo exato de execução de handlers;
|
|
39
|
+
- biblioteca de schema runtime e biblioteca de testes de integração;
|
|
40
|
+
- política de compatibilidade semântica entre versões de contrato;
|
|
41
|
+
- requisitos de autenticação local do server.
|
|
42
|
+
|
|
43
|
+
## Riscos
|
|
44
|
+
|
|
45
|
+
- Os contratos ainda não cobrem invariantes de cada bounded context.
|
|
46
|
+
- `unknown` em payloads é intencional nesta etapa, mas cada capability deverá fornecer schema
|
|
47
|
+
específico antes de execução.
|
|
48
|
+
- A existência de apenas dois ADRs 2.0 não fecha a governança completa; ADRs de runtime, policy,
|
|
49
|
+
GraphLoop, sandbox, eventos, adapters e UI ainda precisam ser aprovadas.
|
|
50
|
+
|
|
51
|
+
## Atualização da unidade Registry (2026-07-31)
|
|
52
|
+
|
|
53
|
+
`packages/core` foi criado com registry em memória, aliases, descoberta filtrada por agente,
|
|
54
|
+
validação de input antes do handler, autorização por uma porta de Policy Engine, suporte a
|
|
55
|
+
handlers síncronos/assíncronos e `ExecutionResult` normalizado. Não há persistência nem adapter.
|
|
56
|
+
|
|
57
|
+
## Atualização da unidade Policy (2026-07-31)
|
|
58
|
+
|
|
59
|
+
`packages/policy` foi criado com default deny, regras por agente, papel, capability, projeto,
|
|
60
|
+
ambiente, risco, categoria e prefixo de arquivo; precedência determinística; limites; exigência
|
|
61
|
+
de aprovação para risco crítico; e ledger de aprovações em memória. A fronteira Registry → Policy
|
|
62
|
+
foi testada sem acoplamento de pacote: o contexto de execução é transportado por uma porta comum.
|
|
63
|
+
|
|
64
|
+
O ledger não é persistente nesta etapa. O adapter SQLite e a auditoria durável ficam para o
|
|
65
|
+
Runtime Controlado.
|
|
66
|
+
|
|
67
|
+
## Atualização da unidade Runtime (2026-07-31)
|
|
68
|
+
|
|
69
|
+
`packages/runtime` foi criado com planner, validator, checkpoint store e memory writer como
|
|
70
|
+
portas. O motor controla estados, limites de passos/tokens/arquivos/tempo/retries, execução
|
|
71
|
+
sequencial (`maxParallel=1` nesta primeira implementação), pausa, retomada, cancelamento e
|
|
72
|
+
validação independente. O estado é em memória; a persistência durável permanece pendente.
|
|
73
|
+
|
|
74
|
+
## Atualização das unidades Events/Scheduler (2026-07-31)
|
|
75
|
+
|
|
76
|
+
`packages/events` fornece log append-only por porta, sequência por aggregate, deduplicação por
|
|
77
|
+
idempotency key, consumidores com retry e dead-letter. `packages/scheduler` fornece one-shot,
|
|
78
|
+
cron UTC de cinco campos, condição, evento, cancelamento, retries, idempotência por slot e limite
|
|
79
|
+
de concorrência. As implementações atuais são determinísticas e em memória; `adapter-sqlite` e a
|
|
80
|
+
integração de relógio/eventos ficam para a camada de adapters.
|
|
81
|
+
|
|
82
|
+
## Atualização da unidade Context (2026-07-31)
|
|
83
|
+
|
|
84
|
+
`packages/context` consulta memória e GraphLoop por portas, descarta evidência obsoleta ou
|
|
85
|
+
contradita, ordena por relevância, deduplica por checksum, limita itens e tokens, mantém cache
|
|
86
|
+
por checksum e permite expansão sob demanda. `ContextPackage` agora expõe métricas de candidatos,
|
|
87
|
+
seleção, deduplicação, cache, tokens usados e tokens não utilizados. Não há busca SQL, diff ou LLM
|
|
88
|
+
dentro do Engine.
|
|
89
|
+
|
|
90
|
+
## Atualização da unidade GraphLoop (2026-07-31)
|
|
91
|
+
|
|
92
|
+
`packages/graph` fornece nós, arestas, evidências, status, validade temporal, upsert idempotente,
|
|
93
|
+
paths, impacto, contradições, agenda e sincronização incremental por checksum de fonte. Arestas
|
|
94
|
+
sem endpoints ou evidência são rejeitadas. Imports e links Markdown são extraídos deterministicamente;
|
|
95
|
+
CodeGraph continua separado e pode alimentar mutations por adapter. O store atual é em memória.
|
|
96
|
+
|
|
97
|
+
## Atualização das unidades Planner/Validator (2026-07-31)
|
|
98
|
+
|
|
99
|
+
`packages/planner` produz planos determinísticos com três etapas mínimas, dependências do grafo,
|
|
100
|
+
evidências de contexto, risco, critérios e orçamento dividido. `packages/validator` verifica
|
|
101
|
+
checks obrigatórios, escopo de arquivos, critérios de aceitação, contradições, blockers e achados
|
|
102
|
+
de segurança, retornando `accepted`, `rejected`, `inconclusive` ou `blocked`. Nenhum dos dois
|
|
103
|
+
executa comandos ou depende do implementador.
|
|
104
|
+
|
|
105
|
+
## Próxima unidade verificável
|
|
106
|
+
|
|
107
|
+
Criar `packages/orchestration` para Sprint, Task e Handoff, com persistência por porta, estados,
|
|
108
|
+
orçamento, retomada, compactação e atualização do GraphLoop.
|
|
109
|
+
|
|
110
|
+
## Atualização da unidade Orchestration (2026-07-31)
|
|
111
|
+
|
|
112
|
+
`packages/orchestration` implementa `SprintEngine`, `TaskEngine` e `HandoffEngine` sobre a porta
|
|
113
|
+
`OrchestrationStore`. A implementação de referência é em memória e não conhece SQLite, NestJS ou
|
|
114
|
+
Next.js. Tasks só avançam quando as dependências estão concluídas; conclusões de Task e Sprint
|
|
115
|
+
exigem um `CompletionValidator` independente retornando `accepted`. Handoffs exigem objetivo,
|
|
116
|
+
aceite e evidências, removem itens duplicados e rejeitam seções acima dos limites definidos.
|
|
117
|
+
`GraphRecorder` registra Sprint, Task e Handoff com relações e evidências, deixando a persistência
|
|
118
|
+
do GraphLoop para o adapter apropriado.
|
|
119
|
+
|
|
120
|
+
O contrato de Sprint passou a explicitar `risks`, `taskIds` e `evidenceIds`; Task passou a
|
|
121
|
+
explicitar `evidenceIds`. A alteração é aditiva e permanece compatível com a direção de
|
|
122
|
+
dependências do domínio.
|
|
123
|
+
|
|
124
|
+
## Atualização da unidade Sandbox (2026-07-31)
|
|
125
|
+
|
|
126
|
+
`packages/sandbox` fornece `SandboxEngine` com ciclo explícito `create → prepare → execute →
|
|
127
|
+
validate → diff → promote/reject → destroy`. O engine depende de `SandboxStore` e
|
|
128
|
+
`SandboxBackend`; não executa subprocessos, não acessa filesystem e não importa Git. Promoção
|
|
129
|
+
exige validação aceita e um diff pertencente à mesma sessão. Falhas de execução levam a estado
|
|
130
|
+
`failed`, e destruição é registrada como estado terminal.
|
|
131
|
+
|
|
132
|
+
`packages/adapter-git` implementa o backend inicial por `CommandRunner` e `PatchApplier`. O
|
|
133
|
+
adapter traduz worktree, status, execução, `git diff --check`, diff numstat/name-only, aplicação
|
|
134
|
+
de patch e remoção de worktree. O adapter não é chamado diretamente pelo domínio e não foi
|
|
135
|
+
executado contra o repositório durante os testes; seus comandos foram verificados com runner
|
|
136
|
+
determinístico.
|
|
137
|
+
|
|
138
|
+
## Atualização da unidade Adapter SQLite (2026-07-31)
|
|
139
|
+
|
|
140
|
+
`packages/adapter-sqlite` fornece `SqliteConnection`, `SqliteMigrationRunner` e repositórios para
|
|
141
|
+
Orchestration, Sandbox, Checkpoint, Runtime Run, Event Bus e Auditoria. A migração inicial cria
|
|
142
|
+
tabelas de registros JSON, eventos append-only, auditoria e controle de versão. Migrações já
|
|
143
|
+
aplicadas são ignoradas por versão; eventos usam chave de idempotência no SQLite. O adapter não
|
|
144
|
+
é importado pelo domínio e não escolhe o driver: `better-sqlite3` pode ser ligado na composição
|
|
145
|
+
externa por duck typing da conexão.
|
|
146
|
+
|
|
147
|
+
## Atualização da unidade MCP (2026-07-31)
|
|
148
|
+
|
|
149
|
+
`packages/mcp` implementa `McpServer` como adaptador fino. As ferramentas delegam para Registry,
|
|
150
|
+
Context, GraphLoop, Memory, Task, Handoff e portas de validação/testes; não duplicam regras de
|
|
151
|
+
negócio. A identidade do agente é transportada nas operações de Registry e Policy é aplicada ao
|
|
152
|
+
handoff por `McpPolicy`. Erros são normalizados em resultados estruturados com código, mensagem e
|
|
153
|
+
`isError`.
|
|
154
|
+
|
|
155
|
+
O servidor anuncia os sete URIs oficiais de recursos; dados são fornecidos por providers externos.
|
|
156
|
+
Quando um provider não existe, o recurso informa explicitamente indisponibilidade. Nenhum dado de
|
|
157
|
+
workspace é inventado pelo adapter.
|
|
158
|
+
|
|
159
|
+
## Atualização da unidade Backend Nest (2026-07-31)
|
|
160
|
+
|
|
161
|
+
`packages/adapter-nest` fornece a fronteira HTTP verificável: rotas REST para health, capabilities,
|
|
162
|
+
contexto, GraphLoop, tasks, handoffs e MCP; correlation IDs; erros HTTP normalizados; SSE por
|
|
163
|
+
`EventStream`; autenticação local por porta; e documento OpenAPI 3.1. `apps/server` compõe essa
|
|
164
|
+
fronteira em `ForjaServerApplication` e expõe os módulos oficiais.
|
|
165
|
+
|
|
166
|
+
NestJS agora está instalado no workspace. `apps/server/src/app.module.ts`,
|
|
167
|
+
`forja-nest.module.ts` e `main.ts` fornecem o módulo dinâmico, controller, guard local, SSE e
|
|
168
|
+
Swagger reais. Como decorators não são executados pelo Node strip-only, o gate do bootstrap é
|
|
169
|
+
`npm run build` seguido de smoke test sobre `dist`; os testes nativos continuam cobrindo o adapter
|
|
170
|
+
sem exigir compilação prévia. Nenhuma regra de domínio foi colocada nessa composição.
|
|
171
|
+
|
|
172
|
+
## Atualização da unidade SDK (2026-07-31)
|
|
173
|
+
|
|
174
|
+
`packages/sdk` fornece `ForjaSdk` sobre a porta `SdkTransport`, sem importar NestJS, Express ou
|
|
175
|
+
um cliente HTTP concreto. A superfície cobre descoberta e execução de capabilities, contexto,
|
|
176
|
+
GraphLoop, próxima task, Sprint/Task/Handoff, runtime, approvals, métricas e subscription de
|
|
177
|
+
eventos. O SDK preserva headers de autenticação/correlation, serializa queries e transforma
|
|
178
|
+
respostas HTTP não-2xx em `SdkError` com status e corpo.
|
|
179
|
+
|
|
180
|
+
Rotas ainda não expostas pelo controller atual (runtime, approvals, métricas e criação de
|
|
181
|
+
Sprint/Task) permanecem contratos de cliente para a próxima fatia do Control Plane; não foram
|
|
182
|
+
tratadas como implementadas apenas por existirem no SDK.
|
|
183
|
+
|
|
184
|
+
## Atualização da unidade Observability/Control Plane (2026-07-31)
|
|
185
|
+
|
|
186
|
+
`packages/observability` registra observações por trace, run, agente, task, sprint e capability,
|
|
187
|
+
incluindo hashes de entrada, refs de contexto, tokens, duração, custo, ferramentas, arquivos,
|
|
188
|
+
comandos, validação, outcome e erro. `ControlPlane` calcula métricas de sucesso, bloqueio,
|
|
189
|
+
tokens, duração, custo e cobertura de evidência.
|
|
190
|
+
|
|
191
|
+
`packages/adapter-sqlite` agora fornece `SqliteObservationStore`. `packages/adapter-nest` expõe
|
|
192
|
+
`/api/control-plane/metrics` e `/api/observability/observations` por `ControlPlanePort`; a
|
|
193
|
+
agregação continua fora do controller. Runtime, approvals e CRUD de Sprint/Task ainda exigem
|
|
194
|
+
serviços de aplicação específicos.
|
|
195
|
+
|
|
196
|
+
## Atualização da unidade Control Plane operacional (2026-07-31)
|
|
197
|
+
|
|
198
|
+
`ControlPlaneServices` agora define portas explícitas para Runtime, Sprint, Task, Handoff e
|
|
199
|
+
Approvals. `apps/server/src/main.ts` compõe as engines reais de Sprint/Task/Handoff e
|
|
200
|
+
`ApprovalLedger`, e `packages/adapter-nest` expõe as rotas de criação/transição/decisão. Eventos
|
|
201
|
+
de observação são convertidos para `InMemoryEventStream` e chegam ao endpoint SSE.
|
|
202
|
+
|
|
203
|
+
Runtime possui rotas e portas, mas continua sem composição padrão no bootstrap porque exige um
|
|
204
|
+
planner, validator e policy executáveis. Um runtime sem capabilities planejadas ou sem validação
|
|
205
|
+
independente seria uma falsa conclusão e permanece bloqueado por decisão arquitetural.
|
|
206
|
+
|
|
207
|
+
## Atualização da unidade Runtime Control Plane (2026-07-31)
|
|
208
|
+
|
|
209
|
+
`DefaultRuntimeApplication` agora compõe `RuntimeEngine` com planner determinístico baseado em
|
|
210
|
+
etapas explícitas da requisição, validator independente que exige sucesso e evidência em todas as
|
|
211
|
+
etapas, `PolicyEngine` read-only/local e transporte de categorias, arquivos, ambiente e budget
|
|
212
|
+
para o Registry. Runtime expõe start/get/execute/pause/resume/cancel pelo Control Plane.
|
|
213
|
+
|
|
214
|
+
O smoke test executou uma capability `read` em sandbox lógico, terminou `completed/accepted` e
|
|
215
|
+
gerou duas observações de Control Plane. Escritas continuam bloqueadas pela política padrão.
|
|
216
|
+
|
|
217
|
+
## Atualização da unidade Evaluation Engine e Plugin SDK (2026-07-31)
|
|
218
|
+
|
|
219
|
+
`packages/evals` consome observações do Control Plane e produz `EvaluationReport` versionado com
|
|
220
|
+
taxa de sucesso, retrabalho/cache, tokens por task, etapas sem atividade, ausência de evidência,
|
|
221
|
+
rollback, uso de contexto, tokens e custo. A avaliação não chama LLM e mantém os IDs das
|
|
222
|
+
observações no relatório.
|
|
223
|
+
|
|
224
|
+
`packages/plugin-sdk` define manifesto com permissões, capabilities, eventos, migrations,
|
|
225
|
+
extensões e compatibilidade. `PluginRegistry` rejeita IDs duplicados e entrega um contexto com
|
|
226
|
+
checagem de permissão por operação. O SDK não concede acesso direto a filesystem, processo ou
|
|
227
|
+
persistência; dashboard e migrations permanecem metadados até suas políticas de host existirem.
|
|
228
|
+
|
|
229
|
+
## Atualização da unidade Worker e Dashboard boundary (2026-07-31)
|
|
230
|
+
|
|
231
|
+
`apps/worker` compõe Event Bus, Scheduler, ObservationStore/Recorder e Evaluation Engine para
|
|
232
|
+
permitir processamento assíncrono determinístico. O worker não recebe executor de capability por
|
|
233
|
+
fora do Runtime/Policy.
|
|
234
|
+
|
|
235
|
+
`apps/dashboard` fornece o view model operacional mínimo: snapshot de métricas/observações e ações
|
|
236
|
+
de pausa, cancelamento e aprovação delegadas ao Control Plane. A casca Next.js/React, Query e SSE
|
|
237
|
+
remoto ainda é pendência explícita; nenhum componente visual foi inventado como se já existisse.
|
|
238
|
+
|
|
239
|
+
## Atualização da unidade Dashboard Next.js (2026-07-31)
|
|
240
|
+
|
|
241
|
+
`apps/dashboard` agora possui distribuição Next.js/React com App Router, layout, Overview, métricas,
|
|
242
|
+
observações recentes, atualização manual e revalidação por SSE. A tela usa REST para obter o estado
|
|
243
|
+
do Control Plane e não importa persistência, Policy, Runtime ou GraphLoop.
|
|
244
|
+
|
|
245
|
+
O build usa `outputFileTracingRoot` na raiz do monorepo e passou em produção. Autenticação de
|
|
246
|
+
usuário, TanStack Query, filtros/inspeção visual do GraphLoop e comandos de aprovação ainda são
|
|
247
|
+
incrementos pendentes; o dashboard não é considerado completo por esta casca inicial.
|
|
248
|
+
|
|
249
|
+
## Atualização da unidade Dashboard proxy/auth/query (2026-08-01)
|
|
250
|
+
|
|
251
|
+
O dashboard agora usa TanStack Query para cache e invalidação do snapshot. Um Route Handler
|
|
252
|
+
server-side encaminha somente endpoints allowlisted ao backend; `FORJA_AUTH_TOKEN` não é exposto ao
|
|
253
|
+
cliente. SSE apenas invalida o cache remoto.
|
|
254
|
+
|
|
255
|
+
`createBearerAuthenticator` foi centralizado no adapter Nest com comparação constante e o bootstrap
|
|
256
|
+
usa `FORJA_AUTH_TOKEN` quando definido. O modo sem token continua local/offline, mas implantação
|
|
257
|
+
operacional deve configurar autenticação. A suíte passou serialmente; testes paralelos que alteram
|
|
258
|
+
PATH/processos continuam sujeitos a interferência ambiental.
|
|
259
|
+
|
|
260
|
+
## Atualização da unidade GraphLoop e Approvals no dashboard (2026-08-01)
|
|
261
|
+
|
|
262
|
+
O adapter Nest agora expõe listagem de approvals e o bootstrap conecta a lista do `ApprovalLedger`.
|
|
263
|
+
O GraphLoop padrão é composto no MCP do servidor, permitindo consulta de nós e impacto sem LLM.
|
|
264
|
+
|
|
265
|
+
O dashboard renderiza os nós retornados, seus status, impacto sob demanda e a fila de approvals.
|
|
266
|
+
Decisões de aprovação permanecem fora desta tela até haver identidade/aprovador configurado;
|
|
267
|
+
nenhuma relação ou decisão é sintetizada no cliente.
|
|
268
|
+
|
|
269
|
+
## Atualização da unidade Approval server-side (2026-08-01)
|
|
270
|
+
|
|
271
|
+
O dashboard agora permite aprovar/rejeitar somente quando `FORJA_APPROVER_ID` está configurado no
|
|
272
|
+
servidor. O browser envia apenas a decisão; o proxy valida o enum, injeta identidade e timestamp e
|
|
273
|
+
encaminha ao `ApprovalLedger`. Configuração ausente não gera fallback permissivo.
|