@sfship/plugin-ship 1.0.0-beta.2

package/lib/core/flow.renderer.js

@@ -0,0 +1,137 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { StandardColors } from '@salesforce/sf-plugins-core';
+import { ExpectedError } from './error.js';
+import { formatFlowPlan, formatStepHeading, formatFlowSummary } from './flow.view.js';
+/**
+ * Renders a flow run as plain sequential output: a plan banner up front, a
+ * heading before each step, the step's own (and any subcommand's) output
+ * flowing untouched, and a result summary at the end.
+ *
+ * All formatting lives in the `flow.view` module so a flow looks the same
+ * whether it runs here or is inspected via `ship flow info`.
+ */
+export class FlowRenderer {
+    flowName;
+    mainSteps;
+    finallySteps;
+    write;
+    stepsById = new Map();
+    order = [];
+    completed = new Set();
+    failed = new Set();
+    skipped = new Set();
+    ignored = new Map();
+    currentStep = null;
+    constructor(flowName, mainSteps, finallySteps, ctx, out = process.stdout) {
+        this.flowName = flowName;
+        this.mainSteps = mainSteps;
+        this.finallySteps = finallySteps;
+        this.write = out.write.bind(out);
+        for (const [id, step] of [...mainSteps, ...finallySteps]) {
+            this.stepsById.set(id, step);
+            this.order.push(id);
+        }
+        // The renderer owns presentation, so it takes over the context logger to
+        // timestamp lines and prefix them with the step that emitted them.
+        // eslint-disable-next-line no-param-reassign
+        ctx.log = (message) => this.logLine(message);
+    }
+    /** The step currently executing, or null between steps. */
+    get activeStep() {
+        return this.currentStep;
+    }
+    get outcome() {
+        return { completed: this.completed, failed: this.failed, skipped: this.skipped, ignored: this.ignored };
+    }
+    static timestamp() {
+        const now = new Date();
+        const h = String(now.getHours()).padStart(2, '0');
+        const m = String(now.getMinutes()).padStart(2, '0');
+        const s = String(now.getSeconds()).padStart(2, '0');
+        return `${h}:${m}:${s}`;
+    }
+    /** Prints the plan banner at the start of the run. */
+    start() {
+        this.write(`${formatFlowPlan(this.flowName, this.mainSteps, this.finallySteps)}\n`);
+    }
+    /** Prints the heading for a step that is about to run. */
+    stepStart(stepId) {
+        this.currentStep = stepId;
+        const step = this.stepsById.get(stepId);
+        if (!step)
+            return;
+        const position = this.order.indexOf(stepId) + 1;
+        this.write(`${formatStepHeading(position, this.order.length, stepId, step)}\n`);
+    }
+    stepComplete(stepId) {
+        this.completed.add(stepId);
+        this.currentStep = null;
+        this.write(`${StandardColors.success('✓')} ${stepId}\n`);
+    }
+    stepFailed(stepId) {
+        this.failed.add(stepId);
+        this.currentStep = null;
+        // The error itself is reported once, with context, in flowFailed().
+        this.write(`${StandardColors.error('✗')} ${stepId}\n`);
+    }
+    stepSkipped(stepId) {
+        this.skipped.add(stepId);
+        this.write(`${StandardColors.info('—')} ${stepId} (skipped)\n`);
+    }
+    stepIgnored(stepId, err) {
+        this.ignored.set(stepId, err.message);
+        this.currentStep = null;
+        this.write(`${StandardColors.warning('⚠')} ${stepId} (ignored: ${err.message})\n`);
+    }
+    /** Reports a flow that could not start (e.g. invalid flow params). */
+    failedBeforeStart(err) {
+        this.write(`\n${StandardColors.error(`✗ Flow "${this.flowName}" could not start`)}\n\n`);
+        for (const line of err.message.split('\n'))
+            this.write(`  ${line}\n`);
+        this.write('\n');
+    }
+    /** Reports a hard failure: prints the summary, then the error (and stack for unexpected errors). */
+    flowFailed(stepId, err) {
+        this.write(`${formatFlowSummary(this.mainSteps, this.finallySteps, this.outcome)}\n`);
+        this.write(`\n${StandardColors.error(`✗ Flow "${this.flowName}" failed at step "${stepId}"`)}\n\n`);
+        for (const line of err.message.split('\n'))
+            this.write(`  ${line}\n`);
+        if (!(err instanceof ExpectedError) && err.stack) {
+            this.write('\n');
+            for (const line of err.stack.split('\n').slice(1))
+                this.write(`  ${line.trim()}\n`);
+        }
+        this.write('\n');
+    }
+    /** Prints the summary and the success banner. */
+    success() {
+        this.write(`${formatFlowSummary(this.mainSteps, this.finallySteps, this.outcome)}\n`);
+        this.write(`\n${StandardColors.success(`✓ Flow "${this.flowName}" finished successfully!`)}\n\n`);
+    }
+    /** Handles a user interrupt (Ctrl+C): marks the active step failed and reports it. */
+    interrupt() {
+        const step = this.currentStep;
+        if (step)
+            this.failed.add(step);
+        this.currentStep = null;
+        this.flowFailed(step ?? '?', new ExpectedError('Interrupted by user.'));
+    }
+    logLine(message) {
+        const ts = StandardColors.info(FlowRenderer.timestamp());
+        const prefix = this.currentStep ? `${StandardColors.info(`[${this.currentStep}]`)} ` : '';
+        this.write(`${ts} ${prefix}${message}\n`);
+    }
+}
+//# sourceMappingURL=flow.renderer.js.map

package/lib/core/flow.renderer.js.map

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

package/lib/core/flow.runner.d.ts

@@ -0,0 +1,13 @@
+import { FlowContext } from './flow.context.js';
+import { FlowDefinition } from './flow.definition.schema.js';
+import { FlowRenderer } from './flow.renderer.js';
+/**
+ * Handles an error that reaches the process while a flow owns the renderer.
+ *
+ * oclif converts Ctrl+C into an EEXIT error; we take over (the renderer is ours
+ * now) so an interrupt prints a clean failure instead of a raw stack, pass any
+ * other oclif exit code through unchanged, and route unexpected crashes back
+ * through the renderer.
+ */
+export declare function handleUncaught(renderer: FlowRenderer, err: unknown): void;
+export declare function runFlow(flowName: string, flow: FlowDefinition, context: FlowContext): Promise<void>;

package/lib/core/flow.runner.js

@@ -0,0 +1,133 @@
+import { validateParams } from './task.param.js';
+import { TaskRegistry } from './task.registry.js';
+import { Store } from './flow.store.js';
+import { FlowRenderer } from './flow.renderer.js';
+import { asError, ExpectedError } from './error.js';
+import { resolvePureToken } from './flow.interpolate.js';
+function resolveConditionValue(condition, context) {
+    const resolved = resolvePureToken(condition.value, context);
+    return resolved !== undefined ? resolved : condition.value;
+}
+function rootMessage(err) {
+    if (err.message)
+        return err.message;
+    return err.cause instanceof Error ? rootMessage(err.cause) : err.toString();
+}
+function coerce(val) {
+    return typeof val === 'string' && Number.isFinite(Number(val)) ? Number(val) : val;
+}
+function evaluateIf(condition, context) {
+    const resolved = resolveConditionValue(condition, context);
+    return condition.equals !== undefined ? resolved === condition.equals : Boolean(coerce(resolved));
+}
+function evaluateIfNot(condition, context) {
+    const resolved = resolveConditionValue(condition, context);
+    return condition.equals !== undefined ? resolved !== condition.equals : !coerce(resolved);
+}
+async function runSteps(stepEntries, flowName, context, store, taskRunner, renderer, ignoreAllFailures = false) {
+    for (const [stepId, step] of stepEntries) {
+        const interpolationContext = {
+            params: context.params,
+            steps: store.getSteps(),
+            config: context.config,
+            flow: { hasFailures: context.hasFailures },
+        };
+        if (step.if && !evaluateIf(step.if, interpolationContext)) {
+            renderer.stepSkipped(stepId);
+            continue;
+        }
+        if (step['if-not'] && !evaluateIfNot(step['if-not'], interpolationContext)) {
+            renderer.stepSkipped(stepId);
+            continue;
+        }
+        renderer.stepStart(stepId);
+        try {
+            // eslint-disable-next-line no-await-in-loop
+            const task = await taskRunner.resolveTask(step.task);
+            const interpolated = store.resolveParams(step.params ?? {}, interpolationContext);
+            const params = validateParams(interpolated, task.params);
+            const output = store.getTaskOutput(stepId);
+            // eslint-disable-next-line no-await-in-loop
+            await task.run({ flow: context, params, output });
+        }
+        catch (err) {
+            const error = asError(err);
+            if (step['ignore-failure'] ?? ignoreAllFailures) {
+                renderer.stepIgnored(stepId, error);
+                store.set(stepId, 'failed', true);
+                store.set(stepId, 'error', error.message);
+                // eslint-disable-next-line no-param-reassign
+                context.hasFailures = true;
+                continue;
+            }
+            renderer.stepFailed(stepId);
+            store.set(stepId, 'failed', true);
+            store.set(stepId, 'error', error.message);
+            // eslint-disable-next-line no-param-reassign
+            context.hasFailures = true;
+            error.message =
+                error instanceof ExpectedError
+                    ? `${error.message}\n(step "${stepId}" in flow "${flowName}")`
+                    : `Step "${stepId}" in flow "${flowName}" failed: ${rootMessage(error)}`;
+            return { stepId, error };
+        }
+        renderer.stepComplete(stepId);
+    }
+    return undefined;
+}
+/**
+ * Handles an error that reaches the process while a flow owns the renderer.
+ *
+ * oclif converts Ctrl+C into an EEXIT error; we take over (the renderer is ours
+ * now) so an interrupt prints a clean failure instead of a raw stack, pass any
+ * other oclif exit code through unchanged, and route unexpected crashes back
+ * through the renderer.
+ */
+export function handleUncaught(renderer, err) {
+    const e = asError(err);
+    if (e.code === 'EEXIT') {
+        const exitCode = e.oclif?.exit ?? 1;
+        if (exitCode === 130) {
+            process.stdout.write = () => true;
+            process.stderr.write = () => true;
+            renderer.interrupt();
+        }
+        process.exit(exitCode);
+    }
+    renderer.flowFailed(renderer.activeStep ?? '?', e);
+    process.exit(1);
+}
+export async function runFlow(flowName, flow, context) {
+    const mainSteps = Object.entries(flow.steps);
+    const finallySteps = Object.entries(flow.finally ?? {});
+    const renderer = new FlowRenderer(flowName, mainSteps, finallySteps, context);
+    if (flow.params?.length) {
+        try {
+            // eslint-disable-next-line no-param-reassign
+            context.params = validateParams(context.params, flow.params);
+        }
+        catch (err) {
+            renderer.failedBeforeStart(asError(err));
+            throw err;
+        }
+    }
+    // Take over uncaught errors while we own the renderer (see handleUncaught).
+    const onUncaught = handleUncaught.bind(null, renderer);
+    process.once('uncaughtException', onUncaught);
+    try {
+        renderer.start();
+        const store = new Store(flow.steps);
+        const taskRunner = new TaskRegistry(context.shipDir);
+        const hardError = await runSteps(mainSteps, flowName, context, store, taskRunner, renderer);
+        await runSteps(finallySteps, flowName, context, store, taskRunner, renderer, true);
+        if (hardError) {
+            renderer.flowFailed(hardError.stepId, hardError.error);
+            throw new ExpectedError(hardError.error.message);
+        }
+        renderer.success();
+    }
+    finally {
+        process.removeListener('uncaughtException', onUncaught);
+    }
+}
+//# sourceMappingURL=flow.runner.js.map

package/lib/core/flow.runner.js.map

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

package/lib/core/flow.store.d.ts

@@ -0,0 +1,24 @@
+import { TaskOutput } from './task.output.js';
+/**
+ * Holds all step outputs for a flow run and owns param interpolation.
+ * Internal to the flow runner — not exposed to tasks directly.
+ * Tasks interact with outputs only through `TaskOutput` instances.
+ */
+export declare class Store {
+    private readonly data;
+    /** Initializes the store, registering a namespace for each step in the flow. */
+    constructor(steps?: Record<string, unknown>);
+    /** Returns the `TaskOutput` for a step. */
+    getTaskOutput(stepId: string): TaskOutput;
+    /** Writes a value into a step's namespace. Used by `TaskOutput.set`. */
+    set(stepId: string, key: string, value: unknown): void;
+    /** Reads a value from a step's namespace. Used by `TaskOutput.get`. */
+    get(stepId: string, key: string): unknown;
+    /** Returns all step outputs as a plain nested object, keyed by step ID. */
+    getSteps(): Record<string, Record<string, unknown>>;
+    /**
+     * Interpolates all `${{ path }}` tokens in a raw params object using the provided context.
+     * The caller is responsible for building the context (e.g. `{ params, steps }`).
+     */
+    resolveParams(rawParams: Record<string, unknown>, context: Record<string, unknown>): Record<string, unknown>;
+}

package/lib/core/flow.store.js

@@ -0,0 +1,57 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { TaskOutput } from './task.output.js';
+import { interpolate } from './flow.interpolate.js';
+/**
+ * Holds all step outputs for a flow run and owns param interpolation.
+ * Internal to the flow runner — not exposed to tasks directly.
+ * Tasks interact with outputs only through `TaskOutput` instances.
+ */
+export class Store {
+    data = new Map();
+    /** Initializes the store, registering a namespace for each step in the flow. */
+    constructor(steps) {
+        for (const stepId of Object.keys(steps ?? {})) {
+            this.data.set(stepId, new Map());
+        }
+    }
+    /** Returns the `TaskOutput` for a step. */
+    getTaskOutput(stepId) {
+        if (!this.data.has(stepId)) {
+            this.data.set(stepId, new Map());
+        }
+        return new TaskOutput(stepId, this);
+    }
+    /** Writes a value into a step's namespace. Used by `TaskOutput.set`. */
+    set(stepId, key, value) {
+        this.data.get(stepId)?.set(key, value);
+    }
+    /** Reads a value from a step's namespace. Used by `TaskOutput.get`. */
+    get(stepId, key) {
+        return this.data.get(stepId)?.get(key);
+    }
+    /** Returns all step outputs as a plain nested object, keyed by step ID. */
+    getSteps() {
+        return Object.fromEntries([...this.data.keys()].map((id) => [id, Object.fromEntries(this.data.get(id))]));
+    }
+    /**
+     * Interpolates all `${{ path }}` tokens in a raw params object using the provided context.
+     * The caller is responsible for building the context (e.g. `{ params, steps }`).
+     */
+    // eslint-disable-next-line class-methods-use-this
+    resolveParams(rawParams, context) {
+        return Object.fromEntries(Object.entries(rawParams).map(([k, v]) => [k, interpolate(v, context)]));
+    }
+}
+//# sourceMappingURL=flow.store.js.map

package/lib/core/flow.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.store.js","sourceRoot":"","sources":["../../src/core/flow.store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,OAAO,KAAK;IACC,IAAI,GAAsC,IAAI,GAAG,EAAE,CAAC;IAErE,gFAAgF;IAChF,YAAmB,KAA+B;QAChD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,2CAA2C;IACpC,aAAa,CAAC,MAAc;QACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,wEAAwE;IACjE,GAAG,CAAC,MAAc,EAAE,GAAW,EAAE,KAAc;QACpD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,uEAAuE;IAChE,GAAG,CAAC,MAAc,EAAE,GAAW;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,2EAA2E;IACpE,QAAQ;QACb,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7G,CAAC;IAED;;;OAGG;IACH,kDAAkD;IAC3C,aAAa,CAAC,SAAkC,EAAE,OAAgC;QACvF,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACrG,CAAC;CACF"}

package/lib/core/flow.view.d.ts

@@ -0,0 +1,20 @@
+import { FlowStep } from './flow.definition.schema.js';
+/** The terminal state of every step in a finished (or failed) flow. */
+export type FlowOutcome = {
+    completed: ReadonlySet<string>;
+    failed: ReadonlySet<string>;
+    skipped: ReadonlySet<string>;
+    ignored: ReadonlyMap<string, string>;
+};
+type Steps = ReadonlyArray<readonly [string, FlowStep]>;
+/**
+ * UX formatted flow name + description
+ */
+export declare function formatFlowPreview(flowName: string, description?: string): string;
+/** The plan banner printed once when a flow starts. */
+export declare function formatFlowPlan(flowName: string, mainSteps: Steps, finallySteps: Steps): string;
+/** The heading printed when a step begins. */
+export declare function formatStepHeading(position: number, total: number, stepId: string, step: FlowStep): string;
+/** The result summary printed when a flow ends, success or failure. */
+export declare function formatFlowSummary(mainSteps: Steps, finallySteps: Steps, outcome: FlowOutcome): string;
+export {};

package/lib/core/flow.view.js

@@ -0,0 +1,77 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { StandardColors } from '@salesforce/sf-plugins-core';
+function stepAnnotations(step) {
+    const tags = [];
+    if (step.if)
+        tags.push('if');
+    if (step['if-not'])
+        tags.push('if-not');
+    if (step['ignore-failure'])
+        tags.push('ignore-failure');
+    return tags.length ? ` ${StandardColors.info(`[${tags.join(', ')}]`)}` : '';
+}
+function planLines(steps, startIndex) {
+    return steps.map(([id, step], i) => `  ${String(startIndex + i + 1).padStart(2)}. ${id.padEnd(24)} ${StandardColors.info('→')} ${step.task}${stepAnnotations(step)}`);
+}
+/**
+ * UX formatted flow name + description
+ */
+export function formatFlowPreview(flowName, description) {
+    const header = `${StandardColors.info('Flow:')} ${StandardColors.success(flowName)}`;
+    return description ? `${header}\n${StandardColors.info('Description:')} ${description}` : header;
+}
+/** The plan banner printed once when a flow starts. */
+export function formatFlowPlan(flowName, mainSteps, finallySteps) {
+    const lines = [
+        `${StandardColors.info('Flow:')} ${StandardColors.success(flowName)}`,
+        '',
+        StandardColors.info('Steps'),
+        ...planLines(mainSteps, 0),
+    ];
+    if (finallySteps.length > 0) {
+        lines.push('', StandardColors.info('Finally'), ...planLines(finallySteps, mainSteps.length));
+    }
+    return lines.join('\n');
+}
+/** The heading printed when a step begins. */
+export function formatStepHeading(position, total, stepId, step) {
+    return `\n${StandardColors.info(`→ Task [${position}/${total}]`)} ${StandardColors.success(stepId)} ${StandardColors.info('·')} ${step.task}`;
+}
+function outcomeLine(stepId, outcome) {
+    if (outcome.failed.has(stepId))
+        return `  ${StandardColors.error('✗')} ${stepId}`;
+    if (outcome.ignored.has(stepId)) {
+        return `  ${StandardColors.warning('⚠')} ${stepId} ${StandardColors.warning(`(ignored: ${outcome.ignored.get(stepId) ?? ''})`)}`;
+    }
+    if (outcome.completed.has(stepId))
+        return `  ${StandardColors.success('✓')} ${stepId}`;
+    if (outcome.skipped.has(stepId))
+        return `  ${StandardColors.info('—')} ${stepId} (skipped)`;
+    return `  ${StandardColors.info('○')} ${stepId} (not run)`;
+}
+/** The result summary printed when a flow ends, success or failure. */
+export function formatFlowSummary(mainSteps, finallySteps, outcome) {
+    const all = [...mainSteps, ...finallySteps];
+    const counts = [
+        StandardColors.success(`${outcome.completed.size} passed`),
+        outcome.failed.size ? StandardColors.error(`${outcome.failed.size} failed`) : `${outcome.failed.size} failed`,
+        `${outcome.skipped.size} skipped`,
+        outcome.ignored.size
+            ? StandardColors.warning(`${outcome.ignored.size} ignored`)
+            : `${outcome.ignored.size} ignored`,
+    ].join(' · ');
+    return ['', StandardColors.info('Flow Summary'), ...all.map(([id]) => outcomeLine(id, outcome)), '', counts].join('\n');
+}
+//# sourceMappingURL=flow.view.js.map

package/lib/core/flow.view.js.map

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

package/lib/core/flows/create/package.yml

@@ -0,0 +1,18 @@
+description: Register the 2GP package on the Dev Hub and write its 0Ho into sfdx-project.json. Run once per project before any release or deploy/feature flow.
+params:
+  - name: path
+    type: string
+    required: false
+    default: force-app
+    description: Path to the package source directory.
+  - name: target-dev-hub
+    type: string
+    required: false
+    description: Dev hub alias or username. Defaults to the SF CLI default target-dev-hub.
+steps:
+  create-package:
+    task: package/create
+    params:
+      package-type: ${{ config.project.package.type }}
+      path: ${{ params.path }}
+      target-dev-hub: ${{ params.target-dev-hub }}

package/lib/core/flows/dependencies/lock.yml

@@ -0,0 +1,4 @@
+description: Resolve ship.yml dependencies into sfdx-project.json. Run whenever your dependencies change, then commit the diff before cutting a release.
+steps:
+  lock:
+    task: package/dependencies/lock

package/lib/core/flows/deploy/beta.yml

@@ -0,0 +1,38 @@
+description: Install the latest beta into a fresh scratch org and run Apex tests.
+steps:
+  create-org:
+    task: org/create/scratch
+    params:
+      scratch-def: beta
+      duration: 1
+      no-namespace: true
+  find-beta:
+    task: git/release/fetch
+    params:
+      prerelease: true
+  update-dependencies:
+    task: package/install/dependencies
+    params:
+      target-org: ${{ steps.create-org.target-org }}
+  install:
+    task: package/install
+    params:
+      target-org: ${{ steps.create-org.target-org }}
+      version-id: ${{ steps.find-beta.version-id }}
+  assign-permsets:
+    task: org/assign/permsets
+    params:
+      target-org: ${{ steps.create-org.target-org }}
+  find-test-classes:
+    task: util/file/find
+    params:
+      path: force-app/main/default/classes
+      pattern: ${{ config.project.package.testPattern }}
+  run-tests:
+    if:
+      value: ${{ steps.find-test-classes.count }}
+    task: apex/run/test
+    params:
+      target-org: ${{ steps.create-org.target-org }}
+      class-names: ${{ steps.find-test-classes.files }}
+      namespace: ${{ config.project.package.namespace }}

package/lib/core/flows/deploy/dev.yml

@@ -0,0 +1,26 @@
+description: Set up a scratch org as a development environment for unmanaged metadata.
+steps:
+  create-org:
+    task: org/create/scratch
+    params:
+      scratch-def: dev
+      duration: 30
+  update-dependencies:
+    task: package/install/dependencies
+    params:
+      target-org: ${{ steps.create-org.target-org }}
+  deploy:
+    task: project/deploy/start
+    params:
+      target-org: ${{ steps.create-org.target-org }}
+  assign-permsets:
+    task: org/assign/permsets
+    params:
+      target-org: ${{ steps.create-org.target-org }}
+  load-data:
+    task: data/import/tree
+    if:
+      value: ${{ steps.create-org.created }}
+      equals: true
+    params:
+      target-org: ${{ steps.create-org.target-org }}

package/lib/core/flows/deploy/feature.yml

@@ -0,0 +1,56 @@
+description: Build a managed package version, install it, and run Apex tests against a fresh scratch org.
+params:
+  - name: version-id
+    type: string
+    required: false
+    description: Existing 04t SubscriberPackageVersionId to install. If omitted, a new package version is built from the current commit.
+  - name: version-type
+    type: string
+    required: false
+    default: build
+    description: Which part of the version to bump relative to the latest released version. One of build, patch, minor, major.
+steps:
+  create-org:
+    task: org/create/scratch
+    params:
+      scratch-def: feature
+      duration: 1
+      no-namespace: true
+  resolve-next:
+    if-not:
+      value: ${{ params.version-id }}
+    task: package/version/resolve-next
+    params:
+      version-type: ${{ params.version-type }}
+  create-version:
+    if-not:
+      value: ${{ params.version-id }}
+    task: package/version/create
+    params:
+      code-coverage: false
+      skip-validation: true
+      version-number: ${{ steps.resolve-next.version-number }}
+  update-dependencies:
+    task: package/install/dependencies
+    params:
+      target-org: ${{ steps.create-org.target-org }}
+  install:
+    task: package/install
+    params:
+      target-org: ${{ steps.create-org.target-org }}
+      # Only one of these resolves per run: create-version's output if it ran,
+      # otherwise the version-id param. Mixed-string concat handles the empty side.
+      version-id: ${{ steps.create-version.version-id }}${{ params.version-id }}
+  find-test-classes:
+    task: util/file/find
+    params:
+      path: force-app/main/default/classes
+      pattern: ${{ config.project.package.testPattern }}
+  run-tests:
+    if:
+      value: ${{ steps.find-test-classes.count }}
+    task: apex/run/test
+    params:
+      target-org: ${{ steps.create-org.target-org }}
+      class-names: ${{ steps.find-test-classes.files }}
+      namespace: ${{ config.project.package.namespace }}