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,64 +1,64 @@
|
|
|
1
|
-
# Sprint 8 — Context Engine sobre GraphLoop
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Usar o GraphLoop persistente como fonte determinística do Context Engine,
|
|
6
|
-
selecionando relações relevantes com evidência, respeitando orçamento e
|
|
7
|
-
reutilizando conteúdo por checksum no SQLite.
|
|
8
|
-
|
|
9
|
-
## Análise de impacto
|
|
10
|
-
|
|
11
|
-
- `packages/graph`: expõe registros de contexto derivados de arestas ativas.
|
|
12
|
-
- `packages/context`: recebe `GraphContextSource`, mantendo a porta
|
|
13
|
-
`ContextSource` e sem depender de SQLite.
|
|
14
|
-
- `packages/adapter-sqlite`: adiciona `SqliteContextCache` e migração v5.
|
|
15
|
-
- `apps/server`: compõe GraphLoop, Context Engine e cache sobre o mesmo banco;
|
|
16
|
-
MCP e Runtime recebem a composição.
|
|
17
|
-
- contratos públicos permanecem inalterados.
|
|
18
|
-
|
|
19
|
-
## Escopo
|
|
20
|
-
|
|
21
|
-
- ranking determinístico por termos do objetivo;
|
|
22
|
-
- exclusão de arestas sem evidência ou fora da validade;
|
|
23
|
-
- referências auditáveis no `ContextPackage`;
|
|
24
|
-
- cache persistente por checksum;
|
|
25
|
-
- aplicação do orçamento existente;
|
|
26
|
-
- expansão de contexto a partir do cache;
|
|
27
|
-
- uso do pacote no bootstrap oficial.
|
|
28
|
-
|
|
29
|
-
## Fora do escopo
|
|
30
|
-
|
|
31
|
-
- embeddings ou busca vetorial;
|
|
32
|
-
- sumarização por LLM;
|
|
33
|
-
- indexação automática do workspace inteiro;
|
|
34
|
-
- alteração de contratos de contexto;
|
|
35
|
-
- compactação de logs ou decisões fora do GraphLoop.
|
|
36
|
-
|
|
37
|
-
## Critérios de aceite
|
|
38
|
-
|
|
39
|
-
1. Context Engine aceita uma fonte GraphLoop por porta, sem importar SQLite.
|
|
40
|
-
2. Apenas relações com evidência e termos relevantes entram como candidatos.
|
|
41
|
-
3. Contexto contradito/obsoleto continua excluído pelo engine.
|
|
42
|
-
4. Cache SQLite preserva conteúdo por checksum.
|
|
43
|
-
5. Orçamento limita seleção e métricas registram tokens/cache.
|
|
44
|
-
6. Server usa GraphLoop, Context Engine e cache no mesmo banco local.
|
|
45
|
-
7. Runtime recebe o pacote de contexto antes do planner sem perder seus passos.
|
|
46
|
-
|
|
47
|
-
## Hipóteses e riscos
|
|
48
|
-
|
|
49
|
-
- A relevância lexical é uma heurística determinística inicial, não uma
|
|
50
|
-
promessa de busca semântica.
|
|
51
|
-
- O conteúdo selecionado é uma relação compacta (`origem TIPO destino`);
|
|
52
|
-
expansão de trechos de arquivos será adicionada quando os extractors fornecerem
|
|
53
|
-
locators e conteúdo segmentado.
|
|
54
|
-
- O runtime mantém `requireEvidence: false` na composição de compatibilidade,
|
|
55
|
-
evitando quebrar tarefas sem relações indexadas; o MCP pode exigir evidência.
|
|
56
|
-
|
|
57
|
-
## Evidências
|
|
58
|
-
|
|
59
|
-
- `packages/context/src/index.ts`;
|
|
60
|
-
- `packages/graph/src/index.ts`;
|
|
61
|
-
- `packages/adapter-sqlite/src/index.ts`;
|
|
62
|
-
- `apps/server/src/main.ts`;
|
|
63
|
-
- `test/context.test.js`;
|
|
64
|
-
- `test/adapter-sqlite.test.js`.
|
|
1
|
+
# Sprint 8 — Context Engine sobre GraphLoop
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Usar o GraphLoop persistente como fonte determinística do Context Engine,
|
|
6
|
+
selecionando relações relevantes com evidência, respeitando orçamento e
|
|
7
|
+
reutilizando conteúdo por checksum no SQLite.
|
|
8
|
+
|
|
9
|
+
## Análise de impacto
|
|
10
|
+
|
|
11
|
+
- `packages/graph`: expõe registros de contexto derivados de arestas ativas.
|
|
12
|
+
- `packages/context`: recebe `GraphContextSource`, mantendo a porta
|
|
13
|
+
`ContextSource` e sem depender de SQLite.
|
|
14
|
+
- `packages/adapter-sqlite`: adiciona `SqliteContextCache` e migração v5.
|
|
15
|
+
- `apps/server`: compõe GraphLoop, Context Engine e cache sobre o mesmo banco;
|
|
16
|
+
MCP e Runtime recebem a composição.
|
|
17
|
+
- contratos públicos permanecem inalterados.
|
|
18
|
+
|
|
19
|
+
## Escopo
|
|
20
|
+
|
|
21
|
+
- ranking determinístico por termos do objetivo;
|
|
22
|
+
- exclusão de arestas sem evidência ou fora da validade;
|
|
23
|
+
- referências auditáveis no `ContextPackage`;
|
|
24
|
+
- cache persistente por checksum;
|
|
25
|
+
- aplicação do orçamento existente;
|
|
26
|
+
- expansão de contexto a partir do cache;
|
|
27
|
+
- uso do pacote no bootstrap oficial.
|
|
28
|
+
|
|
29
|
+
## Fora do escopo
|
|
30
|
+
|
|
31
|
+
- embeddings ou busca vetorial;
|
|
32
|
+
- sumarização por LLM;
|
|
33
|
+
- indexação automática do workspace inteiro;
|
|
34
|
+
- alteração de contratos de contexto;
|
|
35
|
+
- compactação de logs ou decisões fora do GraphLoop.
|
|
36
|
+
|
|
37
|
+
## Critérios de aceite
|
|
38
|
+
|
|
39
|
+
1. Context Engine aceita uma fonte GraphLoop por porta, sem importar SQLite.
|
|
40
|
+
2. Apenas relações com evidência e termos relevantes entram como candidatos.
|
|
41
|
+
3. Contexto contradito/obsoleto continua excluído pelo engine.
|
|
42
|
+
4. Cache SQLite preserva conteúdo por checksum.
|
|
43
|
+
5. Orçamento limita seleção e métricas registram tokens/cache.
|
|
44
|
+
6. Server usa GraphLoop, Context Engine e cache no mesmo banco local.
|
|
45
|
+
7. Runtime recebe o pacote de contexto antes do planner sem perder seus passos.
|
|
46
|
+
|
|
47
|
+
## Hipóteses e riscos
|
|
48
|
+
|
|
49
|
+
- A relevância lexical é uma heurística determinística inicial, não uma
|
|
50
|
+
promessa de busca semântica.
|
|
51
|
+
- O conteúdo selecionado é uma relação compacta (`origem TIPO destino`);
|
|
52
|
+
expansão de trechos de arquivos será adicionada quando os extractors fornecerem
|
|
53
|
+
locators e conteúdo segmentado.
|
|
54
|
+
- O runtime mantém `requireEvidence: false` na composição de compatibilidade,
|
|
55
|
+
evitando quebrar tarefas sem relações indexadas; o MCP pode exigir evidência.
|
|
56
|
+
|
|
57
|
+
## Evidências
|
|
58
|
+
|
|
59
|
+
- `packages/context/src/index.ts`;
|
|
60
|
+
- `packages/graph/src/index.ts`;
|
|
61
|
+
- `packages/adapter-sqlite/src/index.ts`;
|
|
62
|
+
- `apps/server/src/main.ts`;
|
|
63
|
+
- `test/context.test.js`;
|
|
64
|
+
- `test/adapter-sqlite.test.js`.
|
|
@@ -1,51 +1,51 @@
|
|
|
1
|
-
# Sprint 9 — Extractors determinísticos do GraphLoop
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Ampliar a indexação incremental do GraphLoop para relações verificáveis em
|
|
6
|
-
fonte, Markdown, specs, ADRs, tarefas, handoffs, testes e manifests, sem LLM.
|
|
7
|
-
|
|
8
|
-
## Análise de impacto
|
|
9
|
-
|
|
10
|
-
- `packages/graph/src/index.ts`: amplia apenas o extractor existente e mantém
|
|
11
|
-
`GraphMutation`, checksum e evidências.
|
|
12
|
-
- contratos não mudam; tipos de entidade e relações já existentes são usados.
|
|
13
|
-
- adapters SQLite não precisam de nova migração: recebem a mesma mutation.
|
|
14
|
-
- consumidores MCP/Context passam a enxergar mais relações após `apply`.
|
|
15
|
-
|
|
16
|
-
## Padrões cobertos
|
|
17
|
-
|
|
18
|
-
| Entrada | Relação | Evidência |
|
|
19
|
-
| --- | --- | --- |
|
|
20
|
-
| import/from/import() | `DEPENDS_ON` | linha da declaração |
|
|
21
|
-
| link Markdown | `DERIVED_FROM` | linha do link |
|
|
22
|
-
| export de símbolo | `DEFINES` | linha da declaração |
|
|
23
|
-
| `implements` | `IMPLEMENTS` | linha da declaração |
|
|
24
|
-
| chamada de função | `CALLS` | linha da chamada |
|
|
25
|
-
| `ADR-NNNN` | `DERIVED_FROM` | linha da referência |
|
|
26
|
-
| checkbox Markdown | `CONTAINS` | linha da tarefa |
|
|
27
|
-
| `**to**`/`**next agent**` | `ASSIGNED_TO` | linha do handoff |
|
|
28
|
-
| `describe`/`it`/`test` | `VALIDATES` | linha do teste |
|
|
29
|
-
| dependências do `package.json` | `DEPENDS_ON` | manifest |
|
|
30
|
-
|
|
31
|
-
## Critérios de aceite
|
|
32
|
-
|
|
33
|
-
1. Cada relação gerada possui evidência, origem e checksum da fonte.
|
|
34
|
-
2. Padrões existentes de import/link permanecem compatíveis.
|
|
35
|
-
3. JSON inválido não derruba a indexação; é responsabilidade do validator.
|
|
36
|
-
4. Dependências de manifest são nós `Technology`.
|
|
37
|
-
5. Relações não determinísticas não são inferidas por esta etapa.
|
|
38
|
-
6. Reaplicar a mesma mutation continua idempotente no GraphLoop.
|
|
39
|
-
|
|
40
|
-
## Limites
|
|
41
|
-
|
|
42
|
-
- chamadas são identificadas lexicalmente e podem incluir símbolos locais;
|
|
43
|
-
keywords de controle e wrappers de teste são filtrados.
|
|
44
|
-
- não há resolução completa de escopo, overload ou alias de import.
|
|
45
|
-
- commits e diffs continuam aguardando um extractor Git dedicado.
|
|
46
|
-
|
|
47
|
-
## Evidências
|
|
48
|
-
|
|
49
|
-
- `packages/graph/src/index.ts`;
|
|
50
|
-
- `test/graph.test.js`;
|
|
51
|
-
- suíte de contratos do GraphLoop.
|
|
1
|
+
# Sprint 9 — Extractors determinísticos do GraphLoop
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Ampliar a indexação incremental do GraphLoop para relações verificáveis em
|
|
6
|
+
fonte, Markdown, specs, ADRs, tarefas, handoffs, testes e manifests, sem LLM.
|
|
7
|
+
|
|
8
|
+
## Análise de impacto
|
|
9
|
+
|
|
10
|
+
- `packages/graph/src/index.ts`: amplia apenas o extractor existente e mantém
|
|
11
|
+
`GraphMutation`, checksum e evidências.
|
|
12
|
+
- contratos não mudam; tipos de entidade e relações já existentes são usados.
|
|
13
|
+
- adapters SQLite não precisam de nova migração: recebem a mesma mutation.
|
|
14
|
+
- consumidores MCP/Context passam a enxergar mais relações após `apply`.
|
|
15
|
+
|
|
16
|
+
## Padrões cobertos
|
|
17
|
+
|
|
18
|
+
| Entrada | Relação | Evidência |
|
|
19
|
+
| --- | --- | --- |
|
|
20
|
+
| import/from/import() | `DEPENDS_ON` | linha da declaração |
|
|
21
|
+
| link Markdown | `DERIVED_FROM` | linha do link |
|
|
22
|
+
| export de símbolo | `DEFINES` | linha da declaração |
|
|
23
|
+
| `implements` | `IMPLEMENTS` | linha da declaração |
|
|
24
|
+
| chamada de função | `CALLS` | linha da chamada |
|
|
25
|
+
| `ADR-NNNN` | `DERIVED_FROM` | linha da referência |
|
|
26
|
+
| checkbox Markdown | `CONTAINS` | linha da tarefa |
|
|
27
|
+
| `**to**`/`**next agent**` | `ASSIGNED_TO` | linha do handoff |
|
|
28
|
+
| `describe`/`it`/`test` | `VALIDATES` | linha do teste |
|
|
29
|
+
| dependências do `package.json` | `DEPENDS_ON` | manifest |
|
|
30
|
+
|
|
31
|
+
## Critérios de aceite
|
|
32
|
+
|
|
33
|
+
1. Cada relação gerada possui evidência, origem e checksum da fonte.
|
|
34
|
+
2. Padrões existentes de import/link permanecem compatíveis.
|
|
35
|
+
3. JSON inválido não derruba a indexação; é responsabilidade do validator.
|
|
36
|
+
4. Dependências de manifest são nós `Technology`.
|
|
37
|
+
5. Relações não determinísticas não são inferidas por esta etapa.
|
|
38
|
+
6. Reaplicar a mesma mutation continua idempotente no GraphLoop.
|
|
39
|
+
|
|
40
|
+
## Limites
|
|
41
|
+
|
|
42
|
+
- chamadas são identificadas lexicalmente e podem incluir símbolos locais;
|
|
43
|
+
keywords de controle e wrappers de teste são filtrados.
|
|
44
|
+
- não há resolução completa de escopo, overload ou alias de import.
|
|
45
|
+
- commits e diffs continuam aguardando um extractor Git dedicado.
|
|
46
|
+
|
|
47
|
+
## Evidências
|
|
48
|
+
|
|
49
|
+
- `packages/graph/src/index.ts`;
|
|
50
|
+
- `test/graph.test.js`;
|
|
51
|
+
- suíte de contratos do GraphLoop.
|
|
@@ -1,63 +1,63 @@
|
|
|
1
|
-
# Guia Executivo de Onboarding (1 página)
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
Garantir que o projeto seja iniciado, executado e levado para produção sem perda de contexto, com governança de decisão e risco.
|
|
5
|
-
|
|
6
|
-
## Resultado Esperado
|
|
7
|
-
- Time alinhado em objetivos e escopo.
|
|
8
|
-
- Execução com steps claros, donos e critérios de pronto.
|
|
9
|
-
- Decisão Go/No-Go baseada em evidências.
|
|
10
|
-
- Continuidade operacional via documentação + handoff + resumos.
|
|
11
|
-
|
|
12
|
-
## Como Iniciar (rápido)
|
|
13
|
-
1. Criar projeto com scaffold:
|
|
14
|
-
```bash
|
|
15
|
-
npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
|
|
16
|
-
```
|
|
17
|
-
2. Subir backend e memória operacional:
|
|
18
|
-
```bash
|
|
19
|
-
cd nome-do-projeto/backend
|
|
20
|
-
npm install
|
|
21
|
-
npm run memory:db:init
|
|
22
|
-
npm run memory:db:sync
|
|
23
|
-
npm run start:dev
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Governança Mínima
|
|
27
|
-
- **Fonte da verdade**: markdown versionado (`memory/`, `docs/`).
|
|
28
|
-
- **Índice operacional**: SQLite para busca rápida de contexto.
|
|
29
|
-
- **Decisões arquiteturais**: ADR obrigatório para mudanças estruturais.
|
|
30
|
-
- **Troca entre responsáveis**: handoff obrigatório.
|
|
31
|
-
|
|
32
|
-
## Modelo de Execução
|
|
33
|
-
- Orquestrador decompõe o plano em steps menores.
|
|
34
|
-
- Workers executam por ownership de arquivo.
|
|
35
|
-
- Reviewer valida regressão, segurança e qualidade.
|
|
36
|
-
- Resumos globais/dominio são atualizados ao final de cada ciclo.
|
|
37
|
-
|
|
38
|
-
## Indicadores de Controle
|
|
39
|
-
- % steps com DoD completo
|
|
40
|
-
- # riscos críticos abertos
|
|
41
|
-
- cobertura de testes críticos
|
|
42
|
-
- incidentes pós-deploy
|
|
43
|
-
- tempo médio de handoff
|
|
44
|
-
|
|
45
|
-
## Gate de Produção (Go/No-Go)
|
|
46
|
-
### GO apenas se:
|
|
47
|
-
- build/testes/lint críticos verdes
|
|
48
|
-
- segurança validada (segredos, auth, validação de entrada)
|
|
49
|
-
- rollback definido e testado
|
|
50
|
-
- critérios de aceite aprovados
|
|
51
|
-
|
|
52
|
-
### NO-GO se:
|
|
53
|
-
- risco crítico sem mitigação
|
|
54
|
-
- falha de segurança/integridade
|
|
55
|
-
- ausência de rollback executável
|
|
56
|
-
|
|
57
|
-
## Responsabilidade da Liderança
|
|
58
|
-
- Cobrar clareza do plano e dos riscos antes da execução.
|
|
59
|
-
- Bloquear deploy sem checklist completo.
|
|
60
|
-
- Garantir atualização de documentação como parte da entrega.
|
|
61
|
-
|
|
62
|
-
## Mensagem-chave
|
|
63
|
-
O projeto não depende de “memória da conversa”; depende de disciplina de documentação operacional e decisão rastreável.
|
|
1
|
+
# Guia Executivo de Onboarding (1 página)
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
Garantir que o projeto seja iniciado, executado e levado para produção sem perda de contexto, com governança de decisão e risco.
|
|
5
|
+
|
|
6
|
+
## Resultado Esperado
|
|
7
|
+
- Time alinhado em objetivos e escopo.
|
|
8
|
+
- Execução com steps claros, donos e critérios de pronto.
|
|
9
|
+
- Decisão Go/No-Go baseada em evidências.
|
|
10
|
+
- Continuidade operacional via documentação + handoff + resumos.
|
|
11
|
+
|
|
12
|
+
## Como Iniciar (rápido)
|
|
13
|
+
1. Criar projeto com scaffold:
|
|
14
|
+
```bash
|
|
15
|
+
npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
|
|
16
|
+
```
|
|
17
|
+
2. Subir backend e memória operacional:
|
|
18
|
+
```bash
|
|
19
|
+
cd nome-do-projeto/backend
|
|
20
|
+
npm install
|
|
21
|
+
npm run memory:db:init
|
|
22
|
+
npm run memory:db:sync
|
|
23
|
+
npm run start:dev
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Governança Mínima
|
|
27
|
+
- **Fonte da verdade**: markdown versionado (`memory/`, `docs/`).
|
|
28
|
+
- **Índice operacional**: SQLite para busca rápida de contexto.
|
|
29
|
+
- **Decisões arquiteturais**: ADR obrigatório para mudanças estruturais.
|
|
30
|
+
- **Troca entre responsáveis**: handoff obrigatório.
|
|
31
|
+
|
|
32
|
+
## Modelo de Execução
|
|
33
|
+
- Orquestrador decompõe o plano em steps menores.
|
|
34
|
+
- Workers executam por ownership de arquivo.
|
|
35
|
+
- Reviewer valida regressão, segurança e qualidade.
|
|
36
|
+
- Resumos globais/dominio são atualizados ao final de cada ciclo.
|
|
37
|
+
|
|
38
|
+
## Indicadores de Controle
|
|
39
|
+
- % steps com DoD completo
|
|
40
|
+
- # riscos críticos abertos
|
|
41
|
+
- cobertura de testes críticos
|
|
42
|
+
- incidentes pós-deploy
|
|
43
|
+
- tempo médio de handoff
|
|
44
|
+
|
|
45
|
+
## Gate de Produção (Go/No-Go)
|
|
46
|
+
### GO apenas se:
|
|
47
|
+
- build/testes/lint críticos verdes
|
|
48
|
+
- segurança validada (segredos, auth, validação de entrada)
|
|
49
|
+
- rollback definido e testado
|
|
50
|
+
- critérios de aceite aprovados
|
|
51
|
+
|
|
52
|
+
### NO-GO se:
|
|
53
|
+
- risco crítico sem mitigação
|
|
54
|
+
- falha de segurança/integridade
|
|
55
|
+
- ausência de rollback executável
|
|
56
|
+
|
|
57
|
+
## Responsabilidade da Liderança
|
|
58
|
+
- Cobrar clareza do plano e dos riscos antes da execução.
|
|
59
|
+
- Bloquear deploy sem checklist completo.
|
|
60
|
+
- Garantir atualização de documentação como parte da entrega.
|
|
61
|
+
|
|
62
|
+
## Mensagem-chave
|
|
63
|
+
O projeto não depende de “memória da conversa”; depende de disciplina de documentação operacional e decisão rastreável.
|
|
@@ -1,136 +1,136 @@
|
|
|
1
|
-
# Guia Operacional por Papel
|
|
2
|
-
|
|
3
|
-
Este guia define responsabilidades objetivas por papel para execução previsível e validação segura até produção.
|
|
4
|
-
|
|
5
|
-
## 1) DEV
|
|
6
|
-
|
|
7
|
-
### Missão
|
|
8
|
-
Implementar com qualidade, manter contexto atualizado e reduzir retrabalho.
|
|
9
|
-
|
|
10
|
-
### Checklist Diário
|
|
11
|
-
- Ler contexto mínimo (`memory/00-global`, `20-architecture`, `current-sprint`).
|
|
12
|
-
- Executar tarefa com dono de escopo claro.
|
|
13
|
-
- Rodar testes mínimos da mudança.
|
|
14
|
-
- Atualizar documentação impactada.
|
|
15
|
-
- Atualizar resumo/handoff quando necessário.
|
|
16
|
-
- Rodar sync da memória operacional:
|
|
17
|
-
```bash
|
|
18
|
-
cd backend
|
|
19
|
-
npm run memory:db:sync
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
### Critério de Pronto (DEV)
|
|
23
|
-
- Código implementado
|
|
24
|
-
- Teste mínimo ok
|
|
25
|
-
- Sem quebra conhecida
|
|
26
|
-
- Documentação atualizada
|
|
27
|
-
- Risco registrado
|
|
28
|
-
|
|
29
|
-
## 2) QA
|
|
30
|
-
|
|
31
|
-
### Missão
|
|
32
|
-
Garantir que comportamento, qualidade e critérios de aceite estejam validados.
|
|
33
|
-
|
|
34
|
-
### Checklist QA
|
|
35
|
-
- Validar critérios de aceite do step.
|
|
36
|
-
- Rodar cenários críticos (feliz + erro).
|
|
37
|
-
- Verificar regressão funcional.
|
|
38
|
-
- Validar contrato de API (status, payload, erro).
|
|
39
|
-
- Registrar evidências objetivas.
|
|
40
|
-
|
|
41
|
-
### Saída QA
|
|
42
|
-
- `Aprovado` / `Aprovado com ressalvas` / `Reprovado`
|
|
43
|
-
- Bugs com severidade e impacto
|
|
44
|
-
- Recomendação para gate de produção
|
|
45
|
-
|
|
46
|
-
## 3) SRE
|
|
47
|
-
|
|
48
|
-
### Missão
|
|
49
|
-
Assegurar estabilidade operacional, observabilidade e rollback.
|
|
50
|
-
|
|
51
|
-
### Checklist SRE
|
|
52
|
-
- Healthcheck funcional.
|
|
53
|
-
- Logs e métricas essenciais disponíveis.
|
|
54
|
-
- Alertas mínimos ativos.
|
|
55
|
-
- Rollback documentado e testável.
|
|
56
|
-
- Dependências externas validadas.
|
|
57
|
-
|
|
58
|
-
### Gate SRE
|
|
59
|
-
Sem rollback executável e sem observabilidade mínima: **NO-GO**.
|
|
60
|
-
|
|
61
|
-
## 4) TECH LEAD
|
|
62
|
-
|
|
63
|
-
### Missão
|
|
64
|
-
Orquestrar plano, reduzir risco sistêmico e garantir decisão técnica coerente.
|
|
65
|
-
|
|
66
|
-
### Checklist Tech Lead
|
|
67
|
-
- Quebrar demanda em steps testáveis.
|
|
68
|
-
- Validar dependências e ordem de execução.
|
|
69
|
-
- Garantir ownership sem sobreposição de escrita.
|
|
70
|
-
- Exigir ADR em decisão estrutural.
|
|
71
|
-
- Consolidar riscos antes de produção.
|
|
72
|
-
|
|
73
|
-
### Entregável Tech Lead
|
|
74
|
-
- Plano final da sprint
|
|
75
|
-
- Matriz de risco
|
|
76
|
-
- Recomendação Go/No-Go
|
|
77
|
-
|
|
78
|
-
## 5) Fluxo Integrado (papéis)
|
|
79
|
-
|
|
80
|
-
1. Tech Lead/Orchestrator define steps e donos.
|
|
81
|
-
2. Dev implementa + testa + documenta.
|
|
82
|
-
3. QA valida critérios e regressão.
|
|
83
|
-
4. SRE valida operação e rollback.
|
|
84
|
-
5. Tech Lead consolida e decide com stakeholders.
|
|
85
|
-
|
|
86
|
-
## 6) Questionamento Obrigatório por Step
|
|
87
|
-
|
|
88
|
-
Antes de executar, todos devem responder:
|
|
89
|
-
- Está claro o objetivo e o critério de sucesso?
|
|
90
|
-
- Dependências e bloqueios estão explícitos?
|
|
91
|
-
- Risco e impacto foram mapeados?
|
|
92
|
-
- Existe forma de validar e de reverter?
|
|
93
|
-
|
|
94
|
-
Se qualquer item for “não”: refinar step antes da execução.
|
|
95
|
-
|
|
96
|
-
## 7) Comandos Úteis
|
|
97
|
-
|
|
98
|
-
### Setup
|
|
99
|
-
```bash
|
|
100
|
-
cd backend
|
|
101
|
-
npm install
|
|
102
|
-
npm run memory:db:init
|
|
103
|
-
npm run memory:db:sync
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
### Consulta de contexto
|
|
107
|
-
```bash
|
|
108
|
-
npm run memory:db:query -- "search" "auth" 10
|
|
109
|
-
npm run memory:db:query -- handoffs 10
|
|
110
|
-
npm run memory:db:query -- adrs 20
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### Registrar handoff
|
|
114
|
-
```bash
|
|
115
|
-
cd ..
|
|
116
|
-
node scripts/append-handoff.mjs orchestrator backend-nest "implementar modulo auth"
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
## 8) Gate Final de Produção
|
|
120
|
-
|
|
121
|
-
### GO quando:
|
|
122
|
-
- DEV, QA e SRE aprovaram seus checklists
|
|
123
|
-
- riscos críticos mitigados
|
|
124
|
-
- rollback pronto
|
|
125
|
-
|
|
126
|
-
### NO-GO quando:
|
|
127
|
-
- risco crítico aberto
|
|
128
|
-
- falha de segurança
|
|
129
|
-
- ausência de evidência de validação
|
|
130
|
-
|
|
131
|
-
---
|
|
132
|
-
|
|
133
|
-
## 9) Princípio de operação
|
|
134
|
-
|
|
135
|
-
Qualidade, documentação e continuidade de contexto são parte da entrega técnica.
|
|
136
|
-
Não são atividades opcionais.
|
|
1
|
+
# Guia Operacional por Papel
|
|
2
|
+
|
|
3
|
+
Este guia define responsabilidades objetivas por papel para execução previsível e validação segura até produção.
|
|
4
|
+
|
|
5
|
+
## 1) DEV
|
|
6
|
+
|
|
7
|
+
### Missão
|
|
8
|
+
Implementar com qualidade, manter contexto atualizado e reduzir retrabalho.
|
|
9
|
+
|
|
10
|
+
### Checklist Diário
|
|
11
|
+
- Ler contexto mínimo (`memory/00-global`, `20-architecture`, `current-sprint`).
|
|
12
|
+
- Executar tarefa com dono de escopo claro.
|
|
13
|
+
- Rodar testes mínimos da mudança.
|
|
14
|
+
- Atualizar documentação impactada.
|
|
15
|
+
- Atualizar resumo/handoff quando necessário.
|
|
16
|
+
- Rodar sync da memória operacional:
|
|
17
|
+
```bash
|
|
18
|
+
cd backend
|
|
19
|
+
npm run memory:db:sync
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
### Critério de Pronto (DEV)
|
|
23
|
+
- Código implementado
|
|
24
|
+
- Teste mínimo ok
|
|
25
|
+
- Sem quebra conhecida
|
|
26
|
+
- Documentação atualizada
|
|
27
|
+
- Risco registrado
|
|
28
|
+
|
|
29
|
+
## 2) QA
|
|
30
|
+
|
|
31
|
+
### Missão
|
|
32
|
+
Garantir que comportamento, qualidade e critérios de aceite estejam validados.
|
|
33
|
+
|
|
34
|
+
### Checklist QA
|
|
35
|
+
- Validar critérios de aceite do step.
|
|
36
|
+
- Rodar cenários críticos (feliz + erro).
|
|
37
|
+
- Verificar regressão funcional.
|
|
38
|
+
- Validar contrato de API (status, payload, erro).
|
|
39
|
+
- Registrar evidências objetivas.
|
|
40
|
+
|
|
41
|
+
### Saída QA
|
|
42
|
+
- `Aprovado` / `Aprovado com ressalvas` / `Reprovado`
|
|
43
|
+
- Bugs com severidade e impacto
|
|
44
|
+
- Recomendação para gate de produção
|
|
45
|
+
|
|
46
|
+
## 3) SRE
|
|
47
|
+
|
|
48
|
+
### Missão
|
|
49
|
+
Assegurar estabilidade operacional, observabilidade e rollback.
|
|
50
|
+
|
|
51
|
+
### Checklist SRE
|
|
52
|
+
- Healthcheck funcional.
|
|
53
|
+
- Logs e métricas essenciais disponíveis.
|
|
54
|
+
- Alertas mínimos ativos.
|
|
55
|
+
- Rollback documentado e testável.
|
|
56
|
+
- Dependências externas validadas.
|
|
57
|
+
|
|
58
|
+
### Gate SRE
|
|
59
|
+
Sem rollback executável e sem observabilidade mínima: **NO-GO**.
|
|
60
|
+
|
|
61
|
+
## 4) TECH LEAD
|
|
62
|
+
|
|
63
|
+
### Missão
|
|
64
|
+
Orquestrar plano, reduzir risco sistêmico e garantir decisão técnica coerente.
|
|
65
|
+
|
|
66
|
+
### Checklist Tech Lead
|
|
67
|
+
- Quebrar demanda em steps testáveis.
|
|
68
|
+
- Validar dependências e ordem de execução.
|
|
69
|
+
- Garantir ownership sem sobreposição de escrita.
|
|
70
|
+
- Exigir ADR em decisão estrutural.
|
|
71
|
+
- Consolidar riscos antes de produção.
|
|
72
|
+
|
|
73
|
+
### Entregável Tech Lead
|
|
74
|
+
- Plano final da sprint
|
|
75
|
+
- Matriz de risco
|
|
76
|
+
- Recomendação Go/No-Go
|
|
77
|
+
|
|
78
|
+
## 5) Fluxo Integrado (papéis)
|
|
79
|
+
|
|
80
|
+
1. Tech Lead/Orchestrator define steps e donos.
|
|
81
|
+
2. Dev implementa + testa + documenta.
|
|
82
|
+
3. QA valida critérios e regressão.
|
|
83
|
+
4. SRE valida operação e rollback.
|
|
84
|
+
5. Tech Lead consolida e decide com stakeholders.
|
|
85
|
+
|
|
86
|
+
## 6) Questionamento Obrigatório por Step
|
|
87
|
+
|
|
88
|
+
Antes de executar, todos devem responder:
|
|
89
|
+
- Está claro o objetivo e o critério de sucesso?
|
|
90
|
+
- Dependências e bloqueios estão explícitos?
|
|
91
|
+
- Risco e impacto foram mapeados?
|
|
92
|
+
- Existe forma de validar e de reverter?
|
|
93
|
+
|
|
94
|
+
Se qualquer item for “não”: refinar step antes da execução.
|
|
95
|
+
|
|
96
|
+
## 7) Comandos Úteis
|
|
97
|
+
|
|
98
|
+
### Setup
|
|
99
|
+
```bash
|
|
100
|
+
cd backend
|
|
101
|
+
npm install
|
|
102
|
+
npm run memory:db:init
|
|
103
|
+
npm run memory:db:sync
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
### Consulta de contexto
|
|
107
|
+
```bash
|
|
108
|
+
npm run memory:db:query -- "search" "auth" 10
|
|
109
|
+
npm run memory:db:query -- handoffs 10
|
|
110
|
+
npm run memory:db:query -- adrs 20
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### Registrar handoff
|
|
114
|
+
```bash
|
|
115
|
+
cd ..
|
|
116
|
+
node scripts/append-handoff.mjs orchestrator backend-nest "implementar modulo auth"
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
## 8) Gate Final de Produção
|
|
120
|
+
|
|
121
|
+
### GO quando:
|
|
122
|
+
- DEV, QA e SRE aprovaram seus checklists
|
|
123
|
+
- riscos críticos mitigados
|
|
124
|
+
- rollback pronto
|
|
125
|
+
|
|
126
|
+
### NO-GO quando:
|
|
127
|
+
- risco crítico aberto
|
|
128
|
+
- falha de segurança
|
|
129
|
+
- ausência de evidência de validação
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## 9) Princípio de operação
|
|
134
|
+
|
|
135
|
+
Qualidade, documentação e continuidade de contexto são parte da entrega técnica.
|
|
136
|
+
Não são atividades opcionais.
|