forjajs 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -0
- package/.claude/agents/governance.md +32 -0
- package/.claude/agents/marketing.md +24 -0
- package/.claude/agents/orchestrator.md +31 -0
- package/.claude/agents/product.md +26 -0
- package/.claude/agents/sdd-architect.md +34 -0
- package/.claude/settings.json +41 -0
- package/.gemini-instructions.md +87 -0
- package/.github/copilot-instructions.md +87 -0
- package/.memoryrc.json +104 -0
- package/.openai-instructions.md +87 -0
- package/AGENTS.md +132 -0
- package/CHANGELOG.md +106 -0
- package/CONTRIBUTING.md +32 -0
- package/DOC-MAP.md +65 -0
- package/LICENSE +21 -0
- package/README.md +260 -0
- package/bin/create-memory-nest-kit.js +125 -0
- package/bin/forja.mjs +143 -0
- package/bin/init-project.js +612 -0
- package/boilerplates/01-api-rest/README.md +336 -0
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -0
- package/boilerplates/02-saas-starter/.env.example +25 -0
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -0
- package/boilerplates/02-saas-starter/INFO.md +252 -0
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -0
- package/boilerplates/02-saas-starter/README.md +305 -0
- package/boilerplates/02-saas-starter/START-HERE.md +259 -0
- package/boilerplates/02-saas-starter/backend/package.json +87 -0
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -0
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -0
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -0
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -0
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -0
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -0
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -0
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -0
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -0
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -0
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -0
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -0
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -0
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -0
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -0
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -0
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -0
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -0
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -0
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -0
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -0
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -0
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -0
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -0
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -0
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -0
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -0
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -0
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -0
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -0
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -0
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -0
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -0
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -0
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -0
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -0
- package/boilerplates/03-ecommerce-starter/README.md +465 -0
- package/boilerplates/03-ecommerce-starter/agents/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -0
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -0
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -0
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -0
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -0
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -0
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -0
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -0
- package/boilerplates/03-ecommerce-starter/backend/src/common/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -0
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -0
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -0
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -0
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -0
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -0
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -0
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -0
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -0
- package/boilerplates/03-ecommerce-starter/memory/40-delivery/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/50-orchestration/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/60-runs/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/70-summaries/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/80-data/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -0
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -0
- package/boilerplates/03-ecommerce-starter/prompts/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/skills/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/.env.example +43 -0
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -0
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -0
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -0
- package/boilerplates/04-microservices-starter/INDEX.md +377 -0
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -0
- package/boilerplates/04-microservices-starter/README.md +466 -0
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/notification/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/user/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/auth/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/user/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/auth/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/notification/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/types/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -0
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -0
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -0
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -0
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -0
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -0
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -0
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -0
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -0
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -0
- package/boilerplates/04-microservices-starter/memory/40-delivery/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -0
- package/boilerplates/04-microservices-starter/memory/60-runs/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/70-summaries/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/80-data/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/90-decisions/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/package.json +21 -0
- package/boilerplates/05-monorepo-starter/.env.example +1 -0
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -0
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -0
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -0
- package/boilerplates/05-monorepo-starter/README.md +318 -0
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -0
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -0
- package/boilerplates/05-monorepo-starter/memory/40-delivery/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/50-orchestration/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/60-runs/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/70-summaries/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/80-data/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/90-decisions/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/package.json +30 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -0
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -0
- package/boilerplates/05-monorepo-starter/turbo.json +35 -0
- package/boilerplates/README.md +407 -0
- package/design-md/BRIEF-TEMPLATE.md +47 -0
- package/design-md/INDEX.md +35 -0
- package/design-md/MATRIX.md +24 -0
- package/design-md/PLAYBOOK.md +35 -0
- package/design-md/examples/agent-console-brief.md +48 -0
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -0
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -0
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -0
- package/docs/agent-harnesses.md +122 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -0
- package/docs/archive/FASE2-SUMMARY.md +263 -0
- package/docs/archive/FASE3-PROGRESS.md +355 -0
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -0
- package/docs/archive/INDICE-MASTER.md +282 -0
- package/docs/archive/PROJETO-COMPLETO.md +363 -0
- package/docs/archive/README-REFINAMENTO.md +293 -0
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -0
- package/docs/archive/REFINAMENTO-v1.0.md +565 -0
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -0
- package/docs/archive/START-HERE.md +319 -0
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -0
- package/docs/archive/examples/v1/AGENTS.md +10 -0
- package/docs/archive/examples/v1/README.md +36 -0
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -0
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -0
- package/docs/archive/examples/v1/backend/package.json +42 -0
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -0
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -0
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -0
- package/docs/archive/examples/v1/backend/src/main.ts +10 -0
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -0
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -0
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -0
- package/docs/archive/examples/v1/docs/.gitkeep +0 -0
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -0
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -0
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -0
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -0
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -0
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -0
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -0
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -0
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -0
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -0
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -0
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -0
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -0
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/shared/.gitkeep +0 -0
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -0
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -0
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -0
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -0
- package/docs/archive/examples/v1/memory/90-decisions/archive/.gitkeep +0 -0
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -0
- package/docs/archive/examples/v1/scripts/.gitkeep +0 -0
- package/docs/archive/examples/v2/.memoryrc.json +8 -0
- package/docs/archive/examples/v2/AGENTS.md +16 -0
- package/docs/archive/examples/v2/README.md +35 -0
- package/docs/archive/examples/v2/agents/README.md +3 -0
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -0
- package/docs/archive/examples/v2/agents/dba.md +4 -0
- package/docs/archive/examples/v2/agents/frontend.md +4 -0
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -0
- package/docs/archive/examples/v2/agents/reviewer.md +6 -0
- package/docs/archive/examples/v2/agents/security.md +4 -0
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -0
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -0
- package/docs/archive/examples/v2/backend/package.json +42 -0
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -0
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -0
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -0
- package/docs/archive/examples/v2/backend/src/main.ts +10 -0
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -0
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -0
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -0
- package/docs/archive/examples/v2/docs/.gitkeep +0 -0
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -0
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -0
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -0
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -0
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -0
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -0
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -0
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -0
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -0
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -0
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -0
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -0
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -0
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -0
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/shared/.gitkeep +0 -0
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -0
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -0
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -0
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -0
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -0
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -0
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -0
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -0
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -0
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -0
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -0
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -0
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -0
- package/docs/archive/examples/v2/memory/90-decisions/archive/.gitkeep +0 -0
- package/docs/archive/examples/v2/memory/README.md +8 -0
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -0
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -0
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -0
- package/docs/archive/examples/v2/scripts/.gitkeep +0 -0
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -0
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -0
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -0
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -0
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -0
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -0
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -0
- package/docs/capacidades-externas.md +70 -0
- package/docs/cli-first-operacao.md +74 -0
- package/docs/dashboard.md +102 -0
- package/docs/dev-workflow.md +421 -0
- package/docs/examples.md +546 -0
- package/docs/fluxo.md +103 -0
- package/docs/glossary.md +453 -0
- package/docs/init-project.md +457 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -0
- package/docs/personas/architect/README.md +333 -0
- package/docs/personas/developer/README.md +371 -0
- package/docs/personas/executive/README.md +172 -0
- package/docs/personas/qa/README.md +350 -0
- package/docs/processo-projeto.md +138 -0
- package/docs/publishing.md +377 -0
- package/docs/quick-reference.md +409 -0
- package/docs/structure.md +360 -0
- package/docs/token-optimization.md +494 -0
- package/lib/context-builder.js +257 -0
- package/lib/core/registry.mjs +284 -0
- package/lib/generators/memory-generator.js +844 -0
- package/lib/generators/nest-generator.js +496 -0
- package/lib/generators/readme-generator.js +213 -0
- package/lib/templates/harness/code-intel.mjs +119 -0
- package/lib/templates/harness/mcp.json +10 -0
- package/lib/utils/file-helpers.js +40 -0
- package/lib/validators/structure-validator.js +253 -0
- package/lib/workspace.mjs +213 -0
- package/memory/00-global/mission.md +15 -0
- package/memory/00-global/shared-knowledge.md +8 -0
- package/memory/00-global/standards.md +47 -0
- package/memory/10-product/personas.md +21 -0
- package/memory/10-product/vision.md +27 -0
- package/memory/30-projects/README.md +15 -0
- package/memory/40-delivery/backlog.md +15 -0
- package/memory/40-delivery/current-sprint.md +21 -0
- package/memory/50-orchestration/gsd-harness.md +55 -0
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -0
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -0
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -0
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -0
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -0
- package/memory/90-decisions/0006-docs-por-persona.md +23 -0
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -0
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -0
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -0
- package/memory/90-decisions/0010-banco-postgres.md +30 -0
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -0
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -0
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -0
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -0
- package/memory/90-decisions/0019-workspace-separado.md +45 -0
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -0
- package/memory/90-decisions/_template.md +28 -0
- package/package.json +107 -0
- package/prompts/context-engineer-agent.md +19 -0
- package/prompts/governance-agent.md +15 -0
- package/prompts/marketing-agent.md +13 -0
- package/prompts/orchestrator-agent.md +18 -0
- package/prompts/product-agent.md +13 -0
- package/prompts/sdd-architect-agent.md +20 -0
- package/scripts/agent-harness.mjs +578 -0
- package/scripts/agent-router.mjs +189 -0
- package/scripts/build-smart-context.js +87 -0
- package/scripts/check-standards.js +98 -0
- package/scripts/compress-memory.mjs +198 -0
- package/scripts/compress-project-memory.js +58 -0
- package/scripts/context-ops.mjs +463 -0
- package/scripts/dev.mjs +349 -0
- package/scripts/extract-global-knowledge.js +52 -0
- package/scripts/generate-dashboard.js +59 -0
- package/scripts/hook-session-start.mjs +70 -0
- package/scripts/hook-user-prompt.mjs +185 -0
- package/scripts/memory-schema.mjs +68 -0
- package/scripts/pre-commit.sh +102 -0
- package/scripts/query-universal-memory.js +50 -0
- package/scripts/spec-cli.mjs +193 -0
- package/scripts/sprint-manager.js +200 -0
- package/scripts/sync-universal-memory.js +278 -0
- package/scripts/token-benchmark.mjs +203 -0
- package/scripts/tools-doctor.mjs +77 -0
- package/specs/README.md +70 -0
- package/specs/_templates/plan.md +43 -0
- package/specs/_templates/spec.md +43 -0
- package/specs/_templates/tasks.md +32 -0
- package/specs/agent-dashboard/plan.md +165 -0
- package/specs/agent-dashboard/spec.md +89 -0
- package/specs/agent-dashboard/tasks.md +168 -0
- package/specs/cli-first-operacao/plan.md +53 -0
- package/specs/cli-first-operacao/spec.md +53 -0
- package/specs/cli-first-operacao/tasks.md +53 -0
- package/specs/dev-token-assets-db/plan.md +71 -0
- package/specs/dev-token-assets-db/spec.md +58 -0
- package/specs/dev-token-assets-db/tasks.md +58 -0
- package/specs/forja-core/spec.md +71 -0
- package/specs/harness-codegraph/spec.md +71 -0
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -0
- package/specs/reestruturacao-forja-v2/plan.md +95 -0
- package/specs/reestruturacao-forja-v2/spec.md +70 -0
- package/specs/reestruturacao-forja-v2/tasks.md +113 -0
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* agent-router — registra e consulta handoffs entre sub-agents.
|
|
4
|
+
*
|
|
5
|
+
* Schema (criado on-demand em universal.db):
|
|
6
|
+
*
|
|
7
|
+
* CREATE TABLE handoffs (
|
|
8
|
+
* id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
9
|
+
* created_at TEXT NOT NULL,
|
|
10
|
+
* from_agent TEXT NOT NULL,
|
|
11
|
+
* to_agent TEXT NOT NULL,
|
|
12
|
+
* intent TEXT NOT NULL, -- implement|review|plan|research
|
|
13
|
+
* context TEXT NOT NULL, -- paths, refs, links
|
|
14
|
+
* acceptance TEXT NOT NULL, -- AC mensurável
|
|
15
|
+
* constraints TEXT NOT NULL, -- limites
|
|
16
|
+
* return_to TEXT NOT NULL, -- para onde devolver
|
|
17
|
+
* spec_slug TEXT, -- specs/<slug> opcional
|
|
18
|
+
* status TEXT DEFAULT 'open', -- open|in_progress|done|cancelled|archived
|
|
19
|
+
* payload_json TEXT
|
|
20
|
+
* );
|
|
21
|
+
*
|
|
22
|
+
* Uso:
|
|
23
|
+
* agent-router append < handoff.json # lê JSON do stdin
|
|
24
|
+
* agent-router append '{"from":"product",...}'
|
|
25
|
+
* agent-router list [--open] [--to <agent>]
|
|
26
|
+
* agent-router show <id>
|
|
27
|
+
* agent-router done <id>
|
|
28
|
+
* agent-router schema # imprime schema/migra
|
|
29
|
+
*/
|
|
30
|
+
|
|
31
|
+
import fs from 'node:fs';
|
|
32
|
+
import path from 'node:path';
|
|
33
|
+
import process from 'node:process';
|
|
34
|
+
import { fileURLToPath } from 'node:url';
|
|
35
|
+
import Database from 'better-sqlite3';
|
|
36
|
+
import { getDbPath, ensureSchema } from './memory-schema.mjs';
|
|
37
|
+
|
|
38
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
39
|
+
const __dirname = path.dirname(__filename);
|
|
40
|
+
const root = path.resolve(__dirname, '..');
|
|
41
|
+
ensureSchema({ silent: true });
|
|
42
|
+
const dbPath = getDbPath();
|
|
43
|
+
|
|
44
|
+
const REQUIRED = ['from', 'to', 'intent', 'context', 'acceptance', 'constraints', 'return'];
|
|
45
|
+
const VALID_AGENTS = ['orchestrator', 'context-engineer', 'sdd-architect', 'product', 'marketing', 'governance', 'worker', 'user'];
|
|
46
|
+
const VALID_INTENTS = ['implement', 'review', 'plan', 'research', 'spec', 'route'];
|
|
47
|
+
const BUSY_ATTEMPTS = 8;
|
|
48
|
+
const BUSY_DELAY_MS = 150;
|
|
49
|
+
|
|
50
|
+
function fail(msg, code = 1) {
|
|
51
|
+
fs.writeSync(2, `[agent-router] ${msg}\n`);
|
|
52
|
+
process.exit(code);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
function openDb() {
|
|
56
|
+
fs.mkdirSync(path.dirname(dbPath), { recursive: true });
|
|
57
|
+
const db = new Database(dbPath, { timeout: 5000 });
|
|
58
|
+
db.pragma('busy_timeout = 5000');
|
|
59
|
+
db.pragma('journal_mode = WAL');
|
|
60
|
+
withBusyRetry(() => db.exec(`
|
|
61
|
+
CREATE TABLE IF NOT EXISTS handoffs (
|
|
62
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
63
|
+
created_at TEXT NOT NULL,
|
|
64
|
+
from_agent TEXT NOT NULL,
|
|
65
|
+
to_agent TEXT NOT NULL,
|
|
66
|
+
intent TEXT NOT NULL,
|
|
67
|
+
context TEXT NOT NULL,
|
|
68
|
+
acceptance TEXT NOT NULL,
|
|
69
|
+
constraints TEXT NOT NULL,
|
|
70
|
+
return_to TEXT NOT NULL,
|
|
71
|
+
spec_slug TEXT,
|
|
72
|
+
status TEXT DEFAULT 'open',
|
|
73
|
+
payload_json TEXT
|
|
74
|
+
);
|
|
75
|
+
CREATE INDEX IF NOT EXISTS idx_handoffs_status ON handoffs(status);
|
|
76
|
+
CREATE INDEX IF NOT EXISTS idx_handoffs_to ON handoffs(to_agent, status);
|
|
77
|
+
`));
|
|
78
|
+
return db;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
function sleepSync(ms) {
|
|
82
|
+
const buffer = new SharedArrayBuffer(4);
|
|
83
|
+
const view = new Int32Array(buffer);
|
|
84
|
+
Atomics.wait(view, 0, 0, ms);
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
function withBusyRetry(fn) {
|
|
88
|
+
let lastError;
|
|
89
|
+
for (let attempt = 1; attempt <= BUSY_ATTEMPTS; attempt++) {
|
|
90
|
+
try { return fn(); }
|
|
91
|
+
catch (err) {
|
|
92
|
+
if (err?.code !== 'SQLITE_BUSY' && err?.code !== 'SQLITE_LOCKED') throw err;
|
|
93
|
+
lastError = err;
|
|
94
|
+
sleepSync(BUSY_DELAY_MS * attempt);
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
throw lastError;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
function readStdin() {
|
|
101
|
+
return fs.readFileSync(0, 'utf8');
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
function parsePayload(raw) {
|
|
105
|
+
let obj;
|
|
106
|
+
try { obj = JSON.parse(raw); } catch (e) { fail(`JSON inválido: ${e.message}`); }
|
|
107
|
+
for (const k of REQUIRED) {
|
|
108
|
+
if (!obj[k] || typeof obj[k] !== 'string') fail(`campo obrigatório ausente ou inválido: ${k} (ADR-0005)`);
|
|
109
|
+
}
|
|
110
|
+
if (!VALID_AGENTS.includes(obj.from)) fail(`from inválido: ${obj.from}. Use um de: ${VALID_AGENTS.join(', ')}`);
|
|
111
|
+
if (!VALID_AGENTS.includes(obj.to)) fail(`to inválido: ${obj.to}`);
|
|
112
|
+
if (!VALID_INTENTS.includes(obj.intent)) fail(`intent inválido: ${obj.intent}. Use: ${VALID_INTENTS.join(', ')}`);
|
|
113
|
+
return obj;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
function cmdAppend(arg) {
|
|
117
|
+
const raw = arg && arg !== '-' ? arg : readStdin();
|
|
118
|
+
const h = parsePayload(raw);
|
|
119
|
+
const db = openDb();
|
|
120
|
+
const stmt = db.prepare(`
|
|
121
|
+
INSERT INTO handoffs (created_at, from_agent, to_agent, intent, context, acceptance, constraints, return_to, spec_slug, payload_json)
|
|
122
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
|
|
123
|
+
`);
|
|
124
|
+
const result = withBusyRetry(() => stmt.run(
|
|
125
|
+
new Date().toISOString(),
|
|
126
|
+
h.from, h.to, h.intent,
|
|
127
|
+
h.context, h.acceptance, h.constraints, h.return,
|
|
128
|
+
h.spec_slug || null,
|
|
129
|
+
JSON.stringify(h)
|
|
130
|
+
));
|
|
131
|
+
console.log(JSON.stringify({ id: result.lastInsertRowid, status: 'open', from: h.from, to: h.to, intent: h.intent }));
|
|
132
|
+
db.close();
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
function cmdList(args) {
|
|
136
|
+
const db = openDb();
|
|
137
|
+
const filters = [];
|
|
138
|
+
const params = [];
|
|
139
|
+
if (args.includes('--open')) filters.push("status = 'open'");
|
|
140
|
+
const toIdx = args.indexOf('--to');
|
|
141
|
+
if (toIdx >= 0 && args[toIdx + 1]) { filters.push('to_agent = ?'); params.push(args[toIdx + 1]); }
|
|
142
|
+
const where = filters.length ? `WHERE ${filters.join(' AND ')}` : '';
|
|
143
|
+
const rows = db.prepare(`SELECT id, created_at, from_agent, to_agent, intent, status, spec_slug FROM handoffs ${where} ORDER BY id DESC LIMIT 50`).all(...params);
|
|
144
|
+
if (!rows.length) { console.log('(sem handoffs)'); db.close(); return; }
|
|
145
|
+
for (const r of rows) {
|
|
146
|
+
console.log(`#${r.id} [${r.status}] ${r.from_agent} → ${r.to_agent} (${r.intent}) ${r.spec_slug || ''} — ${r.created_at}`);
|
|
147
|
+
}
|
|
148
|
+
db.close();
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
function cmdShow(idArg) {
|
|
152
|
+
const id = parseInt(idArg, 10);
|
|
153
|
+
if (!id) fail('uso: agent-router show <id>');
|
|
154
|
+
const db = openDb();
|
|
155
|
+
const row = db.prepare('SELECT * FROM handoffs WHERE id = ?').get(id);
|
|
156
|
+
if (!row) fail(`handoff ${id} não encontrado`);
|
|
157
|
+
console.log(JSON.stringify(row, null, 2));
|
|
158
|
+
db.close();
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
function cmdSetStatus(idArg, status) {
|
|
162
|
+
const id = parseInt(idArg, 10);
|
|
163
|
+
if (!id) fail(`uso: agent-router ${status} <id>`);
|
|
164
|
+
const db = openDb();
|
|
165
|
+
const r = withBusyRetry(() => db.prepare('UPDATE handoffs SET status = ? WHERE id = ?').run(status, id));
|
|
166
|
+
if (!r.changes) fail(`handoff ${id} não encontrado`);
|
|
167
|
+
fs.writeSync(1, `handoff #${id} → ${status}\n`);
|
|
168
|
+
db.close();
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
function cmdSchema() {
|
|
172
|
+
openDb().close();
|
|
173
|
+
console.log(`✓ schema OK em ${dbPath}`);
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
const [, , subcmd, ...rest] = process.argv;
|
|
177
|
+
switch (subcmd) {
|
|
178
|
+
case 'append': cmdAppend(rest[0]); break;
|
|
179
|
+
case 'list': cmdList(rest); break;
|
|
180
|
+
case 'show': cmdShow(rest[0]); break;
|
|
181
|
+
case 'done': cmdSetStatus(rest[0], 'done'); break;
|
|
182
|
+
case 'in_progress': cmdSetStatus(rest[0], 'in_progress'); break;
|
|
183
|
+
case 'cancel': cmdSetStatus(rest[0], 'cancelled'); break;
|
|
184
|
+
case 'archive': cmdSetStatus(rest[0], 'archived'); break;
|
|
185
|
+
case 'schema': cmdSchema(); break;
|
|
186
|
+
default:
|
|
187
|
+
console.log('Uso: agent-router <append|list|show|done|in_progress|cancel|archive|schema> [args]');
|
|
188
|
+
process.exit(1);
|
|
189
|
+
}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import Database from 'better-sqlite3';
|
|
4
|
+
import { getDbPath, ensureSchema } from './memory-schema.mjs';
|
|
5
|
+
import { resolveProject, initWorkspace } from '../lib/workspace.mjs';
|
|
6
|
+
|
|
7
|
+
initWorkspace();
|
|
8
|
+
ensureSchema({ silent: true });
|
|
9
|
+
const dbPath = getDbPath();
|
|
10
|
+
|
|
11
|
+
const [project, taskKeyword = ''] = process.argv.slice(2);
|
|
12
|
+
|
|
13
|
+
if (!project) {
|
|
14
|
+
console.log('Uso: node scripts/build-smart-context.js <projeto> [keyword]');
|
|
15
|
+
process.exit(0);
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
const db = new Database(dbPath, { readonly: true });
|
|
19
|
+
|
|
20
|
+
function getSmartContext() {
|
|
21
|
+
console.log(`🔍 Construindo contexto inteligente para: ${project} (Busca: ${taskKeyword || 'global'})...`);
|
|
22
|
+
|
|
23
|
+
// 1. Pegar arquivos globais obrigatórios
|
|
24
|
+
const globalNodes = db.prepare(`
|
|
25
|
+
SELECT title, content, path FROM memory_nodes
|
|
26
|
+
WHERE project_id IS NULL AND (path LIKE '%mission.md' OR path LIKE '%standards.md')
|
|
27
|
+
`).all();
|
|
28
|
+
|
|
29
|
+
// 2. Pegar arquivos do projeto por keyword ou gerais
|
|
30
|
+
let projectNodes = [];
|
|
31
|
+
if (taskKeyword) {
|
|
32
|
+
projectNodes = db.prepare(`
|
|
33
|
+
SELECT n.title, n.content, n.path
|
|
34
|
+
FROM memory_nodes n
|
|
35
|
+
JOIN projects p ON p.id = n.project_id
|
|
36
|
+
JOIN search_idx s ON s.node_id = n.id
|
|
37
|
+
WHERE p.name = ? AND search_idx MATCH ?
|
|
38
|
+
LIMIT 10
|
|
39
|
+
`).all(project, taskKeyword);
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
// 3. Pegar ADRs e Summaries recentes do projeto
|
|
43
|
+
const metadata = db.prepare(`
|
|
44
|
+
SELECT n.title, n.content, n.path
|
|
45
|
+
FROM memory_nodes n
|
|
46
|
+
JOIN projects p ON p.id = n.project_id
|
|
47
|
+
WHERE p.name = ? AND (n.kind = 'adr' OR n.kind = 'summary' OR n.path LIKE '%vision.md')
|
|
48
|
+
ORDER BY n.updated_at DESC LIMIT 5
|
|
49
|
+
`).all(project);
|
|
50
|
+
|
|
51
|
+
const designIndex = db.prepare(`
|
|
52
|
+
SELECT n.title, n.content, n.path
|
|
53
|
+
FROM memory_nodes n
|
|
54
|
+
JOIN projects p ON p.id = n.project_id
|
|
55
|
+
WHERE p.name = ? AND n.kind = 'design' AND n.path LIKE '%/design-md/INDEX.md'
|
|
56
|
+
ORDER BY n.updated_at DESC LIMIT 1
|
|
57
|
+
`).all(project);
|
|
58
|
+
|
|
59
|
+
const allNodes = [...globalNodes, ...projectNodes, ...metadata, ...designIndex];
|
|
60
|
+
|
|
61
|
+
let contextPack = `# SMART CONTEXT PACK: ${project.toUpperCase()}\n\n`;
|
|
62
|
+
contextPack += `> Gerado em: ${new Date().toISOString()}\n`;
|
|
63
|
+
contextPack += `> Keyword de Tarefa: ${taskKeyword || 'N/A'}\n\n`;
|
|
64
|
+
|
|
65
|
+
const seen = new Set();
|
|
66
|
+
for (const node of allNodes) {
|
|
67
|
+
if (seen.has(node.path)) continue;
|
|
68
|
+
seen.add(node.path);
|
|
69
|
+
contextPack += `## FILE: ${node.path}\n\n${node.content}\n\n---\n\n`;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
const outDir = path.join(resolveProject(project), '.context');
|
|
73
|
+
if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
|
|
74
|
+
|
|
75
|
+
const outFile = path.join(outDir, 'smart-context.md');
|
|
76
|
+
fs.writeFileSync(outFile, contextPack, 'utf8');
|
|
77
|
+
|
|
78
|
+
console.log(`✅ Contexto inteligente gerado: ${outFile} (${seen.size} arquivos incluídos).`);
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
try {
|
|
82
|
+
getSmartContext();
|
|
83
|
+
} catch (e) {
|
|
84
|
+
console.error('Erro ao gerar contexto inteligente:', e.message);
|
|
85
|
+
} finally {
|
|
86
|
+
db.close();
|
|
87
|
+
}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { fileURLToPath } from 'node:url';
|
|
4
|
+
import { resolveProject, getWorkspaceInfo, initWorkspace } from '../lib/workspace.mjs';
|
|
5
|
+
|
|
6
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
7
|
+
const __dirname = path.dirname(__filename);
|
|
8
|
+
const root = path.resolve(__dirname, '..');
|
|
9
|
+
|
|
10
|
+
const [projectArg] = process.argv.slice(2);
|
|
11
|
+
|
|
12
|
+
const project = projectArg || 'framework-root';
|
|
13
|
+
let projectDir;
|
|
14
|
+
if (projectArg) {
|
|
15
|
+
initWorkspace();
|
|
16
|
+
projectDir = resolveProject(projectArg);
|
|
17
|
+
} else {
|
|
18
|
+
projectDir = root;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
const PROJECT_MANDATORY_FILES = [
|
|
22
|
+
'memory/00-global/mission.md',
|
|
23
|
+
'memory/10-product/vision.md',
|
|
24
|
+
'memory/20-architecture/scaling-patterns.md', // Criado pelo nosso init
|
|
25
|
+
'AGENTS.md',
|
|
26
|
+
'.memoryrc.json'
|
|
27
|
+
];
|
|
28
|
+
|
|
29
|
+
const ROOT_MANDATORY_FILES = [
|
|
30
|
+
'AGENTS.md',
|
|
31
|
+
'README.md',
|
|
32
|
+
'package.json',
|
|
33
|
+
'memory/00-global/mission.md',
|
|
34
|
+
'memory/40-delivery/backlog.md',
|
|
35
|
+
'memory/50-orchestration/gsd-harness.md',
|
|
36
|
+
'specs/README.md',
|
|
37
|
+
];
|
|
38
|
+
|
|
39
|
+
function check() {
|
|
40
|
+
if (!fs.existsSync(projectDir)) {
|
|
41
|
+
console.error(`Projeto nao encontrado: ${projectArg}`);
|
|
42
|
+
if (projectArg) {
|
|
43
|
+
const info = getWorkspaceInfo();
|
|
44
|
+
console.error(`Workspace ativo: ${info.root} (${info.source})`);
|
|
45
|
+
console.error(`Diretorio esperado: ${resolveProject(projectArg)}`);
|
|
46
|
+
}
|
|
47
|
+
process.exit(1);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
const mandatoryFiles = projectArg ? PROJECT_MANDATORY_FILES : ROOT_MANDATORY_FILES;
|
|
51
|
+
|
|
52
|
+
console.log(`\nAnalisando aderencia aos padroes: ${project.toUpperCase()}...\n`);
|
|
53
|
+
if (projectArg) {
|
|
54
|
+
const info = getWorkspaceInfo();
|
|
55
|
+
console.log(`Workspace: ${info.root} (${info.source})`);
|
|
56
|
+
console.log(`Projeto: ${projectDir}\n`);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
const results = [];
|
|
60
|
+
let score = 0;
|
|
61
|
+
|
|
62
|
+
for (const file of mandatoryFiles) {
|
|
63
|
+
const exists = fs.existsSync(path.join(projectDir, file));
|
|
64
|
+
if (exists) {
|
|
65
|
+
const content = fs.readFileSync(path.join(projectDir, file), 'utf8');
|
|
66
|
+
const isPlaceholder = content.length < 100 || content.includes('Descreva');
|
|
67
|
+
|
|
68
|
+
results.push({
|
|
69
|
+
file,
|
|
70
|
+
status: isPlaceholder ? 'WARN Placeholder' : 'OK',
|
|
71
|
+
weight: isPlaceholder ? 0.5 : 1
|
|
72
|
+
});
|
|
73
|
+
score += isPlaceholder ? 0.5 : 1;
|
|
74
|
+
} else {
|
|
75
|
+
results.push({ file, status: 'FAIL Faltando', weight: 0 });
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
results.forEach(r => {
|
|
80
|
+
console.log(`${r.status.padEnd(12)} | ${r.file}`);
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
const finalScore = (score / mandatoryFiles.length) * 100;
|
|
84
|
+
console.log(`\nScore de Maturidade: ${finalScore.toFixed(0)}%`);
|
|
85
|
+
|
|
86
|
+
if (finalScore < 70) {
|
|
87
|
+
console.log('\nAlerta: o projeto precisa de mais documentacao de fundacao antes de escalar.');
|
|
88
|
+
process.exit(1);
|
|
89
|
+
} else {
|
|
90
|
+
console.log('\nProjeto saudavel e pronto para execucao acelerada.');
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
try {
|
|
95
|
+
check();
|
|
96
|
+
} catch (e) {
|
|
97
|
+
console.error('Erro ao verificar padrões:', e.message);
|
|
98
|
+
}
|
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Memory Vacuum - Comprime e limpa memória antiga do projeto
|
|
5
|
+
*
|
|
6
|
+
* Objetivo: Manter .memory/sqlite/ < 50MB removendo:
|
|
7
|
+
* - Logs > 30 dias (moves para archive)
|
|
8
|
+
* - Índices sem referência
|
|
9
|
+
* - Cache expirado (TTL)
|
|
10
|
+
*
|
|
11
|
+
* Uso: npm run memory:vacuum
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
import fs from 'node:fs';
|
|
15
|
+
import path from 'node:path';
|
|
16
|
+
import Database from 'better-sqlite3';
|
|
17
|
+
import { fileURLToPath } from 'node:url';
|
|
18
|
+
import { getDbPath, ensureSchema } from './memory-schema.mjs';
|
|
19
|
+
|
|
20
|
+
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
21
|
+
const root = path.resolve(__dirname, '..');
|
|
22
|
+
|
|
23
|
+
// Configuração de defaults (pode ser sobrescrita por .memoryrc.json)
|
|
24
|
+
const DEFAULT_CONFIG = {
|
|
25
|
+
archiveAge: 30, // dias
|
|
26
|
+
maxDbSize: 50, // MB
|
|
27
|
+
cacheTtl: 7, // dias
|
|
28
|
+
vacuumInterval: 86400000, // ms (1 dia)
|
|
29
|
+
};
|
|
30
|
+
|
|
31
|
+
function loadConfig() {
|
|
32
|
+
const configPath = path.join(root, '.memoryrc.json');
|
|
33
|
+
if (fs.existsSync(configPath)) {
|
|
34
|
+
return JSON.parse(fs.readFileSync(configPath, 'utf8')).compression || {};
|
|
35
|
+
}
|
|
36
|
+
return {};
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function getDbSize(dbPath) {
|
|
40
|
+
if (!fs.existsSync(dbPath)) return 0;
|
|
41
|
+
const stats = fs.statSync(dbPath);
|
|
42
|
+
return stats.size / (1024 * 1024); // MB
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function archiveOldLogs(dbPath, ageInDays) {
|
|
46
|
+
console.log(`📦 Archiving logs older than ${ageInDays} days...`);
|
|
47
|
+
|
|
48
|
+
const db = new Database(dbPath);
|
|
49
|
+
const archiveDir = path.join(path.dirname(dbPath), 'archive');
|
|
50
|
+
|
|
51
|
+
if (!fs.existsSync(archiveDir)) {
|
|
52
|
+
fs.mkdirSync(archiveDir, { recursive: true });
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
try {
|
|
56
|
+
// 1. Buscar runs antigos
|
|
57
|
+
const cutoffDate = new Date();
|
|
58
|
+
cutoffDate.setDate(cutoffDate.getDate() - ageInDays);
|
|
59
|
+
|
|
60
|
+
const oldRuns = db
|
|
61
|
+
.prepare(
|
|
62
|
+
`
|
|
63
|
+
SELECT id, project_id, completed_at, log_content
|
|
64
|
+
FROM memory_runs
|
|
65
|
+
WHERE completed_at < ?
|
|
66
|
+
LIMIT 100
|
|
67
|
+
`
|
|
68
|
+
)
|
|
69
|
+
.all(cutoffDate.toISOString());
|
|
70
|
+
|
|
71
|
+
console.log(` Found ${oldRuns.length} old runs to archive`);
|
|
72
|
+
|
|
73
|
+
// 2. Mover para arquivo
|
|
74
|
+
let archived = 0;
|
|
75
|
+
for (const run of oldRuns) {
|
|
76
|
+
const filename = `run-${run.id}-${run.completed_at.split('T')[0]}.json`;
|
|
77
|
+
const filepath = path.join(archiveDir, filename);
|
|
78
|
+
|
|
79
|
+
fs.writeFileSync(filepath, JSON.stringify(run, null, 2), 'utf8');
|
|
80
|
+
|
|
81
|
+
// 3. Deletar do DB
|
|
82
|
+
db.prepare('DELETE FROM memory_runs WHERE id = ?').run(run.id);
|
|
83
|
+
archived++;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
console.log(` ✅ Archived ${archived} runs`);
|
|
87
|
+
|
|
88
|
+
// 4. Cleanup de índices vazios
|
|
89
|
+
const emptyNodes = db
|
|
90
|
+
.prepare(
|
|
91
|
+
`
|
|
92
|
+
SELECT COUNT(*) as cnt FROM memory_nodes
|
|
93
|
+
WHERE content IS NULL OR content = ''
|
|
94
|
+
`
|
|
95
|
+
)
|
|
96
|
+
.get();
|
|
97
|
+
|
|
98
|
+
if (emptyNodes.cnt > 0) {
|
|
99
|
+
console.log(` 🗑️ Removing ${emptyNodes.cnt} empty nodes...`);
|
|
100
|
+
db.prepare('DELETE FROM memory_nodes WHERE content IS NULL OR content = ""')
|
|
101
|
+
.run();
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
db.exec('VACUUM;'); // Compactar DB
|
|
105
|
+
console.log(` ✨ Database compacted`);
|
|
106
|
+
|
|
107
|
+
db.close();
|
|
108
|
+
} catch (e) {
|
|
109
|
+
console.error(' ❌ Error archiving:', e.message);
|
|
110
|
+
db.close();
|
|
111
|
+
throw e;
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
function cleanExpiredCache(cacheDir, ttlInDays) {
|
|
116
|
+
console.log(`🧹 Cleaning expired cache (TTL: ${ttlInDays} days)...`);
|
|
117
|
+
|
|
118
|
+
if (!fs.existsSync(cacheDir)) {
|
|
119
|
+
console.log(' (No cache directory)');
|
|
120
|
+
return 0;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
const files = fs.readdirSync(cacheDir);
|
|
124
|
+
const cutoffTime = Date.now() - ttlInDays * 86400000;
|
|
125
|
+
let removed = 0;
|
|
126
|
+
|
|
127
|
+
for (const file of files) {
|
|
128
|
+
const filepath = path.join(cacheDir, file);
|
|
129
|
+
const stats = fs.statSync(filepath);
|
|
130
|
+
|
|
131
|
+
if (stats.mtimeMs < cutoffTime) {
|
|
132
|
+
fs.unlinkSync(filepath);
|
|
133
|
+
removed++;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
console.log(` ✅ Removed ${removed} expired cache files`);
|
|
138
|
+
return removed;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
function reportStats(dbPath, beforeSize) {
|
|
142
|
+
const afterSize = getDbSize(dbPath);
|
|
143
|
+
const saved = beforeSize - afterSize;
|
|
144
|
+
const percent = ((saved / beforeSize) * 100).toFixed(1);
|
|
145
|
+
|
|
146
|
+
console.log(`\n📊 Compression Report:`);
|
|
147
|
+
console.log(` Before: ${beforeSize.toFixed(2)} MB`);
|
|
148
|
+
console.log(` After: ${afterSize.toFixed(2)} MB`);
|
|
149
|
+
console.log(` Saved: ${saved.toFixed(2)} MB (${percent}%)`);
|
|
150
|
+
|
|
151
|
+
if (afterSize > DEFAULT_CONFIG.maxDbSize) {
|
|
152
|
+
console.warn(
|
|
153
|
+
` ⚠️ Database still > ${DEFAULT_CONFIG.maxDbSize}MB. Consider manual cleanup.`
|
|
154
|
+
);
|
|
155
|
+
} else {
|
|
156
|
+
console.log(` ✨ Database within limits (< ${DEFAULT_CONFIG.maxDbSize}MB)`);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
async function vacuum() {
|
|
161
|
+
const config = { ...DEFAULT_CONFIG, ...loadConfig() };
|
|
162
|
+
ensureSchema({ silent: true });
|
|
163
|
+
const dbPath = getDbPath();
|
|
164
|
+
const cacheDir = path.join(root, '.context', 'cache');
|
|
165
|
+
|
|
166
|
+
console.log('🔧 Memory Vacuum - Compression & Cleanup');
|
|
167
|
+
console.log(` Config: ${JSON.stringify(config)}\n`);
|
|
168
|
+
|
|
169
|
+
if (!fs.existsSync(dbPath)) {
|
|
170
|
+
console.log('⚠️ Database not found. Skipping.');
|
|
171
|
+
return;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
const beforeSize = getDbSize(dbPath);
|
|
175
|
+
|
|
176
|
+
try {
|
|
177
|
+
// 1. Archive old runs
|
|
178
|
+
archiveOldLogs(dbPath, config.archiveAge);
|
|
179
|
+
|
|
180
|
+
// 2. Clean cache
|
|
181
|
+
cleanExpiredCache(cacheDir, config.cacheTtl);
|
|
182
|
+
|
|
183
|
+
// 3. Report
|
|
184
|
+
reportStats(dbPath, beforeSize);
|
|
185
|
+
|
|
186
|
+
console.log('\n✅ Memory vacuum complete!');
|
|
187
|
+
} catch (e) {
|
|
188
|
+
console.error('❌ Vacuum failed:', e.message);
|
|
189
|
+
process.exit(1);
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
// Executar se chamado via CLI
|
|
194
|
+
if (import.meta.url === `file://${process.argv[1]}`) {
|
|
195
|
+
vacuum().catch(console.error);
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
export { vacuum, getDbSize, archiveOldLogs, cleanExpiredCache };
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { fileURLToPath } from 'node:url';
|
|
4
|
+
import { resolveProject, initWorkspace } from '../lib/workspace.mjs';
|
|
5
|
+
|
|
6
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
7
|
+
const __dirname = path.dirname(__filename);
|
|
8
|
+
|
|
9
|
+
const [project] = process.argv.slice(2);
|
|
10
|
+
|
|
11
|
+
if (!project) {
|
|
12
|
+
console.log('Uso: node scripts/compress-project-memory.js <projeto>');
|
|
13
|
+
process.exit(0);
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
initWorkspace();
|
|
17
|
+
const projectDir = resolveProject(project);
|
|
18
|
+
const handoffDir = path.join(projectDir, 'memory/50-orchestration/handoffs');
|
|
19
|
+
const summaryFile = path.join(projectDir, 'memory/70-summaries/compressed-history.md');
|
|
20
|
+
|
|
21
|
+
function compress() {
|
|
22
|
+
if (!fs.existsSync(handoffDir)) return console.log('Sem handoffs para comprimir.');
|
|
23
|
+
|
|
24
|
+
const files = fs.readdirSync(handoffDir).filter(f => f.endsWith('.md') && f !== 'README.md');
|
|
25
|
+
if (files.length < 5) return console.log('Handoffs insuficientes para compressão significativa.');
|
|
26
|
+
|
|
27
|
+
let compressedContent = `# Histórico Comprimido de Execução: ${project.toUpperCase()}\n\n`;
|
|
28
|
+
compressedContent += `> Última compressão: ${new Date().toISOString()}\n\n`;
|
|
29
|
+
|
|
30
|
+
for (const file of files) {
|
|
31
|
+
const filePath = path.join(handoffDir, file);
|
|
32
|
+
const content = fs.readFileSync(filePath, 'utf8');
|
|
33
|
+
|
|
34
|
+
// Extrai apenas o Título e as Alterações para o resumo
|
|
35
|
+
const titleMatch = content.match(/^## Titulo\n(.+)$/m) || content.match(/^# Handoff: (.+)$/m);
|
|
36
|
+
const changesMatch = content.match(/## Alteracoes\n([\s\S]*?)(?=##|$)/);
|
|
37
|
+
|
|
38
|
+
if (titleMatch) {
|
|
39
|
+
compressedContent += `### ${titleMatch[1].trim()} (${file.split('_')[0]})\n`;
|
|
40
|
+
if (changesMatch) {
|
|
41
|
+
compressedContent += `${changesMatch[1].trim()}\n\n`;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
// Opcional: Arquivar ou deletar o handoff original após compressão
|
|
46
|
+
// fs.unlinkSync(filePath);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
fs.writeFileSync(summaryFile, compressedContent, 'utf8');
|
|
50
|
+
console.log(`✅ Memória comprimida em: ${summaryFile}`);
|
|
51
|
+
console.log(`📉 ${files.length} handoffs consolidados em um único arquivo de resumo.`);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
try {
|
|
55
|
+
compress();
|
|
56
|
+
} catch (e) {
|
|
57
|
+
console.error('Erro na compressão:', e.message);
|
|
58
|
+
}
|