@tech-leads-club/harness-toolkit 0.2.4 → 0.3.0

package/dist/tool-after.mjs

@@ -5273,6 +5273,62 @@ function release(root, provider, session) {
   deletePresenceRecord(root, provider, session);
 }
 
+// src/core/pricing/pricing.freshness.ts
+var DEFAULT_TTL_DAYS = 7;
+var MS_PER_DAY = 86400000;
+function freshness(meta, now, ttlDays = DEFAULT_TTL_DAYS) {
+  if (meta === null) {
+    return { state: "absent" };
+  }
+  const stamp = meta.refreshedAt;
+  if (stamp === undefined || Number.isNaN(Date.parse(stamp))) {
+    return { state: "undated" };
+  }
+  const ageMs = now.getTime() - Date.parse(stamp);
+  const ageDays = Math.max(0, ageMs / MS_PER_DAY);
+  return ageDays > ttlDays ? { state: "stale", ageDays, refreshedAt: stamp } : { state: "fresh", ageDays, refreshedAt: stamp };
+}
+function shouldRefetch(state) {
+  return state.state === "absent" || state.state === "undated" || state.state === "stale";
+}
+function freshnessMessage(state, catalogue) {
+  switch (state.state) {
+    case "absent":
+      return `${catalogue}: not on this machine — run \`tlc harness prices refresh\``;
+    case "undated":
+      return `${catalogue}: present but carries no date — it will be refetched`;
+    case "fresh":
+      return `${catalogue}: ${describeAge(state.ageDays)} old`;
+    default:
+      return `${catalogue}: ${describeAge(state.ageDays)} old — run \`tlc harness prices refresh\``;
+  }
+}
+var MIN_RETAINED_RATIO = 0.5;
+function mayReplace(existingCount, incomingCount, minRatio = MIN_RETAINED_RATIO) {
+  if (incomingCount === 0) {
+    return { replace: false, reason: "parsed no entries at all — the upstream format has changed" };
+  }
+  if (existingCount === 0) {
+    return { replace: true, reason: `first catalogue, ${incomingCount} entries` };
+  }
+  if (incomingCount >= existingCount) {
+    return { replace: true, reason: `${existingCount} → ${incomingCount} entries` };
+  }
+  const retained = incomingCount / existingCount;
+  return retained >= minRatio ? { replace: true, reason: `${existingCount} → ${incomingCount} entries` } : {
+    replace: false,
+    reason: `would drop from ${existingCount} to ${incomingCount} entries, keeping the existing catalogue — the upstream format has probably changed`
+  };
+}
+function describeAge(ageDays) {
+  if (ageDays < 1) {
+    const hours = Math.max(1, Math.round(ageDays * 24));
+    return `${hours} hour${hours === 1 ? "" : "s"}`;
+  }
+  const days = Math.round(ageDays);
+  return `${days} day${days === 1 ? "" : "s"}`;
+}
+
 // src/core/release/release.decisions.ts
 import { existsSync as existsSync17, readdirSync as readdirSync5, readFileSync as readFileSync19 } from "node:fs";
 import { join as join18 } from "node:path";
@@ -5622,7 +5678,8 @@ function linkHealth(target, runtimeHome2, probe) {
   if (!probe.exists(resolved)) {
     return { state: "dangling", target, resolved };
   }
-  const home = runtimeHome2.replace(/\/+$/, "");
+  const resolveHome = probe.realpath ?? ((path) => path);
+  const home = resolveHome(runtimeHome2).replace(/\/+$/, "");
   return resolved === home || resolved.startsWith(`${home}/`) ? { state: "ok", target, resolved } : { state: "outside-runtime", target, resolved };
 }
 function linkHealthMessage(health) {
@@ -6769,6 +6826,12 @@ var coreFacade = {
     coversHandler,
     decideShim
   },
+  pricing: {
+    freshness,
+    freshnessMessage,
+    mayReplace,
+    shouldRefetch
+  },
   skill: {
     linkHealth,
     linkHealthMessage,
@@ -6958,6 +7021,11 @@ var coreFacade = {
 // src/platform/pricing.ts
 import { existsSync as existsSync25, readFileSync as readFileSync27 } from "node:fs";
 import { join as join26 } from "node:path";
+var FALLBACK_PLANE = "litellm";
+var MODEL_ALIASES = {
+  "cursor-grok-4.5": "grok-4.5",
+  auto: "auto-cost"
+};
 var VENDOR_TO_NEUTRAL_POOL = {
   cursor_models: "provider_native",
   anthropic_models: "provider_native",
@@ -6968,16 +7036,6 @@ var VENDOR_TO_NEUTRAL_POOL = {
 function mapPoolToNeutral(pool) {
   return VENDOR_TO_NEUTRAL_POOL[pool];
 }
-function readJsonFile2(path) {
-  if (!existsSync25(path)) {
-    return null;
-  }
-  try {
-    return JSON.parse(readFileSync27(path, "utf8"));
-  } catch {
-    return null;
-  }
-}
 function stripMeta(table) {
   if (!table) {
     return {};
@@ -6986,7 +7044,7 @@ function stripMeta(table) {
   return rest;
 }
 function slugifyModelName(name) {
-  return name.trim().toLowerCase().replace(/[[\]]/g, "").replace(/\(.*?\)/g, "").replace(/[^a-z0-9.+]+/g, "-").replace(/^-+|-+$/g, "");
+  return name.trim().toLowerCase().replace(/\[([^\]]+)\]\([^)]*\)/g, "$1").replace(/[[\]]/g, "").replace(/[^a-z0-9.+]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function candidatesFor(model, aliases) {
   const trimmed = model.trim();
@@ -7023,28 +7081,55 @@ function fuzzyFind(table, needle) {
   }
   return;
 }
-function overridesPath() {
+function cataloguePath() {
   return join26(runtimeHome(), "model-prices.json");
 }
-function providerNativePath(provider) {
-  return join26(runtimeHome(), `model-prices.${provider}.json`);
+function overridesPath() {
+  return join26(runtimeHome(), "model-prices.local.json");
+}
+var cache = new Map;
+function readCatalogue(path) {
+  if (!existsSync25(path)) {
+    cache.delete(path);
+    return null;
+  }
+  let text;
+  try {
+    text = readFileSync27(path, "utf8");
+  } catch {
+    cache.delete(path);
+    return null;
+  }
+  const hit = cache.get(path);
+  if (hit && hit.text === text) {
+    return hit.value;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    cache.delete(path);
+    return null;
+  }
+  cache.set(path, { text, value: parsed });
+  return parsed;
 }
-function litellmPath() {
-  return join26(runtimeHome(), "model-prices.litellm.json");
+function loadCatalogue() {
+  return readCatalogue(cataloguePath()) ?? {};
 }
-function aliasesPath() {
-  return join26(runtimeHome(), "model-aliases.json");
+function planeFor(catalogue, plane) {
+  return stripMeta(catalogue.planes?.[plane] ?? null);
 }
 function resolveModelPrice(provider, model) {
   const trimmed = model.trim();
   if (!trimmed) {
     return;
   }
-  const overrides = stripMeta(readJsonFile2(overridesPath()));
-  const native = stripMeta(readJsonFile2(providerNativePath(provider)));
-  const litellm = stripMeta(readJsonFile2(litellmPath()));
-  const aliases = readJsonFile2(aliasesPath()) ?? {};
-  const candidates = candidatesFor(trimmed, aliases);
+  const catalogue = loadCatalogue();
+  const overrides = stripMeta(readCatalogue(overridesPath()));
+  const native = provider ? planeFor(catalogue, provider) : {};
+  const litellm = planeFor(catalogue, FALLBACK_PLANE);
+  const candidates = candidatesFor(trimmed, MODEL_ALIASES);
   for (const id of candidates) {
     const entry = overrides[id];
     if (entry) {
@@ -7909,14 +7994,9 @@ var ENTRY_SPECS2 = [
   { hookEvent: "stop", handler: "stop", timeoutSeconds: 120, loopLimit: 5 },
   { hookEvent: "afterAgentResponse", handler: "response-after", timeoutSeconds: 5, matcher: "AgentResponse" }
 ];
-function commandFor(runtime) {
-  if (process.platform === "win32") {
-    return { command: "cmd", argsPrefix: ["/c", "node", runtime.launcherPath] };
-  }
-  return { command: "node", argsPrefix: [runtime.launcherPath] };
-}
 function cursorWiring(runtime) {
-  const { command, argsPrefix } = commandFor(runtime);
+  const command = "node";
+  const argsPrefix = [runtime.launcherPath];
   const entries = ENTRY_SPECS2.map((spec) => ({
     hookEvent: spec.hookEvent,
     handler: spec.handler,

package/dist/tool-before.mjs

@@ -5273,6 +5273,62 @@ function release(root, provider, session) {
   deletePresenceRecord(root, provider, session);
 }
 
+// src/core/pricing/pricing.freshness.ts
+var DEFAULT_TTL_DAYS = 7;
+var MS_PER_DAY = 86400000;
+function freshness(meta, now, ttlDays = DEFAULT_TTL_DAYS) {
+  if (meta === null) {
+    return { state: "absent" };
+  }
+  const stamp = meta.refreshedAt;
+  if (stamp === undefined || Number.isNaN(Date.parse(stamp))) {
+    return { state: "undated" };
+  }
+  const ageMs = now.getTime() - Date.parse(stamp);
+  const ageDays = Math.max(0, ageMs / MS_PER_DAY);
+  return ageDays > ttlDays ? { state: "stale", ageDays, refreshedAt: stamp } : { state: "fresh", ageDays, refreshedAt: stamp };
+}
+function shouldRefetch(state) {
+  return state.state === "absent" || state.state === "undated" || state.state === "stale";
+}
+function freshnessMessage(state, catalogue) {
+  switch (state.state) {
+    case "absent":
+      return `${catalogue}: not on this machine — run \`tlc harness prices refresh\``;
+    case "undated":
+      return `${catalogue}: present but carries no date — it will be refetched`;
+    case "fresh":
+      return `${catalogue}: ${describeAge(state.ageDays)} old`;
+    default:
+      return `${catalogue}: ${describeAge(state.ageDays)} old — run \`tlc harness prices refresh\``;
+  }
+}
+var MIN_RETAINED_RATIO = 0.5;
+function mayReplace(existingCount, incomingCount, minRatio = MIN_RETAINED_RATIO) {
+  if (incomingCount === 0) {
+    return { replace: false, reason: "parsed no entries at all — the upstream format has changed" };
+  }
+  if (existingCount === 0) {
+    return { replace: true, reason: `first catalogue, ${incomingCount} entries` };
+  }
+  if (incomingCount >= existingCount) {
+    return { replace: true, reason: `${existingCount} → ${incomingCount} entries` };
+  }
+  const retained = incomingCount / existingCount;
+  return retained >= minRatio ? { replace: true, reason: `${existingCount} → ${incomingCount} entries` } : {
+    replace: false,
+    reason: `would drop from ${existingCount} to ${incomingCount} entries, keeping the existing catalogue — the upstream format has probably changed`
+  };
+}
+function describeAge(ageDays) {
+  if (ageDays < 1) {
+    const hours = Math.max(1, Math.round(ageDays * 24));
+    return `${hours} hour${hours === 1 ? "" : "s"}`;
+  }
+  const days = Math.round(ageDays);
+  return `${days} day${days === 1 ? "" : "s"}`;
+}
+
 // src/core/release/release.decisions.ts
 import { existsSync as existsSync17, readdirSync as readdirSync5, readFileSync as readFileSync19 } from "node:fs";
 import { join as join18 } from "node:path";
@@ -5622,7 +5678,8 @@ function linkHealth(target, runtimeHome2, probe) {
   if (!probe.exists(resolved)) {
     return { state: "dangling", target, resolved };
   }
-  const home = runtimeHome2.replace(/\/+$/, "");
+  const resolveHome = probe.realpath ?? ((path) => path);
+  const home = resolveHome(runtimeHome2).replace(/\/+$/, "");
   return resolved === home || resolved.startsWith(`${home}/`) ? { state: "ok", target, resolved } : { state: "outside-runtime", target, resolved };
 }
 function linkHealthMessage(health) {
@@ -6769,6 +6826,12 @@ var coreFacade = {
     coversHandler,
     decideShim
   },
+  pricing: {
+    freshness,
+    freshnessMessage,
+    mayReplace,
+    shouldRefetch
+  },
   skill: {
     linkHealth,
     linkHealthMessage,
@@ -7719,14 +7782,9 @@ var ENTRY_SPECS2 = [
   { hookEvent: "stop", handler: "stop", timeoutSeconds: 120, loopLimit: 5 },
   { hookEvent: "afterAgentResponse", handler: "response-after", timeoutSeconds: 5, matcher: "AgentResponse" }
 ];
-function commandFor(runtime) {
-  if (process.platform === "win32") {
-    return { command: "cmd", argsPrefix: ["/c", "node", runtime.launcherPath] };
-  }
-  return { command: "node", argsPrefix: [runtime.launcherPath] };
-}
 function cursorWiring(runtime) {
-  const { command, argsPrefix } = commandFor(runtime);
+  const command = "node";
+  const argsPrefix = [runtime.launcherPath];
   const entries = ENTRY_SPECS2.map((spec) => ({
     hookEvent: spec.hookEvent,
     handler: spec.handler,

package/dist/tool-failure.mjs

@@ -5273,6 +5273,62 @@ function release(root, provider, session) {
   deletePresenceRecord(root, provider, session);
 }
 
+// src/core/pricing/pricing.freshness.ts
+var DEFAULT_TTL_DAYS = 7;
+var MS_PER_DAY = 86400000;
+function freshness(meta, now, ttlDays = DEFAULT_TTL_DAYS) {
+  if (meta === null) {
+    return { state: "absent" };
+  }
+  const stamp = meta.refreshedAt;
+  if (stamp === undefined || Number.isNaN(Date.parse(stamp))) {
+    return { state: "undated" };
+  }
+  const ageMs = now.getTime() - Date.parse(stamp);
+  const ageDays = Math.max(0, ageMs / MS_PER_DAY);
+  return ageDays > ttlDays ? { state: "stale", ageDays, refreshedAt: stamp } : { state: "fresh", ageDays, refreshedAt: stamp };
+}
+function shouldRefetch(state) {
+  return state.state === "absent" || state.state === "undated" || state.state === "stale";
+}
+function freshnessMessage(state, catalogue) {
+  switch (state.state) {
+    case "absent":
+      return `${catalogue}: not on this machine — run \`tlc harness prices refresh\``;
+    case "undated":
+      return `${catalogue}: present but carries no date — it will be refetched`;
+    case "fresh":
+      return `${catalogue}: ${describeAge(state.ageDays)} old`;
+    default:
+      return `${catalogue}: ${describeAge(state.ageDays)} old — run \`tlc harness prices refresh\``;
+  }
+}
+var MIN_RETAINED_RATIO = 0.5;
+function mayReplace(existingCount, incomingCount, minRatio = MIN_RETAINED_RATIO) {
+  if (incomingCount === 0) {
+    return { replace: false, reason: "parsed no entries at all — the upstream format has changed" };
+  }
+  if (existingCount === 0) {
+    return { replace: true, reason: `first catalogue, ${incomingCount} entries` };
+  }
+  if (incomingCount >= existingCount) {
+    return { replace: true, reason: `${existingCount} → ${incomingCount} entries` };
+  }
+  const retained = incomingCount / existingCount;
+  return retained >= minRatio ? { replace: true, reason: `${existingCount} → ${incomingCount} entries` } : {
+    replace: false,
+    reason: `would drop from ${existingCount} to ${incomingCount} entries, keeping the existing catalogue — the upstream format has probably changed`
+  };
+}
+function describeAge(ageDays) {
+  if (ageDays < 1) {
+    const hours = Math.max(1, Math.round(ageDays * 24));
+    return `${hours} hour${hours === 1 ? "" : "s"}`;
+  }
+  const days = Math.round(ageDays);
+  return `${days} day${days === 1 ? "" : "s"}`;
+}
+
 // src/core/release/release.decisions.ts
 import { existsSync as existsSync17, readdirSync as readdirSync5, readFileSync as readFileSync19 } from "node:fs";
 import { join as join18 } from "node:path";
@@ -5622,7 +5678,8 @@ function linkHealth(target, runtimeHome2, probe) {
   if (!probe.exists(resolved)) {
     return { state: "dangling", target, resolved };
   }
-  const home = runtimeHome2.replace(/\/+$/, "");
+  const resolveHome = probe.realpath ?? ((path) => path);
+  const home = resolveHome(runtimeHome2).replace(/\/+$/, "");
   return resolved === home || resolved.startsWith(`${home}/`) ? { state: "ok", target, resolved } : { state: "outside-runtime", target, resolved };
 }
 function linkHealthMessage(health) {
@@ -6769,6 +6826,12 @@ var coreFacade = {
     coversHandler,
     decideShim
   },
+  pricing: {
+    freshness,
+    freshnessMessage,
+    mayReplace,
+    shouldRefetch
+  },
   skill: {
     linkHealth,
     linkHealthMessage,
@@ -7719,14 +7782,9 @@ var ENTRY_SPECS2 = [
   { hookEvent: "stop", handler: "stop", timeoutSeconds: 120, loopLimit: 5 },
   { hookEvent: "afterAgentResponse", handler: "response-after", timeoutSeconds: 5, matcher: "AgentResponse" }
 ];
-function commandFor(runtime) {
-  if (process.platform === "win32") {
-    return { command: "cmd", argsPrefix: ["/c", "node", runtime.launcherPath] };
-  }
-  return { command: "node", argsPrefix: [runtime.launcherPath] };
-}
 function cursorWiring(runtime) {
-  const { command, argsPrefix } = commandFor(runtime);
+  const command = "node";
+  const argsPrefix = [runtime.launcherPath];
   const entries = ENTRY_SPECS2.map((spec) => ({
     hookEvent: spec.hookEvent,
     handler: spec.handler,

package/dist/uninstall-runtime.mjs

@@ -979,9 +979,6 @@ var RUNTIME_PAYLOAD = [
   "src",
   "tools",
   "config.example.json",
-  "model-aliases.json",
-  "model-prices.cursor.json",
-  "model-prices.json",
   "package.json"
 ];
 var OPERATOR_OWNED = ["config.json", "state", "flags"];
@@ -989,18 +986,18 @@ var NOT_SHIPPED = [join2("tools", "dev"), join2("tools", "__test__")];
 if (false) {}
 
 // tools/uninstall-runtime.ts
-function uninstallTargets(env = process.env, platform = process.platform) {
-  const windows = platform === "win32";
-  const userHome = (windows ? env.USERPROFILE : env.HOME)?.trim() || homedir2();
+function uninstallTargets(env = process.env) {
+  const userHome = homedir2();
   const binDir = env.TLC_BIN_DIR?.trim() || join3(userHome, ".local", "bin");
   return {
     home: runtimeHome(env),
-    binLink: join3(binDir, windows ? "tlc.cmd" : "tlc"),
+    binLinks: [join3(binDir, "tlc"), join3(binDir, "tlc.cmd")],
     claudeSettings: join3(claudeConfigDir(), "settings.json"),
     cursorHooks: join3(cursorConfigDir(), "hooks.json"),
-    skillLinks: windows ? [join3(userHome, ".tlc", "skills", "harness-init")] : [
+    skillLinks: [
       join3(claudeConfigDir(), "skills", "harness-init"),
-      join3(cursorConfigDir(), "skills", "harness-init")
+      join3(cursorConfigDir(), "skills", "harness-init"),
+      join3(userHome, ".tlc", "skills", "harness-init")
     ]
   };
 }
@@ -1182,7 +1179,9 @@ function planUninstall(targets, options = {}) {
   for (const link of targets.skillLinks) {
     planLink(items, link, targets.home, "skill link", "location");
   }
-  planLink(items, targets.binLink, targets.home, "the tlc launcher on PATH", "target");
+  for (const link of targets.binLinks) {
+    planLink(items, link, targets.home, "the tlc launcher on PATH", "target");
+  }
   const homeIsLink = planRuntime(items, targets.home, purge);
   planManual(items, targets.home);
   return { items, purge, homeIsLink };

package/docs/log.md

@@ -23,6 +23,8 @@ newest first. For what landed in which npm release, see `CHANGELOG.md` at the re
 - **AD-086** — The write lock read the wrong error code on Windows, in a module that already listed the right ones ([/decisions/ad-086.md](/decisions/ad-086.md))
 - **AD-087** — How the release works, and the six wrong shapes it took first ([/decisions/ad-087.md](/decisions/ad-087.md))
 - **AD-095** — Four defects about where things are written, and one of them made every hook run twice ([/decisions/ad-095.md](/decisions/ad-095.md))
+- **AD-096** — Prices are the machine's, in one file, and the parser that fills it was wrong twice ([/decisions/ad-096.md](/decisions/ad-096.md))
+- **AD-097** — The shell layer goes, and with it every platform branch that only existed because of it ([/decisions/ad-097.md](/decisions/ad-097.md))
 
 ## 2026-08-17
 

package/docs/measure.md

@@ -114,55 +114,59 @@ full mapping table.
 
 ## Prices
 
-Cost estimates use on-disk catalogs under `~/.tlc/harness/`, resolved provider-first:
+Fetched per machine, never versioned ([/decisions/ad-096.md](/decisions/ad-096.md)).
 
 ```bash
-tlc harness prices refresh
-tlc harness prices refresh all
-tlc harness prices refresh cursor
-tlc harness prices refresh litellm
+tlc harness prices refresh              # both planes, now
+tlc harness prices refresh cursor       # one plane
+tlc harness prices refresh --if-stale   # only past the TTL; what install and update run
 tlc harness prices lookup <model-id> [provider]
 ```
 
-| Command | Effect |
+| Trigger | Effect |
 |---------|--------|
-| `refresh` / `refresh all` | Update the Cursor catalog and the LiteLLM fallback |
-| `refresh cursor` | Write `model-prices.cursor.json` (commit when rates change) |
-| `refresh litellm` | Write `model-prices.litellm.json` (gitignored; regenerate locally) |
-| `lookup <model-id> [provider]` | Resolve catalog key, pool, and USD for 1M input + 1M output |
+| `tlc harness install` | first fetch; a network failure does not fail the install |
+| `tlc harness update` | `--if-stale`, TTL 7 days |
+| `tlc harness doctor` | reports the catalogue's age, or that it is absent |
 
-### Catalogs
+### Files
 
 | File | Role | In git |
 |------|------|--------|
-| `model-prices.<provider>.json` (e.g. `model-prices.cursor.json`) | Primary, per provider | Yes |
-| `model-prices.litellm.json` | Fallback (LiteLLM public JSON) | No |
-| `model-prices.json` | Local overrides | Empty `{}` template only |
-| `model-aliases.json` | Model id → catalog key | Yes |
+| `~/.tlc/harness/model-prices.json` | the catalogue | No |
+| `~/.tlc/harness/model-prices.local.json` | hand-written overrides | No |
+
+### Planes
+
+`planes` is keyed by who bills the call. They are not merged: the same model has one rate from its vendor and
+another from a provider reselling it.
+
+| Plane | Holds | Source |
+|-------|-------|--------|
+| `cursor` | what that provider charges | its pricing page |
+| `litellm` | vendor list prices | the LiteLLM public JSON |
+
+`_meta.planes[<plane>]` records the source, the model count and the fetch time.
 
 ### Resolution order
 
-1. `model-prices.json` (local overrides)
-2. `model-prices.<provider>.json` (this provider's own catalog)
-3. `model-prices.litellm.json`
+1. `model-prices.local.json`
+2. `planes[<asking provider>]`
+3. `planes.litellm`
 4. otherwise `cost_usd: null`
 
-Pools (neutral names in observability records; see [/decisions/ad-011.md](/decisions/ad-011.md) item 2):
-`provider_native` | `other` | `auto` | `unknown`. The on-disk catalog files still use vendor-named pool
-keys internally (`cursor_models`, `anthropic_models`, …) since pricing must name real vendors — those are
-mapped to the neutral names before they reach `core/`.
+Host ids that differ from a catalogue key are mapped in `MODEL_ALIASES` (`src/platform/pricing.ts`). Add your own
+by writing the key into the overrides file.
 
-### When to refresh
+Pools (neutral names in observability records; see [/decisions/ad-011.md](/decisions/ad-011.md) item 2):
+`provider_native` | `other` | `auto` | `unknown`. The catalogue uses vendor-named pool keys internally
+(`cursor_models`, `anthropic_models`, …) since pricing must name real vendors — those are mapped to the neutral
+names before they reach `core/`.
 
-| Situation | Command |
-|-----------|---------|
-| A provider published new rates or models | `tlc harness prices refresh cursor` (then commit) |
-| Missing LiteLLM file or obscure model | `tlc harness prices refresh litellm` |
-| Update both catalogs | `tlc harness prices refresh` |
-| Inspect one model | `tlc harness prices lookup <model-id> [provider]` |
+### Refusal
 
-`tlc harness doctor` requires at least one provider catalog to be present. LiteLLM is optional until needed
-as fallback.
+A plane is replaced only if the incoming table keeps at least half of what is on disk. Below that the refresh
+refuses, names both counts, and leaves every plane untouched.
 
 ## Project state files
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tech-leads-club/harness-toolkit",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "type": "module",
   "description": "Multi-provider agent steering: gates, follow-up, handoff, policy",
   "keywords": [
@@ -19,6 +19,9 @@
     "tlc": "bin/tlc.mjs",
     "tlc-exec": "bin/tlc-exec.mjs"
   },
+  "scripts": {
+    "prepack": "node bin/tlc-build.mjs"
+  },
   "files": [
     "bin/",
     "capabilities/",
@@ -33,9 +36,6 @@
     "!tools/test-env*",
     "!docs/decisions",
     "config.example.json",
-    "model-aliases.json",
-    "model-prices.cursor.json",
-    "model-prices.json",
     "NOTICE"
   ],
   "publishConfig": {

package/src/core/core.facade.ts

@@ -130,6 +130,7 @@ import { isOperatorMode, OPERATOR_MODES } from "./policy/policy.posture.ts";
 import { activeRails } from "./policy/policy.rails.ts";
 import { forProvider } from "./policy/policy.types.ts";
 import { checkCollision, heartbeat, register, release, sweepStale } from "./presence/presence.service.ts";
+import { freshness, freshnessMessage, mayReplace, shouldRefetch } from "./pricing/pricing.freshness.ts";
 import {
   allDecisionFiles,
   formatDecisionDigest,
@@ -277,6 +278,12 @@ export const coreFacade = {
     coversHandler,
     decideShim,
   },
+  pricing: {
+    freshness,
+    freshnessMessage,
+    mayReplace,
+    shouldRefetch,
+  },
   skill: {
     linkHealth,
     linkHealthMessage,

package/src/core/index.ts

@@ -44,6 +44,7 @@ export type {
   ProviderScoped,
 } from "./policy/policy.types.ts";
 export type { PresenceRecord } from "./presence/presence.types.ts";
+export type { CatalogueMeta, Freshness } from "./pricing/pricing.freshness.ts";
 export type { ShellEffectClass } from "./shell-policy/shell-policy.types.ts";
 export type { ProviderSettings } from "./shim/shim.precedence.ts";
 export type { ShipClaim, ShipClaimKind, ShipLedgerEvent, ShipLedgerRow } from "./ship/ship.types.ts";