@warmhub/cli 0.126.0 → 0.128.0

package/dist/wh.js

@@ -17766,16 +17766,37 @@ var BUILTIN_SHAPE_NAMES = [
   "List"
 ];
 var RETIRED_COLLECTION_SHAPE_NAMES = ["Triple"];
+var V2_RELATION_SHAPE_NAMES = ["Arc", "Bond"];
+var V2_AGGREGATE_SHAPE_NAMES = ["Set", "List"];
+var ORDINARY_COLLECTION_SHAPE_NAMES = [
+  ...V2_RELATION_SHAPE_NAMES,
+  ...V2_AGGREGATE_SHAPE_NAMES
+];
+var COLLECTION_V2_SHAPE_NAMES = [
+  "Collection",
+  ...ORDINARY_COLLECTION_SHAPE_NAMES
+];
 var RESERVED_COLLECTION_SHAPE_NAMES = [
   ...BUILTIN_SHAPE_NAMES,
   ...RETIRED_COLLECTION_SHAPE_NAMES
 ];
+var COLLECTION_CLASSIFICATION_SHAPE_NAMES = [
+  "Collection",
+  ...RESERVED_COLLECTION_SHAPE_NAMES
+];
+var COLLECTION_CLASSIFICATION_SHAPE_NAME_SET = new Set(COLLECTION_CLASSIFICATION_SHAPE_NAMES);
 function isBuiltinCollectionShape(name) {
   return BUILTIN_SHAPE_NAMES.includes(name);
 }
 function isRetiredCollectionShape(name) {
   return RETIRED_COLLECTION_SHAPE_NAMES.includes(name);
 }
+function isOrdinaryCollectionShape(name) {
+  return ORDINARY_COLLECTION_SHAPE_NAMES.includes(name);
+}
+function isCollectionV2Shape(name) {
+  return COLLECTION_V2_SHAPE_NAMES.includes(name);
+}
 function isReservedCollectionShape(name) {
   return RESERVED_COLLECTION_SHAPE_NAMES.includes(name);
 }
@@ -17793,7 +17814,7 @@ var BUILTIN_LICENSE_SHAPE_NAMES = [
 ];
 var isLicenseShape = (name) => BUILTIN_LICENSE_SHAPE_NAMES.includes(name);
 function isRenameableSquattedShape(name) {
-  return isReservedCollectionShape(name) || isViewShape(name) || isLicenseShape(name);
+  return isReservedCollectionShape(name) || isCollectionV2Shape(name) || isViewShape(name) || isLicenseShape(name);
 }
 function isBuiltinShape(name) {
   return BUILTIN_SHAPE_NAMES.includes(name) || BUILTIN_CONTENT_SHAPE_NAMES.includes(name) || BUILTIN_VIEW_SHAPE_NAMES.includes(name) || BUILTIN_LICENSE_SHAPE_NAMES.includes(name);
@@ -17838,6 +17859,47 @@ var BUILTIN_SHAPE_DEFS = {
     description: "An ordered list of things"
   }
 };
+var COLLECTION_V2_SHAPE_DEFS = {
+  Collection: { fields: {} },
+  Arc: {
+    fields: {
+      from: { type: "wref", binding: "either" },
+      to: { type: "wref", binding: "either" }
+    },
+    composes: ["Collection"]
+  },
+  Bond: {
+    fields: {
+      ends: {
+        type: "array",
+        items: { type: "wref", binding: "either" },
+        minItems: 2,
+        maxItems: 2
+      }
+    },
+    composes: ["Collection"]
+  },
+  Set: {
+    fields: {
+      members: {
+        type: "array",
+        items: { type: "wref", binding: "either" },
+        minItems: 1
+      }
+    },
+    composes: ["Collection"]
+  },
+  List: {
+    fields: {
+      items: {
+        type: "array",
+        items: { type: "wref", binding: "either" },
+        minItems: 1
+      }
+    },
+    composes: ["Collection"]
+  }
+};
 var BUILTIN_CONTENT_SHAPE_DEFS = {
   Content: {
     fields: {
@@ -26050,10 +26112,10 @@ function illegalOpSequences(operations, errors, checkAddAdd, options) {
 
 // ../../packages/rules/src/preflight-operation.ts
 var collectionTypes = ["arc", "bond", "set", "list", "pair"];
-var canonicalCollectionTypes = ["arc", "bond", "set", "list"];
+var canonicalCollectionTypes = ["arc", "bond", "pair", "set", "list"];
 var collectionOps = ["add", "revise"];
 var COLLECTION_CREATE_REQUIRES_NAME_MESSAGE = "Collection create requires a name. Collections are ordinary named things (ADR 0004).";
-var COLLECTION_ABOUT_REMOVED_MESSAGE = 'about accepts a wref. Create the collection as its own named operation, then point the assertion at it. Prefer deterministic relationship names, for example: [{"operation":"add","kind":"collection","type":"arc","name":"a-to-b","members":["A","B"]},{"operation":"add","kind":"assertion","about":"Arc/a-to-b","name":"Assertion/example","data":{}}]. For CLI usage, use wh commit submit --file with the two operations.';
+var COLLECTION_ABOUT_REMOVED_MESSAGE = 'about accepts a wref. Create the collection as its own named operation, then point the assertion at it. Prefer deterministic relationship names, for example: [{"operation":"add","kind":"thing","name":"Arc/a-to-b","data":{"from":"Shape/A","to":"Shape/B"}},{"operation":"add","kind":"assertion","about":"Arc/a-to-b","name":"Assertion/example","data":{}}]. For CLI usage, use wh commit submit --file with the two operations.';
 function parseCollectionType(value) {
   return collectionTypes.find((candidate) => candidate === value) ?? null;
 }
@@ -26088,7 +26150,7 @@ function builtinShapeGuard(op, operationIndex) {
       message: `Shape "${op.newName}" is a retired collection shape and cannot be written manually`
     });
   } else {
-    const builtinShapeName = name && isBuiltinShape(name) && !reservedSourcePassThrough ? name : isShapeRename && op.newName && isBuiltinShape(op.newName) ? op.newName : undefined;
+    const builtinShapeName = name && (isBuiltinShape(name) || isCollectionV2Shape(name)) && !reservedSourcePassThrough ? name : isShapeRename && op.newName && (isBuiltinShape(op.newName) || isCollectionV2Shape(op.newName)) ? op.newName : undefined;
     if (builtinShapeName && (isShapeRename || op.operation !== "retract" && op.kind === "shape")) {
       const action = op.operation === "add" ? "created" : op.operation === "rename" ? "renamed" : "revised";
       errors.push({
@@ -26098,7 +26160,7 @@ function builtinShapeGuard(op, operationIndex) {
       });
     }
   }
-  if (name) {
+  if (name && op.operation !== "retract") {
     const local = splitLocalPath(name);
     if (local && isRetiredCollectionShape(local.shapePrefix)) {
       errors.push({
@@ -26106,7 +26168,7 @@ function builtinShapeGuard(op, operationIndex) {
         operationIndex,
         message: `Cannot ${op.operation} under retired collection shape "${local.shapePrefix}". Triple is read-only and retired for new collection writes.`
       });
-    } else if (op.kind === "thing" && local && isBuiltinCollectionShape(local.shapePrefix)) {
+    } else if (op.kind === "thing" && local && (isBuiltinCollectionShape(local.shapePrefix) && !isOrdinaryCollectionShape(local.shapePrefix) || local.shapePrefix === "Collection")) {
       const message = op.operation === "add" ? `Cannot add kind="thing" under built-in shape "${local.shapePrefix}". Use kind="collection" instead.` : `Cannot revise kind="thing" under built-in shape "${local.shapePrefix}". Use kind="collection" to revise a collection.`;
       errors.push({
         code: "VALIDATION_ERROR",
@@ -26195,6 +26257,7 @@ function validateCollectionOps(op, operationIndex) {
   if (parseCollectionOp(op.operation) === null) {
     return errors;
   }
+  const collectionType = parseCollectionType(op.type);
   if (op.operation === "add" && !op.name) {
     errors.push({
       code: "VALIDATION_ERROR",
@@ -26202,7 +26265,6 @@ function validateCollectionOps(op, operationIndex) {
       message: COLLECTION_CREATE_REQUIRES_NAME_MESSAGE
     });
   }
-  const collectionType = parseCollectionType(op.type);
   if (collectionType === null) {
     errors.push({
       code: "VALIDATION_ERROR",
@@ -40590,12 +40652,12 @@ function compareUnsignedUtf8(left, right) {
 var CHECKPOINT_CHUNK_BYTE_LIMIT = 67108864;
 var CHECKPOINT_PART_DIGITS = 10;
 var CHECKPOINT_FORMAT = "warmhub-repository-checkpoint";
-var CHECKPOINT_FORMAT_VERSION = 2;
+var CHECKPOINT_FORMAT_VERSION = 3;
 var CHECKPOINT_MANIFEST_NAME = "repository-checkpoint.json";
 var checkpointSha256Schema = exports_external.string().regex(/^[0-9a-f]{64}$/);
-var nonnegativeSafeIntegerSchema = exports_external.number().int().nonnegative().safe();
-var positiveSafeIntegerSchema = exports_external.number().int().positive().safe();
-var jsonNumberSchema = exports_external.number().finite().refine((value) => !Number.isInteger(value) || Number.isSafeInteger(value), "JSON integers must be safe integers");
+var nonnegativeSafeIntegerSchema = exports_external.number().int().nonnegative();
+var positiveSafeIntegerSchema = exports_external.number().int().positive();
+var jsonNumberSchema = exports_external.number().refine((value) => !Number.isInteger(value) || Number.isSafeInteger(value), "JSON integers must be safe integers");
 var jsonValueSchema = exports_external.lazy(() => exports_external.union([
   exports_external.null(),
   exports_external.boolean(),
@@ -40607,11 +40669,11 @@ var jsonValueSchema = exports_external.lazy(() => exports_external.union([
 var checkpointRowBaseSchema = exports_external.object({
   wref: exports_external.string().min(1),
   durableId: exports_external.string().min(1),
-  version: exports_external.number().int().positive().safe(),
+  version: exports_external.number().int().positive(),
   active: exports_external.literal(true),
   data: jsonValueSchema
 });
-var pinnedWrefSchema = exports_external.string().regex(/^[^\r\n]+@v[1-9]\d*$/, "Checkpoint wref must be pinned with @vN");
+var pinnedWrefSchema = exports_external.string().regex(/^[^\r\n]+@v[1-9]\d*(?![\s\S])/, "Checkpoint wref must be pinned with @vN");
 var affirmedWrefsSchema = exports_external.array(pinnedWrefSchema).superRefine((wrefs, context) => {
   for (let index = 1;index < wrefs.length; index += 1) {
     const previous = wrefs[index - 1];
@@ -40625,11 +40687,16 @@ var affirmedWrefsSchema = exports_external.array(pinnedWrefSchema).superRefine((
     }
   }
 });
+var checkpointCollectionsSchema = exports_external.array(exports_external.object({
+  shape: exports_external.string().min(1),
+  memberCount: nonnegativeSafeIntegerSchema
+}).strict()).min(1);
 var checkpointRowSchema = exports_external.discriminatedUnion("kind", [
   checkpointRowBaseSchema.extend({ kind: exports_external.literal("shape") }).strict(),
   checkpointRowBaseSchema.extend({
-    kind: exports_external.enum(["thing", "collection"]),
-    shapeName: exports_external.string().min(1)
+    kind: exports_external.literal("thing"),
+    shapeName: exports_external.string().min(1),
+    collections: checkpointCollectionsSchema.optional()
   }).strict(),
   checkpointRowBaseSchema.extend({
     kind: exports_external.literal("assertion"),
@@ -40653,9 +40720,9 @@ var checkpointManifestStreamSchema = exports_external.object({
 var checkpointManifestFields = {
   format: exports_external.literal(CHECKPOINT_FORMAT),
   formatVersion: exports_external.literal(CHECKPOINT_FORMAT_VERSION),
-  checkpointId: exports_external.string().uuid(),
+  checkpointId: exports_external.uuid(),
   repository: exports_external.object({
-    id: exports_external.string().uuid(),
+    id: exports_external.uuid(),
     org: exports_external.string().min(1),
     repo: exports_external.string().min(1)
   }).strict(),
@@ -40848,7 +40915,7 @@ function addOneSafe(value) {
   return next;
 }
 // ../../packages/rules/src/repository-export/types.ts
-var REPOSITORY_EXPORT_FORMAT_VERSION = 3;
+var REPOSITORY_EXPORT_FORMAT_VERSION = 4;
 var REPOSITORY_EXPORT_MEDIA_TYPE = "application/x-ndjson";
 var repositoryExportSha256Schema = exports_external.string().regex(/^[0-9a-f]{64}$/);
 var nonnegativeSafeIntegerSchema2 = exports_external.number().int().nonnegative();
@@ -40856,22 +40923,10 @@ var positiveSafeIntegerSchema2 = exports_external.number().int().positive();
 var REPOSITORY_EXPORT_ROW_KINDS = [
   "shape",
   "thing",
-  "collection",
   "assertion"
 ];
 var REPOSITORY_EXPORT_MODES = ["heads", "ops"];
-var REPOSITORY_EXPORT_SHAPE_PROVENANCES = [
-  "captured",
-  "migration-stamped",
-  "reconstructed"
-];
-var repositoryExportShapeCertificateSchema = exports_external.object({
-  name: exports_external.string().min(1),
-  v: positiveSafeIntegerSchema2,
-  durableId: exports_external.string().min(1),
-  provenance: exports_external.enum(REPOSITORY_EXPORT_SHAPE_PROVENANCES),
-  declared: exports_external.boolean()
-}).strict();
+var repositoryExportShapeCertificateSchema = exports_external.string().regex(/^[^\r\n]+@v[1-9]\d*(?![\s\S])/, "Shape certificate must be a pinned wref");
 var repositoryExportReferenceSchema = exports_external.object({
   wref: exports_external.string().min(1),
   v: positiveSafeIntegerSchema2.optional(),
@@ -40888,11 +40943,23 @@ function refineStrictlyIncreasing(entries, key, message, context) {
   });
 }
 var shapesSchema = exports_external.array(repositoryExportShapeCertificateSchema).superRefine((shapes, context) => {
-  refineStrictlyIncreasing(shapes, (entry) => entry.durableId, "Shape certificates must be unique and strictly increasing by durableId", context);
+  refineStrictlyIncreasing(shapes.slice(1), (entry) => entry, "Shape certificates after the declared one must be unique and strictly increasing", context);
+  const declared = shapes[0];
+  if (declared !== undefined && shapes.indexOf(declared, 1) !== -1) {
+    context.addIssue({
+      code: "custom",
+      path: [shapes.indexOf(declared, 1)],
+      message: "The declared Shape must not repeat in the closure tail"
+    });
+  }
 });
 var affirmedSchema = exports_external.array(repositoryExportReferenceSchema).superRefine((affirmed, context) => {
   refineStrictlyIncreasing(affirmed, (entry) => entry.wref, "Affirmed references must be unique and strictly increasing", context);
 });
+var repositoryExportCollectionsSchema = exports_external.array(exports_external.object({
+  shape: exports_external.string().min(1),
+  memberCount: exports_external.number().int().nonnegative()
+}).strict()).min(1);
 var rowEnvelopeFields = {
   wref: exports_external.string().min(1),
   durableId: exports_external.string().min(1),
@@ -40911,8 +40978,9 @@ var activeRowSchema = exports_external.discriminatedUnion("kind", [
   }).strict(),
   exports_external.object({
     ...activeRowFields,
-    kind: exports_external.enum(["thing", "collection"]),
-    shapes: shapesSchema
+    kind: exports_external.literal("thing"),
+    shapes: shapesSchema,
+    collections: repositoryExportCollectionsSchema.optional()
   }).strict(),
   exports_external.object({
     ...activeRowFields,
@@ -41631,13 +41699,28 @@ var SYSTEM_MANIFEST = {
   },
   shapes: [
     { name: "ComponentInstall", fields: COMPONENT_INSTALL_FIELDS },
-    { name: "ComponentConfig", fields: COMPONENT_CONFIG_FIELDS }
+    { name: "ComponentConfig", fields: COMPONENT_CONFIG_FIELDS },
+    { name: "Collection", ...COLLECTION_V2_SHAPE_DEFS.Collection },
+    { name: "Arc", ...COLLECTION_V2_SHAPE_DEFS.Arc },
+    { name: "Bond", ...COLLECTION_V2_SHAPE_DEFS.Bond },
+    { name: "Set", ...COLLECTION_V2_SHAPE_DEFS.Set },
+    { name: "List", ...COLLECTION_V2_SHAPE_DEFS.List }
   ],
   credentials: [],
   subscriptions: [],
   seeds: [],
   health: {
-    requires: { shapes: ["ComponentInstall", "ComponentConfig"] }
+    requires: {
+      shapes: [
+        "ComponentInstall",
+        "ComponentConfig",
+        "Collection",
+        "Arc",
+        "Bond",
+        "Set",
+        "List"
+      ]
+    }
   },
   teardown: {},
   runtimeAccess: { reads: [], writes: [] }
@@ -41657,7 +41740,12 @@ var SYSTEM_COMPONENT = {
       name: "ComponentConfig",
       fields: COMPONENT_CONFIG_FIELDS,
       installInfra: true
-    }
+    },
+    { name: "Collection", ...COLLECTION_V2_SHAPE_DEFS.Collection },
+    { name: "Arc", ...COLLECTION_V2_SHAPE_DEFS.Arc },
+    { name: "Bond", ...COLLECTION_V2_SHAPE_DEFS.Bond },
+    { name: "Set", ...COLLECTION_V2_SHAPE_DEFS.Set },
+    { name: "List", ...COLLECTION_V2_SHAPE_DEFS.List }
   ]
 };
 
@@ -45323,7 +45411,7 @@ function createStreamingSubmissionHandle(input, deps) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.124.0",
+  version: "0.126.0",
   private: false,
   type: "module",
   description: "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -47160,7 +47248,8 @@ class WarmHubClient {
           wref,
           version: opts?.version,
           limit: opts?.limit,
-          cursor: opts?.cursor
+          cursor: opts?.cursor,
+          shape: opts?.shape
         });
       } catch (error51) {
         throw toWarmHubError(error51);
@@ -47199,7 +47288,8 @@ class WarmHubClient {
           wref,
           version: opts?.version,
           members,
-          position: opts?.position
+          position: opts?.position,
+          shape: opts?.shape
         });
       } catch (error51) {
         throw toWarmHubError(error51);
@@ -47214,7 +47304,8 @@ class WarmHubClient {
           rightWref,
           leftVersion: opts?.leftVersion,
           rightVersion: opts?.rightVersion,
-          mode: opts?.mode
+          mode: opts?.mode,
+          shape: opts?.shape
         });
       } catch (error51) {
         throw toWarmHubError(error51);
@@ -47259,7 +47350,8 @@ class WarmHubClient {
           orgName,
           repoName,
           wref,
-          version: opts?.version
+          version: opts?.version,
+          shape: opts?.shape
         });
       } catch (error51) {
         throw toWarmHubError(error51);
@@ -52135,30 +52227,23 @@ function pinnedWref(c, wref, version2) {
 function kindLabel(c, kind) {
   return `${c.dim}${kind}${c.reset}`;
 }
-function collectionFields(shapeName, data) {
-  if (!isBuiltinCollectionShape(shapeName))
-    return null;
-  const fieldDefs = BUILTIN_SHAPE_DEFS[shapeName].fields;
-  const result = [];
-  for (const [key, fieldType] of Object.entries(fieldDefs)) {
-    const value = data[key];
-    if (Array.isArray(fieldType)) {
-      const elementType = fieldType[0];
-      if (basePrimitiveTypeFromSpec(elementType) !== "wref")
-        continue;
-      const wrefs = Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
-      result.push({ name: key, wrefs });
-    } else if (basePrimitiveTypeFromSpec(fieldType) === "wref") {
-      result.push({
-        name: key,
-        wrefs: typeof value === "string" ? [value] : []
-      });
-    }
-  }
-  return result;
-}
-function effectiveKind(kind, shapeName) {
-  if ((kind === "thing" || kind === "collection" || !kind) && shapeName && isBuiltinCollectionShape(shapeName)) {
+function asCollectionSummaries(value) {
+  if (!Array.isArray(value))
+    return;
+  const entries = value.filter((entry) => typeof entry === "object" && entry !== null && typeof entry.shape === "string");
+  return entries.length > 0 ? entries : undefined;
+}
+function bareShapeName(token) {
+  const withoutVersion = token.split("@", 1)[0] ?? "";
+  return withoutVersion.slice(withoutVersion.lastIndexOf("/") + 1);
+}
+function effectiveKind(kind, shapeName, collections) {
+  if (kind !== "thing" && kind)
+    return kind;
+  const summaryShape = collections?.[0]?.shape;
+  if (summaryShape)
+    return bareShapeName(summaryShape).toLowerCase();
+  if (shapeName && isBuiltinCollectionShape(shapeName)) {
     return shapeName.toLowerCase();
   }
   return kind;
@@ -53084,7 +53169,7 @@ function renderHead(out, c, chars, result, org, repo, shape, kind) {
   for (const item of items) {
     const wref = pinnedWref(c, item.wref ?? item.name ?? "(unknown)", item.version);
     const shapeName = item.shapeName;
-    const kl = kindLabel(c, effectiveKind(item.kind ?? "thing", shapeName));
+    const kl = kindLabel(c, effectiveKind(item.kind ?? "thing", shapeName, asCollectionSummaries(item.collections)));
     const retractedTag = item.active === false ? `  ${c.red}[RETRACTED]${c.reset}` : "";
     out(`  ${wref}  ${kl}${retractedTag}`);
     if (item.declaredShapes?.length) {
@@ -53099,11 +53184,7 @@ function renderHead(out, c, chars, result, org, repo, shape, kind) {
     if (item.affirmedWrefs?.length) {
       out(`    ${c.dim}affirms:${c.reset} ${refList(c, item.affirmedWrefs, decorations)}`);
     }
-    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(`    ${refList(c, allWrefs, decorations)}`);
-    } else if (item.data && typeof item.data === "object") {
+    if (item.data && typeof item.data === "object") {
       out(`    ${dataPreview(c, item.data)}`);
     }
     const itemMeta = item.metadata;
@@ -53117,7 +53198,7 @@ function renderThing(out, c, result) {
   const decorations = getResponseDecorations(result);
   const wref = result.wref ?? result.name ?? "(unknown)";
   const shapeName = singularShapeName(result);
-  const displayKind = effectiveKind(result.kind ?? "thing", shapeName);
+  const displayKind = effectiveKind(result.kind ?? "thing", shapeName, result.collections);
   const retractedTag = result.active === false ? `  ${c.red}[RETRACTED]${c.reset}` : "";
   out(`${pinnedWref(c, wref, result.version)}  ${kindLabel(c, displayKind)}${retractedTag}`);
   out(`  ${c.dim}wref:${c.reset}      ${escapeTerminalTextForDisplay(wref)}`);
@@ -53153,29 +53234,18 @@ function renderThing(out, c, result) {
       out(`  ${c.dim}revisedOn:${c.reset}  ${formatTime(meta3.revisedOn, now)}`);
     }
   }
-  if (result.collection) {
-    renderCollectionSummary(out, c, result.collection, decorations);
+  for (const collection of result.collections ?? []) {
+    renderCollectionSummary(out, c, collection, decorations);
   }
-  const fields = shapeName && result.data ? collectionFields(shapeName, result.data) : null;
-  if (fields) {
-    for (const field of fields) {
-      if (field.wrefs.length === 1) {
-        const pad = " ".repeat(Math.max(1, 9 - field.name.length));
-        out(`  ${c.dim}${escapeTerminalTextForDisplay(field.name)}:${c.reset}${pad}${refDisplay(c, field.wrefs[0] ?? "", decorations)}`);
-      } else {
-        out(`  ${c.dim}${escapeTerminalTextForDisplay(field.name)}:${c.reset}`);
-        for (const w of field.wrefs) {
-          out(`    ${refDisplay(c, w, decorations)}`);
-        }
-      }
-    }
-  } else if (result.data) {
+  if (result.data) {
     out(`  ${c.dim}data:${c.reset}`);
     renderJsonDataBlock(out, c, result.data, "    ", decorations);
   }
 }
 function renderCollectionSummary(out, c, collection, decorations) {
-  out(`  ${c.dim}collection:${c.reset} ${collection.type}`);
+  out(`  ${c.dim}collection:${c.reset} ${collection.shape}`);
+  if (collection.memberCount === undefined)
+    return;
   out(`  ${c.dim}members:${c.reset}    ${collection.memberCount}`);
   if (collection.fullData)
     return;
@@ -53209,7 +53279,7 @@ function renderGraphValue(out, c, value, indent, decorations) {
 function renderGraphNode(out, c, result, indent = "", decorations) {
   const wref = result.wref ?? result.name ?? "(unknown)";
   const shapeName = singularShapeName(result);
-  const displayKind = effectiveKind(result.kind ?? "thing", shapeName);
+  const displayKind = effectiveKind(result.kind ?? "thing", shapeName, result.collections);
   out(`${indent}${pinnedWref(c, wref, result.version)}  ${kindLabel(c, displayKind)}`);
   if (result.about) {
     out(`${indent}  ${c.dim}about:${c.reset}`);
@@ -53339,7 +53409,7 @@ function renderBatchView(out, c, result, wrefs, flagsVersion) {
     const requestedBase = requested.replace(/@.+$/, "");
     const fallback = item.wref ?? `${item.shapeName ?? "?"}/${item.name ?? "(unknown)"}`;
     const base = requestedBase.length > 0 ? requestedBase : fallback.replace(/@v\d+$/, "");
-    const kl = kindLabel(c, effectiveKind(item.kind ?? "thing", item.shapeName));
+    const kl = kindLabel(c, effectiveKind(item.kind ?? "thing", item.shapeName, asCollectionSummaries(item.collections)));
     const retractedTag = item.active === false ? `  ${c.red}[RETRACTED]${c.reset}` : "";
     const display = labeledRef(c, `${base}@v${item.version}`, fallback) ?? `${escapeTerminalTextForDisplay(base)}@v${item.version}`;
     out(`  ${display}  ${kl}${retractedTag}`);
@@ -54091,7 +54161,7 @@ function renderQueryResults(out, c, result) {
   for (const item of items) {
     const wref = pinnedWref(c, item.wref ?? item.name ?? "(unknown)", item.version);
     const shapeName = item.shapeName;
-    const kl = kindLabel(c, effectiveKind(item.kind ?? "thing", shapeName));
+    const kl = kindLabel(c, effectiveKind(item.kind ?? "thing", shapeName, asCollectionSummaries(item.collections)));
     const retractedTag = item.active === false ? `  ${c.red}[RETRACTED]${c.reset}` : "";
     out(`  ${wref}  ${kl}${retractedTag}`);
     if (item.declaredShapes?.length) {
@@ -54103,11 +54173,7 @@ function renderQueryResults(out, c, result) {
     if (item.roles?.length) {
       out(`    ${c.dim}roles:${c.reset} ${item.roles.join(", ")}`);
     }
-    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(`    ${refList(c, allWrefs, decorations)}`);
-    } else if (item.data && typeof item.data === "object") {
+    if (item.data && typeof item.data === "object") {
       out(`    ${dataPreview(c, item.data)}`);
     }
   }
@@ -56424,9 +56490,11 @@ function renderMembers(ctx, result) {
     return;
   }
   const decorations = getResponseDecorations(result);
-  for (const item of result.items) {
-    const position = item.position ?? 0;
-    ctx.out(`${String(position).padStart(4, " ")}  ${refDisplay(c, item.wref, decorations)}`);
+  const labels = result.items.map((item) => item.position === undefined ? item.fieldPath : `${item.fieldPath}[${item.position}]`);
+  const width = Math.max(...labels.map((label) => label.length));
+  for (const [index, item] of result.items.entries()) {
+    const label = labels[index] ?? "";
+    ctx.out(`  ${c.dim}${label.padEnd(width, " ")}${c.reset}  ${refDisplay(c, item.wref, decorations)}`);
   }
 }
 function renderContains(ctx, result) {
@@ -56467,7 +56535,7 @@ function renderDiff(ctx, result) {
 }
 function renderStats(ctx, result) {
   const c = ctx.colors;
-  ctx.out(`${pinnedWref(c, result.wref)} ${c.dim}${result.type}${c.reset}`);
+  ctx.out(`${pinnedWref(c, result.wref)} ${c.dim}${result.shape}${c.reset}`);
   ctx.out(`members: ${result.memberCount}`);
   ctx.out(`unique:  ${result.uniqueMemberCount}`);
 }
@@ -56526,11 +56594,11 @@ async function readStreamUtf82(input) {
 var SUPPORTED_COLLECTION_TYPES = [
   "arc",
   "bond",
+  "pair",
   "set",
-  "list",
-  "pair"
+  "list"
 ];
-var CANONICAL_COLLECTION_TYPE_USAGE = "<arc|bond|set|list>";
+var CANONICAL_COLLECTION_TYPE_USAGE = "<arc|bond|pair|set|list>";
 var commonWriteFlags = {
   "event-request-id": operationEventRequestIdFlag,
   message: flag.string({ short: "m", description: "Commit message" }),
@@ -56576,7 +56644,7 @@ var collectionQueryFlags = {
 };
 var collectionCreateFlags = {
   type: flag.string({
-    description: "For new collections, use arc, bond, set, or list"
+    description: "set, list, or the legacy deprecated arc, bond, pair. Set/List land as ordinary Things under their protected V2 Shapes; arc/bond/pair are accepted during the compatibility window and lowered to ordinary Things."
   }),
   name: flag.string({
     description: "Collection local name. Collections are ordinary named things."
@@ -56605,13 +56673,19 @@ var collectionCreateFlags = {
   ...collectionQueryFlags,
   ...commonWriteFlags
 };
+var collectionReadShapeFlag = {
+  shape: flag.string({
+    description: "Collection Shape to read this Thing under (required for composites, e.g. Arc)"
+  })
+};
 var collectionMembersFlags = {
   limit: flag.number({
     description: "Max members per page (default: 50, max: 500)"
   }),
   cursor: flag.string({ description: "Opaque pagination cursor" }),
   all: flag.boolean({ description: "Fetch all pages" }),
-  version: flag.number({ description: "Specific version number" })
+  version: flag.number({ description: "Specific version number" }),
+  ...collectionReadShapeFlag
 };
 var collectionContainsFlags = {
   position: flag.number({
@@ -56620,7 +56694,8 @@ var collectionContainsFlags = {
   version: flag.number({
     description: "Specific collection version number. Member inputs are still pinned before comparison; use pinned @vN members for historical membership checks."
   }),
-  ...collectionInputFlags
+  ...collectionInputFlags,
+  ...collectionReadShapeFlag
 };
 var collectionDiffFlags = {
   mode: flag.string({
@@ -56631,7 +56706,8 @@ var collectionDiffFlags = {
   }),
   "right-version": flag.number({
     description: "Specific right collection version"
-  })
+  }),
+  ...collectionReadShapeFlag
 };
 var collectionReviseFlags = {
   add: flag.string({
@@ -56647,7 +56723,8 @@ var collectionReviseFlags = {
   ...commonWriteFlags
 };
 var collectionStatsFlags = {
-  version: flag.number({ description: "Specific collection version number" })
+  version: flag.number({ description: "Specific collection version number" }),
+  ...collectionReadShapeFlag
 };
 function validateCollectionType(value) {
   const parsed = SUPPORTED_COLLECTION_TYPES.find((candidate) => candidate === value);
@@ -56662,7 +56739,7 @@ function validateDiffMode(value) {
   if (value === "auto" || value === "membership" || value === "ordered") {
     return value;
   }
-  usageError("--mode must be one of: auto, membership, ordered", "wh collection diff Set/a Set/b --mode membership");
+  return usageError("--mode must be one of: auto, membership, ordered", "wh collection diff Set/a Set/b --mode membership");
 }
 function collectionQuerySourceFromFlags(flags) {
   const where = (flags.where ?? []).map(parseWhereFlag);
@@ -56702,9 +56779,6 @@ function requireSetForQuerySource(type, source, example) {
     return;
   usageError("Selector-backed collection sources are only supported for set collections", example);
 }
-function normalizeCreateMembers(type, members) {
-  return type === "set" ? Array.from(new Set(members)) : members;
-}
 function hasDeferredMemberSource(flags) {
   return !!flags.file || !!flags.stdin;
 }
@@ -56766,7 +56840,7 @@ var handleCollectionCreate = async (ctx, { flags, args }) => {
   }) : undefined;
   const eventRequestId = flags["event-request-id"] ?? createOperationEventRequestId();
   ctx.status(`Operation event request: ${eventRequestId}`);
-  const inlineMembers = normalizeCreateMembers(type, parseMemberList(flags.members));
+  const inlineMembers = parseMemberList(flags.members);
   if (flags["skip-existing"] && !queryBacked && inlineMembers.length === 0 && hasDeferredMemberSource(flags)) {
     try {
       const result2 = await ctx.client.collection.create(org, repo, {
@@ -56792,7 +56866,7 @@ var handleCollectionCreate = async (ctx, { flags, args }) => {
     wrefField: flags["wref-field"],
     label: "collection members"
   });
-  const members = normalizeCreateMembers(type, explicitMembers);
+  const members = explicitMembers;
   if (sourceRepo && members.length > 0) {
     usageError("--source-repo cannot be combined with explicit members; use canonical wh:org/repo/... member wrefs or omit --source-repo.", "wh collection create --type set --name wake-voters --source-repo data/nc-voters --shape Voter --where county=Wake");
   }
@@ -56861,12 +56935,13 @@ var handleCollectionMembers = async (ctx, { flags, args }) => {
       fetchPage: (cursor) => ctx.client.collection.members(org, repo, wref, {
         version: snapshotVersion,
         limit: pageLimit,
-        cursor
+        cursor,
+        shape: flags.shape
       }),
       title: "Collection members"
     })) {
       firstPage ??= {
-        type: page.type,
+        shape: page.shape,
         wref: page.wref,
         version: page.version
       };
@@ -56875,7 +56950,7 @@ var handleCollectionMembers = async (ctx, { flags, args }) => {
       snapshotVersion ??= page.version;
     }
     writeCollectionMembersOutput(ctx, withDecorations({
-      type: firstPage?.type ?? "set",
+      shape: firstPage?.shape ?? flags.shape ?? "",
       wref: firstPage?.wref ?? wref,
       version: snapshotVersion ?? firstPage?.version ?? flags.version ?? 1,
       items,
@@ -56886,7 +56961,8 @@ var handleCollectionMembers = async (ctx, { flags, args }) => {
   const result = await ctx.client.collection.members(org, repo, wref, {
     version: flags.version,
     limit: boundedLimit,
-    cursor: flags.cursor
+    cursor: flags.cursor,
+    shape: flags.shape
   });
   if (result.nextCursor) {
     emitPartialPageHint(ctx, result.items.length, result.nextCursor, boundedLimit);
@@ -56901,7 +56977,7 @@ function writeCollectionMembersOutput(ctx, result, page) {
   if (ctx.format === "json") {
     const envelope = pageEnvelope(result.items, page);
     printJson(ctx.out, {
-      type: result.type,
+      shape: result.shape,
       wref: result.wref,
       version: result.version,
       items: result.items,
@@ -56933,7 +57009,8 @@ var handleCollectionContains = async (ctx, { flags, args }) => {
   const { org, repo } = parseCollectionReadRepo(ctx, [wref]);
   const result = await ctx.client.collection.contains(org, repo, wref, members, {
     version: flags.version,
-    position: flags.position
+    position: flags.position,
+    shape: flags.shape
   });
   writeOutput(ctx, result, () => renderContains(ctx, result));
 };
@@ -56946,7 +57023,8 @@ var handleCollectionDiff = async (ctx, { flags, args }) => {
   const result = await ctx.client.collection.diff(org, repo, leftWref, rightWref, {
     leftVersion: flags["left-version"],
     rightVersion: flags["right-version"],
-    mode: validateDiffMode(flags.mode)
+    mode: validateDiffMode(flags.mode),
+    shape: flags.shape
   });
   writeOutput(ctx, result, () => renderDiff(ctx, result));
 };
@@ -57017,7 +57095,8 @@ var handleCollectionStats = async (ctx, { flags, args }) => {
   }
   const { org, repo } = parseCollectionReadRepo(ctx, [wref]);
   const result = await ctx.client.collection.stats(org, repo, wref, {
-    version: flags.version
+    version: flags.version,
+    shape: flags.shape
   });
   writeOutput(ctx, result, () => renderStats(ctx, result));
 };
@@ -57266,7 +57345,7 @@ var createFlags3 = {
     multiple: true
   }),
   type: flag.string({
-    description: "For new collections, use arc, bond, set, or list"
+    description: "set, list, or the legacy deprecated arc, bond, pair. Set/List land as ordinary Things under their protected V2 Shapes; arc/bond/pair are accepted during the compatibility window and lowered to ordinary Things."
   }),
   name: flag.string({
     description: "collection name for --type shorthand"
@@ -57300,27 +57379,29 @@ function identifyCommitSubmitStreamRow(row) {
 // ../../packages/warmhub-cli/src/domains/commit-submit-template.ts
 import { writeFile } from "node:fs/promises";
 var WRITE_TEMPLATE_KINDS = ["thing", "assertion"];
-var COLLECTION_TEMPLATE_SPECS = {
-  Arc: {
-    type: "arc",
-    members: ["Shape/FILL_IN_FROM", "Shape/FILL_IN_TO"]
-  },
-  Bond: {
-    type: "bond",
-    members: ["Shape/FILL_IN_1", "Shape/FILL_IN_2"]
-  },
-  Set: { type: "set", members: ["Shape/FILL_IN"] },
-  List: { type: "list", members: ["Shape/FILL_IN"] }
-};
-function collectionTemplateSpec(shapeName) {
-  if (!isBuiltinCollectionShape(shapeName) || shapeName === "Pair") {
-    return;
+async function readTemplateShape(ctx, org, repo, shapeName) {
+  try {
+    const shape = await ctx.client.shape.get(org, repo, shapeName);
+    if ((shapeName === "Set" || shapeName === "List") && shape.componentRef !== "warmhub/system") {
+      return;
+    }
+    return shape;
+  } catch (error51) {
+    const code = error51.code;
+    if ((shapeName === "Set" || shapeName === "List") && code === "NOT_FOUND") {
+      return;
+    }
+    throw error51;
   }
-  return COLLECTION_TEMPLATE_SPECS[shapeName];
 }
 function zeroValueForField(fieldSpec) {
   if (Array.isArray(fieldSpec))
     return [];
+  const arraySpec = fieldSpec;
+  if (isTypeSpecObject(fieldSpec) && arraySpec.type === "array" && typeof arraySpec.minItems === "number") {
+    const item = zeroValueForField(arraySpec.items);
+    return Array.from({ length: Math.max(0, arraySpec.minItems) }, () => item);
+  }
   const primitiveType = primitiveTypeSpecFromFieldSpec(fieldSpec);
   if (primitiveType) {
     const isOptional = primitiveType.endsWith("?");
@@ -57415,32 +57496,31 @@ var handleTemplate = async (ctx, { flags, args }) => {
   const count = Math.max(1, flags.count ?? 1);
   const operations = [];
   for (const shapeName of shapeNames) {
-    const collectionTemplate = templateKind === "thing" ? collectionTemplateSpec(shapeName) : undefined;
-    const operationKind = collectionTemplate ? "collection" : templateKind;
     if (operationType === "retract") {
       for (let i = 0;i < count; i++) {
         operations.push({
           operation: "retract",
-          kind: operationKind,
-          name: operationKind === "shape" ? shapeName : `${shapeName}/FILL_IN`
+          kind: templateKind,
+          name: templateKind === "shape" ? shapeName : `${shapeName}/FILL_IN`
         });
       }
       continue;
     }
     const nameSuffix = count > 1 ? (i) => `my-${shapeName.toLowerCase()}-${i + 1}` : () => `my-${shapeName.toLowerCase()}`;
-    if (collectionTemplate) {
+    const shape = await readTemplateShape(ctx, org, repo, shapeName);
+    if (shape === undefined) {
+      const type = shapeName === "Set" ? "set" : "list";
       for (let i = 0;i < count; i++) {
         operations.push({
           operation: operationType,
           kind: "collection",
-          type: collectionTemplate.type,
+          type,
           name: operationType === "add" ? nameSuffix(i) : `${shapeName}/FILL_IN`,
-          members: [...collectionTemplate.members]
+          members: ["Shape/FILL_IN"]
         });
       }
       continue;
     }
-    const shape = await ctx.client.shape.get(org, repo, shapeName);
     const shapeVersion = shape.version;
     const shapeData = shapeVersion?.data;
     const fields = shapeData?.fields ?? {};
@@ -57643,7 +57723,7 @@ var SOURCE_COMMAND_EXAMPLES = {
   "--add": "wh commit submit --add Proof/example --data '{}' -m 'Add Proof/example' --repo acme/world",
   "--revise": "wh commit submit --revise Proof/example --data '{}' -m 'Revise Proof/example' --repo acme/world",
   "--retract": "wh commit submit --retract Proof/example -m 'Retract Proof/example' --repo acme/world",
-  "--type": "wh commit submit --type arc --name route --members Location/a,Location/b -m 'Add route' --repo acme/world"
+  "--type": `wh commit submit --add route --shape Arc --data '{"from":"Location/a","to":"Location/b"}' -m 'Add route' --repo acme/world`
 };
 function resolveCommitOperationSource(input) {
   const selected = SOURCE_FLAGS.filter(([, key]) => input[key]).map(([flag2]) => flag2);
@@ -58447,11 +58527,10 @@ var handleSubmit = async (ctx, { flags, args }) => {
     }
     return parsed;
   });
-  const validCollectionTypes = ["arc", "bond", "set", "list", "pair"];
-  const canonicalCollectionTypes2 = ["arc", "bond", "set", "list"];
+  const validCollectionTypes = ["arc", "bond", "pair", "set", "list"];
   const collectionType = validCollectionTypes.find((candidate) => candidate === flags.type);
   if (flags.type !== undefined && collectionType === undefined) {
-    throw new CliError(2 /* UserInput */, "USER_INPUT", `Invalid --type "${flags.type}". Use one of: ${canonicalCollectionTypes2.join(", ")}`, undefined, "wh commit submit --type arc --name route --members Location/a,Location/b");
+    throw new CliError(2 /* UserInput */, "USER_INPUT", `Invalid --type "${flags.type}". Use one of: ${validCollectionTypes.join(", ")}`, undefined, "wh commit submit --type set --name group --members Location/a,Location/b");
   }
   const jsonlFile = opsFile?.endsWith(".jsonl") === true;
   const operationSource = resolveCommitOperationSource({
@@ -58495,10 +58574,10 @@ var handleSubmit = async (ctx, { flags, args }) => {
   } else if (operationSource === "--type") {
     const selectedCollectionType = requireCommitSourceValue(operationSource, collectionType);
     if (!flags.name) {
-      usageError("Usage: wh commit submit --type <arc|bond|set|list> --name <collection-name> --members <wref1,wref2,...>", "wh commit submit --type arc --name route --members Location/a,Location/b");
+      usageError("Usage: wh commit submit --type <arc|bond|pair|set|list> --name <collection-name> --members <wref1,wref2,...>", "wh commit submit --type set --name group --members Location/a,Location/b");
     }
     if (!flags.members) {
-      usageError("Usage: wh commit submit --type <arc|bond|set|list> --name <collection-name> --members <wref1,wref2,...>", "wh commit submit --type arc --name route --members Location/a,Location/b");
+      usageError("Usage: wh commit submit --type <arc|bond|pair|set|list> --name <collection-name> --members <wref1,wref2,...>", "wh commit submit --type set --name group --members Location/a,Location/b");
     }
     const members = flags.members.split(",").map((m) => m.trim()).filter(Boolean);
     const arityMap = { arc: 2, bond: 2, pair: 2 };
@@ -58660,7 +58739,7 @@ var handleSubmit = async (ctx, { flags, args }) => {
         renderPartialStreamSubmission(ctx, error51, completedAllFailed ? undefined : { committer });
       }
       const recovered = toCliError(error51);
-      throw new CliError(recovered.code, recovered.kind, recovered.message, error51, `${receiptLookupCommand(org, repo, error51.eventRequestId)} ${recovered.hint ?? ""}`.trim(), undefined, recovered.backendCode, recovered.recovery);
+      throw new CliError(recovered.code, recovered.kind, recovered.message, error51, `${receiptLookupCommand(org, repo, error51.eventRequestId)} ${recovered.hint ?? ""}`.trim(), undefined, recovered.errorCode, recovered.recovery);
     }
     throw error51;
   }
@@ -58981,8 +59060,8 @@ var COMMIT_DOMAIN = defineDomain({
         'wh commit submit --file dataset.jsonl --stream-id bulk-2026-06-04 --skip-existing --progress -m "bulk stream"',
         'wh commit submit --file dataset.jsonl --server-stream --stream-id bulk-2026-08-14 --group-size 1000 --format jsonl -m "server stream"',
         "wh shape template Session HypothesisCandidate -o ops.json",
-        "wh commit submit --type arc --name route --members Location/a,Location/b",
-        "wh commit submit --type bond --name peers --members Person/alice,Person/bob",
+        `wh commit submit --add route --shape Arc --data '{"from":"Location/a","to":"Location/b"}'`,
+        `wh commit submit --add peers --shape Bond --data '{"ends":["Person/alice","Person/bob"]}'`,
         'wh commit submit --type set --name active-locations --members Location/a,Location/b,Location/c -m "Create location set"'
       ],
       notes: [
@@ -59595,39 +59674,6 @@ var registryUpdateFlags = {
 // ../../packages/warmhub-cli/src/domains/component-handlers.ts
 import { resolve as resolve2 } from "node:path";
 
-// ../../packages/warmhub-cli/src/domain-rename-hints.ts
-var RENAME_HINT_MAP = {
-  "commit:create": "Renamed to 'wh commit submit'",
-  "commit:template": "Moved to 'wh shape template'",
-  graph: "Moved to 'wh thing graph'",
-  "org:add-member": "Use 'wh org member add'",
-  "org:remove-member": "Use 'wh org member remove'",
-  "org:list-members": "Use 'wh org member list'",
-  "org:change-role": "Use 'wh org member set-role'",
-  "thing:get-many": "Renamed; 'wh thing view' is now variadic",
-  "credential:set-keys": "Folded into 'wh credential set'",
-  "credential:export": {
-    message: "'wh credential export' was removed; it has no direct CLI replacement.",
-    hint: "Webhook subscriptions now auto-inject WEBHOOK_* keys (WEBHOOK_BEARER_TOKEN, WEBHOOK_API_KEY[+ _HEADER], WEBHOOK_BASIC_USERNAME/PASSWORD, WEBHOOK_SIGNING_SECRET) as auth headers — store them on a credential set then bind with 'wh sub bind <subscriptionName> --credentials <setName>'. Generic key names (e.g. API_KEY) are not forwarded."
-  },
-  "shape:delete": "Use 'wh shape retract'",
-  "init:run": "Use 'wh init' (no inner verb)",
-  "prime:run": "Use 'wh prime'",
-  "use:run": "Use 'wh use'",
-  "graph:run": "Use 'wh thing graph'",
-  "doctor:check": "Use 'wh doctor'",
-  "doctor:run": "Use 'wh doctor'",
-  "channel:start": "Use 'wh channel'",
-  "notifications:list": "Use 'wh notifications'"
-};
-var RENAME_HINTS = RENAME_HINT_MAP;
-function resolveRenameHint(entry) {
-  return typeof entry === "string" ? { message: entry } : entry;
-}
-function getTopLevelRenameHintCommands() {
-  return Object.keys(RENAME_HINTS).filter((key) => !key.includes(":"));
-}
-
 // ../../packages/warmhub-cli/src/builtin-cli-domains.ts
 var _names = null;
 var EXTRA_TOP_LEVEL_COMMANDS = ["help"];
@@ -59636,11 +59682,7 @@ function ensureNames() {
     return _names;
   const registry3 = new DomainRegistry;
   registerAllDomains(registry3);
-  _names = new Set([
-    ...registry3.getDomainNames(),
-    ...EXTRA_TOP_LEVEL_COMMANDS,
-    ...getTopLevelRenameHintCommands()
-  ]);
+  _names = new Set([...registry3.getDomainNames(), ...EXTRA_TOP_LEVEL_COMMANDS]);
   return _names;
 }
 function isBuiltinCliDomain(name) {
@@ -61985,8 +62027,7 @@ function parseRecipient(kind, name) {
         ...resolveRegisteredComponentRef(name, CREATE_USAGE, CREATE_EXAMPLE)
       };
     default:
-      usageError("Grant recipient kind must be member, pat, or component.", CREATE_EXAMPLE);
-      throw new Error("usageError must throw");
+      return usageError("Grant recipient kind must be member, pat, or component.", CREATE_EXAMPLE);
   }
 }
 function isPatternList(value) {
@@ -62959,7 +63000,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- Wref `binding`: `identity` follows the Thing, `versioned` pins.\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 --dry-run --repo org/repo  # preview; remove --dry-run to submit\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 — Things\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|--file) [--shape]` — 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] [--expected-version]` — 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] [--role from|to|ends] [--limit] [--include-retracted]` — Show assertions about the target identity; `--resolve-collections` expands bare/@HEAD/@ALL members, `--role` filters direction; not pinned @vN\n\n- `wh view evaluate VIEW [--limit N] [--cursor TOK] [--all]`\n### commit — Write operations\n- `wh commit submit [--ops|--file|--add|--revise|--retract] [--dry-run] [--skip-existing]` — Submit operations, or evaluate the complete bounded input without durable changes under `--dry-run`. JSONL preview emits one operation row per input plus one summary.\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] [--expected-version]` — 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|--file)`\n- `wh shape create <name> (--fields|--file)`\n- `wh shape retract <name> -m <message> [--reason] [--expected-version]` — 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>` — Retire; name reserved\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` — help overview\n- `wh <domain>` — domain verbs\n- `wh <domain> <verb> --help` — verb flags and examples\n- `wh help --format json` — `CliSpecV2` (`schemaVersion: 2`): global/contextual/root tables and command overrides\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)\"   # caller id for chunk correlation\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# --stream-id identifies the submission but provides no receipt or resume.\n# After an outcome-unknown append, stop writes and reconcile attempted + unsent\n# work from a later verified checkpoint; never blindly replay revise/retract.\n```\n\n**Create collections:**\n```bash\nwh commit submit --type arc --name route --members Location/a,Location/b --repo org/repo\nwh assertion create --shape Supports --name route-support --about Arc/route --data '{\"confidence\":0.8}' --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- Wref `binding`: `identity` follows the Thing, `versioned` pins.\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 --dry-run --repo org/repo  # preview; remove --dry-run to submit\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 — Things\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|--file) [--shape]` — 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] [--expected-version]` — 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] [--role from|to|ends] [--limit] [--include-retracted]` — Show assertions about the target identity; `--resolve-collections` expands bare/@HEAD/@ALL members, `--role` filters direction; not pinned @vN\n\n- `wh view evaluate VIEW [--limit N] [--cursor TOK] [--all]`\n### commit — Write operations\n- `wh commit submit [--ops|--file|--add|--revise|--retract] [--dry-run] [--skip-existing]` — Submit operations, or evaluate the complete bounded input without durable changes under `--dry-run`. JSONL preview emits one operation row per input plus one summary.\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] [--expected-version]` — 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|--file)`\n- `wh shape create <name> (--fields|--file)`\n- `wh shape retract <name> -m <message> [--reason] [--expected-version]` — 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>` — Retire; name reserved\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` — help overview\n- `wh <domain>` — domain verbs\n- `wh <domain> <verb> --help` — verb flags and examples\n- `wh help --format json` — `CliSpecV2` (`schemaVersion: 2`): global/contextual/root tables and command overrides\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)\"   # caller id for chunk correlation\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# --stream-id identifies the submission but provides no receipt or resume.\n# After an outcome-unknown append, stop writes and reconcile attempted + unsent\n# work from a later verified checkpoint; never blindly replay revise/retract.\n```\n\n**Create collections:**\n```bash\nwh commit submit --add route --shape Arc --data '{\"from\":\"Location/a\",\"to\":\"Location/b\"}'\nwh assertion create --shape Supports --name route-support --about Arc/route --data '{\"confidence\":0.8}' --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(config2) {
@@ -68718,7 +68759,7 @@ function unknownCommandError(command, resolver) {
   return userInputError(`Unknown command: ${command}`, closest ? `Did you mean 'wh ${closest}'?` : "Run 'wh help' for available commands.");
 }
 function retirementError(entry) {
-  const resolved = resolveRenameHint(entry);
+  const resolved = typeof entry === "string" ? { message: entry } : entry;
   return new CliError(2 /* UserInput */, "USER_INPUT", resolved.message, undefined, resolved.hint);
 }
 function rootControlWithCommandError(control) {
@@ -69366,8 +69407,7 @@ var resolver = createInvocationResolver(productionRegistry.getDomains());
 var catalog = {
   globals: GLOBAL_FLAG_SPECS,
   contextualControls: CONTEXTUAL_CONTROL_SPECS,
-  rootControls: ROOT_CONTROL_SPECS,
-  renameHints: RENAME_HINTS
+  rootControls: ROOT_CONTROL_SPECS
 };
 function prepareCliInvocation(argv) {
   return prepare(argv, resolver, catalog);
@@ -69426,7 +69466,7 @@ function selectedRepo(flags, config2) {
   }
 }
 function isReservedCandidateName(name) {
-  return isBuiltinCliDomain(name) || getTopLevelRenameHintCommands().includes(name);
+  return isBuiltinCliDomain(name);
 }
 function basePorts(flags, config2) {
   return {
@@ -69768,7 +69808,7 @@ function resolveLogLevel(flagLevel, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.126.0",
+  version: "0.128.0",
   private: false,
   type: "module",
   description: "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -70393,5 +70433,5 @@ process.exitCode = interceptedExitCode === undefined ? await runPreparedCli(laun
   version: package_default3.version
 }) : interceptedExitCode;
 
-//# debugId=F59DA1C0179CC6A864756E2164756E21
-//# warmhub-cli-build-info {"cliVersion":"0.126.0","sdkVersion":"0.124.0"}
+//# debugId=815EE8EFA242BD9064756E2164756E21
+//# warmhub-cli-build-info {"cliVersion":"0.128.0","sdkVersion":"0.126.0"}

package/package.json

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