@contractual/governance 0.1.0-dev.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2025 Omer Morad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/differs/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Differs
+ *
+ * Contract differ implementations for detecting structural changes
+ * between two versions of a contract specification.
+ *
+ * All differs are pure Node.js - no binary dependencies.
+ */
+export { diffOpenAPI, diffOpenAPIObjects, hasOpenAPIBreakingChanges } from './openapi-diff.js';
+export { diffJsonSchema } from './json-schema/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/differs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../differs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE/F,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/differs/index.js

@@ -0,0 +1,11 @@
+/**
+ * Differs
+ *
+ * Contract differ implementations for detecting structural changes
+ * between two versions of a contract specification.
+ *
+ * All differs are pure Node.js - no binary dependencies.
+ */
+export { diffOpenAPI, diffOpenAPIObjects, hasOpenAPIBreakingChanges } from './openapi-diff.js';
+export { diffJsonSchema } from './json-schema/index.js';
+//# sourceMappingURL=index.js.map

package/dist/differs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../differs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE/F,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/differs/json-schema/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * JSON Schema Differ
+ *
+ * Re-exports from @contractual/differs.json-schema package.
+ * This module provides JSON Schema structural diffing capabilities.
+ */
+export * from '@contractual/differs.json-schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/differs/json-schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../differs/json-schema/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,kCAAkC,CAAC"}

package/dist/differs/json-schema/index.js

@@ -0,0 +1,9 @@
+/**
+ * JSON Schema Differ
+ *
+ * Re-exports from @contractual/differs.json-schema package.
+ * This module provides JSON Schema structural diffing capabilities.
+ */
+// Re-export everything from the json-schema-differ package
+export * from '@contractual/differs.json-schema';
+//# sourceMappingURL=index.js.map

package/dist/differs/json-schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../differs/json-schema/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2DAA2D;AAC3D,cAAc,kCAAkC,CAAC"}

package/dist/differs/openapi-diff.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenAPI Differ using openapi-diff (native Node.js)
+ *
+ * Pure Node.js library for detecting breaking changes in OpenAPI specs.
+ * No binary dependencies required.
+ *
+ * @see https://www.npmjs.com/package/openapi-diff
+ */
+import type { DiffResult } from '@contractual/types';
+/**
+ * Diff two OpenAPI specifications using openapi-diff
+ */
+export declare function diffOpenAPI(oldSpecPath: string, newSpecPath: string): Promise<DiffResult>;
+/**
+ * Diff two OpenAPI spec objects directly (no file I/O)
+ */
+export declare function diffOpenAPIObjects(oldSpec: object, newSpec: object): Promise<DiffResult>;
+/**
+ * Quick check if specs have breaking changes
+ */
+export declare function hasOpenAPIBreakingChanges(oldSpec: object, newSpec: object): Promise<boolean>;
+//# sourceMappingURL=openapi-diff.d.ts.map

package/dist/differs/openapi-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-diff.d.ts","sourceRoot":"","sources":["../../differs/openapi-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAA0B,MAAM,oBAAoB,CAAC;AAoC7E;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkB/F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkB9F;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/differs/openapi-diff.js

@@ -0,0 +1,113 @@
+/**
+ * OpenAPI Differ using openapi-diff (native Node.js)
+ *
+ * Pure Node.js library for detecting breaking changes in OpenAPI specs.
+ * No binary dependencies required.
+ *
+ * @see https://www.npmjs.com/package/openapi-diff
+ */
+import { readFile } from 'node:fs/promises';
+import openapiDiff from 'openapi-diff';
+/**
+ * Diff two OpenAPI specifications using openapi-diff
+ */
+export async function diffOpenAPI(oldSpecPath, newSpecPath) {
+    const oldContent = await readSpecFile(oldSpecPath);
+    const newContent = await readSpecFile(newSpecPath);
+    const result = await openapiDiff.diffSpecs({
+        sourceSpec: {
+            content: oldContent,
+            location: oldSpecPath,
+            format: detectFormat(oldContent),
+        },
+        destinationSpec: {
+            content: newContent,
+            location: newSpecPath,
+            format: detectFormat(newContent),
+        },
+    });
+    return parseResult(result);
+}
+/**
+ * Diff two OpenAPI spec objects directly (no file I/O)
+ */
+export async function diffOpenAPIObjects(oldSpec, newSpec) {
+    const oldContent = JSON.stringify(oldSpec);
+    const newContent = JSON.stringify(newSpec);
+    const result = await openapiDiff.diffSpecs({
+        sourceSpec: {
+            content: oldContent,
+            location: 'old-spec.json',
+            format: detectFormatFromObject(oldSpec),
+        },
+        destinationSpec: {
+            content: newContent,
+            location: 'new-spec.json',
+            format: detectFormatFromObject(newSpec),
+        },
+    });
+    return parseResult(result);
+}
+/**
+ * Quick check if specs have breaking changes
+ */
+export async function hasOpenAPIBreakingChanges(oldSpec, newSpec) {
+    const result = await diffOpenAPIObjects(oldSpec, newSpec);
+    return result.summary.breaking > 0;
+}
+// --- Internal helpers ---
+async function readSpecFile(path) {
+    try {
+        return await readFile(path, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Failed to read spec "${path}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function detectFormat(content) {
+    if (content.includes('openapi:') || content.includes('"openapi"')) {
+        return 'openapi3';
+    }
+    return 'swagger2';
+}
+function detectFormatFromObject(spec) {
+    const s = spec;
+    if (s.openapi && typeof s.openapi === 'string' && s.openapi.startsWith('3')) {
+        return 'openapi3';
+    }
+    return 'swagger2';
+}
+function parseResult(result) {
+    const breaking = result.breakingDifferencesFound ? result.breakingDifferences : [];
+    const nonBreaking = result.nonBreakingDifferences ?? [];
+    const unclassified = result.unclassifiedDifferences ?? [];
+    const changes = [
+        ...breaking.map((d) => mapChange(d, 'breaking')),
+        ...nonBreaking.map((d) => mapChange(d, 'non-breaking')),
+        ...unclassified.map((d) => mapChange(d, 'unknown')),
+    ];
+    const summary = {
+        breaking: breaking.length,
+        nonBreaking: nonBreaking.length,
+        patch: 0,
+        unknown: unclassified.length,
+    };
+    const suggestedBump = summary.breaking > 0 ? 'major' : summary.nonBreaking > 0 ? 'minor' : 'none';
+    return { contract: '', changes, summary, suggestedBump };
+}
+function mapChange(diff, severity) {
+    const srcDetails = diff.sourceSpecEntityDetails?.[0];
+    const destDetails = diff.destinationSpecEntityDetails?.[0];
+    const path = destDetails?.location || srcDetails?.location || '/';
+    // Generate human-readable message from code
+    const message = `${diff.action} ${diff.entity.replace(/\./g, ' ')} at ${path}`;
+    return {
+        path,
+        severity,
+        category: diff.code,
+        message,
+        oldValue: srcDetails?.value,
+        newValue: destDetails?.value,
+    };
+}
+//# sourceMappingURL=openapi-diff.js.map

package/dist/differs/openapi-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-diff.js","sourceRoot":"","sources":["../../differs/openapi-diff.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Governance Engines
+ *
+ * Central module for all linting and diffing capabilities.
+ * Registers all built-in engines with the registry at import time.
+ */
+export { registerLinter, registerDiffer, getLinter, getDiffer, hasLinter, hasDiffer, getRegisteredLinterTypes, getRegisteredDifferTypes, } from './registry.js';
+export type { Change, ChangeSeverity, DiffResult, DiffSummary, SuggestedBump, LintResult, LintIssue, LintSeverity, LintFn, DiffFn, ContractType, RawChange, ChangeType, } from '@contractual/types';
+export { lintOpenAPI } from './linters/openapi-redocly.js';
+export { lintJsonSchema } from './linters/json-schema-ajv.js';
+export { diffOpenAPI, diffOpenAPIObjects, hasOpenAPIBreakingChanges, } from './differs/openapi-diff.js';
+export { diffJsonSchema, diffJsonSchemaObjects, compareSchemas, checkCompatibility, classify, classifyPropertyAdded, classifyAll, CLASSIFICATION_SETS, resolveRefs, hasUnresolvedRefs, extractRefs, validateRefs, walk, formatChangeMessage, } from '@contractual/differs.json-schema';
+export type { CompareResult, CompareOptions, StrandsTrace, StrandsCompatibility, StrandsVersion, SemanticVersion, JsonSchemaDraft, ResolvedSchema, ResolveResult, } from '@contractual/differs.json-schema';
+export { executeCustomCommand, parseCustomLintOutput, parseCustomDiffOutput } from './runner.js';
+/**
+ * Register all built-in governance engines
+ *
+ * Call this function at CLI startup to make all engines available
+ * through the registry.
+ */
+export declare function registerAllEngines(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EACL,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,MAAM,EACN,cAAc,EACd,UAAU,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,SAAS,EACT,YAAY,EACZ,MAAM,EACN,MAAM,EACN,YAAY,EACZ,SAAS,EACT,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,IAAI,EACJ,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEjG;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAczC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * Governance Engines
+ *
+ * Central module for all linting and diffing capabilities.
+ * Registers all built-in engines with the registry at import time.
+ */
+import { registerLinter, registerDiffer } from './registry.js';
+import { lintOpenAPI } from './linters/openapi-redocly.js';
+import { lintJsonSchema } from './linters/json-schema-ajv.js';
+import { diffOpenAPI } from './differs/openapi-diff.js';
+import { diffJsonSchema } from '@contractual/differs.json-schema';
+// Re-export registry functions
+export { registerLinter, registerDiffer, getLinter, getDiffer, hasLinter, hasDiffer, getRegisteredLinterTypes, getRegisteredDifferTypes, } from './registry.js';
+// Re-export linters
+export { lintOpenAPI } from './linters/openapi-redocly.js';
+export { lintJsonSchema } from './linters/json-schema-ajv.js';
+// Re-export differs
+export { diffOpenAPI, diffOpenAPIObjects, hasOpenAPIBreakingChanges, } from './differs/openapi-diff.js';
+// Re-export everything from JSON Schema differ package
+export { diffJsonSchema, diffJsonSchemaObjects, compareSchemas, checkCompatibility, classify, classifyPropertyAdded, classifyAll, CLASSIFICATION_SETS, resolveRefs, hasUnresolvedRefs, extractRefs, validateRefs, walk, formatChangeMessage, } from '@contractual/differs.json-schema';
+// Re-export runner for custom commands
+export { executeCustomCommand, parseCustomLintOutput, parseCustomDiffOutput } from './runner.js';
+/**
+ * Register all built-in governance engines
+ *
+ * Call this function at CLI startup to make all engines available
+ * through the registry.
+ */
+export function registerAllEngines() {
+    // Register linters
+    registerLinter('openapi', lintOpenAPI);
+    registerLinter('json-schema', lintJsonSchema);
+    // Register differs
+    registerDiffer('openapi', diffOpenAPI);
+    registerDiffer('json-schema', diffJsonSchema);
+    // Phase 2:
+    // registerLinter('asyncapi', lintAsyncAPI);
+    // registerLinter('odcs', lintODCS);
+    // registerDiffer('asyncapi', diffAsyncAPI);
+    // registerDiffer('odcs', diffODCS);
+}
+// Auto-register on import
+registerAllEngines();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE,+BAA+B;AAC/B,OAAO,EACL,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAmBvB,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,uDAAuD;AACvD,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,IAAI,EACJ,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAc1C,uCAAuC;AACvC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEjG;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,mBAAmB;IACnB,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACvC,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAE9C,mBAAmB;IACnB,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACvC,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAE9C,WAAW;IACX,4CAA4C;IAC5C,oCAAoC;IACpC,4CAA4C;IAC5C,oCAAoC;AACtC,CAAC;AAED,0BAA0B;AAC1B,kBAAkB,EAAE,CAAC"}

package/dist/linters/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Linters - Export all linter implementations
+ */
+export { lintOpenAPI } from './openapi-redocly.js';
+export { lintJsonSchema, lintJsonSchemaObject } from './json-schema-ajv.js';
+export type { JsonSchemaLintOptions } from './json-schema-ajv.js';
+export { runLintRules, getAvailableRules, getRuleDescription, LINT_RULES, } from './json-schema-rules.js';
+export type { LintRule, SchemaNode } from './json-schema-rules.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/linters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../linters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/linters/index.js

@@ -0,0 +1,11 @@
+/**
+ * Linters - Export all linter implementations
+ */
+export { lintOpenAPI } from './openapi-redocly.js';
+export { lintJsonSchema, lintJsonSchemaObject } from './json-schema-ajv.js';
+// JSON Schema lint rules (for programmatic access)
+export { runLintRules, getAvailableRules, getRuleDescription, LINT_RULES, } from './json-schema-rules.js';
+// Phase 2:
+// export { lintAsyncAPI } from './asyncapi-parser.js';
+// export { lintODCS } from './odcs-ajv.js';
+//# sourceMappingURL=index.js.map

package/dist/linters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../linters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,mDAAmD;AACnD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,GACX,MAAM,wBAAwB,CAAC;AAGhC,WAAW;AACX,uDAAuD;AACvD,4CAA4C"}

package/dist/linters/json-schema-ajv.d.ts

@@ -0,0 +1,42 @@
+/**
+ * JSON Schema Linter using ajv + custom rules
+ *
+ * Two-phase linting:
+ * 1. Meta-validation: Validates that the schema is itself valid JSON Schema (ajv)
+ * 2. Style rules: Checks for best practices, anti-patterns, and quality (custom rules)
+ *
+ * @see https://github.com/sourcemeta/jsonschema
+ * @see https://github.com/orgs/json-schema-org/discussions/323
+ */
+import type { LintResult, LintOptions } from '@contractual/types';
+import type { SchemaNode } from './json-schema-rules.js';
+/**
+ * Options for JSON Schema linting (extends base LintOptions)
+ */
+export interface JsonSchemaLintOptions extends LintOptions {
+    /** Rules to enable (if not specified, all rules are enabled) */
+    enabledRules?: Set<string>;
+    /** Rules to disable */
+    disabledRules?: Set<string>;
+    /** Skip meta-validation (ajv) */
+    skipMetaValidation?: boolean;
+    /** Skip style rules */
+    skipStyleRules?: boolean;
+}
+/**
+ * Lint a JSON Schema using ajv meta-validation and custom style rules
+ *
+ * @param specPath - Path to the JSON Schema file
+ * @param options - Linting options
+ * @returns Lint result with errors and warnings
+ */
+export declare function lintJsonSchema(specPath: string, options?: JsonSchemaLintOptions): Promise<LintResult>;
+/**
+ * Lint a JSON Schema object directly (no file I/O)
+ *
+ * @param schema - JSON Schema object
+ * @param options - Linting options
+ * @returns Lint result with errors and warnings
+ */
+export declare function lintJsonSchemaObject(schema: SchemaNode, options?: JsonSchemaLintOptions): Promise<LintResult>;
+//# sourceMappingURL=json-schema-ajv.d.ts.map

package/dist/linters/json-schema-ajv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-ajv.d.ts","sourceRoot":"","sources":["../../linters/json-schema-ajv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAa,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKzD;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,gEAAgE;IAChE,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,uBAAuB;IACvB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uBAAuB;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,UAAU,CAAC,CAqFrB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,UAAU,CAAC,CA8CrB"}

package/dist/linters/json-schema-ajv.js

@@ -0,0 +1,146 @@
+/**
+ * JSON Schema Linter using ajv + custom rules
+ *
+ * Two-phase linting:
+ * 1. Meta-validation: Validates that the schema is itself valid JSON Schema (ajv)
+ * 2. Style rules: Checks for best practices, anti-patterns, and quality (custom rules)
+ *
+ * @see https://github.com/sourcemeta/jsonschema
+ * @see https://github.com/orgs/json-schema-org/discussions/323
+ */
+import { readFile } from 'node:fs/promises';
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import { runLintRules } from './json-schema-rules.js';
+const AjvConstructor = Ajv.default ?? Ajv;
+const addFormatsFunc = addFormats.default ?? addFormats;
+/**
+ * Lint a JSON Schema using ajv meta-validation and custom style rules
+ *
+ * @param specPath - Path to the JSON Schema file
+ * @param options - Linting options
+ * @returns Lint result with errors and warnings
+ */
+export async function lintJsonSchema(specPath, options = {}) {
+    const errors = [];
+    const warnings = [];
+    let schema;
+    try {
+        const content = await readFile(specPath, 'utf-8');
+        schema = JSON.parse(content);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error reading schema';
+        errors.push({
+            path: '/',
+            message: `Failed to read or parse schema: ${message}`,
+            rule: 'parse-error',
+            severity: 'error',
+        });
+        return { contract: '', specPath, errors, warnings };
+    }
+    // Phase 1: Meta-validation using ajv
+    if (!options.skipMetaValidation) {
+        const ajv = new AjvConstructor({
+            allErrors: true,
+            strict: false,
+            validateSchema: true,
+        });
+        addFormatsFunc(ajv);
+        const valid = ajv.validateSchema(schema);
+        if (!valid && ajv.errors) {
+            for (const err of ajv.errors) {
+                errors.push({
+                    path: err.instancePath || '/',
+                    message: `${err.keyword}: ${err.message}`,
+                    rule: `meta:${err.keyword}`,
+                    severity: 'error',
+                });
+            }
+        }
+    }
+    // Phase 2: Style rules
+    if (!options.skipStyleRules) {
+        const styleIssues = runLintRules(schema, options.enabledRules, options.disabledRules);
+        // Partition into errors and warnings
+        for (const issue of styleIssues) {
+            if (issue.severity === 'error') {
+                errors.push(issue);
+            }
+            else {
+                warnings.push(issue);
+            }
+        }
+    }
+    // Additional meta-level warnings
+    // Warn about unknown $schema versions
+    if (schema.$schema && typeof schema.$schema === 'string') {
+        const schemaUri = schema.$schema;
+        const supportedDrafts = ['draft-04', 'draft-06', 'draft-07', 'draft/2019-09', 'draft/2020-12'];
+        const isKnown = supportedDrafts.some((draft) => schemaUri.includes(draft) || schemaUri.includes(draft.replace('draft-', 'draft/')));
+        if (!isKnown && !schemaUri.includes('json-schema.org')) {
+            warnings.push({
+                path: '/$schema',
+                message: `Unknown schema draft: ${schemaUri}. Validation may be incomplete.`,
+                rule: 'unknown-draft',
+                severity: 'warning',
+            });
+        }
+    }
+    return {
+        contract: '',
+        specPath,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Lint a JSON Schema object directly (no file I/O)
+ *
+ * @param schema - JSON Schema object
+ * @param options - Linting options
+ * @returns Lint result with errors and warnings
+ */
+export async function lintJsonSchemaObject(schema, options = {}) {
+    const errors = [];
+    const warnings = [];
+    // Phase 1: Meta-validation using ajv
+    if (!options.skipMetaValidation) {
+        const ajv = new AjvConstructor({
+            allErrors: true,
+            strict: false,
+            validateSchema: true,
+        });
+        addFormatsFunc(ajv);
+        const valid = ajv.validateSchema(schema);
+        if (!valid && ajv.errors) {
+            for (const err of ajv.errors) {
+                errors.push({
+                    path: err.instancePath || '/',
+                    message: `${err.keyword}: ${err.message}`,
+                    rule: `meta:${err.keyword}`,
+                    severity: 'error',
+                });
+            }
+        }
+    }
+    // Phase 2: Style rules
+    if (!options.skipStyleRules) {
+        const styleIssues = runLintRules(schema, options.enabledRules, options.disabledRules);
+        for (const issue of styleIssues) {
+            if (issue.severity === 'error') {
+                errors.push(issue);
+            }
+            else {
+                warnings.push(issue);
+            }
+        }
+    }
+    return {
+        contract: '',
+        specPath: '',
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=json-schema-ajv.js.map

package/dist/linters/json-schema-ajv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-ajv.js","sourceRoot":"","sources":["../../linters/json-schema-ajv.ts"],"names":[],"mappings":"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"}

package/dist/linters/json-schema-rules.d.ts

@@ -0,0 +1,42 @@
+/**
+ * JSON Schema Linting Rules
+ *
+ * Native TypeScript implementation of linting rules for JSON Schema.
+ * Based on best practices from Sourcemeta, JSON Schema org, and community discussions.
+ *
+ * @see https://github.com/sourcemeta/jsonschema
+ * @see https://github.com/orgs/json-schema-org/discussions/323
+ */
+import type { LintIssue, LintSeverity } from '@contractual/types';
+import { type ResolvedSchema } from '@contractual/differs.json-schema';
+export type { ResolvedSchema as SchemaNode } from '@contractual/differs.json-schema';
+/**
+ * Lint rule definition
+ */
+export interface LintRule {
+    /** Rule identifier */
+    id: string;
+    /** Human-readable description */
+    description: string;
+    /** Default severity */
+    severity: LintSeverity;
+    /** Check function - returns issues found at this schema node */
+    check: (schema: ResolvedSchema, path: string, root: ResolvedSchema) => LintIssue[];
+}
+/**
+ * All built-in linting rules
+ */
+export declare const LINT_RULES: LintRule[];
+/**
+ * Run all lint rules against a schema, recursively walking all subschemas
+ */
+export declare function runLintRules(schema: ResolvedSchema, enabledRules?: Set<string>, disabledRules?: Set<string>): LintIssue[];
+/**
+ * Get all available rule IDs
+ */
+export declare function getAvailableRules(): string[];
+/**
+ * Get rule description by ID
+ */
+export declare function getRuleDescription(ruleId: string): string | undefined;
+//# sourceMappingURL=json-schema-rules.d.ts.map

package/dist/linters/json-schema-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-rules.d.ts","sourceRoot":"","sources":["../../linters/json-schema-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,kCAAkC,CAAC;AAGvF,YAAY,EAAE,cAAc,IAAI,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,gEAAgE;IAChE,KAAK,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,SAAS,EAAE,CAAC;CACpF;AAkED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,EA2kBhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAC1B,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,SAAS,EAAE,CAgBb;AAiHD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE"}