exchange_test.v

1//! Two-machine tests: two repos and one folder remote standing in for the Mac2//! and the PC. This is where offer, steal and combine are actually proven —3//! the folder backend exists so these run offline.45module exchange67import os8import src.events9import src.history10import src.remote11import src.snapshot12import src.storage1314// Global rules must not make source fixtures depend on the developer’s home.15fn testsuite_begin() {16	os.setenv('HOME', os.join_path(os.temp_dir(), 'koh3-test-home-${os.getpid()}'), true)17}1819fn test_arriving_record_drops_unsafe_paths_and_reports_them() {20	mut record := SaveRecord{21		files: [22			FileRecord{ path: 'safe.txt' },23			FileRecord{ path: '../outside.txt' },24			FileRecord{ path: 'bad\\name.txt' },25			FileRecord{ path: 'Icon\r' },26		]27	}28	dropped := drop_unsafe_paths(mut record)29	assert record.files.map(it.path) == ['safe.txt']30	assert dropped == ['../outside.txt', 'Icon\\x0d', 'bad\\\\name.txt']31}3233// An unpaired surrogate escape stands for its three bytes, so the record still34// decodes and only the path holding it is dropped; a real pair is kept.35fn test_a_record_with_unpaired_surrogate_escapes_drops_only_those_paths() {36	body := '{"id":"abcdefabcdef","files":[{"path":"ok\\ud83d\\ude00"},{"path":"lead\\ud800"},{"path":"trail\\udc00x"},{"path":"back\\\\ud800"}]}'37	mut record := decode_save(body.bytes())!38	dropped := drop_unsafe_paths(mut record)39	assert record.files.map(it.path) == ['ok😀']40	assert dropped == ['back\\\\ud800', 'lead\\xed\\xa0\\x80', 'trail\\xed\\xb0\\x80x']41}4243// Machines keep their repo in a folder of the same NAME, because the remote key44// is the folder's name; that is what makes them the same repo to the remote.45fn machine(name string) !string {46	dir := os.join_path(os.temp_dir(), 'koh3_sync_${os.getpid()}_${name}', 'proj')47	os.rmdir_all(os.dir(dir)) or {}48	os.mkdir_all(dir, os.MkdirParams{})!49	return dir50}5152fn scratch(name string) !string {53	dir := os.join_path(os.temp_dir(), 'koh3_sync_${os.getpid()}_${name}')54	os.rmdir_all(dir) or {}55	os.mkdir_all(dir, os.MkdirParams{})!56	return dir57}5859fn open_repo(dir string) !storage.Store {60	mut store := storage.create(dir)!61	os.write_file(os.join_path(dir, '.kohignore'), '*.log\n')!62	return store63}6465fn put(root string, rel string, text string) ! {66	full := os.join_path(root, rel)67	os.mkdir_all(os.dir(full), os.MkdirParams{})!68	os.write_file(full, text)!69}7071fn make_save(store &storage.Store, message string) !history.Save {72	return history.save_worktree(store, store.root, snapshot.load(store.root), history.SaveInput{73		message: message74	})!75}7677fn offer_now(store &storage.Store, mut backend remote.Backend) !OfferReport {78	return offer(store, mut backend)!79}8081fn steal_now(store &storage.Store, mut backend remote.Backend) !StealReport {82	return steal(store, mut backend, StealOptions{83		theirs: true84	})!85}8687fn test_first_offer_publishes_the_whole_line() {88	base := scratch('first')!89	defer {90		os.rmdir_all(base) or {}91	}92	mut a := open_repo(machine('first_a')!)!93	defer {94		a.close()95	}96	put(a.root, 'a.txt', 'one\n')!97	make_save(a, 'first')!98	put(a.root, 'a.txt', 'two\n')!99	make_save(a, 'second')!100	mut backend := remote.new_folder(os.join_path(base, 'remote'))!101102	report := offer_now(a, mut backend)!103	assert report.repo == 'proj'104	assert report.saves == 2105	assert report.objects >= 2106	assert backend.get(head_key('proj'))!.found107	assert backend.list('proj/saves')!.len == 2108109	// A second offer with nothing new uploads nothing and still succeeds.110	again := offer_now(a, mut backend)!111	assert again.saves == 0112}113114fn test_the_repo_name_is_remembered_and_head_offered() {115	base := scratch('remember')!116	defer {117		os.rmdir_all(base) or {}118	}119	mut a := open_repo(machine('remember_a')!)!120	defer {121		a.close()122	}123	put(a.root, 'a.txt', 'one\n')!124	make_save(a, 'first')!125	mut backend := remote.new_folder(os.join_path(base, 'remote'))!126	offer_now(a, mut backend)!127	assert a.state('remote_repo') or { '' } == 'proj'128	assert backend.get(head_key('proj'))!.body.bytestr() == head_of(a).id129	// Offer's step 3: the new remote head is recorded in state.130	assert a.state('remote_head') or { '' } == head_of(a).id131132	// A second offer, with the remote already holding our head, must not133	// refuse: the name is remembered, so the remote is ours.134	put(a.root, 'a.txt', 'two\n')!135	make_save(a, 'second')!136	offer_now(a, mut backend)!137	assert backend.get(head_key('proj'))!.body.bytestr() == head_of(a).id138}139140fn test_a_repo_name_is_lowercased_at_first_offer() {141	base := scratch('lower')!142	defer {143		os.rmdir_all(base) or {}144	}145	dir := os.join_path(base, 'Haven')146	os.mkdir_all(dir, os.MkdirParams{})!147	mut a := open_repo(dir)!148	defer {149		a.close()150	}151	put(a.root, 'a.txt', 'one\n')!152	make_save(a, 'first')!153	mut backend := remote.new_folder(os.join_path(base, 'remote'))!154	assert offer_now(a, mut backend)!.repo == 'haven'155	assert backend.get(head_key('haven'))!.found156}157158fn test_an_offer_follows_a_rename_kepr_marked_on_the_remote() {159	base := scratch('renamed')!160	defer {161		os.rmdir_all(base) or {}162	}163	mut a := open_repo(machine('renamed_a')!)!164	defer {165		a.close()166	}167	put(a.root, 'a.txt', 'one\n')!168	make_save(a, 'first')!169	remote_dir := os.join_path(base, 'remote')170	mut backend := remote.new_folder(remote_dir)!171	offer_now(a, mut backend)!172	// What Kepr's rename leaves: the history under the new name, a marker, no old name.173	os.mv(os.join_path(remote_dir, 'proj'), os.join_path(remote_dir, 'tool'))!174	os.mkdir_all(os.join_path(remote_dir, '.kepr', 'renamed'), os.MkdirParams{})!175	os.write_file(os.join_path(remote_dir, '.kepr', 'renamed', 'proj'), 'tool\n')!176177	put(a.root, 'a.txt', 'two\n')!178	make_save(a, 'second')!179	assert offer_now(a, mut backend)!.repo == 'tool'180	assert a.state('remote_repo') or { '' } == 'tool'181	assert backend.get(head_key('tool'))!.body.bytestr() == head_of(a).id182	assert !backend.get(head_key('proj'))!.found183}184185fn test_a_rename_marker_naming_a_path_is_not_followed() {186	base := scratch('badmarker')!187	defer {188		os.rmdir_all(base) or {}189	}190	mut a := open_repo(machine('badmarker_a')!)!191	defer {192		a.close()193	}194	put(a.root, 'a.txt', 'one\n')!195	make_save(a, 'first')!196	remote_dir := os.join_path(base, 'remote')197	mut backend := remote.new_folder(remote_dir)!198	offer_now(a, mut backend)!199	os.rmdir_all(os.join_path(remote_dir, 'proj'))!200	os.mkdir_all(os.join_path(remote_dir, '.kepr', 'renamed'), os.MkdirParams{})!201	os.write_file(os.join_path(remote_dir, '.kepr', 'renamed', 'proj'), '../elsewhere\n')!202	assert offer_now(a, mut backend)!.repo == 'proj'203}204205fn test_steal_fast_forwards_a_machine_that_has_nothing_of_its_own() {206	base := scratch('forward')!207	defer {208		os.rmdir_all(base) or {}209	}210	mut backend := remote.new_folder(os.join_path(base, 'remote'))!211	mut a := open_repo(machine('fwd_a')!)!212	defer {213		a.close()214	}215	put(a.root, 'a.txt', 'from A\n')!216	make_save(a, 'A writes')!217	offer_now(a, mut backend)!218219	// B starts empty and takes the whole repo.220	mut b := open_repo(machine('fwd_b')!)!221	defer {222		b.close()223	}224	fetched := fetch_repo(mut backend, 'proj')!225	b.begin()!226	write_fetched(b, fetched)!227	history.set_head(b, fetched.head)!228	b.end()!229	snapshot.restore_files(b, b.root, snapshot.load(b.root), history.files_of(b, fetched.head)!, [])!230	assert os.read_file(os.join_path(b.root, 'a.txt'))! == 'from A\n'231	assert head_of(b).id == fetched.head232}233234// A machine that is only ahead has nothing to combine: stealing must leave its235// saves, and their IDs, exactly where they are.236fn test_steal_while_only_ahead_leaves_the_line_alone() {237	base := scratch('ahead')!238	defer {239		os.rmdir_all(base) or {}240	}241	mut backend := remote.new_folder(os.join_path(base, 'remote'))!242	mut a := open_repo(machine('ahead_a')!)!243	defer {244		a.close()245	}246	put(a.root, 'a.txt', 'one\n')!247	make_save(a, 'offered')!248	offer_now(a, mut backend)!249	put(a.root, 'a.txt', 'two\n')!250	ahead := make_save(a, 'not offered yet')!251	report := steal_now(a, mut backend)!252	assert report.replayed == 0253	assert head_of(a).id == ahead.id254	// Nothing was restored, so nothing is left marked as half-restored.255	assert !snapshot.restore_pending(a)256	assert history.all_saves(a)!.len == 2257	offer_now(a, mut backend)!258	assert backend.get(head_key('proj'))!.body.bytestr() == ahead.id259}260261// A link is invisible to the walk, so a tree holding one is clean; the files262// a steal brings in must still never land in the folder it points at.263fn test_steal_never_writes_through_a_symlinked_folder() {264	base := scratch('steal_link')!265	defer {266		os.rmdir_all(base) or {}267	}268	mut backend := remote.new_folder(os.join_path(base, 'remote'))!269	mut a := open_repo(machine('steal_link_a')!)!270	defer {271		a.close()272	}273	mut b := open_repo(machine('steal_link_b')!)!274	defer {275		b.close()276	}277	put(a.root, 'a.txt', 'one\n')!278	make_save(a, 'first')!279	offer_now(a, mut backend)!280	join(b, mut backend)!281	outside := os.join_path(base, 'outside')282	put(outside, 'a.md', 'precious\n')!283	os.symlink(outside, os.join_path(b.root, 'docs'))!284	put(a.root, 'docs/a.md', 'from A\n')!285	make_save(a, 'A adds docs')!286	offer_now(a, mut backend)!287	head_before := head_of(b).id288	if _ := steal_now(b, mut backend) {289		assert false, 'a steal writing through a symlinked folder must refuse'290	} else {291		assert err.msg().contains('docs')292	}293	assert os.read_file(os.join_path(outside, 'a.md'))! == 'precious\n'294	assert head_of(b).id == head_before295}296297// A steal onto a half-restored tree would replay it as somebody's work.298fn test_steal_refuses_after_a_restore_cut_short() {299	base := scratch('steal_cut')!300	defer {301		os.rmdir_all(base) or {}302	}303	mut backend := remote.new_folder(os.join_path(base, 'remote'))!304	mut a := open_repo(machine('steal_cut_a')!)!305	defer {306		a.close()307	}308	put(a.root, 'a.txt', 'one\n')!309	make_save(a, 'first')!310	offer_now(a, mut backend)!311	a.set_state('restoring', 'yes')!312	if _ := steal_now(a, mut backend) {313		assert false, 'steal must refuse while a restore is unfinished'314	} else {315		assert err.msg().contains('koh revert')316	}317}318319// A replayed save keeps its original time but sits on a newer parent, so a320// steal cannot order saves by time.321fn test_a_steal_imports_parents_before_children() {322	base := scratch('steal_order')!323	defer {324		os.rmdir_all(base) or {}325	}326	mut backend := remote.new_folder(os.join_path(base, 'remote'))!327	mut a := open_repo(machine('order_a')!)!328	defer {329		a.close()330	}331	put(a.root, 'a.txt', 'one\n')!332	parent := make_save(a, 'parent')!333	child := history.save_tree(a, '', history.files_of(a, parent.id)!, history.SaveInput{334		message:    'replayed, older than its parent'335		created_at: parent.created_at - 3600336	})!337	offer_now(a, mut backend)!338	mut b := open_repo(machine('order_b')!)!339	defer {340		b.close()341	}342	join(b, mut backend)!343	assert head_of(b).id == child.id344}345346// A chmod is unsaved work too: a steal would restore the old mode over it.347fn test_steal_refuses_an_unsaved_executable_bit_change() {348	base := scratch('chmod')!349	defer {350		os.rmdir_all(base) or {}351	}352	mut backend := remote.new_folder(os.join_path(base, 'remote'))!353	mut a := open_repo(machine('chmod_a')!)!354	defer {355		a.close()356	}357	put(a.root, 'run.sh', 'echo hi\n')!358	make_save(a, 'script')!359	offer_now(a, mut backend)!360	os.chmod(os.join_path(a.root, 'run.sh'), 0o755)!361	if _ := steal_now(a, mut backend) {362		assert false, 'a chmod-only change should make the tree dirty'363	} else {364		assert err.msg() == dirty_tree365	}366}367368fn test_divergence_without_clashes_keeps_both_machines_work() {369	base := scratch('diverge')!370	defer {371		os.rmdir_all(base) or {}372	}373	mut backend := remote.new_folder(os.join_path(base, 'remote'))!374	mut a := open_repo(machine('div_a')!)!375	defer {376		a.close()377	}378	mut b := open_repo(machine('div_b')!)!379	defer {380		b.close()381	}382	put(a.root, 'shared.txt', 'base\n')!383	make_save(a, 'base')!384	offer_now(a, mut backend)!385386	// B joins, then both machines change a different file.387	join(b, mut backend)!388	put(a.root, 'fromA.txt', 'A\n')!389	make_save(a, 'A adds a file')!390	put(b.root, 'fromB.txt', 'B\n')!391	make_save(b, 'B adds a file')!392	offer_now(a, mut backend)!393394	// B's offer is refused: the remote has moved on.395	if _ := offer_now(b, mut backend) {396		assert false, 'offering on top of unknown remote saves should be refused'397	} else {398		assert err.msg().contains('run koh steal')399	}400401	report := steal_now(b, mut backend)!402	assert !report.forward403	assert report.replayed == 1404	assert report.clashes.len == 0405	// Both files are on B's line now, and on disk.406	assert os.read_file(os.join_path(b.root, 'fromA.txt'))! == 'A\n'407	assert os.read_file(os.join_path(b.root, 'fromB.txt'))! == 'B\n'408	assert os.read_file(os.join_path(b.root, 'shared.txt'))! == 'base\n'409	// B's own save was replayed, not erased.410	mut saw_replay := false411	for save in history.all_saves(b)! {412		if save.replayed_from != '' {413			saw_replay = true414		}415	}416	assert saw_replay417	// And the remote now has B's work too.418	offer_now(b, mut backend)!419	line_head := backend.get(head_key('proj'))!.body.bytestr().trim_space()420	assert line_head == head_of(b).id421}422423// An agent that edits a file and then undoes the edit leaves no net change, so424// the file is not a clash when the other machine changed it. Replaying the425// edit itself must not stop the steal: the remote's version simply stands.426// Likewise a file both machines ended up changing the same way.427fn test_a_local_change_undone_does_not_block_a_combine() {428	base := scratch('undone')!429	defer {430		os.rmdir_all(base) or {}431	}432	mut backend := remote.new_folder(os.join_path(base, 'remote'))!433	mut a := open_repo(machine('undone_a')!)!434	defer {435		a.close()436	}437	mut b := open_repo(machine('undone_b')!)!438	defer {439		b.close()440	}441	put(a.root, 'f.txt', 'base\n')!442	put(a.root, 'g.txt', 'base\n')!443	make_save(a, 'base')!444	offer_now(a, mut backend)!445	join(b, mut backend)!446447	put(a.root, 'f.txt', 'from A\n')!448	put(a.root, 'g.txt', 'same\n')!449	make_save(a, 'A edits both')!450	offer_now(a, mut backend)!451452	put(b.root, 'f.txt', 'tried on B\n')!453	put(b.root, 'g.txt', 'first try\n')!454	tried := make_save(b, 'B tries')!455	put(b.root, 'f.txt', 'base\n')!456	put(b.root, 'g.txt', 'same\n')!457	put(b.root, 'h.txt', 'B\n')!458	undone := make_save(b, 'B undoes f, lands on the same g, adds h')!459460	report := steal_now(b, mut backend)!461	assert report.clashes.len == 0462	assert os.read_file(os.join_path(b.root, 'f.txt'))! == 'from A\n'463	assert os.read_file(os.join_path(b.root, 'g.txt'))! == 'same\n'464	assert os.read_file(os.join_path(b.root, 'h.txt'))! == 'B\n'465	// "B tries" only touched files A changed, so it has nothing left to466	// replay; the second save carries h.txt. Both originals stay in history.467	assert report.replayed == 1468	assert head_of(b).replayed_from == undone.id469	ids := history.all_saves(b)!.map(it.id)470	assert tried.id in ids && undone.id in ids471	assert history.files_of(b, tried.id)!.any(it.path == 'f.txt')472}473474// A person deciding a clash may take minutes; the question must come before475// the write lock, or every agent's save on this repo waits and then fails.476fn test_clash_questions_are_asked_before_the_write_lock() {477	base := scratch('ask_unlocked')!478	defer {479		os.rmdir_all(base) or {}480	}481	mut backend := remote.new_folder(os.join_path(base, 'remote'))!482	mut a := open_repo(machine('ask_a')!)!483	defer {484		a.close()485	}486	mut b := open_repo(machine('ask_b')!)!487	defer {488		b.close()489	}490	put(a.root, 'same.txt', 'base\n')!491	make_save(a, 'base')!492	offer_now(a, mut backend)!493	join(b, mut backend)!494	put(a.root, 'same.txt', 'A version\n')!495	make_save(a, 'A edits same')!496	offer_now(a, mut backend)!497	put(b.root, 'same.txt', 'B version\n')!498	make_save(b, 'B edits same')!499	root := b.root500	// An agent saves while the person is still choosing.501	if _ := steal(b, mut backend, StealOptions{502		guide: fn [root] (preview StealPreview) !map[string]Side {503			other := storage.open(root) or { panic(err) }504			defer {505				other.close()506			}507			os.write_file(os.join_path(root, 'agent.txt'), 'saved meanwhile\n') or { panic(err) }508			history.save_worktree(other, root, snapshot.load(root), history.SaveInput{509				message: 'agent saves during the question'510			}) or { panic('steal held the write lock while asking: ${err}') }511			return {512				preview.clashes[0].path: Side.mine513			}514		}515	})516	{517		assert false, 'a steal whose line moved during the question must refuse'518	} else {519		assert err.msg().contains('changed while')520	}521	// The agent's save is still head, and a second steal combines it too.522	assert head_of(b).message == 'agent saves during the question'523	report := steal(b, mut backend, StealOptions{524		mine: true525	})!526	assert report.kept_mine == 1527	assert os.read_file(os.join_path(b.root, 'agent.txt'))! == 'saved meanwhile\n'528	assert os.read_file(os.join_path(b.root, 'same.txt'))! == 'B version\n'529}530531fn test_clashing_files_are_chosen_one_at_a_time() {532	base := scratch('clash')!533	defer {534		os.rmdir_all(base) or {}535	}536	mut backend := remote.new_folder(os.join_path(base, 'remote'))!537	mut a := open_repo(machine('clash_a')!)!538	defer {539		a.close()540	}541	mut b := open_repo(machine('clash_b')!)!542	defer {543		b.close()544	}545	put(a.root, 'same.txt', 'base\n')!546	put(a.root, 'other.txt', 'quiet\n')!547	make_save(a, 'base')!548	offer_now(a, mut backend)!549	join(b, mut backend)!550551	// Both machines edit the same file, differently.552	put(a.root, 'same.txt', 'A version\n')!553	make_save(a, 'A edits same')!554	offer_now(a, mut backend)!555	put(b.root, 'same.txt', 'B version\n')!556	make_save(b, 'B edits same')!557558	// Without a decision, steal refuses and says which files clash.559	if _ := steal(b, mut backend, StealOptions{}) {560		assert false, 'an undecided clash must be refused'561	} else {562		assert err.msg().contains('--mine') || err.msg().contains('--theirs')563		// `koh offer` has no --mine or --theirs, so it needs the paths, not this sentence.564		if err is ClashError {565			assert err.paths == ['same.txt']566		} else {567			assert false, 'an undecided clash must be a ClashError, not ${err}'568		}569	}570	assert find_clashes(history.files_of(b, head_of(b).id)!, history.files_of(b, head_of(b).id)!, history.files_of(b,571		head_of(b).id)!).len == 0572573	// Choosing the remote's version ends with A's content.574	report := steal_now(b, mut backend)!575	assert report.clashes == ['same.txt']576	assert report.kept_mine == 0577	assert report.kept_versions == ['same.txt:${report.previous_head}']578	assert os.read_file(os.join_path(b.root, 'same.txt'))! == 'A version\n'579	assert os.read_file(os.join_path(b.root, 'other.txt'))! == 'quiet\n'580}581582fn test_cancelling_a_guided_steal_keeps_the_line_and_can_retry() {583	base := scratch('guided_cancel')!584	defer { os.rmdir_all(base) or {} }585	mut backend := remote.new_folder(os.join_path(base, 'remote'))!586	mut a := open_repo(machine('guided_cancel_a')!)!587	defer { a.close() }588	mut b := open_repo(machine('guided_cancel_b')!)!589	defer { b.close() }590	put(a.root, 'same.txt', 'base\n')!591	make_save(a, 'base')!592	offer_now(a, mut backend)!593	join(b, mut backend)!594	put(a.root, 'same.txt', 'remote\n')!595	remote_head := make_save(a, 'remote change')!596	offer_now(a, mut backend)!597	put(b.root, 'same.txt', 'mine\n')!598	local_head := make_save(b, 'local change')!599600	if _ := steal(b, mut backend, StealOptions{601		guide: fn (preview StealPreview) !map[string]Side {602			assert preview.clashes.len == 1603			return error('cancelled')604		}605	}) {606		assert false, 'the guide cancelled'607	} else {608		assert err.msg() == 'cancelled'609	}610	assert head_of(b).id == local_head.id611	assert os.read_file(os.join_path(b.root, 'same.txt'))! == 'mine\n'612	assert history.by_id(b, remote_head.id) != none613	assert steal(b, mut backend, StealOptions{ mine: true })!.kept_mine == 1614}615616fn test_choosing_mine_keeps_the_local_version() {617	base := scratch('mine')!618	defer {619		os.rmdir_all(base) or {}620	}621	mut backend := remote.new_folder(os.join_path(base, 'remote'))!622	mut a := open_repo(machine('mine_a')!)!623	defer {624		a.close()625	}626	mut b := open_repo(machine('mine_b')!)!627	defer {628		b.close()629	}630	put(a.root, 'same.txt', 'base\n')!631	make_save(a, 'base')!632	offer_now(a, mut backend)!633	join(b, mut backend)!634	put(a.root, 'same.txt', 'A version\n')!635	make_save(a, 'A edits')!636	offer_now(a, mut backend)!637	put(b.root, 'same.txt', 'B version\n')!638	make_save(b, 'B edits')!639640	report := steal(b, mut backend, StealOptions{641		mine: true642	})!643	assert report.kept_mine == 1644	assert os.read_file(os.join_path(b.root, 'same.txt'))! == 'B version\n'645	// The final save says what it kept.646	assert head_of(b).message.contains('combine: kept mine for 1 file')647	// The pre-combine tree is still reachable in history.648	assert head_of(b).restores == ''649	assert history.all_saves(b)!.len >= 4650}651652fn test_flags_travel_with_the_saves() {653	base := scratch('flags')!654	defer {655		os.rmdir_all(base) or {}656	}657	mut backend := remote.new_folder(os.join_path(base, 'remote'))!658	mut a := open_repo(machine('flag_a')!)!659	defer {660		a.close()661	}662	mut b := open_repo(machine('flag_b')!)!663	defer {664		b.close()665	}666	put(a.root, 'a.txt', 'one\n')!667	save := make_save(a, 'suspect save')!668	events.flag(a, save.id, 'look at this')!669	offer_now(a, mut backend)!670671	// B has nothing yet, so a fetch brings the save and its flag across.672	fetched := fetch_back_to_known(b, mut backend, 'proj')!673	assert fetched.events_out.len == 1674	assert fetched.events_out[0].kind == events.kind_flag675	b.begin()!676	write_fetched(b, fetched)!677	history.set_head(b, fetched.head)!678	b.end()!679	state := events.flag_state(b, save.id)!680	assert state.flagged681	assert state.reason == 'look at this'682}683684fn test_a_second_offer_racing_head_is_refused_not_forced() {685	base := scratch('race')!686	defer {687		os.rmdir_all(base) or {}688	}689	mut backend := remote.new_folder(os.join_path(base, 'remote'))!690	mut a := open_repo(machine('race_a')!)!691	defer {692		a.close()693	}694	put(a.root, 'a.txt', 'one\n')!695	make_save(a, 'base')!696	offer_now(a, mut backend)!697698	// Someone else replaces head behind our back.699	assert backend.put_if_match(head_key('proj'), 'a-save-we-do-not-have'.bytes(),700		backend.get(head_key('proj'))!.tag)!701702	put(a.root, 'a.txt', 'two\n')!703	make_save(a, 'second')!704	if _ := offer_now(a, mut backend) {705		assert false, 'offering while the remote head moved must be refused'706	} else {707		assert err.msg().contains('run koh steal')708	}709}710711// join makes a brand new machine share the remote's line.712fn join(store &storage.Store, mut backend remote.Backend) ! {713	fetched := fetch_repo(mut backend, 'proj')!714	store.begin()!715	write_fetched(store, fetched)!716	history.set_head(store, fetched.head)!717	store.end()!718	snapshot.restore_files(store, store.root, snapshot.load(store.root), history.files_of(store,719		fetched.head)!, [])!720	store.set_state('remote_repo', 'proj')!721}722723struct FaultyBackend {724mut:725	inner      remote.Backend726	writes     int727	reads      int728	fail_write int // fail when the write counter reaches this, 0 never729	fail_read  int730	// fail every delete while set731	fail_delete bool732	// race_format stands in for another machine writing the format key first:733	// the first `format` write loses, to a value this koh does not speak.734	race_format bool735	raced       bool736}737738fn (mut f FaultyBackend) get(key string) !remote.Object {739	f.reads++740	if f.fail_read > 0 && f.reads >= f.fail_read {741		return error('injected read failure')742	}743	return f.inner.get(key)!744}745746fn (mut f FaultyBackend) list(prefix string) ![]string {747	return f.inner.list(prefix)!748}749750fn (mut f FaultyBackend) put_if_absent(key string, body []u8) !bool {751	f.writes++752	if f.fail_write > 0 && f.writes >= f.fail_write {753		return error('injected write failure')754	}755	if f.race_format && !f.raced && key.ends_with('/format') {756		f.raced = true757		f.inner.put_if_absent(key, 'koh-remote 2'.bytes())!758		return false759	}760	return f.inner.put_if_absent(key, body)!761}762763fn (mut f FaultyBackend) put_if_match(key string, body []u8, tag string) !bool {764	f.writes++765	if f.fail_write > 0 && f.writes >= f.fail_write {766		return error('injected write failure')767	}768	return f.inner.put_if_match(key, body, tag)!769}770771fn (mut f FaultyBackend) delete(key string) ! {772	if f.fail_delete {773		return error('injected delete failure')774	}775	f.inner.delete(key)!776}777778// Every save offers after it is made, so a one-file change must cost one779// object, not one conditional write per file in the repo: on S3 each of those780// is a round trip.781fn test_an_offer_sends_only_the_objects_a_save_adds() {782	base := scratch('offer_diff')!783	defer {784		os.rmdir_all(base) or {}785	}786	mut a := open_repo(machine('offer_diff_a')!)!787	defer {788		a.close()789	}790	for i in 0 .. 20 {791		put(a.root, 'f${i}.txt', 'file ${i}\n')!792	}793	make_save(a, 'twenty files')!794	mut backend := FaultyBackend{795		inner: remote.new_folder(os.join_path(base, 'remote'))!796	}797	offer(a, mut backend)!798	put(a.root, 'f3.txt', 'changed\n')!799	make_save(a, 'one change')!800	before := backend.writes801	report := offer(a, mut backend)!802	assert report.objects == 1803	// One object, one save record, one head swap.804	assert backend.writes - before == 3805}806807fn test_a_failed_offer_is_safe_to_re_run() {808	base := scratch('fault_offer')!809	defer {810		os.rmdir_all(base) or {}811	}812	remote_dir := os.join_path(base, 'remote')813	mut a := open_repo(machine('fault_a')!)!814	defer {815		a.close()816	}817	put(a.root, 'a.txt', 'one\n')!818	make_save(a, 'first')!819	put(a.root, 'a.txt', 'two\n')!820	make_save(a, 'second')!821822	// The first offer dies after the first write.823	mut flaky := FaultyBackend{824		inner:      remote.new_folder(remote_dir)!825		fail_write: 2826	}827	if _ := offer(a, mut flaky) {828		assert false, 'the injected failure should have surfaced'829	}830831	// Re-running with a healthy remote finishes the job: "already exists" is832	// success, so nothing is lost and nothing is duplicated.833	mut healthy := remote.new_folder(remote_dir)!834	report := offer(a, mut healthy)!835	assert report.saves == 2836	assert healthy.get(head_key('proj'))!.body.bytestr().trim_space() == head_of(a).id837	assert healthy.list('proj/saves')!.len == 2838}839840// A strip whose path breaks §5.5 names nothing a save can hold; Koh and Kepr both leave it out,841// and it must neither remove anything nor hold up an offer.842fn test_a_strip_with_an_illegal_path_is_ignored() {843	base := scratch('illegal_strip')!844	defer {845		os.rmdir_all(base) or {}846	}847	mut backend := remote.new_folder(os.join_path(base, 'remote'))!848	mut a := open_repo(machine('illegal_strip_a')!)!849	defer {850		a.close()851	}852	mut b := open_repo(machine('illegal_strip_b')!)!853	defer {854		b.close()855	}856	put(a.root, 'a/x.txt', 'kept\n')!857	make_save(a, 'add a folder')!858	offer_now(a, mut backend)!859	for id, path in {860		'aaaaaaaaaaaa': 'a//'861		'bbbbbbbbbbbb': 'a\\ud800'862	} {863		backend.put_if_absent(event_key('proj', id), '{"id":"${id}","kind":"strip","save_id":"","path":"${path}","reason":"","created_at":1,"machine":"crafted"}'.bytes())!864	}865	join(b, mut backend)!866	assert 'a/x.txt' in history.files_of(b, history.head(b)!.id)!.map(it.path)867	put(a.root, 'more.txt', 'more\n')!868	make_save(a, 'more')!869	offer_now(a, mut backend)!870}871872fn test_a_failed_steal_leaves_nothing_behind() {873	base := scratch('fault_steal')!874	defer {875		os.rmdir_all(base) or {}876	}877	remote_dir := os.join_path(base, 'remote')878	mut a := open_repo(machine('fault_s_a')!)!879	defer {880		a.close()881	}882	mut b := open_repo(machine('fault_s_b')!)!883	defer {884		b.close()885	}886	put(a.root, 'a.txt', 'from A\n')!887	make_save(a, 'A writes')!888	mut healthy := remote.new_folder(remote_dir)!889	offer(a, mut healthy)!890891	// B's fetch fails half way through reading the remote.892	mut flaky := FaultyBackend{893		inner:     remote.new_folder(remote_dir)!894		fail_read: 2895	}896	if _ := fetch_back_to_known(b, mut flaky, 'proj') {897		assert false, 'the injected read failure should have surfaced'898	}899	// Nothing was written: the store is untouched and still has no saves.900	assert history.head(b) == none901	assert b.object_count()! == 0902903	// A healthy retry works.904	fetched := fetch_back_to_known(b, mut healthy, 'proj')!905	b.begin()!906	write_fetched(b, fetched)!907	history.set_head(b, fetched.head)!908	b.end()!909	snapshot.restore_files(b, b.root, snapshot.load(b.root), history.files_of(b, fetched.head)!, [])!910	assert os.read_file(os.join_path(b.root, 'a.txt'))! == 'from A\n'911}912913fn test_an_interrupted_strip_is_idempotent() {914	// The local half of a strip is one transaction, so an interrupted strip is915	// simply a strip that did not happen; re-running it must land the same916	// result once, not twice.917	base := scratch('fault_strip')!918	defer {919		os.rmdir_all(base) or {}920	}921	mut a := open_repo(machine('fault_strip_a')!)!922	defer {923		a.close()924	}925	put(a.root, 'secret.txt', 'shh\n')!926	put(a.root, 'keep.txt', 'fine\n')!927	save := make_save(a, 'add both')!928929	for _ in 0 .. 2 {930		strip_local(a, 'secret.txt', '')!931	}932	files := history.files_of(a, save.id)!933	// The repo's own `.kohignore` is tracked content, so it stays; only the934	// stripped path goes.935	assert files.map(it.path) == ['.kohignore', 'keep.txt']936	assert events.strip_events(a)!.len == 1937}938939// SQLite's LIKE ignores ASCII case, so a strip of `docs` must not reach into940// `Docs/`, and `a_b` must not reach `aXb`: strip destroys, so it matches exactly.941// The tree is built by hand: on macOS `Docs` and `docs` are one folder on disk,942// but a save made on Linux can hold both.943fn test_a_strip_matches_the_path_exactly() {944	mut a := open_repo(machine('strip_exact')!)!945	defer {946		a.close()947	}948	hash := a.put_object('x\n'.bytes())!949	mut files := []snapshot.FileEntry{}950	for path in ['DOCS.txt', 'Docs/keep.txt', 'a_b/x.txt', 'aXb/y.txt', 'docs/secret.txt'] {951		files << snapshot.FileEntry{952			path: path953			hash: hash954		}955	}956	save := history.save_tree(a, '', files, history.SaveInput{957		message: 'add all'958	})!959	assert strip_scope(a, 'docs', '')!.files == 1960	strip_local(a, 'docs', '')!961	strip_local(a, 'a_b', '')!962	assert history.files_of(a, save.id)!.map(it.path) == ['DOCS.txt', 'Docs/keep.txt', 'aXb/y.txt']963}964965fn test_a_strip_reaches_the_remote_and_other_machines() {966	base := scratch('strip_sync')!967	defer {968		os.rmdir_all(base) or {}969	}970	mut a := open_repo(machine('strip_a')!)!971	defer {972		a.close()973	}974	mut b := open_repo(machine('strip_b')!)!975	defer {976		b.close()977	}978	put(a.root, 'secrets.env', 'api_key=1\n')!979	put(a.root, 'keep.txt', 'fine\n')!980	save := make_save(a, 'add both')!981	mut backend := remote.new_folder(os.join_path(base, 'remote'))!982	offer_now(a, mut backend)!983	join(b, mut backend)!984	assert b.object_count()! > 0985986	// A strips the path locally, the way `koh strip` does, then tells the987	// remote.988	mut secret_hash := ''989	for file in history.files_of(a, save.id)! {990		if file.path == 'secrets.env' {991			secret_hash = file.hash992		}993	}994	assert secret_hash != ''995	strip_local(a, 'secrets.env', '')!996	report := send_strip(a, mut backend, 'secrets.env')!997	assert report.event_sent998	assert report.records == 19991000	// The remote's copy of the save no longer lists the file, and the object is1001	// gone from the remote.1002	record := decode_save(backend.get(save_key('proj', save.id))!.body)!1003	for file in record.files {1004		assert file.path != 'secrets.env'1005	}1006	// The stripped object is gone from the remote; the ones still referenced1007	// are not.1008	assert !backend.get(object_key('proj', secret_hash))!.found1009	assert backend.list('proj/objects')!.len == 210101011	// Another machine hears about it on its next steal and applies it.1012	b.begin()!1013	fetched := fetch_back_to_known(b, mut backend, 'proj')!1014	write_fetched(b, fetched)!1015	b.end()!1016	mut paths := []string{}1017	for file in history.files_of(b, save.id)! {1018		paths << file.path1019	}1020	assert 'secrets.env' !in paths1021	assert 'keep.txt' in paths10221023	// The event arrives under its own ID, so it is applied once: B's offer adds1024	// no second copy. The path is banned for good: written again, the file is1025	// neither unsaved work nor ever walked into a save.1026	assert events.strip_events(b)!.map(it.id) == events.strip_events(a)!.map(it.id)1027	put(b.root, 'secrets.env', 'rotated\n')!1028	assert !dirty(b, history.head(b))!1029	put(b.root, 'keep.txt', 'still fine\n')!1030	later := make_save(b, 'edit keep')!1031	offer_now(b, mut backend)!1032	assert backend.list('proj/events')!.len == 11033	assert 'secrets.env' !in history.files_of(b, later.id)!.map(it.path)1034}10351036// A strip removes a path from all of history, whenever a save was made. A1037// machine that saved the file after the strip, before it heard of it, loses1038// it from that save too on its next steal, so no copy anywhere keeps it.1039fn test_a_strip_reaches_saves_made_after_it_by_a_machine_that_had_not_heard() {1040	base := scratch('strip_later')!1041	defer {1042		os.rmdir_all(base) or {}1043	}1044	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1045	mut a := open_repo(machine('strip_later_a')!)!1046	defer {1047		a.close()1048	}1049	mut b := open_repo(machine('strip_later_b')!)!1050	defer {1051		b.close()1052	}1053	put(a.root, 'secrets.env', 'api_key=1\n')!1054	old := make_save(a, 'leak the key')!1055	offer_now(a, mut backend)!1056	join(b, mut backend)!1057	strip_local(a, 'secrets.env', '')!1058	send_strip(a, mut backend, 'secrets.env')!1059	// B has not heard, and saves the file again an hour after the strip.1060	put(b.root, 'secrets.env', 'api_key=2\n')!1061	later := history.save_tree(b, b.root, snapshot.walk(b, b.root, snapshot.load(b.root))!, history.SaveInput{1062		message:    'rotate the key'1063		created_at: events.strip_events(a)!.last().created_at + 36001064	})!1065	assert 'secrets.env' in history.files_of(b, later.id)!.map(it.path)1066	b.begin()!1067	write_fetched(b, fetch_back_to_known(b, mut backend, 'proj')!)!1068	b.end()!1069	assert 'secrets.env' !in history.files_of(b, later.id)!.map(it.path)1070	offer_now(b, mut backend)!10711072	mut c := open_repo(machine('strip_later_c')!)!1073	defer {1074		c.close()1075	}1076	join(c, mut backend)!1077	for save in [old.id, later.id] {1078		assert 'secrets.env' !in history.files_of(c, save)!.map(it.path)1079	}1080	assert !os.exists(os.join_path(c.root, 'secrets.env'))1081}10821083// A strip this machine already holds bans its path from saves that arrive1084// later too, not only from those a fetch brings with the strip.1085fn test_a_held_strip_reaches_saves_arriving_after_it() {1086	base := scratch('strip_held')!1087	defer {1088		os.rmdir_all(base) or {}1089	}1090	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1091	mut a := open_repo(machine('strip_held_a')!)!1092	defer {1093		a.close()1094	}1095	mut b := open_repo(machine('strip_held_b')!)!1096	defer {1097		b.close()1098	}1099	put(a.root, 'secrets.env', 'api_key=1\n')!1100	make_save(a, 'leak the key')!1101	offer_now(a, mut backend)!1102	join(b, mut backend)!1103	strip_local(b, 'secrets.env', '')!1104	put(a.root, 'keep.txt', 'fine\n')!1105	later := make_save(a, 'add keep')!1106	offer_now(a, mut backend)!1107	b.begin()!1108	write_fetched(b, fetch_back_to_known(b, mut backend, 'proj')!)!1109	b.end()!1110	paths := history.files_of(b, later.id)!.map(it.path)1111	assert 'secrets.env' !in paths1112	assert 'keep.txt' in paths1113}11141115// StripRace stands in for another machine that strips `path` completely, event1116// and rewrite, just before this machine's first save record lands.1117struct StripRace {1118mut:1119	inner remote.Backend1120	other &storage.Store1121	path  string1122	done  bool1123	// fail every put after the one the strip raced1124	fail_after_race bool1125	raced_put       bool1126}11271128fn (mut r StripRace) get(key string) !remote.Object {1129	return r.inner.get(key)!1130}11311132fn (mut r StripRace) list(prefix string) ![]string {1133	return r.inner.list(prefix)!1134}11351136fn (mut r StripRace) put_if_absent(key string, body []u8) !bool {1137	if r.fail_after_race && r.raced_put {1138		return error('injected write failure')1139	}1140	if !r.done && key.contains('/saves/') {1141		r.done = true1142		r.raced_put = true1143		strip_local(r.other, r.path, '')!1144		send_strip(r.other, mut r.inner, r.path)!1145	}1146	return r.inner.put_if_absent(key, body)!1147}11481149fn (mut r StripRace) put_if_match(key string, body []u8, tag string) !bool {1150	return r.inner.put_if_match(key, body, tag)!1151}11521153fn (mut r StripRace) delete(key string) ! {1154	r.inner.delete(key)!1155}11561157// A strip that finishes on another machine while an offer uploads has already1158// rewritten the remote without the offer's records, so the offer takes back1159// what the strip reaches and leaves head where it was.1160fn test_an_offer_racing_a_strip_leaves_no_stripped_path_behind() {1161	base := scratch('strip_race')!1162	defer {1163		os.rmdir_all(base) or {}1164	}1165	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1166	mut a := open_repo(machine('strip_race_a')!)!1167	defer {1168		a.close()1169	}1170	mut b := open_repo(machine('strip_race_b')!)!1171	defer {1172		b.close()1173	}1174	put(a.root, 'secrets.env', 'api_key=1\n')!1175	first := make_save(a, 'leak the key')!1176	offer_now(a, mut backend)!1177	join(b, mut backend)!1178	put(a.root, 'secrets.env', 'api_key=2\n')!1179	later := make_save(a, 'rotate the key')!1180	secret := history.files_of(a, later.id)!.filter(it.path == 'secrets.env')[0].hash1181	mut race := StripRace{1182		inner: backend1183		other: &b1184		path:  'secrets.env'1185	}1186	if _ := offer(a, mut race) {1187		assert false, 'an offer that raced a strip must refuse'1188	} else {1189		assert err.msg().contains('koh steal'), err.msg()1190	}1191	assert backend.get(head_key('proj'))!.body.bytestr() == first.id1192	assert !backend.get(object_key('proj', secret))!.found1193	for key in backend.list('proj/saves')! {1194		record := decode_save(backend.get(key)!.body)!1195		assert 'secrets.env' !in record.files.map(it.path), record.id1196	}1197}11981199// Doctor's resend of a missing record can race a strip just as an offer can,1200// and takes back what the strip reaches in the same way.1201fn test_a_resend_racing_a_strip_leaves_no_stripped_path_behind() {1202	base := scratch('resend_race')!1203	defer {1204		os.rmdir_all(base) or {}1205	}1206	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1207	mut a := open_repo(machine('resend_race_a')!)!1208	defer {1209		a.close()1210	}1211	mut b := open_repo(machine('resend_race_b')!)!1212	defer {1213		b.close()1214	}1215	put(a.root, 'secrets.env', 'api_key=1\n')!1216	first := make_save(a, 'leak the key')!1217	offer_now(a, mut backend)!1218	join(b, mut backend)!1219	backend.delete(save_key('proj', first.id))!1220	mut race := StripRace{1221		inner: backend1222		other: &b1223		path:  'secrets.env'1224	}1225	if _ := resend(a, mut race, 'proj', [], [first.id]) {1226		assert false, 'a resend that raced a strip must refuse'1227	} else {1228		assert err.msg().contains('koh steal'), err.msg()1229	}1230	// Head names the restored record, so it stays, less the stripped path.1231	record := decode_save(backend.get(save_key('proj', first.id))!.body)!1232	assert 'secrets.env' !in record.files.map(it.path)1233	assert !backend.get(object_key('proj', storage.hash_hex('api_key=1\n'.bytes())))!.found1234}12351236// An object a strip reaches stays while a remote record still lists it under1237// another path, and a strip that landed before an upload failed is still applied.1238fn test_a_resend_keeps_shared_bytes_and_settles_a_strip_after_a_failure() {1239	base := scratch('resend_shared')!1240	defer {1241		os.rmdir_all(base) or {}1242	}1243	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1244	mut a := open_repo(machine('resend_shared_a')!)!1245	defer {1246		a.close()1247	}1248	mut b := open_repo(machine('resend_shared_b')!)!1249	defer {1250		b.close()1251	}1252	put(a.root, 'secrets.env', 'same\n')!1253	put(a.root, 'copy.txt', 'same\n')!1254	first := make_save(a, 'two paths, one object')!1255	offer_now(a, mut backend)!1256	join(b, mut backend)!1257	put(a.root, 'later.txt', 'later\n')!1258	second := make_save(a, 'not offered')!1259	shared := object_key('proj', storage.hash_hex('same\n'.bytes()))1260	backend.delete(save_key('proj', first.id))!1261	backend.delete(shared)!1262	mut race := StripRace{1263		inner:           backend1264		other:           &b1265		path:            'secrets.env'1266		fail_after_race: true1267	}1268	if _ := resend(a, mut race, 'proj', [], [first.id, second.id]) {1269		assert false, 'the injected failure should have surfaced'1270	} else {1271		assert err.msg().contains('injected'), err.msg()1272	}1273	record := decode_save(backend.get(save_key('proj', first.id))!.body)!1274	paths := record.files.map(it.path)1275	assert 'secrets.env' !in paths && 'copy.txt' in paths, paths.str()1276	assert backend.get(shared)!.found1277}12781279// A note that does not parse, or that no recorded strip of its path backs, is1280// kept and changes nothing remote: sending it would lose the retry or strip1281// where no strip asked.1282fn test_an_untrusted_strip_note_is_kept_and_sends_nothing() {1283	base := scratch('strip_note')!1284	defer {1285		os.rmdir_all(base) or {}1286	}1287	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1288	mut a := open_repo(machine('strip_note_a')!)!1289	defer {1290		a.close()1291	}1292	put(a.root, 'app', 'app\n')!1293	save := make_save(a, 'app')!1294	offer_now(a, mut backend)!1295	events.strip(a, '', 'other')!1296	for note in ['not JSON', '{"saves":[""],"hashes":[]}'] {1297		a.set_state(pending_key('app'), note)!1298		if _ := send_strip(a, mut backend, 'app') {1299			assert false, 'an untrusted note must be refused'1300		} else {1301			assert err.msg().contains('kept for recovery'), err.msg()1302		}1303		assert a.state(pending_key('app')) or { '' } == note1304		assert backend.list(events_prefix('proj'))!.len == 01305		assert 'app' in decode_save(backend.get(save_key('proj', save.id))!.body)!.files.map(it.path)1306	}1307	// Even behind a recorded strip, a note's hashes may name only objects.1308	events.strip(a, '', 'app')!1309	victim := os.join_path(base, 'remote', 'victim', 'head')1310	os.mkdir_all(os.dir(victim))!1311	os.write_file(victim, 'another repo')!1312	a.set_state(pending_key('app'), '{"saves":[""],"hashes":["../../victim/head"]}')!1313	if _ := send_strip(a, mut backend, 'app') {1314		assert false, 'a note naming a path outside the objects must be refused'1315	}1316	assert os.read_file(victim)! == 'another repo'1317}13181319// The local half lands before the remote hears anything, so a remote failure1320// leaves nothing to find locally; the pending note is what lets a re-run1321// finish. Objects a remote-only save still needs must survive the strip.1322fn test_an_interrupted_remote_strip_finishes_when_re_run() {1323	base := scratch('strip_resume')!1324	defer {1325		os.rmdir_all(base) or {}1326	}1327	remote_dir := os.join_path(base, 'remote')1328	mut backend := remote.new_folder(remote_dir)!1329	mut a := open_repo(machine('resume_a')!)!1330	defer {1331		a.close()1332	}1333	mut b := open_repo(machine('resume_b')!)!1334	defer {1335		b.close()1336	}1337	put(a.root, 'secrets.env', 'api_key=1\n')!1338	put(a.root, 'shared.env', 'same bytes on B\n')!1339	save := make_save(a, 'add secrets')!1340	offer_now(a, mut backend)!1341	join(b, mut backend)!1342	put(b.root, 'copy.txt', 'same bytes on B\n')!1343	b_save := make_save(b, 'B keeps a copy')!1344	offer_now(b, mut backend)!1345	shared_hash := storage.hash_hex('same bytes on B\n'.bytes())1346	secret_hash := storage.hash_hex('api_key=1\n'.bytes())13471348	strip_local(a, 'secrets.env', '')!1349	// Write 1 uploads the event and write 2 rewrites the first record; B's save,1350	// made from A's tree, lists the file too, and its rewrite (write 3) fails.1351	mut flaky := FaultyBackend{1352		inner:      remote.new_folder(remote_dir)!1353		fail_write: 31354	}1355	if _ := send_strip(a, mut flaky, 'secrets.env') {1356		assert false, 'the injected failure should have surfaced'1357	}1358	assert strip_pending(a, 'secrets.env')1359	assert strip_local(a, 'secrets.env', '')!.files_removed == 01360	report := send_strip(a, mut backend, 'secrets.env')!1361	assert report.records == 11362	assert !strip_pending(a, 'secrets.env')1363	assert !backend.get(object_key('proj', secret_hash))!.found1364	record := decode_save(backend.get(save_key('proj', save.id))!.body)!1365	assert 'secrets.env' !in record.files.map(it.path)1366	b_record := decode_save(backend.get(save_key('proj', b_save.id))!.body)!1367	assert 'secrets.env' !in b_record.files.map(it.path)13681369	// B's save still names the shared bytes, so stripping A's copy keeps them.1370	strip_local(a, 'shared.env', '')!1371	send_strip(a, mut backend, 'shared.env')!1372	assert backend.get(object_key('proj', shared_hash))!.found1373}13741375// A machine that has not heard of a strip must not offer: its records still1376// list the stripped path, and nothing would rewrite them on the remote again.1377fn test_offer_waits_for_an_unapplied_strip() {1378	base := scratch('strip_first')!1379	defer {1380		os.rmdir_all(base) or {}1381	}1382	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1383	mut a := open_repo(machine('strip_first_a')!)!1384	defer {1385		a.close()1386	}1387	mut b := open_repo(machine('strip_first_b')!)!1388	defer {1389		b.close()1390	}1391	put(a.root, 'secrets.env', 'api_key=1\n')!1392	make_save(a, 'add secrets')!1393	offer_now(a, mut backend)!1394	join(b, mut backend)!1395	strip_local(a, 'secrets.env', '')!1396	send_strip(a, mut backend, 'secrets.env')!1397	put(b.root, 'more.txt', 'B keeps working\n')!1398	later := make_save(b, 'B saves with the secret still in its tree')!1399	if _ := offer_now(b, mut backend) {1400		assert false, 'B offered records that still list the stripped path'1401	}1402	steal_now(b, mut backend)!1403	offer_now(b, mut backend)!1404	record := decode_save(backend.get(save_key('proj', later.id))!.body)!1405	assert 'secrets.env' !in record.files.map(it.path)1406}14071408// A strip whose object deletions failed must still delete them when it is run1409// again, and meanwhile the banned path cannot come back in through a save.1410fn test_a_strip_whose_deletes_failed_finishes_when_run_again() {1411	base := scratch('strip_twice')!1412	defer {1413		os.rmdir_all(base) or {}1414	}1415	remote_dir := os.join_path(base, 'remote')1416	mut backend := remote.new_folder(remote_dir)!1417	mut a := open_repo(machine('strip_twice_a')!)!1418	defer {1419		a.close()1420	}1421	put(a.root, 'secrets.env', 'first key\n')!1422	make_save(a, 'first key')!1423	offer_now(a, mut backend)!1424	strip_local(a, 'secrets.env', '')!1425	mut flaky := FaultyBackend{1426		inner:       remote.new_folder(remote_dir)!1427		fail_delete: true1428	}1429	if _ := send_strip(a, mut flaky, 'secrets.env') {1430		assert false, 'the injected delete failure should have surfaced'1431	}1432	put(a.root, 'secrets.env', 'second key\n')!1433	put(a.root, 'other.txt', 'more work\n')!1434	make_save(a, 'more work')!1435	offer_now(a, mut backend)!1436	send_strip(a, mut backend, 'secrets.env')!1437	for key in ['first key\n', 'second key\n'] {1438		assert !backend.get(object_key('proj', storage.hash_hex(key.bytes())))!.found1439	}1440}14411442// Unfinished strips of one path in different scopes finish together.1443fn test_unfinished_strips_of_one_path_in_different_saves_finish_together() {1444	base := scratch('strip_scopes')!1445	defer {1446		os.rmdir_all(base) or {}1447	}1448	remote_dir := os.join_path(base, 'remote')1449	mut backend := remote.new_folder(remote_dir)!1450	mut a := open_repo(machine('strip_scopes_a')!)!1451	defer {1452		a.close()1453	}1454	put(a.root, 'secrets.env', 'first key\n')!1455	first := make_save(a, 'first key')!1456	put(a.root, 'secrets.env', 'second key\n')!1457	second := make_save(a, 'second key')!1458	offer_now(a, mut backend)!1459	strip_local(a, 'secrets.env', first.id)!1460	// Write 1 uploads the event; write 2, the record rewrite, fails.1461	mut flaky := FaultyBackend{1462		inner:      remote.new_folder(remote_dir)!1463		fail_write: 21464	}1465	if _ := send_strip(a, mut flaky, 'secrets.env') {1466		assert false, 'the injected failure should have surfaced'1467	}1468	strip_local(a, 'secrets.env', second.id)!1469	send_strip(a, mut backend, 'secrets.env')!1470	assert !strip_pending(a, 'secrets.env')1471	for save in [first, second] {1472		record := decode_save(backend.get(save_key('proj', save.id))!.body)!1473		assert 'secrets.env' !in record.files.map(it.path)1474	}1475	for key in ['first key\n', 'second key\n'] {1476		assert !backend.get(object_key('proj', storage.hash_hex(key.bytes())))!.found1477	}1478}14791480// A strip bans its path on every machine that has heard of it: written again,1481// the file makes no save, here or there, so there is never a second copy to strip.1482fn test_a_stripped_path_cannot_be_saved_again_on_any_machine() {1483	base := scratch('strip_again')!1484	defer {1485		os.rmdir_all(base) or {}1486	}1487	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1488	mut a := open_repo(machine('strip_again_a')!)!1489	defer {1490		a.close()1491	}1492	mut b := open_repo(machine('strip_again_b')!)!1493	defer {1494		b.close()1495	}1496	put(a.root, 'secrets.env', 'first key\n')!1497	make_save(a, 'first key')!1498	offer_now(a, mut backend)!1499	join(b, mut backend)!1500	strip_local(a, 'secrets.env', '')!1501	send_strip(a, mut backend, 'secrets.env')!1502	steal_now(b, mut backend)!1503	for repo in [a, b] {1504		put(repo.root, 'secrets.env', 'second key\n')!1505		if _ := make_save(repo, 'second key') {1506			assert false, 'a banned path must not make a save'1507		}1508	}1509}15101511// A clash on a path the other machine stripped is no clash: the strip removes1512// the path from every save, so there is nothing to choose.1513fn test_a_stripped_path_is_not_asked_about() {1514	base := scratch('clash_strip')!1515	defer {1516		os.rmdir_all(base) or {}1517	}1518	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1519	mut a := open_repo(machine('clash_strip_a')!)!1520	defer {1521		a.close()1522	}1523	mut b := open_repo(machine('clash_strip_b')!)!1524	defer {1525		b.close()1526	}1527	put(a.root, 'secrets.env', 'key one\n')!1528	make_save(a, 'base')!1529	offer_now(a, mut backend)!1530	join(b, mut backend)!1531	put(a.root, 'secrets.env', 'key two\n')!1532	make_save(a, 'A rotates')!1533	offer_now(a, mut backend)!1534	strip_local(a, 'secrets.env', '')!1535	send_strip(a, mut backend, 'secrets.env')!1536	put(b.root, 'secrets.env', 'key three\n')!1537	mine := make_save(b, 'B rotates')!1538	report := steal(b, mut backend, StealOptions{})!1539	assert report.clashes.len == 01540	for save in history.all_saves(b)! {1541		assert 'secrets.env' !in history.files_of(b, save.id)!.map(it.path)1542	}1543	assert history.by_id(b, mine.id) != none1544}15451546// A strip scoped to the shared base save changes what the replay sees; the1547// clashes must be found on the same trees, or the replay meets a conflict.1548fn test_a_strip_of_the_shared_base_is_seen_before_asking() {1549	base := scratch('clash_base_strip')!1550	defer {1551		os.rmdir_all(base) or {}1552	}1553	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1554	mut a := open_repo(machine('base_strip_a')!)!1555	defer {1556		a.close()1557	}1558	mut b := open_repo(machine('base_strip_b')!)!1559	defer {1560		b.close()1561	}1562	put(a.root, 'notes.txt', 'shared\n')!1563	common := make_save(a, 'base')!1564	offer_now(a, mut backend)!1565	join(b, mut backend)!1566	put(a.root, 'other.txt', 'A moves on\n')!1567	make_save(a, 'A moves on')!1568	offer_now(a, mut backend)!1569	strip_local(a, 'notes.txt', common.id)!1570	send_strip(a, mut backend, 'notes.txt')!1571	put(b.root, 'notes.txt', 'B edits\n')!1572	make_save(b, 'B edits notes')!1573	if _ := steal(b, mut backend, StealOptions{}) {1574		assert false, 'with the base stripped, notes.txt differs on both sides'1575	} else {1576		assert err.msg().contains('notes.txt changed on both machines')1577	}1578	report := steal(b, mut backend, StealOptions{1579		mine: true1580	})!1581	assert report.clashes == ['notes.txt']1582	assert os.read_file(os.join_path(b.root, 'notes.txt'))! == 'B edits\n'1583}15841585// A folder with files but no saves has nothing to combine with; a steal that1586// fast-forwarded into it would overwrite whatever shares a name.1587fn test_steal_into_a_folder_with_unsaved_files_refuses() {1588	base := scratch('steal_unsaved')!1589	defer {1590		os.rmdir_all(base) or {}1591	}1592	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1593	mut a := open_repo(machine('unsaved_a')!)!1594	defer {1595		a.close()1596	}1597	put(a.root, 'notes.txt', 'from A\n')!1598	make_save(a, 'A writes')!1599	offer_now(a, mut backend)!1600	b_root := machine('unsaved_b')!1601	mut b := storage.create(b_root)!1602	defer {1603		b.close()1604	}1605	put(b_root, 'notes.txt', 'never saved\n')!1606	// Only a repo that already knows its remote name gets this far.1607	b.set_state('remote_repo', 'proj')!1608	if _ := steal(b, mut backend, StealOptions{}) {1609		assert false, 'steal overwrote a folder with unsaved files'1610	} else {1611		assert err.msg() == no_saves_here1612	}1613	assert os.read_file(os.join_path(b_root, 'notes.txt'))! == 'never saved\n'1614	// A fresh `koh init` folder, holding only the default ignore list, is fine.1615	os.rm(os.join_path(b_root, 'notes.txt'))!1616	put(b_root, snapshot.ignore_file, snapshot.default_ignore)!1617	steal(b, mut backend, StealOptions{})!1618	assert os.read_file(os.join_path(b_root, 'notes.txt'))! == 'from A\n'1619}16201621// The document asks steal to warn about every incoming flagged save, so the1622// report names them.1623fn test_steal_reports_incoming_flagged_saves() {1624	base := scratch('flag_warn')!1625	defer {1626		os.rmdir_all(base) or {}1627	}1628	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1629	mut a := open_repo(machine('flag_warn_a')!)!1630	defer {1631		a.close()1632	}1633	mut b := open_repo(machine('flag_warn_b')!)!1634	defer {1635		b.close()1636	}1637	put(a.root, 'a.txt', 'one\n')!1638	make_save(a, 'fine')!1639	offer_now(a, mut backend)!1640	join(b, mut backend)!1641	put(a.root, 'a.txt', 'two\n')!1642	suspect := make_save(a, 'suspect')!1643	put(a.root, 'a.txt', 'three\n')!1644	make_save(a, 'also fine')!1645	events.flag(a, suspect.id, 'broke the build')!1646	offer_now(a, mut backend)!1647	report := steal_now(b, mut backend)!1648	assert report.flagged.map(it.save_id) == [suspect.id]1649	assert report.flagged[0].reason == 'broke the build'1650}16511652// head_of unwraps the head for tests that know the repo has saves.1653fn head_of(store &storage.Store) history.Save {1654	return history.head(store) or { panic('this repo has no head') }1655}16561657// A remote says what it is, so two koh versions never half-understand one1658// bucket. The first offer of a repo records the layout.1659fn test_the_first_offer_records_the_remote_format() {1660	base := scratch('format_write')!1661	defer {1662		os.rmdir_all(base) or {}1663	}1664	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1665	mut a := open_repo(machine('format_write_a')!)!1666	defer {1667		a.close()1668	}1669	put(a.root, 'a.txt', 'one\n')!1670	make_save(a, 'first')!1671	offer_now(a, mut backend)!1672	assert backend.get(format_key('proj'))!.body.bytestr().trim_space() == format_value1673}16741675// A repo offered before the key existed is version 1: it still syncs, and the1676// next offer records the key then.1677fn test_a_remote_without_a_format_still_syncs() {1678	base := scratch('format_old')!1679	defer {1680		os.rmdir_all(base) or {}1681	}1682	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1683	mut a := open_repo(machine('format_old_a')!)!1684	defer {1685		a.close()1686	}1687	put(a.root, 'a.txt', 'one\n')!1688	make_save(a, 'first')!1689	offer_now(a, mut backend)!1690	// Stand in for a bucket offered before the key existed.1691	backend.delete(format_key('proj'))!1692	mut b := open_repo(machine('format_old_b')!)!1693	defer {1694		b.close()1695	}1696	join(b, mut backend)!1697	assert head_of(b).id == head_of(a).id1698	put(a.root, 'a.txt', 'two\n')!1699	make_save(a, 'second')!1700	offer_now(a, mut backend)!1701	assert backend.get(format_key('proj'))!.body.bytestr().trim_space() == format_value1702	report := steal_now(b, mut backend)!1703	assert report.head == head_of(a).id1704}17051706// A remote that speaks another layout is refused loudly, on offer and on1707// steal, rather than half-read.1708fn test_an_unknown_remote_format_is_refused() {1709	base := scratch('format_unknown')!1710	defer {1711		os.rmdir_all(base) or {}1712	}1713	mut backend := remote.new_folder(os.join_path(base, 'remote'))!1714	mut a := open_repo(machine('format_bad_a')!)!1715	defer {1716		a.close()1717	}1718	put(a.root, 'a.txt', 'one\n')!1719	make_save(a, 'first')!1720	offer_now(a, mut backend)!1721	backend.delete(format_key('proj'))!1722	backend.put_if_absent(format_key('proj'), 'koh-remote 2'.bytes())!1723	if _ := offer_now(a, mut backend) {1724		assert false, 'offer must refuse a format it does not speak'1725	} else {1726		assert err.msg().contains('koh-remote 2')1727	}1728	if _ := steal_now(a, mut backend) {1729		assert false, 'steal must refuse a format it does not speak'1730	} else {1731		assert err.msg().contains('koh-remote 2')1732	}1733	if _ := fetch_repo(mut backend, 'proj') {1734		assert false, 'a steal must refuse a format it does not speak'1735	} else {1736		assert err.msg().contains('koh-remote 2')1737	}1738}17391740// Two machines offering a new repo at once both find no format key; the loser1741// of the conditional write must read back the winner's value and refuse it,1742// not carry on against a remote it cannot read.1743fn test_a_lost_format_write_is_read_back_and_refused() {1744	base := scratch('format_race')!1745	defer {1746		os.rmdir_all(base) or {}1747	}1748	mut inner := remote.new_folder(os.join_path(base, 'remote'))!1749	mut a := open_repo(machine('format_race_a')!)!1750	defer {1751		a.close()1752	}1753	put(a.root, 'a.txt', 'one\n')!1754	make_save(a, 'first')!1755	mut backend := remote.Backend(FaultyBackend{1756		inner:       inner1757		race_format: true1758	})1759	if _ := offer_now(a, mut backend) {1760		assert false, 'offer must refuse the format another machine wrote first'1761	} else {1762		assert err.msg().contains('koh-remote 2')1763	}1764}17651766fn test_a_bundle_lands_each_entry_however_it_is_split_and_refuses_a_cut_or_foreign_one() {1767	whole := 'objects/aa 3\nabcobjects/bb 0\nend 0\n'1768	for size in [1, 2, 5, whole.len] {1769		mut bundle := Bundle{}1770		for at := 0; at < whole.len; at += size {1771			bundle.feed(whole[at..int_min(at + size, whole.len)].bytes())!1772		}1773		bundle.finish()!1774		assert bundle.fetched.repo_objects == {1775			'aa': 'abc'.bytes()1776			'bb': []u8{}1777		}1778	}1779	for cut in ['objects/aa 3\nabc', 'objects/aa 4\nabc', 'objects/aa 3', 'objects/aa x\nabc',1780		'releases/v1 1\nx', 'end 0\nobjects/aa 3\nabc'] {1781		mut bundle := Bundle{}1782		bundle.feed(cut.bytes()) or { continue }1783		bundle.finish() or { continue }1784		assert false, cut1785	}1786}17871788fn test_strip_batch_rolls_back_all_paths_and_handles_overlap() {1789	mut store := open_repo(machine('strip_batch')!)!1790	defer { store.close() }1791	put(store.root, 'private/a', 'a')!1792	put(store.root, 'secret', 'secret')!1793	put(store.root, 'keep', 'keep')!1794	save := make_save(store, 'initial')!1795	store.db.exec("CREATE TRIGGER block_secret BEFORE DELETE ON save_files1796		WHEN OLD.path = 'secret' BEGIN SELECT RAISE(ABORT, 'blocked'); END")!1797	if _ := strip_local_batch(store, ['private', 'secret'], '') {1798		assert false, 'batch succeeded despite the second path failing'1799	}1800	assert history.files_of(store, save.id)!.map(it.path) == ['.kohignore', 'keep', 'private/a',1801		'secret']1802	assert events.strip_events(store)!.len == 01803	assert !strip_pending(store, 'private')1804	store.db.exec('DROP TRIGGER block_secret')!1805	reports := strip_local_batch(store, ['private', 'private/a', 'secret'], '')!1806	assert reports.map(it.files_removed) == [1, 0, 1]1807	assert history.files_of(store, save.id)!.map(it.path) == ['.kohignore', 'keep']1808	assert events.strip_events(store)!.len == 21809}18101811fn test_strip_batch_limits_every_path_to_selected_save() {1812	mut store := open_repo(machine('strip_batch_scope')!)!1813	defer { store.close() }1814	put(store.root, 'one', 'one')!1815	put(store.root, 'two', 'two')!1816	first := make_save(store, 'initial')!1817	put(store.root, 'keep', 'keep')!1818	second := make_save(store, 'next')!1819	strip_local_batch(store, ['one', 'two'], first.id)!1820	assert history.files_of(store, first.id)!.map(it.path) == ['.kohignore']1821	assert history.files_of(store, second.id)!.map(it.path) == ['.kohignore', 'keep', 'one', 'two']1822	assert events.strip_events(store)!.all(it.save_id == first.id)1823}18241825fn test_strip_batch_keeps_independent_remote_retry_notes() {1826	mut backend := remote.new_folder(scratch('strip_batch_remote')!)!1827	mut store := open_repo(machine('strip_batch_retry')!)!1828	defer { store.close() }1829	put(store.root, 'one', 'secret')!1830	put(store.root, 'two', 'secret')!1831	save := make_save(store, 'initial')!1832	offer_now(store, mut backend)!1833	strip_local_batch(store, ['one', 'two'], '')!1834	mut flaky := FaultyBackend{ inner: backend, fail_write: 1 }1835	if _ := send_strip(store, mut flaky, 'one') {1836		assert false, 'injected remote failure was not reported'1837	}1838	send_strip(store, mut backend, 'two')!1839	assert strip_pending(store, 'one') && !strip_pending(store, 'two')1840	partial := decode_save(backend.get(save_key('proj', save.id))!.body)!1841	assert partial.files.map(it.path) == ['.kohignore', 'one']1842	assert backend.get(object_key('proj', storage.hash_hex('secret'.bytes())))!.found1843	send_strip(store, mut backend, 'one')!1844	assert !strip_pending(store, 'one')1845	finished := decode_save(backend.get(save_key('proj', save.id))!.body)!1846	assert finished.files.map(it.path) == ['.kohignore']1847	assert !backend.get(object_key('proj', storage.hash_hex('secret'.bytes())))!.found1848}