@colrealpro/react-luau-doctor 0.17.0 → 0.17.1

package/dist/cli.js

@@ -11,8 +11,8 @@ var package_default = {
   publishConfig: {
     access: "public"
   },
-  version: "0.17.0",
-  description: "A syntax-aware React-Luau code doctor inspired by React Doctor.",
+  version: "0.17.1",
+  description: "Static analysis for React-Luau hooks, effects, rendering, and performance.",
   license: "MIT",
   type: "module",
   bin: {
@@ -24,8 +24,7 @@ var package_default = {
     "README.md",
     "LICENSE",
     "THIRD_PARTY_NOTICES.md",
-    "docs",
-    "action.yml"
+    "docs"
   ],
   scripts: {
     build: "bun run scripts/build.ts",
@@ -37,14 +36,14 @@ var package_default = {
     "verify:package": "bun run build && bun run scripts/verify-package.ts"
   },
   engines: {
-    bun: ">=1.3.14"
+    bun: ">=1.4.0"
   },
-  packageManager: "bun@1.3.14",
+  packageManager: "bun@1.4.0",
   dependencies: {
     "web-tree-sitter": "0.26.11"
   },
   devDependencies: {
-    "@types/bun": "1.3.14",
+    "@types/bun": "1.4.0",
     typescript: "5.8.3"
   },
   keywords: [
@@ -67,21 +66,18 @@ var package_default = {
 // src/config.ts
 import fs from "fs";
 import path from "path";
-var CONFIG_NAMES = ["react-luau-doctor.config.json", "doctor.config.json"];
+var CONFIG_NAME = "react-luau-doctor.config.json";
 var SEVERITIES = new Set(["off", "error", "warning", "suggestion"]);
 var SCOPES = new Set(["full", "files", "changed", "lines"]);
 var BLOCKING_LEVELS = new Set(["error", "warning", "none"]);
 var CATEGORIES = new Set(["Correctness", "Hooks", "Effects", "Performance", "Roblox", "Architecture"]);
 function loadConfigWithSource(root) {
-  for (const filename of CONFIG_NAMES) {
-    const candidate = path.join(root, filename);
-    if (!fs.existsSync(candidate))
-      continue;
-    const parsed = JSON.parse(fs.readFileSync(candidate, "utf8"));
-    validateConfig(parsed, candidate);
-    return { config: parsed, filename: candidate };
-  }
-  return { config: {}, filename: null };
+  const candidate = path.join(root, CONFIG_NAME);
+  if (!fs.existsSync(candidate))
+    return { config: {}, filename: null };
+  const parsed = JSON.parse(fs.readFileSync(candidate, "utf8"));
+  validateConfig(parsed, candidate);
+  return { config: parsed, filename: candidate };
 }
 function loadConfig(root) {
   return loadConfigWithSource(root).config;
@@ -96,8 +92,6 @@ function validateConfig(config, filename) {
     validateStringArray(config.include, "include", filename);
   if (config.ignore !== undefined)
     validateStringArray(config.ignore, "ignore", filename);
-  if (config.ignoredTags !== undefined)
-    validateStringArray(config.ignoredTags, "ignoredTags", filename);
   if (config.projects !== undefined)
     validateStringArray(config.projects, "projects", filename);
   if (config.categories !== undefined) {
@@ -129,22 +123,8 @@ function validateConfig(config, filename) {
   if (config.blocking !== undefined && !BLOCKING_LEVELS.has(config.blocking)) {
     throw new Error(`${filename}: blocking must be error, warning, or none`);
   }
-  if (config.failOn !== undefined && !BLOCKING_LEVELS.has(config.failOn)) {
-    throw new Error(`${filename}: failOn must be error, warning, or none`);
-  }
 }
-function ruleTags(rule) {
-  return [...new Set([rule.category.toLowerCase(), ...(rule.tags ?? []).map((tag) => tag.toLowerCase())])];
-}
-function ruleFrameworks(rule) {
-  if (rule.frameworks && rule.frameworks.length > 0)
-    return rule.frameworks.map((framework) => framework.toLowerCase());
-  return rule.category === "Roblox" ? ["react-luau", "roblox"] : ["react-luau", "global"];
-}
-function effectiveSeverity(defaultSeverity, ruleId, config, tags = []) {
-  const ignoredTags = new Set((config.ignoredTags ?? []).map((tag) => tag.toLowerCase()));
-  if (tags.some((tag) => ignoredTags.has(tag.toLowerCase())))
-    return null;
+function effectiveSeverity(defaultSeverity, ruleId, config) {
   const configured = config.rules?.[ruleId];
   if (!configured)
     return defaultSeverity;
@@ -152,12 +132,12 @@ function effectiveSeverity(defaultSeverity, ruleId, config, tags = []) {
 }
 function configPathForWrite(root) {
   const loaded = loadConfigWithSource(root);
-  return loaded.filename ?? path.join(root, CONFIG_NAMES[0]);
+  return loaded.filename ?? path.join(root, CONFIG_NAME);
 }
 function writeConfig(root, update) {
   const loaded = loadConfigWithSource(root);
   const next = update(structuredClone(loaded.config));
-  validateConfig(next, loaded.filename ?? CONFIG_NAMES[0]);
+  validateConfig(next, loaded.filename ?? CONFIG_NAME);
   const filename = loaded.filename ?? configPathForWrite(root);
   fs.mkdirSync(path.dirname(filename), { recursive: true });
   fs.writeFileSync(filename, `${JSON.stringify(next, null, 2)}
@@ -582,6 +562,7 @@ function createGitScopePlan(scanRootInput, options, relativeRootInput = scanRoot
 }
 
 // src/reporter.ts
+var VERSION = package_default.version;
 var SYMBOLS = {
   error: "x",
   warning: "!",
@@ -744,7 +725,7 @@ function renderCounts(report, colorized) {
   ].join(", ");
 }
 function renderHeader(report, colorized) {
-  const title = colorized ? paint("React-Luau Doctor", ANSI.bold, ANSI.magenta) : "React-Luau Doctor";
+  const title = colorized ? `${paint("React-Luau Doctor", ANSI.bold, ANSI.magenta)} ${paint(`v${VERSION}`, ANSI.dim)}` : `React-Luau Doctor v${VERSION}`;
   const scopeSuffix = report.scope && report.scope !== "full" ? ` (${report.scope} scope)` : "";
   const lines2 = [title, `Scanned ${report.scannedFiles} React-Luau files in ${report.durationMs.toFixed(2)}ms${scopeSuffix}`];
   if (report.partial) {
@@ -3237,7 +3218,7 @@ function directNodes(body) {
 function topLevelFunctionRecords(record) {
   const functions = [];
   let anonymousExportIndex = 0;
-  const add = (node, body, nameText, localName, memberName, method, exported) => {
+  const add = (node, body, localName, memberName, method, exported) => {
     if (!body)
       return;
     const key = memberName ? `member:${memberName}` : localName ? `local:${localName}` : `export:${anonymousExportIndex++}`;
@@ -3262,9 +3243,9 @@ function topLevelFunctionRecords(record) {
       const text = nameNode?.text.replace(/\s+/g, "") ?? "";
       const methodMatch = text.match(/^([A-Za-z_][A-Za-z0-9_]*)[:.]([A-Za-z_][A-Za-z0-9_]*)$/);
       if (methodMatch && methodMatch[1] === record.exportName) {
-        add(node, body, text, null, methodMatch[2], nameNode?.type === "method_index_expression", false);
+        add(node, body, null, methodMatch[2], nameNode?.type === "method_index_expression", false);
       } else if (nameNode?.type === "identifier") {
-        add(node, body, text, text, null, false, record.exportName === text);
+        add(node, body, text, null, false, record.exportName === text);
       }
       continue;
     }
@@ -3274,7 +3255,7 @@ function topLevelFunctionRecords(record) {
         const expression = expressions[index] ?? expressions[0];
         if (expression?.type !== "function_definition")
           continue;
-        add(expression, child(expression, "block"), names[index], names[index], null, false, record.exportName === names[index]);
+        add(expression, child(expression, "block"), names[index], null, false, record.exportName === names[index]);
       }
       continue;
     }
@@ -3287,7 +3268,7 @@ function topLevelFunctionRecords(record) {
         const text = left[index].text.replace(/\s+/g, "");
         const memberMatch = text.match(/^([A-Za-z_][A-Za-z0-9_]*)[.:]([A-Za-z_][A-Za-z0-9_]*)$/);
         if (memberMatch && memberMatch[1] === record.exportName) {
-          add(expression, child(expression, "block"), text, null, memberMatch[2], text.includes(":"), false);
+          add(expression, child(expression, "block"), null, memberMatch[2], text.includes(":"), false);
         }
       }
       continue;
@@ -3296,7 +3277,7 @@ function topLevelFunctionRecords(record) {
       const expressions = child(node, "expression_list");
       const expression = expressions?.namedChildren[0];
       if (expression?.type === "function_definition")
-        add(expression, child(expression, "block"), null, null, null, false, true);
+        add(expression, child(expression, "block"), null, null, false, true);
     }
   }
   return functions;
@@ -5161,7 +5142,7 @@ function declarationExpressions3(node) {
   const expressionList = assignment?.namedChildren.find((child2) => child2.type === "expression_list");
   return expressionList?.namedChildren ?? [];
 }
-function directCallsInExpression(node, context) {
+function directCallsInExpression(node) {
   const calls = [];
   const pending = [node];
   while (pending.length > 0) {
@@ -5213,7 +5194,7 @@ function customHookDependencyHints(owner, context) {
       const expression = expressions[index] ?? expressions[0];
       if (!expression)
         continue;
-      const calls = directCallsInExpression(expression, context);
+      const calls = directCallsInExpression(expression);
       if (calls.length === 0)
         continue;
       const directHook = calls.find((call) => isCustomHookCall(call, context));
@@ -6339,7 +6320,7 @@ function isIdentifierPropertyName2(node) {
     return sameNode(parent.childForFieldName("method"), node) || sameNode(parent.namedChildren.at(-1), node);
   return false;
 }
-function isReadNode(node, valueName, owner, declaration, context) {
+function isReadNode(node, valueName, owner, declaration) {
   if (node.type !== "identifier" || node.text !== valueName)
     return false;
   if (isInside2(node, declaration))
@@ -6359,7 +6340,7 @@ function isReadNode(node, valueName, owner, declaration, context) {
 function hasAnyRead(valueName, owner, declaration, context) {
   if (!owner.body)
     return false;
-  return [...context.walk(owner.body)].some((node) => isReadNode(node, valueName, owner, declaration, context));
+  return [...context.walk(owner.body)].some((node) => isReadNode(node, valueName, owner, declaration));
 }
 function isCreateElementCall2(call, context) {
   return call.type === "function_call" && context.resolveCallPath(context.getCallPath(call) ?? "") === "React.createElement";
@@ -6436,7 +6417,7 @@ function stateReadsAreBindingCompatible(valueName, owner, declaration, context,
   visited.add(visitKey);
   let reads = 0;
   for (const node of context.walk(owner.body)) {
-    if (!isReadNode(node, valueName, owner, declaration, context))
+    if (!isReadNode(node, valueName, owner, declaration))
       continue;
     reads += 1;
     if (isTransparentUsage(node, context, compatibleComponentProps))
@@ -6721,7 +6702,7 @@ function bindingUsageSummary(valueName, owner, declaration, context, compatibleC
   if (!owner.body)
     return summary;
   for (const node of context.walk(owner.body)) {
-    if (!isReadNode(node, valueName, owner, declaration, context))
+    if (!isReadNode(node, valueName, owner, declaration))
       continue;
     summary.reads += 1;
     const customComponentUsage = createElementPropUsage(node, context);
@@ -7519,7 +7500,7 @@ function stableShapeVariablesByFunction(context) {
   }
   return stable;
 }
-function loopIterationIsProvablyStable(loop, context, imports, owner, stableShapes) {
+function loopIterationIsProvablyStable(loop, imports, owner, stableShapes) {
   const numeric = loop.namedChildren.find((child2) => child2.type === "for_numeric_clause");
   if (numeric) {
     const text = numeric.text;
@@ -7723,7 +7704,7 @@ end`,
       if (controlFlow) {
         if (currentModeSummary && currentModeSummary.knownCallSites > 0 && controlledParameterIndex(controlFlow, fn, currentModeSummary) !== null)
           continue;
-        if (controlFlow.type === "for_statement" && loopIterationIsProvablyStable(controlFlow, context, staticImports, fn, stableShapes))
+        if (controlFlow.type === "for_statement" && loopIterationIsProvablyStable(controlFlow, staticImports, fn, stableShapes))
           continue;
         const kind = controlFlow.type.replaceAll("_", " ");
         const loopLike = controlFlow.type === "for_statement" || controlFlow.type === "while_statement" || controlFlow.type === "repeat_statement";
@@ -8319,8 +8300,7 @@ async function scanPath(target = ".", options = {}) {
     minSeverity,
     categories: options.categories ? [...options.categories].sort() : [],
     respectInlineDisables,
-    rules: config.rules ?? {},
-    ignoredTags: [...config.ignoredTags ?? []].sort()
+    rules: config.rules ?? {}
   });
   const canCacheWholeReport = canPersistCache && targetIsProjectRoot && options.files === undefined && deadlineAt === undefined;
   const previousReport = canCacheWholeReport ? previousCachedReport(cacheSession, reportCacheKey) : null;
@@ -8442,7 +8422,7 @@ async function scanPath(target = ".", options = {}) {
       for (const rule of rules) {
         if (categorySet && !categorySet.has(rule.category))
           continue;
-        const severity = effectiveSeverity(rule.severity, rule.id, config, ruleTags(rule));
+        const severity = effectiveSeverity(rule.severity, rule.id, config);
         if (!severity)
           continue;
         const findings = rule.run(context);
@@ -8648,12 +8628,11 @@ var DEFAULT_SETTINGS = {
   project: "*"
 };
 var GITHUB_WORKFLOW = path11.join(".github", "workflows", "react-luau-doctor.yml");
-var GITHUB_LOCAL_ACTION = path11.join(".github", "actions", "react-luau-doctor", "action.yml");
 var GITLAB_WORKFLOW = ".gitlab-ci.yml";
 var SUMMARY_MARKER = "<!-- react-luau-doctor:summary -->";
 var REVIEW_MARKER = "<!-- react-luau-doctor:review -->";
 var MAX_REVIEW_COMMENTS = 20;
-var PACKAGE_VERSION = package_default.version;
+var PACKAGE_SPEC = `${package_default.name}@${package_default.version}`;
 function yamlString(value) {
   return JSON.stringify(value);
 }
@@ -8682,92 +8661,25 @@ jobs:
       - uses: actions/checkout@v5
         with:
           fetch-depth: 0
-      - uses: ./.github/actions/react-luau-doctor
+      - uses: oven-sh/setup-bun@v2
         with:
-          blocking: ${settings.blocking}
-          scope: ${settings.scope}
-          comment: ${settings.comment}
-          review-comments: ${settings.reviewComments}
-          commit-status: ${settings.commitStatus}
-          project: ${yamlString(settings.project)}
-          directory: ${yamlString(settings.directory)}
-`;
-}
-function renderLocalGitHubAction() {
-  return renderPublishedGitHubAction();
-}
-function renderPublishedGitHubAction() {
-  return `name: React-Luau Doctor
-description: "Review React-Luau pull requests and report introduced diagnostics."
-inputs:
-  blocking:
-    description: "Severity that fails the workflow: error, warning, or none."
-    default: none
-  scope:
-    description: "Pull request scan scope: changed, files, lines, or full."
-    default: changed
-  comment:
-    description: "Create or update a sticky pull request summary comment."
-    default: "true"
-  review-comments:
-    description: "Post inline review comments on changed lines."
-    default: "true"
-  commit-status:
-    description: "Publish score and issue counts as a commit status."
-    default: "true"
-  project:
-    description: "Project directories to scan, comma-separated. Asterisk scans the whole directory."
-    default: "*"
-  directory:
-    description: "Project directory to scan."
-    default: "."
-outputs:
-  score:
-    description: "Health score from 0 to 100."
-    value: \${{ steps.doctor.outputs.score }}
-  total-issues:
-    description: "Total diagnostics reported by this run."
-    value: \${{ steps.doctor.outputs.total-issues }}
-  fixed-issues:
-    description: "Number of diagnostics resolved by the pull request."
-    value: \${{ steps.doctor.outputs.fixed-issues }}
-  error-count:
-    description: "Error diagnostic count."
-    value: \${{ steps.doctor.outputs.error-count }}
-  warning-count:
-    description: "Warning diagnostic count."
-    value: \${{ steps.doctor.outputs.warning-count }}
-  affected-files:
-    description: "Number of files with diagnostics."
-    value: \${{ steps.doctor.outputs.affected-files }}
-runs:
-  using: composite
-  steps:
-    - uses: oven-sh/setup-bun@v2
-      with:
-        bun-version: "1.3.14"
-    - name: Install parser runtime
-      shell: bash
-      run: |
-        cd "$GITHUB_ACTION_PATH"
-        bun install --production --frozen-lockfile
-    - id: doctor
-      shell: bash
-      env:
-        GITHUB_TOKEN: \${{ github.token }}
-        DOCTOR_DIRECTORY: \${{ inputs.directory }}
-        DOCTOR_PROJECT: \${{ inputs.project }}
-        DOCTOR_BLOCKING: \${{ inputs.blocking }}
-        DOCTOR_SCOPE: \${{ inputs.scope }}
-      run: >-
-        bun "$GITHUB_ACTION_PATH/dist/cli.js" ci run
-        --directory "$DOCTOR_DIRECTORY"
-        --project "$DOCTOR_PROJECT"
-        --blocking "$DOCTOR_BLOCKING"
-        --scope "$DOCTOR_SCOPE"
-        \${{ inputs.comment == 'true' && '--comment' || '--no-comment' }}
-        \${{ inputs.review-comments == 'true' && '--review-comments' || '--no-review-comments' }}
-        \${{ inputs.commit-status == 'true' && '--commit-status' || '--no-commit-status' }}
+          bun-version: "1.4.0"
+      - id: doctor
+        env:
+          GITHUB_TOKEN: \${{ github.token }}
+          DOCTOR_DIRECTORY: ${yamlString(settings.directory)}
+          DOCTOR_PROJECT: ${yamlString(settings.project)}
+          DOCTOR_BLOCKING: ${settings.blocking}
+          DOCTOR_SCOPE: ${settings.scope}
+        run: >-
+          bunx --bun ${PACKAGE_SPEC} ci run
+          --directory "$DOCTOR_DIRECTORY"
+          --project "$DOCTOR_PROJECT"
+          --blocking "$DOCTOR_BLOCKING"
+          --scope "$DOCTOR_SCOPE"
+          ${settings.comment ? "--comment" : "--no-comment"}
+          ${settings.reviewComments ? "--review-comments" : "--no-review-comments"}
+          ${settings.commitStatus ? "--commit-status" : "--no-commit-status"}
 `;
 }
 function renderGitLabWorkflow(settings) {
@@ -8776,41 +8688,16 @@ function renderGitLabWorkflow(settings) {
 
 react-luau-doctor:
   stage: test
-  image: oven/bun:1.3.14
+  image: oven/bun:1.4.0
   variables:
     GIT_DEPTH: "0"
     DOCTOR_DIRECTORY: ${yamlString(settings.directory)}
     DOCTOR_SCOPE: ${yamlString(settings.scope)}
     DOCTOR_BLOCKING: ${yamlString(settings.blocking)}
   script:
-    - '(cd .gitlab/react-luau-doctor && bun install --production --frozen-lockfile)'
-    - 'bun .gitlab/react-luau-doctor/dist/cli.js "$DOCTOR_DIRECTORY" --scope "$DOCTOR_SCOPE" --blocking "$DOCTOR_BLOCKING" --no-color'
+    - 'bunx --bun ${PACKAGE_SPEC} "$DOCTOR_DIRECTORY" --scope "$DOCTOR_SCOPE" --blocking "$DOCTOR_BLOCKING" --no-color'
 `;
 }
-function copyCiRuntime(destination) {
-  const root = path11.resolve(import.meta.dir, "..");
-  const entries = ["dist", "vendor", "package.json", "LICENSE", "THIRD_PARTY_NOTICES.md"];
-  for (const entry of entries) {
-    if (!fs9.existsSync(path11.join(root, entry)))
-      throw new Error(`Missing ${entry}; run bun run build before installing CI`);
-  }
-  const lockfile = fs9.existsSync(path11.join(root, "bun.lock")) ? path11.join(root, "bun.lock") : path11.join(root, "dist/runtime-lock.json");
-  if (!fs9.existsSync(lockfile))
-    throw new Error("Missing runtime lockfile; rebuild or reinstall Doctor");
-  fs9.mkdirSync(destination, { recursive: true });
-  const copiedLock = path11.join(destination, "bun.lock");
-  if (path11.resolve(lockfile) !== path11.resolve(copiedLock))
-    fs9.copyFileSync(lockfile, copiedLock);
-  const files = [copiedLock];
-  for (const entry of entries) {
-    const target = path11.join(destination, entry);
-    if (path11.resolve(root, entry) === path11.resolve(target))
-      continue;
-    fs9.cpSync(path11.join(root, entry), target, { recursive: true });
-    files.push(target);
-  }
-  return files;
-}
 function parseBoolean(value, name) {
   if (value === "true")
     return true;
@@ -8887,24 +8774,22 @@ function parseManagedWorkflowSettings(filename) {
   if (!fs9.existsSync(filename))
     return {};
   const text = fs9.readFileSync(filename, "utf8");
-  if (filename.endsWith(".gitlab-ci.yml")) {
-    const scope2 = text.match(/--scope\s+(full|files|changed|lines)/)?.[1];
-    const blocking2 = text.match(/--blocking\s+(error|warning|none)/)?.[1];
-    return {
-      provider: "gitlab",
-      scope: scope2 ? parseScope(scope2) : DEFAULT_SETTINGS.scope,
-      blocking: blocking2 ? parseBlocking(blocking2) : "none"
-    };
-  }
   const match = (name) => text.match(new RegExp(`^\\s*${name}:\\s*(.+?)\\s*$`, "m"))?.[1]?.replace(/^['"]|['"]$/g, "");
-  const result = {};
-  const blocking = match("blocking");
-  const scope = match("scope");
-  const comment = match("comment");
-  const reviewComments = match("review-comments");
-  const commitStatus = match("commit-status");
-  const project = match("project");
-  const directory = match("directory");
+  const result = { provider: filename.endsWith(".gitlab-ci.yml") ? "gitlab" : "github" };
+  const blocking = match("DOCTOR_BLOCKING") ?? match("blocking");
+  const scope = match("DOCTOR_SCOPE") ?? match("scope");
+  const project = match("DOCTOR_PROJECT") ?? match("project");
+  const directory = match("DOCTOR_DIRECTORY") ?? match("directory");
+  const flag = (enabled, disabled) => {
+    if (text.includes(disabled))
+      return false;
+    if (text.includes(enabled))
+      return true;
+    return;
+  };
+  const comment = match("comment") ?? flag("--comment", "--no-comment")?.toString();
+  const reviewComments = match("review-comments") ?? flag("--review-comments", "--no-review-comments")?.toString();
+  const commitStatus = match("commit-status") ?? flag("--commit-status", "--no-commit-status")?.toString();
   if (blocking)
     result.blocking = parseBlocking(blocking);
   if (scope)
@@ -8954,21 +8839,16 @@ async function completeSettings(options, current, action) {
 function writeManagedCi(cwd, settings) {
   if (settings.provider === "github") {
     const workflow2 = path11.join(cwd, GITHUB_WORKFLOW);
-    const action = path11.join(cwd, GITHUB_LOCAL_ACTION);
-    const runtimeFiles2 = copyCiRuntime(path11.dirname(action));
     fs9.mkdirSync(path11.dirname(workflow2), { recursive: true });
-    fs9.mkdirSync(path11.dirname(action), { recursive: true });
     fs9.writeFileSync(workflow2, renderGitHubWorkflow(settings));
-    fs9.writeFileSync(action, renderLocalGitHubAction());
-    return [workflow2, action, ...runtimeFiles2];
+    return [workflow2];
   }
   const workflow = path11.join(cwd, GITLAB_WORKFLOW);
   if (fs9.existsSync(workflow) && !fs9.readFileSync(workflow, "utf8").includes("react-luau-doctor")) {
     throw new Error(".gitlab-ci.yml already exists and is not managed by React-Luau Doctor; add the generated job manually instead of overwriting it");
   }
-  const runtimeFiles = copyCiRuntime(path11.join(cwd, ".gitlab", "react-luau-doctor"));
   fs9.writeFileSync(workflow, renderGitLabWorkflow(settings));
-  return [workflow, ...runtimeFiles];
+  return [workflow];
 }
 function runCommand(cwd, command, args, allowFailure = false) {
   const result = spawnSync2(command, args, { cwd, encoding: "utf8", windowsHide: true });
@@ -9293,7 +9173,7 @@ function parseCiRunOptions(argv) {
   }
   return settings;
 }
-async function runCiAction(argv) {
+async function runCiJob(argv) {
   const settings = parseCiRunOptions(argv);
   const eventName = process.env.GITHUB_EVENT_NAME ?? "";
   const event = githubEvent();
@@ -9354,7 +9234,7 @@ async function runCiCommand(argv) {
     return;
   }
   if (action === "run") {
-    await runCiAction(argv.slice(1));
+    await runCiJob(argv.slice(1));
     return;
   }
   throw new Error("ci requires install, config, or upgrade");
@@ -9830,7 +9710,7 @@ function createProgressRenderer(options = {}) {
 }
 
 // src/cli.ts
-var VERSION = package_default.version;
+var VERSION2 = package_default.version;
 var SCOPES2 = new Set(["full", "files", "changed", "lines"]);
 var BLOCKING = new Set(["error", "warning", "none"]);
 var SEVERITIES2 = new Set(["suggestion", "warning", "error"]);
@@ -9840,7 +9720,7 @@ process.stdout.on("error", (error) => {
   throw error;
 });
 function usage() {
-  return `React-Luau Doctor ${VERSION}
+  return `React-Luau Doctor ${VERSION2}
 
 Usage:
   react-luau-doctor [directory] [options]
@@ -9849,9 +9729,6 @@ Usage:
   react-luau-doctor rules <command>
 
 Scan options:
-  --lint / --no-lint                    Enable or skip React-Luau analysis
-  --dead-code / --no-dead-code          React Doctor compatibility flag; no Luau dead-code pass yet
-  --supply-chain / --no-supply-chain    React Doctor compatibility flag; no Roblox supply-chain pass yet
   --verbose                              Show every finding and per-file details
   --debug                                Print resolved local scan details to stderr
   --output-dir <dir>                     Write report.json, diagnostics.json, and summary.json
@@ -9859,35 +9736,26 @@ Scan options:
   --json                                 Output one structured JSON report
   --json-compact                         Emit compact JSON instead of indented JSON
   --json-out <path>                      Write the JSON report to a file
-  -y, --yes                              Skip prompts; accepted for React Doctor CLI compatibility
-  --no-parallel                          Force serial scanning (the Luau analyzer is currently serial)
   --project <name>                       Select project directories, comma-separated
   --scope <value>                        full, files, changed, or lines
-  --full                                 Legacy alias for --scope full
   --base <ref>                           Git base ref for files/changed/lines scope
   --include-untracked                    Include untracked files in git scopes
   --diff [base]                          Alias for changed scope; false forces full scope
   --changed-files-from <file>            Read changed paths from a newline-delimited file
   --no-score                             Hide the local score
   --category <category>                  Only report a category; repeatable
-  --no-telemetry                         React Doctor-compatible alias for --no-score
-  --offline                              Legacy alias for --no-telemetry
   --staged                               Scan staged git-index content only
   --max-duration <seconds>               Stop after a shared scan time budget and report partial results
   --blocking <level>                     Exit gate: error, warning, or none
-  --fail-on <level>                      Legacy alias for --blocking
   --respect-inline-disables              Respect react-luau-doctor inline suppression comments
   --no-respect-inline-disables           Ignore inline suppressions for audit scans
   --warnings / --no-warnings             Show warnings (default) or errors only
   --annotations                          Emit GitHub Actions workflow annotations
-  --explain <file:line>                  Legacy inline form of the why command
-  --why <file:line>                      Alias for --explain
   --no-color                             Disable automatic ANSI colors
   --no-cache                             Disable the persistent OS-level analysis cache
 
 React-Luau Doctor options:
   --min-severity <level>                 suggestion, warning, or error
-  --rules                                List available rules
   -v, --version                          Print the version
   -h, --help                             Show this help
 
@@ -9898,17 +9766,15 @@ CI commands:
   Reporting toggles: --comment/--no-comment, --review-comments/--no-review-comments, --commit-status/--no-commit-status
 
 Rules commands:
-  rules list [--category <name>] [--tag <name>] [--framework <name>] [--configured] [--json]
+  rules list [--category <name>] [--configured] [--json]
   rules explain <rule> [--json]
   rules set <rule> <severity>
   rules enable <rule> [--severity <level>]
   rules disable <rule>
   rules category <category> <severity>
-  rules ignore-tag <tag>
-  rules unignore-tag <tag>
 
 Config:
-  react-luau-doctor.config.json or doctor.config.json
+  react-luau-doctor.config.json
 `;
 }
 function splitLongOption(arg) {
@@ -10309,17 +10175,12 @@ function parseArgs(argv) {
     scoreOnly: false,
     json: false,
     jsonCompact: false,
-    yes: false,
-    noParallel: false,
-    full: false,
     includeUntracked: false,
     categories: [],
-    noTelemetry: false,
     staged: false,
     annotations: false,
     noColor: false,
     noCache: false,
-    listRules: false,
     help: false,
     version: false
   };
@@ -10327,19 +10188,7 @@ function parseArgs(argv) {
   for (let index = 0;index < argv.length; index += 1) {
     const raw = argv[index];
     const { name: arg, inlineValue } = splitLongOption(raw);
-    if (arg === "--lint")
-      options.lint = true;
-    else if (arg === "--no-lint")
-      options.lint = false;
-    else if (arg === "--dead-code")
-      options.deadCode = true;
-    else if (arg === "--no-dead-code")
-      options.deadCode = false;
-    else if (arg === "--supply-chain")
-      options.supplyChain = true;
-    else if (arg === "--no-supply-chain")
-      options.supplyChain = false;
-    else if (arg === "--verbose")
+    if (arg === "--verbose")
       options.verbose = true;
     else if (arg === "--debug")
       options.debug = true;
@@ -10349,20 +10198,11 @@ function parseArgs(argv) {
       options.json = true;
     else if (arg === "--json-compact")
       options.jsonCompact = true;
-    else if (arg === "-y" || arg === "--yes")
-      options.yes = true;
-    else if (arg === "--no-parallel")
-      options.noParallel = true;
-    else if (arg === "--full")
-      options.full = true;
     else if (arg === "--include-untracked")
       options.includeUntracked = true;
     else if (arg === "--no-score")
       options.showScore = false;
-    else if (arg === "--no-telemetry" || arg === "--offline") {
-      options.noTelemetry = true;
-      options.showScore = false;
-    } else if (arg === "--staged")
+    else if (arg === "--staged")
       options.staged = true;
     else if (arg === "--no-respect-inline-disables")
       options.respectInlineDisables = false;
@@ -10378,8 +10218,6 @@ function parseArgs(argv) {
       options.noCache = true;
     else if (arg === "--annotations")
       options.annotations = true;
-    else if (arg === "--rules")
-      options.listRules = true;
     else if (arg === "--help" || arg === "-h")
       options.help = true;
     else if (arg === "--version" || arg === "-v")
@@ -10439,16 +10277,6 @@ function parseArgs(argv) {
       const parsed = requiredValue(argv, index, arg, inlineValue);
       options.blocking = parseBlocking2(parsed.value, arg);
       index = parsed.nextIndex;
-    } else if (arg === "--fail-on") {
-      const parsed = requiredValue(argv, index, arg, inlineValue);
-      options.failOn = parseBlocking2(parsed.value, arg);
-      index = parsed.nextIndex;
-    } else if (arg === "--explain" || arg === "--why") {
-      const parsed = requiredValue(argv, index, arg, inlineValue);
-      if (options.explain !== undefined)
-        throw new Error("Use --explain or --why once; they are aliases");
-      options.explain = parsed.value;
-      index = parsed.nextIndex;
     } else if (arg === "--min-severity") {
       const parsed = requiredValue(argv, index, arg, inlineValue);
       if (!SEVERITIES2.has(parsed.value))
@@ -10467,8 +10295,6 @@ function parseArgs(argv) {
   return options;
 }
 function resolveScope(options, config) {
-  if (options.full)
-    return { scope: "full", base: options.base ?? config.base };
   if (options.scope)
     return { scope: options.scope, base: options.base ?? config.base };
   if (options.diff !== undefined) {
@@ -10502,12 +10328,9 @@ function validateModeFlags(options, scope) {
   if (options.scoreOnly && options.json)
     throw new Error("Cannot combine --score and --json; pick one output mode");
   if (options.scoreOnly && options.showScore === false)
-    throw new Error("Cannot combine --score with --no-score, --no-telemetry, or --offline");
+    throw new Error("Cannot combine --score with --no-score");
   if (options.annotations && (options.json || options.scoreOnly))
     throw new Error("--annotations cannot be combined with --json or --score");
-  if (options.explain && (options.json || options.scoreOnly || options.annotations || options.staged)) {
-    throw new Error("--explain cannot be combined with --json, --score, --annotations, or --staged");
-  }
 }
 function findProjectByName(root, name) {
   const direct = path12.resolve(root, name);
@@ -10599,7 +10422,7 @@ function parseCommandCwd(argv) {
   return { cwd, remaining };
 }
 function ruleSeverityMap(config) {
-  return new Map(rules.map((rule) => [rule.id, effectiveSeverity(rule.severity, rule.id, config, ruleTags(rule)) ?? "off"]));
+  return new Map(rules.map((rule) => [rule.id, effectiveSeverity(rule.severity, rule.id, config) ?? "off"]));
 }
 function runRulesCommand(argv) {
   const noColor = argv.includes("--no-color");
@@ -10610,8 +10433,6 @@ function runRulesCommand(argv) {
   const config = loaded.config;
   if (action === "list") {
     let category = null;
-    let tag = null;
-    let framework = null;
     let configured = false;
     let json = false;
     for (let index = 0;index < remaining.length; index += 1) {
@@ -10627,14 +10448,6 @@ function runRulesCommand(argv) {
         category = normalizeCategory(value);
         if (!category)
           throw new Error(`Unknown category: ${value}`);
-      } else if (arg === "--tag") {
-        tag = remaining[++index]?.toLowerCase() ?? null;
-        if (!tag)
-          throw new Error("rules list --tag requires a name");
-      } else if (arg === "--framework") {
-        framework = remaining[++index]?.toLowerCase() ?? null;
-        if (!framework)
-          throw new Error("rules list --framework requires a name");
       } else
         throw new Error(`Unknown rules list option: ${arg}`);
     }
@@ -10642,13 +10455,8 @@ function runRulesCommand(argv) {
     const filtered = rules.filter((rule) => {
       if (category && rule.category !== category)
         return false;
-      if (tag && !ruleTags(rule).includes(tag))
+      if (configured && config.rules?.[rule.id] === undefined)
         return false;
-      if (framework && !ruleFrameworks(rule).includes(framework))
-        return false;
-      if (configured && config.rules?.[rule.id] === undefined && !(config.ignoredTags ?? []).some((ignored) => ruleTags(rule).includes(ignored.toLowerCase()))) {
-        return false;
-      }
       return true;
     });
     if (json) {
@@ -10657,8 +10465,6 @@ function runRulesCommand(argv) {
         severity: severityMap.get(rule.id),
         defaultSeverity: rule.severity,
         category: rule.category,
-        tags: ruleTags(rule),
-        frameworks: ruleFrameworks(rule),
         description: rule.description
       })), null, 2)}
 `);
@@ -10676,14 +10482,12 @@ function runRulesCommand(argv) {
     if (extra.length > 0)
       throw new Error(`Unknown rules explain option: ${extra[0]}`);
     const rule = findRule(requested);
-    const currentSeverity = effectiveSeverity(rule.severity, rule.id, config, ruleTags(rule)) ?? "off";
+    const currentSeverity = effectiveSeverity(rule.severity, rule.id, config) ?? "off";
     const result = {
       id: rule.id,
       severity: currentSeverity,
       defaultSeverity: rule.severity,
       category: rule.category,
-      tags: ruleTags(rule),
-      frameworks: ruleFrameworks(rule),
       description: rule.description,
       example: fixExampleForRule(rule.id)
     };
@@ -10773,22 +10577,6 @@ function runRulesCommand(argv) {
       ])
     }));
     process.stdout.write(`Set ${categoryRules.length} ${category} rules to ${severity} in ${path12.relative(cwd, filename)}
-`);
-    return;
-  }
-  if (action === "ignore-tag" || action === "unignore-tag") {
-    const tag = remaining[0]?.toLowerCase();
-    if (!tag)
-      throw new Error(`rules ${action} requires a tag`);
-    const filename = writeConfig(cwd, (current) => {
-      const tags = new Set((current.ignoredTags ?? []).map((entry) => entry.toLowerCase()));
-      if (action === "ignore-tag")
-        tags.add(tag);
-      else
-        tags.delete(tag);
-      return { ...current, ignoredTags: [...tags].sort() };
-    });
-    process.stdout.write(`${action === "ignore-tag" ? "Ignored" : "Unignored"} tag ${tag} in ${path12.relative(cwd, filename)}
 `);
     return;
   }
@@ -11030,7 +10818,7 @@ function pathIsInside(parent, child2) {
   const relative = path12.relative(parent, child2);
   return relative === "" || !relative.startsWith("..") && !path12.isAbsolute(relative);
 }
-async function runScan(options, onProgress, beforeOutput) {
+async function runScan(options, onProgress) {
   const commandRoot = process.cwd();
   const target = path12.resolve(commandRoot, options.target);
   if (!fs10.existsSync(target))
@@ -11042,21 +10830,6 @@ async function runScan(options, onProgress, beforeOutput) {
   const resolvedScope = resolveScope(options, config);
   const scope = options.staged && options.scope === undefined ? "files" : resolvedScope.scope;
   validateModeFlags(options, scope);
-  if (options.explain) {
-    await runWhy(options.explain, commandRoot, options.noColor, !options.noCache, onProgress, beforeOutput);
-    return {
-      schemaVersion: 1,
-      root: commandRoot,
-      scannedFiles: 0,
-      candidateFiles: 0,
-      durationMs: 0,
-      score: 100,
-      counts: { error: 0, warning: 0, suggestion: 0 },
-      diagnostics: [],
-      partial: false,
-      skippedFiles: []
-    };
-  }
   if (targetStat.isFile() && (scope !== "full" || options.staged || options.changedFilesFrom)) {
     throw new Error("Git scopes require a directory target; scan the containing project directory instead");
   }
@@ -11078,13 +10851,6 @@ async function runScan(options, onProgress, beforeOutput) {
   const categories = options.categories.length > 0 ? options.categories : config.categories;
   const respectInlineDisables = options.respectInlineDisables ?? config.respectInlineDisables ?? true;
   const deadlineAt = options.maxDurationSeconds !== undefined ? performance.now() + options.maxDurationSeconds * 1000 : undefined;
-  const notes = [];
-  if (options.deadCode === true)
-    notes.push("--dead-code is accepted for React Doctor CLI compatibility, but this port does not yet include a Luau dead-code pass.");
-  if (options.supplyChain === true)
-    notes.push("--supply-chain is accepted for React Doctor CLI compatibility, but this port does not run Socket.dev or Roblox dependency health checks.");
-  if (options.lint === false)
-    notes.push("React-Luau analysis was disabled by --no-lint.");
   const reports = [];
   for (const { projectRoot, targetRoot } of projectTargets) {
     let report2;
@@ -11094,15 +10860,7 @@ async function runScan(options, onProgress, beforeOutput) {
       phase: [projectName, progress.phase].filter(Boolean).join(":") || undefined,
       label: projectName && progress.label ? `${projectName}: ${progress.label}` : progress.label
     }) : undefined;
-    if (options.lint === false) {
-      report2 = await scanPath(targetRoot, {
-        projectRoot,
-        files: [],
-        config,
-        cache: !options.noCache
-      });
-      report2.scope = options.staged ? "staged" : scope;
-    } else if (targetStat.isFile()) {
+    if (targetStat.isFile()) {
       report2 = await scanPath(targetRoot, {
         projectRoot,
         config,
@@ -11131,21 +10889,19 @@ async function runScan(options, onProgress, beforeOutput) {
         cache: !options.noCache
       });
     }
-    if (notes.length > 0)
-      report2.notes = [...report2.notes ?? [], ...notes];
     reports.push({ projectRoot, report: report2 });
   }
   const report = aggregateReports(displayRoot, reports);
   if (options.debug) {
     const debugLines = [
-      `[debug] version=${VERSION}`,
+      `[debug] version=${VERSION2}`,
       `[debug] bun=${Bun.version} platform=${process.platform}/${process.arch}`,
       `[debug] target=${target}`,
       `[debug] config=${loaded.filename ?? "none"}`,
       `[debug] scope=${report.scope ?? scope} base=${report.base ?? resolvedScope.base ?? "auto"}`,
       `[debug] projects=${projectTargets.map(({ projectRoot }) => path12.relative(displayRoot, projectRoot) || ".").join(",")}`,
       `[debug] candidates=${report.candidateFiles ?? 0} scanned=${report.scannedFiles} partial=${Boolean(report.partial)}`,
-      `[debug] parallel=false${options.noParallel ? " (--no-parallel requested)" : ""}`
+      `[debug] parallel=false`
     ];
     process.stderr.write(`${debugLines.join(`
 `)}
@@ -11187,7 +10943,7 @@ async function main() {
       return;
     }
     if (argv[0] === "version") {
-      process.stdout.write(`React-Luau Doctor ${VERSION}
+      process.stdout.write(`React-Luau Doctor ${VERSION2}
 Bun ${Bun.version}
 ${process.platform} ${process.arch}
 ${os2.release()}
@@ -11200,12 +10956,7 @@ ${os2.release()}
       return;
     }
     if (options.version) {
-      process.stdout.write(`${VERSION}
-`);
-      return;
-    }
-    if (options.listRules) {
-      process.stdout.write(`${renderRulesList(rules, process.stdout.columns ?? 120, new Map, shouldUseColor(options.noColor))}
+      process.stdout.write(`${VERSION2}
 `);
       return;
     }
@@ -11217,12 +10968,10 @@ ${os2.release()}
     });
     let report;
     try {
-      report = await runScan(options, (scanProgress) => progress.update(scanProgress), () => progress.clear());
+      report = await runScan(options, (scanProgress) => progress.update(scanProgress));
     } finally {
       progress.clear();
     }
-    if (options.explain)
-      return;
     const compactJson = options.jsonCompact;
     const json = `${serializeReport(report, compactJson)}
 `;
@@ -11249,7 +10998,7 @@ ${os2.release()}
     } else
       process.stdout.write(`${renderTextReport(report, showScore, colorized, verbose, process.stdout.columns ?? 120)}
 `);
-    const blocking = options.blocking ?? options.failOn ?? config.blocking ?? config.failOn ?? "error";
+    const blocking = options.blocking ?? config.blocking ?? "error";
     if (shouldBlock2(report, blocking))
       process.exitCode = 1;
   } catch (error) {
@@ -11261,5 +11010,5 @@ ${os2.release()}
 }
 main();
 
-//# debugId=DD15F49C505776FC64756E2164756E21
+//# debugId=269B394ED6CE708464756E2164756E21
 //# sourceMappingURL=cli.js.map