sb-mig 6.3.0 → 6.4.0

package/dist/api/data-migration/component-data-migration.d.ts

@@ -1,7 +1,9 @@
 import type { PublishLanguagesOption } from "../stories/stories.types.js";
 import type { RequestBaseConfig } from "../utils/request.js";
+import { type LanguagePublishStateMap } from "../stories/language-publish-state.js";
 import { type MigrationComponentAliasesByMigration, type MigrationComponentOverridesByMigration } from "./migration-component-scope.js";
 import { type PreparedMigrationValidator } from "./migration-validation.js";
+import { type PublishedLayerContext } from "./published-layer.js";
 export type MigrateFrom = "file" | "space";
 export type PublicationMode = "preserve-layers" | "collapse-draft" | "save-only";
 export interface PreparedMigrationConfig {
@@ -73,6 +75,60 @@ export declare const runMigrationPipelineInMemory: ({ itemType, itemsToMigrate,
     preparedMigrationConfigs: PreparedMigrationConfig[];
 }) => MigrationPipelineResult;
 export declare const migrateAllComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, filters, dryRun, publicationMode, publicationLanguages, fromFilePath, fileName, languagePublishStatePath, migrationComponentAliases, migrationComponentOverrides, }: Omit<MigrateItems, "componentsToMigrate" | "preparedMigrationConfigs">, config: RequestBaseConfig) => Promise<void>;
+export interface ContinueManifest {
+    manifestVersion: 1;
+    createdAt?: string;
+    kind: "migrate-content-continue-manifest";
+    itemType: "story" | "preset";
+    from: string;
+    to: string;
+    migrateFrom: MigrateFrom;
+    fromFilePath?: string | null;
+    publicationMode: PublicationMode;
+    migrationConfigNames: string[];
+    publishLanguages?: {
+        requested?: PublishLanguagesOption;
+    } | null;
+    resolvedPublishLanguages?: string[] | null;
+    artifactBaseName: string;
+    useDatestamp: boolean;
+    artifacts: {
+        changedItems: string;
+        pipelineSummary: string;
+        inputFull?: string | null;
+        languageStateMap?: string | null;
+        draftAfterFull?: string | null;
+        publishedAfterFull?: string | null;
+        dirtyPublishedRecords?: string | null;
+    };
+}
+interface FinalizeMigrationArgs {
+    itemType: "story" | "preset";
+    from: string;
+    to: string;
+    migrateFrom: MigrateFrom;
+    fromFilePath?: string;
+    languagePublishStatePath?: string;
+    publicationMode: PublicationMode;
+    effectivePublicationLanguages?: PublishLanguagesOption;
+    resolvedPublishLanguages?: string[];
+    languagePublishStateMap?: LanguagePublishStateMap;
+    appliedMigrationNames: string[];
+    pipelineResult: MigrationPipelineResult;
+    publishedLayerContext?: PublishedLayerContext;
+    publishedLayerPipelineResult: MigrationPipelineResult | null;
+    artifactBaseName: string;
+    useDatestamp: boolean;
+    continuedFromManifest?: string;
+}
+/**
+ * Everything `doTheMigration` does AFTER the dry-run preview returns:
+ * mark migrations as applied, write the changes to Storyblok, and write the
+ * run log. Extracted so `migrate continue` can run the exact same path against
+ * inputs reconstructed from dry-run artifacts (instead of re-pulling + re-transforming).
+ */
+export declare const finalizeMigration: ({ itemType, from, to, migrateFrom, fromFilePath, languagePublishStatePath, publicationMode, effectivePublicationLanguages, resolvedPublishLanguages, languagePublishStateMap, appliedMigrationNames, pipelineResult, publishedLayerContext, publishedLayerPipelineResult, artifactBaseName, useDatestamp, continuedFromManifest, }: FinalizeMigrationArgs, config: RequestBaseConfig) => Promise<void>;
+export declare const findArtifactFilename: (files: string[], stem: string) => string | null;
 export declare const doTheMigration: ({ itemType, from, itemsToMigrate, migrationConfig, migrationConfigs, to, dryRun, publicationMode, publicationLanguages, migrateFrom, fromFilePath, fileName, languagePublishStatePath, }: {
     itemType?: "story" | "preset";
     from: string;
@@ -89,4 +145,29 @@ export declare const doTheMigration: ({ itemType, from, itemsToMigrate, migratio
     languagePublishStatePath?: string;
 }, config: RequestBaseConfig) => Promise<void>;
 export declare const migrateProvidedComponentsDataInStories: ({ itemType, migrationConfig, migrateFrom, from, to, componentsToMigrate, filters, dryRun, publicationMode, publicationLanguages, fromFilePath, fileName, languagePublishStatePath, preparedMigrationConfigs, migrationComponentAliases, migrationComponentOverrides, }: MigrateItems, config: RequestBaseConfig) => Promise<void>;
+export interface ContinuePlanSummary {
+    manifestFileName: string;
+    from: string;
+    to: string;
+    itemType: "story" | "preset";
+    publicationMode: PublicationMode;
+    migrationConfigNames: string[];
+    resolvedPublishLanguages: string[];
+    changedCount: number;
+    dirtyPublishedCount: number;
+    artifactFiles: string[];
+}
+export interface ContinuePlan {
+    summary: ContinuePlanSummary;
+    run: () => Promise<void>;
+}
+/**
+ * Discover the dry-run `continue` manifest in the migrations folder, load the
+ * artifacts it points at, and reconstruct the exact inputs `finalizeMigration`
+ * needs. Returns a summary (for the confirmation prompt) and a `run()` thunk that
+ * performs the write. Does NOT pull stories, transform, or fetch published layers.
+ */
+export declare const prepareContinueMigration: ({ manifestFileName }: {
+    manifestFileName?: string;
+}, config: RequestBaseConfig) => Promise<ContinuePlan>;
 export {};

package/dist/api/data-migration/component-data-migration.js

@@ -2,7 +2,7 @@ import path from "path";
 import chalk from "chalk";
 import { discoverMigrationConfig, discoverStories, LOOKUP_TYPE, SCOPE, } from "../../cli/utils/discover.js";
 import storyblokConfig from "../../config/config.js";
-import { createAndSaveToFile, getFileContentWithRequire, getFilesContentWithRequire, } from "../../utils/files.js";
+import { createAndSaveToFile, getFileContentWithRequire, getFilesContentWithRequire, listFilesInDir, readFile, } from "../../utils/files.js";
 import Logger from "../../utils/logger.js";
 import { modifyOrCreateAppliedMigrationsFile } from "../../utils/migrations.js";
 import { isObjectEmpty } from "../../utils/object-utils.js";
@@ -810,6 +810,222 @@ export const migrateAllComponentsDataInStories = async ({ itemType, migrationCon
         preparedMigrationConfigs,
     }, config);
 };
+/**
+ * Everything `doTheMigration` does AFTER the dry-run preview returns:
+ * mark migrations as applied, write the changes to Storyblok, and write the
+ * run log. Extracted so `migrate continue` can run the exact same path against
+ * inputs reconstructed from dry-run artifacts (instead of re-pulling + re-transforming).
+ */
+export const finalizeMigration = async ({ itemType, from, to, migrateFrom, fromFilePath, languagePublishStatePath, publicationMode, effectivePublicationLanguages, resolvedPublishLanguages, languagePublishStateMap, appliedMigrationNames, pipelineResult, publishedLayerContext, publishedLayerPipelineResult, artifactBaseName, useDatestamp, continuedFromManifest, }, config) => {
+    for (const migrationConfigName of appliedMigrationNames) {
+        await modifyOrCreateAppliedMigrationsFile(migrationConfigName, itemType);
+    }
+    const publishedLayerChangedCount = publishedLayerPipelineResult?.changedItems.length ?? 0;
+    if (pipelineResult.changedItems.length === 0 &&
+        publishedLayerChangedCount === 0) {
+        return;
+    }
+    let writeResults = [];
+    if (itemType === "story") {
+        if (shouldUsePublishedLayerMode(publicationMode) &&
+            publishedLayerContext) {
+            const dirtyStoryIds = new Set(publishedLayerContext.dirtyPublishedRecords.map((record) => String(record.storyId)));
+            const nonDirtyChangedItems = pipelineResult.changedItems.filter((item) => !dirtyStoryIds.has(storyIdOf(item)));
+            const nonDirtyWriteResults = nonDirtyChangedItems.length > 0
+                ? await managementApi.stories.updateStories({
+                    stories: nonDirtyChangedItems,
+                    spaceId: to,
+                    options: {
+                        publish: shouldPublishForPublicationMode(publicationMode),
+                        publishLanguages: resolvedPublishLanguages,
+                        preservePublishState: shouldPublishForPublicationMode(publicationMode),
+                        languagePublishStateMap,
+                    },
+                }, config)
+                : [];
+            const dirtyWriteResults = publishedLayerPipelineResult
+                ? await writeDirtyPublishedLayerStories({
+                    context: publishedLayerContext,
+                    draftPipelineResult: pipelineResult,
+                    publishedPipelineResult: publishedLayerPipelineResult,
+                    to,
+                    resolvedPublishLanguages,
+                    languagePublishStateMap,
+                }, config)
+                : [];
+            writeResults = [...nonDirtyWriteResults, ...dirtyWriteResults];
+        }
+        else {
+            writeResults = await managementApi.stories.updateStories({
+                stories: pipelineResult.changedItems,
+                spaceId: to,
+                options: {
+                    publish: shouldPublishForPublicationMode(publicationMode),
+                    publishLanguages: resolvedPublishLanguages,
+                    preservePublishState: shouldPublishForPublicationMode(publicationMode),
+                    publishDirtyPublishedStories: shouldPublishDirtyDrafts(publicationMode),
+                    languagePublishStateMap,
+                },
+            }, config);
+        }
+    }
+    else if (itemType === "preset") {
+        writeResults = await managementApi.presets.updatePresets({
+            presets: pipelineResult.changedItems,
+            spaceId: to,
+            options: {},
+        }, config);
+    }
+    const writeSummary = summarizeMutationWriteResults(writeResults);
+    try {
+        await saveMigrationRunLog({
+            artifactBaseName,
+            useDatestamp,
+            from,
+            to,
+            itemType,
+            dryRun: false,
+            publish: shouldPublishForPublicationMode(publicationMode),
+            publishLanguages: effectivePublicationLanguages,
+            resolvedPublishLanguages,
+            migrateFrom,
+            fromFilePath,
+            languagePublishStatePath,
+            pipelineResult,
+            writeResults,
+            writeSummary,
+            continuedFromManifest,
+        }, config);
+    }
+    catch (error) {
+        Logger.warning(`[MIGRATION] Could not write migration run log: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (writeSummary.failed === 0) {
+        Logger.success(`[MIGRATION] Update complete. ${writeSummary.successful}/${writeSummary.total} ${itemType}(s) updated successfully.`);
+        return;
+    }
+    Logger.warning(`[MIGRATION] Update complete with partial failures. ${writeSummary.successful}/${writeSummary.total} ${itemType}(s) updated successfully, ${writeSummary.failed} failed.`);
+    writeSummary.failedItems.slice(0, 10).forEach((item) => {
+        const label = item.slug || item.name || item.id || "unknown";
+        Logger.error(`[MIGRATION] Failed ${itemType}: ${String(label)}`);
+    });
+    if (writeSummary.failedItems.length > 10) {
+        Logger.warning(`[MIGRATION] Showing first 10 failed ${itemType}(s) only.`);
+    }
+};
+/**
+ * Sortable key for an artifact's datestamp suffix.
+ *
+ * Datestamps use the non-zero-padded `YYYY-M-D_H-M` format from
+ * generateDatestamp, so a plain string sort is NOT chronological
+ * (e.g. "2026-1-15_9-30" sorts before "2026-1-9_9-30"). Parse the parts and
+ * compare numerically instead. Returns -1 for the non-datestamped variant
+ * (`${stem}.json`), which only exists when --fileName is used (single match,
+ * never mixed with datestamped files for the same stem).
+ */
+const artifactDatestampKey = (filename, stem) => {
+    const prefix = `${stem}__`;
+    if (!filename.startsWith(prefix) || !filename.endsWith(".json")) {
+        return -1;
+    }
+    const stamp = filename.slice(prefix.length, -".json".length);
+    const match = /^(\d+)-(\d+)-(\d+)_(\d+)-(\d+)$/.exec(stamp);
+    if (!match) {
+        return -1;
+    }
+    const [, year, month, day, hour, minute] = match;
+    // month/day/hour/minute each fit in two decimal digits, so this packs the
+    // parts into one monotonically increasing key.
+    return (Number(year) * 100_000_000 +
+        Number(month) * 1_000_000 +
+        Number(day) * 10_000 +
+        Number(hour) * 100 +
+        Number(minute));
+};
+export const findArtifactFilename = (files, stem) => {
+    const matches = files.filter((file) => file === `${stem}.json` || file.startsWith(`${stem}__`));
+    if (matches.length === 0) {
+        return null;
+    }
+    // Pick the chronologically newest match. Do not lexicographically sort:
+    // the datestamp format is not zero-padded, so string order is not time order.
+    return matches.reduce((newest, candidate) => artifactDatestampKey(candidate, stem) >=
+        artifactDatestampKey(newest, stem)
+        ? candidate
+        : newest);
+};
+/**
+ * Written at the end of a dry-run only. A small machine file that lets
+ * `migrate continue` finish the migration without re-pulling/re-transforming:
+ * carries the scalars that aren't otherwise saved (target space, exact migration
+ * names, run-log metadata) and references the heavy dry-run artifacts by filename.
+ */
+const saveContinueManifest = async ({ artifactBaseName, useDatestamp, dryRun, itemType, from, to, migrateFrom, fromFilePath, publicationMode, effectivePublicationLanguages, resolvedPublishLanguages, appliedMigrationNames, publishedLayerContext, publishedLayerPipelineResult, }, config) => {
+    if (!dryRun) {
+        return;
+    }
+    const isPreserveLayers = shouldUsePublishedLayerMode(publicationMode) &&
+        Boolean(publishedLayerContext);
+    if (isPreserveLayers && publishedLayerContext) {
+        const publishedChangedIds = (publishedLayerPipelineResult?.changedItems ?? []).map((item) => storyIdOf(item));
+        await createAndSaveToFile({
+            datestamp: useDatestamp,
+            ext: "json",
+            filename: `dry-run--${artifactBaseName}---dirty-published-records`,
+            folder: "migrations",
+            res: {
+                dirtyPublishedRecords: publishedLayerContext.dirtyPublishedRecords,
+                publishedChangedIds,
+            },
+        }, config);
+    }
+    // Resolve the real sibling filenames from disk. The datestamp suffix has
+    // minute granularity, so sibling artifacts can in rare cases differ; reading
+    // the folder avoids guessing the exact name.
+    const files = await listFilesInDir(`${config.sbmigWorkingDirectory}/migrations`);
+    const resolve = (stem) => findArtifactFilename(files, `dry-run--${artifactBaseName}---${stem}`);
+    const artifacts = {
+        changedItems: resolve(`${itemType}-to-migrate`) ?? "",
+        pipelineSummary: resolve(`${itemType}-migration-pipeline-summary`) ?? "",
+        inputFull: resolve(`${itemType}-input-full`),
+        languageStateMap: resolve("language-publish-state-map"),
+        draftAfterFull: isPreserveLayers
+            ? resolve("draft-current-after-full")
+            : null,
+        publishedAfterFull: isPreserveLayers
+            ? resolve("published-layer-after-full")
+            : null,
+        dirtyPublishedRecords: isPreserveLayers
+            ? resolve("dirty-published-records")
+            : null,
+    };
+    const manifest = {
+        manifestVersion: 1,
+        createdAt: new Date().toISOString(),
+        kind: "migrate-content-continue-manifest",
+        itemType,
+        from,
+        to,
+        migrateFrom,
+        fromFilePath: fromFilePath ?? null,
+        publicationMode,
+        migrationConfigNames: appliedMigrationNames,
+        publishLanguages: publicationMode === "save-only"
+            ? null
+            : { requested: effectivePublicationLanguages },
+        resolvedPublishLanguages: resolvedPublishLanguages ?? null,
+        artifactBaseName,
+        useDatestamp,
+        artifacts,
+    };
+    await createAndSaveToFile({
+        datestamp: useDatestamp,
+        ext: "json",
+        filename: `dry-run--${artifactBaseName}---${itemType}-continue-manifest`,
+        folder: "migrations",
+        res: manifest,
+    }, config);
+};
 export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate, migrationConfig, migrationConfigs, to, dryRun, publicationMode = DEFAULT_PUBLICATION_MODE, publicationLanguages, migrateFrom, fromFilePath, fileName, languagePublishStatePath, }, config) => {
     const preparedMigrationConfigs = migrationConfigs ||
         prepareMigrationConfigs({
@@ -952,6 +1168,23 @@ export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate,
         languagePublishStatePath,
         pipelineResult,
     }, config);
+    await saveContinueManifest({
+        artifactBaseName,
+        useDatestamp,
+        dryRun,
+        itemType,
+        from,
+        to,
+        migrateFrom,
+        fromFilePath,
+        publicationMode,
+        effectivePublicationLanguages,
+        resolvedPublishLanguages,
+        appliedMigrationNames: preparedMigrationConfigs.map((preparedMigrationConfig) => preparedMigrationConfig.migrationConfigName),
+        pipelineResult,
+        publishedLayerContext,
+        publishedLayerPipelineResult,
+    }, config);
     if (dryRun) {
         console.log(" ");
         if (publishedLayerPipelineResult) {
@@ -961,100 +1194,24 @@ export const doTheMigration = async ({ itemType = "story", from, itemsToMigrate,
         Logger.success(`[DRY RUN] No API changes were made. Review the saved migration file for details.`);
         return;
     }
-    for (const preparedMigrationConfig of preparedMigrationConfigs) {
-        await modifyOrCreateAppliedMigrationsFile(preparedMigrationConfig.migrationConfigName, itemType);
-    }
-    const publishedLayerChangedCount = publishedLayerPipelineResult?.changedItems.length ?? 0;
-    if (pipelineResult.changedItems.length === 0 &&
-        publishedLayerChangedCount === 0) {
-        return;
-    }
-    let writeResults = [];
-    if (itemType === "story") {
-        if (shouldUsePublishedLayerMode(publicationMode) &&
-            publishedLayerContext) {
-            const dirtyStoryIds = new Set(publishedLayerContext.dirtyPublishedRecords.map((record) => String(record.storyId)));
-            const nonDirtyChangedItems = pipelineResult.changedItems.filter((item) => !dirtyStoryIds.has(storyIdOf(item)));
-            const nonDirtyWriteResults = nonDirtyChangedItems.length > 0
-                ? await managementApi.stories.updateStories({
-                    stories: nonDirtyChangedItems,
-                    spaceId: to,
-                    options: {
-                        publish: shouldPublishForPublicationMode(publicationMode),
-                        publishLanguages: resolvedPublishLanguages,
-                        preservePublishState: shouldPublishForPublicationMode(publicationMode),
-                        languagePublishStateMap,
-                    },
-                }, config)
-                : [];
-            const dirtyWriteResults = publishedLayerPipelineResult
-                ? await writeDirtyPublishedLayerStories({
-                    context: publishedLayerContext,
-                    draftPipelineResult: pipelineResult,
-                    publishedPipelineResult: publishedLayerPipelineResult,
-                    to,
-                    resolvedPublishLanguages,
-                    languagePublishStateMap,
-                }, config)
-                : [];
-            writeResults = [...nonDirtyWriteResults, ...dirtyWriteResults];
-        }
-        else {
-            writeResults = await managementApi.stories.updateStories({
-                stories: pipelineResult.changedItems,
-                spaceId: to,
-                options: {
-                    publish: shouldPublishForPublicationMode(publicationMode),
-                    publishLanguages: resolvedPublishLanguages,
-                    preservePublishState: shouldPublishForPublicationMode(publicationMode),
-                    publishDirtyPublishedStories: shouldPublishDirtyDrafts(publicationMode),
-                    languagePublishStateMap,
-                },
-            }, config);
-        }
-    }
-    else if (itemType === "preset") {
-        writeResults = await managementApi.presets.updatePresets({
-            presets: pipelineResult.changedItems,
-            spaceId: to,
-            options: {},
-        }, config);
-    }
-    const writeSummary = summarizeMutationWriteResults(writeResults);
-    try {
-        await saveMigrationRunLog({
-            artifactBaseName,
-            useDatestamp,
-            from,
-            to,
-            itemType,
-            dryRun,
-            publish: shouldPublishForPublicationMode(publicationMode),
-            publishLanguages: effectivePublicationLanguages,
-            resolvedPublishLanguages,
-            migrateFrom,
-            fromFilePath,
-            languagePublishStatePath,
-            pipelineResult,
-            writeResults,
-            writeSummary,
-        }, config);
-    }
-    catch (error) {
-        Logger.warning(`[MIGRATION] Could not write migration run log: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    if (writeSummary.failed === 0) {
-        Logger.success(`[MIGRATION] Update complete. ${writeSummary.successful}/${writeSummary.total} ${itemType}(s) updated successfully.`);
-        return;
-    }
-    Logger.warning(`[MIGRATION] Update complete with partial failures. ${writeSummary.successful}/${writeSummary.total} ${itemType}(s) updated successfully, ${writeSummary.failed} failed.`);
-    writeSummary.failedItems.slice(0, 10).forEach((item) => {
-        const label = item.slug || item.name || item.id || "unknown";
-        Logger.error(`[MIGRATION] Failed ${itemType}: ${String(label)}`);
-    });
-    if (writeSummary.failedItems.length > 10) {
-        Logger.warning(`[MIGRATION] Showing first 10 failed ${itemType}(s) only.`);
-    }
+    await finalizeMigration({
+        itemType,
+        from,
+        to,
+        migrateFrom,
+        fromFilePath,
+        languagePublishStatePath,
+        publicationMode,
+        effectivePublicationLanguages,
+        resolvedPublishLanguages,
+        languagePublishStateMap,
+        appliedMigrationNames: preparedMigrationConfigs.map((preparedMigrationConfig) => preparedMigrationConfig.migrationConfigName),
+        pipelineResult,
+        publishedLayerContext,
+        publishedLayerPipelineResult,
+        artifactBaseName,
+        useDatestamp,
+    }, config);
 };
 const saveBackupToFile = async ({ itemType, res, folder, filename }, config) => {
     await createAndSaveToFile({
@@ -1109,3 +1266,142 @@ export const migrateProvidedComponentsDataInStories = async ({ itemType, migrati
         languagePublishStatePath,
     }, config);
 };
+const CONTINUE_MANIFEST_RE = /---(?:story|preset)-continue-manifest(?:__.*)?\.json$/;
+const readMigrationJson = async (config, filename) => {
+    const content = await readFile(`${config.sbmigWorkingDirectory}/migrations/${filename}`);
+    if (content === undefined) {
+        throw new Error(`Could not read migration artifact: migrations/${filename}`);
+    }
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        throw new Error(`Migration artifact is not valid JSON: migrations/${filename}`);
+    }
+};
+/**
+ * Discover the dry-run `continue` manifest in the migrations folder, load the
+ * artifacts it points at, and reconstruct the exact inputs `finalizeMigration`
+ * needs. Returns a summary (for the confirmation prompt) and a `run()` thunk that
+ * performs the write. Does NOT pull stories, transform, or fetch published layers.
+ */
+export const prepareContinueMigration = async ({ manifestFileName }, config) => {
+    const files = await listFilesInDir(`${config.sbmigWorkingDirectory}/migrations`);
+    const manifestFiles = files.filter((file) => CONTINUE_MANIFEST_RE.test(file));
+    let chosen;
+    if (manifestFileName) {
+        if (!files.includes(manifestFileName)) {
+            throw new Error(`Manifest not found in migrations folder: ${manifestFileName}`);
+        }
+        chosen = manifestFileName;
+    }
+    else if (manifestFiles.length === 1) {
+        chosen = manifestFiles[0];
+    }
+    else if (manifestFiles.length === 0) {
+        throw new Error("No dry-run found to continue. Run `sb-mig migrate content … --dryRun` first.");
+    }
+    else {
+        throw new Error(`Multiple dry-run manifests found. Re-run with --manifest <filename>:\n${manifestFiles
+            .map((file) => `  - ${file}`)
+            .join("\n")}`);
+    }
+    const manifest = (await readMigrationJson(config, chosen));
+    if (manifest.kind !== "migrate-content-continue-manifest") {
+        throw new Error(`Not a continue manifest: ${chosen}`);
+    }
+    if (manifest.manifestVersion !== 1) {
+        throw new Error(`Unsupported continue manifest version (${manifest.manifestVersion}) in ${chosen}.`);
+    }
+    const { artifacts } = manifest;
+    if (!artifacts?.changedItems) {
+        throw new Error(`Manifest ${chosen} is missing the changed-items artifact reference.`);
+    }
+    const changedItems = (await readMigrationJson(config, artifacts.changedItems));
+    const pipelineSummary = artifacts.pipelineSummary
+        ? await readMigrationJson(config, artifacts.pipelineSummary)
+        : null;
+    const languagePublishStateMap = artifacts.languageStateMap
+        ? (await readMigrationJson(config, artifacts.languageStateMap))
+        : undefined;
+    const isPreserveLayers = shouldUsePublishedLayerMode(manifest.publicationMode) &&
+        Boolean(artifacts.dirtyPublishedRecords);
+    let publishedLayerContext;
+    let publishedLayerPipelineResult = null;
+    if (isPreserveLayers && artifacts.dirtyPublishedRecords) {
+        const dirty = (await readMigrationJson(config, artifacts.dirtyPublishedRecords));
+        publishedLayerContext = {
+            records: [],
+            publishedLayerInputItems: [],
+            dirtyPublishedRecords: dirty.dirtyPublishedRecords ?? [],
+            missingPublishedLayerRecords: [],
+        };
+        const publishedFinalItems = artifacts.publishedAfterFull
+            ? (await readMigrationJson(config, artifacts.publishedAfterFull))
+            : [];
+        const publishedChangedIdSet = new Set((dirty.publishedChangedIds ?? []).map(String));
+        publishedLayerPipelineResult = {
+            changedItems: publishedFinalItems.filter((item) => publishedChangedIdSet.has(storyIdOf(item))),
+            finalItems: publishedFinalItems,
+            stepReports: [],
+            totalItems: publishedFinalItems.length,
+        };
+    }
+    const draftFinalItems = artifacts.draftAfterFull
+        ? (await readMigrationJson(config, artifacts.draftAfterFull))
+        : changedItems;
+    const pipelineResult = {
+        changedItems,
+        finalItems: draftFinalItems,
+        stepReports: Array.isArray(pipelineSummary?.steps)
+            ? pipelineSummary.steps
+            : [],
+        totalItems: typeof pipelineSummary?.totalItems === "number"
+            ? pipelineSummary.totalItems
+            : changedItems.length,
+    };
+    const resolvedPublishLanguages = manifest.resolvedPublishLanguages ?? undefined;
+    const effectivePublicationLanguages = manifest.publishLanguages?.requested;
+    const artifactFiles = [
+        artifacts.changedItems,
+        artifacts.pipelineSummary,
+        artifacts.draftAfterFull,
+        artifacts.publishedAfterFull,
+        artifacts.dirtyPublishedRecords,
+        artifacts.languageStateMap,
+        artifacts.inputFull,
+    ].filter((file) => Boolean(file));
+    const summary = {
+        manifestFileName: chosen,
+        from: manifest.from,
+        to: manifest.to,
+        itemType: manifest.itemType,
+        publicationMode: manifest.publicationMode,
+        migrationConfigNames: manifest.migrationConfigNames ?? [],
+        resolvedPublishLanguages: resolvedPublishLanguages ?? [],
+        changedCount: changedItems.length,
+        dirtyPublishedCount: publishedLayerContext?.dirtyPublishedRecords.length ?? 0,
+        artifactFiles,
+    };
+    const run = async () => {
+        await finalizeMigration({
+            itemType: manifest.itemType,
+            from: manifest.from,
+            to: manifest.to,
+            migrateFrom: manifest.migrateFrom,
+            fromFilePath: manifest.fromFilePath ?? undefined,
+            publicationMode: manifest.publicationMode,
+            effectivePublicationLanguages,
+            resolvedPublishLanguages,
+            languagePublishStateMap,
+            appliedMigrationNames: manifest.migrationConfigNames ?? [],
+            pipelineResult,
+            publishedLayerContext,
+            publishedLayerPipelineResult,
+            artifactBaseName: manifest.artifactBaseName,
+            useDatestamp: manifest.useDatestamp,
+            continuedFromManifest: chosen,
+        }, config);
+    };
+    return { summary, run };
+};

package/dist/api/data-migration/migration-run-log.d.ts

@@ -23,6 +23,7 @@ export interface MigrationRunLogRecord {
         resolved?: string[];
     };
     dryRun: boolean;
+    continuedFromManifest?: string;
     migrationConfigs: string[];
     totalItems: number;
     totalChangedItems: number;
@@ -76,8 +77,9 @@ interface SaveMigrationRunLogArgs {
     pipelineResult: MigrationPipelineResult;
     writeResults: PromiseSettledResult<MutationWriteResult>[];
     writeSummary: MutationWriteSummary;
+    continuedFromManifest?: string;
 }
-export declare const buildMigrationRunLogRecords: ({ from, to, itemType, dryRun, publish, publishLanguages, resolvedPublishLanguages, migrateFrom, fromFilePath, languagePublishStatePath, pipelineResult, writeResults, writeSummary, }: Omit<SaveMigrationRunLogArgs, "artifactBaseName" | "useDatestamp">) => MigrationRunLogRecord[];
+export declare const buildMigrationRunLogRecords: ({ from, to, itemType, dryRun, publish, publishLanguages, resolvedPublishLanguages, migrateFrom, fromFilePath, languagePublishStatePath, pipelineResult, writeResults, writeSummary, continuedFromManifest, }: Omit<SaveMigrationRunLogArgs, "artifactBaseName" | "useDatestamp">) => MigrationRunLogRecord[];
 export declare const recordsToJsonl: (records: MigrationRunLogRecord[]) => string;
 export declare const saveMigrationRunLog: (args: SaveMigrationRunLogArgs, config: RequestBaseConfig) => Promise<void>;
 export {};

package/dist/api/data-migration/migration-run-log.js

@@ -31,7 +31,7 @@ const resolveWriteResultValue = (result) => {
         error: result.reason,
     };
 };
-export const buildMigrationRunLogRecords = ({ from, to, itemType, dryRun, publish, publishLanguages, resolvedPublishLanguages, migrateFrom, fromFilePath, languagePublishStatePath, pipelineResult, writeResults, writeSummary, }) => {
+export const buildMigrationRunLogRecords = ({ from, to, itemType, dryRun, publish, publishLanguages, resolvedPublishLanguages, migrateFrom, fromFilePath, languagePublishStatePath, pipelineResult, writeResults, writeSummary, continuedFromManifest, }) => {
     const timestamp = new Date().toISOString();
     const runId = `${itemType}-${timestamp}`;
     const baseRecord = {
@@ -57,6 +57,7 @@ export const buildMigrationRunLogRecords = ({ from, to, itemType, dryRun, publis
             }
             : {}),
         dryRun: Boolean(dryRun),
+        ...(continuedFromManifest ? { continuedFromManifest } : {}),
         migrationConfigs: pipelineResult.stepReports.map((step) => step.migrationConfig),
         totalItems: pipelineResult.totalItems,
         totalChangedItems: pipelineResult.changedItems.length,

package/dist/cli/cli-descriptions.d.ts

@@ -5,7 +5,7 @@ export declare const publishedLayerExportDescription = "\n    USAGE\n        $ s
 export declare const languagePublishStateDescription = "\n    USAGE\n        $ sb-mig language-publish-state --from [spaceId]\n\n    DESCRIPTION\n        Read stories from a source Storyblok space and write a JSON map of default and translated language publication states.\n        This command is read-only against Storyblok. It uses Management API for story listing and default-language state, and Delivery API for translated language published/draft comparisons.\n\n    FLAGS\n        --from            Source space ID to inspect. Required.\n        --accessToken     Optional source space Delivery API access token override. Falls back to configured accessToken.\n        --languages       Languages to inspect: all, default,fr,de. Default: all.\n        --withSlug        Exact story full_slug to inspect. Can be repeated.\n        --startsWith      Filter stories by starts_with prefix.\n        --fileName        Stable output base name under sbmig/language-publish-state.\n        --outputPath      Explicit output path for the generated JSON file.\n\n    SIDE EFFECTS\n        Read-only against Storyblok. Writes a local JSON publish-state map.\n\n    EXAMPLES\n        $ sb-mig language-publish-state --from 12345 --startsWith about-ef --languages all --fileName about-ef-prod\n        $ sb-mig language-publish-state --from 12345 --accessToken xxx --withSlug about-ef/testimonials --languages default,fr\n";
 export declare const syncDescription = "\n    USAGE\n        $ sb-mig sync components [component-name ...] | --all [--presets] [--ssot] [--dry-run]\n        $ sb-mig sync roles [role-name ...] | --all [--dry-run]\n        $ sb-mig sync datasources [datasource-name ...] | --all [--dry-run]\n        $ sb-mig sync plugins [plugin-name ...] [--dry-run]\n        $ sb-mig sync content (--all | --stories | --assets) --from [spaceId] --to [spaceId-or-file] --syncDirection [direction]\n\n    DESCRIPTION\n        Synchronize components, roles, datasources, plugins, stories, and assets with Storyblok.\n\n    COMMANDS\n        components      Sync local component schema files to Storyblok.\n        roles           Sync local role schema files to Storyblok.\n        datasources     Sync local datasource schema files to Storyblok.\n        plugins         Sync a provided plugin. Run from a plugin folder with ./dist/export.js.\n        content         Sync stories and/or assets between spaces, local files, or AWS content hub data.\n\n    FLAGS\n        --all           Sync all supported resources for the selected command.\n        --stories       Sync only stories. [content only]\n        --assets        Sync only assets. [content only]\n        --presets       Also sync component presets and set default presets. [components only]\n        --ssot          Single Source of Truth mode. Removes GUI-only components and replaces them with code versions. [components only]\n        --packageName   External package name used when resolving provided components. [components only]\n        --dry-run       Preview planned changes without making writes. [components, roles, datasources, plugins, content]\n        --yes           Skip confirmation prompts. [components --ssot, destructive content sync]\n        --from          Source space ID or local story file name, depending on --syncDirection. [content only]\n        --to            Target space ID or local output file name, depending on --syncDirection. [content only]\n        --syncDirection Sync direction. Values: fromSpaceToFile, fromFileToSpace, fromSpaceToSpace, fromAWSToSpace. [content only]\n\n    SIDE EFFECTS\n        components, roles, datasources, and plugins write to Storyblok unless --dry-run is passed.\n        content with fromSpaceToSpace or fromFileToSpace can delete all target stories before recreating them.\n        content with fromSpaceToFile writes local story and asset backup files.\n\n    GOTCHAS\n        --syncDirection is required for content sync.\n        fromFileToSpace is implemented for stories, but assets log that it is not implemented.\n        fromAWSToSpace is implemented for stories. Assets log that unsupported directions are not implemented.\n        --ssot is destructive for components and prompts unless --yes is passed.\n\n    EXAMPLES\n        $ sb-mig sync components --all\n        $ sb-mig sync components --all --dry-run\n        $ sb-mig sync components --all --presets\n        $ sb-mig sync components --all --ssot --yes\n        $ sb-mig sync components accordion accordion-item --presets\n\n        $ sb-mig sync roles --all\n        $ sb-mig sync roles admin editor --dry-run\n\n        $ sb-mig sync datasources --all\n        $ sb-mig sync datasources countries cities --dry-run\n\n        $ sb-mig sync plugins my-awesome-plugin\n\n        $ sb-mig sync content --all --from 12345 --to 67890 --syncDirection fromSpaceToSpace --yes\n        $ sb-mig sync content --stories --from 12345 --to all-stories-backup --syncDirection fromSpaceToFile\n        $ sb-mig sync content --stories --from all-stories-backup --to 67890 --syncDirection fromFileToSpace --dry-run\n        $ sb-mig sync content --stories --from 12345 --to 67890 --syncDirection fromAWSToSpace\n";
 export declare const copyDescription = "\n    USAGE\n        $ sb-mig copy stories --from [spaceId] --to [spaceId] --source [full_slug] --destination [target_folder_full_slug]\n        $ sb-mig copy stories --from [spaceId] --to [spaceId] --source [folder_full_slug]\n        $ sb-mig copy stories --from [spaceId] --to [spaceId] --source [folder_full_slug]/* --destination [target_folder_full_slug]\n        $ sb-mig copy stories --from [spaceId] --to [spaceId] --source [folder_full_slug] --mode self --destination /\n        $ sb-mig copy assets --from [spaceId] --to [spaceId] --all\n        $ sb-mig copy assets --from [spaceId] --to [spaceId] --asset [asset_id_or_filename]\n        $ sb-mig copy assets --from [spaceId] --to [spaceId] --assetFolder [folder_id_or_path]\n        $ sb-mig copy assets --from [spaceId] --to [spaceId] --referenced-by-stories --source [story_or_folder_full_slug]\n        $ sb-mig copy assets --from [spaceId] --to [spaceId] --all --dry-run\n\n    DESCRIPTION\n        Copy Storyblok stories, folders, assets, or asset folders from one space to another.\n\n    COMMANDS\n        stories         Copy one story, one folder subtree, a folder's children, or one folder shell.\n        assets          Copy or plan all assets and asset folders with durable manifests.\n\n    FLAGS\n        --from          Source Storyblok space ID. Falls back to configured spaceId.\n        --to            Target Storyblok space ID. Falls back to configured spaceId.\n        --source        Source story or folder full_slug. Use folder/* to copy a folder's children without the folder root.\n        --destination   Target folder full_slug where copied stories are attached. Omit, '/', or 'root' to copy into target root.\n        --mode          Copy mode: subtree, children, or self. Default: subtree. folder/* defaults to children.\n        --with-assets   For copy stories, copy referenced assets first and rewrite copied stories to target asset IDs/filenames.\n        --publicationMode\n                       How copy stories should preserve Storyblok publication state. Values: preserve-layers, collapse-draft, save-only. Default: preserve-layers. [stories only]\n        --publicationLanguages\n                       Language scope to publish when publicationMode publishes stories. Values: default, all, or comma-separated Storyblok language codes. Default: all. [stories only]\n        --all           Select all assets and asset folders. [assets only]\n        --asset         Select one source asset by numeric ID, exact Storyblok asset URL, or unique file name. Repeatable. [assets only]\n        --assetFolder   Select one source asset folder by numeric ID or folder path. Includes descendants and assets in that subtree. Repeatable. [assets only]\n        --referenced-by-stories\n                       Select assets referenced by a story/folder scope. Requires --source. [assets only]\n        --dry-run       Preview story paths, manifest-mapped references, and likely target conflicts without writing to Storyblok.\n        --outputPath    Optional JSON file path for a dry-run copy plan artifact. Only writes locally when passed.\n\n    LEGACY FLAGS\n        --sourceSpace   Alias for --from.\n        --targetSpace   Alias for --to.\n        --what          Alias for --source.\n        --where         Alias for --destination.\n\n    SIDE EFFECTS\n        copy stories writes copied stories into the target Storyblok space unless --dry-run is passed.\n        copy stories writes story ID/UUID manifests under .sb-mig/copy/<source>/<target>/ during apply.\n        copy stories --with-assets writes referenced asset folders/assets before story writes unless --dry-run is passed.\n        copy assets writes asset folders and assets into the target Storyblok space unless --dry-run is passed.\n        copy assets writes JSONL manifests under .sb-mig/copy/<source>/<target>/ during apply.\n        --outputPath writes a local JSON report for dry-run or apply.\n\n    GOTCHAS\n        --source must resolve to an existing source story or folder.\n        --destination must resolve to an existing target folder unless it is omitted, '/', or 'root'.\n        mode 'subtree' copies a folder and all descendants. This is the default for folders.\n        mode 'children' copies a folder's descendants without the folder root.\n        mode 'self' copies only the source story or folder shell.\n        copy stories creates or matches target story shells, then fills them with rewritten source content.\n        copy stories matches existing targets by manifest first, then target full_slug when safe, so reruns can reuse mapped target stories.\n        copy stories rewrites mapped asset and story references after story manifests exist.\n        copy stories creates shells as save-only drafts, then applies publicationMode after full rewritten content is saved.\n        publicationMode preserve-layers publishes clean published source stories; for dirty published source stories it copies the source published version, publishes it in target, then restores the source draft/current layer as save-only.\n        publicationMode collapse-draft publishes published source stories from their current draft/current JSON.\n        publicationMode save-only never publishes copied stories.\n        --publicationLanguages cannot be used with --publicationMode save-only.\n        copy stories --with-assets scans selected stories with source component schemas and only copies referenced assets it can resolve from the source asset list.\n        --dry-run checks likely target path conflicts and reports mapped/planned/unresolved story and asset references, with occurrence and unique-asset counts in JSON output.\n        Without --with-assets, run copy assets first when copied stories should point to target-space assets.\n        copy assets supports --all, --asset, or --assetFolder. Use only one selector family per run.\n        copy assets --asset includes the selected asset's folder ancestors so target folder mappings can be preserved.\n        copy assets --assetFolder includes the selected folder, descendants, folder ancestors, and assets inside that selected subtree.\n        copy assets --referenced-by-stories scans selected stories with source component schemas and copies only source-space assets referenced by that story scope.\n        copy assets matches by manifest first, then safe target folder path or unique asset file name before creating.\n        copy assets uploads assets, finalizes the upload, and writes source-to-target asset/folder manifests.\n\n    EXAMPLES\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog/post-1 --destination imported\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog --destination imported\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog/* --destination imported\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog --mode self --destination /\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog --destination imported --with-assets\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog --destination imported --with-assets --publicationMode preserve-layers\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog --destination imported --publicationMode collapse-draft --publicationLanguages default,fr,de\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog --destination imported --publicationMode save-only\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog --destination imported --dry-run\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog --destination imported --with-assets --dry-run --outputPath sbmig/copy-plans/blog-copy.json\n        $ sb-mig copy stories --from 12345 --to 67890 --source blog --destination imported --dry-run --outputPath sbmig/copy-plans/blog-copy.json\n        $ sb-mig copy assets --from 12345 --to 67890 --all\n        $ sb-mig copy assets --from 12345 --to 67890 --asset 987654\n        $ sb-mig copy assets --from 12345 --to 67890 --asset hero.jpg --dry-run\n        $ sb-mig copy assets --from 12345 --to 67890 --assetFolder Marketing/Heroes --dry-run\n        $ sb-mig copy assets --from 12345 --to 67890 --referenced-by-stories --source blog --dry-run --outputPath sbmig/copy-plans/blog-assets.json\n        $ sb-mig copy assets --from 12345 --to 67890 --all --dry-run\n        $ sb-mig copy assets --from 12345 --to 67890 --all --dry-run --outputPath sbmig/copy-plans/assets-copy.json\n";
-export declare const migrateDescription = "\n    USAGE\n        $ sb-mig migrate content [component-name ...] --from [spaceId] --to [spaceId] --migration [migration-config]\n        $ sb-mig migrate content --all --from [spaceId] --to [spaceId] --migration [migration-config]\n        $ sb-mig migrate presets --all --from [spaceId-or-file] --to [spaceId] --migration [migration-config]\n\n    DESCRIPTION\n        Migrate story content or presets using local migration config files.\n        This is a potentially destructive command. It prompts for confirmation unless --yes or --dry-run is passed.\n\n    COMMANDS\n        content         Migrate story content for all components or provided component names.\n        presets         Migrate presets. Supports --all and exactly one --migration value.\n\n    FLAGS\n        --from            Source space ID, or local file name when --migrate-from file is used.\n        --fromFilePath    Direct path to stories or presets JSON when using --migrate-from file.\n        --to              Target Storyblok space ID.\n        --migrate-from    Migrate from space or file. Default: space.\n        --migration       Migration file name without extension. Can be repeated for ordered content pipelines. Presets support exactly one.\n        --migrationComponentAlias\n                          Add extra component aliases for a migration. Repeatable. Format: <migration>:<source>=<alias1>,<alias2>.\n        --migrationComponents\n                          Override the exact component scope for a migration. Repeatable. Format: <migration>:<component1>,<component2>.\n        --withSlug        Filter stories by full_slug. Can be repeated. [content only]\n        --startsWith      Filter stories by starts_with prefix. [content only]\n        --yes             Skip confirmation prompts.\n        --dry-run         Preview what would be migrated without making API changes.\n        --publicationMode How migrate content should preserve Storyblok publication state. Values: preserve-layers, collapse-draft, save-only. Default: preserve-layers. [content only]\n        --publicationLanguages\n                          Language scope to inspect and preserve when publicationMode publishes stories. Values: default, all, or comma-separated Storyblok language codes. Default: all. [content only]\n        --languagePublishStatePath\n                          Optional JSON file generated by language-publish-state. When omitted, migrate builds the map automatically for selected stories. [content only]\n        --fileName        Stable base name for migration output files.\n\n    SIDE EFFECTS\n        content writes migrated stories to Storyblok unless --dry-run is passed.\n        content creates a story backup before provided-component migrations unless --dry-run is passed.\n        presets backs up all remote presets before writing migrated presets unless --dry-run is passed.\n\n    GOTCHAS\n        At least one --migration value is required.\n        preserve-layers currently requires --migrate-from space and requires --from and --to to be the same Storyblok space.\n        --publicationLanguages cannot be used with --publicationMode save-only.\n        --languagePublishStatePath cannot be used with --publicationMode save-only.\n        --publicationMode, --publicationLanguages, and --languagePublishStatePath are only supported for migrate content, not migrate presets.\n        Legacy flags --publish, --publishLanguages, and --preservePublishedLayer are rejected. Use --publicationMode and --publicationLanguages instead.\n\n    EXAMPLES\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --dry-run\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration migration-a --migration migration-b --migration migration-c --yes\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration colorPickerModeValues --migrationComponentAlias colorPickerModeValues:sb-button=sb-open-drift-button\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration colorPickerModeValues --migrationComponents colorPickerModeValues:sb-section,sb-tour-page-section\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --withSlug blog/home --withSlug docs/getting-started\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --startsWith blog/\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --publicationMode preserve-layers --yes\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --publicationMode collapse-draft --publicationLanguages default,fr,de --yes\n        $ sb-mig migrate content --all --migrate-from file --from file-with-stories --to 12345 --migration file-with-migration\n        $ sb-mig migrate content --all --migrate-from file --fromFilePath sbmig/migrations/dry-run--123---story-to-migrate.json --to 12345 --migration migration-a --migration migration-b\n        $ sb-mig migrate content my-component-1 my-component-2 --from 12345 --to 12345 --migration file-with-migration\n        $ sb-mig migrate presets --all --from 12345 --to 12345 --migration preset-migration --dry-run\n        $ sb-mig migrate presets --all --migrate-from file --fromFilePath sbmig/presets/presets-backup.json --to 12345 --migration preset-migration\n";
+export declare const migrateDescription = "\n    USAGE\n        $ sb-mig migrate content [component-name ...] --from [spaceId] --to [spaceId] --migration [migration-config]\n        $ sb-mig migrate content --all --from [spaceId] --to [spaceId] --migration [migration-config]\n        $ sb-mig migrate presets --all --from [spaceId-or-file] --to [spaceId] --migration [migration-config]\n\n    DESCRIPTION\n        Migrate story content or presets using local migration config files.\n        This is a potentially destructive command. It prompts for confirmation unless --yes or --dry-run is passed.\n\n    COMMANDS\n        content         Migrate story content for all components or provided component names.\n        presets         Migrate presets. Supports --all and exactly one --migration value.\n        continue        Finish a previous --dry-run by writing its already-computed result to\n                        Storyblok. Skips pulling stories and re-running the migration, so it is\n                        much faster. Requires a content freeze between the dry-run and continue.\n\n    FLAGS\n        --from            Source space ID, or local file name when --migrate-from file is used.\n        --manifest        [continue only] Continue manifest filename inside the migrations folder.\n                          Only needed when more than one dry-run manifest is present.\n        --fromFilePath    Direct path to stories or presets JSON when using --migrate-from file.\n        --to              Target Storyblok space ID.\n        --migrate-from    Migrate from space or file. Default: space.\n        --migration       Migration file name without extension. Can be repeated for ordered content pipelines. Presets support exactly one.\n        --migrationComponentAlias\n                          Add extra component aliases for a migration. Repeatable. Format: <migration>:<source>=<alias1>,<alias2>.\n        --migrationComponents\n                          Override the exact component scope for a migration. Repeatable. Format: <migration>:<component1>,<component2>.\n        --withSlug        Filter stories by full_slug. Can be repeated. [content only]\n        --startsWith      Filter stories by starts_with prefix. [content only]\n        --yes             Skip confirmation prompts.\n        --dry-run         Preview what would be migrated without making API changes.\n        --publicationMode How migrate content should preserve Storyblok publication state. Values: preserve-layers, collapse-draft, save-only. Default: preserve-layers. [content only]\n        --publicationLanguages\n                          Language scope to inspect and preserve when publicationMode publishes stories. Values: default, all, or comma-separated Storyblok language codes. Default: all. [content only]\n        --languagePublishStatePath\n                          Optional JSON file generated by language-publish-state. When omitted, migrate builds the map automatically for selected stories. [content only]\n        --fileName        Stable base name for migration output files.\n\n    SIDE EFFECTS\n        content writes migrated stories to Storyblok unless --dry-run is passed.\n        content creates a story backup before provided-component migrations unless --dry-run is passed.\n        content --dry-run also writes a continue manifest so the run can later be finished with migrate continue.\n        continue writes the dry-run's migrated stories to Storyblok and updates applied-backpack-migrations.json. It does not pull or re-transform stories.\n        presets backs up all remote presets before writing migrated presets unless --dry-run is passed.\n\n    GOTCHAS\n        At least one --migration value is required.\n        preserve-layers currently requires --migrate-from space and requires --from and --to to be the same Storyblok space.\n        --publicationLanguages cannot be used with --publicationMode save-only.\n        --languagePublishStatePath cannot be used with --publicationMode save-only.\n        --publicationMode, --publicationLanguages, and --languagePublishStatePath are only supported for migrate content, not migrate presets.\n        Legacy flags --publish, --publishLanguages, and --preservePublishedLayer are rejected. Use --publicationMode and --publicationLanguages instead.\n\n    EXAMPLES\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --dry-run\n        $ sb-mig migrate continue\n        $ sb-mig migrate continue --manifest dry-run--12345--2026-6-2_13-5---story-continue-manifest.json --yes\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration migration-a --migration migration-b --migration migration-c --yes\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration colorPickerModeValues --migrationComponentAlias colorPickerModeValues:sb-button=sb-open-drift-button\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration colorPickerModeValues --migrationComponents colorPickerModeValues:sb-section,sb-tour-page-section\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --withSlug blog/home --withSlug docs/getting-started\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --startsWith blog/\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --publicationMode preserve-layers --yes\n        $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --publicationMode collapse-draft --publicationLanguages default,fr,de --yes\n        $ sb-mig migrate content --all --migrate-from file --from file-with-stories --to 12345 --migration file-with-migration\n        $ sb-mig migrate content --all --migrate-from file --fromFilePath sbmig/migrations/dry-run--123---story-to-migrate.json --to 12345 --migration migration-a --migration migration-b\n        $ sb-mig migrate content my-component-1 my-component-2 --from 12345 --to 12345 --migration file-with-migration\n        $ sb-mig migrate presets --all --from 12345 --to 12345 --migration preset-migration --dry-run\n        $ sb-mig migrate presets --all --migrate-from file --fromFilePath sbmig/presets/presets-backup.json --to 12345 --migration preset-migration\n";
 export declare const revertDescription = "\n    USAGE\n        $ sb-mig revert content --from [stories-file-name] --to [spaceId] [--yes]\n\n    DESCRIPTION\n        Restore stories from a local story backup file into a Storyblok space.\n\n    COMMANDS\n        content         Revert content by updating target stories from a local story backup.\n\n    FLAGS\n        --from          Local story backup file name to discover and load.\n        --to            Target Storyblok space ID to update.\n        --yes           Skip confirmation prompt.\n\n    SIDE EFFECTS\n        Writes stories to the target Storyblok space.\n        Creates a target-space story backup before restoring.\n        Restored stories are updated with publish: false.\n\n    GOTCHAS\n        This command restores local story files directly and does not run migration configs.\n        The --from value is resolved as a local story file name, not a source space ID.\n\n    EXAMPLES\n        $ sb-mig revert content --from 12345--backup-before-migration --to 12345\n        $ sb-mig revert content --from prod-stories-backup --to 12345 --yes\n";
 export declare const discoverDescription = "\n    USAGE\n        $ sb-mig discover components --all [--write] [--file file-name]\n        $ sb-mig discover migrations --all\n\n    DESCRIPTION\n        Discover local and external component schema files or migration config files.\n\n    COMMANDS\n        components      Discover component schema files.\n        migrations      Discover migration config files.\n\n    FLAGS\n        --all           Discover all components or migration config files.\n        --write         Write discovered component names to a local file. [components only]\n        --file          Output file name when --write is passed. [components only]\n\n    SIDE EFFECTS\n        Read-only unless --write is passed.\n        --write creates or overwrites a local component list file.\n\n    EXAMPLES\n        $ sb-mig discover components --all\n        $ sb-mig discover components --all --write\n        $ sb-mig discover components --all --write --file all-components\n        $ sb-mig discover migrations --all\n";
 export declare const migrationsDescription = "\n    USAGE\n        $ sb-mig migrations recognize --from [version] [--to version]\n\n    DESCRIPTION\n        Recognize migration commands to run for a package upgrade by comparing an old version with a target version.\n\n    COMMANDS\n        recognize       Print recommended story and preset migration commands.\n\n    FLAGS\n        --from          Previous package version. Required.\n        --to            Target package version. Optional. Falls back to the installed @ef-global/backpack dependency version.\n\n    SIDE EFFECTS\n        Reads local applied-backpack-migrations.json when present.\n        Reads local package.json when --to is omitted.\n        Does not write files or call Storyblok.\n\n    EXAMPLES\n        $ sb-mig migrations recognize --from 3.4.0\n        $ sb-mig migrations recognize --from 3.4.0 --to 4.0.0\n";

package/dist/cli/cli-descriptions.js

@@ -315,9 +315,14 @@ export const migrateDescription = `
     COMMANDS
         content         Migrate story content for all components or provided component names.
         presets         Migrate presets. Supports --all and exactly one --migration value.
+        continue        Finish a previous --dry-run by writing its already-computed result to
+                        Storyblok. Skips pulling stories and re-running the migration, so it is
+                        much faster. Requires a content freeze between the dry-run and continue.
 
     FLAGS
         --from            Source space ID, or local file name when --migrate-from file is used.
+        --manifest        [continue only] Continue manifest filename inside the migrations folder.
+                          Only needed when more than one dry-run manifest is present.
         --fromFilePath    Direct path to stories or presets JSON when using --migrate-from file.
         --to              Target Storyblok space ID.
         --migrate-from    Migrate from space or file. Default: space.
@@ -340,6 +345,8 @@ export const migrateDescription = `
     SIDE EFFECTS
         content writes migrated stories to Storyblok unless --dry-run is passed.
         content creates a story backup before provided-component migrations unless --dry-run is passed.
+        content --dry-run also writes a continue manifest so the run can later be finished with migrate continue.
+        continue writes the dry-run's migrated stories to Storyblok and updates applied-backpack-migrations.json. It does not pull or re-transform stories.
         presets backs up all remote presets before writing migrated presets unless --dry-run is passed.
 
     GOTCHAS
@@ -352,6 +359,8 @@ export const migrateDescription = `
 
     EXAMPLES
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration file-with-migration --dry-run
+        $ sb-mig migrate continue
+        $ sb-mig migrate continue --manifest dry-run--12345--2026-6-2_13-5---story-continue-manifest.json --yes
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration migration-a --migration migration-b --migration migration-c --yes
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration colorPickerModeValues --migrationComponentAlias colorPickerModeValues:sb-button=sb-open-drift-button
         $ sb-mig migrate content --all --from 12345 --to 12345 --migration colorPickerModeValues --migrationComponents colorPickerModeValues:sb-section,sb-tour-page-section

package/dist/cli/commands/migrate.js

@@ -1,5 +1,5 @@
 import path from "path";
-import { migrateAllComponentsDataInStories, migrateProvidedComponentsDataInStories, } from "../../api/data-migration/component-data-migration.js";
+import { migrateAllComponentsDataInStories, migrateProvidedComponentsDataInStories, prepareContinueMigration, } from "../../api/data-migration/component-data-migration.js";
 import { buildStoryBackupBaseName } from "../../api/data-migration/file-naming.js";
 import { parseMigrationComponentAliasFlags, parseMigrationComponentOverrideFlags, } from "../../api/data-migration/migration-component-scope.js";
 import { managementApi } from "../../api/managementApi.js";
@@ -13,6 +13,7 @@ import { isItFactory, unpackElements, getFrom, getTo, } from "../utils/cli-utils
 const MIGRATE_COMMANDS = {
     content: "content",
     presets: "presets",
+    continue: "continue",
 };
 const normalizeMigrationFlags = (migrationFlag) => {
     if (Array.isArray(migrationFlag)) {
@@ -280,6 +281,31 @@ export const migrate = async (props) => {
             }
             break;
         }
+        case MIGRATE_COMMANDS.continue: {
+            const manifestFileName = flags["manifest"];
+            const plan = await prepareContinueMigration({ manifestFileName }, apiConfig);
+            const { summary } = plan;
+            Logger.log("Found dry-run to continue:");
+            console.log(`  manifest:          ${summary.manifestFileName}`);
+            console.log(`  space (from→to):   ${summary.from} → ${summary.to}`);
+            console.log(`  publication mode:  ${summary.publicationMode}`);
+            console.log(`  migrations:        ${summary.migrationConfigNames.join(", ") || "(none recorded)"}`);
+            if (summary.resolvedPublishLanguages.length > 0) {
+                console.log(`  languages:         ${summary.resolvedPublishLanguages.join(", ")}`);
+            }
+            console.log(`  ${summary.itemType}s to write:   ${summary.changedCount} changed${summary.dirtyPublishedCount > 0
+                ? `  (${summary.dirtyPublishedCount} dirty-published dual-layer write(s))`
+                : ""}`);
+            console.log("  using artifacts:");
+            summary.artifactFiles.forEach((file) => console.log(`    - ${file}`));
+            console.log(" ");
+            await askForConfirmation(`Continue and write these to Storyblok space ${summary.to}? (it will overwrite ${summary.itemType}s)`, async () => {
+                await plan.run();
+            }, () => {
+                Logger.warning("Continue not started, exiting the program...");
+            }, flags["yes"]);
+            break;
+        }
         default:
             console.log(`no command like that: ${command}`);
     }

package/dist/cli/index.js

@@ -83,6 +83,9 @@ app.migrate = () => ({
             fileName: {
                 type: "string",
             },
+            manifest: {
+                type: "string",
+            },
         },
     }),
     action: async (cli) => {

package/dist/utils/files.d.ts

@@ -60,6 +60,7 @@ type CreateAndSaveToFile = (args: {
 }, config: RequestBaseConfig) => void;
 export declare const createAndSaveToFile: CreateAndSaveToFile;
 export declare const createAndSaveComponentListToFile: CreateAndSaveComponentListToFile;
+export declare const listFilesInDir: (dirPath: string) => Promise<string[]>;
 export declare const readFile: (pathToFile: string) => Promise<string | undefined>;
 export declare const dumpToFile: (path: string, content: string) => Promise<void>;
 export declare const getConsumerPackageJson: () => Promise<any>;

package/dist/utils/files.js

@@ -253,6 +253,15 @@ export const createAndSaveComponentListToFile = async ({ file, folder, res, time
         : `${sbmigWorkingDirectory}/${filename}.ts`, timestamp);
     Logger.success(`All components written to a file:  ${filename}`);
 };
+export const listFilesInDir = async (dirPath) => {
+    const absolutePath = resolveFromCwd(dirPath);
+    try {
+        return await fs.promises.readdir(absolutePath);
+    }
+    catch {
+        return [];
+    }
+};
 export const readFile = async (pathToFile) => {
     const absolutePath = resolveFromCwd(pathToFile);
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sb-mig",
-  "version": "6.3.0",
+  "version": "6.4.0",
   "description": "CLI to rule the world. (and handle stuff related to Storyblok CMS)",
   "author": "Marcin Krawczyk <marckraw@icloud.com>",
   "license": "MIT",