@my-life-buddies/cli 0.17.7 → 0.18.1

package/dist/bin/core.js

@@ -450,6 +450,9 @@ function alive(pid) {
     return error2.code !== "ESRCH";
   }
 }
+function runtimeAlive(pid) {
+  return alive(pid) || alive(-pid);
+}
 function validPid(pid) {
   return Number.isSafeInteger(pid) && pid > 0;
 }
@@ -462,7 +465,7 @@ async function acquireProcessLock(options) {
   const path = join4(root, key);
   const ownerName = `owner-${randomUUID()}.json`;
   const candidate = join4(root, `.pending-${randomUUID()}`);
-  const owner = { pid: process.pid };
+  const owner = { ...options.ownerData, pid: process.pid };
   await mkdir3(root, { recursive: true, mode: 448 });
   await mkdir3(candidate, { mode: 448 });
   await writeFile3(join4(candidate, ownerName), JSON.stringify(owner), { mode: 384, flag: "wx" });
@@ -492,7 +495,7 @@ async function acquireProcessLock(options) {
         if (code(error2) === "ENOENT") continue;
         throw options.busyError();
       }
-      if (!validPid(previous.pid) || previous.runtimePid !== void 0 && !validPid(previous.runtimePid) || alive(previous.pid) || previous.runtimePid !== void 0 && alive(previous.runtimePid)) throw options.busyError();
+      if (!validPid(previous.pid) || previous.runtimePid !== void 0 && !validPid(previous.runtimePid) || alive(previous.pid) || previous.runtimePid !== void 0 && runtimeAlive(previous.runtimePid)) throw options.busyError();
       try {
         await unlink(previousPath);
       } catch (error2) {
@@ -513,7 +516,7 @@ async function acquireProcessLock(options) {
       if (!validPid(pid)) throw new TypeError("Runtime PID is invalid");
       const temporary = join4(root, `.update-${randomUUID()}`);
       try {
-        await writeFile3(temporary, JSON.stringify({ ...owner, runtimePid: pid }), { mode: 384, flag: "wx" });
+        await writeFile3(temporary, JSON.stringify({ ...owner, ...await options.runtimeData?.(pid), runtimePid: pid }), { mode: 384, flag: "wx" });
         await rename3(temporary, join4(path, ownerName));
       } finally {
         await unlink(temporary).catch(() => void 0);
@@ -879,8 +882,9 @@ const model = ${JSON.stringify(model)};
  * Import tools from ./tools/ and hooks from ./hooks/, then register them below.
  * Shared business code can live in ./services/; directories do not enable capabilities.
  * Use conversation.memory / dataAccess / widget / resource / proactive for platform capabilities.
- * Add conversation.tools.data_access_query / data_access_request / data_access_read_result
- * to initialState.tools for model-driven data access; declarations come from data-access.json.requirements.
+ * Add conversation.tools.data_access_query / data_access_request to initialState.tools.
+ * Declare every required dataset, including device.location / device.calendar, in data-access.json.requirements.
+ * Query first; if notGranted, request({ datasets, reason }), wait for the user, then query again.
  * Add conversation.tools.ask_question for multiple-choice questions.
  * Add conversation.tools.resource_list / resource_read to discover and read reference material.
  * Place widget assets in ../widgets/<type-id>/index.html and schema.json.
@@ -1775,7 +1779,8 @@ import { lstat as lstat14 } from "node:fs/promises";
 import { resolve as resolve7 } from "node:path";
 var DATASETS_COMMAND_HELP = `\u7528\u6CD5: buddy-cli datasets [--directory <\u9879\u76EE\u76EE\u5F55>] [--json]
 \u59CB\u7EC8\u8054\u7F51\u67E5\u8BE2\u516C\u5171 npm \u6700\u65B0 Runtime\uFF0C\u8BFB\u53D6\u5E76\u7F13\u5B58\u5176 DATA_ACCESS_CAPABILITIES\u3002
-\u65E0\u9700\u767B\u5F55\u642D\u642D\u8D26\u53F7\u3002\u5C06\u6240\u9009 id \u4E0E\u7528\u9014 purpose \u5199\u5165 data-access.json.requirements\uFF1B\u76EE\u5F55\u4E0D\u4EE3\u8868\u7528\u6237\u5DF2\u6388\u6743\u3002`;
+\u65E0\u9700\u767B\u5F55\u642D\u642D\u8D26\u53F7\u3002\u5C06\u6240\u9009 id \u4E0E\u7528\u9014 purpose \u5199\u5165 data-access.json.requirements\uFF1B\u4F4D\u7F6E device.location \u548C\u65E5\u5386 device.calendar \u4E5F\u9700\u8981\u58F0\u660E\u3002
+\u76EE\u5F55\u4E0D\u4EE3\u8868\u7528\u6237\u5DF2\u6388\u6743\u3002\u4F7F\u7528 data_access_query \u67E5\u8BE2\uFF0C\u672A\u6388\u6743\u65F6\u4EE5 datasets\u3001reason \u8BF7\u6C42\u6388\u6743\uFF0C\u7528\u6237\u5904\u7406\u540E\u518D\u6B21\u67E5\u8BE2\u3002`;
 async function runDatasetsCommand(args, io, cwd, options = {}) {
   try {
     if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
@@ -2119,7 +2124,7 @@ ${KNOWLEDGE_HELP}`);
 }
 
 // packages/cli-core/src/index.ts
-import { join as join21, resolve as resolve18 } from "node:path";
+import { join as join22, resolve as resolve18 } from "node:path";
 
 // packages/cli-core/src/init/creator.ts
 import { createHash as createHash3, randomUUID as randomUUID6 } from "node:crypto";
@@ -2600,6 +2605,10 @@ Creator \u8DEF\u7EBF\u987B\u7B49\u56DB\u518C\u3001\u5C0F\u6302\u4EF6\u6E05\u5355
 
 ${KNOWLEDGE_GUIDE}
 
+### \u672C\u5730\u8C03\u8BD5\u7684\u9000\u51FA\u548C\u6E05\u7406
+
+\u901A\u8FC7 \`buddy-cli preview\` \u8FDE\u63A5\u540E\u53F0\uFF0C\u9875\u9762\u542F\u52A8 DEV \u540E\u624D\u8FD0\u884C Runtime\u3002\u540E\u53F0\u590D\u5236\u7684\u6307\u4EE4\u5E26 \`--no-open\`\uFF0C\u6267\u884C\u540E\u8FD4\u56DE\u539F\u9875\u9762\uFF1B\u4E0D\u8981\u518D\u5F00\u4E00\u4E2A\u9884\u89C8\u8FDB\u7A0B\u3002\u6B63\u5E38\u505C\u6B62\u7528\u9875\u9762\u300C\u505C\u6B62 DEV\u300D\u6216 \`buddy-cli dev stop\`\uFF0C\u540E\u8005\u65E0\u9700\u8054\u7F51\u66F4\u65B0\u6216\u767B\u5F55\uFF0C\u53EA\u505C\u6B62\u5F53\u524D\u5E73\u53F0\u3001\u5F53\u524D\u642D\u5B50\u7684\u672C\u5730 Runtime \u548C\u76D1\u542C\uFF0C\u4E0D\u81EA\u52A8\u91CD\u8FDE\u6216\u91CD\u542F\u3002\u5173\u95ED\u7EC8\u7AEF\u3001Ctrl+C \u6216 SIGTERM \u4F1A\u505C\u6B62 CLI \u7BA1\u7406\u7684 Runtime \u5E76\u65AD\u5F00\u3002\u82E5\u6B8B\u7559\u5360\u7528\uFF0C\u540E\u53F0\u53EF\u300C\u5F3A\u5236\u65AD\u8FDE\u300D\uFF1B\u9875\u9762\u672A\u786E\u8BA4\u672C\u673A\u505C\u6B62\u65F6\uFF0C\u5728\u539F\u7535\u8111\u3001\u539F\u5DE5\u7A0B\u76EE\u5F55\u6267\u884C\u5176\u505C\u6B62\u6307\u4EE4\u3002\u4E0D\u8981\u624B\u5DE5\u5220\u9501\u6587\u4EF6\uFF0C\u4E0D\u8981\u6279\u91CF\u6740\u6B7B node\uFF1B\u8EAB\u4EFD\u6821\u9A8C\u5931\u8D25\u65F6\u5148\u6838\u5BF9\u5DE5\u7A0B\u548C\u539F\u8FDB\u7A0B\u3002\u8FD9\u4E9B\u64CD\u4F5C\u4E0D\u4F1A\u63D0\u5BA1\u6216\u53D1\u5E03\u3002
+
 ### \u6309\u9700\u6C42\u68C0\u67E5\u9700\u8981\u54EA\u4E9B\u80FD\u529B
 
 \u4E0B\u9762\u662F Coding Agent \u7684\u5B9E\u73B0\u68C0\u67E5\u8868\uFF0C\u4E0D\u662F\u4EA4\u7ED9\u5F00\u53D1\u8005\u9010\u9879\u9009\u62E9\u7684\u95EE\u5377\u3002\u53EA\u5B9E\u73B0\u9700\u6C42\u7528\u5F97\u4E0A\u7684\u80FD\u529B\uFF1B\u5DF2\u6709\u5B9E\u73B0\u6216\u9ED8\u8BA4\u80FD\u529B\u6EE1\u8DB3\u65F6\u76F4\u63A5\u590D\u7528\uFF0C\u4E0D\u4E3A\u4E86\u51D1\u9F50\u7C7B\u522B\u751F\u6210 Tool\u3002\u4E1A\u52A1\u80FD\u529B\u901A\u8FC7 \`agent.md\`\u3001\`src/buddy-options.mjs\` \u548C\u5B98\u65B9 Runtime \u7684\u6269\u5C55\u70B9\u5B9E\u73B0\u3002
@@ -2649,9 +2658,11 @@ Tool \u548C Hook \u662F Runtime \u7684\u6269\u5C55\u70B9\uFF1BService \u53EA\u66
 
 \u9700\u8981\u7528\u6237\u6570\u636E\u65F6\uFF0C\u5148\u5728\u5DE5\u7A0B\u76EE\u5F55\u6267\u884C \`buddy-cli datasets\`\uFF08\u811A\u672C\u53EF\u7528 \`--json\`\uFF09\uFF0C\u4ECE npm \u6700\u65B0 Runtime \u5BFC\u51FA\u8BFB\u53D6\u5168\u90E8\u6570\u636E\u96C6\uFF1B\u4E0D\u8981\u6C42\u767B\u5F55\uFF0C\u4E0D\u4ECE Server \u62C9\u76EE\u5F55\u3002CLI \u6BCF\u6B21\u67E5\u8BE2 latest\uFF0C\u540C\u7248\u672C\u590D\u7528\u7F13\u5B58\uFF0C\u4E0D\u590D\u5236\u679A\u4E3E\u3002\u76EE\u5F55\u547D\u4EE4\u4F1A\u63D0\u793A\u5DE5\u7A0B\u7248\u672C\u5DEE\u5F02\uFF1B\u4F7F\u7528\u65B0\u7248\u80FD\u529B\u524D\uFF0C\u7531\u4F60\u6216\u5F00\u53D1 Agent \u6309\u63D0\u793A\u5347\u7EA7\u4F9D\u8D56\uFF0C\u68C0\u67E5\u542F\u52A8\u53C2\u6570\u3001\u6A21\u578B\u3001datasets\u3001\u5DE5\u5177\u53CA Hook \u7684\u9002\u914D\u5E76\u9A8C\u8BC1 DEV\u3002CLI \u4E0D\u81EA\u52A8\u4FEE\u6539\u5DE5\u7A0B\u4F9D\u8D56\u6216\u914D\u7F6E\u3002\u628A\u5B9E\u9645\u9700\u8981\u7684 \`id\` \u548C\u7528\u9014 \`purpose\` \u5199\u5165 \`data-access.json.requirements\`\uFF0C\u6700\u591A 32 \u9879\uFF0C\u540C\u4E00 ID \u53EA\u5199\u4E00\u6B21\uFF0CID \u548C\u7528\u9014\u53BB\u9664\u9996\u5C3E\u7A7A\u767D\uFF0C\u7528\u9014\u4E3A 1\uFF5E200 \u5B57\uFF1B\u65E0\u9700\u6C42\u65F6\u4FDD\u7559\u7A7A\u6570\u7EC4\u3002DEV \u548C\u58F0\u660E\u975E\u7A7A\u65F6\u7684 push \u9884\u68C0\u7528\u8FD9\u4EFD\u5DE5\u7A0B\u4F9D\u8D56\u6821\u9A8C ID\uFF1B\u9700\u8981\u5148\u5B89\u88C5\u4E0E package.json \u51C6\u786E\u7248\u672C\u4E00\u81F4\u7684 Runtime\u3002\u6E05\u5355\u58F0\u660E\u6570\u91CF\u4E0D\u7B49\u4E8E\u5355\u6B21\u67E5\u8BE2\u4E0A\u9650\uFF0C\u5F53\u524D\u4E00\u6B21\u67E5\u8BE2\u6700\u591A 8 \u9879\u3002
 
-Runtime \u542F\u52A8\u65F6\u8BFB\u53D6\u6839\u76EE\u5F55 \`data-access.json\`\uFF0C\u901A\u8FC7 \`PUT /internal/v1/data-access/requirements\` \u767B\u8BB0\uFF0C\u6210\u529F\u540E\u518D\u8FDE\u63A5\u4E8B\u4EF6\u6D41\uFF1B\u767B\u8BB0\u5931\u8D25\u963B\u6B62\u542F\u52A8\u3002\u6587\u4EF6\u7F3A\u5931\u6216\u7A7A\u6570\u7EC4\u90FD\u4F1A\u4E0A\u4F20\u7A7A\u58F0\u660E\u5E76\u6E05\u9664\u65E7\u58F0\u660E\u3002DEV \u4FDD\u5B58\u8BE5\u6587\u4EF6\u540E\u81EA\u52A8\u91CD\u542F\u5E76\u91CD\u65B0\u767B\u8BB0\u3002\u58F0\u660E\u4E0D\u8868\u793A\u7528\u6237\u5DF2\u6388\u6743\uFF1B\u4F4D\u7F6E\u548C\u65E5\u5386\u4E0D\u653E\u5165\u6B64\u6587\u4EF6\u3002
+Runtime \u542F\u52A8\u65F6\u8BFB\u53D6\u6839\u76EE\u5F55 \`data-access.json\`\uFF0C\u901A\u8FC7 \`PUT /internal/v1/data-access/requirements\` \u767B\u8BB0\uFF0C\u6210\u529F\u540E\u518D\u8FDE\u63A5\u4E8B\u4EF6\u6D41\uFF1B\u767B\u8BB0\u5931\u8D25\u963B\u6B62\u542F\u52A8\u3002\u6587\u4EF6\u7F3A\u5931\u6216\u7A7A\u6570\u7EC4\u90FD\u4F1A\u4E0A\u4F20\u7A7A\u58F0\u660E\u5E76\u6E05\u9664\u65E7\u58F0\u660E\u3002DEV \u4FDD\u5B58\u8BE5\u6587\u4EF6\u540E\u81EA\u52A8\u91CD\u542F\u5E76\u91CD\u65B0\u767B\u8BB0\u3002\u58F0\u660E\u4E0D\u8868\u793A\u7528\u6237\u5DF2\u6388\u6743\uFF1B\u6240\u6709\u9700\u8981\u7684\u6570\u636E\u90FD\u8981\u58F0\u660E\uFF0C\u5305\u62EC\u4F4D\u7F6E \`device.location\` \u548C\u65E5\u5386 \`device.calendar\`\u3002
 
-\u6A21\u578B\u9700\u8981\u67E5\u6570\u636E\u65F6\uFF0C\u5728 \`src/buddy-options.mjs\` \u7684 \`initialState.tools\` \u4E2D\u52A0\u5165 \`conversation.tools.data_access_query\`\uFF1B\u9700\u8981\u5411\u7528\u6237\u7533\u8BF7\u65F6\u52A0\u5165 \`conversation.tools.data_access_request\`\uFF0C\u4F4D\u7F6E\u3001\u65E5\u5386\u7684\u4E00\u6B21\u6027\u7ED3\u679C\u901A\u8FC7 \`data_access_read_result\` \u8BFB\u53D6\uFF0CHealthKit \u5219\u91CD\u65B0\u67E5\u8BE2 Dataset\u3002\u4E1A\u52A1\u4EE3\u7801\u5BF9\u5E94\u4F7F\u7528 \`conversation.dataAccess.query/request/readResult\`\u3002\u65B0\u5EFA\u5DE5\u7A0B\u52A8\u6001\u9009\u62E9\u516C\u5171 npm latest \u5E76\u9501\u5B9A\u51C6\u786E\u7248\u672C\uFF1B\u67E5\u8BE2\u6216\u9501\u6587\u4EF6\u751F\u6210\u5931\u8D25\u65F6\u505C\u6B62\uFF0C\u4E0D\u56DE\u9000\u5185\u7F6E\u65E7\u7248\u672C\u3002\u5DF2\u6709\u5DE5\u7A0B\u901A\u8FC7\u5305\u7BA1\u7406\u5668\u663E\u5F0F\u5347\u7EA7\u4F9D\u8D56\u3002CLI \u7684 DEV \u542F\u52A8\u3001\u81EA\u52A8\u91CD\u8F7D\u548C push \u5FC5\u987B\u4F7F\u7528\u672C\u6B21 npm \u6700\u65B0\u7A33\u5B9A\u7248\uFF0C\u58F0\u660E\u3001\u5B89\u88C5\u548C npm \u9501\u6587\u4EF6\u7248\u672C\u5FC5\u987B\u4E00\u81F4\uFF0C\u67E5\u8BE2\u5931\u8D25\u4F1A\u963B\u6B62\u64CD\u4F5C\u3002
+\u6A21\u578B\u9700\u8981\u67E5\u6570\u636E\u65F6\uFF0C\u5728 \`src/buddy-options.mjs\` \u7684 \`initialState.tools\` \u4E2D\u52A0\u5165 \`conversation.tools.data_access_query\`\uFF1B\u9700\u8981\u5411\u7528\u6237\u7533\u8BF7\u65F6\u52A0\u5165 \`conversation.tools.data_access_request\`\u3002\u5065\u5EB7\u3001\u4F4D\u7F6E\u3001\u65E5\u5386\u7EDF\u4E00\u5148 query\uFF1B\u8FD4\u56DE \`notGranted\` \u65F6\uFF0C\u7528 \`data_access_request({ datasets, reason })\` \u7533\u8BF7\u5DF2\u58F0\u660E\u7684 1\uFF5E8 \u9879\u6570\u636E\uFF0C\u7B49\u5F85\u7528\u6237\u5904\u7406\u540E\u518D\u6B21 query\u3002\u4E1A\u52A1\u4EE3\u7801\u5BF9\u5E94\u4F7F\u7528 \`conversation.dataAccess.query({ datasets, memberId? })\` \u4E0E \`conversation.dataAccess.request({ datasets, reason, idempotencyKey })\`\u3002\u67E5\u8BE2\u53EA\u6709 \`available\` \u643A\u5E26\u6570\u636E\uFF1B\`notDeclared\` \u8981\u4FEE\u6B63\u5DE5\u7A0B\u58F0\u660E\uFF0C\`systemPermissionDenied\` \u8868\u793A\u7CFB\u7EDF\u6743\u9650\u5173\u95ED\uFF0C\u5E94\u5F15\u5BFC\u7528\u6237\u5728 App \u6216\u7CFB\u7EDF\u8BBE\u7F6E\u4E2D\u68C0\u67E5\uFF1B\`unavailable\` \u8868\u793A\u6682\u65E0\u53EF\u7528\u7ED3\u679C\uFF0C\u4E0D\u7B49\u4E8E\u7528\u6237\u62D2\u7EDD\uFF0C\u4E5F\u4E0D\u8981\u53CD\u590D\u53D1\u6388\u6743\u5361\u3002\u4F4D\u7F6E\u3001\u65E5\u5386\u5FEB\u7167\u8FC7\u671F\u540E\u7531\u5E73\u53F0\u5C1D\u8BD5\u8BF7\u6C42\u5728\u7EBF App \u5237\u65B0\uFF0CCLI \u4E0D\u91C7\u96C6\u8BBE\u5907\u6570\u636E\u3002
+
+\u65B0\u5EFA\u5DE5\u7A0B\u52A8\u6001\u9009\u62E9\u516C\u5171 npm latest \u5E76\u9501\u5B9A\u51C6\u786E\u7248\u672C\uFF1B\u67E5\u8BE2\u6216\u9501\u6587\u4EF6\u751F\u6210\u5931\u8D25\u65F6\u505C\u6B62\uFF0C\u4E0D\u56DE\u9000\u5185\u7F6E\u65E7\u7248\u672C\u3002\u5DF2\u6709\u5DE5\u7A0B\u901A\u8FC7\u5305\u7BA1\u7406\u5668\u663E\u5F0F\u5347\u7EA7\u4F9D\u8D56\u3002CLI \u7684 DEV \u542F\u52A8\u3001\u81EA\u52A8\u91CD\u8F7D\u548C push \u5FC5\u987B\u4F7F\u7528\u672C\u6B21 npm \u6700\u65B0\u7A33\u5B9A\u7248\uFF0C\u58F0\u660E\u3001\u5B89\u88C5\u548C npm \u9501\u6587\u4EF6\u7248\u672C\u5FC5\u987B\u4E00\u81F4\uFF0C\u67E5\u8BE2\u5931\u8D25\u4F1A\u963B\u6B62\u64CD\u4F5C\u3002
 
 \u5C0F\u6302\u4EF6\u7684\u6A21\u578B\u5DE5\u5177\u4E3A \`widget_create\`\u3001\`widget_read\`\uFF08\u6574\u4E2A\u5C0F\u6302\u4EF6\uFF09\u3001\`widget_read_module\`\uFF08\u4E00\u4E2A\u6A21\u5757\uFF09\u3001\`widget_rename\`\u3001\`widget_write_record\`\u3001\`widget_delete_record\`\u3001\`widget_delete\`\uFF08\u6574\u4E2A\u5C0F\u6302\u4EF6\u8FDE\u8BB0\u5F55\uFF09\u548C \`widget_send\`\uFF0C\u6309\u4E1A\u52A1\u9700\u8981\u6CE8\u518C\u5230 \`initialState.tools\`\u3002\u4FEE\u6539\u8BB0\u5F55\u7528 \`conversation.widget.writeRecord(id, input)\`\uFF1B\u5220\u4E00\u6761\u8BB0\u5F55\u7528 \`conversation.widget.deleteRecord(id, module, recordId)\`\uFF0C\u4E0D\u80FD\u7528\u5220\u9664\u6574\u4E2A\u5C0F\u6302\u4EF6\u7684 \`conversation.widget.delete(id)\` \u4EE3\u66FF\u3002\u4E24\u4E2A\u8BFB\u53D6\u5DE5\u5177\u53EF\u7528\u4E8E\u4E3B\u52A8\u56DE\u5408\uFF0C\u5176\u4F59\u516D\u4E2A\u5199\u5165\u5DE5\u5177\u7531 Runtime \u963B\u6B62\u5728\u4E3B\u52A8\u56DE\u5408\u6267\u884C\u3002
 
@@ -2956,7 +2967,7 @@ var CLI_HELP = `\u642D\u642D Developer Platform CLI
   models     \u67E5\u770B\u6700\u65B0 Runtime \u7684\u6A21\u578B\u76EE\u5F55
   datasets   \u67E5\u770B\u6700\u65B0 Runtime \u7684\u6570\u636E\u96C6\u76EE\u5F55
   knowledge  \u5C06\u521B\u4F5C\u8D44\u6599\u540C\u6B65\u4E3A\u672C\u5730\u8FD0\u884C\u77E5\u8BC6
-  dev        \u5728\u7EC8\u7AEF\u542F\u52A8\u5F00\u53D1\u7248\u642D\u5B50
+  dev        \u5728\u7EC8\u7AEF\u542F\u52A8\u5F00\u53D1\u7248\u642D\u5B50\uFF1Bdev stop \u505C\u6B62\u672C\u673A DEV
   preview    \u8FDE\u63A5\u5DE5\u7A0B\u5E76\u6253\u5F00\u540E\u53F0\u5F00\u53D1\u8C03\u8BD5
   push       \u4E0A\u4F20\u7A0B\u5E8F\u5305\u548C\u6539\u52A8\u8BF4\u660E
   status     \u67E5\u770B\u4E91\u7AEF\u7248\u672C\u3001\u8FD0\u884C\u548C\u5BA1\u6838\u72B6\u6001
@@ -2971,7 +2982,7 @@ var CLI_HELP = `\u642D\u642D Developer Platform CLI
 \u76F4\u63A5\u8FD0\u884C buddy-cli \u53EF\u8BC6\u522B\u5F53\u524D\u5DE5\u7A0B\u6216\u5F15\u5BFC\u521B\u5EFA\u3002
 \u9ED8\u8BA4\u5E73\u53F0\uFF1A${DEFAULT_MLB_TEST_URL}\uFF1B\u5F00\u53D1\u8005\u540E\u53F0\uFF1A${DEFAULT_DEVELOPER_WEB_URL}\u3002
 \u4ECE\u6D77\u5916\u56DE\u8FC1\u963F\u91CC\u4E91\u540E\u91CD\u65B0 login\uFF1B\u65E7\u5DE5\u7A0B\u7528 dev --refresh-token \u6216 preview --refresh-token \u66F4\u65B0\u5F00\u53D1\u51ED\u636E\u548C .env \u5730\u5740\u3002
-\u6B63\u5E38\u547D\u4EE4\u5148\u8054\u7F51\u81EA\u68C0\uFF0C\u65E7\u7248\u81EA\u52A8\u66F4\u65B0\u540E\u7EE7\u7EED\u6267\u884C\uFF1B\u5931\u8D25\u65F6\u505C\u6B62\u3002\u5E2E\u52A9\u548C --version \u79BB\u7EBF\u53EF\u7528\u3002
+\u6B63\u5E38\u547D\u4EE4\u5148\u8054\u7F51\u81EA\u68C0\uFF0C\u65E7\u7248\u81EA\u52A8\u66F4\u65B0\u540E\u7EE7\u7EED\u6267\u884C\uFF1B\u5931\u8D25\u65F6\u505C\u6B62\u3002\u5E2E\u52A9\u3001--version \u548C dev stop \u79BB\u7EBF\u53EF\u7528\u3002
 \u53C2\u6570\u4E0E\u793A\u4F8B: buddy-cli <\u547D\u4EE4> --help\uFF0C\u4F8B\u5982 buddy-cli init --help\u3002
 Coding Agent \u5F00\u59CB\u5DE5\u4F5C\u524D\u8BF7\u8BFB\u53D6 buddy-cli guide\u3002`;
 var INIT_HELP = `\u7528\u6CD5: buddy-cli init [\u53C2\u6570]
@@ -3019,7 +3030,7 @@ Skill \u7684\u5177\u4F53\u6D41\u7A0B\u8BFB\u53D6 HANDOFF.md \u4E2D\u7684\u6587\u
 
 \u4F7F\u7528\u5B98\u65B9 buddy-cli \u5165\u53E3\u3002\u6BCF\u6761\u6B63\u5E38\u547D\u4EE4\uFF08\u5305\u62EC guide\uFF09\u6267\u884C\u524D\u90FD\u4F1A\u67E5\u8BE2\u516C\u5171 npm latest\uFF1B\u7248\u672C\u8FC7\u65E7\u65F6\u81EA\u52A8\u66F4\u65B0\uFF0C\u518D\u7531\u65B0\u7248\u6267\u884C\u540C\u4E00\u547D\u4EE4\u3002\u7B49\u5F85\u5F53\u524D\u547D\u4EE4\u5B8C\u6210\uFF0C\u4E0D\u91CD\u590D\u53D1\u8D77\uFF0C\u4E0D\u53E6\u5F00\u8FDB\u7A0B\u540C\u65F6\u91CD\u8DD1\u3002
 \u5168\u5C40\u5B89\u88C5\u66F4\u65B0\u5BF9\u5E94 npm \u73AF\u5883\u7684\u5B89\u88C5\uFF1B\u6E90\u7801\u3001npm link\u3001\u9879\u76EE\u5185\u5B89\u88C5\u548C npx \u901A\u8FC7\u7F13\u5B58\u7684\u65B0\u7248\u7EE7\u7EED\u6267\u884C\uFF0C\u4E0D\u6539\u5199\u6E90\u7801\u6216\u9879\u76EE\u4F9D\u8D56\u3002\u53C2\u6570\u3001\u5DE5\u4F5C\u76EE\u5F55\u3001\u7EC8\u7AEF\u8F93\u5165\u8F93\u51FA\u548C\u9000\u51FA\u72B6\u6001\u4FDD\u7559\u3002\u4E00\u6B21\u8C03\u7528\u6700\u591A\u81EA\u52A8\u5207\u6362\u4E00\u6B21\uFF1B\u5F53\u524D\u7248\u672C\u9AD8\u4E8E latest \u65F6\u4E0D\u964D\u7EA7\uFF0C\u5DF2\u8FD0\u884C\u7684 DEV \u4E0D\u4F1A\u56E0\u53D1\u5E03\u65B0 CLI \u81EA\u52A8\u91CD\u542F\u3002
-\u5E2E\u52A9\u3001\u5404\u547D\u4EE4 --help \u548C --version \u79BB\u7EBF\u53EF\u7528\uFF1Bupdate \u662F\u5355\u72EC\u68C0\u67E5\u6216\u66F4\u65B0\u5165\u53E3\u3002\u67E5\u8BE2\u6216\u66F4\u65B0\u5931\u8D25\u65F6\u539F\u4E1A\u52A1\u64CD\u4F5C\u4E0D\u4F1A\u5F00\u59CB\uFF0C\u6839\u636E\u9519\u8BEF\u5904\u7406\u540E\u91CD\u8BD5\uFF0C\u4E0D\u8C03\u7528\u65E7\u7248\u6E90\u7801\u7ED5\u8FC7\u68C0\u67E5\u3002\u65E7 CLI \u9700\u5148\u901A\u8FC7\u5B98\u65B9 npm \u5B89\u88C5\u547D\u4EE4\u5347\u7EA7\u4E00\u6B21\uFF0C\u624D\u80FD\u83B7\u5F97\u6B64\u673A\u5236\u3002
+\u5E2E\u52A9\u3001\u5404\u547D\u4EE4 --help\u3001--version \u548C\u5E94\u6025\u6E05\u7406 dev stop \u79BB\u7EBF\u53EF\u7528\uFF1Bupdate \u662F\u5355\u72EC\u68C0\u67E5\u6216\u66F4\u65B0\u5165\u53E3\u3002\u67E5\u8BE2\u6216\u66F4\u65B0\u5931\u8D25\u65F6\u539F\u4E1A\u52A1\u64CD\u4F5C\u4E0D\u4F1A\u5F00\u59CB\uFF0C\u6839\u636E\u9519\u8BEF\u5904\u7406\u540E\u91CD\u8BD5\uFF0C\u4E0D\u8C03\u7528\u65E7\u7248\u6E90\u7801\u7ED5\u8FC7\u68C0\u67E5\u3002\u65E7 CLI \u9700\u5148\u901A\u8FC7\u5B98\u65B9 npm \u5B89\u88C5\u547D\u4EE4\u5347\u7EA7\u4E00\u6B21\uFF0C\u624D\u80FD\u83B7\u5F97\u6B64\u673A\u5236\u3002
 CLI \u81EA\u52A8\u66F4\u65B0\u4E0D\u7B49\u4E8E\u5DE5\u7A0B Runtime \u5DF2\u9002\u914D\u3002\u4ECD\u987B\u6839\u636E Runtime \u68C0\u67E5\u7ED3\u679C\u66F4\u65B0\u5DE5\u7A0B\u4F9D\u8D56\u3001\u9501\u6587\u4EF6\u548C\u5FC5\u8981\u7684\u4E1A\u52A1\u4EE3\u7801\uFF0C\u5B8C\u6210\u9A8C\u8BC1\u540E\u518D\u542F\u52A8\u6216\u4E0A\u4F20\uFF1B\u4E0D\u8981\u53EA\u4FEE\u6539\u7248\u672C\u53F7\u5C31\u5BA3\u79F0\u9002\u914D\u5B8C\u6210\u3002
 \u901A\u7528\u89C4\u5219\u4EE5\u672C\u547D\u4EE4\u7684\u5F53\u524D\u8F93\u51FA\u4E3A\u51C6\u3002HANDOFF.md \u53EA\u63D0\u4F9B\u5F53\u524D\u5DE5\u7A0B\u3001Skill \u8DEF\u5F84\u53CA\u5177\u4F53\u63A5\u7EED\u65B9\u5F0F\uFF0C\u4E0D\u5305\u542B\u6574\u4EFD\u5F00\u53D1\u6307\u5357\u3002
 
@@ -3046,15 +3057,12 @@ ${IMPLEMENTATION_GUIDE}
 
 ${DEVELOPMENT_HANDOFF}`;
 
-// packages/cli-core/src/commands/dev.ts
-import { resolve as resolve14 } from "node:path";
-
-// packages/cli-core/src/dev/project-env.ts
-import { constants } from "node:fs";
-import { open as open4, rename as rename9, unlink as unlink7 } from "node:fs/promises";
-import { randomUUID as randomUUID7 } from "node:crypto";
-import { join as join13 } from "node:path";
-import { parseEnv } from "node:util";
+// packages/cli-core/src/dev/local-stop.ts
+import { execFile as execFile5 } from "node:child_process";
+import { promisify as promisify5 } from "node:util";
+import { readFile as readFile13, readdir as readdir4, realpath as realpath5, rmdir as rmdir3, unlink as unlink7 } from "node:fs/promises";
+import { join as join14 } from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
 
 // packages/cli-core/src/dev/errors.ts
 var BuddyDevError = class extends Error {
@@ -3084,7 +3092,377 @@ function throwIfDevAborted(signal) {
   if (signal?.aborted) throw abortedDevError(signal);
 }
 
+// packages/cli-core/src/dev/process.ts
+import { promisify as promisify4 } from "node:util";
+import { spawn as spawnChild, execFile as execFile4 } from "node:child_process";
+var NodeAgentProcessLauncher = class {
+  #spawn;
+  constructor(options = {}) {
+    this.#spawn = options.spawn ?? spawnChild;
+  }
+  async spawn(request) {
+    let child;
+    try {
+      child = this.#spawn(request.command, [...request.args], {
+        cwd: request.cwd,
+        env: { ...request.env },
+        shell: false,
+        detached: request.detached,
+        windowsHide: false,
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+    } catch (cause) {
+      throw new BuddyDevError({
+        code: "DEV_AGENT_SPAWN_FAILED",
+        phase: "launch",
+        message: `\u65E0\u6CD5\u542F\u52A8 Agent \u7A0B\u5E8F ${request.command}\u3002`,
+        cause
+      });
+    }
+    let hasExited = false;
+    let spawned = false;
+    const exit = new Promise((resolve19) => {
+      child.once("error", (error2) => {
+        if (!spawned) {
+          hasExited = true;
+          resolve19({ code: null, signal: null, error: error2 });
+        }
+      });
+      child.once("exit", (code2, signal) => {
+        hasExited = true;
+        resolve19({ code: code2, signal });
+      });
+    });
+    child.stdout?.on("data", (chunk) => {
+      try {
+        request.onStdout?.(String(chunk));
+      } catch {
+      }
+    });
+    child.stderr?.on("data", (chunk) => {
+      try {
+        request.onStderr?.(String(chunk));
+      } catch {
+      }
+    });
+    try {
+      await new Promise((resolve19, reject) => {
+        const onSpawn = () => {
+          spawned = true;
+          child.off("error", onError);
+          resolve19();
+        };
+        const onError = (error2) => {
+          child.off("spawn", onSpawn);
+          reject(error2);
+        };
+        child.once("spawn", onSpawn);
+        child.once("error", onError);
+      });
+    } catch (cause) {
+      throw new BuddyDevError({
+        code: "DEV_AGENT_SPAWN_FAILED",
+        phase: "launch",
+        message: `\u65E0\u6CD5\u542F\u52A8 Agent \u7A0B\u5E8F ${request.command}\u3002`,
+        cause
+      });
+    }
+    const pid = child.pid;
+    if (pid === void 0 || !Number.isSafeInteger(pid) || pid <= 0) {
+      try {
+        child.kill("SIGKILL");
+      } catch {
+      }
+      throw new BuddyDevError({
+        code: "DEV_AGENT_SPAWN_FAILED",
+        phase: "launch",
+        message: "Agent \u8FDB\u7A0B\u6CA1\u6709\u6709\u6548 PID\u3002"
+      });
+    }
+    return {
+      pid,
+      exit,
+      hasExited: () => hasExited,
+      kill: (signal) => child.kill(signal)
+    };
+  }
+};
+function waitForExit(process2, timeoutMs) {
+  if (process2.hasExited()) return Promise.resolve(true);
+  return new Promise((resolve19) => {
+    const timeout = setTimeout(() => resolve19(false), timeoutMs);
+    process2.exit.then(() => {
+      clearTimeout(timeout);
+      resolve19(true);
+    });
+  });
+}
+var PosixProcessTreeController = class {
+  #killGroup;
+  #isGroupAlive;
+  constructor(options = {}) {
+    this.#killGroup = options.killGroup ?? ((pid, signal) => process.kill(-pid, signal));
+    this.#isGroupAlive = options.isGroupAlive ?? ((pid) => {
+      try {
+        process.kill(-pid, 0);
+        return true;
+      } catch (cause) {
+        return typeof cause === "object" && cause !== null && "code" in cause && cause.code !== "ESRCH";
+      }
+    });
+  }
+  async terminate(child, options = {}) {
+    if (!Number.isSafeInteger(child.pid) || child.pid <= 0) {
+      throw new BuddyDevError({
+        code: "DEV_STOP_FAILED",
+        phase: "stop",
+        message: "\u65E0\u6CD5\u505C\u6B62\u6CA1\u6709\u6709\u6548 PID \u7684 Agent \u8FDB\u7A0B\u6811\u3002"
+      });
+    }
+    const gracePeriodMs = options.gracePeriodMs ?? 5e3;
+    let gracefulSent = false;
+    let gracefulWasGroup = false;
+    try {
+      this.#killGroup(child.pid, "SIGTERM");
+      gracefulSent = true;
+      gracefulWasGroup = true;
+    } catch {
+      try {
+        gracefulSent = child.kill("SIGTERM");
+      } catch {
+        gracefulSent = false;
+      }
+    }
+    if (gracefulSent && await (gracefulWasGroup ? waitForGroupExit(child.pid, this.#isGroupAlive, gracePeriodMs) : waitForExit(child, gracePeriodMs))) return;
+    let forceSent = false;
+    let forceWasGroup = false;
+    try {
+      this.#killGroup(child.pid, "SIGKILL");
+      forceSent = true;
+      forceWasGroup = true;
+    } catch {
+      try {
+        forceSent = child.kill("SIGKILL");
+      } catch (cause) {
+        if (!child.hasExited()) {
+          throw new BuddyDevError({
+            code: "DEV_STOP_FAILED",
+            phase: "stop",
+            message: `\u65E0\u6CD5\u505C\u6B62 Agent \u8FDB\u7A0B\u6811\uFF08PID ${child.pid}\uFF09\u3002`,
+            cause
+          });
+        }
+      }
+    }
+    if (!forceSent && !child.hasExited()) {
+      throw new BuddyDevError({
+        code: "DEV_STOP_FAILED",
+        phase: "stop",
+        message: `\u65E0\u6CD5\u5411 Agent \u8FDB\u7A0B\u6811\u53D1\u9001\u5F3A\u5236\u505C\u6B62\u4FE1\u53F7\uFF08PID ${child.pid}\uFF09\u3002`
+      });
+    }
+    const forceStopped = forceWasGroup ? await waitForGroupExit(child.pid, this.#isGroupAlive, Math.min(gracePeriodMs, 1e3)) : await waitForExit(child, Math.min(gracePeriodMs, 1e3));
+    if (!forceStopped) {
+      throw new BuddyDevError({
+        code: "DEV_STOP_FAILED",
+        phase: "stop",
+        message: `Agent \u8FDB\u7A0B\u6811\u6CA1\u6709\u5728\u5F3A\u5236\u505C\u6B62\u540E\u9000\u51FA\uFF08PID ${child.pid}\uFF09\u3002`
+      });
+    }
+  }
+};
+async function waitForGroupExit(pid, isGroupAlive, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (isGroupAlive(pid)) {
+    const remaining = deadline - Date.now();
+    if (remaining <= 0) return false;
+    await new Promise((resolve19) => setTimeout(resolve19, Math.min(25, remaining)));
+  }
+  return true;
+}
+function processTreeControllerFor(platform) {
+  if (platform === "darwin") return new PosixProcessTreeController();
+  throw new BuddyDevError({
+    code: "DEV_OS_UNSUPPORTED",
+    phase: "launch",
+    message: "buddy-cli dev V1 \u76EE\u524D\u53EA\u652F\u6301 macOS \u5F00\u53D1\u73AF\u5883\u3002"
+  });
+}
+async function processIdentity(pid) {
+  try {
+    return (await promisify4(execFile4)("/bin/ps", ["-ww", "-p", String(pid), "-o", "uid=,pgid=,lstart=,command="], { env: { ...process.env, LC_ALL: "en_US.UTF-8" } })).stdout.trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
+
+// packages/cli-core/src/dev/instance-lock.ts
+import { createServer as createServer2 } from "node:http";
+import { realpath as realpath4 } from "node:fs/promises";
+import { createHash as createHash5, randomBytes as randomBytes2 } from "node:crypto";
+import { homedir as homedir3 } from "node:os";
+import { join as join13 } from "node:path";
+function alreadyRunningError() {
+  const message = "\u8FD9\u4E2A\u642D\u5B50\u5DF2\u6709 DEV \u5B9E\u4F8B\u5728\u8FD0\u884C\u3002\u8BF7\u5148\u5728\u539F\u9884\u89C8\u9875\u70B9\u51FB\u300C\u505C\u6B62 DEV\u300D\uFF0C\u6216\u5728\u5DE5\u7A0B\u76EE\u5F55\u6267\u884C buddy-cli dev stop\uFF0C\u518D\u542F\u52A8\u3002";
+  return Object.assign(new BuddyDevError({ code: "DEV_ALREADY_RUNNING", phase: "launch", message }), { publicMessage: message });
+}
+function devLockPath(options) {
+  return join13(
+    options.directory ?? join13(homedir3(), ".buddy", "dev-locks"),
+    createHash5("sha256").update(`${new URL(options.gatewayUrl).origin}
+${options.devAgentId}`).digest("hex")
+  );
+}
+async function acquireDevInstanceLock(options) {
+  const token = randomBytes2(32).toString("hex");
+  const server = options.onStop ? createServer2(async (request, response) => {
+    if (request.method !== "POST" || request.url !== "/stop" || request.headers.origin || request.headers.cookie || request.headers.authorization !== `Bearer ${token}`) {
+      response.writeHead(403);
+      response.end();
+      return;
+    }
+    try {
+      await options.onStop();
+      response.writeHead(200);
+      response.end();
+    } catch {
+      response.writeHead(500);
+      response.end();
+    }
+  }) : void 0;
+  try {
+    if (server) await new Promise((resolve19, reject) => {
+      server.once("error", reject);
+      server.listen(0, "127.0.0.1", () => {
+        server.off("error", reject);
+        resolve19();
+      });
+    });
+    const address = server?.address();
+    const path = devLockPath(options);
+    const lock = await acquireProcessLock({
+      directory: options.directory ?? join13(homedir3(), ".buddy", "dev-locks"),
+      key: path.split("/").at(-1),
+      busyError: alreadyRunningError,
+      ownerData: {
+        ...options.projectRoot ? { projectRoot: await realpath4(options.projectRoot) } : {},
+        ...address && typeof address !== "string" ? { control: { port: address.port, token } } : {}
+      },
+      runtimeData: async (pid) => ({ runtimeIdentity: await processIdentity(pid) })
+    });
+    return {
+      attachRuntime: (pid) => lock.attachRuntime(pid),
+      closeControl: () => {
+        server?.close();
+      },
+      async release() {
+        await lock.release();
+        server?.close();
+      }
+    };
+  } catch (error2) {
+    server?.close();
+    throw error2;
+  }
+}
+
+// packages/cli-core/src/dev/local-stop.ts
+var exec = promisify5(execFile5);
+var alive2 = (pid) => {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (e) {
+    return e.code !== "ESRCH";
+  }
+};
+var validPid2 = (pid) => Number.isSafeInteger(pid) && pid > 1;
+var failure = (message) => new BuddyDevError({ code: "DEV_STOP_FAILED", phase: "stop", message });
+async function stopLocalDev(options) {
+  const path = devLockPath(options);
+  let names;
+  try {
+    names = await readdir4(path);
+  } catch (error2) {
+    if (error2.code === "ENOENT") return { stopped: false };
+    throw error2;
+  }
+  if (names.length !== 1 || !/^owner-[a-f0-9-]+\.json$/u.test(names[0])) throw failure("DEV \u9501\u4FE1\u606F\u4E0D\u5B8C\u6574\uFF0C\u8BF7\u68C0\u67E5\u539F\u7EC8\u7AEF\uFF1B\u672A\u7EC8\u6B62\u4EFB\u4F55\u8FDB\u7A0B\u3002");
+  const ownerPath = join14(path, names[0]);
+  const source = await readFile13(ownerPath, "utf8");
+  const owner = JSON.parse(source);
+  if (!validPid2(owner.pid) || owner.runtimePid !== void 0 && !validPid2(owner.runtimePid)) throw failure("DEV \u9501\u4E2D\u7684 PID \u65E0\u6548\u3002");
+  const root = await realpath5(options.projectRoot);
+  if (owner.projectRoot && await realpath5(owner.projectRoot) !== root) throw failure(`\u6B64\u642D\u5B50\u7684 DEV \u5C5E\u4E8E\u53E6\u4E00\u4E2A\u5DE5\u7A0B\u76EE\u5F55\uFF1A${owner.projectRoot}\u3002\u8BF7\u5728\u8BE5\u76EE\u5F55\u6267\u884C dev stop\u3002`);
+  if (alive2(owner.pid)) {
+    const control = owner.control;
+    if (!control || !Number.isInteger(control.port) || control.port < 1 || control.port > 65535 || !/^[a-f0-9]{64}$/u.test(control.token)) {
+      throw failure(`\u539F CLI\uFF08PID ${owner.pid}\uFF09\u4ECD\u5728\u8FD0\u884C\u4E14\u4E0D\u652F\u6301\u8FDC\u7A0B\u505C\u6B62\uFF0C\u8BF7\u5728\u539F\u7EC8\u7AEF\u6309 Ctrl+C\u3002`);
+    }
+    try {
+      const response = await fetch(`http://127.0.0.1:${control.port}/stop`, { method: "POST", redirect: "error", headers: { Authorization: `Bearer ${control.token}` }, signal: AbortSignal.timeout(12e3) });
+      if (!response.ok) throw new Error("stop failed");
+      return { stopped: true };
+    } catch {
+      throw failure(`\u672A\u80FD\u786E\u8BA4\u539F CLI\uFF08PID ${owner.pid}\uFF09\u505C\u6B62 DEV\uFF0C\u8BF7\u5728\u539F\u7EC8\u7AEF\u6309 Ctrl+C\uFF1B\u4FDD\u7559\u8FDB\u7A0B\u9501\u3002`);
+    }
+  }
+  const pid = owner.runtimePid;
+  if (pid && alive2(pid)) {
+    const identity = await processIdentity(pid);
+    if (!identity || owner.runtimeIdentity && identity !== owner.runtimeIdentity) throw failure(`PID ${pid} \u7684\u8EAB\u4EFD\u5DF2\u6539\u53D8\u6216\u65E0\u6CD5\u786E\u8BA4\uFF0C\u672A\u7EC8\u6B62\u8BE5\u8FDB\u7A0B\u3002`);
+    const [uid, group] = identity.split(/\s+/u);
+    if (Number(uid) !== process.getuid?.() || Number(group) !== pid) throw failure(`PID ${pid} \u4E0D\u662F\u5F53\u524D\u7528\u6237\u7684\u72EC\u7ACB Runtime \u8FDB\u7A0B\u7EC4\uFF0C\u672A\u7EC8\u6B62\u8BE5\u8FDB\u7A0B\u3002`);
+    if (!owner.runtimeIdentity) {
+      const cwd = (await exec("/usr/sbin/lsof", ["-a", "-p", String(pid), "-d", "cwd", "-Fn"])).stdout.split("\n").find((line) => line.startsWith("n"))?.slice(1);
+      if (!cwd || await realpath5(cwd) !== root || !identity.endsWith(` ${join14(root, "start.mjs")}`) || !/\bnode\s/u.test(identity)) throw failure(`\u65E0\u6CD5\u786E\u8BA4\u65E7 Runtime\uFF08PID ${pid}\uFF09\u5C5E\u4E8E\u5F53\u524D\u5DE5\u7A0B\uFF0C\u672A\u7EC8\u6B62\u8BE5\u8FDB\u7A0B\u3002`);
+    }
+    if (await readFile13(ownerPath, "utf8") !== source || await processIdentity(pid) !== identity || alive2(owner.pid)) throw failure("DEV \u8FDB\u7A0B\u72B6\u6001\u5DF2\u6539\u53D8\uFF0C\u8BF7\u91CD\u65B0\u6267\u884C dev stop\u3002");
+    try {
+      process.kill(-pid, "SIGTERM");
+    } catch (error2) {
+      if (error2.code !== "ESRCH") throw error2;
+    }
+    const groupAlive = () => {
+      try {
+        process.kill(-pid, 0);
+        return true;
+      } catch (e) {
+        return e.code !== "ESRCH";
+      }
+    };
+    const deadline = Date.now() + 5e3;
+    while (groupAlive() && Date.now() < deadline) await delay(25);
+    if (groupAlive()) {
+      const current = await processIdentity(pid);
+      if (current && current !== identity) throw failure("Runtime \u8FDB\u7A0B\u8EAB\u4EFD\u5DF2\u6539\u53D8\uFF0C\u672A\u53D1\u9001\u5F3A\u5236\u505C\u6B62\u4FE1\u53F7\u3002");
+      process.kill(-pid, "SIGKILL");
+      const forceDeadline = Date.now() + 1e3;
+      while (groupAlive() && Date.now() < forceDeadline) await delay(25);
+      if (groupAlive()) throw failure(`Runtime \u8FDB\u7A0B\u7EC4 ${pid} \u5C1A\u672A\u786E\u8BA4\u9000\u51FA\uFF0C\u4FDD\u7559\u8FDB\u7A0B\u9501\u3002`);
+    }
+  }
+  if (pid && (alive2(pid) || alive2(-pid))) throw failure(`Runtime \u8FDB\u7A0B\u7EC4 ${pid} \u4ECD\u6709\u6B8B\u7559\u4E14\u65E0\u6CD5\u5B8C\u6574\u786E\u8BA4\u8EAB\u4EFD\uFF0C\u8BF7\u68C0\u67E5\u539F\u7EC8\u7AEF\uFF1B\u4FDD\u7559\u8FDB\u7A0B\u9501\u3002`);
+  try {
+    if (await readFile13(ownerPath, "utf8") === source) await unlink7(ownerPath);
+  } catch (error2) {
+    if (error2.code !== "ENOENT") throw error2;
+  }
+  await rmdir3(path).catch((error2) => {
+    if (!["ENOENT", "ENOTEMPTY", "EEXIST"].includes(error2.code)) throw error2;
+  });
+  return { stopped: true };
+}
+
+// packages/cli-core/src/commands/dev.ts
+import { resolve as resolve14 } from "node:path";
+
 // packages/cli-core/src/dev/project-env.ts
+import { constants } from "node:fs";
+import { open as open4, rename as rename9, unlink as unlink8 } from "node:fs/promises";
+import { randomUUID as randomUUID7 } from "node:crypto";
+import { join as join15 } from "node:path";
+import { parseEnv } from "node:util";
 function invalid(message) {
   return new BuddyDevError({ code: "DEV_CONFIG_INVALID", phase: "config", message });
 }
@@ -3104,7 +3482,7 @@ async function readLocalFile(path) {
   }
 }
 async function readProjectEnvironment(projectRoot) {
-  const source = await readLocalFile(join13(projectRoot, ".env"));
+  const source = await readLocalFile(join15(projectRoot, ".env"));
   let values;
   try {
     values = parseEnv(source);
@@ -3183,13 +3561,13 @@ async function replaceFile2(path, contents, mode) {
     await rename9(temporary, path);
   } finally {
     await file?.close();
-    await unlink7(temporary).catch((cause) => {
+    await unlink8(temporary).catch((cause) => {
       if (cause.code !== "ENOENT") throw cause;
     });
   }
 }
 async function writeProjectEnvironment(projectRoot, values) {
-  const envPath = join13(projectRoot, ".env"), ignorePath = join13(projectRoot, ".gitignore");
+  const envPath = join15(projectRoot, ".env"), ignorePath = join15(projectRoot, ".gitignore");
   const contents = updateValues(await readLocalFile(envPath), { ...values, BUDDY_ID: void 0 });
   const ignored = await readLocalFile(ignorePath);
   if (ignored.trimEnd().split(/\r?\n/u).at(-1) !== "/.env") {
@@ -3468,42 +3846,23 @@ function buildAgentEnvironment(options) {
 
 // packages/cli-core/src/dev/orchestrator.ts
 import { createHash as createHash7 } from "node:crypto";
-import { readFile as readFile16 } from "node:fs/promises";
-import { join as join17, resolve as resolve12 } from "node:path";
+import { readFile as readFile17 } from "node:fs/promises";
+import { join as join18, resolve as resolve12 } from "node:path";
 
 // packages/cli-core/src/dev/reload.ts
 import { watch } from "node:fs";
 import { createHash as createHash6 } from "node:crypto";
-import { readFile as readFile13, readdir as readdir4 } from "node:fs/promises";
-import { join as join15, resolve as resolve9 } from "node:path";
+import { readFile as readFile14, readdir as readdir5 } from "node:fs/promises";
+import { join as join16, resolve as resolve9 } from "node:path";
 import { setTimeout as sleep } from "node:timers/promises";
-
-// packages/cli-core/src/dev/instance-lock.ts
-import { createHash as createHash5 } from "node:crypto";
-import { homedir as homedir3 } from "node:os";
-import { join as join14 } from "node:path";
-function alreadyRunningError() {
-  const message = "\u8FD9\u4E2A\u642D\u5B50\u5DF2\u6709 DEV \u5B9E\u4F8B\u5728\u8FD0\u884C\u3002\u8BF7\u5148\u5728\u539F\u9884\u89C8\u9875\u70B9\u51FB\u300C\u505C\u6B62 DEV\u300D\uFF0C\u6216\u5728\u8FD0\u884C dev \u7684\u7EC8\u7AEF\u6309 Ctrl+C\uFF0C\u518D\u542F\u52A8\u3002";
-  return Object.assign(new BuddyDevError({ code: "DEV_ALREADY_RUNNING", phase: "launch", message }), { publicMessage: message });
-}
-async function acquireDevInstanceLock(options) {
-  return acquireProcessLock({
-    directory: options.directory ?? join14(homedir3(), ".buddy", "dev-locks"),
-    key: createHash5("sha256").update(`${new URL(options.gatewayUrl).origin}
-${options.devAgentId}`).digest("hex"),
-    busyError: alreadyRunningError
-  });
-}
-
-// packages/cli-core/src/dev/reload.ts
 var digest2 = (contents) => createHash6("sha256").update(contents).digest("hex");
 async function snapshot(root, prefix = "", result = /* @__PURE__ */ new Map()) {
-  for (const entry2 of await readdir4(join15(root, prefix), { withFileTypes: true })) {
+  for (const entry2 of await readdir5(join16(root, prefix), { withFileTypes: true })) {
     const path = prefix ? `${prefix}/${entry2.name}` : entry2.name;
     if (!relevant(path)) continue;
     try {
       if (entry2.isDirectory()) await snapshot(root, path, result);
-      else if (entry2.isFile()) result.set(path, digest2(await readFile13(join15(root, path))));
+      else if (entry2.isFile()) result.set(path, digest2(await readFile14(join16(root, path))));
     } catch (cause) {
       if (cause.code !== "ENOENT") throw cause;
     }
@@ -3593,7 +3952,7 @@ var ReloadingDevSession = class {
         const path = String(name);
         if (!relevant(path)) return;
         if (path === ".env") {
-          void readFile13(join15(this.projectRoot, path), "utf8").then((contents) => {
+          void readFile14(join16(this.projectRoot, path), "utf8").then((contents) => {
             if (contents !== this.#environment) {
               this.#environment = contents;
               this.#changed();
@@ -3615,8 +3974,10 @@ var ReloadingDevSession = class {
       this.#initializing = false;
       this.#watcher?.close();
       this.#options.signal?.removeEventListener("abort", this.#onAbort);
-      if (cause instanceof BuddyDevError && cause.code === "DEV_STOP_FAILED") this.#unsafeToRelease = true;
-      else await this.#lock?.release();
+      if (cause instanceof BuddyDevError && cause.code === "DEV_STOP_FAILED") {
+        this.#unsafeToRelease = true;
+        this.#lock?.closeControl?.();
+      } else await this.#lock?.release();
       throw cause;
     }
   }
@@ -3648,7 +4009,7 @@ var ReloadingDevSession = class {
       acquireLock: async (input) => {
         const origin = new URL(input.gatewayUrl).origin;
         if (this.#lockOrigin && this.#lockOrigin !== origin) throw new BuddyDevError({ code: "DEV_CONFIG_INVALID", phase: "config", message: "\u5DE5\u7A0B\u5E73\u53F0\u5730\u5740\u5DF2\u6539\u53D8\uFF0C\u8BF7\u505C\u6B62 DEV \u540E\u91CD\u65B0\u8FDE\u63A5\u3002" });
-        this.#lock ??= await acquireDevInstanceLock(input);
+        this.#lock ??= await acquireDevInstanceLock({ ...input, projectRoot: this.projectRoot, onStop: () => this.stop() });
         this.#lockOrigin = origin;
         return { attachRuntime: (pid) => this.#lock.attachRuntime(pid), async release() {
         } };
@@ -3673,6 +4034,7 @@ var ReloadingDevSession = class {
           this.#unsafeToRelease = true;
           this.#ended = true;
           this.#watcher?.close();
+          this.#lock?.closeControl?.();
           this.#resolve(completion);
         }
       }
@@ -3726,6 +4088,7 @@ var ReloadingDevSession = class {
             this.#unsafeToRelease = true;
             this.#ended = true;
             this.#watcher?.close();
+            this.#lock?.closeControl?.();
             this.#resolve({ state: "failed", error: error2 });
             return;
           }
@@ -3759,6 +4122,7 @@ var ReloadingDevSession = class {
       this.#emit("stopped");
       this.#resolve({ state: "stopped" });
     } catch (cause) {
+      this.#lock?.closeControl?.();
       const error2 = this.#error(cause);
       this.#emit("failed");
       this.#resolve({ state: "failed", error: error2 });
@@ -3771,7 +4135,7 @@ function startReloadingDev(options, startProcess) {
 }
 
 // packages/cli-core/src/config/runtime-policy.ts
-import { readFile as readFile14, realpath as realpath4 } from "node:fs/promises";
+import { readFile as readFile15, realpath as realpath6 } from "node:fs/promises";
 import { createRequire as createRequire2 } from "node:module";
 import { resolve as resolve10 } from "node:path";
 var RuntimeRequirementError = class extends Error {
@@ -3808,14 +4172,14 @@ async function requireLatestRuntime(root, options = {}) {
   }
   try {
     assertRequiredRuntime(await projectRuntimeVersion(root), latest);
-    const installedPath = await realpath4(resolve10(root, "node_modules", BUDDY_RUNTIME_PACKAGE, "package.json"));
+    const installedPath = await realpath6(resolve10(root, "node_modules", BUDDY_RUNTIME_PACKAGE, "package.json"));
     const fromProject = createRequire2(resolve10(root, "package.json")).resolve(`${BUDDY_RUNTIME_PACKAGE}/package.json`);
-    if (await realpath4(fromProject) !== installedPath) throw new Error("Runtime \u5FC5\u987B\u5B89\u88C5\u5728\u5F53\u524D\u5DE5\u7A0B\u4E2D");
-    const installed2 = JSON.parse(await readFile14(installedPath, "utf8"));
+    if (await realpath6(fromProject) !== installedPath) throw new Error("Runtime \u5FC5\u987B\u5B89\u88C5\u5728\u5F53\u524D\u5DE5\u7A0B\u4E2D");
+    const installed2 = JSON.parse(await readFile15(installedPath, "utf8"));
     if (installed2.version !== latest) throw new Error(`Runtime \u5B9E\u9645\u5B89\u88C5 ${installed2.version}\uFF0C\u8981\u6C42 ${latest}`);
     let lock;
     try {
-      lock = await readFile14(resolve10(root, "package-lock.json"), "utf8");
+      lock = await readFile15(resolve10(root, "package-lock.json"), "utf8");
     } catch (cause) {
       if (cause.code !== "ENOENT") throw cause;
     }
@@ -3835,8 +4199,8 @@ import { createRequire as createRequire3 } from "node:module";
 import { dirname as dirname4, resolve as resolve11 } from "node:path";
 
 // packages/cli-core/src/config/data-access.ts
-import { lstat as lstat10, readFile as readFile15 } from "node:fs/promises";
-import { join as join16 } from "node:path";
+import { lstat as lstat10, readFile as readFile16 } from "node:fs/promises";
+import { join as join17 } from "node:path";
 var DATA_ACCESS_FILENAME = "data-access.json";
 function parseDataAccessRequirements(source) {
   if (source === void 0) return [];
@@ -3864,10 +4228,10 @@ function parseDataAccessRequirements(source) {
   });
 }
 async function readDataAccessRequirements(projectRoot) {
-  const path = join16(projectRoot, DATA_ACCESS_FILENAME);
+  const path = join17(projectRoot, DATA_ACCESS_FILENAME);
   try {
     if (!(await lstat10(path)).isFile()) throw new Error(`${DATA_ACCESS_FILENAME} \u5FC5\u987B\u662F\u666E\u901A\u6587\u4EF6`);
-    return parseDataAccessRequirements(await readFile15(path, "utf8"));
+    return parseDataAccessRequirements(await readFile16(path, "utf8"));
   } catch (cause) {
     if (cause.code === "ENOENT") return [];
     throw cause;
@@ -3920,202 +4284,6 @@ async function officialAgentLaunchPlan(input) {
   });
 }
 
-// packages/cli-core/src/dev/process.ts
-import { spawn as spawnChild } from "node:child_process";
-var NodeAgentProcessLauncher = class {
-  #spawn;
-  constructor(options = {}) {
-    this.#spawn = options.spawn ?? spawnChild;
-  }
-  async spawn(request) {
-    let child;
-    try {
-      child = this.#spawn(request.command, [...request.args], {
-        cwd: request.cwd,
-        env: { ...request.env },
-        shell: false,
-        detached: request.detached,
-        windowsHide: false,
-        stdio: ["ignore", "pipe", "pipe"]
-      });
-    } catch (cause) {
-      throw new BuddyDevError({
-        code: "DEV_AGENT_SPAWN_FAILED",
-        phase: "launch",
-        message: `\u65E0\u6CD5\u542F\u52A8 Agent \u7A0B\u5E8F ${request.command}\u3002`,
-        cause
-      });
-    }
-    let hasExited = false;
-    let spawned = false;
-    const exit = new Promise((resolve19) => {
-      child.once("error", (error2) => {
-        if (!spawned) {
-          hasExited = true;
-          resolve19({ code: null, signal: null, error: error2 });
-        }
-      });
-      child.once("exit", (code2, signal) => {
-        hasExited = true;
-        resolve19({ code: code2, signal });
-      });
-    });
-    child.stdout?.on("data", (chunk) => {
-      try {
-        request.onStdout?.(String(chunk));
-      } catch {
-      }
-    });
-    child.stderr?.on("data", (chunk) => {
-      try {
-        request.onStderr?.(String(chunk));
-      } catch {
-      }
-    });
-    try {
-      await new Promise((resolve19, reject) => {
-        const onSpawn = () => {
-          spawned = true;
-          child.off("error", onError);
-          resolve19();
-        };
-        const onError = (error2) => {
-          child.off("spawn", onSpawn);
-          reject(error2);
-        };
-        child.once("spawn", onSpawn);
-        child.once("error", onError);
-      });
-    } catch (cause) {
-      throw new BuddyDevError({
-        code: "DEV_AGENT_SPAWN_FAILED",
-        phase: "launch",
-        message: `\u65E0\u6CD5\u542F\u52A8 Agent \u7A0B\u5E8F ${request.command}\u3002`,
-        cause
-      });
-    }
-    const pid = child.pid;
-    if (pid === void 0 || !Number.isSafeInteger(pid) || pid <= 0) {
-      try {
-        child.kill("SIGKILL");
-      } catch {
-      }
-      throw new BuddyDevError({
-        code: "DEV_AGENT_SPAWN_FAILED",
-        phase: "launch",
-        message: "Agent \u8FDB\u7A0B\u6CA1\u6709\u6709\u6548 PID\u3002"
-      });
-    }
-    return {
-      pid,
-      exit,
-      hasExited: () => hasExited,
-      kill: (signal) => child.kill(signal)
-    };
-  }
-};
-function waitForExit(process2, timeoutMs) {
-  if (process2.hasExited()) return Promise.resolve(true);
-  return new Promise((resolve19) => {
-    const timeout = setTimeout(() => resolve19(false), timeoutMs);
-    process2.exit.then(() => {
-      clearTimeout(timeout);
-      resolve19(true);
-    });
-  });
-}
-var PosixProcessTreeController = class {
-  #killGroup;
-  #isGroupAlive;
-  constructor(options = {}) {
-    this.#killGroup = options.killGroup ?? ((pid, signal) => process.kill(-pid, signal));
-    this.#isGroupAlive = options.isGroupAlive ?? ((pid) => {
-      try {
-        process.kill(-pid, 0);
-        return true;
-      } catch (cause) {
-        return typeof cause === "object" && cause !== null && "code" in cause && cause.code !== "ESRCH";
-      }
-    });
-  }
-  async terminate(child, options = {}) {
-    if (!Number.isSafeInteger(child.pid) || child.pid <= 0) {
-      throw new BuddyDevError({
-        code: "DEV_STOP_FAILED",
-        phase: "stop",
-        message: "\u65E0\u6CD5\u505C\u6B62\u6CA1\u6709\u6709\u6548 PID \u7684 Agent \u8FDB\u7A0B\u6811\u3002"
-      });
-    }
-    const gracePeriodMs = options.gracePeriodMs ?? 5e3;
-    let gracefulSent = false;
-    let gracefulWasGroup = false;
-    try {
-      this.#killGroup(child.pid, "SIGTERM");
-      gracefulSent = true;
-      gracefulWasGroup = true;
-    } catch {
-      try {
-        gracefulSent = child.kill("SIGTERM");
-      } catch {
-        gracefulSent = false;
-      }
-    }
-    if (gracefulSent && await (gracefulWasGroup ? waitForGroupExit(child.pid, this.#isGroupAlive, gracePeriodMs) : waitForExit(child, gracePeriodMs))) return;
-    let forceSent = false;
-    let forceWasGroup = false;
-    try {
-      this.#killGroup(child.pid, "SIGKILL");
-      forceSent = true;
-      forceWasGroup = true;
-    } catch {
-      try {
-        forceSent = child.kill("SIGKILL");
-      } catch (cause) {
-        if (!child.hasExited()) {
-          throw new BuddyDevError({
-            code: "DEV_STOP_FAILED",
-            phase: "stop",
-            message: `\u65E0\u6CD5\u505C\u6B62 Agent \u8FDB\u7A0B\u6811\uFF08PID ${child.pid}\uFF09\u3002`,
-            cause
-          });
-        }
-      }
-    }
-    if (!forceSent && !child.hasExited()) {
-      throw new BuddyDevError({
-        code: "DEV_STOP_FAILED",
-        phase: "stop",
-        message: `\u65E0\u6CD5\u5411 Agent \u8FDB\u7A0B\u6811\u53D1\u9001\u5F3A\u5236\u505C\u6B62\u4FE1\u53F7\uFF08PID ${child.pid}\uFF09\u3002`
-      });
-    }
-    const forceStopped = forceWasGroup ? await waitForGroupExit(child.pid, this.#isGroupAlive, Math.min(gracePeriodMs, 1e3)) : await waitForExit(child, Math.min(gracePeriodMs, 1e3));
-    if (!forceStopped) {
-      throw new BuddyDevError({
-        code: "DEV_STOP_FAILED",
-        phase: "stop",
-        message: `Agent \u8FDB\u7A0B\u6811\u6CA1\u6709\u5728\u5F3A\u5236\u505C\u6B62\u540E\u9000\u51FA\uFF08PID ${child.pid}\uFF09\u3002`
-      });
-    }
-  }
-};
-async function waitForGroupExit(pid, isGroupAlive, timeoutMs) {
-  const deadline = Date.now() + timeoutMs;
-  while (isGroupAlive(pid)) {
-    const remaining = deadline - Date.now();
-    if (remaining <= 0) return false;
-    await new Promise((resolve19) => setTimeout(resolve19, Math.min(25, remaining)));
-  }
-  return true;
-}
-function processTreeControllerFor(platform) {
-  if (platform === "darwin") return new PosixProcessTreeController();
-  throw new BuddyDevError({
-    code: "DEV_OS_UNSUPPORTED",
-    phase: "launch",
-    message: "buddy-cli dev V1 \u76EE\u524D\u53EA\u652F\u6301 macOS \u5F00\u53D1\u73AF\u5883\u3002"
-  });
-}
-
 // packages/cli-core/src/dev/orchestrator.ts
 var DEFAULT_ONLINE_TIMEOUT_MS = 3e4;
 var DEFAULT_POLL_INTERVAL_MS = 200;
@@ -4194,7 +4362,7 @@ async function registerDevAgent(options) {
     });
   }
 }
-function delay(milliseconds, signal) {
+function delay2(milliseconds, signal) {
   if (signal.aborted) return Promise.reject(abortedDevError(signal));
   return new Promise((resolveDelay, reject) => {
     const onAbort = () => {
@@ -4234,7 +4402,7 @@ async function waitForAgentOnline(options) {
       if (cause instanceof BuddyDevError && !cause.retryable) throw cause;
       lastError = cause;
     }
-    await delay(Math.min(options.pollIntervalMs, Math.max(1, deadline - Date.now())), options.signal);
+    await delay2(Math.min(options.pollIntervalMs, Math.max(1, deadline - Date.now())), options.signal);
   }
 }
 function agentExitedError(exit, stderr = "") {
@@ -4386,7 +4554,7 @@ async function startBuddyDevProcess(options, hooks) {
     let config;
     let configSource;
     try {
-      configSource = await readFile16(join17(projectRoot, BUDDY_PACKAGE_FILENAME), "utf8");
+      configSource = await readFile17(join18(projectRoot, BUDDY_PACKAGE_FILENAME), "utf8");
       config = combineBuddyProject(parseBuddyAgentConfig(configSource));
     } catch (cause) {
       throw new BuddyDevError({
@@ -4709,8 +4877,11 @@ var DevCommandUsageError = class extends Error {
 };
 var DEV_COMMAND_HELP = `\u7528\u6CD5:
   buddy-cli dev [--app-server <App Server URL>] [--directory <\u9879\u76EE\u76EE\u5F55>] [--refresh-token]
+  buddy-cli dev stop [--directory <\u9879\u76EE\u76EE\u5F55>] [--app-server <App Server URL>] [--buddy-id <\u642D\u5B50 ID>]
 
 \u8BF4\u660E:
+  dev stop \u505C\u6B62\u5F53\u524D\u5DE5\u7A0B\u7684 DEV \u53CA\u6587\u4EF6\u76D1\u542C\uFF0C\u6E05\u7406\u5DF2\u786E\u8BA4\u9000\u51FA\u7684\u6B8B\u7559\u8FDB\u7A0B\uFF1B\u4E0D\u91CD\u8FDE\u3001\u4E0D\u91CD\u542F\uFF0C\u65E0\u9700\u767B\u5F55\u6216\u8054\u7F51\u66F4\u65B0\u3002
+  \u5173\u95ED\u7EC8\u7AEF\u3001Ctrl+C \u6216 SIGTERM \u4F1A\u505C\u6B62 CLI \u6258\u7BA1\u7684 Runtime\uFF1B\u5F3A\u5236\u6740\u6B7B CLI \u540E\u53EF\u7528 dev stop \u6E05\u7406\u3002
   \u672A\u914D\u7F6E\u5730\u5740\u65F6\u8FDE\u63A5 MLB \u6D4B\u8BD5\u73AF\u5883 ${DEFAULT_MLB_TEST_URL}\uFF08HTTP \u4EC5\u9650\u6D4B\u8BD5\uFF09\u3002
   CLI \u7EDF\u4E00\u542F\u52A8\u5E76\u7BA1\u7406\u5DE5\u7A0B\u4E2D\u7684\u5B98\u65B9 Runtime\uFF1B\u6BCF\u6B21\u542F\u52A8\u6216\u91CD\u8F7D\u5FC5\u987B\u901A\u8FC7 npm \u6700\u65B0\u7A33\u5B9A\u7248\u68C0\u67E5\u3002
   DEV \u4F1A\u901A\u8FC7\u6D4F\u89C8\u5668\u767B\u5F55\u83B7\u53D6\u5F00\u53D1\u8005\u4F1A\u8BDD\uFF0C\u5C06\u5F53\u524D\u642D\u5B50\u7684\u5F00\u53D1 Token \u5199\u5165\u5DE5\u7A0B .env\uFF0C\u590D\u7528\u524D\u5411 Server \u6838\u5BF9\u6240\u5C5E\u642D\u5B50\uFF1B\u767B\u5F55\u51ED\u636E\u4ECD\u4F7F\u7528\u7CFB\u7EDF\u51ED\u636E\u5B58\u50A8\u3002
@@ -4726,6 +4897,9 @@ function setOnce(current, value, flag2) {
   return value;
 }
 function parseDevArguments(args) {
+  const stop = args[0] === "stop";
+  if (stop) args = args.slice(1);
+  let buddyId;
   let directory = ".";
   let directorySet = false;
   let appServer;
@@ -4746,6 +4920,10 @@ function parseDevArguments(args) {
     const value = valueAfter(args, index, flag2 ?? "\u53C2\u6570");
     index += 1;
     switch (flag2) {
+      case "--buddy-id":
+        if (!stop) throw new DevCommandUsageError("--buddy-id \u4EC5\u7528\u4E8E dev stop \u8EAB\u4EFD\u6821\u9A8C");
+        buddyId = setOnce(buddyId, value, flag2);
+        break;
       case "--directory":
         if (directorySet) throw new DevCommandUsageError("--directory \u4E0D\u80FD\u91CD\u590D");
         directory = value;
@@ -4758,7 +4936,8 @@ function parseDevArguments(args) {
         throw new DevCommandUsageError(`\u672A\u77E5 dev \u53C2\u6570 ${flag2}`);
     }
   }
-  return { directory, appServer, help, refreshToken };
+  if (stop && refreshToken) throw new DevCommandUsageError("dev stop \u4E0D\u652F\u6301 --refresh-token");
+  return { stop, buddyId, directory, appServer, help, refreshToken };
 }
 function appServerUrl(override, env) {
   try {
@@ -4792,6 +4971,13 @@ async function runDevCommand(args, io, options = {}) {
     const root = await (options.resolveProjectRoot ?? requireBuddyAgentProjectRoot)(requestedRoot);
     const environment = options.env ?? process.env;
     const url = appServerUrl(parsed.appServer, environment);
+    if (parsed.stop) {
+      const manifest = await (options.readManifest ?? readBuddyProjectManifest)(root);
+      if (parsed.buddyId && parsed.buddyId !== manifest.buddyId) throw new DevCommandUsageError(`\u5F53\u524D\u5DE5\u7A0B\u5C5E\u4E8E ${manifest.buddyId}\uFF0C\u505C\u6B62\u6307\u4EE4\u8981\u6C42 ${parsed.buddyId}\uFF1B\u672A\u505C\u6B62\u4EFB\u4F55\u8FDB\u7A0B\u3002`);
+      const result = await stopLocalDev({ gatewayUrl: url, devAgentId: manifest.buddyId, projectRoot: root });
+      io.write(result.stopped ? "DEV \u5DF2\u505C\u6B62\uFF0C\u6B8B\u7559\u8FDB\u7A0B\u53CA\u8FDB\u7A0B\u9501\u5DF2\u6E05\u7406\u3002\u9700\u8981\u8C03\u8BD5\u65F6\u91CD\u65B0\u8FDE\u63A5\u5E76\u542F\u52A8 DEV\u3002" : "\u5F53\u524D\u5DE5\u7A0B\u6CA1\u6709 CLI \u6258\u7BA1\u7684\u672C\u5730 DEV \u8FDB\u7A0B\u3002\u5176\u4ED6\u7535\u8111\u4E0A\u7684\u670D\u52A1\u8BF7\u5728\u5BF9\u5E94\u7535\u8111\u505C\u6B62\u3002");
+      return { exitCode: 0 };
+    }
     const authorizationInput = { appServerUrl: url, ...parsed.refreshToken ? { refreshToken: true } : {} };
     if (!options.authorize) {
       throw new DevCommandUsageError("\u5F53\u524D CLI Host \u5C1A\u672A\u914D\u7F6E\u642D\u642D\u8D26\u53F7\u767B\u5F55 Adapter");
@@ -5308,7 +5494,7 @@ var HttpDeveloperPlatformClient = class {
 };
 
 // packages/cli-core/src/cloud/mock-client.ts
-import { createHash as createHash9, randomBytes as randomBytes2 } from "node:crypto";
+import { createHash as createHash9, randomBytes as randomBytes3 } from "node:crypto";
 var MockDeveloperPlatformClient = class {
   #now;
   #buddies = /* @__PURE__ */ new Map();
@@ -5317,7 +5503,7 @@ var MockDeveloperPlatformClient = class {
     this.#now = options.now ?? Date.now;
   }
   async createBuddy(request) {
-    const id = `b_mock_${randomBytes2(8).toString("hex")}`;
+    const id = `b_mock_${randomBytes3(8).toString("hex")}`;
     const value = this.#value({
       id,
       meta: request.meta,
@@ -5326,7 +5512,7 @@ var MockDeveloperPlatformClient = class {
       released: false,
       online: false,
       updatedAt: this.#now(),
-      token: `bt_mock_${randomBytes2(16).toString("hex")}`
+      token: `bt_mock_${randomBytes3(16).toString("hex")}`
     });
     this.#buddies.set(id, value);
     this.#packages.set(id, []);
@@ -5638,8 +5824,8 @@ async function runCloudCommand(command, args, io, options = {}) {
 var CLOUD_COMMAND_HELP = HELP;
 
 // packages/cli-core/src/migration/index.ts
-import { lstat as lstat11, open as open5, readdir as readdir5, realpath as realpath5, stat } from "node:fs/promises";
-import { extname, isAbsolute as isAbsolute3, join as join18, relative, resolve as resolve16, sep, win32 as win322 } from "node:path";
+import { lstat as lstat11, open as open5, readdir as readdir6, realpath as realpath7, stat } from "node:fs/promises";
+import { extname, isAbsolute as isAbsolute3, join as join19, relative, resolve as resolve16, sep, win32 as win322 } from "node:path";
 var DEFAULT_SKILL_SCAN_LIMITS = Object.freeze({
   maxFiles: 128,
   maxFileBytes: 256 * 1024,
@@ -5792,7 +5978,7 @@ async function existingProjectRoot(value) {
     return rejectScan("SKILL_PROJECT_ROOT_INVALID", ".", "projectRoot \u5FC5\u987B\u6307\u5411\u4E00\u4E2A\u5DF2\u6709\u9879\u76EE\u76EE\u5F55\u3002");
   }
   try {
-    const root = await realpath5(resolve16(value));
+    const root = await realpath7(resolve16(value));
     if (!(await stat(root)).isDirectory()) {
       return rejectScan("SKILL_PROJECT_ROOT_INVALID", ".", "projectRoot \u5FC5\u987B\u6307\u5411\u4E00\u4E2A\u5DF2\u6709\u9879\u76EE\u76EE\u5F55\u3002");
     }
@@ -5808,7 +5994,7 @@ async function existingProjectRoot(value) {
   }
 }
 async function existingSkillRoot(projectRoot, skillPath) {
-  const candidate = skillPath === "." ? projectRoot : join18(projectRoot, ...skillPath.split("/"));
+  const candidate = skillPath === "." ? projectRoot : join19(projectRoot, ...skillPath.split("/"));
   try {
     await lstat11(candidate);
   } catch (cause) {
@@ -5819,7 +6005,7 @@ async function existingSkillRoot(projectRoot, skillPath) {
   }
   let root;
   try {
-    root = await realpath5(candidate);
+    root = await realpath7(candidate);
   } catch (cause) {
     if (filesystemCode(cause) === "ELOOP") {
       return rejectScan("SKILL_SYMLINK_CYCLE", skillPath, "Skill \u8DEF\u5F84\u5305\u542B\u7B26\u53F7\u94FE\u63A5\u5FAA\u73AF\u3002", cause);
@@ -5845,10 +6031,10 @@ async function existingSkillRoot(projectRoot, skillPath) {
 }
 async function assertEntrypoint(context) {
   const entryPath = reportChild(context.skillPath, "SKILL.md");
-  const candidate = join18(context.skillRoot, "SKILL.md");
+  const candidate = join19(context.skillRoot, "SKILL.md");
   try {
     await lstat11(candidate);
-    const target = await realpath5(candidate);
+    const target = await realpath7(candidate);
     if (!isWithin(context.projectRoot, target) || !isWithin(context.skillRoot, target)) {
       rejectScan(
         "SKILL_SYMLINK_ESCAPE",
@@ -5892,7 +6078,7 @@ async function walkDirectory(actualDirectory, reportDirectory, ancestors, contex
   }
   let directory;
   try {
-    directory = await realpath5(actualDirectory);
+    directory = await realpath7(actualDirectory);
   } catch (cause) {
     if (filesystemCode(cause) === "ELOOP") {
       return rejectScan("SKILL_SYMLINK_CYCLE", reportDirectory, "Skill \u76EE\u5F55\u5305\u542B\u7B26\u53F7\u94FE\u63A5\u5FAA\u73AF\u3002", cause);
@@ -5912,7 +6098,7 @@ async function walkDirectory(actualDirectory, reportDirectory, ancestors, contex
   nextAncestors.add(directoryKey);
   let entries;
   try {
-    entries = await readdir5(directory, { withFileTypes: true, encoding: "utf8" });
+    entries = await readdir6(directory, { withFileTypes: true, encoding: "utf8" });
   } catch (cause) {
     return rejectScan("SKILL_SCAN_IO_ERROR", reportDirectory, "\u65E0\u6CD5\u5217\u51FA Skill \u5B50\u76EE\u5F55\u3002", cause);
   }
@@ -5949,10 +6135,10 @@ async function walkDirectory(actualDirectory, reportDirectory, ancestors, contex
   }
   for (const entry2 of entries) {
     const childReportPath = reportChild(reportDirectory, entry2.name);
-    const childPath = join18(directory, entry2.name);
+    const childPath = join19(directory, entry2.name);
     let target;
     try {
-      target = await realpath5(childPath);
+      target = await realpath7(childPath);
     } catch (cause) {
       if (filesystemCode(cause) === "ELOOP") {
         return rejectScan("SKILL_SYMLINK_CYCLE", childReportPath, "Skill \u5185\u5BB9\u5305\u542B\u7B26\u53F7\u94FE\u63A5\u5FAA\u73AF\u3002", cause);
@@ -6404,8 +6590,8 @@ async function scanExternalSkillPortability(options) {
 
 // packages/cli-core/src/push/preflight.ts
 import { createHash as createHash10 } from "node:crypto";
-import { lstat as lstat12, open as open6, readdir as readdir6, realpath as realpath6 } from "node:fs/promises";
-import { isAbsolute as isAbsolute4, join as join19, relative as relative2, resolve as resolve17, sep as sep2, win32 as win323 } from "node:path";
+import { lstat as lstat12, open as open6, readdir as readdir7, realpath as realpath8 } from "node:fs/promises";
+import { isAbsolute as isAbsolute4, join as join20, relative as relative2, resolve as resolve17, sep as sep2, win32 as win323 } from "node:path";
 var MEBIBYTE = 1024 * 1024;
 var DEFAULT_PUSH_MANIFEST_LIMITS = Object.freeze({
   maxFiles: 1e4,
@@ -6599,7 +6785,7 @@ async function canonicalProjectRoot(projectRoot) {
     });
   }
   try {
-    return await realpath6(absolute);
+    return await realpath8(absolute);
   } catch (cause) {
     error({
       code: "PUSH_PROJECT_INVALID",
@@ -6610,7 +6796,7 @@ async function canonicalProjectRoot(projectRoot) {
   }
 }
 async function captureConfigWithinLimit(projectRoot, maxFileBytes, filename) {
-  const path = join19(projectRoot, filename);
+  const path = join20(projectRoot, filename);
   let entry2;
   try {
     entry2 = await lstat12(path);
@@ -6680,7 +6866,7 @@ function parseCapturedProject(agentFile) {
 async function selectLockfile(projectRoot) {
   let names;
   try {
-    names = await readdir6(projectRoot);
+    names = await readdir7(projectRoot);
   } catch (cause) {
     error({
       code: "PUSH_PROJECT_INVALID",
@@ -6789,7 +6975,7 @@ async function createManifest(options) {
     }
     let names;
     try {
-      names = await readdir6(directory);
+      names = await readdir7(directory);
     } catch (cause) {
       error({
         code: "PUSH_PROJECT_INVALID",
@@ -6813,7 +6999,7 @@ async function createManifest(options) {
         sensitiveEntriesExcluded += 1;
         continue;
       }
-      const absolutePath = join19(directory, name);
+      const absolutePath = join20(directory, name);
       let entry2;
       try {
         entry2 = await lstat12(absolutePath);
@@ -6847,7 +7033,7 @@ async function createManifest(options) {
       }
       let canonicalPath;
       try {
-        canonicalPath = await realpath6(absolutePath);
+        canonicalPath = await realpath8(absolutePath);
       } catch (cause) {
         error({
           code: "PUSH_FILE_CHANGED",
@@ -7067,7 +7253,7 @@ async function assertCapturedConfigStable(options) {
   }
   let current;
   try {
-    const path = join19(options.projectRoot, options.filename);
+    const path = join20(options.projectRoot, options.filename);
     const entry2 = await lstat12(path);
     if (!entry2.isFile() || entry2.isSymbolicLink()) {
       error({
@@ -7113,7 +7299,7 @@ async function createPushPreflight(options) {
   parseCapturedProject(initialAgentEntry);
   let initialDataEntry;
   try {
-    await lstat12(join19(projectRoot, DATA_ACCESS_FILENAME));
+    await lstat12(join20(projectRoot, DATA_ACCESS_FILENAME));
     initialDataEntry = await captureConfigWithinLimit(projectRoot, limits.maxFileBytes, DATA_ACCESS_FILENAME);
   } catch (cause) {
     if (cause.code !== "ENOENT") throw cause;
@@ -7215,8 +7401,8 @@ async function createPushPreflight(options) {
 
 // packages/cli-core/src/push/bundle.ts
 import { createHash as createHash11 } from "node:crypto";
-import { lstat as lstat13, readFile as readFile17, realpath as realpath7 } from "node:fs/promises";
-import { join as join20, relative as relative3, sep as sep3, win32 as win324 } from "node:path";
+import { lstat as lstat13, readFile as readFile18, realpath as realpath9 } from "node:fs/promises";
+import { join as join21, relative as relative3, sep as sep3, win32 as win324 } from "node:path";
 import { Writable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { createGzip } from "node:zlib";
@@ -7238,15 +7424,15 @@ function inside(root, target) {
   return path === "" || path !== ".." && !path.startsWith(`..${sep3}`) && !path.startsWith("/") && !win324.isAbsolute(path);
 }
 async function capture(root, file) {
-  const absolute = join20(root, ...file.path.split("/"));
+  const absolute = join21(root, ...file.path.split("/"));
   try {
     const entry2 = await lstat13(absolute);
     if (!entry2.isFile() || entry2.isSymbolicLink() || entry2.size !== file.bytes) {
       changed(file.path, `\u63D0\u4EA4\u524D\u6587\u4EF6\u53D1\u751F\u53D8\u5316\uFF1A${file.path}`);
     }
-    const canonical = await realpath7(absolute);
+    const canonical = await realpath9(absolute);
     if (!inside(root, canonical)) changed(file.path, `\u63D0\u4EA4\u6587\u4EF6\u8D8A\u8FC7\u9879\u76EE\u6839\u76EE\u5F55\uFF1A${file.path}`);
-    const contents = await readFile17(absolute);
+    const contents = await readFile18(absolute);
     if (contents.byteLength !== file.bytes || digest3(contents) !== file.digest) {
       changed(file.path, `\u63D0\u4EA4\u524D\u6587\u4EF6\u5185\u5BB9\u53D1\u751F\u53D8\u5316\uFF1A${file.path}`);
     }
@@ -7262,7 +7448,7 @@ async function capture(root, file) {
   }
 }
 async function createPushSourceBundle(plan) {
-  const canonicalRoot = await realpath7(plan.projectRoot).catch((cause) => changed(plan.projectRoot, "\u63D0\u4EA4\u9879\u76EE\u76EE\u5F55\u5728\u6253\u5305\u524D\u5DF2\u4E0D\u53EF\u7528", cause));
+  const canonicalRoot = await realpath9(plan.projectRoot).catch((cause) => changed(plan.projectRoot, "\u63D0\u4EA4\u9879\u76EE\u76EE\u5F55\u5728\u6253\u5305\u524D\u5DF2\u4E0D\u53EF\u7528", cause));
   if (canonicalRoot !== plan.projectRoot) {
     changed(plan.projectRoot, "\u63D0\u4EA4\u9879\u76EE\u6839\u76EE\u5F55\u5728\u9884\u68C0\u540E\u53D1\u751F\u53D8\u5316");
   }
@@ -7339,7 +7525,7 @@ var MODE_ROUTES = [
   ["direct", NEW_AGENT_CHOICES[0]],
   ["create", NEW_AGENT_CHOICES[1]]
 ];
-function failure(message, io, includeHelp = false) {
+function failure2(message, io, includeHelp = false) {
   io.writeError(`buddy-cli: ${message}`);
   if (includeHelp) io.write("\u67E5\u770B\u7528\u6CD5\uFF1Abuddy-cli --help\uFF1B\u53C2\u6570\u8BF4\u660E\uFF1Abuddy-cli <\u547D\u4EE4> --help\uFF1B\u5F00\u53D1\u6307\u5F15\uFF1Abuddy-cli guide\u3002");
   return { exitCode: 2 };
@@ -7653,7 +7839,7 @@ async function resumeProjectArguments(args, cwd, options, io) {
   await assertInitializableBuddyTarget(root);
   let entry2;
   try {
-    entry2 = await lstat14(join21(root, "package.json"));
+    entry2 = await lstat14(join22(root, "package.json"));
   } catch (cause) {
     if (cause.code === "ENOENT") {
       const draft = await readMetaDraft(root);
@@ -7725,13 +7911,13 @@ async function runBuddyCli(args, io, options = {}) {
     if (command === "guide") {
       if (rest.length === 0) io.write(AGENT_GUIDE);
       else if (rest.length === 1 && (rest[0] === "--help" || rest[0] === "-h")) io.write(GUIDE_HELP);
-      else return failure("guide \u4E0D\u63A5\u53D7\u5176\u4ED6\u53C2\u6570\uFF1B\u7528 buddy-cli guide --help \u67E5\u770B\u7528\u6CD5", io);
+      else return failure2("guide \u4E0D\u63A5\u53D7\u5176\u4ED6\u53C2\u6570\uFF1B\u7528 buddy-cli guide --help \u67E5\u770B\u7528\u6CD5", io);
       return { exitCode: 0 };
     }
     if (command === "models") return await runModelsCommand(rest, io, options.cwd ?? process.cwd(), options.runtimeCatalog);
     if (command === "knowledge") return await runKnowledgeCommand(rest, io, options.cwd ?? process.cwd());
     if (command === "preview") {
-      return options.preview?.(rest, io) ?? failure("preview \u5BBF\u4E3B\u672A\u914D\u7F6E", io, true);
+      return options.preview?.(rest, io) ?? failure2("preview \u5BBF\u4E3B\u672A\u914D\u7F6E", io, true);
     }
     if (command === "datasets") {
       return await runDatasetsCommand(rest, io, options.cwd ?? process.cwd(), options.runtimeCatalog);
@@ -7773,14 +7959,14 @@ async function runBuddyCli(args, io, options = {}) {
       route ??= await chooseEntryRoute(io);
       return await runRoute(route, parsed, io, options);
     }
-    return failure(`\u672A\u77E5\u547D\u4EE4 ${command}`, io, true);
+    return failure2(`\u672A\u77E5\u547D\u4EE4 ${command}`, io, true);
   } catch (cause) {
     if (cause instanceof PromptCancelledError) {
       io.writeError("\u5DF2\u53D6\u6D88\uFF1B\u5DF2\u4FDD\u5B58\u7684\u672C\u5730\u8349\u7A3F\u548C\u5DF2\u6709\u642D\u5B50\u8D44\u6599\u4F1A\u4FDD\u7559\uFF0C\u672A\u786E\u8BA4\u7684\u8D44\u6599\u4E0D\u4F1A\u767B\u8BB0\u3002");
       return { exitCode: 130 };
     }
     if (cause instanceof MetaPreparationError || cause instanceof CliUsageError || cause instanceof BuddyConfigValidationError || cause instanceof ProjectInitializationError || cause instanceof BuddyProjectContextError || cause instanceof CloudLifecycleError) {
-      return failure(cause.message, io, cause instanceof CliUsageError);
+      return failure2(cause.message, io, cause instanceof CliUsageError);
     }
     throw cause;
   }
@@ -7943,6 +8129,7 @@ export {
   serializeBuddyAgentConfig,
   serializeBuddyDraftConfig,
   startBuddyDev,
+  stopLocalDev,
   throwIfDevAborted,
   validateBuddyAgentConfig,
   validateBuddyConfig,