renovate-log-parser 0.1.0

package/dist/commands/detect-errors.js

@@ -0,0 +1,119 @@
+import { resolve, isAbsolute } from "node:path";
+import { writeFileSync } from "node:fs";
+import { Parser } from "../core/parser.js";
+import { ErrorDetector, SEVERITY, } from "../core/error-detector.js";
+import { loadIgnoreRules, DEFAULT_IGNORE_FILE } from "../core/ignore-file.js";
+/**
+ * `detect-errors <path>` — deterministically scan a Renovate JSONL log for
+ * build-breaking problems (exit 1) and warnings, optionally writing a stable
+ * machine-readable JSON report.
+ *
+ * Exit codes: 0 = no non-ignored errors; 1 = ≥1 non-ignored error (or, with
+ * `--fail-on-warn`, ≥1 non-ignored warning); 2 = tool/usage error.
+ */
+export const detectErrorsCommand = {
+    command: "detect-errors <path>",
+    describe: "Detect hidden problems in a Renovate log (CI-friendly)",
+    builder: (yargs) => yargs
+        .positional("path", {
+        type: "string",
+        describe: "Path to the Renovate JSONL log",
+        demandOption: true,
+    })
+        .option("out", {
+        type: "string",
+        describe: "Also write the machine-readable JSON report to this path",
+    })
+        .option("ignore-file", {
+        type: "string",
+        describe: `Ignore-rules file (default: ./${DEFAULT_IGNORE_FILE})`,
+    })
+        .option("fail-on-warn", {
+        type: "boolean",
+        default: false,
+        describe: "Make warning findings affect the exit code",
+    }),
+    handler: (argv) => {
+        const parser = new Parser();
+        try {
+            const logPath = resolve(process.cwd(), argv.path);
+            const ignorePathArg = argv["ignore-file"];
+            const explicitIgnore = ignorePathArg !== undefined;
+            const ignorePath = explicitIgnore
+                ? isAbsolute(ignorePathArg)
+                    ? ignorePathArg
+                    : resolve(process.cwd(), ignorePathArg)
+                : resolve(process.cwd(), DEFAULT_IGNORE_FILE);
+            const ignoreRules = loadIgnoreRules(ignorePath, {
+                explicit: explicitIgnore,
+            });
+            parser.load(logPath);
+            const report = new ErrorDetector(parser).run({
+                ignoreRules,
+                failOnWarn: argv["fail-on-warn"],
+            });
+            if (argv.out) {
+                const outPath = isAbsolute(argv.out)
+                    ? argv.out
+                    : resolve(process.cwd(), argv.out);
+                writeFileSync(outPath, JSON.stringify(report, null, 2) + "\n");
+            }
+            process.stdout.write(renderHumanSummary(report));
+            process.exitCode = report.exitCode;
+        }
+        catch (err) {
+            // Tool/usage error (bad path, unreadable, malformed ignore file, …).
+            console.error(`detect-errors: ${err.message}`);
+            process.exitCode = 2;
+        }
+        finally {
+            parser.close();
+        }
+    },
+};
+/** Format a finding as a single human-readable line. */
+function formatFinding(finding) {
+    const location = finding.repository !== undefined
+        ? `line ${finding.line}, ${finding.repository}`
+        : `line ${finding.line}`;
+    return `  [${finding.category}] ${finding.message} (${location})`;
+}
+/**
+ * Render the human summary for stdout: findings grouped by severity, with
+ * ignored findings under their own section. Ignored findings are excluded from
+ * the headline counts.
+ */
+function renderHumanSummary(report) {
+    const lines = [];
+    lines.push(`Renovate log: ${report.logFile}`);
+    const { errorCount, warningCount } = report.summary;
+    lines.push(`${plural(errorCount, "error")}, ${plural(warningCount, "warning")}`);
+    const active = report.findings.filter((f) => !f.ignored);
+    const errors = active.filter((f) => SEVERITY[f.category] === "error");
+    const warnings = active.filter((f) => SEVERITY[f.category] === "warning");
+    const ignored = report.findings.filter((f) => f.ignored);
+    if (errors.length > 0) {
+        lines.push("", "Errors:");
+        for (const f of errors)
+            lines.push(formatFinding(f));
+    }
+    if (warnings.length > 0) {
+        lines.push("", "Warnings:");
+        for (const f of warnings)
+            lines.push(formatFinding(f));
+    }
+    if (ignored.length > 0) {
+        lines.push("", `Ignored (${ignored.length}):`);
+        for (const f of ignored)
+            lines.push(formatFinding(f));
+    }
+    if (errors.length === 0 && warnings.length === 0) {
+        lines.push("", "No problems detected.");
+    }
+    return lines.join("\n") + "\n";
+}
+/** Pluralise a count/noun pair. */
+function plural(count, noun) {
+    return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+//# sourceMappingURL=detect-errors.js.map

package/dist/commands/detect-errors.js.map

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

package/dist/commands/install-analyze-skill.d.ts

@@ -0,0 +1,27 @@
+import type { CommandModule } from "yargs";
+interface InstallSkillArgs {
+    scope?: string;
+    "with-gh"?: boolean;
+    "gh-base-url"?: string;
+    "gh-org"?: string;
+    "gh-repo"?: string;
+    "gh-workflow"?: string;
+    yes: boolean;
+}
+/**
+ * `install-analyze-skill` — write (or update) the `renovate-log-analyzer`
+ * SKILL.md that teaches an AI coding agent to analyze Renovate logs with the
+ * `analyze` command.
+ *
+ * Answers come from flags when provided; otherwise the command prompts
+ * interactively on a TTY. With `--yes` (or on a non-TTY) prompts are skipped and
+ * missing required answers are an error.
+ *
+ * The skill is written to `<root>/.agents/skills/renovate-log-analyzer/SKILL.md`
+ * where `<root>` is the current working directory (local) or the user's home
+ * directory (global).
+ *
+ * Exit codes: 0 = success; 2 = tool/usage error (missing required answer, IO).
+ */
+export declare const installAnalyzeSkillCommand: CommandModule<object, InstallSkillArgs>;
+export {};

package/dist/commands/install-analyze-skill.js

@@ -0,0 +1,181 @@
+import { homedir } from "node:os";
+import { resolve, join } from "node:path";
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { buildSkillMarkdown } from "../core/skill-template.js";
+/** Where the skill is written, relative to the chosen root. */
+const SKILL_SUBPATH = join(".agents", "skills", "renovate-log-analyzer");
+const SKILL_FILENAME = "SKILL.md";
+/**
+ * `install-analyze-skill` — write (or update) the `renovate-log-analyzer`
+ * SKILL.md that teaches an AI coding agent to analyze Renovate logs with the
+ * `analyze` command.
+ *
+ * Answers come from flags when provided; otherwise the command prompts
+ * interactively on a TTY. With `--yes` (or on a non-TTY) prompts are skipped and
+ * missing required answers are an error.
+ *
+ * The skill is written to `<root>/.agents/skills/renovate-log-analyzer/SKILL.md`
+ * where `<root>` is the current working directory (local) or the user's home
+ * directory (global).
+ *
+ * Exit codes: 0 = success; 2 = tool/usage error (missing required answer, IO).
+ */
+export const installAnalyzeSkillCommand = {
+    command: "install-analyze-skill",
+    describe: "Install the renovate-log-analyzer SKILL.md for an AI coding agent",
+    builder: (yargs) => yargs
+        .option("scope", {
+        type: "string",
+        choices: ["local", "global"],
+        describe: "Install location: local (<cwd>/.agents/skills) or global (~/.agents/skills)",
+    })
+        .option("with-gh", {
+        type: "boolean",
+        describe: "Include a section on fetching Renovate logs from GitHub via the gh CLI",
+    })
+        .option("gh-base-url", {
+        type: "string",
+        describe: "GitHub Enterprise host for the gh section (e.g. github.example.com); omit for github.com",
+    })
+        .option("gh-org", {
+        type: "string",
+        describe: "GitHub organization/owner (gh section)",
+    })
+        .option("gh-repo", {
+        type: "string",
+        describe: "Repository name (gh section)",
+    })
+        .option("gh-workflow", {
+        type: "string",
+        describe: "Filename of the workflow that runs Renovate, e.g. renovate.yml (gh section)",
+    })
+        .option("yes", {
+        type: "boolean",
+        default: false,
+        describe: "Skip all prompts; fail if a required answer is missing",
+    }),
+    handler: async (argv) => {
+        try {
+            const interactive = !argv.yes && stdin.isTTY === true;
+            const answers = await resolveAnswers(argv, interactive);
+            const root = answers.scope === "global" ? homedir() : process.cwd();
+            const dir = resolve(root, SKILL_SUBPATH);
+            const file = join(dir, SKILL_FILENAME);
+            const updating = existsSync(file);
+            const content = buildSkillMarkdown({ gh: answers.gh });
+            mkdirSync(dir, { recursive: true });
+            writeFileSync(file, content);
+            process.stdout.write(`${updating ? "Updated" : "Created"} ${file}\n` +
+                (answers.gh
+                    ? `Included GitHub fetch section for ${answers.gh.org}/${answers.gh.repo} ` +
+                        `(workflow ${answers.gh.workflow}${answers.gh.baseUrl ? `, host ${answers.gh.baseUrl}` : ""}).\n`
+                    : ""));
+        }
+        catch (err) {
+            console.error(`install-analyze-skill: ${err.message}`);
+            process.exitCode = 2;
+        }
+    },
+};
+/**
+ * Resolve every answer from flags, falling back to interactive prompts when a
+ * flag is absent and a TTY is available. When not interactive, a missing
+ * required answer throws (tool/usage error).
+ */
+async function resolveAnswers(argv, interactive) {
+    const rl = interactive
+        ? createInterface({ input: stdin, output: stdout })
+        : undefined;
+    try {
+        const scope = await resolveScope(argv.scope, rl);
+        const gh = await resolveGh(argv, rl);
+        return { scope, gh };
+    }
+    finally {
+        rl?.close();
+    }
+}
+/** Resolve the install scope (local/global). */
+async function resolveScope(flag, rl) {
+    if (flag === "local" || flag === "global")
+        return flag;
+    if (flag !== undefined) {
+        throw new Error(`Invalid --scope "${flag}". Expected "local" or "global".`);
+    }
+    if (!rl) {
+        throw new Error('Missing --scope (expected "local" or "global"). Provide it as a flag when running non-interactively.');
+    }
+    const answer = (await rl.question("Install the skill locally or globally? [local/global] "))
+        .trim()
+        .toLowerCase();
+    if (answer === "" || answer === "l" || answer === "local")
+        return "local";
+    if (answer === "g" || answer === "global")
+        return "global";
+    throw new Error(`Invalid choice "${answer}". Expected "local" or "global".`);
+}
+/**
+ * Resolve the optional GitHub-fetch config. `--with-gh` (or an interactive
+ * yes/no) gates it; the org/repo/workflow are required once enabled, the base
+ * URL is optional.
+ */
+async function resolveGh(argv, rl) {
+    const anyGhFlag = argv["gh-org"] !== undefined ||
+        argv["gh-repo"] !== undefined ||
+        argv["gh-workflow"] !== undefined ||
+        argv["gh-base-url"] !== undefined;
+    let include;
+    if (argv["with-gh"] !== undefined) {
+        include = argv["with-gh"];
+    }
+    else if (anyGhFlag) {
+        // gh details supplied without the boolean gate — treat as opt-in.
+        include = true;
+    }
+    else if (rl) {
+        include = await promptYesNo(rl, "Include instructions to fetch logs from GitHub via the gh CLI?", false);
+    }
+    else {
+        include = false;
+    }
+    if (!include)
+        return undefined;
+    const org = await resolveRequired(argv["gh-org"], rl, "GitHub organization/owner", "--gh-org");
+    const repo = await resolveRequired(argv["gh-repo"], rl, "Repository name", "--gh-repo");
+    const workflow = await resolveRequired(argv["gh-workflow"], rl, "Workflow filename that runs Renovate (e.g. renovate.yml)", "--gh-workflow");
+    const baseUrl = await resolveOptional(argv["gh-base-url"], rl, "GitHub base URL/host (blank for github.com)");
+    return { org, repo, workflow, baseUrl: baseUrl || undefined };
+}
+/** Resolve a required free-text answer from a flag or a prompt. */
+async function resolveRequired(flag, rl, label, flagName) {
+    if (flag !== undefined && flag.trim() !== "")
+        return flag.trim();
+    if (!rl) {
+        throw new Error(`Missing ${flagName} (${label}). Provide it as a flag when running non-interactively.`);
+    }
+    const answer = (await rl.question(`${label}: `)).trim();
+    if (answer === "")
+        throw new Error(`${label} must not be empty.`);
+    return answer;
+}
+/** Resolve an optional free-text answer from a flag or a prompt. */
+async function resolveOptional(flag, rl, label) {
+    if (flag !== undefined)
+        return flag.trim();
+    if (!rl)
+        return "";
+    return (await rl.question(`${label}: `)).trim();
+}
+/** Prompt a yes/no question with a default. */
+async function promptYesNo(rl, question, defaultValue) {
+    const hint = defaultValue ? "[Y/n]" : "[y/N]";
+    const answer = (await rl.question(`${question} ${hint} `))
+        .trim()
+        .toLowerCase();
+    if (answer === "")
+        return defaultValue;
+    return answer === "y" || answer === "yes";
+}
+//# sourceMappingURL=install-analyze-skill.js.map

package/dist/commands/install-analyze-skill.js.map

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

package/dist/commands/web.d.ts

@@ -0,0 +1,12 @@
+import type { CommandModule } from "yargs";
+interface WebArgs {
+    path?: string;
+    port: number;
+    host: string;
+    open: boolean;
+}
+/**
+ * `web` — starts the bundled Nuxt (Nitro) production server.
+ */
+export declare const webCommand: CommandModule<object, WebArgs>;
+export {};

package/dist/commands/web.js

@@ -0,0 +1,103 @@
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * Resolve the prebuilt Nitro server entry that ships inside this package.
+ * Layout after `tsc`: dist/commands/web.js  →  ../../web/.output/server/index.mjs
+ */
+function resolveServerEntry() {
+    return fileURLToPath(new URL("../../web/.output/server/index.mjs", import.meta.url));
+}
+/** Best-effort, dependency-free browser opener. */
+function openBrowser(url) {
+    const command = process.platform === "darwin"
+        ? "open"
+        : process.platform === "win32"
+            ? "cmd"
+            : "xdg-open";
+    const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+    try {
+        spawn(command, args, { stdio: "ignore", detached: true }).unref();
+    }
+    catch {
+        // Opening the browser is non-critical; ignore failures.
+    }
+}
+/**
+ * `web` — starts the bundled Nuxt (Nitro) production server.
+ */
+export const webCommand = {
+    command: "web [path]",
+    describe: "Start the Nuxt-based web UI",
+    builder: (yargs) => yargs
+        .positional("path", {
+        type: "string",
+        describe: "Optional Renovate JSONL log to open automatically in the UI",
+    })
+        .option("port", {
+        type: "number",
+        default: 3000,
+        describe: "Port to listen on",
+    })
+        .option("host", {
+        type: "string",
+        default: "localhost",
+        describe: "Host to bind to",
+    })
+        .option("open", {
+        type: "boolean",
+        default: true,
+        describe: "Open the web UI in your browser",
+    }),
+    handler: (argv) => {
+        const serverEntry = resolveServerEntry();
+        if (!existsSync(serverEntry)) {
+            console.error("The web UI has not been built yet.\n" +
+                "Expected server bundle at:\n  " +
+                serverEntry +
+                '\nRun "npm run build" from the package source before using the "web" command.');
+            process.exitCode = 1;
+            return;
+        }
+        const baseUrl = `http://${argv.host}:${argv.port}`;
+        // When a log path is given, resolve it to an absolute path and hand it off
+        // to the UI via `?log=` — the frontend reads it on mount and POSTs it to
+        // /api/log/path. The server itself does not need the path.
+        let openUrl = baseUrl;
+        if (argv.path) {
+            const absolutePath = resolve(argv.path);
+            if (!existsSync(absolutePath)) {
+                console.error(`Log file not found: ${absolutePath}`);
+                process.exitCode = 2;
+                return;
+            }
+            openUrl = `${baseUrl}/?log=${encodeURIComponent(absolutePath)}`;
+        }
+        console.log(`Starting renovate-log-parser web UI on ${baseUrl}`);
+        const child = spawn(process.execPath, [serverEntry], {
+            stdio: "inherit",
+            env: {
+                ...process.env,
+                PORT: String(argv.port),
+                HOST: argv.host,
+                NITRO_PORT: String(argv.port),
+                NITRO_HOST: argv.host,
+            },
+        });
+        if (argv.open) {
+            // Give Nitro a moment to bind before opening the browser.
+            setTimeout(() => openBrowser(openUrl), 1000);
+        }
+        const forward = (signal) => () => {
+            if (!child.killed)
+                child.kill(signal);
+        };
+        process.on("SIGINT", forward("SIGINT"));
+        process.on("SIGTERM", forward("SIGTERM"));
+        child.on("exit", (code) => {
+            process.exitCode = code ?? 0;
+        });
+    },
+};
+//# sourceMappingURL=web.js.map

package/dist/commands/web.js.map

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

package/dist/core/analyzer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Analyzer — produces the two token-efficient views the `analyze` command
+ * exposes to an AI coding agent:
+ *
+ *  - {@link Analyzer.stats} — a single pass over the whole log summarising level
+ *    counts and per-repository structure (line spans, branches, dependency
+ *    inventory, repo problems). Rendered as compact single-line JSON by the command.
+ *  - {@link Analyzer.print} — a filtered, line-ranged, limited slice of the log
+ *    projected to JSONL, with ignored root fields stripped. Selection order is
+ *    line-range -> filters -> limit, mirroring the source log's order.
+ *
+ * Repositories are keyed strictly by the root-level `repository` value; entries
+ * without one, and git-URL sub-repos whose `repository` is an `https://…` URL
+ * (e.g. pre-commit hooks), are excluded from the per-repo view. The dependency
+ * inventory is disambiguated strictly by
+ * `msg === "packageFiles with updates"`, unioned with root-level
+ * `depName`/`packageName` occurrences.
+ */
+import type { Parser } from "./parser.js";
+import type { Filter } from "./filters.js";
+/** Per-repository structural summary emitted by {@link Analyzer.stats}. */
+export interface RepoStats {
+    /** The `repository` value verbatim (owner/repo or a git URL). */
+    name: string;
+    /** rowid (0-indexed line) of this repo's first entry. */
+    fromLine: number;
+    /** rowid (0-indexed line) of this repo's last entry. */
+    toLine: number;
+    /** Unique root-level `branch` values, in order of appearance. */
+    branches: string[];
+    /** rowid of the `branches info extended` entry, or null. */
+    branchesInformationLine: number | null;
+    /** rowid of the `packageFiles with updates` entry, or null. */
+    packageFilesLine: number | null;
+    /** Unique `repoProblems` strings, in order of appearance. */
+    repoProblems: string[];
+    /** Union of root-level `depName` + packageFiles config deps, deduped. */
+    depNames: string[];
+    /** Union of root-level `packageName` + packageFiles config deps, deduped. */
+    packageNames: string[];
+}
+/** Whole-log statistics emitted in stats mode (compact single-line JSON). */
+export interface AnalyzeStats {
+    logFile: string;
+    md5: string;
+    totalLines: number;
+    /** Count of entries per numeric level, keyed by the level as a string. */
+    levelCounts: Record<string, number>;
+    repos: RepoStats[];
+}
+/** Options for {@link Analyzer.print}. */
+export interface PrintOptions {
+    /** Root keys to strip from each entry (`msg` is never strippable). */
+    ignoredFields: readonly string[];
+    /** Inclusive 0-indexed rowid lower bound. */
+    lineFrom?: number;
+    /** Inclusive 0-indexed rowid upper bound. */
+    lineTo?: number;
+    /** Maximum number of lines to emit. */
+    limit: number;
+    /** Scalar-equals / wildcard filters, AND'd (from `--filter` / `--filter-with-wildcard`). */
+    filters: readonly Filter[];
+    /** When true, add `_oL` (0-indexed source line) to each emitted object. */
+    includeOriginalLine: boolean;
+}
+/** Result of {@link Analyzer.print}. */
+export interface PrintResult {
+    /** The stripped entries to write, in line order. */
+    entries: Record<string, unknown>[];
+    /** Total rows matching range + filters (before the limit). */
+    totalMatched: number;
+    /** Number of entries actually emitted (== entries.length). */
+    emitted: number;
+    /** True when the limit capped the result (totalMatched > emitted). */
+    truncated: boolean;
+}
+/**
+ * Computes the `analyze` command's stats and print views against an
+ * already-loaded {@link Parser}.
+ */
+export declare class Analyzer {
+    private readonly parser;
+    constructor(parser: Parser);
+    /** Build the whole-log statistics view (single pass, all repositories). */
+    stats(): AnalyzeStats;
+    /** Build the filtered, ranged, limited JSONL slice (print mode). */
+    print(options: PrintOptions): PrintResult;
+    private requireLoaded;
+}