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

package/dist/core/analyzer/ac-parser.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Acceptance Criteria Parser — detects GWT (Given/When/Then), checklist, and free-text formats.
+ * Supports both English and Portuguese keywords.
+ */
+import type { ParsedAc } from "../../schemas/ac-quality-schema.js";
+export declare function parseAc(text: string): ParsedAc;
+//# sourceMappingURL=ac-parser.d.ts.map

package/dist/core/analyzer/ac-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-parser.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/ac-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAqB,MAAM,oCAAoC,CAAC;AAqBtF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAgB9C"}

package/dist/core/analyzer/ac-parser.js

@@ -0,0 +1,67 @@
+/**
+ * Acceptance Criteria Parser — detects GWT (Given/When/Then), checklist, and free-text formats.
+ * Supports both English and Portuguese keywords.
+ */
+const GWT_KEYWORDS_EN = /^(given|when|then|and|but)\s/i;
+const GWT_KEYWORDS_PT = /^(dado|quando|então|entao|e|mas)\s/i;
+const CHECKLIST_PATTERN = /^[-*[\]✓✗☐☑]\s/;
+const TESTABLE_VERBS = [
+    "deve", "should", "must", "returns", "retorna", "exibe", "displays",
+    "cria", "creates", "valida", "validates", "rejeita", "rejects",
+    "redireciona", "redirects", "envia", "sends", "salva", "saves",
+    "mostra", "shows", "permite", "allows", "bloqueia", "blocks",
+];
+const MEASURABLE_PATTERNS = [
+    /\d+\s*(ms|s|seg|min|%|px|kb|mb)/i,
+    /\b(menor|maior|less|more|under|over|within|antes|depois)\s+(?:que\s+)?\d+/i,
+    /\b(exatamente|exactly|igual|equals?)\s+/i,
+    /\b(status\s+\d{3}|código?\s+\d{3})/i,
+    /\b(vazio|empty|null|undefined|true|false)\b/i,
+];
+export function parseAc(text) {
+    const trimmed = text.trim();
+    const lines = trimmed.split("\n").map((l) => l.trim()).filter(Boolean);
+    const format = detectFormat(lines);
+    const steps = format === "gwt" ? extractGwtSteps(lines) : undefined;
+    const isTestable = checkTestable(trimmed);
+    const isMeasurable = checkMeasurable(trimmed);
+    return {
+        raw: trimmed,
+        format,
+        steps,
+        isTestable,
+        isMeasurable,
+    };
+}
+function detectFormat(lines) {
+    const hasGwt = lines.some((l) => GWT_KEYWORDS_EN.test(l) || GWT_KEYWORDS_PT.test(l));
+    if (hasGwt)
+        return "gwt";
+    const hasChecklist = lines.some((l) => CHECKLIST_PATTERN.test(l));
+    if (hasChecklist)
+        return "checklist";
+    return "free_text";
+}
+function extractGwtSteps(lines) {
+    const steps = [];
+    for (const line of lines) {
+        const matchEn = line.match(/^(given|when|then|and|but)\s+(.+)$/i);
+        const matchPt = line.match(/^(dado|quando|então|entao|e|mas)\s+(.+)$/i);
+        const match = matchEn ?? matchPt;
+        if (match) {
+            steps.push({
+                keyword: match[1].toLowerCase(),
+                text: match[2].trim(),
+            });
+        }
+    }
+    return steps;
+}
+function checkTestable(text) {
+    const lower = text.toLowerCase();
+    return TESTABLE_VERBS.some((v) => lower.includes(v));
+}
+function checkMeasurable(text) {
+    return MEASURABLE_PATTERNS.some((p) => p.test(text));
+}
+//# sourceMappingURL=ac-parser.js.map

package/dist/core/analyzer/ac-parser.js.map

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

package/dist/core/analyzer/ac-validator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * AC Validator — INVEST check for acceptance criteria quality.
+ *
+ * Checks:
+ * - I: Independent — AC doesn't reference other ACs
+ * - N: Negotiable — not overly prescriptive (implementation details)
+ * - V: Valuable — has a clear outcome/benefit
+ * - E: Estimable — can be estimated (not too vague)
+ * - S: Small — not too many steps
+ * - T: Testable — has concrete assertions
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { AcQualityReport } from "../../schemas/ac-quality-schema.js";
+export declare function validateAcQuality(doc: GraphDocument, nodeId?: string, all?: boolean): AcQualityReport;
+//# sourceMappingURL=ac-validator.d.ts.map

package/dist/core/analyzer/ac-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-validator.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/ac-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,oCAAoC,CAAC;AAoBrG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,eAAe,CAuCrG"}

package/dist/core/analyzer/ac-validator.js

@@ -0,0 +1,142 @@
+/**
+ * AC Validator — INVEST check for acceptance criteria quality.
+ *
+ * Checks:
+ * - I: Independent — AC doesn't reference other ACs
+ * - N: Negotiable — not overly prescriptive (implementation details)
+ * - V: Valuable — has a clear outcome/benefit
+ * - E: Estimable — can be estimated (not too vague)
+ * - S: Small — not too many steps
+ * - T: Testable — has concrete assertions
+ */
+import { parseAc } from "./ac-parser.js";
+import { logger } from "../utils/logger.js";
+const VAGUE_TERMS = [
+    "apropriado", "appropriate", "adequado", "adequate",
+    "rápido", "fast", "bom", "good", "bonito", "nice",
+    "eficiente", "efficient", "robusto", "robust",
+    "escalável", "scalable", "intuitivo", "intuitive",
+    "fácil", "easy", "simples", "simple",
+    "melhor", "better", "ótimo", "great",
+    "etc", "e outros", "and more",
+];
+const IMPLEMENTATION_KEYWORDS = [
+    "sql", "query", "endpoint", "api call", "function",
+    "class", "method", "variable", "database", "table",
+    "column", "redis", "queue", "cron",
+];
+export function validateAcQuality(doc, nodeId, all) {
+    const { nodes } = doc;
+    const targetNodes = selectTargetNodes(nodes, nodeId, all);
+    const reports = [];
+    for (const node of targetNodes) {
+        const acs = node.acceptanceCriteria ?? [];
+        if (acs.length === 0)
+            continue;
+        const parsedAcs = acs.map((ac) => parseAc(ac));
+        const investChecks = runInvestChecks(node, parsedAcs);
+        const vagueTerms = detectVagueTerms(acs);
+        const passedChecks = investChecks.filter((c) => c.passed).length;
+        const score = investChecks.length > 0
+            ? Math.round((passedChecks / investChecks.length) * 100)
+            : 0;
+        reports.push({
+            nodeId: node.id,
+            title: node.title,
+            score,
+            parsedAcs,
+            investChecks,
+            vagueTerms,
+        });
+    }
+    const overallScore = reports.length > 0
+        ? Math.round(reports.reduce((sum, r) => sum + r.score, 0) / reports.length)
+        : 0;
+    const summary = reports.length > 0
+        ? `AC Quality: ${overallScore}/100 across ${reports.length} nodes. ${reports.filter((r) => r.score >= 80).length} nodes with good AC quality.`
+        : "Nenhum node com acceptance criteria encontrado.";
+    logger.info("ac-validator", { nodeCount: reports.length, overallScore });
+    return { nodes: reports, overallScore, summary };
+}
+function selectTargetNodes(nodes, nodeId, all) {
+    if (nodeId) {
+        const node = nodes.find((n) => n.id === nodeId);
+        return node ? [node] : [];
+    }
+    if (all) {
+        return nodes.filter((n) => (n.type === "task" || n.type === "subtask") &&
+            n.acceptanceCriteria &&
+            n.acceptanceCriteria.length > 0);
+    }
+    // Default: all tasks with AC
+    return nodes.filter((n) => (n.type === "task" || n.type === "subtask") &&
+        n.acceptanceCriteria &&
+        n.acceptanceCriteria.length > 0);
+}
+function runInvestChecks(node, parsedAcs) {
+    const checks = [];
+    const allText = (node.acceptanceCriteria ?? []).join(" ").toLowerCase();
+    // I — Independent
+    const hasInternalRefs = /ac\s*\d|critério\s*\d|criterion\s*\d/i.test(allText);
+    checks.push({
+        criterion: "Independent",
+        passed: !hasInternalRefs,
+        details: hasInternalRefs
+            ? "AC referencia outros critérios — deve ser independente"
+            : "AC é independente",
+    });
+    // N — Negotiable (not implementation-specific)
+    const hasImpl = IMPLEMENTATION_KEYWORDS.some((k) => allText.includes(k));
+    checks.push({
+        criterion: "Negotiable",
+        passed: !hasImpl,
+        details: hasImpl
+            ? "AC contém detalhes de implementação — deve descrever comportamento, não solução"
+            : "AC descreve comportamento, não implementação",
+    });
+    // V — Valuable (has clear outcome)
+    const hasOutcome = parsedAcs.some((p) => p.isTestable);
+    checks.push({
+        criterion: "Valuable",
+        passed: hasOutcome,
+        details: hasOutcome
+            ? "AC descreve resultado observável"
+            : "AC não descreve resultado claro — adicionar verbo de ação concreto",
+    });
+    // E — Estimable (not too vague)
+    const vagueCount = detectVagueTerms(node.acceptanceCriteria ?? []).length;
+    const isEstimable = vagueCount <= 1;
+    checks.push({
+        criterion: "Estimable",
+        passed: isEstimable,
+        details: isEstimable
+            ? "AC é específico o suficiente para estimar"
+            : `AC contém ${vagueCount} termos vagos — quantificar critérios`,
+    });
+    // S — Small (not too many steps)
+    const totalSteps = parsedAcs.reduce((sum, p) => sum + (p.steps?.length ?? 1), 0);
+    const isSmall = totalSteps <= 10;
+    checks.push({
+        criterion: "Small",
+        passed: isSmall,
+        details: isSmall
+            ? `${totalSteps} steps — tamanho adequado`
+            : `${totalSteps} steps — considerar dividir em ACs menores`,
+    });
+    // T — Testable
+    const testableCount = parsedAcs.filter((p) => p.isTestable).length;
+    const isTestable = testableCount > 0 && testableCount >= parsedAcs.length * 0.5;
+    checks.push({
+        criterion: "Testable",
+        passed: isTestable,
+        details: isTestable
+            ? `${testableCount}/${parsedAcs.length} ACs testáveis`
+            : `Apenas ${testableCount}/${parsedAcs.length} ACs são testáveis — adicionar assertions concretas`,
+    });
+    return checks;
+}
+function detectVagueTerms(acs) {
+    const allText = acs.join(" ").toLowerCase();
+    return VAGUE_TERMS.filter((term) => allText.includes(term));
+}
+//# sourceMappingURL=ac-validator.js.map

package/dist/core/analyzer/ac-validator.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * Definition of Ready — gate checklist for ANALYZE → DESIGN transition.
+ *
+ * Checks:
+ * 1. ≥1 epic or requirement
+ * 2. Tasks with acceptance criteria
+ * 3. No orphan nodes
+ * 4. No dependency cycles
+ * 5. ≥1 constraint
+ * 6. ≥1 risk identified
+ * 7. PRD quality score ≥ 60
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { ReadinessReport } from "../../schemas/analyzer-schema.js";
+export declare function checkDefinitionOfReady(doc: GraphDocument): ReadinessReport;
+//# sourceMappingURL=definition-of-ready.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition-of-ready.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/definition-of-ready.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,kCAAkC,CAAC;AAKxF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe,CA8F1E"}

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

@@ -0,0 +1,107 @@
+/**
+ * Definition of Ready — gate checklist for ANALYZE → DESIGN transition.
+ *
+ * Checks:
+ * 1. ≥1 epic or requirement
+ * 2. Tasks with acceptance criteria
+ * 3. No orphan nodes
+ * 4. No dependency cycles
+ * 5. ≥1 constraint
+ * 6. ≥1 risk identified
+ * 7. PRD quality score ≥ 60
+ */
+import { analyzeScope } from "./scope-analyzer.js";
+import { analyzePrdQuality } from "./prd-quality.js";
+import { logger } from "../utils/logger.js";
+export function checkDefinitionOfReady(doc) {
+    const { nodes } = doc;
+    const checks = [];
+    const blockers = [];
+    const warnings = [];
+    // 1. Has epics or requirements
+    const hasEpicOrReq = nodes.some((n) => n.type === "epic" || n.type === "requirement");
+    checks.push({
+        name: "has_requirements",
+        passed: hasEpicOrReq,
+        details: hasEpicOrReq
+            ? `${nodes.filter((n) => n.type === "epic" || n.type === "requirement").length} requirements/epics encontrados`
+            : "Nenhum epic ou requirement definido",
+    });
+    if (!hasEpicOrReq)
+        blockers.push("Criar pelo menos 1 epic ou requirement");
+    // 2. Tasks with AC
+    const tasks = nodes.filter((n) => n.type === "task" || n.type === "subtask");
+    const acNodes = nodes.filter((n) => n.type === "acceptance_criteria");
+    const tasksWithAc = tasks.filter((n) => n.acceptanceCriteria && n.acceptanceCriteria.length > 0);
+    const hasAc = tasksWithAc.length > 0 || acNodes.length > 0;
+    checks.push({
+        name: "has_acceptance_criteria",
+        passed: hasAc,
+        details: hasAc
+            ? `${tasksWithAc.length} tasks com AC, ${acNodes.length} AC nodes`
+            : "Nenhum acceptance criteria definido",
+    });
+    if (!hasAc && tasks.length > 0)
+        warnings.push("Definir acceptance criteria para as tasks");
+    // 3. No orphans
+    const scope = analyzeScope(doc);
+    const noOrphans = scope.orphans.length === 0;
+    checks.push({
+        name: "no_orphans",
+        passed: noOrphans,
+        details: noOrphans
+            ? "Nenhum nó órfão detectado"
+            : `${scope.orphans.length} nós órfãos: ${scope.orphans.map((o) => o.id).join(", ")}`,
+    });
+    if (!noOrphans)
+        warnings.push(`Resolver ${scope.orphans.length} nós órfãos`);
+    // 4. No cycles
+    const noCycles = scope.cycles.length === 0;
+    checks.push({
+        name: "no_cycles",
+        passed: noCycles,
+        details: noCycles
+            ? "Nenhum ciclo de dependência"
+            : `${scope.cycles.length} ciclos detectados`,
+    });
+    if (!noCycles)
+        blockers.push("Resolver ciclos de dependência");
+    // 5. Has constraints
+    const hasConstraints = nodes.some((n) => n.type === "constraint");
+    checks.push({
+        name: "has_constraints",
+        passed: hasConstraints,
+        details: hasConstraints
+            ? `${nodes.filter((n) => n.type === "constraint").length} constraints definidas`
+            : "Nenhuma constraint definida",
+    });
+    if (!hasConstraints)
+        warnings.push("Definir restrições técnicas/negócio");
+    // 6. Has risks
+    const hasRisks = nodes.some((n) => n.type === "risk");
+    checks.push({
+        name: "has_risks",
+        passed: hasRisks,
+        details: hasRisks
+            ? `${nodes.filter((n) => n.type === "risk").length} riscos identificados`
+            : "Nenhum risco identificado",
+    });
+    if (!hasRisks)
+        warnings.push("Identificar riscos do projeto");
+    // 7. PRD quality score
+    const prdQuality = analyzePrdQuality(doc);
+    const qualityPass = prdQuality.score >= 60;
+    checks.push({
+        name: "prd_quality_score",
+        passed: qualityPass,
+        details: `PRD score: ${prdQuality.score}/100 (${prdQuality.grade}) — mínimo: 60`,
+    });
+    if (!qualityPass)
+        blockers.push(`PRD quality score ${prdQuality.score} < 60 mínimo`);
+    const readyForNextPhase = blockers.length === 0 && checks.filter((c) => !c.passed).length <= 2;
+    const passedCount = checks.filter((c) => c.passed).length;
+    const summary = `Definition of Ready: ${passedCount}/${checks.length} checks passed. ${readyForNextPhase ? "Ready para DESIGN." : "Não atende os critérios."}`;
+    logger.info("definition-of-ready", { passedCount, total: checks.length, ready: readyForNextPhase });
+    return { readyForNextPhase, checks, blockers, warnings, summary };
+}
+//# sourceMappingURL=definition-of-ready.js.map

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

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

package/dist/core/analyzer/prd-quality.d.ts

@@ -0,0 +1,14 @@
+/**
+ * PRD Quality Analyzer — scores a project graph for completeness and quality.
+ *
+ * Scoring weights:
+ * - Requirements: 25% (epics + requirements present and with descriptions)
+ * - Acceptance Criteria: 25% (tasks have AC defined)
+ * - Tasks: 20% (tasks exist, are decomposed, have estimates)
+ * - Risks: 15% (risk nodes present and assessed)
+ * - Constraints: 15% (constraint nodes defined)
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { PrdQualityReport } from "../../schemas/analyzer-schema.js";
+export declare function analyzePrdQuality(doc: GraphDocument): PrdQualityReport;
+//# sourceMappingURL=prd-quality.d.ts.map

package/dist/core/analyzer/prd-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-quality.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/prd-quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAsD,MAAM,kCAAkC,CAAC;AA0B7H,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,gBAAgB,CAwItE"}

package/dist/core/analyzer/prd-quality.js

@@ -0,0 +1,156 @@
+/**
+ * PRD Quality Analyzer — scores a project graph for completeness and quality.
+ *
+ * Scoring weights:
+ * - Requirements: 25% (epics + requirements present and with descriptions)
+ * - Acceptance Criteria: 25% (tasks have AC defined)
+ * - Tasks: 20% (tasks exist, are decomposed, have estimates)
+ * - Risks: 15% (risk nodes present and assessed)
+ * - Constraints: 15% (constraint nodes defined)
+ */
+import { logger } from "../utils/logger.js";
+const SECTION_WEIGHTS = {
+    requirements: 25,
+    acceptanceCriteria: 25,
+    tasks: 20,
+    risks: 15,
+    constraints: 15,
+};
+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";
+}
+function assessQuality(ratio) {
+    if (ratio <= 0)
+        return "missing";
+    if (ratio < 0.4)
+        return "weak";
+    if (ratio < 0.7)
+        return "adequate";
+    return "strong";
+}
+export function analyzePrdQuality(doc) {
+    const { nodes } = doc;
+    const sections = [];
+    // ── Requirements (epics + requirements) ──
+    const reqNodes = nodes.filter((n) => n.type === "epic" || n.type === "requirement");
+    const reqWithDesc = reqNodes.filter((n) => n.description && n.description.trim().length > 0);
+    const reqRatio = reqNodes.length > 0 ? reqWithDesc.length / reqNodes.length : 0;
+    const reqQuality = assessQuality(reqNodes.length > 0 ? (reqNodes.length >= 1 ? Math.min(1, reqRatio + 0.3) : 0) : 0);
+    const reqIssues = [];
+    const reqSuggestions = [];
+    if (reqNodes.length === 0) {
+        reqIssues.push("Nenhum epic ou requirement definido");
+        reqSuggestions.push("Criar pelo menos 1 epic descrevendo o escopo do projeto");
+    }
+    if (reqNodes.length > 0 && reqWithDesc.length < reqNodes.length) {
+        reqIssues.push(`${reqNodes.length - reqWithDesc.length} requirements sem descrição`);
+        reqSuggestions.push("Adicionar descrição a todos os requirements para clareza");
+    }
+    sections.push({
+        name: "requirements",
+        quality: reqQuality,
+        issues: reqIssues,
+        suggestions: reqSuggestions,
+    });
+    // ── Acceptance Criteria ──
+    const tasks = nodes.filter((n) => n.type === "task" || n.type === "subtask");
+    const acNodes = nodes.filter((n) => n.type === "acceptance_criteria");
+    const tasksWithAc = tasks.filter((n) => n.acceptanceCriteria && n.acceptanceCriteria.length > 0);
+    const acTotal = tasksWithAc.length + acNodes.length;
+    const acRatio = tasks.length > 0 ? Math.min(1, acTotal / tasks.length) : (acNodes.length > 0 ? 0.5 : 0);
+    const acQuality = assessQuality(acRatio);
+    const acIssues = [];
+    const acSuggestions = [];
+    if (acTotal === 0) {
+        acIssues.push("Nenhum critério de aceitação definido");
+        acSuggestions.push("Definir AC para cada task (Given/When/Then ou checklist)");
+    }
+    else if (tasks.length > 0 && tasksWithAc.length < tasks.length && acNodes.length === 0) {
+        acIssues.push(`${tasks.length - tasksWithAc.length} tasks sem acceptance criteria`);
+        acSuggestions.push("Garantir que toda task tenha AC testável");
+    }
+    sections.push({
+        name: "acceptanceCriteria",
+        quality: acQuality,
+        issues: acIssues,
+        suggestions: acSuggestions,
+    });
+    // ── Tasks ──
+    const tasksWithEstimate = tasks.filter((n) => n.estimateMinutes || n.xpSize);
+    const taskRatio = tasks.length > 0 ? Math.min(1, tasksWithEstimate.length / tasks.length) : 0;
+    const taskQuality = assessQuality(tasks.length > 0 ? Math.min(1, (tasks.length >= 1 ? 0.5 : 0) + taskRatio * 0.5) : 0);
+    const taskIssues = [];
+    const taskSuggestions = [];
+    if (tasks.length === 0) {
+        taskIssues.push("Nenhuma task definida");
+        taskSuggestions.push("Decompor requirements em tasks executáveis");
+    }
+    if (tasks.length > 0 && tasksWithEstimate.length < tasks.length) {
+        taskIssues.push(`${tasks.length - tasksWithEstimate.length} tasks sem estimativa`);
+        taskSuggestions.push("Adicionar xpSize ou estimateMinutes a todas as tasks");
+    }
+    sections.push({
+        name: "tasks",
+        quality: taskQuality,
+        issues: taskIssues,
+        suggestions: taskSuggestions,
+    });
+    // ── Risks ──
+    const riskNodes = nodes.filter((n) => n.type === "risk");
+    const riskQuality = assessQuality(riskNodes.length > 0 ? Math.min(1, riskNodes.length / 2) : 0);
+    const riskIssues = [];
+    const riskSuggestions = [];
+    if (riskNodes.length === 0) {
+        riskIssues.push("Nenhum risco identificado");
+        riskSuggestions.push("Identificar pelo menos 1-2 riscos técnicos ou de negócio");
+    }
+    sections.push({
+        name: "risks",
+        quality: riskQuality,
+        issues: riskIssues,
+        suggestions: riskSuggestions,
+    });
+    // ── Constraints ──
+    const constraintNodes = nodes.filter((n) => n.type === "constraint");
+    const constraintQuality = assessQuality(constraintNodes.length > 0 ? Math.min(1, constraintNodes.length / 2) : 0);
+    const constraintIssues = [];
+    const constraintSuggestions = [];
+    if (constraintNodes.length === 0) {
+        constraintIssues.push("Nenhuma restrição definida");
+        constraintSuggestions.push("Definir restrições técnicas (stack, performance, compatibilidade)");
+    }
+    sections.push({
+        name: "constraints",
+        quality: constraintQuality,
+        issues: constraintIssues,
+        suggestions: constraintSuggestions,
+    });
+    // ── Final score ──
+    const qualityToScore = {
+        missing: 0,
+        weak: 33,
+        adequate: 66,
+        strong: 100,
+    };
+    let totalScore = 0;
+    for (const section of sections) {
+        const weight = SECTION_WEIGHTS[section.name] ?? 0;
+        totalScore += (qualityToScore[section.quality] * weight) / 100;
+    }
+    const score = Math.round(totalScore);
+    const grade = scoreToGrade(score);
+    const hasCriticalMissing = sections.some((s) => s.quality === "missing" && (s.name === "requirements" || s.name === "acceptanceCriteria"));
+    const readyForDesign = score >= 60 && !hasCriticalMissing;
+    const summary = `PRD Quality: ${grade} (${score}/100). ${readyForDesign ? "Pronto para DESIGN." : "Não atende os critérios mínimos para avançar."}`;
+    logger.info("prd-quality", { score, grade, readyForDesign });
+    return { score, grade, sections, readyForDesign, summary };
+}
+//# sourceMappingURL=prd-quality.js.map

package/dist/core/analyzer/prd-quality.js.map

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

package/dist/core/analyzer/risk-assessment.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Risk Assessment — evaluates risk nodes using probability × impact scoring.
+ *
+ * Heuristics:
+ * - Keywords in title/description drive automatic probability/impact scoring
+ * - Mitigation status: mitigated if child task is done, partial if in_progress
+ */
+import type { GraphDocument } from "../graph/graph-types.js";
+import type { RiskMatrix } from "../../schemas/analyzer-schema.js";
+export declare function assessRisks(doc: GraphDocument): RiskMatrix;
+//# sourceMappingURL=risk-assessment.d.ts.map

package/dist/core/analyzer/risk-assessment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-assessment.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/risk-assessment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,kCAAkC,CAAC;AA2BzF,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAsD1D"}