@warmhub/cli 0.69.0 → 0.70.0

package/dist/wh.js

@@ -19630,336 +19630,6 @@ var PUBLIC_ORG_PERMISSIONS = new Set([
   "org:read",
   "components:read"
 ]);
-// ../../packages/rules/src/platform-status-constants.ts
-var PLATFORM_STATUS_CATALOG_SHAPE = "PlatformStatusCatalog";
-var PLATFORM_STATUS_CATALOG_NAME = "main";
-var PLATFORM_STATUS_CATALOG_WREF = `${PLATFORM_STATUS_CATALOG_SHAPE}/${PLATFORM_STATUS_CATALOG_NAME}`;
-var PLATFORM_STATUS_STATUSES = [
-  {
-    key: "available",
-    label: "Available",
-    description: "Works as expected."
-  },
-  {
-    key: "degraded",
-    label: "Degraded",
-    description: "Works with known caveats or partial reliability."
-  },
-  {
-    key: "unavailable",
-    label: "Unavailable",
-    description: "Exists in code but is broken or blocked."
-  },
-  {
-    key: "not_yet_built",
-    label: "Not Yet Built",
-    description: "This feature-surface combination does not exist yet."
-  },
-  {
-    key: "unknown",
-    label: "Unknown",
-    description: "Has not been assessed yet."
-  }
-];
-var PLATFORM_STATUS_OBSERVATION_SOURCES = [
-  "probe",
-  "code_inventory",
-  "issue_mining",
-  "manual"
-];
-var PLATFORM_STATUS_OBSERVATION_KINDS = [
-  "surface_present",
-  "surface_missing",
-  "probe_pass",
-  "probe_fail",
-  "issue_linked",
-  "manual_assessment"
-];
-var PLATFORM_STATUS_PROBE_ARTIFACT_KINDS = [
-  "evidence",
-  "note",
-  "step",
-  "workflow_run",
-  "issue"
-];
-// ../../packages/rules/src/platform-status-field-specs.ts
-var issueFields = {
-  number: {
-    type: "number",
-    integer: true,
-    description: "GitHub issue number."
-  },
-  title: {
-    type: "string",
-    description: "GitHub issue title."
-  },
-  oneLineSummary: {
-    type: "string",
-    description: "One-line summary of the issue impact."
-  }
-};
-var dimensionFields = {
-  slug: {
-    type: "string",
-    description: "Stable slug used in thing names and programmatic queries."
-  },
-  label: {
-    type: "string",
-    description: "Human-readable label."
-  },
-  description: {
-    type: "string",
-    description: "Human-readable description."
-  },
-  "url?": {
-    type: "string",
-    description: "Optional canonical URL for this environment."
-  }
-};
-var PLATFORM_STATUS_CATALOG_FIELDS = {
-  schemaVersion: {
-    type: "number",
-    integer: true,
-    description: "Schema version for the platform status catalog."
-  },
-  title: {
-    type: "string",
-    description: "Display title for the status board."
-  },
-  orgName: {
-    type: "string",
-    description: "Owning organization for the status repo."
-  },
-  repoName: {
-    type: "string",
-    description: "Repository name for the status repo."
-  },
-  sourceIssueNumber: {
-    type: "number",
-    integer: true,
-    description: "Source GitHub issue number for this board."
-  },
-  sourceIssueUrl: {
-    type: "string",
-    description: "Source GitHub issue URL for this board."
-  },
-  features: [dimensionFields],
-  surfaces: [dimensionFields],
-  environments: [dimensionFields],
-  statuses: [
-    {
-      key: {
-        type: "string",
-        enum: PLATFORM_STATUS_STATUSES.map((status) => status.key),
-        description: "Stable status key."
-      },
-      label: {
-        type: "string",
-        description: "Human-readable label for the status."
-      },
-      description: {
-        type: "string",
-        description: "Human-readable definition of the status."
-      }
-    }
-  ],
-  updatedAt: {
-    type: "number",
-    integer: true,
-    description: "Timestamp when the catalog was last updated."
-  },
-  "notes?": {
-    type: "string",
-    description: "Optional operator notes for the board as a whole."
-  }
-};
-var PLATFORM_STATUS_CELL_FIELDS = {
-  feature: {
-    type: "string",
-    description: "Feature slug from the catalog."
-  },
-  surface: {
-    type: "string",
-    description: "Surface slug from the catalog."
-  },
-  environment: {
-    type: "string",
-    description: "Environment slug from the catalog."
-  },
-  status: {
-    type: "string",
-    enum: PLATFORM_STATUS_STATUSES.map((status) => status.key),
-    description: "Current readiness state for this matrix cell."
-  },
-  since: {
-    type: "number",
-    integer: true,
-    description: "Timestamp when this status last changed."
-  },
-  lastVerified: {
-    type: "number",
-    integer: true,
-    description: "Timestamp when this cell was last verified."
-  },
-  verifiedBy: {
-    type: "string",
-    enum: ["probe", "code_inventory", "issue_mining", "manual"],
-    description: "Verification source for the latest assessment."
-  },
-  knownIssues: [issueFields],
-  caveats: [
-    {
-      type: "string",
-      description: "Human caveat describing a limitation or workaround."
-    }
-  ],
-  "notes?": {
-    type: "string",
-    description: "Optional free-form notes for this cell."
-  },
-  "issueMiningBaseline?": {
-    status: {
-      type: "string",
-      enum: PLATFORM_STATUS_STATUSES.map((status) => status.key),
-      description: "Cell status before issue mining temporarily degraded it."
-    },
-    since: {
-      type: "number",
-      integer: true,
-      description: "Original status-change timestamp before issue mining."
-    },
-    lastVerified: {
-      type: "number",
-      integer: true,
-      description: "Original verification timestamp before issue mining."
-    },
-    verifiedBy: {
-      type: "string",
-      enum: ["probe", "code_inventory", "issue_mining", "manual"],
-      description: "Original verifier before issue mining."
-    },
-    knownIssues: [issueFields],
-    caveats: [
-      {
-        type: "string",
-        description: "Original caveats before issue mining."
-      }
-    ],
-    "notes?": {
-      type: "string",
-      description: "Original notes before issue mining."
-    }
-  }
-};
-var PLATFORM_STATUS_OBSERVATION_FIELDS = {
-  cell: {
-    type: "wref",
-    description: "Target PlatformStatusCell/<feature>/<surface>/<environment> wref."
-  },
-  feature: {
-    type: "string",
-    description: "Feature slug from the catalog."
-  },
-  surface: {
-    type: "string",
-    description: "Surface slug from the catalog."
-  },
-  environment: {
-    type: "string",
-    description: "Environment slug from the catalog."
-  },
-  source: {
-    type: "string",
-    enum: [...PLATFORM_STATUS_OBSERVATION_SOURCES],
-    description: "Producer of this observation."
-  },
-  kind: {
-    type: "string",
-    enum: [...PLATFORM_STATUS_OBSERVATION_KINDS],
-    description: "Observation kind within the status pipeline."
-  },
-  observedAt: {
-    type: "number",
-    integer: true,
-    description: "Timestamp when this observation was recorded."
-  },
-  summary: {
-    type: "string",
-    description: "One-line summary of the observation."
-  },
-  evidence: [
-    {
-      type: "string",
-      description: "Supporting evidence path, command, or URL."
-    }
-  ],
-  "statusHint?": {
-    type: "string",
-    enum: PLATFORM_STATUS_STATUSES.map((status) => status.key),
-    description: "Optional status implication suggested by this observation alone."
-  },
-  "notes?": {
-    type: "string",
-    description: "Optional free-form notes for this observation."
-  }
-};
-var PLATFORM_STATUS_PROBE_ARTIFACT_FIELDS = {
-  run: {
-    type: "wref",
-    description: "Target PlatformStatusProbeRun wref."
-  },
-  cell: {
-    type: "wref",
-    description: "Target PlatformStatusCell/<feature>/<surface>/<environment> wref."
-  },
-  runId: {
-    type: "string",
-    description: "Shared batch run identifier for this probe execution."
-  },
-  probeId: {
-    type: "string",
-    description: "Stable probe definition identifier."
-  },
-  feature: {
-    type: "string",
-    description: "Feature slug from the catalog."
-  },
-  surface: {
-    type: "string",
-    description: "Surface slug from the catalog."
-  },
-  environment: {
-    type: "string",
-    description: "Environment slug from the catalog."
-  },
-  observedAt: {
-    type: "number",
-    integer: true,
-    description: "Timestamp when this artifact was captured."
-  },
-  index: {
-    type: "number",
-    integer: true,
-    description: "Stable ordering index within the probe run."
-  },
-  kind: {
-    type: "string",
-    enum: [...PLATFORM_STATUS_PROBE_ARTIFACT_KINDS],
-    description: "Artifact category captured during the run."
-  },
-  label: {
-    type: "string",
-    description: "Human-readable artifact label."
-  },
-  value: {
-    type: "string",
-    description: "Artifact payload or summary text."
-  },
-  "url?": {
-    type: "string",
-    description: "Optional URL associated with this artifact."
-  }
-};
 // ../../packages/rules/src/tokens.ts
 var COMMIT_TOKEN_SYNTAX_REMOVED_MESSAGE = "$N/#N commit-token syntax is no longer supported. Use explicit names and explicit wrefs. For assertions about newly created things, create the thing with a deterministic name and set about to that wref in the same commit.";
 var ANY_TOKEN_RE = /[$#]\d+/;
@@ -26989,7 +26659,7 @@ function validatePersistedStringFieldLimits(value, typeDef, errors, path) {
   }
   if (Array.isArray(value)) {
     const elementType = arrayElementType(normalized);
-    if (normalized !== undefined && elementType === undefined)
+    if (elementType === undefined && !isDeclaredArrayType(normalized))
       return;
     for (let i = 0;i < value.length; i++) {
       validatePersistedStringFieldLimits(value[i], elementType, errors, `${path ?? "<value>"}[${i}]`);
@@ -27022,6 +26692,11 @@ function arrayElementType(typeDef) {
     return typeDef.items;
   return;
 }
+function isDeclaredArrayType(typeDef) {
+  if (typeDef === "array" || Array.isArray(typeDef))
+    return true;
+  return isTypeSpecObject(typeDef) && typeDef.type === "array";
+}
 function nestedObjectFields(typeDef) {
   if (!isPlainObject(typeDef) || isTypeSpecObject(typeDef))
     return;
@@ -27461,7 +27136,7 @@ function findSystemComponent(componentId) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.68.0",
+  version: "0.69.0",
   private: false,
   type: "module",
   description: "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -33002,7 +32677,7 @@ function collectionFields(shapeName, data) {
   return result;
 }
 function effectiveKind(kind, shapeName) {
-  if ((kind === "thing" || !kind) && shapeName && isBuiltinCollectionShape(shapeName)) {
+  if ((kind === "thing" || kind === "collection" || !kind) && shapeName && isBuiltinCollectionShape(shapeName)) {
     return shapeName.toLowerCase();
   }
   return kind;
@@ -33245,7 +32920,8 @@ async function fetchAllAssertionHeadPages(ctx, org, repo, opts) {
       match: opts.match,
       includeRetracted: opts.includeRetracted,
       limit: opts.limit,
-      cursor
+      cursor,
+      ...opts.where ? { where: opts.where } : {}
     });
     items.push(...page.items ?? []);
     if (!page.nextCursor)
@@ -33266,7 +32942,8 @@ async function fetchAllAssertionAboutPages(ctx, org, repo, wref, opts) {
       includeRetracted: opts.includeRetracted,
       resolveCollections: opts.resolveCollections,
       limit: opts.limit,
-      cursor
+      cursor,
+      ...opts.where ? { where: opts.where } : {}
     });
     target = page.target;
     assertions.push(...page.assertions ?? []);
@@ -33283,7 +32960,7 @@ async function fetchAllAssertionAboutPages(ctx, org, repo, wref, opts) {
 
 // ../../packages/warmhub-cli/src/domains/assertion/mutators.ts
 var createFlags = {
-  name: flag.string({ description: "Assertion name" }),
+  name: flag.string({ description: "assertion name (required)" }),
   shape: flag.string({ description: "Shape for assertion (required)" }),
   data: flag.string({ description: "Data payload (JSON)" }),
   about: flag.string({ description: "Target wref" }),
@@ -33364,11 +33041,11 @@ var handleCreate = async (ctx, { flags, args }) => {
   const message = flags.message;
   const data = flags.data !== undefined ? parseJsonObject(flags.data, "--data") : undefined;
   const c = ctx.colors;
-  if (!shape || !aboutRaw) {
-    usageError("Usage: wh assertion create --shape <shape> --about <wref|type:members> [--name <name>] --data <json>", `wh assertion create --shape belief --about player --data '{"confidence":0.8}'`);
+  if (!shape || !aboutRaw || !name) {
+    usageError("Usage: wh assertion create --shape <shape> --name <name> --about <wref> [--data <json>]", `wh assertion create --shape belief --name player-belief --about player --data '{"confidence":0.8}'`);
   }
   const about = parseAbout(aboutRaw);
-  const localName = name ? `${shape}/${name}` : `${shape}/${shape}-$1`;
+  const localName = `${shape}/${name}`;
   const operations = [
     {
       operation: "add",
@@ -33605,10 +33282,10 @@ function renderHead(out, c, chars, result, org, repo, shape, kind) {
     if (item.kind === "assertion" && item.aboutWref) {
       out(`    ${c.dim}about:${c.reset} ${pinnedWref(c, item.aboutWref)}`);
     }
-    const fields = shapeName && item.kind === "thing" && item.data ? collectionFields(shapeName, item.data) : null;
+    const fields = shapeName && (item.kind === "thing" || item.kind === "collection") && item.data ? collectionFields(shapeName, item.data) : null;
     if (fields) {
       const allWrefs = fields.flatMap((f) => f.wrefs);
-      out(`    ${allWrefs.map((w) => pinnedWref(c, w)).join(`${c.dim},${c.reset} `)}`);
+      out(`    ${allWrefs.map((w) => pinnedWref(c, escapeTerminalTextForDisplay(w))).join(`${c.dim},${c.reset} `)}`);
     } else if (item.data && typeof item.data === "object") {
       const preview = JSON.stringify(item.data);
       const truncated = preview.length > 80 ? `${preview.slice(0, 77)}...` : preview;
@@ -33658,11 +33335,11 @@ function renderThing(out, c, result) {
     for (const field of fields) {
       if (field.wrefs.length === 1) {
         const pad = " ".repeat(Math.max(1, 9 - field.name.length));
-        out(`  ${c.dim}${field.name}:${c.reset}${pad}${pinnedWref(c, field.wrefs[0])}`);
+        out(`  ${c.dim}${field.name}:${c.reset}${pad}${pinnedWref(c, escapeTerminalTextForDisplay(field.wrefs[0]))}`);
       } else {
         out(`  ${c.dim}${field.name}:${c.reset}`);
         for (const w of field.wrefs) {
-          out(`    ${pinnedWref(c, w)}`);
+          out(`    ${pinnedWref(c, escapeTerminalTextForDisplay(w))}`);
         }
       }
     }
@@ -33687,7 +33364,7 @@ function renderCollectionSummary(out, c, collection) {
     return;
   out(`  ${c.dim}preview:${c.reset}`);
   for (const wref of preview) {
-    out(`    ${pinnedWref(c, wref)}`);
+    out(`    ${pinnedWref(c, escapeTerminalTextForDisplay(wref))}`);
   }
 }
 function renderDataBlock(out, data, indent) {
@@ -33756,7 +33433,7 @@ function renderThingGraph(out, c, result) {
 function renderHistory(out, c, result) {
   if (result.thing && typeof result.thing === "object") {
     const wref = result.thing.wref ?? result.thing.name ?? "(unknown)";
-    out(`${c.bold}History: ${pinnedWref(c, wref)}${c.reset}  ${kindLabel(c, result.thing.kind ?? "thing")}`);
+    out(`${c.bold}History: ${pinnedWref(c, wref)}${c.reset}  ${kindLabel(c, effectiveKind(result.thing.kind ?? "thing", result.thing.shapeName))}`);
   }
   const firstMeta = result.versions?.[0]?.metadata;
   if (firstMeta?.durableId) {
@@ -33860,7 +33537,7 @@ var handleThingGraph = async (ctx, { flags, args }) => {
   if (depth !== undefined && (depth < 1 || depth > 5)) {
     usageError("Usage: wh thing graph <wref> --depth <1-5>", "wh thing graph Game/base --depth 2");
   }
-  const { org, repo } = parseOrgRepo(getRepoRef(ctx), ctx.config);
+  const { org, repo } = looksLikeDurableId(wref) ? parseOrgRepoOptional(getRepoRef(ctx), ctx.config) : parseOrgRepo(getRepoRef(ctx), ctx.config);
   const result = await ctx.client.thing.graph(org, repo, wref, {
     depth,
     version: flags.version
@@ -34047,6 +33724,7 @@ function validateComponentFilters(componentRef, excludeComponents, ...examples)
 // ../../packages/warmhub-cli/src/domains/thing/where.ts
 var MAX_WHERE_IN_VALUES = 1000;
 var WHERE_USAGE_HINT = 'Example: --where state=NC --where "employees>=100" --where "state?"';
+var FIELD_USAGE_HINT = "Example: --field data.round=1";
 function requireWhereFieldPath(raw, fieldPath) {
   const normalized = fieldPath.trim();
   if (!normalized) {
@@ -34089,6 +33767,27 @@ function parseWhereFlag(raw) {
   }
   throw new CliError(2 /* UserInput */, "USER_INPUT", `Malformed --where predicate: "${raw}". Supported operators: =, !=, >, >=, <, <=, ~, in:[...], ?`, undefined, WHERE_USAGE_HINT);
 }
+function parseFieldFlag(raw) {
+  if (!raw.trim()) {
+    throw new CliError(2 /* UserInput */, "USER_INPUT", `Malformed --field predicate: "${raw}". --field requires data.path=value.`, undefined, FIELD_USAGE_HINT);
+  }
+  const parsed = parseWhereFlag(raw);
+  if (parsed.op !== "eq") {
+    throw new CliError(2 /* UserInput */, "USER_INPUT", `Malformed --field predicate: "${raw}". --field supports exact equality only.`, undefined, FIELD_USAGE_HINT);
+  }
+  if (!parsed.fieldPath.startsWith("data.")) {
+    throw new CliError(2 /* UserInput */, "USER_INPUT", `Malformed --field predicate: "${raw}". Field paths must start with "data.".`, undefined, FIELD_USAGE_HINT);
+  }
+  const fieldPath = parsed.fieldPath.slice("data.".length);
+  if (!fieldPath) {
+    throw new CliError(2 /* UserInput */, "USER_INPUT", `Malformed --field predicate: "${raw}". Field path cannot be empty after "data.".`, undefined, FIELD_USAGE_HINT);
+  }
+  return {
+    fieldPath,
+    op: "eq",
+    rhs: parsed.rhs
+  };
+}
 function coerceValue(s) {
   if (s.startsWith('"') && s.endsWith('"') || s.startsWith("'") && s.endsWith("'")) {
     return s.slice(1, -1);
@@ -34437,10 +34136,10 @@ function renderQueryResults(out, c, result) {
     const kl = kindLabel(c, effectiveKind(item.kind ?? "thing", shapeName));
     const retractedTag = item.active === false ? `  ${c.red}[RETRACTED]${c.reset}` : "";
     out(`  ${wref}  ${kl}${retractedTag}`);
-    const fields = shapeName && (item.kind === "thing" || !item.kind) && item.data ? collectionFields(shapeName, item.data) : null;
+    const fields = shapeName && (item.kind === "thing" || item.kind === "collection" || !item.kind) && item.data ? collectionFields(shapeName, item.data) : null;
     if (fields) {
       const allWrefs = fields.flatMap((f) => f.wrefs);
-      out(`    ${allWrefs.map((w) => pinnedWref(c, w)).join(`${c.dim},${c.reset} `)}`);
+      out(`    ${allWrefs.map((w) => pinnedWref(c, escapeTerminalTextForDisplay(w))).join(`${c.dim},${c.reset} `)}`);
     } else if (item.data && typeof item.data === "object") {
       const preview = JSON.stringify(item.data);
       const truncated = preview.length > 80 ? `${preview.slice(0, 77)}...` : preview;
@@ -34908,7 +34607,7 @@ async function collectWrefs(opts) {
 async function runSingleView(ctx, wref, flags) {
   const version = flags.version;
   const depth = flags.depth;
-  const { org, repo } = looksLikeDurableId(wref) && depth === undefined ? parseOrgRepoOptional(getRepoRef(ctx), ctx.config) : parseOrgRepo(getRepoRef(ctx), ctx.config);
+  const { org, repo } = looksLikeDurableId(wref) ? parseOrgRepoOptional(getRepoRef(ctx), ctx.config) : parseOrgRepo(getRepoRef(ctx), ctx.config);
   const includeRetracted = flags["include-retracted"] || version !== undefined;
   const dataMode = validateDataMode(flags["data-mode"]);
   if (depth !== undefined && (depth < 1 || depth > 5)) {
@@ -35192,7 +34891,7 @@ var handleView2 = async (ctx, { flags, args }) => {
   }
   const version = flags.version;
   const depth = flags.depth;
-  const { org, repo } = looksLikeDurableId(wref) && depth === undefined ? parseOrgRepoOptional(getRepoRef(ctx), ctx.config) : parseOrgRepo(getRepoRef(ctx), ctx.config);
+  const { org, repo } = looksLikeDurableId(wref) ? parseOrgRepoOptional(getRepoRef(ctx), ctx.config) : parseOrgRepo(getRepoRef(ctx), ctx.config);
   const includeRetracted = flags["include-retracted"] || version !== undefined;
   if (depth !== undefined && (depth < 1 || depth > 5)) {
     usageError("Usage: wh assertion view <wref> --depth <1-5>", "wh assertion view Belief/cave-safe --depth 2");
@@ -35317,6 +35016,9 @@ var listFlags = {
   cursor: flag.string({ description: "Opaque pagination cursor" }),
   all: flag.boolean({ description: "Fetch all pages" }),
   count: flag.boolean({ description: "Return count of matching assertions" }),
+  field: flag.string({
+    description: "exact data-field filter (data.path=value); served by the typed field index"
+  }),
   match: flag.string({ description: "Filter by wref glob pattern" }),
   "resolve-collections": flag.boolean({
     description: "Include assertions about collections (Pair/Set/List) containing the target."
@@ -35334,9 +35036,11 @@ var handleList = async (ctx, { flags, args }) => {
   const cursor = flags.cursor;
   const all = flags.all;
   const count = flags.count;
+  const field = flags.field;
   const match = flags.match;
   const resolveCollections = flags["resolve-collections"];
   const includeRetracted = flags["include-retracted"];
+  const where = field === undefined ? undefined : [parseFieldFlag(field)];
   if (count) {
     if (cursor || all || limit || ctx.liveMode) {
       usageError("Usage: wh assertion list --count [--shape SHAPE] [--about WREF] [--match PATTERN]", "wh assertion list --shape Belief --count");
@@ -35350,7 +35054,8 @@ var handleList = async (ctx, { flags, args }) => {
       match,
       about: wref,
       includeRetracted,
-      resolveCollections
+      resolveCollections,
+      ...where ? { where } : {}
     });
   }
   if (cursor && !limit) {
@@ -35371,7 +35076,8 @@ var handleList = async (ctx, { flags, args }) => {
       match,
       includeRetracted,
       limit: pageLimit,
-      cursor
+      cursor,
+      ...where ? { where } : {}
     };
     if (ctx.liveMode) {
       await runLive({
@@ -35416,7 +35122,8 @@ var handleList = async (ctx, { flags, args }) => {
     includeRetracted,
     resolveCollections,
     limit: pageLimit,
-    cursor
+    cursor,
+    ...where ? { where } : {}
   };
   if (ctx.liveMode) {
     await runLive({
@@ -35445,7 +35152,8 @@ var handleList = async (ctx, { flags, args }) => {
     includeRetracted,
     resolveCollections,
     limit: pageLimit,
-    cursor
+    cursor,
+    ...where ? { where } : {}
   }) : await ctx.client.thing.about(org, repo, wref, {
     shape,
     match,
@@ -35453,7 +35161,8 @@ var handleList = async (ctx, { flags, args }) => {
     includeRetracted,
     resolveCollections,
     limit: boundedLimit,
-    cursor
+    cursor,
+    ...where ? { where } : {}
   });
   if (!all && result.nextCursor) {
     emitPartialPageHint(ctx, (result.assertions ?? []).length, result.nextCursor, boundedLimit);
@@ -35478,6 +35187,7 @@ var ASSERTION_DOMAIN = defineDomain({
       examples: [
         "wh assertion list",
         "wh assertion list Location/cave --shape Belief",
+        "wh assertion list Session/run-001 --shape HypothesisCandidate --field data.round=1",
         "wh assertion view Belief/cave-safe",
         "wh assertion list --about Location/cave --shape Belief"
       ],
@@ -35501,8 +35211,8 @@ var ASSERTION_DOMAIN = defineDomain({
       args: "",
       flags: createFlags,
       examples: [
-        `wh assertion create --shape belief --about player --data '{"confidence":0.8}'`,
-        `wh assertion create --shape Distance --about Pair/location-distance --data '{"value":5}'`
+        `wh assertion create --shape belief --name player-belief --about player --data '{"confidence":0.8}'`,
+        `wh assertion create --shape Distance --name location-distance-value --about Pair/location-distance --data '{"value":5}'`
       ],
       handler: handleCreate
     },
@@ -40971,7 +40681,7 @@ var CREDENTIAL_DOMAIN = defineDomain({
     revoke: {
       status: "live",
       prime: true,
-      summary: "Revoke a credential set (blocks new binds and strips auth from existing webhook deliveries)",
+      summary: "Revoke a credential set (blocks new binds and stops bound webhook deliveries)",
       args: "<setName>",
       flags: revokeFlags,
       examples: [
@@ -42119,6 +41829,13 @@ var ONBOARD_DOMAIN = defineDomain({
   handler: handleOnboard
 });
 
+// ../../packages/warmhub-cli/src/display-name.ts
+function ensureNonEmptyDisplayName(value, exampleCommand) {
+  if (value !== undefined && value.trim() === "") {
+    usageError("--display-name requires a non-empty value", exampleCommand);
+  }
+}
+
 // ../../packages/warmhub-cli/src/domains/org-member.ts
 var addMemberFlags = {
   role: flag.string({
@@ -42272,6 +41989,7 @@ var handleCreate4 = async (ctx, { flags, args }) => {
   if (!name) {
     usageError('Usage: wh org create <name> [--display-name "..."] [--description "..."]', 'wh org create caryden --display-name "Carl Ryden" -d "A great org"');
   }
+  ensureNonEmptyDisplayName(flags["display-name"], 'wh org create acme --display-name "Acme Co"');
   const c = ctx.colors;
   const result = await ctx.client.org.create(name, flags["display-name"], flags.description);
   writeOutput(ctx, result, () => {
@@ -42356,6 +42074,7 @@ var handleOrgRename = async (ctx, { args, flags }) => {
   if (newSlug !== undefined && newSlug.length === 0 || rawSlugFromInvocation === "" || flagSlug === "") {
     usageError("New slug must be a non-empty string", "wh org rename acme acme-co");
   }
+  ensureNonEmptyDisplayName(displayName2, 'wh org rename acme --display-name "Acme Co"');
   const c = ctx.colors;
   const slugChange = newSlug && newSlug !== oldName ? newSlug : undefined;
   if (displayName2 !== undefined && slugChange) {
@@ -42479,7 +42198,7 @@ var ORG_DOMAIN = defineDomain({
 });
 
 // ../../packages/warmhub-cli/src/domains/prime-content.md
-var prime_content_default = "# WarmHub CLI Context\n> **Context Recovery**: Run `wh prime` after compaction or new session\n\n## Environment\n{{REPO_LINE}}\n\n## Core Concepts\n- **Thing**: A named entity versioned by writes. **Assertion**: A thing that makes a shape-validated claim about another thing.\n- **Shape**: A thing defining data structure; every other thing has one. **Write**: One or more add/revise/retract operations with per-operation results.\n- **wref**: A reference to a thing. Local: `Player` (the shape) or `Player/alice` (a thing with that shape). Cross-repo: `wh:org/repo/Shape` or `wh:org/repo/Shape/name`.\n\n## Versioned Wrefs\n- `Shape` addresses the shape itself; `Shape/name` addresses a thing with that shape. `@vN` pins either.\n- Floating write refs to retracted targets fail; existing pinned versions remain valid.\n- Rename invalidates old spellings, including `@vN`; the new name resolves history.\n- Untyped wrefs accept any thing. `wref<T>` requires the target's shape to be `T`; a shape has no shape, so never satisfies it. `wref?` coalesces only `thing_absent`, never a missing shape.\n\n## Key Workflows\n\n**Write data** (discover shapes → scaffold ops → submit):\n```bash\nwh shape list --repo org/repo                             # list available shapes\nwh shape view ShapeName --repo org/repo                   # inspect fields\nwh shape template ShapeName -o ops.json --repo org/repo   # scaffold write ops (supports --kind assertion)\n# edit ops.json — fill FILL_IN placeholders — then:\nwh commit submit --file ops.json -m \"msg\" --repo org/repo  # submit operations (bare `wh commit` also works)\n# or single assertion (no file needed):\nwh assertion create --shape ShapeName --about Target/name --name my-assertion --data '{\"field\":1}' --repo org/repo\n# Relay failed operation details when present. Never hand-guess ops JSON — use `wh shape template <Shape>`.\n```\n\n**Read data:**\n```bash\nwh thing list --repo org/repo                 # all things at HEAD\nwh thing view Shape/name --repo org/repo      # inspect a thing\nwh thing query --shape MyShape --repo org/repo  # find things by shape\nwh thing about Shape --repo org/repo          # assertions about a shape\nwh assertion list --repo org/repo             # all assertions at HEAD\nwh thing history Shape/name --repo org/repo   # version history\n\n# Batch read — wh thing view is variadic (max 500 wrefs/call):\nwh thing view Player/alice Player/bob               # variadic positionals\nwh thing view --file wrefs.txt --json               # one wref per line\ncat wrefs.txt | wh thing view --format jsonl        # one JSON line per *deduped* requested wref\n```\n\n## Wref Quick Reference\n\nWrites use explicit names and wrefs. Untyped fields, collection members,\nassertion `about`, and committers accept any thing. Create a deterministic\ntarget before referencing it in the same commit.\n\n## Command Reference\n\n**Global flags**: `--repo`, `--format`, `--json`, `--live`\n### thing — Thing operations\n- `wh thing list [--shape] [--kind] [--match] [--include-retracted]` — Current HEAD state\n- `wh thing view [<wref>...] [--file <path>] [--version] [--depth] [--include-retracted] [--data-mode auto|full]` — Thing details. Variadic (max 500). `--version` implies `--include-retracted`. Batch JSON returns `{ requested, items, missing }`; jsonl emits one row per deduped requested wref. Large Set/List bodies summarize by default; use `--data-mode full` for canonical collection JSON.\n- `wh thing history [wref] [--shape] [--about] [--include-retracted]` — Version history\n- `wh thing resolve <wref>` — Resolve a wref to its canonical thing identity\n- `wh thing create <name|Shape/name> --data <json-object> [--shape] [--message] [--committer]` — Create\n- `wh thing revise <name> [--data] [--message] [--committer] [--expected-version]` — Revise (CONFLICT if HEAD≠n)\n- `wh thing retract <wref> -m <message> [--reason] [--kind]` — Retract\n- `wh thing query [--shape] [--kind] [--about] [--match]` — Query by filters\n- `wh thing search <query> [--shape] [--kind] [--about] [--mode]` — Search text\n- `wh thing rename <Shape/oldName> <newName>` — Rename\n- `wh thing refs <wref> [--inbound] [--outbound] [--field]` — Show field references; use `wh thing about` for assertions about the target thing\n- `wh thing about <wref> [--shape] [--match] [--depth] [--resolve-collections] [--limit] [--include-retracted]` — Show assertions about the target identity; `--resolve-collections` expands collection members for bare/@HEAD/@ALL inputs, not pinned @vN\n\n### commit — Write operations\n- `wh commit submit [--ops|--file|--add|--revise|--retract] [--kind] [--data] [--reason] [--expected-version] [--chunk-size] [--skip-existing] [--progress] [--stream-id]` — Submit operations (bare `wh commit` is equivalent). Use `--file ops.jsonl --stream-id <id> --chunk-size 5000 --skip-existing` for bulk ingest.\n- `wh shape template <shape> [shape2 ...] [--kind] [--operation add|revise|retract] [-o file]` — Generate sample ops\n\n### assertion — Assertion operations\n- `wh assertion list [--about wref] [--shape] [--match] [--include-retracted]` — Browse assertions\n- `wh assertion view <wref> [--version] [--include-retracted]` — Assertion details\n- `wh assertion create [--name] [--shape] [--data] [--about] [--message] [--committer]` — Create assertion\n- `wh assertion revise <wref> --data <json> [--message] [--committer]` — Revise assertion\n- `wh assertion retract <wref> -m <message> [--reason] [--committer]` — Retract assertion\n- `wh assertion history <wref> [--include-retracted]` — Assertion history\n\n### shape — Shape management\n- `wh shape list [--match] [--include-retracted]` — List all shapes\n- `wh shape view <name> [--include-retracted]` — Shape details\n- `wh shape revise <name> [--fields]` — Revise shape\n- `wh shape create <name> [--fields]` — Create shape\n- `wh shape retract <name> -m <message> [--reason]` — Retract shape\n- `wh shape history <name> [--include-retracted]` — Shape history\n- `wh shape rename <oldName> <newName>` — Rename shape\n\n### repo — Repository management\n- `wh repo create <org/name> [--display-name] [--description] [--visibility]` — Create repo\n- `wh repo list [org]` — List repos\n- `wh repo view [org/repo]` — Repo details\n\n### org — Organization management\n- `wh org create <name> [--display-name]` — Create a new organization\n- `wh org view <name>` — View organization details (alias: info)\n- `wh org list` — List all organizations\n\n### sub — Subscription management\n- `wh sub create <name> [flags]` — Create a subscription\n- `wh sub view <name>` — View subscription details\n- `wh sub list` — List all subscriptions\n- `wh sub log <name>` — Tail subscription delivery feed\n- `wh sub attempts <runId>` — Show attempt history for a run\n- `wh sub pause <name>` — Pause a subscription\n- `wh sub resume <name>` — Resume a paused subscription\n- `wh sub bind <name> [--credentials]` — Bind a credential set to a subscription for webhook auth\n- `wh sub unbind <name>` — Remove credential binding from a subscription\n- `wh sub delete <name>` — Delete a subscription\n\n### notifications — Action notification listing\n- `wh notifications [--limit] [--since]` — List repo-scoped action notifications\n\n### credential — Credential set management\n- `wh credential create <name> [--repo org/repo | --org org] [--scope] [--description]` — Create an empty credential set\n- `wh credential list [--repo org/repo | --org org]` — List credential sets accessible from a repo or org\n- `wh credential view <name> [--repo org/repo | --org org]` — View a credential set (key names only, no values)\n- `wh credential delete <name> [--repo org/repo | --org org]` — Delete a credential set and its Vault object\n- `wh credential set <setName> [<keyName>] [--repo org/repo | --org org] [--value]` — Set credential key(s). With `<keyName>`: single-key form (reads value from `--value` or stdin). Without `<keyName>`: batch form (reads JSON object from stdin, e.g. `{\"KEY\":\"val\"}`)\n- `wh credential unset <setName> <keyName> [--repo org/repo | --org org]` — Remove a key from a credential set\n- `wh credential audit <setName> [--repo org/repo | --org org]` — View audit log for a credential set\n- `wh credential revoke <setName> [--repo org/repo | --org org] [--reason]` — Revoke a credential set (blocks new binds and strips auth from existing webhook deliveries)\n\n### component — Component management\n- `wh component validate <path>` — Validate package\n- `wh component install <org/name>` — Install a registered component\n- `wh component register <name> --org <org> --manifest <path> [flags]` — Register component identity\n- `wh component unregister <org/name>` — Remove a registered component identity\n- `wh component registry list --org <org>` — List registered components\n- `wh component registry view <org/name>` — View a registered component\n- `wh component registry update <org/name> [flags]` — Update a registered component\n- `wh component list` — List installed components\n- `wh component update <org/name>` — Update installed component\n- `wh component view <org/name>` — Show component details (alias: show)\n- `wh component doctor <org/name>` — Run component health checks\n- `wh component teardown <org/name>` — Pause component subscriptions\n\n### Getting More Info\n- `wh help` — full help overview\n- `wh <domain>` — list verbs for a domain\n- `wh <domain> <verb> --help` — verb details with flags and examples\n- `wh help --format json` — full CLI spec as JSON (best for agents)\n\n## Common Workflows\n\n**Explore a repo:**\n```bash\nwh thing list --repo org/repo             # see all things in HEAD\nwh thing view Shape/name --repo org/repo  # inspect a specific thing\nwh thing history Shape/name --repo org/repo # inspect version history\nwh thing about Shape/name                 # assertions about thing/shape\n```\n\n**Create an assertion** (most common write):\n```bash\n# --about takes an untyped target wref: Shape or Shape/name.\nwh assertion create --shape MyShape --about TargetShape/target-name \\\n  --name my-assertion --data '{\"field_a\":1,\"field_b\":\"value\"}' --repo org/repo\n# Output includes per-operation status; relay failures when present.\n```\n\n**Create via write entrypoint** (alternative, supports batches and streams):\n```bash\nwh commit submit --add my-item --shape MyShape --kind assertion \\\n  --about TargetShape/target-name --data '{\"field_a\":1}' --repo org/repo\n```\n\n**Batch write via file** (generate template → edit → submit):\n```bash\nwh shape template Hypothesis Evidence -o ops.json    # add --kind assertion --about TargetShape/name for assertions\n# edit ops.json — fill FILL_IN placeholders\nwh commit submit --file ops.json -m \"batch update\"   # submit all operations (bare `wh commit` is equivalent)\n# --file format: docs.warmhub.ai/cli-reference/commit-operations\n```\n\n**Bulk write (JSONL stream, >1k ops)** — one chunked stream beats per-record commits (~60× faster):\n```bash\nwh shape template MyShape -o ops.jsonl                          # one op per line (.jsonl)\nID=\"bulk-$(date +%s)\"   # choose your own; set it up front so reruns are safe\nwh commit submit --file ops.jsonl --stream-id \"$ID\" --chunk-size 5000 \\\n  --skip-existing --progress -m \"bulk ingest\" --repo org/repo\n# --chunk-size: ops per append chunk (default 1000, max 10000); chunk≈1 is ~60× slower\n# --skip-existing: skips already-written add ops (drops per-row read-before-write)\n# Add-stream restart: rerun the WHOLE file with the SAME --stream-id.\n# Fixed-name adds are idempotent via --skip-existing. Mid-stream resume is not\n# a CLI mode. Mixed revise/retract JSONL streams are not full-rerun safe after\n# an ambiguous append; inspect repo state and reconcile explicitly.\n```\n\n**Create collections:**\n```bash\nwh commit submit --type pair --name location-distance --members Location,Location/a --repo org/repo\nwh assertion create --shape Distance --about Pair/location-distance --data '{\"value\":5}' --repo org/repo\n```\n\n**Modify data:**\n```bash\nwh thing revise Shape/name --data '{\"x\":5,\"y\":3}' -m \"update\" --repo org/repo\nwh thing retract Shape/old-item -m \"withdrawn\" --reason \"data feed contaminated\" --repo org/repo\n```\n\n**Query and filter:**\n```bash\nwh thing query --shape MyShape                       # by shape\nwh thing query --kind assertion --about Shape/name   # by kind + target\nwh thing history Shape/name --limit 10               # version history\n```\n\n## Built-in Content shape\n\nWarmHub repos expose three well-known content wrefs:\n- `Content/Readme`  — stored markdown for humans\n- `Content/Agents`  — stored markdown guidance for AI agents\n- `Content/LlmsTxt` — synthesized per-request sitemap (read-only)\n\nFetch via `wh repo content get --kind readme|agents|llms-txt`,\n`client.repo.getReadme/getAgents/getLlmsTxt`, MCP `warmhub_repo_content_get`,\nor raw HTTP `GET /{org}/{repo}/readme.md|agents.md|llms.txt`.\nSee `wh repo describe` → `additionalInformation` for the discovery field.\n\n## Query Discipline\n- Plan the repo, shapes, and wrefs you need before the first query.\n- Gather the needed facts from one repo before switching to another.\n- Do the queries first, then write one complete answer.\n\n## Agent Tips\n- **Always run commands for live data** — this context describes the CLI, not repo contents\n- **Before writing, discover wrefs** — run `wh thing list` or `wh shape list`\n- **Shape field types**: `string`, `number`, `boolean`, `wref`, arrays, optionals, nested objects\n- **Write commands return per-operation results** — relay failures and affected wrefs to the user\n- **Pass data inline** with `--data '{...}'` — do NOT create temp files\n- Add `--json` to any command for machine-readable JSON output\n- **Aliases teach canonical commands** — executing aliases emit a status hint; misleading lifecycle aliases reject and point to `retract`\n- Writes go through `wh commit submit` (or bare `wh commit`) or wrappers (`create`, `revise`, `retract`, `assertion create`). `retract` irreversibly withdraws an identity and creates a history entry.\n- Use `wh doctor` to check environment health\n";
+var prime_content_default = "# WarmHub CLI Context\n> **Context Recovery**: Run `wh prime` after compaction or new session\n\n## Environment\n{{REPO_LINE}}\n\n## Core Concepts\n- **Thing**: A named entity versioned by writes. **Assertion**: A thing that makes a shape-validated claim about another thing.\n- **Shape**: A thing defining data structure; every other thing has one. **Write**: One or more add/revise/retract operations with per-operation results.\n- **wref**: A reference to a thing. Local: `Player` (the shape) or `Player/alice` (a thing with that shape). Cross-repo: `wh:org/repo/Shape` or `wh:org/repo/Shape/name`.\n\n## Versioned Wrefs\n- `Shape` addresses the shape itself; `Shape/name` addresses a thing with that shape. `@vN` pins either.\n- Floating write refs to retracted targets fail; existing pinned versions remain valid.\n- Rename invalidates old spellings, including `@vN`; the new name resolves history.\n- Untyped wrefs accept any thing. `wref<T>` requires the target's shape to be `T`; a shape has no shape, so never satisfies it. `wref?` coalesces only `thing_absent`, never a missing shape.\n\n## Key Workflows\n\n**Write data** (discover shapes → scaffold ops → submit):\n```bash\nwh shape list --repo org/repo                             # list available shapes\nwh shape view ShapeName --repo org/repo                   # inspect fields\nwh shape template ShapeName -o ops.json --repo org/repo   # scaffold write ops (supports --kind assertion)\n# edit ops.json — fill FILL_IN placeholders — then:\nwh commit submit --file ops.json -m \"msg\" --repo org/repo  # submit operations (bare `wh commit` also works)\n# or single assertion (no file needed):\nwh assertion create --shape ShapeName --about Target/name --name my-assertion --data '{\"field\":1}' --repo org/repo\n# Relay failed operation details when present. Never hand-guess ops JSON — use `wh shape template <Shape>`.\n```\n\n**Read data:**\n```bash\nwh thing list --repo org/repo                 # all things at HEAD\nwh thing view Shape/name --repo org/repo      # inspect a thing\nwh thing query --shape MyShape --repo org/repo  # find things by shape\nwh thing about Shape --repo org/repo          # assertions about a shape\nwh assertion list --repo org/repo             # all assertions at HEAD\nwh thing history Shape/name --repo org/repo   # version history\n\n# Batch read — wh thing view is variadic (max 500 wrefs/call):\nwh thing view Player/alice Player/bob               # variadic positionals\nwh thing view --file wrefs.txt --json               # one wref per line\ncat wrefs.txt | wh thing view --format jsonl        # one JSON line per *deduped* requested wref\n```\n\n## Wref Quick Reference\n\nWrites use explicit names and wrefs. Untyped fields, collection members,\nassertion `about`, and committers accept any thing. Create a deterministic\ntarget before referencing it in the same commit.\n\n## Command Reference\n\n**Global flags**: `--repo`, `--format`, `--json`, `--live`\n### thing — Thing operations\n- `wh thing list [--shape] [--kind] [--match] [--include-retracted]` — Current HEAD state\n- `wh thing view [<wref>...] [--file <path>] [--version] [--depth] [--include-retracted] [--data-mode auto|full]` — Thing details. Variadic (max 500). `--version` implies `--include-retracted`. Batch JSON returns `{ requested, items, missing }`; jsonl emits one row per deduped requested wref. Large Set/List bodies summarize by default; use `--data-mode full` for canonical collection JSON.\n- `wh thing history [wref] [--shape] [--about] [--include-retracted]` — Version history\n- `wh thing resolve <wref>` — Resolve a wref to its canonical thing identity\n- `wh thing create <name|Shape/name> --data <json-object> [--shape] [--message] [--committer]` — Create\n- `wh thing revise <name> [--data] [--message] [--committer] [--expected-version]` — Revise (CONFLICT if HEAD≠n)\n- `wh thing retract <wref> -m <message> [--reason] [--kind]` — Retract\n- `wh thing query [--shape] [--kind] [--about] [--match]` — Query by filters\n- `wh thing search <query> [--shape] [--kind] [--about] [--mode]` — Search text\n- `wh thing rename <Shape/oldName> <newName>` — Rename\n- `wh thing refs <wref> [--inbound] [--outbound] [--field]` — Show field references; use `wh thing about` for assertions about the target thing\n- `wh thing about <wref> [--shape] [--match] [--depth] [--resolve-collections] [--limit] [--include-retracted]` — Show assertions about the target identity; `--resolve-collections` expands collection members for bare/@HEAD/@ALL inputs, not pinned @vN\n\n### commit — Write operations\n- `wh commit submit [--ops|--file|--add|--revise|--retract] [--kind] [--data] [--reason] [--expected-version] [--chunk-size] [--skip-existing] [--progress] [--stream-id]` — Submit operations (bare `wh commit` is equivalent). Use `--file ops.jsonl --stream-id <id> --chunk-size 5000 --skip-existing` for bulk ingest.\n- `wh shape template <shape> [shape2 ...] [--kind] [--operation add|revise|retract] [-o file]` — Generate sample ops\n\n### assertion — Assertion operations\n- `wh assertion list [--about wref] [--shape] [--match] [--include-retracted]` — Browse assertions\n- `wh assertion view <wref> [--version] [--include-retracted]` — Assertion details\n- `wh assertion create --shape <s> --name <n> --about <wref> [--data] [-m] [--committer]` — Create assertion\n- `wh assertion revise <wref> --data <json> [--message] [--committer]` — Revise assertion\n- `wh assertion retract <wref> -m <message> [--reason] [--committer]` — Retract assertion\n- `wh assertion history <wref> [--include-retracted]` — Assertion history\n\n### shape — Shape management\n- `wh shape list [--match] [--include-retracted]` — List all shapes\n- `wh shape view <name> [--include-retracted]` — Shape details\n- `wh shape revise <name> [--fields]` — Revise shape\n- `wh shape create <name> [--fields]` — Create shape\n- `wh shape retract <name> -m <message> [--reason]` — Retract shape\n- `wh shape history <name> [--include-retracted]` — Shape history\n- `wh shape rename <oldName> <newName>` — Rename shape\n\n### repo — Repository management\n- `wh repo create <org/name> [--display-name] [--description] [--visibility]` — Create repo\n- `wh repo list [org]` — List repos\n- `wh repo view [org/repo]` — Repo details\n\n### org — Organization management\n- `wh org create <name> [--display-name]` — Create a new organization\n- `wh org view <name>` — View organization details (alias: info)\n- `wh org list` — List all organizations\n\n### sub — Subscription management\n- `wh sub create <name> [flags]` — Create a subscription\n- `wh sub view <name>` — View subscription details\n- `wh sub list` — List all subscriptions\n- `wh sub log <name>` — Tail subscription delivery feed\n- `wh sub attempts <runId>` — Show attempt history for a run\n- `wh sub pause <name>` — Pause a subscription\n- `wh sub resume <name>` — Resume a paused subscription\n- `wh sub bind <name> [--credentials]` — Bind a credential set to a subscription for webhook auth\n- `wh sub unbind <name>` — Remove credential binding from a subscription\n- `wh sub delete <name>` — Delete a subscription\n\n### notifications — Action notification listing\n- `wh notifications [--limit] [--since]` — List repo-scoped action notifications\n\n### credential — Credential set management\n- `wh credential create <name> [--repo org/repo | --org org] [--scope] [--description]` — Create an empty credential set\n- `wh credential list [--repo org/repo | --org org]` — List credential sets accessible from a repo or org\n- `wh credential view <name> [--repo org/repo | --org org]` — View a credential set (key names only, no values)\n- `wh credential delete <name> [--repo org/repo | --org org]` — Delete a credential set and its Vault object\n- `wh credential set <setName> [<keyName>] [--repo org/repo | --org org] [--value]` — Set credential key(s). With `<keyName>`: single-key form (reads value from `--value` or stdin). Without `<keyName>`: batch form (reads JSON object from stdin, e.g. `{\"KEY\":\"val\"}`)\n- `wh credential unset <setName> <keyName> [--repo org/repo | --org org]` — Remove a key from a credential set\n- `wh credential audit <setName> [--repo org/repo | --org org]` — View audit log for a credential set\n- `wh credential revoke <setName> [--repo org/repo | --org org] [--reason]` — Revoke a credential set (blocks new binds and stops bound webhook deliveries)\n\n### component — Component management\n- `wh component validate <path>` — Validate package\n- `wh component install <org/name>` — Install a registered component\n- `wh component register <name> --org <org> --manifest <path> [flags]` — Register component identity\n- `wh component unregister <org/name>` — Remove a registered component identity\n- `wh component registry list --org <org>` — List registered components\n- `wh component registry view <org/name>` — View a registered component\n- `wh component registry update <org/name> [flags]` — Update a registered component\n- `wh component list` — List installed components\n- `wh component update <org/name>` — Update installed component\n- `wh component view <org/name>` — Show component details (alias: show)\n- `wh component doctor <org/name>` — Run component health checks\n- `wh component teardown <org/name>` — Pause component subscriptions\n\n### Getting More Info\n- `wh help` — full help overview\n- `wh <domain>` — list verbs for a domain\n- `wh <domain> <verb> --help` — verb details with flags and examples\n- `wh help --format json` — full CLI spec as JSON (best for agents)\n\n## Common Workflows\n\n**Explore a repo:**\n```bash\nwh thing list --repo org/repo             # see all things in HEAD\nwh thing view Shape/name --repo org/repo  # inspect a specific thing\nwh thing history Shape/name --repo org/repo # inspect version history\nwh thing about Shape/name                 # assertions about thing/shape\n```\n\n**Create an assertion** (most common write):\n```bash\n# --about takes an untyped target wref: Shape or Shape/name.\nwh assertion create --shape MyShape --about TargetShape/target-name \\\n  --name my-assertion --data '{\"field_a\":1,\"field_b\":\"value\"}' --repo org/repo\n# Output includes per-operation status; relay failures when present.\n```\n\n**Create via write entrypoint** (alternative, supports batches and streams):\n```bash\nwh commit submit --add my-item --shape MyShape --kind assertion \\\n  --about TargetShape/target-name --data '{\"field_a\":1}' --repo org/repo\n```\n\n**Batch write via file** (generate template → edit → submit):\n```bash\nwh shape template Hypothesis Evidence -o ops.json    # add --kind assertion --about TargetShape/name for assertions\n# edit ops.json — fill FILL_IN placeholders\nwh commit submit --file ops.json -m \"batch update\"   # submit all operations (bare `wh commit` is equivalent)\n# --file format: docs.warmhub.ai/cli-reference/commit-operations\n```\n\n**Bulk write (JSONL stream, >1k ops)** — one chunked stream beats per-record commits (~60× faster):\n```bash\nwh shape template MyShape -o ops.jsonl                          # one op per line (.jsonl)\nID=\"bulk-$(date +%s)\"   # choose your own; set it up front so reruns are safe\nwh commit submit --file ops.jsonl --stream-id \"$ID\" --chunk-size 5000 \\\n  --skip-existing --progress -m \"bulk ingest\" --repo org/repo\n# --chunk-size: ops per append chunk (default 1000, max 10000); chunk≈1 is ~60× slower\n# --skip-existing: skips already-written add ops (drops per-row read-before-write)\n# Add-stream restart: rerun the WHOLE file with the SAME --stream-id.\n# Fixed-name adds are idempotent via --skip-existing. Mid-stream resume is not\n# a CLI mode. Mixed revise/retract JSONL streams are not full-rerun safe after\n# an ambiguous append; inspect repo state and reconcile explicitly.\n```\n\n**Create collections:**\n```bash\nwh commit submit --type pair --name location-distance --members Location,Location/a --repo org/repo\nwh assertion create --shape Distance --name location-distance-value --about Pair/location-distance --data '{\"value\":5}' --repo org/repo\n```\n\n**Modify data:**\n```bash\nwh thing revise Shape/name --data '{\"x\":5,\"y\":3}' -m \"update\" --repo org/repo\nwh thing retract Shape/old-item -m \"withdrawn\" --reason \"data feed contaminated\" --repo org/repo\n```\n\n**Query and filter:**\n```bash\nwh thing query --shape MyShape                       # by shape\nwh thing query --kind assertion --about Shape/name   # by kind + target\nwh thing history Shape/name --limit 10               # version history\n```\n\n## Built-in Content shape\n\nWarmHub repos expose three well-known content wrefs:\n- `Content/Readme`  — stored markdown for humans\n- `Content/Agents`  — stored markdown guidance for AI agents\n- `Content/LlmsTxt` — synthesized per-request sitemap (read-only)\n\nFetch via `wh repo content get --kind readme|agents|llms-txt`,\n`client.repo.getReadme/getAgents/getLlmsTxt`, MCP `warmhub_repo_content_get`,\nor raw HTTP `GET /{org}/{repo}/readme.md|agents.md|llms.txt`.\nSee `wh repo describe` → `additionalInformation` for the discovery field.\n\n## Query Discipline\n- Plan the repo, shapes, and wrefs you need before the first query.\n- Gather the needed facts from one repo before switching to another.\n- Do the queries first, then write one complete answer.\n\n## Agent Tips\n- **Always run commands for live data** — this context describes the CLI, not repo contents\n- **Before writing, discover wrefs** — run `wh thing list` or `wh shape list`\n- **Shape field types**: `string`, `number`, `boolean`, `wref`, arrays, optionals, nested objects\n- **Write commands return per-operation results** — relay failures and affected wrefs to the user\n- **Pass data inline** with `--data '{...}'` — do NOT create temp files\n- Add `--json` to any command for machine-readable JSON output\n- **Aliases teach canonical commands** — executing aliases emit a status hint; misleading lifecycle aliases reject and point to `retract`\n- Writes go through `wh commit submit` (or bare `wh commit`) or wrappers (`create`, `revise`, `retract`, `assertion create`). `retract` irreversibly withdraws an identity and creates a history entry.\n- Use `wh doctor` to check environment health\n";
 
 // ../../packages/warmhub-cli/src/domains/prime.ts
 function buildMarkdown(config) {
@@ -42630,11 +42349,6 @@ function parseExplicitOrgRepoArg(ref, usage, example) {
   const [orgName, repoName] = parts;
   return { orgName, repoName };
 }
-function ensureNonEmptyDisplayName(value, exampleCommand) {
-  if (value !== undefined && value.trim() === "") {
-    usageError("--display-name requires a non-empty value", exampleCommand);
-  }
-}
 function resolveOrgRepoArg(ref, orgFlag) {
   if (ref?.includes("/")) {
     const parts = ref.split("/");
@@ -44852,10 +44566,11 @@ var TOKEN_DOMAIN = defineDomain({
 // ../../packages/warmhub-cli/src/update-check-cache.ts
 import { mkdirSync as mkdirSync7, readFileSync as readFileSync10, writeFileSync as writeFileSync7 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { dirname as dirname7, resolve as resolve3 } from "node:path";
+import { dirname as dirname8, resolve as resolve3 } from "node:path";
 
 // ../../packages/warmhub-cli/src/update-check-fetch.ts
 import * as childProcess4 from "node:child_process";
+import { dirname as dirname7 } from "node:path";
 var WH_CLI_PACKAGE_NAME = "@warmhub/cli";
 var UPDATE_DIST_TAG = "latest";
 var DEFAULT_UPDATE_REGISTRY = "https://registry.npmjs.org";
@@ -44896,8 +44611,24 @@ var getUpdateRegistryConfigFingerprint = (env, _cwd, _homePath, _options = {}) =
     return `env:${override}`;
   return `default:${DEFAULT_UPDATE_REGISTRY}`;
 };
+function withNpmRegistryEnv(env, registry2) {
+  const childEnv = { ...env };
+  for (const key of Object.keys(childEnv)) {
+    if (key.toLowerCase() === "npm_config_registry")
+      delete childEnv[key];
+  }
+  return { ...childEnv, npm_config_registry: registry2 };
+}
 var fetchLatestCliVersion = (env, registry2) => {
-  const proc = childProcess4.spawnSync("npm", [
+  const isWindows = process.platform === "win32";
+  const proc = isWindows ? childProcess4.spawnSync(`npm view ${WH_CLI_PACKAGE_NAME}@${UPDATE_DIST_TAG} version --json`, {
+    encoding: "utf8",
+    cwd: dirname7(process.execPath),
+    env: withNpmRegistryEnv(env, registry2),
+    shell: true,
+    stdio: "pipe",
+    timeout: 8000
+  }) : childProcess4.spawnSync("npm", [
     "view",
     `${WH_CLI_PACKAGE_NAME}@${UPDATE_DIST_TAG}`,
     "version",
@@ -44926,7 +44657,7 @@ var readCache = (homePath) => {
 };
 var writeCache = (homePath, cache) => {
   const path2 = cachePath(homePath);
-  mkdirSync7(dirname7(path2), { recursive: true });
+  mkdirSync7(dirname8(path2), { recursive: true });
   writeFileSync7(path2, `${JSON.stringify(cache, null, 2)}
 `, "utf8");
 };
@@ -44945,7 +44676,7 @@ var markUpdateNoticeShown = ({
 import { spawnSync as spawnSync2 } from "node:child_process";
 import { existsSync as existsSync9, readFileSync as readFileSync11, realpathSync } from "node:fs";
 import { homedir as homedir6 } from "node:os";
-import { dirname as dirname8, resolve as resolve4 } from "node:path";
+import { dirname as dirname9, resolve as resolve4 } from "node:path";
 var DEV_INSTALL_PACKAGE_SEARCH_DEPTH = 8;
 var DEV_INSTALL_GIT_SEARCH_DEPTH = 4;
 var normalizePath = (path2) => path2 ? path2.replaceAll("\\", "/") : "";
@@ -45089,7 +44820,7 @@ var formatUnknownInstallHint = (activePath, realPath, latestVersion, registry2)
 var isDevInstall = (scriptPath) => {
   if (!scriptPath)
     return false;
-  let dir = dirname8(scriptPath);
+  let dir = dirname9(scriptPath);
   for (let i = 0;i < DEV_INSTALL_PACKAGE_SEARCH_DEPTH; i += 1) {
     const pkgPath = resolve4(dir, "package.json");
     try {
@@ -45101,7 +44832,7 @@ var isDevInstall = (scriptPath) => {
         for (let j = 0;j < DEV_INSTALL_GIT_SEARCH_DEPTH; j += 1) {
           if (existsSync9(resolve4(probe, ".git")))
             return true;
-          const parent2 = dirname8(probe);
+          const parent2 = dirname9(probe);
           if (parent2 === probe)
             break;
           probe = parent2;
@@ -45109,7 +44840,7 @@ var isDevInstall = (scriptPath) => {
         return false;
       }
     } catch {}
-    const parent = dirname8(dir);
+    const parent = dirname9(dir);
     if (parent === dir)
       break;
     dir = parent;
@@ -46324,6 +46055,7 @@ async function runCli(argv, opts) {
     ...traceFields
   });
   let exitCode = 0 /* Ok */;
+  let cancelledExitCode;
   let removeSignalListeners;
   try {
     canonicalizeGlobalFlags({ invocation });
@@ -46377,7 +46109,6 @@ async function runCli(argv, opts) {
     const chars = makeChars();
     const ac = new AbortController;
     const liveMode = getBoolFlag(invocation.flags, "live");
-    let cancelledExitCode;
     const handleSigint = () => {
       ac.abort();
       logger.info("cli.cancelled", { signal: "SIGINT", ...traceFields });
@@ -46424,6 +46155,10 @@ async function runCli(argv, opts) {
     exitCode = cancelledExitCode ?? 0 /* Ok */;
     return exitCode;
   } catch (error) {
+    if (cancelledExitCode !== undefined) {
+      exitCode = cancelledExitCode;
+      return exitCode;
+    }
     const cliError = toCliError2(error);
     const fields = {
       kind: cliError.kind,
@@ -46502,7 +46237,7 @@ function resolveLogLevel(flags, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.69.0",
+  version: "0.70.0",
   private: false,
   type: "module",
   description: "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -47157,4 +46892,4 @@ if (!updateCheckSuppressedByArgv && shouldRunUpdateCheck(updateEligibility)) {
 var interceptedExitCode = await maybeHandleComponentShellBoundary(dispatchArgv);
 process.exitCode = interceptedExitCode === undefined ? await runCli(dispatchArgv, { version: package_default3.version }) : interceptedExitCode;
 
-//# debugId=C8123553A9E5F6D464756E2164756E21
+//# debugId=14D7F2CE92253D6D64756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmhub/cli",
-  "version": "0.69.0",
+  "version": "0.70.0",
   "private": false,
   "type": "module",
   "description": "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",