forjajs 2.0.4 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +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 +50 -50
- 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 +133 -133
- package/CHANGELOG.md +619 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +64 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +15 -0
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.js +27 -4
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +32 -3
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/publishing.md +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 +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -157
- 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/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/cost-aware-autonomy-budget/spec.md +102 -0
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/spec.md +23 -23
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -7,186 +7,186 @@ import { writeFileSafe } from "../utils/file-helpers.js";
|
|
|
7
7
|
* Factory para README dinâmico
|
|
8
8
|
*/
|
|
9
9
|
function createReadmeContent(projectName) {
|
|
10
|
-
return `# ${projectName}
|
|
11
|
-
|
|
12
|
-
Scaffold gerado por **create-memory-nest-kit v0.5.0**
|
|
13
|
-
|
|
14
|
-
## 🎯 Estrutura
|
|
15
|
-
|
|
16
|
-
Este projeto segue uma arquitetura modular com:
|
|
17
|
-
|
|
18
|
-
- **memory/** — Hierarquia de documentação centralizada
|
|
19
|
-
- 00-global/ — Missão, padrões, contexto
|
|
20
|
-
- 10-product/ — Visão, personas, regras
|
|
21
|
-
- 20-architecture/ — Design do sistema
|
|
22
|
-
- 30-domains/ — Bounded contexts (auth, billing, etc)
|
|
23
|
-
- 40-delivery/ — Roadmap e sprints
|
|
24
|
-
- 50-orchestration/ — Topologia de agentes, handoffs
|
|
25
|
-
- 60-runs/ — Log de execução
|
|
26
|
-
- 70-summaries/ — Resumos compactados
|
|
27
|
-
- 80-data/ — Schema e queries
|
|
28
|
-
- 90-decisions/ — ADRs
|
|
29
|
-
|
|
30
|
-
- **agents/** — Definição de agentes especializados
|
|
31
|
-
- **skills/** — Capacidades reutilizáveis
|
|
32
|
-
- **prompts/** — Instruções por contexto
|
|
33
|
-
- **backend/** — API NestJS (se gerado)
|
|
34
|
-
|
|
35
|
-
## 🚀 Quick Start
|
|
36
|
-
|
|
37
|
-
### 1. Explorar a Memória
|
|
38
|
-
|
|
39
|
-
\`\`\`bash
|
|
40
|
-
# Ler a missão do projeto
|
|
41
|
-
cat memory/00-global/mission.md
|
|
42
|
-
|
|
43
|
-
# Ler padrões globais
|
|
44
|
-
cat memory/00-global/standards.md
|
|
45
|
-
|
|
46
|
-
# Ler arquitetura
|
|
47
|
-
cat memory/20-architecture/system-overview.md
|
|
48
|
-
\`\`\`
|
|
49
|
-
|
|
50
|
-
### 2. Construir Contexto
|
|
51
|
-
|
|
52
|
-
\`\`\`bash
|
|
53
|
-
# Gerar um context pack com os arquivos prioritários
|
|
54
|
-
node scripts/build-context-pack.mjs
|
|
55
|
-
|
|
56
|
-
# Arquivo gerado em .context/context-pack.md
|
|
57
|
-
\`\`\`
|
|
58
|
-
|
|
59
|
-
### 3. Executar Backend (opcional)
|
|
60
|
-
|
|
61
|
-
\`\`\`bash
|
|
62
|
-
cd backend
|
|
63
|
-
|
|
64
|
-
# Instalar dependências
|
|
65
|
-
npm install
|
|
66
|
-
|
|
67
|
-
# Rodar em desenvolvimento
|
|
68
|
-
npm run start:dev
|
|
69
|
-
|
|
70
|
-
# Executar testes
|
|
71
|
-
npm test
|
|
72
|
-
|
|
73
|
-
# Verificar saúde da API
|
|
74
|
-
curl http://localhost:3000/api/health
|
|
75
|
-
\`\`\`
|
|
76
|
-
|
|
77
|
-
## 📝 Fluxo de Trabalho Multiagente
|
|
78
|
-
|
|
79
|
-
### Orquestrador
|
|
80
|
-
- Recebe tarefa
|
|
81
|
-
- Decompõe em subtarefas independentes
|
|
82
|
-
- Atribui ownership por arquivo
|
|
83
|
-
|
|
84
|
-
### Workers
|
|
85
|
-
- Executam subtarefas isoladas
|
|
86
|
-
- Entregam: alterações, testes, riscos
|
|
87
|
-
- Registram handoff em memory/50-orchestration/handoffs/
|
|
88
|
-
|
|
89
|
-
### Reviewer
|
|
90
|
-
- Valida qualidade, segurança, cobertura
|
|
91
|
-
- Aprova ou rejeita
|
|
92
|
-
|
|
93
|
-
### Consolidação
|
|
94
|
-
- Integrar handoffs
|
|
95
|
-
- Atualizar resumos em memory/70-summaries/
|
|
96
|
-
|
|
97
|
-
## 🔄 Protocolo de Handoff
|
|
98
|
-
|
|
99
|
-
Cada handoff deve incluir:
|
|
100
|
-
|
|
101
|
-
- **Contexto**: O que foi feito e por quê?
|
|
102
|
-
- **Alterações**: Lista de arquivos modificados
|
|
103
|
-
- **Riscos**: Potenciais problemas ou edge cases
|
|
104
|
-
- **Pendências**: O que não foi concluído
|
|
105
|
-
- **Próximo Passo**: Quem assume e o quê fazer
|
|
106
|
-
|
|
107
|
-
Exemplo:
|
|
108
|
-
\`\`\`bash
|
|
109
|
-
node ../scripts/append-handoff.mjs agente-a agente-b "Título da entrega"
|
|
110
|
-
\`\`\`
|
|
111
|
-
|
|
112
|
-
## 🗄️ Banco de Dados (SQLite)
|
|
113
|
-
|
|
114
|
-
A estrutura de memória é indexada em SQLite para busca rápida:
|
|
115
|
-
|
|
116
|
-
\`\`\`bash
|
|
117
|
-
# Inicializar banco
|
|
118
|
-
cd backend && npm run memory:db:init
|
|
119
|
-
|
|
120
|
-
# Sincronizar com markdown
|
|
121
|
-
npm run memory:db:sync
|
|
122
|
-
|
|
123
|
-
# Consultar por termo
|
|
124
|
-
npm run memory:db:query -- "auth"
|
|
125
|
-
\`\`\`
|
|
126
|
-
|
|
127
|
-
## 📊 Dashboard Operacional
|
|
128
|
-
|
|
129
|
-
Após iniciar o backend:
|
|
130
|
-
|
|
131
|
-
\`\`\`bash
|
|
132
|
-
# Abrir em navegador
|
|
133
|
-
open http://localhost:3000/ops
|
|
134
|
-
\`\`\`
|
|
135
|
-
|
|
136
|
-
Mostra:
|
|
137
|
-
- Status dos agentes
|
|
138
|
-
- Progresso de tarefas
|
|
139
|
-
- Últimos handoffs
|
|
140
|
-
|
|
141
|
-
## 🛠️ Scripts Utilitários
|
|
142
|
-
|
|
143
|
-
| Script | O que faz |
|
|
144
|
-
|--------|-----------|
|
|
145
|
-
| \`build-context-pack.mjs\` | Monta pack de contexto prioritário |
|
|
146
|
-
| \`append-handoff.mjs\` | Cria novo arquivo de handoff |
|
|
147
|
-
| \`memory-vacuum.mjs\` | Arquiva logs > 30 dias |
|
|
148
|
-
| \`memory-watcher.mjs\` | Auto-sync de markdown → SQLite |
|
|
149
|
-
| \`check-memory-maps.mjs\` | Gate: os mapas (context.md) não citam código morto. Rode no CI |
|
|
150
|
-
|
|
151
|
-
## 📚 Documentação Importante
|
|
152
|
-
|
|
153
|
-
- **memory/00-global/context-policy.md** — Política de janelas de contexto
|
|
154
|
-
- **memory/00-global/agent-contract.md** — Contrato entre agentes
|
|
155
|
-
- **memory/50-orchestration/handoff-protocol.md** — Protocolo formal de handoff
|
|
156
|
-
- **prompts/project-prompt-base.md** — Instruções base para agentes
|
|
157
|
-
- **AGENTS.md** — Definição de papéis e responsabilidades
|
|
158
|
-
|
|
159
|
-
## 🎯 Próximos Passos
|
|
160
|
-
|
|
161
|
-
1. ✅ Preencher memory/10-product/vision.md
|
|
162
|
-
2. ✅ Preencher memory/20-architecture/* com detalhes do seu sistema
|
|
163
|
-
3. ✅ Criar ADRs em memory/90-decisions/
|
|
164
|
-
4. ✅ Adicionar domínios em memory/30-domains/
|
|
165
|
-
5. ✅ Kickoff do primeiro sprint
|
|
166
|
-
6. ✅ Registrar primeiros handoffs
|
|
167
|
-
|
|
168
|
-
## 🤝 Contribuindo
|
|
169
|
-
|
|
170
|
-
### Padrões
|
|
171
|
-
- Documentação em **pt-BR**
|
|
172
|
-
- Decisões explícitas em ADR
|
|
173
|
-
- Toda mudança registra impacto e rollback
|
|
174
|
-
|
|
175
|
-
### Validação
|
|
176
|
-
\`\`\`bash
|
|
177
|
-
# Verificar integridade de estrutura
|
|
178
|
-
npm run project:check
|
|
179
|
-
|
|
180
|
-
# Gerar dashboard de progresso
|
|
181
|
-
npm run project:dashboard
|
|
182
|
-
\`\`\`
|
|
183
|
-
|
|
184
|
-
---
|
|
185
|
-
|
|
186
|
-
**Gerado em**: ${new Date().toISOString()}
|
|
187
|
-
|
|
188
|
-
**Versão**: v0.5.0
|
|
189
|
-
|
|
10
|
+
return `# ${projectName}
|
|
11
|
+
|
|
12
|
+
Scaffold gerado por **create-memory-nest-kit v0.5.0**
|
|
13
|
+
|
|
14
|
+
## 🎯 Estrutura
|
|
15
|
+
|
|
16
|
+
Este projeto segue uma arquitetura modular com:
|
|
17
|
+
|
|
18
|
+
- **memory/** — Hierarquia de documentação centralizada
|
|
19
|
+
- 00-global/ — Missão, padrões, contexto
|
|
20
|
+
- 10-product/ — Visão, personas, regras
|
|
21
|
+
- 20-architecture/ — Design do sistema
|
|
22
|
+
- 30-domains/ — Bounded contexts (auth, billing, etc)
|
|
23
|
+
- 40-delivery/ — Roadmap e sprints
|
|
24
|
+
- 50-orchestration/ — Topologia de agentes, handoffs
|
|
25
|
+
- 60-runs/ — Log de execução
|
|
26
|
+
- 70-summaries/ — Resumos compactados
|
|
27
|
+
- 80-data/ — Schema e queries
|
|
28
|
+
- 90-decisions/ — ADRs
|
|
29
|
+
|
|
30
|
+
- **agents/** — Definição de agentes especializados
|
|
31
|
+
- **skills/** — Capacidades reutilizáveis
|
|
32
|
+
- **prompts/** — Instruções por contexto
|
|
33
|
+
- **backend/** — API NestJS (se gerado)
|
|
34
|
+
|
|
35
|
+
## 🚀 Quick Start
|
|
36
|
+
|
|
37
|
+
### 1. Explorar a Memória
|
|
38
|
+
|
|
39
|
+
\`\`\`bash
|
|
40
|
+
# Ler a missão do projeto
|
|
41
|
+
cat memory/00-global/mission.md
|
|
42
|
+
|
|
43
|
+
# Ler padrões globais
|
|
44
|
+
cat memory/00-global/standards.md
|
|
45
|
+
|
|
46
|
+
# Ler arquitetura
|
|
47
|
+
cat memory/20-architecture/system-overview.md
|
|
48
|
+
\`\`\`
|
|
49
|
+
|
|
50
|
+
### 2. Construir Contexto
|
|
51
|
+
|
|
52
|
+
\`\`\`bash
|
|
53
|
+
# Gerar um context pack com os arquivos prioritários
|
|
54
|
+
node scripts/build-context-pack.mjs
|
|
55
|
+
|
|
56
|
+
# Arquivo gerado em .context/context-pack.md
|
|
57
|
+
\`\`\`
|
|
58
|
+
|
|
59
|
+
### 3. Executar Backend (opcional)
|
|
60
|
+
|
|
61
|
+
\`\`\`bash
|
|
62
|
+
cd backend
|
|
63
|
+
|
|
64
|
+
# Instalar dependências
|
|
65
|
+
npm install
|
|
66
|
+
|
|
67
|
+
# Rodar em desenvolvimento
|
|
68
|
+
npm run start:dev
|
|
69
|
+
|
|
70
|
+
# Executar testes
|
|
71
|
+
npm test
|
|
72
|
+
|
|
73
|
+
# Verificar saúde da API
|
|
74
|
+
curl http://localhost:3000/api/health
|
|
75
|
+
\`\`\`
|
|
76
|
+
|
|
77
|
+
## 📝 Fluxo de Trabalho Multiagente
|
|
78
|
+
|
|
79
|
+
### Orquestrador
|
|
80
|
+
- Recebe tarefa
|
|
81
|
+
- Decompõe em subtarefas independentes
|
|
82
|
+
- Atribui ownership por arquivo
|
|
83
|
+
|
|
84
|
+
### Workers
|
|
85
|
+
- Executam subtarefas isoladas
|
|
86
|
+
- Entregam: alterações, testes, riscos
|
|
87
|
+
- Registram handoff em memory/50-orchestration/handoffs/
|
|
88
|
+
|
|
89
|
+
### Reviewer
|
|
90
|
+
- Valida qualidade, segurança, cobertura
|
|
91
|
+
- Aprova ou rejeita
|
|
92
|
+
|
|
93
|
+
### Consolidação
|
|
94
|
+
- Integrar handoffs
|
|
95
|
+
- Atualizar resumos em memory/70-summaries/
|
|
96
|
+
|
|
97
|
+
## 🔄 Protocolo de Handoff
|
|
98
|
+
|
|
99
|
+
Cada handoff deve incluir:
|
|
100
|
+
|
|
101
|
+
- **Contexto**: O que foi feito e por quê?
|
|
102
|
+
- **Alterações**: Lista de arquivos modificados
|
|
103
|
+
- **Riscos**: Potenciais problemas ou edge cases
|
|
104
|
+
- **Pendências**: O que não foi concluído
|
|
105
|
+
- **Próximo Passo**: Quem assume e o quê fazer
|
|
106
|
+
|
|
107
|
+
Exemplo:
|
|
108
|
+
\`\`\`bash
|
|
109
|
+
node ../scripts/append-handoff.mjs agente-a agente-b "Título da entrega"
|
|
110
|
+
\`\`\`
|
|
111
|
+
|
|
112
|
+
## 🗄️ Banco de Dados (SQLite)
|
|
113
|
+
|
|
114
|
+
A estrutura de memória é indexada em SQLite para busca rápida:
|
|
115
|
+
|
|
116
|
+
\`\`\`bash
|
|
117
|
+
# Inicializar banco
|
|
118
|
+
cd backend && npm run memory:db:init
|
|
119
|
+
|
|
120
|
+
# Sincronizar com markdown
|
|
121
|
+
npm run memory:db:sync
|
|
122
|
+
|
|
123
|
+
# Consultar por termo
|
|
124
|
+
npm run memory:db:query -- "auth"
|
|
125
|
+
\`\`\`
|
|
126
|
+
|
|
127
|
+
## 📊 Dashboard Operacional
|
|
128
|
+
|
|
129
|
+
Após iniciar o backend:
|
|
130
|
+
|
|
131
|
+
\`\`\`bash
|
|
132
|
+
# Abrir em navegador
|
|
133
|
+
open http://localhost:3000/ops
|
|
134
|
+
\`\`\`
|
|
135
|
+
|
|
136
|
+
Mostra:
|
|
137
|
+
- Status dos agentes
|
|
138
|
+
- Progresso de tarefas
|
|
139
|
+
- Últimos handoffs
|
|
140
|
+
|
|
141
|
+
## 🛠️ Scripts Utilitários
|
|
142
|
+
|
|
143
|
+
| Script | O que faz |
|
|
144
|
+
|--------|-----------|
|
|
145
|
+
| \`build-context-pack.mjs\` | Monta pack de contexto prioritário |
|
|
146
|
+
| \`append-handoff.mjs\` | Cria novo arquivo de handoff |
|
|
147
|
+
| \`memory-vacuum.mjs\` | Arquiva logs > 30 dias |
|
|
148
|
+
| \`memory-watcher.mjs\` | Auto-sync de markdown → SQLite |
|
|
149
|
+
| \`check-memory-maps.mjs\` | Gate: os mapas (context.md) não citam código morto. Rode no CI |
|
|
150
|
+
|
|
151
|
+
## 📚 Documentação Importante
|
|
152
|
+
|
|
153
|
+
- **memory/00-global/context-policy.md** — Política de janelas de contexto
|
|
154
|
+
- **memory/00-global/agent-contract.md** — Contrato entre agentes
|
|
155
|
+
- **memory/50-orchestration/handoff-protocol.md** — Protocolo formal de handoff
|
|
156
|
+
- **prompts/project-prompt-base.md** — Instruções base para agentes
|
|
157
|
+
- **AGENTS.md** — Definição de papéis e responsabilidades
|
|
158
|
+
|
|
159
|
+
## 🎯 Próximos Passos
|
|
160
|
+
|
|
161
|
+
1. ✅ Preencher memory/10-product/vision.md
|
|
162
|
+
2. ✅ Preencher memory/20-architecture/* com detalhes do seu sistema
|
|
163
|
+
3. ✅ Criar ADRs em memory/90-decisions/
|
|
164
|
+
4. ✅ Adicionar domínios em memory/30-domains/
|
|
165
|
+
5. ✅ Kickoff do primeiro sprint
|
|
166
|
+
6. ✅ Registrar primeiros handoffs
|
|
167
|
+
|
|
168
|
+
## 🤝 Contribuindo
|
|
169
|
+
|
|
170
|
+
### Padrões
|
|
171
|
+
- Documentação em **pt-BR**
|
|
172
|
+
- Decisões explícitas em ADR
|
|
173
|
+
- Toda mudança registra impacto e rollback
|
|
174
|
+
|
|
175
|
+
### Validação
|
|
176
|
+
\`\`\`bash
|
|
177
|
+
# Verificar integridade de estrutura
|
|
178
|
+
npm run project:check
|
|
179
|
+
|
|
180
|
+
# Gerar dashboard de progresso
|
|
181
|
+
npm run project:dashboard
|
|
182
|
+
\`\`\`
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
**Gerado em**: ${new Date().toISOString()}
|
|
187
|
+
|
|
188
|
+
**Versão**: v0.5.0
|
|
189
|
+
|
|
190
190
|
`;
|
|
191
191
|
}
|
|
192
192
|
/**
|
|
@@ -125,46 +125,46 @@ export function renderHtml(d) {
|
|
|
125
125
|
const specRows = d.specs.map((s) => `<tr><td class="slug">${esc(s.slug)}</td>${stageCell(s.spec)}${stageCell(s.plan)}${stageCell(s.tasks)}</tr>`).join('');
|
|
126
126
|
const audit = d.audit;
|
|
127
127
|
const auditBlock = audit && audit.total
|
|
128
|
-
? `<div class="ametrics"><div><b>${audit.total}</b><span>runs auditados</span></div><div><b>${audit.fails}</b><span>reprovações</span></div></div>
|
|
129
|
-
<table class="board"><thead><tr><th>comando</th><th>runs</th><th>falhas</th><th>média</th></tr></thead><tbody>
|
|
130
|
-
${audit.byCmd.slice(0, 8).map((c) => `<tr><td class="slug">${esc(c.cmd)}</td><td class="num">${c.runs}</td><td class="num ${c.fails ? 'bad' : ''}">${c.fails}</td><td class="num">${c.avgMs ?? '—'}ms</td></tr>`).join('')}
|
|
128
|
+
? `<div class="ametrics"><div><b>${audit.total}</b><span>runs auditados</span></div><div><b>${audit.fails}</b><span>reprovações</span></div></div>
|
|
129
|
+
<table class="board"><thead><tr><th>comando</th><th>runs</th><th>falhas</th><th>média</th></tr></thead><tbody>
|
|
130
|
+
${audit.byCmd.slice(0, 8).map((c) => `<tr><td class="slug">${esc(c.cmd)}</td><td class="num">${c.runs}</td><td class="num ${c.fails ? 'bad' : ''}">${c.fails}</td><td class="num">${c.avgMs ?? '—'}ms</td></tr>`).join('')}
|
|
131
131
|
</tbody></table>`
|
|
132
132
|
: `<p class="empty">Sem atividade registrada ainda. A trilha nasce em <code>.context/forja-runs.jsonl</code> conforme você usa o <code>forja</code>. Rode <code>forja audit:sync</code>.</p>`;
|
|
133
|
-
return `<!doctype html><html lang="pt-BR"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Forja · Governança</title><style>
|
|
134
|
-
:root{--bg:#eceef1;--panel:#fff;--panel2:#f5f6f9;--line:#dcdfe6;--ink:#191d24;--dim:#59626f;--faint:#8b93a0;--ember:#cf5a12;--good:#2b8a3e;--goodbg:#e5f3e8;--warn:#9a6a10;--warnbg:#f6ecd6;--crit:#c22f2f;--critbg:#f6dede;--mono:ui-monospace,"SF Mono",Menlo,monospace;--sans:system-ui,-apple-system,sans-serif}
|
|
135
|
-
@media(prefers-color-scheme:dark){:root{--bg:#101318;--panel:#181c22;--panel2:#1e232b;--line:#2a303a;--ink:#e6e9ee;--dim:#98a1ad;--faint:#69727e;--ember:#ff7a3c;--good:#46b45a;--goodbg:#16301c;--warn:#d1a02a;--warnbg:#302713;--crit:#f0564a;--critbg:#331917}}
|
|
136
|
-
*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--sans);line-height:1.5}
|
|
137
|
-
.wrap{max-width:1000px;margin:0 auto;padding:30px 20px 60px}
|
|
138
|
-
header{display:flex;align-items:baseline;gap:14px;flex-wrap:wrap;border-bottom:1px solid var(--line);padding-bottom:18px}
|
|
139
|
-
.mark{font-family:var(--mono);font-weight:600;font-size:23px}.mark b{color:var(--ember)}
|
|
140
|
-
.sub{color:var(--dim);font-size:13px}.gen{margin-left:auto;color:var(--faint);font-family:var(--mono);font-size:11.5px}
|
|
141
|
-
.metrics{display:grid;grid-template-columns:repeat(3,1fr);gap:1px;background:var(--line);border:1px solid var(--line);border-radius:12px;overflow:hidden;margin:22px 0 34px}
|
|
142
|
-
.metrics div{background:var(--panel);padding:14px 16px}.metrics b{font-family:var(--mono);font-size:25px;font-weight:600}.metrics span{display:block;color:var(--dim);font-size:12px;text-transform:uppercase;letter-spacing:.05em;margin-top:2px}
|
|
143
|
-
h2{font-size:19px;margin:34px 0 4px;letter-spacing:-.2px}.eye{font-family:var(--mono);font-size:11px;text-transform:uppercase;letter-spacing:.12em;color:var(--ember)}
|
|
144
|
-
.lede{color:var(--dim);font-size:13.5px;margin:0 0 18px}
|
|
145
|
-
.gates{display:grid;grid-template-columns:repeat(3,1fr);gap:14px}
|
|
146
|
-
.gate{background:var(--panel);border:1px solid var(--line);border-radius:13px;overflow:hidden}
|
|
147
|
-
.gh{display:flex;align-items:center;gap:8px;padding:13px 15px 10px;border-bottom:1px solid var(--line)}
|
|
148
|
-
.gn{font-family:var(--mono);font-weight:600;font-size:14px}.gs{margin-left:auto;font-family:var(--mono);font-size:10px;font-weight:700;letter-spacing:.05em}
|
|
149
|
-
.gate.pass .gs{color:var(--good)}.gate.fail .gs{color:var(--crit)}.gate.unknown .gs{color:var(--faint)}
|
|
150
|
-
.gc{font-family:var(--mono);font-size:11px;color:var(--faint);padding:8px 15px 2px}
|
|
151
|
-
.gate ul{list-style:none;margin:0;padding:6px 8px 10px}.gate li{display:flex;align-items:center;gap:8px;padding:5px 7px;font-size:12.5px}
|
|
152
|
-
.cid{font-family:var(--mono);font-size:12px}.sev{margin-left:auto;font-family:var(--mono);font-size:9px;font-weight:700;padding:2px 6px;border-radius:5px;text-transform:uppercase}
|
|
153
|
-
.sev.critical{color:var(--crit);background:var(--critbg)}.sev.warn{color:var(--warn);background:var(--warnbg)}
|
|
154
|
-
.board{width:100%;border-collapse:collapse;background:var(--panel);border:1px solid var(--line);border-radius:12px;overflow:hidden}
|
|
155
|
-
.board th,.board td{text-align:left;padding:10px 15px;border-bottom:1px solid var(--line);font-size:13px}
|
|
156
|
-
.board thead th{font-family:var(--mono);font-size:10.5px;text-transform:uppercase;letter-spacing:.07em;color:var(--faint);background:var(--panel2)}
|
|
157
|
-
.board tbody tr:last-child td{border-bottom:none}.slug{font-family:var(--mono);font-size:12.5px}.num{font-family:var(--mono);text-align:right;font-variant-numeric:tabular-nums}.num.bad{color:var(--crit)}
|
|
158
|
-
.st{font-family:var(--mono);font-size:11px;font-weight:600}.st.done{color:var(--good)}.st.approved{color:#2f6f9e}.st.abandoned{color:var(--faint);text-decoration:line-through}.st.na{color:var(--faint)}
|
|
159
|
-
.ametrics{display:flex;gap:24px;margin-bottom:14px}.ametrics b{font-family:var(--mono);font-size:22px}.ametrics span{color:var(--dim);font-size:12px;margin-left:6px}
|
|
160
|
-
.empty{color:var(--dim);font-size:13.5px;background:var(--panel);border:1px dashed var(--line);border-radius:12px;padding:18px}code{font-family:var(--mono);font-size:.9em}
|
|
161
|
-
footer{margin-top:40px;padding-top:18px;border-top:1px solid var(--line);color:var(--faint);font-size:12px;display:flex;flex-wrap:wrap;gap:6px 16px}
|
|
162
|
-
</style></head><body><div class="wrap">
|
|
163
|
-
<header><span class="mark">for<b>j</b>a</span><span class="sub">painel de governança</span><span class="gen">gerado ${esc(d.generatedAt.slice(0, 16).replace('T', ' '))}</span></header>
|
|
164
|
-
<div class="metrics"><div><b>${d.metrics.commands}</b><span>comandos</span></div><div><b>${d.metrics.specs}</b><span>specs</span></div><div><b>${d.metrics.adrs}</b><span>ADRs</span></div></div>
|
|
165
|
-
<div class="eye">o motor</div><h2>Gates de invariante</h2><p class="lede">Estado do último run de cada gate na auditoria — sem reexecutar.</p><div class="gates">${gateCards}</div>
|
|
166
|
-
<div class="eye">o processo</div><h2>Pipeline SDD</h2><p class="lede">O estado real das features, do <code>spec:check</code>.</p><table class="board"><thead><tr><th>feature</th><th>spec</th><th>plan</th><th>tasks</th></tr></thead><tbody>${specRows}</tbody></table>
|
|
167
|
-
<div class="eye">a atividade</div><h2>Auditoria</h2><p class="lede">A trilha <code>.context/forja-runs.jsonl</code>, consultável.</p>${auditBlock}
|
|
168
|
-
<footer><span>Artefato <b>gerado</b>, não servido — leitura, nunca execução (ADR-0022).</span><span style="margin-left:auto" class="slug">forja governance:dashboard</span></footer>
|
|
133
|
+
return `<!doctype html><html lang="pt-BR"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Forja · Governança</title><style>
|
|
134
|
+
:root{--bg:#eceef1;--panel:#fff;--panel2:#f5f6f9;--line:#dcdfe6;--ink:#191d24;--dim:#59626f;--faint:#8b93a0;--ember:#cf5a12;--good:#2b8a3e;--goodbg:#e5f3e8;--warn:#9a6a10;--warnbg:#f6ecd6;--crit:#c22f2f;--critbg:#f6dede;--mono:ui-monospace,"SF Mono",Menlo,monospace;--sans:system-ui,-apple-system,sans-serif}
|
|
135
|
+
@media(prefers-color-scheme:dark){:root{--bg:#101318;--panel:#181c22;--panel2:#1e232b;--line:#2a303a;--ink:#e6e9ee;--dim:#98a1ad;--faint:#69727e;--ember:#ff7a3c;--good:#46b45a;--goodbg:#16301c;--warn:#d1a02a;--warnbg:#302713;--crit:#f0564a;--critbg:#331917}}
|
|
136
|
+
*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--sans);line-height:1.5}
|
|
137
|
+
.wrap{max-width:1000px;margin:0 auto;padding:30px 20px 60px}
|
|
138
|
+
header{display:flex;align-items:baseline;gap:14px;flex-wrap:wrap;border-bottom:1px solid var(--line);padding-bottom:18px}
|
|
139
|
+
.mark{font-family:var(--mono);font-weight:600;font-size:23px}.mark b{color:var(--ember)}
|
|
140
|
+
.sub{color:var(--dim);font-size:13px}.gen{margin-left:auto;color:var(--faint);font-family:var(--mono);font-size:11.5px}
|
|
141
|
+
.metrics{display:grid;grid-template-columns:repeat(3,1fr);gap:1px;background:var(--line);border:1px solid var(--line);border-radius:12px;overflow:hidden;margin:22px 0 34px}
|
|
142
|
+
.metrics div{background:var(--panel);padding:14px 16px}.metrics b{font-family:var(--mono);font-size:25px;font-weight:600}.metrics span{display:block;color:var(--dim);font-size:12px;text-transform:uppercase;letter-spacing:.05em;margin-top:2px}
|
|
143
|
+
h2{font-size:19px;margin:34px 0 4px;letter-spacing:-.2px}.eye{font-family:var(--mono);font-size:11px;text-transform:uppercase;letter-spacing:.12em;color:var(--ember)}
|
|
144
|
+
.lede{color:var(--dim);font-size:13.5px;margin:0 0 18px}
|
|
145
|
+
.gates{display:grid;grid-template-columns:repeat(3,1fr);gap:14px}
|
|
146
|
+
.gate{background:var(--panel);border:1px solid var(--line);border-radius:13px;overflow:hidden}
|
|
147
|
+
.gh{display:flex;align-items:center;gap:8px;padding:13px 15px 10px;border-bottom:1px solid var(--line)}
|
|
148
|
+
.gn{font-family:var(--mono);font-weight:600;font-size:14px}.gs{margin-left:auto;font-family:var(--mono);font-size:10px;font-weight:700;letter-spacing:.05em}
|
|
149
|
+
.gate.pass .gs{color:var(--good)}.gate.fail .gs{color:var(--crit)}.gate.unknown .gs{color:var(--faint)}
|
|
150
|
+
.gc{font-family:var(--mono);font-size:11px;color:var(--faint);padding:8px 15px 2px}
|
|
151
|
+
.gate ul{list-style:none;margin:0;padding:6px 8px 10px}.gate li{display:flex;align-items:center;gap:8px;padding:5px 7px;font-size:12.5px}
|
|
152
|
+
.cid{font-family:var(--mono);font-size:12px}.sev{margin-left:auto;font-family:var(--mono);font-size:9px;font-weight:700;padding:2px 6px;border-radius:5px;text-transform:uppercase}
|
|
153
|
+
.sev.critical{color:var(--crit);background:var(--critbg)}.sev.warn{color:var(--warn);background:var(--warnbg)}
|
|
154
|
+
.board{width:100%;border-collapse:collapse;background:var(--panel);border:1px solid var(--line);border-radius:12px;overflow:hidden}
|
|
155
|
+
.board th,.board td{text-align:left;padding:10px 15px;border-bottom:1px solid var(--line);font-size:13px}
|
|
156
|
+
.board thead th{font-family:var(--mono);font-size:10.5px;text-transform:uppercase;letter-spacing:.07em;color:var(--faint);background:var(--panel2)}
|
|
157
|
+
.board tbody tr:last-child td{border-bottom:none}.slug{font-family:var(--mono);font-size:12.5px}.num{font-family:var(--mono);text-align:right;font-variant-numeric:tabular-nums}.num.bad{color:var(--crit)}
|
|
158
|
+
.st{font-family:var(--mono);font-size:11px;font-weight:600}.st.done{color:var(--good)}.st.approved{color:#2f6f9e}.st.abandoned{color:var(--faint);text-decoration:line-through}.st.na{color:var(--faint)}
|
|
159
|
+
.ametrics{display:flex;gap:24px;margin-bottom:14px}.ametrics b{font-family:var(--mono);font-size:22px}.ametrics span{color:var(--dim);font-size:12px;margin-left:6px}
|
|
160
|
+
.empty{color:var(--dim);font-size:13.5px;background:var(--panel);border:1px dashed var(--line);border-radius:12px;padding:18px}code{font-family:var(--mono);font-size:.9em}
|
|
161
|
+
footer{margin-top:40px;padding-top:18px;border-top:1px solid var(--line);color:var(--faint);font-size:12px;display:flex;flex-wrap:wrap;gap:6px 16px}
|
|
162
|
+
</style></head><body><div class="wrap">
|
|
163
|
+
<header><span class="mark">for<b>j</b>a</span><span class="sub">painel de governança</span><span class="gen">gerado ${esc(d.generatedAt.slice(0, 16).replace('T', ' '))}</span></header>
|
|
164
|
+
<div class="metrics"><div><b>${d.metrics.commands}</b><span>comandos</span></div><div><b>${d.metrics.specs}</b><span>specs</span></div><div><b>${d.metrics.adrs}</b><span>ADRs</span></div></div>
|
|
165
|
+
<div class="eye">o motor</div><h2>Gates de invariante</h2><p class="lede">Estado do último run de cada gate na auditoria — sem reexecutar.</p><div class="gates">${gateCards}</div>
|
|
166
|
+
<div class="eye">o processo</div><h2>Pipeline SDD</h2><p class="lede">O estado real das features, do <code>spec:check</code>.</p><table class="board"><thead><tr><th>feature</th><th>spec</th><th>plan</th><th>tasks</th></tr></thead><tbody>${specRows}</tbody></table>
|
|
167
|
+
<div class="eye">a atividade</div><h2>Auditoria</h2><p class="lede">A trilha <code>.context/forja-runs.jsonl</code>, consultável.</p>${auditBlock}
|
|
168
|
+
<footer><span>Artefato <b>gerado</b>, não servido — leitura, nunca execução (ADR-0022).</span><span style="margin-left:auto" class="slug">forja governance:dashboard</span></footer>
|
|
169
169
|
</div></body></html>`;
|
|
170
170
|
}
|
package/dist/lib/workspace.js
CHANGED
|
@@ -148,32 +148,32 @@ export function initWorkspace() {
|
|
|
148
148
|
// Cria README de convenção no workspace
|
|
149
149
|
const readmePath = path.join(root, 'README.md');
|
|
150
150
|
if (!fs.existsSync(readmePath)) {
|
|
151
|
-
fs.writeFileSync(readmePath, `# Forja Workspace
|
|
152
|
-
|
|
153
|
-
Este é o workspace de produção do Forja. Aqui vivem projetos gerados, memória universal e specs de produto.
|
|
154
|
-
|
|
155
|
-
## Estrutura
|
|
156
|
-
|
|
157
|
-
- \`projects/\` — projetos gerados pelo Forja.
|
|
158
|
-
- \`memory/sqlite/universal.db\` — memória universal indexada (SQLite + FTS5).
|
|
159
|
-
- \`memory/30-projects/\` — fichas dos projetos.
|
|
160
|
-
- \`specs/\` — specs de produto.
|
|
161
|
-
- \`.context/\` — runbooks GSD de produto.
|
|
162
|
-
|
|
163
|
-
## Configuração
|
|
164
|
-
|
|
165
|
-
O caminho do workspace é resolvido por prioridade:
|
|
166
|
-
|
|
167
|
-
1. Variável \`FORJA_WORKSPACE\`
|
|
168
|
-
2. Campo \`workspaceRoot\` em \`~/.forjarc.json\`
|
|
169
|
-
3. Padrão: \`~/forja-workspace\`
|
|
170
|
-
|
|
171
|
-
## Comandos úteis
|
|
172
|
-
|
|
173
|
-
- \`npm run dev -- workspace:init\` — recria estrutura base.
|
|
174
|
-
- \`npm run dev -- project:new <nome>\` — cria novo projeto.
|
|
175
|
-
- \`npm run dev -- project:list\` — lista projetos.
|
|
176
|
-
- \`npm run dev -- project:check <nome>\` — valida padrões.
|
|
151
|
+
fs.writeFileSync(readmePath, `# Forja Workspace
|
|
152
|
+
|
|
153
|
+
Este é o workspace de produção do Forja. Aqui vivem projetos gerados, memória universal e specs de produto.
|
|
154
|
+
|
|
155
|
+
## Estrutura
|
|
156
|
+
|
|
157
|
+
- \`projects/\` — projetos gerados pelo Forja.
|
|
158
|
+
- \`memory/sqlite/universal.db\` — memória universal indexada (SQLite + FTS5).
|
|
159
|
+
- \`memory/30-projects/\` — fichas dos projetos.
|
|
160
|
+
- \`specs/\` — specs de produto.
|
|
161
|
+
- \`.context/\` — runbooks GSD de produto.
|
|
162
|
+
|
|
163
|
+
## Configuração
|
|
164
|
+
|
|
165
|
+
O caminho do workspace é resolvido por prioridade:
|
|
166
|
+
|
|
167
|
+
1. Variável \`FORJA_WORKSPACE\`
|
|
168
|
+
2. Campo \`workspaceRoot\` em \`~/.forjarc.json\`
|
|
169
|
+
3. Padrão: \`~/forja-workspace\`
|
|
170
|
+
|
|
171
|
+
## Comandos úteis
|
|
172
|
+
|
|
173
|
+
- \`npm run dev -- workspace:init\` — recria estrutura base.
|
|
174
|
+
- \`npm run dev -- project:new <nome>\` — cria novo projeto.
|
|
175
|
+
- \`npm run dev -- project:list\` — lista projetos.
|
|
176
|
+
- \`npm run dev -- project:check <nome>\` — valida padrões.
|
|
177
177
|
`, 'utf8');
|
|
178
178
|
}
|
|
179
179
|
// Cria .forjarc.json local apenas se não houver config global
|
|
@@ -184,9 +184,9 @@ O caminho do workspace é resolvido por prioridade:
|
|
|
184
184
|
// Cria README em 30-projects
|
|
185
185
|
const projectsMemoryReadme = path.join(getWorkspaceProjectsMemoryDir(), 'README.md');
|
|
186
186
|
if (!fs.existsSync(projectsMemoryReadme)) {
|
|
187
|
-
fs.writeFileSync(projectsMemoryReadme, `# Projetos do Workspace
|
|
188
|
-
|
|
189
|
-
Fichas de projetos gerados pelo Forja. Cada arquivo representa um produto ativo ou arquivado.
|
|
187
|
+
fs.writeFileSync(projectsMemoryReadme, `# Projetos do Workspace
|
|
188
|
+
|
|
189
|
+
Fichas de projetos gerados pelo Forja. Cada arquivo representa um produto ativo ou arquivado.
|
|
190
190
|
`, 'utf8');
|
|
191
191
|
}
|
|
192
192
|
return root;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { DeterministicDocument, GraphDocumentSource } from '../../graph/src/index.ts';
|
|
2
|
-
import type
|
|
2
|
+
import { type ISO8601 } from '../../contracts/src/index.ts';
|
|
3
3
|
import type { SandboxBackend, SandboxCommandResult, SandboxDiffData, SandboxValidation } from '../../sandbox/src/index.ts';
|
|
4
4
|
import type { SandboxCommand, SandboxSession } from '../../contracts/src/index.ts';
|
|
5
5
|
export interface CommandRunner {
|
|
@@ -2,6 +2,7 @@ import fs from 'node:fs';
|
|
|
2
2
|
import path from 'node:path';
|
|
3
3
|
import { spawnSync } from 'node:child_process';
|
|
4
4
|
import { graphDocumentId } from "../../graph/src/index.js";
|
|
5
|
+
import { isPathWithinRoot } from "../../contracts/src/index.js";
|
|
5
6
|
export class SpawnCommandRunner {
|
|
6
7
|
run(command) {
|
|
7
8
|
const started = Date.now();
|
|
@@ -27,7 +28,7 @@ export class GitGraphDocumentSource {
|
|
|
27
28
|
if (!isIndexable(relative))
|
|
28
29
|
continue;
|
|
29
30
|
const absolute = path.join(this.root, relative);
|
|
30
|
-
if (!
|
|
31
|
+
if (!isPathWithinRoot(this.root, absolute))
|
|
31
32
|
continue;
|
|
32
33
|
try {
|
|
33
34
|
const content = fs.readFileSync(absolute, 'utf8');
|
|
@@ -45,13 +46,17 @@ function isIndexable(relative) {
|
|
|
45
46
|
return false;
|
|
46
47
|
return /\.(?:ts|tsx|js|jsx|mjs|cjs|json|md|yaml|yml)$/.test(relative);
|
|
47
48
|
}
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
49
|
+
/**
|
|
50
|
+
* `HOME`/`USERPROFILE` (SPEC-038 achado real): sem eles, `npm` não consegue resolver seu diretório
|
|
51
|
+
* de config/cache e trava indefinidamente em vez de falhar rápido — reproduzido rodando
|
|
52
|
+
* `forja simulate` com `--command "npm test"` contra este próprio repositório. Nenhum dos dois é
|
|
53
|
+
* segredo (são só um path de diretório), então passá-los adiante não viola o teste
|
|
54
|
+
* "runner não herda secrets do ambiente por padrão" (`test/adapter-git.test.js`) — esse teste
|
|
55
|
+
* cobre uma env var arbitrária do processo host, não este allowlist fixo.
|
|
56
|
+
*/
|
|
52
57
|
function sandboxEnvironment(overrides) {
|
|
53
58
|
const inherited = {};
|
|
54
|
-
for (const key of ['PATH', 'NODE_PATH', 'SystemRoot', 'TMPDIR', 'TMP', 'TEMP']) {
|
|
59
|
+
for (const key of ['PATH', 'NODE_PATH', 'SystemRoot', 'TMPDIR', 'TMP', 'TEMP', 'HOME', 'USERPROFILE']) {
|
|
55
60
|
const value = process.env[key];
|
|
56
61
|
if (value !== undefined)
|
|
57
62
|
inherited[key] = value;
|
|
@@ -7,7 +7,17 @@ export interface HttpRequest {
|
|
|
7
7
|
readonly body?: unknown;
|
|
8
8
|
readonly headers: Readonly<Record<string, string | undefined>>;
|
|
9
9
|
readonly correlationId?: string;
|
|
10
|
+
/** `req.socket.remoteAddress` (or equivalent) of the caller, when known. Used to fail closed to
|
|
11
|
+
* loopback-only access when no authenticator is configured — see `isLoopbackAddress`. */
|
|
12
|
+
readonly remoteAddress?: string;
|
|
10
13
|
}
|
|
14
|
+
/**
|
|
15
|
+
* True for 127.0.0.0/8 and ::1 (with the common ::ffff:-mapped IPv4 form normalized first).
|
|
16
|
+
* `address === undefined` returns false — "unknown" is not "trusted" — but callers that only have
|
|
17
|
+
* a real remote address for genuine network connections (never for direct in-process calls) may
|
|
18
|
+
* choose to treat a missing address as trusted at the call site; this helper stays strict.
|
|
19
|
+
*/
|
|
20
|
+
export declare function isLoopbackAddress(address: string | undefined): boolean;
|
|
11
21
|
export interface HttpResponse {
|
|
12
22
|
readonly status: number;
|
|
13
23
|
readonly headers: Readonly<Record<string, string>>;
|
|
@@ -50,6 +60,15 @@ export declare class ForjaNestAdapter {
|
|
|
50
60
|
private readonly controlPlane?;
|
|
51
61
|
constructor(mcp: McpServer, stream?: EventStream, authenticator?: LocalAuthenticator, controlPlane?: ControlPlanePort);
|
|
52
62
|
handle(request: HttpRequest): Promise<HttpResponse>;
|
|
63
|
+
/**
|
|
64
|
+
* Fails closed when no authenticator is configured: previously this meant "allow everyone", which
|
|
65
|
+
* left any request that reached the process (e.g. a container-network or port-forward hop) fully
|
|
66
|
+
* unauthenticated. Now it means "loopback callers only". `remoteAddress` being unset (rather than
|
|
67
|
+
* a real non-loopback address) is treated as an internal/direct call — e.g. dispatched in-process,
|
|
68
|
+
* not received over an actual socket — and stays trusted; a genuine HTTP layer always supplies it
|
|
69
|
+
* (see ForjaLocalAuthGuard, which reads it straight off the raw socket).
|
|
70
|
+
*/
|
|
71
|
+
private isAuthenticated;
|
|
53
72
|
subscribeSse(listener: (event: SseEvent) => void): () => void;
|
|
54
73
|
modules(): readonly NestModuleDefinition[];
|
|
55
74
|
openApi(): OpenApiDocument;
|