@zeroxyz/cli 0.0.34 → 0.0.37

package/README.md

@@ -46,7 +46,7 @@ Search for capabilities by free-text query.
 zero search "image classification"
 ```
 
-Results are numbered. Use `zero get <number>` to view details.
+Results are numbered and include public rating/review context. Use `zero get <number>` to view details.
 
 **Cost filtering.** By default, results are filtered to capabilities priced **≤ $30/call** as a wallet-safety cap. Override per-call:
 
@@ -56,7 +56,7 @@ zero search "expensive deep research" --max-cost 100 # raise the cap for hard ta
 zero search "image classification" --free            # only free capabilities
 ```
 
-Other useful filters: `--min-rating <1-5>`, `--min-trust <0-100>`, `--protocol x402|mpp`, `--status healthy|degraded|down`, `--source <name>`, `--all` (no trust/health filtering).
+Other useful filters: `--protocol x402|mpp`, `--status healthy|degraded|down`, `--source <name>`, `--all` (disables default quality filtering).
 
 ### `zero get <position>`
 

package/dist/index.js

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
 
-// src/app.ts
-import { Command as Command12 } from "commander";
+// src/index.ts
+import { homedir as homedir7 } from "os";
+import { join as join8 } from "path";
 
 // package.json
 var package_default = {
   name: "@zeroxyz/cli",
-  version: "0.0.34",
+  version: "0.0.37",
   type: "module",
   bin: {
     zero: "dist/index.js",
@@ -22,7 +23,7 @@ var package_default = {
   },
   scripts: {
     build: "tsup src/index.ts --format esm --out-dir dist --clean",
-    "build:binary": "tsup --config tsup.binary.ts && cp -r skills hooks dist/pkg/ && pnpm exec pkg dist/pkg/index.cjs --config pkg.json --targets node24-macos-arm64,node24-macos-x64,node24-linux-x64 --output dist/bin/zero",
+    "build:binary": "tsup --config tsup.binary.ts && cp -r skills hooks dist/pkg/ && pnpm exec pkg dist/pkg/index.cjs --config pkg.json --targets node24-macos-arm64,node24-macos-x64,node24-linux-x64,node24-linux-arm64 --output dist/bin/zero",
     prepublishOnly: "pnpm run build",
     dev: "ZERO_ENV=development tsx src/index.ts",
     cli: "ZERO_ENV=development ZERO_API_URL=http://localhost:1111 tsx src/index.ts",
@@ -40,7 +41,7 @@ var package_default = {
     "@x402/extensions": "^2.9.0",
     "@x402/fetch": "^2.9.0",
     commander: "^13.0.0",
-    mppx: "^0.5.9",
+    mppx: "^0.6.9",
     open: "^11.0.0",
     "posthog-node": "^5.29.2",
     viem: "^2.47.10",
@@ -59,6 +60,9 @@ var package_default = {
   }
 };
 
+// src/app.ts
+import { Command as Command12 } from "commander";
+
 // src/commands/bug-report-command.ts
 import { createHash as createHash2 } from "crypto";
 import { readFileSync } from "fs";
@@ -68,6 +72,13 @@ import { z as z2 } from "zod";
 // src/services/api-service.ts
 import { createHash } from "crypto";
 import z from "zod";
+var ratingSchema = z.object({
+  score: z.string(),
+  successRate: z.string(),
+  reviews: z.number(),
+  stars: z.string().nullable().optional(),
+  state: z.enum(["unrated", "rated"]).optional()
+});
 var searchResultSchema = z.object({
   id: z.string(),
   position: z.number(),
@@ -77,18 +88,12 @@ var searchResultSchema = z.object({
   description: z.string(),
   whatItDoes: z.string().nullable().optional(),
   url: z.string(),
+  urlTemplate: z.string().nullable().optional(),
   cost: z.object({ amount: z.string(), asset: z.string() }),
-  rating: z.object({
-    score: z.string(),
-    successRate: z.string(),
-    reviews: z.number(),
-    stars: z.string().nullable().optional(),
-    state: z.enum(["unrated", "rated"]).optional()
-  }),
-  trustScore: z.number().nullable().optional(),
-  trustSignalCount: z.number().optional(),
+  reviewCount: z.number().optional(),
+  rating: ratingSchema,
   availabilityStatus: z.enum(["healthy", "degraded", "down", "unknown"]).nullable().optional(),
-  relevanceScore: z.number().optional()
+  displayStatus: z.enum(["healthy", "stable", "degraded", "unhealthy", "unknown"]).optional()
 });
 var searchResponseSchema = z.object({
   searchId: z.string(),
@@ -103,6 +108,7 @@ var capabilityResponseSchema = z.object({
   name: z.string(),
   description: z.string(),
   url: z.string(),
+  urlTemplate: z.string().nullable().optional(),
   method: z.string(),
   headers: z.record(z.string(), z.string()).nullable(),
   bodySchema: z.record(z.string(), z.unknown()).nullable(),
@@ -111,13 +117,8 @@ var capabilityResponseSchema = z.object({
   tags: z.array(z.string()).nullable(),
   displayCostAmount: z.string(),
   displayCostAsset: z.string(),
-  rating: z.object({
-    score: z.string(),
-    successRate: z.string(),
-    reviews: z.number(),
-    stars: z.string().nullable().optional(),
-    state: z.enum(["unrated", "rated"]).optional()
-  }),
+  reviewCount: z.number(),
+  rating: ratingSchema,
   priceObserved: z.object({
     minCents: z.string().nullable(),
     medianCents: z.string().nullable(),
@@ -140,13 +141,8 @@ var capabilityResponseSchema = z.object({
       priority: z.number()
     })
   ).nullable(),
-  trustScore: z.number().nullable().optional(),
-  trustComponents: z.object({
-    apiQuality: z.number().nullable(),
-    blockchainActivity: z.number().nullable(),
-    performance: z.number().nullable()
-  }).nullable().optional(),
   availabilityStatus: z.enum(["healthy", "degraded", "down", "unknown"]).nullable().optional(),
+  displayStatus: z.enum(["healthy", "stable", "degraded", "unhealthy", "unknown"]).optional(),
   activationCount: z.number().optional(),
   lastUsedAt: z.string().nullable().optional(),
   lastSuccessfullyRanAt: z.string().nullable().optional()
@@ -617,6 +613,7 @@ var configCommand = (_appContext) => new Command2("config").description("View or
 });
 
 // src/commands/fetch-command.ts
+import { createHash as createHash3 } from "crypto";
 import { readFileSync as readFileSync3 } from "fs";
 import { resolve as resolvePath } from "path";
 import { Command as Command3 } from "commander";
@@ -740,6 +737,7 @@ var pickSessionCloseAmount = (receipt, openTimeCumulative) => {
   const accepted = BigInt(receipt.acceptedCumulative);
   const spent = BigInt(receipt.spent);
   const fromReceipt = accepted > spent ? accepted : spent;
+  if (receipt.metered === true) return fromReceipt;
   return fromReceipt > openTimeCumulative ? fromReceipt : openTimeCumulative;
 };
 var PaymentService = class {
@@ -1206,6 +1204,22 @@ var truncateQuery = (raw) => raw.length > QUERY_MAX ? `${raw.slice(0, QUERY_MAX)
 var truncateError = (raw) => raw.length > ERROR_MAX ? `${raw.slice(0, ERROR_MAX)}\u2026` : raw;
 
 // src/commands/fetch-command.ts
+var sniffJsonShape = (buf) => {
+  let i = 0;
+  if (buf.length >= 3 && buf[0] === 239 && buf[1] === 187 && buf[2] === 191) {
+    i = 3;
+  }
+  while (i < buf.length && (buf[i] === 32 || buf[i] === 9 || buf[i] === 10 || buf[i] === 13)) {
+    i++;
+  }
+  if (i >= buf.length) return false;
+  return buf[i] === 123 || buf[i] === 91;
+};
+var urlMatchesTemplate = (url, template) => {
+  const escaped = template.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const withCaptures = escaped.replace(/\\\{[^/\\}]+\\\}/g, "[^/]+");
+  return new RegExp(`^${withCaptures}$`).test(url);
+};
 var isTextContentType = (contentType) => {
   if (!contentType) return true;
   const ct = contentType.toLowerCase().split(";")[0]?.trim() ?? "";
@@ -1325,6 +1339,7 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
       const startTime = Date.now();
       let resolvedUrl;
       let resolvedMethodFromCapability;
+      let resolvedCapabilityName;
       if (!url) {
         if (!options.capability) {
           console.error(
@@ -1337,6 +1352,7 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
           const cap = await apiService.getCapability(options.capability);
           resolvedUrl = cap.url;
           resolvedMethodFromCapability = cap.method;
+          resolvedCapabilityName = cap.name;
         } catch (err) {
           console.error(
             `Failed to resolve --capability ${options.capability}: ${err instanceof Error ? err.message : String(err)}`
@@ -1347,6 +1363,47 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
       } else {
         resolvedUrl = url;
       }
+      if (!url && options.capability && !stateService.findSearchContextByCapability(options.capability)) {
+        try {
+          let capName = resolvedCapabilityName;
+          if (capName === void 0) {
+            const cap = await apiService.getCapability(options.capability);
+            capName = cap.name;
+          }
+          const searchResult = await apiService.search({ query: capName });
+          const slugFoundInResults = searchResult.capabilities.some(
+            (c) => c.slug === options.capability || c.id === options.capability
+          );
+          stateService.saveLastSearch({
+            searchId: searchResult.searchId,
+            capabilities: searchResult.capabilities.map((c) => ({
+              position: c.position,
+              id: c.id,
+              url: c.url,
+              urlTemplate: c.urlTemplate ?? null,
+              displayCostAmount: c.cost.amount
+            }))
+          });
+          analyticsService.capture("search_executed", {
+            query: truncateQuery(capName),
+            queryLength: capName.length,
+            resultCount: searchResult.capabilities.length,
+            searchId: searchResult.searchId,
+            total: searchResult.total,
+            hasMore: searchResult.hasMore,
+            json: false,
+            triggeredBy: "slug_handoff",
+            slugFoundInResults
+          });
+          analyticsService.capture("capability_viewed", {
+            capabilityId: options.capability,
+            fromLastSearch: false,
+            searchId: searchResult.searchId,
+            triggeredBy: "slug_handoff"
+          });
+        } catch {
+        }
+      }
       let resolvedBody;
       try {
         resolvedBody = resolveRequestBody(
@@ -1354,9 +1411,13 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
           options.dataStdin ?? false
         );
       } catch (err) {
-        console.error(
-          err instanceof Error ? err.message : "Failed to read request body"
-        );
+        const message = err instanceof Error ? err.message : "Failed to read request body";
+        analyticsService.capture("fetch_error", {
+          cliErrorClass: /exceeds the .* byte limit/.test(message) ? "payload_too_large" : "schema_validation_failed",
+          url: redactUrl(resolvedUrl),
+          error: truncateError(message)
+        });
+        console.error(message);
         process.exitCode = 1;
         return;
       }
@@ -1373,7 +1434,7 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
         (k) => k.toLowerCase() === "content-type"
       );
       if (resolvedBody && !hasContentType) {
-        headers["content-type"] = Buffer.isBuffer(resolvedBody) ? "application/octet-stream" : "application/json";
+        headers["content-type"] = Buffer.isBuffer(resolvedBody) ? sniffJsonShape(resolvedBody) ? "application/json" : "application/octet-stream" : "application/json";
       }
       const log = (msg) => console.error(`  ${msg}`);
       const method = options.method ? options.method.toUpperCase() : resolvedMethodFromCapability && !resolvedBody ? resolvedMethodFromCapability.toUpperCase() : resolvedBody ? "POST" : "GET";
@@ -1382,12 +1443,21 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
         headers,
         body: resolvedBody
       };
-      const lastSearch = stateService.loadLastSearch();
-      const matchedCapability = lastSearch?.capabilities.find(
-        (c) => resolvedUrl.startsWith(c.url)
-      );
-      const capabilityId = options.capability ?? matchedCapability?.id ?? null;
-      const searchId = matchedCapability ? lastSearch?.searchId : void 0;
+      const explicitCapabilityCtx = options.capability ? stateService.findSearchContextByCapability(options.capability) : null;
+      const urlCtx = stateService.findSearchContextByUrl(resolvedUrl, {
+        matchTemplate: (template) => {
+          try {
+            return urlMatchesTemplate(resolvedUrl, template);
+          } catch {
+            return false;
+          }
+        }
+      });
+      const matchCtx = explicitCapabilityCtx ?? urlCtx;
+      const capabilityId = options.capability ?? matchCtx?.capabilityId ?? null;
+      const searchId = matchCtx?.searchId;
+      const resultRank = matchCtx?.resultRank;
+      const matchedDisplayCostAmount = matchCtx?.displayCostAmount;
       const skipReasons = [];
       if (!apiService.walletAddress) {
         skipReasons.push(
@@ -1398,6 +1468,19 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
         skipReasons.push(
           "no capability resolved \u2014 pass --capability <uid|slug> or run `zero search` first so the URL can be matched"
         );
+        if (!options.capability) {
+          const lastSearch = stateService.loadLastSearch();
+          const cached = lastSearch?.capabilities ?? [];
+          analyticsService.capture("capability_resolution_missed", {
+            url: redactUrl(resolvedUrl),
+            method,
+            hasLastSearch: lastSearch !== null,
+            lastSearchSize: cached.length,
+            lastSearchHasTemplates: cached.some(
+              (c) => Boolean(c.urlTemplate)
+            )
+          });
+        }
       }
       let finalResponse;
       let bodyBytes;
@@ -1420,7 +1503,7 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
             paymentReq,
             options.maxPay,
             log,
-            matchedCapability?.displayCostAmount
+            matchedDisplayCostAmount
           );
           finalResponse = result.response;
           paymentMeta = {
@@ -1517,6 +1600,15 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
         } catch {
         }
       }
+      const status = finalResponse?.status;
+      const isFailure = !finalResponse || typeof status === "number" && (status < 200 || status >= 300);
+      let errorSnippetHash;
+      let errorSnippetLength;
+      if (isFailure && body && !bodyIsBinary) {
+        const snippet = body.slice(0, 500);
+        errorSnippetHash = createHash3("sha256").update(snippet).digest("hex");
+        errorSnippetLength = snippet.length;
+      }
       let runId = null;
       if (capabilityId && apiService.walletAddress) {
         let requestSchema;
@@ -1541,6 +1633,8 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
             latencyMs,
             requestSchema,
             responseSchema,
+            errorSnippetHash,
+            errorSnippetLength,
             ...paymentMeta && {
               costAmount: paymentMeta.amount,
               costAsset: paymentMeta.asset,
@@ -1557,7 +1651,6 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
           );
         }
       }
-      const status = finalResponse?.status;
       const outcome = !finalResponse ? "network_error" : status === 402 && !paymentMeta ? "payment_failed" : status !== void 0 && status >= 400 && status !== 402 ? "server_error" : "success";
       analyticsService.capture("fetch_executed", {
         url: redactUrl(resolvedUrl),
@@ -1569,10 +1662,26 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
         paymentAmount: paymentMeta?.amount,
         capabilityId: capabilityId ?? void 0,
         searchId: searchId ?? void 0,
+        resultRank: resultRank ?? void 0,
         runId: runId ?? void 0,
         runTracked: !!runId,
         ...fetchError && { error: truncateError(fetchError.message) }
       });
+      const isFetchFailure = Boolean(fetchError) || !finalResponse || typeof status === "number" && (status < 200 || status >= 300);
+      if (isFetchFailure) {
+        const cliErrorClass = fetchError || !finalResponse ? "network" : !apiService.walletAddress ? "auth_missing" : "unknown";
+        analyticsService.capture("fetch_error", {
+          cliErrorClass,
+          capabilityId: capabilityId ?? void 0,
+          searchId: searchId ?? void 0,
+          resultRank: resultRank ?? void 0,
+          url: redactUrl(resolvedUrl),
+          error: truncateError(
+            fetchError?.message ?? skipReasons.join("; ")
+          ),
+          skippedRun: !runId && skipReasons.length > 0
+        });
+      }
       if (fetchError && !options.json) {
         console.error(`  Fetch failed: ${fetchError.message}`);
       }
@@ -1639,7 +1748,16 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
         process.exitCode = 1;
       }
     } catch (err) {
-      console.error(err instanceof Error ? err.message : "Fetch failed");
+      const message = err instanceof Error ? err.message : "Fetch failed";
+      try {
+        appContext.services.analyticsService.capture("fetch_error", {
+          cliErrorClass: "unknown",
+          url: url ? redactUrl(url) : "unknown",
+          error: truncateError(message)
+        });
+      } catch {
+      }
+      console.error(message);
       process.exitCode = 1;
     }
   }
@@ -1647,10 +1765,6 @@ var fetchCommand = (appContext) => new Command3("fetch").description(
 
 // src/commands/get-command.ts
 import { Command as Command4 } from "commander";
-var formatReviewCount = (count) => {
-  if (count >= 1e3) return `${(count / 1e3).toFixed(1)}k`;
-  return count.toString();
-};
 var formatRelativeTimestamp = (iso) => {
   if (!iso) return "never";
   const then = new Date(iso).getTime();
@@ -1667,16 +1781,6 @@ var formatRelativeTimestamp = (iso) => {
   if (diffMo < 12) return `${diffMo}mo ago`;
   return `${Math.round(diffMo / 12)}y ago`;
 };
-var formatTrustScore = (capability) => {
-  if (capability.trustScore != null) {
-    return `Trust Score: ${capability.trustScore}/100`;
-  }
-  return "Trust Score: --";
-};
-var formatTrustComponent = (label, value) => {
-  const display = value != null ? `${value}/100` : "--";
-  return `    ${label.padEnd(22)}${display}`;
-};
 var centsToDollars = (cents) => {
   const value = Number.parseFloat(cents) / 100;
   if (value < 0.01) return value.toFixed(4);
@@ -1701,6 +1805,10 @@ var formatCost = (capability) => {
   }
   return lines;
 };
+var formatReviewCount = (count) => {
+  if (count >= 1e3) return `${(count / 1e3).toFixed(1)}k`;
+  return count.toString();
+};
 var formatRating = (rating) => {
   if (rating.state === "unrated") return "unrated";
   const successPct = `${Math.round(Number.parseFloat(rating.successRate) * 100)}%`;
@@ -1787,29 +1895,8 @@ var buildTryItExample = (capability) => {
 var formatCapability = (capability) => {
   const lines = [];
   lines.push(capability.name);
-  lines.push(`  ${formatTrustScore(capability)}`);
-  if (capability.trustComponents) {
-    lines.push(
-      formatTrustComponent(
-        "API Quality:",
-        capability.trustComponents.apiQuality
-      )
-    );
-    lines.push(
-      formatTrustComponent(
-        "Blockchain Activity:",
-        capability.trustComponents.blockchainActivity
-      )
-    );
-    lines.push(
-      formatTrustComponent(
-        "Performance:",
-        capability.trustComponents.performance
-      )
-    );
-  }
   lines.push(`  Rating: ${formatRating(capability.rating)}`);
-  lines.push(`  Status: ${capability.availabilityStatus ?? "unknown"}`);
+  lines.push(`  Status: ${capability.displayStatus ?? "unknown"}`);
   lines.push(...formatCost(capability));
   lines.push(`  URL: ${capability.url}`);
   lines.push(`  Method: ${capability.method}`);
@@ -1824,7 +1911,7 @@ var getCommand = (appContext) => new Command4("get").description(
 ).argument(
   "<identifier>",
   "Position number from search results, or a capability slug"
-).option("--formatted", "Output formatted trust breakdown").option(
+).option("--formatted", "Output formatted capability details").option(
   "--agent <name>",
   "Identify your agent host for this invocation. Overrides auto-detect for this call only."
 ).action(async (identifier, options) => {
@@ -1855,6 +1942,8 @@ var getCommand = (appContext) => new Command4("get").description(
       searchId = lastSearch.searchId;
     } else {
       capabilityId = identifier;
+      const ctx = stateService.findSearchContextByCapability(identifier);
+      if (ctx) searchId = ctx.searchId;
     }
     const capability = await apiService.getCapability(
       capabilityId,
@@ -1878,7 +1967,7 @@ var getCommand = (appContext) => new Command4("get").description(
 });
 
 // src/commands/init-command.ts
-import { createHash as createHash3 } from "crypto";
+import { createHash as createHash4 } from "crypto";
 import {
   chmodSync as chmodSync2,
   existsSync as existsSync2,
@@ -1952,10 +2041,12 @@ var color = {
   magenta: (s) => wrap("35", s),
   green: (s) => wrap("32", s),
   yellow: (s) => wrap("33", s),
+  red: (s) => wrap("31", s),
   gray: (s) => wrap("90", s),
   boldCyan: (s) => wrap("1;36", s),
   boldMagenta: (s) => wrap("1;35", s),
-  boldGreen: (s) => wrap("1;32", s)
+  boldGreen: (s) => wrap("1;32", s),
+  boldRed: (s) => wrap("1;31", s)
 };
 var printZeroBanner = () => {
   console.log("");
@@ -1998,12 +2089,16 @@ var printReadyFooter = () => {
   const lines = [
     "",
     `  ${color.boldGreen("Zero is ready!")} Zero works best with an AI agent.`,
-    "  Open Claude Code, Codex, Cursor, Blackbox, or your agent of choice",
-    "  and try one of these commands to get started:",
+    `  Open ${color.boldRed("Claude Code")}, Codex, Cursor, Blackbox, or your agent of choice`,
+    "  and try this prompt to get started:",
     "",
-    `    ${color.cyan('zero search "translate text to Spanish"')}`,
-    `    ${color.cyan('zero search "generate an image"')}`,
-    `    ${color.cyan('zero search "weather forecast"')}`,
+    `    ${color.cyan("What is zero and how do I use it?")}`,
+    "",
+    "  You can also just tell your agent examples of what you are trying to do:",
+    "",
+    `    ${color.cyan("Can you use zero to deploy an NYC weather website")}`,
+    `    ${color.cyan("Email me an image of a crystalline rocket ship with zero")}`,
+    `    ${color.cyan("Create a demo video with real voiceover for my project using zero")}`,
     "",
     `  ${color.dim("By using Zero, you agree to our Terms of Service:")}`,
     `    ${color.dim("https://zero.xyz/terms-of-service")}`,
@@ -2059,7 +2154,7 @@ var getCliModuleDir = () => {
   }
   return __dirname;
 };
-var sha256File = (filePath) => createHash3("sha256").update(readFileSync4(filePath)).digest("hex");
+var sha256File = (filePath) => createHash4("sha256").update(readFileSync4(filePath)).digest("hex");
 var verifyFileCopy = (src, dest) => {
   if (!existsSync2(dest)) return false;
   return sha256File(src) === sha256File(dest);
@@ -2786,7 +2881,7 @@ var formatReviewCount2 = (count) => {
   return count.toString();
 };
 var formatRatingBadge = (rating) => {
-  if (rating.state === "unrated") return "\u2014 unrated";
+  if (rating.state === "unrated") return "unrated";
   const successPct = `${Math.round(Number.parseFloat(rating.successRate) * 100)}%`;
   const reviews = formatReviewCount2(rating.reviews);
   if (rating.stars) {
@@ -2794,13 +2889,7 @@ var formatRatingBadge = (rating) => {
   }
   return `${successPct} success \xB7 ${reviews} reviews`;
 };
-var formatTrustBadge = (item) => {
-  if (item.trustScore != null) {
-    return `Trust: ${item.trustScore}`;
-  }
-  return "Trust: --";
-};
-var formatHealthBadge = (status) => {
+var formatStatusBadge = (status) => {
   if (!status || status === "unknown") return "";
   return ` \u2014 ${status}`;
 };
@@ -2810,21 +2899,19 @@ var formatSearchResults = (results) => {
     const baseName = r.canonicalName ?? r.name;
     const displayName = r.brandName ? `${r.brandName} ${baseName}` : baseName;
     const displayDescription = r.whatItDoes ?? r.description;
-    const trustBadge = formatTrustBadge(r);
     const ratingBadge = formatRatingBadge(r.rating);
-    const healthBadge = formatHealthBadge(r.availabilityStatus);
-    const relevance = r.relevanceScore != null ? ` [${r.relevanceScore.toFixed(3)}]` : "";
-    return `  ${r.position}. ${displayName} \u2014 $${r.cost.amount}/call \u2014 ${trustBadge} \u2014 ${ratingBadge}${healthBadge}${relevance}
+    const statusBadge = formatStatusBadge(r.displayStatus);
+    return `  ${r.position}. ${displayName} \u2014 $${r.cost.amount}/call \u2014 ${ratingBadge}${statusBadge}
      "${displayDescription}"`;
   }).join("\n");
 };
 var searchCommand = (appContext) => new Command8("search").description("Search for capabilities").argument("<query>", "Search query").option("--json", "Output raw JSON to stdout").option("--offset <n>", "Pagination offset", Number).option("--limit <n>", "Results per page", Number).option("--free", "Only show free capabilities").option(
   "--max-cost <amount>",
   `Maximum cost per call in USD (default: ${DEFAULT_MAX_COST_USD})`
-).option("--min-rating <stars>", "Minimum star rating (1-5)", Number).option("--protocol <protocol>", "Payment protocol (x402 or mpp)").option("--min-trust <n>", "Minimum trust score (0-100)", Number).option(
+).option("--protocol <protocol>", "Payment protocol (x402 or mpp)").option(
   "--status <status>",
   "Filter by availability (healthy, degraded, down)"
-).option("--all", "Show all results (no trust or health filtering)").option(
+).option("--all", "Disable default quality filtering").option(
   "--source <source>",
   "Only show results from this crawl source (e.g. mpp, bazaar)"
 ).option(
@@ -2864,9 +2951,7 @@ var searchCommand = (appContext) => new Command8("search").description("Search f
         limit: options.limit,
         freeOnly: options.free,
         maxCost: effectiveMaxCost,
-        minRating: options.minRating,
         protocol: options.protocol,
-        minTrust: options.minTrust,
         availabilityStatus: options.status,
         includeAll: options.all,
         source: options.source,
@@ -2884,9 +2969,7 @@ var searchCommand = (appContext) => new Command8("search").description("Search f
         freeOnly: options.free ?? false,
         maxCost: effectiveMaxCost,
         maxCostDefaulted: appliedDefaultMaxCost,
-        minRating: options.minRating,
         protocol: options.protocol,
-        minTrust: options.minTrust,
         availabilityStatus: options.status,
         includeAll: options.all ?? false,
         source: options.source,
@@ -2913,6 +2996,7 @@ var searchCommand = (appContext) => new Command8("search").description("Search f
           position: c.position,
           id: c.id,
           url: c.url,
+          urlTemplate: c.urlTemplate ?? null,
           displayCostAmount: c.cost.amount
         }))
       });
@@ -3287,7 +3371,11 @@ var AnalyticsService = class {
     this.posthog = new PostHog(POSTHOG_API_KEY, {
       host: POSTHOG_HOST,
       flushAt: 1,
-      flushInterval: 0
+      flushInterval: 0,
+      // Vitest spins up many AnalyticsService instances per process; each
+      // autocapture listener adds to process.{uncaughtException,unhandledRejection}
+      // and trips Node's MaxListeners warning. Real CLI is one instance per process.
+      enableExceptionAutocapture: !process.env.VITEST
     });
     this.posthog.on("error", () => {
     });
@@ -3346,6 +3434,22 @@ var AnalyticsService = class {
       }
     });
   }
+  captureException(error, properties) {
+    if (!this.posthog) return;
+    this.posthog.captureException(error, this.distinctId, {
+      source: "cli",
+      // biome-ignore lint/style/useNamingConvention: snake_case for analytics
+      cli_version: this.cliVersion,
+      environment: this.environment,
+      // biome-ignore lint/style/useNamingConvention: snake_case for analytics
+      wallet_address: this.walletAddress,
+      // biome-ignore lint/style/useNamingConvention: snake_case for analytics
+      request_id: this.requestId,
+      // biome-ignore lint/style/useNamingConvention: snake_case for analytics
+      agent_host: this.agentHost,
+      ...properties
+    });
+  }
   async shutdown() {
     if (!this.posthog) return;
     try {
@@ -3358,15 +3462,27 @@ var AnalyticsService = class {
 // src/services/state-service.ts
 import { existsSync as existsSync6, mkdirSync as mkdirSync5, readFileSync as readFileSync9, writeFileSync as writeFileSync5 } from "fs";
 import { join as join5 } from "path";
+var RECENT_SEARCH_LIMIT = 10;
 var StateService = class {
   constructor(zeroDir) {
     this.zeroDir = zeroDir;
     this.lastSearchPath = join5(zeroDir, "last_search.json");
+    this.recentSearchesPath = join5(zeroDir, "recent_searches.json");
   }
   lastSearchPath;
+  recentSearchesPath;
   saveLastSearch = (data) => {
     mkdirSync5(this.zeroDir, { recursive: true });
     writeFileSync5(this.lastSearchPath, JSON.stringify(data, null, 2));
+    const recent = this.loadRecentSearches();
+    const filtered = recent.searches.filter(
+      (s) => s.searchId !== data.searchId
+    );
+    const next = [data, ...filtered].slice(0, RECENT_SEARCH_LIMIT);
+    writeFileSync5(
+      this.recentSearchesPath,
+      JSON.stringify({ searches: next }, null, 2)
+    );
   };
   loadLastSearch = () => {
     try {
@@ -3377,6 +3493,63 @@ var StateService = class {
       return null;
     }
   };
+  loadRecentSearches = () => {
+    try {
+      if (!existsSync6(this.recentSearchesPath)) {
+        const last = this.loadLastSearch();
+        return { searches: last ? [last] : [] };
+      }
+      const raw = readFileSync9(this.recentSearchesPath, "utf8");
+      const parsed = JSON.parse(raw);
+      return { searches: parsed.searches ?? [] };
+    } catch {
+      return { searches: [] };
+    }
+  };
+  // Walk recent searches newest-first, returning the first one whose
+  // results contain `capabilityId` (uid or slug match). Preferred over
+  // "loadLastSearch" for attributing rank — handles the parallel-search
+  // case where the most recent search isn't the one being fetched.
+  findSearchContextByCapability = (capabilityId) => {
+    const recent = this.loadRecentSearches();
+    for (const search of recent.searches) {
+      const entry = search.capabilities.find((c) => c.id === capabilityId);
+      if (entry) {
+        return {
+          searchId: search.searchId,
+          resultRank: entry.position,
+          capabilityId: entry.id,
+          url: entry.url,
+          displayCostAmount: entry.displayCostAmount
+        };
+      }
+    }
+    return null;
+  };
+  // URL-based attribution for `zero fetch <url>`. Matches by URL prefix
+  // (some capabilities accept query params or path tails the agent appends)
+  // across the recent ring, newest match wins. Falls back to a caller-
+  // supplied urlTemplate matcher (ADS-509 path-parameterized URLs).
+  findSearchContextByUrl = (url, options) => {
+    const recent = this.loadRecentSearches();
+    for (const search of recent.searches) {
+      const prefixHit = search.capabilities.find((c) => url.startsWith(c.url));
+      const templateHit = prefixHit ?? search.capabilities.find(
+        (c) => c.urlTemplate && options?.matchTemplate ? options.matchTemplate(c.urlTemplate) : false
+      );
+      const entry = templateHit;
+      if (entry) {
+        return {
+          searchId: search.searchId,
+          resultRank: entry.position,
+          capabilityId: entry.id,
+          url: entry.url,
+          displayCostAmount: entry.displayCostAmount
+        };
+      }
+    }
+    return null;
+  };
 };
 
 // src/services/wallet-service.ts
@@ -3483,6 +3656,155 @@ var createAppContext = () => {
   };
 };
 
+// src/util/update-check.ts
+import {
+  existsSync as existsSync8,
+  lstatSync,
+  mkdirSync as mkdirSync6,
+  readFileSync as readFileSync11,
+  readlinkSync,
+  writeFileSync as writeFileSync6
+} from "fs";
+import { homedir as homedir6 } from "os";
+import { dirname as dirname3, join as join7, resolve } from "path";
+var CACHE_FILENAME = "update_check.json";
+var NPM_REGISTRY_URL = "https://registry.npmjs.org/@zeroxyz/cli/latest";
+var CHECK_INTERVAL_MS = 60 * 60 * 1e3;
+var FETCH_TIMEOUT_MS = 3e3;
+var emptyCache = {
+  lastCheckedMs: 0,
+  latestVersion: null,
+  lastShownMs: 0
+};
+var resolveExecPath = (execPath) => {
+  try {
+    const stat = lstatSync(execPath);
+    if (stat.isSymbolicLink()) {
+      const target = readlinkSync(execPath);
+      return resolve(dirname3(execPath), target);
+    }
+  } catch {
+  }
+  return execPath;
+};
+var detectInstallMethod = (opts = {}) => {
+  const execPath = opts.execPath ?? process.execPath;
+  const pkg = opts.pkg ?? process.pkg;
+  const home = opts.home ?? homedir6();
+  if (pkg) return "binary";
+  const resolved = resolveExecPath(execPath);
+  const zeroBin = join7(home, ".zero", "bin");
+  if (resolved.startsWith(zeroBin)) return "binary";
+  return "npm";
+};
+var compareVersions = (a, b) => {
+  const parse = (v) => {
+    const dashIdx = v.indexOf("-");
+    const base2 = dashIdx === -1 ? v : v.slice(0, dashIdx);
+    const pre = dashIdx === -1 ? null : v.slice(dashIdx + 1);
+    const nums = base2.split(".").map((n) => Number.parseInt(n, 10) || 0);
+    while (nums.length < 3) nums.push(0);
+    return { nums, pre };
+  };
+  const pa = parse(a);
+  const pb = parse(b);
+  for (let i = 0; i < 3; i++) {
+    const na = pa.nums[i] ?? 0;
+    const nb = pb.nums[i] ?? 0;
+    if (na !== nb) return na - nb;
+  }
+  if (pa.pre === pb.pre) return 0;
+  if (pa.pre === null) return 1;
+  if (pb.pre === null) return -1;
+  return pa.pre < pb.pre ? -1 : 1;
+};
+var cachePath = (zeroDir) => join7(zeroDir, CACHE_FILENAME);
+var readCache = (zeroDir) => {
+  try {
+    const path = cachePath(zeroDir);
+    if (!existsSync8(path)) return emptyCache;
+    const raw = readFileSync11(path, "utf8");
+    const parsed = JSON.parse(raw);
+    return {
+      lastCheckedMs: typeof parsed.lastCheckedMs === "number" ? parsed.lastCheckedMs : 0,
+      latestVersion: typeof parsed.latestVersion === "string" ? parsed.latestVersion : null,
+      lastShownMs: typeof parsed.lastShownMs === "number" ? parsed.lastShownMs : 0
+    };
+  } catch {
+    return emptyCache;
+  }
+};
+var writeCache = (zeroDir, cache) => {
+  try {
+    mkdirSync6(zeroDir, { recursive: true });
+    writeFileSync6(cachePath(zeroDir), JSON.stringify(cache, null, 2));
+  } catch {
+  }
+};
+var fetchLatestVersion = async (url = NPM_REGISTRY_URL) => {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    const response = await fetch(url, {
+      signal: controller.signal,
+      headers: { accept: "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!response.ok) return null;
+    const json = await response.json();
+    return typeof json.version === "string" ? json.version : null;
+  } catch {
+    return null;
+  }
+};
+var refreshUpdateCache = async (zeroDir, opts = {}) => {
+  const now = opts.now ?? Date.now();
+  const fetcher = opts.fetchLatest ?? fetchLatestVersion;
+  const cache = readCache(zeroDir);
+  if (cache.lastCheckedMs > 0 && now - cache.lastCheckedMs < CHECK_INTERVAL_MS) {
+    return;
+  }
+  const latest = await fetcher();
+  if (!latest) {
+    writeCache(zeroDir, { ...cache, lastCheckedMs: now });
+    return;
+  }
+  writeCache(zeroDir, {
+    ...cache,
+    lastCheckedMs: now,
+    latestVersion: latest
+  });
+};
+var updateCommandFor = (method) => method === "binary" ? "curl -fsSL https://zero.xyz/install.sh | bash" : "npm install -g @zeroxyz/cli";
+var formatBanner = (currentVersion, latestVersion, method) => {
+  const arrow = `${currentVersion} \u2192 ${latestVersion}`;
+  const cmd = updateCommandFor(method);
+  const lines = [
+    "",
+    `  ${color.yellow("\u26A1 Update available")}  ${color.dim(arrow)}`,
+    `  ${color.dim("Run:")} ${color.cyan(cmd)}`,
+    ""
+  ];
+  return lines.join("\n");
+};
+var consumeBannerIfDue = (zeroDir, currentVersion, opts = {}) => {
+  const now = opts.now ?? Date.now();
+  const method = opts.method ?? detectInstallMethod();
+  const cache = readCache(zeroDir);
+  if (!cache.latestVersion) return null;
+  if (compareVersions(currentVersion, cache.latestVersion) >= 0) return null;
+  if (cache.lastShownMs > 0 && now - cache.lastShownMs < CHECK_INTERVAL_MS) {
+    return null;
+  }
+  writeCache(zeroDir, { ...cache, lastShownMs: now });
+  return formatBanner(currentVersion, cache.latestVersion, method);
+};
+var maybePrintUpdateBanner = (zeroDir, currentVersion) => {
+  if (!process.stderr.isTTY) return;
+  const banner = consumeBannerIfDue(zeroDir, currentVersion);
+  if (banner) process.stderr.write(banner);
+};
+
 // src/index.ts
 var main = async () => {
   const appContext = createAppContext();
@@ -3490,6 +3812,8 @@ var main = async () => {
     console.error("Failed to create app context");
     process.exit(1);
   }
+  const zeroDir = join8(homedir7(), ".zero");
+  maybePrintUpdateBanner(zeroDir, package_default.version);
   const app = createApp(appContext);
   let caughtError = null;
   try {
@@ -3500,6 +3824,9 @@ var main = async () => {
       caughtError = err instanceof Error ? err : new Error(String(err));
       console.error(caughtError.message);
       process.exitCode = 1;
+      appContext.services.analyticsService.captureException(caughtError, {
+        command: appContext.invocation.current?.command
+      });
     }
   } finally {
     const invocation = appContext.invocation.current;
@@ -3513,6 +3840,7 @@ var main = async () => {
       });
     }
     await appContext.services.analyticsService.shutdown();
+    await refreshUpdateCache(zeroDir);
   }
 };
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zeroxyz/cli",
-	"version": "0.0.34",
+	"version": "0.0.37",
 	"type": "module",
 	"bin": {
 		"zero": "dist/index.js",
@@ -16,7 +16,7 @@
 	},
 	"scripts": {
 		"build": "tsup src/index.ts --format esm --out-dir dist --clean",
-		"build:binary": "tsup --config tsup.binary.ts && cp -r skills hooks dist/pkg/ && pnpm exec pkg dist/pkg/index.cjs --config pkg.json --targets node24-macos-arm64,node24-macos-x64,node24-linux-x64 --output dist/bin/zero",
+		"build:binary": "tsup --config tsup.binary.ts && cp -r skills hooks dist/pkg/ && pnpm exec pkg dist/pkg/index.cjs --config pkg.json --targets node24-macos-arm64,node24-macos-x64,node24-linux-x64,node24-linux-arm64 --output dist/bin/zero",
 		"prepublishOnly": "pnpm run build",
 		"dev": "ZERO_ENV=development tsx src/index.ts",
 		"cli": "ZERO_ENV=development ZERO_API_URL=http://localhost:1111 tsx src/index.ts",
@@ -34,7 +34,7 @@
 		"@x402/extensions": "^2.9.0",
 		"@x402/fetch": "^2.9.0",
 		"commander": "^13.0.0",
-		"mppx": "^0.5.9",
+		"mppx": "^0.6.9",
 		"open": "^11.0.0",
 		"posthog-node": "^5.29.2",
 		"viem": "^2.47.10",

package/skills/zero/SKILL.md

@@ -98,13 +98,16 @@ zero review --capability <slug> --success --accuracy <1-5> --value <1-5> --relia
 
 ### Workflow
 
-1. **Search** — `zero search "weather forecast"` finds matching capabilities. Results show name, cost, rating, and success rate.
+1. **Search** — `zero search "weather forecast"` finds matching capabilities. Results show ranked capabilities with name, cost, availability, and a short description.
 > **Detail-page → CLI bridge.** When you only have a capability slug (e.g. copied from a zero.xyz capability page), `zero get <slug>` and `zero fetch --capability <slug>` both work as drop-in replacements for the position-based forms. You don't need to run `zero search` first.
 
 2. **Inspect** — `zero get 1 --formatted` prints a human summary **and a copy-pasteable `Try it:` command** wired to the capability's schema. Plain `zero get 1` returns full JSON (URL, method, `bodySchema`, examples, pricing) for `jq` pipelines. **If `bodySchema` is `null`**, the capability hasn't been schema-indexed yet — skip it and `zero get 2`, don't invent field names.
 3. **Call** — `zero fetch <url>` makes the request. If the server returns 402, payment is handled automatically (x402 and MPP, including cross-chain bridging from Base to Tempo).
 4. **Review** — `zero review <runId>` submits a quality review. Run IDs are printed to **stderr** after a successful fetch (or returned on stdout in `--json` mode). Always review after a paid call, and **pass `--content "<notes>"` whenever you have something specific to say** — the content line lands on the capability's public detail page on zero.xyz, so it's what the next human buyer (and the next agent) reads when deciding whether to call this capability. See "Writing review content" below.
 5. **Retroactive review** — if you lost a runId, run `zero runs --unreviewed` (or `zero runs --capability <slug> --unreviewed`). `zero review --capability <slug> ...` auto-resolves to your most recent un-reviewed run for that capability.
+6. **Revise a review** — re-running `zero review <runId> ...` for a run you've already reviewed **overwrites** your prior ratings and content (same wallet only). Use this when a retry succeeded, a result that looked good failed downstream, or you want to expand the notes after more usage. There's no separate edit command — same call, same runId.
+
+> **Only your latest review per capability is shown publicly.** When you've reviewed a capability across multiple runs, both the public detail page and the search-ranking math dedupe to your most recent review per capability — older reviews stay in the DB as a version trail but don't display and don't count toward the rating. So if your judgment has changed, submit a fresh review on a recent run (or edit the existing one via the same-`runId` upsert above) — don't assume the old review still represents you.
 
 ### Writing review content
 
@@ -118,6 +121,10 @@ zero review --capability <slug> --success --accuracy <1-5> --value <1-5> --relia
 
 Each names the task attempted, what the output actually was, and a specific observation (latency, a gotcha, a fit/misfit note). That's the kind of line a human buyer trusts and another agent can learn from.
 
+**Name the use case.** State the general type of work you were using the capability for (no private/proprietary detail) so other readers can tell whether their task fits. Examples: *"Used this to generate stock-style hero photography for a vibe-coded landing page"*, *"Called from a daily ETL to enrich new signups with company metadata"*, *"Translating short product blurbs (~80 chars) for a Spanish-language store"*. This is what makes a review useful for someone deciding whether to call the capability for *their* task — not just whether it worked for yours.
+
+**Two-part structure works well** when you have enough to say: lead with the human-facing half (use case, what you got, fit/misfit), then a second half with agent-facing technical notes (exact field names, gotchas, retry behavior, schema quirks). Each half is independently useful — humans skim the top, agents grep the bottom.
+
 **Review failures with content too.** Failure notes are arguably more valuable — they warn the next caller. Example: *"FLUX Schnell returned HTTP 500 Internal Server Error — paid 0.003 USDC via MPP but got no image."* Pair with `--no-success`.
 
 **Skip `--content` rather than write filler.** "Worked great", "Fast response", or test strings like "trial 1" add noise, pollute the capability's public page, and dilute the signal agents rely on. If you don't have a specific observation, just submit the numeric ratings.
@@ -231,7 +238,7 @@ cat payload.json | zero fetch https://api.example.com --data-stdin
 
 ### Rules
 
-- **Always `zero search` fresh, every time.** Never reuse a capability URL, slug, schema, or price from an earlier turn, prior conversation, training data, or memory. Capabilities churn constantly — endpoints go offline, prices change, schemas evolve, and rankings shift as reviews accumulate. A capability that worked yesterday may be dead, repriced, or outranked today. Searching again costs nothing and is the only way to get current trust scores and availability.
+- **Always `zero search` fresh, every time.** Never reuse a capability URL, slug, schema, or price from an earlier turn, prior conversation, training data, or memory. Capabilities churn constantly — endpoints go offline, prices change, schemas evolve, and rankings shift as reviews accumulate. A capability that worked yesterday may be dead, repriced, or outranked today. Searching again costs nothing and is the only way to get current ranking and availability.
 - **Always `zero get` before `zero fetch`.** Even if you "know" the URL, re-fetch the full details to confirm the URL, method, required headers, body schema, and current price. Do not reconstruct a fetch call from memory.
 - Never guess endpoint URLs or schemas.
 - Use `--max-pay` before potentially expensive requests.