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

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

@@ -0,0 +1,146 @@
+/**
+ * Design Definition of Ready — composite gate for DESIGN→PLAN transition.
+ * Aggregates ADR, traceability, coupling, interface, and risk checks.
+ */
+import { validateAdrs } from "./adr-validator.js";
+import { buildTraceabilityMatrix } from "./traceability-matrix.js";
+import { analyzeCoupling } from "./coupling-analyzer.js";
+import { checkInterfaces } from "./interface-checker.js";
+import { assessTechRisks } from "./tech-risk-assessor.js";
+import { detectCycles } from "../planner/dependency-chain.js";
+import { logger } from "../utils/logger.js";
+const GRADE_ORDER = { A: 4, B: 3, C: 2, D: 1, F: 0 };
+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 checkDesignReadiness(doc) {
+    const checks = [];
+    // ── Required checks (block ready: true) ──
+    // 1. Has at least 1 decision
+    const hasDecisions = doc.nodes.some((n) => n.type === "decision");
+    checks.push({
+        name: "has_decisions",
+        passed: hasDecisions,
+        details: hasDecisions
+            ? `${doc.nodes.filter((n) => n.type === "decision").length} decision(s) encontrada(s)`
+            : "Nenhum decision node encontrado",
+        severity: "required",
+    });
+    // 2. Has at least 1 constraint
+    const hasConstraints = doc.nodes.some((n) => n.type === "constraint");
+    checks.push({
+        name: "has_constraints",
+        passed: hasConstraints,
+        details: hasConstraints
+            ? `${doc.nodes.filter((n) => n.type === "constraint").length} constraint(s) encontrada(s)`
+            : "Nenhum constraint node encontrado",
+        severity: "required",
+    });
+    // 3. No orphan requirements (all requirements have at least 1 edge)
+    const requirements = doc.nodes.filter((n) => n.type === "requirement");
+    const reqsWithEdges = requirements.filter((req) => doc.edges.some((e) => e.from === req.id || e.to === req.id));
+    const noOrphans = requirements.length === 0 || reqsWithEdges.length === requirements.length;
+    checks.push({
+        name: "no_orphan_requirements",
+        passed: noOrphans,
+        details: noOrphans
+            ? "Todos requirements têm pelo menos 1 edge"
+            : `${requirements.length - reqsWithEdges.length} requirement(s) sem edges`,
+        severity: "required",
+    });
+    // 4. No 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. ADR quality >= C
+    const adrReport = validateAdrs(doc);
+    const adrPass = hasDecisions && GRADE_ORDER[adrReport.overallGrade] >= GRADE_ORDER["C"];
+    checks.push({
+        name: "adr_quality",
+        passed: adrPass,
+        details: hasDecisions
+            ? `ADR grade: ${adrReport.overallGrade} (mínimo: C)`
+            : "Sem decisions para avaliar ADR",
+        severity: "required",
+    });
+    // ── Recommended checks (affect score but don't block) ──
+    // 6. Traceability coverage >= 80%
+    const traceReport = buildTraceabilityMatrix(doc);
+    const traceCoveragePass = traceReport.coverageRate >= 80;
+    checks.push({
+        name: "traceability_coverage",
+        passed: traceCoveragePass,
+        details: `Cobertura de rastreabilidade: ${traceReport.coverageRate}% (meta: 80%)`,
+        severity: "recommended",
+    });
+    // 7. No isolated nodes
+    const couplingReport = analyzeCoupling(doc);
+    const noIsolated = couplingReport.isolatedNodes.length === 0;
+    checks.push({
+        name: "no_isolated_nodes",
+        passed: noIsolated,
+        details: noIsolated
+            ? "Nenhum nó isolado"
+            : `${couplingReport.isolatedNodes.length} nó(s) isolado(s)`,
+        severity: "recommended",
+    });
+    // 8. Interface score >= 60
+    const ifReport = checkInterfaces(doc);
+    const ifPass = ifReport.overallScore >= 60;
+    checks.push({
+        name: "interface_quality",
+        passed: ifPass,
+        details: `Interface score: ${ifReport.overallScore} (meta: 60)`,
+        severity: "recommended",
+    });
+    // 9. High risks mitigated
+    const riskReport = assessTechRisks(doc);
+    const highUnmitigated = riskReport.risks.filter((r) => r.score >= 6 && !r.mitigated);
+    const risksPass = highUnmitigated.length === 0;
+    checks.push({
+        name: "risks_mitigated",
+        passed: risksPass,
+        details: risksPass
+            ? "Todos riscos altos estão mitigados"
+            : `${highUnmitigated.length} risco(s) alto(s) sem mitigação`,
+        severity: "recommended",
+    });
+    // 10. Has at least 1 milestone
+    const hasMilestones = doc.nodes.some((n) => n.type === "milestone");
+    checks.push({
+        name: "has_milestones",
+        passed: hasMilestones,
+        details: hasMilestones
+            ? `${doc.nodes.filter((n) => n.type === "milestone").length} milestone(s) encontrado(s)`
+            : "Nenhum milestone definido",
+        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);
+    // Ready = all required checks passed
+    const ready = checks.filter((c) => c.severity === "required").every((c) => c.passed);
+    const summary = ready
+        ? `Design Ready (${grade}): ${passedChecks}/${totalChecks} checks passed, score ${score}`
+        : `Design Not Ready: ${checks.filter((c) => c.severity === "required" && !c.passed).map((c) => c.name).join(", ")} failed`;
+    logger.info("design-readiness", { ready, score, grade, passed: passedChecks, total: totalChecks });
+    return { checks, ready, score, grade, summary };
+}
+//# sourceMappingURL=definition-of-ready.js.map

package/dist/core/designer/definition-of-ready.js.map

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

package/dist/core/designer/interface-checker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Interface-first checker: validates that contract nodes have description, AC, edges, and constraint links.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { InterfaceReport } from "../../schemas/designer-schema.js";
+export declare function checkInterfaces(doc: GraphDocument): InterfaceReport;
+//# sourceMappingURL=interface-checker.d.ts.map

package/dist/core/designer/interface-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-checker.d.ts","sourceRoot":"","sources":["../../../src/core/designer/interface-checker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,kCAAkC,CAAC;AAK9F,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe,CAsDnE"}

package/dist/core/designer/interface-checker.js

@@ -0,0 +1,53 @@
+/**
+ * Interface-first checker: validates that contract nodes have description, AC, edges, and constraint links.
+ */
+import { logger } from "../utils/logger.js";
+const INTERFACE_NODE_TYPES = new Set(["epic", "requirement", "decision"]);
+export function checkInterfaces(doc) {
+    const { nodes, edges } = doc;
+    const interfaceNodes = nodes.filter((n) => INTERFACE_NODE_TYPES.has(n.type));
+    if (interfaceNodes.length === 0) {
+        return { results: [], overallScore: 100, nodesWithoutContracts: [] };
+    }
+    const constraintIds = new Set(nodes.filter((n) => n.type === "constraint").map((n) => n.id));
+    // Build node-to-edges map
+    const nodeEdges = new Map();
+    const nodeConstraintLinks = new Map();
+    for (const edge of edges) {
+        // Track edges for both from and to
+        const fromSet = nodeEdges.get(edge.from) ?? new Set();
+        fromSet.add(edge.to);
+        nodeEdges.set(edge.from, fromSet);
+        const toSet = nodeEdges.get(edge.to) ?? new Set();
+        toSet.add(edge.from);
+        nodeEdges.set(edge.to, toSet);
+        // Track constraint links
+        if (constraintIds.has(edge.to)) {
+            nodeConstraintLinks.set(edge.from, true);
+        }
+        if (constraintIds.has(edge.from)) {
+            nodeConstraintLinks.set(edge.to, true);
+        }
+    }
+    const results = interfaceNodes.map((node) => {
+        const hasDescription = !!node.description && node.description.trim().length > 0;
+        const hasAC = !!node.acceptanceCriteria && node.acceptanceCriteria.length > 0;
+        const hasEdges = (nodeEdges.get(node.id)?.size ?? 0) > 0;
+        const hasConstraintLink = nodeConstraintLinks.get(node.id) ?? false;
+        let score = 0;
+        if (hasDescription)
+            score += 25;
+        if (hasAC)
+            score += 25;
+        if (hasEdges)
+            score += 25;
+        if (hasConstraintLink)
+            score += 25;
+        return { nodeId: node.id, hasDescription, hasAC, hasEdges, hasConstraintLink, score };
+    });
+    const overallScore = Math.round(results.reduce((sum, r) => sum + r.score, 0) / results.length);
+    const nodesWithoutContracts = results.filter((r) => r.score < 50).map((r) => r.nodeId);
+    logger.info("interface-checker", { evaluated: results.length, overallScore });
+    return { results, overallScore, nodesWithoutContracts };
+}
+//# sourceMappingURL=interface-checker.js.map

package/dist/core/designer/interface-checker.js.map

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

package/dist/core/designer/tech-risk-assessor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tech risk assessor: categorize, score, and infer technical risks from graph structure.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { TechRiskReport } from "../../schemas/designer-schema.js";
+export declare function assessTechRisks(doc: GraphDocument): TechRiskReport;
+//# sourceMappingURL=tech-risk-assessor.d.ts.map

package/dist/core/designer/tech-risk-assessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-risk-assessor.d.ts","sourceRoot":"","sources":["../../../src/core/designer/tech-risk-assessor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAwD,MAAM,kCAAkC,CAAC;AAgD7H,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CA0DlE"}

package/dist/core/designer/tech-risk-assessor.js

@@ -0,0 +1,95 @@
+/**
+ * Tech risk assessor: categorize, score, and infer technical risks from graph structure.
+ */
+import { logger } from "../utils/logger.js";
+const CATEGORY_KEYWORDS = {
+    integration: ["integration", "api", "third-party", "external", "webhook", "endpoint"],
+    performance: ["performance", "latency", "throughput", "bottleneck", "slow", "cache"],
+    security: ["security", "auth", "vulnerability", "injection", "xss", "csrf", "encryption"],
+    maturity: ["maturity", "experimental", "beta", "unstable", "new technology", "prototype"],
+    complexity: ["complexity", "complex", "coupling", "monolith", "legacy", "refactor"],
+    dependency: ["dependency", "dependencies", "vendor", "lock-in", "upgrade", "breaking change"],
+};
+function categorizeRisk(description, tags) {
+    const text = `${description} ${tags.join(" ")}`.toLowerCase();
+    let bestCategory = "complexity";
+    let bestScore = 0;
+    for (const [category, keywords] of Object.entries(CATEGORY_KEYWORDS)) {
+        const matchCount = keywords.filter((kw) => text.includes(kw)).length;
+        if (matchCount > bestScore) {
+            bestScore = matchCount;
+            bestCategory = category;
+        }
+    }
+    return bestCategory;
+}
+function priorityToProbability(priority) {
+    if (priority <= 2)
+        return "high";
+    if (priority <= 3)
+        return "medium";
+    return "low";
+}
+const PROBABILITY_VALUE = { low: 1, medium: 2, high: 3 };
+function isRiskMitigated(doc, riskId) {
+    const mitigationTypes = new Set(["decision", "constraint"]);
+    const nodeTypeMap = new Map(doc.nodes.map((n) => [n.id, n.type]));
+    return doc.edges.some((edge) => {
+        if (edge.from === riskId && mitigationTypes.has(nodeTypeMap.get(edge.to) ?? ""))
+            return true;
+        if (edge.to === riskId && mitigationTypes.has(nodeTypeMap.get(edge.from) ?? ""))
+            return true;
+        return false;
+    });
+}
+export function assessTechRisks(doc) {
+    const riskNodes = doc.nodes.filter((n) => n.type === "risk");
+    const risks = riskNodes.map((node) => {
+        const category = categorizeRisk(node.description ?? "", node.tags ?? []);
+        const probability = priorityToProbability(node.priority);
+        const impact = node.priority <= 2 ? "high" : node.priority <= 3 ? "medium" : "low";
+        const score = PROBABILITY_VALUE[probability] * PROBABILITY_VALUE[impact];
+        const mitigated = isRiskMitigated(doc, node.id);
+        return { nodeId: node.id, category, probability, impact, score, mitigated };
+    });
+    // Infer risks from graph structure
+    const inferredRisks = [];
+    // Count fan-out per node
+    const fanOutMap = new Map();
+    for (const edge of doc.edges) {
+        if (edge.relationType === "depends_on") {
+            fanOutMap.set(edge.from, (fanOutMap.get(edge.from) ?? 0) + 1);
+        }
+    }
+    const HIGH_FAN_OUT_THRESHOLD = 5;
+    for (const [nodeId, fanOut] of fanOutMap) {
+        if (fanOut > HIGH_FAN_OUT_THRESHOLD) {
+            // High fan-out → complexity risk
+            inferredRisks.push({
+                nodeId,
+                category: "complexity",
+                probability: "medium",
+                impact: "medium",
+                score: 4,
+                mitigated: false,
+            });
+            // High depends_on count → dependency risk
+            inferredRisks.push({
+                nodeId,
+                category: "dependency",
+                probability: "medium",
+                impact: "medium",
+                score: 4,
+                mitigated: false,
+            });
+        }
+    }
+    const riskScore = risks.reduce((sum, r) => sum + r.score, 0)
+        + inferredRisks.reduce((sum, r) => sum + r.score, 0);
+    const highRisks = risks
+        .filter((r) => r.score >= 6)
+        .map((r) => r.nodeId);
+    logger.info("tech-risk-assessor", { explicit: risks.length, inferred: inferredRisks.length, riskScore });
+    return { risks, inferredRisks, riskScore, highRisks };
+}
+//# sourceMappingURL=tech-risk-assessor.js.map

package/dist/core/designer/tech-risk-assessor.js.map

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

package/dist/core/designer/traceability-matrix.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Traceability matrix: requirement → decision → constraint coverage.
+ * Follows edges to determine coverage level per requirement.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { TraceabilityReport } from "../../schemas/designer-schema.js";
+export declare function buildTraceabilityMatrix(doc: GraphDocument): TraceabilityReport;
+//# sourceMappingURL=traceability-matrix.d.ts.map

package/dist/core/designer/traceability-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceability-matrix.d.ts","sourceRoot":"","sources":["../../../src/core/designer/traceability-matrix.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAA2C,MAAM,kCAAkC,CAAC;AAmCpH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,GAAG,kBAAkB,CAsC9E"}

package/dist/core/designer/traceability-matrix.js

@@ -0,0 +1,67 @@
+/**
+ * Traceability matrix: requirement → decision → constraint coverage.
+ * Follows edges to determine coverage level per requirement.
+ */
+import { logger } from "../utils/logger.js";
+const TRACEABILITY_EDGE_TYPES = new Set([
+    "implements", "derived_from", "related_to", "depends_on", "parent_of", "child_of",
+]);
+/**
+ * Find all nodes of given types connected to nodeId via traceability edges (both directions).
+ */
+function findLinked(doc, nodeId, targetTypes) {
+    const linked = new Set();
+    const nodeTypeMap = new Map(doc.nodes.map((n) => [n.id, n.type]));
+    for (const edge of doc.edges) {
+        if (!TRACEABILITY_EDGE_TYPES.has(edge.relationType))
+            continue;
+        let otherId = null;
+        if (edge.from === nodeId)
+            otherId = edge.to;
+        else if (edge.to === nodeId)
+            otherId = edge.from;
+        if (otherId && targetTypes.has(nodeTypeMap.get(otherId) ?? "")) {
+            linked.add(otherId);
+        }
+    }
+    return [...linked];
+}
+function determineCoverage(linkedDecisions, linkedConstraints) {
+    if (linkedDecisions.length > 0 && linkedConstraints.length > 0)
+        return "full";
+    if (linkedDecisions.length > 0 || linkedConstraints.length > 0)
+        return "partial";
+    return "none";
+}
+export function buildTraceabilityMatrix(doc) {
+    const requirements = doc.nodes.filter((n) => n.type === "requirement");
+    const decisions = doc.nodes.filter((n) => n.type === "decision");
+    const decisionTypes = new Set(["decision"]);
+    const constraintTypes = new Set(["constraint"]);
+    const matrix = requirements.map((req) => {
+        const linkedDecisions = findLinked(doc, req.id, decisionTypes);
+        const linkedConstraints = findLinked(doc, req.id, constraintTypes);
+        const coverage = determineCoverage(linkedDecisions, linkedConstraints);
+        return {
+            requirementId: req.id,
+            linkedDecisions,
+            linkedConstraints,
+            coverage,
+        };
+    });
+    const orphanRequirements = matrix
+        .filter((e) => e.coverage === "none")
+        .map((e) => e.requirementId);
+    const coveredCount = matrix.filter((e) => e.coverage !== "none").length;
+    const coverageRate = requirements.length > 0
+        ? Math.round((coveredCount / requirements.length) * 10000) / 100
+        : 100;
+    // Find orphan decisions: not linked to any requirement
+    const linkedDecisionIds = new Set(matrix.flatMap((e) => e.linkedDecisions));
+    const orphanDecisions = decisions
+        .filter((d) => !linkedDecisionIds.has(d.id))
+        .map((d) => d.id);
+    logger.info("traceability-matrix", { requirements: requirements.length, coverageRate });
+    return { matrix, coverageRate, orphanRequirements, orphanDecisions };
+}
+//# sourceMappingURL=traceability-matrix.js.map

package/dist/core/designer/traceability-matrix.js.map

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

package/dist/core/events/event-types.d.ts

@@ -1,4 +1,4 @@
-export type GraphEventType = "node:created" | "node:updated" | "node:deleted" | "edge:created" | "edge:deleted" | "import:completed" | "bulk:updated" | "knowledge:indexed" | "knowledge:deleted" | "log:entry";
+export type GraphEventType = "node:created" | "node:updated" | "node:deleted" | "edge:created" | "edge:deleted" | "import:completed" | "bulk:updated" | "knowledge:indexed" | "knowledge:deleted" | "phase:transitioned" | "log:entry";
 export interface GraphEvent {
     type: GraphEventType;
     timestamp: string;
@@ -68,6 +68,16 @@ export interface KnowledgeDeletedEvent extends GraphEvent {
         documentsDeleted: number;
     };
 }
+export interface PhaseTransitionedEvent extends GraphEvent {
+    type: "phase:transitioned";
+    payload: {
+        fromPhase: string;
+        toPhase: string;
+        forced: boolean;
+        nodesCount: number;
+        doneTasksCount: number;
+    };
+}
 export interface LogEntryEvent extends GraphEvent {
     type: "log:entry";
     payload: {

package/dist/core/events/event-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../../../src/core/events/event-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,cAAc,GACd,cAAc,GACd,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,cAAc,GACd,mBAAmB,GACnB,mBAAmB,GACnB,WAAW,CAAC;AAEhB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAC5F"}
+{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../../../src/core/events/event-types.ts"],"names":[],"mappings":"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"}

package/dist/core/handoff/delivery-checklist.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Delivery Checklist — composite gate for REVIEW→HANDOFF transition.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { HandoffReadinessReport } from "../../schemas/handoff-schema.js";
+export interface HandoffReadinessOptions {
+    knowledgeCount?: number;
+}
+export declare function checkHandoffReadiness(doc: GraphDocument, opts?: HandoffReadinessOptions): HandoffReadinessReport;
+//# sourceMappingURL=delivery-checklist.d.ts.map

package/dist/core/handoff/delivery-checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-checklist.d.ts","sourceRoot":"","sources":["../../../src/core/handoff/delivery-checklist.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAyB,MAAM,iCAAiC,CAAC;AAYrG,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,aAAa,EAClB,IAAI,CAAC,EAAE,uBAAuB,GAC7B,sBAAsB,CAkJxB"}

package/dist/core/handoff/delivery-checklist.js

@@ -0,0 +1,148 @@
+/**
+ * Delivery Checklist — composite gate for REVIEW→HANDOFF transition.
+ */
+import { assessRisks } from "../analyzer/risk-assessment.js";
+import { analyzeScope } from "../analyzer/scope-analyzer.js";
+import { detectBottlenecks } from "../insights/bottleneck-detector.js";
+import { calculateVelocity } from "../planner/velocity.js";
+import { detectCycles } from "../planner/dependency-chain.js";
+import { checkDocCompleteness } from "./doc-completeness.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 checkHandoffReadiness(doc, opts) {
+    const checks = [];
+    const tasks = doc.nodes.filter((n) => TASK_TYPES.has(n.type));
+    const doneTasks = tasks.filter((n) => n.status === "done");
+    // ── Required checks ──
+    // 1. all_tasks_done — 100% tasks done
+    const allDone = tasks.length > 0 && tasks.every((n) => n.status === "done");
+    checks.push({
+        name: "all_tasks_done",
+        passed: allDone,
+        details: allDone
+            ? "Todas tasks done"
+            : `${doneTasks.length}/${tasks.length} tasks done (100% requerido)`,
+        severity: "required",
+    });
+    // 2. no_blocked_nodes — zero blocked nodes
+    const bottlenecks = detectBottlenecks(doc);
+    const noBlocked = bottlenecks.blockedTasks.length === 0;
+    checks.push({
+        name: "no_blocked_nodes",
+        passed: noBlocked,
+        details: noBlocked
+            ? "Nenhum node bloqueado"
+            : `${bottlenecks.blockedTasks.length} node(s) bloqueado(s)`,
+        severity: "required",
+    });
+    // 3. no_critical_risks — zero critical/high unmitigated risks
+    const riskMatrix = assessRisks(doc);
+    const unmitigated = riskMatrix.risks.filter((r) => (r.level === "critical" || r.level === "high") && r.mitigationStatus === "unmitigated");
+    const risksPass = unmitigated.length === 0;
+    checks.push({
+        name: "no_critical_risks",
+        passed: risksPass,
+        details: risksPass
+            ? "Nenhum risco critical/high sem mitigação"
+            : `${unmitigated.length} risco(s) critical/high sem mitigação`,
+        severity: "required",
+    });
+    // 4. ac_coverage — ≥80% tasks with AC
+    const tasksWithAC = tasks.filter((t) => t.acceptanceCriteria && t.acceptanceCriteria.length > 0);
+    const acCoverage = tasks.length > 0 ? Math.round((tasksWithAC.length / tasks.length) * 100) : 100;
+    const acPass = acCoverage >= 80;
+    checks.push({
+        name: "ac_coverage",
+        passed: acPass,
+        details: `${acCoverage}% tasks com AC (meta: 80%)`,
+        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. knowledge_captured — knowledge count > 0
+    const knowledgeCount = opts?.knowledgeCount ?? 0;
+    const knowledgePass = knowledgeCount > 0;
+    checks.push({
+        name: "knowledge_captured",
+        passed: knowledgePass,
+        details: knowledgePass
+            ? `${knowledgeCount} conhecimento(s) capturado(s)`
+            : "Nenhum conhecimento capturado no knowledge store",
+        severity: "recommended",
+    });
+    // 7. milestones_done — ≥1 milestone done
+    const milestonesDone = doc.nodes.filter((n) => n.type === "milestone" && n.status === "done");
+    const milestonesPass = milestonesDone.length > 0;
+    checks.push({
+        name: "milestones_done",
+        passed: milestonesPass,
+        details: milestonesPass
+            ? `${milestonesDone.length} milestone(s) concluído(s)`
+            : "Nenhum milestone concluído",
+        severity: "recommended",
+    });
+    // 8. scope_clean — zero orphans
+    const scopeAnalysis = analyzeScope(doc);
+    const noOrphans = scopeAnalysis.orphans.length === 0;
+    checks.push({
+        name: "scope_clean",
+        passed: noOrphans,
+        details: noOrphans
+            ? "Sem nodes órfãos"
+            : `${scopeAnalysis.orphans.length} node(s) órfão(s)`,
+        severity: "recommended",
+    });
+    // 9. velocity_recorded — ≥1 sprint with data
+    const velocity = calculateVelocity(doc);
+    const velocityPass = velocity.sprints.length > 0;
+    checks.push({
+        name: "velocity_recorded",
+        passed: velocityPass,
+        details: velocityPass
+            ? `${velocity.sprints.length} sprint(s) com dados de velocidade`
+            : "Nenhum sprint com dados de velocidade",
+        severity: "recommended",
+    });
+    // 10. doc_completeness — ≥70% nodes with description
+    const docReport = checkDocCompleteness(doc);
+    const docPass = docReport.coverageRate >= 70;
+    checks.push({
+        name: "doc_completeness",
+        passed: docPass,
+        details: `${docReport.coverageRate}% nodes com description (meta: 70%)`,
+        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
+        ? `Handoff Ready (${grade}): ${passedChecks}/${totalChecks} checks passed, score ${score}`
+        : `Handoff Not Ready: ${checks.filter((c) => c.severity === "required" && !c.passed).map((c) => c.name).join(", ")} failed`;
+    logger.info("handoff-readiness", { ready, score, grade, passed: passedChecks, total: totalChecks });
+    return { checks, ready, score, grade, summary };
+}
+//# sourceMappingURL=delivery-checklist.js.map