diffsage 1.2.0__tar.gz → 1.3.0__tar.gz

{diffsage-1.2.0/src/diffsage.egg-info → diffsage-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: diffsage
-Version: 1.2.0
+Version: 1.3.0
 Summary: AI-powered Git workflow assistant
 Author: Gunitha Rathnayake
 License: MIT
@@ -116,6 +116,10 @@ Current capabilities include:
 - AI provider authentication and error handling
 - Layered architecture
 - Comprehensive automated test suite
+- Add AI-assisted PR generation
+- Interactive PR draft review/edit/regeneration
+- GitHub PR creation
+- Branch synchronization validation
 
 ---
 
@@ -150,18 +154,38 @@ Its scope is intentionally focused on improving Git workflows.
 
 # Project Status
 
-> **Current Stage:** Active Development
+> **Current Stage:** Alpha
 
-DiffSage is currently under active development.
+DiffSage is an actively developed open-source project.
 
-The project is being developed privately while the core architecture, documentation, and workflow foundation are finalized.
+The project is published on PyPI and distributed as a Python package for
+developers, automation, and AI agents.
 
-The long-term goal is to open source the project once it reaches a stable and well-documented foundation.
+The current focus is on expanding Git workflow capabilities while maintaining
+a stable architecture, clear documentation, reliable automation, and strong
+engineering practices.
 
 ---
 
 # Installation
 
+## User Installation
+
+DiffSage is published on PyPI and can be installed using `pipx`.
+
+DiffSage currently requires Python 3.12.
+
+```bash
+pipx install diffsage
+```
+
+After installation verify the environment
+```bash
+diffsage doctor
+```
+
+## Developer Installation
+
 Clone the repository:
 
 ```bash
@@ -192,9 +216,29 @@ Windows
 Install the project:
 
 ```bash
-pip install -e ".[dev]"
+python -m pip install -e ".[dev]"
+```
+
+---
+
+# Releases
+
+DiffSage releases are published through GitHub Releases and distributed through PyPI.
+
+Released package versions can be installed directly with:
+
+```bash
+pipx install diffsage
+```
+
+A specific version can be installed with:
+
+```bash
+pipx install diffsage==1.2.0
 ```
 
+Release builds and PyPI publishing are automated through GitHub Actions.
+
 ---
 
 # Configuration
@@ -203,17 +247,18 @@ DiffSage supports layered configuration through global and repository-local TOML
 
 Application configuration controls how DiffSage behaves and can be managed through global, repository-local, and environment-based configuration.
 
-Provider credentials are managed separately from application configuration. 
 Provider credentials are managed separately from application configuration and are not part of the Settings configuration model.
 
 ```env
 DIFFSAGE_PROVIDER=gemini
-DIFFSAGE_AI_MODEL=gemini-3.5-flash-lite
+DIFFSAGE_AI_MODEL=<provider-supported-model>
 DIFFSAGE_LOG_LEVEL=INFO
 DIFFSAGE_TIMEOUT=60
 DIFFSAGE_MAX_RETRIES=3
 ```
 
+The configured model must be supported by the selected AI provider.
+
 Configuration can also be managed directly from the CLI:
 
 ```bash
@@ -272,10 +317,38 @@ Display AI suggestion
 [N] Cancel
 ```
 
+```bash
+diffsage pr 
+```
+
+PR workflow
+
+```text
+Generate PR draft
+       │
+       ▼
+Show base/head branches
+       │
+       ▼
+Display PR draft
+       │
+ ┌─────┼───────────┐
+ ▼     ▼           ▼
+Edit Regenerate   Cancel
+       │
+       ▼
+    Accept
+       │
+       ▼
+Create GitHub PR
+       │
+       ▼
+Display PR URL
+```
+
 Named credential profiles are also supported:
 
 ```bash
-
 diffsage auth set gemini YOUR_API_KEY --name paid
 ```
 
@@ -300,6 +373,8 @@ diffsage auth unset gemini
 |----------|-------------|
 | `diffsage doctor` | Validate the local DiffSage environment |
 | `diffsage commit` | Generate and manage AI-assisted commit messages |
+| `diffsage pr` | Generate, review, and create a GitHub pull request |
+| `diffsage pr <base-branch>` | Generate and create a pull request against a specific base branch |
 | `diffsage config list` | Display the current DiffSage configuration |
 | `diffsage config get` | Display the value of a configuration setting |
 | `diffsage config set` | Update a configuration setting |
@@ -310,7 +385,46 @@ diffsage auth unset gemini
 | `diffsage auth unset` | Remove a provider credential |
 | `diffsage ask` | Ask the configured AI provider a question |
 
-More commands will be introduced as the project evolves.
+---
+
+## Pull Request Workflow
+
+The `diffsage pr` command analyzes the current Git branch against a resolved base branch and generates a structured pull request draft.
+
+The workflow is interactive:
+
+```text
+Analyze Git repository
+        │
+        ▼
+Resolve base branch
+        │
+        ▼
+Generate PR draft
+        │
+        ▼
+Display base/head branches
+        │
+        ▼
+Review PR draft
+        │
+ ┌──────┼──────────────┐
+ ▼      ▼              ▼
+Edit  Regenerate      Cancel
+ │      │
+ └──────┴───────┐
+                ▼
+             Accept
+                │
+                ▼
+        Validate GitHub access
+                │
+                ▼
+        Create GitHub pull request
+                │
+                ▼
+        Display pull request URL
+```
 
 ---
 
@@ -328,15 +442,22 @@ Commands
 │
 ├── Authentication
 │
-▼
-Services
-│
-├── Git
-├── AI
-├── Prompt Generation
-└── Credentials
+├── Commit Workflow
 │
-▼
+└── Pull Request Workflow
+        │
+        ▼
+    Services
+        │
+        ├── Git
+        ├── GitHub
+        ├── AI
+        ├── Prompt Generation
+        ├── Pull Request Analysis
+        ├── Pull Request Parsing
+        └── Credentials
+        │
+        ▼
 Providers / Storage
 ```
 
@@ -362,6 +483,7 @@ src/
     ├── config/
     ├── exceptions/
     ├── git/
+    ├── github/
     ├── logging/
     ├── models/
     ├── parsers/
@@ -372,6 +494,18 @@ src/
     └── ui/
 
 tests/
+├── commands/
+├── config/
+├── git/
+├── github/
+├── integration/
+├── models/
+├── parsers/
+├── prompts/
+├── providers/
+├── services/
+├── storage/
+└── ui/
 
 docs/
 ```
@@ -390,10 +524,6 @@ Additional project documentation is available within the repository.
 | `docs/changelog.md` | Project changes and milestones |
 | `docs/adrs/ADR-*` | Architecture Decision Records (ADRs) |
 
-Future documentation will include:
-
-- Contributing Guide
-
 ---
 
 # Roadmap
@@ -424,6 +554,7 @@ Instead of requiring every automation tool or AI agent to implement Git workflow
 
 - Repository validation
 - Git operations
+- GitHub integration
 - AI integration
 - Workflow execution
 - Error handling
@@ -452,15 +583,11 @@ Features that fall outside these principles intentionally remain out of scope.
 
 # Contributing
 
-Contribution guidelines will be published when the project becomes publicly available.
-
-Future contributors will be encouraged to review:
+DiffSage is an open-source project and contributions are welcome.
 
-- Architecture documentation
-- Coding conventions
-- ADRs
+Before contributing, review the project architecture, coding conventions, and architectural decision records in the `docs/` directory.
 
-before submitting changes.
+Additional contribution guidelines will be documented as the project evolves.
 
 ---
 

{diffsage-1.2.0 → diffsage-1.3.0}/README.md

@@ -77,6 +77,10 @@ Current capabilities include:
 - AI provider authentication and error handling
 - Layered architecture
 - Comprehensive automated test suite
+- Add AI-assisted PR generation
+- Interactive PR draft review/edit/regeneration
+- GitHub PR creation
+- Branch synchronization validation
 
 ---
 
@@ -111,18 +115,38 @@ Its scope is intentionally focused on improving Git workflows.
 
 # Project Status
 
-> **Current Stage:** Active Development
+> **Current Stage:** Alpha
 
-DiffSage is currently under active development.
+DiffSage is an actively developed open-source project.
 
-The project is being developed privately while the core architecture, documentation, and workflow foundation are finalized.
+The project is published on PyPI and distributed as a Python package for
+developers, automation, and AI agents.
 
-The long-term goal is to open source the project once it reaches a stable and well-documented foundation.
+The current focus is on expanding Git workflow capabilities while maintaining
+a stable architecture, clear documentation, reliable automation, and strong
+engineering practices.
 
 ---
 
 # Installation
 
+## User Installation
+
+DiffSage is published on PyPI and can be installed using `pipx`.
+
+DiffSage currently requires Python 3.12.
+
+```bash
+pipx install diffsage
+```
+
+After installation verify the environment
+```bash
+diffsage doctor
+```
+
+## Developer Installation
+
 Clone the repository:
 
 ```bash
@@ -153,9 +177,29 @@ Windows
 Install the project:
 
 ```bash
-pip install -e ".[dev]"
+python -m pip install -e ".[dev]"
+```
+
+---
+
+# Releases
+
+DiffSage releases are published through GitHub Releases and distributed through PyPI.
+
+Released package versions can be installed directly with:
+
+```bash
+pipx install diffsage
+```
+
+A specific version can be installed with:
+
+```bash
+pipx install diffsage==1.2.0
 ```
 
+Release builds and PyPI publishing are automated through GitHub Actions.
+
 ---
 
 # Configuration
@@ -164,17 +208,18 @@ DiffSage supports layered configuration through global and repository-local TOML
 
 Application configuration controls how DiffSage behaves and can be managed through global, repository-local, and environment-based configuration.
 
-Provider credentials are managed separately from application configuration. 
 Provider credentials are managed separately from application configuration and are not part of the Settings configuration model.
 
 ```env
 DIFFSAGE_PROVIDER=gemini
-DIFFSAGE_AI_MODEL=gemini-3.5-flash-lite
+DIFFSAGE_AI_MODEL=<provider-supported-model>
 DIFFSAGE_LOG_LEVEL=INFO
 DIFFSAGE_TIMEOUT=60
 DIFFSAGE_MAX_RETRIES=3
 ```
 
+The configured model must be supported by the selected AI provider.
+
 Configuration can also be managed directly from the CLI:
 
 ```bash
@@ -233,10 +278,38 @@ Display AI suggestion
 [N] Cancel
 ```
 
+```bash
+diffsage pr 
+```
+
+PR workflow
+
+```text
+Generate PR draft
+       │
+       ▼
+Show base/head branches
+       │
+       ▼
+Display PR draft
+       │
+ ┌─────┼───────────┐
+ ▼     ▼           ▼
+Edit Regenerate   Cancel
+       │
+       ▼
+    Accept
+       │
+       ▼
+Create GitHub PR
+       │
+       ▼
+Display PR URL
+```
+
 Named credential profiles are also supported:
 
 ```bash
-
 diffsage auth set gemini YOUR_API_KEY --name paid
 ```
 
@@ -261,6 +334,8 @@ diffsage auth unset gemini
 |----------|-------------|
 | `diffsage doctor` | Validate the local DiffSage environment |
 | `diffsage commit` | Generate and manage AI-assisted commit messages |
+| `diffsage pr` | Generate, review, and create a GitHub pull request |
+| `diffsage pr <base-branch>` | Generate and create a pull request against a specific base branch |
 | `diffsage config list` | Display the current DiffSage configuration |
 | `diffsage config get` | Display the value of a configuration setting |
 | `diffsage config set` | Update a configuration setting |
@@ -271,7 +346,46 @@ diffsage auth unset gemini
 | `diffsage auth unset` | Remove a provider credential |
 | `diffsage ask` | Ask the configured AI provider a question |
 
-More commands will be introduced as the project evolves.
+---
+
+## Pull Request Workflow
+
+The `diffsage pr` command analyzes the current Git branch against a resolved base branch and generates a structured pull request draft.
+
+The workflow is interactive:
+
+```text
+Analyze Git repository
+        │
+        ▼
+Resolve base branch
+        │
+        ▼
+Generate PR draft
+        │
+        ▼
+Display base/head branches
+        │
+        ▼
+Review PR draft
+        │
+ ┌──────┼──────────────┐
+ ▼      ▼              ▼
+Edit  Regenerate      Cancel
+ │      │
+ └──────┴───────┐
+                ▼
+             Accept
+                │
+                ▼
+        Validate GitHub access
+                │
+                ▼
+        Create GitHub pull request
+                │
+                ▼
+        Display pull request URL
+```
 
 ---
 
@@ -289,15 +403,22 @@ Commands
 │
 ├── Authentication
 │
-▼
-Services
-│
-├── Git
-├── AI
-├── Prompt Generation
-└── Credentials
+├── Commit Workflow
 │
-▼
+└── Pull Request Workflow
+        │
+        ▼
+    Services
+        │
+        ├── Git
+        ├── GitHub
+        ├── AI
+        ├── Prompt Generation
+        ├── Pull Request Analysis
+        ├── Pull Request Parsing
+        └── Credentials
+        │
+        ▼
 Providers / Storage
 ```
 
@@ -323,6 +444,7 @@ src/
     ├── config/
     ├── exceptions/
     ├── git/
+    ├── github/
     ├── logging/
     ├── models/
     ├── parsers/
@@ -333,6 +455,18 @@ src/
     └── ui/
 
 tests/
+├── commands/
+├── config/
+├── git/
+├── github/
+├── integration/
+├── models/
+├── parsers/
+├── prompts/
+├── providers/
+├── services/
+├── storage/
+└── ui/
 
 docs/
 ```
@@ -351,10 +485,6 @@ Additional project documentation is available within the repository.
 | `docs/changelog.md` | Project changes and milestones |
 | `docs/adrs/ADR-*` | Architecture Decision Records (ADRs) |
 
-Future documentation will include:
-
-- Contributing Guide
-
 ---
 
 # Roadmap
@@ -385,6 +515,7 @@ Instead of requiring every automation tool or AI agent to implement Git workflow
 
 - Repository validation
 - Git operations
+- GitHub integration
 - AI integration
 - Workflow execution
 - Error handling
@@ -413,15 +544,11 @@ Features that fall outside these principles intentionally remain out of scope.
 
 # Contributing
 
-Contribution guidelines will be published when the project becomes publicly available.
-
-Future contributors will be encouraged to review:
+DiffSage is an open-source project and contributions are welcome.
 
-- Architecture documentation
-- Coding conventions
-- ADRs
+Before contributing, review the project architecture, coding conventions, and architectural decision records in the `docs/` directory.
 
-before submitting changes.
+Additional contribution guidelines will be documented as the project evolves.
 
 ---
 

{diffsage-1.2.0 → diffsage-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "diffsage"
-version = "1.2.0"
+version = "1.3.0"
 description = "AI-powered Git workflow assistant"
 readme = "README.md"
 requires-python = ">=3.12,<3.13"

{diffsage-1.2.0 → diffsage-1.3.0}/src/diffsage/cli.py

@@ -7,6 +7,7 @@ from diffsage.commands.auth import app as auth_app
 from diffsage.commands.commit import commit
 from diffsage.commands.config import app as config_app
 from diffsage.commands.doctor import doctor
+from diffsage.commands.pr import pr
 from diffsage.config.loader import load_settings
 from diffsage.logging.logger import configure_logging
 
@@ -31,8 +32,13 @@ def main() -> None:
 app.command()(doctor)
 app.command()(ask)
 app.command()(commit)
+app.command()(pr)
+
 app.add_typer(
     config_app,
     name="config",
 )
-app.add_typer(auth_app, name="auth")
+app.add_typer(
+    auth_app,
+    name="auth",
+)

{diffsage-1.2.0 → diffsage-1.3.0}/src/diffsage/commands/ask.py

@@ -4,6 +4,7 @@ from diffsage.exceptions import (
     AuthenticationError,
     ConfigError,
     CredentialNotFoundError,
+    ModelNotFoundError,
     ProviderUnavailableError,
 )
 from diffsage.logging.logger import get_logger
@@ -46,6 +47,11 @@ def ask(prompt: str) -> None:
         view.show_error(str(e))
         raise SystemExit(1) from None
 
+    except ModelNotFoundError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
     except ProviderUnavailableError as e:
         logger.warning(str(e))
         view.show_error(str(e))

{diffsage-1.2.0 → diffsage-1.3.0}/src/diffsage/commands/commit.py

@@ -1,3 +1,5 @@
+from collections.abc import Callable
+
 from diffsage.config.loader import load_settings
 from diffsage.config.paths import get_credentials_path
 from diffsage.exceptions import (
@@ -22,8 +24,13 @@ from diffsage.ui.commit_view import CommitView
 logger = get_logger(__name__)
 
 
-def generate_message(commit_service: CommitService) -> str:
-    return commit_service.generate_commit_message()
+def generate_message(
+    commit_service: CommitService,
+    on_attempt: Callable[[int, int], None] | None = None,
+) -> str:
+    return commit_service.generate_commit_message(
+        on_attempt=on_attempt,
+    )
 
 
 def commit() -> None:
@@ -54,8 +61,13 @@ def commit() -> None:
             ai_service,
         )
 
-        with view.generating():
-            raw_message = generate_message(commit_service)
+        with view.generating() as status:
+            raw_message = generate_message(
+                commit_service,
+                on_attempt=lambda attempt, total: status.update(
+                    f"Generating commit message... Attempt {attempt}/{total}"
+                ),
+            )
             commit_message = CommitMessageParser.parse(raw_message)
 
         view.show_generated()
@@ -79,8 +91,13 @@ def commit() -> None:
 
             if choice == "r":
                 logger.info("User selected regenerate.")
-                with view.generating():
-                    raw_message = generate_message(commit_service)
+                with view.generating() as status:
+                    raw_message = generate_message(
+                        commit_service,
+                        on_attempt=lambda attempt, total: status.update(
+                            f"Generating commit message... Attempt {attempt}/{total}"
+                        ),
+                    )
                     commit_message = CommitMessageParser.parse(raw_message)
 
                 view.show_generated()