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

{git_cai_cli-0.12.2 → git_cai_cli-0.13.1}/.linters/.flake8

@@ -1,5 +1,5 @@
 [flake8]
-#extend-ignore = E501, F821
+extend-ignore = E203
 exclude =
     test_copy_files_fsb.py,
     __pycache__

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

@@ -41,7 +41,7 @@ include-naming-hint=yes                    # Suggest the expected format when na
 max-line-length=256                        # Maximum line length
 indent-string='    '                       # Use 4 spaces per indentation level
 indent-after-paren=4                       # Hanging indent size
-max-module-lines=1000                      # Max lines per module before warning
+max-module-lines=2000                      # Max lines per module before warning
 ignore-long-lines=^\s*(# )?<?https?://\S+>?$
                                            # Ignore long lines if they’re URLs or comments
 expected-line-ending-format=LF             # Require LF line endings

{git_cai_cli-0.12.2 → git_cai_cli-0.13.1}/.semgrepignore

@@ -2,4 +2,5 @@
 cli.py
 config.py
 squash.py
+pr.py
 release_aur.yml

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-cai-cli
-Version: 0.12.2
+Version: 0.13.1
 Summary: Use LLM to create git commit messages
 Author-email: Thorsten Foltz <thorsten.foltz@live.com>
 License-Expression: MIT
@@ -81,6 +81,7 @@ Currently supported providers:
 - Conventional Commits format support
 - Change configuration from the command line
 - Optional commit squashing with automatic summary generation (all, last N, or up to a specific commit)
+- Pull Request description generator (`--PR`) that summarizes the commits between the current branch and its base
 - List providers, models, active config, and file paths
 - Token usage logging for API calls
 - Branch name as LLM context
@@ -233,6 +234,9 @@ git cai -g
 - `conventional` – use Conventional Commits format
 - `token_logging` – log token usage after each LLM call
 - `measure_time` – log generation time
+- `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)
 
 ---
 
@@ -256,6 +260,8 @@ In addition to `git cai`, the following options are available:
 - `-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
+- `-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)
@@ -317,6 +323,39 @@ Persist the default:
 git cai -S full_files=true
 ```
 
+### Pull Request descriptions
+
+`-r` / `--PR` generates a Markdown Pull Request description from the commits
+between the current branch and its base branch. The output has two sections —
+`## Summary` (bullet list following the same best practices as commit messages:
+imperative mood, capitalized, no trailing period, 72-char wrap) and
+`## Test plan` (a checklist a reviewer can run).
+
+This mode never modifies git state — no commit, no reset, no force push.
+
+```sh
+git cai -r                      # print to stdout (default)
+git cai --PR                    # long form
+git cai -r --base develop       # explicit base branch
+git cai -r -x "Closes JIRA-1234"  # add extra context
+```
+
+The base branch is auto-detected in this order: `origin/HEAD`, then local
+`main`, then local `master`. Use `--base` for repositories with non-standard
+layouts or no `origin/HEAD`.
+
+By default the description is printed to stdout. To write it to a file in the
+repository root instead, set `pr_to_file: true`:
+
+```sh
+git cai -S pr_to_file=true
+git cai -S pr_file_name=PR.md   # optional: change the filename
+git cai -r                       # writes ./PR.md (or PR_DESCRIPTION.md by default)
+```
+
+Configuration follows the usual precedence: repo `cai_config.yml` wins,
+otherwise `~/.config/cai/cai_config.yml`, otherwise the built-in defaults.
+
 ### Changing configuration from the CLI
 
 Instead of editing YAML files manually, use `--set` or `--set-home` to update config values.

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

@@ -52,6 +52,7 @@ Currently supported providers:
 - Conventional Commits format support
 - Change configuration from the command line
 - Optional commit squashing with automatic summary generation (all, last N, or up to a specific commit)
+- Pull Request description generator (`--PR`) that summarizes the commits between the current branch and its base
 - List providers, models, active config, and file paths
 - Token usage logging for API calls
 - Branch name as LLM context
@@ -204,6 +205,9 @@ git cai -g
 - `conventional` – use Conventional Commits format
 - `token_logging` – log token usage after each LLM call
 - `measure_time` – log generation time
+- `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)
 
 ---
 
@@ -227,6 +231,8 @@ In addition to `git cai`, the following options are available:
 - `-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
+- `-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)
@@ -288,6 +294,39 @@ Persist the default:
 git cai -S full_files=true
 ```
 
+### Pull Request descriptions
+
+`-r` / `--PR` generates a Markdown Pull Request description from the commits
+between the current branch and its base branch. The output has two sections —
+`## Summary` (bullet list following the same best practices as commit messages:
+imperative mood, capitalized, no trailing period, 72-char wrap) and
+`## Test plan` (a checklist a reviewer can run).
+
+This mode never modifies git state — no commit, no reset, no force push.
+
+```sh
+git cai -r                      # print to stdout (default)
+git cai --PR                    # long form
+git cai -r --base develop       # explicit base branch
+git cai -r -x "Closes JIRA-1234"  # add extra context
+```
+
+The base branch is auto-detected in this order: `origin/HEAD`, then local
+`main`, then local `master`. Use `--base` for repositories with non-standard
+layouts or no `origin/HEAD`.
+
+By default the description is printed to stdout. To write it to a file in the
+repository root instead, set `pr_to_file: true`:
+
+```sh
+git cai -S pr_to_file=true
+git cai -S pr_file_name=PR.md   # optional: change the filename
+git cai -r                       # writes ./PR.md (or PR_DESCRIPTION.md by default)
+```
+
+Configuration follows the usual precedence: repo `cai_config.yml` wins,
+otherwise `~/.config/cai/cai_config.yml`, otherwise the built-in defaults.
+
 ### Changing configuration from the CLI
 
 Instead of editing YAML files manually, use `--set` or `--set-home` to update config values.

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

@@ -12,6 +12,9 @@ token_logging: true
 measure_time: true
 timeout: 30
 full_files: false
+pr_to_file: false
+pr_file_name: PR_DESCRIPTION.md
+pr_prompt_file: "/home/thorsten/.config/cai/pr_prompt.md"
 anthropic:
   model: claude-haiku-4-5
   temperature: 0

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

@@ -20,6 +20,7 @@ SYNOPSIS
          --list [config|editor|language|model|path|provider|style]]
         [-m MODEL | --model MODEL]
         [-P PROVIDER | --provider PROVIDER] [-p | --generate-prompts]
+        [-r | --PR] [--base BRANCH]
         [-S KEY=VALUE | --set KEY=VALUE]
         [-s [N|HASH] | --squash [N|HASH]]
         [-T SECONDS | --timeout SECONDS]
@@ -299,6 +300,48 @@ overwrites.
 git cai -p
 ----
 
+-r, --PR::
+Generate a Pull Request description summarizing the commits between the
+current branch and its base branch. git-cai collects the commit messages
+and the list of files changed since the branch diverged, sends them to
+the configured LLM, and produces a Markdown description with `## Summary`
+and `## Test plan` sections.
++
+This mode never modifies git state: no commit, no reset, no force push.
++
+By default the generated description is printed to stdout. To write it to
+a file in the repository root instead, set `pr_to_file: true` in
+`cai_config.yml`. The filename defaults to `PR_DESCRIPTION.md` and can be
+changed via `pr_file_name`. Configuration follows the same precedence as
+every other key (repository config wins; otherwise home config; otherwise
+built-in defaults).
++
+The base branch is auto-detected in this order: `origin/HEAD`, then local
+`main`, then local `master`. Use `--base` to override.
++
+Cannot be combined with `--amend`, `--list`, `--squash`, or `--update`.
+Can be combined with `--context` to inject extra context (e.g. a ticket
+number or reviewer ask).
++
+----
+git cai -r
+git cai --PR
+git cai -r --base develop
+git cai -r -x "Closes JIRA-1234"
+----
+
+--base BRANCH::
+Explicit base branch for `--PR`. Overrides the auto-detection chain
+(`origin/HEAD` -> `main` -> `master`). Useful for repositories whose base
+branch is not `main`/`master` or that lack `origin/HEAD`.
++
+Only meaningful in combination with `--PR` (`-r`).
++
+----
+git cai -r --base develop
+git cai -r --base release/1.x
+----
+
 -S, --set KEY=VALUE::
 Set a configuration value in the repository config (`cai_config.yml` in the
 repository root). Requires an existing repo config; if none is found, an
@@ -399,12 +442,13 @@ git cai -v
 
 -x, --context CONTEXT::
 Provide extra context for the LLM to consider when generating the commit
-message. The context string is appended to the diff (or commit history in squash
-mode) before sending it to the provider. This is useful for including information
-that is not visible in the diff itself, such as a ticket number, the reason for
-a change, or a link to an issue.
+message. The context string is appended to the diff (or commit history in
+squash mode, or the commit list in PR mode) before sending it to the
+provider. This is useful for including information that is not visible in
+the diff itself, such as a ticket number, the reason for a change, or a
+link to an issue.
 +
-Can be combined with any commit-generating mode (`COMMIT`, `AMEND`, or `SQUASH`).
+Can be combined with `COMMIT`, `AMEND`, `SQUASH`, or `PR` modes.
 Cannot be used with `--list` or `--update`.
 +
 ----
@@ -412,6 +456,7 @@ git cai -x "Fixes JIRA-1234"
 git cai -x "Performance optimisation for the search endpoint"
 git cai -A -x "Reword after code review feedback"
 git cai --squash -x "Resolves JIRA-99"
+git cai -r -x "Closes JIRA-1234"
 ----
 
 LIST TYPES
@@ -622,6 +667,16 @@ Available configuration keys:
 - `timeout` -- HTTP timeout in seconds for remote LLM calls (default `30`)
 - `full_files` -- send full working-tree contents of staged files alongside
   the diff (`true`/`false`, default `false`)
+- `pr_to_file` -- when running `--PR`, write the generated PR description
+  to a Markdown file in the repository root instead of printing it to
+  stdout (`true`/`false`, default `false`)
+- `pr_file_name` -- filename used when `pr_to_file` is `true` (default
+  `PR_DESCRIPTION.md`). The file is written in the repository root and
+  overwritten on each run.
+- `pr_prompt_file` -- path to a custom Markdown prompt file used by
+  `--PR`. Follows the same fallback chain as `prompt_file` /
+  `squash_prompt_file`: configured path -> `~/.config/cai/pr_prompt.md` ->
+  built-in fallback.
 - `<provider>.model` -- model name for a specific provider
 - `<provider>.temperature` -- temperature for a specific provider
 - `anthropic.max_tokens` -- upper bound on Anthropic response tokens
@@ -720,6 +775,35 @@ Squash all commits down to and including a specific commit:
 git cai -s a1b2c3d
 ----
 
+Generate a Pull Request description from the current branch (prints to
+stdout):
+
+----
+git cai -r
+git cai --PR
+----
+
+Generate a PR description against an explicit base branch:
+
+----
+git cai -r --base develop
+----
+
+Write the PR description to a file in the repository root (set once in
+`cai_config.yml`, then run normally):
+
+----
+git cai -S pr_to_file=true
+git cai -S pr_file_name=PR.md
+git cai -r
+----
+
+Generate a PR description with extra context:
+
+----
+git cai -r -x "Closes JIRA-1234"
+----
+
 Show supported styles, languages, or editors:
 
 ----

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

@@ -2,12 +2,12 @@
 .\"     Title: git-cai
 .\"    Author: Thorsten Foltz
 .\" Generator: Asciidoctor 2.0.26
-.\"      Date: 2026-04-23
+.\"      Date: 2026-04-27
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "GIT\-CAI" "1" "2026-04-23" "\ \&" "\ \&"
+.TH "GIT\-CAI" "1" "2026-04-27" "\ \&" "\ \&"
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .ss \n[.ss] 0
@@ -42,6 +42,7 @@ git-cai \- AI\-powered commit message generator
          \-\-list [config|editor|language|model|path|provider|style]]
         [\-m MODEL | \-\-model MODEL]
         [\-P PROVIDER | \-\-provider PROVIDER] [\-p | \-\-generate\-prompts]
+        [\-r | \-\-PR] [\-\-base BRANCH]
         [\-S KEY=VALUE | \-\-set KEY=VALUE]
         [\-s [N|HASH] | \-\-squash [N|HASH]]
         [\-T SECONDS | \-\-timeout SECONDS]
@@ -523,6 +524,60 @@ git cai \-p
 .if n .RE
 .RE
 .sp
+\-r, \-\-PR
+.RS 4
+Generate a Pull Request description summarizing the commits between the
+current branch and its base branch. git\-cai collects the commit messages
+and the list of files changed since the branch diverged, sends them to
+the configured LLM, and produces a Markdown description with \f(CR## Summary\fP
+and \f(CR## Test plan\fP sections.
+.sp
+This mode never modifies git state: no commit, no reset, no force push.
+.sp
+By default the generated description is printed to stdout. To write it to
+a file in the repository root instead, set \f(CRpr_to_file: true\fP in
+\f(CRcai_config.yml\fP. The filename defaults to \f(CRPR_DESCRIPTION.md\fP and can be
+changed via \f(CRpr_file_name\fP. Configuration follows the same precedence as
+every other key (repository config wins; otherwise home config; otherwise
+built\-in defaults).
+.sp
+The base branch is auto\-detected in this order: \f(CRorigin/HEAD\fP, then local
+\f(CRmain\fP, then local \f(CRmaster\fP. Use \f(CR\-\-base\fP to override.
+.sp
+Cannot be combined with \f(CR\-\-amend\fP, \f(CR\-\-list\fP, \f(CR\-\-squash\fP, or \f(CR\-\-update\fP.
+Can be combined with \f(CR\-\-context\fP to inject extra context (e.g. a ticket
+number or reviewer ask).
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-r
+git cai \-\-PR
+git cai \-r \-\-base develop
+git cai \-r \-x "Closes JIRA\-1234"
+.fam
+.fi
+.if n .RE
+.RE
+.sp
+\-\-base BRANCH
+.RS 4
+Explicit base branch for \f(CR\-\-PR\fP. Overrides the auto\-detection chain
+(\f(CRorigin/HEAD\fP \(-> \f(CRmain\fP \(-> \f(CRmaster\fP). Useful for repositories whose base
+branch is not \f(CRmain\fP/\f(CRmaster\fP or that lack \f(CRorigin/HEAD\fP.
+.sp
+Only meaningful in combination with \f(CR\-\-PR\fP (\f(CR\-r\fP).
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-r \-\-base develop
+git cai \-r \-\-base release/1.x
+.fam
+.fi
+.if n .RE
+.RE
+.sp
 \-S, \-\-set KEY=VALUE
 .RS 4
 Set a configuration value in the repository config (\f(CRcai_config.yml\fP in the
@@ -668,12 +723,13 @@ git cai \-v
 \-x, \-\-context CONTEXT
 .RS 4
 Provide extra context for the LLM to consider when generating the commit
-message. The context string is appended to the diff (or commit history in squash
-mode) before sending it to the provider. This is useful for including information
-that is not visible in the diff itself, such as a ticket number, the reason for
-a change, or a link to an issue.
+message. The context string is appended to the diff (or commit history in
+squash mode, or the commit list in PR mode) before sending it to the
+provider. This is useful for including information that is not visible in
+the diff itself, such as a ticket number, the reason for a change, or a
+link to an issue.
 .sp
-Can be combined with any commit\-generating mode (\f(CRCOMMIT\fP, \f(CRAMEND\fP, or \f(CRSQUASH\fP).
+Can be combined with \f(CRCOMMIT\fP, \f(CRAMEND\fP, \f(CRSQUASH\fP, or \f(CRPR\fP modes.
 Cannot be used with \f(CR\-\-list\fP or \f(CR\-\-update\fP.
 .sp
 .if n .RS 4
@@ -683,6 +739,7 @@ git cai \-x "Fixes JIRA\-1234"
 git cai \-x "Performance optimisation for the search endpoint"
 git cai \-A \-x "Reword after code review feedback"
 git cai \-\-squash \-x "Resolves JIRA\-99"
+git cai \-r \-x "Closes JIRA\-1234"
 .fam
 .fi
 .if n .RE
@@ -1131,6 +1188,46 @@ the diff (\f(CRtrue\fP/\f(CRfalse\fP, default \f(CRfalse\fP)
 .  sp -1
 .  IP \(bu 2.3
 .\}
+\f(CRpr_to_file\fP \(em when running \f(CR\-\-PR\fP, write the generated PR description
+to a Markdown file in the repository root instead of printing it to
+stdout (\f(CRtrue\fP/\f(CRfalse\fP, default \f(CRfalse\fP)
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.  sp -1
+.  IP \(bu 2.3
+.\}
+\f(CRpr_file_name\fP \(em filename used when \f(CRpr_to_file\fP is \f(CRtrue\fP (default
+\f(CRPR_DESCRIPTION.md\fP). The file is written in the repository root and
+overwritten on each run.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.  sp -1
+.  IP \(bu 2.3
+.\}
+\f(CRpr_prompt_file\fP \(em path to a custom Markdown prompt file used by
+\f(CR\-\-PR\fP. Follows the same fallback chain as \f(CRprompt_file\fP /
+\f(CRsquash_prompt_file\fP: configured path \(-> \f(CR~/.config/cai/pr_prompt.md\fP \(->
+built\-in fallback.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.  sp -1
+.  IP \(bu 2.3
+.\}
 \f(CR<provider>.model\fP \(em model name for a specific provider
 .RE
 .sp
@@ -1322,6 +1419,51 @@ git cai \-s a1b2c3d
 .fi
 .if n .RE
 .sp
+Generate a Pull Request description from the current branch (prints to
+stdout):
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-r
+git cai \-\-PR
+.fam
+.fi
+.if n .RE
+.sp
+Generate a PR description against an explicit base branch:
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-r \-\-base develop
+.fam
+.fi
+.if n .RE
+.sp
+Write the PR description to a file in the repository root (set once in
+\f(CRcai_config.yml\fP, then run normally):
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-S pr_to_file=true
+git cai \-S pr_file_name=PR.md
+git cai \-r
+.fam
+.fi
+.if n .RE
+.sp
+Generate a PR description with extra context:
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-r \-x "Closes JIRA\-1234"
+.fam
+.fi
+.if n .RE
+.sp
 Show supported styles, languages, or editors:
 .sp
 .if n .RS 4

{git_cai_cli-0.12.2 → git_cai_cli-0.13.1}/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.12.2'
-__version_tuple__ = version_tuple = (0, 12, 2)
+__version__ = version = '0.13.1'
+__version_tuple__ = version_tuple = (0, 13, 1)
 
-__commit_id__ = commit_id = 'gf511d4825'
+__commit_id__ = commit_id = 'gab0a91cf3'

{git_cai_cli-0.12.2 → git_cai_cli-0.13.1}/src/git_cai_cli/cli/cli.py

@@ -78,6 +78,17 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
     squash: bool = typer.Option(
         False, "--squash", "-s", help="Squash commits on this branch"
     ),
+    pr: bool = typer.Option(
+        False,
+        "--PR",
+        "-r",
+        help="Generate a Pull Request description from the commits on this branch",
+    ),
+    base: str = typer.Option(
+        None,
+        "--base",
+        help="Explicit base branch for --PR (overrides auto-detection)",
+    ),
     update: bool = typer.Option(False, "--update", "-u", help="Check for updates"),
     set_config: str = typer.Option(
         None,
@@ -143,7 +154,13 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
         do_install()
         raise typer.Exit()
 
-    mode = resolve_mode(amend=amend, list_flag=list_flag, squash=squash, update=update)
+    mode = resolve_mode(
+        amend=amend,
+        list_flag=list_flag,
+        pr=pr,
+        squash=squash,
+        update=update,
+    )
 
     validate_options(
         mode=mode,
@@ -180,8 +197,8 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
         try:
             manager.generate_prompts_here()
             typer.echo(
-                "commit_prompt.md, squash_prompt.md, and full_files_prompt.md "
-                "created in current directory."
+                "commit_prompt.md, squash_prompt.md, full_files_prompt.md, "
+                "and pr_prompt.md created in current directory."
             )
         except RuntimeError as e:
             typer.echo(f"Error: {e}", err=True)
@@ -228,6 +245,7 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
         timeout_override=timeout,
         full_files_override=full_files,
         files_override=files,
+        base_override=base,
     )
 
 

{git_cai_cli-0.12.2 → git_cai_cli-0.13.1}/src/git_cai_cli/cli/helptext.py

@@ -30,7 +30,9 @@ Flags:
   -l, --list               List information (e.g. languages, styles, providers, config)
   -m, --model NAME         Override model for this invocation (requires --provider)
   -P, --provider NAME      Override LLM provider for this invocation
-  -p, --generate-prompts   Generate default commit_prompt.md and squash_prompt.md
+  -p, --generate-prompts   Generate default commit/squash/full_files/pr prompt files
+  -r, --PR                 Generate a Pull Request description from the commits on this branch
+      --base BRANCH        Base branch for --PR (overrides auto-detection)
   -S, --set KEY=VALUE      Set a config value in repo config (requires existing repo config)
   -s, --squash [N|HASH]    Squash commits on this branch and summarize them
                            No argument: squash all commits since branch checkout

{git_cai_cli-0.12.2 → git_cai_cli-0.13.1}/src/git_cai_cli/cli/modes.py

@@ -15,18 +15,27 @@ class Mode(Enum):
     AMEND = auto()
     COMMIT = auto()
     LIST = auto()
+    PR = auto()
     SQUASH = auto()
     UPDATE = auto()
 
 
-def resolve_mode(*, amend: bool, list_flag: bool, squash: bool, update: bool) -> Mode:
+def resolve_mode(
+    *,
+    amend: bool,
+    list_flag: bool,
+    pr: bool,
+    squash: bool,
+    update: bool,
+) -> Mode:
     """
     Resolves the operational mode based on the provided flags.
     """
-    flags = [amend, list_flag, squash, update]
+    flags = [amend, list_flag, pr, squash, update]
     if sum(flags) > 1:
         typer.echo(
-            "Error: --amend, --list, --squash, and --update cannot be used together.",
+            "Error: --amend, --list, --PR, --squash, and --update "
+            "cannot be used together.",
             err=True,
         )
         raise typer.Exit(code=1)
@@ -35,6 +44,8 @@ def resolve_mode(*, amend: bool, list_flag: bool, squash: bool, update: bool) ->
         return Mode.AMEND
     if list_flag:
         return Mode.LIST
+    if pr:
+        return Mode.PR
     if squash:
         return Mode.SQUASH
     if update:
@@ -68,7 +79,7 @@ def validate_options(
 
     if stage_tracked and mode not in (Mode.COMMIT, Mode.AMEND):
         typer.echo(
-            "Error: --all cannot be used with --list, --update, or --squash.",
+            "Error: --all cannot be used with --list, --update, --PR, or --squash.",
             err=True,
         )
         raise typer.Exit(code=1)
@@ -87,7 +98,7 @@ def validate_options(
         )
         raise typer.Exit(code=1)
 
-    if context and mode not in (Mode.COMMIT, Mode.AMEND, Mode.SQUASH):
+    if context and mode not in (Mode.COMMIT, Mode.AMEND, Mode.SQUASH, Mode.PR):
         typer.echo(
             "Error: --context cannot be used with --list or --update.",
             err=True,
@@ -96,7 +107,7 @@ def validate_options(
 
     if files and mode not in (Mode.COMMIT, Mode.AMEND):
         typer.echo(
-            "Error: --files cannot be used with --list, --update, or --squash.",
+            "Error: --files cannot be used with --list, --update, --PR, or --squash.",
             err=True,
         )
         raise typer.Exit(code=1)