licos-platform-cli 0.3.1__tar.gz → 0.3.3__tar.gz

{licos_platform_cli-0.3.1 → licos_platform_cli-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: licos-platform-cli
-Version: 0.3.1
+Version: 0.3.3
 Summary: LICOS platform CLI
 Requires-Python: >=3.10
-Requires-Dist: licos-platform-sdk>=0.4.1
+Requires-Dist: licos-platform-sdk>=0.4.2

{licos_platform_cli-0.3.1 → licos_platform_cli-0.3.3}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-platform-cli"
-version = "0.3.1"
+version = "0.3.3"
 description = "LICOS platform CLI"
 requires-python = ">=3.10"
 dependencies = [
-    "licos-platform-sdk>=0.4.1",
+    "licos-platform-sdk>=0.4.2",
 ]
 
 [project.scripts]

{licos_platform_cli-0.3.1 → licos_platform_cli-0.3.3}/src/licos_platform_cli/help_commands.py

@@ -451,7 +451,7 @@ KNOWLEDGE_HELP = {
 }
 
 
-OAUTH_HELP = {
+OAUTH_HELP = {
     "topic": "oauth",
     "description": "Manage LICOS OAuth2/OIDC login applications from trusted project runtime code.",
     "runtime": RUNTIME_ENV,
@@ -495,201 +495,284 @@ OAUTH_HELP = {
         "grants": {"description": "List application grants.", "parameters": [], "example": "licos-platform oauth grants app-id"},
         "revoke-grant": {"description": "Revoke one grant.", "parameters": [], "example": "licos-platform oauth revoke-grant grant-id"},
     },
-}
-
-
-UNS_HELP = {
-    "topic": "uns",
-    "description": "Project-scoped UNS generation, reconciliation, resource search, and business runtime access.",
-    "runtime": RUNTIME_ENV,
-    "rules": [
-        "Runtime identity selects the project; never pass tenant, workspace, project, external service URL, or token arguments.",
-        "Query only the blocks and protocols needed for the current document.",
-        "discover, validate, plan, and finalize are read-only for external systems; apply performs writes.",
-        "Run apply only after reviewing the current plan, and pass its exact documentHash and planHash with --confirm.",
-        "UNS.json must not contain platform IDs, external IDs, credentials, MQTT infrastructure IDs, or credential-bearing RTSP URLs.",
+}
+
+
+UNS_HELP = {
+    "topic": "uns",
+    "description": "Project-scoped UNS generation, reconciliation, resource search, and business runtime access.",
+    "runtime": RUNTIME_ENV,
+    "rules": [
+        "Runtime identity selects the project; never pass tenant, workspace, project, external service URL, or token arguments.",
+        "Query only the blocks and protocols needed for the current document.",
+        "discover, validate, plan, and finalize are read-only for external systems; apply performs writes.",
+        "Run apply only after reviewing the current plan, and pass its exact documentHash and planHash with --confirm.",
+        "UNS.json must not contain platform IDs, external IDs, credentials, MQTT infrastructure IDs, or credential-bearing RTSP URLs.",
         "Use resource-search before reference bindings; a reference selector must resolve exactly one existing resource.",
+        "Point nodes are message-backed. New manifests and changes do not create point storage; existing point storage remains unchanged and does not block point operations.",
+        "Use UNSChangeSet for supported isolated structural changes. Remove storage only on an explicit confirmed request. Unsupported operations must fail; do not regenerate a full manifest or call external services directly.",
         "Use either a current-project node code or --path for business access. Data writes/deletions, point control, and video control require explicit confirmation.",
-    ],
-    "sdk": {
-        "python": "from licos_platform_sdk import uns\nplanned = uns.plan(document)\nresult = uns.apply(document, expected_document_hash=planned['documentHash'], expected_plan_hash=planned['planHash'], confirmed=True)",
-    },
-    "commands": {
-        "schema-current": {
-            "description": "Get the current complete UNS Schema and block index.",
-            "parameters": [],
-            "example": "licos-platform uns schema-current",
-        },
-        "schema": {
-            "description": "Get a complete versioned UNS Schema.",
-            "parameters": [{"name": "--version", "required": False, "description": "Schema version, default 1.0."}],
-            "example": "licos-platform uns schema --version 1.0",
-        },
-        "schema-blocks": {
-            "description": "List available blocks for one Schema version.",
-            "parameters": [{"name": "--version", "required": False, "description": "Schema version, default 1.0."}],
-            "example": "licos-platform uns schema-blocks",
-        },
-        "schema-block": {
-            "description": "Get one block and optionally its direct dependencies.",
-            "parameters": [
-                {"name": "block_code", "required": True, "description": "Block code such as collection-point or uns-node."},
-                {"name": "--depth", "required": False, "description": "Dependency depth from 0 to 3."},
-            ],
-            "example": "licos-platform uns schema-block collection-point --depth 1",
-        },
-        "protocol-schema": {
-            "description": "Get one protocol-specific collection-point Schema and capability status.",
-            "parameters": [{"name": "protocol", "required": True, "description": "Protocol code such as opcua."}],
-            "example": "licos-platform uns protocol-schema opcua",
-        },
-        "discover": {
-            "description": "Read a redacted snapshot of reusable industrial resources for the runtime project.",
-            "parameters": [
-                {"name": "--resource-type", "required": False, "description": "Resource block to return; can repeat."},
-                {"name": "--protocol", "required": False, "description": "Protocol capability detail to query; can repeat."},
-            ],
-            "example": "licos-platform uns discover --resource-type connections --protocol opcua",
-        },
-        "resource-search": {
-            "description": "Search reusable points, video channels, or other resources and return a manifestSelector without external IDs.",
-            "parameters": [
-                {"name": "--resource-type", "required": True, "description": "Resource type such as collectionPoints or videoChannels."},
-                {"name": "--protocol", "required": False, "description": "Optional protocol filter."},
-                {"name": "--keyword", "required": False, "description": "Name or business-code search text."},
-                {"name": "--selector-json", "required": False, "description": "Exact business selector JSON object."},
-            ],
-            "example": "licos-platform uns resource-search --resource-type collectionPoints --protocol opcua --keyword TEMP",
-        },
-        "bindings": {
-            "description": "List project UNS node codes, field contracts, and available runtime capabilities.",
-            "parameters": [],
-            "example": "licos-platform uns bindings",
-        },
-        "path-resolve": {
-            "description": "Resolve an authorized absolute or relative enterprise UNS path.",
-            "parameters": [{"name": "path", "required": True, "description": "UNS absolute or relative path."}],
-            "example": "licos-platform uns path-resolve project:/AREA_01/TEMP_01",
-        },
-        "validate": {
-            "description": "Validate a local JSON document in the runtime project scope.",
-            "parameters": [{"name": "--file", "required": True, "description": "Local UNS JSON file."}],
-            "example": "licos-platform uns validate --file UNS.json.candidate",
-        },
-        "plan": {
-            "description": "Create a deterministic read-only reconciliation plan for a local JSON document.",
-            "parameters": [{"name": "--file", "required": True, "description": "Local UNS JSON file."}],
-            "example": "licos-platform uns plan --file UNS.json",
-        },
+    ],
+    "sdk": {
+        "python": "from licos_platform_sdk import uns\nplanned = uns.plan(document)\nresult = uns.apply(document, expected_document_hash=planned['documentHash'], expected_plan_hash=planned['planHash'], confirmed=True)",
+    },
+    "commands": {
+        "schema-current": {
+            "description": "Get the current complete UNS Schema and block index.",
+            "parameters": [],
+            "example": "licos-platform uns schema-current",
+        },
+        "schema": {
+            "description": "Get a complete versioned UNS Schema.",
+            "parameters": [{"name": "--version", "required": False, "description": "Schema version, default 1.0."}],
+            "example": "licos-platform uns schema --version 1.0",
+        },
+        "schema-blocks": {
+            "description": "List available blocks for one Schema version.",
+            "parameters": [{"name": "--version", "required": False, "description": "Schema version, default 1.0."}],
+            "example": "licos-platform uns schema-blocks",
+        },
+        "schema-block": {
+            "description": "Get one block and optionally its direct dependencies.",
+            "parameters": [
+                {"name": "block_code", "required": True, "description": "Block code such as collection-point or uns-node."},
+                {"name": "--depth", "required": False, "description": "Dependency depth from 0 to 3."},
+            ],
+            "example": "licos-platform uns schema-block collection-point --depth 1",
+        },
+        "protocol-schema": {
+            "description": "Get one protocol-specific collection-point Schema and capability status.",
+            "parameters": [{"name": "protocol", "required": True, "description": "Protocol code such as opcua."}],
+            "example": "licos-platform uns protocol-schema opcua",
+        },
+        "discover": {
+            "description": "Read a redacted snapshot of reusable industrial resources for the runtime project.",
+            "parameters": [
+                {"name": "--resource-type", "required": False, "description": "Resource block to return; can repeat."},
+                {"name": "--protocol", "required": False, "description": "Protocol capability detail to query; can repeat."},
+            ],
+            "example": "licos-platform uns discover --resource-type connections --protocol opcua",
+        },
+        "resource-search": {
+            "description": "Search reusable points, video channels, or other resources and return a manifestSelector without external IDs.",
+            "parameters": [
+                {"name": "--resource-type", "required": True, "description": "Resource type such as collectionPoints or videoChannels."},
+                {"name": "--protocol", "required": False, "description": "Optional protocol filter."},
+                {"name": "--keyword", "required": False, "description": "Name or business-code search text."},
+                {"name": "--selector-json", "required": False, "description": "Exact business selector JSON object."},
+            ],
+            "example": "licos-platform uns resource-search --resource-type collectionPoints --protocol opcua --keyword TEMP",
+        },
+        "bindings": {
+            "description": "List project UNS node codes, field contracts, and available runtime capabilities.",
+            "parameters": [],
+            "example": "licos-platform uns bindings",
+        },
+        "path-resolve": {
+            "description": "Resolve an authorized absolute or relative enterprise UNS path.",
+            "parameters": [{"name": "path", "required": True, "description": "UNS absolute or relative path."}],
+            "example": "licos-platform uns path-resolve project:/AREA_01/TEMP_01",
+        },
+        "validate": {
+            "description": "Validate a local JSON document in the runtime project scope.",
+            "parameters": [{"name": "--file", "required": True, "description": "Local UNS JSON file."}],
+            "example": "licos-platform uns validate --file UNS.json.candidate",
+        },
+        "plan": {
+            "description": "Create a deterministic read-only reconciliation plan for a local JSON document.",
+            "parameters": [{"name": "--file", "required": True, "description": "Local UNS JSON file."}],
+            "example": "licos-platform uns plan --file UNS.json",
+        },
         "apply": {
-            "description": "Execute a previously reviewed plan after explicit confirmation and hash verification.",
-            "parameters": [
-                {"name": "--file", "required": True, "description": "The exact local UNS JSON document that was planned."},
-                {"name": "--document-hash", "required": True, "description": "documentHash returned by the reviewed plan."},
-                {"name": "--plan-hash", "required": True, "description": "planHash returned by the reviewed plan."},
-                {"name": "--confirm", "required": True, "description": "Explicitly confirm external writes."},
-            ],
+            "description": "Execute a previously reviewed plan after explicit confirmation and hash verification.",
+            "parameters": [
+                {"name": "--file", "required": True, "description": "The exact local UNS JSON document that was planned."},
+                {"name": "--document-hash", "required": True, "description": "documentHash returned by the reviewed plan."},
+                {"name": "--plan-hash", "required": True, "description": "planHash returned by the reviewed plan."},
+                {"name": "--confirm", "required": True, "description": "Explicitly confirm external writes."},
+            ],
             "example": "licos-platform uns apply --file UNS.json --document-hash <documentHash> --plan-hash <planHash> --confirm",
         },
-        "finalize": {
-            "description": "Validate and atomically install a candidate as project-root UNS.json, revalidate it, and return a read-only plan.",
-            "parameters": [{"name": "--file", "required": True, "description": "Candidate JSON file inside LICOS_PROJECT_PATH."}],
-            "example": "licos-platform uns finalize --file .UNS.json.candidate",
+        "changes-validate": {
+            "description": "Validate one strict UNSChangeSet document without writes.",
+            "parameters": [{"name": "--file", "required": True, "description": "Local UNSChangeSet JSON file."}],
+            "example": "licos-platform uns changes-validate --file UNS.change.json",
         },
-        "data-query": {
-            "description": "Query stored rows through a data or point UNS node.",
-            "parameters": [
-                {"name": "node_code", "required": False, "description": "Current-project UNS node code; mutually exclusive with --path."},
-                {"name": "--path", "required": False, "description": "Authorized UNS path; mutually exclusive with node_code."},
-            ],
-            "example": "licos-platform uns data-query ORDERS --page-size 50",
+        "changes-plan": {
+            "description": "Resolve targets and create a read-only plan for one UNSChangeSet.",
+            "parameters": [{"name": "--file", "required": True, "description": "Local UNSChangeSet JSON file."}],
+            "example": "licos-platform uns changes-plan --file UNS.change.json",
         },
-        "data-write": {
-            "description": "Write structured fields through a UNS node after explicit confirmation.",
+        "changes-apply": {
+            "description": "Apply the exact reviewed UNSChangeSet; destructive or replacement actions require impact confirmation.",
             "parameters": [
-                {"name": "node_code", "required": False, "description": "Current-project UNS node code; mutually exclusive with --path."},
-                {"name": "--path", "required": False, "description": "Authorized UNS path; mutually exclusive with node_code."},
-                {"name": "--fields-json", "required": True, "description": "Field-value JSON object."},
-                {"name": "--confirm", "required": True, "description": "Explicitly confirm the write."},
+                {"name": "--file", "required": True, "description": "The exact UNSChangeSet document that was planned."},
+                {"name": "--document-hash", "required": True, "description": "documentHash returned by changes-plan."},
+                {"name": "--plan-hash", "required": True, "description": "planHash returned by changes-plan."},
+                {"name": "--confirm", "required": True, "description": "Confirm the planned writes."},
+                {"name": "--confirm-impact", "required": False, "description": "Additionally confirm delete, move, replacement, or rebind impact."},
             ],
-            "example": "licos-platform uns data-write ORDERS --fields-json '{\"amount\":12}' --confirm",
+            "example": "licos-platform uns changes-apply --file UNS.change.json --document-hash <documentHash> --plan-hash <planHash> --confirm --confirm-impact",
         },
-        "data-delete": {
-            "description": "Delete exact rows returned by a prior UNS query after explicit confirmation.",
+        "node-update": {
+            "description": "Build and plan one supported node metadata update; this command never applies it.",
             "parameters": [
-                {"name": "node_code", "required": False, "description": "Current-project UNS node code; mutually exclusive with --path."},
-                {"name": "--path", "required": False, "description": "Authorized UNS path; mutually exclusive with node_code."},
-                {"name": "--rows-json", "required": True, "description": "Non-empty JSON array containing exact queried row objects."},
-                {"name": "--confirm", "required": True, "description": "Explicitly confirm the deletion."},
+                {"name": "--path / --node-code", "required": True, "description": "Exactly one project-local target locator."},
+                {"name": "--set-json", "required": True, "description": "Supported node fields to replace."},
             ],
-            "example": "licos-platform uns data-delete ORDERS --rows-json '[{\"orderNo\":\"SO-1\"}]' --confirm",
+            "example": "licos-platform uns node-update --path project:/LINE_1/TEMP_1 --set-json '{\"name\":\"炉温\"}'",
         },
-        "point-current": {
-            "description": "Read the current value of a bound UNS point.",
+        "node-move": {
+            "description": "Build and plan one project-local node move; this command never applies it.",
             "parameters": [
-                {"name": "node_code", "required": False, "description": "Current-project point code; mutually exclusive with --path."},
-                {"name": "--path", "required": False, "description": "Authorized point path; mutually exclusive with node_code."},
+                {"name": "--path / --node-code", "required": True, "description": "Exactly one target locator."},
+                {"name": "--parent-path / --parent-node-code", "required": True, "description": "Exactly one destination locator."},
             ],
-            "example": "licos-platform uns point-current TEMP_01",
+            "example": "licos-platform uns node-move --node-code TEMP_1 --parent-path project:/LINE_2",
         },
-        "point-history": {
-            "description": "Read an ISO-8601 time range of historical point values.",
+        "point-rebind": {
+            "description": "Build and plan rebinding one point to one exact existing collection point; this command never applies it.",
             "parameters": [
-                {"name": "node_code", "required": False, "description": "Current-project point code; mutually exclusive with --path."},
-                {"name": "--path", "required": False, "description": "Authorized point path; mutually exclusive with node_code."},
-                {"name": "--start-time / --end-time", "required": True, "description": "UTC ISO-8601 range."},
+                {"name": "--path / --node-code", "required": True, "description": "Exactly one point target locator."},
+                {"name": "--selector-json", "required": True, "description": "Exact tagCode, taskName, and protocol selector."},
+                {"name": "--field-mappings-json", "required": False, "description": "Optional field mapping array."},
             ],
-            "example": "licos-platform uns point-history TEMP_01 --start-time 2026-07-13T00:00:00Z --end-time 2026-07-14T00:00:00Z",
+            "example": "licos-platform uns point-rebind --node-code TEMP_1 --selector-json '{\"tagCode\":\"T1\",\"taskName\":\"OPC采集\",\"protocol\":\"opcua\"}'",
         },
-        "point-write": {
-            "description": "Dry-run or explicitly confirm a writable point control with audit reason and ticket.",
+        "directory-create": {
+            "description": "Build and plan creating one project-local grouping directory; this command never applies it.",
             "parameters": [
-                {"name": "node_code", "required": False, "description": "Current-project point code; mutually exclusive with --path."},
-                {"name": "--path", "required": False, "description": "Authorized point path; mutually exclusive with node_code."},
-                {"name": "--value-json", "required": True, "description": "Typed JSON scalar or value."},
-                {"name": "--reason / --ticket", "required": True, "description": "Audit context."},
-                {"name": "--request-id", "required": False, "description": "Idempotency/correlation key; generated by the platform when omitted."},
-                {"name": "--dry-run / --confirm", "required": True, "description": "Dry-run or explicit execution confirmation."},
+                {"name": "--parent-path / --parent-node-code", "required": True, "description": "Exactly one parent locator."},
+                {"name": "--node-json", "required": True, "description": "Directory name, stable code, and optional metadata."},
             ],
-            "example": "licos-platform uns point-write MOTOR_START --value-json true --reason 'start line' --ticket WO-100 --dry-run",
+            "example": "licos-platform uns directory-create --parent-path project:/ --node-json '{\"name\":\"一号产线\",\"code\":\"LINE_1\"}'",
         },
-        "video-stream": {
-            "description": "Get credential-safe playback options for a UNS video node.",
+        "connection-update": {
+            "description": "生成并规划一个当前项目托管采集连接的增量修改，不直接执行写入。",
             "parameters": [
-                {"name": "node_code", "required": False, "description": "Current-project video code; mutually exclusive with --path."},
-                {"name": "--path", "required": False, "description": "Authorized video path; mutually exclusive with node_code."},
+                {"name": "--selector-json", "required": True, "description": "精确的 name、protocol 选择器。"},
+                {"name": "--set-json", "required": True, "description": "name、credentialRef 或 configPatch。"},
+                {"name": "--output", "required": False, "description": "在项目目录内保存生成的 UNSChangeSet。"},
             ],
-            "example": "licos-platform uns video-stream CAMERA_01",
+            "example": "licos-platform uns connection-update --selector-json '{\"name\":\"一号PLC\",\"protocol\":\"modbus-tcp\"}' --set-json '{\"configPatch\":{\"host\":\"10.0.0.2\"}}' --output UNS.change.json",
         },
-        "video-snapshot": {
-            "description": "Capture a snapshot from a UNS video node.",
+        "collection-task-update": {
+            "description": "生成并规划一个当前项目托管采集任务的增量修改，不直接执行写入。",
             "parameters": [
-                {"name": "node_code", "required": False, "description": "Current-project video code; mutually exclusive with --path."},
-                {"name": "--path", "required": False, "description": "Authorized video path; mutually exclusive with node_code."},
+                {"name": "--selector-json", "required": True, "description": "精确的 name、protocol、connectionName 选择器。"},
+                {"name": "--set-json", "required": True, "description": "name、pollIntervalMs、enabled 或 configPatch。"},
+                {"name": "--output", "required": False, "description": "在项目目录内保存生成的 UNSChangeSet。"},
             ],
-            "example": "licos-platform uns video-snapshot CAMERA_01",
+            "example": "licos-platform uns collection-task-update --selector-json '{\"name\":\"温度采集\",\"protocol\":\"modbus-tcp\",\"connectionName\":\"一号PLC\"}' --set-json '{\"pollIntervalMs\":2000}' --output UNS.change.json",
         },
-        "video-control": {
-            "description": "Execute an explicitly confirmed PTZ or preset action.",
+        "point-config-update": {
+            "description": "生成并规划一个当前项目托管采集点位配置的增量修改，不改变点位编码和所属任务。",
             "parameters": [
-                {"name": "node_code", "required": False, "description": "Current-project video code; mutually exclusive with --path."},
-                {"name": "--path", "required": False, "description": "Authorized video path; mutually exclusive with node_code."},
-                {"name": "--action", "required": True, "description": "move, stop, preset-set, or preset-goto."},
-                {"name": "--parameters-json", "required": False, "description": "Action-specific JSON parameters."},
-                {"name": "--confirm", "required": True, "description": "Explicitly confirm video control."},
+                {"name": "--selector-json", "required": True, "description": "精确的 tagCode、taskName、protocol 选择器。"},
+                {"name": "--set-json", "required": True, "description": "点位通用字段或协议 addressPatch。"},
+                {"name": "--output", "required": False, "description": "在项目目录内保存生成的 UNSChangeSet。"},
             ],
-            "example": "licos-platform uns video-control CAMERA_01 --action move --parameters-json '{\"direction\":\"left\"}' --confirm",
+            "example": "licos-platform uns point-config-update --selector-json '{\"tagCode\":\"TEMP_01\",\"taskName\":\"温度采集\",\"protocol\":\"modbus-tcp\"}' --set-json '{\"addressPatch\":{\"address\":\"40002\"}}' --output UNS.change.json",
         },
-    },
-}
-
-
-HELP_TOPICS = {
+        "finalize": {
+            "description": "Validate and atomically install a candidate as project-root UNS.json, revalidate it, and return a read-only plan.",
+            "parameters": [{"name": "--file", "required": True, "description": "Candidate JSON file inside LICOS_PROJECT_PATH."}],
+            "example": "licos-platform uns finalize --file .UNS.json.candidate",
+        },
+        "data-query": {
+            "description": "Query stored rows through a data or point UNS node.",
+            "parameters": [
+                {"name": "node_code", "required": False, "description": "Current-project UNS node code; mutually exclusive with --path."},
+                {"name": "--path", "required": False, "description": "Authorized UNS path; mutually exclusive with node_code."},
+            ],
+            "example": "licos-platform uns data-query ORDERS --page-size 50",
+        },
+        "data-write": {
+            "description": "Write structured fields through a UNS node after explicit confirmation.",
+            "parameters": [
+                {"name": "node_code", "required": False, "description": "Current-project UNS node code; mutually exclusive with --path."},
+                {"name": "--path", "required": False, "description": "Authorized UNS path; mutually exclusive with node_code."},
+                {"name": "--fields-json", "required": True, "description": "Field-value JSON object."},
+                {"name": "--confirm", "required": True, "description": "Explicitly confirm the write."},
+            ],
+            "example": "licos-platform uns data-write ORDERS --fields-json '{\"amount\":12}' --confirm",
+        },
+        "data-delete": {
+            "description": "Delete exact rows returned by a prior UNS query after explicit confirmation.",
+            "parameters": [
+                {"name": "node_code", "required": False, "description": "Current-project UNS node code; mutually exclusive with --path."},
+                {"name": "--path", "required": False, "description": "Authorized UNS path; mutually exclusive with node_code."},
+                {"name": "--rows-json", "required": True, "description": "Non-empty JSON array containing exact queried row objects."},
+                {"name": "--confirm", "required": True, "description": "Explicitly confirm the deletion."},
+            ],
+            "example": "licos-platform uns data-delete ORDERS --rows-json '[{\"orderNo\":\"SO-1\"}]' --confirm",
+        },
+        "point-current": {
+            "description": "Read the current value of a bound UNS point.",
+            "parameters": [
+                {"name": "node_code", "required": False, "description": "Current-project point code; mutually exclusive with --path."},
+                {"name": "--path", "required": False, "description": "Authorized point path; mutually exclusive with node_code."},
+            ],
+            "example": "licos-platform uns point-current TEMP_01",
+        },
+        "point-history": {
+            "description": "Read an ISO-8601 time range of historical point values.",
+            "parameters": [
+                {"name": "node_code", "required": False, "description": "Current-project point code; mutually exclusive with --path."},
+                {"name": "--path", "required": False, "description": "Authorized point path; mutually exclusive with node_code."},
+                {"name": "--start-time / --end-time", "required": True, "description": "UTC ISO-8601 range."},
+            ],
+            "example": "licos-platform uns point-history TEMP_01 --start-time 2026-07-13T00:00:00Z --end-time 2026-07-14T00:00:00Z",
+        },
+        "point-write": {
+            "description": "Dry-run or explicitly confirm a writable point control with audit reason and ticket.",
+            "parameters": [
+                {"name": "node_code", "required": False, "description": "Current-project point code; mutually exclusive with --path."},
+                {"name": "--path", "required": False, "description": "Authorized point path; mutually exclusive with node_code."},
+                {"name": "--value-json", "required": True, "description": "Typed JSON scalar or value."},
+                {"name": "--reason / --ticket", "required": True, "description": "Audit context."},
+                {"name": "--request-id", "required": False, "description": "Idempotency/correlation key; generated by the platform when omitted."},
+                {"name": "--dry-run / --confirm", "required": True, "description": "Dry-run or explicit execution confirmation."},
+            ],
+            "example": "licos-platform uns point-write MOTOR_START --value-json true --reason 'start line' --ticket WO-100 --dry-run",
+        },
+        "video-stream": {
+            "description": "Get credential-safe playback options for a UNS video node.",
+            "parameters": [
+                {"name": "node_code", "required": False, "description": "Current-project video code; mutually exclusive with --path."},
+                {"name": "--path", "required": False, "description": "Authorized video path; mutually exclusive with node_code."},
+            ],
+            "example": "licos-platform uns video-stream CAMERA_01",
+        },
+        "video-snapshot": {
+            "description": "Capture a snapshot from a UNS video node.",
+            "parameters": [
+                {"name": "node_code", "required": False, "description": "Current-project video code; mutually exclusive with --path."},
+                {"name": "--path", "required": False, "description": "Authorized video path; mutually exclusive with node_code."},
+            ],
+            "example": "licos-platform uns video-snapshot CAMERA_01",
+        },
+        "video-control": {
+            "description": "Execute an explicitly confirmed PTZ or preset action.",
+            "parameters": [
+                {"name": "node_code", "required": False, "description": "Current-project video code; mutually exclusive with --path."},
+                {"name": "--path", "required": False, "description": "Authorized video path; mutually exclusive with node_code."},
+                {"name": "--action", "required": True, "description": "move, stop, preset-set, or preset-goto."},
+                {"name": "--parameters-json", "required": False, "description": "Action-specific JSON parameters."},
+                {"name": "--confirm", "required": True, "description": "Explicitly confirm video control."},
+            ],
+            "example": "licos-platform uns video-control CAMERA_01 --action move --parameters-json '{\"direction\":\"left\"}' --confirm",
+        },
+    },
+}
+
+
+HELP_TOPICS = {
     "storage": STORAGE_HELP,
     "database": DATABASE_HELP,
     "knowledge": KNOWLEDGE_HELP,
-    "oauth": OAUTH_HELP,
-    "uns": UNS_HELP,
+    "oauth": OAUTH_HELP,
+    "uns": UNS_HELP,
 }
 
 
@@ -701,22 +784,22 @@ def _cmd_help(args: argparse.Namespace) -> dict[str, Any]:
     if not args.topic:
         return {
             "description": "Structured help for LICOS platform CLI topics.",
-            "usage": [
-                "licos-platform help storage",
-                "licos-platform help storage upload-file",
-                "licos-platform help database",
-                "licos-platform help database query",
-                "licos-platform help database export-orm",
-                "licos-platform help database studio-ensure",
-                "licos-platform help knowledge",
-                "licos-platform help knowledge search",
-                "licos-platform help oauth",
-                "licos-platform help oauth configure-project",
-                "licos-platform help uns",
-                "licos-platform help uns protocol-schema",
-            ],
-            "topics": sorted(HELP_TOPICS),
-        }
+            "usage": [
+                "licos-platform help storage",
+                "licos-platform help storage upload-file",
+                "licos-platform help database",
+                "licos-platform help database query",
+                "licos-platform help database export-orm",
+                "licos-platform help database studio-ensure",
+                "licos-platform help knowledge",
+                "licos-platform help knowledge search",
+                "licos-platform help oauth",
+                "licos-platform help oauth configure-project",
+                "licos-platform help uns",
+                "licos-platform help uns protocol-schema",
+            ],
+            "topics": sorted(HELP_TOPICS),
+        }
     topic = HELP_TOPICS[args.topic]
     if not args.command:
         return topic

{licos_platform_cli-0.3.1 → licos_platform_cli-0.3.3}/src/licos_platform_cli/main.py

@@ -11,8 +11,8 @@ from .database_commands import add_database_parser
 from .help_commands import add_help_parser
 from .knowledge_commands import add_knowledge_parser
 from .oauth_commands import add_oauth_parser
-from .storage_commands import add_storage_parser
-from .uns_commands import add_uns_parser
+from .storage_commands import add_storage_parser
+from .uns_commands import add_uns_parser
 
 
 def _print_json(value: Any) -> None:
@@ -34,8 +34,8 @@ def _build_parser() -> argparse.ArgumentParser:
     add_storage_parser(subparsers)
     add_database_parser(subparsers)
     add_knowledge_parser(subparsers)
-    add_oauth_parser(subparsers)
-    add_uns_parser(subparsers)
+    add_oauth_parser(subparsers)
+    add_uns_parser(subparsers)
     return parser