@anarchitects/governance-cli 0.0.1

package/dist/bin/agov.js

@@ -0,0 +1,792 @@
+#!/usr/bin/env node
+import { writeFileSync as H, readFileSync as S, existsSync as _, statSync as L } from "node:fs";
+import f from "node:path";
+import { fileURLToPath as O } from "node:url";
+import { r as N, G as E, a as b, S as U, b as J } from "../check-_APXAvpi.js";
+const M = 10;
+function F(e) {
+  const o = [];
+  o.push(`Nx Governance - ${e.profile}`), o.push(""), o.push(
+    `Health Score: ${e.health.score} (${B(
+      e.health.status
+    )}, ${e.health.grade})`
+  ), o.push(`Projects: ${e.workspace.projects.length}`), o.push(`Dependencies: ${e.workspace.dependencies.length}`), o.push(`Violations: ${e.violations.length}`), o.push(""), o.push("Signal Sources:");
+  for (const t of e.signalBreakdown.bySource)
+    o.push(`- ${t.source}: ${t.count}`);
+  o.push(""), o.push("Signal Types:");
+  for (const t of e.signalBreakdown.byType)
+    o.push(`- ${t.type}: ${t.count}`);
+  o.push(""), o.push("Signal Severity:");
+  for (const t of e.signalBreakdown.bySeverity)
+    o.push(`- ${t.severity}: ${t.count}`);
+  if (e.warnings.length > 0) {
+    o.push(""), o.push("Warnings:");
+    for (const t of e.warnings)
+      o.push(`- ${t}`);
+  }
+  if (o.push(""), o.push("Exceptions:"), o.push(`- declared: ${e.exceptions.summary.declaredCount}`), o.push(`- matched: ${e.exceptions.summary.matchedCount}`), o.push(`- unused: ${e.exceptions.summary.unusedExceptionCount}`), o.push(`- active: ${e.exceptions.summary.activeExceptionCount}`), o.push(`- stale: ${e.exceptions.summary.staleExceptionCount}`), o.push(
+    `- expired: ${e.exceptions.summary.expiredExceptionCount}`
+  ), o.push(
+    `- suppressed policy findings: ${e.exceptions.summary.suppressedPolicyViolationCount}`
+  ), o.push(
+    `- suppressed conformance findings: ${e.exceptions.summary.suppressedConformanceFindingCount}`
+  ), o.push(
+    `- reactivated policy findings: ${e.exceptions.summary.reactivatedPolicyViolationCount}`
+  ), o.push(
+    `- reactivated conformance findings: ${e.exceptions.summary.reactivatedConformanceFindingCount}`
+  ), e.exceptions.suppressedFindings.length > 0) {
+    o.push("Suppressed Findings:");
+    for (const t of e.exceptions.suppressedFindings) {
+      const r = t.ruleId ? ` :: ${t.ruleId}` : "", n = [
+        t.projectId,
+        t.targetProjectId,
+        t.relatedProjectIds.length > 0 ? `related=${t.relatedProjectIds.join(",")}` : void 0
+      ].filter((s) => !!s).join(" -> "), a = n ? ` :: scope=${n}` : "";
+      o.push(
+        `- ${t.exceptionId} :: ${t.status} :: ${t.source}/${t.kind} :: [${t.severity}]${r}${a} :: ${t.message}`
+      );
+    }
+  }
+  if (e.exceptions.reactivatedFindings.length > 0) {
+    o.push("Reactivated Findings:");
+    for (const t of e.exceptions.reactivatedFindings) {
+      const r = t.ruleId ? ` :: ${t.ruleId}` : "", n = [
+        t.projectId,
+        t.targetProjectId,
+        t.relatedProjectIds.length > 0 ? `related=${t.relatedProjectIds.join(",")}` : void 0
+      ].filter((s) => !!s).join(" -> "), a = n ? ` :: scope=${n}` : "";
+      o.push(
+        `- ${t.exceptionId} :: ${t.status} :: ${t.source}/${t.kind} :: [${t.severity}]${r}${a} :: ${t.message}`
+      );
+    }
+  }
+  o.push(""), o.push("Metrics:");
+  for (const t of e.measurements)
+    o.push(`- ${t.name}: ${t.score}/100`);
+  if (e.metricBreakdown.families.length > 0) {
+    o.push(""), o.push("Metric Families:");
+    for (const t of e.metricBreakdown.families)
+      o.push(`- ${t.family}: ${t.score}/100`), o.push(
+        `  measurements: ${t.measurements.map((r) => `${r.name} (${r.score})`).join(", ")}`
+      );
+  }
+  if (e.health.metricHotspots.length > 0) {
+    o.push(""), o.push("Metric Hotspots:");
+    for (const t of e.health.metricHotspots)
+      o.push(`- ${t.name}: ${t.score}/100`);
+  }
+  if (e.health.projectHotspots.length > 0) {
+    o.push(""), o.push("Project Hotspots:");
+    for (const t of e.health.projectHotspots)
+      o.push(
+        `- ${t.project}: ${t.count} :: types=${t.dominantIssueTypes.join(",")}`
+      );
+  }
+  if (o.push(""), o.push("Explainability:"), o.push(`- summary: ${e.health.explainability.summary}`), o.push(
+    `- status reason: ${e.health.explainability.statusReason}`
+  ), e.health.explainability.weakestMetrics.length > 0 && o.push(
+    `- weakest metrics: ${e.health.explainability.weakestMetrics.map((t) => `${t.name} (${t.score})`).join(", ")}`
+  ), e.health.explainability.dominantIssues.length > 0 && o.push(
+    `- dominant issues: ${e.health.explainability.dominantIssues.map((t) => `${t.type} x${t.count}`).join(", ")}`
+  ), e.topIssues.length > 0) {
+    o.push(""), o.push("Top Issues:");
+    for (const t of e.topIssues.slice(0, M)) {
+      const r = t.ruleId ? ` :: ${t.ruleId}` : "", n = t.projects.length > 0 ? ` :: projects=${t.projects.join(",")}` : "";
+      o.push(
+        `- [${t.severity}] ${t.type} (${t.source}) x${t.count}${r}${n} :: ${t.message}`
+      );
+    }
+  }
+  if (e.recommendations.length > 0) {
+    o.push(""), o.push("Recommendations:");
+    for (const t of e.recommendations)
+      o.push(
+        `- (${t.priority}) ${t.title} - ${t.reason}`
+      );
+  }
+  return o.join(`
+`);
+}
+function B(e) {
+  return `${e.charAt(0).toUpperCase()}${e.slice(1)}`;
+}
+function K(e) {
+  return JSON.stringify(e, null, 2);
+}
+function z(e, o) {
+  switch (o) {
+    case "json":
+      return T(e);
+    case "markdown":
+      return D(e);
+    case "table":
+    case "text":
+      return Q(e);
+  }
+}
+function T(e) {
+  return JSON.stringify(
+    {
+      command: e.command,
+      success: e.success,
+      assessment: JSON.parse(K(e.assessment))
+    },
+    null,
+    2
+  );
+}
+function Q(e) {
+  const o = [], { assessment: t } = e, r = F(t).split(`
+`);
+  return r[0]?.startsWith("Nx Governance - ") && (r[0] = `Governance Check - ${t.profile}`), o.push("agov check"), o.push(""), o.push(
+    ...q(
+      ["Field", "Value"],
+      [
+        ["success", e.success ? "true" : "false"],
+        ["workspace", t.workspace.name],
+        ["profile", t.profile]
+      ]
+    )
+  ), o.push(""), o.push(...r), o.join(`
+`);
+}
+function D(e) {
+  const { assessment: o } = e, t = [], r = F(o).split(`
+`);
+  r[0]?.startsWith("Nx Governance - ") && (r[0] = `Governance Check - ${o.profile}`), t.push("# agov check"), t.push(""), t.push("| Field | Value |"), t.push("| --- | --- |"), t.push(`| success | ${e.success ? "true" : "false"} |`), t.push(
+    `| workspace | ${R(o.workspace.name)} |`
+  ), t.push(`| profile | ${R(o.profile)} |`), t.push("");
+  for (const n of r) {
+    if (n.length === 0) {
+      t.push("");
+      continue;
+    }
+    if (!n.startsWith("- ")) {
+      t.push(`## ${n}`);
+      continue;
+    }
+    t.push(n);
+  }
+  return t.join(`
+`);
+}
+function q(e, o) {
+  const t = Math.max(
+    e[0].length,
+    ...o.map((n) => n[0]?.length ?? 0)
+  ), r = Math.max(
+    e[1].length,
+    ...o.map((n) => n[1]?.length ?? 0)
+  );
+  return [
+    `${k(e[0], t)}  ${k(e[1], r)}`,
+    `${"-".repeat(t)}  ${"-".repeat(r)}`,
+    ...o.map(
+      (n) => `${k(n[0] ?? "", t)}  ${k(
+        n[1] ?? "",
+        r
+      )}`
+    )
+  ];
+}
+function k(e, o) {
+  return e.padEnd(o, " ");
+}
+function R(e) {
+  return e.replaceAll("|", "\\|");
+}
+const ee = ["agov.config.json", "governance.config.json"], oe = [
+  "tools/governance/profiles/default.json",
+  "tools/governance/profile.json",
+  "governance.profile.json",
+  "agov.profile.json"
+], te = [
+  "governance.workspace.json",
+  "agov.workspace.json",
+  "tools/governance/workspace.json"
+], w = 0, ne = 1, W = 2, y = 3, re = {
+  runAgovCheck: N
+};
+class u extends Error {
+  constructor(o, t) {
+    super(o), this.code = t, this.name = "AgovCliUsageError";
+  }
+}
+class V extends Error {
+  constructor(o, t, r) {
+    super(o), this.code = t, this.filePath = r, this.name = "AgovCliOutputError";
+  }
+}
+class I extends Error {
+  constructor(o, t, r) {
+    super(o), this.code = t, this.details = r, this.name = "AgovCliRuntimeError";
+  }
+}
+async function ae(e, o = Ae(), t = re, r = ye()) {
+  try {
+    const n = ie(e);
+    if (n.kind === "help")
+      return o.stdout(ke()), w;
+    if (n.kind === "version")
+      return o.stdout(r.packageVersion()), w;
+    if (n.options.showHelp)
+      return o.stdout(we()), w;
+    const a = se(n.options, r), s = await pe(
+      a,
+      r
+    ), c = await Promise.resolve(t.runAgovCheck(s)), p = z(c, a.format);
+    return a.outputPath ? je(a.outputPath, p) : o.stdout(p), c.success ? w : ne;
+  } catch (n) {
+    return n instanceof u ? (o.stderr(
+      v({
+        code: n.code,
+        message: n.message
+      })
+    ), W) : n instanceof V ? (o.stderr(
+      v({
+        code: n.code,
+        message: n.message,
+        details: {
+          filePath: n.filePath
+        }
+      })
+    ), W) : n instanceof I ? (o.stderr(
+      v({
+        code: n.code,
+        message: n.message,
+        ...n.details ? { details: n.details } : {}
+      })
+    ), y) : n instanceof E || n instanceof b || n instanceof U || n instanceof J ? (o.stderr(Ce(n)), y) : (o.stderr(
+      v({
+        code: "agov.cli.unhandled_error",
+        message: n instanceof Error ? n.message : "Unknown agov CLI error."
+      })
+    ), y);
+  }
+}
+function ie(e) {
+  if (e.length === 0)
+    return { kind: "help" };
+  const [o, ...t] = e;
+  if (o === "--help" || o === "-h" || o === "help")
+    return { kind: "help" };
+  if (o === "--version" || o === "-v" || o === "version")
+    return { kind: "version" };
+  if (o !== "check")
+    throw new u(
+      `Unsupported agov command "${o}". Supported commands are "check", "--help", and "--version".`,
+      "agov.cli.unknown_command"
+    );
+  return {
+    kind: "check",
+    options: ce(t)
+  };
+}
+function ce(e) {
+  let o, t, r, n, a, s, c, p = !1;
+  for (let i = 0; i < e.length; i += 1) {
+    const d = e[i];
+    if (d === "--help" || d === "-h") {
+      p = !0;
+      continue;
+    }
+    if (d === "--config") {
+      o = g(e, i, "--config"), i += 1;
+      continue;
+    }
+    if (d === "--profile") {
+      t = g(e, i, "--profile"), i += 1;
+      continue;
+    }
+    if (d === "--workspace") {
+      r = g(e, i, "--workspace"), i += 1;
+      continue;
+    }
+    if (d === "--adapter") {
+      n = g(e, i, "--adapter"), i += 1;
+      continue;
+    }
+    if (d === "--root") {
+      a = g(e, i, "--root"), i += 1;
+      continue;
+    }
+    if (d === "--format") {
+      const l = g(e, i, "--format");
+      if (i += 1, l !== "text" && l !== "json" && l !== "markdown" && l !== "table")
+        throw new u(
+          'Unsupported agov check format. Supported formats are "table", "markdown", "text", and "json".',
+          "agov.cli.unsupported_format"
+        );
+      s = l;
+      continue;
+    }
+    if (d === "--output") {
+      c = g(e, i, "--output"), i += 1;
+      continue;
+    }
+    throw new u(
+      `Unknown agov option "${d}".`,
+      "agov.cli.unknown_option"
+    );
+  }
+  return {
+    command: "check",
+    configPath: o,
+    profilePath: t,
+    workspacePath: r,
+    adapterPackage: n,
+    rootPath: a,
+    format: s,
+    outputPath: c,
+    showHelp: p
+  };
+}
+function g(e, o, t) {
+  const r = e[o + 1];
+  if (!r || r.startsWith("--"))
+    throw new u(
+      `Missing required value for "${t}".`,
+      "agov.cli.missing_option_value"
+    );
+  return r;
+}
+function se(e, o) {
+  const t = f.resolve(o.cwd()), r = e.rootPath ? f.resolve(t, e.rootPath) : void 0, n = he(
+    t,
+    r,
+    e.configPath
+  ), a = n ? ge(n) : {}, s = n ? f.dirname(n) : t;
+  if ((a.adapter || A(a.adapters).length > 0) && a.workspace && !e.adapterPackage && !e.workspacePath)
+    throw new u(
+      "Config file cannot define both adapter-mode and workspace-mode inputs for agov check. Pass one mode only, or override explicitly with CLI flags.",
+      "agov.cli.invalid_config"
+    );
+  if (e.workspacePath && e.adapterPackage)
+    throw new u(
+      'agov check does not allow explicit "--workspace" and "--adapter" together. Use canonical workspace mode or adapter mode, not both.',
+      "agov.cli.ambiguous_workspace_and_adapter"
+    );
+  const c = r ?? $(a.root, s) ?? t, p = j(e.workspacePath, t), i = $(
+    a.workspace,
+    s
+  ), d = P(
+    c,
+    te
+  ), l = p ?? i ?? d, m = j(e.profilePath, t) ?? $(a.profile, s) ?? P(c, oe), x = e.adapterPackage ?? X(a.adapter), G = Ie(c, a), C = ve(e.format, a.format), h = j(e.outputPath, t);
+  if (!m)
+    throw new u(
+      'Could not resolve a governance profile. Pass "--profile <path>", set "profile" in agov.config.json or governance.config.json, or add a conventional profile file such as "governance.profile.json".',
+      "agov.cli.missing_profile"
+    );
+  if (p || i)
+    return {
+      command: "check",
+      rootPath: c,
+      profilePath: m,
+      workspacePath: l,
+      format: C,
+      ...h ? { outputPath: h } : {},
+      ...n ? { configPath: n } : {},
+      mode: "workspace"
+    };
+  if (x)
+    return {
+      command: "check",
+      rootPath: c,
+      profilePath: m,
+      adapterPackage: x,
+      format: C,
+      ...h ? { outputPath: h } : {},
+      ...n ? { configPath: n } : {},
+      mode: "adapter"
+    };
+  if (G.length > 0)
+    return {
+      command: "check",
+      rootPath: c,
+      profilePath: m,
+      adapterCandidates: G,
+      format: C,
+      ...h ? { outputPath: h } : {},
+      ...n ? { configPath: n } : {},
+      mode: "adapter-discovery"
+    };
+  if (l)
+    return {
+      command: "check",
+      rootPath: c,
+      profilePath: m,
+      workspacePath: l,
+      format: C,
+      ...h ? { outputPath: h } : {},
+      ...n ? { configPath: n } : {},
+      mode: "workspace"
+    };
+  throw new u(
+    'Could not resolve Governance workspace input. Pass "--workspace <path>" for canonical workspace mode, pass "--adapter <package> --root <path>" for explicit adapter mode, or configure generic adapter candidates.',
+    "agov.cli.missing_workspace_or_adapter"
+  );
+}
+async function pe(e, o) {
+  if (e.mode === "workspace") {
+    if (!e.workspacePath)
+      throw new I(
+        "Resolved workspace mode without a workspace path.",
+        "agov.cli.unhandled_error"
+      );
+    return {
+      profilePath: e.profilePath,
+      workspacePath: e.workspacePath
+    };
+  }
+  if (!e.adapterPackage) {
+    if (e.mode !== "adapter-discovery" || !e.adapterCandidates)
+      throw new I(
+        "Resolved adapter mode without an adapter package.",
+        "agov.cli.unhandled_error"
+      );
+    const r = await de(
+      e.adapterCandidates,
+      e.rootPath,
+      o
+    );
+    return {
+      profilePath: e.profilePath,
+      workspaceAdapter: r.adapter,
+      workspaceAdapterInput: e.rootPath
+    };
+  }
+  const t = await ue(
+    e.adapterPackage,
+    e.rootPath,
+    o
+  );
+  return {
+    profilePath: e.profilePath,
+    workspaceAdapter: t,
+    workspaceAdapterInput: e.rootPath
+  };
+}
+async function ue(e, o, t) {
+  let r;
+  try {
+    r = await t.moduleLoader(e);
+  } catch {
+    throw new I(
+      le(e),
+      "agov.cli.adapter_not_found",
+      {
+        adapter: e,
+        rootPath: o
+      }
+    );
+  }
+  const n = Y(r);
+  if (!n)
+    throw new I(
+      `Package "${e}" was loaded, but it does not expose a compatible Governance workspace adapter.`,
+      "agov.cli.adapter_contract_mismatch",
+      {
+        adapter: e,
+        rootPath: o
+      }
+    );
+  return n;
+}
+async function de(e, o, t) {
+  const r = [];
+  let n;
+  for (const a of e) {
+    let s;
+    try {
+      s = await t.moduleLoader(a);
+    } catch {
+      r.push({ packageName: a, status: "load-failed" });
+      continue;
+    }
+    const c = Y(s);
+    if (!c) {
+      r.push({ packageName: a, status: "contract-mismatch" });
+      continue;
+    }
+    if (typeof c.probe != "function") {
+      r.push({ packageName: a, status: "missing-probe" });
+      continue;
+    }
+    const p = c.probe(o);
+    if (r.push({
+      packageName: a,
+      status: p.supported ? "supported" : "unsupported",
+      confidence: p.confidence ?? "none",
+      reasons: p.reasons ?? []
+    }), !p.supported)
+      continue;
+    const i = fe(p.confidence);
+    (!n || i > n.rank) && (n = {
+      adapter: c,
+      packageName: a,
+      probe: p,
+      rank: i
+    });
+  }
+  if (!n)
+    throw new I(
+      "Could not find a supported Governance adapter from the discovered candidate packages.",
+      "agov.cli.no_supported_adapter",
+      {
+        rootPath: o,
+        attemptedPackages: e,
+        attempts: r
+      }
+    );
+  return n;
+}
+function Y(e) {
+  const o = typeof e == "object" && e !== null ? e : {};
+  for (const r of [
+    o.default,
+    o.governanceWorkspaceAdapter,
+    o.adapter
+  ])
+    if (Z(r))
+      return r;
+  const t = o.createGovernanceWorkspaceAdapter;
+  if (typeof t == "function") {
+    const r = t();
+    if (Z(r))
+      return r;
+  }
+}
+function Z(e) {
+  return typeof e == "object" && e !== null && typeof e.id == "string" && typeof e.loadWorkspace == "function";
+}
+function le(e) {
+  const o = [`Could not load Governance adapter package "${e}".`];
+  return o.push(
+    `Install "${e}" in the consuming workspace to use adapter mode.`
+  ), o.push(
+    `You can also pass "--adapter ${e}" explicitly, or use "--workspace <path>" with a canonical Governance workspace document.`
+  ), o.join(" ");
+}
+function fe(e) {
+  switch (e) {
+    case "high":
+      return 3;
+    case "medium":
+      return 2;
+    case "low":
+      return 1;
+    default:
+      return 0;
+  }
+}
+function he(e, o, t) {
+  if (t)
+    return f.resolve(e, t);
+  const r = o ? [o, e] : [e];
+  for (const n of r) {
+    const a = P(
+      n,
+      ee
+    );
+    if (a)
+      return a;
+  }
+}
+function ge(e) {
+  let o;
+  try {
+    o = S(e, "utf8");
+  } catch {
+    throw new u(
+      `Failed to read agov config file "${e}".`,
+      "agov.cli.invalid_config"
+    );
+  }
+  let t;
+  try {
+    t = JSON.parse(o);
+  } catch {
+    throw new u(
+      `Failed to parse agov config file "${e}" as JSON.`,
+      "agov.cli.invalid_json"
+    );
+  }
+  if (typeof t != "object" || t === null || Array.isArray(t))
+    throw new u(
+      `agov config file "${e}" must contain a JSON object.`,
+      "agov.cli.invalid_config"
+    );
+  return t;
+}
+function ve(e, o) {
+  const t = e ?? X(o) ?? "text";
+  if (t !== "text" && t !== "json" && t !== "markdown" && t !== "table")
+    throw new u(
+      'Unsupported agov check format. Supported formats are "table", "markdown", "text", and "json".',
+      "agov.cli.unsupported_format"
+    );
+  return t;
+}
+function j(e, o) {
+  if (e)
+    return f.resolve(o, e);
+}
+function $(e, o) {
+  if (!(!e || e.trim().length === 0))
+    return f.resolve(o, e);
+}
+function X(e) {
+  return typeof e == "string" && e.trim().length > 0 ? e.trim() : void 0;
+}
+function A(e) {
+  return Array.isArray(e) ? e.filter((o) => typeof o == "string").map((o) => o.trim()).filter((o) => o.length > 0) : [];
+}
+function P(e, o) {
+  for (const t of o) {
+    const r = f.resolve(e, t);
+    if (_(r) && L(r).isFile())
+      return r;
+  }
+}
+function Ie(e, o) {
+  return [
+    .../* @__PURE__ */ new Set([
+      ...A(o.adapters),
+      ...me(e)
+    ])
+  ];
+}
+function me(e) {
+  const o = f.join(e, "package.json");
+  if (!_(o) || !L(o).isFile())
+    return [];
+  try {
+    const t = JSON.parse(S(o, "utf8"));
+    if (typeof t != "object" || t === null || Array.isArray(t))
+      return [];
+    const r = t, n = typeof r.agov == "object" && r.agov !== null && !Array.isArray(r.agov) ? r.agov : void 0, a = typeof r.governance == "object" && r.governance !== null && !Array.isArray(r.governance) ? r.governance : void 0;
+    return [
+      ...A(n?.adapters),
+      ...A(a?.adapters)
+    ];
+  } catch {
+    return [];
+  }
+}
+function Ce(e) {
+  return e instanceof b || e instanceof J ? v({
+    code: e instanceof b ? "agov.cli.invalid_workspace" : "agov.cli.invalid_profile",
+    message: e.message,
+    details: {
+      filePath: e.filePath,
+      issues: e.issues
+    }
+  }) : v({
+    code: e instanceof E ? "agov.cli.workspace_load_failed" : "agov.cli.profile_load_failed",
+    message: e.message,
+    details: {
+      filePath: e.filePath,
+      loaderCode: e.code
+    }
+  });
+}
+function v(e) {
+  return JSON.stringify(
+    {
+      error: {
+        code: e.code,
+        message: e.message,
+        ...e.details ? { details: e.details } : {}
+      }
+    },
+    null,
+    2
+  );
+}
+function ke() {
+  return [
+    "agov",
+    "",
+    "Usage:",
+    "  agov --help",
+    "  agov --version",
+    "  agov check [options]",
+    "",
+    "Commands:",
+    "  check   Run a Governance check using canonical workspace mode or adapter mode.",
+    "",
+    'Run "agov check --help" for command-specific options.'
+  ].join(`
+`);
+}
+function we() {
+  return [
+    "agov check",
+    "",
+    "Usage:",
+    "  agov check --profile <path> --workspace <path> [--format table|markdown|text|json]",
+    "  agov check --profile <path> --adapter <package> --root <path> [--format table|markdown|text|json]",
+    "  agov check [--config <path>]",
+    "",
+    "Resolution order:",
+    "  explicit CLI flag -> config file -> conventional files -> generic adapter discovery and probe -> error",
+    "",
+    "Options:",
+    "  --help              Show check command help.",
+    "  --config <path>     Load agov.config.json or governance.config.json explicitly.",
+    "  --profile <path>    Governance profile document.",
+    "  --workspace <path>  Canonical Governance workspace document.",
+    "  --adapter <package> Dynamically load a concrete adapter package.",
+    "  --root <path>       Adapter input root. Defaults to the current working directory.",
+    "  --format <value>    Output format: table, markdown, text, or json. Defaults to text.",
+    "  --output <path>     Write command output to a file instead of stdout.",
+    "",
+    "Conventions:",
+    "  Config:   agov.config.json, governance.config.json",
+    "  Profile:  tools/governance/profiles/default.json, tools/governance/profile.json, governance.profile.json, agov.profile.json",
+    "  Workspace: governance.workspace.json, agov.workspace.json, tools/governance/workspace.json"
+  ].join(`
+`);
+}
+function Ae() {
+  return {
+    stdout(e) {
+      process.stdout.write(`${e}
+`);
+    },
+    stderr(e) {
+      process.stderr.write(`${e}
+`);
+    }
+  };
+}
+function ye() {
+  return {
+    cwd() {
+      return process.cwd();
+    },
+    async moduleLoader(e) {
+      return import(e);
+    },
+    packageVersion() {
+      const e = O(
+        new URL("data:application/json;base64,ewogICJuYW1lIjogIkBhbmFyY2hpdGVjdHMvZ292ZXJuYW5jZS1jbGkiLAogICJ2ZXJzaW9uIjogIjAuMC4xIiwKICAiZGVzY3JpcHRpb24iOiAiUGxhdGZvcm0taW5kZXBlbmRlbnQgc3RhbmRhbG9uZSBHb3Zlcm5hbmNlIENMSSB0aGF0IG9yY2hlc3RyYXRlcyBDb21tdW5pdHktb3duZWQgR292ZXJuYW5jZSBDb3JlIGNvbnRyYWN0cyBvdXRzaWRlIE54LiIsCiAgImxpY2Vuc2UiOiAiTUlUIiwKICAidHlwZSI6ICJtb2R1bGUiLAogICJtYWluIjogIi4vZGlzdC9pbmRleC5qcyIsCiAgIm1vZHVsZSI6ICIuL2Rpc3QvaW5kZXguanMiLAogICJ0eXBlcyI6ICIuL2Rpc3QvaW5kZXguZC50cyIsCiAgInJlcG9zaXRvcnkiOiB7CiAgICAidHlwZSI6ICJnaXQiLAogICAgInVybCI6ICJnaXQraHR0cHM6Ly9naXRodWIuY29tL2FuYXJjaGl0ZWN0cy9hbmFyY2hpdGVjdHVyZS1jb21tdW5pdHkuZ2l0IiwKICAgICJkaXJlY3RvcnkiOiAicGFja2FnZXMvZ292ZXJuYW5jZS9jbGkiCiAgfSwKICAiYnVncyI6IHsKICAgICJ1cmwiOiAiaHR0cHM6Ly9naXRodWIuY29tL2FuYXJjaGl0ZWN0cy9hbmFyY2hpdGVjdHVyZS1jb21tdW5pdHkvaXNzdWVzIgogIH0sCiAgImhvbWVwYWdlIjogImh0dHBzOi8vZ2l0aHViLmNvbS9hbmFyY2hpdGVjdHMvYW5hcmNoaXRlY3R1cmUtY29tbXVuaXR5L3RyZWUvbWFpbi9wYWNrYWdlcy9nb3Zlcm5hbmNlL2NsaSNyZWFkbWUiLAogICJrZXl3b3JkcyI6IFsKICAgICJnb3Zlcm5hbmNlIiwKICAgICJjbGkiCiAgXSwKICAiZXhwb3J0cyI6IHsKICAgICIuL3BhY2thZ2UuanNvbiI6ICIuL3BhY2thZ2UuanNvbiIsCiAgICAiLiI6IHsKICAgICAgIkBhbmFyY2hpdGVjdHVyZS1jb21tdW5pdHkvc291cmNlIjogIi4vc3JjL2luZGV4LnRzIiwKICAgICAgInR5cGVzIjogIi4vZGlzdC9pbmRleC5kLnRzIiwKICAgICAgImltcG9ydCI6ICIuL2Rpc3QvaW5kZXguanMiLAogICAgICAiZGVmYXVsdCI6ICIuL2Rpc3QvaW5kZXguanMiCiAgICB9CiAgfSwKICAiYmluIjogewogICAgImFnb3YiOiAiLi9kaXN0L2Jpbi9hZ292LmpzIgogIH0sCiAgImZpbGVzIjogWwogICAgImRpc3QiLAogICAgIiEqKi8qLnRzYnVpbGRpbmZvIgogIF0sCiAgInB1Ymxpc2hDb25maWciOiB7CiAgICAiYWNjZXNzIjogInB1YmxpYyIKICB9LAogICJueCI6IHsKICAgICJuYW1lIjogImdvdmVybmFuY2UtY2xpIiwKICAgICJ0YXJnZXRzIjogewogICAgICAidGVzdCI6IHsKICAgICAgICAiZXhlY3V0b3IiOiAiQG54L3ZpdGVzdDp0ZXN0IiwKICAgICAgICAib3V0cHV0cyI6IFsKICAgICAgICAgICJ7b3B0aW9ucy5yZXBvcnRzRGlyZWN0b3J5fSIKICAgICAgICBdLAogICAgICAgICJvcHRpb25zIjogewogICAgICAgICAgInJlcG9ydHNEaXJlY3RvcnkiOiAiY292ZXJhZ2UvcGFja2FnZXMvZ292ZXJuYW5jZS9jbGkiCiAgICAgICAgfQogICAgICB9CiAgICB9CiAgfSwKICAiZGVwZW5kZW5jaWVzIjogewogICAgIkBhbmFyY2hpdGVjdHMvZ292ZXJuYW5jZS1jb3JlIjogIl4wLjAuMSIsCiAgICAieWFtbCI6ICJeMi44LjEiCiAgfQp9Cg==", import.meta.url)
+      );
+      return JSON.parse(S(e, "utf8")).version ?? "0.0.0";
+    }
+  };
+}
+function je(e, o) {
+  const t = f.resolve(e);
+  try {
+    H(t, o, "utf8");
+  } catch {
+    throw new V(
+      `Failed to write agov report output to "${t}".`,
+      "agov.cli.output_write_failed",
+      t
+    );
+  }
+}
+process.exitCode = await ae(process.argv.slice(2));