taskmeld 0.1.2 → 0.1.41

package/dist/src/artifacts/artifact-cleanup.js

@@ -12,8 +12,8 @@ const DEFAULT_RETENTION_DAYS = {
 };
 const ONE_DAY_MS = 24 * 60 * 60 * 1000;
 /**
- * 生成清理计划，不删除任何文件。
- * 默认只清理 success 状态，可通过 options 指定其他状态。
+ * Generate a cleanup plan without deleting any files.
+ * Defaults to only cleaning "success" status; other statuses can be specified via options.
  */
 const planCleanup = async (definition, options = {}) => {
     const statuses = options.statuses?.length ? options.statuses : ["success"];
@@ -22,7 +22,7 @@ const planCleanup = async (definition, options = {}) => {
     const kindFilter = options.kinds?.length ? new Set(options.kinds) : null;
     const olderThanDays = options.olderThanDays ?? Math.max(...safeStatuses.map((s) => DEFAULT_RETENTION_DAYS[s] ?? 90));
     const cutoffMs = Date.now() - olderThanDays * ONE_DAY_MS;
-    // 优先从索引获取文件列表，索引缺失时回退扫描
+    // Prefer index for file list; fall back to scan when index is missing
     let items = await (0, artifact_index_1.readIndexRecords)(definition.artifactDir);
     if (items.length === 0) {
         const scanned = await (0, storage_service_1.scanStoredArtifacts)([definition]);
@@ -85,7 +85,7 @@ const planCleanup = async (definition, options = {}) => {
 };
 exports.planCleanup = planCleanup;
 /**
- * 执行清理：删除文件 + 清理空目录 + 清理临时文件 + 重建索引。
+ * Execute cleanup: delete files + clean empty directories + clean temp files + rebuild index.
  */
 const executeCleanup = async (definition, plan) => {
     const warnings = [];
@@ -94,10 +94,10 @@ const executeCleanup = async (definition, plan) => {
     for (const file of plan.files) {
         const rootAbs = (0, node_path_1.resolve)(definition.artifactDir);
         const absPath = (0, node_path_1.resolve)(rootAbs, file.relativePath);
-        // 路径穿越保护：目标必须位于当前 pipeline 的 artifactDir 内
+        // Path traversal protection: target must be within the current pipeline's artifactDir
         if (absPath !== rootAbs && !absPath.startsWith(`${rootAbs}${node_path_1.sep}`)) {
             failed += 1;
-            warnings.push(`拒绝删除越界文件 (${definition.id}:${file.relativePath})`);
+            warnings.push(`Refused to delete out-of-bounds file (${definition.id}:${file.relativePath})`);
             continue;
         }
         try {
@@ -106,27 +106,27 @@ const executeCleanup = async (definition, plan) => {
         }
         catch (error) {
             failed += 1;
-            warnings.push(`删除失败 (${definition.id}:${file.relativePath}): ${error instanceof Error ? error.message : String(error)}`);
+            warnings.push(`Delete failed (${definition.id}:${file.relativePath}): ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    // 清理空目录
+    // Clean empty directories
     await (0, exports.cleanupEmptyDirs)(definition.artifactDir);
-    // 清理临时文件
+    // Clean temp files
     const tmpResult = await (0, exports.cleanupTempFiles)(definition.artifactDir);
     warnings.push(...tmpResult.warnings);
-    // 重建索引以移除已删文件
+    // Rebuild index to remove deleted file entries
     try {
         const { rebuildArtifactIndex } = await import("./artifact-index.js");
         await rebuildArtifactIndex(definition, (d) => (0, storage_service_1.scanStoredArtifacts)([d]));
     }
     catch {
-        warnings.push(`删除后自动重建索引失败 (${definition.id})，请手动执行 rebuild-index`);
+        warnings.push(`Auto-rebuild index after delete failed (${definition.id}), please run rebuild-index manually`);
     }
     return { deleted, failed, warnings };
 };
 exports.executeCleanup = executeCleanup;
 /**
- * 递归清理空目录。保留 artifactDir 根目录本身。
+ * Recursively clean empty directories. Preserves the artifactDir root directory itself.
  */
 const cleanupEmptyDirs = async (artifactDir) => {
     const warnings = [];
@@ -139,7 +139,7 @@ const cleanupEmptyDirs = async (artifactDir) => {
                     await walkAndRemove(`${dirPath}${node_path_1.sep}${entry.name}`);
                 }
             }
-            // 不删除 artifacts 根目录本身
+            // Don't delete the artifacts root directory itself
             const isRoot = dirPath === artifactDir || dirPath.endsWith(`${node_path_1.sep}artifacts`) && dirPath.replace(/\\/g, "/").endsWith("/artifacts");
             if (isRoot)
                 return;
@@ -150,7 +150,7 @@ const cleanupEmptyDirs = async (artifactDir) => {
             }
         }
         catch {
-            // 目录不存在或无权访问
+            // Directory doesn't exist or cannot be accessed
         }
     };
     await walkAndRemove(artifactDir);
@@ -158,7 +158,7 @@ const cleanupEmptyDirs = async (artifactDir) => {
 };
 exports.cleanupEmptyDirs = cleanupEmptyDirs;
 /**
- * 清理 persistArtifactFile 遗留的 .tmp-*.json 临时文件（原子写入失败残留）。
+ * Clean up .tmp-*.json temp files left behind by persistArtifactFile (atomic write failure residue).
  */
 const cleanupTempFiles = async (artifactDir) => {
     const warnings = [];
@@ -177,13 +177,13 @@ const cleanupTempFiles = async (artifactDir) => {
                         cleaned += 1;
                     }
                     catch (error) {
-                        warnings.push(`清理临时文件失败: ${error instanceof Error ? error.message : String(error)}`);
+                        warnings.push(`Failed to clean temp files: ${error instanceof Error ? error.message : String(error)}`);
                     }
                 }
             }
         }
         catch {
-            // 目录不存在
+            // Directory doesn't exist
         }
     };
     await walkAndClean(artifactDir);

package/dist/src/artifacts/artifact-index.js

@@ -9,7 +9,7 @@ const INDEX_FILE_NAME = "index.jsonl";
 const getIndexPath = (artifactDir) => (0, node_path_1.resolve)(artifactDir, INDEX_FILE_NAME);
 exports.getIndexPath = getIndexPath;
 const encodeCursorV2 = (cursor) => `v2:${Buffer.from(JSON.stringify(cursor), "utf8").toString("base64url")}`;
-/** 兼容解码 v2 和旧版 cursor。返回 null 表示无效。 */
+/** Compatible decoding for v2 and legacy cursors. Returns null for invalid input. */
 const decodeAnyCursor = (cursor) => {
     if (cursor.startsWith("v2:")) {
         try {
@@ -23,7 +23,7 @@ const decodeAnyCursor = (cursor) => {
             return null;
         }
     }
-    // 旧 v1 cursor 格式: base64url(updatedAt|artifactId)
+    // Legacy v1 cursor format: base64url(updatedAt|artifactId)
     try {
         const raw = Buffer.from(cursor, "base64url").toString("utf8");
         const idx = raw.lastIndexOf("|");
@@ -44,7 +44,7 @@ const getIndexUpdatedAt = async (artifactDir) => {
         return "";
     }
 };
-/** 追加一条索引记录到 index.jsonl。追加失败不抛异常，返回失败信息供调用方观测。 */
+/** Append one index record to index.jsonl. Does not throw on failure; returns failure info for caller observation. */
 const appendIndexRecord = async (artifactDir, record) => {
     const indexPath = (0, exports.getIndexPath)(artifactDir);
     try {
@@ -65,7 +65,7 @@ const appendIndexRecord = async (artifactDir, record) => {
     }
 };
 exports.appendIndexRecord = appendIndexRecord;
-/** 读取索引文件所有行，损坏行跳过。使用流式读取避免大索引一次性内存占用。 */
+/** Read all lines from the index file, skipping corrupt lines. Uses streaming reads to avoid loading a large index entirely into memory. */
 const readIndexRecords = async (artifactDir) => {
     const indexPath = (0, exports.getIndexPath)(artifactDir);
     const records = [];
@@ -81,7 +81,7 @@ const readIndexRecords = async (artifactDir) => {
                 records.push(JSON.parse(line));
             }
             catch {
-                // 损坏行跳过
+                // Skip corrupt lines
             }
         }
     }
@@ -101,7 +101,7 @@ const dedupeLatestByArtifactId = (records) => {
     }
     return [...latest.values()];
 };
-/** 从索引读取、过滤、排序、分页。基于 readIndexRecords 之上提供查询能力。 */
+/** Read from index, filter, sort, paginate. Builds on top of readIndexRecords to provide query capabilities. */
 const listIndexRecords = async (artifactDir, filter) => {
     const records = dedupeLatestByArtifactId(await (0, exports.readIndexRecords)(artifactDir));
     const limitRaw = filter.limit ?? 100;
@@ -133,7 +133,7 @@ const listIndexRecords = async (artifactDir, filter) => {
             continue;
         matched.push(record);
     }
-    // 按 updatedAt DESC, artifactId ASC 排序
+    // Sort by updatedAt DESC, artifactId ASC
     matched.sort((a, b) => {
         const dateDiff = Date.parse(b.updatedAt) - Date.parse(a.updatedAt);
         if (dateDiff !== 0)
@@ -141,13 +141,13 @@ const listIndexRecords = async (artifactDir, filter) => {
         return a.artifactId.localeCompare(b.artifactId);
     });
     const total = matched.length;
-    // cursor 分页：v2 cursor 含 indexUpdatedAt，索引重建后旧 cursor 自动从头开始
+    // cursor pagination: v2 cursor includes indexUpdatedAt; after index rebuild, old cursors automatically restart from the beginning
     let startIndex = 0;
     const currentIndexUpdatedAt = await getIndexUpdatedAt(artifactDir);
     if (filter.cursor) {
         const decoded = decodeAnyCursor(filter.cursor);
         if (decoded) {
-            // 索引代际变化 → cursor 过期，从头开始
+            // Index generation changed → cursor expired, restart from the beginning
             if (decoded.indexUpdatedAt && decoded.indexUpdatedAt !== currentIndexUpdatedAt) {
                 startIndex = 0;
             }
@@ -165,7 +165,7 @@ const listIndexRecords = async (artifactDir, filter) => {
     return { items: page, nextCursor, total };
 };
 exports.listIndexRecords = listIndexRecords;
-/** 从 StoredArtifactIndexRecord 转换为 StoredArtifactItem。 */
+/** Convert from StoredArtifactIndexRecord to StoredArtifactItem. */
 const toStoredArtifactItem = (record, pipelineId, pipelineTitle) => ({
     pipelineId,
     pipelineTitle,
@@ -181,7 +181,7 @@ const toStoredArtifactItem = (record, pipelineId, pipelineTitle) => ({
 });
 exports.toStoredArtifactItem = toStoredArtifactItem;
 /**
- * 扫描一条流水线的产物目录，重建 index.jsonl。
+ * Scan a single pipeline's artifact directory and rebuild its index.jsonl.
  */
 const rebuildArtifactIndex = async (definition, scan) => {
     const warnings = [];
@@ -207,12 +207,12 @@ const rebuildArtifactIndex = async (definition, scan) => {
         await (0, promises_1.rename)(tmpPath, indexPath);
     }
     catch (error) {
-        warnings.push(`重建索引失败 (pipeline ${definition.id}): ${error instanceof Error ? error.message : String(error)}`);
+        warnings.push(`Failed to rebuild index (pipeline ${definition.id}): ${error instanceof Error ? error.message : String(error)}`);
     }
     return { indexed, skipped, warnings };
 };
 exports.rebuildArtifactIndex = rebuildArtifactIndex;
-/** 从 StoredArtifactItem + 读取文件内容 补充为完整的 IndexRecord。 */
+/** Enrich a StoredArtifactItem with its file content to produce a complete IndexRecord. */
 const enrichItemToIndexRecord = async (item, definition) => {
     const filePath = (0, node_path_1.resolve)(definition.artifactDir, item.relativePath);
     let parsed = null;
@@ -221,7 +221,7 @@ const enrichItemToIndexRecord = async (item, definition) => {
         parsed = JSON.parse(raw);
     }
     catch {
-        // 无法读取时用路径启发式信息
+        // When unreadable, use path-based heuristics
     }
     const artifactObj = parsed && typeof parsed.artifact === "object" && parsed.artifact !== null
         ? parsed.artifact

package/dist/src/artifacts/artifact-rebuilder.js

@@ -5,8 +5,8 @@ const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
 const artifact_index_1 = require("./artifact-index");
 /**
- * 增量重建产物索引 — 扫描磁盘目录，仅对缺失索引的文件补充记录。
- * 已有索引记录的文件（按 relativePath 匹配）不会重复添加。
+ * Incrementally rebuild artifact index — scan the disk directory, only append records for files missing from the index.
+ * Files already present in the index (matched by relativePath) are not re-added.
  */
 const rebuildArtifactIndexIncremental = async (rootDir, pipelineId) => {
     const warnings = [];
@@ -36,7 +36,7 @@ const rebuildArtifactIndexIncremental = async (rootDir, pipelineId) => {
         }
     }
     catch {
-        warnings.push(`无法扫描产物根目录: ${rootDir}`);
+        warnings.push(`Failed to scan artifact root directory: ${rootDir}`);
     }
     for (const dir of dirs) {
         const existingRecords = await (0, artifact_index_1.readIndexRecords)(dir.artifactDir);

package/dist/src/artifacts/storage-service.js

@@ -39,7 +39,7 @@ const parseNodeIdFromFileName = (fileName, runId, relativePath) => {
         return null;
     const normalizedPath = toUnixPath(relativePath).toLowerCase();
     if (normalizedPath.includes("/envelopes/")) {
-        // envelope 文件名格式: <runId>-<nodeId>-node-<nodeId>-<uuid>-envelope.json
+        // envelope filename format: <runId>-<nodeId>-node-<nodeId>-<uuid>-envelope.json
         const marker = "-node-";
         const markerIndex = tail.indexOf(marker);
         if (markerIndex > 0) {
@@ -48,13 +48,13 @@ const parseNodeIdFromFileName = (fileName, runId, relativePath) => {
         }
         return null;
     }
-    // group/adpater 聚合文件格式不稳定（含 itemKey），这里不参与节点筛选，避免误判。
+    // group/adapter aggregate file format is unstable (includes itemKey); skip node filtering here to avoid false positives.
     if (tail.endsWith("-adapter-output") || tail.endsWith("-group-output"))
         return null;
     const tokens = tail.split("-").filter(Boolean);
     if (tokens.length < 3)
         return null;
-    // 结构化节点产物命名格式: <runId>-<nodeId>-<artifactIndex>-<safeType>.json
+    // Structured node artifact naming format: <runId>-<nodeId>-<artifactIndex>-<safeType>.json
     let artifactIndexPos = -1;
     for (let i = tokens.length - 1; i >= 0; i -= 1) {
         if (NUMERIC_TOKEN_RE.test(tokens[i])) {
@@ -102,7 +102,7 @@ const parseArtifactPathMeta = (artifactRootAbs, filePathAbs, updatedAtIso) => {
     const dateBucket = DATE_BUCKET_RE.test(dateRaw) ? dateRaw : formatDateBucketFromIso(updatedAtIso);
     let runId = null;
     if (segments[2]?.startsWith("batch-")) {
-        // 批跑产物路径: status/date/batchRunId/runId/...
+        // Batch run artifact path: status/date/batchRunId/runId/...
         runId = segments[3]?.startsWith("run-") ? segments[3] : null;
     }
     else {
@@ -116,7 +116,7 @@ const shouldIncludeArtifactFile = (relativePath) => {
         return false;
     return true;
 };
-/** 文件系统扫描（降级路径 / 索引重建用）。 */
+/** Filesystem scan (fallback path / for index rebuild). */
 const scanStoredArtifacts = async (definitions, options) => {
     const pipelineIdFilter = options?.pipelineIds?.length ? new Set(options.pipelineIds) : null;
     const nodeIdFilter = options?.nodeIds?.length ? new Set(options.nodeIds) : null;
@@ -150,11 +150,11 @@ const scanStoredArtifacts = async (definitions, options) => {
                 continue;
             if (runIdFilter && effectiveRunId !== runIdFilter)
                 continue;
-            // batchRunId 扫描过滤：路径含 batch-xxx 段
+            // batchRunId scan filter: path contains batch-xxx segment
             if (batchRunIdFilter && !meta.relativePath.includes(`/${batchRunIdFilter}/`))
                 continue;
             const nodeId = parseNodeIdFromFileName(fileName, effectiveRunId, meta.relativePath);
-            // kind 扫描过滤：通过文件名后缀和路径判断
+            // kind scan filter: determined by filename suffix and path
             if (kindFilter) {
                 const scanKind = meta.relativePath.includes("/envelopes/") ? "envelope"
                     : fileName.includes("-adapter-output") ? "adapter"
@@ -203,11 +203,11 @@ const decodeListCursor = (cursor) => {
         return null;
     }
 };
-/** 优先读索引，索引缺失时降级为文件系统扫描。支持 cursor 分页。 */
+/** Prefer reading from index; fall back to filesystem scan when index is missing. Supports cursor pagination. */
 const listStoredArtifacts = async (definitions, options) => {
     const pipelineIdFilter = options?.pipelineIds?.length ? new Set(options.pipelineIds) : null;
     const limit = Number.isFinite(options?.limit) ? Math.max(1, Math.min(5000, Math.trunc(options?.limit))) : 100;
-    // 尝试从索引读取（不传 cursor，由外层统一分页）
+    // Try reading from index (without cursor; pagination is handled uniformly by the outer layer)
     const indexItems = [];
     let indexAvailable = false;
     for (const definition of definitions) {
@@ -222,7 +222,7 @@ const listStoredArtifacts = async (definitions, options) => {
             dateTo: options?.dateTo,
             batchRunId: options?.batchRunId,
             runId: options?.runId,
-            limit: 0, // 0 = 无限制，全量读出后统一排序分页
+            limit: 0, // 0 = unlimited; read all then sort and paginate uniformly
         };
         const result = await (0, artifact_index_1.listIndexRecords)(definition.artifactDir, filter);
         if (result.total > 0 || result.items.length > 0) {
@@ -232,7 +232,7 @@ const listStoredArtifacts = async (definitions, options) => {
             }
         }
     }
-    // 统一的排序与 cursor 分页（index 和 scan 使用相同编码）
+    // Unified sort and cursor pagination (index and scan use the same encoding)
     const sortItems = (items) => items.sort((a, b) => Date.parse(b.updatedAt) - Date.parse(a.updatedAt));
     const paginateWithCursor = (items, source) => {
         let startIndex = 0;
@@ -255,7 +255,7 @@ const listStoredArtifacts = async (definitions, options) => {
     if (indexAvailable) {
         return paginateWithCursor(sortItems(indexItems), "index");
     }
-    // 降级：文件系统扫描
+    // Fallback: filesystem scan
     const scanItems = await (0, exports.scanStoredArtifacts)(definitions, {
         pipelineIds: options?.pipelineIds,
         nodeIds: options?.nodeIds,
@@ -272,7 +272,7 @@ exports.listStoredArtifacts = listStoredArtifacts;
 const resolveArtifactFilePath = (definition, relativePath) => {
     const rootAbs = (0, node_path_1.resolve)(definition.artifactDir);
     const targetAbs = (0, node_path_1.resolve)(rootAbs, relativePath);
-    // 防止路径穿越，只允许读取当前流水线产物目录下文件。
+    // Prevent path traversal; only allow reading files within the current pipeline's artifact directory.
     if (targetAbs !== rootAbs && !targetAbs.startsWith(`${rootAbs}${node_path_1.sep}`))
         return null;
     return targetAbs;
@@ -293,7 +293,7 @@ const readStoredArtifactContent = async (definition, relativePath) => {
         parsed = null;
     }
     const parsedObj = toRecord(parsed);
-    // 优先按 kind 字段分发，无 kind 时回退到旧启发式判断（向后兼容）
+    // Prefer dispatching by kind field; fall back to the old heuristic when kind is absent (backward compatible)
     const kind = typeof parsedObj?.kind === "string" ? parsedObj.kind : null;
     const isEnvelope = kind === "envelope" || (!kind && parsedObj && "envelope" in parsedObj);
     const envelopeObj = isEnvelope ? toRecord(parsedObj?.envelope) : null;
@@ -307,7 +307,7 @@ const readStoredArtifactContent = async (definition, relativePath) => {
                 .map((item) => toRecord(item)?.content)
                 .filter((item) => item !== undefined);
             const logs = Array.isArray(envelopeObj.logs) ? envelopeObj.logs : [];
-            // envelope 预览返回 contents + logs，便于排错。
+            // envelope preview returns contents + logs for easier troubleshooting.
             return {
                 contents,
                 logs,
@@ -325,7 +325,7 @@ const readStoredArtifactContent = async (definition, relativePath) => {
 };
 exports.readStoredArtifactContent = readStoredArtifactContent;
 const exportStoredArtifactContents = async (definitions, options) => {
-    // 优先从索引选候选文件，减少全量 scan；索引缺失时 listStoredArtifacts 自动降级 scan
+    // Prefer index for candidate files to reduce full scan; listStoredArtifacts auto-falls-back to scan when index is missing
     const limit = Number.isFinite(options?.limit) ? Math.max(1, Math.trunc(options?.limit)) : 20000;
     const listResult = await (0, exports.listStoredArtifacts)(definitions, {
         pipelineIds: options?.pipelineIds,
@@ -357,8 +357,8 @@ const exportStoredArtifactContents = async (definitions, options) => {
             out[dateKey][pipelineKey] = {};
         if (!out[dateKey][pipelineKey][nodeKey])
             out[dateKey][pipelineKey][nodeKey] = [];
-        // 导出只保留产物内容，不包含 runId、文件名等元信息。
-        // 若 content 本身是数组，则展开写入，避免导出结果出现“数组套数组”。
+        // Export keeps only artifact content; no runId, filename or other metadata.
+        // If content is itself an array, flatten it to avoid "array inside array" in the export result.
         if (Array.isArray(content.content)) {
             out[dateKey][pipelineKey][nodeKey].push(...content.content);
         }

package/dist/src/cli/bootstrap.js

@@ -18,7 +18,7 @@ const normalizePipelineSelector = (selector) => {
 const requirePipelineId = (selector) => {
     if (selector.pipelineId)
         return selector.pipelineId;
-    // 内嵌 runtime service 只能通过 pipelineId 定位 pipeline 实例；runId/batchRunId 在此层仅用于二次匹配。
+    // The embedded runtime service can only locate a pipeline instance by pipelineId; runId/batchRunId at this layer is only used for secondary matching.
     throw new errors_1.CliError("Missing pipelineId for local runtime selector", {
         code: "INVALID_ARGUMENT",
         exitCode: 2,
@@ -64,7 +64,7 @@ const buildCliAppContext = (appContext) => {
             runPipeline: async (pipelineId) => writableServices.pipeline.runPipeline(pipelineId),
             retryNode: async (input) => writableServices.pipeline.retryNode(input),
             diagnoseNode: async (input) => {
-                const runtimeApiClient = (0, server_runtime_client_1.createPipelineRuntimeApiClient)();
+                const runtimeApiClient = (0, server_runtime_client_1.createPipelineRuntimeApiClientWs)();
                 return runtimeApiClient.diagnoseNode(input.pipelineId, input.nodeId, input.itemKey);
             },
             getOutput: async (pipelineId, runId) => writableServices.pipeline.getOutput(pipelineId, runId),
@@ -127,7 +127,7 @@ const buildCliAppContext = (appContext) => {
     };
 };
 const buildRuntimeApiOnlyContext = () => {
-    const runtimeApiClient = (0, server_runtime_client_1.createPipelineRuntimeApiClient)();
+    const runtimeApiClient = (0, server_runtime_client_1.createPipelineRuntimeApiClientWs)();
     const serverLifecycleClient = (0, server_runtime_client_1.createServerLifecycleClient)();
     const unsupported = async () => {
         throw new Error("unsupported_cli_runtime_api_context");
@@ -187,10 +187,10 @@ const createMainCliBootstrap = () => {
     return async ({ route }) => {
         const bootstrap = route.bootstrap;
         if (bootstrap?.runtimeApiOnly) {
-            // runtime-api only 路由必须复用 daemon 提供的 API 语义，避免误落到内嵌 service 路径。
+            // runtime-api-only routes must reuse the daemon-provided API semantics to avoid incorrectly falling to the embedded service path.
             if (bootstrap.ensureServerReady) {
                 const serverLifecycleClient = (0, server_runtime_client_1.createServerLifecycleClient)();
-                // 运行类命令必须先绑定到持久执行宿主，避免 CLI 临时进程误充当后台宿主。
+                // Run-class commands must bind to a persistent execution host first, to avoid the CLI temporary process inadvertently acting as the daemon host.
                 await serverLifecycleClient.ensureServerReady();
             }
             return {
@@ -207,12 +207,12 @@ const createMainCliBootstrap = () => {
             await appContext.gateway.connect();
         }
         else if (bootstrap?.gateway === "warmup") {
-            // 系统快照尽量尝试建链，失败时退回当前缓存状态，避免只读命令被完全阻断。
+            // For system snapshots, try connecting first; fall back to cached state on failure so read-only commands aren't completely blocked.
             try {
                 await appContext.gateway.connect();
             }
             catch {
-                // 保持只读命令可退化执行。
+                // Allow read-only commands to degrade gracefully.
             }
         }
         return {

package/dist/src/cli/commands/agent.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.agentRoutes = exports.agentSendCommand = exports.agentSessionCommand = exports.agentListCommand = void 0;
 const errors_1 = require("../errors");
+const i18n_1 = require("../i18n");
 const readFlagAsPositiveInteger = (value, fallback) => {
     if (typeof value !== "string")
         return fallback;
@@ -84,42 +85,42 @@ exports.agentRoutes = [
     {
         key: "agent.list",
         path: ["agent", "list"],
-        description: "输出智能体列表",
+        description: (0, i18n_1.t)("agent.list.description"),
         handler: exports.agentListCommand,
         bootstrap: { gateway: "required" },
         help: {
             usage: "taskmeld agent list [--format <json|md>]",
-            summary: "输出智能体列表",
+            summary: (0, i18n_1.t)("agent.list.summary"),
         },
     },
     {
         key: "agent.session",
         path: ["agent", "session"],
-        description: "输出会话列表（全部或按 agent 过滤）",
+        description: (0, i18n_1.t)("agent.session.description"),
         handler: exports.agentSessionCommand,
         bootstrap: { gateway: "required" },
         help: {
             usage: "taskmeld agent session [agentId] [--format <json|md>]",
-            summary: "输出会话列表（全部或按 agent 过滤）",
-            args: [{ name: "agentId", required: false, description: "按 Agent ID 过滤会话" }],
+            summary: (0, i18n_1.t)("agent.session.summary"),
+            args: [{ name: "agentId", required: false, description: (0, i18n_1.t)("agent.session.argAgentId") }],
         },
     },
     {
         key: "agent.send",
         path: ["agent", "send"],
-        description: "向指定 agent 会话发送消息",
+        description: (0, i18n_1.t)("agent.send.description"),
         handler: exports.agentSendCommand,
         bootstrap: { gateway: "required" },
         help: {
             usage: "taskmeld agent send <agentId> <message> [--session <id>] [--format <json|md>]",
-            summary: "向指定 agent 会话发送消息并等待回复",
+            summary: (0, i18n_1.t)("agent.send.summary"),
             args: [
-                { name: "agentId", required: true, description: "Agent ID" },
-                { name: "message", required: true, description: "消息内容" },
+                { name: "agentId", required: true, description: (0, i18n_1.t)("agent.send.argAgentId") },
+                { name: "message", required: true, description: (0, i18n_1.t)("agent.send.argMessage") },
             ],
             options: [
-                { flags: ["--session"], valueName: "id", description: "会话 ID（默认 main）" },
-                { flags: ["--stream"], description: "流式输出回复内容" },
+                { flags: ["--session"], valueName: "id", description: (0, i18n_1.t)("agent.send.optSession") },
+                { flags: ["--stream"], description: (0, i18n_1.t)("agent.send.optStream") },
             ],
         },
     },