gabriel / musehub public
backfill_genesis_ops.py python
89 lines 3.1 KB
Raw
sha256:34035d72cef530c1ab9d6a6f53be18d803dde705fc3157617d70352a96d0747b Merge branch 'fix/wire-push-external-parent-manifest' into dev Human 8 days ago
1 #!/usr/bin/env python3
2 """One-time backfill: set op='add' on the oldest history entry for every symbol
3 that was incorrectly recorded as 'modify' due to genesis commits lacking a
4 structured_delta.
5
6 Background
7 ----------
8 Prior to the structured_delta genesis fix in muse, the first commit in a repo
9 (no parent) never computed a plugin.diff(), leaving structured_delta=None.
10 The MuseHub indexer only saw a symbol for the first time in the *second* commit
11 that touched it — which recorded op='modify' (replace) instead of op='add'
12 (insert). This means the provenance timeline shows 'MODIFY' at the bottom
13 instead of 'ADD', and epoch 0 has no birth diff.
14
15 This script corrects that by finding the oldest history entry per symbol and
16 setting op='add' when it is not already 'add'.
17
18 Usage
19 -----
20 # Dry-run: count rows that would be changed (no writes)
21 docker exec musehub-blue python3 /app/deploy/backfill_genesis_ops.py --dry-run
22
23 # Run for all repos
24 docker exec musehub-blue python3 /app/deploy/backfill_genesis_ops.py
25
26 # Run for a single repo
27 docker exec musehub-blue python3 /app/deploy/backfill_genesis_ops.py --repo-id <repo_id>
28
29 # Quiet (no progress output)
30 docker exec musehub-blue python3 /app/deploy/backfill_genesis_ops.py -q
31 """
32 from __future__ import annotations
33
34 import argparse
35 import asyncio
36 import sys
37 import time
38
39 import sqlalchemy as sa
40 from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
41 from sqlalchemy.orm import sessionmaker
42
43 sys.path.insert(0, "/app")
44 sys.path.insert(0, "/tmp/devpkgs")
45
46 from musehub.db.database import get_database_url
47 from musehub.services.musehub_symbol_indexer import backfill_genesis_ops
48
49
50 async def run(dry_run: bool, quiet: bool, repo_id: str | None) -> int:
51 engine = create_async_engine(get_database_url(), echo=False)
52 Session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
53
54 async with Session() as session:
55 if not quiet:
56 scope = f"repo {repo_id}" if repo_id else "all repos"
57 mode = "[DRY RUN] " if dry_run else ""
58 print(f"{mode}Scanning {scope} for birth entries with op != 'add' …")
59
60 t0 = time.monotonic()
61 count = await backfill_genesis_ops(session, repo_id=repo_id, dry_run=dry_run)
62
63 if not dry_run:
64 await session.commit()
65
66 elapsed = time.monotonic() - t0
67
68 if dry_run:
69 print(f"Would update {count} birth entr{'y' if count == 1 else 'ies'} ({elapsed:.1f}s)")
70 else:
71 print(f"Updated {count} birth entr{'y' if count == 1 else 'ies'} ({elapsed:.1f}s)")
72
73 await engine.dispose()
74 return count
75
76
77 def main() -> None:
78 p = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
79 p.add_argument("--dry-run", action="store_true", help="Count rows without writing")
80 p.add_argument("--repo-id", metavar="REPO_ID", help="Limit to a single repo")
81 p.add_argument("-q", "--quiet", action="store_true", help="Suppress progress output")
82 args = p.parse_args()
83
84 count = asyncio.run(run(dry_run=args.dry_run, quiet=args.quiet, repo_id=args.repo_id))
85 sys.exit(0 if count >= 0 else 1)
86
87
88 if __name__ == "__main__":
89 main()
File History 14 commits
sha256:34035d72cef530c1ab9d6a6f53be18d803dde705fc3157617d70352a96d0747b Merge branch 'fix/wire-push-external-parent-manifest' into dev Human 8 days ago
sha256:fc04e4cae9e1774d6a21b65c45daeed0e6787eb581d13aa1b03bfe9384a34226 Merge branch 'fix/two-column-scroll-layout' into dev Human 8 days ago
sha256:408916fc5973ba59c6e4eebaa80ebdcc801c0a63205651e25009d11548f79454 chore: bump version to 0.2.0.dev2 — nightly.2, matching muse Sonnet 4.6 patch 11 days ago
sha256:d035733f21ccff27735fddebfbbe0ed24565a32a22db8de5885402262671ecd2 chore: bump version to 0.2.0rc15 for musehub#113 fix release Sonnet 4.6 patch 14 days ago
sha256:0032d6cfa33bc3c8367436ad768e7dd0e339b4332153160247da8266cb5fa352 Merge branch 'task/version-tags-phase3-server' into dev Human 17 days ago
sha256:4669620efda9ff41c55bdefd1f7bfe1c239d468428744c84ead9957e5a003a53 merge: rescue snapshot-recovery hardening (c00aa21d) into d… Opus 4.8 minor 29 days ago
sha256:a59da49c4611b970fc4b6ae48678ce4943261c213a07ddbd73ce9201df869b4a fix: remove false-positive proposal_comments index drop fro… Sonnet 4.6 patch 33 days ago
sha256:0a240d6dbff234f07d98a28a4a9a68db702f3f9ff9260196f24219bdb1c0b6f3 feat: render markdown mists as HTML with heading anchor links Sonnet 4.6 patch 34 days ago
sha256:24a7d47486ebc4ebd1832830580e177ec6f877b48dced8c000e198cdec4ce9d6 Merge 'task/bump-version-rc12' into 'dev' — proposal: Bump … Human 35 days ago
sha256:b9ff931d147e0114a1f17060f415b89ed551c170a91ff226c70437aa5c85f9ee Merge 'task/bump-version-rc12' into 'dev' — proposal: Bump … Human 35 days ago
sha256:d1122d21e73471879b460037b22c0b50fded7c423444a176f248428f75dac39c Merge 'task/fix-issue-pagination-cursor' into 'dev' — propo… Human 35 days ago
sha256:01e18975e73d2b3cd5b6db7929c895bef9aa6e0d4391dc5b2adfc548b41318dd Merge 'feat/adding-debug-logs-to-staging' into 'dev' — prop… Human 35 days ago
sha256:6b1949fc2797ca4c1936a637a4cbfec828ef56cf52398a2e74ca3c4f494e728f fix: use wire_bytes not mpack_bytes_raw in compute_object_b… Sonnet 4.6 patch 48 days ago
sha256:b99f2455dc346966d040133f5203297e6e3ef5803a93728a2c30568d0a0f7583 rename: delta_add → delta_upsert across wire format, models… Sonnet 4.6 patch 50 days ago