build-raptor 0.131.0 → 0.133.0

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

@@ -0,0 +1,285 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Engine = void 0;
+const build_failed_error_1 = require("build-failed-error");
+const child_process_1 = __importDefault(require("child_process"));
+const core_types_1 = require("core-types");
+const fs = __importStar(require("fs"));
+const fse = __importStar(require("fs-extra"));
+const ignore_1 = __importDefault(require("ignore"));
+const misc_1 = require("misc");
+const path = __importStar(require("path"));
+const task_name_1 = require("task-name");
+const fingerprint_ledger_1 = require("./fingerprint-ledger");
+const fingerprinter_1 = require("./fingerprinter");
+const model_1 = require("./model");
+const planner_1 = require("./planner");
+const purger_1 = require("./purger");
+const task_executor_1 = require("./task-executor");
+const task_tracker_1 = require("./task-tracker");
+class Engine {
+    /**
+     *
+     * @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, rootDir, repoProtocol, taskStore, taskOutputDir, selector, eventPublisher, steps, options) {
+        this.logger = logger;
+        this.rootDir = rootDir;
+        this.repoProtocol = repoProtocol;
+        this.taskStore = taskStore;
+        this.taskOutputDir = taskOutputDir;
+        this.selector = selector;
+        this.eventPublisher = eventPublisher;
+        this.steps = steps;
+        const userDirAbsolute = path.isAbsolute(options.userDir)
+            ? options.userDir
+            : this.rootDir.resolve((0, core_types_1.PathInRepo)(options.userDir));
+        const userDir = this.rootDir.unresolve(userDirAbsolute);
+        this.options = {
+            checkGitIgnore: options.checkGitIgnore ?? true,
+            concurrency: options.concurrency,
+            buildRaptorDir: options.buildRaptorDir,
+            fingerprintLedger: options.fingerprintLedger ?? false,
+            testCaching: options.testCaching ?? true,
+            commitHash: options.commitHash,
+            config: options.config,
+            userDir,
+            toRun: options.toRun ? { args: options.toRun.args, program: userDir.to(options.toRun.program) } : undefined,
+        };
+        this.goals = [...selector.goals, options.toRun?.program].flatMap(g => (g ? [g] : [])).map(g => userDir.to(g));
+        this.logger.info(`this.goals=${JSON.stringify(this.goals)}`);
+        const ledgerFile = path.join(this.options.buildRaptorDir, 'fingerprint-ledger.json');
+        this.eventPublisher.on('taskStore', e => {
+            const step = e.opcode === 'RECORDED'
+                ? 'TASK_STORE_PUT'
+                : e.opcode === 'RESTORED'
+                    ? 'TASK_STORE_GET'
+                    : (0, misc_1.shouldNeverHappen)(e.opcode);
+            const { taskKind, unitId } = (0, task_name_1.TaskName)().undo(e.taskName);
+            this.steps.transmit({
+                blobId: e.blobId,
+                taskName: e.taskName,
+                taskKind,
+                unitId,
+                step,
+                fingerprint: e.fingerprint,
+                files: e.files,
+            });
+        });
+        this.eventPublisher.on('testEnded', e => {
+            this.steps.transmit({
+                step: 'TEST_ENDED',
+                taskName: e.taskName,
+                fileName: e.fileName,
+                testPath: e.testPath,
+                verdict: e.verdict,
+                durationMillis: e.durationMillis,
+            });
+        });
+        this.eventPublisher.on('assetPublished', e => {
+            if (!this.tracker) {
+                throw new Error(`tracker is not set`);
+            }
+            const task = this.tracker?.getTask(e.taskName) ?? (0, misc_1.failMe)(`Task not found (task name=${e.taskName})`);
+            const { unitId } = (0, task_name_1.TaskName)().undo(e.taskName);
+            this.steps.transmit({
+                step: 'ASSET_PUBLISHED',
+                labels: [...task.labels],
+                taskName: e.taskName,
+                unitId,
+                fingerprint: task.getFingerprint(),
+                casAddress: e.casAddress,
+                file: e.file,
+            });
+        });
+        this.eventPublisher.on('publicFiles', e => {
+            if (Object.keys(e.publicFiles).length === 0) {
+                return;
+            }
+            this.steps.transmit({
+                step: 'PUBLIC_FILES',
+                taskName: e.taskName,
+                publicFiles: e.publicFiles,
+            });
+        });
+        this.fingerprintLedger = this.options.fingerprintLedger
+            ? new fingerprint_ledger_1.PersistedFingerprintLedger(logger, ledgerFile)
+            : new fingerprint_ledger_1.NopFingerprintLedger();
+        this.purger = new purger_1.Purger(this.logger, this.rootDir);
+    }
+    async run(buildRunId) {
+        this.steps.transmit({ step: 'BUILD_RUN_STARTED', buildRunId, commitHash: this.options.commitHash });
+        fs.writeFileSync(path.join(this.options.buildRaptorDir, 'build-run-id'), buildRunId);
+        await this.fingerprintLedger.updateRun(buildRunId);
+        await this.repoProtocol.initialize(this.rootDir, this.eventPublisher, this.options.config.outDirName, this.options.config.repoProtocol);
+        try {
+            const model = await this.loadModel(buildRunId);
+            const taskList = await this.repoProtocol.getTasks();
+            this.logger.info(`catalog=\n${JSON.stringify(taskList, null, 2)}`);
+            const plan = await new planner_1.Planner(this.logger).computePlan(taskList, model);
+            const startingPoints = plan.apply(this.selector.units, this.goals, this.selector.labels);
+            if (startingPoints.length === 0) {
+                throw new build_failed_error_1.BuildFailedError(`No task that matches the given goals/labels was found`);
+            }
+            this.steps.transmit({ step: 'PLAN_PREPARED', taskNames: plan.tasks().map(at => at.name) });
+            const ret = await this.executePlan(plan, model);
+            this.steps.transmit({ step: 'BUILD_RUN_ENDED' });
+            await Promise.all([this.fingerprintLedger.close(), this.steps.close()]);
+            return ret;
+        }
+        finally {
+            await this.repoProtocol.close();
+        }
+    }
+    async executePlan(plan, model) {
+        this.logger.info(`plan.taskGraph=${plan.taskGraph}`);
+        const taskTracker = new task_tracker_1.TaskTracker(plan);
+        this.tracker = taskTracker;
+        const taskExecutor = new task_executor_1.TaskExecutor(model, taskTracker, this.logger, this.repoProtocol, this.taskStore, this.taskOutputDir, this.eventPublisher, this.fingerprintLedger, this.purger, this.options.testCaching, this.options.config.verbosePrintTasks);
+        const workFunction = async (tn) => {
+            try {
+                const deps = this.options.config.tightFingerprints
+                    ? taskTracker.getTask(tn).taskInfo.deps ?? []
+                    : plan.taskGraph.neighborsOf(tn);
+                await taskExecutor.executeTask(tn, deps);
+                const task = taskTracker.getTask(tn);
+                const rec = task.record;
+                this.steps.transmit({
+                    step: 'TASK_ENDED',
+                    taskName: tn,
+                    executionType: rec.executionType,
+                    verdict: (0, misc_1.switchOn)(rec.verdict, {
+                        UNKNOWN: () => 'UNKNOWN',
+                        CRASH: () => 'CRASH',
+                        FAIL: () => 'FAIL',
+                        OK: () => 'OK',
+                    }),
+                    durationMillis: task.getDurationMillis(),
+                });
+            }
+            catch (e) {
+                const task = taskTracker.getTask(tn);
+                const rec = task.record;
+                this.logger.info(`crashed while running ${tn}`);
+                this.steps.transmit({
+                    step: 'TASK_ENDED',
+                    taskName: tn,
+                    executionType: rec.executionType,
+                    verdict: 'CRASH',
+                    durationMillis: task.getDurationMillis(),
+                });
+                throw e;
+            }
+            finally {
+                taskTracker.changeStatus(tn, 'DONE');
+            }
+        };
+        await plan.taskGraph.execute(this.options.concurrency, workFunction);
+        return taskTracker;
+    }
+    async executeProgram() {
+        if (!this.options.toRun) {
+            this.logger.info(`no program to execute`);
+            return;
+        }
+        this.logger.info(`about to execute ${JSON.stringify(this.options.toRun)}`);
+        const resolved = this.rootDir.resolve(this.options.toRun.program);
+        const cwd = this.rootDir.resolve(this.options.userDir);
+        const spawnResult = child_process_1.default.spawnSync(resolved, this.options.toRun.args, {
+            cwd,
+            stdio: 'inherit',
+            shell: false,
+        });
+        if (spawnResult.error) {
+            throw new build_failed_error_1.BuildFailedError(`could not execute ${this.options.toRun.program}: ${spawnResult.error}`, 'program');
+        }
+        if (spawnResult.status === 0) {
+            return;
+        }
+        throw new build_failed_error_1.BuildFailedError(`execution of ${this.options.toRun.program} exited with status=${spawnResult.status}, signal=${spawnResult.signal}`, 'program');
+    }
+    async loadModel(buildRunId) {
+        const gitIgnorePath = this.rootDir.resolve((0, core_types_1.PathInRepo)('.gitignore'));
+        const ig = (0, ignore_1.default)();
+        if (await fse.pathExists(gitIgnorePath)) {
+            const gitIgnoreContent = await fse.readFile(gitIgnorePath, 'utf8');
+            const lines = gitIgnoreContent.split('\n');
+            this.logger.info(`Found a .gitignore file:\n${JSON.stringify(lines, null, 2)}`);
+            ig.add(lines);
+        }
+        if (this.options.checkGitIgnore) {
+            const d = '.build-raptor';
+            const ignoresBuildRaptorDir = ig.ignores(d);
+            if (!ignoresBuildRaptorDir) {
+                throw new build_failed_error_1.BuildFailedError(`the ${d} directory should be .gitignore-d`);
+            }
+            const outDirName = this.options.config.outDirName;
+            if (outDirName && !ig.ignores(outDirName)) {
+                throw new build_failed_error_1.BuildFailedError(`the out dir (${outDirName}) should be .gitignore-d`);
+            }
+        }
+        const [graph, units] = await Promise.all([this.repoProtocol.getGraph(), this.repoProtocol.getUnits()]);
+        if (graph.isCyclic()) {
+            throw new build_failed_error_1.BuildFailedError(`Cyclic dependency detected in ${graph}`);
+        }
+        this.logger.info(`unit graph=\n${graph}`);
+        const scanner = new misc_1.DirectoryScanner(this.rootDir.resolve(), { predicate: ig.createFilter() });
+        const fingerprinter = new fingerprinter_1.Fingerprinter(scanner, this.logger, this.options.config.fingerprintSeed, async (h, c) => {
+            if (c) {
+                this.fingerprintLedger.updateFile(h, c);
+            }
+            else {
+                this.fingerprintLedger.updateDirectory(h);
+            }
+        });
+        return new model_1.Model(this.rootDir, graph, units, buildRunId, fingerprinter);
+    }
+}
+exports.Engine = Engine;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW5naW5lLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2VuZ2luZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSwyREFBcUQ7QUFFckQsa0VBQXlDO0FBQ3pDLDJDQUFpRDtBQUNqRCx1Q0FBd0I7QUFDeEIsOENBQStCO0FBQy9CLG9EQUEyQjtBQUUzQiwrQkFBaUc7QUFDakcsMkNBQTRCO0FBRTVCLHlDQUFvQztBQU1wQyw2REFBdUY7QUFDdkYsbURBQStDO0FBQy9DLG1DQUErQjtBQUMvQix1Q0FBbUM7QUFDbkMscUNBQWlDO0FBRWpDLG1EQUE4QztBQUU5QyxpREFBNEM7QUFrQzVDLE1BQWEsTUFBTTtJQU9qQjs7Ozs7Ozs7Ozs7OztPQWFHO0lBQ0gsWUFDbUIsTUFBYyxFQUNkLE9BQWlCLEVBQ2pCLFlBQTBCLEVBQzFCLFNBQW9CLEVBQ3BCLGFBQXFCLEVBQ3JCLFFBQXNCLEVBQ3RCLGNBQWlELEVBQ2pELEtBQTRCLEVBQzdDLE9BQXNCO1FBUkwsV0FBTSxHQUFOLE1BQU0sQ0FBUTtRQUNkLFlBQU8sR0FBUCxPQUFPLENBQVU7UUFDakIsaUJBQVksR0FBWixZQUFZLENBQWM7UUFDMUIsY0FBUyxHQUFULFNBQVMsQ0FBVztRQUNwQixrQkFBYSxHQUFiLGFBQWEsQ0FBUTtRQUNyQixhQUFRLEdBQVIsUUFBUSxDQUFjO1FBQ3RCLG1CQUFjLEdBQWQsY0FBYyxDQUFtQztRQUNqRCxVQUFLLEdBQUwsS0FBSyxDQUF1QjtRQUc3QyxNQUFNLGVBQWUsR0FBRyxJQUFJLENBQUMsVUFBVSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUM7WUFDdEQsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxPQUFPO1lBQ2pCLENBQUMsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFBLHVCQUFVLEVBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUE7UUFD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

package/dist/deps/build-raptor-core/examplify-zod.d.ts

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+/**
+ * Generates a formatted example from a Zod schema with default values and descriptions.
+ *
+ * Converts any supported Zod schema into a human-readable example showing the data
+ * structure with defaults. Useful for generating annotated configuration files that
+ * serve as both documentation and a working starting point.
+ *
+ * **Note**: Output is formatted for readability and is not valid JSON (contains
+ * inline comments and trailing commas).
+ *
+ * @example
+ * ```ts
+ * const schema = z.object({
+ *   port: z.number().default(3000).describe('Server port'),
+ *   host: z.string().optional()
+ * })
+ *
+ * console.log(examplifyZod(schema))
+ * // Output:
+ * {
+ *   // Server port
+ *   // port: 3000,
+ *
+ *   // host: "",
+ * }
+ *
+ * console.log(examplifyZod(schema, { comment: false }))
+ * // Output:
+ * {
+ *   // Server port
+ *   port: 3000,
+ *
+ *   // host: "",
+ * }
+ * ```
+ *
+ * @param input - Any Zod schema (object, primitive, array, union, etc.)
+ * @param options - Formatting options (see {@link ExamplifyZodOptions})
+ * @returns A formatted string example matching the schema structure with defaults populated
+ *
+ * @remarks
+ * ### Default Values
+ * - **Primitives**: Use type defaults: `0`, `""`, `false`
+ * - **Arrays**: Always shown as an empty array `[]`
+ * - **Objects**: Empty object `{}`
+ * - **With `.default()`**: Uses the specified default value
+ *
+ * ### Nullable/Optional Handling
+ * These modifiers are unwrapped to show the underlying type's default.
+ *
+ * ⚠️ **Order matters with `.default()`**:
+ * - `.nullable().default(5)` → uses `5`
+ * - `.default(5).nullable()` → uses type default `0` (`.nullable()` wraps after default is set)
+ *
+ * The same applies to `.optional()`.
+ *
+ * ### Unions
+ * Uses the first option's default value unless an explicit `.default()` is provided.
+ *
+ * ### Descriptions
+ * Property descriptions always appear as comments above their properties, regardless
+ * of the `comment` option. Multi-line descriptions are supported.
+ *
+ * ### Unsupported Types
+ * Unrecognized Zod types (enums, literals, records, tuples, intersections, etc.)
+ * are rendered as the string `'unknown'` with a default value of `null`.
+ */
+export declare function examplifyZod(input: z.ZodTypeAny, options?: ExamplifyZodOptions): string;
+/**
+ * Options for controlling the output format of examplifyZod().
+ */
+export interface ExamplifyZodOptions {
+    /**
+     * Whether to comment out property lines with '//' markers.
+     * When false, outputs property lines without comment prefix.
+     * When true, all property lines are commented.
+     * @default true
+     */
+    comment?: boolean;
+    /**
+     * Whether to also comment the outermost object braces.
+     * Only applies when `comment` is true. Useful for embedding in existing JSON.
+     * @default false
+     */
+    commentAlsoOutermostBraces?: boolean;
+    /**
+     * Column position where comment markers ('//' prefix) start.
+     * Controls horizontal alignment of comments.
+     * @default 2
+     */
+    commentIndentation?: number;
+}