@reddoorla/maintenance 0.4.0 → 0.6.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((resolve8, reject) => {
+var defaultSpawn = (cmd, args, opts = {}) => new Promise((resolve9, 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((resolve8, reject) => {
   });
   child.on("close", (code) => {
     if (timer) clearTimeout(timer);
-    resolve8({ code: code ?? -1, stdout, stderr });
+    resolve9({ code: code ?? -1, stdout, stderr });
   });
 });
 
@@ -904,6 +904,93 @@ function templatesByName(which) {
   return ALL_TEMPLATES.filter((t) => which.includes(t.config));
 }
 
+// src/recipes/sync-configs/gitignore.ts
+var MANAGED_MARKER = "# canonical entries from @reddoorla/maintenance sync-configs";
+var CANONICAL_GITIGNORE_ENTRIES = [
+  "node_modules/",
+  "build/",
+  "dist/",
+  ".svelte-kit/",
+  "coverage/",
+  ".vitest-cache/",
+  "playwright-report/",
+  "test-results/",
+  ".lighthouseci/",
+  ".tsbuildinfo",
+  ".env",
+  ".env.*",
+  "!.env.example",
+  ".DS_Store",
+  "*.log",
+  ".vercel/",
+  ".netlify/"
+];
+function stripLeadingSlash(s) {
+  return s.startsWith("/") ? s.slice(1) : s;
+}
+function stripTrailingSlash(s) {
+  return s.endsWith("/") ? s.slice(0, -1) : s;
+}
+function normalizePresence(line) {
+  return stripTrailingSlash(stripLeadingSlash(line.trim()));
+}
+function presentSet(existing) {
+  const set = /* @__PURE__ */ new Set();
+  for (const raw of existing.split(/\r?\n/)) {
+    const trimmed = raw.trim();
+    if (!trimmed) continue;
+    if (trimmed.startsWith("#")) continue;
+    set.add(normalizePresence(trimmed));
+  }
+  return set;
+}
+function mergeGitignore(existing, canonical) {
+  if (existing === null) {
+    const body = [MANAGED_MARKER, ...canonical].join("\n") + "\n";
+    return { content: body, added: [...canonical] };
+  }
+  const present = presentSet(existing);
+  const added = [];
+  for (const entry of canonical) {
+    const norm = normalizePresence(entry);
+    if (!present.has(norm)) {
+      added.push(entry);
+      present.add(norm);
+    }
+  }
+  if (added.length === 0) {
+    return { content: existing, added: [] };
+  }
+  let base = existing;
+  if (!base.endsWith("\n")) base += "\n";
+  const block = ["", MANAGED_MARKER, ...added].join("\n") + "\n";
+  return { content: base + block, added };
+}
+function findTrackedArtifacts(tracked, canonical) {
+  const dirEntries = [];
+  for (const raw of canonical) {
+    const t = raw.trim();
+    if (!t) continue;
+    if (t.startsWith("!")) continue;
+    if (/[*?[]/.test(t)) continue;
+    const noLead = stripLeadingSlash(t);
+    if (!noLead.endsWith("/")) continue;
+    const name = stripTrailingSlash(noLead);
+    if (!name) continue;
+    dirEntries.push(name);
+  }
+  const matched = [];
+  for (const path of tracked) {
+    for (const dir of dirEntries) {
+      if (path === dir || path.startsWith(dir + "/")) {
+        matched.push(path);
+        break;
+      }
+    }
+  }
+  return matched;
+}
+
 // src/util/git.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
@@ -926,6 +1013,14 @@ async function createBranch(cwd, name) {
 async function stageAll(cwd) {
   await git(cwd, ["add", "-A"]);
 }
+async function listTrackedFiles(cwd) {
+  const { stdout } = await git(cwd, ["ls-files"]);
+  return stdout.split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
+}
+async function removeFromIndex(cwd, paths) {
+  if (paths.length === 0) return;
+  await git(cwd, ["rm", "-r", "--cached", "--", ...paths]);
+}
 async function commit(cwd, message) {
   await stageAll(cwd);
   const { stdout: status } = await git(cwd, ["status", "--porcelain"]);
@@ -936,6 +1031,7 @@ async function commit(cwd, message) {
 }
 
 // src/recipes/sync-configs.ts
+var GITIGNORE_CONFIG = "gitignore";
 function siteLabel6(site) {
   return site.name ?? site.path;
 }
@@ -946,7 +1042,7 @@ async function readMaybe(path) {
     return null;
   }
 }
-async function planDiffs(cwd, templates) {
+async function planTemplateDiffs(cwd, templates) {
   const diffs = [];
   for (const t of templates) {
     const existing = await readMaybe(join6(cwd, t.path));
@@ -954,11 +1050,29 @@ async function planDiffs(cwd, templates) {
   }
   return diffs;
 }
+async function planGitignore(cwd) {
+  const existing = await readMaybe(join6(cwd, ".gitignore"));
+  const merge = mergeGitignore(existing, CANONICAL_GITIGNORE_ENTRIES);
+  const tracked = await listTrackedFiles(cwd);
+  const toUntrack = findTrackedArtifacts(tracked, CANONICAL_GITIGNORE_ENTRIES);
+  if (merge.added.length === 0 && toUntrack.length === 0) return { kind: "noop" };
+  return { kind: "apply", content: merge.content, toUntrack, added: merge.added };
+}
+async function applyGitignore(cwd, plan) {
+  await writeFile3(join6(cwd, ".gitignore"), plan.content, "utf-8");
+  if (plan.toUntrack.length > 0) {
+    await removeFromIndex(cwd, plan.toUntrack);
+  }
+}
 async function syncConfigs(site, opts = {}) {
   const label = siteLabel6(site);
-  const targets = opts.which ? templatesByName(opts.which) : ALL_TEMPLATES;
-  const diffs = await planDiffs(site.path, targets);
-  if (diffs.length === 0) {
+  const requested = opts.which ?? ALL_TEMPLATES.map((t) => t.config).concat(GITIGNORE_CONFIG);
+  const templateNames = requested.filter((c) => c !== GITIGNORE_CONFIG);
+  const templates = templatesByName(templateNames);
+  const includeGitignore = requested.includes(GITIGNORE_CONFIG);
+  const templateDiffs = await planTemplateDiffs(site.path, templates);
+  const gitignorePlan = includeGitignore ? await planGitignore(site.path) : { kind: "noop" };
+  if (templateDiffs.length === 0 && gitignorePlan.kind === "noop") {
     return {
       recipe: "sync-configs",
       site: label,
@@ -973,7 +1087,7 @@ async function syncConfigs(site, opts = {}) {
   const branch = branchName("sync-configs");
   await createBranch(site.path, branch);
   const shas = [];
-  for (const t of diffs) {
+  for (const t of templateDiffs) {
     await writeFile3(join6(site.path, t.path), t.contents, "utf-8");
     const sha = await commit(
       site.path,
@@ -981,6 +1095,11 @@ async function syncConfigs(site, opts = {}) {
     );
     if (sha) shas.push(sha);
   }
+  if (gitignorePlan.kind === "apply") {
+    await applyGitignore(site.path, gitignorePlan);
+    const sha = await commit(site.path, `chore: sync gitignore from @reddoorla/maintenance`);
+    if (sha) shas.push(sha);
+  }
   return {
     recipe: "sync-configs",
     site: label,
@@ -1389,23 +1508,41 @@ function removeDollarRestProps(source) {
   return next;
 }
 
+// src/recipes/svelte-5/codemods/state-effect-sync.ts
+var PATTERN = /let\s+(\w+)\s*=\s*\$state\(\s*([^)]+?)\s*\)\s*;[ \t\r\n]*\$effect\(\s*\(\s*\)\s*=>\s*\{\s*\w+\s*;\s*\1\s*=\s*([^;}]+?)\s*\}\s*\)\s*;?/g;
+function stateEffectSyncToDerived(source) {
+  return source.replace(PATTERN, (full, name, initExpr, effectExpr) => {
+    if (initExpr.trim() !== effectExpr.trim()) return full;
+    return `let ${name} = $derived(${initExpr.trim()});`;
+  });
+}
+
 // src/recipes/svelte-5/step-gotchas.ts
 var SVELTE_GLOBS = ["src/**/*.svelte"];
 var IGNORE2 = ["node_modules/**", ".svelte-kit/**", "build/**"];
-var CODEMODS = [onEventToHandler, exportLetToProps, removeDollarRestProps];
-async function applyGotchaCodemods(cwd) {
-  let filesChanged = 0;
+var CODEMODS = [
+  onEventToHandler,
+  exportLetToProps,
+  removeDollarRestProps,
+  stateEffectSyncToDerived
+];
+async function planGotchaCodemods(cwd) {
+  const changes = [];
   const relPaths = await glob2(SVELTE_GLOBS, { cwd, ignore: IGNORE2, absolute: false });
   for (const rel of relPaths) {
     const path = join11(cwd, rel);
     const before = await readFile10(path, "utf-8");
     const after = CODEMODS.reduce((s, fn) => fn(s), before);
-    if (after !== before) {
-      await writeFile6(path, after, "utf-8");
-      filesChanged += 1;
-    }
+    if (after !== before) changes.push({ rel, after });
   }
-  return { filesChanged };
+  return changes;
+}
+async function applyGotchaCodemods(cwd) {
+  const changes = await planGotchaCodemods(cwd);
+  for (const c of changes) {
+    await writeFile6(join11(cwd, c.rel), c.after, "utf-8");
+  }
+  return { filesChanged: changes.length };
 }
 
 // src/recipes/svelte-5/step-verify.ts
@@ -1849,12 +1986,79 @@ async function runOnboardCommand(site, opts) {
   return { output, code };
 }
 
+// src/cli/commands/svelte-codemods.ts
+import { resolve as resolve8 } from "path";
+
+// src/recipes/svelte-codemods.ts
+import { writeFile as writeFile8 } from "fs/promises";
+import { join as join16 } from "path";
+function siteLabel11(site) {
+  return site.name ?? site.path;
+}
+async function svelteCodemods(site) {
+  const label = siteLabel11(site);
+  const changes = await planGotchaCodemods(site.path);
+  if (changes.length === 0) {
+    return {
+      recipe: "svelte-codemods",
+      site: label,
+      status: "noop",
+      commits: [],
+      notes: "no codemod targets matched"
+    };
+  }
+  if (!await isWorkingTreeClean(site.path)) {
+    throw new Error(`refusing to run: working tree is not clean at ${site.path}`);
+  }
+  const branch = branchName("svelte-codemods");
+  await createBranch(site.path, branch);
+  for (const c of changes) {
+    await writeFile8(join16(site.path, c.rel), c.after, "utf-8");
+  }
+  const sha = await commit(
+    site.path,
+    `refactor(svelte5): apply codemods (${changes.length} files)`
+  );
+  return {
+    recipe: "svelte-codemods",
+    site: label,
+    status: "applied",
+    commits: sha ? [sha] : [],
+    notes: `branch: ${branch}`
+  };
+}
+
+// src/cli/commands/svelte-codemods.ts
+function formatResult6(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 runSvelteCodemodsCommand(site, opts) {
+  const cwd = opts.cwd ? resolve8(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 svelteCodemods(s));
+  const output = results.map(formatResult6).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 join16 } from "path";
+import { join as join17 } from "path";
 function resolvePackageVersion(fromDir) {
   try {
-    const raw = readFileSync(join16(fromDir, "..", "..", "package.json"), "utf-8");
+    const raw = readFileSync(join17(fromDir, "..", "..", "package.json"), "utf-8");
     const pkg = JSON.parse(raw);
     return pkg.version ?? "unknown";
   } catch {
@@ -1876,6 +2080,7 @@ 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-codemods": "Apply Svelte 5 gotcha codemods to an already-migrated site (state_referenced_locally, etc.).",
   "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)."
 };
@@ -1960,6 +2165,19 @@ cli.command(
     }
   }
 );
+cli.command("svelte-codemods [site]", "Apply Svelte 5 gotcha codemods to an already-migrated site.").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 runSvelteCodemodsCommand(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)."