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

package/dist/core/planner/lifecycle-phase.js

@@ -1,3 +1,10 @@
+import { parseAc } from "../analyzer/ac-parser.js";
+import { checkDesignReadiness } from "../designer/definition-of-ready.js";
+import { checkDefinitionOfDone } from "../implementer/definition-of-done.js";
+import { checkValidationReadiness } from "../validator/definition-of-ready.js";
+import { checkReviewReadiness } from "../reviewer/review-readiness.js";
+import { checkHandoffReadiness } from "../handoff/delivery-checklist.js";
+import { checkListeningReadiness } from "../listener/feedback-readiness.js";
 const DESIGN_ONLY_TYPES = new Set(["requirement", "epic", "decision", "constraint", "milestone", "risk", "acceptance_criteria"]);
 const TASK_TYPES = new Set(["task", "subtask"]);
 const FEEDBACK_TYPES = new Set(["requirement", "risk", "constraint"]);
@@ -77,13 +84,13 @@ function hasNewFeedbackNodes(nodes, doneTasks) {
 const GUIDANCE = {
     ANALYZE: {
         reminder: "Fase ANALYZE: Crie o PRD a partir da ideia. Defina requisitos, restrições e critérios de aceitação antes de qualquer código.",
-        suggestedTools: ["import_prd", "add_node", "search"],
+        suggestedTools: ["import_prd", "add_node", "analyze", "validate_ac", "search"],
         principles: ["Definir antes de construir", "PRD como contrato", "Requisitos claros e mensuráveis"],
     },
     DESIGN: {
-        reminder: "Fase DESIGN: Defina a arquitetura e tome decisões técnicas. Use análise de impacto antes de definir a estrutura.",
-        suggestedTools: ["add_node", "edge", "decompose", "export"],
-        principles: ["Skeleton & Organs", "Decisões arquiteturais documentadas", "Anti-one-shot"],
+        reminder: "Fase DESIGN: Defina a arquitetura e tome decisões técnicas. Use analyze para validar qualidade arquitetural.",
+        suggestedTools: ["add_node", "edge", "analyze", "export"],
+        principles: ["Skeleton & Organs", "ADR documentado", "Interface-first", "Traceability"],
         suggestedMcpAgents: [
             { name: "serena", action: "Análise semântica de symbols para entender arquitetura existente", tools: ["find_symbol", "get_symbols_overview"] },
             { name: "gitnexus", action: "Análise de impacto e blast radius da proposta arquitetural", tools: ["impact", "context"] },
@@ -91,7 +98,7 @@ const GUIDANCE = {
     },
     PLAN: {
         reminder: "Fase PLAN: Planeje o sprint, decomponha tasks grandes e sincronize documentação das libs.",
-        suggestedTools: ["plan_sprint", "decompose", "sync_stack_docs", "edge", "dependencies"],
+        suggestedTools: ["plan_sprint", "analyze", "sync_stack_docs", "edge"],
         principles: ["Decomposição atômica", "Sprint planning baseado em velocidade", "Dependências explícitas"],
         suggestedMcpAgents: [
             { name: "context7", action: "Consultar docs atualizadas das libs do stack", tools: ["resolve-library-id", "query-docs"] },
@@ -99,7 +106,7 @@ const GUIDANCE = {
     },
     IMPLEMENT: {
         reminder: "Fase IMPLEMENT: TDD obrigatório — Red → Green → Refactor. Escreva o teste ANTES da implementação. Use `context` para token-efficiency.",
-        suggestedTools: ["next", "context", "update_status", "rag_context", "validate_task"],
+        suggestedTools: ["next", "context", "update_status", "rag_context", "validate_task", "analyze"],
         principles: ["TDD Red→Green→Refactor", "Anti-one-shot", "Code detachment", "Decomposição atômica"],
         suggestedMcpAgents: [
             { name: "serena", action: "Edição semântica de symbols e navegação por referências", tools: ["find_symbol", "replace_symbol_body", "find_referencing_symbols"] },
@@ -109,8 +116,8 @@ const GUIDANCE = {
     },
     VALIDATE: {
         reminder: "Fase VALIDATE: Valide tasks completadas com testes E2E (Playwright). Verifique critérios de aceitação.",
-        suggestedTools: ["validate_task", "velocity", "stats", "list"],
-        principles: ["Validação automatizada", "Critérios de aceitação como contrato", "Zero tolerance para regressões"],
+        suggestedTools: ["validate_task", "metrics", "analyze", "list"],
+        principles: ["Validação automatizada", "Critérios de aceitação como contrato", "Zero tolerance para regressões", "AC quality como contrato", "Done integrity"],
         suggestedMcpAgents: [
             { name: "gitnexus", action: "Verificar escopo das mudanças com detect_changes", tools: ["detect_changes"] },
             { name: "playwright", action: "Testes E2E no browser, screenshots e validação visual", tools: ["browser_navigate", "browser_snapshot", "browser_click"] },
@@ -118,8 +125,8 @@ const GUIDANCE = {
     },
     REVIEW: {
         reminder: "Fase REVIEW: Revise o código, verifique blast radius e garanta que nada quebrou. Exporte o grafo para revisão.",
-        suggestedTools: ["export", "stats", "velocity", "dependencies"],
-        principles: ["Code review obrigatório", "Blast radius check", "Non-regression rule"],
+        suggestedTools: ["export", "metrics", "analyze"],
+        principles: ["Code review obrigatório", "Blast radius check", "Non-regression rule", "Velocity stability", "Scope integrity"],
         suggestedMcpAgents: [
             { name: "serena", action: "Verificar callers e referências dos symbols modificados", tools: ["find_referencing_symbols"] },
             { name: "gitnexus", action: "Blast radius final e verificação de escopo", tools: ["impact", "detect_changes"] },
@@ -127,28 +134,213 @@ const GUIDANCE = {
     },
     HANDOFF: {
         reminder: "Fase HANDOFF: Crie o PR, documente decisões e exporte o grafo. Prepare para entrega.",
-        suggestedTools: ["export", "snapshot", "stats", "velocity"],
-        principles: ["Documentação como entrega", "Grafo exportado", "Knowledge base atualizada"],
+        suggestedTools: ["export", "snapshot", "metrics", "analyze"],
+        principles: ["Documentação como entrega", "Grafo exportado", "Knowledge base atualizada", "Doc completeness", "Knowledge captured"],
         suggestedMcpAgents: [
             { name: "gitnexus", action: "Scope check final antes do PR", tools: ["detect_changes"] },
         ],
     },
     LISTENING: {
         reminder: "Fase LISTENING: Colete feedback e adicione novos nodes ao grafo. Inicie novo ciclo se necessário.",
-        suggestedTools: ["add_node", "import_prd", "search", "list"],
-        principles: ["Feedback contínuo", "Iteração incremental", "CLAUDE.md como spec evolutiva"],
+        suggestedTools: ["add_node", "import_prd", "search", "list", "analyze"],
+        principles: ["Feedback contínuo", "Iteração incremental", "CLAUDE.md como spec evolutiva", "Backlog health", "Tech debt tracking"],
     },
 };
 export function getPhaseGuidance(phase) {
     return GUIDANCE[phase];
 }
+const PHASE_GATES = {
+    ANALYZE_to_DESIGN: (doc) => {
+        const hasEpicOrRequirement = doc.nodes.some((n) => n.type === "epic" || n.type === "requirement");
+        return {
+            allowed: hasEpicOrRequirement,
+            reason: hasEpicOrRequirement ? null : "Nenhum epic ou requirement encontrado",
+            unmetConditions: hasEpicOrRequirement ? [] : ["Criar pelo menos 1 node tipo 'epic' ou 'requirement'"],
+        };
+    },
+    DESIGN_to_PLAN: (doc) => {
+        const report = checkDesignReadiness(doc);
+        return {
+            allowed: report.ready,
+            reason: report.ready ? null : report.summary,
+            unmetConditions: report.checks
+                .filter((c) => c.severity === "required" && !c.passed)
+                .map((c) => c.details),
+        };
+    },
+    PLAN_to_IMPLEMENT: (doc) => {
+        const tasks = doc.nodes.filter((n) => TASK_TYPES.has(n.type));
+        const hasSprints = tasks.some((n) => n.sprint != null);
+        return {
+            allowed: hasSprints,
+            reason: hasSprints ? null : "Nenhuma task com sprint atribuído",
+            unmetConditions: hasSprints ? [] : ["Atribuir sprint a pelo menos 1 task"],
+        };
+    },
+    IMPLEMENT_to_VALIDATE: (doc) => {
+        const report = checkValidationReadiness(doc);
+        // Additional recommended check: ≥50% done tasks have testable AC
+        const tasks = doc.nodes.filter((n) => TASK_TYPES.has(n.type));
+        const doneTasks = tasks.filter((n) => n.status === "done");
+        const doneWithTestableAc = doneTasks.filter((n) => {
+            const acs = n.acceptanceCriteria ?? [];
+            return acs.some((ac) => parseAc(ac).isTestable);
+        });
+        const testableRatio = doneTasks.length > 0 ? doneWithTestableAc.length / doneTasks.length : 0;
+        const conditions = report.checks
+            .filter((c) => c.severity === "required" && !c.passed)
+            .map((c) => c.details);
+        // Testable AC is recommended (warning), not required
+        if (testableRatio < 0.5 && doneTasks.length > 0) {
+            conditions.push(`Recomendado: ≥50% das done tasks com AC testável (atual: ${Math.round(testableRatio * 100)}%)`);
+        }
+        return {
+            allowed: report.ready,
+            reason: report.ready ? null : report.summary,
+            unmetConditions: conditions,
+        };
+    },
+    VALIDATE_to_REVIEW: (doc) => {
+        const report = checkReviewReadiness(doc);
+        return {
+            allowed: report.ready,
+            reason: report.ready ? null : report.summary,
+            unmetConditions: report.checks
+                .filter((c) => c.severity === "required" && !c.passed)
+                .map((c) => c.details),
+        };
+    },
+    REVIEW_to_HANDOFF: (doc) => {
+        const report = checkHandoffReadiness(doc);
+        return {
+            allowed: report.ready,
+            reason: report.ready ? null : report.summary,
+            unmetConditions: report.checks
+                .filter((c) => c.severity === "required" && !c.passed)
+                .map((c) => c.details),
+        };
+    },
+    HANDOFF_to_LISTENING: (doc) => {
+        const report = checkListeningReadiness(doc);
+        return {
+            allowed: report.ready,
+            reason: report.ready ? null : report.summary,
+            unmetConditions: report.checks
+                .filter((c) => c.severity === "required" && !c.passed)
+                .map((c) => c.details),
+        };
+    },
+};
+/**
+ * Validate whether a phase transition is allowed based on graph state.
+ */
+export function validatePhaseTransition(doc, fromPhase, toPhase) {
+    const key = `${fromPhase}_to_${toPhase}`;
+    const gate = PHASE_GATES[key];
+    if (!gate) {
+        // No gate defined for this transition — allowed by default
+        return { allowed: true, reason: null, unmetConditions: [] };
+    }
+    return gate(doc);
+}
+// ── Tool Phase Restrictions ────────────────────
+const TOOL_PHASE_RESTRICTIONS = {
+    update_status: new Set(["ANALYZE"]),
+    plan_sprint: new Set(["ANALYZE"]),
+    validate_task: new Set(["ANALYZE", "DESIGN", "PLAN"]),
+};
+const ALWAYS_ALLOWED_TOOLS = new Set([
+    "init", "set_phase", "list", "show", "search", "metrics", "export", "snapshot",
+    "add_node", "edge", "import_prd", "context", "rag_context", "next",
+    "sync_stack_docs", "reindex_knowledge", "analyze", "validate_ac",
+]);
+/**
+ * Check if a tool is allowed in the current phase.
+ * Returns warnings with severity based on strictness mode.
+ */
+export function checkToolGate(doc, phase, toolName, mode = "strict") {
+    if (ALWAYS_ALLOWED_TOOLS.has(toolName)) {
+        return [];
+    }
+    const restrictions = TOOL_PHASE_RESTRICTIONS[toolName];
+    if (!restrictions || !restrictions.has(phase)) {
+        return [];
+    }
+    const severity = mode === "strict" ? "error" : "warning";
+    return [{
+            code: "tool_phase_blocked",
+            message: `Tool "${toolName}" não é permitida na fase ${phase}. Avance para a fase apropriada primeiro.`,
+            severity,
+        }];
+}
+/**
+ * Check if a status transition is allowed for a specific node in the current phase.
+ */
+export function checkStatusGate(doc, phase, nodeId, newStatus, mode = "strict") {
+    const warnings = [];
+    const severity = mode === "strict" ? "error" : "warning";
+    const node = doc.nodes.find((n) => n.id === nodeId);
+    if (newStatus === "done" && phase === "IMPLEMENT") {
+        // Check if node or parent has acceptance criteria
+        const hasAC = node?.acceptanceCriteria && node.acceptanceCriteria.length > 0;
+        const parentId = node?.parentId;
+        const parent = parentId ? doc.nodes.find((n) => n.id === parentId) : undefined;
+        const parentHasAC = parent?.acceptanceCriteria && parent.acceptanceCriteria.length > 0;
+        const globalAC = doc.nodes.some((n) => n.type === "acceptance_criteria");
+        if (!hasAC && !parentHasAC && !globalAC) {
+            warnings.push({
+                code: "done_without_acceptance_criteria",
+                message: `Node "${nodeId}" marcado como done sem acceptance criteria definidos.`,
+                severity,
+            });
+        }
+        // DoD pre-check — lightweight Definition of Done validation
+        // Only fire for nodes that have AC (the no-AC case is already handled above)
+        if (hasAC || parentHasAC || globalAC) {
+            const dodReport = checkDefinitionOfDone(doc, nodeId);
+            if (!dodReport.ready) {
+                const failedRequired = dodReport.checks
+                    .filter((c) => c.severity === "required" && !c.passed)
+                    .map((c) => c.name);
+                warnings.push({
+                    code: "done_without_dod",
+                    message: `Node "${nodeId}" não atende Definition of Done: ${failedRequired.join(", ")} (score: ${dodReport.score}, grade: ${dodReport.grade}).`,
+                    severity: "warning", // Always warning — DoD is informational guidance
+                });
+            }
+        }
+    }
+    if (newStatus === "in_progress" && phase === "PLAN") {
+        const tasks = doc.nodes.filter((n) => TASK_TYPES.has(n.type));
+        const taskNode = tasks.find((n) => n.id === nodeId);
+        if (taskNode && !taskNode.sprint) {
+            warnings.push({
+                code: "in_progress_without_sprint",
+                message: `Task "${nodeId}" iniciada sem sprint atribuído.`,
+                severity,
+            });
+        }
+    }
+    if (newStatus === "done" && node && node.status !== "in_progress") {
+        warnings.push({
+            code: "done_without_in_progress",
+            message: `Node "${nodeId}" marcado como done sem ter passado por in_progress (status atual: ${node.status}).`,
+            severity: "warning", // Always warning, even in strict — this is a soft guideline
+        });
+    }
+    return { warnings };
+}
 /**
  * Detect anti-pattern behaviors based on current phase, graph state, and tool being called.
- * Returns advisory warnings (never blocks execution).
+ * In advisory mode: returns warnings (never blocks execution).
+ * In strict mode: returns errors that block execution.
  */
-export function detectWarnings(doc, phase, toolName) {
+export function detectWarnings(doc, phase, toolName, mode = "strict") {
     const warnings = [];
     const guidance = GUIDANCE[phase];
+    // Check tool phase restrictions (strict → error, advisory → warning)
+    const gateWarnings = checkToolGate(doc, phase, toolName, mode);
+    warnings.push(...gateWarnings);
     // Warn if tool is not recommended for current phase
     if (!guidance.suggestedTools.includes(toolName)) {
         warnings.push({
@@ -162,7 +354,7 @@ export function detectWarnings(doc, phase, toolName) {
         warnings.push({
             code: "premature_status_change",
             message: "Fase ANALYZE — defina requisitos antes de implementar. Mudança de status prematura.",
-            severity: "warning",
+            severity: mode === "strict" ? "error" : "warning",
         });
     }
     if (phase === "PLAN" && toolName === "update_status") {

package/dist/core/planner/lifecycle-phase.js.map

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

package/dist/core/rag/phase-metadata.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Phase metadata utilities for knowledge indexers.
+ * Provides consistent phase tagging across all knowledge sources.
+ */
+import type { LifecyclePhase } from "../planner/lifecycle-phase.js";
+/**
+ * Phase boost weights for RAG search.
+ * Maps: current phase → source phase → boost multiplier.
+ * Higher boost = more relevant for the current phase.
+ */
+export declare const PHASE_BOOST_WEIGHTS: Record<LifecyclePhase, Partial<Record<LifecyclePhase, number>>>;
+/**
+ * Get the phase boost multiplier for a knowledge document in the current phase.
+ * Returns 1.0 (neutral) if no specific boost is defined.
+ */
+export declare function getPhaseBoost(currentPhase: LifecyclePhase, docPhase: string | undefined): number;
+/**
+ * Apply phase boost to a BM25 score.
+ * BM25 scores are negative (closer to 0 = better match).
+ * Boosting means dividing by the weight (making score closer to 0).
+ */
+export declare function applyPhaseBoost(score: number, boost: number): number;
+//# sourceMappingURL=phase-metadata.d.ts.map

package/dist/core/rag/phase-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-metadata.d.ts","sourceRoot":"","sources":["../../../src/core/rag/phase-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAwC/F,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIhG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpE"}

package/dist/core/rag/phase-metadata.js

@@ -0,0 +1,72 @@
+/**
+ * Phase metadata utilities for knowledge indexers.
+ * Provides consistent phase tagging across all knowledge sources.
+ */
+/**
+ * Phase boost weights for RAG search.
+ * Maps: current phase → source phase → boost multiplier.
+ * Higher boost = more relevant for the current phase.
+ */
+export const PHASE_BOOST_WEIGHTS = {
+    ANALYZE: {
+        ANALYZE: 2.0,
+        LISTENING: 1.5,
+    },
+    DESIGN: {
+        DESIGN: 2.0,
+        ANALYZE: 1.5,
+        PLAN: 1.2,
+    },
+    PLAN: {
+        PLAN: 2.0,
+        DESIGN: 1.5,
+        ANALYZE: 1.3,
+    },
+    IMPLEMENT: {
+        IMPLEMENT: 2.0,
+        PLAN: 1.5,
+        DESIGN: 1.2,
+    },
+    VALIDATE: {
+        VALIDATE: 2.0,
+        IMPLEMENT: 2.0,
+        ANALYZE: 1.3,
+    },
+    REVIEW: {
+        REVIEW: 2.0,
+        IMPLEMENT: 1.5,
+        VALIDATE: 2.0,
+    },
+    HANDOFF: {
+        HANDOFF: 2.0,
+        REVIEW: 1.5,
+        VALIDATE: 1.3,
+    },
+    LISTENING: {
+        LISTENING: 2.0,
+        ANALYZE: 1.5,
+        VALIDATE: 1.3,
+    },
+};
+/**
+ * Get the phase boost multiplier for a knowledge document in the current phase.
+ * Returns 1.0 (neutral) if no specific boost is defined.
+ */
+export function getPhaseBoost(currentPhase, docPhase) {
+    if (!docPhase)
+        return 1.0;
+    const weights = PHASE_BOOST_WEIGHTS[currentPhase];
+    return weights[docPhase] ?? 1.0;
+}
+/**
+ * Apply phase boost to a BM25 score.
+ * BM25 scores are negative (closer to 0 = better match).
+ * Boosting means dividing by the weight (making score closer to 0).
+ */
+export function applyPhaseBoost(score, boost) {
+    if (boost <= 0)
+        return score;
+    // BM25 scores are negative — dividing by boost makes them closer to 0 (better)
+    return score / boost;
+}
+//# sourceMappingURL=phase-metadata.js.map

package/dist/core/rag/phase-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-metadata.js","sourceRoot":"","sources":["../../../src/core/rag/phase-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAoE;IAClG,OAAO,EAAE;QACP,OAAO,EAAE,GAAG;QACZ,SAAS,EAAE,GAAG;KACf;IACD,MAAM,EAAE;QACN,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,GAAG;KACV;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,GAAG;KACb;IACD,SAAS,EAAE;QACT,SAAS,EAAE,GAAG;QACd,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,GAAG;KACZ;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,GAAG;QACb,SAAS,EAAE,GAAG;QACd,OAAO,EAAE,GAAG;KACb;IACD,MAAM,EAAE;QACN,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE,GAAG;KACd;IACD,OAAO,EAAE;QACP,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,GAAG;QACX,QAAQ,EAAE,GAAG;KACd;IACD,SAAS,EAAE;QACT,SAAS,EAAE,GAAG;QACd,OAAO,EAAE,GAAG;QACZ,QAAQ,EAAE,GAAG;KACd;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,YAA4B,EAAE,QAA4B;IACtF,IAAI,CAAC,QAAQ;QAAE,OAAO,GAAG,CAAC;IAC1B,MAAM,OAAO,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAClD,OAAO,OAAO,CAAC,QAA0B,CAAC,IAAI,GAAG,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAa;IAC1D,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7B,+EAA+E;IAC/E,OAAO,KAAK,GAAG,KAAK,CAAC;AACvB,CAAC"}

package/dist/core/rag/phase-summary.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Phase Summary Generator — creates a knowledge document summarizing
+ * what was accomplished during a lifecycle phase when transitioning out.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { LifecyclePhase } from "../planner/lifecycle-phase.js";
+import { KnowledgeStore } from "../store/knowledge-store.js";
+export interface PhaseSummaryResult {
+    indexed: boolean;
+    summaryText: string;
+}
+/**
+ * Generate and index a phase summary document into the knowledge store.
+ * Captures key metrics and decisions from the completed phase.
+ */
+export declare function generateAndIndexPhaseSummary(knowledgeStore: KnowledgeStore, doc: GraphDocument, fromPhase: LifecyclePhase, toPhase: LifecyclePhase): PhaseSummaryResult;
+//# sourceMappingURL=phase-summary.d.ts.map

package/dist/core/rag/phase-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-summary.d.ts","sourceRoot":"","sources":["../../../src/core/rag/phase-summary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,cAAc,EAC9B,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,cAAc,GACtB,kBAAkB,CAwBpB"}

package/dist/core/rag/phase-summary.js

@@ -0,0 +1,104 @@
+/**
+ * Phase Summary Generator — creates a knowledge document summarizing
+ * what was accomplished during a lifecycle phase when transitioning out.
+ */
+import { logger } from "../utils/logger.js";
+const TASK_TYPES = new Set(["task", "subtask"]);
+const DESIGN_TYPES = new Set(["decision", "constraint", "risk", "acceptance_criteria"]);
+/**
+ * Generate and index a phase summary document into the knowledge store.
+ * Captures key metrics and decisions from the completed phase.
+ */
+export function generateAndIndexPhaseSummary(knowledgeStore, doc, fromPhase, toPhase) {
+    const summaryText = buildPhaseSummaryText(doc, fromPhase, toPhase);
+    const sourceId = `phase_summary:${fromPhase}:${new Date().toISOString()}`;
+    try {
+        knowledgeStore.insert({
+            sourceType: "phase_summary",
+            sourceId,
+            title: `Phase ${fromPhase} Summary → ${toPhase}`,
+            content: summaryText,
+            metadata: {
+                phase: fromPhase,
+                transitionTo: toPhase,
+                transitionedAt: new Date().toISOString(),
+            },
+        });
+        logger.info("Phase summary indexed", { fromPhase, toPhase });
+        return { indexed: true, summaryText };
+    }
+    catch (err) {
+        logger.warn("Phase summary indexing failed", { error: String(err) });
+        return { indexed: false, summaryText };
+    }
+}
+/**
+ * Build a human-readable summary of what happened during a phase.
+ */
+function buildPhaseSummaryText(doc, fromPhase, toPhase) {
+    const { nodes, edges } = doc;
+    const tasks = nodes.filter((n) => TASK_TYPES.has(n.type));
+    const doneTasks = tasks.filter((n) => n.status === "done");
+    const inProgressTasks = tasks.filter((n) => n.status === "in_progress");
+    const designNodes = nodes.filter((n) => DESIGN_TYPES.has(n.type));
+    const sections = [];
+    sections.push(`Phase ${fromPhase} completed. Transitioning to ${toPhase}.`);
+    sections.push(`Total nodes: ${nodes.length}. Edges: ${edges.length}.`);
+    if (tasks.length > 0) {
+        sections.push(`Tasks: ${tasks.length} total, ${doneTasks.length} done, ${inProgressTasks.length} in progress, ${tasks.length - doneTasks.length - inProgressTasks.length} remaining.`);
+    }
+    // Phase-specific summaries
+    switch (fromPhase) {
+        case "ANALYZE": {
+            const requirements = nodes.filter((n) => n.type === "requirement");
+            const epics = nodes.filter((n) => n.type === "epic");
+            sections.push(`Requirements defined: ${requirements.length}. Epics: ${epics.length}.`);
+            break;
+        }
+        case "DESIGN": {
+            const decisions = designNodes.filter((n) => n.type === "decision");
+            const constraints = designNodes.filter((n) => n.type === "constraint");
+            const risks = designNodes.filter((n) => n.type === "risk");
+            sections.push(`Decisions: ${decisions.length}. Constraints: ${constraints.length}. Risks: ${risks.length}.`);
+            if (decisions.length > 0) {
+                const decisionTitles = decisions.map((d) => d.title).slice(0, 5);
+                sections.push(`Key decisions: ${decisionTitles.join("; ")}.`);
+            }
+            break;
+        }
+        case "PLAN": {
+            const sprintTasks = tasks.filter((n) => n.sprint != null);
+            const sprints = new Set(sprintTasks.map((n) => n.sprint));
+            sections.push(`Sprint-assigned tasks: ${sprintTasks.length} across ${sprints.size} sprint(s).`);
+            break;
+        }
+        case "IMPLEMENT": {
+            sections.push(`Tasks completed: ${doneTasks.length}/${tasks.length}.`);
+            const acNodes = nodes.filter((n) => n.type === "acceptance_criteria");
+            if (acNodes.length > 0) {
+                sections.push(`Acceptance criteria nodes: ${acNodes.length}.`);
+            }
+            break;
+        }
+        case "VALIDATE": {
+            const tasksWithAc = tasks.filter((n) => n.acceptanceCriteria && n.acceptanceCriteria.length > 0);
+            sections.push(`Tasks with acceptance criteria: ${tasksWithAc.length}/${tasks.length}.`);
+            break;
+        }
+        case "REVIEW": {
+            sections.push(`All tasks done: ${doneTasks.length === tasks.length ? "yes" : "no"}.`);
+            break;
+        }
+        case "HANDOFF": {
+            sections.push(`Handoff completed. ${doneTasks.length} tasks delivered.`);
+            break;
+        }
+        case "LISTENING": {
+            const feedbackNodes = nodes.filter((n) => n.type === "requirement" || n.type === "risk");
+            sections.push(`Feedback items collected: ${feedbackNodes.length}.`);
+            break;
+        }
+    }
+    return sections.join("\n");
+}
+//# sourceMappingURL=phase-summary.js.map

package/dist/core/rag/phase-summary.js.map

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

package/dist/core/rag/prd-indexer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PRD Indexer — indexes PRD text content into the knowledge store
+ * so that original requirements can be queried in later lifecycle phases.
+ */
+import { KnowledgeStore } from "../store/knowledge-store.js";
+import type { LifecyclePhase } from "../planner/lifecycle-phase.js";
+export interface PrdIndexResult {
+    documentsIndexed: number;
+    sourceFile: string;
+}
+/**
+ * Index PRD text content into the knowledge store.
+ * Chunks the content and stores with source_type='prd'.
+ */
+export declare function indexPrdContent(knowledgeStore: KnowledgeStore, content: string, sourceFile: string, phase?: LifecyclePhase): PrdIndexResult;
+//# sourceMappingURL=prd-indexer.d.ts.map

package/dist/core/rag/prd-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-indexer.d.ts","sourceRoot":"","sources":["../../../src/core/rag/prd-indexer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,cAAc,GACrB,cAAc,CAiChB"}