yourskills 0.1.4 → 0.1.5

package/dist/main.js

@@ -143,9 +143,10 @@ function configValue(config, key) {
     case "server":
       return config.serverUrl ?? UNSET;
     case "track":
-      return config.track === undefined ? UNSET : String(config.track);
-    case "autoUpdate":
-      return String(config.autoUpdate !== false);
+    case "autoUpdate": {
+      const value = key === "track" ? config.track : config.autoUpdate;
+      return String(value !== false);
+    }
   }
 }
 function setConfigValue(config, key, value) {
@@ -2866,8 +2867,8 @@ Options:
       --fix               doctor: repair what it can, and say what it did
       --explain           config get: say where each value came from
       --method <tool>     upgrade: npm, bun or brew, when the guess is wrong
-      --track             hooks install: opt in to counting skill invocations
-      --no-track          hooks install: opt out again
+      --track             hooks install: count skill invocations (the default)
+      --no-track          hooks install: stop counting skill invocations
       --server <url>      Registry base URL for this invocation
       --plain             Plain, greppable output; no frames, no colour
       --json              Machine-readable output
@@ -2929,8 +2930,8 @@ var OPTIONS = [
   ["--fix", "doctor: repair what it can"],
   ["--explain", "config get: where each value came from"],
   ["--method", "upgrade: npm, bun or brew"],
-  ["--track", "hooks install: opt in to usage counting"],
-  ["--no-track", "hooks install: opt out"],
+  ["--track", "hooks install: count skill invocations (the default)"],
+  ["--no-track", "hooks install: stop counting skill invocations"],
   ["--server", "registry base URL"],
   ["--plain", "plain output"],
   ["--json", "machine-readable output"],
@@ -3098,6 +3099,9 @@ function agentForEvent(kind, event, adapters = HOOK_ADAPTERS) {
   return owner?.agent ?? "unknown";
 }
 // src/hooks/audit.ts
+import { existsSync as existsSync3 } from "node:fs";
+
+// src/hooks/install.ts
 import { existsSync as existsSync2 } from "node:fs";
 
 // src/usage/queue.ts
@@ -4710,7 +4714,7 @@ function trackingDisabledByEnv() {
 async function trackingEnabled() {
   if (trackingDisabledByEnv())
     return false;
-  return (await readConfig()).track === true;
+  return (await readConfig()).track !== false;
 }
 async function flushQuietly(server) {
   try {
@@ -4864,474 +4868,116 @@ async function applyTo(path, change) {
   return { changed: true };
 }
 
-// src/hooks/audit.ts
-function wanted(entries, optedIn) {
-  return entries.filter((entry) => entry.kind === "update-check" || optedIn);
-}
-async function hookGaps() {
-  const config = await readConfig();
-  const optedIn = !trackingDisabledByEnv() && config.track === true;
-  const gaps = [];
-  for (const adapter of HOOK_ADAPTERS) {
-    const path = adapter.settingsPath();
-    if (!path || !existsSync2(adapter.home()))
-      continue;
-    const expected = wanted(adapter.entries, optedIn);
-    if (expected.length === 0)
-      continue;
-    const file = await readSettingsFile(path);
-    if (!file.ok) {
-      gaps.push({
-        agent: adapter.agent,
-        path,
-        registered: [],
-        missing: [],
-        error: file.error
-      });
-      continue;
-    }
-    const registered = registeredEntries(file.settings, expected).map((entry) => entry.kind);
-    gaps.push({
-      agent: adapter.agent,
-      path,
-      registered,
-      missing: expected.map((entry) => entry.kind).filter((kind) => !registered.includes(kind))
-    });
+// src/hooks/install.ts
+var PAYLOAD_DISCLOSURE = [
+  { mark: "none", text: "Usage tracking sends, once per skill invocation:" },
+  { mark: "none", text: "  skillExternalId", note: "the skill's registry id" },
+  { mark: "none", text: "  ref", note: "the commit you installed it at" },
+  { mark: "none", text: "  agent", note: "which agent ran it" },
+  { mark: "none", text: "  occurredAt", note: "when it ran" },
+  {
+    mark: "none",
+    text: "  (nothing else)",
+    note: "the server adds a keyed hash of you; the CLI never sends a user id"
   }
-  return gaps;
-}
-async function registerMissing(gap) {
-  const adapter = HOOK_ADAPTERS.find((a) => a.agent === gap.agent);
-  const entries = adapter?.entries.filter((entry) => gap.missing.includes(entry.kind));
-  if (!adapter || !entries || entries.length === 0)
-    throw new Error(`nothing to register for ${gap.agent}`);
-  const applied = await applyTo(gap.path, (settings) => addHooks(settings, entries));
-  if (applied.error)
-    throw new Error(applied.error);
-  return `registered ${gap.missing.join(" + ")} in ${gap.path}`;
-}
-// ../../packages/bundles/src/drift.ts
-var SHORT_SHA = 7;
-function namesSameCommit(prefix, full) {
-  const short = prefix.trim().toLowerCase();
-  const long = full.trim().toLowerCase();
-  if (short === long)
-    return true;
-  return short.length >= SHORT_SHA && long.startsWith(short);
-}
-
-// src/installed/installed.ts
-var shortRef = (ref) => ref.slice(0, SHORT_SHA);
-function refColumn(row) {
-  return row.unpinned ? "unpinned" : shortRef(row.ref);
-}
-function installedRows(nearest) {
-  return Object.values(nearest.manifest.skills).map((entry) => ({
-    name: entry.name,
-    ref: entry.ref,
-    bundle: entry.bundle ?? null,
-    scope: nearest.manifest.scope,
-    unpinned: entry.unpinned === true
-  })).sort((a, b) => a.name.localeCompare(b.name));
+];
+function trackNote(track) {
+  if (trackingDisabledByEnv())
+    return "off (YOURSKILLS_NO_TRACK is set)";
+  return track ? "on; turn off with `yourskills config set track false`" : "off; turn on with `yourskills config set track true`";
 }
-function columns(rows) {
-  const names = Math.max(...rows.map((r) => r.name.length));
-  const bundles = Math.max(...rows.map((r) => (r.bundle ?? "-").length));
-  return rows.map((row) => ({
-    mark: "none",
-    text: `${row.name.padEnd(names)}  ${refColumn(row)}`,
-    note: `${(row.bundle ?? "-").padEnd(bundles)}  ${row.scope}`
-  }));
+function trackingOn(config) {
+  return !trackingDisabledByEnv() && config.track !== false;
 }
-function installedReport(nearest) {
-  const rows = installedRows(nearest);
-  const lines = rows.length === 0 ? [
-    {
-      mark: "none",
-      text: "Nothing installed. Run `yourskills add <name>`.",
-      note: nearest.path
-    }
-  ] : columns(rows);
+function selectAdapters(agent) {
+  if (agent) {
+    const found = adapterFor(agent);
+    if (!found)
+      return { adapters: [], unknown: [agent], absent: [] };
+    return existsSync2(found.home()) ? { adapters: [found], unknown: [], absent: [] } : { adapters: [], unknown: [], absent: [found] };
+  }
   return {
-    title: "installed",
-    lines,
-    json: {
-      manifest: nearest.path,
-      scope: nearest.manifest.scope,
-      skills: rows
-    },
-    ...rows.length === 0 ? {
-      next: {
-        command: "yourskills browse",
-        why: "pick something to install"
-      }
-    } : {}
+    adapters: HOOK_ADAPTERS.filter((a) => existsSync2(a.home())),
+    unknown: [],
+    absent: []
   };
 }
-// src/installed/outdated.ts
-function driftTag(row) {
-  return lifecycleTag(row.deprecated ? "deprecated" : undefined);
-}
-function hasMoved(installed, available) {
-  return !(namesSameCommit(available, installed) || namesSameCommit(installed, available));
+async function pinnedAdapters() {
+  const pinned = await resolveAgents();
+  if (pinned.length === 0)
+    return null;
+  const adapters = pinned.map((name) => adapterFor(name)).filter((a) => a !== undefined).filter((a) => existsSync2(a.home()));
+  return adapters.length > 0 ? adapters : null;
 }
-function drift(manifest, pins, catalog) {
-  const byExternalId = new Map(catalog.map((row) => [row.externalId, row]));
-  const byName = new Map(catalog.map((row) => [row.name, row]));
-  const moved = [];
-  const unknown = [];
-  const unpinned = [];
-  for (const entry of Object.values(manifest.skills)) {
-    if (entry.unpinned) {
-      unpinned.push(entry.name);
-      continue;
+async function installInto(adapter, tracking) {
+  const path = adapter.settingsPath();
+  const result = {
+    agent: adapter.agent,
+    path,
+    installed: [],
+    already: [],
+    skipped: []
+  };
+  if (!path) {
+    for (const kind of adapter.supports) {
+      result.skipped.push({
+        kind,
+        why: adapter.limitation ?? "not supported yet"
+      });
     }
-    const row = byExternalId.get(entry.externalId) ?? byName.get(entry.name);
-    if (!row) {
-      unknown.push(entry.name);
+    return result;
+  }
+  const wanted = [];
+  for (const entry of adapter.entries) {
+    if (entry.kind === "usage" && !tracking) {
+      result.skipped.push({ kind: entry.kind, why: trackNote(false) });
       continue;
     }
-    const pin = entry.bundle ? pins.find((p) => p.bundle === entry.bundle && p.skillId === row.id) : undefined;
-    const available = pin?.pinnedSha ?? row.currentSha;
-    if (!hasMoved(entry.ref, available))
-      continue;
-    moved.push({
-      name: entry.name,
-      bundle: entry.bundle ?? null,
-      installed: entry.ref,
-      available,
-      deprecated: pin?.deprecated ?? row.status === "deprecated"
-    });
+    wanted.push(entry);
   }
-  moved.sort((a, b) => a.name.localeCompare(b.name));
-  return { moved, unknown, unpinned };
-}
-async function driftNow(client, nearest) {
-  const [pins, catalog] = await Promise.all([
-    client.bundles.pins.query(),
-    client.skills.list.query({})
-  ]);
-  return drift(nearest.manifest, pins, catalog);
-}
-async function outdatedReport(client, nearest, quiet = false) {
-  let report2;
-  try {
-    report2 = await driftNow(client, nearest);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      title: "outdated",
-      lines: [
-        { mark: "fail", text: "Could not reach the registry.", note: message }
-      ],
-      json: { manifest: nearest.path, error: message },
-      silent: quiet
-    };
+  let present = new Set;
+  const applied = await applyTo(path, (settings) => {
+    present = new Set(registeredEntries(settings, wanted).map((entry) => entry.kind));
+    return addHooks(settings, wanted);
+  });
+  if (applied.error) {
+    result.error = applied.error;
+    return result;
   }
-  const lines = report2.moved.map((row) => ({
-    mark: "pending",
-    text: `${row.name}  ${shortRef(row.installed)} -> ${shortRef(row.available)}`,
-    note: [row.bundle ?? "-", driftTag(row)].filter(Boolean).join("  ")
-  }));
-  for (const name of report2.unknown) {
+  for (const entry of wanted) {
+    if (present.has(entry.kind))
+      result.already.push(entry.kind);
+    else
+      result.installed.push(entry.kind);
+  }
+  if (applied.changed && result.already.length > 0) {
+    result.repaired = result.already;
+    result.already = [];
+  }
+  return result;
+}
+function linesFor(result) {
+  const lines = [];
+  if (result.error) {
     lines.push({
       mark: "fail",
-      text: name,
-      note: "no longer in your registry"
+      text: `${result.agent}: left untouched`,
+      note: result.error
     });
+    return lines;
   }
-  for (const name of report2.unpinned) {
+  for (const kind of result.installed) {
     lines.push({
-      mark: "pending",
-      text: name,
-      note: "not in your registry; imported from disk, nothing to compare"
+      mark: "ok",
+      text: `${result.agent}  ${kind}`,
+      note: result.path ?? ""
     });
   }
-  const current = report2.moved.length === 0 && report2.unknown.length === 0;
-  if (current && !quiet) {
+  for (const kind of result.repaired ?? []) {
     lines.push({
       mark: "ok",
-      text: "Everything is at the ref your registry pins."
-    });
-  }
-  return {
-    title: "outdated",
-    lines,
-    json: {
-      manifest: nearest.path,
-      outdated: report2.moved,
-      unknown: report2.unknown,
-      unpinned: report2.unpinned
-    },
-    silent: quiet && current,
-    ...report2.moved.length > 0 ? {
-      next: {
-        command: "yourskills update --all",
-        why: "install what moved"
-      }
-    } : {}
-  };
-}
-// src/hooks/emit.ts
-function describe(outcome) {
-  switch (outcome.kind) {
-    case "quiet":
-      return [];
-    case "signed-out":
-      return [
-        "yourskills: your sign-in has expired, so your skills are no longer kept up to date.",
-        "  run: yourskills login"
-      ];
-    case "behind": {
-      const lines = [
-        `yourskills: ${count(outcome.moved.length, "skill")} ${outcome.moved.length === 1 ? "has" : "have"} a newer version in your registry (autoUpdate is off)`
-      ];
-      for (const row of outcome.moved) {
-        lines.push(`  ${row.name}  ${shortRef(row.installed)} -> ${shortRef(row.available)}${column(driftTag(row))}`);
-      }
-      lines.push("  run: yourskills update --all");
-      return lines;
-    }
-    case "updated": {
-      const { applied, failed } = outcome;
-      const lines = [
-        applied.length > 0 ? `yourskills: updated ${count(applied.length, "skill")} to what your registry pins; ${applied.length === 1 ? "it is" : "they are"} live in this session.` : `yourskills: could not update ${count(failed.length, "skill")}`
-      ];
-      for (const row of applied) {
-        lines.push(`  ${row.name}  ${row.from} -> ${row.to}`);
-      }
-      for (const row of failed) {
-        lines.push(`  ${row.name}  failed: ${row.message}`);
-      }
-      if (applied.length > 0)
-        lines.push(`  recorded in ${outcome.manifest}`);
-      if (failed.length > 0)
-        lines.push("  run: yourskills doctor");
-      return lines;
-    }
-  }
-}
-function describeForModel(outcome) {
-  switch (outcome.kind) {
-    case "quiet":
-      return [];
-    case "signed-out":
-      return [
-        "yourskills: the user's session with the skills registry has expired, so installed skills are no longer being updated. The user has been told to run `yourskills login`; it is their call."
-      ];
-    case "behind": {
-      const lines = [
-        `yourskills: ${count(outcome.moved.length, "installed skill")} ${outcome.moved.length === 1 ? "is" : "are"} behind the registry. Automatic updates are off; the user has been told and it is their call whether to run \`yourskills update --all\`.`
-      ];
-      for (const row of outcome.moved) {
-        lines.push(`  ${row.name}  installed ${shortRef(row.installed)}, registry pins ${shortRef(row.available)}${column(driftTag(row))}`);
-      }
-      return lines;
-    }
-    case "updated": {
-      const { applied, failed } = outcome;
-      const lines = [];
-      if (applied.length > 0) {
-        lines.push(`yourskills updated ${count(applied.length, "installed skill")} on disk at the start of this session. The contents changed: re-read a skill before relying on what you remember of it.`);
-        for (const row of applied) {
-          lines.push(`  ${row.name}  ${row.from} -> ${row.to}`);
-        }
-        lines.push(`  recorded in ${outcome.manifest}`);
-      }
-      if (failed.length > 0) {
-        lines.push(`yourskills could not update ${count(failed.length, "installed skill")}; the version on disk is unchanged. The user has been told.`);
-        for (const row of failed) {
-          lines.push(`  ${row.name}  ${row.message}`);
-        }
-      }
-      return lines;
-    }
-  }
-}
-function count(n, noun) {
-  return `${n} ${noun}${n === 1 ? "" : "s"}`;
-}
-function column(text) {
-  return text ? `  ${text}` : "";
-}
-function emit(outcome) {
-  const lines = describe(outcome);
-  if (lines.length === 0)
-    return;
-  const installed = outcome.kind === "updated" && outcome.applied.length > 0;
-  console.log(JSON.stringify({
-    systemMessage: lines.join(`
-`),
-    hookSpecificOutput: {
-      hookEventName: "SessionStart",
-      additionalContext: describeForModel(outcome).join(`
-`),
-      ...installed ? { reloadSkills: true } : {}
-    }
-  }));
-}
-// src/hooks/ensure.ts
-import { existsSync as existsSync3 } from "node:fs";
-async function registerInto(adapter) {
-  const wanted2 = adapter.entries.filter((entry) => entry.kind === "update-check");
-  if (wanted2.length === 0)
-    return null;
-  const path = adapter.settingsPath();
-  if (!path)
-    return null;
-  if (!existsSync3(adapter.home()))
-    return null;
-  const applied = await applyTo(path, (settings) => addHooks(settings, wanted2));
-  if (!applied.changed)
-    return null;
-  return { agent: adapter.agent, path, entries: wanted2 };
-}
-function linesFor(registered) {
-  const agents = registered.map((r) => r.agent).join(", ");
-  const lines = [
-    `+ yourskills will check your skills once a day, when ${agents} starts, and update what moved`
-  ];
-  for (const { agent, path } of registered) {
-    lines.push(`  ${agent}  ${path}`);
-  }
-  lines.push("  undo with: yourskills hooks uninstall");
-  if (!trackingDisabledByEnv()) {
-    lines.push("  usage counting stays off; turn it on with: yourskills hooks install --track");
-  }
-  return lines;
-}
-async function ensureHooksRegistered() {
-  try {
-    const config = await readConfig();
-    if (config.hooksOffered)
-      return [];
-    if (!config.token)
-      return [];
-    const registered = [];
-    for (const adapter of HOOK_ADAPTERS) {
-      try {
-        const result = await registerInto(adapter);
-        if (result)
-          registered.push(result);
-      } catch {}
-    }
-    await updateConfig((stored) => ({
-      ...stored,
-      hooksOffered: new Date().toISOString()
-    }));
-    return registered.length > 0 ? linesFor(registered) : [];
-  } catch {
-    return [];
-  }
-}
-// src/hooks/install.ts
-import { existsSync as existsSync4 } from "node:fs";
-var PAYLOAD_DISCLOSURE = [
-  { mark: "none", text: "Usage tracking sends, once per skill invocation:" },
-  { mark: "none", text: "  skillExternalId", note: "the skill's registry id" },
-  { mark: "none", text: "  ref", note: "the commit you installed it at" },
-  { mark: "none", text: "  agent", note: "which agent ran it" },
-  { mark: "none", text: "  occurredAt", note: "when it ran" },
-  {
-    mark: "none",
-    text: "  (nothing else)",
-    note: "the server adds a keyed hash of you; the CLI never sends a user id"
-  }
-];
-function trackNote(track) {
-  if (trackingDisabledByEnv())
-    return "off (YOURSKILLS_NO_TRACK is set)";
-  return track ? "on" : "off — enable with `yourskills hooks install --track`";
-}
-function selectAdapters(agent) {
-  if (agent) {
-    const found = adapterFor(agent);
-    if (!found)
-      return { adapters: [], unknown: [agent], absent: [] };
-    return existsSync4(found.home()) ? { adapters: [found], unknown: [], absent: [] } : { adapters: [], unknown: [], absent: [found] };
-  }
-  return {
-    adapters: HOOK_ADAPTERS.filter((a) => existsSync4(a.home())),
-    unknown: [],
-    absent: []
-  };
-}
-async function pinnedAdapters() {
-  const pinned = await resolveAgents();
-  if (pinned.length === 0)
-    return null;
-  const adapters = pinned.map((name) => adapterFor(name)).filter((a) => a !== undefined).filter((a) => existsSync4(a.home()));
-  return adapters.length > 0 ? adapters : null;
-}
-async function installInto(adapter, optedIn) {
-  const path = adapter.settingsPath();
-  const result = {
-    agent: adapter.agent,
-    path,
-    installed: [],
-    already: [],
-    skipped: []
-  };
-  if (!path) {
-    for (const kind of adapter.supports) {
-      result.skipped.push({
-        kind,
-        why: adapter.limitation ?? "not supported yet"
-      });
-    }
-    return result;
-  }
-  const wanted2 = [];
-  for (const entry of adapter.entries) {
-    if (entry.kind === "usage" && !optedIn) {
-      result.skipped.push({ kind: entry.kind, why: trackNote(false) });
-      continue;
-    }
-    wanted2.push(entry);
-  }
-  let present = new Set;
-  const applied = await applyTo(path, (settings) => {
-    present = new Set(registeredEntries(settings, wanted2).map((entry) => entry.kind));
-    return addHooks(settings, wanted2);
-  });
-  if (applied.error) {
-    result.error = applied.error;
-    return result;
-  }
-  for (const entry of wanted2) {
-    if (present.has(entry.kind))
-      result.already.push(entry.kind);
-    else
-      result.installed.push(entry.kind);
-  }
-  if (applied.changed && result.already.length > 0) {
-    result.repaired = result.already;
-    result.already = [];
-  }
-  return result;
-}
-function linesFor2(result) {
-  const lines = [];
-  if (result.error) {
-    lines.push({
-      mark: "fail",
-      text: `${result.agent}: left untouched`,
-      note: result.error
-    });
-    return lines;
-  }
-  for (const kind of result.installed) {
-    lines.push({
-      mark: "ok",
-      text: `${result.agent}  ${kind}`,
-      note: result.path ?? ""
-    });
-  }
-  for (const kind of result.repaired ?? []) {
-    lines.push({
-      mark: "ok",
-      text: `${result.agent}  ${kind}`,
-      note: `updated  ${result.path ?? ""}`.trim()
+      text: `${result.agent}  ${kind}`,
+      note: `updated  ${result.path ?? ""}`.trim()
     });
   }
   for (const kind of result.already) {
@@ -5356,11 +5002,11 @@ async function hooksInstall(opts = {}) {
     await writeConfig({ ...config2, track: opts.track });
   }
   const config = await readConfig();
-  const optedIn = !trackingDisabledByEnv() && config.track === true;
+  const tracking = trackingOn(config);
   const { adapters: selected, unknown, absent } = selectAdapters(opts.agent);
   const adapters = opts.agent === undefined ? await pinnedAdapters() ?? selected : selected;
   const lines = [...PAYLOAD_DISCLOSURE];
-  lines.push({ mark: "none", text: "tracking", note: trackNote(optedIn) });
+  lines.push({ mark: "none", text: "tracking", note: trackNote(tracking) });
   for (const agent of unknown) {
     lines.push({
       mark: "fail",
@@ -5385,9 +5031,9 @@ async function hooksInstall(opts = {}) {
   }
   const results = [];
   for (const adapter of adapters) {
-    const result = await installInto(adapter, optedIn);
+    const result = await installInto(adapter, tracking);
     results.push(result);
-    lines.push(...linesFor2(result));
+    lines.push(...linesFor(result));
   }
   if (adapters.length === 0 && unknown.length === 0 && absent.length === 0) {
     lines.push({
@@ -5400,7 +5046,7 @@ async function hooksInstall(opts = {}) {
     title: "hooks install",
     lines,
     json: {
-      track: optedIn,
+      track: tracking,
       agents: results,
       unknown,
       absent: absent.map((a) => a.agent)
@@ -5451,9 +5097,9 @@ async function hooksUninstall(opts = {}) {
 }
 async function hooksStatus() {
   const config = await readConfig();
-  const optedIn = !trackingDisabledByEnv() && config.track === true;
+  const tracking = trackingOn(config);
   const lines = [
-    { mark: "none", text: "tracking", note: trackNote(optedIn) }
+    { mark: "none", text: "tracking", note: trackNote(tracking) }
   ];
   const agents = [];
   for (const agent of agentsToReport(config.agents ?? [])) {
@@ -5508,194 +5154,392 @@ async function hooksStatus() {
   return {
     title: "hooks status",
     lines,
-    json: { track: optedIn, agents }
+    json: { track: tracking, agents }
   };
 }
-// src/hooks/session.ts
-var CHECK_BUDGET_MS = 5000;
-var UPDATE_BUDGET_MS = 90000;
-var DAY_MS = 86400000;
-var REAL = {
-  now: () => Date.now(),
-  readConfig,
-  updateConfig,
-  connect: () => createClient(),
-  nearestManifest: () => nearestManifest(),
-  driftNow,
-  add,
-  checkBudgetMs: CHECK_BUDGET_MS,
-  resolveAgents: () => resolveAgents(),
-  landed: listInstalled
-};
-function updateCheckDue(last, now = Date.now()) {
-  if (!last)
+
+// src/hooks/audit.ts
+function wanted(entries, tracking) {
+  return entries.filter((entry) => entry.kind === "update-check" || tracking);
+}
+async function hookGaps() {
+  const config = await readConfig();
+  const optedIn = trackingOn(config);
+  const gaps = [];
+  for (const adapter of HOOK_ADAPTERS) {
+    const path = adapter.settingsPath();
+    if (!path || !existsSync3(adapter.home()))
+      continue;
+    const expected = wanted(adapter.entries, optedIn);
+    if (expected.length === 0)
+      continue;
+    const file = await readSettingsFile(path);
+    if (!file.ok) {
+      gaps.push({
+        agent: adapter.agent,
+        path,
+        registered: [],
+        missing: [],
+        error: file.error
+      });
+      continue;
+    }
+    const registered = registeredEntries(file.settings, expected).map((entry) => entry.kind);
+    gaps.push({
+      agent: adapter.agent,
+      path,
+      registered,
+      missing: expected.map((entry) => entry.kind).filter((kind) => !registered.includes(kind))
+    });
+  }
+  return gaps;
+}
+async function registerMissing(gap) {
+  const adapter = HOOK_ADAPTERS.find((a) => a.agent === gap.agent);
+  const entries = adapter?.entries.filter((entry) => gap.missing.includes(entry.kind));
+  if (!adapter || !entries || entries.length === 0)
+    throw new Error(`nothing to register for ${gap.agent}`);
+  const applied = await applyTo(gap.path, (settings) => addHooks(settings, entries));
+  if (applied.error)
+    throw new Error(applied.error);
+  return `registered ${gap.missing.join(" + ")} in ${gap.path}`;
+}
+// ../../packages/bundles/src/drift.ts
+var SHORT_SHA = 7;
+function namesSameCommit(prefix, full) {
+  const short = prefix.trim().toLowerCase();
+  const long = full.trim().toLowerCase();
+  if (short === long)
     return true;
-  const at = Date.parse(last);
-  return Number.isNaN(at) || now - at >= DAY_MS;
+  return short.length >= SHORT_SHA && long.startsWith(short);
 }
-function withBudget(work, ms) {
-  return Promise.race([
-    work,
-    new Promise((resolve3) => {
-      const timer = setTimeout(() => resolve3(undefined), ms);
-      timer.unref?.();
-    })
-  ]);
+
+// src/installed/installed.ts
+var shortRef = (ref) => ref.slice(0, SHORT_SHA);
+function refColumn(row) {
+  return row.unpinned ? "unpinned" : shortRef(row.ref);
 }
-async function check(ports, client, nearest) {
-  try {
-    const report2 = await ports.driftNow(client, nearest);
-    return { ok: true, moved: report2.moved };
-  } catch (error) {
-    return { ok: false, signedOut: isUnauthorized(error) };
-  }
+function installedRows(nearest) {
+  return Object.values(nearest.manifest.skills).map((entry) => ({
+    name: entry.name,
+    ref: entry.ref,
+    bundle: entry.bundle ?? null,
+    scope: nearest.manifest.scope,
+    unpinned: entry.unpinned === true
+  })).sort((a, b) => a.name.localeCompare(b.name));
 }
-async function applyUpdates(ports, client, nearest, moved, deadline) {
-  const where2 = {
-    ...nearest,
-    agents: await ports.resolveAgents(),
-    landed: ports.landed
-  };
-  const wanted2 = new Map(moved.map((row) => [row.name, row]));
-  const applied = [];
-  const failed = [];
-  const names = [
-    ...new Set(moved.map((row) => row.bundle).filter((name) => !!name))
-  ].sort().map((bundle) => `bundle:${bundle}`).concat(moved.filter((row) => !row.bundle).map((row) => row.name).sort());
-  try {
-    for await (const event of ports.add(names, where2, async () => client).stream()) {
-      if (event.kind === "installed") {
-        const row = wanted2.get(event.location.skillName);
-        if (row) {
-          applied.push({
-            name: row.name,
-            from: shortRef(row.installed),
-            to: shortRef(row.available)
-          });
-        }
-      } else if (event.kind === "failed" && wanted2.has(event.name)) {
-        failed.push({ name: event.name, message: event.message });
+function columns(rows) {
+  const names = Math.max(...rows.map((r) => r.name.length));
+  const bundles = Math.max(...rows.map((r) => (r.bundle ?? "-").length));
+  return rows.map((row) => ({
+    mark: "none",
+    text: `${row.name.padEnd(names)}  ${refColumn(row)}`,
+    note: `${(row.bundle ?? "-").padEnd(bundles)}  ${row.scope}`
+  }));
+}
+function installedReport(nearest) {
+  const rows = installedRows(nearest);
+  const lines = rows.length === 0 ? [
+    {
+      mark: "none",
+      text: "Nothing installed. Run `yourskills add <name>`.",
+      note: nearest.path
+    }
+  ] : columns(rows);
+  return {
+    title: "installed",
+    lines,
+    json: {
+      manifest: nearest.path,
+      scope: nearest.manifest.scope,
+      skills: rows
+    },
+    ...rows.length === 0 ? {
+      next: {
+        command: "yourskills browse",
+        why: "pick something to install"
       }
-      if (ports.now() > deadline)
-        break;
+    } : {}
+  };
+}
+// src/installed/outdated.ts
+function driftTag(row) {
+  return lifecycleTag(row.deprecated ? "deprecated" : undefined);
+}
+function hasMoved(installed, available) {
+  return !(namesSameCommit(available, installed) || namesSameCommit(installed, available));
+}
+function drift(manifest, pins, catalog) {
+  const byExternalId = new Map(catalog.map((row) => [row.externalId, row]));
+  const byName = new Map(catalog.map((row) => [row.name, row]));
+  const moved = [];
+  const unknown = [];
+  const unpinned = [];
+  for (const entry of Object.values(manifest.skills)) {
+    if (entry.unpinned) {
+      unpinned.push(entry.name);
+      continue;
     }
-  } catch (error) {
-    failed.push({
-      name: names.join(", "),
-      message: error instanceof Error ? error.message : String(error)
+    const row = byExternalId.get(entry.externalId) ?? byName.get(entry.name);
+    if (!row) {
+      unknown.push(entry.name);
+      continue;
+    }
+    const pin = entry.bundle ? pins.find((p) => p.bundle === entry.bundle && p.skillId === row.id) : undefined;
+    const available = pin?.pinnedSha ?? row.currentSha;
+    if (!hasMoved(entry.ref, available))
+      continue;
+    moved.push({
+      name: entry.name,
+      bundle: entry.bundle ?? null,
+      installed: entry.ref,
+      available,
+      deprecated: pin?.deprecated ?? row.status === "deprecated"
     });
   }
-  if (applied.length === 0 && failed.length === 0)
-    return { kind: "quiet" };
-  return { kind: "updated", applied, failed, manifest: nearest.path };
+  moved.sort((a, b) => a.name.localeCompare(b.name));
+  return { moved, unknown, unpinned };
 }
-async function sessionStart(ports = {}) {
-  const use = { ...REAL, ...ports };
-  const config = await use.readConfig();
-  if (!updateCheckDue(config.lastUpdateCheck, use.now())) {
-    return { kind: "quiet" };
+async function driftNow(client, nearest) {
+  const [pins, catalog] = await Promise.all([
+    client.bundles.pins.query(),
+    client.skills.list.query({})
+  ]);
+  return drift(nearest.manifest, pins, catalog);
+}
+async function outdatedReport(client, nearest, quiet = false) {
+  let report2;
+  try {
+    report2 = await driftNow(client, nearest);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      title: "outdated",
+      lines: [
+        { mark: "fail", text: "Could not reach the registry.", note: message }
+      ],
+      json: { manifest: nearest.path, error: message },
+      silent: quiet
+    };
   }
-  const written = await use.updateConfig((current) => ({
-    ...current,
-    lastUpdateCheck: new Date(use.now()).toISOString()
+  const lines = report2.moved.map((row) => ({
+    mark: "pending",
+    text: `${row.name}  ${shortRef(row.installed)} -> ${shortRef(row.available)}`,
+    note: [row.bundle ?? "-", driftTag(row)].filter(Boolean).join("  ")
   }));
-  if (written === null)
-    return { kind: "quiet" };
-  if (!config.token)
-    return { kind: "quiet" };
-  let client;
-  let nearest;
-  try {
-    client = await use.connect();
-    nearest = await use.nearestManifest();
-  } catch {
-    return { kind: "quiet" };
+  for (const name of report2.unknown) {
+    lines.push({
+      mark: "fail",
+      text: name,
+      note: "no longer in your registry"
+    });
   }
-  if (Object.keys(nearest.manifest.skills).length === 0)
-    return { kind: "quiet" };
-  const found = await withBudget(check(use, client, nearest), use.checkBudgetMs);
-  if (!found)
-    return { kind: "quiet" };
-  if (!found.ok)
-    return found.signedOut ? { kind: "signed-out" } : { kind: "quiet" };
-  if (found.moved.length === 0)
-    return { kind: "quiet" };
-  if (config.autoUpdate === false) {
-    return { kind: "behind", moved: found.moved, manifest: nearest.path };
+  for (const name of report2.unpinned) {
+    lines.push({
+      mark: "pending",
+      text: name,
+      note: "not in your registry; imported from disk, nothing to compare"
+    });
   }
-  return applyUpdates(use, client, nearest, found.moved, use.now() + UPDATE_BUDGET_MS);
+  const current = report2.moved.length === 0 && report2.unknown.length === 0;
+  if (current && !quiet) {
+    lines.push({
+      mark: "ok",
+      text: "Everything is at the ref your registry pins."
+    });
+  }
+  return {
+    title: "outdated",
+    lines,
+    json: {
+      manifest: nearest.path,
+      outdated: report2.moved,
+      unknown: report2.unknown,
+      unpinned: report2.unpinned
+    },
+    silent: quiet && current,
+    ...report2.moved.length > 0 ? {
+      next: {
+        command: "yourskills update --all",
+        why: "install what moved"
+      }
+    } : {}
+  };
 }
-
-// src/hooks/run.ts
-function isHookEventName(value) {
-  return value === "session-start" || value === "post-tool-use";
+// src/hooks/emit.ts
+function describe(outcome) {
+  switch (outcome.kind) {
+    case "quiet":
+      return [];
+    case "signed-out":
+      return [
+        "yourskills: your sign-in has expired, so your skills are no longer kept up to date.",
+        "  run: yourskills login"
+      ];
+    case "behind": {
+      const lines = [
+        `yourskills: ${count(outcome.moved.length, "skill")} ${outcome.moved.length === 1 ? "has" : "have"} a newer version in your registry (autoUpdate is off)`
+      ];
+      for (const row of outcome.moved) {
+        lines.push(`  ${row.name}  ${shortRef(row.installed)} -> ${shortRef(row.available)}${column(driftTag(row))}`);
+      }
+      lines.push("  run: yourskills update --all");
+      return lines;
+    }
+    case "updated": {
+      const { applied, failed } = outcome;
+      const lines = [
+        applied.length > 0 ? `yourskills: updated ${count(applied.length, "skill")} to what your registry pins; ${applied.length === 1 ? "it is" : "they are"} live in this session.` : `yourskills: could not update ${count(failed.length, "skill")}`
+      ];
+      for (const row of applied) {
+        lines.push(`  ${row.name}  ${row.from} -> ${row.to}`);
+      }
+      for (const row of failed) {
+        lines.push(`  ${row.name}  failed: ${row.message}`);
+      }
+      if (applied.length > 0)
+        lines.push(`  recorded in ${outcome.manifest}`);
+      if (failed.length > 0)
+        lines.push("  run: yourskills doctor");
+      return lines;
+    }
+  }
 }
-var STDIN_BUDGET_MS = 2000;
-async function readStdin() {
-  if (process.stdin.isTTY)
-    return {};
-  const text = await Promise.race([
-    (async () => {
-      let raw = "";
-      process.stdin.setEncoding("utf8");
-      for await (const chunk of process.stdin)
-        raw += chunk;
-      return raw;
-    })(),
-    new Promise((resolve3) => {
-      const timer = setTimeout(() => resolve3(""), STDIN_BUDGET_MS);
-      timer.unref?.();
-    })
-  ]);
-  if (text.trim().length === 0)
-    return {};
-  try {
-    return JSON.parse(text);
-  } catch {
-    return {};
+function describeForModel(outcome) {
+  switch (outcome.kind) {
+    case "quiet":
+      return [];
+    case "signed-out":
+      return [
+        "yourskills: the user's session with the skills registry has expired, so installed skills are no longer being updated. The user has been told to run `yourskills login`; it is their call."
+      ];
+    case "behind": {
+      const lines = [
+        `yourskills: ${count(outcome.moved.length, "installed skill")} ${outcome.moved.length === 1 ? "is" : "are"} behind the registry. Automatic updates are off; the user has been told and it is their call whether to run \`yourskills update --all\`.`
+      ];
+      for (const row of outcome.moved) {
+        lines.push(`  ${row.name}  installed ${shortRef(row.installed)}, registry pins ${shortRef(row.available)}${column(driftTag(row))}`);
+      }
+      return lines;
+    }
+    case "updated": {
+      const { applied, failed } = outcome;
+      const lines = [];
+      if (applied.length > 0) {
+        lines.push(`yourskills updated ${count(applied.length, "installed skill")} on disk at the start of this session. The contents changed: re-read a skill before relying on what you remember of it.`);
+        for (const row of applied) {
+          lines.push(`  ${row.name}  ${row.from} -> ${row.to}`);
+        }
+        lines.push(`  recorded in ${outcome.manifest}`);
+      }
+      if (failed.length > 0) {
+        lines.push(`yourskills could not update ${count(failed.length, "installed skill")}; the version on disk is unchanged. The user has been told.`);
+        for (const row of failed) {
+          lines.push(`  ${row.name}  ${row.message}`);
+        }
+      }
+      return lines;
+    }
   }
 }
-async function lookup(name, cwd) {
-  const nearest = await nearestManifest(undefined, cwd);
-  const found = nearest.manifest.skills[name];
-  if (found)
-    return found;
-  if (nearest.scope === "global")
+function describeStale(stale) {
+  if (!stale)
+    return [];
+  return [
+    `yourskills: you are running ${stale.current}; ${stale.latest} is out.`,
+    "  run: yourskills upgrade"
+  ];
+}
+function describeStaleForModel(stale) {
+  if (!stale)
+    return [];
+  return [
+    `yourskills: the installed CLI is ${stale.current} and ${stale.latest} is published. If the user hits a bug in the \`yourskills\` command itself, check whether it is fixed on the newer version before investigating further. Upgrading is their call; they have been told.`
+  ];
+}
+function count(n, noun) {
+  return `${n} ${noun}${n === 1 ? "" : "s"}`;
+}
+function column(text) {
+  return text ? `  ${text}` : "";
+}
+function emit(outcome, stale = null) {
+  const lines = [...describe(outcome), ...describeStale(stale)];
+  if (lines.length === 0)
     return;
-  const global = readManifest(manifestPathFor("global"));
-  return global.skills[name];
+  const installed = outcome.kind === "updated" && outcome.applied.length > 0;
+  console.log(JSON.stringify({
+    systemMessage: lines.join(`
+`),
+    hookSpecificOutput: {
+      hookEventName: "SessionStart",
+      additionalContext: [
+        ...describeForModel(outcome),
+        ...describeStaleForModel(stale)
+      ].join(`
+`),
+      ...installed ? { reloadSkills: true } : {}
+    }
+  }));
 }
-async function queueInvocation(payload, now = new Date) {
-  if (!await trackingEnabled())
-    return null;
-  const name = payload.tool_input?.skill;
-  if (typeof name !== "string" || name.length === 0)
-    return null;
-  const entry = await lookup(name, payload.cwd);
-  if (!entry)
+// src/hooks/ensure.ts
+import { existsSync as existsSync4 } from "node:fs";
+async function registerInto(adapter, tracking) {
+  const wanted2 = adapter.entries.filter((entry) => entry.kind === "update-check" || tracking);
+  if (wanted2.length === 0)
     return null;
-  const event = {
-    skillExternalId: entry.externalId,
-    ref: entry.ref,
-    agent: agentForEvent("usage", "PostToolUse"),
-    occurredAt: now.toISOString()
-  };
-  await appendEvent(event);
-  return event;
+  const path = adapter.settingsPath();
+  if (!path)
+    return null;
+  if (!existsSync4(adapter.home()))
+    return null;
+  const applied = await applyTo(path, (settings) => addHooks(settings, wanted2));
+  if (!applied.changed)
+    return null;
+  return { agent: adapter.agent, path, entries: wanted2 };
 }
-async function runHook(event) {
-  try {
-    const payload = await readStdin();
-    if (event === "post-tool-use")
-      await queueInvocation(payload);
-    else
-      await runSessionStart();
-  } catch {}
-  process.exitCode = 0;
+function linesFor2(registered, tracking) {
+  const agents = registered.map((r) => r.agent).join(", ");
+  const usage = registered.some((r) => r.entries.some((entry) => entry.kind === "usage"));
+  const lines = [
+    `+ yourskills will check your skills once a day, when ${agents} starts, and update what moved`
+  ];
+  if (usage) {
+    lines.push(`+ yourskills will count which of your organization's skills you invoke in ${agents}, so your organization can see what is used`);
+  }
+  for (const { agent, path } of registered) {
+    lines.push(`  ${agent}  ${path}`);
+  }
+  lines.push("  undo with: yourskills hooks uninstall");
+  if (usage && tracking && !trackingDisabledByEnv()) {
+    lines.push("  turn usage counting off with: yourskills config set track false");
+  }
+  return lines;
 }
-async function runSessionStart() {
-  await flushQuietly();
-  emit(await sessionStart());
+async function ensureHooksRegistered() {
+  try {
+    const config = await readConfig();
+    if (config.hooksOffered)
+      return [];
+    if (!config.token)
+      return [];
+    const tracking = trackingOn(config);
+    const registered = [];
+    for (const adapter of HOOK_ADAPTERS) {
+      try {
+        const result = await registerInto(adapter, tracking);
+        if (result)
+          registered.push(result);
+      } catch {}
+    }
+    await updateConfig((stored) => ({
+      ...stored,
+      hooksOffered: new Date().toISOString()
+    }));
+    return registered.length > 0 ? linesFor2(registered, tracking) : [];
+  } catch {
+    return [];
+  }
 }
 // src/upgrade/upgrade.ts
 import { spawn as spawn3 } from "node:child_process";
@@ -5703,7 +5547,7 @@ import { realpathSync } from "node:fs";
 // package.json
 var package_default = {
   name: "yourskills",
-  version: "0.1.4",
+  version: "0.1.5",
   description: "Browse, install and keep up to date the agent skills and bundles your team publishes on yourskills.",
   license: "UNLICENSED",
   homepage: "https://yourskills.store",
@@ -5762,7 +5606,7 @@ var VERSION = package_default.version ?? "0.0.0-dev";
 // src/upgrade/upgrade.ts
 var PACKAGE = "yourskills";
 var REGISTRY = `https://registry.npmjs.org/${PACKAGE}/latest`;
-var DAY_MS2 = 24 * 60 * 60 * 1000;
+var DAY_MS = 24 * 60 * 60 * 1000;
 function installMethod(entry = process.argv[1], env = process.env) {
   let path = entry ?? "";
   try {
@@ -5921,33 +5765,232 @@ async function remember(latest) {
     }));
   } catch {}
 }
-async function upgradeNotice(now = new Date) {
+var ASK_TIMEOUT_MS = 1500;
+async function upgradeCheck({
+  now = new Date,
+  current = VERSION,
+  ask = latestVersion
+} = {}) {
   if (process.env.YOURSKILLS_NO_UPGRADE_CHECK === "1")
     return null;
   try {
     const config = await readConfig();
     const last = config.lastUpgradeCheck ? Date.parse(config.lastUpgradeCheck) : 0;
     let latest = config.latestVersion ?? null;
-    if (Number.isNaN(last) || now.getTime() - last >= DAY_MS2) {
+    if (Number.isNaN(last) || now.getTime() - last >= DAY_MS) {
       await updateConfig((stored) => ({
         ...stored,
         lastUpgradeCheck: now.toISOString()
       }));
-      latest = await latestVersion(1500);
-      const answered = latest;
-      if (answered)
+      const answered = await ask(ASK_TIMEOUT_MS);
+      if (answered) {
+        latest = answered;
         await updateConfig((stored) => ({
           ...stored,
           latestVersion: answered
         }));
+      }
     }
-    if (!latest || !isNewer(latest, VERSION))
+    if (!latest || !isNewer(latest, current))
       return null;
-    return `+ yourskills ${latest} is out; you have ${VERSION}. run: yourskills upgrade`;
+    return { current, latest };
   } catch {
     return null;
   }
 }
+async function upgradeNotice(now = new Date) {
+  const stale = await upgradeCheck({ now });
+  if (!stale)
+    return null;
+  return `+ yourskills ${stale.latest} is out; you have ${stale.current}. run: yourskills upgrade`;
+}
+// src/hooks/session.ts
+var CHECK_BUDGET_MS = 5000;
+var UPDATE_BUDGET_MS = 90000;
+var DAY_MS2 = 86400000;
+var REAL = {
+  now: () => Date.now(),
+  readConfig,
+  updateConfig,
+  connect: () => createClient(),
+  nearestManifest: () => nearestManifest(),
+  driftNow,
+  add,
+  checkBudgetMs: CHECK_BUDGET_MS,
+  resolveAgents: () => resolveAgents(),
+  landed: listInstalled
+};
+function updateCheckDue(last, now = Date.now()) {
+  if (!last)
+    return true;
+  const at = Date.parse(last);
+  return Number.isNaN(at) || now - at >= DAY_MS2;
+}
+function withBudget(work, ms) {
+  return Promise.race([
+    work,
+    new Promise((resolve3) => {
+      const timer = setTimeout(() => resolve3(undefined), ms);
+      timer.unref?.();
+    })
+  ]);
+}
+async function check(ports, client, nearest) {
+  try {
+    const report2 = await ports.driftNow(client, nearest);
+    return { ok: true, moved: report2.moved };
+  } catch (error) {
+    return { ok: false, signedOut: isUnauthorized(error) };
+  }
+}
+async function applyUpdates(ports, client, nearest, moved, deadline) {
+  const where2 = {
+    ...nearest,
+    agents: await ports.resolveAgents(),
+    landed: ports.landed
+  };
+  const wanted2 = new Map(moved.map((row) => [row.name, row]));
+  const applied = [];
+  const failed = [];
+  const names = [
+    ...new Set(moved.map((row) => row.bundle).filter((name) => !!name))
+  ].sort().map((bundle) => `bundle:${bundle}`).concat(moved.filter((row) => !row.bundle).map((row) => row.name).sort());
+  try {
+    for await (const event of ports.add(names, where2, async () => client).stream()) {
+      if (event.kind === "installed") {
+        const row = wanted2.get(event.location.skillName);
+        if (row) {
+          applied.push({
+            name: row.name,
+            from: shortRef(row.installed),
+            to: shortRef(row.available)
+          });
+        }
+      } else if (event.kind === "failed" && wanted2.has(event.name)) {
+        failed.push({ name: event.name, message: event.message });
+      }
+      if (ports.now() > deadline)
+        break;
+    }
+  } catch (error) {
+    failed.push({
+      name: names.join(", "),
+      message: error instanceof Error ? error.message : String(error)
+    });
+  }
+  if (applied.length === 0 && failed.length === 0)
+    return { kind: "quiet" };
+  return { kind: "updated", applied, failed, manifest: nearest.path };
+}
+async function sessionStart(ports = {}) {
+  const use = { ...REAL, ...ports };
+  const config = await use.readConfig();
+  if (!updateCheckDue(config.lastUpdateCheck, use.now())) {
+    return { kind: "quiet" };
+  }
+  const written = await use.updateConfig((current) => ({
+    ...current,
+    lastUpdateCheck: new Date(use.now()).toISOString()
+  }));
+  if (written === null)
+    return { kind: "quiet" };
+  if (!config.token)
+    return { kind: "quiet" };
+  let client;
+  let nearest;
+  try {
+    client = await use.connect();
+    nearest = await use.nearestManifest();
+  } catch {
+    return { kind: "quiet" };
+  }
+  if (Object.keys(nearest.manifest.skills).length === 0)
+    return { kind: "quiet" };
+  const found = await withBudget(check(use, client, nearest), use.checkBudgetMs);
+  if (!found)
+    return { kind: "quiet" };
+  if (!found.ok)
+    return found.signedOut ? { kind: "signed-out" } : { kind: "quiet" };
+  if (found.moved.length === 0)
+    return { kind: "quiet" };
+  if (config.autoUpdate === false) {
+    return { kind: "behind", moved: found.moved, manifest: nearest.path };
+  }
+  return applyUpdates(use, client, nearest, found.moved, use.now() + UPDATE_BUDGET_MS);
+}
+
+// src/hooks/run.ts
+function isHookEventName(value) {
+  return value === "session-start" || value === "post-tool-use";
+}
+var STDIN_BUDGET_MS = 2000;
+async function readStdin() {
+  if (process.stdin.isTTY)
+    return {};
+  const text = await Promise.race([
+    (async () => {
+      let raw = "";
+      process.stdin.setEncoding("utf8");
+      for await (const chunk of process.stdin)
+        raw += chunk;
+      return raw;
+    })(),
+    new Promise((resolve3) => {
+      const timer = setTimeout(() => resolve3(""), STDIN_BUDGET_MS);
+      timer.unref?.();
+    })
+  ]);
+  if (text.trim().length === 0)
+    return {};
+  try {
+    return JSON.parse(text);
+  } catch {
+    return {};
+  }
+}
+async function lookup(name, cwd) {
+  const nearest = await nearestManifest(undefined, cwd);
+  const found = nearest.manifest.skills[name];
+  if (found)
+    return found;
+  if (nearest.scope === "global")
+    return;
+  const global = readManifest(manifestPathFor("global"));
+  return global.skills[name];
+}
+async function queueInvocation(payload, now = new Date) {
+  if (!await trackingEnabled())
+    return null;
+  const name = payload.tool_input?.skill;
+  if (typeof name !== "string" || name.length === 0)
+    return null;
+  const entry = await lookup(name, payload.cwd);
+  if (!entry)
+    return null;
+  const event = {
+    skillExternalId: entry.externalId,
+    ref: entry.ref,
+    agent: agentForEvent("usage", "PostToolUse"),
+    occurredAt: now.toISOString()
+  };
+  await appendEvent(event);
+  return event;
+}
+async function runHook(event) {
+  try {
+    const payload = await readStdin();
+    if (event === "post-tool-use")
+      await queueInvocation(payload);
+    else
+      await runSessionStart();
+  } catch {}
+  process.exitCode = 0;
+}
+async function runSessionStart() {
+  await flushQuietly();
+  const outcome = await sessionStart();
+  emit(outcome, await upgradeCheck());
+}
 // src/doctor/doctor.ts
 var REACH_TIMEOUT_MS = 5000;
 function withLogin(message) {
@@ -6281,7 +6324,7 @@ function trackFrom(config) {
     return ["off", "YOURSKILLS_NO_TRACK in the environment"];
   if (config.track !== undefined)
     return [config.track ? "on" : "off", `track in ${configPath()}`];
-  return ["off", "built-in default: opt in with `hooks install --track`"];
+  return ["on", "built-in default: turn off with `config set track false`"];
 }
 var LABEL = 12;
 function row(label, value, from) {
@@ -7101,7 +7144,7 @@ var TABLE = {
       },
       {
         usage: "hooks install",
-        blurb: "Register them: the session update, and usage if opted in"
+        blurb: "Register them: the session update, and usage unless turned off"
       },
       {
         usage: "hooks uninstall",
@@ -8031,7 +8074,18 @@ function AccountLine({ facts, width }) {
     ]
   });
 }
+function StaleLine({ stale, width }) {
+  const text = `${mark.ok} ${stale.latest} is out; you have ${stale.current}. type upgrade`;
+  return /* @__PURE__ */ jsx18(Box14, {
+    width: width - FRAME_CHROME,
+    children: /* @__PURE__ */ jsx18(Text16, {
+      color: tone.notice,
+      children: clip(text, width - FRAME_CHROME)
+    })
+  });
+}
 var RUN = "run";
+var ASK_NPM = () => upgradeCheck();
 var NO_EXIT_CODE = () => {
   return;
 };
@@ -8046,7 +8100,8 @@ function HomeScreen({
   onSummary,
   onWelcomed = async () => {
     return;
-  }
+  },
+  checkUpgrade = ASK_NPM
 }) {
   const { exit } = useApp7();
   const width = useFrameWidth();
@@ -8058,6 +8113,19 @@ function HomeScreen({
   const [route, setRoute] = useState11(null);
   const [welcome, setWelcome] = useState11(initial.firstRun);
   const [wizard, setWizard] = useState11(false);
+  const [stale, setStale] = useState11(null);
+  useEffect9(() => {
+    let live = true;
+    checkUpgrade().then((found) => {
+      if (live)
+        setStale(found);
+    }).catch(() => {
+      return;
+    });
+    return () => {
+      live = false;
+    };
+  }, [checkUpgrade]);
   const typed = useMemo4(() => typedCommand(query), [query]);
   const visible = useMemo4(() => {
     const filtered = filterCommands(groups, query);
@@ -8406,6 +8474,10 @@ function HomeScreen({
         facts,
         width
       }),
+      stale ? /* @__PURE__ */ jsx18(StaleLine, {
+        stale,
+        width
+      }) : null,
       /* @__PURE__ */ jsx18(Divider, {
         width
       }),