BetterGit v1.0.0

Fresh start: readable codebase, unified UX, contributor-ready
foundation.

---

Highlights

• Rebuilt the core Git bridge: single GitError, BranchInfo
  dataclass, tidy wrappers (add, create_branch, push, etc.) and
  ASCII-safe output.
• Every CLI command now shares a consistent structure---common
  helpers, unified messages, and proper error handling (bg add,
  bg suggest, bg commit, bg push, bg delete-branch, ...).
• Brand-new bg --help: ASCII banner, categorized quick reference,
  working --version.
• Shared utilities (resolve_config, show_success/show_error,
  echo_boxed) replace one-off snippets; stray Unicode artifacts are
  gone.
• LLM pipeline hardened: typed responses from Ollama, filtered file
  lists, graceful fallback when the provider is offline.
• Documentation overhaul: concise English README plus an expanded
  docs/USER_GUIDE.md covering installation,
  Ollama setup, command usage, workflows, and troubleshooting.

---

What's inside

Core

• bettergit/core/gitio.py rewritten from
  scratch with a clean API and reusable helpers.
• classify.py and template.py
  simplified, ASCII-only and easy to follow.

CLI

• Commands now rely on common helpers for config resolution, diff
  checks, and status reporting.
• bg delete-branch prompts for remote cleanup (or skips with flags)
  and reports actions uniformly.
• bg push / bg push-to keep upstream logic in sync and set -u
  automatically on the first push.

LLM

• OllamaClient and
  pipeline.generate_commit include proper
  typing, filtering, and fallback logging if the service is
  unavailable.

Docs

• README file.
• docs/USER_GUIDE.md expanded with Ollama
  installation steps, command cheat sheet, end-to-end workflows,
  configuration notes, and troubleshooting tips.

---

Install / Upgrade

pip install --upgrade git+https://github.com/xAikq/bettergit.git@v1.0.0

For local development:

git clone https://github.com/xAikq/bettergit.git
cd bettergit
python -m venv venv
source venv/bin/activate   # or venv\Scripts\activate on Windows
pip install -e .

---

Thanks to everyone who tested and provided feedback. BetterGit is now
ready for contributors and future releases!