@useorgx/wizard 0.1.66 → 0.1.68

package/dist/cli.js

@@ -2,12 +2,12 @@
 
 // src/cli.ts
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="783f771d-d176-55f3-b036-2be49833854e")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4b5dd32d-184b-560a-ae80-e8a055ae1bc4")}catch(e){}}();
 import * as clack from "@clack/prompts";
 import { spawnSync as spawnSync5 } from "child_process";
 import { readFileSync as readFileSync10 } from "fs";
 import { hostname } from "os";
-import { resolve as resolve4 } from "path";
+import { resolve as resolve5 } from "path";
 import { Command } from "commander";
 import pc3 from "picocolors";
 
@@ -837,7 +837,7 @@ function parsePairingPollResult(value) {
   };
 }
 function sleep(ms) {
-  return new Promise((resolve5) => setTimeout(resolve5, ms));
+  return new Promise((resolve6) => setTimeout(resolve6, ms));
 }
 async function startBrowserPairing(options, fetchImpl) {
   const data = await fetchJson({
@@ -950,12 +950,12 @@ h1{font-size:1.5rem;color:#b91c1c}p{color:#555;margin-top:.5rem}</style>
 <p>Return to your terminal and try again.</p>
 </div></body></html>`;
 function tryListen(port, hostname2) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const server = createServer();
     server.once("error", reject);
     server.listen(port, hostname2, () => {
       server.removeListener("error", reject);
-      resolve5(server);
+      resolve6(server);
     });
   });
 }
@@ -984,7 +984,7 @@ async function startLocalAuthServer(options) {
   const successHtml = options.successHtml ?? DEFAULT_SUCCESS_HTML;
   const errorHtml = options.errorHtml ?? DEFAULT_ERROR_HTML;
   const { server, port } = await bindServer(options.preferredPort, hostname2);
-  const result = new Promise((resolve5, reject) => {
+  const result = new Promise((resolve6, reject) => {
     const timer = setTimeout(() => {
       server.close();
       reject(new Error("Timed out waiting for browser authorization."));
@@ -1027,7 +1027,7 @@ async function startLocalAuthServer(options) {
       res.writeHead(200, { "Content-Type": "text/html" }).end(successHtml);
       clearTimeout(timer);
       server.close();
-      resolve5({ code, state });
+      resolve6({ code, state });
     });
   });
   return { port, result };
@@ -4013,7 +4013,7 @@ function formatCommandFailure(command, args, result) {
   return `${command} ${args.join(" ")} failed${result.exitCode >= 0 ? ` with exit code ${result.exitCode}` : ""}${detail ? `: ${detail}` : "."}`;
 }
 async function defaultCommandRunner(command, args) {
-  return await new Promise((resolve5) => {
+  return await new Promise((resolve6) => {
     const child = spawn(command, [...args], {
       env: process.env,
       stdio: ["ignore", "pipe", "pipe"]
@@ -4028,7 +4028,7 @@ async function defaultCommandRunner(command, args) {
     });
     child.on("error", (error) => {
       const errorCode2 = typeof error === "object" && error && "code" in error ? String(error.code) : void 0;
-      resolve5({
+      resolve6({
         exitCode: -1,
         stdout,
         stderr,
@@ -4036,7 +4036,7 @@ async function defaultCommandRunner(command, args) {
       });
     });
     child.on("close", (code) => {
-      resolve5({
+      resolve6({
         exitCode: code ?? -1,
         stdout,
         stderr
@@ -6354,7 +6354,7 @@ function initializeWizardSentry() {
   Sentry.init({
     dsn,
     environment: process.env.ORGX_SENTRY_ENVIRONMENT || "production",
-    release: "useorgx-wizard@0.1.66",
+    release: "useorgx-wizard@0.1.68",
     tracesSampleRate: sampleRate(process.env.ORGX_SENTRY_TRACES_SAMPLE_RATE),
     enableLogs: true,
     sendDefaultPii: false,
@@ -13766,9 +13766,9 @@ function buildWorkGraphHookReplayPatch(readResult) {
 }
 
 // src/lib/runtime-hooks.ts
-import { copyFileSync, existsSync as existsSync9, mkdirSync as mkdirSync4, readdirSync as readdirSync6 } from "fs";
-import { homedir as homedir3 } from "os";
-import { dirname as dirname5, join as join8, resolve as resolve2 } from "path";
+import { copyFileSync, existsSync as existsSync10, mkdirSync as mkdirSync4, readdirSync as readdirSync6 } from "fs";
+import { homedir as homedir4 } from "os";
+import { dirname as dirname6, join as join9, resolve as resolve3 } from "path";
 
 // src/lib/session-summary-hook.ts
 var SESSION_SUMMARY_HOOK_MARKER = "orgx-session-summary.mjs";
@@ -14535,6 +14535,141 @@ if (invokedDirectly) {
 `;
 }
 
+// src/lib/client-continuity.ts
+import { existsSync as existsSync9 } from "fs";
+import { homedir as homedir3 } from "os";
+import { dirname as dirname5, join as join8, resolve as resolve2 } from "path";
+var CLIENT_CONTINUITY_SCHEMA_VERSION = "orgx-client-continuity/v1";
+function readJson(path) {
+  return parseJsonObject(readTextIfExists(path));
+}
+function string(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function sharedCaptureReady(options) {
+  return options.shared.summaryHookInstalled && options.shared.automaticDelivery;
+}
+function sharedNextAction(options) {
+  return sharedCaptureReady(options) ? null : "Run orgx-wizard hooks install --targets all, then re-run hooks doctor --json.";
+}
+function wizardHookStatus(client, installed, options) {
+  const captureReady = installed && sharedCaptureReady(options);
+  const warnings = [
+    ...!installed ? [`${client} runtime hooks are not installed.`] : [],
+    ...!options.shared.summaryHookInstalled ? ["The shared bounded session-summary hook is missing."] : [],
+    ...!options.shared.automaticDelivery ? ["ACK-gated automatic delivery is not configured."] : []
+  ];
+  return {
+    client,
+    state: captureReady ? "ready" : installed ? "attention_required" : "not_installed",
+    installed,
+    adapterVersion: null,
+    captureReady,
+    terminalBoundary: "session_end",
+    warnings,
+    nextAction: captureReady ? null : installed ? sharedNextAction(options) : `Run orgx-wizard hooks install --targets ${client}, then re-run hooks doctor --json.`
+  };
+}
+function cursorStatus(paths, options) {
+  const manifest = readJson(paths.cursorManifestPath);
+  const hooks = readJson(paths.cursorHooksPath);
+  const hookMap = hooks.hooks && typeof hooks.hooks === "object" && !Array.isArray(hooks.hooks) ? hooks.hooks : {};
+  const installed = existsSync9(paths.cursorManifestPath) && existsSync9(paths.cursorHooksPath);
+  const hasRunBoundary = ["afterAgentResponse", "stop", "sessionEnd"].every(
+    (name) => Array.isArray(hookMap[name]) && hookMap[name].length > 0
+  );
+  const captureReady = installed && hasRunBoundary && sharedCaptureReady(options);
+  const warnings = [
+    ...!installed ? ["The managed Cursor companion plugin is not installed."] : [],
+    ...installed && !hasRunBoundary ? ["Cursor is missing one or more terminal receipt hooks."] : [],
+    ...!options.shared.summaryHookInstalled ? ["The shared bounded session-summary hook is missing."] : [],
+    ...!options.shared.automaticDelivery ? ["ACK-gated automatic delivery is not configured."] : []
+  ];
+  return {
+    client: "cursor",
+    state: captureReady ? "ready" : installed ? "attention_required" : "not_installed",
+    installed,
+    adapterVersion: string(manifest.version),
+    captureReady,
+    terminalBoundary: "stop/session_end (afterAgentResponse CLI fallback)",
+    warnings,
+    nextAction: captureReady ? null : !installed || !hasRunBoundary ? "Run orgx-wizard plugins add cursor, reload Cursor, then re-run hooks doctor --json." : sharedNextAction(options)
+  };
+}
+function openCodeStatus(paths, options) {
+  const packageJson = readJson(paths.openCodePackagePath);
+  const packageName = string(packageJson.name);
+  const entry = string(packageJson.main) ?? "dist/index.js";
+  const entryPath = resolve2(dirname5(paths.openCodePackagePath), entry);
+  const bridgePath = join8(dirname5(entryPath), "sessionSummaryBridge.js");
+  const bridge = readTextIfExists(bridgePath);
+  const installed = packageName === "@useorgx/orgx-opencode-plugin" && existsSync9(entryPath);
+  const hasRunBoundary = Boolean(
+    bridge?.includes("session.idle") && bridge.includes("RunEnd")
+  );
+  const captureReady = installed && hasRunBoundary && sharedCaptureReady(options);
+  const warnings = [
+    ...!installed ? ["The stable OrgX OpenCode plugin entry point is not installed."] : [],
+    ...installed && !hasRunBoundary ? ["OpenCode is missing the session.idle to RunEnd bridge."] : [],
+    ...!options.shared.summaryHookInstalled ? ["The shared bounded session-summary hook is missing."] : [],
+    ...!options.shared.automaticDelivery ? ["ACK-gated automatic delivery is not configured."] : []
+  ];
+  return {
+    client: "opencode",
+    state: captureReady ? "ready" : installed ? "attention_required" : "not_installed",
+    installed,
+    adapterVersion: string(packageJson.version),
+    captureReady,
+    terminalBoundary: "session.idle -> run_end",
+    warnings,
+    nextAction: captureReady ? null : !installed || !hasRunBoundary ? "Install the current @useorgx/orgx-opencode-plugin alpha package, then re-run hooks doctor --json." : sharedNextAction(options)
+  };
+}
+function clientContinuityPathsForHome(home = homedir3()) {
+  return {
+    cursorManifestPath: join8(
+      home,
+      ".cursor",
+      "plugins",
+      "local",
+      "cursor-plugin",
+      ".cursor-plugin",
+      "plugin.json"
+    ),
+    cursorHooksPath: join8(
+      home,
+      ".cursor",
+      "plugins",
+      "local",
+      "cursor-plugin",
+      "hooks",
+      "hooks.json"
+    ),
+    openCodePackagePath: join8(
+      home,
+      ".config",
+      "opencode",
+      "plugins",
+      "orgx-opencode-plugin",
+      "package.json"
+    )
+  };
+}
+function inspectClientContinuity(options) {
+  const paths = { ...clientContinuityPathsForHome(), ...options.paths };
+  const clients = [
+    wizardHookStatus("claude-code", options.shared.claudeCodeInstalled, options),
+    wizardHookStatus("codex", options.shared.codexInstalled, options),
+    cursorStatus(paths, options),
+    openCodeStatus(paths, options)
+  ];
+  return {
+    schemaVersion: CLIENT_CONTINUITY_SCHEMA_VERSION,
+    state: clients.every((client) => client.captureReady) ? "ready" : "attention_required",
+    clients
+  };
+}
+
 // src/lib/runtime-hooks.ts
 var HOOK_MARKER = "orgx-session-hook.mjs";
 var EMIT_HOOK_MARKER = "orgx-emit-execution-graph.mjs";
@@ -14561,23 +14696,23 @@ var CLAUDE_HOOK_EVENTS = [
 ];
 function currentPackagedCliPath() {
   if (!process.argv[1]) return "";
-  const candidate = resolve2(process.argv[1]);
+  const candidate = resolve3(process.argv[1]);
   return /\.(?:cts|mts|ts|tsx)$/i.test(candidate) ? "" : candidate;
 }
 function defaultPaths(options = {}) {
-  const hookDir = join8(ORGX_WIZARD_CONFIG_HOME, "hooks");
+  const hookDir = join9(ORGX_WIZARD_CONFIG_HOME, "hooks");
   return {
-    claudeSettingsPath: options.claudeSettingsPath ?? join8(CLAUDE_DIR, "settings.json"),
-    codexConfigPath: options.codexConfigPath ?? CODEX_CONFIG_PATH ?? join8(CODEX_DIR, "config.toml"),
-    codexHooksPath: options.codexHooksPath ?? join8(CODEX_DIR, "hooks.json"),
-    hookScriptPath: options.hookScriptPath ?? join8(hookDir, HOOK_MARKER),
-    emitHookScriptPath: options.emitHookScriptPath ?? join8(hookDir, EMIT_HOOK_MARKER),
-    summaryHookScriptPath: options.summaryHookScriptPath ?? join8(hookDir, SUMMARY_HOOK_MARKER),
-    sessionStateDir: options.sessionStateDir ?? join8(ORGX_WIZARD_CONFIG_HOME, "sessions"),
-    sessionSummaryQueueDir: options.sessionSummaryQueueDir ?? join8(ORGX_WIZARD_CONFIG_HOME, "session-summary-captures"),
+    claudeSettingsPath: options.claudeSettingsPath ?? join9(CLAUDE_DIR, "settings.json"),
+    codexConfigPath: options.codexConfigPath ?? CODEX_CONFIG_PATH ?? join9(CODEX_DIR, "config.toml"),
+    codexHooksPath: options.codexHooksPath ?? join9(CODEX_DIR, "hooks.json"),
+    hookScriptPath: options.hookScriptPath ?? join9(hookDir, HOOK_MARKER),
+    emitHookScriptPath: options.emitHookScriptPath ?? join9(hookDir, EMIT_HOOK_MARKER),
+    summaryHookScriptPath: options.summaryHookScriptPath ?? join9(hookDir, SUMMARY_HOOK_MARKER),
+    sessionStateDir: options.sessionStateDir ?? join9(ORGX_WIZARD_CONFIG_HOME, "sessions"),
+    sessionSummaryQueueDir: options.sessionSummaryQueueDir ?? join9(ORGX_WIZARD_CONFIG_HOME, "session-summary-captures"),
     deliveryNodePath: options.deliveryNodePath ?? process.execPath,
     deliveryCliPath: options.deliveryCliPath ?? currentPackagedCliPath(),
-    outboxPath: options.outboxPath ?? join8(hookDir, "events.jsonl")
+    outboxPath: options.outboxPath ?? join9(hookDir, "events.jsonl")
   };
 }
 function countJsonlLines(path) {
@@ -14594,7 +14729,7 @@ function countSessionSummaryCaptures(path) {
 }
 function countSessionSummaryQuarantinedCaptures(path) {
   try {
-    return readdirSync6(join8(path, "quarantine")).filter(
+    return readdirSync6(join9(path, "quarantine")).filter(
       (name) => name.includes(".malformed")
     ).length;
   } catch {
@@ -14606,7 +14741,7 @@ function backupPath(path, now) {
   return `${path}.bak.${timestamp}`;
 }
 function backupExisting(path, now) {
-  if (!existsSync9(path)) return null;
+  if (!existsSync10(path)) return null;
   const backup = backupPath(path, now);
   copyFileSync(path, backup);
   return backup;
@@ -15117,18 +15252,28 @@ function inspectRuntimeHooks(options = {}) {
   const codexHooksRaw = readTextIfExists(paths.codexHooksPath);
   const claudeSettingsRaw = readTextIfExists(paths.claudeSettingsPath);
   const hasAutomaticDelivery = (raw) => Boolean(
-    raw && raw.includes("--delivery_node=") && raw.includes("--delivery_cli=") && raw.includes(paths.deliveryNodePath) && raw.includes(paths.deliveryCliPath) && existsSync9(paths.deliveryNodePath) && existsSync9(paths.deliveryCliPath)
+    raw && raw.includes("--delivery_node=") && raw.includes("--delivery_cli=") && raw.includes(paths.deliveryNodePath) && raw.includes(paths.deliveryCliPath) && existsSync10(paths.deliveryNodePath) && existsSync10(paths.deliveryCliPath)
   );
+  const installed = {
+    claudeCode: hasOrgxHook(claudeSettingsRaw),
+    codex: hasOrgxHook(codexHooksRaw),
+    hookScript: existsSync10(paths.hookScriptPath),
+    emitHookScript: existsSync10(paths.emitHookScriptPath),
+    summaryHookScript: existsSync10(paths.summaryHookScriptPath),
+    automaticDelivery: hasAutomaticDelivery(codexHooksRaw) || hasAutomaticDelivery(claudeSettingsRaw)
+  };
   return {
     paths,
-    installed: {
-      claudeCode: hasOrgxHook(claudeSettingsRaw),
-      codex: hasOrgxHook(codexHooksRaw),
-      hookScript: existsSync9(paths.hookScriptPath),
-      emitHookScript: existsSync9(paths.emitHookScriptPath),
-      summaryHookScript: existsSync9(paths.summaryHookScriptPath),
-      automaticDelivery: hasAutomaticDelivery(codexHooksRaw) || hasAutomaticDelivery(claudeSettingsRaw)
-    },
+    continuity: inspectClientContinuity({
+      ...options.clientContinuityPaths ? { paths: options.clientContinuityPaths } : {},
+      shared: {
+        automaticDelivery: installed.automaticDelivery,
+        claudeCodeInstalled: installed.claudeCode,
+        codexInstalled: installed.codex,
+        summaryHookInstalled: installed.summaryHookScript
+      }
+    }),
+    installed,
     codex: {
       configExists: Boolean(codexConfigRaw),
       hooksEnabled: codexHooksEnabled(codexConfigRaw),
@@ -15154,7 +15299,7 @@ function installRuntimeHooks(targets, options = {}) {
     emitHookScript: false,
     summaryHookScript: false
   };
-  mkdirSync4(dirname5(paths.hookScriptPath), { recursive: true, mode: 448 });
+  mkdirSync4(dirname6(paths.hookScriptPath), { recursive: true, mode: 448 });
   const scriptContent = buildRuntimeHookScriptContent();
   if (readTextIfExists(paths.hookScriptPath) !== scriptContent) {
     const backup = backupExisting(paths.hookScriptPath, now);
@@ -15162,7 +15307,7 @@ function installRuntimeHooks(targets, options = {}) {
     writeTextFile(paths.hookScriptPath, scriptContent, { mode: 448 });
     changed.hookScript = true;
   }
-  mkdirSync4(dirname5(paths.emitHookScriptPath), { recursive: true, mode: 448 });
+  mkdirSync4(dirname6(paths.emitHookScriptPath), { recursive: true, mode: 448 });
   const emitScriptContent = buildExecutionGraphEmitScriptContent();
   if (readTextIfExists(paths.emitHookScriptPath) !== emitScriptContent) {
     const backup = backupExisting(paths.emitHookScriptPath, now);
@@ -15170,7 +15315,7 @@ function installRuntimeHooks(targets, options = {}) {
     writeTextFile(paths.emitHookScriptPath, emitScriptContent, { mode: 448 });
     changed.emitHookScript = true;
   }
-  mkdirSync4(dirname5(paths.summaryHookScriptPath), { recursive: true, mode: 448 });
+  mkdirSync4(dirname6(paths.summaryHookScriptPath), { recursive: true, mode: 448 });
   const summaryScriptContent = buildSessionSummaryHookScriptContent();
   if (readTextIfExists(paths.summaryHookScriptPath) !== summaryScriptContent) {
     const backup = backupExisting(paths.summaryHookScriptPath, now);
@@ -15232,14 +15377,14 @@ function parseRuntimeHookTargets(value) {
 // src/lib/session-summary-queue.ts
 import {
   chmodSync as chmodSync2,
-  existsSync as existsSync10,
+  existsSync as existsSync11,
   mkdirSync as mkdirSync5,
   readdirSync as readdirSync7,
   readFileSync as readFileSync8,
   renameSync as renameSync3,
   unlinkSync as unlinkSync2
 } from "fs";
-import { basename as basename6, join as join9 } from "path";
+import { basename as basename6, join as join10 } from "path";
 
 // src/lib/session-summary-backfill.ts
 import { createReadStream, renameSync as renameSync2, statSync as statSync5, writeFileSync as writeFileSync4 } from "fs";
@@ -15654,27 +15799,27 @@ var SESSION_SUMMARY_CAPTURE_MAX_BYTES = 16 * 1024;
 var SESSION_SUMMARY_QUARANTINE_DIR_NAME = "quarantine";
 var SESSION_SUMMARY_QUARANTINE_FILE_SUFFIX = ".malformed";
 function sessionSummaryCaptureFiles(queueDir) {
-  if (!existsSync10(queueDir)) return [];
+  if (!existsSync11(queueDir)) return [];
   try {
-    return readdirSync7(queueDir).filter((name) => name.endsWith(SESSION_SUMMARY_CAPTURE_FILE_SUFFIX)).sort().map((name) => join9(queueDir, name));
+    return readdirSync7(queueDir).filter((name) => name.endsWith(SESSION_SUMMARY_CAPTURE_FILE_SUFFIX)).sort().map((name) => join10(queueDir, name));
   } catch {
     return [];
   }
 }
 function sessionSummaryQuarantineDir(queueDir) {
-  return join9(queueDir, SESSION_SUMMARY_QUARANTINE_DIR_NAME);
+  return join10(queueDir, SESSION_SUMMARY_QUARANTINE_DIR_NAME);
 }
 function quarantineMalformedCapture(path, queueDir) {
   const quarantineDir = sessionSummaryQuarantineDir(queueDir);
   try {
     mkdirSync5(quarantineDir, { recursive: true, mode: 448 });
-    const baseTarget = join9(
+    const baseTarget = join10(
       quarantineDir,
       `${basename6(path)}${SESSION_SUMMARY_QUARANTINE_FILE_SUFFIX}`
     );
     let target = baseTarget;
     let collision = 0;
-    while (existsSync10(target)) {
+    while (existsSync11(target)) {
       collision += 1;
       target = `${baseTarget}.${collision}`;
     }
@@ -15691,6 +15836,24 @@ function quarantineMalformedCapture(path, queueDir) {
 function isRecord4(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
+function expectsAutomaticReceipt(body) {
+  const session = isRecord4(body.session) ? body.session : {};
+  const metadata = isRecord4(session.metadata) ? session.metadata : {};
+  const capture = isRecord4(metadata.capture) ? metadata.capture : {};
+  const execution = isRecord4(metadata.execution) ? metadata.execution : {};
+  const workContext = isRecord4(metadata.work_context) ? metadata.work_context : {};
+  const actions = Array.isArray(execution.actions) ? execution.actions : [];
+  const completed = execution.actions_completed_observed;
+  return (capture.kind === "run_end" || capture.kind === "session_end") && execution.boundary === capture.kind && execution.terminal_observed === true && execution.action_capture_complete === true && typeof completed === "number" && completed > 0 && session.tool_calls === completed && execution.actions_omitted === 0 && execution.start_times_omitted === 0 && execution.pending_actions === 0 && actions.length === completed && actions.every((value) => {
+    const action = isRecord4(value) ? value : {};
+    return action.status !== "running" && typeof action.started_at === "string" && typeof action.completed_at === "string";
+  }) && isRecord4(workContext.intent) && isRecord4(workContext.authority) && isRecord4(workContext.cost);
+}
+function confirmsAutomaticReceipt(response) {
+  const body = isRecord4(response.body) ? response.body : {};
+  const receipt = isRecord4(body.automatic_receipt) ? body.automatic_receipt : {};
+  return receipt.ready === true && receipt.persisted === true && typeof receipt.receipt_id === "string" && receipt.receipt_id.length > 0;
+}
 function isSessionSummary(value) {
   if (!isRecord4(value)) return false;
   return typeof value.schema_version === "string" && typeof value.session_id === "string" && typeof value.source_client === "string";
@@ -15801,7 +15964,9 @@ async function flushSessionSummaryCaptures(options) {
     retained: 0,
     malformed: 0,
     quarantined: 0,
-    fallbackAcknowledged: 0
+    fallbackAcknowledged: 0,
+    receiptExpected: 0,
+    receiptAcknowledged: 0
   };
   for (const path of selected) {
     const capture = readSessionSummaryCapture(path);
@@ -15820,11 +15985,21 @@ async function flushSessionSummaryCaptures(options) {
     let response;
     let usedFallback = false;
     try {
-      response = await options.send(primaryUrl, deliveryBody(capture), headers);
+      const body = deliveryBody(capture);
+      const receiptExpected = expectsAutomaticReceipt(body);
+      if (receiptExpected) result.receiptExpected += 1;
+      response = await options.send(primaryUrl, body, headers);
       if (!response.ok && (response.status === 404 || response.status === 405)) {
         response = await options.send(fallbackUrl, buildWorkGraphFallback(capture), headers);
         usedFallback = true;
       }
+      if (response.ok && receiptExpected && !confirmsAutomaticReceipt(response)) {
+        result.retained += 1;
+        result.firstError ??= `HTTP ${response.status} did not confirm automatic receipt persistence for ${capture.capture_id}`;
+        if (options.stopOnFailure) break;
+        continue;
+      }
+      if (response.ok && receiptExpected) result.receiptAcknowledged += 1;
     } catch {
       response = { ok: false, status: 0 };
     }
@@ -15859,7 +16034,7 @@ import {
   unlinkSync as unlinkSync3,
   writeSync
 } from "fs";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 var SESSION_SUMMARY_FLUSH_LOCK_NAME = ".flush.lock";
 var SESSION_SUMMARY_FLUSH_MAX_AGE_MS = 2 * 60 * 60 * 1e3;
 var MALFORMED_LOCK_GRACE_MS = 5 * 60 * 1e3;
@@ -15928,7 +16103,7 @@ function claimSessionSummaryFlushLease(queueDir, options = {}) {
   const pid = options.pid ?? process.pid;
   const token = options.token ?? randomUUID3();
   const isProcessAlive = options.isProcessAlive ?? processIsAlive;
-  const path = join10(queueDir, SESSION_SUMMARY_FLUSH_LOCK_NAME);
+  const path = join11(queueDir, SESSION_SUMMARY_FLUSH_LOCK_NAME);
   const record = { token, pid, claimed_at: now.toISOString() };
   try {
     mkdirSync6(queueDir, { recursive: true, mode: 448 });
@@ -15986,7 +16161,7 @@ function createOrgxSpinner(text2) {
 
 // src/lib/workload-diagnosis.ts
 import { closeSync as closeSync3, openSync as openSync3, readSync as readSync2 } from "fs";
-import { resolve as resolve3 } from "path";
+import { resolve as resolve4 } from "path";
 
 // src/lib/workload-diagnosis-schema.ts
 import { z as z2 } from "zod";
@@ -16339,7 +16514,7 @@ var MAX_HANDOFF_TOKEN_CHARACTERS = 7e3;
 var SENSITIVE_KEY2 = /(?:^|[_-])(?:authorization|cookie|credentials?|password|secrets?|session|tokens?|api[_-]?keys?|access[_-]?tokens?|refresh[_-]?tokens?|client[_-]?secrets?|private[_-]?keys?|database[_-]?(?:url|uri)|db[_-]?(?:url|uri))(?:$|[_-])/i;
 function readBoundedUtf8(source) {
   const shouldClose = source !== "-";
-  const fd = shouldClose ? openSync3(resolve3(source), "r") : 0;
+  const fd = shouldClose ? openSync3(resolve4(source), "r") : 0;
   const buffer = Buffer.alloc(MAX_WORKLOAD_DIAGNOSIS_REQUEST_BYTES + 1);
   let offset = 0;
   try {
@@ -16715,6 +16890,9 @@ function printRuntimeHookInspection(report) {
   console.log(`  ${ICON.skip}  ${pc3.bold("capture queue")} ${pc3.dim(`${report.sessionSummaryCaptures} capture${report.sessionSummaryCaptures === 1 ? "" : "s"} at ${report.paths.sessionSummaryQueueDir}`)}`);
   console.log(`  ${report.sessionSummaryQuarantinedCaptures === 0 ? ICON.skip : ICON.warn}  ${pc3.bold("quarantine   ")} ${pc3.dim(`${report.sessionSummaryQuarantinedCaptures} malformed capture${report.sessionSummaryQuarantinedCaptures === 1 ? "" : "s"}, recoverable on disk`)}`);
   console.log(`  ${ICON.skip}  ${pc3.bold("outbox      ")} ${pc3.dim(`${report.outboxEvents} event${report.outboxEvents === 1 ? "" : "s"} at ${report.paths.outboxPath}`)}`);
+  for (const client of report.continuity.clients) {
+    console.log(`  ${client.captureReady ? ICON.ok : ICON.warn}  ${pc3.bold(client.client.padEnd(12))} ${client.captureReady ? pc3.green("capture ready") : pc3.yellow(client.state.replaceAll("_", " "))}  ${pc3.dim(client.adapterVersion ?? client.terminalBoundary)}`);
+  }
 }
 function printSessionSummaryFlush(result) {
   if (result.skipped) {
@@ -16726,10 +16904,17 @@ function printSessionSummaryFlush(result) {
   if (result.fallbackAcknowledged > 0) {
     console.log(`  ${ICON.warn}  ${pc3.bold("fallback    ")} ${pc3.dim(`${result.fallbackAcknowledged} capture(s) delivered through the legacy Work Graph endpoint`)}`);
   }
+  if (result.receiptExpected > 0) {
+    const receiptStatus = `${result.receiptAcknowledged}/${result.receiptExpected} persisted`;
+    const receiptIcon = result.receiptAcknowledged === result.receiptExpected ? ICON.ok : ICON.warn;
+    console.log(
+      `  ${receiptIcon}  ${pc3.bold("receipts    ")} ${pc3.dim(receiptStatus)}`
+    );
+  }
   if (result.firstError) console.log(`  ${ICON.warn}  ${pc3.dim(result.firstError)}`);
 }
 async function runSessionSummaryFlushCommand(options) {
-  const queueDir = resolve4(options.queue?.trim() || inspectRuntimeHooks().paths.sessionSummaryQueueDir);
+  const queueDir = resolve5(options.queue?.trim() || inspectRuntimeHooks().paths.sessionSummaryQueueDir);
   const found = sessionSummaryCaptureFiles(queueDir).length;
   let result;
   if (found === 0) {
@@ -16741,6 +16926,8 @@ async function runSessionSummaryFlushCommand(options) {
       malformed: 0,
       quarantined: 0,
       fallbackAcknowledged: 0,
+      receiptExpected: 0,
+      receiptAcknowledged: 0,
       skipped: "empty_queue"
     };
   } else {
@@ -16758,6 +16945,8 @@ async function runSessionSummaryFlushCommand(options) {
         malformed: 0,
         quarantined: 0,
         fallbackAcknowledged: 0,
+        receiptExpected: 0,
+        receiptAcknowledged: 0,
         skipped: "already_running"
       };
     } else {
@@ -16783,7 +16972,17 @@ async function runSessionSummaryFlushCommand(options) {
                 },
                 options.background ? { timeoutMs: 8e3, retries: 0 } : { timeoutMs: 12e3, retries: 1 }
               );
-              return { ok: response.ok, status: response.status };
+              let responseBody;
+              try {
+                responseBody = await response.json();
+              } catch {
+                responseBody = void 0;
+              }
+              return {
+                ok: response.ok,
+                status: response.status,
+                body: responseBody
+              };
             } catch {
               return { ok: false, status: 0 };
             }
@@ -16811,7 +17010,7 @@ async function runSessionSummaryFlushCommand(options) {
 }
 async function runHookBackfillCommand(options) {
   const paths = inspectRuntimeHooks().paths;
-  const spoolPath = resolve4(options.spool?.trim() || paths.outboxPath);
+  const spoolPath = resolve5(options.spool?.trim() || paths.outboxPath);
   if (!fileExists(spoolPath)) {
     const message = `No hook spool found at ${spoolPath}`;
     if (options.json) {
@@ -16909,7 +17108,7 @@ async function runHookReplayCommand(options) {
   }
   const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
   const paths = inspectRuntimeHooks().paths;
-  const outboxPath = resolve4(options.outbox?.trim() || paths.outboxPath);
+  const outboxPath = resolve5(options.outbox?.trim() || paths.outboxPath);
   const readResult = readRuntimeHookOutbox(outboxPath, parsePositiveInt(options.limit, 200));
   const replay = buildWorkGraphHookReplayPatch(readResult);
   if (replay.records === 0) {
@@ -16941,7 +17140,7 @@ async function runHookReplayCommand(options) {
 }
 function readAuditInput(options, interactive) {
   if (options.input?.trim()) {
-    return readFileSync10(resolve4(options.input.trim()), "utf8");
+    return readFileSync10(resolve5(options.input.trim()), "utf8");
   }
   if (!process.stdin.isTTY) {
     return readFileSync10(0, "utf8");
@@ -16976,7 +17175,7 @@ function collectPathOption(value, previous = []) {
   ];
 }
 function parseClientExtractionFile(path) {
-  const resolvedPath = resolve4(path);
+  const resolvedPath = resolve5(path);
   const parsed = JSON.parse(readFileSync10(resolvedPath, "utf8"));
   if (!isRecord(parsed)) {
     throw new Error(`AI-client extraction must be a JSON object: ${resolvedPath}`);
@@ -16999,8 +17198,8 @@ async function readAuditImports(options, interactive) {
   const missingSources = [];
   if (sources.length > 0) {
     const imported = loadAiSessionImports({
-      ...options.claudeProjectsDir?.trim() ? { claudeProjectsDir: resolve4(options.claudeProjectsDir.trim()) } : {},
-      ...options.codexSessionsDir?.trim() ? { codexSessionsDir: resolve4(options.codexSessionsDir.trim()) } : {},
+      ...options.claudeProjectsDir?.trim() ? { claudeProjectsDir: resolve5(options.claudeProjectsDir.trim()) } : {},
+      ...options.codexSessionsDir?.trim() ? { codexSessionsDir: resolve5(options.codexSessionsDir.trim()) } : {},
       limitPerSource: parsePositiveInteger(options.sessionLimit, 3, "--session-limit"),
       sinceDays: parsePositiveInteger(options.sessionDays, 30, "--session-days"),
       sources
@@ -17040,8 +17239,8 @@ async function readWorkGraphInputs(options, interactive) {
   const clientExtractions = readClientExtractions(options);
   const investigationSources = parseInvestigationSourceList(options.from);
   const investigationSourceData = investigationSources.length > 0 ? loadWorkGraphInvestigationSourceData({
-    ...options.claudeProjectsDir?.trim() ? { claudeProjectsDir: resolve4(options.claudeProjectsDir.trim()) } : {},
-    ...options.codexSessionsDir?.trim() ? { codexSessionsDir: resolve4(options.codexSessionsDir.trim()) } : {},
+    ...options.claudeProjectsDir?.trim() ? { claudeProjectsDir: resolve5(options.claudeProjectsDir.trim()) } : {},
+    ...options.codexSessionsDir?.trim() ? { codexSessionsDir: resolve5(options.codexSessionsDir.trim()) } : {},
     cwd: process.cwd(),
     limitPerSource: parsePositiveInteger(options.sessionLimit, 8, "--session-limit"),
     sinceDays: parsePositiveInteger(options.sessionDays, 45, "--session-days"),
@@ -17158,10 +17357,10 @@ async function runAuditCommand(options) {
     workspace
   });
   const markdown = renderSelfAuditMarkdown(plan);
-  const outputDir = resolve4(options.outputDir?.trim() || ".orgx/audits");
+  const outputDir = resolve5(options.outputDir?.trim() || ".orgx/audits");
   const timestamp = plan.generated_at.replace(/[:.]/g, "-");
-  const jsonPath = resolve4(outputDir, `ai-native-self-audit-${timestamp}.json`);
-  const markdownPath = resolve4(outputDir, `ai-native-self-audit-${timestamp}.md`);
+  const jsonPath = resolve5(outputDir, `ai-native-self-audit-${timestamp}.json`);
+  const markdownPath = resolve5(outputDir, `ai-native-self-audit-${timestamp}.md`);
   writeJsonFile(jsonPath, plan);
   writeTextFile(markdownPath, markdown);
   if (options.json) {
@@ -17292,7 +17491,7 @@ async function runOperatingMapCommand(queryParts, options) {
 }
 function runWorkGraphExtractionSchemaCommand(options) {
   const protocol = buildWorkGraphExtractionProtocol();
-  const outputPath = options.output?.trim() ? resolve4(options.output.trim()) : "";
+  const outputPath = options.output?.trim() ? resolve5(options.output.trim()) : "";
   if (outputPath) {
     if (options.json) {
       writeJsonFile(outputPath, protocol);
@@ -17322,8 +17521,8 @@ function normalizeRuntimePacketRole(role) {
 }
 function runWorkGraphRuntimeEventCommand(options) {
   const source = normalizeRuntimePacketSource(options.source);
-  const cwd = resolve4(options.cwd?.trim() || process.cwd());
-  const outputRoot = resolve4(cwd, options.outputDir?.trim() || ".orgx/work-graph/runtime-events");
+  const cwd = resolve5(options.cwd?.trim() || process.cwd());
+  const outputRoot = resolve5(cwd, options.outputDir?.trim() || ".orgx/work-graph/runtime-events");
   const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
   const timestamp = generatedAt.replace(/[:.]/g, "-");
   const summary = options.summary?.trim() || options.message?.trim();
@@ -17344,7 +17543,7 @@ function runWorkGraphRuntimeEventCommand(options) {
     collection_method: "runtime_packet",
     redaction_state: "agent_redacted"
   };
-  const path = resolve4(outputRoot, source, `${timestamp}-${process.pid}.jsonl`);
+  const path = resolve5(outputRoot, source, `${timestamp}-${process.pid}.jsonl`);
   writeTextFile(path, `${JSON.stringify(packet)}
 `, { mode: 384 });
   if (options.json) {
@@ -17387,11 +17586,11 @@ async function runWorkGraphCommand(options, defaults = {}) {
     workspace
   });
   const markdown = renderWorkGraphMarkdown(report);
-  const outputDir = resolve4(commandOptions.outputDir?.trim() || ".orgx/work-graph");
+  const outputDir = resolve5(commandOptions.outputDir?.trim() || ".orgx/work-graph");
   const timestamp = report.generated_at.replace(/[:.]/g, "-");
-  const jsonPath = resolve4(outputDir, `work-graph-report-${timestamp}.json`);
-  const markdownPath = resolve4(outputDir, `work-graph-report-${timestamp}.md`);
-  const agentBriefPath = resolve4(outputDir, `work-graph-agent-brief-${timestamp}.md`);
+  const jsonPath = resolve5(outputDir, `work-graph-report-${timestamp}.json`);
+  const markdownPath = resolve5(outputDir, `work-graph-report-${timestamp}.md`);
+  const agentBriefPath = resolve5(outputDir, `work-graph-agent-brief-${timestamp}.md`);
   writeJsonFile(jsonPath, report);
   writeTextFile(markdownPath, markdown);
   let published = null;
@@ -17806,14 +18005,14 @@ async function readSingleKey() {
   const stdin = process.stdin;
   if (!stdin.isTTY) return null;
   const previousRawMode = stdin.isRaw === true;
-  return await new Promise((resolve5) => {
+  return await new Promise((resolve6) => {
     const cleanup = (result) => {
       stdin.off("data", onData);
       if (stdin.isTTY) {
         stdin.setRawMode(previousRawMode);
       }
       stdin.pause();
-      resolve5(result);
+      resolve6(result);
     };
     const onData = (chunk) => {
       const text2 = chunk.toString("utf8");
@@ -18578,7 +18777,7 @@ async function main() {
   initializeWizardSentry();
   const program = new Command();
   program.name("orgx-wizard").description("Add OrgX MCP configs, skills/rules, and companion plugins to your local AI tools.").showHelpAfterError();
-  const pkgVersion = true ? "0.1.66" : void 0;
+  const pkgVersion = true ? "0.1.68" : void 0;
   program.version(pkgVersion ?? "unknown", "-V, --version");
   program.hook("preAction", (_thisCommand, actionCommand) => {
     if (Boolean(actionCommand.optsWithGlobals().json)) return;
@@ -19342,7 +19541,7 @@ async function main() {
     await runWorkGraphCommand(options, { from: "all" });
   });
   const hooks = program.command("hooks").description("Inspect or install passive OrgX runtime hooks for local agent clients.");
-  hooks.command("doctor").description("Show Codex and Claude Code runtime hook wiring status.").option("--json", "emit a JSON command summary").action(async (options) => {
+  hooks.command("doctor").description("Show four-client continuity, runtime hook, queue, and delivery status.").option("--json", "emit a JSON command summary").action(async (options) => {
     const report = inspectRuntimeHooks();
     await safeTrackWizardTelemetry("hooks_doctor_ran", {
       command: "hooks doctor",
@@ -19622,4 +19821,4 @@ main().catch(async (error) => {
   process.exitCode = 1;
 });
 //# sourceMappingURL=cli.js.map
-//# debugId=783f771d-d176-55f3-b036-2be49833854e
+//# debugId=4b5dd32d-184b-560a-ae80-e8a055ae1bc4