lopebase 0.4.3 → 0.6.0

package/README.md

@@ -16,6 +16,10 @@
   <a href="https://www.npmjs.com/package/@lopebase/adapter">@lopebase/adapter</a>
 </p>
 
+<p align="center">
+  <a href="https://allmcps.com/mcp/lopebase"><img src="https://allmcps.com/api/badge/lopebase?style=shield" alt="AllMCPs Verified"></a>
+</p>
+
 ---
 
 LopeBase is one place to see and run all of your products: traffic, search,
@@ -79,6 +83,7 @@ Made for web products, and fine with anything else:
 | --- | --- |
 | `npx lopebase` | Scan, connect, choose, and hand over to your agent. |
 | `npx lopebase login` | Connect this computer to your workspace with a short code, creating an account if you need one. `--paste` to paste an agent token instead. |
+| `npx lopebase update` | Update this project's LopeBase Adapter: what is new, then your agent does it. |
 | `npx lopebase scan` | Show what the scan found. `--json` for scripts. |
 | `npx lopebase prompt` | Print the setup prompt instead of starting an agent. |
 | `npx lopebase mcp` | Run the LopeBase tools as a local MCP server (stdio) for any agent. |

package/dist/lopebase.js

@@ -502,7 +502,7 @@ var require_cross_spawn = __commonJS(function(exports, module) {
 
 // bin/lopebase.ts
 import { spawn as spawn2 } from "node:child_process";
-import { readFileSync as readFileSync3 } from "node:fs";
+import { readFileSync as readFileSync4 } from "node:fs";
 
 // ../../node_modules/.bun/@clack+prompts@0.11.0/node_modules/@clack/prompts/dist/index.mjs
 import { stripVTControlCharacters as S2 } from "node:util";
@@ -1205,6 +1205,86 @@ var Y2 = ({ indicator: t = "dots" } = {}) => {
   } };
 };
 
+// ../admin-adapter/src/releases.ts
+var ADAPTER_VERSION = "0.3.1", ADAPTER_RELEASES = [
+  {
+    version: "0.3.1",
+    date: "2026-10-08",
+    features: [
+      "Reports its version to LopeBase, so the console can say when an update is out."
+    ],
+    steps: []
+  },
+  {
+    version: "0.3.0",
+    date: "2026-10-08",
+    features: [
+      "Service health: list the database, queues, workers, or other hosts the app needs, and LopeBase's uptime checks watch each one.",
+      "httpCheck(id, url) for a service that has its own health address."
+    ],
+    steps: [
+      "Read the code for what the app cannot work without (database, queue, workers, third-party APIs called on every request) and show the human the list.",
+      "Add them as `services` in createAdminAdapter: a check function each (a cheap query like select 1), or httpCheck for another host.",
+      "After deploying, set the product's uptime check in LopeBase to <app>/api/lopebase/health."
+    ]
+  },
+  {
+    version: "0.2.0",
+    date: "2026-10-01",
+    features: [
+      "The app's owner chooses how emails, names, phone numbers, and typed text reach LopeBase: in full, masked, or not at all."
+    ],
+    breaking: [
+      'An adapter with personal fields (email, name, phone, free text) will not start until `personalData` is set to "full", "masked", or "ids_only".'
+    ],
+    steps: [
+      "Ask the human how personal data may reach LopeBase (full, masked, or ids_only) and set `personalData` in createAdminAdapter to their answer.",
+      'Mark free-text fields people wrote, like messages and notes, with personal: "text".'
+    ]
+  },
+  {
+    version: "0.1.2",
+    date: "2026-09-30",
+    features: [
+      "Signed requests, the standard overview stats, and the conformance suite."
+    ],
+    steps: []
+  }
+];
+function compareVersions(a, b) {
+  let parts = (v) => (v.match(/^\D*(\d+)\.(\d+)\.(\d+)/) ?? []).slice(1).map(Number), [x, y] = [parts(a), parts(b)];
+  if (x.length !== 3)
+    return y.length === 3 ? -1 : 0;
+  if (y.length !== 3)
+    return 1;
+  for (let i = 0;i < 3; i++)
+    if (x[i] !== y[i])
+      return x[i] < y[i] ? -1 : 1;
+  return 0;
+}
+function releasesSince(version) {
+  return ADAPTER_RELEASES.filter((r) => !version || compareVersions(r.version, version) > 0).reverse();
+}
+function upgradePrompt(fromVersion) {
+  let todo = releasesSince(fromVersion), breaking = todo.flatMap((r) => r.breaking ?? []), steps = todo.flatMap((r) => r.steps);
+  return [
+    `Update this app's LopeBase adapter (@lopebase/adapter) from ${fromVersion ?? "its current version"} to 0.3.1.`,
+    "",
+    "1. Install it with this repo's package manager, for example `npm install @lopebase/adapter@latest`. A 0.x range like ^0.1.2 does not pick up 0.2 or later on its own.",
+    ...breaking.length ? [
+      "2. These changes would stop the adapter from starting; handle each one:",
+      ...breaking.map((b) => `   - ${b}`)
+    ] : ["2. Nothing in this update stops an existing adapter from starting."],
+    ...steps.length ? [
+      "3. Adopt what is new, asking the human before each change:",
+      ...steps.map((s) => `   - ${s}`)
+    ] : ["3. Nothing to add in code."],
+    "4. Run the app and `LOPEBASE_SIGNING_SECRET=... npx lopebase adapter check http://localhost:<port>/api/lopebase`, plus this repo's own tests. Fix anything that fails.",
+    "5. Summarize what changed. Never print the signing secret."
+  ].join(`
+`);
+}
+
 // ../admin-adapter/src/security.ts
 var SIGNATURE_HEADER = "lopebase-signature";
 var enc = /* @__PURE__ */ new TextEncoder;
@@ -1704,6 +1784,46 @@ var SOURCE_RULES = {
     },
     why: "Error counts next to your traffic, so a bad deploy shows up."
   },
+  rollbar: {
+    label: "Rollbar",
+    rule: {
+      deps: [
+        /^rollbar$/,
+        /^@rollbar\//,
+        /^py:rollbar$/,
+        /^gem:rollbar$/,
+        /^composer:rollbar\//
+      ],
+      env: [/ROLLBAR_ACCESS_TOKEN/]
+    },
+    why: "Error counts next to your traffic, so a bad deploy shows up."
+  },
+  honeybadger: {
+    label: "Honeybadger",
+    rule: {
+      deps: [
+        /^@honeybadger-io\//,
+        /^py:honeybadger$/,
+        /^gem:honeybadger$/,
+        /^composer:honeybadger-io\//
+      ],
+      env: [/HONEYBADGER_API_KEY/]
+    },
+    why: "Error counts next to your traffic, so a bad deploy shows up."
+  },
+  bugsnag: {
+    label: "Bugsnag",
+    rule: {
+      deps: [
+        /^@bugsnag\//,
+        /^py:bugsnag$/,
+        /^gem:bugsnag$/,
+        /^composer:bugsnag\//
+      ],
+      env: [/BUGSNAG_API_KEY/]
+    },
+    why: "Error counts next to your traffic, so a bad deploy shows up."
+  },
   stripe: {
     label: "Stripe",
     rule: {
@@ -2156,7 +2276,7 @@ function detectStack(facts) {
         why: SOURCE_RULES.posthog.why
       });
   }
-  if (!has("sentry")) {
+  if (!["sentry", "rollbar", "honeybadger", "bugsnag"].some((id) => has(id))) {
     if (gaps.push("No error logging found."), !listed("sentry"))
       sources.push({
         source: "sentry",
@@ -2168,6 +2288,38 @@ function detectStack(facts) {
   }
   return { stack: tidy, sources, gaps };
 }
+var QUEUES = [
+  [/^bullmq$|^bull$/, "Job queue (BullMQ)"],
+  [/^inngest$/, "Background jobs (Inngest)"],
+  [/^@trigger\.dev\//, "Background jobs (Trigger.dev)"],
+  [/^@upstash\/qstash$/, "Message queue (QStash)"],
+  [/^py:celery$/, "Job queue (Celery)"],
+  [/^gem:sidekiq$/, "Job queue (Sidekiq)"]
+], NOT_A_SERVICE = /* @__PURE__ */ new Set(["Prisma", "Drizzle"]);
+function watchList(d, facts) {
+  let slug = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, ""), out = [];
+  if (d.sources.some((s) => s.source === "uptime") || facts.siteUrl)
+    out.push({ id: "site", label: facts.siteUrl ?? "Website", how: "address" });
+  for (let s of d.stack)
+    if (s.kind === "database" && !NOT_A_SERVICE.has(s.name))
+      out.push({ id: slug(s.name), label: s.name, how: "service" });
+  for (let [re, label] of QUEUES)
+    if (facts.dependencies.some((dep) => re.test(dep)))
+      out.push({
+        id: slug(label.replace(/\s*\(.*\)/, "")) || "queue",
+        label,
+        how: "service"
+      });
+  let email = d.stack.find((s) => s.kind === "email" && s.name !== "Nodemailer");
+  if (email)
+    out.push({
+      id: "email",
+      label: `Email sending (${email.name})`,
+      how: "service"
+    });
+  let seen = /* @__PURE__ */ new Set;
+  return out.filter((w) => !seen.has(w.id) && seen.add(w.id));
+}
 
 // src/device-login.ts
 async function startDeviceLogin(url, opts = {}) {
@@ -2338,6 +2490,8 @@ function onboardingPrompt(input) {
     `- Stack: ${stack}`,
     `- Already in use: ${found.map((s) => s.label).join(", ") || "none of the sources LopeBase reads"}`,
     `- The human wants connected: ${chosen.join(", ") || "whatever get_onboarding_status recommends"}`,
+    `- Worth watching for uptime: ${(input.watch ?? []).map((w) => `${w.label} (${w.how === "address" ? "uptime check on its address" : "adapter health service"})`).join(", ") || "the site, if it has one"}`,
+    `- LopeBase pageviews: ${input.pageviews ? "yes, the human wants them" : "not chosen; offer once, do not push"}`,
     "",
     "How to work:",
     "1. Call get_onboarding_status first, and again after every step. Do the step it marks next.",
@@ -2346,7 +2500,9 @@ function onboardingPrompt(input) {
     "4. When a step needs the human (a browser sign-in, a payment, a permission, a key you cannot create), call request_human_action, tell them in one or two plain sentences what to do and why, and wait for them.",
     "5. Never print a secret in chat or write one to a tracked file. Pass keys straight to connect_source.",
     "6. For a source the project does not use yet (for example analytics), explain what it adds, ask before installing it, then add it the way this codebase does things.",
-    "7. Finish when get_onboarding_status says done. Summarize what is connected and anything left for later."
+    "7. Uptime: confirm the list above against the code, and add anything it misses (a separate API or app host, a third-party API called on every request). Show the human the list. With the adapter, declare the services and use <app>/api/lopebase/health as the uptime address; otherwise use the site's address.",
+    "8. Pageviews: if the human wants them, call get_pageview_snippet, add the tag once to the shared layout, deploy, and confirm with get_pageviews.",
+    "9. Finish when get_onboarding_status says done. Summarize what is connected and anything left for later."
   ].join(`
 `);
 }
@@ -2695,7 +2851,28 @@ function scanProject(root, onProgress) {
 }
 
 // src/ui.ts
-var import_picocolors3 = __toESM(require_picocolors(), 1), MARK = [
+var import_picocolors3 = __toESM(require_picocolors(), 1), RAMP = [
+  [214, 202, 245],
+  [195, 177, 240],
+  [176, 152, 235],
+  [163, 135, 231],
+  [146, 112, 220],
+  [131, 92, 208],
+  [123, 82, 201],
+  [103, 58, 183]
+], BRAND = [163, 135, 231];
+function trueColor(env = process.env) {
+  return /truecolor|24bit/i.test(env.COLORTERM ?? "");
+}
+function paint(rgb, text, bg = !1) {
+  if (!import_picocolors3.default.isColorSupported)
+    return text;
+  if (!trueColor())
+    return bg ? import_picocolors3.default.bgMagenta(import_picocolors3.default.black(text)) : import_picocolors3.default.magenta(text);
+  let [r, g, b] = rgb;
+  return `\x1B[${bg ? 48 : 38};2;${r};${g};${b}m${text}\x1B[${bg ? 49 : 39}m`;
+}
+var brand = (text) => paint(BRAND, text), badge = (text) => paint(BRAND, import_picocolors3.default.black(import_picocolors3.default.bold(` ${text} `)), !0), ramp = (i, text) => paint(RAMP[Math.min(i, RAMP.length - 1)], text), MARK = [
   "   ▗▖  ▗▖   ",
   "   ▐█▖▗█▌   ",
   "    ▜██▛    ",
@@ -2711,11 +2888,11 @@ function motionAllowed(argv = process.argv, env = process.env, isTTY = Boolean(p
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 function logoLines(opts) {
   let right = {
-    3: `${import_picocolors3.default.bold("Lope")}${import_picocolors3.default.dim("Base")}${opts.version ? import_picocolors3.default.dim(`  v${opts.version}`) : ""}`,
+    3: `${import_picocolors3.default.bold("Lope")}${brand("Base")}${opts.version ? import_picocolors3.default.dim(`  v${opts.version}`) : ""}`,
     4: import_picocolors3.default.dim(opts.tagline)
   };
   return MARK.map((row, i) => {
-    let mark = HORIZON.has(i) ? import_picocolors3.default.yellow(import_picocolors3.default.dim(row)) : import_picocolors3.default.yellow(row);
+    let mark = HORIZON.has(i) ? import_picocolors3.default.dim(ramp(i, row)) : ramp(i, row);
     return right[i] ? `${mark}   ${right[i]}` : mark;
   });
 }
@@ -2729,7 +2906,7 @@ ${lines.join(`
 `);
     return;
   }
-  let blank = MARK.map((r) => " ".repeat(r.length)), frame = (shown) => MARK.map((row, i) => shown.has(i) ? HORIZON.has(i) ? import_picocolors3.default.yellow(import_picocolors3.default.dim(row)) : import_picocolors3.default.yellow(row) : blank[i]), up = `\x1B[${MARK.length}A`, onInterrupt = () => {
+  let blank = MARK.map((r) => " ".repeat(r.length)), frame = (shown) => MARK.map((row, i) => shown.has(i) ? HORIZON.has(i) ? import_picocolors3.default.dim(ramp(i, row)) : ramp(i, row) : blank[i]), up = `\x1B[${MARK.length}A`, onInterrupt = () => {
     write(`\x1B[?25h
 `), process.exit(130);
   };
@@ -2805,20 +2982,85 @@ var PLAN = [
   }
 ];
 function planLines() {
-  return PLAN.map((s, i) => `${import_picocolors3.default.yellow(String(i + 1))}  ${import_picocolors3.default.bold(s.title)}
+  return PLAN.map((s, i) => `${brand(String(i + 1))}  ${import_picocolors3.default.bold(s.title)}
    ${import_picocolors3.default.dim(s.detail)}`);
 }
+function stepRail(n, total = PLAN.length) {
+  return Array.from({ length: total }, (_, i) => i < n ? brand("◆") : import_picocolors3.default.dim("◇")).join(import_picocolors3.default.dim(" ── "));
+}
 function stepTitle(n) {
-  return `${import_picocolors3.default.dim(`Step ${n} of ${PLAN.length}`)}  ${import_picocolors3.default.bold(PLAN[n - 1].title)}`;
+  return `${stepRail(n)}   ${import_picocolors3.default.dim(`Step ${n} of ${PLAN.length}`)}  ${import_picocolors3.default.bold(PLAN[n - 1].title)}`;
+}
+async function horizon(opts) {
+  let write = opts.write ?? ((s) => process.stdout.write(s)), width = opts.width ?? 28, line = (n) => Array.from({ length: n }, (_, i) => ramp(Math.floor(i / width * RAMP.length), "━")).join("");
+  if (!opts.motion) {
+    write(`  ${line(width)}
+`);
+    return;
+  }
+  for (let n = 2;n <= width; n += 2)
+    write(`\r  ${line(n)}`), await sleep(10);
+  write(`
+`);
+}
+function watchRows(items) {
+  return items.map((w) => w.how === "address" ? `${brand("◉")} ${import_picocolors3.default.bold(w.label)}  ${import_picocolors3.default.dim("uptime check, every 15 minutes")}` : `${brand("○")} ${import_picocolors3.default.bold(w.label)}  ${import_picocolors3.default.dim("a service in the adapter's health list")}`);
+}
+
+// src/update.ts
+import { readFileSync as readFileSync3 } from "node:fs";
+import path3 from "node:path";
+var readJson2 = (file) => {
+  try {
+    return JSON.parse(readFileSync3(file, "utf8"));
+  } catch {
+    return null;
+  }
+};
+function findAdapterInstalls(root) {
+  let out = [];
+  for (let dir of packageDirs(root)) {
+    let pkg = readJson2(path3.join(dir, "package.json"));
+    if (!pkg)
+      continue;
+    let range = {
+      ...pkg.dependencies,
+      ...pkg.devDependencies
+    }["@lopebase/adapter"];
+    if (!range || range.startsWith("workspace:"))
+      continue;
+    let installed = [dir, root].map((d) => readJson2(path3.join(d, "node_modules/@lopebase/adapter/package.json"))).find((p) => typeof p?.version === "string")?.version;
+    out.push({ dir: path3.relative(root, dir) || ".", range, installed });
+  }
+  return out;
+}
+function runningVersion(i) {
+  return i.installed ?? i.range.replace(/^[^\d]*/, "");
+}
+var isBehind = (running, latest) => compareVersions(running, latest) < 0;
+async function latestOnNpm(name, timeoutMs = 1500, fetchImpl = fetch) {
+  try {
+    let res = await fetchImpl(`https://registry.npmjs.org/${name}/latest`, {
+      signal: AbortSignal.timeout(timeoutMs),
+      headers: { accept: "application/json" }
+    });
+    if (!res.ok)
+      return;
+    let body = await res.json();
+    return typeof body.version === "string" ? body.version : void 0;
+  } catch {
+    return;
+  }
 }
 
 // bin/lopebase.ts
 var [command = "init", ...rest] = process.argv.slice(2), HELP = `
-${import_picocolors4.default.bgYellow(import_picocolors4.default.black(" LopeBase "))}  Set up LopeBase from this project's folder.
+${badge("LopeBase")}  Set up LopeBase from this project's folder.
 
 ${import_picocolors4.default.bold("Usage")}
   npx lopebase                      scan, connect, and hand over to your agent
   npx lopebase login                connect this computer (--paste for a token)
+  npx lopebase update               update this project's LopeBase Adapter to the latest
   npx lopebase scan [--json]        show what the scan found
   npx lopebase prompt               print the setup prompt instead
   npx lopebase mcp                  run the LopeBase tools as a stdio MCP server
@@ -2831,15 +3073,15 @@ ${import_picocolors4.default.bold("Options")}
   --no-motion                       no animation (also LOPEBASE_NO_MOTION=1)
 
 ${import_picocolors4.default.bold("Learn more")}
-  ${import_picocolors4.default.cyan("https://lopebase.com")}
+  ${brand("https://lopebase.com")}
   Help: contact@jackalope.digital
 `, flag = (name) => rest.includes(`--${name}`), option = (name) => {
   let i = rest.indexOf(`--${name}`);
   return i >= 0 ? rest[i + 1] : rest.find((a) => a.startsWith(`--${name}=`))?.split("=")[1];
-}, cwd = process.cwd(), motion = motionAllowed(), TAGLINE = "Every product, one place.";
+}, cwd = process.cwd(), motion = motionAllowed(), TAGLINE = "Every product, one place.", PAGEVIEWS = "LopeBase pageviews";
 function version() {
   try {
-    return JSON.parse(readFileSync3(new URL("../package.json", import.meta.url), "utf8")).version;
+    return JSON.parse(readFileSync4(new URL("../package.json", import.meta.url), "utf8")).version;
   } catch {
     return;
   }
@@ -2898,7 +3140,7 @@ async function login() {
     let device = await startDeviceLogin(url);
     if (device) {
       Me([
-        `Your code: ${import_picocolors4.default.bold(import_picocolors4.default.yellow(device.userCode))}`,
+        `Your code: ${import_picocolors4.default.bold(brand(device.userCode))}`,
         "",
         "We opened LopeBase in your browser. Sign in, or create a free",
         "account if you are new. Then check the code matches and press",
@@ -2959,6 +3201,10 @@ async function printDetection(d, facts) {
   if (possible.length)
     Me(possible.map((s) => `${import_picocolors4.default.yellow("?")} ${import_picocolors4.default.bold(s.label)}  ${import_picocolors4.default.dim(`only ${s.evidence.join(", ")}`)}`).join(`
 `), "Maybe in use, your agent will check"), await pace(motion, 150);
+  let watch = watchList(d, facts);
+  if (watch.length)
+    Me(watchRows(watch).join(`
+`), "Worth watching for uptime"), await pace(motion, 150);
   for (let gap of d.gaps)
     M2.info(import_picocolors4.default.dim(gap));
 }
@@ -2990,7 +3236,7 @@ function registerMcp(agent) {
   return res.status === 0 || /already exists/i.test(`${res.stderr}${res.stdout}`);
 }
 async function init() {
-  if (console.clear(), await showLogo({ tagline: TAGLINE, version: version(), motion }), Ie(`${import_picocolors4.default.bgYellow(import_picocolors4.default.black(" LopeBase "))} set up this project`), Me(planLines().join(`
+  if (console.clear(), await showLogo({ tagline: TAGLINE, version: version(), motion }), await horizon({ motion }), Ie(`${badge("LopeBase")} set up this project`), await noticeNewerCli(), Me(planLines().join(`
 `), "Here is what happens"), !guard(await ye({
     message: `Scan ${import_picocolors4.default.bold(cwd)}?`,
     initialValue: !0
@@ -3015,16 +3261,44 @@ async function init() {
     initialValue: facts.name?.replace(/^@[^/]+\//, "") ?? ""
   })), chosen = guard(await fe({
     message: "What should we connect? (space to toggle, enter to go on)",
-    options: detection.sources.map((src) => ({
-      value: src.label,
-      label: src.status === "found" ? src.label : src.status === "possible" ? `${src.label} ${import_picocolors4.default.dim("(maybe in use, we'll check)")}` : `${src.label} ${import_picocolors4.default.dim("(not set up yet, we'll help)")}`,
-      hint: src.why
-    })),
+    options: [
+      ...detection.sources.map((src) => ({
+        value: src.label,
+        label: src.status === "found" ? src.label : src.status === "possible" ? `${src.label} ${import_picocolors4.default.dim("(maybe in use, we'll check)")}` : `${src.label} ${import_picocolors4.default.dim("(not set up yet, we'll help)")}`,
+        hint: src.why
+      })),
+      ...watchList(detection, facts).some((w) => w.how === "address") ? [
+        {
+          value: PAGEVIEWS,
+          label: `${PAGEVIEWS} ${import_picocolors4.default.dim("(one tag, no cookies)")}`,
+          hint: "LopeBase counts pages, sources, and visits itself."
+        }
+      ] : []
+    ],
     initialValues: detection.sources.filter((src) => src.status === "found" || src.source === "gsc" || src.source === "uptime").map((src) => src.label),
     required: !1
   }));
   M2.step(stepTitle(4));
-  let prompt = onboardingPrompt({ facts, detection, chosen, productName }), agents = installedAgents();
+  let prompt = onboardingPrompt({
+    facts,
+    detection,
+    chosen,
+    productName,
+    watch: watchList(detection, facts),
+    pageviews: chosen.includes(PAGEVIEWS)
+  });
+  await handOff(prompt, (agent) => [
+    `${import_picocolors4.default.bold(agent)} will now:`,
+    `  ${brand("1.")} add ${import_picocolors4.default.bold(productName || "this product")} to your workspace`,
+    `  ${brand("2.")} connect ${chosen.length ? chosen.join(", ") : "what it recommends"}`,
+    `  ${brand("3.")} pick what to watch for uptime: ${watchList(detection, facts).map((w) => w.label).join(", ") || "the site"}`,
+    `  ${brand("4.")} stop and ask you for any sign-in, key, or yes`,
+    "",
+    import_picocolors4.default.dim("You can follow along in your workspace as each one turns green.")
+  ]);
+}
+async function handOff(prompt, plan) {
+  let agents = installedAgents();
   if (!agents.length || flag("print")) {
     if (!agents.length)
       M2.info("No coding agent found on this computer (Claude Code, Codex, and others). Paste the prompt below into the one you use.");
@@ -3049,14 +3323,7 @@ async function init() {
     s.stop(`Added the LopeBase tools to ${agent.label} for this folder.`);
   else
     s.stop(import_picocolors4.default.yellow(`Add an MCP server to ${agent.label} that runs: npx -y lopebase mcp`));
-  Me([
-    `${import_picocolors4.default.bold(agent.label)} will now:`,
-    `  ${import_picocolors4.default.dim("1.")} add ${import_picocolors4.default.bold(productName || "this product")} to your workspace`,
-    `  ${import_picocolors4.default.dim("2.")} connect ${chosen.length ? chosen.join(", ") : "what it recommends"}`,
-    `  ${import_picocolors4.default.dim("3.")} stop and ask you for any sign-in, key, or yes`,
-    "",
-    import_picocolors4.default.dim("You can follow along in your workspace as each one turns green.")
-  ].join(`
+  Me(plan(agent.label).join(`
 `), "Handing over"), Se(`Starting ${agent.label}. Press Ctrl+C any time to stop.`);
   let child = spawnAgent(agent.bin, agent.args(prompt), {
     stdio: "inherit",
@@ -3064,17 +3331,67 @@ async function init() {
   });
   child.on("error", (e) => bail(`Could not start ${agent.label}: ${e.message}`)), child.on("exit", (code) => process.exit(code ?? 0));
 }
+async function noticeNewerCli() {
+  let mine = version(), latest = await latestOnNpm("lopebase");
+  if (mine && latest && isBehind(mine, latest))
+    M2.warn(`lopebase ${latest} is out (this is ${mine}). Run ${brand("npx lopebase@latest")} for the newest setup steps.`);
+}
+async function update() {
+  console.clear(), await showLogo({ tagline: TAGLINE, version: version(), motion }), await horizon({ motion }), Ie(`${badge("LopeBase")} update`), await noticeNewerCli();
+  let s = Y2();
+  s.start("Looking for the LopeBase Adapter in this project");
+  let [installs, npmLatest] = await Promise.all([
+    Promise.resolve(findAdapterInstalls(cwd)),
+    latestOnNpm("@lopebase/adapter")
+  ]);
+  if (await pace(motion, 300), !installs.length)
+    return s.stop("No LopeBase Adapter in this project."), Me([
+      "Connections, uptime checks, and pageviews update on their own in",
+      "the console, so there is nothing to install for them.",
+      "",
+      `To add the adapter (your users, numbers, and service health), run ${brand("npx lopebase")}.`
+    ].join(`
+`), "Nothing to update here"), Se("Done.");
+  let latest = npmLatest && isBehind(ADAPTER_VERSION, npmLatest) ? npmLatest : ADAPTER_VERSION, behind = installs.filter((i) => isBehind(runningVersion(i), latest));
+  if (s.stop(installs.map((i) => `${i.dir === "." ? "This folder" : i.dir} runs ${import_picocolors4.default.bold(runningVersion(i))}`).join(", ")), !behind.length)
+    return Se(`Up to date with ${import_picocolors4.default.bold(latest)}.`);
+  let from = behind.map(runningVersion).sort((a, b) => isBehind(a, b) ? -1 : 1)[0], releases = releasesSince(from);
+  if (Me(releases.flatMap((r) => [
+    `${brand("◆")} ${import_picocolors4.default.bold(r.version)}  ${import_picocolors4.default.dim(r.date)}`,
+    ...r.features.map((f) => `   ${f}`),
+    ...(r.breaking ?? []).map((b) => `   ${import_picocolors4.default.yellow("!")} ${b}`)
+  ]).join(`
+`), `New since ${from}`), npmLatest && isBehind(ADAPTER_VERSION, npmLatest))
+    M2.warn(`npm has ${npmLatest}, newer than these notes. Run ${brand("npx lopebase@latest update")} for its steps.`);
+  if (!guard(await ye({
+    message: "Hand the update to your coding agent? It asks before each change.",
+    initialValue: !0
+  })))
+    return Me(upgradePrompt(from), "Or paste this into your coding agent"), Se("Nothing was changed.");
+  let where = behind.map((i) => i.dir).join(", ");
+  await handOff(`${upgradePrompt(from)}
+
+The adapter is in: ${where}. If you have the lopebase MCP tools, call get_onboarding_status afterwards and do any step it marks next.`, (agent) => [
+    `${import_picocolors4.default.bold(agent)} will now:`,
+    `  ${brand("1.")} update @lopebase/adapter to ${latest} in ${where}`,
+    `  ${brand("2.")} make the changes the new version needs, asking you first`,
+    `  ${brand("3.")} run the adapter check and your tests`
+  ]);
+}
 async function main() {
   switch (command) {
     case "init":
       return init();
+    case "update":
+    case "upgrade":
+      return update();
     case "login":
-      return await showLogo({ tagline: TAGLINE, version: version(), motion }), Ie(`${import_picocolors4.default.bgYellow(import_picocolors4.default.black(" LopeBase "))} sign in`), await login(), Se("Ready. Run lopebase in any project.");
+      return await showLogo({ tagline: TAGLINE, version: version(), motion }), Ie(`${badge("LopeBase")} sign in`), await login(), Se("Ready. Run lopebase in any project.");
     case "scan": {
       let facts = scanProject(cwd), detection = detectStack(facts);
       if (flag("json"))
         return console.log(JSON.stringify({ facts, detection }, null, 2));
-      return Ie(`${import_picocolors4.default.bgYellow(import_picocolors4.default.black(" LopeBase "))} scan`), await printDetection(detection, facts), Se(`Run ${import_picocolors4.default.cyan("npx lopebase")} to connect what it found.`);
+      return Ie(`${badge("LopeBase")} scan`), await printDetection(detection, facts), Se(`Run ${import_picocolors4.default.cyan("npx lopebase")} to connect what it found.`);
     }
     case "prompt": {
       let facts = scanProject(cwd), detection = detectStack(facts);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lopebase",
-  "version": "0.4.3",
+  "version": "0.6.0",
   "description": "Set up LopeBase from your project's folder: scan your stack, connect your workspace, and let your coding agent do the rest.",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "exports": {
     ".": "./src/index.ts",
-    "./detect": "./src/detect.ts"
+    "./detect": "./src/detect.ts",
+    "./releases": "./src/releases.ts"
   },
   "files": [
     "dist",