forjajs 2.0.4 → 4.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 +19 -25
- package/.claude/agents/governance.md +19 -55
- package/.claude/agents/marketing.md +19 -24
- package/.claude/agents/orchestrator.md +19 -31
- package/.claude/agents/product.md +19 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +19 -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 +93 -87
- package/.github/copilot-instructions.md +93 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +93 -87
- package/AGENTS.md +137 -134
- package/CHANGELOG.md +656 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +68 -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 +17 -1
- 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/release.js +3 -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/llm/codex-output.d.ts +12 -0
- package/dist/lib/llm/codex-output.js +56 -0
- package/dist/lib/llm/context.d.ts +5 -0
- package/dist/lib/llm/context.js +17 -0
- package/dist/lib/llm/session.d.ts +18 -0
- package/dist/lib/llm/session.js +34 -0
- package/dist/lib/llm/validation.d.ts +37 -0
- package/dist/lib/llm/validation.js +88 -0
- 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/evals/src/index.js +6 -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.d.ts +8 -1
- package/dist/packages/llm/src/index.js +64 -7
- 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 +85 -9
- 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/agent-operating-contract.md +26 -0
- 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/llm-evolution.md +51 -0
- package/docs/llm-fit-loop.md +134 -5
- 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 +49 -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/0080-llm-execution-evidence.md +42 -0
- package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +159 -157
- package/prompts/context-engineer-agent.md +13 -19
- package/prompts/governance-agent.md +13 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +13 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +13 -20
- package/skills/MANIFEST.json +10 -0
- package/skills/llm-provider-routing/SKILL.md +18 -0
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +50 -43
- package/specs/_templates/spec.md +50 -43
- package/specs/_templates/tasks.md +39 -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-instructions-v4/plan.md +8 -0
- package/specs/agent-instructions-v4/spec.md +21 -0
- package/specs/agent-instructions-v4/tasks.md +12 -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/llm-integration-v2/plan.md +55 -0
- package/specs/llm-integration-v2/spec.md +61 -0
- package/specs/llm-integration-v2/tasks.md +28 -0
- package/specs/llm-resume-validation/plan.md +50 -0
- package/specs/llm-resume-validation/spec.md +35 -0
- package/specs/llm-resume-validation/tasks.md +19 -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
|
@@ -18,32 +18,32 @@ const onlyProject = projectArgIndex >= 0 ? args[projectArgIndex + 1] : null;
|
|
|
18
18
|
const syncGlobal = !onlyProject || args.includes('--global');
|
|
19
19
|
const syncProjects = !args.includes('--global') || Boolean(onlyProject);
|
|
20
20
|
// Schema simplificado para a Memória Universal
|
|
21
|
-
const schema = `
|
|
22
|
-
CREATE TABLE IF NOT EXISTS projects (
|
|
23
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
24
|
-
name TEXT NOT NULL UNIQUE,
|
|
25
|
-
path TEXT NOT NULL,
|
|
26
|
-
created_at TEXT NOT NULL
|
|
27
|
-
);
|
|
28
|
-
|
|
29
|
-
CREATE TABLE IF NOT EXISTS memory_nodes (
|
|
30
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
31
|
-
project_id INTEGER, -- NULL se for global
|
|
32
|
-
path TEXT NOT NULL UNIQUE,
|
|
33
|
-
kind TEXT NOT NULL, -- 'global', 'project', 'domain', 'adr', 'summary'
|
|
34
|
-
title TEXT,
|
|
35
|
-
content TEXT NOT NULL,
|
|
36
|
-
content_hash TEXT NOT NULL,
|
|
37
|
-
updated_at TEXT NOT NULL,
|
|
38
|
-
FOREIGN KEY(project_id) REFERENCES projects(id) ON DELETE CASCADE
|
|
39
|
-
);
|
|
40
|
-
|
|
41
|
-
CREATE VIRTUAL TABLE IF NOT EXISTS search_idx USING fts5(
|
|
42
|
-
node_id UNINDEXED,
|
|
43
|
-
title,
|
|
44
|
-
content,
|
|
45
|
-
tokenize='porter'
|
|
46
|
-
);
|
|
21
|
+
const schema = `
|
|
22
|
+
CREATE TABLE IF NOT EXISTS projects (
|
|
23
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
24
|
+
name TEXT NOT NULL UNIQUE,
|
|
25
|
+
path TEXT NOT NULL,
|
|
26
|
+
created_at TEXT NOT NULL
|
|
27
|
+
);
|
|
28
|
+
|
|
29
|
+
CREATE TABLE IF NOT EXISTS memory_nodes (
|
|
30
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
31
|
+
project_id INTEGER, -- NULL se for global
|
|
32
|
+
path TEXT NOT NULL UNIQUE,
|
|
33
|
+
kind TEXT NOT NULL, -- 'global', 'project', 'domain', 'adr', 'summary'
|
|
34
|
+
title TEXT,
|
|
35
|
+
content TEXT NOT NULL,
|
|
36
|
+
content_hash TEXT NOT NULL,
|
|
37
|
+
updated_at TEXT NOT NULL,
|
|
38
|
+
FOREIGN KEY(project_id) REFERENCES projects(id) ON DELETE CASCADE
|
|
39
|
+
);
|
|
40
|
+
|
|
41
|
+
CREATE VIRTUAL TABLE IF NOT EXISTS search_idx USING fts5(
|
|
42
|
+
node_id UNINDEXED,
|
|
43
|
+
title,
|
|
44
|
+
content,
|
|
45
|
+
tokenize='porter'
|
|
46
|
+
);
|
|
47
47
|
`;
|
|
48
48
|
function log(msg, level = 'info') {
|
|
49
49
|
const prefix = { info: 'INFO', success: 'OK', warn: 'WARN', error: 'ERROR' }[level] || 'INFO';
|
|
@@ -82,25 +82,25 @@ const getProjectId = db.prepare('SELECT id FROM projects WHERE name = ?');
|
|
|
82
82
|
const deleteFts = db.prepare('DELETE FROM search_idx WHERE node_id = ?');
|
|
83
83
|
const insertFts = db.prepare('INSERT INTO search_idx (node_id, title, content) VALUES (?, ?, ?)');
|
|
84
84
|
const purgeFtsOrphans = db.prepare('DELETE FROM search_idx WHERE node_id NOT IN (SELECT id FROM memory_nodes)');
|
|
85
|
-
const upsertSpecSummary = db.prepare(`
|
|
86
|
-
INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
|
|
87
|
-
VALUES (?, ?, ?, ?, ?, ?)
|
|
88
|
-
ON CONFLICT(slug) DO UPDATE SET
|
|
89
|
-
status=excluded.status,
|
|
90
|
-
title=excluded.title,
|
|
91
|
-
summary=excluded.summary,
|
|
92
|
-
source_path=excluded.source_path,
|
|
93
|
-
updated_at=excluded.updated_at
|
|
85
|
+
const upsertSpecSummary = db.prepare(`
|
|
86
|
+
INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
|
|
87
|
+
VALUES (?, ?, ?, ?, ?, ?)
|
|
88
|
+
ON CONFLICT(slug) DO UPDATE SET
|
|
89
|
+
status=excluded.status,
|
|
90
|
+
title=excluded.title,
|
|
91
|
+
summary=excluded.summary,
|
|
92
|
+
source_path=excluded.source_path,
|
|
93
|
+
updated_at=excluded.updated_at
|
|
94
94
|
`);
|
|
95
|
-
const upsertAsset = db.prepare(`
|
|
96
|
-
INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
|
|
97
|
-
VALUES (?, ?, ?, ?, ?, ?)
|
|
98
|
-
ON CONFLICT(path) DO UPDATE SET
|
|
99
|
-
type=excluded.type,
|
|
100
|
-
name=excluded.name,
|
|
101
|
-
summary=excluded.summary,
|
|
102
|
-
tags=excluded.tags,
|
|
103
|
-
updated_at=excluded.updated_at
|
|
95
|
+
const upsertAsset = db.prepare(`
|
|
96
|
+
INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
|
|
97
|
+
VALUES (?, ?, ?, ?, ?, ?)
|
|
98
|
+
ON CONFLICT(path) DO UPDATE SET
|
|
99
|
+
type=excluded.type,
|
|
100
|
+
name=excluded.name,
|
|
101
|
+
summary=excluded.summary,
|
|
102
|
+
tags=excluded.tags,
|
|
103
|
+
updated_at=excluded.updated_at
|
|
104
104
|
`);
|
|
105
105
|
const now = new Date().toISOString();
|
|
106
106
|
function getKind(relPath) {
|
|
@@ -1,35 +1,35 @@
|
|
|
1
|
-
# CLI como adaptador do Capability Registry
|
|
2
|
-
|
|
3
|
-
Sprint 1 unifica os três comandos de prova abaixo com o registry executável. O comando legado
|
|
4
|
-
continua disponível como alias; a lógica é executada por um handler injetado no adaptador, e não
|
|
5
|
-
por uma implementação paralela no CLI.
|
|
6
|
-
|
|
7
|
-
| Comando legado | Capability | Input | Observação |
|
|
8
|
-
| --- | --- | --- | --- |
|
|
9
|
-
| `tools:doctor` | `system.doctor` | `{}` | diagnóstico local determinístico |
|
|
10
|
-
| `code:impact <symbol> [depth]` | `code.impact` | `{ symbol, depth? }` | depth entre 1 e 10 |
|
|
11
|
-
| `context:budget <target> [limitTokens]` | `context.budget` | `{ target, limitTokens? }` | limite positivo |
|
|
12
|
-
| `spec:check [feature]` | `spec.validate` | `{ feature? }` | valida uma spec ou todas |
|
|
13
|
-
| `sprint:status [project]` | `sprint.status` | `{ project? }` | consulta a sprint atual |
|
|
14
|
-
| `gsd:handoff <phase> <slug> [context]` | `handoff.create` | `{ phase, slug, context? }` | grava handoff local governado |
|
|
15
|
-
|
|
16
|
-
## Descoberta e execução
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
forja capabilities:list --json
|
|
20
|
-
forja capabilities:describe code.impact --json
|
|
21
|
-
forja capability:execute code.impact --input '{"symbol":"CapabilityRegistry","depth":2}' --json
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
Os três comandos legados também aceitam `--json` e retornam o mesmo `ExecutionResult` versionado:
|
|
25
|
-
|
|
26
|
-
```bash
|
|
27
|
-
forja tools:doctor --json
|
|
28
|
-
forja code:impact CapabilityRegistry 2 --json
|
|
29
|
-
forja context:budget docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md 10000 --json
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
O envelope inclui `runId`, `correlationId`, `status`, `output`, `evidence` e erro normalizado
|
|
33
|
-
quando aplicável. Entrada inválida é rejeitada antes do handler; política é avaliada pelo
|
|
34
|
-
`CapabilityRegistry` antes da execução. Comandos ainda não migrados permanecem no dispatch
|
|
35
|
-
legado durante a migração progressiva.
|
|
1
|
+
# CLI como adaptador do Capability Registry
|
|
2
|
+
|
|
3
|
+
Sprint 1 unifica os três comandos de prova abaixo com o registry executável. O comando legado
|
|
4
|
+
continua disponível como alias; a lógica é executada por um handler injetado no adaptador, e não
|
|
5
|
+
por uma implementação paralela no CLI.
|
|
6
|
+
|
|
7
|
+
| Comando legado | Capability | Input | Observação |
|
|
8
|
+
| --- | --- | --- | --- |
|
|
9
|
+
| `tools:doctor` | `system.doctor` | `{}` | diagnóstico local determinístico |
|
|
10
|
+
| `code:impact <symbol> [depth]` | `code.impact` | `{ symbol, depth? }` | depth entre 1 e 10 |
|
|
11
|
+
| `context:budget <target> [limitTokens]` | `context.budget` | `{ target, limitTokens? }` | limite positivo |
|
|
12
|
+
| `spec:check [feature]` | `spec.validate` | `{ feature? }` | valida uma spec ou todas |
|
|
13
|
+
| `sprint:status [project]` | `sprint.status` | `{ project? }` | consulta a sprint atual |
|
|
14
|
+
| `gsd:handoff <phase> <slug> [context]` | `handoff.create` | `{ phase, slug, context? }` | grava handoff local governado |
|
|
15
|
+
|
|
16
|
+
## Descoberta e execução
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
forja capabilities:list --json
|
|
20
|
+
forja capabilities:describe code.impact --json
|
|
21
|
+
forja capability:execute code.impact --input '{"symbol":"CapabilityRegistry","depth":2}' --json
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Os três comandos legados também aceitam `--json` e retornam o mesmo `ExecutionResult` versionado:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
forja tools:doctor --json
|
|
28
|
+
forja code:impact CapabilityRegistry 2 --json
|
|
29
|
+
forja context:budget docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md 10000 --json
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
O envelope inclui `runId`, `correlationId`, `status`, `output`, `evidence` e erro normalizado
|
|
33
|
+
quando aplicável. Entrada inválida é rejeitada antes do handler; política é avaliada pelo
|
|
34
|
+
`CapabilityRegistry` antes da execução. Comandos ainda não migrados permanecem no dispatch
|
|
35
|
+
legado durante a migração progressiva.
|
|
@@ -1,40 +1,40 @@
|
|
|
1
|
-
# ForjaJS 2.x — Implementation audit
|
|
2
|
-
|
|
3
|
-
Auditoria realizada em 2026-08-02 sobre o código executável e os testes do repositório. “Existe” só foi marcado quando há implementação; “produção” só quando a composição oficial ou o caminho CLI é exercitado.
|
|
4
|
-
|
|
5
|
-
| Componente | Existe | Integrado | Persistente | Testado | Produção |
|
|
6
|
-
| --- | ---: | ---: | ---: | ---: | ---: |
|
|
7
|
-
| Contratos versionados | sim | sim | n/a | sim | sim |
|
|
8
|
-
| Capability Registry | sim | sim | n/a | sim | sim |
|
|
9
|
-
| CLI adapter | sim | sim | n/a | sim | sim |
|
|
10
|
-
| Runtime | sim | sim | sim | sim | sim |
|
|
11
|
-
| Policy/approvals | sim | sim | sim | sim | sim |
|
|
12
|
-
| Sprint/Task/Handoff | sim | sim | sim | sim | sim |
|
|
13
|
-
| Context Engine | sim | sim | sim | sim | sim |
|
|
14
|
-
| GraphLoop | sim | sim | sim | sim | sim |
|
|
15
|
-
| Sandbox Git worktree | sim | sim | sessão | sim | sim |
|
|
16
|
-
| Sandbox rollback | sim | sim | sessão | sim | sim |
|
|
17
|
-
| Validator | sim | sim | n/a | sim | sim |
|
|
18
|
-
| Event Bus/Scheduler | sim | sim | sim | sim | sim |
|
|
19
|
-
| MCP stdio | sim | sim | n/a | sim | sim |
|
|
20
|
-
| SDK | sim | sim | n/a | sim | sim |
|
|
21
|
-
| Nest adapter/control plane | sim | sim | sim | sim | sim |
|
|
22
|
-
| Dashboard | sim | sim | via API | sim | parcial |
|
|
23
|
-
| Observability/Evals | sim | sim | sim | sim | sim |
|
|
24
|
-
| Plugin SDK | sim | sim | n/a | sim | sim |
|
|
25
|
-
| GitHub/Docker official boundaries | sim | não há handler externo | n/a | sim | boundary |
|
|
26
|
-
|
|
27
|
-
## Evidências executadas
|
|
28
|
-
|
|
29
|
-
- `npm run demo:autonomy`: fixture externa, worktree Git, alteração real, `npm test`, diff, promoção, SQLite, GraphLoop e handoff.
|
|
30
|
-
- `test/mcp-stdio.test.js`: transporte JSON-RPC por processo filho, stdout limpo, tools/resources e shutdown.
|
|
31
|
-
- `test/server-persistence.test.js`: composição oficial SQLite, encerramento/recriação e recuperação de runtime, approval, contexto, grafo, evento e observação.
|
|
32
|
-
- `test/sandbox.test.js` e `test/adapter-git.test.js`: promoção e rollback explícitos.
|
|
33
|
-
- `test/context-benchmark.test.js`: benchmark determinístico; execução observada nesta árvore: baseline 214.549 tokens estimados, contexto selecionado 9.175, redução 95,72%, cache hit 1 e cobertura de evidência 1.
|
|
34
|
-
- `npm test -- --test-concurrency=1`: 300/300 aprovados.
|
|
35
|
-
- `npm run build`: aprovado.
|
|
36
|
-
- `git diff --check`: aprovado.
|
|
37
|
-
|
|
38
|
-
## Limites honestos
|
|
39
|
-
|
|
40
|
-
Os plugins oficiais são boundaries permissionados, não clientes GitHub/Docker completos. O dashboard é superfície de supervisão e não foi usado como dependência do fluxo CLI-first. A estimativa de tokens é um proxy determinístico bytes/4, não telemetria de um provedor de modelo. Essas limitações impedem afirmar que todos os cenários externos são 10/10; o fluxo local-first comprovado está fechado.
|
|
1
|
+
# ForjaJS 2.x — Implementation audit
|
|
2
|
+
|
|
3
|
+
Auditoria realizada em 2026-08-02 sobre o código executável e os testes do repositório. “Existe” só foi marcado quando há implementação; “produção” só quando a composição oficial ou o caminho CLI é exercitado.
|
|
4
|
+
|
|
5
|
+
| Componente | Existe | Integrado | Persistente | Testado | Produção |
|
|
6
|
+
| --- | ---: | ---: | ---: | ---: | ---: |
|
|
7
|
+
| Contratos versionados | sim | sim | n/a | sim | sim |
|
|
8
|
+
| Capability Registry | sim | sim | n/a | sim | sim |
|
|
9
|
+
| CLI adapter | sim | sim | n/a | sim | sim |
|
|
10
|
+
| Runtime | sim | sim | sim | sim | sim |
|
|
11
|
+
| Policy/approvals | sim | sim | sim | sim | sim |
|
|
12
|
+
| Sprint/Task/Handoff | sim | sim | sim | sim | sim |
|
|
13
|
+
| Context Engine | sim | sim | sim | sim | sim |
|
|
14
|
+
| GraphLoop | sim | sim | sim | sim | sim |
|
|
15
|
+
| Sandbox Git worktree | sim | sim | sessão | sim | sim |
|
|
16
|
+
| Sandbox rollback | sim | sim | sessão | sim | sim |
|
|
17
|
+
| Validator | sim | sim | n/a | sim | sim |
|
|
18
|
+
| Event Bus/Scheduler | sim | sim | sim | sim | sim |
|
|
19
|
+
| MCP stdio | sim | sim | n/a | sim | sim |
|
|
20
|
+
| SDK | sim | sim | n/a | sim | sim |
|
|
21
|
+
| Nest adapter/control plane | sim | sim | sim | sim | sim |
|
|
22
|
+
| Dashboard | sim | sim | via API | sim | parcial |
|
|
23
|
+
| Observability/Evals | sim | sim | sim | sim | sim |
|
|
24
|
+
| Plugin SDK | sim | sim | n/a | sim | sim |
|
|
25
|
+
| GitHub/Docker official boundaries | sim | não há handler externo | n/a | sim | boundary |
|
|
26
|
+
|
|
27
|
+
## Evidências executadas
|
|
28
|
+
|
|
29
|
+
- `npm run demo:autonomy`: fixture externa, worktree Git, alteração real, `npm test`, diff, promoção, SQLite, GraphLoop e handoff.
|
|
30
|
+
- `test/mcp-stdio.test.js`: transporte JSON-RPC por processo filho, stdout limpo, tools/resources e shutdown.
|
|
31
|
+
- `test/server-persistence.test.js`: composição oficial SQLite, encerramento/recriação e recuperação de runtime, approval, contexto, grafo, evento e observação.
|
|
32
|
+
- `test/sandbox.test.js` e `test/adapter-git.test.js`: promoção e rollback explícitos.
|
|
33
|
+
- `test/context-benchmark.test.js`: benchmark determinístico; execução observada nesta árvore: baseline 214.549 tokens estimados, contexto selecionado 9.175, redução 95,72%, cache hit 1 e cobertura de evidência 1.
|
|
34
|
+
- `npm test -- --test-concurrency=1`: 300/300 aprovados.
|
|
35
|
+
- `npm run build`: aprovado.
|
|
36
|
+
- `git diff --check`: aprovado.
|
|
37
|
+
|
|
38
|
+
## Limites honestos
|
|
39
|
+
|
|
40
|
+
Os plugins oficiais são boundaries permissionados, não clientes GitHub/Docker completos. O dashboard é superfície de supervisão e não foi usado como dependência do fluxo CLI-first. A estimativa de tokens é um proxy determinístico bytes/4, não telemetria de um provedor de modelo. Essas limitações impedem afirmar que todos os cenários externos são 10/10; o fluxo local-first comprovado está fechado.
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# Sprint 1 — Unificar CLI e Capability Registry
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Fazer três comandos legados passarem pelo mesmo registry, validação, policy e
|
|
6
|
-
envelope `ExecutionResult`, preservando a saída humana existente.
|
|
7
|
-
|
|
8
|
-
## Escopo
|
|
9
|
-
|
|
10
|
-
Incluído:
|
|
11
|
-
|
|
12
|
-
- adapter CLI;
|
|
13
|
-
- mapa comando → capability para o catálogo inicial;
|
|
14
|
-
- schemas determinísticos de entrada;
|
|
15
|
-
- `system.doctor`, `code.impact`, `context.budget`;
|
|
16
|
-
- `capabilities:list`, `capabilities:describe` e
|
|
17
|
-
`capability:execute` em JSON;
|
|
18
|
-
- correlation ID e auditoria do resultado;
|
|
19
|
-
- testes de equivalência e rejeição de entrada.
|
|
20
|
-
|
|
21
|
-
Excluído:
|
|
22
|
-
|
|
23
|
-
- persistência do Runtime;
|
|
24
|
-
- MCP nativo;
|
|
25
|
-
- GraphLoop SQLite;
|
|
26
|
-
- sandbox/autonomia ponta a ponta;
|
|
27
|
-
- migração dos demais comandos.
|
|
28
|
-
|
|
29
|
-
## Impacto
|
|
30
|
-
|
|
31
|
-
Arquivos esperados: `apps/cli/`, `bin/forja.ts`, contratos/testes e
|
|
32
|
-
documentação. O domínio em `packages/core` permanece independente de processo,
|
|
33
|
-
CLI e framework.
|
|
34
|
-
|
|
35
|
-
## Critérios de aceite
|
|
36
|
-
|
|
37
|
-
1. Os três comandos são descobertos por capability ID e alias.
|
|
38
|
-
2. `forja capabilities:list --json` retorna definições versionadas.
|
|
39
|
-
3. `forja capabilities:describe code.impact --json` retorna o contrato.
|
|
40
|
-
4. Entradas inválidas são recusadas antes do handler.
|
|
41
|
-
5. `forja capability:execute code.impact --input '{...}' --json` retorna
|
|
42
|
-
`ExecutionResult` com `runId`, `correlationId`, status e evidência.
|
|
43
|
-
6. O modo textual dos três comandos preserva o comportamento legado.
|
|
44
|
-
7. Policy negada não chama o handler.
|
|
45
|
-
8. O gate de testes determinísticos passa sem alterar comandos fora do escopo.
|
|
46
|
-
|
|
47
|
-
## Status de execução — 2026-08-01
|
|
48
|
-
|
|
49
|
-
Concluído para os três comandos de prova. O adapter está em `apps/cli/src/index.ts`, o dispatch
|
|
50
|
-
integrado está em `bin/forja.ts` e os testes estão em `test/cli-capability-adapter.test.js`.
|
|
51
|
-
`tools:doctor`, `context:budget` e `code:impact` foram executados com `--json` em workspace
|
|
52
|
-
temporário; os envelopes observados continham `runId`, `correlationId`, status, payload e
|
|
53
|
-
evidência. Os demais comandos permanecem fora do escopo desta sprint.
|
|
1
|
+
# Sprint 1 — Unificar CLI e Capability Registry
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Fazer três comandos legados passarem pelo mesmo registry, validação, policy e
|
|
6
|
+
envelope `ExecutionResult`, preservando a saída humana existente.
|
|
7
|
+
|
|
8
|
+
## Escopo
|
|
9
|
+
|
|
10
|
+
Incluído:
|
|
11
|
+
|
|
12
|
+
- adapter CLI;
|
|
13
|
+
- mapa comando → capability para o catálogo inicial;
|
|
14
|
+
- schemas determinísticos de entrada;
|
|
15
|
+
- `system.doctor`, `code.impact`, `context.budget`;
|
|
16
|
+
- `capabilities:list`, `capabilities:describe` e
|
|
17
|
+
`capability:execute` em JSON;
|
|
18
|
+
- correlation ID e auditoria do resultado;
|
|
19
|
+
- testes de equivalência e rejeição de entrada.
|
|
20
|
+
|
|
21
|
+
Excluído:
|
|
22
|
+
|
|
23
|
+
- persistência do Runtime;
|
|
24
|
+
- MCP nativo;
|
|
25
|
+
- GraphLoop SQLite;
|
|
26
|
+
- sandbox/autonomia ponta a ponta;
|
|
27
|
+
- migração dos demais comandos.
|
|
28
|
+
|
|
29
|
+
## Impacto
|
|
30
|
+
|
|
31
|
+
Arquivos esperados: `apps/cli/`, `bin/forja.ts`, contratos/testes e
|
|
32
|
+
documentação. O domínio em `packages/core` permanece independente de processo,
|
|
33
|
+
CLI e framework.
|
|
34
|
+
|
|
35
|
+
## Critérios de aceite
|
|
36
|
+
|
|
37
|
+
1. Os três comandos são descobertos por capability ID e alias.
|
|
38
|
+
2. `forja capabilities:list --json` retorna definições versionadas.
|
|
39
|
+
3. `forja capabilities:describe code.impact --json` retorna o contrato.
|
|
40
|
+
4. Entradas inválidas são recusadas antes do handler.
|
|
41
|
+
5. `forja capability:execute code.impact --input '{...}' --json` retorna
|
|
42
|
+
`ExecutionResult` com `runId`, `correlationId`, status e evidência.
|
|
43
|
+
6. O modo textual dos três comandos preserva o comportamento legado.
|
|
44
|
+
7. Policy negada não chama o handler.
|
|
45
|
+
8. O gate de testes determinísticos passa sem alterar comandos fora do escopo.
|
|
46
|
+
|
|
47
|
+
## Status de execução — 2026-08-01
|
|
48
|
+
|
|
49
|
+
Concluído para os três comandos de prova. O adapter está em `apps/cli/src/index.ts`, o dispatch
|
|
50
|
+
integrado está em `bin/forja.ts` e os testes estão em `test/cli-capability-adapter.test.js`.
|
|
51
|
+
`tools:doctor`, `context:budget` e `code:impact` foram executados com `--json` em workspace
|
|
52
|
+
temporário; os envelopes observados continham `runId`, `correlationId`, status, payload e
|
|
53
|
+
evidência. Os demais comandos permanecem fora do escopo desta sprint.
|
|
@@ -1,54 +1,54 @@
|
|
|
1
|
-
# Sprint 10 — Indexação incremental de workspace/Git
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Transformar os extractors do GraphLoop em uma operação utilizável: listar
|
|
6
|
-
arquivos rastreáveis do workspace, gerar mutations determinísticas e expor o
|
|
7
|
-
processo como capability `graph.sync`.
|
|
8
|
-
|
|
9
|
-
## Fluxo
|
|
10
|
-
|
|
11
|
-
```text
|
|
12
|
-
GitWorkspaceSource
|
|
13
|
-
↓
|
|
14
|
-
GraphIndexer
|
|
15
|
-
↓
|
|
16
|
-
extractDeterministicRelations
|
|
17
|
-
↓
|
|
18
|
-
GraphLoop.apply (checksum)
|
|
19
|
-
↓
|
|
20
|
-
SqliteGraphStore
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
## Escopo
|
|
24
|
-
|
|
25
|
-
- `git ls-files --cached --others --exclude-standard -z` como fonte local;
|
|
26
|
-
- arquivos TypeScript/JavaScript/JSON/Markdown/YAML;
|
|
27
|
-
- exclusão de `.git`, `node_modules`, `dist`, `coverage`, binários e arquivos
|
|
28
|
-
maiores que 1 MB;
|
|
29
|
-
- indexação incremental por locator/checksum;
|
|
30
|
-
- capability `graph.sync` com `ExecutionResult` e evidência;
|
|
31
|
-
- composição da capability no server oficial.
|
|
32
|
-
|
|
33
|
-
## Critérios de aceite
|
|
34
|
-
|
|
35
|
-
1. Arquivos ignorados e não indexáveis não entram na fonte.
|
|
36
|
-
2. Uma sincronização repetida retorna `skipped` sem duplicar arestas.
|
|
37
|
-
3. Falha do Git é retornada como erro, não como sucesso vazio.
|
|
38
|
-
4. A capability valida input antes do handler e exige permissão de escrita.
|
|
39
|
-
5. O server registra `graph.sync` sobre o GraphLoop SQLite.
|
|
40
|
-
6. A operação continua offline e não usa LLM.
|
|
41
|
-
|
|
42
|
-
## Limites
|
|
43
|
-
|
|
44
|
-
- arquivos removidos não são podados automaticamente nesta sprint;
|
|
45
|
-
- commits e diffs não são entidades extraídas ainda;
|
|
46
|
-
- `git ls-files` exige um repositório válido para a fonte oficial.
|
|
47
|
-
|
|
48
|
-
## Evidências
|
|
49
|
-
|
|
50
|
-
- `packages/graph/src/index.ts`;
|
|
51
|
-
- `packages/adapter-git/src/index.ts`;
|
|
52
|
-
- `apps/cli/src/index.ts`;
|
|
53
|
-
- `apps/server/src/main.ts`;
|
|
54
|
-
- testes de GraphIndexer, adapter Git e capability.
|
|
1
|
+
# Sprint 10 — Indexação incremental de workspace/Git
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Transformar os extractors do GraphLoop em uma operação utilizável: listar
|
|
6
|
+
arquivos rastreáveis do workspace, gerar mutations determinísticas e expor o
|
|
7
|
+
processo como capability `graph.sync`.
|
|
8
|
+
|
|
9
|
+
## Fluxo
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
GitWorkspaceSource
|
|
13
|
+
↓
|
|
14
|
+
GraphIndexer
|
|
15
|
+
↓
|
|
16
|
+
extractDeterministicRelations
|
|
17
|
+
↓
|
|
18
|
+
GraphLoop.apply (checksum)
|
|
19
|
+
↓
|
|
20
|
+
SqliteGraphStore
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Escopo
|
|
24
|
+
|
|
25
|
+
- `git ls-files --cached --others --exclude-standard -z` como fonte local;
|
|
26
|
+
- arquivos TypeScript/JavaScript/JSON/Markdown/YAML;
|
|
27
|
+
- exclusão de `.git`, `node_modules`, `dist`, `coverage`, binários e arquivos
|
|
28
|
+
maiores que 1 MB;
|
|
29
|
+
- indexação incremental por locator/checksum;
|
|
30
|
+
- capability `graph.sync` com `ExecutionResult` e evidência;
|
|
31
|
+
- composição da capability no server oficial.
|
|
32
|
+
|
|
33
|
+
## Critérios de aceite
|
|
34
|
+
|
|
35
|
+
1. Arquivos ignorados e não indexáveis não entram na fonte.
|
|
36
|
+
2. Uma sincronização repetida retorna `skipped` sem duplicar arestas.
|
|
37
|
+
3. Falha do Git é retornada como erro, não como sucesso vazio.
|
|
38
|
+
4. A capability valida input antes do handler e exige permissão de escrita.
|
|
39
|
+
5. O server registra `graph.sync` sobre o GraphLoop SQLite.
|
|
40
|
+
6. A operação continua offline e não usa LLM.
|
|
41
|
+
|
|
42
|
+
## Limites
|
|
43
|
+
|
|
44
|
+
- arquivos removidos não são podados automaticamente nesta sprint;
|
|
45
|
+
- commits e diffs não são entidades extraídas ainda;
|
|
46
|
+
- `git ls-files` exige um repositório válido para a fonte oficial.
|
|
47
|
+
|
|
48
|
+
## Evidências
|
|
49
|
+
|
|
50
|
+
- `packages/graph/src/index.ts`;
|
|
51
|
+
- `packages/adapter-git/src/index.ts`;
|
|
52
|
+
- `apps/cli/src/index.ts`;
|
|
53
|
+
- `apps/server/src/main.ts`;
|
|
54
|
+
- testes de GraphIndexer, adapter Git e capability.
|
|
@@ -1,38 +1,38 @@
|
|
|
1
|
-
# Sprint 11 — Graph sync na CLI, MCP e observabilidade
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Tornar `graph.sync` uma capability operável pela CLI standalone e pelo MCP
|
|
6
|
-
stdio, mantendo um único handler e registrando contagens, arquivos e duração.
|
|
7
|
-
|
|
8
|
-
## Escopo
|
|
9
|
-
|
|
10
|
-
- alias declarativo `graph:sync` no registry do core;
|
|
11
|
-
- `capabilities:list`, `capabilities:describe` e `capability:execute` com
|
|
12
|
-
`graph.sync`;
|
|
13
|
-
- `mcp:start` descobrindo a ferramenta dinâmica pelo registry;
|
|
14
|
-
- composição local GraphLoop + SQLite + Git reutilizada pelos adaptadores;
|
|
15
|
-
- saída humana resumida e saída JSON estruturada;
|
|
16
|
-
- métricas `documents`, `indexed`, `skipped`, `nodes`, `edges`, `files` e
|
|
17
|
-
`durationMs` no resultado e no registro de auditoria CLI.
|
|
18
|
-
|
|
19
|
-
## Critérios de aceite
|
|
20
|
-
|
|
21
|
-
1. `graph.sync` aparece em `forja capabilities:list --json`.
|
|
22
|
-
2. `forja graph:sync --json` indexa o repositório atual sem LLM.
|
|
23
|
-
3. Reexecução usa checksum e informa documentos ignorados.
|
|
24
|
-
4. MCP stdio deriva a ferramenta a partir do registry, sem lista duplicada.
|
|
25
|
-
5. Policy exige permissão `write` para a capability.
|
|
26
|
-
6. Falhas do Git retornam `ExecutionResult` falho.
|
|
27
|
-
7. Testes, typecheck, build e release gate passam.
|
|
28
|
-
|
|
29
|
-
## Evidência operacional
|
|
30
|
-
|
|
31
|
-
No workspace temporário da Sprint 11, a CLI descobriu `graph.sync` e a execução
|
|
32
|
-
indexou 867 documentos em 8,9s, retornando contagens estruturadas.
|
|
33
|
-
|
|
34
|
-
## Limites
|
|
35
|
-
|
|
36
|
-
- CLI não faz poda de arquivos removidos;
|
|
37
|
-
- observabilidade detalhada fica no envelope/auditoria CLI; persistência de
|
|
38
|
-
observações do Control Plane para essa ação será consolidada em sprint futura.
|
|
1
|
+
# Sprint 11 — Graph sync na CLI, MCP e observabilidade
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Tornar `graph.sync` uma capability operável pela CLI standalone e pelo MCP
|
|
6
|
+
stdio, mantendo um único handler e registrando contagens, arquivos e duração.
|
|
7
|
+
|
|
8
|
+
## Escopo
|
|
9
|
+
|
|
10
|
+
- alias declarativo `graph:sync` no registry do core;
|
|
11
|
+
- `capabilities:list`, `capabilities:describe` e `capability:execute` com
|
|
12
|
+
`graph.sync`;
|
|
13
|
+
- `mcp:start` descobrindo a ferramenta dinâmica pelo registry;
|
|
14
|
+
- composição local GraphLoop + SQLite + Git reutilizada pelos adaptadores;
|
|
15
|
+
- saída humana resumida e saída JSON estruturada;
|
|
16
|
+
- métricas `documents`, `indexed`, `skipped`, `nodes`, `edges`, `files` e
|
|
17
|
+
`durationMs` no resultado e no registro de auditoria CLI.
|
|
18
|
+
|
|
19
|
+
## Critérios de aceite
|
|
20
|
+
|
|
21
|
+
1. `graph.sync` aparece em `forja capabilities:list --json`.
|
|
22
|
+
2. `forja graph:sync --json` indexa o repositório atual sem LLM.
|
|
23
|
+
3. Reexecução usa checksum e informa documentos ignorados.
|
|
24
|
+
4. MCP stdio deriva a ferramenta a partir do registry, sem lista duplicada.
|
|
25
|
+
5. Policy exige permissão `write` para a capability.
|
|
26
|
+
6. Falhas do Git retornam `ExecutionResult` falho.
|
|
27
|
+
7. Testes, typecheck, build e release gate passam.
|
|
28
|
+
|
|
29
|
+
## Evidência operacional
|
|
30
|
+
|
|
31
|
+
No workspace temporário da Sprint 11, a CLI descobriu `graph.sync` e a execução
|
|
32
|
+
indexou 867 documentos em 8,9s, retornando contagens estruturadas.
|
|
33
|
+
|
|
34
|
+
## Limites
|
|
35
|
+
|
|
36
|
+
- CLI não faz poda de arquivos removidos;
|
|
37
|
+
- observabilidade detalhada fica no envelope/auditoria CLI; persistência de
|
|
38
|
+
observações do Control Plane para essa ação será consolidada em sprint futura.
|
|
@@ -1,40 +1,40 @@
|
|
|
1
|
-
# Sprint 12 — Prova de autonomia supervisionada real
|
|
2
|
-
|
|
3
|
-
## Objetivo
|
|
4
|
-
|
|
5
|
-
Substituir a prova E2E simulada por uma demonstração repetível que usa fixture externa,
|
|
6
|
-
Git worktree, arquivo real, teste real, aprovação persistida, promoção real e estado
|
|
7
|
-
auditável em SQLite.
|
|
8
|
-
|
|
9
|
-
## Escopo
|
|
10
|
-
|
|
11
|
-
- `npm run demo:autonomy`;
|
|
12
|
-
- agente simulado determinístico, sem provedor LLM;
|
|
13
|
-
- Context Engine e GraphLoop antes do plano;
|
|
14
|
-
- Policy Engine e `ApprovalLedger` antes da escrita;
|
|
15
|
-
- `GitWorktreeBackend` no caminho principal;
|
|
16
|
-
- Validator independente antes da promoção;
|
|
17
|
-
- Sprint, Task, Handoff, Event Bus e auditoria persistidos.
|
|
18
|
-
|
|
19
|
-
## Critérios de aceite
|
|
20
|
-
|
|
21
|
-
- fixture é criada fora do repositório do framework;
|
|
22
|
-
- teste inicia falhando e termina passando após edição na worktree;
|
|
23
|
-
- workspace principal da fixture só muda na promoção explícita;
|
|
24
|
-
- aprovação, run, checkpoint, sandbox, evento e handoff sobrevivem no SQLite;
|
|
25
|
-
- GraphLoop recebe evidências e relações da execução;
|
|
26
|
-
- Validator retorna `accepted` antes de `promote`;
|
|
27
|
-
- teste automatizado repete o fluxo e limpa seus artefatos temporários.
|
|
28
|
-
|
|
29
|
-
## Fora do escopo
|
|
30
|
-
|
|
31
|
-
MCP stdio real, composição de servidor após restart abrupto, rollback automatizado,
|
|
32
|
-
contradições avançadas, plugins oficiais e benchmark comparativo de tokens. São as
|
|
33
|
-
próximas sprints de fechamento 10/10.
|
|
34
|
-
|
|
35
|
-
## Evidências
|
|
36
|
-
|
|
37
|
-
- `scripts/demo-autonomy.ts`;
|
|
38
|
-
- `test/demo-autonomy.test.js`;
|
|
39
|
-
- `npm run demo:autonomy`;
|
|
40
|
-
- saída observada: validação `accepted`, uma alteração promovida, 18 nós e 14 arestas.
|
|
1
|
+
# Sprint 12 — Prova de autonomia supervisionada real
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Substituir a prova E2E simulada por uma demonstração repetível que usa fixture externa,
|
|
6
|
+
Git worktree, arquivo real, teste real, aprovação persistida, promoção real e estado
|
|
7
|
+
auditável em SQLite.
|
|
8
|
+
|
|
9
|
+
## Escopo
|
|
10
|
+
|
|
11
|
+
- `npm run demo:autonomy`;
|
|
12
|
+
- agente simulado determinístico, sem provedor LLM;
|
|
13
|
+
- Context Engine e GraphLoop antes do plano;
|
|
14
|
+
- Policy Engine e `ApprovalLedger` antes da escrita;
|
|
15
|
+
- `GitWorktreeBackend` no caminho principal;
|
|
16
|
+
- Validator independente antes da promoção;
|
|
17
|
+
- Sprint, Task, Handoff, Event Bus e auditoria persistidos.
|
|
18
|
+
|
|
19
|
+
## Critérios de aceite
|
|
20
|
+
|
|
21
|
+
- fixture é criada fora do repositório do framework;
|
|
22
|
+
- teste inicia falhando e termina passando após edição na worktree;
|
|
23
|
+
- workspace principal da fixture só muda na promoção explícita;
|
|
24
|
+
- aprovação, run, checkpoint, sandbox, evento e handoff sobrevivem no SQLite;
|
|
25
|
+
- GraphLoop recebe evidências e relações da execução;
|
|
26
|
+
- Validator retorna `accepted` antes de `promote`;
|
|
27
|
+
- teste automatizado repete o fluxo e limpa seus artefatos temporários.
|
|
28
|
+
|
|
29
|
+
## Fora do escopo
|
|
30
|
+
|
|
31
|
+
MCP stdio real, composição de servidor após restart abrupto, rollback automatizado,
|
|
32
|
+
contradições avançadas, plugins oficiais e benchmark comparativo de tokens. São as
|
|
33
|
+
próximas sprints de fechamento 10/10.
|
|
34
|
+
|
|
35
|
+
## Evidências
|
|
36
|
+
|
|
37
|
+
- `scripts/demo-autonomy.ts`;
|
|
38
|
+
- `test/demo-autonomy.test.js`;
|
|
39
|
+
- `npm run demo:autonomy`;
|
|
40
|
+
- saída observada: validação `accepted`, uma alteração promovida, 18 nós e 14 arestas.
|