knownfix 0.2.3 → 0.3.1

package/README.md

@@ -1,8 +1,8 @@
 # KnownFix
 
-Connect an AI agent to [KnownFix](https://b-hash88.github.io/knownfix/), a
-catalog of 35 real development-error fixes: 33 verified in production, 2
-documented, and 10 available in full for free.
+Connect an AI agent to [KnownFix](https://knownfix-backend-28.b-hash88.deno.net/),
+a catalog of 36 real development-error fixes: 33 verified in production, 3
+documented, and 11 available in full for free.
 
 ```bash
 npx knownfix search "your exact error"
@@ -25,23 +25,26 @@ bridge for clients without remote HTTP support.
 
 ## Buying safely
 
-Search and free samples require no account or API key. A paid fix or skill uses
-a one-hour signed bearer offer bound to one product and an offer-specific exact
-wei amount on Base mainnet:
+Search and free samples require no account or API key. A paid search result
+includes a free diagnosis preview, compatibility, dollar price, signed USDC and
+ETH offers, and one recommended redemption action. For direct checkout:
 
-1. Call the MCP `get_offer` tool with `productType` and `productId`.
+1. Call `get_offer` with `productType`, `productId`, and `currency` (`USDC` or
+   `ETH`), or use the offer already returned by `search_fixes`.
 2. Keep the returned `paymentOffer` token private.
-3. Send exactly `priceWei` to `payTo` on chain 8453.
+3. Use the signed Base Pay parameters for USDC or send exactly `priceWei` for
+   ETH on Base mainnet, chain 8453.
 4. Call `get_fix` or `get_skill` with both `paymentTx` and `paymentOffer`.
 
 The transaction and offer are atomically single-use. Inspect the public
 [books](https://knownfix-backend-28.b-hash88.deno.net/books) and
-[buyer-safety guide](https://b-hash88.github.io/knownfix/notes-for-agents.md)
-before paying.
+[agent-readable store guide](https://knownfix-backend-28.b-hash88.deno.net/llms.txt)
+before paying. The **npm Publishing Recovery Pack** bundles five fixes plus a
+current decision tree and release verification procedure for $4 USDC.
 
 ## Commands
 
-- `search "<error>"` — free ranked match and storefront link
+- `search "<error>"` — ranked match and purchase-ready checkout summary
 - `config <client>` — client-specific MCP configuration
 - `tools` — live MCP tool list
 - `books` — live request-to-sale funnel

package/index.mjs

@@ -16,12 +16,12 @@ const MCP_URL = `${REMOTE}/mcp`;
 const [cmd, ...rest] = process.argv.slice(2);
 
 const INTRO = `KnownFix — cataloged fixes for real errors, sold per-lookup to AI agents.
-Free to search; 35 fixes (33 verified in production, 2 documented), with 10 free
-in full. Paid fixes start near $0.08 on Base mainnet. No buyer account or API key.
-Paid redemption uses a private, product-bound signed offer. Test our claims first.
-
-Remote MCP server (Streamable HTTP): ${MCP_URL}
-Storefront + llms.txt:               ${REMOTE.includes("deno.net") ? "https://b-hash88.github.io/knownfix/" : REMOTE}
+Free to search; 36 fixes (33 verified in production, 3 documented), with 11 free
+in full. Paid fixes cost $0.05 USDC or signed exact ETH on Base mainnet. Search
+returns a diagnosis preview and purchase-ready offers. No buyer account or API key.
+
+Remote MCP server (Streamable HTTP): ${MCP_URL}
+Store guide + product catalog:       ${REMOTE}/llms.txt
 
 Commands:
   npx knownfix config <client>   MCP config snippet (claude | cursor | codex | vscode | langchain | crewai | raw)
@@ -131,7 +131,17 @@ async function main() {
     for (const m of out.matches) {
       console.log(`  ${m.id}  (${m.match ?? m.score}, ${m.confidence}${m.sample ? ", free" : ", paid"})`);
     }
-    console.log(`\nReview the top match: https://b-hash88.github.io/knownfix/fixes/${out.matches[0].id}.html`);
+    const top = out.matches[0];
+    const purchase = out.purchase;
+    if (purchase?.checkout === "ready") {
+      console.log(`\nLikely cause: ${purchase.diagnosisPreview?.likelyCause || "A stocked failure mode matches this signature."}`);
+      console.log(`Price: ${purchase.price?.usd || "$0.05"} ${purchase.price?.currency || "USD"}`);
+      console.log("Next: connect the MCP server and use the private purchase object from search_fixes, or call get_offer.");
+      console.log("The signed paymentOffer is intentionally not printed by this CLI.");
+    } else if (out.topMatchTier === "free-sample") {
+      console.log("\nThe complete free fix is included in the MCP search result.");
+    }
+    console.log(`\nMachine-readable store guide: ${REMOTE}/llms.txt`);
     return;
   }
 
@@ -143,7 +153,7 @@ async function main() {
     const { ListToolsRequestSchema, CallToolRequestSchema } = await import(
       "@modelcontextprotocol/sdk/types.js"
     );
-    const server = new Server({ name: "knownfix-bridge", version: "0.2.3" }, { capabilities: { tools: {} } });
+    const server = new Server({ name: "knownfix-bridge", version: "0.3.1" }, { capabilities: { tools: {} } });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: (await rpc("tools/list")).tools }));
     server.setRequestHandler(CallToolRequestSchema, async (req) =>
       rpc("tools/call", { name: req.params.name, arguments: req.params.arguments ?? {} })

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "knownfix",
-  "version": "0.2.3",
-  "description": "MCP storefront for 35 cataloged dev-error fixes: free search, 10 full free fixes, signed product-bound offers, and Base-mainnet settlement. Works with Claude, Cursor, Codex, VS Code, LangChain, and CrewAI.",
+  "version": "0.3.1",
+  "description": "MCP storefront for 36 dev-error fixes: purchase-ready search, 11 free fixes, signed USDC or ETH offers, and premium recovery packs on Base.",
   "type": "module",
   "bin": { "knownfix": "index.mjs" },
   "mcpName": "io.github.b-hash88/knownfix",
@@ -22,7 +22,7 @@
     "knownfix",
     "agent-commerce"
   ],
-  "homepage": "https://b-hash88.github.io/knownfix/",
+  "homepage": "https://knownfix-backend-28.b-hash88.deno.net/",
   "repository": { "type": "git", "url": "git+https://github.com/b-hash88/knownfix.git" },
   "license": "MIT",
   "engines": { "node": ">=18" },