╭─────────────╮ │scroll to top│ ╰─────────────╯ ╭ try.zig ──────────────────────────────────────────────────────╮ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ╰───────────────────────────────────────────────────────────────╯
🬐 🬠 🬞🬂🬏 🬟 🬑 🬟 🬑 ╭f1323b6e..╮ f1323b6e.. haxy: 🬋🬋🬋 🬋🬋🬋 🬋 🬋 │files │ commits refs discuss issues patches new login 🬐 🬠 🬐 🬠 🬑 🬟 🬰 ╰──────────╯ (686) user
╭────╮ ╭ clone ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─╮ │http│ ssh │ │ ╰────╯ ╰ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─╯
.. embed/ event/ test/ ui/ command.zig diff3.zig event.zig find.zig fork.zig lib.zig main.zig main_wasm.zig markdown.zig notify.zig patch.zig progress.zig push.zig search.zig search_commit.zig search_thread.zig serve.zig serve_common.zig serve_http.zig serve_ssh.zig serve_ssh_protocol.zig test.zig testnet.zig ╭─────────────────────────────────╮ │try.zig │ ╰─────────────────────────────────╯ ui.zig web.zig
632 .title = "Deprecate the legacy plugin format", 633 .description = "Both plugin formats are currently loaded, doubling the maintenance surface.\n\n- [ ] warn on legacy plugins this release\n- [ ] drop support in the next", 634 .labels = "maintenance plugins", 635 }, 636 }; 637 638 var issue_events: [issue_data.len]evt.EventWithId = undefined; 639 for (issue_data, 0..) |issue, i| { 640 // the fifth-newest issue's description runs past what the detail 641 // pane shows, so it shows the truncated description and its 642 // link. 643 const description = if (i == issue_data.len - 5) 644 try longDescription(arena.allocator(), issue.description) 645 else 646 issue.description; 647 issue_events[i] = .{ 648 .id = std.fmt.bytesToHex(evt.EventWithId.randomId(prng.random()), .lower), 649 // threads span several weeks, with time for replies on the newest one 650 .timestamp = seedTimestamp(now, i, issue_data.len, 25 * std.time.s_per_day, 3 * std.time.s_per_hour), 651 .author = .{ .name = user_data[i % user_data.len].name, .email = user_data[i % user_data.len].email }, 652 .event = .{ 653 .issue = .{ 654 .title = issue.title, 655 .description = description, 656 .labels = issue.labels, 657 .status = issue.status, 658 }, 659 }, 660 }; 661 } 662 try evt.consume(.local, .repo, .xit, .{}, io, allocator, &template_repo, evt.events_ref, &issue_events); 663 // the tip is the branch point for the conflicting edits below 664 const seed_tip = (try template_repo.readRef(io, evt.events_ref)) orelse unreachable; 665 666 // two divergent edits per conflicted issue: ours on the events 667 // branch, theirs on a temp branch rooted at the seed tip, then a 668 // merge. the 4th-newest issue conflicts on title and labels; the 669 // 3rd-newest on its description with every hunk auto-resolving 670 // (each side reworks a different paragraph); the 2nd-newest on 671 // its description with a removal conflict (ours removes a 672 // paragraph theirs rewords) and an insertion conflict (each side 673 // appends a different closing paragraph). 674 { 675 const other_ref: xit.ref.Ref = .{ .kind = .head, .name = "haxy/other" }; 676 const title_issue = issue_data[issue_data.len - 4]; 677 const sync_issue = issue_data[issue_data.len - 3]; 678 const desc_issue = issue_data[issue_data.len - 2]; 679 680 const ours = [_]evt.EventWithId{ .{ 681 .id = issue_events[issue_data.len - 4].id, 682 .timestamp = now - 120 * std.time.s_per_min, 683 .author = .{ .name = user_data[1].name, .email = user_data[1].email }, 684 .event = .{ .issue = .{ 685 .title = "Crash when resizing the window during the splash animation", 686 .description = title_issue.description, 687 .labels = "bug crash ui priority-high", 688 } }, 689 }, .{ 690 .id = issue_events[issue_data.len - 3].id, 691 .timestamp = now - 115 * std.time.s_per_min, 692 .author = .{ .name = user_data[1].name, .email = user_data[1].email }, 693 .event = .{ .issue = .{ 694 .title = sync_issue.title, 695 .description = "The sync engine's coverage is *unit tests* only, with every transport mocked out." ++ "\n\n" ++ 696 sync_p2 ++ "\n\n" ++ sync_p3, 697 .labels = sync_issue.labels, 698 } }, 699 }, .{ 700 .id = issue_events[issue_data.len - 2].id, 701 .timestamp = now - 110 * std.time.s_per_min, 702 .author = .{ .name = user_data[1].name, .email = user_data[1].email }, 703 .event = .{ .issue = .{ 704 .title = desc_issue.title, 705 .description = tz_p1 ++ "\n\n" ++ tz_p2 ++ "\n\n" ++ tz_p4 ++ "\n\n" ++ 706 "> The confusion is worst for teams spread across timezones, who each read a different wall-clock time from the same feed.", 707 .labels = desc_issue.labels, 708 } }, 709 } }; 710 const theirs = [_]evt.EventWithId{ .{ 711 .id = issue_events[issue_data.len - 4].id, 712 .timestamp = now - 105 * std.time.s_per_min, 713 .author = .{ .name = user_data[2].name, .email = user_data[2].email }, 714 .event = .{ .issue = .{ 715 .title = "Segfault on early window resize", 716 .description = title_issue.description, 717 .labels = "bug crash rendering", 718 } }, 719 }, .{ 720 .id = issue_events[issue_data.len - 3].id, 721 .timestamp = now - 100 * std.time.s_per_min, 722 .author = .{ .name = user_data[2].name, .email = user_data[2].email }, 723 .event = .{ .issue = .{ 724 .title = sync_issue.title, 725 .description = sync_p1 ++ "\n\n" ++ sync_p2 ++ "\n\n" ++ 726 "Add end-to-end tests that drive two live instances against a local server on **every** CI run.", 727 .labels = sync_issue.labels, 728 } }, 729 }, .{ 730 .id = issue_events[issue_data.len - 2].id, 731 .timestamp = now - 95 * std.time.s_per_min, 732 .author = .{ .name = user_data[2].name, .email = user_data[2].email }, 733 .event = .{ .issue = .{ 734 .title = desc_issue.title, 735 .description = tz_p1 ++ "\n\n" ++ tz_p2 ++ "\n\n" ++ 736 "Most other clients already render local time by default, which makes our `UTC` output stand out as a bug." ++ "\n\n" ++ tz_p4 ++ "\n\n" ++ 737 "Log exports inherit the same UTC rendering, so downstream tooling has to *guess* the source timezone.", 738 .labels = desc_issue.labels, 739 } }, 740 } }; 741 742 try evt.consume(.local, .repo, .xit, .{}, io, allocator, &template_repo, evt.events_ref, &ours); 743 744 try commitEventsAtRef(io, allocator, &template_repo, other_ref, &theirs, seed_tip); 745 746 { 747 var to_events = try template_repo.switchDir(io, allocator, .{ .target = .{ .ref = evt.events_ref } }); 748 defer to_events.deinit(); 749 } 750 { 751 var merge = try template_repo.merge(io, allocator, .{ .kind = .full, .action = .{ .new = .{ .source = &.{.{ .ref = other_ref }} } } }, null); 752 defer merge.deinit(); 753 if (merge.result != .success) return error.MergeFailed; 754 } 755 { 756 var to_master = try template_repo.switchDir(io, allocator, .{ .target = .{ .ref = .{ .kind = .head, .name = "master" } } }); 757 defer to_master.deinit(); 758 } 759 try template_repo.removeBranch(io, .{ .name = other_ref.name }); 760 } 761 762 try evt.consume(.local, .repo, .xit, .{}, io, allocator, &template_repo, evt.events_ref, &.{}); 763 764 // seed a small comment tree on the newest issue 765 var comment_ids: [5][evt.event_id_size]u8 = undefined; 766 for (&comment_ids) |*id| id.* = evt.EventWithId.randomId(prng.random()); 767 768 const comment_bodies = [_][]const u8{ 769 "I can take this. The compatibility scanner already reports which repositories still use the **legacy** format.", 770 "Can we keep loading legacy plugins for *one release* after the warning lands? That would give downstream maintainers time to migrate.", 771 "That sounds good. I'll include the scanner output in the warning so each affected plugin is named:\n\n```\nwarning: plugins/foo.so uses the legacy format\n```", 772 "Please include the replacement manifest path too. That should make the warning actionable without opening the [migration guide](https://github.com/xit-vcs/haxy).", 773 "I'll add release-note text once the warning format is settled:\n\n- [x] draft the summary\n- [ ] list the affected plugins", 774 }; 775 776 var comment_events: [comment_ids.len]evt.EventWithId = undefined; 777 for (&comment_events, 0..) |*event, i| { 778 event.* = .{ 779 .id = std.fmt.bytesToHex(comment_ids[i], .lower), 780 .timestamp = seedTimestamp(now, i, comment_events.len, 2 * std.time.s_per_hour, 45), 781 .author = .{ .name = user_data[(i + 1) % user_data.len].name, .email = user_data[(i + 1) % user_data.len].email }, 782 .event = .{ .comment = .{ 783 .thread_id = issue_events[issue_events.len - 1].id, 784 .parent_id = switch (i) { 785 0, 1 => issue_events[issue_events.len - 1].id, 786 2, 4 => std.fmt.bytesToHex(comment_ids[0], .lower), 787 3 => std.fmt.bytesToHex(comment_ids[2], .lower), 788 else => unreachable, 789 }, 790 .body = comment_bodies[i], 791 } }, 792 }; 793 } 794 try evt.consume(.local, .repo, .xit, .{}, io, allocator, &template_repo, evt.events_ref, &comment_events); 795 796 // assign a few issues so the assignee filter has something to show: 797 // alice and bobby share the newest issue, alice also holds the one 798 // before it, and admin an older one 799 const assignment_data = [_]struct { issue: usize, user: usize }{ 800 .{ .issue = issue_data.len - 1, .user = 1 }, 801 .{ .issue = issue_data.len - 1, .user = 2 }, 802 .{ .issue = issue_data.len - 2, .user = 1 }, 803 .{ .issue = issue_data.len - 5, .user = 0 }, 804 }; 805 var assignment_events: [assignment_data.len]evt.EventWithId = undefined; 806 for (&assignment_events, assignment_data, 0..) |*event, assignment, i| { 807 const thread_id = issue_events[assignment.issue].id; 808 const email = user_data[assignment.user].email; 809 event.* = .{ 810 .id = std.fmt.bytesToHex(evt.Assignment.idOf(&try evt.parseEventId(&thread_id), email), .lower), 811 .timestamp = seedTimestamp(now, i, assignment_events.len, 90 * std.time.s_per_min, 20 * std.time.s_per_min), 812 .author = .{ .name = user_data[0].name, .email = user_data[0].email }, 813 .event = .{ .assign = .{ .thread_id = thread_id, .email = email } }, 814 }; 815 } 816 try evt.consume(.local, .repo, .xit, .{}, io, allocator, &template_repo, evt.events_ref, &assignment_events); 817 818 // a comment on admin's assigned issue, which notifies admin as its assignee 819 { 820 const thread_id = issue_events[issue_data.len - 5].id; 821 admin_thread_ids[1] = try evt.parseEventId(&thread_id); 822 try evt.consume(.local, .repo, .xit, .{}, io, allocator, &template_repo, evt.events_ref, &.{.{ 823 .id = std.fmt.bytesToHex(evt.EventWithId.randomId(prng.random()), .lower), 824 .timestamp = now - 15 * std.time.s_per_min, 825 .author = .{ .name = user_data[3].name, .email = user_data[3].email }, 826 .event = .{ .comment = .{ .thread_id = thread_id, .parent_id = thread_id, .body = "Is this still on your list? I can pick it up if you're busy." } }, 827 }}); 828 } 829 830 const discussion_data = [_]struct { 831 title: []const u8, 832 description: []const u8, 833 labels: []const u8, 834 }{ 835 .{ 836 .title = "How should plugins declare capabilities?", 837 .description = "I'd like the manifest to make **privileged** capabilities explicit without making simple plugins verbose.", 838 .labels = "plugins design", 839 }, 840 .{ 841 .title = "Ideas for making large repositories faster", 842 .description = "This is a place to collect *profiling results* and discuss which indexing work is worth pursuing first.", 843 .labels = "performance indexing", 844 }, 845 .{ 846 .title = "What should the next release focus on?", 847 .description = "Let's compare the most important reliability fixes with the larger features already in progress, starting from https://github.com/xit-vcs/haxy.", 848 .labels = "release planning", 849 }, 850 .{ 851 .title = "Improving keyboard navigation", 852 .description = "Share workflows that still **require a mouse** and suggestions for making their focus behavior predictable.", 853 .labels = "ui keyboard accessibility", 854 }, 855 .{ 856 .title = "Configuration format discussion", 857 .description = "Should the next configuration format favor *strict validation* or accept common conveniences such as trailing commas?", 858 .labels = "config design", 859 }, 860 }; 861 862 var discussion_events: [discussion_data.len]evt.EventWithId = undefined; 863 for (discussion_data, 0..) |discussion, i| { 864 discussion_events[i] = .{ 865 .id = std.fmt.bytesToHex(evt.EventWithId.randomId(prng.random()), .lower), 866 .timestamp = seedTimestamp(now, i, discussion_data.len, 21 * std.time.s_per_day, 2 * std.time.s_per_hour), 867 .author = .{ .name = user_data[i % user_data.len].name, .email = user_data[i % user_data.len].email }, 868 .event = .{ .discuss = .{ 869 .title = discussion.title, 870 .description = discussion.description, 871 .labels = discussion.labels, 872 } }, 873 }; 874 } 875 try evt.consume(.local, .repo, .xit, .{}, io, allocator, &template_repo, evt.events_ref, &discussion_events); 876 admin_thread_ids[0] = try evt.parseEventId(&discussion_events[0].id); 877 878 var discussion_comment_ids: [discussion_data.len][3][evt.event_id_size]u8 = undefined; 879 for (&discussion_comment_ids) |*ids| { 880 for (ids) |*id| id.* = evt.EventWithId.randomId(prng.random()); 881 } 882 var discussion_comment_events: [discussion_data.len * 3]evt.EventWithId = undefined; 883 for (&discussion_comment_events, 0..) |*event, i| { 884 const discussion_index = i / 3; 885 const comment_index = i % 3; 886 event.* = .{ 887 .id = std.fmt.bytesToHex(discussion_comment_ids[discussion_index][comment_index], .lower), 888 .timestamp = seedTimestamp(now, i, discussion_comment_events.len, 90 * std.time.s_per_min, 30), 889 .author = .{ .name = user_data[(i + 1) % user_data.len].name, .email = user_data[(i + 1) % user_data.len].email }, 890 .event = .{ .comment = .{ 891 .thread_id = discussion_events[discussion_index].id, 892 .parent_id = if (comment_index < 2) 893 discussion_events[discussion_index].id 894 else 895 std.fmt.bytesToHex(discussion_comment_ids[discussion_index][0], .lower), 896 .body = switch (comment_index) { 897 0 => "My preference is to start with the **smallest useful version** and expand it after we have real usage to learn from.", 898 1 => "It would help to *write down* the tradeoffs we are accepting so the decision is easy to revisit later.", 899 2 => "> A narrow first version\n\nAgreed. It should also make it easier to keep the implementation understandable.", 900 else => unreachable, 901 }, 902 } }, 903 }; 904 } 905 try evt.consume(.local, .repo, .xit, .{}, io, allocator, &template_repo, evt.events_ref, &discussion_comment_events); 906 try template_repo.patchAll(io, allocator, null); 907 try template_repo.addConfig(io, allocator, .{ .name = "core.bare", .value = "true" }); 908 try transaction(io, &template_repo, Reindex{ .io = io, .allocator = allocator, .core = &template_repo.core, .commits = true }); 909 // clear history only after indexing has written its transactions. 910 { 911 const moment = try evt.currentMoment(.{}, &template_repo); 912 const roots = try evt.PatchRev.gcRoots(rp.Repo(.xit, .{}).DB, .sha1, allocator, moment); 913 defer allocator.free(roots); 914 _ = try template_repo.garbageCollect(io, allocator, .{ .extra_roots = roots }); 915 } 916 } 917 918 // copy the template to each repo's on-disk location, named by its 919 // hex-encoded event id. the template repo is deinitialized above, so its 920 // db file is fully written before we copy it. 921 { 922 var template_dir = try cwd.openDir(io, template_path, .{}); 923 defer template_dir.close(io); 924 var template_repo_dir = try template_dir.openDir(io, ".xit", .{ .iterate = true }); 925 defer template_repo_dir.close(io); 926 927 for (repo_event_ids, 0..) |id_bytes, repo_index| { 928 const repo_path = try evt.repoPath(arena.allocator(), users_dir, &user_ids[repo_data[repo_index].user_index], &id_bytes); 929 { 930 var dest_dir = try cwd.createDirPathOpen(io, repo_path, .{}); 931 defer dest_dir.close(io); 932 var dest_repo_dir = try dest_dir.createDirPathOpen(io, ".xit", .{}); 933 defer dest_repo_dir.close(io); 934 try copyDir(io, template_repo_dir, dest_repo_dir); 935 } 936 937 if (repo_index + 1 == repo_data.len) { 938 var target_repo = try rp.Repo(.xit, .{}).open(io, allocator, .{ .path = repo_path, .require_repo_root = true }); 939 defer target_repo.deinit(io, allocator); 940 admin_thread_ids[2] = try seedPatches(io, allocator, server_path, &repo, &target_repo, &repo_event_ids[repo_index], &user_ids[repo_data[repo_index].user_index], &admin_user_id, prng.random(), now); 941 } 942 } 943 } 944 945 // seeding consumed locally, which subscribes nobody, so subscribe admin as the server 946 // would have, then deliver the notifications of its own repos the way the worker does 947 for (repo_data, repo_event_ids, 0..) |r, id_bytes, repo_index| { 948 if (r.user_index != 0) continue; 949 const location: evt.RepoLocation = .{ .owner_id = user_ids[r.user_index], .repo_id = id_bytes }; 950 // only the last repo has patches 951 const thread_ids: []const [evt.event_id_size]u8 = if (repo_index + 1 == repo_data.len) &admin_thread_ids else admin_thread_ids[0..2]; 952 for (thread_ids) |*thread_id| try notify.subscribe(io, allocator, users_dir, &admin_user_id, location, thread_id, .{ .name = user_data[0].name, .email = user_data[0].email }); 953 try notify.notifyRepo(io, allocator, users_dir, work_path, location); 954 } 955 956 break :blk try ui.Session.init(&session_arena, &repo, .{ .user_id = &admin_user_id }); 957 }; 958 session.is_terminal = true; 959 session.color = std.mem.eql(u8, init.environ_map.get("NO_COLOR") orelse "", ""); 960 session.data.git_ssh_prefix = git_ssh_prefix; 961 962 // start the server 963 964 // let the native TUI's page builders open the on-disk repos for the file tree 965 session.io = io; 966 session.users_dir = try std.Io.Dir.path.join(session_arena.allocator(), &.{ server_path, "users" }); 967 968 // leave a one-shot session for the first browser to hit the web ui, so it 969 // starts logged in as admin 970 { 971 var data_dir = try cwd.createDirPathOpen(io, server_path, .{}); 972 defer data_dir.close(io); 973 const store = try hx.web.SessionStore.init(io, data_dir); 974 defer store.deinit(); 975 const token = try store.create(&admin_user_id); 976 try store.offerAutoLogin(&token); 977 } 978 979 if (cli) { 980 var stdout_writer = std.Io.File.stdout().writer(io, &.{}); 981 var stderr_writer = std.Io.File.stderr().writer(io, &.{}); 982 const run_opts = hx.main.RunOpts{ .out = &stdout_writer.interface, .err = &stderr_writer.interface }; 983 984 const Runnable = struct { 985 io: std.Io, 986 key_path: []const u8, 987 988 pub fn run(self: @This(), web_port: u16, http_port: ?u16, ssh_port_maybe: ?u16) !void { 989 _ = web_port; 990 _ = http_port; 991 const ssh_port = ssh_port_maybe orelse return error.SshDisabled; 992 std.debug.print( 993 \\ 994 \\connect to the TUI with: 995 \\ ssh -p {d} -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null localhost 996 \\ 997 \\create a git repo and push over SSH: 998 \\ mkdir -p temp-try/client/test 999 \\ cd temp-try/client/test 1000 \\ git init 1001 \\ echo "hello" > hello.txt 1002 \\ git add hello.txt 1003 \\ git commit -m "let there be light" 1004 \\ GIT_SSH_COMMAND='ssh -p {d} -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o IdentitiesOnly=yes -i {s}' git push localhost:admin:test HEAD:master 1005 \\ 1006 \\to quit, press enter. 1007 \\ 1008 , .{ ssh_port, ssh_port, self.key_path }); 1009 // portable stdin read via std.Io — equivalent to the 1010 // std.posix.read(STDIN_FILENO, ...) that doesn't compile 1011 // on windows. 1012 var buf: [1]u8 = undefined; 1013 var stdin_reader = std.Io.File.stdin().reader(self.io, &buf); 1014 _ = stdin_reader.interface.takeByte() catch {}; 1015 } 1016 }; 1017 1018 try srv.run(.xit, .{}, io, allocator, cwd_path, serve_options, run_opts.err, Runnable{ .io = io, .key_path = key_path }); 1019 } else { 1020 var null_writer = std.Io.Writer.Discarding.init(&.{}); 1021 const run_opts = hx.main.RunOpts{ .out = &null_writer.writer, .err = &null_writer.writer }; 1022 1023 const Runnable = struct { 1024 io: std.Io, 1025 allocator: std.mem.Allocator, 1026 session: *ui.Session, 1027 repo: *Repo, 1028 1029 pub fn run(self: @This(), web_port: u16, http_port: ?u16, ssh_port: ?u16) !void { 1030 // launch the TUI; the footer points at whatever port was bound 1031 self.session.web_port = web_port; 1032 self.session.data.git_http_port = http_port; 1033 self.session.data.git_ssh_port = ssh_port; 1034 try hx.ui.run(self.io, self.allocator, self.session, self.repo); 1035 } 1036 }; 1037 1038 try srv.run(.xit, .{}, io, allocator, cwd_path, serve_options, run_opts.err, Runnable{ .io = io, .allocator = allocator, .session = &session, .repo = &repo }); 1039 } 1040 } 1041 1042 // words cycled through to pad generated lines into prose-like content 1043 const scatter_words = [_][]const u8{ 1044 "lorem", "ipsum", "dolor", "sit", "amet", "consectetur", 1045 "quantum", "vector", "matrix", "buffer", "kernel", "socket", 1046 "falcon", "otter", "badger", "walrus", "ferret", "marmot", 1047 "scatter", "gather", "encode", "decode", "render", "commit", 1048 }; 1049 1050 fn longDescription(allocator: std.mem.Allocator, initial: []const u8) ![]u8 { 1051 var writer = std.Io.Writer.Allocating.init(allocator); 1052 defer writer.deinit(); 1053 try writer.writer.print("{s}\n", .{initial}); 1054 for (0..ui.detail_preview_lines) |line| 1055 try writer.writer.print("\n- {d} {s}", .{ line, scatter_words[line % scatter_words.len] }); 1056 return writer.toOwnedSlice(); 1057 } 1058 1059 // write `path` as 40 lines of mostly-stable filler. revision `c` and file 1060 // index `fi` shift which lines change and the words used, so each (c, fi) 1061 // yields a distinct multi-hunk diff against the previous revision. untouched 1062 // lines stay byte-identical across revisions, so a bump in `c` is a scatter of 1063 // small hunks rather than a full rewrite. 1064 fn writeScatterFile(io: std.Io, allocator: std.mem.Allocator, repo_dir: std.Io.Dir, path: []const u8, fi: usize, c: usize) !void { 1065 const content = try scatterContent(allocator, fi, c, null); 1066 defer allocator.free(content); 1067 const file = try repo_dir.createFile(io, path, .{}); 1068 defer file.close(io); 1069 try file.writeStreamingAll(io, content); 1070 } 1071 1072 const ScatterEdit = struct { line: usize, text: []const u8 }; 1073 1074 fn scatterContent(allocator: std.mem.Allocator, fi: usize, c: usize, replacement: ?ScatterEdit) ![]u8 { 1075 var writer = std.Io.Writer.Allocating.init(allocator); 1076 defer writer.deinit(); 1077 for (0..40) |line| { 1078 if (replacement) |edit| if (line == edit.line) { 1079 try writer.writer.print("{s}\n", .{edit.text}); 1080 continue; 1081 }; 1082 const start = writer.written().len; 1083 if ((line + fi + c) % 8 == 0) { 1084 const tag = scatter_words[(line + fi + c * 3) % scatter_words.len]; 1085 try writer.writer.print("rev {d} {s}", .{ c, tag }); 1086 } 1087 const target = 40 + (line * 17 + fi * 23) % 70; 1088 var w = line + fi; 1089 while (true) : (w += 1) { 1090 const word = scatter_words[w % scatter_words.len]; 1091 const len = writer.written().len - start; 1092 if (len >= target or len + 1 + word.len > 120) break; 1093 if (len == 0) 1094 try writer.writer.print("{s}", .{word}) 1095 else 1096 try writer.writer.print(" {s}", .{word}); 1097 } 1098 try writer.writer.writeByte('\n'); 1099 } 1100 return writer.toOwnedSlice(); 1101 } 1102 1103 // tag the current HEAD with the next three sequential versions, so the refs 1104 // tab has enough tags to page through 1105 fn addNextTags(repo: *rp.Repo(.xit, .{}), io: std.Io, allocator: std.mem.Allocator, n: *usize) !void { 1106 for (0..3) |_| { 1107 var buf: [16]u8 = undefined; 1108 const name = try std.fmt.bufPrint(&buf, "v{d}", .{n.*}); 1109 _ = try repo.addTag(io, allocator, .{ .name = name }); 1110 n.* += 1; 1111 } 1112 } 1113 1114 fn commitTree( 1115 io: std.Io, 1116 allocator: std.mem.Allocator, 1117 repo: *rp.Repo(.xit, .{}), 1118 oid: *const [hash.hexLen(.sha1)]u8, 1119 ) ![hash.hexLen(.sha1)]u8 { 1120 var moment = try repo.core.latestMoment(); 1121 const state = rp.Repo(.xit, .{}).State(.read_only){ .core = &repo.core, .extra = .{ .moment = &moment } }; 1122 var object = try obj.Object(.xit, .{}).init(state, io, allocator, oid); 1123 defer object.deinit(); 1124 return switch (object.content) { 1125 .commit => |commit| commit.tree, 1126 else => error.InvalidObject, 1127 }; 1128 } 1129 1130 // distribute a seed batch from oldest to newest relative to this run. 1131 fn seedTimestamp(now: u64, index: usize, count: usize, oldest_age: u64, newest_age: u64) u64 { 1132 const age = if (count > 1) oldest_age - (oldest_age - newest_age) * index / (count - 1) else newest_age; 1133 return now - age; 1134 } 1135 1136 fn seedPatchRevision( 1137 io: std.Io, 1138 allocator: std.mem.Allocator, 1139 users_dir: []const u8, 1140 forker_id: *const [evt.event_id_size]u8, 1141 patch_id: *const [evt.event_id_size]u8, 1142 title: []const u8, 1143 author: evt.CommitAuthor, 1144 timestamp: u64, 1145 random: std.Random, 1146 base_oid: [hash.hexLen(.sha1)]u8, 1147 path: []const u8, 1148 contents: []const []const u8, 1149 // a base file the last commit removes 1150 removed_path: ?[]const u8, 1151 ) !void { 1152 const patch_hex = std.fmt.bytesToHex(patch_id.*, .lower); 1153 const fork_path = try fork.forkPath(allocator, users_dir, forker_id, patch_id); 1154 defer allocator.free(fork_path); 1155 var fork_repo = try rp.Repo(.xit, .{}).open(io, allocator, .{ .path = fork_path, .require_repo_root = true }); 1156 defer fork_repo.deinit(io, allocator); 1157 1158 try fork_repo.addConfig(io, allocator, .{ .name = "core.bare", .value = "false" }); 1159 { 1160 var reset = try fork_repo.reset(io, allocator, .{ .target = .{ .oid = &base_oid } }); 1161 defer reset.deinit(); 1162 } 1163 const base_tree_oid = try commitTree(io, allocator, &fork_repo, &base_oid); 1164 var source_oid = base_oid; 1165 var fork_dir = try std.Io.Dir.cwd().openDir(io, fork_path, .{}); 1166 defer fork_dir.close(io); 1167 var writer = std.Io.Writer.Allocating.init(allocator); 1168 defer writer.deinit(); 1169 if (std.Io.Dir.path.dirname(path)) |dir| try fork_dir.createDirPath(io, dir); 1170 const commit_count = contents.len + @intFromBool(removed_path != null); 1171 for (contents, 0..) |content, i| { 1172 { 1173 const file = try fork_dir.createFile(io, path, .{}); 1174 defer file.close(io); 1175 try file.writeStreamingAll(io, content); 1176 } 1177 try fork_repo.add(io, allocator, &.{path}); 1178 writer.clearRetainingCapacity(); 1179 try writer.writer.print("{s} ({d}/{d})", .{ title, i + 1, commit_count }); 1180 source_oid = try fork_repo.commit(io, allocator, .{ .message = writer.written(), .timestamp = timestamp + i }); 1181 } 1182 if (removed_path) |removed| { 1183 // the bare fork never checked the base files out, so only the index drops it 1184 try fork_repo.remove(io, allocator, &.{removed}, .{ .update_work_dir = false }); 1185 writer.clearRetainingCapacity(); 1186 try writer.writer.print("{s} ({d}/{d})", .{ title, commit_count, commit_count }); 1187 source_oid = try fork_repo.commit(io, allocator, .{ .message = writer.written(), .timestamp = timestamp + contents.len }); 1188 } 1189 try fork_repo.patchAll(io, allocator, null); 1190 try fork_repo.addConfig(io, allocator, .{ .name = "core.bare", .value = "true" }); 1191 try transaction(io, &fork_repo, Reindex{ .io = io, .allocator = allocator, .core = &fork_repo.core, .commits = false }); 1192 _ = try fork_repo.garbageCollect(io, allocator, .{}); 1193 try fork_dir.deleteFile(io, path); 1194 const revision_id = evt.EventWithId.randomId(random); 1195 const head_tree_oid = try commitTree(io, allocator, &fork_repo, &source_oid); 1196 const revision: evt.PatchRev = .{ 1197 .base_oid = &base_oid, 1198 .source_oid = &source_oid, 1199 .message = title, 1200 }; 1201 const revision_timestamp = timestamp + 3; 1202 const tree_entries = [_]evt.EventTreeEntry{ 1203 .{ .tree = .{ .name = "base", .oid = &base_tree_oid } }, 1204 .{ .tree = .{ .name = "head", .oid = &head_tree_oid } }, 1205 }; 1206 try evt.consume(.{ .server = .{ .users_dir = users_dir } }, .fork, .xit, .{}, io, allocator, &fork_repo, evt.events_ref, &.{.{ 1207 .id = std.fmt.bytesToHex(revision_id, .lower), 1208 .timestamp = revision_timestamp, 1209 .author = author, 1210 .tree_entries = &tree_entries, 1211 .event = .{ .patchrev = revision }, 1212 }}); 1213 1214 var arena = std.heap.ArenaAllocator.init(allocator); 1215 defer arena.deinit(); 1216 const moment = try evt.currentMoment(.{}, &fork_repo); 1217 const revision_record = (try evt.PatchRev.readById(evt.EventDB(.sha1), .sha1, moment, &arena, &revision_id)) orelse return error.NotFound; 1218 const patch_record = (try evt.Patch.readById(evt.EventDB(.sha1), .sha1, moment, &arena, patch_id)) orelse return error.NotFound; 1219 var patch = patch_record.event; 1220 patch.revision = evt.Patch.Revision.fromRecord(revision_id, revision_record); 1221 try evt.consume(.{ .server = .{ .users_dir = users_dir } }, .fork, .xit, .{}, io, allocator, &fork_repo, evt.events_ref, &.{.{ 1222 .id = patch_hex, 1223 .timestamp = revision_timestamp + 1, 1224 .author = author, 1225 .event = .{ .patch = patch }, 1226 }}); 1227 } 1228 1229 // returns the newest patch, the one the seeded comments are on 1230 fn seedPatches( 1231 io: std.Io, 1232 allocator: std.mem.Allocator, 1233 server_path: []const u8, 1234 admin_repo: *rp.Repo(.xit, evt.admin_repo_opts), 1235 target_repo: *rp.Repo(.xit, .{}), 1236 repo_id: *const [evt.event_id_size]u8, 1237 repo_user_id: *const [evt.event_id_size]u8, 1238 user_id: *const [evt.event_id_size]u8, 1239 random: std.Random, 1240 now: u64, 1241 ) ![evt.event_id_size]u8 { 1242 const patch_data = [_]struct { 1243 title: []const u8, 1244 description: []const u8, 1245 labels: []const u8, 1246 status: ?evt.Patch.StatusKind, 1247 alpha_edit: ?ScatterEdit = null, 1248 // based behind master, so merging it makes a merge commit 1249 behind_master: bool = false, 1250 // a base file the patch removes 1251 removed_path: ?[]const u8 = null, 1252 }{ 1253 .{ 1254 .title = "Draft a faster dependency scanner", 1255 .description = "Rework dependency discovery so a **large workspace** can be scanned without repeatedly opening the same manifests.", 1256 .labels = "performance build", 1257 .status = null, 1258 }, 1259 .{ 1260 .title = "Remove the legacy configuration loader", 1261 .description = "Delete the compatibility loader now that the replacement format has shipped and the migration warning has been available for a *full release*.", 1262 .labels = "cleanup config", 1263 .status = .merged, 1264 .behind_master = true, 1265 }, 1266 .{ 1267 .title = "Cache parsed manifests between commands", 1268 .description = "Keep parsed manifests in the command `Context` so consecutive operations do not repeat identical filesystem and parsing work.", 1269 .labels = "performance cache", 1270 .status = .closed, 1271 }, 1272 .{ 1273 .title = "Add structured output to the inspect command", 1274 .description = "Add a stable JSON representation of `inspect` results for scripts and editor integrations.", 1275 .labels = "enhancement cli", 1276 .status = .open, 1277 .removed_path = "docs/dev/contribute.md", 1278 }, 1279 .{ 1280 .title = "Edit an adjacent line in alpha.txt", 1281 .description = "This patch can be cleanly merged by haxy, while git throws a **merge conflict**!", 1282 .labels = "merge", 1283 .status = .open, 1284 .alpha_edit = .{ .line = 2, .text = "adjust alpha beside the latest scatter edit" }, 1285 }, 1286 .{ 1287 .title = "Edit a conflicting line in alpha.txt", 1288 .description = "Both source and squash merges conflict with a different edit to the *same line* on master.", 1289 .labels = "merge", 1290 .status = .open, 1291 .alpha_edit = .{ .line = 3, .text = "replace alpha with a conflicting edit" }, 1292 }, 1293 }; 1294 1295 const users_dir = try std.Io.Dir.path.join(allocator, &.{ server_path, "users" }); 1296 defer allocator.free(users_dir); 1297 const patch_author = evt.CommitAuthor{ .name = "admin", .email = "admin@example.test" }; 1298 var patch_ids: [patch_data.len][evt.event_id_size]u8 = undefined; 1299 for (patch_data, 0..) |patch, i| { 1300 const timestamp = seedTimestamp(now, i, patch_data.len, 25 * std.time.s_per_day, 3 * std.time.s_per_hour); 1301 patch_ids[i] = evt.EventWithId.randomId(random); 1302 const patch_hex = std.fmt.bytesToHex(patch_ids[i], .lower); 1303 const path = try fork.create(.{}, io, allocator, users_dir, .{ 1304 .id = patch_hex, 1305 .user_id = user_id.*, 1306 .repo_id = repo_id.*, 1307 .repo_user_id = repo_user_id.*, 1308 .title = patch.title, 1309 .description = patch.description, 1310 .labels = patch.labels, 1311 .target_branch = "master", 1312 .author = patch_author, 1313 .timestamp = timestamp, 1314 }); 1315 allocator.free(path); 1316 1317 // prepare the patch's base and file contents, then seed its commits and revision 1318 { 1319 var arena = std.heap.ArenaAllocator.init(allocator); 1320 defer arena.deinit(); 1321 const aa = arena.allocator(); 1322 var base_oid = (try target_repo.readRef(io, .{ .kind = .head, .name = "master" })) orelse return error.NotFound; 1323 if (patch.alpha_edit != null or patch.behind_master) { 1324 // v30 precedes the last scatter commit, even after the sample merge 1325 const tag_oid = (try target_repo.readRef(io, .{ .kind = .tag, .name = "v30" })) orelse return error.NotFound; 1326 var moment = try target_repo.core.latestMoment(); 1327 const state = rp.Repo(.xit, .{}).State(.read_only){ .core = &target_repo.core, .extra = .{ .moment = &moment } }; 1328 var tag = try obj.Object(.xit, .{}).init(state, io, allocator, &tag_oid); 1329 defer tag.deinit(); 1330 base_oid = switch (tag.content) { 1331 .tag => |value| value.target, 1332 else => return error.InvalidObject, 1333 }; 1334 } 1335 var contents: [3][]const u8 = undefined; 1336 const file_path: []const u8, const count: usize = if (patch.alpha_edit) |edit| blk: { 1337 // rev 29 first changes line 4; edit that line or the one above it 1338 contents[0] = try scatterContent(aa, 0, 28, edit); 1339 break :blk .{ "src/alpha.txt", 1 }; 1340 } else blk: { 1341 var writer = std.Io.Writer.Allocating.init(allocator); 1342 defer writer.deinit(); 1343 for (&contents, 0..) |*content, part| { 1344 try writer.writer.print("{s}: part {d}\n", .{ patch.title, part + 1 }); 1345 content.* = try aa.dupe(u8, writer.written()); 1346 } 1347 break :blk .{ "patch.txt", contents.len }; 1348 }; 1349 try seedPatchRevision(io, allocator, users_dir, user_id, &patch_ids[i], patch.title, patch_author, timestamp + 1, random, base_oid, file_path, contents[0..count], patch.removed_path); 1350 } 1351 const status = patch.status orelse continue; 1352 try pch.publish(.{}, io, allocator, .{ .users_dir = users_dir }, admin_repo, target_repo, .{ 1353 .id = patch_hex, 1354 .user_id = user_id.*, 1355 .repo_id = repo_id.*, 1356 .author = patch_author, 1357 .timestamp = timestamp + 6, 1358 }); 1359 1360 if (status == .merged) { 1361 try pch.mergeAndRemoveFork(.{}, io, allocator, .{ .users_dir = users_dir }, target_repo, .{ 1362 .id = patch_hex, 1363 .revision = .source, 1364 .author = patch_author, 1365 .timestamp = timestamp + 7, 1366 }); 1367 } else if (status != .open) { 1368 try evt.Patch.update(.{ .server = .{ .users_dir = users_dir } }, .xit, .{}, io, allocator, target_repo, &patch_ids[i], .{ .status = status }, patch_author); 1369 } 1370 } 1371 1372 // seed a small comment tree on the newest patch 1373 var comment_ids: [5][evt.event_id_size]u8 = undefined; 1374 for (&comment_ids) |*id| id.* = evt.EventWithId.randomId(random); 1375 const comment_bodies = [_][]const u8{ 1376 "This also needs to preserve the **executable bit** for files nested inside generated directories.", 1377 "I tested both paths:\n\n- the archive path\n- the direct-copy path\n\nBoth currently lose the mode.", 1378 "The `ArchiveWriter` is the right place to centralize it, since every exporter already goes through that layer.", 1379 "Please include a regression fixture with a *mix* of executable and ordinary files.", 1380 "I'll add that fixture and cover both supported archive formats:\n\n1. tar\n2. zip", 1381 }; 1382 var comments: [comment_ids.len]evt.EventWithId = undefined; 1383 for (&comments, 0..) |*comment, i| { 1384 comment.* = .{ 1385 .id = std.fmt.bytesToHex(comment_ids[i], .lower), 1386 .timestamp = seedTimestamp(now, i, comments.len, 2 * std.time.s_per_hour, 45), 1387 .author = .{ .name = if (i % 2 == 0) "alice" else "bobby", .email = if (i % 2 == 0) "alice@example.test" else "bobby@example.test" }, 1388 .event = .{ .comment = .{ 1389 .thread_id = std.fmt.bytesToHex(patch_ids[patch_ids.len - 1], .lower), 1390 .parent_id = switch (i) { 1391 0, 1 => std.fmt.bytesToHex(patch_ids[patch_ids.len - 1], .lower), 1392 2, 4 => std.fmt.bytesToHex(comment_ids[0], .lower), 1393 3 => std.fmt.bytesToHex(comment_ids[2], .lower), 1394 else => unreachable, 1395 }, 1396 .body = comment_bodies[i], 1397 } }, 1398 }; 1399 } 1400 try evt.consume(.{ .server = .{ .users_dir = users_dir } }, .repo, .xit, .{}, io, allocator, target_repo, evt.events_ref, &comments); 1401 1402 // create divergent metadata edits on the next three patches 1403 var patch_arena = std.heap.ArenaAllocator.init(allocator); 1404 defer patch_arena.deinit(); 1405 const moment = try evt.currentMoment(.{}, target_repo); 1406 var values: [3]evt.Patch = undefined; 1407 for (1..4) |i| { 1408 const record = (try evt.Patch.readById(evt.EventDB(.sha1), .sha1, moment, &patch_arena, &patch_ids[i])) orelse return error.NotFound; 1409 values[i - 1] = record.event; 1410 } 1411 var ours_values = values; 1412 ours_values[0].title = "Drop the legacy configuration loader"; 1413 ours_values[0].labels = "cleanup config breaking"; 1414 const closed_description = try longDescription( 1415 patch_arena.allocator(), 1416 "## Summary\n\nCache parsed manifests for the lifetime of a command invocation and invalidate entries when their files change.", 1417 ); 1418 ours_values[1].description = closed_description; 1419 ours_values[2].description = "Add JSON output to `inspect` with versioned field names and deterministic object ordering."; 1420 var theirs_values = values; 1421 theirs_values[0].title = "Delete compatibility configuration support"; 1422 theirs_values[0].labels = "config maintenance"; 1423 theirs_values[1].description = "Keep a process-wide manifest cache shared by **every** command and refresh it after writes."; 1424 theirs_values[2].description = "Expose `inspect` results as newline-delimited JSON so callers can stream large repositories."; 1425 1426 const seed_tip = (try target_repo.readRef(io, evt.events_ref)) orelse return error.NotFound; 1427 const other_ref = xit.ref.Ref{ .kind = .head, .name = "haxy/patch-other" }; 1428 var ours = [_]evt.EventWithId{ 1429 .{ 1430 .id = std.fmt.bytesToHex(patch_ids[1], .lower), 1431 .timestamp = now - 30 * std.time.s_per_min, 1432 .author = .{ .name = "alice", .email = "alice@example.test" }, 1433 .event = .{ .patch = ours_values[0] }, 1434 }, 1435 .{ 1436 .id = std.fmt.bytesToHex(patch_ids[2], .lower), 1437 .timestamp = now - 29 * std.time.s_per_min, 1438 .author = .{ .name = "alice", .email = "alice@example.test" }, 1439 .event = .{ .patch = ours_values[1] }, 1440 }, 1441 .{ 1442 .id = std.fmt.bytesToHex(patch_ids[3], .lower), 1443 .timestamp = now - 28 * std.time.s_per_min, 1444 .author = .{ .name = "alice", .email = "alice@example.test" }, 1445 .event = .{ .patch = ours_values[2] }, 1446 }, 1447 }; 1448 1449 var theirs = ours; 1450 theirs[0].timestamp = now - 25 * std.time.s_per_min; 1451 theirs[0].author = .{ .name = "bobby", .email = "bobby@example.test" }; 1452 theirs[0].event.patch = theirs_values[0]; 1453 theirs[1].timestamp = now - 24 * std.time.s_per_min; 1454 theirs[1].author = .{ .name = "bobby", .email = "bobby@example.test" }; 1455 theirs[1].event.patch = theirs_values[1]; 1456 theirs[2].timestamp = now - 23 * std.time.s_per_min; 1457 theirs[2].author = .{ .name = "bobby", .email = "bobby@example.test" }; 1458 theirs[2].event.patch = theirs_values[2]; 1459 1460 try evt.consume(.{ .server = .{ .users_dir = users_dir } }, .repo, .xit, .{}, io, allocator, target_repo, evt.events_ref, &ours); 1461 try commitEventsAtRef(io, allocator, target_repo, other_ref, &theirs, seed_tip); 1462 { 1463 var merge = try target_repo.mergeAtRef(io, allocator, .{ .kind = .full, .action = .{ .new = .{ .source = &.{.{ .ref = other_ref }} } } }, evt.events_ref, null); 1464 defer merge.deinit(); 1465 if (merge.result != .success) return error.MergeFailed; 1466 } 1467 try target_repo.removeBranch(io, .{ .name = other_ref.name }); 1468 try evt.consume(.{ .server = .{ .users_dir = users_dir } }, .repo, .xit, .{}, io, allocator, target_repo, evt.events_ref, &.{}); 1469 try pch.writeBranchPatch(.{ .server = .{ .users_dir = users_dir } }, .xit, .{}, io, allocator, target_repo, std.fmt.bytesToHex(evt.EventWithId.randomId(random), .lower), .{ 1470 .title = "Merge the existing feature branch", 1471 .description = "This patch tracks the `feature` branch in this repo without creating a fork.", 1472 .labels = "feature", 1473 .source_branch = "feature", 1474 .target_branch = "master", 1475 }, null, patch_author); 1476 1477 // a push onto the branch that patch tracks, so the undo tab shows the 1478 // action and the patch refresh it sets off 1479 try seedPush(io, allocator, target_repo, users_dir, patch_author, now - 15); 1480 try pch.refreshBranches(.{ .server = .{ .users_dir = users_dir } }, .xit, .{}, io, allocator, target_repo, null, null); 1481 return patch_ids[patch_ids.len - 1]; 1482 } 1483 1484 // stand in for a client push, which the fixture has no server to receive: one 1485 // transaction moves the branch, refreshes the patches tracking it and records 1486 // the action, the way receive-pack does 1487 fn seedPush(io: std.Io, allocator: std.mem.Allocator, repo: *rp.Repo(.xit, .{}), users_dir: []const u8, author: evt.CommitAuthor, timestamp: u64) !void { 1488 const Repo = rp.Repo(.xit, .{}); 1489 const DB = Repo.DB; 1490 const Ctx = struct { 1491 core: *Repo.Core, 1492 io: std.Io, 1493 allocator: std.mem.Allocator, 1494 users_dir: []const u8, 1495 author: evt.CommitAuthor, 1496 timestamp: u64, 1497 1498 pub fn run(ctx: @This(), cursor: *DB.Cursor(.read_write)) !void { 1499 const opts: rp.RepoOpts(.xit) = .{}; 1500 var moment = try DB.HashMap(.read_write).init(cursor.*); 1501 const state = Repo.State(.read_write){ .core = ctx.core, .extra = .{ .moment = &moment } }; 1502 var arena = std.heap.ArenaAllocator.init(ctx.allocator); 1503 defer arena.deinit(); 1504 const aa = arena.allocator(); 1505 1506 // a null tree keeps the parent's content, so the branch advances 1507 // without the fixture having to build one 1508 const author_line = try aa.print("{s} <{s}>", .{ ctx.author.name, ctx.author.email }); 1509 const feature_old = (try rf.readRecur(.xit, opts, state.readOnly(), ctx.io, .{ .ref = .{ .kind = .head, .name = "feature" } })) orelse return error.NotFound; 1510 const feature_new = try obj.writeCommit(.xit, opts, state, ctx.io, ctx.allocator, .{ 1511 .message = "Revise the feature branch", 1512 .author = author_line, 1513 .timestamp = ctx.timestamp, 1514 }, null, .{ .kind = .head, .name = "feature" }); 1515 1516 // a branch the push creates has no old tip, so its range is open 1517 try bch.add(.xit, opts, state, ctx.io, .{ .name = "docs" }); 1518 const docs_new = (try rf.readRecur(.xit, opts, state.readOnly(), ctx.io, .{ .ref = .{ .kind = .head, .name = "docs" } })) orelse return error.NotFound; 1519 1520 const updates = [_]xit.net_server_receive_pack.AppliedRefUpdate{ 1521 .{ 1522 .ref_name = try aa.dupe(u8, "refs/heads/feature"), 1523 .old_oid = try aa.dupe(u8, &feature_old), 1524 .new_oid = try aa.dupe(u8, &feature_new), 1525 }, 1526 .{ 1527 .ref_name = try aa.dupe(u8, "refs/heads/docs"), 1528 .old_oid = try aa.dupe(u8, &@as([hash.hexLen(opts.hash)]u8, @splat('0'))), 1529 .new_oid = try aa.dupe(u8, &docs_new), 1530 }, 1531 }; 1532 1533 // receive-pack patches the new tips before the branches refresh 1534 try xit.patch.writePatches(opts, state, ctx.io, ctx.allocator, &.{ feature_new, docs_new }, null); 1535 _ = try pch.refreshBranchesInTransaction(.{ .server = .{ .users_dir = ctx.users_dir } }, opts, state, &moment, ctx.io, ctx.allocator, &updates, null, null); 1536 try push.writeUndo(opts, state, ctx.io, ctx.allocator, ctx.author, &updates); 1537 } 1538 }; 1539 1540 try transaction(io, repo, Ctx{ .core = &repo.core, .io = io, .allocator = allocator, .users_dir = users_dir, .author = author, .timestamp = timestamp }); 1541 } 1542 1543 // commit `events` onto `ref`, rooted at `parent`, as one transaction. 1544 // consume always roots a new branch at nothing, so the divergent fixtures 1545 // write their side branch here instead. nothing is consumed, so it records 1546 // xit's own commit action rather than one of haxy's event actions 1547 fn commitEventsAtRef( 1548 io: std.Io, 1549 allocator: std.mem.Allocator, 1550 repo: *rp.Repo(.xit, .{}), 1551 ref: xit.ref.Ref, 1552 events: []const evt.EventWithId, 1553 parent: [hash.hexLen(.sha1)]u8, 1554 ) !void { 1555 const Repo = rp.Repo(.xit, .{}); 1556 const DB = Repo.DB; 1557 const Ctx = struct { 1558 core: *Repo.Core, 1559 io: std.Io, 1560 allocator: std.mem.Allocator, 1561 ref: xit.ref.Ref, 1562 events: []const evt.EventWithId, 1563 parent: [hash.hexLen(.sha1)]u8, 1564 1565 pub fn run(ctx: @This(), cursor: *DB.Cursor(.read_write)) !void { 1566 const opts: rp.RepoOpts(.xit) = .{}; 1567 var moment = try DB.HashMap(.read_write).init(cursor.*); 1568 const state = Repo.State(.read_write){ .core = ctx.core, .extra = .{ .moment = &moment } }; 1569 try evt.commitEvents(.xit, opts, state, ctx.io, ctx.allocator, ctx.ref, ctx.events, .{ctx.parent}); 1570 const tip = (try xit.ref.readRecur(.xit, opts, state.readOnly(), ctx.io, .{ .ref = ctx.ref })) orelse return error.NotFound; 1571 try xit.undo.write(opts, state, std.Io.Timestamp.now(ctx.io, .real).toSeconds(), .{ 1572 .commit = try .init("seed conflicting events", tip, opts.max_read_size), 1573 }); 1574 } 1575 }; 1576 1577 try transaction(io, repo, Ctx{ 1578 .core = &repo.core, 1579 .io = io, 1580 .allocator = allocator, 1581 .ref = ref, 1582 .events = events, 1583 .parent = parent, 1584 }); 1585 } 1586 1587 // append `ctx` to the repo's history as one transaction. the fixtures write a 1588 // few states the normal paths have no way to produce 1589 // fixtures commit directly, so the ref tips are indexed by hand. a fork gets 1590 // no commit index, as in production. 1591 const Reindex = struct { 1592 io: std.Io, 1593 allocator: std.mem.Allocator, 1594 core: *rp.Repo(.xit, .{}).Core, 1595 commits: bool, 1596 1597 pub fn run(ctx: @This(), cursor: *rp.Repo(.xit, .{}).DB.Cursor(.read_write)) !void { 1598 var moment = try rp.Repo(.xit, .{}).DB.HashMap(.read_write).init(cursor.*); 1599 const state = rp.Repo(.xit, .{}).State(.read_write){ .core = ctx.core, .extra = .{ .moment = &moment } }; 1600 _ = try find.refreshInTransaction(.{}, state, &moment, ctx.io, ctx.allocator, null); 1601 if (ctx.commits) _ = try srch_cmmt.refreshInTransaction(.{}, state, &moment, ctx.io, ctx.allocator, &.{}, null); 1602 } 1603 }; 1604 1605 fn transaction(io: std.Io, repo: *rp.Repo(.xit, .{}), ctx: anytype) !void { 1606 const DB = rp.Repo(.xit, .{}).DB; 1607 try repo.core.db_file.lock(io, .exclusive); 1608 defer repo.core.db_file.unlock(io); 1609 1610 const history = try DB.ArrayList(.read_write).init(repo.core.db.rootCursor()); 1611 try history.appendContext(.{ .slot = try history.getSlot(-1) }, ctx); 1612 } 1613 1614 // recursively copy the contents of src_dir into dest_dir 1615 fn copyDir(io: std.Io, src_dir: std.Io.Dir, dest_dir: std.Io.Dir) !void { 1616 var iter = src_dir.iterate(); 1617 while (try iter.next(io)) |entry| { 1618 switch (entry.kind) { 1619 .file => try src_dir.copyFile(entry.name, dest_dir, entry.name, io, .{}), 1620 .directory => { 1621 try dest_dir.createDirPath(io, entry.name); 1622 var dest_entry_dir = try dest_dir.openDir(io, entry.name, .{ .access_sub_paths = true, .iterate = true, .follow_symlinks = false }); 1623 defer dest_entry_dir.close(io); 1624 var src_entry_dir = try src_dir.openDir(io, entry.name, .{ .access_sub_paths = true, .iterate = true, .follow_symlinks = false }); 1625 defer src_entry_dir.close(io); 1626 try copyDir(io, src_entry_dir, dest_entry_dir); 1627 }, 1628 else => {}, 1629 } 1630 } 1631 } 1632