git-cai-cli 0.13.1__tar.gz → 0.13.2__tar.gz

{git_cai_cli-0.13.1 → git_cai_cli-0.13.2}/.linters/.pylintrc

@@ -66,10 +66,10 @@ check-protected-access-in-special-methods=no
                                            # Don’t warn about protected attr access in dunder methods
 
 [DESIGN]
-max-args=15                                # Max arguments per function
-max-attributes=7                           # Max attributes per class
+max-args=20                                # Max arguments per function
+max-attributes=12                          # Max attributes per class
 max-branches=30                            # Max branches per function
-max-locals=50                              # Max locals per function
+max-locals=60                              # Max locals per function
 max-returns=10                             # Max return statements per function
 max-statements=100                         # Max total statements per function
 max-public-methods=20                      # Max public methods per class
@@ -77,7 +77,7 @@ min-public-methods=1                       # Min public methods per class
 max-nested-blocks=15                       # Max nesting depth
 max-bool-expr=15                           # Max boolean subexpressions in a condition
 max-parents=7                              # Max base classes per class
-max-positional-arguments=15                # Max positional arguments per function
+max-positional-arguments=20                # Max positional arguments per function
 
 [EXCEPTIONS]
 overgeneral-exceptions=builtins.BaseException,builtins.Exception

{git_cai_cli-0.13.1 → git_cai_cli-0.13.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-cai-cli
-Version: 0.13.1
+Version: 0.13.2
 Summary: Use LLM to create git commit messages
 Author-email: Thorsten Foltz <thorsten.foltz@live.com>
 License-Expression: MIT
@@ -25,6 +25,7 @@ Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: openai>=2.30.0
 Requires-Dist: typer>=0.23.1
 Requires-Dist: requests>=2.33.0
+Requires-Dist: pathspec>=0.12.1
 Dynamic: license-file
 
 # cai
@@ -87,6 +88,7 @@ Currently supported providers:
 - Branch name as LLM context
 - Extra context for the LLM
 - Generation time measurement
+- Local-only usage analytics (per-provider commits, tokens, latency) with opt-in SQLite storage
 - Shell completion for bash, zsh, and fish
 
 ---
@@ -237,6 +239,8 @@ git cai -g
 - `pr_to_file` – when `--PR` is used, write the generated description to a Markdown file in the repo root instead of stdout (default `false`)
 - `pr_file_name` – filename used when `pr_to_file` is `true` (default `PR_DESCRIPTION.md`)
 - `pr_prompt_file` – optional path to a custom Markdown prompt for `--PR` (falls back to `~/.config/cai/pr_prompt.md`, then a built-in default)
+- `stats` – opt in to local-only usage analytics (per-run row in a SQLite DB at `~/.local/share/git-cai/stats.db`); default `false`.
+No diff content, commit messages, or file paths are stored — only metadata (provider, model, kind, repo name, token counts, latency, settings)
 
 ---
 
@@ -258,17 +262,22 @@ In addition to `git cai`, the following options are available:
 - `-i`, `--install-completion` – install shell completion for bash, zsh, or fish
 - `-l`, `--list` – list available information (`config`, `editor`, `language`, `model`, `path`, `provider`, `style`)
 - `-m`, `--model` – override the model for this invocation (requires `-P`)
-- `-p`, `--generate-prompts` – generate default `commit_prompt.md` and `squash_prompt.md` in the current directory (for customization)
 - `-P`, `--provider` – override the LLM provider for this invocation
+- `-p`, `--generate-prompts` – generate default `commit_prompt.md` and `squash_prompt.md` in the current directory (for customization)
+- `-Q`, `--stats` – show local-only usage analytics (commits/squashes/PRs per provider, tokens, average latency)
+- `--since YYYY-MM-DD` – filter `--stats` to events on or after this date
+- `--json` – render `--stats` output as JSON
+- `--reset-stats` – delete all rows from the local stats DB
+- `-q`, `--sql true|false` – override stats writing for this run (wins over the persisted `stats` config)
 - `-r`, `--PR` – generate a Pull Request description from the commits between the current branch and its base (prints to stdout by default; set `pr_to_file=true` to write a Markdown file)
 - `--base` `BRANCH` – explicit base branch for `--PR` (overrides auto-detection: `origin/HEAD` → `main` → `master`)
 - `-S`, `--set` – set a config value (`key=value`) in repo config (requires existing repo config)
 - `-s`, `--squash` `[N|HASH]` – squash commits on the current branch and summarize them. Without argument: squash all since branch checkout. With a number: squash the last N commits. With a commit hash: squash up to and including that commit
 - `-T`, `--timeout` `SECONDS` – HTTP timeout for this invocation (overrides config)
 - `-t`, `--time` – measure and log commit message generation time
-- `-x`, `--context` – provide extra context for the LLM (e.g. ticket number, reason for change)
 - `-u`, `--update` – check for updates
 - `-v`, `--version` – show the installed version
+- `-x`, `--context` – provide extra context for the LLM (e.g. ticket number, reason for change)
 
 ## Examples
 
@@ -356,6 +365,24 @@ git cai -r                       # writes ./PR.md (or PR_DESCRIPTION.md by defau
 Configuration follows the usual precedence: repo `cai_config.yml` wins,
 otherwise `~/.config/cai/cai_config.yml`, otherwise the built-in defaults.
 
+### Local usage analytics
+
+Opt in by setting `stats: true` in `cai_config.yml` (or pass `-q true` for a single run). Each generation appends one row to a local SQLite DB at `~/.local/share/git-cai/stats.db` with metadata only — no diff, message, or file content.
+
+```sh
+git cai -S stats=true            # enable persistently in the repo config
+git cai -H stats=true            # or in the home config
+git cai -q true                  # one-off opt-in regardless of config
+git cai -q false                 # one-off opt-out
+
+git cai --stats                  # text summary
+git cai -Q --json                # machine-readable
+git cai -Q --since 2026-01-01    # date filter
+git cai --reset-stats            # wipe all rows
+```
+
+Rows are split by `kind` (`commit`, `amend`, `squash`, `pr`) and capture provider, model, repo name, token counts, real LLM latency, and a snapshot of the active settings (language, style, emoji, temperature, prompt file).
+
 ### Changing configuration from the CLI
 
 Instead of editing YAML files manually, use `--set` or `--set-home` to update config values.

{git_cai_cli-0.13.1 → git_cai_cli-0.13.2}/README.md

@@ -58,6 +58,7 @@ Currently supported providers:
 - Branch name as LLM context
 - Extra context for the LLM
 - Generation time measurement
+- Local-only usage analytics (per-provider commits, tokens, latency) with opt-in SQLite storage
 - Shell completion for bash, zsh, and fish
 
 ---
@@ -208,6 +209,8 @@ git cai -g
 - `pr_to_file` – when `--PR` is used, write the generated description to a Markdown file in the repo root instead of stdout (default `false`)
 - `pr_file_name` – filename used when `pr_to_file` is `true` (default `PR_DESCRIPTION.md`)
 - `pr_prompt_file` – optional path to a custom Markdown prompt for `--PR` (falls back to `~/.config/cai/pr_prompt.md`, then a built-in default)
+- `stats` – opt in to local-only usage analytics (per-run row in a SQLite DB at `~/.local/share/git-cai/stats.db`); default `false`.
+No diff content, commit messages, or file paths are stored — only metadata (provider, model, kind, repo name, token counts, latency, settings)
 
 ---
 
@@ -229,17 +232,22 @@ In addition to `git cai`, the following options are available:
 - `-i`, `--install-completion` – install shell completion for bash, zsh, or fish
 - `-l`, `--list` – list available information (`config`, `editor`, `language`, `model`, `path`, `provider`, `style`)
 - `-m`, `--model` – override the model for this invocation (requires `-P`)
-- `-p`, `--generate-prompts` – generate default `commit_prompt.md` and `squash_prompt.md` in the current directory (for customization)
 - `-P`, `--provider` – override the LLM provider for this invocation
+- `-p`, `--generate-prompts` – generate default `commit_prompt.md` and `squash_prompt.md` in the current directory (for customization)
+- `-Q`, `--stats` – show local-only usage analytics (commits/squashes/PRs per provider, tokens, average latency)
+- `--since YYYY-MM-DD` – filter `--stats` to events on or after this date
+- `--json` – render `--stats` output as JSON
+- `--reset-stats` – delete all rows from the local stats DB
+- `-q`, `--sql true|false` – override stats writing for this run (wins over the persisted `stats` config)
 - `-r`, `--PR` – generate a Pull Request description from the commits between the current branch and its base (prints to stdout by default; set `pr_to_file=true` to write a Markdown file)
 - `--base` `BRANCH` – explicit base branch for `--PR` (overrides auto-detection: `origin/HEAD` → `main` → `master`)
 - `-S`, `--set` – set a config value (`key=value`) in repo config (requires existing repo config)
 - `-s`, `--squash` `[N|HASH]` – squash commits on the current branch and summarize them. Without argument: squash all since branch checkout. With a number: squash the last N commits. With a commit hash: squash up to and including that commit
 - `-T`, `--timeout` `SECONDS` – HTTP timeout for this invocation (overrides config)
 - `-t`, `--time` – measure and log commit message generation time
-- `-x`, `--context` – provide extra context for the LLM (e.g. ticket number, reason for change)
 - `-u`, `--update` – check for updates
 - `-v`, `--version` – show the installed version
+- `-x`, `--context` – provide extra context for the LLM (e.g. ticket number, reason for change)
 
 ## Examples
 
@@ -327,6 +335,24 @@ git cai -r                       # writes ./PR.md (or PR_DESCRIPTION.md by defau
 Configuration follows the usual precedence: repo `cai_config.yml` wins,
 otherwise `~/.config/cai/cai_config.yml`, otherwise the built-in defaults.
 
+### Local usage analytics
+
+Opt in by setting `stats: true` in `cai_config.yml` (or pass `-q true` for a single run). Each generation appends one row to a local SQLite DB at `~/.local/share/git-cai/stats.db` with metadata only — no diff, message, or file content.
+
+```sh
+git cai -S stats=true            # enable persistently in the repo config
+git cai -H stats=true            # or in the home config
+git cai -q true                  # one-off opt-in regardless of config
+git cai -q false                 # one-off opt-out
+
+git cai --stats                  # text summary
+git cai -Q --json                # machine-readable
+git cai -Q --since 2026-01-01    # date filter
+git cai --reset-stats            # wipe all rows
+```
+
+Rows are split by `kind` (`commit`, `amend`, `squash`, `pr`) and capture provider, model, repo name, token counts, real LLM latency, and a snapshot of the active settings (language, style, emoji, temperature, prompt file).
+
 ### Changing configuration from the CLI
 
 Instead of editing YAML files manually, use `--set` or `--set-home` to update config values.

{git_cai_cli-0.13.1 → git_cai_cli-0.13.2}/cai_config.yml

@@ -15,6 +15,7 @@ full_files: false
 pr_to_file: false
 pr_file_name: PR_DESCRIPTION.md
 pr_prompt_file: "/home/thorsten/.config/cai/pr_prompt.md"
+stats: true
 anthropic:
   model: claude-haiku-4-5
   temperature: 0

{git_cai_cli-0.13.1 → git_cai_cli-0.13.2}/docs/git-cai.txt

@@ -12,7 +12,7 @@ SYNOPSIS
 [verse]
 `git cai` [-A | --amend] [-a | --all] [-C | --conventional]
         [-b | --branch] [-c | --crazy] [-d | --debug]
-        [-F | --full-files] [-f PATH | --files PATH]
+        [-F | --full-files | --no-full-files] [-f PATH | --files PATH]
         [-g | --generate-config]
         [-H KEY=VALUE | --set-home KEY=VALUE] [-h | --help]
         [-i | --install-completion]
@@ -23,6 +23,8 @@ SYNOPSIS
         [-r | --PR] [--base BRANCH]
         [-S KEY=VALUE | --set KEY=VALUE]
         [-s [N|HASH] | --squash [N|HASH]]
+        [-Q | --stats] [--since YYYY-MM-DD] [--json] [--reset-stats]
+        [-q true|false | --sql true|false]
         [-T SECONDS | --timeout SECONDS]
         [-t | --time] [-u | --update] [-v | --version]
         [-x CONTEXT | --context CONTEXT]
@@ -97,12 +99,15 @@ Cannot be combined with `--list`, `--update`, or `--squash`.
 git cai -a
 ----
 
--b, --branch::
+-b, --branch / --no-branch::
 Include the current Git branch name as context when generating the commit
 message. The LLM uses the branch name to better understand the intent and
 scope of the changes (e.g., a branch named `fix/login-timeout` hints at a
 bug fix related to login timeouts).
 +
+Use `--no-branch` to explicitly disable branch context for this run when
+the persisted config has it enabled.
++
 This flag applies for the current invocation only. To enable it permanently,
 set `branch_context: true` in `cai_config.yml` or run:
 +
@@ -113,15 +118,19 @@ git cai -S branch_context=true
 ----
 git cai -b
 git cai -b -c
+git cai --no-branch
 ----
 
--C, --conventional::
+-C, --conventional / --no-conventional::
 Generate the commit message in Conventional Commits format
 (`type(scope): description`). The LLM is instructed to use one of the
 following types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`,
 `build`, `ci`, `chore`, `revert`. Append `!` after the type or scope to
 signal a breaking change.
 +
+Use `--no-conventional` to explicitly disable Conventional Commits for
+this run when the persisted config has it enabled.
++
 This flag applies for the current invocation only. To enable it permanently,
 set `conventional: true` in `cai_config.yml` or run:
 +
@@ -132,6 +141,7 @@ git cai -S conventional=true
 ----
 git cai -C
 git cai -C -c
+git cai --no-conventional
 ----
 
 -c, --crazy::
@@ -300,6 +310,83 @@ overwrites.
 git cai -p
 ----
 
+-Q, --stats::
+Show local-only usage analytics: commits and squashes generated, top
+provider, total token counts, average latency, and per-provider rollups.
+Recording is opt-in via the top-level `stats` config key (a plain
+boolean, default `false`), so this view is empty until you turn writing
+on. No diff content, commit messages, or file paths are stored — only
+metadata.
++
+Combine with `--since YYYY-MM-DD` to scope the view to recent activity, or
+with `--json` to emit machine-readable output. Use `--reset-stats` to
+clear the local SQLite database.
++
+The DB lives at `$XDG_DATA_HOME/git-cai/stats.db` (default
+`~/.local/share/git-cai/stats.db`). Override with the top-level
+`stats_db_path` config key.
++
+At the start of every run, git-cai logs whether stats writing is
+enabled and (when enabled) the path of the SQLite database, so users
+always know where their analytics live.
++
+If the running Python build was compiled without sqlite3, this command
+prints a clear message explaining how to fix it; commit generation
+continues to work normally in that case.
++
+The `stats` (and `stats_db_path`) keys are the one configuration
+exception that does not follow the strict repo-replaces-home rule:
+when the repo `cai_config.yml` does not mention them, the values are
+taken from the home `~/.config/cai/cai_config.yml`. If neither file
+defines `stats`, the hardcoded default is `false`. Use `git cai -g` to
+write a fresh config that includes the setting so it is visible.
++
+----
+git cai --stats
+git cai -Q --since 2026-01-01
+git cai -Q --json
+git cai --reset-stats
+----
+
+--since YYYY-MM-DD::
+Restrict `--stats` (`-Q`) output to events recorded on or after this UTC
+date. Has no effect outside of `--stats`. The date format is strict
+ISO-8601 (e.g. `2026-01-15`).
++
+----
+git cai -Q --since 2026-01-01
+----
+
+--json::
+Emit `--stats` (`-Q`) output as a JSON document instead of the text
+summary. Suitable for piping into `jq` or other tooling. Has no effect
+outside of `--stats`.
++
+----
+git cai -Q --json
+git cai -Q --json --since 2026-01-01 | jq '.per_provider'
+----
+
+--reset-stats::
+Delete every row from the local stats SQLite DB and exit. Prints the
+number of rows removed. The schema and DB file are preserved (so the
+next opt-in run records into the same file). No-op when the DB does
+not yet exist.
++
+----
+git cai --reset-stats
+----
+
+-q, --sql VALUE::
+Per-invocation override for `stats.enabled`. VALUE is `true` or `false`
+(also accepts `yes/no`, `on/off`, `1/0`). Wins over the persisted config
+value. Useful for one-off opt-in or opt-out without editing the config.
++
+----
+git cai --sql true       # record this commit even when config has stats off
+git cai -q false         # don't record this commit even when config has stats on
+----
+
 -r, --PR::
 Generate a Pull Request description summarizing the commits between the
 current branch and its base branch. git-cai collects the commit messages
@@ -683,6 +770,13 @@ Available configuration keys:
   (default `32768`)
 - `ollama.timeout` -- HTTP timeout in seconds for Ollama generation calls
   (default `300`; overrides the global `timeout` for this provider only)
+- `stats` -- opt in to local-only usage analytics (`true`/`false`,
+  default `false`). When enabled, every generation appends one row to
+  `~/.local/share/git-cai/stats.db` capturing kind, repo name, provider,
+  model, token counts, real LLM latency, and a snapshot of the active
+  settings (language, style, emoji, temperature, prompt file). No diff
+  content, commit messages, or file paths are stored. View the rollup
+  with `git cai --stats` (`-Q`).
 
 FILES
 -----

{git_cai_cli-0.13.1 → git_cai_cli-0.13.2}/docs/man/git-cai.1

@@ -2,12 +2,12 @@
 .\"     Title: git-cai
 .\"    Author: Thorsten Foltz
 .\" Generator: Asciidoctor 2.0.26
-.\"      Date: 2026-04-27
+.\"      Date: 2026-05-09
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "GIT\-CAI" "1" "2026-04-27" "\ \&" "\ \&"
+.TH "GIT\-CAI" "1" "2026-05-09" "\ \&" "\ \&"
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .ss \n[.ss] 0
@@ -34,7 +34,7 @@ git-cai \- AI\-powered commit message generator
 .nf
 \f(CRgit cai\fP [\-A | \-\-amend] [\-a | \-\-all] [\-C | \-\-conventional]
         [\-b | \-\-branch] [\-c | \-\-crazy] [\-d | \-\-debug]
-        [\-F | \-\-full\-files] [\-f PATH | \-\-files PATH]
+        [\-F | \-\-full\-files | \-\-no\-full\-files] [\-f PATH | \-\-files PATH]
         [\-g | \-\-generate\-config]
         [\-H KEY=VALUE | \-\-set\-home KEY=VALUE] [\-h | \-\-help]
         [\-i | \-\-install\-completion]
@@ -45,6 +45,8 @@ git-cai \- AI\-powered commit message generator
         [\-r | \-\-PR] [\-\-base BRANCH]
         [\-S KEY=VALUE | \-\-set KEY=VALUE]
         [\-s [N|HASH] | \-\-squash [N|HASH]]
+        [\-Q | \-\-stats] [\-\-since YYYY\-MM\-DD] [\-\-json] [\-\-reset\-stats]
+        [\-q true|false | \-\-sql true|false]
         [\-T SECONDS | \-\-timeout SECONDS]
         [\-t | \-\-time] [\-u | \-\-update] [\-v | \-\-version]
         [\-x CONTEXT | \-\-context CONTEXT]
@@ -225,13 +227,16 @@ git cai \-a
 .if n .RE
 .RE
 .sp
-\-b, \-\-branch
+\-b, \-\-branch / \-\-no\-branch
 .RS 4
 Include the current Git branch name as context when generating the commit
 message. The LLM uses the branch name to better understand the intent and
 scope of the changes (e.g., a branch named \f(CRfix/login\-timeout\fP hints at a
 bug fix related to login timeouts).
 .sp
+Use \f(CR\-\-no\-branch\fP to explicitly disable branch context for this run when
+the persisted config has it enabled.
+.sp
 This flag applies for the current invocation only. To enable it permanently,
 set \f(CRbranch_context: true\fP in \f(CRcai_config.yml\fP or run:
 .sp
@@ -248,12 +253,13 @@ git cai \-S branch_context=true
 .fam C
 git cai \-b
 git cai \-b \-c
+git cai \-\-no\-branch
 .fam
 .fi
 .if n .RE
 .RE
 .sp
-\-C, \-\-conventional
+\-C, \-\-conventional / \-\-no\-conventional
 .RS 4
 Generate the commit message in Conventional Commits format
 (\f(CRtype(scope): description\fP). The LLM is instructed to use one of the
@@ -261,6 +267,9 @@ following types: \f(CRfeat\fP, \f(CRfix\fP, \f(CRdocs\fP, \f(CRstyle\fP, \f(CRre
 \f(CRbuild\fP, \f(CRci\fP, \f(CRchore\fP, \f(CRrevert\fP. Append \f(CR!\fP after the type or scope to
 signal a breaking change.
 .sp
+Use \f(CR\-\-no\-conventional\fP to explicitly disable Conventional Commits for
+this run when the persisted config has it enabled.
+.sp
 This flag applies for the current invocation only. To enable it permanently,
 set \f(CRconventional: true\fP in \f(CRcai_config.yml\fP or run:
 .sp
@@ -277,6 +286,7 @@ git cai \-S conventional=true
 .fam C
 git cai \-C
 git cai \-C \-c
+git cai \-\-no\-conventional
 .fam
 .fi
 .if n .RE
@@ -524,6 +534,113 @@ git cai \-p
 .if n .RE
 .RE
 .sp
+\-Q, \-\-stats
+.RS 4
+Show local\-only usage analytics: commits and squashes generated, top
+provider, total token counts, average latency, and per\-provider rollups.
+Recording is opt\-in via the top\-level \f(CRstats\fP config key (a plain
+boolean, default \f(CRfalse\fP), so this view is empty until you turn writing
+on. No diff content, commit messages, or file paths are stored — only
+metadata.
+.sp
+Combine with \f(CR\-\-since YYYY\-MM\-DD\fP to scope the view to recent activity, or
+with \f(CR\-\-json\fP to emit machine\-readable output. Use \f(CR\-\-reset\-stats\fP to
+clear the local SQLite database.
+.sp
+The DB lives at \f(CR$XDG_DATA_HOME/git\-cai/stats.db\fP (default
+\f(CR~/.local/share/git\-cai/stats.db\fP). Override with the top\-level
+\f(CRstats_db_path\fP config key.
+.sp
+At the start of every run, git\-cai logs whether stats writing is
+enabled and (when enabled) the path of the SQLite database, so users
+always know where their analytics live.
+.sp
+If the running Python build was compiled without sqlite3, this command
+prints a clear message explaining how to fix it; commit generation
+continues to work normally in that case.
+.sp
+The \f(CRstats\fP (and \f(CRstats_db_path\fP) keys are the one configuration
+exception that does not follow the strict repo\-replaces\-home rule:
+when the repo \f(CRcai_config.yml\fP does not mention them, the values are
+taken from the home \f(CR~/.config/cai/cai_config.yml\fP. If neither file
+defines \f(CRstats\fP, the hardcoded default is \f(CRfalse\fP. Use \f(CRgit cai \-g\fP to
+write a fresh config that includes the setting so it is visible.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-\-stats
+git cai \-Q \-\-since 2026\-01\-01
+git cai \-Q \-\-json
+git cai \-\-reset\-stats
+.fam
+.fi
+.if n .RE
+.RE
+.sp
+\-\-since YYYY\-MM\-DD
+.RS 4
+Restrict \f(CR\-\-stats\fP (\f(CR\-Q\fP) output to events recorded on or after this UTC
+date. Has no effect outside of \f(CR\-\-stats\fP. The date format is strict
+ISO\-8601 (e.g. \f(CR2026\-01\-15\fP).
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-Q \-\-since 2026\-01\-01
+.fam
+.fi
+.if n .RE
+.RE
+.sp
+\-\-json
+.RS 4
+Emit \f(CR\-\-stats\fP (\f(CR\-Q\fP) output as a JSON document instead of the text
+summary. Suitable for piping into \f(CRjq\fP or other tooling. Has no effect
+outside of \f(CR\-\-stats\fP.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-Q \-\-json
+git cai \-Q \-\-json \-\-since 2026\-01\-01 | jq \*(Aq.per_provider\*(Aq
+.fam
+.fi
+.if n .RE
+.RE
+.sp
+\-\-reset\-stats
+.RS 4
+Delete every row from the local stats SQLite DB and exit. Prints the
+number of rows removed. The schema and DB file are preserved (so the
+next opt\-in run records into the same file). No\-op when the DB does
+not yet exist.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-\-reset\-stats
+.fam
+.fi
+.if n .RE
+.RE
+.sp
+\-q, \-\-sql VALUE
+.RS 4
+Per\-invocation override for \f(CRstats.enabled\fP. VALUE is \f(CRtrue\fP or \f(CRfalse\fP
+(also accepts \f(CRyes/no\fP, \f(CRon/off\fP, \f(CR1/0\fP). Wins over the persisted config
+value. Useful for one\-off opt\-in or opt\-out without editing the config.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-\-sql true\&       # record this commit even when config has stats off
+git cai \-q false\&         # don\*(Aqt record this commit even when config has stats on
+.fam
+.fi
+.if n .RE
+.RE
+.sp
 \-r, \-\-PR
 .RS 4
 Generate a Pull Request description summarizing the commits between the
@@ -1265,6 +1382,23 @@ built\-in fallback.
 \f(CRollama.timeout\fP \(em HTTP timeout in seconds for Ollama generation calls
 (default \f(CR300\fP; overrides the global \f(CRtimeout\fP for this provider only)
 .RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.  sp -1
+.  IP \(bu 2.3
+.\}
+\f(CRstats\fP \(em opt in to local\-only usage analytics (\f(CRtrue\fP/\f(CRfalse\fP,
+default \f(CRfalse\fP). When enabled, every generation appends one row to
+\f(CR~/.local/share/git\-cai/stats.db\fP capturing kind, repo name, provider,
+model, token counts, real LLM latency, and a snapshot of the active
+settings (language, style, emoji, temperature, prompt file). No diff
+content, commit messages, or file paths are stored. View the rollup
+with \f(CRgit cai \-\-stats\fP (\f(CR\-Q\fP).
+.RE
 .SH "FILES"
 .sp
 \f(CR~/.config/cai/cai_config.yml\fP

{git_cai_cli-0.13.1 → git_cai_cli-0.13.2}/pyproject.toml

@@ -11,6 +11,7 @@ dependencies = [
     "openai>=2.30.0",
     "typer>=0.23.1",
     "requests>=2.33.0",
+    "pathspec>=0.12.1",
 ]
 license = "MIT"
 classifiers = [

{git_cai_cli-0.13.1 → git_cai_cli-0.13.2}/src/git_cai_cli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.13.1'
-__version_tuple__ = version_tuple = (0, 13, 1)
+__version__ = version = '0.13.2'
+__version_tuple__ = version_tuple = (0, 13, 2)
 
-__commit_id__ = commit_id = 'gab0a91cf3'
+__commit_id__ = commit_id = 'g89441925e'