devcommit 0.1.5.0__tar.gz → 0.1.5.2__tar.gz

{devcommit-0.1.5.0 → devcommit-0.1.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devcommit
-Version: 0.1.5.0
+Version: 0.1.5.2
 Summary: AI-powered git commit message generator
 License: GNU GENERAL PUBLIC LICENSE
                                 Version 3, 29 June 2007
@@ -711,6 +711,7 @@ A command-line AI tool for autocommits.
 
 - 🤖 **Multi-AI Provider Support** - Choose from Gemini, Groq, OpenAI, Claude, Ollama, or custom APIs
 - 🚀 Automatic commit generation using AI
+- 📝 **Changelog Generation** - Automatically generate markdown changelogs from your changes
 - 📁 Directory-based commits - create separate commits for each root directory
 - 🎯 Interactive mode to choose between global or directory-based commits
 - 📄 **Commit specific files or folders** - Stage and commit only selected files/directories
@@ -1115,6 +1116,47 @@ Selecting "Regenerate commit messages" will:
 
 This works for all commit modes (global, directory, and per-file commits).
 
+### Changelog Generation
+
+DevCommit can automatically generate markdown changelog files from your changes using AI.
+
+**Usage:**
+
+```bash
+# Generate changelog after committing
+devcommit --changelog
+
+# Generate changelog before staging (recommended)
+devcommit --stageAll --changelog
+
+# Short form
+devcommit -s -c
+
+# With specific files
+devcommit --stageAll --changelog --files src/
+```
+
+**How it works:**
+
+- **With `--stageAll`**: Changelog is generated from unstaged changes **before** staging
+- **Without `--stageAll`**: Changelog is generated from the last commit **after** committing
+- Changelogs are saved as markdown files with datetime-based names (e.g., `2026-01-28_00-55-30.md`)
+- Default directory: `changelogs/` (configurable via `CHANGELOG_DIR` in `.dcommit`)
+- Uses Keep a Changelog format with AI-generated content
+
+**Example workflow:**
+
+```bash
+# Make changes to your code
+# ...
+
+# Stage all changes and generate changelog before committing
+devcommit --stageAll --changelog
+
+# The changelog file is created in changelogs/ directory
+# Then changes are staged and committed
+```
+
 ### Additional Options
 
 - `--excludeFiles` or `-e`: Exclude specific files from the diff
@@ -1124,6 +1166,7 @@ This works for all commit modes (global, directory, and per-file commits).
 - `--directory` or `-d`: Force directory-based commits
 - `--files` or `-f`: Stage and commit specific files or folders (can specify multiple)
 - `--push` or `-p`: Push commits to remote after committing
+- `--changelog` or `-c`: Generate changelog file from changes
 
 ### Examples
 
@@ -1157,6 +1200,15 @@ devcommit -s -f src/core src/modules/account/ --directory
 
 # Stage and commit, then push
 devcommit -s -f src/core src/modules/account/ -p
+
+# Generate changelog before staging and committing
+devcommit --stageAll --changelog
+
+# Generate changelog after committing
+devcommit --changelog
+
+# Generate changelog with specific files
+devcommit -s -c -f src/
 ```
 
 ## AI Provider Support
@@ -1188,28 +1240,19 @@ devcommit
 ```bash
 export AI_PROVIDER=openrouter
 export OPENROUTER_API_KEY='your-openrouter-api-key'
-# Optional: specify model (default: mistralai/devstral-2512:free)
-export OPENROUTER_MODEL='mistralai/devstral-2512:free'
+# Optional: specify model (default: meta-llama/llama-3.3-70b-instruct:free)
+export OPENROUTER_MODEL='meta-llama/llama-3.3-70b-instruct:free'
 devcommit
 ```
 
 **Popular free models on OpenRouter (add `:free` suffix):**
 
-**Coding & Development:**
-- `mistralai/devstral-2512:free` - Mistral's state-of-the-art coding model (123B params)
-- `kwaipilot/kat-coder-pro:free` - Advanced agentic coding model (73.4% SWE-Bench solve rate)
-- `qwen/qwen3-coder:free` - Qwen's MoE code generation model (480B params, 35B active)
-- `deepseek/deepseek-r1-0528:free` - DeepSeek R1 reasoning model (671B params, open-source)
-
-**Reasoning & General Purpose:**
-- `xiaomi/mimo-v2-flash:free` - Mixture-of-Experts model (309B params, top open-source on SWE-bench)
-- `tngtech/deepseek-r1t2-chimera:free` - DeepSeek R1T2 reasoning model (671B params)
-- `tngtech/deepseek-r1t-chimera:free` - DeepSeek R1T reasoning model
-- `tngtech/tng-r1t-chimera:free` - Creative storytelling and character interaction model
-
-**Lightweight & Fast:**
-- `z-ai/glm-4.5-air:free` - GLM 4.5 Air lightweight variant (MoE architecture)
-- `nvidia/nemotron-3-nano-30b-a3b:free` - NVIDIA's efficient small model (30B params, 3B active)
+**Recommended Models:**
+- `meta-llama/llama-3.3-70b-instruct:free` - Llama 3.3 70B Instruct (Powerful & General Purpose)
+- `google/gemma-3-27b-it:free` - Google Gemma 3 27B Instruct (Efficient & Capable)
+- `openai/gpt-oss-120b:free` - OpenAI GPT-OSS 120B (Large & Experimental)
+- `tngtech/deepseek-r1t-chimera:free` - DeepSeek R1T Chimera (Strong Reasoning)
+- `qwen/qwen3-next-80b-a3b-instruct:free` - Qwen3 Next 80B (Advanced Instruction Following)
 
 **Important Notes:**
 - **Logging Requirements:** Some free models may log your prompts and responses for model improvement purposes. This means:
@@ -1274,7 +1317,7 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `OPENROUTER_API_KEY` | OpenRouter API key ([Get it here](https://openrouter.ai/keys)) | - |
-| `OPENROUTER_MODEL` | Model name (add `:free` suffix for free models) | `mistralai/devstral-2512:free` |
+| `OPENROUTER_MODEL` | Model name (add `:free` suffix for free models) | `meta-llama/llama-3.3-70b-instruct:free` |
 
 **Anthropic:**
 | Variable | Description | Default |
@@ -1305,6 +1348,7 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 | `COMMIT_MODE`   | Default commit strategy              | `auto`                                                 | `auto`, `directory`, `global`, `related` |
 | `EXCLUDE_FILES` | Files to exclude from diff           | `package-lock.json, pnpm-lock.yaml, yarn.lock, *.lock` | Comma-separated file patterns            |
 | `MAX_TOKENS`    | Maximum tokens for AI response       | `8192`                                                 | Any positive integer                     |
+| `CHANGELOG_DIR` | Directory for changelog files        | `changelogs`                                           | Any directory path                       |
 
 ### Configuration Priority
 

{devcommit-0.1.5.0 → devcommit-0.1.5.2}/README.md

@@ -6,6 +6,7 @@ A command-line AI tool for autocommits.
 
 - 🤖 **Multi-AI Provider Support** - Choose from Gemini, Groq, OpenAI, Claude, Ollama, or custom APIs
 - 🚀 Automatic commit generation using AI
+- 📝 **Changelog Generation** - Automatically generate markdown changelogs from your changes
 - 📁 Directory-based commits - create separate commits for each root directory
 - 🎯 Interactive mode to choose between global or directory-based commits
 - 📄 **Commit specific files or folders** - Stage and commit only selected files/directories
@@ -410,6 +411,47 @@ Selecting "Regenerate commit messages" will:
 
 This works for all commit modes (global, directory, and per-file commits).
 
+### Changelog Generation
+
+DevCommit can automatically generate markdown changelog files from your changes using AI.
+
+**Usage:**
+
+```bash
+# Generate changelog after committing
+devcommit --changelog
+
+# Generate changelog before staging (recommended)
+devcommit --stageAll --changelog
+
+# Short form
+devcommit -s -c
+
+# With specific files
+devcommit --stageAll --changelog --files src/
+```
+
+**How it works:**
+
+- **With `--stageAll`**: Changelog is generated from unstaged changes **before** staging
+- **Without `--stageAll`**: Changelog is generated from the last commit **after** committing
+- Changelogs are saved as markdown files with datetime-based names (e.g., `2026-01-28_00-55-30.md`)
+- Default directory: `changelogs/` (configurable via `CHANGELOG_DIR` in `.dcommit`)
+- Uses Keep a Changelog format with AI-generated content
+
+**Example workflow:**
+
+```bash
+# Make changes to your code
+# ...
+
+# Stage all changes and generate changelog before committing
+devcommit --stageAll --changelog
+
+# The changelog file is created in changelogs/ directory
+# Then changes are staged and committed
+```
+
 ### Additional Options
 
 - `--excludeFiles` or `-e`: Exclude specific files from the diff
@@ -419,6 +461,7 @@ This works for all commit modes (global, directory, and per-file commits).
 - `--directory` or `-d`: Force directory-based commits
 - `--files` or `-f`: Stage and commit specific files or folders (can specify multiple)
 - `--push` or `-p`: Push commits to remote after committing
+- `--changelog` or `-c`: Generate changelog file from changes
 
 ### Examples
 
@@ -452,6 +495,15 @@ devcommit -s -f src/core src/modules/account/ --directory
 
 # Stage and commit, then push
 devcommit -s -f src/core src/modules/account/ -p
+
+# Generate changelog before staging and committing
+devcommit --stageAll --changelog
+
+# Generate changelog after committing
+devcommit --changelog
+
+# Generate changelog with specific files
+devcommit -s -c -f src/
 ```
 
 ## AI Provider Support
@@ -483,28 +535,19 @@ devcommit
 ```bash
 export AI_PROVIDER=openrouter
 export OPENROUTER_API_KEY='your-openrouter-api-key'
-# Optional: specify model (default: mistralai/devstral-2512:free)
-export OPENROUTER_MODEL='mistralai/devstral-2512:free'
+# Optional: specify model (default: meta-llama/llama-3.3-70b-instruct:free)
+export OPENROUTER_MODEL='meta-llama/llama-3.3-70b-instruct:free'
 devcommit
 ```
 
 **Popular free models on OpenRouter (add `:free` suffix):**
 
-**Coding & Development:**
-- `mistralai/devstral-2512:free` - Mistral's state-of-the-art coding model (123B params)
-- `kwaipilot/kat-coder-pro:free` - Advanced agentic coding model (73.4% SWE-Bench solve rate)
-- `qwen/qwen3-coder:free` - Qwen's MoE code generation model (480B params, 35B active)
-- `deepseek/deepseek-r1-0528:free` - DeepSeek R1 reasoning model (671B params, open-source)
-
-**Reasoning & General Purpose:**
-- `xiaomi/mimo-v2-flash:free` - Mixture-of-Experts model (309B params, top open-source on SWE-bench)
-- `tngtech/deepseek-r1t2-chimera:free` - DeepSeek R1T2 reasoning model (671B params)
-- `tngtech/deepseek-r1t-chimera:free` - DeepSeek R1T reasoning model
-- `tngtech/tng-r1t-chimera:free` - Creative storytelling and character interaction model
-
-**Lightweight & Fast:**
-- `z-ai/glm-4.5-air:free` - GLM 4.5 Air lightweight variant (MoE architecture)
-- `nvidia/nemotron-3-nano-30b-a3b:free` - NVIDIA's efficient small model (30B params, 3B active)
+**Recommended Models:**
+- `meta-llama/llama-3.3-70b-instruct:free` - Llama 3.3 70B Instruct (Powerful & General Purpose)
+- `google/gemma-3-27b-it:free` - Google Gemma 3 27B Instruct (Efficient & Capable)
+- `openai/gpt-oss-120b:free` - OpenAI GPT-OSS 120B (Large & Experimental)
+- `tngtech/deepseek-r1t-chimera:free` - DeepSeek R1T Chimera (Strong Reasoning)
+- `qwen/qwen3-next-80b-a3b-instruct:free` - Qwen3 Next 80B (Advanced Instruction Following)
 
 **Important Notes:**
 - **Logging Requirements:** Some free models may log your prompts and responses for model improvement purposes. This means:
@@ -569,7 +612,7 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `OPENROUTER_API_KEY` | OpenRouter API key ([Get it here](https://openrouter.ai/keys)) | - |
-| `OPENROUTER_MODEL` | Model name (add `:free` suffix for free models) | `mistralai/devstral-2512:free` |
+| `OPENROUTER_MODEL` | Model name (add `:free` suffix for free models) | `meta-llama/llama-3.3-70b-instruct:free` |
 
 **Anthropic:**
 | Variable | Description | Default |
@@ -600,6 +643,7 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 | `COMMIT_MODE`   | Default commit strategy              | `auto`                                                 | `auto`, `directory`, `global`, `related` |
 | `EXCLUDE_FILES` | Files to exclude from diff           | `package-lock.json, pnpm-lock.yaml, yarn.lock, *.lock` | Comma-separated file patterns            |
 | `MAX_TOKENS`    | Maximum tokens for AI response       | `8192`                                                 | Any positive integer                     |
+| `CHANGELOG_DIR` | Directory for changelog files        | `changelogs`                                           | Any directory path                       |
 
 ### Configuration Priority
 

devcommit-0.1.5.2/devcommit/__version__.py

@@ -0,0 +1,7 @@
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("devcommit")
+except PackageNotFoundError:
+    # Fallback if package is not installed (e.g. during dev)
+    __version__ = "0.0.0-dev"