portable: release 0.93
[got-portable.git] / TODO
blob9d4cb0f44191c5d43a03d3c15ca8fdd858782b06
1 got:
2 - Teach 'got merge' to merge changes into an arbitrary subdirectory
3   of the work tree. This would be nice for merging vendor branches.
4   Say you have a branch 'llvm-12' which intially contains a 12.0
5   release tree as published by the LLVM project, added to the repository
6   with a command such as 'got import -b llvm-12'. On the main branch we
7   would want to merge files from the llvm-12 branch into /usr/src/gnu/llvm
8   instead of the root directory checked out at /usr/src.
9   The next LLVM release 12.1 would later be committed onto the llvm-12
10   branch and then merged into main at /usr/src/gnu/llvm in the same way.
11 - When a clone fails the HEAD symref will always point to "refs/heads/main"
12   (ie. the internal default HEAD symref of Got). Resuming a failed clone with
13   'got fetch' is supposed to work. To make this easier, if the HEAD symref
14   points to a non-existent reference it should be updated by 'got fetch'
15   to match the HEAD symref sent by the server.
16 - If invoked in a work tree, got fetch could default to fetching the work
17   tree's current branch, instead of fetching the remote repository's HEAD.
18 - 'got patch' should be able to detect an already applied patch.
19 - 'got patch' should ideally do more passes if a patch doesn't apply and
20   try fancy things (like ignoring context and whitespaces) only in later
21   passes.
22 - investigate whether it's worth for 'got patch' to memory-map the files to
23   edit.  (c.f. Plan A / Plan B in Larry' patch.)
24 - when fetching pack files got should verify that the requested branch tips
25   are present in the pack file sent by the server, before making this pack
26   file visible to readers of the repository
28 network protocol:
29 - add http(s) transport with libtls, speaking the two Git HTTP protocols
30   (both "dumb" and "smart" need to work) via got-fetch-pack, or a new helper
31   like got-fetch-http; it is fine if HTTP remains a fetch-only protocol, and
32   works only against servers which don't require authentication for fetches;
33   anything beyond this would require a full-featured HTTP client (Git uses
34   libcurl, which we cannot use as it is not in the OpenBSD base system)
36 tog:
37 - make 'tog log' respond to key presses while 'loading...' history; loading
38   can be slow for paths in a deep history if the path has not been changed
39   very often, and 'tog log' blocks far too long in this case
40 - make it possible to view the contents of tag objects
41 - verify signed tag objects
42 - make it possible to toggle the parent to diff against in merge commits
44 gotwebd:
45 - fix COMMITS page for paths that were deleted and/or re-added to the
46   repository. One way would be not to let the commit graph filter paths.
47   As an additional optimization we could keep a tailq or the object-id
48   set for everything traversed in the repo to have fast reverse-lookups.
49   (has the additional requirement to invalidate it when the reference
50   timestamp changes)
51 - reply with 404 on some kind of errors ('reference not found' for sure,
52   maybe also tree entry not found?)
53 - run-time changes of addresses on interfaces are being ignored by gotwebd
54 - perhaps "bind interface" should be removed in favour of using only IP
55   addresses? This makes the address family selection explicit and avoids
56   having to monitor interfaces for dynamic address changes.
57 - add breadcrumbs to navigate in the directory tree
58 - add more action links, like "raw", "blame" and "commits" in the blob
59   page.
60 - add a "rawdiff" page to serve a diff as text/plain (or text/x-patch),
61   or maybe "rawcommit" that includes the commentary too.
62 - consider changing the URL scheme to avoid so many query parameters
64 gotd:
65 - ensure all error messages are propagated to clients before disconnecting,
66   there are probably still some cases where such error reporting is skipped
67 - client connection timeout handling needs to be checked by regress tests,
68   and is likely in need of improvement
69 - implement stress-tests to observe and fix misbehaviour under load
70 - listener's fd-reserve limit needs to be reviewed and perhaps adjusted
71 - implement pre-commit checks (in lieu of hook scripts):
72   1. deny branch history rewriting ('got send -f') via gotd.conf [done]
73   2. allow/deny creation/deletion of references via gotd.conf
74   3. deny modifications within a given reference namespace via gotd.conf [done]
75   4. entirely hide a given reference namespace from clients via gotd.conf
76   5. allow/deny addition of binary files to a repo via gotd.conf
77   6. enforce a particular blob size limit via gotd.conf
78   7. optionally reject merge commits via gotd.conf
79 - implement post-commit-event libexec handlers (in lieu of hook scripts):
80   1. commit email notification, plaintext smtp to localhost port 25
81   2. general-purpose HTTP(s) GET/POST request as commit notification,
82      should use a format string to encode commit-info in the request URL
83   3. perform the equivalent of 'got send' to another repository
84 - keep track of available repository disk space and fail gracefully when
85   uploaded pack files would fill up the disk too much, keeping a reserve
86 - reuse packed non-delta objects directly (without re-deltification) for speed
87 - if no permit statement is given in gotd.conf it is possible to send a branch
88   into an empty repository regardless; this should return EPERM instead
90 gotadmin:
91 - add support for generating git-fast-export streams from a repository
92 - add support for importing git-fast-export streams into a repository
93 - speed up 'gotadmin pack -a' is too slow on repositories with many pack files