@geoql/doctor-core 0.2.0-alpha.0 → 1.0.0

package/dist/index.js

@@ -1,12 +1,12 @@
-import { a as listRules, c as InvalidConfigError, i as RULE_REGISTRY, l as BUILT_IN_RECOMMENDED, o as ConfigCycleError, r as validateConfig, s as ConfigFileNotFoundError, t as loadDoctorConfig } from "./load-DiK7Zv0B.js";
+import { a as listRules, c as InvalidConfigError, i as RULE_REGISTRY, l as BUILT_IN_RECOMMENDED, o as ConfigCycleError, r as validateConfig, s as ConfigFileNotFoundError, t as loadDoctorConfig } from "./load-yXDi-5ti.js";
 import { dirname, join, relative, resolve } from "node:path";
 import { performance } from "node:perf_hooks";
-import { access, mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { access, mkdir, mkdtemp, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";
 import { execFile, spawn } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
-import { coerce, gte, major, minor } from "semver";
 import { parseSync } from "oxc-parser";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { coerce, gte, major, minor } from "semver";
 import { glob } from "tinyglobby";
 import { tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
@@ -54,7 +54,7 @@ async function readDeps(packageJsonPath) {
 }
 //#endregion
 //#region src/build-quality/check-eslint-plugin-vue.ts
-const RULE_ID$6 = "vue-doctor/build-quality/eslint-plugin-vue-installed";
+const RULE_ID$20 = "vue-doctor/build-quality/eslint-plugin-vue-installed";
 const DOCS$3 = "https://eslint.vuejs.org/";
 async function checkEslintPluginVue(projectInfo) {
 	if (projectInfo.packageJsonPath === null) return [];
@@ -63,7 +63,7 @@ async function checkEslintPluginVue(projectInfo) {
 	if (deps === null) return [];
 	if (deps.devDependencies["eslint-plugin-vue"]) return [];
 	return [{
-		ruleId: RULE_ID$6,
+		ruleId: RULE_ID$20,
 		file: projectInfo.packageJsonPath,
 		line: 1,
 		column: 1,
@@ -74,7 +74,7 @@ async function checkEslintPluginVue(projectInfo) {
 }
 //#endregion
 //#region src/build-quality/check-no-vue-cli.ts
-const RULE_ID$5 = "vue-doctor/build-quality/no-vue-cli";
+const RULE_ID$19 = "vue-doctor/build-quality/no-vue-cli";
 const DOCS$2 = "https://cli.vuejs.org/migrations/migrate-from-v4.html";
 function isOffendingKey(key) {
 	return key === "@vue/cli-service" || key.startsWith("vue-cli-plugin-");
@@ -86,7 +86,7 @@ async function checkNoVueCli(projectInfo) {
 	const offenders = [];
 	for (const key of [...Object.keys(deps.dependencies), ...Object.keys(deps.devDependencies)]) if (isOffendingKey(key) && !offenders.includes(key)) offenders.push(key);
 	return offenders.map((key, index) => ({
-		ruleId: RULE_ID$5,
+		ruleId: RULE_ID$19,
 		file: projectInfo.packageJsonPath,
 		line: index + 1,
 		column: 1,
@@ -148,7 +148,7 @@ function stripJsonComments(input) {
 }
 //#endregion
 //#region src/build-quality/check-tsconfig-strict.ts
-const RULE_ID$4 = "vue-doctor/build-quality/tsconfig-strict-required";
+const RULE_ID$18 = "vue-doctor/build-quality/tsconfig-strict-required";
 const DOCS$1 = "https://www.typescriptlang.org/tsconfig#strict";
 async function checkTsconfigStrict(projectInfo) {
 	if (projectInfo.packageJsonPath === null) return [];
@@ -162,7 +162,7 @@ async function checkTsconfigStrict(projectInfo) {
 	}
 	if (parsed.compilerOptions?.strict === true) return [];
 	return [{
-		ruleId: RULE_ID$4,
+		ruleId: RULE_ID$18,
 		file: tsconfigPath,
 		line: 1,
 		column: 1,
@@ -173,7 +173,7 @@ async function checkTsconfigStrict(projectInfo) {
 }
 //#endregion
 //#region src/build-quality/check-vue-tsc.ts
-const RULE_ID$3 = "vue-doctor/build-quality/vue-tsc-in-devDeps";
+const RULE_ID$17 = "vue-doctor/build-quality/vue-tsc-in-devDeps";
 const DOCS = "https://github.com/vuejs/language-tools/tree/master/packages/tsc";
 async function checkVueTsc(projectInfo) {
 	if (projectInfo.packageJsonPath === null) return [];
@@ -182,7 +182,7 @@ async function checkVueTsc(projectInfo) {
 	if (deps === null) return [];
 	if (deps.devDependencies["vue-tsc"]) return [];
 	return [{
-		ruleId: RULE_ID$3,
+		ruleId: RULE_ID$17,
 		file: projectInfo.packageJsonPath,
 		line: 1,
 		column: 1,
@@ -215,6 +215,7 @@ async function checkBuildQuality(projectInfo) {
 //#region src/dead-code/build-knip-config.ts
 function buildKnipConfig(projectInfo, doctorConfig) {
 	const isNuxt = projectInfo.framework === "nuxt";
+	const usesConventionResolution = projectInfo.hasAutoImports || projectInfo.hasComponentsAutoImport || projectInfo.hasVueRouter;
 	const entry = isNuxt ? [
 		"app/**/*.vue",
 		"app/**/*.ts",
@@ -224,7 +225,14 @@ function buildKnipConfig(projectInfo, doctorConfig) {
 		"src/main.{ts,js}",
 		"src/App.vue",
 		"index.html",
-		"vite.config.{ts,js}"
+		"vite.config.{ts,js}",
+		...usesConventionResolution ? [
+			"src/pages/**/*.vue",
+			"src/layouts/**/*.vue",
+			"src/components/**/*.vue",
+			"src/composables/**/*.ts",
+			"src/stores/**/*.ts"
+		] : []
 	];
 	const config = {
 		cwd: projectInfo.rootDirectory,
@@ -381,6 +389,20 @@ const _knipLoader = { load: async () => {
 		run: runModule.run
 	};
 } };
+async function writeKnipConfig(rootDir, config) {
+	const cacheDir = join(rootDir, "node_modules", ".cache", "doctor");
+	await mkdir(cacheDir, { recursive: true });
+	const configPath = join(cacheDir, "knip.json");
+	const knipJson = {
+		entry: config.entry,
+		project: config.project,
+		ignore: config.ignoreFiles,
+		ignoreDependencies: config.ignoreDependencies
+	};
+	if (config.compilers) knipJson.compilers = config.compilers;
+	await writeFile(configPath, JSON.stringify(knipJson, null, 2), "utf8");
+	return configPath;
+}
 async function checkDeadCode(options) {
 	if (!options.enabled) return [];
 	const config = buildKnipConfig(options.projectInfo, options.doctorConfig);
@@ -394,13 +416,10 @@ async function checkDeadCode(options) {
 	} catch (err) {
 		throw new DeadCodeImportFailed(err);
 	}
+	const configPath = await writeKnipConfig(options.projectInfo.rootDirectory, config);
 	const knipOptions = await createOptions({
 		cwd: options.projectInfo.rootDirectory,
-		entry: config.entry,
-		project: config.project,
-		ignoreFiles: config.ignoreFiles,
-		ignoreDependencies: config.ignoreDependencies,
-		...config.compilers ? { compilers: config.compilers } : {}
+		args: { config: configPath }
 	});
 	const diagnostics = flattenKnipIssues((await Promise.race([run(knipOptions), new Promise((_, reject) => setTimeout(() => reject(new DeadCodeTimeoutError(timeoutMs)), timeoutMs))])).results.issues).map((issue) => mapKnipDiagnostic(options.projectInfo.rootDirectory, issue)).filter((d) => d !== null);
 	diagnostics.sort((a, b) => {
@@ -520,14 +539,14 @@ async function listVueResolutions(packageJsonPath) {
 }
 //#endregion
 //#region src/deps/check-duplicate-vue.ts
-const RULE_ID$2 = "vue-doctor/deps/duplicate-vue-versions";
+const RULE_ID$16 = "vue-doctor/deps/duplicate-vue-versions";
 async function checkDuplicateVue(projectInfo) {
 	if (projectInfo.packageJsonPath === null) return [];
 	const versions = await listVueResolutions(projectInfo.packageJsonPath);
 	const uniqueVersions = [...new Set(versions)];
 	if (uniqueVersions.length <= 1) return [];
 	return [{
-		ruleId: RULE_ID$2,
+		ruleId: RULE_ID$16,
 		file: projectInfo.packageJsonPath,
 		line: 1,
 		column: 1,
@@ -539,10 +558,10 @@ async function checkDuplicateVue(projectInfo) {
 }
 //#endregion
 //#region src/deps/check-vue-major-current.ts
-const RULE_ID$1 = "vue-doctor/deps/vue-major-current";
+const RULE_ID$15 = "vue-doctor/deps/vue-major-current";
 const DOCTOR_BUNDLED_VUE_FLOOR_MAJOR = 3;
 const DOCTOR_BUNDLED_VUE_FLOOR_MINOR = 5;
-function parseMajorMinor(version) {
+function parseMajorMinor$1(version) {
 	const match = /^v?(\d+)\.(\d+)/.exec(version.trim());
 	if (!match) return null;
 	return {
@@ -553,12 +572,12 @@ function parseMajorMinor(version) {
 function checkVueMajorCurrent(projectInfo) {
 	if (projectInfo.packageJsonPath === null) return [];
 	if (projectInfo.vueVersion === null) return [];
-	const parsed = parseMajorMinor(projectInfo.vueVersion);
+	const parsed = parseMajorMinor$1(projectInfo.vueVersion);
 	if (parsed === null) return [];
 	if (parsed.major !== DOCTOR_BUNDLED_VUE_FLOOR_MAJOR) return [];
 	if (parsed.minor >= DOCTOR_BUNDLED_VUE_FLOOR_MINOR) return [];
 	return [{
-		ruleId: RULE_ID$1,
+		ruleId: RULE_ID$15,
 		file: projectInfo.packageJsonPath,
 		line: 1,
 		column: 1,
@@ -583,6 +602,382 @@ async function checkDeps(projectInfo) {
 	}));
 }
 //#endregion
+//#region src/project-info/parse-nuxt-config.ts
+const CONFIG_FILES = [
+	"nuxt.config.ts",
+	"nuxt.config.js",
+	"nuxt.config.mjs"
+];
+async function readConfigSource(dir) {
+	for (const name of CONFIG_FILES) try {
+		return await readFile(join(dir, name), "utf8");
+	} catch {
+		continue;
+	}
+	return null;
+}
+function* objectEntries(obj) {
+	for (const prop of obj.properties) {
+		if (prop.type !== "Property") continue;
+		const key = prop.key;
+		if (key.type !== "Identifier") continue;
+		yield [key.name, prop.value];
+	}
+}
+function findEntry(obj, name) {
+	for (const [key, value] of objectEntries(obj)) if (key === name) return value;
+}
+function stringLiteral(node) {
+	return node.type === "Literal" && typeof node.value === "string" ? node.value : void 0;
+}
+function unwrapDefault(decl) {
+	if (decl.type !== "CallExpression") return decl;
+	const callee = decl.callee;
+	if (callee.type !== "Identifier") return null;
+	if (callee.name !== "defineNuxtConfig") return null;
+	return decl.arguments[0] ?? null;
+}
+function extractConfigObject(source) {
+	const exported = parseSync("nuxt.config.ts", source, {
+		sourceType: "module",
+		lang: "ts"
+	}).program.body.find((n) => n.type === "ExportDefaultDeclaration");
+	if (!exported) return null;
+	const node = unwrapDefault(exported.declaration);
+	if (!node) return null;
+	return node.type === "ObjectExpression" ? node : null;
+}
+function readNitroPreset(value) {
+	if (value.type !== "ObjectExpression") return void 0;
+	const preset = findEntry(value, "preset");
+	return preset ? stringLiteral(preset) : void 0;
+}
+function readImportsAutoImport(value) {
+	if (value.type !== "ObjectExpression") return void 0;
+	const node = findEntry(value, "autoImport");
+	if (node?.type === "Literal" && typeof node.value === "boolean") return node.value;
+}
+function readModules(value) {
+	if (value.type !== "ArrayExpression") return void 0;
+	const out = [];
+	for (const element of value.elements) {
+		if (!element) continue;
+		const str = stringLiteral(element);
+		if (str !== void 0) out.push(str);
+	}
+	return out;
+}
+function readCompatibility(value) {
+	return value.type === "Literal" && typeof value.value === "number" ? value.value : void 0;
+}
+function readHtmlLang(value) {
+	if (value.type !== "ObjectExpression") return void 0;
+	const head = findEntry(value, "head");
+	if (head?.type !== "ObjectExpression") return void 0;
+	const htmlAttrs = findEntry(head, "htmlAttrs");
+	if (htmlAttrs?.type !== "ObjectExpression") return void 0;
+	const lang = findEntry(htmlAttrs, "lang");
+	return lang ? stringLiteral(lang) : void 0;
+}
+async function parseNuxtConfig(dir) {
+	const source = await readConfigSource(dir);
+	if (source === null) return null;
+	const info = {};
+	const config = extractConfigObject(source);
+	if (!config) return info;
+	for (const [key, value] of objectEntries(config)) if (key === "compatibilityVersion") {
+		const compat = readCompatibility(value);
+		if (compat !== void 0) info.compatibilityVersion = compat;
+	} else if (key === "compatibilityDate") {
+		const date = stringLiteral(value);
+		if (date !== void 0) info.compatibilityDate = date;
+	} else if (key === "nitro") {
+		const preset = readNitroPreset(value);
+		if (preset !== void 0) info.nitroPreset = preset;
+	} else if (key === "modules") {
+		const modules = readModules(value);
+		if (modules !== void 0) info.modules = modules;
+	} else if (key === "imports") {
+		const autoImport = readImportsAutoImport(value);
+		if (autoImport !== void 0) info.importsAutoImport = autoImport;
+	} else if (key === "runtimeConfig") info.hasRuntimeConfig = true;
+	else if (key === "app") {
+		const lang = readHtmlLang(value);
+		if (lang !== void 0) info.htmlLang = lang;
+	}
+	return info;
+}
+//#endregion
+//#region src/nuxt/post-checks/compatibility-date-set.ts
+const RULE_ID$14 = "nuxt-doctor/nitro/compatibilityDate-set";
+function checkCompatibilityDateSet(projectInfo, nuxtConfig) {
+	if (projectInfo.packageJsonPath === null) return [];
+	if (nuxtConfig?.compatibilityDate !== void 0) return [];
+	return [{
+		ruleId: RULE_ID$14,
+		file: projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath,
+		line: 1,
+		column: 1,
+		severity: "error",
+		message: "No compatibilityDate is set. Nuxt 4 and Nitro require a compatibilityDate to pin deployment behaviour.",
+		recommendation: "Add compatibilityDate: 'YYYY-MM-DD' to defineNuxtConfig in nuxt.config."
+	}];
+}
+//#endregion
+//#region src/nuxt/post-checks/lang-on-html.ts
+const RULE_ID$13 = "nuxt-doctor/seo/lang-on-html";
+function checkLangOnHtml(projectInfo, nuxtConfig) {
+	if (projectInfo.packageJsonPath === null) return [];
+	if (nuxtConfig?.htmlLang !== void 0) return [];
+	return [{
+		ruleId: RULE_ID$13,
+		file: projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath,
+		line: 1,
+		column: 1,
+		severity: "warn",
+		message: "No lang attribute is set on the html element. Screen readers and search engines rely on it.",
+		recommendation: "Set app.head.htmlAttrs.lang (e.g. 'en') in defineNuxtConfig."
+	}];
+}
+//#endregion
+//#region src/nuxt/post-checks/nitro-cloudflare-preset.ts
+const RULE_ID$12 = "nuxt-doctor/cloudflare/nitro-cloudflare-preset";
+const CLOUDFLARE_PRESETS = new Set([
+	"cloudflare-pages",
+	"cloudflare-module",
+	"cloudflare"
+]);
+function checkNitroCloudflarePreset(projectInfo) {
+	if (projectInfo.packageJsonPath === null) return [];
+	if (!projectInfo.hasWranglerConfig) return [];
+	if (projectInfo.nitroPreset === null) return [];
+	if (CLOUDFLARE_PRESETS.has(projectInfo.nitroPreset)) return [];
+	return [{
+		ruleId: RULE_ID$12,
+		file: projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath,
+		line: 1,
+		column: 1,
+		severity: "warn",
+		message: `A wrangler config is present but the Nitro preset is '${projectInfo.nitroPreset}', not a Cloudflare preset.`,
+		recommendation: "Set nitro.preset to 'cloudflare-module' (or 'cloudflare-pages') to deploy on Cloudflare."
+	}];
+}
+//#endregion
+//#region src/nuxt/post-checks/no-modules-incompatible-with-nuxt-4.ts
+const RULE_ID$11 = "nuxt-doctor/modules-deps/no-modules-incompatible-with-nuxt-4";
+const INCOMPATIBLE_MODULES = new Set([
+	"@nuxtjs/composition-api",
+	"@nuxt/bridge",
+	"nuxt-property-decorator"
+]);
+async function checkNoModulesIncompatibleWithNuxt4(projectInfo) {
+	if (projectInfo.packageJsonPath === null) return [];
+	const deps = await readDeps(projectInfo.packageJsonPath);
+	if (deps === null) return [];
+	const offenders = [];
+	for (const key of [...Object.keys(deps.dependencies), ...Object.keys(deps.devDependencies)]) if (INCOMPATIBLE_MODULES.has(key) && !offenders.includes(key)) offenders.push(key);
+	return offenders.map((name, index) => ({
+		ruleId: RULE_ID$11,
+		file: projectInfo.packageJsonPath,
+		line: index + 1,
+		column: 1,
+		severity: "warn",
+		message: `${name} is incompatible with Nuxt 4 and is no longer maintained.`,
+		recommendation: `Remove ${name} and adopt the Nuxt 4 native equivalent.`
+	}));
+}
+//#endregion
+//#region src/nuxt/post-checks/no-node-only-modules.ts
+const RULE_ID$10 = "nuxt-doctor/cloudflare/no-node-only-modules";
+const NODE_ONLY_MODULES = new Set(["fs-extra", "sharp"]);
+async function checkNoNodeOnlyModules(projectInfo) {
+	if (projectInfo.packageJsonPath === null) return [];
+	if (!projectInfo.hasWranglerConfig) return [];
+	const deps = await readDeps(projectInfo.packageJsonPath);
+	if (deps === null) return [];
+	const offenders = [];
+	for (const key of [...Object.keys(deps.dependencies), ...Object.keys(deps.devDependencies)]) if (NODE_ONLY_MODULES.has(key) && !offenders.includes(key)) offenders.push(key);
+	return offenders.map((name, index) => ({
+		ruleId: RULE_ID$10,
+		file: projectInfo.packageJsonPath,
+		line: index + 1,
+		column: 1,
+		severity: "warn",
+		message: `${name} is a Node-only module and does not run on the Cloudflare Workers runtime.`,
+		recommendation: `Replace ${name} with a Workers-compatible alternative or move it to a build-only step.`
+	}));
+}
+//#endregion
+//#region src/nuxt/post-checks/nuxt-major-current.ts
+const RULE_ID$9 = "nuxt-doctor/structure/nuxt-major-current";
+const DOCTOR_BUNDLED_NUXT_FLOOR_MAJOR = 4;
+const DOCTOR_BUNDLED_NUXT_FLOOR_MINOR = 4;
+function parseMajorMinor(version) {
+	const match = /^v?(\d+)\.(\d+)/.exec(version.trim());
+	if (!match) return null;
+	return {
+		major: Number(match[1]),
+		minor: Number(match[2])
+	};
+}
+function checkNuxtMajorCurrent(projectInfo) {
+	if (projectInfo.packageJsonPath === null) return [];
+	if (projectInfo.nuxtVersion === null) return [];
+	const parsed = parseMajorMinor(projectInfo.nuxtVersion);
+	if (parsed === null) return [];
+	if (parsed.major !== DOCTOR_BUNDLED_NUXT_FLOOR_MAJOR) return [];
+	if (parsed.minor >= DOCTOR_BUNDLED_NUXT_FLOOR_MINOR) return [];
+	return [{
+		ruleId: RULE_ID$9,
+		file: projectInfo.packageJsonPath,
+		line: 1,
+		column: 1,
+		severity: "info",
+		message: `Nuxt ${projectInfo.nuxtVersion} is older than the doctor-bundled floor (^${DOCTOR_BUNDLED_NUXT_FLOOR_MAJOR}.${DOCTOR_BUNDLED_NUXT_FLOOR_MINOR}.0). Newer minors ship rule-relevant fixes and Nitro improvements.`,
+		recommendation: `Bump "nuxt" to ^${DOCTOR_BUNDLED_NUXT_FLOOR_MAJOR}.${DOCTOR_BUNDLED_NUXT_FLOOR_MINOR}.0 or later in package.json.`
+	}];
+}
+//#endregion
+//#region src/nuxt/post-checks/og-image-via-satori.ts
+const RULE_ID$8 = "nuxt-doctor/cloudflare/og-image-via-satori";
+const OG_IMAGE_MODULES = ["@nuxtjs/og-image", "nuxt-og-image"];
+async function checkOgImageViaSatori(projectInfo) {
+	if (projectInfo.packageJsonPath === null) return [];
+	if (!projectInfo.hasWranglerConfig) return [];
+	const deps = await readDeps(projectInfo.packageJsonPath);
+	if (deps === null) return [];
+	const installed = new Set([...Object.keys(deps.dependencies), ...Object.keys(deps.devDependencies)]);
+	if (OG_IMAGE_MODULES.some((name) => installed.has(name))) return [];
+	return [{
+		ruleId: RULE_ID$8,
+		file: projectInfo.packageJsonPath,
+		line: 1,
+		column: 1,
+		severity: "info",
+		message: "Running on Cloudflare with no OG image module installed; dynamic social images are unconfigured.",
+		recommendation: "Add @nuxtjs/og-image to generate Satori-based OG images that run on Cloudflare Workers."
+	}];
+}
+//#endregion
+//#region src/nuxt/post-checks/preset-defined-for-deploy-target.ts
+const RULE_ID$7 = "nuxt-doctor/nitro/preset-defined-for-deploy-target";
+function checkPresetDefinedForDeployTarget(projectInfo) {
+	if (projectInfo.packageJsonPath === null) return [];
+	if (!projectInfo.hasWranglerConfig) return [];
+	if (projectInfo.nitroPreset !== null) return [];
+	return [{
+		ruleId: RULE_ID$7,
+		file: projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath,
+		line: 1,
+		column: 1,
+		severity: "warn",
+		message: "A wrangler config is present but no Nitro preset is defined for the deploy target.",
+		recommendation: "Set nitro.preset in nuxt.config (e.g. 'cloudflare-module') to match your deploy target."
+	}];
+}
+//#endregion
+//#region src/nuxt/post-checks/recommended-modules-installed.ts
+const RULE_ID$6 = "nuxt-doctor/modules-deps/recommended-modules-installed";
+const RECOMMENDED_GROUPS = [
+	{
+		label: "@nuxt/image",
+		candidates: ["@nuxt/image"]
+	},
+	{
+		label: "@nuxtjs/seo",
+		candidates: ["@nuxtjs/seo", "@nuxtjs/sitemap"]
+	},
+	{
+		label: "@nuxt/fonts",
+		candidates: ["@nuxt/fonts"]
+	}
+];
+async function checkRecommendedModulesInstalled(projectInfo) {
+	if (projectInfo.packageJsonPath === null) return [];
+	const deps = await readDeps(projectInfo.packageJsonPath);
+	if (deps === null) return [];
+	const installed = new Set([...Object.keys(deps.dependencies), ...Object.keys(deps.devDependencies)]);
+	return RECOMMENDED_GROUPS.filter((group) => !group.candidates.some((name) => installed.has(name))).map((group, index) => ({
+		ruleId: RULE_ID$6,
+		file: projectInfo.packageJsonPath,
+		line: index + 1,
+		column: 1,
+		severity: "info",
+		message: `Recommended Nuxt 4 module ${group.label} is not installed.`,
+		recommendation: `Add ${group.label} to dependencies to improve image, SEO, or font handling.`
+	}));
+}
+//#endregion
+//#region src/nuxt/post-checks/runtime-config-typed.ts
+const RULE_ID$5 = "nuxt-doctor/nitro/runtime-config-typed";
+async function hasRuntimeConfigAugmentation(dir) {
+	const entries = await readdir(dir);
+	for (const name of entries) {
+		if (!name.endsWith(".d.ts")) continue;
+		if ((await readFile(join(dir, name), "utf8")).includes("RuntimeConfig")) return true;
+	}
+	return false;
+}
+async function checkRuntimeConfigTyped(projectInfo, nuxtConfig) {
+	if (projectInfo.packageJsonPath === null) return [];
+	if (nuxtConfig?.hasRuntimeConfig !== true) return [];
+	if (await hasRuntimeConfigAugmentation(projectInfo.rootDirectory)) return [];
+	return [{
+		ruleId: RULE_ID$5,
+		file: projectInfo.packageJsonPath,
+		line: 1,
+		column: 1,
+		severity: "info",
+		message: "runtimeConfig is defined but no RuntimeConfig type augmentation was found, so runtime config access is untyped.",
+		recommendation: "Augment 'nuxt/schema' with a RuntimeConfig interface in a .d.ts file to type useRuntimeConfig()."
+	}];
+}
+//#endregion
+//#region src/nuxt/post-checks/uses-app-directory.ts
+const RULE_ID$4 = "nuxt-doctor/structure/uses-app-directory";
+function checkUsesAppDirectory(projectInfo) {
+	if (projectInfo.packageJsonPath === null) return [];
+	if (projectInfo.hasAppDir) return [];
+	return [{
+		ruleId: RULE_ID$4,
+		file: projectInfo.packageJsonPath,
+		line: 1,
+		column: 1,
+		severity: "warn",
+		message: "No app/ directory found. Nuxt 4 expects source under app/ (app/pages, app/components, app/app.vue).",
+		recommendation: "Create an app/ directory and move pages, components, layouts, and app.vue into it."
+	}];
+}
+//#endregion
+//#region src/check-nuxt-project.ts
+async function checkNuxtProject(projectInfo) {
+	if (projectInfo.packageJsonPath === null) return [];
+	if (projectInfo.framework !== "nuxt") return [];
+	const nuxtConfig = await parseNuxtConfig(projectInfo.rootDirectory);
+	return (await Promise.all([
+		Promise.resolve(checkUsesAppDirectory(projectInfo)),
+		Promise.resolve(checkNuxtMajorCurrent(projectInfo)),
+		checkNoModulesIncompatibleWithNuxt4(projectInfo),
+		checkRecommendedModulesInstalled(projectInfo),
+		Promise.resolve(checkCompatibilityDateSet(projectInfo, nuxtConfig)),
+		Promise.resolve(checkPresetDefinedForDeployTarget(projectInfo)),
+		checkRuntimeConfigTyped(projectInfo, nuxtConfig),
+		Promise.resolve(checkLangOnHtml(projectInfo, nuxtConfig)),
+		Promise.resolve(checkNitroCloudflarePreset(projectInfo)),
+		checkOgImageViaSatori(projectInfo),
+		checkNoNodeOnlyModules(projectInfo)
+	])).flat().map((issue) => ({
+		file: issue.file,
+		line: issue.line,
+		column: issue.column,
+		ruleId: issue.ruleId,
+		severity: issue.severity,
+		message: issue.message,
+		source: "project",
+		recommendation: issue.recommendation
+	}));
+}
+//#endregion
 //#region src/disables/parse-directives.ts
 const DIRECTIVE = /doctor-(disable-next-line|disable-line|disable|enable)\b(.*)/;
 function parseRuleList(raw) {
@@ -694,6 +1089,30 @@ async function attachCodeSnippets(diagnostics) {
 	return out;
 }
 //#endregion
+//#region src/project-info/fs-checks.ts
+/**
+* Synchronously reports whether `target` exists and is a directory. Missing
+* paths and non-directory entries both return false rather than throwing.
+*/
+function directoryExists(target) {
+	try {
+		return statSync(target).isDirectory();
+	} catch {
+		return false;
+	}
+}
+/**
+* Returns the absolute path of the first existing candidate file (resolved
+* against `dir`), or null when none of the candidates exist.
+*/
+function resolveExistingFile(dir, candidates) {
+	for (const name of candidates) {
+		const full = join(dir, name);
+		if (existsSync(full)) return full;
+	}
+	return null;
+}
+//#endregion
 //#region src/project-info/path-exists.ts
 async function pathExists(target) {
 	try {
@@ -708,118 +1127,28 @@ async function pathExists(target) {
 async function detectKind(dir) {
 	if (await pathExists(join(dir, "pnpm-workspace.yaml"))) return "pnpm";
 	if ((await readPackageJson(dir))?.workspaces) {
-		if (await pathExists(join(dir, "yarn.lock"))) return "yarn";
-		if (await pathExists(join(dir, "package-lock.json"))) return "npm";
-	}
-	if (await pathExists(join(dir, "turbo.json"))) return "turbo";
-	return null;
-}
-async function findMonorepoRoot(rootDirectory) {
-	let current = rootDirectory;
-	for (;;) {
-		const kind = await detectKind(current);
-		if (kind) return {
-			root: current,
-			kind
-		};
-		const parent = dirname(current);
-		if (parent === current) break;
-		current = parent;
-	}
-	return {
-		root: rootDirectory,
-		kind: null
-	};
-}
-//#endregion
-//#region src/project-info/parse-nuxt-config.ts
-const CONFIG_FILES = [
-	"nuxt.config.ts",
-	"nuxt.config.js",
-	"nuxt.config.mjs"
-];
-async function readConfigSource(dir) {
-	for (const name of CONFIG_FILES) try {
-		return await readFile(join(dir, name), "utf8");
-	} catch {
-		continue;
-	}
-	return null;
-}
-function* objectEntries(obj) {
-	for (const prop of obj.properties) {
-		if (prop.type !== "Property") continue;
-		const key = prop.key;
-		if (key.type !== "Identifier") continue;
-		yield [key.name, prop.value];
-	}
-}
-function findEntry(obj, name) {
-	for (const [key, value] of objectEntries(obj)) if (key === name) return value;
-}
-function stringLiteral(node) {
-	return node.type === "Literal" && typeof node.value === "string" ? node.value : void 0;
-}
-function unwrapDefault(decl) {
-	if (decl.type !== "CallExpression") return decl;
-	const callee = decl.callee;
-	if (callee.type !== "Identifier") return null;
-	if (callee.name !== "defineNuxtConfig") return null;
-	return decl.arguments[0] ?? null;
-}
-function extractConfigObject(source) {
-	const exported = parseSync("nuxt.config.ts", source, {
-		sourceType: "module",
-		lang: "ts"
-	}).program.body.find((n) => n.type === "ExportDefaultDeclaration");
-	if (!exported) return null;
-	const node = unwrapDefault(exported.declaration);
-	if (!node) return null;
-	return node.type === "ObjectExpression" ? node : null;
-}
-function readNitroPreset(value) {
-	if (value.type !== "ObjectExpression") return void 0;
-	const preset = findEntry(value, "preset");
-	return preset ? stringLiteral(preset) : void 0;
-}
-function readImportsAutoImport(value) {
-	if (value.type !== "ObjectExpression") return void 0;
-	const node = findEntry(value, "autoImport");
-	if (node?.type === "Literal" && typeof node.value === "boolean") return node.value;
-}
-function readModules(value) {
-	if (value.type !== "ArrayExpression") return void 0;
-	const out = [];
-	for (const element of value.elements) {
-		if (!element) continue;
-		const str = stringLiteral(element);
-		if (str !== void 0) out.push(str);
-	}
-	return out;
-}
-function readCompatibility(value) {
-	return value.type === "Literal" && typeof value.value === "number" ? value.value : void 0;
+		if (await pathExists(join(dir, "yarn.lock"))) return "yarn";
+		if (await pathExists(join(dir, "package-lock.json"))) return "npm";
+	}
+	if (await pathExists(join(dir, "turbo.json"))) return "turbo";
+	return null;
 }
-async function parseNuxtConfig(dir) {
-	const source = await readConfigSource(dir);
-	if (source === null) return null;
-	const info = {};
-	const config = extractConfigObject(source);
-	if (!config) return info;
-	for (const [key, value] of objectEntries(config)) if (key === "compatibilityVersion") {
-		const compat = readCompatibility(value);
-		if (compat !== void 0) info.compatibilityVersion = compat;
-	} else if (key === "nitro") {
-		const preset = readNitroPreset(value);
-		if (preset !== void 0) info.nitroPreset = preset;
-	} else if (key === "modules") {
-		const modules = readModules(value);
-		if (modules !== void 0) info.modules = modules;
-	} else if (key === "imports") {
-		const autoImport = readImportsAutoImport(value);
-		if (autoImport !== void 0) info.importsAutoImport = autoImport;
+async function findMonorepoRoot(rootDirectory) {
+	let current = rootDirectory;
+	for (;;) {
+		const kind = await detectKind(current);
+		if (kind) return {
+			root: current,
+			kind
+		};
+		const parent = dirname(current);
+		if (parent === current) break;
+		current = parent;
 	}
-	return info;
+	return {
+		root: rootDirectory,
+		kind: null
+	};
 }
 //#endregion
 //#region src/project-info/resolve-dep-version.ts
@@ -877,6 +1206,12 @@ function buildCapabilities(input) {
 	}
 	if (input.nuxtCompatibilityVersion === 4) caps.add("nuxt:4");
 	if (input.nuxtVersion && gte(input.nuxtVersion, "4.4.0")) caps.add("nuxt:4.4");
+	if (input.isNuxtMajor4) caps.add("nuxt4");
+	if (input.hasNuxtConfig) caps.add("nuxt-config");
+	if (input.hasAppDir) caps.add("app-dir");
+	if (input.hasServerDir) caps.add("server-dir");
+	if (input.hasPagesDir) caps.add("pages-dir");
+	if (input.hasWrangler) caps.add("wrangler");
 	if (input.hasAutoImports) caps.add("auto-imports:vue");
 	if (input.hasComponentsAutoImport) caps.add("components:auto");
 	if (input.hasPinia) caps.add("pinia");
@@ -905,6 +1240,41 @@ async function detectProject(rootDirectory) {
 	const hasPinia = hasDependency(pkg, "pinia");
 	const hasVueRouter = hasDependency(pkg, "vue-router") && !isNuxt;
 	const tsconfigExists = await pathExists(join(rootDirectory, "tsconfig.json"));
+	const hasTypescript = hasDependency(pkg, "typescript") || tsconfigExists;
+	const hasWranglerConfig = resolveExistingFile(rootDirectory, [
+		"wrangler.toml",
+		"wrangler.jsonc",
+		"wrangler.json"
+	]) !== null;
+	const nuxtConfigPath = resolveExistingFile(rootDirectory, [
+		"nuxt.config.ts",
+		"nuxt.config.js",
+		"nuxt.config.mjs"
+	]);
+	const appDirPath = join(rootDirectory, "app");
+	const hasAppDir = directoryExists(appDirPath);
+	const hasServerDir = directoryExists(join(rootDirectory, "server"));
+	const hasPagesDir = hasAppDir && directoryExists(join(appDirPath, "pages")) || directoryExists(join(rootDirectory, "pages"));
+	const capabilities = buildCapabilities({
+		framework,
+		vueVersion,
+		nuxtVersion,
+		typescriptVersion,
+		hasTypescript,
+		hasAutoImports,
+		hasComponentsAutoImport,
+		hasPinia,
+		hasVueRouter,
+		nitroPreset,
+		nuxtCompatibilityVersion,
+		monorepoKind,
+		hasWrangler: hasWranglerConfig,
+		isNuxtMajor4: nuxtVersion !== null && major(nuxtVersion) >= 4,
+		hasNuxtConfig: nuxtConfigPath !== null,
+		hasAppDir,
+		hasServerDir,
+		hasPagesDir
+	});
 	return {
 		framework,
 		rootDirectory,
@@ -919,21 +1289,13 @@ async function detectProject(rootDirectory) {
 		nitroPreset,
 		nuxtCompatibilityVersion,
 		monorepoKind,
-		capabilities: buildCapabilities({
-			framework,
-			vueVersion,
-			nuxtVersion,
-			typescriptVersion,
-			hasTypescript: hasDependency(pkg, "typescript") || tsconfigExists,
-			hasAutoImports,
-			hasComponentsAutoImport,
-			hasPinia,
-			hasVueRouter,
-			nitroPreset,
-			nuxtCompatibilityVersion,
-			monorepoKind,
-			hasWrangler: await pathExists(join(rootDirectory, "wrangler.toml")) || await pathExists(join(rootDirectory, "wrangler.jsonc"))
-		})
+		nuxtConfigPath,
+		hasAppDir,
+		appDirPath: hasAppDir ? appDirPath : null,
+		hasServerDir,
+		hasPagesDir,
+		hasWranglerConfig,
+		capabilities
 	};
 }
 //#endregion
@@ -1001,18 +1363,86 @@ function toCanonicalDiagnostics(raws, rootDir) {
 }
 //#endregion
 //#region src/oxlint/generate-config.ts
-const DEFAULT_RULES = {
+const VUE_DEFAULT_RULES = {
 	"vue/no-export-in-script-setup": "error",
 	"vue/require-typed-ref": "warn",
+	"vue/no-arrow-functions-in-watch": "error",
+	"vue/no-deprecated-data-object-declaration": "error",
+	"vue/no-deprecated-events-api": "error",
+	"vue/no-deprecated-destroyed-lifecycle": "error",
+	"vue/no-deprecated-model-definition": "error",
+	"vue/no-deprecated-delete-set": "error",
+	"vue/no-deprecated-vue-config-keycodes": "error",
+	"vue/no-lifecycle-after-await": "error",
+	"vue/no-this-in-before-route-enter": "error",
+	"vue/return-in-computed-property": "error",
+	"vue/valid-define-emits": "error",
+	"vue/valid-define-props": "error",
+	"vue/no-required-prop-with-default": "warn",
+	"vue/prefer-import-from-vue": "warn",
+	"vue/no-import-compiler-macros": "warn",
+	"vue/no-multiple-slot-args": "warn",
+	"vue/require-default-export": "warn",
 	"vue-doctor/no-em-dash-in-string": "warn",
-	"vue-doctor/no-destructure-props-without-to-refs": "error",
-	"vue-doctor/no-destructure-reactive-without-to-refs": "error",
 	"vue-doctor/no-non-null-assertion-on-ref-value": "warn",
 	"vue-doctor/no-imports-from-vue-when-auto-imported": "warn",
 	"vue-doctor/reactivity/watch-without-cleanup": "warn",
 	"vue-doctor/composition/prefer-script-setup-for-new-files": "warn",
 	"vue-doctor/composition/defineProps-typed": "warn"
 };
+const NUXT_PLUGIN_RULES = {
+	"nuxt-doctor/ai-slop/no-process-client-server": "error",
+	"nuxt-doctor/ai-slop/no-explicit-imports-of-auto-imported": "warn",
+	"nuxt-doctor/ai-slop/no-useState-for-server-data": "warn",
+	"nuxt-doctor/ai-slop/no-fetch-in-setup": "warn",
+	"nuxt-doctor/data-fetching/useAsyncData-key-required-in-loop": "error",
+	"nuxt-doctor/server-routes/defineEventHandler-typed": "warn",
+	"nuxt-doctor/server-routes/validate-body-with-h3-v2": "warn",
+	"nuxt-doctor/server-routes/createError-on-failure": "warn",
+	"nuxt-doctor/hydration/no-document-in-setup": "error",
+	"nuxt-doctor/hydration/clientOnly-for-browser-apis": "error"
+};
+const VUE_OXLINT_RULE_IDS = new Set([
+	"vue/no-export-in-script-setup",
+	"vue/require-typed-ref",
+	"vue/no-arrow-functions-in-watch",
+	"vue/no-deprecated-data-object-declaration",
+	"vue/no-deprecated-events-api",
+	"vue/no-deprecated-destroyed-lifecycle",
+	"vue/no-deprecated-model-definition",
+	"vue/no-deprecated-delete-set",
+	"vue/no-deprecated-vue-config-keycodes",
+	"vue/no-lifecycle-after-await",
+	"vue/no-this-in-before-route-enter",
+	"vue/return-in-computed-property",
+	"vue/valid-define-emits",
+	"vue/valid-define-props",
+	"vue/no-required-prop-with-default",
+	"vue/prefer-import-from-vue",
+	"vue/no-import-compiler-macros",
+	"vue/no-multiple-slot-args",
+	"vue/require-default-export",
+	"vue/define-emits-declaration",
+	"vue/define-props-declaration",
+	"vue/define-props-destructuring",
+	"vue/max-props",
+	"vue-doctor/no-em-dash-in-string",
+	"vue-doctor/no-destructure-props-without-to-refs",
+	"vue-doctor/no-destructure-reactive-without-to-refs",
+	"vue-doctor/no-non-null-assertion-on-ref-value",
+	"vue-doctor/no-imports-from-vue-when-auto-imported",
+	"vue-doctor/reactivity/watch-without-cleanup",
+	"vue-doctor/reactivity/prefer-shallowRef-for-large-data",
+	"vue-doctor/reactivity/prefer-readonly-for-injected",
+	"vue-doctor/composition/prefer-script-setup-for-new-files",
+	"vue-doctor/composition/defineProps-typed",
+	"vue-doctor/performance/prefer-defineAsyncComponent-on-route"
+]);
+const NUXT_OXLINT_RULE_IDS = new Set(Object.keys(NUXT_PLUGIN_RULES));
+function oxlintRuleAllowlist(framework) {
+	if (framework !== "nuxt") return VUE_OXLINT_RULE_IDS;
+	return new Set([...VUE_OXLINT_RULE_IDS, ...NUXT_OXLINT_RULE_IDS]);
+}
 function toOxlintSeverity(s) {
 	if (s === "error") return "error";
 	return "warn";
@@ -1040,9 +1470,19 @@ function resolveUserConfig(rootDir) {
 }
 async function generateOxlintConfig(input) {
 	const { dir, removeDir } = await resolveCacheDir(input.rootDir);
-	const merged = { ...DEFAULT_RULES };
-	if (input.ruleOverrides) for (const [id, sev] of Object.entries(input.ruleOverrides)) if (sev === "off") delete merged[id];
-	else merged[id] = sev;
+	const framework = input.framework === "nuxt" ? "nuxt" : "vue";
+	const allowlist = oxlintRuleAllowlist(framework);
+	let defaults = { ...VUE_DEFAULT_RULES };
+	if (framework === "nuxt") defaults = {
+		...defaults,
+		...NUXT_PLUGIN_RULES
+	};
+	const merged = { ...defaults };
+	if (input.ruleOverrides) for (const [id, sev] of Object.entries(input.ruleOverrides)) {
+		if (!allowlist.has(id)) continue;
+		if (sev === "off") delete merged[id];
+		else merged[id] = sev;
+	}
 	const rules = {};
 	for (const [id, sev] of Object.entries(merged)) rules[id] = toOxlintSeverity(sev);
 	const userConfig = resolveUserConfig(input.rootDir);
@@ -1050,7 +1490,7 @@ async function generateOxlintConfig(input) {
 		$schema: "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
 		...userConfig ? { extends: [userConfig] } : {},
 		plugins: ["vue"],
-		jsPlugins: [input.pluginPath],
+		jsPlugins: input.pluginPaths,
 		rules
 	};
 	const configPath = join(dir, ".oxlintrc.json");
@@ -1107,11 +1547,24 @@ function resolveVueDoctorPluginPath(fromDir) {
 	}
 	const selfMain = resolveFromSelf("@geoql/oxlint-plugin-vue-doctor");
 	if (selfMain) return selfMain;
-	return throwResolveError(fromDir);
+	return throwVueResolveError(fromDir);
+}
+function resolveNuxtDoctorPluginPath(fromDir) {
+	const pkgJson = lookUpwards(fromDir, "node_modules/@geoql/oxlint-plugin-nuxt-doctor/package.json");
+	if (pkgJson) {
+		const main = readPkgMain(pkgJson) ?? "./dist/index.js";
+		return resolve(dirname(pkgJson), main);
+	}
+	const selfMain = resolveFromSelf("@geoql/oxlint-plugin-nuxt-doctor");
+	if (selfMain) return selfMain;
+	return throwNuxtResolveError(fromDir);
 }
-function throwResolveError(fromDir) {
+function throwVueResolveError(fromDir) {
 	throw new Error(`Failed to resolve @geoql/oxlint-plugin-vue-doctor from ${fromDir}. Install it as a dependency of your project or use the bundled @geoql/vue-doctor CLI.`);
 }
+function throwNuxtResolveError(fromDir) {
+	throw new Error(`Failed to resolve @geoql/oxlint-plugin-nuxt-doctor from ${fromDir}. Install it as a dependency of your project or use the bundled @geoql/nuxt-doctor CLI.`);
+}
 function resolveOxlintBin(fromDir) {
 	const pkgJson = lookUpwards(fromDir, "node_modules/oxlint/package.json");
 	if (pkgJson) return resolve(dirname(pkgJson), "bin/oxlint");
@@ -1147,9 +1600,10 @@ async function runOxlint(opts) {
 			"-c",
 			opts.configPath,
 			"--format",
-			"json",
-			opts.targetPath
+			"json"
 		];
+		if (opts.fix) args.push("--fix");
+		args.push(opts.targetPath);
 		const child = spawn(opts.oxlintBin, args, {
 			cwd: opts.rootDir,
 			stdio: [
@@ -1234,12 +1688,16 @@ function parseNdjson(text) {
 //#endregion
 //#region src/oxlint/run.ts
 async function runScriptPass(opts) {
-	const pluginPath = resolveVueDoctorPluginPath(opts.rootDir);
+	const vuePluginPath = resolveVueDoctorPluginPath(opts.rootDir);
 	const oxlintBin = resolveOxlintBin(opts.rootDir);
+	let pluginPaths;
+	if (opts.framework === "nuxt") pluginPaths = [resolveNuxtDoctorPluginPath(opts.rootDir), vuePluginPath];
+	else pluginPaths = [vuePluginPath];
 	const { configPath, cleanup } = await generateOxlintConfig({
-		pluginPath,
+		pluginPaths,
 		ruleOverrides: opts.ruleOverrides,
-		rootDir: opts.rootDir
+		rootDir: opts.rootDir,
+		framework: opts.framework
 	});
 	try {
 		const raw = await runOxlint({
@@ -1247,7 +1705,8 @@ async function runScriptPass(opts) {
 			targetPath: opts.targetPath,
 			configPath,
 			oxlintBin,
-			timeoutMs: opts.timeoutMs
+			timeoutMs: opts.timeoutMs,
+			fix: opts.fix
 		});
 		return {
 			diagnostics: toCanonicalDiagnostics(raw.diagnostics, opts.rootDir),
@@ -1330,9 +1789,9 @@ async function parseSfcDescriptor(absPath) {
 }
 //#endregion
 //#region src/sfc/rules/no-mixed-options-and-composition-api.ts
-const RULE_ID = "vue-doctor/sfc/no-mixed-options-and-composition-api";
-const MESSAGE = "Mixed Options API in a <script setup> SFC. Move data/methods/computed/watch/lifecycle into <script setup> Composition API; keep <script> only for options like name/inheritAttrs. See https://vuejs.org/api/sfc-script-setup.html#usage-alongside-normal-script";
-const RECOMMENDATION = "Move this option into the <script setup> block using the Composition API, or keep <script> only for options-only config such as name or inheritAttrs.";
+const RULE_ID$3 = "vue-doctor/sfc/no-mixed-options-and-composition-api";
+const MESSAGE$3 = "Mixed Options API in a <script setup> SFC. Move data/methods/computed/watch/lifecycle into <script setup> Composition API; keep <script> only for options like name/inheritAttrs. See https://vuejs.org/api/sfc-script-setup.html#usage-alongside-normal-script";
+const RECOMMENDATION$3 = "Move this option into the <script setup> block using the Composition API, or keep <script> only for options-only config such as name or inheritAttrs.";
 const DISALLOWED = new Set([
 	"data",
 	"methods",
@@ -1399,7 +1858,7 @@ function locate(content, offset, startLine, startColumn) {
 		column
 	};
 }
-function check$6(ctx) {
+function check$9(ctx) {
 	const { script, scriptSetup } = ctx.descriptor;
 	if (!script || !scriptSetup) return { diagnostics: [] };
 	const lang = script.lang === "ts" ? "ts" : "js";
@@ -1419,35 +1878,241 @@ function check$6(ctx) {
 			file: ctx.file,
 			line,
 			column,
-			ruleId: RULE_ID,
+			ruleId: RULE_ID$3,
 			severity: "error",
-			message: MESSAGE,
+			message: MESSAGE$3,
 			source: "sfc",
-			recommendation: RECOMMENDATION
+			recommendation: RECOMMENDATION$3
 		});
 	}
 	return { diagnostics };
 }
 //#endregion
+//#region src/nuxt/file-role.ts
+const PAGE_DIR = /^(?:app\/)?pages\//;
+const LAYOUT_DIR = /^(?:app\/)?layouts\//;
+function normalize(relPath) {
+	return relPath.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+/**
+* True when the path points at a Nuxt page component — a `.vue` file under
+* `pages/` (Nuxt 3 layout) or `app/pages/` (Nuxt 4 layout) at the project root.
+*/
+function isNuxtPageFile(relPath) {
+	const path = normalize(relPath);
+	return PAGE_DIR.test(path) && path.endsWith(".vue");
+}
+/**
+* True when the path points at a Nitro server file — a `.ts` file under the
+* project-root `server/` directory.
+*/
+function isNuxtServerFile(relPath) {
+	const path = normalize(relPath);
+	return path.startsWith("server/") && path.endsWith(".ts");
+}
+/**
+* True when the path points at a Nuxt layout component — a `.vue` file under
+* `layouts/` (Nuxt 3 layout) or `app/layouts/` (Nuxt 4 layout) at the project
+* root.
+*/
+function isNuxtLayoutFile(relPath) {
+	const path = normalize(relPath);
+	return LAYOUT_DIR.test(path) && path.endsWith(".vue");
+}
+//#endregion
+//#region src/template/walk.ts
+const NODE_ELEMENT$2 = 1;
+function isElementNode(node) {
+	return node !== null && node !== void 0 && node.type === NODE_ELEMENT$2;
+}
+function walkElements(root, visit) {
+	const stack = [...root.children];
+	while (stack.length > 0) {
+		const node = stack.pop();
+		if (!node) continue;
+		if (isElementNode(node)) {
+			visit(node);
+			if (node.children) for (const child of node.children) stack.push(child);
+		}
+	}
+}
+//#endregion
+//#region src/sfc/rules/nuxt/no-mixed-app-and-root-layout.ts
+const RULE_ID$2 = "nuxt-doctor/ai-slop/no-mixed-app-and-root-layout";
+const MESSAGE$2 = "Layout file renders<NuxtLayout> inside itself. This creates a nested layout chain where the root layout renders itself as a slot. Use<slot /> directly and let the page content flow through.";
+const RECOMMENDATION$2 = "Replace <NuxtLayout> in this layout file with <slot />. The layout slot is already provided by the parent layout wrapper.";
+function check$8(ctx) {
+	if (!isNuxtLayoutFile(ctx.relativePath)) return { diagnostics: [] };
+	const { template } = ctx.descriptor;
+	if (!template || !template.ast) return { diagnostics: [] };
+	let foundNuxtLayout = false;
+	let nuxtLayoutNode;
+	walkElements(template.ast, (el) => {
+		if (el.tag === "NuxtLayout") {
+			foundNuxtLayout = true;
+			nuxtLayoutNode = el;
+		}
+	});
+	if (!foundNuxtLayout) return { diagnostics: [] };
+	const node = nuxtLayoutNode;
+	return { diagnostics: [{
+		file: ctx.file,
+		line: node.loc.start.line,
+		column: node.loc.start.column,
+		endLine: node.loc.end.line,
+		endColumn: node.loc.end.column,
+		ruleId: RULE_ID$2,
+		severity: "warn",
+		message: MESSAGE$2,
+		source: "sfc",
+		recommendation: RECOMMENDATION$2
+	}] };
+}
+//#endregion
+//#region src/sfc/rules/nuxt/og-image-defined.ts
+const RULE_ID$1 = "nuxt-doctor/seo/og-image-defined";
+const MESSAGE$1 = "Page uses SEO meta but has no og:image property. Open Graph images improve social sharing previews. Add an og:image value or install @nuxtjs/og-image for automatic OG images.";
+const RECOMMENDATION$1 = "Add ogImage: \"/path/to/image.png\" to useSeoMeta / useHead, or install @nuxtjs/og-image.";
+function hasOgImageInCall(program) {
+	for (const stmt of program.body) {
+		if (stmt.type !== "ExpressionStatement") continue;
+		const call = stmt.expression;
+		if (call.type !== "CallExpression") continue;
+		if (call.callee.type !== "Identifier") continue;
+		const name = call.callee.name;
+		if (name !== "useSeoMeta" && name !== "useHead") continue;
+		const firstArg = call.arguments[0];
+		if (!firstArg || firstArg.type !== "ObjectExpression") continue;
+		for (const prop of firstArg.properties) {
+			if (prop.type !== "Property") continue;
+			if (prop.key.type === "Identifier" && prop.key.name === "ogImage") return true;
+			if (prop.key.type === "Literal" && prop.key.value === "og:image") return true;
+		}
+	}
+	return false;
+}
+function hasOgImageDep(packageJsonPath) {
+	try {
+		const raw = readFileSync(packageJsonPath, "utf8");
+		const pkg = JSON.parse(raw);
+		const deps = {
+			...pkg.dependencies,
+			...pkg.devDependencies
+		};
+		return "@nuxtjs/og-image" in deps || "nuxt-og-image" in deps;
+	} catch {
+		return false;
+	}
+}
+function check$7(ctx) {
+	if (!isNuxtPageFile(ctx.relativePath)) return { diagnostics: [] };
+	const { scriptSetup } = ctx.descriptor;
+	if (!scriptSetup) return { diagnostics: [] };
+	const lang = scriptSetup.lang === "ts" ? "ts" : "js";
+	const { program } = parseSync(`script.${lang}`, scriptSetup.content, {
+		sourceType: "module",
+		lang
+	});
+	if (hasOgImageInCall(program)) return { diagnostics: [] };
+	if (ctx.projectInfo.packageJsonPath === null) return { diagnostics: [] };
+	if (hasOgImageDep(ctx.projectInfo.packageJsonPath)) return { diagnostics: [] };
+	const { line, column } = scriptSetup.loc.start;
+	return { diagnostics: [{
+		file: ctx.file,
+		line,
+		column,
+		ruleId: RULE_ID$1,
+		severity: "warn",
+		message: MESSAGE$1,
+		source: "sfc",
+		recommendation: RECOMMENDATION$1
+	}] };
+}
+//#endregion
+//#region src/sfc/rules/nuxt/use-seo-meta-on-public-page.ts
+const RULE_ID = "nuxt-doctor/seo/useSeoMeta-on-public-page";
+const MESSAGE = "Public page component is missing SEO metadata. Add useSeoMeta, useHead, or definePageMeta with a title so search engines can index it properly.";
+const RECOMMENDATION = "Call useSeoMeta({ title: \"...\" }) in<script setup> to define page title and meta tags for search engines and social previews.";
+function hasTitleInCall(program) {
+	for (const stmt of program.body) {
+		if (stmt.type !== "ExpressionStatement") continue;
+		const call = stmt.expression;
+		if (call.type !== "CallExpression") continue;
+		if (call.callee.type !== "Identifier") continue;
+		const name = call.callee.name;
+		if (name !== "useSeoMeta" && name !== "useHead" && name !== "definePageMeta") continue;
+		const firstArg = call.arguments[0];
+		if (!firstArg || firstArg.type !== "ObjectExpression") continue;
+		for (const prop of firstArg.properties) {
+			if (prop.type !== "Property") continue;
+			if (prop.key.type === "Identifier" && prop.key.name === "title") return true;
+			if (prop.key.type === "Literal" && prop.key.value === "title") return true;
+		}
+	}
+	return false;
+}
+function check$6(ctx) {
+	if (!isNuxtPageFile(ctx.relativePath)) return { diagnostics: [] };
+	const { scriptSetup } = ctx.descriptor;
+	if (!scriptSetup) return { diagnostics: [] };
+	const lang = scriptSetup.lang === "ts" ? "ts" : "js";
+	const { program } = parseSync(`script.${lang}`, scriptSetup.content, {
+		sourceType: "module",
+		lang
+	});
+	if (hasTitleInCall(program)) return { diagnostics: [] };
+	const { line, column } = scriptSetup.loc.start;
+	return { diagnostics: [{
+		file: ctx.file,
+		line,
+		column,
+		ruleId: RULE_ID,
+		severity: "warn",
+		message: MESSAGE,
+		source: "sfc",
+		recommendation: RECOMMENDATION
+	}] };
+}
+//#endregion
 //#region src/sfc/rules/index.ts
-const SFC_RULES = [{
-	id: "vue-doctor/sfc/no-mixed-options-and-composition-api",
-	check: check$6
-}];
+const SFC_RULES = [
+	{
+		id: "vue-doctor/sfc/no-mixed-options-and-composition-api",
+		check: check$9
+	},
+	{
+		id: "nuxt-doctor/seo/useSeoMeta-on-public-page",
+		check: check$6
+	},
+	{
+		id: "nuxt-doctor/seo/og-image-defined",
+		check: check$7
+	},
+	{
+		id: "nuxt-doctor/ai-slop/no-mixed-app-and-root-layout",
+		check: check$8
+	}
+];
 //#endregion
 //#region src/sfc/run.ts
 async function runSfcPass(opts) {
 	const all = [];
+	const { projectInfo } = opts;
+	const rootDir = projectInfo?.rootDirectory ?? process.cwd();
 	for (const file of opts.files) {
 		if (!file.endsWith(".vue")) continue;
 		const descriptor = await parseSfcDescriptor(file);
 		if (!descriptor) continue;
+		const relativePath = relative(rootDir, file).replace(/\\/g, "/");
 		for (const rule of SFC_RULES) {
 			const override = opts.ruleOverrides?.[rule.id];
 			if (override === "off") continue;
 			const { diagnostics } = rule.check({
 				file,
-				descriptor
+				descriptor,
+				rootDirectory: rootDir,
+				relativePath,
+				projectInfo
 			});
 			for (const d of diagnostics) all.push(override ? {
 				...d,
@@ -1458,6 +2123,183 @@ async function runSfcPass(opts) {
 	return all;
 }
 //#endregion
+//#region src/nuxt/cross-file/run.ts
+function extractDataFetchingKeys(content, lang) {
+	const keys = [];
+	try {
+		const { program } = parseSync(`script.${lang}`, content, {
+			sourceType: "module",
+			lang
+		});
+		for (const stmt of program.body) if (stmt.type === "VariableDeclaration") for (const decl of stmt.declarations) {
+			const call = unwrapAwait(decl.init);
+			if (call?.type !== "CallExpression") continue;
+			extractKeyFromCall(call, keys);
+		}
+		else if (stmt.type === "ExpressionStatement") {
+			const expr = unwrapAwait(stmt.expression);
+			if (expr?.type === "CallExpression") extractKeyFromCall(expr, keys);
+		}
+	} catch {}
+	return keys;
+}
+function unwrapAwait(node) {
+	if (node?.type === "AwaitExpression") return node.argument;
+	return node;
+}
+function extractKeyFromCall(call, keys) {
+	if (call.callee.type !== "Identifier") return;
+	const fnName = call.callee.name;
+	if (fnName !== "useAsyncData" && fnName !== "useFetch") return;
+	const keyArg = call.arguments[0];
+	if (keyArg?.type === "Literal" && typeof keyArg.value === "string") keys.push(keyArg.value);
+	else if (keyArg?.type === "TemplateLiteral" && keyArg.quasis.length === 1) {
+		const val = keyArg.quasis[0]?.value?.raw;
+		if (val) keys.push(val);
+	}
+	if (fnName === "useFetch" && call.arguments.length >= 2) {
+		const optsArg = call.arguments[1];
+		if (optsArg?.type === "ObjectExpression") {
+			for (const prop of optsArg.properties) if (prop.type === "Property" && prop.key.type === "Identifier" && prop.key.name === "key" && prop.value.type === "Literal" && typeof prop.value.value === "string") keys.push(prop.value.value);
+		}
+	}
+}
+async function runCrossFilePass(opts) {
+	const { files, projectInfo } = opts;
+	if (projectInfo.framework !== "nuxt") return [];
+	const rootDir = projectInfo.rootDirectory;
+	const pageFiles = files.filter((f) => isNuxtPageFile(relative(rootDir, f).replace(/\\/g, "/")));
+	if (pageFiles.length === 0) return [];
+	const parsed = [];
+	for (const file of pageFiles) {
+		const descriptor = await parseSfcDescriptor(file);
+		if (!descriptor) continue;
+		const { scriptSetup } = descriptor;
+		if (!scriptSetup) continue;
+		parsed.push({
+			file,
+			relativePath: relative(rootDir, file).replace(/\\/g, "/"),
+			keys: extractDataFetchingKeys(scriptSetup.content, scriptSetup.lang === "ts" ? "ts" : "js"),
+			scriptSetupContent: scriptSetup.content,
+			scriptSetupLang: scriptSetup.lang === "ts" ? "ts" : "js",
+			scriptSetupLine: scriptSetup.loc.start.line
+		});
+	}
+	return runCrossFileRules(parsed);
+}
+function runCrossFileRules(pages) {
+	const all = [];
+	all.push(...ruleNoSharedKeyAcrossPages(pages));
+	all.push(...ruleSsrSafeOnMountedOnlyForClient(pages));
+	return all;
+}
+function ruleNoSharedKeyAcrossPages(pages) {
+	const keyToFiles = /* @__PURE__ */ new Map();
+	for (const page of pages) for (const key of page.keys) {
+		const existing = keyToFiles.get(key) ?? [];
+		if (!existing.includes(page.file)) existing.push(page.file);
+		keyToFiles.set(key, existing);
+	}
+	const diags = [];
+	for (const [key, files] of keyToFiles) {
+		if (files.length < 2) continue;
+		for (const file of files) diags.push({
+			file,
+			line: 1,
+			column: 1,
+			ruleId: "nuxt-doctor/data-fetching/no-shared-key-across-pages",
+			severity: "warn",
+			message: `Data fetching key "${key}" is shared across ${files.length} different page files. This causes cache collisions in useAsyncData/useFetch. Use a unique key per page.`,
+			source: "cross-file",
+			recommendation: `Rename the key to something page-specific, e.g. "page-${key}" or "users-${key}".`
+		});
+	}
+	return diags;
+}
+const BROWSER_GLOBALS = new Set([
+	"window",
+	"document",
+	"navigator",
+	"localStorage",
+	"sessionStorage",
+	"location",
+	"history",
+	"fetch",
+	"XMLHttpRequest",
+	"matchMedia",
+	"IntersectionObserver",
+	"MutationObserver",
+	"indexedDB",
+	"webkit",
+	"moz",
+	"onmessage"
+]);
+function ruleSsrSafeOnMountedOnlyForClient(pages) {
+	const diags = [];
+	for (const page of pages) {
+		const { program } = parseSync(`script.${page.scriptSetupLang}`, page.scriptSetupContent, {
+			sourceType: "module",
+			lang: page.scriptSetupLang
+		});
+		for (const stmt of program.body) if (stmt.type === "VariableDeclaration") for (const decl of stmt.declarations) {
+			const init = decl.init;
+			if (!init) continue;
+			if (init.type === "CallExpression") {
+				const call = init;
+				if (isSkippedReactiveCall(call)) continue;
+				checkCallForBrowserGlobal(call, page, diags);
+			} else if (init.type === "MemberExpression") checkMemberForBrowserGlobal(init, page, diags);
+		}
+		else if (stmt.type === "ExpressionStatement") {
+			const expr = stmt.expression;
+			if (expr.type === "CallExpression") {
+				if (isSkippedReactiveCall(expr)) continue;
+				checkCallForBrowserGlobal(expr, page, diags);
+			} else if (expr.type === "MemberExpression") checkMemberForBrowserGlobal(expr, page, diags);
+		}
+	}
+	return diags;
+}
+const CLIENT_SAFE_WRAPPERS = new Set([
+	"onMounted",
+	"watchEffect",
+	"watch"
+]);
+function isSkippedReactiveCall(call) {
+	if (call.callee.type !== "Identifier") return false;
+	return CLIENT_SAFE_WRAPPERS.has(call.callee.name);
+}
+function checkCallForBrowserGlobal(call, page, diags) {
+	const callee = call.callee;
+	if (callee.type !== "MemberExpression") return;
+	const obj = callee.object;
+	if (obj.type !== "Identifier" || !BROWSER_GLOBALS.has(obj.name)) return;
+	diags.push({
+		file: page.file,
+		line: page.scriptSetupLine,
+		column: 1,
+		ruleId: "nuxt-doctor/data-fetching/ssr-safe-onMounted-only-for-client",
+		severity: "warn",
+		message: `Browser global "${obj.name}" is accessed at setup top-level outside onMounted. This causes SSR/hydration mismatches. Move browser-only code inside onMounted or a client-only plugin.`,
+		source: "cross-file",
+		recommendation: `Wrap "${obj.name}" access in onMounted(() => { /* code */ }) or use defineNuxtPlugin to run only on the client.`
+	});
+}
+function checkMemberForBrowserGlobal(mem, page, diags) {
+	const obj = mem.object;
+	if (obj.type !== "Identifier" || !BROWSER_GLOBALS.has(obj.name)) return;
+	diags.push({
+		file: page.file,
+		line: page.scriptSetupLine,
+		column: 1,
+		ruleId: "nuxt-doctor/data-fetching/ssr-safe-onMounted-only-for-client",
+		severity: "warn",
+		message: `Browser global "${obj.name}" is accessed at setup top-level outside onMounted. This causes SSR/hydration mismatches. Move browser-only code inside onMounted or a client-only plugin.`,
+		source: "cross-file",
+		recommendation: `Wrap "${obj.name}" access in onMounted(() => { /* code */ }) or use defineNuxtPlugin to run only on the client.`
+	});
+}
+//#endregion
 //#region src/template/parse-sfc.ts
 const cache = /* @__PURE__ */ new Map();
 async function parseSfc(absPath) {
@@ -1495,23 +2337,6 @@ function findStaticAttr(el, attrName) {
 	for (const prop of el.props) if (prop.type === 6 && prop.name === attrName) return prop;
 }
 //#endregion
-//#region src/template/walk.ts
-const NODE_ELEMENT$2 = 1;
-function isElementNode(node) {
-	return node !== null && node !== void 0 && node.type === NODE_ELEMENT$2;
-}
-function walkElements(root, visit) {
-	const stack = [...root.children];
-	while (stack.length > 0) {
-		const node = stack.pop();
-		if (!node) continue;
-		if (isElementNode(node)) {
-			visit(node);
-			if (node.children) for (const child of node.children) stack.push(child);
-		}
-	}
-}
-//#endregion
 //#region src/template/rules/v-for-has-key.ts
 function check$5(ctx) {
 	const diagnostics = [];
@@ -1830,6 +2655,7 @@ async function audit(config = {}) {
 		exclude
 	});
 	const overallStart = performance.now();
+	const project = await detectProject(rootDir);
 	const templateStart = performance.now();
 	const templateDiagnostics = lintEnabled ? await runTemplatePass({
 		files,
@@ -1839,7 +2665,8 @@ async function audit(config = {}) {
 	const sfcStart = performance.now();
 	const sfcDiagnostics = lintEnabled ? await runSfcPass({
 		files,
-		ruleOverrides: config.rules
+		ruleOverrides: config.rules,
+		projectInfo: project
 	}) : [];
 	const sfcElapsed = performance.now() - sfcStart;
 	let scriptDiagnostics = [];
@@ -1849,7 +2676,10 @@ async function audit(config = {}) {
 		const result = await runScriptPass({
 			rootDir,
 			targetPath: rootDir,
-			ruleOverrides: config.rules
+			ruleOverrides: config.rules,
+			framework: project.framework === "nuxt" ? "nuxt" : "vue",
+			fix: config.fix === true && config.scopeFiles === void 0,
+			fixExcludes: config.fixExcludes
 		});
 		scriptDiagnostics = result.diagnostics;
 		oxlintStderr = result.stderr;
@@ -1858,13 +2688,12 @@ async function audit(config = {}) {
 		if (process.env.DOCTOR_DEBUG) process.stderr.write(`[doctor-core] script pass failed: ${oxlintStderr}\n`);
 	}
 	const scriptElapsed = performance.now() - scriptStart;
-	const project = await detectProject(rootDir);
 	let deadCodeDiagnostics = [];
 	let deadCodeElapsed = 0;
 	if (config.deadCode !== false) {
 		const deadCodeStart = performance.now();
 		try {
-			const { loadDoctorConfig } = await import("./load-DiK7Zv0B.js").then((n) => n.n);
+			const { loadDoctorConfig } = await import("./load-yXDi-5ti.js").then((n) => n.n);
 			deadCodeDiagnostics = dedupeDeadCodeAgainstLint(await checkDeadCode({
 				projectInfo: project,
 				doctorConfig: await loadDoctorConfig(rootDir),
@@ -1897,6 +2726,29 @@ async function audit(config = {}) {
 			} : d;
 		});
 	} catch {}
+	let nuxtProjectDiagnostics = [];
+	if (project.framework === "nuxt") try {
+		nuxtProjectDiagnostics = (await checkNuxtProject(project)).filter((d) => config.rules?.[d.ruleId] !== "off").map((d) => {
+			const override = config.rules?.[d.ruleId];
+			return override ? {
+				...d,
+				severity: override
+			} : d;
+		});
+	} catch {}
+	let crossFileDiagnostics = [];
+	if (project.framework === "nuxt") try {
+		crossFileDiagnostics = (await runCrossFilePass({
+			files,
+			projectInfo: project
+		})).filter((d) => config.rules?.[d.ruleId] !== "off").map((d) => {
+			const override = config.rules?.[d.ruleId];
+			return override ? {
+				...d,
+				severity: override
+			} : d;
+		});
+	} catch {}
 	const elapsedMs = performance.now() - overallStart;
 	const timings = {
 		template: templateElapsed,
@@ -1905,7 +2757,7 @@ async function audit(config = {}) {
 		deadCode: deadCodeElapsed,
 		total: elapsedMs
 	};
-	let afterDisables = applyInlineDisables(mergeDiagnostics(templateDiagnostics, sfcDiagnostics, scriptDiagnostics, deadCodeDiagnostics, buildQualityDiagnostics, depsDiagnostics), { respect: config.respectInlineDisables !== false });
+	let afterDisables = applyInlineDisables(mergeDiagnostics(templateDiagnostics, sfcDiagnostics, scriptDiagnostics, deadCodeDiagnostics, buildQualityDiagnostics, depsDiagnostics, nuxtProjectDiagnostics, crossFileDiagnostics), { respect: config.respectInlineDisables !== false });
 	if (config.scopeFiles) {
 		const scope = new Set(config.scopeFiles.map((f) => resolve(rootDir, f)));
 		afterDisables = afterDisables.filter((d) => scope.has(resolve(rootDir, d.file)));
@@ -1960,7 +2812,111 @@ function mergeCliOverrides(resolved, cli) {
 		threshold: cli.threshold ?? resolved.threshold,
 		rules,
 		source: resolved.source,
-		configFile: resolved.configFile
+		configFile: resolved.configFile,
+		...cli.fixExcludes ?? resolved.fixExcludes ? { fixExcludes: cli.fixExcludes ?? resolved.fixExcludes } : {}
+	};
+}
+//#endregion
+//#region src/init/index.ts
+function parseExcludeList(raw) {
+	if (!raw) return void 0;
+	const parts = raw.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+	return parts.length > 0 ? parts : void 0;
+}
+function normalizeInitAnswers(raw) {
+	return {
+		configFormat: raw.target ?? "ts",
+		preset: raw.preset ?? "recommended",
+		threshold: typeof raw.threshold === "number" ? raw.threshold : void 0,
+		exclude: parseExcludeList(raw.exclude)
+	};
+}
+function frameworkLabel(project) {
+	if (project.framework === "nuxt") return `Nuxt ${project.nuxtVersion ?? "unknown"}`;
+	if (project.framework === "vue") return `Vue ${project.vueVersion ?? "unknown"}`;
+	return "unknown project";
+}
+function renderDetectSummary(project, sfcCount) {
+	const ts = project.capabilities.has("typescript") ? " · TS" : "";
+	const noun = sfcCount === 1 ? "SFC" : "SFCs";
+	return `detected: ${frameworkLabel(project)}${ts} · ${sfcCount} ${noun}`;
+}
+async function detectSummary(dir) {
+	return renderDetectSummary(await detectProject(dir), (await listSourceFiles({
+		rootDir: dir,
+		include: ["**/*.vue"],
+		exclude: ["**/node_modules/**"]
+	})).length);
+}
+function buildUserConfig(options) {
+	const config = { preset: options.preset };
+	if (options.threshold !== void 0) config.threshold = options.threshold;
+	if (options.exclude && options.exclude.length > 0) config.exclude = options.exclude;
+	return config;
+}
+function renderTsConfig(options) {
+	const config = buildUserConfig(options);
+	const lines = [
+		"import { defineConfig } from '@geoql/doctor-core';",
+		"",
+		"export default defineConfig({",
+		`  preset: '${config.preset}',`
+	];
+	if (config.threshold !== void 0) lines.push(`  threshold: ${config.threshold},`);
+	if (config.exclude) {
+		const globs = config.exclude.map((glob) => `'${glob}'`).join(", ");
+		lines.push(`  exclude: [${globs}],`);
+	}
+	lines.push("});");
+	return `${lines.join("\n")}\n`;
+}
+function renderJsonConfig(options) {
+	return `${JSON.stringify(buildUserConfig(options), null, 2)}\n`;
+}
+async function readPackageJsonRaw(path) {
+	try {
+		return JSON.parse(await readFile(path, "utf8"));
+	} catch {
+		return null;
+	}
+}
+async function planInit(options) {
+	const writes = [];
+	const packageJsonPath = join(options.dir, "package.json");
+	const pkg = { ...await readPackageJsonRaw(packageJsonPath) ?? {} };
+	let conflict = false;
+	let conflictPath = null;
+	if (options.configFormat === "package-json") {
+		if (pkg.doctor !== void 0) {
+			conflict = true;
+			conflictPath = packageJsonPath;
+		}
+		pkg.doctor = buildUserConfig(options);
+	} else {
+		const fileName = options.configFormat === "ts" ? "doctor.config.ts" : "doctor.config.json";
+		const configPath = join(options.dir, fileName);
+		if (await pathExists(configPath)) {
+			conflict = true;
+			conflictPath = configPath;
+		}
+		const content = options.configFormat === "ts" ? renderTsConfig(options) : renderJsonConfig(options);
+		writes.push({
+			path: configPath,
+			content
+		});
+	}
+	pkg.scripts = {
+		...pkg.scripts ?? {},
+		"doctor:check": options.binName
+	};
+	writes.push({
+		path: packageJsonPath,
+		content: `${JSON.stringify(pkg, null, 2)}\n`
+	});
+	return {
+		writes,
+		conflict,
+		conflictPath
 	};
 }
 //#endregion
@@ -2007,6 +2963,47 @@ async function listChangedFiles(options) {
 	return [...new Set(absolute)].sort();
 }
 //#endregion
+//#region src/project-info/list-workspace-packages.ts
+function parsePackageGlobs(yaml) {
+	const globs = [];
+	let inPackages = false;
+	for (const raw of yaml.split("\n")) {
+		if (!inPackages) {
+			if (/^packages:/.test(raw)) inPackages = true;
+			continue;
+		}
+		const item = raw.match(/^\s*-\s*(.+?)\s*$/);
+		if (item) {
+			globs.push(item[1].replace(/^['"]|['"]$/g, ""));
+			continue;
+		}
+		if (raw.trim() === "") continue;
+		break;
+	}
+	return globs;
+}
+async function listWorkspacePackages(rootDir) {
+	const { root, kind } = await findMonorepoRoot(rootDir);
+	if (kind !== "pnpm") return [];
+	const manifests = await glob(parsePackageGlobs(await readFile(join(root, "pnpm-workspace.yaml"), "utf8")).map((g) => `${g}/package.json`), {
+		cwd: root,
+		absolute: true,
+		onlyFiles: true,
+		dot: false
+	});
+	const packages = [];
+	for (const manifest of manifests) {
+		const dir = dirname(manifest);
+		const pkg = await readPackageJson(dir);
+		if (pkg?.name) packages.push({
+			name: pkg.name,
+			dir
+		});
+	}
+	packages.sort((a, b) => a.name.localeCompare(b.name));
+	return packages;
+}
+//#endregion
 //#region src/reporters/docs-url.ts
 function docsUrl(ruleId) {
 	return `https://docs.doctor.geoql.in/rules/${ruleId}`;
@@ -2371,6 +3368,53 @@ function jsonCompactReport(input) {
 	return `${JSON.stringify(buildDoctorReport(input))}\n`;
 }
 //#endregion
+//#region src/reporters/pr-comment.ts
+const DOCS_BASE = "https://docs.doctor.geoql.in/rules/";
+const MAX_PER_SECTION = 5;
+function binName(toolName) {
+	return toolName.replace("@geoql/", "");
+}
+function relativeLocation(diag, rootDirectory) {
+	return `${relative(rootDirectory, diag.file).replaceAll("\\", "/")}:${diag.line}`;
+}
+function findingLine(diag, rootDirectory) {
+	return `- \`${relativeLocation(diag, rootDirectory)}\` ${diag.ruleId} — ${diag.message}`;
+}
+function sortBySeverityFilter(diagnostics, severity, rootDirectory) {
+	return diagnostics.filter((d) => d.severity === severity).sort((a, b) => {
+		const byFile = compareStrings(relative(rootDirectory, a.file).replaceAll("\\", "/"), relative(rootDirectory, b.file).replaceAll("\\", "/"));
+		if (byFile !== 0) return byFile;
+		if (a.line !== b.line) return a.line - b.line;
+		if (a.column !== b.column) return a.column - b.column;
+		return compareStrings(a.ruleId, b.ruleId);
+	});
+}
+function section(title, diagnostics, rootDirectory) {
+	if (diagnostics.length === 0) return [];
+	const lines = ["", `### ${title}`];
+	for (const d of diagnostics.slice(0, MAX_PER_SECTION)) lines.push(findingLine(d, rootDirectory));
+	return lines;
+}
+function prCommentReport(input) {
+	const score = input.score.score;
+	const header = `## 🛡 ${input.toolName} — Score: ${score}`;
+	const errors = sortBySeverityFilter(input.diagnostics, "error", input.rootDirectory);
+	const warnings = sortBySeverityFilter(input.diagnostics, "warn", input.rootDirectory);
+	const actionable = errors.length + warnings.length;
+	if (actionable === 0) return `${header}\n\n✓ No actionable findings. Score: ${score}\n`;
+	const topRule = (errors[0] ?? warnings[0]).ruleId;
+	return `${[
+		header,
+		"",
+		`**${actionable} findings** (${errors.length} errors, ${warnings.length} warnings)`,
+		...section("Errors", errors, input.rootDirectory),
+		...section("Warnings", warnings, input.rootDirectory),
+		"",
+		"---",
+		`[View the docs](${DOCS_BASE}) · Run \`${binName(input.toolName)} explain ${topRule}\` for details.`
+	].join("\n")}\n`;
+}
+//#endregion
 //#region src/reporters/pretty.ts
 const colors = pc.createColors(true);
 const colorTheme = {
@@ -2421,9 +3465,10 @@ function format(input, kind = "agent", options) {
 	if (kind === "json-compact") return jsonCompactReport(input);
 	if (kind === "sarif") return sarifReport(input);
 	if (kind === "html") return htmlReport(input);
+	if (kind === "pr-comment") return prCommentReport(input);
 	return agentReport(input, options);
 }
 //#endregion
-export { BUILT_IN_RECOMMENDED, ConfigCycleError, ConfigFileNotFoundError, DOCTOR_REPORT_SCHEMA_VERSION, DeadCodeImportFailed, DeadCodeTimeoutError, InvalidConfigError, OxlintOutputTooLarge, OxlintSpawnFailed, RULE_REGISTRY, agentReport, applyInlineDisables, audit, buildDoctorReport, checkBuildQuality, checkDeadCode, checkDeps, dedupeDeadCodeAgainstLint, defineConfig, detectProject, docsUrl, encodeAnnotation, encodeAnnotations, format, jsonCompactReport, jsonReport, listChangedFiles, listRules, loadAllRuleDocs, loadDoctorConfig, loadRuleDoc, mergeCliOverrides, parseDirectives, prettyReport, renderVerboseTrace, sarifReport, scoreDiagnostics, validateConfig };
+export { BUILT_IN_RECOMMENDED, ConfigCycleError, ConfigFileNotFoundError, DOCTOR_REPORT_SCHEMA_VERSION, DeadCodeImportFailed, DeadCodeTimeoutError, InvalidConfigError, OxlintOutputTooLarge, OxlintSpawnFailed, RULE_REGISTRY, agentReport, applyInlineDisables, audit, buildDoctorReport, checkBuildQuality, checkDeadCode, checkDeps, checkNuxtProject, dedupeDeadCodeAgainstLint, defineConfig, detectProject, detectSummary, docsUrl, encodeAnnotation, encodeAnnotations, findMonorepoRoot, format, isNuxtLayoutFile, isNuxtPageFile, isNuxtServerFile, jsonCompactReport, jsonReport, listChangedFiles, listRules, listWorkspacePackages, loadAllRuleDocs, loadDoctorConfig, loadRuleDoc, mergeCliOverrides, normalizeInitAnswers, parseDirectives, parseExcludeList, planInit, prCommentReport, prettyReport, renderDetectSummary, renderVerboseTrace, runCrossFilePass, sarifReport, scoreDiagnostics, validateConfig };
 
 //# sourceMappingURL=index.js.map