@timiagama/ecr 0.0.1 → 0.1.0

package/dist/cli/corpus-statistics.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Corpus Statistics
+ *
+ * Counts the structure ECR makes explicit, so that a reader can measure their
+ * own corpus rather than take anyone's figures on trust. Every number here is
+ * derived from validated artefacts, not from a regular expression over the
+ * source, so the same corpus always yields the same counts.
+ */
+import type { CorpusResult } from '../types.js';
+/**
+ * Counts of References-section entries by their declared direction.
+ */
+export interface DirectionCounts {
+    /** Entries declaring the cited document as an authority. */
+    readonly authority: number;
+    /** Entries declaring the cited document as a constraint. */
+    readonly constraint: number;
+    /** Entries declaring the cited document as a contract. */
+    readonly contract: number;
+    /** Entries declaring the cited document as a dependency. */
+    readonly dependency: number;
+}
+/**
+ * A measured summary of an ECR corpus.
+ */
+export interface CorpusStatisticsReport {
+    /** Documents validated, excluding meta-documents. */
+    readonly documents: number;
+    /** Documents that carry at least one References entry. */
+    readonly documentsWithReferences: number;
+    /** Sections extracted across the corpus, excluding the root H1 of each document. */
+    readonly sections: number;
+    /** Unique DocIDs found in the corpus. */
+    readonly docIds: number;
+    /** Unique SectionIDs found in the corpus. */
+    readonly sectionIds: number;
+    /** References-section entries, the document-level edges. */
+    readonly referenceEntries: number;
+    /** References-section entries broken down by direction. */
+    readonly referencesByDirection: DirectionCounts;
+    /** Inline `see`/`per` references. */
+    readonly inlineReferences: number;
+    /** Inline references naming a precise section rather than a whole document. */
+    readonly sectionPreciseInlineReferences: number;
+    /** Every edge in the corpus: References entries plus inline references. */
+    readonly totalEdges: number;
+    /**
+     * Whether every input document was parsed successfully. This does not imply
+     * ECR conformance or complete extraction.
+     *
+     * A document that was parsed but has no recoverable DocID contributes
+     * nothing to any count, and one with structural errors contributes whatever
+     * did pass validation; both leave this `true`, because both were parsed.
+     * Only a document the parser could not read at all makes it `false`, and
+     * {@link unparsable} names those documents.
+     */
+    readonly complete: boolean;
+    /**
+     * Documents the parser could not read at all, which contribute nothing.
+     * A document with ordinary validation errors is not listed here: it still
+     * contributes whatever passed validation.
+     */
+    readonly unparsable: readonly string[];
+}
+/**
+ * Derives a statistical summary from a corpus validation result.
+ *
+ * Only documents that produced extracted artefacts contribute, which means
+ * every document with a valid H1 DocID. A document with other structural
+ * errors still counts, and contributes whatever was extracted from it: a
+ * heading or References entry that could not be read at all adds nothing,
+ * while one reported for something other than its structure -- a heading
+ * whose source form breaks the navigation guarantee, say -- is extracted and
+ * counted like any other. A document with no recoverable DocID contributes
+ * nothing at all.
+ */
+export declare class CorpusStatistics {
+    /** The validation result to summarise. */
+    private readonly corpusResult;
+    /**
+     * Creates a summariser for one validation result.
+     *
+     * @param corpusResult - The result produced by validating the corpus
+     */
+    constructor(corpusResult: CorpusResult);
+    /**
+     * Computes the summary.
+     *
+     * @returns Counts describing the corpus's explicit structure
+     */
+    summarise(): CorpusStatisticsReport;
+    /**
+     * Gathers the extracted artefacts of every document that produced them.
+     *
+     * @returns Extracted documents, in corpus order
+     */
+    private collectExtractedDocuments;
+    /**
+     * Names the documents the parser could not read, so that a reader knows
+     * what these counts leave out rather than taking them for the whole corpus.
+     *
+     * @returns Their URIs, in corpus order
+     */
+    private collectUnparsableDocuments;
+    /**
+     * Counts the entries of a corpus index map.
+     *
+     * @param index - A DocID or SectionID index, absent when indexing did not succeed
+     * @returns The number of entries, or 0 when the index is absent
+     */
+    private countIndexEntries;
+}
+//# sourceMappingURL=corpus-statistics.d.ts.map

package/dist/cli/corpus-statistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus-statistics.d.ts","sourceRoot":"","sources":["../../src/cli/corpus-statistics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAyC,MAAM,aAAa,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,qBAAqB,EAAE,eAAe,CAAC;IAChD,qCAAqC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,8BAA8B,EAAE,MAAM,CAAC;IAChD,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C;;;;OAIG;gBACgB,YAAY,EAAE,YAAY;IAI7C;;;;OAIG;IACI,SAAS,IAAI,sBAAsB;IAsD1C;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAYjC;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;CAG1B"}

package/dist/cli/corpus-statistics.js

@@ -0,0 +1,119 @@
+/**
+ * Corpus Statistics
+ *
+ * Counts the structure ECR makes explicit, so that a reader can measure their
+ * own corpus rather than take anyone's figures on trust. Every number here is
+ * derived from validated artefacts, not from a regular expression over the
+ * source, so the same corpus always yields the same counts.
+ */
+import { UNPARSABLE_DOCUMENT_RULE_ID } from '../per-document-visitor.js';
+/**
+ * Derives a statistical summary from a corpus validation result.
+ *
+ * Only documents that produced extracted artefacts contribute, which means
+ * every document with a valid H1 DocID. A document with other structural
+ * errors still counts, and contributes whatever was extracted from it: a
+ * heading or References entry that could not be read at all adds nothing,
+ * while one reported for something other than its structure -- a heading
+ * whose source form breaks the navigation guarantee, say -- is extracted and
+ * counted like any other. A document with no recoverable DocID contributes
+ * nothing at all.
+ */
+export class CorpusStatistics {
+    /** The validation result to summarise. */
+    corpusResult;
+    /**
+     * Creates a summariser for one validation result.
+     *
+     * @param corpusResult - The result produced by validating the corpus
+     */
+    constructor(corpusResult) {
+        this.corpusResult = corpusResult;
+    }
+    /**
+     * Computes the summary.
+     *
+     * @returns Counts describing the corpus's explicit structure
+     */
+    summarise() {
+        const extractedDocuments = this.collectExtractedDocuments();
+        const unparsable = this.collectUnparsableDocuments();
+        let documentsWithReferences = 0;
+        let sections = 0;
+        let referenceEntries = 0;
+        let inlineReferences = 0;
+        let sectionPreciseInlineReferences = 0;
+        const referencesByDirection = {
+            authority: 0,
+            constraint: 0,
+            contract: 0,
+            dependency: 0,
+        };
+        for (const document of extractedDocuments) {
+            if (document.references.length > 0) {
+                documentsWithReferences += 1;
+            }
+            // The root H1 is a node but not a section, so it is not counted here.
+            sections += Math.max(document.sections.length - 1, 0);
+            referenceEntries += document.references.length;
+            inlineReferences += document.inlineReferences.length;
+            for (const reference of document.references) {
+                referencesByDirection[reference.direction] += 1;
+            }
+            for (const inlineReference of document.inlineReferences) {
+                if (inlineReference.toId.includes('#')) {
+                    sectionPreciseInlineReferences += 1;
+                }
+            }
+        }
+        return {
+            documents: extractedDocuments.length,
+            documentsWithReferences,
+            sections,
+            docIds: this.countIndexEntries(this.corpusResult.index?.docIds),
+            sectionIds: this.countIndexEntries(this.corpusResult.index?.sectionIds),
+            referenceEntries,
+            referencesByDirection: { ...referencesByDirection },
+            inlineReferences,
+            sectionPreciseInlineReferences,
+            totalEdges: referenceEntries + inlineReferences,
+            complete: unparsable.length === 0,
+            unparsable,
+        };
+    }
+    /**
+     * Gathers the extracted artefacts of every document that produced them.
+     *
+     * @returns Extracted documents, in corpus order
+     */
+    collectExtractedDocuments() {
+        const extracted = [];
+        for (const entry of this.corpusResult.documents) {
+            if (entry.result.extracted !== undefined) {
+                extracted.push(entry.result.extracted);
+            }
+        }
+        return extracted;
+    }
+    /**
+     * Names the documents the parser could not read, so that a reader knows
+     * what these counts leave out rather than taking them for the whole corpus.
+     *
+     * @returns Their URIs, in corpus order
+     */
+    collectUnparsableDocuments() {
+        return this.corpusResult.documents
+            .filter((entry) => entry.result.diagnostics.some((diagnostic) => diagnostic.ruleId === UNPARSABLE_DOCUMENT_RULE_ID))
+            .map((entry) => entry.uri);
+    }
+    /**
+     * Counts the entries of a corpus index map.
+     *
+     * @param index - A DocID or SectionID index, absent when indexing did not succeed
+     * @returns The number of entries, or 0 when the index is absent
+     */
+    countIndexEntries(index) {
+        return index === undefined ? 0 : Object.keys(index).length;
+    }
+}
+//# sourceMappingURL=corpus-statistics.js.map

package/dist/cli/corpus-statistics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus-statistics.js","sourceRoot":"","sources":["../../src/cli/corpus-statistics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AA4DzE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,gBAAgB;IAC3B,0CAA0C;IACzB,YAAY,CAAe;IAE5C;;;;OAIG;IACH,YAAmB,YAA0B;QAC3C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACI,SAAS;QACd,MAAM,kBAAkB,GAAiC,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC1F,MAAM,UAAU,GAAsB,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAExE,IAAI,uBAAuB,GAAW,CAAC,CAAC;QACxC,IAAI,QAAQ,GAAW,CAAC,CAAC;QACzB,IAAI,gBAAgB,GAAW,CAAC,CAAC;QACjC,IAAI,gBAAgB,GAAW,CAAC,CAAC;QACjC,IAAI,8BAA8B,GAAW,CAAC,CAAC;QAE/C,MAAM,qBAAqB,GAAuC;YAChE,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,CAAC;SACd,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,kBAAkB,EAAE,CAAC;YAC1C,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,uBAAuB,IAAI,CAAC,CAAC;YAC/B,CAAC;YAED,sEAAsE;YACtE,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACtD,gBAAgB,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;YAC/C,gBAAgB,IAAI,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC;YAErD,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAC5C,qBAAqB,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;YAED,KAAK,MAAM,eAAe,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;gBACxD,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACvC,8BAA8B,IAAI,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,SAAS,EAAE,kBAAkB,CAAC,MAAM;YACpC,uBAAuB;YACvB,QAAQ;YACR,MAAM,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC;YAC/D,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC;YACvE,gBAAgB;YAChB,qBAAqB,EAAE,EAAE,GAAG,qBAAqB,EAAE;YACnD,gBAAgB;YAChB,8BAA8B;YAC9B,UAAU,EAAE,gBAAgB,GAAG,gBAAgB;YAC/C,QAAQ,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;YACjC,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,yBAAyB;QAC/B,MAAM,SAAS,GAAwB,EAAE,CAAC;QAE1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACzC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACK,0BAA0B;QAChC,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS;aAC/B,MAAM,CAAC,CAAC,KAAK,EAAW,EAAE,CACzB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAC3B,CAAC,UAAU,EAAW,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,2BAA2B,CAC3E,CACF;aACA,GAAG,CAAC,CAAC,KAAK,EAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACK,iBAAiB,CAAC,KAAmD;QAC3E,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAC7D,CAAC;CACF"}

package/dist/cli/diagnostic-reporter.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Diagnostic Reporting
+ *
+ * Renders validation results for a terminal or for a machine. The pretty form
+ * groups diagnostics by document and prints a `path:line:column` prefix so an
+ * editor can jump to them; the JSON form is the same data unformatted, for CI
+ * and for tooling built on top of the CLI.
+ */
+import type { CorpusResult } from '../types.js';
+import type { CorpusStatisticsReport } from './corpus-statistics.js';
+/**
+ * Output formats the CLI can produce.
+ */
+export type ReportFormat = 'pretty' | 'json';
+/**
+ * Counts of diagnostics by severity.
+ */
+export interface SeverityTotals {
+    /** Diagnostics that make the corpus non-conforming. */
+    readonly errors: number;
+    /** Diagnostics that warrant attention but do not fail validation. */
+    readonly warnings: number;
+    /** Informational diagnostics. */
+    readonly infos: number;
+}
+/**
+ * Formats corpus validation results and statistics for output.
+ */
+export declare class DiagnosticReporter {
+    /** The format to render in. */
+    private readonly format;
+    /**
+     * Creates a reporter.
+     *
+     * @param format - The output format to produce
+     */
+    constructor(format: ReportFormat);
+    /**
+     * Renders a corpus validation result.
+     *
+     * @param corpusResult - The result to render
+     * @param excludedPaths - Paths skipped as meta-documents or by ignore pattern
+     * @param notFollowedPaths - Links beneath the corpus root that were not followed
+     * @returns The text to write to standard output
+     */
+    reportValidation(corpusResult: CorpusResult, excludedPaths: readonly string[], notFollowedPaths: readonly string[]): string;
+    /**
+     * Renders a statistics report.
+     *
+     * @param statistics - The measured summary to render
+     * @param notFollowedPaths - Links beneath the corpus root that were not followed, and so not measured
+     * @returns The text to write to standard output
+     */
+    reportStatistics(statistics: CorpusStatisticsReport, notFollowedPaths: readonly string[]): string;
+    /**
+     * Counts the documents the parser could not read.
+     *
+     * @param corpusResult - The result being reported
+     * @returns How many documents produced an unparsable-document diagnostic
+     */
+    private static countUnparsable;
+    /**
+     * Lists the links a walk did not follow, by name: unlike an exclusion,
+     * nobody asked for them to be skipped.
+     *
+     * @param notFollowedPaths - Links beneath the corpus root that were not followed
+     * @returns Lines to print; none when there are no such links
+     */
+    static listNotFollowed(notFollowedPaths: readonly string[]): readonly string[];
+    /**
+     * Renders the human-readable form of a validation result.
+     *
+     * @param corpusResult - The result being rendered
+     * @param located - Diagnostics paired with their document paths
+     * @param totals - Severity counts across the corpus
+     * @param excludedPaths - Paths skipped during discovery
+     * @param notFollowedPaths - Links beneath the corpus root that were not followed
+     * @returns The text to write to standard output
+     */
+    private renderPretty;
+    /**
+     * Flattens per-document and corpus-wide diagnostics into one ordered list,
+     * grouped by document.
+     *
+     * A corpus-wide diagnostic still names the document it concerns — a
+     * duplicate DocID, an unresolved reference or a stale References title each
+     * belong to a specific file — so it is listed under that document, after the
+     * document's own diagnostics. Only a corpus-wide diagnostic whose URI matches
+     * no validated document falls back to the `(corpus)` label.
+     *
+     * @param corpusResult - The result to read
+     * @returns Diagnostics paired with the path they belong to, in document order
+     */
+    private collectDiagnostics;
+    /**
+     * Counts diagnostics by severity.
+     *
+     * @param located - The diagnostics to count
+     * @returns Totals per severity
+     */
+    private countSeverities;
+}
+//# sourceMappingURL=diagnostic-reporter.d.ts.map

package/dist/cli/diagnostic-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-reporter.d.ts","sourceRoot":"","sources":["../../src/cli/diagnostic-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAkC,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAmB,MAAM,wBAAwB,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAY7C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAKD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC;;;;OAIG;gBACgB,MAAM,EAAE,YAAY;IAIvC;;;;;;;OAOG;IACI,gBAAgB,CACrB,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,MAAM;IAiCT;;;;;;OAMG;IACI,gBAAgB,CACrB,UAAU,EAAE,sBAAsB,EAClC,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,MAAM;IAkDT;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAQ9B;;;;;;OAMG;WACW,eAAe,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE;IAWrF;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;IAuEpB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAmBxB"}

package/dist/cli/diagnostic-reporter.js

@@ -0,0 +1,254 @@
+/**
+ * Diagnostic Reporting
+ *
+ * Renders validation results for a terminal or for a machine. The pretty form
+ * groups diagnostics by document and prints a `path:line:column` prefix so an
+ * editor can jump to them; the JSON form is the same data unformatted, for CI
+ * and for tooling built on top of the CLI.
+ */
+import { showControlCharacters } from './safe-text.js';
+import { UNPARSABLE_DOCUMENT_RULE_ID } from '../per-document-visitor.js';
+/** Label used for a diagnostic whose URI matches no validated document. */
+const CORPUS_SCOPE_LABEL = '(corpus)';
+/**
+ * Formats corpus validation results and statistics for output.
+ */
+export class DiagnosticReporter {
+    /** The format to render in. */
+    format;
+    /**
+     * Creates a reporter.
+     *
+     * @param format - The output format to produce
+     */
+    constructor(format) {
+        this.format = format;
+    }
+    /**
+     * Renders a corpus validation result.
+     *
+     * @param corpusResult - The result to render
+     * @param excludedPaths - Paths skipped as meta-documents or by ignore pattern
+     * @param notFollowedPaths - Links beneath the corpus root that were not followed
+     * @returns The text to write to standard output
+     */
+    reportValidation(corpusResult, excludedPaths, notFollowedPaths) {
+        const located = this.collectDiagnostics(corpusResult);
+        const totals = this.countSeverities(located);
+        if (this.format === 'json') {
+            return JSON.stringify({
+                documents: corpusResult.documents.length,
+                excluded: excludedPaths,
+                notFollowed: notFollowedPaths,
+                totals,
+                diagnostics: located.map((entry) => ({
+                    path: entry.path,
+                    ruleId: entry.diagnostic.ruleId,
+                    severity: entry.diagnostic.severity,
+                    message: entry.diagnostic.message,
+                    ...(entry.diagnostic.range !== undefined
+                        ? {
+                            // Positions are zero-based internally; editors are one-based.
+                            line: entry.diagnostic.range.start.line + 1,
+                            column: entry.diagnostic.range.start.character + 1,
+                        }
+                        : {}),
+                })),
+            }, null, 2);
+        }
+        return this.renderPretty(corpusResult, located, totals, excludedPaths, notFollowedPaths);
+    }
+    /**
+     * Renders a statistics report.
+     *
+     * @param statistics - The measured summary to render
+     * @param notFollowedPaths - Links beneath the corpus root that were not followed, and so not measured
+     * @returns The text to write to standard output
+     */
+    reportStatistics(statistics, notFollowedPaths) {
+        if (this.format === 'json') {
+            return JSON.stringify({ ...statistics, notFollowed: notFollowedPaths }, null, 2);
+        }
+        const direction = statistics.referencesByDirection;
+        const links = DiagnosticReporter.listNotFollowed(notFollowedPaths);
+        // A document the parser could not read contributes nothing to any of
+        // these numbers, so saying which ones, and that the numbers are therefore
+        // partial, is the difference between a measurement and a misreading.
+        const unparsable = statistics.unparsable.length === 0
+            ? []
+            : [
+                `  ${String(statistics.unparsable.length)} document(s) could not be parsed, ` +
+                    'so they are not counted above:',
+                ...statistics.unparsable.map((path) => `    ${path}`),
+                '  These statistics describe the rest of the corpus.',
+                '',
+            ];
+        const lines = [
+            '',
+            '  Corpus structure',
+            '  ────────────────',
+            `  documents                      ${String(statistics.documents)}`,
+            `    with a References section    ${String(statistics.documentsWithReferences)}`,
+            `  sections                       ${String(statistics.sections)}`,
+            '',
+            `  unique DocIDs                  ${String(statistics.docIds)}`,
+            `  unique SectionIDs              ${String(statistics.sectionIds)}`,
+            '',
+            `  References entries             ${String(statistics.referenceEntries)}`,
+            `    authority                    ${String(direction.authority)}`,
+            `    constraint                   ${String(direction.constraint)}`,
+            `    contract                     ${String(direction.contract)}`,
+            `    dependency                   ${String(direction.dependency)}`,
+            '',
+            `  inline see/per references      ${String(statistics.inlineReferences)}`,
+            `    section-precise              ${String(statistics.sectionPreciseInlineReferences)}`,
+            '',
+            `  total edges                    ${String(statistics.totalEdges)}`,
+            '',
+            ...unparsable,
+            ...links,
+            ...(links.length > 0 ? [''] : []),
+        ];
+        return showControlCharacters(lines.join('\n'));
+    }
+    /**
+     * Counts the documents the parser could not read.
+     *
+     * @param corpusResult - The result being reported
+     * @returns How many documents produced an unparsable-document diagnostic
+     */
+    static countUnparsable(corpusResult) {
+        return corpusResult.documents.filter((entry) => entry.result.diagnostics.some((diagnostic) => diagnostic.ruleId === UNPARSABLE_DOCUMENT_RULE_ID)).length;
+    }
+    /**
+     * Lists the links a walk did not follow, by name: unlike an exclusion,
+     * nobody asked for them to be skipped.
+     *
+     * @param notFollowedPaths - Links beneath the corpus root that were not followed
+     * @returns Lines to print; none when there are no such links
+     */
+    static listNotFollowed(notFollowedPaths) {
+        if (notFollowedPaths.length === 0) {
+            return [];
+        }
+        return [
+            `  ${String(notFollowedPaths.length)} link(s) not followed:`,
+            ...notFollowedPaths.map((path) => `    ${path}`),
+        ];
+    }
+    /**
+     * Renders the human-readable form of a validation result.
+     *
+     * @param corpusResult - The result being rendered
+     * @param located - Diagnostics paired with their document paths
+     * @param totals - Severity counts across the corpus
+     * @param excludedPaths - Paths skipped during discovery
+     * @param notFollowedPaths - Links beneath the corpus root that were not followed
+     * @returns The text to write to standard output
+     */
+    renderPretty(corpusResult, located, totals, excludedPaths, notFollowedPaths) {
+        const lines = [''];
+        let currentPath = undefined;
+        for (const entry of located) {
+            if (entry.path !== currentPath) {
+                lines.push(`  ${entry.path}`);
+                currentPath = entry.path;
+            }
+            const position = entry.diagnostic.range !== undefined
+                ? `${String(entry.diagnostic.range.start.line + 1)}:` +
+                    String(entry.diagnostic.range.start.character + 1)
+                : '-';
+            lines.push(`    ${position.padEnd(8)} ${entry.diagnostic.severity.padEnd(7)} ` +
+                `${entry.diagnostic.ruleId.padEnd(10)} ${entry.diagnostic.message}`);
+        }
+        if (located.length > 0) {
+            lines.push('');
+        }
+        const documentCount = String(corpusResult.documents.length);
+        // "checked" covers every document the command attempted, which is not the
+        // same as every document having been validated: one the parser could not
+        // read was attempted and counted, but nothing in it was validated. Those
+        // are then stated outright, and their errors are in the total already.
+        const unparsableCount = DiagnosticReporter.countUnparsable(corpusResult);
+        const unparsableNote = unparsableCount > 0
+            ? ` ${String(unparsableCount)} document(s) could not be parsed.`
+            : '';
+        if (totals.errors === 0 && totals.warnings > 0) {
+            lines.push(`  ${documentCount} document(s) checked, no errors, ` +
+                `${String(totals.warnings)} warning(s).${unparsableNote}`);
+        }
+        else if (totals.errors === 0) {
+            lines.push(`  ${documentCount} document(s) checked, no errors.${unparsableNote}`);
+        }
+        else {
+            lines.push(`  ${documentCount} document(s) checked: ` +
+                `${String(totals.errors)} error(s), ${String(totals.warnings)} warning(s).${unparsableNote}`);
+        }
+        if (excludedPaths.length > 0) {
+            lines.push(`  ${String(excludedPaths.length)} path(s) excluded.`);
+        }
+        lines.push(...DiagnosticReporter.listNotFollowed(notFollowedPaths));
+        lines.push('');
+        // Every line here can carry text quoted from a document or a path from
+        // the disk, so the whole report is made safe to print in one place.
+        return showControlCharacters(lines.join('\n'));
+    }
+    /**
+     * Flattens per-document and corpus-wide diagnostics into one ordered list,
+     * grouped by document.
+     *
+     * A corpus-wide diagnostic still names the document it concerns — a
+     * duplicate DocID, an unresolved reference or a stale References title each
+     * belong to a specific file — so it is listed under that document, after the
+     * document's own diagnostics. Only a corpus-wide diagnostic whose URI matches
+     * no validated document falls back to the `(corpus)` label.
+     *
+     * @param corpusResult - The result to read
+     * @returns Diagnostics paired with the path they belong to, in document order
+     */
+    collectDiagnostics(corpusResult) {
+        const located = [];
+        const documentUris = new Set(corpusResult.documents.map((entry) => entry.uri));
+        for (const entry of corpusResult.documents) {
+            for (const diagnostic of entry.result.diagnostics) {
+                located.push({ path: entry.uri, diagnostic });
+            }
+            for (const diagnostic of corpusResult.diagnostics) {
+                if (diagnostic.uri === entry.uri) {
+                    located.push({ path: entry.uri, diagnostic });
+                }
+            }
+        }
+        for (const diagnostic of corpusResult.diagnostics) {
+            if (!documentUris.has(diagnostic.uri)) {
+                located.push({ path: CORPUS_SCOPE_LABEL, diagnostic });
+            }
+        }
+        return located;
+    }
+    /**
+     * Counts diagnostics by severity.
+     *
+     * @param located - The diagnostics to count
+     * @returns Totals per severity
+     */
+    countSeverities(located) {
+        let errors = 0;
+        let warnings = 0;
+        let infos = 0;
+        for (const entry of located) {
+            const severity = entry.diagnostic.severity;
+            if (severity === 'error') {
+                errors += 1;
+            }
+            else if (severity === 'warning') {
+                warnings += 1;
+            }
+            else {
+                infos += 1;
+            }
+        }
+        return { errors, warnings, infos };
+    }
+}
+//# sourceMappingURL=diagnostic-reporter.js.map

package/dist/cli/diagnostic-reporter.js.map

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