@shrkcrft/quality-gates 0.1.0-alpha.18 → 0.1.0-alpha.20

package/dist/gates/arch-gate.d.ts

@@ -1,8 +1,19 @@
+import type { IArchGateOptions } from '../schema/arch-gate-options.js';
 import type { IGateResult } from '../schema/quality-gate.js';
 /**
- * Architecture-guard gate. Pass when zero error-severity violations.
- * Warnings (fat barrels, 2-node cycles, adapter leaks) are reported
- * as `warn` — the gate doesn't fail, but the human sees them.
+ * Architecture-guard gate.
+ *
+ * When a frozen baseline exists and `baselineRelative` is not disabled (the
+ * DEFAULT), the gate fails only on NEW architecture errors — violations absent
+ * from the baseline — and surfaces the total pre-existing debt as informational.
+ * This stops the gate from being a perpetual red on baseline debt the current
+ * diff never introduced (an agent learns to ignore a gate that's always red).
+ *
+ * When no baseline is frozen (or `baselineRelative: false`), it preserves the
+ * legacy behavior — fail on ANY error — so nothing regresses for projects that
+ * never opted in, and a clean-tree CI demand stays expressible.
+ *
+ * Warnings never fail the gate; they are reported as `warn`.
  */
-export declare function archGate(projectRoot: string): IGateResult;
+export declare function archGate(projectRoot: string, options?: IArchGateOptions): IGateResult;
 //# sourceMappingURL=arch-gate.d.ts.map

package/dist/gates/arch-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arch-gate.d.ts","sourceRoot":"","sources":["../../src/gates/arch-gate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAgDzD"}
+{"version":3,"file":"arch-gate.d.ts","sourceRoot":"","sources":["../../src/gates/arch-gate.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,WAAW,CA6FzF"}

package/dist/gates/arch-gate.js

@@ -1,10 +1,20 @@
-import { runArchCheck } from '@shrkcrft/architecture-guard';
+import { ArchReportStore, diffSnapshots, runArchCheck, snapshotFromReport, violationId, } from '@shrkcrft/architecture-guard';
 /**
- * Architecture-guard gate. Pass when zero error-severity violations.
- * Warnings (fat barrels, 2-node cycles, adapter leaks) are reported
- * as `warn` — the gate doesn't fail, but the human sees them.
+ * Architecture-guard gate.
+ *
+ * When a frozen baseline exists and `baselineRelative` is not disabled (the
+ * DEFAULT), the gate fails only on NEW architecture errors — violations absent
+ * from the baseline — and surfaces the total pre-existing debt as informational.
+ * This stops the gate from being a perpetual red on baseline debt the current
+ * diff never introduced (an agent learns to ignore a gate that's always red).
+ *
+ * When no baseline is frozen (or `baselineRelative: false`), it preserves the
+ * legacy behavior — fail on ANY error — so nothing regresses for projects that
+ * never opted in, and a clean-tree CI demand stays expressible.
+ *
+ * Warnings never fail the gate; they are reported as `warn`.
  */
-export function archGate(projectRoot) {
+export function archGate(projectRoot, options = {}) {
     const start = Date.now();
     const report = runArchCheck({ projectRoot });
     if (report.diagnostics.some((d) => d.includes('code-graph store missing'))) {
@@ -19,18 +29,58 @@ export function archGate(projectRoot) {
     }
     const errors = report.countsBySeverity.error;
     const warnings = report.countsBySeverity.warning;
+    const baseline = options.baselineRelative === false ? undefined : new ArchReportStore(projectRoot).readBaseline();
+    if (baseline) {
+        const current = snapshotFromReport(report);
+        const delta = diffSnapshots(baseline, current);
+        const newIds = new Set(delta.newViolationIds);
+        const newViolations = report.violations.filter((v) => newIds.has(violationId(v)));
+        const newErrors = newViolations.filter((v) => v.severity === 'error').length;
+        const newWarnings = newViolations.filter((v) => v.severity === 'warning').length;
+        const baselineErrors = baseline.countsBySeverity.error;
+        if (newErrors > 0) {
+            return {
+                id: 'arch',
+                label: 'Architecture',
+                status: 'fail',
+                message: `${newErrors} NEW architecture error(s) since baseline (baseline debt: ${baselineErrors}, informational).`,
+                details: { newErrors, newWarnings, baselineErrors, totalErrors: errors, newViolationIds: delta.newViolationIds },
+                nextCommands: ['shrk arch check', 'shrk arch baseline show'],
+                durationMs: Date.now() - start,
+            };
+        }
+        if (newWarnings > 0) {
+            return {
+                id: 'arch',
+                label: 'Architecture',
+                status: 'warn',
+                message: `${newWarnings} new architecture warning(s) since baseline (baseline debt: ${baselineErrors} error(s), informational).`,
+                details: { newWarnings, baselineErrors, totalErrors: errors, totalWarnings: warnings },
+                nextCommands: ['shrk arch check'],
+                durationMs: Date.now() - start,
+            };
+        }
+        return {
+            id: 'arch',
+            label: 'Architecture',
+            status: 'pass',
+            message: errors > 0
+                ? `No NEW architecture violations (baseline debt: ${baselineErrors} error(s), informational).`
+                : 'No architecture violations.',
+            details: { baselineErrors, totalErrors: errors },
+            durationMs: Date.now() - start,
+        };
+    }
+    // No baseline (or baseline-relative disabled): fail on any error (legacy), but
+    // hint how to opt into NEW-only gating.
     if (errors > 0) {
         return {
             id: 'arch',
             label: 'Architecture',
             status: 'fail',
             message: `${errors} architecture error(s).`,
-            details: {
-                errors,
-                warnings,
-                kinds: report.countsByKind,
-            },
-            nextCommands: ['shrk arch check'],
+            details: { errors, warnings, kinds: report.countsByKind },
+            nextCommands: ['shrk arch check', 'shrk arch baseline write'],
             durationMs: Date.now() - start,
         };
     }

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './schema/quality-gate.js';
+export * from './schema/arch-gate-options.js';
 export * from './gates/graph-fresh-gate.js';
 export * from './gates/arch-gate.js';
 export * from './gates/impact-gate.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./schema/quality-gate.js";
+export * from "./schema/arch-gate-options.js";
 export * from "./gates/graph-fresh-gate.js";
 export * from "./gates/arch-gate.js";
 export * from "./gates/impact-gate.js";

package/dist/runner/run-gates.d.ts

@@ -1,4 +1,5 @@
 import { type IApiDiffGateOptions } from '../gates/api-diff-gate.js';
+import type { IArchGateOptions } from '../schema/arch-gate-options.js';
 import { type IGraphCyclesGateOptions } from '../gates/graph-cycles-gate.js';
 import { type IGraphUnresolvedGateOptions } from '../gates/graph-unresolved-gate.js';
 import { type IImpactGateOptions } from '../gates/impact-gate.js';
@@ -8,6 +9,8 @@ import { type IStructuralPatternsGateOptions } from '../gates/structural-pattern
 import { type IQualityGateReport } from '../schema/quality-gate.js';
 export interface IRunGatesOptions {
     projectRoot: string;
+    /** Optional architecture-gate config (baseline-relative toggle). */
+    arch?: IArchGateOptions;
     /** Optional impact-gate config (sinceRef, failOn). */
     impact?: IImpactGateOptions;
     /**

package/dist/runner/run-gates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-gates.d.ts","sourceRoot":"","sources":["../../src/runner/run-gates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAElF,OAAO,EAAmB,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE9F,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,yCAAyC;IACzC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,6CAA6C;IAC7C,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,4CAA4C;IAC5C,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,8BAA8B,CAAC;IACpD,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,oCAAoC;IACpC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,kBAAkB,CAkD7E"}
+{"version":3,"file":"run-gates.d.ts","sourceRoot":"","sources":["../../src/runner/run-gates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAElF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAmB,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE9F,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,sDAAsD;IACtD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,yCAAyC;IACzC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,6CAA6C;IAC7C,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,4CAA4C;IAC5C,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,8BAA8B,CAAC;IACpD,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,oCAAoC;IACpC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,kBAAkB,CAkD7E"}

package/dist/runner/run-gates.js

@@ -40,7 +40,7 @@ export function runQualityGates(options) {
         gates.push(graphFreshGate(options.projectRoot));
     }
     if (!disabled.has('arch')) {
-        gates.push(archGate(options.projectRoot));
+        gates.push(archGate(options.projectRoot, options.arch ?? {}));
     }
     if (!disabled.has('impact')) {
         gates.push(impactGate(options.projectRoot, options.impact ?? {}));

package/dist/schema/arch-gate-options.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Options for the architecture-guard gate.
+ */
+export interface IArchGateOptions {
+    /**
+     * When true (the DEFAULT) and a frozen baseline exists, the gate fails only on
+     * NEW architecture errors (violations absent from the baseline) and surfaces
+     * the total pre-existing debt as informational — so the gate isn't a perpetual
+     * red on baseline debt the current diff never introduced.
+     *
+     * Set to false to fail on ANY error regardless of the baseline (the legacy
+     * behavior; useful for a clean-tree CI demand).
+     */
+    baselineRelative?: boolean;
+}
+//# sourceMappingURL=arch-gate-options.d.ts.map

package/dist/schema/arch-gate-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-gate-options.d.ts","sourceRoot":"","sources":["../../src/schema/arch-gate-options.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B"}

package/dist/schema/arch-gate-options.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@shrkcrft/quality-gates",
-  "version": "0.1.0-alpha.18",
+  "version": "0.1.0-alpha.20",
   "description": "SharkCraft quality gates: single aggregator that runs the code-intelligence checks (graph index, boundaries, architecture, impact summary) and emits one pass/fail report. The pre-merge gate for AI-agent-authored changes.",
   "license": "MIT",
   "author": "SharkCraft contributors",
   "type": "module",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.d.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -43,14 +43,14 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.18",
-    "@shrkcrft/graph": "^0.1.0-alpha.18",
-    "@shrkcrft/architecture-guard": "^0.1.0-alpha.18",
-    "@shrkcrft/impact-engine": "^0.1.0-alpha.18",
-    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.18",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.18",
-    "@shrkcrft/structural-search": "^0.1.0-alpha.18",
-    "@shrkcrft/context-planner": "^0.1.0-alpha.18"
+    "@shrkcrft/core": "^0.1.0-alpha.20",
+    "@shrkcrft/graph": "^0.1.0-alpha.20",
+    "@shrkcrft/architecture-guard": "^0.1.0-alpha.20",
+    "@shrkcrft/impact-engine": "^0.1.0-alpha.20",
+    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.20",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.20",
+    "@shrkcrft/structural-search": "^0.1.0-alpha.20",
+    "@shrkcrft/context-planner": "^0.1.0-alpha.20"
   },
   "publishConfig": {
     "access": "public"