doc-detective 4.41.6 → 4.42.0

package/dist/upgradeNotice.js

@@ -0,0 +1,356 @@
+// Warnings on 4.x about what 5.0 changes or removes (ADR 01147). They go to
+// stderr, so stdout stays clean for --dry-run JSON and LSP traffic. Keep this
+// module free of heavy imports: the bare bins load it too.
+import fs from "node:fs";
+import path from "node:path";
+const UPGRADE_GUIDE_URL = "https://docs.doc-detective.com/docs/ci/upgrade-to-v5";
+const REMOVED_BINS = {
+    "doc-detective-lsp": "Use `doc-detective lsp --stdio`, which works today.",
+};
+// Each exact message prints once per process. Spec rows name their file, so a
+// later `runTests` call in the same process still warns about a new file, but
+// not about the same issue in a file it already warned about. Every caller
+// shares this set, including programmatic `runTests` calls.
+const warned = new Set();
+// The Action's legacy path runs v4 on purpose and has its own notice.
+function isAction() {
+    try {
+        return JSON.parse(process.env.DOC_DETECTIVE_META || "{}").dist_interface === "github-actions";
+    }
+    catch {
+        return false;
+    }
+}
+export function warnUpgrade(messages, logLevel) {
+    if (logLevel === "silent" || isAction())
+        return;
+    for (const message of messages) {
+        if (warned.has(message))
+            continue;
+        warned.add(message);
+        console.error(`Warning: ${message} See ${UPGRADE_GUIDE_URL}`);
+    }
+}
+export function warnRemovedBin(bin) {
+    warnUpgrade([`\`${bin}\` is removed in Doc Detective 5.0. ${REMOVED_BINS[bin]}`]);
+}
+/**
+ * Warnings for a command line. `commands` is yargs' parsed `_`; `rawArgs` is the
+ * unparsed argv, because yargs fills in both `-a` and `--agent` and can't tell
+ * which one the user typed.
+ */
+export function commandWarnings(commands, rawArgs) {
+    const messages = [];
+    const installAgents = commands[0] === "install-agents";
+    if (installAgents) {
+        messages.push("`install-agents` is removed in Doc Detective 5.0. Use `install agents`, which works today.");
+    }
+    if ((installAgents || (commands[0] === "install" && commands[1] === "agents")) &&
+        rawArgs.some((arg) => /^-[^-]*[as]/.test(arg))) {
+        messages.push("`-a` and `-s` are removed in Doc Detective 5.0. Use `--agent` and `--scope`, which work today.");
+    }
+    if (commands[0] === "install" && rawArgs.some((arg) => arg === "--silent" || arg.startsWith("--silent="))) {
+        messages.push("`install --silent` is removed in Doc Detective 5.0. Use `--quiet`, which works today.");
+    }
+    return messages;
+}
+/**
+ * Whether an `output` setting names a folder. 4.x treats any path without a
+ * file extension as a folder and creates it. `raw` is the value as written,
+ * since resolving it strips a trailing slash. Unset means the default, which
+ * the user didn't choose.
+ */
+export function namesFolder(raw, resolved) {
+    if (typeof raw !== "string" || raw.length === 0)
+        return false;
+    if (/[\\/]$/.test(raw) || !path.extname(resolved))
+        return true;
+    try {
+        return fs.statSync(resolved).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function outputWarnings(raw, resolved) {
+    return namesFolder(raw, resolved)
+        ? [
+            `In Doc Detective 5.0, \`--output\` and \`output\` name the results file. Use \`--output-dir\` for a folder when you upgrade. Your output path ('${raw}') names a folder, and 4.x treats a path without a file extension as a folder.`,
+        ]
+        : [];
+}
+export function concurrentRunnersWarnings(value) {
+    return value === ""
+        ? [
+            "`--concurrent-runners` with no value is removed in Doc Detective 5.0. Use `--concurrent-runners true`, which works today.",
+        ]
+        : [];
+}
+/** `-r` with several values, and repeated `-t` or `-s`, from yargs' parsed args. */
+export function flagWarnings(args) {
+    const messages = [];
+    // `reporters` is declared with `array: true` in buildYargs (src/utils.ts), so
+    // both `-r a b` and `-r a -r b` arrive as an array of several values.
+    if (Array.isArray(args.reporters) && args.reporters.length > 1) {
+        // 4.x reads `-r terminal,html` as one unknown reporter, so that form has to wait.
+        messages.push("`--reporters` takes one comma-separated value in Doc Detective 5.0, like `-r terminal,html`, which 4.x doesn't read. Switch when you upgrade, or set `reporters` in your config file, which works on both.");
+    }
+    for (const flag of ["test", "spec"]) {
+        const values = args[flag];
+        // Relies on yargs collecting a repeated `type: "string"` option (`-t a -t b`) into an
+        // array; the "setup rows prints them from the CLI" test guards that.
+        if (Array.isArray(values) && values.length > 1) {
+            messages.push(`\`--${flag}\` is given more than once, so 4.x ignores it and Doc Detective 5.0 exits with a usage error. Give one comma-separated value, \`--${flag} ${values.join(",")}\`, which works today.`);
+        }
+    }
+    return messages;
+}
+// How 4.x reads each boolean env var. 5.0 reads them all as on for
+// 1/true/yes/on and off for 0/false/no/off. `on` and `off` are the settings
+// that mean the same on both.
+const BOOLEAN_ENV = {
+    DOC_DETECTIVE_DEBUG: { v4: (v) => /^(1|true|yes)$/i.test(v.trim()) },
+    DOC_DETECTIVE_SKIP_AUTO_UPDATE: { v4: Boolean },
+    DOC_DETECTIVE_SKIP_AGENT_PROMPT: { v4: Boolean },
+    DOC_DETECTIVE_RUNTIME_DEBUG: { v4: (v) => v === "1" },
+    DOC_DETECTIVE_NO_ANDROID_AUTOINSTALL: { v4: (v) => v === "1" },
+    DOC_DETECTIVE_REUSE_APPIUM: { v4: (v) => v === "true" || v === "1" },
+    DOC_DETECTIVE_ALLOW_LOCAL_URLS: { v4: (v) => v === "true", on: "true" },
+    DOC_DETECTIVE_AUTOINSTALL: {
+        v4: (v) => !["0", "false", "no", "off"].includes(v.trim().toLowerCase()),
+        off: "`0`",
+    },
+};
+function readsAs5(value) {
+    const v = value.trim().toLowerCase();
+    if (["1", "true", "yes", "on"].includes(v))
+        return true;
+    if (["", "0", "false", "no", "off"].includes(v))
+        return false;
+    return undefined;
+}
+/** The legacy `DOC_DETECTIVE` env var as an object, or `{}` when it's unset or not JSON. */
+export function legacyEnv(env) {
+    try {
+        const parsed = JSON.parse(env.DOC_DETECTIVE || "{}");
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** The legacy `DOC_DETECTIVE` env var, and boolean env vars 5.0 reads differently. */
+export function envWarnings(env, config) {
+    const messages = [];
+    const legacy = legacyEnv(env);
+    if (legacy.config && typeof legacy.config === "object") {
+        messages.push("`DOC_DETECTIVE` is deprecated in Doc Detective 5.0, and its `config` object merges below `DOC_DETECTIVE_CONFIG` and flags instead of above them. Move it to `DOC_DETECTIVE_CONFIG`, which works today.");
+    }
+    // The official images set this value themselves, and their 5.0 builds allow
+    // unsafe steps in config, so only other images need to act.
+    const officialImage = /^docdetective\/docdetective:/.test(String(legacy.container));
+    // Deliberately strict: an explicit `false` has already opted out, so it needs no migration.
+    if (legacy.container && !officialImage && config.allowUnsafeSteps === undefined) {
+        messages.push("`DOC_DETECTIVE` has a `container` key, which allows unsafe steps today but not in Doc Detective 5.0. To keep running them, set `allowUnsafeSteps: true` in your config, which works today.");
+    }
+    for (const [name, { v4, on = "1", off = "unset it" }] of Object.entries(BOOLEAN_ENV)) {
+        const value = env[name];
+        // An empty value still counts: DOC_DETECTIVE_AUTOINSTALL reads it as on today.
+        if (value === undefined)
+            continue;
+        const today = v4(value);
+        const next = readsAs5(value);
+        if (next === today)
+            continue;
+        const reads = next === undefined
+            ? "Doc Detective 5.0 doesn't accept"
+            : `turns it ${today ? "on" : "off"} today and ${next ? "on" : "off"} in Doc Detective 5.0`;
+        messages.push(`\`${name}\` is '${value}', which ${reads}. Set it to \`${on}\` for on, or ${off} for off, which works today.`);
+    }
+    return messages;
+}
+/** Browsers loading from a legacy `browser-snapshots` folder, which 5.0 ignores. */
+export function browsersDirWarnings(dir) {
+    return path.basename(dir) === "browser-snapshots"
+        ? [
+            `Doc Detective uses browsers from '${dir}'. Doc Detective 5.0 ignores \`browser-snapshots\` folders and installs browsers into \`<cacheDir>/browsers\`. To switch now, delete the folder or set \`cacheDir\`.`,
+        ]
+        : [];
+}
+const REPORTERS = ["terminal", "json", "html", "runFolder", "junit", "markdown"];
+/** Config values 5.0 validates more strictly. */
+export function configWarnings(config) {
+    const messages = [];
+    // `-r terminal,html` arrives comma-joined, and 5.0 splits it.
+    const names = (Array.isArray(config.reporters) ? config.reporters : [])
+        .flatMap((name) => (typeof name === "string" ? name.split(",").map((part) => part.trim()) : []))
+        .filter(Boolean);
+    for (const name of names) {
+        if (!REPORTERS.includes(name)) {
+            messages.push(`\`reporters\` has '${name}'. Doc Detective 5.0 exits 2 unless each name is exactly \`terminal\`, \`json\`, \`html\`, \`runFolder\`, \`junit\`, or \`markdown\`, which work today.`);
+        }
+    }
+    return messages;
+}
+const ROUTING = ["onPass", "onFail", "onWarning", "onSkip"];
+const LOCATORS = ["selector", "elementText", "elementId", "elementTestId", "elementClass", "elementAttribute", "elementAria"];
+const REJECTS = "Doc Detective 5.0 rejects with exit 2";
+const EXIT_2 = `which ${REJECTS}`;
+function routes(owner) {
+    return ROUTING.flatMap((key) => (Array.isArray(owner[key]) ? owner[key] : []));
+}
+function testWarnings(test, where) {
+    return routes(test).flatMap((route) => [
+        ...(route.stop === "run"
+            ? [`A test in ${where} has \`stop: "run"\` in its routing, ${EXIT_2}. Use \`stop: "spec"\`, which is what 4.x does.`]
+            : []),
+        ...["retry", "goToStep"]
+            .filter((key) => key in route)
+            .map((key) => `A test in ${where} has \`${key}\` in its routing, which 4.x ignores and ${REJECTS}. Remove it, or move it to a step.`),
+    ]);
+}
+// Subtrees that hold the user's own data, where a `timeout` key isn't one of ours.
+// Keep this in sync with the schemas' free-form boundaries.
+const FREE_FORM = new Set([
+    "request",
+    "response",
+    "headers",
+    "body",
+    "params",
+    "parameters",
+    "elementAttribute",
+    "variables",
+    "outputs",
+    "env",
+    "driverOptions",
+    "openApi",
+]);
+// Negative `wait`, `*timeout`, `*duration`, and `*delay` numbers in a step,
+// which 5.0 rejects anywhere. It walks authored steps: shallow, parsed JSON/YAML
+// with no cycles, so the recursion needs no depth limit or cycle guard.
+function negatives(value, found = new Set()) {
+    if (value && typeof value === "object") {
+        for (const [key, child] of Object.entries(value)) {
+            if (FREE_FORM.has(key))
+                continue;
+            if (typeof child === "number" && child < 0 && (key === "wait" || /(timeout|duration|delay)$/i.test(key)))
+                found.add(key);
+            negatives(child, found);
+        }
+    }
+    return found;
+}
+function offend(offenders, row, value, message) {
+    if (!offenders.has(row))
+        offenders.set(row, { values: new Set(), message });
+    offenders.get(row).values.add(value);
+}
+function stepWarnings(step, where, offenders) {
+    const messages = [];
+    for (const route of routes(step)) {
+        if (route.stop === "spec" || route.stop === "run") {
+            messages.push(`A step in ${where} has \`stop: "${route.stop}"\` in its routing, ${EXIT_2}. Use \`stop: "test"\` on the step and \`stop: "spec"\` on the test, which works today.`);
+        }
+        if ("goToTest" in route) {
+            messages.push(`A step in ${where} has \`goToTest\` in its routing, which 4.x ignores and ${REJECTS}. Move it to the test's routing, which works today.`);
+        }
+    }
+    if (typeof step.click === "boolean") {
+        messages.push(`A \`click\` step in ${where} is \`${step.click}\`, which 4.x reads as text to click and ${REJECTS}. To click an element whose text is '${step.click}', quote it as \`"click": "${step.click}"\`, which works today. If you don't want a click, remove the step.`);
+    }
+    const objects = (value) => [value].flat().filter((s) => s && typeof s === "object");
+    if (objects(step.startSurface).concat(objects(step.closeSurface)).some((s) => s.browser === "edge")) {
+        messages.push(`A surface in ${where} uses \`browser: "edge"\`, which Doc Detective 5.0 removes. Use another \`browser\`, such as \`chrome\`, which works today.`);
+    }
+    const starts = objects(step.startSurface);
+    for (const surface of starts) {
+        // A string device names a device, so only an object can hold these keys.
+        const device = surface.device && typeof surface.device === "object" ? surface.device : {};
+        const removed = ["orientation", "udid", "provider"].filter((key) => key in device);
+        if (removed.length) {
+            messages.push(`A \`startSurface\` device in ${where} sets ${removed.map((key) => `\`${key}\``).join(", ")}, which Doc Detective 5.0 removes. Remove ${removed.length > 1 ? "them" : "it"}, which works today.`);
+        }
+        if (surface.app != null && surface.workingDirectory === ".") {
+            messages.push(`An app in ${where} sets \`workingDirectory: "."\`, which 4.x tolerates and Doc Detective 5.0 fails. Remove it, which works today.`);
+        }
+    }
+    const zeroTimeouts = [
+        ...["runShell", "runCode", "goTo", "httpRequest"].filter((action) => step[action]?.timeout === 0),
+        ...(starts.some((s) => s.timeout === 0) ? ["startSurface"] : []),
+    ];
+    for (const action of zeroTimeouts) {
+        messages.push(`A \`${action}\` step in ${where} sets \`timeout: 0\`, ${EXIT_2} on \`runShell\`, \`runCode\`, \`goTo\`, \`httpRequest\`, and \`startSurface\` processes and apps. Remove \`timeout\` for the default, or set it to 1 or more, which works today. Locator and wait timeouts can still be 0.`);
+    }
+    for (const key of negatives(step)) {
+        messages.push(`A step in ${where} has a negative \`${key}\`, ${EXIT_2}. Use a positive value, which works today.`);
+    }
+    if (step.screenshot === false) {
+        messages.push(`A \`screenshot: false\` step in ${where} takes a screenshot today, and Doc Detective 5.0 skips it. To keep the screenshot, use \`screenshot: true\`, which works today.`);
+    }
+    const find = step.find && typeof step.find === "object" ? step.find : {};
+    const click = find.click;
+    if ((typeof click === "string" && !["left", "right", "middle"].includes(click)) ||
+        (click && typeof click === "object" && Object.keys(click).some((key) => key !== "button" && key !== "duration"))) {
+        messages.push(`A \`find.click\` in ${where} isn't \`true\`, \`false\`, a button, or \`{button, duration}\`, ${EXIT_2}. Use \`click: true\` to click the found element, or a separate \`click\` step, which works today.`);
+    }
+    if (find.type && typeof find.type === "object" && LOCATORS.some((key) => key in find.type)) {
+        messages.push(`A \`find.type\` in ${where} sets its own locator, ${EXIT_2}. Move it to a separate \`type\` step, which works today.`);
+    }
+    for (const action of ["goTo", "httpRequest"]) {
+        const url = typeof step[action] === "string" ? step[action] : step[action]?.url;
+        if (typeof url === "string" && !/^(https?:\/\/|\/)/.test(url) && !/^\$[A-Za-z0-9_]+$/.test(url)) {
+            offend(offenders, `${action} URL`, url, (first) => `A \`${action}\` URL in ${where} (${first}) doesn't start with \`http://\`, \`https://\`, or \`/\`, and isn't a whole \`$VAR\`, ${EXIT_2}. Put the whole URL in one variable, which works today.`);
+        }
+    }
+    for (const action of ["saveCookie", "loadCookie"]) {
+        const value = step[action];
+        if (typeof value === "string" && value.includes("/") && !value.endsWith(".txt")) {
+            offend(offenders, action, value, (first) => `A \`${action}\` in ${where} (${first}) has a \`/\` but doesn't end in \`.txt\`, ${EXIT_2}. End a file path in \`.txt\`, which works today.`);
+        }
+    }
+    return messages;
+}
+/** Spec content 5.0 rejects or reads differently, from resolved tests. */
+export function specWarnings(resolvedTests) {
+    const messages = [];
+    for (const spec of resolvedTests?.specs ?? []) {
+        const file = spec.contentPath;
+        const where = typeof file === "string" ? `'${path.isAbsolute(file) ? path.relative(process.cwd(), file) : file}'` : "a spec";
+        const offenders = new Map();
+        for (const test of spec.tests ?? []) {
+            messages.push(...testWarnings(test, where));
+            for (const context of test.contexts ?? []) {
+                for (const step of context.steps ?? [])
+                    messages.push(...stepWarnings(step, where, offenders));
+            }
+        }
+        for (const { values, message } of offenders.values()) {
+            const [first] = values;
+            messages.push(message(values.size > 1 ? `\`${first}\` and ${values.size - 1} more` : `\`${first}\``));
+        }
+    }
+    return [...new Set(messages)];
+}
+/**
+ * Warnings for a finished run. `exitOnFail` is the raw config value: undefined
+ * means the user didn't choose, and false is already the 5.0 way to keep exit 0.
+ */
+export function runResultWarnings(exitOnFail, failed, results) {
+    if (exitOnFail === false)
+        return [];
+    const specs = results?.summary?.specs;
+    const testedNothing = !results || (!!specs && [specs.pass, specs.fail, specs.warning, specs.skipped].every((n) => !n));
+    if (testedNothing) {
+        const fix = exitOnFail === true
+            ? "Make sure your inputs always find tests."
+            : "To allow empty runs, set `--no-exit-on-fail`, which also stops failed tests from failing the run. Otherwise, make sure your inputs always find tests.";
+        return [`This run tested nothing. Doc Detective 5.0 will exit 2 instead of 0. ${fix}`];
+    }
+    if (failed && exitOnFail === undefined) {
+        return [
+            "This run has failed specs. Doc Detective 5.0 will exit 1 instead of 0. To keep exit 0, set `--no-exit-on-fail`.",
+        ];
+    }
+    return [];
+}
+//# sourceMappingURL=upgradeNotice.js.map

package/dist/upgradeNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgradeNotice.js","sourceRoot":"","sources":["../src/upgradeNotice.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,aAAa,EACb,YAAY,EACZ,OAAO,EACP,cAAc,EACd,GAAG,EACH,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,CAAC;AASF,iBAAS,gBAAgB,IAAI,OAAO,CAKnC;AAQD,iBAAS,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,GAAQ,GAAG,OAAO,CAMjE;AAED,iBAAS,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,GAAE,MAAe,EAAE,MAAM,GAAE,GAAQ,QASlE;AAMD,iBAAS,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CA4GlC;AAGD,iBAAS,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAG/B;AAGD,iBAAe,uBAAuB,CAAC,MAAM,GAAE,GAAQ;;;UAyEtD;AA8CD,iBAAe,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IAAE,UAAU,CAAC,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,gBA2N7E;AAuCD,QAAA,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CA2mBzG,CAAC;AAGF,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,WAM5D;AAED,iBAAe,aAAa,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;IAAE,SAAS,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,iBA4DpF;AAED,iBAAe,aAAa,CAAC,MAAM,EAAE,GAAG,YAAK,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAE,GAAQ,kBA8E9F;AAGD,iBAAe,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE;;;;GAwCvD;AAED,iBAAS,OAAO,SAuBf;AAGD,iBAAS,cAAc,QA+GtB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAqBA,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,aAAa,EACb,YAAY,EACZ,OAAO,EACP,cAAc,EACd,GAAG,EACH,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,CAAC;AASF,iBAAS,gBAAgB,IAAI,OAAO,CAKnC;AAQD,iBAAS,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,GAAQ,GAAG,OAAO,CAMjE;AAED,iBAAS,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,GAAE,MAAe,EAAE,MAAM,GAAE,GAAQ,QASlE;AAMD,iBAAS,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CA4GlC;AAGD,iBAAS,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAG/B;AAGD,iBAAe,uBAAuB,CAAC,MAAM,GAAE,GAAQ;;;UAyEtD;AA8CD,iBAAe,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IAAE,UAAU,CAAC,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,gBA0O7E;AAuCD,QAAA,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CA2mBzG,CAAC;AAGF,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,WAM5D;AAED,iBAAe,aAAa,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;IAAE,SAAS,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,iBA4DpF;AAED,iBAAe,aAAa,CAAC,MAAM,EAAE,GAAG,YAAK,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAE,GAAQ,kBA8E9F;AAGD,iBAAe,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE;;;;GAwCvD;AAED,iBAAS,OAAO,SAsBf;AAGD,iBAAS,cAAc,QA8GtB"}

package/dist/utils.js

@@ -3,12 +3,13 @@ import { hideBin } from "yargs/helpers";
 import { validate } from "./common/src/validate.js";
 import { resolvePaths, readFile } from "./core/index.js";
 import { getRunOutputDir, loadAxios } from "./core/utils.js";
+import { browsersDirWarnings, concurrentRunnersWarnings, configWarnings, envWarnings, flagWarnings, outputWarnings, warnUpgrade, } from "./upgradeNotice.js";
+import { getBrowsersDir } from "./runtime/cacheDir.js";
 import path from "node:path";
 import fs from "node:fs";
 import { spawn } from "node:child_process";
 import os from "node:os";
-import { createRequire } from "node:module";
-const require = createRequire(import.meta.url);
+import { ownVersion, readShimPackageJson } from "./runtime/heavyDeps.js";
 export { buildYargs, setArgs, setConfig, outputResults, spawnCommand, setMeta, getVersionData, log, logLevelEnabled, getResolvedTestsFromEnv, reportResults, reporters, registerReporter, isDebugRequested, };
 // True when `DOC_DETECTIVE_DEBUG` env var is set to a truthy value.
 // Used by `runTestsHandler` in cli.ts to decide whether to catch
@@ -123,7 +124,7 @@ function buildYargs(args) {
         type: "string",
     })
         .option("concurrent-runners", {
-        description: "Number of test contexts to run concurrently (default 1). Pass a number (for example, --concurrent-runners 4), or pass the flag with no value to use the CPU core count (capped at 4). With more than 1 runner, log lines from different contexts interleave and cross-context variable dependencies are unsupported.",
+        description: "Number of test contexts to run concurrently (default 1). Pass a number (for example, --concurrent-runners 4), or pass true to use the CPU core count (capped at 4). With more than 1 runner, log lines from different contexts interleave and cross-context variable dependencies are unsupported.",
         type: "string",
     })
         .option("browser-fallback", {
@@ -139,7 +140,7 @@ function buildYargs(args) {
         description: "Exit with a non-zero code (1) when any spec's result is FAIL, so a documentation-testing job fails the build like a broken unit test. Off by default: the CLI otherwise exits 0 on test failures (non-zero only on a crash or invalid config). WARNING results are non-fatal. Use --no-exit-on-fail to override a config file that enables it.",
         type: "boolean",
     })
-        .version(require("../package.json").version)
+        .version(ownVersion() ?? "unknown")
         .help()
         .alias("help", "h");
 }
@@ -264,6 +265,8 @@ async function setConfig({ configPath, args }) {
         // Merge with file config, preferring environment variable config (use raw envConfig, not validated with defaults)
         config = { ...config, ...envConfig };
     }
+    // Read before validation fills in the default, which the user didn't choose.
+    const outputSetting = args.output || config.output;
     // Validate config
     const validation = validate({
         schemaKey: "config_v3",
@@ -431,6 +434,14 @@ async function setConfig({ configPath, args }) {
         nested: false,
         objectType: "config",
     });
+    warnUpgrade([
+        ...outputWarnings(outputSetting, String(config.output)),
+        ...concurrentRunnersWarnings(args.concurrentRunners),
+        ...flagWarnings(args),
+        ...envWarnings(process.env, config),
+        ...configWarnings(config),
+        ...browsersDirWarnings(getBrowsersDir({ cacheDir: config.cacheDir })),
+    ], config.logLevel);
     return config;
 }
 // Resolve the directory the runFolder reporter's `.doc-detective/` archive
@@ -1159,9 +1170,8 @@ function setMeta() {
     const meta = process.env["DOC_DETECTIVE_META"] !== undefined
         ? JSON.parse(process.env["DOC_DETECTIVE_META"])
         : {};
-    const pkg = require("../package.json");
     meta.distribution = "doc-detective";
-    meta.dist_version = pkg.version;
+    meta.dist_version = ownVersion();
     meta.dist_platform = platformMap[os.platform()] || os.platform();
     meta.dist_platform_version = os.release();
     meta.dist_platform_arch = os.arch();
@@ -1174,8 +1184,7 @@ function setMeta() {
 // Get version data programmatically (no console output)
 function getVersionData() {
     try {
-        // Get main package version
-        const mainPackage = require("../package.json");
+        const mainPackage = readShimPackageJson();
         const versionData = {
             main: {
                 "doc-detective": {