@clawos-dev/clawd 0.2.121 → 0.2.122-beta.241.0e144f4

package/dist/cli.cjs

@@ -202,7 +202,16 @@ var init_methods = __esm({
       "appBuilder:reportStage",
       // 显式控制 fix (spec 2026-06-02-app-builder-explicit-dev-server-control)：用户点"收起预览"按钮触发，
       // 对称 startDevServer。砍掉了 setActiveSession（dev server 不再跟用户 focus 走），切 session 不动 dev server。
-      "appBuilder:stopDevServer"
+      "appBuilder:stopDevServer",
+      // 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design)：
+      //   publish：PreviewPane「发布上线」按钮 onClick 调本 RPC，daemon 内串行化 + spawn publish.sh +
+      //            广播阶段进度帧 (appBuilder:publish-progress / publish-failed)。同 project 已有 in-flight job
+      //            返回 already-publishing + 既有 jobId（UI 不报错继续订阅）。失败时 daemon 调 manager.send()
+      //            注入 user_text 到 chat，由 assistant 接管完成部署。
+      //   dismissPublishJob：取消 in-flight publish（SIGTERM 子进程 + 清字段）或清掉 daemon 崩溃留下的
+      //            中断残骸 publishJob 字段。UI 端 [取消] / [interrupted 取消] 都走这个 RPC。
+      "appBuilder:publish",
+      "appBuilder:dismissPublishJob"
     ];
   }
 });
@@ -4548,7 +4557,7 @@ var init_persona_schemas = __esm({
 });
 
 // ../protocol/src/schemas.ts
-var SessionStatusSchema, UsageSchema, ContextUsageSchema, sessionMetaShape, SessionMetaSchema, ModelInfoSchema, ModeInfoSchema, ConfigFieldSchemaSchema, CapabilitiesGetArgs, CapabilitiesResponseSchema, AllowRuleSchema, SessionFileSchema, ParsedEventBase, HistoryUserMetaSchema, SubagentToolStatsSchema, StructuredPatchHunkSchema, ToolResultExtraSchema, MemoryEntrySchema, AskQuestionOptionSchema, AskQuestionItemSchema, ParsedEventSchema, SessionCreateArgs, SessionIdArgs, SessionUpdateArgs, SessionSendArgs, SessionRewindArgs, SessionRewindResponseSchema, SessionRewindDiffArgs, RewindDiffHunkSchema, RewindDiffFileSchema, SessionRewindDiffResponseSchema, SessionRewindableMessageIdsArgs, SessionRewindableMessageIdsResponseSchema, SessionResumeArgs, SessionForkArgs, SessionForkResponseSchema, SessionObserveArgs, SessionEventsArgs, PermissionRespondArgs, HistoryListArgs, HistoryReadArgs, HistorySubagentsArgs, HistorySubagentReadArgs, WorkspaceListArgs, WorkspaceReadArgs, SkillsListArgs, SkillEntrySchema, AgentEntrySchema, AgentsListArgs, AgentsListResponseSchema, SessionSubscribeArgs, SessionPinArgs, PeerSessionUpsertArgs, PeerSessionUpsertResponseSchema, PeerSessionRemoveArgs, PeerSessionRemoveResponseSchema, SessionReorderPinsArgs, GitRootArgs, GitRootResponseSchema, GitBranchArgs, GitBranchResponseSchema, GitBranchesArgs, GitBranchesResponseSchema, HistoryRecentDirsArgs, RecentDirEntrySchema, HistoryRecentDirsResponseSchema, SessionQuestionFrameSchema, SessionQuestionClearedFrameSchema, AnswerQuestionArgs, AnswerQuestionResponseSchema, CancelQuestionArgs, CancelQuestionResponseSchema, AuthRequestFrameSchema, AuthOkFrameSchema, TunnelReadyEventSchema, TunnelExitedEventSchema, TunnelUnavailableEventSchema, InfoRunningSessionSchema, InfoResponseSchema, PROJECT_PORT_MIN, PROJECT_PORT_MAX, projectNameRegex, DEFAULT_DEV_COMMAND, ProjectMetadataSchema, PROJECT_STAGE_VALUES, ProjectStageSchema, ProjectWithStatusSchema, ListProjectsArgsSchema, ListProjectsResultSchema, CreateProjectArgsSchema, CreateProjectResultSchema, DeleteProjectArgsSchema, DeleteProjectResultSchema, UpdateProjectPortArgsSchema, UpdateProjectPortResultSchema, SetProdUrlArgsSchema, SetProdUrlResultSchema, StartDevServerArgsSchema, StartDevServerResultSchema, ASSISTANT_REPORTABLE_STAGES, ReportStageArgsSchema, ReportStageResultSchema, StopDevServerArgsSchema, StopDevServerResultSchema, AppBuilderProjectUpdatedEventSchema;
+var SessionStatusSchema, UsageSchema, ContextUsageSchema, sessionMetaShape, SessionMetaSchema, ModelInfoSchema, ModeInfoSchema, ConfigFieldSchemaSchema, CapabilitiesGetArgs, CapabilitiesResponseSchema, AllowRuleSchema, SessionFileSchema, ParsedEventBase, HistoryUserMetaSchema, SubagentToolStatsSchema, StructuredPatchHunkSchema, ToolResultExtraSchema, MemoryEntrySchema, AskQuestionOptionSchema, AskQuestionItemSchema, ParsedEventSchema, SessionCreateArgs, SessionIdArgs, SessionUpdateArgs, SessionSendArgs, SessionRewindArgs, SessionRewindResponseSchema, SessionRewindDiffArgs, RewindDiffHunkSchema, RewindDiffFileSchema, SessionRewindDiffResponseSchema, SessionRewindableMessageIdsArgs, SessionRewindableMessageIdsResponseSchema, SessionResumeArgs, SessionForkArgs, SessionForkResponseSchema, SessionObserveArgs, SessionEventsArgs, PermissionRespondArgs, HistoryListArgs, HistoryReadArgs, HistorySubagentsArgs, HistorySubagentReadArgs, WorkspaceListArgs, WorkspaceReadArgs, SkillsListArgs, SkillEntrySchema, AgentEntrySchema, AgentsListArgs, AgentsListResponseSchema, SessionSubscribeArgs, SessionPinArgs, PeerSessionUpsertArgs, PeerSessionUpsertResponseSchema, PeerSessionRemoveArgs, PeerSessionRemoveResponseSchema, SessionReorderPinsArgs, GitRootArgs, GitRootResponseSchema, GitBranchArgs, GitBranchResponseSchema, GitBranchesArgs, GitBranchesResponseSchema, HistoryRecentDirsArgs, RecentDirEntrySchema, HistoryRecentDirsResponseSchema, SessionQuestionFrameSchema, SessionQuestionClearedFrameSchema, AnswerQuestionArgs, AnswerQuestionResponseSchema, CancelQuestionArgs, CancelQuestionResponseSchema, AuthRequestFrameSchema, AuthOkFrameSchema, TunnelReadyEventSchema, TunnelExitedEventSchema, TunnelUnavailableEventSchema, InfoRunningSessionSchema, InfoResponseSchema, PROJECT_PORT_MIN, PROJECT_PORT_MAX, projectNameRegex, DEFAULT_DEV_COMMAND, ProjectMetadataSchema, PROJECT_STAGE_VALUES, ProjectStageSchema, ProjectWithStatusSchema, ListProjectsArgsSchema, ListProjectsResultSchema, CreateProjectArgsSchema, CreateProjectResultSchema, DeleteProjectArgsSchema, DeleteProjectResultSchema, UpdateProjectPortArgsSchema, UpdateProjectPortResultSchema, SetProdUrlArgsSchema, SetProdUrlResultSchema, StartDevServerArgsSchema, StartDevServerResultSchema, ASSISTANT_REPORTABLE_STAGES, ReportStageArgsSchema, ReportStageResultSchema, StopDevServerArgsSchema, StopDevServerResultSchema, AppBuilderProjectUpdatedEventSchema, PublishArgsSchema, PublishResultSchema, DismissPublishJobArgsSchema, DismissPublishJobResultSchema, AppBuilderPublishProgressEventSchema, AppBuilderPublishFailedEventSchema;
 var init_schemas = __esm({
   "../protocol/src/schemas.ts"() {
     "use strict";
@@ -5225,7 +5234,22 @@ var init_schemas = __esm({
        * optional：缺省时 supervisor 用默认 /Local:\s+https?:\/\//（vite "Local: http://..." 输出）。
        * 老板换非 vite 技术栈（Next.js "Ready in"、webpack "Compiled" 等）时自定义这个字段。
        */
-      readyPattern: external_exports.string().optional()
+      readyPattern: external_exports.string().optional(),
+      /**
+       * 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design §5.1.4)：
+       * in-flight 发布 job 的元数据。仅承载"in-flight"或"中断残骸"两种状态：
+       *   - daemon spawn publish.sh + 收到第一个 ::stage::build marker 时写入
+       *   - 每次 stage 切换更新 stage 字段
+       *   - 成功 / 正常失败 / 用户 dismiss 时立即清掉
+       *   - 只有 daemon 崩才会留残骸（子进程随 daemon 一起死）
+       * status 字段在 ProjectWithStatus 派生而不在这里 —— 本 schema 是落盘形态，
+       * "in-flight vs interrupted" 区分由 daemon 响应时实时拼 registry 状态得出。
+       */
+      publishJob: external_exports.object({
+        jobId: external_exports.string().min(1),
+        stage: external_exports.enum(["build", "deploy", "verify"]),
+        startedAt: external_exports.number().int().nonnegative()
+      }).optional()
     });
     PROJECT_STAGE_VALUES = [
       "install-pending",
@@ -5252,7 +5276,21 @@ var init_schemas = __esm({
        */
       stage: ProjectStageSchema.optional(),
       /** stage='failed' 时携带失败原因 */
-      stageReason: external_exports.string().optional()
+      stageReason: external_exports.string().optional(),
+      /**
+       * 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design §5.1.3)：
+       * ProjectMetadata.publishJob 的 status 派生版。daemon 响应时按以下规则实时拼装：
+       *   - 落盘字段存在 + PublishJobRegistry 有匹配 jobId → 'in-flight'
+       *   - 落盘字段存在 + Registry 无匹配（jobId 对不上或 entry 缺失）→ 'interrupted'（daemon 崩残骸）
+       *   - 落盘字段不存在 → undefined（字段省略）
+       * UI 用 status 决定 PreviewPane 渲染分支（in-flight 三段 checklist / interrupted 恢复条）。
+       */
+      publishJob: external_exports.object({
+        jobId: external_exports.string().min(1),
+        stage: external_exports.enum(["build", "deploy", "verify"]),
+        startedAt: external_exports.number().int().nonnegative(),
+        status: external_exports.enum(["in-flight", "interrupted"])
+      }).optional()
     });
     ListProjectsArgsSchema = external_exports.object({}).strict();
     ListProjectsResultSchema = external_exports.object({
@@ -5317,6 +5355,33 @@ var init_schemas = __esm({
       /** stage='failed' 时的失败原因 */
       stageReason: external_exports.string().optional()
     }).strict();
+    PublishArgsSchema = external_exports.object({
+      name: external_exports.string().regex(projectNameRegex)
+    });
+    PublishResultSchema = external_exports.object({
+      jobId: external_exports.string().min(1),
+      status: external_exports.enum(["started", "already-publishing"])
+    }).strict();
+    DismissPublishJobArgsSchema = external_exports.object({
+      name: external_exports.string().regex(projectNameRegex)
+    });
+    DismissPublishJobResultSchema = external_exports.object({
+      ok: external_exports.literal(true)
+    }).strict();
+    AppBuilderPublishProgressEventSchema = external_exports.object({
+      type: external_exports.literal("appBuilder:publish-progress"),
+      name: external_exports.string().regex(projectNameRegex),
+      jobId: external_exports.string().min(1),
+      stage: external_exports.enum(["build", "deploy", "verify"]),
+      status: external_exports.enum(["started", "completed"])
+    }).strict();
+    AppBuilderPublishFailedEventSchema = external_exports.object({
+      type: external_exports.literal("appBuilder:publish-failed"),
+      name: external_exports.string().regex(projectNameRegex),
+      jobId: external_exports.string().min(1),
+      stage: external_exports.enum(["build", "deploy", "verify", "unknown"]),
+      errorSummary: external_exports.string()
+    }).strict();
   }
 });
 
@@ -7746,7 +7811,7 @@ var require_thread_stream = __commonJS({
     var { version: version2 } = require_package();
     var { EventEmitter: EventEmitter3 } = require("events");
     var { Worker } = require("worker_threads");
-    var { join: join12 } = require("path");
+    var { join: join14 } = require("path");
     var { pathToFileURL } = require("url");
     var { wait } = require_wait();
     var {
@@ -7782,7 +7847,7 @@ var require_thread_stream = __commonJS({
     function createWorker(stream, opts) {
       const { filename, workerData } = opts;
       const bundlerOverrides = "__bundlerPathsOverrides" in globalThis ? globalThis.__bundlerPathsOverrides : {};
-      const toExecute = bundlerOverrides["thread-stream-worker"] || join12(__dirname, "lib", "worker.js");
+      const toExecute = bundlerOverrides["thread-stream-worker"] || join14(__dirname, "lib", "worker.js");
       const worker = new Worker(toExecute, {
         ...opts.workerOpts,
         trackUnmanagedFds: false,
@@ -8168,7 +8233,7 @@ var require_transport = __commonJS({
     "use strict";
     var { createRequire } = require("module");
     var getCallers = require_caller();
-    var { join: join12, isAbsolute: isAbsolute2, sep: sep3 } = require("path");
+    var { join: join14, isAbsolute: isAbsolute2, sep: sep3 } = require("path");
     var sleep = require_atomic_sleep();
     var onExit = require_on_exit_leak_free();
     var ThreadStream = require_thread_stream();
@@ -8231,7 +8296,7 @@ var require_transport = __commonJS({
         throw new Error("only one of target or targets can be specified");
       }
       if (targets) {
-        target = bundlerOverrides["pino-worker"] || join12(__dirname, "worker.js");
+        target = bundlerOverrides["pino-worker"] || join14(__dirname, "worker.js");
         options.targets = targets.filter((dest) => dest.target).map((dest) => {
           return {
             ...dest,
@@ -8249,7 +8314,7 @@ var require_transport = __commonJS({
           });
         });
       } else if (pipeline3) {
-        target = bundlerOverrides["pino-worker"] || join12(__dirname, "worker.js");
+        target = bundlerOverrides["pino-worker"] || join14(__dirname, "worker.js");
         options.pipelines = [pipeline3.map((dest) => {
           return {
             ...dest,
@@ -8271,7 +8336,7 @@ var require_transport = __commonJS({
           return origin;
         }
         if (origin === "pino/file") {
-          return join12(__dirname, "..", "file.js");
+          return join14(__dirname, "..", "file.js");
         }
         let fixTarget2;
         for (const filePath of callers) {
@@ -9261,7 +9326,7 @@ var require_safe_stable_stringify = __commonJS({
               return circularValue;
             }
             let res = "";
-            let join12 = ",";
+            let join14 = ",";
             const originalIndentation = indentation;
             if (Array.isArray(value)) {
               if (value.length === 0) {
@@ -9275,7 +9340,7 @@ var require_safe_stable_stringify = __commonJS({
                 indentation += spacer;
                 res += `
 ${indentation}`;
-                join12 = `,
+                join14 = `,
 ${indentation}`;
               }
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -9283,13 +9348,13 @@ ${indentation}`;
               for (; i < maximumValuesToStringify - 1; i++) {
                 const tmp2 = stringifyFnReplacer(String(i), value, stack, replacer, spacer, indentation);
                 res += tmp2 !== void 0 ? tmp2 : "null";
-                res += join12;
+                res += join14;
               }
               const tmp = stringifyFnReplacer(String(i), value, stack, replacer, spacer, indentation);
               res += tmp !== void 0 ? tmp : "null";
               if (value.length - 1 > maximumBreadth) {
                 const removedKeys = value.length - maximumBreadth - 1;
-                res += `${join12}"... ${getItemCount(removedKeys)} not stringified"`;
+                res += `${join14}"... ${getItemCount(removedKeys)} not stringified"`;
               }
               if (spacer !== "") {
                 res += `
@@ -9310,7 +9375,7 @@ ${originalIndentation}`;
             let separator = "";
             if (spacer !== "") {
               indentation += spacer;
-              join12 = `,
+              join14 = `,
 ${indentation}`;
               whitespace = " ";
             }
@@ -9324,13 +9389,13 @@ ${indentation}`;
               const tmp = stringifyFnReplacer(key2, value, stack, replacer, spacer, indentation);
               if (tmp !== void 0) {
                 res += `${separator}${strEscape(key2)}:${whitespace}${tmp}`;
-                separator = join12;
+                separator = join14;
               }
             }
             if (keyLength > maximumBreadth) {
               const removedKeys = keyLength - maximumBreadth;
               res += `${separator}"...":${whitespace}"${getItemCount(removedKeys)} not stringified"`;
-              separator = join12;
+              separator = join14;
             }
             if (spacer !== "" && separator.length > 1) {
               res = `
@@ -9371,7 +9436,7 @@ ${originalIndentation}`;
             }
             const originalIndentation = indentation;
             let res = "";
-            let join12 = ",";
+            let join14 = ",";
             if (Array.isArray(value)) {
               if (value.length === 0) {
                 return "[]";
@@ -9384,7 +9449,7 @@ ${originalIndentation}`;
                 indentation += spacer;
                 res += `
 ${indentation}`;
-                join12 = `,
+                join14 = `,
 ${indentation}`;
               }
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -9392,13 +9457,13 @@ ${indentation}`;
               for (; i < maximumValuesToStringify - 1; i++) {
                 const tmp2 = stringifyArrayReplacer(String(i), value[i], stack, replacer, spacer, indentation);
                 res += tmp2 !== void 0 ? tmp2 : "null";
-                res += join12;
+                res += join14;
               }
               const tmp = stringifyArrayReplacer(String(i), value[i], stack, replacer, spacer, indentation);
               res += tmp !== void 0 ? tmp : "null";
               if (value.length - 1 > maximumBreadth) {
                 const removedKeys = value.length - maximumBreadth - 1;
-                res += `${join12}"... ${getItemCount(removedKeys)} not stringified"`;
+                res += `${join14}"... ${getItemCount(removedKeys)} not stringified"`;
               }
               if (spacer !== "") {
                 res += `
@@ -9411,7 +9476,7 @@ ${originalIndentation}`;
             let whitespace = "";
             if (spacer !== "") {
               indentation += spacer;
-              join12 = `,
+              join14 = `,
 ${indentation}`;
               whitespace = " ";
             }
@@ -9420,7 +9485,7 @@ ${indentation}`;
               const tmp = stringifyArrayReplacer(key2, value[key2], stack, replacer, spacer, indentation);
               if (tmp !== void 0) {
                 res += `${separator}${strEscape(key2)}:${whitespace}${tmp}`;
-                separator = join12;
+                separator = join14;
               }
             }
             if (spacer !== "" && separator.length > 1) {
@@ -9478,20 +9543,20 @@ ${originalIndentation}`;
               indentation += spacer;
               let res2 = `
 ${indentation}`;
-              const join13 = `,
+              const join15 = `,
 ${indentation}`;
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
               let i = 0;
               for (; i < maximumValuesToStringify - 1; i++) {
                 const tmp2 = stringifyIndent(String(i), value[i], stack, spacer, indentation);
                 res2 += tmp2 !== void 0 ? tmp2 : "null";
-                res2 += join13;
+                res2 += join15;
               }
               const tmp = stringifyIndent(String(i), value[i], stack, spacer, indentation);
               res2 += tmp !== void 0 ? tmp : "null";
               if (value.length - 1 > maximumBreadth) {
                 const removedKeys = value.length - maximumBreadth - 1;
-                res2 += `${join13}"... ${getItemCount(removedKeys)} not stringified"`;
+                res2 += `${join15}"... ${getItemCount(removedKeys)} not stringified"`;
               }
               res2 += `
 ${originalIndentation}`;
@@ -9507,16 +9572,16 @@ ${originalIndentation}`;
               return '"[Object]"';
             }
             indentation += spacer;
-            const join12 = `,
+            const join14 = `,
 ${indentation}`;
             let res = "";
             let separator = "";
             let maximumPropertiesToStringify = Math.min(keyLength, maximumBreadth);
             if (isTypedArrayWithEntries(value)) {
-              res += stringifyTypedArray(value, join12, maximumBreadth);
+              res += stringifyTypedArray(value, join14, maximumBreadth);
               keys = keys.slice(value.length);
               maximumPropertiesToStringify -= value.length;
-              separator = join12;
+              separator = join14;
             }
             if (deterministic) {
               keys = sort(keys, comparator);
@@ -9527,13 +9592,13 @@ ${indentation}`;
               const tmp = stringifyIndent(key2, value[key2], stack, spacer, indentation);
               if (tmp !== void 0) {
                 res += `${separator}${strEscape(key2)}: ${tmp}`;
-                separator = join12;
+                separator = join14;
               }
             }
             if (keyLength > maximumBreadth) {
               const removedKeys = keyLength - maximumBreadth;
               res += `${separator}"...": "${getItemCount(removedKeys)} not stringified"`;
-              separator = join12;
+              separator = join14;
             }
             if (separator !== "") {
               res = `
@@ -21120,7 +21185,7 @@ var require_BufferList = __commonJS({
         this.head = this.tail = null;
         this.length = 0;
       };
-      BufferList.prototype.join = function join12(s) {
+      BufferList.prototype.join = function join14(s) {
         if (this.length === 0) return "";
         var p2 = this.head;
         var ret = "" + p2.data;
@@ -30577,7 +30642,7 @@ var require_lib3 = __commonJS({
 // src/run-case/recorder.ts
 function startRunCaseRecorder(opts) {
   const now = opts.now ?? Date.now;
-  const dir = import_node_path46.default.dirname(opts.recordPath);
+  const dir = import_node_path48.default.dirname(opts.recordPath);
   let stream = null;
   let closing = false;
   let closedSettled = false;
@@ -30591,8 +30656,8 @@ function startRunCaseRecorder(opts) {
   });
   const ensureStream = () => {
     if (stream) return stream;
-    import_node_fs31.default.mkdirSync(dir, { recursive: true });
-    stream = import_node_fs31.default.createWriteStream(opts.recordPath, { flags: "a" });
+    import_node_fs32.default.mkdirSync(dir, { recursive: true });
+    stream = import_node_fs32.default.createWriteStream(opts.recordPath, { flags: "a" });
     stream.on("close", () => closedResolve());
     return stream;
   };
@@ -30617,12 +30682,12 @@ function startRunCaseRecorder(opts) {
   };
   return { tap, close, closed };
 }
-var import_node_fs31, import_node_path46;
+var import_node_fs32, import_node_path48;
 var init_recorder = __esm({
   "src/run-case/recorder.ts"() {
     "use strict";
-    import_node_fs31 = __toESM(require("fs"), 1);
-    import_node_path46 = __toESM(require("path"), 1);
+    import_node_fs32 = __toESM(require("fs"), 1);
+    import_node_path48 = __toESM(require("path"), 1);
   }
 });
 
@@ -30665,7 +30730,7 @@ var init_wire = __esm({
 // src/run-case/controller.ts
 async function runController(opts) {
   const now = opts.now ?? Date.now;
-  const cwd = opts.cwd ?? (0, import_node_fs32.mkdtempSync)(import_node_path47.default.join(import_node_os19.default.tmpdir(), "clawd-runcase-"));
+  const cwd = opts.cwd ?? (0, import_node_fs33.mkdtempSync)(import_node_path49.default.join(import_node_os19.default.tmpdir(), "clawd-runcase-"));
   const ownsCwd = opts.cwd === void 0;
   const recorder = startRunCaseRecorder({ recordPath: opts.record, now });
   const spawnCtx = { cwd };
@@ -30826,19 +30891,19 @@ async function runController(opts) {
   if (sigintHandler) process.off("SIGINT", sigintHandler);
   if (ownsCwd) {
     try {
-      (0, import_node_fs32.rmSync)(cwd, { recursive: true, force: true });
+      (0, import_node_fs33.rmSync)(cwd, { recursive: true, force: true });
     } catch {
     }
   }
   return exitCode ?? 0;
 }
-var import_node_fs32, import_node_os19, import_node_path47;
+var import_node_fs33, import_node_os19, import_node_path49;
 var init_controller = __esm({
   "src/run-case/controller.ts"() {
     "use strict";
-    import_node_fs32 = require("fs");
+    import_node_fs33 = require("fs");
     import_node_os19 = __toESM(require("os"), 1);
-    import_node_path47 = __toESM(require("path"), 1);
+    import_node_path49 = __toESM(require("path"), 1);
     init_claude();
     init_stdout_splitter();
     init_permission_stdio();
@@ -31073,8 +31138,8 @@ Env (advanced):
 `;
 
 // src/index.ts
-var import_node_path45 = __toESM(require("path"), 1);
-var import_node_fs30 = __toESM(require("fs"), 1);
+var import_node_path47 = __toESM(require("path"), 1);
+var import_node_fs31 = __toESM(require("fs"), 1);
 
 // src/logger.ts
 var import_node_fs2 = __toESM(require("fs"), 1);
@@ -32881,6 +32946,14 @@ var SessionManager = class {
   // guest sessions 由 handlers/session.ts list 处按 ctx.principal.kind === 'guest' 做权限过滤
   // (creatorPrincipalId === capId), 这里仅负责数据源汇总.
   // listener sub-session 不走这条（listener 走 persona:listSubSessions RPC 单独入口）。
+  /**
+   * 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design §5.2.2)：
+   * 反查绑定到指定 app-builder project 的 session。按 invariant "1 Session ↔ 1 Project"
+   * 应当唯一；找不到 → undefined（项目已成孤儿）。
+   */
+  findOwnedSessionByAppBuilderProject(projectName) {
+    return this.listAllOwned().find((file) => file.appBuilderProject === projectName);
+  }
   listAllOwned() {
     const out = [];
     out.push(...this.deps.store.list());
@@ -34853,6 +34926,34 @@ function copyBundleExtras(srcDir, dstDir) {
     }
   }
 }
+var DAEMON_MANAGED_DIRS = ["extension-kit"];
+function refreshDaemonManagedDirs(args) {
+  const entries = args.entries ?? DEFAULT_PERSONAS;
+  for (const entry of entries) {
+    const bundleDir = path11.join(args.defaultsRoot, entry.personaId);
+    if (!fs9.existsSync(bundleDir)) continue;
+    const personaDir = args.store.personaDirPath(entry.personaId);
+    if (!fs9.existsSync(personaDir)) continue;
+    for (const subdir of DAEMON_MANAGED_DIRS) {
+      const srcPath = path11.join(bundleDir, subdir);
+      if (!fs9.existsSync(srcPath)) continue;
+      const dstPath = path11.join(personaDir, subdir);
+      try {
+        fs9.cpSync(srcPath, dstPath, { recursive: true, force: true, dereference: true });
+        args.logger.info("persona.refresh.synced", {
+          personaId: entry.personaId,
+          subdir
+        });
+      } catch (err) {
+        args.logger.warn("persona.refresh.failed", {
+          personaId: entry.personaId,
+          subdir,
+          error: err instanceof Error ? err.message : String(err)
+        });
+      }
+    }
+  }
+}
 
 // src/index.ts
 init_claude();
@@ -41713,12 +41814,373 @@ function listPidsOnPort(port) {
   });
 }
 
+// src/app-builder/publish-registry.ts
+var import_node_crypto14 = require("crypto");
+var PublishJobRegistry = class {
+  jobs = /* @__PURE__ */ new Map();
+  has(name) {
+    return this.jobs.has(name);
+  }
+  get(name) {
+    return this.jobs.get(name);
+  }
+  /**
+   * args.jobId 仅用于测试注入；生产代码不传，registry 自己生成。
+   * args.now 仅用于测试注入；生产代码不传，用 Date.now()。
+   */
+  create(args) {
+    if (this.jobs.has(args.name)) {
+      throw new Error(`already publishing: ${args.name}`);
+    }
+    const jobId = args.jobId ?? `job-${(0, import_node_crypto14.randomUUID)()}`;
+    this.jobs.set(args.name, {
+      jobId,
+      name: args.name,
+      stage: "build",
+      sessionId: args.sessionId,
+      childProc: args.childProc,
+      dismissed: false,
+      sawAnyStage: false,
+      startedAt: args.now ?? Date.now()
+    });
+    return jobId;
+  }
+  updateStage(name, stage) {
+    const job = this.jobs.get(name);
+    if (!job) return;
+    job.stage = stage;
+    job.sawAnyStage = true;
+  }
+  markDismissed(name) {
+    const job = this.jobs.get(name);
+    if (!job) return;
+    job.dismissed = true;
+  }
+  remove(name) {
+    const job = this.jobs.get(name);
+    if (!job) return void 0;
+    this.jobs.delete(name);
+    return { sessionId: job.sessionId };
+  }
+};
+
+// src/app-builder/publish-job-runner.ts
+var import_node_child_process8 = require("child_process");
+var import_node_fs29 = require("fs");
+var import_node_path39 = require("path");
+
+// src/app-builder/publish-stage-parser.ts
+var STAGE_RE = /^\s*::stage::(build|deploy|verify)\s*$/;
+var PROD_URL_RE = /^\s*::prod-url::(\S+)\s*$/;
+var URL_RE = /\bhttps?:\/\/[^\s]+/;
+function parsePublishLine(line) {
+  const stageMatch = STAGE_RE.exec(line);
+  if (stageMatch) return { kind: "stage", stage: stageMatch[1] };
+  const urlMatch = PROD_URL_RE.exec(line);
+  if (urlMatch) return { kind: "prod-url", url: urlMatch[1] };
+  return null;
+}
+function extractProdUrl(text) {
+  const m2 = URL_RE.exec(text);
+  return m2 ? m2[0] : null;
+}
+function tailStderrLines(buf, n) {
+  if (!buf) return "";
+  const lines = buf.split("\n");
+  if (lines.length <= n) return buf;
+  return lines.slice(lines.length - n).join("\n");
+}
+
+// src/app-builder/publish-job-runner.ts
+async function startPublishJob(deps, args) {
+  const { registry: registry2, projectDir } = deps;
+  const spawn9 = deps.spawnImpl ?? import_node_child_process8.spawn;
+  if (registry2.has(args.name)) {
+    return { jobId: registry2.get(args.name).jobId, status: "already-publishing" };
+  }
+  const projDir = projectDir(args.name);
+  const logPath = (0, import_node_path39.join)(projDir, ".publish.log");
+  let logStream = null;
+  try {
+    logStream = (0, import_node_fs29.createWriteStream)(logPath, { flags: "w" });
+  } catch {
+    logStream = null;
+  }
+  const child = spawn9("bash", [args.scriptPath, projDir], {
+    cwd: projDir,
+    env: process.env,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  const jobId = registry2.create({
+    name: args.name,
+    sessionId: args.sessionId,
+    childProc: child
+  });
+  deps.logger?.info("app-builder.publish.spawned", {
+    name: args.name,
+    jobId,
+    pid: child.pid ?? null,
+    scriptPath: args.scriptPath,
+    logPath
+  });
+  child.on("error", (err) => {
+    deps.logger?.warn("app-builder.publish.spawn-error", {
+      name: args.name,
+      jobId,
+      error: err instanceof Error ? err.message : String(err)
+    });
+    void handleExit(deps, {
+      name: args.name,
+      jobId,
+      code: null,
+      signal: null,
+      urlCandidate: null,
+      stderrTail: err instanceof Error ? err.message : String(err),
+      logPath
+    });
+  });
+  let urlFromMarker = null;
+  let urlFallback = null;
+  let stdoutBuf = "";
+  child.stdout?.on("data", (chunk) => {
+    if (logStream) logStream.write(chunk);
+    stdoutBuf += chunk.toString();
+    let nlIdx;
+    while ((nlIdx = stdoutBuf.indexOf("\n")) >= 0) {
+      const line = stdoutBuf.slice(0, nlIdx);
+      stdoutBuf = stdoutBuf.slice(nlIdx + 1);
+      handleStdoutLine(deps, args.name, jobId, line);
+      const parsedForUrl = parsePublishLine(line);
+      if (parsedForUrl?.kind === "prod-url") urlFromMarker = parsedForUrl.url;
+      const url = extractProdUrl(line);
+      if (url && !urlFallback) urlFallback = url;
+    }
+  });
+  let stderrBuf = "";
+  child.stderr?.on("data", (chunk) => {
+    if (logStream) logStream.write(chunk);
+    stderrBuf += chunk.toString();
+  });
+  child.on("exit", (code, signal) => {
+    if (logStream) logStream.end();
+    const urlCandidate = urlFromMarker ?? urlFallback;
+    deps.logger?.info("app-builder.publish.child-exit", {
+      name: args.name,
+      jobId,
+      code,
+      signal,
+      hadUrl: !!urlCandidate,
+      urlSource: urlFromMarker ? "marker" : urlFallback ? "fallback" : "none",
+      stderrBytes: stderrBuf.length
+    });
+    void handleExit(deps, {
+      name: args.name,
+      jobId,
+      code,
+      signal,
+      urlCandidate,
+      stderrTail: tailStderrLines(stderrBuf, 20),
+      logPath
+    });
+  });
+  return { jobId, status: "started" };
+}
+function handleStdoutLine(deps, name, jobId, line) {
+  const parsed = parsePublishLine(line);
+  if (parsed?.kind !== "stage") return;
+  advanceStage(deps, name, jobId, parsed.stage);
+}
+function advanceStage(deps, name, jobId, next) {
+  const job = deps.registry.get(name);
+  if (!job) return;
+  const prev = job.stage;
+  const wasFirstStage = !job.sawAnyStage;
+  deps.logger?.info("app-builder.publish.stage-advance", {
+    name,
+    jobId,
+    prev: wasFirstStage ? null : prev,
+    next,
+    firstStage: wasFirstStage
+  });
+  if (wasFirstStage) {
+    deps.registry.updateStage(name, next);
+    void deps.setPublishJob(name, {
+      jobId,
+      stage: next,
+      startedAt: job.startedAt
+    });
+    deps.broadcast({
+      type: "appBuilder:publish-progress",
+      name,
+      jobId,
+      stage: next,
+      status: "started"
+    });
+    return;
+  }
+  if (prev === next) {
+    return;
+  }
+  deps.broadcast({
+    type: "appBuilder:publish-progress",
+    name,
+    jobId,
+    stage: prev,
+    status: "completed"
+  });
+  deps.registry.updateStage(name, next);
+  void deps.setPublishJob(name, {
+    jobId,
+    stage: next,
+    startedAt: job.startedAt
+  });
+  deps.broadcast({
+    type: "appBuilder:publish-progress",
+    name,
+    jobId,
+    stage: next,
+    status: "started"
+  });
+}
+async function handleExit(deps, args) {
+  const job = deps.registry.get(args.name);
+  if (args.signal === "SIGTERM" && job?.dismissed) {
+    try {
+      await deps.clearPublishJob(args.name);
+    } catch (err) {
+      console.error("[publish] clearPublishJob failed (dismissed branch)", err);
+    }
+    deps.registry.remove(args.name);
+    return;
+  }
+  if (args.code === 0 && args.urlCandidate) {
+    if (job?.sawAnyStage) {
+      deps.broadcast({
+        type: "appBuilder:publish-progress",
+        name: args.name,
+        jobId: args.jobId,
+        stage: job.stage,
+        status: "completed"
+      });
+    }
+    try {
+      await deps.setProdUrl(args.name, args.urlCandidate);
+    } catch (err) {
+      console.error("[publish] setProdUrl failed; falling through to failure branch", err);
+      await emitFailure(deps, args, "\u8C03 setProdUrl \u5931\u8D25\uFF1A" + (err instanceof Error ? err.message : String(err)));
+      return;
+    }
+    try {
+      await deps.clearPublishJob(args.name);
+    } catch (err) {
+      console.error("[publish] clearPublishJob failed (success branch)", err);
+    }
+    deps.registry.remove(args.name);
+    return;
+  }
+  await emitFailure(deps, args, buildErrorSummary(args));
+}
+async function emitFailure(deps, args, errorSummary) {
+  const job = deps.registry.get(args.name);
+  const failStage = job?.sawAnyStage ? job.stage : "unknown";
+  deps.logger?.warn("app-builder.publish.failed", {
+    name: args.name,
+    jobId: args.jobId,
+    stage: failStage,
+    errorSummary: errorSummary.slice(0, 500)
+  });
+  try {
+    await deps.clearPublishJob(args.name);
+  } catch (err) {
+    deps.logger?.warn("app-builder.publish.clear-field-failed", {
+      name: args.name,
+      jobId: args.jobId,
+      error: err instanceof Error ? err.message : String(err)
+    });
+  }
+  const removed = deps.registry.remove(args.name);
+  deps.broadcast({
+    type: "appBuilder:publish-failed",
+    name: args.name,
+    jobId: args.jobId,
+    stage: failStage,
+    errorSummary
+  });
+  if (removed) {
+    const msg = formatFailureMessage(failStage, errorSummary, args.logPath);
+    try {
+      await deps.injectUserText(removed.sessionId, msg);
+      deps.logger?.info("app-builder.publish.failure-injected-to-chat", {
+        name: args.name,
+        jobId: args.jobId,
+        sessionId: removed.sessionId
+      });
+    } catch (err) {
+      deps.logger?.warn("app-builder.publish.inject-user-text-failed", {
+        name: args.name,
+        jobId: args.jobId,
+        sessionId: removed.sessionId,
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  } else {
+    deps.logger?.warn("app-builder.publish.no-registry-entry-on-failure", {
+      name: args.name,
+      jobId: args.jobId
+    });
+  }
+}
+function buildErrorSummary(args) {
+  if (args.signal) {
+    return `publish.sh \u88AB\u4E2D\u65AD\uFF08signal: ${args.signal}\uFF09`;
+  }
+  if (args.code === 0 && !args.urlCandidate) {
+    return "publish.sh \u6210\u529F\u9000\u51FA\u4F46\u672A\u8F93\u51FA\u516C\u7F51 URL";
+  }
+  return args.stderrTail || `publish.sh \u5F02\u5E38\u9000\u51FA\uFF08exit code: ${args.code}\uFF09`;
+}
+function formatFailureMessage(stage, errorSummary, logPath) {
+  return `\u53D1\u5E03\u5931\u8D25\uFF1A[${stage}] \u9636\u6BB5
+${errorSummary}
+
+\u5B8C\u6574\u65E5\u5FD7\uFF1A${logPath}
+\u8BF7\u4F60\u63A5\u7BA1\u5B8C\u6210\u672C\u6B21\u53D1\u5E03\uFF1A\u5148\u6839\u636E\u65E5\u5FD7\u4FEE\u590D\u95EE\u9898\uFF0C\u7136\u540E\u91CD\u8DD1 publish.sh \u76F4\u5230\u4E0A\u7EBF\u6210\u529F\uFF0C\u6700\u540E\u7528 appBuilder.setProdUrl \u5199\u5165\u516C\u7F51 URL\u3002`;
+}
+async function recoverInterruptedJobs(deps) {
+  const projects = await deps.listAllProjects();
+  for (const p2 of projects) {
+    if (p2.publishJob) {
+      deps.log(
+        `[publish] found interrupted job ${p2.publishJob.jobId} for ${p2.name}, stage=${p2.publishJob.stage}`
+      );
+    }
+  }
+}
+
 // src/handlers/app-builder.ts
 init_protocol();
+var import_node_path40 = require("path");
+var PUBLISH_SCRIPT_REL = "extension-kit/scripts/publish.sh";
 var DEV_SERVER_READY_TIMEOUT_MS = 3e4;
+async function recoverInterruptedPublishJobs(store, logger) {
+  await recoverInterruptedJobs({
+    listAllProjects: async () => store.list(),
+    log: (msg) => logger?.info(msg)
+  });
+}
 function buildAppBuilderHandlers(deps) {
   const { store, devServerLifecycle, sessionManager, getTunnelUrl, broadcastProjectUpdated } = deps;
   const stages = /* @__PURE__ */ new Map();
+  const publishRegistry = new PublishJobRegistry();
+  function withPublishJobStatus(meta) {
+    if (!meta.publishJob) return void 0;
+    const job = publishRegistry.get(meta.name);
+    const inFlight = !!job && job.jobId === meta.publishJob.jobId;
+    return {
+      ...meta.publishJob,
+      status: inFlight ? "in-flight" : "interrupted"
+    };
+  }
   function getStageOf(name) {
     const recorded = stages.get(name);
     if (recorded) return recorded;
@@ -41737,6 +42199,7 @@ function buildAppBuilderHandlers(deps) {
       return;
     }
     deps.logger?.info("app-builder.stage-transition", { name, stage, reason });
+    const publishJobWithStatus = withPublishJobStatus(meta);
     broadcastProjectUpdated({
       type: "appBuilder:project-updated",
       project: {
@@ -41744,7 +42207,8 @@ function buildAppBuilderHandlers(deps) {
         isRunning: devServerLifecycle.isRunning(name),
         boundSessionId: devServerLifecycle.boundSessionId(name),
         stage,
-        ...reason !== void 0 ? { stageReason: reason } : {}
+        ...reason !== void 0 ? { stageReason: reason } : {},
+        ...publishJobWithStatus !== void 0 ? { publishJob: publishJobWithStatus } : { publishJob: void 0 }
       },
       stage,
       ...reason !== void 0 ? { stageReason: reason } : {}
@@ -41756,12 +42220,16 @@ function buildAppBuilderHandlers(deps) {
       response: {
         projects: projects.map((p2) => {
           const s = getStageOf(p2.name);
+          const publishJobWithStatus = withPublishJobStatus(p2);
           return {
             ...p2,
             isRunning: devServerLifecycle.isRunning(p2.name),
             boundSessionId: devServerLifecycle.boundSessionId(p2.name),
             stage: s.stage,
-            ...s.reason !== void 0 ? { stageReason: s.reason } : {}
+            ...s.reason !== void 0 ? { stageReason: s.reason } : {},
+            // publishJob 在 spread ...p 之后覆写：原始 ProjectMetadata.publishJob 没有 status，
+            // 这里实时拼上 status 字段；字段不存在时显式 undefined（覆盖掉 spread 的可能值）。
+            publishJob: publishJobWithStatus
           };
         })
       }
@@ -41980,6 +42448,103 @@ function buildAppBuilderHandlers(deps) {
     await setStageAndBroadcast(projectName, "stopped");
     return { response: { ok: true } };
   };
+  const publish = async (frame) => {
+    const args = PublishArgsSchema.parse(frame);
+    const projects = await store.list();
+    const project = projects.find((p2) => p2.name === args.name);
+    if (!project) {
+      throw new ClawdError(ERROR_CODES.VALIDATION_ERROR, `publish: project "${args.name}" not found`);
+    }
+    const boundSession = sessionManager.findOwnedSessionByAppBuilderProject(args.name);
+    if (!boundSession) {
+      throw new ClawdError(
+        ERROR_CODES.VALIDATION_ERROR,
+        `publish: project "${args.name}" has no bound session (orphan); cannot inject failure to chat`
+      );
+    }
+    if (project.publishJob && !publishRegistry.has(args.name)) {
+      deps.logger?.info("app-builder.publish.clear-interrupted", {
+        name: args.name,
+        previousJobId: project.publishJob.jobId,
+        previousStage: project.publishJob.stage
+      });
+      await store.clearPublishJob(args.name);
+    }
+    const scriptPath = (0, import_node_path40.join)(deps.personaRoot, PUBLISH_SCRIPT_REL);
+    deps.logger?.info("app-builder.publish.start", {
+      name: args.name,
+      sessionId: boundSession.sessionId,
+      scriptPath
+    });
+    const result = await startPublishJob(
+      {
+        registry: publishRegistry,
+        setPublishJob: async (name, job) => {
+          await store.setPublishJob(name, job);
+          const current = getStageOf(name);
+          await setStageAndBroadcast(name, current.stage, current.reason);
+        },
+        clearPublishJob: async (name) => {
+          await store.clearPublishJob(name);
+          const current = getStageOf(name);
+          await setStageAndBroadcast(name, current.stage, current.reason);
+        },
+        setProdUrl: async (name, url) => {
+          await store.setProdUrl(name, url);
+          const current = getStageOf(name);
+          await setStageAndBroadcast(name, current.stage, current.reason);
+        },
+        broadcast: (f) => {
+          broadcastProjectUpdated(f);
+        },
+        injectUserText: async (sessionId, text) => {
+          const { broadcast } = sessionManager.send({ sessionId, text });
+          for (const entry of broadcast) {
+            deps.broadcastSessionFrame(entry.frame, entry.target);
+          }
+        },
+        projectDir: (name) => store.projectDir(name),
+        logger: deps.logger
+      },
+      {
+        name: args.name,
+        sessionId: boundSession.sessionId,
+        scriptPath
+      }
+    );
+    return { response: { ...result } };
+  };
+  const dismissPublishJob = async (frame) => {
+    const args = DismissPublishJobArgsSchema.parse(frame);
+    const projects = await store.list();
+    const project = projects.find((p2) => p2.name === args.name);
+    if (!project) {
+      throw new ClawdError(
+        ERROR_CODES.VALIDATION_ERROR,
+        `dismissPublishJob: project "${args.name}" not found`
+      );
+    }
+    const job = publishRegistry.get(args.name);
+    if (job) {
+      deps.logger?.info("app-builder.publish.dismiss.in-flight", {
+        name: args.name,
+        jobId: job.jobId,
+        stage: job.stage
+      });
+      publishRegistry.markDismissed(args.name);
+      job.childProc.kill("SIGTERM");
+    } else if (project.publishJob) {
+      deps.logger?.info("app-builder.publish.dismiss.interrupted", {
+        name: args.name,
+        jobId: project.publishJob.jobId,
+        stage: project.publishJob.stage
+      });
+      await store.clearPublishJob(args.name);
+      const current = getStageOf(args.name);
+      await setStageAndBroadcast(args.name, current.stage, current.reason);
+    }
+    return { response: { ok: true } };
+  };
   return {
     "appBuilder:listProjects": listProjects,
     "appBuilder:createProject": createProject,
@@ -41988,13 +42553,15 @@ function buildAppBuilderHandlers(deps) {
     "appBuilder:setProdUrl": setProdUrl,
     "appBuilder:startDevServer": startDevServer,
     "appBuilder:reportStage": reportStage,
-    "appBuilder:stopDevServer": stopDevServer
+    "appBuilder:stopDevServer": stopDevServer,
+    "appBuilder:publish": publish,
+    "appBuilder:dismissPublishJob": dismissPublishJob
   };
 }
 
 // src/extension/registry.ts
 var import_promises8 = __toESM(require("fs/promises"), 1);
-var import_node_path39 = __toESM(require("path"), 1);
+var import_node_path41 = __toESM(require("path"), 1);
 async function loadAll(root) {
   let entries;
   try {
@@ -42007,13 +42574,13 @@ async function loadAll(root) {
   for (const ent of entries) {
     if (!ent.isDirectory()) continue;
     if (ent.name.startsWith(".")) continue;
-    records.push(await loadOne(import_node_path39.default.join(root, ent.name), ent.name));
+    records.push(await loadOne(import_node_path41.default.join(root, ent.name), ent.name));
   }
   records.sort((a, b2) => a.extId < b2.extId ? -1 : a.extId > b2.extId ? 1 : 0);
   return records;
 }
 async function loadOne(dir, dirName) {
-  const manifestPath = import_node_path39.default.join(dir, "manifest.json");
+  const manifestPath = import_node_path41.default.join(dir, "manifest.json");
   let raw;
   try {
     raw = await import_promises8.default.readFile(manifestPath, "utf8");
@@ -42058,7 +42625,7 @@ async function loadOne(dir, dirName) {
 
 // src/extension/uninstall.ts
 var import_promises9 = __toESM(require("fs/promises"), 1);
-var import_node_path40 = __toESM(require("path"), 1);
+var import_node_path42 = __toESM(require("path"), 1);
 var UninstallError = class extends Error {
   constructor(code, message) {
     super(message);
@@ -42067,7 +42634,7 @@ var UninstallError = class extends Error {
   code;
 };
 async function uninstall(deps) {
-  const dir = import_node_path40.default.join(deps.root, deps.extId);
+  const dir = import_node_path42.default.join(deps.root, deps.extId);
   try {
     await import_promises9.default.access(dir);
   } catch {
@@ -42134,15 +42701,20 @@ function buildMethodHandlers(deps) {
       sessionManager: deps.manager,
       getTunnelUrl: deps.getTunnelUrl,
       broadcastProjectUpdated: deps.broadcastProjectUpdated,
-      logger: deps.logger
+      logger: deps.logger,
+      // 发布上线脚手架化 (spec 2026-06-03 §5.2):
+      // personaRoot 用于拼 publish.sh 绝对路径；broadcastSessionFrame 用于失败回灌路径
+      // （runner 调 manager.send 后逐帧 dispatch 到 transport）。
+      personaRoot: deps.appBuilderPersonaRoot,
+      broadcastSessionFrame: deps.broadcastSessionFrame
     })
   };
 }
 
 // src/app-builder/project-store.ts
-var import_node_fs29 = require("fs");
-var import_node_child_process8 = require("child_process");
-var import_node_path41 = require("path");
+var import_node_fs30 = require("fs");
+var import_node_child_process9 = require("child_process");
+var import_node_path43 = require("path");
 init_protocol();
 var PROJECTS_DIR = "projects";
 var META_FILE = ".clawd-project.json";
@@ -42157,19 +42729,19 @@ var ProjectStore = class {
   personaRoot;
   /** projects/<name>/.clawd-project.json 路径 */
   metaPath(name) {
-    return (0, import_node_path41.join)(this.projectsRoot(), name, META_FILE);
+    return (0, import_node_path43.join)(this.projectsRoot(), name, META_FILE);
   }
   /** projects/<name>/ 目录路径（cwd 用） */
   projectDir(name) {
-    return (0, import_node_path41.join)(this.projectsRoot(), name);
+    return (0, import_node_path43.join)(this.projectsRoot(), name);
   }
   projectsRoot() {
-    return (0, import_node_path41.join)(this.personaRoot, PROJECTS_DIR);
+    return (0, import_node_path43.join)(this.personaRoot, PROJECTS_DIR);
   }
   async list() {
     let entries;
     try {
-      entries = await import_node_fs29.promises.readdir(this.projectsRoot());
+      entries = await import_node_fs30.promises.readdir(this.projectsRoot());
     } catch (err) {
       if (err.code === "ENOENT") return [];
       throw err;
@@ -42177,7 +42749,7 @@ var ProjectStore = class {
     const out = [];
     for (const name of entries) {
       try {
-        const raw = await import_node_fs29.promises.readFile(this.metaPath(name), "utf8");
+        const raw = await import_node_fs30.promises.readFile(this.metaPath(name), "utf8");
         const json = JSON.parse(raw);
         let migrated = false;
         if (typeof json.devCommand !== "string" || json.devCommand.length === 0) {
@@ -42188,7 +42760,7 @@ var ProjectStore = class {
         if (parsed.success) {
           out.push(parsed.data);
           if (migrated) {
-            void import_node_fs29.promises.writeFile(this.metaPath(name), JSON.stringify(parsed.data, null, 2) + "\n", "utf8").catch(() => {
+            void import_node_fs30.promises.writeFile(this.metaPath(name), JSON.stringify(parsed.data, null, 2) + "\n", "utf8").catch(() => {
             });
           }
         }
@@ -42226,8 +42798,8 @@ var ProjectStore = class {
       throw new Error(`invalid name "${name}": ${validated.error.message}`);
     }
     const dir = this.projectDir(name);
-    await import_node_fs29.promises.mkdir(dir, { recursive: true });
-    await import_node_fs29.promises.writeFile(this.metaPath(name), JSON.stringify(meta, null, 2) + "\n", "utf8");
+    await import_node_fs30.promises.mkdir(dir, { recursive: true });
+    await import_node_fs30.promises.writeFile(this.metaPath(name), JSON.stringify(meta, null, 2) + "\n", "utf8");
     return meta;
   }
   /**
@@ -42239,9 +42811,9 @@ var ProjectStore = class {
    * 代码再参考"。assistant 进 project 时目录已是完整模板，直接 pnpm install 即可。
    */
   async scaffold(name, template = DEFAULT_TEMPLATE) {
-    const scriptPath = (0, import_node_path41.join)(this.personaRoot, SCAFFOLD_SCRIPT_REL);
+    const scriptPath = (0, import_node_path43.join)(this.personaRoot, SCAFFOLD_SCRIPT_REL);
     return await new Promise((resolve6, reject) => {
-      const child = (0, import_node_child_process8.spawn)("bash", [scriptPath, name, template], {
+      const child = (0, import_node_child_process9.spawn)("bash", [scriptPath, name, template], {
         cwd: this.personaRoot,
         env: { ...process.env, PATH: process.env.PATH ?? "" },
         stdio: ["ignore", "pipe", "pipe"]
@@ -42271,7 +42843,7 @@ var ProjectStore = class {
   }
   async delete(name) {
     const dir = this.projectDir(name);
-    await import_node_fs29.promises.rm(dir, { recursive: true, force: true });
+    await import_node_fs30.promises.rm(dir, { recursive: true, force: true });
   }
   async updatePort(name, newPort) {
     if (newPort < PROJECT_PORT_MIN || newPort > PROJECT_PORT_MAX) {
@@ -42287,7 +42859,7 @@ var ProjectStore = class {
       throw new Error(`port ${newPort} already used / \u5DF2\u88AB project "${conflict.name}" \u5360\u7528`);
     }
     const updated = { ...target, port: newPort };
-    await import_node_fs29.promises.writeFile(this.metaPath(name), JSON.stringify(updated, null, 2) + "\n", "utf8");
+    await import_node_fs30.promises.writeFile(this.metaPath(name), JSON.stringify(updated, null, 2) + "\n", "utf8");
     return updated;
   }
   /**
@@ -42304,13 +42876,49 @@ var ProjectStore = class {
     if (!validated.success) {
       throw new Error(`invalid prodUrl "${url}": ${validated.error.message}`);
     }
-    await import_node_fs29.promises.writeFile(this.metaPath(name), JSON.stringify(validated.data, null, 2) + "\n", "utf8");
+    await import_node_fs30.promises.writeFile(this.metaPath(name), JSON.stringify(validated.data, null, 2) + "\n", "utf8");
+    return validated.data;
+  }
+  /**
+   * 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design §5.1.4)：
+   * 写 publishJob 字段到 .clawd-project.json。仅承载 in-flight 状态 ——
+   *   - daemon 收到第一个 ::stage::build marker 时写入
+   *   - 每次 stage 切换更新 stage 字段（jobId / startedAt 不变）
+   *   - 成功 / 失败 / dismiss 时调 clearPublishJob 清掉
+   *   - 只有 daemon 崩才会留残骸
+   * 写入时保留所有其他字段（prodUrl 等不受影响）。
+   */
+  async setPublishJob(name, job) {
+    const list = await this.list();
+    const target = list.find((p2) => p2.name === name);
+    if (!target) throw new Error(`project "${name}" not found / \u4E0D\u5B58\u5728`);
+    const updated = { ...target, publishJob: job };
+    const validated = ProjectMetadataSchema.safeParse(updated);
+    if (!validated.success) {
+      throw new Error(`invalid publishJob: ${validated.error.message}`);
+    }
+    await import_node_fs30.promises.writeFile(this.metaPath(name), JSON.stringify(validated.data, null, 2) + "\n", "utf8");
+    return validated.data;
+  }
+  /** 清掉 .clawd-project.json.publishJob 字段。其他字段保持原样。 */
+  async clearPublishJob(name) {
+    const list = await this.list();
+    const target = list.find((p2) => p2.name === name);
+    if (!target) throw new Error(`project "${name}" not found / \u4E0D\u5B58\u5728`);
+    if (!target.publishJob) return target;
+    const { publishJob: _drop, ...rest } = target;
+    void _drop;
+    const validated = ProjectMetadataSchema.safeParse(rest);
+    if (!validated.success) {
+      throw new Error(`failed to clear publishJob: ${validated.error.message}`);
+    }
+    await import_node_fs30.promises.writeFile(this.metaPath(name), JSON.stringify(validated.data, null, 2) + "\n", "utf8");
     return validated.data;
   }
 };
 
 // src/app-builder/dev-server-supervisor.ts
-var import_node_child_process9 = require("child_process");
+var import_node_child_process10 = require("child_process");
 var import_node_events2 = require("events");
 var DEFAULT_READY_PATTERN = /Local:\s+https?:\/\/|Nest application successfully started|server listening on/i;
 var DevServerSupervisor = class extends import_node_events2.EventEmitter {
@@ -42347,7 +42955,7 @@ var DevServerSupervisor = class extends import_node_events2.EventEmitter {
       tunnelHost: args.tunnelHost,
       devCommand: cmd
     });
-    const child = (0, import_node_child_process9.spawn)("sh", ["-c", cmd], {
+    const child = (0, import_node_child_process10.spawn)("sh", ["-c", cmd], {
       cwd: args.cwd,
       env,
       stdio: "pipe",
@@ -42709,7 +43317,11 @@ var METHOD_GRANT_MAP = {
   "appBuilder:reportStage": ADMIN_ANY,
   // 显式控制 fix (spec 2026-06-02-app-builder-explicit-dev-server-control)：用户点"收起预览"触发停 dev server，
   // 对称 startDevServer。同时砍了 setActiveSession（dev server 不再 follow-the-eyes）。
-  "appBuilder:stopDevServer": ADMIN_ANY
+  "appBuilder:stopDevServer": ADMIN_ANY,
+  // 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design):
+  // owner-only：PreviewPane「发布上线」按钮直接调 publish；UI [取消] / interrupted 恢复按钮调 dismissPublishJob。
+  "appBuilder:publish": ADMIN_ANY,
+  "appBuilder:dismissPublishJob": ADMIN_ANY
 };
 function computeGrantForFrame(method, frame) {
   const rule = METHOD_GRANT_MAP[method];
@@ -42725,8 +43337,8 @@ function computeGrantForFrame(method, frame) {
 }
 
 // src/extension/runtime.ts
-var import_node_child_process10 = require("child_process");
-var import_node_path42 = __toESM(require("path"), 1);
+var import_node_child_process11 = require("child_process");
+var import_node_path44 = __toESM(require("path"), 1);
 var import_promises10 = require("timers/promises");
 
 // src/extension/port-allocator.ts
@@ -42827,13 +43439,13 @@ var Runtime = class {
       /\$CLAWOS_EXT_PORT/g,
       String(port)
     );
-    const dir = import_node_path42.default.join(this.root, extId);
+    const dir = import_node_path44.default.join(this.root, extId);
     const env = {
       ...process.env,
       CLAWOS_EXT_PORT: String(port),
       CLAWOS_EXT_ID: extId
     };
-    const child = (0, import_node_child_process10.spawn)("sh", ["-c", cmd], {
+    const child = (0, import_node_child_process11.spawn)("sh", ["-c", cmd], {
       cwd: dir,
       env,
       stdio: ["ignore", "pipe", "pipe"],
@@ -42939,7 +43551,7 @@ ${handle.stderrTail}`
 
 // src/extension/published-channels.ts
 var import_promises11 = __toESM(require("fs/promises"), 1);
-var import_node_path43 = __toESM(require("path"), 1);
+var import_node_path45 = __toESM(require("path"), 1);
 init_zod();
 var PublishedChannelsError = class extends Error {
   constructor(code, message) {
@@ -43038,7 +43650,7 @@ var PublishedChannelStore = class {
       )
     };
     const tmp = `${this.filePath}.tmp`;
-    await import_promises11.default.mkdir(import_node_path43.default.dirname(this.filePath), { recursive: true });
+    await import_promises11.default.mkdir(import_node_path45.default.dirname(this.filePath), { recursive: true });
     await import_promises11.default.writeFile(tmp, JSON.stringify(data, null, 2), { mode: 384 });
     await import_promises11.default.rename(tmp, this.filePath);
   }
@@ -43046,7 +43658,7 @@ var PublishedChannelStore = class {
 
 // src/extension/bundle-cache.ts
 var import_promises12 = __toESM(require("fs/promises"), 1);
-var import_node_path44 = __toESM(require("path"), 1);
+var import_node_path46 = __toESM(require("path"), 1);
 var BundleCache = class {
   constructor(rootDir) {
     this.rootDir = rootDir;
@@ -43055,14 +43667,14 @@ var BundleCache = class {
   /** Atomic write: stage tmp → rename. Caller passes the hex sha256. */
   async write(snapshotHash, buffer) {
     await import_promises12.default.mkdir(this.rootDir, { recursive: true });
-    const file = import_node_path44.default.join(this.rootDir, `${snapshotHash}.zip`);
+    const file = import_node_path46.default.join(this.rootDir, `${snapshotHash}.zip`);
     const tmp = `${file}.tmp`;
     await import_promises12.default.writeFile(tmp, buffer, { mode: 384 });
     await import_promises12.default.rename(tmp, file);
   }
   /** Returns the bundle bytes, or null when the file doesn't exist. */
   async read(snapshotHash) {
-    const file = import_node_path44.default.join(this.rootDir, `${snapshotHash}.zip`);
+    const file = import_node_path46.default.join(this.rootDir, `${snapshotHash}.zip`);
     try {
       return await import_promises12.default.readFile(file);
     } catch (e) {
@@ -43072,7 +43684,7 @@ var BundleCache = class {
   }
   /** Idempotent — missing file is not an error. */
   async delete(snapshotHash) {
-    const file = import_node_path44.default.join(this.rootDir, `${snapshotHash}.zip`);
+    const file = import_node_path46.default.join(this.rootDir, `${snapshotHash}.zip`);
     await import_promises12.default.rm(file, { force: true });
   }
 };
@@ -43081,7 +43693,7 @@ var BundleCache = class {
 async function startDaemon(config) {
   const logger = createLogger({
     level: config.logLevel,
-    file: import_node_path45.default.join(config.dataDir, "clawd.log")
+    file: import_node_path47.default.join(config.dataDir, "clawd.log")
   });
   logger.info("starting clawd", { version, config: { port: config.port, host: config.host, dataDir: config.dataDir } });
   const stateMgr = new StateFileManager({ dataDir: config.dataDir });
@@ -43168,10 +43780,11 @@ async function startDaemon(config) {
   const agents = new AgentsScanner();
   const history = new ClaudeHistoryReader();
   let transport = null;
-  const personaStore = new PersonaStore(import_node_path45.default.join(config.dataDir, "personas"));
+  const personaStore = new PersonaStore(import_node_path47.default.join(config.dataDir, "personas"));
   const defaultsRoot = findDefaultsRoot();
   if (defaultsRoot) {
     seedDefaultPersonas({ store: personaStore, defaultsRoot, logger });
+    refreshDaemonManagedDirs({ store: personaStore, defaultsRoot, logger });
   } else {
     logger.warn("persona.seed.skip", { reason: "defaults-root-not-found" });
   }
@@ -43185,7 +43798,7 @@ async function startDaemon(config) {
     getAdapter,
     historyReader: history,
     dataDir: config.dataDir,
-    personaRoot: import_node_path45.default.join(config.dataDir, "personas"),
+    personaRoot: import_node_path47.default.join(config.dataDir, "personas"),
     personaStore,
     ownerDisplayName,
     ownerPrincipalId,
@@ -43214,10 +43827,10 @@ async function startDaemon(config) {
     // 文件可能 agent 写完又被自己删（罕见），用 size=0 / fallback mime 兜底。
     attachmentGroup: {
       onFileEdit: (input) => {
-        const absPath = import_node_path45.default.isAbsolute(input.relPath) ? input.relPath : import_node_path45.default.join(input.cwd, input.relPath);
+        const absPath = import_node_path47.default.isAbsolute(input.relPath) ? input.relPath : import_node_path47.default.join(input.cwd, input.relPath);
         let size = 0;
         try {
-          size = import_node_fs30.default.statSync(absPath).size;
+          size = import_node_fs31.default.statSync(absPath).size;
         } catch (err) {
           logger.warn("attachment.onFileEdit stat failed", {
             sessionId: input.sessionId,
@@ -43305,8 +43918,13 @@ async function startDaemon(config) {
   await publishedChannelStore.load();
   const bundleCache = new BundleCache(bundleCacheRoot());
   const appBuilderStore = new ProjectStore(
-    import_node_path45.default.join(config.dataDir, "personas/persona-app-builder")
+    import_node_path47.default.join(config.dataDir, "personas/persona-app-builder")
   );
+  recoverInterruptedPublishJobs(appBuilderStore, logger).catch((err) => {
+    logger.warn("app-builder.publish.recover-startup-failed", {
+      error: err instanceof Error ? err.message : String(err)
+    });
+  });
   const devServerSupervisor = new DevServerSupervisor();
   devServerSupervisor.setLogger(logger);
   const appBuilderPortRange = [];
@@ -43353,10 +43971,10 @@ async function startDaemon(config) {
       // 'persona/<pid>/owner'，default 走 'default'。
       getSessionScope: (sid) => manager.findOwnedSessionScope(sid),
       // guest path guard：candidate 必须在 personaRoot 子树下
-      personaRoot: import_node_path45.default.join(config.dataDir, "personas")
+      personaRoot: import_node_path47.default.join(config.dataDir, "personas")
     },
     // workspace/git/history/skills/agents handler 共用的 guest path guard 锚点
-    personaRoot: import_node_path45.default.join(config.dataDir, "personas"),
+    personaRoot: import_node_path47.default.join(config.dataDir, "personas"),
     // capability:list / delete handler 依赖
     capabilityManager,
     // personal-cap:get 返回的 shareBaseUrl 用此 base URL：
@@ -43393,6 +44011,27 @@ async function startDaemon(config) {
     // 单栏 refactor §5.6.2 stage fix：appBuilder:project-updated 帧通过 wsServer broadcast。
     // 推给所有 owner 连接（picker 可能没订阅特定 session，全局 broadcast 最稳）。
     broadcastProjectUpdated: (event) => wsServer?.broadcastToOwners(event),
+    // 发布上线脚手架化 (spec 2026-06-03 §5.2):
+    // appBuilderPersonaRoot 用于拼 publish.sh 绝对路径（persona-app-builder 安装在
+    // dataDir/personas/persona-app-builder 之下，extension-kit/scripts/publish.sh 是相对路径）。
+    appBuilderPersonaRoot: import_node_path47.default.join(config.dataDir, "personas", "persona-app-builder"),
+    // 发布上线脚手架化 (spec 2026-06-03 §5.2.2):
+    // 复用 SessionManagerDeps.broadcastFrame 同款 dispatch 逻辑 —— runner 调 manager.send
+    // 取回 broadcast 帧后逐帧 push 到 transport，跟 manager 自身的 deps 一致。
+    broadcastSessionFrame: (frame, target) => {
+      if (target === "all") {
+        transport?.broadcastAll(frame);
+        return;
+      }
+      const sid = frame.sessionId;
+      if (!sid) return;
+      if (target === "first-subscriber") {
+        const handle = transport?.firstSubscriber(sid);
+        if (handle) handle.send(frame);
+        return;
+      }
+      transport?.broadcastToSession(sid, frame);
+    },
     logger
   });
   const authResolver = new AuthContextResolver({
@@ -43595,8 +44234,8 @@ async function startDaemon(config) {
       const lines = [
         `Tunnel:      ${r.url}`,
         ...resolvedAuthToken ? [`Connect:     ${connectUrl}`] : [],
-        `Frpc config: ${import_node_path45.default.join(config.dataDir, "frpc.toml")}`,
-        `Frpc log:    ${import_node_path45.default.join(config.dataDir, "frpc.log")}`
+        `Frpc config: ${import_node_path47.default.join(config.dataDir, "frpc.toml")}`,
+        `Frpc log:    ${import_node_path47.default.join(config.dataDir, "frpc.log")}`
       ];
       const width = Math.max(...lines.map((l) => l.length));
       const bar = "\u2550".repeat(width + 4);
@@ -43609,8 +44248,8 @@ ${bar}
 
 `);
       try {
-        const connectPath = import_node_path45.default.join(config.dataDir, "connect.txt");
-        import_node_fs30.default.writeFileSync(connectPath, lines.join("\n") + "\n", { mode: 384 });
+        const connectPath = import_node_path47.default.join(config.dataDir, "connect.txt");
+        import_node_fs31.default.writeFileSync(connectPath, lines.join("\n") + "\n", { mode: 384 });
       } catch {
       }
     } catch (err) {
@@ -43679,9 +44318,9 @@ ${bar}
   };
 }
 function migrateDropPersonsDir(dataDir) {
-  const dir = import_node_path45.default.join(dataDir, "persons");
+  const dir = import_node_path47.default.join(dataDir, "persons");
   try {
-    import_node_fs30.default.rmSync(dir, { recursive: true, force: true });
+    import_node_fs31.default.rmSync(dir, { recursive: true, force: true });
   } catch {
   }
 }