@ontrails/warden 1.0.0-beta.2 → 1.0.0-beta.22

package/src/workspaces.ts

@@ -0,0 +1,238 @@
+/**
+ * Workspace-manifest discovery for Warden project-aware rules.
+ */
+
+import { existsSync, readdirSync, readFileSync, realpathSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+
+export interface WardenPublicWorkspace {
+  readonly name: string;
+  readonly rootDir: string;
+  readonly packageJsonPath: string;
+  readonly hasExports: boolean;
+  readonly bin?: Readonly<Record<string, string>> | undefined;
+  readonly exportTargets?: Readonly<Record<string, string>> | undefined;
+  readonly files?: readonly string[] | undefined;
+}
+
+interface RootManifest {
+  readonly workspaces?: unknown;
+}
+
+interface PackageManifest {
+  readonly bin?: unknown;
+  readonly exports?: unknown;
+  readonly files?: unknown;
+  readonly name?: unknown;
+  readonly private?: unknown;
+}
+
+const normalizePath = (path: string): string => path.replaceAll('\\', '/');
+
+const normalizeRealPath = (path: string): string => {
+  try {
+    return normalizePath(realpathSync(path));
+  } catch {
+    return normalizePath(resolve(path));
+  }
+};
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  Boolean(value && typeof value === 'object' && !Array.isArray(value));
+
+const readJson = <T>(path: string): T | undefined => {
+  try {
+    return JSON.parse(readFileSync(path, 'utf8')) as T;
+  } catch {
+    return undefined;
+  }
+};
+
+const workspacePatternsFromManifest = (
+  manifest: RootManifest | undefined
+): readonly string[] => {
+  const { workspaces } = manifest ?? {};
+  if (Array.isArray(workspaces)) {
+    return workspaces.filter(
+      (pattern): pattern is string => typeof pattern === 'string'
+    );
+  }
+
+  const packages = isRecord(workspaces) ? workspaces['packages'] : undefined;
+  return Array.isArray(packages)
+    ? packages.filter(
+        (pattern): pattern is string => typeof pattern === 'string'
+      )
+    : [];
+};
+
+const workspaceDirsForPattern = (
+  rootDir: string,
+  pattern: string
+): readonly string[] => {
+  if (!pattern.endsWith('/*')) {
+    const workspaceDir = join(rootDir, pattern);
+    return existsSync(workspaceDir) ? [workspaceDir] : [];
+  }
+
+  const groupDir = join(rootDir, pattern.slice(0, -2));
+  if (!existsSync(groupDir)) {
+    return [];
+  }
+
+  return readdirSync(groupDir, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => join(groupDir, entry.name))
+    .toSorted();
+};
+
+const packageLocalName = (name: string): string =>
+  name.split('/').at(-1) ?? name;
+
+const normalizeBin = (
+  name: string,
+  value: unknown
+): Readonly<Record<string, string>> | undefined => {
+  if (typeof value === 'string') {
+    return { [packageLocalName(name)]: value };
+  }
+  if (!isRecord(value)) {
+    return undefined;
+  }
+
+  const entries = Object.entries(value).filter(
+    (entry): entry is [string, string] => typeof entry[1] === 'string'
+  );
+  return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+};
+
+const normalizeFiles = (value: unknown): readonly string[] | undefined => {
+  if (!Array.isArray(value)) {
+    return undefined;
+  }
+
+  const files = value.filter(
+    (entry): entry is string => typeof entry === 'string'
+  );
+  return files.length > 0 ? files : undefined;
+};
+
+const resolveExportTarget = (
+  target: unknown,
+  depth = 0
+): string | undefined => {
+  if (typeof target === 'string') {
+    return target;
+  }
+  if (!isRecord(target) || depth > 8) {
+    return undefined;
+  }
+
+  for (const condition of ['bun', 'import', 'default', 'require'] as const) {
+    const conditionalTarget = target[condition];
+    const resolvedTarget = resolveExportTarget(conditionalTarget, depth + 1);
+    if (resolvedTarget) {
+      return resolvedTarget;
+    }
+  }
+  return undefined;
+};
+
+const exportSpecifierFromKey = (
+  packageName: string,
+  key: string
+): string | undefined => {
+  if (key === '.') {
+    return packageName;
+  }
+  if (!key.startsWith('./') || key.includes('*')) {
+    return undefined;
+  }
+  return `${packageName}/${key.slice(2)}`;
+};
+
+const normalizeExportTargets = (
+  packageDir: string,
+  packageName: string,
+  exportsValue: unknown
+): Readonly<Record<string, string>> | undefined => {
+  if (!isRecord(exportsValue)) {
+    return undefined;
+  }
+
+  const targets: Record<string, string> = {};
+  for (const [key, value] of Object.entries(exportsValue)) {
+    const specifier = exportSpecifierFromKey(packageName, key);
+    const target = resolveExportTarget(value);
+    if (!specifier || !target) {
+      continue;
+    }
+    targets[specifier] = normalizeRealPath(join(packageDir, target));
+  }
+
+  return Object.keys(targets).length > 0 ? targets : undefined;
+};
+
+const publicWorkspaceFromManifest = (
+  packageJsonPath: string,
+  manifest: PackageManifest
+): WardenPublicWorkspace | undefined => {
+  if (typeof manifest.name !== 'string') {
+    return undefined;
+  }
+  if (!manifest.name.startsWith('@ontrails/')) {
+    return undefined;
+  }
+  if (manifest.private === true) {
+    return undefined;
+  }
+
+  const packageDir = dirname(packageJsonPath);
+  const bin = normalizeBin(manifest.name, manifest.bin);
+  const exportTargets = normalizeExportTargets(
+    packageDir,
+    manifest.name,
+    manifest.exports
+  );
+  const files = normalizeFiles(manifest.files);
+
+  return {
+    ...(bin ? { bin } : {}),
+    ...(exportTargets ? { exportTargets } : {}),
+    ...(files ? { files } : {}),
+    hasExports: manifest.exports !== undefined,
+    name: manifest.name,
+    packageJsonPath: normalizeRealPath(packageJsonPath),
+    rootDir: normalizeRealPath(dirname(packageJsonPath)),
+  };
+};
+
+export const collectPublicWorkspaces = (
+  rootDir: string
+): ReadonlyMap<string, WardenPublicWorkspace> => {
+  const normalizedRoot = normalizeRealPath(rootDir);
+  const rootManifest = readJson<RootManifest>(
+    join(normalizedRoot, 'package.json')
+  );
+  const workspaces = new Map<string, WardenPublicWorkspace>();
+
+  for (const pattern of workspacePatternsFromManifest(rootManifest)) {
+    for (const workspaceDir of workspaceDirsForPattern(
+      normalizedRoot,
+      pattern
+    )) {
+      const packageJsonPath = join(workspaceDir, 'package.json');
+      const manifest = readJson<PackageManifest>(packageJsonPath);
+      if (!manifest) {
+        continue;
+      }
+
+      const workspace = publicWorkspaceFromManifest(packageJsonPath, manifest);
+      if (workspace) {
+        workspaces.set(workspace.name, workspace);
+      }
+    }
+  }
+
+  return workspaces;
+};

package/.turbo/turbo-build.log

@@ -1 +0,0 @@
-$ tsc -b

package/.turbo/turbo-lint.log

@@ -1,3 +0,0 @@
-$ oxlint ./src
-Found 0 warnings and 0 errors.
-Finished in 24ms on 30 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

@@ -1 +0,0 @@
-$ tsc --noEmit

package/dist/cli.d.ts

@@ -1,46 +0,0 @@
-/**
- * Warden CLI command runner.
- *
- * Scans TypeScript files, runs all warden rules, optionally checks drift,
- * and returns a structured report.
- */
-import type { Topo } from '@ontrails/core';
-import type { DriftResult } from './drift.js';
-import type { WardenDiagnostic } from './rules/types.js';
-/**
- * Options for the warden CLI runner.
- */
-export interface WardenOptions {
-    /** Root directory to scan for TypeScript files. Defaults to cwd. */
-    readonly rootDir?: string | undefined;
-    /** Only run lint rules, skip drift detection */
-    readonly lintOnly?: boolean | undefined;
-    /** Only run drift detection, skip lint rules */
-    readonly driftOnly?: boolean | undefined;
-    /** App topology for drift detection. When provided, enables real surface lock comparison. */
-    readonly topo?: Topo | undefined;
-}
-/**
- * Result of a warden run.
- */
-export interface WardenReport {
-    /** All diagnostics from lint rules */
-    readonly diagnostics: readonly WardenDiagnostic[];
-    /** Count of error-severity diagnostics */
-    readonly errorCount: number;
-    /** Count of warn-severity diagnostics */
-    readonly warnCount: number;
-    /** Drift detection result, or null if skipped */
-    readonly drift: DriftResult | null;
-    /** Whether the warden run passed (no errors, no drift) */
-    readonly passed: boolean;
-}
-/**
- * Run all warden checks and return a structured report.
- */
-export declare const runWarden: (options?: WardenOptions) => Promise<WardenReport>;
-/**
- * Format a warden report as a human-readable string.
- */
-export declare const formatWardenReport: (report: WardenReport) => string;
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C,OAAO,KAAK,EAGV,gBAAgB,EAEjB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAyLD;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,UAAS,aAAkB,KAC1B,OAAO,CAAC,YAAY,CAqBtB,CAAC;AAsDF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,YAAY,KAAG,MAmBzD,CAAC"}

package/dist/cli.js

@@ -1,221 +0,0 @@
-/**
- * Warden CLI command runner.
- *
- * Scans TypeScript files, runs all warden rules, optionally checks drift,
- * and returns a structured report.
- */
-import { resolve } from 'node:path';
-import { checkDrift } from './drift.js';
-import { findConfigProperty, findTrailDefinitions, parse, walk, } from './rules/ast.js';
-import { wardenRules } from './rules/index.js';
-/**
- * Collect all .ts files under a directory, excluding node_modules, dist, and .git.
- */
-const isSourceFile = (match) => !match.endsWith('.d.ts') &&
-    !match.startsWith('node_modules/') &&
-    !match.startsWith('dist/') &&
-    !match.startsWith('.git/') &&
-    !match.includes('__tests__/') &&
-    !match.includes('__test__/') &&
-    !match.endsWith('.test.ts') &&
-    !match.endsWith('.spec.ts');
-const collectTsFiles = (dir) => {
-    const glob = new Bun.Glob('**/*.ts');
-    let matches;
-    try {
-        matches = glob.scanSync({ cwd: dir, dot: false, onlyFiles: true });
-    }
-    catch {
-        return [];
-    }
-    const files = [];
-    for (const match of matches) {
-        if (isSourceFile(match)) {
-            files.push(`${dir}/${match}`);
-        }
-    }
-    return files;
-};
-const collectKnownTrailIds = (sourceCode, filePath, knownTrailIds) => {
-    const ast = parse(filePath, sourceCode);
-    if (!ast) {
-        return;
-    }
-    for (const def of findTrailDefinitions(ast)) {
-        knownTrailIds.add(def.id);
-    }
-};
-const collectDetourTargetTrailIds = (sourceCode, filePath, detourTargetTrailIds) => {
-    const ast = parse(filePath, sourceCode);
-    if (!ast) {
-        return;
-    }
-    for (const def of findTrailDefinitions(ast)) {
-        const detoursProp = findConfigProperty(def.config, 'detours');
-        if (!detoursProp) {
-            continue;
-        }
-        // Walk the detours value for string literals that look like trail IDs
-        walk(detoursProp, (node) => {
-            if (node.type !== 'Literal') {
-                return;
-            }
-            const val = node.value;
-            if (val && val.includes('.')) {
-                detourTargetTrailIds.add(val);
-            }
-        });
-    }
-};
-const loadSourceFiles = async (rootDir) => {
-    const sourceFiles = [];
-    for (const filePath of collectTsFiles(rootDir)) {
-        try {
-            sourceFiles.push({
-                filePath,
-                sourceCode: await Bun.file(filePath).text(),
-            });
-        }
-        catch {
-            continue;
-        }
-    }
-    return sourceFiles;
-};
-const buildProjectContextFromTopo = (appTopo) => {
-    const knownTrailIds = new Set([
-        ...appTopo.trails.keys(),
-        ...appTopo.hikes.keys(),
-    ]);
-    const detourTargetTrailIds = new Set();
-    for (const t of appTopo.trails.values()) {
-        const detours = t['detours'];
-        if (!detours) {
-            continue;
-        }
-        for (const targets of Object.values(detours)) {
-            for (const id of targets) {
-                detourTargetTrailIds.add(id);
-            }
-        }
-    }
-    return { detourTargetTrailIds, knownTrailIds };
-};
-const buildProjectContextFromFiles = (sourceFiles) => {
-    const knownTrailIds = new Set();
-    const detourTargetTrailIds = new Set();
-    for (const sourceFile of sourceFiles) {
-        collectKnownTrailIds(sourceFile.sourceCode, sourceFile.filePath, knownTrailIds);
-        collectDetourTargetTrailIds(sourceFile.sourceCode, sourceFile.filePath, detourTargetTrailIds);
-    }
-    return {
-        detourTargetTrailIds,
-        knownTrailIds,
-    };
-};
-const isProjectAwareRule = (rule) => 'checkWithContext' in rule;
-/**
- * Lint all files against all warden rules.
- */
-const lintFiles = async (rootDir, appTopo) => {
-    const allDiagnostics = [];
-    const sourceFiles = await loadSourceFiles(rootDir);
-    const context = appTopo
-        ? buildProjectContextFromTopo(appTopo)
-        : buildProjectContextFromFiles(sourceFiles);
-    for (const sourceFile of sourceFiles) {
-        for (const rule of wardenRules.values()) {
-            if (isProjectAwareRule(rule)) {
-                allDiagnostics.push(...rule.checkWithContext(sourceFile.sourceCode, sourceFile.filePath, context));
-                continue;
-            }
-            allDiagnostics.push(...rule.check(sourceFile.sourceCode, sourceFile.filePath));
-        }
-    }
-    return allDiagnostics;
-};
-/**
- * Run all warden checks and return a structured report.
- */
-export const runWarden = async (options = {}) => {
-    const rootDir = resolve(options.rootDir ?? process.cwd());
-    const allDiagnostics = options.driftOnly
-        ? []
-        : await lintFiles(rootDir, options.topo);
-    const drift = options.lintOnly
-        ? null
-        : await checkDrift(rootDir, options.topo);
-    const errorCount = allDiagnostics.filter((d) => d.severity === 'error').length;
-    const warnCount = allDiagnostics.filter((d) => d.severity === 'warn').length;
-    return {
-        diagnostics: allDiagnostics,
-        drift,
-        errorCount,
-        passed: errorCount === 0 && !(drift?.stale ?? false),
-        warnCount,
-    };
-};
-/**
- * Format the lint section of the report.
- */
-const formatLintSection = (report) => {
-    if (report.diagnostics.length === 0) {
-        return ['Lint: clean'];
-    }
-    const lines = [
-        `Lint: ${report.errorCount} errors, ${report.warnCount} warnings`,
-    ];
-    for (const d of report.diagnostics) {
-        const prefix = d.severity === 'error' ? 'ERROR' : 'WARN';
-        lines.push(`  ${d.filePath}:${String(d.line)}  [${prefix}] ${d.rule}  ${d.message}`);
-    }
-    return lines;
-};
-/**
- * Format the drift section of the report.
- */
-const formatDriftSection = (drift) => {
-    if (drift === null) {
-        return [];
-    }
-    const label = drift.stale
-        ? 'Drift: surface.lock is stale (regenerate with `trails survey generate`)'
-        : 'Drift: clean';
-    return [label, ''];
-};
-/**
- * Format the result line.
- */
-const formatResultLine = (report) => {
-    if (report.passed) {
-        return 'Result: PASS';
-    }
-    const parts = [];
-    if (report.errorCount > 0) {
-        parts.push(`${report.errorCount} errors`);
-    }
-    if (report.drift?.stale) {
-        parts.push('drift detected');
-    }
-    return `Result: FAIL (${parts.join(', ')})`;
-};
-/**
- * Format a warden report as a human-readable string.
- */
-export const formatWardenReport = (report) => {
-    const lintLines = formatLintSection(report);
-    const driftLines = formatDriftSection(report.drift);
-    if (lintLines.length === 0 && driftLines.length === 0) {
-        return ['Warden Report', '=============', '', 'No checks were run.'].join('\n');
-    }
-    return [
-        'Warden Report',
-        '=============',
-        '',
-        ...lintLines,
-        '',
-        ...driftLines,
-        formatResultLine(report),
-    ].join('\n');
-};
-//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/drift.d.ts

@@ -1,26 +0,0 @@
-/**
- * Surface lock drift detection.
- *
- * Compares the committed `surface.lock` hash against a freshly generated
- * surface map hash to detect when the trail topology has changed without
- * updating the lock file.
- */
-import type { Topo } from '@ontrails/core';
-/**
- * Result of a drift check comparing committed surface.lock against the current state.
- */
-export interface DriftResult {
-    /** Whether the committed lock is out of date */
-    readonly stale: boolean;
-    /** Hash from the committed surface.lock file, or null if not found */
-    readonly committedHash: string | null;
-    /** Hash computed from the current trail topology */
-    readonly currentHash: string;
-}
-/**
- * Check whether the committed surface.lock is stale compared to the current topology.
- *
- * When no topo is provided, returns a clean result (no drift detectable without runtime info).
- */
-export declare const checkDrift: (rootDir: string, topo?: Topo | undefined) => Promise<DriftResult>;
-//# sourceMappingURL=drift.d.ts.map

package/dist/drift.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../src/drift.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAO3C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,EACf,OAAO,IAAI,GAAG,SAAS,KACtB,OAAO,CAAC,WAAW,CAcrB,CAAC"}

package/dist/drift.js

@@ -1,27 +0,0 @@
-/**
- * Surface lock drift detection.
- *
- * Compares the committed `surface.lock` hash against a freshly generated
- * surface map hash to detect when the trail topology has changed without
- * updating the lock file.
- */
-import { generateSurfaceMap, hashSurfaceMap, readSurfaceLock, } from '@ontrails/schema';
-/**
- * Check whether the committed surface.lock is stale compared to the current topology.
- *
- * When no topo is provided, returns a clean result (no drift detectable without runtime info).
- */
-export const checkDrift = async (rootDir, topo) => {
-    if (!topo) {
-        return { committedHash: null, currentHash: 'unknown', stale: false };
-    }
-    const surfaceMap = generateSurfaceMap(topo);
-    const currentHash = hashSurfaceMap(surfaceMap);
-    const committedHash = await readSurfaceLock({ dir: rootDir });
-    return {
-        committedHash,
-        currentHash,
-        stale: committedHash !== null && committedHash !== currentHash,
-    };
-};
-//# sourceMappingURL=drift.js.map

package/dist/drift.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"drift.js","sourceRoot":"","sources":["../src/drift.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAc1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,OAAe,EACf,IAAuB,EACD,EAAE;IACxB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACvE,CAAC;IAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IAE9D,OAAO;QACL,aAAa;QACb,WAAW;QACX,KAAK,EAAE,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,WAAW;KAC/D,CAAC;AACJ,CAAC,CAAC"}

package/dist/formatters.d.ts

@@ -1,29 +0,0 @@
-/**
- * CI-oriented formatters for warden reports.
- *
- * Each formatter takes a `WardenReport` and produces output suited to a
- * specific CI environment: GitHub Actions annotations, structured JSON,
- * or a concise markdown summary.
- */
-import type { WardenReport } from './cli.js';
-/**
- * Produce GitHub Actions workflow command annotations, one per diagnostic.
- *
- * Severity mapping: `error` to `::error`, `warn` to `::warning`.
- * Drift staleness is emitted as a single `::error` annotation when detected.
- */
-export declare const formatGitHubAnnotations: (report: WardenReport) => string;
-/**
- * Produce a structured JSON string from the report.
- *
- * Includes a `summary` object with error, warning, and suggestion counts
- * for easy consumption by downstream tooling.
- */
-export declare const formatJson: (report: WardenReport) => string;
-/**
- * Produce a concise markdown summary suitable for a GitHub job summary or PR comment.
- *
- * Groups diagnostics by severity and includes drift status when relevant.
- */
-export declare const formatSummary: (report: WardenReport) => string;
-//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAS7C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ,YAAY,KAAG,MAiB9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,YAAY,KAAG,MAiBjD,CAAC;AA6BF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,YAAY,KAAG,MAapD,CAAC"}