meodp 0.1.0 → 0.2.0

package/README.md

@@ -52,6 +52,33 @@ await saveReport(report, historyFile)
 
 Each observation includes its HTTP status, final URL, redirect chain, duration, attempt count, failure reason, last success, consecutive failed runs, and recovery/change flags. `formatReport(report, 'html')` returns a self-contained interactive HTML report; `'json'` returns JSON; the default is Markdown. `writeReports()` writes `report.html`, `report.json`, and `report.md` and returns `{ html, json, markdown }`.
 
+## Project configuration
+
+Starting with 0.2.0, HTTP commands read `meodp.config.ts`:
+
+```ts
+import { defineConfig } from 'meodp/config'
+
+export default defineConfig({
+  check: {
+    reporter: ['json', 'markdown', ['html', { outputFolder: 'reports/site' }]],
+    input: 'public/links.yml',
+    output: 'reports/links',
+    history: '.cache/links.json',
+    failOn: 'none',
+  },
+  report: { input: 'reports/links/report.json', reporter: 'html', output: 'dist/status' },
+})
+```
+
+Run `meodp check` to collect observations or `meodp report` to render saved data. `check.reporter` selects check outputs; `report.input` is the saved JSON to read, and `report.reporter` selects export formats. Use top-level `reporter` only for shared defaults. CLI options override config values. Config file paths are relative to the config; CLI paths are relative to your working directory.
+
+The same config supports history seeding, deployment verification (`meodp report --verify`), and optional Feishu / SMTP notifications (`meodp notify`). Reuse the pure policy from `meodp/notify` and delivery adapters from `meodp/notify/feishu` or `meodp/notify/email`. Email requires the optional Nodemailer peer only for sending. Notification channels default to off; use `--mode changes|weekly` to enable and `--dry-run` to preview.
+
+See the [configuration guide](https://yunyoujun.github.io/meodp/guide/configuration) ([中文](https://yunyoujun.github.io/meodp/zh/guide/configuration)). The older browser `defineConfig` at the package root remains unchanged; HTTP projects import from `meodp/config`.
+
+Override formats with `--reporter=json,markdown,html` or repeated `--reporter` flags. JSON / Markdown tuples accept `outputFile`; HTML accepts `outputFolder` or a standalone `outputFile`. See [reporter formats and path precedence](https://yunyoujun.github.io/meodp/guide/reports#reporters).
+
 ## Sitemap page checks
 
 Check all pages listed in an XML sitemap, reusing the same HTTP observations, history, and reports:
@@ -102,7 +129,7 @@ Use explicit subcommands to distinguish a fresh network check from rendering sav
 | Command        | Input                            | Behavior                                                       |
 | -------------- | -------------------------------- | -------------------------------------------------------------- |
 | `meodp check`  | URL array in JSON/YAML           | Request sites and write fresh HTML, Markdown, and JSON reports |
-| `meodp report` | Saved `report.json`, or no input | Export a static report viewer; no site-check requests          |
+| `meodp report` | Saved `report.json`, or no input | Render JSON, Markdown or HTML; no site-check requests          |
 | `meodp scan`   | Legacy config directory          | Run the experimental Playwright scanner                        |
 
 `meodp`, `meodp --help`, and `meodp help` display the command overview. Use `meodp check -h` or `meodp help report` for details; `meodp --version` / `-v` prints the version. Unknown commands exit with code `2` instead of starting a scan. Help and version do not require Playwright.

package/dist/check/cli.cjs

@@ -1,18 +1,21 @@
 'use strict';
 
 const promises = require('node:fs/promises');
+const node_os = require('node:os');
 const path = require('node:path');
 const process = require('node:process');
 const node_util = require('node:util');
 const jsYaml = require('js-yaml');
-const check_index = require('../shared/meodp.a0bcc3e7.cjs');
+const load = require('../shared/meodp.63483e20.cjs');
+const check_index = require('../shared/meodp.c4c70565.cjs');
+const report = require('../shared/meodp.2b00b0ae.cjs');
+require('c12');
 require('node:timers/promises');
 require('linkinator');
-require('node:os');
-require('node:crypto');
 require('node:buffer');
 require('node:zlib');
 require('fast-xml-parser');
+require('node:crypto');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
 
@@ -24,7 +27,10 @@ Check only the listed HTTP(S) URLs, with no browser or recursive resource scan.
 Input: an array of URL strings or objects with url and optional name.
 This makes network requests. To render saved data instead, use meodp report.
 
-  --output <directory>  Write report.json, report.md, report.html (default: reports/meodp)
+  --config <file>      Load a project config (default: meodp.config.ts)
+  --output <directory>  Default report directory (default: reports/meodp)
+  --reporter <names>    json, markdown, html; comma-separated or repeated
+                       Without a selection, write report.json, report.md, report.html
   --history <file>      Read previous observations and save the completed report
   --observer <name>     Identify this network/environment (default: hostname)
   --concurrency <n>     Concurrent sites (default: 5)
@@ -49,14 +55,16 @@ async function runScanCli(mode, args) {
       args,
       allowPositionals: true,
       options: {
-        "output": { type: "string", default: "reports/meodp" },
+        "config": { type: "string" },
+        "reporter": { type: "string", multiple: true },
+        "output": { type: "string" },
         "history": { type: "string" },
         "observer": { type: "string" },
         "concurrency": { type: "string" },
         "timeout": { type: "string" },
         "retries": { type: "string" },
         "max-redirects": { type: "string" },
-        "fail-on": { type: "string", default: "unavailable" },
+        "fail-on": { type: "string" },
         "help": { type: "boolean", short: "h" },
         ...mode === "sitemap" ? {
           "discover": { type: "boolean" },
@@ -75,42 +83,64 @@ Read an XML sitemap or nested index, then check each listed page via HTTP.
   --max-sitemaps <n>     Limit sitemap documents (default: 100)
   --max-sitemap-bytes <n> Limit each downloaded/decompressed document (default: 10485760)
 
-${help.slice(help.indexOf("  --output"))}`);
+${help.slice(help.indexOf("  --config"))}`);
       return 0;
     }
-    if (positionals.length !== 1)
+    const project = await load.loadProjectConfig(values.config);
+    const configured = (mode === "links" ? project.config.check : project.config.sitemap) ?? {};
+    const input = positionals[0] ?? (configured.input ? mode === "links" ? project.path(configured.input) : configured.input : void 0);
+    if (!input || positionals.length > 1)
       throw new Error(`Provide exactly one ${mode === "links" ? "JSON or YAML input file" : "HTTP(S) URL"}. Use --help for examples.`);
-    if (!["none", "unavailable", "review"].includes(values["fail-on"]))
+    const selection = selectReporters(values.reporter, configured.reporter ?? project.config.reporter);
+    const outputDir = path.resolve(values.output ?? (configured.output ? project.path(configured.output) : "reports/meodp"));
+    const reporterOptions = { outputDir, cwd: project.path(".") };
+    const reporter = typeof selection === "string" ? [selection] : [...selection ?? ["json", "markdown", ["html", { outputFile: path.join(outputDir, "report.html") }]]];
+    if (configured.site)
+      reporter.push(["html", { outputFolder: project.path(configured.site) }]);
+    const plan = check_index.planReporters(reporter, reporterOptions);
+    const failOn = values["fail-on"] ?? configured.failOn ?? "unavailable";
+    if (!["none", "unavailable", "review"].includes(failOn))
       throw new Error("--fail-on must be none, unavailable, or review");
     const numeric = (value) => typeof value === "string" ? Number(value) : void 0;
+    const history = values.history ?? (configured.history ? project.path(configured.history) : void 0);
+    const seed = configured.historySeed ? project.path(configured.historySeed) : void 0;
+    await protectInputs(plan, [
+      ...mode === "links" ? [{ file: input, jsonOnly: false }] : [],
+      ...[history, seed].filter((file) => !!file).map((file) => ({ file, jsonOnly: true }))
+    ], history);
+    let previousReport = history ? await report.readReport(history) : void 0;
+    if (!previousReport && seed)
+      previousReport = await report.readReport(seed);
+    const observer = values.observer ?? configured.observer;
+    if (previousReport && configured.observerMismatch === "reset" && previousReport.observer !== (observer ?? node_os.hostname()))
+      previousReport = void 0;
     const options = {
-      observer: values.observer,
-      previousReport: values.history ? await check_index.readReport(values.history) : void 0,
-      concurrency: numeric(values.concurrency),
-      timeoutMs: numeric(values.timeout),
-      retries: numeric(values.retries),
-      maxRedirects: numeric(values["max-redirects"]),
+      observer,
+      previousReport,
+      concurrency: numeric(values.concurrency) ?? configured.concurrency,
+      timeoutMs: numeric(values.timeout) ?? configured.timeoutMs,
+      retries: numeric(values.retries) ?? configured.retries,
+      maxRedirects: numeric(values["max-redirects"]) ?? configured.maxRedirects,
       onResult(result) {
         console.log(`[${result.status}] ${result.httpStatus ?? result.reason} ${result.url}`);
       }
     };
-    const input = positionals[0];
-    const report = mode === "sitemap" ? await check_index.checkSitemap(input, {
+    const report$1 = mode === "sitemap" ? await check_index.checkSitemap(input, {
       ...options,
-      discover: values.discover === true,
-      maxUrls: numeric(values["max-urls"]),
-      maxSitemaps: numeric(values["max-sitemaps"]),
-      maxSitemapBytes: numeric(values["max-sitemap-bytes"])
+      discover: values.discover === void 0 ? configured.discover : values.discover === true,
+      maxUrls: numeric(values["max-urls"]) ?? configured.maxUrls,
+      maxSitemaps: numeric(values["max-sitemaps"]) ?? configured.maxSitemaps,
+      maxSitemapBytes: numeric(values["max-sitemap-bytes"]) ?? configured.maxSitemapBytes
     }) : await check_index.checkLinks(await readTargets(input), options);
-    const paths = await check_index.writeReports(report, values.output);
-    if (values.history)
-      await check_index.saveReport(report, values.history);
-    console.log(`${report.summary.total} URLs: ${report.summary.reachable} reachable, ${report.summary.restricted} restricted, ${report.summary.unavailable} unavailable`);
-    console.log(`Interactive report: ${path.resolve(paths.html)}`);
-    console.log(`Reports: ${path.resolve(paths.markdown)} and ${path.resolve(paths.json)}`);
-    if (values["fail-on"] === "none")
+    const outputs = await check_index.writeReporters(report$1, reporter, reporterOptions);
+    for (const output of outputs)
+      console.log(`${output.reporter}: ${output.files.join(", ")}`);
+    if (history)
+      await report.saveReport(report$1, history);
+    console.log(`${report$1.summary.total} URLs: ${report$1.summary.reachable} reachable, ${report$1.summary.restricted} restricted, ${report$1.summary.unavailable} unavailable`);
+    if (failOn === "none")
       return 0;
-    const findings = report.summary.unavailable > 0 || values["fail-on"] === "review" && (report.summary.restricted > 0 || report.summary.redirected > 0);
+    const findings = report$1.summary.unavailable > 0 || failOn === "review" && (report$1.summary.restricted > 0 || report$1.summary.redirected > 0);
     return findings ? 1 : 0;
   } catch (error) {
     console.error(`meodp ${mode === "links" ? "check" : "sitemap"}: ${error instanceof Error ? error.message : String(error)}`);
@@ -130,18 +160,25 @@ async function runReportCli(args = process__default.argv.slice(3)) {
       args,
       allowPositionals: true,
       options: {
-        "output": { type: "string", default: "reports/site" },
+        "config": { type: "string" },
+        "reporter": { type: "string", multiple: true },
+        "verify": { type: "boolean" },
+        "output": { type: "string" },
         "data-url": { type: "string" },
         "help": { type: "boolean", short: "h" }
       }
     });
     if (values.help) {
-      console.log(`Usage: meodp report [report.json] [--output reports/site] [--data-url ./report.json]
+      console.log(`Usage: meodp report [report.json] [--reporter json,markdown,html] [--output reports/site]
 
-Export a static interactive viewer without making any site-check requests.
-With an input report, write index.html and report.json. The hosted viewer loads
+Render saved data through selected reporters without making any site-check requests.
+--reporter accepts json, markdown, html; repeat it or separate names with commas.
+With no configured selection, export the HTML static viewer.
+HTML folders with input write index.html and report.json. The hosted viewer loads
 report.json on each visit; opening index.html as a local file uses its embedded snapshot.
-Without input, export an empty viewer supporting file upload and JSON URL loading.
+Without input, only HTML is available: an empty viewer with file upload and URL loading.
+--config loads a project config; CLI arguments override config values.
+--verify waits for report.verify.url to serve this report and the matching viewer.
 --data-url overrides the data source loaded by the hosted viewer (cross-origin needs CORS).
 -h, --help shows this help. To collect fresh observations, use meodp check.
 Exit codes: 0 = exported; 2 = invalid input or execution error.`);
@@ -149,17 +186,71 @@ Exit codes: 0 = exported; 2 = invalid input or execution error.`);
     }
     if (positionals.length > 1)
       throw new Error("Provide at most one report.json file. Use --help for examples.");
-    const report = positionals[0] ? await check_index.readReport(positionals[0]) : void 0;
-    if (positionals[0] && !report)
-      throw new Error(`Report not found: ${positionals[0]}`);
-    const paths = await check_index.writeReportSite(report, values.output, values["data-url"] ? { dataUrl: values["data-url"] } : {});
-    console.log(`Static report site: ${path.resolve(paths.index)}`);
+    const project = await load.loadProjectConfig(values.config);
+    const configured = project.config.report ?? {};
+    const input = positionals[0] ?? (configured.input ? project.path(configured.input) : void 0);
+    const report$1 = input ? await report.readReport(input) : void 0;
+    if (input && !report$1)
+      throw new Error(`Report not found: ${input}`);
+    const reporter = selectReporters(values.reporter, configured.reporter ?? project.config.reporter) ?? "html";
+    if (values.verify) {
+      if (!report$1 || !configured.verify)
+        throw new Error("Verification requires a saved report and report.verify.url in the config.");
+      await check_index.waitForReport(report$1, configured.verify);
+      console.log("The public status page is serving the expected report.");
+      return 0;
+    }
+    const selected = values["data-url"] === void 0 ? reporter : (typeof reporter === "string" ? [reporter] : reporter).map((entry) => {
+      const [name, options] = typeof entry === "string" ? [entry] : entry;
+      return name === "html" ? ["html", { ...options, dataUrl: values["data-url"] }] : entry;
+    });
+    const reporterOptions = {
+      cwd: project.path("."),
+      outputDir: path.resolve(values.output ?? (configured.output ? project.path(configured.output) : "reports/site")),
+      dataUrl: values["data-url"] ?? configured.dataUrl
+    };
+    await protectInputs(check_index.planReporters(selected, reporterOptions), input ? [{ file: input, jsonOnly: true }] : []);
+    const outputs = await check_index.writeReporters(report$1, selected, reporterOptions);
+    for (const output of outputs)
+      console.log(`${output.reporter}: ${output.files.join(", ")}`);
     return 0;
   } catch (error) {
     console.error(`meodp report: ${error instanceof Error ? error.message : String(error)}`);
     return 2;
   }
 }
+function selectReporters(cli, configured) {
+  if (cli === void 0)
+    return configured;
+  const names = [...new Set(cli.flatMap((value) => value.split(",").map((name) => name.trim())))];
+  if (names.some((name) => !["json", "markdown", "html"].includes(name)))
+    throw new TypeError("--reporter must select json, markdown, or html.");
+  return names;
+}
+async function protectInputs(plan, inputs, history) {
+  const identity = async (file) => {
+    try {
+      return await promises.realpath(file);
+    } catch (error) {
+      if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
+        return path.resolve(file);
+      throw error;
+    }
+  };
+  const writes = plan.flatMap((item) => [
+    { file: item.file, reporter: item.reporter },
+    ...item.json ? [{ file: item.json, reporter: "json" }] : []
+  ]);
+  if (history)
+    writes.push({ file: history, reporter: "json" });
+  for (const input of inputs) {
+    const source = await identity(input.file);
+    for (const output of writes) {
+      if (await identity(output.file) === source && (!input.jsonOnly || output.reporter !== "json"))
+        throw new Error(`Reporter/history output would overwrite input ${input.file}; choose another output path.`);
+    }
+  }
+}
 
 exports.runCheckCli = runCheckCli;
 exports.runReportCli = runReportCli;

package/dist/check/cli.mjs

@@ -1,16 +1,19 @@
-import { readFile } from 'node:fs/promises';
-import { resolve, extname } from 'node:path';
+import { readFile, realpath } from 'node:fs/promises';
+import { hostname } from 'node:os';
+import { resolve, join, extname } from 'node:path';
 import process from 'node:process';
 import { parseArgs } from 'node:util';
 import { load } from 'js-yaml';
-import { r as readReport, c as checkSitemap, a as checkLinks, w as writeReports, s as saveReport, n as normalizeTargets, b as writeReportSite } from '../shared/meodp.d0916bc5.mjs';
+import { l as loadProjectConfig } from '../shared/meodp.f96d0510.mjs';
+import { p as planReporters, c as checkSitemap, a as checkLinks, w as writeReporters, n as normalizeTargets, b as waitForReport } from '../shared/meodp.80ff918d.mjs';
+import { r as readReport, s as saveReport } from '../shared/meodp.9c706389.mjs';
+import 'c12';
 import 'node:timers/promises';
 import 'linkinator';
-import 'node:os';
-import 'node:crypto';
 import 'node:buffer';
 import 'node:zlib';
 import 'fast-xml-parser';
+import 'node:crypto';
 
 const help = `Usage: meodp check <links.json|links.yml> [options]
 
@@ -18,7 +21,10 @@ Check only the listed HTTP(S) URLs, with no browser or recursive resource scan.
 Input: an array of URL strings or objects with url and optional name.
 This makes network requests. To render saved data instead, use meodp report.
 
-  --output <directory>  Write report.json, report.md, report.html (default: reports/meodp)
+  --config <file>      Load a project config (default: meodp.config.ts)
+  --output <directory>  Default report directory (default: reports/meodp)
+  --reporter <names>    json, markdown, html; comma-separated or repeated
+                       Without a selection, write report.json, report.md, report.html
   --history <file>      Read previous observations and save the completed report
   --observer <name>     Identify this network/environment (default: hostname)
   --concurrency <n>     Concurrent sites (default: 5)
@@ -43,14 +49,16 @@ async function runScanCli(mode, args) {
       args,
       allowPositionals: true,
       options: {
-        "output": { type: "string", default: "reports/meodp" },
+        "config": { type: "string" },
+        "reporter": { type: "string", multiple: true },
+        "output": { type: "string" },
         "history": { type: "string" },
         "observer": { type: "string" },
         "concurrency": { type: "string" },
         "timeout": { type: "string" },
         "retries": { type: "string" },
         "max-redirects": { type: "string" },
-        "fail-on": { type: "string", default: "unavailable" },
+        "fail-on": { type: "string" },
         "help": { type: "boolean", short: "h" },
         ...mode === "sitemap" ? {
           "discover": { type: "boolean" },
@@ -69,42 +77,64 @@ Read an XML sitemap or nested index, then check each listed page via HTTP.
   --max-sitemaps <n>     Limit sitemap documents (default: 100)
   --max-sitemap-bytes <n> Limit each downloaded/decompressed document (default: 10485760)
 
-${help.slice(help.indexOf("  --output"))}`);
+${help.slice(help.indexOf("  --config"))}`);
       return 0;
     }
-    if (positionals.length !== 1)
+    const project = await loadProjectConfig(values.config);
+    const configured = (mode === "links" ? project.config.check : project.config.sitemap) ?? {};
+    const input = positionals[0] ?? (configured.input ? mode === "links" ? project.path(configured.input) : configured.input : void 0);
+    if (!input || positionals.length > 1)
       throw new Error(`Provide exactly one ${mode === "links" ? "JSON or YAML input file" : "HTTP(S) URL"}. Use --help for examples.`);
-    if (!["none", "unavailable", "review"].includes(values["fail-on"]))
+    const selection = selectReporters(values.reporter, configured.reporter ?? project.config.reporter);
+    const outputDir = resolve(values.output ?? (configured.output ? project.path(configured.output) : "reports/meodp"));
+    const reporterOptions = { outputDir, cwd: project.path(".") };
+    const reporter = typeof selection === "string" ? [selection] : [...selection ?? ["json", "markdown", ["html", { outputFile: join(outputDir, "report.html") }]]];
+    if (configured.site)
+      reporter.push(["html", { outputFolder: project.path(configured.site) }]);
+    const plan = planReporters(reporter, reporterOptions);
+    const failOn = values["fail-on"] ?? configured.failOn ?? "unavailable";
+    if (!["none", "unavailable", "review"].includes(failOn))
       throw new Error("--fail-on must be none, unavailable, or review");
     const numeric = (value) => typeof value === "string" ? Number(value) : void 0;
+    const history = values.history ?? (configured.history ? project.path(configured.history) : void 0);
+    const seed = configured.historySeed ? project.path(configured.historySeed) : void 0;
+    await protectInputs(plan, [
+      ...mode === "links" ? [{ file: input, jsonOnly: false }] : [],
+      ...[history, seed].filter((file) => !!file).map((file) => ({ file, jsonOnly: true }))
+    ], history);
+    let previousReport = history ? await readReport(history) : void 0;
+    if (!previousReport && seed)
+      previousReport = await readReport(seed);
+    const observer = values.observer ?? configured.observer;
+    if (previousReport && configured.observerMismatch === "reset" && previousReport.observer !== (observer ?? hostname()))
+      previousReport = void 0;
     const options = {
-      observer: values.observer,
-      previousReport: values.history ? await readReport(values.history) : void 0,
-      concurrency: numeric(values.concurrency),
-      timeoutMs: numeric(values.timeout),
-      retries: numeric(values.retries),
-      maxRedirects: numeric(values["max-redirects"]),
+      observer,
+      previousReport,
+      concurrency: numeric(values.concurrency) ?? configured.concurrency,
+      timeoutMs: numeric(values.timeout) ?? configured.timeoutMs,
+      retries: numeric(values.retries) ?? configured.retries,
+      maxRedirects: numeric(values["max-redirects"]) ?? configured.maxRedirects,
       onResult(result) {
         console.log(`[${result.status}] ${result.httpStatus ?? result.reason} ${result.url}`);
       }
     };
-    const input = positionals[0];
     const report = mode === "sitemap" ? await checkSitemap(input, {
       ...options,
-      discover: values.discover === true,
-      maxUrls: numeric(values["max-urls"]),
-      maxSitemaps: numeric(values["max-sitemaps"]),
-      maxSitemapBytes: numeric(values["max-sitemap-bytes"])
+      discover: values.discover === void 0 ? configured.discover : values.discover === true,
+      maxUrls: numeric(values["max-urls"]) ?? configured.maxUrls,
+      maxSitemaps: numeric(values["max-sitemaps"]) ?? configured.maxSitemaps,
+      maxSitemapBytes: numeric(values["max-sitemap-bytes"]) ?? configured.maxSitemapBytes
     }) : await checkLinks(await readTargets(input), options);
-    const paths = await writeReports(report, values.output);
-    if (values.history)
-      await saveReport(report, values.history);
+    const outputs = await writeReporters(report, reporter, reporterOptions);
+    for (const output of outputs)
+      console.log(`${output.reporter}: ${output.files.join(", ")}`);
+    if (history)
+      await saveReport(report, history);
     console.log(`${report.summary.total} URLs: ${report.summary.reachable} reachable, ${report.summary.restricted} restricted, ${report.summary.unavailable} unavailable`);
-    console.log(`Interactive report: ${resolve(paths.html)}`);
-    console.log(`Reports: ${resolve(paths.markdown)} and ${resolve(paths.json)}`);
-    if (values["fail-on"] === "none")
+    if (failOn === "none")
       return 0;
-    const findings = report.summary.unavailable > 0 || values["fail-on"] === "review" && (report.summary.restricted > 0 || report.summary.redirected > 0);
+    const findings = report.summary.unavailable > 0 || failOn === "review" && (report.summary.restricted > 0 || report.summary.redirected > 0);
     return findings ? 1 : 0;
   } catch (error) {
     console.error(`meodp ${mode === "links" ? "check" : "sitemap"}: ${error instanceof Error ? error.message : String(error)}`);
@@ -124,18 +154,25 @@ async function runReportCli(args = process.argv.slice(3)) {
       args,
       allowPositionals: true,
       options: {
-        "output": { type: "string", default: "reports/site" },
+        "config": { type: "string" },
+        "reporter": { type: "string", multiple: true },
+        "verify": { type: "boolean" },
+        "output": { type: "string" },
         "data-url": { type: "string" },
         "help": { type: "boolean", short: "h" }
       }
     });
     if (values.help) {
-      console.log(`Usage: meodp report [report.json] [--output reports/site] [--data-url ./report.json]
+      console.log(`Usage: meodp report [report.json] [--reporter json,markdown,html] [--output reports/site]
 
-Export a static interactive viewer without making any site-check requests.
-With an input report, write index.html and report.json. The hosted viewer loads
+Render saved data through selected reporters without making any site-check requests.
+--reporter accepts json, markdown, html; repeat it or separate names with commas.
+With no configured selection, export the HTML static viewer.
+HTML folders with input write index.html and report.json. The hosted viewer loads
 report.json on each visit; opening index.html as a local file uses its embedded snapshot.
-Without input, export an empty viewer supporting file upload and JSON URL loading.
+Without input, only HTML is available: an empty viewer with file upload and URL loading.
+--config loads a project config; CLI arguments override config values.
+--verify waits for report.verify.url to serve this report and the matching viewer.
 --data-url overrides the data source loaded by the hosted viewer (cross-origin needs CORS).
 -h, --help shows this help. To collect fresh observations, use meodp check.
 Exit codes: 0 = exported; 2 = invalid input or execution error.`);
@@ -143,16 +180,70 @@ Exit codes: 0 = exported; 2 = invalid input or execution error.`);
     }
     if (positionals.length > 1)
       throw new Error("Provide at most one report.json file. Use --help for examples.");
-    const report = positionals[0] ? await readReport(positionals[0]) : void 0;
-    if (positionals[0] && !report)
-      throw new Error(`Report not found: ${positionals[0]}`);
-    const paths = await writeReportSite(report, values.output, values["data-url"] ? { dataUrl: values["data-url"] } : {});
-    console.log(`Static report site: ${resolve(paths.index)}`);
+    const project = await loadProjectConfig(values.config);
+    const configured = project.config.report ?? {};
+    const input = positionals[0] ?? (configured.input ? project.path(configured.input) : void 0);
+    const report = input ? await readReport(input) : void 0;
+    if (input && !report)
+      throw new Error(`Report not found: ${input}`);
+    const reporter = selectReporters(values.reporter, configured.reporter ?? project.config.reporter) ?? "html";
+    if (values.verify) {
+      if (!report || !configured.verify)
+        throw new Error("Verification requires a saved report and report.verify.url in the config.");
+      await waitForReport(report, configured.verify);
+      console.log("The public status page is serving the expected report.");
+      return 0;
+    }
+    const selected = values["data-url"] === void 0 ? reporter : (typeof reporter === "string" ? [reporter] : reporter).map((entry) => {
+      const [name, options] = typeof entry === "string" ? [entry] : entry;
+      return name === "html" ? ["html", { ...options, dataUrl: values["data-url"] }] : entry;
+    });
+    const reporterOptions = {
+      cwd: project.path("."),
+      outputDir: resolve(values.output ?? (configured.output ? project.path(configured.output) : "reports/site")),
+      dataUrl: values["data-url"] ?? configured.dataUrl
+    };
+    await protectInputs(planReporters(selected, reporterOptions), input ? [{ file: input, jsonOnly: true }] : []);
+    const outputs = await writeReporters(report, selected, reporterOptions);
+    for (const output of outputs)
+      console.log(`${output.reporter}: ${output.files.join(", ")}`);
     return 0;
   } catch (error) {
     console.error(`meodp report: ${error instanceof Error ? error.message : String(error)}`);
     return 2;
   }
 }
+function selectReporters(cli, configured) {
+  if (cli === void 0)
+    return configured;
+  const names = [...new Set(cli.flatMap((value) => value.split(",").map((name) => name.trim())))];
+  if (names.some((name) => !["json", "markdown", "html"].includes(name)))
+    throw new TypeError("--reporter must select json, markdown, or html.");
+  return names;
+}
+async function protectInputs(plan, inputs, history) {
+  const identity = async (file) => {
+    try {
+      return await realpath(file);
+    } catch (error) {
+      if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
+        return resolve(file);
+      throw error;
+    }
+  };
+  const writes = plan.flatMap((item) => [
+    { file: item.file, reporter: item.reporter },
+    ...item.json ? [{ file: item.json, reporter: "json" }] : []
+  ]);
+  if (history)
+    writes.push({ file: history, reporter: "json" });
+  for (const input of inputs) {
+    const source = await identity(input.file);
+    for (const output of writes) {
+      if (await identity(output.file) === source && (!input.jsonOnly || output.reporter !== "json"))
+        throw new Error(`Reporter/history output would overwrite input ${input.file}; choose another output path.`);
+    }
+  }
+}
 
 export { runCheckCli, runReportCli, runSitemapCli };

package/dist/check/index.cjs

@@ -1,25 +1,29 @@
 'use strict';
 
-const check_index = require('../shared/meodp.a0bcc3e7.cjs');
+const check_index = require('../shared/meodp.c4c70565.cjs');
+const report = require('../shared/meodp.2b00b0ae.cjs');
 require('node:timers/promises');
 require('linkinator');
 require('node:os');
-require('node:crypto');
 require('node:fs/promises');
 require('node:path');
+require('node:process');
 require('node:buffer');
 require('node:util');
 require('node:zlib');
 require('fast-xml-parser');
+require('node:crypto');
 
 
 
 exports.checkLinks = check_index.checkLinks;
 exports.checkSitemap = check_index.checkSitemap;
-exports.formatReport = check_index.formatReport;
-exports.parseReport = check_index.parseReport;
-exports.readReport = check_index.readReport;
 exports.readSitemapUrls = check_index.readSitemapUrls;
-exports.saveReport = check_index.saveReport;
-exports.writeReportSite = check_index.writeReportSite;
-exports.writeReports = check_index.writeReports;
+exports.waitForReport = check_index.waitForReport;
+exports.writeReporters = check_index.writeReporters;
+exports.formatReport = report.formatReport;
+exports.parseReport = report.parseReport;
+exports.readReport = report.readReport;
+exports.saveReport = report.saveReport;
+exports.writeReportSite = report.writeReportSite;
+exports.writeReports = report.writeReports;