WIP snapshot before drive cleanup 2026-10-03

This commit is contained in:
George Lambert 2026-10-03 23:02:02 -04:00
commit e666e7bf3c

View file

@ -0,0 +1,89 @@
# libSQL migrator dry-run (WP-K) — PASS
**Date:** 2026-10-03T06:24–06:26Z
**Host:** NS1 `70.88.205.138` (`NS1.GEORGELAMBERT.ORG`)
**Role:** Engineer (safe dry-run only)
**Result:** **PASS**
## Constraints honored
- Did **not** modify `/var/lib/timestamping-svc/data/blockchain.db` or any Go timestamping DB (stat-only; mtime 2026-09-25).
- Did **not** set `BUSINESS_STORE=libsql` (or any `LIBSQL_*`) on `zappier-edge.service`.
- Did **not** delete/truncate live `/opt/verae/zappier-edge/billing.db`.
- All migrator I/O under `/tmp/libsql-dryrun-20261003T062452Z/` copies only.
## Workspace
| Item | Path |
|------|------|
| Dry-run dir | `/tmp/libsql-dryrun-20261003T062452Z/` |
| Source copy | `…/source-billing.db` (90112 bytes) |
| Dest libSQL file | `…/dest.db` (`file:/tmp/libsql-dryrun-20261003T062452Z/dest.db`, 94208 bytes) |
| Migrator | `/opt/verae/zappier-edge/dist/db/migrate-to-libsql.js` (same content/mtime as `/tmp/zappier-edge-work`) |
| Runner | `…/run-migrate.mjs` (uses opt `node_modules`; chdir to `/opt/verae/zappier-edge`) |
| JSON report | `…/migrate-report.json` |
`/tmp/zappier-edge-work` had no `node_modules`; used live opt install for `@libsql/client` + `better-sqlite3`. Migrator source identical in both trees.
## Commands
```bash
# 1) Checkpoint + consistent copy (as verae-zapier → /tmp dry-run dir)
sudo -u verae-zapier sqlite3 /opt/verae/zappier-edge/billing.db "PRAGMA wal_checkpoint(TRUNCATE);"
# → 0|0|0
sudo chmod 777 /tmp/libsql-dryrun-20261003T062452Z
sudo -u verae-zapier python3 -c "import sqlite3; s=sqlite3.connect(\"/opt/verae/zappier-edge/billing.db\"); d=sqlite3.connect(\"/tmp/libsql-dryrun-20261003T062452Z/source-billing.db\"); s.backup(d); d.close(); s.close()"
sudo chown marchon:marchon /tmp/libsql-dryrun-20261003T062452Z/source-billing.db
# 2) Run migrator (node ESM runner → migrateBillingDbToLibsql)
cd /opt/verae/zappier-edge
node /tmp/libsql-dryrun-20261003T062452Z/run-migrate.mjs
```
## Row counts
| Table | Live billing.db | Source copy | Dest libSQL | Match |
|-------|-----------------|-------------|-------------|-------|
| customers | 4 | 4 | 4 | yes |
| usage_entries | 6 | 6 | 6 | yes |
| channel_rates | 108 | 108 | 108 | yes |
| channel_rate_meta | 1 | 1 | 1 | yes |
| tiers | 3 | 3 | 3 | yes |
| price_endpoints | 11 | 11 | 11 | yes |
| invoices | 0 | 0 | 0 | yes |
| invoice_lines | 0 | 0 | 0 | yes |
Customers on dest: `cust-platform`, `cust_1`, `cust_2`, `cust_3`.
## Chain / tip hashes
| Phase | ok | length | tipHash |
|-------|----|--------|---------|
| before (source copy via `verifyUsageLedgerChain`) | true | 6 | `8d58a2986f46a9775712354234d44075eea1257226f93f9fb33a19b444ddebd5` |
| after (dest via `LibsqlBusinessStore.verifyUsageChain`) | true | 6 | `8d58a2986f46a9775712354234d44075eea1257226f93f9fb33a19b444ddebd5` |
| live billing.db (post-run read) | — | 6 | `8d58a2986f46a9775712354234d44075eea1257226f93f9fb33a19b444ddebd5` |
Genesis `prev_hash` = 64 zeros; tip id = 6. Before tip === after tip; lengths match.
## Dual-run / safety post-checks
| Check | Result |
|-------|--------|
| `sourcePreserved: true` (migrator report) | PASS |
| Source copy still 90112 bytes after migrate | PASS |
| Live `billing.db` still 90112 bytes; counts 4/6; same tip | PASS |
| `BUSINESS_STORE` / `LIBSQL_*` absent from unit + not applied | PASS |
| zappier-edge `/health` still 200 | PASS |
| blockchain.db untouched (mtime 2026-09-25, ~31MB) | PASS |
| booksJson | `absent` (path not provided; stub skip) |
## Pass/fail
**PASS** — WP-K migrator dry-run on a WAL-checkpointed copy of live `billing.db` → `file:…/dest.db` succeeded with matching row counts and identical usage ledger tip hash. Live service remains on sqlite-file BusinessStore; no cutover.
## Non-goals (explicitly not done)
- No `BUSINESS_STORE=libsql` flip
- No rsync/deploy of edge
- No books.json prepaid import (schema stub)
- No JetStream / multi-host work