forjajs 2.0.4 → 3.0.0
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 +50 -50
- 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 +133 -133
- package/CHANGELOG.md +619 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +64 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +15 -0
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.js +27 -4
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +32 -3
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- 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/manual-operacional-cli-sdd-gsd.md +1014 -1014
- 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/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 +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -157
- 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/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- 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/cost-aware-autonomy-budget/spec.md +102 -0
- 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/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- 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/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- 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/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- 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/spec.md +23 -23
- 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/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- 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,35 +1,35 @@
|
|
|
1
|
-
# Sprint 4 — MCP nativo sobre o Capability Registry
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Disponibilizar o catálogo de capabilities por MCP sem duplicar ferramentas, handlers ou regras de
|
|
6
|
-
policy, incluindo um transporte local JSON-RPC por stdio.
|
|
7
|
-
|
|
8
|
-
## Escopo
|
|
9
|
-
|
|
10
|
-
- `forja mcp:start`;
|
|
11
|
-
- `tools/list`, `tools/call`, `resources/list`, `resources/read` e `initialize`;
|
|
12
|
-
- `forja_capability_describe`;
|
|
13
|
-
- ferramentas dinâmicas derivadas dos IDs visíveis no registry;
|
|
14
|
-
- execução dinâmica delegada ao mesmo `CapabilityRegistry`;
|
|
15
|
-
- identidade e permissões MCP locais;
|
|
16
|
-
- testes do adapter e smoke test stdio.
|
|
17
|
-
|
|
18
|
-
Fora do escopo: transporte HTTP/SSE MCP, autenticação remota, GraphLoop persistente e aprovação
|
|
19
|
-
interativa de ações críticas.
|
|
20
|
-
|
|
21
|
-
## Critérios de aceite
|
|
22
|
-
|
|
23
|
-
1. `mcp:start` responde JSON-RPC por linha sem depender de provedor externo.
|
|
24
|
-
2. `tools/list` contém ferramentas fixas e uma ferramenta derivada por capability visível.
|
|
25
|
-
3. `forja_capability_describe` retorna a definição versionada do registry.
|
|
26
|
-
4. Execução dinâmica retorna `ExecutionResult` e passa pelo Policy Engine.
|
|
27
|
-
5. Recursos MCP continuam disponíveis e erros são normalizados.
|
|
28
|
-
6. Nenhuma regra de domínio é implementada dentro do transporte stdio.
|
|
29
|
-
|
|
30
|
-
## Riscos e hipóteses
|
|
31
|
-
|
|
32
|
-
- O transporte stdio implementa o subconjunto local necessário para a operação do Forja; clientes
|
|
33
|
-
que exigirem recursos MCP adicionais ficam para uma sprint própria.
|
|
34
|
-
- Schemas de payload específicos ainda são genéricos porque `CapabilityDefinition` não carrega um
|
|
35
|
-
schema de input serializável; a validação definitiva continua no registry.
|
|
1
|
+
# Sprint 4 — MCP nativo sobre o Capability Registry
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Disponibilizar o catálogo de capabilities por MCP sem duplicar ferramentas, handlers ou regras de
|
|
6
|
+
policy, incluindo um transporte local JSON-RPC por stdio.
|
|
7
|
+
|
|
8
|
+
## Escopo
|
|
9
|
+
|
|
10
|
+
- `forja mcp:start`;
|
|
11
|
+
- `tools/list`, `tools/call`, `resources/list`, `resources/read` e `initialize`;
|
|
12
|
+
- `forja_capability_describe`;
|
|
13
|
+
- ferramentas dinâmicas derivadas dos IDs visíveis no registry;
|
|
14
|
+
- execução dinâmica delegada ao mesmo `CapabilityRegistry`;
|
|
15
|
+
- identidade e permissões MCP locais;
|
|
16
|
+
- testes do adapter e smoke test stdio.
|
|
17
|
+
|
|
18
|
+
Fora do escopo: transporte HTTP/SSE MCP, autenticação remota, GraphLoop persistente e aprovação
|
|
19
|
+
interativa de ações críticas.
|
|
20
|
+
|
|
21
|
+
## Critérios de aceite
|
|
22
|
+
|
|
23
|
+
1. `mcp:start` responde JSON-RPC por linha sem depender de provedor externo.
|
|
24
|
+
2. `tools/list` contém ferramentas fixas e uma ferramenta derivada por capability visível.
|
|
25
|
+
3. `forja_capability_describe` retorna a definição versionada do registry.
|
|
26
|
+
4. Execução dinâmica retorna `ExecutionResult` e passa pelo Policy Engine.
|
|
27
|
+
5. Recursos MCP continuam disponíveis e erros são normalizados.
|
|
28
|
+
6. Nenhuma regra de domínio é implementada dentro do transporte stdio.
|
|
29
|
+
|
|
30
|
+
## Riscos e hipóteses
|
|
31
|
+
|
|
32
|
+
- O transporte stdio implementa o subconjunto local necessário para a operação do Forja; clientes
|
|
33
|
+
que exigirem recursos MCP adicionais ficam para uma sprint própria.
|
|
34
|
+
- Schemas de payload específicos ainda são genéricos porque `CapabilityDefinition` não carrega um
|
|
35
|
+
schema de input serializável; a validação definitiva continua no registry.
|
|
@@ -1,31 +1,31 @@
|
|
|
1
|
-
# Sprint 5 — Catálogo padrão, approvals e auditoria MCP
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Fechar a composição oficial do server sobre o mesmo catálogo da CLI e tornar approvals e chamadas
|
|
6
|
-
MCP duráveis e auditáveis em SQLite.
|
|
7
|
-
|
|
8
|
-
## Entregas
|
|
9
|
-
|
|
10
|
-
- `createDefaultCapabilityRegistry` no server com as seis capabilities migradas;
|
|
11
|
-
- `ApprovalStore` no Policy Engine;
|
|
12
|
-
- `SqliteApprovalStore` e migração SQLite v3;
|
|
13
|
-
- `McpAuditSink` e `SqliteMcpAuditSink`;
|
|
14
|
-
- auditoria de sucesso, falha e ferramenta inexistente;
|
|
15
|
-
- server inicializando catálogo, approvals e auditoria no banco do workspace.
|
|
16
|
-
|
|
17
|
-
## Critérios de aceite
|
|
18
|
-
|
|
19
|
-
1. Server e CLI descobrem os mesmos seis IDs.
|
|
20
|
-
2. Approval criado antes do reinício pode ser consultado e decidido depois.
|
|
21
|
-
3. Chamada MCP gera registro de auditoria sem derrubar o transporte se o sink falhar.
|
|
22
|
-
4. Migrações v1–v3 são idempotentes e não destrutivas.
|
|
23
|
-
5. Policy continua bloqueando ações fora do escopo.
|
|
24
|
-
6. Testes, build e release gate passam.
|
|
25
|
-
|
|
26
|
-
## Hipóteses e riscos
|
|
27
|
-
|
|
28
|
-
- O catálogo padrão usa os handlers determinísticos existentes; capabilities futuras devem ser
|
|
29
|
-
registradas no mesmo ponto de composição.
|
|
30
|
-
- A auditoria MCP usa `SqliteAuditStore` existente e não cria um ledger paralelo.
|
|
31
|
-
- `ApprovalLedger` mantém API síncrona nesta primeira distribuição local-first.
|
|
1
|
+
# Sprint 5 — Catálogo padrão, approvals e auditoria MCP
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Fechar a composição oficial do server sobre o mesmo catálogo da CLI e tornar approvals e chamadas
|
|
6
|
+
MCP duráveis e auditáveis em SQLite.
|
|
7
|
+
|
|
8
|
+
## Entregas
|
|
9
|
+
|
|
10
|
+
- `createDefaultCapabilityRegistry` no server com as seis capabilities migradas;
|
|
11
|
+
- `ApprovalStore` no Policy Engine;
|
|
12
|
+
- `SqliteApprovalStore` e migração SQLite v3;
|
|
13
|
+
- `McpAuditSink` e `SqliteMcpAuditSink`;
|
|
14
|
+
- auditoria de sucesso, falha e ferramenta inexistente;
|
|
15
|
+
- server inicializando catálogo, approvals e auditoria no banco do workspace.
|
|
16
|
+
|
|
17
|
+
## Critérios de aceite
|
|
18
|
+
|
|
19
|
+
1. Server e CLI descobrem os mesmos seis IDs.
|
|
20
|
+
2. Approval criado antes do reinício pode ser consultado e decidido depois.
|
|
21
|
+
3. Chamada MCP gera registro de auditoria sem derrubar o transporte se o sink falhar.
|
|
22
|
+
4. Migrações v1–v3 são idempotentes e não destrutivas.
|
|
23
|
+
5. Policy continua bloqueando ações fora do escopo.
|
|
24
|
+
6. Testes, build e release gate passam.
|
|
25
|
+
|
|
26
|
+
## Hipóteses e riscos
|
|
27
|
+
|
|
28
|
+
- O catálogo padrão usa os handlers determinísticos existentes; capabilities futuras devem ser
|
|
29
|
+
registradas no mesmo ponto de composição.
|
|
30
|
+
- A auditoria MCP usa `SqliteAuditStore` existente e não cria um ledger paralelo.
|
|
31
|
+
- `ApprovalLedger` mantém API síncrona nesta primeira distribuição local-first.
|
|
@@ -1,55 +1,55 @@
|
|
|
1
|
-
# Sprint 6 — Eventos persistentes e prova operacional
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Conectar o Event Bus ao server oficial com log SQLite append-only e comprovar,
|
|
6
|
-
em um cenário determinístico, o fluxo supervisionado approval → sandbox →
|
|
7
|
-
runtime → validator → evento persistido.
|
|
8
|
-
|
|
9
|
-
## Escopo
|
|
10
|
-
|
|
11
|
-
- hidratação do Event Bus a partir do store ao iniciar;
|
|
12
|
-
- idempotência e sequência por aggregate após reinício;
|
|
13
|
-
- persistência de eventos publicados pelo Control Plane no SQLite do workspace;
|
|
14
|
-
- prova E2E sem provedor de LLM, usando capability e sandbox simuladas;
|
|
15
|
-
- teste de aprovação, retomada, validação e registro de `execution.completed`.
|
|
16
|
-
|
|
17
|
-
## Fora do escopo
|
|
18
|
-
|
|
19
|
-
- substituir o stream SSE em memória por broker externo;
|
|
20
|
-
- persistir subscriptions e dead letters entre processos;
|
|
21
|
-
- implementar o backend Git worktree real;
|
|
22
|
-
- integrar GraphLoop SQLite ou dashboard operacional.
|
|
23
|
-
|
|
24
|
-
## Tarefas verificáveis
|
|
25
|
-
|
|
26
|
-
1. Carregar eventos existentes antes de gerar sequência ou aceitar idempotency key.
|
|
27
|
-
2. Instanciar `EventBus(SqliteEventStore)` no bootstrap NestJS.
|
|
28
|
-
3. Encaminhar eventos do Control Plane para SSE e log durável.
|
|
29
|
-
4. Executar a fixture de teste falho com aprovação humana e sandbox isolada.
|
|
30
|
-
5. Validar aceitação independentemente do handler implementador.
|
|
31
|
-
6. Rodar testes, typecheck, build e release gate.
|
|
32
|
-
|
|
33
|
-
## Critérios de aceite
|
|
34
|
-
|
|
35
|
-
- duas instâncias do Event Bus sobre o mesmo SQLite preservam sequência e
|
|
36
|
-
idempotência;
|
|
37
|
-
- server inicializa runtime, approvals, MCP audit e eventos no mesmo banco;
|
|
38
|
-
- a prova E2E termina somente após aprovação e validator `accepted`;
|
|
39
|
-
- a prova registra um evento `execution.completed` persistido;
|
|
40
|
-
- nenhum teste depende de LLM, rede ou estado externo;
|
|
41
|
-
- documentação e ADR registram limites conhecidos.
|
|
42
|
-
|
|
43
|
-
## Evidências esperadas
|
|
44
|
-
|
|
45
|
-
- `test/events-scheduler.test.js`;
|
|
46
|
-
- `test/autonomy-e2e.test.js`;
|
|
47
|
-
- `packages/events/src/index.ts`;
|
|
48
|
-
- `apps/server/src/main.ts`;
|
|
49
|
-
- saída de `npm test`, `tsc --noEmit`, `npm run build` e
|
|
50
|
-
`npm run release:check`.
|
|
51
|
-
|
|
52
|
-
## Próxima dependência
|
|
53
|
-
|
|
54
|
-
A próxima sprint deve persistir o GraphLoop e ligar suas evidências ao mesmo
|
|
55
|
-
fluxo de execução, mantendo o Event Bus como trilha de integração.
|
|
1
|
+
# Sprint 6 — Eventos persistentes e prova operacional
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Conectar o Event Bus ao server oficial com log SQLite append-only e comprovar,
|
|
6
|
+
em um cenário determinístico, o fluxo supervisionado approval → sandbox →
|
|
7
|
+
runtime → validator → evento persistido.
|
|
8
|
+
|
|
9
|
+
## Escopo
|
|
10
|
+
|
|
11
|
+
- hidratação do Event Bus a partir do store ao iniciar;
|
|
12
|
+
- idempotência e sequência por aggregate após reinício;
|
|
13
|
+
- persistência de eventos publicados pelo Control Plane no SQLite do workspace;
|
|
14
|
+
- prova E2E sem provedor de LLM, usando capability e sandbox simuladas;
|
|
15
|
+
- teste de aprovação, retomada, validação e registro de `execution.completed`.
|
|
16
|
+
|
|
17
|
+
## Fora do escopo
|
|
18
|
+
|
|
19
|
+
- substituir o stream SSE em memória por broker externo;
|
|
20
|
+
- persistir subscriptions e dead letters entre processos;
|
|
21
|
+
- implementar o backend Git worktree real;
|
|
22
|
+
- integrar GraphLoop SQLite ou dashboard operacional.
|
|
23
|
+
|
|
24
|
+
## Tarefas verificáveis
|
|
25
|
+
|
|
26
|
+
1. Carregar eventos existentes antes de gerar sequência ou aceitar idempotency key.
|
|
27
|
+
2. Instanciar `EventBus(SqliteEventStore)` no bootstrap NestJS.
|
|
28
|
+
3. Encaminhar eventos do Control Plane para SSE e log durável.
|
|
29
|
+
4. Executar a fixture de teste falho com aprovação humana e sandbox isolada.
|
|
30
|
+
5. Validar aceitação independentemente do handler implementador.
|
|
31
|
+
6. Rodar testes, typecheck, build e release gate.
|
|
32
|
+
|
|
33
|
+
## Critérios de aceite
|
|
34
|
+
|
|
35
|
+
- duas instâncias do Event Bus sobre o mesmo SQLite preservam sequência e
|
|
36
|
+
idempotência;
|
|
37
|
+
- server inicializa runtime, approvals, MCP audit e eventos no mesmo banco;
|
|
38
|
+
- a prova E2E termina somente após aprovação e validator `accepted`;
|
|
39
|
+
- a prova registra um evento `execution.completed` persistido;
|
|
40
|
+
- nenhum teste depende de LLM, rede ou estado externo;
|
|
41
|
+
- documentação e ADR registram limites conhecidos.
|
|
42
|
+
|
|
43
|
+
## Evidências esperadas
|
|
44
|
+
|
|
45
|
+
- `test/events-scheduler.test.js`;
|
|
46
|
+
- `test/autonomy-e2e.test.js`;
|
|
47
|
+
- `packages/events/src/index.ts`;
|
|
48
|
+
- `apps/server/src/main.ts`;
|
|
49
|
+
- saída de `npm test`, `tsc --noEmit`, `npm run build` e
|
|
50
|
+
`npm run release:check`.
|
|
51
|
+
|
|
52
|
+
## Próxima dependência
|
|
53
|
+
|
|
54
|
+
A próxima sprint deve persistir o GraphLoop e ligar suas evidências ao mesmo
|
|
55
|
+
fluxo de execução, mantendo o Event Bus como trilha de integração.
|
|
@@ -1,60 +1,60 @@
|
|
|
1
|
-
# Sprint 7 — GraphLoop persistente e evidências de execução
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Substituir o store oficial em memória do GraphLoop por uma porta de domínio com
|
|
6
|
-
adapter SQLite, preservar as invariantes de evidência e checksum e registrar no
|
|
7
|
-
grafo as relações produzidas por execuções do Runtime.
|
|
8
|
-
|
|
9
|
-
## Análise de impacto
|
|
10
|
-
|
|
11
|
-
- `packages/graph`: passa a depender de `GraphStore`, sem conhecer SQLite.
|
|
12
|
-
- `packages/adapter-sqlite`: recebe migração v4 e `SqliteGraphStore`.
|
|
13
|
-
- `apps/server`: compõe MCP e Runtime com o mesmo GraphLoop SQLite.
|
|
14
|
-
- `packages/runtime`: não é alterado conceitualmente; usa a porta existente
|
|
15
|
-
`RuntimeMemory` por meio de um adapter em `packages/graph`.
|
|
16
|
-
- Context Engine permanece consumindo fontes por porta; a seleção semântica
|
|
17
|
-
completa sobre nós e trechos é escopo posterior.
|
|
18
|
-
|
|
19
|
-
## Escopo
|
|
20
|
-
|
|
21
|
-
- nós, arestas, evidências e checksums de origem persistidos;
|
|
22
|
-
- tabelas preparatórias para claims, contradições, agenda e extrações;
|
|
23
|
-
- recuperação após reconstrução do `GraphLoop`;
|
|
24
|
-
- consultas, path e impacto sobre dados SQLite;
|
|
25
|
-
- memória de execução com relação `Execution PRODUCES Capability` auditada.
|
|
26
|
-
|
|
27
|
-
## Fora do escopo
|
|
28
|
-
|
|
29
|
-
- banco externo ou consultas assíncronas;
|
|
30
|
-
- inferência por LLM;
|
|
31
|
-
- detecção avançada de contradições além das regras existentes;
|
|
32
|
-
- indexação automática de todo workspace no bootstrap;
|
|
33
|
-
- dashboard novo.
|
|
34
|
-
|
|
35
|
-
## Critérios de aceite
|
|
36
|
-
|
|
37
|
-
1. Migrações v1–v4 são idempotentes e não destrutivas.
|
|
38
|
-
2. `SqliteGraphStore` satisfaz a porta usada pelo domínio e não importa NestJS.
|
|
39
|
-
3. Nós, evidências, arestas e checksum sobrevivem à recriação do GraphLoop.
|
|
40
|
-
4. A segunda aplicação da mesma fonte é ignorada por checksum.
|
|
41
|
-
5. Nenhuma aresta é salva sem endpoints e evidência existente.
|
|
42
|
-
6. Runtime pode registrar uma execução como relação verificável no grafo.
|
|
43
|
-
7. Server usa o GraphLoop SQLite para MCP e Runtime.
|
|
44
|
-
|
|
45
|
-
## Hipóteses e riscos
|
|
46
|
-
|
|
47
|
-
- A API síncrona atual do GraphLoop é mantida para preservar os consumidores
|
|
48
|
-
existentes e adequar-se ao SQLite local.
|
|
49
|
-
- Tabelas de claims/contradições/agenda/extractions são fundação de schema, não
|
|
50
|
-
significam que seus engines estejam persistentes nesta sprint.
|
|
51
|
-
- A prova de execução registra evidências já produzidas pelo handler; não cria
|
|
52
|
-
evidência artificial para ações sem prova.
|
|
53
|
-
|
|
54
|
-
## Evidências
|
|
55
|
-
|
|
56
|
-
- `packages/graph/src/index.ts`;
|
|
57
|
-
- `packages/adapter-sqlite/src/index.ts`;
|
|
58
|
-
- `apps/server/src/main.ts`;
|
|
59
|
-
- `test/graph.test.js`;
|
|
60
|
-
- `test/adapter-sqlite.test.js`.
|
|
1
|
+
# Sprint 7 — GraphLoop persistente e evidências de execução
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Substituir o store oficial em memória do GraphLoop por uma porta de domínio com
|
|
6
|
+
adapter SQLite, preservar as invariantes de evidência e checksum e registrar no
|
|
7
|
+
grafo as relações produzidas por execuções do Runtime.
|
|
8
|
+
|
|
9
|
+
## Análise de impacto
|
|
10
|
+
|
|
11
|
+
- `packages/graph`: passa a depender de `GraphStore`, sem conhecer SQLite.
|
|
12
|
+
- `packages/adapter-sqlite`: recebe migração v4 e `SqliteGraphStore`.
|
|
13
|
+
- `apps/server`: compõe MCP e Runtime com o mesmo GraphLoop SQLite.
|
|
14
|
+
- `packages/runtime`: não é alterado conceitualmente; usa a porta existente
|
|
15
|
+
`RuntimeMemory` por meio de um adapter em `packages/graph`.
|
|
16
|
+
- Context Engine permanece consumindo fontes por porta; a seleção semântica
|
|
17
|
+
completa sobre nós e trechos é escopo posterior.
|
|
18
|
+
|
|
19
|
+
## Escopo
|
|
20
|
+
|
|
21
|
+
- nós, arestas, evidências e checksums de origem persistidos;
|
|
22
|
+
- tabelas preparatórias para claims, contradições, agenda e extrações;
|
|
23
|
+
- recuperação após reconstrução do `GraphLoop`;
|
|
24
|
+
- consultas, path e impacto sobre dados SQLite;
|
|
25
|
+
- memória de execução com relação `Execution PRODUCES Capability` auditada.
|
|
26
|
+
|
|
27
|
+
## Fora do escopo
|
|
28
|
+
|
|
29
|
+
- banco externo ou consultas assíncronas;
|
|
30
|
+
- inferência por LLM;
|
|
31
|
+
- detecção avançada de contradições além das regras existentes;
|
|
32
|
+
- indexação automática de todo workspace no bootstrap;
|
|
33
|
+
- dashboard novo.
|
|
34
|
+
|
|
35
|
+
## Critérios de aceite
|
|
36
|
+
|
|
37
|
+
1. Migrações v1–v4 são idempotentes e não destrutivas.
|
|
38
|
+
2. `SqliteGraphStore` satisfaz a porta usada pelo domínio e não importa NestJS.
|
|
39
|
+
3. Nós, evidências, arestas e checksum sobrevivem à recriação do GraphLoop.
|
|
40
|
+
4. A segunda aplicação da mesma fonte é ignorada por checksum.
|
|
41
|
+
5. Nenhuma aresta é salva sem endpoints e evidência existente.
|
|
42
|
+
6. Runtime pode registrar uma execução como relação verificável no grafo.
|
|
43
|
+
7. Server usa o GraphLoop SQLite para MCP e Runtime.
|
|
44
|
+
|
|
45
|
+
## Hipóteses e riscos
|
|
46
|
+
|
|
47
|
+
- A API síncrona atual do GraphLoop é mantida para preservar os consumidores
|
|
48
|
+
existentes e adequar-se ao SQLite local.
|
|
49
|
+
- Tabelas de claims/contradições/agenda/extractions são fundação de schema, não
|
|
50
|
+
significam que seus engines estejam persistentes nesta sprint.
|
|
51
|
+
- A prova de execução registra evidências já produzidas pelo handler; não cria
|
|
52
|
+
evidência artificial para ações sem prova.
|
|
53
|
+
|
|
54
|
+
## Evidências
|
|
55
|
+
|
|
56
|
+
- `packages/graph/src/index.ts`;
|
|
57
|
+
- `packages/adapter-sqlite/src/index.ts`;
|
|
58
|
+
- `apps/server/src/main.ts`;
|
|
59
|
+
- `test/graph.test.js`;
|
|
60
|
+
- `test/adapter-sqlite.test.js`.
|
|
@@ -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.
|