lopebase 0.5.0 → 0.6.0

package/README.md

@@ -83,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;
@@ -2927,6 +3007,52 @@ 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 = `
 ${badge("LopeBase")}  Set up LopeBase from this project's folder.
@@ -2934,6 +3060,7 @@ ${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
@@ -2954,7 +3081,7 @@ ${import_picocolors4.default.bold("Learn more")}
 }, 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;
   }
@@ -3109,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 }), await horizon({ motion }), Ie(`${badge("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
@@ -3159,7 +3286,19 @@ async function init() {
     productName,
     watch: watchList(detection, facts),
     pageviews: chosen.includes(PAGEVIEWS)
-  }), agents = installedAgents();
+  });
+  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.");
@@ -3184,15 +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:`,
-    `  ${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.")
-  ].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",
@@ -3200,10 +3331,60 @@ 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(`${badge("LopeBase")} sign in`), await login(), Se("Ready. Run lopebase in any project.");
     case "scan": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lopebase",
-  "version": "0.5.0",
+  "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",