Files
winning-wallet-finder_github/recorder/bootstrap_parquet.py
T
jaxperro 5c8ee5961b stage-0 warehouse: recorder folds its own tape to parquet; Mac mirrors every 15 min
The nightly Mac-coupled bulk ingest was the fragile link (today: Mac slept
through 08:00, the pipeline started 09:31, and the sftp bulk pull wedged in
timeout cascades holding the db lock — digest blocked behind it). Stage 0
moves the fold onto the box and reduces the Mac to an incremental mirror:

- recorder/fold.py (sidecar, capture stays PID 1): closed gz segments ->
  zstd parquet /data/parquet/<fam>/date=*/segment.parquet, row-parity
  verified, manifest-logged, THEN gz deleted. Deletion invariant STRONGER:
  raw needs a verified parquet; parquet needs a Mac ACK before the disk
  guard may prune it. duckdb capped 384MB; VM 256MB -> 1GB.
- recorder/sync_tape.py (com.jaxperro.tape-sync every 15 min + daily.sh):
  manifest-driven incremental sftp pull, per-file row verify, append into
  rtds.duckdb NATIVE tables (views-over-parquet rejected: sim's per-asset
  point queries would crawl), segment-keyed idempotence shared with the
  legacy ingest.py (kept as fallback), ack back to the box.
- recorder/bootstrap_parquet.py: pre-fold history exported to the mirror,
  parity OK (13.84M trades + 3.07M aux). live/parquet/ is now the complete
  durable layer Stage 1 (MotherDuck/ClickHouse) would consume.
- research/tape.py connect(): brief retry — the 15-min sync holds the
  write lock for seconds.

First run: backlog folded in <60s on the box, 36/36 files mirrored+
verified, rtds.duckdb 13.8M -> 18.2M trades, tape age 24h+ -> ~15-45 min.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 12:46:54 -04:00

54 lines
2.3 KiB
Python

#!/usr/bin/env python3
"""One-shot Stage-0 bootstrap: export the history that exists ONLY in
live/rtds.duckdb (segments already deleted on the box) into the parquet
mirror, so live/parquet/ becomes the complete durable warehouse layer from
day one. Partitioned like fold.py's output (date=YYYY-MM-DD, UTC from ts),
one bootstrap_<date>.parquet per family per day. Idempotent: skips files
that already exist. Run once after the last bulk ingest; verify counts."""
import os
import sys
HERE = os.path.dirname(os.path.abspath(__file__))
LIVE = os.path.join(HERE, "..", "live")
DB = os.path.join(LIVE, "rtds.duckdb")
MIRROR = os.path.join(LIVE, "parquet")
def main():
import duckdb
con = duckdb.connect(DB, read_only=True)
total = {"trades": 0, "aux": 0}
for fam, cols in (("trades", "ts, wallet, asset, cond, side, price, size, tx, title"),
("aux", "ts, topic, type, payload")):
days = [d for (d,) in con.execute(
f"SELECT DISTINCT strftime(to_timestamp(ts), '%Y-%m-%d') FROM {fam} "
f"WHERE ts IS NOT NULL ORDER BY 1").fetchall()]
for day in days:
outdir = os.path.join(MIRROR, fam, f"date={day}")
os.makedirs(outdir, exist_ok=True)
out = os.path.join(outdir, f"bootstrap_{day.replace('-', '')}.parquet")
if os.path.exists(out):
print(f"[bootstrap] {fam} {day}: exists — skip")
continue
con.execute(f"""COPY (SELECT {cols} FROM {fam}
WHERE strftime(to_timestamp(ts), '%Y-%m-%d') = '{day}')
TO '{out}' (FORMAT PARQUET, COMPRESSION ZSTD)""")
n, = con.execute(
f"SELECT count(*) FROM read_parquet('{out}')").fetchone()
total[fam] += n
print(f"[bootstrap] {fam} {day}: {n:,} rows "
f"({os.path.getsize(out)//2**20}MB)")
for fam in ("trades", "aux"):
db_n, = con.execute(f"SELECT count(*) FROM {fam}").fetchone()
pq_n, = con.execute(f"""SELECT count(*) FROM
read_parquet('{os.path.join(MIRROR, fam)}/*/*.parquet')""").fetchone()
ok = "OK" if db_n == pq_n else "MISMATCH"
print(f"[bootstrap] parity {fam}: db {db_n:,} vs mirror {pq_n:,}{ok}")
if db_n != pq_n:
return 1
return 0
if __name__ == "__main__":
sys.exit(main())