@deepexi/datasense-cli 2.0.4 → 3.0.1

package/README.md

@@ -1,88 +1,88 @@
-# ontos
-
-Ontos 平台命令行工具。npm 包名为 `@deepexi/datasense-cli`，终端命令为 `ontos`。
-
-需要 Node.js ≥22.12.0 与 npm。
-
-## 安装
-
-向目标环境安装，不要直接 `npm install -g @deepexi/datasense-cli@latest`：
-
-```bash
-curl -fsSL https://your-host/api/cli/install.sh | sh -s -- https://your-host
-ontos auth host set https://your-host
-```
-
-Windows 使用 `/api/cli/install.ps1`。安装脚本会按该 host 的兼容清单安装对应版本。
-
-升级：
-
-```bash
-ontos update          # 按当前 host 兼容范围升级
-ontos update --check  # 只查看，不安装
-```
-
-查看 CLI 版本：`ontos -v` / `ontos --version`。子命令里的 `--version <n>` 是该命令自己的版本参数，例如 `kb cat`。
-
-## 快速开始
-
-```bash
-ontos auth host set https://your-host
-ontos auth login
-ontos project list
-ontos project set <name>
-```
-
-`project set` 会在当前目录写入 `ontos.yaml`。
-
-## 常用命令
-
-| 命令 | 说明 |
-| :--- | :--- |
-| `auth` | 登录、退出、查看会话；`host get` / `host set` |
-| `project` | 项目列表、落地与成员 |
-| `update` | 按当前 host 升级 CLI |
-| `skill list` / `skill install` / `skill context` / `skill prune` | 列出、安装技能存根，运行时取技能内容，清理已下线存根 |
-| `query` | 只读查询 |
-| `search` | 检索对象 |
-| `execute` | 执行动作 |
-| `compute` | 执行已发布函数 |
-| `kb` | 知识库读取：`ls` / `cat` / `fetch` / `history` / `search` |
-| `simulation` | 场景推演 |
-| `admin` | 平台管理（租户、环境、资源、同步、校验等），详见 `ontos admin --help` |
-
-完整命令与参数以 `ontos --help` 和各子命令 `--help` 为准。
-
-## 技能
-
-`ontos skill install <skill...>` 只在当前目录写入技能存根（一份 `SKILL.md`：触发描述、所属项目，以及「先运行 `ontos skill context <name>`」）。默认同时写入 `.opencode/skills`、`.agents/skills`、`.claude/skills`；`--agent` 选择子集，`--global` 写到各宿主的用户目录。能力内容不落盘：agent 每次用 `ontos skill context <name>` 按当前身份、环境和快照取得；`--ref <path>` 取单篇参考。平台升级和项目发布后不用重装。`skill context` 与 `kb cat` 默认一次输出全文并带行号：首行给行号范围与补读命令，末行是 `[end …]`；空行不带行号，单行超过 500 字截断。宿主截断输出时，agent 从行号断档或缺失的末行发现，用 `--offset <行> --limit <行数>` 补读。需要分段时用 `--limit`，或设 `ONTOS_PAGE_LINES` / `ONTOS_PAGE_CHARS`（每段非空行数 / 正文字符数，缺省的一项取 240 / 26000）。脚本要不带行号的原文，用 `--raw` 或把输出重定向到文件。技能删了用 `ontos skill prune` 清掉本地存根。
-
-Grok 和 Codex 在仓库未被信任时不加载项目级技能，把仓库标为信任后才会看到存根。OpenCode v1 不热加载技能文件，存根改写之后要新开一个会话，description 才会更新；`ontos skill context` 取到的内容不受影响。
-
-## 输出
-
-默认输出 Markdown 表格。脚本与编排器请显式使用 `--format json`（或 `ONTOS_FORMAT=json`）。
-
-失败时错误 JSON 写在 stderr，含稳定的 `code` 字段；不要解析 `message` 文本。退出码：`0` 成功，`2` 用法/配置/输入错误，`1` 运行时或远端失败。
-
-## 项目清单
-
-每个项目目录一份 `ontos.yaml`：
-
-```yaml
-tenant: acme
-project: sales
-specDir: ./spec
-sync:
-  domains: [ontology]
-```
-
-```bash
-ontos --cwd ./sales project list
-ontos --cwd ./sales admin sync diff
-```
-
-- `--cwd` 指定工作目录；`--manifest` 显式指定清单文件。
-- 自动发现从当前目录向上查找，止于最近 Git 根或用户主目录。
-- 切换已绑定项目使用 `--cwd` / `--manifest`。覆盖已有绑定需 `ontos project set --rebind`。
-- 清单不存放登录凭据。更换 `auth host set` 后需要重新登录。
+# ontos
+
+Ontos 平台命令行工具。npm 包名为 `@deepexi/datasense-cli`，终端命令为 `ontos`。
+
+需要 Node.js ≥22.12.0 与 npm。
+
+## 安装
+
+向目标环境安装，不要直接 `npm install -g @deepexi/datasense-cli@latest`：
+
+```bash
+curl -fsSL https://your-host/api/cli/install.sh | sh -s -- https://your-host
+ontos auth host set https://your-host
+```
+
+Windows 使用 `/api/cli/install.ps1`。安装脚本会按该 host 的兼容清单安装对应版本。
+
+升级：
+
+```bash
+ontos update          # 按当前 host 兼容范围升级
+ontos update --check  # 只查看，不安装
+```
+
+查看 CLI 版本：`ontos -v` / `ontos --version`。子命令里的 `--version <n>` 是该命令自己的版本参数，例如 `kb cat`。
+
+## 快速开始
+
+```bash
+ontos auth host set https://your-host
+ontos auth login
+ontos project list
+ontos project set <name>
+```
+
+`project set` 会在当前目录写入 `ontos.yaml`。
+
+## 常用命令
+
+| 命令 | 说明 |
+| :--- | :--- |
+| `auth` | 登录、退出、查看会话；`host get` / `host set` |
+| `project` | 项目列表、落地与成员 |
+| `update` | 按当前 host 升级 CLI |
+| `skill list` / `skill install` / `skill context` / `skill prune` | 列出、安装技能存根，运行时取技能内容，清理已下线存根 |
+| `query` | 只读查询 |
+| `search` | 检索对象 |
+| `execute` | 执行动作 |
+| `compute` | 执行已发布函数 |
+| `kb` | 知识库读取：`ls` / `cat` / `fetch` / `history` / `search` |
+| `simulation` | 场景推演 |
+| `admin` | 平台管理（租户、环境、资源、同步、校验等），详见 `ontos admin --help` |
+
+完整命令与参数以 `ontos --help` 和各子命令 `--help` 为准。
+
+## 技能
+
+`ontos skill install <skill...>` 只在当前目录写入技能存根（一份 `SKILL.md`：触发描述、所属项目，以及「先运行 `ontos skill context <name>`」）。默认同时写入 `.opencode/skills`、`.agents/skills`、`.claude/skills`；`--agent` 选择子集，`--global` 写到各宿主的用户目录。能力内容不落盘：agent 每次用 `ontos skill context <name>` 按当前身份、环境和快照取得；`--ref <path>` 取单篇参考。平台升级和项目发布后不用重装。`skill context` 与 `kb cat` 默认一次输出全文并带行号：首行给行号范围与补读命令，末行是 `[end …]`；空行不带行号，单行超过 500 字截断。宿主截断输出时，agent 从行号断档或缺失的末行发现，用 `--offset <行> --limit <行数>` 补读。需要分段时用 `--limit`，或设 `ONTOS_PAGE_LINES` / `ONTOS_PAGE_CHARS`（每段非空行数 / 正文字符数，缺省的一项取 240 / 26000）。脚本要不带行号的原文，用 `--raw` 或把输出重定向到文件。技能删了用 `ontos skill prune` 清掉本地存根。
+
+Grok 和 Codex 在仓库未被信任时不加载项目级技能，把仓库标为信任后才会看到存根。OpenCode v1 不热加载技能文件，存根改写之后要新开一个会话，description 才会更新；`ontos skill context` 取到的内容不受影响。
+
+## 输出
+
+默认输出 Markdown 表格。脚本与编排器请显式使用 `--format json`（或 `ONTOS_FORMAT=json`）。
+
+失败时错误 JSON 写在 stderr，含稳定的 `code` 字段；不要解析 `message` 文本。退出码：`0` 成功，`2` 用法/配置/输入错误，`1` 运行时或远端失败。
+
+## 项目清单
+
+每个项目目录一份 `ontos.yaml`：
+
+```yaml
+tenant: acme
+project: sales
+specDir: ./spec
+sync:
+  domains: [ontology]
+```
+
+```bash
+ontos --cwd ./sales project list
+ontos --cwd ./sales admin sync diff
+```
+
+- `--cwd` 指定工作目录；`--manifest` 显式指定清单文件。
+- 自动发现从当前目录向上查找，止于最近 Git 根或用户主目录。
+- 切换已绑定项目使用 `--cwd` / `--manifest`。覆盖已有绑定需 `ontos project set --rebind`。
+- 清单不存放登录凭据。更换 `auth host set` 后需要重新登录。

package/dist/connector-child.cjs

@@ -0,0 +1,350 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  if (mod && typeof mod === "object" || typeof mod === "function") {
+    for (let key of __getOwnPropNames(mod))
+      if (!__hasOwnProp.call(to, key))
+        __defProp(to, key, {
+          get: __accessProp.bind(mod, key),
+          enumerable: true
+        });
+  }
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+
+// src/runtime/session.ts
+var import_node_vm = __toESM(require("node:vm"), 1);
+
+// src/runtime/protocol.ts
+var HOST_METHODS = Object.freeze([
+  "definition",
+  "declaration",
+  "http",
+  "db.query",
+  "db.next",
+  "db.close",
+  "crypto",
+  "cache.get",
+  "cache.set",
+  "secret.reveal",
+  "emit"
+]);
+var GUEST_FAILURE_CODES = Object.freeze([
+  "CONNECTOR_LOAD_FAILED",
+  "CONFIG_INVALID",
+  "SCHEMA_ERROR",
+  "FATAL_ERROR",
+  "AUTH_ERROR",
+  "TRANSIENT_ERROR",
+  "PUSH_UNKNOWN",
+  "CANCELED"
+]);
+var HTTP_METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD"]);
+var BODY_ENCODINGS = new Set(["utf8", "base64"]);
+var DIGEST_ENCODINGS = new Set(["hex", "base64"]);
+var HMAC_ALGORITHMS = new Set(["sha1", "sha256", "sha512"]);
+var HASH_ALGORITHMS = new Set(["md5", "sha1", "sha256", "sha512"]);
+var LOG_LEVELS = new Set(["info", "warn", "error"]);
+var SYNC_MODES = new Set(["full", "incremental"]);
+var SNAPSHOTS = new Set(["complete", "partial"]);
+var HOST_METHOD_SET = new Set(HOST_METHODS);
+var FAILURE_CODE_SET = new Set(GUEST_FAILURE_CODES);
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function isStringRecord(value) {
+  return isRecord(value) && Object.values(value).every((item) => typeof item === "string");
+}
+function isId(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function parsePushRequest(value) {
+  if (!isRecord(value))
+    return null;
+  const { requestId, push, receivedAt, headers, body } = value;
+  if (typeof requestId !== "string" || typeof push !== "string" || typeof receivedAt !== "string" || !isStringRecord(headers) || typeof body !== "string")
+    return null;
+  return { requestId, push, receivedAt, headers: { ...headers }, body };
+}
+function parseJob(value) {
+  if (!isRecord(value) || !isRecord(value.config) || !isStringArray(value.secretFields))
+    return null;
+  const config = value.config;
+  const secretFields = [...value.secretFields];
+  if (value.kind === "push") {
+    if (!Array.isArray(value.requests))
+      return null;
+    const requests = [];
+    for (const item of value.requests) {
+      const request = parsePushRequest(item);
+      if (!request)
+        return null;
+      requests.push(request);
+    }
+    return { kind: "push", config, secretFields, requests };
+  }
+  if (value.kind === "discover")
+    return { kind: "discover", config, secretFields };
+  if (value.kind === "check")
+    return { kind: "check", config, secretFields };
+  if (value.kind === "pull") {
+    const { stream, mode, streamConfig, tables, discoverFirst } = value;
+    if (typeof stream !== "string" || typeof mode !== "string" || !SYNC_MODES.has(mode) || !isRecord(streamConfig) || !isStringArray(tables))
+      return null;
+    if (discoverFirst !== undefined && typeof discoverFirst !== "boolean")
+      return null;
+    return {
+      kind: "pull",
+      config,
+      secretFields,
+      stream,
+      mode,
+      state: value.state,
+      streamConfig,
+      tables: [...tables],
+      ...discoverFirst === true ? { discoverFirst: true } : {}
+    };
+  }
+  return null;
+}
+function parseHostError(value) {
+  if (!isRecord(value) || typeof value.code !== "string" || typeof value.message !== "string")
+    return null;
+  const error = { code: value.code, message: value.message };
+  if (value.status !== undefined) {
+    if (typeof value.status !== "number" || !Number.isInteger(value.status))
+      return null;
+    error.status = value.status;
+  }
+  if (value.retryAfterMs !== undefined) {
+    if (typeof value.retryAfterMs !== "number" || !Number.isFinite(value.retryAfterMs) || value.retryAfterMs < 0)
+      return null;
+    error.retryAfterMs = value.retryAfterMs;
+  }
+  return error;
+}
+function parseParentMessage(value) {
+  if (!isRecord(value))
+    return null;
+  switch (value.type) {
+    case "execute": {
+      const { guest, code, expect } = value;
+      if (typeof guest !== "string" || typeof code !== "string")
+        return null;
+      if (!isRecord(expect) || typeof expect.name !== "string" || typeof expect.version !== "string")
+        return null;
+      const job = parseJob(value.job);
+      return job ? { type: "execute", guest, code, expect: { name: expect.name, version: expect.version }, job } : null;
+    }
+    case "reply": {
+      if (!isId(value.id))
+        return null;
+      if (value.ok === true)
+        return { type: "reply", id: value.id, ok: true, value: value.value };
+      if (value.ok !== false)
+        return null;
+      const error = parseHostError(value.error);
+      return error ? { type: "reply", id: value.id, ok: false, error } : null;
+    }
+    case "cancel":
+      return { type: "cancel" };
+    default:
+      return null;
+  }
+}
+
+// src/runtime/session.ts
+var GUEST_FILENAME = "ontos-guest.js";
+var CONNECTOR_FILENAME = "connector.js";
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function guestErrorMessage(error) {
+  try {
+    if (error !== null && typeof error === "object") {
+      const message = error.message;
+      if (typeof message === "string")
+        return message;
+    }
+  } catch {}
+  return "unknown error";
+}
+function bootGuest(context, guestSource) {
+  const wrapped = `(() => { const module = { exports: {} }; const exports = module.exports; ${guestSource}
+; return module.exports; })()`;
+  const exported = new import_node_vm.default.Script(wrapped, { filename: GUEST_FILENAME }).runInContext(context);
+  const boot = exported.bootGuest;
+  if (typeof boot !== "function")
+    throw new Error("guest runtime does not export bootGuest");
+  const api = boot();
+  const { start, handle, poll } = api;
+  if (typeof start !== "function" || typeof handle !== "function" || typeof poll !== "function")
+    throw new Error("guest runtime returned an incomplete API");
+  return { start, handle, poll };
+}
+function bootInVm(guestSource, code) {
+  const context = import_node_vm.default.createContext(Object.create(null), { codeGeneration: { strings: false, wasm: false } });
+  let guest;
+  try {
+    guest = bootGuest(context, guestSource);
+  } catch (error) {
+    return { ok: false, code: "CONNECTOR_LOAD_FAILED", message: `connector runtime failed to start: ${guestErrorMessage(error)}` };
+  }
+  try {
+    const factory = new import_node_vm.default.Script(`(function (module, exports, require) {${code}
+})`, { filename: CONNECTOR_FILENAME }).runInContext(context);
+    return { ok: true, guest, factory };
+  } catch (error) {
+    return { ok: false, code: "CONNECTOR_LOAD_FAILED", message: `connector code failed to compile: ${guestErrorMessage(error)}` };
+  }
+}
+function createGuestSession(send) {
+  return createSession(send, bootInVm);
+}
+function createSession(send, boot) {
+  let guest = null;
+  let started = false;
+  let done = false;
+  let timer;
+  let timerAt = Number.POSITIVE_INFINITY;
+  const stop = () => {
+    done = true;
+    if (timer !== undefined)
+      clearTimeout(timer);
+    timer = undefined;
+  };
+  const fail = (code, message) => {
+    if (done)
+      return;
+    stop();
+    send(JSON.stringify({ type: "failure", code, message, logs: [] }));
+  };
+  const schedule = (delay) => {
+    if (done)
+      return;
+    const at = Date.now() + delay;
+    if (timer !== undefined && timerAt <= at)
+      return;
+    if (timer !== undefined)
+      clearTimeout(timer);
+    timerAt = at;
+    timer = setTimeout(pump, delay);
+  };
+  function pump() {
+    timer = undefined;
+    timerAt = Number.POSITIVE_INFINITY;
+    if (done || !guest)
+      return;
+    let text;
+    try {
+      text = guest.poll();
+    } catch (error) {
+      fail("FATAL_ERROR", `connector runtime failed: ${guestErrorMessage(error)}`);
+      return;
+    }
+    let parsed;
+    try {
+      parsed = typeof text === "string" ? JSON.parse(text) : null;
+    } catch {
+      parsed = null;
+    }
+    if (!isRecord2(parsed) || !Array.isArray(parsed.out)) {
+      fail("FATAL_ERROR", "connector runtime returned a malformed poll result");
+      return;
+    }
+    for (const message of parsed.out) {
+      if (!isRecord2(message))
+        continue;
+      send(JSON.stringify(message));
+      if (message.type === "result" || message.type === "failure") {
+        stop();
+        return;
+      }
+    }
+    if (parsed.out.length > 0 || parsed.fired === true)
+      schedule(0);
+    else if (typeof parsed.wake === "number" && parsed.wake >= 0)
+      schedule(parsed.wake);
+  }
+  const execute = (guestSource, code, payload) => {
+    const booted = boot(guestSource, code);
+    if (!booted.ok) {
+      fail(booted.code, booted.message);
+      return;
+    }
+    guest = booted.guest;
+    try {
+      guest.start(payload, booted.factory);
+    } catch (error) {
+      fail("FATAL_ERROR", `connector runtime failed: ${guestErrorMessage(error)}`);
+      return;
+    }
+    schedule(0);
+  };
+  return {
+    handle(json) {
+      if (done || typeof json !== "string")
+        return;
+      let raw;
+      try {
+        raw = JSON.parse(json);
+      } catch {
+        return;
+      }
+      const message = parseParentMessage(raw);
+      if (!message)
+        return;
+      if (message.type === "execute") {
+        if (started)
+          return;
+        started = true;
+        execute(message.guest, message.code, JSON.stringify({ expect: message.expect, job: message.job }));
+        return;
+      }
+      if (!guest)
+        return;
+      try {
+        guest.handle(JSON.stringify(message));
+      } catch (error) {
+        fail("FATAL_ERROR", `connector runtime failed: ${guestErrorMessage(error)}`);
+        return;
+      }
+      schedule(0);
+    }
+  };
+}
+
+// src/testing/child.ts
+var session = createGuestSession((json) => {
+  process.send?.(json);
+});
+process.on("message", (raw) => {
+  if (typeof raw === "string")
+    session.handle(raw);
+});
+process.on("disconnect", () => {
+  process.exit(0);
+});
+process.send?.(JSON.stringify({ type: "ready" }));