svelte-vitals 0.43.0 → 0.44.1

package/dist/bin.js

@@ -3,19 +3,19 @@ import {
   CONFIG_FILENAMES,
   discoverApps,
   findUnknownRuleIds,
+  hasDep,
   isReporterName,
   knownRuleIds,
   readCoreVersion,
   readPackageVersion,
+  readPkg,
   run
-} from "./chunk-6Y2E7QCQ.js";
+} from "./chunk-4MC7STFI.js";
 import {
-  consoleIO
-} from "./chunk-SLUMRYUD.js";
-
-// src/bin.ts
-import mri4 from "mri";
-import * as p2 from "@clack/prompts";
+  consoleIO,
+  parseCliArgs,
+  toList
+} from "./chunk-5Q2PT47V.js";
 
 // src/resolve-args.ts
 var CATEGORIES = ["seo", "performance", "correctness", "security", "architecture"];
@@ -24,7 +24,7 @@ function parseWeights(raw, errors) {
   const weights = {};
   const unknownCategories = [];
   const invalidValues = [];
-  for (const pair of raw.split(",").map((s) => s.trim()).filter(Boolean)) {
+  for (const pair of toList(raw)) {
     const eq = pair.indexOf("=");
     if (eq === -1) {
       invalidValues.push(pair);
@@ -65,7 +65,7 @@ function parseCategories(raw, errors) {
   if (typeof raw !== "string" || raw.trim() === "") return void 0;
   const categories = [];
   const unknownCategories = [];
-  for (const entry of raw.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean)) {
+  for (const entry of toList(raw).map((s) => s.toLowerCase())) {
     if (!CATEGORIES.includes(entry)) {
       unknownCategories.push(entry);
       continue;
@@ -81,12 +81,74 @@ function parseCategories(raw, errors) {
   }
   return categories;
 }
-var toList = (v) => typeof v === "string" ? v.split(",").map((s) => s.trim()).filter(Boolean) : [];
+var VALUE_FLAGS = [
+  "meta-components",
+  "treat-dynamic-as",
+  "route",
+  "fail-on",
+  "reporter",
+  "rules",
+  "ignore",
+  "min-health",
+  "out-file",
+  "weights",
+  "category"
+];
+function parseRunArgs(args) {
+  const patched = args.map((a, i) => a === "--diff" && (args[i + 1] ?? "--").startsWith("-") ? "--diff=HEAD" : a);
+  return parseCliArgs(patched, {
+    boolean: [
+      "by-route",
+      "staged",
+      "score",
+      "verbose",
+      "update-suppressions",
+      "no-suppressions",
+      "no-color",
+      "no-animation",
+      "help",
+      "version"
+    ],
+    string: [
+      "meta-components",
+      "treat-dynamic-as",
+      "route",
+      "fail-on",
+      "reporter",
+      "rules",
+      "ignore",
+      "min-health",
+      "out-file",
+      "diff",
+      "baseline",
+      "weights",
+      "category"
+    ],
+    short: { h: "help", v: "version" }
+  });
+}
 function resolveArgs(argv) {
   const warnings = [];
   const errors = [];
+  for (const flag of VALUE_FLAGS) {
+    const v = argv[flag];
+    if (flag === "out-file" && v === "-") continue;
+    if (v !== void 0 && (typeof v !== "string" || v.trim() === "" || v.startsWith("-"))) {
+      errors.push(`svelte-vitals: --${flag} requires a value.`);
+    }
+  }
+  let minHealth;
+  const minHealthRaw = argv["min-health"];
+  if (minHealthRaw !== void 0) {
+    const n = Number(minHealthRaw);
+    if (!Number.isFinite(n) || n < 0 || n > 100) {
+      errors.push(`svelte-vitals: invalid --min-health '${minHealthRaw}'; expected a number 0-100.`);
+    } else {
+      minHealth = n;
+    }
+  }
   const positional = argv._[0];
-  const metaComponents = typeof argv["meta-components"] === "string" ? argv["meta-components"].split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+  const metaComponents = typeof argv["meta-components"] === "string" ? toList(argv["meta-components"]) : void 0;
   const treatRaw = argv["treat-dynamic-as"];
   const treatDynamicAs = treatRaw === "warn" || treatRaw === "fail" || treatRaw === "pass" ? treatRaw : void 0;
   if (typeof treatRaw === "string" && treatDynamicAs === void 0) {
@@ -98,8 +160,8 @@ function resolveArgs(argv) {
   const diffBase = typeof argv.diff === "string" ? argv.diff || "HEAD" : void 0;
   const staged = Boolean(argv.staged);
   let baselineRef;
-  if (typeof argv.baseline === "string") {
-    if (argv.baseline.trim() === "") {
+  if (argv.baseline !== void 0) {
+    if (typeof argv.baseline !== "string" || argv.baseline.trim() === "" || argv.baseline.startsWith("-")) {
       errors.push("svelte-vitals: --baseline requires a git ref (e.g. --baseline origin/main).");
     } else {
       baselineRef = argv.baseline;
@@ -132,14 +194,23 @@ function resolveArgs(argv) {
   const failOn = failOnValid ? failOnRaw : void 0;
   const weights = parseWeights(argv.weights, errors);
   const categories = parseCategories(argv.category, errors);
+  if (categories !== void 0 && categories.length > 0 && allow.length > 0) {
+    const excluded = allow.filter((id) => !unknown.includes(id)).filter((id) => !categories.includes(id.split("/")[0]));
+    if (excluded.length > 0) {
+      errors.push(
+        `svelte-vitals: --rules id(s) excluded by --category ${categories.join(", ")}: ${excluded.join(", ")}`
+      );
+      errors.push("Add the rule's category to --category, or drop the rule from --rules.");
+    }
+  }
   const score = Boolean(argv.score);
   if (score && typeof argv.reporter === "string") {
     warnings.push("svelte-vitals: --score overrides --reporter; reporter output suppressed.");
   }
   const verbose = Boolean(argv["verbose"]);
-  const noColor = argv.color === false;
-  const noAnimation = argv.animation === false;
-  const noSuppressions = argv.suppressions === false;
+  const noColor = Boolean(argv["no-color"]);
+  const noAnimation = Boolean(argv["no-animation"]);
+  const noSuppressions = Boolean(argv["no-suppressions"]);
   const updateSuppressions = Boolean(argv["update-suppressions"]);
   if (updateSuppressions && noSuppressions) {
     errors.push("svelte-vitals: --update-suppressions and --no-suppressions cannot be used together.");
@@ -175,7 +246,8 @@ function resolveArgs(argv) {
       ...updateSuppressions ? { updateSuppressions } : {}
     },
     warnings,
-    errors
+    errors,
+    minHealth
   };
 }
 
@@ -183,83 +255,11 @@ function resolveArgs(argv) {
 import { mkdirSync, readFileSync, writeFileSync } from "fs";
 import { dirname } from "path";
 import { spawnSync } from "child_process";
-import mri from "mri";
 import * as p from "@clack/prompts";
 
 // src/install/index.ts
 import { join as join3 } from "path";
 
-// src/install/vite-targets.ts
-var VITE_TARGETS = [
-  {
-    id: "vite-plugin",
-    label: "Vite plugin (build gate)",
-    hint: "Fails `vite build` when prerendered pages cross the SEO/Performance threshold"
-  },
-  {
-    id: "vite-hooks",
-    label: "Live dashboard accuracy",
-    hint: "Feeds real rendered results into the live dashboard as you browse \u2014 improves per-route accuracy, never fails a build"
-  }
-];
-function viteTargetById(id) {
-  return VITE_TARGETS.find((t) => t.id === id);
-}
-function isViteTargetId(id) {
-  return VITE_TARGETS.some((t) => t.id === id);
-}
-
-// src/install/agent-targets.ts
-var AGENT_TARGETS = [
-  {
-    id: "claude-skill",
-    label: "Agent skill: svelte-vitals",
-    hint: "Teaches the agent svelte-vitals rules + when to run the scanner (Claude Code, Codex, Cursor)",
-    relPaths: [
-      ".claude/skills/svelte-vitals/SKILL.md",
-      ".agents/skills/svelte-vitals/SKILL.md",
-      ".cursor/skills/svelte-vitals/SKILL.md"
-    ]
-  },
-  {
-    id: "cursor-rules",
-    label: "Cursor rules",
-    hint: "Project rules file so Cursor avoids flagged patterns up front",
-    relPaths: [".cursor/rules/svelte-vitals.mdc"]
-  },
-  {
-    id: "claude-skill-improve",
-    label: "Agent skill: improve-svelte",
-    hint: "Senior-advisor audit \u2192 implementation plans (read-only), for a project-wide improvement roadmap (Claude Code, Codex, Cursor)",
-    relPaths: [
-      ".claude/skills/improve-svelte/SKILL.md",
-      ".agents/skills/improve-svelte/SKILL.md",
-      ".cursor/skills/improve-svelte/SKILL.md"
-    ]
-  }
-];
-function agentTargetById(id) {
-  return AGENT_TARGETS.find((t) => t.id === id);
-}
-function isAgentTargetId(id) {
-  return AGENT_TARGETS.some((t) => t.id === id);
-}
-
-// src/install/config-targets.ts
-var CONFIG_TARGETS = [
-  {
-    id: "config-file",
-    label: "Config file",
-    hint: "Scaffolds svelte-vitals.config.{mjs,ts} (auto-picks the best one) with every option commented out"
-  }
-];
-function configTargetById(id) {
-  return CONFIG_TARGETS.find((t) => t.id === id);
-}
-function isConfigTargetId(id) {
-  return CONFIG_TARGETS.some((t) => t.id === id);
-}
-
 // src/ci/workflow.ts
 var WORKFLOW_PATH = ".github/workflows/svelte-vitals.yml";
 var CHECKOUT_SHA = "9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0";
@@ -298,20 +298,74 @@ function buildWorkflowYaml(opts) {
   ].join("\n");
 }
 
-// src/install/ci-targets.ts
-var CI_TARGETS = [
+// src/install/targets.ts
+var INSTALL_TARGETS = [
+  {
+    id: "vite-plugin",
+    kind: "vite",
+    label: "Vite plugin (build gate)",
+    hint: "Fails `vite build` when prerendered pages cross the SEO/Performance threshold",
+    relPaths: []
+  },
+  {
+    id: "vite-hooks",
+    kind: "vite",
+    label: "Live dashboard accuracy",
+    hint: "Feeds real rendered results into the live dashboard as you browse \u2014 improves per-route accuracy, never fails a build",
+    relPaths: []
+  },
+  {
+    id: "claude-skill",
+    kind: "agent",
+    label: "Agent skill: svelte-vitals",
+    hint: "Teaches the agent svelte-vitals rules + when to run the scanner (Claude Code, Codex, Cursor)",
+    relPaths: [
+      ".claude/skills/svelte-vitals/SKILL.md",
+      ".agents/skills/svelte-vitals/SKILL.md",
+      ".cursor/skills/svelte-vitals/SKILL.md"
+    ]
+  },
+  {
+    id: "cursor-rules",
+    kind: "agent",
+    label: "Cursor rules",
+    hint: "Project rules file so Cursor avoids flagged patterns up front",
+    relPaths: [".cursor/rules/svelte-vitals.mdc"]
+  },
+  {
+    id: "claude-skill-improve",
+    kind: "agent",
+    label: "Agent skill: improve-svelte",
+    hint: "Senior-advisor audit \u2192 implementation plans (read-only), for a project-wide improvement roadmap (Claude Code, Codex, Cursor)",
+    relPaths: [
+      ".claude/skills/improve-svelte/SKILL.md",
+      ".agents/skills/improve-svelte/SKILL.md",
+      ".cursor/skills/improve-svelte/SKILL.md"
+    ]
+  },
+  {
+    id: "config-file",
+    kind: "config",
+    label: "Config file",
+    hint: "Scaffolds svelte-vitals.config.{mjs,ts} (auto-picks the best one) with every option commented out",
+    relPaths: []
+  },
   {
     id: "ci-workflow",
+    kind: "ci",
     label: "GitHub Actions CI",
     hint: "Scaffolds a workflow that runs @svelte-vitals/action on pull requests \u2014 inline annotations, job summary, sticky PR comment",
-    relPath: WORKFLOW_PATH
+    relPaths: [WORKFLOW_PATH]
   }
 ];
-function ciTargetById(id) {
-  return CI_TARGETS.find((t) => t.id === id);
+function targetById(id) {
+  return INSTALL_TARGETS.find((t) => t.id === id);
 }
-function isCiTargetId(id) {
-  return CI_TARGETS.some((t) => t.id === id);
+function targetsOfKind(kind) {
+  return INSTALL_TARGETS.filter((t) => t.kind === kind);
+}
+function isKind(id, kind) {
+  return targetById(id)?.kind === kind;
 }
 
 // src/install/skill-content.ts
@@ -351,7 +405,7 @@ ${lines}`;
   }).join("\n\n");
 }
 function sharedBody(version) {
-  return `<!-- Generated by \`svelte-vitals install\` (svelte-vitals ${version}). Re-run with --force to refresh. -->
+  return `<!-- Generated by \`svelte-vitals install\` (svelte-vitals ${version}). Re-run \`svelte-vitals install --refresh\` to regenerate. -->
 
 # svelte-vitals
 
@@ -398,7 +452,7 @@ name: improve-svelte
 description: Survey a whole SvelteKit codebase as a senior Svelte/SvelteKit engineer, using svelte-vitals' scan as evidence, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code \u2014 it plans improvements, it does not apply them. Use when the user asks to "improve this SvelteKit app", "audit this codebase", "make this app more SEO/performance/security solid", or wants a roadmap of fixes rather than a review of a single diff. For routine regression checks while writing code, use the \`svelte-vitals\` skill instead.
 ---
 
-<!-- Generated by \`svelte-vitals install\` (svelte-vitals ${version}). Re-run with --force to refresh. -->
+<!-- Generated by \`svelte-vitals install\` (svelte-vitals ${version}). Re-run \`svelte-vitals install --refresh\` to regenerate. -->
 
 # improve-svelte
 
@@ -755,23 +809,10 @@ function findExistingConfigFile(readFile, cwd) {
   return CONFIG_FILENAMES.find((rel) => readFile(join(cwd, rel)) !== void 0);
 }
 function hasSvelteVitalsDependency(readFile, cwd) {
-  const raw = readFile(join(cwd, "package.json"));
-  if (raw === void 0) return false;
-  try {
-    const pkg = JSON.parse(raw);
-    return Boolean(pkg.dependencies?.["svelte-vitals"] ?? pkg.devDependencies?.["svelte-vitals"]);
-  } catch {
-    return false;
-  }
+  return hasDep(readPkg(readFile, cwd), "svelte-vitals");
 }
 function isEsmProject(readFile, cwd) {
-  const raw = readFile(join(cwd, "package.json"));
-  if (raw === void 0) return false;
-  try {
-    return JSON.parse(raw).type === "module";
-  } catch {
-    return false;
-  }
+  return readPkg(readFile, cwd)?.type === "module";
 }
 function detectBestConfigExtension(opts) {
   if (!nodeSupportsNativeTypeScript(opts.nodeVersion)) return "mjs";
@@ -796,7 +837,7 @@ function codemodViteConfig(existing) {
       return { status: "manual", snippet: MANUAL_SNIPPET };
     }
     const already = configObj.plugins.find(
-      (p3) => p3?.$type === "function-call" && p3?.$callee === "svelteVitals"
+      (p2) => p2?.$type === "function-call" && p2?.$callee === "svelteVitals"
     );
     if (already !== void 0) {
       return { status: "exists" };
@@ -904,14 +945,10 @@ function detectPackageManager(io) {
   return detectPackageManagerFromLockfile(io) ?? "npm";
 }
 function hasVitePackage(io) {
-  const raw = io.readFile(join2(io.cwd, "package.json"));
-  if (raw === void 0) return false;
-  try {
-    const pkg = JSON.parse(raw);
-    return Boolean(pkg.dependencies?.["@svelte-vitals/vite"] || pkg.devDependencies?.["@svelte-vitals/vite"]);
-  } catch {
-    return false;
-  }
+  return hasDep(
+    readPkg((p2) => io.readFile(p2), io.cwd),
+    "@svelte-vitals/vite"
+  );
 }
 function installCommand(pm) {
   const action = pm === "npm" ? "install" : "add";
@@ -946,12 +983,12 @@ function resolveCandidate(io, baseDir, candidates) {
 function planForVitePlugin(io, appDir) {
   const { path, content } = resolveCandidate(io, appDir, ["vite.config.ts", "vite.config.js", "vite.config.mjs"]);
   const result = codemodViteConfig(content);
-  return { id: "vite-plugin", label: viteTargetById("vite-plugin").label, path, ...result };
+  return { id: "vite-plugin", label: targetById("vite-plugin").label, path, ...result };
 }
 function planForViteHooks(io, appDir) {
   const { path, content } = resolveCandidate(io, appDir, ["src/hooks.server.ts", "src/hooks.server.js"]);
   const result = codemodHooksServer(content);
-  return { id: "vite-hooks", label: viteTargetById("vite-hooks").label, path, ...result };
+  return { id: "vite-hooks", label: targetById("vite-hooks").label, path, ...result };
 }
 function agentTargetContent(id, version) {
   switch (id) {
@@ -967,8 +1004,9 @@ function agentTargetContent(id, version) {
     }
   }
 }
-function planForAgentTarget(target, io, force, version) {
-  const content = agentTargetContent(target.id, version);
+function planForAgentTarget(id, io, force, version) {
+  const target = targetById(id);
+  const content = agentTargetContent(id, version);
   return target.relPaths.map((relPath) => {
     const path = join3(io.cwd, relPath);
     const existing = io.readFile(path);
@@ -976,7 +1014,8 @@ function planForAgentTarget(target, io, force, version) {
     return { id: target.id, label: target.label, path, status, content };
   });
 }
-function planForConfigTarget(target, io, force, appDir) {
+function planForConfigTarget(io, force, appDir) {
+  const target = targetById("config-file");
   const existingRel = findExistingConfigFile(io.readFile, appDir);
   if (existingRel !== void 0) {
     const path2 = join3(appDir, existingRel);
@@ -996,8 +1035,9 @@ function planForConfigTarget(target, io, force, appDir) {
   const content = buildConfigFileTemplate({ useDefineConfig: ext === "ts" });
   return { id: target.id, label: target.label, path, status: "created", content };
 }
-function planForCiTarget(target, io, force) {
-  const path = join3(io.cwd, target.relPath);
+function planForCiTarget(io, force) {
+  const target = targetById("ci-workflow");
+  const path = join3(io.cwd, target.relPaths[0]);
   const existing = io.readFile(path);
   const plan = planWorkflowWrite(existing, force);
   const content = plan.status === "exists" ? void 0 : buildWorkflowYaml({ actionSha: ACTION_SHA, actionVersion: ACTION_VERSION });
@@ -1014,7 +1054,7 @@ ${indent(r.snippet)}` : head;
 async function runRefresh(io, flags, version) {
   let hadFailure = false;
   const rows = [];
-  for (const target of AGENT_TARGETS) {
+  for (const target of targetsOfKind("agent")) {
     const content = agentTargetContent(target.id, version);
     for (const relPath of target.relPaths) {
       const path = join3(io.cwd, relPath);
@@ -1079,25 +1119,26 @@ async function runInstall(flags, io, prompts, version = "0.0.0") {
       ".cursor/environment.json",
       ".cursorrules",
       ".cursorignore",
-      agentTargetById("cursor-rules").relPaths[0]
+      targetById("cursor-rules").relPaths[0]
     ].some((rel) => configExists(join3(io.cwd, rel)));
     const detectedAgents = [
       ...claudeSkillDetected ? ["claude-skill"] : [],
       ...cursorRulesDetected ? ["cursor-rules"] : []
     ];
-    const ciWorkflowDetected = configExists(join3(io.cwd, CI_TARGETS[0].relPath));
-    const configFileDetected = findExistingConfigFile((p3) => configExists(p3) ? "" : void 0, io.cwd) !== void 0;
+    const ciWorkflowDetected = configExists(join3(io.cwd, targetById("ci-workflow").relPaths[0]));
+    const configFileDetected = findExistingConfigFile((p2) => configExists(p2) ? "" : void 0, io.cwd) !== void 0;
     const detected = [
-      ...viteConfigExists ? VITE_TARGETS.map((t) => t.id) : [],
+      ...viteConfigExists ? targetsOfKind("vite").map((t) => t.id) : [],
       ...detectedAgents,
-      ...ciWorkflowDetected ? CI_TARGETS.map((t) => t.id) : [],
-      ...configFileDetected ? CONFIG_TARGETS.map((t) => t.id) : []
+      ...ciWorkflowDetected ? ["ci-workflow"] : [],
+      ...configFileDetected ? ["config-file"] : []
     ];
+    const asOption = (t) => ({ id: t.id, label: t.label, hint: t.hint });
     const groups = {
-      "Vite integration": VITE_TARGETS.map((t) => ({ id: t.id, label: t.label, hint: t.hint })),
-      "Agent Skills & rules": AGENT_TARGETS.map((t) => ({ id: t.id, label: t.label, hint: t.hint })),
-      "CI (GitHub Actions)": CI_TARGETS.map((t) => ({ id: t.id, label: t.label, hint: t.hint })),
-      "Config file": CONFIG_TARGETS.map((t) => ({ id: t.id, label: t.label, hint: t.hint }))
+      "Vite integration": targetsOfKind("vite").map(asOption),
+      "Agent Skills & rules": targetsOfKind("agent").map(asOption),
+      "CI (GitHub Actions)": targetsOfKind("ci").map(asOption),
+      "Config file": targetsOfKind("config").map(asOption)
     };
     const picked = await prompts.selectClients(groups, detected);
     if (picked === null) {
@@ -1111,10 +1152,10 @@ async function runInstall(flags, io, prompts, version = "0.0.0") {
     );
     return 2;
   }
-  const viteIds = ids.filter(isViteTargetId);
-  const agentIds = ids.filter(isAgentTargetId);
-  const configIds = ids.filter(isConfigTargetId);
-  const ciIds = ids.filter(isCiTargetId);
+  const viteIds = ids.filter((id) => isKind(id, "vite"));
+  const agentIds = ids.filter((id) => isKind(id, "agent"));
+  const configIds = ids.filter((id) => isKind(id, "config"));
+  const ciIds = ids.filter((id) => isKind(id, "ci"));
   if (viteIds.length === 0 && agentIds.length === 0 && configIds.length === 0 && ciIds.length === 0) {
     io.errorLog("svelte-vitals: no valid targets selected.");
     return 2;
@@ -1124,10 +1165,10 @@ async function runInstall(flags, io, prompts, version = "0.0.0") {
       if (io.readFile(join3(dir, "svelte.config.js")) !== void 0 || io.readFile(join3(dir, "svelte.config.ts")) !== void 0) {
         return true;
       }
-      const pkgRaw = io.readFile(join3(dir, "package.json"));
-      if (pkgRaw === void 0) return false;
-      const pkg = JSON.parse(pkgRaw);
-      return Boolean(pkg.dependencies?.["@sveltejs/kit"] ?? pkg.devDependencies?.["@sveltejs/kit"]);
+      return hasDep(
+        readPkg((p2) => io.readFile(p2), dir),
+        "@sveltejs/kit"
+      );
     } catch {
       return false;
     }
@@ -1177,20 +1218,18 @@ async function runInstall(flags, io, prompts, version = "0.0.0") {
     }
   }
   for (const agentId of agentIds) {
-    const target = agentTargetById(agentId);
     try {
-      rows.push(...planForAgentTarget(target, io, flags.force ?? false, version));
+      rows.push(...planForAgentTarget(agentId, io, flags.force ?? false, version));
     } catch (err) {
       io.errorLog(
-        `svelte-vitals: could not check existing agent target ${target.id}: ${err instanceof Error ? err.message : String(err)}`
+        `svelte-vitals: could not check existing agent target ${agentId}: ${err instanceof Error ? err.message : String(err)}`
       );
       return 2;
     }
   }
-  for (const configId of configIds) {
-    const target = configTargetById(configId);
+  if (configIds.length > 0) {
     try {
-      rows.push(planForConfigTarget(target, io, flags.force ?? false, appDir));
+      rows.push(planForConfigTarget(io, flags.force ?? false, appDir));
     } catch (err) {
       io.errorLog(
         `svelte-vitals: could not check existing config file: ${err instanceof Error ? err.message : String(err)}`
@@ -1198,13 +1237,12 @@ async function runInstall(flags, io, prompts, version = "0.0.0") {
       return 2;
     }
   }
-  for (const ciId of ciIds) {
-    const target = ciTargetById(ciId);
+  if (ciIds.length > 0) {
     try {
-      rows.push(planForCiTarget(target, io, flags.force ?? false));
+      rows.push(planForCiTarget(io, flags.force ?? false));
     } catch (err) {
       io.errorLog(
-        `svelte-vitals: could not check existing workflow at ${join3(io.cwd, target.relPath)}: ${err instanceof Error ? err.message : String(err)}`
+        `svelte-vitals: could not check existing workflow at ${join3(io.cwd, targetById("ci-workflow").relPaths[0])}: ${err instanceof Error ? err.message : String(err)}`
       );
       return 2;
     }
@@ -1227,7 +1265,7 @@ async function runInstall(flags, io, prompts, version = "0.0.0") {
   let viteWasWritten = false;
   for (const r of rows) {
     if (r.status === "exists") {
-      const hint = isViteTargetId(r.id) ? "" : " \u2014 use --force to overwrite";
+      const hint = isKind(r.id, "vite") ? "" : " \u2014 use --force to overwrite";
       io.log(`= ${r.label}: already configured (${r.path})${hint}.`);
       continue;
     }
@@ -1239,8 +1277,8 @@ ${indent(r.snippet ?? "")}`);
     try {
       io.writeFile(r.path, r.content ?? "");
       io.log(`\u2713 ${r.label}: ${r.status} ${r.path}`);
-      if (isViteTargetId(r.id)) viteWasWritten = true;
-      if (isConfigTargetId(r.id) && r.path.endsWith(".ts")) {
+      if (isKind(r.id, "vite")) viteWasWritten = true;
+      if (isKind(r.id, "config") && r.path.endsWith(".ts")) {
         io.log(
           "svelte-vitals: note \u2014 a .ts config needs Node 22.18+ (or 23.6+) everywhere svelte-vitals runs, CI included; rename to .mjs if that is not guaranteed."
         );
@@ -1276,17 +1314,21 @@ ${indent(r.snippet ?? "")}`);
 }
 
 // src/install/args.ts
-var VALID_TARGETS = [
-  ...VITE_TARGETS.map((t) => t.id),
-  ...AGENT_TARGETS.map((t) => t.id),
-  ...CONFIG_TARGETS.map((t) => t.id),
-  ...CI_TARGETS.map((t) => t.id)
-];
+var VALID_TARGETS = INSTALL_TARGETS.map((t) => t.id);
 var EXPECTED_TARGETS = VALID_TARGETS.join("|");
+function parseInstallArgs(args) {
+  return parseCliArgs(args, {
+    boolean: ["yes", "dry-run", "force", "refresh", "help"],
+    // `scope` is still declared although the flag is gone: it keeps `--scope global` from
+    // parsing its value as a positional, so resolveInstallArgs can warn and carry on.
+    string: ["client", "scope", "app"],
+    short: { y: "yes", h: "help" }
+  });
+}
 function resolveInstallArgs(argv) {
   const warnings = [];
   const errors = [];
-  const rawClients = typeof argv.client === "string" ? argv.client.split(",").map((s) => s.trim()).filter(Boolean) : [];
+  const rawClients = toList(argv.client);
   const client = [];
   for (const c of rawClients) {
     if (VALID_TARGETS.includes(c)) {
@@ -1408,6 +1450,14 @@ function realIO() {
     }
   };
 }
+async function selectAppPrompt(apps, message) {
+  const res = await p.select({
+    message,
+    options: apps.map((a) => ({ value: a, label: a })),
+    initialValue: apps[0]
+  });
+  return p.isCancel(res) ? null : res;
+}
 function clackPrompts() {
   return {
     selectClients: async (groups, defaults) => {
@@ -1424,14 +1474,7 @@ function clackPrompts() {
       });
       return p.isCancel(res) ? null : res;
     },
-    selectApp: async (apps) => {
-      const res = await p.select({
-        message: "Multiple SvelteKit apps found \u2014 which one should the Vite/config targets go into?",
-        options: apps.map((a) => ({ value: a, label: a })),
-        initialValue: apps[0]
-      });
-      return p.isCancel(res) ? null : res;
-    },
+    selectApp: (apps) => selectAppPrompt(apps, "Multiple SvelteKit apps found \u2014 which one should the Vite/config targets go into?"),
     confirm: async (planText) => {
       const res = await p.confirm({ message: `Apply this plan?
 ${planText}` });
@@ -1440,13 +1483,7 @@ ${planText}` });
   };
 }
 async function runInstallCli(args) {
-  const argv = mri(args, {
-    boolean: ["yes", "dry-run", "force", "refresh", "help"],
-    // `scope` is still declared although the flag is gone: it keeps `--scope global` from
-    // parsing its value as a positional, so resolveInstallArgs can warn and carry on.
-    string: ["client", "scope", "app"],
-    alias: { y: "yes", h: "help" }
-  });
+  const argv = parseInstallArgs(args);
   if (argv.help) {
     console.log(INSTALL_HELP);
     return 0;
@@ -1460,7 +1497,6 @@ async function runInstallCli(args) {
 
 // src/ci/cli.ts
 import { join as join4 } from "path";
-import mri2 from "mri";
 
 // src/ci/upgrade.ts
 var CANONICAL_PATH = "oekazuma/svelte-vitals-action";
@@ -1529,10 +1565,7 @@ async function runCiCli(args, io = realIO()) {
     io.log(CI_HELP);
     return 2;
   }
-  const argv = mri2(args.slice(1), {
-    boolean: ["force", "dry-run", "help"],
-    alias: { h: "help" }
-  });
+  const argv = parseCliArgs(args.slice(1), { boolean: ["force", "dry-run", "help"], short: { h: "help" } });
   if (argv.help) {
     io.log(CI_HELP);
     return 0;
@@ -1563,10 +1596,7 @@ async function runCiCli(args, io = realIO()) {
   return 0;
 }
 async function runCiUpgrade(args, io) {
-  const argv = mri2(args, {
-    boolean: ["dry-run", "help"],
-    alias: { h: "help" }
-  });
+  const argv = parseCliArgs(args, { boolean: ["dry-run", "help"], short: { h: "help" } });
   if (argv.help) {
     io.log(CI_HELP);
     return 0;
@@ -1602,7 +1632,6 @@ async function runCiUpgrade(args, io) {
 }
 
 // src/explain.ts
-import mri3 from "mri";
 import { allRules as allRules2, CATEGORIES as CATEGORIES2, explainRule } from "@svelte-vitals/core";
 var EXPLAIN_HELP = `svelte-vitals explain \u2014 print a rule's rationale, fix, and configurable options
 
@@ -1652,7 +1681,7 @@ function renderRuleList() {
   );
 }
 function runExplainCli(args, io = consoleIO) {
-  const argv = mri3(args, { boolean: ["json", "list", "help"], alias: { h: "help" } });
+  const argv = parseCliArgs(args, { boolean: ["json", "list", "help"], short: { h: "help" } });
   if (argv.help) {
     io.log(EXPLAIN_HELP);
     return 0;
@@ -1750,17 +1779,13 @@ If you are an AI agent:
     naming the flag to pass. \`install\` is the exception \u2014 non-interactively it skips its
     confirmation and writes, so pass \`--dry-run\` first if you need to see the plan.`;
 var VERSION = readPackageVersion();
-async function selectApp(apps) {
-  const res = await p2.select({
-    message: "Multiple SvelteKit apps found \u2014 which one should svelte-vitals analyze?",
-    options: apps.map((a) => ({ value: a, label: a }))
-  });
-  return p2.isCancel(res) ? null : res;
+function selectApp(apps) {
+  return selectAppPrompt(apps, "Multiple SvelteKit apps found \u2014 which one should svelte-vitals analyze?");
 }
 async function main() {
   const rawArgs = process.argv.slice(2);
   if (rawArgs[0] === "docs") {
-    const { runDocsCli } = await import("./cli-J5V65YIN.js");
+    const { runDocsCli } = await import("./cli-LGD6NDAO.js");
     process.exitCode = runDocsCli(rawArgs.slice(1));
     return;
   }
@@ -1776,25 +1801,7 @@ async function main() {
     const code2 = await runCiCli(rawArgs.slice(1));
     process.exit(code2);
   }
-  const argv = mri4(process.argv.slice(2), {
-    alias: { h: "help", v: "version" },
-    boolean: ["by-route", "staged", "score", "verbose", "update-suppressions"],
-    string: [
-      "meta-components",
-      "treat-dynamic-as",
-      "route",
-      "fail-on",
-      "reporter",
-      "rules",
-      "ignore",
-      "min-health",
-      "out-file",
-      "diff",
-      "baseline",
-      "weights",
-      "category"
-    ]
-  });
+  const argv = parseRunArgs(rawArgs);
   if (argv.help) {
     console.log(HELP);
     return;
@@ -1804,20 +1811,10 @@ async function main() {
     console.error("svelte-vitals: run `svelte-vitals docs list` for the bundled guides.");
     return;
   }
-  const { options, warnings, errors } = resolveArgs(argv);
+  const { options, warnings, errors, minHealth } = resolveArgs(argv);
   for (const w of warnings) console.error(w);
   for (const e of errors) console.error(e);
   if (!options) process.exit(2);
-  const minHealthRaw = argv["min-health"];
-  let minHealth;
-  if (minHealthRaw !== void 0) {
-    const n = Number(minHealthRaw);
-    if (!Number.isFinite(n) || n < 0 || n > 100) {
-      console.error(`svelte-vitals: invalid --min-health '${minHealthRaw}'; expected a number 0-100.`);
-      process.exit(2);
-    }
-    minHealth = n;
-  }
   const code = await run({
     ...options,
     minHealth,