@warmhub/cli 0.84.3 → 0.85.0

package/dist/wh.js

@@ -4092,11 +4092,11 @@ var require_util2 = __commonJS((exports, module) => {
   var { isUint8Array } = __require("node:util/types");
   var { webidl } = require_webidl();
   var supportedHashes = [];
-  var crypto2;
+  var crypto;
   try {
-    crypto2 = __require("node:crypto");
+    crypto = __require("node:crypto");
     const possibleRelevantHashes = ["sha256", "sha384", "sha512"];
-    supportedHashes = crypto2.getHashes().filter((hash) => possibleRelevantHashes.includes(hash));
+    supportedHashes = crypto.getHashes().filter((hash) => possibleRelevantHashes.includes(hash));
   } catch {}
   function responseURL(response) {
     const urlList = response.urlList;
@@ -4355,7 +4355,7 @@ var require_util2 = __commonJS((exports, module) => {
     }
   }
   function bytesMatch(bytes, metadataList) {
-    if (crypto2 === undefined) {
+    if (crypto === undefined) {
       return true;
     }
     const parsedMetadata = parseMetadata(metadataList);
@@ -4370,7 +4370,7 @@ var require_util2 = __commonJS((exports, module) => {
     for (const item of metadata) {
       const algorithm = item.algo;
       const expectedValue = item.hash;
-      let actualValue = crypto2.createHash(algorithm).update(bytes).digest("base64");
+      let actualValue = crypto.createHash(algorithm).update(bytes).digest("base64");
       if (actualValue[actualValue.length - 1] === "=") {
         if (actualValue[actualValue.length - 2] === "=") {
           actualValue = actualValue.slice(0, -2);
@@ -5355,8 +5355,8 @@ var require_body = __commonJS((exports, module) => {
   var { multipartFormDataParser } = require_formdata_parser();
   var random;
   try {
-    const crypto2 = __require("node:crypto");
-    random = (max) => crypto2.randomInt(0, max);
+    const crypto = __require("node:crypto");
+    random = (max) => crypto.randomInt(0, max);
   } catch {
     random = (max) => Math.floor(Math.random(max));
   }
@@ -16107,13 +16107,13 @@ var require_util7 = __commonJS((exports, module) => {
 var require_frame = __commonJS((exports, module) => {
   var { maxUnsigned16Bit } = require_constants5();
   var BUFFER_SIZE = 16386;
-  var crypto2;
+  var crypto;
   var buffer = null;
   var bufIdx = BUFFER_SIZE;
   try {
-    crypto2 = __require("node:crypto");
+    crypto = __require("node:crypto");
   } catch {
-    crypto2 = {
+    crypto = {
       randomFillSync: function randomFillSync(buffer2, _offset, _size) {
         for (let i = 0;i < buffer2.length; ++i) {
           buffer2[i] = Math.random() * 255 | 0;
@@ -16125,7 +16125,7 @@ var require_frame = __commonJS((exports, module) => {
   function generateMask() {
     if (bufIdx === BUFFER_SIZE) {
       bufIdx = 0;
-      crypto2.randomFillSync(buffer ??= Buffer.allocUnsafe(BUFFER_SIZE), 0, BUFFER_SIZE);
+      crypto.randomFillSync(buffer ??= Buffer.allocUnsafe(BUFFER_SIZE), 0, BUFFER_SIZE);
     }
     return [buffer[bufIdx++], buffer[bufIdx++], buffer[bufIdx++], buffer[bufIdx++]];
   }
@@ -16193,9 +16193,9 @@ var require_connection = __commonJS((exports, module) => {
   var { Headers: Headers2, getHeadersList } = require_headers();
   var { getDecodeSplit } = require_util2();
   var { WebsocketFrameSend } = require_frame();
-  var crypto2;
+  var crypto;
   try {
-    crypto2 = __require("node:crypto");
+    crypto = __require("node:crypto");
   } catch {}
   function establishWebSocketConnection(url, protocols, client, ws, onEstablish, options) {
     const requestURL = url;
@@ -16214,7 +16214,7 @@ var require_connection = __commonJS((exports, module) => {
       const headersList = getHeadersList(new Headers2(options.headers));
       request.headersList = headersList;
     }
-    const keyValue = crypto2.randomBytes(16).toString("base64");
+    const keyValue = crypto.randomBytes(16).toString("base64");
     request.headersList.append("sec-websocket-key", keyValue);
     request.headersList.append("sec-websocket-version", "13");
     for (const protocol of protocols) {
@@ -16244,7 +16244,7 @@ var require_connection = __commonJS((exports, module) => {
           return;
         }
         const secWSAccept = response.headersList.get("Sec-WebSocket-Accept");
-        const digest2 = crypto2.createHash("sha1").update(keyValue + uid).digest("base64");
+        const digest2 = crypto.createHash("sha1").update(keyValue + uid).digest("base64");
         if (secWSAccept !== digest2) {
           failWebsocketConnection(ws, "Incorrect hash received in Sec-WebSocket-Accept header.");
           return;
@@ -19146,31 +19146,6 @@ var import_usingCtx = __toESM(require_usingCtx(), 1);
 var import_awaitAsyncGenerator = __toESM(require_awaitAsyncGenerator(), 1);
 var import_wrapAsyncGenerator = __toESM(require_wrapAsyncGenerator(), 1);
 var import_objectSpread29 = __toESM(require_objectSpread2(), 1);
-// ../../packages/rules/src/authority-coverage.ts
-var EMPTY_COVERAGE = Object.freeze({
-  include: Object.freeze([])
-});
-var FULL_REPO_COVERAGE = Object.freeze({
-  include: Object.freeze(["**"])
-});
-var EMPTY_COVERAGE_SET = Object.freeze([]);
-var FULL_REPO_COVERAGE_SET = Object.freeze([
-  Object.freeze([FULL_REPO_COVERAGE])
-]);
-// ../../packages/rules/src/stable-json.ts
-function stableJson(value) {
-  if (!value || typeof value !== "object") {
-    return JSON.stringify(value);
-  }
-  if (Array.isArray(value)) {
-    return `[${value.map((entry) => stableJson(entry)).join(",")}]`;
-  }
-  const record = value;
-  return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`).join(",")}}`;
-}
-function stableJsonEquals(left, right) {
-  return stableJson(left) === stableJson(right);
-}
 // ../../packages/rules/src/builtin-shapes.ts
 var BUILTIN_SHAPE_NAMES = [
   "Arc",
@@ -19399,6 +19374,21 @@ function resolveComponentTemplate(value, ctx) {
   });
 }
 
+// ../../packages/rules/src/stable-json.ts
+function stableJson(value) {
+  if (!value || typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map((entry) => stableJson(entry)).join(",")}]`;
+  }
+  const record = value;
+  return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`).join(",")}}`;
+}
+function stableJsonEquals(left, right) {
+  return stableJson(left) === stableJson(right);
+}
+
 // ../../packages/rules/src/org-activity-events.ts
 var ORG_MEMBER_ADDED_EVENT_TYPE = "org.member_added";
 var ORG_REPO_CREATED_EVENT_TYPE = "org.repo_created";
@@ -20410,7 +20400,304 @@ function joinFieldIdentityPath(...segments) {
 function joinFieldPathWithEscaper(escapeSegment, segments) {
   return segments.map((segment) => typeof segment === "number" ? `[${segment}]` : escapeSegment(segment)).join(".").replace(/\.\[/g, "[");
 }
+// ../../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+/;
+function hasAnyTokens(s) {
+  return ANY_TOKEN_RE.test(s);
+}
 
+// ../../packages/rules/src/preflight-commit.ts
+function preflightCommitDiagnostics(operations, options) {
+  const errors = [];
+  rejectCommitTokenSyntax(operations, errors, options);
+  illegalOpSequences(operations, errors, options?.checkAddAdd ?? true, options);
+  return errors;
+}
+function sourceOperationIndex(filteredIndex, options) {
+  return options?.sourceOperationIndexes?.[filteredIndex] ?? filteredIndex;
+}
+function getOpName(op) {
+  return op.name;
+}
+function tokenStringFields(op) {
+  const fields = [getOpName(op), op.newName];
+  if (typeof op.about === "string") {
+    fields.push(op.about);
+  }
+  if (op.members) {
+    fields.push(...op.members);
+  }
+  return fields;
+}
+function rejectCommitTokenSyntax(operations, errors, options) {
+  for (let i = 0;i < operations.length; i++) {
+    const op = operations[i];
+    if (!op)
+      continue;
+    for (const field of tokenStringFields(op)) {
+      if (field && hasAnyTokens(field)) {
+        errors.push({
+          code: "COMMIT_TOKEN_SYNTAX_REMOVED",
+          operationIndex: sourceOperationIndex(i, options),
+          message: COMMIT_TOKEN_SYNTAX_REMOVED_MESSAGE
+        });
+        break;
+      }
+    }
+  }
+}
+function illegalOpSequences(operations, errors, checkAddAdd, options) {
+  const opHistory = new Map;
+  for (let i = 0;i < operations.length; i++) {
+    const op = operations[i];
+    if (!op)
+      continue;
+    const name = getOpName(op);
+    if (!name)
+      continue;
+    if (hasAnyTokens(name))
+      continue;
+    const kind = inferOperationKind({ ...op, name });
+    const qualName = kind === "shape" ? `shape:${name}` : `thing:${name}`;
+    const history = opHistory.get(qualName) ?? [];
+    history.push({
+      operation: op.operation,
+      index: sourceOperationIndex(i, options)
+    });
+    opHistory.set(qualName, history);
+  }
+  for (const [qualName, history] of opHistory) {
+    if (history.length < 2)
+      continue;
+    for (let i = 1;i < history.length; i++) {
+      const prev = history[i - 1];
+      const curr = history[i];
+      if (!prev || !curr)
+        continue;
+      const pair = `${prev.operation}+${curr.operation}`;
+      if (checkAddAdd && pair === "add+add") {
+        errors.push({
+          code: "ILLEGAL_OP_SEQUENCE",
+          operationIndex: curr.index,
+          message: `Cannot add "${qualName}" twice in the same commit`
+        });
+      }
+      if (pair === "revise+add") {
+        errors.push({
+          code: "ILLEGAL_OP_SEQUENCE",
+          operationIndex: curr.index,
+          message: `Cannot revise then add "${qualName}" in the same commit`
+        });
+      }
+    }
+  }
+}
+
+// ../../packages/rules/src/preflight-operation.ts
+var collectionTypes = ["arc", "bond", "set", "list", "pair"];
+var canonicalCollectionTypes = ["arc", "bond", "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.';
+function preflightOpDiagnostics(op, operationIndex) {
+  const errors = [];
+  errors.push(...builtinShapeGuard(op, operationIndex));
+  errors.push(...contentNameGuard(op, operationIndex));
+  errors.push(...plusSignGuard(op, operationIndex));
+  errors.push(...validateCollectionAbouts(op, operationIndex));
+  errors.push(...validateCollectionOps(op, operationIndex));
+  return errors;
+}
+function builtinShapeGuard(op, operationIndex) {
+  const errors = [];
+  const name = op.name;
+  const isShapeRename = op.operation === "rename" && (op.kind === "shape" || op.name !== undefined && !splitLocalPath(op.name));
+  const reservedSourcePassThrough = isShapeRename && name !== undefined && isRenameableSquattedShape(name) && op.newName !== undefined && !isReservedCollectionShape(op.newName) && !isBuiltinShape(op.newName);
+  if (name && isRetiredCollectionShape(name) && !reservedSourcePassThrough) {
+    errors.push({
+      code: "RESERVED_NAME",
+      operationIndex,
+      message: `Shape "${name}" is a retired collection shape and cannot be written manually`
+    });
+  }
+  if (op.operation === "rename" && (op.kind === "shape" || op.name !== undefined && !splitLocalPath(op.name)) && op.newName && isRetiredCollectionShape(op.newName)) {
+    errors.push({
+      code: "RESERVED_NAME",
+      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;
+    if (builtinShapeName && (isShapeRename || op.operation !== "retract" && op.kind === "shape")) {
+      const action = op.operation === "add" ? "created" : op.operation === "rename" ? "renamed" : "revised";
+      errors.push({
+        code: "RESERVED_NAME",
+        operationIndex,
+        message: `Shape "${builtinShapeName}" is a built-in shape and cannot be ${action} manually`
+      });
+    }
+  }
+  if (name) {
+    const local = splitLocalPath(name);
+    if (local && isRetiredCollectionShape(local.shapePrefix)) {
+      errors.push({
+        code: "VALIDATION_ERROR",
+        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)) {
+      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",
+        operationIndex,
+        message
+      });
+    }
+  }
+  return errors;
+}
+function contentNameGuard(op, operationIndex) {
+  if (op.kind !== "thing" || !op.name)
+    return [];
+  const local = splitLocalPath(op.name);
+  if (!local || !isContentShape(local.shapePrefix))
+    return [];
+  const bareName = local.bareName;
+  if (isSynthesizedContentName(bareName)) {
+    return [
+      {
+        code: "READ_ONLY_BUILTIN_CONTENT",
+        operationIndex,
+        message: `${local.shapePrefix}/${bareName} is synthesized; writes are not allowed`
+      }
+    ];
+  }
+  if (!isStoredContentName(bareName)) {
+    return [
+      {
+        code: "UNKNOWN_CONTENT_NAME",
+        operationIndex,
+        message: `${local.shapePrefix}/${bareName} is not a recognized well-known content name`
+      }
+    ];
+  }
+  return [];
+}
+function plusSignGuard(op, operationIndex) {
+  const errors = [];
+  const name = op.name;
+  if (op.newName?.includes("+")) {
+    errors.push({
+      code: "VALIDATION_ERROR",
+      operationIndex,
+      message: `Name "${op.newName}" contains reserved character "+". The "+" character is reserved for the historical collection auto-name namespace and is not allowed in user-supplied names.`
+    });
+    return errors;
+  }
+  if (name?.includes("+")) {
+    if (op.kind === "collection" && op.operation === "add") {
+      errors.push({
+        code: "VALIDATION_ERROR",
+        operationIndex,
+        message: `Name "${name}" contains reserved character "+". The "+" character is reserved for the historical collection auto-name namespace and is not allowed in user-supplied names.`
+      });
+      return errors;
+    }
+    if (op.kind === "collection")
+      return errors;
+    const local = splitLocalPath(name);
+    if (local && isReservedCollectionShape(local.shapePrefix))
+      return errors;
+    errors.push({
+      code: "VALIDATION_ERROR",
+      operationIndex,
+      message: `Name "${name}" contains reserved character "+". The "+" character is reserved for the historical collection auto-name namespace and is not allowed in user-supplied names.`
+    });
+  }
+  return errors;
+}
+function validateCollectionAbouts(op, operationIndex) {
+  const errors = [];
+  if (!op.about || typeof op.about === "string")
+    return errors;
+  errors.push({
+    code: "VALIDATION_ERROR",
+    operationIndex,
+    message: COLLECTION_ABOUT_REMOVED_MESSAGE
+  });
+  return errors;
+}
+function validateCollectionOps(op, operationIndex) {
+  const errors = [];
+  if (op.kind !== "collection")
+    return errors;
+  if (!collectionOps.includes(op.operation)) {
+    return errors;
+  }
+  if (op.operation === "add" && !op.name) {
+    errors.push({
+      code: "VALIDATION_ERROR",
+      operationIndex,
+      message: COLLECTION_CREATE_REQUIRES_NAME_MESSAGE
+    });
+  }
+  if (!op.type || !collectionTypes.includes(op.type)) {
+    errors.push({
+      code: "VALIDATION_ERROR",
+      operationIndex,
+      message: `Collection "type" is invalid. Use one of: ${canonicalCollectionTypes.join(", ")}. Got: "${op.type ?? ""}"`
+    });
+  }
+  if (!op.members || !Array.isArray(op.members)) {
+    errors.push({
+      code: "VALIDATION_ERROR",
+      operationIndex,
+      message: 'Collection requires a "members" array'
+    });
+  } else {
+    for (let i = 0;i < op.members.length; i++) {
+      if (typeof op.members[i] !== "string") {
+        errors.push({
+          code: "VALIDATION_ERROR",
+          operationIndex,
+          message: `Collection member at index ${i} must be a string`
+        });
+      }
+    }
+  }
+  if (op.type && op.members) {
+    const arityError = collectionArityError(op.type, op.members);
+    if (arityError) {
+      errors.push({
+        code: "VALIDATION_ERROR",
+        operationIndex,
+        message: arityError
+      });
+    }
+  }
+  return errors;
+}
+function collectionArityError(tag, members) {
+  switch (tag) {
+    case "arc":
+      return members.length !== 2 ? `Arc requires exactly 2 members, got ${members.length}` : null;
+    case "bond":
+      return members.length !== 2 ? `Bond requires exactly 2 members, got ${members.length}` : null;
+    case "pair":
+      return members.length !== 2 ? `Pair requires exactly 2 members, got ${members.length}` : null;
+    case "set":
+    case "list":
+      return members.length < 1 ? `${tag === "set" ? "Set" : "List"} requires at least 1 member, got 0` : null;
+  }
+}
+// ../../packages/rules/src/preflight.ts
+function preflightOpDiagnostics2(op, operationIndex) {
+  return preflightOpDiagnostics(op, operationIndex);
+}
+function preflightCommitDiagnostics2(operations, options) {
+  return preflightCommitDiagnostics(operations, options);
+}
 // ../../packages/rules/src/shape-types.ts
 var BASE_PRIMITIVE_TYPES = [
   "number",
@@ -20608,6 +20895,14 @@ function displayFieldEntry(fieldType) {
     return { type, description };
   return type;
 }
+// ../../packages/rules/src/shape-field-key.ts
+function foldFieldName(name) {
+  const stripped = name.endsWith("?") ? name.slice(0, -1) : name;
+  return stripped.toLowerCase();
+}
+function foldFieldPath(path) {
+  return path.split(".").map((segment) => foldFieldName(segment)).join(".");
+}
 
 // ../../node_modules/.bun/re2js@2.8.3/node_modules/re2js/build/index.js
 /*!
@@ -27102,372 +27397,7 @@ function normalizeOptionalTypeSpec(spec) {
   }
   return { spec, optionalByType: false };
 }
-// ../../packages/rules/src/external-contract.ts
-var FORBIDDEN_EXTERNAL_FIELDS = new Set([
-  "_id",
-  "_creationTime",
-  "repoId",
-  "orgId",
-  "thingId",
-  "shapeThingId",
-  "aboutThingId",
-  "currentVersionId",
-  "createdInCommitId",
-  "validatedShapeVersionId"
-]);
-// ../../packages/rules/src/name-charset.ts
-var RESERVED_NAME_SEGMENT_CHARS = ["?", "#", "@", ":", "$"];
-function escapeForCharClass(char) {
-  return char.replace(/[\\\]^-]/g, "\\$&");
-}
-var RESERVED_CLASS_BODY = RESERVED_NAME_SEGMENT_CHARS.map(escapeForCharClass).join("");
-var NAME_SEGMENT_FORBIDDEN_RE = new RegExp(`[${RESERVED_CLASS_BODY}\\s]`);
-var PATH_SEGMENT_FORBIDDEN_RE = new RegExp(`[/${RESERVED_CLASS_BODY}\\s]`);
-// ../../packages/rules/src/permission-scopes.ts
-var PUBLIC_ORG_PERMISSIONS = new Set([
-  "org:read",
-  "components:read"
-]);
-// ../../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+/;
-function hasAnyTokens(s) {
-  return ANY_TOKEN_RE.test(s);
-}
-
-// ../../packages/rules/src/preflight-commit.ts
-function preflightCommitDiagnostics(operations, options) {
-  const errors = [];
-  rejectCommitTokenSyntax(operations, errors, options);
-  illegalOpSequences(operations, errors, options?.checkAddAdd ?? true, options);
-  return errors;
-}
-function sourceOperationIndex(filteredIndex, options) {
-  return options?.sourceOperationIndexes?.[filteredIndex] ?? filteredIndex;
-}
-function getOpName(op) {
-  return op.name;
-}
-function tokenStringFields(op) {
-  const fields = [getOpName(op), op.newName];
-  if (typeof op.about === "string") {
-    fields.push(op.about);
-  }
-  if (op.members) {
-    fields.push(...op.members);
-  }
-  return fields;
-}
-function rejectCommitTokenSyntax(operations, errors, options) {
-  for (let i = 0;i < operations.length; i++) {
-    const op = operations[i];
-    if (!op)
-      continue;
-    for (const field of tokenStringFields(op)) {
-      if (field && hasAnyTokens(field)) {
-        errors.push({
-          code: "COMMIT_TOKEN_SYNTAX_REMOVED",
-          operationIndex: sourceOperationIndex(i, options),
-          message: COMMIT_TOKEN_SYNTAX_REMOVED_MESSAGE
-        });
-        break;
-      }
-    }
-  }
-}
-function illegalOpSequences(operations, errors, checkAddAdd, options) {
-  const opHistory = new Map;
-  for (let i = 0;i < operations.length; i++) {
-    const op = operations[i];
-    if (!op)
-      continue;
-    const name = getOpName(op);
-    if (!name)
-      continue;
-    if (hasAnyTokens(name))
-      continue;
-    const kind = inferOperationKind({ ...op, name });
-    const qualName = kind === "shape" ? `shape:${name}` : `thing:${name}`;
-    const history = opHistory.get(qualName) ?? [];
-    history.push({
-      operation: op.operation,
-      index: sourceOperationIndex(i, options)
-    });
-    opHistory.set(qualName, history);
-  }
-  for (const [qualName, history] of opHistory) {
-    if (history.length < 2)
-      continue;
-    for (let i = 1;i < history.length; i++) {
-      const prev = history[i - 1];
-      const curr = history[i];
-      if (!prev || !curr)
-        continue;
-      const pair = `${prev.operation}+${curr.operation}`;
-      if (checkAddAdd && pair === "add+add") {
-        errors.push({
-          code: "ILLEGAL_OP_SEQUENCE",
-          operationIndex: curr.index,
-          message: `Cannot add "${qualName}" twice in the same commit`
-        });
-      }
-      if (pair === "revise+add") {
-        errors.push({
-          code: "ILLEGAL_OP_SEQUENCE",
-          operationIndex: curr.index,
-          message: `Cannot revise then add "${qualName}" in the same commit`
-        });
-      }
-    }
-  }
-}
 
-// ../../packages/rules/src/preflight-operation.ts
-var collectionTypes = ["arc", "bond", "set", "list", "pair"];
-var canonicalCollectionTypes = ["arc", "bond", "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.';
-function preflightOpDiagnostics(op, operationIndex) {
-  const errors = [];
-  errors.push(...builtinShapeGuard(op, operationIndex));
-  errors.push(...contentNameGuard(op, operationIndex));
-  errors.push(...plusSignGuard(op, operationIndex));
-  errors.push(...validateCollectionAbouts(op, operationIndex));
-  errors.push(...validateCollectionOps(op, operationIndex));
-  return errors;
-}
-function builtinShapeGuard(op, operationIndex) {
-  const errors = [];
-  const name = op.name;
-  const isShapeRename = op.operation === "rename" && (op.kind === "shape" || op.name !== undefined && !splitLocalPath(op.name));
-  const reservedSourcePassThrough = isShapeRename && name !== undefined && isRenameableSquattedShape(name) && op.newName !== undefined && !isReservedCollectionShape(op.newName) && !isBuiltinShape(op.newName);
-  if (name && isRetiredCollectionShape(name) && !reservedSourcePassThrough) {
-    errors.push({
-      code: "RESERVED_NAME",
-      operationIndex,
-      message: `Shape "${name}" is a retired collection shape and cannot be written manually`
-    });
-  }
-  if (op.operation === "rename" && (op.kind === "shape" || op.name !== undefined && !splitLocalPath(op.name)) && op.newName && isRetiredCollectionShape(op.newName)) {
-    errors.push({
-      code: "RESERVED_NAME",
-      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;
-    if (builtinShapeName && (isShapeRename || op.operation !== "retract" && op.kind === "shape")) {
-      const action = op.operation === "add" ? "created" : op.operation === "rename" ? "renamed" : "revised";
-      errors.push({
-        code: "RESERVED_NAME",
-        operationIndex,
-        message: `Shape "${builtinShapeName}" is a built-in shape and cannot be ${action} manually`
-      });
-    }
-  }
-  if (name) {
-    const local = splitLocalPath(name);
-    if (local && isRetiredCollectionShape(local.shapePrefix)) {
-      errors.push({
-        code: "VALIDATION_ERROR",
-        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)) {
-      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",
-        operationIndex,
-        message
-      });
-    }
-  }
-  return errors;
-}
-function contentNameGuard(op, operationIndex) {
-  if (op.kind !== "thing" || !op.name)
-    return [];
-  const local = splitLocalPath(op.name);
-  if (!local || !isContentShape(local.shapePrefix))
-    return [];
-  const bareName = local.bareName;
-  if (isSynthesizedContentName(bareName)) {
-    return [
-      {
-        code: "READ_ONLY_BUILTIN_CONTENT",
-        operationIndex,
-        message: `${local.shapePrefix}/${bareName} is synthesized; writes are not allowed`
-      }
-    ];
-  }
-  if (!isStoredContentName(bareName)) {
-    return [
-      {
-        code: "UNKNOWN_CONTENT_NAME",
-        operationIndex,
-        message: `${local.shapePrefix}/${bareName} is not a recognized well-known content name`
-      }
-    ];
-  }
-  return [];
-}
-function plusSignGuard(op, operationIndex) {
-  const errors = [];
-  const name = op.name;
-  if (op.newName?.includes("+")) {
-    errors.push({
-      code: "VALIDATION_ERROR",
-      operationIndex,
-      message: `Name "${op.newName}" contains reserved character "+". The "+" character is reserved for the historical collection auto-name namespace and is not allowed in user-supplied names.`
-    });
-    return errors;
-  }
-  if (name?.includes("+")) {
-    if (op.kind === "collection" && op.operation === "add") {
-      errors.push({
-        code: "VALIDATION_ERROR",
-        operationIndex,
-        message: `Name "${name}" contains reserved character "+". The "+" character is reserved for the historical collection auto-name namespace and is not allowed in user-supplied names.`
-      });
-      return errors;
-    }
-    if (op.kind === "collection")
-      return errors;
-    const local = splitLocalPath(name);
-    if (local && isReservedCollectionShape(local.shapePrefix))
-      return errors;
-    errors.push({
-      code: "VALIDATION_ERROR",
-      operationIndex,
-      message: `Name "${name}" contains reserved character "+". The "+" character is reserved for the historical collection auto-name namespace and is not allowed in user-supplied names.`
-    });
-  }
-  return errors;
-}
-function validateCollectionAbouts(op, operationIndex) {
-  const errors = [];
-  if (!op.about || typeof op.about === "string")
-    return errors;
-  errors.push({
-    code: "VALIDATION_ERROR",
-    operationIndex,
-    message: COLLECTION_ABOUT_REMOVED_MESSAGE
-  });
-  return errors;
-}
-function validateCollectionOps(op, operationIndex) {
-  const errors = [];
-  if (op.kind !== "collection")
-    return errors;
-  if (!collectionOps.includes(op.operation)) {
-    return errors;
-  }
-  if (op.operation === "add" && !op.name) {
-    errors.push({
-      code: "VALIDATION_ERROR",
-      operationIndex,
-      message: COLLECTION_CREATE_REQUIRES_NAME_MESSAGE
-    });
-  }
-  if (!op.type || !collectionTypes.includes(op.type)) {
-    errors.push({
-      code: "VALIDATION_ERROR",
-      operationIndex,
-      message: `Collection "type" is invalid. Use one of: ${canonicalCollectionTypes.join(", ")}. Got: "${op.type ?? ""}"`
-    });
-  }
-  if (!op.members || !Array.isArray(op.members)) {
-    errors.push({
-      code: "VALIDATION_ERROR",
-      operationIndex,
-      message: 'Collection requires a "members" array'
-    });
-  } else {
-    for (let i = 0;i < op.members.length; i++) {
-      if (typeof op.members[i] !== "string") {
-        errors.push({
-          code: "VALIDATION_ERROR",
-          operationIndex,
-          message: `Collection member at index ${i} must be a string`
-        });
-      }
-    }
-  }
-  if (op.type && op.members) {
-    const arityError = collectionArityError(op.type, op.members);
-    if (arityError) {
-      errors.push({
-        code: "VALIDATION_ERROR",
-        operationIndex,
-        message: arityError
-      });
-    }
-  }
-  return errors;
-}
-function collectionArityError(tag, members) {
-  switch (tag) {
-    case "arc":
-      return members.length !== 2 ? `Arc requires exactly 2 members, got ${members.length}` : null;
-    case "bond":
-      return members.length !== 2 ? `Bond requires exactly 2 members, got ${members.length}` : null;
-    case "pair":
-      return members.length !== 2 ? `Pair requires exactly 2 members, got ${members.length}` : null;
-    case "set":
-    case "list":
-      return members.length < 1 ? `${tag === "set" ? "Set" : "List"} requires at least 1 member, got 0` : null;
-  }
-}
-// ../../packages/rules/src/preflight.ts
-function preflightOpDiagnostics2(op, operationIndex) {
-  return preflightOpDiagnostics(op, operationIndex);
-}
-function preflightCommitDiagnostics2(operations, options) {
-  return preflightCommitDiagnostics(operations, options);
-}
-// ../../packages/rules/src/read-limits.ts
-var MAX_GET_MANY_WREFS = 500;
-// ../../packages/rules/src/reserved-orgs.ts
-var RESERVED_RAW_CONTENT_TOP_LEVEL_NAMES = [
-  "_app",
-  "_static",
-  "api",
-  "health",
-  "healthz",
-  "mcp",
-  "readyz",
-  "robots.txt",
-  "sse",
-  "trpc",
-  "version"
-];
-var RESERVED_ORG_NAMES = [
-  ...RESERVED_RAW_CONTENT_TOP_LEVEL_NAMES,
-  "admin",
-  "billing",
-  "blog",
-  "docs",
-  "help",
-  "login",
-  "public",
-  "settings",
-  "signup",
-  "status",
-  "support",
-  "system",
-  "warmhub",
-  "www"
-];
-var RESERVED_ORG_NAME_SET = new Set(RESERVED_ORG_NAMES);
-// ../../packages/rules/src/shape-field-key.ts
-function foldFieldName(name) {
-  const stripped = name.endsWith("?") ? name.slice(0, -1) : name;
-  return stripped.toLowerCase();
-}
-function foldFieldPath(path) {
-  return path.split(".").map((segment) => foldFieldName(segment)).join(".");
-}
 // ../../packages/rules/src/shape-validation-runtime.ts
 function validatePersistedStringFieldLimits(value, typeDef, errors, path) {
   const normalized = normalizeOptionalTypeSpec(typeDef).spec;
@@ -28550,7 +28480,7 @@ function dedupeDeprecationsByShape(results) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.82.3",
+  version: "0.83.0",
   private: false,
   type: "module",
   description: "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -28705,40 +28635,64 @@ function assertPaginatedCursorAdvanced(cursor, nextCursor, seenCursors) {
     throw new WarmHubError("VALIDATION_ERROR", "Paginated result cursor did not advance");
   }
 }
-async function* paginate(fetchPage, extractItems, initialCursor) {
+function assertIncrementalLowerBound(sinceRepoSeq) {
+  if (sinceRepoSeq === undefined) {
+    throw new WarmHubError("VALIDATION_ERROR", "sinceRepoSeq is required for an incremental read");
+  }
+}
+async function* paginatePages(fetchPage, initialCursor) {
   let cursor = initialCursor;
   const seenCursors = new Set;
   for (;; ) {
     if (cursor)
       seenCursors.add(cursor);
     const page = await fetchPage(cursor);
-    for (const item of extractItems(page)) {
-      yield item;
-    }
+    yield page;
     if (!page.nextCursor)
       return;
     assertPaginatedCursorAdvanced(cursor, page.nextCursor, seenCursors);
     cursor = page.nextCursor;
   }
 }
+async function* paginate(fetchPage, extractItems, initialCursor) {
+  for await (const page of paginatePages(fetchPage, initialCursor)) {
+    yield* extractItems(page);
+  }
+}
 async function collectPaginatedPages(fetchPage, extractItems, max, initialCursor) {
   if (max !== undefined && (!Number.isFinite(max) || Math.trunc(max) !== max || max < 0)) {
     throw new WarmHubError("VALIDATION_ERROR", "max must be a nonnegative integer");
   }
   const items = [];
-  let cursor = initialCursor;
+  for await (const page of paginatePages(fetchPage, initialCursor)) {
+    const pageItems = extractItems(page);
+    if (max !== undefined && items.length + pageItems.length > max) {
+      throw new WarmHubError("VALIDATION_ERROR", `Paginated result exceeded max=${max}`);
+    }
+    items.push(...pageItems);
+  }
+  return items;
+}
+function assertRepoExploreBrowseMode(opts) {
+  if (opts?.slugs !== undefined) {
+    throw new WarmHubError("VALIDATION_ERROR", "repo.explore pagination helpers do not support slugs mode");
+  }
+}
+async function collectIncrementalPages(fetchPage) {
+  const items = [];
+  let cursor;
   const seenCursors = new Set;
   for (;; ) {
     if (cursor)
       seenCursors.add(cursor);
     const page = await fetchPage(cursor);
-    const pageItems = extractItems(page);
-    if (max !== undefined && items.length + pageItems.length > max) {
-      throw new WarmHubError("VALIDATION_ERROR", `Paginated result exceeded max=${max}`);
+    items.push(...page.items);
+    if (!page.nextCursor) {
+      if (page.repoSeq === undefined) {
+        throw new WarmHubError("VALIDATION_ERROR", "Incremental read completed without repoSeq");
+      }
+      return { items, repoSeq: page.repoSeq };
     }
-    items.push(...pageItems);
-    if (!page.nextCursor)
-      return items;
     assertPaginatedCursorAdvanced(cursor, page.nextCursor, seenCursors);
     cursor = page.nextCursor;
   }
@@ -29141,6 +29095,13 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    listIter: (orgName, repoName, opts) => {
+      return paginate((cursor) => this.component.list(orgName, repoName, { ...opts, cursor }), (page) => page.items, opts?.cursor);
+    },
+    listAll: async (orgName, repoName, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages((cursor) => this.component.list(orgName, repoName, { ...pageOpts, cursor }), (page) => page.items, max, pageOpts.cursor);
+    },
     search: async (query, opts) => {
       try {
         return await this.trpc.component.search.query({
@@ -29152,6 +29113,13 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    searchIter: (query, opts) => {
+      return paginate((cursor) => this.component.search(query, { ...opts, cursor }), (page) => page.items, opts?.cursor);
+    },
+    searchAll: async (query, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages((cursor) => this.component.search(query, { ...pageOpts, cursor }), (page) => page.items, max, pageOpts.cursor);
+    },
     get: async (orgName, repoName, componentRef) => {
       try {
         return await this.trpc.component.get.query({
@@ -29531,6 +29499,13 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    listIter: (orgName, opts) => {
+      return paginate((cursor) => this.repo.list(orgName, { ...opts, cursor }), (page) => page.items, opts?.cursor);
+    },
+    listAll: async (orgName, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages((cursor) => this.repo.list(orgName, { ...pageOpts, cursor }), (page) => page.items, max, pageOpts.cursor);
+    },
     search: async (query, opts) => {
       try {
         return await this.trpc.repo.search.query({
@@ -29542,6 +29517,13 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    searchIter: (query, opts) => {
+      return paginate((cursor) => this.repo.search(query, { ...opts, cursor }), (page) => page.items, opts?.cursor);
+    },
+    searchAll: async (query, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages((cursor) => this.repo.search(query, { ...pageOpts, cursor }), (page) => page.items, max, pageOpts.cursor);
+    },
     create: async (orgName, repoName, description, visibility, displayName) => {
       try {
         return await this.trpc.repo.create.mutate({
@@ -29651,6 +29633,13 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    listPageIter: (orgName, opts) => {
+      return paginate((cursor) => this.repo.listPage(orgName, { ...opts, cursor }), (page) => page.items, opts?.cursor);
+    },
+    listPageAll: async (orgName, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages((cursor) => this.repo.listPage(orgName, { ...pageOpts, cursor }), (page) => page.items, max, pageOpts.cursor);
+    },
     listForCaller: async (opts) => {
       try {
         return await this.trpc.repo.listForCaller.query({
@@ -29678,6 +29667,15 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    exploreIter: (opts) => {
+      assertRepoExploreBrowseMode(opts);
+      return paginate((cursor) => this.repo.explore({ ...opts, cursor }), (page) => page.items, opts?.cursor);
+    },
+    exploreAll: async (opts) => {
+      assertRepoExploreBrowseMode(opts);
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages((cursor) => this.repo.explore({ ...pageOpts, cursor }), (page) => page.items, max, pageOpts.cursor);
+    },
     getReadme: async (orgName, repoName) => {
       try {
         return await this.trpc.repo.getReadme.query({
@@ -29866,6 +29864,13 @@ class WarmHubClient {
       } catch (error) {
         throw toWarmHubError(error);
       }
+    },
+    historyIter: (orgName, repoName, name, opts = {}) => {
+      return paginate((cursor) => this.shape.history(orgName, repoName, name, { ...opts, cursor }), (page) => page.versions, opts.cursor);
+    },
+    historyAll: async (orgName, repoName, name, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages((cursor) => this.shape.history(orgName, repoName, name, { ...pageOpts, cursor }), (page) => page.versions, max, pageOpts.cursor);
     }
   };
   subscription = {
@@ -30024,6 +30029,19 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    liveFeedIter: (orgName, repoName, subscriptionName, opts) => {
+      return paginate((cursor) => this.action.liveFeed(orgName, repoName, subscriptionName, {
+        ...opts,
+        cursor
+      }), (page) => page.items, opts?.cursor);
+    },
+    liveFeedAll: async (orgName, repoName, subscriptionName, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages((cursor) => this.action.liveFeed(orgName, repoName, subscriptionName, {
+        ...pageOpts,
+        cursor
+      }), (page) => page.items, max, pageOpts.cursor);
+    },
     listRuns: async (orgName, repoName, opts) => {
       try {
         return await this.trpc.action.listRuns.query({
@@ -30040,6 +30058,21 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    listRunsIter: (orgName, repoName, opts) => {
+      return paginate((cursor) => this.action.listRuns(orgName, repoName, {
+        ...opts,
+        since: cursor === undefined ? opts?.since : undefined,
+        cursor
+      }), (page) => page.items, opts?.cursor);
+    },
+    listRunsAll: async (orgName, repoName, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages((cursor) => this.action.listRuns(orgName, repoName, {
+        ...pageOpts,
+        since: cursor === undefined ? pageOpts.since : undefined,
+        cursor
+      }), (page) => page.items, max, pageOpts.cursor);
+    },
     latestRuns: async (orgName, repoName) => {
       try {
         return await this.trpc.action.latestRuns.query({ orgName, repoName });
@@ -30238,7 +30271,8 @@ class WarmHubClient {
           componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           excludeInfraShapes: opts?.excludeInfraShapes,
-          where: opts?.where
+          where: opts?.where,
+          sinceRepoSeq: opts?.sinceRepoSeq
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -30251,6 +30285,14 @@ class WarmHubClient {
       const { max, ...pageOpts } = opts ?? {};
       return await collectPaginatedPages((cursor) => this.thing.head(orgName, repoName, { ...pageOpts, cursor }), (page) => page.items, max, pageOpts.cursor);
     },
+    headChanges: async (orgName, repoName, opts) => {
+      assertIncrementalLowerBound(opts?.sinceRepoSeq);
+      return await collectIncrementalPages((cursor) => this.thing.head(orgName, repoName, {
+        ...opts,
+        includeRetracted: true,
+        cursor
+      }));
+    },
     get: async (orgName, repoName, wref, version, opts) => {
       try {
         return await this.trpc.thing.get.query({
@@ -30394,6 +30436,13 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    historyIter: (orgName, repoName, opts) => {
+      return paginate((cursor) => this.thing.history(orgName, repoName, { ...opts, cursor }), (page) => page.versions, opts.cursor);
+    },
+    historyAll: async (orgName, repoName, opts) => {
+      const { max, ...pageOpts } = opts;
+      return await collectPaginatedPages((cursor) => this.thing.history(orgName, repoName, { ...pageOpts, cursor }), (page) => page.versions, max, pageOpts.cursor);
+    },
     rename: async (orgName, repoName, shapeName, oldName, newName) => {
       try {
         return await this.trpc.thing.rename.mutate({
@@ -30463,7 +30512,8 @@ class WarmHubClient {
           componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           excludeInfraShapes: opts?.excludeInfraShapes,
-          where: opts?.where
+          where: opts?.where,
+          sinceRepoSeq: opts?.sinceRepoSeq
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -30476,6 +30526,14 @@ class WarmHubClient {
       const { max, ...pageOpts } = opts ?? {};
       return await collectPaginatedPages((cursor) => this.thing.query(orgName, repoName, { ...pageOpts, cursor }), (page) => page.items, max, pageOpts.cursor);
     },
+    queryChanges: async (orgName, repoName, opts) => {
+      assertIncrementalLowerBound(opts?.sinceRepoSeq);
+      return await collectIncrementalPages((cursor) => this.thing.query(orgName, repoName, {
+        ...opts,
+        includeRetracted: true,
+        cursor
+      }));
+    },
     search: async (orgName, repoName, query, opts) => {
       try {
         const kind = opts?.kind === "shape" || opts?.kind === "thing" || opts?.kind === "assertion" || opts?.kind === "collection" ? opts.kind : undefined;
@@ -30501,6 +30559,16 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    searchIter: (orgName, repoName, query, opts) => {
+      return paginate((cursor) => this.thing.search(orgName, repoName, query, { ...opts, cursor }), (page) => page.items, opts?.cursor);
+    },
+    searchAll: async (orgName, repoName, query, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages((cursor) => this.thing.search(orgName, repoName, query, {
+        ...pageOpts,
+        cursor
+      }), (page) => page.items, max, pageOpts.cursor);
+    },
     count: async (orgName, repoName, opts) => {
       try {
         const kind = opts?.kind === "shape" || opts?.kind === "thing" || opts?.kind === "assertion" || opts?.kind === "collection" ? opts.kind : undefined;
@@ -30516,7 +30584,8 @@ class WarmHubClient {
           componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           excludeInfraShapes: opts?.excludeInfraShapes,
-          where: opts?.where
+          where: opts?.where,
+          sinceRepoSeq: opts?.sinceRepoSeq
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -31044,6 +31113,7 @@ var _orgActivityNeedsNoFilter = ["org.member_added", "org.repo_created", "org.re
 }));
 
 // ../../packages/warmhub-cli/src/errors-classification.ts
+var INCREMENTAL_READ_UNAVAILABLE_GUIDANCE = "Retry the same incremental request after incremental reads are enabled, or simplify the query to a supported form. Do not fall back to a full read.";
 function unauthenticatedHint(message) {
   if (message.includes("Authentication required")) {
     return "Not logged in. Run `wh auth login` to authenticate.";
@@ -31070,6 +31140,8 @@ function classifyConflict(message, code) {
       return "pending-delete";
     case "LEASE_UNAVAILABLE":
       return "lease-held";
+    case "INCREMENTAL_READ_UNAVAILABLE":
+      return "incremental-read-unavailable";
     default:
       break;
   }
@@ -31103,6 +31175,8 @@ function conflictHint(message, code) {
       return "Repo is being deleted. Wait for the delete to finish or cancel it before retrying.";
     case "lease-held":
       return "This thing is leased by another holder. Back off until the lease expires (see leaseExpiresAt / retryAfter), then retry.";
+    case "incremental-read-unavailable":
+      return INCREMENTAL_READ_UNAVAILABLE_GUIDANCE;
     case "other":
       return "Resolve the conflicting existing state and try again.";
   }
@@ -31130,7 +31204,8 @@ var CONFLICT_SHAPED_CODES = new Set([
   "HAS_INBOUND_REFS",
   "REPO_PENDING_DELETE",
   "ALREADY_RETRACTED",
-  "LEASE_UNAVAILABLE"
+  "LEASE_UNAVAILABLE",
+  "INCREMENTAL_READ_UNAVAILABLE"
 ]);
 
 // ../../packages/warmhub-cli/src/errors-types.ts
@@ -31274,6 +31349,11 @@ function generateSuggestions(code, message, context, errorCode) {
           action: "Another holder leased this thing. Back off until the lease expires (leaseExpiresAt / retryAfter), then retry"
         });
         break;
+      case "incremental-read-unavailable":
+        suggestions.push({
+          action: INCREMENTAL_READ_UNAVAILABLE_GUIDANCE
+        });
+        break;
       case "other":
         suggestions.push({
           action: "Resolve the conflicting existing state and retry"
@@ -36842,6 +36922,9 @@ async function fetchAllSearchPages(ctx, org, repo, queryText, opts) {
 // ../../packages/warmhub-cli/src/domains/thing/view.ts
 import { readFileSync as readFileSync7 } from "node:fs";
 
+// ../../packages/rules/src/read-limits.ts
+var MAX_GET_MANY_WREFS2 = 500;
+
 // ../../packages/warmhub-cli/src/io.ts
 function isBrokenPipe(error) {
   return error instanceof Error && "code" in error && error.code === "EPIPE";
@@ -37078,8 +37161,8 @@ var handleView = async (ctx, { flags, args, terminator }) => {
   if (wrefs.length === 0) {
     throw new CliError(2 /* UserInput */, "USER_INPUT", "Missing required <wref>. Pass a wref as a positional arg, via --file <path>, or pipe newline-delimited wrefs on stdin.", undefined, "Example: wh thing view Game/base --depth 2");
   }
-  if (wrefs.length > MAX_GET_MANY_WREFS) {
-    throw new CliError(2 /* UserInput */, "USER_INPUT", `Too many wrefs: ${wrefs.length} (max ${MAX_GET_MANY_WREFS} per call).`, undefined, `Split your input into chunks of ${MAX_GET_MANY_WREFS} or fewer.`);
+  if (wrefs.length > MAX_GET_MANY_WREFS2) {
+    throw new CliError(2 /* UserInput */, "USER_INPUT", `Too many wrefs: ${wrefs.length} (max ${MAX_GET_MANY_WREFS2} per call).`, undefined, `Split your input into chunks of ${MAX_GET_MANY_WREFS2} or fewer.`);
   }
   const isBatch = wrefs.length > 1 || flags.file !== undefined;
   if (isBatch && flags.depth !== undefined) {
@@ -49120,7 +49203,7 @@ function resolveLogLevel(flagLevel, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.84.3",
+  version: "0.85.0",
   private: false,
   type: "module",
   description: "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -49737,5 +49820,5 @@ process.exitCode = interceptedExitCode === undefined ? await runPreparedCli(laun
   version: package_default3.version
 }) : interceptedExitCode;
 
-//# debugId=5B259BBB96D29C3364756E2164756E21
-//# warmhub-cli-build-info {"cliVersion":"0.84.3","sdkVersion":"0.82.3"}
+//# debugId=F50B28EECDCA074C64756E2164756E21
+//# warmhub-cli-build-info {"cliVersion":"0.85.0","sdkVersion":"0.83.0"}

package/package.json

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