forjajs 2.0.3 → 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 -339
- package/README.pt-BR.md +345 -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/dashboard-client.jsx +10 -10
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +14 -2
- 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 +54 -0
- package/dist/lib/core/registry.js +55 -0
- package/dist/lib/core/release.d.ts +53 -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-sqlite/src/index.js +12 -12
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -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-ops.js +29 -29
- package/dist/scripts/demo-autonomy.js +2 -2
- 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.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 -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/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 -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/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 -150
- 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
- package/dist/scripts/server-persistence-probe.d.ts +0 -1
- package/dist/scripts/server-persistence-probe.js +0 -52
- package/dist/scripts/server-persistence-probe.mjs +0 -52
- /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
package/docs/agent-harnesses.md
CHANGED
|
@@ -1,149 +1,149 @@
|
|
|
1
|
-
# Harnesses: Hermes e GSD
|
|
2
|
-
|
|
3
|
-
Este projeto passa a tratar harness como camada fina em cima dos scripts existentes, nao como framework externo obrigatorio.
|
|
4
|
-
|
|
5
|
-
## Hermes Agent
|
|
6
|
-
|
|
7
|
-
Hermes e o harness de roteamento. Ele valida o contrato de 7 campos do ADR-0005 e registra handoffs no SQLite usando `scripts/agent-router.mjs`.
|
|
8
|
-
|
|
9
|
-
Uso:
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
npm run hermes:handoff -- '{"from":"orchestrator","to":"product","intent":"spec","context":"specs/foo/spec.md","acceptance":"spec com AC testaveis","constraints":"pt-BR; sem codigo","return":"orchestrator"}'
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
Quando usar:
|
|
16
|
-
|
|
17
|
-
- Uma tarefa atravessa mais de um papel.
|
|
18
|
-
- Um agente precisa devolver trabalho para outro com aceite objetivo.
|
|
19
|
-
- Governance precisa auditar o caminho da decisao.
|
|
20
|
-
|
|
21
|
-
## GSD Harness
|
|
22
|
-
|
|
23
|
-
GSD e o harness de execucao. Ele gera um runbook curto para sair de uma demanda aberta ate gates verificaveis: contexto, spec, design, plano, implementacao e review.
|
|
24
|
-
|
|
25
|
-
Uso:
|
|
26
|
-
|
|
27
|
-
```bash
|
|
28
|
-
npm run gsd:plan -- pipeline-sdd-e-orquestracao "fortalecer design-md e harness"
|
|
29
|
-
npm run gsd:handoff -- spec pipeline-sdd-e-orquestracao
|
|
30
|
-
npm run gsd:check -- pipeline-sdd-e-orquestracao design-md/examples/agent-console-brief.md
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Saida:
|
|
34
|
-
|
|
35
|
-
- `.context/gsd-<slug>.md`
|
|
36
|
-
- checklist de gates
|
|
37
|
-
- comandos sugeridos para contexto, design check, spec check e handoff
|
|
38
|
-
|
|
39
|
-
Tambem esta integrado ao CLI unificado:
|
|
40
|
-
|
|
41
|
-
```bash
|
|
42
|
-
npm run dev -- gsd:plan pipeline-sdd-e-orquestracao "fortalecer design-md e harness"
|
|
43
|
-
npm run dev -- gsd:handoff plan pipeline-sdd-e-orquestracao
|
|
44
|
-
npm run dev -- gsd:check pipeline-sdd-e-orquestracao design-md/examples/agent-console-brief.md
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
Fases aceitas por `gsd:handoff`:
|
|
48
|
-
|
|
49
|
-
| Fase | Origem | Destino | Intent |
|
|
50
|
-
|---|---|---|---|
|
|
51
|
-
| `spec` | orchestrator | product | spec |
|
|
52
|
-
| `plan` | product | sdd-architect | plan |
|
|
53
|
-
| `implement` | sdd-architect | worker | implement |
|
|
54
|
-
| `review` | worker | governance | review |
|
|
55
|
-
|
|
56
|
-
## Design Harness
|
|
57
|
-
|
|
58
|
-
O design harness valida se um brief visual tem os campos minimos antes de virar handoff de implementacao.
|
|
59
|
-
|
|
60
|
-
Uso:
|
|
61
|
-
|
|
62
|
-
```bash
|
|
63
|
-
npm run design:check -- design-md/BRIEF-TEMPLATE.md
|
|
64
|
-
npm run design:select -- agent-console tecnico
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
Regra operacional: nenhuma interface relevante deve seguir para implementacao sem referencia primaria e criterios de aceite visual.
|
|
68
|
-
|
|
69
|
-
## Codegraph Harness (code intelligence)
|
|
70
|
-
|
|
71
|
-
O codegraph e o harness de inteligencia de codigo (ADR-0017). Ele expoe o grafo de simbolos/edges do projeto e vira gate verificavel do GSD: o Architect/Worker consulta o blast radius antes de editar; a Governanca valida que o indice e confiavel.
|
|
72
|
-
|
|
73
|
-
```bash
|
|
74
|
-
npm run code:check # indice pertence a este worktree e esta em dia?
|
|
75
|
-
npm run code:impact -- <simbolo> # chamadores + blast radius de um simbolo
|
|
76
|
-
npm run code:index # (re)indexa; use codegraph init -i para indice local de worktree
|
|
77
|
-
npm run code:sync # atualiza o indice apos mudancas
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
Regras operacionais:
|
|
81
|
-
|
|
82
|
-
- **Antes de planejar/editar**: rode `code:impact` para fundamentar "modulos afetados" no plan, em vez de chutar.
|
|
83
|
-
- **Degradacao graciosa**: se o binario `codegraph` nao existe, os comandos avisam e seguem — nada trava.
|
|
84
|
-
- **Gate de Governanca**: `code:check` reprova (bloqueante) se o indice pertence a outro worktree; e nao-bloqueante se o codegraph simplesmente nao esta instalado.
|
|
85
|
-
- `gsd:check` ja inclui o gate codegraph automaticamente.
|
|
86
|
-
|
|
87
|
-
## Doctor (nucleo + ferramentas de processo)
|
|
88
|
-
|
|
89
|
-
```bash
|
|
90
|
-
npm run tools:doctor
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
Duas secoes, dois contratos:
|
|
94
|
-
|
|
95
|
-
### Nucleo — o que impede o framework de trabalhar (ADR-0023)
|
|
96
|
-
|
|
97
|
-
Falha critica aqui **reprova com exit 1**. Cada falha vem com o comando que a corrige.
|
|
98
|
-
|
|
99
|
-
| Check | O que verifica | Severidade |
|
|
100
|
-
|---|---|---|
|
|
101
|
-
| `native-abi` | better-sqlite3 carrega no Node em uso | critica |
|
|
102
|
-
| `memory-db` | `universal.db` abre | critica se corrompido; **aviso** se so nao foi indexado |
|
|
103
|
-
| `memory-fresh` | indice em dia com `memory/` | aviso |
|
|
104
|
-
| `workspace` | workspace resolvido (e por qual origem) | aviso |
|
|
105
|
-
| `node-engines` | Node dentro do `engines` declarado | aviso |
|
|
106
|
-
| `runtime-deps` | script publicado nao importa devDependency (ADR-0021) | critica |
|
|
107
|
-
| `mcp-json` | `.mcp.json` sem path absoluto versionado (ADR-0021) | critica |
|
|
108
|
-
|
|
109
|
-
O caso que motivou o gate: com o `better-sqlite3` compilado para outra major do Node, a memoria
|
|
110
|
-
universal morre inteira — e o doctor antigo reportava "2/5 ferramentas disponiveis", exit 0. A
|
|
111
|
-
correcao e `npm rebuild better-sqlite3`; `npm install` **nao** recompila binario nativo.
|
|
112
|
-
|
|
113
|
-
O doctor diagnostica e prescreve; nao conserta. Nao existe `--fix`.
|
|
114
|
-
|
|
115
|
-
Os checks `runtime-deps` e `mcp-json` so rodam dentro do repo do framework — numa instalacao
|
|
116
|
-
`npm i -g forjajs` nao ha devDependencies nem `.mcp.json`, e eles dariam falso positivo.
|
|
117
|
-
|
|
118
|
-
### Ferramentas de processo — opcionais (ADR-0018)
|
|
119
|
-
|
|
120
|
-
Detecta sem impor. Ausencia **nunca** trava o fluxo: apenas desativa o gate correspondente.
|
|
121
|
-
|
|
122
|
-
| Ferramenta | Papel | Gate |
|
|
123
|
-
|---|---|---|
|
|
124
|
-
| codegraph | code intelligence | `code:check` / `code:impact` |
|
|
125
|
-
| gitleaks | varredura de segredos | `gitleaks detect` no review |
|
|
126
|
-
| ast-grep | busca/codemod por AST | refactor do Worker |
|
|
127
|
-
| lefthook | pre-commit automatico | `.lefthook.yml` |
|
|
128
|
-
| markdownlint | lint de docs | `markdownlint-cli2 "docs/**/*.md"` |
|
|
129
|
-
|
|
130
|
-
Ferramentas ausentes apenas desativam seus gates. Governanca decide o que exigir conforme disponibilidade.
|
|
131
|
-
|
|
132
|
-
## Workflow integrado
|
|
133
|
-
|
|
134
|
-
O fluxo sempre deve operar em steps, nesta ordem:
|
|
135
|
-
|
|
136
|
-
```text
|
|
137
|
-
briefing → estrutura → sprints → contexto → impacto (codegraph) → spec → design → plan → desenvolvimento → validação → governança
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
```bash
|
|
141
|
-
npm run dev -- gsd:plan <slug> "<objetivo>"
|
|
142
|
-
npm run dev -- design:select agent-console tecnico
|
|
143
|
-
# preencher um brief a partir de design-md/BRIEF-TEMPLATE.md
|
|
144
|
-
npm run dev -- design:check <brief.md>
|
|
145
|
-
npm run dev -- gsd:handoff spec <slug>
|
|
146
|
-
npm run dev -- gsd:check <slug> <brief.md>
|
|
147
|
-
```
|
|
148
|
-
|
|
149
|
-
Governance deve usar `gsd:check` como gate leve antes de aceitar review quando a feature passou por GSD.
|
|
1
|
+
# Harnesses: Hermes e GSD
|
|
2
|
+
|
|
3
|
+
Este projeto passa a tratar harness como camada fina em cima dos scripts existentes, nao como framework externo obrigatorio.
|
|
4
|
+
|
|
5
|
+
## Hermes Agent
|
|
6
|
+
|
|
7
|
+
Hermes e o harness de roteamento. Ele valida o contrato de 7 campos do ADR-0005 e registra handoffs no SQLite usando `scripts/agent-router.mjs`.
|
|
8
|
+
|
|
9
|
+
Uso:
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm run hermes:handoff -- '{"from":"orchestrator","to":"product","intent":"spec","context":"specs/foo/spec.md","acceptance":"spec com AC testaveis","constraints":"pt-BR; sem codigo","return":"orchestrator"}'
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Quando usar:
|
|
16
|
+
|
|
17
|
+
- Uma tarefa atravessa mais de um papel.
|
|
18
|
+
- Um agente precisa devolver trabalho para outro com aceite objetivo.
|
|
19
|
+
- Governance precisa auditar o caminho da decisao.
|
|
20
|
+
|
|
21
|
+
## GSD Harness
|
|
22
|
+
|
|
23
|
+
GSD e o harness de execucao. Ele gera um runbook curto para sair de uma demanda aberta ate gates verificaveis: contexto, spec, design, plano, implementacao e review.
|
|
24
|
+
|
|
25
|
+
Uso:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
npm run gsd:plan -- pipeline-sdd-e-orquestracao "fortalecer design-md e harness"
|
|
29
|
+
npm run gsd:handoff -- spec pipeline-sdd-e-orquestracao
|
|
30
|
+
npm run gsd:check -- pipeline-sdd-e-orquestracao design-md/examples/agent-console-brief.md
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Saida:
|
|
34
|
+
|
|
35
|
+
- `.context/gsd-<slug>.md`
|
|
36
|
+
- checklist de gates
|
|
37
|
+
- comandos sugeridos para contexto, design check, spec check e handoff
|
|
38
|
+
|
|
39
|
+
Tambem esta integrado ao CLI unificado:
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npm run dev -- gsd:plan pipeline-sdd-e-orquestracao "fortalecer design-md e harness"
|
|
43
|
+
npm run dev -- gsd:handoff plan pipeline-sdd-e-orquestracao
|
|
44
|
+
npm run dev -- gsd:check pipeline-sdd-e-orquestracao design-md/examples/agent-console-brief.md
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Fases aceitas por `gsd:handoff`:
|
|
48
|
+
|
|
49
|
+
| Fase | Origem | Destino | Intent |
|
|
50
|
+
|---|---|---|---|
|
|
51
|
+
| `spec` | orchestrator | product | spec |
|
|
52
|
+
| `plan` | product | sdd-architect | plan |
|
|
53
|
+
| `implement` | sdd-architect | worker | implement |
|
|
54
|
+
| `review` | worker | governance | review |
|
|
55
|
+
|
|
56
|
+
## Design Harness
|
|
57
|
+
|
|
58
|
+
O design harness valida se um brief visual tem os campos minimos antes de virar handoff de implementacao.
|
|
59
|
+
|
|
60
|
+
Uso:
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npm run design:check -- design-md/BRIEF-TEMPLATE.md
|
|
64
|
+
npm run design:select -- agent-console tecnico
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Regra operacional: nenhuma interface relevante deve seguir para implementacao sem referencia primaria e criterios de aceite visual.
|
|
68
|
+
|
|
69
|
+
## Codegraph Harness (code intelligence)
|
|
70
|
+
|
|
71
|
+
O codegraph e o harness de inteligencia de codigo (ADR-0017). Ele expoe o grafo de simbolos/edges do projeto e vira gate verificavel do GSD: o Architect/Worker consulta o blast radius antes de editar; a Governanca valida que o indice e confiavel.
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
npm run code:check # indice pertence a este worktree e esta em dia?
|
|
75
|
+
npm run code:impact -- <simbolo> # chamadores + blast radius de um simbolo
|
|
76
|
+
npm run code:index # (re)indexa; use codegraph init -i para indice local de worktree
|
|
77
|
+
npm run code:sync # atualiza o indice apos mudancas
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Regras operacionais:
|
|
81
|
+
|
|
82
|
+
- **Antes de planejar/editar**: rode `code:impact` para fundamentar "modulos afetados" no plan, em vez de chutar.
|
|
83
|
+
- **Degradacao graciosa**: se o binario `codegraph` nao existe, os comandos avisam e seguem — nada trava.
|
|
84
|
+
- **Gate de Governanca**: `code:check` reprova (bloqueante) se o indice pertence a outro worktree; e nao-bloqueante se o codegraph simplesmente nao esta instalado.
|
|
85
|
+
- `gsd:check` ja inclui o gate codegraph automaticamente.
|
|
86
|
+
|
|
87
|
+
## Doctor (nucleo + ferramentas de processo)
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
npm run tools:doctor
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Duas secoes, dois contratos:
|
|
94
|
+
|
|
95
|
+
### Nucleo — o que impede o framework de trabalhar (ADR-0023)
|
|
96
|
+
|
|
97
|
+
Falha critica aqui **reprova com exit 1**. Cada falha vem com o comando que a corrige.
|
|
98
|
+
|
|
99
|
+
| Check | O que verifica | Severidade |
|
|
100
|
+
|---|---|---|
|
|
101
|
+
| `native-abi` | better-sqlite3 carrega no Node em uso | critica |
|
|
102
|
+
| `memory-db` | `universal.db` abre | critica se corrompido; **aviso** se so nao foi indexado |
|
|
103
|
+
| `memory-fresh` | indice em dia com `memory/` | aviso |
|
|
104
|
+
| `workspace` | workspace resolvido (e por qual origem) | aviso |
|
|
105
|
+
| `node-engines` | Node dentro do `engines` declarado | aviso |
|
|
106
|
+
| `runtime-deps` | script publicado nao importa devDependency (ADR-0021) | critica |
|
|
107
|
+
| `mcp-json` | `.mcp.json` sem path absoluto versionado (ADR-0021) | critica |
|
|
108
|
+
|
|
109
|
+
O caso que motivou o gate: com o `better-sqlite3` compilado para outra major do Node, a memoria
|
|
110
|
+
universal morre inteira — e o doctor antigo reportava "2/5 ferramentas disponiveis", exit 0. A
|
|
111
|
+
correcao e `npm rebuild better-sqlite3`; `npm install` **nao** recompila binario nativo.
|
|
112
|
+
|
|
113
|
+
O doctor diagnostica e prescreve; nao conserta. Nao existe `--fix`.
|
|
114
|
+
|
|
115
|
+
Os checks `runtime-deps` e `mcp-json` so rodam dentro do repo do framework — numa instalacao
|
|
116
|
+
`npm i -g forjajs` nao ha devDependencies nem `.mcp.json`, e eles dariam falso positivo.
|
|
117
|
+
|
|
118
|
+
### Ferramentas de processo — opcionais (ADR-0018)
|
|
119
|
+
|
|
120
|
+
Detecta sem impor. Ausencia **nunca** trava o fluxo: apenas desativa o gate correspondente.
|
|
121
|
+
|
|
122
|
+
| Ferramenta | Papel | Gate |
|
|
123
|
+
|---|---|---|
|
|
124
|
+
| codegraph | code intelligence | `code:check` / `code:impact` |
|
|
125
|
+
| gitleaks | varredura de segredos | `gitleaks detect` no review |
|
|
126
|
+
| ast-grep | busca/codemod por AST | refactor do Worker |
|
|
127
|
+
| lefthook | pre-commit automatico | `.lefthook.yml` |
|
|
128
|
+
| markdownlint | lint de docs | `markdownlint-cli2 "docs/**/*.md"` |
|
|
129
|
+
|
|
130
|
+
Ferramentas ausentes apenas desativam seus gates. Governanca decide o que exigir conforme disponibilidade.
|
|
131
|
+
|
|
132
|
+
## Workflow integrado
|
|
133
|
+
|
|
134
|
+
O fluxo sempre deve operar em steps, nesta ordem:
|
|
135
|
+
|
|
136
|
+
```text
|
|
137
|
+
briefing → estrutura → sprints → contexto → impacto (codegraph) → spec → design → plan → desenvolvimento → validação → governança
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
```bash
|
|
141
|
+
npm run dev -- gsd:plan <slug> "<objetivo>"
|
|
142
|
+
npm run dev -- design:select agent-console tecnico
|
|
143
|
+
# preencher um brief a partir de design-md/BRIEF-TEMPLATE.md
|
|
144
|
+
npm run dev -- design:check <brief.md>
|
|
145
|
+
npm run dev -- gsd:handoff spec <slug>
|
|
146
|
+
npm run dev -- gsd:check <slug> <brief.md>
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
Governance deve usar `gsd:check` como gate leve antes de aceitar review quando a feature passou por GSD.
|
|
@@ -1,109 +1,109 @@
|
|
|
1
|
-
# ForjaJS 2.0 — Arquitetura de referência
|
|
2
|
-
|
|
3
|
-
## Direção de dependência
|
|
4
|
-
|
|
5
|
-
```text
|
|
6
|
-
interfaces externas (CLI, REST/SSE, MCP, SDK, dashboard)
|
|
7
|
-
↓
|
|
8
|
-
adapters (Nest, SQLite, Git, transporte, filesystem)
|
|
9
|
-
↓
|
|
10
|
-
application layer (casos de uso, comandos, queries, políticas)
|
|
11
|
-
↓
|
|
12
|
-
domain core (contratos, invariantes, estados, eventos)
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
`packages/core`, `contracts`, `policy`, `runtime`, `graph`, `context`, `planner`, `validator`,
|
|
16
|
-
`orchestration` e `events` não importam NestJS, Next.js, Express, Fastify, React ou drivers de
|
|
17
|
-
persistência. Portas são interfaces TypeScript; adapters fazem o binding.
|
|
18
|
-
|
|
19
|
-
## Containers
|
|
20
|
-
|
|
21
|
-
```mermaid
|
|
22
|
-
flowchart LR
|
|
23
|
-
CLI[apps/cli] --> APP[Application services]
|
|
24
|
-
API[apps/server / NestJS] --> ADP[adapter-nest]
|
|
25
|
-
MCP[packages/mcp] --> APP
|
|
26
|
-
SDK[packages/sdk] --> API
|
|
27
|
-
ADP --> APP
|
|
28
|
-
APP --> CORE[Domain packages]
|
|
29
|
-
ADP --> SQL[adapter-sqlite]
|
|
30
|
-
ADP --> GIT[adapter-git]
|
|
31
|
-
WORKER[apps/worker] --> APP
|
|
32
|
-
DASH[apps/dashboard / Next.js] --> API
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
## Componentes e persistência
|
|
36
|
-
|
|
37
|
-
SQLite é a persistência local padrão para memória, eventos, runs, handoffs e checkpoints.
|
|
38
|
-
Filesystem e Git worktree são usados para artefatos e sandbox. Cada porta de persistência deve
|
|
39
|
-
permitir uma implementação substituível; nenhuma entidade conhece SQL.
|
|
40
|
-
|
|
41
|
-
## Capability e execução
|
|
42
|
-
|
|
43
|
-
```mermaid
|
|
44
|
-
sequenceDiagram
|
|
45
|
-
participant I as Interface
|
|
46
|
-
participant R as Registry
|
|
47
|
-
participant P as Policy
|
|
48
|
-
participant A as Application
|
|
49
|
-
participant H as Handler
|
|
50
|
-
participant V as Validator
|
|
51
|
-
I->>R: discover/describe/execute
|
|
52
|
-
R->>R: validate input + version
|
|
53
|
-
R->>P: authorize identity, risk, scope, budget
|
|
54
|
-
P-->>R: ALLOW / LIMITS / APPROVAL / DENY
|
|
55
|
-
R->>A: execute application command
|
|
56
|
-
A->>H: invoke port/handler
|
|
57
|
-
H-->>A: structured result + evidence
|
|
58
|
-
A->>V: validate outcome
|
|
59
|
-
V-->>I: ExecutionResult + audit references
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
## Autonomia e GraphLoop
|
|
63
|
-
|
|
64
|
-
```mermaid
|
|
65
|
-
flowchart TD
|
|
66
|
-
O[observe] --> R[retrieve context/evidence]
|
|
67
|
-
R --> P[plan deterministically first]
|
|
68
|
-
P --> A[authorize by Policy Engine]
|
|
69
|
-
A --> X[execute in sandbox]
|
|
70
|
-
X --> V[validate independently]
|
|
71
|
-
V --> M[remember evidence/events]
|
|
72
|
-
M --> O
|
|
73
|
-
M --> G[GraphLoop incremental update]
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
GraphLoop mantém nós, arestas, evidências, validade temporal e status (`verified`, `inferred`,
|
|
77
|
-
`hypothesis`, `contradicted`, `unknown`). CodeGraph continua sendo a análise de código do 1.x;
|
|
78
|
-
GraphLoop pode consumir seus resultados, mas não o substitui.
|
|
79
|
-
|
|
80
|
-
## Processos e falhas
|
|
81
|
-
|
|
82
|
-
O modo padrão é processo separado para worker e server, com SQLite local e jobs persistidos.
|
|
83
|
-
Execuções curtas podem ser síncronas; tarefas longas usam scheduler/worker e checkpoint. REST +
|
|
84
|
-
SSE são a interface oficial inicial. WebSocket fica adiado até existir requisito verificável.
|
|
85
|
-
Retries têm limite e chave idempotente; eventos têm log append-only, consumer offsets e dead
|
|
86
|
-
letter. Cancelamento e retomada são estados explícitos.
|
|
87
|
-
|
|
88
|
-
## Fluxos de domínio
|
|
89
|
-
|
|
90
|
-
```mermaid
|
|
91
|
-
flowchart LR
|
|
92
|
-
S[Sprint] --> T[Task]
|
|
93
|
-
T --> H[Handoff]
|
|
94
|
-
H --> R[Runtime run]
|
|
95
|
-
R --> C[Checkpoint]
|
|
96
|
-
R --> V[Validator]
|
|
97
|
-
V --> E[Evidence + events]
|
|
98
|
-
E --> S
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
Dashboard exibe e solicita comandos; não contém regras de autorização, GraphLoop ou execução.
|
|
102
|
-
Plugins só recebem capabilities e eventos declarados em manifesto permissionado.
|
|
103
|
-
|
|
104
|
-
## Migração e empacotamento
|
|
105
|
-
|
|
106
|
-
O repositório atual permanece publicável como 1.x enquanto `apps/` e `packages/` são introduzidos
|
|
107
|
-
de forma aditiva. A CLI existente roteia para o novo núcleo por capability quando houver
|
|
108
|
-
equivalente; comandos sem equivalente continuam no caminho legado. Migrações criam backup,
|
|
109
|
-
validam antes de promover e não removem dados por padrão.
|
|
1
|
+
# ForjaJS 2.0 — Arquitetura de referência
|
|
2
|
+
|
|
3
|
+
## Direção de dependência
|
|
4
|
+
|
|
5
|
+
```text
|
|
6
|
+
interfaces externas (CLI, REST/SSE, MCP, SDK, dashboard)
|
|
7
|
+
↓
|
|
8
|
+
adapters (Nest, SQLite, Git, transporte, filesystem)
|
|
9
|
+
↓
|
|
10
|
+
application layer (casos de uso, comandos, queries, políticas)
|
|
11
|
+
↓
|
|
12
|
+
domain core (contratos, invariantes, estados, eventos)
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
`packages/core`, `contracts`, `policy`, `runtime`, `graph`, `context`, `planner`, `validator`,
|
|
16
|
+
`orchestration` e `events` não importam NestJS, Next.js, Express, Fastify, React ou drivers de
|
|
17
|
+
persistência. Portas são interfaces TypeScript; adapters fazem o binding.
|
|
18
|
+
|
|
19
|
+
## Containers
|
|
20
|
+
|
|
21
|
+
```mermaid
|
|
22
|
+
flowchart LR
|
|
23
|
+
CLI[apps/cli] --> APP[Application services]
|
|
24
|
+
API[apps/server / NestJS] --> ADP[adapter-nest]
|
|
25
|
+
MCP[packages/mcp] --> APP
|
|
26
|
+
SDK[packages/sdk] --> API
|
|
27
|
+
ADP --> APP
|
|
28
|
+
APP --> CORE[Domain packages]
|
|
29
|
+
ADP --> SQL[adapter-sqlite]
|
|
30
|
+
ADP --> GIT[adapter-git]
|
|
31
|
+
WORKER[apps/worker] --> APP
|
|
32
|
+
DASH[apps/dashboard / Next.js] --> API
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## Componentes e persistência
|
|
36
|
+
|
|
37
|
+
SQLite é a persistência local padrão para memória, eventos, runs, handoffs e checkpoints.
|
|
38
|
+
Filesystem e Git worktree são usados para artefatos e sandbox. Cada porta de persistência deve
|
|
39
|
+
permitir uma implementação substituível; nenhuma entidade conhece SQL.
|
|
40
|
+
|
|
41
|
+
## Capability e execução
|
|
42
|
+
|
|
43
|
+
```mermaid
|
|
44
|
+
sequenceDiagram
|
|
45
|
+
participant I as Interface
|
|
46
|
+
participant R as Registry
|
|
47
|
+
participant P as Policy
|
|
48
|
+
participant A as Application
|
|
49
|
+
participant H as Handler
|
|
50
|
+
participant V as Validator
|
|
51
|
+
I->>R: discover/describe/execute
|
|
52
|
+
R->>R: validate input + version
|
|
53
|
+
R->>P: authorize identity, risk, scope, budget
|
|
54
|
+
P-->>R: ALLOW / LIMITS / APPROVAL / DENY
|
|
55
|
+
R->>A: execute application command
|
|
56
|
+
A->>H: invoke port/handler
|
|
57
|
+
H-->>A: structured result + evidence
|
|
58
|
+
A->>V: validate outcome
|
|
59
|
+
V-->>I: ExecutionResult + audit references
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
## Autonomia e GraphLoop
|
|
63
|
+
|
|
64
|
+
```mermaid
|
|
65
|
+
flowchart TD
|
|
66
|
+
O[observe] --> R[retrieve context/evidence]
|
|
67
|
+
R --> P[plan deterministically first]
|
|
68
|
+
P --> A[authorize by Policy Engine]
|
|
69
|
+
A --> X[execute in sandbox]
|
|
70
|
+
X --> V[validate independently]
|
|
71
|
+
V --> M[remember evidence/events]
|
|
72
|
+
M --> O
|
|
73
|
+
M --> G[GraphLoop incremental update]
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
GraphLoop mantém nós, arestas, evidências, validade temporal e status (`verified`, `inferred`,
|
|
77
|
+
`hypothesis`, `contradicted`, `unknown`). CodeGraph continua sendo a análise de código do 1.x;
|
|
78
|
+
GraphLoop pode consumir seus resultados, mas não o substitui.
|
|
79
|
+
|
|
80
|
+
## Processos e falhas
|
|
81
|
+
|
|
82
|
+
O modo padrão é processo separado para worker e server, com SQLite local e jobs persistidos.
|
|
83
|
+
Execuções curtas podem ser síncronas; tarefas longas usam scheduler/worker e checkpoint. REST +
|
|
84
|
+
SSE são a interface oficial inicial. WebSocket fica adiado até existir requisito verificável.
|
|
85
|
+
Retries têm limite e chave idempotente; eventos têm log append-only, consumer offsets e dead
|
|
86
|
+
letter. Cancelamento e retomada são estados explícitos.
|
|
87
|
+
|
|
88
|
+
## Fluxos de domínio
|
|
89
|
+
|
|
90
|
+
```mermaid
|
|
91
|
+
flowchart LR
|
|
92
|
+
S[Sprint] --> T[Task]
|
|
93
|
+
T --> H[Handoff]
|
|
94
|
+
H --> R[Runtime run]
|
|
95
|
+
R --> C[Checkpoint]
|
|
96
|
+
R --> V[Validator]
|
|
97
|
+
V --> E[Evidence + events]
|
|
98
|
+
E --> S
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Dashboard exibe e solicita comandos; não contém regras de autorização, GraphLoop ou execução.
|
|
102
|
+
Plugins só recebem capabilities e eventos declarados em manifesto permissionado.
|
|
103
|
+
|
|
104
|
+
## Migração e empacotamento
|
|
105
|
+
|
|
106
|
+
O repositório atual permanece publicável como 1.x enquanto `apps/` e `packages/` são introduzidos
|
|
107
|
+
de forma aditiva. A CLI existente roteia para o novo núcleo por capability quando houver
|
|
108
|
+
equivalente; comandos sem equivalente continuam no caminho legado. Migrações criam backup,
|
|
109
|
+
validam antes de promover e não removem dados por padrão.
|