@kweaver-ai/kweaver-sdk 0.5.0 → 0.5.2

package/dist/commands/bkn.js

@@ -1,32 +1,20 @@
 import { createInterface } from "node:readline";
-import { spawnSync } from "node:child_process";
-import { mkdirSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { resolve } from "node:path";
-import { loadNetwork, allObjects, allRelations, allActions, generateChecksum, validateNetwork } from "@kweaver-ai/bkn";
-import { prepareBknDirectoryForImport, stripBknEncodingCliArgs, } from "../utils/bkn-encoding.js";
+import { readFileSync } from "node:fs";
 import { ensureValidToken, formatHttpError, with401RefreshRetry } from "../auth/oauth.js";
-import { listKnowledgeNetworks, getKnowledgeNetwork, createKnowledgeNetwork, updateKnowledgeNetwork, deleteKnowledgeNetwork, listObjectTypes, listRelationTypes, listActionTypes, getObjectType, createObjectTypes, updateObjectType, deleteObjectTypes, getRelationType, createRelationTypes, updateRelationType, deleteRelationTypes, buildKnowledgeNetwork, getBuildStatus, } from "../api/knowledge-networks.js";
-import { objectTypeQuery, objectTypeProperties, subgraph, actionTypeQuery, actionTypeExecute, actionExecutionGet, actionLogsList, actionLogGet, actionLogCancel, } from "../api/ontology-query.js";
-import { semanticSearch } from "../api/semantic-search.js";
-import { listTablesWithColumns, scanMetadata, getDatasource } from "../api/datasources.js";
-import { createDataView, findDataView } from "../api/dataviews.js"; // used by runKnCreateFromDsCommand
-import { downloadBkn, uploadBkn } from "../api/bkn-backend.js";
+import { listKnowledgeNetworks, getKnowledgeNetwork, createKnowledgeNetwork, updateKnowledgeNetwork, deleteKnowledgeNetwork, } from "../api/knowledge-networks.js";
 import { formatCallOutput } from "./call.js";
 import { resolveBusinessDomain } from "../config/store.js";
-import { runDsImportCsv } from "./ds.js";
-export async function pollWithBackoff(opts) {
-    const { fn, timeout, maxInterval = 15000, _sleep = (ms) => new Promise(r => setTimeout(r, ms)) } = opts;
-    let currentInterval = opts.interval;
-    const deadline = Date.now() + timeout;
-    while (Date.now() < deadline) {
-        const result = await fn();
-        if (result.done)
-            return result.value;
-        await _sleep(currentInterval);
-        currentInterval = Math.min(currentInterval * 2, maxInterval);
-    }
-    throw new Error(`Polling timed out after ${timeout}ms`);
-}
+import { runKnObjectTypeCommand, runKnRelationTypeCommand, runKnActionTypeCommand, runKnConceptGroupCommand, } from "./bkn-schema.js";
+import { runKnSubgraphCommand, runKnActionExecutionCommand, runKnActionLogCommand, runKnSearchCommand, runKnRelationTypePathsCommand, runKnResourcesCommand, } from "./bkn-query.js";
+import { runKnBuildCommand, runKnValidateCommand, runKnPushCommand, runKnPullCommand, runKnCreateFromDsCommand, runKnCreateFromCsvCommand, runKnActionScheduleCommand, runKnJobCommand, } from "./bkn-ops.js";
+// Re-export shared utils for backward compatibility (tests import from bkn.js)
+export { pollWithBackoff, parseOntologyQueryFlags, parseJsonObject, parseSearchAfterArray, confirmYes, DISPLAY_HINTS, detectPrimaryKey, detectDisplayKey, } from "./bkn-utils.js";
+// Re-export schema types and parse functions for backward compatibility
+export { parseObjectTypeCreateArgs, finalizeObjectTypeCreateFromDataview, ensureMappedFieldOnDataProperty, normalizeAdpFieldType, parseKnObjectTypeQueryArgs, parseKnActionTypeExecuteArgs, parseRelationTypeCreateArgs, applyObjectTypeMerge, stripObjectTypeForPut, parseObjectTypeUpdateArgs, parseObjectTypeDeleteArgs, parseRelationTypeUpdateArgs, parseRelationTypeDeleteArgs, runKnObjectTypeCommand, runKnRelationTypeCommand, runKnActionTypeCommand, parseConceptGroupArgs, } from "./bkn-schema.js";
+// Re-export query parse functions for backward compatibility (tests import from bkn.js)
+export { parseKnSearchArgs } from "./bkn-query.js";
+// Re-export ops types and parse functions for backward compatibility (tests import from bkn.js)
+export { parseKnBuildArgs, parseKnPushArgs, parseKnPullArgs, packDirectoryToTar, extractTarToDirectory, parseActionScheduleArgs, parseJobArgs, } from "./bkn-ops.js";
 export function formatSimpleKnList(text, pretty, includeDetail = false) {
     const parsed = JSON.parse(text);
     const entries = Array.isArray(parsed.entries) ? parsed.entries : [];
@@ -368,245 +356,6 @@ export function parseKnDeleteArgs(args) {
         businessDomain = resolveBusinessDomain();
     return { knId, businessDomain, yes };
 }
-export function parseKnPushArgs(args) {
-    const { rest, options: encodingOptions } = stripBknEncodingCliArgs(args);
-    let directory = "";
-    let branch = "main";
-    let businessDomain = "";
-    let pretty = true;
-    for (let i = 0; i < rest.length; i += 1) {
-        const arg = rest[i];
-        if (arg === "--help" || arg === "-h") {
-            throw new Error("help");
-        }
-        if (arg === "--branch") {
-            branch = args[i + 1] ?? "main";
-            if (!branch || branch.startsWith("-")) {
-                throw new Error("Missing value for --branch");
-            }
-            i += 1;
-            continue;
-        }
-        if (arg === "-bd" || arg === "--biz-domain") {
-            businessDomain = args[i + 1] ?? "bd_public";
-            if (!businessDomain || businessDomain.startsWith("-")) {
-                throw new Error("Missing value for biz-domain flag");
-            }
-            i += 1;
-            continue;
-        }
-        if (arg === "--pretty") {
-            pretty = true;
-            continue;
-        }
-        if (!arg.startsWith("-") && !directory) {
-            directory = arg;
-            continue;
-        }
-        throw new Error(`Unsupported bkn push argument: ${arg}`);
-    }
-    if (!directory) {
-        throw new Error("Missing directory. Usage: kweaver bkn push <directory> [--branch main] [-bd value]");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { directory, branch, businessDomain, pretty, encodingOptions };
-}
-export function parseKnPullArgs(args) {
-    let knId = "";
-    let directory = "";
-    let branch = "main";
-    let businessDomain = "";
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h") {
-            throw new Error("help");
-        }
-        if (arg === "--branch") {
-            branch = args[i + 1] ?? "main";
-            if (!branch || branch.startsWith("-")) {
-                throw new Error("Missing value for --branch");
-            }
-            i += 1;
-            continue;
-        }
-        if (arg === "-bd" || arg === "--biz-domain") {
-            businessDomain = args[i + 1] ?? "bd_public";
-            if (!businessDomain || businessDomain.startsWith("-")) {
-                throw new Error("Missing value for biz-domain flag");
-            }
-            i += 1;
-            continue;
-        }
-        if (!arg.startsWith("-")) {
-            if (!knId) {
-                knId = arg;
-            }
-            else if (!directory) {
-                directory = arg;
-            }
-            else {
-                throw new Error(`Unexpected positional argument: ${arg}`);
-            }
-            continue;
-        }
-        throw new Error(`Unsupported bkn pull argument: ${arg}`);
-    }
-    if (!knId) {
-        throw new Error("Missing kn-id. Usage: kweaver bkn pull <kn-id> [<directory>] [--branch main] [-bd value]");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { knId, directory: directory || knId, branch, businessDomain };
-}
-function parseJsonObject(text, errorMessage) {
-    let parsed;
-    try {
-        parsed = JSON.parse(text);
-    }
-    catch {
-        throw new Error(errorMessage);
-    }
-    if (!parsed || Array.isArray(parsed) || typeof parsed !== "object") {
-        throw new Error(errorMessage);
-    }
-    return parsed;
-}
-const MAX_OUTPUT_BYTES = 100_000;
-/**
- * If a query response exceeds MAX_OUTPUT_BYTES, trim the datas array
- * to fit, preserving valid JSON and the search_after cursor for pagination.
- */
-function truncateQueryResult(raw) {
-    if (raw.length <= MAX_OUTPUT_BYTES) {
-        return raw;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return raw;
-    }
-    const datas = parsed.datas;
-    if (!Array.isArray(datas) || datas.length === 0) {
-        return raw;
-    }
-    const originalCount = datas.length;
-    while (datas.length > 1) {
-        datas.pop();
-        const candidate = JSON.stringify(parsed);
-        if (candidate.length <= MAX_OUTPUT_BYTES) {
-            const remaining = originalCount - datas.length;
-            const sa = parsed.search_after;
-            parsed._truncated = {
-                returned: datas.length,
-                total_fetched: originalCount,
-                remaining,
-                next_search_after: sa ?? null,
-                hint: sa
-                    ? `Pass --search-after '${JSON.stringify(sa)}' --limit ${datas.length} to fetch the next page.`
-                    : `Reduce --limit to ${datas.length} or less to avoid truncation.`,
-            };
-            console.error(`[warn] Truncated ${originalCount} → ${datas.length} records (output exceeded ${Math.round(MAX_OUTPUT_BYTES / 1024)}KB). ${parsed._truncated.hint}`);
-            return JSON.stringify(parsed);
-        }
-    }
-    const sa = parsed.search_after;
-    parsed._truncated = {
-        returned: 1,
-        total_fetched: originalCount,
-        remaining: originalCount - 1,
-        next_search_after: sa ?? null,
-        hint: `Single record is very large. Use --limit 1 and --search-after to iterate.`,
-    };
-    console.error(`[warn] Truncated ${originalCount} → 1 record. Single record is very large. Use --limit 1 and --search-after to iterate.`);
-    return JSON.stringify(parsed);
-}
-function parseSearchAfterArray(text) {
-    let parsed;
-    try {
-        parsed = JSON.parse(text);
-    }
-    catch {
-        throw new Error("Invalid value for --search-after. Expected a JSON array string.");
-    }
-    if (!Array.isArray(parsed)) {
-        throw new Error("Invalid value for --search-after. Expected a JSON array string.");
-    }
-    return parsed;
-}
-export function parseKnObjectTypeQueryArgs(args) {
-    let pretty = true;
-    let businessDomain = "";
-    let limit;
-    let searchAfter;
-    const positionalArgs = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h") {
-            throw new Error("help");
-        }
-        if (arg === "--pretty") {
-            pretty = true;
-            continue;
-        }
-        if (arg === "-bd" || arg === "--biz-domain") {
-            businessDomain = args[i + 1] ?? "bd_public";
-            if (!businessDomain || businessDomain.startsWith("-")) {
-                throw new Error("Missing value for biz-domain flag");
-            }
-            i += 1;
-            continue;
-        }
-        if (arg === "--limit") {
-            const rawLimit = args[i + 1];
-            const parsedLimit = parseInt(rawLimit ?? "", 10);
-            if (!rawLimit || rawLimit.startsWith("-") || Number.isNaN(parsedLimit) || parsedLimit < 1) {
-                throw new Error("Invalid value for --limit. Expected a positive integer.");
-            }
-            limit = parsedLimit;
-            i += 1;
-            continue;
-        }
-        if (arg === "--search-after") {
-            const rawSearchAfter = args[i + 1];
-            if (!rawSearchAfter) {
-                throw new Error("Missing value for --search-after. Expected a JSON array string.");
-            }
-            searchAfter = parseSearchAfterArray(rawSearchAfter);
-            i += 1;
-            continue;
-        }
-        positionalArgs.push(arg);
-    }
-    const [knId, otId, bodyText = "{}"] = positionalArgs;
-    if (!knId || !otId) {
-        throw new Error("Usage: kweaver bkn object-type query <kn-id> <ot-id> ['<json>'] [--limit <n>] [--search-after '<json-array>'] [--pretty] [-bd value]");
-    }
-    if (positionalArgs.length > 3) {
-        throw new Error("Usage: kweaver bkn object-type query <kn-id> <ot-id> ['<json>'] [--limit <n>] [--search-after '<json-array>'] [--pretty] [-bd value]");
-    }
-    const body = parseJsonObject(bodyText, "object-type query body must be a JSON object.");
-    if (limit !== undefined) {
-        body.limit = limit;
-    }
-    if (searchAfter !== undefined) {
-        body.search_after = searchAfter;
-    }
-    if (typeof body.limit !== "number" || !Number.isFinite(body.limit) || body.limit < 1) {
-        body.limit = 50;
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return {
-        knId,
-        otId,
-        body: JSON.stringify(body),
-        pretty,
-        businessDomain,
-    };
-}
 const KN_HELP = `kweaver bkn
 
 Subcommands:
@@ -635,16 +384,25 @@ Subcommands:
   relation-type list <kn-id>   List relation types (schema)
   relation-type get <kn-id> <rt-id>   Get relation type details
   relation-type create <kn-id> [options]   Create relation type (--name --source --target [--mapping src:tgt])
-  relation-type update <kn-id> <rt-id> [options]   Update relation type
+  relation-type update <kn-id> <rt-id> --source <ot-id> --target <ot-id> [--name X] [--type direct|data_view] [--mapping src:tgt ...]   Update relation type
   relation-type delete <kn-id> <rt-ids> [-y]   Delete relation type(s)
   subgraph <kn-id> '<json>'   Query subgraph
   action-type list <kn-id>   List action types (schema)
+  action-type get <kn-id> <at-id>   Get action type details
+  action-type create <kn-id> '<json>'   Create action type
+  action-type update <kn-id> <at-id> '<json>'   Update action type
+  action-type delete <kn-id> <at-ids> [-y]   Delete action type(s)
   action-type query <kn-id> <at-id> '<json>'   Query action info
   action-type execute <kn-id> <at-id> '<json>'   Execute action (has side effects)
   action-execution get <kn-id> <execution-id>   Get execution status
   action-log list <kn-id> [options]   List action execution logs
   action-log get <kn-id> <log-id>   Get single execution log
   action-log cancel <kn-id> <log-id>   Cancel running execution (has side effects)
+  concept-group list|get|create|update|delete|add-members|remove-members <kn-id> ...
+  action-schedule list|get|create|update|set-status|delete <kn-id> ...
+  job list|get|tasks|delete <kn-id> ...
+  relation-type-paths <kn-id> '<json>'   Query relation type paths between OTs
+  resources                              List available resources
 
 Use 'kweaver bkn <subcommand> --help' for subcommand options.`;
 export async function runKnCommand(args) {
@@ -694,6 +452,16 @@ export async function runKnCommand(args) {
             return runKnActionExecutionCommand(rest);
         if (subcommand === "action-log")
             return runKnActionLogCommand(rest);
+        if (subcommand === "concept-group")
+            return runKnConceptGroupCommand(rest);
+        if (subcommand === "action-schedule")
+            return runKnActionScheduleCommand(rest);
+        if (subcommand === "job")
+            return runKnJobCommand(rest);
+        if (subcommand === "relation-type-paths")
+            return runKnRelationTypePathsCommand(rest);
+        if (subcommand === "resources")
+            return runKnResourcesCommand(rest);
         return Promise.resolve(-1);
     };
     try {
@@ -711,1341 +479,119 @@ export async function runKnCommand(args) {
         return 1;
     }
 }
-/** Parse object-type create args: --name --dataview-id --primary-key --display-key [--property '<json>' ...] */
-export function parseObjectTypeCreateArgs(args) {
-    let name = "";
-    let dataviewId = "";
-    let primaryKey = "";
-    let displayKey = "";
-    let businessDomain = "";
-    let branch = "main";
-    let pretty = true;
-    const properties = [];
-    const positional = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h")
-            throw new Error("help");
-        if (arg === "--name" && args[i + 1]) {
-            name = args[++i];
-            continue;
-        }
-        if (arg === "--dataview-id" && args[i + 1]) {
-            dataviewId = args[++i];
-            continue;
-        }
-        if (arg === "--primary-key" && args[i + 1]) {
-            primaryKey = args[++i];
-            continue;
-        }
-        if (arg === "--display-key" && args[i + 1]) {
-            displayKey = args[++i];
-            continue;
-        }
-        if (arg === "--property" && args[i + 1]) {
-            properties.push(args[++i]);
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[++i];
-            continue;
-        }
-        if (arg === "--branch" && args[i + 1]) {
-            branch = args[++i];
-            continue;
-        }
-        if (arg === "--pretty") {
-            pretty = true;
-            continue;
-        }
-        if (!arg.startsWith("-"))
-            positional.push(arg);
-    }
-    const knId = positional[0];
-    if (!knId || !name || !dataviewId || !primaryKey || !displayKey) {
-        throw new Error("Usage: kweaver bkn object-type create <kn-id> --name X --dataview-id Y --primary-key Z --display-key W");
+async function runKnListCommand(args) {
+    let options;
+    try {
+        options = parseKnListArgs(args);
     }
-    const entry = {
-        branch,
-        name,
-        data_source: { type: "data_view", id: dataviewId },
-        primary_keys: [primaryKey],
-        display_key: displayKey,
-    };
-    if (properties.length > 0) {
-        entry.data_properties = properties.map((p) => JSON.parse(p));
+    catch (error) {
+        if (error instanceof Error && error.message === "help") {
+            console.log(KN_LIST_HELP);
+            return 0;
+        }
+        console.error(formatHttpError(error));
+        return 1;
     }
-    else {
-        const autoProps = new Set([primaryKey, displayKey]);
-        entry.data_properties = Array.from(autoProps).map((n) => ({
-            name: n,
-            display_name: n,
-            type: "string",
-        }));
+    try {
+        const token = await ensureValidToken();
+        const body = await listKnowledgeNetworks({
+            baseUrl: token.baseUrl,
+            accessToken: token.accessToken,
+            businessDomain: options.businessDomain,
+            offset: options.offset,
+            limit: options.limit,
+            sort: options.sort,
+            direction: options.direction,
+            name_pattern: options.name_pattern,
+            tag: options.tag,
+        });
+        if (body) {
+            console.log(options.verbose
+                ? formatCallOutput(body, options.pretty)
+                : formatSimpleKnList(body, options.pretty, options.detail));
+        }
+        return 0;
     }
-    const body = JSON.stringify({ entries: [entry] });
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { knId, body, businessDomain, branch, pretty };
-}
-const OBJECT_TYPE_PUT_STRIP_KEYS = new Set([
-    "status",
-    "creator",
-    "updater",
-    "create_time",
-    "update_time",
-    "module_type",
-    "kn_id",
-]);
-/** Prepare a GET response entry for PUT (drop read-only fields). */
-export function stripObjectTypeForPut(entry) {
-    const out = { ...entry };
-    for (const k of OBJECT_TYPE_PUT_STRIP_KEYS) {
-        delete out[k];
+    catch (error) {
+        console.error(formatHttpError(error));
+        return 1;
     }
-    return out;
 }
-/**
- * Apply merge flags onto a stripped object-type object (mutates copy).
- * - Add: property `name` not in list → append.
- * - Update: property `name` exists → replace entry (same as add; CLI also accepts `--update-property`).
- * - Delete: `--remove-property` removes by `name` before adds are applied.
- */
-export function applyObjectTypeMerge(target, merge) {
-    if (merge.name !== undefined)
-        target.name = merge.name;
-    if (merge.displayKey !== undefined)
-        target.display_key = merge.displayKey;
-    if (merge.comment !== undefined)
-        target.comment = merge.comment;
-    if (merge.icon !== undefined)
-        target.icon = merge.icon;
-    if (merge.color !== undefined)
-        target.color = merge.color;
-    if (merge.tags !== undefined)
-        target.tags = merge.tags;
-    let props = target.data_properties;
-    if (!Array.isArray(props)) {
-        props = [];
-    }
-    else {
-        props = props.map((p) => p && typeof p === "object" && !Array.isArray(p) ? { ...p } : p);
-    }
-    const list = props;
-    for (const rm of merge.removeProperties) {
-        for (let j = list.length - 1; j >= 0; j -= 1) {
-            const n = list[j]?.name;
-            if (typeof n === "string" && n === rm)
-                list.splice(j, 1);
-        }
+const KN_LIST_HELP = `kweaver bkn list [options]
+
+List business knowledge networks from the ontology-manager API.
+
+Options:
+  --offset <n>       Offset (default: 0)
+  --limit <n>        Limit (default: 30)
+  --sort <key>       Sort field (default: update_time)
+  --direction <asc|desc>  Sort direction (default: desc)
+  --name-pattern <s> Filter by name pattern
+  --tag <s>          Filter by tag
+  --detail           Include the detail field in simplified output
+  --verbose, -v      Show full JSON response
+  -bd, --biz-domain <value>  Business domain (default: bd_public)
+  --pretty           Pretty-print JSON output (applies to both modes)`;
+const KN_GET_HELP = `kweaver bkn get <kn-id> [options]
+
+Get knowledge network detail.
+
+Options:
+  --stats            Include statistics
+  --export           Export mode (include sub-types)
+  -bd, --biz-domain <value>  Business domain (default: bd_public)
+  --pretty           Pretty-print JSON output`;
+const KN_CREATE_HELP = `kweaver bkn create [options]
+
+Create a knowledge network.
+
+Options:
+  --name <s>         Name (required unless --body-file)
+  --comment <s>      Comment
+  --tags <t1,t2>     Comma-separated tags
+  --icon <s>         Icon
+  --color <s>        Color
+  --branch <s>       Branch (default: main)
+  --base-branch <s>  Base branch (default: empty for main)
+  --body-file <path> Read full JSON body from file (cannot combine with flags above)
+  --import-mode <normal|ignore|overwrite>  Import mode (default: normal)
+  --validate-dependency <true|false>  Validate dependency (default: true)
+  -bd, --biz-domain <value>  Business domain (default: bd_public)
+  --pretty           Pretty-print JSON output`;
+const KN_UPDATE_HELP = `kweaver bkn update <kn-id> [options]
+
+Update a knowledge network.
+
+Options:
+  --name <s>         Name (required unless --body-file)
+  --comment <s>      Comment
+  --tags <t1,t2>     Comma-separated tags
+  --icon <s>         Icon
+  --color <s>        Color
+  --branch <s>       Branch (default: main)
+  --base-branch <s>  Base branch (default: empty for main)
+  --body-file <path> Read full JSON body from file (cannot combine with flags above)
+  -bd, --biz-domain <value>  Business domain (default: bd_public)
+  --pretty           Pretty-print JSON output`;
+const KN_DELETE_HELP = `kweaver bkn delete <kn-id>
+
+Delete a knowledge network and its object types, relation types, action types, and concept groups.
+
+Options:
+  --yes, -y          Skip confirmation prompt
+  -bd, --biz-domain <value>  Business domain (default: bd_public)`;
+async function runKnGetCommand(args) {
+    let options;
+    try {
+        options = parseKnGetArgs(args);
     }
-    for (const add of merge.addProperties) {
-        const nm = add.name;
-        if (typeof nm !== "string" || !nm) {
-            throw new Error("--add-property / --update-property JSON must include a non-empty string \"name\" field.");
+    catch (error) {
+        if (error instanceof Error && error.message === "help") {
+            console.log(KN_GET_HELP);
+            return 0;
         }
-        const idx = list.findIndex((p) => p?.name === nm);
-        if (idx >= 0)
-            list[idx] = add;
-        else
-            list.push(add);
-    }
-    target.data_properties = list;
-    return target;
-}
-/** Parse object-type update: raw JSON body OR merge flags (GET-merge-PUT). */
-function parseObjectTypeUpdateArgs(args) {
-    let name;
-    let displayKey;
-    let businessDomain = "";
-    let pretty = true;
-    let branch = "main";
-    let comment;
-    let icon;
-    let color;
-    let tagsJson;
-    const addProperties = [];
-    const removeProperties = [];
-    const positional = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h")
-            throw new Error("help");
-        if (arg === "--name" && args[i + 1]) {
-            name = args[++i];
-            continue;
-        }
-        if (arg === "--display-key" && args[i + 1]) {
-            displayKey = args[++i];
-            continue;
-        }
-        if ((arg === "--add-property" || arg === "--update-property") && args[i + 1]) {
-            const raw = args[++i];
-            addProperties.push(parseJsonObject(raw, `--add-property / --update-property must be valid JSON object: ${raw}`));
-            continue;
-        }
-        if (arg === "--remove-property" && args[i + 1]) {
-            removeProperties.push(args[++i]);
-            continue;
-        }
-        if (arg === "--tags" && args[i + 1]) {
-            tagsJson = args[++i];
-            continue;
-        }
-        if (arg === "--comment" && args[i + 1]) {
-            comment = args[++i];
-            continue;
-        }
-        if (arg === "--icon" && args[i + 1]) {
-            icon = args[++i];
-            continue;
-        }
-        if (arg === "--color" && args[i + 1]) {
-            color = args[++i];
-            continue;
-        }
-        if (arg === "--branch" && args[i + 1]) {
-            branch = args[++i];
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[++i];
-            continue;
-        }
-        if (arg === "--pretty") {
-            pretty = true;
-            continue;
-        }
-        if (!arg.startsWith("-"))
-            positional.push(arg);
-    }
-    const [knId, otId, maybeBody] = positional;
-    if (!knId || !otId) {
-        throw new Error("Usage: kweaver bkn object-type update <kn-id> <ot-id> [ '<full-json-body>' ] [--name ...] [--add-property|--update-property '<json>' ...] [--remove-property <name> ...]");
-    }
-    const hasMergeFlags = name !== undefined ||
-        displayKey !== undefined ||
-        addProperties.length > 0 ||
-        removeProperties.length > 0 ||
-        tagsJson !== undefined ||
-        comment !== undefined ||
-        icon !== undefined ||
-        color !== undefined;
-    if (maybeBody !== undefined && maybeBody.trim().startsWith("{")) {
-        if (hasMergeFlags) {
-            throw new Error("Do not combine a raw JSON body with --name/--add-property/--update-property/--remove-property and other merge flags.");
-        }
-        if (!businessDomain)
-            businessDomain = resolveBusinessDomain();
-        return {
-            mode: "body",
-            knId,
-            otId,
-            body: maybeBody.trim(),
-            businessDomain,
-            pretty,
-        };
-    }
-    if (maybeBody !== undefined) {
-        throw new Error(`Unexpected third argument "${maybeBody}". For raw PUT body, pass a single JSON object starting with "{".`);
-    }
-    let tags;
-    if (tagsJson !== undefined) {
-        try {
-            const t = JSON.parse(tagsJson);
-            if (!Array.isArray(t) || !t.every((x) => typeof x === "string")) {
-                throw new Error("invalid");
-            }
-            tags = t;
-        }
-        catch {
-            throw new Error(`--tags must be a JSON array of strings, e.g. '["足球","球员"]'`);
-        }
-    }
-    const merge = {
-        addProperties,
-        removeProperties,
-        ...(name !== undefined ? { name } : {}),
-        ...(displayKey !== undefined ? { displayKey } : {}),
-        ...(tags !== undefined ? { tags } : {}),
-        ...(comment !== undefined ? { comment } : {}),
-        ...(icon !== undefined ? { icon } : {}),
-        ...(color !== undefined ? { color } : {}),
-    };
-    if (merge.name === undefined &&
-        merge.displayKey === undefined &&
-        merge.addProperties.length === 0 &&
-        merge.removeProperties.length === 0 &&
-        merge.tags === undefined &&
-        merge.comment === undefined &&
-        merge.icon === undefined &&
-        merge.color === undefined) {
-        throw new Error("No update fields. Use --name, --display-key, --add-property (new), --update-property (same as add; replaces by name), --remove-property, --tags, --comment, --icon, --color, or pass a full JSON object as the third argument.");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { mode: "merge", knId, otId, merge, businessDomain, pretty, branch };
-}
-/** Parse object-type delete args: <kn-id> <ot-ids> [-y] */
-function parseObjectTypeDeleteArgs(args) {
-    let businessDomain = "";
-    let yes = false;
-    const positional = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h")
-            throw new Error("help");
-        if (arg === "--yes" || arg === "-y") {
-            yes = true;
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[++i];
-            continue;
-        }
-        if (!arg.startsWith("-"))
-            positional.push(arg);
-    }
-    const [knId, otIds] = positional;
-    if (!knId || !otIds) {
-        throw new Error("Usage: kweaver bkn object-type delete <kn-id> <ot-ids> [-y]");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { knId, otIds, businessDomain, yes };
-}
-/** Parse common flags for ontology-query subcommands; returns { filteredArgs, pretty, businessDomain } */
-function parseOntologyQueryFlags(args) {
-    let pretty = true;
-    let businessDomain = "";
-    const filteredArgs = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h") {
-            throw new Error("help");
-        }
-        if (arg === "--pretty") {
-            pretty = true;
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[i + 1];
-            i += 1;
-            continue;
-        }
-        filteredArgs.push(arg);
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { filteredArgs, pretty, businessDomain };
-}
-export function parseKnActionTypeExecuteArgs(args) {
-    let pretty = true;
-    let businessDomain = "";
-    let wait = true;
-    let timeout = 300;
-    const positional = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h") {
-            throw new Error("help");
-        }
-        if (arg === "--pretty") {
-            pretty = true;
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[i + 1];
-            i += 1;
-            continue;
-        }
-        if (arg === "--wait") {
-            wait = true;
-            continue;
-        }
-        if (arg === "--no-wait") {
-            wait = false;
-            continue;
-        }
-        if (arg === "--timeout" && args[i + 1]) {
-            timeout = parseInt(args[i + 1], 10);
-            if (Number.isNaN(timeout) || timeout < 1)
-                timeout = 300;
-            i += 1;
-            continue;
-        }
-        positional.push(arg);
-    }
-    const [knId, atId, body] = positional;
-    if (!knId || !atId || !body) {
-        throw new Error("Missing kn-id, at-id, or body. Usage: kweaver bkn action-type execute <kn-id> <at-id> '<json>' [options]");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return {
-        knId,
-        atId,
-        body,
-        pretty,
-        businessDomain,
-        wait,
-        timeout,
-    };
-}
-const DISPLAY_HINTS = ["name", "title", "label", "display_name", "description"];
-/** Detect primary key: first column (left-to-right) with all unique values in the sample. */
-function detectPrimaryKey(table, rows) {
-    if (rows && rows.length > 0) {
-        for (const col of table.columns) {
-            const values = rows.map((r) => r[col.name]);
-            const unique = new Set(values);
-            if (unique.size === rows.length)
-                return col.name;
-        }
-    }
-    // Fallback: first column
-    return table.columns[0]?.name ?? "id";
-}
-function detectDisplayKey(table, primaryKey) {
-    for (const col of table.columns) {
-        if (DISPLAY_HINTS.some((h) => col.name.toLowerCase().includes(h))) {
-            return col.name;
-        }
-    }
-    return primaryKey;
-}
-function confirmYes(prompt) {
-    return new Promise((resolve) => {
-        const rl = createInterface({ input: process.stdin, output: process.stdout });
-        rl.question(`${prompt} [y/N] `, (answer) => {
-            rl.close();
-            const trimmed = answer.trim().toLowerCase();
-            resolve(trimmed === "y" || trimmed === "yes");
-        });
-    });
-}
-async function runKnObjectTypeCommand(args) {
-    const [action, ...rest] = args;
-    if (!action || action === "--help" || action === "-h") {
-        console.log(`kweaver bkn object-type list <kn-id> [--pretty] [-bd value]
-kweaver bkn object-type get <kn-id> <ot-id> [--pretty] [-bd value]
-kweaver bkn object-type create <kn-id> --name X --dataview-id Y --primary-key Z --display-key W [--property '<json>' ...]
-kweaver bkn object-type update <kn-id> <ot-id> [--name X] [--display-key Y] [--add-property|--update-property '<json>' ...] [--remove-property N ...] [--tags '["a","b"]'] [--comment S] [--icon I] [--color C] [--branch main]
-  kweaver bkn object-type update <kn-id> <ot-id> '<full-json-body>'
-kweaver bkn object-type delete <kn-id> <ot-ids> [-y]
-kweaver bkn object-type query <kn-id> <ot-id> ['<json>'] [--limit <n>] [--search-after '<json-array>'] [--pretty] [-bd value]
-kweaver bkn object-type properties <kn-id> <ot-id> '<json>' [--pretty] [-bd value]
-
-list: List object types (schema) from ontology-manager.
-get: Get single object type details.
-create/update/delete: Schema CRUD (create requires dataview-id). update: merge flags (--add-property / --update-property / --remove-property, etc.) GET-merge-PUT; or full JSON as third arg.
-query: Query via ontology-query API. Default limit is 50 if not specified. Use --search-after for pagination.
-properties: Query instance properties by primary key.
-
-properties JSON format: {"_instance_identities":[{"<primary-key>":"<value>"}],"properties":["prop1","prop2"]}`);
-        return 0;
-    }
-    try {
-        if (action === "get") {
-            const parsed = parseOntologyQueryFlags(rest);
-            const [knId, otId] = parsed.filteredArgs;
-            if (!knId || !otId) {
-                console.error("Usage: kweaver bkn object-type get <kn-id> <ot-id> [options]");
-                return 1;
-            }
-            const token = await ensureValidToken();
-            const body = await getObjectType({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId,
-                otId,
-                businessDomain: parsed.businessDomain,
-            });
-            console.log(formatCallOutput(body, parsed.pretty));
-            return 0;
-        }
-        if (action === "create") {
-            const opts = parseObjectTypeCreateArgs(rest);
-            const token = await ensureValidToken();
-            const body = await createObjectTypes({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId: opts.knId,
-                body: opts.body,
-                businessDomain: opts.businessDomain,
-                branch: opts.branch,
-            });
-            console.log(formatCallOutput(body, opts.pretty));
-            return 0;
-        }
-        if (action === "update") {
-            const opts = parseObjectTypeUpdateArgs(rest);
-            const token = await ensureValidToken();
-            let putBody;
-            if (opts.mode === "body") {
-                putBody = opts.body;
-            }
-            else {
-                const raw = await getObjectType({
-                    baseUrl: token.baseUrl,
-                    accessToken: token.accessToken,
-                    knId: opts.knId,
-                    otId: opts.otId,
-                    businessDomain: opts.businessDomain,
-                    branch: opts.branch,
-                });
-                const parsed = JSON.parse(raw);
-                const entryUnknown = parsed.entries;
-                const entry = Array.isArray(entryUnknown) && entryUnknown.length > 0 && entryUnknown[0] && typeof entryUnknown[0] === "object"
-                    ? entryUnknown[0]
-                    : parsed;
-                if (!entry || typeof entry !== "object") {
-                    throw new Error("Unexpected object-type GET response shape.");
-                }
-                const stripped = stripObjectTypeForPut(entry);
-                applyObjectTypeMerge(stripped, opts.merge);
-                putBody = JSON.stringify(stripped);
-            }
-            const body = await updateObjectType({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId: opts.knId,
-                otId: opts.otId,
-                body: putBody,
-                businessDomain: opts.businessDomain,
-            });
-            console.log(formatCallOutput(body, opts.pretty));
-            return 0;
-        }
-        if (action === "delete") {
-            const opts = parseObjectTypeDeleteArgs(rest);
-            if (!opts.yes) {
-                const confirmed = await confirmYes(`Delete object type(s) ${opts.otIds}?`);
-                if (!confirmed) {
-                    console.error("Aborted.");
-                    return 1;
-                }
-            }
-            const token = await ensureValidToken();
-            await deleteObjectTypes({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId: opts.knId,
-                otIds: opts.otIds,
-                businessDomain: opts.businessDomain,
-            });
-            console.log(`Deleted ${opts.otIds}`);
-            return 0;
-        }
-        if (action === "list") {
-            const parsed = parseOntologyQueryFlags(rest);
-            const [knId] = parsed.filteredArgs;
-            if (!knId) {
-                console.error("Usage: kweaver bkn object-type list <kn-id> [options]");
-                return 1;
-            }
-            const token = await ensureValidToken();
-            const body = await listObjectTypes({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId,
-                businessDomain: parsed.businessDomain,
-            });
-            console.log(formatCallOutput(body, parsed.pretty));
-            return 0;
-        }
-        if (action === "query") {
-            const options = parseKnObjectTypeQueryArgs(rest);
-            const token = await ensureValidToken();
-            const result = await objectTypeQuery({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId: options.knId,
-                otId: options.otId,
-                body: options.body,
-                businessDomain: options.businessDomain,
-            });
-            console.log(formatCallOutput(truncateQueryResult(result), options.pretty));
-            return 0;
-        }
-        if (action === "properties") {
-            const parsed = parseOntologyQueryFlags(rest);
-            const [knId, otId, body] = parsed.filteredArgs;
-            if (!knId || !otId || !body) {
-                console.error(`Usage: kweaver bkn object-type properties <kn-id> <ot-id> '<json>' [options]
-JSON: {"_instance_identities":[{"<primary-key>":"<value>"}],"properties":["prop1","prop2"]}`);
-                return 1;
-            }
-            const token = await ensureValidToken();
-            const result = await objectTypeProperties({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId,
-                otId,
-                body,
-                businessDomain: parsed.businessDomain,
-            });
-            console.log(formatCallOutput(result, parsed.pretty));
-            return 0;
-        }
-        console.error(`Unknown object-type action: ${action}. Use list, get, create, update, delete, query, or properties.`);
-        return 1;
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(`kweaver bkn object-type create <kn-id> --name X --dataview-id Y --primary-key Z --display-key W [--property '<json>' ...]
-kweaver bkn object-type update <kn-id> <ot-id> [--name X] [--display-key Y] [--add-property|--update-property '<json>' ...] [--remove-property N ...] [--tags '["a"]'] [--comment S] [--icon I] [--color C] [--branch main]
-  kweaver bkn object-type update <kn-id> <ot-id> '<full-json-body>'
-kweaver bkn object-type delete <kn-id> <ot-ids> [-y]`);
-            return 0;
-        }
-        console.error(formatHttpError(error));
-        return 1;
-    }
-}
-/** Parse relation-type create args: --name --source --target [--mapping src:tgt ...] */
-export function parseRelationTypeCreateArgs(args) {
-    let name = "";
-    let source = "";
-    let target = "";
-    let businessDomain = "";
-    let branch = "main";
-    let pretty = true;
-    const mappings = [];
-    const positional = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h")
-            throw new Error("help");
-        if (arg === "--name" && args[i + 1]) {
-            name = args[++i];
-            continue;
-        }
-        if (arg === "--source" && args[i + 1]) {
-            source = args[++i];
-            continue;
-        }
-        if (arg === "--target" && args[i + 1]) {
-            target = args[++i];
-            continue;
-        }
-        if (arg === "--mapping" && args[i + 1]) {
-            const m = args[++i];
-            if (!m.includes(":")) {
-                throw new Error(`Invalid mapping format '${m}'. Expected source_prop:target_prop.`);
-            }
-            const [s, t] = m.split(":", 2);
-            mappings.push([s, t]);
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[++i];
-            continue;
-        }
-        if (arg === "--branch" && args[i + 1]) {
-            branch = args[++i];
-            continue;
-        }
-        if (arg === "--pretty") {
-            pretty = true;
-            continue;
-        }
-        if (!arg.startsWith("-"))
-            positional.push(arg);
-    }
-    const knId = positional[0];
-    if (!knId || !name || !source || !target) {
-        throw new Error("Usage: kweaver bkn relation-type create <kn-id> --name X --source <ot-id> --target <ot-id> [--mapping src:tgt ...]");
-    }
-    const entry = {
-        branch,
-        name,
-        source_object_type_id: source,
-        target_object_type_id: target,
-        type: "direct",
-        mapping_rules: mappings.map(([s, t]) => ({
-            source_property: { name: s },
-            target_property: { name: t },
-        })),
-    };
-    const body = JSON.stringify({ entries: [entry] });
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { knId, body, businessDomain, branch, pretty };
-}
-/** Parse relation-type update args: [--name X] */
-function parseRelationTypeUpdateArgs(args) {
-    let name;
-    let businessDomain = "";
-    let pretty = true;
-    const positional = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h")
-            throw new Error("help");
-        if (arg === "--name" && args[i + 1]) {
-            name = args[++i];
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[++i];
-            continue;
-        }
-        if (arg === "--pretty") {
-            pretty = true;
-            continue;
-        }
-        if (!arg.startsWith("-"))
-            positional.push(arg);
-    }
-    const [knId, rtId] = positional;
-    if (!knId || !rtId) {
-        throw new Error("Usage: kweaver bkn relation-type update <kn-id> <rt-id> [--name X]");
-    }
-    if (name === undefined) {
-        throw new Error("No update fields. Use --name.");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { knId, rtId, body: JSON.stringify({ name }), businessDomain, pretty };
-}
-/** Parse relation-type delete args: <kn-id> <rt-ids> [-y] */
-function parseRelationTypeDeleteArgs(args) {
-    let businessDomain = "";
-    let yes = false;
-    const positional = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h")
-            throw new Error("help");
-        if (arg === "--yes" || arg === "-y") {
-            yes = true;
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[++i];
-            continue;
-        }
-        if (!arg.startsWith("-"))
-            positional.push(arg);
-    }
-    const [knId, rtIds] = positional;
-    if (!knId || !rtIds) {
-        throw new Error("Usage: kweaver bkn relation-type delete <kn-id> <rt-ids> [-y]");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { knId, rtIds, businessDomain, yes };
-}
-async function runKnRelationTypeCommand(args) {
-    const [action, ...rest] = args;
-    if (!action || action === "--help" || action === "-h") {
-        console.log(`kweaver bkn relation-type list <kn-id> [--pretty] [-bd value]
-kweaver bkn relation-type get <kn-id> <rt-id> [--pretty] [-bd value]
-kweaver bkn relation-type create <kn-id> --name X --source <ot-id> --target <ot-id> [--mapping src:tgt ...]
-kweaver bkn relation-type update <kn-id> <rt-id> [--name X]
-kweaver bkn relation-type delete <kn-id> <rt-ids> [-y]
-
-list: List relation types (schema) from ontology-manager.
-get: Get single relation type details.
-create/update/delete: Schema CRUD.`);
-        return 0;
-    }
-    try {
-        if (action === "get") {
-            const parsed = parseOntologyQueryFlags(rest);
-            const [knId, rtId] = parsed.filteredArgs;
-            if (!knId || !rtId) {
-                console.error("Usage: kweaver bkn relation-type get <kn-id> <rt-id> [options]");
-                return 1;
-            }
-            const token = await ensureValidToken();
-            const body = await getRelationType({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId,
-                rtId,
-                businessDomain: parsed.businessDomain,
-            });
-            console.log(formatCallOutput(body, parsed.pretty));
-            return 0;
-        }
-        if (action === "create") {
-            const opts = parseRelationTypeCreateArgs(rest);
-            const token = await ensureValidToken();
-            const body = await createRelationTypes({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId: opts.knId,
-                body: opts.body,
-                businessDomain: opts.businessDomain,
-                branch: opts.branch,
-            });
-            console.log(formatCallOutput(body, opts.pretty));
-            return 0;
-        }
-        if (action === "update") {
-            const opts = parseRelationTypeUpdateArgs(rest);
-            const token = await ensureValidToken();
-            const body = await updateRelationType({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId: opts.knId,
-                rtId: opts.rtId,
-                body: opts.body,
-                businessDomain: opts.businessDomain,
-            });
-            console.log(formatCallOutput(body, opts.pretty));
-            return 0;
-        }
-        if (action === "delete") {
-            const opts = parseRelationTypeDeleteArgs(rest);
-            if (!opts.yes) {
-                const confirmed = await confirmYes(`Delete relation type(s) ${opts.rtIds}?`);
-                if (!confirmed) {
-                    console.error("Aborted.");
-                    return 1;
-                }
-            }
-            const token = await ensureValidToken();
-            await deleteRelationTypes({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId: opts.knId,
-                rtIds: opts.rtIds,
-                businessDomain: opts.businessDomain,
-            });
-            console.log(`Deleted ${opts.rtIds}`);
-            return 0;
-        }
-        if (action === "list") {
-            const parsed = parseOntologyQueryFlags(rest);
-            const [knId] = parsed.filteredArgs;
-            if (!knId) {
-                console.error("Usage: kweaver bkn relation-type list <kn-id> [options]");
-                return 1;
-            }
-            const token = await ensureValidToken();
-            const body = await listRelationTypes({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId,
-                businessDomain: parsed.businessDomain,
-            });
-            console.log(formatCallOutput(body, parsed.pretty));
-            return 0;
-        }
-        console.error(`Unknown relation-type action: ${action}. Use list, get, create, update, or delete.`);
-        return 1;
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(`kweaver bkn relation-type create <kn-id> --name X --source <ot-id> --target <ot-id> [--mapping src:tgt ...]
-kweaver bkn relation-type update <kn-id> <rt-id> [--name X]
-kweaver bkn relation-type delete <kn-id> <rt-ids> [-y]`);
-            return 0;
-        }
-        console.error(formatHttpError(error));
-        return 1;
-    }
-}
-async function runKnSubgraphCommand(args) {
-    let filteredArgs;
-    let pretty;
-    let businessDomain;
-    try {
-        const parsed = parseOntologyQueryFlags(args);
-        filteredArgs = parsed.filteredArgs;
-        pretty = parsed.pretty;
-        businessDomain = parsed.businessDomain;
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(`kweaver bkn subgraph <kn-id> '<json>' [--pretty] [-bd value]
-
-Query subgraph via ontology-query API. JSON body format see references/json-formats.md#subgraph.`);
-            return 0;
-        }
-        throw error;
-    }
-    const [knId, body] = filteredArgs;
-    if (!knId || !body) {
-        console.error("Usage: kweaver bkn subgraph <kn-id> '<json>' [options]");
-        return 1;
-    }
-    try {
-        // Auto-detect query_type=relation_path when body contains source_object_type_id
-        let queryType;
-        try {
-            const parsedBody = JSON.parse(body);
-            if (parsedBody.source_object_type_id) {
-                queryType = "relation_path";
-            }
-        }
-        catch {
-            // Not valid JSON — let the API return the error
-        }
-        const token = await ensureValidToken();
-        const result = await subgraph({
-            baseUrl: token.baseUrl,
-            accessToken: token.accessToken,
-            knId,
-            body,
-            businessDomain,
-            queryType,
-        });
-        if (result.length > 100_000) {
-            console.error(`[warn] Response is ${(result.length / 1024).toFixed(0)}KB. Consider narrowing the subgraph query.`);
-        }
-        console.log(formatCallOutput(result, pretty));
-        return 0;
-    }
-    catch (error) {
-        console.error(formatHttpError(error));
-        return 1;
-    }
-}
-const TERMINAL_STATUSES = ["SUCCESS", "FAILED", "CANCELLED"];
-function extractExecutionId(body) {
-    try {
-        const data = JSON.parse(body);
-        const id = data.execution_id ?? data.id;
-        return typeof id === "string" ? id : null;
-    }
-    catch {
-        return null;
-    }
-}
-function extractStatus(body) {
-    try {
-        const data = JSON.parse(body);
-        const status = data.status;
-        return typeof status === "string" ? status : "";
-    }
-    catch {
-        return "";
-    }
-}
-async function runKnActionTypeCommand(args) {
-    const [action, ...rest] = args;
-    if (!action || action === "--help" || action === "-h") {
-        console.log(`kweaver bkn action-type list <kn-id> [--pretty] [-bd value]
-kweaver bkn action-type query <kn-id> <at-id> '<json>' [--pretty] [-bd value]
-kweaver bkn action-type execute <kn-id> <at-id> '<json>' [--pretty] [-bd value] [--wait|--no-wait] [--timeout n]
-
-list: List action types (schema) from ontology-manager.
-query/execute: Query or execute actions. execute has side effects - only use when explicitly requested.
-  --wait (default)    Poll until execution completes
-  --no-wait           Return immediately after starting execution
-  --timeout <seconds> Max wait time when --wait (default: 300)`);
-        return 0;
-    }
-    if (action === "list") {
-        try {
-            const parsed = parseOntologyQueryFlags(rest);
-            const [knId] = parsed.filteredArgs;
-            if (!knId) {
-                console.error("Usage: kweaver bkn action-type list <kn-id> [options]");
-                return 1;
-            }
-            const token = await ensureValidToken();
-            const body = await listActionTypes({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId,
-                businessDomain: parsed.businessDomain,
-            });
-            console.log(formatCallOutput(body, parsed.pretty));
-            return 0;
-        }
-        catch (error) {
-            console.error(formatHttpError(error));
-            return 1;
-        }
-    }
-    if (action === "query") {
-        let filteredArgs;
-        let pretty;
-        let businessDomain;
-        try {
-            const parsed = parseOntologyQueryFlags(rest);
-            filteredArgs = parsed.filteredArgs;
-            pretty = parsed.pretty;
-            businessDomain = parsed.businessDomain;
-        }
-        catch (error) {
-            if (error instanceof Error && error.message === "help")
-                return 0;
-            throw error;
-        }
-        const [knId, atId, body] = filteredArgs;
-        if (!knId || !atId || !body) {
-            console.error("Usage: kweaver bkn action-type query <kn-id> <at-id> '<json>' [options]");
-            return 1;
-        }
-        try {
-            const token = await ensureValidToken();
-            const result = await actionTypeQuery({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId,
-                atId,
-                body,
-                businessDomain,
-            });
-            console.log(formatCallOutput(result, pretty));
-            return 0;
-        }
-        catch (error) {
-            console.error(formatHttpError(error));
-            return 1;
-        }
-    }
-    if (action === "execute") {
-        let options;
-        try {
-            options = parseKnActionTypeExecuteArgs(rest);
-        }
-        catch (error) {
-            if (error instanceof Error && error.message === "help")
-                return 0;
-            console.error(formatHttpError(error));
-            return 1;
-        }
-        try {
-            const token = await ensureValidToken();
-            const base = {
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                knId: options.knId,
-                atId: options.atId,
-                body: options.body,
-                businessDomain: options.businessDomain,
-            };
-            const result = await actionTypeExecute(base);
-            if (!options.wait) {
-                console.log(formatCallOutput(result, options.pretty));
-                return 0;
-            }
-            const executionId = extractExecutionId(result);
-            if (!executionId) {
-                console.log(formatCallOutput(result, options.pretty));
-                return 0;
-            }
-            let lastBody = result;
-            try {
-                lastBody = await pollWithBackoff({
-                    fn: async () => {
-                        const status = extractStatus(lastBody);
-                        if (TERMINAL_STATUSES.includes(status.toUpperCase())) {
-                            return { done: true, value: lastBody };
-                        }
-                        lastBody = await actionExecutionGet({
-                            baseUrl: token.baseUrl,
-                            accessToken: token.accessToken,
-                            knId: options.knId,
-                            executionId,
-                            businessDomain: options.businessDomain,
-                        });
-                        return { done: false, value: lastBody };
-                    },
-                    interval: 2000,
-                    timeout: options.timeout * 1000,
-                });
-            }
-            catch {
-                console.error(`Action execution did not complete within ${options.timeout}s`);
-                console.log(formatCallOutput(lastBody, options.pretty));
-                return 1;
-            }
-            const finalStatus = extractStatus(lastBody);
-            console.log(formatCallOutput(lastBody, options.pretty));
-            return finalStatus.toUpperCase() === "SUCCESS" ? 0 : 1;
-        }
-        catch (error) {
-            console.error(formatHttpError(error));
-            return 1;
-        }
-    }
-    console.error(`Unknown action-type action: ${action}. Use list, query, or execute.`);
-    return 1;
-}
-async function runKnActionExecutionCommand(args) {
-    let filteredArgs;
-    let pretty;
-    let businessDomain;
-    try {
-        const parsed = parseOntologyQueryFlags(args);
-        filteredArgs = parsed.filteredArgs;
-        pretty = parsed.pretty;
-        businessDomain = parsed.businessDomain;
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(`kweaver bkn action-execution get <kn-id> <execution-id> [--pretty] [-bd value]
-
-Get action execution status.`);
-            return 0;
-        }
-        throw error;
-    }
-    const [subAction, knId, executionId] = filteredArgs;
-    if (subAction !== "get" || !knId || !executionId) {
-        console.error("Usage: kweaver bkn action-execution get <kn-id> <execution-id> [options]");
-        return 1;
-    }
-    try {
-        const token = await ensureValidToken();
-        const result = await actionExecutionGet({
-            baseUrl: token.baseUrl,
-            accessToken: token.accessToken,
-            knId,
-            executionId,
-            businessDomain,
-        });
-        console.log(formatCallOutput(result, pretty));
-        return 0;
-    }
-    catch (error) {
-        console.error(formatHttpError(error));
-        return 1;
-    }
-}
-async function runKnActionLogCommand(args) {
-    const [action, ...rest] = args;
-    if (!action || action === "--help" || action === "-h") {
-        console.log(`kweaver bkn action-log list <kn-id> [options]
-kweaver bkn action-log get <kn-id> <log-id> [options]
-kweaver bkn action-log cancel <kn-id> <log-id> [options]
-
-List/get execution logs. cancel has side effects - only use when explicitly requested.
-Options for list: --limit, --need-total, --action-type-id, --status, --trigger-type, --search-after`);
-        return 0;
-    }
-    let pretty = true;
-    let businessDomain = "";
-    let limit = 30;
-    let needTotal;
-    let actionTypeId;
-    let status;
-    let triggerType;
-    let searchAfter;
-    const filteredArgs = [];
-    for (let i = 0; i < rest.length; i += 1) {
-        const arg = rest[i];
-        if (arg === "--help" || arg === "-h") {
-            throw new Error("help");
-        }
-        if (arg === "--pretty") {
-            pretty = true;
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && rest[i + 1]) {
-            businessDomain = rest[i + 1];
-            i += 1;
-            continue;
-        }
-        if (arg === "--limit" && rest[i + 1]) {
-            limit = parseInt(rest[i + 1], 10);
-            i += 1;
-            continue;
-        }
-        if (arg === "--need-total" && rest[i + 1]) {
-            needTotal = rest[i + 1].toLowerCase() === "true";
-            i += 1;
-            continue;
-        }
-        if (arg === "--action-type-id" && rest[i + 1]) {
-            actionTypeId = rest[i + 1];
-            i += 1;
-            continue;
-        }
-        if (arg === "--status" && rest[i + 1]) {
-            status = rest[i + 1];
-            i += 1;
-            continue;
-        }
-        if (arg === "--trigger-type" && rest[i + 1]) {
-            triggerType = rest[i + 1];
-            i += 1;
-            continue;
-        }
-        if (arg === "--search-after" && rest[i + 1]) {
-            searchAfter = rest[i + 1];
-            i += 1;
-            continue;
-        }
-        filteredArgs.push(arg);
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    try {
-        const token = await ensureValidToken();
-        const base = {
-            baseUrl: token.baseUrl,
-            accessToken: token.accessToken,
-            businessDomain,
-        };
-        if (action === "list") {
-            const [knId] = filteredArgs;
-            if (!knId) {
-                console.error("Usage: kweaver bkn action-log list <kn-id> [options]");
-                return 1;
-            }
-            const result = await actionLogsList({
-                ...base,
-                knId,
-                limit,
-                needTotal,
-                actionTypeId,
-                status,
-                triggerType,
-                searchAfter,
-            });
-            console.log(formatCallOutput(result, pretty));
-            return 0;
-        }
-        if (action === "get") {
-            const [knId, logId] = filteredArgs;
-            if (!knId || !logId) {
-                console.error("Usage: kweaver bkn action-log get <kn-id> <log-id> [options]");
-                return 1;
-            }
-            const result = await actionLogGet({ ...base, knId, logId });
-            console.log(formatCallOutput(result, pretty));
-            return 0;
-        }
-        if (action === "cancel") {
-            const [knId, logId] = filteredArgs;
-            if (!knId || !logId) {
-                console.error("Usage: kweaver bkn action-log cancel <kn-id> <log-id> [options]");
-                return 1;
-            }
-            const result = await actionLogCancel({ ...base, knId, logId });
-            console.log(formatCallOutput(result, pretty));
-            return 0;
-        }
-        console.error(`Unknown action-log action: ${action}. Use list, get, or cancel.`);
-        return 1;
-    }
-    catch (error) {
-        console.error(formatHttpError(error));
-        return 1;
-    }
-}
-async function runKnListCommand(args) {
-    let options;
-    try {
-        options = parseKnListArgs(args);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(KN_LIST_HELP);
-            return 0;
-        }
-        console.error(formatHttpError(error));
-        return 1;
-    }
-    try {
-        const token = await ensureValidToken();
-        const body = await listKnowledgeNetworks({
-            baseUrl: token.baseUrl,
-            accessToken: token.accessToken,
-            businessDomain: options.businessDomain,
-            offset: options.offset,
-            limit: options.limit,
-            sort: options.sort,
-            direction: options.direction,
-            name_pattern: options.name_pattern,
-            tag: options.tag,
-        });
-        if (body) {
-            console.log(options.verbose
-                ? formatCallOutput(body, options.pretty)
-                : formatSimpleKnList(body, options.pretty, options.detail));
-        }
-        return 0;
-    }
-    catch (error) {
-        console.error(formatHttpError(error));
-        return 1;
-    }
-}
-const KN_LIST_HELP = `kweaver bkn list [options]
-
-List business knowledge networks from the ontology-manager API.
-
-Options:
-  --offset <n>       Offset (default: 0)
-  --limit <n>        Limit (default: 30)
-  --sort <key>       Sort field (default: update_time)
-  --direction <asc|desc>  Sort direction (default: desc)
-  --name-pattern <s> Filter by name pattern
-  --tag <s>          Filter by tag
-  --detail           Include the detail field in simplified output
-  --verbose, -v      Show full JSON response
-  -bd, --biz-domain <value>  Business domain (default: bd_public)
-  --pretty           Pretty-print JSON output (applies to both modes)`;
-const KN_GET_HELP = `kweaver bkn get <kn-id> [options]
-
-Get knowledge network detail.
-
-Options:
-  --stats            Include statistics
-  --export           Export mode (include sub-types)
-  -bd, --biz-domain <value>  Business domain (default: bd_public)
-  --pretty           Pretty-print JSON output`;
-const KN_CREATE_HELP = `kweaver bkn create [options]
-
-Create a knowledge network.
-
-Options:
-  --name <s>         Name (required unless --body-file)
-  --comment <s>      Comment
-  --tags <t1,t2>     Comma-separated tags
-  --icon <s>         Icon
-  --color <s>        Color
-  --branch <s>       Branch (default: main)
-  --base-branch <s>  Base branch (default: empty for main)
-  --body-file <path> Read full JSON body from file (cannot combine with flags above)
-  --import-mode <normal|ignore|overwrite>  Import mode (default: normal)
-  --validate-dependency <true|false>  Validate dependency (default: true)
-  -bd, --biz-domain <value>  Business domain (default: bd_public)
-  --pretty           Pretty-print JSON output`;
-const KN_UPDATE_HELP = `kweaver bkn update <kn-id> [options]
-
-Update a knowledge network.
-
-Options:
-  --name <s>         Name (required unless --body-file)
-  --comment <s>      Comment
-  --tags <t1,t2>     Comma-separated tags
-  --icon <s>         Icon
-  --color <s>        Color
-  --branch <s>       Branch (default: main)
-  --base-branch <s>  Base branch (default: empty for main)
-  --body-file <path> Read full JSON body from file (cannot combine with flags above)
-  -bd, --biz-domain <value>  Business domain (default: bd_public)
-  --pretty           Pretty-print JSON output`;
-const KN_DELETE_HELP = `kweaver bkn delete <kn-id>
-
-Delete a knowledge network and its object types, relation types, action types, and concept groups.
-
-Options:
-  --yes, -y          Skip confirmation prompt
-  -bd, --biz-domain <value>  Business domain (default: bd_public)`;
-async function runKnGetCommand(args) {
-    let options;
-    try {
-        options = parseKnGetArgs(args);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(KN_GET_HELP);
-            return 0;
-        }
-        console.error(formatHttpError(error));
-        return 1;
+        console.error(formatHttpError(error));
+        return 1;
     }
     try {
         const token = await ensureValidToken();
@@ -2054,303 +600,8 @@ async function runKnGetCommand(args) {
             accessToken: token.accessToken,
             knId: options.knId,
             businessDomain: options.businessDomain,
-            mode: options.export ? "export" : undefined,
-            include_statistics: options.stats ? true : undefined,
-        });
-        if (body) {
-            console.log(formatCallOutput(body, options.pretty));
-        }
-        return 0;
-    }
-    catch (error) {
-        console.error(formatHttpError(error));
-        return 1;
-    }
-}
-async function runKnCreateCommand(args) {
-    let options;
-    try {
-        options = parseKnCreateArgs(args);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(KN_CREATE_HELP);
-            return 0;
-        }
-        console.error(formatHttpError(error));
-        return 1;
-    }
-    try {
-        const token = await ensureValidToken();
-        const body = await createKnowledgeNetwork({
-            baseUrl: token.baseUrl,
-            accessToken: token.accessToken,
-            body: options.body,
-            businessDomain: options.businessDomain,
-            import_mode: options.import_mode,
-            validate_dependency: options.validate_dependency,
-        });
-        if (body) {
-            console.log(formatCallOutput(body, options.pretty));
-        }
-        return 0;
-    }
-    catch (error) {
-        console.error(formatHttpError(error));
-        return 1;
-    }
-}
-const KN_CREATE_FROM_DS_HELP = `kweaver bkn create-from-ds <ds-id> --name X [options]
-
-Create a knowledge network from a datasource (dataviews + object types + optional build).
-
-Options:
-  --name <s>       Knowledge network name (required)
-  --tables <a,b>   Comma-separated table names (default: all)
-  --build (default)  Build after creation
-  --no-build       Skip build after creation
-  --timeout <n>    Build timeout in seconds (default: 300)
-  -bd, --biz-domain  Business domain (default: bd_public)
-  --pretty         Pretty-print output (default)`;
-function parseKnCreateFromDsArgs(args) {
-    let dsId = "";
-    let name = "";
-    let tablesStr = "";
-    let build = true;
-    let timeout = 300;
-    let businessDomain = "";
-    let pretty = true;
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h")
-            throw new Error("help");
-        if (arg === "--name" && args[i + 1]) {
-            name = args[++i];
-            continue;
-        }
-        if (arg === "--tables" && args[i + 1]) {
-            tablesStr = args[++i];
-            continue;
-        }
-        if (arg === "--build") {
-            build = true;
-            continue;
-        }
-        if (arg === "--no-build") {
-            build = false;
-            continue;
-        }
-        if (arg === "--timeout" && args[i + 1]) {
-            timeout = parseInt(args[++i], 10);
-            if (Number.isNaN(timeout) || timeout < 1)
-                timeout = 300;
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[++i];
-            continue;
-        }
-        if (arg === "--pretty") {
-            pretty = true;
-            continue;
-        }
-        if (!arg.startsWith("-") && !dsId) {
-            dsId = arg;
-        }
-    }
-    const tables = tablesStr ? tablesStr.split(",").map((s) => s.trim()).filter(Boolean) : [];
-    if (!dsId || !name) {
-        throw new Error("Usage: kweaver bkn create-from-ds <ds-id> --name X [options]");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { dsId, name, tables, build, timeout, businessDomain, pretty };
-}
-/** Sanitize a table name into a BKN-safe ID (alphanumeric + underscore). */
-function sanitizeBknId(name) {
-    return name.replace(/[^a-zA-Z0-9_]/g, "_").replace(/^(\d)/, "_$1");
-}
-/** Generate a BKN ObjectType YAML markdown file for a table. */
-function generateObjectTypeBkn(tableName, dvId, pk, dk, columns) {
-    const safeId = sanitizeBknId(tableName);
-    const header = `## ObjectType: ${safeId}\n\n**${tableName}**\n`;
-    const dsTable = `### Data Source\n\n| Type | ID | Name |\n|------|-----|------|\n| data_view | ${dvId} | ${tableName} |\n`;
-    const dpHeader = `### Data Properties\n\n| Property | Display Name | Type | Primary Key | Display Key |\n|----------|-------------|------|-------------|-------------|\n`;
-    const dpRows = columns.map((c) => {
-        const isPk = c.name === pk ? "yes" : "no";
-        const isDk = c.name === dk ? "yes" : "no";
-        return `| ${c.name} | ${c.name} | string | ${isPk} | ${isDk} |`;
-    }).join("\n");
-    const frontmatter = `---\ntype: object_type\nid: ${safeId}\nname: ${tableName}\n---\n\n`;
-    return `${frontmatter}${header}\n${dsTable}\n${dpHeader}${dpRows}\n`;
-}
-async function runKnCreateFromDsCommand(args, sampleRows) {
-    let options;
-    try {
-        options = parseKnCreateFromDsArgs(args);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(KN_CREATE_FROM_DS_HELP);
-            return 0;
-        }
-        console.error(formatHttpError(error));
-        return 1;
-    }
-    try {
-        const token = await ensureValidToken();
-        const base = {
-            baseUrl: token.baseUrl,
-            accessToken: token.accessToken,
-            businessDomain: options.businessDomain,
-        };
-        const tablesBody = await listTablesWithColumns({ ...base, id: options.dsId });
-        const allTables = JSON.parse(tablesBody);
-        const targetTables = options.tables.length > 0
-            ? allTables.filter((t) => options.tables.includes(t.name))
-            : allTables;
-        if (targetTables.length === 0) {
-            console.error("No tables available");
-            return 1;
-        }
-        // Phase 1: Create DataViews for each table
-        console.error(`Creating data views for ${targetTables.length} table(s) ...`);
-        const viewMap = {};
-        for (const t of targetTables) {
-            const found = await findDataView({
-                ...base,
-                name: t.name,
-                datasourceId: options.dsId,
-                exact: true,
-                wait: true,
-            });
-            const dvId = found[0]?.id ??
-                (await createDataView({
-                    ...base,
-                    name: t.name,
-                    datasourceId: options.dsId,
-                    table: t.name,
-                    fields: t.columns.map((c) => ({ name: c.name, type: c.type })),
-                }));
-            viewMap[t.name] = dvId;
-        }
-        // Phase 2: Create the KN record
-        const knBody = JSON.stringify({
-            name: options.name,
-            branch: "main",
-            base_branch: "",
-        });
-        const knResponse = await createKnowledgeNetwork({
-            ...base,
-            body: knBody,
-        });
-        const knParsed = JSON.parse(knResponse);
-        const knItem = Array.isArray(knParsed) ? knParsed[0] : knParsed;
-        const knId = String(knItem?.id ?? "");
-        console.error(`Knowledge network created: ${knId}`);
-        // Phase 3: Create object types via REST API
-        console.error(`Creating ${targetTables.length} object type(s) ...`);
-        const otResults = [];
-        for (const t of targetTables) {
-            const pk = detectPrimaryKey(t, sampleRows?.[t.name]);
-            const dk = detectDisplayKey(t, pk);
-            const uniqueProps = [pk, dk].filter((x, i, a) => a.indexOf(x) === i);
-            const entry = {
-                branch: "main",
-                name: t.name,
-                data_source: { type: "data_view", id: viewMap[t.name] },
-                primary_keys: [pk],
-                display_key: dk,
-                data_properties: t.columns.map((c) => ({
-                    name: c.name,
-                    display_name: c.name,
-                    type: "string",
-                    mapped_field: { name: c.name, type: c.type || "varchar" },
-                })),
-            };
-            const otBody = JSON.stringify({ entries: [entry] });
-            const otResponse = await createObjectTypes({
-                ...base,
-                knId,
-                body: otBody,
-            });
-            const otParsed = JSON.parse(otResponse);
-            const otItem = otParsed.entries?.[0];
-            otResults.push({
-                name: t.name,
-                id: otItem?.id ?? "",
-                field_count: t.columns.length,
-            });
-            console.error(`  Created: ${t.name} (${t.columns.length} fields, pk=${pk}, dk=${dk})`);
-        }
-        if (otResults.length === 0) {
-            const errorOutput = {
-                kn_id: knId,
-                kn_name: options.name,
-                error: "No object types were created",
-            };
-            console.log(JSON.stringify(errorOutput, null, options.pretty ? 2 : 0));
-            return 1;
-        }
-        let statusStr = "skipped";
-        if (options.build) {
-            console.error("Building ...");
-            await buildKnowledgeNetwork({ ...base, knId });
-            const TERMINAL = ["completed", "failed", "success"];
-            try {
-                statusStr = await pollWithBackoff({
-                    fn: async () => {
-                        const statusBody = await getBuildStatus({ ...base, knId });
-                        const statusParsed = JSON.parse(statusBody);
-                        const jobs = Array.isArray(statusParsed) ? statusParsed : (statusParsed.entries ?? []);
-                        const state = (jobs[0]?.state ?? "running").toLowerCase();
-                        if (TERMINAL.includes(state))
-                            return { done: true, value: state };
-                        return { done: false, value: "running" };
-                    },
-                    interval: 2000,
-                    timeout: options.timeout * 1000,
-                });
-            }
-            catch {
-                // timeout — statusStr remains "skipped"
-            }
-        }
-        const output = {
-            kn_id: knId,
-            kn_name: options.name,
-            object_types: otResults,
-            status: statusStr,
-        };
-        console.log(JSON.stringify(output, null, options.pretty ? 2 : 0));
-        return 0;
-    }
-    catch (error) {
-        console.error(formatHttpError(error));
-        return 1;
-    }
-}
-async function runKnUpdateCommand(args) {
-    let options;
-    try {
-        options = parseKnUpdateArgs(args);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(KN_UPDATE_HELP);
-            return 0;
-        }
-        console.error(formatHttpError(error));
-        return 1;
-    }
-    try {
-        const token = await ensureValidToken();
-        const body = await updateKnowledgeNetwork({
-            baseUrl: token.baseUrl,
-            accessToken: token.accessToken,
-            knId: options.knId,
-            body: options.body,
-            businessDomain: options.businessDomain,
+            mode: options.export ? "export" : undefined,
+            include_statistics: options.stats ? true : undefined,
         });
         if (body) {
             console.log(formatCallOutput(body, options.pretty));
@@ -2362,44 +613,32 @@ async function runKnUpdateCommand(args) {
         return 1;
     }
 }
-function confirmDelete(knId) {
-    return new Promise((resolve) => {
-        const rl = createInterface({ input: process.stdin, output: process.stdout });
-        rl.question(`Delete knowledge network ${knId}? [y/N] `, (answer) => {
-            rl.close();
-            const trimmed = answer.trim().toLowerCase();
-            resolve(trimmed === "y" || trimmed === "yes");
-        });
-    });
-}
-async function runKnDeleteCommand(args) {
+async function runKnCreateCommand(args) {
     let options;
     try {
-        options = parseKnDeleteArgs(args);
+        options = parseKnCreateArgs(args);
     }
     catch (error) {
         if (error instanceof Error && error.message === "help") {
-            console.log(KN_DELETE_HELP);
+            console.log(KN_CREATE_HELP);
             return 0;
         }
         console.error(formatHttpError(error));
         return 1;
     }
-    if (!options.yes) {
-        const confirmed = await confirmDelete(options.knId);
-        if (!confirmed) {
-            console.error("Aborted.");
-            return 1;
-        }
-    }
     try {
         const token = await ensureValidToken();
-        await deleteKnowledgeNetwork({
+        const body = await createKnowledgeNetwork({
             baseUrl: token.baseUrl,
             accessToken: token.accessToken,
-            knId: options.knId,
+            body: options.body,
             businessDomain: options.businessDomain,
+            import_mode: options.import_mode,
+            validate_dependency: options.validate_dependency,
         });
+        if (body) {
+            console.log(formatCallOutput(body, options.pretty));
+        }
         return 0;
     }
     catch (error) {
@@ -2407,423 +646,76 @@ async function runKnDeleteCommand(args) {
         return 1;
     }
 }
-const KN_BUILD_HELP = `kweaver bkn build <kn-id> [options]
-
-Trigger a full build for a knowledge network.
-
-Options:
-  --wait (default)     Poll until build completes
-  --no-wait            Return immediately after triggering
-  --timeout <seconds>  Max wait time when --wait (default: 300)
-  -bd, --biz-domain    Business domain (default: bd_public)`;
-export function parseKnBuildArgs(args) {
-    let knId = "";
-    let wait = true;
-    let timeout = 300;
-    let businessDomain = "";
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h")
-            throw new Error("help");
-        if (arg === "--wait") {
-            wait = true;
-            continue;
-        }
-        if (arg === "--no-wait") {
-            wait = false;
-            continue;
-        }
-        if (arg === "--timeout" && args[i + 1]) {
-            timeout = parseInt(args[i + 1], 10);
-            if (Number.isNaN(timeout) || timeout < 1)
-                timeout = 300;
-            i += 1;
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[i + 1];
-            i += 1;
-            continue;
-        }
-        if (!arg.startsWith("-") && !knId) {
-            knId = arg;
-        }
-    }
-    if (!knId) {
-        throw new Error("Missing kn-id. Usage: kweaver bkn build <kn-id> [options]");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { knId, wait, timeout, businessDomain };
-}
-async function runKnBuildCommand(args) {
+async function runKnUpdateCommand(args) {
     let options;
     try {
-        options = parseKnBuildArgs(args);
+        options = parseKnUpdateArgs(args);
     }
     catch (error) {
         if (error instanceof Error && error.message === "help") {
-            console.log(KN_BUILD_HELP);
+            console.log(KN_UPDATE_HELP);
             return 0;
         }
         console.error(formatHttpError(error));
         return 1;
     }
-    const TERMINAL_STATES = ["completed", "failed", "success"];
     try {
         const token = await ensureValidToken();
-        await buildKnowledgeNetwork({
+        const body = await updateKnowledgeNetwork({
             baseUrl: token.baseUrl,
             accessToken: token.accessToken,
             knId: options.knId,
+            body: options.body,
             businessDomain: options.businessDomain,
         });
-        console.error(`Build started for ${options.knId}`);
-        if (!options.wait) {
-            console.error("Build triggered (not waiting).");
-            return 0;
-        }
-        console.error("Waiting for build to complete ...");
-        try {
-            const { state, detail } = await pollWithBackoff({
-                fn: async () => {
-                    const body = await getBuildStatus({
-                        baseUrl: token.baseUrl,
-                        accessToken: token.accessToken,
-                        knId: options.knId,
-                        businessDomain: options.businessDomain,
-                    });
-                    const parsed = JSON.parse(body);
-                    const jobs = Array.isArray(parsed) ? parsed : (parsed.entries ?? parsed.data ?? []);
-                    const job = jobs[0];
-                    const st = (job?.state ?? "running").toLowerCase();
-                    const dt = job?.state_detail;
-                    if (TERMINAL_STATES.includes(st))
-                        return { done: true, value: { state: st, detail: dt } };
-                    return { done: false, value: { state: st } };
-                },
-                interval: 2000,
-                timeout: options.timeout * 1000,
-            });
-            console.log(state);
-            if (detail) {
-                console.log(`Detail: ${detail}`);
-            }
-            return state === "failed" ? 1 : 0;
-        }
-        catch {
-            console.error(`Build did not complete within ${options.timeout}s`);
-            return 1;
+        if (body) {
+            console.log(formatCallOutput(body, options.pretty));
         }
+        return 0;
     }
     catch (error) {
         console.error(formatHttpError(error));
         return 1;
     }
 }
-// ── push / pull (BKN tar import/export) ──────────────────────────────────────
-export function packDirectoryToTar(dirPath) {
-    const absPath = resolve(dirPath);
-    const entries = readdirSync(absPath);
-    const args = ["cf", "-", "-C", absPath, ...entries];
-    const result = spawnSync("tar", args, {
-        encoding: "buffer",
-        env: { ...process.env, COPYFILE_DISABLE: "1" },
-    });
-    if (result.error) {
-        if ("code" in result.error && result.error.code === "ENOENT") {
-            throw new Error("tar executable not found. On Windows, ensure tar.exe is in PATH " +
-                "(ships with Windows 10 1803+) or install GNU tar via Git for Windows / scoop.");
-        }
-        throw result.error;
-    }
-    if (result.status !== 0) {
-        throw new Error(`tar pack failed: ${result.stderr?.toString() ?? result.status}`);
-    }
-    return result.stdout;
-}
-export function extractTarToDirectory(tarBuffer, dirPath) {
-    const absPath = resolve(dirPath);
-    mkdirSync(absPath, { recursive: true });
-    const result = spawnSync("tar", ["xf", "-", "-C", absPath], {
-        input: tarBuffer,
+function confirmDelete(knId) {
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(`Delete knowledge network ${knId}? [y/N] `, (answer) => {
+            rl.close();
+            const trimmed = answer.trim().toLowerCase();
+            resolve(trimmed === "y" || trimmed === "yes");
+        });
     });
-    if (result.error) {
-        if ("code" in result.error && result.error.code === "ENOENT") {
-            throw new Error("tar executable not found. On Windows, ensure tar.exe is in PATH " +
-                "(ships with Windows 10 1803+) or install GNU tar via Git for Windows / scoop.");
-        }
-        throw result.error;
-    }
-    if (result.status !== 0) {
-        throw new Error(`tar extract failed: ${result.stderr?.toString() ?? result.status}`);
-    }
-}
-const KN_PUSH_HELP = `kweaver bkn push <directory> [options]
-
-Pack a BKN directory into a tar and upload to import as a knowledge network.
-
-Options:
-  --branch <s>       Branch name (default: main)
-  -bd, --biz-domain  Business domain (default: bd_public)
-  --pretty           Pretty-print JSON output
-  --detect-encoding  Detect .bkn encoding and normalize to UTF-8 (default: on)
-  --no-detect-encoding  Do not detect; require UTF-8 .bkn files
-  --source-encoding <name>  Decode all .bkn files with this encoding (e.g. gb18030); overrides detection`;
-const KN_PULL_HELP = `kweaver bkn pull <kn-id> [<directory>] [options]
-
-Download a BKN tar from a knowledge network and extract to a local directory.
-
-Options:
-  <directory>        Output directory (default: <kn-id>)
-  --branch <s>       Branch name (default: main)
-  -bd, --biz-domain  Business domain (default: bd_public)`;
-async function runKnValidateCommand(args) {
-    if (args.includes("--help") || args.includes("-h")) {
-        console.log("Usage: kweaver bkn validate <directory> [options]\n\n" +
-            "Validate a local BKN directory without uploading.\n\n" +
-            "Options:\n" +
-            "  --detect-encoding       Detect .bkn encoding and normalize to UTF-8 (default: on)\n" +
-            "  --no-detect-encoding    Require UTF-8 .bkn files\n" +
-            "  --source-encoding <n>   Decode all .bkn with this encoding (e.g. gb18030)");
-        return 0;
-    }
-    let encodingOptions;
-    let restArgs;
-    try {
-        const stripped = stripBknEncodingCliArgs(args);
-        encodingOptions = stripped.options;
-        restArgs = stripped.rest;
-    }
-    catch (e) {
-        console.error(e instanceof Error ? e.message : String(e));
-        return 1;
-    }
-    const directory = restArgs.find((a) => !a.startsWith("-"));
-    if (!directory) {
-        console.error("Missing directory. Usage: kweaver bkn validate <directory> [options]");
-        return 1;
-    }
-    const absDir = resolve(directory);
-    try {
-        const stat = statSync(absDir);
-        if (!stat.isDirectory()) {
-            console.error(`Not a directory: ${directory}`);
-            return 1;
-        }
-    }
-    catch (err) {
-        if (err && typeof err === "object" && "code" in err && err.code === "ENOENT") {
-            console.error(`Directory not found: ${directory}`);
-            return 1;
-        }
-        throw err;
-    }
-    const prepared = prepareBknDirectoryForImport(absDir, encodingOptions);
-    try {
-        const network = await loadNetwork(prepared.dir);
-        const result = validateNetwork(network);
-        if (!result.ok) {
-            for (const e of result.errors)
-                console.error(`  - ${e}`);
-            console.error(`BKN validation failed: ${result.errors.length} error(s)`);
-            return 1;
-        }
-        const objs = allObjects(network);
-        const rels = allRelations(network);
-        const acts = allActions(network);
-        console.log(`Valid: ${objs.length} object types, ${rels.length} relation types, ${acts.length} action types`);
-        return 0;
-    }
-    catch (error) {
-        console.error(`BKN validation failed: ${error instanceof Error ? error.message : String(error)}`);
-        return 1;
-    }
-    finally {
-        prepared.cleanup();
-    }
 }
-async function runKnPushCommand(args) {
+async function runKnDeleteCommand(args) {
     let options;
     try {
-        options = parseKnPushArgs(args);
+        options = parseKnDeleteArgs(args);
     }
     catch (error) {
         if (error instanceof Error && error.message === "help") {
-            console.log(KN_PUSH_HELP);
+            console.log(KN_DELETE_HELP);
             return 0;
         }
         console.error(formatHttpError(error));
         return 1;
     }
-    const absDir = resolve(options.directory);
-    try {
-        const stat = statSync(absDir);
-        if (!stat.isDirectory()) {
-            console.error(`Not a directory: ${options.directory}`);
-            return 1;
-        }
-    }
-    catch (err) {
-        if (err && typeof err === "object" && "code" in err && err.code === "ENOENT") {
-            console.error(`Directory not found: ${options.directory}`);
-            return 1;
-        }
-        throw err;
-    }
-    const prepared = prepareBknDirectoryForImport(absDir, options.encodingOptions);
-    const workDir = prepared.dir;
-    try {
-        try {
-            const network = await loadNetwork(workDir);
-            const objs = allObjects(network);
-            const rels = allRelations(network);
-            const acts = allActions(network);
-            console.error(`Validated: ${objs.length} object types, ${rels.length} relation types, ${acts.length} action types`);
-        }
-        catch (error) {
-            console.error(`BKN validation failed: ${error instanceof Error ? error.message : String(error)}`);
-            return 1;
-        }
-        try {
-            await generateChecksum(workDir);
-            console.error("Checksum generated");
-        }
-        catch (error) {
-            console.error(`Checksum generation failed: ${error instanceof Error ? error.message : String(error)}`);
-            return 1;
-        }
-        try {
-            const tarBuffer = packDirectoryToTar(workDir);
-            const token = await ensureValidToken();
-            const body = await uploadBkn({
-                baseUrl: token.baseUrl,
-                accessToken: token.accessToken,
-                tarBuffer,
-                businessDomain: options.businessDomain,
-                branch: options.branch,
-            });
-            console.log(formatCallOutput(body, options.pretty));
-            return 0;
-        }
-        catch (error) {
-            console.error(formatHttpError(error));
+    if (!options.yes) {
+        const confirmed = await confirmDelete(options.knId);
+        if (!confirmed) {
+            console.error("Aborted.");
             return 1;
         }
     }
-    finally {
-        prepared.cleanup();
-    }
-}
-async function runKnPullCommand(args) {
-    let options;
-    try {
-        options = parseKnPullArgs(args);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(KN_PULL_HELP);
-            return 0;
-        }
-        console.error(formatHttpError(error));
-        return 1;
-    }
-    try {
-        const token = await ensureValidToken();
-        const tarBuffer = await downloadBkn({
-            baseUrl: token.baseUrl,
-            accessToken: token.accessToken,
-            knId: options.knId,
-            businessDomain: options.businessDomain,
-            branch: options.branch,
-        });
-        const absDir = resolve(options.directory);
-        extractTarToDirectory(tarBuffer, absDir);
-        console.log(`Extracted to ${absDir}`);
-        return 0;
-    }
-    catch (error) {
-        console.error(formatHttpError(error));
-        return 1;
-    }
-}
-// ── search ──────────────────────────────────────────────────────────────────
-const KN_SEARCH_HELP = `kweaver bkn search <kn-id> <query> [--max-concepts <n>] [--mode <mode>] [--pretty] [-bd value]
-
-Semantic search within a knowledge network via agent-retrieval API.
-Returns matched concepts (object types, relation types, action types).
-
-Options:
-  --max-concepts <n>   Max concepts to return (default: 10)
-  --mode <mode>        Search mode (default: keyword_vector_retrieval)
-  --pretty             Pretty-print JSON output
-  -bd, --biz-domain    Override x-business-domain`;
-export function parseKnSearchArgs(args) {
-    let knId = "";
-    let query = "";
-    let maxConcepts = 10;
-    let mode = "keyword_vector_retrieval";
-    let pretty = false;
-    let businessDomain = process.env.KWEAVER_BUSINESS_DOMAIN ?? "";
-    const positional = [];
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg === "--max-concepts") {
-            maxConcepts = Number(args[++i]);
-        }
-        else if (arg === "--mode") {
-            mode = args[++i];
-        }
-        else if (arg === "--pretty") {
-            pretty = true;
-        }
-        else if (arg === "-bd" || arg === "--biz-domain") {
-            businessDomain = args[++i];
-        }
-        else if (arg === "--help" || arg === "-h") {
-            throw Object.assign(new Error("help"), { isHelp: true });
-        }
-        else if (arg.startsWith("-")) {
-            throw new Error(`Unknown flag: ${arg}`);
-        }
-        else {
-            positional.push(arg);
-        }
-    }
-    knId = positional[0] ?? "";
-    query = positional.slice(1).join(" ");
-    if (!knId || !query) {
-        throw new Error("Usage: kweaver bkn search <kn-id> <query> [options]");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { knId, query, maxConcepts, mode, pretty, businessDomain };
-}
-async function runKnSearchCommand(args) {
-    let options;
-    try {
-        options = parseKnSearchArgs(args);
-    }
-    catch (error) {
-        if (error instanceof Error && error.isHelp) {
-            console.log(KN_SEARCH_HELP);
-            return 0;
-        }
-        console.error(error instanceof Error ? error.message : String(error));
-        return 1;
-    }
     try {
         const token = await ensureValidToken();
-        const result = await semanticSearch({
+        await deleteKnowledgeNetwork({
             baseUrl: token.baseUrl,
             accessToken: token.accessToken,
             knId: options.knId,
-            query: options.query,
             businessDomain: options.businessDomain,
-            maxConcepts: options.maxConcepts,
-            mode: options.mode,
         });
-        console.log(formatCallOutput(result, options.pretty));
         return 0;
     }
     catch (error) {
@@ -2831,149 +723,3 @@ async function runKnSearchCommand(args) {
         return 1;
     }
 }
-const KN_CREATE_FROM_CSV_HELP = `kweaver bkn create-from-csv <ds-id> --files <glob> --name X [options]
-
-Import CSV files into datasource, then create a knowledge network.
-
-Options:
-  --files <s>          CSV file paths (comma-separated or glob, required)
-  --name <s>           Knowledge network name (required)
-  --table-prefix <s>   Table name prefix (default: none)
-  --batch-size <n>     Rows per batch (default: 500)
-  --tables <a,b>       Tables to include in KN (default: all imported)
-  --build (default)    Build after creation
-  --no-build           Skip build
-  --timeout <n>        Build timeout in seconds (default: 300)
-  -bd, --biz-domain    Business domain (default: bd_public)`;
-function parseKnCreateFromCsvArgs(args) {
-    let dsId = "";
-    let files = "";
-    let name = "";
-    let tablePrefix = "";
-    let batchSize = 500;
-    let tablesStr = "";
-    let build = true;
-    let timeout = 300;
-    let businessDomain = "";
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h")
-            throw new Error("help");
-        if (arg === "--files" && args[i + 1]) {
-            files = args[++i];
-            continue;
-        }
-        if (arg === "--name" && args[i + 1]) {
-            name = args[++i];
-            continue;
-        }
-        if (arg === "--table-prefix" && args[i + 1]) {
-            tablePrefix = args[++i];
-            continue;
-        }
-        if (arg === "--batch-size" && args[i + 1]) {
-            batchSize = parseInt(args[++i], 10);
-            if (Number.isNaN(batchSize) || batchSize < 1)
-                batchSize = 500;
-            continue;
-        }
-        if (arg === "--tables" && args[i + 1]) {
-            tablesStr = args[++i];
-            continue;
-        }
-        if (arg === "--build") {
-            build = true;
-            continue;
-        }
-        if (arg === "--no-build") {
-            build = false;
-            continue;
-        }
-        if (arg === "--timeout" && args[i + 1]) {
-            timeout = parseInt(args[++i], 10);
-            if (Number.isNaN(timeout) || timeout < 1)
-                timeout = 300;
-            continue;
-        }
-        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
-            businessDomain = args[++i];
-            continue;
-        }
-        if (!arg.startsWith("-") && !dsId) {
-            dsId = arg;
-        }
-    }
-    const tables = tablesStr ? tablesStr.split(",").map((s) => s.trim()).filter(Boolean) : [];
-    if (!dsId || !files || !name) {
-        throw new Error("Usage: kweaver bkn create-from-csv <ds-id> --files <glob> --name X [options]");
-    }
-    if (!businessDomain)
-        businessDomain = resolveBusinessDomain();
-    return { dsId, files, name, tablePrefix, batchSize, tables, build, timeout, businessDomain };
-}
-async function runKnCreateFromCsvCommand(args) {
-    let options;
-    try {
-        options = parseKnCreateFromCsvArgs(args);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "help") {
-            console.log(KN_CREATE_FROM_CSV_HELP);
-            return 0;
-        }
-        console.error(formatHttpError(error));
-        return 1;
-    }
-    // Phase 1: Import CSVs
-    console.error("Phase 1: Importing CSVs ...");
-    const importArgs = [
-        options.dsId,
-        "--files", options.files,
-        "--table-prefix", options.tablePrefix,
-        "--batch-size", String(options.batchSize),
-        "-bd", options.businessDomain,
-    ];
-    const importResult = await runDsImportCsv(importArgs);
-    if (importResult.code !== 0) {
-        console.error("CSV import failed — aborting KN creation");
-        return importResult.code;
-    }
-    // Phase 1.5: Scan datasource metadata so platform discovers newly imported tables
-    console.error("Scanning datasource metadata ...");
-    try {
-        const token = await ensureValidToken();
-        const dsBody = await getDatasource({
-            baseUrl: token.baseUrl,
-            accessToken: token.accessToken,
-            id: options.dsId,
-            businessDomain: options.businessDomain,
-        });
-        const dsParsed = JSON.parse(dsBody);
-        await scanMetadata({
-            baseUrl: token.baseUrl,
-            accessToken: token.accessToken,
-            id: options.dsId,
-            dsType: dsParsed.type ?? "mysql",
-            businessDomain: options.businessDomain,
-        });
-    }
-    catch (err) {
-        console.error(`Scan warning (continuing): ${String(err)}`);
-    }
-    // Phase 2: Create KN from datasource
-    console.error("Phase 2: Creating knowledge network ...");
-    const tableNames = options.tables.length > 0 ? options.tables : importResult.tables;
-    if (tableNames.length === 0) {
-        console.error("No tables available for KN creation — aborting");
-        return 1;
-    }
-    const knArgs = [
-        options.dsId,
-        "--name", options.name,
-        "--tables", tableNames.join(","),
-        options.build ? "--build" : "--no-build",
-        "--timeout", String(options.timeout),
-        "-bd", options.businessDomain,
-    ];
-    return runKnCreateFromDsCommand(knArgs, importResult.sampleRows);
-}