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
package/specs/README.md
CHANGED
|
@@ -1,70 +1,70 @@
|
|
|
1
|
-
# Specs — Pipeline SDD
|
|
2
|
-
|
|
3
|
-
Toda feature não-trivial passa por **spec → plan → tasks** antes de virar código.
|
|
4
|
-
|
|
5
|
-
## Fluxo
|
|
6
|
-
|
|
7
|
-
```
|
|
8
|
-
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
9
|
-
│ spec │ → │ plan │ → │ tasks │ → │ código │
|
|
10
|
-
│ (porquê) │ │ (como) │ │ (passos) │ │ (impl.) │
|
|
11
|
-
└──────────┘ └──────────┘ └──────────┘ └──────────┘
|
|
12
|
-
Product SDD Architect SDD Architect Worker
|
|
13
|
-
+ Governance
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Comandos
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
npm run spec:new <feature> # cria specs/<feature>/spec.md
|
|
20
|
-
npm run spec:plan <feature> # cria plan.md (após spec aprovada)
|
|
21
|
-
npm run spec:tasks <feature> # cria tasks.md (após plan aprovado)
|
|
22
|
-
npm run spec:check <feature> # valida que as 3 fases existem e foram preenchidas
|
|
23
|
-
npm run spec:check # valida todas
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Estrutura de uma feature
|
|
27
|
-
|
|
28
|
-
```
|
|
29
|
-
specs/
|
|
30
|
-
<feature-slug>/
|
|
31
|
-
spec.md # problema, AC, NFRs, escopo
|
|
32
|
-
plan.md # arquitetura, contratos, decisões
|
|
33
|
-
tasks.md # decomposição executável
|
|
34
|
-
notes/ # opcional: research, mockups
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## Critérios de "spec aprovada"
|
|
38
|
-
|
|
39
|
-
- Problema descrito em 1 frase
|
|
40
|
-
- Pelo menos 1 user story com persona, ação, benefício
|
|
41
|
-
- ≥3 critérios de aceite observáveis
|
|
42
|
-
- Escopo fora explicitado
|
|
43
|
-
- NFRs com números (não "rápido", mas "p95 < 200ms")
|
|
44
|
-
|
|
45
|
-
## Quando NÃO precisa de spec
|
|
46
|
-
|
|
47
|
-
- Bugfix de 1 linha
|
|
48
|
-
- Renomeação/rearranjo sem mudança de contrato
|
|
49
|
-
- Atualização de documentação
|
|
50
|
-
- Bump de dependência sem breaking change
|
|
51
|
-
|
|
52
|
-
Em dúvida: escreva spec. Custa 10min, salva retrabalho.
|
|
53
|
-
|
|
54
|
-
## Relação com ADRs
|
|
55
|
-
|
|
56
|
-
- **Spec** = "vamos fazer X"
|
|
57
|
-
- **ADR** = "decidimos fazer X **deste jeito** por **estas razões**"
|
|
58
|
-
|
|
59
|
-
Plan da spec pode gerar 0..N ADRs novas. Toda decisão estrutural irreversível mencionada no plan vira ADR em `memory/90-decisions/`.
|
|
60
|
-
|
|
61
|
-
## Estados
|
|
62
|
-
|
|
63
|
-
| Estado | Significado |
|
|
64
|
-
|---|---|
|
|
65
|
-
| `draft` | Em escrita, não revise ainda |
|
|
66
|
-
| `review` | Pronto para feedback |
|
|
67
|
-
| `approved` | OK para próxima fase (plan ou tasks) |
|
|
68
|
-
| `implementing` | Código sendo escrito |
|
|
69
|
-
| `done` | Mergeado e validado |
|
|
70
|
-
| `abandoned` | Não vai acontecer (mantemos por histórico) |
|
|
1
|
+
# Specs — Pipeline SDD
|
|
2
|
+
|
|
3
|
+
Toda feature não-trivial passa por **spec → plan → tasks** antes de virar código.
|
|
4
|
+
|
|
5
|
+
## Fluxo
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
9
|
+
│ spec │ → │ plan │ → │ tasks │ → │ código │
|
|
10
|
+
│ (porquê) │ │ (como) │ │ (passos) │ │ (impl.) │
|
|
11
|
+
└──────────┘ └──────────┘ └──────────┘ └──────────┘
|
|
12
|
+
Product SDD Architect SDD Architect Worker
|
|
13
|
+
+ Governance
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Comandos
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npm run spec:new <feature> # cria specs/<feature>/spec.md
|
|
20
|
+
npm run spec:plan <feature> # cria plan.md (após spec aprovada)
|
|
21
|
+
npm run spec:tasks <feature> # cria tasks.md (após plan aprovado)
|
|
22
|
+
npm run spec:check <feature> # valida que as 3 fases existem e foram preenchidas
|
|
23
|
+
npm run spec:check # valida todas
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Estrutura de uma feature
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
specs/
|
|
30
|
+
<feature-slug>/
|
|
31
|
+
spec.md # problema, AC, NFRs, escopo
|
|
32
|
+
plan.md # arquitetura, contratos, decisões
|
|
33
|
+
tasks.md # decomposição executável
|
|
34
|
+
notes/ # opcional: research, mockups
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Critérios de "spec aprovada"
|
|
38
|
+
|
|
39
|
+
- Problema descrito em 1 frase
|
|
40
|
+
- Pelo menos 1 user story com persona, ação, benefício
|
|
41
|
+
- ≥3 critérios de aceite observáveis
|
|
42
|
+
- Escopo fora explicitado
|
|
43
|
+
- NFRs com números (não "rápido", mas "p95 < 200ms")
|
|
44
|
+
|
|
45
|
+
## Quando NÃO precisa de spec
|
|
46
|
+
|
|
47
|
+
- Bugfix de 1 linha
|
|
48
|
+
- Renomeação/rearranjo sem mudança de contrato
|
|
49
|
+
- Atualização de documentação
|
|
50
|
+
- Bump de dependência sem breaking change
|
|
51
|
+
|
|
52
|
+
Em dúvida: escreva spec. Custa 10min, salva retrabalho.
|
|
53
|
+
|
|
54
|
+
## Relação com ADRs
|
|
55
|
+
|
|
56
|
+
- **Spec** = "vamos fazer X"
|
|
57
|
+
- **ADR** = "decidimos fazer X **deste jeito** por **estas razões**"
|
|
58
|
+
|
|
59
|
+
Plan da spec pode gerar 0..N ADRs novas. Toda decisão estrutural irreversível mencionada no plan vira ADR em `memory/90-decisions/`.
|
|
60
|
+
|
|
61
|
+
## Estados
|
|
62
|
+
|
|
63
|
+
| Estado | Significado |
|
|
64
|
+
|---|---|
|
|
65
|
+
| `draft` | Em escrita, não revise ainda |
|
|
66
|
+
| `review` | Pronto para feedback |
|
|
67
|
+
| `approved` | OK para próxima fase (plan ou tasks) |
|
|
68
|
+
| `implementing` | Código sendo escrito |
|
|
69
|
+
| `done` | Mergeado e validado |
|
|
70
|
+
| `abandoned` | Não vai acontecer (mantemos por histórico) |
|
package/specs/_templates/plan.md
CHANGED
|
@@ -1,43 +1,50 @@
|
|
|
1
|
-
# Plan: {{FEATURE}}
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Status**: draft | review | approved
|
|
5
|
-
- **Criado em**: {{DATE}}
|
|
6
|
-
|
|
7
|
-
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
-
|
|
9
|
-
## 1. Abordagem técnica
|
|
10
|
-
<Visão geral em 3-5 linhas. Qual estratégia (extend vs. rewrite, lib vs. service, sync vs. async).>
|
|
11
|
-
|
|
12
|
-
## 2. Módulos afetados
|
|
13
|
-
| Caminho | Mudança | Risco |
|
|
14
|
-
|---|---|---|
|
|
15
|
-
| `lib/...` | criar / editar / remover | B/M/A |
|
|
16
|
-
| `scripts/...` | ... | ... |
|
|
17
|
-
|
|
18
|
-
## 3. Diagrama de fluxo
|
|
19
|
-
```
|
|
20
|
-
<ASCII ou descrição textual do fluxo de dados/controle>
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
## 4. Contratos (API/CLI/Schema)
|
|
24
|
-
<Assinatura de funções públicas, endpoints, formato de arquivos novos.>
|
|
25
|
-
|
|
26
|
-
## 5. Decisões e alternativas
|
|
27
|
-
**D1**: <decisão> — alternativas rejeitadas: <A> (por X), <B> (por Y)
|
|
28
|
-
**D2**: ...
|
|
29
|
-
|
|
30
|
-
Se alguma D é estrutural ou irreversível, abra ADR em `memory/90-decisions/` e referencie aqui.
|
|
31
|
-
|
|
32
|
-
## 6. Dependências
|
|
33
|
-
- Outras specs: ...
|
|
34
|
-
- Pacotes npm: ...
|
|
35
|
-
- Migrações de dado/memory: ...
|
|
36
|
-
|
|
37
|
-
## 7. Rollout
|
|
38
|
-
- [ ] Feature flag necessária?
|
|
39
|
-
- [ ] Migração de dados existentes?
|
|
40
|
-
- [ ] Doc/persona impactada?
|
|
41
|
-
|
|
42
|
-
## 8. Sinais de fracasso (kill criteria)
|
|
43
|
-
<O que faria abandonar essa abordagem mid-flight?>
|
|
1
|
+
# Plan: {{FEATURE}}
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: draft | review | approved
|
|
5
|
+
- **Criado em**: {{DATE}}
|
|
6
|
+
|
|
7
|
+
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
+
|
|
9
|
+
## 1. Abordagem técnica
|
|
10
|
+
<Visão geral em 3-5 linhas. Qual estratégia (extend vs. rewrite, lib vs. service, sync vs. async).>
|
|
11
|
+
|
|
12
|
+
## 2. Módulos afetados
|
|
13
|
+
| Caminho | Mudança | Risco |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| `lib/...` | criar / editar / remover | B/M/A |
|
|
16
|
+
| `scripts/...` | ... | ... |
|
|
17
|
+
|
|
18
|
+
## 3. Diagrama de fluxo
|
|
19
|
+
```
|
|
20
|
+
<ASCII ou descrição textual do fluxo de dados/controle>
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## 4. Contratos (API/CLI/Schema)
|
|
24
|
+
<Assinatura de funções públicas, endpoints, formato de arquivos novos.>
|
|
25
|
+
|
|
26
|
+
## 5. Decisões e alternativas
|
|
27
|
+
**D1**: <decisão> — alternativas rejeitadas: <A> (por X), <B> (por Y)
|
|
28
|
+
**D2**: ...
|
|
29
|
+
|
|
30
|
+
Se alguma D é estrutural ou irreversível, abra ADR em `memory/90-decisions/` e referencie aqui.
|
|
31
|
+
|
|
32
|
+
## 6. Dependências
|
|
33
|
+
- Outras specs: ...
|
|
34
|
+
- Pacotes npm: ...
|
|
35
|
+
- Migrações de dado/memory: ...
|
|
36
|
+
|
|
37
|
+
## 7. Rollout
|
|
38
|
+
- [ ] Feature flag necessária?
|
|
39
|
+
- [ ] Migração de dados existentes?
|
|
40
|
+
- [ ] Doc/persona impactada?
|
|
41
|
+
|
|
42
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
43
|
+
<O que faria abandonar essa abordagem mid-flight?>
|
|
44
|
+
|
|
45
|
+
## Evidências e estado real
|
|
46
|
+
- Relacione cada critério AC à task responsável e ao comando ou observação que o verifica.
|
|
47
|
+
- Registre resultado, data e limitações; marque concluído somente após verificar.
|
|
48
|
+
- Diferencie hipótese, estimativa e medição. Remova exemplos que não se aplicam.
|
|
49
|
+
- Documente falhas esperadas, compatibilidade e recuperação quando houver mudança de contrato.
|
|
50
|
+
- Para LLMs, separe sucesso de execução, formato válido e aceite por checks independentes.
|
package/specs/_templates/spec.md
CHANGED
|
@@ -1,43 +1,50 @@
|
|
|
1
|
-
# Spec: {{FEATURE}}
|
|
2
|
-
|
|
3
|
-
- **ID**: {{ID}}
|
|
4
|
-
- **Status**: draft | review | approved | implementing | done | abandoned
|
|
5
|
-
- **Owner**: {{OWNER}}
|
|
6
|
-
- **Criado em**: {{DATE}}
|
|
7
|
-
- **Sprint alvo**: <S?>
|
|
8
|
-
- **ADRs relacionadas**: <links para memory/90-decisions/>
|
|
9
|
-
|
|
10
|
-
## 1. Problema
|
|
11
|
-
<O que está doendo? Quem sente a dor? Como medimos hoje?>
|
|
12
|
-
|
|
13
|
-
## 2. Proposta de valor
|
|
14
|
-
<O que muda quando isto existir? Frase única, mensurável.>
|
|
15
|
-
|
|
16
|
-
## 3. User stories
|
|
17
|
-
- **Como** <persona>, **quero** <ação>, **para que** <benefício>
|
|
18
|
-
- ...
|
|
19
|
-
|
|
20
|
-
## 4. Critérios de aceite (Definition of Done)
|
|
21
|
-
- [ ] AC-1: <observável, testável>
|
|
22
|
-
- [ ] AC-2: ...
|
|
23
|
-
|
|
24
|
-
## 5. Escopo
|
|
25
|
-
**Dentro**:
|
|
26
|
-
- ...
|
|
27
|
-
|
|
28
|
-
**Fora** (explícito, evita scope creep):
|
|
29
|
-
- ...
|
|
30
|
-
|
|
31
|
-
## 6. NFRs / restrições
|
|
32
|
-
- Performance: <ex: p95 < 200ms>
|
|
33
|
-
- Segurança: <ex: validação class-validator obrigatória — ADR-0004>
|
|
34
|
-
- Observabilidade: <ex: log estruturado por endpoint>
|
|
35
|
-
- Compatibilidade: <ex: não quebra `init-project.js`>
|
|
36
|
-
|
|
37
|
-
## 7. Riscos e mitigação
|
|
38
|
-
| Risco | Probabilidade | Impacto | Mitigação |
|
|
39
|
-
|---|---|---|---|
|
|
40
|
-
| ... | M | A | ... |
|
|
41
|
-
|
|
42
|
-
## 8. Métricas de sucesso
|
|
43
|
-
<Como saberemos se foi um sucesso 30 dias após o release?>
|
|
1
|
+
# Spec: {{FEATURE}}
|
|
2
|
+
|
|
3
|
+
- **ID**: {{ID}}
|
|
4
|
+
- **Status**: draft | review | approved | implementing | done | abandoned
|
|
5
|
+
- **Owner**: {{OWNER}}
|
|
6
|
+
- **Criado em**: {{DATE}}
|
|
7
|
+
- **Sprint alvo**: <S?>
|
|
8
|
+
- **ADRs relacionadas**: <links para memory/90-decisions/>
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
<O que está doendo? Quem sente a dor? Como medimos hoje?>
|
|
12
|
+
|
|
13
|
+
## 2. Proposta de valor
|
|
14
|
+
<O que muda quando isto existir? Frase única, mensurável.>
|
|
15
|
+
|
|
16
|
+
## 3. User stories
|
|
17
|
+
- **Como** <persona>, **quero** <ação>, **para que** <benefício>
|
|
18
|
+
- ...
|
|
19
|
+
|
|
20
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
21
|
+
- [ ] AC-1: <observável, testável>
|
|
22
|
+
- [ ] AC-2: ...
|
|
23
|
+
|
|
24
|
+
## 5. Escopo
|
|
25
|
+
**Dentro**:
|
|
26
|
+
- ...
|
|
27
|
+
|
|
28
|
+
**Fora** (explícito, evita scope creep):
|
|
29
|
+
- ...
|
|
30
|
+
|
|
31
|
+
## 6. NFRs / restrições
|
|
32
|
+
- Performance: <ex: p95 < 200ms>
|
|
33
|
+
- Segurança: <ex: validação class-validator obrigatória — ADR-0004>
|
|
34
|
+
- Observabilidade: <ex: log estruturado por endpoint>
|
|
35
|
+
- Compatibilidade: <ex: não quebra `init-project.js`>
|
|
36
|
+
|
|
37
|
+
## 7. Riscos e mitigação
|
|
38
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
39
|
+
|---|---|---|---|
|
|
40
|
+
| ... | M | A | ... |
|
|
41
|
+
|
|
42
|
+
## 8. Métricas de sucesso
|
|
43
|
+
<Como saberemos se foi um sucesso 30 dias após o release?>
|
|
44
|
+
|
|
45
|
+
## Evidências e estado real
|
|
46
|
+
- Relacione cada critério AC à task responsável e ao comando ou observação que o verifica.
|
|
47
|
+
- Registre resultado, data e limitações; marque concluído somente após verificar.
|
|
48
|
+
- Diferencie hipótese, estimativa e medição. Remova exemplos que não se aplicam.
|
|
49
|
+
- Documente falhas esperadas, compatibilidade e recuperação quando houver mudança de contrato.
|
|
50
|
+
- Para LLMs, separe sucesso de execução, formato válido e aceite por checks independentes.
|
|
@@ -1,32 +1,39 @@
|
|
|
1
|
-
# Tasks: {{FEATURE}}
|
|
2
|
-
|
|
3
|
-
- **Spec**: ./spec.md
|
|
4
|
-
- **Plan**: ./plan.md
|
|
5
|
-
- **Status**: draft
|
|
6
|
-
- **Criado em**: {{DATE}}
|
|
7
|
-
|
|
8
|
-
> Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
|
|
9
|
-
|
|
10
|
-
Convenção de IDs: `T1`, `T2`, ... Sequência reflete ordem de execução padrão (pode ser paralelizada quando indicado).
|
|
11
|
-
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
## T1 — <título curto>
|
|
15
|
-
- **Owner**: <agente ou pessoa>
|
|
16
|
-
- **Estimativa**: <P/M/G>
|
|
17
|
-
- **Depende de**: —
|
|
18
|
-
- **Paths**: `lib/...`, `scripts/...`
|
|
19
|
-
- **Done quando**:
|
|
20
|
-
- [ ] ...
|
|
21
|
-
- [ ] testes passando
|
|
22
|
-
- [ ] doc atualizada (se aplicável)
|
|
23
|
-
|
|
24
|
-
## T2 — ...
|
|
25
|
-
- **Owner**: ...
|
|
26
|
-
- **Depende de**: T1
|
|
27
|
-
- ...
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
## Handoffs entre agentes
|
|
32
|
-
Se este conjunto de tasks atravessa papéis (Product → SDD Architect → Worker → Governance), registre handoff via `
|
|
1
|
+
# Tasks: {{FEATURE}}
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: draft
|
|
6
|
+
- **Criado em**: {{DATE}}
|
|
7
|
+
|
|
8
|
+
> Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
|
|
9
|
+
|
|
10
|
+
Convenção de IDs: `T1`, `T2`, ... Sequência reflete ordem de execução padrão (pode ser paralelizada quando indicado).
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## T1 — <título curto>
|
|
15
|
+
- **Owner**: <agente ou pessoa>
|
|
16
|
+
- **Estimativa**: <P/M/G>
|
|
17
|
+
- **Depende de**: —
|
|
18
|
+
- **Paths**: `lib/...`, `scripts/...`
|
|
19
|
+
- **Done quando**:
|
|
20
|
+
- [ ] ...
|
|
21
|
+
- [ ] testes passando
|
|
22
|
+
- [ ] doc atualizada (se aplicável)
|
|
23
|
+
|
|
24
|
+
## T2 — ...
|
|
25
|
+
- **Owner**: ...
|
|
26
|
+
- **Depende de**: T1
|
|
27
|
+
- ...
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Handoffs entre agentes
|
|
32
|
+
Se este conjunto de tasks atravessa papéis (Product → SDD Architect → Worker → Governance), registre handoff via `npm run hermes:handoff` pelo core (ADR-0005).
|
|
33
|
+
|
|
34
|
+
## Evidências e estado real
|
|
35
|
+
- Relacione cada critério AC à task responsável e ao comando ou observação que o verifica.
|
|
36
|
+
- Registre resultado, data e limitações; marque concluído somente após verificar.
|
|
37
|
+
- Diferencie hipótese, estimativa e medição. Remova exemplos que não se aplicam.
|
|
38
|
+
- Documente falhas esperadas, compatibilidade e recuperação quando houver mudança de contrato.
|
|
39
|
+
- Para LLMs, separe sucesso de execução, formato válido e aceite por checks independentes.
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
# Plan: Agent Identity & Reputation
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-09-01
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem técnica
|
|
8
|
+
|
|
9
|
+
Novo sub-domínio `packages/engineering/identity` (autorizado por ADR-0078), puro domínio: só
|
|
10
|
+
`computeReputationScore`, uma função que recebe um `EvaluationReport` (já produzido por
|
|
11
|
+
`packages/evals.EvaluationEngine`, reaproveitado sem reimplementar nenhuma métrica) e devolve um
|
|
12
|
+
`AgentReputationScore`. Persistência de `AgentProfile2` **não precisa de migration nova** —
|
|
13
|
+
`packages/adapter-sqlite` já tem `SqliteJsonRepository` (tabela genérica `forja_records`,
|
|
14
|
+
`collection`+`id`+`payload`) usada por `SqliteRuntimeRunStore`/`RuntimePersistence`; um
|
|
15
|
+
`SqliteAgentProfileStore` fino por cima dela (mesmo padrão) é só mais uma `collection`.
|
|
16
|
+
|
|
17
|
+
## 2. Módulos afetados
|
|
18
|
+
|
|
19
|
+
| Caminho | Mudança | Risco |
|
|
20
|
+
|---|---|---|
|
|
21
|
+
| `packages/contracts/src/index.ts` | `AgentProfile2` novo (aditivo — `AgentIdentity` intocado) | Baixo |
|
|
22
|
+
| `packages/engineering/identity/src/index.ts` | novo — `computeReputationScore`, thresholds default | Médio — lógica nova, mas pura/testável |
|
|
23
|
+
| `packages/adapter-sqlite/src/index.ts` | `SqliteAgentProfileStore` novo (reaproveita `SqliteJsonRepository`, sem migration nova) | Baixo |
|
|
24
|
+
| `scripts/agent.ts` | novo — `agent:register/list/show/score/history` | Médio — I/O fino sobre engine puro + stores já existentes |
|
|
25
|
+
| `lib/core/registry.ts` | 5 comandos novos | Baixo |
|
|
26
|
+
| `test/agent-identity-reputation.test.js` (novo) | testes puros de `computeReputationScore` | — |
|
|
27
|
+
| `test/agent-cli.test.js` (novo) | fixture isolada, CLI ponta a ponta | — |
|
|
28
|
+
|
|
29
|
+
## 3. Diagrama de fluxo
|
|
30
|
+
|
|
31
|
+
```text
|
|
32
|
+
agent:register <id> --role ... ──► SqliteAgentProfileStore.save (sem trustLevel/autonomyLevel)
|
|
33
|
+
│
|
|
34
|
+
agent:score <id> [--domain <d>] │
|
|
35
|
+
│ │
|
|
36
|
+
├─► SqliteObservationStore.list() filtrado por agentId (+ capabilityId===domain)
|
|
37
|
+
│ │
|
|
38
|
+
│ ▼
|
|
39
|
+
├─► EvaluationEngine.evaluate({scope:'agent', scopeId, observations}) [já existente]
|
|
40
|
+
│ │
|
|
41
|
+
│ ▼
|
|
42
|
+
└─► computeReputationScore(report) [packages/engineering/identity, puro]
|
|
43
|
+
│
|
|
44
|
+
▼
|
|
45
|
+
AgentReputationScore (trustLevel, autonomyLevel, confidence, evidenceIds)
|
|
46
|
+
│
|
|
47
|
+
▼
|
|
48
|
+
SqliteAgentProfileStore.save (profile + trustLevel/autonomyLevel/lastScoredAt)
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## 4. Contratos (API/CLI/Schema)
|
|
52
|
+
|
|
53
|
+
```ts
|
|
54
|
+
// packages/contracts/src/index.ts — aditivo
|
|
55
|
+
export interface AgentProfile2 extends AuditFields {
|
|
56
|
+
readonly id: EntityId;
|
|
57
|
+
readonly role: string;
|
|
58
|
+
readonly provider?: string;
|
|
59
|
+
readonly model?: string;
|
|
60
|
+
readonly capabilities: readonly string[];
|
|
61
|
+
readonly architectureDomains: readonly string[];
|
|
62
|
+
readonly limits?: { readonly maxFiles?: number; readonly maxCostUsd?: number; readonly maxDurationMs?: number };
|
|
63
|
+
// Só escritos por `agent:score` (via computeReputationScore) — nunca aceitos em `agent:register`.
|
|
64
|
+
readonly trustLevel?: number; // 0-5
|
|
65
|
+
readonly autonomyLevel?: 'autonomous' | 'autonomous_with_review' | 'supervised' | 'human_in_the_loop';
|
|
66
|
+
readonly lastScoredAt?: ISO8601;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
// packages/engineering/identity/src/index.ts
|
|
70
|
+
export interface AgentReputationScore {
|
|
71
|
+
readonly agentId: string;
|
|
72
|
+
readonly domain?: string;
|
|
73
|
+
readonly trustLevel: number;
|
|
74
|
+
readonly autonomyLevel: 'autonomous' | 'autonomous_with_review' | 'supervised' | 'human_in_the_loop';
|
|
75
|
+
readonly confidence: number;
|
|
76
|
+
readonly sampleSize: number;
|
|
77
|
+
readonly metrics: Readonly<Record<string, number>>;
|
|
78
|
+
readonly evidenceIds: readonly string[];
|
|
79
|
+
}
|
|
80
|
+
export interface ReputationThresholds { readonly minSampleSize: number; readonly autonomous: number; readonly autonomousWithReview: number; readonly supervised: number; }
|
|
81
|
+
export const DEFAULT_REPUTATION_THRESHOLDS: ReputationThresholds; // minSampleSize:5, autonomous:4, autonomousWithReview:3, supervised:1 (escala 0-5)
|
|
82
|
+
export function computeReputationScore(report: EvaluationReport, meta: { agentId: string; domain?: string; thresholds?: ReputationThresholds }): AgentReputationScore;
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
agent:register <id> --role <role> [--provider <p>] [--model <m>] [--capabilities <c1,c2>] [--domains <d1,d2>]
|
|
87
|
+
agent:list
|
|
88
|
+
agent:show <id>
|
|
89
|
+
agent:score <id> [--domain <d>]
|
|
90
|
+
agent:history <id>
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## 5. Decisões e alternativas
|
|
94
|
+
|
|
95
|
+
**D1**: `trustLevel` 0-5, fórmula fixa a partir das métricas que `EvaluationEngine` já calcula —
|
|
96
|
+
`0.5·successRate + 0.2·(1-reworkRate) + 0.2·(1-rollbackRate) + 0.1·(1-assertionsWithoutEvidenceRate)`,
|
|
97
|
+
arredondado pra 0-5. Pesos documentados aqui e no código (mesmo princípio de RiskEngine, SPEC-034)
|
|
98
|
+
— nunca "número mágico". Revisitar se dado real mostrar que os pesos não fazem sentido (mesmo kill
|
|
99
|
+
criteria de RiskEngine).
|
|
100
|
+
|
|
101
|
+
**D2**: `agent:register` **não aceita** `--trust-level`/`--autonomy-level` como flag — não é
|
|
102
|
+
validação em runtime, é ausência da opção na CLI. Único jeito de `trustLevel` mudar é
|
|
103
|
+
`computeReputationScore` via `agent:score`. Alternativa rejeitada: aceitar e validar contra
|
|
104
|
+
"não pode ser setado à mão" — mais frágil (alguém pode enganar a validação) que simplesmente nunca
|
|
105
|
+
expor o caminho.
|
|
106
|
+
|
|
107
|
+
**D3**: sem `SqliteAgentProfileStore` novo com migration própria — reaproveita
|
|
108
|
+
`SqliteJsonRepository`/`forja_records` (mesmo padrão de `SqliteRuntimeRunStore`). Zero migration
|
|
109
|
+
nova nesta spec inteira.
|
|
110
|
+
|
|
111
|
+
**D4**: `domain` (do `AgentReputationService.score(agentId, domain?)` do doc de arquitetura) mapeia
|
|
112
|
+
pra um filtro por `Observation.capabilityId` — não é um campo novo em `EvaluationScope` (que já tem
|
|
113
|
+
`'capability'` como scope próprio, mas isso filtraria SÓ por capability, perdendo o filtro por
|
|
114
|
+
agente ao mesmo tempo). Filtro duplo (agentId E capabilityId) é feito no adapter antes de chamar
|
|
115
|
+
`EvaluationEngine.evaluate({observations: <já filtrado>})` — `EvaluationEngine` já aceita
|
|
116
|
+
`observations` pré-filtrado exatamente pra esse caso (parâmetro existente, não uma mudança).
|
|
117
|
+
|
|
118
|
+
## 6. Dependências
|
|
119
|
+
|
|
120
|
+
- `packages/evals.EvaluationEngine` (já existente) — não reimplementado, só consumido.
|
|
121
|
+
- `packages/adapter-sqlite.SqliteObservationStore`/`SqliteJsonRepository` (já existentes).
|
|
122
|
+
|
|
123
|
+
## 7. Rollout
|
|
124
|
+
|
|
125
|
+
- [ ] Feature flag necessária? Não — comandos novos, opt-in por natureza.
|
|
126
|
+
- [ ] Migração de dados existentes? Não (D3).
|
|
127
|
+
- [ ] Doc/persona impactada? README (comandos novos).
|
|
128
|
+
|
|
129
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
130
|
+
|
|
131
|
+
Se `agent:score` sobre dado real (ou amostra sintética documentada, §8 do spec) não corresponder a
|
|
132
|
+
julgamento humano de confiabilidade, os pesos de D1 são revisados antes de qualquer spec futura
|
|
133
|
+
conectar `trustLevel` a decisão de política (§5 "Fora" desta spec, explicitamente adiado).
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
# Spec: Agent Identity & Reputation
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-036
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprint 4 (primeiro sprint da Fase 3 da visão original — Agent Identity / Agent
|
|
8
|
+
Reputation / Project Evals / Smart Routing; esta spec cobre as duas primeiras, Smart Routing fica
|
|
9
|
+
para spec própria — ver §5)
|
|
10
|
+
- **ADRs relacionadas**: ADR-0078 (bounded context `packages/engineering/*` já autorizado; nenhuma
|
|
11
|
+
decisão estrutural nova aqui, só mais um sub-domínio dentro do mesmo contexto)
|
|
12
|
+
|
|
13
|
+
> Depende de SPEC-034 (Change Risk Engine — dados reais de risco começam a existir a partir de
|
|
14
|
+
> agora) e reaproveita `packages/evals.EvaluationEngine` (já existente, scope `'agent'`) — a razão
|
|
15
|
+
> pela qual `docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md` §19 recomendou
|
|
16
|
+
> começar a Fase 3 só depois do Sprint 1-3 estar rodando: reputação precisa de comportamento real
|
|
17
|
+
> pra pontuar, não de um motor de decisão novo.
|
|
18
|
+
|
|
19
|
+
## 1. Problema
|
|
20
|
+
|
|
21
|
+
`AgentIdentity` (`packages/contracts`) hoje é efêmero — `{id, name, role, autonomy}` passado a cada
|
|
22
|
+
`PolicyRequest`, sem histórico persistido. Não existe registro de "quais agentes operam neste
|
|
23
|
+
projeto, com quais capabilities, e qual o histórico de confiabilidade de cada um" — cada run começa
|
|
24
|
+
do zero, sem memória de que um agente já causou 3 rollbacks nesta capability ou tem 95% de sucesso
|
|
25
|
+
naquela. `EvaluationEngine.evaluate({scope:'agent', scopeId})` já produz as métricas certas
|
|
26
|
+
(`successRate`, `reworkRate`, `rollbackRate` etc.), mas nada as transforma num score consultável
|
|
27
|
+
nem as persiste como identidade.
|
|
28
|
+
|
|
29
|
+
## 2. Proposta de valor
|
|
30
|
+
|
|
31
|
+
`forja agent:register`/`:list`/`:show`/`:score`/`:history` dão à Forja uma identidade de agente
|
|
32
|
+
persistente com reputação derivada de comportamento real (nunca auto-declarada) — base para, no
|
|
33
|
+
futuro, `PolicyEngine` e `forja engineer` considerarem "este agente já provou que lida bem com este
|
|
34
|
+
tipo de mudança" em vez de tratar todo agente como desconhecido a cada run.
|
|
35
|
+
|
|
36
|
+
## 3. User stories
|
|
37
|
+
|
|
38
|
+
- **Como** governance, **quero** ver o histórico de confiabilidade de um agente antes de ampliar
|
|
39
|
+
sua autonomia, **para que** a decisão seja baseada em comportamento real, não em confiança cega.
|
|
40
|
+
- **Como** desenvolvedor operando múltiplos agentes/projetos, **quero** `agent:list` mostrando quem
|
|
41
|
+
são os agentes registrados e seu nível de confiança atual, **para que** eu saiba a quem atribuir
|
|
42
|
+
o quê sem adivinhar.
|
|
43
|
+
- **Como** sdd-architect, **quero** que `trustLevel` seja sempre derivado de `Observation`s reais
|
|
44
|
+
(nunca um campo que alguém simplesmente edita), **para que** reputação não vire teatro.
|
|
45
|
+
|
|
46
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
47
|
+
|
|
48
|
+
- [x] AC-1: `AgentProfile2` (extensão aditiva de `packages/contracts`, `AgentIdentity` continua
|
|
49
|
+
existindo sem mudança) é persistido via `SqliteAgentProfileStore` (reaproveita
|
|
50
|
+
`SqliteJsonRepository`/`forja_records` já existente — **sem** migration nova, revisado em
|
|
51
|
+
D3 do plan) — `role`/`provider`/`model`/`capabilities`/`architectureDomains`/`limits` são
|
|
52
|
+
dados de registro; `trustLevel`/`autonomyLevel` **nunca** aceitos em `agent:register` — só
|
|
53
|
+
escritos por `agent:score`.
|
|
54
|
+
- [x] AC-2: `computeReputationScore` (função pura, `packages/engineering/identity`) recebe um
|
|
55
|
+
`EvaluationReport` (já produzido por `EvaluationEngine`, reaproveitado sem reimplementar) e
|
|
56
|
+
devolve `AgentReputationScore` — `trustLevel` 0-5, `confidence` proporcional ao tamanho da
|
|
57
|
+
amostra (`observationCount`), nunca escondida.
|
|
58
|
+
- [x] AC-3: sem amostra suficiente (cold start, `observationCount` abaixo de um mínimo
|
|
59
|
+
configurável), `autonomyLevel` cai para `human_in_the_loop` por padrão — fail-closed em
|
|
60
|
+
ambiguidade (mesmo princípio já usado em Architecture Constitution/Risk Engine), nunca
|
|
61
|
+
`autonomous` por falta de dado.
|
|
62
|
+
- [x] AC-4: `forja agent:register/:list/:show/:score [--domain <d>]/:history` funcionais;
|
|
63
|
+
`agent:score` persiste o `trustLevel`/`autonomyLevel` calculado de volta no profile (cache
|
|
64
|
+
da última pontuação, não fonte de verdade paralela — a fonte de verdade continua sendo os
|
|
65
|
+
`Observation`s).
|
|
66
|
+
- [x] AC-5: nenhum comando/contrato existente muda de assinatura; `PolicyEngine`/`RuntimeEngine`
|
|
67
|
+
continuam funcionando com `AgentIdentity` efêmero exatamente como hoje — este sprint não
|
|
68
|
+
acopla nada a `AgentProfile2` ainda (ver §5, Smart Routing/Policy fica para spec própria).
|
|
69
|
+
|
|
70
|
+
## 5. Escopo
|
|
71
|
+
|
|
72
|
+
**Dentro**: `AgentProfile2` + persistência; `computeReputationScore` (motor puro); CLI
|
|
73
|
+
`agent:register/list/show/score/history`.
|
|
74
|
+
|
|
75
|
+
**Fora** (spec própria quando chegar a vez, mesmo princípio de escopo já usado em SPEC-031 §5 —
|
|
76
|
+
"fases seguintes exigem spec própria, não emenda desta"):
|
|
77
|
+
- Smart Agent Routing (estender `scripts/llm-fit.ts`/`llm:recommend` com dados de reputação) — a
|
|
78
|
+
visão original agrupa isso na mesma Fase 3, mas é consumo do que esta spec produz, não parte de
|
|
79
|
+
produzir; melhor com `AgentReputationScore` já rodando contra dado real primeiro.
|
|
80
|
+
- `PolicyEngine`/`forja engineer` passarem a *consultar* `trustLevel`/`AgentReputationScore`
|
|
81
|
+
automaticamente — mesmo raciocínio de SPEC-034 D3 (score é informação, não decisão automática) e
|
|
82
|
+
mesmo motivo de não estar aqui: consumo depende deste sprint já estar em produção.
|
|
83
|
+
- Agent Runtime Monitoring / Behavior Anomaly Engine (Fase 5 da visão original) — comportamento
|
|
84
|
+
*durante* um run, não identidade/reputação entre runs.
|
|
85
|
+
|
|
86
|
+
## 6. NFRs / restrições
|
|
87
|
+
|
|
88
|
+
- Determinístico: `computeReputationScore` é uma função pura sobre métricas já calculadas por
|
|
89
|
+
`EvaluationEngine` — nenhuma chamada de LLM em nenhum ponto.
|
|
90
|
+
- Fail-closed: amostra insuficiente nunca produz `autonomous` (AC-3).
|
|
91
|
+
- `trustLevel` nunca é um campo editável por humano ou agente — só `agent:score` escreve nele, e só
|
|
92
|
+
com o valor que `computeReputationScore` calculou.
|
|
93
|
+
|
|
94
|
+
## 7. Riscos e mitigação
|
|
95
|
+
|
|
96
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
97
|
+
|---|---|---|---|
|
|
98
|
+
| Reputação virar gate automático de autonomia sem revisão humana | Média (é a tentação óbvia) | Alta (agente ruim ganha mais autonomia sozinho) | Este sprint não conecta `trustLevel` a nenhuma decisão de `PolicyEngine` — é só leitura/consulta (§5, "Fora") |
|
|
99
|
+
| Cold start: agente novo sem `Observation` | Alta em projetos novos ou agentes recém-registrados | Baixa (esperado) | AC-3: fail-closed pra `human_in_the_loop`, `confidence` baixa declarada, nunca escondida |
|
|
100
|
+
| `AgentProfile2` divergir de `AgentIdentity` (dois conceitos de "quem é o agente") | Baixa se documentado | Média | `AgentIdentity` continua sendo o tipo usado em `PolicyRequest`/`RuntimeRun` (efêmero, por run); `AgentProfile2` é o registro persistente — dois papéis diferentes, não dois conceitos concorrentes; nota explícita no código |
|
|
101
|
+
|
|
102
|
+
## 8. Métricas de sucesso
|
|
103
|
+
|
|
104
|
+
Registrar pelo menos 1 agente real usado nesta sessão de desenvolvimento (`apk`/o agente que
|
|
105
|
+
implementou os Sprints 1-3), rodar `agent:score` contra os `Observation`s reais já persistidos (se
|
|
106
|
+
existirem neste workspace) ou contra uma amostra sintética documentada como tal, e confirmar que o
|
|
107
|
+
score reflete corretamente sucesso/retrabalho — revisão humana, mesma metodologia usada em SPEC-034
|
|
108
|
+
§8.
|
|
109
|
+
|
|
110
|
+
**Validado**: workspace de desenvolvimento não acumulou `Observation`s reais suficientes ainda
|
|
111
|
+
(`sync:universal`/runtime real não foi exercitado neste ambiente sandboxado) — validado com amostra
|
|
112
|
+
sintética documentada como tal (`test/agent-cli.test.js`, 4 sucessos + 1 falha com rollback):
|
|
113
|
+
`trustLevel` saiu 4/5 (80% de sucesso, 1 rollback em 5) — ordena corretamente entre o caso "0
|
|
114
|
+
Observation" (0/5) e o caso "100% sucesso" (5/5), ambos também cobertos nos testes unitários do
|
|
115
|
+
motor puro. Revalidar com dado real assim que este workspace acumular `Observation`s de verdade.
|
|
116
|
+
|
|
117
|
+
**Achado real corrigido durante a implementação (não adiado)**: a primeira execução de
|
|
118
|
+
`agent:score` contra um agente recém-registrado, **zero** `Observation`, devolveu `trustLevel 3/5`
|
|
119
|
+
— um número "neutro" que sugeria confiabilidade moderada sem nenhuma evidência por trás.
|
|
120
|
+
`EvaluationEngine.rate()` devolve `0` (não `undefined`) pra toda métrica quando não há dado, e a
|
|
121
|
+
fórmula original lia `reworkRate`/`rollbackRate`/`assertionsWithoutEvidenceRate` zerados como "bom
|
|
122
|
+
sinal" — 3/5 do nada. Corrigido em `packages/engineering/identity`: `sampleSize === 0` agora força
|
|
123
|
+
`trustLevel: 0` antes mesmo de aplicar a fórmula, com teste unitário e de CLI cobrindo o caso.
|
|
124
|
+
`autonomyLevel` já caía corretamente pra `human_in_the_loop` via AC-3 mesmo antes da correção — só
|
|
125
|
+
o número exibido é que mentia.
|