@ohos-ports/nx 23.3.0-beta.3 → 24.0.2-beta.0

package/dist/src/command-line/migrate/run/orchestrator.d.ts

@@ -1,4 +1,4 @@
-import { type MigrateRunPolicy, type MigrateRunState } from './run-state';
+import { type MigrateCommitLedgerEntry, type MigrateRunPolicy, type MigrateRunState, type MigrateStep } from './run-state';
 import { type StepAction } from './state-machine';
 import { type PlannedMigration } from '../migration-shape';
 import { type ExistingRunFacts } from './existing-run-report';
@@ -19,6 +19,7 @@ export interface RunOrchestratorInitInput {
     onExistingRun?: 'report' | 'start-fresh';
     replaceRunId?: string;
     confirmStart?: () => Promise<boolean>;
+    singleMigration?: boolean;
 }
 export type OrchestratorInitResult = {
     kind: 'ready';
@@ -54,9 +55,9 @@ export declare function runOrchestratorResume(input: RunOrchestratorResumeInput)
  * Holds the active run `runId` names and returns its state. A continue calls
  * this before the install and the agent selection: a concurrent start-fresh
  * must not delete the run meanwhile. Throws when the id names no run or a
- * finished one, and while another process holds the run: continuing would
- * open a second session over a live one. Under WASM nothing is held and no
- * holder refuses.
+ * finished one, and while another process holds the run or works on a
+ * different run: continuing would open a second session over a live one.
+ * Under WASM nothing is held and no holder refuses.
  */
 export declare function holdRunToContinue(root: string, runId: string): MigrateRunState;
 export declare function activeRunToReplace(root: string, runId: string | undefined): {
@@ -69,7 +70,63 @@ export declare function activeRunToReplace(root: string, runId: string | undefin
  * exclusive one refuses while this process still holds.
  */
 export declare function releaseRunToHandOff(root: string, runId: string): void;
+/**
+ * The active run a classic `--run-migrations` must not run over, held while
+ * the caller reports it or asks what to do; null when no run is active. Run
+ * directories that cannot be read refuse as they do for init.
+ */
+export declare function activeRunForClassic(root: string, plannedIds: readonly string[]): {
+    runId: string;
+    facts: ExistingRunFacts;
+} | null;
+/**
+ * Throws when a classic start fresh could not delete the active run `runId`.
+ * Run before the commit prompt, as init does, so the user is not asked for a
+ * run that is then refused; deleteRunForStartFresh repeats the checks.
+ */
+export declare function checkRunForStartFresh(root: string, runId: string): void;
+/**
+ * Deletes the record of the active run `runId` for a classic start fresh,
+ * under the refusals init applies before it replaces a run. The classic loop
+ * records no run of its own afterwards.
+ */
+export declare function deleteRunForStartFresh(root: string, runId: string): void;
+/**
+ * Throws while another process works on a run that init wouldn't report: a
+ * `--run-migration` run, a run being started, or a run nx can't read. A new
+ * run would install and commit over its in-progress edits. An active
+ * `--run-migrations` run is reported instead, except to a `--run-migration`
+ * run, and records no process holds block nothing.
+ */
+export declare function refuseNewRunAlongsideLiveRun(root: string, singleMigration?: boolean): void;
+/**
+ * The refusals of prepareSingleMigrationRun alone, for the CLI to make before
+ * its install. Removes and warns about nothing.
+ */
+export declare function checkRunsForSingleMigration(root: string): void;
+/**
+ * The check every `--run-migration` run without a run id makes before it runs
+ * anything. Throws while another nx migrate process works on a run, removes
+ * `--run-migration` records no process holds, and warns about idle active
+ * runs, which do not record this migration.
+ */
+export declare function prepareSingleMigrationRun(root: string): void;
+/**
+ * Removes a `--run-migration` run's record. Call under the creation lock. Kept
+ * while another process still works on the run, such as a worker the agent
+ * left running: other runs refuse alongside it, and the next
+ * `--run-migration` removes it once none does. Otherwise best effort: what is
+ * left blocks nothing.
+ */
+export declare function removeSingleMigrationRun(root: string, runId: string): void;
 export declare function runOrchestratorReconcile(input: RunOrchestratorReconcileInput): Promise<void>;
+/**
+ * Dispenses a `--run-migration` run's step without a response: the parent
+ * runs the step's first attempt itself, and an agent it starts afterwards
+ * gets the step from the "next" command.
+ */
+export declare function dispenseSingleMigrationStep(root: string, runId: string): void;
+export declare function lastCoveringLandedEntry(state: MigrateRunState, step: MigrateStep): MigrateCommitLedgerEntry | null;
 /**
  * What a completed run leaves behind for whoever reads its summary, one line
  * group per warning: commit debt, uninstalled dependency changes, unresolved