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

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"}

package/dist/core/rag/prd-indexer.js

@@ -0,0 +1,37 @@
+/**
+ * PRD Indexer — indexes PRD text content into the knowledge store
+ * so that original requirements can be queried in later lifecycle phases.
+ */
+import { chunkText } from "./chunk-text.js";
+import { logger } from "../utils/logger.js";
+/**
+ * Index PRD text content into the knowledge store.
+ * Chunks the content and stores with source_type='prd'.
+ */
+export function indexPrdContent(knowledgeStore, content, sourceFile, phase) {
+    const chunks = chunkText(content);
+    if (chunks.length === 0) {
+        logger.info("No content to index from PRD", { sourceFile });
+        return { documentsIndexed: 0, sourceFile };
+    }
+    const sourceId = `prd:${sourceFile}`;
+    // Remove previous version to re-index fresh content
+    knowledgeStore.deleteBySource("prd", sourceId);
+    const docs = knowledgeStore.insertChunks(chunks.map((chunk) => ({
+        sourceType: "prd",
+        sourceId,
+        title: chunks.length > 1
+            ? `PRD: ${sourceFile} [${chunk.index + 1}/${chunks.length}]`
+            : `PRD: ${sourceFile}`,
+        content: chunk.content,
+        chunkIndex: chunk.index,
+        metadata: {
+            sourceFile,
+            phase: phase ?? "ANALYZE",
+            indexedAt: new Date().toISOString(),
+        },
+    })));
+    logger.info("PRD content indexed", { sourceFile, chunks: docs.length });
+    return { documentsIndexed: docs.length, sourceFile };
+}
+//# sourceMappingURL=prd-indexer.js.map

package/dist/core/rag/prd-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-indexer.js","sourceRoot":"","sources":["../../../src/core/rag/prd-indexer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ5C;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,cAA8B,EAC9B,OAAe,EACf,UAAkB,EAClB,KAAsB;IAEtB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5D,OAAO,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,UAAU,EAAE,CAAC;IAErC,oDAAoD;IACpD,cAAc,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAE/C,MAAM,IAAI,GAAG,cAAc,CAAC,YAAY,CACtC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrB,UAAU,EAAE,KAAc;QAC1B,QAAQ;QACR,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;YACtB,CAAC,CAAC,QAAQ,UAAU,KAAK,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG;YAC5D,CAAC,CAAC,QAAQ,UAAU,EAAE;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,KAAK;QACvB,QAAQ,EAAE;YACR,UAAU;YACV,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;KACF,CAAC,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAExE,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;AACvD,CAAC"}

package/dist/core/reviewer/review-readiness.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Review Readiness — composite gate for VALIDATE→REVIEW transition.
+ * 100% reuse of existing analyzers, no new helper modules.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { ReviewReadinessReport } from "../../schemas/reviewer-schema.js";
+export declare function checkReviewReadiness(doc: GraphDocument): ReviewReadinessReport;
+//# sourceMappingURL=review-readiness.d.ts.map

package/dist/core/reviewer/review-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-readiness.d.ts","sourceRoot":"","sources":["../../../src/core/reviewer/review-readiness.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAwB,MAAM,kCAAkC,CAAC;AAoBpG,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,qBAAqB,CA6J9E"}

package/dist/core/reviewer/review-readiness.js

@@ -0,0 +1,159 @@
+/**
+ * Review Readiness — composite gate for VALIDATE→REVIEW transition.
+ * 100% reuse of existing analyzers, no new helper modules.
+ */
+import { analyzeScope } from "../analyzer/scope-analyzer.js";
+import { assessRisks } from "../analyzer/risk-assessment.js";
+import { detectBottlenecks } from "../insights/bottleneck-detector.js";
+import { validateAcQuality } from "../analyzer/ac-validator.js";
+import { calculateVelocity } from "../planner/velocity.js";
+import { detectCycles } from "../planner/dependency-chain.js";
+import { logger } from "../utils/logger.js";
+const TASK_TYPES = new Set(["task", "subtask"]);
+function scoreToGrade(score) {
+    if (score >= 90)
+        return "A";
+    if (score >= 75)
+        return "B";
+    if (score >= 60)
+        return "C";
+    if (score >= 40)
+        return "D";
+    return "F";
+}
+export function checkReviewReadiness(doc) {
+    const checks = [];
+    const tasks = doc.nodes.filter((n) => TASK_TYPES.has(n.type));
+    const doneTasks = tasks.filter((n) => n.status === "done");
+    const completionRate = tasks.length > 0 ? (doneTasks.length / tasks.length) * 100 : 0;
+    // Reuse results from expensive calls
+    const bottlenecks = detectBottlenecks(doc);
+    const scopeAnalysis = analyzeScope(doc);
+    // ── Required checks ──
+    // 1. completion_rate — ≥80% tasks done
+    const enough = completionRate >= 80;
+    checks.push({
+        name: "completion_rate",
+        passed: enough,
+        details: enough
+            ? `${Math.round(completionRate)}% tasks done (meta: 80%)`
+            : `Apenas ${Math.round(completionRate)}% tasks done (meta: 80%)`,
+        severity: "required",
+    });
+    // 2. no_blocked_tasks — zero blocked tasks
+    const blockedCount = bottlenecks.blockedTasks.length;
+    const noBlocked = blockedCount === 0;
+    checks.push({
+        name: "no_blocked_tasks",
+        passed: noBlocked,
+        details: noBlocked
+            ? "Nenhuma task bloqueada"
+            : `${blockedCount} task(s) bloqueada(s)`,
+        severity: "required",
+    });
+    // 3. ac_coverage — ≥70% done tasks with AC
+    const doneWithAC = doneTasks.filter((t) => (t.acceptanceCriteria && t.acceptanceCriteria.length > 0));
+    const acCoverage = doneTasks.length > 0 ? Math.round((doneWithAC.length / doneTasks.length) * 100) : 100;
+    const acCoveragePass = acCoverage >= 70;
+    checks.push({
+        name: "ac_coverage",
+        passed: acCoveragePass,
+        details: `${acCoverage}% done tasks com AC (meta: 70%)`,
+        severity: "required",
+    });
+    // 4. no_cycles — no dependency cycles
+    const cycles = detectCycles(doc);
+    const noCycles = cycles.length === 0;
+    checks.push({
+        name: "no_cycles",
+        passed: noCycles,
+        details: noCycles
+            ? "Nenhum ciclo de dependência detectado"
+            : `${cycles.length} ciclo(s) detectado(s)`,
+        severity: "required",
+    });
+    // 5. risks_addressed — zero critical/high unmitigated risks
+    const riskMatrix = assessRisks(doc);
+    const unmitigatedCritical = riskMatrix.risks.filter((r) => (r.level === "critical" || r.level === "high") && r.mitigationStatus === "unmitigated");
+    const risksPass = unmitigatedCritical.length === 0;
+    checks.push({
+        name: "risks_addressed",
+        passed: risksPass,
+        details: risksPass
+            ? "Todos riscos critical/high endereçados"
+            : `${unmitigatedCritical.length} risco(s) critical/high sem mitigação`,
+        severity: "required",
+    });
+    // ── Recommended checks ──
+    // 6. velocity_stable — coefficient of variation < 1.0 (≥2 sprints)
+    const velocity = calculateVelocity(doc);
+    let velocityPass = true;
+    let velocityDetails = "Dados insuficientes para avaliar estabilidade";
+    if (velocity.sprints.length >= 2) {
+        const points = velocity.sprints.map((s) => s.totalPoints);
+        const avg = points.reduce((a, b) => a + b, 0) / points.length;
+        const variance = points.reduce((sum, p) => sum + Math.pow(p - avg, 2), 0) / points.length;
+        const stdDev = Math.sqrt(variance);
+        const cv = avg > 0 ? stdDev / avg : 0;
+        velocityPass = cv < 1.0;
+        velocityDetails = `Coeficiente de variação: ${cv.toFixed(2)} (meta: < 1.0)`;
+    }
+    checks.push({
+        name: "velocity_stable",
+        passed: velocityPass,
+        details: velocityDetails,
+        severity: "recommended",
+    });
+    // 7. no_orphan_tasks — zero orphan tasks
+    const orphanTasks = scopeAnalysis.orphans.filter((o) => TASK_TYPES.has(o.type));
+    const noOrphans = orphanTasks.length === 0;
+    checks.push({
+        name: "no_orphan_tasks",
+        passed: noOrphans,
+        details: noOrphans
+            ? "Nenhuma task órfã"
+            : `${orphanTasks.length} task(s) órfã(s)`,
+        severity: "recommended",
+    });
+    // 8. no_oversized_tasks — no tasks >120min without subtasks
+    const noOversized = bottlenecks.oversizedTasks.length === 0;
+    checks.push({
+        name: "no_oversized_tasks",
+        passed: noOversized,
+        details: noOversized
+            ? "Nenhuma task oversized"
+            : `${bottlenecks.oversizedTasks.length} task(s) >120min sem decomposição`,
+        severity: "recommended",
+    });
+    // 9. scope_integrity — no scope conflicts
+    const noConflicts = scopeAnalysis.conflicts.length === 0;
+    checks.push({
+        name: "scope_integrity",
+        passed: noConflicts,
+        details: noConflicts
+            ? "Sem conflitos de escopo"
+            : `${scopeAnalysis.conflicts.length} conflito(s) de escopo`,
+        severity: "recommended",
+    });
+    // 10. ac_quality — AC quality score ≥ 60
+    const acReport = validateAcQuality(doc);
+    const acQualityPass = acReport.overallScore >= 60;
+    checks.push({
+        name: "ac_quality",
+        passed: acQualityPass,
+        details: `AC quality score: ${acReport.overallScore} (meta: 60)`,
+        severity: "recommended",
+    });
+    // ── Scoring ──
+    const totalChecks = checks.length;
+    const passedChecks = checks.filter((c) => c.passed).length;
+    const score = Math.round((passedChecks / totalChecks) * 100);
+    const grade = scoreToGrade(score);
+    const ready = checks.filter((c) => c.severity === "required").every((c) => c.passed);
+    const summary = ready
+        ? `Review Ready (${grade}): ${passedChecks}/${totalChecks} checks passed, score ${score}`
+        : `Review Not Ready: ${checks.filter((c) => c.severity === "required" && !c.passed).map((c) => c.name).join(", ")} failed`;
+    logger.info("review-readiness", { ready, score, grade, passed: passedChecks, total: totalChecks });
+    return { checks, ready, score, grade, summary };
+}
+//# sourceMappingURL=review-readiness.js.map

package/dist/core/reviewer/review-readiness.js.map

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

package/dist/core/store/knowledge-store.d.ts

@@ -5,6 +5,7 @@
  */
 import type Database from "better-sqlite3";
 import type { KnowledgeDocument, KnowledgeSourceType } from "../../schemas/knowledge.schema.js";
+import type { LifecyclePhase } from "../planner/lifecycle-phase.js";
 export interface InsertKnowledgeDoc {
     sourceType: KnowledgeSourceType;
     sourceId: string;
@@ -48,6 +49,14 @@ export declare class KnowledgeStore {
     search(query: string, limit?: number): Array<KnowledgeDocument & {
         score: number;
     }>;
+    /**
+     * Search knowledge documents with phase-aware boosting.
+     * Documents tagged with phases relevant to the current phase are ranked higher.
+     */
+    searchWithPhaseBoost(query: string, currentPhase: LifecyclePhase, limit?: number): Array<KnowledgeDocument & {
+        score: number;
+        phaseBoost: number;
+    }>;
     /**
      * Delete a knowledge document by ID.
      */

package/dist/core/store/knowledge-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-store.d.ts","sourceRoot":"","sources":["../../../src/core/store/knowledge-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAKhG,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,mBAAmB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AA8BD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIjC;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,iBAAiB;IAqClD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,iBAAiB,EAAE;IAY7D;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAO7C;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,mBAAmB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,EAAE;IAqB1G;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,KAAK,CAAC,iBAAiB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAkBvF;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO3B;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQzE;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,MAAM;IAc/C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOnC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE;CAMrD"}
+{"version":3,"file":"knowledge-store.d.ts","sourceRoot":"","sources":["../../../src/core/store/knowledge-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAKhG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,mBAAmB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AA8BD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIjC;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,iBAAiB;IAqClD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,iBAAiB,EAAE;IAY7D;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAO7C;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,mBAAmB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,EAAE;IAqB1G;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,KAAK,CAAC,iBAAiB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAkBvF;;;OAGG;IACH,oBAAoB,CAClB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,cAAc,EAC5B,KAAK,GAAE,MAAW,GACjB,KAAK,CAAC,iBAAiB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBnE;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO3B;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQzE;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,MAAM;IAc/C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOnC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE;CAMrD"}

package/dist/core/store/knowledge-store.js

@@ -7,6 +7,7 @@ import { createHash } from "node:crypto";
 import { generateId } from "../utils/id.js";
 import { now } from "../utils/time.js";
 import { logger } from "../utils/logger.js";
+import { getPhaseBoost, applyPhaseBoost } from "../rag/phase-metadata.js";
 function rowToDoc(row) {
     return {
         id: row.id,
@@ -110,6 +111,27 @@ export class KnowledgeStore {
             score: row.score,
         }));
     }
+    /**
+     * Search knowledge documents with phase-aware boosting.
+     * Documents tagged with phases relevant to the current phase are ranked higher.
+     */
+    searchWithPhaseBoost(query, currentPhase, limit = 20) {
+        // Fetch more results than needed to allow re-ranking
+        const rawResults = this.search(query, limit * 2);
+        const boosted = rawResults.map((result) => {
+            const docPhase = result.metadata?.phase;
+            const boost = getPhaseBoost(currentPhase, docPhase);
+            const boostedScore = applyPhaseBoost(result.score, boost);
+            return {
+                ...result,
+                score: boostedScore,
+                phaseBoost: boost,
+            };
+        });
+        // Re-sort by boosted score (BM25: closer to 0 = better)
+        boosted.sort((a, b) => b.score - a.score);
+        return boosted.slice(0, limit);
+    }
     /**
      * Delete a knowledge document by ID.
      */

package/dist/core/store/knowledge-store.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Validation Definition of Ready — composite gate for IMPLEMENT→VALIDATE transition.
+ * Aggregates completion, AC quality, done integrity, and risk checks.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { ValidationReadinessReport } from "../../schemas/validator-schema.js";
+export declare function checkValidationReadiness(doc: GraphDocument): ValidationReadinessReport;
+//# sourceMappingURL=definition-of-ready.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition-of-ready.d.ts","sourceRoot":"","sources":["../../../src/core/validator/definition-of-ready.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,yBAAyB,EAA4B,MAAM,mCAAmC,CAAC;AAqB7G,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,aAAa,GAAG,yBAAyB,CAgKtF"}

package/dist/core/validator/definition-of-ready.js

@@ -0,0 +1,155 @@
+/**
+ * Validation Definition of Ready — composite gate for IMPLEMENT→VALIDATE transition.
+ * Aggregates completion, AC quality, done integrity, and risk checks.
+ */
+import { validateAcQuality } from "../analyzer/ac-validator.js";
+import { assessRisks } from "../analyzer/risk-assessment.js";
+import { detectBottlenecks } from "../insights/bottleneck-detector.js";
+import { calculateMetrics } from "../insights/metrics-calculator.js";
+import { detectCycles } from "../planner/dependency-chain.js";
+import { checkDoneIntegrity } from "./done-integrity-checker.js";
+import { checkStatusFlow } from "./status-flow-checker.js";
+import { logger } from "../utils/logger.js";
+const TASK_TYPES = new Set(["task", "subtask"]);
+function scoreToGrade(score) {
+    if (score >= 90)
+        return "A";
+    if (score >= 75)
+        return "B";
+    if (score >= 60)
+        return "C";
+    if (score >= 40)
+        return "D";
+    return "F";
+}
+export function checkValidationReadiness(doc) {
+    const checks = [];
+    const tasks = doc.nodes.filter((n) => TASK_TYPES.has(n.type));
+    const doneTasks = tasks.filter((n) => n.status === "done");
+    const completionRate = tasks.length > 0 ? (doneTasks.length / tasks.length) * 100 : 0;
+    // ── Required checks ──
+    // 1. completion_threshold — ≥50% tasks done
+    const halfDone = completionRate >= 50;
+    checks.push({
+        name: "completion_threshold",
+        passed: halfDone,
+        details: halfDone
+            ? `${Math.round(completionRate)}% tasks done (meta: 50%)`
+            : `Apenas ${Math.round(completionRate)}% tasks done (meta: 50%)`,
+        severity: "required",
+    });
+    // 2. ac_defined — done tasks have AC
+    const hasAC = doc.nodes.some((n) => n.type === "acceptance_criteria" || (n.acceptanceCriteria && n.acceptanceCriteria.length > 0));
+    checks.push({
+        name: "ac_defined",
+        passed: hasAC,
+        details: hasAC
+            ? "Acceptance criteria definidos"
+            : "Nenhum acceptance criteria encontrado",
+        severity: "required",
+    });
+    // 3. ac_quality — AC quality score ≥ 60
+    const acReport = validateAcQuality(doc);
+    const acQualityPass = acReport.overallScore >= 60;
+    checks.push({
+        name: "ac_quality",
+        passed: acQualityPass,
+        details: `AC quality score: ${acReport.overallScore} (meta: 60)`,
+        severity: "required",
+    });
+    // 4. done_integrity — no done tasks with integrity issues
+    const integrityReport = checkDoneIntegrity(doc);
+    checks.push({
+        name: "done_integrity",
+        passed: integrityReport.passed,
+        details: integrityReport.passed
+            ? "Todas tasks done com integridade verificada"
+            : `${integrityReport.issues.length} problema(s) de integridade em tasks done`,
+        severity: "required",
+    });
+    // 5. no_cycles — no dependency cycles
+    const cycles = detectCycles(doc);
+    const noCycles = cycles.length === 0;
+    checks.push({
+        name: "no_cycles",
+        passed: noCycles,
+        details: noCycles
+            ? "Nenhum ciclo de dependência detectado"
+            : `${cycles.length} ciclo(s) detectado(s)`,
+        severity: "required",
+    });
+    // ── Recommended checks ──
+    // 6. ac_coverage_global — ≥80% of ALL tasks have AC
+    const tasksWithAC = tasks.filter((t) => (t.acceptanceCriteria && t.acceptanceCriteria.length > 0) ||
+        doc.nodes.some((n) => n.type === "acceptance_criteria" && doc.edges.some((e) => (e.from === n.id && e.to === t.id) || (e.from === t.id && e.to === n.id))));
+    const acCoverageRate = tasks.length > 0 ? Math.round((tasksWithAC.length / tasks.length) * 100) : 100;
+    const acCoveragePass = acCoverageRate >= 80;
+    checks.push({
+        name: "ac_coverage_global",
+        passed: acCoveragePass,
+        details: `${acCoverageRate}% tasks com AC (meta: 80%)`,
+        severity: "recommended",
+    });
+    // 7. no_oversized_remaining — no incomplete tasks >120min without subtasks
+    const bottlenecks = detectBottlenecks(doc);
+    const oversizedRemaining = bottlenecks.oversizedTasks.filter((ot) => {
+        const node = doc.nodes.find((n) => n.id === ot.id);
+        return node && node.status !== "done";
+    });
+    const noOversized = oversizedRemaining.length === 0;
+    checks.push({
+        name: "no_oversized_remaining",
+        passed: noOversized,
+        details: noOversized
+            ? "Nenhuma task incompleta oversized"
+            : `${oversizedRemaining.length} task(s) incompleta(s) >120min sem decomposição`,
+        severity: "recommended",
+    });
+    // 8. risks_mitigated — high/critical risks with mitigation
+    const riskMatrix = assessRisks(doc);
+    const unmitigatedHighRisks = riskMatrix.risks.filter((r) => (r.level === "high" || r.level === "critical") && r.mitigationStatus === "unmitigated");
+    const risksPass = unmitigatedHighRisks.length === 0;
+    checks.push({
+        name: "risks_mitigated",
+        passed: risksPass,
+        details: risksPass
+            ? "Todos riscos high/critical com mitigação"
+            : `${unmitigatedHighRisks.length} risco(s) high/critical sem mitigação`,
+        severity: "recommended",
+    });
+    // 9. status_flow_compliance — done tasks went through in_progress
+    const flowReport = checkStatusFlow(doc);
+    const flowPass = flowReport.complianceRate >= 80;
+    checks.push({
+        name: "status_flow_compliance",
+        passed: flowPass,
+        details: `Taxa de compliance do fluxo de status: ${flowReport.complianceRate}% (meta: 80%)`,
+        severity: "recommended",
+    });
+    // 10. sprint_progress — current sprint ≥ 70% completion
+    const metrics = calculateMetrics(doc);
+    const currentSprint = metrics.sprintProgress.length > 0
+        ? metrics.sprintProgress[metrics.sprintProgress.length - 1]
+        : null;
+    const sprintPass = currentSprint ? currentSprint.percentage >= 70 : true;
+    checks.push({
+        name: "sprint_progress",
+        passed: sprintPass,
+        details: currentSprint
+            ? `Sprint "${currentSprint.sprint}": ${currentSprint.percentage}% (meta: 70%)`
+            : "Nenhum sprint ativo",
+        severity: "recommended",
+    });
+    // ── Scoring ──
+    const totalChecks = checks.length;
+    const passedChecks = checks.filter((c) => c.passed).length;
+    const score = Math.round((passedChecks / totalChecks) * 100);
+    const grade = scoreToGrade(score);
+    const ready = checks.filter((c) => c.severity === "required").every((c) => c.passed);
+    const summary = ready
+        ? `Validation Ready (${grade}): ${passedChecks}/${totalChecks} checks passed, score ${score}`
+        : `Validation Not Ready: ${checks.filter((c) => c.severity === "required" && !c.passed).map((c) => c.name).join(", ")} failed`;
+    logger.info("validation-readiness", { ready, score, grade, passed: passedChecks, total: totalChecks });
+    return { checks, ready, score, grade, summary };
+}
+//# sourceMappingURL=definition-of-ready.js.map