@geoql/doctor-core 1.3.3 → 1.4.1

package/dist/index.js

@@ -12,8 +12,8 @@ import { fileURLToPath } from "node:url";
 import { babelParse, parse } from "@vue/compiler-sfc";
 import { loadConfig } from "c12";
 import { z } from "zod";
-import { promisify } from "node:util";
 import process$1 from "node:process";
+import { promisify } from "node:util";
 import pc from "picocolors";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
@@ -337,7 +337,7 @@ async function buildKnipConfig(projectInfo, doctorConfig) {
 			"!**/knip.config.mjs"
 		],
 		ignoreFiles: [...doctorConfig.exclude, "knip.config.mjs"],
-		ignoreDependencies: [...new Set([
+		ignoreDependencies: [.../* @__PURE__ */ new Set([
 			"vite-plus",
 			"@geoql/vue-doctor",
 			"@geoql/nuxt-doctor",
@@ -808,9 +808,10 @@ const RULE_ID$17 = "nuxt-doctor/nitro/compatibilityDate-set";
 function checkCompatibilityDateSet(projectInfo, nuxtConfig) {
 	if (projectInfo.packageJsonPath === null) return [];
 	if (nuxtConfig?.compatibilityDate !== void 0) return [];
+	const file = projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath;
 	return [{
 		ruleId: RULE_ID$17,
-		file: projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath,
+		file,
 		line: 1,
 		column: 1,
 		severity: "error",
@@ -824,9 +825,10 @@ const RULE_ID$16 = "nuxt-doctor/seo/lang-on-html";
 function checkLangOnHtml(projectInfo, nuxtConfig) {
 	if (projectInfo.packageJsonPath === null) return [];
 	if (nuxtConfig?.htmlLang !== void 0) return [];
+	const file = projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath;
 	return [{
 		ruleId: RULE_ID$16,
-		file: projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath,
+		file,
 		line: 1,
 		column: 1,
 		severity: "warn",
@@ -837,7 +839,7 @@ function checkLangOnHtml(projectInfo, nuxtConfig) {
 //#endregion
 //#region src/nuxt/post-checks/nitro-cloudflare-preset.ts
 const RULE_ID$15 = "nuxt-doctor/cloudflare/nitro-cloudflare-preset";
-const CLOUDFLARE_PRESETS = new Set([
+const CLOUDFLARE_PRESETS = /* @__PURE__ */ new Set([
 	"cloudflare-pages",
 	"cloudflare-module",
 	"cloudflare"
@@ -847,9 +849,10 @@ function checkNitroCloudflarePreset(projectInfo) {
 	if (!projectInfo.hasWranglerConfig) return [];
 	if (projectInfo.nitroPreset === null) return [];
 	if (CLOUDFLARE_PRESETS.has(projectInfo.nitroPreset)) return [];
+	const file = projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath;
 	return [{
 		ruleId: RULE_ID$15,
-		file: projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath,
+		file,
 		line: 1,
 		column: 1,
 		severity: "warn",
@@ -860,7 +863,7 @@ function checkNitroCloudflarePreset(projectInfo) {
 //#endregion
 //#region src/nuxt/post-checks/no-modules-incompatible-with-nuxt-4.ts
 const RULE_ID$14 = "nuxt-doctor/modules-deps/no-modules-incompatible-with-nuxt-4";
-const INCOMPATIBLE_MODULES = new Set([
+const INCOMPATIBLE_MODULES = /* @__PURE__ */ new Set([
 	"@nuxtjs/composition-api",
 	"@nuxt/bridge",
 	"nuxt-property-decorator"
@@ -884,7 +887,7 @@ async function checkNoModulesIncompatibleWithNuxt4(projectInfo) {
 //#endregion
 //#region src/nuxt/post-checks/no-node-only-modules.ts
 const RULE_ID$13 = "nuxt-doctor/cloudflare/no-node-only-modules";
-const NODE_ONLY_MODULES = new Set(["fs-extra", "sharp"]);
+const NODE_ONLY_MODULES = /* @__PURE__ */ new Set(["fs-extra", "sharp"]);
 async function checkNoNodeOnlyModules(projectInfo) {
 	if (projectInfo.packageJsonPath === null) return [];
 	if (!projectInfo.hasWranglerConfig) return [];
@@ -1030,7 +1033,7 @@ async function checkOgImageViaSatori(projectInfo) {
 	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)]);
+	const installed = /* @__PURE__ */ new Set([...Object.keys(deps.dependencies), ...Object.keys(deps.devDependencies)]);
 	if (OG_IMAGE_MODULES.some((name) => installed.has(name))) return [];
 	return [{
 		ruleId: RULE_ID$10,
@@ -1049,9 +1052,10 @@ function checkPresetDefinedForDeployTarget(projectInfo) {
 	if (projectInfo.packageJsonPath === null) return [];
 	if (!projectInfo.hasWranglerConfig) return [];
 	if (projectInfo.nitroPreset !== null) return [];
+	const file = projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath;
 	return [{
 		ruleId: RULE_ID$9,
-		file: projectInfo.nuxtConfigPath ?? projectInfo.packageJsonPath,
+		file,
 		line: 1,
 		column: 1,
 		severity: "warn",
@@ -1080,7 +1084,7 @@ 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)]);
+	const installed = /* @__PURE__ */ 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$8,
 		file: projectInfo.packageJsonPath,
@@ -1462,6 +1466,7 @@ async function detectProject(rootDirectory) {
 	});
 	return {
 		framework,
+		frameworkDetected: framework === "vue" || framework === "nuxt",
 		rootDirectory,
 		packageJsonPath,
 		vueVersion,
@@ -1592,7 +1597,7 @@ const NUXT_PLUGIN_RULES = {
 	"nuxt-doctor/hydration/clientOnly-for-browser-apis": "error",
 	"nuxt-doctor/security/no-user-input-in-fetch-url": "warn"
 };
-const VUE_OXLINT_RULE_IDS = new Set([
+const VUE_OXLINT_RULE_IDS = /* @__PURE__ */ new Set([
 	"vue/no-export-in-script-setup",
 	"vue/require-typed-ref",
 	"vue/no-arrow-functions-in-watch",
@@ -1640,7 +1645,7 @@ const VUE_OXLINT_RULE_IDS = new Set([
 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]);
+	return /* @__PURE__ */ new Set([...VUE_OXLINT_RULE_IDS, ...NUXT_OXLINT_RULE_IDS]);
 }
 function toOxlintSeverity(s) {
 	if (s === "error") return "error";
@@ -1819,12 +1824,24 @@ async function runOxlint(opts) {
 		let timer;
 		const timeoutMs = opts.timeoutMs ?? 6e4;
 		const maxOutputBytes = opts.maxOutputBytes ?? 33554432;
+		const onAbort = () => {
+			child.kill("SIGKILL");
+			finish(() => reject(/* @__PURE__ */ new Error("oxlint subprocess aborted")));
+		};
 		const finish = (fn) => {
 			if (settled) return;
 			settled = true;
 			if (timer) clearTimeout(timer);
+			opts.signal?.removeEventListener("abort", onAbort);
 			fn();
 		};
+		if (opts.signal) {
+			if (opts.signal.aborted) {
+				onAbort();
+				return;
+			}
+			opts.signal.addEventListener("abort", onAbort, { once: true });
+		}
 		if (timeoutMs > 0) timer = setTimeout(() => {
 			child.kill("SIGKILL");
 			finish(() => reject(/* @__PURE__ */ new Error(`oxlint subprocess timed out after ${timeoutMs}ms`)));
@@ -1906,7 +1923,8 @@ async function runScriptPass(opts) {
 			configPath,
 			oxlintBin,
 			timeoutMs: opts.timeoutMs,
-			fix: opts.fix
+			fix: opts.fix,
+			signal: opts.signal
 		});
 		return {
 			diagnostics: toCanonicalDiagnostics(raw.diagnostics, opts.rootDir),
@@ -2819,7 +2837,7 @@ async function parseSfcDescriptor(absPath) {
 const RULE_ID$5 = "vue-doctor/sfc/no-mixed-options-and-composition-api";
 const MESSAGE$5 = "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$5 = "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([
+const DISALLOWED = /* @__PURE__ */ new Set([
 	"data",
 	"methods",
 	"computed",
@@ -3000,7 +3018,7 @@ function check$20(ctx) {
 const RULE_ID$3 = "nuxt-doctor/seo/og-image-defined";
 const MESSAGE$3 = "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$3 = "Add ogImage: \"/path/to/image.png\" to useSeoMeta / useHead, or install @nuxtjs/og-image.";
-const SEO_PRIMITIVES$1 = new Set(["useSeoMeta", "useHead"]);
+const SEO_PRIMITIVES$1 = /* @__PURE__ */ new Set(["useSeoMeta", "useHead"]);
 function isSeoWrapperName$1(name) {
 	if (SEO_PRIMITIVES$1.has(name)) return false;
 	return /^use[a-z]*seo/i.test(name);
@@ -3066,7 +3084,7 @@ function check$19(ctx) {
 const RULE_ID$2 = "nuxt-doctor/seo/useSeoMeta-on-public-page";
 const MESSAGE$2 = "Public page component is missing SEO metadata. Add useSeoMeta, useHead, or definePageMeta with a title so search engines can index it properly.";
 const RECOMMENDATION$2 = "Call useSeoMeta({ title: \"...\" }) in<script setup> to define page title and meta tags for search engines and social previews.";
-const SEO_PRIMITIVES = new Set([
+const SEO_PRIMITIVES = /* @__PURE__ */ new Set([
 	"useSeoMeta",
 	"useHead",
 	"definePageMeta"
@@ -3259,7 +3277,7 @@ function ruleNoSharedKeyAcrossPages(pages) {
 	}
 	return diags;
 }
-const BROWSER_GLOBALS = new Set([
+const BROWSER_GLOBALS = /* @__PURE__ */ new Set([
 	"window",
 	"document",
 	"navigator",
@@ -3303,7 +3321,7 @@ function ruleSsrSafeOnMountedOnlyForClient(pages) {
 	}
 	return diags;
 }
-const CLIENT_SAFE_WRAPPERS = new Set([
+const CLIENT_SAFE_WRAPPERS = /* @__PURE__ */ new Set([
 	"onMounted",
 	"watchEffect",
 	"watch"
@@ -3739,7 +3757,7 @@ function check$8(ctx) {
 //#endregion
 //#region src/template/rules/no-javascript-uri.ts
 const NODE_ATTRIBUTE$1 = 6;
-const URI_SINKS = new Set([
+const URI_SINKS = /* @__PURE__ */ new Set([
 	"href",
 	"src",
 	"srcset",
@@ -3972,7 +3990,7 @@ function check$2(ctx) {
 }
 //#endregion
 //#region src/template/rules/no-missing-alt.ts
-const IMAGE_TAGS = new Set([
+const IMAGE_TAGS = /* @__PURE__ */ new Set([
 	"img",
 	"NuxtImg",
 	"nuxt-img"
@@ -4200,24 +4218,36 @@ async function audit(config = {}) {
 		exclude
 	});
 	const overallStart = performance.now();
+	const maxDurationMs = config.maxDurationMs;
+	const deadlineMs = maxDurationMs ?? 0;
+	const budgetExhausted = () => maxDurationMs !== void 0 && performance.now() - overallStart >= maxDurationMs;
+	const skippedPasses = [];
+	const deadlineController = new AbortController();
+	let deadlineTimer;
+	if (maxDurationMs !== void 0) deadlineTimer = setTimeout(() => deadlineController.abort(), maxDurationMs);
 	const project = await detectProject(rootDir);
 	const templateStart = performance.now();
-	const templateDiagnostics = lintEnabled ? await runTemplatePass({
+	let templateDiagnostics = [];
+	if (lintEnabled) if (budgetExhausted()) skippedPasses.push("template");
+	else templateDiagnostics = await runTemplatePass({
 		files,
 		ruleOverrides: config.rules
-	}) : [];
+	});
 	const templateElapsed = performance.now() - templateStart;
 	const sfcStart = performance.now();
-	const sfcDiagnostics = lintEnabled ? await runSfcPass({
+	let sfcDiagnostics = [];
+	if (lintEnabled) if (budgetExhausted()) skippedPasses.push("sfc");
+	else sfcDiagnostics = await runSfcPass({
 		files,
 		ruleOverrides: config.rules,
 		projectInfo: project
-	}) : [];
+	});
 	const sfcElapsed = performance.now() - sfcStart;
 	let scriptDiagnostics = [];
 	let oxlintStderr = "";
 	const scriptStart = performance.now();
-	if (lintEnabled) try {
+	if (lintEnabled) if (budgetExhausted()) skippedPasses.push("lint");
+	else try {
 		const result = await runScriptPass({
 			rootDir,
 			targetPath: rootDir,
@@ -4225,18 +4255,26 @@ async function audit(config = {}) {
 			framework: project.framework === "nuxt" ? "nuxt" : "vue",
 			fix: config.fix === true && config.scopeFiles === void 0,
 			fixExcludes: config.fixExcludes,
-			exclude
+			exclude,
+			signal: deadlineController.signal
 		});
 		scriptDiagnostics = result.diagnostics;
 		oxlintStderr = result.stderr;
 	} catch (err) {
-		oxlintStderr = err instanceof Error ? err.message : String(err);
-		if (process.env.DOCTOR_DEBUG) process.stderr.write(`[doctor-core] script pass failed: ${oxlintStderr}\n`);
+		if (deadlineController.signal.aborted) {
+			skippedPasses.push("lint");
+			oxlintStderr = "aborted: time-budget exhausted";
+		} else {
+			oxlintStderr = err instanceof Error ? err.message : String(err);
+			if (process.env.DOCTOR_DEBUG) process.stderr.write(`[doctor-core] script pass failed: ${oxlintStderr}\n`);
+		}
 	}
 	const scriptElapsed = performance.now() - scriptStart;
 	let deadCodeDiagnostics = [];
 	let deadCodeElapsed = 0;
-	if (config.deadCode !== false) {
+	const deadCodeEnabled = config.deadCode !== false && !budgetExhausted();
+	if (config.deadCode !== false && !deadCodeEnabled) skippedPasses.push("dead-code");
+	if (deadCodeEnabled) {
 		const deadCodeStart = performance.now();
 		try {
 			const { loadDoctorConfig } = await Promise.resolve().then(() => load_exports);
@@ -4255,48 +4293,54 @@ async function audit(config = {}) {
 		deadCodeElapsed = performance.now() - deadCodeStart;
 	}
 	let buildQualityDiagnostics = [];
-	try {
-		buildQualityDiagnostics = (await checkBuildQuality(project)).filter((d) => config.rules?.[d.ruleId] !== "off").map((d) => {
-			const override = config.rules?.[d.ruleId];
-			return override ? {
-				...d,
-				severity: override
-			} : d;
-		});
-	} catch {}
 	let depsDiagnostics = [];
-	try {
-		depsDiagnostics = (await checkDeps(project)).filter((d) => config.rules?.[d.ruleId] !== "off").map((d) => {
-			const override = config.rules?.[d.ruleId];
-			return override ? {
-				...d,
-				severity: override
-			} : 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 {}
+	if (budgetExhausted()) skippedPasses.push("project");
+	else {
+		try {
+			buildQualityDiagnostics = (await checkBuildQuality(project)).filter((d) => config.rules?.[d.ruleId] !== "off").map((d) => {
+				const override = config.rules?.[d.ruleId];
+				return override ? {
+					...d,
+					severity: override
+				} : d;
+			});
+		} catch {}
+		try {
+			depsDiagnostics = (await checkDeps(project)).filter((d) => config.rules?.[d.ruleId] !== "off").map((d) => {
+				const override = config.rules?.[d.ruleId];
+				return override ? {
+					...d,
+					severity: override
+				} : d;
+			});
+		} catch {}
+		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 {}
+			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 {}
+		}
+	}
+	if (deadlineTimer) clearTimeout(deadlineTimer);
 	const elapsedMs = performance.now() - overallStart;
 	const timings = {
 		template: templateElapsed,
@@ -4315,6 +4359,7 @@ async function audit(config = {}) {
 	const ruleCounts = countRuleCounts(diagnostics);
 	const projectInfo = {
 		framework: project.framework,
+		frameworkDetected: project.frameworkDetected,
 		vueVersion: project.vueVersion,
 		nuxtVersion: project.nuxtVersion,
 		capabilities: [...project.capabilities].sort(),
@@ -4325,6 +4370,13 @@ async function audit(config = {}) {
 	else if (failOn !== "none") {
 		if ((failOn === "warn" ? scored.errorCount + scored.warnCount : scored.errorCount) > 0) exitCode = 1;
 	}
+	const incomplete = skippedPasses.length > 0;
+	const skippedCheckReasons = incomplete ? [{
+		kind: "time-budget-exhausted",
+		deadlineMs,
+		elapsedMs,
+		skippedPasses
+	}] : void 0;
 	return {
 		rootDir,
 		filesScanned: files.length,
@@ -4338,7 +4390,9 @@ async function audit(config = {}) {
 		projectInfo,
 		elapsedMs,
 		timings,
-		ruleCounts
+		ruleCounts,
+		incomplete,
+		...skippedCheckReasons ? { skippedCheckReasons } : {}
 	};
 }
 //#endregion
@@ -4564,7 +4618,8 @@ async function loadDoctorConfig(rootDir, explicitPathOrOptions) {
 		source = "flag";
 		configFile = resolve(rootDir, explicitPath);
 	} else if (result._configFile) {
-		source = SOURCE_MAP[extname(result._configFile).slice(1)];
+		const ext = extname(result._configFile).slice(1);
+		source = SOURCE_MAP[ext];
 		configFile = result._configFile;
 	} else if (Object.keys(raw).length > 0) {
 		source = "package.json";
@@ -4719,6 +4774,146 @@ async function planInit(options) {
 	};
 }
 //#endregion
+//#region src/ci/provider-detect.ts
+/**
+* Detects the CI provider from an explicit env snapshot. Takes the env as an
+* argument (instead of reading process.env) so provider detection stays a
+* deterministic, fully-testable pure function.
+*/
+function detectCiProvider(env) {
+	if (env.GITHUB_ACTIONS === "true") return "github";
+	if (env.GITLAB_CI === "true") return "gitlab";
+	return "unknown";
+}
+//#endregion
+//#region src/ci/scaffold-workflow.ts
+function renderGithubWorkflow(opts) {
+	return `name: doctor
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Run doctor
+        uses: geoql/doctor-action@v2
+        with:
+          framework: ${opts.framework}
+          preset: recommended
+          threshold: '0'
+          fail-on: error
+          pr-comment: '${opts.prComment}'
+          api-key: \${{ secrets.DOCTOR_API_KEY }}
+          project: \${{ github.repository }}
+`;
+}
+function renderGithubPrWorkflow(opts) {
+	return `name: doctor-pr
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Doctor PR review
+        uses: geoql/doctor-action@v2
+        with:
+          framework: ${opts.framework}
+          preset: recommended
+          fail-on: error
+          diff: 'true'
+          pr-comment: 'true'
+          comment-mode: both
+          api-key: \${{ secrets.DOCTOR_API_KEY }}
+          project: \${{ github.repository }}
+`;
+}
+function renderGitlabPipeline(opts) {
+	return `# Doctor quality gate — https://docs.the-doctor.report
+doctor:
+  image: node:24
+  stage: test
+  script:
+    - npx -y @geoql/${opts.bin}@latest --fail-on error
+  rules:
+    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
+    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
+`;
+}
+async function scaffoldCiWorkflow(opts) {
+	const requested = opts.provider ?? "auto";
+	let provider;
+	if (requested === "auto") provider = detectCiProvider(opts.env ?? process$1.env) === "gitlab" ? "gitlab" : "github";
+	else provider = requested;
+	const writes = [];
+	let conflict = false;
+	let conflictPath = null;
+	if (provider === "gitlab") {
+		const pipelinePath = join(opts.dir, ".gitlab-ci.yml");
+		if (!opts.force && await pathExists(pipelinePath)) {
+			conflict = true;
+			conflictPath = pipelinePath;
+		} else writes.push({
+			path: pipelinePath,
+			content: renderGitlabPipeline({ bin: opts.bin })
+		});
+		return {
+			writes,
+			conflict,
+			conflictPath,
+			provider
+		};
+	}
+	const workflowPath = join(opts.dir, ".github", "workflows", "doctor.yml");
+	if (!opts.force && await pathExists(workflowPath)) {
+		conflict = true;
+		conflictPath = workflowPath;
+		return {
+			writes,
+			conflict,
+			conflictPath,
+			provider
+		};
+	}
+	writes.push({
+		path: workflowPath,
+		content: renderGithubWorkflow({
+			framework: opts.framework,
+			prComment: opts.noComments !== true
+		})
+	});
+	if (opts.pr === true) writes.push({
+		path: join(opts.dir, ".github", "workflows", "doctor-pr.yml"),
+		content: renderGithubPrWorkflow({ framework: opts.framework })
+	});
+	return {
+		writes,
+		conflict,
+		conflictPath,
+		provider
+	};
+}
+//#endregion
 //#region src/git-scope.ts
 const execFileAsync = promisify(execFile);
 const SOURCE_EXTENSIONS = [
@@ -5119,6 +5314,7 @@ function buildDoctorReport(input) {
 		},
 		projectInfo: {
 			framework: input.projectInfo.framework,
+			frameworkDetected: input.projectInfo.frameworkDetected,
 			vueVersion: input.projectInfo.vueVersion,
 			nuxtVersion: input.projectInfo.nuxtVersion,
 			capabilities: [...input.projectInfo.capabilities].sort(),
@@ -5162,7 +5358,16 @@ function buildDoctorReport(input) {
 		timing: {
 			elapsedMs: input.elapsedMs,
 			analyzedFileCount: input.analyzedFileCount
-		}
+		},
+		...input.incomplete !== void 0 && input.incomplete ? {
+			incomplete: input.incomplete,
+			skippedCheckReasons: input.skippedCheckReasons?.map((r) => ({
+				kind: r.kind,
+				deadlineMs: r.deadlineMs,
+				elapsedMs: r.elapsedMs,
+				skippedPasses: [...r.skippedPasses]
+			}))
+		} : {}
 	};
 }
 function jsonReport(input) {
@@ -5643,6 +5848,6 @@ async function pushFindings(opts) {
 	}
 }
 //#endregion
-export { BUILT_IN_RECOMMENDED, ConfigCycleError, ConfigFileNotFoundError, DOCTOR_REPORT_SCHEMA_VERSION, DeadCodeImportFailed, DeadCodeTimeoutError, DoctorUserConfigSchema, InvalidConfigError, LevelSchema, OxlintOutputTooLarge, OxlintSpawnFailed, RULE_REGISTRY, RuleEntrySchema, SCORE_DIMENSIONS, agentReport, applyInlineDisables, audit, buildDoctorReport, buildJsonSchema, buildPushPayload, categoriesForDimension, checkBuildQuality, checkDeadCode, checkDeps, checkNuxtProject, dedupeDeadCodeAgainstLint, defineConfig, detectProject, detectSummary, dimensionForCategory, docsUrl, encodeAnnotation, encodeAnnotations, filterReportByRules, filterRuleIdsByCategory, findMonorepoRoot, format, isNuxtLayoutFile, isNuxtPageFile, isNuxtServerFile, isScoreDimension, jsonCompactReport, jsonReport, listChangedFiles, listRules, listWorkspacePackages, loadAllRuleDocs, loadDoctorConfig, loadRuleDoc, mergeCliOverrides, normalizeInitAnswers, parseDirectives, parseExcludeList, planInit, prCommentReport, prettyReport, pushFindings, renderAgentPlaybook, renderDetectSummary, renderRulePrompt, renderVerboseTrace, resolveCategoryScope, runCrossFilePass, sarifReport, scoreDiagnostics, stripFindings, validateConfig };
+export { BUILT_IN_RECOMMENDED, ConfigCycleError, ConfigFileNotFoundError, DOCTOR_REPORT_SCHEMA_VERSION, DeadCodeImportFailed, DeadCodeTimeoutError, DoctorUserConfigSchema, InvalidConfigError, LevelSchema, OxlintOutputTooLarge, OxlintSpawnFailed, RULE_REGISTRY, RuleEntrySchema, SCORE_DIMENSIONS, agentReport, applyInlineDisables, audit, buildDoctorReport, buildJsonSchema, buildPushPayload, categoriesForDimension, checkBuildQuality, checkDeadCode, checkDeps, checkNuxtProject, dedupeDeadCodeAgainstLint, defineConfig, detectCiProvider, detectProject, detectSummary, dimensionForCategory, docsUrl, encodeAnnotation, encodeAnnotations, filterReportByRules, filterRuleIdsByCategory, findMonorepoRoot, format, isNuxtLayoutFile, isNuxtPageFile, isNuxtServerFile, isScoreDimension, jsonCompactReport, jsonReport, listChangedFiles, listRules, listWorkspacePackages, loadAllRuleDocs, loadDoctorConfig, loadRuleDoc, mergeCliOverrides, normalizeInitAnswers, parseDirectives, parseExcludeList, planInit, prCommentReport, prettyReport, pushFindings, renderAgentPlaybook, renderDetectSummary, renderRulePrompt, renderVerboseTrace, resolveCategoryScope, runCrossFilePass, sarifReport, scaffoldCiWorkflow, scoreDiagnostics, stripFindings, validateConfig };
 
 //# sourceMappingURL=index.js.map