mjolnir-qa 0.5.34 → 0.5.35

package/CHANGELOG.md

@@ -9,6 +9,12 @@ Rule behavior changes (new rules, FP-rate changes against the corpus,
 severity changes) are first-class entries here — rule IDs are immutable
 once shipped, so this file is the record of what changed between versions.
 
+## [0.5.35] — 2026-09-08
+
+### Changes since 0
+
+- P3a: GitLab CI — Code Quality report, MR recipe, exit-code discipline (#65)
+
 ## [0.5.34] — 2026-09-08
 
 ### Changes since 0

package/README.md

@@ -203,6 +203,7 @@ pinned to the `v1` major tag) by default, or plain `npx` with
 | `mjolnir forensics ./test-results/` | Runtime evidence from a real run                 |
 | `mjolnir handoff`                   | Remediation plan for a coding agent              |
 | `mjolnir --json` / `--format sarif` | Machine-readable / GitHub Code Scanning          |
+| `mjolnir --format codequality`      | GitLab Code Quality report (MR widget artifact)  |
 | `mjolnir --strict`                  | Also run quarantine-tier rules (higher FP risk)  |
 
 <details>
@@ -565,6 +566,10 @@ Or wire it into GitHub Code Scanning natively via SARIF:
     sarif_file: mjolnir.sarif
 ```
 
+On GitLab, `--format codequality` emits the Code Quality report the MR
+widget and diff annotations consume
+([docs/GITLAB-CI.md](docs/GITLAB-CI.md)).
+
 Editor and pipeline setup: [docs/SARIF-INTEGRATION.md](docs/SARIF-INTEGRATION.md).
 
 ### Changed-scope attribution
@@ -718,6 +723,7 @@ Rule IDs (`QA-<FAMILY>-NNN`) are immutable once shipped and never reused.
 | [docs/VERSIONING.md](docs/VERSIONING.md)               | Semver policy, frozen surfaces, deprecation cycle |
 | [docs/machine-contract.md](docs/machine-contract.md)   | The canonical machine-readable result             |
 | [docs/SARIF-INTEGRATION.md](docs/SARIF-INTEGRATION.md) | SARIF output + editor/CI setup                    |
+| [docs/GITLAB-CI.md](docs/GITLAB-CI.md)                 | GitLab: Code Quality report, MR recipe, gate      |
 | [docs/rules/](docs/rules/)                             | Generated per-rule catalog                        |
 | [CONTRIBUTING.md](CONTRIBUTING.md)                     | Dev setup + contribution workflow                 |
 | [SUPPORT.md](SUPPORT.md)                               | Where to ask, report and get help                 |

package/dist/cli.d.mts

@@ -565,7 +565,7 @@ interface CliArgs {
   verbose: boolean;
   maxDurationMs: number;
   scopeChanged: boolean;
-  format: "terminal" | "json" | "sarif" | "mermaid";
+  format: "terminal" | "json" | "sarif" | "mermaid" | "codequality";
   /** --width override for terminal box/gauge wrapping (Sprint 5 Task 22). */
   width?: number;
   /** --ascii / --no-ascii override for shouldUseAscii()'s heuristic. */
@@ -737,7 +737,7 @@ declare const runScan: typeof runScan$1, buildUniversalRules: typeof buildUniver
  * `scripts/sync-sarif-version.cjs` on release and guarded by
  * `tests/version-consistency.spec.ts` locally.
  */
-declare const CLI_VERSION = "0.5.34";
+declare const CLI_VERSION = "0.5.35";
 /** A usage-error detail: the offending token, when one exists. */
 interface UsageErrorDetail {
   /** The unknown flag or rejected value (e.g. `--nope`, `loud`). */

package/dist/cli.mjs

@@ -13350,7 +13350,7 @@ function renderSarif(result, repoRootUri) {
 		tool: { driver: {
 			name: "Mjölnir",
 			informationUri: "https://github.com/Sergey-Bar/Mjolnir",
-			version: "0.5.34",
+			version: "0.5.35",
 			rules: [...rules.values()].map((r) => {
 				const meta = RULES.find((x) => x.id === r.id);
 				return {
@@ -13422,6 +13422,62 @@ function renderSarif(result, repoRootUri) {
 	return JSON.stringify(sarif, null, 2);
 }
 //#endregion
+//#region src/reporter/codequality.ts
+/**
+* GitLab Code Quality reporter (product-gap-remediation master plan P3a,
+* plan 1788853205786 — flag 2, decision 2: GitLab is the in-plan second
+* platform).
+*
+* Emits the Code Quality report schema GitLab's `codequality` artifact
+* type consumes (docs.gitlab.com/ee/ci/testing/code_quality.html) so
+* findings render as MR widgets and diff annotations inside existing
+* governance — the same distribution logic as SARIF for GitHub, never a
+* second truth: this is a deterministic projection of the same
+* ScanResult the JSON contract carries.
+*
+* Usage: mjolnir --format codequality > gl-code-quality-report.json
+*
+* Severity map (documented in docs/GITLAB-CI.md):
+*   error   → major   (categorical defects — the gate's core)
+*   warning → minor
+*   info    → info
+*
+* Fingerprint stability: GitLab deduplicates MR findings across runs by
+* `fingerprint` — an unstable fingerprint would resurrect closed
+* findings on every push (the exact PR-noise the MR flow exists to
+* avoid). The fingerprint is sha256 over ruleId + repo-relative path +
+* line + column + message — the same finding shape the --why command
+* addresses, so a moved line legitimately re-reports and an unchanged
+* finding stays silent.
+*/
+function codeQualitySeverity(severity) {
+	if (severity === "error") return "major";
+	if (severity === "warning") return "minor";
+	return "info";
+}
+/**
+* sha256 hex over the identifying tuple. Exported for the contract test:
+* the fingerprint MUST be stable across runs for an unchanged finding
+* (GitLab dedup contract) and MUST change when the finding's identity
+* changes (otherwise an MR could hide a moved-and-still-broken line).
+*/
+function codeQualityFingerprint(f) {
+	return createHash("sha256").update(`${f.ruleId}\u0000${f.file}\u0000${f.line}\u0000${f.column}\u0000${f.message}`).digest("hex");
+}
+function renderCodeQuality(result) {
+	const issues = result.findings.map((f) => ({
+		description: f.message,
+		check_name: f.ruleId,
+		fingerprint: codeQualityFingerprint(f),
+		severity: codeQualitySeverity(f.severity),
+		location: {
+			path: f.file.replaceAll("\\", "/"),
+			lines: { begin: f.line }
+		}
+	}));
+	return JSON.stringify(issues, null, 2) + "\n";
+}
+//#endregion
 //#region src/reporter/mermaid.ts
 function sanitizeId(raw) {
 	return raw.replace(/[^a-z0-9]/gi, "_");
@@ -16384,6 +16440,10 @@ const HELP_FLAGS = [
 		flag: "--format sarif",
 		summary: "SARIF 2.1 for GitHub Code Scanning"
 	},
+	{
+		flag: "--format codequality",
+		summary: "GitLab Code Quality report (MR widget artifact)"
+	},
 	{
 		flag: "--format mermaid",
 		summary: "test-architecture diagram"
@@ -18848,7 +18908,7 @@ const { runScan, buildUniversalRules, fallbackWorkspace, pathMatchesGlob, isVali
 * `scripts/sync-sarif-version.cjs` on release and guarded by
 * `tests/version-consistency.spec.ts` locally.
 */
-const CLI_VERSION = "0.5.34";
+const CLI_VERSION = "0.5.35";
 function parseArgs(argv, onError) {
 	const args = {
 		target: ".",
@@ -18871,6 +18931,7 @@ function parseArgs(argv, onError) {
 			const fmt = argv[++i];
 			if (fmt === "sarif") args.format = "sarif";
 			else if (fmt === "mermaid") args.format = "mermaid";
+			else if (fmt === "codequality") args.format = "codequality";
 			else if (fmt === "json") {
 				args.format = "json";
 				args.json = true;
@@ -19255,6 +19316,7 @@ async function runScanCommand(argv, io = {
 		}
 		if (args.format === "sarif") io.out(renderSarif(result, pathToFileURL(target).href));
 		else if (args.format === "mermaid") io.out(renderMermaid(result));
+		else if (args.format === "codequality") io.out(renderCodeQuality(result));
 		else if (args.json) io.out(JSON.stringify({
 			...result,
 			contract: buildMachineContract(result)

package/dist/mcp/stdio.mjs

@@ -13349,7 +13349,7 @@ function renderSarif(result, repoRootUri) {
 		tool: { driver: {
 			name: "Mjölnir",
 			informationUri: "https://github.com/Sergey-Bar/Mjolnir",
-			version: "0.5.34",
+			version: "0.5.35",
 			rules: [...rules.values()].map((r) => {
 				const meta = RULES.find((x) => x.id === r.id);
 				return {
@@ -13421,6 +13421,62 @@ function renderSarif(result, repoRootUri) {
 	return JSON.stringify(sarif, null, 2);
 }
 //#endregion
+//#region src/reporter/codequality.ts
+/**
+* GitLab Code Quality reporter (product-gap-remediation master plan P3a,
+* plan 1788853205786 — flag 2, decision 2: GitLab is the in-plan second
+* platform).
+*
+* Emits the Code Quality report schema GitLab's `codequality` artifact
+* type consumes (docs.gitlab.com/ee/ci/testing/code_quality.html) so
+* findings render as MR widgets and diff annotations inside existing
+* governance — the same distribution logic as SARIF for GitHub, never a
+* second truth: this is a deterministic projection of the same
+* ScanResult the JSON contract carries.
+*
+* Usage: mjolnir --format codequality > gl-code-quality-report.json
+*
+* Severity map (documented in docs/GITLAB-CI.md):
+*   error   → major   (categorical defects — the gate's core)
+*   warning → minor
+*   info    → info
+*
+* Fingerprint stability: GitLab deduplicates MR findings across runs by
+* `fingerprint` — an unstable fingerprint would resurrect closed
+* findings on every push (the exact PR-noise the MR flow exists to
+* avoid). The fingerprint is sha256 over ruleId + repo-relative path +
+* line + column + message — the same finding shape the --why command
+* addresses, so a moved line legitimately re-reports and an unchanged
+* finding stays silent.
+*/
+function codeQualitySeverity(severity) {
+	if (severity === "error") return "major";
+	if (severity === "warning") return "minor";
+	return "info";
+}
+/**
+* sha256 hex over the identifying tuple. Exported for the contract test:
+* the fingerprint MUST be stable across runs for an unchanged finding
+* (GitLab dedup contract) and MUST change when the finding's identity
+* changes (otherwise an MR could hide a moved-and-still-broken line).
+*/
+function codeQualityFingerprint(f) {
+	return createHash("sha256").update(`${f.ruleId}\u0000${f.file}\u0000${f.line}\u0000${f.column}\u0000${f.message}`).digest("hex");
+}
+function renderCodeQuality(result) {
+	const issues = result.findings.map((f) => ({
+		description: f.message,
+		check_name: f.ruleId,
+		fingerprint: codeQualityFingerprint(f),
+		severity: codeQualitySeverity(f.severity),
+		location: {
+			path: f.file.replaceAll("\\", "/"),
+			lines: { begin: f.line }
+		}
+	}));
+	return JSON.stringify(issues, null, 2) + "\n";
+}
+//#endregion
 //#region src/reporter/mermaid.ts
 function sanitizeId(raw) {
 	return raw.replace(/[^a-z0-9]/gi, "_");
@@ -15575,6 +15631,10 @@ const HELP_FLAGS = [
 		flag: "--format sarif",
 		summary: "SARIF 2.1 for GitHub Code Scanning"
 	},
+	{
+		flag: "--format codequality",
+		summary: "GitLab Code Quality report (MR widget artifact)"
+	},
 	{
 		flag: "--format mermaid",
 		summary: "test-architecture diagram"
@@ -18484,7 +18544,7 @@ const { runScan, buildUniversalRules, fallbackWorkspace, pathMatchesGlob, isVali
 * `scripts/sync-sarif-version.cjs` on release and guarded by
 * `tests/version-consistency.spec.ts` locally.
 */
-const CLI_VERSION = "0.5.34";
+const CLI_VERSION = "0.5.35";
 function parseArgs(argv, onError) {
 	const args = {
 		target: ".",
@@ -18507,6 +18567,7 @@ function parseArgs(argv, onError) {
 			const fmt = argv[++i];
 			if (fmt === "sarif") args.format = "sarif";
 			else if (fmt === "mermaid") args.format = "mermaid";
+			else if (fmt === "codequality") args.format = "codequality";
 			else if (fmt === "json") {
 				args.format = "json";
 				args.json = true;
@@ -18891,6 +18952,7 @@ async function runScanCommand(argv, io = {
 		}
 		if (args.format === "sarif") io.out(renderSarif(result, pathToFileURL(target).href));
 		else if (args.format === "mermaid") io.out(renderMermaid(result));
+		else if (args.format === "codequality") io.out(renderCodeQuality(result));
 		else if (args.json) io.out(JSON.stringify({
 			...result,
 			contract: buildMachineContract(result)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mjolnir-qa",
-  "version": "0.5.34",
+  "version": "0.5.35",
   "description": "Mjölnir — the Verification Trust Engine for QA. Audits test suites and CI pipelines, reports a worthiness score and prioritized findings.",
   "type": "module",
   "engines": {