imp-git 0.0.26__tar.gz

imp_git-0.0.26/.gitignore

@@ -0,0 +1,11 @@
+*.egg-info/
+*.pyc
+*.swp
+*.swo
+*~
+.DS_Store
+.pytest_cache/
+.ruff_cache/
+.venv/
+__pycache__/
+dist/

imp_git-0.0.26/CHANGELOG.md

@@ -0,0 +1,165 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+
+## [0.0.24] - 2026-03-26
+
+### Added
+- Add push command
+
+## [0.0.23] - 2026-03-26
+
+### Added
+- Set commit dates from file modification times
+
+## [0.0.22] - 2026-03-24
+
+### Changed
+- Restructure readme and remove table of contents
+
+## [0.0.21] - 2026-03-24
+
+### Changed
+- Implement dynamic vcs-based versioning with hatch-vcs
+
+## [0.0.20] - 2026-03-24
+
+### Added
+- Add resolve command for ai-assisted conflict resolution
+
+## [0.0.19] - 2026-03-24
+
+### Changed
+- Refactor workflows section
+
+## [0.0.18] - 2026-03-24
+
+### Added
+- Add interactive config management
+
+## [0.0.17] - 2026-03-23
+
+### Changed
+- Rewrite why section to emphasize opinionated approach
+
+## [0.0.16] - 2026-03-23
+
+### Added
+- Warn when releasing from non-base branch
+
+## [0.0.15] - 2026-03-21
+
+### Fixed
+- Replace broad exception handling with specific types
+
+## [0.0.14] - 2026-03-20
+
+### Added
+- Add ship command for one-shot commit and release
+
+## [0.0.13] - 2026-03-20
+
+### Added
+- Add whisper option to AI commands
+
+## [0.0.12] - 2026-03-20
+
+### Added
+- Overhaul done to merge locally and delete branch
+
+### Changed
+- Expand command docstrings with behavior descriptions
+- Replace git edit flag with interactive console.edit
+
+### Fixed
+- Include exception details in error messages
+- Parse status file paths with lstrip instead of fixed index
+
+## [0.0.11] - 2026-03-15
+
+### Added
+- Add __main__ entry point and dynamic version from metadata
+
+### Changed
+- Use builtin print instead of console.out.print
+- Update install instructions for python package
+- Add ai tests, command tests, and update imports
+- Move sanitize to ai module and add truncate helper
+- Remove deprecated bash scripts and bin wrapper
+- Sync (alias).
+- Rewrite in python
+
+### Fixed
+- Rename range to rev_range, add git timeout, fix split paths
+
+## [0.0.10] - 2026-02-26
+
+- Added: add split, done, clean commands and branch switching
+- Changed: normalize output to use item helper
+- Changed: remove stash, diff, describe, and init commands
+- Fixed: improve reliability and ux across commands
+
+## [0.0.9] - 2026-02-24
+
+- Changed: Pipe AI prompts via stdin instead of passing as shell arguments, removing argument size limits
+- Changed: Increase Claude request timeout from 60s to 120s
+- Added: `--tools ""` flag to Claude CLI calls to disable tool use
+- Changed: Ollama prompt now piped through `jq -Rs` and `curl -d @-` instead of inline JSON argument
+- Fixed: Changelog file path now resolved relative to repo root instead of current working directory
+- Changed: `prompt_changelog` now receives full diff as primary input alongside commit log
+- Changed: Changelog prompt format changed from Keep a Changelog sections to flat prefixed lines (`Added:`, `Changed:`, `Fixed:`, `Removed:`)
+- Changed: `prompt_commit` now counts and reports number of changed files in the prompt
+- Changed: Commit message rules updated to require prose body (semicolon-separated) instead of bullet points, with example included
+- Changed: Release squash now stages all changes with `git add -A` instead of only staging the changelog file
+- Added: Integration test verifying release creates a tag and includes changelog in the commit
+- Added: Integration test verifying release squashes multiple commits into one since the last tag
+- Removed: Directory structure section from README
+- Changed: README description, examples, and command reference updated for clarity
+
+## [0.0.8] - 2026-02-21
+
+### Changed
+- Consolidated v0.0.5 changes into main development branch
+
+## [0.0.7] - 2026-02-21
+
+### Changed
+- Release process no longer pushes unrelated tags
+
+## [0.0.6] - 2026-02-21
+
+### Changed
+- Simplified version calculation and fallback logic
+
+## [0.0.5] - 2026-02-21
+
+### Added
+- Gum spinners for improved UX during operations
+
+### Changed
+- Command names aligned with actual behavior
+- Version accuracy and tag conflict prevention
+
+## [0.0.4] - 2026-02-17
+
+### Changed
+- Use `--force-with-lease` for squashed commits to preserve history integrity
+
+## [0.0.3] - 2026-02-17
+
+### Added
+- Daily workflow commands and analysis tools to the command set
+
+## [0.0.2] - 2026-02-07
+
+### Changed
+- Improved user experience with consistent output formatting and clearer hints
+
+## [0.0.1] - 2026-02-07
+
+### Added
+- AI-powered git commands functionality
+
+### Changed
+- Refactored user input prompts for improved clarity and safety

imp_git-0.0.26/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anders
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

imp_git-0.0.26/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: imp-git
+Version: 0.0.26
+Summary: AI-powered git workflow CLI
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.15.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+   <img src="logo.png" alt="imp" width="200">
+</p>
+
+<p align="center">
+   AI-powered git workflow.<br>
+   Commit, branch, review, and release without writing commit messages, branch names, or PR descriptions.
+</p>
+
+<p align="center">
+   <a href="#install">Install</a> &middot;
+   <a href="#quick-start">Quick Start</a> &middot;
+   <a href="#commands">Commands</a> &middot;
+   <a href="#configuration">Configuration</a> &middot;
+   <a href="#license">License</a>
+</p>
+
+---
+
+```bash
+imp commit -a        # stages everything, generates message, commits
+imp branch "auth"    # creates feat/user-auth
+imp review           # AI code review of your changes
+imp release          # squash, changelog, tag, push
+```
+
+## Why
+
+AI agents can run git for you, but they improvise every time. Imp is opinionated: same format, same workflow, same result, every time.
+
+- **Consistent commits** across your whole team, validated against [Conventional Commits](https://www.conventionalcommits.org/) before anything touches git
+- **One-command releases** that squash, changelog, tag, and push with automatic rollback on failure
+- **Fast and deterministic.** One command, not a conversation. No reasoning, no retries, no surprises.
+- **AI writes the words, Imp controls the workflow.** What gets staged, how it's validated, when it's safe to push.
+- **Works offline** with local models via Ollama. No API key required.
+
+## Install
+
+```bash
+uv tool install git+https://github.com/anders458/imp.git
+```
+
+Or with pip:
+
+```bash
+pip install git+https://github.com/anders458/imp.git
+```
+
+Then set up your AI provider and verify:
+
+```bash
+imp config
+imp doctor
+```
+
+## Quick Start
+
+```bash
+# Make some changes, then commit with an AI message
+imp commit -a
+# -> "feat: add rate limiting to API endpoints"
+# -> Use this message? [Yes / Edit / No]
+
+# Branch from a description
+imp branch "add user authentication"
+# -> Suggested: feat/user-auth
+# -> Create branch? [Yes / No]
+
+# Branch from a GitHub issue
+imp fix 42
+# -> Fetches issue, suggests fix/login-redirect-42
+
+# Ship a release
+imp release
+# -> Version bump: patch / minor / major
+# -> Generates changelog, squashes, tags, pushes
+```
+
+## Commands
+
+### Daily Workflow
+
+| Command | Description |
+|---|---|
+| `imp commit [-a]` | Generate commit message from diff. `-a` stages all. |
+| `imp amend` | Rewrite last commit message from the full diff. |
+| `imp undo [N]` | Undo last N commits, keep changes staged. |
+| `imp revert [hash]` | Safely revert a pushed commit. |
+| `imp push` | Push commits to origin. Sets upstream on first push. |
+| `imp sync` | Pull, rebase, push in one step. |
+| `imp resolve` | AI-assisted merge conflict resolution. |
+
+### Branching
+
+| Command | Description |
+|---|---|
+| `imp branch <desc>` | Create branch from plain English description. |
+| `imp branch` | Interactive branch switcher. |
+| `imp fix <issue>` | Create branch from GitHub issue number. |
+| `imp pr` | Create pull request with AI title and body. |
+| `imp done [target]` | Merge feature branch, clean up local and remote. |
+
+### Analysis
+
+| Command | Description |
+|---|---|
+| `imp review` | AI code review of staged or unstaged changes. |
+| `imp split` | Group dirty files into logical commits via AI. |
+| `imp status` | Repo overview: branch, changes, sync state. |
+| `imp log [-n N]` | Pretty commit graph. |
+
+### Release
+
+| Command | Description |
+|---|---|
+| `imp release` | Squash commits, generate changelog, tag, push, create GitHub release. |
+| `imp ship [level]` | Commit all + release in one shot, no prompts. Default: patch. |
+
+### Setup
+
+| Command | Description |
+|---|---|
+| `imp config` | Interactive AI provider and model setup. |
+| `imp doctor` | Verify tools, config, and AI connection. |
+| `imp clean` | Delete merged branches (local and remote). |
+| `imp help` | Show workflow guide and commit format reference. |
+
+Any AI command accepts `--whisper` / `-w` to hint the AI without overriding its rules:
+
+```bash
+imp commit -a -w "use IMP-42 as ticket"
+imp review -w "focus on error handling"
+```
+
+## Workflows
+
+| Flow | Steps |
+|---|---|
+| **Solo** | `commit -a` → `push` → `release` |
+| **Feature branch** | `branch` → `commit -a` → `pr` → `done` |
+| **Hotfix** | `fix 42` → `commit -a` → `pr` → `done` |
+| **Merge conflict** | `sync` or `done` → `resolve` → continue |
+
+## Commit Format
+
+Imp generates [Conventional Commits](https://www.conventionalcommits.org/) messages, validated before use.
+
+```
+type: message              feat, fix, refactor, build, chore,
+type(scope): message       docs, test, style, perf, ci
+type!: message             (breaking change)
+```
+
+All lowercase after the colon (except ticket IDs). Imperative mood. Max 72 chars, no period. Tickets after the colon: `fix: IMP-42 resolve timeout`. Scopes optional: `refactor(auth): simplify flow`.
+
+## Configuration
+
+```bash
+imp config
+```
+
+Interactive menu to set your AI provider and models. Stored in `~/.config/imp/config.json`.
+
+| Setting | Default | Description |
+|---|---|---|
+| `provider` | `claude` | AI provider: `claude` or `ollama` |
+| `model:fast` | `haiku` | Model for quick tasks (commit, branch) |
+| `model:smart` | `sonnet` | Model for complex tasks (review, PR, split) |
+
+Environment variables (`IMP_AI_PROVIDER`, `IMP_AI_MODEL_FAST`, `IMP_AI_MODEL_SMART`) override the config file when set, useful for CI.
+
+## Requirements
+
+- Python 3.10+
+- git
+- [gh](https://cli.github.com) (optional, for `imp fix`, `imp pr`, `imp release`)
+
+### Claude Code (default)
+
+Imp uses [Claude Code](https://docs.anthropic.com/en/docs/claude-code) as its default AI provider. You need an active Claude Code subscription.
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+claude          # authenticate
+imp doctor      # verify
+```
+
+### Ollama (local, free)
+
+For fully offline usage with no API key:
+
+```bash
+# Install from https://ollama.com, then:
+ollama pull llama3.2
+imp config      # select ollama and your models
+imp doctor      # verify
+```
+
+## Development
+
+```bash
+git clone https://github.com/anders458/imp.git
+cd imp
+pip install -e ".[dev]"
+pytest -v
+ruff check src/ tests/
+```
+
+## License
+
+[MIT](LICENSE)

imp_git-0.0.26/README.md

@@ -0,0 +1,211 @@
+<p align="center">
+   <img src="logo.png" alt="imp" width="200">
+</p>
+
+<p align="center">
+   AI-powered git workflow.<br>
+   Commit, branch, review, and release without writing commit messages, branch names, or PR descriptions.
+</p>
+
+<p align="center">
+   <a href="#install">Install</a> &middot;
+   <a href="#quick-start">Quick Start</a> &middot;
+   <a href="#commands">Commands</a> &middot;
+   <a href="#configuration">Configuration</a> &middot;
+   <a href="#license">License</a>
+</p>
+
+---
+
+```bash
+imp commit -a        # stages everything, generates message, commits
+imp branch "auth"    # creates feat/user-auth
+imp review           # AI code review of your changes
+imp release          # squash, changelog, tag, push
+```
+
+## Why
+
+AI agents can run git for you, but they improvise every time. Imp is opinionated: same format, same workflow, same result, every time.
+
+- **Consistent commits** across your whole team, validated against [Conventional Commits](https://www.conventionalcommits.org/) before anything touches git
+- **One-command releases** that squash, changelog, tag, and push with automatic rollback on failure
+- **Fast and deterministic.** One command, not a conversation. No reasoning, no retries, no surprises.
+- **AI writes the words, Imp controls the workflow.** What gets staged, how it's validated, when it's safe to push.
+- **Works offline** with local models via Ollama. No API key required.
+
+## Install
+
+```bash
+uv tool install git+https://github.com/anders458/imp.git
+```
+
+Or with pip:
+
+```bash
+pip install git+https://github.com/anders458/imp.git
+```
+
+Then set up your AI provider and verify:
+
+```bash
+imp config
+imp doctor
+```
+
+## Quick Start
+
+```bash
+# Make some changes, then commit with an AI message
+imp commit -a
+# -> "feat: add rate limiting to API endpoints"
+# -> Use this message? [Yes / Edit / No]
+
+# Branch from a description
+imp branch "add user authentication"
+# -> Suggested: feat/user-auth
+# -> Create branch? [Yes / No]
+
+# Branch from a GitHub issue
+imp fix 42
+# -> Fetches issue, suggests fix/login-redirect-42
+
+# Ship a release
+imp release
+# -> Version bump: patch / minor / major
+# -> Generates changelog, squashes, tags, pushes
+```
+
+## Commands
+
+### Daily Workflow
+
+| Command | Description |
+|---|---|
+| `imp commit [-a]` | Generate commit message from diff. `-a` stages all. |
+| `imp amend` | Rewrite last commit message from the full diff. |
+| `imp undo [N]` | Undo last N commits, keep changes staged. |
+| `imp revert [hash]` | Safely revert a pushed commit. |
+| `imp push` | Push commits to origin. Sets upstream on first push. |
+| `imp sync` | Pull, rebase, push in one step. |
+| `imp resolve` | AI-assisted merge conflict resolution. |
+
+### Branching
+
+| Command | Description |
+|---|---|
+| `imp branch <desc>` | Create branch from plain English description. |
+| `imp branch` | Interactive branch switcher. |
+| `imp fix <issue>` | Create branch from GitHub issue number. |
+| `imp pr` | Create pull request with AI title and body. |
+| `imp done [target]` | Merge feature branch, clean up local and remote. |
+
+### Analysis
+
+| Command | Description |
+|---|---|
+| `imp review` | AI code review of staged or unstaged changes. |
+| `imp split` | Group dirty files into logical commits via AI. |
+| `imp status` | Repo overview: branch, changes, sync state. |
+| `imp log [-n N]` | Pretty commit graph. |
+
+### Release
+
+| Command | Description |
+|---|---|
+| `imp release` | Squash commits, generate changelog, tag, push, create GitHub release. |
+| `imp ship [level]` | Commit all + release in one shot, no prompts. Default: patch. |
+
+### Setup
+
+| Command | Description |
+|---|---|
+| `imp config` | Interactive AI provider and model setup. |
+| `imp doctor` | Verify tools, config, and AI connection. |
+| `imp clean` | Delete merged branches (local and remote). |
+| `imp help` | Show workflow guide and commit format reference. |
+
+Any AI command accepts `--whisper` / `-w` to hint the AI without overriding its rules:
+
+```bash
+imp commit -a -w "use IMP-42 as ticket"
+imp review -w "focus on error handling"
+```
+
+## Workflows
+
+| Flow | Steps |
+|---|---|
+| **Solo** | `commit -a` → `push` → `release` |
+| **Feature branch** | `branch` → `commit -a` → `pr` → `done` |
+| **Hotfix** | `fix 42` → `commit -a` → `pr` → `done` |
+| **Merge conflict** | `sync` or `done` → `resolve` → continue |
+
+## Commit Format
+
+Imp generates [Conventional Commits](https://www.conventionalcommits.org/) messages, validated before use.
+
+```
+type: message              feat, fix, refactor, build, chore,
+type(scope): message       docs, test, style, perf, ci
+type!: message             (breaking change)
+```
+
+All lowercase after the colon (except ticket IDs). Imperative mood. Max 72 chars, no period. Tickets after the colon: `fix: IMP-42 resolve timeout`. Scopes optional: `refactor(auth): simplify flow`.
+
+## Configuration
+
+```bash
+imp config
+```
+
+Interactive menu to set your AI provider and models. Stored in `~/.config/imp/config.json`.
+
+| Setting | Default | Description |
+|---|---|---|
+| `provider` | `claude` | AI provider: `claude` or `ollama` |
+| `model:fast` | `haiku` | Model for quick tasks (commit, branch) |
+| `model:smart` | `sonnet` | Model for complex tasks (review, PR, split) |
+
+Environment variables (`IMP_AI_PROVIDER`, `IMP_AI_MODEL_FAST`, `IMP_AI_MODEL_SMART`) override the config file when set, useful for CI.
+
+## Requirements
+
+- Python 3.10+
+- git
+- [gh](https://cli.github.com) (optional, for `imp fix`, `imp pr`, `imp release`)
+
+### Claude Code (default)
+
+Imp uses [Claude Code](https://docs.anthropic.com/en/docs/claude-code) as its default AI provider. You need an active Claude Code subscription.
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+claude          # authenticate
+imp doctor      # verify
+```
+
+### Ollama (local, free)
+
+For fully offline usage with no API key:
+
+```bash
+# Install from https://ollama.com, then:
+ollama pull llama3.2
+imp config      # select ollama and your models
+imp doctor      # verify
+```
+
+## Development
+
+```bash
+git clone https://github.com/anders458/imp.git
+cd imp
+pip install -e ".[dev]"
+pytest -v
+ruff check src/ tests/
+```
+
+## License
+
+[MIT](LICENSE)