bun-doctor 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kyle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+# Bun Doctor
+
+Diagnose Node-to-Bun migration readiness for JavaScript and TypeScript projects.
+
+`bun-doctor` answers one question:
+
+> Can this repo safely move to Bun, and what exact changes get it there?
+
+It scans package manager state, lockfiles, Bun config, TypeScript config, CI workflows, dependency risk, and a first pass of Bun-specific code risks. The output is a 0-100 Bun Readiness score grouped into Blockers, Risks, Migration work, and Bun wins.
+
+## Usage
+
+```bash
+npx -y bun-doctor@latest .
+```
+
+Local development from this repo:
+
+```bash
+bun install
+bun run build
+node dist/cli.mjs . --verbose
+```
+
+## CLI
+
+```txt
+Usage: bun-doctor [directory] [options]
+
+Options:
+  --json                  output a structured JSON report
+  --score                 output only the numeric score
+  --verbose               show every diagnostic
+  --no-package            skip package/config/dependency checks
+  --no-code               skip source code checks
+  --fail-on <level>       exit non-zero on blocker, risk, migration, or none
+  -v, --version           print version
+  -h, --help              print help
+
+Commands:
+  bun-doctor install      install the bun-doctor agent skill
+```
+
+## Scoring
+
+The score starts at 100 and subtracts for unique triggered rules:
+
+- Blocker: 12 points
+- Risk: 5 points
+- Migration work: 2 points
+- Bun win: 0 points
+
+Bun wins are shown as opportunities but do not lower readiness.
+
+## Rule Sources
+
+Every diagnostic has at least one verifiable source: Bun docs, compatibility docs, or an issue/test link in the compatibility database. No source means no rule.
+
+## Roadmap
+
+- MVP: CLI, JSON, score, config/package rules, code-risk scans, compatibility DB v0.
+- v1.0: public eval harness that verifies compatibility DB entries across Bun versions and platforms.
+- Later: editor/linter plugin once rules prove useful in real migrations.

package/action.yml

@@ -0,0 +1,52 @@
+name: "Bun Doctor"
+description: "Scan JavaScript and TypeScript projects for Bun migration readiness"
+branding:
+  icon: "activity"
+  color: "orange"
+
+inputs:
+  directory:
+    description: "Project directory to scan"
+    default: "."
+  verbose:
+    description: "Show all diagnostics"
+    default: "true"
+  fail-on:
+    description: "Exit with error code on diagnostics: blocker, risk, migration, none"
+    default: "blocker"
+  node-version:
+    description: "Node.js version to use for running bun-doctor"
+    default: "22"
+
+outputs:
+  score:
+    description: "Bun Readiness score (0-100)"
+    value: ${{ steps.score.outputs.score }}
+
+runs:
+  using: "composite"
+  steps:
+    - uses: actions/setup-node@v4
+      with:
+        node-version: ${{ inputs.node-version }}
+
+    - shell: bash
+      env:
+        INPUT_DIRECTORY: ${{ inputs.directory }}
+        INPUT_VERBOSE: ${{ inputs.verbose }}
+        INPUT_FAIL_ON: ${{ inputs.fail-on }}
+      run: |
+        FLAGS=("--fail-on" "$INPUT_FAIL_ON")
+        if [ "$INPUT_VERBOSE" = "true" ]; then FLAGS+=("--verbose"); fi
+        npx -y bun-doctor@latest "$INPUT_DIRECTORY" "${FLAGS[@]}"
+
+    - id: score
+      if: always()
+      shell: bash
+      env:
+        INPUT_DIRECTORY: ${{ inputs.directory }}
+      run: |
+        SCORE=$(npx -y bun-doctor@latest "$INPUT_DIRECTORY" --score --fail-on none 2>/dev/null | tail -1 | tr -d '[:space:]') || true
+        if [[ -n "$SCORE" && "$SCORE" =~ ^[0-9]+$ ]]; then
+          echo "score=$SCORE" >> "$GITHUB_OUTPUT"
+        fi

package/bin/bun-doctor.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/cli.mjs";

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+import { a as VERSION, i as toRelativePath, t as scan } from "./scan-BVcJTreL.mjs";
+import { parseArgs } from "node:util";
+import path from "node:path";
+import fs from "node:fs";
+//#region src/install-skill.ts
+const SKILL_CONTENT = `---
+name: bun-doctor
+description: Use after making dependency, CI, package manager, test runner, or Node runtime changes in a project that uses or is migrating to Bun. Checks Bun readiness and migration risk.
+version: "1.0.0"
+---
+
+# Bun Doctor
+
+Run \`npx -y bun-doctor@latest . --verbose\` after Bun migration changes and fix blockers before switching CI or runtime.
+`;
+const installSkill = (options) => {
+	const skillDirectory = path.join(options.directory, ".agents", "skills", "bun-doctor");
+	const skillPath = path.join(skillDirectory, "SKILL.md");
+	if (options.dryRun) return skillPath;
+	fs.mkdirSync(skillDirectory, { recursive: true });
+	fs.writeFileSync(skillPath, SKILL_CONTENT, "utf8");
+	return skillPath;
+};
+//#endregion
+//#region src/report.ts
+const CATEGORY_ORDER = [
+	"Blockers",
+	"Risks",
+	"Migration work",
+	"Bun wins"
+];
+const LEVEL_SYMBOL = {
+	blocker: "x",
+	risk: "!",
+	migration: "~",
+	win: "+"
+};
+const groupByCategory = (diagnostics) => {
+	const groups = /* @__PURE__ */ new Map();
+	for (const diagnostic of diagnostics) {
+		const existing = groups.get(diagnostic.category) ?? [];
+		existing.push(diagnostic);
+		groups.set(diagnostic.category, existing);
+	}
+	return groups;
+};
+const formatLocation = (diagnostic, rootDirectory) => {
+	const relativePath = toRelativePath(path.resolve(diagnostic.filePath), rootDirectory);
+	return diagnostic.line > 0 ? `${relativePath}:${diagnostic.line}` : relativePath;
+};
+const formatTextReport = (result, verbose) => {
+	const lines = [];
+	lines.push(`bun-doctor`);
+	lines.push(`Project: ${result.project.packageName}`);
+	lines.push(`Bun Readiness: ${result.score.score}/100 (${result.score.label})`);
+	lines.push(`Findings: ${result.summary.blockers} blockers, ${result.summary.risks} risks, ${result.summary.migrations} migration, ${result.summary.wins} wins`);
+	lines.push("");
+	if (result.diagnostics.length === 0) {
+		lines.push("No Bun migration findings.");
+		return lines.join("\n");
+	}
+	const groups = groupByCategory(result.diagnostics);
+	for (const category of CATEGORY_ORDER) {
+		const diagnostics = groups.get(category) ?? [];
+		if (diagnostics.length === 0) continue;
+		lines.push(`${category} (${diagnostics.length})`);
+		const shownDiagnostics = verbose ? diagnostics : diagnostics.slice(0, 3);
+		for (const diagnostic of shownDiagnostics) {
+			lines.push(`  ${LEVEL_SYMBOL[diagnostic.level]} ${diagnostic.title} [${diagnostic.ruleId}]`);
+			lines.push(`    ${diagnostic.message}`);
+			if (diagnostic.help) lines.push(`    ${diagnostic.help}`);
+			lines.push(`    ${formatLocation(diagnostic, result.project.rootDirectory)}`);
+			lines.push(`    Source: ${diagnostic.sources[0]}`);
+		}
+		if (!verbose && diagnostics.length > shownDiagnostics.length) lines.push(`  ... ${diagnostics.length - shownDiagnostics.length} more. Re-run with --verbose.`);
+		lines.push("");
+	}
+	return lines.join("\n").trimEnd();
+};
+const toJsonReport = (result) => ({
+	schemaVersion: 1,
+	ok: true,
+	score: result.score,
+	summary: result.summary,
+	project: {
+		name: result.project.packageName,
+		rootDirectory: result.project.rootDirectory,
+		packageJsonPath: result.project.packageJsonPath,
+		lockfiles: result.project.lockfiles,
+		legacyLockfiles: result.project.legacyLockfiles
+	},
+	diagnostics: result.diagnostics
+});
+//#endregion
+//#region src/cli.ts
+const VALID_FAIL_ON_LEVELS = new Set([
+	"blocker",
+	"risk",
+	"migration",
+	"win",
+	"none"
+]);
+const HELP_TEXT = `Usage: bun-doctor [directory] [options]
+
+Options:
+  --json                  output a structured JSON report
+  --score                 output only the numeric score
+  --verbose               show every diagnostic
+  --no-package            skip package/config/dependency checks
+  --no-code               skip source code checks
+  --fail-on <level>       exit non-zero on blocker, risk, migration, or none
+  -v, --version           print version
+  -h, --help              print help
+
+Commands:
+  bun-doctor install [directory] [--dry-run]
+`;
+const shouldFail = (levels, failOn) => {
+	if (failOn === "none") return false;
+	if (failOn === "win") return levels.size > 0;
+	if (failOn === "migration") return levels.has("blocker") || levels.has("risk") || levels.has("migration");
+	if (failOn === "risk") return levels.has("blocker") || levels.has("risk");
+	return levels.has("blocker");
+};
+const parseFailOn = (value) => {
+	if (!value) return "blocker";
+	if (VALID_FAIL_ON_LEVELS.has(value)) return value;
+	throw new Error(`Invalid --fail-on value: ${value}. Expected blocker, risk, migration, win, or none.`);
+};
+const parseCli = (argv) => {
+	const parsed = parseArgs({
+		args: argv,
+		allowPositionals: true,
+		options: {
+			json: {
+				type: "boolean",
+				default: false
+			},
+			score: {
+				type: "boolean",
+				default: false
+			},
+			verbose: {
+				type: "boolean",
+				default: false
+			},
+			"no-package": {
+				type: "boolean",
+				default: false
+			},
+			"no-code": {
+				type: "boolean",
+				default: false
+			},
+			"fail-on": {
+				type: "string",
+				default: "blocker"
+			},
+			version: {
+				type: "boolean",
+				short: "v",
+				default: false
+			},
+			help: {
+				type: "boolean",
+				short: "h",
+				default: false
+			}
+		}
+	});
+	if (parsed.values.help) {
+		process.stdout.write(`${HELP_TEXT}\n`);
+		process.exit(0);
+	}
+	if (parsed.values.version) {
+		process.stdout.write(`${VERSION}\n`);
+		process.exit(0);
+	}
+	return {
+		directory: path.resolve(parsed.positionals[0] ?? "."),
+		flags: {
+			json: Boolean(parsed.values.json),
+			score: Boolean(parsed.values.score),
+			verbose: Boolean(parsed.values.verbose),
+			packageChecks: !parsed.values["no-package"],
+			codeChecks: !parsed.values["no-code"],
+			failOn: parseFailOn(parsed.values["fail-on"])
+		}
+	};
+};
+const runInstallCommand = (argv) => {
+	const parsed = parseArgs({
+		args: argv,
+		allowPositionals: true,
+		options: {
+			"dry-run": {
+				type: "boolean",
+				default: false
+			},
+			help: {
+				type: "boolean",
+				short: "h",
+				default: false
+			}
+		}
+	});
+	if (parsed.values.help) {
+		process.stdout.write("Usage: bun-doctor install [directory] [--dry-run]\n");
+		return;
+	}
+	const skillPath = installSkill({
+		directory: path.resolve(parsed.positionals[0] ?? "."),
+		dryRun: Boolean(parsed.values["dry-run"])
+	});
+	const action = parsed.values["dry-run"] ? "Would install" : "Installed";
+	process.stdout.write(`${action} bun-doctor skill at ${skillPath}\n`);
+};
+const main = async () => {
+	const argv = process.argv.slice(2);
+	if (argv[0] === "install") {
+		runInstallCommand(argv.slice(1));
+		return;
+	}
+	const { directory, flags } = parseCli(argv);
+	const result = await scan(directory, {
+		packageChecks: flags.packageChecks,
+		codeChecks: flags.codeChecks
+	});
+	if (flags.score) process.stdout.write(`${result.score.score}\n`);
+	else if (flags.json) process.stdout.write(`${JSON.stringify(toJsonReport(result), null, 2)}\n`);
+	else process.stdout.write(`${formatTextReport(result, flags.verbose)}\n`);
+	if (shouldFail(new Set(result.diagnostics.map((diagnostic) => diagnostic.level)), flags.failOn)) process.exitCode = 1;
+};
+main().catch((error) => {
+	const message = error instanceof Error ? error.message : String(error);
+	process.stderr.write(`bun-doctor: ${message}\n`);
+	process.exitCode = 1;
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/install-skill.ts","../src/report.ts","../src/cli.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\ninterface InstallSkillOptions {\n  directory: string;\n  dryRun?: boolean;\n}\n\nconst SKILL_CONTENT = `---\nname: bun-doctor\ndescription: Use after making dependency, CI, package manager, test runner, or Node runtime changes in a project that uses or is migrating to Bun. Checks Bun readiness and migration risk.\nversion: \"1.0.0\"\n---\n\n# Bun Doctor\n\nRun \\`npx -y bun-doctor@latest . --verbose\\` after Bun migration changes and fix blockers before switching CI or runtime.\n`;\n\nexport const installSkill = (options: InstallSkillOptions): string => {\n  const skillDirectory = path.join(options.directory, \".agents\", \"skills\", \"bun-doctor\");\n  const skillPath = path.join(skillDirectory, \"SKILL.md\");\n\n  if (options.dryRun) return skillPath;\n\n  fs.mkdirSync(skillDirectory, { recursive: true });\n  fs.writeFileSync(skillPath, SKILL_CONTENT, \"utf8\");\n  return skillPath;\n};\n","import path from \"node:path\";\nimport type { Diagnostic, FindingCategory, ScanResult } from \"./types.js\";\nimport { toRelativePath } from \"./utils.js\";\n\nconst CATEGORY_ORDER: FindingCategory[] = [\"Blockers\", \"Risks\", \"Migration work\", \"Bun wins\"];\n\nconst LEVEL_SYMBOL: Record<Diagnostic[\"level\"], string> = {\n  blocker: \"x\",\n  risk: \"!\",\n  migration: \"~\",\n  win: \"+\",\n};\n\nconst groupByCategory = (diagnostics: Diagnostic[]): Map<FindingCategory, Diagnostic[]> => {\n  const groups = new Map<FindingCategory, Diagnostic[]>();\n  for (const diagnostic of diagnostics) {\n    const existing = groups.get(diagnostic.category) ?? [];\n    existing.push(diagnostic);\n    groups.set(diagnostic.category, existing);\n  }\n  return groups;\n};\n\nconst formatLocation = (diagnostic: Diagnostic, rootDirectory: string): string => {\n  const relativePath = toRelativePath(path.resolve(diagnostic.filePath), rootDirectory);\n  return diagnostic.line > 0 ? `${relativePath}:${diagnostic.line}` : relativePath;\n};\n\nexport const formatTextReport = (result: ScanResult, verbose: boolean): string => {\n  const lines: string[] = [];\n  lines.push(`bun-doctor`);\n  lines.push(`Project: ${result.project.packageName}`);\n  lines.push(`Bun Readiness: ${result.score.score}/100 (${result.score.label})`);\n  lines.push(\n    `Findings: ${result.summary.blockers} blockers, ${result.summary.risks} risks, ${result.summary.migrations} migration, ${result.summary.wins} wins`,\n  );\n  lines.push(\"\");\n\n  if (result.diagnostics.length === 0) {\n    lines.push(\"No Bun migration findings.\");\n    return lines.join(\"\\n\");\n  }\n\n  const groups = groupByCategory(result.diagnostics);\n  for (const category of CATEGORY_ORDER) {\n    const diagnostics = groups.get(category) ?? [];\n    if (diagnostics.length === 0) continue;\n    lines.push(`${category} (${diagnostics.length})`);\n    const shownDiagnostics = verbose ? diagnostics : diagnostics.slice(0, 3);\n    for (const diagnostic of shownDiagnostics) {\n      lines.push(`  ${LEVEL_SYMBOL[diagnostic.level]} ${diagnostic.title} [${diagnostic.ruleId}]`);\n      lines.push(`    ${diagnostic.message}`);\n      if (diagnostic.help) lines.push(`    ${diagnostic.help}`);\n      lines.push(`    ${formatLocation(diagnostic, result.project.rootDirectory)}`);\n      lines.push(`    Source: ${diagnostic.sources[0]}`);\n    }\n    if (!verbose && diagnostics.length > shownDiagnostics.length) {\n      lines.push(`  ... ${diagnostics.length - shownDiagnostics.length} more. Re-run with --verbose.`);\n    }\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\").trimEnd();\n};\n\nexport const toJsonReport = (result: ScanResult): object => ({\n  schemaVersion: 1,\n  ok: true,\n  score: result.score,\n  summary: result.summary,\n  project: {\n    name: result.project.packageName,\n    rootDirectory: result.project.rootDirectory,\n    packageJsonPath: result.project.packageJsonPath,\n    lockfiles: result.project.lockfiles,\n    legacyLockfiles: result.project.legacyLockfiles,\n  },\n  diagnostics: result.diagnostics,\n});\n","#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport path from \"node:path\";\nimport { VERSION } from \"./constants.js\";\nimport { installSkill } from \"./install-skill.js\";\nimport { formatTextReport, toJsonReport } from \"./report.js\";\nimport { scan } from \"./scan.js\";\nimport type { FailOnLevel, ScanOptions } from \"./types.js\";\n\ninterface CliFlags {\n  json: boolean;\n  score: boolean;\n  verbose: boolean;\n  packageChecks: boolean;\n  codeChecks: boolean;\n  failOn: FailOnLevel;\n}\n\nconst VALID_FAIL_ON_LEVELS = new Set<FailOnLevel>([\"blocker\", \"risk\", \"migration\", \"win\", \"none\"]);\n\nconst HELP_TEXT = `Usage: bun-doctor [directory] [options]\n\nOptions:\n  --json                  output a structured JSON report\n  --score                 output only the numeric score\n  --verbose               show every diagnostic\n  --no-package            skip package/config/dependency checks\n  --no-code               skip source code checks\n  --fail-on <level>       exit non-zero on blocker, risk, migration, or none\n  -v, --version           print version\n  -h, --help              print help\n\nCommands:\n  bun-doctor install [directory] [--dry-run]\n`;\n\nconst shouldFail = (levels: Set<string>, failOn: FailOnLevel): boolean => {\n  if (failOn === \"none\") return false;\n  if (failOn === \"win\") return levels.size > 0;\n  if (failOn === \"migration\") return levels.has(\"blocker\") || levels.has(\"risk\") || levels.has(\"migration\");\n  if (failOn === \"risk\") return levels.has(\"blocker\") || levels.has(\"risk\");\n  return levels.has(\"blocker\");\n};\n\nconst parseFailOn = (value: string | undefined): FailOnLevel => {\n  if (!value) return \"blocker\";\n  if (VALID_FAIL_ON_LEVELS.has(value as FailOnLevel)) return value as FailOnLevel;\n  throw new Error(`Invalid --fail-on value: ${value}. Expected blocker, risk, migration, win, or none.`);\n};\n\nconst parseCli = (argv: string[]): { directory: string; flags: CliFlags } => {\n  const parsed = parseArgs({\n    args: argv,\n    allowPositionals: true,\n    options: {\n      json: { type: \"boolean\", default: false },\n      score: { type: \"boolean\", default: false },\n      verbose: { type: \"boolean\", default: false },\n      \"no-package\": { type: \"boolean\", default: false },\n      \"no-code\": { type: \"boolean\", default: false },\n      \"fail-on\": { type: \"string\", default: \"blocker\" },\n      version: { type: \"boolean\", short: \"v\", default: false },\n      help: { type: \"boolean\", short: \"h\", default: false },\n    },\n  });\n\n  if (parsed.values.help) {\n    process.stdout.write(`${HELP_TEXT}\\n`);\n    process.exit(0);\n  }\n\n  if (parsed.values.version) {\n    process.stdout.write(`${VERSION}\\n`);\n    process.exit(0);\n  }\n\n  return {\n    directory: path.resolve(parsed.positionals[0] ?? \".\"),\n    flags: {\n      json: Boolean(parsed.values.json),\n      score: Boolean(parsed.values.score),\n      verbose: Boolean(parsed.values.verbose),\n      packageChecks: !parsed.values[\"no-package\"],\n      codeChecks: !parsed.values[\"no-code\"],\n      failOn: parseFailOn(parsed.values[\"fail-on\"]),\n    },\n  };\n};\n\nconst runInstallCommand = (argv: string[]): void => {\n  const parsed = parseArgs({\n    args: argv,\n    allowPositionals: true,\n    options: {\n      \"dry-run\": { type: \"boolean\", default: false },\n      help: { type: \"boolean\", short: \"h\", default: false },\n    },\n  });\n\n  if (parsed.values.help) {\n    process.stdout.write(\"Usage: bun-doctor install [directory] [--dry-run]\\n\");\n    return;\n  }\n\n  const directory = path.resolve(parsed.positionals[0] ?? \".\");\n  const skillPath = installSkill({ directory, dryRun: Boolean(parsed.values[\"dry-run\"]) });\n  const action = parsed.values[\"dry-run\"] ? \"Would install\" : \"Installed\";\n  process.stdout.write(`${action} bun-doctor skill at ${skillPath}\\n`);\n};\n\nconst main = async (): Promise<void> => {\n  const argv = process.argv.slice(2);\n  if (argv[0] === \"install\") {\n    runInstallCommand(argv.slice(1));\n    return;\n  }\n\n  const { directory, flags } = parseCli(argv);\n  const options: ScanOptions = {\n    packageChecks: flags.packageChecks,\n    codeChecks: flags.codeChecks,\n  };\n  const result = await scan(directory, options);\n\n  if (flags.score) {\n    process.stdout.write(`${result.score.score}\\n`);\n  } else if (flags.json) {\n    process.stdout.write(`${JSON.stringify(toJsonReport(result), null, 2)}\\n`);\n  } else {\n    process.stdout.write(`${formatTextReport(result, flags.verbose)}\\n`);\n  }\n\n  const levels = new Set(result.diagnostics.map((diagnostic) => diagnostic.level));\n  if (shouldFail(levels, flags.failOn)) {\n    process.exitCode = 1;\n  }\n};\n\nmain().catch((error: unknown) => {\n  const message = error instanceof Error ? error.message : String(error);\n  process.stderr.write(`bun-doctor: ${message}\\n`);\n  process.exitCode = 1;\n});\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,129 @@
+//#region src/types.d.ts
+type FindingLevel = "blocker" | "risk" | "migration" | "win";
+type FindingCategory = "Blockers" | "Risks" | "Migration work" | "Bun wins";
+type FailOnLevel = FindingLevel | "none";
+interface PackageJson {
+  name?: string;
+  version?: string;
+  packageManager?: string;
+  scripts?: Record<string, string>;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+  optionalDependencies?: Record<string, string>;
+  trustedDependencies?: string[];
+  workspaces?: string[] | {
+    packages?: string[];
+    catalog?: unknown;
+    catalogs?: unknown;
+  };
+  catalog?: unknown;
+  catalogs?: unknown;
+  bunDoctor?: BunDoctorConfig;
+}
+interface BunDoctorConfig {
+  ignore?: {
+    rules?: string[];
+    files?: string[];
+  };
+  package?: boolean;
+  code?: boolean;
+}
+interface CompatEntry {
+  packageName: string;
+  severity: FindingLevel;
+  affectedRanges: string[];
+  bunVersions: string[];
+  platforms: Array<"darwin" | "linux" | "win32" | "all">;
+  confidence: "high" | "medium" | "low";
+  reason: string;
+  sources: string[];
+  lastVerified: string;
+  replacement?: string;
+  workaround?: string;
+  migrationHint?: string;
+  requiresTrustedDependency?: boolean;
+}
+interface SourceFile {
+  filePath: string;
+  content: string;
+}
+interface WorkflowFile {
+  filePath: string;
+  content: string;
+}
+interface BunfigInfo {
+  filePath: string;
+  content: string;
+  installIgnoreScripts?: boolean;
+  installFrozenLockfile?: boolean;
+  installAuto?: string;
+  installSecurityScanner?: string;
+}
+interface ProjectInfo {
+  rootDirectory: string;
+  packageJsonPath: string;
+  packageJson: PackageJson;
+  packageName: string;
+  dependencies: Record<string, string>;
+  trustedDependencies: Set<string>;
+  packageManifests: PackageManifest[];
+  lockfiles: string[];
+  legacyLockfiles: string[];
+  bunfig: BunfigInfo | null;
+  tsconfigPath: string | null;
+  tsconfig: Record<string, unknown> | null;
+  workflows: WorkflowFile[];
+  sourceFiles: SourceFile[];
+  pnpmWorkspacePath: string | null;
+}
+interface PackageManifest {
+  packageJsonPath: string;
+  packageJson: PackageJson;
+  packageName: string;
+  dependencies: Record<string, string>;
+  trustedDependencies: Set<string>;
+}
+interface Diagnostic {
+  ruleId: string;
+  title: string;
+  level: FindingLevel;
+  category: FindingCategory;
+  message: string;
+  filePath: string;
+  line: number;
+  sources: string[];
+  help?: string;
+  packageName?: string;
+}
+interface ScoreResult {
+  score: number;
+  label: "Ready" | "Close" | "Risky" | "Blocked";
+}
+interface ScanSummary {
+  blockers: number;
+  risks: number;
+  migrations: number;
+  wins: number;
+}
+interface ScanOptions {
+  packageChecks?: boolean;
+  codeChecks?: boolean;
+  configOverride?: BunDoctorConfig | null;
+}
+interface ScanResult {
+  project: ProjectInfo;
+  diagnostics: Diagnostic[];
+  score: ScoreResult;
+  summary: ScanSummary;
+}
+//#endregion
+//#region src/scan.d.ts
+declare const scan: (directory: string, options?: ScanOptions) => Promise<ScanResult>;
+//#endregion
+//#region src/score.d.ts
+declare const calculateScore: (diagnostics: Diagnostic[]) => ScoreResult;
+declare const summarizeDiagnostics: (diagnostics: Diagnostic[]) => ScanSummary;
+//#endregion
+export { type BunDoctorConfig, type CompatEntry, type Diagnostic, type FailOnLevel, type FindingCategory, type FindingLevel, type ScanOptions, type ScanResult, calculateScore, scan, summarizeDiagnostics };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { n as calculateScore, r as summarizeDiagnostics, t as scan } from "./scan-BVcJTreL.mjs";
+export { calculateScore, scan, summarizeDiagnostics };