@warmhub/cli 0.64.0 → 0.65.0

package/dist/wh.js

@@ -27353,7 +27353,7 @@ function findSystemComponent(componentId) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.63.0",
+  version: "0.64.0",
   private: false,
   type: "module",
   description: "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -32744,17 +32744,37 @@ function escapeTerminalTextForDisplay(value) {
 var escapeInlineTerminalText = escapeFieldNameForDisplay;
 function renderWarningLine(out, c, chars, op) {
   const warnings = op.warnings;
-  if (!warnings || warnings.undeclaredFields.length === 0)
+  if (!warnings)
+    return;
+  renderUndeclaredFieldsWarning(out, c, chars, op.name, warnings);
+  renderCoalescedWrefsWarning(out, c, chars, warnings);
+}
+function renderUndeclaredFieldsWarning(out, c, chars, opName, warnings) {
+  const undeclaredFields = warnings.undeclaredFields;
+  if (!undeclaredFields || undeclaredFields.length === 0)
     return;
-  const shapeName = extractShapeName(op.name);
-  const total = warnings.totalUndeclared ?? warnings.undeclaredFields.length;
+  const shapeName = extractShapeName(opName);
+  const total = warnings.totalUndeclared ?? undeclaredFields.length;
   const noun = total === 1 ? "field" : "fields";
   const shapeLabel = shapeName ? ` ${shapeName}` : "";
-  const remaining = warnings.undeclaredFieldsTruncated ? total - warnings.undeclaredFields.length : 0;
-  const fieldsList = warnings.undeclaredFields.map(escapeInlineTerminalText).join(", ");
+  const remaining = warnings.undeclaredFieldsTruncated ? total - undeclaredFields.length : 0;
+  const fieldsList = undeclaredFields.map(escapeInlineTerminalText).join(", ");
   const moreSuffix = remaining > 0 ? ` ${c.dim}(+${remaining} more)${c.reset}` : "";
   out(`    ${c.yellow}${chars.warn}${c.reset} ${total} ${noun} not declared in shape${shapeLabel}: ${c.dim}${fieldsList}${c.reset}${moreSuffix}`);
 }
+function renderCoalescedWrefsWarning(out, c, chars, warnings) {
+  const coalescedWrefs = warnings.coalescedWrefs;
+  if (!coalescedWrefs || coalescedWrefs.length === 0)
+    return;
+  for (const entry of coalescedWrefs) {
+    out(`    ${c.yellow}${chars.warn}${c.reset} coalesced wref ${escapeInlineTerminalText(entry.fieldPath)}: ${c.dim}${escapeInlineTerminalText(entry.wref)}${c.reset} (${escapeInlineTerminalText(entry.reason)})`);
+  }
+  const total = warnings.totalCoalescedWrefs ?? coalescedWrefs.length;
+  const remaining = warnings.coalescedWrefsTruncated ? total - coalescedWrefs.length : 0;
+  if (remaining > 0) {
+    out(`    ${c.dim}(+${remaining} more coalesced wrefs)${c.reset}`);
+  }
+}
 function renderCommitterEcho(out, c, committer) {
   if (!committer)
     return;
@@ -37882,6 +37902,24 @@ function isInstallSnapshotCacheShape(value) {
     if (!Array.isArray(component.methods))
       return false;
   }
+  if (!isPlainObject2(value.installs))
+    return false;
+  const installs = value.installs;
+  for (const entry of Object.values(installs)) {
+    if (!isPlainObject2(entry))
+      return false;
+    const install = entry;
+    if (typeof install.ref !== "string")
+      return false;
+    if (typeof install.version !== "string")
+      return false;
+    if (install.latestVersion !== undefined && typeof install.latestVersion !== "string") {
+      return false;
+    }
+    if (install.updateAvailable !== undefined && typeof install.updateAvailable !== "boolean") {
+      return false;
+    }
+  }
   return true;
 }
 
@@ -37955,6 +37993,7 @@ async function refreshInstallSnapshotCache(repoSlug, client, opts) {
 }
 async function refreshFromSummaries(repoSlug, parsed, activeItems, client, now, previousCache) {
   const components = {};
+  const installs = {};
   let detailReadFailures = 0;
   for (const item of activeItems) {
     if (!item.ref)
@@ -37974,6 +38013,12 @@ async function refreshFromSummaries(repoSlug, parsed, activeItems, client, now,
     const manifest = extractInstalledManifest(detail.install.data);
     if (!manifest)
       continue;
+    installs[item.componentName] = {
+      ref: itemRef,
+      version: manifest.component.version ?? item.version ?? "",
+      latestVersion: item.latestVersion,
+      updateAvailable: item.updateAvailable
+    };
     const methods = manifest.cli?.methods ?? [];
     if (methods.length === 0)
       continue;
@@ -37987,7 +38032,9 @@ async function refreshFromSummaries(repoSlug, parsed, activeItems, client, now,
       version: manifest.component.version ?? item.version ?? "",
       description: manifest.cli?.description,
       manifestHash: item.manifestHash ?? "",
-      methods
+      methods,
+      latestVersion: item.latestVersion,
+      updateAvailable: item.updateAvailable
     };
   }
   if (activeItems.length > 0 && detailReadFailures === activeItems.length) {
@@ -37999,7 +38046,8 @@ async function refreshFromSummaries(repoSlug, parsed, activeItems, client, now,
   const cache = {
     cachedAt: now,
     repoSlug,
-    components
+    components,
+    installs
   };
   writeInstallSnapshotCache(repoSlug, cache);
   return cache;
@@ -38365,6 +38413,13 @@ var handleComponentExec = async (ctx, { args, terminator }) => {
   const cache = await ensureFreshInstallSnapshotCache(installRepo, ctx.client);
   const entry = cache.components[componentName];
   if (!entry) {
+    const install = cache.installs[componentName];
+    if (install?.updateAvailable && install.latestVersion) {
+      throw new CliError(2 /* UserInput */, "USER_INPUT", `Component '${componentName}' is installed at ${install.version || "an older version"} in ${installRepo}, which exposes no CLI method${methodName ? ` '${methodName}'` : "s"}.`, undefined, `Version ${install.latestVersion} is available — run 'wh component update ${install.ref} --repo ${installRepo}', then 'wh component exec ${componentName} --help' to see its methods.`);
+    }
+    if (install) {
+      throw new CliError(2 /* UserInput */, "USER_INPUT", `Component '${componentName}' is installed in ${installRepo} but exposes no CLI methods.`);
+    }
     throw new CliError(2 /* UserInput */, "USER_INPUT", `Component '${componentName}' is not installed in ${installRepo}.`, undefined, `Run 'wh component install <ref> --repo ${installRepo}' first.`);
   }
   if (!methodName) {
@@ -38376,7 +38431,9 @@ var handleComponentExec = async (ctx, { args, terminator }) => {
   }
   const method = entry.methods.find((m) => m.name === methodName);
   if (!method) {
-    throw new CliError(2 /* UserInput */, "USER_INPUT", `Method '${methodName}' not found on component '${componentName}'.`, undefined, `Available: ${entry.methods.map((m) => m.name).join(", ")}. Run wh component update ${entry.ref} --repo ${installRepo} if you expect a newer method.`);
+    const available = entry.methods.map((m) => m.name).join(", ");
+    const updateHint = entry.updateAvailable && entry.latestVersion ? `Version ${entry.latestVersion} is available — run wh component update ${entry.ref} --repo ${installRepo} for newer methods.` : `Run wh component update ${entry.ref} --repo ${installRepo} if you expect a newer method.`;
+    throw new CliError(2 /* UserInput */, "USER_INPUT", `Method '${methodName}' not found on component '${componentName}'.`, undefined, `Available: ${available}. ${updateHint}`);
   }
   if (helpRequested) {
     renderMethodHelp(ctx, componentName, method);
@@ -39025,7 +39082,8 @@ var handleView3 = async (ctx, { args }) => {
   writeOutput(ctx, viewData, () => {
     const c = ctx.colors;
     ctx.out(`${c.bold}Component:${c.reset} ${c.cyan}${viewData.ref ?? ref}${c.reset}`);
-    ctx.out(`${c.bold}Version:${c.reset} ${viewData.version ?? "unknown"}`);
+    const update = viewData.updateAvailable && viewData.latestVersion ? ` ${c.yellow}(${viewData.latestVersion} available — run wh component update ${viewData.ref ?? ref} --repo ${org}/${repo})${c.reset}` : "";
+    ctx.out(`${c.bold}Version:${c.reset} ${viewData.version ?? "unknown"}${update}`);
     ctx.out(`${c.bold}State:${c.reset} ${viewData.state ?? "-"}`);
     ctx.out(`${c.bold}Source:${c.reset} ${viewData.source ?? "-"}`);
     if (viewData.ownedShapes.length > 0) {
@@ -39282,6 +39340,22 @@ async function doctorComponent(client, org, repo, componentId) {
       });
     }
   }
+  try {
+    const detail = await client.component.get(org, repo, registeredComponentRef);
+    if (detail.updateAvailable === true && detail.latestVersion) {
+      findings.push({
+        resource: "version",
+        status: "warning",
+        message: `Installed ${detail.version ?? "version"}; ${detail.latestVersion} available — run wh component update ${registeredComponentRef} --repo ${org}/${repo}`
+      });
+    } else if (detail.updateAvailable === false && detail.version) {
+      findings.push({
+        resource: "version",
+        status: "ok",
+        message: `Up to date (${detail.version})`
+      });
+    }
+  } catch {}
   const hasMissing = findings.some((f) => f.status === "missing");
   const hasInactive = findings.some((f) => f.status === "inactive" && !f.resource.startsWith("sub:"));
   const hasShapeDrift = findings.some((f) => f.resource.startsWith("shape:") && f.status === "warning" && f.message.includes("differs from installed manifest"));
@@ -39294,21 +39368,23 @@ async function doctorComponent(client, org, repo, componentId) {
   } else {
     state = "ready";
   }
-  try {
-    await client.commit.apply(org, repo, `Doctor: update ${componentName} state to ${state}`, [
-      {
-        operation: "revise",
-        kind: "thing",
-        name: `ComponentInstall/${componentId}`,
-        data: { ...installData, state, checkedAt: new Date().toISOString() }
-      }
-    ], { componentRef: SYSTEM_REGISTERED_COMPONENT_REF });
-  } catch {
-    findings.push({
-      resource: "state-update",
-      status: "warning",
-      message: "Failed to persist computed state"
-    });
+  if (state !== existingState) {
+    try {
+      await client.commit.apply(org, repo, `Doctor: update ${componentName} state to ${state}`, [
+        {
+          operation: "revise",
+          kind: "thing",
+          name: `ComponentInstall/${componentId}`,
+          data: { ...installData, state }
+        }
+      ], { componentRef: SYSTEM_REGISTERED_COMPONENT_REF });
+    } catch {
+      findings.push({
+        resource: "state-update",
+        status: "warning",
+        message: "Failed to persist computed state"
+      });
+    }
   }
   return { componentId, componentName, state, findings };
 }
@@ -39426,7 +39502,8 @@ var handleList2 = async (ctx, { flags }) => {
       const state = item.state ?? "unknown";
       const source = item.source ?? "-";
       const stateColor = stateToColor2(c, state);
-      ctx.out(`  ${c.cyan}${item.ref ?? item.componentName}${c.reset}  ${stateColor}${state}${c.reset}  ${c.dim}v${version}${c.reset}  ${source}`);
+      const update = item.updateAvailable && item.latestVersion ? ` ${c.yellow}(${item.latestVersion} available)${c.reset}` : "";
+      ctx.out(`  ${c.cyan}${item.ref ?? item.componentName}${c.reset}  ${stateColor}${state}${c.reset}  ${c.dim}v${version}${c.reset}${update}  ${source}`);
     }
   });
 };
@@ -45761,7 +45838,7 @@ function resolveLogLevel(flags, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.64.0",
+  version: "0.65.0",
   private: false,
   type: "module",
   description: "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -46416,4 +46493,4 @@ if (!updateCheckSuppressedByArgv && shouldRunUpdateCheck(updateEligibility)) {
 var interceptedExitCode = await maybeHandleComponentShellBoundary(dispatchArgv);
 process.exitCode = interceptedExitCode === undefined ? await runCli(dispatchArgv, { version: package_default3.version }) : interceptedExitCode;
 
-//# debugId=7FF3388CDD4F972C64756E2164756E21
+//# debugId=B70D5B946B8CF0E364756E2164756E21

package/package.json

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