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

package/dist/core/analyzer/risk-assessment.js

@@ -0,0 +1,97 @@
+/**
+ * Risk Assessment — evaluates risk nodes using probability × impact scoring.
+ *
+ * Heuristics:
+ * - Keywords in title/description drive automatic probability/impact scoring
+ * - Mitigation status: mitigated if child task is done, partial if in_progress
+ */
+import { logger } from "../utils/logger.js";
+const HIGH_PROBABILITY_KEYWORDS = ["sempre", "provável", "frequente", "common", "likely"];
+const LOW_PROBABILITY_KEYWORDS = ["raro", "improvável", "unlikely", "rare"];
+const HIGH_IMPACT_KEYWORDS = ["crítico", "blocker", "critical", "data loss", "security", "downtime"];
+const LOW_IMPACT_KEYWORDS = ["cosmético", "menor", "minor", "cosmetic", "low-priority"];
+function scoreFromKeywords(text, highKeywords, lowKeywords, defaultScore) {
+    const lower = text.toLowerCase();
+    if (highKeywords.some((k) => lower.includes(k)))
+        return 4;
+    if (lowKeywords.some((k) => lower.includes(k)))
+        return 2;
+    return defaultScore;
+}
+function scoreToLevel(score) {
+    if (score >= 16)
+        return "critical";
+    if (score >= 9)
+        return "high";
+    if (score >= 4)
+        return "medium";
+    return "low";
+}
+export function assessRisks(doc) {
+    const { nodes } = doc;
+    const riskNodes = nodes.filter((n) => n.type === "risk");
+    const risks = [];
+    for (const node of riskNodes) {
+        const text = `${node.title} ${node.description ?? ""}`;
+        const probability = scoreFromKeywords(text, HIGH_PROBABILITY_KEYWORDS, LOW_PROBABILITY_KEYWORDS, 3);
+        const impact = scoreFromKeywords(text, HIGH_IMPACT_KEYWORDS, LOW_IMPACT_KEYWORDS, 3);
+        const score = probability * impact;
+        const level = scoreToLevel(score);
+        // Check mitigation via child tasks
+        const childTasks = nodes.filter((n) => n.parentId === node.id && (n.type === "task" || n.type === "subtask"));
+        let mitigationStatus = "unmitigated";
+        if (childTasks.length > 0) {
+            const allDone = childTasks.every((t) => t.status === "done");
+            const someProgress = childTasks.some((t) => t.status === "in_progress" || t.status === "done");
+            if (allDone)
+                mitigationStatus = "mitigated";
+            else if (someProgress)
+                mitigationStatus = "partial";
+        }
+        const suggestedMitigation = mitigationStatus === "unmitigated"
+            ? suggestMitigation(text, level)
+            : undefined;
+        risks.push({
+            nodeId: node.id,
+            title: node.title,
+            probability,
+            impact,
+            score,
+            level,
+            mitigationStatus,
+            suggestedMitigation,
+        });
+    }
+    // Sort by score descending
+    risks.sort((a, b) => b.score - a.score);
+    const summary = {
+        total: risks.length,
+        critical: risks.filter((r) => r.level === "critical").length,
+        high: risks.filter((r) => r.level === "high").length,
+        medium: risks.filter((r) => r.level === "medium").length,
+        low: risks.filter((r) => r.level === "low").length,
+        mitigated: risks.filter((r) => r.mitigationStatus === "mitigated").length,
+    };
+    logger.info("risk-assessment", { total: summary.total, critical: summary.critical, high: summary.high });
+    return { risks, summary };
+}
+function suggestMitigation(text, level) {
+    const lower = text.toLowerCase();
+    if (lower.includes("security") || lower.includes("segurança")) {
+        return "Criar task de security review/audit";
+    }
+    if (lower.includes("performance") || lower.includes("desempenho")) {
+        return "Criar task de benchmark e definir SLOs";
+    }
+    if (lower.includes("data") || lower.includes("dados")) {
+        return "Criar task de backup e plano de recuperação";
+    }
+    if (level === "critical") {
+        return "Risco crítico — criar spike de investigação urgente";
+    }
+    if (level === "high") {
+        return "Criar task de mitigação com prioridade alta";
+    }
+    return "Documentar plano de contingência";
+}
+//# sourceMappingURL=risk-assessment.js.map

package/dist/core/analyzer/risk-assessment.js.map

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

package/dist/core/analyzer/scope-analyzer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Scope Analyzer — detects orphans, coverage gaps, and conflicts in the graph.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { ScopeAnalysis } from "../../schemas/analyzer-schema.js";
+export declare function analyzeScope(doc: GraphDocument): ScopeAnalysis;
+//# sourceMappingURL=scope-analyzer.d.ts.map

package/dist/core/analyzer/scope-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-analyzer.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/scope-analyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAA8B,MAAM,kCAAkC,CAAC;AAOlG,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CA4G9D"}

package/dist/core/analyzer/scope-analyzer.js

@@ -0,0 +1,99 @@
+/**
+ * Scope Analyzer — detects orphans, coverage gaps, and conflicts in the graph.
+ */
+import { detectCycles } from "../planner/dependency-chain.js";
+import { logger } from "../utils/logger.js";
+const TASK_TYPES = new Set(["task", "subtask"]);
+const REQUIREMENT_TYPES = new Set(["epic", "requirement"]);
+export function analyzeScope(doc) {
+    const { nodes, edges } = doc;
+    const orphans = [];
+    // ── Orphan detection ──
+    // Requirements without tasks linked
+    const reqNodes = nodes.filter((n) => REQUIREMENT_TYPES.has(n.type));
+    const tasks = nodes.filter((n) => TASK_TYPES.has(n.type));
+    const parentIds = new Set(tasks.map((t) => t.parentId).filter(Boolean));
+    const edgeTargetIds = new Set(edges.map((e) => e.to));
+    const edgeSourceIds = new Set(edges.map((e) => e.from));
+    for (const req of reqNodes) {
+        const hasChildTask = parentIds.has(req.id);
+        const hasEdgeToTask = edgeSourceIds.has(req.id) || edgeTargetIds.has(req.id);
+        if (!hasChildTask && !hasEdgeToTask) {
+            orphans.push({
+                id: req.id,
+                title: req.title,
+                type: req.type,
+                reason: "Requirement sem tasks vinculadas",
+            });
+        }
+    }
+    // Tasks without parent or edges
+    for (const task of tasks) {
+        const hasParent = task.parentId != null;
+        const hasEdges = edgeSourceIds.has(task.id) || edgeTargetIds.has(task.id);
+        if (!hasParent && !hasEdges) {
+            orphans.push({
+                id: task.id,
+                title: task.title,
+                type: task.type,
+                reason: "Task sem parent ou relações",
+            });
+        }
+    }
+    // ── Cycles ──
+    const cycles = detectCycles(doc);
+    // ── Coverage matrix ──
+    const reqsWithTasks = reqNodes.filter((r) => {
+        const hasChild = tasks.some((t) => t.parentId === r.id);
+        const hasEdge = edges.some((e) => e.from === r.id || e.to === r.id);
+        return hasChild || hasEdge;
+    });
+    const tasksWithAc = tasks.filter((t) => (t.acceptanceCriteria && t.acceptanceCriteria.length > 0) ||
+        nodes.some((n) => n.type === "acceptance_criteria" && n.parentId === t.id));
+    const coverage = {
+        requirementsToTasks: reqNodes.length > 0
+            ? Math.round((reqsWithTasks.length / reqNodes.length) * 100)
+            : 100,
+        tasksToAc: tasks.length > 0
+            ? Math.round((tasksWithAc.length / tasks.length) * 100)
+            : 100,
+        orphanRequirements: orphans.filter((o) => REQUIREMENT_TYPES.has(o.type)).length,
+        orphanTasks: orphans.filter((o) => TASK_TYPES.has(o.type)).length,
+    };
+    // ── Conflicts (simple keyword contradiction detection) ──
+    const conflicts = [];
+    const constraintNodes = nodes.filter((n) => n.type === "constraint");
+    const constraintTexts = constraintNodes.map((n) => ({
+        id: n.id,
+        text: `${n.title} ${n.description ?? ""}`.toLowerCase(),
+    }));
+    const contradictions = [
+        ["performance", "funcionalidade"],
+        ["velocidade", "segurança"],
+        ["simples", "completo"],
+        ["rápido", "robusto"],
+    ];
+    for (let i = 0; i < constraintTexts.length; i++) {
+        for (let j = i + 1; j < constraintTexts.length; j++) {
+            for (const [a, b] of contradictions) {
+                if ((constraintTexts[i].text.includes(a) && constraintTexts[j].text.includes(b)) ||
+                    (constraintTexts[i].text.includes(b) && constraintTexts[j].text.includes(a))) {
+                    conflicts.push(`Possível conflito entre "${constraintTexts[i].id}" (${a}) e "${constraintTexts[j].id}" (${b})`);
+                }
+            }
+        }
+    }
+    const summaryParts = [];
+    if (orphans.length > 0)
+        summaryParts.push(`${orphans.length} órfãos`);
+    if (cycles.length > 0)
+        summaryParts.push(`${cycles.length} ciclos`);
+    if (conflicts.length > 0)
+        summaryParts.push(`${conflicts.length} conflitos`);
+    const summary = summaryParts.length > 0
+        ? `Scope issues: ${summaryParts.join(", ")}`
+        : "Escopo limpo — sem órfãos, ciclos ou conflitos detectados";
+    logger.info("scope-analyzer", { orphans: orphans.length, cycles: cycles.length, conflicts: conflicts.length });
+    return { orphans, cycles, coverage, conflicts, summary };
+}
+//# sourceMappingURL=scope-analyzer.js.map

package/dist/core/analyzer/scope-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-analyzer.js","sourceRoot":"","sources":["../../../src/core/analyzer/scope-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;AAkDnD,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;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"}

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

@@ -10,36 +10,33 @@ const TOOL_REFERENCE = `| Tool | Quando usar |
 | \`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) |
+| \`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 |
-| \`dependencies\` | Analisar cadeia de dependências |
-| \`decompose\` | Detectar tasks grandes e sugerir decomposição |
+| \`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 |
-| \`velocity\` | Métricas de velocidade por sprint |
-| \`stats\` | Estatísticas gerais do grafo |
+| \`metrics\` | Métricas do projeto (stats ou velocity) |
 | \`export\` | Exportar grafo (JSON ou Mermaid) |
 | \`snapshot\` | Criar/restaurar snapshots do grafo |
 | \`move_node\` | Mover node para outro parent |
 | \`clone_node\` | Clonar node com filhos |
-| \`bulk_update_status\` | Atualizar status de múltiplos nodes |
 | \`sync_stack_docs\` | Sincronizar docs das libs do projeto |
 | \`reindex_knowledge\` | Reindexar knowledge store |
 | \`validate_task\` | Validar task com browser (Playwright) |`;
 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\`, \`decompose\`)
-3. **PLAN** — Sprint planning, decomposição (\`plan_sprint\`, \`decompose\`, \`sync_stack_docs\`)
-4. **IMPLEMENT** — TDD Red→Green→Refactor (\`next\`, \`context\`, \`update_status\`)
-5. **VALIDATE** — Testes E2E, critérios de aceitação (\`validate_task\`, \`velocity\`)
-6. **REVIEW** — Code review, blast radius (\`export\`, \`stats\`)
+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

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;;;;;;;;;;;;;;;;;;;;;;;;;;;8DA2BuC,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,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"}

package/dist/core/context/context-assembler.d.ts

@@ -5,6 +5,7 @@
  */
 import type { SqliteStore } from "../store/sqlite-store.js";
 import { type ContextTier } from "./tiered-context.js";
+import type { LifecyclePhase } from "../planner/lifecycle-phase.js";
 export interface AssembledContext {
     /** The query used to assemble context */
     query: string;
@@ -35,6 +36,8 @@ export interface AssemblerOptions {
     nodeIds?: string[];
     /** Max knowledge chunks to include (default: 5) */
     maxKnowledgeChunks?: number;
+    /** Current lifecycle phase for phase-aware knowledge boosting */
+    phase?: LifecyclePhase;
 }
 /**
  * Assemble a multi-source context with token budgeting.

package/dist/core/context/context-assembler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-assembler.d.ts","sourceRoot":"","sources":["../../../src/core/context/context-assembler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAK3E,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,4BAA4B;IAC5B,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,gBAAgB,CAuGlB"}
+{"version":3,"file":"context-assembler.d.ts","sourceRoot":"","sources":["../../../src/core/context/context-assembler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAI3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,4BAA4B;IAC5B,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,gBAAgB,CA0GlB"}

package/dist/core/context/context-assembler.js

@@ -42,11 +42,14 @@ export function assembleContext(store, query, options) {
         tokensUsed += tokens;
     }
     breakdown.graph = tokensUsed;
-    // Section 2: Knowledge context (BM25-compressed)
+    // Section 2: Knowledge context (BM25-compressed, phase-aware)
     const knowledgeTokensBefore = tokensUsed;
+    const phase = options?.phase;
     try {
         const knowledgeStore = new KnowledgeStore(store.getDb());
-        const kResults = knowledgeStore.search(query, maxKnowledgeChunks * 2);
+        const kResults = phase
+            ? knowledgeStore.searchWithPhaseBoost(query, phase, maxKnowledgeChunks * 2)
+            : knowledgeStore.search(query, maxKnowledgeChunks * 2);
         if (kResults.length > 0) {
             const chunks = kResults.map((r) => `[${r.sourceType}] ${r.title}: ${r.content}`);
             const compressed = compressWithBm25(chunks, query, knowledgeBudget);

package/dist/core/context/context-assembler.js.map

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

package/dist/core/context/rag-context.d.ts

@@ -4,6 +4,7 @@
  */
 import type { SqliteStore } from "../store/sqlite-store.js";
 import { type TaskContext } from "./compact-context.js";
+import type { LifecyclePhase } from "../planner/lifecycle-phase.js";
 export interface KnowledgeSummary {
     id: string;
     sourceType: string;
@@ -37,8 +38,9 @@ interface RagNodeSummary {
  *
  * 1. Search for relevant nodes via FTS5
  * 2. Expand subgraph context for top results via buildTaskContext
- * 3. Manage token budget to stay within limits
+ * 3. Search knowledge store with optional phase-aware boosting
+ * 4. Manage token budget to stay within limits
  */
-export declare function ragBuildContext(store: SqliteStore, query: string, tokenBudget?: number): RagContext;
+export declare function ragBuildContext(store: SqliteStore, query: string, tokenBudget?: number, phase?: LifecyclePhase): RagContext;
 export {};
 //# sourceMappingURL=rag-context.d.ts.map

package/dist/core/context/rag-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rag-context.d.ts","sourceRoot":"","sources":["../../../src/core/context/rag-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAI1E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,gBAAgB,EAAE,WAAW,EAAE,CAAC;IAChC,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,MAAa,GACzB,UAAU,CAmFZ"}
+{"version":3,"file":"rag-context.d.ts","sourceRoot":"","sources":["../../../src/core/context/rag-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,gBAAgB,EAAE,WAAW,EAAE,CAAC;IAChC,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,MAAa,EAC1B,KAAK,CAAC,EAAE,cAAc,GACrB,UAAU,CAqFZ"}

package/dist/core/context/rag-context.js

@@ -12,10 +12,11 @@ import { logger } from "../utils/logger.js";
  *
  * 1. Search for relevant nodes via FTS5
  * 2. Expand subgraph context for top results via buildTaskContext
- * 3. Manage token budget to stay within limits
+ * 3. Search knowledge store with optional phase-aware boosting
+ * 4. Manage token budget to stay within limits
  */
-export function ragBuildContext(store, query, tokenBudget = 4000) {
-    logger.info(`RAG context: query="${query}", budget=${tokenBudget} tokens`);
+export function ragBuildContext(store, query, tokenBudget = 4000, phase) {
+    logger.info(`RAG context: query="${query}", budget=${tokenBudget} tokens, phase=${phase ?? "none"}`);
     // Stage 1: Search for relevant nodes with TF-IDF reranking
     const searchResults = searchNodes(store, query, { limit: 10, rerank: true });
     const relevantNodes = searchResults.map((r) => {
@@ -33,11 +34,13 @@ export function ragBuildContext(store, query, tokenBudget = 4000) {
             summary.tags = r.node.tags;
         return summary;
     });
-    // Stage 2: Search knowledge store for additional context
+    // Stage 2: Search knowledge store with optional phase-aware boosting
     const knowledgeStore = new KnowledgeStore(store.getDb());
     let knowledgeResults = [];
     try {
-        const kResults = knowledgeStore.search(query, 5);
+        const kResults = phase
+            ? knowledgeStore.searchWithPhaseBoost(query, phase, 5)
+            : knowledgeStore.search(query, 5);
         knowledgeResults = kResults.map((r) => ({
             id: r.id,
             sourceType: r.sourceType,

package/dist/core/context/rag-context.js.map

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

package/dist/core/designer/adr-validator.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ADR (Architecture Decision Record) validator.
+ * Validates decision nodes against ADR pattern: Status, Context, Decision, Consequences.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { AdrReport } from "../../schemas/designer-schema.js";
+export declare function validateAdrs(doc: GraphDocument): AdrReport;
+//# sourceMappingURL=adr-validator.d.ts.map

package/dist/core/designer/adr-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-validator.d.ts","sourceRoot":"","sources":["../../../src/core/designer/adr-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAiC,MAAM,kCAAkC,CAAC;AA4BjG,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,CAsC1D"}

package/dist/core/designer/adr-validator.js

@@ -0,0 +1,61 @@
+/**
+ * ADR (Architecture Decision Record) validator.
+ * Validates decision nodes against ADR pattern: Status, Context, Decision, Consequences.
+ */
+import { logger } from "../utils/logger.js";
+const ADR_SECTIONS = ["Status", "Context", "Decision", "Consequences"];
+/** Match both `## Section` and `Section:` formats, case-insensitive */
+function hasSection(text, section) {
+    const sectionLower = section.toLowerCase();
+    const lines = text.toLowerCase().split("\n");
+    return lines.some((line) => {
+        const trimmed = line.trimStart();
+        return trimmed.startsWith(`## ${sectionLower}`) ||
+            trimmed.startsWith(`##${sectionLower}`) ||
+            trimmed.startsWith(`${sectionLower}:`) ||
+            trimmed.startsWith(`${sectionLower} :`);
+    });
+}
+function sectionCountToGrade(count) {
+    if (count >= 4)
+        return "A";
+    if (count === 3)
+        return "B";
+    if (count === 2)
+        return "C";
+    if (count === 1)
+        return "D";
+    return "F";
+}
+const GRADE_ORDER = { A: 4, B: 3, C: 2, D: 1, F: 0 };
+export function validateAdrs(doc) {
+    const decisionNodes = doc.nodes.filter((n) => n.type === "decision");
+    const decisions = decisionNodes.map((node) => {
+        const text = node.description ?? "";
+        const hasStatus = hasSection(text, "Status");
+        const hasContext = hasSection(text, "Context");
+        const hasDecision = hasSection(text, "Decision");
+        const hasConsequences = hasSection(text, "Consequences");
+        const sectionFlags = { Status: hasStatus, Context: hasContext, Decision: hasDecision, Consequences: hasConsequences };
+        const missingFields = ADR_SECTIONS.filter((s) => !sectionFlags[s]);
+        const sectionCount = ADR_SECTIONS.length - missingFields.length;
+        return {
+            nodeId: node.id,
+            title: node.title,
+            grade: sectionCountToGrade(sectionCount),
+            hasStatus,
+            hasContext,
+            hasDecision,
+            hasConsequences,
+            missingFields,
+        };
+    });
+    let overallGrade = "F";
+    if (decisions.length > 0) {
+        overallGrade = decisions.reduce((worst, d) => (GRADE_ORDER[d.grade] < GRADE_ORDER[worst] ? d.grade : worst), "A");
+    }
+    const summary = `${decisions.length} decision(s) avaliada(s). Grade geral: ${overallGrade}`;
+    logger.info("adr-validator", { count: decisions.length, overallGrade });
+    return { decisions, overallGrade, summary };
+}
+//# sourceMappingURL=adr-validator.js.map

package/dist/core/designer/adr-validator.js.map

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

package/dist/core/designer/coupling-analyzer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Coupling analysis: fan-in, fan-out, instability (Robert C. Martin), isolation detection.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { CouplingReport } from "../../schemas/designer-schema.js";
+export declare function analyzeCoupling(doc: GraphDocument): CouplingReport;
+//# sourceMappingURL=coupling-analyzer.d.ts.map

package/dist/core/designer/coupling-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coupling-analyzer.d.ts","sourceRoot":"","sources":["../../../src/core/designer/coupling-analyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,kCAAkC,CAAC;AAa5F,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAsDlE"}

package/dist/core/designer/coupling-analyzer.js

@@ -0,0 +1,59 @@
+/**
+ * Coupling analysis: fan-in, fan-out, instability (Robert C. Martin), isolation detection.
+ */
+import { logger } from "../utils/logger.js";
+function calculateDepth(nodeId, parentMap) {
+    let depth = 0;
+    let current = parentMap.get(nodeId);
+    while (current) {
+        depth++;
+        current = parentMap.get(current);
+    }
+    return depth;
+}
+export function analyzeCoupling(doc) {
+    const { nodes, edges } = doc;
+    if (nodes.length === 0) {
+        return { nodes: [], highCouplingNodes: [], isolatedNodes: [], avgFanIn: 0, avgFanOut: 0, avgInstability: 0 };
+    }
+    const fanInMap = new Map();
+    const fanOutMap = new Map();
+    const parentMap = new Map();
+    for (const node of nodes) {
+        fanInMap.set(node.id, 0);
+        fanOutMap.set(node.id, 0);
+        parentMap.set(node.id, node.parentId);
+    }
+    for (const edge of edges) {
+        // from → to: from has fanOut, to has fanIn
+        fanOutMap.set(edge.from, (fanOutMap.get(edge.from) ?? 0) + 1);
+        fanInMap.set(edge.to, (fanInMap.get(edge.to) ?? 0) + 1);
+    }
+    const metrics = nodes.map((node) => {
+        const fanIn = fanInMap.get(node.id) ?? 0;
+        const fanOut = fanOutMap.get(node.id) ?? 0;
+        const total = fanIn + fanOut;
+        const instability = total > 0 ? fanOut / total : 0;
+        const depth = calculateDepth(node.id, parentMap);
+        return { nodeId: node.id, fanIn, fanOut, depth, instability };
+    });
+    const HIGH_COUPLING_THRESHOLD = 5;
+    const highCouplingNodes = metrics
+        .filter((m) => m.fanIn + m.fanOut > HIGH_COUPLING_THRESHOLD)
+        .map((m) => m.nodeId);
+    // Isolated: no edges AND has a parentId (root/top-level nodes without edges are expected)
+    const isolatedNodes = metrics
+        .filter((m) => {
+        if (m.fanIn + m.fanOut !== 0)
+            return false;
+        const node = nodes.find((n) => n.id === m.nodeId);
+        return !!node?.parentId;
+    })
+        .map((m) => m.nodeId);
+    const avgFanIn = metrics.reduce((sum, m) => sum + m.fanIn, 0) / metrics.length;
+    const avgFanOut = metrics.reduce((sum, m) => sum + m.fanOut, 0) / metrics.length;
+    const avgInstability = metrics.reduce((sum, m) => sum + m.instability, 0) / metrics.length;
+    logger.info("coupling-analyzer", { nodeCount: metrics.length, highCoupling: highCouplingNodes.length, isolated: isolatedNodes.length });
+    return { nodes: metrics, highCouplingNodes, isolatedNodes, avgFanIn, avgFanOut, avgInstability };
+}
+//# sourceMappingURL=coupling-analyzer.js.map

package/dist/core/designer/coupling-analyzer.js.map

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

package/dist/core/designer/definition-of-ready.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Design Definition of Ready — composite gate for DESIGN→PLAN transition.
+ * Aggregates ADR, traceability, coupling, interface, and risk checks.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { DesignReadinessReport } from "../../schemas/designer-schema.js";
+export declare function checkDesignReadiness(doc: GraphDocument): DesignReadinessReport;
+//# sourceMappingURL=definition-of-ready.d.ts.map

package/dist/core/designer/definition-of-ready.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-of-ready.d.ts","sourceRoot":"","sources":["../../../src/core/designer/definition-of-ready.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAkC,MAAM,kCAAkC,CAAC;AAmB9G,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,qBAAqB,CA4I9E"}