@reddoorla/maintenance 0.1.3 → 0.3.0

package/dist/cli/bin.js

@@ -10,7 +10,7 @@ import { resolve as resolve2 } from "path";
 
 // src/audits/util/spawn.ts
 import { spawn } from "child_process";
-var defaultSpawn = (cmd, args, opts = {}) => new Promise((resolve6, reject) => {
+var defaultSpawn = (cmd, args, opts = {}) => new Promise((resolve8, reject) => {
   const streaming = opts.streaming === true;
   const child = spawn(cmd, [...args], {
     cwd: opts.cwd,
@@ -33,7 +33,7 @@ var defaultSpawn = (cmd, args, opts = {}) => new Promise((resolve6, reject) => {
   });
   child.on("close", (code) => {
     if (timer) clearTimeout(timer);
-    resolve6({ code: code ?? -1, stdout, stderr });
+    resolve8({ code: code ?? -1, stdout, stderr });
   });
 });
 
@@ -357,7 +357,10 @@ var lighthouseConfig = {
   ci: {
     collect: {
       url: ["http://localhost:5173/dev/a11y-fixtures"],
-      startServerCommand: "pnpm vite:dev",
+      // `npm run vite:dev` works on both pnpm and npm sites — pnpm respects
+      // the `run` form too. Keeps this config portable across the fleet
+      // while sites transition to pnpm.
+      startServerCommand: "npm run vite:dev",
       startServerReadyPattern: "ready in",
       startServerReadyTimeout: 12e4,
       numberOfRuns: 1,
@@ -509,7 +512,8 @@ var playwrightA11yConfig = defineConfig({
     }
   ],
   webServer: {
-    command: "pnpm vite:dev",
+    // Portable across pnpm and npm sites — pnpm respects `npm run` too.
+    command: "npm run vite:dev",
     url: "http://localhost:5173/dev/a11y-fixtures",
     reuseExistingServer: !process.env.CI,
     timeout: 12e4
@@ -1546,12 +1550,293 @@ async function runUpgradeCommand(upgradeName, site, opts = {}) {
   return { output, code };
 }
 
+// src/cli/commands/convert-to-pnpm.ts
+import { resolve as resolve6 } from "path";
+
+// src/recipes/convert-to-pnpm.ts
+import { rm as rm3, stat as stat2 } from "fs/promises";
+import { join as join14 } from "path";
+
+// src/recipes/convert-to-pnpm/script-rewrites.ts
+function rewriteScriptForPnpm(script) {
+  let out = script;
+  out = out.replace(/\bnpm run(?=\s)/g, "pnpm run");
+  out = out.replace(/\bnpx(?=\s)/g, "pnpm dlx");
+  return out;
+}
+function rewriteScriptsForPnpm(scripts) {
+  const next = {};
+  let changedCount = 0;
+  for (const [name, value] of Object.entries(scripts)) {
+    const rewritten = rewriteScriptForPnpm(value);
+    next[name] = rewritten;
+    if (rewritten !== value) changedCount++;
+  }
+  return { scripts: next, changedCount };
+}
+
+// src/recipes/convert-to-pnpm.ts
+var DEFAULT_PNPM_VERSION = "10.33.1";
+async function exists(path) {
+  try {
+    await stat2(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function siteLabel9(site) {
+  return site.name ?? site.path;
+}
+async function convertToPnpm(site, opts = {}) {
+  const label = siteLabel9(site);
+  const spawn2 = opts.spawn ?? defaultSpawn;
+  const pnpmVersion = opts.pnpmVersion ?? DEFAULT_PNPM_VERSION;
+  const pnpmLockPath = join14(site.path, "pnpm-lock.yaml");
+  const npmLockPath = join14(site.path, "package-lock.json");
+  const yarnLockPath = join14(site.path, "yarn.lock");
+  if (await exists(pnpmLockPath)) {
+    return {
+      recipe: "convert-to-pnpm",
+      site: label,
+      status: "noop",
+      commits: [],
+      notes: "site already has pnpm-lock.yaml"
+    };
+  }
+  const hasNpmLock = await exists(npmLockPath);
+  const hasYarnLock = await exists(yarnLockPath);
+  if (!hasNpmLock && !hasYarnLock) {
+    return {
+      recipe: "convert-to-pnpm",
+      site: label,
+      status: "noop",
+      commits: [],
+      notes: "no convertible lockfile (package-lock.json or yarn.lock) at site root"
+    };
+  }
+  if (!await isWorkingTreeClean(site.path)) {
+    throw new Error(`refusing to run: working tree is not clean at ${site.path}`);
+  }
+  const branch = branchName("convert-to-pnpm");
+  await createBranch(site.path, branch);
+  const shas = [];
+  if (hasNpmLock) await rm3(npmLockPath, { force: true });
+  if (hasYarnLock) await rm3(yarnLockPath, { force: true });
+  const sourceLock = hasNpmLock ? "package-lock.json" : "yarn.lock";
+  const lockSha = await commit(site.path, `chore(pnpm): remove ${sourceLock}`);
+  if (lockSha) shas.push(lockSha);
+  const pkgPath = join14(site.path, "package.json");
+  const pkg = await readPackageJson(pkgPath);
+  const next = { ...pkg, packageManager: `pnpm@${pnpmVersion}` };
+  if (pkg.scripts && typeof pkg.scripts === "object") {
+    const { scripts: rewritten, changedCount } = rewriteScriptsForPnpm(
+      pkg.scripts
+    );
+    if (changedCount > 0) {
+      next.scripts = rewritten;
+    }
+  }
+  await writePackageJson(pkgPath, next);
+  const pkgSha = await commit(site.path, "chore(pnpm): pin packageManager + rewrite npm scripts");
+  if (pkgSha) shas.push(pkgSha);
+  const installResult = await spawn2("pnpm", ["install"], {
+    cwd: site.path,
+    streaming: true
+  });
+  if (installResult.code !== 0) {
+    return {
+      recipe: "convert-to-pnpm",
+      site: label,
+      status: "failed",
+      commits: shas,
+      notes: `pnpm install failed (exit ${installResult.code}). branch ${branch} left for inspection.`
+    };
+  }
+  const installSha = await commit(site.path, "chore(pnpm): add pnpm-lock.yaml");
+  if (installSha) shas.push(installSha);
+  return {
+    recipe: "convert-to-pnpm",
+    site: label,
+    status: "applied",
+    commits: shas,
+    notes: `branch: ${branch}`
+  };
+}
+
+// src/cli/commands/convert-to-pnpm.ts
+function formatResult4(r) {
+  if (r.status === "noop") return `[${r.site}] noop: ${r.notes ?? ""}`;
+  if (r.status === "failed") return `[${r.site}] failed: ${r.notes ?? ""}`;
+  return `[${r.site}] applied: ${r.commits.length} commit(s)
+${r.notes ?? ""}`;
+}
+async function runConvertToPnpmCommand(site, opts) {
+  const cwd = opts.cwd ? resolve6(opts.cwd) : process.cwd();
+  let sites = await resolveSites({
+    ...site !== void 0 ? { site } : {},
+    ...opts.fleet !== void 0 ? { fleet: opts.fleet } : {},
+    cwd
+  });
+  if (opts.fleet) {
+    const workdir = opts.workdir ?? `${process.env.HOME ?? ""}/.reddoor-maint/sites`;
+    sites = await Promise.all(sites.map((s) => cloneIfNeeded(s, { workdir })));
+  }
+  const results = [];
+  for (const s of sites) results.push(await convertToPnpm(s));
+  const output = results.map(formatResult4).join("\n");
+  const code = results.some((r) => r.status === "failed") ? 1 : 0;
+  return { output, code };
+}
+
+// src/cli/commands/onboard.ts
+import { resolve as resolve7 } from "path";
+
+// src/recipes/onboard.ts
+import { stat as stat3 } from "fs/promises";
+import { join as join15 } from "path";
+var PACKAGE_NAME = "@reddoorla/maintenance";
+var DEFAULT_PACKAGE_VERSION = "^0.2.0";
+var AUDIT_DEPS = {
+  lighthouse: [{ name: "@lhci/cli", version: "^0.15.1" }],
+  a11y: [
+    { name: "@playwright/test", version: "^1.59.1" },
+    { name: "@axe-core/playwright", version: "^4.11.3" }
+  ]
+};
+async function exists2(path) {
+  try {
+    await stat3(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function siteLabel10(site) {
+  return site.name ?? site.path;
+}
+function isDeclared(pkg, name) {
+  return Boolean(pkg.dependencies?.[name] ?? pkg.devDependencies?.[name]);
+}
+async function onboard(site, opts = {}) {
+  const label = siteLabel10(site);
+  const spawn2 = opts.spawn ?? defaultSpawn;
+  const audits = opts.audits ?? ["lighthouse", "a11y"];
+  const packageVersion = opts.packageVersion ?? DEFAULT_PACKAGE_VERSION;
+  if (!await exists2(join15(site.path, "pnpm-lock.yaml"))) {
+    return {
+      recipe: "onboard",
+      site: label,
+      status: "failed",
+      commits: [],
+      notes: "no pnpm-lock.yaml at site root \u2014 run convert-to-pnpm first"
+    };
+  }
+  const pkgPath = join15(site.path, "package.json");
+  const pkg = await readPackageJson(pkgPath);
+  const toAdd = [];
+  if (!isDeclared(pkg, PACKAGE_NAME)) {
+    toAdd.push({ name: PACKAGE_NAME, version: packageVersion });
+  }
+  for (const audit of audits) {
+    for (const dep of AUDIT_DEPS[audit]) {
+      if (!isDeclared(pkg, dep.name)) toAdd.push(dep);
+    }
+  }
+  if (toAdd.length === 0) {
+    return {
+      recipe: "onboard",
+      site: label,
+      status: "noop",
+      commits: [],
+      notes: `site already has ${PACKAGE_NAME} and audit deps (${audits.join("+")})`
+    };
+  }
+  if (!await isWorkingTreeClean(site.path)) {
+    throw new Error(`refusing to run: working tree is not clean at ${site.path}`);
+  }
+  const branch = branchName("onboard");
+  await createBranch(site.path, branch);
+  let next = pkg;
+  for (const dep of toAdd) {
+    next = bumpDep(next, dep.name, dep.version);
+  }
+  await writePackageJson(pkgPath, next);
+  const installResult = await spawn2("pnpm", ["install"], {
+    cwd: site.path,
+    streaming: true
+  });
+  if (installResult.code !== 0) {
+    return {
+      recipe: "onboard",
+      site: label,
+      status: "failed",
+      commits: [],
+      notes: `pnpm install failed (exit ${installResult.code}). branch ${branch} left for inspection.`
+    };
+  }
+  const sha = await commit(
+    site.path,
+    `chore(reddoor): onboard with ${PACKAGE_NAME} ${packageVersion}`
+  );
+  const shas = sha ? [sha] : [];
+  return {
+    recipe: "onboard",
+    site: label,
+    status: "applied",
+    commits: shas,
+    notes: `branch: ${branch}. Added ${toAdd.length} dep(s): ${toAdd.map((d) => d.name).join(", ")}`
+  };
+}
+
+// src/cli/commands/onboard.ts
+var ALL_AUDITS = ["lighthouse", "a11y"];
+function parseAudits(value) {
+  if (!value) return void 0;
+  const parsed = value.split(",").map((s) => s.trim());
+  for (const a of parsed) {
+    if (!ALL_AUDITS.includes(a)) {
+      throw Object.assign(
+        new Error(`unknown audit in --audits: ${a}. expected ${ALL_AUDITS.join(", ")}`),
+        { exitCode: 2 }
+      );
+    }
+  }
+  return parsed;
+}
+function formatResult5(r) {
+  if (r.status === "noop") return `[${r.site}] noop: ${r.notes ?? ""}`;
+  if (r.status === "failed") return `[${r.site}] failed: ${r.notes ?? ""}`;
+  return `[${r.site}] applied: ${r.commits.length} commit(s)
+${r.notes ?? ""}`;
+}
+async function runOnboardCommand(site, opts) {
+  const audits = parseAudits(opts.audits);
+  const cwd = opts.cwd ? resolve7(opts.cwd) : process.cwd();
+  let sites = await resolveSites({
+    ...site !== void 0 ? { site } : {},
+    ...opts.fleet !== void 0 ? { fleet: opts.fleet } : {},
+    cwd
+  });
+  if (opts.fleet) {
+    const workdir = opts.workdir ?? `${process.env.HOME ?? ""}/.reddoor-maint/sites`;
+    sites = await Promise.all(sites.map((s) => cloneIfNeeded(s, { workdir })));
+  }
+  const results = [];
+  for (const s of sites) {
+    results.push(await onboard(s, audits ? { audits } : {}));
+  }
+  const output = results.map(formatResult5).join("\n");
+  const code = results.some((r) => r.status === "failed") ? 1 : 0;
+  return { output, code };
+}
+
 // src/cli/version.ts
 import { readFileSync } from "fs";
-import { join as join14 } from "path";
+import { join as join16 } from "path";
 function resolvePackageVersion(fromDir) {
   try {
-    const raw = readFileSync(join14(fromDir, "..", "..", "package.json"), "utf-8");
+    const raw = readFileSync(join16(fromDir, "..", "..", "package.json"), "utf-8");
     const pkg = JSON.parse(raw);
     return pkg.version ?? "unknown";
   } catch {
@@ -1572,7 +1857,9 @@ var AUDIT_DESCRIPTIONS = {
 var RECIPE_DESCRIPTIONS = {
   "sync-configs": "Overwrite a site's canonical configs to match @reddoorla/maintenance.",
   "bump-deps": "Bump dependencies and commit the lockfile change.",
-  "svelte-4-to-5": "Run the 7-commit Svelte 4 \u2192 5 upgrade recipe."
+  "svelte-4-to-5": "Run the 7-commit Svelte 4 \u2192 5 upgrade recipe.",
+  "convert-to-pnpm": "Convert an npm/yarn site to pnpm (lockfile, packageManager, scripts).",
+  onboard: "Install @reddoorla/maintenance + audit deps on a site (preferred first step)."
 };
 var cli = cac("reddoor-maint");
 cli.option("--cwd <path>", "Override working directory (default: process.cwd())");
@@ -1639,6 +1926,38 @@ cli.command("upgrade <upgrade> [site]", "Run a named upgrade recipe (svelte-4-to
     }
   }
 );
+cli.command(
+  "convert-to-pnpm [site]",
+  "Convert an npm/yarn site to pnpm (lockfile, packageManager, scripts)."
+).option("--fleet <inventory>", "Inventory file (.json or .mjs/.js)").option("--workdir <path>", "Clone target for fleet mode (default ~/.reddoor-maint/sites)").action(
+  async (site, opts) => {
+    try {
+      const { output, code } = await runConvertToPnpmCommand(site, opts);
+      console.log(output);
+      process.exit(code);
+    } catch (err) {
+      const e = err;
+      console.error(opts.verbose ? e.stack ?? e.message : e.message ?? String(err));
+      process.exit(e.exitCode ?? 1);
+    }
+  }
+);
+cli.command(
+  "onboard [site]",
+  "Install @reddoorla/maintenance + audit deps on a site (run after convert-to-pnpm)."
+).option("--audits <names>", "Comma-separated audit subset: lighthouse,a11y (default: both)").option("--fleet <inventory>", "Inventory file (.json or .mjs/.js)").option("--workdir <path>", "Clone target for fleet mode (default ~/.reddoor-maint/sites)").action(
+  async (site, opts) => {
+    try {
+      const { output, code } = await runOnboardCommand(site, opts);
+      console.log(output);
+      process.exit(code);
+    } catch (err) {
+      const e = err;
+      console.error(opts.verbose ? e.stack ?? e.message : e.message ?? String(err));
+      process.exit(e.exitCode ?? 1);
+    }
+  }
+);
 cli.help();
 cli.version(version);
 cli.parse();