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
|
@@ -1,47 +1,47 @@
|
|
|
1
|
-
# Design Brief
|
|
2
|
-
|
|
3
|
-
- **Feature/superficie**: <ex: dashboard operacional, agent console, docs>
|
|
4
|
-
- **Persona principal**: <quem usa e em que contexto>
|
|
5
|
-
- **Objetivo da UI**: <decisao/acao que a tela precisa facilitar>
|
|
6
|
-
- **Referencia primaria**: <marca/pasta em design-md + motivo>
|
|
7
|
-
- **Referencias secundarias**: <opcional>
|
|
8
|
-
- **Densidade**: baixa | media | alta
|
|
9
|
-
- **Tom visual**: utilitario | premium | editorial | tecnico | colaborativo
|
|
10
|
-
|
|
11
|
-
## Principios aplicados
|
|
12
|
-
|
|
13
|
-
- <principio 1 vindo da referencia>
|
|
14
|
-
- <principio 2>
|
|
15
|
-
- <principio 3>
|
|
16
|
-
|
|
17
|
-
## Tokens visuais
|
|
18
|
-
|
|
19
|
-
- **Cores**: <paleta funcional, nao apenas estetica>
|
|
20
|
-
- **Tipografia**: <escala, peso, uso em headings/body/labels>
|
|
21
|
-
- **Espacamento**: <ritmo e grid>
|
|
22
|
-
- **Raios/bordas/sombras**: <restricoes>
|
|
23
|
-
- **Iconografia**: <familia e regras de uso>
|
|
24
|
-
|
|
25
|
-
## Componentes esperados
|
|
26
|
-
|
|
27
|
-
- <componente 1>
|
|
28
|
-
- <componente 2>
|
|
29
|
-
- <componente 3>
|
|
30
|
-
|
|
31
|
-
## Estados obrigatorios
|
|
32
|
-
|
|
33
|
-
- [ ] Carregando
|
|
34
|
-
- [ ] Vazio
|
|
35
|
-
- [ ] Erro
|
|
36
|
-
- [ ] Sucesso
|
|
37
|
-
- [ ] Permissao/sem acesso, se aplicavel
|
|
38
|
-
- [ ] Responsivo mobile, se aplicavel
|
|
39
|
-
|
|
40
|
-
## Criterios de aceite visual
|
|
41
|
-
|
|
42
|
-
- [ ] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
|
|
43
|
-
- [ ] Texto nao quebra nem sobrepoe em mobile e desktop.
|
|
44
|
-
- [ ] A hierarquia deixa clara a proxima acao do usuario.
|
|
45
|
-
- [ ] Estados obrigatorios existem e sao coerentes.
|
|
46
|
-
- [ ] A UI pode ser validada por screenshot ou checklist objetivo.
|
|
47
|
-
|
|
1
|
+
# Design Brief
|
|
2
|
+
|
|
3
|
+
- **Feature/superficie**: <ex: dashboard operacional, agent console, docs>
|
|
4
|
+
- **Persona principal**: <quem usa e em que contexto>
|
|
5
|
+
- **Objetivo da UI**: <decisao/acao que a tela precisa facilitar>
|
|
6
|
+
- **Referencia primaria**: <marca/pasta em design-md + motivo>
|
|
7
|
+
- **Referencias secundarias**: <opcional>
|
|
8
|
+
- **Densidade**: baixa | media | alta
|
|
9
|
+
- **Tom visual**: utilitario | premium | editorial | tecnico | colaborativo
|
|
10
|
+
|
|
11
|
+
## Principios aplicados
|
|
12
|
+
|
|
13
|
+
- <principio 1 vindo da referencia>
|
|
14
|
+
- <principio 2>
|
|
15
|
+
- <principio 3>
|
|
16
|
+
|
|
17
|
+
## Tokens visuais
|
|
18
|
+
|
|
19
|
+
- **Cores**: <paleta funcional, nao apenas estetica>
|
|
20
|
+
- **Tipografia**: <escala, peso, uso em headings/body/labels>
|
|
21
|
+
- **Espacamento**: <ritmo e grid>
|
|
22
|
+
- **Raios/bordas/sombras**: <restricoes>
|
|
23
|
+
- **Iconografia**: <familia e regras de uso>
|
|
24
|
+
|
|
25
|
+
## Componentes esperados
|
|
26
|
+
|
|
27
|
+
- <componente 1>
|
|
28
|
+
- <componente 2>
|
|
29
|
+
- <componente 3>
|
|
30
|
+
|
|
31
|
+
## Estados obrigatorios
|
|
32
|
+
|
|
33
|
+
- [ ] Carregando
|
|
34
|
+
- [ ] Vazio
|
|
35
|
+
- [ ] Erro
|
|
36
|
+
- [ ] Sucesso
|
|
37
|
+
- [ ] Permissao/sem acesso, se aplicavel
|
|
38
|
+
- [ ] Responsivo mobile, se aplicavel
|
|
39
|
+
|
|
40
|
+
## Criterios de aceite visual
|
|
41
|
+
|
|
42
|
+
- [ ] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
|
|
43
|
+
- [ ] Texto nao quebra nem sobrepoe em mobile e desktop.
|
|
44
|
+
- [ ] A hierarquia deixa clara a proxima acao do usuario.
|
|
45
|
+
- [ ] Estados obrigatorios existem e sao coerentes.
|
|
46
|
+
- [ ] A UI pode ser validada por screenshot ou checklist objetivo.
|
|
47
|
+
|
package/design-md/INDEX.md
CHANGED
|
@@ -1,35 +1,35 @@
|
|
|
1
|
-
# Biblioteca de Design (design-md)
|
|
2
|
-
|
|
3
|
-
Camada operacional de design do fluxo GSD: garante que toda feature com impacto
|
|
4
|
-
visual passe por **referência escolhida → brief preenchido → gate validado**,
|
|
5
|
-
em vez de "faz uma UI aí".
|
|
6
|
-
|
|
7
|
-
## Como funciona
|
|
8
|
-
|
|
9
|
-
1. **Escolha a referência** por superfície: [MATRIX.md](./MATRIX.md) mapeia
|
|
10
|
-
superfícies (agent console, dashboard, docs, landing…) para nomes de
|
|
11
|
-
referência (`linear.app`, `stripe`, `vercel`…). Os nomes são **vocabulário
|
|
12
|
-
compartilhado** entre agentes — apontam para produtos publicamente
|
|
13
|
-
conhecidos, não para cópias locais.
|
|
14
|
-
2. **Preencha o brief**: [BRIEF-TEMPLATE.md](./BRIEF-TEMPLATE.md) é obrigatório
|
|
15
|
-
para features com impacto visual (9 campos, incluindo estados e critérios
|
|
16
|
-
de aceite visual).
|
|
17
|
-
3. **Valide antes do handoff**: `forja design:check <brief.md>` reprova brief
|
|
18
|
-
incompleto; `gsd:check` puxa esse gate quando há brief.
|
|
19
|
-
|
|
20
|
-
```bash
|
|
21
|
-
npm run design:select -- agent-console tecnico # sugere referências pela MATRIX
|
|
22
|
-
npm run design:check -- <caminho-do-brief.md> # gate de completude
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
Regras de uso por agentes e checklist de handoff visual: [PLAYBOOK.md](./PLAYBOOK.md).
|
|
26
|
-
Exemplo de brief preenchido: [examples/agent-console-brief.md](./examples/agent-console-brief.md).
|
|
27
|
-
|
|
28
|
-
## Cache local de referências (opcional)
|
|
29
|
-
|
|
30
|
-
Detalhes de cada sistema de design (tokens, componentes, padrões) podem ser
|
|
31
|
-
mantidos como cache local em `design-md/<nome>/README.md` + `design.manifest.json`.
|
|
32
|
-
O harness degrada graciosamente sem eles: `design:select` indica "sem cache
|
|
33
|
-
local" e o agente usa o conhecimento público da referência.
|
|
34
|
-
|
|
35
|
-
> Nunca copie identidade visual proprietária — referência é direção, não clone.
|
|
1
|
+
# Biblioteca de Design (design-md)
|
|
2
|
+
|
|
3
|
+
Camada operacional de design do fluxo GSD: garante que toda feature com impacto
|
|
4
|
+
visual passe por **referência escolhida → brief preenchido → gate validado**,
|
|
5
|
+
em vez de "faz uma UI aí".
|
|
6
|
+
|
|
7
|
+
## Como funciona
|
|
8
|
+
|
|
9
|
+
1. **Escolha a referência** por superfície: [MATRIX.md](./MATRIX.md) mapeia
|
|
10
|
+
superfícies (agent console, dashboard, docs, landing…) para nomes de
|
|
11
|
+
referência (`linear.app`, `stripe`, `vercel`…). Os nomes são **vocabulário
|
|
12
|
+
compartilhado** entre agentes — apontam para produtos publicamente
|
|
13
|
+
conhecidos, não para cópias locais.
|
|
14
|
+
2. **Preencha o brief**: [BRIEF-TEMPLATE.md](./BRIEF-TEMPLATE.md) é obrigatório
|
|
15
|
+
para features com impacto visual (9 campos, incluindo estados e critérios
|
|
16
|
+
de aceite visual).
|
|
17
|
+
3. **Valide antes do handoff**: `forja design:check <brief.md>` reprova brief
|
|
18
|
+
incompleto; `gsd:check` puxa esse gate quando há brief.
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npm run design:select -- agent-console tecnico # sugere referências pela MATRIX
|
|
22
|
+
npm run design:check -- <caminho-do-brief.md> # gate de completude
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Regras de uso por agentes e checklist de handoff visual: [PLAYBOOK.md](./PLAYBOOK.md).
|
|
26
|
+
Exemplo de brief preenchido: [examples/agent-console-brief.md](./examples/agent-console-brief.md).
|
|
27
|
+
|
|
28
|
+
## Cache local de referências (opcional)
|
|
29
|
+
|
|
30
|
+
Detalhes de cada sistema de design (tokens, componentes, padrões) podem ser
|
|
31
|
+
mantidos como cache local em `design-md/<nome>/README.md` + `design.manifest.json`.
|
|
32
|
+
O harness degrada graciosamente sem eles: `design:select` indica "sem cache
|
|
33
|
+
local" e o agente usa o conhecimento público da referência.
|
|
34
|
+
|
|
35
|
+
> Nunca copie identidade visual proprietária — referência é direção, não clone.
|
package/design-md/MATRIX.md
CHANGED
|
@@ -1,24 +1,24 @@
|
|
|
1
|
-
# Matriz de Referencias design-md
|
|
2
|
-
|
|
3
|
-
Use esta matriz para escolher referencias por tipo de superficie. Ela nao substitui o julgamento do designer/agente; ela reduz escolhas aleatorias.
|
|
4
|
-
|
|
5
|
-
| Superficie | Primarias recomendadas | Secundarias uteis | Evitar |
|
|
6
|
-
|---|---|---|---|
|
|
7
|
-
| Agent console / ops | linear.app, cursor, raycast | sentry, posthog, claude | visual de landing ou excesso decorativo |
|
|
8
|
-
| Dashboard executivo | stripe, linear.app, posthog | airbnb, sentry, supabase | cards gigantes sem densidade informacional |
|
|
9
|
-
| Docs / developer portal | mintlify, stripe, vercel | resend, supabase, hashicorp | layouts promocionais que escondem exemplos |
|
|
10
|
-
| SaaS operacional / CRM | linear.app, intercom, airtable | clay, notion, zapier | paleta de uma cor so e baixa densidade |
|
|
11
|
-
| Landing de produto tecnico | vercel, stripe, resend | cursor, x.ai, cohere | hero abstrato sem produto real |
|
|
12
|
-
| Ferramenta colaborativa | figma, miro, notion | cal, airtable, intercom | navegacao escondida ou comandos ambiguos |
|
|
13
|
-
| IA / agent workflow | claude, cursor, x.ai | mistral.ai, together.ai, cohere | magia visual sem rastreabilidade de execucao |
|
|
14
|
-
| Fintech / trust | wise, revolut, coinbase | stripe, kraken | linguagem visual agressiva sem confianca |
|
|
15
|
-
| Premium / marca forte | apple, bmw, ferrari | tesla, lamborghini, spacex | copiar identidade visual proprietaria |
|
|
16
|
-
| Observabilidade / incidentes | sentry, posthog, datadog-style local se existir | linear.app, stripe | esconder erros em UI decorativa |
|
|
17
|
-
|
|
18
|
-
## Heuristica rapida
|
|
19
|
-
|
|
20
|
-
- Se a tela sera usada muitas vezes por dia, escolha referencias de produtividade: `linear.app`, `raycast`, `cursor`.
|
|
21
|
-
- Se a tela precisa ensinar ou vender uma API, escolha docs/devtools: `mintlify`, `stripe`, `vercel`.
|
|
22
|
-
- Se a tela precisa passar confianca, escolha sistemas com clareza financeira/operacional: `wise`, `stripe`, `sentry`.
|
|
23
|
-
- Se a tela e para agentes, sempre inclua rastreabilidade: fila, status, logs, handoffs e criterio de aceite visivel.
|
|
24
|
-
|
|
1
|
+
# Matriz de Referencias design-md
|
|
2
|
+
|
|
3
|
+
Use esta matriz para escolher referencias por tipo de superficie. Ela nao substitui o julgamento do designer/agente; ela reduz escolhas aleatorias.
|
|
4
|
+
|
|
5
|
+
| Superficie | Primarias recomendadas | Secundarias uteis | Evitar |
|
|
6
|
+
|---|---|---|---|
|
|
7
|
+
| Agent console / ops | linear.app, cursor, raycast | sentry, posthog, claude | visual de landing ou excesso decorativo |
|
|
8
|
+
| Dashboard executivo | stripe, linear.app, posthog | airbnb, sentry, supabase | cards gigantes sem densidade informacional |
|
|
9
|
+
| Docs / developer portal | mintlify, stripe, vercel | resend, supabase, hashicorp | layouts promocionais que escondem exemplos |
|
|
10
|
+
| SaaS operacional / CRM | linear.app, intercom, airtable | clay, notion, zapier | paleta de uma cor so e baixa densidade |
|
|
11
|
+
| Landing de produto tecnico | vercel, stripe, resend | cursor, x.ai, cohere | hero abstrato sem produto real |
|
|
12
|
+
| Ferramenta colaborativa | figma, miro, notion | cal, airtable, intercom | navegacao escondida ou comandos ambiguos |
|
|
13
|
+
| IA / agent workflow | claude, cursor, x.ai | mistral.ai, together.ai, cohere | magia visual sem rastreabilidade de execucao |
|
|
14
|
+
| Fintech / trust | wise, revolut, coinbase | stripe, kraken | linguagem visual agressiva sem confianca |
|
|
15
|
+
| Premium / marca forte | apple, bmw, ferrari | tesla, lamborghini, spacex | copiar identidade visual proprietaria |
|
|
16
|
+
| Observabilidade / incidentes | sentry, posthog, datadog-style local se existir | linear.app, stripe | esconder erros em UI decorativa |
|
|
17
|
+
|
|
18
|
+
## Heuristica rapida
|
|
19
|
+
|
|
20
|
+
- Se a tela sera usada muitas vezes por dia, escolha referencias de produtividade: `linear.app`, `raycast`, `cursor`.
|
|
21
|
+
- Se a tela precisa ensinar ou vender uma API, escolha docs/devtools: `mintlify`, `stripe`, `vercel`.
|
|
22
|
+
- Se a tela precisa passar confianca, escolha sistemas com clareza financeira/operacional: `wise`, `stripe`, `sentry`.
|
|
23
|
+
- Se a tela e para agentes, sempre inclua rastreabilidade: fila, status, logs, handoffs e criterio de aceite visivel.
|
|
24
|
+
|
package/design-md/PLAYBOOK.md
CHANGED
|
@@ -1,35 +1,35 @@
|
|
|
1
|
-
# Design Playbook para Agentes
|
|
2
|
-
|
|
3
|
-
Este playbook transforma `design-md/` em entrada operacional para Product, Frontend, SDD Architect e Governance. A pasta de marcas continua sendo biblioteca de referencia; este arquivo define como escolher, aplicar e auditar uma direcao visual sem depender de memoria solta.
|
|
4
|
-
|
|
5
|
-
## Quando usar
|
|
6
|
-
|
|
7
|
-
- Antes de criar uma tela nova, componente critico, dashboard ou landing.
|
|
8
|
-
- Durante `spec.md`, quando a experiencia visual influencia conversao, confianca ou produtividade.
|
|
9
|
-
- Antes de merge/release, quando Governance precisa auditar fidelidade visual.
|
|
10
|
-
|
|
11
|
-
## Fluxo minimo
|
|
12
|
-
|
|
13
|
-
1. Defina a superficie: `dashboard`, `docs`, `landing`, `tool`, `mobile`, `checkout`, `agent-console`.
|
|
14
|
-
2. Escolha 1 referencia primaria e ate 2 secundarias em `MATRIX.md`.
|
|
15
|
-
3. Preencha `BRIEF-TEMPLATE.md` para o contexto da feature.
|
|
16
|
-
4. Anexe o brief ao handoff de implementacao.
|
|
17
|
-
5. Governance valida com `npm run design:check -- <brief.md>`.
|
|
18
|
-
|
|
19
|
-
## Regras para agentes
|
|
20
|
-
|
|
21
|
-
- Nunca copie marca, logo, texto proprietario ou identidade visual completa.
|
|
22
|
-
- Use referencias como principios: densidade, ritmo, hierarquia, tom, navegacao, estados e padroes de interacao.
|
|
23
|
-
- Para SaaS, CRM, ops e dashboards: priorize legibilidade, densidade organizada e estados claros.
|
|
24
|
-
- Para landing: a primeira dobra deve comunicar objeto/oferta real, nao apenas estilo abstrato.
|
|
25
|
-
- Para ferramentas de agente: prefira affordances explicitas, logs verificaveis, controles previsiveis e feedback de estado.
|
|
26
|
-
|
|
27
|
-
## Checklist de handoff visual
|
|
28
|
-
|
|
29
|
-
- Superficie e persona estao definidos.
|
|
30
|
-
- Referencia primaria tem justificativa clara.
|
|
31
|
-
- Tokens visuais foram definidos: cor, tipografia, raio, espacamento, densidade.
|
|
32
|
-
- Componentes esperados foram listados.
|
|
33
|
-
- Estados obrigatorios foram listados: vazio, carregando, erro, sucesso, permissao negada quando aplicavel.
|
|
34
|
-
- Criterios de aceite visual sao verificaveis por screenshot ou revisao objetiva.
|
|
35
|
-
|
|
1
|
+
# Design Playbook para Agentes
|
|
2
|
+
|
|
3
|
+
Este playbook transforma `design-md/` em entrada operacional para Product, Frontend, SDD Architect e Governance. A pasta de marcas continua sendo biblioteca de referencia; este arquivo define como escolher, aplicar e auditar uma direcao visual sem depender de memoria solta.
|
|
4
|
+
|
|
5
|
+
## Quando usar
|
|
6
|
+
|
|
7
|
+
- Antes de criar uma tela nova, componente critico, dashboard ou landing.
|
|
8
|
+
- Durante `spec.md`, quando a experiencia visual influencia conversao, confianca ou produtividade.
|
|
9
|
+
- Antes de merge/release, quando Governance precisa auditar fidelidade visual.
|
|
10
|
+
|
|
11
|
+
## Fluxo minimo
|
|
12
|
+
|
|
13
|
+
1. Defina a superficie: `dashboard`, `docs`, `landing`, `tool`, `mobile`, `checkout`, `agent-console`.
|
|
14
|
+
2. Escolha 1 referencia primaria e ate 2 secundarias em `MATRIX.md`.
|
|
15
|
+
3. Preencha `BRIEF-TEMPLATE.md` para o contexto da feature.
|
|
16
|
+
4. Anexe o brief ao handoff de implementacao.
|
|
17
|
+
5. Governance valida com `npm run design:check -- <brief.md>`.
|
|
18
|
+
|
|
19
|
+
## Regras para agentes
|
|
20
|
+
|
|
21
|
+
- Nunca copie marca, logo, texto proprietario ou identidade visual completa.
|
|
22
|
+
- Use referencias como principios: densidade, ritmo, hierarquia, tom, navegacao, estados e padroes de interacao.
|
|
23
|
+
- Para SaaS, CRM, ops e dashboards: priorize legibilidade, densidade organizada e estados claros.
|
|
24
|
+
- Para landing: a primeira dobra deve comunicar objeto/oferta real, nao apenas estilo abstrato.
|
|
25
|
+
- Para ferramentas de agente: prefira affordances explicitas, logs verificaveis, controles previsiveis e feedback de estado.
|
|
26
|
+
|
|
27
|
+
## Checklist de handoff visual
|
|
28
|
+
|
|
29
|
+
- Superficie e persona estao definidos.
|
|
30
|
+
- Referencia primaria tem justificativa clara.
|
|
31
|
+
- Tokens visuais foram definidos: cor, tipografia, raio, espacamento, densidade.
|
|
32
|
+
- Componentes esperados foram listados.
|
|
33
|
+
- Estados obrigatorios foram listados: vazio, carregando, erro, sucesso, permissao negada quando aplicavel.
|
|
34
|
+
- Criterios de aceite visual sao verificaveis por screenshot ou revisao objetiva.
|
|
35
|
+
|
|
@@ -1,48 +1,48 @@
|
|
|
1
|
-
# Design Brief
|
|
2
|
-
|
|
3
|
-
- **Feature/superficie**: agent console operacional
|
|
4
|
-
- **Persona principal**: desenvolvedor ou coordenador que acompanha handoffs, contexto e status de agentes durante uma sprint.
|
|
5
|
-
- **Objetivo da UI**: reduzir ambiguidade operacional mostrando fila, dono, aceite, status e proximo comando verificavel.
|
|
6
|
-
- **Referencia primaria**: linear.app, pela densidade organizada, hierarquia clara e foco em produtividade diaria.
|
|
7
|
-
- **Referencias secundarias**: cursor para contexto de IA; sentry para tratamento de estados e incidentes.
|
|
8
|
-
- **Densidade**: alta
|
|
9
|
-
- **Tom visual**: tecnico
|
|
10
|
-
|
|
11
|
-
## Principios aplicados
|
|
12
|
-
|
|
13
|
-
- Navegacao lateral previsivel com conteudo principal orientado a tarefas.
|
|
14
|
-
- Estados de trabalho sempre visiveis: aberto, em andamento, bloqueado, concluido.
|
|
15
|
-
- Cada item acionavel mostra dono, criterio de aceite e proximo passo.
|
|
16
|
-
|
|
17
|
-
## Tokens visuais
|
|
18
|
-
|
|
19
|
-
- **Cores**: neutros claros para fundo, texto de alto contraste, acentos funcionais para status.
|
|
20
|
-
- **Tipografia**: escala compacta, labels menores, headings restritos ao contexto da tela.
|
|
21
|
-
- **Espacamento**: grid de 8px, alta densidade sem sobreposicao.
|
|
22
|
-
- **Raios/bordas/sombras**: raio ate 8px, bordas sutis, sombras apenas para overlays.
|
|
23
|
-
- **Iconografia**: lucide ou equivalente, sempre com tooltip para acoes ambiguas.
|
|
24
|
-
|
|
25
|
-
## Componentes esperados
|
|
26
|
-
|
|
27
|
-
- Lista de handoffs com status e filtros.
|
|
28
|
-
- Painel de detalhe com os 7 campos do ADR-0005.
|
|
29
|
-
- Log de eventos e comandos sugeridos.
|
|
30
|
-
- Indicadores de saude de contexto, design e spec.
|
|
31
|
-
|
|
32
|
-
## Estados obrigatorios
|
|
33
|
-
|
|
34
|
-
- [x] Carregando
|
|
35
|
-
- [x] Vazio
|
|
36
|
-
- [x] Erro
|
|
37
|
-
- [x] Sucesso
|
|
38
|
-
- [x] Permissao/sem acesso, se aplicavel
|
|
39
|
-
- [x] Responsivo mobile, se aplicavel
|
|
40
|
-
|
|
41
|
-
## Criterios de aceite visual
|
|
42
|
-
|
|
43
|
-
- [x] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
|
|
44
|
-
- [x] Texto nao quebra nem sobrepoe em mobile e desktop.
|
|
45
|
-
- [x] A hierarquia deixa clara a proxima acao do usuario.
|
|
46
|
-
- [x] Estados obrigatorios existem e sao coerentes.
|
|
47
|
-
- [x] A UI pode ser validada por screenshot ou checklist objetivo.
|
|
48
|
-
|
|
1
|
+
# Design Brief
|
|
2
|
+
|
|
3
|
+
- **Feature/superficie**: agent console operacional
|
|
4
|
+
- **Persona principal**: desenvolvedor ou coordenador que acompanha handoffs, contexto e status de agentes durante uma sprint.
|
|
5
|
+
- **Objetivo da UI**: reduzir ambiguidade operacional mostrando fila, dono, aceite, status e proximo comando verificavel.
|
|
6
|
+
- **Referencia primaria**: linear.app, pela densidade organizada, hierarquia clara e foco em produtividade diaria.
|
|
7
|
+
- **Referencias secundarias**: cursor para contexto de IA; sentry para tratamento de estados e incidentes.
|
|
8
|
+
- **Densidade**: alta
|
|
9
|
+
- **Tom visual**: tecnico
|
|
10
|
+
|
|
11
|
+
## Principios aplicados
|
|
12
|
+
|
|
13
|
+
- Navegacao lateral previsivel com conteudo principal orientado a tarefas.
|
|
14
|
+
- Estados de trabalho sempre visiveis: aberto, em andamento, bloqueado, concluido.
|
|
15
|
+
- Cada item acionavel mostra dono, criterio de aceite e proximo passo.
|
|
16
|
+
|
|
17
|
+
## Tokens visuais
|
|
18
|
+
|
|
19
|
+
- **Cores**: neutros claros para fundo, texto de alto contraste, acentos funcionais para status.
|
|
20
|
+
- **Tipografia**: escala compacta, labels menores, headings restritos ao contexto da tela.
|
|
21
|
+
- **Espacamento**: grid de 8px, alta densidade sem sobreposicao.
|
|
22
|
+
- **Raios/bordas/sombras**: raio ate 8px, bordas sutis, sombras apenas para overlays.
|
|
23
|
+
- **Iconografia**: lucide ou equivalente, sempre com tooltip para acoes ambiguas.
|
|
24
|
+
|
|
25
|
+
## Componentes esperados
|
|
26
|
+
|
|
27
|
+
- Lista de handoffs com status e filtros.
|
|
28
|
+
- Painel de detalhe com os 7 campos do ADR-0005.
|
|
29
|
+
- Log de eventos e comandos sugeridos.
|
|
30
|
+
- Indicadores de saude de contexto, design e spec.
|
|
31
|
+
|
|
32
|
+
## Estados obrigatorios
|
|
33
|
+
|
|
34
|
+
- [x] Carregando
|
|
35
|
+
- [x] Vazio
|
|
36
|
+
- [x] Erro
|
|
37
|
+
- [x] Sucesso
|
|
38
|
+
- [x] Permissao/sem acesso, se aplicavel
|
|
39
|
+
- [x] Responsivo mobile, se aplicavel
|
|
40
|
+
|
|
41
|
+
## Criterios de aceite visual
|
|
42
|
+
|
|
43
|
+
- [x] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
|
|
44
|
+
- [x] Texto nao quebra nem sobrepoe em mobile e desktop.
|
|
45
|
+
- [x] A hierarquia deixa clara a proxima acao do usuario.
|
|
46
|
+
- [x] Estados obrigatorios existem e sao coerentes.
|
|
47
|
+
- [x] A UI pode ser validada por screenshot ou checklist objetivo.
|
|
48
|
+
|
|
@@ -1,11 +1,18 @@
|
|
|
1
1
|
// @ts-expect-error Next resolves the adjacent TypeScript helper.
|
|
2
2
|
import { buildApprovalDecisionBody } from '../approval';
|
|
3
|
+
// @ts-expect-error Next resolves the adjacent TypeScript helper.
|
|
4
|
+
import { isCallerAuthorized, matchesAllowedPrefix } from '../guard';
|
|
3
5
|
const allowedPrefixes = ['/control-plane/metrics', '/observability/observations', '/events/stream', '/executions/', '/graph/query', '/graph/impact', '/approvals'];
|
|
4
6
|
export async function GET(request, context) { return forward(request, await context.params, 'GET'); }
|
|
5
7
|
export async function POST(request, context) { return forward(request, await context.params, 'POST'); }
|
|
6
8
|
async function forward(request, params, method) {
|
|
9
|
+
// Fails closed: without FORJA_DASHBOARD_TOKEN configured, or without the caller presenting it,
|
|
10
|
+
// this route refuses every request rather than silently forwarding the server's own backend
|
|
11
|
+
// credential (FORJA_API_TOKEN, below) on an unauthenticated caller's behalf.
|
|
12
|
+
if (!isCallerAuthorized(request))
|
|
13
|
+
return new Response(JSON.stringify({ error: { code: 'FORBIDDEN', message: 'Dashboard caller authentication required' } }), { status: 403, headers: { 'content-type': 'application/json' } });
|
|
7
14
|
const path = `/${params.path.join('/')}`;
|
|
8
|
-
if (!allowedPrefixes.some((prefix) => path
|
|
15
|
+
if (!allowedPrefixes.some((prefix) => matchesAllowedPrefix(path, prefix)))
|
|
9
16
|
return new Response(JSON.stringify({ error: { code: 'FORBIDDEN', message: 'Dashboard route is not allowed' } }), { status: 403, headers: { 'content-type': 'application/json' } });
|
|
10
17
|
const backend = process.env.FORJA_API_URL ?? 'http://localhost:3000';
|
|
11
18
|
const token = process.env.FORJA_API_TOKEN;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pure helpers backing the dashboard's `/api/forja/[...path]` proxy route. Kept out of route.ts
|
|
3
|
+
* (which only wires Next's Request/Response) so they're directly unit-testable, same pattern as
|
|
4
|
+
* `approval.ts`.
|
|
5
|
+
*/
|
|
6
|
+
/**
|
|
7
|
+
* True when `pathname` is `prefix` itself or a path segment nested under it. Plain
|
|
8
|
+
* `pathname.startsWith(prefix)` is not enough: it also matches an unrelated sibling like
|
|
9
|
+
* `/control-plane/metrics-extra` against the `/control-plane/metrics` prefix, since string
|
|
10
|
+
* prefixing doesn't respect segment boundaries. `isPathWithinRoot` (packages/contracts) isn't
|
|
11
|
+
* reused here — it resolves inputs as filesystem paths via `path.resolve`, which is the wrong
|
|
12
|
+
* semantics for URL path segments (and platform-dependent via `path.sep`); this applies the same
|
|
13
|
+
* boundary principle directly on `/`, which is always the URL path separator.
|
|
14
|
+
*/
|
|
15
|
+
export declare function matchesAllowedPrefix(pathname: string, prefix: string): boolean;
|
|
16
|
+
/**
|
|
17
|
+
* Authenticates the *caller of this dashboard route*, not the backend it proxies to.
|
|
18
|
+
* FORJA_API_TOKEN (forwarded as a Bearer header below) is the server's own credential to the
|
|
19
|
+
* backend; without this check, anyone who can reach the deployed dashboard gets that credential
|
|
20
|
+
* applied on their behalf, including approval decisions. Fails closed on both ends: an
|
|
21
|
+
* unconfigured FORJA_DASHBOARD_TOKEN means the route refuses every request rather than allowing
|
|
22
|
+
* all of them, and a present-but-non-matching credential is rejected the same way as a missing one.
|
|
23
|
+
*/
|
|
24
|
+
export declare function isCallerAuthorized(request: Request, expectedToken?: string | undefined): boolean;
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pure helpers backing the dashboard's `/api/forja/[...path]` proxy route. Kept out of route.ts
|
|
3
|
+
* (which only wires Next's Request/Response) so they're directly unit-testable, same pattern as
|
|
4
|
+
* `approval.ts`.
|
|
5
|
+
*/
|
|
6
|
+
import { timingSafeEqual } from 'node:crypto';
|
|
7
|
+
/**
|
|
8
|
+
* True when `pathname` is `prefix` itself or a path segment nested under it. Plain
|
|
9
|
+
* `pathname.startsWith(prefix)` is not enough: it also matches an unrelated sibling like
|
|
10
|
+
* `/control-plane/metrics-extra` against the `/control-plane/metrics` prefix, since string
|
|
11
|
+
* prefixing doesn't respect segment boundaries. `isPathWithinRoot` (packages/contracts) isn't
|
|
12
|
+
* reused here — it resolves inputs as filesystem paths via `path.resolve`, which is the wrong
|
|
13
|
+
* semantics for URL path segments (and platform-dependent via `path.sep`); this applies the same
|
|
14
|
+
* boundary principle directly on `/`, which is always the URL path separator.
|
|
15
|
+
*/
|
|
16
|
+
export function matchesAllowedPrefix(pathname, prefix) {
|
|
17
|
+
if (pathname === prefix)
|
|
18
|
+
return true;
|
|
19
|
+
const boundary = prefix.endsWith('/') ? prefix : `${prefix}/`;
|
|
20
|
+
return pathname.startsWith(boundary);
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Authenticates the *caller of this dashboard route*, not the backend it proxies to.
|
|
24
|
+
* FORJA_API_TOKEN (forwarded as a Bearer header below) is the server's own credential to the
|
|
25
|
+
* backend; without this check, anyone who can reach the deployed dashboard gets that credential
|
|
26
|
+
* applied on their behalf, including approval decisions. Fails closed on both ends: an
|
|
27
|
+
* unconfigured FORJA_DASHBOARD_TOKEN means the route refuses every request rather than allowing
|
|
28
|
+
* all of them, and a present-but-non-matching credential is rejected the same way as a missing one.
|
|
29
|
+
*/
|
|
30
|
+
export function isCallerAuthorized(request, expectedToken = process.env.FORJA_DASHBOARD_TOKEN) {
|
|
31
|
+
if (expectedToken === undefined || expectedToken.length === 0)
|
|
32
|
+
return false;
|
|
33
|
+
const header = request.headers.get('x-forja-dashboard-token');
|
|
34
|
+
if (header !== null)
|
|
35
|
+
return constantTimeEqual(header, expectedToken);
|
|
36
|
+
const cookie = readCookie(request.headers.get('cookie'), 'forja_dashboard_token');
|
|
37
|
+
if (cookie !== undefined)
|
|
38
|
+
return constantTimeEqual(cookie, expectedToken);
|
|
39
|
+
return false;
|
|
40
|
+
}
|
|
41
|
+
function constantTimeEqual(left, right) {
|
|
42
|
+
const leftBuffer = Buffer.from(left);
|
|
43
|
+
const rightBuffer = Buffer.from(right);
|
|
44
|
+
return leftBuffer.length === rightBuffer.length && timingSafeEqual(leftBuffer, rightBuffer);
|
|
45
|
+
}
|
|
46
|
+
function readCookie(cookieHeader, name) {
|
|
47
|
+
if (cookieHeader === null)
|
|
48
|
+
return undefined;
|
|
49
|
+
for (const part of cookieHeader.split(';')) {
|
|
50
|
+
const separator = part.indexOf('=');
|
|
51
|
+
if (separator === -1)
|
|
52
|
+
continue;
|
|
53
|
+
if (part.slice(0, separator).trim() !== name)
|
|
54
|
+
continue;
|
|
55
|
+
try {
|
|
56
|
+
return decodeURIComponent(part.slice(separator + 1).trim());
|
|
57
|
+
}
|
|
58
|
+
catch {
|
|
59
|
+
return part.slice(separator + 1).trim();
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
return undefined;
|
|
63
|
+
}
|
|
@@ -39,16 +39,16 @@ export default function DashboardClient() {
|
|
|
39
39
|
}
|
|
40
40
|
}
|
|
41
41
|
const metrics = snapshot.data?.metrics;
|
|
42
|
-
return <>
|
|
43
|
-
<header className="header"><div><p className="eyebrow">FORJAJS 2.0</p><h1>Control Plane</h1><p className="muted">Autonomia supervisionada, evidência e execução auditável.</p></div><button onClick={() => void snapshot.refetch()} disabled={snapshot.isFetching}>{snapshot.isFetching ? 'Atualizando…' : 'Atualizar'}</button></header>
|
|
44
|
-
{(error !== undefined || snapshot.error !== null) && <div className="alert" role="alert">{error ?? 'Control Plane indisponível'}</div>}
|
|
45
|
-
<section className="grid" aria-label="Métricas operacionais"><Metric label="Execuções" value={metrics?.runCount ?? 0}/><Metric label="Taxa de sucesso" value={`${((metrics?.successRate ?? 0) * 100).toFixed(1)}%`}/><Metric label="Tokens de entrada" value={metrics?.totalInputTokens ?? 0}/><Metric label="Observações" value={metrics?.observationCount ?? 0}/></section>
|
|
46
|
-
<section className="panel"><div className="panel-title"><h2>GraphLoop</h2><span className="muted">nós com origem no backend</span></div><div className="graph-controls"><input aria-label="ID do nó de impacto" value={impactOrigin} onChange={(event) => setImpactOrigin(event.target.value)} placeholder="ID do nó para impacto"/><button onClick={() => void impact.refetch()} disabled={impactOrigin.trim().length === 0}>Calcular impacto</button></div><div className="graph-grid">{snapshot.data?.graphNodes.slice(0, 12).map((node) => <span key={node.id} className="node"><strong>{node.label}</strong><small>{node.type} · {node.status}</small></span>)}</div>{impact.data !== undefined && <pre className="impact">{JSON.stringify(impact.data, null, 2)}</pre>}</section>
|
|
47
|
-
<section className="panel"><div className="panel-title"><h2>Approvals</h2><span className="muted">identidade configurada no servidor</span></div>{snapshot.data?.approvals.length === 0 && <p className="muted">Nenhuma aprovação registrada.</p>}<ul className="events">{snapshot.data?.approvals.map((approval) => <li key={approval.id}><span className="dot"/><span><strong>{approval.decision ?? 'pending'}</strong> · {approval.action}<small>{approval.impact}</small></span>{approval.decision === undefined && <span className="actions"><button onClick={() => void decideApproval(approval.id, 'approved')}>Aprovar</button><button onClick={() => void decideApproval(approval.id, 'rejected')}>Rejeitar</button></span>}</li>)}</ul></section>
|
|
48
|
-
<section className="panel"><div className="panel-title"><h2>Atividade recente</h2><span className="muted">{snapshot.isFetching ? 'sincronizando' : 'estado remoto'}</span></div>
|
|
49
|
-
{snapshot.data?.observations.length === 0 && <p className="muted">Nenhuma observação registrada.</p>}
|
|
50
|
-
<ul className="events">{snapshot.data?.observations.slice(-8).reverse().map((observation) => <li key={observation.id}><span className={`dot ${observation.outcome}`}/><span><strong>{observation.outcome}</strong> · {observation.capabilityId ?? 'operação do Control Plane'}<small>{observation.traceId}</small></span>{observation.runId !== undefined && <span className="actions"><button onClick={() => void execute(`/executions/${observation.runId}/pause`)}>Pausar</button><button onClick={() => void execute(`/executions/${observation.runId}/cancel`)}>Cancelar</button></span>}</li>)}</ul>
|
|
51
|
-
</section>
|
|
42
|
+
return <>
|
|
43
|
+
<header className="header"><div><p className="eyebrow">FORJAJS 2.0</p><h1>Control Plane</h1><p className="muted">Autonomia supervisionada, evidência e execução auditável.</p></div><button onClick={() => void snapshot.refetch()} disabled={snapshot.isFetching}>{snapshot.isFetching ? 'Atualizando…' : 'Atualizar'}</button></header>
|
|
44
|
+
{(error !== undefined || snapshot.error !== null) && <div className="alert" role="alert">{error ?? 'Control Plane indisponível'}</div>}
|
|
45
|
+
<section className="grid" aria-label="Métricas operacionais"><Metric label="Execuções" value={metrics?.runCount ?? 0}/><Metric label="Taxa de sucesso" value={`${((metrics?.successRate ?? 0) * 100).toFixed(1)}%`}/><Metric label="Tokens de entrada" value={metrics?.totalInputTokens ?? 0}/><Metric label="Observações" value={metrics?.observationCount ?? 0}/></section>
|
|
46
|
+
<section className="panel"><div className="panel-title"><h2>GraphLoop</h2><span className="muted">nós com origem no backend</span></div><div className="graph-controls"><input aria-label="ID do nó de impacto" value={impactOrigin} onChange={(event) => setImpactOrigin(event.target.value)} placeholder="ID do nó para impacto"/><button onClick={() => void impact.refetch()} disabled={impactOrigin.trim().length === 0}>Calcular impacto</button></div><div className="graph-grid">{snapshot.data?.graphNodes.slice(0, 12).map((node) => <span key={node.id} className="node"><strong>{node.label}</strong><small>{node.type} · {node.status}</small></span>)}</div>{impact.data !== undefined && <pre className="impact">{JSON.stringify(impact.data, null, 2)}</pre>}</section>
|
|
47
|
+
<section className="panel"><div className="panel-title"><h2>Approvals</h2><span className="muted">identidade configurada no servidor</span></div>{snapshot.data?.approvals.length === 0 && <p className="muted">Nenhuma aprovação registrada.</p>}<ul className="events">{snapshot.data?.approvals.map((approval) => <li key={approval.id}><span className="dot"/><span><strong>{approval.decision ?? 'pending'}</strong> · {approval.action}<small>{approval.impact}</small></span>{approval.decision === undefined && <span className="actions"><button onClick={() => void decideApproval(approval.id, 'approved')}>Aprovar</button><button onClick={() => void decideApproval(approval.id, 'rejected')}>Rejeitar</button></span>}</li>)}</ul></section>
|
|
48
|
+
<section className="panel"><div className="panel-title"><h2>Atividade recente</h2><span className="muted">{snapshot.isFetching ? 'sincronizando' : 'estado remoto'}</span></div>
|
|
49
|
+
{snapshot.data?.observations.length === 0 && <p className="muted">Nenhuma observação registrada.</p>}
|
|
50
|
+
<ul className="events">{snapshot.data?.observations.slice(-8).reverse().map((observation) => <li key={observation.id}><span className={`dot ${observation.outcome}`}/><span><strong>{observation.outcome}</strong> · {observation.capabilityId ?? 'operação do Control Plane'}<small>{observation.traceId}</small></span>{observation.runId !== undefined && <span className="actions"><button onClick={() => void execute(`/executions/${observation.runId}/pause`)}>Pausar</button><button onClick={() => void execute(`/executions/${observation.runId}/cancel`)}>Cancelar</button></span>}</li>)}</ul>
|
|
51
|
+
</section>
|
|
52
52
|
</>;
|
|
53
53
|
}
|
|
54
54
|
async function loadSnapshot() {
|
|
@@ -13,7 +13,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
|
|
|
13
13
|
var ForjaNestModule_1;
|
|
14
14
|
import { Controller, Get, Global, Inject, Injectable, Module, Optional, Post, Req, Res, Sse, UnauthorizedException, UseGuards } from '@nestjs/common';
|
|
15
15
|
import { Observable as RxObservable } from 'rxjs';
|
|
16
|
-
import { ForjaNestAdapter } from "../../../packages/adapter-nest/src/index.js";
|
|
16
|
+
import { ForjaNestAdapter, isLoopbackAddress } from "../../../packages/adapter-nest/src/index.js";
|
|
17
17
|
export const FORJA_MCP = Symbol('FORJA_MCP');
|
|
18
18
|
export const FORJA_EVENT_STREAM = Symbol('FORJA_EVENT_STREAM');
|
|
19
19
|
export const FORJA_AUTHENTICATOR = Symbol('FORJA_AUTHENTICATOR');
|
|
@@ -25,9 +25,14 @@ let ForjaLocalAuthGuard = class ForjaLocalAuthGuard {
|
|
|
25
25
|
authenticator;
|
|
26
26
|
constructor(authenticator) { this.authenticator = authenticator; }
|
|
27
27
|
async canActivate(context) {
|
|
28
|
-
if (this.authenticator === undefined)
|
|
29
|
-
return true;
|
|
30
28
|
const request = context.switchToHttp().getRequest();
|
|
29
|
+
if (this.authenticator === undefined) {
|
|
30
|
+
// Fail closed, not open: no FORJA_AUTH_TOKEN configured means loopback-only, not allow-all —
|
|
31
|
+
// otherwise a port-forward or container-network hop reaches this server fully unauthenticated.
|
|
32
|
+
if (isLoopbackAddress(request.socket?.remoteAddress))
|
|
33
|
+
return true;
|
|
34
|
+
throw new UnauthorizedException('Local authentication required (no FORJA_AUTH_TOKEN configured; only loopback requests are allowed)');
|
|
35
|
+
}
|
|
31
36
|
if (await this.authenticator.authenticate(headers(request)))
|
|
32
37
|
return true;
|
|
33
38
|
throw new UnauthorizedException('Local authentication required');
|
|
@@ -80,7 +85,7 @@ let ForjaNestController = class ForjaNestController {
|
|
|
80
85
|
});
|
|
81
86
|
}
|
|
82
87
|
async route(request, response, method, path, body) {
|
|
83
|
-
const result = await this.adapter.handle({ method, path, query: request.query, body, headers: headers(request), correlationId: this.correlation(request) });
|
|
88
|
+
const result = await this.adapter.handle({ method, path, query: request.query, body, headers: headers(request), correlationId: this.correlation(request), remoteAddress: request.socket?.remoteAddress });
|
|
84
89
|
response.status(result.status);
|
|
85
90
|
for (const [key, value] of Object.entries(result.headers))
|
|
86
91
|
response.setHeader(key, value);
|
|
@@ -146,10 +146,19 @@ export async function bootstrap(port = Number(process.env.FORJA_PORT ?? 3000)) {
|
|
|
146
146
|
registerGraphSyncCapability(registry, graph, new GitGraphDocumentSource(process.env.FORJA_GRAPH_ROOT ?? process.cwd(), new SpawnCommandRunner()));
|
|
147
147
|
const context = new ContextEngine({ graph: new GraphContextSource({ searchContext: (objective) => graph.contextRecords(objective) }), cache: new SqliteContextCache(runtimeDatabase) });
|
|
148
148
|
const mcp = createDefaultMcp(registry, policy, graph, mcpAudit, context);
|
|
149
|
-
const
|
|
149
|
+
const authenticator = createLocalAuthenticator();
|
|
150
|
+
if (authenticator === undefined)
|
|
151
|
+
console.warn('[forja] FORJA_AUTH_TOKEN is not set — only loopback (127.0.0.1/::1) requests will be accepted. Set FORJA_AUTH_TOKEN before exposing this server beyond localhost.');
|
|
152
|
+
const app = await NestFactory.create(AppModule.register({ mcp, eventStream, authenticator, controlPlane: createDefaultControlPlane(eventStream, registry, policy, runtimePersistence, approvals, events, graph, context, orchestrationStore, observationStore) }));
|
|
150
153
|
const config = new DocumentBuilder().setTitle('ForjaJS 2.0 API').setDescription('Local-first agent control plane').setVersion('2.0.0').build();
|
|
151
154
|
SwaggerModule.setup('docs', app, SwaggerModule.createDocument(app, config));
|
|
152
155
|
await app.listen(port, '127.0.0.1');
|
|
156
|
+
const shutdown = (signal) => {
|
|
157
|
+
console.log(`[forja] received ${signal}, closing database and shutting down`);
|
|
158
|
+
void app.close().finally(() => { runtimeDatabase.close(); process.exit(0); });
|
|
159
|
+
};
|
|
160
|
+
process.on('SIGINT', shutdown);
|
|
161
|
+
process.on('SIGTERM', shutdown);
|
|
153
162
|
return app;
|
|
154
163
|
}
|
|
155
164
|
if (import.meta.url === `file://${process.argv[1]}`)
|
|
@@ -24,23 +24,23 @@ const __dirname = path.dirname(__filename);
|
|
|
24
24
|
const args = process.argv.slice(2);
|
|
25
25
|
const showHelp = args.includes('--help') || args.includes('-h');
|
|
26
26
|
if (showHelp) {
|
|
27
|
-
console.log(`
|
|
28
|
-
create-memory-nest-kit v0.6.0
|
|
29
|
-
|
|
30
|
-
Uso:
|
|
31
|
-
create-memory-nest-kit [diretorio] [opcoes]
|
|
32
|
-
|
|
33
|
-
Opcoes:
|
|
34
|
-
--force Sobrescreve arquivos existentes
|
|
35
|
-
--only-memory Gera apenas estrutura de memoria/agents/skills
|
|
36
|
-
--no-gitkeep Nao cria .gitkeep em diretorios vazios
|
|
37
|
-
--no-validate Pula validacao apos geracao
|
|
38
|
-
-h, --help Mostra esta ajuda
|
|
39
|
-
|
|
40
|
-
Exemplos:
|
|
41
|
-
node bin/create-memory-nest-kit.js meu-projeto
|
|
42
|
-
node bin/create-memory-nest-kit.js meu-projeto --force
|
|
43
|
-
node bin/create-memory-nest-kit.js meu-projeto --only-memory
|
|
27
|
+
console.log(`
|
|
28
|
+
create-memory-nest-kit v0.6.0
|
|
29
|
+
|
|
30
|
+
Uso:
|
|
31
|
+
create-memory-nest-kit [diretorio] [opcoes]
|
|
32
|
+
|
|
33
|
+
Opcoes:
|
|
34
|
+
--force Sobrescreve arquivos existentes
|
|
35
|
+
--only-memory Gera apenas estrutura de memoria/agents/skills
|
|
36
|
+
--no-gitkeep Nao cria .gitkeep em diretorios vazios
|
|
37
|
+
--no-validate Pula validacao apos geracao
|
|
38
|
+
-h, --help Mostra esta ajuda
|
|
39
|
+
|
|
40
|
+
Exemplos:
|
|
41
|
+
node bin/create-memory-nest-kit.js meu-projeto
|
|
42
|
+
node bin/create-memory-nest-kit.js meu-projeto --force
|
|
43
|
+
node bin/create-memory-nest-kit.js meu-projeto --only-memory
|
|
44
44
|
`);
|
|
45
45
|
process.exit(0);
|
|
46
46
|
}
|