forjajs 2.0.3 → 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 -339
- package/README.pt-BR.md +345 -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/dashboard-client.jsx +10 -10
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +14 -2
- 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 +54 -0
- package/dist/lib/core/registry.js +55 -0
- package/dist/lib/core/release.d.ts +53 -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-sqlite/src/index.js +12 -12
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -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-ops.js +29 -29
- package/dist/scripts/demo-autonomy.js +2 -2
- 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.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 -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/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 -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/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 -150
- 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
- package/dist/scripts/server-persistence-probe.d.ts +0 -1
- package/dist/scripts/server-persistence-probe.js +0 -52
- package/dist/scripts/server-persistence-probe.mjs +0 -52
- /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
|
@@ -1,64 +1,64 @@
|
|
|
1
|
-
# ADR-0033: `memory-db` distingue permissão/lock de corrupção
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-23
|
|
5
|
-
- **Autor(es)**: Allan Pablo
|
|
6
|
-
- **Tags**: doctor, memory, diagnostics, sqlite
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
O check `memory-db` (`lib/core/health.ts`), consumido por `tools:doctor` e pelo hook
|
|
11
|
-
`SessionStart`, abria `universal.db` e tratava **qualquer** exceção do `better-sqlite3` como
|
|
12
|
-
corrupção:
|
|
13
|
-
|
|
14
|
-
```ts
|
|
15
|
-
} catch (err) {
|
|
16
|
-
return {
|
|
17
|
-
status: 'fail',
|
|
18
|
-
detail: `... (${asErrno(err).code}) — provavelmente corrompido`,
|
|
19
|
-
fix: 'npm run sync:universal',
|
|
20
|
-
};
|
|
21
|
-
}
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
O `err.code` — que já distingue os casos — estava impresso no `detail`, mas não decidia nada.
|
|
25
|
-
Num ambiente sem permissão de escrita (sandbox, FS read-only, diretório protegido) o driver
|
|
26
|
-
lança `SQLITE_CANTOPEN`, e o doctor diagnosticava "provavelmente corrompido" prescrevendo
|
|
27
|
-
`sync:universal`. A prescrição é ativamente errada: `sync:universal` **escreve** no banco — no
|
|
28
|
-
mesmo ambiente ele reencena o `CANTOPEN` sem curar nada, e ainda confunde o operador levando-o a
|
|
29
|
-
"reindexar" um banco íntegro. Reportado a partir de uma sessão real em sandbox restrito.
|
|
30
|
-
|
|
31
|
-
É a violação do princípio 1 do próprio `health.ts` ("nunca colapsar causas distintas num
|
|
32
|
-
booleano"), a mesma classe do bug de ABI que motivou a SPEC-009 — sobrevivendo dentro do arquivo
|
|
33
|
-
escrito para fechá-la.
|
|
34
|
-
|
|
35
|
-
## Decisão
|
|
36
|
-
|
|
37
|
-
Classificar a falha de abertura por `err.code`, uma causa por prescrição:
|
|
38
|
-
|
|
39
|
-
- `SQLITE_CANTOPEN` / `EACCES` → `fail`, **permissão/sandbox**, não corrupção; fix orienta
|
|
40
|
-
garantir leitura no path e **desaconselha** `sync:universal`.
|
|
41
|
-
- `SQLITE_BUSY` → `warn` (lock temporário de outro processo; não trava o gate); fix é aguardar.
|
|
42
|
-
- Resto (`SQLITE_CORRUPT`, `SQLITE_NOTADB`, …) → `fail`, **corrupção**; fix `npm run sync:universal`.
|
|
43
|
-
|
|
44
|
-
## Alternativas consideradas
|
|
45
|
-
|
|
46
|
-
- **Testar a integridade com `PRAGMA quick_check` antes de classificar** — rejeitada: um banco que
|
|
47
|
-
nem abre (CANTOPEN) não chega ao pragma; o `err.code` da abertura já carrega a distinção sem I/O extra.
|
|
48
|
-
- **Discriminar por mensagem de erro** — rejeitada: mensagens do SQLite variam entre versões e
|
|
49
|
-
locale; `err.code` é o contrato estável, como o resto do `health.ts` já assume.
|
|
50
|
-
|
|
51
|
-
## Consequências
|
|
52
|
-
|
|
53
|
-
**Positivas**:
|
|
54
|
-
- Sandbox/permissão deixa de ser confundido com corrupção; o operador recebe a correção da causa real.
|
|
55
|
-
- `sync:universal` nunca é prescrito para um banco íntegro-mas-inacessível.
|
|
56
|
-
- Lock concorrente vira `warn`, não reprova o núcleo.
|
|
57
|
-
|
|
58
|
-
**Negativas / Trade-offs**:
|
|
59
|
-
- Mais um `err.code` (`SQLITE_BUSY`) a manter caso o driver mude a taxonomia — coberto por teste.
|
|
60
|
-
|
|
61
|
-
## Rastreamento
|
|
62
|
-
- Implementação: `lib/core/health.ts` (check `memory-db`)
|
|
63
|
-
- Testes: `test/health.test.js` (CANTOPEN, EACCES, BUSY, NOTADB)
|
|
64
|
-
- ADRs relacionadas: ADR-0023 (doctor como gate do núcleo), SPEC-009 (doctor-do-nucleo)
|
|
1
|
+
# ADR-0033: `memory-db` distingue permissão/lock de corrupção
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-23
|
|
5
|
+
- **Autor(es)**: Allan Pablo
|
|
6
|
+
- **Tags**: doctor, memory, diagnostics, sqlite
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
O check `memory-db` (`lib/core/health.ts`), consumido por `tools:doctor` e pelo hook
|
|
11
|
+
`SessionStart`, abria `universal.db` e tratava **qualquer** exceção do `better-sqlite3` como
|
|
12
|
+
corrupção:
|
|
13
|
+
|
|
14
|
+
```ts
|
|
15
|
+
} catch (err) {
|
|
16
|
+
return {
|
|
17
|
+
status: 'fail',
|
|
18
|
+
detail: `... (${asErrno(err).code}) — provavelmente corrompido`,
|
|
19
|
+
fix: 'npm run sync:universal',
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
O `err.code` — que já distingue os casos — estava impresso no `detail`, mas não decidia nada.
|
|
25
|
+
Num ambiente sem permissão de escrita (sandbox, FS read-only, diretório protegido) o driver
|
|
26
|
+
lança `SQLITE_CANTOPEN`, e o doctor diagnosticava "provavelmente corrompido" prescrevendo
|
|
27
|
+
`sync:universal`. A prescrição é ativamente errada: `sync:universal` **escreve** no banco — no
|
|
28
|
+
mesmo ambiente ele reencena o `CANTOPEN` sem curar nada, e ainda confunde o operador levando-o a
|
|
29
|
+
"reindexar" um banco íntegro. Reportado a partir de uma sessão real em sandbox restrito.
|
|
30
|
+
|
|
31
|
+
É a violação do princípio 1 do próprio `health.ts` ("nunca colapsar causas distintas num
|
|
32
|
+
booleano"), a mesma classe do bug de ABI que motivou a SPEC-009 — sobrevivendo dentro do arquivo
|
|
33
|
+
escrito para fechá-la.
|
|
34
|
+
|
|
35
|
+
## Decisão
|
|
36
|
+
|
|
37
|
+
Classificar a falha de abertura por `err.code`, uma causa por prescrição:
|
|
38
|
+
|
|
39
|
+
- `SQLITE_CANTOPEN` / `EACCES` → `fail`, **permissão/sandbox**, não corrupção; fix orienta
|
|
40
|
+
garantir leitura no path e **desaconselha** `sync:universal`.
|
|
41
|
+
- `SQLITE_BUSY` → `warn` (lock temporário de outro processo; não trava o gate); fix é aguardar.
|
|
42
|
+
- Resto (`SQLITE_CORRUPT`, `SQLITE_NOTADB`, …) → `fail`, **corrupção**; fix `npm run sync:universal`.
|
|
43
|
+
|
|
44
|
+
## Alternativas consideradas
|
|
45
|
+
|
|
46
|
+
- **Testar a integridade com `PRAGMA quick_check` antes de classificar** — rejeitada: um banco que
|
|
47
|
+
nem abre (CANTOPEN) não chega ao pragma; o `err.code` da abertura já carrega a distinção sem I/O extra.
|
|
48
|
+
- **Discriminar por mensagem de erro** — rejeitada: mensagens do SQLite variam entre versões e
|
|
49
|
+
locale; `err.code` é o contrato estável, como o resto do `health.ts` já assume.
|
|
50
|
+
|
|
51
|
+
## Consequências
|
|
52
|
+
|
|
53
|
+
**Positivas**:
|
|
54
|
+
- Sandbox/permissão deixa de ser confundido com corrupção; o operador recebe a correção da causa real.
|
|
55
|
+
- `sync:universal` nunca é prescrito para um banco íntegro-mas-inacessível.
|
|
56
|
+
- Lock concorrente vira `warn`, não reprova o núcleo.
|
|
57
|
+
|
|
58
|
+
**Negativas / Trade-offs**:
|
|
59
|
+
- Mais um `err.code` (`SQLITE_BUSY`) a manter caso o driver mude a taxonomia — coberto por teste.
|
|
60
|
+
|
|
61
|
+
## Rastreamento
|
|
62
|
+
- Implementação: `lib/core/health.ts` (check `memory-db`)
|
|
63
|
+
- Testes: `test/health.test.js` (CANTOPEN, EACCES, BUSY, NOTADB)
|
|
64
|
+
- ADRs relacionadas: ADR-0023 (doctor como gate do núcleo), SPEC-009 (doctor-do-nucleo)
|
|
@@ -1,29 +1,29 @@
|
|
|
1
|
-
# ADR-0034: Fundação 2.0 em contratos versionados e domínio independente
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-31
|
|
5
|
-
- **Autor(es)**: ForjaJS
|
|
6
|
-
- **Tags**: architecture, contracts, domain, migration
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
O ForjaJS 1.x é um CLI TypeScript com memória SQLite e adapters misturados à operação. A 2.0
|
|
11
|
-
precisa ser consumível por CLI, MCP, SDK, worker e NestJS sem duplicar regras ou contaminar o
|
|
12
|
-
domínio com frameworks.
|
|
13
|
-
|
|
14
|
-
## Decisão
|
|
15
|
-
|
|
16
|
-
Introduzir `packages/contracts` como fonte versionada dos contratos públicos e adotar a direção
|
|
17
|
-
interfaces → adapters → application → domain. A primeira entrega é aditiva; a compatibilidade
|
|
18
|
-
1.x continua roteada pelo CLI até cada capability possuir equivalente 2.0.
|
|
19
|
-
|
|
20
|
-
## Consequências
|
|
21
|
-
|
|
22
|
-
Contratos podem ser testados sem infraestrutura e adapters ficam substituíveis. O custo inicial
|
|
23
|
-
é manter versões, schemas e compatibilidade explícita.
|
|
24
|
-
|
|
25
|
-
## Rastreamento
|
|
26
|
-
|
|
27
|
-
- Implementação: `packages/contracts/`
|
|
28
|
-
- Arquitetura: `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
|
|
29
|
-
- Visão: `docs/vision/FORJA-2.0-VISION.md`
|
|
1
|
+
# ADR-0034: Fundação 2.0 em contratos versionados e domínio independente
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-31
|
|
5
|
+
- **Autor(es)**: ForjaJS
|
|
6
|
+
- **Tags**: architecture, contracts, domain, migration
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
O ForjaJS 1.x é um CLI TypeScript com memória SQLite e adapters misturados à operação. A 2.0
|
|
11
|
+
precisa ser consumível por CLI, MCP, SDK, worker e NestJS sem duplicar regras ou contaminar o
|
|
12
|
+
domínio com frameworks.
|
|
13
|
+
|
|
14
|
+
## Decisão
|
|
15
|
+
|
|
16
|
+
Introduzir `packages/contracts` como fonte versionada dos contratos públicos e adotar a direção
|
|
17
|
+
interfaces → adapters → application → domain. A primeira entrega é aditiva; a compatibilidade
|
|
18
|
+
1.x continua roteada pelo CLI até cada capability possuir equivalente 2.0.
|
|
19
|
+
|
|
20
|
+
## Consequências
|
|
21
|
+
|
|
22
|
+
Contratos podem ser testados sem infraestrutura e adapters ficam substituíveis. O custo inicial
|
|
23
|
+
é manter versões, schemas e compatibilidade explícita.
|
|
24
|
+
|
|
25
|
+
## Rastreamento
|
|
26
|
+
|
|
27
|
+
- Implementação: `packages/contracts/`
|
|
28
|
+
- Arquitetura: `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
|
|
29
|
+
- Visão: `docs/vision/FORJA-2.0-VISION.md`
|
|
@@ -1,23 +1,23 @@
|
|
|
1
|
-
# ADR-0035: SQLite local-first e autonomia supervisionada
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-31
|
|
5
|
-
- **Autor(es)**: ForjaJS
|
|
6
|
-
- **Tags**: runtime, policy, sqlite, autonomy
|
|
7
|
-
|
|
8
|
-
## Decisão
|
|
9
|
-
|
|
10
|
-
SQLite é o backend local padrão para estado durável, eventos, auditoria, memória e checkpoints.
|
|
11
|
-
O nível padrão de autonomia é supervisionado: toda ação crítica passa pelo Policy Engine e uma
|
|
12
|
-
execução só termina após validação independente. Operações longas devem ser retomáveis.
|
|
13
|
-
|
|
14
|
-
## Alternativas rejeitadas
|
|
15
|
-
|
|
16
|
-
- banco remoto obrigatório — viola offline/local-first;
|
|
17
|
-
- autonomia irrestrita — não permite governança verificável;
|
|
18
|
-
- estado apenas em memória — perde retomada e auditoria.
|
|
19
|
-
|
|
20
|
-
## Rastreamento
|
|
21
|
-
|
|
22
|
-
- `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
|
|
23
|
-
- `packages/contracts/`
|
|
1
|
+
# ADR-0035: SQLite local-first e autonomia supervisionada
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-31
|
|
5
|
+
- **Autor(es)**: ForjaJS
|
|
6
|
+
- **Tags**: runtime, policy, sqlite, autonomy
|
|
7
|
+
|
|
8
|
+
## Decisão
|
|
9
|
+
|
|
10
|
+
SQLite é o backend local padrão para estado durável, eventos, auditoria, memória e checkpoints.
|
|
11
|
+
O nível padrão de autonomia é supervisionado: toda ação crítica passa pelo Policy Engine e uma
|
|
12
|
+
execução só termina após validação independente. Operações longas devem ser retomáveis.
|
|
13
|
+
|
|
14
|
+
## Alternativas rejeitadas
|
|
15
|
+
|
|
16
|
+
- banco remoto obrigatório — viola offline/local-first;
|
|
17
|
+
- autonomia irrestrita — não permite governança verificável;
|
|
18
|
+
- estado apenas em memória — perde retomada e auditoria.
|
|
19
|
+
|
|
20
|
+
## Rastreamento
|
|
21
|
+
|
|
22
|
+
- `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
|
|
23
|
+
- `packages/contracts/`
|
|
@@ -1,30 +1,30 @@
|
|
|
1
|
-
# ADR-0036: Capability Registry como núcleo executável
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-31
|
|
5
|
-
- **Autor(es)**: ForjaJS
|
|
6
|
-
- **Tags**: capabilities, contracts, runtime, architecture
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
CLI, MCP, SDK, API e Runtime precisam descobrir e executar a mesma operação sem duplicar regras.
|
|
11
|
-
Uma lista de comandos não oferece schema, risco, permissões, idempotência ou resultado auditável.
|
|
12
|
-
|
|
13
|
-
## Decisão
|
|
14
|
-
|
|
15
|
-
`packages/core` mantém um registry em memória como núcleo inicial. Cada registro possui definição
|
|
16
|
-
versionada, aliases, validadores de entrada/saída e handler. A entrada é validada antes da
|
|
17
|
-
autorização e do handler; toda execução retorna `ExecutionResult`. Policy é uma porta injetada e
|
|
18
|
-
não uma implementação dentro do registry.
|
|
19
|
-
|
|
20
|
-
## Consequências
|
|
21
|
-
|
|
22
|
-
Interfaces externas podem ser adaptadores finos e testes não precisam de banco ou framework. A
|
|
23
|
-
persistência do registry, schemas especializados e Policy Engine completo ficam para fases
|
|
24
|
-
posteriores.
|
|
25
|
-
|
|
26
|
-
## Rastreamento
|
|
27
|
-
|
|
28
|
-
- Implementação: `packages/core/src/index.ts`
|
|
29
|
-
- Testes: `test/capability-registry.test.js`
|
|
30
|
-
- Arquitetura: `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
|
|
1
|
+
# ADR-0036: Capability Registry como núcleo executável
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-31
|
|
5
|
+
- **Autor(es)**: ForjaJS
|
|
6
|
+
- **Tags**: capabilities, contracts, runtime, architecture
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
CLI, MCP, SDK, API e Runtime precisam descobrir e executar a mesma operação sem duplicar regras.
|
|
11
|
+
Uma lista de comandos não oferece schema, risco, permissões, idempotência ou resultado auditável.
|
|
12
|
+
|
|
13
|
+
## Decisão
|
|
14
|
+
|
|
15
|
+
`packages/core` mantém um registry em memória como núcleo inicial. Cada registro possui definição
|
|
16
|
+
versionada, aliases, validadores de entrada/saída e handler. A entrada é validada antes da
|
|
17
|
+
autorização e do handler; toda execução retorna `ExecutionResult`. Policy é uma porta injetada e
|
|
18
|
+
não uma implementação dentro do registry.
|
|
19
|
+
|
|
20
|
+
## Consequências
|
|
21
|
+
|
|
22
|
+
Interfaces externas podem ser adaptadores finos e testes não precisam de banco ou framework. A
|
|
23
|
+
persistência do registry, schemas especializados e Policy Engine completo ficam para fases
|
|
24
|
+
posteriores.
|
|
25
|
+
|
|
26
|
+
## Rastreamento
|
|
27
|
+
|
|
28
|
+
- Implementação: `packages/core/src/index.ts`
|
|
29
|
+
- Testes: `test/capability-registry.test.js`
|
|
30
|
+
- Arquitetura: `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
|
|
@@ -1,28 +1,28 @@
|
|
|
1
|
-
# ADR-0037: Policy Engine obrigatório e default deny
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-31
|
|
5
|
-
- **Autor(es)**: ForjaJS
|
|
6
|
-
- **Tags**: security, policy, autonomy, approvals
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
Capabilities podem ler, escrever, executar comandos, acessar rede ou afetar um deployment. Uma
|
|
11
|
-
autonomia sem decisão centralizada permite que cada adapter invente suas próprias permissões.
|
|
12
|
-
|
|
13
|
-
## Decisão
|
|
14
|
-
|
|
15
|
-
Toda execução recebe uma porta de Policy Engine. O engine aplica regras determinísticas por
|
|
16
|
-
identidade, papel, capability, projeto, ambiente, risco, categoria e escopo de arquivos. Sem
|
|
17
|
-
regra correspondente, o resultado é `DENY`. Empates têm precedência `DENY`, `REQUIRE_APPROVAL`,
|
|
18
|
-
`ALLOW_WITH_LIMITS`, `ALLOW`. Risco crítico exige aprovação explícita mesmo quando uma regra permite
|
|
19
|
-
a ação. Limites retornados pela política devem ser impostos pelo Runtime.
|
|
20
|
-
|
|
21
|
-
Approval requests são contratos auditáveis; o primeiro ledger é em memória e será substituído por
|
|
22
|
-
adapter persistente sem mudar o domínio.
|
|
23
|
-
|
|
24
|
-
## Rastreamento
|
|
25
|
-
|
|
26
|
-
- Implementação: `packages/policy/src/index.ts`
|
|
27
|
-
- Testes: `test/policy.test.js`, `test/policy-registry.integration.test.js`
|
|
28
|
-
- Relacionadas: ADR-0035, ADR-0036
|
|
1
|
+
# ADR-0037: Policy Engine obrigatório e default deny
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-31
|
|
5
|
+
- **Autor(es)**: ForjaJS
|
|
6
|
+
- **Tags**: security, policy, autonomy, approvals
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
Capabilities podem ler, escrever, executar comandos, acessar rede ou afetar um deployment. Uma
|
|
11
|
+
autonomia sem decisão centralizada permite que cada adapter invente suas próprias permissões.
|
|
12
|
+
|
|
13
|
+
## Decisão
|
|
14
|
+
|
|
15
|
+
Toda execução recebe uma porta de Policy Engine. O engine aplica regras determinísticas por
|
|
16
|
+
identidade, papel, capability, projeto, ambiente, risco, categoria e escopo de arquivos. Sem
|
|
17
|
+
regra correspondente, o resultado é `DENY`. Empates têm precedência `DENY`, `REQUIRE_APPROVAL`,
|
|
18
|
+
`ALLOW_WITH_LIMITS`, `ALLOW`. Risco crítico exige aprovação explícita mesmo quando uma regra permite
|
|
19
|
+
a ação. Limites retornados pela política devem ser impostos pelo Runtime.
|
|
20
|
+
|
|
21
|
+
Approval requests são contratos auditáveis; o primeiro ledger é em memória e será substituído por
|
|
22
|
+
adapter persistente sem mudar o domínio.
|
|
23
|
+
|
|
24
|
+
## Rastreamento
|
|
25
|
+
|
|
26
|
+
- Implementação: `packages/policy/src/index.ts`
|
|
27
|
+
- Testes: `test/policy.test.js`, `test/policy-registry.integration.test.js`
|
|
28
|
+
- Relacionadas: ADR-0035, ADR-0036
|
|
@@ -1,28 +1,28 @@
|
|
|
1
|
-
# ADR-0038: Runtime controlado por estados, limites e validação independente
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-31
|
|
5
|
-
- **Autor(es)**: ForjaJS
|
|
6
|
-
- **Tags**: runtime, autonomy, checkpoint, validation
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
Um agente não pode ser considerado concluído apenas porque um handler terminou. Execuções longas
|
|
11
|
-
precisam ser pausáveis, limitadas, retomáveis e validadas por uma fonte independente.
|
|
12
|
-
|
|
13
|
-
## Decisão
|
|
14
|
-
|
|
15
|
-
`packages/runtime` coordena planner → capabilities autorizadas → checkpoint → validator. Cada run
|
|
16
|
-
possui estado explícito, orçamento, limites de passos/tokens/arquivos/tempo/retries, métricas,
|
|
17
|
-
erros e evidências. A implementação inicial é sequencial e limita concorrência a uma capability
|
|
18
|
-
por vez. `DENY` e aprovação pendente bloqueiam; falhas retryable podem repetir até o limite;
|
|
19
|
-
validação rejeitada nunca produz `completed`.
|
|
20
|
-
|
|
21
|
-
Planner, validator, checkpoint e memória são portas. O primeiro armazenamento é em memória; SQLite
|
|
22
|
-
será um adapter posterior.
|
|
23
|
-
|
|
24
|
-
## Rastreamento
|
|
25
|
-
|
|
26
|
-
- Implementação: `packages/runtime/src/index.ts`
|
|
27
|
-
- Testes: `test/runtime.test.js`
|
|
28
|
-
- Relacionadas: ADR-0035, ADR-0037
|
|
1
|
+
# ADR-0038: Runtime controlado por estados, limites e validação independente
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-31
|
|
5
|
+
- **Autor(es)**: ForjaJS
|
|
6
|
+
- **Tags**: runtime, autonomy, checkpoint, validation
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
Um agente não pode ser considerado concluído apenas porque um handler terminou. Execuções longas
|
|
11
|
+
precisam ser pausáveis, limitadas, retomáveis e validadas por uma fonte independente.
|
|
12
|
+
|
|
13
|
+
## Decisão
|
|
14
|
+
|
|
15
|
+
`packages/runtime` coordena planner → capabilities autorizadas → checkpoint → validator. Cada run
|
|
16
|
+
possui estado explícito, orçamento, limites de passos/tokens/arquivos/tempo/retries, métricas,
|
|
17
|
+
erros e evidências. A implementação inicial é sequencial e limita concorrência a uma capability
|
|
18
|
+
por vez. `DENY` e aprovação pendente bloqueiam; falhas retryable podem repetir até o limite;
|
|
19
|
+
validação rejeitada nunca produz `completed`.
|
|
20
|
+
|
|
21
|
+
Planner, validator, checkpoint e memória são portas. O primeiro armazenamento é em memória; SQLite
|
|
22
|
+
será um adapter posterior.
|
|
23
|
+
|
|
24
|
+
## Rastreamento
|
|
25
|
+
|
|
26
|
+
- Implementação: `packages/runtime/src/index.ts`
|
|
27
|
+
- Testes: `test/runtime.test.js`
|
|
28
|
+
- Relacionadas: ADR-0035, ADR-0037
|
|
@@ -1,31 +1,31 @@
|
|
|
1
|
-
# ADR-0039: Event Bus append-only e Scheduler determinístico local-first
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-31
|
|
5
|
-
- **Autor(es)**: ForjaJS
|
|
6
|
-
- **Tags**: events, scheduler, reliability, local-first
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
Execuções, tarefas, aprovações e mudanças do workspace precisam disparar trabalho sem perder
|
|
11
|
-
ordem, repetir efeitos de forma segura ou ocultar falhas de consumidores.
|
|
12
|
-
|
|
13
|
-
## Decisão
|
|
14
|
-
|
|
15
|
-
O Event Bus usa log append-only, sequência por aggregate, chave de idempotência, consumers com
|
|
16
|
-
retry limitado e dead-letter. O Scheduler suporta one-shot, cron UTC de cinco campos, condição e
|
|
17
|
-
evento, com cancelamento, chave de execução por slot/evento, retries e limite de concorrência.
|
|
18
|
-
As portas permitem substituir o armazenamento em memória por SQLite e o relógio por adapter sem
|
|
19
|
-
mover regra de domínio.
|
|
20
|
-
|
|
21
|
-
## Consequências
|
|
22
|
-
|
|
23
|
-
Falhas ficam observáveis e eventos duplicados não reexecutam efeitos concluídos. A implementação
|
|
24
|
-
em memória não sobrevive a processo; persistência, consumer offsets e recovery serão tratados em
|
|
25
|
-
`adapter-sqlite`/worker.
|
|
26
|
-
|
|
27
|
-
## Rastreamento
|
|
28
|
-
|
|
29
|
-
- Implementação: `packages/events/src/index.ts`, `packages/scheduler/src/index.ts`
|
|
30
|
-
- Testes: `test/events-scheduler.test.js`
|
|
31
|
-
- Relacionadas: ADR-0035, ADR-0038
|
|
1
|
+
# ADR-0039: Event Bus append-only e Scheduler determinístico local-first
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-31
|
|
5
|
+
- **Autor(es)**: ForjaJS
|
|
6
|
+
- **Tags**: events, scheduler, reliability, local-first
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
Execuções, tarefas, aprovações e mudanças do workspace precisam disparar trabalho sem perder
|
|
11
|
+
ordem, repetir efeitos de forma segura ou ocultar falhas de consumidores.
|
|
12
|
+
|
|
13
|
+
## Decisão
|
|
14
|
+
|
|
15
|
+
O Event Bus usa log append-only, sequência por aggregate, chave de idempotência, consumers com
|
|
16
|
+
retry limitado e dead-letter. O Scheduler suporta one-shot, cron UTC de cinco campos, condição e
|
|
17
|
+
evento, com cancelamento, chave de execução por slot/evento, retries e limite de concorrência.
|
|
18
|
+
As portas permitem substituir o armazenamento em memória por SQLite e o relógio por adapter sem
|
|
19
|
+
mover regra de domínio.
|
|
20
|
+
|
|
21
|
+
## Consequências
|
|
22
|
+
|
|
23
|
+
Falhas ficam observáveis e eventos duplicados não reexecutam efeitos concluídos. A implementação
|
|
24
|
+
em memória não sobrevive a processo; persistência, consumer offsets e recovery serão tratados em
|
|
25
|
+
`adapter-sqlite`/worker.
|
|
26
|
+
|
|
27
|
+
## Rastreamento
|
|
28
|
+
|
|
29
|
+
- Implementação: `packages/events/src/index.ts`, `packages/scheduler/src/index.ts`
|
|
30
|
+
- Testes: `test/events-scheduler.test.js`
|
|
31
|
+
- Relacionadas: ADR-0035, ADR-0038
|
|
@@ -1,32 +1,32 @@
|
|
|
1
|
-
# ADR-0040: Context Engine determinístico com orçamento e cache por checksum
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-31
|
|
5
|
-
- **Autor(es)**: ForjaJS
|
|
6
|
-
- **Tags**: context, tokens, cache, memory
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
Enviar memória integral ao agente aumenta custo, repetição e risco de contexto obsoleto. Busca,
|
|
11
|
-
deduplicação, diff e imports são operações determinísticas e não devem depender de LLM.
|
|
12
|
-
|
|
13
|
-
## Decisão
|
|
14
|
-
|
|
15
|
-
O Context Engine recebe candidatos recortados de memória e GraphLoop, exige evidência atual,
|
|
16
|
-
ordena por relevância, deduplica por checksum e seleciona até o orçamento de tokens. O conteúdo
|
|
17
|
-
pode ser omitido no pacote e expandido sob demanda pelo checksum. Cache e métricas são portas e o
|
|
18
|
-
`ContextPackage` registra referências, checksum, tokens selecionados, cache hits e conteúdo não
|
|
19
|
-
utilizado.
|
|
20
|
-
|
|
21
|
-
## Consequências
|
|
22
|
-
|
|
23
|
-
O contexto enviado é menor, auditável e reproduzível. O Engine não lê banco nem arquivos; adapters
|
|
24
|
-
devem produzir candidatos com locators, snippets e evidências. A estimativa atual é bytes UTF-8 / 4,
|
|
25
|
-
compatível com o proxy existente do ForjaJS 1.x.
|
|
26
|
-
|
|
27
|
-
## Rastreamento
|
|
28
|
-
|
|
29
|
-
- Implementação: `packages/context/src/index.ts`
|
|
30
|
-
- Contrato: `packages/contracts/src/index.ts`
|
|
31
|
-
- Testes: `test/context.test.js`
|
|
32
|
-
- Relacionadas: ADR-0003, ADR-0009
|
|
1
|
+
# ADR-0040: Context Engine determinístico com orçamento e cache por checksum
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-31
|
|
5
|
+
- **Autor(es)**: ForjaJS
|
|
6
|
+
- **Tags**: context, tokens, cache, memory
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
Enviar memória integral ao agente aumenta custo, repetição e risco de contexto obsoleto. Busca,
|
|
11
|
+
deduplicação, diff e imports são operações determinísticas e não devem depender de LLM.
|
|
12
|
+
|
|
13
|
+
## Decisão
|
|
14
|
+
|
|
15
|
+
O Context Engine recebe candidatos recortados de memória e GraphLoop, exige evidência atual,
|
|
16
|
+
ordena por relevância, deduplica por checksum e seleciona até o orçamento de tokens. O conteúdo
|
|
17
|
+
pode ser omitido no pacote e expandido sob demanda pelo checksum. Cache e métricas são portas e o
|
|
18
|
+
`ContextPackage` registra referências, checksum, tokens selecionados, cache hits e conteúdo não
|
|
19
|
+
utilizado.
|
|
20
|
+
|
|
21
|
+
## Consequências
|
|
22
|
+
|
|
23
|
+
O contexto enviado é menor, auditável e reproduzível. O Engine não lê banco nem arquivos; adapters
|
|
24
|
+
devem produzir candidatos com locators, snippets e evidências. A estimativa atual é bytes UTF-8 / 4,
|
|
25
|
+
compatível com o proxy existente do ForjaJS 1.x.
|
|
26
|
+
|
|
27
|
+
## Rastreamento
|
|
28
|
+
|
|
29
|
+
- Implementação: `packages/context/src/index.ts`
|
|
30
|
+
- Contrato: `packages/contracts/src/index.ts`
|
|
31
|
+
- Testes: `test/context.test.js`
|
|
32
|
+
- Relacionadas: ADR-0003, ADR-0009
|
|
@@ -1,32 +1,32 @@
|
|
|
1
|
-
# ADR-0041: GraphLoop verificável separado de CodeGraph
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-31
|
|
5
|
-
- **Autor(es)**: ForjaJS
|
|
6
|
-
- **Tags**: graph, memory, evidence, codegraph
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
CodeGraph já existe no ForjaJS 1.x como índice de símbolos e blast radius. A 2.0 precisa de um
|
|
11
|
-
grafo de trabalho mais amplo, com projetos, specs, decisões, execuções, evidências e validade
|
|
12
|
-
temporal, sem transformar o domínio em dependente do binário ou MCP do CodeGraph.
|
|
13
|
-
|
|
14
|
-
## Decisão
|
|
15
|
-
|
|
16
|
-
GraphLoop é um domínio separado. Toda aresta exige endpoints existentes e ao menos uma evidência;
|
|
17
|
-
status e validade temporal participam das consultas. O núcleo oferece paths, impacto, contradições,
|
|
18
|
-
agenda e sync incremental por checksum. Extractors determinísticos têm prioridade para imports,
|
|
19
|
-
links Markdown e artefatos do processo. Relações semiestruturadas de LLM só poderão entrar como
|
|
20
|
-
`inferred`/`hypothesis`, com confiança e evidência revisável.
|
|
21
|
-
|
|
22
|
-
## Consequências
|
|
23
|
-
|
|
24
|
-
O grafo pode operar offline e receber fontes diferentes, inclusive CodeGraph, sem acoplamento. O
|
|
25
|
-
primeiro store é em memória; persistência SQLite e extractors de commits/diffs/specs completos
|
|
26
|
-
serão adapters/expansões posteriores.
|
|
27
|
-
|
|
28
|
-
## Rastreamento
|
|
29
|
-
|
|
30
|
-
- Implementação: `packages/graph/src/index.ts`
|
|
31
|
-
- Testes: `test/graph.test.js`
|
|
32
|
-
- Relacionadas: ADR-0017, ADR-0040
|
|
1
|
+
# ADR-0041: GraphLoop verificável separado de CodeGraph
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-31
|
|
5
|
+
- **Autor(es)**: ForjaJS
|
|
6
|
+
- **Tags**: graph, memory, evidence, codegraph
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
|
|
10
|
+
CodeGraph já existe no ForjaJS 1.x como índice de símbolos e blast radius. A 2.0 precisa de um
|
|
11
|
+
grafo de trabalho mais amplo, com projetos, specs, decisões, execuções, evidências e validade
|
|
12
|
+
temporal, sem transformar o domínio em dependente do binário ou MCP do CodeGraph.
|
|
13
|
+
|
|
14
|
+
## Decisão
|
|
15
|
+
|
|
16
|
+
GraphLoop é um domínio separado. Toda aresta exige endpoints existentes e ao menos uma evidência;
|
|
17
|
+
status e validade temporal participam das consultas. O núcleo oferece paths, impacto, contradições,
|
|
18
|
+
agenda e sync incremental por checksum. Extractors determinísticos têm prioridade para imports,
|
|
19
|
+
links Markdown e artefatos do processo. Relações semiestruturadas de LLM só poderão entrar como
|
|
20
|
+
`inferred`/`hypothesis`, com confiança e evidência revisável.
|
|
21
|
+
|
|
22
|
+
## Consequências
|
|
23
|
+
|
|
24
|
+
O grafo pode operar offline e receber fontes diferentes, inclusive CodeGraph, sem acoplamento. O
|
|
25
|
+
primeiro store é em memória; persistência SQLite e extractors de commits/diffs/specs completos
|
|
26
|
+
serão adapters/expansões posteriores.
|
|
27
|
+
|
|
28
|
+
## Rastreamento
|
|
29
|
+
|
|
30
|
+
- Implementação: `packages/graph/src/index.ts`
|
|
31
|
+
- Testes: `test/graph.test.js`
|
|
32
|
+
- Relacionadas: ADR-0017, ADR-0040
|