-- JSON sidecar copy (preserves relative paths)

-- `telemetry_manifest.json` placeholder written to destination

-optimized for Apple Photos / QuickTime compatibility, with sidecar JSON copy and a telemetry

-manifest placeholder for a future FIT sync pipeline.

-                                  Falls back to destination temp files if staging cannot be used

-- JSON sidecars copied 1:1 to destination

-- `telemetry_manifest.json` written to destination as a placeholder for a future FIT sync pipeline

-JSON_COPIED=0

-JSON_SKIPPED=0

-  - JSON sidecar files found in source are copied 1:1 to destination

-  - telemetry_manifest.json is created in destination as a placeholder contract

-  printf '| %-25s | %5s |\n' "JSON copied" "$JSON_COPIED"

-  printf '| %-25s | %5s |\n' "JSON skipped" "$JSON_SKIPPED"

-copy_one_json() {

-  local json_file="$1"

-  local rel_json dst_json dst_dir

-

-  rel_json="$(rel_path_from_source "$json_file")"

-  dst_json="$DEST_DIR/$rel_json"

-  dst_dir="$(dirname "$dst_json")"

-

-  mkdir -p "$dst_dir"

-

-  if [[ -f "$dst_json" && "$OVERWRITE" != true ]]; then

-    JSON_SKIPPED=$((JSON_SKIPPED + 1))

-    vlog_msg "SKIP" "JSON exists: $dst_json"

-    return

-  fi

-

-  if [[ "$DRY_RUN" == true ]]; then

-    JSON_COPIED=$((JSON_COPIED + 1))

-    log_msg "DRY-RUN" "Would copy JSON: $json_file -> $dst_json"

-    return

-  fi

-

-  if cp -f "$json_file" "$dst_json"; then

-    touch -r "$json_file" "$dst_json" || true

-    JSON_COPIED=$((JSON_COPIED + 1))

-    vlog_msg "INFO" "Copied JSON: $dst_json"

-  else

-    ERRORS=$((ERRORS + 1))

-    log_msg "ERROR" "Failed to copy JSON: $json_file"

-  fi

-}

-

-copy_sidecars_json() {

-  local json_files=()

-

-  if [[ -n "$SINGLE_FILE" ]]; then

-    local single_abs rel_path candidate

-    single_abs="$(to_abs_path "$SINGLE_FILE")"

-    rel_path="$(rel_path_from_source "$single_abs")"

-    candidate="$SOURCE_DIR/${rel_path%.*}.json"

-    if [[ -f "$candidate" ]]; then

-      json_files+=("$candidate")

-    fi

-  else

-    while IFS= read -r -d '' jf; do

-      json_files+=("$jf")

-    done < <(

-      if [[ "$RECURSIVE" == true ]]; then

-        find "$SOURCE_DIR" -path "$DEST_DIR" -prune -o -type f -iname '*.json' -print0

-      else

-        find "$SOURCE_DIR" -maxdepth 1 -type f -iname '*.json' -print0

-      fi

-    )

-  fi

-

-  if [[ ${#json_files[@]} -eq 0 ]]; then

-    vlog_msg "INFO" "No JSON sidecars found to copy"

-    return

-  fi

-

-  local jf

-  for jf in "${json_files[@]}"; do

-    if is_apple_noise_file "$jf"; then

-      vlog_msg "SKIP" "Ignoring Apple artifact JSON: $jf"

-      continue

-    fi

-    copy_one_json "$jf"

-  done

-}

-

-write_manifest() {

-  local manifest_path="$DEST_DIR/telemetry_manifest.json"

-

-  if [[ -f "$manifest_path" && "$OVERWRITE" != true ]]; then

-    vlog_msg "SKIP" "Manifest exists: $manifest_path"

-    return

-  fi

-

-  if [[ "$DRY_RUN" == true ]]; then

-    log_msg "DRY-RUN" "Would write manifest: $manifest_path"

-    return

-  fi

-

-  mkdir -p "$DEST_DIR"

-

-  cat > "$manifest_path" <<EOF

-{

-  "schema_version": "0.1-draft",

-  "purpose": "placeholder contract for future FIT-to-sidecar sync pipeline",

-  "fields_target": [

-    "power_w",

-    "speed_kmh",

-    "heart_rate_bpm",

-    "cadence_rpm",

-    "gps"

-  ],

-  "sync_methods": [

-    "auto_timestamp_plus_offset",

-    "manual_offset_ms"

-  ],

-  "notes": "Current release copies existing JSON sidecars only; FIT parsing is not implemented yet."

-}

-EOF

-

-  vlog_msg "INFO" "Wrote manifest: $manifest_path"

-}

-

-    log_msg "INFO" "Skipping sidecar copy and manifest because debug timing mode requested early stop"

-    log_msg "INFO" "Skipping sidecar copy and manifest because run was stopped by user"

-    copy_sidecars_json

-    write_manifest

-    log_msg "INFO" "Skipping sidecar copy and manifest because encoding ended with errors"