feat(dotfiles): adaptive autosave and doctor health for the watcher

Each tracked file is scheduled on its own: an ordinary edit is saved after
the base quiet period, while a file that never settles has its own interval
doubled on every churn save, up to `history.watch.max_interval` (24h). A
throttled file is still saved periodically, captured promptly once it
settles, reset after sustained quiet, and never delays another file. The
schedule is persisted so a service restart does not reset it, and captures
another path triggers carry a held file's last saved version so whole-set
reconciliation cannot defeat the throttling. Nothing is excluded or switched
to manual saving automatically.

The watcher persists its health; `mise doctor` reports a declared but not
running watcher, capture failures, an unusable store, and heavily throttled
files without starting anything, and `mise bootstrap dotfiles status` and
`paths --noisy` show the detail.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Author: jdx

.github/workflows/test-impl.yml

@@ -162,6 +162,7 @@ jobs:
       - run: mise run test:e2e e2e/cli/test_dotfiles_rollback_types
       - run: mise run test:e2e e2e/cli/test_bootstrap_user_services
       - run: mise run test:e2e e2e/cli/test_dotfiles_watch
+      - run: mise run test:e2e e2e/cli/test_dotfiles_watch_throttle
 
   lint:
     runs-on: ${{ !inputs.trusted && 'ubuntu-latest' || 'namespace-profile-endev-linux-amd64-large;overrides.cache-tag=cache' }}

docs/.vitepress/cli_commands.ts

@@ -86,6 +86,9 @@ export const commands: { [key: string]: Command } = {
           edit: {
             hide: false,
           },
+          exclude: {
+            hide: false,
+          },
           history: {
             hide: false,
             subcommands: {
@@ -103,6 +106,9 @@ export const commands: { [key: string]: Command } = {
               },
             },
           },
+          include: {
+            hide: false,
+          },
           paths: {
             hide: false,
           },
@@ -127,6 +133,9 @@ export const commands: { [key: string]: Command } = {
           untrack: {
             hide: false,
           },
+          watch: {
+            hide: false,
+          },
         },
       },
       files: {

docs/cli/bootstrap/dotfiles.md

@@ -16,12 +16,15 @@ Manage dotfiles from `[dotfiles]`
 - [`mise bootstrap dotfiles apply [FLAGS] [TARGET]…`](/cli/bootstrap/dotfiles/apply.md)
 - [`mise bootstrap dotfiles diff [TARGET]…`](/cli/bootstrap/dotfiles/diff.md)
 - [`mise bootstrap dotfiles edit [FLAGS] <TARGET>`](/cli/bootstrap/dotfiles/edit.md)
-- [`mise bootstrap dotfiles history [FLAGS] [SUBCOMMAND]`](/cli/bootstrap/dotfiles/history.md)
-- [`mise bootstrap dotfiles paths [-J --json] [--preview <PATH>]`](/cli/bootstrap/dotfiles/paths.md)
+- [`mise bootstrap dotfiles exclude <GLOB>`](/cli/bootstrap/dotfiles/exclude.md)
+- [`mise bootstrap dotfiles history [FLAGS] <SUBCOMMAND>`](/cli/bootstrap/dotfiles/history.md)
+- [`mise bootstrap dotfiles include <GLOB>`](/cli/bootstrap/dotfiles/include.md)
+- [`mise bootstrap dotfiles paths [FLAGS]`](/cli/bootstrap/dotfiles/paths.md)
 - [`mise bootstrap dotfiles rollback [FLAGS] [PATH]…`](/cli/bootstrap/dotfiles/rollback.md)
 - [`mise bootstrap dotfiles save [FLAGS] [PATH]…`](/cli/bootstrap/dotfiles/save.md)
 - [`mise bootstrap dotfiles status [-J --json] [--missing] [TARGET]…`](/cli/bootstrap/dotfiles/status.md)
 - [`mise bootstrap dotfiles track [FLAGS] <PATH>…`](/cli/bootstrap/dotfiles/track.md)
 - [`mise bootstrap dotfiles unapply [FLAGS] [TARGET]…`](/cli/bootstrap/dotfiles/unapply.md)
 - [`mise bootstrap dotfiles undo [-n --dry-run] [-y --yes] [REF]`](/cli/bootstrap/dotfiles/undo.md)
 - [`mise bootstrap dotfiles untrack <PATH>…`](/cli/bootstrap/dotfiles/untrack.md)
+- [`mise bootstrap dotfiles watch [--once] [-J --json]`](/cli/bootstrap/dotfiles/watch.md)

docs/cli/bootstrap/dotfiles/exclude.md

@@ -0,0 +1,19 @@
+<!-- @generated by usage-cli from usage spec -->
+# `mise bootstrap dotfiles exclude`
+
+- **Usage:** `mise bootstrap dotfiles exclude <GLOB>`
+- **Effect:** modifies state
+- **Source code:** [`src/cli/bootstrap.rs`](https://github.com/jdx/mise/blob/main/src/cli/bootstrap.rs)
+
+Never capture paths matching a glob
+
+Adds the glob to `[history] exclude` in the global config. Use it for
+logs, caches, databases, and constantly rewritten application state; a
+file that genuinely holds configuration but changes constantly is
+better tracked with `--no-autosave` and saved explicitly.
+
+## Arguments
+- **`<GLOB>`** — A glob such as `~/.config/hypr/plugins/**`
+
+## Flags
+- **`-h --help`** — Print help

docs/cli/bootstrap/dotfiles/include.md

@@ -0,0 +1,16 @@
+<!-- @generated by usage-cli from usage spec -->
+# `mise bootstrap dotfiles include`
+
+- **Usage:** `mise bootstrap dotfiles include <GLOB>`
+- **Effect:** modifies state
+- **Source code:** [`src/cli/bootstrap.rs`](https://github.com/jdx/mise/blob/main/src/cli/bootstrap.rs)
+
+Capture paths matching a glob again
+
+Removes the glob from `[history] exclude` in the global config.
+
+## Arguments
+- **`<GLOB>`** — The glob as written by `exclude`
+
+## Flags
+- **`-h --help`** — Print help

docs/cli/bootstrap/dotfiles/paths.md

@@ -1,7 +1,7 @@
 <!-- @generated by usage-cli from usage spec -->
 # `mise bootstrap dotfiles paths`
 
-- **Usage:** `mise bootstrap dotfiles paths [-J --json] [--preview <PATH>]`
+- **Usage:** `mise bootstrap dotfiles paths [FLAGS]`
 - **Effect:** read-only
 - **Source code:** [`src/cli/bootstrap.rs`](https://github.com/jdx/mise/blob/main/src/cli/bootstrap.rs)
 
@@ -15,4 +15,5 @@ enrollment is never mistaken for protection.
 ## Flags
 - **`-J --json`** — Output in JSON format
 - **`--preview <PATH>`** — Show what tracking this path would capture
+- **`--noisy`** — List the paths the watcher found changing constantly
 - **`-h --help`** — Print help

docs/cli/history/watch.md docs/cli/bootstrap/dotfiles/watch.mddocs/cli/history/watch.md renamed to docs/cli/bootstrap/dotfiles/watch.md

@@ -1,9 +1,9 @@
 <!-- @generated by usage-cli from usage spec -->
-# `mise history watch`
+# `mise bootstrap dotfiles watch`
 
-- **Usage:** `mise history watch [--once] [-J --json]`
+- **Usage:** `mise bootstrap dotfiles watch [--once] [-J --json]`
 - **Effect:** modifies state
-- **Source code:** [`src/cli/history/watch.rs`](https://github.com/jdx/mise/blob/main/src/cli/history/watch.rs)
+- **Source code:** [`src/cli/bootstrap.rs`](https://github.com/jdx/mise/blob/main/src/cli/bootstrap.rs)
 
 Save tracked files as they change
 
@@ -36,7 +36,7 @@ is deferred.
 Examples:
 
 ```
-mise history watch
-mise history watch --once      # one reconcile, for a timer
-mise history watch --json
+mise bootstrap dotfiles watch
+mise bootstrap dotfiles watch --once      # one reconcile, for a timer
+mise bootstrap dotfiles watch --json
 ```

docs/cli/history/paths/exclude.md

@@ -67,19 +67,22 @@
 - [`mise bootstrap dotfiles apply [FLAGS] [TARGET]…`](/cli/bootstrap/dotfiles/apply.md)
 - [`mise bootstrap dotfiles diff [TARGET]…`](/cli/bootstrap/dotfiles/diff.md)
 - [`mise bootstrap dotfiles edit [FLAGS] <TARGET>`](/cli/bootstrap/dotfiles/edit.md)
+- [`mise bootstrap dotfiles exclude <GLOB>`](/cli/bootstrap/dotfiles/exclude.md)
 - [`mise bootstrap dotfiles history [FLAGS] [SUBCOMMAND]`](/cli/bootstrap/dotfiles/history.md)
 - [`mise bootstrap dotfiles history describe <REF> <TEXT>`](/cli/bootstrap/dotfiles/history/describe.md)
 - [`mise bootstrap dotfiles history diff [FLAGS] [A] [B]`](/cli/bootstrap/dotfiles/history/diff.md)
 - [`mise bootstrap dotfiles history ls [FLAGS]`](/cli/bootstrap/dotfiles/history/ls.md)
 - [`mise bootstrap dotfiles history show [FLAGS] [REF]`](/cli/bootstrap/dotfiles/history/show.md)
-- [`mise bootstrap dotfiles paths [-J --json] [--preview <PATH>]`](/cli/bootstrap/dotfiles/paths.md)
+- [`mise bootstrap dotfiles include <GLOB>`](/cli/bootstrap/dotfiles/include.md)
+- [`mise bootstrap dotfiles paths [FLAGS]`](/cli/bootstrap/dotfiles/paths.md)
 - [`mise bootstrap dotfiles rollback [FLAGS] [PATH]…`](/cli/bootstrap/dotfiles/rollback.md)
 - [`mise bootstrap dotfiles save [FLAGS] [PATH]…`](/cli/bootstrap/dotfiles/save.md)
 - [`mise bootstrap dotfiles status [-J --json] [--missing] [TARGET]…`](/cli/bootstrap/dotfiles/status.md)
 - [`mise bootstrap dotfiles track [FLAGS] <PATH>…`](/cli/bootstrap/dotfiles/track.md)
 - [`mise bootstrap dotfiles unapply [FLAGS] [TARGET]…`](/cli/bootstrap/dotfiles/unapply.md)
 - [`mise bootstrap dotfiles undo [-n --dry-run] [-y --yes] [REF]`](/cli/bootstrap/dotfiles/undo.md)
 - [`mise bootstrap dotfiles untrack <PATH>…`](/cli/bootstrap/dotfiles/untrack.md)
+- [`mise bootstrap dotfiles watch [--once] [-J --json]`](/cli/bootstrap/dotfiles/watch.md)
 - [`mise bootstrap files <SUBCOMMAND>`](/cli/bootstrap/files.md)
 - [`mise bootstrap files apply [FLAGS]`](/cli/bootstrap/files/apply.md)
 - [`mise bootstrap files status [FLAGS]`](/cli/bootstrap/files/status.md)