feat(record): add untracked file detection

This updates `git record` and `git amend` to automaticaly detect (and
optionally add) new, untracked files.

There are 4 modes of operation, configurable via command line option and config
setting:
- `disable` (default): do nothing; don't look for untracked files on disk/in db
- `skip`: new files are not added, will remain skipped in subsequent invocaions
- `add`: new files are added to the commit
- `prompt`: user will be prompted for what to do with each new file

Notes:
- As noted above, this behavior it totally disabled by default. It must be
  enabled either via CLI option, or via the config setting.
- Untracked files are considered "new" if they are detected on disk, but aren't
  in the cached list from last run (ie in the db).
  - Every invocation of record/amend updates a cache of "known" untracked
    files, stored in our internal sqlite db.
  - Because the cache is updated on every invocation, a previously skipped file
    may be treated as a new file if was deleted and later recreated.
- Config setting `branchless.record.untrackedFiles` is provided to change the
  default runtime behavior, ie when `--untracked` is not used
- If there are staged changes, then no untracked files are added/prompted.
- A list of "known" (previously skipped) files is printed at runtime.
  Admittedly, this can be sort of annoying, but it is intended to help maintain
  "situational awareness" and reduce confusion about why the feature is
  behaving in a particular way. This may need to be reconsidered based on user
  feedback.
- When new files are skipped, a hint is shown to remind the user that
  - they will remain skipped forever
  - if they need to be added, they need to do so manually, via `git add`

Author: claytonrcarter

CHANGELOG.md

@@ -14,6 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - (#1461): added `!` revset postfix operator as shortcut for "only child"
 - (#1464): created `git split` command to extract changes from a commit
 - (#1603): added `git move --dry-run` to test in-memory rebases
+- (#1604): `git record` and `git amend` can now automatically detect and begin tracking new files (optional, disabled by default)
 - (#1632): added `git record --fixup` option, to create a fixup commit (similar to `reword --fixup`)
 
 ### Changed

Cargo.lock

@@ -48,6 +48,7 @@ async-trait = { workspace = true }
 bstr = { workspace = true }
 chashmap = { workspace = true }
 chrono = { workspace = true }
+clap = { workspace = true }
 color-eyre = { workspace = true }
 concolor = { workspace = true }
 console = { workspace = true }

git-branchless-lib/Cargo.toml

@@ -250,6 +250,10 @@ pub const RESTACK_WARN_ABANDONED_CONFIG_KEY: &str = "branchless.restack.warnAban
 /// Possible hint types.
 #[derive(Clone, Debug)]
 pub enum Hint {
+    /// Suggest running `git add` on skipped, untracked files, which are never
+    /// automatically reconsidered for tracking.
+    AddSkippedFiles,
+
     /// Suggest running `git test clean` in order to clean cached test results.
     CleanCachedTestResults,
 
@@ -269,6 +273,7 @@ pub enum Hint {
 impl Hint {
     fn get_config_key(&self) -> &'static str {
         match self {
+            Hint::AddSkippedFiles => "branchless.hint.addSkippedFiles",
             Hint::CleanCachedTestResults => "branchless.hint.cleanCachedTestResults",
             Hint::MoveImplicitHeadArgument => "branchless.hint.moveImplicitHeadArgument",
             Hint::RestackWarnAbandoned => "branchless.hint.restackWarnAbandoned",

git-branchless-lib/src/core/config.rs

@@ -11,3 +11,4 @@ pub mod node_descriptors;
 pub mod repo_ext;
 pub mod rewrite;
 pub mod task;
+pub mod untracked_file_cache;