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

licos_platform_cli-0.7.0/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 帮助。
@@ -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.7.0/PKG-INFO → licos_platform_cli-0.8.0/README.md

@@ -1,11 +1,3 @@
-Metadata-Version: 2.5
-Name: licos-platform-cli
-Version: 0.7.0
-Summary: LICOS platform CLI
-Requires-Python: >=3.10
-Requires-Dist: licos-platform-sdk>=0.8.0
-Description-Content-Type: text/markdown
-
 # licos-platform-cli
 
 LICOS 平台命令行工具。`licos-platform help` 返回结构化 JSON 帮助。
@@ -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.7.0 → licos_platform_cli-0.8.0}/pyproject.toml

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

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

@@ -799,7 +799,7 @@ ONTOLOGY_HELP = {
         "Resolve elements by stable IDs before querying context, model checks, or mapped data.",
         "elementId/objectElementId 是部署实例 ID；objectTypeId 从实例上下文读取，是对象模板 ID。",
         "函数使用目录中的 apiName 和 version，input 满足 inputSchema；objects 传对象导入描述，每组需明确部署实例。动作仍使用列表 id 作为 actionTypeId。",
-        "正式应用使用 ontology releases/package/bind/validate/query/function/diff；绑定只接受正式发布版本。函数版本与包版本分别固定，不能调用 CURRENT 或包外函数。",
+        "正式应用默认用 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.",

{licos_platform_cli-0.7.0 → licos_platform_cli-0.8.0}/src/licos_platform_cli/ontology_package_commands.py

@@ -11,13 +11,18 @@ 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": True, "description": "Release ID from releases."}],
+                "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": True, "description": "Explicit published release ID."},
+             "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"},
@@ -83,10 +88,14 @@ def _run(args: argparse.Namespace) -> Any:
     if operation == "releases":
         return ontology.list_releases(user_token=token)
     if operation == "package":
-        return ontology.get_package(args.release_id, user_token=token)
+        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":
-        return ontology.create_binding(args.release_id, _file(args.objects_file),
+        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)
@@ -105,6 +114,7 @@ def add_package_commands(commands: argparse._SubParsersAction) -> None:
         ("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"),
@@ -114,7 +124,11 @@ def add_package_commands(commands: argparse._SubParsersAction) -> None:
         add_user_token_option(parser)
         parser.set_defaults(handler=_run)
         if name in {"package", "bind"}:
-            parser.add_argument("release_id")
+            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":

{licos_platform_cli-0.7.0 → licos_platform_cli-0.8.0}/tests/test_ontology_packages.py

@@ -16,7 +16,7 @@ from test_cli import run_cli
 
 class OntologyPackageCliTests(unittest.TestCase):
     def test_package_commands_have_structured_help(self):
-        for command in ("releases", "package", "bind", "validate", "query", "function", "diff"):
+        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))
@@ -26,6 +26,15 @@ class OntologyPackageCliTests(unittest.TestCase):
         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):