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,119 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* code-intel — camada de code intelligence sobre o codegraph (ADR-0017).
|
|
4
|
+
*
|
|
5
|
+
* Auto-contido: depende apenas do binario `codegraph` no PATH. Se ausente,
|
|
6
|
+
* degrada graciosamente (avisa e segue) — nunca trava o fluxo.
|
|
7
|
+
*
|
|
8
|
+
* Comandos:
|
|
9
|
+
* check Valida indice (worktree + freshness)
|
|
10
|
+
* impact <simbolo> [d] Chamadores e blast radius de um simbolo
|
|
11
|
+
*
|
|
12
|
+
* Emitido por forja/init-project.js. Veja docs do framework para o GSD completo.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import { spawnSync } from 'node:child_process';
|
|
16
|
+
|
|
17
|
+
function runCodegraph(args) {
|
|
18
|
+
const result = spawnSync('codegraph', args, { encoding: 'utf8' });
|
|
19
|
+
if (result.error && result.error.code === 'ENOENT') return { missing: true };
|
|
20
|
+
return {
|
|
21
|
+
missing: false,
|
|
22
|
+
status: result.status ?? 1,
|
|
23
|
+
stdout: (result.stdout || '').trim(),
|
|
24
|
+
stderr: (result.stderr || '').trim(),
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
function codegraphStatus() {
|
|
29
|
+
const res = runCodegraph(['status', '--json']);
|
|
30
|
+
if (res.missing) return { missing: true };
|
|
31
|
+
let data = null;
|
|
32
|
+
try {
|
|
33
|
+
data = JSON.parse(res.stdout);
|
|
34
|
+
} catch {
|
|
35
|
+
return { missing: false, parseError: true, raw: res.stdout || res.stderr };
|
|
36
|
+
}
|
|
37
|
+
const pending = data.pendingChanges || {};
|
|
38
|
+
const pendingTotal = (pending.added || 0) + (pending.modified || 0) + (pending.removed || 0);
|
|
39
|
+
return {
|
|
40
|
+
missing: false,
|
|
41
|
+
initialized: Boolean(data.initialized),
|
|
42
|
+
worktreeMismatch: data.worktreeMismatch || null,
|
|
43
|
+
fileCount: data.fileCount || 0,
|
|
44
|
+
pendingTotal,
|
|
45
|
+
reindexRecommended: Boolean(data.index && data.index.reindexRecommended),
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function fail(msg) {
|
|
50
|
+
console.error(msg);
|
|
51
|
+
process.exit(1);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function cmdCheck() {
|
|
55
|
+
const s = codegraphStatus();
|
|
56
|
+
if (s.missing) {
|
|
57
|
+
console.log('Codegraph nao instalado no PATH. Code intelligence ignorado.');
|
|
58
|
+
console.log('Instale com: npm i -g @codegraph/cli');
|
|
59
|
+
process.exit(0);
|
|
60
|
+
}
|
|
61
|
+
if (s.parseError) {
|
|
62
|
+
console.log('Codegraph respondeu, mas status --json nao pode ser lido.');
|
|
63
|
+
fail(s.raw || 'sem saida');
|
|
64
|
+
}
|
|
65
|
+
const lines = [];
|
|
66
|
+
let blocking = false;
|
|
67
|
+
if (!s.initialized) {
|
|
68
|
+
blocking = true;
|
|
69
|
+
lines.push('FAIL indice ausente: rode `npm run code:index`.');
|
|
70
|
+
} else {
|
|
71
|
+
lines.push(`OK indice inicializado (${s.fileCount} arquivos).`);
|
|
72
|
+
}
|
|
73
|
+
if (s.worktreeMismatch) {
|
|
74
|
+
blocking = true;
|
|
75
|
+
lines.push(`FAIL indice de outro worktree: ${s.worktreeMismatch}. Rode \`codegraph init -i\`.`);
|
|
76
|
+
} else if (s.initialized) {
|
|
77
|
+
lines.push('OK indice pertence a este worktree.');
|
|
78
|
+
}
|
|
79
|
+
if (s.pendingTotal > 0 || s.reindexRecommended) {
|
|
80
|
+
lines.push(`WARN indice defasado (${s.pendingTotal} pend.). Rode \`npm run code:sync\`.`);
|
|
81
|
+
} else if (s.initialized) {
|
|
82
|
+
lines.push('OK indice em dia.');
|
|
83
|
+
}
|
|
84
|
+
console.log('Codegraph check:\n');
|
|
85
|
+
for (const line of lines) console.log(line);
|
|
86
|
+
if (blocking) fail('\nResultado: gate de code intelligence reprovado.');
|
|
87
|
+
console.log('\nResultado: code intelligence confiavel.');
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
function cmdImpact(symbol, depthArg) {
|
|
91
|
+
if (!symbol) fail('Uso: code-intel impact <simbolo> [profundidade]');
|
|
92
|
+
const probe = runCodegraph(['status', '--json']);
|
|
93
|
+
if (probe.missing) {
|
|
94
|
+
console.log('Codegraph nao instalado. Sem mapa de impacto automatico.');
|
|
95
|
+
console.log(`Fallback manual: grep -rn "${symbol}" . e leia os chamadores.`);
|
|
96
|
+
process.exit(0);
|
|
97
|
+
}
|
|
98
|
+
const depth = String(parseInt(depthArg, 10) || 2);
|
|
99
|
+
console.log(`Mapa de impacto: ${symbol} (profundidade ${depth})\n`);
|
|
100
|
+
const impact = runCodegraph(['impact', symbol, '-d', depth]);
|
|
101
|
+
if (impact.stdout) console.log(impact.stdout);
|
|
102
|
+
const callers = runCodegraph(['callers', symbol]);
|
|
103
|
+
if (callers.stdout) {
|
|
104
|
+
console.log('\n--- Chamadores diretos ---');
|
|
105
|
+
console.log(callers.stdout);
|
|
106
|
+
}
|
|
107
|
+
if (!impact.stdout && !callers.stdout) {
|
|
108
|
+
console.log('Nenhum no encontrado. Confirme o nome ou rode `npm run code:sync`.');
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
const [cmd, ...rest] = process.argv.slice(2);
|
|
113
|
+
switch (cmd) {
|
|
114
|
+
case 'check': cmdCheck(); break;
|
|
115
|
+
case 'impact': cmdImpact(rest[0], rest[1]); break;
|
|
116
|
+
default:
|
|
117
|
+
console.log('Uso: node scripts/code-intel.mjs <check|impact> [args]');
|
|
118
|
+
process.exit(cmd ? 1 : 0);
|
|
119
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Funções utilitárias compartilhadas para geração de arquivos
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
export function ensureDir(dirPath) {
|
|
9
|
+
fs.mkdirSync(dirPath, { recursive: true });
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
export function writeFileSafe(filePath, content, options = {}) {
|
|
13
|
+
const { force = false } = options;
|
|
14
|
+
if (fs.existsSync(filePath) && !force) {
|
|
15
|
+
throw new Error(`Arquivo ja existe: ${filePath}. Use --force para sobrescrever.`);
|
|
16
|
+
}
|
|
17
|
+
ensureDir(path.dirname(filePath));
|
|
18
|
+
fs.writeFileSync(filePath, content, 'utf8');
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export function maybeGitkeep(dirPath, options = {}) {
|
|
22
|
+
const { noGitkeep = false } = options;
|
|
23
|
+
if (noGitkeep) return;
|
|
24
|
+
const keepFile = path.join(dirPath, '.gitkeep');
|
|
25
|
+
if (!fs.existsSync(keepFile)) {
|
|
26
|
+
fs.writeFileSync(keepFile, '', 'utf8');
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export function log(message) {
|
|
31
|
+
console.log(message);
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export function logError(message) {
|
|
35
|
+
console.error(`❌ ${message}`);
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export function logSuccess(message) {
|
|
39
|
+
console.log(`✅ ${message}`);
|
|
40
|
+
}
|
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Structure Validator - Valida integridade da estrutura gerada
|
|
3
|
+
* Garante que todos os diretórios e arquivos críticos foram criados
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import fs from 'node:fs';
|
|
7
|
+
import path from 'node:path';
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Lista dos arquivos críticos que devem existir
|
|
11
|
+
*/
|
|
12
|
+
const CRITICAL_FILES = [
|
|
13
|
+
'memory/00-global/mission.md',
|
|
14
|
+
'memory/00-global/standards.md',
|
|
15
|
+
'memory/10-product/vision.md',
|
|
16
|
+
'memory/20-architecture/backend.md',
|
|
17
|
+
'memory/40-delivery/current-sprint.md',
|
|
18
|
+
'memory/50-orchestration/topology.md',
|
|
19
|
+
'AGENTS.md',
|
|
20
|
+
'.memoryrc.json',
|
|
21
|
+
];
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Lista de diretórios críticos
|
|
25
|
+
*/
|
|
26
|
+
const CRITICAL_DIRS = [
|
|
27
|
+
'memory',
|
|
28
|
+
'memory/00-global',
|
|
29
|
+
'memory/10-product',
|
|
30
|
+
'memory/20-architecture',
|
|
31
|
+
'memory/30-domains',
|
|
32
|
+
'memory/40-delivery',
|
|
33
|
+
'memory/50-orchestration',
|
|
34
|
+
'memory/60-runs',
|
|
35
|
+
'memory/70-summaries',
|
|
36
|
+
'agents',
|
|
37
|
+
'skills',
|
|
38
|
+
'prompts',
|
|
39
|
+
'.memory/sqlite',
|
|
40
|
+
];
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* Validações específicas do NestJS backend
|
|
44
|
+
*/
|
|
45
|
+
const NEST_CRITICAL_FILES = [
|
|
46
|
+
'backend/package.json',
|
|
47
|
+
'backend/src/main.ts',
|
|
48
|
+
'backend/src/app.module.ts',
|
|
49
|
+
'backend/src/app.controller.ts',
|
|
50
|
+
'backend/src/app.service.ts',
|
|
51
|
+
'backend/tsconfig.json',
|
|
52
|
+
];
|
|
53
|
+
|
|
54
|
+
const NEST_CRITICAL_DIRS = [
|
|
55
|
+
'backend/src',
|
|
56
|
+
'backend/src/modules/ops',
|
|
57
|
+
'backend/test',
|
|
58
|
+
'backend/scripts',
|
|
59
|
+
];
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* Valida estrutura de memória
|
|
63
|
+
* @param {string} baseDir - Diretório base
|
|
64
|
+
* @returns {Object} Resultado da validação
|
|
65
|
+
*/
|
|
66
|
+
export function validateMemoryStructure(baseDir) {
|
|
67
|
+
const errors = [];
|
|
68
|
+
const warnings = [];
|
|
69
|
+
|
|
70
|
+
// Validar arquivos críticos
|
|
71
|
+
for (const filePath of CRITICAL_FILES) {
|
|
72
|
+
const abs = path.join(baseDir, filePath);
|
|
73
|
+
if (!fs.existsSync(abs)) {
|
|
74
|
+
errors.push(`Arquivo crítico não encontrado: ${filePath}`);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
// Validar diretórios críticos
|
|
79
|
+
for (const dirPath of CRITICAL_DIRS) {
|
|
80
|
+
const abs = path.join(baseDir, dirPath);
|
|
81
|
+
if (!fs.existsSync(abs)) {
|
|
82
|
+
errors.push(`Diretório crítico não encontrado: ${dirPath}`);
|
|
83
|
+
} else if (!fs.statSync(abs).isDirectory()) {
|
|
84
|
+
errors.push(`Não é um diretório: ${dirPath}`);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
// Validar conteúdo de mission.md
|
|
89
|
+
const missionPath = path.join(baseDir, 'memory/00-global/mission.md');
|
|
90
|
+
if (fs.existsSync(missionPath)) {
|
|
91
|
+
const content = fs.readFileSync(missionPath, 'utf8');
|
|
92
|
+
if (!content.includes('Missao') && !content.includes('Missão')) {
|
|
93
|
+
warnings.push('mission.md parece estar vazio ou incorreto');
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
// Validar .memoryrc.json é JSON válido
|
|
98
|
+
const memoryrcPath = path.join(baseDir, '.memoryrc.json');
|
|
99
|
+
if (fs.existsSync(memoryrcPath)) {
|
|
100
|
+
try {
|
|
101
|
+
const content = fs.readFileSync(memoryrcPath, 'utf8');
|
|
102
|
+
JSON.parse(content);
|
|
103
|
+
} catch (e) {
|
|
104
|
+
errors.push('.memoryrc.json é JSON inválido');
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
return {
|
|
109
|
+
isValid: errors.length === 0,
|
|
110
|
+
errors,
|
|
111
|
+
warnings,
|
|
112
|
+
checklist: {
|
|
113
|
+
memoryStructure: CRITICAL_DIRS.length,
|
|
114
|
+
memoryFiles: CRITICAL_FILES.length,
|
|
115
|
+
},
|
|
116
|
+
};
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* Valida estrutura NestJS
|
|
121
|
+
* @param {string} baseDir - Diretório base
|
|
122
|
+
* @returns {Object} Resultado da validação
|
|
123
|
+
*/
|
|
124
|
+
export function validateNestStructure(baseDir) {
|
|
125
|
+
const errors = [];
|
|
126
|
+
const warnings = [];
|
|
127
|
+
|
|
128
|
+
// Validar arquivos críticos do NestJS
|
|
129
|
+
for (const filePath of NEST_CRITICAL_FILES) {
|
|
130
|
+
const abs = path.join(baseDir, filePath);
|
|
131
|
+
if (!fs.existsSync(abs)) {
|
|
132
|
+
errors.push(`Arquivo NestJS não encontrado: ${filePath}`);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
// Validar diretórios críticos do NestJS
|
|
137
|
+
for (const dirPath of NEST_CRITICAL_DIRS) {
|
|
138
|
+
const abs = path.join(baseDir, dirPath);
|
|
139
|
+
if (!fs.existsSync(abs)) {
|
|
140
|
+
errors.push(`Diretório NestJS não encontrado: ${dirPath}`);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
// Validar package.json
|
|
145
|
+
const pkgPath = path.join(baseDir, 'backend/package.json');
|
|
146
|
+
if (fs.existsSync(pkgPath)) {
|
|
147
|
+
try {
|
|
148
|
+
const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
|
|
149
|
+
if (!pkg.dependencies['@nestjs/common']) {
|
|
150
|
+
errors.push('package.json não contém @nestjs/common');
|
|
151
|
+
}
|
|
152
|
+
} catch (e) {
|
|
153
|
+
errors.push('backend/package.json é JSON inválido');
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
// Validar tsconfig.json
|
|
158
|
+
const tsconfigPath = path.join(baseDir, 'backend/tsconfig.json');
|
|
159
|
+
if (fs.existsSync(tsconfigPath)) {
|
|
160
|
+
try {
|
|
161
|
+
JSON.parse(fs.readFileSync(tsconfigPath, 'utf8'));
|
|
162
|
+
} catch (e) {
|
|
163
|
+
errors.push('backend/tsconfig.json é JSON inválido');
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
return {
|
|
168
|
+
isValid: errors.length === 0,
|
|
169
|
+
errors,
|
|
170
|
+
warnings,
|
|
171
|
+
checklist: {
|
|
172
|
+
nestDirectories: NEST_CRITICAL_DIRS.length,
|
|
173
|
+
nestFiles: NEST_CRITICAL_FILES.length,
|
|
174
|
+
},
|
|
175
|
+
};
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* Valida estrutura completa do projeto
|
|
180
|
+
* @param {string} baseDir - Diretório base
|
|
181
|
+
* @param {Object} options - Opções { includeNest: boolean }
|
|
182
|
+
* @returns {Object} Resultado completo
|
|
183
|
+
*/
|
|
184
|
+
export function validateProjectStructure(baseDir, options = {}) {
|
|
185
|
+
const { includeNest = false } = options;
|
|
186
|
+
|
|
187
|
+
const memoryResult = validateMemoryStructure(baseDir);
|
|
188
|
+
const results = { memory: memoryResult };
|
|
189
|
+
|
|
190
|
+
if (includeNest) {
|
|
191
|
+
results.nest = validateNestStructure(baseDir);
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
const allErrors = [
|
|
195
|
+
...memoryResult.errors,
|
|
196
|
+
...(results.nest?.errors || []),
|
|
197
|
+
];
|
|
198
|
+
|
|
199
|
+
return {
|
|
200
|
+
isValid: allErrors.length === 0,
|
|
201
|
+
errors: allErrors,
|
|
202
|
+
warnings: [
|
|
203
|
+
...memoryResult.warnings,
|
|
204
|
+
...(results.nest?.warnings || []),
|
|
205
|
+
],
|
|
206
|
+
results,
|
|
207
|
+
summary: {
|
|
208
|
+
totalErrors: allErrors.length,
|
|
209
|
+
hasNest: includeNest,
|
|
210
|
+
timestamp: new Date().toISOString(),
|
|
211
|
+
},
|
|
212
|
+
};
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
/**
|
|
216
|
+
* Imprime relatório de validação de forma amigável
|
|
217
|
+
* @param {Object} report - Resultado de validateProjectStructure
|
|
218
|
+
*/
|
|
219
|
+
export function printValidationReport(report) {
|
|
220
|
+
if (report.isValid) {
|
|
221
|
+
console.log('✅ Estrutura do projeto é válida!');
|
|
222
|
+
} else {
|
|
223
|
+
console.log('❌ Estrutura do projeto tem problemas:');
|
|
224
|
+
console.log('');
|
|
225
|
+
for (const error of report.errors) {
|
|
226
|
+
console.log(` ❌ ${error}`);
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
if (report.warnings.length > 0) {
|
|
231
|
+
console.log('');
|
|
232
|
+
console.log('⚠️ Avisos:');
|
|
233
|
+
for (const warning of report.warnings) {
|
|
234
|
+
console.log(` ⚠️ ${warning}`);
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
if (report.summary) {
|
|
239
|
+
console.log('');
|
|
240
|
+
console.log(`📊 Verificado em: ${report.summary.timestamp}`);
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
export default {
|
|
245
|
+
validateProjectStructure,
|
|
246
|
+
validateMemoryStructure,
|
|
247
|
+
validateNestStructure,
|
|
248
|
+
printValidationReport,
|
|
249
|
+
CRITICAL_FILES,
|
|
250
|
+
CRITICAL_DIRS,
|
|
251
|
+
NEST_CRITICAL_FILES,
|
|
252
|
+
NEST_CRITICAL_DIRS,
|
|
253
|
+
};
|
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* lib/workspace.mjs
|
|
3
|
+
*
|
|
4
|
+
* Centraliza a resolução de caminhos do workspace Forja.
|
|
5
|
+
*
|
|
6
|
+
* Regras de prioridade para descobrir o workspace:
|
|
7
|
+
* 1. Variável de ambiente FORJA_WORKSPACE
|
|
8
|
+
* 2. Arquivo ~/.forjarc.json (campo workspaceRoot)
|
|
9
|
+
* 3. Default: ~/forja-workspace
|
|
10
|
+
*
|
|
11
|
+
* O workspace é o "canto fixo" onde projetos de produto vivem:
|
|
12
|
+
* ~/forja-workspace/
|
|
13
|
+
* projects/ # projetos gerados
|
|
14
|
+
* memory/ # memória universal do workspace
|
|
15
|
+
* sqlite/universal.db # SQLite FTS5
|
|
16
|
+
* 30-projects/ # fichas de projetos
|
|
17
|
+
* specs/ # specs de produto
|
|
18
|
+
* .context/ # runbooks GSD de produto
|
|
19
|
+
* .forjarc.json # config local do workspace (opcional)
|
|
20
|
+
*/
|
|
21
|
+
|
|
22
|
+
import fs from 'node:fs';
|
|
23
|
+
import path from 'node:path';
|
|
24
|
+
import os from 'node:os';
|
|
25
|
+
import { fileURLToPath } from 'node:url';
|
|
26
|
+
|
|
27
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
28
|
+
const __dirname = path.dirname(__filename);
|
|
29
|
+
|
|
30
|
+
const DEFAULT_WORKSPACE_NAME = 'forja-workspace';
|
|
31
|
+
|
|
32
|
+
function getHomeDir() {
|
|
33
|
+
return os.homedir();
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
function readJsonSafe(filePath) {
|
|
37
|
+
try {
|
|
38
|
+
const raw = fs.readFileSync(filePath, 'utf8');
|
|
39
|
+
return JSON.parse(raw);
|
|
40
|
+
} catch {
|
|
41
|
+
return null;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export function getUserConfigPath() {
|
|
46
|
+
return path.join(getHomeDir(), '.forjarc.json');
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export function getWorkspaceRoot() {
|
|
50
|
+
if (process.env.FORJA_WORKSPACE) {
|
|
51
|
+
return path.resolve(process.env.FORJA_WORKSPACE);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
const userConfig = readJsonSafe(getUserConfigPath());
|
|
55
|
+
if (userConfig?.workspaceRoot) {
|
|
56
|
+
return path.resolve(userConfig.workspaceRoot);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
return path.join(getHomeDir(), DEFAULT_WORKSPACE_NAME);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
export function getWorkspaceInfo() {
|
|
63
|
+
const root = getWorkspaceRoot();
|
|
64
|
+
return {
|
|
65
|
+
root,
|
|
66
|
+
source: process.env.FORJA_WORKSPACE
|
|
67
|
+
? 'FORJA_WORKSPACE'
|
|
68
|
+
: fs.existsSync(getUserConfigPath())
|
|
69
|
+
? '~/.forjarc.json'
|
|
70
|
+
: 'default',
|
|
71
|
+
exists: fs.existsSync(root),
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export function getProjectsDir() {
|
|
76
|
+
return path.join(getWorkspaceRoot(), 'projects');
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export function getWorkspaceMemoryDir() {
|
|
80
|
+
return path.join(getWorkspaceRoot(), 'memory');
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
export function getWorkspaceDbDir() {
|
|
84
|
+
return path.join(getWorkspaceMemoryDir(), 'sqlite');
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
export function getWorkspaceDbPath() {
|
|
88
|
+
return path.join(getWorkspaceDbDir(), 'universal.db');
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
export function getWorkspaceProjectsMemoryDir() {
|
|
92
|
+
return path.join(getWorkspaceMemoryDir(), '30-projects');
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
export function getWorkspaceSpecsDir() {
|
|
96
|
+
return path.join(getWorkspaceRoot(), 'specs');
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
export function getWorkspaceContextDir() {
|
|
100
|
+
return path.join(getWorkspaceRoot(), '.context');
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
export function resolveProject(name) {
|
|
104
|
+
if (!name || typeof name !== 'string') {
|
|
105
|
+
throw new Error('Nome do projeto é obrigatório');
|
|
106
|
+
}
|
|
107
|
+
const safe = name.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
|
|
108
|
+
if (!safe) {
|
|
109
|
+
throw new Error(`Nome de projeto inválido: ${name}`);
|
|
110
|
+
}
|
|
111
|
+
return path.join(getProjectsDir(), safe);
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
export function listProjects() {
|
|
115
|
+
const dir = getProjectsDir();
|
|
116
|
+
if (!fs.existsSync(dir)) return [];
|
|
117
|
+
return fs
|
|
118
|
+
.readdirSync(dir, { withFileTypes: true })
|
|
119
|
+
.filter((entry) => entry.isDirectory())
|
|
120
|
+
.map((entry) => entry.name);
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
export function ensureDir(dir) {
|
|
124
|
+
if (!fs.existsSync(dir)) {
|
|
125
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
126
|
+
}
|
|
127
|
+
return dir;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
export function initWorkspace() {
|
|
131
|
+
const root = ensureDir(getWorkspaceRoot());
|
|
132
|
+
ensureDir(getProjectsDir());
|
|
133
|
+
ensureDir(getWorkspaceMemoryDir());
|
|
134
|
+
ensureDir(getWorkspaceDbDir());
|
|
135
|
+
ensureDir(getWorkspaceProjectsMemoryDir());
|
|
136
|
+
ensureDir(getWorkspaceSpecsDir());
|
|
137
|
+
ensureDir(getWorkspaceContextDir());
|
|
138
|
+
|
|
139
|
+
// Cria README de convenção no workspace
|
|
140
|
+
const readmePath = path.join(root, 'README.md');
|
|
141
|
+
if (!fs.existsSync(readmePath)) {
|
|
142
|
+
fs.writeFileSync(
|
|
143
|
+
readmePath,
|
|
144
|
+
`# Forja Workspace
|
|
145
|
+
|
|
146
|
+
Este é o workspace de produção do Forja. Aqui vivem projetos gerados, memória universal e specs de produto.
|
|
147
|
+
|
|
148
|
+
## Estrutura
|
|
149
|
+
|
|
150
|
+
- \`projects/\` — projetos gerados pelo Forja.
|
|
151
|
+
- \`memory/sqlite/universal.db\` — memória universal indexada (SQLite + FTS5).
|
|
152
|
+
- \`memory/30-projects/\` — fichas dos projetos.
|
|
153
|
+
- \`specs/\` — specs de produto.
|
|
154
|
+
- \`.context/\` — runbooks GSD de produto.
|
|
155
|
+
|
|
156
|
+
## Configuração
|
|
157
|
+
|
|
158
|
+
O caminho do workspace é resolvido por prioridade:
|
|
159
|
+
|
|
160
|
+
1. Variável \`FORJA_WORKSPACE\`
|
|
161
|
+
2. Campo \`workspaceRoot\` em \`~/.forjarc.json\`
|
|
162
|
+
3. Padrão: \`~/forja-workspace\`
|
|
163
|
+
|
|
164
|
+
## Comandos úteis
|
|
165
|
+
|
|
166
|
+
- \`npm run dev -- workspace:init\` — recria estrutura base.
|
|
167
|
+
- \`npm run dev -- project:new <nome>\` — cria novo projeto.
|
|
168
|
+
- \`npm run dev -- project:list\` — lista projetos.
|
|
169
|
+
- \`npm run dev -- project:check <nome>\` — valida padrões.
|
|
170
|
+
`,
|
|
171
|
+
'utf8'
|
|
172
|
+
);
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
// Cria .forjarc.json local apenas se não houver config global
|
|
176
|
+
const localConfigPath = path.join(root, '.forjarc.json');
|
|
177
|
+
if (!fs.existsSync(localConfigPath) && !fs.existsSync(getUserConfigPath()) && !process.env.FORJA_WORKSPACE) {
|
|
178
|
+
fs.writeFileSync(
|
|
179
|
+
localConfigPath,
|
|
180
|
+
JSON.stringify({ workspaceRoot: root }, null, 2) + '\n',
|
|
181
|
+
'utf8'
|
|
182
|
+
);
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
// Cria README em 30-projects
|
|
186
|
+
const projectsMemoryReadme = path.join(getWorkspaceProjectsMemoryDir(), 'README.md');
|
|
187
|
+
if (!fs.existsSync(projectsMemoryReadme)) {
|
|
188
|
+
fs.writeFileSync(
|
|
189
|
+
projectsMemoryReadme,
|
|
190
|
+
`# Projetos do Workspace
|
|
191
|
+
|
|
192
|
+
Fichas de projetos gerados pelo Forja. Cada arquivo representa um produto ativo ou arquivado.
|
|
193
|
+
`,
|
|
194
|
+
'utf8'
|
|
195
|
+
);
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
return root;
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
export function isInsideFrameworkRepo(filePath) {
|
|
202
|
+
const frameworkRoot = path.resolve(__dirname, '..');
|
|
203
|
+
const resolved = path.resolve(filePath);
|
|
204
|
+
return resolved === frameworkRoot || resolved.startsWith(frameworkRoot + path.sep);
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
export function assertOutsideFrameworkRepo(filePath, operation = 'operacao') {
|
|
208
|
+
if (isInsideFrameworkRepo(filePath)) {
|
|
209
|
+
throw new Error(
|
|
210
|
+
`${operation} não pode ser executada dentro do repositório do framework Forja. Use o workspace externo (~/forja-workspace).`
|
|
211
|
+
);
|
|
212
|
+
}
|
|
213
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Missão Universal: Projeto Agentes
|
|
2
|
+
|
|
3
|
+
## Propósito
|
|
4
|
+
Criar um ecossistema de agentes orquestrados, independentes de LLM, com memória persistente e universal para acelerar o desenvolvimento de produtos escaláveis.
|
|
5
|
+
|
|
6
|
+
## Objetivos
|
|
7
|
+
1. **Independência de LLM**: Funcionar com Gemini, Claude, OpenAI, etc.
|
|
8
|
+
2. **Memória Universal**: Banco de dados SQLite central que indexa documentação de todos os projetos.
|
|
9
|
+
3. **Escalabilidade**: Camadas de metodologia para crescimento do produto (Growth, Scaling).
|
|
10
|
+
4. **Isolamento**: Projetos gerados são isolados e não poluem o repositório principal.
|
|
11
|
+
|
|
12
|
+
## Pilares
|
|
13
|
+
- **Memória Hierárquica**: Global -> Projeto -> Domínio -> Tarefa.
|
|
14
|
+
- **Orquestração**: Divisão clara de papéis e responsabilidades.
|
|
15
|
+
- **Continuidade**: Handoffs que preservam o contexto entre sessões e agentes.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Base de Conhecimento Compartilhada (Patterns)
|
|
2
|
+
|
|
3
|
+
> Preenchida via Cross-Project Analysis (`npm run memory:extract`): padrões que se
|
|
4
|
+
> repetem em 2+ projetos do workspace são promovidos para cá, **sem dados de
|
|
5
|
+
> produto** — apenas o padrão generalizado.
|
|
6
|
+
|
|
7
|
+
Nenhum padrão promovido ainda nesta instalação. Conhecimento específico de cada
|
|
8
|
+
produto vive na ficha do projeto em `<workspace>/memory/30-projects/`.
|