build-raptor 0.131.0 → 0.133.0

package/dist/deps/build-raptor-core/breakdown.js

@@ -0,0 +1,99 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Breakdown = void 0;
+const fse = __importStar(require("fs-extra"));
+const misc_1 = require("misc");
+const path = __importStar(require("path"));
+const task_name_1 = require("task-name");
+const unit_metadata_1 = require("unit-metadata");
+class Breakdown {
+    constructor(overallVerdict, buildRunId, summaries, rootDir, performanceReport, crashCause, message) {
+        this.overallVerdict = overallVerdict;
+        this.buildRunId = buildRunId;
+        this.summaries = summaries;
+        this.rootDir = rootDir;
+        this.performanceReport = performanceReport;
+        this.crashCause = crashCause;
+        this.message = message;
+    }
+    get exitCode() {
+        return (0, misc_1.switchOn)(this.overallVerdict, {
+            OK: () => 0,
+            CRASH: () => 1,
+            FAIL: () => 2,
+        });
+    }
+    getSummaries() {
+        return this.summaries;
+    }
+    async outputOf(taskKind, unitId, format = 'lines') {
+        const taskName = (0, task_name_1.TaskName)((0, unit_metadata_1.UnitId)(unitId), (0, task_name_1.TaskKind)(taskKind));
+        const finishedTask = this.summaries.find(t => t.taskName === taskName);
+        if (finishedTask === undefined) {
+            throw new Error(`No task with kind ${taskKind} and unitId ${unitId}`);
+        }
+        const status = finishedTask.verdict;
+        if (status === undefined) {
+            throw new Error(`status of ${unitId}/${taskKind} is ${status}`);
+        }
+        if (status === 'OK' || status === 'FAIL') {
+            const outputFile = finishedTask.outputFile;
+            if (!outputFile) {
+                return [];
+            }
+            const content = await fse.readFile(outputFile, 'utf8');
+            const trimmed = content.trim();
+            return format === 'string' ? trimmed : trimmed.split('\n');
+        }
+        if (status === 'CRASH') {
+            throw new Error(`Task ${finishedTask.taskName} crashed while running`);
+        }
+        if (status === 'UNKNOWN') {
+            throw new Error(`Task ${finishedTask.taskName} did not run`);
+        }
+        (0, misc_1.shouldNeverHappen)(status);
+    }
+    async readLines(relativePath) {
+        const resolved = path.join(this.rootDir, relativePath);
+        if (!(await fse.pathExists(resolved))) {
+            return undefined;
+        }
+        const content = await fse.readFile(resolved, 'utf8');
+        return content.trim().split('\n');
+    }
+}
+exports.Breakdown = Breakdown;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJlYWtkb3duLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2JyZWFrZG93bi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFDQSw4Q0FBK0I7QUFDL0IsK0JBQWtEO0FBQ2xELDJDQUE0QjtBQUM1Qix5Q0FBOEM7QUFDOUMsaURBQXNDO0FBS3RDLE1BQWEsU0FBUztJQUNwQixZQUNXLGNBQXVDLEVBQ3ZDLFVBQXNCLEVBQ2QsU0FBd0IsRUFDeEIsT0FBZSxFQUN2QixpQkFBcUMsRUFDckMsVUFBb0IsRUFDcEIsT0FBZ0I7UUFOaEIsbUJBQWMsR0FBZCxjQUFjLENBQXlCO1FBQ3ZDLGVBQVUsR0FBVixVQUFVLENBQVk7UUFDZCxjQUFTLEdBQVQsU0FBUyxDQUFlO1FBQ3hCLFlBQU8sR0FBUCxPQUFPLENBQVE7UUFDdkIsc0JBQWlCLEdBQWpCLGlCQUFpQixDQUFvQjtRQUNyQyxlQUFVLEdBQVYsVUFBVSxDQUFVO1FBQ3BCLFlBQU8sR0FBUCxPQUFPLENBQVM7SUFDeEIsQ0FBQztJQUVKLElBQUksUUFBUTtRQUNWLE9BQU8sSUFBQSxlQUFRLEVBQUMsSUFBSSxDQUFDLGNBQWMsRUFBRTtZQUNuQyxFQUFFLEVBQUUsR0FBRyxFQUFFLENBQUMsQ0FBQztZQUNYLEtBQUssRUFBRSxHQUFHLEVBQUUsQ0FBQyxDQUFDO1lBQ2QsSUFBSSxFQUFFLEdBQUcsRUFBRSxDQUFDLENBQUM7U0FDZCxDQUFDLENBQUE7SUFDSixDQUFDO0lBRUQsWUFBWTtRQUNWLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQTtJQUN2QixDQUFDO0lBSUQsS0FBSyxDQUFDLFFBQVEsQ0FBQyxRQUFnQixFQUFFLE1BQWMsRUFBRSxTQUE2QixPQUFPO1FBQ25GLE1BQU0sUUFBUSxHQUFHLElBQUEsb0JBQVEsRUFBQyxJQUFBLHNCQUFNLEVBQUMsTUFBTSxDQUFDLEVBQUUsSUFBQSxvQkFBUSxFQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUE7UUFDN0QsTUFBTSxZQUFZLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsUUFBUSxLQUFLLFFBQVEsQ0FBQyxDQUFBO1FBQ3RFLElBQUksWUFBWSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQy9CLE1BQU0sSUFBSSxLQUFLLENBQUMscUJBQXFCLFFBQVEsZUFBZSxNQUFNLEVBQUUsQ0FBQyxDQUFBO1FBQ3ZFLENBQUM7UUFFRCxNQUFNLE1BQU0sR0FBRyxZQUFZLENBQUMsT0FBTyxDQUFBO1FBQ25DLElBQUksTUFBTSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3pCLE1BQU0sSUFBSSxLQUFLLENBQUMsYUFBYSxNQUFNLElBQUksUUFBUSxPQUFPLE1BQU0sRUFBRSxDQUFDLENBQUE7UUFDakUsQ0FBQztRQUVELElBQUksTUFBTSxLQUFLLElBQUksSUFBSSxNQUFNLEtBQUssTUFBTSxFQUFFLENBQUM7WUFDekMsTUFBTSxVQUFVLEdBQUcsWUFBWSxDQUFDLFVBQVUsQ0FBQTtZQUMxQyxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7Z0JBQ2hCLE9BQU8sRUFBRSxDQUFBO1lBQ1gsQ0FBQztZQUNELE1BQU0sT0FBTyxHQUFHLE1BQU0sR0FBRyxDQUFDLFFBQVEsQ0FBQyxVQUFVLEVBQUUsTUFBTSxDQUFDLENBQUE7WUFDdEQsTUFBTSxPQUFPLEdBQUcsT0FBTyxDQUFDLElBQUksRUFBRSxDQUFBO1lBQzlCLE9BQU8sTUFBTSxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFBO1FBQzVELENBQUM7UUFFRCxJQUFJLE1BQU0sS0FBSyxPQUFPLEVBQUUsQ0FBQztZQUN2QixNQUFNLElBQUksS0FBSyxDQUFDLFFBQVEsWUFBWSxDQUFDLFFBQVEsd0JBQXdCLENBQUMsQ0FBQTtRQUN4RSxDQUFDO1FBRUQsSUFBSSxNQUFNLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDekIsTUFBTSxJQUFJLEtBQUssQ0FBQyxRQUFRLFlBQVksQ0FBQyxRQUFRLGNBQWMsQ0FBQyxDQUFBO1FBQzlELENBQUM7UUFFRCxJQUFBLHdCQUFpQixFQUFDLE1BQU0sQ0FBQyxDQUFBO0lBQzNCLENBQUM7SUFFRCxLQUFLLENBQUMsU0FBUyxDQUFDLFlBQW9CO1FBQ2xDLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLE9BQU8sRUFBRSxZQUFZLENBQUMsQ0FBQTtRQUN0RCxJQUFJLENBQUMsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxVQUFVLENBQUMsUUFBUSxDQUFDLENBQUMsRUFBRSxDQUFDO1lBQ3RDLE9BQU8sU0FBUyxDQUFBO1FBQ2xCLENBQUM7UUFDRCxNQUFNLE9BQU8sR0FBRyxNQUFNLEdBQUcsQ0FBQyxRQUFRLENBQUMsUUFBUSxFQUFFLE1BQU0sQ0FBQyxDQUFBO1FBQ3BELE9BQU8sT0FBTyxDQUFDLElBQUksRUFBRSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQTtJQUNuQyxDQUFDO0NBQ0Y7QUFsRUQsOEJBa0VDIn0=

package/dist/deps/build-raptor-core/build-raptor-config.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const BuildRaptorConfig: z.ZodObject<{
+    repoProtocol: z.ZodDefault<z.ZodUnknown>;
+    verbosePrintTasks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    tightFingerprints: z.ZodDefault<z.ZodBoolean>;
+    outDirName: z.ZodDefault<z.ZodString>;
+    fingerprintSeed: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    verbosePrintTasks: string[];
+    tightFingerprints: boolean;
+    outDirName: string;
+    fingerprintSeed: string;
+    repoProtocol?: unknown;
+}, {
+    repoProtocol?: unknown;
+    verbosePrintTasks?: string[] | undefined;
+    tightFingerprints?: boolean | undefined;
+    outDirName?: string | undefined;
+    fingerprintSeed?: string | undefined;
+}>;
+export type BuildRaptorConfig = z.infer<typeof BuildRaptorConfig>;

package/dist/deps/build-raptor-core/build-raptor-config.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuildRaptorConfig = void 0;
+const zod_1 = require("zod");
+exports.BuildRaptorConfig = zod_1.z.object({
+    repoProtocol: zod_1.z.unknown().default(undefined).describe('Repo-protocol-specific configuration.'),
+    verbosePrintTasks: zod_1.z
+        .string()
+        .array()
+        .default([])
+        .describe("task names for which high-detail printing will be enabled. This allow the user to get detailed information about specific tasks. Example: ['foo:build', 'bar:test']."),
+    tightFingerprints: zod_1.z
+        .boolean()
+        .default(false)
+        .describe('[EXPERIMENTAL - Not yet stable] Selects one of two modes for determining when a task will run. A task will always run if one of the tasks listed in its TaskInfo.deps had to run. Additionally, a task will run if any of its inputs have changed (when this attribute is true) or if any of the tasks that generates its inputs had to run (when this attribute is false).'),
+    outDirName: zod_1.z
+        .string()
+        .default('.out')
+        .describe('Name of the directory at which outputs of tasks will be placed (other than compilation outputs which are currently under dist). This directory is created in each module.'),
+    fingerprintSeed: zod_1.z
+        .string()
+        .default('8')
+        .describe('Seed value for fingerprint computation. Changing this value invalidates all cached content by producing new fingerprints.'),
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVpbGQtcmFwdG9yLWNvbmZpZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9idWlsZC1yYXB0b3ItY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDZCQUF1QjtBQUVWLFFBQUEsaUJBQWlCLEdBQUcsT0FBQyxDQUFDLE1BQU0sQ0FBQztJQUN4QyxZQUFZLEVBQUUsT0FBQyxDQUFDLE9BQU8sRUFBRSxDQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsQ0FBQyxRQUFRLENBQUMsdUNBQXVDLENBQUM7SUFDOUYsaUJBQWlCLEVBQUUsT0FBQztTQUNqQixNQUFNLEVBQUU7U0FDUixLQUFLLEVBQUU7U0FDUCxPQUFPLENBQUMsRUFBRSxDQUFDO1NBQ1gsUUFBUSxDQUNQLHNLQUFzSyxDQUN2SztJQUNILGlCQUFpQixFQUFFLE9BQUM7U0FDakIsT0FBTyxFQUFFO1NBQ1QsT0FBTyxDQUFDLEtBQUssQ0FBQztTQUNkLFFBQVEsQ0FDUCw2V0FBNlcsQ0FDOVc7SUFDSCxVQUFVLEVBQUUsT0FBQztTQUNWLE1BQU0sRUFBRTtTQUNSLE9BQU8sQ0FBQyxNQUFNLENBQUM7U0FDZixRQUFRLENBQ1AsMktBQTJLLENBQzVLO0lBQ0gsZUFBZSxFQUFFLE9BQUM7U0FDZixNQUFNLEVBQUU7U0FDUixPQUFPLENBQUMsR0FBRyxDQUFDO1NBQ1osUUFBUSxDQUNQLDJIQUEySCxDQUM1SDtDQUNKLENBQUMsQ0FBQSJ9

package/dist/deps/build-raptor-core/default-asset-publisher.d.ts

@@ -0,0 +1,10 @@
+import { Logger } from 'logger';
+import { StorageClient } from 'misc';
+import { Publisher } from 'repo-protocol';
+import { UnitMetadata } from 'unit-metadata';
+export declare class DefaultAssetPublisher implements Publisher {
+    private readonly storageClient;
+    private readonly logger;
+    constructor(storageClient: StorageClient, logger: Logger);
+    publishAsset(u: UnitMetadata, content: Buffer, name: string): Promise<string>;
+}

package/dist/deps/build-raptor-core/default-asset-publisher.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultAssetPublisher = void 0;
+class DefaultAssetPublisher {
+    constructor(storageClient, logger) {
+        this.storageClient = storageClient;
+        this.logger = logger;
+    }
+    async publishAsset(u, content, name) {
+        const resolved = await this.storageClient.putContentAddressable(content);
+        this.logger.info(`Asset ${u.id}/${name} uploaded to CAS ${resolved}`);
+        return resolved;
+    }
+}
+exports.DefaultAssetPublisher = DefaultAssetPublisher;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVmYXVsdC1hc3NldC1wdWJsaXNoZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGVmYXVsdC1hc3NldC1wdWJsaXNoZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBS0EsTUFBYSxxQkFBcUI7SUFDaEMsWUFBNkIsYUFBNEIsRUFBbUIsTUFBYztRQUE3RCxrQkFBYSxHQUFiLGFBQWEsQ0FBZTtRQUFtQixXQUFNLEdBQU4sTUFBTSxDQUFRO0lBQUcsQ0FBQztJQUU5RixLQUFLLENBQUMsWUFBWSxDQUFDLENBQWUsRUFBRSxPQUFlLEVBQUUsSUFBWTtRQUMvRCxNQUFNLFFBQVEsR0FBRyxNQUFNLElBQUksQ0FBQyxhQUFhLENBQUMscUJBQXFCLENBQUMsT0FBTyxDQUFDLENBQUE7UUFDeEUsSUFBSSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUMsRUFBRSxJQUFJLElBQUksb0JBQW9CLFFBQVEsRUFBRSxDQUFDLENBQUE7UUFDckUsT0FBTyxRQUFRLENBQUE7SUFDakIsQ0FBQztDQUNGO0FBUkQsc0RBUUMifQ==

package/dist/deps/build-raptor-core/engine-bootstrapper.d.ts

@@ -0,0 +1,50 @@
+import { PathInRepo } from 'core-types';
+import { Criticality, Logger } from 'logger';
+import { StorageClient, Subscribable } from 'misc';
+import { RepoProtocol } from 'repo-protocol';
+import { Breakdown } from './breakdown';
+import { EngineOptions } from './engine';
+import { EngineEventScheme } from './engine-event-scheme';
+import { StepByStepTransmitter } from './step-by-step-transmitter';
+export interface TaskSelector {
+    /**
+     * units the units whose tasks are to be built. An empty array means "all units".
+     */
+    units: string[];
+    /**
+     * a list of output locations. The tasks that produce these outputs will be added to "tasks to run".
+     */
+    goals: string[];
+    labels: string[];
+}
+export declare class EngineBootstrapper {
+    readonly t0: number;
+    readonly logger: Logger;
+    readonly storageClient: StorageClient;
+    readonly repoProtocol: RepoProtocol;
+    private readonly eventPublisher;
+    readonly transmitter: StepByStepTransmitter;
+    readonly rootDir: {
+        resolve: (pathInRepo?: PathInRepo) => string;
+        unresolve: (absolutePath: string) => PathInRepo;
+        toString: () => string;
+        toJSON: () => string;
+    };
+    private constructor();
+    private makeEngine;
+    static readonly CONFIG_FILES: string[];
+    private resolveConfigFile;
+    private readConfigFile;
+    get subscribable(): Subscribable<EngineEventScheme>;
+    private newBuildRunId;
+    getConfigFileExample(): string;
+    /**
+     * Returns a "runner function". When the runner function is invoked, a build will run.
+     *
+     * @param configFile
+     * @param options
+     * @returns
+     */
+    makeRunner(selector: TaskSelector, configFile: string | undefined, options: Omit<EngineOptions, 'config'>): Promise<() => Promise<Breakdown>>;
+    static create(rootDir: string, storageClient: StorageClient, repoProtocol: RepoProtocol, t0: number, criticalityLevel: Criticality, name?: string, logger?: Logger): Promise<EngineBootstrapper>;
+}

package/dist/deps/build-raptor-core/engine-bootstrapper.js

@@ -0,0 +1,200 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EngineBootstrapper = void 0;
+const build_failed_error_1 = require("build-failed-error");
+const build_run_id_1 = require("build-run-id");
+const core_types_1 = require("core-types");
+const fs = __importStar(require("fs"));
+const JsoncParser = __importStar(require("jsonc-parser"));
+const logger_1 = require("logger");
+const misc_1 = require("misc");
+const path = __importStar(require("path"));
+const Tmp = __importStar(require("tmp-promise"));
+const util = __importStar(require("util"));
+const uuid = __importStar(require("uuid"));
+const zod_1 = require("zod");
+const breakdown_1 = require("./breakdown");
+const build_raptor_config_1 = require("./build-raptor-config");
+const engine_1 = require("./engine");
+const examplify_zod_1 = require("./examplify-zod");
+const step_by_step_transmitter_1 = require("./step-by-step-transmitter");
+const task_store_1 = require("./task-store");
+class EngineBootstrapper {
+    constructor(rootDir, t0, logger, storageClient, repoProtocol) {
+        this.t0 = t0;
+        this.logger = logger;
+        this.storageClient = storageClient;
+        this.repoProtocol = repoProtocol;
+        this.eventPublisher = new misc_1.TypedPublisher();
+        this.rootDir = (0, core_types_1.RepoRoot)(rootDir);
+        this.transmitter = new step_by_step_transmitter_1.StepByStepTransmitter(logger);
+    }
+    async makeEngine(selector, configFile, optionsSansConfig) {
+        const taskOutputDir = (await Tmp.dir()).path;
+        this.logger.info(`rootDir is ${this.rootDir}`);
+        this.logger.info(`The console outputs (stdout/stderr) of tasks are stored under ${taskOutputDir}`);
+        const resolvedConfigFile = configFile ? (0, core_types_1.PathInRepo)(configFile) : this.resolveConfigFile();
+        const options = {
+            ...optionsSansConfig,
+            config: this.readConfigFile(resolvedConfigFile),
+        };
+        const taskStore = new task_store_1.TaskStore(this.rootDir, this.storageClient, this.logger, this.eventPublisher);
+        const stepByStepFile = path.join(options.buildRaptorDir, 'step-by-step.json');
+        this.transmitter.setOutputFile(stepByStepFile);
+        if (options.stepByStepProcessorModuleName) {
+            this.transmitter.dynamicallyLoadProcessor(options.stepByStepProcessorModuleName);
+        }
+        const engine = new engine_1.Engine(this.logger, this.rootDir, this.repoProtocol, taskStore, taskOutputDir, selector, this.eventPublisher, this.transmitter, options);
+        return engine;
+    }
+    resolveConfigFile() {
+        const arr = EngineBootstrapper.CONFIG_FILES.map(at => (0, core_types_1.PathInRepo)(at));
+        const existings = arr.flatMap(at => (fs.existsSync(this.rootDir.resolve(at)) ? [at] : []));
+        if (existings.length > 1) {
+            const quoted = existings.map(at => `"${at}"`);
+            throw new Error(`Found competing config files: ${quoted.join(', ')}. To avoid confusion, you must keep just one.`);
+        }
+        return existings.at(0);
+    }
+    readConfigFile(pathToConfigFile) {
+        if (pathToConfigFile === undefined) {
+            return build_raptor_config_1.BuildRaptorConfig.parse({});
+        }
+        const p = this.rootDir.resolve(pathToConfigFile);
+        try {
+            if (!fs.existsSync(p)) {
+                return build_raptor_config_1.BuildRaptorConfig.parse({});
+            }
+            const content = fs.readFileSync(p, 'utf-8');
+            const errors = [];
+            const parsed = JsoncParser.parse(content, errors, { allowTrailingComma: true, allowEmptyContent: true });
+            const e = errors.at(0);
+            if (e) {
+                throw new Error(`Bad format: ${JsoncParser.printParseErrorCode(e.error)} at position ${e.offset}`);
+            }
+            return build_raptor_config_1.BuildRaptorConfig.parse(parsed);
+        }
+        catch (e) {
+            throw new Error(`could not read repo config file ${p} - ${(0, misc_1.errorLike)(e).message}`);
+        }
+    }
+    get subscribable() {
+        return this.eventPublisher;
+    }
+    newBuildRunId() {
+        return (0, build_run_id_1.BuildRunId)(uuid.v4());
+    }
+    getConfigFileExample() {
+        const withRepoProtocol = zod_1.z.object({
+            ...build_raptor_config_1.BuildRaptorConfig.shape,
+            repoProtocol: this.repoProtocol
+                .getConfigSchema()
+                .describe(build_raptor_config_1.BuildRaptorConfig.shape.repoProtocol.description ?? ''),
+        });
+        return (0, examplify_zod_1.examplifyZod)(withRepoProtocol, {});
+    }
+    /**
+     * Returns a "runner function". When the runner function is invoked, a build will run.
+     *
+     * @param configFile
+     * @param options
+     * @returns
+     */
+    async makeRunner(selector, configFile, options) {
+        try {
+            const t1 = Date.now();
+            this.logger.info(`Creating a runner for ${JSON.stringify({ selector, options })}`);
+            const engine = await this.makeEngine(selector, configFile, options);
+            const buildRunId = this.newBuildRunId();
+            return async () => {
+                try {
+                    const tracker = await engine.run(buildRunId);
+                    const t2 = Date.now();
+                    this.logger.info(`Engine finished in ${t2 - t1}ms (${t2 - this.t0}ms incl. bootstrapping)`);
+                    const successful = tracker.successful;
+                    this.logger.info(`tasks=${JSON.stringify(tracker.tasks(), null, 2)}`);
+                    this.logger.info(`performance report: ${JSON.stringify(tracker.getPerformanceReport(), null, 2)}`);
+                    if (successful) {
+                        await engine.executeProgram();
+                    }
+                    return new breakdown_1.Breakdown(successful ? 'OK' : 'FAIL', buildRunId, tracker.tasks().map(t => summarizeTask(t)), this.rootDir.resolve(), tracker.getPerformanceReport());
+                }
+                catch (err) {
+                    if (err instanceof build_failed_error_1.BuildFailedError) {
+                        const prefix = (0, misc_1.switchOn)(err.hint, {
+                            program: () => '',
+                            task: () => 'build-raptor detected the following problem: ',
+                        });
+                        // TODO(imaman): cover this print
+                        this.logger.print(`${prefix}${err.message}`, 'high');
+                        return new breakdown_1.Breakdown('FAIL', buildRunId, [], this.rootDir.resolve(), undefined, undefined, (0, misc_1.errorLike)(err).message);
+                    }
+                    this.logger.error(`this build-raptor run has crashed due to an unexpected error`, err);
+                    this.logger.print(`this build-raptor run has crashed due to an unexpected error ${util.inspect(err)}`, 'high');
+                    return new breakdown_1.Breakdown('CRASH', buildRunId, [], this.rootDir.resolve(), undefined, err);
+                }
+            };
+        }
+        catch (err) {
+            this.logger.error(`failed to initialize build-raptor`, err);
+            throw err;
+        }
+    }
+    static async create(rootDir, storageClient, repoProtocol, t0, criticalityLevel, name, logger) {
+        if (!logger) {
+            const logFile = path.join(rootDir, 'build-raptor.log');
+            logger = (0, logger_1.createDefaultLogger)(logFile, criticalityLevel);
+            logger.info(`Logger initialized`);
+            const formatted = name ? ` ("${name}") ` : ' ';
+            logger.print(`logging${formatted}to ${logFile}`);
+        }
+        return new EngineBootstrapper(rootDir, t0, logger, storageClient, repoProtocol);
+    }
+}
+exports.EngineBootstrapper = EngineBootstrapper;
+EngineBootstrapper.CONFIG_FILES = ['.build-raptor.jsonc', '.build-raptor.json'];
+function summarizeTask(t) {
+    return {
+        outputFile: t.record.outputFile,
+        taskName: t.name,
+        verdict: t.record.verdict,
+        execution: t.record.executionType,
+        startedAt: t.record.startedAt,
+        endedAt: t.record.endedAt,
+        rootCause: t.record.rootCause,
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW5naW5lLWJvb3RzdHJhcHBlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9lbmdpbmUtYm9vdHN0cmFwcGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLDJEQUFxRDtBQUNyRCwrQ0FBeUM7QUFDekMsMkNBQWlEO0FBQ2pELHVDQUF3QjtBQUN4QiwwREFBMkM7QUFDM0MsbUNBQWlFO0FBQ2pFLCtCQUF1RjtBQUN2RiwyQ0FBNEI7QUFFNUIsaURBQWtDO0FBQ2xDLDJDQUE0QjtBQUM1QiwyQ0FBNEI7QUFDNUIsNkJBQXVCO0FBRXZCLDJDQUF1QztBQUN2QywrREFBeUQ7QUFDekQscUNBQWdEO0FBRWhELG1EQUE4QztBQUM5Qyx5RUFBa0U7QUFFbEUsNkNBQXdDO0FBZXhDLE1BQWEsa0JBQWtCO0lBSzdCLFlBQ0UsT0FBZSxFQUNOLEVBQVUsRUFDVixNQUFjLEVBQ2QsYUFBNEIsRUFDNUIsWUFBMEI7UUFIMUIsT0FBRSxHQUFGLEVBQUUsQ0FBUTtRQUNWLFdBQU0sR0FBTixNQUFNLENBQVE7UUFDZCxrQkFBYSxHQUFiLGFBQWEsQ0FBZTtRQUM1QixpQkFBWSxHQUFaLFlBQVksQ0FBYztRQVRwQixtQkFBYyxHQUFHLElBQUkscUJBQWMsRUFBcUIsQ0FBQTtRQVd2RSxJQUFJLENBQUMsT0FBTyxHQUFHLElBQUEscUJBQVEsRUFBQyxPQUFPLENBQUMsQ0FBQTtRQUNoQyxJQUFJLENBQUMsV0FBVyxHQUFHLElBQUksZ0RBQXFCLENBQUMsTUFBTSxDQUFDLENBQUE7SUFDdEQsQ0FBQztJQUVPLEtBQUssQ0FBQyxVQUFVLENBQ3RCLFFBQXNCLEVBQ3RCLFVBQThCLEVBQzlCLGlCQUFnRDtRQUVoRCxNQUFNLGFBQWEsR0FBRyxDQUFDLE1BQU0sR0FBRyxDQUFDLEdBQUcsRUFBRSxDQUFDLENBQUMsSUFBSSxDQUFBO1FBQzVDLElBQUksQ0FBQyxNQUFNLENBQUMs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

package/dist/deps/build-raptor-core/engine-event-scheme.d.ts

@@ -0,0 +1,20 @@
+import { ExitStatus } from 'repo-protocol';
+import { RepoProtocolEvent } from 'repo-protocol';
+import { TaskName } from 'task-name';
+import { Phase } from './phase';
+import { TaskStoreEvent } from './task-store-event';
+export type EngineEventScheme = TaskStoreEvent & RepoProtocolEvent & {
+    executionSkipped: TaskName;
+    executionStarted: TaskName;
+    executionEnded: {
+        taskName: TaskName;
+        status: ExitStatus;
+        outputFile: string;
+        pathInRepo: string;
+        time: number;
+    };
+    taskPhaseEnded: {
+        taskName: TaskName;
+        phase: Phase;
+    };
+};

package/dist/deps/build-raptor-core/engine-event-scheme.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW5naW5lLWV2ZW50LXNjaGVtZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9lbmdpbmUtZXZlbnQtc2NoZW1lLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist/deps/build-raptor-core/engine.d.ts

@@ -0,0 +1,66 @@
+import { BuildRunId } from 'build-run-id';
+import { RepoRoot } from 'core-types';
+import { Logger } from 'logger';
+import { Int, TypedPublisher } from 'misc';
+import { RepoProtocol } from 'repo-protocol';
+import { BuildRaptorConfig } from './build-raptor-config';
+import { TaskSelector } from './engine-bootstrapper';
+import { EngineEventScheme } from './engine-event-scheme';
+import { ExecutionPlan } from './execution-plan';
+import { Model } from './model';
+import { StepByStepTransmitter } from './step-by-step-transmitter';
+import { TaskStore } from './task-store';
+import { TaskTracker } from './task-tracker';
+export interface EngineOptions {
+    /**
+     * The directory that build-ratpor was invoked at. If relative it is relative to the repo root. If absolute it must
+     * point to a dir somewhere under the repo root.
+     */
+    userDir: string;
+    checkGitIgnore?: boolean;
+    concurrency: Int;
+    buildRaptorDir: string;
+    fingerprintLedger?: boolean;
+    testCaching?: boolean;
+    commitHash: string | undefined;
+    stepByStepProcessorModuleName?: string;
+    config: BuildRaptorConfig;
+    toRun?: {
+        program: string;
+        args: string[];
+    };
+}
+export declare class Engine {
+    private readonly logger;
+    private readonly rootDir;
+    private readonly repoProtocol;
+    private readonly taskStore;
+    private readonly taskOutputDir;
+    private readonly selector;
+    private readonly eventPublisher;
+    private readonly steps;
+    private readonly options;
+    private readonly fingerprintLedger;
+    private readonly purger;
+    private tracker?;
+    private readonly goals;
+    /**
+     *
+     * @param logger
+     * @param rootDir
+     * @param repoProtocol
+     * @param taskStore
+     * @param taskOutputDir
+     * @param command the task kind to run. An empty string means "all tasks".
+     * @param units the units whose tasks are to be run. An empty array means "all units".
+     * @param goals list of output locations. The tasks that produce these outputs will be added to "tasks to run".
+     * @param eventPublisher
+     * @param steps
+     * @param options
+     */
+    constructor(logger: Logger, rootDir: RepoRoot, repoProtocol: RepoProtocol, taskStore: TaskStore, taskOutputDir: string, selector: TaskSelector, eventPublisher: TypedPublisher<EngineEventScheme>, steps: StepByStepTransmitter, options: EngineOptions);
+    run(buildRunId: BuildRunId): Promise<TaskTracker>;
+    executePlan(plan: ExecutionPlan, model: Model): Promise<TaskTracker>;
+    executeProgram(): Promise<void>;
+    loadModel(buildRunId: BuildRunId): Promise<Model>;
+}