@ait-co/console-cli 0.1.4 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -75,6 +75,17 @@ The containing directory is created with mode `0700`. Cookies captured during lo
75
75
 
76
76
  See [CLAUDE.md](./CLAUDE.md) for the rationale behind using a plain `0600` file instead of an OS keychain.
77
77
 
78
+ ## Update notifications
79
+
80
+ When running interactively, `aitcc` occasionally checks for a newer release and prints a one-line notice on stderr if one exists. The check is rate-limit friendly:
81
+
82
+ - At most one network call every 24 hours, no matter how often you run commands.
83
+ - Even a failed check updates the throttle window, so a broken network or a 403 from GitHub does not loop back within minutes.
84
+ - Conditional GET (`If-None-Match`) — a 304 response does not consume the anonymous GitHub rate-limit bucket.
85
+ - The check is skipped entirely when stdout is not a TTY, when `--json` is passed, or when `AITCC_NO_UPDATE_CHECK=1` is set.
86
+
87
+ Cached state lives at `$XDG_CACHE_HOME/aitcc/upgrade-check.json` (fallback `~/.cache/aitcc/upgrade-check.json`).
88
+
78
89
  ## Machine-readable output (`--json`)
79
90
 
80
91
  Every command accepts `--json`. When set: