taskmeld 0.1.1 → 0.1.41

package/dist/src/cli/locales/en.json

@@ -0,0 +1,244 @@
+{
+    "help": {
+        "usage": "taskmeld <resource> <action> [args] [--flags]",
+        "groups": {
+            "agent": "Agent management",
+            "artifact": "Artifact management",
+            "init": "First-time setup",
+            "pipeline": "Pipeline management",
+            "scheduler": "Scheduler control",
+            "server": "Server management",
+            "system": "System info"
+        },
+        "commonOptions": {
+            "title": "Common Options:",
+            "format": "Output format (default: md)",
+            "envelope": "Only available with --format json, outputs full envelope wrapper",
+            "help": "Show help for current command"
+        },
+        "tips": {
+            "title": "Tips:",
+            "groupHelp": "View group-level help",
+            "commandHelp": "View command-level help"
+        },
+        "label": {
+            "required": "Required",
+            "optional": "Optional"
+        }
+    },
+    "init": {
+        "firstTimeSetup": "First-time Setup",
+        "greeting": "Configure your OpenClaw Gateway connection to get started.",
+        "configSavedTo": "Config  {{path}}",
+        "languageLabel": "Language",
+        "gatewayUrlLabel": "Gateway URL",
+        "gatewayUrlHint": "ws:// or wss:// address of your OpenClaw Gateway",
+        "gatewayTokenLabel": "Gateway Token",
+        "gatewayTokenHint": "Authentication token for the Gateway",
+        "success": "Gateway configured successfully",
+        "nextStep": "Run \"taskmeld server start\" to begin.",
+        "urlLabel": "URL",
+        "description": "Guided setup for OpenClaw Gateway connection",
+        "usage": "taskmeld init [--url <url>] [--token <token>]",
+        "summary": "Guided first-time setup — configure the OpenClaw Gateway connection.",
+        "optUrlDesc": "Gateway WebSocket URL (ws:// or wss://)",
+        "optTokenDesc": "Gateway authentication token",
+        "example1": "taskmeld init",
+        "example2": "taskmeld init --url ws://127.0.0.1:18789 --token your-token",
+        "note1": "Running without flags starts an interactive guided setup.",
+        "note2": "Config is saved to ~/.taskmeld/config.json.",
+        "note3": "Environment variables (OPENCLAW_GATEWAY_URL/TOKEN) take precedence over this config."
+    },
+    "agent": {
+        "list": {
+            "description": "List agents",
+            "summary": "List agents"
+        },
+        "session": {
+            "description": "List sessions (all or filtered by agent)",
+            "summary": "List sessions (all or filtered by agent)",
+            "argAgentId": "Filter sessions by Agent ID"
+        },
+        "send": {
+            "description": "Send message to agent session",
+            "summary": "Send message to agent session and wait for reply",
+            "argAgentId": "Agent ID",
+            "argMessage": "Message content",
+            "optSession": "Session ID (default: main)",
+            "optStream": "Stream reply content"
+        }
+    },
+    "artifact": {
+        "index": {
+            "description": "Rebuild artifact index",
+            "summary": "Scan artifact directory and rebuild index.jsonl, used to include historical files after upgrade or fix index inconsistency",
+            "argRebuild": "Rebuild index.jsonl",
+            "optPipeline": "Only rebuild for specified pipeline"
+        },
+        "list": {
+            "description": "List artifacts",
+            "summary": "List artifacts with status/type/batch/cursor pagination support",
+            "optPipeline": "Filter by pipeline",
+            "optNode": "Filter by node",
+            "optBatch": "Filter by batch run ID",
+            "optRun": "Filter by run ID",
+            "optCursor": "Pagination cursor"
+        },
+        "show": {
+            "description": "Show artifact content",
+            "summary": "Show content of specified artifact",
+            "argPipelineId": "Pipeline ID",
+            "argRelativePath": "Artifact relative path"
+        },
+        "export": {
+            "description": "Export artifact content",
+            "summary": "Export artifacts as date->pipeline->node three-level JSON",
+            "optPipeline": "Filter by pipeline",
+            "optNode": "Filter by node",
+            "optBatch": "Filter by batch run ID",
+            "optFrom": "Start date YYYY-MM-DD",
+            "optTo": "End date YYYY-MM-DD",
+            "optLimit": "Max export count, default 20000"
+        },
+        "cleanup": {
+            "description": "Clean up old artifacts",
+            "summary": "Clean up old artifact files, default dry-run shows candidates without deleting, pass --confirm to execute real deletion and rebuild index",
+            "argPipelineId": "Pipeline ID",
+            "optOlderThan": "Retention days, default success=30/failed=90/rejected=90",
+            "optConfirm": "Must be explicitly passed to execute real deletion, otherwise dry-run",
+            "dryRunMessage": "Dry-run mode, candidate files will not be deleted. Pass --confirm to execute real deletion."
+        }
+    },
+    "pipeline": {
+        "list": {
+            "description": "List pipelines",
+            "summary": "List pipelines"
+        },
+        "get": {
+            "description": "Show pipeline details",
+            "summary": "Show pipeline details",
+            "argId": "Pipeline ID"
+        },
+        "start": {
+            "description": "Start a pipeline run (completion not guaranteed)",
+            "summary": "Start a pipeline run (completion not guaranteed)",
+            "argPipelineId": "Pipeline ID",
+            "optWatch": "Continue waiting for run completion after start",
+            "optTimeout": "Watch timeout in ms, default 600000",
+            "optInterval": "Watch polling interval in ms, default 1200",
+            "noteOnlyStart": "start only initiates the run request, does not guarantee completion when the command returns.",
+            "noteWatch": "--watch enters the wait flow after a successful start."
+        },
+        "status": {
+            "description": "Show current pipeline run status",
+            "summary": "Show current pipeline run status",
+            "argPipelineId": "Compatibility entry, query current run by pipeline ID",
+            "optRunId": "Query by specific run ID",
+            "optBatchRunId": "Query by specific batch run ID",
+            "noteNeedSelector": "At least one of <pipelineId>, --run-id, --batch-run-id must be provided.",
+            "noteDefaultQuery": "When no selector is provided, defaults to querying current active run by pipelineId."
+        },
+        "watch": {
+            "description": "Watch pipeline until completion or timeout",
+            "summary": "Watch pipeline until completion or timeout",
+            "argPipelineId": "Compatibility entry, watch current run of this pipeline",
+            "optRunId": "Watch by specific run ID",
+            "optBatchRunId": "Watch by specific batch run ID",
+            "optTimeout": "Watch timeout in ms, default 600000",
+            "optInterval": "Watch polling interval in ms, default 1200",
+            "noteIsWatch": "watch is a monitoring command, it does not start new runs.",
+            "noteNeedSelector": "At least one of <pipelineId>, --run-id, --batch-run-id must be provided.",
+            "notePollingFallback": "Current watch semantics prioritize event streams with polling as fallback."
+        },
+        "stop": {
+            "description": "Stop pipeline batch run",
+            "summary": "Stop pipeline batch run",
+            "argPipelineId": "Compatibility entry, stop current run of this pipeline",
+            "optRunId": "Stop by specific run ID",
+            "optBatchRunId": "Stop by specific batch run ID",
+            "noteNeedSelector": "At least one of <pipelineId>, --run-id, --batch-run-id must be provided.",
+            "noteBatchOnly": "Currently stop is mainly used for stopping batch runs.",
+            "noteNonBatch": "Non-batch runs will return a business error instead of silent success."
+        },
+        "retryNode": {
+            "description": "Retry a node or node item",
+            "summary": "Retry a node or node item",
+            "argPipelineId": "Pipeline ID",
+            "argNodeId": "Node ID",
+            "optItem": "Specify the item key to retry"
+        },
+        "diagnose": {
+            "description": "Diagnose node dependency status, output blocking reason",
+            "summary": "Diagnose node dependency status, output blocking reason",
+            "argPipelineId": "Pipeline ID",
+            "argNodeId": "Node ID",
+            "optItem": "Optional, specify item key for precise diagnosis"
+        },
+        "result": {
+            "description": "Show pipeline run results",
+            "summary": "Show artifact content of each node after pipeline run",
+            "argPipelineId": "Pipeline ID",
+            "optNode": "Filter to specific node",
+            "optLogs": "Also show processing logs",
+            "optFormat": "Output format, default md"
+        },
+        "output": {
+            "description": "Query pipeline final output",
+            "summary": "Query pipeline final output",
+            "argPipelineId": "Pipeline ID",
+            "optRun": "Query by specific run ID"
+        },
+        "linkList": {
+            "description": "List all pipeline dispatch links",
+            "summary": "List all pipeline dispatch links"
+        },
+        "queue": {
+            "description": "Query pipeline inbound queue",
+            "summary": "Query pipeline inbound queue",
+            "argPipelineId": "Pipeline ID"
+        }
+    },
+    "scheduler": {
+        "toggle": {
+            "description": "Enable or disable scheduler",
+            "summary": "Enable or disable scheduler",
+            "argPipelineId": "Pipeline ID",
+            "optEnabled": "Whether to enable scheduler",
+            "note": "Both <pipelineId> and --enabled are required."
+        },
+        "mode": {
+            "description": "Switch scheduler mode",
+            "summary": "Switch scheduler mode",
+            "argPipelineId": "Pipeline ID",
+            "optMode": "Scheduler mode",
+            "note": "Both <pipelineId> and --mode are required."
+        }
+    },
+    "server": {
+        "ensure": {
+            "description": "Ensure local control-plane backend is started and healthy",
+            "summary": "Ensure local control-plane daemon is started and healthy",
+            "noteDaemonFirst": "Daemon-first semantics: prefer reusing an existing healthy local instance.",
+            "noteNewDaemon": "Only starts a new daemon when no reusable healthy instance is available."
+        },
+        "start": {
+            "description": "Explicitly start local control-plane backend",
+            "summary": "Explicitly start local control-plane daemon"
+        },
+        "status": {
+            "description": "Show local control-plane backend status",
+            "summary": "View local control-plane daemon health, ownership and pid info",
+            "note": "Status output is used to confirm whether local daemon is reusable and current owner metadata is consistent."
+        },
+        "stop": {
+            "description": "Stop local control-plane backend",
+            "summary": "Stop local control-plane daemon"
+        }
+    },
+    "system": {
+        "snapshot": {
+            "description": "Show system global snapshot",
+            "summary": "Show system global snapshot"
+        }
+    }
+}

package/dist/src/cli/locales/zh.json

@@ -0,0 +1,244 @@
+{
+    "help": {
+        "usage": "taskmeld <resource> <action> [args] [--flags]",
+        "groups": {
+            "agent": "智能体管理",
+            "artifact": "产物管理",
+            "init": "首次配置",
+            "pipeline": "流水线管理",
+            "scheduler": "调度控制",
+            "server": "后端服务管理",
+            "system": "系统信息"
+        },
+        "commonOptions": {
+            "title": "通用选项:",
+            "format": "输出格式（默认: md）",
+            "envelope": "仅与 --format json 搭配可用，输出完整包装层",
+            "help": "显示当前命令帮助"
+        },
+        "tips": {
+            "title": "提示:",
+            "groupHelp": "查看一级命令帮助",
+            "commandHelp": "查看二级命令帮助"
+        },
+        "label": {
+            "required": "必填",
+            "optional": "可选"
+        }
+    },
+    "init": {
+        "firstTimeSetup": "首次配置",
+        "greeting": "配置您的 OpenClaw Gateway 连接以开始使用。",
+        "configSavedTo": "配置  {{path}}",
+        "languageLabel": "语言",
+        "gatewayUrlLabel": "Gateway URL",
+        "gatewayUrlHint": "OpenClaw Gateway 的 ws:// 或 wss:// 地址",
+        "gatewayTokenLabel": "Gateway Token",
+        "gatewayTokenHint": "Gateway 认证令牌",
+        "success": "Gateway 配置成功",
+        "nextStep": "运行 \"taskmeld server start\" 以开始使用。",
+        "urlLabel": "URL",
+        "description": "OpenClaw Gateway 连接引导设置",
+        "usage": "taskmeld init [--url <url>] [--token <token>]",
+        "summary": "引导式首次配置 — 设置 OpenClaw Gateway 连接。",
+        "optUrlDesc": "Gateway WebSocket URL（ws:// 或 wss://）",
+        "optTokenDesc": "Gateway 认证令牌",
+        "example1": "taskmeld init",
+        "example2": "taskmeld init --url ws://127.0.0.1:18789 --token your-token",
+        "note1": "不带参数运行时启动交互式引导设置。",
+        "note2": "配置保存在 ~/.taskmeld/config.json。",
+        "note3": "环境变量（OPENCLAW_GATEWAY_URL/TOKEN）的优先级高于此配置。"
+    },
+    "agent": {
+        "list": {
+            "description": "输出智能体列表",
+            "summary": "输出智能体列表"
+        },
+        "session": {
+            "description": "输出会话列表（全部或按 agent 过滤）",
+            "summary": "输出会话列表（全部或按 agent 过滤）",
+            "argAgentId": "按 Agent ID 过滤会话"
+        },
+        "send": {
+            "description": "向指定 agent 会话发送消息",
+            "summary": "向指定 agent 会话发送消息并等待回复",
+            "argAgentId": "Agent ID",
+            "argMessage": "消息内容",
+            "optSession": "会话 ID（默认 main）",
+            "optStream": "流式输出回复内容"
+        }
+    },
+    "artifact": {
+        "index": {
+            "description": "重建产物索引",
+            "summary": "扫描产物目录并重建 index.jsonl，用于升级后纳入历史文件或修复索引不一致",
+            "argRebuild": "重建 index.jsonl",
+            "optPipeline": "只重建指定流水线"
+        },
+        "list": {
+            "description": "输出产物列表",
+            "summary": "输出产物列表，支持状态/类型/批跑/游标分页",
+            "optPipeline": "按流水线过滤",
+            "optNode": "按节点过滤",
+            "optBatch": "按批跑ID过滤",
+            "optRun": "按运行RunId过滤",
+            "optCursor": "分页游标"
+        },
+        "show": {
+            "description": "输出产物内容",
+            "summary": "输出指定产物的文件内容",
+            "argPipelineId": "流水线 ID",
+            "argRelativePath": "产物相对路径"
+        },
+        "export": {
+            "description": "导出产物内容",
+            "summary": "导出产物内容为 日期->流水线->节点 三层JSON",
+            "optPipeline": "按流水线过滤",
+            "optNode": "按节点过滤",
+            "optBatch": "按批跑ID过滤",
+            "optFrom": "开始日期 YYYY-MM-DD",
+            "optTo": "结束日期 YYYY-MM-DD",
+            "optLimit": "最大导出条数，默认20000"
+        },
+        "cleanup": {
+            "description": "清理旧产物",
+            "summary": "清理旧产物文件，默认 dry-run 只展示候选不删除，传 --confirm 执行真实删除并重建索引",
+            "argPipelineId": "流水线 ID",
+            "optOlderThan": "保留天数，默认 success=30/failed=90/rejected=90",
+            "optConfirm": "必须显式传入才执行真实删除，否则 dry-run",
+            "dryRunMessage": "dry-run 模式，候选文件不会删除。传入 --confirm 执行真实删除。"
+        }
+    },
+    "pipeline": {
+        "list": {
+            "description": "输出流水线列表",
+            "summary": "输出流水线列表"
+        },
+        "get": {
+            "description": "输出指定流水线详情",
+            "summary": "输出指定流水线详情",
+            "argId": "流水线 ID"
+        },
+        "start": {
+            "description": "发起指定流水线运行（不承诺已完成）",
+            "summary": "发起指定流水线运行（不承诺已完成）",
+            "argPipelineId": "流水线 ID",
+            "optWatch": "启动后继续等待运行完成",
+            "optTimeout": "watch 超时时间，默认 600000",
+            "optInterval": "watch 轮询间隔，默认 1200",
+            "noteOnlyStart": "start 只负责发起运行请求，不承诺命令返回时业务已执行完成。",
+            "noteWatch": "--watch 会在发起成功后进入等待流程。"
+        },
+        "status": {
+            "description": "输出指定流水线当前运行状态",
+            "summary": "输出指定流水线当前运行状态",
+            "argPipelineId": "兼容入口，按流水线 ID 查询当前运行",
+            "optRunId": "按单次运行 ID 精确查询",
+            "optBatchRunId": "按批跑 ID 精确查询",
+            "noteNeedSelector": "需要至少提供 <pipelineId>、--run-id、--batch-run-id 之一。",
+            "noteDefaultQuery": "未提供 selector 时，默认按 pipelineId 查询当前活动运行。"
+        },
+        "watch": {
+            "description": "监听指定流水线直到结束或超时",
+            "summary": "监听指定流水线直到结束或超时",
+            "argPipelineId": "兼容入口，监听该流水线当前运行",
+            "optRunId": "按单次运行 ID 精确监听",
+            "optBatchRunId": "按批跑 ID 精确监听",
+            "optTimeout": "watch 超时时间，默认 600000",
+            "optInterval": "watch 轮询间隔，默认 1200",
+            "noteIsWatch": "watch 是监听命令，不负责发起新运行。",
+            "noteNeedSelector": "需要至少提供 <pipelineId>、--run-id、--batch-run-id 之一。",
+            "notePollingFallback": "当前 watch 语义为事件流优先，轮询作为兜底路径。"
+        },
+        "stop": {
+            "description": "停止指定流水线批跑任务",
+            "summary": "停止指定流水线批跑任务",
+            "argPipelineId": "兼容入口，停止该流水线当前运行",
+            "optRunId": "按单次运行 ID 精确停止",
+            "optBatchRunId": "按批跑 ID 精确停止",
+            "noteNeedSelector": "需要至少提供 <pipelineId>、--run-id、--batch-run-id 之一。",
+            "noteBatchOnly": "当前 stop 主要用于停止批跑任务。",
+            "noteNonBatch": "对非批跑运行会返回业务错误，而不是静默成功。"
+        },
+        "retryNode": {
+            "description": "重试指定节点或节点条目",
+            "summary": "重试指定节点或节点条目",
+            "argPipelineId": "流水线 ID",
+            "argNodeId": "节点 ID",
+            "optItem": "指定重试的条目键"
+        },
+        "diagnose": {
+            "description": "诊断指定节点依赖状态，输出阻塞原因",
+            "summary": "诊断指定节点依赖状态，输出阻塞原因",
+            "argPipelineId": "流水线 ID",
+            "argNodeId": "节点 ID",
+            "optItem": "可选，指定条目键精确诊断"
+        },
+        "result": {
+            "description": "输出流水线运行结果",
+            "summary": "输出流水线运行后各节点的产物内容",
+            "argPipelineId": "流水线 ID",
+            "optNode": "过滤到指定节点",
+            "optLogs": "同时展示处理日志",
+            "optFormat": "输出格式，默认 md"
+        },
+        "output": {
+            "description": "查询流水线最终产物",
+            "summary": "查询流水线最终产物",
+            "argPipelineId": "流水线 ID",
+            "optRun": "按 runId 精确查询"
+        },
+        "linkList": {
+            "description": "列出所有流水线投递链接",
+            "summary": "列出所有流水线投递链接"
+        },
+        "queue": {
+            "description": "查询流水线接收队列",
+            "summary": "查询流水线接收队列",
+            "argPipelineId": "流水线 ID"
+        }
+    },
+    "scheduler": {
+        "toggle": {
+            "description": "启用或停用调度器",
+            "summary": "启用或停用调度器",
+            "argPipelineId": "流水线 ID",
+            "optEnabled": "是否启用调度器",
+            "note": "<pipelineId> 与 --enabled 均为必填控制项。"
+        },
+        "mode": {
+            "description": "切换调度器模式",
+            "summary": "切换调度器模式",
+            "argPipelineId": "流水线 ID",
+            "optMode": "调度器模式",
+            "note": "<pipelineId> 与 --mode 均为必填控制项。"
+        }
+    },
+    "server": {
+        "ensure": {
+            "description": "确保本地控制面后端已启动并健康",
+            "summary": "确保本地 control-plane daemon 已启动并健康",
+            "noteDaemonFirst": "daemon-first 语义：优先复用已存在且健康的本地实例。",
+            "noteNewDaemon": "仅在没有可复用健康实例时，才会启动新的 daemon。"
+        },
+        "start": {
+            "description": "显式启动本地控制面后端",
+            "summary": "显式启动本地 control-plane daemon"
+        },
+        "status": {
+            "description": "输出本地控制面后端状态",
+            "summary": "查看本地 control-plane daemon 的健康、ownership 与 pid 信息",
+            "note": "状态输出用于确认本地 daemon 是否可复用以及当前 owner 元数据是否一致。"
+        },
+        "stop": {
+            "description": "停止本地控制面后端",
+            "summary": "停止本地 control-plane daemon"
+        }
+    },
+    "system": {
+        "snapshot": {
+            "description": "输出系统全局快照",
+            "summary": "输出系统全局快照"
+        }
+    }
+}

package/dist/src/cli/output.js

@@ -2,17 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeHelp = exports.writeError = exports.writeResult = void 0;
 const renderers_1 = require("./renderers");
-// 成功输出由 renderer 统一分发，命令层不直接拼接文本。
+// Success output is dispatched uniformly by the renderer; command layer does not assemble text directly.
 const writeResult = (stream, command, data, global) => {
     stream.write(`${(0, renderers_1.renderSuccessByMode)(command, data, global)}\n`);
 };
 exports.writeResult = writeResult;
-// 错误统一写 stderr，避免污染 stdout 结果流。
+// Errors are consistently written to stderr to avoid polluting the stdout result stream.
 const writeError = (stream, error, command, global) => {
     stream.write(`${(0, renderers_1.renderErrorByMode)(command, error, global)}\n`);
 };
 exports.writeError = writeError;
-// 帮助信息输出纯文本到 stdout，便于人类直接阅读。
+// Help info is output as plain text to stdout for easy human reading.
 const writeHelp = (stream, helpText) => {
     stream.write(`${helpText}\n`);
 };

package/dist/src/cli/renderers/engine/markdown.js

@@ -86,7 +86,7 @@ const formatMarkdown = (ir) => {
             lines.push(...renderTable(headers, stringRows));
         }
         else {
-            // custom: 直接拼入
+            // custom: concatenate directly
             lines.push(...section.lines);
         }
     }

package/dist/src/cli/renderers/specs/index.js

@@ -8,7 +8,7 @@ const pipeline_1 = require("./pipeline");
 const scheduler_1 = require("./scheduler");
 const server_1 = require("./server");
 const system_1 = require("./system");
-// 按模块聚合输出定义，避免继续把所有结构堆回单一 renderer 文件。
+// Aggregate output definitions by module to avoid dumping all structures back into a single renderer file.
 const allSpecs = {
     ...agent_1.agentRenderSpecs,
     ...artifact_1.artifactRenderSpecs,

package/dist/src/cli/router.js

@@ -44,7 +44,7 @@ const serverCommands = __importStar(require("./commands/server"));
 const systemCommands = __importStar(require("./commands/system"));
 const help_1 = require("./help");
 const collectRoutesFromModule = (moduleExports) => {
-    // 只聚合命令模块导出的 *Routes，router 不再内联维护路由定义。
+    // Only aggregate *Routes exports from command modules; the router no longer inlines route definitions.
     return Object.entries(moduleExports)
         .filter(([exportName, value]) => exportName.endsWith("Routes") && Array.isArray(value))
         .flatMap(([, value]) => value);