@sasjs/cli 6.6.0 → 6.8.0

package/build/commands/job/internal/execute/viya.js

@@ -44,12 +44,14 @@ exports.getContextName = getContextName;
 var displayResult_1 = require("../../../../utils/displayResult");
 var file_1 = require("../../../../utils/file");
 var fetchLogFileContent_1 = require("../../../shared/fetchLogFileContent");
+var logcheck_1 = require("../../../../utils/logcheck");
+var utils_1 = require("../../../../utils/utils");
 var path_1 = __importDefault(require("path"));
 var node_1 = require("@sasjs/adapter/node");
-var utils_1 = require("@sasjs/utils");
-var utils_2 = require("../../../../utils/");
+var utils_2 = require("@sasjs/utils");
+var utils_3 = require("../../../../utils/");
 var command_1 = require("../../../../types/command");
-var utils_3 = require("../utils");
+var utils_4 = require("../utils");
 /**
  * Triggers existing job for execution on Viya server.
  * @param {object} sasjs - configuration object of SAS adapter.
@@ -90,23 +92,23 @@ function executeJobViya(sasjs, authConfig, jobPath, target, waitForJob, output,
                     if (!source) return [3 /*break*/, 5];
                     if (!(0, file_1.isJsonFile)(source))
                         throw 'Source file has to be JSON.';
-                    return [4 /*yield*/, (0, utils_1.fileExists)(source).catch(function (_) {
+                    return [4 /*yield*/, (0, utils_2.fileExists)(source).catch(function (_) {
                             throw 'Error while checking if source file exists.';
                         })];
                 case 3:
                     _c.sent();
-                    return [4 /*yield*/, (0, utils_1.readFile)(source).catch(function (_) {
+                    return [4 /*yield*/, (0, utils_2.readFile)(source).catch(function (_) {
                             throw 'Error while reading source file.';
                         })];
                 case 4:
                     source = _c.sent();
                     macroVars = JSON.parse(source);
-                    if (!(0, utils_1.isMacroVars)(macroVars)) {
+                    if (!(0, utils_2.isMacroVars)(macroVars)) {
                         throw "Provided source is not valid. An example of valid source:\n{ macroVars: { name1: 'value1', name2: 'value2' } }";
                     }
                     _c.label = 5;
                 case 5: return [4 /*yield*/, sasjs
-                        .startComputeJob(jobPath, null, { contextName: contextName }, authConfig, waitForJob || !!logFile, pollOptions, true, macroVars === null || macroVars === void 0 ? void 0 : macroVars.macroVars, undefined, (0, utils_2.persistTokensRefreshedByAdapter)(target))
+                        .startComputeJob(jobPath, null, { contextName: contextName }, authConfig, waitForJob || !!logFile, pollOptions, true, macroVars === null || macroVars === void 0 ? void 0 : macroVars.macroVars, undefined, (0, utils_3.persistTokensRefreshedByAdapter)(target))
                         .catch(function (err) { return __awaiter(_this, void 0, void 0, function () {
                         var logData;
                         var _a, _b;
@@ -121,7 +123,7 @@ function executeJobViya(sasjs, authConfig, jobPath, target, waitForJob, output,
                                 case 1:
                                     logData = _c.sent();
                                     // save log
-                                    return [4 /*yield*/, (0, utils_3.saveLog)(logData, logFile, jobPath)];
+                                    return [4 /*yield*/, (0, utils_4.saveLog)(logData, logFile, jobPath)];
                                 case 2:
                                     // save log
                                     _c.sent();
@@ -129,11 +131,11 @@ function executeJobViya(sasjs, authConfig, jobPath, target, waitForJob, output,
                                 case 3:
                                     (0, displayResult_1.displayError)(err);
                                     // terminate process with status code 2
-                                    (0, utils_2.terminateProcess)(2);
+                                    (0, utils_3.terminateProcess)(2);
                                     _c.label = 4;
                                 case 4:
                                     if (!(err === null || err === void 0 ? void 0 : err.log)) return [3 /*break*/, 6];
-                                    return [4 /*yield*/, (0, utils_3.saveLog)(err.log, logFile, jobPath)
+                                    return [4 /*yield*/, (0, utils_4.saveLog)(err.log, logFile, jobPath)
                                         // handle use case when job wasn't found
                                     ];
                                 case 5:
@@ -174,13 +176,13 @@ function executeJobViya(sasjs, authConfig, jobPath, target, waitForJob, output,
                     _c.sent();
                     _c.label = 8;
                 case 8:
-                    if (!(submittedJob && submittedJob.links)) return [3 /*break*/, 21];
+                    if (!(submittedJob && submittedJob.links)) return [3 /*break*/, 22];
                     if (!result)
                         result = true;
-                    if (!(output || logFile)) return [3 /*break*/, 20];
+                    if (!(output || logFile)) return [3 /*break*/, 21];
                     _c.label = 9;
                 case 9:
-                    _c.trys.push([9, 19, , 20]);
+                    _c.trys.push([9, 20, , 21]);
                     outputJson = JSON.stringify(submittedJob, null, 2);
                     if (!(typeof output === 'string')) return [3 /*break*/, 14];
                     currentDirPath = path_1.default.isAbsolute(output)
@@ -192,14 +194,14 @@ function executeJobViya(sasjs, authConfig, jobPath, target, waitForJob, output,
                     folderPath = outputPath.split(path_1.default.sep);
                     folderPath.pop();
                     parentFolderPath = folderPath.join(path_1.default.sep);
-                    return [4 /*yield*/, (0, utils_1.folderExists)(parentFolderPath)];
+                    return [4 /*yield*/, (0, utils_2.folderExists)(parentFolderPath)];
                 case 10:
                     if (!!(_c.sent())) return [3 /*break*/, 12];
-                    return [4 /*yield*/, (0, utils_1.createFolder)(parentFolderPath)];
+                    return [4 /*yield*/, (0, utils_2.createFolder)(parentFolderPath)];
                 case 11:
                     _c.sent();
                     _c.label = 12;
-                case 12: return [4 /*yield*/, (0, utils_1.createFile)(outputPath, outputJson)];
+                case 12: return [4 /*yield*/, (0, utils_2.createFile)(outputPath, outputJson)];
                 case 13:
                     _c.sent();
                     (0, displayResult_1.displaySuccess)("Output saved to: ".concat(outputPath));
@@ -212,50 +214,53 @@ function executeJobViya(sasjs, authConfig, jobPath, target, waitForJob, output,
                     }
                     _c.label = 15;
                 case 15:
-                    if (!(logFile && !pollOptions.streamLog)) return [3 /*break*/, 18];
+                    if (!(logFile && !pollOptions.streamLog)) return [3 /*break*/, 19];
                     logObj = submittedJob.links.find(function (link) { return link.rel === 'log' && link.method === 'GET'; });
-                    if (!logObj) return [3 /*break*/, 18];
+                    if (!logObj) return [3 /*break*/, 19];
                     logUrl = target.serverUrl + logObj.href;
                     logCount = submittedJob.logStatistics.lineCount;
                     return [4 /*yield*/, (0, fetchLogFileContent_1.fetchLogFileContent)(sasjs, authConfig.access_token, logUrl, logCount)];
                 case 16:
                     logData = _c.sent();
-                    return [4 /*yield*/, (0, utils_3.saveLog)(logData, logFile, jobPath)];
+                    return [4 /*yield*/, (0, utils_4.saveLog)(logData, logFile, jobPath)];
                 case 17:
                     _c.sent();
-                    _c.label = 18;
+                    return [4 /*yield*/, (0, logcheck_1.checkLog)(typeof logData === 'string' ? logData : (0, utils_1.parseLogLines)(logData), jobPath)];
                 case 18:
-                    result = submittedJob;
-                    return [3 /*break*/, 20];
+                    _c.sent();
+                    _c.label = 19;
                 case 19:
+                    result = submittedJob;
+                    return [3 /*break*/, 21];
+                case 20:
                     error_1 = _c.sent();
                     // handle use case when submitted job can't be parsed
                     result = false;
                     (0, displayResult_1.displayError)(null, 'An error has occurred when parsing an output of the job.');
-                    return [3 /*break*/, 20];
-                case 20:
+                    return [3 /*break*/, 21];
+                case 21:
                     // wait for job state and return status(0,1,2) based on it
                     if (waitForJob && submittedJob.state) {
                         switch (submittedJob.state) {
                             case 'completed':
-                                (0, utils_2.terminateProcess)(0);
+                                (0, utils_3.terminateProcess)(0);
                             case 'warning':
                                 // if ignoreWarnings flag is present, process will be terminated with
                                 // status code 0, otherwise status code will be 1
-                                (0, utils_2.terminateProcess)(ignoreWarnings ? 0 : 1);
+                                (0, utils_3.terminateProcess)(ignoreWarnings ? 0 : 1);
                             case 'error':
-                                (0, utils_2.terminateProcess)(2);
+                                (0, utils_3.terminateProcess)(2);
                             default:
                                 break;
                         }
                     }
-                    return [3 /*break*/, 22];
-                case 21:
+                    return [3 /*break*/, 23];
+                case 22:
                     if (result) {
-                        (0, utils_2.terminateProcess)(command_1.ReturnCode.InternalError);
+                        (0, utils_3.terminateProcess)(command_1.ReturnCode.InternalError);
                     }
-                    _c.label = 22;
-                case 22:
+                    _c.label = 23;
+                case 23:
                     (_b = process.logger) === null || _b === void 0 ? void 0 : _b.info("This job was executed in ".concat((endTime - startTime) / 1000, " seconds"));
                     return [2 /*return*/, result];
             }
@@ -271,7 +276,7 @@ function executeJobViya(sasjs, authConfig, jobPath, target, waitForJob, output,
 function getContextName(target) {
     var _a;
     // default execution context of @sasjs/cli
-    var defaultContextName = utils_2.contextName;
+    var defaultContextName = utils_3.contextName;
     // get gontext name from target
     if (target === null || target === void 0 ? void 0 : target.contextName)
         return target.contextName;
@@ -311,14 +316,14 @@ function displayStatus(submittedJob_1, statusFile_1) {
                     folderPath = statusFile.split(path_1.default.sep);
                     folderPath.pop();
                     parentFolderPath = folderPath.join(path_1.default.sep);
-                    return [4 /*yield*/, (0, utils_1.folderExists)(parentFolderPath)];
+                    return [4 /*yield*/, (0, utils_2.folderExists)(parentFolderPath)];
                 case 1:
                     if (!!(_a.sent())) return [3 /*break*/, 3];
-                    return [4 /*yield*/, (0, utils_1.createFolder)(parentFolderPath)];
+                    return [4 /*yield*/, (0, utils_2.createFolder)(parentFolderPath)];
                 case 2:
                     _a.sent();
                     _a.label = 3;
-                case 3: return [4 /*yield*/, (0, utils_1.createFile)(statusFile, status)
+                case 3: return [4 /*yield*/, (0, utils_2.createFile)(statusFile, status)
                     // display file path to status file
                 ];
                 case 4:

package/build/commands/job/jobCommand.js

@@ -62,6 +62,7 @@ var targetCommand_1 = require("../../types/command/targetCommand");
 var utils_2 = require("../../utils");
 var getLogFilePath_1 = require("../../utils/getLogFilePath");
 var prefixAppLoc_1 = require("../../utils/prefixAppLoc");
+var logcheck_1 = require("../../utils/logcheck");
 var execute_1 = require("./internal/execute");
 var node_1 = __importDefault(require("@sasjs/adapter/node"));
 var JobSubCommand;
@@ -126,6 +127,11 @@ var executeParseOptions = {
         alias: 'v',
         default: false,
         description: "If present, CLI will return status 0, 1 or 2 together with HTTP response summaries. If set to 'bleached', HTTP response summaries will be logged without extra colors."
+    },
+    logcheck: {
+        type: 'boolean',
+        default: undefined,
+        description: 'Check the SAS log this job returned, and fail when logCheck in sasjsconfig.json says so. --no-logcheck switches both the report and the verdict off.'
     }
 };
 var JobCommand = /** @class */ (function (_super) {
@@ -160,6 +166,7 @@ var JobCommand = /** @class */ (function (_super) {
             return __generator(this, function (_f) {
                 switch (_f.label) {
                     case 0:
+                        (0, logcheck_1.setLogCheckMode)((0, logcheck_1.logCheckModeOf)(this.parsed.logcheck));
                         returnStatusOnly = !!this.parsed.returnStatusOnly;
                         if (returnStatusOnly) {
                             process.logger.warn('--returnStatusOnly (-r) flag is deprecated.');
@@ -257,6 +264,8 @@ var JobCommand = /** @class */ (function (_super) {
                                 .catch(function (err) {
                                 var _a;
                                 // handle job execution failure
+                                if ((0, logcheck_1.isLogCheckFailure)(err))
+                                    return command_1.ReturnCode.LogCheckError;
                                 (_a = process.logger) === null || _a === void 0 ? void 0 : _a.error('Error executing job: ', err);
                                 return command_1.ReturnCode.InternalError;
                             })];
@@ -293,6 +302,8 @@ var JobCommand = /** @class */ (function (_super) {
                                 .catch(function (err) {
                                 var _a;
                                 // handle job execution failure
+                                if ((0, logcheck_1.isLogCheckFailure)(err))
+                                    return command_1.ReturnCode.LogCheckError;
                                 (_a = process.logger) === null || _a === void 0 ? void 0 : _a.error('Error executing job: ', err);
                                 return command_1.ReturnCode.InternalError;
                             })];
@@ -334,6 +345,8 @@ var JobCommand = /** @class */ (function (_super) {
                                 .catch(function (err) {
                                 var _a;
                                 // handle job execution failure
+                                if ((0, logcheck_1.isLogCheckFailure)(err))
+                                    return command_1.ReturnCode.LogCheckError;
                                 (_a = process.logger) === null || _a === void 0 ? void 0 : _a.error('Error executing job: ', err);
                                 return command_1.ReturnCode.InternalError;
                             })];

package/build/commands/job/spec/executeLogOrder.spec.d.ts

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

package/build/commands/job/spec/executeLogOrder.spec.js

@@ -0,0 +1,119 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var node_1 = __importDefault(require("@sasjs/adapter/node"));
+var jobUtils = __importStar(require("../internal/utils"));
+var logcheck = __importStar(require("../../../utils/logcheck"));
+var sas9_1 = require("../internal/execute/sas9");
+/**
+ * A run that fails the log check is the run whose log someone wants to read, so
+ * the file has to be written before the check can throw - otherwise `--log`
+ * produces nothing exactly when it is needed.
+ */
+describe('job execute log handling', function () {
+    beforeEach(function () {
+        process.logger = {
+            success: jest.fn(),
+            info: jest.fn(),
+            warn: jest.fn(),
+            error: jest.fn()
+        };
+    });
+    it('writes the log before a failing check can throw', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var sasjs, saveSpy, checkSpy;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    sasjs = new node_1.default();
+                    jest.spyOn(sasjs, 'request').mockResolvedValue({
+                        status: 200,
+                        log: 'ERROR 22-322: Syntax error',
+                        result: {}
+                    });
+                    saveSpy = jest
+                        .spyOn(jobUtils, 'saveLog')
+                        .mockResolvedValue(undefined);
+                    checkSpy = jest
+                        .spyOn(logcheck, 'checkLog')
+                        .mockRejectedValue(new Error('SAS log check failed'));
+                    return [4 /*yield*/, expect((0, sas9_1.executeJobSas9)(sasjs, {}, 'job/path', 'job.log')).rejects.toThrow('SAS log check failed')];
+                case 1:
+                    _a.sent();
+                    expect(saveSpy).toHaveBeenCalledWith('ERROR 22-322: Syntax error', 'job.log', 'job/path');
+                    expect(saveSpy.mock.invocationCallOrder[0]).toBeLessThan(checkSpy.mock.invocationCallOrder[0]);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});

package/build/commands/job/spec/jobCommand.spec.js

@@ -106,6 +106,7 @@ var utils_1 = require("@sasjs/utils");
 var SasjsUtilsFilesModule = __importStar(require("@sasjs/utils/file"));
 var configUtils = __importStar(require("../../../utils/config"));
 var command_1 = require("../../../types/command");
+var logcheck_1 = require("../../../utils/logcheck");
 var utilsModule = __importStar(require("../internal/utils"));
 var defaultArgs = ['node', 'sasjs', 'job', 'execute'];
 var targetViya = new utils_1.Target({
@@ -149,6 +150,37 @@ describe('JobCommand', function () {
         beforeEach(function () {
             setupMocksForViya();
         });
+        afterEach(function () { return (0, logcheck_1.setLogCheckMode)('auto'); });
+        it('should return the logcheck code when the log check failed the job', function () { return __awaiter(void 0, void 0, void 0, function () {
+            var args, _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        jest
+                            .spyOn(viyaExecuteModule, 'executeJobViya')
+                            .mockImplementation(function () {
+                            return Promise.reject(new logcheck_1.LogCheckFailure('2 errors'));
+                        });
+                        args = __spreadArray(__spreadArray([], __read(defaultArgs), false), [jobPath], false);
+                        _a = expect;
+                        return [4 /*yield*/, new jobCommand_1.JobCommand(args).execute()];
+                    case 1:
+                        _a.apply(void 0, [_b.sent()]).toEqual(command_1.ReturnCode.LogCheckError);
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        it('should switch the log check off for --no-logcheck', function () { return __awaiter(void 0, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, executeCommandWrapper([jobPath, '--no-logcheck'])];
+                    case 1:
+                        _a.sent();
+                        expect((0, logcheck_1.getLogCheckMode)()).toEqual('off');
+                        return [2 /*return*/];
+                }
+            });
+        }); });
         it('should parse sasjs job execute command', function () { return __awaiter(void 0, void 0, void 0, function () {
             var _a;
             return __generator(this, function (_b) {

package/build/commands/logcheck/collectLogs.d.ts

@@ -0,0 +1,60 @@
+import { LogIssue } from '@sasjs/utils/logs';
+import { LogCheckConfig, ScannedLog, SkippedFile } from './types';
+/** A log bigger than this is reported and skipped rather than read. */
+export declare const MAX_LOG_BYTES: number;
+export interface CollectedFiles {
+    /** Absolute paths of the files that will be read, in report order. */
+    files: string[];
+    /** Paths the user named that do not exist. */
+    missing: string[];
+    /**
+     * Folders that could not be listed, with the reason.
+     *
+     * A folder the process cannot read is not an empty folder: the logs inside
+     * it were never looked at, so it has to reach the report and it has to fail
+     * the gate - a check that goes green on a directory it could not open is
+     * worse than no check.
+     */
+    unreadable: SkippedFile[];
+}
+/**
+ * Expands the paths a user named into the files to read.
+ *
+ * A file is taken as it is; a folder is walked, because the reason a user
+ * points at `sasjsresults` is that they do not know which run left which log.
+ * Order is sorted so that two runs over the same folder produce the same
+ * report, which is what makes a diff of two reports readable.
+ */
+export declare const collectLogFiles: (paths: string[]) => Promise<CollectedFiles>;
+/**
+ * The path a report shows for a file: relative to the project folder where
+ * that is shorter and does not climb out of it, absolute otherwise.
+ *
+ * Forward slashes throughout, so a report generated on Windows and one
+ * generated on Linux describe the same log the same way, and so a path can be
+ * dropped into a CI annotation without escaping.
+ */
+export declare const toDisplayPath: (filePath: string) => string;
+/**
+ * Parses one log and splits its issues into the ones reported and the ones
+ * suppressed by message code.
+ *
+ * A file that is not a SAS log is skipped rather than reported as clean: a
+ * Python traceback and a shell build log both begin lines with `ERROR:`, and
+ * `isSasLog` is what tells them from the real thing.
+ */
+export declare const scanLogFile: (filePath: string, config: LogCheckConfig) => Promise<ScannedLog>;
+/**
+ * Splits parsed issues by the suppressed message codes.
+ *
+ * Matching is on the code alone, because that is what SAS keeps stable: the
+ * text of a note carries values from the data and changes between runs, while
+ * `49-169` means the same thing every time.
+ */
+export declare const partitionIssues: (issues: LogIssue[], ignoreCodes: string[]) => {
+    issues: LogIssue[];
+    suppressed: LogIssue[];
+};
+export declare const countIssues: (issues: LogIssue[]) => import("./types").IssueCounts;
+/** A file the check declined to open, as the report shows it. */
+export declare const toSkippedFile: (log: ScannedLog) => SkippedFile;