@appland/appmap 3.84.2 → 3.86.0

package/built/cmds/compare/compare.js

@@ -0,0 +1,121 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.builder = exports.describe = exports.command = void 0;
+const readline_1 = __importDefault(require("readline"));
+const path_1 = require("path");
+const promises_1 = require("fs/promises");
+const handleWorkingDirectory_1 = require("../../lib/handleWorkingDirectory");
+const detectRevisions_1 = __importDefault(require("./detectRevisions"));
+const prepareOutputDir_1 = require("./prepareOutputDir");
+const utils_1 = require("../../utils");
+const loadAppMapConfig_1 = __importDefault(require("../../lib/loadAppMapConfig"));
+const ChangeReporter_1 = __importStar(require("./ChangeReporter"));
+exports.command = 'compare';
+exports.describe = 'Compare runtime code behavior between base and head revisions';
+const builder = (args) => {
+    args.option('directory', {
+        describe: 'program working directory',
+        type: 'string',
+        alias: 'd',
+    });
+    args.option('base-revision', {
+        describe: 'base revision name or commit SHA.',
+        alias: ['b', 'base'],
+        demandOption: true,
+    });
+    args.option('head-revision', {
+        describe: 'head revision name or commit SHA. By default, use the current commit.',
+        alias: ['h', 'head'],
+    });
+    args.option('output-dir', {
+        describe: 'directory in which to save the report files. Default is ./.appmap/change-report/<base-revision>-<head-revision>.',
+    });
+    args.option('clobber-output-dir', {
+        describe: 'remove the output directory if it exists',
+        type: 'boolean',
+        default: false,
+    });
+    args.option('source-dir', {
+        describe: 'root directory of the application source code',
+        type: 'string',
+        default: '.',
+    });
+    args.option('delete-unreferenced', {
+        describe: 'whether to delete AppMaps from base and head that are unreferenced by the change report',
+        default: true,
+        alias: 'delete-unchanged',
+    });
+    args.option('report-removed', {
+        describe: 'whether to report removed findings, such as removed API routes, resolved findings, etc',
+        default: true,
+    });
+    return args.strict();
+};
+exports.builder = builder;
+const handler = async (argv) => {
+    (0, utils_1.verbose)(argv.verbose);
+    const rl = readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const { directory, sourceDir: srcDir, baseRevision: baseRevisionArg, outputDir: outputDirArg, headRevision: headRevisionArg, deleteUnreferenced, reportRemoved, } = argv;
+    try {
+        (0, handleWorkingDirectory_1.handleWorkingDirectory)(directory);
+        const appmapConfig = await (0, loadAppMapConfig_1.default)();
+        if (!appmapConfig)
+            throw new Error(`Unable to load appmap.yml config file`);
+        let scannerConfig;
+        try {
+            scannerConfig = await (0, promises_1.readFile)((0, path_1.join)(srcDir, 'appmap-scanner.yml'), 'utf-8');
+            console.debug(`Using scanner configuration from appmap-scanner.yml`);
+        }
+        catch (e) {
+            console.debug(`Unable to load appmap-scanner.yml. Will use default scanner configuration.`);
+        }
+        const { baseRevision, headRevision } = await (0, detectRevisions_1.default)(baseRevisionArg, headRevisionArg);
+        const outputDir = await (0, prepareOutputDir_1.prepareOutputDir)(outputDirArg, baseRevision, headRevision, argv.clobberOutputDir, rl);
+        const changeReporter = new ChangeReporter_1.default(baseRevision, headRevision, outputDir, srcDir);
+        await changeReporter.initialize();
+        const options = new ChangeReporter_1.ChangeReportOptions();
+        options.reportRemoved = reportRemoved;
+        const report = await changeReporter.report(options);
+        if (deleteUnreferenced) {
+            await changeReporter.deleteUnreferencedAppMaps();
+        }
+        await (0, promises_1.writeFile)((0, path_1.join)(outputDir, 'change-report.json'), JSON.stringify(report, null, 2));
+    }
+    catch (e) {
+        throw e;
+    }
+    finally {
+        rl.close();
+    }
+};
+exports.handler = handler;
+//# sourceMappingURL=compare.js.map

package/built/cmds/compare/compare.js.map

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

package/built/cmds/compare/detectRevisions.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const executeCommand_1 = require("../../lib/executeCommand");
+const ui_1 = require("./ui");
+const ValidationError_1 = require("./ValidationError");
+async function detectRevisions(baseRevision, headArg) {
+    let headRevision = headArg;
+    if (!headRevision) {
+        let currentBranch = (await (0, executeCommand_1.executeCommand)(`git rev-parse HEAD`)).trim().split('\n')[0];
+        headRevision = currentBranch;
+    }
+    console.log((0, ui_1.prominentStyle)(`Current revision is: ${headRevision}`));
+    if (baseRevision === headRevision) {
+        throw new ValidationError_1.ValidationError(`Base and head revisions are the same: ${baseRevision}`);
+    }
+    return { baseRevision, headRevision };
+}
+exports.default = detectRevisions;
+//# sourceMappingURL=detectRevisions.js.map

package/built/cmds/compare/detectRevisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectRevisions.js","sourceRoot":"","sources":["../../../src/cmds/compare/detectRevisions.ts"],"names":[],"mappings":";;AAAA,6DAA0D;AAC1D,6BAAsC;AACtC,uDAAoD;AAErC,KAAK,UAAU,eAAe,CAC3C,YAAoB,EACpB,OAAe;IAEf,IAAI,YAAY,GAAG,OAAO,CAAC;IAC3B,IAAI,CAAC,YAAY,EAAE;QACjB,IAAI,aAAa,GAAG,CAAC,MAAM,IAAA,+BAAc,EAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvF,YAAY,GAAG,aAAa,CAAC;KAC9B;IAED,OAAO,CAAC,GAAG,CAAC,IAAA,mBAAc,EAAC,wBAAwB,YAAY,EAAE,CAAC,CAAC,CAAC;IAEpE,IAAI,YAAY,KAAK,YAAY,EAAE;QACjC,MAAM,IAAI,iCAAe,CAAC,yCAAyC,YAAY,EAAE,CAAC,CAAC;KACpF;IAED,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AACxC,CAAC;AAlBD,kCAkBC"}

package/built/cmds/compare/loadFindings.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const assert_1 = __importDefault(require("assert"));
+const semver_1 = require("semver");
+const executeCommand_1 = require("../../lib/executeCommand");
+const promises_1 = require("fs/promises");
+const utils_1 = require("../../utils");
+async function loadFindings(paths, revisionName, appMapDir) {
+    const manifest = JSON.parse(await (0, promises_1.readFile)(paths.manifestPath(revisionName), 'utf-8'));
+    const findings = new Array();
+    const collectFindings = (findings) => {
+        return async (findingsFile) => {
+            const findingsData = JSON.parse(await (0, promises_1.readFile)(findingsFile, 'utf-8'));
+            findings.push(...findingsData.findings);
+        };
+    };
+    let archiveVersion = manifest.versions.archive;
+    (0, assert_1.default)(archiveVersion);
+    if (archiveVersion.split('.').length === 2)
+        archiveVersion += '.0';
+    if (new semver_1.SemVer(archiveVersion).compare('1.3.0') < 0) {
+        const workingDir = paths.revisionPath(revisionName);
+        console.info(`Scanning ${revisionName} revision for findings (archive version: ${archiveVersion}).`);
+        let command = `npx @appland/scanner@latest scan -d ${workingDir} --all`;
+        await (0, executeCommand_1.executeCommand)(command);
+        // Pre-1.3.0 archive. Scan and load findings the old way.
+        const scanResults = JSON.parse(await (0, promises_1.readFile)(paths.findingsPath(revisionName), 'utf-8'));
+        findings.push(...(scanResults.findings || []));
+    }
+    else {
+        await (0, utils_1.processNamedFiles)(paths.revisionPath(revisionName), 'appmap-findings.json', collectFindings(findings));
+    }
+    console.info(`Found ${findings.length} findings for ${revisionName} revision`);
+    for (const finding of findings) {
+        if (finding.appMapFile.startsWith(appMapDir)) {
+            finding.appMapFile = finding.appMapFile.slice(appMapDir.length + 1);
+        }
+    }
+    return findings;
+}
+exports.default = loadFindings;
+//# sourceMappingURL=loadFindings.js.map

package/built/cmds/compare/loadFindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadFindings.js","sourceRoot":"","sources":["../../../src/cmds/compare/loadFindings.ts"],"names":[],"mappings":";;;;;AAAA,oDAA4B;AAK5B,mCAAgC;AAChC,6DAA0D;AAC1D,0CAAuC;AACvC,uCAAgD;AAEjC,KAAK,UAAU,YAAY,CACxC,KAAY,EACZ,YAA0B,EAC1B,SAAiB;IAEjB,MAAM,QAAQ,GAAoB,IAAI,CAAC,KAAK,CAC1C,MAAM,IAAA,mBAAQ,EAAC,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAC1D,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,KAAK,EAAW,CAAC;IAEtC,MAAM,eAAe,GAAG,CAAC,QAAmB,EAA6C,EAAE;QACzF,OAAO,KAAK,EAAE,YAAoB,EAAE,EAAE;YACpC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,mBAAQ,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;YACvE,QAAQ,CAAC,IAAI,CAAC,GAAI,YAAY,CAAC,QAAsB,CAAC,CAAC;QACzD,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,IAAI,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC/C,IAAA,gBAAM,EAAC,cAAc,CAAC,CAAC;IACvB,IAAI,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,cAAc,IAAI,IAAI,CAAC;IACnE,IAAI,IAAI,eAAM,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACnD,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CACV,YAAY,YAAY,4CAA4C,cAAc,IAAI,CACvF,CAAC;QACF,IAAI,OAAO,GAAG,uCAAuC,UAAU,QAAQ,CAAC;QACxE,MAAM,IAAA,+BAAc,EAAC,OAAO,CAAC,CAAC;QAE9B,yDAAyD;QACzD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,mBAAQ,EAAC,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1F,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;KAChD;SAAM;QACL,MAAM,IAAA,yBAAiB,EACrB,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,EAChC,sBAAsB,EACtB,eAAe,CAAC,QAAQ,CAAC,CAC1B,CAAC;KACH;IAED,OAAO,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,iBAAiB,YAAY,WAAW,CAAC,CAAC;IAE/E,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;QAC9B,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;YAC5C,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;SACrE;KACF;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAhDD,+BAgDC"}

package/built/cmds/compare/loadSequenceDiagram.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSequenceDiagram = void 0;
+const promises_1 = require("fs/promises");
+const sequence_diagram_1 = require("@appland/sequence-diagram");
+async function loadSequenceDiagram(path) {
+    const diagramData = JSON.parse(await (0, promises_1.readFile)(path, 'utf-8'));
+    return (0, sequence_diagram_1.unparseDiagram)(diagramData);
+}
+exports.loadSequenceDiagram = loadSequenceDiagram;
+//# sourceMappingURL=loadSequenceDiagram.js.map

package/built/cmds/compare/loadSequenceDiagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadSequenceDiagram.js","sourceRoot":"","sources":["../../../src/cmds/compare/loadSequenceDiagram.ts"],"names":[],"mappings":";;;AAAA,0CAAuC;AACvC,gEAAuF;AAEhF,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,mBAAQ,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,OAAO,IAAA,iCAAc,EAAC,WAAW,CAAC,CAAC;AACrC,CAAC;AAHD,kDAGC"}

package/built/cmds/compare/mapToRecord.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function mapToRecord(map) {
+    return [...map.entries()].reduce((memo, entry) => {
+        const [key, value] = entry;
+        memo[key] = value;
+        return memo;
+    }, {});
+}
+exports.default = mapToRecord;
+//# sourceMappingURL=mapToRecord.js.map

package/built/cmds/compare/mapToRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapToRecord.js","sourceRoot":"","sources":["../../../src/cmds/compare/mapToRecord.ts"],"names":[],"mappings":";;AAAA,SAAwB,WAAW,CACjC,GAA2B;IAE3B,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/C,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AARD,8BAQC"}

package/built/cmds/compare/prepareOutputDir.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareOutputDir = void 0;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const utils_1 = require("../../utils");
+const RevisionName_1 = require("./RevisionName");
+const ui_1 = require("./ui");
+const ValidationError_1 = require("./ValidationError");
+async function prepareOutputDir(outputDirArg, baseRevision, headRevision, clobberOutputDir, rl) {
+    let outputDir = outputDirArg;
+    if (!outputDir) {
+        outputDir = `.appmap/change-report/${(0, ui_1.sanitizeRevision)(baseRevision)}-${(0, ui_1.sanitizeRevision)(headRevision)}`;
+    }
+    for (const revision of [RevisionName_1.RevisionName.Base, RevisionName_1.RevisionName.Head]) {
+        if (!(await (0, utils_1.exists)((0, path_1.join)(outputDir, revision))))
+            throw new ValidationError_1.ValidationError(`${revision} revision data (${(0, path_1.join)(outputDir, revision)}) does not exist`);
+    }
+    const diffDir = (0, path_1.join)(outputDir, RevisionName_1.RevisionName.Diff);
+    if (await (0, utils_1.exists)(diffDir)) {
+        if (!clobberOutputDir &&
+            process.stdout.isTTY &&
+            !(await (0, ui_1.confirm)(`Delete existing 'diff' in ${diffDir}?`, rl))) {
+            throw new ValidationError_1.ValidationError(`The 'diff' data directory ${diffDir} exists and you chose not to delete it`);
+        }
+        await (0, promises_1.rm)(diffDir, { recursive: true, force: true });
+        // Rapid rm and then mkdir will silently fail in practice.
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    await (0, promises_1.mkdir)((0, path_1.join)(outputDir, RevisionName_1.RevisionName.Diff), { recursive: true });
+    return outputDir;
+}
+exports.prepareOutputDir = prepareOutputDir;
+//# sourceMappingURL=prepareOutputDir.js.map

package/built/cmds/compare/prepareOutputDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareOutputDir.js","sourceRoot":"","sources":["../../../src/cmds/compare/prepareOutputDir.ts"],"names":[],"mappings":";;;AAAA,0CAAwC;AACxC,+BAA4B;AAE5B,uCAAqC;AACrC,iDAA8C;AAC9C,6BAAiD;AACjD,uDAAoD;AAE7C,KAAK,UAAU,gBAAgB,CACpC,YAAiB,EACjB,YAAoB,EACpB,YAAoB,EACpB,gBAAyB,EACzB,EAAsB;IAEtB,IAAI,SAAS,GAAG,YAAY,CAAC;IAC7B,IAAI,CAAC,SAAS,EAAE;QACd,SAAS,GAAG,yBAAyB,IAAA,qBAAgB,EAAC,YAAY,CAAC,IAAI,IAAA,qBAAgB,EACrF,YAAY,CACb,EAAE,CAAC;KACL;IAED,KAAK,MAAM,QAAQ,IAAI,CAAC,2BAAY,CAAC,IAAI,EAAE,2BAAY,CAAC,IAAI,CAAC,EAAE;QAC7D,IAAI,CAAC,CAAC,MAAM,IAAA,cAAM,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC5C,MAAM,IAAI,iCAAe,CACvB,GAAG,QAAQ,mBAAmB,IAAA,WAAI,EAAC,SAAS,EAAE,QAAQ,CAAC,kBAAkB,CAC1E,CAAC;KACL;IAED,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,2BAAY,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,MAAM,IAAA,cAAM,EAAC,OAAO,CAAC,EAAE;QACzB,IACE,CAAC,gBAAgB;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK;YACpB,CAAC,CAAC,MAAM,IAAA,YAAO,EAAC,6BAA6B,OAAO,GAAG,EAAE,EAAE,CAAC,CAAC,EAC7D;YACA,MAAM,IAAI,iCAAe,CACvB,6BAA6B,OAAO,wCAAwC,CAC7E,CAAC;SACH;QACD,MAAM,IAAA,aAAE,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,0DAA0D;QAC1D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;KAChE;IAED,MAAM,IAAA,gBAAK,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,2BAAY,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAErE,OAAO,SAAS,CAAC;AACnB,CAAC;AAxCD,4CAwCC"}

package/built/cmds/compare/ui.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeRevision = exports.mutedStyle = exports.prominentStyle = exports.actionStyle = exports.confirm = exports.ask = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+async function ask(rl, q) {
+    return new Promise((resolve) => {
+        rl.question(q, resolve);
+    });
+}
+exports.ask = ask;
+async function confirm(prompt, rl) {
+    let response = '';
+    while (!['y', 'n'].includes(response)) {
+        response = await ask(rl, `${prompt} (y/n) `);
+    }
+    return response === 'y';
+}
+exports.confirm = confirm;
+function actionStyle(message) {
+    return chalk_1.default.bold(chalk_1.default.green(message));
+}
+exports.actionStyle = actionStyle;
+function prominentStyle(message) {
+    return chalk_1.default.bold(message);
+}
+exports.prominentStyle = prominentStyle;
+function mutedStyle(message) {
+    return chalk_1.default.dim(message);
+}
+exports.mutedStyle = mutedStyle;
+function sanitizeRevision(revision) {
+    return revision.replace(/[^a-zA-Z0-9_]/g, '_');
+}
+exports.sanitizeRevision = sanitizeRevision;
+//# sourceMappingURL=ui.js.map

package/built/cmds/compare/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../src/cmds/compare/ui.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAGnB,KAAK,UAAU,GAAG,CAAC,EAAsB,EAAE,CAAS;IACzD,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAJD,kBAIC;AAEM,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,EAAsB;IAClE,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QACrC,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE,EAAE,GAAG,MAAM,SAAS,CAAC,CAAC;KAC9C;IACD,OAAO,QAAQ,KAAK,GAAG,CAAC;AAC1B,CAAC;AAND,0BAMC;AAED,SAAgB,WAAW,CAAC,OAAe;IACzC,OAAO,eAAK,CAAC,IAAI,CAAC,eAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC;AAFD,kCAEC;AAED,SAAgB,cAAc,CAAC,OAAe;IAC5C,OAAO,eAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAFD,wCAEC;AAED,SAAgB,UAAU,CAAC,OAAe;IACxC,OAAO,eAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC;AAFD,gCAEC;AAED,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AAFD,4CAEC"}

package/built/cmds/compare-report/MarkdownReport.js

@@ -0,0 +1,197 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const handlebars_1 = __importDefault(require("handlebars"));
+const path_1 = require("path");
+const assert_1 = __importDefault(require("assert"));
+const executeCommand_1 = require("../../lib/executeCommand");
+const utils_1 = require("../../utils");
+const TemplateFile = [
+    '../../../resources/change-report.hbs',
+    '../../../../resources/change-report.hbs', // In development
+]
+    .map((fileName) => (0, path_1.join)(__dirname, fileName))
+    .find((fileName) => (0, fs_1.existsSync)(fileName));
+function isURL(path) {
+    try {
+        new URL(path);
+        return true;
+    }
+    catch (e) {
+        return false;
+    }
+}
+class MarkdownReport {
+    constructor(appmapURL, sourceURL) {
+        this.appmapURL = appmapURL;
+        this.sourceURL = sourceURL;
+    }
+    async generateReport(changeReport, baseDir) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        (0, assert_1.default)(TemplateFile, "Report template file 'change-report.hbs' not found");
+        const Template = handlebars_1.default.compile((0, fs_1.readFileSync)(TemplateFile, 'utf8'));
+        // Remove the empty sequence diagram diff snippet - which can't be reasonably rendered.
+        delete changeReport.sequenceDiagramDiff[''];
+        // Resolve changedAppMap entry for a test failure. Note that this will not help much
+        // with new test cases that fail, but it will help with modified tests that fail.
+        changeReport.testFailures.forEach((failure) => {
+            const changedAppMap = changeReport.changedAppMaps.find((change) => change.appmap === failure.appmap);
+            if (changedAppMap) {
+                failure.changedAppMap = changedAppMap;
+            }
+        });
+        const appmapNames = new Map();
+        for (const { appmap } of changeReport.testFailures) {
+            const metadata = JSON.parse(await (0, promises_1.readFile)((0, path_1.join)('head', appmap, 'metadata.json'), 'utf-8'));
+            appmapNames.set(appmap, metadata.name.replace(/_/g, ' '));
+        }
+        // Resolve the test location to a source path relative to baseDir.
+        changeReport.testFailures
+            .filter((failure) => failure.testLocation)
+            .forEach((failure) => {
+            const tokens = failure.testLocation.split(':');
+            tokens.pop();
+            let testPath = tokens.join(':');
+            let path;
+            if (isURL(baseDir)) {
+                path = new URL(testPath, baseDir).toString();
+            }
+            else {
+                path = (0, path_1.join)(baseDir, testPath);
+            }
+            failure.testPath = path;
+            failure.testName = appmapNames.get(failure.appmap) || testPath;
+            if (failure.testSnippet) {
+                const [, lineno] = (failure.failureLocation || '').split(':');
+                failure.failureLine = lineno;
+                failure.testSnippet.codeFragment = failure.testSnippet.codeFragment
+                    .split('\n')
+                    .map((line, index) => `${(index + failure.testSnippet.startLine).toString() === lineno ? '> ' : '  '} ${index + failure.testSnippet.startLine}: ${line}`)
+                    .join('\n');
+            }
+        });
+        const wordify = (s) => s.replace(/([-_])/g, ' ').toLowerCase();
+        const capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+        const explainAPIChange = (change) => {
+            const { action, entity } = change;
+            const entityTokens = entity.split('.');
+            change.title = [capitalize(wordify(action)), ...entityTokens.map(wordify)].join(' ');
+        };
+        if (changeReport.apiDiff) {
+            (_a = changeReport.apiDiff.breakingDifferences) === null || _a === void 0 ? void 0 : _a.forEach(explainAPIChange);
+            (_b = changeReport.apiDiff.nonBreakingDifferences) === null || _b === void 0 ? void 0 : _b.forEach(explainAPIChange);
+            (_c = changeReport.apiDiff.unclassifiedDifferences) === null || _c === void 0 ? void 0 : _c.forEach(explainAPIChange);
+            // Provide a simple count of the number of differences - since Handlebars can't do math.
+            changeReport.apiDiff.differenceCount =
+                (((_d = changeReport.apiDiff.breakingDifferences) === null || _d === void 0 ? void 0 : _d.length) || 0) +
+                    (((_e = changeReport.apiDiff.nonBreakingDifferences) === null || _e === void 0 ? void 0 : _e.length) || 0) +
+                    (((_f = changeReport.apiDiff.unclassifiedDifferences) === null || _f === void 0 ? void 0 : _f.length) || 0);
+            changeReport.apiDiff.breakingDifferenceCount =
+                ((_g = changeReport.apiDiff.breakingDifferences) === null || _g === void 0 ? void 0 : _g.length) || 0;
+            changeReport.apiDiff.nonBreakingDifferenceCount =
+                ((_h = changeReport.apiDiff.nonBreakingDifferences) === null || _h === void 0 ? void 0 : _h.length) || 0;
+            if (changeReport.apiDiff.differenceCount > 0) {
+                const sourceDiff = (await (0, executeCommand_1.executeCommand)(`diff -u base/openapi.yml head/openapi.yml`, (0, utils_1.verbose)(), (0, utils_1.verbose)(), (0, utils_1.verbose)(), [0, 1])).trim();
+                changeReport.apiDiff.sourceDiff = sourceDiff;
+            }
+        }
+        changeReport.sequenceDiagramDiffSnippetCount = Object.keys(changeReport.sequenceDiagramDiff || {}).length;
+        if (changeReport.findingDiff) {
+            Object.keys(changeReport.findingDiff).forEach((key) => {
+                (0, assert_1.default)(changeReport.findingDiff);
+                changeReport.findingDiff[key].forEach((finding) => (finding.appmap = finding.appMapFile));
+            });
+        }
+        const self = this;
+        handlebars_1.default.registerHelper('inspect', function (value) {
+            return new handlebars_1.default.SafeString(JSON.stringify(value, null, 2));
+        });
+        handlebars_1.default.registerHelper('length', function (...list) {
+            let result = 0;
+            for (const item of list) {
+                if (Array.isArray(item)) {
+                    result += item.length;
+                }
+            }
+            return result;
+        });
+        handlebars_1.default.registerHelper('has_source_diff', function (appmap) {
+            if (appmap.endsWith('.appmap.json'))
+                appmap = appmap.slice(0, '.appmap.json'.length * -1);
+            const changedAppMap = changeReport.changedAppMaps.find((change) => change.appmap === appmap);
+            return !!changedAppMap && !!changedAppMap.sourceDiff;
+        });
+        handlebars_1.default.registerHelper('source_diff', function (appmap) {
+            var _a;
+            if (appmap.endsWith('.appmap.json'))
+                appmap = appmap.slice(0, '.appmap.json'.length * -1);
+            const diffText = (_a = changeReport.changedAppMaps.find((change) => change.appmap === appmap)) === null || _a === void 0 ? void 0 : _a.sourceDiff;
+            return diffText ? new handlebars_1.default.SafeString(diffText) : undefined;
+        });
+        handlebars_1.default.registerHelper('appmap_diff_url', function (diagram) {
+            if (diagram.startsWith('./'))
+                diagram = diagram.slice('./'.length);
+            if (diagram.startsWith('diff/'))
+                diagram = diagram.slice('diff/'.length);
+            if (diagram.endsWith('.diff.sequence.json'))
+                diagram = diagram.slice(0, '.diff.sequence.json'.length * -1);
+            const path = ['diff', `${diagram}.diff.sequence.json`].join('/');
+            if (self.appmapURL) {
+                const url = new URL(self.appmapURL.toString());
+                url.searchParams.append('path', path);
+                return new handlebars_1.default.SafeString(url.toString());
+            }
+            else {
+                return new handlebars_1.default.SafeString(path);
+            }
+        });
+        handlebars_1.default.registerHelper('appmap_url', function (dir, appmap) {
+            if (appmap.startsWith('./'))
+                appmap = appmap.slice('./'.length);
+            if (appmap.endsWith('.appmap.json'))
+                appmap = appmap.slice(0, '.appmap.json'.length * -1);
+            const path = [dir, `${appmap}.appmap.json`].join('/');
+            if (self.appmapURL) {
+                const url = new URL(self.appmapURL.toString());
+                url.searchParams.append('path', path);
+                return new handlebars_1.default.SafeString(url.toString());
+            }
+            else {
+                return new handlebars_1.default.SafeString(path);
+            }
+        });
+        handlebars_1.default.registerHelper('source_url', function (location, fileLinenoSeparator = '#L') {
+            if (typeof fileLinenoSeparator === 'object') {
+                fileLinenoSeparator = '#L';
+            }
+            const [path, lineno] = location.split(':');
+            if ((0, path_1.isAbsolute)(path))
+                return;
+            if (path.startsWith('vendor/') || path.startsWith('node_modules/'))
+                return;
+            if (self.sourceURL) {
+                const url = new URL(self.sourceURL.toString());
+                if (url.protocol === 'file:') {
+                    const sourcePath = (0, path_1.relative)(process.cwd(), (0, path_1.join)(url.pathname, path));
+                    return new handlebars_1.default.SafeString([sourcePath, lineno].filter(Boolean).join(fileLinenoSeparator));
+                }
+                else {
+                    url.pathname = (0, path_1.join)(url.pathname, path);
+                    if (lineno)
+                        url.hash = `L${lineno}`;
+                    return new handlebars_1.default.SafeString(url.toString());
+                }
+            }
+            else {
+                return new handlebars_1.default.SafeString(location);
+            }
+        });
+        return Template(changeReport);
+    }
+}
+exports.default = MarkdownReport;
+//# sourceMappingURL=MarkdownReport.js.map

package/built/cmds/compare-report/MarkdownReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownReport.js","sourceRoot":"","sources":["../../../src/cmds/compare-report/MarkdownReport.ts"],"names":[],"mappings":"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"}

package/built/cmds/compare-report/Report.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Report.js.map

package/built/cmds/compare-report/Report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Report.js","sourceRoot":"","sources":["../../../src/cmds/compare-report/Report.ts"],"names":[],"mappings":""}

package/built/cmds/compare-report/compareReport.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 });
+exports.handler = exports.builder = exports.describe = exports.command = void 0;
+const promises_1 = require("fs/promises");
+const handleWorkingDirectory_1 = require("../../lib/handleWorkingDirectory");
+const utils_1 = require("../../utils");
+const MarkdownReport_1 = __importDefault(require("./MarkdownReport"));
+exports.command = 'compare-report <report-directory>';
+exports.describe = 'Generate a report document from comparison data generated by the compare command.';
+const builder = (args) => {
+    args.positional('report-directory', {
+        describe: 'directory containing the comparison data',
+        type: 'string',
+        demandOption: true,
+    });
+    args.option('source-url', {
+        describe: `Base URL to link to a source file. The relative path to the source file will be added to the URL path.`,
+        type: 'string',
+    });
+    args.option('appmap-url', {
+        describe: `Base URL to link to AppMaps. A 'path' parameter will be added with the relative path from the report directory to the AppMap JSON file.`,
+        type: 'string',
+    });
+    args.option('directory', {
+        describe: 'program working directory',
+        type: 'string',
+        alias: 'd',
+    });
+    return args.strict();
+};
+exports.builder = builder;
+const handler = async (argv) => {
+    (0, utils_1.verbose)(argv.verbose);
+    const { directory } = argv;
+    (0, handleWorkingDirectory_1.handleWorkingDirectory)(directory);
+    const baseDir = process.cwd();
+    const { reportDirectory, sourceUrl, appmapUrl } = argv;
+    process.chdir(reportDirectory);
+    const report = JSON.parse(await (0, promises_1.readFile)('change-report.json', 'utf-8'));
+    const reportMD = await new MarkdownReport_1.default(appmapUrl, sourceUrl).generateReport(report, baseDir);
+    await (0, promises_1.writeFile)('report.md', reportMD);
+};
+exports.handler = handler;
+//# sourceMappingURL=compareReport.js.map

package/built/cmds/compare-report/compareReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareReport.js","sourceRoot":"","sources":["../../../src/cmds/compare-report/compareReport.ts"],"names":[],"mappings":";;;;;;AAAA,0CAAkD;AAElD,6EAA0E;AAC1E,uCAAsC;AAEtC,sEAA8C;AAEjC,QAAA,OAAO,GAAG,mCAAmC,CAAC;AAC9C,QAAA,QAAQ,GACnB,mFAAmF,CAAC;AAE/E,MAAM,OAAO,GAAG,CAAC,IAAgB,EAAE,EAAE;IAC1C,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE;QAClC,QAAQ,EAAE,0CAA0C;QACpD,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE;QACxB,QAAQ,EAAE,wGAAwG;QAClH,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE;QACxB,QAAQ,EAAE,yIAAyI;QACnJ,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;QACvB,QAAQ,EAAE,2BAA2B;QACrC,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,GAAG;KACX,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;AACvB,CAAC,CAAC;AAxBW,QAAA,OAAO,WAwBlB;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,IAAS,EAAE,EAAE;IACzC,IAAA,eAAO,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC3B,IAAA,+CAAsB,EAAC,SAAS,CAAC,CAAC;IAElC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE9B,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACvD,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAE/B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,mBAAQ,EAAC,oBAAoB,EAAE,OAAO,CAAC,CAAiB,CAAC;IACzF,MAAM,QAAQ,GAAG,MAAM,IAAI,wBAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChG,MAAM,IAAA,oBAAS,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC,CAAC;AAbW,QAAA,OAAO,WAalB"}

package/built/cmds/record/action/countAppMaps.js

@@ -6,7 +6,9 @@ async function countAppMaps(appMapDir) {
     // This function is too verbose to be useful in this context.
     const v = (0, utils_1.verbose)();
     (0, utils_1.verbose)(false);
-    await (0, utils_1.listAppMapFiles)(appMapDir, () => { fileCount += 1; });
+    await (0, utils_1.findFiles)(appMapDir, '.appmap.json', () => {
+        fileCount += 1;
+    });
     (0, utils_1.verbose)(v);
     return fileCount;
 }

package/built/cmds/record/action/countAppMaps.js.map

@@ -1 +1 @@
-{"version":3,"file":"countAppMaps.js","sourceRoot":"","sources":["../../../../src/cmds/record/action/countAppMaps.ts"],"names":[],"mappings":";;AAAA,0CAA0D;AAE3C,KAAK,UAAU,YAAY,CAAC,SAAiB;IAC1D,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,6DAA6D;IAC7D,MAAM,CAAC,GAAG,IAAA,eAAO,GAAE,CAAC;IACpB,IAAA,eAAO,EAAC,KAAK,CAAC,CAAC;IACf,MAAM,IAAA,uBAAe,EAAC,SAAS,EAAE,GAAG,EAAE,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAA,eAAO,EAAC,CAAC,CAAC,CAAC;IAEX,OAAO,SAAS,CAAC;AACnB,CAAC;AAVD,+BAUC"}
+{"version":3,"file":"countAppMaps.js","sourceRoot":"","sources":["../../../../src/cmds/record/action/countAppMaps.ts"],"names":[],"mappings":";;AAAA,0CAAoD;AAErC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAC1D,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,6DAA6D;IAC7D,MAAM,CAAC,GAAG,IAAA,eAAO,GAAE,CAAC;IACpB,IAAA,eAAO,EAAC,KAAK,CAAC,CAAC;IACf,MAAM,IAAA,iBAAS,EAAC,SAAS,EAAE,cAAc,EAAE,GAAG,EAAE;QAC9C,SAAS,IAAI,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IACH,IAAA,eAAO,EAAC,CAAC,CAAC,CAAC;IAEX,OAAO,SAAS,CAAC;AACnB,CAAC;AAZD,+BAYC"}

package/built/cmds/scan/ScanResult.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ScanResult.js.map

package/built/cmds/scan/ScanResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScanResult.js","sourceRoot":"","sources":["../../../src/cmds/scan/ScanResult.ts"],"names":[],"mappings":""}

package/built/cmds/scan/ScanTask.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isScanTask = void 0;
+function isScanTask(task) {
+    return task.name === 'scan';
+}
+exports.isScanTask = isScanTask;
+//# sourceMappingURL=ScanTask.js.map