depflow 3.0.0-dev.1 → 3.0.0-dev.11

package/dist/task/Task.d.ts

@@ -0,0 +1,210 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>.
+ * @description Runs the instructions of a task in sequence over a working directory, owning the single
+ *              verdict of the run and reporting its progress.
+ * @license Apache-2.0
+ */
+import { Events } from "@netfeez/common";
+import Command from "./Command.js";
+export declare class Task extends Events<Task.EventMap> {
+    protected readonly cwd: string;
+    protected readonly instructions: Task.Instruction[];
+    protected readonly options: Task.Options;
+    protected vResults: Task.commandResult[];
+    protected vCurrentStep: number;
+    protected vTotalTime: number;
+    protected vIsFinished: boolean;
+    protected vIsRunning: boolean;
+    protected vIsStopped: boolean;
+    protected vReason: Task.Reason | null;
+    /** The shell the scripts are written to, created only when an instruction needs one. */
+    protected shell: Command.Shell | null;
+    /** The handshake that silences the shell, awaited before the first instruction is written to it. */
+    protected prepared: Promise<void> | null;
+    /** The instruction in flight, the only one a timeout or a stop has to take down. */
+    protected current: Command | null;
+    protected timer: NodeJS.Timeout | null;
+    constructor(cwd: string, instructions: Task.Instruction[], options?: Task.Options);
+    get currentStep(): number;
+    get isFinished(): boolean;
+    get isRunning(): boolean;
+    get completes(): number;
+    get totalTime(): number;
+    get successes(): number;
+    get results(): Task.commandResult[];
+    get fails(): number;
+    /**
+     * Runs every instruction in sequence and settles the verdict of the task.
+     * @returns A promise resolving with the summary of the run, or rejecting with a
+     * {@link Task.Failure} carrying it, when the task failed and does not tolerate failures.
+     *
+     * @remarks This promise is the only verdict of the run: the `finish` event carries the same summary
+     * for reporting, and nothing is decided by it.
+     *
+     * The failure of an instruction does not stop the task, so the remaining instructions still run, and
+     * `allowFails` tolerates it. Anything else does stop the task, tolerating nothing, because none of
+     * them is the failure of a command: a run that timed out, was stopped, could not start a program or
+     * lost its shell did not do what it was asked to do, and `success: false` is not a verdict a caller
+     * can act on.
+     *
+     * @example
+     * ```ts
+     * const task = new Task(cwd, [ { executable: 'git', args: ['clone', repo, folder] } ], { maxTimeMs: 30000 });
+     * task.on('line', (line) => logger.info(line));
+     * const outcome = await task.run();
+     * ```
+     */
+    run(): Promise<Task.FinishData>;
+    /**
+     * Stops the task, taking down the instruction in flight, if any.
+     * @returns void
+     *
+     * @remarks The pending run rejects with a {@link Task.Failure} of reason `stopped`, so a caller
+     * that stops a task never waits for a verdict that will not come.
+     */
+    stop(): void;
+    /**
+     * Runs one instruction and turns its verdict into a result of the task.
+     * @param instruction - The instruction to run, a script for the shell or a program of its own.
+     * @returns A promise resolving with the result of the instruction.
+     **/
+    protected execute(instruction: Task.Instruction): Promise<Task.commandResult>;
+    /**
+     * The shell the scripts of this task are written to, started in the working directory of the task.
+     * @returns A promise resolving to the shell, or to `null` when the shell of the task is already gone.
+     *
+     * @remarks The shell is silenced before it is handed over: everything it writes about itself belongs
+     * to the shell and not to the first instruction, so the handshake that removes it completes first.
+     *
+     * @remarks A shell that dies takes down the instruction reading it, and the reason of the run becomes
+     * `shell`: the instruction is reported as unfinished because there is no longer anything reading it,
+     * and it is the task that owns the shell that says the shell is gone.
+     */
+    protected getShell(): Promise<Command.Shell | null>;
+    /**
+     * Arms the deadline of the task, taken from the time it started.
+     * @returns void
+     **/
+    protected arm(): void;
+    /** Disarms the deadline of the task. **/
+    protected disarm(): void;
+    /** Takes down the shell of the task, if it created one. **/
+    protected dispose(): void;
+    /**
+     * Turns the verdict of an instruction into the result the task keeps: the identity of the command,
+     * the verdict itself, the output it produced and the diagnostic that explains how it ended.
+     *
+     * @remarks The output and the error are kept whole, so a caller can show them, save them or search
+     * them without a policy having to be present while the command runs. Nothing is added to either
+     * buffer, and the diagnostic never carries them: it says what happened, and the buffers say why.
+     *
+     * @param label - The human readable form of the instruction.
+     * @param verdict - The verdict the command settled with.
+     * @param ordinal - The position of the instruction inside the task, starting at 1.
+     * @returns The result of the instruction.
+     **/
+    protected static result(label: string, verdict: Command.Verdict, ordinal: number): Task.commandResult;
+    /**
+     * The one line that explains how an instruction ended, the same in every mode and the only text
+     * about the failure that belongs to the result.
+     *
+     * @remarks A command that failed carries its status, its signal or the reason it could not finish,
+     * and never its output: mixing both made the first line of a failure unreadable, and the output is
+     * already in the buffers, in the evidence file and, when it is wanted, right under this line.
+     *
+     * @param label - The human readable form of the instruction.
+     * @param verdict - The verdict the command settled with.
+     * @returns The diagnostic of the instruction, empty when it succeeded.
+     **/
+    protected static diagnostic(label: string, verdict: Command.Verdict): string;
+    /**
+     * The summary of the task execution, which is both the verdict of the run and what the `finish`
+     * event reports.
+     * @returns The summary of the execution.
+     **/
+    protected getSummary(): Task.FinishData;
+}
+export declare namespace Task {
+    type Emitter = Events.Emitter<EventMap>;
+    type Program = Command.Program;
+    type Instruction = string | Program;
+    type Reason = Command.Reason;
+    interface Options {
+        /** The deadline of the whole task in milliseconds; a negative value leaves it unbounded. */
+        maxTimeMs?: number;
+        /** Whether the failure of an instruction is tolerated, so the task still succeeds. */
+        allowFails?: boolean;
+    }
+    /**
+     * The events of a task: a line of stdout, a line of stderr, the result of the instruction that just
+     * ended, and the summary of the run.
+     *
+     * @remarks Every line and every result carries the ordinal of the instruction it belongs to, the one
+     * the command already knows, so a consumer can attribute both without keeping a counter of its own.
+     */
+    type EventMap = {
+        line: [line: string, ordinal: number];
+        err: [line: string, ordinal: number];
+        step: [commandResult: commandResult, step: number, time: number];
+        error: [commandResult: commandResult, step: number, time: number];
+        finish: [data: FinishData];
+    };
+    /**
+     * Everything a task knows about one instruction: who it was, how it ended, and everything it said.
+     */
+    interface commandResult {
+        /** The position of the instruction inside its task, starting at 1. */
+        ordinal: number;
+        /** The human readable form of the instruction, whole, as it was given. */
+        label: string;
+        /** Whether the instruction ended as it was asked to. */
+        success: boolean;
+        /** The exit status, or `null` when there was none. */
+        code: number | null;
+        /** The signal that took the command down, or `null` when there was none. */
+        signal: NodeJS.Signals | null;
+        /** Why there is no status at all, or `null` when the command reported one. */
+        reason: Reason | null;
+        /** The time the instruction took, in milliseconds. */
+        time: number;
+        /** Everything the instruction wrote to stdout. */
+        stdout: string;
+        /** Everything the instruction wrote to stderr. */
+        stderr: string;
+        /** The one line that explains a failure, empty when the instruction succeeded. */
+        diagnostic: string;
+    }
+    interface FinishData {
+        success: boolean;
+        completes: number;
+        fails: number;
+        totalTime: number;
+        results: commandResult[];
+    }
+    /**
+     * The failure of a task, carrying the summary of the run that produced it.
+     *
+     * @remarks The message says how the task failed and nothing more. The output of every instruction is
+     * in the summary, one result per command, and printing it here duplicated it in every message a
+     * caller logged: a task that printed a build log threw the log away once per layer that reported it.
+     */
+    class Failure extends Error {
+        readonly outcome: FinishData;
+        readonly reason: Reason | 'command';
+        /**
+         * Creates the failure of a task.
+         * @param outcome - The summary of the run.
+         * @param reason - Why the task failed.
+         */
+        constructor(outcome: FinishData, reason?: Reason | 'command');
+        /**
+         * The message describing why a task failed: how many instructions failed, and why the run did not
+         * get to all of them.
+         * @param outcome - The summary of the run.
+         * @param reason - Why the task failed.
+         * @returns The message of the failure.
+         **/
+        private static message;
+    }
+}
+export default Task;

package/dist/task/Task.js

@@ -0,0 +1,312 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>.
+ * @description Runs the instructions of a task in sequence over a working directory, owning the single
+ *              verdict of the run and reporting its progress.
+ * @license Apache-2.0
+ */
+import { Events } from "@netfeez/common";
+import Command from "./Command.js";
+export class Task extends Events {
+    cwd;
+    instructions;
+    options;
+    vResults = [];
+    vCurrentStep = 0;
+    vTotalTime = 0;
+    vIsFinished = false;
+    vIsRunning = false;
+    vIsStopped = false;
+    vReason = null;
+    /** The shell the scripts are written to, created only when an instruction needs one. */
+    shell = null;
+    /** The handshake that silences the shell, awaited before the first instruction is written to it. */
+    prepared = null;
+    /** The instruction in flight, the only one a timeout or a stop has to take down. */
+    current = null;
+    timer = null;
+    constructor(cwd, instructions, options = {}) {
+        super();
+        this.cwd = cwd;
+        this.instructions = instructions;
+        this.options = options;
+    }
+    get currentStep() { return this.vCurrentStep; }
+    get isFinished() { return this.vIsFinished; }
+    get isRunning() { return this.vIsRunning; }
+    get completes() { return this.vResults.length; }
+    get totalTime() { return this.vTotalTime; }
+    get successes() { return this.vResults.filter(r => r.success).length; }
+    get results() { return this.vResults; }
+    get fails() { return this.vResults.filter(r => !r.success).length; }
+    /**
+     * Runs every instruction in sequence and settles the verdict of the task.
+     * @returns A promise resolving with the summary of the run, or rejecting with a
+     * {@link Task.Failure} carrying it, when the task failed and does not tolerate failures.
+     *
+     * @remarks This promise is the only verdict of the run: the `finish` event carries the same summary
+     * for reporting, and nothing is decided by it.
+     *
+     * The failure of an instruction does not stop the task, so the remaining instructions still run, and
+     * `allowFails` tolerates it. Anything else does stop the task, tolerating nothing, because none of
+     * them is the failure of a command: a run that timed out, was stopped, could not start a program or
+     * lost its shell did not do what it was asked to do, and `success: false` is not a verdict a caller
+     * can act on.
+     *
+     * @example
+     * ```ts
+     * const task = new Task(cwd, [ { executable: 'git', args: ['clone', repo, folder] } ], { maxTimeMs: 30000 });
+     * task.on('line', (line) => logger.info(line));
+     * const outcome = await task.run();
+     * ```
+     */
+    async run() {
+        if (this.vIsFinished)
+            throw new Error('Task has already run.');
+        if (this.vIsRunning)
+            throw new Error('Task is already running.');
+        this.vIsRunning = true;
+        this.arm();
+        try {
+            for (const instruction of this.instructions) {
+                if (this.vIsStopped)
+                    break;
+                this.vCurrentStep += 1;
+                const result = await this.execute(instruction);
+                this.vResults.push(result);
+                this.vTotalTime += result.time;
+                if (result.success)
+                    this.emit('step', result, this.vCurrentStep, result.time);
+                else
+                    this.emit('error', result, this.vCurrentStep, result.time);
+                if (result.reason && result.reason !== 'stopped')
+                    this.vReason = result.reason;
+                if (result.reason)
+                    break;
+            }
+            const summary = this.getSummary();
+            if (this.vIsStopped)
+                throw new Task.Failure(summary, 'stopped');
+            if (this.vReason !== null)
+                throw new Task.Failure(summary, this.vReason);
+            if (summary.fails > 0 && !this.options.allowFails)
+                throw new Task.Failure(summary, 'command');
+            return summary;
+        }
+        finally {
+            this.vIsRunning = false;
+            this.vIsFinished = true;
+            this.disarm();
+            this.dispose();
+            this.emit('finish', this.getSummary());
+        }
+    }
+    /**
+     * Stops the task, taking down the instruction in flight, if any.
+     * @returns void
+     *
+     * @remarks The pending run rejects with a {@link Task.Failure} of reason `stopped`, so a caller
+     * that stops a task never waits for a verdict that will not come.
+     */
+    stop() {
+        if (this.vIsFinished)
+            return;
+        this.vIsStopped = true;
+        this.current?.kill('stopped');
+    }
+    /**
+     * Runs one instruction and turns its verdict into a result of the task.
+     * @param instruction - The instruction to run, a script for the shell or a program of its own.
+     * @returns A promise resolving with the result of the instruction.
+     **/
+    async execute(instruction) {
+        const ordinal = this.vCurrentStep;
+        const command = typeof instruction === 'string'
+            ? Command.inShell(await this.getShell(), instruction, ordinal)
+            : Command.asProgram({ cwd: this.cwd, ...instruction }, ordinal);
+        this.current = command;
+        if (this.vIsStopped)
+            command.kill('stopped');
+        return new Promise((resolve) => {
+            command.on('log', (line, step) => this.emit('line', line, step));
+            command.on('err', (line, step) => this.emit('err', line, step));
+            command.once('end', (verdict) => {
+                if (this.current === command)
+                    this.current = null;
+                resolve(Task.result(command.label, verdict, ordinal));
+            });
+            command.exec();
+        });
+    }
+    /**
+     * The shell the scripts of this task are written to, started in the working directory of the task.
+     * @returns A promise resolving to the shell, or to `null` when the shell of the task is already gone.
+     *
+     * @remarks The shell is silenced before it is handed over: everything it writes about itself belongs
+     * to the shell and not to the first instruction, so the handshake that removes it completes first.
+     *
+     * @remarks A shell that dies takes down the instruction reading it, and the reason of the run becomes
+     * `shell`: the instruction is reported as unfinished because there is no longer anything reading it,
+     * and it is the task that owns the shell that says the shell is gone.
+     */
+    async getShell() {
+        if (!this.shell) {
+            this.shell = Command.createShell(this.cwd);
+            this.shell.stdin.on('error', () => { });
+            this.shell.once('error', () => { this.current?.kill('shell'); });
+            this.shell.once('exit', () => { this.current?.kill('shell'); });
+            this.prepared = Command.prepare(this.shell);
+        }
+        await this.prepared;
+        return this.shell.exitCode === null && this.shell.signalCode === null ? this.shell : null;
+    }
+    /**
+     * Arms the deadline of the task, taken from the time it started.
+     * @returns void
+     **/
+    arm() {
+        const limit = this.options.maxTimeMs ?? -1;
+        if (limit < 0)
+            return;
+        this.timer = setTimeout(() => {
+            this.vReason = 'timeout';
+            this.current?.kill('timeout');
+        }, limit);
+        this.timer.unref();
+    }
+    /** Disarms the deadline of the task. **/
+    disarm() {
+        if (!this.timer)
+            return;
+        clearTimeout(this.timer);
+        this.timer = null;
+    }
+    /** Takes down the shell of the task, if it created one. **/
+    dispose() {
+        this.current = null;
+        this.prepared = null;
+        if (!this.shell)
+            return;
+        Command.terminate(this.shell);
+        this.shell = null;
+    }
+    /**
+     * Turns the verdict of an instruction into the result the task keeps: the identity of the command,
+     * the verdict itself, the output it produced and the diagnostic that explains how it ended.
+     *
+     * @remarks The output and the error are kept whole, so a caller can show them, save them or search
+     * them without a policy having to be present while the command runs. Nothing is added to either
+     * buffer, and the diagnostic never carries them: it says what happened, and the buffers say why.
+     *
+     * @param label - The human readable form of the instruction.
+     * @param verdict - The verdict the command settled with.
+     * @param ordinal - The position of the instruction inside the task, starting at 1.
+     * @returns The result of the instruction.
+     **/
+    static result(label, verdict, ordinal) {
+        return {
+            ordinal,
+            label,
+            success: verdict.code === 0 && verdict.reason === null,
+            code: verdict.code,
+            signal: verdict.signal,
+            reason: verdict.reason,
+            time: verdict.time,
+            stdout: verdict.output,
+            stderr: verdict.error,
+            diagnostic: Task.diagnostic(label, verdict)
+        };
+    }
+    /**
+     * The one line that explains how an instruction ended, the same in every mode and the only text
+     * about the failure that belongs to the result.
+     *
+     * @remarks A command that failed carries its status, its signal or the reason it could not finish,
+     * and never its output: mixing both made the first line of a failure unreadable, and the output is
+     * already in the buffers, in the evidence file and, when it is wanted, right under this line.
+     *
+     * @param label - The human readable form of the instruction.
+     * @param verdict - The verdict the command settled with.
+     * @returns The diagnostic of the instruction, empty when it succeeded.
+     **/
+    static diagnostic(label, verdict) {
+        if (verdict.reason === 'timeout')
+            return `Instruction timed out: ${label}`;
+        if (verdict.reason === 'stopped')
+            return `Instruction stopped: ${label}`;
+        if (verdict.reason === 'shell')
+            return `The shell exited before the instruction finished: ${label}`;
+        if (verdict.reason === 'spawn')
+            return `Instruction could not be started: ${label}`;
+        if (verdict.reason === 'protocol')
+            return `The shell did not report the status of: ${label}`;
+        if (verdict.reason !== null || verdict.code === 0)
+            return '';
+        return verdict.signal
+            ? `Command failed with signal ${verdict.signal}: ${label}`
+            : `Command failed with status ${verdict.code}: ${label}`;
+    }
+    /**
+     * The summary of the task execution, which is both the verdict of the run and what the `finish`
+     * event reports.
+     * @returns The summary of the execution.
+     **/
+    getSummary() {
+        return {
+            success: this.vReason === null && (this.fails === 0 || this.options.allowFails === true),
+            completes: this.completes,
+            fails: this.fails,
+            totalTime: this.totalTime,
+            results: this.results
+        };
+    }
+}
+(function (Task) {
+    /**
+     * The failure of a task, carrying the summary of the run that produced it.
+     *
+     * @remarks The message says how the task failed and nothing more. The output of every instruction is
+     * in the summary, one result per command, and printing it here duplicated it in every message a
+     * caller logged: a task that printed a build log threw the log away once per layer that reported it.
+     */
+    class Failure extends Error {
+        outcome;
+        reason;
+        /**
+         * Creates the failure of a task.
+         * @param outcome - The summary of the run.
+         * @param reason - Why the task failed.
+         */
+        constructor(outcome, reason = 'command') {
+            super(Failure.message(outcome, reason));
+            this.outcome = outcome;
+            this.reason = reason;
+            this.name = 'Task.Failure';
+        }
+        /**
+         * The message describing why a task failed: how many instructions failed, and why the run did not
+         * get to all of them.
+         * @param outcome - The summary of the run.
+         * @param reason - Why the task failed.
+         * @returns The message of the failure.
+         **/
+        static message(outcome, reason) {
+            const lines = [];
+            if (outcome.fails > 0)
+                lines.push(`Task failed with ${outcome.fails} failed instruction(s).`);
+            if (reason === 'timeout')
+                lines.push('Task timed out before completing every instruction.');
+            else if (reason === 'stopped')
+                lines.push('Task was stopped before completing every instruction.');
+            else if (reason === 'shell')
+                lines.push('The shell running the task exited unexpectedly.');
+            else if (reason === 'spawn')
+                lines.push('An instruction could not be started.');
+            else if (reason === 'protocol')
+                lines.push('The shell did not report the status of an instruction.');
+            return lines.join('\n');
+        }
+    }
+    Task.Failure = Failure;
+})(Task || (Task = {}));
+export default Task;
+//# sourceMappingURL=Task.js.map

package/dist/task/Task.js.map

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

package/package.json

@@ -1,21 +1,22 @@
 {
   "name": "depflow",
   "description": "is a simple dependency manager based on github repositories",
-  "version": "3.0.0-dev.1",
-  "main": "build/bin/bin.js",
+  "version": "3.0.0-dev.11",
+  "main": "dist/cli/bin.js",
   "type": "module",
   "bin": {
-    "dep": "build/cli/bin.js"
+    "dep": "dist/cli/bin.js"
   },
   "scripts": {
-    "dev": "npx tsc --watch",
-    "compile": "npx tsc",
-    "prepare": "npm run compile"
+    "clean": "node ./scripts/clean.mjs",
+    "dev": "npx tsc --watch -p tsconfig.depflow.json",
+    "build": "npm run clean && npx tsc -p tsconfig.depflow.json",
+    "test": "npx tsc -p tsconfig.test.json && node --import ./tests/_register.mjs dist-test/tests/index.js",
+    "prepublishOnly": "npm run build && npm test"
   },
   "license": "Apache-2.0",
   "repository": {
-    "type": "git",
-    "url": "https://github.com/NetFeez/DependencyManager.git"
+    "url": "git+https://github.com/NetFeez/depflow.git"
   },
   "author": {
     "name": "NetFeez",
@@ -27,18 +28,19 @@
     "manager"
   ],
   "files": [
-    "build",
-    ".gitignore",
+    "dist",
     "LICENCE",
     "README.md"
   ],
   "dependencies": {
-    "@netfeez/common": "^3.0.0",
-    "@netfeez/common-node": "^3.0.0",
-    "@netfeez/vterm": "^1.1.0"
+    "@netfeez/common": "^4.2.0",
+    "@netfeez/common-node": "^3.4.0",
+    "@netfeez/schema": "^0.1.0",
+    "@netfeez/vterm": "^2.0.0-dev.1",
+    "@netfeez/yaml": "^0.2.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "typescript": "^6.0.2"
+    "typescript": "^7.0.2"
   }
 }

package/.gitignore

@@ -1,7 +0,0 @@
-# Build setting
-**/node_modules/
-**/build/
-**/.**
-**/*.log
-**/*.env
-!.gitignore

package/build/cli/DepFLowCLI.d.ts

@@ -1,15 +0,0 @@
-import { DebugUI } from "@netfeez/vterm";
-export declare class DepFlowCLI extends DebugUI {
-    readonly configPath: string;
-    protected readonly projectRoot: string;
-    constructor(configPath?: string);
-    commandAdd(command: string, args: string[]): Promise<void>;
-    commandRemove(command: string, args: string[]): Promise<void>;
-    commandInstall(command: string, args: string[]): Promise<void>;
-    uninstall(command: string, args: string[]): Promise<void>;
-    list(command: string, args: string[]): Promise<void>;
-    rewritePaths(command: string, args: string[]): Promise<void>;
-    commandSync(command: string, args: string[]): Promise<void>;
-}
-export declare namespace DepFlowCLI { }
-export default DepFlowCLI;