weaver-work-cli 0.1.28 → 0.1.31

package/dist/chunks/registry-2VLUAESA.js

@@ -0,0 +1,14 @@
+import { createRequire as __esbuildCreateRequire } from 'node:module';
+const require = __esbuildCreateRequire(import.meta.url);
+import {
+  getImOperation,
+  imOperationDefinitions
+} from "./chunk-QWY6PGL6.js";
+import "./chunk-YLCYX7LE.js";
+import "./chunk-ZEDWSH32.js";
+import "./chunk-LUSPKZKY.js";
+import "./chunk-BUSC6UAE.js";
+export {
+  getImOperation,
+  imOperationDefinitions
+};

package/dist/chunks/registry-JCFEYXOE.js

@@ -0,0 +1,18 @@
+import { createRequire as __esbuildCreateRequire } from 'node:module';
+const require = __esbuildCreateRequire(import.meta.url);
+import {
+  esbOperationDefinitions,
+  getEsbOperation,
+  hasEsbOperation
+} from "./chunk-6V7ZLF34.js";
+import "./chunk-R7O5PUWO.js";
+import "./chunk-GPMFD4RD.js";
+import "./chunk-H3WDBYJW.js";
+import "./chunk-324YPTC2.js";
+import "./chunk-LUSPKZKY.js";
+import "./chunk-BUSC6UAE.js";
+export {
+  esbOperationDefinitions,
+  getEsbOperation,
+  hasEsbOperation
+};

package/dist/chunks/registry-NYPYMZXG.js

@@ -0,0 +1,16 @@
+import { createRequire as __esbuildCreateRequire } from 'node:module';
+const require = __esbuildCreateRequire(import.meta.url);
+import {
+  getHrmOperation,
+  hasHrmOperation,
+  hrmOperationDefinitions
+} from "./chunk-G2JSIUWF.js";
+import "./chunk-NOODWMCL.js";
+import "./chunk-OOUTBLZ4.js";
+import "./chunk-LUSPKZKY.js";
+import "./chunk-BUSC6UAE.js";
+export {
+  getHrmOperation,
+  hasHrmOperation,
+  hrmOperationDefinitions
+};

package/dist/chunks/registry-Q7OQJ3SU.js

@@ -0,0 +1,19 @@
+import { createRequire as __esbuildCreateRequire } from 'node:module';
+const require = __esbuildCreateRequire(import.meta.url);
+import {
+  getWorkflowOperation,
+  hasWorkflowOperation,
+  workflowOperationDefinitions
+} from "./chunk-2DUV44UX.js";
+import "./chunk-EZALDOQH.js";
+import "./chunk-FMPJJYYI.js";
+import "./chunk-EG6ZU444.js";
+import "./chunk-AJ62BGAW.js";
+import "./chunk-324YPTC2.js";
+import "./chunk-LUSPKZKY.js";
+import "./chunk-BUSC6UAE.js";
+export {
+  getWorkflowOperation,
+  hasWorkflowOperation,
+  workflowOperationDefinitions
+};

package/dist/chunks/registry-ZJMJVWFA.js

@@ -0,0 +1,19 @@
+import { createRequire as __esbuildCreateRequire } from 'node:module';
+const require = __esbuildCreateRequire(import.meta.url);
+import {
+  getMeetingOperation,
+  hasMeetingOperation,
+  meetingOperationDefinitions
+} from "./chunk-RCGYCOMG.js";
+import "./chunk-VZTXRG6X.js";
+import "./chunk-AC7KJWC5.js";
+import "./chunk-CVZ2JOSW.js";
+import "./chunk-GCG2NMWR.js";
+import "./chunk-H6XSTSLM.js";
+import "./chunk-LUSPKZKY.js";
+import "./chunk-BUSC6UAE.js";
+export {
+  getMeetingOperation,
+  hasMeetingOperation,
+  meetingOperationDefinitions
+};

package/dist/chunks/room-recommend-UR4ZDZS6.js

@@ -0,0 +1,20 @@
+import { createRequire as __esbuildCreateRequire } from 'node:module';
+const require = __esbuildCreateRequire(import.meta.url);
+import {
+  ebRoomRecommendOperation,
+  loadFrequentRooms,
+  loadRooms,
+  recommendRooms,
+  rememberFrequentRoom
+} from "./chunk-AC7KJWC5.js";
+import "./chunk-CVZ2JOSW.js";
+import "./chunk-H6XSTSLM.js";
+import "./chunk-LUSPKZKY.js";
+import "./chunk-BUSC6UAE.js";
+export {
+  ebRoomRecommendOperation,
+  loadFrequentRooms,
+  loadRooms,
+  recommendRooms,
+  rememberFrequentRoom
+};

package/dist/chunks/schedule-5L2PM4M6.js

@@ -0,0 +1,24 @@
+import { createRequire as __esbuildCreateRequire } from 'node:module';
+const require = __esbuildCreateRequire(import.meta.url);
+import {
+  applyMessageDetails,
+  buildScheduleFreeResult,
+  meetingEbScheduleOperations,
+  parseScheduleConflictMessage,
+  resolveMeetingScheduleTypeIds,
+  resolveMemberIdsByName,
+  runScheduleConflictFlow
+} from "./chunk-VZTXRG6X.js";
+import "./chunk-CVZ2JOSW.js";
+import "./chunk-H6XSTSLM.js";
+import "./chunk-LUSPKZKY.js";
+import "./chunk-BUSC6UAE.js";
+export {
+  applyMessageDetails,
+  buildScheduleFreeResult,
+  meetingEbScheduleOperations,
+  parseScheduleConflictMessage,
+  resolveMeetingScheduleTypeIds,
+  resolveMemberIdsByName,
+  runScheduleConflictFlow
+};

package/dist/chunks/state-Y2XBP6YE.js

@@ -0,0 +1,15 @@
+import { createRequire as __esbuildCreateRequire } from 'node:module';
+const require = __esbuildCreateRequire(import.meta.url);
+import {
+  refsDir,
+  refsIndexPath,
+  stateDir,
+  stateRoot
+} from "./chunk-AJ62BGAW.js";
+import "./chunk-BUSC6UAE.js";
+export {
+  refsDir,
+  refsIndexPath,
+  stateDir,
+  stateRoot
+};

package/dist/chunks/workflow-TR6PG2SL.js

@@ -0,0 +1,245 @@
+import { createRequire as __esbuildCreateRequire } from 'node:module';
+const require = __esbuildCreateRequire(import.meta.url);
+import {
+  createWorkflowHost
+} from "./chunk-65QMVWHS.js";
+import {
+  asObject,
+  assertNoForbiddenKeys,
+  compactStdoutPaths,
+  getWorkflowOperation,
+  workflowOperationDefinitions,
+  workflowSuccess
+} from "./chunk-2DUV44UX.js";
+import {
+  createWorkflowContinuationSigner
+} from "./chunk-EZALDOQH.js";
+import {
+  CLARIFICATION_SUBTYPE,
+  WorkflowCliError,
+  workflowValidationError
+} from "./chunk-FMPJJYYI.js";
+import "./chunk-EG6ZU444.js";
+import "./chunk-AJ62BGAW.js";
+import "./chunk-H3WDBYJW.js";
+import "./chunk-324YPTC2.js";
+import {
+  isCliError,
+  toErrorEnvelope
+} from "./chunk-LUSPKZKY.js";
+import "./chunk-BUSC6UAE.js";
+
+// src/shortcuts/workflow/index.ts
+import { readFile } from "node:fs/promises";
+
+// src/shortcuts/workflow/manifest.ts
+var WITHHELD = [];
+function buildOperations() {
+  return workflowOperationDefinitions().map((definition) => ({
+    name: definition.name,
+    resource: definition.resource,
+    summary: definition.summary,
+    ...definition.capability ? { capability: definition.capability } : {},
+    risk: definition.risk,
+    ...definition.requiresConfirmation ? { requiresConfirmation: true } : {},
+    inputSchema: definition.inputSchema
+  }));
+}
+var workflowManifest = {
+  schemaVersion: 1,
+  name: "workflow",
+  title: "\u6CDB\u5FAEE10\u6D41\u7A0B\u667A\u80FD\u52A9\u624B\uFF08\u67E5\u8BE2/\u67E5\u770B/\u64CD\u4F5C/\u6279\u91CF/\u53D1\u8D77/\u4FEE\u6539\uFF09",
+  version: "0.1.0",
+  host: "e10-workflow",
+  status: "builtin",
+  sourceSkill: "weaver-e10-workflow",
+  capabilities: ["workflow"],
+  operations: buildOperations(),
+  withheldOperations: WITHHELD
+};
+
+// src/shortcuts/workflow/operations.ts
+function idempotentReplayEnvelope(error, operation) {
+  if (!(error instanceof WorkflowCliError) || error.subtype !== "continuation_already_applied") return null;
+  const details = error.details ?? {};
+  const finishedAt = Number(details.finishedAt);
+  const onlyCommitted = details.stage === "committed" && details.result == null;
+  const previous = typeof details.operation === "string" && details.operation ? details.operation : operation;
+  const hasPrepare = /Apply$/u.test(previous);
+  const retryHint = hasPrepare ? "\u4E0D\u8981\u91CD\u8DD1 Prepare\uFF0C\u4E5F\u4E0D\u8981\u518D\u6B21\u63D0\u4EA4" : "\u4E0D\u8981\u91CD\u590D\u63D0\u4EA4\u540C\u4E00\u6279 requestId";
+  return workflowSuccess(operation, {
+    status: "ALREADY_APPLIED",
+    operation: previous,
+    requestId: typeof details.requestId === "string" && details.requestId ? details.requestId : null,
+    confirmedAt: Number.isFinite(finishedAt) ? new Date(finishedAt).toISOString() : null,
+    previousResult: details.result ?? null,
+    note: onlyCommitted ? `\u8BE5 continuation \u5BF9\u5E94\u7684\u4E0A\u4E00\u6B21\u6267\u884C\u5DF2\u7ECF\u5199\u5165\u6210\u529F\uFF08\u670D\u52A1\u7AEF\u5DF2\u8FD4\u56DE\u6210\u529F\u56DE\u6267\uFF0C\u53EA\u662F\u6CA1\u6765\u5F97\u53CA\u5199\u56DE\u672C\u5730\u7ED3\u679C\uFF09\uFF0C\u672C\u6B21\u672A\u91CD\u590D\u6267\u884C\u2014\u2014${retryHint}\uFF1B\u76EE\u6807\u6D41\u7A0B\u6309\u4E0A\u9762\u7684 requestId \u67E5\u5373\u53EF\u3002` : `\u8BE5 continuation \u5DF2\u7ECF\u6267\u884C\u8FC7\u4E14\u5DF2\u6210\u529F\uFF0C\u672C\u6B21\u672A\u91CD\u590D\u5199\u5165\uFF08\u5E42\u7B49\u56DE\u62A5\uFF09\u2014\u2014${retryHint}\u3002`
+  });
+}
+function clarificationEnvelope(error, operation) {
+  if (!(error instanceof WorkflowCliError) || error.subtype !== CLARIFICATION_SUBTYPE) return null;
+  const details = error.details ?? {};
+  const candidates = Array.isArray(details.candidates) ? details.candidates : [];
+  const question = typeof details.clarificationQuestion === "string" && details.clarificationQuestion ? details.clarificationQuestion : error.message;
+  const reason = typeof details.clarificationReason === "string" ? details.clarificationReason : "";
+  return workflowSuccess(operation, {
+    type: "workflowClarification",
+    status: "NEEDS_CLARIFICATION",
+    clarificationType: details.clarificationType ?? null,
+    clarificationKeyword: details.clarificationKeyword ?? null,
+    clarificationQuestion: question,
+    ...reason ? { clarificationReason: reason } : {},
+    candidates,
+    candidateCount: candidates.length,
+    note: clarificationNote(reason, candidates.length)
+  });
+}
+function clarificationNote(reason, candidateCount) {
+  const base = "\u8FD9\u4E0D\u662F\u5931\u8D25\uFF0C\u4E5F**\u4E0D\u4EE3\u8868\u67E5\u8BE2\u5DF2\u6267\u884C**\uFF1A\u672C\u6B21\u67E5\u8BE2\u5DF2\u505C\u6B62\uFF0C\u6CA1\u6709\u8FD4\u56DE\u4EFB\u4F55\u6D41\u7A0B\u6570\u636E\u3002";
+  if (reason === "workflow_not_exist") {
+    return base + '\u8BF7\u5982\u5B9E\u544A\u77E5\u7528\u6237\uFF1A\u8BE5\u5DE5\u4F5C\u6D41\u4E0D\u5B58\u5728\uFF08\u53EF\u80FD\u5DF2\u5220\u9664\u6216\u88AB\u505C\u7528\uFF09\uFF0C\u8BF7\u7528\u6237\u6539\u7528\u8BE5\u6D41\u7A0B\u7684\u5B8C\u6574\u540D\u79F0\uFF08\u6216\u5176\u5B83\u53EF\u7528\u4E8E\u68C0\u7D22\u7684\u5173\u952E\u8BCD\uFF09\u91CD\u65B0\u6307\u5B9A\u2014\u2014**\u4E0D\u8981\u5411\u7528\u6237\u7D22\u53D6 ID**\u3002**\u4E0D\u8981**\u8BF4\u6210"\u6CA1\u6709\u53EF\u53D1\u8D77\u7684\u5DE5\u4F5C\u6D41"\u8FD9\u7C7B\u6A21\u7CCA\u8BF4\u6CD5\u2014\u2014\u95EE\u9898\u5C31\u51FA\u5728\u8FD9\u4E2A\u76EE\u6807\u4E0A\u3002';
+  }
+  if (reason === "no_create_right") {
+    return base + '\u8BF7\u5982\u5B9E\u544A\u77E5\u7528\u6237\uFF1A\u8BE5\u6D41\u7A0B**\u5B58\u5728**\uFF0C\u4F46\u5F53\u524D\u8D26\u53F7**\u6CA1\u6709\u53D1\u8D77\u6743\u9650**\u3002**\u5FC5\u987B\u660E\u786E\u8BF4\u51FA\u300C\u5B58\u5728\u4F46\u6CA1\u6709\u53D1\u8D77\u6743\u9650\u300D**\uFF0C\u7EDD\u4E0D\u80FD\u8F6C\u8FF0\u6210"\u6D41\u7A0B\u4E0D\u5B58\u5728"\uFF1B\u5E76\u7ED9\u51FA\u4E0B\u4E00\u6B65\uFF1A\u6539\u7528\u5176\u4ED6\u53EF\u53D1\u8D77\u7684\u6D41\u7A0B\uFF0C\u6216\u8054\u7CFB\u7BA1\u7406\u5458\u4E3A\u8BE5\u6D41\u7A0B\u6388\u4E88\u53D1\u8D77\u6743\u9650\u3002';
+  }
+  return base + "\u8BF7\u628A\u6F84\u6E05\u95EE\u9898\u4E0E\u5019\u9009**\u539F\u6837**\u4EA4\u7ED9\u7528\u6237\u786E\u8BA4\uFF08\u9010\u6761\u5217\u51FA\u5019\u9009\u540D\u79F0\uFF09\uFF0C\u62FF\u5230\u786E\u8BA4\u540E\u7531\u4F60\u6309\u300C\u540D\u79F0(ID)\u300D\u628A ID \u62FC\u597D\u3001\u91CD\u53D1\u540C\u4E00\u6761\u547D\u4EE4\u2014\u2014**\u53EA\u95EE\u7528\u6237\u8BE5\u5BF9\u8C61\u7684\u5B8C\u6574\u540D\u79F0\u6216\u5176\u5B83\u53EF\u7528\u4E8E\u68C0\u7D22\u7684\u5173\u952E\u8BCD\uFF0C\u4E0D\u8981\u5411\u7528\u6237\u7D22\u53D6 ID**\u3002**\u4E0D\u8981**\u628A\u672C\u6B21\u7ED3\u679C\u8F6C\u8FF0\u6210\u300C\u6CA1\u6709\u5339\u914D\u7684\u6D41\u7A0B\u300D\u300C\u67E5\u8BE2\u7ED3\u679C\u4E3A 0 \u6761\u300D\u6216\u81EA\u884C\u6311\u4E00\u4E2A\u5019\u9009\u7EE7\u7EED\u67E5\u3002" + (candidateCount === 0 ? "\u5F53\u524D\u6CA1\u6709\u4EFB\u4F55\u5019\u9009\u2014\u2014\u8BF7\u8BA9\u7528\u6237\u7ED9\u51FA\u8BE5\u5BF9\u8C61\u7684\u5B8C\u6574\u540D\u79F0\uFF08\u6216\u7EA0\u6B63\u540D\u79F0\u91CC\u7684\u9519\u522B\u5B57\u3001\u6362\u5176\u5B83\u53EF\u7528\u4E8E\u68C0\u7D22\u7684\u5173\u952E\u8BCD\uFF09\u540E\u91CD\u53D1\u3002" : "");
+}
+async function settleAppliedContinuation(input, result, context, definition) {
+  if (definition.risk !== "high-risk-write") return;
+  const raw = typeof input.continuation === "string" ? input.continuation : typeof input.context === "string" ? input.context : "";
+  const reference = raw.trim();
+  if (!reference) return;
+  await context.continuation.settle(reference, result.data, definition.action || definition.name);
+}
+async function executeWorkflowOperation(operation, rawInput, context) {
+  const definition = getWorkflowOperation(operation);
+  const input = asObject(rawInput);
+  assertNoForbiddenKeys(input);
+  let result;
+  try {
+    result = await definition.handler(input, context);
+  } catch (error) {
+    const clarified = clarificationEnvelope(error, operation);
+    if (clarified) return clarified;
+    const replayed = idempotentReplayEnvelope(error, operation);
+    if (replayed) return replayed;
+    throw error;
+  }
+  await settleAppliedContinuation(input, result, context, definition);
+  return result;
+}
+
+// src/shortcuts/workflow/index.ts
+function asOptions(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+function stripBom(value) {
+  return value.replace(/^\uFEFF+/u, "");
+}
+async function inputFrom(options, extra = {}) {
+  const opts = asOptions(options);
+  if (opts.input && opts.inputJson) {
+    throw workflowValidationError("input_conflict", "\u4E0D\u80FD\u540C\u65F6\u4F20 --input \u548C --input-json");
+  }
+  let input = {};
+  if (opts.inputJson) {
+    input = parseJsonInput(String(opts.inputJson), "--input-json");
+  }
+  if (opts.input) {
+    let raw;
+    try {
+      raw = stripBom(opts.input === "-" ? await readStdin() : await readFile(String(opts.input), "utf8"));
+    } catch {
+      throw workflowValidationError("input_unreadable", `\u65E0\u6CD5\u8BFB\u53D6 --input\uFF1A${String(opts.input)}`);
+    }
+    input = parseJsonInput(raw, "--input");
+  }
+  return {
+    ...input,
+    ...Object.fromEntries(Object.entries(extra).filter(([, value]) => value !== void 0 && value !== ""))
+  };
+}
+function parseJsonInput(raw, label) {
+  try {
+    const parsed = JSON.parse(stripBom(raw));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new Error("input must be an object");
+    }
+    return parsed;
+  } catch {
+    throw workflowValidationError("input_invalid", `${label} \u4E0D\u662F\u5408\u6CD5 JSON \u5BF9\u8C61`);
+  }
+}
+function successEnvelope(operation, result) {
+  return {
+    schemaVersion: 1,
+    ok: true,
+    operation,
+    data: result.data === void 0 ? null : result.data,
+    ...result.meta ? { meta: result.meta } : {},
+    warnings: []
+  };
+}
+function failureEnvelope(error) {
+  const structured = error;
+  return {
+    schemaVersion: 1,
+    ok: false,
+    ...structured?.partialData === void 0 ? {} : { data: structured.partialData },
+    error: toErrorEnvelope(error)
+  };
+}
+function printWorkflowResult(ctx, operation, result) {
+  ctx.output.write(successEnvelope(operation, result), {
+    json: true,
+    compactPaths: compactStdoutPaths(operation),
+    // todoSmartConvert 的业务契约要求直接返回完整 requestDatas/displayItems；
+    // 禁止公共输出层按 24KB 预算递归折叠该分支（2026-10-27 用户要求，勿删）。
+    persist: operation !== "workflow.todoSmartConvert"
+  });
+}
+async function executeAndPrint(ctx, operation, input) {
+  try {
+    const result = await executeWorkflowOperation(operation, input, {
+      ctx,
+      host: createWorkflowHost(ctx),
+      continuation: createWorkflowContinuationSigner(ctx)
+    });
+    printWorkflowResult(ctx, operation, result);
+  } catch (error) {
+    console.error(JSON.stringify(failureEnvelope(error), null, 2));
+    process.exitCode = isCliError(error) ? error.exitCode : 1 /* GeneralError */;
+  }
+}
+function withJsonInputOptions(command) {
+  command.option("--input <path>", "JSON input file, or - for stdin").option("--input-json <json>", "inline JSON input object");
+  return command;
+}
+var workflowShortcut = {
+  name: "workflow",
+  description: "\u6CDB\u5FAEE10\u6D41\u7A0B\u667A\u80FD\u52A9\u624B CLI\uFF08\u67E5\u8BE2/\u67E5\u770B/\u64CD\u4F5C/\u6279\u91CF/\u53D1\u8D77/\u4FEE\u6539\uFF09",
+  category: "shortcut",
+  register({ program, action }) {
+    const workflow = program.command("workflow").description("\u6CDB\u5FAEE10\u6D41\u7A0B\u667A\u80FD\u52A9\u624B\uFF08\u5F85\u529E/\u5DF2\u529E/\u6211\u53D1\u8D77/\u5168\u90E8\u3001\u8BE6\u60C5\u3001\u64CD\u4F5C\u3001\u6279\u91CF\u3001\u53D1\u8D77\u3001\u4FEE\u6539\uFF09");
+    workflow.command("schema").description("Print workflow operation manifest for agents").action(action((ctx) => {
+      ctx.output.write(workflowManifest, { json: true });
+    }));
+    withJsonInputOptions(workflow.command("run").description("Run a workflow operation with JSON input").argument("<operation>", "operation name, e.g. workflow.search")).action(action(async (ctx, operation, options) => {
+      await executeAndPrint(ctx, String(operation), await inputFrom(options));
+    }));
+  }
+};
+export {
+  compactStdoutPaths,
+  inputFrom,
+  printWorkflowResult,
+  successEnvelope,
+  workflowShortcut
+};

package/dist/cmd/argv.js

@@ -0,0 +1,45 @@
+/**
+ * 会吃掉下一个 token 作为值的**全局**选项（与 `cmd/root.ts` 里 `program.option(...)` 一一对应）。
+ *
+ * `--is-connector [value]` 故意不算在内：它的值是可选的，宁可把后面的 token 当成命令名
+ * （多加载一个 shortcut 只是慢一点），也不要把它自己的值误当成命令名（那会少加载）。
+ */
+export const VALUE_TAKING_GLOBAL_OPTIONS = new Set([
+    '--config',
+    '--auth',
+    '--profile',
+    '--runtime-agent',
+    '--base-url',
+    '--passport-url',
+]);
+/**
+ * 取 argv 里**第一个位置参数**（= 最可能的顶层命令名），跳过所有 `-` 开头的选项。
+ *
+ * 注意：这个函数**只用于决定"要加载哪个 shortcut 实现"**，不参与真正的参数解析
+ * （真正的解析仍然全权交给 commander）。所以猜错的后果只有"多加载/少加载"，
+ * 少加载那一种由 `lazy-dispatch.ts` 的重放兜住。
+ */
+export function firstPositionalToken(argv) {
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === undefined)
+            return undefined;
+        if (token === '--')
+            return argv[index + 1];
+        if (token.startsWith('-')) {
+            if (VALUE_TAKING_GLOBAL_OPTIONS.has(token))
+                index += 1;
+            continue;
+        }
+        return token;
+    }
+    return undefined;
+}
+/** 命令对象 → `ctx.commands` 里的元数据（`commands list` 就靠它）。 */
+export function toCommandMetadata(commands) {
+    return commands.map((command) => ({
+        name: command.name,
+        description: command.description,
+        category: command.category,
+    }));
+}

package/dist/cmd/docs/index.js

@@ -1,9 +1,9 @@
 import { cpSync, existsSync, readdirSync, readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { CliError } from '../../core/errors.js';
-const DOCS_DIR = fileURLToPath(new URL('../../../docs/', import.meta.url));
-const PKG_JSON_URL = new URL('../../../package.json', import.meta.url);
+import { packageFileUrl, packagePath } from '../../core/package-paths.js';
+const DOCS_DIR = packagePath('docs');
+const PKG_JSON_URL = packageFileUrl('package.json');
 function packageVersion() {
     try {
         return JSON.parse(readFileSync(PKG_JSON_URL, 'utf-8')).version;

package/dist/cmd/lazy-dispatch.js

@@ -0,0 +1,20 @@
+import { builtinCommands } from './index.js';
+import { registerCommands } from './register.js';
+import { createProgram } from './root.js';
+import { toCommandMetadata } from './argv.js';
+/**
+ * 懒加载兜底：把 argv 原样交给**一套新建的 program**，并把真实命令树注册上去重放一次。
+ *
+ * 只在一种情况下会走到这里：`src/index.ts` 的 argv 预判没猜中要跑哪个 shortcut
+ * （宿主用了我们没见过的参数形式），于是记录表里注册的**占位命令**接住了这条命令。
+ * 重放保证行为与「全量静态注册」时完全一致，代价是这一次多走一遍 commander。
+ */
+export async function dispatchLazyShortcut(definition, metadata, argv = process.argv) {
+    const { program, ctx } = createProgram();
+    const command = await definition.load();
+    await registerCommands(program, ctx, [...builtinCommands, command]);
+    // `commands list` 要看到的是**全部**命令，而不是本次真实注册的那几个 —— 元数据是静态的，直接补齐。
+    ctx.commands = toCommandMetadata([...builtinCommands, ...metadata]);
+    ctx.modules = ctx.commands;
+    await program.parseAsync(argv);
+}

package/dist/cmd/root.js

@@ -1,13 +1,11 @@
 import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { Command } from 'commander';
 import { createCliContext } from '../core/context.js';
 import { HookManager } from '../core/hooks.js';
+import { packagePath } from '../core/package-paths.js';
 const CLI_COMMAND_NAME = 'weaver-work-cli';
 function readPackageInfo() {
-    const __dirname = dirname(fileURLToPath(import.meta.url));
-    const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+    const pkg = JSON.parse(readFileSync(packagePath('package.json'), 'utf-8'));
     return {
         name: pkg.name || CLI_COMMAND_NAME,
         version: pkg.version || '0.0.0',

package/dist/cmd/setup/index.js

@@ -1,9 +1,9 @@
 import { existsSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
 import { CliError, ExitCode } from '../../core/errors.js';
+import { packagePath } from '../../core/package-paths.js';
 import { findAuthFile } from '../../internal/e10/auth/session.js';
 import { installPackagedSkills, resolvePackagedSkillNames, resolveSkillsRoot, resolveSkillsTargetPath, unresolvedSkillsRootMessage, } from '../../internal/skills/install.js';
-const SKILLS_DIR = fileURLToPath(new URL('../../../skills/', import.meta.url));
+const SKILLS_DIR = packagePath('skills');
 function versionMajor(version) {
     return Number(version.replace(/^v/, '').split('.')[0] || 0);
 }

package/dist/cmd/skills/index.js

@@ -1,11 +1,11 @@
 import { existsSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
 import { CliError, ExitCode } from '../../core/errors.js';
+import { packagePath } from '../../core/package-paths.js';
 import { resolveDetectorInfo } from '../../internal/skills/detector.js';
 import { installPackagedSkills, resolveSkillsRoot, resolveSkillsTargetPath, unresolvedSkillsRootMessage, } from '../../internal/skills/install.js';
 import { SkillReader } from '../../internal/skills/reader.js';
-const SKILLS_DIR = fileURLToPath(new URL('../../../skills/', import.meta.url));
+const SKILLS_DIR = packagePath('skills');
 function reader() {
     if (!existsSync(SKILLS_DIR)) {
         throw new CliError('skills directory does not exist: ' + SKILLS_DIR);

package/dist/core/package-paths.js

@@ -0,0 +1,47 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+/**
+ * 包根目录（含 package.json 的那一层）。
+ *
+ * 为什么不用 `new URL('../../..', import.meta.url)`：那条路径把「源码在 dist 下的相对深度」
+ * 写死了。2026-10-28 引入打包产物（B 方案，esbuild 打出 dist/index.js + 若干 chunk）之后，
+ * 同一个模块可能来自 `dist/cmd/docs/index.js`（深层），也可能被内联进 `dist/index.js`（浅层），
+ * 相对深度不再成立。改成从**入口脚本**往上找第一个 package.json，两种布局都对。
+ *
+ * 注意取 `process.argv[1]` 优先：它是"用户实际执行的那个文件"，比 import.meta.url 更接近真相；
+ * 找不到时（`node -e`、被当成库 import）再退回本模块所在目录，最后兜底 cwd。
+ */
+let cachedRoot;
+export function packageRootDir() {
+    if (cachedRoot)
+        return cachedRoot;
+    const seeds = [];
+    const entry = process.argv[1];
+    if (entry)
+        seeds.push(dirname(resolve(entry)));
+    seeds.push(dirname(fileURLToPath(import.meta.url)));
+    for (const seed of seeds) {
+        let dir = seed;
+        for (let depth = 0; depth < 10; depth += 1) {
+            if (existsSync(join(dir, 'package.json'))) {
+                cachedRoot = dir;
+                return dir;
+            }
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    cachedRoot = process.cwd();
+    return cachedRoot;
+}
+/** 包内相对路径 → 绝对路径。 */
+export function packagePath(...segments) {
+    return join(packageRootDir(), ...segments);
+}
+/** 包内相对路径 → file:// URL（给 `readFileSync` 这类接受 URL 的 API 用）。 */
+export function packageFileUrl(...segments) {
+    return pathToFileURL(packagePath(...segments));
+}