renovate-log-parser 0.1.0

package/dist/core/query-builder.js

@@ -0,0 +1,155 @@
+/**
+ * QueryBuilder — translates the shared {@link Filter} model into a single
+ * parameterized SQL SELECT against the parser's `logs` table.
+ *
+ * All filters are AND'd. WHERE
+ * fragments reuse the exact `json_extract(...)` expressions that the parser
+ * indexes, so the query planner can use those expression indices.
+ *
+ * The builder never interpolates user values into SQL text; every value is a
+ * bound parameter. Wildcard (`like`) filters compare a single field with a
+ * case-insensitive SQLite `LIKE ... ESCAPE`; the `*`-to-`%` translation
+ * and escaping happen in {@link globStarToLike}.
+ */
+import { extractExpr, globStarToLike, } from "./filters.js";
+const TABLE = "logs";
+const COLUMN = "logentry";
+const LEVEL_EXPR = extractExpr("level", COLUMN);
+/** Convert a scalar filter value to a bound SQL parameter. */
+function scalarParam(value) {
+    if (typeof value === "boolean")
+        return value ? 1 : 0;
+    return value;
+}
+/** Build the WHERE fragment + params for a single filter. */
+function buildFilter(filter) {
+    switch (filter.type) {
+        case "equals": {
+            const expr = extractExpr(filter.field, COLUMN);
+            const param = scalarParam(filter.value);
+            // Negation is null-safe: entries missing the field are kept when hiding a
+            // specific value (they clearly are not that value).
+            const sql = filter.negate
+                ? `(${expr} IS NULL OR ${expr} <> ?)`
+                : `${expr} = ?`;
+            return { sql, params: [param] };
+        }
+        case "presence": {
+            const expr = extractExpr(filter.field, COLUMN);
+            const sql = filter.negate ? `${expr} IS NULL` : `${expr} IS NOT NULL`;
+            return { sql, params: [] };
+        }
+        case "levelIn": {
+            if (filter.levels.length === 0) {
+                // An empty set matches nothing (or, negated, everything).
+                return { sql: filter.negate ? "1=1" : "1=0", params: [] };
+            }
+            const placeholders = filter.levels.map(() => "?").join(", ");
+            const params = filter.levels.map((l) => l);
+            const sql = filter.negate
+                ? `(${LEVEL_EXPR} IS NULL OR ${LEVEL_EXPR} NOT IN (${placeholders}))`
+                : `${LEVEL_EXPR} IN (${placeholders})`;
+            return { sql, params };
+        }
+        case "inSet": {
+            const expr = extractExpr(filter.field, COLUMN);
+            if (filter.values.length === 0) {
+                // No values: with includeNull it reduces to a presence check; without,
+                // it matches nothing (or, negated, everything). Kept null-safe.
+                if (filter.includeNull) {
+                    const sql = filter.negate ? `${expr} IS NOT NULL` : `${expr} IS NULL`;
+                    return { sql, params: [] };
+                }
+                return { sql: filter.negate ? "1=1" : "1=0", params: [] };
+            }
+            const placeholders = filter.values.map(() => "?").join(", ");
+            const params = filter.values.map(scalarParam);
+            let sql;
+            if (filter.negate) {
+                // Negation is null-safe. With includeNull the positive match also
+                // covered nulls, so the negation must exclude them; otherwise nulls are
+                // kept (they clearly are not in the value set).
+                sql = filter.includeNull
+                    ? `(${expr} IS NOT NULL AND ${expr} NOT IN (${placeholders}))`
+                    : `(${expr} IS NULL OR ${expr} NOT IN (${placeholders}))`;
+            }
+            else {
+                sql = filter.includeNull
+                    ? `(${expr} IN (${placeholders}) OR ${expr} IS NULL)`
+                    : `${expr} IN (${placeholders})`;
+            }
+            return { sql, params };
+        }
+        case "like": {
+            // Case-insensitive wildcard match on one field. CAST to TEXT so numeric/
+            // boolean fields are still comparable; `\` escapes LIKE metacharacters.
+            const expr = extractExpr(filter.field, COLUMN);
+            const text = `CAST(${expr} AS TEXT)`;
+            const param = globStarToLike(filter.pattern);
+            // Negation is null-safe: entries missing the field are kept when hiding a
+            // pattern (they clearly do not match it).
+            const sql = filter.negate
+                ? `(${expr} IS NULL OR ${text} NOT LIKE ? ESCAPE '\\')`
+                : `${text} LIKE ? ESCAPE '\\'`;
+            return { sql, params: [param] };
+        }
+        case "raw": {
+            // Case-insensitive wildcard match against the whole line (the `logentry`
+            // JSON text). `logentry` is NOT NULL so no null-safety is needed.
+            const param = globStarToLike(filter.pattern);
+            const sql = filter.negate
+                ? `${COLUMN} NOT LIKE ? ESCAPE '\\'`
+                : `${COLUMN} LIKE ? ESCAPE '\\'`;
+            return { sql, params: [param] };
+        }
+    }
+}
+/**
+ * Build a parameterized SELECT for the given filters and options.
+ *
+ * @param filters Row-matching filters, AND'd together.
+ * @param options Line range, ordering, and pagination.
+ * @param columns SELECT list. Defaults to `rowid, logentry`.
+ */
+export function buildQuery(filters = [], options = {}, columns = `rowid, ${COLUMN}`) {
+    const clauses = [];
+    const params = [];
+    for (const filter of filters) {
+        const built = buildFilter(filter);
+        clauses.push(built.sql);
+        params.push(...built.params);
+    }
+    if (options.lineFrom !== undefined) {
+        clauses.push("rowid >= ?");
+        params.push(options.lineFrom);
+    }
+    if (options.lineTo !== undefined) {
+        clauses.push("rowid <= ?");
+        params.push(options.lineTo);
+    }
+    let sql = `SELECT ${columns} FROM ${TABLE}`;
+    if (clauses.length > 0) {
+        sql += ` WHERE ${clauses.join(" AND ")}`;
+    }
+    sql += ` ORDER BY rowid ${options.order === "desc" ? "DESC" : "ASC"}`;
+    if (options.limit !== undefined) {
+        sql += " LIMIT ?";
+        params.push(options.limit);
+        if (options.offset !== undefined) {
+            sql += " OFFSET ?";
+            params.push(options.offset);
+        }
+    }
+    return { sql, params };
+}
+/**
+ * Build a `SELECT COUNT(*)` for the given filters (ignores pagination/order),
+ * used by the web `total` count.
+ */
+export function buildCountQuery(filters = [], options = {}) {
+    const built = buildQuery(filters, options, "COUNT(*) AS n");
+    // Strip the trailing ORDER BY (harmless but pointless for a count).
+    built.sql = built.sql.replace(/ ORDER BY rowid (ASC|DESC)$/, "");
+    return built;
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/core/query-builder.js.map

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

package/dist/core/skill-template.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Skill-template builder — the single source of truth for the
+ * `renovate-log-analyzer` SKILL.md that the `install-analyze-skill` command
+ * writes into a project (or the user's home).
+ *
+ * {@link buildSkillMarkdown} is a pure, dependency-free function so it can be
+ * unit-tested in isolation and reused anywhere the skill text is needed. The
+ * optional GitHub (`gh`) fetch section is emitted only when {@link GhConfig} is
+ * provided; a base URL, when given, is threaded onto the `gh` commands as a
+ * `GH_HOST=<host>` prefix (the standard way to target a GitHub Enterprise host).
+ */
+/** GitHub log-fetch configuration embedded into the skill's `gh` section. */
+export interface GhConfig {
+    /** Optional GitHub (Enterprise) host, e.g. `github.example.com`. */
+    baseUrl?: string;
+    /** GitHub organization / owner that hosts the repository. */
+    org: string;
+    /** Repository name (without the owner). */
+    repo: string;
+    /** Filename of the workflow that runs Renovate, e.g. `renovate.yml`. */
+    workflow: string;
+}
+/** Options controlling the generated skill markdown. */
+export interface SkillTemplateOptions {
+    /** When set, include the "Fetch logs from GitHub" section. */
+    gh?: GhConfig;
+}
+/**
+ * Build the full `renovate-log-analyzer` SKILL.md text.
+ *
+ * The output is deterministic for a given {@link SkillTemplateOptions}, ending
+ * with a single trailing newline.
+ */
+export declare function buildSkillMarkdown(options?: SkillTemplateOptions): string;

package/dist/core/skill-template.js

@@ -0,0 +1,259 @@
+/**
+ * Skill-template builder — the single source of truth for the
+ * `renovate-log-analyzer` SKILL.md that the `install-analyze-skill` command
+ * writes into a project (or the user's home).
+ *
+ * {@link buildSkillMarkdown} is a pure, dependency-free function so it can be
+ * unit-tested in isolation and reused anywhere the skill text is needed. The
+ * optional GitHub (`gh`) fetch section is emitted only when {@link GhConfig} is
+ * provided; a base URL, when given, is threaded onto the `gh` commands as a
+ * `GH_HOST=<host>` prefix (the standard way to target a GitHub Enterprise host).
+ */
+/** The skill's frontmatter description (kept in sync with its purpose). */
+const DESCRIPTION = "Analyze Renovate Bot debug logs (JSONL, produced via the LOG_FILE env " +
+    "var) token-efficiently. Use when diagnosing why Renovate did or did not " +
+    "do something, investigating dependency-dashboard problems, or reading a " +
+    "large Renovate log without exhausting the context window.";
+/**
+ * Build the full `renovate-log-analyzer` SKILL.md text.
+ *
+ * The output is deterministic for a given {@link SkillTemplateOptions}, ending
+ * with a single trailing newline.
+ */
+export function buildSkillMarkdown(options = {}) {
+    const sections = [
+        frontmatter(),
+        heading(),
+        coreLoop(),
+        quickStart(),
+        logLevels(),
+        statsFields(),
+        zeroIndexNote(),
+        printMode(),
+        workflow(),
+        detectErrors(),
+    ];
+    if (options.gh)
+        sections.push(githubFetch(options.gh));
+    sections.push(tips());
+    return sections.join("\n").replace(/\n+$/, "") + "\n";
+}
+/** YAML frontmatter block. */
+function frontmatter() {
+    return `---
+name: renovate-log-analyzer
+description: ${DESCRIPTION}
+license: MIT
+---
+`;
+}
+function heading() {
+    return `# Renovate log analyzer
+
+You are analyzing a **Renovate Bot debug log**: a JSONL file (one JSON object
+per line) produced by self-hosted Renovate when run with the \`LOG_FILE\`
+environment variable set, or downloaded from the Mend hosted app. These logs are
+large (thousands of mostly \`debug\`-level lines) and the useful signal is
+usually buried in \`debug\` entries, not \`warn\`/\`error\` ones.
+
+Never open the raw log file directly — it will blow your context window. Instead
+use the \`renovate-log-parser analyze\` command, which gives you a compact map of
+the log first, then lets you print only the exact line ranges you need.
+`;
+}
+function coreLoop() {
+    return `## The core loop (do this every time)
+
+1. **Stats** — get the whole-log map (cheap, one small JSON object):
+   \`\`\`bash
+   npx --yes renovate-log-parser analyze <path-to-log.jsonl>
+   \`\`\`
+2. **Pick lines** — from the stats, choose the repository and the interesting
+   line range or key entries (\`branchesInformationLine\`, \`packageFilesLine\`,
+   the repo's \`fromLine\`..\`toLine\`, etc.).
+3. **Print** — read only that slice as JSONL, narrowed with filters:
+   \`\`\`bash
+   npx --yes renovate-log-parser analyze <path-to-log.jsonl> --print \\
+     --line-from <N> --line-to <M> --filter <key:value> --limit <K>
+   \`\`\`
+
+Repeat 2–3, tightening the range and filters, until you've answered the
+question. This keeps token use proportional to what you actually read, not to
+the size of the log.
+`;
+}
+function quickStart() {
+    return `## Quick start
+
+\`\`\`bash
+# Whole-log map: level counts + per-repository structure
+npx --yes renovate-log-parser analyze renovate.jsonl
+
+# Read a single key entry (e.g. the per-branch summary at line 1132)
+npx --yes renovate-log-parser analyze renovate.jsonl --print \\
+  --line-from 1132 --line-to 1132 --limit 1
+
+# Read one repo's range, keeping only npm-manager entries, first 20 matches
+npx --yes renovate-log-parser analyze renovate.jsonl --print \\
+  --line-from 37 --line-to 1146 --filter manager:npm --limit 20
+
+# Find every entry whose msg starts with "Found match" (case-insensitive)
+npx --yes renovate-log-parser analyze renovate.jsonl --print \\
+  --filter-with-wildcard "msg:Found match*"
+\`\`\`
+`;
+}
+function logLevels() {
+    return `## Log levels (the numbers in \`level\` and \`levelCounts\`)
+
+Renovate uses Bunyan numeric levels. The stats \`levelCounts\` map is keyed by
+these numbers:
+
+| \`level\` | Name  | Notes                                              |
+| ------- | ----- | -------------------------------------------------- |
+| \`10\`    | trace | very verbose                                       |
+| \`20\`    | debug | the bulk of the log — most diagnostic signal here  |
+| \`30\`    | info  | normal progress                                    |
+| \`40\`    | warn  | warnings (also surfaced in \`repoProblems\`)          |
+| \`50\`    | error | errors                                             |
+| \`60\`    | fatal | fatal errors                                       |
+
+Do not stop at \`warn\`/\`error\`. Renovate frequently records *why* it made a
+decision only at \`debug\` (\`20\`). Filter to a level with \`--filter level:20\`
+(the value is auto-typed to the number).
+`;
+}
+function statsFields() {
+    return `## Reading the stats output
+
+Stats mode prints one compact single-line JSON object:
+
+- \`logFile\`, \`md5\`, \`totalLines\` — identity and size of the log.
+- \`levelCounts\` — number of entries per numeric \`level\` (see the table above).
+- \`repos\` — one object per repository Renovate processed, in order of first
+  appearance. Each has:
+
+| Field                     | Meaning                                                                                                                                                                             |
+| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| \`name\`                    | The \`repository\` value (\`owner/repo\`).                                                                                                                                             |
+| \`fromLine\` / \`toLine\`     | First / last line for this repo — **0-indexed**. Feed straight into \`--line-from\`/\`--line-to\`.                                                                                     |
+| \`branches\`                | Unique \`renovate/*\` branch names seen for this repo.                                                                                                                               |
+| \`branchesInformationLine\` | 0-indexed line of the \`branches info extended\` entry (or \`null\`). This **one** line summarizes every branch: PR number, PR title, \`result\` (e.g. \`pr-created\`), and \`upgrades\`. Read it first to see what Renovate actually did per branch. |
+| \`packageFilesLine\`        | 0-indexed line of the \`packageFiles with updates\` entry (or \`null\`). Carries the detected dependency/update inventory grouped by manager (npm, docker, nuget, github-actions, …). Read it to see what updates Renovate found. |
+| \`repoProblems\`            | The warning strings Renovate posts to the repo's **Dependency Dashboard** issue (e.g. ignored custom registries, unicode warnings). These are the subtle problems that often go unnoticed — inspect them.                       |
+| \`depNames\`                | Dependency names seen (root-level \`depName\` unioned with the \`packageFiles\` config).                                                                                              |
+| \`packageNames\`            | Package names seen (root-level \`packageName\` unioned with the \`packageFiles\` config).                                                                                             |
+
+If \`branchesInformationLine\` or \`packageFilesLine\` is \`null\`, that entry was not
+emitted for the repo (often a sign Renovate bailed early — check \`repoProblems\`
+and the repo's line range for errors).
+`;
+}
+function zeroIndexNote() {
+    return `## Line numbers are 0-indexed
+
+Every line reference is **0-indexed** and they all agree with each other:
+\`fromLine\`, \`toLine\`, \`branchesInformationLine\`, \`packageFilesLine\`, the
+\`--line-from\` / \`--line-to\` bounds (both inclusive), and the \`_oL\` field added
+by \`--include-original-line\`. So a \`branchesInformationLine\` of \`1132\` is read
+with \`--line-from 1132 --line-to 1132\`.
+`;
+}
+function printMode() {
+    return `## Print mode reference
+
+\`--print\` streams matching entries as JSONL to stdout (one object per line).
+Rows are selected in the order: **line range → filters → limit** (first N in
+line order). A truncation notice (when \`--limit\` caps the result) is written to
+**stderr**, so stdout stays a clean, pipeable JSONL stream.
+
+| Option                     | Effect                                                                                                                        |
+| -------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| \`--line-from\` / \`--line-to\` | Inclusive 0-indexed line bounds.                                                                                            |
+| \`--filter key:value\`        | Exact match on a root-level key. Repeatable, AND'd. Value is **auto-typed**: \`level:30\` matches the number \`30\`, \`true\`/\`false\` become booleans; \`007\` / \`1.2.3\` stay strings. |
+| \`--filter-with-wildcard key:pat\` | Case-insensitive wildcard match where \`*\` = any run of characters (only \`*\` is special). Anchored as written — use leading/trailing \`*\` for contains, e.g. \`msg:*lock file*\`. Repeatable, AND'd. |
+| \`--limit N\`                 | Max lines to print (default \`50\`).                                                                                          |
+| \`--ignored-fields csv\`      | Root keys to strip from output (default \`v,time,logContext,pid,hostname,name\`; \`msg\` is never stripped).                     |
+| \`--include-original-line\`   | Add \`_oL\` (the 0-indexed source line) to each printed object — handy to pinpoint an entry for a follow-up query.            |
+
+Useful root keys to filter on: \`level\`, \`repository\`, \`branch\`, \`manager\`,
+\`depName\`, \`packageName\`, \`msg\`, \`err\`.
+`;
+}
+function workflow() {
+    return `## Suggested investigation workflow
+
+1. Run **stats**. Note \`totalLines\`, \`levelCounts\`, and each repo's range.
+2. For the repo in question, print its \`branchesInformationLine\` — this tells
+   you the outcome for every branch/PR in one line.
+3. Print its \`repoProblems\` context and any \`level:40\`/\`50\`/\`60\` lines within
+   the repo's range to catch surfaced issues.
+4. To understand a specific decision ("why no PR for X?"), filter within the
+   repo range by \`depName\`/\`packageName\` and read the surrounding \`debug\`
+   (\`level:20\`) lines — that is where Renovate explains itself.
+5. Use \`--include-original-line\` to get \`_oL\`, then zoom into a tiny
+   \`--line-from\`/\`--line-to\` window around it for full context.
+`;
+}
+function detectErrors() {
+    return `## Tip: deterministic first pass
+
+For a quick, deterministic scan of build-breaking problems and warnings before
+manual analysis, run:
+
+\`\`\`bash
+npx --yes renovate-log-parser detect-errors <path-to-log.jsonl>
+\`\`\`
+
+It surfaces host-error aborts, config migrations, abandoned packages, \`err\`
+objects, and \`repoProblems\` — a good starting list of what to investigate with
+\`analyze\`.
+`;
+}
+/**
+ * The optional GitHub-fetch section. When {@link GhConfig.baseUrl} is set, every
+ * `gh` command is prefixed with `GH_HOST=<host>` to target a GHES host.
+ */
+function githubFetch(gh) {
+    const host = gh.baseUrl?.trim();
+    const prefix = host ? `GH_HOST=${host} ` : "";
+    const repoRef = `${gh.org}/${gh.repo}`;
+    const hostNote = host
+        ? `This repository is hosted on GitHub Enterprise at \`${host}\`, so every ` +
+            `\`gh\` command is prefixed with \`GH_HOST=${host}\` (ensure you have run ` +
+            `\`gh auth login --hostname ${host}\` once).`
+        : `Ensure you are authenticated with \`gh auth status\`.`;
+    return `## Fetch the log from GitHub (via \`gh\`)
+
+The Renovate log for \`${repoRef}\` is produced by the \`${gh.workflow}\` GitHub
+Actions workflow, which uploads it as a build artifact. ${hostNote}
+
+1. Find recent Renovate runs:
+   \`\`\`bash
+   ${prefix}gh run list --workflow ${gh.workflow} -R ${repoRef} --limit 10
+   \`\`\`
+2. Download the artifact(s) from the run you want (use the run ID from step 1):
+   \`\`\`bash
+   ${prefix}gh run download <run-id> -R ${repoRef} --dir ./renovate-log
+   \`\`\`
+   Omit \`-n <artifact-name>\` to download all artifacts; add it to fetch a
+   specific one if the run publishes several. List a run's artifacts with
+   \`${prefix}gh run view <run-id> -R ${repoRef}\`.
+3. Locate the JSONL log inside \`./renovate-log\` and analyze it with the core
+   loop above:
+   \`\`\`bash
+   npx --yes renovate-log-parser analyze ./renovate-log/<log-file>.jsonl
+   \`\`\`
+`;
+}
+function tips() {
+    return `## Reminders
+
+- Always start with stats; never \`cat\`/read the whole log.
+- Most answers live in \`debug\` (\`level:20\`) lines — don't ignore them.
+- All line numbers are 0-indexed and inclusive.
+- Keep \`--limit\` small and widen only when needed; truncation is reported on
+  stderr.
+`;
+}
+//# sourceMappingURL=skill-template.js.map

package/dist/core/skill-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-template.js","sourceRoot":"","sources":["../../src/core/skill-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoBH,2EAA2E;AAC3E,MAAM,WAAW,GACf,wEAAwE;IACxE,0EAA0E;IAC1E,0EAA0E;IAC1E,2DAA2D,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAgC,EAAE;IACnE,MAAM,QAAQ,GAAa;QACzB,WAAW,EAAE;QACb,OAAO,EAAE;QACT,QAAQ,EAAE;QACV,UAAU,EAAE;QACZ,SAAS,EAAE;QACX,WAAW,EAAE;QACb,aAAa,EAAE;QACf,SAAS,EAAE;QACX,QAAQ,EAAE;QACV,YAAY,EAAE;KACf,CAAC;IAEF,IAAI,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAEvD,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtB,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;AACxD,CAAC;AAED,8BAA8B;AAC9B,SAAS,WAAW;IAClB,OAAO;;eAEM,WAAW;;;CAGzB,CAAC;AACF,CAAC;AAED,SAAS,OAAO;IACd,OAAO;;;;;;;;;;;CAWR,CAAC;AACF,CAAC;AAED,SAAS,QAAQ;IACf,OAAO;;;;;;;;;;;;;;;;;;CAkBR,CAAC;AACF,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;;;;;;;;;;;;;;;;;;CAkBR,CAAC;AACF,CAAC;AAED,SAAS,SAAS;IAChB,OAAO;;;;;;;;;;;;;;;;;CAiBR,CAAC;AACF,CAAC;AAED,SAAS,WAAW;IAClB,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBR,CAAC;AACF,CAAC;AAED,SAAS,aAAa;IACpB,OAAO;;;;;;;CAOR,CAAC;AACF,CAAC;AAED,SAAS,SAAS;IAChB,OAAO;;;;;;;;;;;;;;;;;;CAkBR,CAAC;AACF,CAAC;AAED,SAAS,QAAQ;IACf,OAAO;;;;;;;;;;;;CAYR,CAAC;AACF,CAAC;AAED,SAAS,YAAY;IACnB,OAAO;;;;;;;;;;;;CAYR,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,EAAY;IAC/B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI;QACnB,CAAC,CAAC,uDAAuD,IAAI,eAAe;YAC1E,6CAA6C,IAAI,0BAA0B;YAC3E,8BAA8B,IAAI,WAAW;QAC/C,CAAC,CAAC,uDAAuD,CAAC;IAE5D,OAAO;;yBAEgB,OAAO,2BAA2B,EAAE,CAAC,QAAQ;0DACZ,QAAQ;;;;KAI7D,MAAM,0BAA0B,EAAE,CAAC,QAAQ,OAAO,OAAO;;;;KAIzD,MAAM,+BAA+B,OAAO;;;;OAI1C,MAAM,2BAA2B,OAAO;;;;;;CAM9C,CAAC;AACF,CAAC;AAED,SAAS,IAAI;IACX,OAAO;;;;;;;CAOR,CAAC;AACF,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "renovate-log-parser",
+  "version": "0.1.0",
+  "description": "A CLI that parses Renovate Bot debug logs to auto-detect issues, with an optional Nuxt-based web UI.",
+  "type": "module",
+  "bin": {
+    "renovate-log-parser": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "web/.output"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "workspaces": [
+    "web"
+  ],
+  "scripts": {
+    "build": "npm run build:web && npm run build:cli",
+    "build:cli": "tsc -p tsconfig.build.json",
+    "build:web": "npm run build --workspace web && node scripts/deref-output-symlinks.mjs",
+    "dev:cli": "tsx src/cli.ts",
+    "dev:web": "npm run dev --workspace web",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint . && npm run lint --workspace web",
+    "start": "node dist/cli.js",
+    "test": "node --import tsx --test --test-concurrency=1 \"src/**/*.test.ts\"",
+    "test:fixtures": "node --import tsx --test --test-concurrency=1 src/core/__tests__/fixtures.test.ts",
+    "test:e2e": "node --import tsx --test --test-concurrency=1 \"e2e/**/*.e2e.ts\"",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MShekow/renovate-log-parser.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MShekow/renovate-log-parser/issues"
+  },
+  "homepage": "https://github.com/MShekow/renovate-log-parser#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "renovate",
+    "logs",
+    "parser",
+    "cli"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "yargs": "18.1.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "@types/node": "26.1.1",
+    "@types/yargs": "17.0.35",
+    "eslint": "10.8.0",
+    "eslint-config-prettier": "10.1.8",
+    "globals": "17.7.0",
+    "playwright-core": "1.62.0",
+    "prettier": "3.9.6",
+    "tsx": "4.23.1",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.65.0"
+  }
+}

package/web/.output/nitro.json

@@ -0,0 +1,15 @@
+{
+  "date": "2026-07-29T16:05:27.052Z",
+  "preset": "node-server",
+  "framework": {
+    "name": "nuxt",
+    "version": "4.4.8"
+  },
+  "versions": {
+    "nitro": "2.13.4"
+  },
+  "commands": {
+    "preview": "node server/index.mjs"
+  },
+  "config": {}
+}