renovate-log-parser 0.1.0

package/dist/core/analyzer.js

@@ -0,0 +1,179 @@
+import { buildQuery, buildCountQuery } from "./query-builder.js";
+/** The `msg` that marks the entry carrying the dependency inventory. */
+const PACKAGE_FILES_MSG = "packageFiles with updates";
+/** The `msg` that marks the entry carrying `branchesInformation`. */
+const BRANCHES_INFO_MSG = "branches info extended";
+/**
+ * Computes the `analyze` command's stats and print views against an
+ * already-loaded {@link Parser}.
+ */
+export class Analyzer {
+    parser;
+    constructor(parser) {
+        this.parser = parser;
+    }
+    /** Build the whole-log statistics view (single pass, all repositories). */
+    stats() {
+        const loaded = this.requireLoaded();
+        const rows = this.parser.queryEntries("SELECT line, logentry FROM logs ORDER BY rowid");
+        const levelCounts = {};
+        const repos = new Map();
+        for (const { line, entry } of rows) {
+            // Synthetic parser rows (blank / malformed) carry no structural signal.
+            if (entry._blank === true || entry._parseError === true)
+                continue;
+            if (typeof entry.level === "number") {
+                const key = String(entry.level);
+                levelCounts[key] = (levelCounts[key] ?? 0) + 1;
+            }
+            const repository = typeof entry.repository === "string" ? entry.repository : undefined;
+            // Skip entries with no repository, and git-URL sub-repos (e.g. pre-commit
+            // hooks) whose `repository` is an `https://…` URL rather than an
+            // `owner/repo` target — they are noise in the per-repo structure view.
+            if (repository === undefined || repository.startsWith("https://")) {
+                continue;
+            }
+            let acc = repos.get(repository);
+            if (acc === undefined) {
+                acc = newAccumulator(repository, line);
+                repos.set(repository, acc);
+            }
+            // Rows arrive in ascending rowid order, so toLine grows monotonically.
+            acc.toLine = line;
+            if (typeof entry.branch === "string")
+                acc.branches.add(entry.branch);
+            if (Array.isArray(entry.repoProblems)) {
+                for (const problem of entry.repoProblems) {
+                    if (typeof problem === "string")
+                        acc.repoProblems.add(problem);
+                }
+            }
+            if (typeof entry.depName === "string")
+                acc.depNames.add(entry.depName);
+            if (typeof entry.packageName === "string") {
+                acc.packageNames.add(entry.packageName);
+            }
+            if (entry.msg === BRANCHES_INFO_MSG &&
+                acc.branchesInformationLine === null) {
+                acc.branchesInformationLine = line;
+            }
+            if (entry.msg === PACKAGE_FILES_MSG) {
+                if (acc.packageFilesLine === null)
+                    acc.packageFilesLine = line;
+                collectConfigDeps(entry.config, acc.depNames, acc.packageNames);
+            }
+        }
+        return {
+            logFile: loaded.path,
+            md5: loaded.md5,
+            totalLines: loaded.totalLines,
+            levelCounts: sortLevelCounts(levelCounts),
+            // Map iteration order is first-appearance order == fromLine ascending.
+            repos: [...repos.values()].map(finalizeRepo),
+        };
+    }
+    /** Build the filtered, ranged, limited JSONL slice (print mode). */
+    print(options) {
+        this.requireLoaded();
+        const range = { lineFrom: options.lineFrom, lineTo: options.lineTo };
+        const countQuery = buildCountQuery(options.filters, range);
+        const totalMatched = this.parser.query(countQuery.sql, countQuery.params)[0]
+            ?.n ?? 0;
+        const dataQuery = buildQuery(options.filters, { ...range, limit: options.limit }, "line, logentry");
+        const rows = this.parser.queryEntries(dataQuery.sql, dataQuery.params);
+        // `msg` is never strippable, even if the caller lists it.
+        const stripped = new Set(options.ignoredFields.filter((field) => field !== "msg"));
+        const entries = rows.map(({ line, entry }) => {
+            const projected = {};
+            if (options.includeOriginalLine)
+                projected._oL = line;
+            for (const [key, value] of Object.entries(entry)) {
+                if (stripped.has(key))
+                    continue;
+                projected[key] = value;
+            }
+            return projected;
+        });
+        return {
+            entries,
+            totalMatched,
+            emitted: entries.length,
+            truncated: totalMatched > entries.length,
+        };
+    }
+    requireLoaded() {
+        const loaded = this.parser.loaded;
+        if (!loaded) {
+            throw new Error("No log loaded. Call parser.load() before analysis.");
+        }
+        return loaded;
+    }
+}
+/** Create a fresh accumulator for a newly-seen repository. */
+function newAccumulator(name, line) {
+    return {
+        name,
+        fromLine: line,
+        toLine: line,
+        branches: new Set(),
+        branchesInformationLine: null,
+        packageFilesLine: null,
+        repoProblems: new Set(),
+        depNames: new Set(),
+        packageNames: new Set(),
+    };
+}
+/** Convert an accumulator into the immutable {@link RepoStats} shape. */
+function finalizeRepo(acc) {
+    return {
+        name: acc.name,
+        fromLine: acc.fromLine,
+        toLine: acc.toLine,
+        branches: [...acc.branches],
+        branchesInformationLine: acc.branchesInformationLine,
+        packageFilesLine: acc.packageFilesLine,
+        repoProblems: [...acc.repoProblems],
+        depNames: [...acc.depNames],
+        packageNames: [...acc.packageNames],
+    };
+}
+/**
+ * Collect dependency and package names from a `packageFiles with updates`
+ * `config` object. The documented shape is `config[manager] = PackageFile[]`,
+ * each package file carrying a `deps` array of `{ depName, packageName }`.
+ * Non-conforming shapes are skipped defensively.
+ */
+function collectConfigDeps(config, depNames, packageNames) {
+    if (config === null || typeof config !== "object" || Array.isArray(config)) {
+        return;
+    }
+    for (const managerFiles of Object.values(config)) {
+        if (!Array.isArray(managerFiles))
+            continue;
+        for (const packageFile of managerFiles) {
+            if (packageFile === null || typeof packageFile !== "object")
+                continue;
+            const deps = packageFile.deps;
+            if (!Array.isArray(deps))
+                continue;
+            for (const dep of deps) {
+                if (dep === null || typeof dep !== "object")
+                    continue;
+                const { depName, packageName } = dep;
+                if (typeof depName === "string")
+                    depNames.add(depName);
+                if (typeof packageName === "string")
+                    packageNames.add(packageName);
+            }
+        }
+    }
+}
+/** Re-key the level counts in ascending numeric level order. */
+function sortLevelCounts(counts) {
+    const sorted = {};
+    for (const key of Object.keys(counts).sort((a, b) => Number(a) - Number(b))) {
+        sorted[key] = counts[key];
+    }
+    return sorted;
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/core/analyzer.js.map

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

package/dist/core/error-detector.d.ts

@@ -0,0 +1,56 @@
+import type { Parser } from "./parser.js";
+import { type IgnoreRule } from "./ignore-file.js";
+/** Ordered list of every known finding category (drives the `counts` map). */
+export declare const CATEGORIES: readonly ["host-error-abort", "log-warn", "log-error", "log-fatal", "err-object", "config-migration", "abandoned-package", "repo-problem"];
+/** A finding category. */
+export type Category = (typeof CATEGORIES)[number];
+/** Finding severity. */
+export type Severity = "error" | "warning";
+/** Severity for each category. */
+export declare const SEVERITY: Readonly<Record<Category, Severity>>;
+/** A single detected problem. */
+export interface Finding {
+    category: Category;
+    severity: Severity;
+    /** Human-facing message; also the target of ignore-rule message globs. */
+    message: string;
+    /** 0-indexed source line (parser rowid). */
+    line: number;
+    /** Repository the entry belongs to, when present. */
+    repository?: string;
+    /** Category-specific extra context. */
+    details?: Record<string, unknown>;
+    /** True when an active ignore rule suppressed this finding. */
+    ignored: boolean;
+}
+/** The machine-readable report (schema v1). */
+export interface DetectionReport {
+    version: 1;
+    logFile: string;
+    logMd5: string;
+    generatedAt: string;
+    exitCode: number;
+    summary: {
+        errorCount: number;
+        warningCount: number;
+    };
+    counts: Record<Category, number>;
+    findings: Finding[];
+}
+/** Options for {@link ErrorDetector.run}. */
+export interface DetectOptions {
+    /** Active ignore rules (already filtered for expiry). */
+    ignoreRules?: readonly IgnoreRule[];
+    /** When true, non-ignored warnings also force a non-zero exit code. */
+    failOnWarn?: boolean;
+}
+/**
+ * Detects problems in a loaded {@link Parser}. Construct with an already-loaded
+ * parser, then call {@link run}.
+ */
+export declare class ErrorDetector {
+    private readonly parser;
+    constructor(parser: Parser);
+    /** Run detection and build the report. */
+    run(options?: DetectOptions): DetectionReport;
+}

package/dist/core/error-detector.js

@@ -0,0 +1,236 @@
+/**
+ * ErrorDetector — scans a parsed Renovate log for build-breaking problems and
+ * (non-breaking) warnings, producing the stable machine-readable report used by
+ * the `detect-errors` command and CI.
+ *
+ * The category model is fixed: every known category is always present in
+ * `counts` (zeros included) so runs diff cleanly over time. Categories are independent — an entry that is both a
+ * `level:50` error and carries an `err` object yields two findings — with the
+ * sole exception of `repo-problem`, which is de-duplicated against overlapping
+ * `log-warn` messages.
+ *
+ * Detection walks the whole log once (all repositories); findings carry a
+ * `repository` when the source entry has one. Line numbers are 0-indexed,
+ * matching the parser's rowid == source-line invariant.
+ *
+ * The error/warning split is scoped to problems Renovate would *not* otherwise
+ * surface in a PR comment: `host-error-abort`, `log-error`, `log-fatal`,
+ * `config-migration`, and `abandoned-package` are errors (exit 1); `log-warn`,
+ * `err-object`, and `repo-problem` are warnings.
+ */
+import { ERROR_LEVELS, WARN_LEVEL } from "./levels.js";
+import { matchIgnoreRule } from "./ignore-file.js";
+import { buildQuery } from "./query-builder.js";
+/** Ordered list of every known finding category (drives the `counts` map). */
+export const CATEGORIES = [
+    "host-error-abort",
+    "log-warn",
+    "log-error",
+    "log-fatal",
+    "err-object",
+    "config-migration",
+    "abandoned-package",
+    "repo-problem",
+];
+/** Severity for each category. */
+export const SEVERITY = {
+    "host-error-abort": "error",
+    "log-warn": "warning",
+    "log-error": "error",
+    "log-fatal": "error",
+    "err-object": "warning",
+    "config-migration": "error",
+    "abandoned-package": "error",
+    "repo-problem": "warning",
+};
+/** The `msg` that marks a per-repository run summary. */
+const REPOSITORY_FINISHED_MSG = "Repository finished";
+/** The `result` on a "Repository finished" entry that signals an aborting host error. */
+const HOST_ERROR_RESULT = "external-host-error";
+/** The exact `msg` that marks a required config migration. */
+const CONFIG_MIGRATION_MSG = "Config migration necessary";
+/** The exact `msg` that carries abandoned-package statistics. */
+const ABANDONED_PACKAGE_MSG = "Abandoned package statistics";
+/**
+ * Detects problems in a loaded {@link Parser}. Construct with an already-loaded
+ * parser, then call {@link run}.
+ */
+export class ErrorDetector {
+    parser;
+    constructor(parser) {
+        this.parser = parser;
+    }
+    /** Run detection and build the report. */
+    run(options = {}) {
+        const loaded = this.parser.loaded;
+        if (!loaded) {
+            throw new Error("No log loaded. Call parser.load() before detection.");
+        }
+        // Fetch only rows that can yield a finding, instead of scanning
+        // the ENTIRE log (hogging memory). QueryBuilder AND's filters, so the disjunction
+        // of finding predicates is expressed as separate queries, merged by line.
+        const filterGroups = [
+            [{ type: "levelIn", levels: [WARN_LEVEL, ...ERROR_LEVELS] }],
+            [{ type: "presence", field: "err" }],
+            [{ type: "presence", field: "repoProblems" }],
+            [
+                {
+                    type: "inSet",
+                    field: "msg",
+                    values: [
+                        REPOSITORY_FINISHED_MSG,
+                        CONFIG_MIGRATION_MSG,
+                        ABANDONED_PACKAGE_MSG,
+                    ],
+                },
+            ],
+        ];
+        // A row can match more than one group (e.g. a level:50 entry that also
+        // carries an `err`), so dedupe by line before walking.
+        const byLine = new Map();
+        for (const filters of filterGroups) {
+            const { sql, params } = buildQuery(filters, { order: "asc" }, "line, logentry");
+            for (const { line, entry } of this.parser.queryEntries(sql, params)) {
+                byLine.set(line, entry);
+            }
+        }
+        const rows = [...byLine.entries()]
+            .sort(([a], [b]) => a - b)
+            .map(([line, entry]) => ({ line, entry }));
+        // First pass: collect every log-warn message so repo-problems that merely
+        // echo a level:40 message are not counted twice.
+        const warnLogMessages = new Set();
+        for (const { entry } of rows) {
+            if (entry.level === WARN_LEVEL && typeof entry.msg === "string") {
+                warnLogMessages.add(entry.msg);
+            }
+        }
+        const findings = [];
+        for (const { line, entry } of rows) {
+            collectFindings(entry, line, warnLogMessages, findings);
+        }
+        // Apply ignore rules.
+        const rules = options.ignoreRules ?? [];
+        for (const finding of findings) {
+            finding.ignored =
+                rules.length > 0 && matchIgnoreRule(finding, rules) !== undefined;
+        }
+        const counts = emptyCounts();
+        let errorCount = 0;
+        let warningCount = 0;
+        for (const finding of findings) {
+            counts[finding.category] += 1;
+            if (finding.ignored)
+                continue;
+            if (finding.severity === "error")
+                errorCount += 1;
+            else
+                warningCount += 1;
+        }
+        const exitCode = errorCount > 0 || (options.failOnWarn === true && warningCount > 0)
+            ? 1
+            : 0;
+        return {
+            version: 1,
+            logFile: loaded.path,
+            logMd5: loaded.md5,
+            generatedAt: new Date().toISOString(),
+            exitCode,
+            summary: { errorCount, warningCount },
+            counts,
+            findings,
+        };
+    }
+}
+/** Build a counts map with every category initialised to zero. */
+function emptyCounts() {
+    const counts = {};
+    for (const category of CATEGORIES)
+        counts[category] = 0;
+    return counts;
+}
+/** Apply every detection rule to a single entry, appending to `findings`. */
+function collectFindings(entry, line, warnLogMessages, findings) {
+    // Synthetic parser rows (blank / malformed lines) carry no signal.
+    if (entry._blank === true || entry._parseError === true)
+        return;
+    const repository = typeof entry.repository === "string" ? entry.repository : undefined;
+    const msg = typeof entry.msg === "string" ? entry.msg : "";
+    const level = typeof entry.level === "number" ? entry.level : undefined;
+    const push = (category, message, details) => {
+        findings.push({
+            category,
+            severity: SEVERITY[category],
+            message,
+            line,
+            ...(repository !== undefined ? { repository } : {}),
+            ...(details !== undefined ? { details } : {}),
+            ignored: false,
+        });
+    };
+    // host-error-abort — a "Repository finished" summary aborted by a host error.
+    if (msg === REPOSITORY_FINISHED_MSG && entry.result === HOST_ERROR_RESULT) {
+        push("host-error-abort", msg, { result: entry.result });
+    }
+    // log-error / log-fatal — by level.
+    if (level === ERROR_LEVELS[0])
+        push("log-error", msg, errDetails(entry));
+    if (level === ERROR_LEVELS[1])
+        push("log-fatal", msg, errDetails(entry));
+    // err-object — a root-level `err` object.
+    const err = entry.err;
+    if (err !== null && typeof err === "object" && !Array.isArray(err)) {
+        const errMessage = msg !== ""
+            ? msg
+            : typeof err.message === "string"
+                ? err.message
+                : "error";
+        push("err-object", errMessage, { err });
+    }
+    // config-migration — exact message plus the old/new config pair.
+    if (msg === CONFIG_MIGRATION_MSG &&
+        entry.oldConfig !== undefined &&
+        entry.newConfig !== undefined) {
+        push("config-migration", msg, { keys: ["oldConfig", "newConfig"] });
+    }
+    // abandoned-package — one finding per package, keyed as `datasource:package`.
+    // The entry carries datasource-named objects (e.g. `npm`, `crate`) mapping a
+    // package name to its last-update timestamp; string/number metadata fields are
+    // skipped by only descending into plain-object root values.
+    if (msg === ABANDONED_PACKAGE_MSG) {
+        for (const [datasource, group] of Object.entries(entry)) {
+            if (group === null || typeof group !== "object" || Array.isArray(group)) {
+                continue;
+            }
+            for (const [pkg, lastUpdated] of Object.entries(group)) {
+                push("abandoned-package", `${datasource}:${pkg}`, {
+                    datasource,
+                    package: pkg,
+                    lastUpdated,
+                });
+            }
+        }
+    }
+    // log-warn — by level.
+    if (level === WARN_LEVEL)
+        push("log-warn", msg);
+    // repo-problem — each string, de-duped against log-warn messages.
+    if (Array.isArray(entry.repoProblems)) {
+        for (const problem of entry.repoProblems) {
+            if (typeof problem !== "string")
+                continue;
+            if (warnLogMessages.has(problem))
+                continue;
+            push("repo-problem", problem, { problem });
+        }
+    }
+}
+/** Extract an `{ err }` details object when the entry carries one. */
+function errDetails(entry) {
+    const err = entry.err;
+    if (err !== null && typeof err === "object" && !Array.isArray(err)) {
+        return { err };
+    }
+    return undefined;
+}
+//# sourceMappingURL=error-detector.js.map

package/dist/core/error-detector.js.map

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

package/dist/core/filters.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Shared filter model for renovate-log-parser.
+ *
+ * All three commands (detect-errors, analyze, web) describe the same kinds of
+ * filters. They are represented here as a small, closed set of primitives that
+ * the {@link QueryBuilder} translates into parameterized SQL. Filters are always
+ * AND'd together.
+ *
+ * Design decisions:
+ *  - Only root-level JSON keys are addressable in v1 (`$.<key>`), though the
+ *    helpers below already build JSON paths so nested support is a non-breaking
+ *    extension later.
+ *  - `equals` matches scalar (string/number/boolean) values only. Against a
+ *    non-scalar value it simply does not match.
+ *  - `like` is a simple, case-insensitive wildcard match on a single field
+ *    where `*` (and only `*`) is a wildcard. It is translated to a SQLite
+ *    `LIKE ... ESCAPE` comparison (see {@link globStarToLike}).
+ */
+/** Root-level JSON key name (e.g. `repository`, `err`, `msg`). */
+export type FieldName = string;
+/** Scalar values usable in an `equals` filter. */
+export type ScalarValue = string | number | boolean;
+/** Match log entries where a root-level `field` equals a scalar `value`. */
+export interface EqualsFilter {
+    type: "equals";
+    field: FieldName;
+    value: ScalarValue;
+    /** When true, matches entries that do NOT equal the value. */
+    negate?: boolean;
+}
+/** Match log entries where a root-level `field` is present (non-null). */
+export interface PresenceFilter {
+    type: "presence";
+    field: FieldName;
+    /** When true, matches entries where the field is absent. */
+    negate?: boolean;
+}
+/** Match log entries whose `level` is in (or, when negated, not in) the set. */
+export interface LevelFilter {
+    type: "levelIn";
+    levels: number[];
+    negate?: boolean;
+}
+/**
+ * Case-insensitive wildcard match on a single root-level `field`, where `*`
+ * (and only `*`) is a wildcard. Translated to a SQLite `LIKE ... ESCAPE`
+ * comparison by the {@link QueryBuilder}. The `pattern` is the raw user glob;
+ * {@link globStarToLike} performs the escaping/translation at build time.
+ */
+export interface LikeFilter {
+    type: "like";
+    field: FieldName;
+    /** Raw user pattern where `*` matches any run of characters. */
+    pattern: string;
+    /** When true, matches entries that do NOT match the pattern. */
+    negate?: boolean;
+}
+/**
+ * Case-insensitive wildcard match against the **entire raw log line** (the
+ * whole `logentry` JSON text), where `*` (and only `*`) is a wildcard. This is
+ * the "raw search" the web UI exposes: the user's term is looked for anywhere in
+ * the serialized line — in any key or any value — without targeting a field.
+ * Translated to a SQLite `LIKE ... ESCAPE` on the `logentry` column by the
+ * {@link QueryBuilder}; `*`-to-`%` translation/escaping happens in
+ * {@link globStarToLike}.
+ */
+export interface RawFilter {
+    type: "raw";
+    /** Raw user pattern where `*` matches any run of characters. */
+    pattern: string;
+    /** When true, matches entries whose line does NOT match the pattern. */
+    negate?: boolean;
+}
+/**
+ * Match log entries whose root-level `field` is one of a set of scalar values.
+ *
+ * This is the generic, arbitrary-field analogue of {@link LevelFilter} and is
+ * primarily used by the web layer to translate a repository include/exclude
+ * selection (potentially many values, which needs OR semantics the AND'd
+ * {@link EqualsFilter}s cannot express) into a single filter. `includeNull`
+ * additionally matches entries where the field is absent (used for the web's
+ * "Repository-independent" pseudo-group). All null handling is explicit so the
+ * negated form stays predictable (see the {@link QueryBuilder} for the emitted
+ * SQL).
+ */
+export interface InSetFilter {
+    type: "inSet";
+    field: FieldName;
+    values: ScalarValue[];
+    /** When true, also match entries where the field is null/absent. */
+    includeNull?: boolean;
+    /** When true, matches entries NOT covered by the (value set + null) match. */
+    negate?: boolean;
+}
+/** Any supported filter. All filters in a query are AND'd. */
+export type Filter = EqualsFilter | PresenceFilter | LevelFilter | LikeFilter | RawFilter | InSetFilter;
+/**
+ * Build a SQLite JSON path for a root-level key.
+ *
+ * Uses `$."key"` quoting so keys containing dots, spaces or reserved characters
+ * (common in Renovate logs, e.g. datasource URLs used as keys) are handled
+ * safely. Embedded double quotes are escaped per the JSON path grammar.
+ */
+export declare function jsonPath(field: FieldName): string;
+/** SQL expression that extracts a root-level key from the `logentry` column. */
+export declare function extractExpr(field: FieldName, column?: string): string;
+/** Parse a `key:val` CLI filter token into an {@link EqualsFilter}. */
+export declare function parseKeyValueFilter(token: string): EqualsFilter;
+/**
+ * Parse a `key:pattern` CLI token into a {@link LikeFilter}, where `*` in the
+ * pattern is a wildcard (matching is case-insensitive; see {@link globStarToLike}).
+ */
+export declare function parseWildcardFilter(token: string): LikeFilter;
+/**
+ * Translate a simple `*`-only user glob into a SQLite `LIKE` pattern.
+ *
+ * `LIKE`'s own metacharacters (`%`, `_`) and the escape character (`\`) are
+ * escaped so they match literally; then `*` is mapped to `%` (any run of
+ * characters). The resulting pattern must be used with `ESCAPE '\'`. Matching
+ * is anchored exactly as written — a leading/trailing `*` is required for
+ * prefix/suffix/contains behaviour.
+ */
+export declare function globStarToLike(pattern: string): string;
+/**
+ * Coerce a raw CLI string value to its scalar type so `equals` filters compare
+ * against the correctly-typed JSON value.
+ *
+ * Renovate stores many root fields as numbers (`level`, `pid`, `v`) or booleans,
+ * and SQLite never treats a numeric value as equal to a text value — so without
+ * this, `--filter level:30` would compare `30 = '30'` and never match.
+ *
+ * Coercion is deliberately conservative: only `true`/`false` and strict numeric
+ * literals are converted. Leading-zero (`007`) and dotted/version-like (`1.2.3`)
+ * values stay strings, since those are meaningful string identifiers.
+ */
+export declare function coerceScalar(value: string): ScalarValue;