@aaronsb/kg-cli 0.6.6 → 0.7.0

package/dist/mcp/formatters/document.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Document formatters (ADR-084)
+ */
+/**
+ * Format document search results (ADR-084)
+ */
+export declare function formatDocumentSearchResults(result: any): string;
+/**
+ * Format document list (ADR-084)
+ */
+export declare function formatDocumentList(result: any): string;
+/**
+ * Format document content (ADR-084)
+ */
+export declare function formatDocumentContent(result: any): string;
+/**
+ * Format document concepts (ADR-084)
+ */
+export declare function formatDocumentConcepts(result: any): string;
+/**
+ * Format document concepts with full details (ADR-084)
+ * Used when include_details=true - fetches all concept info in one call
+ */
+export declare function formatDocumentConceptsDetailed(docResult: any, conceptDetails: any[]): string;
+//# sourceMappingURL=document.d.ts.map

package/dist/mcp/formatters/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/mcp/formatters/document.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAgC/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAuBtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAyBzD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAyB1D;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,MAAM,CA+D5F"}

package/dist/mcp/formatters/document.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * Document formatters (ADR-084)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDocumentSearchResults = formatDocumentSearchResults;
+exports.formatDocumentList = formatDocumentList;
+exports.formatDocumentContent = formatDocumentContent;
+exports.formatDocumentConcepts = formatDocumentConcepts;
+exports.formatDocumentConceptsDetailed = formatDocumentConceptsDetailed;
+const utils_js_1 = require("./utils.js");
+/**
+ * Format document search results (ADR-084)
+ */
+function formatDocumentSearchResults(result) {
+    let output = `# Document Search: "${result.query || 'documents'}"\n\n`;
+    output += `Found ${result.total_matches} document(s)\n\n`;
+    if (result.documents.length === 0) {
+        output += 'No documents found matching this query.\n';
+        return output;
+    }
+    result.documents.forEach((doc, i) => {
+        output += `## ${i + 1}. ${doc.filename}\n\n`;
+        output += `Document ID: ${doc.document_id}\n`;
+        output += `Ontology: ${doc.ontology}\n`;
+        output += `Similarity: ${(doc.best_similarity * 100).toFixed(1)}%\n`;
+        output += `Source Chunks: ${doc.source_count}\n`;
+        if (doc.concept_ids && doc.concept_ids.length > 0) {
+            const conceptPreview = doc.concept_ids.slice(0, 5).join(', ');
+            const more = doc.concept_ids.length > 5 ? ` (+${doc.concept_ids.length - 5} more)` : '';
+            output += `Concepts: ${conceptPreview}${more}\n`;
+        }
+        output += '\n';
+    });
+    // Usage hints
+    output += '## Next Steps\n\n';
+    output += '- Use `document` tool with action "show" to view document content\n';
+    output += '- Use `document` tool with action "concepts" to see all extracted concepts\n';
+    output += '- Use `concept` tool to explore individual concepts in detail\n';
+    return output;
+}
+/**
+ * Format document list (ADR-084)
+ */
+function formatDocumentList(result) {
+    let output = `# Documents\n\n`;
+    output += `Showing ${result.documents.length} of ${result.total} documents\n\n`;
+    if (result.documents.length === 0) {
+        output += 'No documents found.\n';
+        return output;
+    }
+    result.documents.forEach((doc, i) => {
+        output += `${i + 1}. **${doc.filename}**\n`;
+        output += `   - ID: ${doc.document_id.substring(0, 50)}...\n`;
+        output += `   - Ontology: ${doc.ontology}\n`;
+        output += `   - Type: ${doc.content_type || 'document'}\n`;
+        output += `   - Sources: ${doc.source_count}, Concepts: ${doc.concept_count}\n`;
+        output += '\n';
+    });
+    if (result.total > result.documents.length) {
+        output += `Use offset=${result.offset + result.documents.length} to see more.\n`;
+    }
+    return output;
+}
+/**
+ * Format document content (ADR-084)
+ */
+function formatDocumentContent(result) {
+    let output = `# Document Content\n\n`;
+    output += `Type: ${result.content_type}\n`;
+    output += `Chunks: ${result.chunks.length}\n\n`;
+    if (result.content_type === 'image') {
+        if (result.content.prose) {
+            output += '## Image Description\n\n';
+            output += result.content.prose + '\n\n';
+        }
+        if (result.content.image) {
+            output += `[Image data: ${result.content.image.length} bytes base64]\n`;
+        }
+    }
+    else {
+        if (result.content.document) {
+            output += '## Content\n\n';
+            output += result.content.document + '\n';
+        }
+        else if (result.content.error) {
+            output += `Error: ${result.content.error}\n`;
+        }
+        else {
+            output += 'No content available.\n';
+        }
+    }
+    return output;
+}
+/**
+ * Format document concepts (ADR-084)
+ */
+function formatDocumentConcepts(result) {
+    let output = `# Concepts: ${result.filename}\n\n`;
+    output += `Document: ${result.document_id}\n`;
+    output += `Total: ${result.total} concept(s)\n\n`;
+    if (result.concepts.length === 0) {
+        output += 'No concepts found for this document.\n';
+        return output;
+    }
+    result.concepts.forEach((concept, i) => {
+        output += `${i + 1}. **${concept.name}**\n`;
+        output += `   - ID: ${concept.concept_id}\n`;
+        output += `   - Source: ${concept.source_id}\n`;
+        output += `   - Instances: ${concept.instance_count}\n`;
+        output += '\n';
+    });
+    // Usage hints
+    output += '## Next Steps\n\n';
+    output += '- Use `concept` tool with action "details" for full concept information\n';
+    output += '- Use `concept` tool with action "connect" to find relationships between concepts\n';
+    output += '- Or use `include_details: true` to get full details in one call\n';
+    return output;
+}
+/**
+ * Format document concepts with full details (ADR-084)
+ * Used when include_details=true - fetches all concept info in one call
+ */
+function formatDocumentConceptsDetailed(docResult, conceptDetails) {
+    let output = `# Concepts: ${docResult.filename}\n\n`;
+    output += `Document: ${docResult.document_id}\n`;
+    output += `Total: ${conceptDetails.length} unique concept(s)\n\n`;
+    if (conceptDetails.length === 0) {
+        output += 'No concepts found for this document.\n';
+        return output;
+    }
+    conceptDetails.forEach((concept, i) => {
+        if (concept.error) {
+            output += `## ${i + 1}. ${concept.label}\n\n`;
+            output += `ID: ${concept.concept_id}\n`;
+            output += `Status: Failed to load\n\n`;
+            return;
+        }
+        output += `## ${i + 1}. ${concept.label}\n\n`;
+        if (concept.description) {
+            output += `${concept.description}\n\n`;
+        }
+        output += `ID: ${concept.concept_id}\n`;
+        output += `Documents: ${concept.documents?.join(', ') || 'Unknown'}\n`;
+        output += `Evidence: ${concept.instances?.length || 0} instances\n`;
+        // Grounding with confidence
+        if (concept.grounding_strength !== undefined || concept.grounding_display) {
+            const grounding = concept.grounding_display || (0, utils_js_1.formatGroundingStrength)(concept.grounding_strength);
+            output += `Grounding: ${grounding}\n`;
+        }
+        // Sample evidence (max 2)
+        if (concept.instances && concept.instances.length > 0) {
+            output += `\n### Evidence Samples\n\n`;
+            concept.instances.slice(0, 2).forEach((inst, idx) => {
+                const truncated = inst.quote.length > 120 ? inst.quote.substring(0, 120) + '...' : inst.quote;
+                output += `${idx + 1}. ${inst.document} (para ${inst.paragraph}):\n`;
+                output += `   "${truncated}"\n`;
+            });
+            if (concept.instances.length > 2) {
+                output += `   ... and ${concept.instances.length - 2} more\n`;
+            }
+        }
+        // Relationships (max 5)
+        if (concept.relationships && concept.relationships.length > 0) {
+            output += `\n### Relationships (${concept.relationships.length})\n\n`;
+            concept.relationships.slice(0, 5).forEach((rel) => {
+                const confidence = rel.confidence ? ` (${(rel.confidence * 100).toFixed(0)}%)` : '';
+                output += `${rel.rel_type} -> ${rel.to_label}${confidence}\n`;
+            });
+            if (concept.relationships.length > 5) {
+                output += `... and ${concept.relationships.length - 5} more\n`;
+            }
+        }
+        output += '\n---\n\n';
+    });
+    return output;
+}
+//# sourceMappingURL=document.js.map

package/dist/mcp/formatters/document.js.map

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

package/dist/mcp/formatters/epistemic.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Epistemic status formatters (ADR-065)
+ */
+/**
+ * Format epistemic status list (ADR-065)
+ */
+export declare function formatEpistemicStatusList(result: any): string;
+/**
+ * Format epistemic status details for a specific type (ADR-065)
+ */
+export declare function formatEpistemicStatusDetails(result: any): string;
+/**
+ * Format epistemic status measurement results (ADR-065)
+ */
+export declare function formatEpistemicStatusMeasurement(result: any): string;
+//# sourceMappingURL=epistemic.d.ts.map

package/dist/mcp/formatters/epistemic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epistemic.d.ts","sourceRoot":"","sources":["../../../src/mcp/formatters/epistemic.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CA8E7D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAiGhE;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAoEpE"}

package/dist/mcp/formatters/epistemic.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * Epistemic status formatters (ADR-065)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatEpistemicStatusList = formatEpistemicStatusList;
+exports.formatEpistemicStatusDetails = formatEpistemicStatusDetails;
+exports.formatEpistemicStatusMeasurement = formatEpistemicStatusMeasurement;
+/**
+ * Format epistemic status interpretation hint
+ */
+function formatEpistemicStatusInterpretation(status) {
+    const interpretations = {
+        'WELL_GROUNDED': 'Well-established knowledge with strong evidence support (avg grounding >0.8). Highly reliable for reasoning.',
+        'MIXED_GROUNDING': 'Variable validation - grounding ranges 0.15-0.8 (15-80% net support). Represents mixed evidence or evolving understanding.',
+        'WEAK_GROUNDING': 'Weak positive grounding 0.0-0.15 (0-15% net support). Developing evidence, emerging knowledge. Use for exploratory reasoning.',
+        'POORLY_GROUNDED': 'Weak negative grounding -0.5-0.0 (0-50% net contradiction). Uncertain, liminal knowledge. Unclear epistemic status.',
+        'CONTRADICTED': 'Strong negative grounding <-0.5 (>50% net contradiction). Refuted claims, contradicted by evidence.',
+        'HISTORICAL': 'Temporal vocabulary with past-tense markers. Important for understanding evolution of concepts over time.',
+        'INSUFFICIENT_DATA': 'Less than 3 measurements available. Need more graph data to establish epistemic status.',
+    };
+    return interpretations[status] || 'Unknown epistemic status classification.';
+}
+/**
+ * Format epistemic status list (ADR-065)
+ */
+function formatEpistemicStatusList(result) {
+    let output = '# Epistemic Status Classification\n\n';
+    output += `Total vocabulary types: ${result.total}\n\n`;
+    if (!result.types || result.types.length === 0) {
+        output += '**No epistemic status data available.**\n\n';
+        output += 'Run measurement first using the "measure" action to calculate epistemic status for all vocabulary types.\n\n';
+        output += '**What This Means:** Epistemic status reflects how well-established each relationship type is based on evidence grounding. ';
+        output += 'Without measurement, you cannot filter relationships by reliability or identify contested knowledge areas.\n';
+        return output;
+    }
+    // Add staleness header (ADR-065 Phase 2 counter-based tracking)
+    if (result.last_measurement_at) {
+        const measurementDate = new Date(result.last_measurement_at).toLocaleString();
+        output += `**Last Measurement:** ${measurementDate}\n`;
+        const delta = result.vocabulary_changes_since_measurement ?? 0;
+        let stalenessText = '';
+        if (delta === 0) {
+            stalenessText = 'No changes since measurement (fresh)';
+        }
+        else if (delta < 5) {
+            stalenessText = `${delta} vocabulary change${delta > 1 ? 's' : ''} since measurement`;
+        }
+        else if (delta < 10) {
+            stalenessText = `${delta} vocabulary changes since measurement (consider re-measuring)`;
+        }
+        else {
+            stalenessText = `${delta} vocabulary changes since measurement (re-measurement recommended)`;
+        }
+        output += `**Staleness:** ${stalenessText}\n\n`;
+    }
+    // Summary by classification
+    const classificationCounts = {};
+    result.types.forEach((type) => {
+        const status = type.epistemic_status || 'UNKNOWN';
+        classificationCounts[status] = (classificationCounts[status] || 0) + 1;
+    });
+    output += '## Classification Summary\n\n';
+    Object.entries(classificationCounts)
+        .sort((a, b) => b[1] - a[1]) // Sort by count descending
+        .forEach(([status, count]) => {
+        output += `- **${status}**: ${count} types\n`;
+    });
+    output += '\n';
+    // Detailed table (removed "Measured At" column - all types measured together)
+    output += '## Vocabulary Types\n\n';
+    output += '| Relationship Type | Status | Avg Grounding | Sampled Edges |\n';
+    output += '|-------------------|--------|---------------|---------------|\n';
+    result.types.forEach((type) => {
+        const avgGrounding = type.stats?.avg_grounding !== undefined
+            ? type.stats.avg_grounding.toFixed(3)
+            : '--';
+        const sampledEdges = type.stats?.sampled_edges !== undefined
+            ? type.stats.sampled_edges.toString()
+            : '--';
+        output += `| ${type.relationship_type} | ${type.epistemic_status} | ${avgGrounding} | ${sampledEdges} |\n`;
+    });
+    output += '\n## Interpretation Guide\n\n';
+    output += '**How to use this data:**\n';
+    output += '- **WELL_GROUNDED types** → Use for high-confidence reasoning and reliable knowledge extraction (>80% net support)\n';
+    output += '- **MIXED_GROUNDING types** → Variable validation (15-80% net support), explore dialectical patterns or uncertainty\n';
+    output += '- **WEAK_GROUNDING types** → Emerging evidence (0-15% net support), use for exploratory reasoning\n';
+    output += '- **POORLY_GROUNDED types** → Uncertain knowledge (0-50% net contradiction), unclear epistemic status\n';
+    output += '- **CONTRADICTED types** → Refuted claims (>50% net contradiction), contradicted by evidence\n';
+    output += '- **INSUFFICIENT_DATA types** → Need more document ingestion to establish epistemic patterns\n\n';
+    output += '**Next Steps:**\n';
+    output += '- Use `epistemic_status` with action "show" to get detailed statistics for a specific type\n';
+    output += '- Filter concept searches by epistemic status to curate high-confidence vs exploratory subgraphs\n';
+    output += '- Ingest more documents to move types from INSUFFICIENT_DATA to measurable classifications\n';
+    return output;
+}
+/**
+ * Format epistemic status details for a specific type (ADR-065)
+ */
+function formatEpistemicStatusDetails(result) {
+    const relType = result.relationship_type || 'Unknown';
+    const status = result.epistemic_status || 'UNKNOWN';
+    let output = `# Epistemic Status: ${relType}\n\n`;
+    output += `**Classification:** ${status}\n\n`;
+    output += `**Interpretation:** ${formatEpistemicStatusInterpretation(status)}\n\n`;
+    if (result.stats) {
+        output += '## Grounding Statistics\n\n';
+        output += `- **Average Grounding:** ${result.stats.avg_grounding.toFixed(3)} `;
+        if (result.stats.avg_grounding > 0.8) {
+            output += '(Strong support - well-established)\n';
+        }
+        else if (result.stats.avg_grounding > 0.15) {
+            output += '(Mixed validation - debated or uncertain)\n';
+        }
+        else if (result.stats.avg_grounding >= 0) {
+            output += '(Weak support - emerging or poorly grounded)\n';
+        }
+        else {
+            output += '(Contradicted - refuted or historical)\n';
+        }
+        if (result.stats.std_grounding !== undefined) {
+            output += `- **Standard Deviation:** ${result.stats.std_grounding.toFixed(3)} `;
+            if (result.stats.std_grounding > 0.3) {
+                output += '(High variance - highly contested)\n';
+            }
+            else if (result.stats.std_grounding > 0.15) {
+                output += '(Moderate variance - some disagreement)\n';
+            }
+            else {
+                output += '(Low variance - consistent validation)\n';
+            }
+        }
+        output += `- **Range:** ${result.stats.min_grounding.toFixed(3)} to ${result.stats.max_grounding.toFixed(3)}\n`;
+        output += `- **Measurements:** ${result.stats.measured_concepts} concepts sampled\n`;
+        output += `- **Sampled Edges:** ${result.stats.sampled_edges} of ${result.stats.total_edges} total\n`;
+    }
+    // Add measurement context with staleness (ADR-065 Phase 2)
+    output += '\n## Measurement Context\n\n';
+    if (result.status_measured_at) {
+        output += `- **Measured At:** ${new Date(result.status_measured_at).toLocaleString()}\n`;
+    }
+    const delta = result.vocabulary_changes_since_measurement ?? 0;
+    let stalenessText = '';
+    if (delta === 0) {
+        stalenessText = 'No changes since measurement (fresh)';
+    }
+    else if (delta < 5) {
+        stalenessText = `${delta} vocabulary change${delta > 1 ? 's' : ''} since measurement`;
+    }
+    else if (delta < 10) {
+        stalenessText = `${delta} vocabulary changes since measurement (consider re-measuring)`;
+    }
+    else {
+        stalenessText = `${delta} vocabulary changes since measurement (re-measurement recommended)`;
+    }
+    output += `- **Staleness:** ${stalenessText}\n`;
+    output += `- **Note:** Results are temporal - rerun measurement as graph evolves\n`;
+    if (result.rationale) {
+        output += `\n## Classification Rationale\n\n${result.rationale}\n`;
+    }
+    output += '\n## Practical Implications\n\n';
+    if (status === 'WELL_GROUNDED') {
+        output += '**This relationship type is highly reliable.**\n';
+        output += '- Use in high-confidence reasoning chains\n';
+        output += '- Good candidate for automated inference\n';
+        output += '- Represents well-established domain knowledge\n';
+    }
+    else if (status === 'MIXED_GROUNDING') {
+        output += '**This relationship type has variable validation.**\n';
+        output += '- Represents mixed evidence or evolving understanding\n';
+        output += '- Explore both supporting and contradicting evidence\n';
+        output += '- Good for identifying knowledge gaps or areas of uncertainty\n';
+    }
+    else if (status === 'WEAK_GROUNDING') {
+        output += '**This relationship type has emerging evidence.**\n';
+        output += '- Weak positive grounding (0.0-0.15) indicates developing knowledge\n';
+        output += '- May strengthen with more document ingestion\n';
+        output += '- Use for exploratory reasoning, but verify claims\n';
+    }
+    else if (status === 'POORLY_GROUNDED') {
+        output += '**This relationship type has uncertain validation.**\n';
+        output += '- Weak negative grounding (-0.5-0.0) indicates unclear support\n';
+        output += '- May represent liminal or contested knowledge\n';
+        output += '- Use cautiously - verify before using in reasoning\n';
+    }
+    else if (status === 'CONTRADICTED') {
+        output += '**This relationship type is contradicted by evidence.**\n';
+        output += '- May represent refuted claims or historical misconceptions\n';
+        output += '- Use cautiously - validate before using in reasoning\n';
+        output += '- Useful for understanding evolution of knowledge\n';
+    }
+    else if (status === 'INSUFFICIENT_DATA') {
+        output += '**Not enough data to establish epistemic pattern.**\n';
+        output += '- Need more documents using this relationship type\n';
+        output += '- Current measurements: <3 successful samples\n';
+        output += '- Re-measure after ingesting more content\n';
+    }
+    return output;
+}
+/**
+ * Format epistemic status measurement results (ADR-065)
+ */
+function formatEpistemicStatusMeasurement(result) {
+    let output = '# Epistemic Status Measurement Results\n\n';
+    output += `**Measured:** ${result.total_types} vocabulary types\n`;
+    output += `**Stored:** ${result.stored_count} types updated in database\n\n`;
+    if (result.classifications && Object.keys(result.classifications).length > 0) {
+        output += '## Classification Distribution\n\n';
+        Object.entries(result.classifications)
+            .sort((a, b) => b[1] - a[1]) // Sort by count descending
+            .forEach(([status, count]) => {
+            output += `- **${status}**: ${count}\n`;
+        });
+        output += '\n';
+    }
+    if (result.sample_results && result.sample_results.length > 0) {
+        output += '## Sample Results (Top 10)\n\n';
+        output += '| Type | Status | Avg Grounding | Interpretation |\n';
+        output += '|------|--------|---------------|----------------|\n';
+        result.sample_results.forEach((sample) => {
+            const avgGrounding = sample.stats?.avg_grounding !== undefined
+                ? sample.stats.avg_grounding.toFixed(3)
+                : '--';
+            let interpretation = '';
+            if (sample.epistemic_status === 'WELL_GROUNDED') {
+                interpretation = '✓ Reliable';
+            }
+            else if (sample.epistemic_status === 'MIXED_GROUNDING') {
+                interpretation = '⚠ Variable';
+            }
+            else if (sample.epistemic_status === 'WEAK_GROUNDING') {
+                interpretation = '~ Emerging';
+            }
+            else if (sample.epistemic_status === 'POORLY_GROUNDED') {
+                interpretation = '? Uncertain';
+            }
+            else if (sample.epistemic_status === 'CONTRADICTED') {
+                interpretation = '✗ Refuted';
+            }
+            else if (sample.epistemic_status === 'INSUFFICIENT_DATA') {
+                interpretation = '? Need data';
+            }
+            else {
+                interpretation = '- Other';
+            }
+            output += `| ${sample.relationship_type} | ${sample.epistemic_status} | ${avgGrounding} | ${interpretation} |\n`;
+        });
+        output += '\n';
+    }
+    output += '## What This Means\n\n';
+    output += 'Epistemic status measurement evaluates how well-established each vocabulary relationship type is based on:\n';
+    output += '1. **Grounding strength** of target concepts (evidence support)\n';
+    output += '2. **Consistency** across multiple samples (standard deviation)\n';
+    output += '3. **Sample size** (measured vs total edges)\n\n';
+    output += '**Key Insights:**\n';
+    output += '- **WELL_GROUNDED types** represent well-established knowledge patterns (>80% net support)\n';
+    output += '- **MIXED_GROUNDING types** show variable validation or mixed evidence (15-80% net support)\n';
+    output += '- **WEAK_GROUNDING types** represent emerging knowledge (0-15% net support)\n';
+    output += '- **POORLY_GROUNDED types** have uncertain validation (0-50% net contradiction)\n';
+    output += '- **CONTRADICTED types** may represent refuted claims (>50% net contradiction)\n';
+    output += '- **INSUFFICIENT_DATA types** need more document ingestion\n\n';
+    output += '**Next Actions:**\n';
+    output += '1. Review MIXED_GROUNDING types to identify knowledge gaps or dialectical patterns\n';
+    output += '2. Use WELL_GROUNDED types for high-confidence reasoning and inference\n';
+    output += '3. Investigate CONTRADICTED types to understand knowledge evolution\n';
+    output += '4. Ingest more documents to move INSUFFICIENT_DATA types to measurable states\n';
+    return output;
+}
+//# sourceMappingURL=epistemic.js.map

package/dist/mcp/formatters/epistemic.js.map

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

package/dist/mcp/formatters/graph.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Graph CRUD formatters (ADR-089 Phase 3a)
+ */
+/**
+ * Format a created/updated concept for MCP output
+ */
+export declare function formatGraphConceptResult(result: any, action: string): string;
+/**
+ * Format a created/updated edge for MCP output
+ */
+export declare function formatGraphEdgeResult(result: any, action: string): string;
+/**
+ * Format concept list for MCP output
+ */
+export declare function formatGraphConceptList(result: any): string;
+/**
+ * Format edge list for MCP output
+ */
+export declare function formatGraphEdgeList(result: any): string;
+/**
+ * Format batch create response for MCP output
+ */
+export declare function formatGraphBatchResult(result: any): string;
+/**
+ * Queue operation result type for formatter
+ */
+interface QueueOperationResult {
+    index: number;
+    status: 'ok' | 'error';
+    op: string;
+    entity: string;
+    label?: string;
+    id?: string;
+    relationship?: string;
+    count?: number;
+    total?: number;
+    matched_existing?: boolean;
+    concepts?: Array<{
+        id: string;
+        label: string;
+    }>;
+    edges?: Array<{
+        from: string;
+        type: string;
+        to: string;
+    }>;
+    error?: string;
+}
+/**
+ * Queue execution result type for formatter
+ */
+interface QueueExecutionResult {
+    results: QueueOperationResult[];
+    stopIndex: number;
+    successCount: number;
+    errorCount: number;
+}
+/**
+ * Format queue execution results for MCP output
+ */
+export declare function formatGraphQueueResult(queueResult: QueueExecutionResult, totalOperations: number): string;
+export {};
+//# sourceMappingURL=graph.d.ts.map

package/dist/mcp/formatters/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/mcp/formatters/graph.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA4B5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAqBzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CA+B1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAwBvD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAkD1D;AAED;;GAEG;AACH,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,oBAAoB;IAC5B,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,oBAAoB,EACjC,eAAe,EAAE,MAAM,GACtB,MAAM,CAoDR"}