@aaronsb/kg-cli 0.6.6 → 0.7.0

package/dist/cli/batch.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * Batch Operations Commands (ADR-089 Phase 1b)
+ *
+ * Import batch JSON files containing concepts and edges.
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchCommand = void 0;
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const client_1 = require("../api/client");
+const colors = __importStar(require("./colors"));
+const colors_1 = require("./colors");
+const help_formatter_1 = require("./help-formatter");
+const interactive_1 = require("../lib/interactive");
+exports.batchCommand = (0, help_formatter_1.setCommandHelp)(new commander_1.Command('batch'), 'Batch graph operations', 'Batch operations for creating concepts and edges in a single transaction. Import JSON files that define concepts and their relationships. All operations are atomic - if any item fails, the entire batch is rolled back.')
+    .alias('b')
+    .showHelpAfterError('(add --help for additional information)')
+    .showSuggestionAfterError()
+    .addCommand(new commander_1.Command('create')
+    .description('Import a batch JSON file to create concepts and edges atomically. The JSON must contain ontology, concepts array, and optional edges array. All operations succeed or all are rolled back.')
+    .argument('<file>', 'Path to batch JSON file')
+    .option('--json', 'Output result as JSON')
+    .option('--dry-run', 'Validate without creating (not yet implemented)')
+    .action(async (file, options) => {
+    try {
+        // Read and parse the JSON file
+        if (!fs.existsSync(file)) {
+            console.error(colors.status.error(`✗ File not found: ${file}`));
+            process.exit(1);
+        }
+        const content = fs.readFileSync(file, 'utf-8');
+        let request;
+        try {
+            request = JSON.parse(content);
+        }
+        catch (parseError) {
+            console.error(colors.status.error('✗ Invalid JSON file'));
+            console.error(colors.status.error(parseError.message));
+            process.exit(1);
+        }
+        // Basic validation
+        if (!request.ontology) {
+            console.error(colors.status.error('✗ Missing required field: ontology'));
+            process.exit(1);
+        }
+        if ((!request.concepts || request.concepts.length === 0) &&
+            (!request.edges || request.edges.length === 0)) {
+            console.error(colors.status.error('✗ Batch must contain at least one concept or edge'));
+            process.exit(1);
+        }
+        // Check for edge references to concepts not in the batch
+        if (request.edges && request.edges.length > 0 && request.concepts) {
+            const batchLabels = new Set(request.concepts.map((c) => c.label.toLowerCase()));
+            const unreferencedEdges = [];
+            for (const edge of request.edges) {
+                const fromInBatch = batchLabels.has(edge.from_label.toLowerCase());
+                const toInBatch = batchLabels.has(edge.to_label.toLowerCase());
+                if (!fromInBatch || !toInBatch) {
+                    const missing = [];
+                    if (!fromInBatch)
+                        missing.push(`from: "${edge.from_label}"`);
+                    if (!toInBatch)
+                        missing.push(`to: "${edge.to_label}"`);
+                    unreferencedEdges.push(`  ${edge.from_label} -[${edge.relationship_type}]-> ${edge.to_label} (${missing.join(', ')} not in batch)`);
+                }
+            }
+            if (unreferencedEdges.length > 0 && !options.json) {
+                console.log(colors.status.warning('\n⚠️  Some edges reference concepts not in this batch file:'));
+                for (const edge of unreferencedEdges.slice(0, 5)) {
+                    console.log(colors.status.dim(edge));
+                }
+                if (unreferencedEdges.length > 5) {
+                    console.log(colors.status.dim(`  ... and ${unreferencedEdges.length - 5} more`));
+                }
+                console.log(colors.status.dim('  These edges will resolve to existing concepts in the database, or fail if not found.\n'));
+            }
+        }
+        if (options.dryRun) {
+            console.log(colors.status.warning('Dry-run mode not yet implemented by API.'));
+            console.log(colors.status.info('File validation passed:'));
+            console.log(`  Ontology: ${request.ontology}`);
+            console.log(`  Concepts: ${request.concepts?.length || 0}`);
+            console.log(`  Edges: ${request.edges?.length || 0}`);
+            return;
+        }
+        const client = (0, client_1.createClientFromEnv)();
+        if (!options.json) {
+            console.log();
+            console.log(colors.ui.title('📦 Batch Import'));
+            console.log((0, colors_1.separator)());
+            console.log(`  ${colors.ui.key('File:')} ${file}`);
+            console.log(`  ${colors.ui.key('Ontology:')} ${request.ontology}`);
+            console.log(`  ${colors.ui.key('Concepts:')} ${request.concepts?.length || 0}`);
+            console.log(`  ${colors.ui.key('Edges:')} ${request.edges?.length || 0}`);
+            console.log();
+            console.log(colors.status.dim('Creating...'));
+        }
+        const result = await client.batchCreate(request);
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log();
+        console.log((0, colors_1.separator)());
+        // Show results
+        if (result.errors.length > 0) {
+            console.log(colors.status.warning('⚠️  Completed with errors:'));
+            for (const error of result.errors) {
+                console.log(`  ${colors.status.error('✗')} ${error}`);
+            }
+            console.log();
+        }
+        else {
+            console.log(colors.status.success('✓ Batch import successful'));
+        }
+        console.log(`  ${colors.ui.key('Concepts created:')} ${colors.status.success(result.concepts_created.toString())}`);
+        console.log(`  ${colors.ui.key('Concepts matched:')} ${colors.status.info(result.concepts_matched.toString())}`);
+        console.log(`  ${colors.ui.key('Edges created:')} ${colors.status.success(result.edges_created.toString())}`);
+        // Show individual results if verbose
+        if (result.concept_results.length > 0) {
+            console.log();
+            console.log(colors.ui.header('Concept Results:'));
+            for (const cr of result.concept_results) {
+                const statusIcon = cr.status === 'created' ? colors.status.success('✓') :
+                    cr.status === 'matched' ? colors.status.info('≈') :
+                        colors.status.error('✗');
+                const statusText = cr.status === 'created' ? 'created' :
+                    cr.status === 'matched' ? 'matched existing' : 'error';
+                console.log(`  ${statusIcon} ${colors.concept.label(cr.label)} - ${statusText}${cr.id ? ` (${cr.id})` : ''}`);
+                if (cr.error) {
+                    console.log(`    ${colors.status.error(cr.error)}`);
+                }
+            }
+        }
+        if (result.edge_results.length > 0) {
+            console.log();
+            console.log(colors.ui.header('Edge Results:'));
+            for (const er of result.edge_results) {
+                const statusIcon = er.status === 'created' ? colors.status.success('✓') :
+                    er.status === 'error' ? colors.status.error('✗') : '?';
+                console.log(`  ${statusIcon} ${er.label}`);
+                if (er.error) {
+                    console.log(`    ${colors.status.error(er.error)}`);
+                }
+            }
+        }
+        console.log();
+        console.log((0, colors_1.separator)());
+        // Exit with error code if there were failures
+        if (result.errors.length > 0 && result.concepts_created === 0 && result.edges_created === 0) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        (0, interactive_1.handleCliError)(error, 'Batch import failed');
+    }
+}))
+    .addCommand(new commander_1.Command('template')
+    .description('Output a template batch JSON file to stdout. Redirect to a file to customize.')
+    .option('--with-edges', 'Include example edges in template')
+    .action((options) => {
+    const template = {
+        ontology: 'my-ontology',
+        matching_mode: 'auto',
+        creation_method: 'import',
+        concepts: [
+            {
+                label: 'Example Concept A',
+                description: 'A brief description of concept A',
+                search_terms: ['alt term', 'synonym'],
+            },
+            {
+                label: 'Example Concept B',
+                description: 'A brief description of concept B',
+            },
+        ],
+    };
+    if (options.withEdges) {
+        template.edges = [
+            {
+                from_label: 'Example Concept A',
+                to_label: 'Example Concept B',
+                relationship_type: 'IMPLIES',
+                category: 'logical_truth',
+                confidence: 0.9,
+            },
+        ];
+    }
+    console.log(JSON.stringify(template, null, 2));
+}));
+//# sourceMappingURL=batch.js.map

package/dist/cli/batch.js.map

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

package/dist/cli/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyEpC,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,iBA+DtD"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6EpC,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,iBAmEtD"}

package/dist/cli/commands.js

@@ -61,6 +61,10 @@ const document_1 = require("./document");
 const artifact_1 = require("./artifact");
 const group_1 = require("./group");
 const query_def_1 = require("./query-def");
+const concept_1 = require("./concept");
+const edge_1 = require("./edge");
+const batch_1 = require("./batch");
+const storage_1 = require("./storage");
 const login_1 = require("./login");
 const logout_1 = require("./logout");
 const oauth_1 = require("./oauth");
@@ -135,12 +139,16 @@ async function registerCommands(program) {
         ontology_1.ontologyCommand,
         source_1.sourceCommand,
         vocabulary_1.vocabularyCommand,
+        concept_1.conceptCommand, // ADR-089: Concept CRUD
+        edge_1.edgeCommand, // ADR-089: Edge CRUD
+        batch_1.batchCommand, // ADR-089: Batch operations
         admin_1.adminCommand,
         polarity_1.polarityCommand,
         projection_1.projectionCommand,
         artifact_1.artifactCommand,
         group_1.groupCommand,
         query_def_1.queryDefCommand,
+        storage_1.storageCommand,
     ];
     subcommands.forEach(cmd => {
         (0, help_formatter_1.configureColoredHelp)(cmd);

package/dist/cli/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+EH,4CAmEC;AA/ID,sEAAqC;AACrC,oDAA4B;AAC5B,iDAAmC;AACnC,qDAAwD;AACxD,qCAAyC;AACzC,iCAAqC;AACrC,qCAAyC;AACzC,qCAAyC;AACzC,yCAA6C;AAC7C,yCAA6C;AAC7C,qCAAyC;AACzC,mCAAuC;AACvC,6CAAiD;AACjD,6CAAgD;AAChD,yCAA6C;AAC7C,6CAAiD;AACjD,qCAAyC;AACzC,yCAA6C;AAC7C,yCAA6C;AAC7C,mCAAuC;AACvC,2CAA8C;AAC9C,uCAA2C;AAC3C,iCAAqC;AACrC,mCAAuC;AACvC,uCAA2C;AAC3C,mCAA+C;AAC/C,qCAAiD;AACjD,mCAA+C;AAC/C,+CAAiD;AACjD,iCAA2C;AAC3C,0CAAoD;AACpD,wCAA0C;AAC1C,0CAA0C;AAE1C;;GAEG;AACH,KAAK,UAAU,UAAU;IACvB,gBAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE;QAC5B,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAG,wCAAwC;QACpF,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC;KACd,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC,CAAC;IAErG,0BAA0B;IAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,uBAAuB,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,4BAAmB,GAAE,CAAC;QACrC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,uDAAuD;IACvD,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;IAC3B,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;IAC5C,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC;IAC3I,CAAC;IAED,oBAAoB;IACpB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,sBAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,sBAAY,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,sBAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAE/D,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,aAAa;AAC9B,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,OAAgB;IACrD,sDAAsD;IACtD,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,UAAU,EAAE,CAAC;IACrB,CAAC;IAED,OAAO;SACJ,IAAI,CAAC,IAAI,CAAC;SACV,WAAW,CAAC,6DAA6D,CAAC;SAC1E,OAAO,CAAC,sBAAG,CAAC,OAAO,CAAC;SACpB,kBAAkB,CAAC,yCAAyC,CAAC;SAC7D,wBAAwB,EAAE,CAAC;IAE9B,0CAA0C;IAC1C,IAAA,qCAAoB,EAAC,OAAO,CAAC,CAAC;IAE9B,yCAAyC;IACzC,MAAM,MAAM,GAAG,IAAA,4BAAmB,GAAE,CAAC;IAErC,yCAAyC;IACzC,MAAM,WAAW,GAAG;QAClB,sBAAa;QACb,sBAAa;QACb,6BAAgB;QAChB,sBAAa;QACb,kBAAW;QACX,sBAAa;QACb,0BAAe,EAAG,2BAA2B;QAC7C,0BAAe;QACf,0BAAe;QACf,sBAAa;QACb,8BAAiB;QACjB,wBAAc,EAAI,wBAAwB;QAC1C,kBAAW,EAAO,qBAAqB;QACvC,oBAAY,EAAM,4BAA4B;QAC9C,oBAAY;QACZ,0BAAe;QACf,8BAAiB;QACjB,0BAAe;QACf,oBAAY;QACZ,2BAAe;QACf,wBAAc;KACf,CAAC;IAEF,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACxB,IAAA,qCAAoB,EAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,4DAA4D;IAC5D,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAE/B,qDAAqD;IACrD,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAE9B,kEAAkE;IAClE,MAAM,YAAY,GAAG,IAAA,8BAAgB,EAAC,OAAO,CAAC,CAAC;IAC/C,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACzB,IAAA,qCAAoB,EAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,mDAAmD;IACnD,MAAM,WAAW,GAAG,IAAA,wBAAiB,EAAC,OAAO,CAAC,CAAC;IAC/C,IAAA,qCAAoB,EAAC,WAAW,CAAC,CAAC;IAClC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC"}

package/dist/cli/concept.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Concept CRUD Commands (ADR-089 Phase 2)
+ *
+ * Direct creation, listing, and management of concepts in the knowledge graph.
+ * Supports both non-interactive (flags) and interactive (-i) modes.
+ */
+import { Command } from 'commander';
+export declare const conceptCommand: Command;
+//# sourceMappingURL=concept.d.ts.map

package/dist/cli/concept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept.d.ts","sourceRoot":"","sources":["../../src/cli/concept.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,eAAO,MAAM,cAAc,SAWS,CAAC"}

package/dist/cli/concept.js

@@ -0,0 +1,336 @@
+"use strict";
+/**
+ * Concept CRUD Commands (ADR-089 Phase 2)
+ *
+ * Direct creation, listing, and management of concepts in the knowledge graph.
+ * Supports both non-interactive (flags) and interactive (-i) modes.
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.conceptCommand = void 0;
+const commander_1 = require("commander");
+const client_1 = require("../api/client");
+const colors = __importStar(require("./colors"));
+const colors_1 = require("./colors");
+const table_1 = require("../lib/table");
+const help_formatter_1 = require("./help-formatter");
+const interactive_1 = require("../lib/interactive");
+exports.conceptCommand = (0, help_formatter_1.setCommandHelp)(new commander_1.Command('concept'), 'Manage concepts in the knowledge graph', 'Create, list, show, and delete concepts. Concepts are the fundamental nodes in the knowledge graph. When creating concepts, the description is embedded and similarity-matched against existing concepts (same as automatic ingestion). Use matching modes to control duplicate handling.')
+    .alias('c')
+    .showHelpAfterError('(add --help for additional information)')
+    .showSuggestionAfterError()
+    .addCommand(createListCommand())
+    .addCommand(createShowCommand())
+    .addCommand(createCreateCommand())
+    .addCommand(createDeleteCommand());
+function createListCommand() {
+    return new commander_1.Command('list')
+        .description('List concepts with optional filters. Shows concept ID, label, ontology, and creation method.')
+        .option('--ontology <name>', 'Filter by ontology')
+        .option('--label <text>', 'Filter by label (contains)')
+        .option('--creation-method <method>', 'Filter by creation method (cli, mcp, api, llm_extraction, import)')
+        .option('--limit <n>', 'Maximum results (default: 50)', '50')
+        .option('--offset <n>', 'Pagination offset', '0')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        try {
+            const client = (0, client_1.createClientFromEnv)();
+            const params = {
+                ontology: options.ontology,
+                label_contains: options.label,
+                creation_method: options.creationMethod,
+                limit: parseInt(options.limit, 10),
+                offset: parseInt(options.offset, 10),
+            };
+            const result = await client.listConceptsCRUD(params);
+            if (options.json) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            if (result.concepts.length === 0) {
+                console.log(colors.status.warning('\nNo concepts found.'));
+                if (options.ontology) {
+                    console.log(colors.status.dim(`  Ontology filter: ${options.ontology}`));
+                }
+                return;
+            }
+            console.log('\n' + colors.ui.title('📚 Concepts'));
+            console.log((0, colors_1.separator)());
+            console.log(colors.status.dim(`Showing ${result.concepts.length} of ${result.total} concepts\n`));
+            const table = new table_1.Table({
+                columns: [
+                    { header: 'ID', field: 'concept_id', type: 'concept_id', width: 15 },
+                    { header: 'Label', field: 'label', type: 'heading', width: 'flex', priority: 3 },
+                    { header: 'Ontology', field: (row) => row.ontology || '-', type: 'text', width: 20 },
+                    { header: 'Created By', field: (row) => row.creation_method || '-', type: 'text', width: 15 },
+                ],
+            });
+            table.print(result.concepts);
+            if (result.total > result.concepts.length) {
+                console.log(colors.status.dim(`\nUse --offset ${result.offset + result.concepts.length} to see more`));
+            }
+        }
+        catch (error) {
+            (0, interactive_1.handleCliError)(error, 'Failed to list concepts');
+        }
+    });
+}
+function createShowCommand() {
+    return new commander_1.Command('show')
+        .description('Show detailed information about a concept by ID.')
+        .argument('<id>', 'Concept ID (e.g., c_abc123)')
+        .option('--json', 'Output as JSON')
+        .action(async (id, options) => {
+        try {
+            const client = (0, client_1.createClientFromEnv)();
+            const concept = await client.getConceptById(id);
+            if (options.json) {
+                console.log(JSON.stringify(concept, null, 2));
+                return;
+            }
+            console.log('\n' + (0, colors_1.separator)());
+            console.log(colors.ui.title(`📖 Concept: ${concept.label}`));
+            console.log((0, colors_1.separator)());
+            console.log();
+            console.log(`${colors.ui.key('ID:')} ${colors.concept.id(concept.concept_id)}`);
+            console.log(`${colors.ui.key('Label:')} ${colors.concept.label(concept.label)}`);
+            if (concept.description) {
+                console.log(`${colors.ui.key('Description:')} ${concept.description}`);
+            }
+            if (concept.ontology) {
+                console.log(`${colors.ui.key('Ontology:')} ${concept.ontology}`);
+            }
+            console.log(`${colors.ui.key('Creation Method:')} ${concept.creation_method || 'unknown'}`);
+            console.log(`${colors.ui.key('Has Embedding:')} ${concept.has_embedding ? colors.status.success('Yes') : colors.status.warning('No')}`);
+            if (concept.search_terms && concept.search_terms.length > 0) {
+                console.log(`${colors.ui.key('Search Terms:')} ${concept.search_terms.join(', ')}`);
+            }
+            console.log('\n' + (0, colors_1.separator)());
+        }
+        catch (error) {
+            (0, interactive_1.handleCliError)(error, 'Failed to get concept', {
+                notFoundMessage: `Concept not found: ${id}`,
+            });
+        }
+    });
+}
+function createCreateCommand() {
+    return new commander_1.Command('create')
+        .description('Create a new concept. Description is embedded and similarity-matched against existing concepts.')
+        .option('--label <name>', 'Concept label (required)')
+        .option('--ontology <name>', 'Target ontology (required)')
+        .option('--description <text>', 'Concept description (used for embedding match)')
+        .option('--search-terms <terms>', 'Comma-separated search terms')
+        .option('--matching-mode <mode>', 'auto|force_create|match_only (default: auto)', 'auto')
+        .option('--json', 'Output as JSON')
+        .option('-i, --interactive', 'Guided wizard mode')
+        .option('-y, --yes', 'Skip confirmation prompts')
+        .action(async (options) => {
+        try {
+            const client = (0, client_1.createClientFromEnv)();
+            let label;
+            let ontology;
+            let description;
+            let searchTerms;
+            let matchingMode = options.matchingMode || 'auto';
+            if (options.interactive) {
+                // Interactive wizard mode
+                console.log('\n' + colors.ui.title('📝 Create New Concept'));
+                console.log((0, colors_1.separator)());
+                console.log();
+                // Get ontology
+                const ontologies = await client.listOntologies();
+                if (ontologies.ontologies.length === 0) {
+                    console.log(colors.status.warning('No ontologies found. Create one first with kg ingest.'));
+                    return;
+                }
+                const ontologyResult = await (0, interactive_1.selectOption)('Select ontology:', ontologies.ontologies.map((o) => ({
+                    label: o.ontology,
+                    value: o.ontology,
+                    description: `${o.concept_count} concepts, ${o.file_count} files`,
+                })));
+                if (ontologyResult.cancelled || !ontologyResult.selected) {
+                    console.log(colors.status.dim('\nCancelled.'));
+                    return;
+                }
+                ontology = ontologyResult.selected.value;
+                // Get label
+                const labelResult = await (0, interactive_1.textInput)('Label');
+                if (labelResult.cancelled || !labelResult.value) {
+                    console.log(colors.status.dim('\nCancelled.'));
+                    return;
+                }
+                label = labelResult.value;
+                // Get description
+                const descResult = await (0, interactive_1.textInput)('Description (optional, used for similarity matching)');
+                if (!descResult.cancelled && descResult.value) {
+                    description = descResult.value;
+                }
+                // Get search terms
+                const termsResult = await (0, interactive_1.textInput)('Search terms (optional, comma-separated)');
+                if (!termsResult.cancelled && termsResult.value) {
+                    searchTerms = termsResult.value.split(',').map((t) => t.trim()).filter(Boolean);
+                }
+                // Matching mode
+                const modeResult = await (0, interactive_1.selectOption)('Matching mode:', [
+                    { label: 'auto', value: 'auto', description: 'Match existing if similar, create if not (recommended)' },
+                    { label: 'force_create', value: 'force_create', description: 'Always create new, skip matching' },
+                    { label: 'match_only', value: 'match_only', description: 'Only link to existing, fail if no match' },
+                ]);
+                if (modeResult.cancelled) {
+                    console.log(colors.status.dim('\nCancelled.'));
+                    return;
+                }
+                matchingMode = modeResult.selected?.value || 'auto';
+                // Confirm
+                console.log('\n' + (0, colors_1.separator)());
+                console.log(colors.ui.header('Summary:'));
+                console.log(`  ${colors.ui.key('Ontology:')} ${ontology}`);
+                console.log(`  ${colors.ui.key('Label:')} ${label}`);
+                if (description)
+                    console.log(`  ${colors.ui.key('Description:')} ${description}`);
+                if (searchTerms?.length)
+                    console.log(`  ${colors.ui.key('Search Terms:')} ${searchTerms.join(', ')}`);
+                console.log(`  ${colors.ui.key('Matching Mode:')} ${matchingMode}`);
+                console.log();
+                const confirmed = await (0, interactive_1.confirmYesNo)('Create this concept?', true);
+                if (!confirmed) {
+                    console.log(colors.status.dim('\nCancelled.'));
+                    return;
+                }
+            }
+            else {
+                // Non-interactive mode - require flags
+                if (!options.label) {
+                    console.error(colors.status.error('✗ Missing required option: --label'));
+                    console.log(colors.status.dim('\nUse -i for interactive mode, or provide required options:'));
+                    console.log(colors.status.dim('  kg concept create --label "My Concept" --ontology my-ontology'));
+                    process.exit(1);
+                }
+                if (!options.ontology) {
+                    console.error(colors.status.error('✗ Missing required option: --ontology'));
+                    console.log(colors.status.dim('\nUse -i for interactive mode, or provide required options:'));
+                    console.log(colors.status.dim('  kg concept create --label "My Concept" --ontology my-ontology'));
+                    process.exit(1);
+                }
+                label = options.label;
+                ontology = options.ontology;
+                description = options.description;
+                searchTerms = options.searchTerms?.split(',').map((t) => t.trim()).filter(Boolean);
+            }
+            // Create the concept
+            const result = await (0, interactive_1.withSpinner)('Creating concept...', async () => {
+                return client.createConcept({
+                    label,
+                    ontology,
+                    description,
+                    search_terms: searchTerms,
+                    matching_mode: matchingMode,
+                    creation_method: 'cli',
+                });
+            });
+            if (options.json) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            console.log();
+            if (result.matched_existing) {
+                console.log(colors.status.info(`≈ Matched existing concept: ${result.concept_id}`));
+                console.log(colors.status.dim('  (Use --matching-mode force_create to create new anyway)'));
+            }
+            else {
+                console.log(colors.status.success(`✓ Created concept: ${result.concept_id}`));
+            }
+            console.log(`  ${colors.ui.key('Label:')} ${result.label}`);
+            console.log(`  ${colors.ui.key('Has Embedding:')} ${result.has_embedding ? 'Yes' : 'No'}`);
+        }
+        catch (error) {
+            (0, interactive_1.handleCliError)(error, 'Failed to create concept');
+        }
+    });
+}
+function createDeleteCommand() {
+    return new commander_1.Command('delete')
+        .description('Delete a concept by ID. Requires --force flag or interactive confirmation.')
+        .argument('<id>', 'Concept ID to delete')
+        .option('--cascade', 'Also delete orphaned synthetic sources')
+        .option('-f, --force', 'Skip confirmation')
+        .option('--json', 'Output as JSON')
+        .action(async (id, options) => {
+        try {
+            const client = (0, client_1.createClientFromEnv)();
+            // First, get the concept to show what will be deleted
+            let concept;
+            try {
+                concept = await client.getConceptById(id);
+            }
+            catch (error) {
+                (0, interactive_1.handleCliError)(error, 'Failed to get concept', {
+                    notFoundMessage: `Concept not found: ${id}`,
+                });
+                return; // handleCliError exits, but TypeScript needs this
+            }
+            if (!options.force) {
+                console.log('\n' + (0, colors_1.separator)());
+                console.log(colors.status.warning('⚠️  Delete Concept'));
+                console.log((0, colors_1.separator)());
+                console.log();
+                console.log(`  ${colors.ui.key('ID:')} ${concept.concept_id}`);
+                console.log(`  ${colors.ui.key('Label:')} ${concept.label}`);
+                if (concept.ontology) {
+                    console.log(`  ${colors.ui.key('Ontology:')} ${concept.ontology}`);
+                }
+                console.log();
+                console.log(colors.status.warning('This action cannot be undone.'));
+                console.log();
+                const confirmed = await (0, interactive_1.confirmYesNo)('Delete this concept?', false);
+                if (!confirmed) {
+                    console.log(colors.status.dim('\nCancelled.'));
+                    return;
+                }
+            }
+            await client.deleteConcept(id, options.cascade);
+            if (options.json) {
+                console.log(JSON.stringify({ deleted: true, concept_id: id }));
+                return;
+            }
+            console.log(colors.status.success(`\n✓ Deleted concept: ${id}`));
+        }
+        catch (error) {
+            (0, interactive_1.handleCliError)(error, 'Failed to delete concept');
+        }
+    });
+}
+//# sourceMappingURL=concept.js.map