@a11yst/cli 1.0.0

package/dist/commands/detect.d.ts

@@ -0,0 +1,12 @@
+import type { ProjectDetectionResult, WorkspaceDetectionResult } from "@a11yst/types";
+/**
+ * Run static detection for `options.cwd`. A thin pass-through to
+ * `@a11yst/detect` — no additional heuristics live here.
+ */
+export declare function runDetect(options: {
+    cwd: string;
+    workspace?: boolean;
+}): Promise<ProjectDetectionResult | WorkspaceDetectionResult>;
+export declare function formatDetectHuman(result: ProjectDetectionResult | WorkspaceDetectionResult): string;
+export declare function formatDetectJson(result: ProjectDetectionResult | WorkspaceDetectionResult): unknown;
+//# sourceMappingURL=detect.d.ts.map

package/dist/commands/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/commands/detect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAOV,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,eAAe,CAAC;AAqBvB;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,sBAAsB,GAAG,wBAAwB,CAAC,CAK7D;AAsFD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,sBAAsB,GAAG,wBAAwB,GACxD,MAAM,CA4BR;AAmED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,sBAAsB,GAAG,wBAAwB,GACxD,OAAO,CA0BT"}

package/dist/commands/detect.js

@@ -0,0 +1,213 @@
+import { detectProject, detectWorkspace } from "@a11yst/detect";
+import { productMetadata } from "@a11yst/types";
+import { formatLabelValue } from "../output.js";
+const EVIDENCE_TYPE_LABELS = {
+    dependency: "Dependency",
+    devDependency: "Dev dependency",
+    file: "File",
+    directory: "Directory",
+    "package-script": "Script",
+    configuration: "Configuration",
+    workspace: "Workspace",
+    fallback: "Fallback",
+};
+function isWorkspaceResult(result) {
+    return "projects" in result;
+}
+/**
+ * Run static detection for `options.cwd`. A thin pass-through to
+ * `@a11yst/detect` — no additional heuristics live here.
+ */
+export async function runDetect(options) {
+    if (options.workspace) {
+        return detectWorkspace({ cwd: options.cwd });
+    }
+    return detectProject({ cwd: options.cwd });
+}
+function isAmbiguous(project) {
+    const framework = project.framework;
+    if (framework.diagnostics.some((d) => d.code === "FRAMEWORK_AMBIGUOUS")) {
+        return true;
+    }
+    return ((framework.confidence === "medium" || framework.confidence === "low") &&
+        framework.alternatives.length > 0);
+}
+function formatEvidenceLines(evidence) {
+    if (evidence.length === 0) {
+        return [];
+    }
+    return [
+        "Evidence",
+        ...evidence.map((item) => `- ${EVIDENCE_TYPE_LABELS[item.type]}: ${item.value}`),
+    ];
+}
+function formatDiagnosticsLines(diagnostics) {
+    if (diagnostics.length === 0) {
+        return [];
+    }
+    const lines = ["Diagnostics"];
+    for (const diagnostic of diagnostics) {
+        lines.push(`- [${diagnostic.code}] ${diagnostic.message}`);
+        if (diagnostic.hint) {
+            lines.push(`  Hint: ${diagnostic.hint}`);
+        }
+    }
+    return lines;
+}
+function formatProjectLines(project) {
+    const framework = project.framework;
+    const ambiguous = isAmbiguous(project);
+    const bestDevServer = project.devServers[0];
+    const topAlternative = framework.alternatives[0];
+    const lines = [ambiguous ? "Framework detection is ambiguous." : "Project detection", ""];
+    lines.push(formatLabelValue("Root", project.relativeRoot));
+    lines.push(formatLabelValue("Platform", framework.platform));
+    if (ambiguous) {
+        lines.push(formatLabelValue("Selected", framework.framework));
+        if (topAlternative) {
+            lines.push(formatLabelValue("Alternative", topAlternative.framework));
+        }
+    }
+    else {
+        lines.push(formatLabelValue("Framework", framework.framework));
+    }
+    lines.push(formatLabelValue("Support", framework.supportLevel));
+    lines.push(formatLabelValue("Confidence", framework.confidence));
+    lines.push(formatLabelValue("Package mgr", project.packageManager.name));
+    if (bestDevServer?.command) {
+        lines.push(formatLabelValue("Dev command", bestDevServer.command));
+    }
+    if (bestDevServer?.inferredUrl) {
+        lines.push(formatLabelValue("URL", bestDevServer.inferredUrl));
+        if (bestDevServer.inferredUrlSource) {
+            lines.push(formatLabelValue("URL source", bestDevServer.inferredUrlSource));
+        }
+    }
+    const evidenceLines = formatEvidenceLines(framework.evidence);
+    if (evidenceLines.length > 0) {
+        lines.push("", ...evidenceLines);
+    }
+    const allDiagnostics = [
+        ...project.diagnostics,
+        ...framework.diagnostics,
+        ...project.packageManager.diagnostics,
+    ];
+    const diagnosticsLines = formatDiagnosticsLines(allDiagnostics);
+    if (diagnosticsLines.length > 0) {
+        lines.push("", ...diagnosticsLines);
+    }
+    return lines;
+}
+export function formatDetectHuman(result) {
+    if (!isWorkspaceResult(result)) {
+        return formatProjectLines(result.project).join("\n");
+    }
+    const lines = ["Workspace detection", ""];
+    lines.push(formatLabelValue("Root", result.workspaceRoot));
+    lines.push(formatLabelValue("Package mgr", result.packageManager.name));
+    lines.push(formatLabelValue("Projects", String(result.projects.length)));
+    if (result.projects.length === 0) {
+        lines.push("", "No auditable projects were found.");
+    }
+    else {
+        for (const project of result.projects) {
+            lines.push("");
+            lines.push(`- ${project.relativeRoot}`);
+            lines.push(`    ${formatLabelValue("Platform", project.framework.platform, 12)}`);
+            lines.push(`    ${formatLabelValue("Framework", project.framework.framework, 12)}`);
+            lines.push(`    ${formatLabelValue("Confidence", project.framework.confidence, 12)}`);
+        }
+    }
+    const diagnosticsLines = formatDiagnosticsLines(result.diagnostics);
+    if (diagnosticsLines.length > 0) {
+        lines.push("", ...diagnosticsLines);
+    }
+    return lines.join("\n");
+}
+function serializeEvidence(evidence) {
+    return evidence.map((item) => ({
+        type: item.type,
+        value: item.value,
+        description: item.description,
+        weight: item.weight,
+    }));
+}
+function serializeDiagnostics(diagnostics) {
+    return diagnostics.map((diagnostic) => ({
+        code: diagnostic.code,
+        severity: diagnostic.severity,
+        message: diagnostic.message,
+        hint: diagnostic.hint,
+        path: diagnostic.path,
+    }));
+}
+function serializeFrameworkCandidate(candidate) {
+    return {
+        framework: candidate.framework,
+        score: candidate.score,
+        evidence: serializeEvidence(candidate.evidence),
+    };
+}
+function serializeDevServer(devServer) {
+    return {
+        command: devServer.command,
+        sourceScript: devServer.sourceScript,
+        confidence: devServer.confidence,
+        inferredPort: devServer.inferredPort,
+        inferredUrl: devServer.inferredUrl,
+        evidence: serializeEvidence(devServer.evidence),
+    };
+}
+function serializeProject(project) {
+    return {
+        name: project.name,
+        rootDir: project.rootDir,
+        relativeRoot: project.relativeRoot,
+        isLibrary: project.isLibrary,
+        framework: {
+            platform: project.framework.platform,
+            framework: project.framework.framework,
+            supportLevel: project.framework.supportLevel,
+            confidence: project.framework.confidence,
+            score: project.framework.score,
+            evidence: serializeEvidence(project.framework.evidence),
+            alternatives: project.framework.alternatives.map(serializeFrameworkCandidate),
+            diagnostics: serializeDiagnostics(project.framework.diagnostics),
+        },
+        packageManager: {
+            name: project.packageManager.name,
+            confidence: project.packageManager.confidence,
+            evidence: serializeEvidence(project.packageManager.evidence),
+            diagnostics: serializeDiagnostics(project.packageManager.diagnostics),
+        },
+        devServers: project.devServers.map(serializeDevServer),
+        diagnostics: serializeDiagnostics(project.diagnostics),
+    };
+}
+export function formatDetectJson(result) {
+    if (isWorkspaceResult(result)) {
+        return {
+            kind: "workspace",
+            product: productMetadata.name,
+            cwd: result.cwd,
+            workspaceRoot: result.workspaceRoot,
+            packageManager: {
+                name: result.packageManager.name,
+                confidence: result.packageManager.confidence,
+                evidence: serializeEvidence(result.packageManager.evidence),
+                diagnostics: serializeDiagnostics(result.packageManager.diagnostics),
+            },
+            projects: result.projects.map(serializeProject),
+            diagnostics: serializeDiagnostics(result.diagnostics),
+        };
+    }
+    return {
+        kind: "project",
+        product: productMetadata.name,
+        cwd: result.cwd,
+        rootDir: result.rootDir,
+        project: serializeProject(result.project),
+        diagnostics: serializeDiagnostics(result.diagnostics),
+    };
+}
+//# sourceMappingURL=detect.js.map

package/dist/commands/detect.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,16 @@
+export type DoctorStatus = "ok" | "warn" | "fail";
+export interface DoctorCheck {
+    id: string;
+    title: string;
+    status: DoctorStatus;
+    detail: string;
+    hint?: string;
+}
+export interface DoctorReport {
+    status: DoctorStatus;
+    checks: DoctorCheck[];
+}
+export declare function runDoctor(cwd: string): Promise<DoctorReport>;
+export declare function formatDoctorHuman(report: DoctorReport): string;
+export declare function formatDoctorJson(report: DoctorReport): unknown;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AA4UD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAmGlE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAkB9D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAM9D"}

package/dist/commands/doctor.js

@@ -0,0 +1,404 @@
+import { accessSync, constants, existsSync, mkdirSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { ConfigError, findConfigPath, loadConfig, resolveProjectPath, } from "@a11yst/config";
+import { detectPackageManager, detectProject, detectWorkspace, readPackageJson } from "@a11yst/detect";
+import { createAdapterContext, FIRST_CLASS_ADAPTERS, readAngularJson, resolveAdapter, } from "@a11yst/adapters";
+import { productMetadata } from "@a11yst/types";
+function worstStatus(statuses) {
+    if (statuses.includes("fail"))
+        return "fail";
+    if (statuses.includes("warn"))
+        return "warn";
+    return "ok";
+}
+function parseVersion(raw) {
+    return raw
+        .replace(/^v/, "")
+        .split(".")
+        .map((part) => Number.parseInt(part, 10) || 0);
+}
+function isNodeCompatible(current, minimum) {
+    const a = parseVersion(current);
+    const b = parseVersion(minimum);
+    for (let i = 0; i < Math.max(a.length, b.length); i += 1) {
+        const left = a[i] ?? 0;
+        const right = b[i] ?? 0;
+        if (left > right)
+            return true;
+        if (left < right)
+            return false;
+    }
+    return true;
+}
+/** Best-effort extraction of the package.json script name a dev command invokes. */
+function extractScriptName(command) {
+    const trimmed = command.trim();
+    const runMatch = /^(?:npm|bun)\s+run\s+(\S+)/.exec(trimmed);
+    if (runMatch?.[1])
+        return runMatch[1];
+    const directMatch = /^(?:pnpm|yarn)\s+(\S+)/.exec(trimmed);
+    if (directMatch?.[1])
+        return directMatch[1];
+    const parts = trimmed.split(/\s+/).filter(Boolean);
+    return parts.length > 0 ? parts[parts.length - 1] : undefined;
+}
+function checkArtifactsWritable(cwd) {
+    const artifactsDir = join(cwd, ".a11yst");
+    const probe = join(artifactsDir, `.doctor-write-${process.pid}`);
+    try {
+        mkdirSync(artifactsDir, { recursive: true });
+        accessSync(artifactsDir, constants.W_OK);
+        // Touch and clean a probe file under the artifacts directory.
+        mkdirSync(probe, { recursive: true });
+        rmSync(probe, { recursive: true, force: true });
+        return {
+            id: "artifacts-writable",
+            title: "Artifacts directory",
+            status: "ok",
+            detail: `Writable artifacts directory available at ${artifactsDir}.`,
+        };
+    }
+    catch (error) {
+        // Fallback: try system temp to distinguish permission vs path issues
+        const tempProbe = join(tmpdir(), `a11yst-doctor-${process.pid}`);
+        try {
+            mkdirSync(tempProbe, { recursive: true });
+            rmSync(tempProbe, { recursive: true, force: true });
+        }
+        catch {
+            // ignore
+        }
+        return {
+            id: "artifacts-writable",
+            title: "Artifacts directory",
+            status: "fail",
+            detail: `Cannot write to ${artifactsDir}: ${error instanceof Error ? error.message : String(error)}`,
+            hint: `Ensure the project directory is writable so ${productMetadata.name} can store future reports.`,
+        };
+    }
+}
+function checkPackageManager(cwd) {
+    const manifest = readPackageJson(cwd);
+    const detection = detectPackageManager(cwd, manifest);
+    const unknown = detection.name === "unknown";
+    return {
+        id: "package-manager",
+        title: "Package manager",
+        status: unknown ? "warn" : "ok",
+        detail: unknown
+            ? "No lockfile or packageManager field detected."
+            : `Detected package manager: ${detection.name} (confidence: ${detection.confidence}).`,
+        hint: unknown ? "This is optional. A lockfile helps reproducible installs." : undefined,
+    };
+}
+async function checkProjectsAgainstDetection(config) {
+    const checks = [];
+    for (const project of config.projects) {
+        const rootAbs = resolveProjectPath(config.configDir, project.rootDir);
+        if (!existsSync(rootAbs)) {
+            checks.push({
+                id: `project-root:${project.name}`,
+                title: `Project root (${project.name})`,
+                status: "fail",
+                detail: `Configured rootDir "${project.rootDir}" for project "${project.name}" does not exist at ${rootAbs}.`,
+                hint: "Fix rootDir in the configuration or create the missing directory.",
+            });
+            continue;
+        }
+        checks.push({
+            id: `project-root:${project.name}`,
+            title: `Project root (${project.name})`,
+            status: "ok",
+            detail: `Root directory exists at ${rootAbs}.`,
+        });
+        const detection = await detectProject({ cwd: rootAbs });
+        const detectedFramework = detection.project.framework;
+        if (detectedFramework.platform !== "unknown" && detectedFramework.platform !== project.platform) {
+            checks.push({
+                id: `platform-match:${project.name}`,
+                title: `Platform match (${project.name})`,
+                status: "fail",
+                detail: `Project "${project.name}" is configured as "${project.platform}" but detection found "${detectedFramework.platform}".`,
+                hint: `Update platform to "${detectedFramework.platform}", or verify rootDir points at the intended project.`,
+            });
+        }
+        else {
+            checks.push({
+                id: `platform-match:${project.name}`,
+                title: `Platform match (${project.name})`,
+                status: "ok",
+                detail: `Configured platform "${project.platform}" agrees with detection.`,
+            });
+        }
+        if (detectedFramework.framework === "unknown") {
+            const configuredIsUnknown = project.framework === "unknown";
+            checks.push({
+                id: `framework-match:${project.name}`,
+                title: `Framework detection (${project.name})`,
+                status: configuredIsUnknown ? "ok" : "warn",
+                detail: configuredIsUnknown
+                    ? `No framework signals detected for "${project.name}"; framework remains "unknown".`
+                    : `Configured framework "${project.framework}" could not be verified: no recognizable framework signals were found at ${rootAbs}.`,
+                hint: configuredIsUnknown ? undefined : "Confirm the framework value manually.",
+            });
+        }
+        else if (detectedFramework.framework !== project.framework) {
+            checks.push({
+                id: `framework-match:${project.name}`,
+                title: `Framework detection (${project.name})`,
+                status: "warn",
+                detail: `Project "${project.name}" is configured with framework "${project.framework}" but detection found "${detectedFramework.framework}" (confidence: ${detectedFramework.confidence}).`,
+                hint: "Update the framework in the configuration if detection is correct.",
+            });
+        }
+        else {
+            checks.push({
+                id: `framework-match:${project.name}`,
+                title: `Framework detection (${project.name})`,
+                status: "ok",
+                detail: `Configured framework "${project.framework}" agrees with detection (confidence: ${detectedFramework.confidence}).`,
+            });
+        }
+        if (project.platform === "web" && project.devServer?.command) {
+            const scriptName = extractScriptName(project.devServer.command);
+            const manifest = readPackageJson(rootAbs);
+            const scripts = manifest?.scripts ?? {};
+            const hasScript = scriptName !== undefined && Object.hasOwn(scripts, scriptName);
+            checks.push({
+                id: `dev-server-script:${project.name}`,
+                title: `Dev server script (${project.name})`,
+                status: hasScript ? "ok" : "warn",
+                detail: hasScript
+                    ? `Script "${scriptName}" referenced by devServer.command exists in package.json.`
+                    : `Could not find a package.json script matching devServer.command "${project.devServer.command}" at ${rootAbs}.`,
+                hint: hasScript ? undefined : "Verify devServer.command matches an existing package.json script.",
+            });
+        }
+    }
+    return checks;
+}
+const META_FRAMEWORK_PAIRS = [
+    { detected: "next", misconfigured: "react", label: "Next.js detected but configured as React" },
+    { detected: "nuxt", misconfigured: "vue", label: "Nuxt detected but configured as Vue" },
+];
+const FIRST_CLASS_FRAMEWORKS = new Set(FIRST_CLASS_ADAPTERS.map((adapter) => adapter.framework));
+async function checkAdapterIntegration(config, project) {
+    const checks = [];
+    const rootAbs = resolveProjectPath(config.configDir, project.rootDir);
+    const detection = await detectProject({ cwd: rootAbs });
+    const detectedFramework = detection.project.framework.framework;
+    for (const pair of META_FRAMEWORK_PAIRS) {
+        if (detectedFramework === pair.detected &&
+            project.framework === pair.misconfigured) {
+            checks.push({
+                id: `adapter-meta-framework:${project.name}`,
+                title: `Adapter mismatch (${project.name})`,
+                status: "warn",
+                detail: `${pair.label}. Use framework "${pair.detected}" for dedicated route discovery and readiness.`,
+                hint: `Update framework to "${pair.detected}" in the configuration.`,
+            });
+        }
+    }
+    if (project.adapterId === "generic-web" &&
+        detectedFramework !== "unknown" &&
+        FIRST_CLASS_FRAMEWORKS.has(detectedFramework)) {
+        checks.push({
+            id: `adapter-generic-web:${project.name}`,
+            title: `Adapter selection (${project.name})`,
+            status: "warn",
+            detail: `Project "${project.name}" resolves to the generic-web adapter but detection found first-class framework "${detectedFramework}".`,
+            hint: `Set framework to "${detectedFramework}" for adapter-specific route discovery and readiness.`,
+        });
+    }
+    else if (project.adapterId === "generic-web" &&
+        !FIRST_CLASS_FRAMEWORKS.has(project.framework)) {
+        checks.push({
+            id: `adapter-generic-web:${project.name}`,
+            title: `Adapter selection (${project.name})`,
+            status: "ok",
+            detail: `Framework "${project.framework}" uses the generic-web adapter (support varies by framework).`,
+        });
+    }
+    const adapter = resolveAdapter({ framework: project.framework, platform: project.platform }) ??
+        resolveAdapter({ framework: "unknown", platform: "web" });
+    if (adapter) {
+        const context = createAdapterContext(rootAbs, config.configDir, project);
+        const discovery = await adapter.discoverRoutes(context);
+        const adapterDiagnostics = await adapter.getDiagnostics(context);
+        for (const diagnostic of [...discovery.diagnostics, ...adapterDiagnostics]) {
+            checks.push({
+                id: `adapter-diagnostic:${project.name}:${diagnostic.code}`,
+                title: `Adapter diagnostic (${project.name})`,
+                status: diagnostic.severity === "error"
+                    ? "fail"
+                    : diagnostic.severity === "warning"
+                        ? "warn"
+                        : "ok",
+                detail: diagnostic.message,
+                hint: diagnostic.hint,
+            });
+        }
+        const samples = project.routeDiscovery.samples;
+        for (const skipped of discovery.skippedPatterns) {
+            const samplePaths = samples[skipped.pattern];
+            if (!samplePaths || samplePaths.length === 0) {
+                checks.push({
+                    id: `adapter-dynamic-samples:${project.name}:${skipped.pattern}`,
+                    title: `Dynamic route samples (${project.name})`,
+                    status: "warn",
+                    detail: `Dynamic pattern "${skipped.pattern}" has no samples configured.`,
+                    hint: 'Add sample paths under routeDiscovery.samples or list explicit routes.',
+                });
+            }
+        }
+    }
+    if (project.framework === "angular" || detectedFramework === "angular") {
+        const angularJson = readAngularJson(rootAbs);
+        const projectNames = angularJson?.projects
+            ? Object.keys(angularJson.projects)
+            : [];
+        if (projectNames.length > 1 && !angularJson?.defaultProject) {
+            checks.push({
+                id: `adapter-angular-workspace:${project.name}`,
+                title: `Angular workspace (${project.name})`,
+                status: "warn",
+                detail: `angular.json defines ${projectNames.length} projects without defaultProject.`,
+                hint: "Set defaultProject in angular.json or list routes explicitly in a11yst.config.ts.",
+            });
+        }
+    }
+    return checks;
+}
+async function checkWorkspaceCoverage(cwd, config) {
+    const workspace = await detectWorkspace({ cwd });
+    const isRealWorkspace = !workspace.diagnostics.some((d) => d.code === "WORKSPACE_CONFIG_NOT_FOUND");
+    if (!isRealWorkspace || workspace.projects.length <= config.projects.length) {
+        return undefined;
+    }
+    const configuredRoots = new Set(config.projects.map((project) => resolve(resolveProjectPath(config.configDir, project.rootDir))));
+    const unconfigured = workspace.projects.filter((project) => !configuredRoots.has(resolve(project.rootDir)));
+    if (unconfigured.length === 0) {
+        return undefined;
+    }
+    return {
+        id: "workspace-coverage",
+        title: "Workspace coverage",
+        status: "warn",
+        detail: `Workspace has ${workspace.projects.length} detected app(s) but only ${config.projects.length} configured. Unconfigured: ${unconfigured
+            .map((project) => project.relativeRoot)
+            .join(", ")}.`,
+        hint: "Add these projects to the configuration if they should be audited, or ignore this if intentional.",
+    };
+}
+export async function runDoctor(cwd) {
+    const checks = [];
+    const nodeOk = isNodeCompatible(process.versions.node, productMetadata.minNodeVersion);
+    checks.push({
+        id: "node-version",
+        title: "Node.js version",
+        status: nodeOk ? "ok" : "fail",
+        detail: nodeOk
+            ? `Node.js ${process.versions.node} satisfies minimum ${productMetadata.minNodeVersion}.`
+            : `Node.js ${process.versions.node} is below minimum ${productMetadata.minNodeVersion}.`,
+        hint: nodeOk
+            ? undefined
+            : `Upgrade Node.js to ${productMetadata.minNodeVersion} or newer.`,
+    });
+    const configPath = findConfigPath(cwd);
+    let config;
+    if (!configPath) {
+        checks.push({
+            id: "config-exists",
+            title: "Configuration file",
+            status: "fail",
+            detail: `No ${productMetadata.command}.config.* found from ${cwd}.`,
+            hint: `Run \`${productMetadata.command} init\` to create a starter configuration.`,
+        });
+    }
+    else {
+        checks.push({
+            id: "config-exists",
+            title: "Configuration file",
+            status: "ok",
+            detail: `Found ${configPath}.`,
+        });
+        try {
+            config = await loadConfig({ cwd, configPath });
+            checks.push({
+                id: "config-valid",
+                title: "Configuration validity",
+                status: "ok",
+                detail: `Configuration is valid (${config.projects.length} project(s)).`,
+            });
+        }
+        catch (error) {
+            const detail = error instanceof ConfigError
+                ? error.format()
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            checks.push({
+                id: "config-valid",
+                title: "Configuration validity",
+                status: "fail",
+                detail,
+                hint: error instanceof ConfigError
+                    ? error.hint
+                    : "Fix validation errors in the configuration file.",
+            });
+        }
+    }
+    checks.push(checkArtifactsWritable(cwd));
+    checks.push(checkPackageManager(cwd));
+    if (config) {
+        checks.push(...(await checkProjectsAgainstDetection(config)));
+        for (const project of config.projects) {
+            if (project.platform === "web") {
+                checks.push(...(await checkAdapterIntegration(config, project)));
+            }
+        }
+        for (const [index, diagnostic] of config.diagnostics.entries()) {
+            checks.push({
+                id: `config-diagnostic:${diagnostic.code}:${index}`,
+                title: `Configuration diagnostic (${diagnostic.code})`,
+                status: diagnostic.severity === "error" ? "fail" : diagnostic.severity === "warning" ? "warn" : "ok",
+                detail: diagnostic.message,
+                hint: diagnostic.hint,
+            });
+        }
+        const workspaceCheck = await checkWorkspaceCoverage(cwd, config);
+        if (workspaceCheck) {
+            checks.push(workspaceCheck);
+        }
+    }
+    return {
+        status: worstStatus(checks.map((check) => check.status)),
+        checks,
+    };
+}
+export function formatDoctorHuman(report) {
+    const lines = [
+        "Environment check",
+        "",
+        `Overall status: ${report.status.toUpperCase()}`,
+        "",
+    ];
+    for (const check of report.checks) {
+        lines.push(`[${check.status.toUpperCase()}] ${check.title}`);
+        lines.push(`  ${check.detail}`);
+        if (check.hint) {
+            lines.push(`  Hint: ${check.hint}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+}
+export function formatDoctorJson(report) {
+    return {
+        status: report.status,
+        product: productMetadata.name,
+        checks: report.checks,
+    };
+}
+//# sourceMappingURL=doctor.js.map