migration-framework

Migration Framework

Standard Integration Schema

The intermediate JSON format that all platform parsers produce. See references/standard-integration-schema.md.

Key sections:

• metadata — Source platform, confidence score, migration notes
• integration — Name, description, systems summary
• flows — Trigger type, step sequence with operations
• api_profiles — Request/response field definitions with nesting structure
• systems — Source and destination with connection details
• data_transformations — Field mappings and transformation functions
• scripts — Groovy scripts with full source code for TypeScript translation
• error_handling — Strategy (retry, fail, ignore)
• config_variables — Overrideable configuration values
• migration_notes — Manual review items, unsupported features

Schema-to-Spec Mapping

The schema-to-answers script maps schema fields to the integration YAML spec items. See references/schema-to-requirements-mapping.md.

Pre-populated (from parsed export — confirmed by user via proposal):

• systems, trigger_type, schedule_value, data_flow
• source_system, destination_system
• transformations, error_handler_type, error_retry_*
• additional_requirements (includes Groovy scripts for translation)

Left for live discovery (requires platform interaction):

• source_component, destination_component — live registry search
• *_connection_type, *_connection — live connection search + user decision
• flow_count, flow_definitions — confirmed by user

Confidence Scoring

Per-element confidence:

• high (0.8-1.0): Direct 1:1 mapping, deterministic
• medium (0.5-0.79): Requires interpretation or custom code
• low (0.0-0.49): No direct equivalent, manual design needed

Overall = weighted average. Drives reviewer focus.

Migration-Aware Code Generation

When migration-schema.json exists in the session, code-plan emits <migration-context>:

• api_profiles — exact field names and nesting paths. Use these, don't invent field names.
• script_translations — full Groovy source with input/output contracts. Translate completely.
• field_mappings — source→destination field mappings from transformations.
• endpoints — known API paths with confidence scores.

See references/migration-code-gen-guide.md for translation patterns.

Key References

• references/standard-integration-schema.md — Full schema definition with examples
• references/schema-to-requirements-mapping.md — Spec item ID mapping
• references/migration-code-gen-guide.md — API profiles, script translation, field mapping patterns