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,70 @@
|
|
|
1
|
+
# Capacidades externas integradas
|
|
2
|
+
|
|
3
|
+
TrΓͺs produtos open-source foram alocados ao `2-projeto-agents` como capacidades de
|
|
4
|
+
primeira classe (ver [ADR-0016](../memory/90-decisions/0016-integracao-capacidades-externas.md)).
|
|
5
|
+
Antigamente viviam em `projects/`; agora estΓ£o no workspace Forja
|
|
6
|
+
(`~/forja-workspace`, configurΓ‘vel β ver [ADR-0019](../memory/90-decisions/0019-workspace-separado.md)).
|
|
7
|
+
Aqui ficam sΓ³ a fiaΓ§Γ£o e o modo de uso.
|
|
8
|
+
|
|
9
|
+
## 1. codegraph β anΓ‘lise de cΓ³digo (MCP)
|
|
10
|
+
|
|
11
|
+
Grafo de cΓ³digo semΓ’ntico, 100% local. Registrado como **servidor MCP** no repo
|
|
12
|
+
(`.mcp.json`) e disponΓvel no PATH (`~/.local/bin/codegraph`).
|
|
13
|
+
|
|
14
|
+
**Ferramentas MCP** (aparecem automaticamente em sessΓ΅es Claude Code neste repo):
|
|
15
|
+
- `codegraph_explore` β sΓmbolos relevantes + call paths de uma Γ‘rea, num disparo sΓ³.
|
|
16
|
+
- `codegraph_node` β fonte de um sΓmbolo + trilha de callers/callees, ou leitura de arquivo.
|
|
17
|
+
|
|
18
|
+
**CLI / npm scripts:**
|
|
19
|
+
```bash
|
|
20
|
+
npm run code:index # codegraph init β constrΓ³i o Γndice inicial (respeita .gitignore)
|
|
21
|
+
npm run code:sync # sincroniza mudanΓ§as desde o ΓΊltimo Γndice
|
|
22
|
+
npm run code:status # status e estatΓsticas do Γndice
|
|
23
|
+
npm run code:query "<termo>" # busca sΓmbolos
|
|
24
|
+
codegraph explore "<query>" # exploraΓ§Γ£o ad-hoc
|
|
25
|
+
codegraph callers <sΓmbolo> # quem chama um sΓmbolo
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
O Γndice fica em `.codegraph/` (jΓ‘ coberto por `.gitignore` do projeto, se necessΓ‘rio).
|
|
29
|
+
|
|
30
|
+
## 2. harness β orquestraΓ§Γ£o de times de agentes (plugin)
|
|
31
|
+
|
|
32
|
+
Plugin do Claude Code (`harness@harness-marketplace`, instalado e habilitado) que
|
|
33
|
+
transforma uma descriΓ§Γ£o de domΓnio em um time de agentes + skills, a partir de 6
|
|
34
|
+
padrΓ΅es: Pipeline, Fan-out/Fan-in, Expert Pool, Producer-Reviewer, Supervisor,
|
|
35
|
+
Hierarchical Delegation.
|
|
36
|
+
|
|
37
|
+
**Uso:** numa sessΓ£o Claude Code, peΓ§a _"build a harness for this project"_ (ou
|
|
38
|
+
_"configure um harness para X"_) e ele gera `.claude/agents/` e `.claude/skills/`
|
|
39
|
+
adequados ao domΓnio.
|
|
40
|
+
|
|
41
|
+
**GestΓ£o:**
|
|
42
|
+
```bash
|
|
43
|
+
claude plugin list # confirmar harness habilitado
|
|
44
|
+
claude plugin marketplace list # confirmar marketplace local
|
|
45
|
+
claude plugin update harness@harness-marketplace
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Complementa o sistema de orquestraΓ§Γ£o nativo do framework (AGENTS.md, handoffs,
|
|
49
|
+
`scripts/agent-router.mjs`): harness ajuda a *desenhar* novos times; o framework
|
|
50
|
+
*opera* os handoffs.
|
|
51
|
+
|
|
52
|
+
## 3. ai-engineering-from-scratch β base de conhecimento (referΓͺncia)
|
|
53
|
+
|
|
54
|
+
CurrΓculo de AI engineering: 503 liΓ§Γ΅es, 20 fases, 4 linguagens (Python, TypeScript,
|
|
55
|
+
Rust, Julia). Material de referΓͺncia para fundamentar decisΓ΅es tΓ©cnicas de IA do
|
|
56
|
+
framework. NΓ£o hΓ‘ instalaΓ§Γ£o β consultar diretamente:
|
|
57
|
+
|
|
58
|
+
- `projects/ai-engineering-from-scratch-main/ROADMAP.md` β Γndice das 20 fases.
|
|
59
|
+
- `projects/ai-engineering-from-scratch-main/phases/` β liΓ§Γ΅es por fase.
|
|
60
|
+
- `projects/ai-engineering-from-scratch-main/glossary/` β glossΓ‘rio.
|
|
61
|
+
|
|
62
|
+
## ReinstalaΓ§Γ£o
|
|
63
|
+
|
|
64
|
+
Se `projects/` for limpo, recriar a fiaΓ§Γ£o:
|
|
65
|
+
```bash
|
|
66
|
+
ln -sf "$PWD/projects/codegraph-linux-x64/bin/codegraph" ~/.local/bin/codegraph
|
|
67
|
+
claude mcp add codegraph --scope project -- codegraph serve --mcp
|
|
68
|
+
claude plugin marketplace add "$PWD/projects/harness-main"
|
|
69
|
+
claude plugin install harness@harness-marketplace
|
|
70
|
+
```
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Operacao CLI-First
|
|
2
|
+
|
|
3
|
+
Este framework deve ser operado primeiro por linha de comando. O dashboard web fica como artefato legado/opcional de consulta; nao e gate de entrega, sprint, handoff ou governanca.
|
|
4
|
+
|
|
5
|
+
## Ciclo Diario
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm run sprint:status
|
|
9
|
+
npm run dev -- context:build task <slug> "<palavras-chave>"
|
|
10
|
+
npm run gsd:plan -- <slug> "<objetivo>"
|
|
11
|
+
npm run gsd:handoff -- spec <slug>
|
|
12
|
+
npm run spec:check -- <slug>
|
|
13
|
+
npm run gsd:handoff -- plan <slug>
|
|
14
|
+
npm run gsd:handoff -- implement <slug>
|
|
15
|
+
npm run gsd:check -- <slug>
|
|
16
|
+
npm test
|
|
17
|
+
npm run project:check
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## Sprints
|
|
21
|
+
|
|
22
|
+
No repositorio raiz:
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
npm run sprint:start
|
|
26
|
+
npm run sprint:status
|
|
27
|
+
npm run sprint:complete
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Em um projeto do workspace (`~/forja-workspace/projects/<NomeDoProjeto>`):
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
npm run sprint:start -- NomeDoProjeto
|
|
34
|
+
npm run sprint:status -- NomeDoProjeto
|
|
35
|
+
npm run sprint:complete -- NomeDoProjeto
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
O backlog pode estar em checklist com secao `## Alta Prioridade` ou em tabela RICE. Quando houver tabela RICE, entram na sprint os itens `P0` e `P1` mais bem posicionados.
|
|
39
|
+
|
|
40
|
+
## SDD + GSD
|
|
41
|
+
|
|
42
|
+
Use SDD para decidir o que sera entregue e GSD para controlar a execucao.
|
|
43
|
+
|
|
44
|
+
1. Product cria ou completa `specs/<slug>/spec.md`.
|
|
45
|
+
2. SDD Architect cria `plan.md`, `tasks.md` e ADRs quando houver decisao estrutural.
|
|
46
|
+
3. Orchestrator registra cada passagem com `gsd:handoff`.
|
|
47
|
+
4. Worker implementa somente os arquivos do ownership definido.
|
|
48
|
+
5. Governance roda `gsd:check`, `spec:check`, testes e `project:check`.
|
|
49
|
+
|
|
50
|
+
## Handoffs Hermes
|
|
51
|
+
|
|
52
|
+
Todo handoff precisa dos 7 campos da ADR-0005:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
npm run hermes:handoff -- '{"from":"orchestrator","to":"product","intent":"spec","context":"specs/<slug>","acceptance":"spec aprovada com AC testaveis","constraints":"pt-BR; sem codigo nesta fase","return":"orchestrator"}'
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
Para o fluxo padrao, prefira os atalhos:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
npm run gsd:handoff -- spec <slug>
|
|
62
|
+
npm run gsd:handoff -- plan <slug>
|
|
63
|
+
npm run gsd:handoff -- implement <slug>
|
|
64
|
+
npm run gsd:handoff -- review <slug>
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Quando Usar Design/Web
|
|
68
|
+
|
|
69
|
+
Use `design:select` e `design:check` apenas se a tarefa tiver impacto visual real. Em tarefas CLI-only, `gsd:check` nao exige brief visual.
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
npm run design:select -- agent-console tecnico
|
|
73
|
+
npm run design:check -- design-md/examples/agent-console-brief.md
|
|
74
|
+
```
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
# Dashboard
|
|
2
|
+
|
|
3
|
+
Painel web local para monitorar specs, handoffs e tokens do framework, e disparar comandos da CLI canΓ΄nica.
|
|
4
|
+
|
|
5
|
+
- **LocalizaΓ§Γ£o**: `dashboard/`
|
|
6
|
+
- **Bind**: `127.0.0.1` (nunca expΓ΅e a rede β kill criterion da SPEC-002)
|
|
7
|
+
- **Porta default**: `7777` (override via `DASHBOARD_PORT`)
|
|
8
|
+
|
|
9
|
+
## Subir
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
# Primeira vez β instala backend + frontend
|
|
13
|
+
npm run dashboard:install
|
|
14
|
+
|
|
15
|
+
# Build do frontend
|
|
16
|
+
npm run dashboard:web:build
|
|
17
|
+
|
|
18
|
+
# Sobe servidor (serve SPA + API)
|
|
19
|
+
npm run dashboard
|
|
20
|
+
# β http://127.0.0.1:7777
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Modo dev (HMR no frontend, backend separado):
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
# terminal 1 β API
|
|
27
|
+
npm run dashboard
|
|
28
|
+
# terminal 2 β Vite com proxy /api β 7777
|
|
29
|
+
npm run dashboard:web:dev
|
|
30
|
+
# β http://127.0.0.1:5173
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Telas
|
|
34
|
+
|
|
35
|
+
| Rota | O quΓͺ | Fonte |
|
|
36
|
+
|---|---|---|
|
|
37
|
+
| `/` (Briefing) | Textarea β POST `/api/briefing` β `spec.md` em status `draft` | parser heurΓstico (D5) |
|
|
38
|
+
| `/specs` | Tabela com status colorido + drawer com spec/plan/tasks | `specs/*/` |
|
|
39
|
+
| `/handoffs` | Kanban 3 colunas com botΓ΅es de transiΓ§Γ£o | `universal.db.handoffs` |
|
|
40
|
+
| `/tokens` | Linha 30d por projeto, totais agregados | `.context/*` + `60-runs/*.json` |
|
|
41
|
+
| `/commands` | 5 botΓ΅es com painel SSE ao vivo | allowlist hard-coded |
|
|
42
|
+
| `/projects` | Cards com badges (specs, handoffs, commit, memΓ³ria) | `projects/*` + git + SQLite |
|
|
43
|
+
|
|
44
|
+
Polling 30s em todas as telas (pausa quando aba nΓ£o-visΓvel).
|
|
45
|
+
|
|
46
|
+
## Allowlist de comandos (ADR-0009 + plan Β§4 D4)
|
|
47
|
+
|
|
48
|
+
Hard-coded em `dashboard/server/lib/allowlist.mjs`. Qualquer outro nome β `403`.
|
|
49
|
+
|
|
50
|
+
| Nome | Comando |
|
|
51
|
+
|---|---|
|
|
52
|
+
| `spec:check` | `node scripts/spec-cli.mjs check` |
|
|
53
|
+
| `sync:universal` | `node scripts/sync-universal-memory.js` |
|
|
54
|
+
| `memory:vacuum` | `node scripts/compress-memory.mjs` |
|
|
55
|
+
| `project:check` | `node scripts/check-standards.js` |
|
|
56
|
+
| `sprint:status` | `node scripts/sprint-manager.js status` |
|
|
57
|
+
|
|
58
|
+
Para adicionar comando novo: edite a constante, adicione teste, documente aqui β exige PR e revisΓ£o.
|
|
59
|
+
|
|
60
|
+
## Endpoints (API)
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
GET /api/health
|
|
64
|
+
GET /api/specs
|
|
65
|
+
GET /api/specs/:slug
|
|
66
|
+
GET /api/handoffs?status=&to=&from=&spec=&limit=
|
|
67
|
+
GET /api/handoffs/:id
|
|
68
|
+
POST /api/handoffs/:id/transition body { to }
|
|
69
|
+
GET /api/projects
|
|
70
|
+
GET /api/tokens?project=&days=30
|
|
71
|
+
GET /api/commands
|
|
72
|
+
POST /api/commands/:name SSE
|
|
73
|
+
POST /api/briefing body { brief, slug, projectHint? }
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Troubleshooting
|
|
77
|
+
|
|
78
|
+
**`EADDRINUSE: 7777`** β outra instΓ’ncia jΓ‘ estΓ‘ rodando. Mate com `lsof -ti:7777 | xargs kill` ou use `DASHBOARD_PORT=7778 npm run dashboard`.
|
|
79
|
+
|
|
80
|
+
**`/api/handoffs` retorna `[]` no primeiro acesso** β `universal.db` ainda nΓ£o foi criado. Rode `node scripts/agent-router.mjs schema` ou abra qualquer handoff via `agent-router append`.
|
|
81
|
+
|
|
82
|
+
**SPA mostra placeholder em vez das telas** β `dashboard/web/dist/` nΓ£o existe. Rode `npm run dashboard:web:build`.
|
|
83
|
+
|
|
84
|
+
**Briefing recusa slug** β kebab-case, 2-64 caracteres, comeΓ§ando com letra/dΓgito. Use o auto-slug do form.
|
|
85
|
+
|
|
86
|
+
**SSE corta no meio** β alguns proxies bufferizam SSE. Mantenha o dashboard em `127.0.0.1` direto, sem reverse proxy.
|
|
87
|
+
|
|
88
|
+
## SeguranΓ§a
|
|
89
|
+
|
|
90
|
+
- Bind exclusivo em `127.0.0.1` (nΓ£o hΓ‘ flag para abrir para rede β proposital)
|
|
91
|
+
- Allowlist literal em cΓ³digo (nΓ£o config) β ADR-0009 D4
|
|
92
|
+
- `spawn` sem `shell: true`; sem interpolaΓ§Γ£o de args do body
|
|
93
|
+
- `POST /api/briefing` valida slug com regex e bloqueia conflito de spec existente
|
|
94
|
+
- `POST /api/handoffs/:id/transition` aceita sΓ³ `in_progress | done | cancelled`
|
|
95
|
+
- 95% das telas sΓ£o read-only; mutaΓ§Γ£o sΓ³ via shell-out para a CLI canΓ΄nica
|
|
96
|
+
|
|
97
|
+
## Limites conhecidos (v1)
|
|
98
|
+
|
|
99
|
+
- Briefing usa heurΓstica simples β nΓ£o LLM (D5). Sucesso depende do briefing seguir padrΓ£o "Hojeβ¦", "Queremosβ¦", "Como X, quero Y, para que Z".
|
|
100
|
+
- Tokens sΓ£o estimativa por `chars/4`, nΓ£o consumo real da API.
|
|
101
|
+
- Polling 30s; sem WebSocket.
|
|
102
|
+
- Sem auth, sem multi-usuΓ‘rio (intencional β kill criterion).
|
|
@@ -0,0 +1,421 @@
|
|
|
1
|
+
# π οΈ DEV WORKFLOW - Guia de Desenvolvimento Unificado
|
|
2
|
+
|
|
3
|
+
**Status:** Fase 4 - Desenvolvimento Γgil
|
|
4
|
+
**Objetivo:** Unifcar CLI commands, pre-commit validation, health checks, e automatizaΓ§Γ£o
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## π VisΓ£o Geral
|
|
9
|
+
|
|
10
|
+
Esta fase cria uma interface unificada para todos os comandos de desenvolvimento, reduzindo complexidade e erros.
|
|
11
|
+
|
|
12
|
+
```
|
|
13
|
+
npm run dev -- <command> [args]
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## π― Comandos DisponΓveis
|
|
19
|
+
|
|
20
|
+
### 1. `context:build` β Gerar Contexto Inteligente
|
|
21
|
+
|
|
22
|
+
**Uso:**
|
|
23
|
+
```bash
|
|
24
|
+
npm run dev -- context:build <mode> <project> [keyword]
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
**Modos:**
|
|
28
|
+
- `global` β Mission + standards + ADRs (~2KB, 500 tokens)
|
|
29
|
+
- `domain` β Vision + design + rules (~20KB, 5K tokens)
|
|
30
|
+
- `task` β Searchable context + domain (~30KB, 8K tokens)
|
|
31
|
+
|
|
32
|
+
**Exemplos:**
|
|
33
|
+
```bash
|
|
34
|
+
# Para novo dev (quick overview)
|
|
35
|
+
npm run dev -- context:build global my-project
|
|
36
|
+
|
|
37
|
+
# Para feature development
|
|
38
|
+
npm run dev -- context:build domain my-project
|
|
39
|
+
|
|
40
|
+
# Para debugging especΓfico
|
|
41
|
+
npm run dev -- context:build task my-project "payment auth bug"
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
**Output:**
|
|
45
|
+
- Arquivo: `.context/context-{mode}.md`
|
|
46
|
+
- Metrics: bytes, tokens, estimated cost
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
### 2. `memory:vacuum` β Comprimir MemΓ³ria
|
|
51
|
+
|
|
52
|
+
**Uso:**
|
|
53
|
+
```bash
|
|
54
|
+
npm run dev -- memory:vacuum
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
**O que faz:**
|
|
58
|
+
- Archive runs > 30 dias β `.memory/archive/`
|
|
59
|
+
- Remove Γndices vazios
|
|
60
|
+
- SQLite VACUUM otimizado
|
|
61
|
+
|
|
62
|
+
**Output:**
|
|
63
|
+
```
|
|
64
|
+
π¦ Compression Report
|
|
65
|
+
Before: 2.10 MB
|
|
66
|
+
After: 1.20 MB
|
|
67
|
+
Saved: 0.90 MB (43%)
|
|
68
|
+
β¨ Database within limits
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
### 3. `memory:sync` β Sincronizar Γndices
|
|
74
|
+
|
|
75
|
+
**Uso:**
|
|
76
|
+
```bash
|
|
77
|
+
npm run dev -- memory:sync [project]
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
**O que faz:**
|
|
81
|
+
- Rebuild FTS5 Γndices
|
|
82
|
+
- Atualiza search weights
|
|
83
|
+
- Limpa stale entries
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
### 4. `project:health` β ValidaΓ§Γ£o de SaΓΊde
|
|
88
|
+
|
|
89
|
+
**Uso:**
|
|
90
|
+
```bash
|
|
91
|
+
npm run dev -- project:health
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
**Checa:**
|
|
95
|
+
- β
Estrutura de diretΓ³rios
|
|
96
|
+
- β
Arquivos de configuraΓ§Γ£o
|
|
97
|
+
- β
PermissΓ΅es
|
|
98
|
+
- β
Database status
|
|
99
|
+
- β
Dependencies
|
|
100
|
+
|
|
101
|
+
**Output:**
|
|
102
|
+
```
|
|
103
|
+
π Checking structure...
|
|
104
|
+
β
lib/
|
|
105
|
+
β
scripts/
|
|
106
|
+
β
docs/
|
|
107
|
+
...
|
|
108
|
+
|
|
109
|
+
β
Project health: GOOD
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
### 5. `project:init` β Inicializar Novo Projeto
|
|
115
|
+
|
|
116
|
+
**Uso:**
|
|
117
|
+
```bash
|
|
118
|
+
npm run dev -- project:init <project-name> [flags]
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
**Flags:**
|
|
122
|
+
- `--force` β Sobrescrever existente
|
|
123
|
+
- `--only-memory` β Apenas estrutura de memΓ³ria
|
|
124
|
+
- `--no-gitkeep` β Sem .gitkeep em dirs vazios
|
|
125
|
+
|
|
126
|
+
**Exemplo:**
|
|
127
|
+
```bash
|
|
128
|
+
npm run dev -- project:init awesome-app
|
|
129
|
+
npm run dev -- project:init awesome-app --force
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## π Pre-Commit Hook
|
|
135
|
+
|
|
136
|
+
**InstalaΓ§Γ£o:**
|
|
137
|
+
```bash
|
|
138
|
+
cp scripts/pre-commit.sh .git/hooks/pre-commit
|
|
139
|
+
chmod +x .git/hooks/pre-commit
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
**ValidaΓ§Γ΅es AutomΓ‘ticas:**
|
|
143
|
+
1. π Scan for secrets (password, api_key, token)
|
|
144
|
+
2. π Check console.log statements
|
|
145
|
+
3. π§Ή Lint & auto-fix staged files
|
|
146
|
+
4. π§ͺ Run tests
|
|
147
|
+
5. π Validate documentation
|
|
148
|
+
|
|
149
|
+
**Bypass (emergΓͺncia):**
|
|
150
|
+
```bash
|
|
151
|
+
git commit --no-verify
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
---
|
|
155
|
+
|
|
156
|
+
## π₯ Project Health Check
|
|
157
|
+
|
|
158
|
+
**Estrutura validada:**
|
|
159
|
+
```
|
|
160
|
+
β
lib/ (generators, validators, utils)
|
|
161
|
+
β
scripts/ (CLI, build, compress)
|
|
162
|
+
β
docs/ (documentation)
|
|
163
|
+
β
memory/ (project knowledge)
|
|
164
|
+
β
agents/ (agent definitions)
|
|
165
|
+
β
skills/ (capabilities)
|
|
166
|
+
β
prompts/ (instructions)
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
**Config validada:**
|
|
170
|
+
```
|
|
171
|
+
β
.memoryrc.json (token economy config)
|
|
172
|
+
β
package.json (dependencies, scripts)
|
|
173
|
+
β
.gitignore (security)
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
**Key files:**
|
|
177
|
+
```
|
|
178
|
+
β
bin/create-memory-nest-kit.js (generator orchestrator)
|
|
179
|
+
β
lib/context-builder.js (context API)
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
## π
AutomatizaΓ§Γ£o Schedule
|
|
185
|
+
|
|
186
|
+
### Memory Vacuum Cron (DiΓ‘rio)
|
|
187
|
+
|
|
188
|
+
**Via Cron Job (Linux/Mac):**
|
|
189
|
+
```bash
|
|
190
|
+
# Edit crontab
|
|
191
|
+
crontab -e
|
|
192
|
+
|
|
193
|
+
# Add (roda 2h da manhΓ£ todo dia)
|
|
194
|
+
0 2 * * * cd /path/to/project && npm run dev -- memory:vacuum >> logs/cron.log 2>&1
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
**Via Windows Task Scheduler:**
|
|
198
|
+
```batch
|
|
199
|
+
# PowerShell
|
|
200
|
+
$action = New-ScheduledTaskAction -Execute "cmd.exe" `
|
|
201
|
+
-Argument "/c cd C:\path\to\project && npm run dev -- memory:vacuum"
|
|
202
|
+
$trigger = New-ScheduledTaskTrigger -Daily -At 2am
|
|
203
|
+
Register-ScheduledTask -TaskName "ProjectMemoryVacuum" -Action $action -Trigger $trigger
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
**Via PM2 (Recomendado):**
|
|
207
|
+
```bash
|
|
208
|
+
npm install -g pm2
|
|
209
|
+
|
|
210
|
+
# Criar ecosystem.config.js
|
|
211
|
+
cat > ecosystem.config.js << 'EOF'
|
|
212
|
+
module.exports = {
|
|
213
|
+
apps: [{
|
|
214
|
+
name: 'memory-vacuum',
|
|
215
|
+
script: 'npm',
|
|
216
|
+
args: 'run dev -- memory:vacuum',
|
|
217
|
+
cron_restart: '0 2 * * *' // 2h da manhΓ£
|
|
218
|
+
}]
|
|
219
|
+
};
|
|
220
|
+
EOF
|
|
221
|
+
|
|
222
|
+
pm2 start ecosystem.config.js
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
---
|
|
226
|
+
|
|
227
|
+
## π Workflow TΓpico
|
|
228
|
+
|
|
229
|
+
### InΓcio de Dia
|
|
230
|
+
|
|
231
|
+
```bash
|
|
232
|
+
# 1. Verificar saΓΊde do projeto
|
|
233
|
+
npm run dev -- project:health
|
|
234
|
+
|
|
235
|
+
# 2. Gerar contexto (se iniciando feature nova)
|
|
236
|
+
npm run dev -- context:build domain my-project
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
### Durante Desenvolvimento
|
|
240
|
+
|
|
241
|
+
```bash
|
|
242
|
+
# 1. Fazer alteraΓ§Γ΅es
|
|
243
|
+
vim src/features/auth.ts
|
|
244
|
+
|
|
245
|
+
# 2. Commit automΓ‘tico roda validaΓ§Γ΅es:
|
|
246
|
+
# - Lint (auto-fix)
|
|
247
|
+
# - Tests
|
|
248
|
+
# - No secrets check
|
|
249
|
+
git commit -m "feat: auth implementation"
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
### Fim de Semana
|
|
253
|
+
|
|
254
|
+
```bash
|
|
255
|
+
# 1. Executar manually (ou via cron):
|
|
256
|
+
npm run dev -- memory:vacuum
|
|
257
|
+
|
|
258
|
+
# 2. Verificar novamente
|
|
259
|
+
npm run dev -- project:health
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
---
|
|
263
|
+
|
|
264
|
+
## π§ ConfiguraΓ§Γ£o Customizada
|
|
265
|
+
|
|
266
|
+
### Via .memoryrc.json
|
|
267
|
+
|
|
268
|
+
```json
|
|
269
|
+
{
|
|
270
|
+
"compression": {
|
|
271
|
+
"archiveAge": 30, // dias
|
|
272
|
+
"maxDbSize": 50, // MB
|
|
273
|
+
"vacuumInterval": 86400000 // ms (1 dia)
|
|
274
|
+
},
|
|
275
|
+
"devWorkflow": {
|
|
276
|
+
"preCommitStrict": true,
|
|
277
|
+
"autofixOnCommit": true,
|
|
278
|
+
"requireTests": true,
|
|
279
|
+
"requireCoverage": 80
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
### Via Environment Variables
|
|
285
|
+
|
|
286
|
+
```bash
|
|
287
|
+
# Skip tests
|
|
288
|
+
SKIP_TESTS=1 git commit -m "..."
|
|
289
|
+
|
|
290
|
+
# Dry run
|
|
291
|
+
DRY_RUN=1 npm run dev -- memory:vacuum
|
|
292
|
+
|
|
293
|
+
# Debug mode
|
|
294
|
+
DEBUG=1 npm run dev -- project:health
|
|
295
|
+
```
|
|
296
|
+
|
|
297
|
+
---
|
|
298
|
+
|
|
299
|
+
## π Health Check Output Example
|
|
300
|
+
|
|
301
|
+
```
|
|
302
|
+
π₯ Running project health checks...
|
|
303
|
+
|
|
304
|
+
π Checking structure...
|
|
305
|
+
β
lib/
|
|
306
|
+
β
scripts/
|
|
307
|
+
β
docs/
|
|
308
|
+
β
memory/
|
|
309
|
+
β
agents/
|
|
310
|
+
β
skills/
|
|
311
|
+
β
prompts/
|
|
312
|
+
|
|
313
|
+
βοΈ Checking config...
|
|
314
|
+
β
.memoryrc.json
|
|
315
|
+
β
package.json
|
|
316
|
+
|
|
317
|
+
π Checking key files...
|
|
318
|
+
β
bin/create-memory-nest-kit.js
|
|
319
|
+
β
lib/context-builder.js
|
|
320
|
+
|
|
321
|
+
ποΈ Checking database...
|
|
322
|
+
β
~/forja-workspace/memory/sqlite/universal.db
|
|
323
|
+
|
|
324
|
+
ββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
325
|
+
β
Project health: GOOD
|
|
326
|
+
ββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
327
|
+
```
|
|
328
|
+
|
|
329
|
+
---
|
|
330
|
+
|
|
331
|
+
## β‘ CLI Shortcuts
|
|
332
|
+
|
|
333
|
+
**Adicionar ao shell (`.bashrc` ou `.zshrc`):**
|
|
334
|
+
|
|
335
|
+
```bash
|
|
336
|
+
# Quick health check
|
|
337
|
+
alias dev-health='npm run dev -- project:health'
|
|
338
|
+
|
|
339
|
+
# Quick context
|
|
340
|
+
alias dev-ctx='npm run dev -- context:build'
|
|
341
|
+
|
|
342
|
+
# Quick vacuum
|
|
343
|
+
alias dev-vac='npm run dev -- memory:vacuum'
|
|
344
|
+
|
|
345
|
+
# Quick init
|
|
346
|
+
alias dev-init='npm run dev -- project:init'
|
|
347
|
+
```
|
|
348
|
+
|
|
349
|
+
**Uso:**
|
|
350
|
+
```bash
|
|
351
|
+
dev-health
|
|
352
|
+
dev-ctx task my-project "feature"
|
|
353
|
+
dev-vac
|
|
354
|
+
dev-init awesome-app
|
|
355
|
+
```
|
|
356
|
+
|
|
357
|
+
---
|
|
358
|
+
|
|
359
|
+
## π Checklist Pre-Deployment
|
|
360
|
+
|
|
361
|
+
- [ ] `npm run dev -- project:health` β
|
|
362
|
+
- [ ] `npm run dev -- memory:vacuum` β
|
|
363
|
+
- [ ] All tests passing: `npm test`
|
|
364
|
+
- [ ] Coverage > 80%: `npm run test:cov`
|
|
365
|
+
- [ ] No console.log in production code
|
|
366
|
+
- [ ] Docs updated: `git diff --name-only | grep .md`
|
|
367
|
+
- [ ] Commit message follows convention: `feat:` / `fix:` / `docs:`
|
|
368
|
+
- [ ] Pre-commit hook passed automatically
|
|
369
|
+
|
|
370
|
+
---
|
|
371
|
+
|
|
372
|
+
## π Troubleshooting
|
|
373
|
+
|
|
374
|
+
### Pre-commit hook nΓ£o roda
|
|
375
|
+
|
|
376
|
+
```bash
|
|
377
|
+
# Verificar permissΓ΅es
|
|
378
|
+
ls -la .git/hooks/pre-commit
|
|
379
|
+
|
|
380
|
+
# Se nΓ£o tem permissΓ£o:
|
|
381
|
+
chmod +x .git/hooks/pre-commit
|
|
382
|
+
```
|
|
383
|
+
|
|
384
|
+
### Health check falha
|
|
385
|
+
|
|
386
|
+
```bash
|
|
387
|
+
# Rodar com debug
|
|
388
|
+
DEBUG=1 npm run dev -- project:health
|
|
389
|
+
|
|
390
|
+
# Checar diretΓ³rio especΓfico
|
|
391
|
+
ls -la lib/
|
|
392
|
+
ls -la scripts/
|
|
393
|
+
```
|
|
394
|
+
|
|
395
|
+
### Memory vacuum muito lento
|
|
396
|
+
|
|
397
|
+
```bash
|
|
398
|
+
# Checar tamanho do DB
|
|
399
|
+
du -sh .memory/sqlite/context.db
|
|
400
|
+
|
|
401
|
+
# Manual cleanup (backup first!)
|
|
402
|
+
cp .memory/sqlite/context.db .memory/sqlite/context.db.backup
|
|
403
|
+
sqlite3 .memory/sqlite/context.db "VACUUM;"
|
|
404
|
+
```
|
|
405
|
+
|
|
406
|
+
---
|
|
407
|
+
|
|
408
|
+
## π ReferΓͺncia RΓ‘pida
|
|
409
|
+
|
|
410
|
+
| Comando | Uso | Output |
|
|
411
|
+
|---------|-----|--------|
|
|
412
|
+
| `context:build` | Gerar contexto | `.context/context-*.md` |
|
|
413
|
+
| `memory:vacuum` | Comprimir | RelatΓ³rio de economia |
|
|
414
|
+
| `memory:sync` | Atualizar Γndices | Status de sync |
|
|
415
|
+
| `project:health` | Validar projeto | RelatΓ³rio de saΓΊde |
|
|
416
|
+
| `project:init` | Novo projeto | Projeto inicializado |
|
|
417
|
+
|
|
418
|
+
---
|
|
419
|
+
|
|
420
|
+
**PrΓ³xima Fase**: Testes de integraΓ§Γ£o com projeto exemplo
|
|
421
|
+
**Status**: Fase 4 - CLI Unificada 100% β
|