@warmhub/cli 0.44.0 → 0.45.0

package/dist/wh.js

@@ -19358,7 +19358,7 @@ function findSystemComponent(componentId) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.43.0",
+  version: "0.44.1",
   private: false,
   type: "module",
   homepage: "https://docs.warmhub.ai",
@@ -19852,13 +19852,15 @@ class WarmHubError extends Error {
   status;
   hint;
   retryAfter;
-  constructor(code, message, status, hint, retryAfter) {
+  backendCode;
+  constructor(code, message, status, hint, retryAfter, backendCode) {
     super(message);
     this.name = "WarmHubError";
     this.code = code;
     this.status = status;
     this.hint = hint;
     this.retryAfter = retryAfter;
+    this.backendCode = backendCode;
   }
   get kind() {
     return this.code;
@@ -19881,13 +19883,14 @@ function toWarmHubError(error) {
       return error.cause;
     }
     const data = error.data;
+    const wireCode = data?.warmhub?.code;
     const message = data?.warmhub?.message ?? sanitizeErrorMessage(error.message);
-    return new WarmHubError(data?.warmhub?.code ?? "BACKEND", message, data?.warmhub?.status, data?.warmhub?.hint, data?.warmhub?.retryAfter);
+    return new WarmHubError(wireCode ?? "BACKEND", message, data?.warmhub?.status, data?.warmhub?.hint, data?.warmhub?.retryAfter, wireCode);
   }
   if (error instanceof Error) {
     const warmhubLike = error;
     if (error.name === "WarmHubError" && typeof warmhubLike.code === "string") {
-      return new WarmHubError(warmhubLike.code, sanitizeErrorMessage(error.message), typeof warmhubLike.status === "number" ? warmhubLike.status : undefined, typeof warmhubLike.hint === "string" ? warmhubLike.hint : undefined, typeof warmhubLike.retryAfter === "number" ? warmhubLike.retryAfter : undefined);
+      return new WarmHubError(warmhubLike.code, sanitizeErrorMessage(error.message), typeof warmhubLike.status === "number" ? warmhubLike.status : undefined, typeof warmhubLike.hint === "string" ? warmhubLike.hint : undefined, typeof warmhubLike.retryAfter === "number" ? warmhubLike.retryAfter : undefined, typeof warmhubLike.backendCode === "string" ? warmhubLike.backendCode : undefined);
     }
     if (error.name === "AbortError") {
       return new WarmHubError("CANCELLED", error.message);
@@ -20547,6 +20550,18 @@ class WarmHubClient {
       } catch (error) {
         throw toWarmHubError(error);
       }
+    },
+    index: {
+      describe: async (orgName, repoName) => {
+        try {
+          return await this.trpc.repo.index.describe.query({
+            orgName,
+            repoName
+          });
+        } catch (error) {
+          throw toWarmHubError(error);
+        }
+      }
     }
   };
   shape = {
@@ -20869,7 +20884,8 @@ class WarmHubClient {
           cursor: opts?.cursor,
           componentId: opts?.componentId,
           excludeComponents: opts?.excludeComponents,
-          excludeInfraShapes: opts?.excludeInfraShapes
+          excludeInfraShapes: opts?.excludeInfraShapes,
+          where: opts?.where
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -21002,7 +21018,8 @@ class WarmHubClient {
           depth: opts?.depth,
           resolveCollections: opts?.resolveCollections,
           limit: opts?.limit,
-          cursor: opts?.cursor
+          cursor: opts?.cursor,
+          where: opts?.where
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -21031,7 +21048,8 @@ class WarmHubClient {
           cursor: opts?.cursor,
           componentId: opts?.componentId,
           excludeComponents: opts?.excludeComponents,
-          excludeInfraShapes: opts?.excludeInfraShapes
+          excludeInfraShapes: opts?.excludeInfraShapes,
+          where: opts?.where
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -21082,7 +21100,8 @@ class WarmHubClient {
           resolveCollections: opts?.resolveCollections,
           componentId: opts?.componentId,
           excludeComponents: opts?.excludeComponents,
-          excludeInfraShapes: opts?.excludeInfraShapes
+          excludeInfraShapes: opts?.excludeInfraShapes,
+          where: opts?.where
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -21120,7 +21139,8 @@ class WarmHubClient {
         dataMode: opts?.dataMode,
         limit: opts?.limit,
         cursor: opts?.cursor,
-        includeRetracted: opts?.includeRetracted
+        includeRetracted: opts?.includeRetracted,
+        where: opts?.where
       }), onUpdate);
     },
     thingHistory: async (orgName, repoName, opts, onUpdate) => {
@@ -21457,6 +21477,7 @@ class WarmHubClient {
     if (!response.ok) {
       let message = `Request failed with status ${response.status}`;
       let code = httpStatusToWarmHubCode(response.status);
+      let backendCode;
       let hint;
       let retryAfter;
       try {
@@ -21466,6 +21487,7 @@ class WarmHubClient {
         }
         if (typeof body.error?.code === "string") {
           code = body.error.code;
+          backendCode = body.error.code;
         }
         if (typeof body.error?.hint === "string") {
           hint = body.error.hint;
@@ -21474,7 +21496,7 @@ class WarmHubClient {
           retryAfter = body.error.retryAfter;
         }
       } catch {}
-      throw new WarmHubError(code, message, response.status, hint, retryAfter);
+      throw new WarmHubError(code, message, response.status, hint, retryAfter, backendCode);
     }
     return response;
   }
@@ -21592,13 +21614,15 @@ class CliError extends Error {
   kind;
   cause;
   hint;
+  backendCode;
   context;
-  constructor(code, kind, message, cause, hint, context) {
+  constructor(code, kind, message, cause, hint, context, backendCode) {
     super(message);
     this.code = code;
     this.kind = kind;
     this.cause = cause;
     this.hint = hint;
+    this.backendCode = backendCode;
     this.context = context;
   }
 }
@@ -21624,24 +21648,33 @@ function conflictHint(message) {
   }
   return "Resolve the conflicting existing state and try again.";
 }
+function isFieldIndexErrorCode(code) {
+  return code === "FIELD_INDEX_UNAVAILABLE" || code === "FIELD_NOT_INDEXABLE" || code === "FIELD_TYPE_AMBIGUOUS";
+}
+function fromWh(exit, kind, err, hint = err.hint) {
+  return new CliError(exit, kind, err.message, err, hint, undefined, err.backendCode);
+}
 function toCliError(err) {
   if (err instanceof CliError)
     return err;
   if (err instanceof WarmHubError) {
     if (err.kind === "VALIDATION_ERROR" || err.kind === "SHAPE_MISMATCH" || err.kind === "NOT_FOUND") {
-      return new CliError(2 /* UserInput */, "USER_INPUT", err.message, err, err.hint);
+      return fromWh(2 /* UserInput */, "USER_INPUT", err);
     }
     if (err.kind === "UNAUTHENTICATED" || err.kind === "FORBIDDEN") {
-      const hint = err.hint ?? unauthenticatedHint(err.message);
-      return new CliError(3 /* Config */, "AUTH", err.message, err, hint);
+      return fromWh(3 /* Config */, "AUTH", err, err.hint ?? unauthenticatedHint(err.message));
+    }
+    if (isFieldIndexErrorCode(err.code)) {
+      const exit = err.code === "FIELD_NOT_INDEXABLE" ? 2 /* UserInput */ : 4 /* Backend */;
+      return fromWh(exit, err.code, err);
     }
     if ((err.code === "CONFLICT" || err.code === "ARCHIVED") && err.status === undefined) {
-      return new CliError(2 /* UserInput */, "CONFLICT", err.message, err, err.hint ?? conflictHint(err.message));
+      return fromWh(2 /* UserInput */, "CONFLICT", err, err.hint ?? conflictHint(err.message));
     }
     if (err.status) {
-      return new CliError(4 /* Backend */, "BACKEND", err.message, err, err.hint);
+      return fromWh(4 /* Backend */, "BACKEND", err);
     }
-    return new CliError(4 /* Backend */, "BACKEND", err.message, err, err.hint ?? "Check that the API URL and backend are reachable.");
+    return fromWh(4 /* Backend */, "BACKEND", err, err.hint ?? "Check that the API URL and backend are reachable.");
   }
   if (err instanceof TypeError && err.message.includes("fetch")) {
     return new CliError(4 /* Backend */, "BACKEND", "Network error connecting to backend", err, "Check WARMHUB_API_URL or --api-url.");
@@ -21738,6 +21771,30 @@ function generateSuggestions(code, message, context) {
       });
     }
   }
+  if (code === "FIELD_NOT_INDEXABLE") {
+    suggestions.push({
+      action: "Inspect indexed field state for the repo",
+      command: "wh repo describe --indexed-fields"
+    });
+    suggestions.push({
+      action: "Use a shape-declared, indexable scalar field in --where"
+    });
+  }
+  if (code === "FIELD_INDEX_UNAVAILABLE") {
+    suggestions.push({
+      action: "Retry after the field index finishes building"
+    });
+    suggestions.push({
+      action: "Inspect indexed field state for the repo",
+      command: "wh repo describe --indexed-fields"
+    });
+  }
+  if (code === "FIELD_TYPE_AMBIGUOUS") {
+    suggestions.push({
+      action: "Inspect indexed field state for heterogeneous field types",
+      command: "wh repo describe --indexed-fields"
+    });
+  }
   if (code === "AUTH") {
     suggestions.push({
       action: "Re-authenticate",
@@ -21771,6 +21828,11 @@ function shouldLogToErrorTier(err) {
     case "AUTH":
     case "UNKNOWN":
       return true;
+    case "FIELD_NOT_INDEXABLE":
+      return false;
+    case "FIELD_INDEX_UNAVAILABLE":
+    case "FIELD_TYPE_AMBIGUOUS":
+      return true;
     case "BACKEND": {
       const status = err.cause?.status;
       if (typeof status === "number" && status >= 400 && status < 500) {
@@ -21787,7 +21849,7 @@ function cliErrorFromOpFailure(failure) {
   const message = failure.error?.message ?? `Operation on "${failure.name}" failed`;
   const exit = code === "FORBIDDEN" || code === "UNAUTHENTICATED" ? 5 /* Auth */ : code === "VALIDATION_ERROR" || code === "SHAPE_MISMATCH" || code === "NOT_FOUND" || code === "KIND_MISMATCH" || code === "ALREADY_RETRACTED" || code === "CONFLICT" ? 2 /* UserInput */ : 4 /* Backend */;
   const kind = exit === 5 /* Auth */ ? "AUTH" : exit === 2 /* UserInput */ ? code === "CONFLICT" ? "CONFLICT" : "USER_INPUT" : "BACKEND";
-  return new CliError(exit, kind, message);
+  return new CliError(exit, kind, message, undefined, undefined, undefined, failure.error?.code);
 }
 function cliErrorFromAllFailed(failures) {
   const exitPriority = (failure) => {
@@ -21826,6 +21888,7 @@ function printCliError(err, errWriter, opts = {}) {
     const envelope = {
       error: {
         code: err.kind,
+        ...err.backendCode ? { backendCode: err.backendCode } : {},
         message: err.message,
         ...err.hint ? { hint: err.hint } : {},
         ...suggestions.length > 0 ? { suggestions } : {},
@@ -24533,10 +24596,64 @@ async function readContentInput(filePath, inline, stdinStream) {
 function usageError(usage, example) {
   throw new CliError(2 /* UserInput */, "USER_INPUT", usage, undefined, `Example: ${example}`);
 }
+var WHERE_USAGE_HINT = 'Example: --where state=NC --where "employees>=100" --where "state?"';
+function requireWhereFieldPath(raw, fieldPath) {
+  const normalized = fieldPath.trim();
+  if (!normalized) {
+    throw new CliError(2 /* UserInput */, "USER_INPUT", `Malformed --where predicate: "${raw}". Field path cannot be empty.`, undefined, WHERE_USAGE_HINT);
+  }
+  return normalized;
+}
+function parseWhereFlag(raw) {
+  const opMatch = raw.match(/^(.+?)\s*(>=|<=|!=|=|>|<)\s*(.*)$/);
+  if (opMatch) {
+    const fieldPath = requireWhereFieldPath(raw, opMatch[1]);
+    const opStr = opMatch[2];
+    const rhsStr = (opMatch[3] ?? "").trim();
+    const op = opStr === "=" ? "eq" : opStr === "!=" ? "ne" : opStr === ">=" ? "gte" : opStr === "<=" ? "lte" : opStr === ">" ? "gt" : "lt";
+    const rhs = coerceValue(rhsStr);
+    return { fieldPath, op, rhs };
+  }
+  const inMatch = raw.match(/^(.+?)\s+in:\[(.*)?\]$/);
+  if (inMatch) {
+    const fieldPath = requireWhereFieldPath(raw, inMatch[1]);
+    const valueStr = inMatch[2] ?? "";
+    if (valueStr.trim() === "") {
+      throw new CliError(2 /* UserInput */, "USER_INPUT", `Invalid --where "${raw}": in:[] requires at least one value`, undefined, 'Example: --where "state in:[NC,VA]"');
+    }
+    const rhs = valueStr.split(",").map((v) => coerceValue(v.trim()));
+    if (rhs.length > MAX_WHERE_IN_VALUES) {
+      throw new CliError(2 /* UserInput */, "USER_INPUT", `Invalid --where "${raw}": in:[...] supports at most ${MAX_WHERE_IN_VALUES} values`, undefined, `Split the query into smaller batches of at most ${MAX_WHERE_IN_VALUES} values.`);
+    }
+    return { fieldPath, op: "in", rhs };
+  }
+  const prefixMatch = raw.match(/^(.+?)~(.+)$/);
+  if (prefixMatch) {
+    const fieldPath = requireWhereFieldPath(raw, prefixMatch[1]);
+    const rhs = coerceValue(prefixMatch[2].replace(/\*$/, ""));
+    return { fieldPath, op: "prefix", rhs };
+  }
+  if (raw.endsWith("?")) {
+    const fieldPath = requireWhereFieldPath(raw, raw.slice(0, -1));
+    return { fieldPath, op: "exists" };
+  }
+  throw new CliError(2 /* UserInput */, "USER_INPUT", `Malformed --where predicate: "${raw}". Supported operators: =, !=, >, >=, <, <=, ~, in:[...], ?`, undefined, WHERE_USAGE_HINT);
+}
+function coerceValue(s) {
+  if (s.startsWith('"') && s.endsWith('"') || s.startsWith("'") && s.endsWith("'")) {
+    return s.slice(1, -1);
+  }
+  if (s === "true")
+    return true;
+  if (s === "false")
+    return false;
+  return s;
+}
 var DEFAULT_PAGE_LIMIT = 50;
 var DEFAULT_SEARCH_LIMIT = 25;
 var MAX_PAGE_LIMIT = 500;
 var AUTO_PAGE_LIMIT = MAX_PAGE_LIMIT;
+var MAX_WHERE_IN_VALUES = 1000;
 async function handleCount(ctx, org, repo, opts) {
   const result = await ctx.client.thing.count(org, repo, opts);
   writeOutput(ctx, result, () => ctx.out(`${result.count}`));
@@ -24778,6 +24895,10 @@ var headFlags = {
   }),
   "exclude-components": flag.boolean({
     description: "Exclude component-owned things from results"
+  }),
+  where: flag.string({
+    multiple: true,
+    description: `Field-value WHERE predicate (repeatable). Syntax: field=val, field>=val, field~prefix*, field in:[a,b] (max ${MAX_WHERE_IN_VALUES} values), field? (exists). Predicates are served by the typed field index; unservable fields return a machine-readable field-index error instead of scanning JSONB bodies.`
   })
 };
 var handleHead = async (ctx, { flags, args }) => {
@@ -24790,6 +24911,8 @@ var handleHead = async (ctx, { flags, args }) => {
   const match = flags.match;
   const count = flags.count;
   const includeRetracted = flags["include-retracted"];
+  const whereRaw = flags.where ?? [];
+  const where = whereRaw.map(parseWhereFlag);
   if (count) {
     if (cursor || all || limit || ctx.liveMode) {
       usageError("Usage: wh thing list --count [--shape SHAPE] [--kind KIND] [--match PATTERN]", "wh thing list --shape Player --count");
@@ -24804,7 +24927,8 @@ var handleHead = async (ctx, { flags, args }) => {
       includeRetracted,
       componentId: componentId2,
       excludeComponents: strictExclude2,
-      excludeInfraShapes: !strictExclude2 && !shape
+      excludeInfraShapes: !strictExclude2 && !shape,
+      where: where.length > 0 ? where : undefined
     });
   }
   if (cursor && !limit) {
@@ -24830,7 +24954,8 @@ var handleHead = async (ctx, { flags, args }) => {
     cursor,
     componentId,
     excludeComponents,
-    excludeInfraShapes
+    excludeInfraShapes,
+    where: where.length > 0 ? where : undefined
   };
   if (ctx.liveMode) {
     await runLive({
@@ -24860,7 +24985,8 @@ var handleHead = async (ctx, { flags, args }) => {
     cursor,
     componentId,
     excludeComponents,
-    excludeInfraShapes
+    excludeInfraShapes,
+    where: where.length > 0 ? where : undefined
   }) : await ctx.client.thing.head(org, repo, {
     shape,
     kind,
@@ -24870,7 +24996,8 @@ var handleHead = async (ctx, { flags, args }) => {
     cursor,
     componentId,
     excludeComponents,
-    excludeInfraShapes
+    excludeInfraShapes,
+    where: where.length > 0 ? where : undefined
   });
   writeOutput(ctx, result, () => renderHead(ctx.out, ctx.colors, ctx.chars, result, org, repo, shape, kind));
 };
@@ -24887,7 +25014,8 @@ async function fetchAllHeadPages(ctx, org, repo, opts) {
       cursor,
       componentId: opts.componentId,
       excludeComponents: opts.excludeComponents,
-      excludeInfraShapes: opts.excludeInfraShapes
+      excludeInfraShapes: opts.excludeInfraShapes,
+      where: opts.where
     });
     items.push(...page.items ?? []);
     if (!page.nextCursor)
@@ -25333,6 +25461,10 @@ var queryFlags = {
   }),
   "exclude-components": flag.boolean({
     description: "Exclude component-owned things from results"
+  }),
+  where: flag.string({
+    multiple: true,
+    description: `Field-value WHERE predicate (repeatable). Syntax: field=val, field>=val, field~prefix*, field in:[a,b] (max ${MAX_WHERE_IN_VALUES} values), field? (exists). Predicates are served by the typed field index; unservable fields return a machine-readable field-index error instead of scanning JSONB bodies.`
   })
 };
 var handleQuery = async (ctx, { flags }) => {
@@ -25354,6 +25486,8 @@ var handleQuery = async (ctx, { flags }) => {
   const excludeComponents = strictExclude;
   const excludeInfraShapes = !strictExclude && !hasShape;
   const c = ctx.colors;
+  const whereRaw = flags.where ?? [];
+  const where = whereRaw.map(parseWhereFlag);
   if (count) {
     if (cursor || all || limit || ctx.liveMode) {
       usageError("Usage: wh thing query --count [--shape SHAPE] [--about WREF] [--kind KIND] [--match PATTERN]", "wh thing query --kind assertion --about Player/alice --count");
@@ -25367,7 +25501,8 @@ var handleQuery = async (ctx, { flags }) => {
       resolveCollections,
       componentId,
       excludeComponents,
-      excludeInfraShapes
+      excludeInfraShapes,
+      where: where.length > 0 ? where : undefined
     });
   }
   if (cursor && !limit) {
@@ -25389,7 +25524,8 @@ var handleQuery = async (ctx, { flags }) => {
     cursor,
     componentId,
     excludeComponents,
-    excludeInfraShapes
+    excludeInfraShapes,
+    where: where.length > 0 ? where : undefined
   };
   if (ctx.liveMode) {
     await runLive({
@@ -25421,7 +25557,8 @@ var handleQuery = async (ctx, { flags }) => {
     cursor,
     componentId,
     excludeComponents,
-    excludeInfraShapes
+    excludeInfraShapes,
+    where: where.length > 0 ? where : undefined
   }) : await ctx.client.thing.query(org, repo, {
     shape,
     about,
@@ -25433,7 +25570,8 @@ var handleQuery = async (ctx, { flags }) => {
     cursor,
     componentId,
     excludeComponents,
-    excludeInfraShapes
+    excludeInfraShapes,
+    where: where.length > 0 ? where : undefined
   });
   writeOutput(ctx, result, () => renderQueryResults(ctx.out, c, result));
 };
@@ -25452,7 +25590,8 @@ async function fetchAllQueryPages(ctx, org, repo, opts) {
       cursor,
       componentId: opts.componentId,
       excludeComponents: opts.excludeComponents,
-      excludeInfraShapes: opts.excludeInfraShapes
+      excludeInfraShapes: opts.excludeInfraShapes,
+      where: opts.where
     });
     items.push(...page.items ?? []);
     if (!page.nextCursor)
@@ -33437,20 +33576,36 @@ var handleUpdate3 = async (ctx, { args, flags }) => {
     ctx.out(`${c.green}Updated${c.reset} ${c.cyan}${orgName}/${repoName}${c.reset} description`);
   });
 };
-var handleDescribe = async (ctx, { args }) => {
+var describeFlags = {
+  "indexed-fields": flag.boolean({
+    description: "Show typed field index state (building, ready, failed) for each shape"
+  })
+};
+var handleDescribe = async (ctx, { args, flags }) => {
   const repoRef = args[0];
   const { org, repo } = parseOrgRepo(repoRef, ctx.config);
   const c = ctx.colors;
-  const [repoInfo, shapesPage, stats] = await Promise.all([
+  const showIndexedFields = flags["indexed-fields"] === true;
+  const [repoInfo, shapesPage, stats, indexedFields] = await Promise.all([
     ctx.client.repo.get(org, repo),
     ctx.client.shape.list(org, repo),
-    ctx.client.repo.getStats(org, repo)
+    ctx.client.repo.getStats(org, repo),
+    showIndexedFields ? ctx.client.repo.index.describe(org, repo) : null
   ]);
   const shapes = shapesPage.items;
   const byShape = Object.fromEntries([
     ...shapes.map((shape) => shape.name).filter((name) => typeof name === "string").map((name) => [name, 0]),
     ...Object.entries(stats.byShape)
   ]);
+  function stripShapeThingId(bucket) {
+    return bucket.map(({ shapeThingId: _omit, ...rest }) => rest);
+  }
+  const indexedFieldsPublic = indexedFields ? {
+    building: stripShapeThingId(indexedFields.building),
+    ready: stripShapeThingId(indexedFields.ready),
+    failed: stripShapeThingId(indexedFields.failed),
+    other: stripShapeThingId(indexedFields.other)
+  } : null;
   const payload = {
     org,
     repo,
@@ -33470,7 +33625,8 @@ var handleDescribe = async (ctx, { args }) => {
         description: typeof data?.description === "string" ? data.description : null,
         fields: Object.fromEntries(Object.entries(fields).map(([k, v]) => [k, displayFieldEntry(v)]))
       };
-    })
+    }),
+    ...indexedFieldsPublic ? { indexedFields: indexedFieldsPublic } : {}
   };
   writeOutput(ctx, payload, () => {
     ctx.out(`${c.bold}${org}/${repo}${c.reset}`);
@@ -33521,6 +33677,52 @@ var handleDescribe = async (ctx, { args }) => {
       }
       ctx.out("");
     }
+    if (indexedFieldsPublic) {
+      const allEntries = [
+        ...indexedFieldsPublic.building,
+        ...indexedFieldsPublic.ready,
+        ...indexedFieldsPublic.failed,
+        ...indexedFieldsPublic.other
+      ];
+      if (allEntries.length === 0) {
+        ctx.out(`${c.bold}Indexed Fields${c.reset}  ${c.dim}none${c.reset}`);
+      } else {
+        ctx.out(`${c.bold}Indexed Fields${c.reset} (${allEntries.length})`);
+        ctx.out("");
+        const stateColor = (state) => {
+          switch (state) {
+            case "ready":
+              return c.green;
+            case "building":
+              return c.yellow;
+            case "failed":
+              return c.red;
+            default:
+              return c.dim;
+          }
+        };
+        const maxShape = allEntries.reduce((m, e) => Math.max(m, e.shapeName.length), 0);
+        const maxField = allEntries.reduce((m, e) => Math.max(m, e.fieldPath.length), 0);
+        const maxState = allEntries.reduce((m, e) => Math.max(m, e.state.length), 0);
+        for (const entry of allEntries) {
+          const shapeLabel = entry.shapeName.padEnd(maxShape);
+          const fieldLabel = entry.fieldPath.padEnd(maxField);
+          const stateLabel = entry.state.padEnd(maxState);
+          const sc = stateColor(entry.state);
+          let line = `  ${c.cyan}${shapeLabel}${c.reset}  ${c.dim}${fieldLabel}${c.reset}  ${sc}${stateLabel}${c.reset}`;
+          if (entry.state === "building" && entry.backfillTotal != null && entry.backfillTotal > 0) {
+            const pct = Math.round(entry.backfillDone / entry.backfillTotal * 100);
+            line += `  ${c.dim}${entry.backfillDone}/${entry.backfillTotal} (${pct}%)${c.reset}`;
+          } else if (entry.state === "building") {
+            line += `  ${c.dim}${entry.backfillDone} rows${c.reset}`;
+          } else if (entry.state === "failed" && entry.failureReason) {
+            line += `  ${c.dim}${entry.failureReason}${c.reset}`;
+          }
+          ctx.out(line);
+        }
+        ctx.out("");
+      }
+    }
   });
 };
 var confirmFlags2 = {
@@ -33790,7 +33992,12 @@ var REPO_DOMAIN = defineDomain({
       prime: true,
       summary: "Describe repo schema: shapes, fields, and inline descriptions",
       args: "[org/repo]",
-      examples: ["wh repo describe", "wh repo describe acme/world"],
+      flags: describeFlags,
+      examples: [
+        "wh repo describe",
+        "wh repo describe acme/world",
+        "wh repo describe acme/world --indexed-fields"
+      ],
       handler: handleDescribe
     },
     visibility: {
@@ -35860,7 +36067,7 @@ function resolveLogLevel(flags, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.44.0",
+  version: "0.45.0",
   private: false,
   type: "module",
   homepage: "https://docs.warmhub.ai",
@@ -36094,8 +36301,11 @@ async function resolveRegisteredInstall(args) {
   try {
     return await args.client.component.registry.resolve(ownerOrg, componentName, args.installRepo);
   } catch (error) {
-    if (error instanceof WarmHubError && error.kind === "NOT_FOUND") {
-      throw new CliError(2 /* UserInput */, "USER_INPUT", `No component registered as ${args.componentRef}`, undefined, `If you meant a local path, prefix it with ./${args.componentRef}`);
+    if (error instanceof WarmHubError && error.backendCode === "NOT_FOUND") {
+      throw new CliError(2 /* UserInput */, "USER_INPUT", `No component registered as ${args.componentRef}`, undefined, `If you meant a local path, prefix it with ./${args.componentRef}`, undefined, error.backendCode);
+    }
+    if (error instanceof WarmHubError && error.status === 404 && error.backendCode === undefined) {
+      throw new CliError(4 /* Backend */, "BACKEND", error.message, error, "The backend may not expose the component-registry routes. Confirm the API URL points at a deployment that supports `wh component install`, or check for a proxy/path mismatch.");
     }
     throw toCliError2(error);
   }
@@ -36186,7 +36396,7 @@ async function handleRegisteredInstall(args) {
         });
       } catch (error) {
         if (isMissingManifestPermissionError(error)) {
-          throw new CliError(2 /* UserInput */, "USER_INPUT", error.message, undefined, "Ask an org owner/admin to grant the missing permissions on the install repo, then re-run install.");
+          throw new CliError(2 /* UserInput */, "USER_INPUT", error.message, undefined, "Ask an org owner/admin to grant the missing permissions on the install repo, then re-run install.", undefined, error.backendCode);
         }
         throw error;
       }
@@ -36805,4 +37015,4 @@ if (!updateCheckSuppressedByArgv && shouldRunUpdateCheck(updateEligibility)) {
 var interceptedExitCode = await maybeHandleComponentShellBoundary(dispatchArgv);
 process.exitCode = interceptedExitCode === undefined ? await runCli(dispatchArgv, { version: package_default3.version }) : interceptedExitCode;
 
-//# debugId=2257A8F0A0546F4F64756E2164756E21
+//# debugId=3F3232411E7711A864756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmhub/cli",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "private": false,
   "type": "module",
   "homepage": "https://docs.warmhub.ai",