PCLI2
2.1.0 - 2026-09-22
v2.1.0
Sep 22 2026 at 15:51 UTC
Added
asset diagnoseexplains why an asset failed to process (aliasesfailure,why) - Physna added on-demand failure diagnostics: the server searches its ingestion logs for the asset and answers with astatus(found,not-found,unavailable), akind(user, with a summary you can act on, orinternal, with a trace ID to quote to support), the summary, the trace ID and when it happened. The command takes--uuidor--path, prints JSON or CSV (ASSET_PATH,ASSET_STATE,STATUS,KIND,SUMMARY,TRACE_ID,OCCURRED_AT,ASSET_UUID), exits 0 forfoundandnot-found(with a stderr note saying whether the asset is simply not failed or the log entry has aged out), and exits 68 on a deployment without failure log search. Until now a failed asset was only visible as the wordfailedin aSTATEcolumn.tenant failureslists what failed lately - Assets, reports and part-finder reports in one listing, newest first, with--kindto narrow it (repeatable) and--limitto stop early. JSON output also carries the tenant-wide totals per kind; CSV isKIND,NAME,ID,FAILED_AT. TheIDof anassetrow is whatasset diagnose --uuidtakes.pcli2 doctorreports whether failure diagnostics are available - A newdiagnosticsline asks the deployment up front, so a customer-managed or enclave stack without log search is visible beforeasset diagnoseexits 68 there. It is a warning, never a failure.- Exit code 68 (service unavailable) is documented - It was defined but unused outside
doctor;asset diagnosenow uses it for a feature the deployment does not have.
Changed
asset similarityCSV carries every volumetric field - The API's volumetric block gained the mismatch-volume breakdown, the unmatched holes and the matched-hole distance in 2.0.2, but only the JSON output showed them. CSV now hasMISMATCH_VOLUME_TOTAL_MM3,SOURCE_MISS_MM3,TARGET_MISS_MM3,SOURCE_HOLE_MISS_MM3,TARGET_HOLE_MISS_MM3,MATCHED_HOLE_CENTER_DISTANCE_TOTAL_MM,SOURCE_HOLE_MISSESandTARGET_HOLE_MISSES(the last two are counts; the holes themselves are JSON-only) afterVOLUMETRIC_MATCH_PERCENTAGE. Every volumetric cell is empty, not0, when the tenant has no volumetric scoring or the API did not report that field. TheREFERENCE_ASSET_UUID,CANDIDATE_ASSET_UUIDandCOMPARISON_URLcolumns moved right accordingly: read CSV columns by header name.- The spec review found no drift - The live OpenAPI specification is identical to the snapshot refreshed in 2.0.2, so no existing command changed. The three failure endpoints (
failure-diagnostics,failure-diagnostics/availability,failures) and their enumerations are now covered by the contract tests and the weekly drift check.