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,77 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* tools-doctor — raio-x das ferramentas de processo (ADR-0018).
|
|
4
|
+
*
|
|
5
|
+
* Detecta binarios opcionais que potencializam o harness. Nunca impoe:
|
|
6
|
+
* reporta instalado/ausente + como instalar. Governanca decide quais gates
|
|
7
|
+
* ativar conforme disponibilidade.
|
|
8
|
+
*
|
|
9
|
+
* Uso: node scripts/tools-doctor.mjs
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
import { spawnSync } from 'node:child_process';
|
|
13
|
+
|
|
14
|
+
const TOOLS = [
|
|
15
|
+
{
|
|
16
|
+
name: 'codegraph',
|
|
17
|
+
probe: ['codegraph', ['--version']],
|
|
18
|
+
role: 'Code intelligence: chamadores, blast radius, mapa de impacto (ADR-0017).',
|
|
19
|
+
install: 'npm i -g @codegraph/cli',
|
|
20
|
+
gate: 'npm run code:check / code:impact',
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
name: 'gitleaks',
|
|
24
|
+
probe: ['gitleaks', ['version']],
|
|
25
|
+
role: 'Varredura de segredos antes de merge/release.',
|
|
26
|
+
install: 'https://github.com/gitleaks/gitleaks (binario) ou: brew install gitleaks',
|
|
27
|
+
gate: 'gitleaks detect --no-banner (gate de Governance)',
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
name: 'ast-grep',
|
|
31
|
+
probe: ['ast-grep', ['--version']],
|
|
32
|
+
role: 'Busca e codemod estrutural por AST — refactor seguro do Worker.',
|
|
33
|
+
install: 'npm i -g @ast-grep/cli (binarios: ast-grep / sg)',
|
|
34
|
+
gate: 'ast-grep run -p "<pattern>" -r "<rewrite>"',
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
name: 'lefthook',
|
|
38
|
+
probe: ['lefthook', ['version']],
|
|
39
|
+
role: 'Pre-commit rodando project:check / spec:check automaticamente.',
|
|
40
|
+
install: 'npm i -g lefthook (depois: lefthook install)',
|
|
41
|
+
gate: '.lefthook.yml (pre-commit)',
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
name: 'markdownlint',
|
|
45
|
+
probe: ['markdownlint-cli2', ['--version']],
|
|
46
|
+
role: 'Lint da documentacao (docs e memory sao centrais aqui).',
|
|
47
|
+
install: 'npm i -g markdownlint-cli2',
|
|
48
|
+
gate: 'markdownlint-cli2 "docs/**/*.md"',
|
|
49
|
+
},
|
|
50
|
+
];
|
|
51
|
+
|
|
52
|
+
function detect(cmd, args) {
|
|
53
|
+
const res = spawnSync(cmd, args, { encoding: 'utf8' });
|
|
54
|
+
if (res.error && res.error.code === 'ENOENT') return { ok: false };
|
|
55
|
+
const version = (res.stdout || res.stderr || '').trim().split('\n')[0] || 'instalado';
|
|
56
|
+
return { ok: true, version };
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
function main() {
|
|
60
|
+
console.log('\nTools doctor — ferramentas de processo (ADR-0018)\n');
|
|
61
|
+
let installed = 0;
|
|
62
|
+
for (const tool of TOOLS) {
|
|
63
|
+
const [cmd, args] = tool.probe;
|
|
64
|
+
const { ok, version } = detect(cmd, args);
|
|
65
|
+
if (ok) installed += 1;
|
|
66
|
+
const tag = ok ? 'OK ' : 'FALTA';
|
|
67
|
+
console.log(`${tag} ${tool.name.padEnd(13)} ${ok ? version : '(ausente)'}`);
|
|
68
|
+
console.log(` papel: ${tool.role}`);
|
|
69
|
+
console.log(` gate: ${tool.gate}`);
|
|
70
|
+
if (!ok) console.log(` instalar: ${tool.install}`);
|
|
71
|
+
console.log('');
|
|
72
|
+
}
|
|
73
|
+
console.log(`Resumo: ${installed}/${TOOLS.length} ferramentas disponiveis.`);
|
|
74
|
+
console.log('Ferramentas ausentes apenas desativam seus gates — o fluxo nunca trava por elas.');
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
main();
|
package/specs/README.md
ADDED
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# Specs — Pipeline SDD
|
|
2
|
+
|
|
3
|
+
Toda feature não-trivial passa por **spec → plan → tasks** antes de virar código.
|
|
4
|
+
|
|
5
|
+
## Fluxo
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
9
|
+
│ spec │ → │ plan │ → │ tasks │ → │ código │
|
|
10
|
+
│ (porquê) │ │ (como) │ │ (passos) │ │ (impl.) │
|
|
11
|
+
└──────────┘ └──────────┘ └──────────┘ └──────────┘
|
|
12
|
+
Product SDD Architect SDD Architect Worker
|
|
13
|
+
+ Governance
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Comandos
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npm run spec:new <feature> # cria specs/<feature>/spec.md
|
|
20
|
+
npm run spec:plan <feature> # cria plan.md (após spec aprovada)
|
|
21
|
+
npm run spec:tasks <feature> # cria tasks.md (após plan aprovado)
|
|
22
|
+
npm run spec:check <feature> # valida que as 3 fases existem e foram preenchidas
|
|
23
|
+
npm run spec:check # valida todas
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Estrutura de uma feature
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
specs/
|
|
30
|
+
<feature-slug>/
|
|
31
|
+
spec.md # problema, AC, NFRs, escopo
|
|
32
|
+
plan.md # arquitetura, contratos, decisões
|
|
33
|
+
tasks.md # decomposição executável
|
|
34
|
+
notes/ # opcional: research, mockups
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Critérios de "spec aprovada"
|
|
38
|
+
|
|
39
|
+
- Problema descrito em 1 frase
|
|
40
|
+
- Pelo menos 1 user story com persona, ação, benefício
|
|
41
|
+
- ≥3 critérios de aceite observáveis
|
|
42
|
+
- Escopo fora explicitado
|
|
43
|
+
- NFRs com números (não "rápido", mas "p95 < 200ms")
|
|
44
|
+
|
|
45
|
+
## Quando NÃO precisa de spec
|
|
46
|
+
|
|
47
|
+
- Bugfix de 1 linha
|
|
48
|
+
- Renomeação/rearranjo sem mudança de contrato
|
|
49
|
+
- Atualização de documentação
|
|
50
|
+
- Bump de dependência sem breaking change
|
|
51
|
+
|
|
52
|
+
Em dúvida: escreva spec. Custa 10min, salva retrabalho.
|
|
53
|
+
|
|
54
|
+
## Relação com ADRs
|
|
55
|
+
|
|
56
|
+
- **Spec** = "vamos fazer X"
|
|
57
|
+
- **ADR** = "decidimos fazer X **deste jeito** por **estas razões**"
|
|
58
|
+
|
|
59
|
+
Plan da spec pode gerar 0..N ADRs novas. Toda decisão estrutural irreversível mencionada no plan vira ADR em `memory/90-decisions/`.
|
|
60
|
+
|
|
61
|
+
## Estados
|
|
62
|
+
|
|
63
|
+
| Estado | Significado |
|
|
64
|
+
|---|---|
|
|
65
|
+
| `draft` | Em escrita, não revise ainda |
|
|
66
|
+
| `review` | Pronto para feedback |
|
|
67
|
+
| `approved` | OK para próxima fase (plan ou tasks) |
|
|
68
|
+
| `implementing` | Código sendo escrito |
|
|
69
|
+
| `done` | Mergeado e validado |
|
|
70
|
+
| `abandoned` | Não vai acontecer (mantemos por histórico) |
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Plan: {{FEATURE}}
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: draft | review | approved
|
|
5
|
+
- **Criado em**: {{DATE}}
|
|
6
|
+
|
|
7
|
+
> Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
|
|
8
|
+
|
|
9
|
+
## 1. Abordagem técnica
|
|
10
|
+
<Visão geral em 3-5 linhas. Qual estratégia (extend vs. rewrite, lib vs. service, sync vs. async).>
|
|
11
|
+
|
|
12
|
+
## 2. Módulos afetados
|
|
13
|
+
| Caminho | Mudança | Risco |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| `lib/...` | criar / editar / remover | B/M/A |
|
|
16
|
+
| `scripts/...` | ... | ... |
|
|
17
|
+
|
|
18
|
+
## 3. Diagrama de fluxo
|
|
19
|
+
```
|
|
20
|
+
<ASCII ou descrição textual do fluxo de dados/controle>
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## 4. Contratos (API/CLI/Schema)
|
|
24
|
+
<Assinatura de funções públicas, endpoints, formato de arquivos novos.>
|
|
25
|
+
|
|
26
|
+
## 5. Decisões e alternativas
|
|
27
|
+
**D1**: <decisão> — alternativas rejeitadas: <A> (por X), <B> (por Y)
|
|
28
|
+
**D2**: ...
|
|
29
|
+
|
|
30
|
+
Se alguma D é estrutural ou irreversível, abra ADR em `memory/90-decisions/` e referencie aqui.
|
|
31
|
+
|
|
32
|
+
## 6. Dependências
|
|
33
|
+
- Outras specs: ...
|
|
34
|
+
- Pacotes npm: ...
|
|
35
|
+
- Migrações de dado/memory: ...
|
|
36
|
+
|
|
37
|
+
## 7. Rollout
|
|
38
|
+
- [ ] Feature flag necessária?
|
|
39
|
+
- [ ] Migração de dados existentes?
|
|
40
|
+
- [ ] Doc/persona impactada?
|
|
41
|
+
|
|
42
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
43
|
+
<O que faria abandonar essa abordagem mid-flight?>
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Spec: {{FEATURE}}
|
|
2
|
+
|
|
3
|
+
- **ID**: {{ID}}
|
|
4
|
+
- **Status**: draft | review | approved | implementing | done | abandoned
|
|
5
|
+
- **Owner**: {{OWNER}}
|
|
6
|
+
- **Criado em**: {{DATE}}
|
|
7
|
+
- **Sprint alvo**: <S?>
|
|
8
|
+
- **ADRs relacionadas**: <links para memory/90-decisions/>
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
<O que está doendo? Quem sente a dor? Como medimos hoje?>
|
|
12
|
+
|
|
13
|
+
## 2. Proposta de valor
|
|
14
|
+
<O que muda quando isto existir? Frase única, mensurável.>
|
|
15
|
+
|
|
16
|
+
## 3. User stories
|
|
17
|
+
- **Como** <persona>, **quero** <ação>, **para que** <benefício>
|
|
18
|
+
- ...
|
|
19
|
+
|
|
20
|
+
## 4. Critérios de aceite (Definition of Done)
|
|
21
|
+
- [ ] AC-1: <observável, testável>
|
|
22
|
+
- [ ] AC-2: ...
|
|
23
|
+
|
|
24
|
+
## 5. Escopo
|
|
25
|
+
**Dentro**:
|
|
26
|
+
- ...
|
|
27
|
+
|
|
28
|
+
**Fora** (explícito, evita scope creep):
|
|
29
|
+
- ...
|
|
30
|
+
|
|
31
|
+
## 6. NFRs / restrições
|
|
32
|
+
- Performance: <ex: p95 < 200ms>
|
|
33
|
+
- Segurança: <ex: validação class-validator obrigatória — ADR-0004>
|
|
34
|
+
- Observabilidade: <ex: log estruturado por endpoint>
|
|
35
|
+
- Compatibilidade: <ex: não quebra `init-project.js`>
|
|
36
|
+
|
|
37
|
+
## 7. Riscos e mitigação
|
|
38
|
+
| Risco | Probabilidade | Impacto | Mitigação |
|
|
39
|
+
|---|---|---|---|
|
|
40
|
+
| ... | M | A | ... |
|
|
41
|
+
|
|
42
|
+
## 8. Métricas de sucesso
|
|
43
|
+
<Como saberemos se foi um sucesso 30 dias após o release?>
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Tasks: {{FEATURE}}
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Plan**: ./plan.md
|
|
5
|
+
- **Status**: draft
|
|
6
|
+
- **Criado em**: {{DATE}}
|
|
7
|
+
|
|
8
|
+
> Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
|
|
9
|
+
|
|
10
|
+
Convenção de IDs: `T1`, `T2`, ... Sequência reflete ordem de execução padrão (pode ser paralelizada quando indicado).
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## T1 — <título curto>
|
|
15
|
+
- **Owner**: <agente ou pessoa>
|
|
16
|
+
- **Estimativa**: <P/M/G>
|
|
17
|
+
- **Depende de**: —
|
|
18
|
+
- **Paths**: `lib/...`, `scripts/...`
|
|
19
|
+
- **Done quando**:
|
|
20
|
+
- [ ] ...
|
|
21
|
+
- [ ] testes passando
|
|
22
|
+
- [ ] doc atualizada (se aplicável)
|
|
23
|
+
|
|
24
|
+
## T2 — ...
|
|
25
|
+
- **Owner**: ...
|
|
26
|
+
- **Depende de**: T1
|
|
27
|
+
- ...
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Handoffs entre agentes
|
|
32
|
+
Se este conjunto de tasks atravessa papéis (Product → SDD Architect → Worker → Governance), registre handoff via `scripts/append-handoff.mjs` ou tabela `handoffs` do `universal.db` (ADR-0005).
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
# Plan: agent-dashboard
|
|
2
|
+
|
|
3
|
+
- **Spec**: ./spec.md
|
|
4
|
+
- **Status**: approved
|
|
5
|
+
- **Criado em**: 2026-05-11
|
|
6
|
+
|
|
7
|
+
## 1. Abordagem técnica
|
|
8
|
+
|
|
9
|
+
Servidor único Node (Fastify) servindo: **(a)** JSON API que lê `universal.db` + filesystem, **(b)** SPA estática buildada do `dashboard/web/`. Não há SSR, não há processo separado. SPA chama `/api/*`. Comandos do framework são disparados via `child_process.spawn` com **allowlist hard-coded**, stream de stdout/stderr via SSE (Server-Sent Events — mais simples que WebSocket, suficiente para output linear). Briefing → spec é shell-out para `scripts/spec-cli.mjs` + um parser de heurística (sem LLM nesta versão).
|
|
10
|
+
|
|
11
|
+
Tudo isolado em `dashboard/` com seu próprio `package.json`. O kit raiz não ganha dependência runtime nova — `npm run dashboard` no root delega para `cd dashboard && npm start`.
|
|
12
|
+
|
|
13
|
+
## 2. Módulos afetados
|
|
14
|
+
|
|
15
|
+
| Caminho | Mudança | Risco |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| `dashboard/package.json` | criar — deps: fastify, better-sqlite3 (já existe no kit), execa | B |
|
|
18
|
+
| `dashboard/server/index.mjs` | criar — bootstrap Fastify + registro de rotas | B |
|
|
19
|
+
| `dashboard/server/routes/specs.mjs` | criar — `GET /api/specs`, `GET /api/specs/:slug` | B |
|
|
20
|
+
| `dashboard/server/routes/handoffs.mjs` | criar — `GET /api/handoffs`, `POST /api/handoffs/:id/transition` | M |
|
|
21
|
+
| `dashboard/server/routes/tokens.mjs` | criar — `GET /api/tokens?project=&days=30` | M |
|
|
22
|
+
| `dashboard/server/routes/projects.mjs` | criar — `GET /api/projects` | B |
|
|
23
|
+
| `dashboard/server/routes/commands.mjs` | criar — `POST /api/commands/:name` com SSE; allowlist | A (RCE) |
|
|
24
|
+
| `dashboard/server/routes/briefing.mjs` | criar — `POST /api/briefing` → cria spec | M |
|
|
25
|
+
| `dashboard/server/lib/allowlist.mjs` | criar — fonte única de comandos permitidos | A |
|
|
26
|
+
| `dashboard/server/lib/briefing-parser.mjs` | criar — heurística texto → seções spec | M |
|
|
27
|
+
| `dashboard/server/lib/token-estimator.mjs` | criar — chars/4 + leitura de `60-runs/` | B |
|
|
28
|
+
| `dashboard/web/` (Vite+React) | criar — 5 telas + layout | M |
|
|
29
|
+
| `package.json` (root) | editar — adicionar `dashboard` script | B |
|
|
30
|
+
| `.gitignore` | editar — ignorar `dashboard/web/dist`, `dashboard/node_modules` | B |
|
|
31
|
+
| `docs/dashboard.md` | criar — uso, troubleshooting, allowlist | B |
|
|
32
|
+
|
|
33
|
+
## 3. Diagrama de fluxo
|
|
34
|
+
|
|
35
|
+
```
|
|
36
|
+
Browser (localhost:7777)
|
|
37
|
+
│
|
|
38
|
+
├─ HTML/JS estático ──→ dashboard/web/dist/
|
|
39
|
+
│
|
|
40
|
+
└─ /api/* ──→ Fastify ──┬─ better-sqlite3 ──→ .memory/sqlite/universal.db
|
|
41
|
+
├─ fs ──→ specs/, projects/, memory/60-runs/
|
|
42
|
+
└─ spawn (allowlist) ──→ scripts/spec-cli.mjs
|
|
43
|
+
──→ scripts/agent-router.mjs
|
|
44
|
+
──→ scripts/compress-memory.mjs
|
|
45
|
+
──→ scripts/sync-universal-memory.js
|
|
46
|
+
──→ scripts/check-standards.js
|
|
47
|
+
──→ scripts/sprint-manager.js
|
|
48
|
+
|
|
49
|
+
SSE stream de stdout/stderr ─────────────────→ painel lateral da UI
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## 4. Contratos (API)
|
|
53
|
+
|
|
54
|
+
Todas as rotas montadas sob `/api`. Retorno padrão JSON. Erros 4xx/5xx em `{error: string, code: string}`.
|
|
55
|
+
|
|
56
|
+
### Leitura
|
|
57
|
+
|
|
58
|
+
```ts
|
|
59
|
+
GET /api/specs
|
|
60
|
+
→ [{ slug, status, file, sprint, owner, hasplan, hastasks }]
|
|
61
|
+
|
|
62
|
+
GET /api/specs/:slug
|
|
63
|
+
→ { slug, spec: string, plan: string|null, tasks: string|null }
|
|
64
|
+
|
|
65
|
+
GET /api/handoffs?status=open|in_progress|done&to=<agent>
|
|
66
|
+
→ [{ id, created_at, from_agent, to_agent, intent, status, spec_slug, ... }]
|
|
67
|
+
|
|
68
|
+
POST /api/handoffs/:id/transition
|
|
69
|
+
body: { to: "in_progress"|"done"|"cancelled" }
|
|
70
|
+
→ { id, status }
|
|
71
|
+
|
|
72
|
+
GET /api/projects
|
|
73
|
+
→ [{ name, path, specs_open, handoffs_open, last_commit, memory_bytes }]
|
|
74
|
+
|
|
75
|
+
GET /api/tokens?project=<name>&days=30
|
|
76
|
+
→ { project, days, series: [{ date, tokens_in, tokens_out, mode_breakdown }] }
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### Mutação controlada
|
|
80
|
+
|
|
81
|
+
```ts
|
|
82
|
+
POST /api/commands/:name
|
|
83
|
+
body: { args?: string[] } // args só usado se a entrada na allowlist permitir
|
|
84
|
+
→ SSE stream (text/event-stream): evento "stdout"|"stderr"|"exit"
|
|
85
|
+
|
|
86
|
+
:name ∈ COMMAND_ALLOWLIST (commands.mjs)
|
|
87
|
+
|
|
88
|
+
POST /api/briefing
|
|
89
|
+
body: { brief: string, slug?: string, projectHint?: string }
|
|
90
|
+
→ { slug, specPath, parsed: { problem, value, stories } }
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### Allowlist (hard-coded)
|
|
94
|
+
|
|
95
|
+
```js
|
|
96
|
+
export const COMMAND_ALLOWLIST = {
|
|
97
|
+
'spec:check': { cmd: 'node', args: ['scripts/spec-cli.mjs', 'check'] },
|
|
98
|
+
'sync:universal': { cmd: 'node', args: ['scripts/sync-universal-memory.js'] },
|
|
99
|
+
'memory:vacuum': { cmd: 'node', args: ['scripts/compress-memory.mjs'] },
|
|
100
|
+
'project:check': { cmd: 'node', args: ['scripts/check-standards.js'] },
|
|
101
|
+
'sprint:status': { cmd: 'node', args: ['scripts/sprint-manager.js', 'status'] },
|
|
102
|
+
};
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Qualquer outro `:name` retorna `403 { error: "command not allowlisted" }`. Sem interpolação de shell — `spawn` direto sem `shell: true`. `args` do body só é apendado se a entrada da allowlist marcar `acceptsArgs: true` (nenhuma marca isso na v1).
|
|
106
|
+
|
|
107
|
+
## 5. Decisões e alternativas
|
|
108
|
+
|
|
109
|
+
**D1 — Fastify em vez de Express**
|
|
110
|
+
Razão: mais rápido, hooks de erro estritos, schema validation embutida. Rejeitada: Express (mais boilerplate, precisa ajv separado).
|
|
111
|
+
|
|
112
|
+
**D2 — Vite + React + shadcn/ui**
|
|
113
|
+
Razão: shadcn é copy-paste (não vira dep gigante), Tailwind já é stack confortável, ecossistema rico de tabelas/kanban/charts. Rejeitada: htmx puro (gráfico precisa Recharts); Svelte (menos componentes prontos).
|
|
114
|
+
|
|
115
|
+
**D3 — SSE em vez de WebSocket**
|
|
116
|
+
Razão: stdout/stderr é unidirecional. SSE roda em HTTP simples, sem upgrade, sem libs. Rejeitada: WebSocket (over-engineering); polling em log file (latência, cleanup).
|
|
117
|
+
|
|
118
|
+
**D4 — Allowlist literal em código, não config**
|
|
119
|
+
Razão: arquivo editável aumenta superfície (quem escreve no `.allowlist.json` ganha RCE). Hard-coded em `.mjs` exige PR + revisão. Rejeitada: regex `spec:*` (escapa para `spec:; rm -rf` se algum dia passar via shell).
|
|
120
|
+
|
|
121
|
+
**D5 — Briefing parser heurístico, sem LLM nesta versão**
|
|
122
|
+
Razão: dep zero, custo zero, latência zero. Heurística: split em parágrafos, busca palavras-chave ("problema", "queremos", "para que <persona>"), preenche seções 1-3 do template. Saída fica em `draft` — revisão humana obrigatória. Rejeitada nesta versão: Anthropic API (env var, custo, latência, dep). Evolui para v2 (potencial ADR-0011).
|
|
123
|
+
|
|
124
|
+
**D6 — Pasta `dashboard/` isolada com próprio `package.json`**
|
|
125
|
+
Razão: zero impacto em quem só usa o kit como scaffold. Rejeitada: workspaces npm (complica `npm publish` do kit).
|
|
126
|
+
|
|
127
|
+
**D7 — Token estimator: chars/4, sem chamada API real**
|
|
128
|
+
Razão: spec §5 já marca "custo real" como fora de escopo. Estimativa rotulada na UI. Fonte: agrega `memory/60-runs/*.json` se existir, lê tamanho dos packs em `.context/` por projeto. Rejeitada: Anthropic Usage API (exige API key local, expõe credencial).
|
|
129
|
+
|
|
130
|
+
**D8 — Porta 7777 default, configurável via `DASHBOARD_PORT`**
|
|
131
|
+
Razão: porta raramente ocupada. Override por env var resolve conflito.
|
|
132
|
+
|
|
133
|
+
> Nenhuma destas decisões parece estrutural-irreversível o suficiente para abrir ADR. Se durante a impl emergir uma irreversível, abrir ADR-0010.
|
|
134
|
+
|
|
135
|
+
## 6. Dependências
|
|
136
|
+
|
|
137
|
+
- **Specs**: depende de SPEC-001 (já em `implementing`) — usa `spec-cli.mjs` e `agent-router.mjs`
|
|
138
|
+
- **Pacotes npm novos** (todos em `dashboard/package.json`, não no root):
|
|
139
|
+
- `fastify`, `@fastify/static`, `@fastify/cors`
|
|
140
|
+
- `better-sqlite3` (já é devDep no root — duplicado no dashboard)
|
|
141
|
+
- Front: `vite`, `react`, `react-dom`, `react-router-dom`, `tailwindcss`, `recharts`
|
|
142
|
+
- shadcn/ui via CLI (copy-paste, não vira dep)
|
|
143
|
+
- **Migrações de memória**: nenhuma — `projects`, `memory_nodes`, `handoffs` já existem em `universal.db`
|
|
144
|
+
|
|
145
|
+
## 7. Rollout
|
|
146
|
+
|
|
147
|
+
- [x] Feature flag: não — `npm run dashboard` é opt-in por natureza
|
|
148
|
+
- [x] Migração de dados: não
|
|
149
|
+
- [ ] Doc/persona: criar `docs/dashboard.md`, linkar em `DOC-MAP.md`; mencionar em `docs/personas/developer/` como ferramenta visual
|
|
150
|
+
|
|
151
|
+
## 8. Sinais de fracasso (kill criteria)
|
|
152
|
+
|
|
153
|
+
Abandonar / refatorar profundamente se:
|
|
154
|
+
- Allowlist for desviada via injection (qualquer comando fora dela conseguir rodar)
|
|
155
|
+
- Polling 30s × 10 projetos passar de 500ms p95 em `/api/tokens` — estimativa por leitura de arquivos não escala
|
|
156
|
+
- Briefing heurístico produzir spec reescrita 100% em > 80% dos casos — sinal de que precisa LLM
|
|
157
|
+
- Dashboard aberto < 1×/semana após 30d — leitura ASCII era suficiente
|
|
158
|
+
|
|
159
|
+
## Próximo handoff
|
|
160
|
+
SDD Architect → Product (revisar plan) → SDD Architect (gerar `tasks.md`) → Worker (impl).
|
|
161
|
+
Quando este plan for aprovado, rodar:
|
|
162
|
+
```bash
|
|
163
|
+
node scripts/spec-cli.mjs tasks agent-dashboard
|
|
164
|
+
node scripts/agent-router.mjs done 2
|
|
165
|
+
```
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# Spec: agent-dashboard
|
|
2
|
+
|
|
3
|
+
- **ID**: SPEC-002
|
|
4
|
+
- **Status**: implementing
|
|
5
|
+
- **Owner**: apk
|
|
6
|
+
- **Criado em**: 2026-05-11
|
|
7
|
+
- **Sprint alvo**: refator-2026-05 (próximo após SPEC-001)
|
|
8
|
+
- **ADRs relacionadas**: ADR-0002 (SQLite/FTS5), ADR-0005 (handoff 7 campos), ADR-0008 (sub-agents)
|
|
9
|
+
|
|
10
|
+
## 1. Problema
|
|
11
|
+
|
|
12
|
+
Hoje só dá pra acompanhar o framework pelo terminal: `agent-router list`, `spec:check`, ler `60-runs/` na unha. Resultado:
|
|
13
|
+
|
|
14
|
+
- **Visibilidade**: difícil ver de relance o estado dos 10 projetos em `projects/` — quantas specs ativas, handoffs travados, sprint em curso, sem rodar 3-4 comandos.
|
|
15
|
+
- **Custo invisível**: smart-context economiza tokens (40-60%, ADR-0003), mas não há gráfico de consumo ao longo do tempo. Não dá pra responder "qual projeto come mais token?".
|
|
16
|
+
- **Onboarding de feature novo**: começar uma feature exige saber a CLI inteira (`spec:new`, mexer em `vision.md`, rodar `sync:universal`). Para o próprio autor é OK; para qualquer outro humano é fricção.
|
|
17
|
+
- **Briefing perdido**: quando uma feature nasce de uma conversa, o "porquê" original some entre WhatsApp/Notion/cabeça. Falta um ponto de captura inicial que vire `spec.md` direito.
|
|
18
|
+
|
|
19
|
+
## 2. Proposta de valor
|
|
20
|
+
|
|
21
|
+
Um painel web local (`npm run dashboard`) que: **(a)** mostra estado de specs/handoffs/tokens em tempo quase-real, **(b)** permite iniciar uma feature a partir de um briefing em texto livre que vira `spec.md`, e **(c)** dispara os comandos principais do framework com 1 clique. CLI continua canônica — a UI é leitura + atalho de entrada.
|
|
22
|
+
|
|
23
|
+
## 3. User stories
|
|
24
|
+
|
|
25
|
+
- **Como** autor do framework, **quero** ver num gráfico quanto cada projeto consumiu de tokens nos últimos 30 dias, **para que** eu decida onde investir compressão/cache.
|
|
26
|
+
- **Como** Product Agent, **quero** colar um briefing em texto livre e receber um rascunho de `spec.md` pré-preenchido, **para que** eu salte a página em branco.
|
|
27
|
+
- **Como** Orchestrator, **quero** ver handoffs abertos em kanban (open / in_progress / done), **para que** eu detecte gargalo (ex: 4 handoffs parados em `sdd-architect`).
|
|
28
|
+
- **Como** dev de outro projeto, **quero** botões para `spec:check`, `sync:universal` e `memory:vacuum`, **para que** eu não precise memorizar a CLI.
|
|
29
|
+
- **Como** Governance Agent, **quero** ver quais features estão em `implementing` sem ADR referenciada no plan, **para que** eu bloqueie a tempo.
|
|
30
|
+
|
|
31
|
+
## 4. Critérios de aceite
|
|
32
|
+
|
|
33
|
+
- [x] **AC-1**: `npm run dashboard` sobe servidor local (Vite ou Express estático) em `localhost:<porta>` e abre o browser
|
|
34
|
+
- [x] **AC-2**: Tela "Specs" lista todas as features de `specs/<slug>/` com status colorido (draft/review/approved/implementing/done/abandoned) e link para spec.md/plan.md/tasks.md
|
|
35
|
+
- [x] **AC-3**: Tela "Handoffs" mostra 3 colunas (open / in_progress / done) lidas de `universal.db.handoffs`; permite marcar como `done` ou `in_progress` via botão (chama `agent-router`)
|
|
36
|
+
- [x] **AC-4**: Tela "Tokens" mostra gráfico (linha) de tokens estimados por dia nos últimos 30d, agregado por projeto, lido de `memory_nodes` + `60-runs/`
|
|
37
|
+
- [x] **AC-5**: Tela "Novo briefing" tem um `<textarea>` ≥10 linhas + select de projeto-alvo. Botão "Gerar spec" envia o texto para um endpoint que: (a) cria `specs/<slug>/` via `spec-cli.mjs new`, (b) pré-preenche seções 1-3 (Problema/Valor/User stories) com o briefing em prosa estruturada, (c) deixa o status em `draft` para o usuário revisar
|
|
38
|
+
- [x] **AC-6**: Tela "Comandos" tem botões para: `spec:check`, `sync:universal`, `memory:vacuum`, `project:check`, `sprint:status` — cada um abre painel lateral com stdout/stderr em tempo real
|
|
39
|
+
- [x] **AC-7**: Tela "Projetos" lista `projects/*` com badges (specs ativas, handoffs abertos, último commit, tamanho da memória)
|
|
40
|
+
- [x] **AC-8**: Polling de 30s atualiza dados sem refresh manual
|
|
41
|
+
- [x] **AC-9**: Acessível somente a `localhost` (binding em `127.0.0.1`), sem auth; documentado como "ferramenta de dev local"
|
|
42
|
+
- [x] **AC-10**: `npm run dashboard` funciona sem instalar nada além de `npm install` no repo
|
|
43
|
+
|
|
44
|
+
## 5. Escopo
|
|
45
|
+
|
|
46
|
+
**Dentro**:
|
|
47
|
+
- Backend Express/Fastify minimalista (1 arquivo, lê SQLite e fs)
|
|
48
|
+
- Frontend Vite + React + shadcn/ui (ou alternativa mais leve se justificada no plan)
|
|
49
|
+
- 5 telas: Specs, Handoffs, Tokens, Briefing, Comandos, Projetos
|
|
50
|
+
- Polling simples (30s) — sem WebSocket
|
|
51
|
+
- "Pré-preenchimento" de spec via heurística simples (regex/keywords no briefing) — sem LLM nesta primeira versão
|
|
52
|
+
- Cores e estados ligados a ADR-0007 (status SDD) e ADR-0008 (status handoff)
|
|
53
|
+
|
|
54
|
+
**Fora** (explícito, evita scope creep):
|
|
55
|
+
- Edição livre de spec.md/plan.md/tasks.md pela UI (só status via comando)
|
|
56
|
+
- Pré-preenchimento via LLM real (Anthropic/OpenAI API) — fica para v2
|
|
57
|
+
- ~~WebSocket / SSE / push em tempo real~~ — **revisado 2026-05-11: SSE de eventos adicionado para que toda ação da UI exiba o comando executando ao vivo**
|
|
58
|
+
- WebSocket bidirecional (mantém SSE simples)
|
|
59
|
+
- Auth, multi-usuário, deploy remoto
|
|
60
|
+
- Custo real consumido na API Anthropic (depende de plumbing extra)
|
|
61
|
+
- Mobile / responsive sério (desktop-first; degrada graciosamente)
|
|
62
|
+
- Dark mode toggle (segue OS, sem switch)
|
|
63
|
+
- i18n (pt-BR fixo)
|
|
64
|
+
|
|
65
|
+
## 6. NFRs / restrições
|
|
66
|
+
|
|
67
|
+
- **Performance**: primeira pintura < 1s em localhost; polling não pode passar de 200ms na rota mais pesada (tokens)
|
|
68
|
+
- **Segurança**: bind em `127.0.0.1` apenas; nunca expõe a rede; endpoints que invocam scripts (Comandos, Briefing) precisam allowlist explícita — `npm` arbitrário NÃO
|
|
69
|
+
- **Compatibilidade**: não quebra nenhum script npm existente; CLI continua sendo a fonte da verdade
|
|
70
|
+
- **Observabilidade**: cada ação que dispara comando loga em `60-runs/dashboard-<ts>.json`
|
|
71
|
+
- **Dependências**: zero novas runtime deps no kit base (só dev). Frontend isolado em `dashboard/` com seu próprio `package.json`
|
|
72
|
+
- **Tamanho do bundle**: front com menos de 500KB gzipped
|
|
73
|
+
|
|
74
|
+
## 7. Riscos e mitigação
|
|
75
|
+
|
|
76
|
+
| Risco | P | I | Mitigação |
|
|
77
|
+
|---|---|---|---|
|
|
78
|
+
| Dashboard vira "fonte da verdade" e dessincroniza com CLI | M | A | Read-only em 95% das telas; mutações sempre via shell-out para o script CLI canônico |
|
|
79
|
+
| Endpoint de comandos vira RCE local | B | A | Allowlist hard-coded de scripts permitidos; sem `npm run <arbitrário>` |
|
|
80
|
+
| Gráfico de tokens mente (estimativa ≠ real) | A | M | Rotular como "estimativa baseada em chars/4"; documentar fórmula |
|
|
81
|
+
| Briefing → spec produz texto ruim | A | M | Marcar status `draft` e exigir revisão humana antes de mudar pra `review` |
|
|
82
|
+
| Adicionar bundle JS pesado complica o repo | M | M | Frontend em pasta isolada; CI roda `npm test` no kit sem precisar buildar dashboard |
|
|
83
|
+
|
|
84
|
+
## 8. Métricas de sucesso (30d)
|
|
85
|
+
|
|
86
|
+
- Autor abre o dashboard ≥3×/semana
|
|
87
|
+
- ≥1 spec criada via briefing (versus 100% via CLI hoje)
|
|
88
|
+
- 0 incidentes de comando executado fora da allowlist
|
|
89
|
+
- Tempo médio "abriu dashboard → identificou gargalo" < 60s
|