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

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

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

package/dist/core/handoff/doc-completeness.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Doc Completeness Checker — validates documentation coverage for handoff.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { DocCompletenessReport } from "../../schemas/handoff-schema.js";
+export declare function checkDocCompleteness(doc: GraphDocument): DocCompletenessReport;
+//# sourceMappingURL=doc-completeness.d.ts.map

package/dist/core/handoff/doc-completeness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-completeness.d.ts","sourceRoot":"","sources":["../../../src/core/handoff/doc-completeness.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAG7E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,qBAAqB,CAkB9E"}

package/dist/core/handoff/doc-completeness.js

@@ -0,0 +1,19 @@
+/**
+ * Doc Completeness Checker — validates documentation coverage for handoff.
+ */
+import { logger } from "../utils/logger.js";
+export function checkDocCompleteness(doc) {
+    const { nodes } = doc;
+    const withDescription = nodes.filter((n) => n.description && n.description.trim().length > 0);
+    const withoutDescription = nodes.filter((n) => !n.description || n.description.trim().length === 0);
+    const totalNodes = nodes.length;
+    const descriptionsPresent = withDescription.length;
+    const coverageRate = totalNodes > 0 ? Math.round((descriptionsPresent / totalNodes) * 100) : 100;
+    const nodesWithoutDescription = withoutDescription.map((n) => ({
+        nodeId: n.id,
+        title: n.title,
+    }));
+    logger.info("doc-completeness", { coverageRate, totalNodes, descriptionsPresent });
+    return { descriptionsPresent, totalNodes, coverageRate, nodesWithoutDescription };
+}
+//# sourceMappingURL=doc-completeness.js.map

package/dist/core/handoff/doc-completeness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-completeness.js","sourceRoot":"","sources":["../../../src/core/handoff/doc-completeness.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,UAAU,oBAAoB,CAAC,GAAkB;IACrD,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;IAEtB,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9F,MAAM,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAEpG,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAChC,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC;IACnD,MAAM,YAAY,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,mBAAmB,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAEjG,MAAM,uBAAuB,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,EAAE,CAAC,CAAC,EAAE;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;KACf,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAEnF,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,YAAY,EAAE,uBAAuB,EAAE,CAAC;AACpF,CAAC"}

package/dist/core/implementer/definition-of-done.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Definition of Done — composite gate for IMPLEMENT task completion.
+ * Validates 8 checks (4 required + 4 recommended) before marking a task as done.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { ImplementDoneReport } from "../../schemas/implementer-schema.js";
+/**
+ * Check Definition of Done for a specific task node.
+ */
+export declare function checkDefinitionOfDone(doc: GraphDocument, nodeId: string): ImplementDoneReport;
+//# sourceMappingURL=definition-of-done.d.ts.map

package/dist/core/implementer/definition-of-done.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-of-done.d.ts","sourceRoot":"","sources":["../../../src/core/implementer/definition-of-done.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAA4B,MAAM,qCAAqC,CAAC;AAiBzG;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAkJ7F"}

package/dist/core/implementer/definition-of-done.js

@@ -0,0 +1,158 @@
+/**
+ * Definition of Done — composite gate for IMPLEMENT task completion.
+ * Validates 8 checks (4 required + 4 recommended) before marking a task as done.
+ */
+import { validateAcQuality } from "../analyzer/ac-validator.js";
+import { parseAc } from "../analyzer/ac-parser.js";
+import { findTransitiveBlockers } from "../planner/dependency-chain.js";
+import { logger } from "../utils/logger.js";
+const XP_SIZE_ORDER = { XS: 1, S: 2, M: 3, L: 4, XL: 5 };
+const LARGE_XP_THRESHOLD = 4; // L=4, XL=5
+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";
+}
+/**
+ * Check Definition of Done for a specific task node.
+ */
+export function checkDefinitionOfDone(doc, nodeId) {
+    const node = doc.nodes.find((n) => n.id === nodeId);
+    const checks = [];
+    if (!node) {
+        return {
+            nodeId,
+            title: "(not found)",
+            checks: [],
+            ready: false,
+            score: 0,
+            grade: "F",
+            summary: `Node "${nodeId}" não encontrado no grafo`,
+        };
+    }
+    // ── Required checks ──
+    // 1. has_acceptance_criteria — task or parent has AC
+    const hasAc = (node.acceptanceCriteria && node.acceptanceCriteria.length > 0);
+    const parent = node.parentId ? doc.nodes.find((n) => n.id === node.parentId) : undefined;
+    const parentHasAc = parent?.acceptanceCriteria && parent.acceptanceCriteria.length > 0;
+    const acPass = !!(hasAc || parentHasAc);
+    checks.push({
+        name: "has_acceptance_criteria",
+        passed: acPass,
+        details: acPass
+            ? `AC definidos${parentHasAc && !hasAc ? " (herdado do parent)" : ""}`
+            : "Nenhum acceptance criteria definido no node ou parent",
+        severity: "required",
+    });
+    // 2. ac_quality_pass — AC score >= 60
+    if (hasAc) {
+        const acReport = validateAcQuality(doc, nodeId);
+        const nodeReport = acReport.nodes.find((r) => r.nodeId === nodeId);
+        const acScore = nodeReport?.score ?? 0;
+        const acQualityPass = acScore >= 60;
+        checks.push({
+            name: "ac_quality_pass",
+            passed: acQualityPass,
+            details: acQualityPass
+                ? `AC quality score: ${acScore} (mínimo: 60)`
+                : `AC quality score: ${acScore} — abaixo do mínimo de 60`,
+            severity: "required",
+        });
+    }
+    else {
+        checks.push({
+            name: "ac_quality_pass",
+            passed: false,
+            details: "Sem AC para avaliar qualidade",
+            severity: "required",
+        });
+    }
+    // 3. no_unresolved_blockers — no depends_on non-done nodes
+    const blockers = findTransitiveBlockers(doc, nodeId);
+    const unresolvedBlockers = blockers.filter((b) => b.status !== "done");
+    const noBlockers = unresolvedBlockers.length === 0;
+    checks.push({
+        name: "no_unresolved_blockers",
+        passed: noBlockers,
+        details: noBlockers
+            ? "Sem blockers não-resolvidos"
+            : `${unresolvedBlockers.length} blocker(s) pendente(s): ${unresolvedBlockers.map((b) => b.id).join(", ")}`,
+        severity: "required",
+    });
+    // 4. status_flow_valid — must have been in_progress or done
+    const validStatuses = new Set(["in_progress", "done"]);
+    const statusValid = validStatuses.has(node.status);
+    checks.push({
+        name: "status_flow_valid",
+        passed: statusValid,
+        details: statusValid
+            ? `Status atual: ${node.status}`
+            : `Status "${node.status}" — deve passar por in_progress antes de done`,
+        severity: "required",
+    });
+    // ── Recommended checks ──
+    // 5. has_description — non-empty description
+    const hasDesc = !!(node.description && node.description.trim().length > 0);
+    checks.push({
+        name: "has_description",
+        passed: hasDesc,
+        details: hasDesc
+            ? "Descrição definida"
+            : "Sem descrição — recomendado adicionar contexto",
+        severity: "recommended",
+    });
+    // 6. not_oversized — not L/XL without subtasks
+    const sizeOrder = XP_SIZE_ORDER[node.xpSize ?? "M"] ?? 3;
+    const isLarge = sizeOrder >= LARGE_XP_THRESHOLD;
+    const hasChildren = doc.nodes.some((n) => n.parentId === node.id);
+    const notOversized = !isLarge || hasChildren;
+    checks.push({
+        name: "not_oversized",
+        passed: notOversized,
+        details: notOversized
+            ? isLarge ? `Task ${node.xpSize} com subtasks — ok` : `Task ${node.xpSize ?? "M"} — tamanho adequado`
+            : `Task ${node.xpSize} sem subtasks — considerar decomposição`,
+        severity: "recommended",
+    });
+    // 7. has_testable_ac — at least 1 AC is testable
+    const acs = node.acceptanceCriteria ?? [];
+    const parsedAcs = acs.map((ac) => parseAc(ac));
+    const testableCount = parsedAcs.filter((p) => p.isTestable).length;
+    const hasTestableAc = testableCount > 0;
+    checks.push({
+        name: "has_testable_ac",
+        passed: hasTestableAc,
+        details: hasTestableAc
+            ? `${testableCount}/${acs.length} AC(s) testáveis`
+            : "Nenhum AC testável — adicionar assertions concretas",
+        severity: "recommended",
+    });
+    // 8. has_estimate — xpSize or estimateMinutes defined
+    const hasEstimate = !!(node.xpSize || node.estimateMinutes);
+    checks.push({
+        name: "has_estimate",
+        passed: hasEstimate,
+        details: hasEstimate
+            ? `Estimativa: ${node.xpSize ? `size=${node.xpSize}` : ""}${node.estimateMinutes ? ` ${node.estimateMinutes}min` : ""}`.trim()
+            : "Sem estimativa — recomendado definir xpSize ou estimateMinutes",
+        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
+        ? `DoD Ready (${grade}): ${passedChecks}/${totalChecks} checks passed, score ${score}`
+        : `DoD Not Ready: ${checks.filter((c) => c.severity === "required" && !c.passed).map((c) => c.name).join(", ")} failed`;
+    logger.info("definition-of-done", { nodeId, ready, score, grade, passed: passedChecks, total: totalChecks });
+    return { nodeId, title: node.title, checks, ready, score, grade, summary };
+}
+//# sourceMappingURL=definition-of-done.js.map

package/dist/core/implementer/definition-of-done.js.map

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

package/dist/core/implementer/sprint-progress.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sprint Progress — burndown, velocity trend, blockers, critical path, and ETA.
+ * Composes existing functions: calculateVelocity + findCriticalPath + findTransitiveBlockers.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { SprintProgressReport } from "../../schemas/implementer-schema.js";
+/**
+ * Calculate sprint progress with burndown, velocity, blockers, and ETA.
+ */
+export declare function calculateSprintProgress(doc: GraphDocument, sprint?: string): SprintProgressReport;
+//# sourceMappingURL=sprint-progress.d.ts.map

package/dist/core/implementer/sprint-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprint-progress.d.ts","sourceRoot":"","sources":["../../../src/core/implementer/sprint-progress.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAA0B,MAAM,qCAAqC,CAAC;AAOxG;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,aAAa,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,oBAAoB,CAiEtB"}

package/dist/core/implementer/sprint-progress.js

@@ -0,0 +1,80 @@
+/**
+ * Sprint Progress — burndown, velocity trend, blockers, critical path, and ETA.
+ * Composes existing functions: calculateVelocity + findCriticalPath + findTransitiveBlockers.
+ */
+import { calculateVelocity } from "../planner/velocity.js";
+import { findTransitiveBlockers, findCriticalPath } from "../planner/dependency-chain.js";
+import { logger } from "../utils/logger.js";
+const TASK_TYPES = new Set(["task", "subtask"]);
+/**
+ * Calculate sprint progress with burndown, velocity, blockers, and ETA.
+ */
+export function calculateSprintProgress(doc, sprint) {
+    // Filter tasks by sprint if provided
+    const allTasks = doc.nodes.filter((n) => TASK_TYPES.has(n.type));
+    const tasks = sprint
+        ? allTasks.filter((n) => n.sprint === sprint)
+        : allTasks;
+    const done = tasks.filter((n) => n.status === "done").length;
+    const inProgress = tasks.filter((n) => n.status === "in_progress").length;
+    const blocked = tasks.filter((n) => n.status === "blocked").length;
+    const backlog = tasks.filter((n) => n.status === "backlog").length;
+    const ready = tasks.filter((n) => n.status === "ready").length;
+    const total = tasks.length;
+    const donePercent = total > 0 ? Math.round((done / total) * 100) : 0;
+    // Velocity trend
+    const velocity = calculateVelocity(doc);
+    const currentSprintVelocity = sprint
+        ? velocity.sprints.find((s) => s.sprint === sprint)?.totalPoints ?? 0
+        : velocity.overall.totalPoints;
+    const averageVelocity = velocity.overall.avgPointsPerSprint;
+    const trend = determineTrend(currentSprintVelocity, averageVelocity);
+    // Blockers
+    const blockedTasks = tasks.filter((n) => n.status === "blocked");
+    const blockers = blockedTasks.map((t) => {
+        const transBlockers = findTransitiveBlockers(doc, t.id);
+        return {
+            nodeId: t.id,
+            title: t.title,
+            blockedBy: transBlockers.map((b) => b.id),
+        };
+    });
+    // Critical path remaining
+    const criticalPath = findCriticalPath(doc);
+    const criticalPathRemaining = criticalPath.filter((n) => n.status !== "done").length;
+    // ETA
+    const remaining = total - done;
+    const avgHours = velocity.overall.avgCompletionHours;
+    const estimatedCompletionDays = remaining > 0 && avgHours !== null && avgHours > 0
+        ? Math.round((remaining * avgHours / 8) * 10) / 10 // 8h per day
+        : null;
+    const summary = `Sprint Progress: ${done}/${total} done (${donePercent}%). ${blocked} blocked, ${criticalPathRemaining} on critical path.${estimatedCompletionDays !== null ? ` ETA: ~${estimatedCompletionDays} days.` : ""}`;
+    logger.info("sprint-progress", {
+        sprint: sprint ?? "(all)",
+        done,
+        total,
+        donePercent,
+        blocked,
+        criticalPathRemaining,
+    });
+    return {
+        sprint: sprint ?? null,
+        burndown: { total, done, inProgress, blocked, backlog, ready, donePercent },
+        velocityTrend: { currentSprintVelocity, averageVelocity, trend },
+        blockers,
+        criticalPathRemaining,
+        estimatedCompletionDays,
+        summary,
+    };
+}
+function determineTrend(current, average) {
+    if (average === 0)
+        return "stable";
+    const ratio = current / average;
+    if (ratio > 1.1)
+        return "up";
+    if (ratio < 0.9)
+        return "down";
+    return "stable";
+}
+//# sourceMappingURL=sprint-progress.js.map

package/dist/core/implementer/sprint-progress.js.map

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

package/dist/core/implementer/tdd-checker.d.ts

@@ -0,0 +1,15 @@
+/**
+ * TDD Checker — validates TDD adherence and generates test spec suggestions
+ * based on acceptance criteria analysis.
+ */
+import type { GraphDocument, GraphNode } from "../graph/graph-types.js";
+import type { TddCheckReport, TddHint } from "../../schemas/implementer-schema.js";
+/**
+ * Check TDD adherence across tasks in the graph.
+ */
+export declare function checkTddAdherence(doc: GraphDocument, nodeId?: string): TddCheckReport;
+/**
+ * Generate TDD hints for a single node — lightweight version for next tool enrichment.
+ */
+export declare function generateTddHints(node: GraphNode): TddHint[];
+//# sourceMappingURL=tdd-checker.d.ts.map

package/dist/core/implementer/tdd-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tdd-checker.d.ts","sourceRoot":"","sources":["../../../src/core/implementer/tdd-checker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EACV,cAAc,EAId,OAAO,EACR,MAAM,qCAAqC,CAAC;AAqB7C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,CAuDrF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,CAW3D"}

package/dist/core/implementer/tdd-checker.js

@@ -0,0 +1,132 @@
+/**
+ * TDD Checker — validates TDD adherence and generates test spec suggestions
+ * based on acceptance criteria analysis.
+ */
+import { parseAc } from "../analyzer/ac-parser.js";
+import { logger } from "../utils/logger.js";
+const UNIT_KEYWORDS = [
+    "retorna", "returns", "return", "status", "calcula", "calculates",
+    "valida", "validates", "converte", "converts", "formata", "formats",
+];
+const INTEGRATION_KEYWORDS = [
+    "integra", "conecta", "persiste", "salva", "saves", "persist",
+    "database", "db", "armazena", "stores", "envia", "sends",
+    "publica", "publishes", "sincroniza", "syncs",
+];
+const E2E_KEYWORDS = [
+    "navega", "navigate", "exibe", "displays", "mostra", "shows",
+    "clica", "clicks", "página", "page", "redireciona", "redirects",
+    "formulário", "form", "botão", "button", "tela", "screen",
+];
+/**
+ * Check TDD adherence across tasks in the graph.
+ */
+export function checkTddAdherence(doc, nodeId) {
+    const tasks = selectTasks(doc, nodeId);
+    const taskReports = [];
+    const allSuggested = [];
+    for (const node of tasks) {
+        const acs = node.acceptanceCriteria ?? [];
+        if (acs.length === 0)
+            continue;
+        const parsed = acs.map((ac) => parseAc(ac));
+        const testableAcs = parsed.filter((p) => p.isTestable).length;
+        const measurableAcs = parsed.filter((p) => p.isMeasurable).length;
+        const testabilityScore = acs.length > 0
+            ? Math.round((testableAcs / acs.length) * 100)
+            : 0;
+        const suggestedTests = [];
+        for (let i = 0; i < acs.length; i++) {
+            const ac = acs[i];
+            const p = parsed[i];
+            const specs = generateTestSpecsFromAc(ac, p);
+            suggestedTests.push(...specs);
+        }
+        allSuggested.push(...suggestedTests);
+        taskReports.push({
+            nodeId: node.id,
+            title: node.title,
+            totalAcs: acs.length,
+            testableAcs,
+            measurableAcs,
+            testabilityScore,
+            suggestedTests,
+        });
+    }
+    const tasksAtRisk = taskReports.filter((t) => t.testabilityScore === 0).length;
+    const overallTestability = taskReports.length > 0
+        ? Math.round(taskReports.reduce((sum, t) => sum + t.testabilityScore, 0) / taskReports.length)
+        : 0;
+    const summary = taskReports.length > 0
+        ? `TDD Check: ${taskReports.length} tasks analyzed, ${tasksAtRisk} at risk. Overall testability: ${overallTestability}%. ${allSuggested.length} test specs suggested.`
+        : "Nenhuma task com acceptance criteria encontrada.";
+    logger.info("tdd-checker", { tasks: taskReports.length, tasksAtRisk, overallTestability });
+    return {
+        tasks: taskReports,
+        overallTestability,
+        tasksAtRisk,
+        suggestedTestSpecs: allSuggested,
+        summary,
+    };
+}
+/**
+ * Generate TDD hints for a single node — lightweight version for next tool enrichment.
+ */
+export function generateTddHints(node) {
+    const acs = node.acceptanceCriteria ?? [];
+    if (acs.length === 0)
+        return [];
+    const hints = [];
+    for (const ac of acs) {
+        const parsed = parseAc(ac);
+        const specs = generateTestSpecsFromAc(ac, parsed);
+        hints.push(...specs);
+    }
+    return hints;
+}
+function selectTasks(doc, nodeId) {
+    if (nodeId) {
+        const node = doc.nodes.find((n) => n.id === nodeId);
+        return node ? [node] : [];
+    }
+    return doc.nodes.filter((n) => (n.type === "task" || n.type === "subtask") &&
+        n.acceptanceCriteria &&
+        n.acceptanceCriteria.length > 0);
+}
+function generateTestSpecsFromAc(acText, parsed) {
+    const specs = [];
+    const type = inferTestType(acText);
+    if (parsed.format === "gwt" && parsed.steps) {
+        const thenSteps = parsed.steps.filter((s) => s.keyword === "then");
+        const whenSteps = parsed.steps.filter((s) => s.keyword === "when");
+        const givenSteps = parsed.steps.filter((s) => s.keyword === "given");
+        if (thenSteps.length > 0) {
+            const testName = buildGwtTestName(thenSteps[0].text, whenSteps[0]?.text, givenSteps[0]?.text);
+            specs.push({ testName, fromAc: acText, type });
+        }
+    }
+    else if (parsed.isTestable) {
+        const testName = `should ${acText.toLowerCase().slice(0, 80)}`;
+        specs.push({ testName, fromAc: acText, type });
+    }
+    return specs;
+}
+function buildGwtTestName(then, when, given) {
+    let name = `should ${then.toLowerCase()}`;
+    if (when)
+        name += ` when ${when.toLowerCase()}`;
+    if (given)
+        name += ` given ${given.toLowerCase()}`;
+    return name;
+}
+function inferTestType(text) {
+    const lower = text.toLowerCase();
+    if (E2E_KEYWORDS.some((k) => lower.includes(k)))
+        return "e2e";
+    if (INTEGRATION_KEYWORDS.some((k) => lower.includes(k)))
+        return "integration";
+    if (UNIT_KEYWORDS.some((k) => lower.includes(k)))
+        return "unit";
+    return "unit"; // default
+}
+//# sourceMappingURL=tdd-checker.js.map

package/dist/core/implementer/tdd-checker.js.map

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

package/dist/core/listener/backlog-health.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Backlog Health — analyzes backlog state for new cycle readiness.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { BacklogHealthReport } from "../../schemas/listener-schema.js";
+export declare function analyzeBacklogHealth(doc: GraphDocument): BacklogHealthReport;
+//# sourceMappingURL=backlog-health.d.ts.map

package/dist/core/listener/backlog-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog-health.d.ts","sourceRoot":"","sources":["../../../src/core/listener/backlog-health.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAO5E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,mBAAmB,CA6D5E"}

package/dist/core/listener/backlog-health.js

@@ -0,0 +1,64 @@
+/**
+ * Backlog Health — analyzes backlog state for new cycle readiness.
+ */
+import { logger } from "../utils/logger.js";
+const TASK_TYPES = new Set(["task", "subtask"]);
+const TECH_DEBT_KEYWORDS = ["tech-debt", "refactor", "fix", "debt", "cleanup", "deprecat"];
+const STALE_THRESHOLD_DAYS = 30;
+export function analyzeBacklogHealth(doc) {
+    const tasks = doc.nodes.filter((n) => TASK_TYPES.has(n.type));
+    const backlogTasks = tasks.filter((n) => n.status === "backlog");
+    const readyTasks = tasks.filter((n) => n.status === "ready");
+    const now = Date.now();
+    // Find stale tasks (in backlog/ready for more than 30 days)
+    const staleTasks = [...backlogTasks, ...readyTasks]
+        .filter((t) => {
+        const createdMs = new Date(t.createdAt).getTime();
+        const daysOld = (now - createdMs) / (1000 * 60 * 60 * 24);
+        return daysOld >= STALE_THRESHOLD_DAYS;
+    })
+        .map((t) => ({
+        nodeId: t.id,
+        title: t.title,
+        daysInBacklog: Math.floor((now - new Date(t.createdAt).getTime()) / (1000 * 60 * 60 * 24)),
+    }));
+    // Find tech debt indicators by tags/title/description keywords
+    const techDebtIndicators = doc.nodes
+        .filter((n) => {
+        const searchText = [
+            n.title.toLowerCase(),
+            (n.description ?? "").toLowerCase(),
+            ...(n.tags ?? []).map((t) => t.toLowerCase()),
+        ].join(" ");
+        return TECH_DEBT_KEYWORDS.some((kw) => searchText.includes(kw));
+    })
+        .map((n) => {
+        const searchText = [
+            n.title.toLowerCase(),
+            (n.description ?? "").toLowerCase(),
+            ...(n.tags ?? []).map((t) => t.toLowerCase()),
+        ].join(" ");
+        const matchedKeywords = TECH_DEBT_KEYWORDS.filter((kw) => searchText.includes(kw));
+        return {
+            nodeId: n.id,
+            title: n.title,
+            keywords: matchedKeywords,
+        };
+    });
+    // Clean for new cycle = no stale tasks and limited tech debt
+    const cleanForNewCycle = staleTasks.length === 0 && techDebtIndicators.length <= 3;
+    logger.info("backlog-health", {
+        backlogCount: backlogTasks.length,
+        readyCount: readyTasks.length,
+        staleCount: staleTasks.length,
+        techDebtCount: techDebtIndicators.length,
+    });
+    return {
+        backlogCount: backlogTasks.length,
+        readyCount: readyTasks.length,
+        staleTasks,
+        techDebtIndicators,
+        cleanForNewCycle,
+    };
+}
+//# sourceMappingURL=backlog-health.js.map

package/dist/core/listener/backlog-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog-health.js","sourceRoot":"","sources":["../../../src/core/listener/backlog-health.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAChD,MAAM,kBAAkB,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAC3F,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,MAAM,UAAU,oBAAoB,CAAC,GAAkB;IACrD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;IAE7D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,4DAA4D;IAC5D,MAAM,UAAU,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,UAAU,CAAC;SAChD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACZ,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1D,OAAO,OAAO,IAAI,oBAAoB,CAAC;IACzC,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,MAAM,EAAE,CAAC,CAAC,EAAE;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;KAC3F,CAAC,CAAC,CAAC;IAEN,+DAA+D;IAC/D,MAAM,kBAAkB,GAAG,GAAG,CAAC,KAAK;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACZ,MAAM,UAAU,GAAG;YACjB,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE;YACrB,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;YACnC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,UAAU,GAAG;YACjB,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE;YACrB,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;YACnC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QACnF,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,EAAE;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,eAAe;SAC1B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,kBAAkB,CAAC,MAAM,IAAI,CAAC,CAAC;IAEnF,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAC5B,YAAY,EAAE,YAAY,CAAC,MAAM;QACjC,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,aAAa,EAAE,kBAAkB,CAAC,MAAM;KACzC,CAAC,CAAC;IAEH,OAAO;QACL,YAAY,EAAE,YAAY,CAAC,MAAM;QACjC,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,UAAU;QACV,kBAAkB;QAClB,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/core/listener/feedback-readiness.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Feedback Readiness — composite gate for HANDOFF→LISTENING transition.
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { ListenerReadinessReport } from "../../schemas/listener-schema.js";
+export interface ListeningReadinessOptions {
+    hasSnapshots?: boolean;
+    knowledgeCount?: number;
+}
+export declare function checkListeningReadiness(doc: GraphDocument, opts?: ListeningReadinessOptions): ListenerReadinessReport;
+//# sourceMappingURL=feedback-readiness.d.ts.map

package/dist/core/listener/feedback-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-readiness.d.ts","sourceRoot":"","sources":["../../../src/core/listener/feedback-readiness.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAA0B,MAAM,kCAAkC,CAAC;AASxG,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,aAAa,EAClB,IAAI,CAAC,EAAE,yBAAyB,GAC/B,uBAAuB,CAuHzB"}