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
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Tasks: Agent Identity & Reputation
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## T1 — contrato + engine puro (`computeReputationScore`)
|
|
11
|
+
- **Owner**: worker
|
|
12
|
+
- **Estimativa**: M
|
|
13
|
+
- **Depende de**: —
|
|
14
|
+
- **Paths**: `packages/contracts/src/index.ts`, `packages/engineering/identity/src/index.ts`
|
|
15
|
+
- **Done quando**:
|
|
16
|
+
- [ ] `AgentProfile2` aditivo, `trustLevel`/`autonomyLevel`/`lastScoredAt` opcionais
|
|
17
|
+
- [ ] `computeReputationScore` implementa a fórmula de D1 do plan
|
|
18
|
+
- [ ] amostra abaixo de `minSampleSize` força `autonomyLevel: 'human_in_the_loop'` (AC-3)
|
|
19
|
+
- [ ] testes unitários (sem `fs`/rede): fórmula com dado real vs. sintético, cold start,
|
|
20
|
+
thresholds customizados, `evidenceIds` passthrough do `EvaluationReport.observationIds`
|
|
21
|
+
|
|
22
|
+
## T2 — persistência (`SqliteAgentProfileStore`) + `scripts/agent.ts`
|
|
23
|
+
- **Owner**: worker
|
|
24
|
+
- **Estimativa**: G
|
|
25
|
+
- **Depende de**: T1
|
|
26
|
+
- **Paths**: `packages/adapter-sqlite/src/index.ts`, `scripts/agent.ts`, `lib/core/registry.ts`
|
|
27
|
+
- **Done quando**:
|
|
28
|
+
- [ ] `SqliteAgentProfileStore` reaproveita `SqliteJsonRepository`, sem migration nova (D3)
|
|
29
|
+
- [ ] `agent:register` não tem flag de `trust-level`/`autonomy-level` (D2)
|
|
30
|
+
- [ ] `agent:score` computa e persiste `trustLevel`/`autonomyLevel`/`lastScoredAt`, filtro por
|
|
31
|
+
`--domain` funcional (D4)
|
|
32
|
+
- [ ] `agent:list`/`:show`/`:history` funcionais
|
|
33
|
+
- [ ] `forja tools:doctor` continua verde
|
|
34
|
+
|
|
35
|
+
## T3 — prova sobre dado real/sintético documentado
|
|
36
|
+
- **Owner**: worker
|
|
37
|
+
- **Estimativa**: P
|
|
38
|
+
- **Depende de**: T2
|
|
39
|
+
- **Paths**: `test/agent-cli.test.js` (novo)
|
|
40
|
+
- **Done quando**:
|
|
41
|
+
- [ ] fixture isolada: registrar agente, seed de `Observation`s sintéticas (documentadas como
|
|
42
|
+
tal — sem `Observation` real suficiente neste workspace), `agent:score` produz resultado
|
|
43
|
+
coerente
|
|
44
|
+
- [ ] cold start (sem `Observation`) produz `human_in_the_loop`, não erro
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## Handoffs entre agentes
|
|
49
|
+
|
|
50
|
+
T1 → T2 → T3 sequencial. Sem handoff de papel — spec e plan já aprovados cobrem as decisões de
|
|
51
|
+
produto/arquitetura.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Plan: Instruções de agentes v4
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
|
|
6
|
+
Centralizar comportamento em docs/agent-operating-contract.md; manter procedimentos de papel nos prompts e agentes. Atualizar skill e templates. Incluir skills/ no tarball. Doctor deriva scripts válidos do package.json, assim como já deriva comandos de projetos gerados.
|
|
7
|
+
|
|
8
|
+
Validação: quick_validate da skill, testes health/harness/spec-cli, suíte completa, types:check, tools:doctor e gate do tarball após commit. Recuperação por revert do commit; sem migração de dados.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Spec: Instruções de agentes v4
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-039
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-05
|
|
7
|
+
|
|
8
|
+
## Problema e escopo
|
|
9
|
+
Prompts e skills citavam comandos antigos, confundiam execução com aceite e prescreviam rotinas sem evidência. Atualizar as superfícies ativas e templates sem reescrever specs históricas. Corrigir o falso positivo do doctor para scripts npm do checkout.
|
|
10
|
+
|
|
11
|
+
## Critérios de aceite
|
|
12
|
+
- [x] AC-1: Seis prompts e agentes compartilham contrato de contexto, autorização e evidências.
|
|
13
|
+
- [x] AC-2: Skill de LLM possui frontmatter válido e é incluída no pacote.
|
|
14
|
+
- [x] AC-3: Templates SDD orientam evidência por critério; instruções nativas apontam o contrato.
|
|
15
|
+
- [x] AC-4: Doctor reconhece scripts reais; teste mantém rejeição de comandos inexistentes.
|
|
16
|
+
|
|
17
|
+
## Restrições
|
|
18
|
+
Não alegar disponibilidade de modelos, custos medidos ou aceite sem verificação. Não alterar semântica dos adapters LLM nesta revisão.
|
|
19
|
+
|
|
20
|
+
## Evidências
|
|
21
|
+
Em 2026-09-05: 473 testes passaram; types:check, build, tools:doctor e quick_validate da skill passaram. Publicação e CI são acompanhados após o commit; não constituem aceite editorial local.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Tasks: Instruções de agentes v4
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: done
|
|
6
|
+
|
|
7
|
+
- [x] T1: Atualizar contrato, prompts e agentes (AC-1).
|
|
8
|
+
- [x] T2: Validar skill e incluir no pacote (AC-2).
|
|
9
|
+
- [x] T3: Atualizar instruções e templates (AC-3).
|
|
10
|
+
- [x] T4: Verificar regressão do doctor e suíte (AC-4): 473 testes, tipos, build e doctor passaram.
|
|
11
|
+
|
|
12
|
+
Gate de release e CI serão executados sobre o commit publicado.
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# Plan: Agent Runtime Monitoring / Behavior Anomaly Engine
|
|
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/monitoring`, puro: `detectAnomaly(baseline, recent)`
|
|
10
|
+
compara dois `EvaluationReport` (mesma fonte que `computeReputationScore` consome, SPEC-036) fator
|
|
11
|
+
a fator. `scripts/agent.ts` ganha `agent:monitor` (mesmo script de domínio de SPEC-036/037 — não um
|
|
12
|
+
script novo), que busca `Observation`s reais e monta os dois `EvaluationReport` (linha de base =
|
|
13
|
+
tudo antes da janela; recente = últimas N horas), reaproveitando `EvaluationEngine` sem
|
|
14
|
+
reimplementar nenhuma métrica.
|
|
15
|
+
|
|
16
|
+
`packages/policy` ganha `anomalyScoreRange`/`anomalyScore`, campo `number` puro — mesmo padrão
|
|
17
|
+
exato de `riskScoreRange`/`riskScore` (SPEC-034): nenhum import de `packages/engineering/monitoring`.
|
|
18
|
+
|
|
19
|
+
## 2. Módulos afetados
|
|
20
|
+
|
|
21
|
+
| Caminho | Mudança | Risco |
|
|
22
|
+
|---|---|---|
|
|
23
|
+
| `packages/engineering/monitoring/src/index.ts` | novo — `detectAnomaly` | Baixo — comparação pura |
|
|
24
|
+
| `scripts/agent.ts` | `agent:monitor` novo subcomando | Baixo |
|
|
25
|
+
| `packages/policy/src/index.ts` | `anomalyScoreRange`/`anomalyScore` (aditivo) | Baixo |
|
|
26
|
+
| `lib/core/registry.ts` | 1 comando novo | Baixo |
|
|
27
|
+
| `test/agent-runtime-monitoring.test.js` (novo) | unit de `detectAnomaly` | — |
|
|
28
|
+
| `test/policy.test.js` | +teste de `anomalyScoreRange` | — |
|
|
29
|
+
| `test/agent-cli.test.js` | +teste de CLI de `agent:monitor` | — |
|
|
30
|
+
|
|
31
|
+
## 3. Contratos
|
|
32
|
+
|
|
33
|
+
```ts
|
|
34
|
+
// packages/engineering/monitoring/src/index.ts
|
|
35
|
+
export interface AnomalySignal { readonly metric: string; readonly baseline: number; readonly recent: number; readonly delta: number; }
|
|
36
|
+
export interface AnomalyAssessment { readonly agentId: string; readonly score: number; readonly confidence: number; readonly signals: readonly AnomalySignal[]; }
|
|
37
|
+
export function detectAnomaly(agentId: string, baseline: EvaluationReport, recent: EvaluationReport, options?: { minSampleSize?: number }): AnomalyAssessment;
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Fórmula (D1): compara `successRate`, `reworkRate`, `rollbackRate` (as 3 métricas de qualidade já
|
|
41
|
+
usadas em `computeReputationScore`, D1 de SPEC-036 — mesmo vocabulário, não um novo). Para cada
|
|
42
|
+
métrica, `delta = recent - baseline` (sinal importa: `successRate` caindo é ruim, `reworkRate`/
|
|
43
|
+
`rollbackRate` subindo é ruim). `score = min(100, round(100 * (max(0, -deltaSuccessRate) * 0.5 +
|
|
44
|
+
max(0, deltaReworkRate) * 0.25 + max(0, deltaRollbackRate) * 0.25)))`. `confidence` = `min(1,
|
|
45
|
+
min(baseline.observationCount, recent.observationCount) / minSampleSize)` (default `minSampleSize:
|
|
46
|
+
5`, mesmo valor default de `DEFAULT_REPUTATION_THRESHOLDS.minSampleSize` em SPEC-036 — consistência
|
|
47
|
+
entre os dois motores de agente).
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
agent:monitor <id> [--window-hours <n>] # default 24
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
```ts
|
|
54
|
+
// packages/policy/src/index.ts — extensão aditiva
|
|
55
|
+
export interface PolicyScope { /* ...campos existentes... */ readonly anomalyScoreRange?: readonly [number, number]; }
|
|
56
|
+
export interface PolicyRequest { /* ...campos existentes... */ readonly anomalyScore?: number; }
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## 4. Decisões
|
|
60
|
+
|
|
61
|
+
**D1**: fórmula reaproveita as mesmas 3 métricas de `computeReputationScore` (successRate/
|
|
62
|
+
reworkRate/rollbackRate) — vocabulário consistente entre os dois motores de comportamento de
|
|
63
|
+
agente, em vez de inventar um conjunto de métricas diferente pra "anomalia" vs. "reputação".
|
|
64
|
+
|
|
65
|
+
**D2**: `anomalyScoreRange`/`anomalyScore` seguem exatamente o padrão de `riskScoreRange`/
|
|
66
|
+
`riskScore` (mesmo formato `[number, number]`, mesmo `matches()` em `PolicyEngine`, mesmo raciocínio
|
|
67
|
+
de D3 de SPEC-034: campo `number` puro, não o `AnomalyAssessment` inteiro) — consistência de design
|
|
68
|
+
entre os dois scores que `PolicyEngine` pode consultar.
|
|
69
|
+
|
|
70
|
+
## 5. Rollout
|
|
71
|
+
|
|
72
|
+
Sem migração, sem feature flag.
|
|
73
|
+
|
|
74
|
+
## 6. Kill criteria
|
|
75
|
+
|
|
76
|
+
Já coberto pelo mesmo princípio das specs anteriores — se `detectAnomaly` sinalizar anomalia sem
|
|
77
|
+
correspondência a julgamento humano sobre dado real, os pesos de D1 são revisados antes de
|
|
78
|
+
qualquer regra de política real usar `anomalyScoreRange` (§5 do spec, "Fora").
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# Spec: Agent Runtime Monitoring / Behavior Anomaly Engine
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-040
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprint 8 (fecha a Fase 5 da visão original, junto de SPEC-039)
|
|
8
|
+
- **ADRs relacionadas**: ADR-0078; depende de `packages/evals.EvaluationEngine` (reaproveitado),
|
|
9
|
+
`packages/policy` (extensão aditiva, mesmo padrão de SPEC-034 `riskScoreRange`)
|
|
10
|
+
|
|
11
|
+
> Gap analysis original (`docs/architecture/...` §3): "Não existe. `PolicyEngine` já é o lugar
|
|
12
|
+
> certo pra acoplar (política decide, não o LLM) — Construir, mas *dentro* de Policy, não paralelo."
|
|
13
|
+
> Interpretação (mesma resolvida em SPEC-034 D3 pra risco): "dentro de Policy" não significa o
|
|
14
|
+
> cálculo morar em `packages/policy` — significa que a **decisão** continua sendo do
|
|
15
|
+
> `PolicyEngine`/humano, nunca de um motor de anomalia paralelo. O cálculo é um pacote separado
|
|
16
|
+
> (mesmo padrão de `RiskEngine`), e `PolicyRequest` ganha um campo `number` opcional pra consultá-lo
|
|
17
|
+
> — exatamente a forma que `riskScoreRange`/`riskScore` já tomaram em SPEC-034.
|
|
18
|
+
|
|
19
|
+
## 1. Problema
|
|
20
|
+
|
|
21
|
+
Nada compara o comportamento **recente** de um agente contra sua própria linha de base — um agente
|
|
22
|
+
que de repente começa a falhar mais, gastar mais, ou tocar categorias diferentes de arquivo não
|
|
23
|
+
gera nenhum sinal. `EvaluationEngine` já calcula as taxas certas por escopo, mas só olha pra um
|
|
24
|
+
recorte de dado por vez, nunca compara dois recortes (linha de base vs. recente).
|
|
25
|
+
|
|
26
|
+
## 2. Proposta de valor
|
|
27
|
+
|
|
28
|
+
`forja agent:monitor <id> [--window-hours <n>]` compara os `Observation`s recentes de um agente
|
|
29
|
+
contra sua linha de base histórica e reporta um `AnomalyAssessment` com sinais nomeados — nunca um
|
|
30
|
+
alarme sem explicação, mesmo princípio de `RiskEngine`/`AgentReputationScore`.
|
|
31
|
+
|
|
32
|
+
## 3. User stories
|
|
33
|
+
|
|
34
|
+
- **Como** governance, **quero** saber quando o comportamento recente de um agente se desvia do
|
|
35
|
+
histórico dele, **para que** eu investigue antes que o desvio vire um incidente.
|
|
36
|
+
|
|
37
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
38
|
+
|
|
39
|
+
- [x] AC-1: `detectAnomaly` (função pura, `packages/engineering/monitoring`) recebe dois
|
|
40
|
+
`EvaluationReport` (linha de base + recente, ambos já produzidos por `EvaluationEngine`,
|
|
41
|
+
reaproveitado sem reimplementar nenhuma métrica) e devolve `AnomalyAssessment` — `score`
|
|
42
|
+
0-100, `signals[]` nomeados (quais métricas desviaram e por quanto), nunca um score sem
|
|
43
|
+
explicação.
|
|
44
|
+
- [x] AC-2: amostra insuficiente em qualquer um dos dois recortes (linha de base ou recente) marca
|
|
45
|
+
`confidence` baixa explicitamente — fail-closed/honesto, mesmo princípio de
|
|
46
|
+
`AgentReputationScore`/SPEC-036 AC-3, nunca reporta anomalia alta por falta de dado.
|
|
47
|
+
- [x] AC-3: `forja agent:monitor <id> [--window-hours <n>]` (CLI) — linha de base = todo o histórico
|
|
48
|
+
anterior à janela; recente = últimas `n` horas (default configurável). Reaproveita
|
|
49
|
+
`SqliteObservationStore` (já existente).
|
|
50
|
+
- [x] AC-4: `PolicyScope.anomalyScoreRange`/`PolicyRequest.anomalyScore` (extensão aditiva de
|
|
51
|
+
`packages/policy`, mesmo padrão exato de `riskScoreRange`/`riskScore` em SPEC-034) —
|
|
52
|
+
`packages/policy` nunca importa `packages/engineering/monitoring`; quem calcula o score chama
|
|
53
|
+
`detectAnomaly` antes de montar o `PolicyRequest`, exatamente como já acontece com risco.
|
|
54
|
+
- [x] AC-5: nenhuma aplicação automática — `agent:monitor` nunca chama `PolicyEngine`/bloqueia
|
|
55
|
+
nada sozinho; é leitura, mesmo princípio de `RiskEngine` D3.
|
|
56
|
+
|
|
57
|
+
## 5. Escopo
|
|
58
|
+
|
|
59
|
+
**Dentro**: `detectAnomaly` (motor puro); `agent:monitor` (CLI); extensão aditiva de
|
|
60
|
+
`packages/policy` (campo `number`, não motor paralelo).
|
|
61
|
+
|
|
62
|
+
**Fora**: qualquer regra de política real usando `anomalyScoreRange` neste sprint (só a capacidade
|
|
63
|
+
estrutural, mesmo raciocínio de `riskScoreRange` em SPEC-034 — não é este sprint que decide
|
|
64
|
+
*quando* pausar um agente, só habilita que uma regra futura possa); alertas/notificação automática
|
|
65
|
+
(fica pra quando houver um canal real de notificação, fora de escopo desta fundação); detecção via
|
|
66
|
+
ML/estatística avançada (comparação de taxa determinística e documentada é suficiente e verificável
|
|
67
|
+
— mesmo princípio de "determinístico antes de LLM" já estabelecido em toda a fundação).
|
|
68
|
+
|
|
69
|
+
## 6. NFRs / restrições
|
|
70
|
+
|
|
71
|
+
- Determinístico — nenhum LLM/ML em nenhum ponto; fórmula documentada em código e aqui.
|
|
72
|
+
- Fail-closed: amostra insuficiente nunca produz confiança alta (AC-2).
|
|
73
|
+
- Zero migration SQLite nova.
|
|
74
|
+
|
|
75
|
+
## 7. Riscos e mitigação
|
|
76
|
+
|
|
77
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
78
|
+
|---|---|---|---|
|
|
79
|
+
| Anomalia virar bloqueio automático de agente | Baixa (mesmo padrão já seguido em Risk/Reputation) | Alta se acontecesse | AC-5 explícito; nenhuma regra de política usando o campo é criada nesta spec (§5 "Fora") |
|
|
80
|
+
| Falso positivo por baixa amostra em qualquer um dos dois recortes | Média em agentes novos/pouco usados | Média (alarme sem sentido) | AC-2: confidence baixa declarada, não escondida |
|
|
81
|
+
|
|
82
|
+
## 8. Métricas de sucesso
|
|
83
|
+
|
|
84
|
+
Comparar dois recortes sintéticos documentados como tais (um com comportamento estável, outro com
|
|
85
|
+
degradação clara — ex.: `successRate` caindo de 90% pra 30%) e confirmar que `detectAnomaly` sinaliza
|
|
86
|
+
a anomalia com os `signals[]` corretos — revisão humana, mesma metodologia das specs anteriores.
|
|
87
|
+
|
|
88
|
+
**Validado** (`test/agent-cli.test.js`): amostra sintética documentada como tal (10 `Observation`s
|
|
89
|
+
de linha de base com 90% de sucesso, 10 recentes com 30%) — `agent:monitor` reportou o `signal`
|
|
90
|
+
`successRate: 0.90 → 0.30`, score de anomalia > 0, nunca acionou `PolicyEngine`/bloqueio algum. Caso
|
|
91
|
+
de zero `Observation` reporta corretamente score 0 (sem degradação sem dado, não um alarme
|
|
92
|
+
por falta de dado — mesma honestidade de AC-2/`AgentReputationScore`).
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Tasks: Agent Runtime Monitoring / Behavior Anomaly Engine
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## T1 — `detectAnomaly` (motor puro) + `PolicyEngine` extensão
|
|
11
|
+
- **Owner**: worker
|
|
12
|
+
- **Estimativa**: M
|
|
13
|
+
- **Depende de**: —
|
|
14
|
+
- **Paths**: `packages/engineering/monitoring/src/index.ts`, `packages/policy/src/index.ts`
|
|
15
|
+
- **Done quando**:
|
|
16
|
+
- [ ] `detectAnomaly` implementa a fórmula de D1, `confidence` reflete o menor dos dois tamanhos
|
|
17
|
+
de amostra (AC-2)
|
|
18
|
+
- [ ] `PolicyScope.anomalyScoreRange`/`PolicyRequest.anomalyScore` (D2), `packages/policy`
|
|
19
|
+
continua sem importar `packages/engineering/monitoring`
|
|
20
|
+
- [ ] testes unitários: degradação clara sinaliza corretamente; comportamento estável não
|
|
21
|
+
sinaliza; amostra pequena em qualquer um dos dois recortes reduz confidence
|
|
22
|
+
- [ ] testes de `PolicyEngine.matches` com `anomalyScoreRange`
|
|
23
|
+
|
|
24
|
+
## T2 — `agent:monitor` (CLI) + prova
|
|
25
|
+
- **Owner**: worker
|
|
26
|
+
- **Estimativa**: M
|
|
27
|
+
- **Depende de**: T1
|
|
28
|
+
- **Paths**: `scripts/agent.ts`, `lib/core/registry.ts`, `test/agent-cli.test.js`
|
|
29
|
+
- **Done quando**:
|
|
30
|
+
- [ ] `agent:monitor <id> [--window-hours <n>]` busca `Observation`s reais, monta os dois
|
|
31
|
+
`EvaluationReport` (linha de base/recente), chama `detectAnomaly`
|
|
32
|
+
- [ ] teste de CLI com amostra sintética documentada como tal (degradação clara)
|
|
33
|
+
- [ ] `forja tools:doctor` continua verde
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Handoffs entre agentes
|
|
38
|
+
|
|
39
|
+
T1 → T2 sequencial. Sem handoff de papel.
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Plan: AI Code Provenance + AI-SBOM
|
|
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/provenance` (autorizado por ADR-0078), puro: só
|
|
10
|
+
`extractProvenance(run)`, mapeamento de `RuntimeRun.changedFiles` para `ProvenanceRecord[]`.
|
|
11
|
+
Persistência via `SqliteProvenanceStore` (reaproveita `SqliteJsonRepository`, mesmo padrão zero-
|
|
12
|
+
migration de `SqliteAgentProfileStore`/`SqliteRuntimeRunStore`). `scripts/provenance.ts` é o
|
|
13
|
+
adapter: `provenance:record <run-id>` (lê o `RuntimeRun` via `SqliteRuntimeRunStore.get`, já
|
|
14
|
+
existente), `blame <file>`, `sbom`.
|
|
15
|
+
|
|
16
|
+
## 2. Módulos afetados
|
|
17
|
+
|
|
18
|
+
| Caminho | Mudança | Risco |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| `packages/engineering/provenance/src/index.ts` | novo — `extractProvenance` | Baixo — mapeamento puro |
|
|
21
|
+
| `packages/adapter-sqlite/src/index.ts` | `SqliteProvenanceStore` novo (reaproveita `SqliteJsonRepository`) | Baixo |
|
|
22
|
+
| `scripts/provenance.ts` | novo — `provenance:record`/`blame`/`sbom` | Baixo |
|
|
23
|
+
| `lib/core/registry.ts` | 3 comandos novos | Baixo |
|
|
24
|
+
| `test/provenance.test.js` (novo) | unit + CLI | — |
|
|
25
|
+
|
|
26
|
+
## 3. Contratos
|
|
27
|
+
|
|
28
|
+
```ts
|
|
29
|
+
// packages/engineering/provenance/src/index.ts
|
|
30
|
+
export interface ProvenanceRecord {
|
|
31
|
+
readonly file: string;
|
|
32
|
+
readonly runId: string;
|
|
33
|
+
readonly agentId: string;
|
|
34
|
+
readonly model?: string;
|
|
35
|
+
readonly lines?: readonly [number, number][]; // sempre undefined nesta spec — ver AC-2
|
|
36
|
+
readonly recordedAt: string;
|
|
37
|
+
}
|
|
38
|
+
export function extractProvenance(run: RuntimeRun): readonly ProvenanceRecord[];
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
provenance:record <run-id>
|
|
43
|
+
blame <file>
|
|
44
|
+
sbom [--json]
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## 4. Decisões
|
|
48
|
+
|
|
49
|
+
**D1**: `blame`/`sbom` são comandos de topo (não `provenance:blame`/`provenance:sbom`) — a visão
|
|
50
|
+
original e o CLI plan (`docs/architecture/...` §12) já citam `provenance:blame`/`:generate`, mas
|
|
51
|
+
"blame" e "sbom" como conceitos são suficientemente autoexplicativos e usados fora do namespace
|
|
52
|
+
`provenance:` em outras ferramentas (`git blame`, SBOM genérico) — manter `provenance:record` (a
|
|
53
|
+
ação de escrita, menos ambígua com prefixo) e deixar as duas leituras mais usadas sem prefixo,
|
|
54
|
+
espelhando `engineer`/`simulate` (façades/comandos de leitura frequente também sem prefixo de
|
|
55
|
+
domínio).
|
|
56
|
+
|
|
57
|
+
**D2**: `SqliteRuntimeRunStore` não ganha `list()` nesta spec — `blame`/`sbom` enumeram via
|
|
58
|
+
`SqliteProvenanceStore.list()` (nova, mas só ela é necessária); `SqliteRuntimeRunStore.get(runId)`
|
|
59
|
+
já existente basta pra `provenance:record <run-id>` (busca um run específico por id). Adicionar
|
|
60
|
+
`list()` a `SqliteRuntimeRunStore` sem um consumidor real seria antecipar uso hipotético — evitado
|
|
61
|
+
por princípio (CLAUDE.md/instruções da sessão: não adicionar abstração além do que a tarefa exige).
|
|
62
|
+
|
|
63
|
+
## 5. Rollout
|
|
64
|
+
|
|
65
|
+
Sem migração, sem feature flag.
|
|
66
|
+
|
|
67
|
+
## 6. Kill criteria
|
|
68
|
+
|
|
69
|
+
Já coberto pelo mesmo princípio das specs anteriores — se `blame`/`sbom` confundirem usuários por
|
|
70
|
+
prometerem granularidade de linha, revisar a UX (não os dados, que já são honestos por construção
|
|
71
|
+
via AC-2) antes de qualquer extensão futura.
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# Spec: AI Code Provenance + AI-SBOM
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-039
|
|
4
|
+
- **Status**: done
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
- **Sprint alvo**: Sprint 7 (Fase 5 da visão original)
|
|
8
|
+
- **ADRs relacionadas**: ADR-0078; depende de `RuntimeRun`/`AgentIdentity` (`packages/contracts`,
|
|
9
|
+
já existentes) e `SqliteRuntimeRunStore` (já existente)
|
|
10
|
+
|
|
11
|
+
> Gap analysis original (`docs/architecture/...` §3): "`Observation` já tem `model`, `agentId`,
|
|
12
|
+
> `runId`, `inputHash`, `contextRefs` — falta só ligar linha de código a `Observation`... Construir,
|
|
13
|
+
> dado que os campos-fonte já existem." `RuntimeRun.changedFiles`+`RuntimeRun.agent` têm exatamente
|
|
14
|
+
> o dado necessário pra provenance em **granularidade de arquivo** — a granularidade que este
|
|
15
|
+
> repositório de fato coleta hoje.
|
|
16
|
+
|
|
17
|
+
## 1. Problema
|
|
18
|
+
|
|
19
|
+
Nada liga "este arquivo mudou neste run" a "quem/qual agente produziu essa mudança" de forma
|
|
20
|
+
consultável — `RuntimeRun` já grava `changedFiles`+`agent` por run, mas essa informação fica presa
|
|
21
|
+
em cada `RuntimeRun` isolado, sem uma view "quem tocou este arquivo, ao longo do tempo" nem um
|
|
22
|
+
relatório agregado de proveniência do código gerado por IA.
|
|
23
|
+
|
|
24
|
+
## 2. Proposta de valor
|
|
25
|
+
|
|
26
|
+
`forja provenance:record <run-id>` extrai proveniência (arquivo↔agente↔run) de um `RuntimeRun` já
|
|
27
|
+
persistido; `forja blame <file>` mostra o histórico de quem tocou um arquivo; `forja sbom` agrega
|
|
28
|
+
tudo num relatório por agente/modelo — um "AI-SBOM" honesto sobre o que já foi coletado, não uma
|
|
29
|
+
promessa de rastreamento que o sistema não tem dado pra sustentar.
|
|
30
|
+
|
|
31
|
+
## 3. User stories
|
|
32
|
+
|
|
33
|
+
- **Como** governance, **quero** saber quais agentes/modelos tocaram um arquivo, **para que** eu
|
|
34
|
+
saiba a quem perguntar ou o que revisar com mais cuidado.
|
|
35
|
+
- **Como** compliance/auditoria, **quero** um relatório agregado de proveniência do código gerado
|
|
36
|
+
por IA neste projeto, **para que** eu tenha uma resposta estruturada, não "não sabemos".
|
|
37
|
+
|
|
38
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
39
|
+
|
|
40
|
+
- [x] AC-1: `extractProvenance` (função pura, `packages/engineering/provenance`) recebe um
|
|
41
|
+
`RuntimeRun` e devolve `ProvenanceRecord[]` (um por arquivo em `changedFiles`) — nenhum dado
|
|
42
|
+
inventado além do que o run já registrou.
|
|
43
|
+
- [x] AC-2: granularidade é **arquivo**, não linha — `ProvenanceRecord.lines` existe no tipo (mesmo
|
|
44
|
+
shape do `ProvenanceEngine.recordGeneration` desenhado no doc de arquitetura §11) mas fica
|
|
45
|
+
`undefined` nesta spec, porque nenhuma fonte de dado real deste repositório rastreia hunks de
|
|
46
|
+
linha por run hoje. Nunca fingir granularidade de linha que não existe (mesmo princípio de
|
|
47
|
+
"nunca escondida" já usado em `AgentReputationScore.confidence`).
|
|
48
|
+
- [x] AC-3: `forja provenance:record <run-id>` persiste os `ProvenanceRecord`s de um `RuntimeRun`
|
|
49
|
+
já existente (`SqliteRuntimeRunStore.get`, já existente) — sem tocar em `RuntimeEngine`, sem
|
|
50
|
+
novo ponto de coleta automática (essa integração é spec própria futura, ver §5).
|
|
51
|
+
- [x] AC-4: `forja blame <file>` lista os registros de proveniência de um arquivo, mais recentes
|
|
52
|
+
primeiro.
|
|
53
|
+
- [x] AC-5: `forja sbom [--json]` agrega todos os registros por **agente** (contagem de arquivos,
|
|
54
|
+
lista de arquivos) — derivado inteiramente do que já foi gravado, sem nova fonte de verdade.
|
|
55
|
+
Não agrega por modelo: `AgentIdentity` (o tipo real de `RuntimeRun.agent`) não carrega um
|
|
56
|
+
campo de modelo de LLM hoje — `ProvenanceRecord.model` fica declarado no tipo mas sempre
|
|
57
|
+
`undefined`, mesmo raciocínio de AC-2 pra `lines`.
|
|
58
|
+
|
|
59
|
+
## 5. Escopo
|
|
60
|
+
|
|
61
|
+
**Dentro**: `extractProvenance` (motor puro); `SqliteProvenanceStore` (reaproveita
|
|
62
|
+
`SqliteJsonRepository`, sem migration nova — mesmo padrão de `SqliteAgentProfileStore`);
|
|
63
|
+
`provenance:record`/`blame`/`sbom` (CLI).
|
|
64
|
+
|
|
65
|
+
**Fora** (spec própria futura, mesmo princípio de escopo já usado nas specs anteriores):
|
|
66
|
+
- Coleta automática de proveniência no fim de todo `RuntimeRun` (integração com `RuntimeEngine`) —
|
|
67
|
+
esta spec só extrai de runs já persistidos, sob demanda; automatizar a coleta é uma mudança no
|
|
68
|
+
caminho crítico do runtime, merece spec própria com sua própria análise de risco.
|
|
69
|
+
- Granularidade de linha (`git blame`-like) — exigiria uma fonte de dado nova (hunks de diff por
|
|
70
|
+
run) que não existe hoje; ver AC-2.
|
|
71
|
+
- AI-SBOM em formato padrão da indústria (CycloneDX/SPDX) — o relatório desta spec é interno,
|
|
72
|
+
formato próprio; adotar um formato padrão é decisão separada, não bloqueante pra esta fundação.
|
|
73
|
+
|
|
74
|
+
## 6. NFRs / restrições
|
|
75
|
+
|
|
76
|
+
- Determinístico — nenhum LLM em nenhum ponto.
|
|
77
|
+
- `ProvenanceRecord` nunca afirma granularidade de linha sem dado real (AC-2).
|
|
78
|
+
- Zero migration SQLite nova (mesmo padrão de SPEC-036).
|
|
79
|
+
|
|
80
|
+
## 7. Riscos e mitigação
|
|
81
|
+
|
|
82
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
83
|
+
|---|---|---|---|
|
|
84
|
+
| `forja blame`/`sbom` prometerem granularidade de linha que não existe | Média (nome "blame" sugere `git blame`) | Média (confiança quebrada quando descoberto) | AC-2 explícito; saída de `blame` deixa claro que é por arquivo, não por linha |
|
|
85
|
+
| `provenance:record` divergir do `RuntimeRun` original se rodado depois de mudanças | Baixa | Baixa | `RuntimeRun` é imutável após completar (mesmo padrão já estabelecido); `provenance:record` sempre lê o estado atual, idempotente por natureza |
|
|
86
|
+
|
|
87
|
+
## 8. Métricas de sucesso
|
|
88
|
+
|
|
89
|
+
Rodar `provenance:record` sobre 1+ `RuntimeRun` real ou sintético documentado como tal, e confirmar
|
|
90
|
+
que `blame`/`sbom` refletem corretamente o que foi gravado — revisão humana, mesma metodologia das
|
|
91
|
+
specs anteriores.
|
|
92
|
+
|
|
93
|
+
**Validado** (`test/provenance-cli.test.js`): `RuntimeRun` sintético documentado como tal (este
|
|
94
|
+
workspace de desenvolvimento ainda não acumulou runs reais suficientes, mesma situação já
|
|
95
|
+
registrada em SPEC-036 §8) com 2 arquivos alterados — `provenance:record` gravou os 2 registros,
|
|
96
|
+
`blame` de cada arquivo mostrou o agente/run corretos, `sbom` agregou corretamente por agente.
|
|
97
|
+
Regravar o mesmo run é idempotente (chave `runId:file`), não duplica.
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Tasks: AI Code Provenance + AI-SBOM
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: approved
|
|
6
|
+
- **Criado em**: 2026-09-01
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## T1 — `extractProvenance` (motor puro) + `SqliteProvenanceStore` + CLI
|
|
11
|
+
- **Owner**: worker
|
|
12
|
+
- **Estimativa**: M
|
|
13
|
+
- **Depende de**: —
|
|
14
|
+
- **Paths**: `packages/engineering/provenance/src/index.ts`, `packages/adapter-sqlite/src/index.ts`,
|
|
15
|
+
`scripts/provenance.ts`, `lib/core/registry.ts`
|
|
16
|
+
- **Done quando**:
|
|
17
|
+
- [ ] `extractProvenance` mapeia `RuntimeRun.changedFiles` → `ProvenanceRecord[]`, `lines`
|
|
18
|
+
sempre `undefined` (AC-2)
|
|
19
|
+
- [ ] `provenance:record <run-id>` lê o run real (`SqliteRuntimeRunStore.get`), persiste via
|
|
20
|
+
`SqliteProvenanceStore` (zero migration nova)
|
|
21
|
+
- [ ] `blame <file>` / `sbom [--json]` funcionais
|
|
22
|
+
- [ ] `forja tools:doctor` continua verde
|
|
23
|
+
- [ ] testes unitários de `extractProvenance` (sem `fs`/rede)
|
|
24
|
+
|
|
25
|
+
## T2 — prova sobre dado real/sintético documentado
|
|
26
|
+
- **Owner**: worker
|
|
27
|
+
- **Estimativa**: P
|
|
28
|
+
- **Depende de**: T1
|
|
29
|
+
- **Paths**: `test/provenance-cli.test.js` (novo)
|
|
30
|
+
- **Done quando**:
|
|
31
|
+
- [ ] fixture isolada: seed de 1+ `RuntimeRun` (sintético documentado como tal, §8 do spec),
|
|
32
|
+
`provenance:record` + `blame` + `sbom` ponta a ponta
|
|
33
|
+
- [ ] `blame` de um arquivo nunca tocado devolve vazio, não erro
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Handoffs entre agentes
|
|
38
|
+
|
|
39
|
+
T1 → T2 sequencial. Sem handoff de papel.
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# Plan: Architecture Constitution — ADRs como regras executáveis
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-09-01
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem técnica
|
|
8
|
+
|
|
9
|
+
Novo bounded context `packages/engineering/architecture` (autorizado por ADR-0078), puro domínio
|
|
10
|
+
(sem `fs`/rede — só parsing de string e comparação de listas), consumido por um script CLI
|
|
11
|
+
(`scripts/architecture.ts`) que faz a ponte com `fs` (ler ADRs) e `GraphLoop` (ler arestas
|
|
12
|
+
`DEPENDS_ON` reais). Vocabulário de frase reconhecida é pequeno e fixo (3 padrões: proibir
|
|
13
|
+
import, exigir dependência, proibir dependência) — qualquer linha de `## Constraints` fora desse
|
|
14
|
+
vocabulário vira regra `proposed` com `confidence < 1`, nunca `active` (AC-1).
|
|
15
|
+
|
|
16
|
+
## 2. Módulos afetados
|
|
17
|
+
|
|
18
|
+
| Caminho | Mudança | Risco |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| `packages/engineering/architecture/src/index.ts` | novo — `parseConstraintLine`, `compileConstitution`, `checkConstitution`, `explainRule` | Médio — lógica nova, mas pura/testável |
|
|
21
|
+
| `scripts/architecture.ts` | novo — `architecture:compile/check/status/explain/approve` | Baixo — I/O fino sobre o engine puro |
|
|
22
|
+
| `lib/core/registry.ts` | 5 comandos novos | Baixo |
|
|
23
|
+
| `packages/policy` (não muda código) — `ApprovalLedger` reaproveitado por `architecture:approve` | leitura/escrita via API já existente | Baixo |
|
|
24
|
+
| `memory/90-decisions/0078-*.md` | ganha `## Constraints` real (1 regra) — primeira prova de que o parser funciona sobre dado real do próprio repositório | — |
|
|
25
|
+
| `test/architecture-constitution.test.js` (novo) | testes do parser + compile + check (incluindo violação injetada em unidade, não em arquivo real) | — |
|
|
26
|
+
|
|
27
|
+
## 3. Diagrama de fluxo
|
|
28
|
+
|
|
29
|
+
```text
|
|
30
|
+
memory/90-decisions/*.md (## Constraints)
|
|
31
|
+
│
|
|
32
|
+
▼
|
|
33
|
+
parseConstraintLine (determinístico, vocabulário fixo)
|
|
34
|
+
│
|
|
35
|
+
▼
|
|
36
|
+
compileConstitution ──► .context/architecture/constitution.json (versionado em git)
|
|
37
|
+
│
|
|
38
|
+
▼
|
|
39
|
+
checkConstitution (recebe rules + edges DEPENDS_ON já extraídas pelo GraphLoop existente)
|
|
40
|
+
│
|
|
41
|
+
▼
|
|
42
|
+
ArchitectureCheckReport (compliant/violations, severidade, remediação sugerida)
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## 4. Contratos (API/CLI/Schema)
|
|
46
|
+
|
|
47
|
+
```ts
|
|
48
|
+
// packages/engineering/architecture/src/index.ts
|
|
49
|
+
export type ArchitectureConstraintKind = 'forbid_import' | 'require_dependency' | 'forbid_dependency';
|
|
50
|
+
export interface ArchitectureConstraint { readonly kind: ArchitectureConstraintKind; readonly target: string; }
|
|
51
|
+
export interface ArchitectureRule {
|
|
52
|
+
readonly id: string;
|
|
53
|
+
readonly source: string; // ex.: 'memory/90-decisions/0078-....md'
|
|
54
|
+
readonly status: 'active' | 'proposed';
|
|
55
|
+
readonly scope: { readonly paths: readonly string[] };
|
|
56
|
+
readonly constraint: ArchitectureConstraint;
|
|
57
|
+
readonly severity: 'info' | 'low' | 'medium' | 'high' | 'critical';
|
|
58
|
+
readonly rationale: string; // texto original da linha
|
|
59
|
+
readonly confidence: number; // 1 = padrão reconhecido; < 1 = ambíguo, fica proposed
|
|
60
|
+
}
|
|
61
|
+
export interface DependencyEdge { readonly fromPath: string; readonly targetLabel: string; }
|
|
62
|
+
export interface ArchitectureViolation { readonly ruleId: string; readonly severity: ArchitectureRule['severity']; readonly file: string; readonly target: string; readonly source: string; readonly remediation: string; }
|
|
63
|
+
export interface ArchitectureCheckReport { readonly compliant: number; readonly violations: readonly ArchitectureViolation[]; }
|
|
64
|
+
|
|
65
|
+
export function parseConstraintLine(line: string): { constraint: ArchitectureConstraint; scopeRaw: string; confidence: number } | undefined;
|
|
66
|
+
export function compileConstitution(adrs: readonly { source: string; content: string }[]): readonly ArchitectureRule[];
|
|
67
|
+
export function checkConstitution(rules: readonly ArchitectureRule[], edges: readonly DependencyEdge[]): ArchitectureCheckReport;
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
architecture:compile
|
|
72
|
+
architecture:check
|
|
73
|
+
architecture:status
|
|
74
|
+
architecture:explain <rule-id>
|
|
75
|
+
architecture:approve <rule-id>
|
|
76
|
+
```
|
|
77
|
+
(sem prefixo `forja` — nenhum existe ainda, mesma convenção já usada em SPEC-032/doc de arquitetura)
|
|
78
|
+
|
|
79
|
+
## 5. Decisões e alternativas
|
|
80
|
+
|
|
81
|
+
**D1**: `ArchitectureRule`/`ArchitectureConstraint` vivem em `packages/engineering/architecture`,
|
|
82
|
+
não em `packages/contracts`. O documento de arquitetura original (§6) sugeriu `packages/contracts`
|
|
83
|
+
— revisado aqui: nenhum outro pacote hoje precisa desses tipos além do próprio engine de
|
|
84
|
+
arquitetura e seu adapter CLI; colocá-los no contracts compartilhado cedo demais repetiria o erro
|
|
85
|
+
que ADR-0078 já evita para o pacote como um todo (acoplamento prematuro). Revisitar se
|
|
86
|
+
`packages/engineering/risk` (SPEC-034) precisar do mesmo vocabulário.
|
|
87
|
+
|
|
88
|
+
**D2**: vocabulário de frase fixo em português, 3 padrões (`não depende de` / `usa` / `não
|
|
89
|
+
acessa`), scope e target devem conter `/` (parecer caminho) para confidence=1. Alternativa
|
|
90
|
+
rejeitada: NLP/heurística mais permissiva — rejeitada explicitamente por AC-1 e pelo risco #1 do
|
|
91
|
+
spec (falso positivo em massa).
|
|
92
|
+
|
|
93
|
+
## 6. Dependências
|
|
94
|
+
|
|
95
|
+
- SPEC-032 (nós ADR com `documentStatus`) — usado por `architecture:status` para não compilar
|
|
96
|
+
regra de ADR `superseded`/`deprecated` (verificação leve, não bloqueante se o dado não estiver
|
|
97
|
+
disponível).
|
|
98
|
+
- `packages/policy.ApprovalLedger` — reaproveitado por `architecture:approve`.
|
|
99
|
+
|
|
100
|
+
## 7. Rollout
|
|
101
|
+
|
|
102
|
+
- [ ] Feature flag necessária? Não — comando novo, opt-in por natureza (ninguém chama sem saber).
|
|
103
|
+
- [ ] Migração de dados existentes? Não.
|
|
104
|
+
- [ ] Doc/persona impactada? README (comandos novos), `docs/architecture/`.
|
|
105
|
+
|
|
106
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
107
|
+
|
|
108
|
+
Já registrado no `plan.md`-equivalente da spec master (`specs/engineering-intelligence/spec.md`,
|
|
109
|
+
apêndice): mais falso-positivo que sinal real sobre este próprio repositório após o Sprint 1
|
|
110
|
+
manda redesenhar o motor antes de avançar.
|