@eonium/compass-migrate

Portability Migrate owns the initial FlutterFlow-to-Flutter Portability migration scaffold.

It creates placeholder files under .eonium/compass/portability/migrations/flutterflow_to_flutter/ so a target repo can record provider-coupling risks, compatibility planning notes and migration-readiness status without implying that Eonium has already implemented an automatic migration engine.

Generated files

This package currently creates:

• status.json - structured placeholder status for the FlutterFlow-to-Flutter Portability migration surface.
• provider-coupling.md - notes for verified provider coupling such as Firebase, auth, storage, API, custom-action and generated FlutterFlow assumptions.
• compatibility-plan.md - notes for compatibility planning before future Create specs, plans, overlays, validation evidence or finalization records are produced.

Write behaviour

initCompassMigrate() uses the shared @eonium/compass-core scaffold writer.

The initializer:

• defaults to dry-run when no write mode is supplied;
• writes only when dryRun: false or mode: "write" is supplied;
• preserves existing files by default;
• updates existing scaffold targets only when force: true is supplied;
• reports created, updated, skipped, errored, warnings and errors through the shared Compass change report shape.

Relationship to other Compass surfaces

Portability records migration-readiness, provider-coupling and compatibility planning notes.

Create remains the future place for bounded specs, plans, runs, overlays, validation evidence and finalization records once implementation work is approved.

Sherpa remains the durable repo truth surface for frontend, business and backend knowledge. Do not use this package's placeholders as a replacement for Sherpa.

FF Migrator remains the FlutterFlow-specific migration cockpit for source archaeology, prompt packs, migration graphs, progress logs and step execution instructions.

Non-goals

This package does not parse FlutterFlow exports, rewrite providers, generate Flutter app code, compare screenshots, call AI providers, run prompt packs, host agents, perform automatic migration, execute Create workflows or make compatibility decisions.

It is a safe scaffold generator for Portability placeholders only. Full Portability migration engines remain deferred.