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

package/dist/doctor.mjs

@@ -3,9 +3,9 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // tools/doctor.ts
 import { spawnSync } from "node:child_process";
-import { existsSync as existsSync29, lstatSync as lstatSync2, readFileSync as readFileSync31, readlinkSync, realpathSync as realpathSync4 } from "node:fs";
+import { existsSync as existsSync30, lstatSync as lstatSync2, readFileSync as readFileSync32, readlinkSync, realpathSync as realpathSync4 } from "node:fs";
 import { homedir as homedir3, platform as osPlatform } from "node:os";
-import { basename as basename5, dirname as dirname9, join as join30 } from "node:path";
+import { basename as basename5, delimiter as delimiter3, dirname as dirname9, join as join31 } from "node:path";
 
 // bin/tlc-cli.ts
 import {
@@ -5288,6 +5288,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";
@@ -5637,7 +5693,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) {
@@ -6784,6 +6841,12 @@ var coreFacade = {
     coversHandler,
     decideShim
   },
+  pricing: {
+    freshness,
+    freshnessMessage,
+    mayReplace,
+    shouldRefetch
+  },
   skill: {
     linkHealth,
     linkHealthMessage,
@@ -6993,6 +7056,7 @@ function writeStdout(text) {
 }
 
 // bin/tlc-cli.ts
+var NPM_PACKAGE = "@tech-leads-club/harness-toolkit";
 var NPM_MARKER = "installed-from-npm";
 function classifyRuntimePath(dest, probe) {
   if (probe.isSymlink(dest)) {
@@ -7026,19 +7090,17 @@ import { delimiter as delimiter2, dirname as dirname7, join as join27 } from "no
 function isPackagedCopy(candidate) {
   return candidate.split(/[/\\]/).includes("node_modules");
 }
-function bunExecutableName(platform = process.platform) {
-  return platform === "win32" ? "bun.exe" : "bun";
-}
-function findBunOnPath(env = process.env, platform = process.platform) {
-  const pathValue = env.PATH ?? "";
-  const bunName = bunExecutableName(platform);
-  for (const dir of pathValue.split(delimiter2)) {
+var BUN_EXECUTABLE_NAMES = ["bun", "bun.exe"];
+function findBunOnPath(env = process.env) {
+  for (const dir of (env.PATH ?? "").split(delimiter2)) {
     if (!dir) {
       continue;
     }
-    const candidate = join27(dir, bunName);
-    if (existsSync26(candidate)) {
-      return candidate;
+    for (const name of BUN_EXECUTABLE_NAMES) {
+      const candidate = join27(dir, name);
+      if (existsSync26(candidate)) {
+        return candidate;
+      }
     }
   }
   return null;
@@ -7814,14 +7876,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,
@@ -7913,6 +7970,50 @@ function isCursorWired(targetPath) {
 }
 if (false) {}
 
+// src/platform/pricing.ts
+import { existsSync as existsSync29, readFileSync as readFileSync31 } from "node:fs";
+import { join as join30 } from "node:path";
+function cataloguePath() {
+  return join30(runtimeHome(), "model-prices.json");
+}
+var cache = new Map;
+function readCatalogue(path) {
+  if (!existsSync29(path)) {
+    cache.delete(path);
+    return null;
+  }
+  let text;
+  try {
+    text = readFileSync31(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 loadCatalogue() {
+  return readCatalogue(cataloguePath()) ?? {};
+}
+function planeMeta() {
+  return loadCatalogue()._meta?.planes ?? {};
+}
+function catalogueMeta() {
+  const parsed = readCatalogue(cataloguePath());
+  return parsed === null ? null : parsed._meta ?? {};
+}
+
 // tools/doctor.ts
 function plural(count, word) {
   return `${count} ${word}${count === 1 ? "" : "s"}`;
@@ -7986,10 +8087,17 @@ function checkSkillLinks(home, providerDirs = providerConfigDirs(), probe = {
       }
     }
   },
-  exists: existsSync29
+  exists: existsSync30,
+  realpath: (path) => {
+    try {
+      return realpathSync4(path);
+    } catch {
+      return path;
+    }
+  }
 }) {
-  return providerDirs.filter((dir) => existsSync29(dir)).map((dir) => {
-    const health = coreFacade.skill.linkHealth(join30(dir, "skills", "harness-init"), home, probe);
+  return providerDirs.filter((dir) => existsSync30(dir)).map((dir) => {
+    const health = coreFacade.skill.linkHealth(join31(dir, "skills", "harness-init"), home, probe);
     return {
       level: health.state === "ok" ? "ok" : "fail",
       name: `init skill (${basename5(dir)})`,
@@ -7997,24 +8105,50 @@ function checkSkillLinks(home, providerDirs = providerConfigDirs(), probe = {
     };
   });
 }
+function checkPrices(now = new Date, read = { meta: catalogueMeta, planes: planeMeta }) {
+  const state = coreFacade.pricing.freshness(read.meta(), now);
+  const planes = read.planes();
+  const named = Object.entries(planes).map(([plane, meta]) => `${plane} ${meta.count ?? 0}`).join(", ");
+  return [
+    {
+      level: state.state === "fresh" ? "ok" : "warn",
+      name: "prices",
+      detail: state.state === "fresh" ? `${coreFacade.pricing.freshnessMessage(state, "catalogue")}${named ? ` (${named})` : ""}` : coreFacade.pricing.freshnessMessage(state, "catalogue")
+    }
+  ];
+}
+function resolveOnPath(command, env = process.env, exists = existsSync30) {
+  for (const dir of (env.PATH ?? "").split(delimiter3)) {
+    if (!dir) {
+      continue;
+    }
+    for (const name of [command, `${command}.cmd`, `${command}.exe`, `${command}.ps1`]) {
+      const candidate = join31(dir, name);
+      if (exists(candidate)) {
+        return candidate;
+      }
+    }
+  }
+  return null;
+}
 function checkRuntimePaths(home, platform) {
-  const launcher = join30(home, "bin", "tlc-exec.mjs");
-  const distSample = join30(home, "dist", "stop.mjs");
-  const cliLink = join30(homedir3(), ".local", "bin", platform === "win32" ? "tlc.cmd" : "tlc");
+  const launcher = join31(home, "bin", "tlc-exec.mjs");
+  const distSample = join31(home, "dist", "stop.mjs");
+  const onPath = resolveOnPath("tlc");
   return [
     { level: "ok", name: "platform", detail: platform },
-    { level: existsSync29(launcher) ? "ok" : "fail", name: "global runtime", detail: home },
+    { level: existsSync30(launcher) ? "ok" : "fail", name: "global runtime", detail: home },
     runtimeOwnershipCheck(home),
     {
-      level: existsSync29(distSample) ? "ok" : "fail",
+      level: existsSync30(distSample) ? "ok" : "fail",
       name: "dist bundles",
-      detail: existsSync29(distSample) ? join30(home, "dist") : "missing — run: tlc harness build"
+      detail: existsSync30(distSample) ? join31(home, "dist") : "missing — run: tlc harness build"
     },
-    { level: existsSync29(launcher) ? "ok" : "fail", name: "portable launcher", detail: launcher },
+    { level: existsSync30(launcher) ? "ok" : "fail", name: "portable launcher", detail: launcher },
     {
-      level: existsSync29(cliLink) || existsSync29(join30(home, "bin", platform === "win32" ? "tlc.cmd" : "tlc")) ? "ok" : "fail",
+      level: onPath === null ? "fail" : "ok",
       name: "CLI on PATH",
-      detail: cliLink
+      detail: onPath ?? `no \`tlc\` on PATH — npm i -g ${NPM_PACKAGE}, or \`npm link\` from a clone`
     }
   ];
 }
@@ -8033,15 +8167,15 @@ function wiringProblems(wiring) {
   if (wiring.strategy !== "replace") {
     return [];
   }
-  const text = existsSync29(wiring.target) ? readFileSync31(wiring.target, "utf8") : null;
-  return cursorWiringProblems(text, { launcherPath: launcherPathOf(wiring) }, existsSync29);
+  const text = existsSync30(wiring.target) ? readFileSync32(wiring.target, "utf8") : null;
+  return cursorWiringProblems(text, { launcherPath: launcherPathOf(wiring) }, existsSync30);
 }
 function launcherPathOf(wiring) {
   const first = wiring.entries[0];
   return first?.args.find((arg) => arg.endsWith(".mjs")) ?? "";
 }
 function providerWiringStatus(wiring) {
-  if (!existsSync29(dirname9(wiring.target))) {
+  if (!existsSync30(dirname9(wiring.target))) {
     return "not-installed";
   }
   if (wiring.strategy === "replace") {
@@ -8050,12 +8184,12 @@ function providerWiringStatus(wiring) {
     }
     return wiringProblems(wiring).length === 0 ? "wired" : "detected-but-unwired";
   }
-  const existingText = existsSync29(wiring.target) ? readFileSync31(wiring.target, "utf8") : null;
+  const existingText = existsSync30(wiring.target) ? readFileSync32(wiring.target, "utf8") : null;
   const result = mergeClaudeSettings(existingText, wiring.entries);
   return result.ok && !result.changed ? "wired" : "detected-but-unwired";
 }
 function checkProviders(registry, home) {
-  const launcherPath = join30(home, "bin", "tlc-exec.mjs");
+  const launcherPath = join31(home, "bin", "tlc-exec.mjs");
   return registry.map((provider) => {
     const wiring = provider.wiring({ launcherPath });
     const status = providerWiringStatus(wiring);
@@ -8239,12 +8373,12 @@ function checkProjectPolicy(root) {
     {
       level: "ok",
       name: "project policy",
-      detail: existsSync29(configPath) ? configPath : "missing — run: tlc harness init"
+      detail: existsSync30(configPath) ? configPath : "missing — run: tlc harness init"
     },
     {
       level: "ok",
       name: "state dir",
-      detail: existsSync29(stateDir) ? stateDir : `${stateDir} (created on first session)`
+      detail: existsSync30(stateDir) ? stateDir : `${stateDir} (created on first session)`
     },
     checkPosture(root),
     ...checkObservedRails(root),
@@ -8255,8 +8389,8 @@ function checkProjectPolicy(root) {
   ];
 }
 function checkGlobalCommands(home) {
-  const globalCommands = join30(home, ".cursor", "commands");
-  if (!existsSync29(globalCommands)) {
+  const globalCommands = join31(home, ".cursor", "commands");
+  if (!existsSync30(globalCommands)) {
     return {
       level: "ok",
       name: "global commands dir",
@@ -8280,6 +8414,7 @@ function runChecks(ctx) {
     ...checkProviders(ctx.registry, ctx.runtimeHome),
     ...checkProjectPolicy(ctx.root),
     ...checkCapabilities(ctx.root, ctx.runtimeHome),
+    ...checkPrices(),
     checkGlobalCommands(ctx.home)
   ];
 }
@@ -8349,6 +8484,7 @@ export {
   toReport,
   runtimeOwnershipCheck,
   runChecks,
+  resolveOnPath,
   providerWiringStatus,
   plural,
   medianMs,
@@ -8360,6 +8496,7 @@ export {
   checkRuntimePaths,
   checkProviders,
   checkProjectPolicy,
+  checkPrices,
   checkNodeVersion,
   checkLessonHealth,
   checkId,

package/dist/init-project.mjs

@@ -811,12 +811,7 @@ function usageText(style = PLAIN) {
 function launcherPath(home = runtimeHome()) {
   return join4(home, "bin", "tlc-exec.mjs");
 }
-function shimCommand(platform = process.platform) {
-  if (platform === "win32") {
-    return { command: "cmd", argsPrefix: ["/c", "node"] };
-  }
-  return { command: "node", argsPrefix: [] };
-}
+var SHIM_COMMAND = { command: "node", argsPrefix: [] };
 var CURSOR_SHIM_SPECS = [
   { hookEvent: "sessionStart", handler: "session-start", timeoutSeconds: 10 },
   { hookEvent: "sessionEnd", handler: "session-end", timeoutSeconds: 10 },
@@ -837,7 +832,7 @@ var CLAUDE_SHIM_SPECS = [
   { hookEvent: "MessageDisplay", handler: "response-after", timeoutSeconds: 5 }
 ];
 function cursorShimEntries(launcher) {
-  const { command, argsPrefix } = shimCommand();
+  const { command, argsPrefix } = SHIM_COMMAND;
   return CURSOR_SHIM_SPECS.map((spec) => ({
     hookEvent: spec.hookEvent,
     handler: spec.handler,

package/dist/install-runtime.mjs

@@ -2,8 +2,9 @@ import { createRequire } from "node:module";
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // tools/install-runtime.ts
-import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { join as join2, relative, resolve, sep } from "node:path";
+import { spawnSync } from "node:child_process";
+import { cpSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, rmSync as rmSync2, writeFileSync } from "node:fs";
+import { join as join3, relative, resolve, sep } from "node:path";
 
 // src/platform/paths.ts
 import { homedir } from "node:os";
@@ -849,6 +850,34 @@ var TOOL_KINDS = new Set([
   "file.edit",
   "file.read"
 ]);
+// src/platform/links.ts
+import { copyFileSync, existsSync, lstatSync, mkdirSync, rmSync, symlinkSync } from "node:fs";
+import { dirname, join as join2 } from "node:path";
+var LINK_TYPE = "junction";
+function linkDir(source, target) {
+  let replaced = false;
+  if (isLink(target)) {
+    rmSync(target, { recursive: true, force: true });
+    replaced = true;
+  } else if (existsSync(target)) {
+    return {
+      kind: "refused",
+      target,
+      reason: `${target} exists and is not a link — move it aside and re-run`
+    };
+  }
+  mkdirSync(dirname(target), { recursive: true });
+  symlinkSync(source, target, LINK_TYPE);
+  return { kind: replaced ? "relinked" : "linked", target, source };
+}
+function isLink(path) {
+  try {
+    return lstatSync(path).isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+
 // bin/tlc-cli.ts
 var NPM_PACKAGE = "@tech-leads-club/harness-toolkit";
 var NPM_MARKER = "installed-from-npm";
@@ -864,13 +893,10 @@ 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"];
-var NOT_SHIPPED = [join2("tools", "dev"), join2("tools", "__test__")];
+var NOT_SHIPPED = [join3("tools", "dev"), join3("tools", "__test__")];
 function isShipped(relativePath) {
   const normalised = relativePath.split(sep).join("/");
   return !NOT_SHIPPED.some((excluded) => {
@@ -890,34 +916,75 @@ function installRuntime(source, dest) {
   if (resolve(source) === resolve(dest)) {
     return { kind: "in-place", source, dest, entries: [], missing: [] };
   }
-  mkdirSync(dest, { recursive: true });
+  mkdirSync2(dest, { recursive: true });
   const entries = [];
   const missing = [];
   for (const entry of RUNTIME_PAYLOAD) {
-    const from = join2(source, entry);
-    if (!existsSync(from)) {
+    const from = join3(source, entry);
+    if (!existsSync2(from)) {
       missing.push(entry);
       continue;
     }
-    const to = join2(dest, entry);
-    rmSync(to, { recursive: true, force: true });
+    const to = join3(dest, entry);
+    rmSync2(to, { recursive: true, force: true });
     cpSync(from, to, {
       recursive: true,
       filter: (src) => isShipped(relative(source, src))
     });
     entries.push(entry);
   }
-  writeFileSync(join2(dest, NPM_MARKER), `Installed by \`tlc harness install\` from ${source}.
+  writeFileSync(join3(dest, NPM_MARKER), `Installed by \`tlc harness install\` from ${source}.
 Update with: npm i -g ${NPM_PACKAGE}@latest && tlc harness install
 `, "utf8");
-  const config = join2(dest, "config.json");
-  const example = join2(dest, "config.example.json");
-  if (!existsSync(config) && existsSync(example)) {
+  const config = join3(dest, "config.json");
+  const example = join3(dest, "config.example.json");
+  if (!existsSync2(config) && existsSync2(example)) {
     writeFileSync(config, readFileSync(example, "utf8"), "utf8");
   }
   return { kind: "copied", source, dest, entries, missing };
 }
+function linkRuntime(source, dest) {
+  if (resolve(source) === resolve(dest)) {
+    return { kind: "in-place", source, dest, entries: [], missing: [] };
+  }
+  const outcome = linkDir(resolve(source), dest);
+  if (outcome.kind === "refused") {
+    return { kind: "refused", source, dest, entries: [], missing: [], reason: outcome.reason };
+  }
+  const missing = RUNTIME_PAYLOAD.filter((entry) => !existsSync2(join3(dest, entry)));
+  return { kind: outcome.kind === "relinked" ? "relinked" : "linked", source, dest, entries: [], missing };
+}
 function installScreen(report) {
+  if (report.kind === "refused") {
+    return {
+      title: "harness install",
+      sections: [{ rows: [{ label: "refused", value: report.reason ?? "", level: "fail" }] }]
+    };
+  }
+  if (report.kind === "linked" || report.kind === "relinked") {
+    return {
+      title: "harness install",
+      sections: [
+        {
+          rows: [
+            {
+              label: report.kind === "linked" ? "linked" : "relinked",
+              value: `${report.dest} → ${report.source}`,
+              level: "ok"
+            },
+            ...report.missing.length > 0 ? [
+              {
+                label: "incomplete",
+                value: `the checkout has no ${report.missing.join(", ")} — run the build`,
+                level: "fail"
+              }
+            ] : []
+          ]
+        }
+      ],
+      footer: "an edit in the checkout is live in the next hook  ·  `npm link` puts `tlc` on PATH"
+    };
+  }
   if (report.kind === "in-place") {
     return {
       title: "harness install",
@@ -949,20 +1016,36 @@ function installDest(env = process.env) {
   }
   return runtimeHomeWasChosen(env) ? runtimeHome(env) : conventionalRuntimeHome();
 }
+function fetchPrices(dest, spawn = spawnSync) {
+  const result = spawn(process.execPath, [join3(dest, "bin", "tlc-exec.mjs"), "refresh-model-prices"], {
+    stdio: "inherit",
+    env: { ...process.env, TLC_HOME: dest }
+  });
+  if ((result.status ?? 1) !== 0) {
+    console.log("install: prices not fetched — cost estimates stay empty until `tlc harness prices refresh`");
+  }
+}
 if (__require.main == __require.module) {
-  const source = originRoot();
+  const link = process.argv.includes("--link");
+  const source = link ? process.cwd() : originRoot();
   const dest = installDest();
-  const report = installRuntime(source, dest);
+  const report = link ? linkRuntime(source, dest) : installRuntime(source, dest);
   console.log(installReportText(report, createStyle()));
+  if (report.kind === "refused") {
+    process.exit(1);
+  }
+  fetchPrices(dest);
   process.exit(report.missing.length > 0 ? 1 : 0);
 }
 export {
   originRoot,
+  linkRuntime,
   isShipped,
   installScreen,
   installRuntime,
   installReportText,
   installDest,
+  fetchPrices,
   RUNTIME_PAYLOAD,
   OPERATOR_OWNED,
   NOT_SHIPPED

package/dist/lessons-cli.mjs

@@ -5258,6 +5258,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";
@@ -5607,7 +5663,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) {
@@ -6754,6 +6811,12 @@ var coreFacade = {
     coversHandler,
     decideShim
   },
+  pricing: {
+    freshness,
+    freshnessMessage,
+    mayReplace,
+    shouldRefetch
+  },
   skill: {
     linkHealth,
     linkHealthMessage,
@@ -6972,6 +7035,9 @@ var NO_HUMAN_MODES = new Set(["bypassPermissions", "dontAsk"]);
 // bin/write-user-hooks.mjs
 if (false) {}
 
+// src/platform/pricing.ts
+var cache = new Map;
+
 // tools/doctor.ts
 function plural(count, word) {
   return `${count} ${word}${count === 1 ? "" : "s"}`;