@shrkcrft/quality-gates 0.1.0-alpha.21 → 0.1.0-alpha.22

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

@@ -0,0 +1,23 @@
+import type { IWiringRule } from '@shrkcrft/core';
+import type { IGateResult } from '../schema/quality-gate.js';
+export interface IWiringGateOptions {
+    /** The project's wiring rules (from `sharkcraft.config.ts` `wiringRules[]`). */
+    rules?: readonly IWiringRule[];
+    /** Restrict to rules touched by these (project-relative) changed files. */
+    changedFiles?: readonly string[];
+    /** When true, only run rules touched by `changedFiles`. */
+    changedOnly?: boolean;
+    /**
+     * Set when the project config could not be loaded/validated. The gate surfaces
+     * it (warn) instead of silently skipping — a malformed config must not quietly
+     * disable the wiring plane.
+     */
+    configError?: string;
+}
+/**
+ * The "completeness plane" gate: runs the project's data-defined wiring rules
+ * (declared token set ⊆ registered token set). Skipped — never red — when no
+ * rules are configured, so it's inert for projects that don't opt in.
+ */
+export declare function wiringGate(projectRoot: string, options?: IWiringGateOptions): IGateResult;
+//# sourceMappingURL=wiring-gate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wiring-gate.d.ts","sourceRoot":"","sources":["../../src/gates/wiring-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAmD7F"}

package/dist/gates/wiring-gate.js

@@ -0,0 +1,56 @@
+import { runWiring } from '@shrkcrft/boundaries';
+/**
+ * The "completeness plane" gate: runs the project's data-defined wiring rules
+ * (declared token set ⊆ registered token set). Skipped — never red — when no
+ * rules are configured, so it's inert for projects that don't opt in.
+ */
+export function wiringGate(projectRoot, options = {}) {
+    const start = Date.now();
+    if (options.configError) {
+        return {
+            id: 'wiring',
+            label: 'Wiring (completeness)',
+            status: 'warn',
+            message: `Config could not be loaded — wiring rules not evaluated: ${options.configError}`,
+            nextCommands: ['shrk doctor'],
+            durationMs: Date.now() - start,
+        };
+    }
+    const rules = options.rules ?? [];
+    if (rules.length === 0) {
+        return {
+            id: 'wiring',
+            label: 'Wiring (completeness)',
+            status: 'skipped',
+            message: 'No wiring rules configured (sharkcraft.config.ts wiringRules[]).',
+            durationMs: Date.now() - start,
+        };
+    }
+    const report = runWiring(projectRoot, rules, {
+        ...(options.changedOnly ? { changedOnly: true, changedFiles: options.changedFiles ?? [] } : {}),
+    });
+    const errors = report.violations.filter((v) => v.severity === 'error').length;
+    const warnings = report.violations.filter((v) => v.severity === 'warning').length;
+    const samples = report.violations.slice(0, 8).map((v) => `${v.ruleId}: ${v.token} (${v.file}:${v.line})`);
+    const diagnostics = report.diagnostics;
+    if (report.verdict === 'pass') {
+        return {
+            id: 'wiring',
+            label: 'Wiring (completeness)',
+            status: 'pass',
+            message: `${report.rules.length} wiring rule(s) — every declared token is wired.`,
+            details: { rules: report.rules.length },
+            durationMs: Date.now() - start,
+        };
+    }
+    const misconfig = diagnostics.length > 0 ? `, ${diagnostics.length} misconfigured rule(s)` : '';
+    return {
+        id: 'wiring',
+        label: 'Wiring (completeness)',
+        status: report.verdict === 'errors' ? 'fail' : 'warn',
+        message: `${errors} error(s), ${warnings} warning(s)${misconfig}: declared but not wired.`,
+        details: { errors, warnings, samples, ...(diagnostics.length > 0 ? { diagnostics } : {}) },
+        nextCommands: ['shrk check wiring'],
+        durationMs: Date.now() - start,
+    };
+}

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export * from './gates/graph-unresolved-gate.js';
 export * from './gates/impact-baseline-gate.js';
 export * from './gates/structural-patterns-gate.js';
 export * from './gates/intent-classifier-gate.js';
+export * from './gates/wiring-gate.js';
 export * from './runner/run-gates.js';
 export * from './runner/report-store.js';
 export * from './runner/render-markdown.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,+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"}
+{"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,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -9,6 +9,7 @@ export * from "./gates/graph-unresolved-gate.js";
 export * from "./gates/impact-baseline-gate.js";
 export * from "./gates/structural-patterns-gate.js";
 export * from "./gates/intent-classifier-gate.js";
+export * from "./gates/wiring-gate.js";
 export * from "./runner/run-gates.js";
 export * from "./runner/report-store.js";
 export * from "./runner/render-markdown.js";

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

@@ -6,6 +6,7 @@ import { type IImpactGateOptions } from '../gates/impact-gate.js';
 import { type IImpactBaselineGateOptions } from '../gates/impact-baseline-gate.js';
 import { type IIntentClassifierGateOptions } from '../gates/intent-classifier-gate.js';
 import { type IStructuralPatternsGateOptions } from '../gates/structural-patterns-gate.js';
+import { type IWiringGateOptions } from '../gates/wiring-gate.js';
 import { type IQualityGateReport } from '../schema/quality-gate.js';
 export interface IRunGatesOptions {
     projectRoot: string;
@@ -28,6 +29,8 @@ export interface IRunGatesOptions {
     structuralPatterns?: IStructuralPatternsGateOptions;
     /** Optional intent-classifier gate config. */
     intentClassifier?: IIntentClassifierGateOptions;
+    /** Optional wiring gate config (the project's wiringRules + change scope). */
+    wiring?: IWiringGateOptions;
     /** Disable specific gates by id. */
     disable?: readonly string[];
 }

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,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"}
+{"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,EAAc,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,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,8EAA8E;IAC9E,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,oCAAoC;IACpC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,kBAAkB,CAqD7E"}

package/dist/runner/run-gates.js

@@ -7,6 +7,7 @@ import { impactGate } from "../gates/impact-gate.js";
 import { impactBaselineGate, } from "../gates/impact-baseline-gate.js";
 import { intentClassifierGate, } from "../gates/intent-classifier-gate.js";
 import { structuralPatternsGate, } from "../gates/structural-patterns-gate.js";
+import { wiringGate } from "../gates/wiring-gate.js";
 import { QUALITY_GATE_SCHEMA, } from "../schema/quality-gate.js";
 /**
  * Run the quality-gate aggregator over a project.
@@ -60,6 +61,9 @@ export function runQualityGates(options) {
     if (!disabled.has('intent-classifier')) {
         gates.push(intentClassifierGate(options.projectRoot, options.intentClassifier ?? {}));
     }
+    if (!disabled.has('wiring')) {
+        gates.push(wiringGate(options.projectRoot, options.wiring ?? {}));
+    }
     if (!disabled.has('api-diff') && options.apiDiff) {
         gates.push(apiDiffGate(options.projectRoot, options.apiDiff));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/quality-gates",
-  "version": "0.1.0-alpha.21",
+  "version": "0.1.0-alpha.22",
   "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",
@@ -43,14 +43,14 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.21",
-    "@shrkcrft/graph": "^0.1.0-alpha.21",
-    "@shrkcrft/architecture-guard": "^0.1.0-alpha.21",
-    "@shrkcrft/impact-engine": "^0.1.0-alpha.21",
-    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.21",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.21",
-    "@shrkcrft/structural-search": "^0.1.0-alpha.21",
-    "@shrkcrft/context-planner": "^0.1.0-alpha.21"
+    "@shrkcrft/core": "^0.1.0-alpha.22",
+    "@shrkcrft/graph": "^0.1.0-alpha.22",
+    "@shrkcrft/architecture-guard": "^0.1.0-alpha.22",
+    "@shrkcrft/impact-engine": "^0.1.0-alpha.22",
+    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.22",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.22",
+    "@shrkcrft/structural-search": "^0.1.0-alpha.22",
+    "@shrkcrft/context-planner": "^0.1.0-alpha.22"
   },
   "publishConfig": {
     "access": "public"