licos-platform-cli 0.6.6__tar.gz → 0.8.0__tar.gz

licos_platform_cli-0.6.6/README.md → licos_platform_cli-0.8.0/PKG-INFO

@@ -1,3 +1,11 @@
+Metadata-Version: 2.5
+Name: licos-platform-cli
+Version: 0.8.0
+Summary: LICOS platform CLI
+Requires-Python: >=3.10
+Requires-Dist: licos-platform-sdk>=0.9.0
+Description-Content-Type: text/markdown
+
 # licos-platform-cli
 
 LICOS 平台命令行工具。`licos-platform help` 返回结构化 JSON 帮助。
@@ -34,7 +42,7 @@ licos-platform user me --token-stdin
 | --- | --- | --- |
 | `user me` | 按 `LICOS_CURRENT_USER_ID` 换 Token | 使用 `--token-stdin` |
 | `knowledge enterprise …` | 按 `LICOS_CURRENT_USER_ID` 换 Token | 使用 `--token-stdin`，企业范围和权限由平台认证结果确定 |
-| `ontology search`、`ontology invoke` | 按 `LICOS_CURRENT_USER_ID` 换 Token | 使用 `--token-stdin` |
+| 所有 `ontology` 命令 | 按 `LICOS_CURRENT_USER_ID` 换 Token | 使用 `--token-stdin` |
 | 普通 `knowledge …` | 项目身份 | 需要用户权限时使用 `--token-stdin` |
 | 数据库、对象存储、OAuth 应用管理 | 项目身份 | 保持项目身份 |
 
@@ -57,6 +65,10 @@ result = subprocess.run(
 
 显式传入的 Token 鉴权失败时返回非零退出码，由调用方更新登录凭证，不切换到容器用户或项目所有者。项目所有者和工作空间等资源归属字段单独保留，不用它们冒充调用用户。
 
+## 本体正式版本
+
+0.8.0 起，`ontology package/bind --root-object-id <id>` 自动选择最新正式版；使用显式 release_id 固定版本。`ontology resolve --configuration-file ontology.json` 解析 `{versionPolicy, rootObjectId, binding}`，省略策略保持固定版本。新运行开始解析并保存输出绑定，query/function 及恢复执行复用它，不在每次查询时重新解析。新版缺少已选对象、属性或函数时直接失败。
+
 ## 编程项目登录身份
 
 - 有内置登录时使用内置登录会话；没有内置登录时使用当前 LICOS 网页登录。内置登录未登录或过期时不能切换成平台用户。

licos_platform_cli-0.6.6/PKG-INFO → licos_platform_cli-0.8.0/README.md

@@ -1,11 +1,3 @@
-Metadata-Version: 2.5
-Name: licos-platform-cli
-Version: 0.6.6
-Summary: LICOS platform CLI
-Requires-Python: >=3.10
-Requires-Dist: licos-platform-sdk>=0.7.6
-Description-Content-Type: text/markdown
-
 # licos-platform-cli
 
 LICOS 平台命令行工具。`licos-platform help` 返回结构化 JSON 帮助。
@@ -42,7 +34,7 @@ licos-platform user me --token-stdin
 | --- | --- | --- |
 | `user me` | 按 `LICOS_CURRENT_USER_ID` 换 Token | 使用 `--token-stdin` |
 | `knowledge enterprise …` | 按 `LICOS_CURRENT_USER_ID` 换 Token | 使用 `--token-stdin`，企业范围和权限由平台认证结果确定 |
-| `ontology search`、`ontology invoke` | 按 `LICOS_CURRENT_USER_ID` 换 Token | 使用 `--token-stdin` |
+| 所有 `ontology` 命令 | 按 `LICOS_CURRENT_USER_ID` 换 Token | 使用 `--token-stdin` |
 | 普通 `knowledge …` | 项目身份 | 需要用户权限时使用 `--token-stdin` |
 | 数据库、对象存储、OAuth 应用管理 | 项目身份 | 保持项目身份 |
 
@@ -65,6 +57,10 @@ result = subprocess.run(
 
 显式传入的 Token 鉴权失败时返回非零退出码，由调用方更新登录凭证，不切换到容器用户或项目所有者。项目所有者和工作空间等资源归属字段单独保留，不用它们冒充调用用户。
 
+## 本体正式版本
+
+0.8.0 起，`ontology package/bind --root-object-id <id>` 自动选择最新正式版；使用显式 release_id 固定版本。`ontology resolve --configuration-file ontology.json` 解析 `{versionPolicy, rootObjectId, binding}`，省略策略保持固定版本。新运行开始解析并保存输出绑定，query/function 及恢复执行复用它，不在每次查询时重新解析。新版缺少已选对象、属性或函数时直接失败。
+
 ## 编程项目登录身份
 
 - 有内置登录时使用内置登录会话；没有内置登录时使用当前 LICOS 网页登录。内置登录未登录或过期时不能切换成平台用户。

{licos_platform_cli-0.6.6 → licos_platform_cli-0.8.0}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-platform-cli"
-version = "0.6.6"
+version = "0.8.0"
 description = "LICOS platform CLI"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "licos-platform-sdk>=0.7.6",
+    "licos-platform-sdk>=0.9.0",
 ]
 
 [project.scripts]

{licos_platform_cli-0.6.6 → licos_platform_cli-0.8.0}/src/licos_platform_cli/help_commands.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import argparse
 from typing import Any, Callable
 from .user_commands import USER_HELP
+from .ontology_package_commands import PACKAGE_HELP
 
 
 Handler = Callable[[argparse.Namespace], Any]
@@ -797,7 +798,8 @@ ONTOLOGY_HELP = {
         "Search the catalog before invoking a tool; the catalog is filtered by the current user's permissions.",
         "Resolve elements by stable IDs before querying context, model checks, or mapped data.",
         "elementId/objectElementId 是部署实例 ID；objectTypeId 从实例上下文读取，是对象模板 ID。",
-        "函数和动作列表读取 id，分别用于 functionId/actionTypeId；返回已移除 actionTypeId、functionKind、implementationRef，业务 definition 按实际返回读取。",
+        "函数使用目录中的 apiName 和 version，input 满足 inputSchema；objects 传对象导入描述，每组需明确部署实例。动作仍使用列表 id 作为 actionTypeId。",
+        "正式应用默认用 ontology package/bind --root-object-id 选择最新正式版；显式 release_id 固定版本。ontology resolve 在新运行开始解析配置，保存绑定供整轮及恢复复用。函数版本仍显式固定，不能调用 CURRENT 或包外函数。",
         "动作预览明确传入 objectElementId 和真实 objectKey；用户确认后用同一草稿的 confirmationId 执行。实例参数必须已在当前工具 schema 中声明，缺失时报告上游目录问题。",
         "READ tools query state, PREPARE tools validate a change draft, and PERSIST tools apply an explicitly confirmed draft.",
         "PERSIST commands require --confirm. Never reuse a catalog result after its catalogVersion changes.",
@@ -844,6 +846,8 @@ ONTOLOGY_HELP = {
 }
 
 
+ONTOLOGY_HELP["commands"].update(PACKAGE_HELP)
+
 HELP_TOPICS = {
     "user": USER_HELP,
     "storage": STORAGE_HELP,

{licos_platform_cli-0.6.6 → licos_platform_cli-0.8.0}/src/licos_platform_cli/ontology_commands.py

@@ -7,6 +7,7 @@ from typing import Any, Callable
 
 from licos_platform_sdk import ontology
 from .identity import add_user_token_option, user_token
+from .ontology_package_commands import add_package_commands
 
 Handler = Callable[[argparse.Namespace], Any]
 
@@ -60,6 +61,7 @@ def add_ontology_parser(
         help="Discover and invoke authorized ontology and Data Factory AI tools",
     )
     commands = parser.add_subparsers(dest="ontology_command", required=True)
+    add_package_commands(commands)
 
     search = commands.add_parser("search", help="Search the authorized AI tool catalog")
     search.add_argument("query")

licos_platform_cli-0.8.0/src/licos_platform_cli/ontology_package_commands.py

@@ -0,0 +1,147 @@
+from __future__ import annotations
+
+import argparse
+import json
+from copy import deepcopy
+from pathlib import Path
+from typing import Any
+
+from licos_platform_sdk import ontology
+from .identity import add_user_token_option, user_token
+
+
+PACKAGE_HELP = {
+    "resolve": {"description": "Resolve a latestPublished/pinned selection once at run start. Persist the returned binding for all queries and resume.",
+                "parameters": [{"name": "--configuration-file", "required": True, "description": "JSON containing binding, versionPolicy and rootObjectId."}],
+                "example": "licos-platform ontology resolve --configuration-file ontology.json"},
+    "releases": {"description": "List visible published releases using the current execution identity.", "parameters": [],
+                 "example": "licos-platform ontology releases"},
+    "package": {"description": "Inspect semantic metadata of a specific release; excludes physical mappings and implementation DSL.",
+                "parameters": [{"name": "release_id", "required": False, "description": "Pinned release; mutually exclusive with --root-object-id."},
+                               {"name": "--root-object-id", "required": False, "description": "Inspect the latest formally published release of this ontology root."}],
+                "example": "licos-platform ontology package <release_id>"},
+    "bind": {"description": "Create a binding JSON for a published release; save the output in trusted application configuration.",
+             "parameters": [{"name": "release_id", "required": False, "description": "Pinned release; mutually exclusive with --root-object-id."},
+                            {"name": "--root-object-id", "required": False, "description": "Resolve latest formally published model once for this run."},
+                            {"name": "--objects-file", "required": True, "description": "JSON array of elementId and attributeIds selections."},
+                            {"name": "--functions-file", "required": False, "description": "JSON array of apiName/version selections. Omitted selects no functions."}],
+             "example": "licos-platform ontology bind <release_id> --objects-file objects.json --functions-file functions.json"},
+    "validate": {"description": "Re-read the published artifact and validate binding identity, hash metadata and selected scope.",
+                 "parameters": [{"name": "--binding-file", "required": True, "description": "Trusted binding JSON file."}],
+                 "example": "licos-platform ontology validate --binding-file binding.json"},
+    "query": {"description": "Query bound business records; preserve primary keys and pagination metadata.",
+              "parameters": [{"name": "--binding-file", "required": True, "description": "Binding JSON file."},
+                             {"name": "--element-id", "required": True, "description": "Deployment ID in the binding."},
+                             {"name": "--query-file", "required": True, "description": "JSON with attributeIds and explicit pagination; optional conditionGroup/sorts/includeTotalCount."}],
+              "example": "licos-platform ontology query --binding-file binding.json --element-id <id> --query-file query.json"},
+    "function": {"description": "Invoke an explicitly selected published function through its package runtime; no automatic latest-version fallback.",
+                 "parameters": [{"name": "--binding-file", "required": True, "description": "Binding JSON file."},
+                                {"name": "--api-name", "required": True, "description": "Bound function API name."},
+                                {"name": "--version", "required": True, "description": "Function version, distinct from package version."},
+                                {"name": "--input-file", "required": True, "description": "Business input JSON satisfying inputSchema."},
+                                {"name": "--objects-file", "required": False, "description": "JSON import descriptors alias/objectTypeId/objectElementId; at most 8 groups."}],
+                 "example": "licos-platform ontology function --binding-file binding.json --api-name <name> --version <function_version> --input-file input.json"},
+    "diff": {"description": "Compare semantic object, attribute and function changes between two releases.",
+             "parameters": [{"name": "before", "required": True, "description": "Previous release ID."},
+                            {"name": "after", "required": True, "description": "Proposed release ID."}],
+             "example": "licos-platform ontology diff <before_release_id> <after_release_id>"},
+}
+
+
+def _file(path: str) -> Any:
+    try:
+        return json.loads(Path(path).read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError) as exc:
+        raise argparse.ArgumentTypeError(f"cannot read ontology JSON file: {exc}") from exc
+
+
+def _diff(before: Any, after: Any, path: str = "") -> list[dict[str, Any]]:
+    if before == after:
+        return []
+    if isinstance(before, dict) and isinstance(after, dict):
+        changes = []
+        for key in sorted(before.keys() | after.keys()):
+            location = f"{path}/{key}"
+            if key not in before:
+                changes.append({"path": location, "change": "added", "after": after[key]})
+            elif key not in after:
+                changes.append({"path": location, "change": "removed", "before": before[key]})
+            else:
+                changes.extend(_diff(before[key], after[key], location))
+        return changes
+    return [{"path": path, "change": "changed", "before": before, "after": after}]
+
+
+def _indexed(context: dict[str, Any]) -> dict[str, Any]:
+    result = deepcopy(context)
+    for key in ("types", "instances", "relations"):
+        result[key] = {item["id"]: item for item in result[key]}
+    result["functions"] = {f"{item['apiName']}@{item.get('functionVersion', 'historical')}": item for item in result["functions"]}
+    for instance in result["instances"].values():
+        instance["attributes"] = {item["id"]: item for item in instance["attributes"]}
+    return result
+
+
+def _run(args: argparse.Namespace) -> Any:
+    token = user_token(args)
+    operation = args.ontology_command
+    if operation == "releases":
+        return ontology.list_releases(user_token=token)
+    if operation == "package":
+        return (ontology.get_latest_package(args.root_object_id, user_token=token) if args.root_object_id
+                else ontology.get_package(args.release_id, user_token=token))
+    if operation == "bind":
+        bind = ontology.create_latest_binding if args.root_object_id else ontology.create_binding
+        return bind(args.root_object_id or args.release_id, _file(args.objects_file),
+            _file(args.functions_file) if args.functions_file else [], user_token=token)
+    if operation == "resolve":
+        return ontology.resolve_binding(_file(args.configuration_file), user_token=token)
+    if operation == "diff":
+        before = ontology.get_package(args.before, user_token=token)
+        after = ontology.get_package(args.after, user_token=token)
+        return {"before": before["package"], "after": after["package"], "changes": _diff(_indexed(before), _indexed(after))}
+    binding = _file(args.binding_file)
+    if operation == "validate":
+        return ontology.validate_binding(binding, user_token=token)
+    if operation == "query":
+        return ontology.query_package_objects(binding, args.element_id, _file(args.query_file), user_token=token)
+    return ontology.invoke_package_function(binding, args.api_name, args.version, _file(args.input_file), user_token=token,
+        objects=_file(args.objects_file) if args.objects_file else [])
+
+
+def add_package_commands(commands: argparse._SubParsersAction) -> None:
+    for name, description in (
+        ("releases", "List visible published ontology releases"),
+        ("package", "Inspect semantic metadata of one release"),
+        ("bind", "Create an explicit release and capability binding"),
+        ("resolve", "Resolve a saved version policy once at run start"),
+        ("validate", "Verify a binding against its published artifact"),
+        ("query", "Query business objects within a binding"),
+        ("function", "Invoke a versioned read-only function within a binding"),
+        ("diff", "Compare semantic metadata of two releases"),
+    ):
+        parser = commands.add_parser(name, help=description)
+        add_user_token_option(parser)
+        parser.set_defaults(handler=_run)
+        if name in {"package", "bind"}:
+            selection = parser.add_mutually_exclusive_group(required=True)
+            selection.add_argument("release_id", nargs="?")
+            selection.add_argument("--root-object-id", help="Use the latest formally published release of this stable ontology root")
+        if name == "resolve":
+            parser.add_argument("--configuration-file", required=True)
+        if name in {"validate", "query", "function"}:
+            parser.add_argument("--binding-file", required=True)
+        if name == "bind":
+            parser.add_argument("--objects-file", required=True, help="JSON array of elementId/attributeIds selections")
+            parser.add_argument("--functions-file", help="JSON array of apiName/version selections; omitted selects no functions")
+        if name == "query":
+            parser.add_argument("--element-id", required=True)
+            parser.add_argument("--query-file", required=True)
+        if name == "function":
+            parser.add_argument("--api-name", required=True)
+            parser.add_argument("--version", required=True)
+            parser.add_argument("--input-file", required=True)
+            parser.add_argument("--objects-file")
+        if name == "diff":
+            parser.add_argument("before")
+            parser.add_argument("after")

{licos_platform_cli-0.6.6 → licos_platform_cli-0.8.0}/tests/test_cli.py

@@ -136,7 +136,7 @@ class PlatformCliTests(unittest.TestCase):
         self.assertEqual(stderr, "")
         payload = json.loads(stdout)
         self.assertEqual(payload["topic"], "ontology")
-        self.assertEqual(set(payload["commands"]), {"search", "invoke"})
+        self.assertEqual(set(payload["commands"]), {"search", "invoke", "releases", "package", "bind", "validate", "query", "function", "diff"})
         self.assertTrue(any("catalogVersion" in rule for rule in payload["rules"]))
         sdk_help = "\n".join(payload["sdk"].values())
         self.assertNotIn("items[0]", sdk_help)

licos_platform_cli-0.8.0/tests/test_ontology_packages.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+import json
+import os
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+from unittest.mock import patch
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[2] / "licos-platform-sdk" / "src"))
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
+from licos_platform_cli.ontology_package_commands import _indexed, _diff
+from test_cli import run_cli
+
+
+class OntologyPackageCliTests(unittest.TestCase):
+    def test_package_commands_have_structured_help(self):
+        for command in ("releases", "package", "bind", "resolve", "validate", "query", "function", "diff"):
+            code, output, error = run_cli("help", "ontology", command)
+            self.assertEqual((code, error), (0, ""))
+            self.assertIn("parameters", json.loads(output))
+
+    def setUp(self):
+        identity = patch.dict(os.environ, {"LICOS_CURRENT_USER_ID": "caller"})
+        identity.start()
+        self.addCleanup(identity.stop)
+
+    @patch("licos_platform_cli.identity.runtime_user_token", return_value="caller-token")
+    @patch("licos_platform_cli.ontology_package_commands.ontology.get_latest_package", return_value={"version": "V2"})
+    def test_latest_package_selects_by_root_and_rejects_ambiguous_input(self, latest, _identity):
+        code, _, error = run_cli("ontology", "package", "--root-object-id", "root-1")
+        self.assertEqual((code, error), (0, ""))
+        latest.assert_called_once_with("root-1", user_token="caller-token")
+        code, _, _ = run_cli("ontology", "package", "release-1", "--root-object-id", "root-1")
+        self.assertNotEqual(code, 0)
+
+    @patch("licos_platform_cli.identity.runtime_user_token", return_value="caller-token")
+    @patch("licos_platform_cli.ontology_package_commands.ontology.list_releases", return_value=[])
+    def test_releases_forwards_runtime_identity(self, releases, _identity):
+        code, output, error = run_cli("ontology", "releases")
+        self.assertEqual((code, error), (0, ""))
+        releases.assert_called_once_with(user_token="caller-token")
+
+    @patch("licos_platform_cli.identity.runtime_user_token", return_value="caller-token")
+    @patch("licos_platform_cli.ontology_package_commands.ontology.invoke_package_function", return_value={"result": 42})
+    def test_function_preserves_binding_version_and_structured_input(self, invoke, _identity):
+        with tempfile.TemporaryDirectory() as root:
+            binding, inputs = Path(root)/"binding.json", Path(root)/"input.json"
+            binding.write_text(json.dumps({"releaseId": "release-1"}), encoding="utf-8")
+            inputs.write_text(json.dumps({"value": 3}), encoding="utf-8")
+            code, _, error = run_cli("ontology", "function", "--binding-file", str(binding),
+                "--api-name", "readStatus", "--version", "1.0.1", "--input-file", str(inputs))
+            self.assertEqual((code, error), (0, ""))
+            invoke.assert_called_once_with({"releaseId": "release-1"}, "readStatus", "1.0.1", {"value": 3}, user_token="caller-token", objects=[])
+
+    def test_diff_preserves_multiple_versions_and_does_not_mutate_input(self):
+        context = {"types": [], "relations": [], "instances": [{"id": "pump", "attributes": [{"id": "pressure"}]}],
+                   "functions": [{"apiName": "read", "functionVersion": "1"}, {"apiName": "read", "functionVersion": "2"}]}
+        indexed = _indexed(context)
+        self.assertEqual(len(indexed["functions"]), 2)
+        self.assertIsInstance(context["instances"][0]["attributes"], list)
+        updated = json.loads(json.dumps(indexed))
+        updated["instances"]["pump"]["attributes"]["pressure"]["valueType"] = "Double"
+        self.assertEqual(_diff(indexed, updated)[0]["path"], "/instances/pump/attributes/pressure/valueType")