How wdufrin/headless-migration-tool works
gemini-migrate is an administrator-operated platform for moving Gemini Enterprise data and permissions between Google Cloud environments. Its main workflow is to configure source/target environments and identity mappings, discover resources, audit parity and connector mappings for human review, then run a dry-run or migration and produce reports. The graph emphasizes those documented stages and the migration runner’s indexed module dependencies. Some route wiring and unsampled engines are represented only where the README or SOURCE INDEX supports them; edges do not imply unverified call order.
Main entry points: migrationRunner.ts Migration Runner · gcpAuth.ts GCP Authentication · cli.ts CLI · discoveryEngine.ts Resource Discovery
Components 26
Operator Entry
- CLI
src/cli.ts - Web Server
src/server.ts
Configuration and Control
- Config Schema
src/config/configSchema.ts - Discovery Routes
src/routes/discovery.ts - Setup Wizard
src/routes/wizard.ts - Migration Routes
src/routes/migration.ts
Migration Workflows
- Migration Runner
src/engines/migrationRunner.ts - Agent Migrator
src/engines/agentMigrator.ts - Notebook Migrator
src/engines/notebookMigrator.ts - Skill Migrator
src/engines/skillMigrator.ts - Session Migrator
src/engines/sessionMigrator.ts - Memory Migrator
src/engines/memoryMigrator.ts - Artifact Export
src/engines/artifactExtractor.ts - Migration Checkpoints
src/services/checkpointManager.ts
Cloud and Identity
- GCP Authentication
src/services/gcpAuth.ts - Resource Discovery
src/services/discoveryEngine.ts - Identity Mapping
src/services/identityMappingService.ts - WiF Preflight
src/services/wifPreflight.ts
Audit and Reporting
- Audit Routes
src/routes/configAudit.ts - Parity Audit
src/engines/configAuditEngine.ts - Connector Matching
src/services/connectorMatcher.ts - User Reports
src/engines/userReportGenerator.ts - Report Service
src/services/reporter.ts - Permission Audit
src/services/permissionAuditor.ts
Other components
- Administrator
- Google Cloud APIs
Connections 48
- Administrator → CLI: runs commands
README.md - Administrator → Web Server: operates console
README.md - Web Server → Migration Routes: routes requests
src/server.ts - Web Server → Discovery Routes: routes requests
src/server.ts - Web Server → Setup Wizard: routes requests
src/server.ts - Web Server → Audit Routes: routes requests
src/server.ts - CLI → Config Schema: loads configuration
src/cli.ts - CLI → Migration Runner: starts migration
src/cli.ts - CLI → GCP Authentication: configures credentials
src/cli.ts - CLI → Resource Discovery: uses discovery
src/cli.ts - CLI → Parity Audit: runs audit
src/cli.ts - CLI → User Reports: generates report
src/cli.ts - Config Schema → GCP Authentication: configures credentials
- Setup Wizard → GCP Authentication: sets up identity
src/routes/wizard.ts - Setup Wizard → Permission Audit: checks permissions
src/routes/wizard.ts - Setup Wizard → WiF Preflight: runs preflight
src/routes/wizard.ts - Discovery Routes → Resource Discovery: queries resources
src/routes/discovery.ts - Parity Audit → Resource Discovery: compares environments
src/engines/configAuditEngine.ts - Parity Audit → Connector Matching: builds mappings
src/engines/configAuditEngine.ts - Parity Audit → GCP Authentication: uses credentials
src/engines/configAuditEngine.ts - Administrator → Parity Audit: reviews parity
README.md - Administrator → Migration Runner: confirms migration
README.md - Migration Routes → Migration Runner: starts migration
- Migration Runner → Agent Migrator: dispatches migration
src/engines/migrationRunner.ts - Migration Runner → Notebook Migrator: dispatches migration
src/engines/migrationRunner.ts - Migration Runner → Skill Migrator: dispatches migration
src/engines/migrationRunner.ts - Migration Runner → Session Migrator: dispatches migration
src/engines/migrationRunner.ts - Migration Runner → Memory Migrator: dispatches migration
src/engines/migrationRunner.ts - Migration Runner → Artifact Export: dispatches export
src/engines/migrationRunner.ts - Migration Runner → GCP Authentication: uses credentials
src/engines/migrationRunner.ts - Migration Runner → Resource Discovery: uses API client
src/engines/migrationRunner.ts - Migration Runner → Identity Mapping: maps identities
src/engines/migrationRunner.ts - Migration Runner → Migration Checkpoints: saves progress
src/engines/migrationRunner.ts - Agent Migrator → Resource Discovery: uses API client
src/engines/agentMigrator.ts - Agent Migrator → Identity Mapping: maps owners
src/engines/agentMigrator.ts - Skill Migrator → Identity Mapping: maps owners
src/engines/skillMigrator.ts - Session Migrator → GCP Authentication: obtains tokens
src/engines/sessionMigrator.ts - Session Migrator → Identity Mapping: maps identities
src/engines/sessionMigrator.ts - Memory Migrator → GCP Authentication: uses credentials
src/engines/memoryMigrator.ts - Memory Migrator → Resource Discovery: uses API client
src/engines/memoryMigrator.ts - Memory Migrator → Identity Mapping: maps users
src/engines/memoryMigrator.ts - Artifact Export → GCP Authentication: uses credentials
src/engines/artifactExtractor.ts - Artifact Export → Session Migrator: extracts session data
src/engines/artifactExtractor.ts - GCP Authentication → Google Cloud APIs: requests tokens
src/services/gcpAuth.ts - Resource Discovery → Google Cloud APIs: calls Discovery APIs
README.md - User Reports → GCP Authentication: uses credentials
src/engines/userReportGenerator.ts - User Reports → Resource Discovery: queries resources
src/engines/userReportGenerator.ts - User Reports → Report Service: formats reports