forjajs 2.0.2 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -317
- package/README.pt-BR.md +345 -323
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.d.ts +1 -0
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -140
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
/** CLI-first LLM Fit Loop. Credentials stay in the provider CLI; Forja stores only profiles and observations. */
|
|
2
|
+
import fs from 'node:fs';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { spawnSync } from 'node:child_process';
|
|
5
|
+
import Database from 'better-sqlite3';
|
|
6
|
+
import { createHash, randomUUID } from 'node:crypto';
|
|
7
|
+
import { DEFAULT_LLM_PROFILES, buildLlmExecution, recommendProfile, runLlm, validateProfiles } from "../packages/llm/src/index.js";
|
|
8
|
+
import { EvaluationEngine } from "../packages/evals/src/index.js";
|
|
9
|
+
import { ObservabilityRecorder } from "../packages/observability/src/index.js";
|
|
10
|
+
import { SqliteMigrationRunner, SqliteObservationStore } from "../packages/adapter-sqlite/src/index.js";
|
|
11
|
+
import { getWorkspaceContextDir, getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
|
|
12
|
+
const profilePath = () => path.join(getWorkspaceContextDir(), 'llm-profiles.json');
|
|
13
|
+
function usage() {
|
|
14
|
+
console.error('Uso: forja llm:<doctor|profiles:init|probe|recommend|run|eval>');
|
|
15
|
+
process.exit(1);
|
|
16
|
+
}
|
|
17
|
+
function profiles() {
|
|
18
|
+
if (!fs.existsSync(profilePath()))
|
|
19
|
+
throw new Error(`Perfis ausentes: execute forja llm:profiles:init (${profilePath()})`);
|
|
20
|
+
return validateProfiles(JSON.parse(fs.readFileSync(profilePath(), 'utf8')));
|
|
21
|
+
}
|
|
22
|
+
function profile(name) {
|
|
23
|
+
const value = profiles().profiles[name];
|
|
24
|
+
if (!value)
|
|
25
|
+
throw new Error(`Perfil não encontrado: ${name}`);
|
|
26
|
+
return value;
|
|
27
|
+
}
|
|
28
|
+
function flags(args) {
|
|
29
|
+
const output = new Map();
|
|
30
|
+
for (let index = 0; index < args.length; index += 1) {
|
|
31
|
+
const flag = args[index];
|
|
32
|
+
if (!flag.startsWith('--'))
|
|
33
|
+
throw new Error(`Argumento inválido: ${flag}`);
|
|
34
|
+
const value = args[index + 1];
|
|
35
|
+
if (!value || value.startsWith('--'))
|
|
36
|
+
throw new Error(`Valor ausente para ${flag}`);
|
|
37
|
+
output.set(flag, [...(output.get(flag) ?? []), value]);
|
|
38
|
+
index += 1;
|
|
39
|
+
}
|
|
40
|
+
return output;
|
|
41
|
+
}
|
|
42
|
+
function option(input, name) { return input.get(name)?.at(-1); }
|
|
43
|
+
function storage() {
|
|
44
|
+
fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
|
|
45
|
+
const db = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
|
|
46
|
+
new SqliteMigrationRunner(db).apply();
|
|
47
|
+
return { db, store: new SqliteObservationStore(db) };
|
|
48
|
+
}
|
|
49
|
+
function doctor(name) {
|
|
50
|
+
const configured = profiles().profiles;
|
|
51
|
+
if (name && !configured[name])
|
|
52
|
+
throw new Error(`Perfil não encontrado: ${name}`);
|
|
53
|
+
const result = Object.entries(configured).filter(([profileName]) => name === undefined || profileName === name).map(([profileName, value]) => {
|
|
54
|
+
const probe = spawnSync(value.command, ['--version'], { encoding: 'utf8', timeout: 10_000, shell: false });
|
|
55
|
+
const errorCode = probe.error?.code;
|
|
56
|
+
return { name: profileName, provider: value.provider, model: value.model, enabled: value.enabled, executable: value.command, available: !probe.error && probe.status === 0, detail: errorCode ?? (probe.status === 0 ? String(probe.stdout).trim().split('\n')[0] : String(probe.stderr).trim().split('\n')[0]) };
|
|
57
|
+
});
|
|
58
|
+
console.log(JSON.stringify({ profiles: result }, null, 2));
|
|
59
|
+
if (result.some((item) => item.enabled && !item.available))
|
|
60
|
+
process.exitCode = 1;
|
|
61
|
+
}
|
|
62
|
+
async function run() {
|
|
63
|
+
const input = flags(process.argv.slice(3));
|
|
64
|
+
const name = option(input, '--profile');
|
|
65
|
+
const prompt = option(input, '--prompt') ?? (option(input, '--task') ? fs.readFileSync(path.resolve(option(input, '--task')), 'utf8') : undefined);
|
|
66
|
+
if (!name || !prompt)
|
|
67
|
+
usage();
|
|
68
|
+
const selected = profile(name);
|
|
69
|
+
const result = await runLlm(buildLlmExecution(selected, prompt), process.cwd());
|
|
70
|
+
const { db, store } = storage();
|
|
71
|
+
try {
|
|
72
|
+
const recorder = new ObservabilityRecorder(store);
|
|
73
|
+
const refs = (input.get('--context') ?? []).map((value) => path.resolve(value));
|
|
74
|
+
const observation = await recorder.record({ traceId: `llm:${name}:${randomUUID()}`, model: `${selected.provider}:${selected.model}`, inputHash: createHash('sha256').update(prompt).digest('hex'), contextRefs: refs, inputTokens: Math.ceil(Buffer.byteLength(prompt) / 4), outputTokens: Math.ceil(Buffer.byteLength(result.stdout) / 4), durationMs: result.durationMs, tools: [selected.command], commands: [selected.command], outcome: result.exitCode === 0 ? 'succeeded' : 'failed', errorCode: result.errorCode });
|
|
75
|
+
console.log(JSON.stringify({ profile: name, model: observation.model, exitCode: result.exitCode, durationMs: result.durationMs, observationId: observation.id, stdout: result.stdout, stderr: result.stderr }, null, 2));
|
|
76
|
+
if (result.exitCode !== 0)
|
|
77
|
+
process.exitCode = result.exitCode;
|
|
78
|
+
}
|
|
79
|
+
finally {
|
|
80
|
+
db.close();
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
function recommend() {
|
|
84
|
+
const input = flags(process.argv.slice(3));
|
|
85
|
+
const role = option(input, '--role');
|
|
86
|
+
const task = option(input, '--task');
|
|
87
|
+
if (!role || !task)
|
|
88
|
+
usage();
|
|
89
|
+
const { db, store } = storage();
|
|
90
|
+
try {
|
|
91
|
+
console.log(JSON.stringify({ role, task, recommendations: recommendProfile(profiles(), store.list(), role, task, option(input, '--privacy')) }, null, 2));
|
|
92
|
+
}
|
|
93
|
+
finally {
|
|
94
|
+
db.close();
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
async function evaluate() {
|
|
98
|
+
const input = flags(process.argv.slice(3));
|
|
99
|
+
const scope = option(input, '--scope') ?? 'workspace';
|
|
100
|
+
const scopeId = option(input, '--id');
|
|
101
|
+
if (!['workspace', 'model', 'agent', 'task', 'sprint', 'run', 'capability', 'strategy'].includes(scope))
|
|
102
|
+
throw new Error(`Escopo inválido: ${scope}`);
|
|
103
|
+
const { db, store } = storage();
|
|
104
|
+
try {
|
|
105
|
+
console.log(JSON.stringify(await new EvaluationEngine(store).evaluate({ scope: scope, scopeId }), null, 2));
|
|
106
|
+
}
|
|
107
|
+
finally {
|
|
108
|
+
db.close();
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
async function main() {
|
|
112
|
+
const command = process.argv[2];
|
|
113
|
+
if (command === 'profiles:init') {
|
|
114
|
+
fs.mkdirSync(path.dirname(profilePath()), { recursive: true });
|
|
115
|
+
if (fs.existsSync(profilePath()) && !process.argv.includes('--force'))
|
|
116
|
+
throw new Error(`Perfis já existem: ${profilePath()} (use --force para substituir)`);
|
|
117
|
+
fs.writeFileSync(profilePath(), `${JSON.stringify(DEFAULT_LLM_PROFILES, null, 2)}\n`);
|
|
118
|
+
console.log(`Perfis LLM criados: ${profilePath()}`);
|
|
119
|
+
}
|
|
120
|
+
else if (command === 'doctor' || command === 'probe')
|
|
121
|
+
doctor(process.argv[3]);
|
|
122
|
+
else if (command === 'recommend')
|
|
123
|
+
recommend();
|
|
124
|
+
else if (command === 'run')
|
|
125
|
+
await run();
|
|
126
|
+
else if (command === 'eval')
|
|
127
|
+
await evaluate();
|
|
128
|
+
else
|
|
129
|
+
usage();
|
|
130
|
+
}
|
|
131
|
+
main().catch((error) => { console.error(error instanceof Error ? error.message : String(error)); process.exit(1); });
|
|
@@ -16,54 +16,54 @@ function ensureSchema({ silent = false } = {}) {
|
|
|
16
16
|
const db = new Database(dbPath, { timeout: 5000 });
|
|
17
17
|
db.pragma('busy_timeout = 5000');
|
|
18
18
|
db.pragma('journal_mode = WAL');
|
|
19
|
-
db.exec(`
|
|
20
|
-
CREATE TABLE IF NOT EXISTS spec_summaries (
|
|
21
|
-
slug TEXT PRIMARY KEY,
|
|
22
|
-
status TEXT,
|
|
23
|
-
title TEXT,
|
|
24
|
-
summary TEXT NOT NULL,
|
|
25
|
-
source_path TEXT NOT NULL,
|
|
26
|
-
updated_at TEXT NOT NULL
|
|
27
|
-
);
|
|
28
|
-
|
|
29
|
-
CREATE TABLE IF NOT EXISTS context_runs (
|
|
30
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
31
|
-
created_at TEXT NOT NULL,
|
|
32
|
-
kind TEXT NOT NULL,
|
|
33
|
-
slug TEXT,
|
|
34
|
-
path TEXT NOT NULL,
|
|
35
|
-
bytes INTEGER NOT NULL,
|
|
36
|
-
estimated_tokens INTEGER NOT NULL,
|
|
37
|
-
limit_tokens INTEGER,
|
|
38
|
-
status TEXT NOT NULL
|
|
39
|
-
);
|
|
40
|
-
|
|
41
|
-
CREATE TABLE IF NOT EXISTS asset_catalog (
|
|
42
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
43
|
-
type TEXT NOT NULL,
|
|
44
|
-
name TEXT NOT NULL,
|
|
45
|
-
path TEXT NOT NULL UNIQUE,
|
|
46
|
-
summary TEXT,
|
|
47
|
-
tags TEXT,
|
|
48
|
-
updated_at TEXT NOT NULL
|
|
49
|
-
);
|
|
50
|
-
|
|
51
|
-
-- Projecao consultavel do audit trail (.context/forja-runs.jsonl), SPEC-014. O jsonl e a
|
|
52
|
-
-- fonte de verdade append-only; esta tabela e reconstruivel por audit:sync. line_hash (hash
|
|
53
|
-
-- do conteudo da linha) da idempotencia: re-sync nao duplica.
|
|
54
|
-
CREATE TABLE IF NOT EXISTS audit_runs (
|
|
55
|
-
line_hash TEXT PRIMARY KEY,
|
|
56
|
-
ts TEXT,
|
|
57
|
-
cmd TEXT,
|
|
58
|
-
args TEXT,
|
|
59
|
-
exit_code INTEGER,
|
|
60
|
-
duration_ms INTEGER
|
|
61
|
-
);
|
|
62
|
-
|
|
63
|
-
CREATE INDEX IF NOT EXISTS idx_context_runs_kind_slug ON context_runs(kind, slug);
|
|
64
|
-
CREATE INDEX IF NOT EXISTS idx_asset_catalog_type_name ON asset_catalog(type, name);
|
|
65
|
-
CREATE INDEX IF NOT EXISTS idx_audit_runs_cmd ON audit_runs(cmd);
|
|
66
|
-
CREATE INDEX IF NOT EXISTS idx_audit_runs_ts ON audit_runs(ts);
|
|
19
|
+
db.exec(`
|
|
20
|
+
CREATE TABLE IF NOT EXISTS spec_summaries (
|
|
21
|
+
slug TEXT PRIMARY KEY,
|
|
22
|
+
status TEXT,
|
|
23
|
+
title TEXT,
|
|
24
|
+
summary TEXT NOT NULL,
|
|
25
|
+
source_path TEXT NOT NULL,
|
|
26
|
+
updated_at TEXT NOT NULL
|
|
27
|
+
);
|
|
28
|
+
|
|
29
|
+
CREATE TABLE IF NOT EXISTS context_runs (
|
|
30
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
31
|
+
created_at TEXT NOT NULL,
|
|
32
|
+
kind TEXT NOT NULL,
|
|
33
|
+
slug TEXT,
|
|
34
|
+
path TEXT NOT NULL,
|
|
35
|
+
bytes INTEGER NOT NULL,
|
|
36
|
+
estimated_tokens INTEGER NOT NULL,
|
|
37
|
+
limit_tokens INTEGER,
|
|
38
|
+
status TEXT NOT NULL
|
|
39
|
+
);
|
|
40
|
+
|
|
41
|
+
CREATE TABLE IF NOT EXISTS asset_catalog (
|
|
42
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
43
|
+
type TEXT NOT NULL,
|
|
44
|
+
name TEXT NOT NULL,
|
|
45
|
+
path TEXT NOT NULL UNIQUE,
|
|
46
|
+
summary TEXT,
|
|
47
|
+
tags TEXT,
|
|
48
|
+
updated_at TEXT NOT NULL
|
|
49
|
+
);
|
|
50
|
+
|
|
51
|
+
-- Projecao consultavel do audit trail (.context/forja-runs.jsonl), SPEC-014. O jsonl e a
|
|
52
|
+
-- fonte de verdade append-only; esta tabela e reconstruivel por audit:sync. line_hash (hash
|
|
53
|
+
-- do conteudo da linha) da idempotencia: re-sync nao duplica.
|
|
54
|
+
CREATE TABLE IF NOT EXISTS audit_runs (
|
|
55
|
+
line_hash TEXT PRIMARY KEY,
|
|
56
|
+
ts TEXT,
|
|
57
|
+
cmd TEXT,
|
|
58
|
+
args TEXT,
|
|
59
|
+
exit_code INTEGER,
|
|
60
|
+
duration_ms INTEGER
|
|
61
|
+
);
|
|
62
|
+
|
|
63
|
+
CREATE INDEX IF NOT EXISTS idx_context_runs_kind_slug ON context_runs(kind, slug);
|
|
64
|
+
CREATE INDEX IF NOT EXISTS idx_asset_catalog_type_name ON asset_catalog(type, name);
|
|
65
|
+
CREATE INDEX IF NOT EXISTS idx_audit_runs_cmd ON audit_runs(cmd);
|
|
66
|
+
CREATE INDEX IF NOT EXISTS idx_audit_runs_ts ON audit_runs(ts);
|
|
67
67
|
`);
|
|
68
68
|
db.close();
|
|
69
69
|
if (!silent)
|
|
@@ -10,19 +10,19 @@ if (!query) {
|
|
|
10
10
|
process.exit(0);
|
|
11
11
|
}
|
|
12
12
|
const db = new Database(dbPath, { readonly: true });
|
|
13
|
-
const search = db.prepare(`
|
|
14
|
-
SELECT
|
|
15
|
-
n.path,
|
|
16
|
-
n.kind,
|
|
17
|
-
n.title,
|
|
18
|
-
p.name as project,
|
|
19
|
-
snippet(search_idx, 2, '>', '<', '...', 20) as snippet
|
|
20
|
-
FROM search_idx
|
|
21
|
-
JOIN memory_nodes n ON n.id = search_idx.node_id
|
|
22
|
-
LEFT JOIN projects p ON p.id = n.project_id
|
|
23
|
-
WHERE search_idx MATCH ?
|
|
24
|
-
ORDER BY rank
|
|
25
|
-
LIMIT ?
|
|
13
|
+
const search = db.prepare(`
|
|
14
|
+
SELECT
|
|
15
|
+
n.path,
|
|
16
|
+
n.kind,
|
|
17
|
+
n.title,
|
|
18
|
+
p.name as project,
|
|
19
|
+
snippet(search_idx, 2, '>', '<', '...', 20) as snippet
|
|
20
|
+
FROM search_idx
|
|
21
|
+
JOIN memory_nodes n ON n.id = search_idx.node_id
|
|
22
|
+
LEFT JOIN projects p ON p.id = n.project_id
|
|
23
|
+
WHERE search_idx MATCH ?
|
|
24
|
+
ORDER BY rank
|
|
25
|
+
LIMIT ?
|
|
26
26
|
`);
|
|
27
27
|
try {
|
|
28
28
|
const results = search.all(query, limit);
|
|
@@ -58,24 +58,24 @@ function startSprint() {
|
|
|
58
58
|
}
|
|
59
59
|
if (toSprint.length === 0)
|
|
60
60
|
return console.log('Nada para mover para a sprint.');
|
|
61
|
-
const sprintContent = `# Sprint Atual
|
|
62
|
-
|
|
63
|
-
## Projeto
|
|
64
|
-
${projectLabel}
|
|
65
|
-
|
|
66
|
-
## Objetivos
|
|
67
|
-
- Completar itens P0/P1 do backlog com handoffs GSD registrados.
|
|
68
|
-
|
|
69
|
-
## Itens da Sprint
|
|
70
|
-
${toSprint.join('\n')}
|
|
71
|
-
|
|
72
|
-
## Ritual CLI
|
|
73
|
-
- Planejar: npm run gsd:plan -- <slug> "<objetivo>"
|
|
74
|
-
- Handoff spec: npm run gsd:handoff -- spec <slug>
|
|
75
|
-
- Handoff plan: npm run gsd:handoff -- plan <slug>
|
|
76
|
-
- Handoff implement: npm run gsd:handoff -- implement <slug>
|
|
77
|
-
- Validar: npm run gsd:check -- <slug>
|
|
78
|
-
- Governanca: npm run project:check
|
|
61
|
+
const sprintContent = `# Sprint Atual
|
|
62
|
+
|
|
63
|
+
## Projeto
|
|
64
|
+
${projectLabel}
|
|
65
|
+
|
|
66
|
+
## Objetivos
|
|
67
|
+
- Completar itens P0/P1 do backlog com handoffs GSD registrados.
|
|
68
|
+
|
|
69
|
+
## Itens da Sprint
|
|
70
|
+
${toSprint.join('\n')}
|
|
71
|
+
|
|
72
|
+
## Ritual CLI
|
|
73
|
+
- Planejar: npm run gsd:plan -- <slug> "<objetivo>"
|
|
74
|
+
- Handoff spec: npm run gsd:handoff -- spec <slug>
|
|
75
|
+
- Handoff plan: npm run gsd:handoff -- plan <slug>
|
|
76
|
+
- Handoff implement: npm run gsd:handoff -- implement <slug>
|
|
77
|
+
- Validar: npm run gsd:check -- <slug>
|
|
78
|
+
- Governanca: npm run project:check
|
|
79
79
|
`;
|
|
80
80
|
fs.writeFileSync(sprintFile, sprintContent, 'utf8');
|
|
81
81
|
if (hasChecklistPriority)
|
|
@@ -142,29 +142,29 @@ function completeSprint() {
|
|
|
142
142
|
const now = new Date();
|
|
143
143
|
const stamp = now.toISOString().replace(/[:]/g, '-');
|
|
144
144
|
const reportFile = path.join(runsDir, `sprint-close-${stamp}.md`);
|
|
145
|
-
const report = `# Fechamento de Sprint
|
|
146
|
-
|
|
147
|
-
## Projeto
|
|
148
|
-
${projectLabel}
|
|
149
|
-
|
|
150
|
-
## Data
|
|
151
|
-
${now.toISOString()}
|
|
152
|
-
|
|
153
|
-
## Entregas concluídas (${done.length})
|
|
154
|
-
${done.length ? done.map((item) => `- ${item}`).join('\n') : '- Nenhuma'}
|
|
155
|
-
|
|
156
|
-
## Pendências realocadas para backlog (${pending.length})
|
|
157
|
-
${pending.length ? pending.map((item) => `- ${item}`).join('\n') : '- Nenhuma'}
|
|
145
|
+
const report = `# Fechamento de Sprint
|
|
146
|
+
|
|
147
|
+
## Projeto
|
|
148
|
+
${projectLabel}
|
|
149
|
+
|
|
150
|
+
## Data
|
|
151
|
+
${now.toISOString()}
|
|
152
|
+
|
|
153
|
+
## Entregas concluídas (${done.length})
|
|
154
|
+
${done.length ? done.map((item) => `- ${item}`).join('\n') : '- Nenhuma'}
|
|
155
|
+
|
|
156
|
+
## Pendências realocadas para backlog (${pending.length})
|
|
157
|
+
${pending.length ? pending.map((item) => `- ${item}`).join('\n') : '- Nenhuma'}
|
|
158
158
|
`;
|
|
159
159
|
fs.writeFileSync(reportFile, report, 'utf8');
|
|
160
|
-
const resetSprint = `# Sprint Atual
|
|
161
|
-
|
|
162
|
-
## Status
|
|
163
|
-
- Encerrada em ${now.toISOString()}
|
|
164
|
-
- Nova sprint ainda não iniciada.
|
|
165
|
-
|
|
166
|
-
## Próximo passo
|
|
167
|
-
- Execute: node scripts/sprint-manager.js start ${projectDir === root ? '' : project}
|
|
160
|
+
const resetSprint = `# Sprint Atual
|
|
161
|
+
|
|
162
|
+
## Status
|
|
163
|
+
- Encerrada em ${now.toISOString()}
|
|
164
|
+
- Nova sprint ainda não iniciada.
|
|
165
|
+
|
|
166
|
+
## Próximo passo
|
|
167
|
+
- Execute: node scripts/sprint-manager.js start ${projectDir === root ? '' : project}
|
|
168
168
|
`;
|
|
169
169
|
fs.writeFileSync(sprintFile, resetSprint, 'utf8');
|
|
170
170
|
console.log(`Sprint encerrada para ${projectLabel}.`);
|
|
@@ -4,11 +4,13 @@ import crypto from 'node:crypto';
|
|
|
4
4
|
import Database from 'better-sqlite3';
|
|
5
5
|
import { fileURLToPath } from 'node:url';
|
|
6
6
|
import { ensureSchema, getDbPath } from "./memory-schema.js";
|
|
7
|
-
import { initWorkspace, getProjectsDir, getWorkspaceSpecsDir, getWorkspaceProjectsMemoryDir, } from "../lib/workspace.js";
|
|
7
|
+
import { initWorkspace, getForjaMode, getWorkspaceRoot, getProjectsDir, getWorkspaceSpecsDir, getWorkspaceProjectsMemoryDir, } from "../lib/workspace.js";
|
|
8
8
|
const __filename = fileURLToPath(import.meta.url);
|
|
9
9
|
const __dirname = path.dirname(__filename);
|
|
10
10
|
const root = path.resolve(__dirname, '..');
|
|
11
11
|
initWorkspace();
|
|
12
|
+
const mode = getForjaMode();
|
|
13
|
+
const operationRoot = getWorkspaceRoot();
|
|
12
14
|
const dbPath = getDbPath();
|
|
13
15
|
const args = process.argv.slice(2);
|
|
14
16
|
const projectArgIndex = args.indexOf('--project');
|
|
@@ -16,32 +18,32 @@ const onlyProject = projectArgIndex >= 0 ? args[projectArgIndex + 1] : null;
|
|
|
16
18
|
const syncGlobal = !onlyProject || args.includes('--global');
|
|
17
19
|
const syncProjects = !args.includes('--global') || Boolean(onlyProject);
|
|
18
20
|
// Schema simplificado para a Memória Universal
|
|
19
|
-
const schema = `
|
|
20
|
-
CREATE TABLE IF NOT EXISTS projects (
|
|
21
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
22
|
-
name TEXT NOT NULL UNIQUE,
|
|
23
|
-
path TEXT NOT NULL,
|
|
24
|
-
created_at TEXT NOT NULL
|
|
25
|
-
);
|
|
26
|
-
|
|
27
|
-
CREATE TABLE IF NOT EXISTS memory_nodes (
|
|
28
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
29
|
-
project_id INTEGER, -- NULL se for global
|
|
30
|
-
path TEXT NOT NULL UNIQUE,
|
|
31
|
-
kind TEXT NOT NULL, -- 'global', 'project', 'domain', 'adr', 'summary'
|
|
32
|
-
title TEXT,
|
|
33
|
-
content TEXT NOT NULL,
|
|
34
|
-
content_hash TEXT NOT NULL,
|
|
35
|
-
updated_at TEXT NOT NULL,
|
|
36
|
-
FOREIGN KEY(project_id) REFERENCES projects(id) ON DELETE CASCADE
|
|
37
|
-
);
|
|
38
|
-
|
|
39
|
-
CREATE VIRTUAL TABLE IF NOT EXISTS search_idx USING fts5(
|
|
40
|
-
node_id UNINDEXED,
|
|
41
|
-
title,
|
|
42
|
-
content,
|
|
43
|
-
tokenize='porter'
|
|
44
|
-
);
|
|
21
|
+
const schema = `
|
|
22
|
+
CREATE TABLE IF NOT EXISTS projects (
|
|
23
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
24
|
+
name TEXT NOT NULL UNIQUE,
|
|
25
|
+
path TEXT NOT NULL,
|
|
26
|
+
created_at TEXT NOT NULL
|
|
27
|
+
);
|
|
28
|
+
|
|
29
|
+
CREATE TABLE IF NOT EXISTS memory_nodes (
|
|
30
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
31
|
+
project_id INTEGER, -- NULL se for global
|
|
32
|
+
path TEXT NOT NULL UNIQUE,
|
|
33
|
+
kind TEXT NOT NULL, -- 'global', 'project', 'domain', 'adr', 'summary'
|
|
34
|
+
title TEXT,
|
|
35
|
+
content TEXT NOT NULL,
|
|
36
|
+
content_hash TEXT NOT NULL,
|
|
37
|
+
updated_at TEXT NOT NULL,
|
|
38
|
+
FOREIGN KEY(project_id) REFERENCES projects(id) ON DELETE CASCADE
|
|
39
|
+
);
|
|
40
|
+
|
|
41
|
+
CREATE VIRTUAL TABLE IF NOT EXISTS search_idx USING fts5(
|
|
42
|
+
node_id UNINDEXED,
|
|
43
|
+
title,
|
|
44
|
+
content,
|
|
45
|
+
tokenize='porter'
|
|
46
|
+
);
|
|
45
47
|
`;
|
|
46
48
|
function log(msg, level = 'info') {
|
|
47
49
|
const prefix = { info: 'INFO', success: 'OK', warn: 'WARN', error: 'ERROR' }[level] || 'INFO';
|
|
@@ -80,25 +82,25 @@ const getProjectId = db.prepare('SELECT id FROM projects WHERE name = ?');
|
|
|
80
82
|
const deleteFts = db.prepare('DELETE FROM search_idx WHERE node_id = ?');
|
|
81
83
|
const insertFts = db.prepare('INSERT INTO search_idx (node_id, title, content) VALUES (?, ?, ?)');
|
|
82
84
|
const purgeFtsOrphans = db.prepare('DELETE FROM search_idx WHERE node_id NOT IN (SELECT id FROM memory_nodes)');
|
|
83
|
-
const upsertSpecSummary = db.prepare(`
|
|
84
|
-
INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
|
|
85
|
-
VALUES (?, ?, ?, ?, ?, ?)
|
|
86
|
-
ON CONFLICT(slug) DO UPDATE SET
|
|
87
|
-
status=excluded.status,
|
|
88
|
-
title=excluded.title,
|
|
89
|
-
summary=excluded.summary,
|
|
90
|
-
source_path=excluded.source_path,
|
|
91
|
-
updated_at=excluded.updated_at
|
|
85
|
+
const upsertSpecSummary = db.prepare(`
|
|
86
|
+
INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
|
|
87
|
+
VALUES (?, ?, ?, ?, ?, ?)
|
|
88
|
+
ON CONFLICT(slug) DO UPDATE SET
|
|
89
|
+
status=excluded.status,
|
|
90
|
+
title=excluded.title,
|
|
91
|
+
summary=excluded.summary,
|
|
92
|
+
source_path=excluded.source_path,
|
|
93
|
+
updated_at=excluded.updated_at
|
|
92
94
|
`);
|
|
93
|
-
const upsertAsset = db.prepare(`
|
|
94
|
-
INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
|
|
95
|
-
VALUES (?, ?, ?, ?, ?, ?)
|
|
96
|
-
ON CONFLICT(path) DO UPDATE SET
|
|
97
|
-
type=excluded.type,
|
|
98
|
-
name=excluded.name,
|
|
99
|
-
summary=excluded.summary,
|
|
100
|
-
tags=excluded.tags,
|
|
101
|
-
updated_at=excluded.updated_at
|
|
95
|
+
const upsertAsset = db.prepare(`
|
|
96
|
+
INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
|
|
97
|
+
VALUES (?, ?, ?, ?, ?, ?)
|
|
98
|
+
ON CONFLICT(path) DO UPDATE SET
|
|
99
|
+
type=excluded.type,
|
|
100
|
+
name=excluded.name,
|
|
101
|
+
summary=excluded.summary,
|
|
102
|
+
tags=excluded.tags,
|
|
103
|
+
updated_at=excluded.updated_at
|
|
102
104
|
`);
|
|
103
105
|
const now = new Date().toISOString();
|
|
104
106
|
function getKind(relPath) {
|
|
@@ -233,9 +235,9 @@ function syncFiles(files, projectId = null) {
|
|
|
233
235
|
if (syncGlobal) {
|
|
234
236
|
log('Sincronizando Memória Global...', 'info');
|
|
235
237
|
const globalFiles = [
|
|
236
|
-
...walk(path.join(root, 'memory')),
|
|
237
|
-
...walk(path.join(root, 'docs')),
|
|
238
|
-
...walk(path.join(root, 'prompts')),
|
|
238
|
+
...walk(path.join(mode === 'embedded' ? operationRoot : root, 'memory')),
|
|
239
|
+
...walk(path.join(mode === 'embedded' ? operationRoot : root, 'docs')),
|
|
240
|
+
...walk(path.join(mode === 'embedded' ? operationRoot : root, 'prompts')),
|
|
239
241
|
];
|
|
240
242
|
syncFiles(globalFiles);
|
|
241
243
|
syncSpecSummaries();
|
|
@@ -243,7 +245,18 @@ if (syncGlobal) {
|
|
|
243
245
|
}
|
|
244
246
|
// 2. Sincronizar Projetos do Workspace
|
|
245
247
|
const projectsDir = getProjectsDir();
|
|
246
|
-
if (syncProjects &&
|
|
248
|
+
if (syncProjects && mode === 'embedded') {
|
|
249
|
+
const projectName = path.basename(operationRoot);
|
|
250
|
+
upsertProject.run(projectName, operationRoot, now);
|
|
251
|
+
const pid = getProjectId.get(projectName).id;
|
|
252
|
+
syncFiles([
|
|
253
|
+
...walk(path.join(operationRoot, 'memory')),
|
|
254
|
+
...walk(path.join(operationRoot, 'docs')),
|
|
255
|
+
...walk(path.join(operationRoot, 'specs')),
|
|
256
|
+
...walk(path.join(operationRoot, 'design-md')),
|
|
257
|
+
], pid);
|
|
258
|
+
}
|
|
259
|
+
else if (syncProjects && fs.existsSync(projectsDir)) {
|
|
247
260
|
const projects = fs.readdirSync(projectsDir, { withFileTypes: true })
|
|
248
261
|
.filter(e => e.isDirectory())
|
|
249
262
|
.filter(e => !onlyProject || e.name === onlyProject);
|
|
@@ -265,7 +278,7 @@ if (syncProjects && fs.existsSync(projectsDir)) {
|
|
|
265
278
|
}
|
|
266
279
|
// 3. Sincronizar fichas de projetos no workspace memory/30-projects
|
|
267
280
|
const workspaceProjectsMemoryDir = getWorkspaceProjectsMemoryDir();
|
|
268
|
-
if (fs.existsSync(workspaceProjectsMemoryDir)) {
|
|
281
|
+
if (mode === 'studio' && fs.existsSync(workspaceProjectsMemoryDir)) {
|
|
269
282
|
const fichaFiles = walk(workspaceProjectsMemoryDir);
|
|
270
283
|
syncFiles(fichaFiles);
|
|
271
284
|
}
|
|
@@ -1,35 +1,35 @@
|
|
|
1
|
-
# CLI como adaptador do Capability Registry
|
|
2
|
-
|
|
3
|
-
Sprint 1 unifica os três comandos de prova abaixo com o registry executável. O comando legado
|
|
4
|
-
continua disponível como alias; a lógica é executada por um handler injetado no adaptador, e não
|
|
5
|
-
por uma implementação paralela no CLI.
|
|
6
|
-
|
|
7
|
-
| Comando legado | Capability | Input | Observação |
|
|
8
|
-
| --- | --- | --- | --- |
|
|
9
|
-
| `tools:doctor` | `system.doctor` | `{}` | diagnóstico local determinístico |
|
|
10
|
-
| `code:impact <symbol> [depth]` | `code.impact` | `{ symbol, depth? }` | depth entre 1 e 10 |
|
|
11
|
-
| `context:budget <target> [limitTokens]` | `context.budget` | `{ target, limitTokens? }` | limite positivo |
|
|
12
|
-
| `spec:check [feature]` | `spec.validate` | `{ feature? }` | valida uma spec ou todas |
|
|
13
|
-
| `sprint:status [project]` | `sprint.status` | `{ project? }` | consulta a sprint atual |
|
|
14
|
-
| `gsd:handoff <phase> <slug> [context]` | `handoff.create` | `{ phase, slug, context? }` | grava handoff local governado |
|
|
15
|
-
|
|
16
|
-
## Descoberta e execução
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
forja capabilities:list --json
|
|
20
|
-
forja capabilities:describe code.impact --json
|
|
21
|
-
forja capability:execute code.impact --input '{"symbol":"CapabilityRegistry","depth":2}' --json
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
Os três comandos legados também aceitam `--json` e retornam o mesmo `ExecutionResult` versionado:
|
|
25
|
-
|
|
26
|
-
```bash
|
|
27
|
-
forja tools:doctor --json
|
|
28
|
-
forja code:impact CapabilityRegistry 2 --json
|
|
29
|
-
forja context:budget docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md 10000 --json
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
O envelope inclui `runId`, `correlationId`, `status`, `output`, `evidence` e erro normalizado
|
|
33
|
-
quando aplicável. Entrada inválida é rejeitada antes do handler; política é avaliada pelo
|
|
34
|
-
`CapabilityRegistry` antes da execução. Comandos ainda não migrados permanecem no dispatch
|
|
35
|
-
legado durante a migração progressiva.
|
|
1
|
+
# CLI como adaptador do Capability Registry
|
|
2
|
+
|
|
3
|
+
Sprint 1 unifica os três comandos de prova abaixo com o registry executável. O comando legado
|
|
4
|
+
continua disponível como alias; a lógica é executada por um handler injetado no adaptador, e não
|
|
5
|
+
por uma implementação paralela no CLI.
|
|
6
|
+
|
|
7
|
+
| Comando legado | Capability | Input | Observação |
|
|
8
|
+
| --- | --- | --- | --- |
|
|
9
|
+
| `tools:doctor` | `system.doctor` | `{}` | diagnóstico local determinístico |
|
|
10
|
+
| `code:impact <symbol> [depth]` | `code.impact` | `{ symbol, depth? }` | depth entre 1 e 10 |
|
|
11
|
+
| `context:budget <target> [limitTokens]` | `context.budget` | `{ target, limitTokens? }` | limite positivo |
|
|
12
|
+
| `spec:check [feature]` | `spec.validate` | `{ feature? }` | valida uma spec ou todas |
|
|
13
|
+
| `sprint:status [project]` | `sprint.status` | `{ project? }` | consulta a sprint atual |
|
|
14
|
+
| `gsd:handoff <phase> <slug> [context]` | `handoff.create` | `{ phase, slug, context? }` | grava handoff local governado |
|
|
15
|
+
|
|
16
|
+
## Descoberta e execução
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
forja capabilities:list --json
|
|
20
|
+
forja capabilities:describe code.impact --json
|
|
21
|
+
forja capability:execute code.impact --input '{"symbol":"CapabilityRegistry","depth":2}' --json
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Os três comandos legados também aceitam `--json` e retornam o mesmo `ExecutionResult` versionado:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
forja tools:doctor --json
|
|
28
|
+
forja code:impact CapabilityRegistry 2 --json
|
|
29
|
+
forja context:budget docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md 10000 --json
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
O envelope inclui `runId`, `correlationId`, `status`, `output`, `evidence` e erro normalizado
|
|
33
|
+
quando aplicável. Entrada inválida é rejeitada antes do handler; política é avaliada pelo
|
|
34
|
+
`CapabilityRegistry` antes da execução. Comandos ainda não migrados permanecem no dispatch
|
|
35
|
+
legado durante a migração progressiva.
|