@warmhub/cli 0.64.0 → 0.66.0

package/dist/wh.js

@@ -27292,7 +27292,6 @@ var SUBSCRIBABLE_EVENT_TYPES = [
 ];
 // ../../packages/rules/src/system-components/system.ts
 var SYSTEM_COMPONENT_ID = "com.warmhub.system";
-var SYSTEM_REGISTERED_COMPONENT_REF = "warmhub/system";
 var COMPONENT_INSTALL_FIELDS = {
   componentId: "string",
   name: "string",
@@ -27353,7 +27352,7 @@ function findSystemComponent(componentId) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.63.0",
+  version: "0.65.0",
   private: false,
   type: "module",
   description: "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -28439,6 +28438,18 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    history: async (orgName, repoName, opts) => {
+      try {
+        return await this.trpc.component.history.query({
+          orgName,
+          repoName,
+          componentRef: opts?.componentRef,
+          limit: opts?.limit
+        });
+      } catch (error) {
+        throw toWarmHubError(error);
+      }
+    },
     install: async (orgName, repoName, componentRef) => {
       try {
         return await this.trpc.component.install.mutate({
@@ -32744,17 +32755,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;
-  const shapeName = extractShapeName(op.name);
-  const total = warnings.totalUndeclared ?? warnings.undeclaredFields.length;
+  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(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 +37913,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 +38004,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)
@@ -37971,13 +38021,20 @@ async function refreshFromSummaries(repoSlug, parsed, activeItems, client, now,
       }
       continue;
     }
-    const manifest = extractInstalledManifest(detail.install.data);
-    if (!manifest)
-      continue;
+    if (!detail.installedManifest || typeof detail.installedManifest !== "object") {
+      throw new Error(`component.get returned no installedManifest for ${itemRef}; the backend must support GH-4690 (installedManifest on component.get)`);
+    }
+    const manifest = detail.installedManifest;
+    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;
-    const ref = extractRegisteredRef(detail.install.data);
+    const ref = extractRegisteredRef(itemRef);
     if (!ref)
       continue;
     components[item.componentName] = {
@@ -37987,7 +38044,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 +38058,8 @@ async function refreshFromSummaries(repoSlug, parsed, activeItems, client, now,
   const cache = {
     cachedAt: now,
     repoSlug,
-    components
+    components,
+    installs
   };
   writeInstallSnapshotCache(repoSlug, cache);
   return cache;
@@ -38020,10 +38080,7 @@ async function fetchAllSummaries(client, org, repo) {
 function filterActiveItems(items) {
   return items.filter((i) => i.active && i.state !== "uninstalled" && i.state !== "paused" && i.state !== "error");
 }
-function extractRegisteredRef(data) {
-  if (typeof data !== "object" || data === null)
-    return null;
-  const ref = data.registeredComponentRef;
+function extractRegisteredRef(ref) {
   if (typeof ref !== "string" || ref.length === 0)
     return null;
   const segments = ref.split("/");
@@ -38034,27 +38091,6 @@ function extractRegisteredRef(data) {
     return null;
   return { ownerOrgName: org, registeredComponentName: name };
 }
-function extractInstalledManifest(data) {
-  if (typeof data !== "object" || data === null)
-    return null;
-  const raw = data.manifest;
-  let manifest;
-  if (typeof raw === "string") {
-    try {
-      manifest = JSON.parse(raw);
-    } catch {
-      return null;
-    }
-  } else {
-    manifest = raw;
-  }
-  if (typeof manifest !== "object" || manifest === null)
-    return null;
-  const component = manifest.component;
-  if (typeof component !== "object" || component === null)
-    return null;
-  return manifest;
-}
 
 // ../../packages/warmhub-cli/src/manifest.ts
 var GLOBAL_FLAGS = [
@@ -38365,6 +38401,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 +38419,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);
@@ -38697,6 +38742,9 @@ function renderTeardownResult(ctx, result) {
   if (result.pausedSubscriptions.length > 0) {
     ctx.out(`  ${c.green}paused${c.reset} ${result.pausedSubscriptions.length} subscription(s): ${result.pausedSubscriptions.join(", ")}`);
   }
+  if (result.releasedShapes.length > 0) {
+    ctx.out(`  ${c.green}released${c.reset} ${result.releasedShapes.length} shape(s): ${result.releasedShapes.join(", ")}`);
+  }
   if (result.tokensRevoked > 0) {
     ctx.out(`  ${c.green}revoked${c.reset} ${result.tokensRevoked} token(s)`);
   }
@@ -38856,46 +38904,6 @@ function readManifestArg(path2) {
   }
   return parsed;
 }
-function asRecord(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return;
-  }
-  return value;
-}
-function readString(data, key) {
-  const candidate = data?.[key];
-  return typeof candidate === "string" && candidate.length > 0 ? candidate : undefined;
-}
-function componentInstallIdFromWref(wref) {
-  const prefix = "ComponentInstall/";
-  return wref.startsWith(prefix) ? wref.slice(prefix.length) : undefined;
-}
-function componentInstallCanonicalId(item) {
-  const data = asRecord(item.data);
-  return componentInstallIdFromWref(item.wref) ?? readString(data, "id") ?? readString(data, "componentId") ?? item.name;
-}
-function componentInstallHasRegisteredRef(item, ref) {
-  return readString(asRecord(item.data), "registeredComponentRef") === ref;
-}
-async function resolveInstalledComponentRefId(client, org, repo, ref) {
-  let cursor;
-  do {
-    const result = await client.thing.head(org, repo, {
-      shape: "ComponentInstall",
-      kind: "thing",
-      limit: 500,
-      cursor
-    });
-    const items = result.items ?? [];
-    const exactMatch = items.find((item) => componentInstallHasRegisteredRef(item, ref));
-    const resolved = exactMatch ? componentInstallCanonicalId(exactMatch) : undefined;
-    if (resolved) {
-      return resolved;
-    }
-    cursor = result.nextCursor;
-  } while (cursor);
-  throw new CliError(2 /* UserInput */, "USER_INPUT", `Component '${ref}' is not installed. Run 'wh component install <org>/<name>' first.`);
-}
 
 // ../../packages/warmhub-cli/src/domains/component-handlers.ts
 var handleUpdate = async (ctx, { args }) => {
@@ -39025,8 +39033,9 @@ 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"}`);
-    ctx.out(`${c.bold}State:${c.reset} ${viewData.state ?? "-"}`);
+    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}Lifecycle:${c.reset} ${viewData.state ?? "-"}`);
     ctx.out(`${c.bold}Source:${c.reset} ${viewData.source ?? "-"}`);
     if (viewData.ownedShapes.length > 0) {
       ctx.out("");
@@ -39077,67 +39086,37 @@ var handleValidate = async (ctx, { args }) => {
     throw new CliError(2 /* UserInput */, "USER_INPUT", "Component package validation failed");
   }
 };
-// ../../packages/warmhub-cli/src/manifest/shared-infra.ts
-var SHARED_INFRA_SHAPES = findSystemComponent(SYSTEM_COMPONENT_ID)?.shapes ?? [];
-
 // ../../packages/warmhub-cli/src/manifest/doctor.ts
-async function doctorComponent(client, org, repo, componentId) {
+async function doctorComponent(client, org, repo, ref) {
   const findings = [];
-  let installData;
+  let detail;
   try {
-    const thing = await client.thing.get(org, repo, `ComponentInstall/${componentId}`);
-    installData = thing.data && typeof thing.data === "object" ? thing.data : {};
+    detail = await client.component.get(org, repo, ref);
     findings.push({
-      resource: "ComponentInstall",
+      resource: "install",
       status: "ok",
       message: "Install record found"
     });
-  } catch {
+  } catch (err) {
+    const kind = isWarmHubError(err) ? err.kind : undefined;
+    const notInstalled = kind === "NOT_FOUND";
     return {
-      componentId,
-      componentName: componentId,
-      state: "error",
+      componentId: ref,
+      componentName: ref,
+      state: notInstalled ? "uninstalled" : "error",
       findings: [
         {
-          resource: "ComponentInstall",
+          resource: "install",
           status: "missing",
-          message: `ComponentInstall/${componentId} not found`
+          message: notInstalled ? `Component "${ref}" is not actively installed` : `Failed to resolve component "${ref}"`
         }
       ]
     };
   }
-  const componentName = typeof installData.name === "string" ? installData.name : componentId;
-  const registeredComponentRef = typeof installData.registeredComponentRef === "string" && installData.registeredComponentRef.length > 0 ? installData.registeredComponentRef : undefined;
-  if (!registeredComponentRef) {
-    findings.push({
-      resource: "ComponentInstall",
-      status: "error",
-      message: "Install record is missing registeredComponentRef"
-    });
-    return { componentId, componentName, state: "error", findings };
-  }
-  const existingState = typeof installData.state === "string" ? installData.state : undefined;
-  if (existingState === "error") {
-    findings.push({
-      resource: "state",
-      status: "error",
-      message: "Component is in error state from a previous operation"
-    });
-    return { componentId, componentName, state: "error", findings };
-  }
-  if (existingState === "uninstalled") {
-    findings.push({
-      resource: "state",
-      status: "inactive",
-      message: "Component is uninstalled; reinstall to revive it"
-    });
-    return { componentId, componentName, state: "uninstalled", findings };
-  }
-  let manifest;
-  try {
-    const raw = typeof installData.manifest === "string" ? installData.manifest : undefined;
-    manifest = raw ? JSON.parse(raw) : { shapes: [], subscriptions: [], credentials: [], seeds: [] };
-  } catch {
+  const componentName = detail.componentName;
+  const componentId = detail.installComponentId ?? ref;
+  const registeredComponentRef = detail.ref ?? ref;
+  if (!detail.installedManifest || typeof detail.installedManifest !== "object") {
     return {
       componentId,
       componentName,
@@ -39147,11 +39126,12 @@ async function doctorComponent(client, org, repo, componentId) {
         {
           resource: "manifest",
           status: "error",
-          message: "Failed to parse installed manifest snapshot"
+          message: "Installed manifest unavailable from the registry"
         }
       ]
     };
   }
+  const manifest = detail.installedManifest;
   for (const shape of manifest.shapes ?? []) {
     try {
       const s = await client.shape.get(org, repo, shape.name);
@@ -39282,6 +39262,19 @@ async function doctorComponent(client, org, repo, componentId) {
       });
     }
   }
+  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})`
+    });
+  }
   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,22 +39287,6 @@ 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"
-    });
-  }
   return { componentId, componentName, state, findings };
 }
 
@@ -39320,8 +39297,7 @@ var handleDoctor = async (ctx, { args }) => {
     usageError("Usage: wh component doctor <org/name> --repo org/repo", "wh component doctor warmhub/research-knowledge --repo myorg/myrepo");
   }
   const { org, repo } = parseOrgRepo(getRepoRef(ctx), ctx.config);
-  const componentId = await resolveInstalledComponentRefId(ctx.client, org, repo, name);
-  const result = await doctorComponent(ctx.client, org, repo, componentId);
+  const result = await doctorComponent(ctx.client, org, repo, name);
   writeOutput(ctx, result, () => renderDoctorResult(ctx, result));
 };
 var handleTeardown = async (ctx, { args }) => {
@@ -39426,7 +39402,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}`);
     }
   });
 };
@@ -39451,16 +39428,11 @@ var handleSearch2 = async (ctx, { flags, args }) => {
 };
 function stateToColor2(c, state) {
   switch (state) {
-    case "ready":
+    case "active":
       return c.green;
-    case "paused":
     case "uninstalled":
       return c.yellow;
-    case "degraded":
-      return c.red;
-    case "error":
-      return c.red;
-    case "installing":
+    case "initiated":
       return c.cyan;
     default:
       return c.dim;
@@ -45415,6 +45387,8 @@ async function dispatch(ctx) {
   const hint = ctx._domainHint ? ` ${ctx._domainHint}` : "";
   throw new CliError(2 /* UserInput */, "USER_INPUT", `Unknown command: ${command}`, undefined, hint.trim() || "Run 'wh help' for available commands.");
 }
+// ../../packages/warmhub-cli/src/manifest/shared-infra.ts
+var SHARED_INFRA_SHAPES = findSystemComponent(SYSTEM_COMPONENT_ID)?.shapes ?? [];
 // ../../packages/warmhub-cli/src/apply-global-flags.ts
 function invokesRemovedVerb(ctx) {
   return ctx.invocation.command === "credential" && ctx.invocation.positional[0] === "export";
@@ -45761,7 +45735,7 @@ function resolveLogLevel(flags, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.64.0",
+  version: "0.66.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 +46390,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=C5B05FE58189780B64756E2164756E21

package/package.json

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