Migrate an AnalysisSpecification v1 object to v2 — migrate_analysis

Migration is deliberately explicit. A v1 target-only object lacks target direction, and a v1 manual-component object lacks both target intent and proposal-decision provenance. Callers must supply those missing declarations; this function never fabricates them or silently drops the legacy component.

Usage

migrate_analysis_specification(
  spec,
  target = "2.0.0",
  target_field = NULL,
  target_type = NULL,
  reference_level = NULL,
  comparison_level = NULL,
  ordered_levels = character(0L),
  continuous_direction = NULL,
  proposal_digest = NULL,
  proposal_decision = NULL,
  analyst_rationale = NULL
)

Arguments

spec: serialized or in-memory AnalysisSpecification v1 object
target: target schema version; currently only "2.0.0"
target_field: explicit target field when absent from the v1 object
target_type: "binary", "ordered", or "continuous"
reference_level, comparison_level: binary target direction
ordered_levels: ordered target direction
continuous_direction: continuous target direction
proposal_digest: optional digest of an existing ranked proposal; required when migrating a legacy manual component
proposal_decision: "accepted" or "overridden"
analyst_rationale: non-empty analyst rationale for a legacy component

Value

a validated v2 AnalysisSpecification