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,30 +1,30 @@
|
|
|
1
|
-
# ADR-0010: Banco principal em Postgres
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-05-22
|
|
5
|
-
- **Autor(es)**: apk
|
|
6
|
-
- **Tags**: data, architecture
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
O projeto precisa armazenar inventario, checks, alertas e historico de disponibilidade com retencao de 12 meses, alem de suportar consultas por empresa e relatarios mensais. A operacao e self-hosted em Debian 13 com Dokploy.
|
|
10
|
-
|
|
11
|
-
## Decisao
|
|
12
|
-
Usar **Postgres** como banco de dados principal para inventario, checks, alertas e storage.
|
|
13
|
-
|
|
14
|
-
## Alternativas consideradas
|
|
15
|
-
- **SQLite**: rejeitada por concorrencia limitada e maior risco de bloqueio com historico de checks.
|
|
16
|
-
- **Banco timeseries dedicado**: rejeitado por aumentar complexidade operacional na v1.
|
|
17
|
-
|
|
18
|
-
## Consequencias
|
|
19
|
-
**Positivas**:
|
|
20
|
-
- Melhor concorrencia e indices para consultas por empresa e periodo.
|
|
21
|
-
- Evolucao de schema mais segura para crescimento futuro.
|
|
22
|
-
|
|
23
|
-
**Negativas / Trade-offs**:
|
|
24
|
-
- Exige container/servico Postgres e backup separado.
|
|
25
|
-
- Maior custo operacional que SQLite.
|
|
26
|
-
|
|
27
|
-
## Rastreamento
|
|
28
|
-
- Implementacao: `backend/src/modules/*`, `backend/prisma/*`
|
|
29
|
-
- Issues/PRs: n/a
|
|
30
|
-
- ADRs relacionadas: n/a
|
|
1
|
+
# ADR-0010: Banco principal em Postgres
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-05-22
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: data, architecture
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
O projeto precisa armazenar inventario, checks, alertas e historico de disponibilidade com retencao de 12 meses, alem de suportar consultas por empresa e relatarios mensais. A operacao e self-hosted em Debian 13 com Dokploy.
|
|
10
|
+
|
|
11
|
+
## Decisao
|
|
12
|
+
Usar **Postgres** como banco de dados principal para inventario, checks, alertas e storage.
|
|
13
|
+
|
|
14
|
+
## Alternativas consideradas
|
|
15
|
+
- **SQLite**: rejeitada por concorrencia limitada e maior risco de bloqueio com historico de checks.
|
|
16
|
+
- **Banco timeseries dedicado**: rejeitado por aumentar complexidade operacional na v1.
|
|
17
|
+
|
|
18
|
+
## Consequencias
|
|
19
|
+
**Positivas**:
|
|
20
|
+
- Melhor concorrencia e indices para consultas por empresa e periodo.
|
|
21
|
+
- Evolucao de schema mais segura para crescimento futuro.
|
|
22
|
+
|
|
23
|
+
**Negativas / Trade-offs**:
|
|
24
|
+
- Exige container/servico Postgres e backup separado.
|
|
25
|
+
- Maior custo operacional que SQLite.
|
|
26
|
+
|
|
27
|
+
## Rastreamento
|
|
28
|
+
- Implementacao: `backend/src/modules/*`, `backend/prisma/*`
|
|
29
|
+
- Issues/PRs: n/a
|
|
30
|
+
- ADRs relacionadas: n/a
|
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
# ADR-0011…0015: realocadas para o workspace (dados de produto)
|
|
2
|
-
|
|
3
|
-
- **Status**: superseded (realocação, não reversão)
|
|
4
|
-
- **Data**: 2026-07-06
|
|
5
|
-
- **Autor(es)**: apk
|
|
6
|
-
- **Tags**: governance, workspace, privacy
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
As ADRs 0011–0015 eram decisões de **produto** (monitoramento multiprotocolo, idempotência de recorrência, scheduler, importação CSV, notificações on-demand) tomadas durante o desenvolvimento de um produto gerado — não decisões do framework. Com a separação framework × workspace (ADR-0019) e a preparação do repo para visibilidade pública, dados de produto não podem viver no decision log do framework.
|
|
10
|
-
|
|
11
|
-
## Decisão
|
|
12
|
-
Mover as ADRs 0011–0015 para a ficha do produto de origem no workspace (`<workspace>/memory/30-projects/`), mantendo este tombstone para explicar o gap de numeração. A numeração do framework segue de 0016 em diante.
|
|
13
|
-
|
|
14
|
-
## Consequências
|
|
15
|
-
**Positivas**: decision log do framework contém apenas decisões do framework; repo publicável.
|
|
16
|
-
**Negativas / Trade-offs**: gap 0011–0015 na numeração (documentado aqui).
|
|
17
|
-
|
|
18
|
-
## Rastreamento
|
|
19
|
-
- ADRs relacionadas: ADR-0019 (workspace separado), ADR-0020 (core)
|
|
1
|
+
# ADR-0011…0015: realocadas para o workspace (dados de produto)
|
|
2
|
+
|
|
3
|
+
- **Status**: superseded (realocação, não reversão)
|
|
4
|
+
- **Data**: 2026-07-06
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: governance, workspace, privacy
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
As ADRs 0011–0015 eram decisões de **produto** (monitoramento multiprotocolo, idempotência de recorrência, scheduler, importação CSV, notificações on-demand) tomadas durante o desenvolvimento de um produto gerado — não decisões do framework. Com a separação framework × workspace (ADR-0019) e a preparação do repo para visibilidade pública, dados de produto não podem viver no decision log do framework.
|
|
10
|
+
|
|
11
|
+
## Decisão
|
|
12
|
+
Mover as ADRs 0011–0015 para a ficha do produto de origem no workspace (`<workspace>/memory/30-projects/`), mantendo este tombstone para explicar o gap de numeração. A numeração do framework segue de 0016 em diante.
|
|
13
|
+
|
|
14
|
+
## Consequências
|
|
15
|
+
**Positivas**: decision log do framework contém apenas decisões do framework; repo publicável.
|
|
16
|
+
**Negativas / Trade-offs**: gap 0011–0015 na numeração (documentado aqui).
|
|
17
|
+
|
|
18
|
+
## Rastreamento
|
|
19
|
+
- ADRs relacionadas: ADR-0019 (workspace separado), ADR-0020 (core)
|
|
@@ -1,64 +1,64 @@
|
|
|
1
|
-
# ADR-0016: Integração de capacidades externas (codegraph, harness, ai-engineering)
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-06-15
|
|
5
|
-
- **Autor(es)**: Allan Pablo
|
|
6
|
-
- **Tags**: orchestration, tooling, knowledge-base, mcp, plugins
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
Durante a refatoração do framework `2-projeto-agents`, três produtos externos
|
|
10
|
-
(open-source, baixados em `projects/`, que está 100% no `.gitignore`) foram
|
|
11
|
-
escolhidos para serem alocados como capacidades de primeira classe do framework,
|
|
12
|
-
cobrindo três eixos da refatoração:
|
|
13
|
-
|
|
14
|
-
- **Orquestração de agentes** → `harness-main` (plugin do Claude Code, Apache-2.0):
|
|
15
|
-
fábrica de arquitetura de times de agentes a partir de 6 padrões.
|
|
16
|
-
- **Análise de código** → `codegraph-linux-x64` (CLI binária, MIT): grafo de código
|
|
17
|
-
semântico com servidor MCP (`codegraph_explore`, `codegraph_node`).
|
|
18
|
-
- **Base de conhecimento** → `ai-engineering-from-scratch-main` (currículo, MIT):
|
|
19
|
-
503 lições / 20 fases de AI engineering como material de referência.
|
|
20
|
-
|
|
21
|
-
Restrição: `projects/` é off-limits para edição e não é versionado, logo a
|
|
22
|
-
integração não pode depender de editar nada lá dentro, nem assumir que o conteúdo
|
|
23
|
-
permanece commitado no repo do framework.
|
|
24
|
-
|
|
25
|
-
## Decisão
|
|
26
|
-
Integrar cada produto pelo seu mecanismo nativo, com os artefatos de fiação na raiz
|
|
27
|
-
do framework (versionados), e nunca dentro de `projects/`:
|
|
28
|
-
|
|
29
|
-
1. **codegraph** — binário linkado em `~/.local/bin/codegraph` (desacopla do path
|
|
30
|
-
em `projects/`) e registrado como servidor MCP em **escopo project** (`.mcp.json`
|
|
31
|
-
na raiz do repo, comando `codegraph serve --mcp`). Scripts `npm run code:index|sync|status|query`.
|
|
32
|
-
2. **harness** — marketplace local registrado (`claude plugin marketplace add`) e
|
|
33
|
-
plugin `harness@harness-marketplace` instalado/habilitado (escopo user).
|
|
34
|
-
3. **ai-engineering** — registrado como base de conhecimento/referência em
|
|
35
|
-
`DOC-MAP.md` e `docs/capacidades-externas.md`; não há código a instalar.
|
|
36
|
-
|
|
37
|
-
## Alternativas consideradas
|
|
38
|
-
- **Mover o código para dentro do repo (vendoring)**: rejeitada — são repos externos
|
|
39
|
-
com licenças próprias e tamanho elevado (codegraph traz binário node de ~123MB);
|
|
40
|
-
o usuário pediu "integrar como capacidade", não "mover".
|
|
41
|
-
- **MCP do codegraph em escopo user/global**: rejeitada — a intenção é atar a
|
|
42
|
-
capacidade a *este* repo; escopo project (`.mcp.json`) viaja com o framework.
|
|
43
|
-
- **Carregar harness só por `--plugin-dir` (sessão)**: rejeitada — não persiste;
|
|
44
|
-
marketplace + install dá capacidade permanente.
|
|
45
|
-
|
|
46
|
-
## Consequências
|
|
47
|
-
**Positivas**:
|
|
48
|
-
- Capacidades nativas: harness disponível como plugin, codegraph como ferramentas MCP
|
|
49
|
-
dentro de qualquer sessão Claude Code no repo, ai-engineering como referência catalogada.
|
|
50
|
-
- `.mcp.json` versionado: quem clonar o repo herda o MCP do codegraph.
|
|
51
|
-
- Baixo acoplamento ao conteúdo gitignored de `projects/` para o codegraph (via PATH).
|
|
52
|
-
|
|
53
|
-
**Negativas / Trade-offs**:
|
|
54
|
-
- O symlink do codegraph e o marketplace do harness ainda apontam para
|
|
55
|
-
`projects/codegraph-linux-x64` e `projects/harness-main` no disco local; se essas
|
|
56
|
-
pastas forem removidas, as capacidades quebram (precisam ser reinstaladas).
|
|
57
|
-
- harness fica em escopo **user** (máquina do usuário), não project — não viaja com o repo.
|
|
58
|
-
|
|
59
|
-
## Rastreamento
|
|
60
|
-
- Implementação: `.mcp.json`, `package.json` (scripts `code:*`), `~/.local/bin/codegraph`,
|
|
61
|
-
marketplace `harness-marketplace`, `docs/capacidades-externas.md`, `DOC-MAP.md`
|
|
62
|
-
- Fontes: github.com/colbymchenry/codegraph, github.com/revfactory/harness,
|
|
63
|
-
github.com/rohitg00/ai-engineering-from-scratch
|
|
64
|
-
- ADRs relacionadas: ADR-0008 (sub-agents), ADR-0009 (hooks/token economy)
|
|
1
|
+
# ADR-0016: Integração de capacidades externas (codegraph, harness, ai-engineering)
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-06-15
|
|
5
|
+
- **Autor(es)**: Allan Pablo
|
|
6
|
+
- **Tags**: orchestration, tooling, knowledge-base, mcp, plugins
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
Durante a refatoração do framework `2-projeto-agents`, três produtos externos
|
|
10
|
+
(open-source, baixados em `projects/`, que está 100% no `.gitignore`) foram
|
|
11
|
+
escolhidos para serem alocados como capacidades de primeira classe do framework,
|
|
12
|
+
cobrindo três eixos da refatoração:
|
|
13
|
+
|
|
14
|
+
- **Orquestração de agentes** → `harness-main` (plugin do Claude Code, Apache-2.0):
|
|
15
|
+
fábrica de arquitetura de times de agentes a partir de 6 padrões.
|
|
16
|
+
- **Análise de código** → `codegraph-linux-x64` (CLI binária, MIT): grafo de código
|
|
17
|
+
semântico com servidor MCP (`codegraph_explore`, `codegraph_node`).
|
|
18
|
+
- **Base de conhecimento** → `ai-engineering-from-scratch-main` (currículo, MIT):
|
|
19
|
+
503 lições / 20 fases de AI engineering como material de referência.
|
|
20
|
+
|
|
21
|
+
Restrição: `projects/` é off-limits para edição e não é versionado, logo a
|
|
22
|
+
integração não pode depender de editar nada lá dentro, nem assumir que o conteúdo
|
|
23
|
+
permanece commitado no repo do framework.
|
|
24
|
+
|
|
25
|
+
## Decisão
|
|
26
|
+
Integrar cada produto pelo seu mecanismo nativo, com os artefatos de fiação na raiz
|
|
27
|
+
do framework (versionados), e nunca dentro de `projects/`:
|
|
28
|
+
|
|
29
|
+
1. **codegraph** — binário linkado em `~/.local/bin/codegraph` (desacopla do path
|
|
30
|
+
em `projects/`) e registrado como servidor MCP em **escopo project** (`.mcp.json`
|
|
31
|
+
na raiz do repo, comando `codegraph serve --mcp`). Scripts `npm run code:index|sync|status|query`.
|
|
32
|
+
2. **harness** — marketplace local registrado (`claude plugin marketplace add`) e
|
|
33
|
+
plugin `harness@harness-marketplace` instalado/habilitado (escopo user).
|
|
34
|
+
3. **ai-engineering** — registrado como base de conhecimento/referência em
|
|
35
|
+
`DOC-MAP.md` e `docs/capacidades-externas.md`; não há código a instalar.
|
|
36
|
+
|
|
37
|
+
## Alternativas consideradas
|
|
38
|
+
- **Mover o código para dentro do repo (vendoring)**: rejeitada — são repos externos
|
|
39
|
+
com licenças próprias e tamanho elevado (codegraph traz binário node de ~123MB);
|
|
40
|
+
o usuário pediu "integrar como capacidade", não "mover".
|
|
41
|
+
- **MCP do codegraph em escopo user/global**: rejeitada — a intenção é atar a
|
|
42
|
+
capacidade a *este* repo; escopo project (`.mcp.json`) viaja com o framework.
|
|
43
|
+
- **Carregar harness só por `--plugin-dir` (sessão)**: rejeitada — não persiste;
|
|
44
|
+
marketplace + install dá capacidade permanente.
|
|
45
|
+
|
|
46
|
+
## Consequências
|
|
47
|
+
**Positivas**:
|
|
48
|
+
- Capacidades nativas: harness disponível como plugin, codegraph como ferramentas MCP
|
|
49
|
+
dentro de qualquer sessão Claude Code no repo, ai-engineering como referência catalogada.
|
|
50
|
+
- `.mcp.json` versionado: quem clonar o repo herda o MCP do codegraph.
|
|
51
|
+
- Baixo acoplamento ao conteúdo gitignored de `projects/` para o codegraph (via PATH).
|
|
52
|
+
|
|
53
|
+
**Negativas / Trade-offs**:
|
|
54
|
+
- O symlink do codegraph e o marketplace do harness ainda apontam para
|
|
55
|
+
`projects/codegraph-linux-x64` e `projects/harness-main` no disco local; se essas
|
|
56
|
+
pastas forem removidas, as capacidades quebram (precisam ser reinstaladas).
|
|
57
|
+
- harness fica em escopo **user** (máquina do usuário), não project — não viaja com o repo.
|
|
58
|
+
|
|
59
|
+
## Rastreamento
|
|
60
|
+
- Implementação: `.mcp.json`, `package.json` (scripts `code:*`), `~/.local/bin/codegraph`,
|
|
61
|
+
marketplace `harness-marketplace`, `docs/capacidades-externas.md`, `DOC-MAP.md`
|
|
62
|
+
- Fontes: github.com/colbymchenry/codegraph, github.com/revfactory/harness,
|
|
63
|
+
github.com/rohitg00/ai-engineering-from-scratch
|
|
64
|
+
- ADRs relacionadas: ADR-0008 (sub-agents), ADR-0009 (hooks/token economy)
|
|
@@ -1,40 +1,40 @@
|
|
|
1
|
-
# ADR-0017: Codegraph como gate de primeira classe no harness GSD
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-06-27
|
|
5
|
-
- **Autor(es)**: framework-team
|
|
6
|
-
- **Tags**: orchestration, sdd, gsd, codegraph, code-intelligence
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
O codegraph (grafo de conhecimento SQLite de símbolos/edges, exposto via MCP) já estava instalado e configurado em `.mcp.json`, com scripts `code:index/sync/status/query`. Mas era uma integração **pendurada**: nenhum dos 10 gates do runbook GSD o mencionava, nenhum papel o usava, e o índice apontava para o worktree pai (`2-Projeto-Agents`) em vez de `projects/forja`, retornando símbolos da árvore errada sem erro visível.
|
|
10
|
-
|
|
11
|
-
Resultado prático: o Worker recebia "implemente `tasks.md`" sem nunca consultar o blast radius de um símbolo antes de editar. O `plan.md` listava "módulos afetados" por inspeção manual em vez de pelos chamadores reais. Governança não tinha como saber se o índice era confiável.
|
|
12
|
-
|
|
13
|
-
## Decisão
|
|
14
|
-
Tornar o codegraph um **passo verificável do fluxo GSD**, com degradação graciosa:
|
|
15
|
-
|
|
16
|
-
1. **Comando `code:impact <símbolo>`** em `agent-harness.mjs`: retorna chamadores + arquivos afetados consultando o codegraph. É a ferramenta que o Architect/Worker roda antes de planejar/editar.
|
|
17
|
-
2. **Comando `code:check`**: valida que o índice existe, pertence a este worktree e não está defasado (heurística por mtime + warning de worktree do próprio `codegraph status`).
|
|
18
|
-
3. **Novo gate no runbook GSD**: "Mapa de impacto (codegraph)" entre Contexto e Plano.
|
|
19
|
-
4. **`gsd:check` ganha o gate de freshness**: não-bloqueante se o binário codegraph não existe; bloqueante se o índice pertence a outro worktree.
|
|
20
|
-
|
|
21
|
-
Princípio: nenhum comando novo quebra o fluxo quando codegraph está ausente — avisa e segue. Code intelligence é alavanca, não obstáculo.
|
|
22
|
-
|
|
23
|
-
## Alternativas consideradas
|
|
24
|
-
- **Manter codegraph só como MCP, sem gate** — rejeitada porque uma ferramenta sem gate nem papel que a invoque é ignorada na prática (era o estado atual).
|
|
25
|
-
- **Construir índice de código próprio** — rejeitada: reinventa o codegraph, que já entrega grafo com WAL e watcher.
|
|
26
|
-
- **Bloquear sempre que o índice estiver "defasado"** — rejeitada: gera falso bloqueio; usamos heurística leve (mtime + worktree) em vez de hash por arquivo.
|
|
27
|
-
|
|
28
|
-
## Consequências
|
|
29
|
-
**Positivas**:
|
|
30
|
-
- Architect/Worker editam com blast radius à vista, em menos tokens que reler arquivos
|
|
31
|
-
- Governança ganha sinal objetivo de confiabilidade do índice
|
|
32
|
-
- O grafo deixa de ser decoração e entra no runbook
|
|
33
|
-
|
|
34
|
-
**Negativas / Trade-offs**:
|
|
35
|
-
- Acoplamento leve à CLI do codegraph (mitigado: só `init/status/sync` + MCP, parsing tolerante)
|
|
36
|
-
- Mais um gate no runbook (mitigado: não-bloqueante quando a ferramenta falta)
|
|
37
|
-
|
|
38
|
-
## Rastreamento
|
|
39
|
-
- Implementação: `scripts/agent-harness.mjs`, `package.json`, `specs/harness-codegraph/`
|
|
40
|
-
- ADRs relacionadas: ADR-0003 (smart-context), ADR-0005 (handoff 7 campos), ADR-0018 (ferramentas de processo)
|
|
1
|
+
# ADR-0017: Codegraph como gate de primeira classe no harness GSD
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-06-27
|
|
5
|
+
- **Autor(es)**: framework-team
|
|
6
|
+
- **Tags**: orchestration, sdd, gsd, codegraph, code-intelligence
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
O codegraph (grafo de conhecimento SQLite de símbolos/edges, exposto via MCP) já estava instalado e configurado em `.mcp.json`, com scripts `code:index/sync/status/query`. Mas era uma integração **pendurada**: nenhum dos 10 gates do runbook GSD o mencionava, nenhum papel o usava, e o índice apontava para o worktree pai (`2-Projeto-Agents`) em vez de `projects/forja`, retornando símbolos da árvore errada sem erro visível.
|
|
10
|
+
|
|
11
|
+
Resultado prático: o Worker recebia "implemente `tasks.md`" sem nunca consultar o blast radius de um símbolo antes de editar. O `plan.md` listava "módulos afetados" por inspeção manual em vez de pelos chamadores reais. Governança não tinha como saber se o índice era confiável.
|
|
12
|
+
|
|
13
|
+
## Decisão
|
|
14
|
+
Tornar o codegraph um **passo verificável do fluxo GSD**, com degradação graciosa:
|
|
15
|
+
|
|
16
|
+
1. **Comando `code:impact <símbolo>`** em `agent-harness.mjs`: retorna chamadores + arquivos afetados consultando o codegraph. É a ferramenta que o Architect/Worker roda antes de planejar/editar.
|
|
17
|
+
2. **Comando `code:check`**: valida que o índice existe, pertence a este worktree e não está defasado (heurística por mtime + warning de worktree do próprio `codegraph status`).
|
|
18
|
+
3. **Novo gate no runbook GSD**: "Mapa de impacto (codegraph)" entre Contexto e Plano.
|
|
19
|
+
4. **`gsd:check` ganha o gate de freshness**: não-bloqueante se o binário codegraph não existe; bloqueante se o índice pertence a outro worktree.
|
|
20
|
+
|
|
21
|
+
Princípio: nenhum comando novo quebra o fluxo quando codegraph está ausente — avisa e segue. Code intelligence é alavanca, não obstáculo.
|
|
22
|
+
|
|
23
|
+
## Alternativas consideradas
|
|
24
|
+
- **Manter codegraph só como MCP, sem gate** — rejeitada porque uma ferramenta sem gate nem papel que a invoque é ignorada na prática (era o estado atual).
|
|
25
|
+
- **Construir índice de código próprio** — rejeitada: reinventa o codegraph, que já entrega grafo com WAL e watcher.
|
|
26
|
+
- **Bloquear sempre que o índice estiver "defasado"** — rejeitada: gera falso bloqueio; usamos heurística leve (mtime + worktree) em vez de hash por arquivo.
|
|
27
|
+
|
|
28
|
+
## Consequências
|
|
29
|
+
**Positivas**:
|
|
30
|
+
- Architect/Worker editam com blast radius à vista, em menos tokens que reler arquivos
|
|
31
|
+
- Governança ganha sinal objetivo de confiabilidade do índice
|
|
32
|
+
- O grafo deixa de ser decoração e entra no runbook
|
|
33
|
+
|
|
34
|
+
**Negativas / Trade-offs**:
|
|
35
|
+
- Acoplamento leve à CLI do codegraph (mitigado: só `init/status/sync` + MCP, parsing tolerante)
|
|
36
|
+
- Mais um gate no runbook (mitigado: não-bloqueante quando a ferramenta falta)
|
|
37
|
+
|
|
38
|
+
## Rastreamento
|
|
39
|
+
- Implementação: `scripts/agent-harness.mjs`, `package.json`, `specs/harness-codegraph/`
|
|
40
|
+
- ADRs relacionadas: ADR-0003 (smart-context), ADR-0005 (handoff 7 campos), ADR-0018 (ferramentas de processo)
|
|
@@ -1,46 +1,46 @@
|
|
|
1
|
-
# ADR-0018: Ferramentas de processo opcionais com detecção via tools:doctor
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-06-27
|
|
5
|
-
- **Autor(es)**: framework-team
|
|
6
|
-
- **Tags**: tooling, governance, dx, security
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
O harness pede `project:check`, `spec:check` e testes — mas todos manuais. Há ganhos práticos de processo parados por falta de mecânica:
|
|
10
|
-
- **Pré-commit** que rode os checks antes do commit (hoje dependem de disciplina humana).
|
|
11
|
-
- **Varredura de segredos** no gate de Governança (o projeto teve fase de hardening de segurança, mas não há scanner).
|
|
12
|
-
- **Busca/codemod estrutural** (codegraph dá relações; falta reescrita por padrão de AST).
|
|
13
|
-
- **Lint de docs**, dado que a documentação é central e enorme.
|
|
14
|
-
|
|
15
|
-
O risco é o oposto: exigir um zoológico de dependências que trava ambientes que não as têm.
|
|
16
|
-
|
|
17
|
-
## Decisão
|
|
18
|
-
Adotar ferramentas de processo como **camada opcional, detectada, nunca imposta**:
|
|
19
|
-
|
|
20
|
-
| Ferramenta | Papel no processo | Como entra |
|
|
21
|
-
|---|---|---|
|
|
22
|
-
| **codegraph** | code intelligence (relações, blast radius) | gate GSD (ADR-0017) |
|
|
23
|
-
| **gitleaks** | varredura de segredos no review | gate opcional de Governance |
|
|
24
|
-
| **ast-grep (`sg`)** | busca/codemod estrutural por AST | ferramenta do Worker para refactor |
|
|
25
|
-
| **lefthook** | pré-commit rodando `project:check`/`spec:check` | hook git opcional |
|
|
26
|
-
| **markdownlint-cli2** | lint da documentação | check opcional |
|
|
27
|
-
|
|
28
|
-
Mecânica: `scripts/tools-doctor.mjs` (`npm run tools:doctor`) detecta cada binário e reporta instalado/ausente + comando de instalação. Governança decide quais gates ativar conforme disponibilidade. Nenhum check novo é bloqueante por padrão quando a ferramenta falta.
|
|
29
|
-
|
|
30
|
-
## Alternativas consideradas
|
|
31
|
-
- **Tornar gitleaks/lefthook dependências obrigatórias** — rejeitada: quebra ambientes mínimos e CI alheios.
|
|
32
|
-
- **Não documentar nada e deixar cada projeto escolher** — rejeitada: perde a padronização que o objetivo pede ("próximos projetos usam esta estrutura").
|
|
33
|
-
- **Embutir as ferramentas como devDependencies npm** — rejeitada para binários nativos (codegraph, gitleaks, ast-grep) que não vivem bem no npm; ficam como detecção + instrução.
|
|
34
|
-
|
|
35
|
-
## Consequências
|
|
36
|
-
**Positivas**:
|
|
37
|
-
- Caminho claro de evolução do processo sem travar quem não tem as ferramentas
|
|
38
|
-
- Governança ganha checklist objetivo do que pode exigir
|
|
39
|
-
- `tools:doctor` vira o "raio-x" de prontidão do ambiente
|
|
40
|
-
|
|
41
|
-
**Negativas / Trade-offs**:
|
|
42
|
-
- Detecção sem imposição significa que o gate pode ser pulado num ambiente sem a ferramenta (aceito: documentado como degradação graciosa)
|
|
43
|
-
|
|
44
|
-
## Rastreamento
|
|
45
|
-
- Implementação: `scripts/tools-doctor.mjs`, `package.json`, `.lefthook.yml` (opcional)
|
|
46
|
-
- ADRs relacionadas: ADR-0017 (codegraph), ADR-0009 (hooks/token economy)
|
|
1
|
+
# ADR-0018: Ferramentas de processo opcionais com detecção via tools:doctor
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-06-27
|
|
5
|
+
- **Autor(es)**: framework-team
|
|
6
|
+
- **Tags**: tooling, governance, dx, security
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
O harness pede `project:check`, `spec:check` e testes — mas todos manuais. Há ganhos práticos de processo parados por falta de mecânica:
|
|
10
|
+
- **Pré-commit** que rode os checks antes do commit (hoje dependem de disciplina humana).
|
|
11
|
+
- **Varredura de segredos** no gate de Governança (o projeto teve fase de hardening de segurança, mas não há scanner).
|
|
12
|
+
- **Busca/codemod estrutural** (codegraph dá relações; falta reescrita por padrão de AST).
|
|
13
|
+
- **Lint de docs**, dado que a documentação é central e enorme.
|
|
14
|
+
|
|
15
|
+
O risco é o oposto: exigir um zoológico de dependências que trava ambientes que não as têm.
|
|
16
|
+
|
|
17
|
+
## Decisão
|
|
18
|
+
Adotar ferramentas de processo como **camada opcional, detectada, nunca imposta**:
|
|
19
|
+
|
|
20
|
+
| Ferramenta | Papel no processo | Como entra |
|
|
21
|
+
|---|---|---|
|
|
22
|
+
| **codegraph** | code intelligence (relações, blast radius) | gate GSD (ADR-0017) |
|
|
23
|
+
| **gitleaks** | varredura de segredos no review | gate opcional de Governance |
|
|
24
|
+
| **ast-grep (`sg`)** | busca/codemod estrutural por AST | ferramenta do Worker para refactor |
|
|
25
|
+
| **lefthook** | pré-commit rodando `project:check`/`spec:check` | hook git opcional |
|
|
26
|
+
| **markdownlint-cli2** | lint da documentação | check opcional |
|
|
27
|
+
|
|
28
|
+
Mecânica: `scripts/tools-doctor.mjs` (`npm run tools:doctor`) detecta cada binário e reporta instalado/ausente + comando de instalação. Governança decide quais gates ativar conforme disponibilidade. Nenhum check novo é bloqueante por padrão quando a ferramenta falta.
|
|
29
|
+
|
|
30
|
+
## Alternativas consideradas
|
|
31
|
+
- **Tornar gitleaks/lefthook dependências obrigatórias** — rejeitada: quebra ambientes mínimos e CI alheios.
|
|
32
|
+
- **Não documentar nada e deixar cada projeto escolher** — rejeitada: perde a padronização que o objetivo pede ("próximos projetos usam esta estrutura").
|
|
33
|
+
- **Embutir as ferramentas como devDependencies npm** — rejeitada para binários nativos (codegraph, gitleaks, ast-grep) que não vivem bem no npm; ficam como detecção + instrução.
|
|
34
|
+
|
|
35
|
+
## Consequências
|
|
36
|
+
**Positivas**:
|
|
37
|
+
- Caminho claro de evolução do processo sem travar quem não tem as ferramentas
|
|
38
|
+
- Governança ganha checklist objetivo do que pode exigir
|
|
39
|
+
- `tools:doctor` vira o "raio-x" de prontidão do ambiente
|
|
40
|
+
|
|
41
|
+
**Negativas / Trade-offs**:
|
|
42
|
+
- Detecção sem imposição significa que o gate pode ser pulado num ambiente sem a ferramenta (aceito: documentado como degradação graciosa)
|
|
43
|
+
|
|
44
|
+
## Rastreamento
|
|
45
|
+
- Implementação: `scripts/tools-doctor.mjs`, `package.json`, `.lefthook.yml` (opcional)
|
|
46
|
+
- ADRs relacionadas: ADR-0017 (codegraph), ADR-0009 (hooks/token economy)
|
|
@@ -1,45 +1,45 @@
|
|
|
1
|
-
# ADR-0019: Workspace separado para projetos de produto
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-01
|
|
5
|
-
- **Autor(es)**: apk
|
|
6
|
-
- **Tags**: workspace, memory, orchestration, cli-first
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
O Forja nasceu como framework e, ao mesmo tempo, gerador de projetos. Os projetos gerados foram colocados em `projects/` dentro do mesmo repositório, gitignored. Com o tempo, isso gerou atrito:
|
|
10
|
-
|
|
11
|
-
- O worktree do framework ficava poluído com dados de produto (códigos, specs, memória).
|
|
12
|
-
- A memória universal (`memory/30-projects/`, `.memory/sqlite/universal.db`) convivia com a memória do framework, dificultando versionar um sem o outro.
|
|
13
|
-
- `init-project.js` tinha lógica ambígua: se o nome não contivesse `/`, colocava em `projects/<nome>`; caso contrário, usava o path fornecido.
|
|
14
|
-
- Não havia um "canto fixo" óbvio para novos projetos, aumentando a chance de perda ou commit acidental.
|
|
15
|
-
|
|
16
|
-
## Decisão
|
|
17
|
-
Separar o **framework Forja** do **workspace de produção**.
|
|
18
|
-
|
|
19
|
-
- O workspace padrão fica em `~/forja-workspace`.
|
|
20
|
-
- Todo projeto novo é criado obrigatoriamente em `~/forja-workspace/projects/<nome>`.
|
|
21
|
-
- A memória universal dos produtos fica em `~/forja-workspace/memory/` (incluindo `sqlite/universal.db` e `30-projects/`).
|
|
22
|
-
- O workspace é configurável via variável de ambiente `FORJA_WORKSPACE` ou arquivo `~/.forjarc.json`; o default é `~/forja-workspace`.
|
|
23
|
-
- A resolução de caminhos é centralizada em `lib/workspace.mjs`.
|
|
24
|
-
|
|
25
|
-
## Alternativas consideradas
|
|
26
|
-
- **Manter `projects/` dentro do repo do framework**: rejeitada porque mantém a poluição do worktree e dificulta versionar/backupear produtos separadamente.
|
|
27
|
-
- **Usar submódulos Git para cada projeto**: rejeitada porque adiciona complexidade de versionamento sem ganho operacional claro.
|
|
28
|
-
- **Workspace como subpasta irmã (`../forja-workspace`)**: rejeitada porque depende da localização do clone do framework; `~/forja-workspace` é previsível em qualquer máquina.
|
|
29
|
-
|
|
30
|
-
## Consequências
|
|
31
|
-
**Positivas**:
|
|
32
|
-
- Repo do framework fica limpo e versionável sem dados de produto.
|
|
33
|
-
- Projetos têm um "canto fixo" previsível.
|
|
34
|
-
- Backup e remoção de produtos ficam independentes do framework.
|
|
35
|
-
- É possível reinstalar ou mover o framework sem tocar nos produtos.
|
|
36
|
-
|
|
37
|
-
**Negativas / Trade-offs**:
|
|
38
|
-
- Usuários precisam saber que o workspace existe fora do repo (documentação e comandos devem deixar isso explícito).
|
|
39
|
-
- Projetos antigos em `projects/` do repo não são migrados automaticamente; migração é manual.
|
|
40
|
-
- Ferramentas que assumiam paths relativos ao repo do framework precisam ser atualizadas.
|
|
41
|
-
|
|
42
|
-
## Rastreamento
|
|
43
|
-
- Implementação: `lib/workspace.mjs`, `bin/init-project.js`, `scripts/*`, `package.json`, `README.md`, `AGENTS.md`, `docs/structure.md`, `docs/init-project.md`.
|
|
44
|
-
- Spec: `specs/reestruturacao-forja-v2/`
|
|
45
|
-
- ADRs relacionadas: ADR-0001, ADR-0003, ADR-0005, ADR-0008, ADR-0017, ADR-0018.
|
|
1
|
+
# ADR-0019: Workspace separado para projetos de produto
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-01
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: workspace, memory, orchestration, cli-first
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
O Forja nasceu como framework e, ao mesmo tempo, gerador de projetos. Os projetos gerados foram colocados em `projects/` dentro do mesmo repositório, gitignored. Com o tempo, isso gerou atrito:
|
|
10
|
+
|
|
11
|
+
- O worktree do framework ficava poluído com dados de produto (códigos, specs, memória).
|
|
12
|
+
- A memória universal (`memory/30-projects/`, `.memory/sqlite/universal.db`) convivia com a memória do framework, dificultando versionar um sem o outro.
|
|
13
|
+
- `init-project.js` tinha lógica ambígua: se o nome não contivesse `/`, colocava em `projects/<nome>`; caso contrário, usava o path fornecido.
|
|
14
|
+
- Não havia um "canto fixo" óbvio para novos projetos, aumentando a chance de perda ou commit acidental.
|
|
15
|
+
|
|
16
|
+
## Decisão
|
|
17
|
+
Separar o **framework Forja** do **workspace de produção**.
|
|
18
|
+
|
|
19
|
+
- O workspace padrão fica em `~/forja-workspace`.
|
|
20
|
+
- Todo projeto novo é criado obrigatoriamente em `~/forja-workspace/projects/<nome>`.
|
|
21
|
+
- A memória universal dos produtos fica em `~/forja-workspace/memory/` (incluindo `sqlite/universal.db` e `30-projects/`).
|
|
22
|
+
- O workspace é configurável via variável de ambiente `FORJA_WORKSPACE` ou arquivo `~/.forjarc.json`; o default é `~/forja-workspace`.
|
|
23
|
+
- A resolução de caminhos é centralizada em `lib/workspace.mjs`.
|
|
24
|
+
|
|
25
|
+
## Alternativas consideradas
|
|
26
|
+
- **Manter `projects/` dentro do repo do framework**: rejeitada porque mantém a poluição do worktree e dificulta versionar/backupear produtos separadamente.
|
|
27
|
+
- **Usar submódulos Git para cada projeto**: rejeitada porque adiciona complexidade de versionamento sem ganho operacional claro.
|
|
28
|
+
- **Workspace como subpasta irmã (`../forja-workspace`)**: rejeitada porque depende da localização do clone do framework; `~/forja-workspace` é previsível em qualquer máquina.
|
|
29
|
+
|
|
30
|
+
## Consequências
|
|
31
|
+
**Positivas**:
|
|
32
|
+
- Repo do framework fica limpo e versionável sem dados de produto.
|
|
33
|
+
- Projetos têm um "canto fixo" previsível.
|
|
34
|
+
- Backup e remoção de produtos ficam independentes do framework.
|
|
35
|
+
- É possível reinstalar ou mover o framework sem tocar nos produtos.
|
|
36
|
+
|
|
37
|
+
**Negativas / Trade-offs**:
|
|
38
|
+
- Usuários precisam saber que o workspace existe fora do repo (documentação e comandos devem deixar isso explícito).
|
|
39
|
+
- Projetos antigos em `projects/` do repo não são migrados automaticamente; migração é manual.
|
|
40
|
+
- Ferramentas que assumiam paths relativos ao repo do framework precisam ser atualizadas.
|
|
41
|
+
|
|
42
|
+
## Rastreamento
|
|
43
|
+
- Implementação: `lib/workspace.mjs`, `bin/init-project.js`, `scripts/*`, `package.json`, `README.md`, `AGENTS.md`, `docs/structure.md`, `docs/init-project.md`.
|
|
44
|
+
- Spec: `specs/reestruturacao-forja-v2/`
|
|
45
|
+
- ADRs relacionadas: ADR-0001, ADR-0003, ADR-0005, ADR-0008, ADR-0017, ADR-0018.
|
|
@@ -1,45 +1,45 @@
|
|
|
1
|
-
# ADR-0020: CLI única `forja` como core executivo dos comandos
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-07-06
|
|
5
|
-
- **Autor(es)**: apk
|
|
6
|
-
- **Tags**: cli, orchestration, governance, workspace
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
Os comandos do Forja cresceram em três camadas paralelas sem núcleo comum: `scripts/agent-harness.mjs` (workspace/GSD/code), `scripts/dev.mjs` (context/memória, duplicando parte do harness) e ~40 scripts npm apontando direto para scripts soltos — com a chave `project:check` duplicada no `package.json`. Não havia trilha de auditoria unificada, gates eram aplicados de forma desigual e a resolução do workspace (ADR-0019) dependia de cada script lembrar de usá-la. Projetos criados por `project:new` não eram registrados em ficha alguma.
|
|
10
|
-
|
|
11
|
-
O posicionamento do produto ("processo que governa" como pilar) exige que o processo passe, de fato, por um ponto governável.
|
|
12
|
-
|
|
13
|
-
## Decisão
|
|
14
|
-
Criar o **core executivo** do Forja:
|
|
15
|
-
|
|
16
|
-
- `bin/forja.mjs` — dispatcher único; todo comando de processo roda como `forja <comando>`.
|
|
17
|
-
- `lib/core/registry.mjs` — registry declarativo: domínio, descrição, alvo (script ou binário) e gates por comando.
|
|
18
|
-
- **Gates transversais** aplicados pelo core antes do alvo: `workspace` (comandos de produto falham cedo sem workspace, com instrução de correção).
|
|
19
|
-
- **Auditoria append-only**: cada execução gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback `.context/` do repo), com ts, cmd, args, exitCode, durationMs. Falha de auditoria nunca bloqueia o comando.
|
|
20
|
-
- Scripts npm viram aliases finos para `node bin/forja.mjs <cmd>`; `forja` é publicado em `"bin"`.
|
|
21
|
-
- `project:new` passa a registrar ficha automática em `<workspace>/memory/30-projects/<nome>.md`.
|
|
22
|
-
- `agent-harness.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. permanecem como implementação roteada; `dev.mjs` vira alias legado.
|
|
23
|
-
|
|
24
|
-
## Alternativas consideradas
|
|
25
|
-
- **Promover `agent-harness.mjs` a core**: rejeitada porque mistura implementação de gates GSD com roteamento; o registry declarativo separa "o que existe" de "como executa".
|
|
26
|
-
- **Promover `dev.mjs` a core**: rejeitada porque seu registry embute handlers (não é declarativo) e já nasceu duplicando o harness.
|
|
27
|
-
- **Registrar auditoria direto no SQLite universal**: adiada; JSONL em `.context/` é append-only, sem dependência e legível por humanos. Promoção a tabela pode vir depois via `sync:universal`.
|
|
28
|
-
- **Manter scripts npm diretos**: rejeitada porque perpetua a ausência de gates/auditoria — o problema que motivou a decisão.
|
|
29
|
-
|
|
30
|
-
## Consequências
|
|
31
|
-
**Positivas**:
|
|
32
|
-
- Um único ponto de entrada auditável; help agrupado por domínio.
|
|
33
|
-
- Gates de processo aplicados uniformemente (workspace hoje; extensível para spec/governance).
|
|
34
|
-
- Todo projeto nasce registrado no workspace.
|
|
35
|
-
- npm scripts ficam finos e sem duplicatas.
|
|
36
|
-
|
|
37
|
-
**Negativas / Trade-offs**:
|
|
38
|
-
- Um spawn adicional por comando (npm → forja → script), ~dezenas de ms.
|
|
39
|
-
- Registry precisa acompanhar novos scripts (mitigado por teste de integridade).
|
|
40
|
-
- `dev.mjs` convive como caminho legado até ser absorvido.
|
|
41
|
-
|
|
42
|
-
## Rastreamento
|
|
43
|
-
- Implementação: `bin/forja.mjs`, `lib/core/registry.mjs`, `package.json`, `scripts/agent-harness.mjs`, `test/forja-core.test.js`
|
|
44
|
-
- Issues/PRs: SPEC-025 (`specs/forja-core/spec.md`)
|
|
45
|
-
- ADRs relacionadas: ADR-0005, ADR-0017, ADR-0019
|
|
1
|
+
# ADR-0020: CLI única `forja` como core executivo dos comandos
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-07-06
|
|
5
|
+
- **Autor(es)**: apk
|
|
6
|
+
- **Tags**: cli, orchestration, governance, workspace
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
Os comandos do Forja cresceram em três camadas paralelas sem núcleo comum: `scripts/agent-harness.mjs` (workspace/GSD/code), `scripts/dev.mjs` (context/memória, duplicando parte do harness) e ~40 scripts npm apontando direto para scripts soltos — com a chave `project:check` duplicada no `package.json`. Não havia trilha de auditoria unificada, gates eram aplicados de forma desigual e a resolução do workspace (ADR-0019) dependia de cada script lembrar de usá-la. Projetos criados por `project:new` não eram registrados em ficha alguma.
|
|
10
|
+
|
|
11
|
+
O posicionamento do produto ("processo que governa" como pilar) exige que o processo passe, de fato, por um ponto governável.
|
|
12
|
+
|
|
13
|
+
## Decisão
|
|
14
|
+
Criar o **core executivo** do Forja:
|
|
15
|
+
|
|
16
|
+
- `bin/forja.mjs` — dispatcher único; todo comando de processo roda como `forja <comando>`.
|
|
17
|
+
- `lib/core/registry.mjs` — registry declarativo: domínio, descrição, alvo (script ou binário) e gates por comando.
|
|
18
|
+
- **Gates transversais** aplicados pelo core antes do alvo: `workspace` (comandos de produto falham cedo sem workspace, com instrução de correção).
|
|
19
|
+
- **Auditoria append-only**: cada execução gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback `.context/` do repo), com ts, cmd, args, exitCode, durationMs. Falha de auditoria nunca bloqueia o comando.
|
|
20
|
+
- Scripts npm viram aliases finos para `node bin/forja.mjs <cmd>`; `forja` é publicado em `"bin"`.
|
|
21
|
+
- `project:new` passa a registrar ficha automática em `<workspace>/memory/30-projects/<nome>.md`.
|
|
22
|
+
- `agent-harness.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. permanecem como implementação roteada; `dev.mjs` vira alias legado.
|
|
23
|
+
|
|
24
|
+
## Alternativas consideradas
|
|
25
|
+
- **Promover `agent-harness.mjs` a core**: rejeitada porque mistura implementação de gates GSD com roteamento; o registry declarativo separa "o que existe" de "como executa".
|
|
26
|
+
- **Promover `dev.mjs` a core**: rejeitada porque seu registry embute handlers (não é declarativo) e já nasceu duplicando o harness.
|
|
27
|
+
- **Registrar auditoria direto no SQLite universal**: adiada; JSONL em `.context/` é append-only, sem dependência e legível por humanos. Promoção a tabela pode vir depois via `sync:universal`.
|
|
28
|
+
- **Manter scripts npm diretos**: rejeitada porque perpetua a ausência de gates/auditoria — o problema que motivou a decisão.
|
|
29
|
+
|
|
30
|
+
## Consequências
|
|
31
|
+
**Positivas**:
|
|
32
|
+
- Um único ponto de entrada auditável; help agrupado por domínio.
|
|
33
|
+
- Gates de processo aplicados uniformemente (workspace hoje; extensível para spec/governance).
|
|
34
|
+
- Todo projeto nasce registrado no workspace.
|
|
35
|
+
- npm scripts ficam finos e sem duplicatas.
|
|
36
|
+
|
|
37
|
+
**Negativas / Trade-offs**:
|
|
38
|
+
- Um spawn adicional por comando (npm → forja → script), ~dezenas de ms.
|
|
39
|
+
- Registry precisa acompanhar novos scripts (mitigado por teste de integridade).
|
|
40
|
+
- `dev.mjs` convive como caminho legado até ser absorvido.
|
|
41
|
+
|
|
42
|
+
## Rastreamento
|
|
43
|
+
- Implementação: `bin/forja.mjs`, `lib/core/registry.mjs`, `package.json`, `scripts/agent-harness.mjs`, `test/forja-core.test.js`
|
|
44
|
+
- Issues/PRs: SPEC-025 (`specs/forja-core/spec.md`)
|
|
45
|
+
- ADRs relacionadas: ADR-0005, ADR-0017, ADR-0019
|