forjajs 2.0.2 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -317
- package/README.pt-BR.md +345 -323
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.d.ts +1 -0
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
- 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 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
- 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 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- 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 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -140
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -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
|
+
|
|
@@ -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() {
|
|
@@ -2,8 +2,9 @@ import 'reflect-metadata';
|
|
|
2
2
|
import { CapabilityRegistry } from '../../../packages/core/src/index.ts';
|
|
3
3
|
import { PolicyEngine } from '../../../packages/policy/src/index.ts';
|
|
4
4
|
import { McpServer } from '../../../packages/mcp/src/index.ts';
|
|
5
|
-
import { ControlPlane } from '../../../packages/observability/src/index.ts';
|
|
5
|
+
import { ControlPlane, type ObservationStore } from '../../../packages/observability/src/index.ts';
|
|
6
6
|
import { ApprovalLedger } from '../../../packages/policy/src/index.ts';
|
|
7
|
+
import { type OrchestrationStore } from '../../../packages/orchestration/src/index.ts';
|
|
7
8
|
import { InMemoryEventStream, type LocalAuthenticator } from '../../../packages/adapter-nest/src/index.ts';
|
|
8
9
|
import { GraphLoop } from '../../../packages/graph/src/index.ts';
|
|
9
10
|
import { ContextEngine } from '../../../packages/context/src/index.ts';
|
|
@@ -13,5 +14,5 @@ export declare function createDefaultCapabilityRegistry(root?: string, cwd?: str
|
|
|
13
14
|
export declare function createDefaultMcp(registry?: CapabilityRegistry, policy?: PolicyEngine, graph?: GraphLoop, audit?: import('../../../packages/mcp/src/index.ts').McpAuditSink, context?: ContextEngine): McpServer;
|
|
14
15
|
export declare function createDefaultPolicy(): PolicyEngine;
|
|
15
16
|
export declare function createLocalAuthenticator(token?: string | undefined): LocalAuthenticator | undefined;
|
|
16
|
-
export declare function createDefaultControlPlane(eventStream: InMemoryEventStream, registry?: CapabilityRegistry, policy?: PolicyEngine, persistence?: RuntimePersistence, approvals?: ApprovalLedger, events?: EventBus, graph?: GraphLoop, context?: ContextEngine): ControlPlane;
|
|
17
|
+
export declare function createDefaultControlPlane(eventStream: InMemoryEventStream, registry?: CapabilityRegistry, policy?: PolicyEngine, persistence?: RuntimePersistence, approvals?: ApprovalLedger, events?: EventBus, graph?: GraphLoop, context?: ContextEngine, orchestrationStore?: OrchestrationStore, observationStore?: ObservationStore): ControlPlane;
|
|
17
18
|
export declare function bootstrap(port?: number): Promise<import("@nestjs/common").INestApplication<any>>;
|
|
@@ -8,7 +8,7 @@ import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
|
|
|
8
8
|
import { CapabilityRegistry } from "../../../packages/core/src/index.js";
|
|
9
9
|
import { PolicyEngine } from "../../../packages/policy/src/index.js";
|
|
10
10
|
import { McpServer } from "../../../packages/mcp/src/index.js";
|
|
11
|
-
import { ControlPlane } from "../../../packages/observability/src/index.js";
|
|
11
|
+
import { ControlPlane, InMemoryObservationStore, ObservabilityRecorder } from "../../../packages/observability/src/index.js";
|
|
12
12
|
import { ApprovalLedger } from "../../../packages/policy/src/index.js";
|
|
13
13
|
import { HandoffEngine, InMemoryOrchestrationStore, SprintEngine, TaskEngine } from "../../../packages/orchestration/src/index.js";
|
|
14
14
|
import { validateTokenBudget } from "../../../packages/contracts/src/index.js";
|
|
@@ -18,7 +18,7 @@ import { RuntimeEngine } from "../../../packages/runtime/src/index.js";
|
|
|
18
18
|
import { GraphExecutionMemory, GraphLoop } from "../../../packages/graph/src/index.js";
|
|
19
19
|
import { ContextEngine, GraphContextSource } from "../../../packages/context/src/index.js";
|
|
20
20
|
import { SqliteContextCache, SqliteGraphStore, SqliteMigrationRunner, SqliteRuntimePersistence } from "../../../packages/adapter-sqlite/src/index.js";
|
|
21
|
-
import { SqliteApprovalStore, SqliteMcpAuditSink } from "../../../packages/adapter-sqlite/src/index.js";
|
|
21
|
+
import { SqliteApprovalStore, SqliteMcpAuditSink, SqliteObservationStore, SqliteOrchestrationStore } from "../../../packages/adapter-sqlite/src/index.js";
|
|
22
22
|
import { EventBus } from "../../../packages/events/src/index.js";
|
|
23
23
|
import { SqliteEventStore } from "../../../packages/adapter-sqlite/src/index.js";
|
|
24
24
|
import { getWorkspaceDbDir, getWorkspaceDbPath } from "../../../lib/workspace.js";
|
|
@@ -114,13 +114,13 @@ function runtimeInput(input) {
|
|
|
114
114
|
return { objective: input.objective, agent, budget, steps, sprintId: typeof input.sprintId === 'string' ? input.sprintId : undefined, taskId: typeof input.taskId === 'string' ? input.taskId : undefined, correlationId: typeof input.correlationId === 'string' ? input.correlationId : undefined };
|
|
115
115
|
}
|
|
116
116
|
function isRecord(value) { return typeof value === 'object' && value !== null; }
|
|
117
|
-
export function createDefaultControlPlane(eventStream, registry = createDefaultCapabilityRegistry(), policy = createDefaultPolicy(), persistence, approvals = new ApprovalLedger(), events, graph, context) {
|
|
118
|
-
const store =
|
|
117
|
+
export function createDefaultControlPlane(eventStream, registry = createDefaultCapabilityRegistry(), policy = createDefaultPolicy(), persistence, approvals = new ApprovalLedger(), events, graph, context, orchestrationStore = new InMemoryOrchestrationStore(), observationStore = new InMemoryObservationStore()) {
|
|
118
|
+
const store = orchestrationStore;
|
|
119
119
|
const sprintEngine = new SprintEngine(store);
|
|
120
120
|
const taskEngine = new TaskEngine(store, sprintEngine);
|
|
121
121
|
const handoffEngine = new HandoffEngine(store);
|
|
122
122
|
const runtime = new DefaultRuntimeApplication(registry, policy, persistence, graph, context);
|
|
123
|
-
return new ControlPlane(
|
|
123
|
+
return new ControlPlane(new ObservabilityRecorder(observationStore), {
|
|
124
124
|
runtime: { start: (input) => runtime.start(input), get: (input) => runtime.get(input), execute: (input) => runtime.execute(input), pause: (input) => runtime.pause(input), resume: (input) => runtime.resume(input), cancel: (input) => runtime.cancel(input) },
|
|
125
125
|
sprint: { create: (input) => sprintEngine.create(input), start: (id) => sprintEngine.start(id), pause: (id) => sprintEngine.pause(id) },
|
|
126
126
|
task: { create: (input) => taskEngine.create(input), start: (id) => taskEngine.start(id), block: (id) => taskEngine.block(id) },
|
|
@@ -141,10 +141,12 @@ export async function bootstrap(port = Number(process.env.FORJA_PORT ?? 3000)) {
|
|
|
141
141
|
const mcpAudit = new SqliteMcpAuditSink(runtimeDatabase);
|
|
142
142
|
const events = new EventBus(new SqliteEventStore(runtimeDatabase));
|
|
143
143
|
const graph = new GraphLoop(new SqliteGraphStore(runtimeDatabase));
|
|
144
|
+
const orchestrationStore = new SqliteOrchestrationStore(runtimeDatabase);
|
|
145
|
+
const observationStore = new SqliteObservationStore(runtimeDatabase);
|
|
144
146
|
registerGraphSyncCapability(registry, graph, new GitGraphDocumentSource(process.env.FORJA_GRAPH_ROOT ?? process.cwd(), new SpawnCommandRunner()));
|
|
145
147
|
const context = new ContextEngine({ graph: new GraphContextSource({ searchContext: (objective) => graph.contextRecords(objective) }), cache: new SqliteContextCache(runtimeDatabase) });
|
|
146
148
|
const mcp = createDefaultMcp(registry, policy, graph, mcpAudit, context);
|
|
147
|
-
const app = await NestFactory.create(AppModule.register({ mcp, eventStream, authenticator: createLocalAuthenticator(), controlPlane: createDefaultControlPlane(eventStream, registry, policy, runtimePersistence, approvals, events, graph, context) }));
|
|
149
|
+
const app = await NestFactory.create(AppModule.register({ mcp, eventStream, authenticator: createLocalAuthenticator(), controlPlane: createDefaultControlPlane(eventStream, registry, policy, runtimePersistence, approvals, events, graph, context, orchestrationStore, observationStore) }));
|
|
148
150
|
const config = new DocumentBuilder().setTitle('ForjaJS 2.0 API').setDescription('Local-first agent control plane').setVersion('2.0.0').build();
|
|
149
151
|
SwaggerModule.setup('docs', app, SwaggerModule.createDocument(app, config));
|
|
150
152
|
await app.listen(port, '127.0.0.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
|
}
|
package/dist/bin/forja.js
CHANGED
|
@@ -25,6 +25,7 @@ import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
|
|
|
25
25
|
import { McpServer } from "../packages/mcp/src/index.js";
|
|
26
26
|
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
27
27
|
const root = path.resolve(__dirname, '..');
|
|
28
|
+
const STUDIO_COMMANDS = new Set(['workspace:init', 'project:new', 'project:list', 'project:upgrade', 'workspace:project:check', 'init:project', 'demo:workspace']);
|
|
28
29
|
function printHelp() {
|
|
29
30
|
console.log('Forja — core executivo (ADR-0020)');
|
|
30
31
|
console.log('Uso: forja <comando> [args]\n');
|
|
@@ -122,6 +123,13 @@ function jsonFlag(args) {
|
|
|
122
123
|
function withoutFlag(args, flag) {
|
|
123
124
|
return args.filter((arg) => arg !== flag);
|
|
124
125
|
}
|
|
126
|
+
// Prompts podem conter dados do projeto. A execução recebe o texto, mas a trilha de auditoria só prova
|
|
127
|
+
// que um prompt foi enviado; nunca preserva seu conteúdo.
|
|
128
|
+
function auditArgs(command, args) {
|
|
129
|
+
if (command !== 'llm:run')
|
|
130
|
+
return args;
|
|
131
|
+
return args.map((arg, index) => args[index - 1] === '--prompt' ? '<redacted>' : arg);
|
|
132
|
+
}
|
|
125
133
|
function printExecutionResult(result, json) {
|
|
126
134
|
if (json) {
|
|
127
135
|
console.log(JSON.stringify(result));
|
|
@@ -235,12 +243,17 @@ async function runMcpStdio() {
|
|
|
235
243
|
if (line.trim().length === 0)
|
|
236
244
|
return;
|
|
237
245
|
let request;
|
|
246
|
+
let id = null;
|
|
238
247
|
try {
|
|
239
248
|
request = JSON.parse(line);
|
|
240
|
-
|
|
249
|
+
id = request.id ?? null;
|
|
250
|
+
if (request.method === 'notifications/initialized')
|
|
251
|
+
return;
|
|
252
|
+
if (request.method === 'notifications/cancelled')
|
|
253
|
+
return;
|
|
241
254
|
let result;
|
|
242
255
|
if (request.method === 'initialize')
|
|
243
|
-
result = { protocolVersion: '2025-06-18', capabilities: { tools: {}, resources: {} }, serverInfo: { name: 'forja', version: '2.0.
|
|
256
|
+
result = { protocolVersion: '2025-06-18', capabilities: { tools: {}, resources: {} }, serverInfo: { name: 'forja', version: '2.0.3' } };
|
|
244
257
|
else if (request.method === 'tools/list')
|
|
245
258
|
result = { tools: mcp.listTools() };
|
|
246
259
|
else if (request.method === 'resources/list')
|
|
@@ -254,7 +267,7 @@ async function runMcpStdio() {
|
|
|
254
267
|
process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id, result })}\n`);
|
|
255
268
|
}
|
|
256
269
|
catch (error) {
|
|
257
|
-
process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id
|
|
270
|
+
process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id, error: { code: -32000, message: error instanceof Error ? error.message : 'MCP request failed' } })}\n`);
|
|
258
271
|
}
|
|
259
272
|
};
|
|
260
273
|
let buffer = '';
|
|
@@ -280,6 +293,10 @@ if (!name || name === 'help' || name === '--help' || name === '-h') {
|
|
|
280
293
|
printHelp();
|
|
281
294
|
process.exit(0);
|
|
282
295
|
}
|
|
296
|
+
// O pacote instalado dentro de um projeto opera o próprio cwd. Operações que administram vários
|
|
297
|
+
// projetos permanecem no studio global; FORJA_MODE/FORJA_WORKSPACE sempre vencem a inferência.
|
|
298
|
+
if (STUDIO_COMMANDS.has(name) && !process.env.FORJA_MODE && !process.env.FORJA_WORKSPACE)
|
|
299
|
+
process.env.FORJA_MODE = 'studio';
|
|
283
300
|
if (name === 'capabilities:list' || name === 'capabilities:describe' || name === 'capability:execute') {
|
|
284
301
|
process.exit(await runCapabilityCommand(name, rest));
|
|
285
302
|
}
|
|
@@ -304,7 +321,7 @@ if (gateErrors.length) {
|
|
|
304
321
|
audit({
|
|
305
322
|
ts: new Date().toISOString(),
|
|
306
323
|
cmd: name,
|
|
307
|
-
args: rest,
|
|
324
|
+
args: auditArgs(name, rest),
|
|
308
325
|
exitCode: 1,
|
|
309
326
|
durationMs: 0,
|
|
310
327
|
gate: 'blocked',
|
|
@@ -342,7 +359,7 @@ const exitCode = result.status ?? 1;
|
|
|
342
359
|
audit({
|
|
343
360
|
ts: new Date().toISOString(),
|
|
344
361
|
cmd: name,
|
|
345
|
-
args: rest,
|
|
362
|
+
args: auditArgs(name, rest),
|
|
346
363
|
exitCode,
|
|
347
364
|
durationMs: Date.now() - started,
|
|
348
365
|
});
|