@aaronsb/kg-cli 0.6.1

package/dist/lib/terminal-images.js

@@ -0,0 +1,268 @@
+"use strict";
+/**
+ * Terminal Image Display Utilities (ADR-057)
+ *
+ * Provides utilities for displaying images in the terminal using chafa,
+ * with fallback options and configuration support.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isChafaAvailable = isChafaAvailable;
+exports.getChafaVersion = getChafaVersion;
+exports.displayImageWithChafa = displayImageWithChafa;
+exports.displayImageBufferWithChafa = displayImageBufferWithChafa;
+exports.saveImageToFile = saveImageToFile;
+exports.detectImageFormat = detectImageFormat;
+exports.printChafaInstallInstructions = printChafaInstallInstructions;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Check if chafa is available on the system
+ * @returns true if chafa command is available
+ */
+function isChafaAvailable() {
+    try {
+        (0, child_process_1.execSync)('which chafa', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get chafa version information
+ * @returns Version string or null if not available
+ */
+function getChafaVersion() {
+    try {
+        const output = (0, child_process_1.execSync)('chafa --version', { encoding: 'utf-8' });
+        const match = output.match(/chafa version (\S+)/i);
+        return match ? match[1] : output.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Display image in terminal using chafa
+ * @param imagePath - Path to image file
+ * @param options - Chafa display options
+ * @returns true if successfully displayed, false otherwise
+ */
+function displayImageWithChafa(imagePath, options = {}) {
+    if (!isChafaAvailable()) {
+        return false;
+    }
+    // Build chafa command arguments
+    const args = [];
+    // Size options
+    const termWidth = process.stdout.columns || 80;
+    let targetWidth;
+    if (options.width) {
+        // Explicit width takes precedence
+        targetWidth = options.width;
+    }
+    else if (options.scale) {
+        // Scale factor (e.g., 0.3 for 1/3 width)
+        targetWidth = Math.floor(termWidth * options.scale);
+    }
+    else {
+        // Default: use terminal width with margin
+        targetWidth = Math.min(termWidth - 4, 120);
+    }
+    args.push('--size', `${targetWidth}x${options.height || ''}`);
+    // Alignment
+    if (options.align) {
+        args.push('--align', options.align);
+    }
+    else {
+        args.push('--align', 'left');
+    }
+    // Color mode
+    if (options.colors) {
+        if (options.colors === 'full') {
+            args.push('--colors', 'full');
+        }
+        else {
+            args.push('--colors', options.colors);
+        }
+    }
+    else {
+        // Default to 256 colors for best compatibility
+        args.push('--colors', '256');
+    }
+    // Symbol map
+    if (options.symbols) {
+        args.push('--symbols', options.symbols);
+    }
+    else {
+        // Use block symbols for better image quality
+        args.push('--symbols', 'block');
+    }
+    // Animation (for GIFs)
+    if (options.animate === false) {
+        args.push('--animate', 'off');
+    }
+    // Add image path
+    args.push(imagePath);
+    try {
+        // Execute chafa synchronously to display image
+        const result = (0, child_process_1.spawnSync)('chafa', args, {
+            stdio: 'inherit',
+            encoding: 'utf-8',
+        });
+        return result.status === 0;
+    }
+    catch (error) {
+        console.error(chalk_1.default.yellow(`Failed to display image with chafa: ${error}`));
+        return false;
+    }
+}
+/**
+ * Display image from Buffer using chafa
+ * Writes to temp file, displays, then cleans up
+ * @param imageBuffer - Image binary data
+ * @param extension - File extension (e.g., '.jpg', '.png')
+ * @param options - Chafa display options
+ * @returns true if successfully displayed
+ */
+async function displayImageBufferWithChafa(imageBuffer, extension = '.jpg', options = {}) {
+    if (!isChafaAvailable()) {
+        return false;
+    }
+    // Create temp file
+    const tmpDir = os.tmpdir();
+    const tmpFile = path.join(tmpDir, `kg-image-${Date.now()}${extension}`);
+    try {
+        // Write buffer to temp file
+        fs.writeFileSync(tmpFile, imageBuffer);
+        // Display with chafa
+        const success = displayImageWithChafa(tmpFile, options);
+        return success;
+    }
+    catch (error) {
+        console.error(chalk_1.default.yellow(`Failed to display image: ${error}`));
+        return false;
+    }
+    finally {
+        // Clean up temp file
+        try {
+            if (fs.existsSync(tmpFile)) {
+                fs.unlinkSync(tmpFile);
+            }
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+/**
+ * Save image buffer to file
+ * @param imageBuffer - Image binary data
+ * @param outputPath - Path to save image
+ * @returns true if successfully saved
+ */
+function saveImageToFile(imageBuffer, outputPath) {
+    try {
+        // Ensure directory exists
+        const dir = path.dirname(outputPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Write file
+        fs.writeFileSync(outputPath, imageBuffer);
+        return true;
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`Failed to save image: ${error}`));
+        return false;
+    }
+}
+/**
+ * Get image format from buffer by checking magic bytes
+ * @param buffer - Image binary data
+ * @returns File extension (with dot) or '.jpg' as fallback
+ */
+function detectImageFormat(buffer) {
+    if (buffer.length < 12) {
+        return '.jpg'; // Fallback
+    }
+    // Check magic bytes
+    // PNG: 89 50 4E 47 0D 0A 1A 0A
+    if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4E && buffer[3] === 0x47) {
+        return '.png';
+    }
+    // JPEG: FF D8 FF
+    if (buffer[0] === 0xFF && buffer[1] === 0xD8 && buffer[2] === 0xFF) {
+        return '.jpg';
+    }
+    // GIF: 47 49 46 38
+    if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x38) {
+        return '.gif';
+    }
+    // WebP: 52 49 46 46 ... 57 45 42 50
+    if (buffer[0] === 0x52 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x46 &&
+        buffer[8] === 0x57 && buffer[9] === 0x45 && buffer[10] === 0x42 && buffer[11] === 0x50) {
+        return '.webp';
+    }
+    // BMP: 42 4D
+    if (buffer[0] === 0x42 && buffer[1] === 0x4D) {
+        return '.bmp';
+    }
+    return '.jpg'; // Fallback to JPEG
+}
+/**
+ * Print chafa installation instructions
+ */
+function printChafaInstallInstructions() {
+    console.log(chalk_1.default.yellow('\n⚠️  chafa is not installed\n'));
+    console.log('To display images inline in the terminal, install chafa:\n');
+    console.log(chalk_1.default.cyan('  # macOS'));
+    console.log(chalk_1.default.gray('  brew install chafa\n'));
+    console.log(chalk_1.default.cyan('  # Ubuntu/Debian'));
+    console.log(chalk_1.default.gray('  sudo apt install chafa\n'));
+    console.log(chalk_1.default.cyan('  # Fedora'));
+    console.log(chalk_1.default.gray('  sudo dnf install chafa\n'));
+    console.log(chalk_1.default.cyan('  # Arch Linux'));
+    console.log(chalk_1.default.gray('  sudo pacman -S chafa\n'));
+    console.log('You can still use --download to save images to a file.\n');
+}
+//# sourceMappingURL=terminal-images.js.map

package/dist/lib/terminal-images.js.map

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

package/dist/mcp/formatters.d.ts

@@ -0,0 +1,100 @@
+/**
+ * MCP Server Markdown Formatters
+ *
+ * Formats API responses as markdown-style text for AI agents.
+ * Optimized for token efficiency - minimal Unicode, plain structure.
+ */
+import type { SearchResponse, ConceptDetailsResponse, FindConnectionBySearchResponse, RelatedConceptsResponse, JobStatus, SourceSearchResponse } from '../types/index.js';
+/**
+ * Format search results as markdown
+ */
+export declare function formatSearchResults(result: SearchResponse): string;
+/**
+ * Format concept details as markdown
+ * @param concept - The concept details to format
+ * @param truncateEvidence - Whether to truncate full_text context to 200 chars (default: true)
+ */
+export declare function formatConceptDetails(concept: ConceptDetailsResponse, truncateEvidence?: boolean): string;
+/**
+ * Format connection paths as markdown
+ * Enhanced to match CLI output with full concept details, evidence samples, and path visualization
+ */
+export declare function formatConnectionPaths(result: FindConnectionBySearchResponse): string;
+/**
+ * Format related concepts as markdown
+ */
+export declare function formatRelatedConcepts(result: RelatedConceptsResponse): string;
+/**
+ * Format job list as markdown (token-efficient summary view)
+ */
+export declare function formatJobList(jobs: JobStatus[]): string;
+/**
+ * Format job status as markdown (token-efficient)
+ */
+export declare function formatJobStatus(job: JobStatus): string;
+/**
+ * Format inspect-file result as markdown
+ */
+export declare function formatInspectFileResult(result: any): string;
+/**
+ * Format ingest-file result as markdown
+ */
+export declare function formatIngestFileResult(result: any): string;
+/**
+ * Format ingest-directory result as markdown
+ */
+export declare function formatIngestDirectoryResult(result: any): string;
+export declare function formatDatabaseStats(result: any): string;
+export declare function formatDatabaseInfo(result: any): string;
+export declare function formatDatabaseHealth(result: any): string;
+export declare function formatSystemStatus(result: any): string;
+export declare function formatApiHealth(result: any): string;
+export declare function formatMcpAllowedPaths(result: any): string;
+/**
+ * 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;
+/**
+ * Format source search results as markdown (ADR-068 Phase 5)
+ *
+ * Optimized for MCP/AI consumption - shows matched chunks with offsets
+ * and related concepts extracted from those sources.
+ */
+export declare function formatSourceSearchResults(result: SourceSearchResponse): string;
+/**
+ * Format polarity axis analysis results as markdown (ADR-070)
+ *
+ * Optimized for MCP/AI consumption - shows axis definition, projections,
+ * statistics, and grounding correlation patterns.
+ */
+export declare function formatPolarityAxisResults(result: any): string;
+/**
+ * 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=formatters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/mcp/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,8BAA8B,EAC9B,uBAAuB,EACvB,SAAS,EACT,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAwD3B;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA6DlE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,GAAE,OAAc,GAAG,MAAM,CAuE9G;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,CA8FpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAuB7E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAwGvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAiHtD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAmC3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAkE1D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAwD/D;AAMD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAwBvD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAiBtD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAmBxD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CA6BtD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAkBnD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAkDzD;AAkBD;;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;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAuD9E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAgI7D;AAED;;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"}