migration.yml

# migration.yml — the migration lifecycle tracker for data-lectures.
#
# One record per dataset moving into this repo, holding the PROCESS facts the
# manifests deliberately do not: which PRs landed the file, which PRs repointed
# each consumer, and where the dataset sits in the lifecycle. Manifests
# (lectures/*.yml) are the permanent record of a dataset; this file documents
# a transition and can be archived once the migration programme completes,
# without touching a single manifest.
#
# The audit dashboard (scripts/build_audit.py) renders this file and VERIFIES
# it against reality on every build: a dataset marked `repointed` whose
# consumers still read an old URL (or vice versa) fails the consistency check.
#
# Lifecycle (status):
#   pending    identified for migration; nothing landed here yet
#   landed     file + manifest merged in data-lectures; consumers unchanged
#   repointed  every consumer reads this repo's raw URL directly
#   final      every consumer code read resolves through qeld.url(), with the
#              PLAN-QELD-PACKAGE.md section 4.1 carve-outs terminal on the direct
#              form. (Redefined 2026-08-12, D11 — this status previously meant the
#              data.quantecon.org address, a cutover retired in favor of qeld;
#              see data-lectures#37 and #15. The audit learns the qeld pattern
#              in Q1, before any consumer adopts it.)

datasets:
  lingcod_msy_recovery.csv:
    pilot: P1
    status: repointed
    prior_pattern: local-path
    landed:
      pr: QuantEcon/data-lectures#12
      date: 2026-07-15
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#792
        date: 2026-07-17
    cutover: null

  realwage.csv:
    pilot: P2
    status: repointed
    prior_pattern: legacy
    landed:
      pr: QuantEcon/data-lectures#17
      date: 2026-07-17
    repoints:
      - repo: QuantEcon/lecture-python-programming
        pr: QuantEcon/lecture-python-programming#578
        date: 2026-07-17
      - repo: QuantEcon/lecture-python.myst
        pr: QuantEcon/lecture-python.myst#973
        date: 2026-07-17
    cutover: null

  countries.csv:
    pilot: P2
    status: repointed
    prior_pattern: legacy
    landed:
      pr: QuantEcon/data-lectures#17
      date: 2026-07-17
    repoints:
      - repo: QuantEcon/lecture-python-programming
        pr: QuantEcon/lecture-python-programming#578
        date: 2026-07-17
      - repo: QuantEcon/lecture-python.myst
        pr: QuantEcon/lecture-python.myst#973
        date: 2026-07-17
    cutover: null

  employ.csv:
    pilot: P2
    status: repointed
    prior_pattern: legacy   # programming read the legacy repo; python.myst its own copy
    landed:
      pr: QuantEcon/data-lectures#17
      date: 2026-07-17
    repoints:
      - repo: QuantEcon/lecture-python-programming
        pr: QuantEcon/lecture-python-programming#578
        date: 2026-07-17
      - repo: QuantEcon/lecture-python.myst
        pr: QuantEcon/lecture-python.myst#973
        date: 2026-07-17
    cutover: null

  ames_house_prices.csv:
    pilot: P5
    status: repointed
    # A new dataset, not a migration: these bytes have never lived in a lecture
    # repo, so there is no prior pattern to move away from. It landed together
    # with its consuming lecture, which is new and read the interim raw URL
    # from its first commit.
    prior_pattern: none
    landed:
      pr: QuantEcon/data-lectures#27
      date: 2026-08-03
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#811
        date: 2026-08-03
    cutover: null

  japan_deaths_by_age.csv:
    pilot: P5
    status: repointed
    prior_pattern: none
    landed:
      pr: QuantEcon/data-lectures#27
      date: 2026-08-03
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#811
        date: 2026-08-03
    cutover: null

  us_adult_heights.csv:
    pilot: P5
    status: repointed
    # Migrated out of lecture-python-intro, where it was added by #790 with no
    # committed builder. The builder was recovered during this migration and
    # reproduces the file byte for byte, so it lands as `committed` rather than
    # the `unrecovered` state Phase 9 tracks.
    prior_pattern: local-path
    landed:
      pr: QuantEcon/data-lectures#27
      date: 2026-08-03
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#811
        date: 2026-08-03
    cutover: null

  epl_match_goals.csv:
    pilot: P5
    status: repointed
    # New dataset with no prior life in a lecture repo, landed ahead of the
    # lecture that reads it.
    prior_pattern: none
    landed:
      pr: QuantEcon/data-lectures#31
      date: 2026-08-03
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#814
        date: 2026-08-04
    cutover: null

  japan_earthquakes.csv:
    pilot: P5
    status: repointed
    prior_pattern: none
    landed:
      pr: QuantEcon/data-lectures#31
      date: 2026-08-03
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#814
        date: 2026-08-04
    cutover: null

  japan_population_by_age.csv:
    pilot: P5
    status: repointed
    # Migrated out of lecture-python-intro, which held an e-Stat export with no
    # recorded provenance. Rebuilt from the same table at its publisher, the
    # Statistics Bureau, whose copy has a stable URL; the figures are identical,
    # so the repoint left lecture output unchanged.
    prior_pattern: local-path
    landed:
      pr: QuantEcon/data-lectures#33
      date: 2026-08-04
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#821
        date: 2026-08-04
    cutover: null

  # ---------------------------------------------------------------------------
  # Track A, the intro static batch -- landed in the Feb 2025 migration
  # (data#5-#7) but never repointed, which is the gap #4 recorded. Manifests
  # written 2026-08-06; each flips to `repointed` when its intro + wasm PR set
  # merges. Every one of these has TWO consuming repos, so all consumers move
  # together (PLAN, "Repoint rules").
  # ---------------------------------------------------------------------------

  mpd2020.xlsx:
    pilot: A1
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#5
      date: 2025-02-14
    # Two consuming repos, moved together: intro's copy could not be deleted
    # while wasm fetched that exact blob by URL (PLAN, "Repoint rules" 1).
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#823
        date: 2026-08-06
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#52
        date: 2026-08-06
    cutover: null

  longprices.xls:
    pilot: A2
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#5
      date: 2025-02-14
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#824
        date: 2026-08-06
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#53
        date: 2026-08-06
    cutover: null

  chapter_3.xlsx:
    pilot: A2
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#5
      date: 2025-02-14
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#824
        date: 2026-08-06
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#53
        date: 2026-08-06
    cutover: null

  assignat.xlsx:
    pilot: A3
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#5
      date: 2025-02-14
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#826
        date: 2026-08-07
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#55
        date: 2026-08-07
    cutover: null

  dette.xlsx:
    pilot: A3
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#5
      date: 2025-02-14
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#826
        date: 2026-08-07
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#55
        date: 2026-08-07
    cutover: null

  fig_3.xlsx:
    pilot: A3
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#5
      date: 2025-02-14
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#826
        date: 2026-08-07
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#55
        date: 2026-08-07
    cutover: null

  caron.npy:
    pilot: A3
    status: repointed
    # Local-path read in intro (np.load('datasets/caron.npy')) -- one of the
    # two Colab-breaking reads this batch retires, the same failure mode P1
    # fixed for msy_fishery.
    prior_pattern: local-path
    landed:
      pr: QuantEcon/data-lectures#5
      date: 2025-02-14
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#826
        date: 2026-08-07
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#55
        date: 2026-08-07
    cutover: null

  nom_balances.npy:
    pilot: A3
    status: repointed
    prior_pattern: local-path
    landed:
      pr: QuantEcon/data-lectures#5
      date: 2025-02-14
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#826
        date: 2026-08-07
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#55
        date: 2026-08-07
    cutover: null

  # --- P3: the high_dim_data fold ----------------------------------------
  # COMPLETE 2026-08-11. Six datasets folded in from QuantEcon/high_dim_data,
  # which is now archived (never deleted) and still serving on both hosts.
  # `prior_pattern: external` is the audit's own label for these reads; the
  # human-readable text behind that label lives in render_audit.py and is
  # deliberately NOT quoted here — the copy that used to sit on this line
  # ("...via raw and media (LFS) hosts") outlived the string it quoted by one
  # PR (#70) and became a false record of a label nobody could grep for.
  #
  # They landed at `landed` with `repoints: []` and their manifests at
  # `consumers: []`, which was honest: no lecture read a data-lectures URL for
  # these until PR set C. The window between those repoints and the flip to
  # `repointed` is RED by design — build_audit fails on a landed dataset whose
  # consumers read this repo — so the flip is a same-day action. Measured on
  # this wave: `landed` exits 1 with 6 warnings, `repointed` exits 0. Dry-run
  # both directions before pushing a flip; that is the wave's acceptance test.
  #
  # They were LFS-tracked upstream and are plain git here, so every consuming
  # read had to change HOST as well as org and repo (repoint rule 6). 28 reads
  # across four repos: lecture-python-intro, lecture-wasm, lecture-intro.zh-cn
  # and test-actions-lecture-intro — the last two invisible to every audit run,
  # which is why all four consumers are recorded per manifest below rather than
  # only the two the scan can see.

  forbes-global2000.csv:
    pilot: P3
    status: repointed
    prior_pattern: external
    landed:
      pr: QuantEcon/data-lectures#62
      date: 2026-08-10
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#832
        date: 2026-08-11
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#60
        date: 2026-08-11
      - repo: QuantEcon/lecture-intro.zh-cn
        pr: QuantEcon/lecture-intro.zh-cn#292
        date: 2026-08-11
      - repo: QuantEcon/test-actions-lecture-intro
        pr: QuantEcon/test-actions-lecture-intro#53
        date: 2026-08-11
    cutover: null

  forbes-billionaires.csv:
    pilot: P3
    status: repointed
    prior_pattern: external
    landed:
      pr: QuantEcon/data-lectures#62
      date: 2026-08-10
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#832
        date: 2026-08-11
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#60
        date: 2026-08-11
      - repo: QuantEcon/lecture-intro.zh-cn
        pr: QuantEcon/lecture-intro.zh-cn#292
        date: 2026-08-11
      - repo: QuantEcon/test-actions-lecture-intro
        pr: QuantEcon/test-actions-lecture-intro#53
        date: 2026-08-11
    cutover: null

  cities_us.csv:
    pilot: P3
    status: repointed
    prior_pattern: external
    landed:
      pr: QuantEcon/data-lectures#62
      date: 2026-08-10
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#832
        date: 2026-08-11
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#60
        date: 2026-08-11
      - repo: QuantEcon/lecture-intro.zh-cn
        pr: QuantEcon/lecture-intro.zh-cn#292
        date: 2026-08-11
      - repo: QuantEcon/test-actions-lecture-intro
        pr: QuantEcon/test-actions-lecture-intro#53
        date: 2026-08-11
    cutover: null

  cities_brazil.csv:
    pilot: P3
    status: repointed
    prior_pattern: external
    landed:
      pr: QuantEcon/data-lectures#62
      date: 2026-08-10
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#832
        date: 2026-08-11
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#60
        date: 2026-08-11
      - repo: QuantEcon/lecture-intro.zh-cn
        pr: QuantEcon/lecture-intro.zh-cn#292
        date: 2026-08-11
      - repo: QuantEcon/test-actions-lecture-intro
        pr: QuantEcon/test-actions-lecture-intro#53
        date: 2026-08-11
    cutover: null

  SCF_plus_mini.csv:
    pilot: P3
    status: repointed
    prior_pattern: external
    landed:
      pr: QuantEcon/data-lectures#62
      date: 2026-08-10
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#832
        date: 2026-08-11
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#60
        date: 2026-08-11
      - repo: QuantEcon/lecture-intro.zh-cn
        pr: QuantEcon/lecture-intro.zh-cn#292
        date: 2026-08-11
      - repo: QuantEcon/test-actions-lecture-intro
        pr: QuantEcon/test-actions-lecture-intro#53
        date: 2026-08-11
    cutover: null

  SCF_plus_mini_no_weights.csv:
    pilot: P3
    status: repointed
    prior_pattern: external
    landed:
      pr: QuantEcon/data-lectures#62
      date: 2026-08-10
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#832
        date: 2026-08-11
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#60
        date: 2026-08-11
      - repo: QuantEcon/lecture-intro.zh-cn
        pr: QuantEcon/lecture-intro.zh-cn#292
        date: 2026-08-11
      - repo: QuantEcon/test-actions-lecture-intro
        pr: QuantEcon/test-actions-lecture-intro#53
        date: 2026-08-11
    cutover: null

  # --- A4: Track A's last two CSVs ---------------------------------------
  # The intro statics that were NOT part of the Feb 2025 migration, because
  # they sat under lectures/_static/lecture_specific/ rather than in the
  # datasets/ tree. Both are read by URL from intro's own copy, by FIVE
  # reference-holders each: intro, lecture-wasm, lecture-intro.zh-cn,
  # test-actions-lecture-intro, and the generated notebooks mirror. Only two
  # of those are in SCAN_REPOS, so a green audit here proves less than usual —
  # zh-cn and the canary are verified by hand.
  #
  # They land together at `landed`, with consumers unchanged. Track A's third
  # remaining item, graph.txt, is NOT here and never will be: it is synthetic
  # teaching data with null provenance, and its one URL reader is being given
  # an inline literal instead (PLAN, Track A).
  #
  # DELETION IS NOT PART OF THIS WAVE. Unlike P3, which deleted nothing, intro
  # holds the only live copy of both files — so the phase-2 split of rule 3
  # applies in full, and its gate is FOUR publishes, not one: intro, wasm
  # (automatic), lecture-intro.zh-cn and the canary. Merging zh-cn's sync PR
  # changes its `main`, not its published site.

  life-expectancy-vs-gdp-per-capita.csv:
    pilot: A4
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#74
      date: 2026-08-12
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#834
        date: 2026-08-12
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#61
        date: 2026-08-12
      - repo: QuantEcon/lecture-intro.zh-cn
        pr: QuantEcon/lecture-intro.zh-cn#294
        date: 2026-08-12
      - repo: QuantEcon/test-actions-lecture-intro
        pr: QuantEcon/test-actions-lecture-intro#56
        date: 2026-08-12
    cutover: null

  usa-gini-nwealth-tincome-lincome.csv:
    pilot: A4
    status: repointed
    # Second-order: built from SCF_plus_mini.csv, which landed in #62. That
    # dependency is why this file waited for P3 rather than moving with the
    # other intro statics.
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#74
      date: 2026-08-12
    repoints:
      - repo: QuantEcon/lecture-python-intro
        pr: QuantEcon/lecture-python-intro#834
        date: 2026-08-12
      - repo: QuantEcon/lecture-wasm
        pr: QuantEcon/lecture-wasm#61
        date: 2026-08-12
      - repo: QuantEcon/lecture-intro.zh-cn
        pr: QuantEcon/lecture-intro.zh-cn#294
        date: 2026-08-12
      - repo: QuantEcon/test-actions-lecture-intro
        pr: QuantEcon/test-actions-lecture-intro#56
        date: 2026-08-12
    cutover: null

  # --------------------------------------------------------------------------
  # Wave B1' — the lecture-python.myst block, part one (Track B).
  #
  # Five files, three lectures, all three URL forms. Track B was planned as
  # three waves and re-cut to two on 2026-08-13: a `publish*` tag rebuilds the
  # whole book, so wave size does not change publish cost — only the NUMBER of
  # publishes does, and each wave costs two (python.myst and python.zh-cn).
  # The hansen_singleton pair follows as B2', separated by its builders, its
  # READMEs and an open translation-sync PR, not by novelty.
  #
  # All five carry `prior_pattern: own-repo` — the lectures fetch their own
  # repo's committed blobs. Consumers are recorded at the flip, and will
  # include lecture-python.zh-cn, which is OUTSIDE the audit's SCAN_REPOS and
  # so is recorded in the manifests or nowhere.
  # --------------------------------------------------------------------------

  maketable1.dta:
    pilot: B1
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#79
      date: 2026-08-13
    repoints:
      - repo: QuantEcon/lecture-python.myst
        pr: QuantEcon/lecture-python.myst#1034
        date: 2026-08-13
      - repo: QuantEcon/lecture-python.zh-cn
        pr: QuantEcon/lecture-python.zh-cn#249
        date: 2026-08-13
    cutover: null

  maketable2.dta:
    pilot: B1
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#79
      date: 2026-08-13
    repoints:
      - repo: QuantEcon/lecture-python.myst
        pr: QuantEcon/lecture-python.myst#1034
        date: 2026-08-13
      - repo: QuantEcon/lecture-python.zh-cn
        pr: QuantEcon/lecture-python.zh-cn#249
        date: 2026-08-13
    cutover: null

  maketable4.dta:
    pilot: B1
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#79
      date: 2026-08-13
    repoints:
      - repo: QuantEcon/lecture-python.myst
        pr: QuantEcon/lecture-python.myst#1034
        date: 2026-08-13
      - repo: QuantEcon/lecture-python.zh-cn
        pr: QuantEcon/lecture-python.zh-cn#249
        date: 2026-08-13
    cutover: null

  fp.dta:
    pilot: B1
    status: repointed
    # The one Track B file with a published-SITE prose link
    # (python.quantecon.org/_static/lecture_specific/mle/fp.dta) as well as a
    # code read. That link is also carried by lecture-stats, which runs a daily
    # linkcheck — so deletion is gated on the lecture-stats repoint, not only
    # on the two publishes.
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#79
      date: 2026-08-13
    repoints:
      - repo: QuantEcon/lecture-python.myst
        pr: QuantEcon/lecture-python.myst#1034
        date: 2026-08-13
      - repo: QuantEcon/lecture-python.zh-cn
        pr: QuantEcon/lecture-python.zh-cn#249
        date: 2026-08-13
      # Prose download link only — lecture-stats' code read points at the
      # archived QuantEcon/lecture-python blob, not at this repo.
      - repo: QuantEcon/lecture-stats
        pr: QuantEcon/lecture-stats#61
        date: 2026-08-13
    cutover: null

  NEWQDATA.csv:
    pilot: B1
    status: repointed
    # Reclassified at migration from the `verbatim` guess in
    # audit_annotations.yml: it is a container conversion of the authors'
    # NEWQDATA.MAT, and the conversion is recovered and committed at
    # builders/NEWQDATA.py. The only Track B file read via
    # raw.githubusercontent.com, and its URL is built by string concatenation
    # across three source lines — the repoint must collapse it, not patch the
    # stem line.
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#79
      date: 2026-08-13
    repoints:
      - repo: QuantEcon/lecture-python.myst
        pr: QuantEcon/lecture-python.myst#1034
        date: 2026-08-13
      - repo: QuantEcon/lecture-python.zh-cn
        pr: QuantEcon/lecture-python.zh-cn#249
        date: 2026-08-13
    cutover: null

  # --------------------------------------------------------------------------
  # Wave B2' — the lecture-python.myst block, part two (Track B). Two files,
  # two lectures, one URL form.
  #
  # The first wave in this migration to move BUILDERS as well as data. Both
  # were named make_data.py beside their output and collide in the flat
  # builders/ tree, so each takes its dataset's stem. That rename is what makes
  # this wave more coupled than B1' was: each lecture carries FIVE references,
  # not one — a prose link to the builder, three lines of a concatenated data
  # URL, and the builder's path named again in a docstring inside the data
  # cell. Only the URL is a code read; the other two break silently.
  #
  # Both carry `prior_pattern: own-repo`. Consumers are recorded at the flip,
  # and include lecture-python.zh-cn, which is OUTSIDE the audit's SCAN_REPOS
  # and so is recorded in the manifests or nowhere. lecture-stats holds no
  # reference to either file (swept 2026-08-13, exit 1) — unlike B1', it is not
  # a consumer here.
  #
  # 1982 is a bitwise strict subset of 1983 on an identical index. Recorded in
  # both manifests; consolidating them is a rename-class decision, deferred
  # with the rest under D6.
  # --------------------------------------------------------------------------

  hansen_singleton_1982_data.csv:
    pilot: B2
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#82
      date: 2026-08-13
    repoints:
      - repo: QuantEcon/lecture-python.myst
        pr: QuantEcon/lecture-python.myst#1036
        date: 2026-08-13
      - repo: QuantEcon/lecture-python.zh-cn
        pr: QuantEcon/lecture-python.zh-cn#250
        date: 2026-08-13
    cutover: null

  hansen_singleton_1983_data.csv:
    pilot: B2
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#82
      date: 2026-08-13
    repoints:
      - repo: QuantEcon/lecture-python.myst
        pr: QuantEcon/lecture-python.myst#1036
        date: 2026-08-13
      - repo: QuantEcon/lecture-python.zh-cn
        pr: QuantEcon/lecture-python.zh-cn#250
        date: 2026-08-13
    cutover: null

  # Wave C1 — the three lecture-python-advanced.myst datasets that needed no
  # rename decision. Landed and repointed 2026-08-17 (data first, always:
  # advanced.myst caches notebook execution, so the repointed cells re-execute
  # against whatever is on this repo's main at that moment).
  bbh_macro_quarterly.csv:
    pilot: C1
    status: repointed
    prior_pattern: local-path
    landed:
      pr: QuantEcon/data-lectures#92
      date: 2026-08-17
    repoints:
      - repo: QuantEcon/lecture-python-advanced.myst
        pr: QuantEcon/lecture-python-advanced.myst#372
        date: 2026-08-17
    cutover: null

  bbh_michigan_monthly.csv:
    pilot: C1
    status: repointed
    prior_pattern: local-path
    landed:
      pr: QuantEcon/data-lectures#92
      date: 2026-08-17
    repoints:
      - repo: QuantEcon/lecture-python-advanced.myst
        pr: QuantEcon/lecture-python-advanced.myst#372
        date: 2026-08-17
    cutover: null

  # Already read over an own-repo raw URL rather than a local path, so deleting
  # it from advanced.myst breaks readers at RUNTIME with no stale-serving grace
  # period. Repoint and publish before any deletion.
  hansen_jagannathan_1991_data.json:
    pilot: C1
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#92
      date: 2026-08-17
    repoints:
      - repo: QuantEcon/lecture-python-advanced.myst
        pr: QuantEcon/lecture-python-advanced.myst#372
        date: 2026-08-17
    cutover: null

  # Wave C2 — the three lecture-python-advanced.myst datasets that needed
  # decisions, all settled 2026-08-17 on QuantEcon/workspace-lectures#45:
  # renames deferred to the phase-2 review (QuantEcon/data-lectures#87), and
  # dataBHS.mat converts to dataBHS.csv (stem preserved).

  # Already read over an own-repo raw URL rather than a local path, so deleting
  # it from advanced.myst breaks readers at RUNTIME with no stale-serving grace
  # period. Repoint and publish before any deletion. The in-repo URL is split
  # across adjacent string literals with the `refs/heads/main` spelling —
  # sweep by basename, and do not copy the spelling into the repoint.
  fred_data.csv:
    pilot: C2
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#98
      date: 2026-08-18
    repoints:
      - repo: QuantEcon/lecture-python-advanced.myst
        pr: QuantEcon/lecture-python-advanced.myst#375
        date: 2026-08-18
    cutover: null

  acs_data_summary.csv:
    pilot: C2
    status: repointed
    prior_pattern: local-path
    landed:
      pr: QuantEcon/data-lectures#98
      date: 2026-08-18
    repoints:
      - repo: QuantEcon/lecture-python-advanced.myst
        pr: QuantEcon/lecture-python-advanced.myst#375
        date: 2026-08-18
    cutover: null

  # Lands as a FORMAT CONVERSION of advanced.myst's lectures/dataBHS.mat — a
  # bug fix, not tidying: the .mat sat outside html_static_path, so the
  # published site 404s it while the published notebook calls loadmat on it.
  # The audit keys on basenames, so until the repoint removes the .mat read,
  # scripts/audit_annotations.yml keeps its dataBHS.mat entry (the basenames
  # differ — dual_recorded cannot fire); the flip PR deletes it.
  dataBHS.csv:
    pilot: C2
    status: repointed
    prior_pattern: local-path
    landed:
      pr: QuantEcon/data-lectures#98
      date: 2026-08-18
    repoints:
      - repo: QuantEcon/lecture-python-advanced.myst
        pr: QuantEcon/lecture-python-advanced.myst#375
        date: 2026-08-18
    cutover: null

  # Track D — the one lecture-python-programming dataset, riding with C2 (its
  # rename is on the same phase-2 review). Was read over the SOURCE repo's raw
  # URL from pandas.md, polars.md AND the three synced translation repos
  # (.zh-cn/.fr/.fa); all four repos repointed 2026-08-18 (translations via
  # sync PRs, certified by basename sweep). The deletion gate that remains:
  # all four sites' PUBLISHED notebooks must be rebuilt from repointed source
  # before the source copy is deleted — published notebooks bake the URL of
  # their last publish, and the read is a live fetch at cell execution.
  test_pwt.csv:
    pilot: D
    status: repointed
    prior_pattern: own-repo
    landed:
      pr: QuantEcon/data-lectures#98
      date: 2026-08-18
    repoints:
      - repo: QuantEcon/lecture-python-programming
        pr: QuantEcon/lecture-python-programming#612
        date: 2026-08-18
    cutover: null

  # The dynamic-snapshot prototype. The BYTES have been in the published tree
  # since the 2026-07-16 flatten (#10; originally QuantEcon/data b857c5c,
  # 2025-02-16), but `landed` means file + manifest (see the lifecycle above),
  # and the manifest arrived with #109 — so that is the landing PR. No
  # consumer: intro's business_cycle still makes the live wbgapi call the
  # builder reproduces; whether it adopts the snapshot is the P4 decision.
  # Renamed from business_cycle_data.csv on 2026-09-07 under the naming policy
  # (#113), while `consumers` was still empty; no URL was ever read.
  gdp_growth_annual.csv:
    pilot: P4
    status: landed
    prior_pattern: null           # never read from anywhere — the lecture
                                  # fetches live (api pattern), so there is no
                                  # prior file read to migrate
    landed:
      pr: QuantEcon/data-lectures#109
      date: 2026-09-01
    repoints: []
    cutover: null

  # The rest of the business_cycle set (#114): two more World Bank tables from
  # the same builder, and the FRED half as one composite monthly file. Names
  # settled 2026-09-07 (#113). Consumer-to-be: lecture-wasm (lecture-wasm#70).
  unemployment_rate_annual.csv:
    pilot: P4
    status: landed
    prior_pattern: null
    landed:
      pr: QuantEcon/data-lectures#114
      date: 2026-09-01
    repoints: []
    cutover: null

  private_credit_to_gdp.csv:
    pilot: P4
    status: landed
    prior_pattern: null
    landed:
      pr: QuantEcon/data-lectures#114
      date: 2026-09-01
    repoints: []
    cutover: null

  us_business_cycle_monthly.csv:
    pilot: P4
    status: landed
    prior_pattern: null
    landed:
      pr: QuantEcon/data-lectures#114
      date: 2026-09-01
    repoints: []
    cutover: null

# Planned waves that have not landed anything here yet. `datasets` names the
# files as the audit sees them today, so the dashboard can join the two views.
# `title` is the reader-facing milestone name (the dashboard is read by people
# who are not doing the migration); `scope` carries the insider detail.
pending:
  - pilot: P4
    title: Maintained snapshots for lectures that fetch live API data
    scope: the dynamic-snapshot case — a maintained UNRATE twin for the incidental FRED consumers
    datasets: []          # produces a NEW file here; no existing static file moves
    tracking:
      - QuantEcon/meta#338

# Interim → final URL cutover (status: repointed → final) is tracked as one
# sweep, not per dataset: QuantEcon/data-lectures#15, gated on Phase 4 DNS.