react-doctor 0.9.12-dev.ffc2d14 → 0.9.13-dev.1239043

package/dist/sanitize-runtime-url-Bbq40iIp.js

@@ -0,0 +1,76 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="39fe62ec-70de-53ef-9168-84e5123b75a2")}catch(e){}}();
+import { z as CliInputError } from "./record-metric-B6T_Ej33.js";
+//#region src/cli/runtime-scan/constants.ts
+const RUNTIME_SCAN_MAX_COMPONENT_EVENTS = 2e3;
+const RUNTIME_SCAN_MAX_SNAPSHOT_PAYLOAD_BYTES = 5 * 1024 * 1024;
+const RUNTIME_SCAN_MAX_SNAPSHOT_BYTES = RUNTIME_SCAN_MAX_SNAPSHOT_PAYLOAD_BYTES - 64 * 1024;
+Math.floor(RUNTIME_SCAN_MAX_SNAPSHOT_BYTES / 3);
+const RUNTIME_SCAN_MAX_TRACE_BYTES = 512 * 1024 * 1024;
+const RUNTIME_SCAN_MAX_STRING_LENGTH = 4096;
+const RUNTIME_SCAN_LAYOUT_THRASH_RATIO = .25;
+const RUNTIME_SCAN_MAX_RECORDING_DURATION_MS = 300 * 1e3;
+const RUNTIME_SCAN_SNAPSHOT_TIMEOUT_MS = 1e4;
+const RUNTIME_SCAN_LOCAL_DEV_PORTS = [
+	1234,
+	...Array.from({ length: 11 }, (_unusedValue, portOffset) => 3e3 + portOffset),
+	...Array.from({ length: 11 }, (_unusedValue, portOffset) => 4e3 + portOffset),
+	4173,
+	4200,
+	4321,
+	...Array.from({ length: 11 }, (_unusedValue, portOffset) => 5e3 + portOffset),
+	...Array.from({ length: 11 }, (_unusedValue, portOffset) => 5173 + portOffset),
+	...Array.from({ length: 11 }, (_unusedValue, portOffset) => 8e3 + portOffset),
+	...Array.from({ length: 11 }, (_unusedValue, portOffset) => 8080 + portOffset),
+	8888
+];
+const RUNTIME_SCAN_BROWSER_WIDTH_PX = 1440;
+const RUNTIME_SCAN_TRACE_FILE_EXTENSION = ".json.gz";
+const RUNTIME_SCAN_TRACING_COMPLETE_TIMEOUT_MS = 6e4;
+const RUNTIME_SCAN_PROBE_RELATIVE_PATH = "runtime-scan/browser-probe.iife.js";
+const RUNTIME_SCAN_PROBE_SNAPSHOT_BINDING_NAME_PLACEHOLDER = "__REACT_DOCTOR_RUNTIME_SCAN_CAPTURE__";
+const RUNTIME_SCAN_PROBE_SNAPSHOT_ATTRIBUTE_NAME_PLACEHOLDER = "data-react-doctor-runtime-scan-snapshot";
+const RUNTIME_SCAN_PROBE_SNAPSHOT_TOKEN_PLACEHOLDER = "__REACT_DOCTOR_RUNTIME_SCAN_TOKEN__";
+const RUNTIME_SCAN_SAFE_CDP_PAGE_URLS = [
+	"about:blank",
+	"chrome://newtab/",
+	"chrome://new-tab-page/"
+];
+const RUNTIME_SCAN_CONTROL_CHARACTERS_PATTERN = /[\u0000-\u001f\u007f-\u009f]/g;
+const RUNTIME_SCAN_TRACE_CATEGORIES = [
+	"-*",
+	"blink.console",
+	"blink.user_timing",
+	"devtools.timeline",
+	"disabled-by-default-devtools.timeline",
+	"disabled-by-default-devtools.timeline.invalidationTracking",
+	"disabled-by-default-devtools.timeline.frame",
+	"disabled-by-default-devtools.timeline.stack",
+	"disabled-by-default-v8.cpu_profiler",
+	"disabled-by-default-v8.cpu_profiler.hires",
+	"latencyInfo",
+	"loading",
+	"v8",
+	"v8.execute"
+];
+//#endregion
+//#region src/cli/runtime-scan/sanitize-runtime-url.ts
+const sanitizeRuntimeUrl = (rawUrl) => {
+	let parsedUrl;
+	try {
+		parsedUrl = new URL(rawUrl);
+	} catch {
+		throw new CliInputError(`Expected an absolute http(s) URL, received "${rawUrl}".`);
+	}
+	if (parsedUrl.protocol !== "http:" && parsedUrl.protocol !== "https:") throw new CliInputError(`Expected an http(s) URL, received "${parsedUrl.protocol}".`);
+	parsedUrl.username = "";
+	parsedUrl.password = "";
+	parsedUrl.search = "";
+	parsedUrl.hash = "";
+	return parsedUrl.href;
+};
+//#endregion
+export { RUNTIME_SCAN_SNAPSHOT_TIMEOUT_MS as _, RUNTIME_SCAN_LOCAL_DEV_PORTS as a, RUNTIME_SCAN_TRACING_COMPLETE_TIMEOUT_MS as b, RUNTIME_SCAN_MAX_SNAPSHOT_BYTES as c, RUNTIME_SCAN_MAX_TRACE_BYTES as d, RUNTIME_SCAN_PROBE_RELATIVE_PATH as f, RUNTIME_SCAN_SAFE_CDP_PAGE_URLS as g, RUNTIME_SCAN_PROBE_SNAPSHOT_TOKEN_PLACEHOLDER as h, RUNTIME_SCAN_LAYOUT_THRASH_RATIO as i, RUNTIME_SCAN_MAX_SNAPSHOT_PAYLOAD_BYTES as l, RUNTIME_SCAN_PROBE_SNAPSHOT_BINDING_NAME_PLACEHOLDER as m, RUNTIME_SCAN_BROWSER_WIDTH_PX as n, RUNTIME_SCAN_MAX_COMPONENT_EVENTS as o, RUNTIME_SCAN_PROBE_SNAPSHOT_ATTRIBUTE_NAME_PLACEHOLDER as p, RUNTIME_SCAN_CONTROL_CHARACTERS_PATTERN as r, RUNTIME_SCAN_MAX_RECORDING_DURATION_MS as s, sanitizeRuntimeUrl as t, RUNTIME_SCAN_MAX_STRING_LENGTH as u, RUNTIME_SCAN_TRACE_CATEGORIES as v, RUNTIME_SCAN_TRACE_FILE_EXTENSION as y };
+
+//# sourceMappingURL=sanitize-runtime-url-Bbq40iIp.js.map
+//# debugId=39fe62ec-70de-53ef-9168-84e5123b75a2

package/dist/scan-C7sCm7wi.js

@@ -0,0 +1,47 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="11af106d-169b-5022-be6a-f7f67fb8e76e")}catch(e){}}();
+import { T as METRIC, fn as resolveScanTarget, t as recordCount } from "./record-metric-B6T_Ej33.js";
+import { i as warnDeprecatedDiff } from "./resolve-scope-CTlLl7e6.js";
+import { a as validateModeFlags, r as validateFilePathSelectionFlags, y as resolveCliInspectOptions } from "./should-fail-scan-gate-CfG_ppAV.js";
+import { n as warnDeprecatedFailOn, r as runProjectMigrations, t as inspectAction } from "./inspect-Dq5krKWG.js";
+import { n as shouldUseTui, r as resolveTuiEnvironment } from "./should-use-tui-B-lCjXVG.js";
+import path from "node:path";
+//#region src/cli/commands/scan.ts
+const runScanCommand = async (input) => {
+	if (input.flags.cache === false) process.env.REACT_DOCTOR_NO_CACHE = "1";
+	if (input.filePaths !== void 0) validateFilePathSelectionFlags(input.flags);
+	const tuiEnvironment = {
+		flags: input.flags,
+		...resolveTuiEnvironment()
+	};
+	if (input.filePaths !== void 0) {
+		await inspectAction(input.directory, input.flags, input.invocationCommand, input.filePaths);
+		return;
+	}
+	if (!shouldUseTui(tuiEnvironment)) {
+		await inspectAction(input.directory, input.flags, input.invocationCommand);
+		return;
+	}
+	await runProjectMigrations(path.resolve(input.directory));
+	const scanTarget = await resolveScanTarget(input.directory, { allowAmbiguous: true });
+	validateModeFlags(input.flags);
+	warnDeprecatedFailOn(input.flags, scanTarget.userConfig);
+	warnDeprecatedDiff(input.flags, scanTarget.userConfig);
+	recordCount(METRIC.cliInvoked, 1, { command: input.invocationCommand });
+	const { runScanApp } = await import("./run-scan-app-D3huvmXJ.js");
+	const { shouldFail } = await runScanApp({
+		directory: input.directory,
+		scanTarget,
+		options: resolveCliInspectOptions(input.flags, null),
+		projectFlag: input.flags.project,
+		skipPrompts: input.flags.yes ?? false,
+		blocking: input.flags.blocking ?? input.flags.failOn,
+		flags: input.flags
+	});
+	if (shouldFail) process.exitCode = 1;
+};
+//#endregion
+export { runScanCommand };
+
+//# sourceMappingURL=scan-C7sCm7wi.js.map
+//# debugId=11af106d-169b-5022-be6a-f7f67fb8e76e

package/dist/{should-fail-scan-gate-C0Bo5Gqy.js → should-fail-scan-gate-CfG_ppAV.js}

@@ -1,12 +1,15 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b04e98bc-8ff1-560d-94c4-ce519f681b46")}catch(e){}}();
-import { $ as Maintainability, $t as listSourceFiles, An as makeSpan, At as filterDiagnosticsForSurface, Bn as try_, Ct as computeConfigFingerprint, Dn as decodeUnknownSync, Dt as createOxlintSpawnSlots, E as NANOSECONDS_PER_MILLISECOND, En as Diagnostic, Et as createNodeReadFileLinesSync, Fn as provideContext, G as isCiOrCodingAgentEnvironment, Gn as succeed, Gt as highlighter, H as ACTION_INPUT_ENVIRONMENT_VARIABLES, Ht as hasPublishedFixRecipe, In as provideService, J as Files, Jn as fail, Kt as isMonorepoRoot, Ln as runPromise, Mn as orElseSucceed, Mt as filterSourceFiles, Nn as promise, Pn as provide, Q as Linter, R as CliInputError, Rn as runSync, Rt as getDiagnosticRuleIdentity, Sn as error, St as collectSourceFileCountsByDirectory, Tn as warn, Tt as countOptInProjectRuleSelections, U as detectRunnerOs, Un as mergeAll, Vt as groupBy, W as isCiEnvironment, Wt as hashFileContents, Xn as ParentSpan, Y as Git, Yn as void_, Yt as isReactDoctorError, Z as LintPartialFailures, Zt as isScanComplete, _ as makeNoopConsole, _n as summarizeDiagnostics, _t as buildSkippedChecks, an as mergeReactDoctorConfigs, at as Project, bn as yieldToEventLoop, br as isFile, bt as classifyFileContext, c as setSentryProjectInfo, cn as resolveLintBatchOrdering, cr as GIT_SHOW_MAX_BUFFER_BYTES, ct as SidecarLintCacheEnabled, d as isJsonModeActive, dn as resolveScanTarget, dr as JSX_FILE_PATTERN, en as listSourceFilesCooperative, er as CI_URL, et as NodeResolver, fn as restoreLegacyThrow, fr as MILLISECONDS_PER_SECOND, g as VERSION, gn as shouldUseMaintainabilityLayer, gt as buildRuleSeverityControls, ht as buildRuleDocsUrl, in as materializeSourceTree, ir as DIAGNOSTIC_CATEGORY_BUCKETS, it as Progress, jn as map, jt as filterPathsOutsideDirectories, k as SCAN_RESULT_CACHE_FILENAME, kn as gen, kt as discoverSupportedSubprojects, l as getRunId, ln as resolveReactDoctorCacheDir, lr as HTML_FILE_PATTERN, mr as SHARE_BASE_URL, n as recordDistribution, nt as OxlintSpawnSlots, o as buildSentryScope, on as remainingDeadlineBudgetMs, or as ENTERPRISE_CONTACT_URL, ot as Reporter, pn as runInspect, pr as OXLINT_NODE_REQUIREMENT, pt as atomicWriteJson, q as Config, qt as isPathInsideDirectory, r as toSpanAttributes, rn as mapWithConcurrency, rt as PerFileLintCacheEnabled, s as buildSentryProjectContext, sn as resolveGithubActionsScoreMetadata, st as Score, t as recordCount, tn as listWorkspacePackages, tt as OxlintConcurrency, un as resolveScanConcurrency, ur as JSX_DUPLICATION_SOURCE_FILE_PATTERN, ut as SupplyChain, vr as isDirectory, vt as calculateScore, w as METRIC, wn as log, wt as computeDiagnosticDelta, x as BASELINE_FILES_TEMP_DIR_PREFIX, xn as Console, yt as canonicalizeUserRuleKey, z as isNonInteractiveEnvironment, zn as sync } from "./record-metric-CFfsgcVs.js";
-import { a as setActiveRunTrace, i as recordRunTraceId, o as getTelemetryContext } from "./unref-stdin-BxyvqsOy.js";
-import { n as buildFooterLinkLines, r as activeScanAbortRegistry, t as buildSectionDivider } from "./build-section-divider-BuOtLrzK.js";
-import { D as getPackageJsonPath, L as cliLogger, O as isRecord, P as runGit, a as installReactDoctorScriptStep, c as spinner, n as findNearestPackageDirectory, o as isSpinnerSilent, s as setSpinnerSilent } from "./install-doctor-script-DmEWQpVJ.js";
-import { d as detectDefaultBranch, l as prompts, r as installReactDoctorWorkflow, u as isCommandAvailable } from "./install-github-workflow-Dx6Pl9Wl.js";
-import { a as isValidBlockingLevel, c as openWorkflowPullRequest, l as stageWorkflowFile, o as pickBlockingLevel, u as toForwardSlashes } from "./resolve-scope-CXS-5jLR.js";
-import { h as detectAvailableAgents, t as reportWorkflowResult } from "./report-workflow-result-DGg9xopH.js";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="159aa887-619a-5d42-9d32-79fce37783d6")}catch(e){}}();
+import { $ as Linter, A as SCAN_RESULT_CACHE_FILENAME, An as gen, At as discoverSupportedSubprojects, B as isNonInteractiveEnvironment, Bn as sync, Cn as error, Ct as collectSourceFileCountsByDirectory, Dn as Diagnostic, Dt as createNodeReadFileLinesSync, En as warn, Et as countOptInProjectRuleSelections, Fn as provide, G as isCiEnvironment, Gt as hashFileContents, Ht as groupBy, In as provideContext, J as Config, Jt as isPathInsideDirectory, K as isCiOrCodingAgentEnvironment, Kn as succeed, Kt as highlighter, Ln as provideService, Mn as map, Mt as filterPathsOutsideDirectories, Nn as orElseSucceed, Nt as filterSourceFiles, On as decodeUnknownSync, Ot as createOxlintSpawnSlots, Pn as promise, Q as LintPartialFailures, Qt as isScanComplete, Rn as runPromise, S as BASELINE_FILES_TEMP_DIR_PREFIX, Sn as Console, T as METRIC, Tn as log, Tt as computeDiagnosticDelta, U as ACTION_INPUT_ENVIRONMENT_VARIABLES, Ut as hasPublishedFixRecipe, Vn as try_, W as detectRunnerOs, Wn as mergeAll, X as Git, Xt as isReactDoctorError, Y as Files, Zn as ParentSpan, _ as VERSION, _n as shouldUseMaintainabilityLayer, _t as buildRuleSeverityControls, an as materializeSourceTree, ar as DIAGNOSTIC_CATEGORY_BUCKETS, at as Progress, bt as canonicalizeUserRuleKey, cn as resolveGithubActionsScoreMetadata, ct as Score, d as isJsonModeActive, dn as resolveScanConcurrency, dr as JSX_FILE_PATTERN, dt as SupplyChain, en as listSourceFiles, et as Maintainability, fn as resolveScanTarget, fr as MAINTAINABILITY_SOURCE_FILE_PATTERN, gt as buildRuleDocsUrl, hr as SHARE_BASE_URL, in as mapWithConcurrency, it as PerFileLintCacheEnabled, jt as filterDiagnosticsForSurface, l as getRunId, ln as resolveLintBatchOrdering, lr as GIT_SHOW_MAX_BUFFER_BYTES, lt as SidecarLintCacheEnabled, mn as runInspect, mr as OXLINT_NODE_REQUIREMENT, mt as atomicWriteJson, n as recordDistribution, nn as listWorkspacePackages, nt as OxlintConcurrency, on as mergeReactDoctorConfigs, ot as Project, pn as restoreLegacyThrow, pr as MILLISECONDS_PER_SECOND, qt as isMonorepoRoot, r as toSpanAttributes, rt as OxlintSpawnSlots, sn as remainingDeadlineBudgetMs, sr as ENTERPRISE_CONTACT_URL, st as Reporter, t as recordCount, tn as listSourceFilesCooperative, tr as CI_URL, tt as NodeResolver, un as resolveReactDoctorCacheDir, ur as HTML_FILE_PATTERN, v as makeNoopConsole, vn as summarizeDiagnostics, vt as buildSkippedChecks, wt as computeConfigFingerprint, xn as yieldToEventLoop, xr as isFile, xt as classifyFileContext, yr as isDirectory, yt as calculateScore, z as CliInputError, zn as runSync, zt as getDiagnosticRuleIdentity } from "./record-metric-B6T_Ej33.js";
+import { t as getTelemetryContext } from "./telemetry-runtime-BF83aBFL.js";
+import { n as buildFooterLinkLines, t as buildSectionDivider } from "./build-section-divider-C09RcJrc.js";
+import { t as activeScanAbortRegistry } from "./active-scan-abort-registry-DwG6tSPy.js";
+import { t as toForwardSlashes } from "./path-format-DnHpmJwG.js";
+import { C as isRecord, M as cliLogger, S as getPackageJsonPath, a as installReactDoctorScriptStep, c as spinner, k as runGit, n as findNearestPackageDirectory, o as isSpinnerSilent, s as setSpinnerSilent } from "./install-doctor-script-CaTIms0r.js";
+import { d as detectDefaultBranch, l as prompts, r as installReactDoctorWorkflow, u as isCommandAvailable } from "./install-github-workflow-DjPgXVqg.js";
+import { a as isValidBlockingLevel, c as openWorkflowPullRequest, l as stageWorkflowFile, o as pickBlockingLevel } from "./resolve-scope-CTlLl7e6.js";
+import { n as resetSentryRunState, r as withRunSpan, t as recordSentryProjectContext } from "./with-run-span-CdsXSJgE.js";
+import { h as detectAvailableAgents, t as reportWorkflowResult } from "./report-workflow-result-5PueDIAr.js";
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import * as path$1 from "node:path";
@@ -102,107 +105,6 @@ const buildRuntimeLayers = (input) => {
 	return input.oxlintSpawnSlots === void 0 ? layersWithConcurrency : mergeAll(layersWithConcurrency, succeed(OxlintSpawnSlots, input.oxlintSpawnSlots));
 };
 //#endregion
-//#region src/cli/utils/with-run-span.ts
-/**
-* Ends the run span without letting a telemetry failure change the run's
-* outcome — the invariant every other emit site here already holds.
-*
-* The failure path is the reason this matters most: a throw from `end` there
-* would replace the user's original scan error, so a project-config mistake
-* could surface as an exporter stack trace, be reclassified as a crash, and get
-* reported as one.
-*/
-const endSpanSafely = (span, exit) => {
-	try {
-		span.end(BigInt(Date.now()) * NANOSECONDS_PER_MILLISECOND, exit);
-	} catch {}
-};
-/**
-* Clears the module-level run-scoped telemetry state — the current scanned
-* project and the active run trace. `inspect()` calls this at the start of every
-* run and again after a clean one, so a prior or just-finished scan can't attach
-* its project tags / trace to a later run or to a non-scan error (e.g.
-* inspectAction's post-loop finalize/handoff steps). A thrown scan error skips
-* the post-run reset, leaving the state for the command catch to attribute and
-* link the crash. Concurrent batch members (`concurrentScan`) never touch this
-* state — they neither write nor reset it. Safe to call when telemetry is off
-* (the refs are read only when an event is built).
-*/
-const resetSentryRunState = () => {
-	setSentryProjectInfo(null);
-	setActiveRunTrace(null);
-};
-/**
-* Runs an inspect invocation inside a root span so each `react-doctor` run is a
-* first-class trace with timing and the run snapshot as attributes. The span is
-* handed to `run` so the scan's Effect spans parent under it and so the wide
-* event can be stamped onto it once the outcome is known.
-*
-* A no-op pass-through when telemetry is off (`--no-telemetry`, tests, or an
-* unconfigured build) — `run` receives `undefined` and no span is created, so
-* there's no added exit latency.
-*
-* The span is created against the shared telemetry context rather than a
-* freshly-provided layer, so it lives in the same tracer as the scan program's
-* spans; see `telemetry-runtime.ts` for why that matters. It is started and
-* ended manually because the body it wraps is a promise-returning imperative
-* function, not an Effect — the same shape the Sentry inactive span had.
-*
-* While the span runs, its trace context is recorded as the active run trace so
-* `reportErrorToSentry` can attach a crash thrown during the scan back to this
-* trace (errors surface in the command catch, after the span has ended).
-*
-* A `concurrentScan` (one member of the CLI's multi-project pool) still gets its
-* own root span, but skips recording the active run trace — the module-level
-* handle has single-scan semantics, and overlapping writers would link a crash
-* to an arbitrary sibling's trace.
-*/
-const withRunSpan = async (run, options = {}) => {
-	const telemetryContext = getTelemetryContext();
-	if (telemetryContext === null) return run(void 0);
-	const { tags } = buildSentryScope();
-	const command = typeof tags.command === "string" ? tags.command : "inspect";
-	let rootSpan;
-	try {
-		rootSpan = runSync(makeSpan(`react-doctor ${command}`, { attributes: toSpanAttributes(tags) }).pipe(provideContext(telemetryContext)));
-	} catch {
-		return run(void 0);
-	}
-	recordRunTraceId(rootSpan.traceId);
-	if (options.concurrentScan !== true) setActiveRunTrace({
-		traceId: rootSpan.traceId,
-		spanId: rootSpan.spanId,
-		sampled: rootSpan.sampled
-	});
-	try {
-		const result = await run(rootSpan);
-		endSpanSafely(rootSpan, void_);
-		return result;
-	} catch (error) {
-		endSpanSafely(rootSpan, fail(error));
-		throw error;
-	}
-};
-/**
-* Records the scanned project (discovered in the `beforeLint` hook): remembers
-* it for the lazy Sentry error-capture path (`buildSentryScope` folds it into
-* exception events) and for per-emit metric attributes, and sets it on the run's
-* root span so the trace carries the project shape too. Always cheap — the span
-* attributes are skipped when `rootSpan` is absent (telemetry off), and storing
-* the info is a plain assignment.
-*
-* A `concurrentScan` only sets the span attributes: the module-level project ref
-* has single-scan semantics, and overlapping writers would stamp events and
-* metrics with an arbitrary sibling's project. Wide events keep full attribution
-* (they ride the span); per-emit metrics simply omit the project shape during a
-* concurrent batch (absent, never wrong).
-*/
-const recordSentryProjectContext = (projectInfo, rootSpan, options = {}) => {
-	if (options.concurrentScan !== true) setSentryProjectInfo(projectInfo);
-	if (rootSpan === void 0) return;
-	for (const [key, value] of Object.entries(toSpanAttributes(buildSentryProjectContext(projectInfo).tags))) rootSpan.attribute(key, value);
-};
-//#endregion
 //#region src/cli/utils/diagnostic-grouping.ts
 const buildRulePriorityMap = (scores) => {
 	const rulePriority = /* @__PURE__ */ new Map();
@@ -2064,8 +1966,10 @@ const isMaterializableGitSource = (content) => !content.includes("\0") && !conte
 * `tempDirectory`, mirroring the project layout plus head's config files so
 * both sides lint under the same rules. Git rename heuristics are disabled by
 * the diff planner, so an old path is retained as a base deletion while its
-* new path is a head addition. Missing head-only additions are expected;
-* missing paths that the plan says must exist at base make `isComplete` false.
+* new path is a head addition. Missing head-only additions are expected, and a
+* base-only deletion that cannot be read has nothing at head to compare
+* against; only a missing path that the plan says exists on both sides makes
+* `isComplete` false.
 */
 const materializeBaselineFiles = (input) => runPromise(gen(function* () {
 	const git = yield* Git;
@@ -2090,11 +1994,12 @@ const materializeBaselineFiles = (input) => runPromise(gen(function* () {
 		}).pipe(map((content) => content !== null && isMaterializableGitSource(content) ? content : null))
 	});
 	const materializedFiles = new Set(tree.materializedFiles);
+	const headFileSet = new Set(headFiles);
 	return {
 		...tree,
 		baseFiles,
 		headFiles,
-		isComplete: baseFiles.every((filePath) => materializedFiles.has(filePath)),
+		isComplete: baseFiles.every((filePath) => materializedFiles.has(filePath) || !headFileSet.has(filePath)),
 		untrackedFiles
 	};
 }).pipe(provide(Git.layerNode)));
@@ -2116,6 +2021,12 @@ const resolveMergeBaseRef = async (directory, ref) => {
 	}
 };
 //#endregion
+//#region src/cli/utils/has-unlinted-surviving-base-file.ts
+const hasUnlintedSurvivingBaseFile = (input) => {
+	const analyzedBaseFiles = new Set(input.analyzedBaseFiles.map(toForwardSlashes));
+	return filterSourceFiles(input.baseLintPaths.map(toForwardSlashes)).some((filePath) => input.headFiles.has(filePath) && !analyzedBaseFiles.has(filePath));
+};
+//#endregion
 //#region src/cli/utils/run-baseline-comparison.ts
 const silentConsole$1 = makeNoopConsole();
 const countIncompleteLintFiles = (lintPartialFailures) => countDroppedLintFiles(lintPartialFailures) + countDeadlineSkippedFiles(lintPartialFailures);
@@ -2141,7 +2052,7 @@ const runBaselineComparison = async (input) => {
 	const baselineListingSignal = baselineDeadlineSignal === void 0 ? input.oxlintRuntime.abortSignal : input.oxlintRuntime.abortSignal === void 0 ? baselineDeadlineSignal : AbortSignal.any([input.oxlintRuntime.abortSignal, baselineDeadlineSignal]);
 	let maintainabilitySourceFiles = [];
 	if (input.options.deadCode) try {
-		maintainabilitySourceFiles = (await listSourceFilesCooperative(input.directory, baselineListingSignal)).filter((filePath) => JSX_DUPLICATION_SOURCE_FILE_PATTERN.test(filePath) && classifyFileContext(filePath) === "production");
+		maintainabilitySourceFiles = (await listSourceFilesCooperative(input.directory, baselineListingSignal)).filter((filePath) => MAINTAINABILITY_SOURCE_FILE_PATTERN.test(filePath) && classifyFileContext(filePath) === "production");
 	} catch (error) {
 		if (baselineDeadlineSignal?.aborted) return null;
 		throw error;
@@ -2241,7 +2152,12 @@ const runBaselineComparison = async (input) => {
 			excludedProjectDirectories: baselineExcludedProjectDirectories,
 			retainExcludedProjectDeadCodeDiagnostics: input.options.retainExcludedProjectDeadCodeDiagnostics
 		}, {}).pipe(provide(runtimeLayers), provideService(PerFileLintCacheEnabled, false), provideService(SidecarLintCacheEnabled, false), provideService(Console, silentConsole$1))), { signal: input.oxlintRuntime.abortSignal });
-		if (baseOutput.didLintFail || baseOutput.didDeadCodeFail || countIncompleteLintFiles(baseOutput.lintPartialFailures) > 0) return null;
+		if (baseOutput.didLintFail || baseOutput.didDeadCodeFail) return null;
+		if (countIncompleteLintFiles(baseOutput.lintPartialFailures) > 0 && hasUnlintedSurvivingBaseFile({
+			baseLintPaths: materializedLintPaths,
+			headFiles: expectedHeadFiles,
+			analyzedBaseFiles: baseOutput.analyzedFiles
+		})) return null;
 		const hasUnscannedUntrackedSourceFiles = filterSourceFiles(filterPathsOutsideDirectories({
 			rootDirectory: input.directory,
 			relativePaths: snapshot.untrackedFiles,
@@ -3063,6 +2979,17 @@ const projectManifestChanged = (rootDirectory, projectDirectory, diffInfo) => {
 	return diffInfo.changedFiles.some((filePath) => toForwardSlashes(filePath) === manifestPath);
 };
 //#endregion
+//#region src/cli/utils/resolve-excluded-project-directories.ts
+const resolveExcludedProjectDirectories = (scanDirectory, projectDirectories) => {
+	const excludedDirectories = /* @__PURE__ */ new Map();
+	for (const projectDirectory of projectDirectories) {
+		if (!isPathInsideDirectory(projectDirectory, scanDirectory)) continue;
+		const resolvedDirectory = path$1.resolve(projectDirectory);
+		if (!excludedDirectories.has(resolvedDirectory)) excludedDirectories.set(resolvedDirectory, projectDirectory);
+	}
+	return [...excludedDirectories.values()];
+};
+//#endregion
 //#region src/cli/utils/validate-mode-flags.ts
 const usedDiffAlias = (flags) => flags.diff !== void 0 && flags.diff !== false && flags.diff !== "false" && flags.diff !== "";
 const usedScope = (flags) => typeof flags.scope === "string" && flags.scope.length > 0;
@@ -3070,6 +2997,12 @@ const validateIncludeUntrackedScope = (includeUntracked, scope) => {
 	if (!includeUntracked || scope !== void 0 && scope !== "full") return;
 	throw new CliInputError("--include-untracked requires the files, changed, or lines scope (via --scope, --diff, or config).");
 };
+const validateFilePathSelectionFlags = (flags) => {
+	if (flags.staged || flags.changedFilesFrom !== void 0) throw new CliInputError("Cannot combine file path arguments with --staged or --changed-files-from. Use one file source.");
+	if (usedDiffAlias(flags)) throw new CliInputError("Cannot combine file path arguments with --diff. File path arguments use the files scope.");
+	if (usedScope(flags) && flags.scope !== "files") throw new CliInputError(`Cannot combine file path arguments with --scope ${flags.scope}. File path arguments use --scope files.`);
+	if (flags.base !== void 0) throw new CliInputError("Cannot combine file path arguments with --base. The selected files do not need a Git base.");
+};
 const validateModeFlags = (flags) => {
 	if (usedScope(flags) && usedDiffAlias(flags)) throw new CliInputError("Cannot combine --scope and --diff; --diff is the deprecated alias.");
 	if (flags.staged && usedDiffAlias(flags)) throw new CliInputError("Cannot combine --staged and --diff; pick one mode.");
@@ -3094,7 +3027,7 @@ const shouldFailScanGate = (input) => {
 	return shouldBlockCi(filterScansForSurface(input.scans, "ciFailure"), input.blockingLevel);
 };
 //#endregion
-export { resolveMergeBaseRef as A, buildNoScoreMessage as B, copyToClipboard as C, deduplicateProjectScans as D, collectProjectSourceFileCounts as E, printFooter as F, formatFixRecipeLine as G, hasLintHardFailure as H, printDiagnosticsDump as I, formatLearnMoreLine as K, formatDiagnosticSite as L, pluralize as M, formatSkippedCheckLabel as N, createInvocationInspect as O, formatElapsedTime as P, hasIncompleteScoreAnalysis as R, CLI_AGENT_BINARIES as S, buildHandoffPayload as T, buildRulePriorityMap as U, buildEmptyReportMessage as V, buildSortedRuleGroups as W, resolveCliInspectOptions as _, projectManifestChanged as a, setUpGitHubActions as b, selectProjects as c, resolveProjectChangedLineRanges as d, resolveProjectDiffIncludePaths as f, resolveWorkspaceDeadCodeOwner as g, retryMissingProjectScores as h, validateModeFlags as i, printHeadlessReport as j, inspect as k, buildCodeFrame as l, resolveProjectRelativeDirectory as m, formatSkippedProjectsMessage as n, partitionProjectScanOutcomes as o, resolveProjectSourceFilePaths as p, validateIncludeUntrackedScope as r, discoverWorkspacePackages as s, shouldFailScanGate as t, resolveProjectScan as u, filterScansForSurface as v, launchCliAgent as w, detectLaunchableAgents as x, countUniqueScannedFiles as y, filterDiagnosticsByCategories as z };
+export { createInvocationInspect as A, hasIncompleteScoreAnalysis as B, detectLaunchableAgents as C, buildHandoffPayload as D, launchCliAgent as E, formatSkippedCheckLabel as F, buildRulePriorityMap as G, buildNoScoreMessage as H, formatElapsedTime as I, formatLearnMoreLine as J, buildSortedRuleGroups as K, printFooter as L, resolveMergeBaseRef as M, printHeadlessReport as N, collectProjectSourceFileCounts as O, pluralize as P, printDiagnosticsDump as R, setUpGitHubActions as S, copyToClipboard as T, buildEmptyReportMessage as U, filterDiagnosticsByCategories as V, hasLintHardFailure as W, retryMissingProjectScores as _, validateModeFlags as a, filterScansForSurface as b, partitionProjectScanOutcomes as c, buildCodeFrame as d, resolveProjectScan as f, resolveProjectRelativeDirectory as g, resolveProjectSourceFilePaths as h, validateIncludeUntrackedScope as i, inspect as j, deduplicateProjectScans as k, discoverWorkspacePackages as l, resolveProjectDiffIncludePaths as m, formatSkippedProjectsMessage as n, resolveExcludedProjectDirectories as o, resolveProjectChangedLineRanges as p, formatFixRecipeLine as q, validateFilePathSelectionFlags as r, projectManifestChanged as s, shouldFailScanGate as t, selectProjects as u, resolveWorkspaceDeadCodeOwner as v, CLI_AGENT_BINARIES as w, countUniqueScannedFiles as x, resolveCliInspectOptions as y, formatDiagnosticSite as z };
 
-//# sourceMappingURL=should-fail-scan-gate-C0Bo5Gqy.js.map
-//# debugId=b04e98bc-8ff1-560d-94c4-ce519f681b46
+//# sourceMappingURL=should-fail-scan-gate-CfG_ppAV.js.map
+//# debugId=159aa887-619a-5d42-9d32-79fce37783d6

package/dist/{should-skip-prompts-BqrtVX4G.js → should-skip-prompts-BuNtAVEs.js}

@@ -1,10 +1,10 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0fe3c6c5-2652-5908-928b-a30fbf2196c5")}catch(e){}}();
-import { z as isNonInteractiveEnvironment } from "./record-metric-CFfsgcVs.js";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="82a072bc-1267-5b0f-b69c-f997e7622281")}catch(e){}}();
+import { B as isNonInteractiveEnvironment } from "./record-metric-B6T_Ej33.js";
 //#region src/cli/utils/should-skip-prompts.ts
 const shouldSkipPrompts = (input = {}) => Boolean(input.yes) || Boolean(input.json) || isNonInteractiveEnvironment() || !process.stdin.isTTY;
 //#endregion
 export { shouldSkipPrompts as t };
 
-//# sourceMappingURL=should-skip-prompts-BqrtVX4G.js.map
-//# debugId=0fe3c6c5-2652-5908-928b-a30fbf2196c5
+//# sourceMappingURL=should-skip-prompts-BuNtAVEs.js.map
+//# debugId=82a072bc-1267-5b0f-b69c-f997e7622281

package/dist/should-use-tui-B-lCjXVG.js

@@ -0,0 +1,25 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0e5a5f1f-ac58-5ea9-8205-f8d5913b3bc6")}catch(e){}}();
+import { B as isNonInteractiveEnvironment } from "./record-metric-B6T_Ej33.js";
+//#region src/cli/utils/resolve-tui-environment.ts
+const resolveTuiEnvironment = (outputIsTty = process.stdout.isTTY === true) => ({
+	isNonInteractiveEnvironment: isNonInteractiveEnvironment(),
+	nodeMajorVersion: Number(process.versions.node.split(".")[0]),
+	outputIsTty,
+	stdinIsTty: process.stdin.isTTY === true,
+	supportsRawMode: typeof process.stdin.setRawMode === "function",
+	terminalName: process.env.TERM
+});
+//#endregion
+//#region src/cli/utils/should-use-tui.ts
+const isTuiEnvironmentSupported = (input) => !input.isNonInteractiveEnvironment && input.stdinIsTty && input.outputIsTty && input.supportsRawMode && input.nodeMajorVersion >= 22 && input.terminalName !== "dumb";
+const shouldUseTui = (input) => {
+	if (!isTuiEnvironmentSupported(input)) return false;
+	const flags = input.flags;
+	return !(flags.score === true || flags.json === true || flags.jsonCompact === true || flags.jsonOut !== void 0 || flags.staged === true || flags.changedFilesFrom !== void 0);
+};
+//#endregion
+export { shouldUseTui as n, resolveTuiEnvironment as r, isTuiEnvironmentSupported as t };
+
+//# sourceMappingURL=should-use-tui-B-lCjXVG.js.map
+//# debugId=0e5a5f1f-ac58-5ea9-8205-f8d5913b3bc6

package/dist/skills/improve-threejs/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: improve-threejs
+description: Audit and fix Three.js and React Three Fiber apps for frame-loop performance, GPU memory leaks, scene-graph correctness, and visual defects like z-fighting, shadow acne, wrong color space, and broken resize handling. Uses React Doctor as the scanning engine plus a visual rubric checked against rendered output. Use when the user asks to improve, audit, scan, or clean up a Three.js, R3F, react-three-fiber, drei, or WebGL app, or types `/improve-threejs`.
+---
+
+# Improve Three.js
+
+Audits a Three.js or React Three Fiber (R3F) codebase and fixes what hurts most: work that runs every frame, GPU resources that never get disposed, scene-graph objects rebuilt on every render, and visual defects the user can see. React Doctor supplies the machine-verified code scan; this skill supplies the frame-loop judgment and the visual inspection a general React scanner lacks.
+
+The core principle: severity follows the render loop. Code inside `useFrame` or a `requestAnimationFrame` callback runs 60 times per second, so a minor inefficiency there outweighs a major one in a settings panel. Rank every finding by where it runs, not by the rule's default severity.
+
+## Workflow
+
+### Step 1: Recon
+
+Identify the stack before scanning: plain Three.js or R3F, which helper libraries are in use (drei, postprocessing, rapier), and where the render loop lives (`useFrame` hooks, `requestAnimationFrame`, the `<Canvas frameloop>` setting).
+
+Build a hot-path map: every `useFrame` body, every RAF callback, every pointer-move handler. These files get the strictest review in Step 3.
+
+### Step 2: Scan
+
+Run React Doctor read-only to collect structured evidence:
+
+```bash
+npx react-doctor@latest --verbose
+```
+
+For a regression check after making changes, run with `--scope changed` and confirm the score did not drop.
+
+### Step 3: Triage by frame-loop leverage
+
+Re-rank the scanner's findings using the hot-path map, then hunt for the Three.js-specific problems the scanner cannot see. Confirm every finding at its `file:line` before reporting it.
+
+**HIGH severity, runs every frame or leaks GPU memory:**
+
+- **Allocation inside `useFrame`**: `new Vector3()`, `new Color()`, or fresh arrays passed to Three.js APIs each frame. Fix: hoist a scratch object to module scope or `useMemo`, then mutate it in place
+- **`setState` inside `useFrame`**: re-renders the React tree on every frame. Fix: mutate refs directly; reserve state for discrete changes like selection or visibility
+- **Missing disposal**: geometries, materials, textures, or render targets created imperatively and never disposed. Fix: call `dispose()` in the cleanup function, or move the object into R3F's declarative tree so it owns the lifecycle
+- **Object reconstruction in render**: geometry or material instances created without `useMemo`, or inline `args` arrays whose identity changes each render, forcing R3F to rebuild the underlying object
+
+**MEDIUM severity, per-render or per-interaction waste:**
+
+- **Unstable scene-graph props**: inline `new THREE.Vector3()` or fresh material objects as props (plain arrays like `position={[x, y, z]}` are fine; R3F handles them)
+- **Missing instancing**: hundreds of identical meshes rendered individually instead of through `<Instances>` or `InstancedMesh`
+- **Wasted frames**: `frameloop="always"` on a scene that only changes on interaction. Fix: `frameloop="demand"` plus `invalidate()`
+- **Uncached asset loading**: textures and models loaded outside `useLoader`, `useTexture`, or `useGLTF`, losing caching and Suspense integration
+
+**LOW severity, hygiene:** React Doctor findings on non-canvas UI code, missing `<Preload>`, oversized textures.
+
+### Step 4: Visual audit
+
+Inspect what the scene actually renders. Every visual finding needs evidence: a screenshot, a frame capture, or a reproduced observation, never a guess from reading source. When a dev server and browser are available, load the app, capture the first stable frame, then capture again after moving the camera and interacting. When no browser is available, check the code-level causes listed below and label each finding as inferred from source.
+
+Apply the mini rubric. A row fails only when the evidence shows the failure condition:
+
+| Area                   | Check                                                                  | Fail when                                                                                          |
+| ---------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| Render sanity          | The scene reaches a stable frame after load                            | Black canvas, WebGL context errors, or content that never appears                                  |
+| Geometry               | Move the camera along seams, edges, and boundaries                     | Gaps, missing faces, visible backfaces, or two surfaces flickering at the same depth (z-fighting)  |
+| Transparency and depth | Cross depth-order boundaries with overlapping or transmissive surfaces | Wrong sort order, halos, opaque surfaces that should transmit, or flicker at grazing angles        |
+| Textures               | View mapped surfaces close, far, and at grazing angles                 | Missing textures, stretching, seams, moiré, shimmer, or washed-out colors from a wrong color space |
+| Materials and lighting | Change light and view direction on lit surfaces                        | Surfaces that ignore light direction, or reflective metals with no environment to reflect          |
+| Shadows                | Move casters, receivers, and the light through their range             | Acne, detached or floating shadows, flicker at rest, or shadows that outlive their caster          |
+| Camera                 | Follow the primary subject through movement and transitions            | Subject leaves frame, camera clips into geometry, or foreground blocks the play area               |
+| Scale and contact      | Compare object scale and resting contact against surroundings          | Objects float above, sink into, or intersect their support surface, or sit at implausible scale    |
+| Image stability        | Pan the camera slowly at supported resolutions                         | Silhouettes, thin geometry, or highlights that crawl, sparkle, or ghost                            |
+| Resize and DPR         | Change viewport size, zoom, and device pixel ratio                     | Distortion, blur, stretched output, or content leaving the viewport                                |
+
+Each rubric row has a small set of usual code-level causes. Check these first when a row fails:
+
+- **Washed-out or too-dark colors**: `renderer.outputColorSpace` not set to `SRGBColorSpace`, color textures missing `texture.colorSpace = SRGBColorSpace`, or a data texture (normal, roughness) wrongly marked sRGB
+- **Z-fighting**: coplanar geometry needing `polygonOffset` or a position nudge, or a near plane set far too small for the scene scale
+- **Shadow acne or floating shadows**: `shadow.bias` and `shadow.normalBias` untuned, or a shadow camera frustum far larger than the scene
+- **Blurry or stretched canvas**: renderer size not synced to canvas CSS size, `setPixelRatio` never called, or a resize handler that forgets `camera.updateProjectionMatrix()`
+- **Black metals**: `metalness: 1` with no `scene.environment` set
+- **Transparency sorting glitches**: large transparent meshes needing `depthWrite: false`, manual `renderOrder`, or a split into smaller meshes
+- **Shimmer and crawl**: missing texture anisotropy, antialiasing disabled, or thin geometry needing thicker forms
+
+### Step 5: Fix
+
+Fix in severity order: HIGH performance findings and failed visual rows first. When a finding maps to a React Doctor rule, fetch the canonical recipe instead of improvising:
+
+```text
+https://www.react.doctor/prompts/rules/<plugin>/<rule>.md
+```
+
+For Three.js-specific findings, apply the fix named in the triage list or the cause list above.
+
+### Step 6: Validate
+
+Run `npx react-doctor@latest --verbose --scope changed` and confirm the score did not regress. Re-check every visual rubric row that failed, using the same viewpoint and interaction as the original evidence, and confirm it now passes. Then verify behavior: the scene renders, animations play, and interactions respond. If browser dev tools are available, watch the memory profile while orbiting an idle scene; a rising heap during idle means a disposal leak survived.
+
+## Checks the scanner always misses
+
+Review these by hand on every audit:
+
+- `dispose()` coverage for every imperatively created GPU resource
+- Allocations and `setState` inside `useFrame` and RAF callbacks
+- Event listeners and `ResizeObserver`s on the canvas or window without cleanup
+- Raycasting against the full scene on every pointer move instead of a filtered target list
+- Shadows or postprocessing enabled globally when one part of the scene needs them
+- Color space configuration on the renderer and every color texture