Skip to content

chore(migrate-sdk): version packages - #9

Merged
asgorobets merged 1 commit into
mainfrom
changeset-release/main
Sep 1, 2026
Merged

chore(migrate-sdk): version packages#9
asgorobets merged 1 commit into
mainfrom
changeset-release/main

Conversation

@github-actions

@github-actions github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

migrate-sdk@0.8.0

Minor Changes

  • 0acb9ae: Add a versioned, schema-backed Migrate Protocol with Effect RPC handlers for
    dashboard discovery, messages, planning, execution, streaming observation,
    cancellation of work owned by the current Migrate Server process, source scans,
    source identity history, and lock recovery. Detached run cancellation by
    Migration Run id remains deferred until Execution Adapters expose
    provider-neutral cancellation.

    Run local migration configurations in a Node Migrate Server child process while
    the OpenTUI renderer remains in Bun. The npm launcher passes its exact Node
    executable to the renderer, plans are revalidated by fingerprint before
    execution, and live progress is multiplexed over child-process IPC. The public
    programmatic runtime uses the same boundary, and the Node server reports
    bootstrap failures through a nonzero process exit. Runtime-neutral
    MigrateClient and MigrateServer Effect services expose constructors and
    Layers for alternative transports and server deployments.

    Discover active runs from durable run and lock ownership, and observe a
    Reconnectable Migration Run by Migration Run id after the original client
    observation or Migrate Server instance is gone. The TUI offers Attach to run for
    matching locked migrations, follows committed progress, and can end the new
    observation without cancelling work owned by its Execution Adapter.

    Add active-run discovery and run-based observation to the unreleased Migrate
    Protocol. Dashboard snapshots include active runs so the TUI reads
    durable status once per refresh. Reconnection preserves failed terminal states
    and observes through a Migration Definition Lock still owned by the run.
    Migration Stores retain Migration Run State by Migration Run id when a later run
    replaces a definition's latest state. Non-transactional stores commit that
    authoritative run record before latest-definition projections, and retries
    repair interrupted projection writes without overwriting newer runs.
    Integration coverage closes one Node
    server and proves that a fresh server can rediscover and observe a file-backed
    run whose execution provider process remained active.

  • 1537643: Add an interactive terminal interface for discovering, inspecting, running, retrying, and rolling back migrations. Targeted runs accept multiple source identities in one SDK operation, and the TUI can compose them from durable item history. Closing the TUI detaches its observations while active runs continue until explicitly stopped or completed, and the command uses the migration project's compatible SDK version. Session activity keeps a chronological, scrollable record of statuses, notices, warnings, errors, and observed run lifecycle changes, provides complete event details, and exports retained entries as JSON Lines.

  • 9002aaa: Allow local CLI and TUI clients to identify immutable migration application
    builds with MIGRATE_SERVER_BUILD_ID. Changing the build ID selects a separate
    local Node Migrate Server endpoint while active runs on the previous endpoint
    continue to drain.

  • b919a6e: CSV sources can now set batchSize to emit bounded cursor windows. This makes
    committed progress observable during large CSV migrations while retaining the
    existing unbounded behavior by default. Durable CSV cursor row positions remain
    integer-validated.

    Add a persistent SQLite catalog example backed by checked-in CC0 Wikidata CSV
    metadata, including deterministic failures, skips, updates, retry, concurrency,
    dependency groups, and rollback scenarios in the TUI. Fixture setup
    only resets directories it previously created, and the source schema rejects
    unknown fixture dispositions. The local Node Migrate Server now loads this and
    other Node migration configurations on behalf of the Bun-rendered TUI.

  • 23bdba4: Stream complete migration-dashboard snapshots through persistent RPC streams
    and resumable HTTP leases, while keeping focused run detail and client
    navigation independent from aggregate status observation.

  • 54f4a90: Manage SQL Migration Store schemas with bundled Effect SQL migrations. Fresh
    stores install the current bundled schema, while existing stores are checked without
    mutation and rejected when their history or shape is older, newer, divergent,
    partial, or untracked. TypeScript callers can inspect a stable schema plan and
    explicitly apply it with SqlMigrationStore.planSchema and
    SqlMigrationStore.applySchemaPlan.

    CLI callers can configure an explicit SQL store target and use
    migrate store schema status to inspect it or migrate store schema upgrade
    to apply an interactively confirmed or exact plan-ID-approved upgrade.

  • 57ca6f0: Expose runtime-neutral HTTP and browser Migrate clients that connect directly
    to the complete authenticated Migrate Server protocol. Browser connections can
    cancel setup and observation independently from durable migration execution.

  • 2879a84: Separate Migration Run observation from run control. The Migrate Protocol
    can observe server-owned inline work by Migration Run id and request an explicit
    run-scoped stop, while provider-owned runs report stopping as unsupported until
    their Execution Adapter implements cancellation.

    Keep the local Node Migrate Server alive when its TUI client disconnects during
    active runs. The server owns independent execution and cancellation handles for
    each run, allowing non-overlapping migrations to execute concurrently while
    Migration Definition Locks reject conflicting plans. A later TUI session
    reconnects over local Effect RPC, navigation changes only the focused run
    observation, and closing the TUI no longer stops any migration.

  • bb977d4: Expose the Migrate Server through a Web-standard Effect RPC HTTP handler and
    add bounded, resumable run-observation leases with opaque resume tokens and
    absolute durable progress snapshots. Lease resume tokens retain the durable
    observation anchor so reconnects address the selected run directly. Transient
    lifecycle states and warnings are delivered with the next progress or completion
    checkpoint, and a terminal event is emitted only after the final durable
    progress snapshot.

    Let the TUI connect to a remote Migrate Server with --server, authenticate
    with an environment-provided Bearer token, reconnect observation leases after
    HTTP or serverless function boundaries, and expose the same complete operation
    contract used by local Migrate Servers. Remote connections require HTTPS outside
    loopback development and a matching Migrate SDK version, while HTTP hosts must
    provide request authorization or explicitly delegate it to authenticated
    infrastructure.

    Separate registry-backed Migrate Server construction from local
    migrate.config.* discovery. Remote hosts can construct the server directly
    from an imported registry and executable, while config paths remain private to
    the local CLI/TUI bootstrap.

Patch Changes

  • b919a6e: Record a separate durable outcome for every migration definition in a shared
    run. A failed group run no longer marks successful dependencies or unstarted
    siblings as failed, and retries use the dependency's own latest outcome.

    SQL Migration Stores can upgrade to schema version 2 to retain definition
    outcomes alongside the aggregate run lifecycle.

@migrate-sdk/tui@0.8.0

Minor Changes

  • 0acb9ae: Add a versioned, schema-backed Migrate Protocol with Effect RPC handlers for
    dashboard discovery, messages, planning, execution, streaming observation,
    cancellation of work owned by the current Migrate Server process, source scans,
    source identity history, and lock recovery. Detached run cancellation by
    Migration Run id remains deferred until Execution Adapters expose
    provider-neutral cancellation.

    Run local migration configurations in a Node Migrate Server child process while
    the OpenTUI renderer remains in Bun. The npm launcher passes its exact Node
    executable to the renderer, plans are revalidated by fingerprint before
    execution, and live progress is multiplexed over child-process IPC. The public
    programmatic runtime uses the same boundary, and the Node server reports
    bootstrap failures through a nonzero process exit. Runtime-neutral
    MigrateClient and MigrateServer Effect services expose constructors and
    Layers for alternative transports and server deployments.

    Discover active runs from durable run and lock ownership, and observe a
    Reconnectable Migration Run by Migration Run id after the original client
    observation or Migrate Server instance is gone. The TUI offers Attach to run for
    matching locked migrations, follows committed progress, and can end the new
    observation without cancelling work owned by its Execution Adapter.

    Add active-run discovery and run-based observation to the unreleased Migrate
    Protocol. Dashboard snapshots include active runs so the TUI reads
    durable status once per refresh. Reconnection preserves failed terminal states
    and observes through a Migration Definition Lock still owned by the run.
    Migration Stores retain Migration Run State by Migration Run id when a later run
    replaces a definition's latest state. Non-transactional stores commit that
    authoritative run record before latest-definition projections, and retries
    repair interrupted projection writes without overwriting newer runs.
    Integration coverage closes one Node
    server and proves that a fresh server can rediscover and observe a file-backed
    run whose execution provider process remained active.

  • 1537643: Add an interactive terminal interface for discovering, inspecting, running, retrying, and rolling back migrations. Targeted runs accept multiple source identities in one SDK operation, and the TUI can compose them from durable item history. Closing the TUI detaches its observations while active runs continue until explicitly stopped or completed, and the command uses the migration project's compatible SDK version. Session activity keeps a chronological, scrollable record of statuses, notices, warnings, errors, and observed run lifecycle changes, provides complete event details, and exports retained entries as JSON Lines.

  • 9002aaa: Allow local CLI and TUI clients to identify immutable migration application
    builds with MIGRATE_SERVER_BUILD_ID. Changing the build ID selects a separate
    local Node Migrate Server endpoint while active runs on the previous endpoint
    continue to drain.

  • 23bdba4: Stream complete migration-dashboard snapshots through persistent RPC streams
    and resumable HTTP leases, while keeping focused run detail and client
    navigation independent from aggregate status observation.

  • 2879a84: Separate Migration Run observation from run control. The Migrate Protocol
    can observe server-owned inline work by Migration Run id and request an explicit
    run-scoped stop, while provider-owned runs report stopping as unsupported until
    their Execution Adapter implements cancellation.

    Keep the local Node Migrate Server alive when its TUI client disconnects during
    active runs. The server owns independent execution and cancellation handles for
    each run, allowing non-overlapping migrations to execute concurrently while
    Migration Definition Locks reject conflicting plans. A later TUI session
    reconnects over local Effect RPC, navigation changes only the focused run
    observation, and closing the TUI no longer stops any migration.

  • bb977d4: Expose the Migrate Server through a Web-standard Effect RPC HTTP handler and
    add bounded, resumable run-observation leases with opaque resume tokens and
    absolute durable progress snapshots. Lease resume tokens retain the durable
    observation anchor so reconnects address the selected run directly. Transient
    lifecycle states and warnings are delivered with the next progress or completion
    checkpoint, and a terminal event is emitted only after the final durable
    progress snapshot.

    Let the TUI connect to a remote Migrate Server with --server, authenticate
    with an environment-provided Bearer token, reconnect observation leases after
    HTTP or serverless function boundaries, and expose the same complete operation
    contract used by local Migrate Servers. Remote connections require HTTPS outside
    loopback development and a matching Migrate SDK version, while HTTP hosts must
    provide request authorization or explicitly delegate it to authenticated
    infrastructure.

    Separate registry-backed Migrate Server construction from local
    migrate.config.* discovery. Remote hosts can construct the server directly
    from an imported registry and executable, while config paths remain private to
    the local CLI/TUI bootstrap.

Patch Changes

  • b919a6e: Record a separate durable outcome for every migration definition in a shared
    run. A failed group run no longer marks successful dependencies or unstarted
    siblings as failed, and retries use the dependency's own latest outcome.

    SQL Migration Stores can upgrade to schema version 2 to retain definition
    outcomes alongside the aggregate run lifecycle.

  • Updated dependencies [0acb9ae]

  • Updated dependencies [1537643]

  • Updated dependencies [b919a6e]

  • Updated dependencies [9002aaa]

  • Updated dependencies [b919a6e]

  • Updated dependencies [23bdba4]

  • Updated dependencies [54f4a90]

  • Updated dependencies [57ca6f0]

  • Updated dependencies [2879a84]

  • Updated dependencies [bb977d4]

    • migrate-sdk@0.8.0

@migrate-sdk/commercetools@0.8.0

Patch Changes

  • 0acb9ae: Add a versioned, schema-backed Migrate Protocol with Effect RPC handlers for
    dashboard discovery, messages, planning, execution, streaming observation,
    cancellation of work owned by the current Migrate Server process, source scans,
    source identity history, and lock recovery. Detached run cancellation by
    Migration Run id remains deferred until Execution Adapters expose
    provider-neutral cancellation.

    Run local migration configurations in a Node Migrate Server child process while
    the OpenTUI renderer remains in Bun. The npm launcher passes its exact Node
    executable to the renderer, plans are revalidated by fingerprint before
    execution, and live progress is multiplexed over child-process IPC. The public
    programmatic runtime uses the same boundary, and the Node server reports
    bootstrap failures through a nonzero process exit. Runtime-neutral
    MigrateClient and MigrateServer Effect services expose constructors and
    Layers for alternative transports and server deployments.

    Discover active runs from durable run and lock ownership, and observe a
    Reconnectable Migration Run by Migration Run id after the original client
    observation or Migrate Server instance is gone. The TUI offers Attach to run for
    matching locked migrations, follows committed progress, and can end the new
    observation without cancelling work owned by its Execution Adapter.

    Add active-run discovery and run-based observation to the unreleased Migrate
    Protocol. Dashboard snapshots include active runs so the TUI reads
    durable status once per refresh. Reconnection preserves failed terminal states
    and observes through a Migration Definition Lock still owned by the run.
    Migration Stores retain Migration Run State by Migration Run id when a later run
    replaces a definition's latest state. Non-transactional stores commit that
    authoritative run record before latest-definition projections, and retries
    repair interrupted projection writes without overwriting newer runs.
    Integration coverage closes one Node
    server and proves that a fresh server can rediscover and observe a file-backed
    run whose execution provider process remained active.

  • b919a6e: Record a separate durable outcome for every migration definition in a shared
    run. A failed group run no longer marks successful dependencies or unstarted
    siblings as failed, and retries use the dependency's own latest outcome.

    SQL Migration Stores can upgrade to schema version 2 to retain definition
    outcomes alongside the aggregate run lifecycle.

@migrate-sdk/workflow-sdk@0.8.0

Patch Changes

  • b919a6e: Record a separate durable outcome for every migration definition in a shared
    run. A failed group run no longer marks successful dependencies or unstarted
    siblings as failed, and retries use the dependency's own latest outcome.

    SQL Migration Stores can upgrade to schema version 2 to retain definition
    outcomes alongside the aggregate run lifecycle.

@vercel

vercel Bot commented Sep 1, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
migrate-sdk-workflow Ready Ready Preview Sep 1, 2026 12:27pm UTC

@asgorobets
asgorobets merged commit c9882fe into main Sep 1, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant