@phigon/observer 8.1.0 → 8.3.0

package/dist/src/discovery/system-evidence.js

@@ -3,19 +3,91 @@ import { execFile } from "node:child_process";
 import { constants } from "node:fs";
 import { access, stat } from "node:fs/promises";
 import { homedir } from "node:os";
-import { basename, delimiter, join } from "node:path";
+import { basename, delimiter, join, win32 } from "node:path";
 import { promisify } from "node:util";
 import { observedProcessKey } from "./process-identity.js";
+import { guardianRunnerPath } from "../guardian-native.js";
 const execFileAsync = promisify(execFile);
 const executableNamePattern = /^[a-zA-Z0-9._+-]{1,128}$/;
 const versionPattern = /\bv?\d+\.\d+(?:\.\d+)?(?:[-+][0-9A-Za-z.-]+)?\b/;
+const maxCachedExecutableProbes = 64;
+/**
+ * Remembers which agent CLIs are installed between discovery passes.
+ * Finding one walks PATH and runs its `--version`, which starts the agent's
+ * own runtime; discovery runs every few seconds, while installs change
+ * rarely. A found CLI is probed again when its file changes or after
+ * `foundTtlMs` (npm shims stay unchanged across upgrades); an absent one, or
+ * one whose version could not be read, is probed again after `missingTtlMs`.
+ */
+export class ExecutableProbeCache {
+    #entries = new Map();
+    #foundTtlMs;
+    #missingTtlMs;
+    #clock;
+    constructor(options = {}) {
+        this.#foundTtlMs = options.foundTtlMs ?? 5 * 60_000;
+        this.#missingTtlMs = options.missingTtlMs ?? 60_000;
+        this.#clock = options.clock ?? Date.now;
+    }
+    async lookup(key) {
+        const cached = this.#entries.get(key);
+        if (cached === undefined)
+            return undefined;
+        const age = this.#clock() - cached.checkedAt;
+        if (age < 0 || age >= cached.ttlMs)
+            return undefined;
+        if (cached.executablePath === undefined)
+            return { value: cached.value };
+        try {
+            const metadata = await stat(cached.executablePath);
+            if (metadata.size !== cached.size ||
+                metadata.mtimeMs !== cached.modifiedMs) {
+                return undefined;
+            }
+        }
+        catch {
+            return undefined;
+        }
+        return { value: cached.value };
+    }
+    async remember(key, value, executablePath) {
+        const checkedAt = this.#clock();
+        const ttlMs = value === null || value.version === ""
+            ? this.#missingTtlMs
+            : this.#foundTtlMs;
+        let entry = { checkedAt, ttlMs, value };
+        if (executablePath !== null) {
+            try {
+                const metadata = await stat(executablePath);
+                entry = {
+                    ...entry,
+                    executablePath,
+                    size: metadata.size,
+                    modifiedMs: metadata.mtimeMs,
+                };
+            }
+            catch {
+                return;
+            }
+        }
+        this.#entries.delete(key);
+        this.#entries.set(key, entry);
+        if (this.#entries.size > maxCachedExecutableProbes) {
+            const oldest = this.#entries.keys().next().value;
+            if (oldest !== undefined)
+                this.#entries.delete(oldest);
+        }
+    }
+}
 export class SystemEvidenceProvider {
     #platform;
     #environment;
+    #executableCache;
     #processes;
-    constructor(platform = process.platform, environment = process.env) {
+    constructor(platform = process.platform, environment = process.env, executableCache) {
         this.#platform = platform;
         this.#environment = environment;
+        this.#executableCache = executableCache;
     }
     listProcesses() {
         this.#processes ??= this.#readProcesses();
@@ -30,20 +102,29 @@ export class SystemEvidenceProvider {
                 };
             }
         }
+        const cacheKey = JSON.stringify([
+            this.#platform,
+            this.#environmentValue("PATH") ?? "",
+            this.#environmentValue("PATHEXT") ?? "",
+            candidates,
+        ]);
         try {
+            const cached = await this.#executableCache?.lookup(cacheKey);
+            if (cached !== undefined)
+                return { status: "ok", value: cached.value };
             for (const candidate of candidates) {
                 const executablePath = await this.#findExecutable(candidate);
                 if (executablePath === null)
                     continue;
-                return {
-                    status: "ok",
-                    value: {
-                        executableName: normalizedExecutableName(candidate),
-                        executablePathDigest: digest(executablePath),
-                        version: await readVersion(executablePath),
-                    },
+                const value = {
+                    executableName: normalizedExecutableName(candidate),
+                    executablePathDigest: digest(executablePath),
+                    version: await readVersion(executablePath),
                 };
+                await this.#executableCache?.remember(cacheKey, value, executablePath);
+                return { status: "ok", value };
             }
+            await this.#executableCache?.remember(cacheKey, null, null);
             return { status: "ok", value: null };
         }
         catch (error) {
@@ -123,13 +204,15 @@ export class SystemEvidenceProvider {
             return probeFailure(error, "Process inspection");
         }
     }
-    async #findExecutable(candidate) {
-        const environmentValue = (name) => this.#environment[name] ?? (this.#platform === "win32"
+    #environmentValue(name) {
+        return this.#environment[name] ?? (this.#platform === "win32"
             ? Object.entries(this.#environment).find(([key]) => key.toUpperCase() === name)?.[1]
             : undefined);
-        const pathValue = environmentValue("PATH") ?? "";
+    }
+    async #findExecutable(candidate) {
+        const pathValue = this.#environmentValue("PATH") ?? "";
         const extensions = this.#platform === "win32"
-            ? (environmentValue("PATHEXT") ?? ".EXE;.CMD;.BAT")
+            ? (this.#environmentValue("PATHEXT") ?? ".EXE;.CMD;.BAT")
                 .split(";")
                 .filter(Boolean)
             : [""];
@@ -154,7 +237,51 @@ export class SystemEvidenceProvider {
         return null;
     }
 }
+// Set once the native helper is found missing (for example, a source
+// checkout built without Go); PowerShell is used from then on.
+let nativeProcessListingMissing = false;
+/**
+ * Windows processes, listed by the bundled native helper in tens of
+ * milliseconds. PowerShell's Win32_Process query, which costs 0.3-1 s (most
+ * of it PowerShell start-up), is the fallback when the helper is missing or
+ * fails. Both report the same IDs, names and start times, and paths are
+ * normalized (see windowsPathIdentity) before identities are derived. Each
+ * listing is one short-lived process with a timeout, so nothing outlives
+ * the observer.
+ */
 async function readWindowsProcesses() {
+    return listWindowsProcesses(nativeProcessListingMissing ? undefined : runNativeProcessListing, runPowerShellProcessListing);
+}
+export async function listWindowsProcesses(native, powerShell) {
+    if (native !== undefined) {
+        try {
+            return windowsProcessEvidence(nativeProcessValues(await native()));
+        }
+        catch {
+            // A crashed, timed-out or unreadable helper is retried next pass.
+        }
+    }
+    const parsed = JSON.parse(await powerShell());
+    return windowsProcessEvidence(Array.isArray(parsed) ? parsed : [parsed]);
+}
+export async function runNativeProcessListing() {
+    try {
+        const { stdout } = await execFileAsync(guardianRunnerPath(), ["__processes"], {
+            timeout: 5_000,
+            maxBuffer: 8 << 20,
+            encoding: "utf8",
+            windowsHide: true,
+        });
+        return stdout;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            nativeProcessListingMissing = true;
+        }
+        throw error;
+    }
+}
+export async function runPowerShellProcessListing() {
     const script = [
         "Get-CimInstance Win32_Process",
         "Select-Object ProcessId,CreationDate,ExecutablePath,Name",
@@ -166,8 +293,34 @@ async function readWindowsProcesses() {
         encoding: "utf8",
         windowsHide: true,
     });
+    return stdout;
+}
+/**
+ * The native listing in Win32_Process's shape. PowerShell serializes
+ * CreationDate as `/Date(<Unix ms>)/`; the helper reports those milliseconds,
+ * so rebuilding the string keeps process identities unchanged.
+ */
+export function nativeProcessValues(stdout) {
     const parsed = JSON.parse(stdout);
-    const values = Array.isArray(parsed) ? parsed : [parsed];
+    if (!Array.isArray(parsed)) {
+        throw new Error("Native process listing is invalid.");
+    }
+    return parsed.map((value) => {
+        if (typeof value !== "object" || value === null)
+            return undefined;
+        const entry = value;
+        const created = entry["created_ms"];
+        return {
+            ProcessId: entry["pid"],
+            Name: entry["name"],
+            CreationDate: typeof created === "number" && Number.isSafeInteger(created) && created > 0
+                ? `/Date(${created})/`
+                : undefined,
+            ExecutablePath: entry["path"],
+        };
+    });
+}
+function windowsProcessEvidence(values) {
     const processes = [];
     for (const value of values) {
         if (typeof value !== "object" ||
@@ -185,7 +338,7 @@ async function readWindowsProcesses() {
             ? value.ExecutablePath
             : value.Name;
         const startedAt = processStartDate(value.CreationDate);
-        const executablePathDigest = digest(rawPath);
+        const executablePathDigest = digest(windowsPathIdentity(rawPath));
         const processKey = observedProcessKey("win32", value.ProcessId, value.CreationDate, executablePathDigest);
         if (startedAt === undefined || processKey === undefined)
             continue;
@@ -199,6 +352,23 @@ async function readWindowsProcesses() {
     }
     return processes;
 }
+/**
+ * One spelling of a Windows executable path, so a process has the same
+ * identity whichever listing found it. Win32_Process reports the path the
+ * process was started with (`C:\windows\Explorer.EXE`,
+ * `C:\Program Files\Git\bin\..\usr\bin\bash.exe`); the native helper reports
+ * the file's own path (`C:\Windows\explorer.exe`). Windows paths are
+ * case-insensitive, so case, `.` and `..` segments and a `\\?\` prefix are
+ * removed. A path reached through a junction still differs from its target.
+ */
+export function windowsPathIdentity(path) {
+    let value = path;
+    if (/^\\\\\?\\UNC\\/iu.test(value))
+        value = `\\\\${value.slice(8)}`;
+    else if (value.startsWith("\\\\?\\"))
+        value = value.slice(4);
+    return win32.normalize(value).toLowerCase();
+}
 async function readVersion(executablePath) {
     try {
         // npm exposes .cmd shims on Windows, which execFile cannot launch.
@@ -210,7 +380,10 @@ async function readVersion(executablePath) {
         if (script !== undefined)
             await access(script, constants.F_OK);
         const execution = execFileAsync(script === undefined ? executablePath : "powershell.exe", script === undefined ? ["--version"] : ["-NoProfile", "-NonInteractive", "-File", script, "--version"], {
-            timeout: 5_000,
+            // Starting PowerShell alone can take several seconds on a busy or
+            // closely monitored computer, as for the PowerShell process listing.
+            // A probe result is cached, so a slow start is paid once per CLI.
+            timeout: script === undefined ? 5_000 : 15_000,
             maxBuffer: 4_096,
             encoding: "utf8",
             windowsHide: true,

package/dist/src/discovery/system-evidence.js.map

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

package/dist/src/doctor-check.d.ts

@@ -0,0 +1,51 @@
+import type { ObserverConfig } from "./config.js";
+import { type ObserverConsentHealth } from "./health.js";
+import { type InstanceLockHolder } from "./instance-lock.js";
+/**
+ * Exit codes of `doctor --check`, for device management scripts. The first
+ * failing check, in this order, decides the code.
+ */
+export declare const doctorCheckExitCodes: Readonly<{
+    ok: 0;
+    notPaired: 3;
+    consentMissing: 4;
+    notRunning: 5;
+    deliveryStale: 6;
+    controlPlaneUnreachable: 7;
+}>;
+export declare const defaultMaxDeliveryAgeMinutes = 15;
+export type DoctorCheckName = "paired" | "consent" | "running" | "delivery" | "control_plane";
+export type DoctorCheck = Readonly<{
+    name: DoctorCheckName;
+    status: "pass" | "fail" | "skip";
+    detail: string;
+}>;
+export type DoctorCheckReport = Readonly<{
+    ok: boolean;
+    exitCode: number;
+    observerVersion: string;
+    dataDirectory: string;
+    controlPlaneOrigin: string;
+    maxDeliveryAgeMinutes: number;
+    /** How this computer consented, when it is paired with this server. */
+    consent?: ObserverConsentHealth;
+    checks: readonly DoctorCheck[];
+    checkedAt: string;
+}>;
+export type DoctorCheckOptions = Readonly<{
+    config: ObserverConfig;
+    observerVersion: string;
+    maxDeliveryAgeMinutes?: number;
+    now?: () => Date;
+    fetcher?: typeof fetch;
+    inspectLock?: (dataDirectory: string) => Promise<InstanceLockHolder>;
+    probeTimeoutMs?: number;
+}>;
+/**
+ * Checks, without sending any activity, that this computer is paired with
+ * current consent, that an observer is running, that the workspace has
+ * confirmed delivery recently, and that the control plane answers.
+ */
+export declare function runDoctorCheck(options: DoctorCheckOptions): Promise<DoctorCheckReport>;
+export declare function formatDoctorCheck(report: DoctorCheckReport): string;
+//# sourceMappingURL=doctor-check.d.ts.map

package/dist/src/doctor-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-check.d.ts","sourceRoot":"","sources":["../../src/doctor-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAiB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAI3E;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;EAO/B,CAAC;AAEH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAG/C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC;AAE9F,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uEAAuE;IACvE,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAUH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8F5F;AAgDD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAgBnE"}

package/dist/src/doctor-check.js

@@ -0,0 +1,174 @@
+import { FileCredentialStore } from "./credential-store.js";
+import { consentHealth } from "./health.js";
+import { InstanceLock } from "./instance-lock.js";
+import { OBSERVER_CONSENT_POLICY_VERSION } from "./pair.js";
+import { StreamStateStore } from "./stream-state.js";
+/**
+ * Exit codes of `doctor --check`, for device management scripts. The first
+ * failing check, in this order, decides the code.
+ */
+export const doctorCheckExitCodes = Object.freeze({
+    ok: 0,
+    notPaired: 3,
+    consentMissing: 4,
+    notRunning: 5,
+    deliveryStale: 6,
+    controlPlaneUnreachable: 7,
+});
+export const defaultMaxDeliveryAgeMinutes = 15;
+const probeTimeoutMs = 5_000;
+const exitCodeFor = Object.freeze({
+    paired: doctorCheckExitCodes.notPaired,
+    consent: doctorCheckExitCodes.consentMissing,
+    running: doctorCheckExitCodes.notRunning,
+    delivery: doctorCheckExitCodes.deliveryStale,
+    control_plane: doctorCheckExitCodes.controlPlaneUnreachable,
+});
+/**
+ * Checks, without sending any activity, that this computer is paired with
+ * current consent, that an observer is running, that the workspace has
+ * confirmed delivery recently, and that the control plane answers.
+ */
+export async function runDoctorCheck(options) {
+    const { config } = options;
+    const now = (options.now ?? (() => new Date()))();
+    const maxAge = options.maxDeliveryAgeMinutes ?? defaultMaxDeliveryAgeMinutes;
+    const checks = [];
+    let credential = null;
+    try {
+        credential = await new FileCredentialStore(config.dataDirectory).load();
+        if (credential === null) {
+            checks.push(fail("paired", "This computer is not paired. Run phigon-observer pair with a code from Connect machine."));
+        }
+        else if (credential.controlPlaneOrigin !== config.controlPlaneUrl.origin) {
+            checks.push(fail("paired", `This computer is paired with ${credential.controlPlaneOrigin}, but the observer is set up for ${config.controlPlaneUrl.origin}.`));
+            credential = null;
+        }
+        else {
+            checks.push(pass("paired", `Paired as machine ${credential.machineId} with ${credential.controlPlaneOrigin}.`));
+        }
+    }
+    catch (error) {
+        checks.push(fail("paired", error instanceof Error ? error.message : "Stored pairing data could not be read."));
+    }
+    const consent = credential === null ? undefined : consentHealth(credential);
+    if (credential === null || consent === undefined) {
+        checks.push(skip("consent", "Needs pairing first."));
+    }
+    else if (credential.consentProfile === undefined ||
+        credential.consentPolicyVersion !== OBSERVER_CONSENT_POLICY_VERSION) {
+        // A company's consent is stored only with its profile, so this is an
+        // owner's consent from before profiles, or from an older policy.
+        checks.push(fail("consent", "The owner's consent is missing or out of date. Pair again with --consent-profile metadata or --consent-profile full."));
+    }
+    else {
+        const when = credential.consentedAt === undefined ? "" : ` on ${credential.consentedAt}`;
+        checks.push(pass("consent", consent.source === "company"
+            ? `Your company consented for this computer to the ${credential.consentProfile} profile${consent.enrollmentCodeLabel === undefined ? " with an enrollment code" : ` with the enrollment code "${consent.enrollmentCodeLabel}"`}${when}.`
+            : `The owner consented to the ${credential.consentProfile} profile${when}.`));
+    }
+    try {
+        const holder = await (options.inspectLock ?? ((directory) => InstanceLock.inspect(directory)))(config.dataDirectory);
+        checks.push(holder.running
+            ? pass("running", `An observer is running with this data directory${holder.pid === undefined ? "" : ` (process ${holder.pid})`}.`)
+            : fail("running", "No observer is running with this data directory. Start it with phigon-observer service install, or run phigon-observer run."));
+    }
+    catch {
+        checks.push(fail("running", "Could not tell whether an observer is running: its lock file could not be read."));
+    }
+    if (credential === null) {
+        checks.push(skip("delivery", "Needs pairing first."));
+    }
+    else {
+        try {
+            const state = await new StreamStateStore(config.dataDirectory).load(credential.machineId);
+            const confirmedAt = Date.parse(state.updatedAt);
+            const minutes = Math.floor((now.getTime() - confirmedAt) / 60_000);
+            if (confirmedAt <= 0) {
+                checks.push(fail("delivery", "The workspace has not confirmed any delivery from this computer yet."));
+            }
+            else if (minutes > maxAge) {
+                checks.push(fail("delivery", `Nothing has been delivered to the workspace for ${minutes} minutes (last confirmed ${state.updatedAt}).`));
+            }
+            else {
+                checks.push(pass("delivery", `The workspace last confirmed delivery ${Math.max(0, minutes)} minutes ago.`));
+            }
+        }
+        catch {
+            checks.push(fail("delivery", "The stored stream checkpoint could not be read."));
+        }
+    }
+    checks.push(await probeControlPlane(config.controlPlaneUrl, options.fetcher ?? fetch, options.probeTimeoutMs ?? probeTimeoutMs));
+    const failed = checks.find((check) => check.status === "fail");
+    return Object.freeze({
+        ok: failed === undefined,
+        exitCode: failed === undefined ? doctorCheckExitCodes.ok : exitCodeFor[failed.name],
+        observerVersion: options.observerVersion,
+        dataDirectory: config.dataDirectory,
+        controlPlaneOrigin: config.controlPlaneUrl.origin,
+        maxDeliveryAgeMinutes: maxAge,
+        ...(consent === undefined ? {} : { consent }),
+        checks: Object.freeze(checks),
+        checkedAt: now.toISOString(),
+    });
+}
+/** GET /healthz, through the configured proxy and the pinned authority. */
+async function probeControlPlane(url, fetcher, timeoutMs) {
+    const endpoint = new URL("/healthz", url);
+    const started = performance.now();
+    try {
+        const response = await fetcher(endpoint, {
+            method: "GET",
+            headers: { Accept: "application/json" },
+            redirect: "error",
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        await response.body?.cancel().catch(() => undefined);
+        if (!response.ok) {
+            return fail("control_plane", `The control plane at ${url.origin} answered HTTP ${response.status}.`);
+        }
+        return pass("control_plane", `The control plane at ${url.origin} answered in ${Math.round(performance.now() - started)} ms.`);
+    }
+    catch (error) {
+        const reason = error instanceof Error && error.name === "TimeoutError"
+            ? `no answer within ${Math.round(timeoutMs / 1_000)} seconds`
+            : errorCode(error) ?? "the connection failed";
+        return fail("control_plane", `Could not reach the control plane at ${url.origin} (${reason}).`);
+    }
+}
+/** A system error code such as ENOTFOUND or a certificate error, never a message with data. */
+function errorCode(error) {
+    for (let current = error, depth = 0; current instanceof Error && depth < 4; depth++) {
+        const code = current.code;
+        if (typeof code === "string" && /^[A-Z0-9_]{2,64}$/u.test(code))
+            return code;
+        current = current.cause;
+    }
+    return undefined;
+}
+function pass(name, detail) {
+    return Object.freeze({ name, status: "pass", detail });
+}
+function fail(name, detail) {
+    return Object.freeze({ name, status: "fail", detail });
+}
+function skip(name, detail) {
+    return Object.freeze({ name, status: "skip", detail });
+}
+export function formatDoctorCheck(report) {
+    const labels = {
+        paired: "Pairing",
+        consent: "Consent",
+        running: "Observer",
+        delivery: "Delivery",
+        control_plane: "Control plane",
+    };
+    return [
+        report.ok
+            ? "Phigon observer check passed."
+            : `Phigon observer check found a problem (exit code ${report.exitCode}).`,
+        ...report.checks.map((check) => `${check.status === "pass" ? "ok  " : check.status === "fail" ? "FAIL" : "skip"}  ${labels[check.name].padEnd(13)} ${check.detail}`),
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=doctor-check.js.map

package/dist/src/doctor-check.js.map

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