tirtc-devtools-cli 0.2.0 → 0.2.1

package/README.md

@@ -8,7 +8,7 @@
 - `assets prepare`：把默认资产或任意 MP4 准备成 native role driver 使用的媒体资产。
 - `device start`：作为标准上行 device 启动 native DevTools driver，送出音视频，按需产出本机 `bootstrap.json` 与 execution evidence。
 - `client start`：作为标准下行 client 消费本机 `bootstrap.json` 或显式 device/token，产出 `frame_dump` 与 summary。
-- CLI 负责参数、环境变量、token 签发、JSON envelope、artifact 摘要与打包定位；真实 TiRTC lifecycle 由 `products/devtools/driver/` 承接。
+- CLI 负责参数、环境变量、token 签发、JSON envelope、artifact 摘要与打包定位；真实 TiRTC lifecycle 由 `products/devtools/driver/` 承接。native role 失败且 runtime logging 已初始化时，driver 会在退出前尝试上传日志，CLI JSON 会透出 `log_id` 与 `log_upload` 结果。
 
 ## 不负责什么
 
@@ -60,6 +60,10 @@ node products/cli/bin/tirtc-devtools-cli.js --json device start \
 `--duration-ms <ms>`。prepared asset 会按完整音视频轨循环，任一轨到达源文件末尾时
 audio/video 同步回到源头并保持 PTS 继续递增。
 
+native role 失败时，`reason_code` 与 `failed_stage` 仍是主失败事实；`log_upload`
+只说明失败现场日志是否已上传。上传成功时，CLI JSON 与 `summary.json` 会包含
+可用于后续抓取的 `log_id`。
+
 打包入口：
 
 ```sh

package/dist/cli/src/role_driver.js

@@ -471,6 +471,8 @@ async function runRole(role, commandOptions, options) {
             bootstrap_path: summary.bootstrap_path,
             reason_code: summary.reason_code,
             failed_stage: failedStage(summary),
+            log_id: summary.log_upload?.log_id,
+            log_upload: summary.log_upload,
         };
         if (summary.exit_code === 0 && summary.status === 'completed') {
             printEnvelope(options, 0, 'OK', data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tirtc-devtools-cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": false,
   "main": "dist/cli/src/index.js",
   "types": "dist/cli/src/index.d.ts",

package/vendor/runtime/linux-x64/manifest.txt

@@ -1,6 +1,6 @@
 platform=linux-x64
 profile=full
-staged_at_utc=2026-04-30T14:15:15Z
+staged_at_utc=2026-04-30T14:53:23Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/linux-x64
 
 bfc096be1484ac2b1c2776ccabfa2a4c6a982e869abf875192ff06fad85e82ca  include/tirtc/audio.h
@@ -36,7 +36,7 @@ b1f4135025cb8e8520a14268d831b9998920a4239f84bb6b409d0e4909fd5bee  lib/libcrypto.
 296ba0b5efa9d2ac49e3bf278c5d467b31436e73fbc608b736e974bcf9759bde  lib/libmatrix_runtime_audio.a
 88f9c545943e4ef80024baf3620e91817ec16a4fea60b0e8c7887a0a41dc9d1b  lib/libmatrix_runtime_facade.a
 ec7bbf8e8744c6645a441a28e24e0645906152cc987d6fcca16af3c3badba940  lib/libmatrix_runtime_foundation_http.a
-4038af89ac4dc7e7c99ac9ace58ce063661ddb3134f71664b79221ade4adb8d1  lib/libmatrix_runtime_foundation_logging.a
+c8d9968c3544028f2e800d7f5ab6fa1604c54d5fddc682d65b5885ebac3967a8  lib/libmatrix_runtime_foundation_logging.a
 9c7108b70cb442dee02cfdb4f98891a8a099f15c379e9e48cf53d7b276f6e894  lib/libmatrix_runtime_media.a
 fc498c74804ef35dc3939a6368d9ae908b0e35578db32eb7902ad00107781295  lib/libmatrix_runtime_transport.a
 337d38891e264e76aeb61a4e25a3b0bad56ab26697948805e64dec920874093f  lib/libmatrix_runtime_video.a

package/vendor/runtime/macos-arm64/manifest.txt

@@ -1,6 +1,6 @@
 platform=macos-arm64
 profile=full
-staged_at_utc=2026-04-30T14:13:34Z
+staged_at_utc=2026-04-30T14:51:39Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/macos-arm64
 
 bfc096be1484ac2b1c2776ccabfa2a4c6a982e869abf875192ff06fad85e82ca  include/tirtc/audio.h
@@ -35,13 +35,13 @@ cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/
 8db86d6714264047e8fd4086ddd7315722d675749719e6175f89eb5a636b48a1  lib/libTiRTC.a
 b39daee6a3d39bf0ca20c45084601133c4198de8dca848dcff6dd9c70ae99016  lib/libcrypto.a
 c052857ef315e3d61db9c862cad10709a3a6b2487dc41799cbe4d74a805de875  lib/libcrypto.dylib
-9466d90d68de9ea40a5ef2c5ff393fe94f3ec22f410dcc9c1707253344971a17  lib/libmatrix_runtime_audio.a
-8bc2920d99c7cf575af169baeba9725951d56d3891e2ba4bf50d99023ac4608c  lib/libmatrix_runtime_facade.a
-3d3ef3d682052b7ab982b82597a3810e091ab4eb3a6b40177a88d60d0391d800  lib/libmatrix_runtime_foundation_http.a
-e329006b0f653f338c22addb307bd5fca56163e8f6ab6adf3d8ce2fa83c28523  lib/libmatrix_runtime_foundation_logging.a
-1e7e5b699d3625d4ba3b514b21d43ca3915d6a3f15997a74de93d86509d4e58f  lib/libmatrix_runtime_media.a
-7945859c05cbc4e55f95b1eee109e0f604d90ff3cbe69bb17e3932b6b094ad01  lib/libmatrix_runtime_transport.a
-b93f5eec5e4fe4278c161095c3b3445f71f78898f4b293efc2b7299d18c91253  lib/libmatrix_runtime_video.a
+33742c05d53b6d7cf5c415ef0cd011a78b800493a02da341d856717fff9ae36a  lib/libmatrix_runtime_audio.a
+30c3ab7aaf27c7de6674ce9a1e41bb381c763e965142ad62acb4fb67d40bc852  lib/libmatrix_runtime_facade.a
+a2e3bdd6b2543e83972c7cc4052b3df1516c8c323208402b7d4cd5e26f4fc86b  lib/libmatrix_runtime_foundation_http.a
+45270e2123ea3f40eb1f20a2909018e3d5e6fb58d11f849ba72f6087c76c9d75  lib/libmatrix_runtime_foundation_logging.a
+9aadb323e7c61ec1a06ae5f50f452d39d4a3180a757b562977e7e000f64a1f06  lib/libmatrix_runtime_media.a
+8ffe6de3e6268d6002ca73c65c9f68968c761a76d0a2bcb2ea0cd70c750e7e0f  lib/libmatrix_runtime_transport.a
+5dfce7599170bba0f14167373b489934f744eb01b8ff12fd491d99d985a9d008  lib/libmatrix_runtime_video.a
 c11c65d373a127028350c41fa58cd2d1223f2b5d70a84e13b115d90daaba25ca  lib/libssl.a
 ef1c1104bbdd2528ed7b958fb7252bd6249875f92300b0c9577d6c4bd6c0d88a  lib/libssl.dylib
 e14e846e43d64e240fa0e5745bf4e702b79d0f2442e7f768beb990610735c71b  lib/libtgrtc.dylib