PCLI2
2.2.0 - 2026-09-22
Added
-
asset moveputs an asset in another folder (aliasmv) ---uuidor--pathnames the asset,--folder-uuidor--folder-paththe destination;/(or/Home) as the path is the root. The asset keeps its UUID and metadata; only its path changes. Silent on success,--dry-runnames the asset and the destination. UsesPATCH /tenants/{tenantId}/assets/{assetId}/folder. -
asset resolve-dependencylinks a missing dependency to an existing asset (aliasresolve-dep) - An assembly whose referenced part was not found stays in themissing-dependenciesstate.--dependencytakes the missing path asasset dependencieslists it,--target-uuidor--target-paththe asset that should stand in for it; the server re-indexes the assembly. The dependency must be one of the assembly's missing ones, otherwise the command stops and lists them (exit 64), so a typo never reaches the server. Silent on success,--dry-runnames everything. UsesPOST /tenants/{tenantId}/assets/{assetId}/resolve-dependency. -
tenant metadatamanages the field registry - Besidelist:rename --name OLD --new-name NEW(values on assets are kept),delete --name NAME [--force](the server refuses a field still in use unless--force, which also removes its values from every asset; confirms unless--yes,--dry-runsupported),assets --name NAME [--limit N](the assets with a value for the field, printed likeasset list),coverage(how many assets carry any metadata: counts and a percentage, JSON or CSV), andmissing [--folder-path P]* [--extension E]* [--limit N](the assets with no metadata at all, oldest first; Physna's demo assets excluded). Fields are addressed by their exact registered name; an unknown name lists the registered ones (exit 67). Endpoints:PATCH/DELETE /tenants/{tenantId}/metadata-fields/{fieldId},GET .../metadata-fields/{fieldId}/assets,GET .../metadata-coverage,GET .../assets/without-metadata. -
pcli2 reportmanages report jobs - A new command group for the server-side reports (duplication, simplification, custom).report list [--type] [--status] [--limit](newest first; CSVID,NAME,TYPE,STATUS,PROGRESS,GROUPS,MIN_THRESHOLD,MAX_THRESHOLD,CREATED_AT,UPDATED_AT,CREATOR),report get --id,report download --id --format csv|xlsx [-o PATH](only a COMPLETED report; the file is streamed through a temporary file like an asset download; the default name is the report's name or id plus the extension),report diagnose --id(why a report failed, same shape and exit codes asasset diagnose),report delete --id(confirms unless--yes,--dry-run), andreport createfor a duplication report over--folder-pathfolders (subfolders included;--exclude-folder-path,--extension,--exclude-assemblies,--exclude-exact-duplicates,--include-home, thresholds default 80 to 100).--waitpolls until the report is COMPLETED, FAILED or CANCELLED (progress on stderr; a credential failure stops at once, any other polling error is retried up to three times in a row) and a report that ended FAILED or CANCELLED exits 69 with a pointer toreport diagnose.tenant failuresalready listed failed reports; their ids now have somewhere to go.
Changed
-
tenant metadata listJSON carries each field'sid- The registry listing always sent ids; the client now reads them, since rename and delete address a field by id. The CSV and tree output are unchanged. -
Dependencies are read by asset ID -
asset dependencies,folder dependenciesandasset dependency-diffnow useGET /tenants/{tenantId}/assets/{assetId}/dependencies-by-id, which looks the asset up by its stored path on the server, so the lookup keeps working after a folder is moved or renamed. The path-based/assets/{assetPath}/dependenciesendpoint the commands used is deprecated in Physna's specification. Output is unchanged in every format. The client now also reads each dependency'sstatus(matched,resolved,missing) and never asks the API about a missing dependency's children (it has no asset, so the only UUID to ask about was the nil one). -
--skip-existingasks the server instead of listing the folder -asset create-batch --skip-existingandfolder upload(which checks for existing names in both modes) now send the target paths toPOST /tenants/{tenantId}/assets/existing-paths, one request per 1000 files, instead of paging through the whole destination folder. Which files are skipped, theSkipping existing asset: ...lines, the counts and the "Asset already exists" error are unchanged. -
asset create --overridereplaces the file in place - When the asset exists and the new file has the same extension, the file is sent toPUT /tenants/{tenantId}/assets/{assetId}/file: the asset keeps its UUID, path and metadata and is re-indexed with the new content. Nothing is deleted, so a failed upload leaves the tenant as it was.--restore-metadatahas nothing to do in that case and says so. A file with a different extension still goes the old way (delete, then upload, with the conflict retry and the loss report).--override --dry-runnow says which of the two would happen and names the asset; without--overridethe dry-run line is unchanged. Uploads (asset create,asset create-batch,folder upload) go through the client's upload variant, which shares the token with the rest of the run; it makes no difference today because there is no separate upload timeout setting. -
asset gettakes several--uuidvalues - They are fetched with onePOST /tenants/{tenantId}/assets/batchrequest (up to 1000 per request) and printed as an asset list, in the same JSON and CSV shapes asasset list. Every id must exist: otherwise nothing is printed and the missing ids are named (exit 67). With one--uuidor--paththe output is unchanged. The client's batch method, which nothing used, now calls that endpoint instead of one request per asset.
Fixed
folder dependencieslists assemblies in a stable order - The JSON and tree output listed a folder's assemblies in a different order on every run (the folder listing is a map). They are now sorted by path, as the CSV rows already were.
Removed
- Four path-based dependency methods of the client library -
get_asset_dependencies_by_path,get_asset_dependencies_by_path_with_pagination,populate_asset_dependencies_recursive_by_pathand the unusedpopulate_asset_dependencies_recursive. Every command that used them holds the asset's UUID already and callsget_asset_dependencies_by_uuid.