# Architecture

> How the sb-mig CLI, old API layer, and API v2 fit together today.
sb-mig is currently a CLI-first TypeScript package with two API surfaces.

## CLI [#cli]

The CLI entrypoint uses `meow` for parsing and delegates to command modules under `src/cli/commands`.

Commands are thin in some places and still orchestration-heavy in others.

## Current API layer [#current-api-layer]

The current `src/api` layer contains Storyblok operations for components, stories, assets, datasources, roles, plugins, presets, spaces, inspections, and migrations.

Some of this layer still imports CLI discovery utilities and global configuration. That means it is useful internally, but not yet a perfectly isolated public SDK.

## API v2 [#api-v2]

`api-v2` is the evolving programmatic surface intended for direct GUI and application integration.

Today it includes a client factory, stories, discovery, sync types, and resource wrappers, but it does not yet have full parity with every CLI workflow.

## Documentation stance [#documentation-stance]

The public docs should document the CLI as the stable user surface first. API v2 docs should be explicit about maturity and parity.