wagenet · February 27, 2026 17:41
diff --git a/fix-oxlint-config.js b/fix-oxlint-config.js
 #!/usr/bin/env node
 /**
 * Rewrites a migration-tool-generated oxlint.config.ts:
 * - Fixes indentation
 * - Adds globals import + CJS override (if CJS files present)
 * - Removes JSON-file overrides (tsconfig*.json)
 * - Removes @auditboard/eslint-plugin from jsPlugins
 * - Adds no-unsafe-assignment disable comment
 */

 const fs = require('fs');
 const path = process.argv[2] || 'oxlint.config.ts';
 const hasCjs = process.argv[3] === 'true';
 const content = fs.readFileSync(path, 'utf8');

 // Extract ignorePatterns
 const ignoreMatch = content.match(/ignorePatterns:\s*\[([^\]]*)\]/);
 let ignorePatterns = ['build'];
 if (ignoreMatch) {
 	const items = ignoreMatch[1].match(/["']([^"']+)["']/g);
 	if (items) ignorePatterns = items.map((s) => s.replace(/["']/g, ''));
 }

 // Extract overrides using bracket counting
 function extractArray(str, startKeyword) {
 	const idx = str.indexOf(startKeyword);
 	if (idx === -1) return null;

 	// Find the opening bracket
 	let bracketStart = str.indexOf('[', idx + startKeyword.length);
 	if (bracketStart === -1) return null;

 	let depth = 0;
 	let start = bracketStart;
 	for (let i = start; i < str.length; i++) {
 		if (str[i] === '[') depth++;
 		else if (str[i] === ']') {
 			depth--;
 			if (depth === 0) {
 				return str.substring(start + 1, i);
 			}
 		}
 	}
 	return null;
 }

 // Extract individual objects from an array string using bracket counting
 function extractObjects(arrayContent) {
 	const objects = [];
 	let depth = 0;
 	let current = '';
 	for (let i = 0; i < arrayContent.length; i++) {
 		const ch = arrayContent[i];
 		if (ch === '{') {
 			depth++;
 			current += ch;
 		} else if (ch === '}') {
 			depth--;
 			current += ch;
 			if (depth === 0) {
 				objects.push(current.trim());
 				current = '';
 			}
 		} else {
 			if (depth > 0) current += ch;
 		}
 	}
 	return objects;
 }

 // Extract content between matching braces { ... }
 function extractBraces(str, startKeyword) {
 	const idx = str.indexOf(startKeyword);
 	if (idx === -1) return null;

 	let braceStart = str.indexOf('{', idx + startKeyword.length);
 	if (braceStart === -1) return null;

 	let depth = 0;
 	for (let i = braceStart; i < str.length; i++) {
 		if (str[i] === '{') depth++;
 		else if (str[i] === '}') {
 			depth--;
 			if (depth === 0) {
 				return str.substring(braceStart + 1, i);
 			}
 		}
 	}
 	return null;
 }

 // Parse an override object to extract files and rules
 function parseOverride(obj) {
 	const filesMatch = obj.match(/files:\s*\[([^\]]*)\]/);
 	const rulesContent = extractBraces(obj, 'rules:');

 	const files = [];
 	if (filesMatch) {
 		const items = filesMatch[1].match(/["']([^"']+)["']/g);
 		if (items) files.push(...items.map((s) => s.replace(/["']/g, '')));
 	}

 	const rules = {};
 	if (rulesContent) {
 		const ruleLines = rulesContent.split('\n');
 		for (const line of ruleLines) {
 			const ruleMatch = line.match(/["']([^"']+)["']\s*:\s*["']([^"']+)["']/);
 			if (ruleMatch) {
 				rules[ruleMatch[1]] = ruleMatch[2];
 			}
 		}
 	}

 	return { files, rules };
 }

 // Extract and filter overrides
 const overridesContent = extractArray(content, 'overrides:');
 const jsOverrides = [];
 if (overridesContent) {
 	const overrideObjects = extractObjects(overridesContent);
 	for (const obj of overrideObjects) {
 		const parsed = parseOverride(obj);
 		// Skip JSON-only overrides
 		if (
 			parsed.files.some(
 				(f) => f.includes('tsconfig') && f.includes('.json'),
 			)
 		) {
 			console.error(
 				`  Removed JSON-only override: ${parsed.files.join(', ')}`,
 			);
 			continue;
 		}
 		jsOverrides.push(parsed);
 	}
 }

 // Extract and filter jsPlugins
 const jsPluginsContent = extractArray(content, 'jsPlugins:');
 const jsPlugins = [];
 if (jsPluginsContent) {
 	const items = extractObjects(jsPluginsContent);
 	// Also get string literals
 	const stringItems =
 		jsPluginsContent.match(
 			/(?:^|,)\s*["']([^"']+)["']\s*(?:,|$)/gm,
 		) || [];

 	for (const item of items) {
 		if (item.includes('@auditboard/eslint-plugin')) {
 			console.error(
 				'  Removed @auditboard/eslint-plugin from jsPlugins',
 			);
 			continue;
 		}
 		const nameMatch = item.match(/name:\s*["']([^"']+)["']/);
 		const specMatch = item.match(/specifier:\s*["']([^"']+)["']/);
 		if (nameMatch && specMatch) {
 			jsPlugins.push({ name: nameMatch[1], specifier: specMatch[1] });
 		}
 	}

 	// Get top-level string plugins (not inside objects)
 	let d = 0;
 	let buf = '';
 	for (let i = 0; i < jsPluginsContent.length; i++) {
 		const ch = jsPluginsContent[i];
 		if (ch === '{') d++;
 		else if (ch === '}') d--;
 		else if (d === 0) buf += ch;
 	}
 	const topStrings = buf.match(/["']([^"']+)["']/g) || [];
 	for (const s of topStrings) {
 		const name = s.replace(/["']/g, '');
 		if (name === '@auditboard/eslint-plugin') {
 			console.error(
 				'  Removed @auditboard/eslint-plugin from jsPlugins',
 			);
 			continue;
 		}
 		jsPlugins.push(name);
 	}
 }

 // Build output
 let jsPluginsCode = '';
 for (const p of jsPlugins) {
 	if (typeof p === 'object') {
 		jsPluginsCode += `\t\t\t{\n\t\t\t\tname: '${p.name}',\n\t\t\t\tspecifier: '${p.specifier}',\n\t\t\t},\n`;
 	} else {
 		jsPluginsCode += `\t\t\t'${p}',\n`;
 	}
 }

 let overridesCode = '';
 for (const ov of jsOverrides) {
 	const filesStr = ov.files.map((f) => `'${f}'`).join(', ');
 	const ruleEntries = Object.entries(ov.rules);
 	if (ruleEntries.length > 0) {
 		const rulesStr = ruleEntries
 			.map(([k, v]) => `\t\t\t\t'${k}': '${v}',`)
 			.join('\n');
 		overridesCode += `\t\t\t{\n\t\t\t\tfiles: [${filesStr}],\n\t\t\t\trules: {\n${rulesStr}\n\t\t\t\t},\n\t\t\t},\n`;
 	} else {
 		overridesCode += `\t\t\t{\n\t\t\t\tfiles: [${filesStr}],\n\t\t\t},\n`;
 	}
 }

 // Add CJS globals override only if CJS files are present
 if (hasCjs) {
 	overridesCode += `\t\t\t{\n\t\t\t\tfiles: ['**/*.cjs'],\n\t\t\t\tglobals: globals.commonjs,\n\t\t\t},\n`;
 }

 const ignoreStr = ignorePatterns.map((p) => `'${p}'`).join(', ');

 const globalsImport = hasCjs ? `import globals from 'globals';\n` : '';

 const output = `${globalsImport}import { defineConfig } from 'oxlint';

 import { mergeConfigs, node } from '@soxhub/lint/oxlint';

 // oxlint-disable-next-line typescript/no-unsafe-assignment -- For some reason we don't get the types correctly here
 const baseConfig = node({ typescript: true, esm: true });

 export default defineConfig(
 \tmergeConfigs(baseConfig, {
 \t\tplugins: ['import', 'node', 'typescript', 'unicorn'],
 \t\tjsPlugins: [
 ${jsPluginsCode}\t\t],
 \t\tignorePatterns: [${ignoreStr}],
 \t\toverrides: [
 ${overridesCode}\t\t],
 \t}),
 );
 `;

 fs.writeFileSync(path, output);
 console.error(`  Wrote cleaned ${path}`);
diff --git a/linked-brewing-muffin.md b/linked-brewing-muffin.md
diff --git a/migrate-to-oxlint.sh b/migrate-to-oxlint.sh
 #!/bin/bash
 set -euo pipefail

 PACKAGE_DIR="$1"
 REPO_ROOT="$(git rev-parse --show-toplevel)"
 FULL_PATH="$REPO_ROOT/$PACKAGE_DIR"

 if [ -z "$PACKAGE_DIR" ]; then
  echo "Usage: $0 <package-dir>"
  exit 1
 fi

 if [ ! -d "$FULL_PATH" ]; then
  echo "ERROR: Directory not found: $FULL_PATH"
  exit 1
 fi

 cd "$REPO_ROOT"
 echo "=== Migrating $PACKAGE_DIR ==="

 # ============================================================
 # Step 1: Run migration tool
 # ============================================================
 echo ""
 echo "--- Step 1: Running soxhub-oxlint-migrate --minimal ---"
 cd "$FULL_PATH"
 pnpm exec soxhub-oxlint-migrate --minimal 2>&1 || {
  echo "WARNING: Migration tool failed. oxlint.config.ts may need manual creation."
 }

 # ============================================================
 # Detect CJS files
 # ============================================================
 HAS_CJS=false
 if find . -name "*.cjs" -not -path "*/node_modules/*" -not -path "*/build/*" | grep -q .; then
  HAS_CJS=true
  echo "CJS files detected — will add globals override"
 else
  echo "No CJS files detected — skipping globals override"
 fi

 # ============================================================
 # Step 2: Update package.json (scripts + devDeps, remove lint:ox)
 # ============================================================
 echo ""
 echo "--- Step 2: Updating package.json ---"

 TMPFILE=$(mktemp)
 jq --argjson hasCjs "$HAS_CJS" '
  .scripts["lint:js"] = "NODE_OPTIONS=\"--import @oxc-node/core/register\" oxlint --deny-warnings --type-aware --report-unused-disable-directives $FILES" |
  .scripts["lint:js:fix"] = "NODE_OPTIONS=\"--import @oxc-node/core/register\" oxlint --deny-warnings --type-aware --report-unused-disable-directives --fix $FILES" |
  .scripts["lint:json"] = "eslint --max-warnings=0 --cache --cache-location=.eslintcache.json --cache-strategy=content ${FILES:-.}" |
  .scripts["lint:json:fix"] = "eslint --fix --max-warnings=0 --cache --cache-location=.eslintcache.json --cache-strategy=content ${FILES:-.}" |
  del(.scripts["lint:ox"]) |
  .devDependencies["@oxc-node/core"] //= "^0.0.35" |
  .devDependencies["oxlint"] //= "^1.50.0" |
  .devDependencies["oxlint-tsgolint"] //= "^0.15.0" |
  (if $hasCjs then .devDependencies["globals"] //= "^17.3.0" else . end)
 ' package.json > "$TMPFILE" && mv "$TMPFILE" package.json
 echo "Updated package.json"

 # ============================================================
 # Step 3: Rewrite oxlint.config.ts using external helper
 # ============================================================
 echo ""
 echo "--- Step 3: Rewriting oxlint.config.ts ---"

 if [ -f "oxlint.config.ts" ]; then
  node /tmp/fix-oxlint-config.js oxlint.config.ts "$HAS_CJS" 2>&1
  echo "Rewrote oxlint.config.ts"
 else
  echo "WARNING: No oxlint.config.ts found"
 fi

 # ============================================================
 # Step 4: Write eslint.config.mjs (JSON-only)
 # ============================================================
 echo ""
 echo "--- Step 4: Writing JSON-only eslint.config.mjs ---"

 # Check if existing config has @auditboard/no-dependency-tsconfig-paths
 HAS_TSCONFIG_RULE=false
 if [ -f "eslint.config.mjs" ] && grep -q "no-dependency-tsconfig-paths" eslint.config.mjs; then
  HAS_TSCONFIG_RULE=true
 fi

 # Extract ignorePatterns for eslint globalIgnores
 IGNORE_PATTERNS=$(node -e "
 const fs = require('fs');
 const content = fs.readFileSync('oxlint.config.ts', 'utf8');
 const match = content.match(/ignorePatterns:\\s*\\[(.*?)\\]/);
 if (match) {
  const items = match[1].match(/'([^']+)'/g);
  if (items) console.log(items.map(i => i.replace(/'/g, '')).join(','));
 } else {
  console.log('build');
 }
 " 2>/dev/null || echo "build")

 IFS=',' read -ra IGNORE_ARRAY <<< "$IGNORE_PATTERNS"
 IGNORE_JS=""
 for pattern in "${IGNORE_ARRAY[@]}"; do
  pattern=$(echo "$pattern" | xargs)
  IGNORE_JS="$IGNORE_JS'$pattern', "
 done
 IGNORE_JS="${IGNORE_JS%, }"

 if [ "$HAS_TSCONFIG_RULE" = true ]; then
  cat > eslint.config.mjs << 'ESLINT_EOF'
 import { defineConfig, globalIgnores } from 'eslint/config';
 import jsoncParser from 'jsonc-eslint-parser';

 import auditboardPlugin from '@auditboard/eslint-plugin';
 import soxhubLint from '@soxhub/lint/eslint';

 const { node } = soxhubLint;

 const nodeConfig = node({ root: true, path: import.meta.dirname });

 export default defineConfig([
 	globalIgnores(['**/*', '!**/*.json', '!**/*.jsonc']),
 ESLINT_EOF
  echo "	globalIgnores([$IGNORE_JS])," >> eslint.config.mjs
  cat >> eslint.config.mjs << 'ESLINT_EOF'
 	nodeConfig,
 	{
 		files: ['**/tsconfig*.json'],
 		plugins: {
 			'@auditboard': auditboardPlugin,
 		},
 		languageOptions: {
 			parser: jsoncParser,
 		},
 		rules: {
 			'@auditboard/no-dependency-tsconfig-paths': 'error',
 		},
 	},
 ]);
 ESLINT_EOF
 else
  cat > eslint.config.mjs << 'ESLINT_EOF'
 import { defineConfig, globalIgnores } from 'eslint/config';

 import soxhubLint from '@soxhub/lint/eslint';

 const { node } = soxhubLint;

 const nodeConfig = node({ root: true, path: import.meta.dirname });

 export default defineConfig([
 	globalIgnores(['**/*', '!**/*.json', '!**/*.jsonc']),
 ESLINT_EOF
  echo "	globalIgnores([$IGNORE_JS])," >> eslint.config.mjs
  cat >> eslint.config.mjs << 'ESLINT_EOF'
 	nodeConfig,
 ]);
 ESLINT_EOF
 fi

 echo "Wrote JSON-only eslint.config.mjs (has tsconfig rule: $HAS_TSCONFIG_RULE)"

 # ============================================================
 # Step 5: Fix JSON sort order, run autofix, prettier, clean up
 # ============================================================
 echo ""
 echo "--- Step 5: Autofixing and cleaning up ---"
 cd "$FULL_PATH"

 # Fix JSON sort order
 echo ">> lint:json:fix"
 pnpm lint:json:fix 2>&1 || true
 rm -f .eslintcache.json

 # Run oxlint autofix (import sorting, array-type, etc.)
 echo ">> lint:js:fix"
 pnpm lint:js:fix 2>&1 || true

 # Run prettier fix (fixes formatting from autofix changes)
 echo ">> lint:prettier:fix"
 pnpm lint:prettier:fix 2>&1 || true

 # Clean up generated files
 rm -f oxlint-migration-report.md .eslintcache.json

 # ============================================================
 # Step 6: Run lint checks
 # ============================================================
 echo ""
 echo "--- Step 6: Running final lint checks ---"
 LINT_PASS=true

 echo ">> lint:js"
 if ! pnpm lint:js 2>&1; then
  LINT_PASS=false
  echo "FAILED: lint:js"
 fi

 echo ">> lint:json"
 if ! pnpm lint:json 2>&1; then
  LINT_PASS=false
  echo "FAILED: lint:json"
 fi
 rm -f .eslintcache.json

 echo ">> lint:prettier"
 if ! pnpm lint:prettier 2>&1; then
  LINT_PASS=false
  echo "FAILED: lint:prettier"
 fi

 echo ">> lint:types"
 if ! pnpm lint:types 2>&1; then
  LINT_PASS=false
  echo "FAILED: lint:types"
 fi

 echo ""
 if [ "$LINT_PASS" = true ]; then
  echo "=== ALL LINT CHECKS PASSED ==="
 else
  echo "=== SOME LINT CHECKS FAILED — manual fixes needed ==="
 fi

 echo ""
 echo "=== REMAINING STEPS ==="
 echo "1. Review oxlint.config.ts for any package-specific adjustments"
 echo "2. Fix any remaining lint failures above"
 echo "3. git add + commit (include pnpm-lock.yaml)"
 echo "4. Push and create PR"
 echo "==========================="
	#!/usr/bin/env node
	/**
	* Rewrites a migration-tool-generated oxlint.config.ts:
	* - Fixes indentation
	* - Adds globals import + CJS override (if CJS files present)
	* - Removes JSON-file overrides (tsconfig*.json)
	* - Removes @auditboard/eslint-plugin from jsPlugins
	* - Adds no-unsafe-assignment disable comment
	*/

	const fs = require('fs');
	const path = process.argv[2] \|\| 'oxlint.config.ts';
	const hasCjs = process.argv[3] === 'true';
	const content = fs.readFileSync(path, 'utf8');

	// Extract ignorePatterns
	const ignoreMatch = content.match(/ignorePatterns:\s\[([^\]])\]/);
	let ignorePatterns = ['build'];
	if (ignoreMatch) {
	const items = ignoreMatch[1].match(/["']([^"']+)["']/g);
	if (items) ignorePatterns = items.map((s) => s.replace(/["']/g, ''));
	}

	// Extract overrides using bracket counting
	function extractArray(str, startKeyword) {
	const idx = str.indexOf(startKeyword);
	if (idx === -1) return null;

	// Find the opening bracket
	let bracketStart = str.indexOf('[', idx + startKeyword.length);
	if (bracketStart === -1) return null;

	let depth = 0;
	let start = bracketStart;
	for (let i = start; i < str.length; i++) {
	if (str[i] === '[') depth++;
	else if (str[i] === ']') {
	depth--;
	if (depth === 0) {
	return str.substring(start + 1, i);
	}
	}
	}
	return null;
	}

	// Extract individual objects from an array string using bracket counting
	function extractObjects(arrayContent) {
	const objects = [];
	let depth = 0;
	let current = '';
	for (let i = 0; i < arrayContent.length; i++) {
	const ch = arrayContent[i];
	if (ch === '{') {
	depth++;
	current += ch;
	} else if (ch === '}') {
	depth--;
	current += ch;
	if (depth === 0) {
	objects.push(current.trim());
	current = '';
	}
	} else {
	if (depth > 0) current += ch;
	}
	}
	return objects;
	}

	// Extract content between matching braces { ... }
	function extractBraces(str, startKeyword) {
	const idx = str.indexOf(startKeyword);
	if (idx === -1) return null;

	let braceStart = str.indexOf('{', idx + startKeyword.length);
	if (braceStart === -1) return null;

	let depth = 0;
	for (let i = braceStart; i < str.length; i++) {
	if (str[i] === '{') depth++;
	else if (str[i] === '}') {
	depth--;
	if (depth === 0) {
	return str.substring(braceStart + 1, i);
	}
	}
	}
	return null;
	}

	// Parse an override object to extract files and rules
	function parseOverride(obj) {
	const filesMatch = obj.match(/files:\s\[([^\]])\]/);
	const rulesContent = extractBraces(obj, 'rules:');

	const files = [];
	if (filesMatch) {
	const items = filesMatch[1].match(/["']([^"']+)["']/g);
	if (items) files.push(...items.map((s) => s.replace(/["']/g, '')));
	}

	const rules = {};
	if (rulesContent) {
	const ruleLines = rulesContent.split('\n');
	for (const line of ruleLines) {
	const ruleMatch = line.match(/["']([^"']+)["']\s:\s["']([^"']+)["']/);
	if (ruleMatch) {
	rules[ruleMatch[1]] = ruleMatch[2];
	}
	}
	}

	return { files, rules };
	}

	// Extract and filter overrides
	const overridesContent = extractArray(content, 'overrides:');
	const jsOverrides = [];
	if (overridesContent) {
	const overrideObjects = extractObjects(overridesContent);
	for (const obj of overrideObjects) {
	const parsed = parseOverride(obj);
	// Skip JSON-only overrides
	if (
	parsed.files.some(
	(f) => f.includes('tsconfig') && f.includes('.json'),
	)
	) {
	console.error(
	` Removed JSON-only override: ${parsed.files.join(', ')}`,
	);
	continue;
	}
	jsOverrides.push(parsed);
	}
	}

	// Extract and filter jsPlugins
	const jsPluginsContent = extractArray(content, 'jsPlugins:');
	const jsPlugins = [];
	if (jsPluginsContent) {
	const items = extractObjects(jsPluginsContent);
	// Also get string literals
	const stringItems =
	jsPluginsContent.match(
	/(?:^\|,)\s["']([^"']+)["']\s(?:,\|$)/gm,
	) \|\| [];

	for (const item of items) {
	if (item.includes('@auditboard/eslint-plugin')) {
	console.error(
	' Removed @auditboard/eslint-plugin from jsPlugins',
	);
	continue;
	}
	const nameMatch = item.match(/name:\s*["']([^"']+)["']/);
	const specMatch = item.match(/specifier:\s*["']([^"']+)["']/);
	if (nameMatch && specMatch) {
	jsPlugins.push({ name: nameMatch[1], specifier: specMatch[1] });
	}
	}

	// Get top-level string plugins (not inside objects)
	let d = 0;
	let buf = '';
	for (let i = 0; i < jsPluginsContent.length; i++) {
	const ch = jsPluginsContent[i];
	if (ch === '{') d++;
	else if (ch === '}') d--;
	else if (d === 0) buf += ch;
	}
	const topStrings = buf.match(/["']([^"']+)["']/g) \|\| [];
	for (const s of topStrings) {
	const name = s.replace(/["']/g, '');
	if (name === '@auditboard/eslint-plugin') {
	console.error(
	' Removed @auditboard/eslint-plugin from jsPlugins',
	);
	continue;
	}
	jsPlugins.push(name);
	}
	}

	// Build output
	let jsPluginsCode = '';
	for (const p of jsPlugins) {
	if (typeof p === 'object') {
	jsPluginsCode += `\t\t\t{\n\t\t\t\tname: '${p.name}',\n\t\t\t\tspecifier: '${p.specifier}',\n\t\t\t},\n`;
	} else {
	jsPluginsCode += `\t\t\t'${p}',\n`;
	}
	}

	let overridesCode = '';
	for (const ov of jsOverrides) {
	const filesStr = ov.files.map((f) => `'${f}'`).join(', ');
	const ruleEntries = Object.entries(ov.rules);
	if (ruleEntries.length > 0) {
	const rulesStr = ruleEntries
	.map(([k, v]) => `\t\t\t\t'${k}': '${v}',`)
	.join('\n');
	overridesCode += `\t\t\t{\n\t\t\t\tfiles: [${filesStr}],\n\t\t\t\trules: {\n${rulesStr}\n\t\t\t\t},\n\t\t\t},\n`;
	} else {
	overridesCode += `\t\t\t{\n\t\t\t\tfiles: [${filesStr}],\n\t\t\t},\n`;
	}
	}

	// Add CJS globals override only if CJS files are present
	if (hasCjs) {
	overridesCode += `\t\t\t{\n\t\t\t\tfiles: ['*/.cjs'],\n\t\t\t\tglobals: globals.commonjs,\n\t\t\t},\n`;
	}

	const ignoreStr = ignorePatterns.map((p) => `'${p}'`).join(', ');

	const globalsImport = hasCjs ? `import globals from 'globals';\n` : '';

	const output = `${globalsImport}import { defineConfig } from 'oxlint';

	import { mergeConfigs, node } from '@soxhub/lint/oxlint';

	// oxlint-disable-next-line typescript/no-unsafe-assignment -- For some reason we don't get the types correctly here
	const baseConfig = node({ typescript: true, esm: true });

	export default defineConfig(
	\tmergeConfigs(baseConfig, {
	\t\tplugins: ['import', 'node', 'typescript', 'unicorn'],
	\t\tjsPlugins: [
	${jsPluginsCode}\t\t],
	\t\tignorePatterns: [${ignoreStr}],
	\t\toverrides: [
	${overridesCode}\t\t],
	\t}),
	);
	`;

	fs.writeFileSync(path, output);
	console.error(` Wrote cleaned ${path}`);
	#!/bin/bash
	set -euo pipefail

	PACKAGE_DIR="$1"
	REPO_ROOT="$(git rev-parse --show-toplevel)"
	FULL_PATH="$REPO_ROOT/$PACKAGE_DIR"

	if [ -z "$PACKAGE_DIR" ]; then
	echo "Usage: $0 <package-dir>"
	exit 1
	fi

	if [ ! -d "$FULL_PATH" ]; then
	echo "ERROR: Directory not found: $FULL_PATH"
	exit 1
	fi

	cd "$REPO_ROOT"
	echo "=== Migrating $PACKAGE_DIR ==="

	# ============================================================
	# Step 1: Run migration tool
	# ============================================================
	echo ""
	echo "--- Step 1: Running soxhub-oxlint-migrate --minimal ---"
	cd "$FULL_PATH"
	pnpm exec soxhub-oxlint-migrate --minimal 2>&1 \|\| {
	echo "WARNING: Migration tool failed. oxlint.config.ts may need manual creation."
	}

	# ============================================================
	# Detect CJS files
	# ============================================================
	HAS_CJS=false
	if find . -name ".cjs" -not -path "/node_modules/" -not -path "/build/*" \| grep -q .; then
	HAS_CJS=true
	echo "CJS files detected — will add globals override"
	else
	echo "No CJS files detected — skipping globals override"
	fi

	# ============================================================
	# Step 2: Update package.json (scripts + devDeps, remove lint:ox)
	# ============================================================
	echo ""
	echo "--- Step 2: Updating package.json ---"

	TMPFILE=$(mktemp)
	jq --argjson hasCjs "$HAS_CJS" '
	.scripts["lint:js"] = "NODE_OPTIONS=\"--import @oxc-node/core/register\" oxlint --deny-warnings --type-aware --report-unused-disable-directives $FILES" \|
	.scripts["lint:js:fix"] = "NODE_OPTIONS=\"--import @oxc-node/core/register\" oxlint --deny-warnings --type-aware --report-unused-disable-directives --fix $FILES" \|
	.scripts["lint:json"] = "eslint --max-warnings=0 --cache --cache-location=.eslintcache.json --cache-strategy=content ${FILES:-.}" \|
	.scripts["lint:json:fix"] = "eslint --fix --max-warnings=0 --cache --cache-location=.eslintcache.json --cache-strategy=content ${FILES:-.}" \|
	del(.scripts["lint:ox"]) \|
	.devDependencies["@oxc-node/core"] //= "^0.0.35" \|
	.devDependencies["oxlint"] //= "^1.50.0" \|
	.devDependencies["oxlint-tsgolint"] //= "^0.15.0" \|
	(if $hasCjs then .devDependencies["globals"] //= "^17.3.0" else . end)
	' package.json > "$TMPFILE" && mv "$TMPFILE" package.json
	echo "Updated package.json"

	# ============================================================
	# Step 3: Rewrite oxlint.config.ts using external helper
	# ============================================================
	echo ""
	echo "--- Step 3: Rewriting oxlint.config.ts ---"

	if [ -f "oxlint.config.ts" ]; then
	node /tmp/fix-oxlint-config.js oxlint.config.ts "$HAS_CJS" 2>&1
	echo "Rewrote oxlint.config.ts"
	else
	echo "WARNING: No oxlint.config.ts found"
	fi

	# ============================================================
	# Step 4: Write eslint.config.mjs (JSON-only)
	# ============================================================
	echo ""
	echo "--- Step 4: Writing JSON-only eslint.config.mjs ---"

	# Check if existing config has @auditboard/no-dependency-tsconfig-paths
	HAS_TSCONFIG_RULE=false
	if [ -f "eslint.config.mjs" ] && grep -q "no-dependency-tsconfig-paths" eslint.config.mjs; then
	HAS_TSCONFIG_RULE=true
	fi

	# Extract ignorePatterns for eslint globalIgnores
	IGNORE_PATTERNS=$(node -e "
	const fs = require('fs');
	const content = fs.readFileSync('oxlint.config.ts', 'utf8');
	const match = content.match(/ignorePatterns:\\s\\[(.?)\\]/);
	if (match) {
	const items = match[1].match(/'([^']+)'/g);
	if (items) console.log(items.map(i => i.replace(/'/g, '')).join(','));
	} else {
	console.log('build');
	}
	" 2>/dev/null \|\| echo "build")

	IFS=',' read -ra IGNORE_ARRAY <<< "$IGNORE_PATTERNS"
	IGNORE_JS=""
	for pattern in "${IGNORE_ARRAY[@]}"; do
	pattern=$(echo "$pattern" \| xargs)
	IGNORE_JS="$IGNORE_JS'$pattern', "
	done
	IGNORE_JS="${IGNORE_JS%, }"

	if [ "$HAS_TSCONFIG_RULE" = true ]; then
	cat > eslint.config.mjs << 'ESLINT_EOF'
	import { defineConfig, globalIgnores } from 'eslint/config';
	import jsoncParser from 'jsonc-eslint-parser';

	import auditboardPlugin from '@auditboard/eslint-plugin';
	import soxhubLint from '@soxhub/lint/eslint';

	const { node } = soxhubLint;

	const nodeConfig = node({ root: true, path: import.meta.dirname });

	export default defineConfig([
	globalIgnores(['*/', '!*/.json', '!*/.jsonc']),
	ESLINT_EOF
	echo " globalIgnores([$IGNORE_JS])," >> eslint.config.mjs
	cat >> eslint.config.mjs << 'ESLINT_EOF'
	nodeConfig,
	{
	files: ['*/tsconfig.json'],
	plugins: {
	'@auditboard': auditboardPlugin,
	},
	languageOptions: {
	parser: jsoncParser,
	},
	rules: {
	'@auditboard/no-dependency-tsconfig-paths': 'error',
	},
	},
	]);
	ESLINT_EOF
	else
	cat > eslint.config.mjs << 'ESLINT_EOF'
	import { defineConfig, globalIgnores } from 'eslint/config';

	import soxhubLint from '@soxhub/lint/eslint';

	const { node } = soxhubLint;

	const nodeConfig = node({ root: true, path: import.meta.dirname });

	export default defineConfig([
	globalIgnores(['*/', '!*/.json', '!*/.jsonc']),
	ESLINT_EOF
	echo " globalIgnores([$IGNORE_JS])," >> eslint.config.mjs
	cat >> eslint.config.mjs << 'ESLINT_EOF'
	nodeConfig,
	]);
	ESLINT_EOF
	fi

	echo "Wrote JSON-only eslint.config.mjs (has tsconfig rule: $HAS_TSCONFIG_RULE)"

	# ============================================================
	# Step 5: Fix JSON sort order, run autofix, prettier, clean up
	# ============================================================
	echo ""
	echo "--- Step 5: Autofixing and cleaning up ---"
	cd "$FULL_PATH"

	# Fix JSON sort order
	echo ">> lint:json:fix"
	pnpm lint:json:fix 2>&1 \|\| true
	rm -f .eslintcache.json

	# Run oxlint autofix (import sorting, array-type, etc.)
	echo ">> lint:js:fix"
	pnpm lint:js:fix 2>&1 \|\| true

	# Run prettier fix (fixes formatting from autofix changes)
	echo ">> lint:prettier:fix"
	pnpm lint:prettier:fix 2>&1 \|\| true

	# Clean up generated files
	rm -f oxlint-migration-report.md .eslintcache.json

	# ============================================================
	# Step 6: Run lint checks
	# ============================================================
	echo ""
	echo "--- Step 6: Running final lint checks ---"
	LINT_PASS=true

	echo ">> lint:js"
	if ! pnpm lint:js 2>&1; then
	LINT_PASS=false
	echo "FAILED: lint:js"
	fi

	echo ">> lint:json"
	if ! pnpm lint:json 2>&1; then
	LINT_PASS=false
	echo "FAILED: lint:json"
	fi
	rm -f .eslintcache.json

	echo ">> lint:prettier"
	if ! pnpm lint:prettier 2>&1; then
	LINT_PASS=false
	echo "FAILED: lint:prettier"
	fi

	echo ">> lint:types"
	if ! pnpm lint:types 2>&1; then
	LINT_PASS=false
	echo "FAILED: lint:types"
	fi

	echo ""
	if [ "$LINT_PASS" = true ]; then
	echo "=== ALL LINT CHECKS PASSED ==="
	else
	echo "=== SOME LINT CHECKS FAILED — manual fixes needed ==="
	fi

	echo ""
	echo "=== REMAINING STEPS ==="
	echo "1. Review oxlint.config.ts for any package-specific adjustments"
	echo "2. Fix any remaining lint failures above"
	echo "3. git add + commit (include pnpm-lock.yaml)"
	echo "4. Push and create PR"
	echo "==========================="