@remixhq/claude-plugin 0.1.11 → 0.1.14

package/dist/hook-stop-collab.cjs

@@ -29,6 +29,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // node_modules/isexe/windows.js
 var require_windows = __commonJS({
@@ -36,8 +37,8 @@ var require_windows = __commonJS({
     "use strict";
     module2.exports = isexe;
     isexe.sync = sync;
-    var fs8 = require("fs");
-    function checkPathExt(path12, options) {
+    var fs9 = require("fs");
+    function checkPathExt(path13, options) {
       var pathext = options.pathExt !== void 0 ? options.pathExt : process.env.PATHEXT;
       if (!pathext) {
         return true;
@@ -48,25 +49,25 @@ var require_windows = __commonJS({
       }
       for (var i2 = 0; i2 < pathext.length; i2++) {
         var p = pathext[i2].toLowerCase();
-        if (p && path12.substr(-p.length).toLowerCase() === p) {
+        if (p && path13.substr(-p.length).toLowerCase() === p) {
           return true;
         }
       }
       return false;
     }
-    function checkStat(stat, path12, options) {
+    function checkStat(stat, path13, options) {
       if (!stat.isSymbolicLink() && !stat.isFile()) {
         return false;
       }
-      return checkPathExt(path12, options);
+      return checkPathExt(path13, options);
     }
-    function isexe(path12, options, cb) {
-      fs8.stat(path12, function(er, stat) {
-        cb(er, er ? false : checkStat(stat, path12, options));
+    function isexe(path13, options, cb) {
+      fs9.stat(path13, function(er, stat) {
+        cb(er, er ? false : checkStat(stat, path13, options));
       });
     }
-    function sync(path12, options) {
-      return checkStat(fs8.statSync(path12), path12, options);
+    function sync(path13, options) {
+      return checkStat(fs9.statSync(path13), path13, options);
     }
   }
 });
@@ -77,14 +78,14 @@ var require_mode = __commonJS({
     "use strict";
     module2.exports = isexe;
     isexe.sync = sync;
-    var fs8 = require("fs");
-    function isexe(path12, options, cb) {
-      fs8.stat(path12, function(er, stat) {
+    var fs9 = require("fs");
+    function isexe(path13, options, cb) {
+      fs9.stat(path13, function(er, stat) {
         cb(er, er ? false : checkStat(stat, options));
       });
     }
-    function sync(path12, options) {
-      return checkStat(fs8.statSync(path12), options);
+    function sync(path13, options) {
+      return checkStat(fs9.statSync(path13), options);
     }
     function checkStat(stat, options) {
       return stat.isFile() && checkMode(stat, options);
@@ -109,7 +110,7 @@ var require_mode = __commonJS({
 var require_isexe = __commonJS({
   "node_modules/isexe/index.js"(exports2, module2) {
     "use strict";
-    var fs8 = require("fs");
+    var fs9 = require("fs");
     var core;
     if (process.platform === "win32" || global.TESTING_WINDOWS) {
       core = require_windows();
@@ -118,7 +119,7 @@ var require_isexe = __commonJS({
     }
     module2.exports = isexe;
     isexe.sync = sync;
-    function isexe(path12, options, cb) {
+    function isexe(path13, options, cb) {
       if (typeof options === "function") {
         cb = options;
         options = {};
@@ -128,7 +129,7 @@ var require_isexe = __commonJS({
           throw new TypeError("callback not provided");
         }
         return new Promise(function(resolve, reject) {
-          isexe(path12, options || {}, function(er, is) {
+          isexe(path13, options || {}, function(er, is) {
             if (er) {
               reject(er);
             } else {
@@ -137,7 +138,7 @@ var require_isexe = __commonJS({
           });
         });
       }
-      core(path12, options || {}, function(er, is) {
+      core(path13, options || {}, function(er, is) {
         if (er) {
           if (er.code === "EACCES" || options && options.ignoreErrors) {
             er = null;
@@ -147,9 +148,9 @@ var require_isexe = __commonJS({
         cb(er, is);
       });
     }
-    function sync(path12, options) {
+    function sync(path13, options) {
       try {
-        return core.sync(path12, options || {});
+        return core.sync(path13, options || {});
       } catch (er) {
         if (options && options.ignoreErrors || er.code === "EACCES") {
           return false;
@@ -166,7 +167,7 @@ var require_which = __commonJS({
   "node_modules/which/which.js"(exports2, module2) {
     "use strict";
     var isWindows = process.platform === "win32" || process.env.OSTYPE === "cygwin" || process.env.OSTYPE === "msys";
-    var path12 = require("path");
+    var path13 = require("path");
     var COLON = isWindows ? ";" : ":";
     var isexe = require_isexe();
     var getNotFoundError = (cmd) => Object.assign(new Error(`not found: ${cmd}`), { code: "ENOENT" });
@@ -204,7 +205,7 @@ var require_which = __commonJS({
           return opt.all && found.length ? resolve(found) : reject(getNotFoundError(cmd));
         const ppRaw = pathEnv[i2];
         const pathPart = /^".*"$/.test(ppRaw) ? ppRaw.slice(1, -1) : ppRaw;
-        const pCmd = path12.join(pathPart, cmd);
+        const pCmd = path13.join(pathPart, cmd);
         const p = !pathPart && /^\.[\\\/]/.test(cmd) ? cmd.slice(0, 2) + pCmd : pCmd;
         resolve(subStep(p, i2, 0));
       });
@@ -231,7 +232,7 @@ var require_which = __commonJS({
       for (let i2 = 0; i2 < pathEnv.length; i2++) {
         const ppRaw = pathEnv[i2];
         const pathPart = /^".*"$/.test(ppRaw) ? ppRaw.slice(1, -1) : ppRaw;
-        const pCmd = path12.join(pathPart, cmd);
+        const pCmd = path13.join(pathPart, cmd);
         const p = !pathPart && /^\.[\\\/]/.test(cmd) ? cmd.slice(0, 2) + pCmd : pCmd;
         for (let j = 0; j < pathExt.length; j++) {
           const cur = p + pathExt[j];
@@ -279,7 +280,7 @@ var require_path_key = __commonJS({
 var require_resolveCommand = __commonJS({
   "node_modules/cross-spawn/lib/util/resolveCommand.js"(exports2, module2) {
     "use strict";
-    var path12 = require("path");
+    var path13 = require("path");
     var which = require_which();
     var getPathKey = require_path_key();
     function resolveCommandAttempt(parsed, withoutPathExt) {
@@ -297,7 +298,7 @@ var require_resolveCommand = __commonJS({
       try {
         resolved = which.sync(parsed.command, {
           path: env[getPathKey({ env })],
-          pathExt: withoutPathExt ? path12.delimiter : void 0
+          pathExt: withoutPathExt ? path13.delimiter : void 0
         });
       } catch (e) {
       } finally {
@@ -306,7 +307,7 @@ var require_resolveCommand = __commonJS({
         }
       }
       if (resolved) {
-        resolved = path12.resolve(hasCustomCwd ? parsed.options.cwd : "", resolved);
+        resolved = path13.resolve(hasCustomCwd ? parsed.options.cwd : "", resolved);
       }
       return resolved;
     }
@@ -360,8 +361,8 @@ var require_shebang_command = __commonJS({
       if (!match) {
         return null;
       }
-      const [path12, argument] = match[0].replace(/#! ?/, "").split(" ");
-      const binary = path12.split("/").pop();
+      const [path13, argument] = match[0].replace(/#! ?/, "").split(" ");
+      const binary = path13.split("/").pop();
       if (binary === "env") {
         return argument;
       }
@@ -374,16 +375,16 @@ var require_shebang_command = __commonJS({
 var require_readShebang = __commonJS({
   "node_modules/cross-spawn/lib/util/readShebang.js"(exports2, module2) {
     "use strict";
-    var fs8 = require("fs");
+    var fs9 = require("fs");
     var shebangCommand = require_shebang_command();
     function readShebang(command) {
       const size = 150;
       const buffer = Buffer.alloc(size);
       let fd;
       try {
-        fd = fs8.openSync(command, "r");
-        fs8.readSync(fd, buffer, 0, size, 0);
-        fs8.closeSync(fd);
+        fd = fs9.openSync(command, "r");
+        fs9.readSync(fd, buffer, 0, size, 0);
+        fs9.closeSync(fd);
       } catch (e) {
       }
       return shebangCommand(buffer.toString());
@@ -396,7 +397,7 @@ var require_readShebang = __commonJS({
 var require_parse = __commonJS({
   "node_modules/cross-spawn/lib/parse.js"(exports2, module2) {
     "use strict";
-    var path12 = require("path");
+    var path13 = require("path");
     var resolveCommand = require_resolveCommand();
     var escape = require_escape();
     var readShebang = require_readShebang();
@@ -421,7 +422,7 @@ var require_parse = __commonJS({
       const needsShell = !isExecutableRegExp.test(commandFile);
       if (parsed.options.forceShell || needsShell) {
         const needsDoubleEscapeMetaChars = isCmdShimRegExp.test(commandFile);
-        parsed.command = path12.normalize(parsed.command);
+        parsed.command = path13.normalize(parsed.command);
         parsed.command = escape.command(parsed.command);
         parsed.args = parsed.args.map((arg) => escape.argument(arg, needsDoubleEscapeMetaChars));
         const shellCommand = [parsed.command].concat(parsed.args).join(" ");
@@ -531,6 +532,13 @@ var require_cross_spawn = __commonJS({
   }
 });
 
+// src/hook-stop-collab.ts
+var hook_stop_collab_exports = {};
+__export(hook_stop_collab_exports, {
+  runHookStopCollab: () => runHookStopCollab
+});
+module.exports = __toCommonJS(hook_stop_collab_exports);
+
 // node_modules/@remixhq/core/dist/chunk-YZ34ICNN.js
 var RemixError = class extends Error {
   code;
@@ -545,7 +553,7 @@ var RemixError = class extends Error {
   }
 };
 
-// node_modules/@remixhq/core/dist/chunk-FAZUMWBS.js
+// node_modules/@remixhq/core/dist/chunk-GEHSFPCD.js
 var import_promises = __toESM(require("fs/promises"), 1);
 var import_path = __toESM(require("path"), 1);
 function getCollabBindingPath(repoRoot) {
@@ -582,7 +590,7 @@ var REMIX_ERROR_CODES = {
   PREFERRED_BRANCH_MISMATCH: "PREFERRED_BRANCH_MISMATCH"
 };
 
-// node_modules/@remixhq/core/dist/chunk-RREREIGW.js
+// node_modules/@remixhq/core/dist/chunk-J3J4PBQ7.js
 var import_promises13 = __toESM(require("fs/promises"), 1);
 var import_crypto = require("crypto");
 var import_os = __toESM(require("os"), 1);
@@ -4969,13 +4977,13 @@ var logOutputSync = ({ serializedResult, fdNumber, state, verboseInfo, encoding,
   }
 };
 var writeToFiles = (serializedResult, stdioItems, outputFiles) => {
-  for (const { path: path12, append } of stdioItems.filter(({ type }) => FILE_TYPES.has(type))) {
-    const pathString = typeof path12 === "string" ? path12 : path12.toString();
+  for (const { path: path13, append } of stdioItems.filter(({ type }) => FILE_TYPES.has(type))) {
+    const pathString = typeof path13 === "string" ? path13 : path13.toString();
     if (append || outputFiles.has(pathString)) {
-      (0, import_node_fs4.appendFileSync)(path12, serializedResult);
+      (0, import_node_fs4.appendFileSync)(path13, serializedResult);
     } else {
       outputFiles.add(pathString);
-      (0, import_node_fs4.writeFileSync)(path12, serializedResult);
+      (0, import_node_fs4.writeFileSync)(path13, serializedResult);
     }
   }
 };
@@ -7363,7 +7371,7 @@ var {
   getCancelSignal: getCancelSignal2
 } = getIpcExport();
 
-// node_modules/@remixhq/core/dist/chunk-RREREIGW.js
+// node_modules/@remixhq/core/dist/chunk-J3J4PBQ7.js
 async function runGit(args, cwd) {
   const res = await execa("git", args, { cwd, stderr: "ignore" });
   return String(res.stdout || "").trim();
@@ -7879,6 +7887,25 @@ function formatCliErrorDetail(err) {
   }
   return typeof err === "string" && err.trim() ? err.trim() : null;
 }
+async function pollAppReady(api, appId) {
+  const started = Date.now();
+  let delay = 2e3;
+  while (Date.now() - started < 20 * 60 * 1e3) {
+    const appResp = await api.getApp(appId);
+    const app = unwrapResponseObject(appResp, "app");
+    const status = typeof app.status === "string" ? app.status : "";
+    if (status === "ready") return app;
+    if (status === "error") {
+      throw new RemixError("App is in error state.", {
+        exitCode: 1,
+        hint: typeof app.statusError === "string" ? app.statusError : null
+      });
+    }
+    await sleep(delay);
+    delay = Math.min(1e4, Math.floor(delay * 1.4));
+  }
+  throw new RemixError("Timed out waiting for app to become ready.", { exitCode: 1 });
+}
 async function pollChangeStep(api, appId, changeStepId) {
   const started = Date.now();
   let delay = 1500;
@@ -8700,6 +8727,7 @@ async function collabAdd(params) {
     }
     const { backupPath } = await writeTempUnifiedDiffBackup(diff, "remix-add");
     try {
+      await pollAppReady(params.api, binding.currentAppId);
       if (submissionSnapshot) {
         await assertRepoSnapshotUnchanged(repoRoot, submissionSnapshot, {
           operation: "`remix collab add` auto-sync",
@@ -8845,7 +8873,7 @@ async function collabRecordTurn(params) {
   return unwrapResponseObject(resp, "collab turn");
 }
 
-// node_modules/@remixhq/core/dist/chunk-4276ARDF.js
+// node_modules/@remixhq/core/dist/chunk-XC2FV57P.js
 async function readJsonSafe(res) {
   const ct = res.headers.get("content-type") ?? "";
   if (!ct.toLowerCase().includes("application/json")) return null;
@@ -8859,7 +8887,7 @@ function createApiClient(config, opts) {
   const apiKey = (opts?.apiKey ?? "").trim();
   const tokenProvider = opts?.tokenProvider;
   const CLIENT_KEY_HEADER = "x-comerge-api-key";
-  async function request(path12, init) {
+  async function request(path13, init) {
     if (!tokenProvider) {
       throw new RemixError("API client is missing a token provider.", {
         exitCode: 1,
@@ -8867,7 +8895,7 @@ function createApiClient(config, opts) {
       });
     }
     const auth = await tokenProvider();
-    const url = new URL(path12, config.apiUrl).toString();
+    const url = new URL(path13, config.apiUrl).toString();
     const doFetch = async (bearer) => fetch(url, {
       ...init,
       headers: {
@@ -8891,7 +8919,7 @@ function createApiClient(config, opts) {
     const json = await readJsonSafe(res);
     return json ?? null;
   }
-  async function requestBinary(path12, init) {
+  async function requestBinary(path13, init) {
     if (!tokenProvider) {
       throw new RemixError("API client is missing a token provider.", {
         exitCode: 1,
@@ -8899,7 +8927,7 @@ function createApiClient(config, opts) {
       });
     }
     const auth = await tokenProvider();
-    const url = new URL(path12, config.apiUrl).toString();
+    const url = new URL(path13, config.apiUrl).toString();
     const doFetch = async (bearer) => fetch(url, {
       ...init,
       headers: {
@@ -8960,10 +8988,29 @@ function createApiClient(config, opts) {
       if (params?.projectId) qs.set("projectId", params.projectId);
       if (params?.organizationId) qs.set("organizationId", params.organizationId);
       if (params?.forked) qs.set("forked", params.forked);
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
       const suffix = qs.toString() ? `?${qs.toString()}` : "";
       return request(`/v1/apps${suffix}`, { method: "GET" });
     },
     getApp: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}`, { method: "GET" }),
+    getAppContext: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/context`, { method: "GET" }),
+    getAppOverview: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/overview`, { method: "GET" }),
+    listAppTimeline: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (params?.cursor) qs.set("cursor", params.cursor);
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/timeline${suffix}`, { method: "GET" });
+    },
+    getAppTimelineEvent: (appId, eventId) => request(`/v1/apps/${encodeURIComponent(appId)}/timeline/${encodeURIComponent(eventId)}`, { method: "GET" }),
+    listAppEditQueue: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/edit-queue${suffix}`, { method: "GET" });
+    },
     getMergeRequest: (mrId) => request(`/v1/merge-requests/${encodeURIComponent(mrId)}`, { method: "GET" }),
     presignImportUpload: (payload) => request("/v1/apps/import/upload/presign", { method: "POST", body: JSON.stringify(payload) }),
     importFromUpload: (payload) => request("/v1/apps/import/upload", { method: "POST", body: JSON.stringify(payload) }),
@@ -9045,6 +9092,8 @@ function createApiClient(config, opts) {
         qs.set("status", params.status);
       }
       if (params?.kind) qs.set("kind", params.kind);
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
       const suffix = qs.toString() ? `?${qs.toString()}` : "";
       return request(`/v1/merge-requests${suffix}`, { method: "GET" });
     },
@@ -9063,24 +9112,60 @@ function createApiClient(config, opts) {
       method: "POST",
       body: JSON.stringify(payload)
     }),
-    listOrganizationMembers: (orgId) => request(`/v1/organizations/${encodeURIComponent(orgId)}/members`, { method: "GET" }),
+    listOrganizationMembers: (orgId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/organizations/${encodeURIComponent(orgId)}/members${suffix}`, { method: "GET" });
+    },
     updateOrganizationMember: (orgId, userId, payload) => request(`/v1/organizations/${encodeURIComponent(orgId)}/members/${encodeURIComponent(userId)}`, {
       method: "PATCH",
       body: JSON.stringify(payload)
     }),
-    listProjectMembers: (projectId) => request(`/v1/projects/${encodeURIComponent(projectId)}/members`, { method: "GET" }),
+    listProjectMembers: (projectId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/members${suffix}`, { method: "GET" });
+    },
     updateProjectMember: (projectId, userId, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/members/${encodeURIComponent(userId)}`, {
       method: "PATCH",
       body: JSON.stringify(payload)
     }),
-    listAppMembers: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/members`, { method: "GET" }),
+    listAppMembers: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/members${suffix}`, { method: "GET" });
+    },
     updateAppMember: (appId, userId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/members/${encodeURIComponent(userId)}`, {
       method: "PATCH",
       body: JSON.stringify(payload)
     }),
-    listOrganizationInvites: (orgId) => request(`/v1/organizations/${encodeURIComponent(orgId)}/invitations`, { method: "GET" }),
-    listProjectInvites: (projectId) => request(`/v1/projects/${encodeURIComponent(projectId)}/invitations`, { method: "GET" }),
-    listAppInvites: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/invitations`, { method: "GET" }),
+    listOrganizationInvites: (orgId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/organizations/${encodeURIComponent(orgId)}/invitations${suffix}`, { method: "GET" });
+    },
+    listProjectInvites: (projectId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/invitations${suffix}`, { method: "GET" });
+    },
+    listAppInvites: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/invitations${suffix}`, { method: "GET" });
+    },
     resendOrganizationInvite: (orgId, inviteId, payload) => request(`/v1/organizations/${encodeURIComponent(orgId)}/invitations/${encodeURIComponent(inviteId)}/resend`, {
       method: "POST",
       body: JSON.stringify(payload ?? {})
@@ -9102,6 +9187,7 @@ function createApiClient(config, opts) {
     revokeAppInvite: (appId, inviteId) => request(`/v1/apps/${encodeURIComponent(appId)}/invitations/${encodeURIComponent(inviteId)}`, {
       method: "DELETE"
     }),
+    acceptInvitation: (payload) => request("/v1/invitations/accept", { method: "POST", body: JSON.stringify(payload) }),
     syncUpstreamApp: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/sync-upstream`, {
       method: "POST",
       body: JSON.stringify({})
@@ -9137,7 +9223,31 @@ function createApiClient(config, opts) {
         `/v1/apps/${encodeURIComponent(appId)}/bundles/${encodeURIComponent(bundleId)}/assets/download?${qs.toString()}`,
         { method: "GET" }
       );
-    }
+    },
+    listAgentRuns: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      if (params?.status) qs.set("status", params.status);
+      if (params?.currentPhase) qs.set("currentPhase", params.currentPhase);
+      if (params?.createdAfter) qs.set("createdAfter", params.createdAfter);
+      if (params?.createdBefore) qs.set("createdBefore", params.createdBefore);
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/agent-runs${suffix}`, { method: "GET" });
+    },
+    getAgentRun: (appId, runId) => request(`/v1/apps/${encodeURIComponent(appId)}/agent-runs/${encodeURIComponent(runId)}`, { method: "GET" }),
+    listAgentRunEvents: (appId, runId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      if (params?.createdAfter) qs.set("createdAfter", params.createdAfter);
+      if (params?.createdBefore) qs.set("createdBefore", params.createdBefore);
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/agent-runs/${encodeURIComponent(runId)}/events${suffix}`, {
+        method: "GET"
+      });
+    },
+    getSandboxStatus: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/sandbox/status`, { method: "GET" })
   };
 }
 
@@ -9619,8 +9729,8 @@ function getErrorMap() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path12, errorMaps, issueData } = params;
-  const fullPath = [...path12, ...issueData.path || []];
+  const { data, path: path13, errorMaps, issueData } = params;
+  const fullPath = [...path13, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -9736,11 +9846,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path12, key) {
+  constructor(parent, value, path13, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path12;
+    this._path = path13;
     this._key = key;
   }
   get path() {
@@ -22073,8 +22183,8 @@ var IcebergError = class extends Error {
     return this.status === 419;
   }
 };
-function buildUrl(baseUrl, path12, query) {
-  const url = new URL(path12, baseUrl);
+function buildUrl(baseUrl, path13, query) {
+  const url = new URL(path13, baseUrl);
   if (query) {
     for (const [key, value] of Object.entries(query)) {
       if (value !== void 0) {
@@ -22104,12 +22214,12 @@ function createFetchClient(options) {
   return {
     async request({
       method,
-      path: path12,
+      path: path13,
       query,
       body,
       headers
     }) {
-      const url = buildUrl(options.baseUrl, path12, query);
+      const url = buildUrl(options.baseUrl, path13, query);
       const authHeaders = await buildAuthHeaders(options.auth);
       const res = await fetchFn(url, {
         method,
@@ -22928,7 +23038,7 @@ var StorageFileApi = class extends BaseApiClient {
   * @param path The relative file path. Should be of the format `folder/subfolder/filename.png`. The bucket must already exist before attempting to upload.
   * @param fileBody The body of the file to be stored in the bucket.
   */
-  async uploadOrUpdate(method, path12, fileBody, fileOptions) {
+  async uploadOrUpdate(method, path13, fileBody, fileOptions) {
     var _this = this;
     return _this.handleOperation(async () => {
       let body;
@@ -22952,7 +23062,7 @@ var StorageFileApi = class extends BaseApiClient {
         if ((typeof ReadableStream !== "undefined" && body instanceof ReadableStream || body && typeof body === "object" && "pipe" in body && typeof body.pipe === "function") && !options.duplex) options.duplex = "half";
       }
       if (fileOptions === null || fileOptions === void 0 ? void 0 : fileOptions.headers) headers = _objectSpread22(_objectSpread22({}, headers), fileOptions.headers);
-      const cleanPath = _this._removeEmptyFolders(path12);
+      const cleanPath = _this._removeEmptyFolders(path13);
       const _path = _this._getFinalPath(cleanPath);
       const data = await (method == "PUT" ? put : post)(_this.fetch, `${_this.url}/object/${_path}`, body, _objectSpread22({ headers }, (options === null || options === void 0 ? void 0 : options.duplex) ? { duplex: options.duplex } : {}));
       return {
@@ -23013,8 +23123,8 @@ var StorageFileApi = class extends BaseApiClient {
   * - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
   * - For React Native, using either `Blob`, `File` or `FormData` does not work as intended. Upload file using `ArrayBuffer` from base64 file data instead, see example below.
   */
-  async upload(path12, fileBody, fileOptions) {
-    return this.uploadOrUpdate("POST", path12, fileBody, fileOptions);
+  async upload(path13, fileBody, fileOptions) {
+    return this.uploadOrUpdate("POST", path13, fileBody, fileOptions);
   }
   /**
   * Upload a file with a token generated from `createSignedUploadUrl`.
@@ -23053,9 +23163,9 @@ var StorageFileApi = class extends BaseApiClient {
   *   - `objects` table permissions: none
   * - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
   */
-  async uploadToSignedUrl(path12, token, fileBody, fileOptions) {
+  async uploadToSignedUrl(path13, token, fileBody, fileOptions) {
     var _this3 = this;
-    const cleanPath = _this3._removeEmptyFolders(path12);
+    const cleanPath = _this3._removeEmptyFolders(path13);
     const _path = _this3._getFinalPath(cleanPath);
     const url = new URL(_this3.url + `/object/upload/sign/${_path}`);
     url.searchParams.set("token", token);
@@ -23117,10 +23227,10 @@ var StorageFileApi = class extends BaseApiClient {
   *   - `objects` table permissions: `insert`
   * - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
   */
-  async createSignedUploadUrl(path12, options) {
+  async createSignedUploadUrl(path13, options) {
     var _this4 = this;
     return _this4.handleOperation(async () => {
-      let _path = _this4._getFinalPath(path12);
+      let _path = _this4._getFinalPath(path13);
       const headers = _objectSpread22({}, _this4.headers);
       if (options === null || options === void 0 ? void 0 : options.upsert) headers["x-upsert"] = "true";
       const data = await post(_this4.fetch, `${_this4.url}/object/upload/sign/${_path}`, {}, { headers });
@@ -23129,7 +23239,7 @@ var StorageFileApi = class extends BaseApiClient {
       if (!token) throw new StorageError("No token returned by API");
       return {
         signedUrl: url.toString(),
-        path: path12,
+        path: path13,
         token
       };
     });
@@ -23185,8 +23295,8 @@ var StorageFileApi = class extends BaseApiClient {
   * - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
   * - For React Native, using either `Blob`, `File` or `FormData` does not work as intended. Update file using `ArrayBuffer` from base64 file data instead, see example below.
   */
-  async update(path12, fileBody, fileOptions) {
-    return this.uploadOrUpdate("PUT", path12, fileBody, fileOptions);
+  async update(path13, fileBody, fileOptions) {
+    return this.uploadOrUpdate("PUT", path13, fileBody, fileOptions);
   }
   /**
   * Moves an existing file to a new path in the same bucket.
@@ -23333,10 +23443,10 @@ var StorageFileApi = class extends BaseApiClient {
   *   - `objects` table permissions: `select`
   * - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
   */
-  async createSignedUrl(path12, expiresIn, options) {
+  async createSignedUrl(path13, expiresIn, options) {
     var _this8 = this;
     return _this8.handleOperation(async () => {
-      let _path = _this8._getFinalPath(path12);
+      let _path = _this8._getFinalPath(path13);
       const hasTransform = typeof (options === null || options === void 0 ? void 0 : options.transform) === "object" && options.transform !== null && Object.keys(options.transform).length > 0;
       let data = await post(_this8.fetch, `${_this8.url}/object/sign/${_path}`, _objectSpread22({ expiresIn }, hasTransform ? { transform: options.transform } : {}), { headers: _this8.headers });
       const downloadQueryParam = (options === null || options === void 0 ? void 0 : options.download) ? `&download=${options.download === true ? "" : options.download}` : "";
@@ -23463,11 +23573,11 @@ var StorageFileApi = class extends BaseApiClient {
   *   - `objects` table permissions: `select`
   * - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
   */
-  download(path12, options, parameters) {
+  download(path13, options, parameters) {
     const renderPath = typeof (options === null || options === void 0 ? void 0 : options.transform) !== "undefined" ? "render/image/authenticated" : "object";
     const transformationQuery = this.transformOptsToQueryString((options === null || options === void 0 ? void 0 : options.transform) || {});
     const queryString = transformationQuery ? `?${transformationQuery}` : "";
-    const _path = this._getFinalPath(path12);
+    const _path = this._getFinalPath(path13);
     const downloadFn = () => get(this.fetch, `${this.url}/${renderPath}/${_path}${queryString}`, {
       headers: this.headers,
       noResolveJson: true
@@ -23497,9 +23607,9 @@ var StorageFileApi = class extends BaseApiClient {
   * }
   * ```
   */
-  async info(path12) {
+  async info(path13) {
     var _this10 = this;
-    const _path = _this10._getFinalPath(path12);
+    const _path = _this10._getFinalPath(path13);
     return _this10.handleOperation(async () => {
       return recursiveToCamel(await get(_this10.fetch, `${_this10.url}/object/info/${_path}`, { headers: _this10.headers }));
     });
@@ -23519,9 +23629,9 @@ var StorageFileApi = class extends BaseApiClient {
   *   .exists('folder/avatar1.png')
   * ```
   */
-  async exists(path12) {
+  async exists(path13) {
     var _this11 = this;
-    const _path = _this11._getFinalPath(path12);
+    const _path = _this11._getFinalPath(path13);
     try {
       await head(_this11.fetch, `${_this11.url}/object/${_path}`, { headers: _this11.headers });
       return {
@@ -23598,8 +23708,8 @@ var StorageFileApi = class extends BaseApiClient {
   *   - `objects` table permissions: none
   * - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
   */
-  getPublicUrl(path12, options) {
-    const _path = this._getFinalPath(path12);
+  getPublicUrl(path13, options) {
+    const _path = this._getFinalPath(path13);
     const _queryString = [];
     const downloadQueryParam = (options === null || options === void 0 ? void 0 : options.download) ? `download=${options.download === true ? "" : options.download}` : "";
     if (downloadQueryParam !== "") _queryString.push(downloadQueryParam);
@@ -23738,10 +23848,10 @@ var StorageFileApi = class extends BaseApiClient {
   *   - `objects` table permissions: `select`
   * - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
   */
-  async list(path12, options, parameters) {
+  async list(path13, options, parameters) {
     var _this13 = this;
     return _this13.handleOperation(async () => {
-      const body = _objectSpread22(_objectSpread22(_objectSpread22({}, DEFAULT_SEARCH_OPTIONS), options), {}, { prefix: path12 || "" });
+      const body = _objectSpread22(_objectSpread22(_objectSpread22({}, DEFAULT_SEARCH_OPTIONS), options), {}, { prefix: path13 || "" });
       return await post(_this13.fetch, `${_this13.url}/object/list/${_this13.bucketId}`, body, { headers: _this13.headers }, parameters);
     });
   }
@@ -23805,11 +23915,11 @@ var StorageFileApi = class extends BaseApiClient {
     if (typeof Buffer !== "undefined") return Buffer.from(data).toString("base64");
     return btoa(data);
   }
-  _getFinalPath(path12) {
-    return `${this.bucketId}/${path12.replace(/^\/+/, "")}`;
+  _getFinalPath(path13) {
+    return `${this.bucketId}/${path13.replace(/^\/+/, "")}`;
   }
-  _removeEmptyFolders(path12) {
-    return path12.replace(/^\/|\/$/g, "").replace(/\/+/g, "/");
+  _removeEmptyFolders(path13) {
+    return path13.replace(/^\/|\/$/g, "").replace(/\/+/g, "/");
   }
   transformOptsToQueryString(transform) {
     const params = [];
@@ -33085,13 +33195,20 @@ async function createHookCollabApiClient() {
   });
 }
 
+// src/hook-diagnostics.ts
+var import_node_crypto2 = require("crypto");
+var import_promises19 = __toESM(require("fs/promises"), 1);
+var import_node_os5 = __toESM(require("os"), 1);
+var import_node_path7 = __toESM(require("path"), 1);
+
 // src/hook-state.ts
 var import_promises18 = __toESM(require("fs/promises"), 1);
 var import_node_os4 = __toESM(require("os"), 1);
 var import_node_path6 = __toESM(require("path"), 1);
 var import_node_crypto = require("crypto");
 function stateRoot() {
-  return import_node_path6.default.join(import_node_os4.default.tmpdir(), "remix-claude-plugin-hooks");
+  const configured = process.env.REMIX_CLAUDE_PLUGIN_HOOK_STATE_ROOT?.trim();
+  return configured || import_node_path6.default.join(import_node_os4.default.tmpdir(), "remix-claude-plugin-hooks");
 }
 function statePath(sessionId) {
   return import_node_path6.default.join(stateRoot(), `${sessionId}.json`);
@@ -33156,6 +33273,7 @@ async function tryRemoveStaleStateLock(sessionId) {
 async function acquireStateLock(sessionId) {
   const lockPath = stateLockPath(sessionId);
   const deadline = Date.now() + STATE_LOCK_WAIT_MS;
+  await import_promises18.default.mkdir(stateRoot(), { recursive: true });
   while (true) {
     try {
       await import_promises18.default.mkdir(lockPath);
@@ -33404,7 +33522,7 @@ async function clearPendingTurnState(sessionId) {
 // package.json
 var package_default = {
   name: "@remixhq/claude-plugin",
-  version: "0.1.11",
+  version: "0.1.14",
   description: "Claude Code plugin for Remix collaboration workflows",
   homepage: "https://github.com/RemixDotOne/remix-claude-plugin",
   license: "MIT",
@@ -33435,8 +33553,8 @@ var package_default = {
     prepack: "npm run build"
   },
   dependencies: {
-    "@remixhq/core": "^0.1.8",
-    "@remixhq/mcp": "^0.1.8"
+    "@remixhq/core": "^0.1.9",
+    "@remixhq/mcp": "^0.1.9"
   },
   devDependencies: {
     "@types/node": "^25.4.0",
@@ -33455,9 +33573,90 @@ var pluginMetadata = {
   agentName: "remix-collab"
 };
 
+// src/hook-diagnostics.ts
+var MAX_LOG_BYTES = 512 * 1024;
+function resolveClaudeRoot() {
+  const configured = process.env.CLAUDE_CONFIG_DIR?.trim();
+  return configured || import_node_path7.default.join(import_node_os5.default.homedir(), ".claude");
+}
+function resolvePluginDataDirName() {
+  return `${pluginMetadata.pluginId}-${pluginMetadata.pluginId}`;
+}
+function getHookDiagnosticsDirPath() {
+  const configured = process.env.REMIX_CLAUDE_PLUGIN_HOOK_DIAGNOSTICS_DIR?.trim();
+  return configured || import_node_path7.default.join(resolveClaudeRoot(), "plugins", "data", resolvePluginDataDirName());
+}
+function getHookDiagnosticsLogPath() {
+  return import_node_path7.default.join(getHookDiagnosticsDirPath(), "hooks.ndjson");
+}
+function toFieldValue(value) {
+  if (value === null) return null;
+  if (typeof value === "string") return value;
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "boolean") return value;
+  return void 0;
+}
+function normalizeFields(fields) {
+  if (!fields) return {};
+  const normalizedEntries = Object.entries(fields).map(([key, value]) => {
+    const normalized = toFieldValue(value);
+    return normalized === void 0 ? null : [key, normalized];
+  }).filter((entry) => entry !== null);
+  return Object.fromEntries(normalizedEntries);
+}
+async function rotateLogIfNeeded(logPath) {
+  const stat = await import_promises19.default.stat(logPath).catch(() => null);
+  if (!stat || stat.size < MAX_LOG_BYTES) {
+    return;
+  }
+  const rotatedPath = `${logPath}.1`;
+  await import_promises19.default.rm(rotatedPath, { force: true }).catch(() => void 0);
+  await import_promises19.default.rename(logPath, rotatedPath).catch(() => void 0);
+}
+function summarizeText(value) {
+  if (typeof value !== "string" || !value.trim()) {
+    return {
+      present: false,
+      length: 0,
+      sha256Prefix: null
+    };
+  }
+  const trimmed = value.trim();
+  return {
+    present: true,
+    length: trimmed.length,
+    sha256Prefix: (0, import_node_crypto2.createHash)("sha256").update(trimmed).digest("hex").slice(0, 12)
+  };
+}
+async function appendHookDiagnosticsEvent(params) {
+  try {
+    const logPath = getHookDiagnosticsLogPath();
+    await import_promises19.default.mkdir(import_node_path7.default.dirname(logPath), { recursive: true });
+    await rotateLogIfNeeded(logPath);
+    const event = {
+      ts: (/* @__PURE__ */ new Date()).toISOString(),
+      hook: params.hook,
+      pluginVersion: pluginMetadata.version,
+      pid: process.pid,
+      sessionId: params.sessionId?.trim() || null,
+      turnId: params.turnId?.trim() || null,
+      stage: params.stage.trim(),
+      result: params.result,
+      reason: params.reason?.trim() || null,
+      toolName: params.toolName?.trim() || null,
+      repoRoot: params.repoRoot?.trim() || null,
+      message: params.message?.trim() || null,
+      fields: normalizeFields(params.fields)
+    };
+    await import_promises19.default.appendFile(logPath, `${JSON.stringify(event)}
+`, "utf8");
+  } catch {
+  }
+}
+
 // src/hook-utils.ts
-var import_promises19 = __toESM(require("fs/promises"), 1);
-var import_node_path7 = __toESM(require("path"), 1);
+var import_promises20 = __toESM(require("fs/promises"), 1);
+var import_node_path8 = __toESM(require("path"), 1);
 async function readJsonStdin() {
   const chunks = [];
   for await (const chunk of process.stdin) {
@@ -33481,6 +33680,11 @@ function extractToolInput(payload) {
 function extractToolResponse(payload) {
   return getNestedRecord(payload.tool_response) ?? getNestedRecord(payload.toolResponse);
 }
+function extractToolStructuredData(payload) {
+  const toolResponse = extractToolResponse(payload);
+  const structuredContent = getNestedRecord(toolResponse?.structuredContent) ?? getNestedRecord(payload.structuredContent);
+  return getNestedRecord(toolResponse?.data) ?? getNestedRecord(structuredContent?.data) ?? structuredContent;
+}
 function extractAssistantResponse(payload) {
   const candidateKeys = [
     "last_assistant_message",
@@ -33492,7 +33696,7 @@ function extractAssistantResponse(payload) {
     "response",
     "message"
   ];
-  return extractString(payload, candidateKeys) ?? extractString(extractToolResponse(payload) ?? {}, candidateKeys) ?? extractString(extractToolInput(payload), candidateKeys);
+  return extractString(payload, candidateKeys) ?? extractString(extractToolResponse(payload) ?? {}, candidateKeys) ?? extractString(extractToolStructuredData(payload) ?? {}, candidateKeys) ?? extractString(extractToolInput(payload), candidateKeys);
 }
 function extractString(input, keys) {
   for (const key of keys) {
@@ -33514,16 +33718,16 @@ function extractBoolean(input, keys) {
 }
 async function findBoundRepo(startPath) {
   if (!startPath) return null;
-  let current = import_node_path7.default.resolve(startPath);
-  let stats = await import_promises19.default.stat(current).catch(() => null);
+  let current = import_node_path8.default.resolve(startPath);
+  let stats = await import_promises20.default.stat(current).catch(() => null);
   if (stats?.isFile()) {
-    current = import_node_path7.default.dirname(current);
+    current = import_node_path8.default.dirname(current);
   }
   while (true) {
-    const bindingPath = import_node_path7.default.join(current, ".remix", "config.json");
-    const bindingStats = await import_promises19.default.stat(bindingPath).catch(() => null);
+    const bindingPath = import_node_path8.default.join(current, ".remix", "config.json");
+    const bindingStats = await import_promises20.default.stat(bindingPath).catch(() => null);
     if (bindingStats?.isFile()) return current;
-    const parent = import_node_path7.default.dirname(current);
+    const parent = import_node_path8.default.dirname(current);
     if (parent === current) return null;
     current = parent;
   }
@@ -33552,52 +33756,52 @@ function getErrorDetails(error) {
   if (error instanceof Error) {
     const hint = typeof error.hint === "string" ? String(error.hint) : null;
     return {
-      message: error.message || "Automatic Remix turn recording failed.",
+      message: error.message || "Fallback Remix turn recording failed.",
       hint
     };
   }
-  const message = typeof error === "string" && error.trim() ? error.trim() : "Automatic Remix turn recording failed.";
+  const message = typeof error === "string" && error.trim() ? error.trim() : "Fallback Remix turn recording failed.";
   return { message, hint: null };
 }
 function getRecordingBlockedMessage(status, repoRoot) {
   switch (status.status) {
     case "not_git_repo":
       return {
-        message: "Automatic Remix turn recording failed because the repository is no longer inside a git repository.",
+        message: "Fallback Remix turn recording failed because the repository is no longer inside a git repository.",
         hint: status.hint || `Repo root: ${repoRoot}`
       };
     case "not_bound":
       return {
-        message: "Automatic Remix turn recording failed because the repository is no longer bound to Remix.",
+        message: "Fallback Remix turn recording failed because the repository is no longer bound to Remix.",
         hint: status.hint || `Repo root: ${repoRoot}`
       };
     case "missing_head":
       return {
-        message: "Automatic Remix turn recording failed because the repository HEAD could not be resolved.",
+        message: "Fallback Remix turn recording failed because the repository HEAD could not be resolved.",
         hint: status.hint || `Repo root: ${repoRoot}`
       };
     case "branch_mismatch":
       return {
-        message: "Automatic Remix turn recording was blocked by the checkout's preferred-branch policy.",
+        message: "Fallback Remix turn recording was blocked by the checkout's preferred-branch policy.",
         hint: status.hint || `Repo root: ${repoRoot}`
       };
     case "metadata_conflict":
       return {
-        message: "Automatic Remix turn recording was blocked because local repository metadata conflicts with the bound Remix app.",
+        message: "Fallback Remix turn recording was blocked because local repository metadata conflicts with the bound Remix app.",
         hint: status.hint || `Repo root: ${repoRoot}`
       };
     case "reconcile_required":
       return {
-        message: "Automatic Remix turn recording was blocked because the repository must be reconciled before recording can continue safely.",
+        message: "Fallback Remix turn recording was blocked because the repository must be reconciled before recording can continue safely.",
         hint: status.hint || `Repo root: ${repoRoot}`
       };
     default:
       return null;
   }
 }
-function buildRepoIdempotencyKey(turnId, repo, mode) {
+function buildRepoIdempotencyKey(turnId, repo) {
   const repoToken = repo.currentAppId?.trim() || repo.repoRoot;
-  return `${turnId}:${repoToken}:${mode}`;
+  return `${turnId}:${repoToken}:finalize_turn`;
 }
 function shouldSkipStopRecording(repo) {
   if (repo.stopRecorded) {
@@ -33650,21 +33854,64 @@ function createFallbackTouchedRepo(params) {
   };
 }
 async function recordTouchedRepo(params) {
-  const { sessionId, turnId, repo, prompt, assistantResponse, api } = params;
+  const { hook, sessionId, turnId, repo, prompt, assistantResponse, api } = params;
   await markTouchedRepoStopAttempted(sessionId, repo.repoRoot);
+  await appendHookDiagnosticsEvent({
+    hook,
+    sessionId,
+    turnId,
+    stage: "recording_started",
+    result: "info",
+    repoRoot: repo.repoRoot,
+    fields: {
+      hasObservedWrite: repo.hasObservedWrite,
+      manuallyRecorded: repo.manuallyRecorded,
+      stopAttempted: true
+    }
+  });
   try {
     const binding = await readCollabBinding(repo.repoRoot).catch(() => null);
     if (!binding) {
       await markTouchedRepoRecordingFailure(sessionId, repo.repoRoot, {
-        message: "Automatic Remix turn recording failed because the repository is no longer bound to Remix.",
+        message: "Fallback Remix turn recording failed because the repository is no longer bound to Remix.",
         hint: `Repo root: ${repo.repoRoot}`
       });
+      await appendHookDiagnosticsEvent({
+        hook,
+        sessionId,
+        turnId,
+        stage: "binding_lookup",
+        result: "error",
+        reason: "repo_not_bound",
+        repoRoot: repo.repoRoot
+      });
       return false;
     }
     const workspaceDiff = await getWorkspaceDiff(repo.repoRoot);
     if (workspaceDiff.diff.trim()) {
+      await appendHookDiagnosticsEvent({
+        hook,
+        sessionId,
+        turnId,
+        stage: "workspace_diff_checked",
+        result: "info",
+        repoRoot: repo.repoRoot,
+        fields: {
+          hasWorkspaceDiff: true,
+          diffLength: workspaceDiff.diff.length
+        }
+      });
       if (repo.manualRemoteChangeRecordedAt && !hasNewObservedWriteSince(repo.manualRemoteChangeRecordedAt, repo)) {
         await markTouchedRepoStopRecorded(sessionId, repo.repoRoot, { mode: "changed_turn" });
+        await appendHookDiagnosticsEvent({
+          hook,
+          sessionId,
+          turnId,
+          stage: "recording_skipped",
+          result: "success",
+          reason: "manual_recording_already_covers_diff",
+          repoRoot: repo.repoRoot
+        });
         return true;
       }
       const recordingPreflight2 = await collabRecordingPreflight({
@@ -33674,6 +33921,19 @@ async function recordTouchedRepo(params) {
       const blocked2 = getRecordingBlockedMessage(recordingPreflight2, repo.repoRoot);
       if (blocked2) {
         await markTouchedRepoRecordingFailure(sessionId, repo.repoRoot, blocked2);
+        await appendHookDiagnosticsEvent({
+          hook,
+          sessionId,
+          turnId,
+          stage: "recording_preflight",
+          result: "error",
+          reason: recordingPreflight2.status,
+          repoRoot: repo.repoRoot,
+          message: blocked2.message,
+          fields: {
+            hint: blocked2.hint
+          }
+        });
         return false;
       }
       await collabAdd({
@@ -33682,12 +33942,33 @@ async function recordTouchedRepo(params) {
         prompt,
         assistantResponse,
         diffSource: "worktree",
-        idempotencyKey: buildRepoIdempotencyKey(turnId, repo, "changed_turn"),
+        idempotencyKey: buildRepoIdempotencyKey(turnId, repo),
         actor: HOOK_ACTOR
       });
       await markTouchedRepoStopRecorded(sessionId, repo.repoRoot, { mode: "changed_turn" });
+      await appendHookDiagnosticsEvent({
+        hook,
+        sessionId,
+        turnId,
+        stage: "recording_completed",
+        result: "success",
+        reason: "changed_turn_recorded",
+        repoRoot: repo.repoRoot
+      });
       return true;
     }
+    await appendHookDiagnosticsEvent({
+      hook,
+      sessionId,
+      turnId,
+      stage: "workspace_diff_checked",
+      result: "info",
+      repoRoot: repo.repoRoot,
+      fields: {
+        hasWorkspaceDiff: false,
+        diffLength: 0
+      }
+    });
     const recordingPreflight = await collabRecordingPreflight({
       api,
       cwd: repo.repoRoot
@@ -33695,6 +33976,19 @@ async function recordTouchedRepo(params) {
     const blocked = getRecordingBlockedMessage(recordingPreflight, repo.repoRoot);
     if (blocked) {
       await markTouchedRepoRecordingFailure(sessionId, repo.repoRoot, blocked);
+      await appendHookDiagnosticsEvent({
+        hook,
+        sessionId,
+        turnId,
+        stage: "recording_preflight",
+        result: "error",
+        reason: recordingPreflight.status,
+        repoRoot: repo.repoRoot,
+        message: blocked.message,
+        fields: {
+          hint: blocked.hint
+        }
+      });
       return false;
     }
     await collabRecordTurn({
@@ -33702,36 +33996,116 @@ async function recordTouchedRepo(params) {
       cwd: repo.repoRoot,
       prompt,
       assistantResponse,
-      idempotencyKey: buildRepoIdempotencyKey(turnId, repo, "no_diff_turn"),
+      idempotencyKey: buildRepoIdempotencyKey(turnId, repo),
       actor: HOOK_ACTOR
     });
     await markTouchedRepoStopRecorded(sessionId, repo.repoRoot, { mode: "no_diff_turn" });
+    await appendHookDiagnosticsEvent({
+      hook,
+      sessionId,
+      turnId,
+      stage: "recording_completed",
+      result: "success",
+      reason: "no_diff_turn_recorded",
+      repoRoot: repo.repoRoot
+    });
     return true;
   } catch (error) {
     const details = getErrorDetails(error);
     await markTouchedRepoRecordingFailure(sessionId, repo.repoRoot, details);
+    await appendHookDiagnosticsEvent({
+      hook,
+      sessionId,
+      turnId,
+      stage: "recording_failed",
+      result: "error",
+      reason: "exception",
+      repoRoot: repo.repoRoot,
+      message: details.message,
+      fields: {
+        hint: details.hint
+      }
+    });
     return false;
   }
 }
-async function main() {
-  const payload = await readJsonStdin();
+async function runHookStopCollab(payload) {
+  const hook = "Stop";
   if (extractBoolean(payload, ["stop_hook_active"])) {
+    await appendHookDiagnosticsEvent({
+      hook,
+      stage: "reentrancy_guard",
+      result: "skip",
+      reason: "stop_hook_active"
+    });
     return;
   }
   const sessionId = extractString(payload, ["session_id"]);
+  await appendHookDiagnosticsEvent({
+    hook,
+    sessionId,
+    stage: "payload_received",
+    result: "start",
+    fields: {
+      hasSessionId: Boolean(sessionId),
+      hasStopHookActive: Boolean(extractBoolean(payload, ["stop_hook_active"])),
+      hasAssistantResponse: summarizeText(extractAssistantResponse(payload)).present
+    }
+  });
   if (!sessionId) {
+    await appendHookDiagnosticsEvent({
+      hook,
+      stage: "payload_validation",
+      result: "skip",
+      reason: "missing_session_id"
+    });
     return;
   }
   const state = await loadPendingTurnState(sessionId);
   if (!state) {
+    await appendHookDiagnosticsEvent({
+      hook,
+      sessionId,
+      stage: "state_lookup",
+      result: "skip",
+      reason: "pending_state_not_found"
+    });
     return;
   }
+  await appendHookDiagnosticsEvent({
+    hook,
+    sessionId,
+    turnId: state.turnId,
+    stage: "state_loaded",
+    result: "info",
+    fields: {
+      consultedMemory: state.consultedMemory,
+      touchedRepoCount: Object.keys(state.touchedRepos).length,
+      hasTurnFailure: Boolean(state.turnFailureMessage)
+    }
+  });
   try {
     let touchedRepos = await listTouchedRepos(sessionId);
     if (touchedRepos.length === 0) {
       const fallbackRepo = await resolveBoundRepoSummary(state.initialCwd);
       if (!fallbackRepo) {
         await clearPendingTurnState(sessionId);
+        await appendHookDiagnosticsEvent({
+          hook,
+          sessionId,
+          turnId: state.turnId,
+          stage: "fallback_repo_lookup",
+          result: "skip",
+          reason: "no_bound_repo_for_fallback"
+        });
+        await appendHookDiagnosticsEvent({
+          hook,
+          sessionId,
+          turnId: state.turnId,
+          stage: "state_cleanup",
+          result: "success",
+          reason: "cleared_without_bound_repo"
+        });
         return;
       }
       await upsertTouchedRepo(sessionId, {
@@ -33746,22 +34120,80 @@ async function main() {
       if (touchedRepos.length === 0) {
         touchedRepos = [createFallbackTouchedRepo(fallbackRepo)];
       }
+      await appendHookDiagnosticsEvent({
+        hook,
+        sessionId,
+        turnId: state.turnId,
+        stage: "fallback_repo_lookup",
+        result: "info",
+        repoRoot: fallbackRepo.repoRoot,
+        fields: {
+          touchedRepoCount: touchedRepos.length
+        }
+      });
     }
     const prompt = state.prompt.trim();
     const assistantResponse = (extractAssistantResponse(payload) || "").trim();
+    const promptSummary = summarizeText(prompt);
+    const assistantResponseSummary = summarizeText(assistantResponse);
+    await appendHookDiagnosticsEvent({
+      hook,
+      sessionId,
+      turnId: state.turnId,
+      stage: "response_summary",
+      result: "info",
+      fields: {
+        promptLength: promptSummary.length,
+        promptHash: promptSummary.sha256Prefix,
+        assistantResponseLength: assistantResponseSummary.length,
+        assistantResponseHash: assistantResponseSummary.sha256Prefix
+      }
+    });
     if (!prompt || !assistantResponse) {
       await markPendingTurnFailure(sessionId, {
-        message: "Automatic Remix turn recording failed because the prompt or assistant response was missing."
+        message: "Fallback Remix turn recording failed because the prompt or assistant response was missing."
+      });
+      await appendHookDiagnosticsEvent({
+        hook,
+        sessionId,
+        turnId: state.turnId,
+        stage: "response_validation",
+        result: "error",
+        reason: !prompt ? "missing_prompt" : "missing_assistant_response"
       });
       return;
     }
     const api = await createHookCollabApiClient();
+    await appendHookDiagnosticsEvent({
+      hook,
+      sessionId,
+      turnId: state.turnId,
+      stage: "api_client_created",
+      result: "success",
+      fields: {
+        touchedRepoCount: touchedRepos.length
+      }
+    });
     let hadFailure = false;
     for (const repo of touchedRepos) {
       if (shouldSkipStopRecording(repo)) {
+        await appendHookDiagnosticsEvent({
+          hook,
+          sessionId,
+          turnId: state.turnId,
+          stage: "recording_skipped",
+          result: "info",
+          reason: "skip_stop_recording",
+          repoRoot: repo.repoRoot,
+          fields: {
+            manuallyRecorded: repo.manuallyRecorded,
+            stopRecorded: repo.stopRecorded
+          }
+        });
         continue;
       }
       const recorded = await recordTouchedRepo({
+        hook,
         sessionId,
         turnId: state.turnId,
         repo,
@@ -33775,16 +34207,60 @@ async function main() {
     }
     if (!hadFailure) {
       await clearPendingTurnState(sessionId);
+      await appendHookDiagnosticsEvent({
+        hook,
+        sessionId,
+        turnId: state.turnId,
+        stage: "state_cleanup",
+        result: "success",
+        reason: "cleared_after_success"
+      });
+      return;
     }
+    await appendHookDiagnosticsEvent({
+      hook,
+      sessionId,
+      turnId: state.turnId,
+      stage: "state_cleanup",
+      result: "info",
+      reason: "retained_after_failure"
+    });
   } catch (error) {
     const details = getErrorDetails(error);
     await markPendingTurnFailure(sessionId, details);
+    await appendHookDiagnosticsEvent({
+      hook,
+      sessionId,
+      turnId: state.turnId,
+      stage: "turn_failed",
+      result: "error",
+      reason: "exception",
+      message: details.message,
+      fields: {
+        hint: details.hint
+      }
+    });
   }
 }
+async function main() {
+  const payload = await readJsonStdin();
+  await runHookStopCollab(payload);
+}
 main().catch((error) => {
   const message = error instanceof Error ? error.message : String(error);
+  void appendHookDiagnosticsEvent({
+    hook: "Stop",
+    stage: "unhandled_error",
+    result: "error",
+    reason: "exception",
+    message
+  });
   process.stderr.write(`${message}
 `);
   process.exitCode = 0;
 });
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runHookStopCollab
+});
 //# sourceMappingURL=hook-stop-collab.cjs.map