@codacy/analysis-runner 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -34,6 +34,18 @@ interface AnalyzeOptions {
     /** Target execution environment. "local" = developer machine, "container" = Codacy Docker runner.
      *  Phase 9 implements the actual container path; this field is accepted but currently ignored. */
     runner?: "local" | "container";
+    /**
+     * Git-aware file scope. Mutually exclusive options:
+     * - `"staged"` — analyze only files in the git staging area
+     * - `{ diff: string | true }` — analyze files changed vs a base ref (true = auto-detect)
+     * - `"pr"` — analyze files in the current pull request
+     *
+     * Resolved files are intersected with `files` if both are provided.
+     * If the resolved set is empty, analysis returns immediately with zero issues.
+     */
+    gitScope?: "staged" | {
+        diff: string | true;
+    } | "pr";
     /** Logger for pipeline progress messages (install status, etc.). Defaults to no-op. */
     logger?: Logger;
     /** Called when a tool starts executing. */
@@ -278,6 +290,32 @@ declare function resolveEngineToAdapter(engineName: string, adapters: Readonly<T
  */
 declare function applyCodacyYamlExcludes(config: CodacyConfig, yamlConfig: CodacyYamlConfig, adapters: Readonly<ToolAdapter>[], logger?: Logger): CodacyConfig;
 
+/**
+ * File discovery and routing — finds files in a repository, applies exclusion
+ * layers (.gitignore, global exclude, per-tool exclude), and routes files to
+ * the appropriate tool adapters based on file patterns.
+ */
+
+/**
+ * Returns files changed in the git staging area (index), excluding deleted files.
+ * Used by `--staged` to analyze only what's about to be committed.
+ */
+declare function listStagedFiles(repositoryRoot: string): string[];
+/**
+ * Returns files changed between a base ref and HEAD, excluding deleted files.
+ * Uses the three-dot diff (`base...HEAD`) to show only changes since divergence.
+ *
+ * If `base` is omitted, auto-detects the default branch via `detectDefaultBranch()`.
+ */
+declare function listDiffFiles(repositoryRoot: string, base?: string): string[];
+/**
+ * Returns files changed in the current pull request.
+ *
+ * Tries `gh pr view` first for accuracy (handles renames, squash merges).
+ * Falls back to git merge-base diff when gh is unavailable or not in a PR context.
+ */
+declare function listPrFiles(repositoryRoot: string): string[];
+
 /**
  * Codacy API client — thin wrappers around the generated OpenAPI client.
  *
@@ -361,4 +399,4 @@ declare function rotateLogFiles(logsDir: string, maxFiles: number): void;
  */
 declare function createLogger(options?: LoggerOptions): Logger;
 
-export { type AnalyzeOptions, type CodacyYamlConfig, type CodacyYamlEngineConfig, type ExecutionMode, type InitDefaultStats, type InitLocalStats, type InitRemoteStats, type LoggerOptions, analyze, applyCodacyYamlExcludes, buildToolConfig, clearAdapters, configureApiToken, createCodacyConfig, createLogger, detectLanguages, formatOutput, formatTextSummary, getRegisteredAdapters, initContainerConfig, initDefaultConfig, initLocalConfig, initRemoteConfig, readCodacyConfig, readCodacyYaml, registerAdapter, resolveEngineToAdapter, rotateLogFiles, validateApiToken, writeCodacyConfig };
+export { type AnalyzeOptions, type CodacyYamlConfig, type CodacyYamlEngineConfig, type ExecutionMode, type InitDefaultStats, type InitLocalStats, type InitRemoteStats, type LoggerOptions, analyze, applyCodacyYamlExcludes, buildToolConfig, clearAdapters, configureApiToken, createCodacyConfig, createLogger, detectLanguages, formatOutput, formatTextSummary, getRegisteredAdapters, initContainerConfig, initDefaultConfig, initLocalConfig, initRemoteConfig, listDiffFiles, listPrFiles, listStagedFiles, readCodacyConfig, readCodacyYaml, registerAdapter, resolveEngineToAdapter, rotateLogFiles, validateApiToken, writeCodacyConfig };

package/dist/index.js

@@ -45,6 +45,9 @@ __export(index_exports, {
   initDefaultConfig: () => initDefaultConfig,
   initLocalConfig: () => initLocalConfig,
   initRemoteConfig: () => initRemoteConfig,
+  listDiffFiles: () => listDiffFiles,
+  listPrFiles: () => listPrFiles,
+  listStagedFiles: () => listStagedFiles,
   readCodacyConfig: () => readCodacyConfig,
   readCodacyYaml: () => readCodacyYaml,
   registerAdapter: () => registerAdapter,
@@ -207,6 +210,91 @@ function routeFilesToTool(files, adapter, toolConfig) {
     );
   });
 }
+function listStagedFiles(repositoryRoot) {
+  try {
+    const output = (0, import_child_process.execSync)("git diff --cached --name-only --diff-filter=d", {
+      cwd: repositoryRoot,
+      encoding: "utf-8",
+      maxBuffer: 10 * 1024 * 1024
+    }).trim();
+    return output ? output.split("\n").filter(Boolean).sort() : [];
+  } catch {
+    throw new Error("Cannot list staged files: not inside a git repository");
+  }
+}
+function listDiffFiles(repositoryRoot, base) {
+  const baseBranch = base ?? detectDefaultBranch(repositoryRoot);
+  try {
+    const output = (0, import_child_process.execFileSync)(
+      "git",
+      ["diff", "--name-only", "--diff-filter=d", `${baseBranch}...HEAD`],
+      { cwd: repositoryRoot, encoding: "utf-8", maxBuffer: 10 * 1024 * 1024 }
+    ).trim();
+    return output ? output.split("\n").filter(Boolean).sort() : [];
+  } catch {
+    throw new Error(
+      `Cannot diff against "${baseBranch}": ref not found or not inside a git repository. Specify a base explicitly with --diff <base>.`
+    );
+  }
+}
+function listPrFiles(repositoryRoot) {
+  try {
+    const output = (0, import_child_process.execSync)("gh pr view --json files --jq '.files[].path'", {
+      cwd: repositoryRoot,
+      encoding: "utf-8",
+      maxBuffer: 10 * 1024 * 1024,
+      timeout: 15e3
+    }).trim();
+    if (output) {
+      return output.split("\n").filter(Boolean).sort();
+    }
+  } catch {
+  }
+  const baseBranch = detectDefaultBranch(repositoryRoot);
+  try {
+    const mergeBase = (0, import_child_process.execFileSync)("git", ["merge-base", "HEAD", baseBranch], {
+      cwd: repositoryRoot,
+      encoding: "utf-8"
+    }).trim();
+    const output = (0, import_child_process.execFileSync)(
+      "git",
+      ["diff", "--name-only", "--diff-filter=d", `${mergeBase}...HEAD`],
+      { cwd: repositoryRoot, encoding: "utf-8", maxBuffer: 10 * 1024 * 1024 }
+    ).trim();
+    return output ? output.split("\n").filter(Boolean).sort() : [];
+  } catch {
+    throw new Error(
+      `Cannot determine PR files: gh CLI unavailable and git merge-base with "${baseBranch}" failed. Use --diff <base> instead.`
+    );
+  }
+}
+function detectDefaultBranch(repositoryRoot) {
+  try {
+    const ref = (0, import_child_process.execSync)("git rev-parse --abbrev-ref origin/HEAD", {
+      cwd: repositoryRoot,
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    if (ref && ref !== "origin/HEAD") {
+      return ref;
+    }
+  } catch {
+  }
+  for (const branch of ["origin/main", "origin/master"]) {
+    try {
+      (0, import_child_process.execFileSync)("git", ["rev-parse", "--verify", branch], {
+        cwd: repositoryRoot,
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      return branch;
+    } catch {
+    }
+  }
+  throw new Error(
+    "Cannot auto-detect default branch: no origin/HEAD, origin/main, or origin/master found. Specify a base explicitly with --diff <base>."
+  );
+}
 function filterByTargetFiles(allFiles, targetPatterns) {
   if (targetPatterns.length === 0) return allFiles;
   const normalized = targetPatterns.map((p) => p.replace(/^\.\//, ""));
@@ -225,16 +313,24 @@ function filterByTargetFiles(allFiles, targetPatterns) {
 // src/executor.ts
 async function runTool(adapter, ctx, codacyToolConfig, timeoutMs) {
   const startTime = Date.now();
-  ctx.logger.debug("runTool started", { toolId: adapter.id, fileCount: ctx.targetFiles.length, timeoutMs });
+  ctx.logger.debug("runTool started", {
+    toolId: adapter.id,
+    fileCount: ctx.targetFiles.length,
+    timeoutMs
+  });
   try {
     const timeoutPromise = new Promise((_resolve, reject) => {
-      setTimeout(() => reject(new Error(`TIMEOUT: Tool ${adapter.id} exceeded ${timeoutMs}ms`)), timeoutMs);
+      setTimeout(
+        () => reject(new Error(`TIMEOUT: Tool ${adapter.id} exceeded ${timeoutMs}ms`)),
+        timeoutMs
+      );
+    });
+    const result = await Promise.race([adapter.analyze(ctx, codacyToolConfig), timeoutPromise]);
+    ctx.logger.debug("runTool completed", {
+      toolId: adapter.id,
+      issueCount: result.summary.issueCount,
+      durationMs: result.summary.durationMs
     });
-    const result = await Promise.race([
-      adapter.analyze(ctx, codacyToolConfig),
-      timeoutPromise
-    ]);
-    ctx.logger.debug("runTool completed", { toolId: adapter.id, issueCount: result.summary.issueCount, durationMs: result.summary.durationMs });
     return result;
   } catch (err) {
     const durationMs = Date.now() - startTime;
@@ -242,7 +338,11 @@ async function runTool(adapter, ctx, codacyToolConfig, timeoutMs) {
     if (isTimeout) {
       ctx.logger.error("Tool timed out", { toolId: adapter.id, timeoutMs, elapsedMs: durationMs });
     } else {
-      ctx.logger.error("Tool execution failed", { toolId: adapter.id, error: err instanceof Error ? err.message : String(err), durationMs });
+      ctx.logger.error("Tool execution failed", {
+        toolId: adapter.id,
+        error: err instanceof Error ? err.message : String(err),
+        durationMs
+      });
     }
     const now = /* @__PURE__ */ new Date();
     return {
@@ -277,7 +377,12 @@ async function runToolsSequential(tools, timeoutMs, callbacks) {
   for (const { adapter, ctx, codacyToolConfig } of tools) {
     callbacks?.onToolStart?.(adapter.id, adapter.displayName);
     const result = await runTool(adapter, ctx, codacyToolConfig, timeoutMs);
-    callbacks?.onToolComplete?.(adapter.id, adapter.displayName, result.summary.issueCount, result.summary.durationMs);
+    callbacks?.onToolComplete?.(
+      adapter.id,
+      adapter.displayName,
+      result.summary.issueCount,
+      result.summary.durationMs
+    );
     results.push(result);
   }
   return results;
@@ -291,7 +396,12 @@ async function runToolsParallel(tools, timeoutMs, concurrency, callbacks) {
       const { adapter, ctx, codacyToolConfig } = tools[index];
       callbacks?.onToolStart?.(adapter.id, adapter.displayName);
       results[index] = await runTool(adapter, ctx, codacyToolConfig, timeoutMs);
-      callbacks?.onToolComplete?.(adapter.id, adapter.displayName, results[index].summary.issueCount, results[index].summary.durationMs);
+      callbacks?.onToolComplete?.(
+        adapter.id,
+        adapter.displayName,
+        results[index].summary.issueCount,
+        results[index].summary.durationMs
+      );
     }
   }
   const workers = Array.from({ length: Math.min(concurrency, tools.length) }, () => worker());
@@ -337,11 +447,19 @@ async function analyze(options) {
       const availability = await Promise.race([
         adapter.checkAvailability(ctx),
         new Promise(
-          (_, reject) => setTimeout(() => reject(new Error(`checkAvailability timed out after ${availabilityTimeout}ms`)), availabilityTimeout)
+          (_, reject) => setTimeout(
+            () => reject(new Error(`checkAvailability timed out after ${availabilityTimeout}ms`)),
+            availabilityTimeout
+          )
         )
       ]);
       if (availability.available) {
-        logger.debug("Tool available", { toolId: adapter.id, version: availability.version, installation: availability.installation, durationMs: Date.now() - checkStart });
+        logger.debug("Tool available", {
+          toolId: adapter.id,
+          version: availability.version,
+          installation: availability.installation,
+          durationMs: Date.now() - checkStart
+        });
         ready.push({
           toolId: adapter.id,
           displayName: adapter.displayName,
@@ -350,7 +468,11 @@ async function analyze(options) {
           runner: "local"
         });
       } else {
-        logger.warn("Tool unavailable", { toolId: adapter.id, reason: availability.reason, durationMs: Date.now() - checkStart });
+        logger.warn("Tool unavailable", {
+          toolId: adapter.id,
+          reason: availability.reason,
+          durationMs: Date.now() - checkStart
+        });
         unavailable.push({
           toolId: adapter.id,
           displayName: adapter.displayName,
@@ -359,7 +481,11 @@ async function analyze(options) {
         });
       }
     } catch (err) {
-      logger.warn("Availability check failed", { toolId: adapter.id, error: err instanceof Error ? err.message : String(err), durationMs: Date.now() - checkStart });
+      logger.warn("Availability check failed", {
+        toolId: adapter.id,
+        error: err instanceof Error ? err.message : String(err),
+        durationMs: Date.now() - checkStart
+      });
       unavailable.push({
         toolId: adapter.id,
         displayName: adapter.displayName,
@@ -378,7 +504,11 @@ async function analyze(options) {
     const configuredIds = new Set(codacyConfig.tools.map((t) => t.toolId));
     capability.ready = capability.ready.filter((t) => configuredIds.has(t.toolId));
     capability.unavailable = capability.unavailable.filter((t) => configuredIds.has(t.toolId));
-    logger.debug("Filtered by config", { readyBefore, readyAfter: capability.ready.length, configuredToolCount: configuredIds.size });
+    logger.debug("Filtered by config", {
+      readyBefore,
+      readyAfter: capability.ready.length,
+      configuredToolCount: configuredIds.size
+    });
   } else {
     logger.debug("No codacy config found, running all available tools");
   }
@@ -407,7 +537,9 @@ async function analyze(options) {
             });
             capability.unavailable.splice(i, 1);
           } else {
-            logger.error(`${adapter.displayName} post-install check failed: ${recheck.reason ?? "unknown"}`);
+            logger.error(
+              `${adapter.displayName} post-install check failed: ${recheck.reason ?? "unknown"}`
+            );
             installErrors.push({
               toolId: adapter.id,
               phase: "toolInstall",
@@ -445,7 +577,15 @@ async function analyze(options) {
       }
     }
     if (installErrors.length > 0) {
-      return buildResult(startedAt, options.repositoryRoot, mode, capability, [], installErrors, []);
+      return buildResult(
+        startedAt,
+        options.repositoryRoot,
+        mode,
+        capability,
+        [],
+        installErrors,
+        []
+      );
     }
   }
   if (mode === "inspect") {
@@ -478,19 +618,41 @@ async function analyze(options) {
   }
   if (mode === "strict" && capability.unavailable.length > 0) {
     const missingTools = capability.unavailable.map((u) => u.toolId).join(", ");
-    return buildResult(startedAt, options.repositoryRoot, mode, capability, [], [
-      {
-        toolId: "runner",
-        phase: "requirementCheck",
-        kind: "UnavailableTools",
-        message: `Strict mode: the following tools are unavailable: ${missingTools}`,
-        level: "error"
-      }
-    ], []);
+    return buildResult(
+      startedAt,
+      options.repositoryRoot,
+      mode,
+      capability,
+      [],
+      [
+        {
+          toolId: "runner",
+          phase: "requirementCheck",
+          kind: "UnavailableTools",
+          message: `Strict mode: the following tools are unavailable: ${missingTools}`,
+          level: "error"
+        }
+      ],
+      []
+    );
   }
   const globalExclude = codacyConfig?.exclude || [];
   let allFiles = listRepoFiles(options.repositoryRoot);
   logger.debug("File discovery", { totalFiles: allFiles.length });
+  if (options.gitScope) {
+    const scopeFiles = resolveGitScope(options.repositoryRoot, options.gitScope);
+    logger.debug("Git scope resolved", {
+      scope: typeof options.gitScope === "string" ? options.gitScope : "diff",
+      fileCount: scopeFiles.length
+    });
+    if (scopeFiles.length === 0) {
+      logger.info("Git scope resolved to zero files, skipping analysis");
+      return buildResult(startedAt, options.repositoryRoot, mode, capability, [], [], []);
+    }
+    const scopeSet = new Set(scopeFiles);
+    allFiles = allFiles.filter((f) => scopeSet.has(f));
+    logger.debug("After git scope intersection", { fileCount: allFiles.length });
+  }
   if (options.files && options.files.length > 0) {
     allFiles = filterByTargetFiles(allFiles, options.files);
     logger.debug("Filtered by target files", { afterFilter: allFiles.length });
@@ -515,7 +677,11 @@ async function analyze(options) {
     const ctx = makeToolContext(baseCtx, adapter, toolFiles);
     const configCheck = await adapter.checkLocalConfigurationFile(ctx);
     const codacyToolConfig = buildToolConfig(codacyConfig, adapter, configCheck);
-    logger.debug("Tool config resolved", { toolId: adapter.id, configSource: codacyToolConfig.useLocalConfigurationFile ? "local" : "codacy", patternCount: codacyToolConfig.patterns?.length ?? 0 });
+    logger.debug("Tool config resolved", {
+      toolId: adapter.id,
+      configSource: codacyToolConfig.useLocalConfigurationFile ? "local" : "codacy",
+      patternCount: codacyToolConfig.patterns?.length ?? 0
+    });
     const readyEntry = capability.ready.find((r) => r.toolId === adapter.id);
     if (readyEntry) {
       if (configCheck.found && codacyToolConfig.useLocalConfigurationFile) {
@@ -527,7 +693,11 @@ async function analyze(options) {
     }
     toolRuns.push({ adapter, ctx, codacyToolConfig });
   }
-  logger.info("Starting tool execution", { toolCount: toolRuns.length, parallel: parallelTools > 1, parallelTools });
+  logger.info("Starting tool execution", {
+    toolCount: toolRuns.length,
+    parallel: parallelTools > 1,
+    parallelTools
+  });
   const callbacks = {
     onToolStart: options.onToolStart,
     onToolComplete: options.onToolComplete
@@ -541,8 +711,20 @@ async function analyze(options) {
   const allIssues = normalizeIssues(results.flatMap((r) => r.issues));
   const allErrors = results.flatMap((r) => r.errors);
   const allSummaries = results.map((r) => r.summary);
-  logger.info("Pipeline complete", { totalIssues: allIssues.length, totalErrors: allErrors.length, durationMs: Date.now() - startedAt.getTime() });
-  return buildResult(startedAt, options.repositoryRoot, mode, capability, allIssues, allErrors, allSummaries);
+  logger.info("Pipeline complete", {
+    totalIssues: allIssues.length,
+    totalErrors: allErrors.length,
+    durationMs: Date.now() - startedAt.getTime()
+  });
+  return buildResult(
+    startedAt,
+    options.repositoryRoot,
+    mode,
+    capability,
+    allIssues,
+    allErrors,
+    allSummaries
+  );
 }
 function makeToolContext(base, adapter, targetFiles) {
   return {
@@ -561,6 +743,12 @@ function normalizeIssues(issues) {
     return issue;
   });
 }
+function resolveGitScope(repositoryRoot, scope) {
+  if (scope === "staged") return listStagedFiles(repositoryRoot);
+  if (scope === "pr") return listPrFiles(repositoryRoot);
+  const base = scope.diff === true ? void 0 : scope.diff;
+  return listDiffFiles(repositoryRoot, base);
+}
 function buildResult(startedAt, repositoryRoot, mode, capability, issues, errors, toolResults) {
   const completedAt = /* @__PURE__ */ new Date();
   return {
@@ -792,7 +980,14 @@ function formatTextSummary(result, isInspect) {
         ]);
       }
       for (const tool of unavailableTools) {
-        table.push([import_ansis.default.dim.red(tool.displayName ?? tool.toolId), "-", "-", "-", "-", tool.reason]);
+        table.push([
+          import_ansis.default.dim.red(tool.displayName ?? tool.toolId),
+          "-",
+          "-",
+          "-",
+          "-",
+          tool.reason
+        ]);
       }
       lines.push(table.toString());
     } else {
@@ -4602,7 +4797,11 @@ async function initLocalConfigBase(repositoryRoot, adapters2) {
 }
 async function initLocalConfig(repositoryRoot, adapters2) {
   const baseConfig = await initLocalConfigBase(repositoryRoot, adapters2);
-  const { config, codacyYamlApplied } = await enrichWithCodacyYaml(baseConfig, repositoryRoot, adapters2);
+  const { config, codacyYamlApplied } = await enrichWithCodacyYaml(
+    baseConfig,
+    repositoryRoot,
+    adapters2
+  );
   return { config, stats: { codacyYamlApplied } };
 }
 async function initDefaultConfig(repositoryRoot, adapters2) {
@@ -4618,7 +4817,7 @@ async function initDefaultConfig(repositoryRoot, adapters2) {
   for (const adapter of adapters2) {
     if (toolsWithLocalConfig.has(adapter.id)) continue;
     const apiTool = apiTools.find(
-      (t) => t.prefix ? t.prefix.replace(/_$/, "") === adapter.id : t.name === adapter.id
+      (t) => t.prefix ? t.prefix.replace(/_$/, "") === adapter.id : t.shortName === adapter.id
     );
     if (!apiTool) continue;
     if (!apiTool.enabledByDefault) continue;
@@ -4641,8 +4840,16 @@ async function initDefaultConfig(repositoryRoot, adapters2) {
       addedTools++;
     }
   }
-  const baseConfig = createCodacyConfig({ source: "default", languages: base.metadata.languages, tools: updatedTools });
-  const { config, codacyYamlApplied } = await enrichWithCodacyYaml(baseConfig, repositoryRoot, adapters2);
+  const baseConfig = createCodacyConfig({
+    source: "default",
+    languages: base.metadata.languages,
+    tools: updatedTools
+  });
+  const { config, codacyYamlApplied } = await enrichWithCodacyYaml(
+    baseConfig,
+    repositoryRoot,
+    adapters2
+  );
   return { config, stats: { totalApiTools: apiTools.length, addedTools, codacyYamlApplied } };
 }
 async function initRemoteConfig(repositoryRoot, provider, organization, repositoryName, adapters2, apiToken, onRemoteToolsFound, onToolProcessed) {
@@ -4711,8 +4918,15 @@ async function initRemoteConfig(repositoryRoot, provider, organization, reposito
     repositoryId: repoInfo.repositoryId != null ? String(repoInfo.repositoryId) : void 0,
     repositoryName
   });
-  const { config, codacyYamlApplied } = await enrichWithCodacyYaml(baseConfig, repositoryRoot, adapters2);
-  return { config, stats: { totalRemoteTools: remoteTools.length, matchedAdapters, codacyYamlApplied } };
+  const { config, codacyYamlApplied } = await enrichWithCodacyYaml(
+    baseConfig,
+    repositoryRoot,
+    adapters2
+  );
+  return {
+    config,
+    stats: { totalRemoteTools: remoteTools.length, matchedAdapters, codacyYamlApplied }
+  };
 }
 async function initContainerConfig(repositoryRoot, adapters2) {
   const codacyrcPath = import_path6.default.join(repositoryRoot, ".codacyrc");
@@ -4787,8 +5001,9 @@ function rotateLogFiles(logsDir, maxFiles) {
     }
   }
 }
+var fileSeq = 0;
 function fileTimestamp() {
-  return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  return `${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}-${fileSeq++}`;
 }
 function enrichMessage(message, fields) {
   if (!fields) return message;
@@ -4799,10 +5014,13 @@ function enrichMessage(message, fields) {
   if (fields.configSource) parts.push(String(fields.configSource));
   if (typeof fields.fileCount === "number") parts.push(`${fields.fileCount} files`);
   if (typeof fields.issueCount === "number") parts.push(`${fields.issueCount} issues`);
-  if (typeof fields.errorCount === "number" && fields.errorCount > 0) parts.push(`${fields.errorCount} errors`);
+  if (typeof fields.errorCount === "number" && fields.errorCount > 0)
+    parts.push(`${fields.errorCount} errors`);
   if (typeof fields.totalIssues === "number") parts.push(`${fields.totalIssues} issues`);
-  if (typeof fields.totalErrors === "number" && fields.totalErrors > 0) parts.push(`${fields.totalErrors} errors`);
-  if (typeof fields.durationMs === "number") parts.push(`${(fields.durationMs / 1e3).toFixed(1)}s`);
+  if (typeof fields.totalErrors === "number" && fields.totalErrors > 0)
+    parts.push(`${fields.totalErrors} errors`);
+  if (typeof fields.durationMs === "number")
+    parts.push(`${(fields.durationMs / 1e3).toFixed(1)}s`);
   if (fields.reason) parts.push(String(fields.reason));
   if (fields.error) parts.push(String(fields.error));
   if (typeof fields.found === "boolean") parts.push(fields.found ? "found" : "not found");
@@ -4878,6 +5096,9 @@ function createLogger(options = {}) {
   initDefaultConfig,
   initLocalConfig,
   initRemoteConfig,
+  listDiffFiles,
+  listPrFiles,
+  listStagedFiles,
   readCodacyConfig,
   readCodacyYaml,
   registerAdapter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codacy/analysis-runner",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Core orchestration engine for Codacy analysis",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,11 +12,11 @@
     "cli-table3": "^0.6",
     "minimatch": "10.2.4",
     "yaml": "^2.6.0",
-    "@codacy/tooling": "0.1.0"
+    "@codacy/tooling": "0.2.0"
   },
   "devDependencies": {
     "@codacy/openapi-typescript-codegen": "0.0.9",
-    "@codacy/tools-dummy-1": "0.1.0"
+    "@codacy/tools-dummy-1": "0.2.0"
   },
   "license": "MIT",
   "author": "Codacy <support@codacy.com> (https://www.codacy.com)",