@warmhub/cli 0.71.0 → 0.72.0

package/dist/wh.js

@@ -18478,7 +18478,13 @@ var import_awaitAsyncGenerator = __toESM(require_awaitAsyncGenerator(), 1);
 var import_wrapAsyncGenerator = __toESM(require_wrapAsyncGenerator(), 1);
 var import_objectSpread29 = __toESM(require_objectSpread2(), 1);
 // ../../packages/rules/src/builtin-shapes.ts
-var BUILTIN_SHAPE_NAMES = ["Pair", "Set", "List"];
+var BUILTIN_SHAPE_NAMES = [
+  "Arc",
+  "Bond",
+  "Pair",
+  "Set",
+  "List"
+];
 var RETIRED_COLLECTION_SHAPE_NAMES = ["Triple"];
 var RESERVED_COLLECTION_SHAPE_NAMES = [
   ...BUILTIN_SHAPE_NAMES,
@@ -18503,6 +18509,25 @@ function isBuiltinShape(name) {
   return BUILTIN_SHAPE_NAMES.includes(name) || BUILTIN_CONTENT_SHAPE_NAMES.includes(name);
 }
 var BUILTIN_SHAPE_DEFS = {
+  Arc: {
+    fields: {
+      from: {
+        type: "wref",
+        description: "Origin of the directed relationship"
+      },
+      to: {
+        type: "wref",
+        description: "Destination of the directed relationship"
+      }
+    },
+    description: "A directed relationship between two things"
+  },
+  Bond: {
+    fields: {
+      ends: [{ type: "wref", description: "Endpoints of the relationship" }]
+    },
+    description: "A symmetric relationship between two things"
+  },
   Pair: {
     fields: {
       first: { type: "wref", description: "First member of the pair" },
@@ -19735,7 +19760,9 @@ function preflightOpDiagnostics(op, operationIndex) {
 function builtinShapeGuard(op, operationIndex) {
   const errors = [];
   const name = op.name;
-  if (name && isRetiredCollectionShape(name)) {
+  const isShapeRename = op.operation === "rename" && (op.kind === "shape" || op.name !== undefined && !splitLocalPath(op.name));
+  const reservedSourcePassThrough = isShapeRename && name !== undefined && isReservedCollectionShape(name) && op.newName !== undefined && !isReservedCollectionShape(op.newName) && !isBuiltinShape(op.newName);
+  if (name && isRetiredCollectionShape(name) && !reservedSourcePassThrough) {
     errors.push({
       code: "RESERVED_NAME",
       operationIndex,
@@ -19749,8 +19776,7 @@ function builtinShapeGuard(op, operationIndex) {
       message: `Shape "${op.newName}" is a retired collection shape and cannot be written manually`
     });
   } else {
-    const isShapeRename = op.operation === "rename" && (op.kind === "shape" || op.name !== undefined && !splitLocalPath(op.name));
-    const builtinShapeName = name && isBuiltinShape(name) ? name : isShapeRename && op.newName && isBuiltinShape(op.newName) ? op.newName : undefined;
+    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({
@@ -27136,7 +27162,7 @@ function findSystemComponent(componentId) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.69.1",
+  version: "0.70.0",
   private: false,
   type: "module",
   description: "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -30179,6 +30205,7 @@ var TOP_LEVEL_USER_INPUT_CODES = new Set([
 ]);
 var CONFLICT_SHAPED_CODES = new Set([
   "CONFLICT",
+  "BUILTIN_SHAPE_CONFLICT",
   "ARCHIVED",
   "HAS_INBOUND_REFS",
   "REPO_PENDING_DELETE",
@@ -32648,10 +32675,11 @@ function formatTime(ts, now) {
   return d.toISOString().slice(0, 16).replace("T", " ");
 }
 function pinnedWref(c, wref, version) {
-  if (version == null)
-    return `${c.cyan}${wref}${c.reset}`;
+  if (version == null) {
+    return `${c.cyan}${escapeTerminalTextForDisplay(wref)}${c.reset}`;
+  }
   const base = wref.replace(/@v\d+$/, "");
-  return `${c.cyan}${base}@v${version}${c.reset}`;
+  return `${c.cyan}${escapeTerminalTextForDisplay(base)}@v${version}${c.reset}`;
 }
 function kindLabel(c, kind) {
   return `${c.dim}${kind}${c.reset}`;
@@ -32686,7 +32714,7 @@ function effectiveKind(kind, shapeName) {
 }
 function displayName(c, name) {
   if (name)
-    return `${c.cyan}${name}${c.reset}`;
+    return `${c.cyan}${escapeTerminalTextForDisplay(name)}${c.reset}`;
   return `${c.dim}(unnamed)${c.reset}`;
 }
 function extractShapeName(name) {
@@ -33468,15 +33496,15 @@ function renderHead(out, c, chars, result, org, repo, shape, kind) {
     const fields = shapeName && (item.kind === "thing" || item.kind === "collection") && item.data ? collectionFields(shapeName, item.data) : null;
     if (fields) {
       const allWrefs = fields.flatMap((f) => f.wrefs);
-      out(`    ${allWrefs.map((w) => pinnedWref(c, escapeTerminalTextForDisplay(w))).join(`${c.dim},${c.reset} `)}`);
+      out(`    ${allWrefs.map((w) => pinnedWref(c, w)).join(`${c.dim},${c.reset} `)}`);
     } else if (item.data && typeof item.data === "object") {
       const preview = JSON.stringify(item.data);
       const truncated = preview.length > 80 ? `${preview.slice(0, 77)}...` : preview;
-      out(`    ${c.dim}${truncated}${c.reset}`);
+      out(`    ${c.dim}${escapeTerminalTextForDisplay(truncated)}${c.reset}`);
     }
     const itemMeta = item.metadata;
     if (itemMeta?.durableId) {
-      out(`    ${c.dim}durableId:${c.reset} ${styleDurableId(itemMeta.durableId, c)}`);
+      out(`    ${c.dim}durableId:${c.reset} ${styleDurableId(escapeTerminalTextForDisplay(itemMeta.durableId), c)}`);
     }
   }
   out(`${c.dim}${items.length} item(s)${c.reset}`);
@@ -33487,7 +33515,7 @@ function renderThing(out, c, result) {
   const displayKind = effectiveKind(result.kind ?? "thing", shapeName);
   const retractedTag = result.active === false ? `  ${c.red}[RETRACTED]${c.reset}` : "";
   out(`${pinnedWref(c, wref, result.version)}  ${kindLabel(c, displayKind)}${retractedTag}`);
-  out(`  ${c.dim}wref:${c.reset}      ${wref}`);
+  out(`  ${c.dim}wref:${c.reset}      ${escapeTerminalTextForDisplay(wref)}`);
   out(`  ${c.dim}version:${c.reset}   ${result.version ?? "-"}`);
   out(`  ${c.dim}active:${c.reset}    ${String(result.active)}`);
   if (result.committerWref) {
@@ -33495,13 +33523,13 @@ function renderThing(out, c, result) {
   }
   const aboutWref = result.aboutWref ?? result.about;
   if (aboutWref) {
-    out(`  ${c.dim}about:${c.reset}     ${String(aboutWref)}`);
+    out(`  ${c.dim}about:${c.reset}     ${escapeTerminalTextForDisplay(String(aboutWref))}`);
   }
   const meta = result.metadata;
   if (meta?.durableId || meta?.createdOn || meta?.revisedOn) {
     const now = Date.now();
     if (meta.durableId) {
-      out(`  ${c.dim}durableId:${c.reset} ${styleDurableId(meta.durableId, c)}`);
+      out(`  ${c.dim}durableId:${c.reset} ${styleDurableId(escapeTerminalTextForDisplay(meta.durableId), c)}`);
     }
     if (meta.createdOn) {
       out(`  ${c.dim}createdOn:${c.reset}  ${formatTime(meta.createdOn, now)}`);
@@ -33518,11 +33546,11 @@ function renderThing(out, c, result) {
     for (const field of fields) {
       if (field.wrefs.length === 1) {
         const pad = " ".repeat(Math.max(1, 9 - field.name.length));
-        out(`  ${c.dim}${field.name}:${c.reset}${pad}${pinnedWref(c, escapeTerminalTextForDisplay(field.wrefs[0]))}`);
+        out(`  ${c.dim}${escapeTerminalTextForDisplay(field.name)}:${c.reset}${pad}${pinnedWref(c, field.wrefs[0])}`);
       } else {
-        out(`  ${c.dim}${field.name}:${c.reset}`);
+        out(`  ${c.dim}${escapeTerminalTextForDisplay(field.name)}:${c.reset}`);
         for (const w of field.wrefs) {
-          out(`    ${pinnedWref(c, escapeTerminalTextForDisplay(w))}`);
+          out(`    ${pinnedWref(c, w)}`);
         }
       }
     }
@@ -33531,7 +33559,7 @@ function renderThing(out, c, result) {
     const lines = JSON.stringify(result.data, null, 2).split(`
 `);
     for (const line of lines) {
-      out(`    ${line}`);
+      out(`    ${escapeTerminalTextForDisplay(line)}`);
     }
   }
 }
@@ -33547,14 +33575,14 @@ function renderCollectionSummary(out, c, collection) {
     return;
   out(`  ${c.dim}preview:${c.reset}`);
   for (const wref of preview) {
-    out(`    ${pinnedWref(c, escapeTerminalTextForDisplay(wref))}`);
+    out(`    ${pinnedWref(c, wref)}`);
   }
 }
 function renderDataBlock(out, data, indent) {
   const lines = JSON.stringify(data, null, 2).split(`
 `);
   for (const line of lines) {
-    out(`${indent}${line}`);
+    out(`${indent}${escapeTerminalTextForDisplay(line)}`);
   }
 }
 function renderGraphValue(out, c, value, indent) {
@@ -33594,7 +33622,7 @@ function renderGraphNode(out, c, result, indent = "") {
   if (resolvedEntries.length > 0) {
     out(`${indent}  ${c.dim}resolved:${c.reset}`);
     for (const [fieldPath, value] of resolvedEntries) {
-      out(`${indent}    ${c.dim}${fieldPath}:${c.reset}`);
+      out(`${indent}    ${c.dim}${escapeTerminalTextForDisplay(fieldPath)}:${c.reset}`);
       renderGraphValue(out, c, value, `${indent}      `);
     }
   }
@@ -33620,7 +33648,7 @@ function renderHistory(out, c, result) {
   }
   const firstMeta = result.versions?.[0]?.metadata;
   if (firstMeta?.durableId) {
-    out(`  ${c.dim}durableId:${c.reset} ${styleDurableId(firstMeta.durableId, c)}`);
+    out(`  ${c.dim}durableId:${c.reset} ${styleDurableId(escapeTerminalTextForDisplay(firstMeta.durableId), c)}`);
   }
   const versions = result.versions ?? [];
   const now = Date.now();
@@ -33629,7 +33657,7 @@ function renderHistory(out, c, result) {
     if (ver.operation === "add") {
       op = `${c.green}add${c.reset}`;
     } else if (ver.operation === "retract") {
-      const reason = ver.retractReason ? ` ${c.dim}'${ver.retractReason.length > 80 ? `${ver.retractReason.slice(0, 77)}...` : ver.retractReason}'${c.reset}` : "";
+      const reason = ver.retractReason ? ` ${c.dim}'${escapeTerminalTextForDisplay(ver.retractReason.length > 80 ? `${ver.retractReason.slice(0, 77)}...` : ver.retractReason)}'${c.reset}` : "";
       op = `${c.red}retract${c.reset}${reason}`;
     } else {
       op = `${c.yellow}revise${c.reset}`;
@@ -33650,12 +33678,12 @@ function renderRefs(out, c, result, wref, direction) {
     return;
   }
   const label = direction === "inbound" ? "References to" : "Referenced by";
-  out(`${c.bold}${label}${c.reset} ${c.cyan}${wref}${c.reset}`);
+  out(`${c.bold}${label}${c.reset} ${c.cyan}${escapeTerminalTextForDisplay(wref)}${c.reset}`);
   out(`${c.dim}${"─".repeat(60)}${c.reset}`);
   for (const item of items) {
     const refWref = pinnedWref(c, item.wref, item.version);
     const kl = kindLabel(c, effectiveKind(item.kind ?? "thing", item.shapeName));
-    const field = `${c.dim}via ${c.reset}${item.fieldPath}`;
+    const field = `${c.dim}via ${c.reset}${escapeTerminalTextForDisplay(item.fieldPath ?? "(unknown)")}`;
     out(`  ${refWref}  ${kl}  ${field}`);
   }
   out(`${c.dim}${items.length} ref(s)${c.reset}`);
@@ -33685,7 +33713,7 @@ function renderBatchView(out, c, result, wrefs, flagsVersion) {
     if (event.kind === "miss")
       continue;
     if (event.kind === "desync") {
-      out(`  ${event.requested}  ${c.red}[no result]${c.reset}`);
+      out(`  ${escapeTerminalTextForDisplay(event.requested)}  ${c.red}[no result]${c.reset}`);
       continue;
     }
     const { requested, item } = event;
@@ -33694,12 +33722,12 @@ function renderBatchView(out, c, result, wrefs, flagsVersion) {
     const base = requestedBase.length > 0 ? requestedBase : fallback.replace(/@v\d+$/, "");
     const kl = kindLabel(c, effectiveKind(item.kind ?? "thing", item.shapeName));
     const retractedTag = item.active === false ? `  ${c.red}[RETRACTED]${c.reset}` : "";
-    out(`  ${base}@v${item.version}  ${kl}${retractedTag}`);
+    out(`  ${escapeTerminalTextForDisplay(base)}@v${item.version}  ${kl}${retractedTag}`);
   }
   if (result.missing.length > 0) {
     out("Missing:");
     for (const wref of result.missing) {
-      out(`  ${wref}`);
+      out(`  ${escapeTerminalTextForDisplay(wref)}`);
     }
   }
 }
@@ -34459,7 +34487,7 @@ var handleResolve = async (ctx, { args }) => {
   writeOutput(ctx, result, () => {
     const wref2 = result.wref ?? result.name ?? "(unknown)";
     ctx.out(`${pinnedWref(c, wref2, result.version)}  ${kindLabel(c, result.kind ?? "thing")}`);
-    ctx.out(`  ${c.dim}wref:${c.reset}      ${wref2}`);
+    ctx.out(`  ${c.dim}wref:${c.reset}      ${escapeTerminalTextForDisplay(wref2)}`);
     ctx.out(`  ${c.dim}version:${c.reset}   ${result.version ?? "-"}`);
     ctx.out(`  ${c.dim}active:${c.reset}    ${String(result.active)}`);
   });
@@ -36165,7 +36193,7 @@ function renderTokenInfo(ctx, info, profileName, apiUrl, identityWref) {
       ctx.status(`${c.dim}Check the value of your WH_TOKEN environment variable.${c.reset}`);
     } else if (info.source === "device") {
       if (info.canRefresh) {
-        ctx.status(`${prefix}${c.bold}${info.email ?? "unknown"}${c.reset} via ${via} ${c.dim}(token expired at ${expiry} — will auto-refresh)${c.reset}${endpoint}`);
+        ctx.status(`${prefix}${c.bold}${info.email ?? "unknown"}${c.reset} via ${via} ${c.dim}(token expired at ${expiry} — refresh token available)${c.reset}${endpoint}`);
       } else {
         ctx.status(`${prefix}${c.red}Session expired${c.reset}${email} via ${via} ${c.dim}(expired at ${expiry})${c.reset}${endpoint}`);
         ctx.status(`${c.dim}Run: wh auth login${profileName && profileName !== "default" ? ` --profile ${profileName}` : ""}${c.reset}`);
@@ -36212,6 +36240,26 @@ var loginFlags = {
   }),
   ...profileFlag
 };
+function authStatusEntry(info, options) {
+  return {
+    active: options.active,
+    apiUrl: options.apiUrl ?? null,
+    authenticated: !info.expired,
+    canRefresh: info.canRefresh,
+    email: info.email ?? null,
+    expiresAt: info.expiresAt ?? null,
+    identityWref: options.identityWref ?? null,
+    profile: options.profile ?? null,
+    source: info.source
+  };
+}
+function authStatusOutput(activeProfile, entries) {
+  return {
+    activeProfile,
+    authenticated: entries.some((entry) => entry.active && entry.authenticated),
+    entries
+  };
+}
 var handleLogin = async (ctx, { flags }) => {
   const profile = flags.profile ?? ctx.config.profile ?? "default";
   if (flags["with-token"]) {
@@ -36306,7 +36354,7 @@ var handleStatus = async (ctx, { flags }) => {
   if (selectedProfile) {
     const prof = getProfile(selectedProfile);
     if (!prof) {
-      ctx.status(`Not logged in for profile ${c.bold}${selectedProfile}${c.reset}. Run: wh auth login --profile ${selectedProfile}`);
+      writeOutput(ctx, authStatusOutput(selectedProfile, []), () => ctx.status(`Not logged in for profile ${c.bold}${selectedProfile}${c.reset}. Run: wh auth login --profile ${selectedProfile}`));
       return;
     }
     const tokens = prof.tokens;
@@ -36320,17 +36368,26 @@ var handleStatus = async (ctx, { flags }) => {
       canRefresh: source === "device" && !!tokens.refreshToken
     };
     const identityWref = info.expired ? null : await fetchIdentityWref(ctx);
-    renderTokenInfo(ctx, info, selectedProfile, prof.apiUrl, identityWref);
+    const entry = authStatusEntry(info, {
+      active: true,
+      apiUrl: prof.apiUrl,
+      identityWref,
+      profile: selectedProfile
+    });
+    writeOutput(ctx, authStatusOutput(selectedProfile, [entry]), () => renderTokenInfo(ctx, info, selectedProfile, prof.apiUrl, identityWref));
     return;
   }
   const envToken = process.env.WH_TOKEN;
+  const activeProfile = ctx.config.profile ?? "default";
+  const entries = [];
+  const prettyEntries = [];
   if (envToken) {
     const envInfo = getTokenInfo();
     if (envInfo) {
-      renderTokenInfo(ctx, envInfo);
+      entries.push(authStatusEntry(envInfo, { active: true }));
+      prettyEntries.push(() => renderTokenInfo(ctx, envInfo));
     }
   }
-  const activeProfile = ctx.config.profile ?? "default";
   const profiles = listProfiles();
   for (const name of profiles) {
     const prof = getProfile(name);
@@ -36346,12 +36403,22 @@ var handleStatus = async (ctx, { flags }) => {
         canRefresh: source === "device" && !!tokens.refreshToken
       };
       const identityWref = !info.expired && name === activeProfile ? await fetchIdentityWref(ctx) : null;
-      renderTokenInfo(ctx, info, name, prof.apiUrl, identityWref);
+      entries.push(authStatusEntry(info, {
+        active: !envToken && name === activeProfile,
+        apiUrl: prof.apiUrl,
+        identityWref,
+        profile: name
+      }));
+      prettyEntries.push(() => renderTokenInfo(ctx, info, name, prof.apiUrl, identityWref));
     }
   }
-  if (!envToken && profiles.length === 0) {
-    ctx.status("Not logged in. Run: wh auth login");
-  }
+  writeOutput(ctx, authStatusOutput(envToken ? null : activeProfile, entries), () => {
+    for (const render of prettyEntries)
+      render();
+    if (!envToken && profiles.length === 0) {
+      ctx.status("Not logged in. Run: wh auth login");
+    }
+  });
 };
 var statusVerb = {
   prime: true,
@@ -37799,6 +37866,10 @@ function buildAddOperations(input) {
     const rawAbout = pick(abouts, i, { allowBroadcast: true });
     const about = rawAbout ? parseCollectionAboutFlag(rawAbout) : rawAbout;
     const kindFlag = pick(kinds, i, { allowBroadcast: true });
+    const addNameParts = addName.split("/");
+    if (shape && addNameParts.length === 2 && addNameParts[0] === shape) {
+      throw new CliError(2 /* UserInput */, "USER_INPUT", `--add value "${addName}" already includes the --shape prefix "${shape}/".`, undefined, "Pass a bare name with --shape (for example: wh commit submit --add item --shape Shape), or omit --shape and pass the full wref.");
+    }
     const localName = shape ? `${shape}/${addName}` : addName;
     const kind = kindFlag ?? (about ? "assertion" : "thing");
     return { operation: "add", kind, name: localName, data, about };
@@ -39608,15 +39679,15 @@ function renderValidationResult(ctx, result) {
   if (result.errors.length > 0) {
     ctx.out(`${c.red}Validation failed${c.reset}`);
     for (const err of result.errors) {
-      ctx.out(`  ${c.red}error${c.reset}: ${err}`);
+      ctx.out(`  ${c.red}error${c.reset}: ${escapeTerminalTextForDisplay(err)}`);
     }
   }
   for (const finding of result.findings) {
     const color = finding.level === "error" ? c.red : finding.level === "warning" ? c.yellow : c.dim;
-    ctx.out(`  ${color}${finding.level}${c.reset} [${finding.code}]: ${finding.message}`);
+    ctx.out(`  ${color}${finding.level}${c.reset} [${escapeTerminalTextForDisplay(finding.code)}]: ${escapeTerminalTextForDisplay(finding.message)}`);
   }
   for (const warn of result.warnings) {
-    ctx.out(`  ${c.yellow}warning${c.reset}: ${warn}`);
+    ctx.out(`  ${c.yellow}warning${c.reset}: ${escapeTerminalTextForDisplay(warn)}`);
   }
   if (result.valid && result.errors.length === 0) {
     ctx.out(`${c.green}Valid component package${c.reset}`);
@@ -39626,29 +39697,29 @@ function renderValidationResult(ctx, result) {
 function renderDoctorResult(ctx, result) {
   const c = ctx.colors;
   const stateColor = stateToColor(c, result.state);
-  ctx.out(`${c.bold}Doctor:${c.reset} ${c.cyan}${result.componentName}${c.reset}  ${stateColor}${result.state}${c.reset}`);
+  ctx.out(`${c.bold}Doctor:${c.reset} ${c.cyan}${escapeTerminalTextForDisplay(result.componentName)}${c.reset}  ${stateColor}${escapeTerminalTextForDisplay(result.state)}${c.reset}`);
   ctx.out("");
   for (const finding of result.findings) {
     const color = finding.status === "ok" ? c.green : finding.status === "missing" || finding.status === "error" ? c.red : finding.status === "inactive" ? c.yellow : c.dim;
-    ctx.out(`  ${color}${finding.status}${c.reset} ${finding.resource}  ${c.dim}${finding.message}${c.reset}`);
+    ctx.out(`  ${color}${escapeTerminalTextForDisplay(finding.status)}${c.reset} ${escapeTerminalTextForDisplay(finding.resource)}  ${c.dim}${escapeTerminalTextForDisplay(finding.message)}${c.reset}`);
   }
 }
 function renderTeardownResult(ctx, result) {
   const c = ctx.colors;
   const stateColor = stateToColor(c, result.state);
-  ctx.out(`${c.bold}Teardown:${c.reset} ${c.cyan}${result.componentName}${c.reset}  ${stateColor}${result.state}${c.reset}`);
+  ctx.out(`${c.bold}Teardown:${c.reset} ${c.cyan}${escapeTerminalTextForDisplay(result.componentName)}${c.reset}  ${stateColor}${escapeTerminalTextForDisplay(result.state)}${c.reset}`);
   if (result.pausedSubscriptions.length > 0) {
-    ctx.out(`  ${c.green}paused${c.reset} ${result.pausedSubscriptions.length} subscription(s): ${result.pausedSubscriptions.join(", ")}`);
+    ctx.out(`  ${c.green}paused${c.reset} ${result.pausedSubscriptions.length} subscription(s): ${result.pausedSubscriptions.map(escapeTerminalTextForDisplay).join(", ")}`);
   }
   if (result.releasedShapes.length > 0) {
-    ctx.out(`  ${c.green}released${c.reset} ${result.releasedShapes.length} shape(s): ${result.releasedShapes.join(", ")}`);
+    ctx.out(`  ${c.green}released${c.reset} ${result.releasedShapes.length} shape(s): ${result.releasedShapes.map(escapeTerminalTextForDisplay).join(", ")}`);
   }
   if (result.tokensRevoked > 0) {
     ctx.out(`  ${c.green}revoked${c.reset} ${result.tokensRevoked} token(s)`);
   }
   ctx.out(`  uninstall callback: ${result.uninstallDispatched ? `${c.green}dispatched${c.reset}` : `${c.dim}not dispatched${c.reset}`}`);
   for (const warning of result.warnings) {
-    ctx.out(`  ${c.yellow}warning${c.reset}: ${warning}`);
+    ctx.out(`  ${c.yellow}warning${c.reset}: ${escapeTerminalTextForDisplay(warning)}`);
   }
 }
 function redactRegistryEntryLifecycleUrls(entry, showSecrets) {
@@ -39668,26 +39739,26 @@ function redactRegistryEntryListLifecycleUrls(entries, showSecrets) {
 function renderRegistryList(ctx, orgName, result) {
   const c = ctx.colors;
   if (!result.items.length) {
-    ctx.status(`${c.dim}No registered components in ${orgName}${c.reset}`);
+    ctx.status(`${c.dim}No registered components in ${escapeTerminalTextForDisplay(orgName)}${c.reset}`);
     return;
   }
-  ctx.out(`${c.bold}Registered Components${c.reset} ${c.cyan}${orgName}${c.reset}`);
+  ctx.out(`${c.bold}Registered Components${c.reset} ${c.cyan}${escapeTerminalTextForDisplay(orgName)}${c.reset}`);
   ctx.out("");
   for (const item of result.items) {
     const visibility = item.isPrivate ? `${c.yellow}private${c.reset}` : `${c.green}public${c.reset}`;
-    const description = item.description ? `  ${c.dim}${item.description}${c.reset}` : "";
-    ctx.out(`  ${c.cyan}${orgName}/${item.componentName}${c.reset}  ${visibility}${description}`);
+    const description = item.description ? `  ${c.dim}${escapeTerminalTextForDisplay(item.description)}${c.reset}` : "";
+    ctx.out(`  ${c.cyan}${escapeTerminalTextForDisplay(orgName)}/${escapeTerminalTextForDisplay(item.componentName)}${c.reset}  ${visibility}${description}`);
   }
 }
 function renderRegistryEntry(ctx, entry) {
   const c = ctx.colors;
-  ctx.out(`${c.bold}${entry.ownerOrgName}/${entry.componentName}${c.reset} ${entry.isPrivate ? `${c.yellow}[private]${c.reset}` : `${c.green}[public]${c.reset}`}`);
+  ctx.out(`${c.bold}${escapeTerminalTextForDisplay(entry.ownerOrgName)}/${escapeTerminalTextForDisplay(entry.componentName)}${c.reset} ${entry.isPrivate ? `${c.yellow}[private]${c.reset}` : `${c.green}[public]${c.reset}`}`);
   if (entry.description) {
-    ctx.out(`  ${entry.description}`);
+    ctx.out(`  ${escapeTerminalTextForDisplay(entry.description)}`);
   }
   if (entry.sourceUrl) {
-    const suffix = entry.sourceDefaultRef ? ` @ ${entry.sourceDefaultRef}` : "";
-    ctx.out(`  Source: ${entry.sourceUrl}${suffix}`);
+    const suffix = entry.sourceDefaultRef ? ` @ ${escapeTerminalTextForDisplay(entry.sourceDefaultRef)}` : "";
+    ctx.out(`  Source: ${escapeTerminalTextForDisplay(entry.sourceUrl)}${suffix}`);
   } else {
     ctx.out(`  Source: ${c.dim}(not installable — no source URL)${c.reset}`);
   }
@@ -39698,10 +39769,10 @@ function renderRegistryEntry(ctx, entry) {
     ctx.out(`  Uninstall: ${formatLifecycleUrl(entry.uninstallUrl, c)}`);
   }
   if (entry.credentialSetName || entry.credentialSetId) {
-    ctx.out(`  Credential set: ${entry.credentialSetName ?? entry.credentialSetId}`);
+    ctx.out(`  Credential set: ${escapeTerminalTextForDisplay(entry.credentialSetName ?? entry.credentialSetId ?? "")}`);
   }
   if (entry.allowedCallbackDomains.length > 0) {
-    ctx.out(`  Allowed callback domains: ${entry.allowedCallbackDomains.join(", ")}`);
+    ctx.out(`  Allowed callback domains: ${entry.allowedCallbackDomains.map(escapeTerminalTextForDisplay).join(", ")}`);
   }
   ctx.out(`  ${c.dim}Updated: ${new Date(entry.updatedAt).toISOString().slice(0, 16)}${c.reset}`);
 }
@@ -39737,13 +39808,13 @@ function redactSecretBearingUrl(rawUrl) {
 }
 function formatLifecycleUrl(url, colors) {
   if (url === REDACTED_LIFECYCLE_URL) {
-    return `${colors.dim}${url}${colors.reset}`;
+    return `${colors.dim}${escapeTerminalTextForDisplay(url)}${colors.reset}`;
   }
   if (url.endsWith(REDACTED_LIFECYCLE_PATH_SUFFIX)) {
     const visiblePrefix = url.slice(0, -REDACTED_LIFECYCLE_PATH_SUFFIX.length);
-    return `${visiblePrefix}${colors.dim}${REDACTED_LIFECYCLE_PATH_SUFFIX}${colors.reset}`;
+    return `${escapeTerminalTextForDisplay(visiblePrefix)}${colors.dim}${REDACTED_LIFECYCLE_PATH_SUFFIX}${colors.reset}`;
   }
-  return url;
+  return escapeTerminalTextForDisplay(url);
 }
 
 // ../../packages/warmhub-cli/src/domains/component-utils.ts
@@ -40296,12 +40367,13 @@ var handleList2 = async (ctx, { flags }) => {
     ctx.out(`${c.bold}Installed Components${c.reset} ${c.cyan}${org}/${repo}${c.reset}`);
     ctx.out("");
     for (const item of items) {
-      const version = item.version ?? "unknown";
-      const state = item.state ?? "unknown";
-      const source = item.source ?? "-";
-      const stateColor = stateToColor2(c, state);
-      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}`);
+      const version = escapeTerminalTextForDisplay(item.version ?? "unknown");
+      const rawState = item.state ?? "unknown";
+      const state = escapeTerminalTextForDisplay(rawState);
+      const source = escapeTerminalTextForDisplay(item.source ?? "-");
+      const stateColor = stateToColor2(c, rawState);
+      const update = item.updateAvailable && item.latestVersion ? ` ${c.yellow}(${escapeTerminalTextForDisplay(item.latestVersion)} available)${c.reset}` : "";
+      ctx.out(`  ${c.cyan}${escapeTerminalTextForDisplay(item.ref ?? item.componentName)}${c.reset}  ${stateColor}${state}${c.reset}  ${c.dim}v${version}${c.reset}${update}  ${source}`);
     }
   });
 };
@@ -42193,12 +42265,12 @@ var handleView5 = async (ctx, { args }) => {
   const c = ctx.colors;
   const result = await ctx.client.org.get(name);
   writeOutput(ctx, result, () => {
-    ctx.out(`${c.bold}${result.name}${c.reset}`);
+    ctx.out(`${c.bold}${escapeTerminalTextForDisplay(result.name)}${c.reset}`);
     if (result.displayName) {
-      ctx.out(`  ${result.displayName}`);
+      ctx.out(`  ${escapeTerminalTextForDisplay(result.displayName)}`);
     }
     if (result.description) {
-      ctx.out(`  ${c.dim}${result.description}${c.reset}`);
+      ctx.out(`  ${c.dim}${escapeTerminalTextForDisplay(result.description)}${c.reset}`);
     }
     if (result.tier !== "free") {
       ctx.out(`  ${c.cyan}Tier: ${result.tier}${c.reset}`);
@@ -42226,10 +42298,10 @@ var handleList4 = async (ctx, { flags }) => {
     }
     ctx.out(`${c.bold}Organizations:${c.reset}`);
     for (const org of result.items) {
-      const display = org.displayName ? `  ${c.dim}${org.displayName}${c.reset}` : "";
-      const desc = org.description ? `  ${c.dim}${org.description}${c.reset}` : "";
+      const display = org.displayName ? `  ${c.dim}${escapeTerminalTextForDisplay(org.displayName)}${c.reset}` : "";
+      const desc = org.description ? `  ${c.dim}${escapeTerminalTextForDisplay(org.description)}${c.reset}` : "";
       const archived = org.archivedAt ? `  ${c.yellow}[archived]${c.reset}` : "";
-      ctx.out(`  ${c.cyan}${org.name}${c.reset}${display}${desc}${archived}`);
+      ctx.out(`  ${c.cyan}${escapeTerminalTextForDisplay(org.name)}${c.reset}${display}${desc}${archived}`);
     }
   });
 };
@@ -42879,10 +42951,10 @@ var handleList5 = async (ctx, { flags, args }) => {
     }
     ctx.out(`${c.bold}Repos in ${orgName}:${c.reset}`);
     for (const r of items) {
-      const display = r.displayName && r.displayName !== r.name ? `  ${c.dim}${r.displayName}${c.reset}` : "";
-      const desc = r.description ? `  ${c.dim}${r.description}${c.reset}` : "";
+      const display = r.displayName && r.displayName !== r.name ? `  ${c.dim}${escapeTerminalTextForDisplay(r.displayName)}${c.reset}` : "";
+      const desc = r.description ? `  ${c.dim}${escapeTerminalTextForDisplay(r.description)}${c.reset}` : "";
       const archived = r.archivedAt ? `  ${c.yellow}[archived]${c.reset}` : "";
-      ctx.out(`  ${c.cyan}${orgName}/${r.name}${c.reset}${display}${desc}${archived}`);
+      ctx.out(`  ${c.cyan}${orgName}/${escapeTerminalTextForDisplay(r.name)}${c.reset}${display}${desc}${archived}`);
     }
   });
 };
@@ -43015,7 +43087,7 @@ var handleDescribe = async (ctx, { args, flags }) => {
   writeOutput(ctx, payload, () => {
     ctx.out(`${c.bold}${org}/${repo}${c.reset}`);
     if (repoInfo.description) {
-      ctx.out(`  ${repoInfo.description}`);
+      ctx.out(`  ${escapeTerminalTextForDisplay(repoInfo.description)}`);
     }
     ctx.out("");
     ctx.out(`${c.bold}Counts${c.reset}  ${stats.byKind.shape} shapes, ${stats.byKind.thing} things, ${stats.byKind.assertion} assertions (${stats.total} total)`);
@@ -43023,7 +43095,7 @@ var handleDescribe = async (ctx, { args, flags }) => {
     if (shapeCountEntries.length > 0) {
       const maxName = shapeCountEntries.reduce((max, [name]) => Math.max(max, name.length), 0);
       for (const [shapeName, count] of shapeCountEntries) {
-        ctx.out(`  ${c.cyan}${shapeName.padEnd(maxName)}${c.reset}  ${count}`);
+        ctx.out(`  ${c.cyan}${escapeTerminalTextForDisplay(shapeName.padEnd(maxName))}${c.reset}  ${count}`);
       }
     }
     ctx.out("");
@@ -43090,9 +43162,9 @@ var handleDescribe = async (ctx, { args, flags }) => {
         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 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) {
@@ -43101,7 +43173,7 @@ var handleDescribe = async (ctx, { args, flags }) => {
           } 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}`;
+            line += `  ${c.dim}${escapeTerminalTextForDisplay(entry.failureReason)}${c.reset}`;
           }
           ctx.out(line);
         }
@@ -43155,10 +43227,11 @@ var handleView6 = async (ctx, { args }) => {
   writeOutput(ctx, { ...repoInfo, stats, configureStats }, () => {
     ctx.out(`${c.bold}${org}/${repo}${c.reset}`);
     if (repoInfo.displayName && repoInfo.displayName !== repoInfo.name) {
-      ctx.out(`  ${repoInfo.displayName}`);
+      ctx.out(`  ${escapeTerminalTextForDisplay(repoInfo.displayName)}`);
+    }
+    if (repoInfo.description) {
+      ctx.out(`  ${escapeTerminalTextForDisplay(repoInfo.description)}`);
     }
-    if (repoInfo.description)
-      ctx.out(`  ${repoInfo.description}`);
     if (repoInfo.archivedAt) {
       ctx.out(`${c.yellow}ARCHIVED${c.reset} ${c.dim}${new Date(repoInfo.archivedAt).toISOString().slice(0, 16)}${c.reset}`);
     }
@@ -46421,7 +46494,7 @@ function resolveLogLevel(flags, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.71.0",
+  version: "0.72.0",
   private: false,
   type: "module",
   description: "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -47076,4 +47149,4 @@ if (!updateCheckSuppressedByArgv && shouldRunUpdateCheck(updateEligibility)) {
 var interceptedExitCode = await maybeHandleComponentShellBoundary(dispatchArgv);
 process.exitCode = interceptedExitCode === undefined ? await runCli(dispatchArgv, { version: package_default3.version }) : interceptedExitCode;
 
-//# debugId=94B2C7EE252C64A264756E2164756E21
+//# debugId=32195DBCBD952F6364756E2164756E21

package/package.json

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