### Getting Started with dodo-migrate CLI Commands

Source: https://github.com/dodopayments/dodo-migrate/blob/main/README.md

Provides example command-line usage for installing and executing the dodo-migrate CLI. It demonstrates importing data from Stripe, planning the migration, and exporting it to Dodo format.

```bash
# Install
npm i -g dodo-migrate  # or use npx once published

# Example: import from Stripe, then plan and export
dodo-migrate import --provider stripe --since 2022-01-01 --out ./.dodo-migrate
dodo-migrate plan --out ./.dodo-migrate
dodo-migrate export --target dodo --out ./.dodo-migrate
```

--------------------------------

### Repository Structure Overview

Source: https://github.com/dodopayments/dodo-migrate/blob/main/README.md

Illustrates the organizational structure of the dodo-migrate project, categorizing source code, documentation, examples, scripts, and tests. This helps understand the project's modular design.

```tree
src/
  cli/                # CLI entrypoints and commands
  adapters/           # Provider-specific import logic (no secrets committed)
    lemonsqueezy/
    gumroad/
    stripe/
    paddle/
    fastspring/
    2checkout/
    generic-csv/      # Simple CSV-based migration for custom sources
  models/             # Canonical TypeScript interfaces for entities
  services/           # Provider-agnostic domain services
  validators/         # Zod/Valibot schemas and integrity checks
  utils/              # Shared helpers
  importers/          # Pull & stage raw provider data
  transformers/       # Convert raw -> canonical models
  exporters/
    dodo/             # Emit Dodo-compatible artifacts (JSONL/CSV)

docs/
  providers/          # Per-provider notes, mappings, gotchas
examples/             # Sample configs and input data layouts
scripts/              # One-off maintenance and generation scripts
tests/                # Unit/integration tests
```

--------------------------------

### Run Directory Structure

Source: https://github.com/dodopayments/dodo-migrate/blob/main/docs/ARCHITECTURE.md

Illustrates the directory layout created by each migration run. This structure organizes raw provider data, normalized canonical models, reports, exported artifacts, and logs.

```text
.dodo-migrate/
  <run-id>/
    raw/            # Provider raw payloads
    normalized/     # Canonical models JSONL
    reports/        # Markdown/CSV summaries
    artifacts/      # Dodo-ready exports
    logs/           # Structured logs
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.