@mcp-graph-workflow/mcp-graph 5.2.0 → 5.4.0

package/dist/core/code/ts-analyzer.js

@@ -0,0 +1,331 @@
+/**
+ * TypeScript AST analyzer using ts.createSourceFile() (parse-only, no type checker).
+ * Extracts symbols and relations from TypeScript files syntactically.
+ * ~10-100x faster than ts.createProgram() with ~95% accuracy.
+ */
+import ts from "typescript";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { logger } from "../utils/logger.js";
+/**
+ * Analyze a single TypeScript file syntactically.
+ * Returns extracted symbols and relations with paths relative to basePath.
+ */
+export function analyzeFile(filePath, basePath) {
+    const content = readFileSync(filePath, "utf-8");
+    const relativePath = path.relative(basePath, filePath);
+    const sourceFile = ts.createSourceFile(relativePath, content, ts.ScriptTarget.Latest, true, // setParentNodes
+    ts.ScriptKind.TS);
+    const symbols = [];
+    const relations = [];
+    // Track imports for call resolution: localName → { modulePath, importedName }
+    const importMap = new Map();
+    // First pass: collect imports
+    collectImports(sourceFile, importMap);
+    // Second pass: extract symbols and relations
+    visitNode(sourceFile, sourceFile, relativePath, symbols, relations, importMap, null);
+    logger.debug("ts-analyzer:file", {
+        file: relativePath,
+        symbols: symbols.length,
+        relations: relations.length,
+    });
+    return { file: relativePath, symbols, relations };
+}
+// ── Import Collection ────────────────────────────────
+function collectImports(sourceFile, importMap) {
+    for (const stmt of sourceFile.statements) {
+        if (!ts.isImportDeclaration(stmt))
+            continue;
+        if (!stmt.moduleSpecifier || !ts.isStringLiteral(stmt.moduleSpecifier))
+            continue;
+        const modulePath = stmt.moduleSpecifier.text;
+        const clause = stmt.importClause;
+        if (!clause)
+            continue;
+        // Default import
+        if (clause.name) {
+            importMap.set(clause.name.text, { modulePath, importedName: "default" });
+        }
+        // Named imports: import { a, b as c } from '...'
+        if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) {
+            for (const specifier of clause.namedBindings.elements) {
+                const localName = specifier.name.text;
+                const importedName = specifier.propertyName?.text ?? localName;
+                importMap.set(localName, { modulePath, importedName });
+            }
+        }
+        // Namespace import: import * as ns from '...'
+        if (clause.namedBindings && ts.isNamespaceImport(clause.namedBindings)) {
+            importMap.set(clause.namedBindings.name.text, { modulePath, importedName: "*" });
+        }
+    }
+}
+// ── AST Visitor ──────────────────────────────────────
+function visitNode(node, sourceFile, file, symbols, relations, importMap, currentClass) {
+    // Function declarations
+    if (ts.isFunctionDeclaration(node) && node.name) {
+        const name = node.name.text;
+        const { line: startLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getStart());
+        const { line: endLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getEnd());
+        symbols.push({
+            name,
+            kind: "function",
+            file,
+            startLine: startLine + 1,
+            endLine: endLine + 1,
+            exported: hasExportModifier(node),
+            signature: extractSignature(node, sourceFile),
+        });
+        // Scan function body for calls
+        if (node.body) {
+            collectCalls(node.body, sourceFile, file, name, relations, importMap);
+        }
+    }
+    // Class declarations
+    if (ts.isClassDeclaration(node) && node.name) {
+        const className = node.name.text;
+        const { line: startLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getStart());
+        const { line: endLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getEnd());
+        symbols.push({
+            name: className,
+            kind: "class",
+            file,
+            startLine: startLine + 1,
+            endLine: endLine + 1,
+            exported: hasExportModifier(node),
+        });
+        // Heritage clauses: extends / implements
+        if (node.heritageClauses) {
+            for (const clause of node.heritageClauses) {
+                const relType = clause.token === ts.SyntaxKind.ExtendsKeyword ? "extends" : "implements";
+                for (const typeExpr of clause.types) {
+                    const baseName = typeExpr.expression.getText(sourceFile);
+                    relations.push({
+                        fromSymbol: className,
+                        toSymbol: baseName,
+                        type: relType,
+                        file,
+                        line: ts.getLineAndCharacterOfPosition(sourceFile, typeExpr.getStart()).line + 1,
+                    });
+                }
+            }
+        }
+        // Visit class members
+        for (const member of node.members) {
+            if (ts.isMethodDeclaration(member) && member.name) {
+                const methodName = member.name.getText(sourceFile);
+                const { line: mStartLine } = ts.getLineAndCharacterOfPosition(sourceFile, member.getStart());
+                const { line: mEndLine } = ts.getLineAndCharacterOfPosition(sourceFile, member.getEnd());
+                symbols.push({
+                    name: methodName,
+                    kind: "method",
+                    file,
+                    startLine: mStartLine + 1,
+                    endLine: mEndLine + 1,
+                    exported: false,
+                    signature: extractSignature(member, sourceFile),
+                });
+                relations.push({
+                    fromSymbol: methodName,
+                    toSymbol: className,
+                    type: "belongs_to",
+                    file,
+                    line: mStartLine + 1,
+                });
+                // Scan method body for calls
+                if (member.body) {
+                    collectCalls(member.body, sourceFile, file, methodName, relations, importMap);
+                }
+            }
+            if (ts.isConstructorDeclaration(member) && member.body) {
+                const { line: cStartLine } = ts.getLineAndCharacterOfPosition(sourceFile, member.getStart());
+                const { line: cEndLine } = ts.getLineAndCharacterOfPosition(sourceFile, member.getEnd());
+                symbols.push({
+                    name: "constructor",
+                    kind: "method",
+                    file,
+                    startLine: cStartLine + 1,
+                    endLine: cEndLine + 1,
+                    exported: false,
+                });
+                relations.push({
+                    fromSymbol: "constructor",
+                    toSymbol: className,
+                    type: "belongs_to",
+                    file,
+                    line: cStartLine + 1,
+                });
+                collectCalls(member.body, sourceFile, file, "constructor", relations, importMap);
+            }
+        }
+        return; // Don't recurse into class children again
+    }
+    // Interface declarations
+    if (ts.isInterfaceDeclaration(node)) {
+        const name = node.name.text;
+        const { line: startLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getStart());
+        const { line: endLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getEnd());
+        symbols.push({
+            name,
+            kind: "interface",
+            file,
+            startLine: startLine + 1,
+            endLine: endLine + 1,
+            exported: hasExportModifier(node),
+        });
+    }
+    // Type alias declarations
+    if (ts.isTypeAliasDeclaration(node)) {
+        const name = node.name.text;
+        const { line: startLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getStart());
+        const { line: endLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getEnd());
+        symbols.push({
+            name,
+            kind: "type_alias",
+            file,
+            startLine: startLine + 1,
+            endLine: endLine + 1,
+            exported: hasExportModifier(node),
+        });
+    }
+    // Enum declarations
+    if (ts.isEnumDeclaration(node)) {
+        const name = node.name.text;
+        const { line: startLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getStart());
+        const { line: endLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getEnd());
+        symbols.push({
+            name,
+            kind: "enum",
+            file,
+            startLine: startLine + 1,
+            endLine: endLine + 1,
+            exported: hasExportModifier(node),
+        });
+    }
+    // Variable statements (top-level exports: export const X = ...)
+    if (ts.isVariableStatement(node) && hasExportModifier(node)) {
+        for (const decl of node.declarationList.declarations) {
+            if (ts.isIdentifier(decl.name)) {
+                const name = decl.name.text;
+                const { line: startLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getStart());
+                const { line: endLine } = ts.getLineAndCharacterOfPosition(sourceFile, node.getEnd());
+                symbols.push({
+                    name,
+                    kind: "variable",
+                    file,
+                    startLine: startLine + 1,
+                    endLine: endLine + 1,
+                    exported: true,
+                });
+            }
+        }
+    }
+    // Import declarations → import relations (file-level, from each imported name to the file)
+    if (ts.isImportDeclaration(node) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier)) {
+        const modulePath = node.moduleSpecifier.text;
+        const clause = node.importClause;
+        if (clause) {
+            const { line } = ts.getLineAndCharacterOfPosition(sourceFile, node.getStart());
+            if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) {
+                for (const specifier of clause.namedBindings.elements) {
+                    const importedName = specifier.propertyName?.text ?? specifier.name.text;
+                    relations.push({
+                        fromSymbol: file,
+                        toSymbol: importedName,
+                        type: "imports",
+                        file,
+                        line: line + 1,
+                        metadata: { modulePath },
+                    });
+                }
+            }
+            if (clause.name) {
+                relations.push({
+                    fromSymbol: file,
+                    toSymbol: clause.name.text,
+                    type: "imports",
+                    file,
+                    line: line + 1,
+                    metadata: { modulePath },
+                });
+            }
+        }
+    }
+    // Recurse into children (except class which is handled above)
+    if (!ts.isClassDeclaration(node)) {
+        ts.forEachChild(node, (child) => {
+            visitNode(child, sourceFile, file, symbols, relations, importMap, currentClass);
+        });
+    }
+}
+// ── Call Collection ──────────────────────────────────
+function collectCalls(body, sourceFile, file, callerName, relations, importMap) {
+    const seen = new Set();
+    function walk(node) {
+        if (ts.isCallExpression(node)) {
+            const calleeName = extractCalleeName(node.expression, sourceFile);
+            if (calleeName && calleeName !== callerName && !seen.has(calleeName)) {
+                seen.add(calleeName);
+                const { line } = ts.getLineAndCharacterOfPosition(sourceFile, node.getStart());
+                // Resolve through import map if available
+                const importEntry = importMap.get(calleeName);
+                const resolvedName = importEntry
+                    ? importEntry.importedName === "*"
+                        ? calleeName
+                        : importEntry.importedName
+                    : calleeName;
+                relations.push({
+                    fromSymbol: callerName,
+                    toSymbol: resolvedName,
+                    type: "calls",
+                    file,
+                    line: line + 1,
+                });
+            }
+        }
+        if (ts.isNewExpression(node)) {
+            const calleeName = extractCalleeName(node.expression, sourceFile);
+            if (calleeName && !seen.has(calleeName)) {
+                seen.add(calleeName);
+                const { line } = ts.getLineAndCharacterOfPosition(sourceFile, node.getStart());
+                relations.push({
+                    fromSymbol: callerName,
+                    toSymbol: calleeName,
+                    type: "calls",
+                    file,
+                    line: line + 1,
+                });
+            }
+        }
+        ts.forEachChild(node, walk);
+    }
+    walk(body);
+}
+// ── Helpers ──────────────────────────────────────────
+function hasExportModifier(node) {
+    if (!ts.canHaveModifiers(node))
+        return false;
+    const modifiers = ts.getModifiers(node);
+    return modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+}
+function extractCalleeName(expr, _sourceFile) {
+    // Simple identifier: foo()
+    if (ts.isIdentifier(expr)) {
+        return expr.text;
+    }
+    // Property access: obj.method() → extract method name
+    if (ts.isPropertyAccessExpression(expr)) {
+        return expr.name.text;
+    }
+    return null;
+}
+function extractSignature(node, sourceFile) {
+    if (!node.parameters || node.parameters.length === 0)
+        return undefined;
+    const params = node.parameters
+        .map((p) => p.getText(sourceFile))
+        .join(", ");
+    const returnType = node.type ? `: ${node.type.getText(sourceFile)}` : "";
+    return `(${params})${returnType}`;
+}
+//# sourceMappingURL=ts-analyzer.js.map

package/dist/core/code/ts-analyzer.js.map

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

package/dist/core/config/ai-memory-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-memory-generator.d.ts","sourceRoot":"","sources":["../../../src/core/config/ai-memory-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,YAAY,6BAA6B,CAAC;AACvD,eAAO,MAAM,UAAU,2BAA2B,CAAC;AA+CnD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA+BnE;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA0BvE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAgBhF"}
+{"version":3,"file":"ai-memory-generator.d.ts","sourceRoot":"","sources":["../../../src/core/config/ai-memory-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,YAAY,6BAA6B,CAAC;AACvD,eAAO,MAAM,UAAU,2BAA2B,CAAC;AAyInD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6BnE;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6BvE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAgBhF"}

package/dist/core/config/ai-memory-generator.js

@@ -4,100 +4,188 @@
  */
 export const MARKER_START = "<!-- mcp-graph:start -->";
 export const MARKER_END = "<!-- mcp-graph:end -->";
-const TOOL_REFERENCE = `| Tool | Quando usar |
+const TOOL_TABLE_FULL = `#### 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 |
 |------|-------------|
-| \`init\` | Inicializar grafo do projeto |
-| \`import_prd\` | Importar PRD (texto/markdown) para o grafo |
-| \`list\` | Listar nodes do grafo (filtrar por tipo/status) |
-| \`show\` | Ver detalhes de um node específico |
-| \`next\` | Próxima task recomendada (prioridade + dependências + knowledge coverage + TDD hints) |
-| \`context\` | Contexto comprimido da task (token-efficient) |
-| \`update_status\` | Mudar status de um node (backlog→ready→in_progress→done) |
-| \`add_node\` | Criar node manualmente |
-| \`update_node\` | Atualizar campos de um node |
-| \`delete_node\` | Remover node do grafo |
-| \`edge\` | Criar/remover relações entre nodes |
-| \`analyze\` | Analisar grafo (qualidade, escopo, riscos, dependências, decomposição) |
-| \`search\` | Busca full-text no grafo (FTS5 + BM25) |
-| \`rag_context\` | Contexto RAG com knowledge base |
-| \`plan_sprint\` | Gerar relatório de planejamento de sprint |
-| \`metrics\` | Métricas do projeto (stats ou velocity) |
-| \`export\` | Exportar grafo (JSON ou Mermaid) |
-| \`snapshot\` | Criar/restaurar snapshots do grafo |
+| \`add_node\` | Criar node manualmente (task, milestone, phase, epic) |
+| \`update_node\` | Atualizar campos de um node (title, description, AC, tags) |
+| \`delete_node\` | Remover node do grafo (cascata em filhos) |
 | \`move_node\` | Mover node para outro parent |
-| \`clone_node\` | Clonar node com filhos |
-| \`sync_stack_docs\` | Sincronizar docs das libs do projeto |
-| \`reindex_knowledge\` | Reindexar knowledge store |
-| \`validate_task\` | Validar task com browser (Playwright) |`;
+| \`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\u2192ready\u2192in_progress\u2192done) |
+| \`bulk_update_status\` | Atualizar status de m\u00FAltiplos nodes de uma vez |
+
+#### PRD & Planejamento
+
+| Tool | Quando usar |
+|------|-------------|
+| \`import_prd\` | Importar PRD \u2192 segmentar \u2192 classificar \u2192 extrair \u2192 inferir deps \u2192 criar grafo + indexar knowledge |
+| \`plan_sprint\` | Gerar relat\u00F3rio de planejamento de sprint (capacity, velocity, recomenda\u00E7\u00F5es) |
+| \`analyze\` | 24 modos de an\u00E1lise por fase do lifecycle (ver modos abaixo) |
+| \`set_phase\` | For\u00E7ar/resetar fase do lifecycle (strict/advisory, gate checks) |
+
+#### Contexto & RAG
+
+| Tool | Quando usar |
+|------|-------------|
+| \`next\` | Pr\u00F3xima task recomendada (prioridade + deps + knowledge coverage 0-1 + TDD hints + velocity) |
+| \`context\` | Contexto comprimido da task (token-efficient, ~73% redu\u00E7\u00E3o) |
+| \`rag_context\` | Contexto RAG phase-aware (tiers: summary/standard/deep, budget 60/30/10) |
+| \`reindex_knowledge\` | Rebuild completo do \u00EDndice de knowledge (BM25 + TF-IDF) |
+| \`sync_stack_docs\` | Sincronizar docs das libs do projeto via Context7 |
+
+#### Mem\u00F3rias do Projeto
+
+| Tool | Quando usar |
+|------|-------------|
+| \`write_memory\` | Escrever mem\u00F3ria em workflow-graph/memories/{name}.md (auto-indexa no RAG) |
+| \`read_memory\` | Ler conte\u00FAdo de uma mem\u00F3ria espec\u00EDfica |
+| \`list_memories\` | Listar todas as mem\u00F3rias dispon\u00EDveis |
+| \`delete_memory\` | Remover mem\u00F3ria do filesystem e do knowledge store |
+
+#### Valida\u00E7\u00E3o
+
+| Tool | Quando usar |
+|------|-------------|
+| \`validate_task\` | Validar com Playwright (A/B comparison, CSS selector scoping, auto-index knowledge) |
+| \`validate_ac\` | Validar crit\u00E9rios de aceita\u00E7\u00E3o de uma task (checklist autom\u00E1tico) |`;
+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\u00E7\u00E3o, cobertura) |
+| ANALYZE | \`ready\` | Definition of Ready (bloqueios, depend\u00EAncias, AC) |
+| ANALYZE | \`risk\` | Riscos (complexidade, deps, tamanho, AC faltantes) |
+| ANALYZE | \`blockers\` | Bloqueios transitivos de um node |
+| ANALYZE | \`cycles\` | Ciclos de depend\u00EAncia no grafo |
+| ANALYZE | \`critical_path\` | Caminho cr\u00EDtico (sequ\u00EAncia mais longa de deps) |
+| PLAN | \`decompose\` | Tasks grandes que precisam ser decompostas |
+| DESIGN | \`adr\` | Valida\u00E7\u00E3o de ADRs (Architecture Decision Records) |
+| DESIGN | \`traceability\` | Matriz de rastreabilidade (req \u2192 task \u2192 test) |
+| DESIGN | \`coupling\` | Acoplamento entre m\u00F3dulos |
+| DESIGN | \`interfaces\` | Verifica\u00E7\u00E3o de interfaces e contratos |
+| DESIGN | \`tech_risk\` | Riscos t\u00E9cnicos (complexidade, stack, deps externas) |
+| DESIGN | \`design_ready\` | Gate DESIGN\u2192PLAN (pr\u00E9-requisitos atendidos?) |
+| IMPLEMENT | \`implement_done\` | Definition of Done (8 checks: 4 required + 4 recommended) |
+| IMPLEMENT | \`tdd_check\` | Ader\u00EAncia TDD (specs sugeridos por AC) |
+| IMPLEMENT | \`progress\` | Sprint burndown + velocity trend + blockers + ETA |
+| VALIDATE | \`validate_ready\` | Gate IMPLEMENT\u2192VALIDATE |
+| VALIDATE | \`done_integrity\` | Integridade dos nodes marcados done |
+| VALIDATE | \`status_flow\` | Fluxo de status v\u00E1lido (sem pulos) |
+| REVIEW | \`review_ready\` | Gate VALIDATE\u2192REVIEW |
+| HANDOFF | \`handoff_ready\` | Gate REVIEW\u2192HANDOFF |
+| HANDOFF | \`doc_completeness\` | Completude de documenta\u00E7\u00E3o |
+| LISTENING | \`listening_ready\` | Gate HANDOFF\u2192LISTENING |
+| LISTENING | \`backlog_health\` | Sa\u00FAde do backlog (distribui\u00E7\u00E3o, aging) |`;
+const KNOWLEDGE_PIPELINE_SECTION = `### Pipeline de Conhecimento (Knowledge Store + RAG)
+
+Fontes indexadas automaticamente:
+- **Project memories** \u2014 ao escrever com \`write_memory\` (auto-indexa)
+- **PRD imports** \u2014 ao importar com \`import_prd\`
+- **Browser captures** \u2014 ao validar com \`validate_task\`
+- **Stack docs** \u2014 ao sincronizar com \`sync_stack_docs\`
+- **Sprint reports** \u2014 ao gerar com \`plan_sprint\`
+
+Recupera\u00E7\u00E3o: \`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 \u00EDndice.`;
 const LIFECYCLE_SUMMARY = `### Lifecycle (8 fases)
 
-1. **ANALYZE** — Criar PRD, definir requisitos (\`import_prd\`, \`add_node\`)
-2. **DESIGN** — Arquitetura, decisões técnicas (\`add_node\`, \`edge\`, \`analyze\`)
-3. **PLAN** — Sprint planning, decomposição (\`plan_sprint\`, \`analyze\`, \`sync_stack_docs\`)
-4. **IMPLEMENT** — TDD Red→Green→Refactor (\`next\`, \`context\`, \`update_status\`, \`analyze\` — modes: implement_done, tdd_check, progress)
-5. **VALIDATE** — Testes E2E, critérios de aceitação (\`validate_task\`, \`metrics\`)
-6. **REVIEW** — Code review, blast radius (\`export\`, \`metrics\`)
-7. **HANDOFF** — PR, documentação, entrega (\`export\`, \`snapshot\`)
-8. **LISTENING** — Feedback, novo ciclo (\`add_node\`, \`import_prd\`)`;
-const XP_PRINCIPLES = `### Princípios XP Anti-Vibe-Coding
-
-- **TDD obrigatório** — Teste antes do código. Sem teste = sem implementação.
-- **Anti-one-shot** — Nunca gere sistemas inteiros em um prompt. Decomponha em tasks atômicas.
-- **Decomposição atômica** — Cada task deve ser completável em ≤2h.
-- **Code detachment** — Se a IA errou, explique o erro via prompt. Nunca edite manualmente.
-- **CLAUDE.md como spec evolutiva** — Documente padrões e decisões aqui.`;
+1. **ANALYZE** \u2014 Criar PRD, definir requisitos (\`import_prd\`, \`add_node\`)
+2. **DESIGN** \u2014 Arquitetura, decis\u00F5es t\u00E9cnicas (\`add_node\`, \`edge\`, \`analyze\`)
+3. **PLAN** \u2014 Sprint planning, decomposi\u00E7\u00E3o (\`plan_sprint\`, \`analyze\`, \`sync_stack_docs\`)
+4. **IMPLEMENT** \u2014 TDD Red\u2192Green\u2192Refactor (\`next\`, \`context\`, \`update_status\`, \`analyze\` \u2014 modes: implement_done, tdd_check, progress)
+5. **VALIDATE** \u2014 Testes E2E, crit\u00E9rios de aceita\u00E7\u00E3o (\`validate_task\`, \`metrics\`)
+6. **REVIEW** \u2014 Code review, blast radius (\`export\`, \`metrics\`)
+7. **HANDOFF** \u2014 PR, documenta\u00E7\u00E3o, entrega (\`export\`, \`snapshot\`)
+8. **LISTENING** \u2014 Feedback, novo ciclo (\`add_node\`, \`import_prd\`)`;
+const XP_PRINCIPLES = `### Princ\u00EDpios XP Anti-Vibe-Coding
+
+- **TDD obrigat\u00F3rio** \u2014 Teste antes do c\u00F3digo. Sem teste = sem implementa\u00E7\u00E3o.
+- **Anti-one-shot** \u2014 Nunca gere sistemas inteiros em um prompt. Decomponha em tasks at\u00F4micas.
+- **Decomposi\u00E7\u00E3o at\u00F4mica** \u2014 Cada task deve ser complet\u00E1vel em \u22642h.
+- **Code detachment** \u2014 Se a IA errou, explique o erro via prompt. Nunca edite manualmente.
+- **CLAUDE.md como spec evolutiva** \u2014 Documente padr\u00F5es e decis\u00F5es aqui.`;
+const CLI_COMMANDS = `### Comandos essenciais
+
+\`\`\`bash
+npx mcp-graph stats            # Estat\u00EDsticas do grafo
+npx mcp-graph list             # Listar nodes
+npx mcp-graph doctor           # Validar ambiente de execu\u00E7\u00E3o
+npx mcp-graph doctor --json    # Diagn\u00F3stico em JSON estruturado
+npx mcp-graph serve --port 3000  # Dashboard visual
+\`\`\``;
 export function generateClaudeMdSection(projectName) {
     return `
 ${MARKER_START}
-## mcp-graph — ${projectName}
+## mcp-graph \u2014 ${projectName}
 
-Este projeto usa **mcp-graph** para gestão de execução via grafo persistente (SQLite).
+Este projeto usa **mcp-graph** para gest\u00E3o de execu\u00E7\u00E3o via grafo persistente (SQLite).
 Dados armazenados em \`workflow-graph/graph.db\` (local, gitignored).
 
-### Ferramentas MCP disponíveis (26 tools)
+### Ferramentas MCP dispon\u00EDveis (30 tools)
 
-${TOOL_REFERENCE}
+${TOOL_TABLE_FULL}
+
+${ANALYZE_MODES_SECTION}
 
 ### Fluxo de trabalho recomendado
 
 \`\`\`
-next → context → [implementar com TDD] → update_status → next
+next \u2192 context \u2192 [implementar com TDD] \u2192 update_status \u2192 next
 \`\`\`
 
 ${LIFECYCLE_SUMMARY}
 
-${XP_PRINCIPLES}
+${KNOWLEDGE_PIPELINE_SECTION}
 
-### Comandos essenciais
+${XP_PRINCIPLES}
 
-\`\`\`bash
-npx mcp-graph stats          # Estatísticas do grafo
-npx mcp-graph list            # Listar nodes
-npx mcp-graph serve --port 3000  # Dashboard visual
-\`\`\`
+${CLI_COMMANDS}
 ${MARKER_END}
 `;
 }
 export function generateCopilotInstructions(projectName) {
     return `${MARKER_START}
-## mcp-graph — ${projectName}
+## mcp-graph \u2014 ${projectName}
 
-Este projeto usa **mcp-graph** para gestão de execução via grafo persistente.
+Este projeto usa **mcp-graph** para gest\u00E3o de execu\u00E7\u00E3o via grafo persistente.
 Dados em \`workflow-graph/graph.db\`.
 
 ### Ferramentas MCP (principais)
 
 | Tool | Uso |
 |------|-----|
-| \`next\` | Próxima task recomendada |
-| \`context\` | Contexto comprimido (token-efficient) |
-| \`update_status\` | Mudar status (backlog→ready→in_progress→done) |
-| \`import_prd\` | Importar PRD para o grafo |
-| \`plan_sprint\` | Planejamento de sprint |
-| \`decompose\` | Decompor tasks grandes |
-| \`validate_task\` | Validar com Playwright |
-
-### Fluxo: \`next → context → [TDD] → update_status → next\`
+| \`next\` | Pr\u00F3xima task recomendada (prioridade + deps + knowledge coverage + TDD hints) |
+| \`context\` | Contexto comprimido (token-efficient, ~73% redu\u00E7\u00E3o) |
+| \`update_status\` | Mudar status (backlog\u2192ready\u2192in_progress\u2192done) |
+| \`import_prd\` | Importar PRD \u2192 segmentar \u2192 classificar \u2192 extrair \u2192 criar grafo |
+| \`plan_sprint\` | Planejamento de sprint (capacity, velocity) |
+| \`analyze\` | 24 modos de an\u00E1lise por fase do lifecycle |
+| \`set_phase\` | For\u00E7ar/resetar fase do lifecycle (gate checks) |
+| \`validate_task\` | Validar com Playwright (A/B, CSS scoping) |
+| \`validate_ac\` | Validar crit\u00E9rios de aceita\u00E7\u00E3o (checklist autom\u00E1tico) |
+| \`rag_context\` | Contexto RAG phase-aware (budget 60/30/10) |
+
+### Fluxo: \`next \u2192 context \u2192 [TDD] \u2192 update_status \u2192 next\`
 
 ${LIFECYCLE_SUMMARY}
 

package/dist/core/config/ai-memory-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-memory-generator.js","sourceRoot":"","sources":["../../../src/core/config/ai-memory-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAEnD,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;8DAwBuC,CAAC;AAE/D,MAAM,iBAAiB,GAAG;;;;;;;;;uEAS6C,CAAC;AAExE,MAAM,aAAa,GAAG;;;;;;yEAMmD,CAAC;AAE1E,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO;EACP,YAAY;iBACG,WAAW;;;;;;;EAO1B,cAAc;;;;;;;;EAQd,iBAAiB;;EAEjB,aAAa;;;;;;;;;EASb,UAAU;CACX,CAAC;AACF,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,WAAmB;IAC7D,OAAO,GAAG,YAAY;iBACP,WAAW;;;;;;;;;;;;;;;;;;;EAmB1B,iBAAiB;;EAEjB,aAAa;EACb,UAAU;CACX,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,eAAuB,EAAE,UAAkB;IACtE,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;IAEhD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;QAChF,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,UAAU,GAAG,cAAc,GAAG,SAAS,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,OAAO,MAAM,GAAG,cAAc,CAAC;AACjC,CAAC"}
+{"version":3,"file":"ai-memory-generator.js","sourceRoot":"","sources":["../../../src/core/config/ai-memory-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAEnD,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4GA0DoF,CAAC;AAE7G,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;2FA4B6D,CAAC;AAE5F,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;oEAciC,CAAC;AAErE,MAAM,iBAAiB,GAAG;;;;;;;;;4EASkD,CAAC;AAE7E,MAAM,aAAa,GAAG;;;;;;wFAMkE,CAAC;AAEzF,MAAM,YAAY,GAAG;;;;;;;;OAQd,CAAC;AAER,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO;EACP,YAAY;sBACQ,WAAW;;;;;;;EAO/B,eAAe;;EAEf,qBAAqB;;;;;;;;EAQrB,iBAAiB;;EAEjB,0BAA0B;;EAE1B,aAAa;;EAEb,YAAY;EACZ,UAAU;CACX,CAAC;AACF,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,WAAmB;IAC7D,OAAO,GAAG,YAAY;sBACF,WAAW;;;;;;;;;;;;;;;;;;;;;;EAsB/B,iBAAiB;;EAEjB,aAAa;EACb,UAAU;CACX,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,eAAuB,EAAE,UAAkB;IACtE,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;IAEhD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;QAChF,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,UAAU,GAAG,cAAc,GAAG,SAAS,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,OAAO,MAAM,GAAG,cAAc,CAAC;AACjC,CAAC"}

package/dist/core/config/config-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../../src/core/config/config-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKvE,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CA6C5D"}
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../../src/core/config/config-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKvE,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CAoC5D"}

package/dist/core/config/config-loader.js

@@ -29,17 +29,9 @@ export function loadConfig(basePath) {
             fileConfig.port = envPort;
         }
     }
-    if (process.env.GITNEXUS_PORT) {
-        const envGitnexusPort = parseInt(process.env.GITNEXUS_PORT, 10);
-        if (!isNaN(envGitnexusPort)) {
-            const integrations = (fileConfig.integrations ?? {});
-            integrations.gitnexusPort = envGitnexusPort;
-            fileConfig.integrations = integrations;
-        }
-    }
-    if (process.env.GITNEXUS_AUTO_START) {
+    if (process.env.CODE_GRAPH_AUTO_INDEX) {
         const integrations = (fileConfig.integrations ?? {});
-        integrations.gitnexusAutoStart = process.env.GITNEXUS_AUTO_START !== "false";
+        integrations.codeGraphAutoIndex = process.env.CODE_GRAPH_AUTO_INDEX !== "false";
         fileConfig.integrations = integrations;
     }
     const config = ConfigSchema.parse(fileConfig);