@aidc-toolkit/dev 1.0.23-beta → 1.0.24-beta

package/src/publish/publish.ts

@@ -1,875 +0,0 @@
-import { spawnSync } from "node:child_process";
-import * as fs from "node:fs";
-import * as process from "node:process";
-import {
-    type Configuration,
-    loadConfiguration,
-    type Phase,
-    type PhaseState,
-    type Repository,
-    saveConfiguration,
-    SHARED_CONFIGURATION_PATH
-} from "./configuration.js";
-import { logger, setLogLevel } from "./logger.js";
-import { pick } from "./type-helper.js";
-
-export const PACKAGE_CONFIGURATION_PATH = "package.json";
-
-export const PACKAGE_LOCK_CONFIGURATION_PATH = "package-lock.json";
-
-/**
- * Configuration layout of package.json (relevant attributes only).
- */
-export interface PackageConfiguration {
-    /**
-     * Name.
-     */
-    readonly name: string;
-
-    /**
-     * Version.
-     */
-    version: string;
-
-    /**
-     * Development dependencies.
-     */
-    readonly devDependencies?: Record<string, string>;
-
-    /**
-     * Dependencies.
-     */
-    readonly dependencies?: Record<string, string>;
-}
-
-/**
- * Repository state, derived from package configuration and updated during publishing.
- */
-interface RepositoryState {
-    /**
-     * Repository name from configuration.
-     */
-    readonly repositoryName: string;
-
-    /**
-     * Repository from configuration.
-     */
-    repository: Repository;
-
-    /**
-     * Phase state.
-     */
-    phaseState: PhaseState;
-
-    /**
-     * Phase date/time or undefined if phase never before published.
-     */
-    phaseDateTime: Date | undefined;
-
-    /**
-     * NPM platform arguments if any.
-     */
-    readonly npmPlatformArgs: readonly string[];
-
-    /**
-     * Branch.
-     */
-    readonly branch: string;
-
-    /**
-     * Package configuration.
-     */
-    readonly packageConfiguration: PackageConfiguration;
-
-    /**
-     * Major version.
-     */
-    majorVersion: number;
-
-    /**
-     * Minor version.
-     */
-    minorVersion: number;
-
-    /**
-     * Patch version.
-     */
-    patchVersion: number;
-
-    /**
-     * Pre-release identifier or null if none.
-     */
-    preReleaseIdentifier: string | null;
-
-    /**
-     * Dependency package names extracted directly from package configuration.
-     */
-    readonly dependencyPackageNames: readonly string[];
-
-    /**
-     * All dependency package names in publication order.
-     */
-    readonly allDependencyPackageNames: readonly string[];
-
-    /**
-     * True if any dependencies have been updated.
-     */
-    readonly anyDependenciesUpdated: boolean;
-}
-
-/**
- * Publish base class.
- */
-export abstract class Publish {
-    /**
-     * Phase.
-     */
-    private readonly _phase: Phase;
-
-    /**
-     * If true, outputs what would be run rather than running it.
-     */
-    private readonly _dryRun: boolean;
-
-    /**
-     * Configuration. Merger of shared and local configurations.
-     */
-    private readonly _configuration: Configuration;
-
-    /**
-     * At organization.
-     */
-    private readonly _atOrganization: string;
-
-    /**
-     * At organization registry parameter.
-     */
-    private readonly _atOrganizationRegistry: string;
-
-    /**
-     * Repository states, keyed on repository name.
-     */
-    private readonly _repositoryStates: Record<string, Readonly<RepositoryState>>;
-
-    /**
-     * Current repository state.
-     */
-    private _repositoryState: RepositoryState | undefined;
-
-    /**
-     * Constructor.
-     *
-     * @param releaseType
-     * Release type.
-     *
-     * @param dryRun
-     * If true, outputs what would be run rather than running it.
-     */
-    protected constructor(releaseType: Phase, dryRun: boolean) {
-        this._phase = releaseType;
-        this._dryRun = dryRun;
-
-        this._configuration = loadConfiguration();
-
-        this._atOrganization = `@${this.configuration.organization}`;
-
-        this._atOrganizationRegistry = `${this.atOrganization}:registry${releaseType === "alpha" ? `=${this.configuration.alphaRegistry}` : ""}`;
-
-        if (this._configuration.logLevel !== undefined) {
-            setLogLevel(this._configuration.logLevel);
-        }
-
-        this._repositoryStates = {};
-        this._repositoryState = undefined;
-    }
-
-    /**
-     * Get the phase.
-     */
-    protected get phase(): Phase {
-        return this._phase;
-    }
-
-    /**
-     * Determine if outputs what would be run rather than running it.
-     */
-    protected get dryRun(): boolean {
-        return this._dryRun;
-    }
-
-    /**
-     * Get the configuration.
-     */
-    protected get configuration(): Configuration {
-        return this._configuration;
-    }
-
-    /**
-     * Get the at organization.
-     */
-    protected get atOrganization(): string {
-        return this._atOrganization;
-    }
-
-    /**
-     * Get the at organization registry parameter.
-     */
-    protected get atOrganizationRegistry(): string {
-        return this._atOrganizationRegistry;
-    }
-
-    /**
-     * Get the repository states, keyed on repository name.
-     */
-    protected get repositoryStates(): Record<string, Readonly<RepositoryState>> {
-        return this._repositoryStates;
-    }
-
-    /**
-     * Get the current repository state.
-     */
-    protected get repositoryState(): RepositoryState {
-        // Repository state should be accessed only during active publication.
-        if (this._repositoryState === undefined) {
-            throw new Error("Repository state not defined");
-        }
-
-        return this._repositoryState;
-    }
-
-    /**
-     * Get the dependency version for a dependency repository.
-     *
-     * @param dependencyRepositoryName
-     * Dependency repository name.
-     *
-     * @param dependencyRepository
-     * Dependency repository.
-     *
-     * @returns
-     * Dependency version.
-     */
-    protected abstract dependencyVersionFor(dependencyRepositoryName: string, dependencyRepository: Repository): string;
-
-    /**
-     * Determine the latest date/time or undefined if all undefined.
-     *
-     * @param initialDateTime
-     * Initial date/time.
-     *
-     * @param additionalDateTimes
-     * Additional date/times.
-     *
-     * @returns
-     * Latest date/time.
-     */
-    protected latestDateTime(initialDateTime: Date, ...additionalDateTimes: Array<Date | undefined>): Date {
-        let latestDateTime = initialDateTime;
-
-        for (const dateTime of additionalDateTimes) {
-            if (dateTime !== undefined && latestDateTime.getTime() < dateTime.getTime()) {
-                latestDateTime = dateTime;
-            }
-        }
-
-        return latestDateTime;
-    }
-
-    /**
-     * Get the phase date/time for a repository.
-     *
-     * @param repository
-     * Repository.
-     *
-     * @param phaseDateTime
-     * Initial phase date/time.
-     *
-     * @returns
-     * Phase date/time or undefined if phase never before published.
-     */
-    protected abstract getPhaseDateTime(repository: Repository, phaseDateTime: Date): Date;
-
-    /**
-     * Determine if branch is valid for the phase.
-     *
-     * @returns
-     * True if branch is valid for the phase.
-     */
-    protected abstract isValidBranch(): boolean;
-
-    /**
-     * Run a command and optionally capture its output.
-     *
-     * @param ignoreDryRun
-     * If true, dry run setting is ignored.
-     *
-     * @param captureOutput
-     * If true, output is captured and returned.
-     *
-     * @param command
-     * Command to run.
-     *
-     * @param args
-     * Arguments to command.
-     *
-     * @returns
-     * Output if captured or empty array if not.
-     */
-    protected run(ignoreDryRun: boolean, captureOutput: boolean, command: string, ...args: string[]): string[] {
-        if (!ignoreDryRun && captureOutput) {
-            throw new Error("Cannot capture output in dry run");
-        }
-
-        let output: string[];
-
-        const runningCommand = `Running command "${command}" with arguments [${args.join(", ")}].`;
-
-        if (this.dryRun && !ignoreDryRun) {
-            logger.info(`Dry run: ${runningCommand}`);
-
-            output = [];
-        } else {
-            logger.debug(runningCommand);
-
-            const spawnResult = spawnSync(command, args, {
-                stdio: ["inherit", captureOutput ? "pipe" : "inherit", "inherit"]
-            });
-
-            if (spawnResult.error !== undefined) {
-                throw spawnResult.error;
-            }
-
-            if (spawnResult.status === null) {
-                throw new Error(`Terminated by signal ${spawnResult.signal}`);
-            }
-
-            if (spawnResult.status !== 0) {
-                throw new Error(`Failed with status ${spawnResult.status}`);
-            }
-
-            // Last line is also terminated by newline and split() places empty string at the end, so use slice() to remove it.
-            output = captureOutput ? spawnResult.stdout.toString().split("\n").slice(0, -1) : [];
-
-            if (captureOutput) {
-                logger.trace(`Output:\n${output.join("\n")}`);
-            }
-        }
-
-        return output;
-    }
-
-    /**
-     * Get the repository name for a dependency if it belongs to the organization or null if not.
-     *
-     * @param dependency
-     * Dependency.
-     *
-     * @returns
-     * Repository name for dependency or null.
-     */
-    protected dependencyRepositoryName(dependency: string): string | null {
-        const parsedDependency = dependency.split("/");
-
-        return parsedDependency.length === 2 && parsedDependency[0] === this.atOrganization ? parsedDependency[1] : null;
-    }
-
-    /**
-     * Determine if an organization dependency has been updated.
-     *
-     * @param phaseDateTime
-     * Phase date/time of the current repository.
-     *
-     * @param dependencyRepositoryName
-     * Dependency repository name.
-     *
-     * @param isAdditional
-     * True if this is an additional dependency.
-     *
-     * @returns
-     * True if organization dependency has been updated.
-     */
-    private isOrganizationDependencyUpdated(phaseDateTime: Date, dependencyRepositoryName: string, isAdditional: boolean): boolean {
-        const dependencyString = !isAdditional ? "Dependency" : "Additional dependency";
-
-        // If dependency repository state exists, so does dependency repository.
-        if (!(dependencyRepositoryName in this.repositoryStates)) {
-            throw new Error(`${dependencyString} repository ${dependencyRepositoryName} not yet published`);
-        }
-
-        const dependencyRepository = this.configuration.repositories[dependencyRepositoryName];
-        const dependencyPhaseState = dependencyRepository.phaseStates[this.phase];
-
-        if (dependencyPhaseState === undefined) {
-            throw new Error(`*** Internal error *** ${dependencyString} ${dependencyRepositoryName} does not have state for ${this.phase} phase`);
-        }
-
-        const isUpdated = phaseDateTime.getTime() < this.getPhaseDateTime(dependencyRepository, dependencyPhaseState.dateTime).getTime();
-
-        if (isUpdated) {
-            logger.trace(`Dependency repository ${dependencyRepositoryName} updated`);
-        }
-
-        return isUpdated;
-    }
-
-    /**
-     * Determine if there have been any changes to the current repository.
-     *
-     * @param phaseDateTime
-     * Phase date/time to check against or undefined if phase never before published.
-     *
-     * @param ignoreGitHub
-     * If true, ignore .github directory.
-     *
-     * @returns
-     * True if there have been any changes since the phase date/time.
-     */
-    protected anyChanges(phaseDateTime: Date | undefined, ignoreGitHub: boolean): boolean {
-        let anyChanges: boolean;
-
-        const excludePaths = this.repositoryState.repository.excludePaths ?? [];
-
-        const changedFilesSet = new Set<string>();
-
-        /**
-         * Process a changed file.
-         *
-         * @param status
-         * "R" if the file has been renamed, "D" if the file has been deleted, otherwise file has been added.
-         *
-         * @param file
-         * Original file name if status is "R", otherwise file to be added or deleted.
-         *
-         * @param newFile
-         * New file name if status is "R", undefined otherwise.
-         */
-        function processChangedFile(status: string, file: string, newFile: string | undefined): void {
-            // Status is "D" if deleted, "R" if renamed.
-            const deleteFile = status === "D" || status === "R" ? file : undefined;
-            const addFile = status === "R" ? newFile : status !== "D" ? file : undefined;
-
-            // Remove deleted file; anything that depends on a deleted file will have been modified.
-            if (deleteFile !== undefined && changedFilesSet.delete(deleteFile)) {
-                logger.debug(`-${deleteFile}`);
-            }
-
-            if (addFile !== undefined && !changedFilesSet.has(addFile)) {
-                // Exclude hidden files and directories except possibly .github directory, package-lock.json, test directory, and any explicitly excluded files or directories.
-                if (((!addFile.startsWith(".") && !addFile.includes("/.")) || (!ignoreGitHub && addFile.startsWith(".github/"))) && addFile !== PACKAGE_LOCK_CONFIGURATION_PATH && !addFile.startsWith("test/") && excludePaths.filter(excludePath => addFile === excludePath || (excludePath.endsWith("/") && addFile.startsWith(excludePath))).length === 0) {
-                    logger.debug(`+${addFile}`);
-
-                    changedFilesSet.add(addFile);
-                } else {
-                    // File is excluded.
-                    logger.debug(`*${addFile}`);
-                }
-            }
-        }
-
-        if (this.phase !== "alpha" && this.run(true, true, "git", "fetch", "--porcelain", "--dry-run").length !== 0) {
-            throw new Error("Remote repository has outstanding changes");
-        }
-
-        // Phase date/time is undefined if never before published.
-        if (phaseDateTime !== undefined) {
-            // Get all files committed since last published.
-            for (const line of this.run(true, true, "git", "log", "--since", phaseDateTime.toISOString(), "--name-status", "--pretty=oneline")) {
-                // Header starts with 40-character SHA.
-                if (/^[0-9a-f]{40} /.test(line)) {
-                    logger.debug(`Commit SHA ${line.substring(0, 40)}`);
-                } else {
-                    const [status, file, newFile] = line.split("\t");
-
-                    processChangedFile(status.charAt(0), file, newFile);
-                }
-            }
-
-            // Get all uncommitted files.
-            const output = this.run(true, true, "git", "status", "--porcelain");
-
-            if (output.length !== 0) {
-                const committedCount = changedFilesSet.size;
-
-                logger.debug("Uncommitted");
-
-                for (const line of output) {
-                    // Line is two-character status, space, and detail.
-                    const status = line.substring(0, 1);
-                    const [file, newFile] = line.substring(3).split(" -> ");
-
-                    processChangedFile(status, file, newFile);
-                }
-
-                // Beta or production publication requires that repository be fully committed except for excluded paths.
-                if (this.phase !== "alpha" && changedFilesSet.size !== committedCount) {
-                    throw new Error("Repository has uncommitted changes");
-                }
-            }
-
-            const lastPublishedDateTime = new Date(phaseDateTime);
-
-            anyChanges = false;
-
-            for (const changedFile of changedFilesSet) {
-                if (fs.lstatSync(changedFile).mtime > lastPublishedDateTime) {
-                    if (!anyChanges) {
-                        logger.info("Changes");
-
-                        anyChanges = true;
-                    }
-
-                    logger.info(`>${changedFile}`);
-                }
-            }
-
-            if (!anyChanges) {
-                logger.info("No changes");
-            }
-        } else {
-            logger.info("Never published");
-
-            // No last published, so there must have been changes.
-            anyChanges = true;
-        }
-
-        return anyChanges;
-    }
-
-    /**
-     * Commit files that have been modified.
-     *
-     * @param message
-     * Commit message.
-     *
-     * @param files
-     * Files to commit; if none, defaults to "--all".
-     */
-    protected commitModified(message: string, ...files: string[]): void {
-        const modifiedFiles: string[] = [];
-
-        if (files.length === 0) {
-            modifiedFiles.push("--all");
-        } else {
-            for (const line of this.run(true, true, "git", "status", ...files, "--porcelain")) {
-                const status = line.substring(0, 3);
-                const modifiedFile = line.substring(3);
-
-                // Only interest is in local additions and modifications with no conflicts.
-                if (status !== "A  " && status !== " M " && status !== "AM ") {
-                    throw new Error(`Unsupported status "${status}" for ${modifiedFile}`);
-                }
-
-                modifiedFiles.push(modifiedFile);
-            }
-        }
-
-        if (modifiedFiles.length !== 0) {
-            this.run(false, false, "git", "commit", ...modifiedFiles, "--message", message);
-        }
-    }
-
-    /**
-     * Save package configuration.
-     */
-    protected savePackageConfiguration(): void {
-        const packageConfiguration = this.repositoryState.packageConfiguration;
-        
-        if (this.dryRun) {
-            logger.info(`Dry run: Saving package configuration\n${JSON.stringify(pick(packageConfiguration, "name", "version", "devDependencies", "dependencies"), null, 2)}\n`);
-        } else {
-            fs.writeFileSync(PACKAGE_CONFIGURATION_PATH, `${JSON.stringify(packageConfiguration, null, 2)}\n`);
-        }
-    }
-
-    /**
-     * Update the package version.
-     *
-     * @param majorVersion
-     * Major version or undefined if no change.
-     *
-     * @param minorVersion
-     * Minor version or undefined if no change.
-     *
-     * @param patchVersion
-     * Patch version or undefined if no change.
-     *
-     * @param preReleaseIdentifier
-     * Pre-release identifier or undefined if no change.
-     */
-    protected updatePackageVersion(majorVersion: number | undefined, minorVersion: number | undefined, patchVersion: number | undefined, preReleaseIdentifier: string | null | undefined): void {
-        const repositoryState = this.repositoryState;
-
-        if (majorVersion !== undefined) {
-            repositoryState.majorVersion = majorVersion;
-        }
-
-        if (minorVersion !== undefined) {
-            repositoryState.minorVersion = minorVersion;
-        }
-
-        if (patchVersion !== undefined) {
-            repositoryState.patchVersion = patchVersion;
-        }
-
-        if (preReleaseIdentifier !== undefined) {
-            repositoryState.preReleaseIdentifier = preReleaseIdentifier;
-        }
-
-        repositoryState.packageConfiguration.version = `${repositoryState.majorVersion}.${repositoryState.minorVersion}.${repositoryState.patchVersion}${repositoryState.preReleaseIdentifier !== null ? `-${repositoryState.preReleaseIdentifier}` : ""}`;
-
-        this.savePackageConfiguration();
-    }
-
-    /**
-     * Update organization dependencies.
-     */
-    protected updateOrganizationDependencies(): void {
-        const repositoryState = this.repositoryState;
-
-        logger.debug(`Updating organization dependencies [${repositoryState.allDependencyPackageNames.join(", ")}]`);
-
-        this.run(false, false, "npm", "update", ...repositoryState.allDependencyPackageNames, ...this.repositoryState.npmPlatformArgs);
-    }
-
-    /**
-     * Commit changes resulting from updating the package version.
-     *
-     * @param files
-     * Files to commit; if none, defaults to "--all".
-     */
-    protected commitUpdatedPackageVersion(...files: string[]): void {
-        this.commitModified(`Updated to version ${this.repositoryState.packageConfiguration.version}.`, ...files);
-    }
-
-    /**
-     * Update the phase state. This will replace the phase state object in the repository and repository state and may
-     * update the phase date/time in the repository state.
-     *
-     * @param phaseState
-     * Partial phases state. Only those properties provided will be updated.
-     */
-    protected updatePhaseState(phaseState: Partial<PhaseState>): void {
-        const repositoryState = this.repositoryState;
-
-        const phaseStateDateTime = phaseState.dateTime !== undefined ?
-            {
-                // Git resolution is one second so round up to next second to ensure that comparisons work as expected.
-                dateTime: new Date(phaseState.dateTime.getTime() - phaseState.dateTime.getMilliseconds() + 1000)
-            } :
-            {};
-
-        const updatedPhaseState = {
-            ...this.repositoryState.phaseState,
-            ...phaseState,
-            ...phaseStateDateTime
-        };
-
-        repositoryState.repository.phaseStates[this.phase] = updatedPhaseState;
-        repositoryState.phaseState = updatedPhaseState;
-
-        // Setting the phase date/time overrides the logic of its initial determination.
-        if (phaseStateDateTime.dateTime !== undefined) {
-            repositoryState.phaseDateTime = phaseStateDateTime.dateTime;
-        }
-    }
-
-    /**
-     * Save the configuration.
-     */
-    private saveConfiguration(): void {
-        saveConfiguration(this.configuration, this.dryRun);
-    }
-
-    /**
-     * Publish current repository.
-     */
-    protected abstract publish(): void | Promise<void>;
-
-    /**
-     * Publish all repositories.
-     */
-    async publishAll(): Promise<void> {
-        const startDirectory = process.cwd();
-
-        for (const [repositoryName, repository] of Object.entries(this.configuration.repositories)) {
-            // All repositories are expected to be children of the parent of this repository.
-            const directory = `../${repository.directory ?? repositoryName}`;
-
-            if (fs.existsSync(directory) && fs.statSync(directory).isDirectory()) {
-                logger.info(`Repository ${repositoryName}...`);
-
-                process.chdir(directory);
-
-                let phaseState = repository.phaseStates[this.phase];
-
-                // Create phase state if necessary.
-                if (phaseState === undefined) {
-                    phaseState = {
-                        dateTime: new Date(0)
-                    };
-
-                    repository.phaseStates[this.phase] = phaseState;
-                }
-
-                try {
-                    const phaseDateTime = this.getPhaseDateTime(repository, phaseState.dateTime);
-
-                    const npmPlatformArgs = repository.platform !== undefined ?
-                        [
-                            "--cpu",
-                            repository.platform.cpu,
-                            "--os",
-                            repository.platform.os
-                        ] :
-                        [];
-
-                    const branch = this.run(true, true, "git", "branch", "--show-current")[0];
-
-                    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Package configuration format is known.
-                    const packageConfiguration = JSON.parse(fs.readFileSync(PACKAGE_CONFIGURATION_PATH).toString()) as PackageConfiguration;
-
-                    const version = packageConfiguration.version;
-
-                    const parsedVersion = /^(\d+)\.(\d+)\.(\d+)(-(alpha|beta))?$/.exec(version);
-
-                    if (parsedVersion === null) {
-                        throw new Error(`Invalid package version ${version}`);
-                    }
-
-                    const majorVersion = Number(parsedVersion[1]);
-                    const minorVersion = Number(parsedVersion[2]);
-                    const patchVersion = Number(parsedVersion[3]);
-                    const preReleaseIdentifier = parsedVersion.length === 6 ? parsedVersion[5] : null;
-
-                    const dependencyPackageNames: string[] = [];
-                    const allDependencyPackageNames: string[] = [];
-
-                    let anyDependenciesUpdated = false;
-
-                    for (const dependencies of [packageConfiguration.devDependencies ?? {}, packageConfiguration.dependencies ?? {}]) {
-                        for (const dependencyPackageName of Object.keys(dependencies)) {
-                            const dependencyRepositoryName = this.dependencyRepositoryName(dependencyPackageName);
-
-                            // Dependency repository name is null if dependency is not within the organization.
-                            if (dependencyRepositoryName !== null) {
-                                logger.trace(`Organization dependency ${dependencyPackageName} from package configuration`);
-
-                                // Check every dependency for logging purposes.
-                                if (this.isOrganizationDependencyUpdated(phaseDateTime, dependencyRepositoryName, false)) {
-                                    anyDependenciesUpdated = true;
-                                }
-
-                                for (const dependencyDependencyPackageName of this.repositoryStates[dependencyRepositoryName].allDependencyPackageNames) {
-                                    if (!allDependencyPackageNames.includes(dependencyDependencyPackageName)) {
-                                        logger.trace(`Organization dependency ${dependencyDependencyPackageName} from dependencies`);
-
-                                        allDependencyPackageNames.push(dependencyDependencyPackageName);
-                                    }
-                                }
-
-                                dependencyPackageNames.push(dependencyPackageName);
-
-                                // Current dependency package name goes in last to preserve hierarchy.
-                                allDependencyPackageNames.push(dependencyPackageName);
-
-                                // Dependency changes will ultimately be discarded if there are no changes and no updates to repository states.
-                                dependencies[dependencyPackageName] = this.dependencyVersionFor(dependencyRepositoryName, this.configuration.repositories[dependencyRepositoryName]);
-                            }
-                        }
-                    }
-
-                    if (repository.additionalDependencies !== undefined) {
-                        const additionalRepositoryNames: string[] = [];
-
-                        for (const additionalDependencyRepositoryName of repository.additionalDependencies) {
-                            const additionalDependencyPackageName = `${this.atOrganization}/${additionalDependencyRepositoryName}`;
-
-                            if (allDependencyPackageNames.includes(additionalDependencyPackageName) || additionalRepositoryNames.includes(additionalDependencyRepositoryName)) {
-                                logger.warn(`Additional dependency repository ${additionalDependencyRepositoryName} already a dependency`);
-                            } else {
-                                logger.trace(`Organization dependency ${additionalDependencyRepositoryName} from additional dependencies`);
-
-                                // Check every dependency for logging purposes.
-                                if (this.isOrganizationDependencyUpdated(phaseDateTime, additionalDependencyRepositoryName, true)) {
-                                    anyDependenciesUpdated = true;
-                                }
-
-                                additionalRepositoryNames.push(additionalDependencyRepositoryName);
-                            }
-                        }
-                    }
-
-                    this._repositoryState = {
-                        repositoryName,
-                        repository,
-                        phaseState,
-                        phaseDateTime,
-                        npmPlatformArgs,
-                        branch,
-                        packageConfiguration,
-                        majorVersion,
-                        minorVersion,
-                        patchVersion,
-                        preReleaseIdentifier,
-                        dependencyPackageNames,
-                        allDependencyPackageNames,
-                        anyDependenciesUpdated
-                    };
-
-                    // Save repository state for future repositories.
-                    this.repositoryStates[repositoryName] = this._repositoryState;
-
-                    if (!this.isValidBranch()) {
-                        throw new Error(`Branch ${branch} is not valid for ${this.phase} phase`);
-                    }
-
-                    const parsedBranch = /^v(\d+)\.(\d+)/.exec(branch);
-
-                    // If this is a version branch, update the package version if required.
-                    if (parsedBranch !== null) {
-                        const branchMajorVersion = Number(parsedBranch[1]);
-                        const branchMinorVersion = Number(parsedBranch[2]);
-
-                        // If in a version branch and version doesn't match, update it.
-                        if (majorVersion !== branchMajorVersion || minorVersion !== branchMinorVersion) {
-                            if (majorVersion !== branchMajorVersion ? majorVersion !== branchMajorVersion - 1 : minorVersion !== branchMinorVersion - 1) {
-                                throw new Error(`Invalid transition from ${majorVersion}.${minorVersion} to ${branchMajorVersion}.${branchMinorVersion}`);
-                            }
-
-                            this.updatePackageVersion(branchMajorVersion, branchMinorVersion, 0, null);
-                            this.commitUpdatedPackageVersion(PACKAGE_CONFIGURATION_PATH);
-                        }
-                    }
-
-                    // eslint-disable-next-line no-await-in-loop -- Next iteration requires previous to finish.
-                    await this.publish();
-                } finally {
-                    // Clear repository state to prevent accidental access.
-                    this._repositoryState = undefined;
-
-                    // Return to the start directory.
-                    process.chdir(startDirectory);
-
-                    this.saveConfiguration();
-                }
-            // Non-external repositories may be private and not accessible to all developers.
-            } else if (repository.dependencyType === "external") {
-                throw new Error(`Repository ${repositoryName} not found`);
-            }
-        }
-
-        this.finalizeAll();
-
-        this.saveConfiguration();
-
-        if (this.phase !== "alpha") {
-            this.commitModified(`Published ${this.phase} release.`, SHARED_CONFIGURATION_PATH);
-        }
-    }
-
-    /**
-     * Finalize publishing all repositories.
-     */
-    protected finalizeAll(): void {
-    }
-}