@mcp-graph-workflow/mcp-graph 5.27.0 → 5.28.0

package/dist/core/config/reference-content.js

@@ -0,0 +1,449 @@
+/**
+ * Reference content extracted from ai-memory-generator.ts.
+ * Shared between the generator (full mode) and the help MCP tool (on-demand).
+ */
+export const TOOL_TABLE_FULL = `### Ferramentas MCP disponíveis (46 tools + 6 deprecated)
+
+#### Projeto & Grafo
+
+| Tool | Quando usar |
+|------|-------------|
+| \`init\` | Inicializar grafo do projeto (cria DB, AI memory files, detecta MCPs) |
+| \`list\` | Listar nodes do grafo (filtrar por tipo/status/parent) |
+| \`show\` | Ver detalhes de um node específico (metadata, deps, knowledge) |
+| \`search\` | Busca full-text no grafo (FTS5 + BM25 ranking) |
+| \`export\` | Exportar grafo (JSON completo ou Mermaid diagram) |
+| \`snapshot\` | Criar/restaurar snapshots do grafo (backup/rollback) |
+| \`metrics\` | Estatísticas do grafo (\`stats\`) ou velocidade por sprint (\`velocity\`) |
+
+#### Nodes & Edges
+
+| Tool | Quando usar |
+|------|-------------|
+| \`node\` | CRUD de nodes: action \`add\` (criar), \`update\` (atualizar), \`delete\` (remover) |
+| \`move_node\` | Mover node para outro parent |
+| \`clone_node\` | Clonar node com filhos (deep copy) |
+| \`edge\` | Criar/remover relações entre nodes (depends_on, blocks, related_to) |
+| \`update_status\` | Mudar status de um node (backlog→ready→in_progress→done) |
+| \`bulk_update_status\` | Atualizar status de múltiplos nodes de uma vez |
+
+#### PRD & Planejamento
+
+| Tool | Quando usar |
+|------|-------------|
+| \`import_prd\` | Importar PRD → segmentar → classificar → extrair → inferir deps → criar grafo + indexar knowledge |
+| \`plan_sprint\` | Gerar relatório de planejamento de sprint (capacity, velocity, recomendações) |
+| \`analyze\` | 24 modos de análise por fase do lifecycle (ver modos abaixo) |
+| \`set_phase\` | Forçar/resetar fase do lifecycle (strict/advisory, gate checks) + Code Intelligence mode (strict/advisory/off) + Tool Prerequisites mode (strict/advisory/off) |
+
+#### Contexto & RAG
+
+| Tool | Quando usar |
+|------|-------------|
+| \`next\` | Próxima task recomendada (prioridade + deps + knowledge coverage 0-1 + TDD hints + velocity) |
+| \`context\` | Contexto comprimido da task (token-efficient, ~73% redução) |
+| \`rag_context\` | Contexto RAG phase-aware (tiers: summary/standard/deep, budget 60/30/10) |
+| \`reindex_knowledge\` | Rebuild completo do índice de knowledge (BM25 + TF-IDF) |
+| \`sync_stack_docs\` | Sincronizar docs das libs do projeto via Context7 |
+
+#### Memórias do Projeto
+
+| Tool | Quando usar |
+|------|-------------|
+| \`write_memory\` | Escrever memória em workflow-graph/memories/{name}.md (auto-indexa no RAG) |
+| \`read_memory\` | Ler conteúdo de uma memória específica |
+| \`list_memories\` | Listar todas as memórias disponíveis |
+| \`delete_memory\` | Remover memória do filesystem e do knowledge store |
+
+#### Validação
+
+| Tool | Quando usar |
+|------|-------------|
+| \`validate\` | Validação: action \`task\` (browser A/B com Playwright) ou \`ac\` (critérios de aceitação) |
+
+#### Skills
+
+| Tool | Quando usar |
+|------|-------------|
+| \`manage_skill\` | Gerenciar skills: action \`list\` (listar/filtrar por fase), \`enable\`/\`disable\`, CRUD de custom skills |
+
+#### Utilitários
+
+| Tool | Quando usar |
+|------|-------------|
+| \`help\` | Referência on-demand de tools, analyze modes, skills, CLI, workflow (este tool) |
+| \`journey\` | Gerenciar journey maps de websites (list, get, search, index para RAG) |
+| \`import_graph\` | Importar/merge grafo JSON exportado (local wins, dry_run disponível) |
+
+#### Code Intelligence (LSP)
+
+| Tool | Quando usar |
+|------|-------------|
+| \`code_intelligence\` | Análise semântica via LSP: definition, references, hover, rename, call_hierarchy, diagnostics, symbols. Multi-language (TS, Python, Rust, Go, Java, C/C++, Ruby, PHP, Kotlin, Swift, C#, Lua) |
+
+#### Knowledge Avançado
+
+| Tool | Quando usar |
+|------|-------------|
+| \`knowledge_feedback\` | Feedback em docs do knowledge store (helpful/unhelpful/outdated) para melhorar RAG |
+| \`knowledge_stats\` | Estatísticas do knowledge store: contagem por source, qualidade, docs mais acessados |
+| \`export_knowledge\` | Export/import/preview de knowledge packages para colaboração entre projetos |
+
+#### Siebel CRM (8 tools)
+
+| Tool | Quando usar |
+|------|-------------|
+| \`siebel_import_sif\` | Importar .SIF (XML Siebel) — parse, extrai objetos, mapeia no grafo, indexa no knowledge |
+| \`siebel_analyze\` | Analisar objetos Siebel: impact, dependencies, circular, diff, refactor_script, troubleshoot |
+| \`siebel_composer\` | Automação do Siebel Composer via Playwright: navigate, import_sif, edit, publish, capture |
+| \`siebel_env\` | Gerenciar ambientes Siebel CRM: list, add, remove |
+| \`siebel_validate\` | Validar .SIF: full, naming, security, performance, migration_ready, code_review |
+| \`siebel_search\` | Buscar objetos Siebel indexados no knowledge store (BCs, Applets, Views, Workflows) |
+| \`siebel_generate_sif\` | Gerar SIF: prepare, finalize, templates, scaffold, clone_adapt, auto_wire, wsdl_to_sif |
+| \`siebel_import_docs\` | Importar docs (Swagger/WSDL/PDF/HTML/DOCX/MD) no knowledge store para contexto Siebel |
+
+#### Translation (3 tools)
+
+| Tool | Quando usar |
+|------|-------------|
+| \`translate_code\` | Traduzir código entre linguagens — cria job, analisa constructs, gera prompt, finaliza com código |
+| \`analyze_translation\` | Analisar código-fonte para prontidão de tradução (language, constructs, complexity, translatability) |
+| \`translation_jobs\` | Gerenciar jobs de tradução: list, get, delete, stats |`;
+export const DEPRECATED_TOOLS_SECTION = `#### Tools Deprecated (backward compat, removidos na v7.0)
+
+| Tool antigo | Usar no lugar |
+|-------------|---------------|
+| \`add_node\` | \`node\` com action:\`add\` |
+| \`update_node\` | \`node\` com action:\`update\` |
+| \`delete_node\` | \`node\` com action:\`delete\` |
+| \`validate_task\` | \`validate\` com action:\`task\` |
+| \`validate_ac\` | \`validate\` com action:\`ac\` |
+| \`list_skills\` | \`manage_skill\` com action:\`list\` |`;
+export const ANALYZE_MODES_SECTION = `### Modos do analyze por fase
+
+| Fase | Modo | O que verifica |
+|------|------|----------------|
+| ANALYZE | \`prd_quality\` | Qualidade do PRD (completude, user stories, AC) |
+| ANALYZE | \`scope\` | Escopo do grafo (tipos, distribuição, cobertura) |
+| ANALYZE | \`ready\` | Definition of Ready (bloqueios, dependências, AC) |
+| ANALYZE | \`risk\` | Riscos (complexidade, deps, tamanho, AC faltantes) |
+| ANALYZE | \`blockers\` | Bloqueios transitivos de um node |
+| ANALYZE | \`cycles\` | Ciclos de dependência no grafo |
+| ANALYZE | \`critical_path\` | Caminho crítico (sequência mais longa de deps) |
+| PLAN | \`decompose\` | Tasks grandes que precisam ser decompostas |
+| DESIGN | \`adr\` | Validação de ADRs (Architecture Decision Records) |
+| DESIGN | \`traceability\` | Matriz de rastreabilidade (req → task → test) |
+| DESIGN | \`coupling\` | Acoplamento entre módulos |
+| DESIGN | \`interfaces\` | Verificação de interfaces e contratos |
+| DESIGN | \`tech_risk\` | Riscos técnicos (complexidade, stack, deps externas) |
+| DESIGN | \`design_ready\` | Gate DESIGN→PLAN (pré-requisitos atendidos?) |
+| IMPLEMENT | \`implement_done\` | Definition of Done (8 checks: 4 required + 4 recommended) |
+| IMPLEMENT | \`tdd_check\` | Aderência TDD (specs sugeridos por AC) |
+| IMPLEMENT | \`progress\` | Sprint burndown + velocity trend + blockers + ETA |
+| VALIDATE | \`validate_ready\` | Gate IMPLEMENT→VALIDATE |
+| VALIDATE | \`done_integrity\` | Integridade dos nodes marcados done |
+| VALIDATE | \`status_flow\` | Fluxo de status válido (sem pulos) |
+| REVIEW | \`review_ready\` | Gate VALIDATE→REVIEW |
+| HANDOFF | \`handoff_ready\` | Gate REVIEW→HANDOFF |
+| HANDOFF | \`doc_completeness\` | Completude de documentação |
+| DEPLOY | \`deploy_ready\` | Gate HANDOFF→DEPLOY (snapshot, tasks done, no blocked) |
+| DEPLOY | \`release_check\` | Validação de release readiness |
+| LISTENING | \`listening_ready\` | Gate DEPLOY→LISTENING |
+| LISTENING | \`backlog_health\` | Saúde do backlog (distribuição, aging) |`;
+export const KNOWLEDGE_PIPELINE_SECTION = `### Pipeline de Conhecimento (Knowledge Store + RAG)
+
+Fontes indexadas automaticamente:
+- **Project memories** — ao escrever com \`write_memory\` (auto-indexa)
+- **PRD imports** — ao importar com \`import_prd\`
+- **Browser captures** — ao validar com \`validate_task\`
+- **Stack docs** — ao sincronizar com \`sync_stack_docs\`
+- **Sprint reports** — ao gerar com \`plan_sprint\`
+
+Recuperação: \`rag_context\` monta contexto phase-aware com budget de tokens:
+- 60% contexto do grafo (nodes, deps, status)
+- 30% knowledge store (BM25 + TF-IDF)
+- 10% metadata de fase
+
+Manual: \`reindex_knowledge\` para rebuild completo do índice.`;
+export const SKILLS_SECTION = `### Skills Built-in (40 skills)
+
+40 skills mapeadas às fases do lifecycle. Use \`list_skills\` para descobrir por fase ou ver instruções completas.
+
+#### Skills por fase
+
+| Fase | Skills sugeridas |
+|------|-----------------|
+| ANALYZE | \`create-prd-chat-mode\`, \`business-analyst\`, \`product-manager\` |
+| DESIGN | \`breakdown-epic-arch\`, \`context-architect\`, \`backend-architect\` |
+| PLAN | \`breakdown-feature-prd\`, \`track-with-mcp-graph\` |
+| IMPLEMENT | \`subagent-driven-development\`, \`xp-bootstrap\`, \`self-healing-awareness\` |
+| VALIDATE | \`playwright-explore-website\`, \`playwright-generate-test\`, \`e2e-testing\` |
+| REVIEW | \`code-reviewer\`, \`code-review-checklist\`, \`review-and-refactor\`, \`observability-engineer\` |
+
+#### Categorias adicionais (multi-fase)
+
+| Categoria | Skills |
+|-----------|--------|
+| software-design | SOLID, KISS, YAGNI, DRY, clean-architecture, composition-over-inheritance |
+| security | \`owasp-web-security\`, \`auth-and-secrets\`, \`database-and-deps-security\` |
+| ddd | \`domain-driven-design\` (DESIGN, PLAN) |
+| testing | \`comprehensive-testing-reference\`, \`self-healing-awareness\` (IMPLEMENT, VALIDATE) |
+| cost-reducer | \`cloud-infra-cost\`, \`code-level-savings\`, \`finops-services\` (DESIGN, REVIEW) |
+| frontend-design | \`ui-ux-patterns\` (DESIGN, IMPLEMENT) |
+
+#### Custom Skills
+
+Crie skills específicas do projeto via \`manage_skill\` (create/enable/disable). Custom skills são armazenadas no grafo e aparecem junto com as built-in em \`list_skills\`.
+
+#### Self-Healing Awareness
+
+A skill \`self-healing-awareness\` monitora padrões de erro recorrentes e sugere correções automaticamente. Ativa nas fases IMPLEMENT e VALIDATE.`;
+export const CLI_COMMANDS = `### Comandos essenciais
+
+\`\`\`bash
+npx mcp-graph stats            # Estatísticas do grafo
+npx mcp-graph list             # Listar nodes
+npx mcp-graph update           # Atualizar configs para última versão
+npx mcp-graph doctor           # Validar ambiente de execução
+npx mcp-graph doctor --json    # Diagnóstico em JSON estruturado
+npx mcp-graph serve --port 3000  # Dashboard visual
+\`\`\``;
+// ── Phase-to-tools mapping ──────────────────────────
+const PHASE_TOOLS = {
+    ANALYZE: [
+        "import_prd",
+        "node",
+        "analyze",
+        "validate",
+        "search",
+        "list",
+        "show",
+        "help",
+        "knowledge_stats",
+    ],
+    DESIGN: [
+        "node",
+        "edge",
+        "analyze",
+        "export",
+        "search",
+        "show",
+        "help",
+        "code_intelligence",
+        "siebel_analyze",
+        "siebel_import_sif",
+        "analyze_translation",
+    ],
+    PLAN: [
+        "plan_sprint",
+        "analyze",
+        "sync_stack_docs",
+        "edge",
+        "node",
+        "search",
+        "help",
+        "import_graph",
+    ],
+    IMPLEMENT: [
+        "next",
+        "context",
+        "rag_context",
+        "update_status",
+        "analyze",
+        "validate",
+        "write_memory",
+        "read_memory",
+        "help",
+        "code_intelligence",
+        "translate_code",
+        "siebel_generate_sif",
+        "siebel_composer",
+        "journey",
+    ],
+    VALIDATE: [
+        "validate",
+        "metrics",
+        "analyze",
+        "export",
+        "next",
+        "update_status",
+        "help",
+        "siebel_validate",
+        "knowledge_feedback",
+    ],
+    REVIEW: [
+        "export",
+        "metrics",
+        "analyze",
+        "search",
+        "show",
+        "help",
+        "code_intelligence",
+        "knowledge_stats",
+        "export_knowledge",
+    ],
+    HANDOFF: [
+        "export",
+        "snapshot",
+        "analyze",
+        "write_memory",
+        "help",
+        "export_knowledge",
+        "translation_jobs",
+    ],
+    DEPLOY: [
+        "export",
+        "snapshot",
+        "analyze",
+        "metrics",
+        "write_memory",
+        "help",
+    ],
+    LISTENING: [
+        "node",
+        "import_prd",
+        "analyze",
+        "search",
+        "list",
+        "help",
+        "knowledge_stats",
+        "import_graph",
+    ],
+};
+// ── Phase-to-analyze-modes mapping ──────────────────
+const PHASE_ANALYZE_MODES = {
+    ANALYZE: [
+        "prd_quality",
+        "scope",
+        "ready",
+        "risk",
+        "blockers",
+        "cycles",
+        "critical_path",
+    ],
+    PLAN: ["decompose"],
+    DESIGN: [
+        "adr",
+        "traceability",
+        "coupling",
+        "interfaces",
+        "tech_risk",
+        "design_ready",
+    ],
+    IMPLEMENT: ["implement_done", "tdd_check", "progress"],
+    VALIDATE: ["validate_ready", "done_integrity", "status_flow"],
+    REVIEW: ["review_ready"],
+    HANDOFF: ["handoff_ready", "doc_completeness"],
+    DEPLOY: ["deploy_ready", "release_check"],
+    LISTENING: ["listening_ready", "backlog_health"],
+};
+// ── Phase-to-skills mapping ─────────────────────────
+const PHASE_SKILLS = {
+    ANALYZE: ["create-prd-chat-mode", "business-analyst", "product-manager"],
+    DESIGN: ["breakdown-epic-arch", "context-architect", "backend-architect"],
+    PLAN: ["breakdown-feature-prd", "track-with-mcp-graph"],
+    IMPLEMENT: [
+        "subagent-driven-development",
+        "xp-bootstrap",
+        "self-healing-awareness",
+    ],
+    VALIDATE: [
+        "playwright-explore-website",
+        "playwright-generate-test",
+        "e2e-testing",
+    ],
+    REVIEW: [
+        "code-reviewer",
+        "code-review-checklist",
+        "review-and-refactor",
+        "observability-engineer",
+    ],
+    DEPLOY: [
+        "deployment-engineer",
+        "devops-deploy",
+        "git-pushing",
+    ],
+};
+// ── Getter functions ────────────────────────────────
+/**
+ * Get tool reference, optionally filtered by lifecycle phase.
+ */
+export function getToolReference(phase) {
+    if (!phase)
+        return TOOL_TABLE_FULL;
+    const upper = phase.toUpperCase();
+    const tools = PHASE_TOOLS[upper];
+    if (!tools)
+        return TOOL_TABLE_FULL;
+    const lines = TOOL_TABLE_FULL.split("\n");
+    const filtered = lines.filter((line) => {
+        if (line.startsWith("#") || line.startsWith("|--") || line.trim() === "")
+            return true;
+        if (line.startsWith("| Tool") || line.startsWith("| `")) {
+            if (line.startsWith("| Tool"))
+                return true;
+            return tools.some((tool) => line.includes(`\`${tool}\``));
+        }
+        return true;
+    });
+    return `### Tools recomendadas para fase ${upper}\n\n${filtered.join("\n")}`;
+}
+/**
+ * Get analyze modes, optionally filtered by lifecycle phase.
+ */
+export function getAnalyzeModes(phase) {
+    if (!phase)
+        return ANALYZE_MODES_SECTION;
+    const upper = phase.toUpperCase();
+    const modes = PHASE_ANALYZE_MODES[upper];
+    if (!modes)
+        return ANALYZE_MODES_SECTION;
+    const lines = ANALYZE_MODES_SECTION.split("\n");
+    const filtered = lines.filter((line) => {
+        if (line.startsWith("#") ||
+            line.startsWith("|--") ||
+            line.startsWith("| Fase") ||
+            line.trim() === "")
+            return true;
+        return modes.some((mode) => line.includes(`\`${mode}\``));
+    });
+    return `### Modos analyze para fase ${upper}\n\n${filtered.join("\n")}`;
+}
+/**
+ * Get skills by lifecycle phase.
+ */
+export function getSkillsByPhase(phase) {
+    if (!phase)
+        return SKILLS_SECTION;
+    const upper = phase.toUpperCase();
+    const skills = PHASE_SKILLS[upper];
+    if (!skills)
+        return `### Skills para fase ${upper}\n\nNenhuma skill específica mapeada. Use \`manage_skill(list)\` para ver todas.`;
+    return `### Skills para fase ${upper}\n\n${skills.map((s) => `- \`${s}\``).join("\n")}`;
+}
+/**
+ * Get CLI commands reference.
+ */
+export function getCliCommands() {
+    return CLI_COMMANDS;
+}
+/**
+ * Get knowledge pipeline documentation.
+ */
+export function getKnowledgePipeline() {
+    return KNOWLEDGE_PIPELINE_SECTION;
+}
+/**
+ * Get all reference content combined.
+ */
+export function getFullReference() {
+    return [
+        TOOL_TABLE_FULL,
+        DEPRECATED_TOOLS_SECTION,
+        ANALYZE_MODES_SECTION,
+        KNOWLEDGE_PIPELINE_SECTION,
+        SKILLS_SECTION,
+        CLI_COMMANDS,
+    ].join("\n\n");
+}
+//# sourceMappingURL=reference-content.js.map

package/dist/core/config/reference-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-content.js","sourceRoot":"","sources":["../../../src/core/config/reference-content.ts"],"names":[],"mappings":"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"}

package/dist/core/deployer/deploy-readiness.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Deploy Readiness — composite gate for HANDOFF→DEPLOY transition.
+ * Validates that the project is ready for release/deployment.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { DeployReadinessReport } from "../../schemas/deployer-schema.js";
+export interface DeployReadinessOptions {
+    hasSnapshots?: boolean;
+    knowledgeCount?: number;
+}
+export declare function checkDeployReadiness(doc: GraphDocument, opts?: DeployReadinessOptions): DeployReadinessReport;
+//# sourceMappingURL=deploy-readiness.d.ts.map

package/dist/core/deployer/deploy-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-readiness.d.ts","sourceRoot":"","sources":["../../../src/core/deployer/deploy-readiness.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAwB,MAAM,kCAAkC,CAAC;AAOpG,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,aAAa,EAClB,IAAI,CAAC,EAAE,sBAAsB,GAC5B,qBAAqB,CA0GvB"}

package/dist/core/deployer/deploy-readiness.js

@@ -0,0 +1,102 @@
+/**
+ * Deploy Readiness — composite gate for HANDOFF→DEPLOY transition.
+ * Validates that the project is ready for release/deployment.
+ */
+import { detectCycles } from "../planner/dependency-chain.js";
+import { scoreToGrade } from "../utils/grading.js";
+import { TASK_TYPES } from "../utils/node-type-sets.js";
+import { nodeHasAc } from "../utils/ac-helpers.js";
+import { logger } from "../utils/logger.js";
+export function checkDeployReadiness(doc, opts) {
+    const checks = [];
+    const tasks = doc.nodes.filter((n) => TASK_TYPES.has(n.type));
+    const doneTasks = tasks.filter((n) => n.status === "done");
+    // ── Required checks ──
+    // 1. all_tasks_done — 100% tasks done
+    const allDone = tasks.length > 0 && tasks.every((n) => n.status === "done");
+    checks.push({
+        name: "all_tasks_done",
+        passed: allDone,
+        details: allDone
+            ? "Todas tasks done"
+            : `${doneTasks.length}/${tasks.length} tasks done (100% requerido)`,
+        severity: "required",
+    });
+    // 2. no_blocked_nodes — zero nodes with status=blocked
+    const statusBlockedCount = doc.nodes.filter((n) => n.status === "blocked").length;
+    const noBlocked = statusBlockedCount === 0;
+    checks.push({
+        name: "no_blocked_nodes",
+        passed: noBlocked,
+        details: noBlocked
+            ? "Nenhum node bloqueado"
+            : `${statusBlockedCount} node(s) bloqueado(s)`,
+        severity: "required",
+    });
+    // 3. has_snapshot — snapshot must exist before deploying
+    const hasSnapshots = opts?.hasSnapshots ?? false;
+    checks.push({
+        name: "has_snapshot",
+        passed: hasSnapshots,
+        details: hasSnapshots
+            ? "Snapshot do grafo existe"
+            : "Nenhum snapshot encontrado — criar snapshot antes de deploy",
+        severity: "required",
+    });
+    // 4. no_cycles — no dependency cycles
+    const cycles = detectCycles(doc);
+    const noCycles = cycles.length === 0;
+    checks.push({
+        name: "no_cycles",
+        passed: noCycles,
+        details: noCycles
+            ? "Nenhum ciclo de dependência detectado"
+            : `${cycles.length} ciclo(s) detectado(s)`,
+        severity: "required",
+    });
+    // 5. no_in_progress — zero in_progress tasks
+    const inProgressTasks = tasks.filter((n) => n.status === "in_progress");
+    const noInProgress = inProgressTasks.length === 0;
+    checks.push({
+        name: "no_in_progress",
+        passed: noInProgress,
+        details: noInProgress
+            ? "Nenhuma task in_progress"
+            : `${inProgressTasks.length} task(s) ainda in_progress`,
+        severity: "required",
+    });
+    // ── Recommended checks ──
+    // 6. ac_coverage — ≥80% tasks with AC
+    const tasksWithAC = tasks.filter((t) => nodeHasAc(doc, t.id));
+    const acCoverage = tasks.length > 0 ? Math.round((tasksWithAC.length / tasks.length) * 100) : 0;
+    const acPass = acCoverage >= 80;
+    checks.push({
+        name: "ac_coverage",
+        passed: acPass,
+        details: `${acCoverage}% tasks com AC (meta: 80%)`,
+        severity: "recommended",
+    });
+    // 7. knowledge_captured — knowledge count > 0
+    const knowledgeCount = opts?.knowledgeCount ?? 0;
+    const knowledgePass = knowledgeCount > 0;
+    checks.push({
+        name: "knowledge_captured",
+        passed: knowledgePass,
+        details: knowledgePass
+            ? `${knowledgeCount} conhecimento(s) capturado(s)`
+            : "Nenhum conhecimento capturado no knowledge store",
+        severity: "recommended",
+    });
+    // ── Scoring ──
+    const totalChecks = checks.length;
+    const passedChecks = checks.filter((c) => c.passed).length;
+    const score = Math.round((passedChecks / totalChecks) * 100);
+    const grade = scoreToGrade(score);
+    const ready = checks.filter((c) => c.severity === "required").every((c) => c.passed);
+    const summary = ready
+        ? `Deploy Ready (${grade}): ${passedChecks}/${totalChecks} checks passed, score ${score}`
+        : `Deploy Not Ready: ${checks.filter((c) => c.severity === "required" && !c.passed).map((c) => c.name).join(", ")} failed`;
+    logger.info("deploy-readiness", { ready, score, grade, passed: passedChecks, total: totalChecks });
+    return { checks, ready, score, grade, summary };
+}
+//# sourceMappingURL=deploy-readiness.js.map

package/dist/core/deployer/deploy-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-readiness.js","sourceRoot":"","sources":["../../../src/core/deployer/deploy-readiness.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAO5C,MAAM,UAAU,oBAAoB,CAClC,GAAkB,EAClB,IAA6B;IAE7B,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAE3D,wBAAwB;IAExB,sCAAsC;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAC5E,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,OAAO;YACd,CAAC,CAAC,kBAAkB;YACpB,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,8BAA8B;QACrE,QAAQ,EAAE,UAAU;KACrB,CAAC,CAAC;IAEH,uDAAuD;IACvD,MAAM,kBAAkB,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAClF,MAAM,SAAS,GAAG,kBAAkB,KAAK,CAAC,CAAC;IAC3C,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,SAAS;YAChB,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,GAAG,kBAAkB,uBAAuB;QAChD,QAAQ,EAAE,UAAU;KACrB,CAAC,CAAC;IAEH,yDAAyD;IACzD,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,KAAK,CAAC;IACjD,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,YAAY;YACnB,CAAC,CAAC,0BAA0B;YAC5B,CAAC,CAAC,6DAA6D;QACjE,QAAQ,EAAE,UAAU;KACrB,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,QAAQ;YACf,CAAC,CAAC,uCAAuC;YACzC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,wBAAwB;QAC5C,QAAQ,EAAE,UAAU;KACrB,CAAC,CAAC;IAEH,6CAA6C;IAC7C,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,YAAY;YACnB,CAAC,CAAC,0BAA0B;YAC5B,CAAC,CAAC,GAAG,eAAe,CAAC,MAAM,4BAA4B;QACzD,QAAQ,EAAE,UAAU;KACrB,CAAC,CAAC;IAEH,2BAA2B;IAE3B,sCAAsC;IACtC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,MAAM,MAAM,GAAG,UAAU,IAAI,EAAE,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,GAAG,UAAU,4BAA4B;QAClD,QAAQ,EAAE,aAAa;KACxB,CAAC,CAAC;IAEH,8CAA8C;IAC9C,MAAM,cAAc,GAAG,IAAI,EAAE,cAAc,IAAI,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,cAAc,GAAG,CAAC,CAAC;IACzC,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,oBAAoB;QAC1B,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,aAAa;YACpB,CAAC,CAAC,GAAG,cAAc,+BAA+B;YAClD,CAAC,CAAC,kDAAkD;QACtD,QAAQ,EAAE,aAAa;KACxB,CAAC,CAAC;IAEH,gBAAgB;IAChB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAElC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAErF,MAAM,OAAO,GAAG,KAAK;QACnB,CAAC,CAAC,iBAAiB,KAAK,MAAM,YAAY,IAAI,WAAW,yBAAyB,KAAK,EAAE;QACzF,CAAC,CAAC,qBAAqB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;IAE7H,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAEnG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/dist/core/docs/doc-generator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Doc Generator — composes markdown sections from introspection data.
+ * Used by the auto-docs update step and the /docs API route.
+ */
+import type { ToolInfo } from "./tool-introspector.js";
+import type { RouteInfo } from "./route-introspector.js";
+/**
+ * Generate README stats table (tools, endpoints counts).
+ */
+export declare function generateReadmeStats(tools: ToolInfo[], routes: RouteInfo[]): string;
+/**
+ * Generate architecture guide MCP tools section.
+ */
+export declare function generateArchToolSection(tools: ToolInfo[]): string;
+/**
+ * Generate architecture guide REST API section.
+ */
+export declare function generateArchRouteSection(routes: RouteInfo[]): string;
+/**
+ * Generate MCP-TOOLS-REFERENCE.md summary header and table.
+ */
+export declare function generateToolRefSummary(tools: ToolInfo[]): string;
+//# sourceMappingURL=doc-generator.d.ts.map

package/dist/core/docs/doc-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-generator.d.ts","sourceRoot":"","sources":["../../../src/core/docs/doc-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CASlF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAgCjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAGpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAgChE"}