@useorgx/wizard 0.1.64 → 0.1.66

package/README.md

@@ -32,8 +32,8 @@ 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.
-- `ORGX_SESSION_WORK_CONTEXT` can carry one explicit, bounded JSON annotation for intent, authority, cost, artifact references, and evidence references. The Wizard does not infer this context from prompts; invalid or oversized annotations are omitted, and unknown fields are removed before cloud delivery.
+- `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.
+- `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.
 - `hooks backfill` previews compact summaries distilled from the legacy spool. It does not upload or archive anything unless you add `--post --yes`; `--truncate` also requires both flags and archives the original spool only after every upload succeeds.

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]="cf979138-322b-5229-81f2-931f9cdf95d2")}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]="783f771d-d176-55f3-b036-2be49833854e")}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.64",
+    release: "useorgx-wizard@0.1.66",
     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,
@@ -14281,7 +14283,7 @@ function workRefs(value) {
 
 function workIso(value) {
   var text = workString(value, 100);
-  return text && /^d{4}-d{2}-d{2}Td{2}:d{2}:d{2}(?:.d+)?(?:Z|[+-]d{2}:d{2})$/.test(text) && !Number.isNaN(Date.parse(text))
+  return text && /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$/.test(text) && !Number.isNaN(Date.parse(text))
     ? text
     : null;
 }
@@ -14316,6 +14318,18 @@ export function parseExplicitWorkContext(value) {
   var validUntil = authority.valid_until === undefined ? undefined : workIso(authority.valid_until);
   var artifactRefs = workRefs(parsed.artifact_refs);
   var evidenceRefs = workRefs(parsed.evidence_refs);
+  var semantic = parsed.semantic_refs === undefined ? undefined : workObject(parsed.semantic_refs);
+  var contextCapsuleRef = !semantic || semantic.context_capsule_ref === undefined
+    ? undefined
+    : workRef(semantic.context_capsule_ref);
+  var contextDeliveredAt = !semantic || semantic.context_delivered_at === undefined
+    ? undefined
+    : workIso(semantic.context_delivered_at);
+  var decisionRefs = !semantic ? [] : workRefs(semantic.decision_refs);
+  var constraintRefs = !semantic ? [] : workRefs(semantic.constraint_refs);
+  var expectationRefs = !semantic ? [] : workRefs(semantic.expectation_refs);
+  var learningRefs = !semantic ? [] : workRefs(semantic.learning_refs);
+  var priorReceiptRefs = !semantic ? [] : workRefs(semantic.prior_receipt_refs);
   var currency = workString(cost.currency, 12);
   var source = cost.source === undefined ? undefined : workString(cost.source, 120);
   if (!summary || objective === null || acceptance === null || intentConstraints === null || requestRef === null) return null;
@@ -14326,6 +14340,11 @@ export function parseExplicitWorkContext(value) {
   if (!currency || !/^[A-Z][A-Z0-9_-]{1,11}$/.test(currency) || typeof cost.total !== "number" || !Number.isFinite(cost.total) || cost.total < 0 || cost.total > 100000 || source === null) return null;
   if (cost.estimated !== undefined && typeof cost.estimated !== "boolean") return null;
   if (artifactRefs === null || evidenceRefs === null) return null;
+  if (parsed.semantic_refs !== undefined && !semantic) return null;
+  if (contextCapsuleRef === null || contextDeliveredAt === null || decisionRefs === null || constraintRefs === null || expectationRefs === null || learningRefs === null || priorReceiptRefs === null) return null;
+  if (Boolean(contextCapsuleRef) !== Boolean(contextDeliveredAt)) return null;
+  var semanticRefCount = decisionRefs.length + constraintRefs.length + expectationRefs.length + learningRefs.length + priorReceiptRefs.length + (contextCapsuleRef ? 1 : 0);
+  if (semantic !== undefined && (semanticRefCount === 0 || semanticRefCount > 20)) return null;
   var normalizedIntent = { summary: summary, acceptance_criteria: acceptance, constraints: intentConstraints };
   if (objective) normalizedIntent.objective = objective;
   if (requestRef) normalizedIntent.request_ref = requestRef;
@@ -14341,6 +14360,20 @@ export function parseExplicitWorkContext(value) {
   if (validUntil) normalizedAuthority.valid_until = validUntil;
   var normalizedCost = { currency: currency, total: cost.total, estimated: cost.estimated !== false };
   if (source) normalizedCost.source = source;
+  var normalizedSemantic;
+  if (semantic !== undefined) {
+    normalizedSemantic = {
+      decision_refs: decisionRefs,
+      constraint_refs: constraintRefs,
+      expectation_refs: expectationRefs,
+      learning_refs: learningRefs,
+      prior_receipt_refs: priorReceiptRefs,
+    };
+    if (contextCapsuleRef) {
+      normalizedSemantic.context_capsule_ref = contextCapsuleRef;
+      normalizedSemantic.context_delivered_at = contextDeliveredAt;
+    }
+  }
   return {
     schema_version: "orgx-session-work-context/v1",
     provenance: "producer_asserted",
@@ -14349,6 +14382,7 @@ export function parseExplicitWorkContext(value) {
     cost: normalizedCost,
     artifact_refs: artifactRefs,
     evidence_refs: evidenceRefs,
+    ...(normalizedSemantic ? { semantic_refs: normalizedSemantic } : {}),
   };
 }
 
@@ -14411,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");
@@ -14419,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.
@@ -14455,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) {
@@ -14474,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,
   };
 }
@@ -15227,6 +15273,29 @@ var referenceList = z.array(externalReferenceSchema).max(20).default([]).transfo
     return a < b ? -1 : a > b ? 1 : 0;
   });
 });
+var semanticReferencesSchema = z.object({
+  context_capsule_ref: externalReferenceSchema.optional(),
+  context_delivered_at: z.string().datetime({ offset: true }).optional(),
+  decision_refs: referenceList,
+  constraint_refs: referenceList,
+  expectation_refs: referenceList,
+  learning_refs: referenceList,
+  prior_receipt_refs: referenceList
+}).superRefine((value, context) => {
+  if (Boolean(value.context_capsule_ref) !== Boolean(value.context_delivered_at)) {
+    context.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "context_capsule_ref and context_delivered_at must be supplied together"
+    });
+  }
+  const totalRefs = value.decision_refs.length + value.constraint_refs.length + value.expectation_refs.length + value.learning_refs.length + value.prior_receipt_refs.length + (value.context_capsule_ref ? 1 : 0);
+  if (totalRefs === 0 || totalRefs > 20) {
+    context.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "semantic_refs must contain between 1 and 20 references"
+    });
+  }
+});
 var authoritySchema = z.object({
   mode: z.enum([
     "explicit",
@@ -15271,7 +15340,8 @@ var sessionWorkContextInputSchema = z.object({
     source: boundedText(120).optional()
   }),
   artifact_refs: referenceList,
-  evidence_refs: referenceList
+  evidence_refs: referenceList,
+  semantic_refs: semanticReferencesSchema.optional()
 });
 function normalizeSessionWorkContext(value) {
   const parsed = sessionWorkContextInputSchema.safeParse(value);
@@ -15341,6 +15411,7 @@ function normalizeSessionExecutionObservation(value) {
   const boundary = boundedString(value.boundary, 40);
   if (!boundary || ![
     "turn_boundary",
+    "run_end",
     "session_end",
     "historical_backfill",
     "legacy_unspecified"
@@ -15654,7 +15725,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 } : {}
@@ -18507,7 +18578,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.64" : void 0;
+  const pkgVersion = true ? "0.1.66" : void 0;
   program.version(pkgVersion ?? "unknown", "-V, --version");
   program.hook("preAction", (_thisCommand, actionCommand) => {
     if (Boolean(actionCommand.optsWithGlobals().json)) return;
@@ -19551,4 +19622,4 @@ main().catch(async (error) => {
   process.exitCode = 1;
 });
 //# sourceMappingURL=cli.js.map
-//# debugId=cf979138-322b-5229-81f2-931f9cdf95d2
+//# debugId=783f771d-d176-55f3-b036-2be49833854e