doc-detective 4.6.1 → 4.7.0-runtime-dependency-detection.1

package/dist/debug/envvars.js

@@ -0,0 +1,231 @@
+// Env-var enumeration for the debug dump.
+//
+// Two collection paths:
+//   1. `findReferencedEnvVars` walks raw text (config file source,
+//      DOC_DETECTIVE_CONFIG env value, input file contents) for
+//      `$VAR` style references — the same shape `replaceEnvs` in
+//      `src/core/utils.ts` substitutes at runtime.
+//   2. `detectContainer` returns a small struct describing whether
+//      Doc Detective is running inside a container (IN_CONTAINER
+//      canary, /.dockerenv probe, or /proc/1/cgroup substring).
+//
+// Both helpers are pure / cheap and safe to call in any order. File
+// I/O lives in the orchestrator, not here.
+import fs from "node:fs";
+import path from "node:path";
+// Env-var references, scoped to POSIX-valid variable names: a leading
+// letter or underscore followed by letters / digits / underscores.
+//
+// `replaceEnvs` (in src/core/utils.ts) uses the looser `\$[a-zA-Z0-9_]+`
+// shape, but that's harmless there — it only ever resolves names that
+// actually exist in `process.env`, and env var names can't start with a
+// digit. The debug dump GREPS raw source, so the loose shape matched
+// shell positionals (`$0`, `$1`), regex backreferences (`$2`), and
+// numeric tokens (`$86`) that can never be env vars — pure noise in a
+// pasted report. Anchoring on a non-digit first char drops all of it
+// without hiding anything `replaceEnvs` would ever substitute.
+const ENV_REF_REGEX = /\$[a-zA-Z_][a-zA-Z0-9_]*/g;
+export function findReferencedEnvVars(value) {
+    const found = new Set();
+    collect(value, found, new WeakSet());
+    return found;
+}
+function collect(value, out, seen) {
+    if (value == null)
+        return;
+    if (typeof value === "string") {
+        const matches = value.match(ENV_REF_REGEX);
+        if (matches) {
+            for (const m of matches)
+                out.add(m.slice(1));
+        }
+        return;
+    }
+    if (typeof value !== "object")
+        return;
+    if (seen.has(value))
+        return;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collect(item, out, seen);
+        return;
+    }
+    for (const k of Object.keys(value)) {
+        if (k === "__proto__" || k === "constructor" || k === "prototype")
+            continue;
+        collect(value[k], out, seen);
+    }
+}
+export function detectContainer() {
+    const signals = [];
+    if (process.env.IN_CONTAINER === "true") {
+        signals.push("IN_CONTAINER=true");
+    }
+    // /.dockerenv exists in Docker containers on Linux. Safe to stat on
+    // Windows too — it just returns false.
+    try {
+        if (fs.existsSync("/.dockerenv"))
+            signals.push("/.dockerenv exists");
+    }
+    catch {
+        // Stat errors are non-fatal — diagnostics should never crash.
+    }
+    // /proc/1/cgroup substring check (Linux only). Skip on win32 / darwin
+    // where /proc doesn't exist.
+    if (process.platform === "linux") {
+        try {
+            const cgroup = fs.readFileSync("/proc/1/cgroup", "utf8");
+            if (/docker|containerd|kubepods/.test(cgroup)) {
+                signals.push("/proc/1/cgroup matches container runtime");
+            }
+        }
+        catch {
+            // Non-fatal — /proc/1/cgroup may not be readable.
+        }
+    }
+    return { inContainer: signals.length > 0, signals };
+}
+// Default file-type → extension map, mirroring core's `defaultFileTypes`
+// (src/core/config.ts). Used to scope the referenced-env-var scan to the
+// files doc-detective actually parses, instead of every file in the tree
+// (where the `$VAR` grep matched shell/code/CI syntax — see the dump's
+// noise before this was added).
+const DOC_EXTENSIONS_BY_TYPE = {
+    markdown: ["md", "markdown", "mdx"],
+    asciidoc: ["adoc", "asciidoc", "asc"],
+    html: ["html", "htm"],
+    dita: ["dita", "ditamap", "xml"],
+};
+// Resolve `config.fileTypes` into the set of lowercase extensions (no
+// leading dot) that doc-detective would treat as input. Handles both the
+// post-setConfig string-name form (`["markdown", "dita"]`) and richer
+// object entries that carry their own `extensions` / `name` / `extends`.
+// Falls back to the union of all known doc extensions when fileTypes is
+// absent or yields nothing, so the scan still targets something sensible.
+export function resolveDocExtensions(fileTypes) {
+    const exts = new Set();
+    const add = (e) => {
+        if (typeof e === "string" && e.length > 0) {
+            exts.add(e.replace(/^\./, "").toLowerCase());
+        }
+    };
+    if (Array.isArray(fileTypes)) {
+        for (const ft of fileTypes) {
+            if (typeof ft === "string") {
+                for (const e of DOC_EXTENSIONS_BY_TYPE[ft] || [])
+                    add(e);
+            }
+            else if (ft && typeof ft === "object") {
+                const obj = ft;
+                // The schema allows `extensions` as a string OR an array.
+                if (typeof obj.extensions === "string") {
+                    add(obj.extensions);
+                }
+                else if (Array.isArray(obj.extensions)) {
+                    for (const e of obj.extensions)
+                        add(e);
+                }
+                for (const key of ["name", "extends"]) {
+                    const named = obj[key];
+                    if (typeof named === "string") {
+                        for (const e of DOC_EXTENSIONS_BY_TYPE[named] || [])
+                            add(e);
+                    }
+                }
+            }
+        }
+    }
+    if (exts.size === 0) {
+        for (const list of Object.values(DOC_EXTENSIONS_BY_TYPE)) {
+            for (const e of list)
+                add(e);
+        }
+    }
+    return exts;
+}
+// Hard cap on how many filesystem entries the walk will examine, separate
+// from the matched-file `cap`. Without it, an input pointed at `/` or a
+// huge repo with no doc-extension matches would traverse the whole tree
+// (the matched-file cap never trips), making `doc-detective debug` look
+// hung. 50k entries is plenty for any real docs tree.
+const MAX_ENTRIES_EXAMINED = 50_000;
+// Walk a list of input paths (files or directories) and return a list of
+// readable file paths up to `cap` entries. Bounded so the debug dump can
+// never hang on a giant tree. Skips node_modules and .git.
+//
+// When `allowedExtensions` is provided and non-empty, only files whose
+// extension is in the set are returned — directories are always traversed.
+// An explicitly-passed input file is returned regardless of extension
+// (the user pointed at it directly); the filter only prunes files
+// discovered by walking a directory.
+export function enumerateInputFiles(inputs, cap = 200, allowedExtensions) {
+    const filter = allowedExtensions && allowedExtensions.size > 0 ? allowedExtensions : null;
+    const matches = (p) => {
+        if (!filter)
+            return true;
+        const ext = path.extname(p).replace(/^\./, "").toLowerCase();
+        return filter.has(ext);
+    };
+    const out = [];
+    const stack = [];
+    const explicit = new Set();
+    // Canonical paths of directories already walked. Guards against cyclic
+    // symlinked directory graphs (e.g. `a/link -> ..`) that would otherwise
+    // keep the stack non-empty forever — a real hang risk, especially when
+    // the extension filter means no files ever pass to bound the walk.
+    const visitedDirs = new Set();
+    let examined = 0;
+    for (const i of inputs) {
+        if (typeof i === "string" && i.length > 0) {
+            stack.push(i);
+            explicit.add(i);
+        }
+    }
+    while (stack.length > 0 && out.length < cap && examined < MAX_ENTRIES_EXAMINED) {
+        examined++;
+        // pop() (LIFO) keeps the walk O(n); shift() reindexes the array on every
+        // iteration, degrading a large tree to O(n²). Order doesn't matter here.
+        const p = stack.pop();
+        let stat;
+        try {
+            stat = fs.statSync(p);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isFile()) {
+            // Honor an explicitly-passed file path even if its extension isn't
+            // a recognized doc type; only filter files found by walking dirs.
+            if (explicit.has(p) || matches(p))
+                out.push(p);
+            continue;
+        }
+        if (stat.isDirectory()) {
+            let realDir;
+            try {
+                realDir = fs.realpathSync(p);
+            }
+            catch {
+                realDir = p;
+            }
+            if (visitedDirs.has(realDir))
+                continue;
+            visitedDirs.add(realDir);
+            let entries;
+            try {
+                entries = fs.readdirSync(p);
+            }
+            catch {
+                continue;
+            }
+            for (const e of entries) {
+                if (e === "node_modules" || e === ".git")
+                    continue;
+                stack.push(path.join(p, e));
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=envvars.js.map

package/dist/debug/envvars.js.map

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

package/dist/debug/index.d.ts

@@ -0,0 +1,85 @@
+import { type SystemInfo } from "./system.js";
+import { type ToolResult } from "./tools.js";
+import { type ContainerInfo } from "./envvars.js";
+export interface PrintDebugOptions {
+    config: any;
+    configPath?: string | null;
+    configError?: Error | null;
+    /**
+     * When `true`, dump every `process.env` entry (redacted by name and
+     * by value-shape). When falsy (the default), only env vars actually
+     * referenced via `$VAR` in config / input files are listed.
+     *
+     * Wired from the `--include-env` flag on the `debug` subcommand.
+     * Intentionally separate from container detection so users in
+     * containers (the common case for env-leak risk) do NOT get an
+     * implicit full env dump unless they explicitly ask for it.
+     */
+    includeEnv?: boolean;
+    /**
+     * When set, the dump is written into this directory as two timestamped
+     * files — `debug-<timestamp>.txt` and `debug-<timestamp>.json` — using
+     * the same timestamp printed at the top of the dump. Parent directories
+     * are created. Production callers pass `defaultDebugDir()`; unit tests
+     * omit it so calling `printDebug` never writes a file as a side effect.
+     */
+    outDir?: string;
+    print?: (line: string) => void;
+}
+export declare function defaultDebugDir(): string;
+interface BrowserComponent {
+    label: string;
+    installed: boolean;
+    detail?: string;
+}
+interface BrowserDiagnostic {
+    name: string;
+    supported: boolean;
+    available: boolean;
+    components: BrowserComponent[];
+    note?: string;
+}
+interface BrowsersData {
+    timedOut?: boolean;
+    error?: string;
+    detectionFailed?: boolean;
+    browsers?: BrowserDiagnostic[];
+}
+interface DocDetectiveData {
+    version: string;
+    executionMethod?: string;
+    loadedFrom: string;
+    entryPoint: string;
+    nodeVersion?: string;
+    platform?: string;
+    timestamp?: string;
+    dependencies: Record<string, string>;
+    lockstepWarning?: string;
+    error?: string;
+}
+interface EnvData {
+    mode: "referenced" | "full";
+    scannedFileCount?: number;
+    variables: Array<{
+        name: string;
+        value: string;
+    }>;
+}
+interface ConfigData {
+    configPath: string | null;
+    configError?: string;
+    redacted: unknown;
+}
+export interface DebugData {
+    generatedAt: string;
+    system: SystemInfo;
+    docDetective: DocDetectiveData;
+    tools: ToolResult[];
+    browsers: BrowsersData;
+    container: ContainerInfo;
+    environment: EnvData;
+    config: ConfigData;
+}
+export declare function printDebug(opts: PrintDebugOptions): Promise<void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAStB,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,GAAG,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAID,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAaD,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACD,UAAU,YAAY;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,OAAO;IACf,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACpB;AAqND,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCvE"}