nx 23.3.0-beta.6 → 23.3.0-beta.8

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

@@ -1,18 +1,23 @@
-import { type MigrateRunState } from './run-state';
+import { type MigrateRunPolicy, type MigrateRunState } from './run-state';
 import { type StepAction } from './state-machine';
 import { type PlannedMigration } from '../migration-shape';
+import { type ExistingRunFacts } from './existing-run-report';
 export interface RunOrchestratorInitInput {
     root: string;
     migrationsJson: {
         migrations?: PlannedMigration[];
         [k: string]: unknown;
     };
+    migrationsPath?: string;
     createCommits: boolean;
     commitPrefix: string;
     skipInstall: boolean;
     installedNxVersion: string;
     validate: boolean | undefined;
     emitAgentInstructions?: boolean;
+    onExistingRun?: 'report' | 'start-fresh';
+    replaceRunId?: string;
+    confirmStart?: () => Promise<boolean>;
 }
 export type OrchestratorInitResult = {
     kind: 'ready';
@@ -22,13 +27,47 @@ export type OrchestratorInitResult = {
     reconcileCommand: string;
 } | {
     kind: 'refused';
+} | {
+    kind: 'existing-run';
+    runId: string;
+    facts: ExistingRunFacts;
 };
+export interface RunOrchestratorResumeInput {
+    root: string;
+    runId: string;
+    policy: MigrateRunPolicy;
+    emitAgentInstructions?: boolean;
+}
 export interface RunOrchestratorReconcileInput {
     root: string;
     runId: string;
     stepAction?: StepAction;
 }
 export declare function runOrchestratorInit(input: RunOrchestratorInitInput): Promise<OrchestratorInitResult>;
+/**
+ * Continues the active run `runId` names: the `--run-migrations --run-id`
+ * shape on both paths. Refuses as holdRunToContinue does.
+ */
+export declare function runOrchestratorResume(input: RunOrchestratorResumeInput): OrchestratorInitResult;
+/**
+ * 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.
+ */
+export declare function holdRunToContinue(root: string, runId: string): MigrateRunState;
+export declare function activeRunToReplace(root: string, runId: string | undefined): {
+    runId: string;
+    state: MigrateRunState;
+};
+/**
+ * Drops the hold holdRunToContinue took, for a wrapper that hands the
+ * continue to the workspace-local nx: the child takes its own hold, and an
+ * exclusive one refuses while this process still holds.
+ */
+export declare function releaseRunToHandOff(root: string, runId: string): void;
 export declare function runOrchestratorReconcile(input: RunOrchestratorReconcileInput): Promise<void>;
 /**
  * What a completed run leaves behind for whoever reads its summary, one line