ts-openapi-codegen 2.1.0-beta.1 → 2.1.0-beta.10

package/dist/cli/analyzeDiff/__tests__/analyzeDiff.cli.test.js

@@ -9,6 +9,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_test_1 = require("node:test");
 const LoggerMessages_1 = require("../../../common/LoggerMessages");
 const semanticDiffReportSchema_1 = require("../../../core/semanticDiff/semanticDiffReportSchema");
+const silenceLoggers_1 = require("../../../test/helpers/silenceLoggers");
 const analyzeDiff_1 = require("../analyzeDiff");
 const ciSummary_1 = require("../ciSummary");
 const repoRoot = node_path_1.default.join(__dirname, '..', '..', '..', '..');
@@ -29,6 +30,14 @@ async function runAnalyzeDiffCli(options) {
     };
 }
 (0, node_test_1.describe)('@unit: analyzeDiff cli', () => {
+    let restoreAppLogger;
+    (0, node_test_1.beforeEach)(() => {
+        restoreAppLogger = (0, silenceLoggers_1.installSilenceAppLogger)();
+    });
+    (0, node_test_1.afterEach)(() => {
+        restoreAppLogger?.();
+        restoreAppLogger = undefined;
+    });
     (0, node_test_1.test)('returns exit code 0 and skips when --input has no base source', async (t) => {
         const tempDir = createTempDir(t, 'openapi-cli-analyze-skip-');
         const reportPath = node_path_1.default.join(tempDir, 'report.json');
@@ -102,12 +111,13 @@ async function runAnalyzeDiffCli(options) {
         const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
         const schemaValidation = (0, semanticDiffReportSchema_1.validateSemanticDiffReportSchema)(report);
         node_assert_1.default.strictEqual(schemaValidation.valid, true, schemaValidation.errors.join('\n'));
-        node_assert_1.default.strictEqual(report.schemaVersion, '1.1.0');
-        node_assert_1.default.strictEqual(report.summary.breaking, 0);
-        node_assert_1.default.ok(report.summary.nonBreaking > 0);
-        node_assert_1.default.strictEqual(report.recommendation.semver, 'minor');
-        node_assert_1.default.ok(report.recommendation.reasons.includes('HAS_BACKWARD_COMPATIBLE_CHANGES'));
-        node_assert_1.default.strictEqual(report.governance.summary.errors, 0);
+        node_assert_1.default.strictEqual(report.schemaVersion, '2.0.0');
+        node_assert_1.default.strictEqual(report.semantic.summary.breaking, 0);
+        node_assert_1.default.ok(report.semantic.summary.nonBreaking > 0);
+        node_assert_1.default.strictEqual(report.semantic.recommendation.semver, 'minor');
+        node_assert_1.default.ok(report.semantic.recommendation.reasons.includes('HAS_BACKWARD_COMPATIBLE_CHANGES'));
+        node_assert_1.default.strictEqual(report.semantic.governance.summary.errors, 0);
+        node_assert_1.default.strictEqual(report.structural.diff.all.length, report.semantic.changes.length);
         const ciSummary = (0, ciSummary_1.formatCiMarkdownSummary)(report, reportPath);
         node_assert_1.default.ok(ciSummary.includes('### OpenAPI Semantic Diff'));
         node_assert_1.default.ok(ciSummary.includes('HAS_BACKWARD_COMPATIBLE_CHANGES'));
@@ -145,12 +155,12 @@ async function runAnalyzeDiffCli(options) {
         const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
         const schemaValidation = (0, semanticDiffReportSchema_1.validateSemanticDiffReportSchema)(report);
         node_assert_1.default.strictEqual(schemaValidation.valid, true, schemaValidation.errors.join('\n'));
-        node_assert_1.default.strictEqual(report.schemaVersion, '1.1.0');
-        node_assert_1.default.ok(report.summary.breaking > 0);
-        node_assert_1.default.ok(report.changes.some(change => change.severity === 'breaking'));
-        node_assert_1.default.strictEqual(report.recommendation.semver, 'major');
-        node_assert_1.default.ok(report.recommendation.reasons.includes('HAS_BREAKING_CHANGES'));
-        node_assert_1.default.ok(report.governance.violations.some(violation => violation.ruleId === 'NO_BREAKING_WITHOUT_FLAG'));
+        node_assert_1.default.strictEqual(report.schemaVersion, '2.0.0');
+        node_assert_1.default.ok(report.semantic.summary.breaking > 0);
+        node_assert_1.default.ok(report.semantic.changes.some(change => change.severity === 'breaking'));
+        node_assert_1.default.strictEqual(report.semantic.recommendation.semver, 'major');
+        node_assert_1.default.ok(report.semantic.recommendation.reasons.includes('HAS_BREAKING_CHANGES'));
+        node_assert_1.default.ok(report.semantic.governance.violations.some(violation => violation.ruleId === 'NO_BREAKING_WITHOUT_FLAG'));
         const ciSummary = (0, ciSummary_1.formatCiMarkdownSummary)(report, reportPath);
         node_assert_1.default.ok(ciSummary.includes('### OpenAPI Semantic Diff'));
         node_assert_1.default.ok(ciSummary.includes('HAS_BREAKING_CHANGES'));
@@ -190,9 +200,9 @@ async function runAnalyzeDiffCli(options) {
         const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
         const schemaValidation = (0, semanticDiffReportSchema_1.validateSemanticDiffReportSchema)(report);
         node_assert_1.default.strictEqual(schemaValidation.valid, true, schemaValidation.errors.join('\n'));
-        node_assert_1.default.strictEqual(report.schemaVersion, '1.1.0');
-        node_assert_1.default.ok(report.summary.breaking > 0);
-        node_assert_1.default.ok(!report.governance.violations.some(violation => violation.ruleId === 'NO_BREAKING_WITHOUT_FLAG'));
+        node_assert_1.default.strictEqual(report.schemaVersion, '2.0.0');
+        node_assert_1.default.ok(report.semantic.summary.breaking > 0);
+        node_assert_1.default.ok(!report.semantic.governance.violations.some(violation => violation.ruleId === 'NO_BREAKING_WITHOUT_FLAG'));
         node_assert_1.default.ok((0, ciSummary_1.formatCiMarkdownSummary)(report, reportPath).includes('### OpenAPI Semantic Diff'));
     });
     (0, node_test_1.test)('returns exit code 0 for breaking diff in ci mode when governance config disables no-breaking rule', async (t) => {
@@ -238,9 +248,9 @@ async function runAnalyzeDiffCli(options) {
         const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
         const schemaValidation = (0, semanticDiffReportSchema_1.validateSemanticDiffReportSchema)(report);
         node_assert_1.default.strictEqual(schemaValidation.valid, true, schemaValidation.errors.join('\n'));
-        node_assert_1.default.strictEqual(report.schemaVersion, '1.1.0');
-        node_assert_1.default.ok(report.summary.breaking > 0);
-        node_assert_1.default.ok(!report.governance.violations.some(violation => violation.ruleId === 'NO_BREAKING_WITHOUT_FLAG'));
+        node_assert_1.default.strictEqual(report.schemaVersion, '2.0.0');
+        node_assert_1.default.ok(report.semantic.summary.breaking > 0);
+        node_assert_1.default.ok(!report.semantic.governance.violations.some(violation => violation.ruleId === 'NO_BREAKING_WITHOUT_FLAG'));
         node_assert_1.default.ok((0, ciSummary_1.formatCiMarkdownSummary)(report, reportPath).includes('### OpenAPI Semantic Diff'));
     });
     (0, node_test_1.test)('uses --compare-with over --git when both flags are provided', async (t) => {
@@ -284,8 +294,8 @@ async function runAnalyzeDiffCli(options) {
         node_assert_1.default.strictEqual(exitCode, 0);
         node_assert_1.default.strictEqual(result.success, true);
         const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
-        node_assert_1.default.strictEqual(report.summary.breaking, 0);
-        node_assert_1.default.strictEqual(report.recommendation.semver, 'patch');
+        node_assert_1.default.strictEqual(report.semantic.summary.breaking, 0);
+        node_assert_1.default.strictEqual(report.semantic.recommendation.semver, 'patch');
         node_assert_1.default.ok(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.COMPARE_WITH_OVERRIDES_GIT('HEAD~9999').includes('Ignoring git ref'));
     });
     (0, node_test_1.test)('filters semantic changes with analyze.ignore and recalculates summary', async (t) => {
@@ -346,10 +356,10 @@ async function runAnalyzeDiffCli(options) {
         node_assert_1.default.strictEqual(exitCode, 0);
         node_assert_1.default.strictEqual(result.ignored, 1);
         const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
-        node_assert_1.default.strictEqual(report.summary.breaking, 0);
-        node_assert_1.default.strictEqual(report.summary.nonBreaking, 0);
-        node_assert_1.default.strictEqual(report.summary.informational, 0);
-        node_assert_1.default.strictEqual(report.recommendation.semver, 'patch');
+        node_assert_1.default.strictEqual(report.semantic.summary.breaking, 0);
+        node_assert_1.default.strictEqual(report.semantic.summary.nonBreaking, 0);
+        node_assert_1.default.strictEqual(report.semantic.summary.informational, 0);
+        node_assert_1.default.strictEqual(report.semantic.recommendation.semver, 'patch');
         node_assert_1.default.ok(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.IGNORED_CHANGES(1).includes('IGNORED: 1 semantic change'));
     });
     (0, node_test_1.test)('fails when --input is missing', async () => {
@@ -362,4 +372,10 @@ async function runAnalyzeDiffCli(options) {
         node_assert_1.default.strictEqual((0, analyzeDiff_1.toAnalyzeDiffExitCode)(result), 1);
         node_assert_1.default.ok(result.error?.includes('"--input" is required for analyze-diff command'));
     });
+    (0, node_test_1.test)('uses semantic ref expansion instead of full dereference in the analyze hot path', () => {
+        const source = (0, node_fs_1.readFileSync)(node_path_1.default.join(__dirname, '..', 'analyzeDiff.ts'), 'utf8');
+        node_assert_1.default.ok(source.includes('loadSemanticOpenApiSpec'));
+        node_assert_1.default.ok(!source.includes('dereferenceOpenApiSpec'));
+        node_assert_1.default.ok(!source.includes('dereferenceOpenApiObject'));
+    });
 });

package/dist/cli/analyzeDiff/__tests__/analyzeDiffLomMiracles.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analyzeDiffLomMiracles.test.d.ts.map

package/dist/cli/analyzeDiff/__tests__/analyzeDiffLomMiracles.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeDiffLomMiracles.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/analyzeDiff/__tests__/analyzeDiffLomMiracles.test.ts"],"names":[],"mappings":""}

package/dist/cli/analyzeDiff/__tests__/analyzeDiffLomMiracles.test.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = require("node:test");
+const silenceLoggers_1 = require("../../../test/helpers/silenceLoggers");
+const analyzeDiff_1 = require("../analyzeDiff");
+const generatedRoot = node_path_1.default.join(__dirname, 'generated');
+const createTempDir = (t, prefix) => {
+    node_fs_1.default.mkdirSync(generatedRoot, { recursive: true });
+    const tempDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(generatedRoot, prefix));
+    t.after(() => {
+        node_fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+    });
+    return tempDir;
+};
+(0, node_test_1.describe)('@unit: analyzeDiff lom miracles', () => {
+    let restoreAppLogger;
+    (0, node_test_1.beforeEach)(() => {
+        restoreAppLogger = (0, silenceLoggers_1.installSilenceAppLogger)();
+    });
+    (0, node_test_1.afterEach)(() => {
+        restoreAppLogger?.();
+        restoreAppLogger = undefined;
+    });
+    (0, node_test_1.test)('builds changes and miracles for lom v1 vs v2 specs', async (t) => {
+        const tmpDir = createTempDir(t, 'lom-diff-');
+        const reportPath = node_path_1.default.join(tmpDir, 'report.json');
+        const specRoot = node_path_1.default.join(__dirname, '../../../../test/spec/lom');
+        const result = await (0, analyzeDiff_1.analyzeDiff)({
+            input: node_path_1.default.join(specRoot, 'lom_api.v2.yaml'),
+            compareWith: node_path_1.default.join(specRoot, 'lom_api.v1.yaml'),
+            outputReport: reportPath,
+        });
+        node_assert_1.default.ok(result.success, result.error);
+        const report = JSON.parse(node_fs_1.default.readFileSync(reportPath, 'utf-8'));
+        node_assert_1.default.ok(report.semantic.changes.length > 0, 'expected semantic changes');
+        node_assert_1.default.ok(report.structural.miracles.length > 0, 'expected miracles in report');
+        node_assert_1.default.ok(report.structural.miracles.some(miracle => miracle.type === 'RENAME'));
+        node_assert_1.default.ok(report.structural.miracles.some(miracle => miracle.type === 'TYPE_COERCION'));
+        node_assert_1.default.ok(report.semantic.changes.some(change => change.type === 'model.property.type.changed'));
+    });
+});

package/dist/cli/analyzeDiff/__tests__/analyzeDiffRenameAndInvalidRegex.test.js

@@ -7,6 +7,7 @@ const node_assert_1 = __importDefault(require("node:assert"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_test_1 = require("node:test");
+const silenceLoggers_1 = require("../../../test/helpers/silenceLoggers");
 const analyzeDiff_1 = require("../analyzeDiff");
 const writeSpec = (dir, filename, payload) => {
     const filePath = node_path_1.default.join(dir, filename);
@@ -23,6 +24,14 @@ const createTempDir = (t, prefix) => {
     return tempDir;
 };
 (0, node_test_1.describe)('@unit: analyzeDiff RENAME and invalid-regex handling', () => {
+    let restoreAppLogger;
+    (0, node_test_1.beforeEach)(() => {
+        restoreAppLogger = (0, silenceLoggers_1.installSilenceAppLogger)();
+    });
+    (0, node_test_1.afterEach)(() => {
+        restoreAppLogger?.();
+        restoreAppLogger = undefined;
+    });
     (0, node_test_1.test)('detects semantic remove/add entries for property rename-like change', async (t) => {
         const tmpDir = createTempDir(t, 'openapi-diff-rename-');
         const reportPath = node_path_1.default.join(tmpDir, 'report.json');
@@ -66,12 +75,13 @@ const createTempDir = (t, prefix) => {
         node_assert_1.default.ok(result.success, `analyzeDiff failed: ${result.error ?? 'unknown'}`);
         const reportRaw = node_fs_1.default.readFileSync(reportPath, 'utf-8');
         const report = JSON.parse(reportRaw);
-        const removed = report.changes.find(change => change.type === 'model.property.removed' && change.path === '#/components/schemas/User/properties/first_name');
-        const added = report.changes.find(change => change.type === 'model.property.added' && change.path === '#/components/schemas/User/properties/firstName');
+        const removed = report.semantic.changes.find(change => change.type === 'model.property.removed' && change.path === '#/components/schemas/User/properties/first_name');
+        const added = report.semantic.changes.find(change => change.type === 'model.property.added' && change.path === '#/components/schemas/User/properties/firstName');
         node_assert_1.default.ok(removed, 'Expected semantic removal entry for previous property');
         node_assert_1.default.ok(added, 'Expected semantic addition entry for renamed property');
         node_assert_1.default.strictEqual(removed?.severity, 'breaking');
         node_assert_1.default.strictEqual(added?.severity, 'non-breaking');
+        node_assert_1.default.ok(report.structural.miracles.some(miracle => miracle.type === 'RENAME'));
     });
     (0, node_test_1.test)('invalid regex in config does not crash and valid rules still apply', async (t) => {
         const tmpDir = createTempDir(t, 'openapi-diff-invalidregex-');
@@ -132,11 +142,11 @@ const createTempDir = (t, prefix) => {
         node_assert_1.default.ok(result.success, `analyzeDiff failed: ${result.error ?? 'unknown'}`);
         const reportRaw = node_fs_1.default.readFileSync(reportPath, 'utf-8');
         const report = JSON.parse(reportRaw);
-        const filteredTypeChange = report.changes.find(change => change.type === 'model.property.type.changed' && change.path === '#/components/schemas/User/properties/age');
+        const filteredTypeChange = report.semantic.changes.find(change => change.type === 'model.property.type.changed' && change.path === '#/components/schemas/User/properties/age');
         node_assert_1.default.ok(!filteredTypeChange, 'Expected matching semantic change to be filtered by valid rule while invalid regex is ignored');
-        node_assert_1.default.strictEqual(report.summary.breaking, 0);
-        node_assert_1.default.strictEqual(report.summary.nonBreaking, 0);
-        node_assert_1.default.strictEqual(report.summary.informational, 0);
-        node_assert_1.default.strictEqual(report.recommendation.semver, 'patch');
+        node_assert_1.default.strictEqual(report.semantic.summary.breaking, 0);
+        node_assert_1.default.strictEqual(report.semantic.summary.nonBreaking, 0);
+        node_assert_1.default.strictEqual(report.semantic.summary.informational, 0);
+        node_assert_1.default.strictEqual(report.semantic.recommendation.semver, 'patch');
     });
 });

package/dist/cli/analyzeDiff/__tests__/analyzeDiffTypeCoercion.test.js

@@ -7,6 +7,7 @@ const node_assert_1 = __importDefault(require("node:assert"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_test_1 = require("node:test");
+const silenceLoggers_1 = require("../../../test/helpers/silenceLoggers");
 const analyzeDiff_1 = require("../analyzeDiff");
 const writeSpec = (dir, filename, payload) => {
     const filePath = node_path_1.default.join(dir, filename);
@@ -23,6 +24,14 @@ const createTempDir = (t, prefix) => {
     return tempDir;
 };
 (0, node_test_1.describe)('@unit: analyzeDiff TYPE_COERCION miracles', () => {
+    let restoreAppLogger;
+    (0, node_test_1.beforeEach)(() => {
+        restoreAppLogger = (0, silenceLoggers_1.installSilenceAppLogger)();
+    });
+    (0, node_test_1.afterEach)(() => {
+        restoreAppLogger?.();
+        restoreAppLogger = undefined;
+    });
     (0, node_test_1.test)('detects semantic type change for scalar property transition', async (t) => {
         const tmpDir = createTempDir(t, 'openapi-diff-test-');
         const reportPath = node_path_1.default.join(tmpDir, 'report.json');
@@ -66,11 +75,12 @@ const createTempDir = (t, prefix) => {
         node_assert_1.default.ok(result.success, `analyzeDiff failed: ${result.error ?? 'unknown error'}`);
         const reportRaw = node_fs_1.default.readFileSync(reportPath, 'utf-8');
         const report = JSON.parse(reportRaw);
-        const typeChange = report.changes.find(change => change.type === 'model.property.type.changed');
+        const typeChange = report.semantic.changes.find(change => change.type === 'model.property.type.changed');
         node_assert_1.default.ok(typeChange, 'Expected semantic type-change entry');
         node_assert_1.default.strictEqual(typeChange?.path, '#/components/schemas/User/properties/age');
         node_assert_1.default.strictEqual(typeChange?.severity, 'breaking');
-        node_assert_1.default.ok(report.summary.breaking > 0);
+        node_assert_1.default.ok(report.semantic.summary.breaking > 0);
+        node_assert_1.default.ok(report.structural.miracles.some(miracle => miracle.type === 'TYPE_COERCION'));
     });
     (0, node_test_1.test)('filters semantic type-change entry when rule matches path', async (t) => {
         const tmpDir = createTempDir(t, 'openapi-diff-test-');
@@ -127,11 +137,11 @@ const createTempDir = (t, prefix) => {
         node_assert_1.default.ok(result.success, `analyzeDiff failed: ${result.error ?? 'unknown error'}`);
         const reportRaw = node_fs_1.default.readFileSync(reportPath, 'utf-8');
         const report = JSON.parse(reportRaw);
-        const filteredTypeChange = report.changes.find(change => change.type === 'model.property.type.changed' && change.path === '#/components/schemas/User/properties/age');
+        const filteredTypeChange = report.semantic.changes.find(change => change.type === 'model.property.type.changed' && change.path === '#/components/schemas/User/properties/age');
         node_assert_1.default.ok(!filteredTypeChange, 'Expected semantic type-change to be filtered by analyze.ignore');
-        node_assert_1.default.strictEqual(report.summary.breaking, 0);
-        node_assert_1.default.strictEqual(report.summary.nonBreaking, 0);
-        node_assert_1.default.strictEqual(report.summary.informational, 0);
-        node_assert_1.default.strictEqual(report.recommendation.semver, 'patch');
+        node_assert_1.default.strictEqual(report.semantic.summary.breaking, 0);
+        node_assert_1.default.strictEqual(report.semantic.summary.nonBreaking, 0);
+        node_assert_1.default.strictEqual(report.semantic.summary.informational, 0);
+        node_assert_1.default.strictEqual(report.semantic.recommendation.semver, 'patch');
     });
 });

package/dist/cli/analyzeDiff/analyzeDiff.d.ts

@@ -1,4 +1,12 @@
 import { OptionValues } from 'commander';
+/**
+ * Результат выполнения команды analyze-diff.
+ * @property success признак успешного завершения
+ * @property [skipped] анализ пропущен из-за отсутствия базовой спецификации
+ * @property [reportPath] абсолютный путь к сохранённому отчёту
+ * @property [ignored] количество проигнорированных изменений
+ * @property [error] текст ошибки при неуспешном завершении
+ */
 export type AnalyzeDiffResult = {
     success: boolean;
     skipped?: boolean;
@@ -7,11 +15,15 @@ export type AnalyzeDiffResult = {
     error?: string;
 };
 /**
- * Maps analyze-diff result to a process exit code. Does not call `process.exit`.
+ * Преобразует результат analyze-diff в код выхода процесса. Не вызывает `process.exit`.
+ * @param result результат выполнения analyze-diff
+ * @returns код выхода: 0 при успехе, 1 при ошибке
  */
 export declare function toAnalyzeDiffExitCode(result: AnalyzeDiffResult): number;
 /**
- * Runs semantic diff analysis between two OpenAPI specs and writes JSON report.
+ * Выполняет семантическое сравнение двух OpenAPI-спецификаций и записывает JSON-отчёт.
+ * @param options опции CLI команды analyze-diff
+ * @returns результат выполнения с путём к отчёту или описанием ошибки
  */
 export declare function analyzeDiff(options: OptionValues): Promise<AnalyzeDiffResult>;
 //# sourceMappingURL=analyzeDiff.d.ts.map

package/dist/cli/analyzeDiff/analyzeDiff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyzeDiff.d.ts","sourceRoot":"","sources":["../../../src/cli/analyzeDiff/analyzeDiff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAoBzC,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuFnF"}
+{"version":3,"file":"analyzeDiff.d.ts","sourceRoot":"","sources":["../../../src/cli/analyzeDiff/analyzeDiff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAuBzC;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAEvE;AAqBD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuGnF"}

package/dist/cli/analyzeDiff/analyzeDiff.js

@@ -1,16 +1,23 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toAnalyzeDiffExitCode = toAnalyzeDiffExitCode;
 exports.analyzeDiff = analyzeDiff;
+const crypto_1 = __importDefault(require("crypto"));
 const Consts_1 = require("../../common/Consts");
 const LoggerMessages_1 = require("../../common/LoggerMessages");
-const validateZodOptions_1 = require("../../common/Validation/validateZodOptions");
+const Validation_1 = require("../../common/Validation");
 const evaluateGovernanceRules_1 = require("../../core/governance/evaluateGovernanceRules");
 const loadGovernanceConfig_1 = require("../../core/governance/loadGovernanceConfig");
 const applySemanticDiffPluginHooks_1 = require("../../core/plugins/applySemanticDiffPluginHooks");
 const loadGeneratorPlugins_1 = require("../../core/plugins/loadGeneratorPlugins");
 const analyzeOpenApiDiff_1 = require("../../core/semanticDiff/analyzeOpenApiDiff");
-const getOpenApiSpec_1 = require("../../core/utils/getOpenApiSpec");
+const DiffReport_model_1 = require("../../core/types/DiffReport.model");
+const adapters_1 = require("../../core/utils/adapters");
+const buildMiraclesFromSemanticChanges_1 = require("../../core/utils/buildMiraclesFromSemanticChanges");
+const loadSemanticOpenApiSpec_1 = require("../../core/utils/loadSemanticOpenApiSpec");
 const schemas_1 = require("../schemas");
 const ciSummary_1 = require("./ciSummary");
 const ignoreRules_1 = require("./ignoreRules");
@@ -19,16 +26,36 @@ const pluginPaths_1 = require("./pluginPaths");
 const semanticDiffContext_1 = require("./semanticDiffContext");
 const specParser_1 = require("./specParser");
 /**
- * Maps analyze-diff result to a process exit code. Does not call `process.exit`.
+ * Преобразует результат analyze-diff в код выхода процесса. Не вызывает `process.exit`.
+ * @param result результат выполнения analyze-diff
+ * @returns код выхода: 0 при успехе, 1 при ошибке
  */
 function toAnalyzeDiffExitCode(result) {
     return result.success ? 0 : 1;
 }
+function createSpecHash(spec) {
+    const seen = new WeakSet();
+    const serializedSpec = JSON.stringify(spec, (_key, value) => {
+        if (value && typeof value === 'object') {
+            if (seen.has(value)) {
+                return '[Circular]';
+            }
+            seen.add(value);
+        }
+        return value;
+    });
+    return crypto_1.default
+        .createHash('sha256')
+        .update(serializedSpec ?? '')
+        .digest('hex');
+}
 /**
- * Runs semantic diff analysis between two OpenAPI specs and writes JSON report.
+ * Выполняет семантическое сравнение двух OpenAPI-спецификаций и записывает JSON-отчёт.
+ * @param options опции CLI команды analyze-diff
+ * @returns результат выполнения с путём к отчёту или описанием ошибки
  */
 async function analyzeDiff(options) {
-    const validationResult = (0, validateZodOptions_1.validateZodOptions)(schemas_1.analyzeDiffOptionsSchema, options);
+    const validationResult = (0, Validation_1.validateZodOptions)(schemas_1.analyzeDiffOptionsSchema, options);
     if (!validationResult.success) {
         const message = validationResult.errors.join('\n');
         Consts_1.APP_LOGGER.error(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.VALIDATION_ERROR(message));
@@ -46,11 +73,9 @@ async function analyzeDiff(options) {
         }
         const baseSourceLabel = oldSpecInput ? `compare-with:${oldSpecInput}` : `git:${gitRef}`;
         Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.STARTED(newSpecInput, baseSourceLabel));
-        const newContext = (0, semanticDiffContext_1.createSemanticDiffContext)(newSpecInput);
-        const newSpec = await (0, getOpenApiSpec_1.getOpenApiSpec)(newContext, newSpecInput);
-        const oldSpec = oldSpecInput
-            ? await (0, getOpenApiSpec_1.getOpenApiSpec)((0, semanticDiffContext_1.createSemanticDiffContext)(oldSpecInput), oldSpecInput)
-            : (await (0, specParser_1.readSpecFromGit)(gitRef, newSpecInput));
+        (0, semanticDiffContext_1.createSemanticDiffContext)(newSpecInput);
+        const newSpec = await (0, loadSemanticOpenApiSpec_1.loadSemanticOpenApiSpec)(newSpecInput);
+        const oldSpec = oldSpecInput ? await (0, loadSemanticOpenApiSpec_1.loadSemanticOpenApiSpec)(oldSpecInput) : await (0, loadSemanticOpenApiSpec_1.loadSemanticOpenApiObject)(await (0, specParser_1.readSpecFromGit)(gitRef, newSpecInput), newSpecInput);
         if (oldSpecInput && validatedOptions.git) {
             Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.COMPARE_WITH_OVERRIDES_GIT(validatedOptions.git));
         }
@@ -72,7 +97,7 @@ async function analyzeDiff(options) {
             },
         });
         const { report: reportAfterIgnore, ignored } = (0, ignoreSemanticChanges_1.filterSemanticChangesByIgnoreRules)(pluginHooksResult.report, ignoreRules);
-        const report = {
+        const semanticReport = {
             ...reportAfterIgnore,
             governance: (0, evaluateGovernanceRules_1.evaluateGovernanceRules)({
                 openApi: newSpec,
@@ -80,19 +105,37 @@ async function analyzeDiff(options) {
                 allowBreaking: validatedOptions.allowBreaking ?? false,
                 governanceConfig: governancePolicy,
             }),
+            miracles: (0, buildMiraclesFromSemanticChanges_1.buildMiraclesFromSemanticChanges)(reportAfterIgnore.changes),
+        };
+        const report = {
+            schemaVersion: DiffReport_model_1.UNIFIED_DIFF_REPORT_SCHEMA_VERSION,
+            timestamp: new Date().toISOString(),
+            metadata: {
+                base: baseSourceLabel,
+                target: newSpecInput,
+                baseHash: createSpecHash(oldSpec),
+                targetHash: createSpecHash(newSpec),
+            },
+            semantic: {
+                changes: semanticReport.changes,
+                governance: semanticReport.governance,
+                recommendation: semanticReport.recommendation,
+                summary: semanticReport.summary,
+            },
+            structural: (0, adapters_1.adaptSemanticToStructural)(semanticReport, ignored),
         };
         const reportPath = await (0, analyzeOpenApiDiff_1.writeSemanticDiffReport)(report, pluginHooksResult.reportPath);
         Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.REPORT_CREATED(reportPath));
-        Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.SUMMARY(report, reportPath));
-        Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.RECOMMENDATION(report));
-        Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.GOVERNANCE(report));
+        Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.SUMMARY(semanticReport, reportPath));
+        Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.RECOMMENDATION(semanticReport));
+        Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.GOVERNANCE(semanticReport));
         if (ignored > 0) {
             Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.IGNORED_CHANGES(ignored));
         }
         if (validatedOptions.ci) {
             Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.CI_MARKDOWN_SUMMARY((0, ciSummary_1.formatCiMarkdownSummary)(report, reportPath)));
         }
-        if (validatedOptions.ci && report.governance.summary.errors > 0) {
+        if (validatedOptions.ci && semanticReport.governance.summary.errors > 0) {
             return { success: false, reportPath, error: LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.CI_FAILURE };
         }
         return { success: true, reportPath, ignored };

package/dist/cli/analyzeDiff/ciSummary.d.ts

@@ -1,6 +1,9 @@
-import { SemanticDiffReport } from '../../core/semanticDiff/analyzeOpenApiDiff';
+import type { UnifiedDiffReport } from '../../core/types/DiffReport.model';
 /**
- * Builds markdown summary for CI logs.
+ * Формирует markdown-сводку семантического diff для CI-логов.
+ * @param report унифицированный diff-отчёт
+ * @param reportPath путь к сохранённому отчёту
+ * @returns markdown-текст для вывода в CI
  */
-export declare function formatCiMarkdownSummary(report: SemanticDiffReport, reportPath: string): string;
+export declare function formatCiMarkdownSummary(report: UnifiedDiffReport, reportPath: string): string;
 //# sourceMappingURL=ciSummary.d.ts.map

package/dist/cli/analyzeDiff/ciSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ciSummary.d.ts","sourceRoot":"","sources":["../../../src/cli/analyzeDiff/ciSummary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAEhF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAc9F"}
+{"version":3,"file":"ciSummary.d.ts","sourceRoot":"","sources":["../../../src/cli/analyzeDiff/ciSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAe7F"}

package/dist/cli/analyzeDiff/ciSummary.js

@@ -2,19 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatCiMarkdownSummary = formatCiMarkdownSummary;
 /**
- * Builds markdown summary for CI logs.
+ * Формирует markdown-сводку семантического diff для CI-логов.
+ * @param report унифицированный diff-отчёт
+ * @param reportPath путь к сохранённому отчёту
+ * @returns markdown-текст для вывода в CI
  */
 function formatCiMarkdownSummary(report, reportPath) {
-    const reasons = report.recommendation.reasons.map(reason => `- \`${reason}\``).join('\n');
+    const semantic = report.semantic;
+    const reasons = semantic.recommendation.reasons.map(reason => `- \`${reason}\``).join('\n');
     return [
         '### OpenAPI Semantic Diff',
         `- Report: \`${reportPath}\``,
         `- Schema Version: \`${report.schemaVersion}\``,
-        `- Recommendation: \`${report.recommendation.semver}\` (confidence: \`${report.recommendation.confidence}\`)`,
-        `- Reason: ${report.recommendation.reason}`,
+        `- Recommendation: \`${semantic.recommendation.semver}\` (confidence: \`${semantic.recommendation.confidence}\`)`,
+        `- Reason: ${semantic.recommendation.reason}`,
         '- Reason Codes:',
         reasons,
-        `- Summary: breaking=\`${report.summary.breaking}\`, nonBreaking=\`${report.summary.nonBreaking}\`, informational=\`${report.summary.informational}\``,
-        `- Governance: errors=\`${report.governance.summary.errors}\`, warnings=\`${report.governance.summary.warnings}\`, info=\`${report.governance.summary.info}\``,
+        `- Summary: breaking=\`${semantic.summary.breaking}\`, nonBreaking=\`${semantic.summary.nonBreaking}\`, informational=\`${semantic.summary.informational}\``,
+        `- Governance: errors=\`${semantic.governance.summary.errors}\`, warnings=\`${semantic.governance.summary.warnings}\`, info=\`${semantic.governance.summary.info}\``,
     ].join('\n');
 }

package/dist/cli/analyzeDiff/ignoreRules.d.ts

@@ -1,10 +1,4 @@
 import type { DiffEntry, IgnoreRule } from './types';
-/**
- * Проверяет, активно ли правило игнорирования по полю `until`.
- * @param rule правило игнорирования
- * @returns true если правило активно или не содержит валидной даты
- */
-export declare const isRuleActive: (rule: IgnoreRule) => boolean;
 /**
  * Проверяет, соответствует ли запись diff правилу игнорирования.
  * Совмещает полное совпадение пути, префикс и регулярные выражения.
@@ -13,21 +7,5 @@ export declare const isRuleActive: (rule: IgnoreRule) => boolean;
  * @returns true если правило применимо к записи
  */
 export declare const matchesIgnoreRule: (entry: DiffEntry, rule: IgnoreRule) => boolean;
-/**
- * Применяет набор правил игнорирования к массиву записей и возвращает отфильтрованные записи и число игнорированных.
- * @param entries список записей diff
- * @param rules список правил игнорирования
- * @returns объект с полем filtered и числом ignored
- */
-export declare const applyIgnoreRules: (entries: DiffEntry[], rules: IgnoreRule[]) => {
-    filtered: DiffEntry[];
-    ignored: number;
-};
-/**
- * Извлекает правила игнорирования из загруженной конфигурации openapi.
- * @param configData загруженные данные конфигурации
- * @returns список правил ignore
- */
-export declare const getIgnoreRulesFromConfig: (configData: Record<string, any> | Record<string, any>[] | null) => IgnoreRule[];
 export declare const loadIgnoreRules: (openapiConfigPath?: string) => IgnoreRule[];
 //# sourceMappingURL=ignoreRules.d.ts.map

package/dist/cli/analyzeDiff/ignoreRules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ignoreRules.d.ts","sourceRoot":"","sources":["../../../src/cli/analyzeDiff/ignoreRules.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,UAAU,KAAG,OAK/C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,SAAS,EAAE,MAAM,UAAU,KAAG,OAkBtE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,SAAS,EAAE,EAAE,OAAO,UAAU,EAAE,KAAG;IAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAapH,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACjC,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,KAC/D,UAAU,EAOZ,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,oBAAoB,MAAM,KAAG,UAAU,EAGtE,CAAC"}
+{"version":3,"file":"ignoreRules.d.ts","sourceRoot":"","sources":["../../../src/cli/analyzeDiff/ignoreRules.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAcrD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,SAAS,EAAE,MAAM,UAAU,KAAG,OAkBtE,CAAC;AAgBF,eAAO,MAAM,eAAe,GAAI,oBAAoB,MAAM,KAAG,UAAU,EAGtE,CAAC"}

package/dist/cli/analyzeDiff/ignoreRules.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadIgnoreRules = exports.getIgnoreRulesFromConfig = exports.applyIgnoreRules = exports.matchesIgnoreRule = exports.isRuleActive = void 0;
+exports.loadIgnoreRules = exports.matchesIgnoreRule = void 0;
 const Consts_1 = require("../../common/Consts");
 const LoggerMessages_1 = require("../../common/LoggerMessages");
 const loadConfigIfExists_1 = require("../../common/utils/loadConfigIfExists");
@@ -17,7 +17,6 @@ const isRuleActive = (rule) => {
         return true;
     return Date.now() <= timestamp;
 };
-exports.isRuleActive = isRuleActive;
 /**
  * Проверяет, соответствует ли запись diff правилу игнорирования.
  * Совмещает полное совпадение пути, префикс и регулярные выражения.
@@ -26,7 +25,7 @@ exports.isRuleActive = isRuleActive;
  * @returns true если правило применимо к записи
  */
 const matchesIgnoreRule = (entry, rule) => {
-    if (!(0, exports.isRuleActive)(rule))
+    if (!isRuleActive(rule))
         return false;
     if (rule.path) {
         if (entry.path === rule.path)
@@ -51,26 +50,6 @@ const matchesIgnoreRule = (entry, rule) => {
     return false;
 };
 exports.matchesIgnoreRule = matchesIgnoreRule;
-/**
- * Применяет набор правил игнорирования к массиву записей и возвращает отфильтрованные записи и число игнорированных.
- * @param entries список записей diff
- * @param rules список правил игнорирования
- * @returns объект с полем filtered и числом ignored
- */
-const applyIgnoreRules = (entries, rules) => {
-    if (!rules.length) {
-        return { filtered: entries, ignored: 0 };
-    }
-    let ignored = 0;
-    const filtered = entries.filter(entry => {
-        const shouldIgnore = rules.some(rule => (0, exports.matchesIgnoreRule)(entry, rule));
-        if (shouldIgnore)
-            ignored += 1;
-        return !shouldIgnore;
-    });
-    return { filtered, ignored };
-};
-exports.applyIgnoreRules = applyIgnoreRules;
 /**
  * Извлекает правила игнорирования из загруженной конфигурации openapi.
  * @param configData загруженные данные конфигурации
@@ -85,9 +64,8 @@ const getIgnoreRulesFromConfig = (configData) => {
     }
     return configData.analyze?.ignore ?? [];
 };
-exports.getIgnoreRulesFromConfig = getIgnoreRulesFromConfig;
 const loadIgnoreRules = (openapiConfigPath) => {
     const configData = (0, loadConfigIfExists_1.loadConfigIfExists)(openapiConfigPath);
-    return (0, exports.getIgnoreRulesFromConfig)(configData);
+    return getIgnoreRulesFromConfig(configData);
 };
 exports.loadIgnoreRules = loadIgnoreRules;