@useorgx/wizard 0.1.66 → 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 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. 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]="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]="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.66",
+    release: "useorgx-wizard@0.1.67",
     tracesSampleRate: sampleRate(process.env.ORGX_SENTRY_TRACES_SAMPLE_RATE),
     enableLogs: true,
     sendDefaultPii: false,
@@ -15691,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";
@@ -15801,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);
@@ -15820,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 };
     }
@@ -16726,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) {
@@ -16741,6 +16778,8 @@ async function runSessionSummaryFlushCommand(options) {
       malformed: 0,
       quarantined: 0,
       fallbackAcknowledged: 0,
+      receiptExpected: 0,
+      receiptAcknowledged: 0,
       skipped: "empty_queue"
     };
   } else {
@@ -16758,6 +16797,8 @@ async function runSessionSummaryFlushCommand(options) {
         malformed: 0,
         quarantined: 0,
         fallbackAcknowledged: 0,
+        receiptExpected: 0,
+        receiptAcknowledged: 0,
         skipped: "already_running"
       };
     } else {
@@ -16783,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 };
             }
@@ -18578,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.66" : 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;
@@ -19622,4 +19673,4 @@ main().catch(async (error) => {
   process.exitCode = 1;
 });
 //# sourceMappingURL=cli.js.map
-//# debugId=783f771d-d176-55f3-b036-2be49833854e
+//# debugId=20c1b754-5691-5226-9f34-921cdff2d9f8