qualink 0.5.0 → 0.6.1

package/README.md

@@ -110,7 +110,7 @@ qualink collect <collector> --input <path> --sink elastic [flags]
 ```bash
 qualink collect eslint --input eslint-report.json --sink elastic --repo frontend-mono --category frontend --tags frontend,web
 qualink collect sarif --input analyzers.sarif --sink elastic --repo backend-api --category backend --tags backend,api
-qualink collect coverage-dotnet --input coverage.cobertura.xml --sink elastic --repo backend-api
+qualink collect coverage-cobertura --input coverage.cobertura.xml --sink elastic --repo backend-api
 ```
 
 ### Multi-collect
@@ -160,7 +160,7 @@ Collectors:
 - `lighthouse` (Lighthouse JSON)
 - `coverage-js` (Istanbul/Vitest JSON)
 - `sarif` (Roslyn or generic SARIF JSON)
-- `coverage-dotnet` (Cobertura/OpenCover XML)
+- `coverage-cobertura` (Cobertura/OpenCover XML)
 - `junit` (JUnit XML)
 
 ESLint file-level options (optional):

package/dist/cli/command-factory.js

@@ -1,4 +1,6 @@
+import { stat } from "node:fs/promises";
 import { defineCommand } from "citty";
+import { formatBytes } from "../utils/format.js";
 import { CliError } from "./cli-error.js";
 import { commonArgs, isDryRun } from "./common-args.js";
 import { parseCommonMetadata } from "./parse-metadata.js";
@@ -16,6 +18,11 @@ export function createCollectorCommand(config) {
         async run({ args }) {
             try {
                 const parsedArgs = args;
+                const inputPath = typeof parsedArgs.input === "string" ? parsedArgs.input : undefined;
+                if (inputPath) {
+                    const fileStat = await stat(inputPath);
+                    process.stderr.write(`  read: ${inputPath} (${formatBytes(fileStat.size)})\n`);
+                }
                 const metadata = parseCommonMetadata(parsedArgs);
                 const { metricType, documents } = await config.collect(parsedArgs, metadata);
                 await sendToSink(metricType, parsedArgs, documents);

package/dist/cli/commands/{coverage-dotnet.d.ts → coverage-cobertura.d.ts}

@@ -1,4 +1,4 @@
-export declare const coverageDotnetCommand: import("citty").CommandDef<{
+export declare const coverageCoberturaCommand: import("citty").CommandDef<{
     readonly input: {
         readonly type: "string";
         readonly required: true;

package/dist/cli/commands/coverage-cobertura.js

@@ -0,0 +1,12 @@
+import { collectCoverageCobertura } from "../../collectors/coverage-cobertura.js";
+import { createCollectorCommand } from "../command-factory.js";
+import { loadTextInput } from "../load-input.js";
+export const coverageCoberturaCommand = createCollectorCommand({
+    name: "coverage-cobertura",
+    description: "Collect Cobertura XML coverage metrics and relay them",
+    async collect(args, metadata) {
+        const input = await loadTextInput(args);
+        const documents = collectCoverageCobertura(input, metadata);
+        return { metricType: "coverage-cobertura", documents };
+    },
+});

package/dist/cli/commands/index.d.ts

@@ -1,5 +1,5 @@
 export { biomeCommand } from "./biome.js";
-export { coverageDotnetCommand } from "./coverage-dotnet.js";
+export { coverageCoberturaCommand } from "./coverage-cobertura.js";
 export { coverageJsCommand } from "./coverage-js.js";
 export { eslintCommand } from "./eslint.js";
 export { junitCommand } from "./junit.js";

package/dist/cli/commands/index.js

@@ -1,5 +1,5 @@
 export { biomeCommand } from "./biome.js";
-export { coverageDotnetCommand } from "./coverage-dotnet.js";
+export { coverageCoberturaCommand } from "./coverage-cobertura.js";
 export { coverageJsCommand } from "./coverage-js.js";
 export { eslintCommand } from "./eslint.js";
 export { junitCommand } from "./junit.js";

package/dist/cli/index.js

@@ -1,6 +1,7 @@
+import { relative } from "node:path";
 import { defineCommand, runMain } from "citty";
 import { CliError } from "./cli-error.js";
-import { biomeCommand, coverageDotnetCommand, coverageJsCommand, eslintCommand, junitCommand, lighthouseCommand, metaCommand, pipelineCommand, sarifCommand, } from "./commands/index.js";
+import { biomeCommand, coverageCoberturaCommand, coverageJsCommand, eslintCommand, junitCommand, lighthouseCommand, metaCommand, pipelineCommand, sarifCommand, } from "./commands/index.js";
 import { commonArgs, isDryRun } from "./common-args.js";
 import { parseConfig, resolveConfig } from "./multi-collect/config.js";
 import { discoverFiles } from "./multi-collect/discover.js";
@@ -32,7 +33,7 @@ const collectCommand = defineCommand({
         lighthouse: lighthouseCommand,
         "coverage-js": coverageJsCommand,
         sarif: sarifCommand,
-        "coverage-dotnet": coverageDotnetCommand,
+        "coverage-cobertura": coverageCoberturaCommand,
         junit: junitCommand,
     },
     async run({ args }) {
@@ -54,6 +55,11 @@ const collectCommand = defineCommand({
 async function runDirMode(dir, args) {
     const metadata = parseCommonMetadata(args);
     const discovered = await discoverFiles(dir);
+    for (const [collectorKey, files] of discovered) {
+        for (const filePath of files) {
+            process.stderr.write(`  scan: ${relative(dir, filePath)} → ${collectorKey}\n`);
+        }
+    }
     const accumulated = new Map();
     const counts = new Map();
     for (const [collectorKey, files] of discovered) {
@@ -78,6 +84,11 @@ async function runConfigMode(configValue, args) {
     const metadata = parseCommonMetadata(args);
     const entries = await parseConfig(configValue);
     const resolved = await resolveConfig(entries, ".");
+    for (const entry of resolved) {
+        for (const filePath of entry.files) {
+            process.stderr.write(`  scan: ${filePath} → ${entry.type}\n`);
+        }
+    }
     const accumulated = new Map();
     const counts = new Map();
     for (const entry of resolved) {

package/dist/cli/multi-collect/patterns.d.ts

@@ -1,5 +1,5 @@
 import type { MetricType } from "../../types.js";
-export type CollectorKey = Extract<MetricType, "eslint" | "biome" | "coverage-js" | "coverage-dotnet" | "sarif" | "lighthouse" | "junit">;
+export type CollectorKey = Extract<MetricType, "eslint" | "biome" | "coverage-js" | "coverage-cobertura" | "sarif" | "lighthouse" | "junit">;
 export declare const COLLECTOR_KEYS: readonly CollectorKey[];
 export interface FilePattern {
     /** Match against basename only */

package/dist/cli/multi-collect/patterns.js

@@ -2,7 +2,7 @@ export const COLLECTOR_KEYS = [
     "eslint",
     "biome",
     "coverage-js",
-    "coverage-dotnet",
+    "coverage-cobertura",
     "sarif",
     "lighthouse",
     "junit",
@@ -11,7 +11,7 @@ export const COLLECTOR_PATTERNS = {
     eslint: [{ basename: "eslint-report.json" }],
     biome: [{ basename: "biome-report.json" }],
     "coverage-js": [{ basename: "coverage-summary.json" }],
-    "coverage-dotnet": [
+    "coverage-cobertura": [
         { basename: "coverage.cobertura.xml" },
         { basename: "cobertura-coverage.xml" },
     ],

package/dist/cli/multi-collect/resolve-metadata.js

@@ -116,7 +116,7 @@ export function resolveFileMetadata(filePath, collectorKey) {
     const stopAt = gitRoot ?? fileDir;
     const overrides = {};
     // Detect project name
-    if (collectorKey === "coverage-dotnet" || collectorKey === "sarif") {
+    if (collectorKey === "coverage-cobertura" || collectorKey === "sarif") {
         overrides.projectName = findNearestProjectName(fileDir, stopAt) ?? null;
     }
     else {

package/dist/cli/multi-collect/run-collector.js

@@ -1,5 +1,5 @@
 import { collectBiome } from "../../collectors/biome.js";
-import { collectCoverageDotnet } from "../../collectors/coverage-dotnet.js";
+import { collectCoverageCobertura } from "../../collectors/coverage-cobertura.js";
 import { collectCoverageJs } from "../../collectors/coverage-js.js";
 import { collectEslint } from "../../collectors/eslint.js";
 import { collectJunit } from "../../collectors/junit.js";
@@ -53,10 +53,10 @@ export async function runCollector(key, filePath, metadata, urlOverride) {
             const documents = collectCoverageJs(input, metadata);
             return { metricType: "coverage-js", documents };
         }
-        case "coverage-dotnet": {
+        case "coverage-cobertura": {
             const input = await readTextFile(filePath);
-            const documents = collectCoverageDotnet(input, metadata);
-            return { metricType: "coverage-dotnet", documents };
+            const documents = collectCoverageCobertura(input, metadata);
+            return { metricType: "coverage-cobertura", documents };
         }
         case "sarif": {
             const input = await readJsonFile(filePath);

package/dist/cli/send-to-sink.js

@@ -1,3 +1,4 @@
+import { INDEX_BY_TYPE } from "../sinks/elastic.js";
 import { createSink } from "../sinks/index.js";
 import { CliError } from "./cli-error.js";
 import { argValue, envOrArg, isDryRun } from "./common-args.js";
@@ -65,8 +66,22 @@ export async function sendToSink(metricType, args, documents) {
         sinkConfig = sinkConfigBase;
     }
     const sink = createSink(sinkConfig);
-    await sink.send({
+    const { durationMs } = await sink.send({
         metricType,
         documents,
     });
+    const count = documents.length;
+    const ms = Math.round(durationMs);
+    if (sinkKind === "elastic") {
+        const index = INDEX_BY_TYPE[metricType];
+        const url = sinkConfig.elasticUrl ?? "";
+        process.stderr.write(`  sent: ${count} document(s) → elastic ${index} (${url}) ${ms}ms\n`);
+    }
+    else if (sinkKind === "loki") {
+        const url = sinkConfig.lokiUrl ?? "";
+        process.stderr.write(`  sent: ${count} document(s) → loki (${url}) ${ms}ms\n`);
+    }
+    else {
+        process.stderr.write(`  sent: ${count} document(s) → stdout\n`);
+    }
 }

package/dist/collectors/coverage-cobertura.d.ts

@@ -0,0 +1,2 @@
+import type { CoberturaCoverageMetricDocument, CommonMetadata } from "../types.js";
+export declare function collectCoverageCobertura(xmlInput: string, metadata: CommonMetadata): CoberturaCoverageMetricDocument[];

package/dist/collectors/{coverage-dotnet.js → coverage-cobertura.js}

@@ -39,7 +39,7 @@ function parseOpenCover(root) {
         branchesCovered: readNumber(summary, "@_visitedBranchPoints"),
     };
 }
-export function collectCoverageDotnet(xmlInput, metadata) {
+export function collectCoverageCobertura(xmlInput, metadata) {
     const parser = new XMLParser({
         ignoreAttributes: false,
         attributeNamePrefix: "@_",
@@ -76,8 +76,8 @@ export function collectCoverageDotnet(xmlInput, metadata) {
     const functionsCovered = 0;
     const doc = {
         ...baseDocument({
-            metricType: "coverage-dotnet",
-            tool: "dotnet-test",
+            metricType: "coverage-cobertura",
+            tool: "cobertura",
             languages: ["csharp"],
             metadata,
         }),

package/dist/collectors/index.d.ts

@@ -1,5 +1,5 @@
 export { collectBiome } from "./biome.js";
-export { collectCoverageDotnet } from "./coverage-dotnet.js";
+export { collectCoverageCobertura } from "./coverage-cobertura.js";
 export { collectCoverageJs } from "./coverage-js.js";
 export { collectEslint } from "./eslint.js";
 export { collectLighthouse } from "./lighthouse.js";

package/dist/collectors/index.js

@@ -1,5 +1,5 @@
 export { collectBiome } from "./biome.js";
-export { collectCoverageDotnet } from "./coverage-dotnet.js";
+export { collectCoverageCobertura } from "./coverage-cobertura.js";
 export { collectCoverageJs } from "./coverage-js.js";
 export { collectEslint } from "./eslint.js";
 export { collectLighthouse } from "./lighthouse.js";

package/dist/sinks/elastic.d.ts

@@ -1,11 +1,12 @@
-import type { NormalizedDocument } from "../types.js";
-import type { SendInput, Sink } from "./types.js";
+import type { MetricType, NormalizedDocument } from "../types.js";
+import type { SendInput, SendResult, Sink } from "./types.js";
 interface ElasticSinkOptions {
     url: string;
     apiKey: string;
     retryMax: number;
     retryBackoffMs: number;
 }
+export declare const INDEX_BY_TYPE: Record<MetricType, string>;
 export declare function buildBulkBody(indexName: string, documents: NormalizedDocument[]): string;
 export declare class ElasticSink implements Sink {
     private readonly url;
@@ -13,6 +14,6 @@ export declare class ElasticSink implements Sink {
     private readonly retryMax;
     private readonly retryBackoffMs;
     constructor(options: ElasticSinkOptions);
-    send(input: SendInput): Promise<void>;
+    send(input: SendInput): Promise<SendResult>;
 }
 export {};

package/dist/sinks/elastic.js

@@ -1,11 +1,11 @@
 import { isRecord } from "../utils/guards.js";
-const INDEX_BY_TYPE = {
+export const INDEX_BY_TYPE = {
     biome: "codequality-biome",
     eslint: "codequality-eslint",
     lighthouse: "codequality-lighthouse",
     "coverage-js": "codequality-coverage-js",
     sarif: "codequality-sarif",
-    "coverage-dotnet": "codequality-coverage-dotnet",
+    "coverage-cobertura": "codequality-coverage-cobertura",
     junit: "codequality-junit",
     meta: "codequality-meta",
     pipeline: "codequality-pipeline",
@@ -63,8 +63,9 @@ export class ElasticSink {
     }
     async send(input) {
         if (input.documents.length === 0) {
-            return;
+            return { durationMs: 0 };
         }
+        const start = performance.now();
         const indexName = INDEX_BY_TYPE[input.metricType];
         let documents = input.documents;
         let attempt = 0;
@@ -99,7 +100,7 @@ export class ElasticSink {
                     if (nonRetryableErrors.length > 0) {
                         throw new Error(`Elastic bulk request completed with ${nonRetryableErrors.length} non-retryable item error(s)`);
                     }
-                    return;
+                    return { durationMs: performance.now() - start };
                 }
                 if (attempt > this.retryMax) {
                     const deadLetterBody = buildBulkBody(indexName, retryable);
@@ -110,7 +111,7 @@ export class ElasticSink {
                 await sleep(this.retryBackoffMs * attempt);
                 continue;
             }
-            return;
+            return { durationMs: performance.now() - start };
         }
     }
 }

package/dist/sinks/loki.d.ts

@@ -1,5 +1,5 @@
 import type { NormalizedDocument } from "../types.js";
-import type { SendInput, Sink } from "./types.js";
+import type { SendInput, SendResult, Sink } from "./types.js";
 export interface LokiSinkOptions {
     url: string;
     username?: string | undefined;
@@ -25,6 +25,6 @@ export declare class LokiSink implements Sink {
     private readonly retryMax;
     private readonly retryBackoffMs;
     constructor(options: LokiSinkOptions);
-    send(input: SendInput): Promise<void>;
+    send(input: SendInput): Promise<SendResult>;
 }
 export {};

package/dist/sinks/loki.js

@@ -48,8 +48,9 @@ export class LokiSink {
     }
     async send(input) {
         if (input.documents.length === 0) {
-            return;
+            return { durationMs: 0 };
         }
+        const start = performance.now();
         const payload = buildLokiPayload(input.documents);
         const body = JSON.stringify(payload);
         const headers = {
@@ -71,7 +72,7 @@ export class LokiSink {
                 body,
             });
             if (response.status === 204 || response.ok) {
-                return;
+                return { durationMs: performance.now() - start };
             }
             const responseText = await response.text();
             if (!isRetryableStatus(response.status) || attempt > this.retryMax) {

package/dist/sinks/stdout.d.ts

@@ -1,4 +1,4 @@
-import type { SendInput, Sink } from "./types.js";
+import type { SendInput, SendResult, Sink } from "./types.js";
 export declare class StdoutSink implements Sink {
-    send(input: SendInput): Promise<void>;
+    send(input: SendInput): Promise<SendResult>;
 }

package/dist/sinks/stdout.js

@@ -6,5 +6,6 @@ export class StdoutSink {
             documents: input.documents,
         };
         process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+        return { durationMs: 0 };
     }
 }

package/dist/sinks/types.d.ts

@@ -3,6 +3,9 @@ export interface SendInput {
     metricType: MetricType;
     documents: NormalizedDocument[];
 }
+export interface SendResult {
+    durationMs: number;
+}
 export interface Sink {
-    send(input: SendInput): Promise<void>;
+    send(input: SendInput): Promise<SendResult>;
 }

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 export type Language = "js" | "ts" | "csharp" | (string & {});
 export type Environment = "dev" | "test" | "prod" | "ci";
-export type MetricType = "biome" | "eslint" | "lighthouse" | "coverage-js" | "sarif" | "coverage-dotnet" | "junit" | "meta" | "pipeline";
+export type MetricType = "biome" | "eslint" | "lighthouse" | "coverage-js" | "sarif" | "coverage-cobertura" | "junit" | "meta" | "pipeline";
 export interface BaseMetricDocument {
     "@timestamp": string;
     metric_type: MetricType;
@@ -102,8 +102,8 @@ export interface BiomeFileIssue {
     fixable_errors: number;
     fixable_warnings: number;
 }
-export interface DotnetCoverageMetricDocument extends CoverageMetricDocument {
-    metric_type: "coverage-dotnet";
+export interface CoberturaCoverageMetricDocument extends CoverageMetricDocument {
+    metric_type: "coverage-cobertura";
     coverage_format: "cobertura" | "opencover" | (string & {});
 }
 export interface JunitMetricDocument extends BaseMetricDocument {
@@ -128,7 +128,7 @@ export interface PipelineMetricDocument extends BaseMetricDocument {
     start_time: string | null;
     stage_name: string | null;
 }
-export type NormalizedDocument = BiomeMetricDocument | EslintMetricDocument | LighthouseMetricDocument | CoverageJsMetricDocument | SarifMetricDocument | DotnetCoverageMetricDocument | JunitMetricDocument | MetaMetricDocument | PipelineMetricDocument;
+export type NormalizedDocument = BiomeMetricDocument | EslintMetricDocument | LighthouseMetricDocument | CoverageJsMetricDocument | SarifMetricDocument | CoberturaCoverageMetricDocument | JunitMetricDocument | MetaMetricDocument | PipelineMetricDocument;
 export interface CommonMetadata {
     repo: string;
     category: string | null;

package/dist/utils/format.d.ts

@@ -0,0 +1 @@
+export declare function formatBytes(bytes: number): string;

package/dist/utils/format.js

@@ -0,0 +1,11 @@
+const UNITS = ["B", "kB", "MB", "GB"];
+export function formatBytes(bytes) {
+    let value = bytes;
+    let unitIndex = 0;
+    while (value >= 1000 && unitIndex < UNITS.length - 1) {
+        value /= 1000;
+        unitIndex++;
+    }
+    const formatted = unitIndex === 0 ? value.toString() : value.toFixed(1).replace(/\.0$/, "");
+    return `${formatted} ${UNITS[unitIndex]}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qualink",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Collect, normalize, and relay code quality metrics from CI",
   "license": "MIT",
   "type": "module",
@@ -17,17 +17,17 @@
     "node": ">=22"
   },
   "dependencies": {
-    "citty": "^0.2.1",
-    "fast-xml-parser": "^5.4.2"
+    "citty": "^0.2.2",
+    "fast-xml-parser": "^5.7.3"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.5",
-    "@types/node": "^25.3.3",
-    "@vitest/coverage-v8": "^4.0.18",
-    "git-cliff": "^2.12.0",
+    "@biomejs/biome": "^2.4.14",
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "git-cliff": "^2.13.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   },
   "repository": {
     "type": "git",

package/dist/cli/commands/coverage-dotnet.js

@@ -1,12 +0,0 @@
-import { collectCoverageDotnet } from "../../collectors/coverage-dotnet.js";
-import { createCollectorCommand } from "../command-factory.js";
-import { loadTextInput } from "../load-input.js";
-export const coverageDotnetCommand = createCollectorCommand({
-    name: "coverage-dotnet",
-    description: "Collect .NET coverage metrics and relay them",
-    async collect(args, metadata) {
-        const input = await loadTextInput(args);
-        const documents = collectCoverageDotnet(input, metadata);
-        return { metricType: "coverage-dotnet", documents };
-    },
-});

package/dist/collectors/coverage-dotnet.d.ts

@@ -1,2 +0,0 @@
-import type { CommonMetadata, DotnetCoverageMetricDocument } from "../types.js";
-export declare function collectCoverageDotnet(xmlInput: string, metadata: CommonMetadata): DotnetCoverageMetricDocument[];