forjajs 2.0.3 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -339
- package/README.pt-BR.md +345 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +14 -2
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +54 -0
- package/dist/lib/core/registry.js +55 -0
- package/dist/lib/core/release.d.ts +53 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.js +2 -2
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -150
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
- package/dist/scripts/server-persistence-probe.d.ts +0 -1
- package/dist/scripts/server-persistence-probe.js +0 -52
- package/dist/scripts/server-persistence-probe.mjs +0 -52
- /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
|
@@ -4,11 +4,13 @@ import crypto from 'node:crypto';
|
|
|
4
4
|
import Database from 'better-sqlite3';
|
|
5
5
|
import { fileURLToPath } from 'node:url';
|
|
6
6
|
import { ensureSchema, getDbPath } from "./memory-schema.js";
|
|
7
|
-
import { initWorkspace, getProjectsDir, getWorkspaceSpecsDir, getWorkspaceProjectsMemoryDir, } from "../lib/workspace.js";
|
|
7
|
+
import { initWorkspace, getForjaMode, getWorkspaceRoot, getProjectsDir, getWorkspaceSpecsDir, getWorkspaceProjectsMemoryDir, } from "../lib/workspace.js";
|
|
8
8
|
const __filename = fileURLToPath(import.meta.url);
|
|
9
9
|
const __dirname = path.dirname(__filename);
|
|
10
10
|
const root = path.resolve(__dirname, '..');
|
|
11
11
|
initWorkspace();
|
|
12
|
+
const mode = getForjaMode();
|
|
13
|
+
const operationRoot = getWorkspaceRoot();
|
|
12
14
|
const dbPath = getDbPath();
|
|
13
15
|
const args = process.argv.slice(2);
|
|
14
16
|
const projectArgIndex = args.indexOf('--project');
|
|
@@ -16,32 +18,32 @@ const onlyProject = projectArgIndex >= 0 ? args[projectArgIndex + 1] : null;
|
|
|
16
18
|
const syncGlobal = !onlyProject || args.includes('--global');
|
|
17
19
|
const syncProjects = !args.includes('--global') || Boolean(onlyProject);
|
|
18
20
|
// Schema simplificado para a Memória Universal
|
|
19
|
-
const schema = `
|
|
20
|
-
CREATE TABLE IF NOT EXISTS projects (
|
|
21
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
22
|
-
name TEXT NOT NULL UNIQUE,
|
|
23
|
-
path TEXT NOT NULL,
|
|
24
|
-
created_at TEXT NOT NULL
|
|
25
|
-
);
|
|
26
|
-
|
|
27
|
-
CREATE TABLE IF NOT EXISTS memory_nodes (
|
|
28
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
29
|
-
project_id INTEGER, -- NULL se for global
|
|
30
|
-
path TEXT NOT NULL UNIQUE,
|
|
31
|
-
kind TEXT NOT NULL, -- 'global', 'project', 'domain', 'adr', 'summary'
|
|
32
|
-
title TEXT,
|
|
33
|
-
content TEXT NOT NULL,
|
|
34
|
-
content_hash TEXT NOT NULL,
|
|
35
|
-
updated_at TEXT NOT NULL,
|
|
36
|
-
FOREIGN KEY(project_id) REFERENCES projects(id) ON DELETE CASCADE
|
|
37
|
-
);
|
|
38
|
-
|
|
39
|
-
CREATE VIRTUAL TABLE IF NOT EXISTS search_idx USING fts5(
|
|
40
|
-
node_id UNINDEXED,
|
|
41
|
-
title,
|
|
42
|
-
content,
|
|
43
|
-
tokenize='porter'
|
|
44
|
-
);
|
|
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
|
+
);
|
|
45
47
|
`;
|
|
46
48
|
function log(msg, level = 'info') {
|
|
47
49
|
const prefix = { info: 'INFO', success: 'OK', warn: 'WARN', error: 'ERROR' }[level] || 'INFO';
|
|
@@ -80,25 +82,25 @@ const getProjectId = db.prepare('SELECT id FROM projects WHERE name = ?');
|
|
|
80
82
|
const deleteFts = db.prepare('DELETE FROM search_idx WHERE node_id = ?');
|
|
81
83
|
const insertFts = db.prepare('INSERT INTO search_idx (node_id, title, content) VALUES (?, ?, ?)');
|
|
82
84
|
const purgeFtsOrphans = db.prepare('DELETE FROM search_idx WHERE node_id NOT IN (SELECT id FROM memory_nodes)');
|
|
83
|
-
const upsertSpecSummary = db.prepare(`
|
|
84
|
-
INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
|
|
85
|
-
VALUES (?, ?, ?, ?, ?, ?)
|
|
86
|
-
ON CONFLICT(slug) DO UPDATE SET
|
|
87
|
-
status=excluded.status,
|
|
88
|
-
title=excluded.title,
|
|
89
|
-
summary=excluded.summary,
|
|
90
|
-
source_path=excluded.source_path,
|
|
91
|
-
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
|
|
92
94
|
`);
|
|
93
|
-
const upsertAsset = db.prepare(`
|
|
94
|
-
INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
|
|
95
|
-
VALUES (?, ?, ?, ?, ?, ?)
|
|
96
|
-
ON CONFLICT(path) DO UPDATE SET
|
|
97
|
-
type=excluded.type,
|
|
98
|
-
name=excluded.name,
|
|
99
|
-
summary=excluded.summary,
|
|
100
|
-
tags=excluded.tags,
|
|
101
|
-
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
|
|
102
104
|
`);
|
|
103
105
|
const now = new Date().toISOString();
|
|
104
106
|
function getKind(relPath) {
|
|
@@ -233,9 +235,9 @@ function syncFiles(files, projectId = null) {
|
|
|
233
235
|
if (syncGlobal) {
|
|
234
236
|
log('Sincronizando Memória Global...', 'info');
|
|
235
237
|
const globalFiles = [
|
|
236
|
-
...walk(path.join(root, 'memory')),
|
|
237
|
-
...walk(path.join(root, 'docs')),
|
|
238
|
-
...walk(path.join(root, 'prompts')),
|
|
238
|
+
...walk(path.join(mode === 'embedded' ? operationRoot : root, 'memory')),
|
|
239
|
+
...walk(path.join(mode === 'embedded' ? operationRoot : root, 'docs')),
|
|
240
|
+
...walk(path.join(mode === 'embedded' ? operationRoot : root, 'prompts')),
|
|
239
241
|
];
|
|
240
242
|
syncFiles(globalFiles);
|
|
241
243
|
syncSpecSummaries();
|
|
@@ -243,7 +245,18 @@ if (syncGlobal) {
|
|
|
243
245
|
}
|
|
244
246
|
// 2. Sincronizar Projetos do Workspace
|
|
245
247
|
const projectsDir = getProjectsDir();
|
|
246
|
-
if (syncProjects &&
|
|
248
|
+
if (syncProjects && mode === 'embedded') {
|
|
249
|
+
const projectName = path.basename(operationRoot);
|
|
250
|
+
upsertProject.run(projectName, operationRoot, now);
|
|
251
|
+
const pid = getProjectId.get(projectName).id;
|
|
252
|
+
syncFiles([
|
|
253
|
+
...walk(path.join(operationRoot, 'memory')),
|
|
254
|
+
...walk(path.join(operationRoot, 'docs')),
|
|
255
|
+
...walk(path.join(operationRoot, 'specs')),
|
|
256
|
+
...walk(path.join(operationRoot, 'design-md')),
|
|
257
|
+
], pid);
|
|
258
|
+
}
|
|
259
|
+
else if (syncProjects && fs.existsSync(projectsDir)) {
|
|
247
260
|
const projects = fs.readdirSync(projectsDir, { withFileTypes: true })
|
|
248
261
|
.filter(e => e.isDirectory())
|
|
249
262
|
.filter(e => !onlyProject || e.name === onlyProject);
|
|
@@ -265,7 +278,7 @@ if (syncProjects && fs.existsSync(projectsDir)) {
|
|
|
265
278
|
}
|
|
266
279
|
// 3. Sincronizar fichas de projetos no workspace memory/30-projects
|
|
267
280
|
const workspaceProjectsMemoryDir = getWorkspaceProjectsMemoryDir();
|
|
268
|
-
if (fs.existsSync(workspaceProjectsMemoryDir)) {
|
|
281
|
+
if (mode === 'studio' && fs.existsSync(workspaceProjectsMemoryDir)) {
|
|
269
282
|
const fichaFiles = walk(workspaceProjectsMemoryDir);
|
|
270
283
|
syncFiles(fichaFiles);
|
|
271
284
|
}
|
|
@@ -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.
|