@warmhub/cli 0.117.0 → 0.118.0

package/dist/wh.js

@@ -45312,7 +45312,7 @@ function createStreamingSubmissionHandle(input, deps) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.115.0",
+  version: "0.116.0",
   private: false,
   type: "module",
   description: "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -46725,6 +46725,30 @@ class WarmHubClient {
         } catch (error51) {
           throw toWarmHubError(error51);
         }
+      },
+      pin: async (orgName, repoName, shape, fieldPath) => {
+        try {
+          return await this.trpc.repo.index.pin.mutate({
+            orgName,
+            repoName,
+            shape,
+            fieldPath
+          });
+        } catch (error51) {
+          throw toWarmHubError(error51);
+        }
+      },
+      unpin: async (orgName, repoName, shape, fieldPath) => {
+        try {
+          return await this.trpc.repo.index.unpin.mutate({
+            orgName,
+            repoName,
+            shape,
+            fieldPath
+          });
+        } catch (error51) {
+          throw toWarmHubError(error51);
+        }
       }
     }
   };
@@ -48509,6 +48533,12 @@ function generateSuggestions(code, message, context, errorCode) {
     }
   }
   if (code === "FIELD_NOT_INDEXABLE") {
+    if (message.includes("field-not-declared")) {
+      suggestions.push({
+        action: "Declare the field path for indexing, then retry",
+        command: "wh repo index pin <Shape> <field.path>"
+      });
+    }
     suggestions.push({
       action: "Inspect indexed field state for the repo",
       command: "wh repo describe --indexed-fields"
@@ -65029,6 +65059,70 @@ var VERIFY_VERB = {
   handler: handleVerify2
 };
 
+// ../../packages/warmhub-cli/src/domains/repo/index-pin.ts
+var PIN_USAGE = "Usage: wh repo index pin <Shape> <field.path> [org/repo]";
+var PIN_EXAMPLE = "wh repo index pin Person address.city acme/world";
+var UNPIN_USAGE = "Usage: wh repo index unpin <Shape> <field.path> [org/repo]";
+var UNPIN_EXAMPLE = "wh repo index unpin Person address.city acme/world";
+function parseIndexArgs(args, usage, example) {
+  const [shape, fieldPath, repoRef] = args;
+  if (!shape || !fieldPath) {
+    usageError(usage, example);
+  }
+  return { shape, fieldPath, repoRef };
+}
+function renderPinResult(ctx, verb, result) {
+  const c = ctx.colors;
+  ctx.out(`${c.green}${verb}${c.reset} ${c.cyan}${escapeTerminalTextForDisplay(result.fieldPath)}${c.reset} via ${escapeTerminalTextForDisplay(result.declaredByShape)}`);
+  if (result.carryingShapes.length === 0) {
+    ctx.out(`  ${c.dim}no shape in this repo carries the path${c.reset}`);
+    return;
+  }
+  const maxShape = result.carryingShapes.reduce((m, s) => Math.max(m, s.shape.length), 0);
+  for (const carrying of result.carryingShapes) {
+    ctx.out(`  ${c.cyan}${escapeTerminalTextForDisplay(carrying.shape.padEnd(maxShape))}${c.reset}  ${escapeTerminalTextForDisplay(carrying.markerState)}`);
+  }
+}
+var handlePin = async (ctx, { args }) => {
+  const { shape, fieldPath, repoRef } = parseIndexArgs(args, PIN_USAGE, PIN_EXAMPLE);
+  const { org, repo: repo2 } = parseOrgRepo(getRepoRef(ctx) ?? repoRef, ctx.config);
+  const result = await ctx.client.repo.index.pin(org, repo2, shape, fieldPath);
+  writeOutput(ctx, result, () => renderPinResult(ctx, "Declared", result));
+};
+var handleUnpin = async (ctx, { args }) => {
+  const { shape, fieldPath, repoRef } = parseIndexArgs(args, UNPIN_USAGE, UNPIN_EXAMPLE);
+  const { org, repo: repo2 } = parseOrgRepo(getRepoRef(ctx) ?? repoRef, ctx.config);
+  const result = await ctx.client.repo.index.unpin(org, repo2, shape, fieldPath);
+  writeOutput(ctx, result, () => renderPinResult(ctx, "Withdrew", result));
+};
+var INDEX_SUBDOMAIN = defineDomain({
+  name: "index",
+  summary: "Declare which field paths the typed field index carries",
+  verbs: {
+    pin: {
+      summary: "Declare a field path for indexing",
+      args: "<Shape> <field.path> [org/repo]",
+      notes: [
+        "The declaration is repository-wide: every shape carrying the path is backfilled, not just the one named here.",
+        "The path is resolved through the shape’s effective contract, so a composite may name a property one of its composed shapes owns.",
+        "Read `wh repo describe --indexed-fields` for readiness."
+      ],
+      examples: [PIN_EXAMPLE, "wh repo index pin Person address.city"],
+      handler: handlePin
+    },
+    unpin: {
+      summary: "Withdraw a field path from indexing",
+      args: "<Shape> <field.path> [org/repo]",
+      notes: [
+        "Refuses while a stored View definition references the path, naming the Views.",
+        "Rows are evicted asynchronously; predicates on the path fail immediately."
+      ],
+      examples: [UNPIN_EXAMPLE, "wh repo index unpin Person address.city"],
+      handler: handleUnpin
+    }
+  }
+});
+
 // ../../packages/warmhub-cli/src/domains/repo/lifecycle.ts
 var confirmFlags2 = {
   yes: flag.boolean({ short: "y", description: "Skip confirmation prompt" })
@@ -65146,6 +65240,100 @@ var handleList6 = async (ctx, { flags, args }) => {
   });
 };
 
+// ../../packages/warmhub-cli/src/domains/repo/indexed-fields-view.ts
+function stripShapeThingId(bucket) {
+  return bucket.map(({ shapeThingId: _omit, ...rest }) => rest);
+}
+function toPublicIndexedFields(report) {
+  return {
+    building: stripShapeThingId(report.building),
+    ready: stripShapeThingId(report.ready),
+    failed: stripShapeThingId(report.failed),
+    other: stripShapeThingId(report.other),
+    declarations: report.declarations,
+    consistency: report.consistency
+  };
+}
+function stateColor(c, state) {
+  switch (state) {
+    case "ready":
+      return c.green;
+    case "building":
+      return c.yellow;
+    case "failed":
+      return c.red;
+    default:
+      return c.dim;
+  }
+}
+function renderDeclarations(out, c, view) {
+  const { declarations, consistency } = view;
+  if (declarations.length === 0) {
+    out(`${c.bold}Declared Fields${c.reset}  ${c.dim}none${c.reset}`);
+    out(`  ${c.dim}Declare one with \`wh repo index pin <Shape> <path>\`${c.reset}`);
+  } else {
+    out(`${c.bold}Declared Fields${c.reset} (${declarations.length})`);
+    out("");
+    const maxPath = declarations.reduce((m, d) => Math.max(m, d.fieldPath.length), 0);
+    for (const declaration of declarations) {
+      const pathLabel = escapeTerminalTextForDisplay(declaration.fieldPath.padEnd(maxPath));
+      const readiness = declaration.ready ? "ready" : "not ready";
+      const rc = declaration.ready ? c.green : c.yellow;
+      const carriedBy = declaration.carrying.length > 0 ? declaration.carrying.map((m) => `${m.shapeName} (${m.state})`).join(", ") : "no carrying shape";
+      out(`  ${c.cyan}${pathLabel}${c.reset}  ${rc}${readiness}${c.reset}  ${c.dim}${escapeTerminalTextForDisplay(carriedBy)}${c.reset}`);
+      if (declaration.declaredByShape) {
+        out(`    ${c.dim}pinned via ${escapeTerminalTextForDisplay(declaration.declaredByShape)}${c.reset}`);
+      }
+    }
+  }
+  out("");
+  if (!consistency.consistent) {
+    out(`${c.bold}${c.red}Index consistency${c.reset}`);
+    for (const marker of consistency.undeclaredMarkers) {
+      out(`  ${c.red}undeclared${c.reset}  ${c.cyan}${escapeTerminalTextForDisplay(marker.shapeName)}${c.reset}  ${escapeTerminalTextForDisplay(marker.fieldPath)}`);
+    }
+    out("");
+  }
+}
+function renderMarkers(out, c, view) {
+  const allEntries = [
+    ...view.building,
+    ...view.ready,
+    ...view.failed,
+    ...view.other
+  ];
+  if (allEntries.length === 0) {
+    out(`${c.bold}Indexed Fields${c.reset}  ${c.dim}none${c.reset}`);
+    return;
+  }
+  out(`${c.bold}Indexed Fields${c.reset} (${allEntries.length})`);
+  out("");
+  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 = escapeTerminalTextForDisplay(entry.shapeName.padEnd(maxShape));
+    const fieldLabel = escapeTerminalTextForDisplay(entry.fieldPath.padEnd(maxField));
+    const stateLabel = escapeTerminalTextForDisplay(entry.state.padEnd(maxState));
+    const sc = stateColor(c, 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}${escapeTerminalTextForDisplay(entry.failureReason)}${c.reset}`;
+    }
+    out(line);
+  }
+  out("");
+}
+function renderIndexedFields(out, c, view) {
+  renderDeclarations(out, c, view);
+  renderMarkers(out, c, view);
+}
+
 // ../../packages/warmhub-cli/src/domains/repo/manage.ts
 var repoRenameFlags = {
   "display-name": flag.string({
@@ -65240,15 +65428,7 @@ var handleDescribe = async (ctx, { args, flags }) => {
     ...nameStrings(shapes).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 indexedFieldsPublic = indexedFields ? toPublicIndexedFields(indexedFields) : null;
   const payload = {
     org,
     repo: repo2,
@@ -65324,50 +65504,7 @@ var handleDescribe = async (ctx, { args, flags }) => {
       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 = escapeTerminalTextForDisplay(entry.shapeName.padEnd(maxShape));
-          const fieldLabel = escapeTerminalTextForDisplay(entry.fieldPath.padEnd(maxField));
-          const stateLabel = escapeTerminalTextForDisplay(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}${escapeTerminalTextForDisplay(entry.failureReason)}${c.reset}`;
-          }
-          ctx.out(line);
-        }
-        ctx.out("");
-      }
+      renderIndexedFields(ctx.out, c, indexedFieldsPublic);
     }
   });
 };
@@ -65565,7 +65702,8 @@ var REPO_DOMAIN = defineDomain({
   },
   subdomains: {
     checkpoint: CHECKPOINT_SUBDOMAIN,
-    content: CONTENT_SUBDOMAIN
+    content: CONTENT_SUBDOMAIN,
+    index: INDEX_SUBDOMAIN
   }
 });
 
@@ -69612,7 +69750,7 @@ function resolveLogLevel(flagLevel, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.117.0",
+  version: "0.118.0",
   private: false,
   type: "module",
   description: "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -70237,5 +70375,5 @@ process.exitCode = interceptedExitCode === undefined ? await runPreparedCli(laun
   version: package_default3.version
 }) : interceptedExitCode;
 
-//# debugId=A07541AC8954FD7B64756E2164756E21
-//# warmhub-cli-build-info {"cliVersion":"0.117.0","sdkVersion":"0.115.0"}
+//# debugId=E526A210005F6CCA64756E2164756E21
+//# warmhub-cli-build-info {"cliVersion":"0.118.0","sdkVersion":"0.116.0"}

package/package.json

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