@jeffreyjyz/mpc 0.1.6 → 0.1.9

package/README.md

@@ -25,6 +25,15 @@ bun link
 mpc --help
 ```
 
+Working on the CLI itself? `bun run dev:link` points `mpcdev` at this checkout, so the
+published `mpc` keeps running the installed release while `mpcdev` runs your edits:
+
+```sh
+bun run dev:link
+mpcdev --version    # this checkout
+mpc --version       # the published install
+```
+
 ## Usage
 
 ```sh

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jeffreyjyz/mpc",
-	"version": "0.1.6",
+	"version": "0.1.9",
 	"description": "Compare model pricing across opencode Go and Command Code plans",
 	"license": "MIT",
 	"type": "module",
@@ -22,7 +22,8 @@
 		"start": "bun run src/index.ts",
 		"test": "bun test",
 		"lint": "biome lint --write .",
-		"typecheck": "bun check"
+		"typecheck": "bun check",
+		"dev:link": "ln -sfn \"$PWD/src/index.ts\" \"$HOME/.bun/bin/mpcdev\""
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.5.13",

package/src/cli/engine/score.ts

@@ -76,19 +76,19 @@ export function assignValueIndex(metrics: EntryMetrics[], config: ScoreConfig):
 	const byAbility = of(scored, ability);
 	const bySpeed = of(speeded, speed);
 
-	// Unpriced models have unlimited requests, so they sit at the top of the
-	// scale and stay out of the range below.
+	// Unlimited requests win the volume term outright — you cannot buy more than
+	// infinite — but the model still enters the composite, so a free model with a
+	// low ability no longer outranks everything by virtue of being free.
+	const volumeTerm = (m: EntryMetrics) =>
+		Number.isFinite(m.requestsPerMonth) ? (byVolume.get(m) ?? 0.5) : 1;
+
 	const composites = new Map<EntryMetrics, number>();
 	for (const m of scored) {
-		if (!Number.isFinite(m.requestsPerMonth)) {
-			m.valueIndex = 100;
-			continue;
-		}
 		composites.set(
 			m,
 			100 * (wAbility ?? 0) * (byAbility.get(m) ?? 0.5) +
 				100 * (wTps ?? 0) * (bySpeed.get(m) ?? 0.5) +
-				100 * (wVolume ?? 0) * (byVolume.get(m) ?? 0.5) +
+				100 * (wVolume ?? 0) * volumeTerm(m) +
 				100 * (wCache ?? 0) * (1 - (byCache.get(m) ?? 0.5)) +
 				100 * (wOutput ?? 0) * (1 - (byOutput.get(m) ?? 0.5)),
 		);

package/src/constants/data.ts

@@ -13,6 +13,13 @@ export const ALIASES: Record<string, string> = {
 	// CommandCode prefixes these with "Tencent"; OpenCode Go does not.
 	tencenthy3: "hy3",
 	tencenthy4preview: "hy4preview",
+	// AA's slug keeps the vendor the catalogs drop: "tencent-hy4", "reflection-beam".
+	tencenthy4: "hy4",
+	reflectionbeam: "beam10",
+	// AA suffixes the bake date onto the slug: "mimo-v2-5-0424".
+	mimov250424: "mimov25",
+	// CommandCode lists the same Jev build twice, once with its version suffix.
+	jev1140: "jev",
 	// CommandCode writes "(exp)"; OpenCode Go writes "-exp".
 	deepseekv4flashvision: "deepseekv4flashvisionexp",
 	// Alibaba's "Qwen3.8-Flash-Next" is the release name of the model

package/src/constants/sources.ts

@@ -79,7 +79,10 @@ export const DEFAULT_OC_PLAN = "go";
 export const DOC_URL = "https://opencode.ai/v2/docs/console/go/";
 export const OC_MODELS_URL = "https://opencode.ai/zen/go/v1/models";
 
-export const API_URL = "https://artificialanalysis.ai/api/v2/data/llms/models";
+/** Artificial Analysis retired `/api/v2/data/*` on 2026-11-04 (410 Gone). The free
+ * tier serves the same index and median output speed mpc reads, so no Pro plan
+ * is needed; the paid list at `/api/v2/language/models` answers 403 without one. */
+export const API_URL = "https://artificialanalysis.ai/api/v2/language/models/free";
 export const AA_MODELS_URL = "https://artificialanalysis.ai/models";
 
 // CommandCode only publishes Intelligence and Tok/s on the GOAT/Pro catalogs.

package/src/constants/view.ts

@@ -100,7 +100,10 @@ export const LEGEND: [string, string][] = [
 	["ability", "benchmark score for the model (source above)"],
 	["tps", "output tokens per second (source above)"],
 	["COST", "0-100 volume index: requests/mo, lower is better (no ability)"],
-	["VAL", "0-100 ability-aware value: ability + speed + volume + cache + output"],
+	[
+		"VAL",
+		"0-100 ability-aware value: ability + speed + volume + cache + output · a free row wins volume only, so it can post COST 0 and a mid VAL",
+	],
 ];
 
 export const CSV_HEADER = [

package/src/data/sources/aa/api.ts

@@ -26,13 +26,23 @@ async function fetchTextWithKey(url: string, key: string): Promise<string> {
 		headers: { "x-api-key": key, "user-agent": "mpc/0.1" },
 	});
 	if (!res.ok) {
-		throw new Error(
-			`Artificial Analysis API ${res.status}: set AA_API_KEY or use --bench cc / aa-web`,
-		);
+		throw new Error(`Artificial Analysis API ${res.status}: ${statusHint(res.status)}`);
 	}
 	return res.text();
 }
 
+/** One line per cause: a retired path is not a bad key, and the old message
+ * blamed credentials for every status. */
+function statusHint(status: number): string {
+	if (status === 401) return "AA_API_KEY rejected, replace the key";
+	if (status === 403)
+		return "this endpoint needs a Pro subscription, the free list is /language/models/free";
+	if (status === 404 || status === 410)
+		return "endpoint retired, see artificialanalysis.ai/data-api";
+	if (status === 429) return "daily quota spent, use --bench cc / aa-web";
+	return "unexpected response, use --bench cc / aa-web";
+}
+
 /** Keep the best variant per key; AA lists a row per reasoning effort. */
 function mergeAaPage(
 	page: { intelligence: Map<string, number>; tps: Map<string, number> },