@useorgx/wizard 0.1.65 → 0.1.67

package/README.md

@@ -32,7 +32,7 @@ The wizard modifies local tool configuration only. Depending on the command, it
 - Every profile or preview writes both the full evidence report and a compact, machine-safe `work-graph-agent-brief-*.md` with provenance, the growth edge, and a ready prompt for the smallest verifiable repair.
 - `work-graph preview --from all` shows the same profile story locally without publishing.
 - `work-graph runtime-event --source codex|claude --summary "..."` lets an agent write public-safe runtime evidence that the next AQ profile can collect.
-- `hooks install [--targets codex,claude-code]` installs bounded local capture hooks. Terminal events write compact session summaries to a durable queue, then request a detached single-flight delivery worker. The hook does not read credentials or perform network I/O. Set `ORGX_SESSION_SUMMARY_AUTO_FLUSH=off` for local-only capture and manual delivery. The legacy transcript-derived execution-graph emit remains off unless `ORGX_EMIT_EXECUTION_GRAPH=1` is set.
+- `hooks install [--targets codex,claude-code]` installs bounded local capture hooks. Terminal session events and adapter-supplied `RunEnd` events write compact summaries to a durable queue, then request a detached single-flight delivery worker. `RunEnd` represents one completed agent run inside a conversation that may continue. Receipt-ready captures remain queued until the server confirms that the automatic receipt was persisted; a session-only 2xx response is not enough. The hook does not read credentials or perform network I/O. Set `ORGX_SESSION_SUMMARY_AUTO_FLUSH=off` for local-only capture and manual delivery. The legacy transcript-derived execution-graph emit remains off unless `ORGX_EMIT_EXECUTION_GRAPH=1` is set.
 - `ORGX_SESSION_WORK_CONTEXT` can carry one explicit, bounded JSON annotation for intent, authority, cost, artifact and evidence references, plus exact Context Capsule, decision, constraint, expectation, applied-learning, and prior-receipt references. Capsule delivery requires both the capsule reference and delivery timestamp. The Wizard does not infer this context from prompts; invalid or oversized annotations are omitted, and unknown fields are removed before cloud delivery.
 - `hooks flush [--limit 100]` is the manual delivery and recovery path. It uses the same queue lease as automatic delivery and removes each valid file only after a successful server acknowledgement. Failed captures stay queued for retry; malformed captures move to the owner-only `session-summary-captures/quarantine/` directory and make a manual flush fail visibly without being deleted.
 - `hooks doctor` shows hook wiring, automatic-delivery configuration, active and quarantined capture counts, and the legacy spool count without changing local configuration.

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // 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]="af54c3d7-9ef3-5d66-90dc-45a9ecb71d96")}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]="20c1b754-5691-5226-9f34-921cdff2d9f8")}catch(e){}}();
 import * as clack from "@clack/prompts";
 import { spawnSync as spawnSync5 } from "child_process";
 import { readFileSync as readFileSync10 } from "fs";
@@ -6354,7 +6354,7 @@ function initializeWizardSentry() {
   Sentry.init({
     dsn,
     environment: process.env.ORGX_SENTRY_ENVIRONMENT || "production",
-    release: "useorgx-wizard@0.1.65",
+    release: "useorgx-wizard@0.1.67",
     tracesSampleRate: sampleRate(process.env.ORGX_SENTRY_TRACES_SAMPLE_RATE),
     enableLogs: true,
     sendDefaultPii: false,
@@ -13969,7 +13969,9 @@ function actionResult(event, sourceClient) {
   // Claude's PostToolUse contract fires only after success. Codex documents
   // PostToolUse for completed tools, including non-zero Bash exits, so its
   // outcome must remain explicitly unclassified without reading tool output.
-  return sourceClient === "claude-code" ? "succeeded" : "completed_unknown";
+  return sourceClient === "claude-code" || sourceClient === "cursor" || sourceClient === "opencode"
+    ? "succeeded"
+    : "completed_unknown";
 }
 
 function pendingIndex(state, toolUseId) {
@@ -14135,7 +14137,7 @@ function buildExecutionObservation(state, captureKind) {
   return {
     schema_version: "orgx-session-execution-observation/v1",
     boundary: captureKind || "legacy_unspecified",
-    terminal_observed: captureKind === "session_end",
+    terminal_observed: captureKind === "run_end" || captureKind === "session_end",
     actions: actions,
     actions_completed_observed: state.tool_calls,
     actions_omitted: omitted,
@@ -14443,7 +14445,15 @@ export async function main(options) {
   var explicitWorkContext = parseExplicitWorkContext(env.ORGX_SESSION_WORK_CONTEXT);
 
   var event = pickString(args.event, payload.hook_event_name, payload.hookEventName, "unknown");
-  var sessionId = pickString(payload.session_id, payload.sessionId, args.session_id);
+  var sessionId = pickString(
+    payload.session_id,
+    payload.sessionId,
+    payload.conversation_id,
+    payload.conversationId,
+    payload.thread_id,
+    payload.threadId,
+    args.session_id
+  );
   if (!sessionId) return { ok: true, skipped: "missing_session_id" };
 
   var sourceClient = pickString(args.source_client, env.ORGX_SOURCE_CLIENT, "claude-code");
@@ -14451,7 +14461,7 @@ export async function main(options) {
   var stateDir = dir ? dir : pickString(args.state_dir, env.ORGX_SESSION_STATE_DIR);
   var path = statePath(sessionId, stateDir);
 
-  var terminal = event === "Stop" || event === "SessionEnd";
+  var terminal = event === "Stop" || event === "RunEnd" || event === "SessionEnd";
 
   if (!terminal) {
     // Hot path: one small file read + write. Never a network call.
@@ -14487,13 +14497,17 @@ export async function main(options) {
   if (explicitWorkContext) finalState.work_context = explicitWorkContext;
   var initiativeId = pickString(env.ORGX_INITIATIVE_ID, args.initiative);
   var queueDir = pickString(args.queue_dir, env.ORGX_SESSION_SUMMARY_QUEUE_DIR) || defaultQueueDir();
-  var captureKind = event === "SessionEnd" ? "session_end" : "turn_boundary";
+  var captureKind = event === "SessionEnd"
+    ? "session_end"
+    : event === "RunEnd"
+    ? "run_end"
+    : "turn_boundary";
   var summary = buildSummary(finalState, nowIso, captureKind);
   var queued = enqueueSummaryCapture(queueDir, summary, initiativeId, nowIso, captureKind);
   if (!queued) return { ok: true, skipped: "queue_write_failed", summary: summary };
   var deliveryTriggered = triggerQueueDelivery(args, env, queueDir, spawnImpl);
 
-  if (event === "SessionEnd") {
+  if (event === "RunEnd" || event === "SessionEnd") {
     try {
       rmSync(path, { force: true });
     } catch (e) {
@@ -14506,7 +14520,7 @@ export async function main(options) {
     queued: true,
     queue_path: queued.path,
     delivery_triggered: deliveryTriggered,
-    final: event === "SessionEnd",
+    final: event === "RunEnd" || event === "SessionEnd",
     summary: summary,
   };
 }
@@ -15397,6 +15411,7 @@ function normalizeSessionExecutionObservation(value) {
   const boundary = boundedString(value.boundary, 40);
   if (!boundary || ![
     "turn_boundary",
+    "run_end",
     "session_end",
     "historical_backfill",
     "legacy_unspecified"
@@ -15676,6 +15691,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";
@@ -15710,7 +15743,7 @@ function parseSessionSummaryCapture(raw) {
       // Captures created by wizard 0.1.56 before this field existed must remain
       // deliverable. Preserve the uncertainty instead of guessing that an old
       // snapshot represented a real SessionEnd.
-      capture_kind: value.capture_kind === "turn_boundary" || value.capture_kind === "session_end" ? value.capture_kind : "legacy_unspecified",
+      capture_kind: value.capture_kind === "turn_boundary" || value.capture_kind === "run_end" || value.capture_kind === "session_end" ? value.capture_kind : "legacy_unspecified",
       queued_at: value.queued_at,
       session: value.session,
       ...typeof value.initiative_id === "string" ? { initiative_id: value.initiative_id } : {}
@@ -15786,7 +15819,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);
@@ -15805,11 +15840,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 };
     }
@@ -16711,6 +16756,13 @@ 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) {
@@ -16726,6 +16778,8 @@ async function runSessionSummaryFlushCommand(options) {
       malformed: 0,
       quarantined: 0,
       fallbackAcknowledged: 0,
+      receiptExpected: 0,
+      receiptAcknowledged: 0,
       skipped: "empty_queue"
     };
   } else {
@@ -16743,6 +16797,8 @@ async function runSessionSummaryFlushCommand(options) {
         malformed: 0,
         quarantined: 0,
         fallbackAcknowledged: 0,
+        receiptExpected: 0,
+        receiptAcknowledged: 0,
         skipped: "already_running"
       };
     } else {
@@ -16768,7 +16824,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 };
             }
@@ -18563,7 +18629,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.65" : void 0;
+  const pkgVersion = true ? "0.1.67" : void 0;
   program.version(pkgVersion ?? "unknown", "-V, --version");
   program.hook("preAction", (_thisCommand, actionCommand) => {
     if (Boolean(actionCommand.optsWithGlobals().json)) return;
@@ -19607,4 +19673,4 @@ main().catch(async (error) => {
   process.exitCode = 1;
 });
 //# sourceMappingURL=cli.js.map
-//# debugId=af54c3d7-9ef3-5d66-90dc-45a9ecb71d96
+//# debugId=20c1b754-5691-5226-9f34-921cdff2d9f8