@zhuoyuezs/ml-platform 0.2.2-alpha.3 → 0.2.2

package/DEVELOPMENT.md

@@ -10,7 +10,7 @@
 - Skill 直接调用正式命令 `ml-platform`，不嵌入 CLI runtime。
 - 正式 npm 包只有 `@zhuoyuezs/ml-platform`，正式 bin 只有 `ml-platform`。
 - `business-client-js/src-ts/` 是 business CLI 的唯一 TypeScript 源码，`src/` 是供 Node.js 和
-  release payload 使用的编译输出；仓库 `skills/` 下三个受支持 Skill 是各自唯一源码。
+  release payload 使用的编译输出；仓库 `skills/` 下四个受支持 Skill 是各自唯一源码。
 - `npx @zhuoyuezs/ml-platform@<version> install` 是面向用户的统一安装入口；默认目标是 Codex
   用户级 Skill，不要求额外安装参数。
 - 管理命令默认输出简洁结果；Agent 和 CI 显式使用 `--json` 获取稳定结构化输出。
@@ -31,6 +31,7 @@ business-client-js/
 └── src/                          generated Node.js runtime
 npm/ml-platform/src/               TypeScript installer and dispatcher source
 skills/feature-management/
+skills/data-source-exploration/
 skills/model-lifecycle-management/
 skills/model-deployment-management/
 npm/ml-platform/

package/README.md

@@ -1,7 +1,8 @@
 # ML Platform
 
-ML Platform 的 TypeScript CLI（编译为 Node.js JavaScript runtime）、`feature-management`、`model-lifecycle-management` 与
-`model-deployment-management` Agent Skill。CLI 与 Skill 由同一个 npm
+ML Platform 的 TypeScript CLI（编译为 Node.js JavaScript runtime）、`feature-management`、
+`data-source-exploration`、`model-lifecycle-management` 与 `model-deployment-management`
+Agent Skill。CLI 与 Skill 由同一个 npm
 release 安装和升级，运行时不需要 Python 或 `uv`。
 
 ## 环境要求
@@ -18,7 +19,7 @@ release 安装和升级，运行时不需要 Python 或 `uv`。
 npx @zhuoyuezs/ml-platform@latest install
 ```
 
-这条命令不需要额外参数。默认安装持久化的 `ml-platform` 命令，并将三个 Skill 安装到
+这条命令不需要额外参数。默认安装持久化的 `ml-platform` 命令，并将四个 Skill 安装到
 `~/.codex/skills/`，供当前用户的 Codex 使用。安装后重启终端和 Agent 会话。
 
 只在当前项目使用 Skill 时，在项目根目录运行：
@@ -94,6 +95,7 @@ Skill。`status --json` 中 `installed_release` 是当前 scope 的 Skill releas
 
 ```bash
 ml-platform list-parameters
+ml-platform list-datasource-connections
 ml-platform list-datasets --project <project>
 ml-platform get-dataset <dataset_id> <dataset_version> --project <project>
 ml-platform resolve-dataset <dataset_id> <dataset_version> --project <project>
@@ -129,8 +131,8 @@ npx --yes --registry=https://registry.npmjs.org/ \
 ## 包内容
 
 - 一份由 TypeScript 编译的 business CLI；
-- 三份纯 Skill：`feature-management`、`model-lifecycle-management` 与
-  `model-deployment-management`；
+- 四份纯 Skill：`feature-management`、`data-source-exploration`、
+  `model-lifecycle-management` 与 `model-deployment-management`；
 - 显式安装、升级、状态、校验和回滚逻辑。
 
 不包含 Codex CLI、Python business-client wheel、Agent Host、平台服务端、模型训练或 Kubernetes

package/checksums.json

@@ -7,12 +7,12 @@
     },
     {
       "path": "runtime/business-client/package-lock.json",
-      "sha256": "sha256:1e364f51be2b6df7ab5f27b72aa04cb499d9d191a321ab669bba011555e659e7",
+      "sha256": "sha256:ebc31820ae0d2985879efd87ba4b0d8843e44a175d4c9e1dc557737893f8bdae",
       "size_bytes": 1628
     },
     {
       "path": "runtime/business-client/package.json",
-      "sha256": "sha256:45545a61753cc889a1d578266634f0720423895e0693fa4911e0fdd3c0957f69",
+      "sha256": "sha256:4685ca172b5b23bd5de53bcccbd7f7412df281eff67533d72d1b598c63a28b47",
       "size_bytes": 671
     },
     {
@@ -22,8 +22,8 @@
     },
     {
       "path": "runtime/business-client/src/cli.js",
-      "sha256": "sha256:7ddd434c1e8ee64d8a6de9005e4f6b440197eafab021071b9e4a8af340d4e23a",
-      "size_bytes": 57877
+      "sha256": "sha256:c1beda5fd4e2d6f23f81529017679d85c0703d6859cfa0155a8597e50b7b6cdf",
+      "size_bytes": 60617
     },
     {
       "path": "runtime/business-client/src/config.js",
@@ -35,6 +35,16 @@
       "sha256": "sha256:4ae9e9ec10a74f36ed19ca7a63b0ba58a34cedea13ed95131ef1d07cd7d9e674",
       "size_bytes": 17176
     },
+    {
+      "path": "skills/data-source-exploration/SKILL.md",
+      "sha256": "sha256:3b609d61f3c73da3657ce2e6bb4d1eff95a90e4ac5e5445b8513536438b26b0b",
+      "size_bytes": 3853
+    },
+    {
+      "path": "skills/data-source-exploration/agents/openai.yaml",
+      "sha256": "sha256:5c7f7d497ad7738c672b8ee906d514284a2f2583a854f8fa487708a75836256f",
+      "size_bytes": 299
+    },
     {
       "path": "skills/feature-management/SKILL.md",
       "sha256": "sha256:88898ea83ff339512d5512537db485a2764420abb67afceb9dd090cc780c00e0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.2.2-alpha.3",
+  "version": "0.2.2",
   "description": "ML 数据平台 business CLI 与 Agent Skills 管理工具",
   "bin": {
     "ml-platform": "scripts/main.js"

package/release.json

@@ -13,8 +13,8 @@
     "entrypoint": "src/cli.js",
     "name": "ml-platform",
     "path": "runtime/business-client",
-    "sha256": "sha256:ceb3fdabf57044a5bf8d54baf04ab10327cb896e4eaff3897c18e08e96e5336a",
-    "version": "0.8.2"
+    "sha256": "sha256:4e06df68d4f849eae92d1fcfb57f1a3b9e949f97ed8042ec549c8b460f3736c8",
+    "version": "0.8.3"
   },
   "policy_sha256": "sha256:02fbde0134696b78c0c365d6e0b76c9814227208da5b2b3d4e5dbd82dc4a3606",
   "public_schema_versions": [
@@ -25,7 +25,7 @@
     "ml_data_platform.feature_set/v1",
     "ml_data_platform.dataset_manifest/v1"
   ],
-  "release_version": "0.2.2-alpha.3",
+  "release_version": "0.2.2",
   "runtime_requirements": {
     "node": ">=18",
     "os": [
@@ -35,24 +35,30 @@
   },
   "schema_version": "data_platform.ml_platform_release/v2",
   "skills": {
+    "data-source-exploration": {
+      "path": "skills/data-source-exploration",
+      "requires_cli": ">=0.8.3 <0.9.0",
+      "revision": "0.2.2",
+      "sha256": "sha256:ae3cfc88f8f3f46a5b7e0179d850b2216bc37275f34679dbea1ff2ba99875a96"
+    },
     "feature-management": {
       "path": "skills/feature-management",
-      "requires_cli": ">=0.8.2 <0.9.0",
-      "revision": "0.2.2-alpha.3",
+      "requires_cli": ">=0.8.3 <0.9.0",
+      "revision": "0.2.2",
       "sha256": "sha256:d32f0306f129d7bf76eb037fe239c84dd3c29c64b61600799d6e40320784bb10"
     },
     "model-deployment-management": {
       "path": "skills/model-deployment-management",
-      "requires_cli": ">=0.8.2 <0.9.0",
-      "revision": "0.2.2-alpha.3",
+      "requires_cli": ">=0.8.3 <0.9.0",
+      "revision": "0.2.2",
       "sha256": "sha256:e7d87c272a0dcc028ea628d5e36f5b7e52ed27cb9c1bc17ea76527478e28b46d"
     },
     "model-lifecycle-management": {
       "path": "skills/model-lifecycle-management",
-      "requires_cli": ">=0.8.2 <0.9.0",
-      "revision": "0.2.2-alpha.3",
+      "requires_cli": ">=0.8.3 <0.9.0",
+      "revision": "0.2.2",
       "sha256": "sha256:ec6ebb2587fd7acd024def75a8c0e9cd94b6cdd8ee6df439609291b496751b91"
     }
   },
-  "source_commit": "e713953153439c28680b60b56f57d3b9679ff49a"
+  "source_commit": "03bf8af26abcf13a95dc41d2637598a8f0233552"
 }

package/runtime/business-client/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@zhuoyuezs/ml-platform-business-client",
-      "version": "0.8.2",
+      "version": "0.8.3",
       "license": "UNLICENSED",
       "bin": {
         "ml-platform": "src/cli.js"

package/runtime/business-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "private": true,
   "description": "JavaScript implementation of the ML Platform business client",
   "bin": {

package/runtime/business-client/src/cli.js

@@ -13,7 +13,10 @@ const BUSINESS_COMMANDS = new Set([
     "get-model-runtime-release", "get-training-run", "get-model-artifact", "get-executable-package",
     "validate-training-job", "validate-model-package",
     "version", "create-project", "list-projects", "get-project", "delete-project",
-    "configure", "show-config", "health", "list-parameters", "list-operators", "list-features",
+    "configure", "show-config", "health",
+    "list-datasource-connections", "list-datasource-namespaces", "list-datasource-objects",
+    "list-datasource-fields", "query-datasource-object",
+    "list-parameters", "list-operators", "list-features",
     "list-feature-sets", "list-datasets", "get-dataset", "list-jobs", "resolve-manifest",
     "resolve-dataset", "build-dataset", "build-registered-dataset",
     "get-parameter", "get-feature", "get-feature-set", "get-operator",
@@ -49,6 +52,11 @@ const COMMAND_USAGE = {
     configure: "configure --api-url URL",
     "show-config": "show-config",
     health: "health",
+    "list-datasource-connections": "list-datasource-connections [--limit N] [--cursor CURSOR]",
+    "list-datasource-namespaces": "list-datasource-namespaces CONNECTION_ID [--limit N] [--cursor CURSOR]",
+    "list-datasource-objects": "list-datasource-objects CONNECTION_ID NAMESPACE_ID [--limit N] [--cursor CURSOR]",
+    "list-datasource-fields": "list-datasource-fields CONNECTION_ID OBJECT_ID [--limit N] [--cursor CURSOR]",
+    "query-datasource-object": "query-datasource-object CONNECTION_ID OBJECT_ID SPEC_JSON [--cursor CURSOR]",
     "create-project": "create-project NAME [--display-name TEXT] [--description TEXT] [--owner OWNER]",
     "list-projects": "list-projects",
     "get-project": "get-project NAME",
@@ -238,6 +246,13 @@ function readObject(file) {
 }
 function readDataset(file) { return normalizeDataset(readObject(file)); }
 function readSpec(file) { return readObject(file); }
+function datasourcePageParams(rest) {
+    const rawLimit = take(rest, "--limit");
+    const limit = rawLimit === undefined ? 100 : integer(rawLimit, "--limit");
+    if (limit < 1 || limit > 500)
+        throw new Error("--limit must be between 1 and 500");
+    return { limit, cursor: take(rest, "--cursor") };
+}
 function datasetEndpoint(project, datasetId, datasetVersion) {
     return `/datasets/${encodeURIComponent(project)}/${encodeURIComponent(datasetId)}/${encodeURIComponent(datasetVersion)}`;
 }
@@ -382,6 +397,32 @@ async function runBusinessCli(argv) {
     }
     else if (options.command === "health")
         result = await client(options).get("/health");
+    else if (options.command === "list-datasource-connections") {
+        result = await client(options).get("/datasource-connections", datasourcePageParams(rest));
+    }
+    else if (options.command === "list-datasource-namespaces") {
+        const connectionId = positional(rest, "connection id");
+        result = await client(options).get(`/datasource-connections/${encodeURIComponent(connectionId)}/namespaces`, datasourcePageParams(rest));
+    }
+    else if (options.command === "list-datasource-objects") {
+        const connectionId = positional(rest, "connection id");
+        const namespaceId = positional(rest, "namespace id");
+        result = await client(options).get(`/datasource-connections/${encodeURIComponent(connectionId)}/namespaces/${encodeURIComponent(namespaceId)}/objects`, datasourcePageParams(rest));
+    }
+    else if (options.command === "list-datasource-fields") {
+        const connectionId = positional(rest, "connection id");
+        const objectId = positional(rest, "object id");
+        result = await client(options).get(`/datasource-connections/${encodeURIComponent(connectionId)}/objects/${encodeURIComponent(objectId)}/fields`, datasourcePageParams(rest));
+    }
+    else if (options.command === "query-datasource-object") {
+        const connectionId = positional(rest, "connection id");
+        const objectId = positional(rest, "object id");
+        const spec = readSpec(positional(rest, "query spec JSON"));
+        const cursor = take(rest, "--cursor");
+        if (cursor !== undefined)
+            spec.cursor = cursor;
+        result = await client(options).post(`/datasource-connections/${encodeURIComponent(connectionId)}/objects/${encodeURIComponent(objectId)}/query`, spec);
+    }
     else if (options.command === "create-project") {
         const name = positional(rest, "project name");
         result = await client(options).post("/projects", { schema_version: "ml_data_platform.project/v1", name, display_name: take(rest, "--display-name", name), description: take(rest, "--description", ""), owner: take(rest, "--owner", "demo") });

package/skills/data-source-exploration/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: data-source-exploration
+description: Discover platform-configured PostgreSQL, MySQL, SQL Server, or InfluxDB objects and run bounded structured reads for local data and feature exploration. Use when an algorithm engineer wants to inspect visible databases, schemas, tables, measurements, fields, or limited rows before defining governed feature assets. Do not use for free-form SQL, bulk export, asset publication, dataset builds, or model training.
+---
+
+# Data Source Exploration
+
+Use the platform API through `ml-platform`; never connect to a business database directly and
+never request credentials. The platform exposes configured connections and their discoverable objects.
+
+## Establish The Target
+
+Before discovery, verify the installed client and server target:
+
+```bash
+command -v ml-platform
+ml-platform health
+```
+
+If the server target is missing or unhealthy, stop. Do not fall back to a DSN, database client, SQL,
+Flux, or a repository-local source adapter.
+
+## Discover Hierarchically
+
+Read one level at a time and preserve the returned opaque IDs:
+
+```bash
+ml-platform list-datasource-connections
+ml-platform list-datasource-namespaces <connection_id>
+ml-platform list-datasource-objects <connection_id> <namespace_id>
+ml-platform list-datasource-fields <connection_id> <object_id>
+```
+
+Follow `next_cursor` with `--cursor` until it is null when complete traversal is needed. Do not derive an
+ID from a database, schema, table, measurement, or field name. An absent object means it is unavailable
+or no longer present; do not probe alternate names.
+
+## Query One Object
+
+Create a `DatasourceQuerySpec` JSON in the user's workspace. Select only fields needed for the current
+question, use bounded time filters for time-series data, and start with a small `limit`:
+
+```json
+{
+  "schema_version": "ml_data_platform.datasource_query/v1",
+  "field_ids": ["fld_time", "fld_entity", "fld_value"],
+  "filters": [
+    {
+      "field_id": "fld_time",
+      "operator": "between",
+      "values": ["2026-09-01T00:00:00+08:00", "2026-09-02T00:00:00+08:00"]
+    }
+  ],
+  "order_by": [{"field_id": "fld_time", "direction": "asc"}],
+  "limit": 200,
+  "cursor": null
+}
+```
+
+Run it with:
+
+```bash
+ml-platform query-datasource-object \
+  <connection_id> <object_id> datasource-query.json
+```
+
+Supported filters are `eq`, `in`, `gt`, `gte`, `lt`, `lte`, `between`, and `is_null`. Only fields marked
+filterable or sortable may be used in those positions. InfluxDB reads require bounded `_time` start and
+end filters. For the next page, keep projection, filters, ordering, and `limit` unchanged and pass the
+returned cursor with `--cursor`.
+
+## Explore In The Workspace
+
+Analyze returned rows with local code such as pandas or DuckDB. Keep these outputs outside the platform
+repository unless the user explicitly asks for a repository-owned fixture. Record:
+
+- the connection, namespace, object, field IDs, query spec, `audit_ref`, and response hash;
+- observed facts such as dtypes, missingness, frequency, ranges, duplicates, and candidate entity/time keys;
+- hypotheses about business meaning, target suitability, leakage, transformations, and model features;
+- unresolved items that require a data owner or business owner to confirm.
+
+Do not present inferred semantics as facts. Query results are exploratory evidence, not training data and
+not a substitute for Parameter, Feature, FeatureSet, DatasetManifest, or DatasetArtifact.
+
+## Hand Off Confirmed Work
+
+After a human confirms source mapping, event time, entity keys, units, availability, quality rules, target,
+horizon, and feature formulas, use `$feature-management` to create governed assets and build a
+DatasetArtifact. Use `$model-lifecycle-management` only after that artifact exists. Exploration does not
+authorize publishing assets, building datasets, or submitting training jobs.

package/skills/data-source-exploration/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "数据源与特征探索"
+  short_description: "逐层发现已连接数据源并执行受限数据查询"
+  default_prompt: "使用 $data-source-exploration 从平台已连接数据源中发现可见库表字段，执行有限查询，并整理数据与特征假设。"