@aaronsb/kg-cli 0.6.6 → 0.7.0

package/dist/mcp/formatters/utils.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Shared utilities for MCP formatters
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatGroundingStrength = formatGroundingStrength;
+exports.formatGroundingWithConfidence = formatGroundingWithConfidence;
+/**
+ * Format grounding strength as text (token-efficient)
+ * This is the fallback when grounding_display is not available.
+ */
+function formatGroundingStrength(grounding) {
+    const groundingValue = grounding.toFixed(3);
+    const percentValue = grounding * 100;
+    // Use ≈ symbol when value is very close to zero but not exactly zero
+    const groundingPercent = (Math.abs(percentValue) < 0.1 && percentValue !== 0)
+        ? `≈${percentValue >= 0 ? '0' : '-0'}`
+        : percentValue.toFixed(0);
+    let level;
+    if (grounding >= 0.7)
+        level = 'Strong';
+    else if (grounding >= 0.3)
+        level = 'Moderate';
+    else if (grounding >= 0)
+        level = 'Weak';
+    else if (grounding >= -0.3)
+        level = 'Negative';
+    else
+        level = 'Contradicted';
+    return `${level} (${groundingValue}, ${groundingPercent}%)`;
+}
+/**
+ * Format grounding with confidence-awareness (grounding × confidence two-dimensional model)
+ *
+ * Uses grounding_display when available (categorical label from API).
+ * Includes numeric confidence_score alongside the label for quantitative insight.
+ * Falls back to raw grounding score display for backwards compatibility.
+ */
+function formatGroundingWithConfidence(grounding, groundingDisplay, confidenceScore = null) {
+    // Format confidence score as percentage if available
+    const confScoreStr = confidenceScore !== undefined && confidenceScore !== null
+        ? ` [${(confidenceScore * 100).toFixed(0)}% conf]`
+        : '';
+    // If we have a grounding_display label from the API, use it directly
+    if (groundingDisplay) {
+        return `${groundingDisplay}${confScoreStr}`;
+    }
+    // Fall back to raw grounding score display if available
+    if (grounding !== undefined && grounding !== null) {
+        return formatGroundingStrength(grounding);
+    }
+    // No grounding information available
+    return 'Unexplored';
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/mcp/formatters/utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAMH,0DAiBC;AASD,sEAsBC;AApDD;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,SAAiB;IACvD,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,SAAS,GAAG,GAAG,CAAC;IAErC,qEAAqE;IACrE,MAAM,gBAAgB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,IAAI,YAAY,KAAK,CAAC,CAAC;QAC3E,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;QACtC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAE5B,IAAI,KAAa,CAAC;IAClB,IAAI,SAAS,IAAI,GAAG;QAAE,KAAK,GAAG,QAAQ,CAAC;SAClC,IAAI,SAAS,IAAI,GAAG;QAAE,KAAK,GAAG,UAAU,CAAC;SACzC,IAAI,SAAS,IAAI,CAAC;QAAE,KAAK,GAAG,MAAM,CAAC;SACnC,IAAI,SAAS,IAAI,CAAC,GAAG;QAAE,KAAK,GAAG,UAAU,CAAC;;QAC1C,KAAK,GAAG,cAAc,CAAC;IAE5B,OAAO,GAAG,KAAK,KAAK,cAAc,KAAK,gBAAgB,IAAI,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,6BAA6B,CAC3C,SAAoC,EACpC,gBAA2C,EAC3C,kBAA6C,IAAI;IAEjD,qDAAqD;IACrD,MAAM,YAAY,GAAG,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,IAAI;QAC5E,CAAC,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAClD,CAAC,CAAC,EAAE,CAAC;IAEP,qEAAqE;IACrE,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,GAAG,gBAAgB,GAAG,YAAY,EAAE,CAAC;IAC9C,CAAC;IAED,wDAAwD;IACxD,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED,qCAAqC;IACrC,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/mcp/graph-operations.d.ts

@@ -0,0 +1,242 @@
+/**
+ * GraphOperationExecutor - Handles graph CRUD operations for MCP tool
+ * ADR-089 Phase 3a refactoring: Extracted from mcp-server.ts handler
+ */
+import type { KnowledgeGraphClient } from '../api/client';
+import type { MatchingMode, ConceptCRUDResponse, EdgeResponse, ConceptListCRUDResponse, EdgeListResponse } from '../types';
+/**
+ * Entity types for graph operations.
+ */
+export type GraphEntity = 'concept' | 'edge';
+/**
+ * Action types for graph operations.
+ */
+export type GraphAction = 'create' | 'edit' | 'delete' | 'list';
+/**
+ * Base operation result with status.
+ */
+export interface OperationResult {
+    success: boolean;
+    error?: string;
+}
+/**
+ * Result from concept create/edit/delete operations.
+ */
+export interface ConceptOperationResult extends OperationResult {
+    data?: ConceptCRUDResponse & {
+        from_label?: string;
+        to_label?: string;
+    };
+}
+/**
+ * Result from edge create/edit/delete operations.
+ */
+export interface EdgeOperationResult extends OperationResult {
+    data?: EdgeResponse & {
+        from_label?: string;
+        to_label?: string;
+    };
+}
+/**
+ * Result from concept list operation.
+ */
+export interface ConceptListResult extends OperationResult {
+    data?: ConceptListCRUDResponse;
+}
+/**
+ * Result from edge list operation.
+ */
+export interface EdgeListResult extends OperationResult {
+    data?: EdgeListResponse;
+}
+/**
+ * Parameters for creating a concept.
+ */
+export interface CreateConceptParams {
+    label: string;
+    ontology: string;
+    description?: string;
+    search_terms?: string[];
+    matching_mode?: MatchingMode;
+}
+/**
+ * Parameters for creating an edge.
+ */
+export interface CreateEdgeParams {
+    from_concept_id?: string;
+    from_label?: string;
+    to_concept_id?: string;
+    to_label?: string;
+    relationship_type: string;
+    category?: string;
+    confidence?: number;
+}
+/**
+ * Parameters for editing a concept.
+ */
+export interface EditConceptParams {
+    concept_id: string;
+    label?: string;
+    description?: string;
+    search_terms?: string[];
+}
+/**
+ * Parameters for editing an edge.
+ */
+export interface EditEdgeParams {
+    from_concept_id?: string;
+    from_label?: string;
+    to_concept_id?: string;
+    to_label?: string;
+    relationship_type: string;
+    confidence?: number;
+    category?: string;
+}
+/**
+ * Parameters for deleting a concept.
+ */
+export interface DeleteConceptParams {
+    concept_id: string;
+    cascade?: boolean;
+}
+/**
+ * Parameters for deleting an edge.
+ */
+export interface DeleteEdgeParams {
+    from_concept_id?: string;
+    from_label?: string;
+    to_concept_id?: string;
+    to_label?: string;
+    relationship_type: string;
+}
+/**
+ * Parameters for listing concepts.
+ */
+export interface ListConceptsParams {
+    ontology?: string;
+    label_contains?: string;
+    creation_method?: string;
+    offset?: number;
+    limit?: number;
+}
+/**
+ * Parameters for listing edges.
+ */
+export interface ListEdgesParams {
+    from_concept_id?: string;
+    from_label?: string;
+    to_concept_id?: string;
+    to_label?: string;
+    relationship_type?: string;
+    category?: string;
+    source?: string;
+    offset?: number;
+    limit?: number;
+}
+/**
+ * Queue operation definition.
+ */
+export interface QueueOperation {
+    op: GraphAction;
+    entity: GraphEntity;
+    label?: string;
+    ontology?: string;
+    description?: string;
+    search_terms?: string[];
+    matching_mode?: MatchingMode;
+    concept_id?: string;
+    cascade?: boolean;
+    label_contains?: string;
+    creation_method?: string;
+    from_concept_id?: string;
+    from_label?: string;
+    to_concept_id?: string;
+    to_label?: string;
+    relationship_type?: string;
+    category?: string;
+    confidence?: number;
+    source?: string;
+    offset?: number;
+    limit?: number;
+}
+/**
+ * Result from a single queue operation.
+ */
+export 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;
+}
+/**
+ * Result from queue execution.
+ */
+export interface QueueExecutionResult {
+    results: QueueOperationResult[];
+    stopIndex: number;
+    successCount: number;
+    errorCount: number;
+}
+/**
+ * Executes graph CRUD operations with semantic resolution support.
+ */
+export declare class GraphOperationExecutor {
+    private client;
+    constructor(client: KnowledgeGraphClient);
+    /**
+     * Resolve a concept label to its ID using semantic search.
+     * @param label - The concept label to resolve
+     * @returns The concept ID
+     * @throws Error if no confident match found
+     */
+    resolveConceptByLabel(label: string): Promise<string>;
+    /**
+     * Resolve concept ID from params, using label resolution if needed.
+     * @param id - Explicit concept ID (optional)
+     * @param label - Concept label for resolution (optional)
+     * @param fieldName - Name of the field for error messages
+     * @param throwOnMissing - Whether to throw if neither ID nor label provided
+     * @returns The resolved concept ID or undefined
+     */
+    resolveConceptId(id: string | undefined, label: string | undefined, fieldName: string, throwOnMissing?: boolean): Promise<string | undefined>;
+    /**
+     * Resolve concept ID for list operations (silently skip on error).
+     */
+    resolveConceptIdForList(id: string | undefined, label: string | undefined): Promise<string | undefined>;
+    createConcept(params: CreateConceptParams): Promise<ConceptOperationResult>;
+    createEdge(params: CreateEdgeParams): Promise<EdgeOperationResult>;
+    listConcepts(params: ListConceptsParams): Promise<ConceptListResult>;
+    listEdges(params: ListEdgesParams): Promise<EdgeListResult>;
+    editConcept(params: EditConceptParams): Promise<ConceptOperationResult>;
+    editEdge(params: EditEdgeParams): Promise<EdgeOperationResult>;
+    deleteConcept(params: DeleteConceptParams): Promise<ConceptOperationResult>;
+    deleteEdge(params: DeleteEdgeParams): Promise<EdgeOperationResult>;
+    /**
+     * Execute a queue of operations sequentially.
+     * @param operations - Array of operations to execute
+     * @param continueOnError - Whether to continue after errors
+     * @returns Queue execution result with all operation results
+     */
+    executeQueue(operations: QueueOperation[], continueOnError?: boolean): Promise<QueueExecutionResult>;
+    /**
+     * Execute a single queue operation.
+     */
+    private executeSingleOperation;
+}
+//# sourceMappingURL=graph-operations.d.ts.map

package/dist/mcp/graph-operations.d.ts.map

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