@reddoorla/maintenance 0.2.0 → 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((resolve7, 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((resolve7, reject) => {
   });
   child.on("close", (code) => {
     if (timer) clearTimeout(timer);
-    resolve7({ code: code ?? -1, stdout, stderr });
+    resolve8({ code: code ?? -1, stdout, stderr });
   });
 });
 
@@ -1689,12 +1689,154 @@ async function runConvertToPnpmCommand(site, opts) {
   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 join15 } from "path";
+import { join as join16 } from "path";
 function resolvePackageVersion(fromDir) {
   try {
-    const raw = readFileSync(join15(fromDir, "..", "..", "package.json"), "utf-8");
+    const raw = readFileSync(join16(fromDir, "..", "..", "package.json"), "utf-8");
     const pkg = JSON.parse(raw);
     return pkg.version ?? "unknown";
   } catch {
@@ -1716,7 +1858,8 @@ 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.",
-  "convert-to-pnpm": "Convert an npm/yarn site to pnpm (lockfile, packageManager, scripts)."
+  "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())");
@@ -1799,6 +1942,22 @@ cli.command(
     }
   }
 );
+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();