@zeroxyz/cli 0.0.36 → 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

@@ -7,7 +7,7 @@ import { join as join8 } from "path";
 // package.json
 var package_default = {
   name: "@zeroxyz/cli",
-  version: "0.0.36",
+  version: "0.0.37",
   type: "module",
   bin: {
     zero: "dist/index.js",
@@ -23,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",
@@ -41,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",
@@ -72,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(),
@@ -83,17 +90,10 @@ var searchResultSchema = z.object({
   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(),
@@ -117,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(),
@@ -146,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()
@@ -1775,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();
@@ -1795,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);
@@ -1829,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)}%`;
@@ -1915,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}`);
@@ -1952,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) => {
@@ -2922,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) {
@@ -2930,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}`;
 };
@@ -2946,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(
@@ -3000,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,
@@ -3020,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,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zeroxyz/cli",
-	"version": "0.0.36",
+	"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.