meodp 0.0.8 → 0.1.0

package/dist/check/index.d.cts

@@ -0,0 +1,107 @@
+interface LinkTarget {
+    url: string;
+    name?: string;
+}
+type Availability = 'reachable' | 'restricted' | 'unavailable';
+type FailureReason = 'http' | 'dns' | 'tls' | 'timeout' | 'network' | 'redirect';
+interface LinkObservation extends LinkTarget {
+    status: Availability;
+    checkedAt: string;
+    durationMs: number;
+    attempts: number;
+    finalUrl: string;
+    httpStatus?: number;
+    redirects: {
+        url: string;
+        status: number;
+        location: string;
+    }[];
+    reason?: FailureReason;
+    detail?: string;
+    consecutiveFailures: number;
+    firstFailureAt?: string;
+    lastSuccessAt?: string;
+    changed: boolean;
+    recovered: boolean;
+}
+interface CheckReport {
+    schemaVersion: 1;
+    observer: string;
+    startedAt: string;
+    completedAt: string;
+    summary: Record<Availability, number> & {
+        total: number;
+        redirected: number;
+        recovered: number;
+    };
+    results: LinkObservation[];
+}
+interface CheckOptions {
+    /** Maximum simultaneous site checks. Default: 5. */
+    concurrency?: number;
+    /** Timeout for each HTTP request, including its body. Default: 10000 ms. */
+    timeoutMs?: number;
+    /** Retries for transport errors and 5xx responses. Default: 1; 429 is not retried. */
+    retries?: number;
+    /** Maximum followed redirects per attempt. Default: 5. */
+    maxRedirects?: number;
+    /** Identifies the network/environment. Must match previousReport.observer. */
+    observer?: string;
+    previousReport?: CheckReport;
+    onResult?: (result: LinkObservation) => void | Promise<void>;
+}
+interface SitemapOptions extends CheckOptions {
+    /** Treat the input as a site URL: read robots.txt, falling back to /sitemap.xml. */
+    discover?: boolean;
+    /** Reject before page checks if discovery exceeds this many unique pages. Default: 10000. */
+    maxUrls?: number;
+    /** Maximum number of unique sitemap documents to read. Default: 100. */
+    maxSitemaps?: number;
+    /** Maximum downloaded and decompressed size per discovery document. Default: 10 MiB. */
+    maxSitemapBytes?: number;
+}
+
+/** Check only the supplied URLs. HTTP failures become observations; invalid input rejects. */
+declare function checkLinks(input: readonly (string | LinkTarget)[], options?: CheckOptions): Promise<CheckReport>;
+
+interface ReportSiteOptions {
+    /** Automatically load this HTTP(S) or relative JSON URL when hosted. */
+    dataUrl?: string;
+}
+
+declare function formatReport(report: CheckReport, format?: 'json' | 'markdown' | 'html'): string;
+declare function writeReports(report: CheckReport, directory: string): Promise<{
+    json: string;
+    markdown: string;
+    html: string;
+}>;
+/** Export a portable static site. Hosting refreshes the sidecar; file:// uses the embedded snapshot. */
+declare function writeReportSite(report: CheckReport | undefined, directory: string, options?: ReportSiteOptions): Promise<{
+    index: string;
+    json?: string;
+}>;
+/** A missing file starts history; malformed or incompatible history is an error. */
+declare function readReport(path: string): Promise<CheckReport | undefined>;
+/** Write history only after a completed run; replace it atomically. */
+declare function saveReport(report: CheckReport, path: string): Promise<void>;
+
+/** Shared by the Node reader and the static viewer; report files are untrusted input. */
+declare function parseReport(data: unknown): CheckReport;
+
+/** Read and validate a complete, deduplicated page list without requesting the pages. */
+declare function readSitemapUrls(source: string, options?: SitemapOptions): Promise<string[]>;
+/** Check sitemap-listed pages using the same linkinator adapter, history, and report schema as checkLinks. */
+declare function checkSitemap(source: string, options?: SitemapOptions): Promise<{
+    startedAt: string;
+    schemaVersion: 1;
+    observer: string;
+    completedAt: string;
+    summary: Record<Availability, number> & {
+        total: number;
+        redirected: number;
+        recovered: number;
+    };
+    results: LinkObservation[];
+}>;
+
+export { type Availability, type CheckOptions, type CheckReport, type FailureReason, type LinkObservation, type LinkTarget, type ReportSiteOptions, type SitemapOptions, checkLinks, checkSitemap, formatReport, parseReport, readReport, readSitemapUrls, saveReport, writeReportSite, writeReports };

package/dist/check/index.d.mts

@@ -0,0 +1,107 @@
+interface LinkTarget {
+    url: string;
+    name?: string;
+}
+type Availability = 'reachable' | 'restricted' | 'unavailable';
+type FailureReason = 'http' | 'dns' | 'tls' | 'timeout' | 'network' | 'redirect';
+interface LinkObservation extends LinkTarget {
+    status: Availability;
+    checkedAt: string;
+    durationMs: number;
+    attempts: number;
+    finalUrl: string;
+    httpStatus?: number;
+    redirects: {
+        url: string;
+        status: number;
+        location: string;
+    }[];
+    reason?: FailureReason;
+    detail?: string;
+    consecutiveFailures: number;
+    firstFailureAt?: string;
+    lastSuccessAt?: string;
+    changed: boolean;
+    recovered: boolean;
+}
+interface CheckReport {
+    schemaVersion: 1;
+    observer: string;
+    startedAt: string;
+    completedAt: string;
+    summary: Record<Availability, number> & {
+        total: number;
+        redirected: number;
+        recovered: number;
+    };
+    results: LinkObservation[];
+}
+interface CheckOptions {
+    /** Maximum simultaneous site checks. Default: 5. */
+    concurrency?: number;
+    /** Timeout for each HTTP request, including its body. Default: 10000 ms. */
+    timeoutMs?: number;
+    /** Retries for transport errors and 5xx responses. Default: 1; 429 is not retried. */
+    retries?: number;
+    /** Maximum followed redirects per attempt. Default: 5. */
+    maxRedirects?: number;
+    /** Identifies the network/environment. Must match previousReport.observer. */
+    observer?: string;
+    previousReport?: CheckReport;
+    onResult?: (result: LinkObservation) => void | Promise<void>;
+}
+interface SitemapOptions extends CheckOptions {
+    /** Treat the input as a site URL: read robots.txt, falling back to /sitemap.xml. */
+    discover?: boolean;
+    /** Reject before page checks if discovery exceeds this many unique pages. Default: 10000. */
+    maxUrls?: number;
+    /** Maximum number of unique sitemap documents to read. Default: 100. */
+    maxSitemaps?: number;
+    /** Maximum downloaded and decompressed size per discovery document. Default: 10 MiB. */
+    maxSitemapBytes?: number;
+}
+
+/** Check only the supplied URLs. HTTP failures become observations; invalid input rejects. */
+declare function checkLinks(input: readonly (string | LinkTarget)[], options?: CheckOptions): Promise<CheckReport>;
+
+interface ReportSiteOptions {
+    /** Automatically load this HTTP(S) or relative JSON URL when hosted. */
+    dataUrl?: string;
+}
+
+declare function formatReport(report: CheckReport, format?: 'json' | 'markdown' | 'html'): string;
+declare function writeReports(report: CheckReport, directory: string): Promise<{
+    json: string;
+    markdown: string;
+    html: string;
+}>;
+/** Export a portable static site. Hosting refreshes the sidecar; file:// uses the embedded snapshot. */
+declare function writeReportSite(report: CheckReport | undefined, directory: string, options?: ReportSiteOptions): Promise<{
+    index: string;
+    json?: string;
+}>;
+/** A missing file starts history; malformed or incompatible history is an error. */
+declare function readReport(path: string): Promise<CheckReport | undefined>;
+/** Write history only after a completed run; replace it atomically. */
+declare function saveReport(report: CheckReport, path: string): Promise<void>;
+
+/** Shared by the Node reader and the static viewer; report files are untrusted input. */
+declare function parseReport(data: unknown): CheckReport;
+
+/** Read and validate a complete, deduplicated page list without requesting the pages. */
+declare function readSitemapUrls(source: string, options?: SitemapOptions): Promise<string[]>;
+/** Check sitemap-listed pages using the same linkinator adapter, history, and report schema as checkLinks. */
+declare function checkSitemap(source: string, options?: SitemapOptions): Promise<{
+    startedAt: string;
+    schemaVersion: 1;
+    observer: string;
+    completedAt: string;
+    summary: Record<Availability, number> & {
+        total: number;
+        redirected: number;
+        recovered: number;
+    };
+    results: LinkObservation[];
+}>;
+
+export { type Availability, type CheckOptions, type CheckReport, type FailureReason, type LinkObservation, type LinkTarget, type ReportSiteOptions, type SitemapOptions, checkLinks, checkSitemap, formatReport, parseReport, readReport, readSitemapUrls, saveReport, writeReportSite, writeReports };

package/dist/check/index.d.ts

@@ -0,0 +1,107 @@
+interface LinkTarget {
+    url: string;
+    name?: string;
+}
+type Availability = 'reachable' | 'restricted' | 'unavailable';
+type FailureReason = 'http' | 'dns' | 'tls' | 'timeout' | 'network' | 'redirect';
+interface LinkObservation extends LinkTarget {
+    status: Availability;
+    checkedAt: string;
+    durationMs: number;
+    attempts: number;
+    finalUrl: string;
+    httpStatus?: number;
+    redirects: {
+        url: string;
+        status: number;
+        location: string;
+    }[];
+    reason?: FailureReason;
+    detail?: string;
+    consecutiveFailures: number;
+    firstFailureAt?: string;
+    lastSuccessAt?: string;
+    changed: boolean;
+    recovered: boolean;
+}
+interface CheckReport {
+    schemaVersion: 1;
+    observer: string;
+    startedAt: string;
+    completedAt: string;
+    summary: Record<Availability, number> & {
+        total: number;
+        redirected: number;
+        recovered: number;
+    };
+    results: LinkObservation[];
+}
+interface CheckOptions {
+    /** Maximum simultaneous site checks. Default: 5. */
+    concurrency?: number;
+    /** Timeout for each HTTP request, including its body. Default: 10000 ms. */
+    timeoutMs?: number;
+    /** Retries for transport errors and 5xx responses. Default: 1; 429 is not retried. */
+    retries?: number;
+    /** Maximum followed redirects per attempt. Default: 5. */
+    maxRedirects?: number;
+    /** Identifies the network/environment. Must match previousReport.observer. */
+    observer?: string;
+    previousReport?: CheckReport;
+    onResult?: (result: LinkObservation) => void | Promise<void>;
+}
+interface SitemapOptions extends CheckOptions {
+    /** Treat the input as a site URL: read robots.txt, falling back to /sitemap.xml. */
+    discover?: boolean;
+    /** Reject before page checks if discovery exceeds this many unique pages. Default: 10000. */
+    maxUrls?: number;
+    /** Maximum number of unique sitemap documents to read. Default: 100. */
+    maxSitemaps?: number;
+    /** Maximum downloaded and decompressed size per discovery document. Default: 10 MiB. */
+    maxSitemapBytes?: number;
+}
+
+/** Check only the supplied URLs. HTTP failures become observations; invalid input rejects. */
+declare function checkLinks(input: readonly (string | LinkTarget)[], options?: CheckOptions): Promise<CheckReport>;
+
+interface ReportSiteOptions {
+    /** Automatically load this HTTP(S) or relative JSON URL when hosted. */
+    dataUrl?: string;
+}
+
+declare function formatReport(report: CheckReport, format?: 'json' | 'markdown' | 'html'): string;
+declare function writeReports(report: CheckReport, directory: string): Promise<{
+    json: string;
+    markdown: string;
+    html: string;
+}>;
+/** Export a portable static site. Hosting refreshes the sidecar; file:// uses the embedded snapshot. */
+declare function writeReportSite(report: CheckReport | undefined, directory: string, options?: ReportSiteOptions): Promise<{
+    index: string;
+    json?: string;
+}>;
+/** A missing file starts history; malformed or incompatible history is an error. */
+declare function readReport(path: string): Promise<CheckReport | undefined>;
+/** Write history only after a completed run; replace it atomically. */
+declare function saveReport(report: CheckReport, path: string): Promise<void>;
+
+/** Shared by the Node reader and the static viewer; report files are untrusted input. */
+declare function parseReport(data: unknown): CheckReport;
+
+/** Read and validate a complete, deduplicated page list without requesting the pages. */
+declare function readSitemapUrls(source: string, options?: SitemapOptions): Promise<string[]>;
+/** Check sitemap-listed pages using the same linkinator adapter, history, and report schema as checkLinks. */
+declare function checkSitemap(source: string, options?: SitemapOptions): Promise<{
+    startedAt: string;
+    schemaVersion: 1;
+    observer: string;
+    completedAt: string;
+    summary: Record<Availability, number> & {
+        total: number;
+        redirected: number;
+        recovered: number;
+    };
+    results: LinkObservation[];
+}>;
+
+export { type Availability, type CheckOptions, type CheckReport, type FailureReason, type LinkObservation, type LinkTarget, type ReportSiteOptions, type SitemapOptions, checkLinks, checkSitemap, formatReport, parseReport, readReport, readSitemapUrls, saveReport, writeReportSite, writeReports };

package/dist/check/index.mjs

@@ -0,0 +1,11 @@
+export { a as checkLinks, c as checkSitemap, f as formatReport, p as parseReport, r as readReport, d as readSitemapUrls, s as saveReport, b as writeReportSite, w as writeReports } from '../shared/meodp.d0916bc5.mjs';
+import 'node:timers/promises';
+import 'linkinator';
+import 'node:os';
+import 'node:crypto';
+import 'node:fs/promises';
+import 'node:path';
+import 'node:buffer';
+import 'node:util';
+import 'node:zlib';
+import 'fast-xml-parser';

package/dist/cli/index.cjs

@@ -7,7 +7,7 @@ const utils = require('consola/utils');
 const yargs = require('yargs');
 const helpers = require('yargs/helpers');
 require('playwright');
-const index = require('../shared/meodp.6b19529e.cjs');
+const index = require('../shared/meodp.15f2977d.cjs');
 require('node:path');
 require('strip-ansi');
 require('winston');
@@ -68,13 +68,13 @@ function getErrorMdContent(sites) {
         continue;
       }
       const statusInfo = link.statusText ? `${link.statusCode} ${link.statusText}` : link.statusCode;
-      md += `  - [${statusInfo}] <${link.url}>
+      md += `  - [${statusInfo}] [${link.url}](${link.url})
 `;
       for (const req of link.requests) {
         if (req.failed) {
           if (req.statusCode) {
             const statusInfo2 = req.statusText ? `${req.statusCode} ${req.statusText}` : req.statusCode;
-            md += `    - [${statusInfo2}] <${req.url}>
+            md += `    - [${statusInfo2}] [${req.url}](${req.url})
 `;
           } else {
             md += `    - [\u23F0 TIMEOUT] <${req.url}>
@@ -235,8 +235,8 @@ const cli = yargs__default(helpers.hideBin(process__default$1.argv)).scriptName(
     await output(argv.type);
   }
 ).alias("h", "help").alias("v", "version").showHelpOnFail(false).help();
-function run() {
-  cli.parse();
+async function run(args = helpers.hideBin(process__default$1.argv), scriptName = "meodp") {
+  await cli.scriptName(scriptName).parseAsync(args);
 }
 
 exports.__DEV__ = __DEV__;

package/dist/cli/index.d.cts

@@ -6,6 +6,6 @@ declare const __DEV__ = false;
  */
 declare function debug(name: string, ...args: any[]): void;
 declare const cli: yargs.Argv<{}>;
-declare function run(): void;
+declare function run(args?: string[], scriptName?: string): Promise<void>;
 
 export { __DEV__, cli, debug, run };

package/dist/cli/index.d.mts

@@ -6,6 +6,6 @@ declare const __DEV__ = false;
  */
 declare function debug(name: string, ...args: any[]): void;
 declare const cli: yargs.Argv<{}>;
-declare function run(): void;
+declare function run(args?: string[], scriptName?: string): Promise<void>;
 
 export { __DEV__, cli, debug, run };

package/dist/cli/index.d.ts

@@ -6,6 +6,6 @@ declare const __DEV__ = false;
  */
 declare function debug(name: string, ...args: any[]): void;
 declare const cli: yargs.Argv<{}>;
-declare function run(): void;
+declare function run(args?: string[], scriptName?: string): Promise<void>;
 
 export { __DEV__, cli, debug, run };

package/dist/cli/index.mjs

@@ -5,7 +5,7 @@ import { colors } from 'consola/utils';
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
 import 'playwright';
-import { j as createLowDB, h as defaultMEODPConfig, M as MEODP, r as runByConfig } from '../shared/meodp.b58178b8.mjs';
+import { j as createLowDB, h as defaultMEODPConfig, M as MEODP, r as runByConfig } from '../shared/meodp.9a096f50.mjs';
 import 'node:path';
 import 'strip-ansi';
 import 'winston';
@@ -57,13 +57,13 @@ function getErrorMdContent(sites) {
         continue;
       }
       const statusInfo = link.statusText ? `${link.statusCode} ${link.statusText}` : link.statusCode;
-      md += `  - [${statusInfo}] <${link.url}>
+      md += `  - [${statusInfo}] [${link.url}](${link.url})
 `;
       for (const req of link.requests) {
         if (req.failed) {
           if (req.statusCode) {
             const statusInfo2 = req.statusText ? `${req.statusCode} ${req.statusText}` : req.statusCode;
-            md += `    - [${statusInfo2}] <${req.url}>
+            md += `    - [${statusInfo2}] [${req.url}](${req.url})
 `;
           } else {
             md += `    - [\u23F0 TIMEOUT] <${req.url}>
@@ -224,8 +224,8 @@ const cli = yargs(hideBin(process$1.argv)).scriptName("meodp").usage("$0 \u68C0\
     await output(argv.type);
   }
 ).alias("h", "help").alias("v", "version").showHelpOnFail(false).help();
-function run() {
-  cli.parse();
+async function run(args = hideBin(process$1.argv), scriptName = "meodp") {
+  await cli.scriptName(scriptName).parseAsync(args);
 }
 
 export { __DEV__, cli, debug, run };

package/dist/cli/main.cjs

@@ -0,0 +1,220 @@
+'use strict';
+
+const process = require('node:process');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const process__default = /*#__PURE__*/_interopDefaultCompat(process);
+
+const name = "meodp";
+const type = "module";
+const version = "0.1.0";
+const description = "Check website and friend-link availability with sitemap discovery, history, and portable reports.";
+const author = {
+	name: "YunYouJun",
+	url: "https://www.yunyoujun.cn"
+};
+const license = "MIT";
+const homepage = "https://yunyoujun.github.io/meodp/";
+const repository = {
+	type: "git",
+	url: "git+https://github.com/YunYouJun/meodp.git",
+	directory: "packages/meodp"
+};
+const bugs = {
+	url: "https://github.com/YunYouJun/meodp/issues"
+};
+const keywords = [
+	"meodp",
+	"link-checker",
+	"broken-links",
+	"sitemap",
+	"friend-links",
+	"cli"
+];
+const exports$1 = {
+	".": {
+		types: "./dist/index.d.ts",
+		"import": "./dist/index.mjs",
+		require: "./dist/index.cjs"
+	},
+	"./check": {
+		"import": {
+			types: "./dist/check/index.d.mts",
+			"default": "./dist/check/index.mjs"
+		},
+		require: {
+			types: "./dist/check/index.d.cts",
+			"default": "./dist/check/index.cjs"
+		}
+	}
+};
+const main = "./dist/index.mjs";
+const module$1 = "./dist/index.mjs";
+const types = "./dist/index.d.ts";
+const bin = {
+	meodp: "bin/index.mjs"
+};
+const files = [
+	"bin/index.mjs",
+	"dist"
+];
+const engines = {
+	node: ">=22.19.0"
+};
+const scripts = {
+	build: "tsx scripts/build-report-viewer.ts && unbuild",
+	dev: "tsx scripts/build-report-viewer.ts && unbuild --stub",
+	test: "tsx scripts/build-report-viewer.ts && tsx --test test/check.test.ts test/sitemap.test.ts",
+	"test:e2e": "tsx scripts/build-report-viewer.ts && playwright test",
+	typecheck: "tsx scripts/build-report-viewer.ts && tsc --noEmit -p tsconfig.json",
+	prepack: "npm run build",
+	release: "npm version --no-git-tag-version"
+};
+const peerDependencies = {
+	playwright: "^1",
+	typescript: "^5.0.0"
+};
+const peerDependenciesMeta = {
+	playwright: {
+		optional: true
+	},
+	typescript: {
+		optional: true
+	}
+};
+const dependencies = {
+	c12: "^2.0.1",
+	"cli-progress": "^3.12.0",
+	consola: "^3.2.3",
+	"date-fns": "^4.1.0",
+	"fast-xml-parser": "^5.11.1",
+	"fs-extra": "^11.2.0",
+	"js-yaml": "^4.1.0",
+	linkinator: "^8.1.0",
+	lowdb: "^7.0.1",
+	"markdown-table": "^3.0.4",
+	"p-queue": "^8.0.1",
+	"strip-ansi": "^7.1.0",
+	winston: "^3.17.0",
+	yargs: "^17.7.2"
+};
+const devDependencies = {
+	"@playwright/test": "^1.48.2",
+	"@types/bun": "latest",
+	"@types/cli-progress": "^3.11.6",
+	"@types/fs-extra": "^11.0.4",
+	"@types/js-yaml": "^4.0.9",
+	"@types/node": "^22.9.0",
+	"@types/yargs": "^17.0.33",
+	cilicili: "^0.1.1",
+	esbuild: "^0.28.2",
+	playwright: "^1.48.2",
+	tsx: "^4.19.2",
+	unbuild: "^2.0.0",
+	"vite-node": "^2.1.4"
+};
+const publishConfig = {
+	access: "public",
+	registry: "https://registry.npmjs.org/"
+};
+const pkg = {
+	name: name,
+	type: type,
+	version: version,
+	description: description,
+	author: author,
+	license: license,
+	homepage: homepage,
+	repository: repository,
+	bugs: bugs,
+	keywords: keywords,
+	exports: exports$1,
+	main: main,
+	module: module$1,
+	types: types,
+	bin: bin,
+	files: files,
+	engines: engines,
+	scripts: scripts,
+	peerDependencies: peerDependencies,
+	peerDependenciesMeta: peerDependenciesMeta,
+	dependencies: dependencies,
+	devDependencies: devDependencies,
+	publishConfig: publishConfig
+};
+
+const help = `Usage: meodp <command> [options]
+
+Commands:
+  check <links.json|links.yml>  Request listed HTTP(S) URLs and write fresh reports
+  sitemap <sitemap-url>        Check pages listed in an XML sitemap or nested index
+  report [report.json]         Export a static viewer from saved data; no site checks
+  scan [root]                 Run the legacy browser scanner using meodp.config.ts
+  export [root]               Export a legacy browser-scan report
+
+Options:
+  -h, --help                  Show this help
+  -v, --version               Show the package version
+
+Examples:
+  meodp check links.yml --output reports/links
+  meodp sitemap https://example.com/sitemap.xml --output reports/pages
+  meodp report reports/links/report.json --output reports/site
+  meodp check --help
+  meodp help report
+
+check, sitemap, and scan initiate site checks. scan requires Playwright.
+Running meodp without arguments shows help; no scan starts automatically.
+`;
+async function runCli(args = process__default.argv.slice(2)) {
+  try {
+    const [command, ...rest] = args;
+    if (!command || command === "--help" || command === "-h") {
+      if (rest.length)
+        throw new Error("Use meodp <command> --help for command-specific help");
+      console.log(help);
+      return 0;
+    }
+    if (command === "--version" || command === "-v") {
+      if (rest.length)
+        throw new Error("--version does not accept additional arguments");
+      console.log(pkg.version);
+      return 0;
+    }
+    if (command === "help") {
+      if (!rest.length)
+        return runCli(["--help"]);
+      if (rest.length !== 1 || !["check", "sitemap", "report", "scan", "export"].includes(rest[0]))
+        throw new Error("Use meodp help <check|sitemap|report|scan|export>");
+      return runCli([rest[0], "--help"]);
+    }
+    if (command === "check") {
+      const { runCheckCli } = await import('../check/cli.cjs');
+      return runCheckCli(rest);
+    }
+    if (command === "report") {
+      const { runReportCli } = await import('../check/cli.cjs');
+      return runReportCli(rest);
+    }
+    if (command === "sitemap") {
+      const { runSitemapCli } = await import('../check/cli.cjs');
+      return runSitemapCli(rest);
+    }
+    if (command === "scan" || command === "export") {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        console.log(command === "scan" ? "Usage: meodp scan [root]\n\nRun the legacy Playwright scanner with meodp.config.ts in root (default: .).\nThis starts browser/network activity and uses the legacy configuration and reports." : "Usage: meodp export [root] [--type md|html]\n\nExport the legacy browser scanner's stored data.\nFor a schemaVersion: 1 report.json, use meodp report instead.");
+        return 0;
+      }
+      const { run } = await import('./index.cjs');
+      await run(command === "scan" ? rest : ["export", ...rest], command === "scan" ? "meodp scan" : "meodp");
+      return 0;
+    }
+    throw new Error(`Unknown command ${JSON.stringify(command)}. Use meodp --help. For the legacy scanner, use meodp scan [root].`);
+  } catch (error) {
+    console.error(`meodp: ${error instanceof Error ? error.message : String(error)}`);
+    return 2;
+  }
+}
+
+exports.runCli = runCli;

package/dist/cli/main.d.cts

@@ -0,0 +1,4 @@
+/** Keep command discovery independent of optional browser dependencies. */
+declare function runCli(args?: string[]): Promise<number>;
+
+export { runCli };

package/dist/cli/main.d.mts

@@ -0,0 +1,4 @@
+/** Keep command discovery independent of optional browser dependencies. */
+declare function runCli(args?: string[]): Promise<number>;
+
+export { runCli };

package/dist/cli/main.d.ts

@@ -0,0 +1,4 @@
+/** Keep command discovery independent of optional browser dependencies. */
+declare function runCli(args?: string[]): Promise<number>;
+
+export { runCli };