Files
mantra-kmp/docs/scripts/curated-replay.py
Kgothatso Ngako d7d6f5a922 chore(scripts): a partial pick, and the seven deletes the FAB sweep needs
Two rules for the third pull. ca6c16be moves twenty screens onto one
ExtendedFab; seven of them -- the curated-list and group-identity screens
-- were taken out with lines B, D and H, so each is a modify/delete
conflict that resolves as "still deleted", the DELETE rule it already had
for one test file, now for a set. d2a4298d is half in line D and half in
a line Mantra kept: its Broadcast-all button on the entries screen is
gone here, but the sendToRelays it lifted into the broadcast view model's
companion, the RelayOutcomeLabel widget and the screen reading it are the
broadcast line Mantra holds. PARTIAL applies the diff restricted to the
kept paths, commits it under the original message and trailer, and writes
what was left out into the note, so the four shared files stay identical
to the fork's and the FAB commit lands on them cleanly.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 16:35:31 +02:00

185 lines
12 KiB
Python
Executable File

#!/usr/bin/env python3
"""Land rewritten Curated commits on a Mantra branch, one cherry-pick at a time.
The companion of curated-unbrand.py, and the second half of docs/curated-to-mantra.md's
pipeline as it was actually run; docs/curated-to-mantra-profiles.md is the second pull it
served, and added the one rule that pull needed. The rewrite (filter-branch with curated-unbrand.py as the
tree filter and a `Pulled-From: curated/curated@<sha>` trailer stamped by its message
filter) leaves a branch `tmp/curated-src` in Mantra's names; this replays commits off it
by their *original* sha, in the order you give, onto the current branch of <worktree>.
curated-replay.py pick <worktree> <orig-sha>... cherry-pick each, resolving by the rules below
curated-replay.py check <worktree> <orig-cut-sha> files differing from the rewritten cut
Resolutions are rules, and anything the rules do not cover stops the run with the commit
aborted, so a new conflict is a decision rather than a guess. What the rules encode:
* a branch join -- the first commit off one side of an upstream merge landing on top of
the other side -- is resolved by taking the join files exactly as upstream's own merge
left them (TAKE_FROM). Not a union: a union orders the two appended blocks its own way,
and every later commit that edits the block then misses its base and its deletions
silently fail.
* files whose lines are unique by construction (string keys, imports, route
registrations, table rows) get a line-set three-way merge over diff3 hunks (UNION):
ours, minus what theirs deleted from base, plus what theirs added that the file does
not already hold anywhere.
* the library pin follows the commit being replayed (PIN), because each upstream commit
compiled against the pin it recorded; `5efeae76` named a branch commit that no longer
exists and is mapped to the master commit with the identical tree.
* a handful of (commit, file) pairs where one side simply wins (THEIRS, DELETE), each
with the reason written into the commit. DELETE is also how a sweep over screens
lands on a tree that no longer has some of them: the modify/delete conflict on each
removed screen resolves as "still deleted".
* a commit of which Mantra wants only some files (PARTIAL): the diff restricted to those
paths is applied and committed under the original message, and the note names what
was left out. For a commit half in a removed line and half in a kept one.
Every resolution is appended to the landed commit's message as a paragraph, ahead of the
trailers, so the branch explains itself.
"""
import os, re, subprocess, sys
STRINGS = 'composeApp/src/commonMain/composeResources/values/strings.xml'
NAVHOST = 'composeApp/src/commonMain/kotlin/press/mantra/compose/ui/composable/navigation/MantraNavHost.kt'
UI = 'composeApp/src/commonMain/kotlin/press/mantra/compose/ui/composable/'
GITLINK = 'lightning-kmp-app'
UNION = {STRINGS, NAVHOST, 'docs/README.md'}
PIN = {
'366b0177': '59c11ed926ac05c820b98afb4cc961a5a3506310', # the nsec line was written against 59c11ed's NostrKeyManager
'5efeae76': '84cc44c855e3d173e26016b807c449153a3af597', # upstream: 01962f3, a rebased-away branch commit with this tree
'00c36ec5': '84cc44c855e3d173e26016b807c449153a3af597',
}
TAKE_FROM = { # (orig, path) -> the original merge commit whose rewritten tree supplies the file
('1e52fc8f', STRINGS): 'c8de3a1f', ('1e52fc8f', NAVHOST): 'c8de3a1f',
('0634487e', UI + 'CuratedSuggestionListScreen.kt'): 'fedbe724',
('0634487e', STRINGS): 'fedbe724', ('0634487e', NAVHOST): 'fedbe724',
}
AFTER = { # orig -> files folded in after the pick, from the merge that edited them outside its conflicts
'0634487e': [(UI + 'AcceptCuratedSuggestionScreen.kt', 'fedbe724'), (UI + 'BroadcastGroupSignedEventScreen.kt', 'fedbe724')],
}
THEIRS = {
('42f3a697', 'composeApp/src/commonMain/kotlin/press/mantra/compose/network/relays/RelaysSocketManager.kt'),
('42f3a697', 'composeApp/src/commonMain/kotlin/press/mantra/compose/ui/view/model/NavigationViewModel.kt'),
('e3cc23ae', UI + 'KeyRecoveryScreen.kt'),
('2f420230', 'composeApp/src/commonMain/kotlin/press/mantra/compose/ui/view/model/CreateProfileViewModel.kt'),
}
THEIRS_WHY = {
'42f3a697': "this commit's import block taken whole -- Mantra had already moved the nostrPublicKey() import to the library's (39fb64b6), and this commit removes the call it served",
'e3cc23ae': 'the class comment this commit rewrites is taken whole; the only base difference was the dropped rebrand capitalising the brand in one word of it',
'2f420230': "this commit's import block taken whole -- Mantra had already moved the nostrPublicKey() import to the library's (39fb64b6), and this commit removes the seed derivation that import served; the file is identical on both sides afterwards (docs/curated-to-mantra-profiles.md, the third decision)",
}
DELETE = {('55664cc7', 'composeApp/src/jvmTest/kotlin/press/mantra/compose/ui/composable/GroupNostrProfileSectionJvmTest.kt')} | {
# the extended-FAB sweep touches twenty screens; these seven were taken out with lines B, D and H
('ca6c16be', UI + f) for f in (
'AcceptCuratedSuggestionScreen.kt', 'AddGroupPostScreen.kt', 'EditGroupCuratedSchemaScreen.kt',
'EditGroupNostrProfileScreen.kt', 'EditGroupRelaysScreen.kt', 'GroupCuratedEntriesScreen.kt',
'ProposeGroupEventScreen.kt',
)
}
VM = 'composeApp/src/commonMain/kotlin/press/mantra/compose/ui/view/model/'
PARTIAL = { # orig -> (paths to take, why the rest stays out)
'd2a4298d': ([
'composeApp/src/commonMain/kotlin/press/mantra/compose/database/model/GroupSignedEvent.kt',
UI + 'BroadcastGroupSignedEventScreen.kt',
UI + 'widgets/RelayOutcomeLabel.kt',
VM + 'BroadcastGroupSignedEventViewModel.kt',
], "only its broadcast half: sendToRelays lifted into the view model's companion, the RelayOutcomeLabel widget and the screen reading it, and the GroupSignedEvent comment. "
"The entries screen's Broadcast-all button, its view model and state, its tests, its five strings and its nav-host wiring are line D, which Mantra took out (docs/curated-to-mantra.md)"),
}
def main():
mode, wt, args = sys.argv[1], sys.argv[2], sys.argv[3:]
def git(*a, check=True, **kw):
return subprocess.run(['git', *a], cwd=wt, capture_output=True, text=True, check=check, **kw)
rewritten = {}
for line in git('log', '--format=%H %(trailers:key=Pulled-From,valueonly)', 'origin/mantra..tmp/curated-src').stdout.splitlines():
parts = line.split()
if len(parts) == 2: rewritten[parts[1].split('@')[-1][:8]] = parts[0]
rw = lambda orig: rewritten[orig[:8]]
if mode == 'check':
print(git('diff', '--name-only', rw(args[0]), 'HEAD').stdout, end=''); return
def union_resolve(path):
p = os.path.join(wt, path); lines = open(p, encoding='utf-8').read().split('\n')
state = None; outside = set()
for l in lines:
if l.startswith('<<<<<<< '): state = 'in'; continue
if l.startswith('>>>>>>> '): state = None; continue
if state is None: outside.add(l)
out = []; state = None; ours = base = theirs = None
for l in lines:
if l.startswith('<<<<<<< '): state = 'ours'; ours, base, theirs = [], [], []; continue
if l.startswith('||||||| ') and state == 'ours': state = 'base'; continue
if l == '=======' and state in ('ours', 'base'): state = 'theirs'; continue
if l.startswith('>>>>>>> ') and state == 'theirs':
removed = {b for b in base if b not in theirs and b.strip()}
added = [t for t in theirs if t not in base]
kept = [o for o in ours if o not in removed]
have = outside | set(kept)
out.extend(kept); out.extend(a for a in added if a not in have or a.strip() == ''); state = None; continue
if state == 'ours': ours.append(l)
elif state == 'base': base.append(l)
elif state == 'theirs': theirs.append(l)
else: out.append(l)
open(p, 'w', encoding='utf-8').write('\n'.join(out))
def amend_note(note):
msg = git('log', '-1', '--format=%B').stdout.rstrip('\n').split('\n'); i = len(msg)
while i > 0 and re.match(r'^[A-Za-z-]+: ', msg[i - 1]): i -= 1
body, trailers = msg[:i], msg[i:]
while body and body[-1] == '': body.pop()
subprocess.run(['git', 'commit', '-q', '--amend', '-F', '-'], cwd=wt, input='\n'.join(body + ['', note, ''] + trailers) + '\n', text=True, check=True)
for orig in args:
o8 = orig[:8]; sha = rw(o8); subject = git('log', '-1', '--format=%s', sha).stdout.strip(); notes = []
if o8 in PARTIAL:
paths, why = PARTIAL[o8]
patch = git('diff', '--binary', f'{sha}^', sha, '--', *paths).stdout
r = subprocess.run(['git', 'apply', '--index', '--3way'], cwd=wt, input=patch, capture_output=True, text=True)
if r.returncode != 0: sys.exit(f'STUCK at {o8} {subject}: the partial pick did not apply: {r.stderr.strip()[:300]}')
git('commit', '-q', '-C', sha)
amend_note(f'Replayed onto Mantra by docs/curated-to-mantra.md, in part: {why}.')
print(f"{o8} partial {subject[:80]}"); continue
r = git('-c', 'merge.conflictStyle=diff3', 'cherry-pick', '--allow-empty', sha, check=False)
if r.returncode != 0:
stuck = []
for f in git('diff', '--name-only', '--diff-filter=U').stdout.split():
if f == GITLINK and o8 in PIN:
git('update-index', '--cacheinfo', f'160000,{PIN[o8]},{GITLINK}'); notes.append(f'gitlink -> {PIN[o8][:8]}, the pin this commit compiles against')
elif (o8, f) in TAKE_FROM:
src = TAKE_FROM[(o8, f)]; open(os.path.join(wt, f), 'w').write(git('show', f'{rw(src)}:{f}').stdout); git('add', f)
notes.append(f'{os.path.basename(f)}: taken as the original merge {src} left it, this being the branch join')
elif (o8, f) in THEIRS:
git('checkout', '--theirs', '--', f); git('add', f); notes.append(f'{os.path.basename(f)}: {THEIRS_WHY[o8]}')
elif (o8, f) in DELETE:
git('rm', '-q', '-f', f); notes.append(f'{os.path.basename(f)}: deleted, as this commit deletes it upstream')
elif f in UNION:
union_resolve(f); git('add', f); notes.append(f'{os.path.basename(f)}: line-set three-way merge, both sides\' additions kept and this commit\'s deletions applied')
else:
stuck.append(f)
if stuck:
git('cherry-pick', '--abort', check=False); sys.exit(f'STUCK at {o8} {subject}: no rule for {stuck}')
r2 = subprocess.run(['git', '-c', 'core.editor=true', 'cherry-pick', '--continue'], cwd=wt, capture_output=True, text=True)
if r2.returncode != 0: sys.exit(f'STUCK continuing {o8}: {r2.stderr.strip()[:300]}')
for path, src in AFTER.get(o8, []):
open(os.path.join(wt, path), 'w').write(git('show', f'{rw(src)}:{path}').stdout); git('add', path)
notes.append(f'{os.path.basename(path)}: brought to the state the original merge {src} left it in, an edit that merge made outside its conflicts')
if o8 in PIN and git('ls-tree', 'HEAD', GITLINK).stdout.split()[2] != PIN[o8]:
# a populated submodule lets git resolve the gitlink by fast-forward and keep the newer pin;
# the pin has to follow the commit, since each compiles only against the library it named
git('update-index', '--cacheinfo', f"160000,{PIN[o8]},{GITLINK}")
notes.append('gitlink -> 84cc44c: upstream pinned 01962f3, a branch commit since rebased onto the library\'s master as 84cc44c with an identical tree' if o8 == '5efeae76'
else f'gitlink -> {PIN[o8][:8]}, the pin this commit compiles against (git had fast-forwarded it to the newer one)')
if notes:
git('commit', '-q', '--amend', '--no-edit', check=False)
amend_note('Replayed onto Mantra by docs/curated-to-mantra.md: ' + '; '.join(notes) + '.')
print(f"{o8} {'resolved' if notes else 'clean':8s} {subject[:80]}")
if __name__ == '__main__':
if len(sys.argv) < 4 or sys.argv[1] not in ('pick', 'check'): sys.exit(__doc__)
main()