@jeeva1398/eventa 0.1.2 → 0.2.0

package/README.md

@@ -1,6 +1,11 @@
 # eventa
 
-**Offline AI assistant for Node.js developers.** It explains crashes, reviews your diffs and audits dependencies, using a small code model that runs on your own machine. No API key, and no code leaves your laptop.
+[![npm](https://img.shields.io/npm/v/@jeeva1398/eventa?color=cb3837&label=npm)](https://www.npmjs.com/package/@jeeva1398/eventa)
+[![downloads](https://img.shields.io/npm/dm/@jeeva1398/eventa)](https://www.npmjs.com/package/@jeeva1398/eventa)
+[![model](https://img.shields.io/badge/%F0%9F%A4%97%20model-eventa--1.5b-yellow)](https://huggingface.co/jeeva1398/eventa-1.5b-gguf)
+![offline](https://img.shields.io/badge/runs-100%25%20offline-2ea44f)
+
+**Offline AI assistant for Node.js and TypeScript developers.** It explains crashes, reviews your diffs and audits dependencies, using a small code model that runs on your own machine. No API key, and no code leaves your laptop.
 
 ```bash
 npx @jeeva1398/eventa explain --run "node app.js"   # run it, explain the crash
@@ -44,7 +49,42 @@ Global flags: `-p, --provider auto|ollama|local`, `-m, --model <name>`, `--host
 | `localModel` (built-in) | `eventa-1.5b` | `EVENTA_LOCAL_MODEL` |
 | `ollamaHost` | `http://localhost:11434` | `EVENTA_OLLAMA_HOST` / `OLLAMA_HOST` |
 | `contextSize` | `8192` | |
-| `temperature` | `0.2` | |
+| `temperature` | `0.2` | `EVENTA_TEMPERATURE` |
+
+## Review pull requests in GitHub Actions
+
+Eventa can review every pull request and post the findings as one comment, which it updates on each push. The model runs on the GitHub runner, so your code is not sent to any AI service.
+
+```yaml
+# .github/workflows/eventa.yml
+name: eventa
+on: pull_request
+permissions:
+  contents: read
+  pull-requests: write
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+      - uses: Jeeva1398/eventa@v0.2.0
+        with:
+          fail-on: none   # or high | medium | low to fail the check
+```
+
+| Input | Default | |
+|---|---|---|
+| `fail-on` | `none` | Fail the job when the AI reports an issue at this severity or above. |
+| `max-files` | `20` | Maximum number of files to review. |
+| `base` | PR base | Git ref to diff against. |
+| `comment` | `true` | Post or update the PR comment. The report is always written to the job summary. |
+| `version` | the action's tag | `@jeeva1398/eventa` version to run. |
+
+The first run downloads the runtime and model (~1 GB). Later runs restore them from the Actions cache. Reviews run at temperature 0, so re-running a job gives the same result. Pull requests from forks get a read-only token, so for those the report goes only to the job summary.
+
+Locally, `eventa review --markdown` prints the same report, and `--fail-on high` sets exit code 1 when the review finds a high-severity issue.
 
 ## Privacy & security
 

package/dist/index.js

@@ -39,6 +39,7 @@ function fromEnv(env) {
   if (env.EVENTA_MODEL) out.model = env.EVENTA_MODEL;
   if (env.EVENTA_LOCAL_MODEL) out.localModel = env.EVENTA_LOCAL_MODEL;
   if (env.EVENTA_PROVIDER) out.provider = env.EVENTA_PROVIDER;
+  if (env.EVENTA_TEMPERATURE && !Number.isNaN(Number(env.EVENTA_TEMPERATURE))) out.temperature = Number(env.EVENTA_TEMPERATURE);
   const host = env.EVENTA_OLLAMA_HOST ?? env.OLLAMA_HOST;
   if (host) out.ollamaHost = host.startsWith("http") ? host : `http://${host}`;
   return out;
@@ -1258,6 +1259,57 @@ ${hints.map((h) => `- [${h.severity}] line ${h.line}: ${h.message}`).join("\n")}
   };
 }
 
+// src/commands/reviewReport.ts
+var MARKER = "<!-- eventa-review -->";
+var RANK = { low: 1, medium: 2, high: 3 };
+var ICON = { high: "\u{1F534}", medium: "\u{1F7E0}", low: "\u26AA" };
+function parseIssues(analysis) {
+  const issues = [];
+  for (const line of analysis.split(/\r?\n/)) {
+    const m = /^\s*[-*]\s*\[(high|medium|low)\]\s*(?:line\s+(\d+)\s*:?)?\s*(.+)$/i.exec(line);
+    if (m) issues.push({ severity: m[1].toLowerCase(), line: m[2] ? Number(m[2]) : void 0, text: m[3].trim() });
+  }
+  return issues;
+}
+function worstSeverity(results) {
+  let worst;
+  for (const r of results) for (const i of parseIssues(r.analysis)) if (!worst || RANK[i.severity] > RANK[worst]) worst = i.severity;
+  return worst;
+}
+var meetsThreshold = (worst, failOn) => !!worst && failOn in RANK && RANK[worst] >= RANK[failOn];
+var cell = (s) => s.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+function toMarkdown(results, opts) {
+  const byFile = /* @__PURE__ */ new Map();
+  for (const r of results) {
+    const entry = byFile.get(r.file) ?? { issues: [], hints: [] };
+    entry.issues.push(...parseIssues(r.analysis));
+    entry.hints.push(...r.hints);
+    byFile.set(r.file, entry);
+  }
+  const all = [...byFile.values()].flatMap((f) => f.issues);
+  const count = (s) => all.filter((i) => i.severity === s).length;
+  const out = [MARKER, "### Eventa review", ""];
+  if (!all.length) {
+    out.push(`No issues found in ${byFile.size} file(s) (${opts.label}).`);
+  } else {
+    out.push(`Found **${all.length}** issue(s) in ${byFile.size} file(s) (${opts.label}): ${count("high")} high, ${count("medium")} medium, ${count("low")} low.`, "");
+    out.push("| | File | Line | Issue |", "|---|---|---|---|");
+    for (const [file, { issues }] of byFile) {
+      for (const i of [...issues].sort((a, b) => RANK[b.severity] - RANK[a.severity])) {
+        out.push(`| ${ICON[i.severity]} ${i.severity} | \`${file}\` | ${i.line ?? ""} | ${cell(i.text)} |`);
+      }
+    }
+  }
+  const hinted = [...byFile].filter(([, f]) => f.hints.length);
+  if (hinted.length) {
+    out.push("", "<details><summary>Static checks</summary>", "");
+    for (const [file, { hints }] of hinted) for (const h of hints) out.push(`- \`${file}\` line ${h.line}: [${h.severity}] ${h.message}`);
+    out.push("", "</details>");
+  }
+  out.push("", `<sub>Reviewed offline by <a href="https://github.com/Jeeva1398/eventa">eventa</a> ${opts.version}. AI findings can be wrong, check before acting.</sub>`);
+  return out.join("\n") + "\n";
+}
+
 // src/commands/review.ts
 var SEVERITY = { high: chalk7.red, medium: chalk7.yellow, low: chalk7.dim };
 var git = (args, cwd) => exec("git", args, { cwd, shell: false });
@@ -1276,13 +1328,16 @@ async function getDiff(cwd, base) {
 async function reviewCommand(config2, opts) {
   const cwd = process.cwd();
   const { diff, label } = await getDiff(cwd, opts.base);
+  if (opts.failOn && !["high", "medium", "low", "none"].includes(opts.failOn)) throw new Error("--fail-on must be high, medium, low or none");
+  const quiet = opts.json || opts.markdown;
   const files = parseDiff(diff).slice(0, Number(opts.maxFiles) || 20);
   if (!files.length) {
     if (opts.json) printJson([]);
+    else if (opts.markdown) process.stdout.write(toMarkdown([], { label, version: "0.2.0" }));
     else console.log(chalk7.yellow("Nothing to review: no changed source files found."));
     return;
   }
-  if (!opts.json) console.log(chalk7.dim(`Reviewing ${label} in ${files.length} file(s)
+  if (!quiet) console.log(chalk7.dim(`Reviewing ${label} in ${files.length} file(s)
 `));
   const maxChars = Math.min(12e3, Math.floor((config2.contextSize - 2e3) * 3.5));
   const results = [];
@@ -1291,7 +1346,9 @@ async function reviewCommand(config2, opts) {
     const parts = splitPatch(file.patch, maxChars);
     for (const [i, part] of parts.entries()) {
       const partHints = hints.filter((h) => part.includes(`${String(h.line).padStart(4)} +`));
-      if (!opts.json) {
+      if (opts.markdown) process.stderr.write(`Reviewing ${file.path}${parts.length > 1 ? ` (part ${i + 1}/${parts.length})` : ""}
+`);
+      if (!quiet) {
         const suffix = parts.length > 1 ? chalk7.dim(` (part ${i + 1}/${parts.length})`) : "";
         console.log(chalk7.bold.cyan(`\u25B8 ${file.path}`) + suffix);
         if (partHints.length) {
@@ -1300,20 +1357,22 @@ async function reviewCommand(config2, opts) {
           console.log(chalk7.bold("AI review"));
         }
       }
-      const analysis = await generate(config2, reviewPrompt(file.path, part, partHints), opts);
+      const analysis = await generate(config2, reviewPrompt(file.path, part, partHints), { ...opts, json: quiet });
       results.push({ file: file.path, hints: partHints, analysis });
-      if (!opts.json && /^no issues found\.?$/i.test(analysis.trim()) && partHints.some((h) => h.severity !== "low")) {
+      if (!quiet && /^no issues found\.?$/i.test(analysis.trim()) && partHints.some((h) => h.severity !== "low")) {
         console.log(chalk7.yellow("The AI did not confirm the static checks above. Verify them yourself."));
       }
-      if (!opts.json) console.log();
+      if (!quiet) console.log();
     }
   }
   if (opts.json) printJson(results);
+  else if (opts.markdown) process.stdout.write(toMarkdown(results, { label, version: "0.2.0" }));
+  if (opts.failOn && meetsThreshold(worstSeverity(results), opts.failOn)) process.exitCode = 1;
 }
 
 // src/index.ts
 var program = new Command();
-program.name("eventa").description("Offline AI assistant for Node.js developers").version("0.1.2").option("-m, --model <name>", "model to use (overrides config)").option("--host <url>", "Ollama host URL").option("-p, --provider <name>", "auto | ollama | local").option("--raw", "print plain output without terminal formatting");
+program.name("eventa").description("Offline AI assistant for Node.js developers").version("0.2.0").option("-m, --model <name>", "model to use (overrides config)").option("--host <url>", "Ollama host URL").option("-p, --provider <name>", "auto | ollama | local").option("--raw", "print plain output without terminal formatting");
 var configFrom = (cmd) => {
   const g = cmd.optsWithGlobals();
   if (g.provider && !["auto", "ollama", "local"].includes(g.provider)) throw new Error("--provider must be auto, ollama or local");
@@ -1327,7 +1386,7 @@ program.command("explain").description("explain a Node.js error or stack trace a
   const { config: config2, raw } = configFrom(cmd);
   await explainCommand(words, config2, { ...opts, raw });
 });
-program.command("review").description("review your staged git diff (falls back to unstaged changes)").option("-b, --base <ref>", "review all changes since a branch or commit, e.g. main").option("--max-files <n>", "maximum files to review", "20").option("--json", "print JSON output").action(async (opts, cmd) => {
+program.command("review").description("review your staged git diff (falls back to unstaged changes)").option("-b, --base <ref>", "review all changes since a branch or commit, e.g. main").option("--max-files <n>", "maximum files to review", "20").option("--json", "print JSON output").option("--markdown", "print a Markdown report (for PR comments)").option("--fail-on <severity>", "exit with code 1 if the AI reports an issue at this severity or above: high | medium | low | none").action(async (opts, cmd) => {
   const { config: config2, raw } = configFrom(cmd);
   await reviewCommand(config2, { ...opts, raw });
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jeeva1398/eventa",
-  "version": "0.1.2",
-  "description": "Offline AI assistant for Node.js developers: explain errors, review diffs, audit dependencies.",
+  "version": "0.2.0",
+  "description": "Offline AI assistant for Node.js & TypeScript: explains crashes, reviews git diffs, audits npm dependencies. Runs a local 1 GB model, no API key.",
   "type": "module",
   "bin": {
     "eventa": "dist/index.js"
@@ -24,13 +24,29 @@
   },
   "keywords": [
     "nodejs",
+    "typescript",
     "ai",
     "cli",
-    "llm",
-    "offline",
     "code-review",
+    "ai-code-review",
+    "debugging",
+    "stack-trace",
+    "error",
+    "explain",
+    "npm-audit",
+    "dependencies",
+    "security",
+    "offline",
+    "local-llm",
+    "llm",
     "ollama",
-    "gguf"
+    "gguf",
+    "llama.cpp",
+    "express",
+    "nestjs",
+    "prisma",
+    "privacy",
+    "developer-tools"
   ],
   "repository": {
     "type": "git",