@arcships/morula-runtime 0.1.0-alpha.2 → 0.1.0-alpha.3

package/bin/morula.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * 业务命令面发布入口：`morula` = Morula 业务 CLI（task / repo / comment / review / space / attachment / report）。
+ *
+ * 与 `morula-runtime` 同属 `@arcships/morula-runtime` 单包（docs/features/single-package-cli-distribution.md）：
+ * bin 指向本文件，本文件 import 构建产物 dist/morula.js（由 @morula/morula-cli 入口 bundle 而来）。
+ * 本地开发走 `pnpm dev:morula`（tsx 直接跑源码），不经过本文件。
+ */
+import '../dist/morula.js'

package/dist/index.js

@@ -1715,7 +1715,7 @@ function page(ok, message) {
 }
 
 // ../morula-cli-core/dist/build-env.js
-var BUILD_ID = "20260913141147.nogit";
+var BUILD_ID = "20260914094501.nogit";
 var BUILD_CONTEXTS = {
   "local": "http://localhost:8080/api",
   "test": "https://morula.basecastle.com/api",
@@ -2873,7 +2873,7 @@ function redactInputSummary(value) {
 }
 
 // src/build-env.ts
-var BUILD_VERSION2 = "0.1.0-alpha.2";
+var BUILD_VERSION2 = "0.1.0-alpha.3";
 
 // src/commands/daemon.ts
 import { existsSync as existsSync15, mkdirSync as mkdirSync11, readFileSync as readFileSync10, rmSync as rmSync7, writeFileSync as writeFileSync9 } from "node:fs";
@@ -3672,11 +3672,11 @@ var COLLABORATION_SKILL_SOURCE_MAP = `# morula-working-on-issues \u2014 \u5951\u
 
 | \u5951\u7EA6 | \u5B9E\u73B0 | \u4F4D\u7F6E |
 |------|------|------|
-| CLI \u8BFB\u8BC4\u8BBA | \`morula comment list --object <objectId>\` | \`apps/morula-cli/src/commands/comment.ts\` |
-| CLI \u5199\u8BC4\u8BBA\uFF08**\u5951\u7EA6\u7981\u6B62 agent \u81EA\u884C\u8C03\u7528**\uFF1A\u5B8C\u6210\u8BC4\u8BBA\u7531\u670D\u52A1\u7AEF\u7EDF\u4E00\u53D1\u9001\uFF0C\u89C1\u672C\u6587\u4EF6\u7B2C 5 \u6761\uFF09 | \`morula comment add\`\uFF08\u547D\u4EE4\u5B58\u5728\uFF0C\u4F46\u672C\u5951\u7EA6\u8981\u6C42\u4E0D\u8C03\u7528\uFF09 | \`apps/morula-cli/src/commands/comment.ts\` |
-| CLI \u4EFB\u52A1\u8BE6\u60C5\uFF08**\u65E0\u53C2**\u53D6\u672C\u4EFB\u52A1\uFF1B\u5E26\u53C2\u53D6\u4E1A\u52A1\u5BF9\u8C61\uFF09 | \`morula task get\` \u2192 \`GET /agent-tasks/:id\`\uFF1B\`morula task get <objectId>\` \u2192 \`GET /objects/:id\` | \`apps/morula-cli/src/commands/task.ts\` |
+| CLI \u8BFB\u8BC4\u8BBA | \`morula comment list --object <objectId>\` | \`packages/morula-cli/src/commands/comment.ts\` |
+| CLI \u5199\u8BC4\u8BBA\uFF08**\u5951\u7EA6\u7981\u6B62 agent \u81EA\u884C\u8C03\u7528**\uFF1A\u5B8C\u6210\u8BC4\u8BBA\u7531\u670D\u52A1\u7AEF\u7EDF\u4E00\u53D1\u9001\uFF0C\u89C1\u672C\u6587\u4EF6\u7B2C 5 \u6761\uFF09 | \`morula comment add\`\uFF08\u547D\u4EE4\u5B58\u5728\uFF0C\u4F46\u672C\u5951\u7EA6\u8981\u6C42\u4E0D\u8C03\u7528\uFF09 | \`packages/morula-cli/src/commands/comment.ts\` |
+| CLI \u4EFB\u52A1\u8BE6\u60C5\uFF08**\u65E0\u53C2**\u53D6\u672C\u4EFB\u52A1\uFF1B\u5E26\u53C2\u53D6\u4E1A\u52A1\u5BF9\u8C61\uFF09 | \`morula task get\` \u2192 \`GET /agent-tasks/:id\`\uFF1B\`morula task get <objectId>\` \u2192 \`GET /objects/:id\` | \`packages/morula-cli/src/commands/task.ts\` |
 | daemon \u6CE8\u5165\u51ED\u636E\uFF08agent \u65E0\u9700\u81EA\u884C\u767B\u5F55\uFF09 | runner \u6CE8\u5165 \`env\` \u7ED9 Provider \u5B50\u8FDB\u7A0B | \`packages/runtime/src/daemon/runner.ts\` |
-| \u7CFB\u7EDF\u63D0\u793A\u6CE8\u5165\uFF08\u9636\u6BB5\u804C\u8D23 / \u76EE\u6807 / \u4ED3\u5E93\u6E05\u5355 / \u5DE5\u5177\u6307\u5F15\uFF09\uFF1B\u4EFB\u52A1\u8BE6\u60C5\u7531 \`morula task get\`\uFF08\u65E0\u53C2\uFF09\u83B7\u53D6 | \`buildTaskPromptWithContract\`\uFF08\`runner.ts\`\uFF0C\u552F\u4E00\u8FDB dim \u7684 messages[0]\uFF09\uFF1BCLI \`apps/morula-cli/src/commands/task.ts\`\uFF08resolveTaskId \u2192 \`GET /agent-tasks/:id\`\uFF09 | \`packages/runtime/src/daemon/runner.ts\` |
+| \u7CFB\u7EDF\u63D0\u793A\u6CE8\u5165\uFF08\u9636\u6BB5\u804C\u8D23 / \u76EE\u6807 / \u4ED3\u5E93\u6E05\u5355 / \u5DE5\u5177\u6307\u5F15\uFF09\uFF1B\u4EFB\u52A1\u8BE6\u60C5\u7531 \`morula task get\`\uFF08\u65E0\u53C2\uFF09\u83B7\u53D6 | \`buildTaskPromptWithContract\`\uFF08\`runner.ts\`\uFF0C\u552F\u4E00\u8FDB dim \u7684 messages[0]\uFF09\uFF1BCLI \`packages/morula-cli/src/commands/task.ts\`\uFF08resolveTaskId \u2192 \`GET /agent-tasks/:id\`\uFF09 | \`packages/runtime/src/daemon/runner.ts\` |
 
 ## 3. \u6539\u4EE3\u7801\u9ED8\u8BA4\u4EA7 PR\uFF08\u5206\u652F\u7EAA\u5F8B\uFF0CAgent \u53D6\u540D\uFF09
 
@@ -3694,13 +3694,13 @@ var COLLABORATION_SKILL_SOURCE_MAP = `# morula-working-on-issues \u2014 \u5951\u
 | \u5951\u7EA6 | \u5B9E\u73B0 | \u4F4D\u7F6E |
 |------|------|------|
 | merge \u81EA\u52A8\u5173\u5355\uFF08\u670D\u52A1\u7AEF\u9A71\u52A8\u72B6\u6001\uFF09 | webhook merged \u2192 closeIntent \u2192 Object \u5B8C\u6210 | \`src/modules/vcs-integration/webhook/vcs-event.service.ts\` |
-| agent \u4E0D\u8C03 CLI \u6539\u72B6\u6001 | \u534F\u4F5C\u5951\u7EA6\u7B2C 4 \u6761\u3002**\u6CE8\u610F\uFF1ACLI \u6709 \`morula task state <id> --state <code>\`**\uFF08\u673A\u5668\u534F\u8BAE \`POST /agent-tasks/:id/state\`\uFF0C\u4F9B\u5E73\u53F0/\u81EA\u6D41\u8F6C\u4F7F\u7528\uFF09\u2014\u2014\u662F**\u5951\u7EA6\u8981\u6C42 agent \u4E0D\u8C03\u7528**\u5B83\uFF0C\u4E0D\u662F\u300CCLI \u6CA1\u6709\u8FD9\u4E2A\u547D\u4EE4\u300D | \`apps/morula-cli/src/commands/task.ts\`\uFF08action \`state\`\uFF09\u3001\`src/modules/agent-task/agent-task.controller.ts\`\uFF08\u7AEF\u70B9\uFF09 |
+| agent \u4E0D\u8C03 CLI \u6539\u72B6\u6001 | \u534F\u4F5C\u5951\u7EA6\u7B2C 4 \u6761\u3002**\u6CE8\u610F\uFF1ACLI \u6709 \`morula task state <id> --state <code>\`**\uFF08\u673A\u5668\u534F\u8BAE \`POST /agent-tasks/:id/state\`\uFF0C\u4F9B\u5E73\u53F0/\u81EA\u6D41\u8F6C\u4F7F\u7528\uFF09\u2014\u2014\u662F**\u5951\u7EA6\u8981\u6C42 agent \u4E0D\u8C03\u7528**\u5B83\uFF0C\u4E0D\u662F\u300CCLI \u6CA1\u6709\u8FD9\u4E2A\u547D\u4EE4\u300D | \`packages/morula-cli/src/commands/task.ts\`\uFF08action \`state\`\uFF09\u3001\`src/modules/agent-task/agent-task.controller.ts\`\uFF08\u7AEF\u70B9\uFF09 |
 
 ## 4.1 \u8BC4\u5BA1\u4EFB\u52A1\u7ED3\u8BBA\u56DE\u4F20\uFF08morula review submit\uFF09
 
 | \u5951\u7EA6 | \u5B9E\u73B0 | \u4F4D\u7F6E |
 |------|------|------|
-| \u8BC4\u5BA1\u7ED3\u8BBA\u673A\u5668\u534F\u8BAE\uFF08approved / changes_requested / commented\uFF0Cchanges_requested \u5FC5\u987B\u5E26 details\uFF09 | \`morula review submit <objectId> --verdict ... [--details] [--pr-number]\` \u2192 \`POST /agent-collaborations/review/submit\`\uFF08\u670D\u52A1\u7AEF\u6821\u9A8C\u8C03\u7528\u8005 = \u8BC4\u5BA1\u4EFB\u52A1\u540E\u843D\u5E93\u5E76\u9A71\u52A8\u56DE\u73AF\uFF09 | \`apps/morula-cli/src/commands/review.ts\`\u3001\`src/modules/agent-task/review-loop.service.ts\` |
+| \u8BC4\u5BA1\u7ED3\u8BBA\u673A\u5668\u534F\u8BAE\uFF08approved / changes_requested / commented\uFF0Cchanges_requested \u5FC5\u987B\u5E26 details\uFF09 | \`morula review submit <objectId> --verdict ... [--details] [--pr-number]\` \u2192 \`POST /agent-collaborations/review/submit\`\uFF08\u670D\u52A1\u7AEF\u6821\u9A8C\u8C03\u7528\u8005 = \u8BC4\u5BA1\u4EFB\u52A1\u540E\u843D\u5E93\u5E76\u9A71\u52A8\u56DE\u73AF\uFF09 | \`packages/morula-cli/src/commands/review.ts\`\u3001\`src/modules/agent-task/review-loop.service.ts\` |
 | \u8BC4\u5BA1\u5BF9\u8C61\uFF08objectId\uFF09\u7ECF AgentTask \u672C\u4F53\u4E0B\u53D1\uFF08\`morula task get\` \u65E0\u53C2\u8FD4\u56DE\uFF09 | AgentTask \u8BB0\u5F55 \`objectId\` \u5B57\u6BB5\uFF08enqueue \u65F6\u5199\u5165\uFF09 | \`src/modules/agent-task/review-loop.service.ts\` |
 
 ## 5. \u8BC4\u8BBA\u4EA4\u4ED8\u7EAA\u5F8B\uFF08\u4E00\u6761\u6700\u7EC8\u8BC4\u8BBA\uFF0C\u7ED3\u679C\u4E0A\u5E73\u53F0\uFF09
@@ -3792,19 +3792,33 @@ import { execFileSync as execFileSync4 } from "node:child_process";
 import { existsSync as existsSync5, mkdirSync as mkdirSync4 } from "node:fs";
 import { join as join8 } from "node:path";
 var GIT_CANDIDATE_DIRS = ["/usr/bin", "/usr/local/bin", "/opt/homebrew/bin", "/opt/local/bin"];
+function prependToPath(dirs) {
+  const cur = process.env.PATH ?? "";
+  const parts = new Set(cur.split(":").filter(Boolean));
+  const missing = dirs.filter((d) => !parts.has(d));
+  if (missing.length)
+    process.env.PATH = [...missing, cur].join(":");
+  return missing;
+}
 function ensureGitOnPath() {
   try {
     execFileSync4("git", ["--version"], { stdio: "pipe" });
     return;
   } catch {
   }
-  const cur = process.env.PATH ?? "";
-  const missing = GIT_CANDIDATE_DIRS.filter((d) => existsSync5(join8(d, "git")) && !cur.split(":").includes(d));
+  const missing = prependToPath(GIT_CANDIDATE_DIRS.filter((d) => existsSync5(join8(d, "git"))));
   if (missing.length) {
-    process.env.PATH = [...missing, cur].join(":");
     console.warn(`[daemon] PATH \u7F3A\u5C11 git\uFF0C\u5DF2\u8865\u5145: ${missing.join(", ")}`);
   }
 }
+function ensureNodeOnPath() {
+  const nodeDir = process.execPath ? join8(process.execPath, "..") : "";
+  const candidates = [nodeDir, "/usr/local/bin", "/opt/homebrew/bin"].filter((d) => d && existsSync5(join8(d, "node")));
+  const missing = prependToPath(candidates);
+  if (missing.length) {
+    console.warn(`[daemon] PATH \u7F3A\u5C11 node\uFF0C\u5DF2\u8865\u5145: ${missing.join(", ")}`);
+  }
+}
 function buildRepoEnv(token, baseUrl) {
   if (baseUrl) {
     const host = new URL(baseUrl).host;
@@ -4751,8 +4765,8 @@ var DimAgentAdapter = class {
     }
   }
   async probe() {
-    const { existsSync: existsSync16 } = await import("node:fs");
-    const installed = existsSync16(this.dimPath) || this.dimPath === "dim";
+    const { existsSync: existsSync17 } = await import("node:fs");
+    const installed = existsSync17(this.dimPath) || this.dimPath === "dim";
     let authStatus = installed ? "unknown" : "error";
     let lastProbeErrorCode = installed ? void 0 : "DIM_CLI_NOT_FOUND";
     let lastProbeError = installed ? void 0 : `\u672A\u627E\u5230 dim CLI\uFF08${this.dimPath}\uFF09`;
@@ -6164,7 +6178,7 @@ var DaemonWsClient = class {
       console.log(`[daemon] WS \u5DF2\u8FDE\u63A5\uFF08${(/* @__PURE__ */ new Date()).toISOString()}\uFF09`);
     });
     socket.on("agent-task:dispatched", (payload) => {
-      handlers.onTaskDispatched(payload.taskId);
+      handlers.onTaskDispatched(payload.taskId, payload.runtimeId);
     });
     socket.on("agent-task:status-changed", (payload) => {
       if (payload?.status === "cancelled" && payload.taskId) {
@@ -6359,6 +6373,7 @@ var DaemonRunner = class {
       return;
     this.running = true;
     ensureGitOnPath();
+    ensureNodeOnPath();
     {
       const cfg2 = loadDaemonConfig(this.store);
       try {
@@ -6440,8 +6455,8 @@ var DaemonRunner = class {
     this.repoCheckout?.setRuntimeId(registered.id);
     this.startHeartbeatTimer();
     this.ws.connect({
-      onTaskDispatched: (taskId) => {
-        void this.handleTask(taskId);
+      onTaskDispatched: (taskId, runtimeId) => {
+        this.onTaskDispatched(taskId, runtimeId);
       },
       // M1-A1：取消信号 → 中断执行中的 dim 进程
       onTaskCancelled: (taskId) => {
@@ -6782,6 +6797,20 @@ var DaemonRunner = class {
     }, Math.max(0, nextAt - Date.now()));
     this.outboxTimer.unref?.();
   }
+  /**
+   * 派发事件入口（P0-b，issues/agent-task-false-failure-on-daemon-fetch-error.md）：
+   * 服务端把派发事件发到 **tenant 房间**（daemon-executor.service.ts `sendToTenant`，WS 无 per-runtime
+   * 房间），同租户每台 daemon 都会收到，故**必须按 `runtimeId` 自过滤**——否则每台设备都会替每条任务
+   * 去 claim，任一台设备的一次网络抖动都会把归属设备正在跑的任务判失败（`POST /agent-tasks/:id/result`
+   * 不校验任务归属，见同 issue 根因 ③ / ④）。
+   *
+   * `runtimeId` 缺失（旧服务端）→ 保持旧行为不过滤；poll 兜底本就按 runtimeId 查询，不受影响。
+   */
+  onTaskDispatched(taskId, runtimeId) {
+    if (runtimeId && this.runtimeId && runtimeId !== this.runtimeId)
+      return;
+    void this.handleTask(taskId);
+  }
   /** 任务处理（幂等：已在处理中则跳过） */
   async handleTask(taskId) {
     if (this.processing.has(taskId))
@@ -6789,6 +6818,7 @@ var DaemonRunner = class {
     this.processing.add(taskId);
     const ctrl = new AbortController();
     this.cancels.set(taskId, ctrl);
+    let claimed = false;
     try {
       if (!this.runtimeId)
         return;
@@ -6797,6 +6827,7 @@ var DaemonRunner = class {
         this.log(`[daemon] \u4EFB\u52A1 ${taskId} \u9886\u53D6\u5931\u8D25: ${claim.code}`);
         return;
       }
+      claimed = true;
       await this.executeTask(taskId, ctrl.signal);
     } catch (error) {
       if (ctrl.signal.aborted) {
@@ -6804,6 +6835,10 @@ var DaemonRunner = class {
         return;
       }
       const message = error instanceof Error ? error.message : String(error);
+      if (!claimed) {
+        this.log(`[daemon] \u4EFB\u52A1 ${taskId} \u672A\u53D6\u5F97\u6267\u884C\u6743\uFF0C\u5FFD\u7565\u672C\u6B21\u5F02\u5E38\uFF08\u4E0D\u4E0A\u62A5\u5931\u8D25\uFF09: ${message}`);
+        return;
+      }
       this.log(`[daemon] \u4EFB\u52A1 ${taskId} \u5904\u7406\u5F02\u5E38: ${message}`);
       await this.submitResultReliable(taskId, { ok: false, error: message }).catch(() => {
       });
@@ -8278,10 +8313,128 @@ function parseMaxConcurrent(context) {
   return value;
 }
 
+// src/daemon/plugin-register.ts
+import { chmodSync as chmodSync3, cpSync, existsSync as existsSync16, mkdirSync as mkdirSync12, readdirSync as readdirSync4, readFileSync as readFileSync11, rmSync as rmSync8, statSync as statSync3, writeFileSync as writeFileSync10 } from "node:fs";
+import { homedir as homedir11 } from "node:os";
+import { dirname as dirname8, join as join19 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+var PLUGIN_NAME = "morula-cli";
+var MANIFEST_DIR_NAME = ".codex-plugin";
+function legacyAgentsPluginDir(home = homedir11()) {
+  return join19(home, ".agents", "plugins", PLUGIN_NAME);
+}
+function resolveDimcodeHome(env = process.env, home = homedir11()) {
+  const fromEnv = env.DIMCODE_HOME?.trim();
+  return fromEnv || join19(home, ".dimcode", "v2");
+}
+function defaultPluginsRoot(env = process.env, home = homedir11()) {
+  return join19(resolveDimcodeHome(env, home), "plugins");
+}
+function resolvePackagePaths(entryUrl) {
+  const distDir = dirname8(fileURLToPath2(entryUrl));
+  return {
+    packageRoot: dirname8(distDir),
+    distDir,
+    assetsDir: join19(distDir, "plugin")
+  };
+}
+function buildLauncherScript(opts) {
+  const entry = join19(opts.packageRoot, "dist", "morula.js");
+  return `#!/bin/sh
+# Morula \u4E1A\u52A1 CLI \u542F\u52A8\u5668\uFF08\u7531 \`morula-runtime setup\` \u751F\u6210\uFF1BNode \u5347\u7EA7\u540E\u91CD\u8DD1 setup \u5237\u65B0\uFF09\u3002
+# \u4E0D\u4F9D\u8D56\u8C03\u7528\u65B9 PATH \u91CC\u7684 node\uFF08agent \u6267\u884C\u73AF\u5883 PATH \u5E38\u88AB\u88C1\u526A\uFF09\uFF0C\u4EC5\u4F5C\u515C\u5E95\u3002
+NODE=${JSON.stringify(opts.nodePath)}
+[ -x "$NODE" ] || NODE="$(command -v node 2>/dev/null || true)"
+if [ -z "$NODE" ]; then
+  echo '{"code":"ERROR","message":"node not found; reinstall or re-run: morula-runtime setup"}' >&2
+  exit 127
+fi
+exec "$NODE" ${JSON.stringify(entry)} "$@"
+`;
+}
+function assetsReady(paths) {
+  return existsSync16(join19(paths.assetsDir, "plugin.json")) && existsSync16(join19(paths.assetsDir, "skills"));
+}
+function listSkillNames(assetsDir) {
+  const dir = join19(assetsDir, "skills");
+  if (!existsSync16(dir))
+    return [];
+  return readdirSync4(dir).filter((name) => {
+    try {
+      return statSync3(join19(dir, name)).isDirectory();
+    } catch {
+      return false;
+    }
+  }).sort();
+}
+function registerPlugin(opts) {
+  const { pluginsRoot, paths, version } = opts;
+  const nodePath = opts.nodePath ?? process.execPath;
+  const pluginDir = join19(pluginsRoot, PLUGIN_NAME);
+  if (!assetsReady(paths))
+    throw new Error(`plugin assets not found at ${paths.assetsDir}; run \`pnpm run build:dist\` (dev) or reinstall the package`);
+  const skillsSrc = join19(paths.assetsDir, "skills");
+  const skills = listSkillNames(paths.assetsDir);
+  const manifestDir = join19(pluginDir, MANIFEST_DIR_NAME);
+  mkdirSync12(manifestDir, { recursive: true });
+  const manifest = JSON.parse(readFileSync11(join19(paths.assetsDir, "plugin.json"), "utf8"));
+  writeFileSync10(join19(manifestDir, "plugin.json"), `${JSON.stringify({ ...manifest, version }, null, 2)}
+`);
+  const skillsDest = join19(pluginDir, "skills");
+  rmSync8(skillsDest, { recursive: true, force: true });
+  mkdirSync12(skillsDest, { recursive: true });
+  cpSync(skillsSrc, skillsDest, { recursive: true });
+  const binDir = join19(pluginDir, "bin");
+  mkdirSync12(binDir, { recursive: true });
+  const binPath = join19(binDir, "morula");
+  writeFileSync10(binPath, buildLauncherScript({ nodePath, packageRoot: paths.packageRoot }));
+  chmodSync3(binPath, 493);
+  const legacy = legacyAgentsPluginDir(opts.home);
+  return {
+    pluginDir,
+    binPath,
+    skills,
+    version,
+    node: nodePath,
+    legacyDir: existsSync16(join19(legacy, MANIFEST_DIR_NAME)) ? legacy : null
+  };
+}
+
+// src/commands/setup.ts
+var KNOWN_FLAGS = ["root", "help"];
+async function setupCommand(context) {
+  rejectUnknownFlags(context.parsed.flags, KNOWN_FLAGS);
+  if (context.parsed.action && context.parsed.action !== "setup")
+    throw usage("usage: morula-runtime setup [--root <dir>]", { hint: "morula-runtime setup --help" });
+  const rootOverride = flagString(context.parsed.flags, "root");
+  const pluginsRoot = rootOverride ?? defaultPluginsRoot(context.env);
+  const paths = resolvePackagePaths(import.meta.url);
+  let result;
+  try {
+    result = registerPlugin({ pluginsRoot, paths, version: BUILD_VERSION2 });
+  } catch (error) {
+    throw new CliError("ERROR", EXIT.OTHER, error instanceof Error ? error.message : String(error), false, {
+      hint: "\u6E90\u7801\u6A21\u5F0F\u8BF7\u5148 `pnpm --filter @arcships/morula-runtime run build:dist`\uFF1B\u5168\u5C40\u5B89\u88C5\u8BF7\u91CD\u88C5\u8BE5\u5305"
+    });
+  }
+  return {
+    ok: true,
+    pluginRoot: result.pluginDir,
+    version: result.version,
+    binPath: result.binPath,
+    skills: result.skills,
+    node: result.node,
+    legacyRoot: result.legacyDir,
+    ...result.legacyDir ? { hint: "\u68C0\u6D4B\u5230\u65E7\u7684\u540C\u540D\u63D2\u4EF6\u76EE\u5F55\uFF0C\u8BF7\u5220\u9664\u4EE5\u514D\u4E24\u4E2A\u63D2\u4EF6\u6839\u540C\u540D\u51B2\u7A81\uFF08Dim \u4F18\u5148\u547D\u4E2D <DIMCODE_HOME>/plugins\uFF09" } : {},
+    note: "Dim \u5728**\u65B0 session** \u624D\u4F1A\u91CD\u65B0\u626B\u63CF\u63D2\u4EF6\u6839\uFF1B\u5DF2\u5F00\u7740\u7684\u4F1A\u8BDD\u4E0D\u4F1A\u52A0\u8F7D\u65B0 skills\u3002"
+  };
+}
+
 // src/commands/registry-runtime.ts
 var COMMANDS = {
   auth: authCommand,
-  daemon: daemonCommand
+  daemon: daemonCommand,
+  setup: setupCommand
 };
 var EXIT_CODES = {
   0: "success",
@@ -8437,6 +8590,28 @@ var SPEC = {
       notes: [
         'exit code 0 = all checks passed (warn is ok); 1 = at least one check failed -> see checks[] to tell "found problems" from "command failed"'
       ]
+    },
+    {
+      resource: "setup",
+      summary: "materialize the Dim plugin directory (skills + bin launcher) for this package",
+      actions: [
+        {
+          action: "setup",
+          summary: "write <DIMCODE_HOME>/plugins/morula-cli (manifest + skills + bin/morula launcher); offline and idempotent",
+          flags: [
+            { name: "root", type: "string", valueHint: "<dir>", description: "plugins root to install into (default: $DIMCODE_HOME/plugins or ~/.dimcode/v2/plugins)" }
+          ],
+          examples: ["morula-runtime setup", "morula-runtime setup --root /tmp/plugins"],
+          writes: "local",
+          interactive: false,
+          idempotent: true,
+          emits: ["ok", "pluginRoot", "version", "binPath", "skills", "node", "legacyRoot"]
+        }
+      ],
+      notes: [
+        "canonical form is the bare `morula-runtime setup`; postinstall runs the same registration automatically",
+        "only writes <root>/morula-cli; never deletes other plugins or the legacy ~/.agents/plugins/morula-cli (reported as legacyRoot)"
+      ]
     }
   ]
 };