forjajs 2.0.2 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -317
- package/README.pt-BR.md +345 -323
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.d.ts +1 -0
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -140
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,25 +1,25 @@
|
|
|
1
|
-
# ADR-0002: SQLite + FTS5 como camada de busca de memória
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-04-21
|
|
5
|
-
- **Tags**: memory, search, performance
|
|
6
|
-
|
|
7
|
-
## Contexto
|
|
8
|
-
Memória cresce com o projeto. Grep linear em `memory/**/*.md` é O(n) sobre disco e ignora ranking. Indexação externa (Elastic, Meili) adiciona infra. Embeddings adicionam custo e dependência de modelo.
|
|
9
|
-
|
|
10
|
-
## Decisão
|
|
11
|
-
Usar SQLite com extensão FTS5 como índice de busca local. Banco em `.memory/sqlite/universal.db`, sincronizado pelo `scripts/sync-universal-memory.js`. Consultas via `scripts/query-universal-memory.js` e `lib/context-builder.js`.
|
|
12
|
-
|
|
13
|
-
## Alternativas consideradas
|
|
14
|
-
- **Grep direto** — rejeitada: sem ranking, sem stemming, lento em repos grandes
|
|
15
|
-
- **Embeddings (Chroma/Qdrant)** — rejeitada nesta fase: custo de embedding em cada sync e dependência de modelo externo. Mantida como evolução futura
|
|
16
|
-
- **Elasticsearch/Meilisearch** — rejeitada: infra externa, sem ganho para repos <10k arquivos
|
|
17
|
-
|
|
18
|
-
## Consequências
|
|
19
|
-
**Positivas**: zero infra externa, FTS5 nativo, banco versionável (ou ignorável), reconstrução determinística do índice.
|
|
20
|
-
**Negativas**: BM25 só (sem semântica), sync manual (não há watcher), banco pode crescer — mitigado por `compress-memory`.
|
|
21
|
-
|
|
22
|
-
## Rastreamento
|
|
23
|
-
- `scripts/sync-universal-memory.js`, `scripts/query-universal-memory.js`
|
|
24
|
-
- `lib/context-builder.js`
|
|
25
|
-
- `.memoryrc.json` (chave `compression`)
|
|
1
|
+
# ADR-0002: SQLite + FTS5 como camada de busca de memória
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-04-21
|
|
5
|
+
- **Tags**: memory, search, performance
|
|
6
|
+
|
|
7
|
+
## Contexto
|
|
8
|
+
Memória cresce com o projeto. Grep linear em `memory/**/*.md` é O(n) sobre disco e ignora ranking. Indexação externa (Elastic, Meili) adiciona infra. Embeddings adicionam custo e dependência de modelo.
|
|
9
|
+
|
|
10
|
+
## Decisão
|
|
11
|
+
Usar SQLite com extensão FTS5 como índice de busca local. Banco em `.memory/sqlite/universal.db`, sincronizado pelo `scripts/sync-universal-memory.js`. Consultas via `scripts/query-universal-memory.js` e `lib/context-builder.js`.
|
|
12
|
+
|
|
13
|
+
## Alternativas consideradas
|
|
14
|
+
- **Grep direto** — rejeitada: sem ranking, sem stemming, lento em repos grandes
|
|
15
|
+
- **Embeddings (Chroma/Qdrant)** — rejeitada nesta fase: custo de embedding em cada sync e dependência de modelo externo. Mantida como evolução futura
|
|
16
|
+
- **Elasticsearch/Meilisearch** — rejeitada: infra externa, sem ganho para repos <10k arquivos
|
|
17
|
+
|
|
18
|
+
## Consequências
|
|
19
|
+
**Positivas**: zero infra externa, FTS5 nativo, banco versionável (ou ignorável), reconstrução determinística do índice.
|
|
20
|
+
**Negativas**: BM25 só (sem semântica), sync manual (não há watcher), banco pode crescer — mitigado por `compress-memory`.
|
|
21
|
+
|
|
22
|
+
## Rastreamento
|
|
23
|
+
- `scripts/sync-universal-memory.js`, `scripts/query-universal-memory.js`
|
|
24
|
+
- `lib/context-builder.js`
|
|
25
|
+
- `.memoryrc.json` (chave `compression`)
|
|
@@ -1,31 +1,31 @@
|
|
|
1
|
-
# ADR-0003: Smart Context com 3 modos (global/domain/task)
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-05-02
|
|
5
|
-
- **Tags**: tokens, context, performance
|
|
6
|
-
|
|
7
|
-
## Contexto
|
|
8
|
-
Mandar `memory/**` inteiro para o modelo gasta tokens e dilui relevância. Por outro lado, contexto vazio força o agente a perguntar tudo. Precisamos de níveis intermediários.
|
|
9
|
-
|
|
10
|
-
## Decisão
|
|
11
|
-
`lib/context-builder.js` expõe 3 modos:
|
|
12
|
-
|
|
13
|
-
- **`global`**: arquivos de `00-global`, `10-product/vision.md`, `20-architecture/overview.md`. Para onboarding de agentes novos.
|
|
14
|
-
- **`domain`**: tudo de `30-domains/<dominio>/` + summaries relacionados. Para trabalho focado em um bounded-context.
|
|
15
|
-
- **`task`**: busca FTS5 dirigida por query + top-N arquivos rankeados. Para sprints/tasks específicas.
|
|
16
|
-
|
|
17
|
-
Cada modo tem cap de bytes em `.memoryrc.json` e cache LRU.
|
|
18
|
-
|
|
19
|
-
## Alternativas consideradas
|
|
20
|
-
- **1 só modo (everything-or-nothing)** — rejeitada: sem granularidade
|
|
21
|
-
- **Modo dinâmico baseado em prompt** — rejeitada nesta versão: latência de classificação, comportamento difícil de explicar. Pode evoluir para isso
|
|
22
|
-
|
|
23
|
-
## Consequências
|
|
24
|
-
**Positivas**: redução medida de 40-60% em tokens (`scripts/token-benchmark.mjs`), comportamento determinístico.
|
|
25
|
-
**Negativas**: agente precisa escolher o modo — mitigado por defaults sensatos (smart-context escolhe pelo contexto da invocação).
|
|
26
|
-
|
|
27
|
-
## Rastreamento
|
|
28
|
-
- `lib/context-builder.js`
|
|
29
|
-
- `scripts/build-smart-context.js`
|
|
30
|
-
- `scripts/token-benchmark.mjs`
|
|
31
|
-
- `.memoryrc.json` (chave `context.modes`)
|
|
1
|
+
# ADR-0003: Smart Context com 3 modos (global/domain/task)
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-05-02
|
|
5
|
+
- **Tags**: tokens, context, performance
|
|
6
|
+
|
|
7
|
+
## Contexto
|
|
8
|
+
Mandar `memory/**` inteiro para o modelo gasta tokens e dilui relevância. Por outro lado, contexto vazio força o agente a perguntar tudo. Precisamos de níveis intermediários.
|
|
9
|
+
|
|
10
|
+
## Decisão
|
|
11
|
+
`lib/context-builder.js` expõe 3 modos:
|
|
12
|
+
|
|
13
|
+
- **`global`**: arquivos de `00-global`, `10-product/vision.md`, `20-architecture/overview.md`. Para onboarding de agentes novos.
|
|
14
|
+
- **`domain`**: tudo de `30-domains/<dominio>/` + summaries relacionados. Para trabalho focado em um bounded-context.
|
|
15
|
+
- **`task`**: busca FTS5 dirigida por query + top-N arquivos rankeados. Para sprints/tasks específicas.
|
|
16
|
+
|
|
17
|
+
Cada modo tem cap de bytes em `.memoryrc.json` e cache LRU.
|
|
18
|
+
|
|
19
|
+
## Alternativas consideradas
|
|
20
|
+
- **1 só modo (everything-or-nothing)** — rejeitada: sem granularidade
|
|
21
|
+
- **Modo dinâmico baseado em prompt** — rejeitada nesta versão: latência de classificação, comportamento difícil de explicar. Pode evoluir para isso
|
|
22
|
+
|
|
23
|
+
## Consequências
|
|
24
|
+
**Positivas**: redução medida de 40-60% em tokens (`scripts/token-benchmark.mjs`), comportamento determinístico.
|
|
25
|
+
**Negativas**: agente precisa escolher o modo — mitigado por defaults sensatos (smart-context escolhe pelo contexto da invocação).
|
|
26
|
+
|
|
27
|
+
## Rastreamento
|
|
28
|
+
- `lib/context-builder.js`
|
|
29
|
+
- `scripts/build-smart-context.js`
|
|
30
|
+
- `scripts/token-benchmark.mjs`
|
|
31
|
+
- `.memoryrc.json` (chave `context.modes`)
|
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
# ADR-0004: Validação e segurança obrigatórias no scaffold NestJS
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-04-21
|
|
5
|
-
- **Tags**: security, scaffold
|
|
6
|
-
|
|
7
|
-
## Contexto
|
|
8
|
-
Versão inicial do scaffold gerava controllers sem DTO, sem rate-limit, sem sanitização. Projetos derivados herdaram débito de segurança. Custo de "consertar depois" é alto.
|
|
9
|
-
|
|
10
|
-
## Decisão
|
|
11
|
-
Todo controller gerado pelo kit deve:
|
|
12
|
-
- Usar DTOs com `class-validator` (`@IsString`, `@IsEmail`, `@MaxLength`, etc.)
|
|
13
|
-
- Tratar erro via `HttpException` com código específico
|
|
14
|
-
- Ter `*.spec.ts` gerado lado-a-lado
|
|
15
|
-
- Aplicar `helmet`, `rate-limit` global e payload máximo de 10MB
|
|
16
|
-
|
|
17
|
-
## Alternativas consideradas
|
|
18
|
-
- **Validação opcional** — rejeitada: vira "todo mundo pula"
|
|
19
|
-
- **Validação só em endpoints públicos** — rejeitada: classificar "público" é ambíguo
|
|
20
|
-
|
|
21
|
-
## Consequências
|
|
22
|
-
**Positivas**: baseline de segurança herdado por todos os projetos derivados.
|
|
23
|
-
**Negativas**: scaffold mais verboso (~30% mais arquivos no `--no-only-memory`).
|
|
24
|
-
|
|
25
|
-
## Rastreamento
|
|
26
|
-
- `lib/generators/nest-generator.js`
|
|
27
|
-
- `docs/archive/REFINAMENTO-v1.0.md` (seção SEC-001..004)
|
|
1
|
+
# ADR-0004: Validação e segurança obrigatórias no scaffold NestJS
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-04-21
|
|
5
|
+
- **Tags**: security, scaffold
|
|
6
|
+
|
|
7
|
+
## Contexto
|
|
8
|
+
Versão inicial do scaffold gerava controllers sem DTO, sem rate-limit, sem sanitização. Projetos derivados herdaram débito de segurança. Custo de "consertar depois" é alto.
|
|
9
|
+
|
|
10
|
+
## Decisão
|
|
11
|
+
Todo controller gerado pelo kit deve:
|
|
12
|
+
- Usar DTOs com `class-validator` (`@IsString`, `@IsEmail`, `@MaxLength`, etc.)
|
|
13
|
+
- Tratar erro via `HttpException` com código específico
|
|
14
|
+
- Ter `*.spec.ts` gerado lado-a-lado
|
|
15
|
+
- Aplicar `helmet`, `rate-limit` global e payload máximo de 10MB
|
|
16
|
+
|
|
17
|
+
## Alternativas consideradas
|
|
18
|
+
- **Validação opcional** — rejeitada: vira "todo mundo pula"
|
|
19
|
+
- **Validação só em endpoints públicos** — rejeitada: classificar "público" é ambíguo
|
|
20
|
+
|
|
21
|
+
## Consequências
|
|
22
|
+
**Positivas**: baseline de segurança herdado por todos os projetos derivados.
|
|
23
|
+
**Negativas**: scaffold mais verboso (~30% mais arquivos no `--no-only-memory`).
|
|
24
|
+
|
|
25
|
+
## Rastreamento
|
|
26
|
+
- `lib/generators/nest-generator.js`
|
|
27
|
+
- `docs/archive/REFINAMENTO-v1.0.md` (seção SEC-001..004)
|
|
@@ -1,32 +1,32 @@
|
|
|
1
|
-
# ADR-0005: Handoff entre agentes com 7 campos obrigatórios
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-04-26
|
|
5
|
-
- **Tags**: orchestration, handoff
|
|
6
|
-
|
|
7
|
-
## Contexto
|
|
8
|
-
Handoffs em texto-livre entre agentes (Product → SDD Architect → Worker) perdiam contexto, geravam retrabalho e ambiguidade. Sem contrato, cada agente inventa formato.
|
|
9
|
-
|
|
10
|
-
## Decisão
|
|
11
|
-
Todo handoff em `memory/50-orchestration/handoffs/` deve carregar 7 campos:
|
|
12
|
-
|
|
13
|
-
1. **from** — agente origem
|
|
14
|
-
2. **to** — agente destino
|
|
15
|
-
3. **intent** — verbo curto: implement | review | plan | research
|
|
16
|
-
4. **context** — referências (paths, ADRs, specs) suficientes para isolar a tarefa
|
|
17
|
-
5. **acceptance** — critérios mensuráveis de "pronto"
|
|
18
|
-
6. **constraints** — limites (tempo, escopo, padrões a respeitar)
|
|
19
|
-
7. **return** — o que o destinatário deve devolver e onde
|
|
20
|
-
|
|
21
|
-
## Alternativas consideradas
|
|
22
|
-
- **Texto-livre** — rejeitada (era o estado anterior)
|
|
23
|
-
- **Schema mais rico (15+ campos)** — rejeitada: fricção alta, agentes esqueciam
|
|
24
|
-
|
|
25
|
-
## Consequências
|
|
26
|
-
**Positivas**: handoff verificável programaticamente, qualidade mínima garantida.
|
|
27
|
-
**Negativas**: precisa ferramenta (`append-handoff.mjs`) para não virar burocracia.
|
|
28
|
-
|
|
29
|
-
## Rastreamento
|
|
30
|
-
- `lib/generators/memory-generator.js` (templates de `50-orchestration/`)
|
|
31
|
-
- `scripts/append-handoff.mjs` (no projeto gerado)
|
|
32
|
-
- Esta refator: migrar handoff para tabela SQLite (ADR futura)
|
|
1
|
+
# ADR-0005: Handoff entre agentes com 7 campos obrigatórios
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-04-26
|
|
5
|
+
- **Tags**: orchestration, handoff
|
|
6
|
+
|
|
7
|
+
## Contexto
|
|
8
|
+
Handoffs em texto-livre entre agentes (Product → SDD Architect → Worker) perdiam contexto, geravam retrabalho e ambiguidade. Sem contrato, cada agente inventa formato.
|
|
9
|
+
|
|
10
|
+
## Decisão
|
|
11
|
+
Todo handoff em `memory/50-orchestration/handoffs/` deve carregar 7 campos:
|
|
12
|
+
|
|
13
|
+
1. **from** — agente origem
|
|
14
|
+
2. **to** — agente destino
|
|
15
|
+
3. **intent** — verbo curto: implement | review | plan | research
|
|
16
|
+
4. **context** — referências (paths, ADRs, specs) suficientes para isolar a tarefa
|
|
17
|
+
5. **acceptance** — critérios mensuráveis de "pronto"
|
|
18
|
+
6. **constraints** — limites (tempo, escopo, padrões a respeitar)
|
|
19
|
+
7. **return** — o que o destinatário deve devolver e onde
|
|
20
|
+
|
|
21
|
+
## Alternativas consideradas
|
|
22
|
+
- **Texto-livre** — rejeitada (era o estado anterior)
|
|
23
|
+
- **Schema mais rico (15+ campos)** — rejeitada: fricção alta, agentes esqueciam
|
|
24
|
+
|
|
25
|
+
## Consequências
|
|
26
|
+
**Positivas**: handoff verificável programaticamente, qualidade mínima garantida.
|
|
27
|
+
**Negativas**: precisa ferramenta (`append-handoff.mjs`) para não virar burocracia.
|
|
28
|
+
|
|
29
|
+
## Rastreamento
|
|
30
|
+
- `lib/generators/memory-generator.js` (templates de `50-orchestration/`)
|
|
31
|
+
- `scripts/append-handoff.mjs` (no projeto gerado)
|
|
32
|
+
- Esta refator: migrar handoff para tabela SQLite (ADR futura)
|
|
@@ -1,23 +1,23 @@
|
|
|
1
|
-
# ADR-0006: Documentação estruturada por persona
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-05-02
|
|
5
|
-
- **Tags**: docs, onboarding
|
|
6
|
-
|
|
7
|
-
## Contexto
|
|
8
|
-
Antes da refator, 30+ `.md` no root sem ordem fizeram onboarding levar horas. Cada perfil (executivo, arquiteto, dev, QA) precisava de visão diferente, mas tudo era apresentado em massa.
|
|
9
|
-
|
|
10
|
-
## Decisão
|
|
11
|
-
Adotar `docs/personas/{executive,architect,developer,qa}/README.md` como ponto de entrada por papel. `DOC-MAP.md` no root indexa as personas. Documentos genéricos (`quick-reference`, `glossary`, `token-optimization`, `dev-workflow`) ficam em `docs/` raiz.
|
|
12
|
-
|
|
13
|
-
## Alternativas consideradas
|
|
14
|
-
- **README único gigante** — rejeitada: ninguém lê linear
|
|
15
|
-
- **Wiki externa (Notion/GitBook)** — rejeitada: sai do repo, vira desincronizado
|
|
16
|
-
|
|
17
|
-
## Consequências
|
|
18
|
-
**Positivas**: tempo de onboarding caiu ~83% (medido em tempo até primeiro commit produtivo).
|
|
19
|
-
**Negativas**: 4 entradas para manter; risco de divergência mitigado por DOC-MAP central.
|
|
20
|
-
|
|
21
|
-
## Rastreamento
|
|
22
|
-
- `docs/personas/`, `docs/`, `DOC-MAP.md`
|
|
23
|
-
- `docs/archive/FASE2-SUMMARY.md` (relatório original)
|
|
1
|
+
# ADR-0006: Documentação estruturada por persona
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-05-02
|
|
5
|
+
- **Tags**: docs, onboarding
|
|
6
|
+
|
|
7
|
+
## Contexto
|
|
8
|
+
Antes da refator, 30+ `.md` no root sem ordem fizeram onboarding levar horas. Cada perfil (executivo, arquiteto, dev, QA) precisava de visão diferente, mas tudo era apresentado em massa.
|
|
9
|
+
|
|
10
|
+
## Decisão
|
|
11
|
+
Adotar `docs/personas/{executive,architect,developer,qa}/README.md` como ponto de entrada por papel. `DOC-MAP.md` no root indexa as personas. Documentos genéricos (`quick-reference`, `glossary`, `token-optimization`, `dev-workflow`) ficam em `docs/` raiz.
|
|
12
|
+
|
|
13
|
+
## Alternativas consideradas
|
|
14
|
+
- **README único gigante** — rejeitada: ninguém lê linear
|
|
15
|
+
- **Wiki externa (Notion/GitBook)** — rejeitada: sai do repo, vira desincronizado
|
|
16
|
+
|
|
17
|
+
## Consequências
|
|
18
|
+
**Positivas**: tempo de onboarding caiu ~83% (medido em tempo até primeiro commit produtivo).
|
|
19
|
+
**Negativas**: 4 entradas para manter; risco de divergência mitigado por DOC-MAP central.
|
|
20
|
+
|
|
21
|
+
## Rastreamento
|
|
22
|
+
- `docs/personas/`, `docs/`, `DOC-MAP.md`
|
|
23
|
+
- `docs/archive/FASE2-SUMMARY.md` (relatório original)
|
|
@@ -1,33 +1,33 @@
|
|
|
1
|
-
# ADR-0007: Pipeline Spec-Driven obrigatório para features não-triviais
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-05-10
|
|
5
|
-
- **Tags**: sdd, methodology, governance
|
|
6
|
-
|
|
7
|
-
## Contexto
|
|
8
|
-
AGENTS.md descrevia um "SDD Architect" mas não havia mecânica que forçasse spec antes de código. Trabalho começava direto na implementação, decisões eram tomadas no PR (tarde), e o "porquê" se perdia no tempo.
|
|
9
|
-
|
|
10
|
-
## Decisão
|
|
11
|
-
Adotar pipeline em 3 fases vinculadas:
|
|
12
|
-
|
|
13
|
-
1. **`spec.md`** — produto define problema, AC, NFRs, escopo
|
|
14
|
-
2. **`plan.md`** — SDD Architect define arquitetura, contratos, alternativas; abre ADRs para decisões estruturais
|
|
15
|
-
3. **`tasks.md`** — decomposição executável com owners
|
|
16
|
-
|
|
17
|
-
CLI `scripts/spec-cli.mjs` força ordem: `plan` exige `spec` em `approved+`; `tasks` exige `plan` em `approved+`. `spec:check` falha CI quando há violação.
|
|
18
|
-
|
|
19
|
-
Lista explícita de "quando NÃO precisa spec" em `specs/README.md` (bugfixes 1-line, renames, doc updates, dep bumps) — evita transformar SDD em burocracia.
|
|
20
|
-
|
|
21
|
-
## Alternativas consideradas
|
|
22
|
-
- **GitHub Issues + PR template** — rejeitada: não enforça ordem, sem separação entre "o quê" e "como"
|
|
23
|
-
- **ADR como única forma** — rejeitada: ADR é decisão pontual, não rastreia execução
|
|
24
|
-
- **Spec opcional** — rejeitada: viraria letra morta como o "Spec-Driven Architect" da versão anterior
|
|
25
|
-
|
|
26
|
-
## Consequências
|
|
27
|
-
**Positivas**: rastreabilidade decisão → impl, onboarding de novos agentes mais barato, AC mensuráveis evitam scope creep.
|
|
28
|
-
**Negativas**: fricção inicial (~10min por feature). Mitigada por templates e excluindo trabalhos triviais.
|
|
29
|
-
|
|
30
|
-
## Rastreamento
|
|
31
|
-
- `specs/`, `scripts/spec-cli.mjs`
|
|
32
|
-
- `package.json` (scripts `spec:*`)
|
|
33
|
-
- SPEC-001 = pipeline-sdd-e-orquestracao (meta-spec deste trabalho)
|
|
1
|
+
# ADR-0007: Pipeline Spec-Driven obrigatório para features não-triviais
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-05-10
|
|
5
|
+
- **Tags**: sdd, methodology, governance
|
|
6
|
+
|
|
7
|
+
## Contexto
|
|
8
|
+
AGENTS.md descrevia um "SDD Architect" mas não havia mecânica que forçasse spec antes de código. Trabalho começava direto na implementação, decisões eram tomadas no PR (tarde), e o "porquê" se perdia no tempo.
|
|
9
|
+
|
|
10
|
+
## Decisão
|
|
11
|
+
Adotar pipeline em 3 fases vinculadas:
|
|
12
|
+
|
|
13
|
+
1. **`spec.md`** — produto define problema, AC, NFRs, escopo
|
|
14
|
+
2. **`plan.md`** — SDD Architect define arquitetura, contratos, alternativas; abre ADRs para decisões estruturais
|
|
15
|
+
3. **`tasks.md`** — decomposição executável com owners
|
|
16
|
+
|
|
17
|
+
CLI `scripts/spec-cli.mjs` força ordem: `plan` exige `spec` em `approved+`; `tasks` exige `plan` em `approved+`. `spec:check` falha CI quando há violação.
|
|
18
|
+
|
|
19
|
+
Lista explícita de "quando NÃO precisa spec" em `specs/README.md` (bugfixes 1-line, renames, doc updates, dep bumps) — evita transformar SDD em burocracia.
|
|
20
|
+
|
|
21
|
+
## Alternativas consideradas
|
|
22
|
+
- **GitHub Issues + PR template** — rejeitada: não enforça ordem, sem separação entre "o quê" e "como"
|
|
23
|
+
- **ADR como única forma** — rejeitada: ADR é decisão pontual, não rastreia execução
|
|
24
|
+
- **Spec opcional** — rejeitada: viraria letra morta como o "Spec-Driven Architect" da versão anterior
|
|
25
|
+
|
|
26
|
+
## Consequências
|
|
27
|
+
**Positivas**: rastreabilidade decisão → impl, onboarding de novos agentes mais barato, AC mensuráveis evitam scope creep.
|
|
28
|
+
**Negativas**: fricção inicial (~10min por feature). Mitigada por templates e excluindo trabalhos triviais.
|
|
29
|
+
|
|
30
|
+
## Rastreamento
|
|
31
|
+
- `specs/`, `scripts/spec-cli.mjs`
|
|
32
|
+
- `package.json` (scripts `spec:*`)
|
|
33
|
+
- SPEC-001 = pipeline-sdd-e-orquestracao (meta-spec deste trabalho)
|
|
@@ -1,36 +1,36 @@
|
|
|
1
|
-
# ADR-0008: Sub-agents executáveis + handoff em SQLite
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-05-10
|
|
5
|
-
- **Tags**: orchestration, agents, sdd
|
|
6
|
-
- **Supersede parcial**: comportamento de handoff em markdown da ADR-0005 (campos continuam valendo)
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
AGENTS.md listava 6 papéis mas nenhum era executável — sub-agents existiam só como descrição. Handoffs viviam em `memory/50-orchestration/handoffs/*.md`, sem validação de campos, sem fila, sem status. Resultado: ninguém "passava o bastão" — papéis colidiam ou ficavam ociosos.
|
|
10
|
-
|
|
11
|
-
## Decisão
|
|
12
|
-
1. **6 sub-agents Claude Code** em `.claude/agents/*.md` — orchestrator, context-engineer, sdd-architect, product, marketing, governance. Cada um com frontmatter `name`/`description`/`tools` e system prompt focado.
|
|
13
|
-
2. **Handoffs persistem em SQLite** (`universal.db.handoffs`), não em markdown. Campos da ADR-0005 (7) são validados em `scripts/agent-router.mjs append`.
|
|
14
|
-
3. **Roteamento explícito**: agent-router CLI grava, lista, marca status (open → in_progress → done). Sem broadcast, sem polling.
|
|
15
|
-
4. Markdown handoffs antigos em `memory/50-orchestration/handoffs/` ficam como histórico — não migrados.
|
|
16
|
-
|
|
17
|
-
## Alternativas consideradas
|
|
18
|
-
- **Manter handoff em markdown** — rejeitada: difícil de validar/consultar, status invisível
|
|
19
|
-
- **Fila externa (Redis/SQS)** — rejeitada: infra extra para repo de framework
|
|
20
|
-
- **Um único super-agent monolítico** — rejeitada: perde especialização e força do system-prompt focado
|
|
21
|
-
|
|
22
|
-
## Consequências
|
|
23
|
-
**Positivas**:
|
|
24
|
-
- Sub-agents Claude Code podem ser invocados via subagent_type explícito ou descobertos pela descrição
|
|
25
|
-
- Handoff é queryável (SQL): "todos os abertos para o sdd-architect"
|
|
26
|
-
- Validação de schema bloqueia handoff incompleto na origem
|
|
27
|
-
|
|
28
|
-
**Negativas**:
|
|
29
|
-
- Adiciona dependência soft de `better-sqlite3` para roteamento (já era devDependency)
|
|
30
|
-
- Outras IAs (Copilot/Gemini/Codex) não consomem os `.claude/agents/` — precisam adapter futuro
|
|
31
|
-
|
|
32
|
-
## Rastreamento
|
|
33
|
-
- `.claude/agents/`
|
|
34
|
-
- `scripts/agent-router.mjs`
|
|
35
|
-
- `AGENTS.md` (atualizado para apontar para sub-agents)
|
|
36
|
-
- SPEC-001 AC-4..AC-6
|
|
1
|
+
# ADR-0008: Sub-agents executáveis + handoff em SQLite
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-05-10
|
|
5
|
+
- **Tags**: orchestration, agents, sdd
|
|
6
|
+
- **Supersede parcial**: comportamento de handoff em markdown da ADR-0005 (campos continuam valendo)
|
|
7
|
+
|
|
8
|
+
## Contexto
|
|
9
|
+
AGENTS.md listava 6 papéis mas nenhum era executável — sub-agents existiam só como descrição. Handoffs viviam em `memory/50-orchestration/handoffs/*.md`, sem validação de campos, sem fila, sem status. Resultado: ninguém "passava o bastão" — papéis colidiam ou ficavam ociosos.
|
|
10
|
+
|
|
11
|
+
## Decisão
|
|
12
|
+
1. **6 sub-agents Claude Code** em `.claude/agents/*.md` — orchestrator, context-engineer, sdd-architect, product, marketing, governance. Cada um com frontmatter `name`/`description`/`tools` e system prompt focado.
|
|
13
|
+
2. **Handoffs persistem em SQLite** (`universal.db.handoffs`), não em markdown. Campos da ADR-0005 (7) são validados em `scripts/agent-router.mjs append`.
|
|
14
|
+
3. **Roteamento explícito**: agent-router CLI grava, lista, marca status (open → in_progress → done). Sem broadcast, sem polling.
|
|
15
|
+
4. Markdown handoffs antigos em `memory/50-orchestration/handoffs/` ficam como histórico — não migrados.
|
|
16
|
+
|
|
17
|
+
## Alternativas consideradas
|
|
18
|
+
- **Manter handoff em markdown** — rejeitada: difícil de validar/consultar, status invisível
|
|
19
|
+
- **Fila externa (Redis/SQS)** — rejeitada: infra extra para repo de framework
|
|
20
|
+
- **Um único super-agent monolítico** — rejeitada: perde especialização e força do system-prompt focado
|
|
21
|
+
|
|
22
|
+
## Consequências
|
|
23
|
+
**Positivas**:
|
|
24
|
+
- Sub-agents Claude Code podem ser invocados via subagent_type explícito ou descobertos pela descrição
|
|
25
|
+
- Handoff é queryável (SQL): "todos os abertos para o sdd-architect"
|
|
26
|
+
- Validação de schema bloqueia handoff incompleto na origem
|
|
27
|
+
|
|
28
|
+
**Negativas**:
|
|
29
|
+
- Adiciona dependência soft de `better-sqlite3` para roteamento (já era devDependency)
|
|
30
|
+
- Outras IAs (Copilot/Gemini/Codex) não consomem os `.claude/agents/` — precisam adapter futuro
|
|
31
|
+
|
|
32
|
+
## Rastreamento
|
|
33
|
+
- `.claude/agents/`
|
|
34
|
+
- `scripts/agent-router.mjs`
|
|
35
|
+
- `AGENTS.md` (atualizado para apontar para sub-agents)
|
|
36
|
+
- SPEC-001 AC-4..AC-6
|
|
@@ -1,43 +1,43 @@
|
|
|
1
|
-
# ADR-0009: Hooks Claude Code para contexto e economia de tokens
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Data**: 2026-05-10
|
|
5
|
-
- **Tags**: tokens, hooks, claude-code
|
|
6
|
-
|
|
7
|
-
## Contexto
|
|
8
|
-
A Fase 3 entregou smart-context API (ADR-0003) mas o agente precisava invocá-la manualmente. Resultado: economia teórica de 40-60% só se materializa quando alguém lembra de chamar. Pre-commit também era leve — não validava SDD nem standards.
|
|
9
|
-
|
|
10
|
-
## Decisão
|
|
11
|
-
Três pontos de hook em `.claude/settings.json`:
|
|
12
|
-
|
|
13
|
-
1. **`SessionStart`** → `scripts/hook-session-start.mjs`
|
|
14
|
-
Imprime status do framework (specs ativas, handoffs abertos) como `additionalContext`. Roda 1×/sessão. Sem custo recorrente.
|
|
15
|
-
|
|
16
|
-
2. **`UserPromptSubmit`** → `scripts/hook-user-prompt.mjs`
|
|
17
|
-
Opt-in via env `FRAMEWORK_HOOK_INJECT=1`. Só injeta quando prompt casa com keywords (`implement`, `refactor`, `criar feature`, `spec:`, …). Cache TTL 30min por hash do prompt. Cap configurável em `.memoryrc.json::hooks.userPromptCap` (default 4KB).
|
|
18
|
-
|
|
19
|
-
3. **Pre-commit ampliado** (`scripts/pre-commit.sh`)
|
|
20
|
-
Adicionados passos 6 (`spec:check`) e 7 (`check-standards`). Bloqueia commit se SDD inconsistente.
|
|
21
|
-
|
|
22
|
-
## Alternativas consideradas
|
|
23
|
-
- **Sempre injetar contexto** — rejeitada: gasta tokens em prompts triviais, atrasa primeiros tokens
|
|
24
|
-
- **Injetar via slash command manual** — rejeitada: vira esquecível; já tem `npm run context:smart`
|
|
25
|
-
- **Hook em `PreToolUse`** — rejeitada nesta versão: ruído alto, ganho duvidoso para o caso de uso (framework, não app de produção)
|
|
26
|
-
|
|
27
|
-
## Consequências
|
|
28
|
-
**Positivas**:
|
|
29
|
-
- Status do framework sempre visível ao iniciar sessão
|
|
30
|
-
- Injeção opt-in com safeguards (keyword, cache, cap)
|
|
31
|
-
- Pre-commit catch dívida de SDD antes do PR
|
|
32
|
-
|
|
33
|
-
**Negativas / Trade-offs**:
|
|
34
|
-
- `UserPromptSubmit` adiciona ≤200ms (cache) ou ≤1s (cold) ao primeiro token. Mitigado por trigger restrito.
|
|
35
|
-
- Comportamento muda quando `FRAMEWORK_HOOK_INJECT=1` — documentar em onboarding.
|
|
36
|
-
- Hooks só rodam no Claude Code; outras IAs (Copilot/Gemini) seguem fluxo manual.
|
|
37
|
-
|
|
38
|
-
## Rastreamento
|
|
39
|
-
- `.claude/settings.json`
|
|
40
|
-
- `scripts/hook-session-start.mjs`, `scripts/hook-user-prompt.mjs`
|
|
41
|
-
- `scripts/pre-commit.sh` (passos 6-7)
|
|
42
|
-
- `.memoryrc.json` (chave `hooks`)
|
|
43
|
-
- SPEC-001 AC-7
|
|
1
|
+
# ADR-0009: Hooks Claude Code para contexto e economia de tokens
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-05-10
|
|
5
|
+
- **Tags**: tokens, hooks, claude-code
|
|
6
|
+
|
|
7
|
+
## Contexto
|
|
8
|
+
A Fase 3 entregou smart-context API (ADR-0003) mas o agente precisava invocá-la manualmente. Resultado: economia teórica de 40-60% só se materializa quando alguém lembra de chamar. Pre-commit também era leve — não validava SDD nem standards.
|
|
9
|
+
|
|
10
|
+
## Decisão
|
|
11
|
+
Três pontos de hook em `.claude/settings.json`:
|
|
12
|
+
|
|
13
|
+
1. **`SessionStart`** → `scripts/hook-session-start.mjs`
|
|
14
|
+
Imprime status do framework (specs ativas, handoffs abertos) como `additionalContext`. Roda 1×/sessão. Sem custo recorrente.
|
|
15
|
+
|
|
16
|
+
2. **`UserPromptSubmit`** → `scripts/hook-user-prompt.mjs`
|
|
17
|
+
Opt-in via env `FRAMEWORK_HOOK_INJECT=1`. Só injeta quando prompt casa com keywords (`implement`, `refactor`, `criar feature`, `spec:`, …). Cache TTL 30min por hash do prompt. Cap configurável em `.memoryrc.json::hooks.userPromptCap` (default 4KB).
|
|
18
|
+
|
|
19
|
+
3. **Pre-commit ampliado** (`scripts/pre-commit.sh`)
|
|
20
|
+
Adicionados passos 6 (`spec:check`) e 7 (`check-standards`). Bloqueia commit se SDD inconsistente.
|
|
21
|
+
|
|
22
|
+
## Alternativas consideradas
|
|
23
|
+
- **Sempre injetar contexto** — rejeitada: gasta tokens em prompts triviais, atrasa primeiros tokens
|
|
24
|
+
- **Injetar via slash command manual** — rejeitada: vira esquecível; já tem `npm run context:smart`
|
|
25
|
+
- **Hook em `PreToolUse`** — rejeitada nesta versão: ruído alto, ganho duvidoso para o caso de uso (framework, não app de produção)
|
|
26
|
+
|
|
27
|
+
## Consequências
|
|
28
|
+
**Positivas**:
|
|
29
|
+
- Status do framework sempre visível ao iniciar sessão
|
|
30
|
+
- Injeção opt-in com safeguards (keyword, cache, cap)
|
|
31
|
+
- Pre-commit catch dívida de SDD antes do PR
|
|
32
|
+
|
|
33
|
+
**Negativas / Trade-offs**:
|
|
34
|
+
- `UserPromptSubmit` adiciona ≤200ms (cache) ou ≤1s (cold) ao primeiro token. Mitigado por trigger restrito.
|
|
35
|
+
- Comportamento muda quando `FRAMEWORK_HOOK_INJECT=1` — documentar em onboarding.
|
|
36
|
+
- Hooks só rodam no Claude Code; outras IAs (Copilot/Gemini) seguem fluxo manual.
|
|
37
|
+
|
|
38
|
+
## Rastreamento
|
|
39
|
+
- `.claude/settings.json`
|
|
40
|
+
- `scripts/hook-session-start.mjs`, `scripts/hook-user-prompt.mjs`
|
|
41
|
+
- `scripts/pre-commit.sh` (passos 6-7)
|
|
42
|
+
- `.memoryrc.json` (chave `hooks`)
|
|
43
|
+
- SPEC-001 AC-7
|
|
@@ -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)
|