gitgotchi 0.3.1__tar.gz → 0.4.0__tar.gz

{gitgotchi-0.3.1 → gitgotchi-0.4.0}/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.4.0
+
+### New
+
+- `gitgotchi-statusline`: one line about your companion for Claude Code's status line, tmux or
+  Starship. It uses only the standard library, so it runs in about 50 ms, and prints nothing outside
+  a haunted repo. `gitgotchi statusline --setup` shows the config snippets.
+- `gitgotchi badge`: an SVG README badge with a pixel portrait of your companion and its form.
+- `gitgotchi config full|line|off [--global]`: choose how much the hook prints after each commit.
+- `gitgotchi doctor`: checks git, the hook and its Python, the database, your terminal and the
+  API key, with a fix for each problem. It never prints the key.
+- `gitgotchi card --gif`: an animated card (install `gitgotchi[gif]` for Pillow).
+
+## 0.3.2
+
+### Sharper sprites
+
+- Every form is framed bigger, so it gets about 60% more pixels in the same space.
+- Shading uses hue-shifted color ramps (cool shadows, warm highlights) lit from the upper front, with
+  soft contact shadows, so forms look round instead of striped.
+- Glossy highlights on the pumpkin, the Demon and the Poltergeist's keycaps.
+- Outlines pick up a little of the color they border, and dark inner lines separate parts that
+  overlap (arms, horns, keycaps).
+- A cleanup pass removes one-pixel spurs, notches and stray shading pixels.
+- The pumpkin's shadows are warm instead of muddy, the Demon has bigger curved horns, and the Angel
+  has feathered wings and a halo that stays in frame.
+
 ## 0.3.1
 
 ### Fixed

{gitgotchi-0.3.1 → gitgotchi-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitgotchi
-Version: 0.3.1
+Version: 0.4.0
 Summary: A 3D pixel-art Halloween spirit that haunts your git repo and reacts as you (and your AI agents) commit
 Author-email: M K Sai Srikar <Srikarmks@gmail.com>
 License-Expression: MIT
@@ -31,6 +31,8 @@ Requires-Dist: sqlalchemy>=2.0.36
 Requires-Dist: typer>=0.15.4
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: numpy>=1.24
+Provides-Extra: gif
+Requires-Dist: pillow>=10.0; extra == "gif"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0; extra == "dev"
@@ -95,10 +97,55 @@ single line instead of the full pet, so it doesn't flood the agent's context.
 gitgotchi card
 ```
 
-Saves a 1200×630 card, sized for LinkedIn and other link previews:
+Saves a 1200×630 card, sized for LinkedIn and other link previews. Add `--gif` for one where your companion
+moves (needs `pip install "gitgotchi[gif]"`).
 
 ![A sample card](https://raw.githubusercontent.com/Srikarmk/Gitgotchi/main/docs/card.png)
 
+For your README, `gitgotchi badge` saves a small SVG with your companion's portrait and form, and prints the
+Markdown to paste in. Run it again whenever your companion evolves.
+
+## 📟 In your status bar
+
+`gitgotchi-statusline` prints one line about the companion in the current repo, for example
+`👾 Boo the Poltergeist · 63% possessed · hungry`. It starts in about 50 ms and prints nothing outside a
+haunted repo, so it's safe to leave on everywhere.
+
+Claude Code: add this to `~/.claude/settings.json`
+
+```json
+"statusLine": {"type": "command", "command": "gitgotchi-statusline"}
+```
+
+tmux: add this to `~/.tmux.conf`
+
+```bash
+set -g status-right '#(cd #{pane_current_path} && gitgotchi-statusline --plain)'
+```
+
+`gitgotchi-statusline --setup` prints these snippets, plus one for Starship.
+
+## 🔕 How much the hook says
+
+```bash
+gitgotchi config line             # one line per commit in this repo
+gitgotchi config off --global     # silent everywhere
+gitgotchi config full             # the whole pet (the default)
+```
+
+It's stored in git config as `gitgotchi.output`, so a repo's setting wins over the global one. When an agent
+runs `git commit` without a terminal, the hook always keeps it to one line.
+
+## 🩺 Something not working?
+
+```bash
+gitgotchi doctor
+```
+
+Checks git, the hook and the Python it points at, the pet database, your terminal's colors and size, and
+whether stories can use Claude, with a fix for anything that's wrong. Include its output when you open an
+issue; it never shows your API key.
+
 ## 🔮 Séance
 
 ```bash
@@ -122,7 +169,11 @@ story. GitGotchi reads only `ANTHROPIC_API_KEY` from `.env` and ignores everythi
 | `gitgotchi haunt` | Live pane that reacts to every commit |
 | `gitgotchi status` | Your companion and its stats |
 | `gitgotchi seance` | Ghost stories from your repo's history |
-| `gitgotchi card` | Save a shareable PNG |
+| `gitgotchi card` | Save a shareable card (`--gif` for an animated one) |
+| `gitgotchi badge` | Save a README badge with your companion's portrait |
+| `gitgotchi-statusline` | One line for Claude Code, tmux or Starship |
+| `gitgotchi config` | How much the hook prints: `full`, `line` or `off` |
+| `gitgotchi doctor` | Check your setup and get fixes |
 | `gitgotchi evolve` | Evolution paths and progress |
 | `gitgotchi pet` | Give it some affection |
 | `gitgotchi name <name>` | Name your companion |

{gitgotchi-0.3.1 → gitgotchi-0.4.0}/README.md

@@ -54,10 +54,55 @@ single line instead of the full pet, so it doesn't flood the agent's context.
 gitgotchi card
 ```
 
-Saves a 1200×630 card, sized for LinkedIn and other link previews:
+Saves a 1200×630 card, sized for LinkedIn and other link previews. Add `--gif` for one where your companion
+moves (needs `pip install "gitgotchi[gif]"`).
 
 ![A sample card](https://raw.githubusercontent.com/Srikarmk/Gitgotchi/main/docs/card.png)
 
+For your README, `gitgotchi badge` saves a small SVG with your companion's portrait and form, and prints the
+Markdown to paste in. Run it again whenever your companion evolves.
+
+## 📟 In your status bar
+
+`gitgotchi-statusline` prints one line about the companion in the current repo, for example
+`👾 Boo the Poltergeist · 63% possessed · hungry`. It starts in about 50 ms and prints nothing outside a
+haunted repo, so it's safe to leave on everywhere.
+
+Claude Code: add this to `~/.claude/settings.json`
+
+```json
+"statusLine": {"type": "command", "command": "gitgotchi-statusline"}
+```
+
+tmux: add this to `~/.tmux.conf`
+
+```bash
+set -g status-right '#(cd #{pane_current_path} && gitgotchi-statusline --plain)'
+```
+
+`gitgotchi-statusline --setup` prints these snippets, plus one for Starship.
+
+## 🔕 How much the hook says
+
+```bash
+gitgotchi config line             # one line per commit in this repo
+gitgotchi config off --global     # silent everywhere
+gitgotchi config full             # the whole pet (the default)
+```
+
+It's stored in git config as `gitgotchi.output`, so a repo's setting wins over the global one. When an agent
+runs `git commit` without a terminal, the hook always keeps it to one line.
+
+## 🩺 Something not working?
+
+```bash
+gitgotchi doctor
+```
+
+Checks git, the hook and the Python it points at, the pet database, your terminal's colors and size, and
+whether stories can use Claude, with a fix for anything that's wrong. Include its output when you open an
+issue; it never shows your API key.
+
 ## 🔮 Séance
 
 ```bash
@@ -81,7 +126,11 @@ story. GitGotchi reads only `ANTHROPIC_API_KEY` from `.env` and ignores everythi
 | `gitgotchi haunt` | Live pane that reacts to every commit |
 | `gitgotchi status` | Your companion and its stats |
 | `gitgotchi seance` | Ghost stories from your repo's history |
-| `gitgotchi card` | Save a shareable PNG |
+| `gitgotchi card` | Save a shareable card (`--gif` for an animated one) |
+| `gitgotchi badge` | Save a README badge with your companion's portrait |
+| `gitgotchi-statusline` | One line for Claude Code, tmux or Starship |
+| `gitgotchi config` | How much the hook prints: `full`, `line` or `off` |
+| `gitgotchi doctor` | Check your setup and get fixes |
 | `gitgotchi evolve` | Evolution paths and progress |
 | `gitgotchi pet` | Give it some affection |
 | `gitgotchi name <name>` | Name your companion |

{gitgotchi-0.3.1 → gitgotchi-0.4.0}/pyproject.toml

@@ -50,6 +50,9 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
+gif = [
+    "pillow>=10.0",
+]
 dev = [
     "pytest>=8.0",
     "pytest-cov>=5.0",
@@ -60,6 +63,7 @@ dev = [
 
 [project.scripts]
 gitgotchi = "gitgotchi.cli:cli"
+gitgotchi-statusline = "gitgotchi.statusline:main"
 
 [project.urls]
 Homepage = "https://github.com/Srikarmk/Gitgotchi"

{gitgotchi-0.3.1 → gitgotchi-0.4.0}/src/gitgotchi/__init__.py

@@ -1,3 +1,3 @@
 """GitGotchi - A Halloween-inspired terminal companion for your git repository."""
 
-__version__ = "0.3.1"
+__version__ = "0.4.0"

{gitgotchi-0.3.1 → gitgotchi-0.4.0}/src/gitgotchi/cli.py

@@ -317,31 +317,64 @@ def adopt(
 
 @app.command()
 def card(
-    output: Path = typer.Option(Path("gitgotchi-card.png"), "--output", "-o", help="Where to save the PNG"),
+    output: Optional[Path] = typer.Option(None, "--output", "-o", help="Where to save it (default gitgotchi-card.png, or .gif with --gif)"),
     scale: int = typer.Option(5, help="Pixel size; 5 gives 1200x630"),
+    gif: bool = typer.Option(False, "--gif", help="Save an animated GIF (needs: pip install 'gitgotchi[gif]')"),
 ):
-    """Save a shareable card of your companion as a PNG."""
+    """Save a shareable card of your companion."""
     from gitgotchi.paths import require_repo
-    from gitgotchi.render.card import make_card
+    from gitgotchi.render.card import make_card, make_card_gif
     from gitgotchi.render.scene import encode_png, upscale
     from gitgotchi.render.terminal import graphics_protocol, inline_image
 
     state_manager = load_state()
     stats = state_manager.get_pet_state()
     repo_name = Path(require_repo().working_tree_dir).name
-
-    image = make_card(stats, repo_name, state_manager.agent_counts())
+    agents = state_manager.agent_counts()
     scale = max(1, min(12, scale))
-    output.write_bytes(encode_png(upscale(image, scale)))
+    output = output or Path("gitgotchi-card.gif" if gif else "gitgotchi-card.png")
+
+    image = make_card(stats, repo_name, agents)
+    if gif:
+        try:
+            data = make_card_gif(stats, repo_name, agents, scale=scale)
+        except ImportError:
+            render_error("Animated cards need Pillow: pip install 'gitgotchi[gif]'")
+            raise typer.Exit(1)
+        output.write_bytes(data)
+    else:
+        output.write_bytes(encode_png(upscale(image, scale)))
 
     protocol = graphics_protocol()
     if protocol and console.is_terminal:
         console.file.write(inline_image(image, min(console.width - 2, 96), protocol))
         console.file.flush()
-    console.print(Text(f"\n🖼️  Saved {output} ({image.shape[1] * scale}x{image.shape[0] * scale})", style=theme.ORANGE))
+    size = f"{image.shape[1] * scale}x{image.shape[0] * scale}"
+    console.print(Text(f"\n🖼️  Saved {output} ({size})", style=theme.ORANGE))
     console.print(Text("Share it, and tag the spirits that wrote your code.\n", style=theme.DIM))
 
 
+@app.command()
+def badge(
+    output: Path = typer.Option(Path("gitgotchi-badge.svg"), "--output", "-o", help="Where to save the SVG"),
+):
+    """Save a README badge with your companion's portrait and form."""
+    from gitgotchi.render.badge import make_badge
+
+    from gitgotchi.paths import require_repo
+
+    stats = load_state().get_pet_state()
+    output.write_text(make_badge(stats), encoding="utf-8")
+    root = Path(require_repo().working_tree_dir).resolve()
+    try:
+        link = output.resolve().relative_to(root).as_posix()
+    except ValueError:  # saved outside the repo
+        link = output.as_posix()
+    console.print(Text(f"\n🏷️  Saved {output}. Commit it and add this to your README:", style=theme.ORANGE))
+    console.print(Text(f"[![GitGotchi]({link})](https://github.com/Srikarmk/Gitgotchi)\n", style=theme.BONE))
+    console.print(Text("Run `gitgotchi badge` again whenever your companion evolves.\n", style=theme.DIM))
+
+
 @app.command()
 def haunt(fps: int = typer.Option(12, help="Frames per second")):
     """Open a live pane where your companion reacts to every commit.
@@ -372,6 +405,86 @@ def demo():
     console.print(Text("🎃 That's GitGotchi. Run `gitgotchi install` in a real repo to adopt your own.", style=theme.ORANGE))
 
 
+@app.command()
+def config(
+    output: Optional[str] = typer.Argument(None, help="full, line or off"),
+    global_: bool = typer.Option(False, "--global", help="Set it for every repo instead of this one"),
+):
+    """Choose how much the hook prints after each commit.
+
+    full: the whole pet (default). line: one line. off: nothing.
+    Stored in git config as gitgotchi.output.
+    """
+    from gitgotchi.hooks.post_commit import configured_output
+    from gitgotchi.paths import find_repo
+    from gitgotchi.pet.renderer import OUTPUT_STYLES
+
+    repo = find_repo()
+    if output is None:
+        if repo is None:
+            render_error("No git repository found here. Run `git init` first.")
+            raise typer.Exit(1)
+        console.print(Text(f"gitgotchi.output = {configured_output(repo)}", style=theme.ORANGE))
+        return
+
+    output = output.strip().lower()
+    if output not in OUTPUT_STYLES:
+        render_error(f"Pick one of: {', '.join(OUTPUT_STYLES)}")
+        raise typer.Exit(1)
+    if not global_ and repo is None:
+        render_error("No git repository here. Use --global to set it everywhere.")
+        raise typer.Exit(1)
+
+    if global_:
+        from git import Git
+
+        Git().config("--global", "gitgotchi.output", output)
+    else:
+        repo.git.config("gitgotchi.output", output)
+    where = "every repo" if global_ else "this repo"
+    console.print(Text(f"🕯️  Hook output set to {output} for {where}.", style=theme.ORANGE))
+
+
+@app.command()
+def doctor():
+    """Check your setup and explain how to fix anything that's wrong."""
+    from gitgotchi.doctor import FAIL, WARN, run_checks
+
+    checks = run_checks(console)
+    marks = {"ok": ("✓", theme.GREEN), WARN: ("!", theme.ORANGE), FAIL: ("✗", theme.BLOOD)}
+    table = Table.grid(padding=(0, 2))
+    table.add_column(no_wrap=True)
+    table.add_column(no_wrap=True, style="bold")
+    table.add_column()
+    for check in checks:
+        mark, color = marks[check.status]
+        detail = Text(check.detail, overflow="fold")
+        if check.fix and check.status != "ok":
+            detail.append(f"\n→ {check.fix}", style=color)
+        table.add_row(Text(mark, style=f"bold {color}"), check.name, detail)
+    console.print(Panel(table, title="🩺 GitGotchi doctor", border_style=theme.PURPLE, expand=False))
+
+    failures = [c for c in checks if c.status == FAIL]
+    if failures:
+        console.print(Text(f"{len(failures)} problem{'s' if len(failures) > 1 else ''} to fix.", style=theme.BLOOD))
+        raise typer.Exit(1)
+    console.print(Text("Everything needed is working.", style=theme.GREEN))
+
+
+@app.command()
+def statusline(
+    plain: bool = typer.Option(False, "--plain", help="No colors (for tmux or Starship)"),
+    setup: bool = typer.Option(False, "--setup", help="Show how to add it to Claude Code, tmux and Starship"),
+):
+    """Print one line about your companion, for status bars and prompts.
+
+    For status bars, use the faster `gitgotchi-statusline` command instead.
+    """
+    from gitgotchi.statusline import main
+
+    raise typer.Exit(main((["--plain"] if plain else []) + (["--setup"] if setup else [])))
+
+
 @app.command()
 def version():
     """Show GitGotchi version."""

gitgotchi-0.4.0/src/gitgotchi/doctor.py

@@ -0,0 +1,190 @@
+"""`gitgotchi doctor`: check every place setup can go wrong, with a fix for each."""
+import os
+import platform
+import re
+import shutil
+import subprocess
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+from typing import List, Optional
+
+from gitgotchi import __version__
+
+OK, WARN, FAIL = "ok", "warn", "fail"
+
+
+@dataclass
+class Check:
+    status: str
+    name: str
+    detail: str
+    fix: str = ""
+
+
+def run_checks(console) -> List[Check]:
+    from gitgotchi.paths import find_repo
+
+    checks = [
+        Check(OK, "GitGotchi", f"{__version__} on Python {platform.python_version()} ({sys.executable})"),
+        _git_check(),
+    ]
+
+    repo = find_repo()
+    if repo is None:
+        checks.append(Check(FAIL, "Repository", "not inside a git repository", "cd into a repo, or run `git init`"))
+        checks.extend(_terminal_checks(console))
+        checks.append(_api_key_check())
+        return checks
+
+    checks.append(Check(OK, "Repository", repo.working_tree_dir))
+    checks.append(_pet_check())
+    checks.extend(_hook_checks(repo))
+    checks.append(_output_check(repo))
+    checks.extend(_terminal_checks(console))
+    checks.append(_api_key_check())
+    return checks
+
+
+def _git_check() -> Check:
+    git = shutil.which("git")
+    if not git:
+        return Check(FAIL, "git", "not found on PATH", "install git from https://git-scm.com")
+    try:
+        version = subprocess.run([git, "--version"], capture_output=True, text=True, timeout=10).stdout.strip()
+    except (OSError, subprocess.SubprocessError) as e:
+        return Check(FAIL, "git", str(e), "check that git runs from this terminal")
+    return Check(OK, "git", version)
+
+
+def _pet_check() -> Check:
+    from gitgotchi.db.state_manager import StateManager
+
+    try:
+        manager = StateManager()
+        stats = manager.get_pet_state()
+        path = manager.db_path
+        manager.close()
+    except Exception as e:
+        return Check(FAIL, "Pet", f"can't open the pet database: {e}", "check the permissions of .git/gitgotchi/")
+    if ".gitgotchi" in Path(path).parts:
+        return Check(WARN, "Pet", f"still in the old location {path}", "close any running `gitgotchi haunt`, then run any gitgotchi command to move it")
+    return Check(OK, "Pet", f"{stats.pet_name}, {stats.total_commits} commits ({path})")
+
+
+def _hook_checks(repo) -> List[Check]:
+    from gitgotchi.hooks.installer import HOOK_START, LEGACY_MARKER, hooks_dir
+
+    hook = hooks_dir(repo) / "post-commit"
+    if not hook.exists():
+        return [Check(WARN, "Hook", "not installed, so commits don't feed your pet", "run `gitgotchi install`")]
+
+    content = hook.read_text(errors="replace")
+    if HOOK_START not in content:
+        if LEGACY_MARKER in content:
+            return [Check(FAIL, "Hook", "left over from an older GitGotchi", "run `gitgotchi install` to update it")]
+        return [Check(WARN, "Hook", f"{hook} exists but has no GitGotchi block", "run `gitgotchi install`")]
+
+    checks = [Check(OK, "Hook", str(hook))]
+    before = content.split(HOOK_START, 1)[0]
+    if re.search(r"^\s*(exit|exec)\b", before, re.MULTILINE):
+        checks.append(Check(FAIL, "Hook order", "an `exit` or `exec` runs before GitGotchi's block", "run `gitgotchi install` to move the block up"))
+
+    if os.name != "nt" and not os.access(hook, os.X_OK):
+        checks.append(Check(FAIL, "Hook permissions", "the hook isn't executable", f"chmod +x {hook}"))
+
+    python = _hook_python(content)
+    if python is None:
+        checks.append(Check(WARN, "Hook Python", "couldn't read which Python the hook uses", "run `gitgotchi install`"))
+    elif not Path(python).exists():
+        checks.append(Check(FAIL, "Hook Python", f"{python} no longer exists", "run `gitgotchi install` from the environment GitGotchi is installed in"))
+    else:
+        probe = _probe(python)
+        if probe is None:
+            checks.append(Check(FAIL, "Hook Python", f"{python} can't import gitgotchi", "run `gitgotchi install` from the environment GitGotchi is installed in"))
+        elif probe != __version__:
+            checks.append(Check(WARN, "Hook Python", f"{python} has GitGotchi {probe}, this is {__version__}", "run `gitgotchi install` to point the hook here"))
+        else:
+            checks.append(Check(OK, "Hook Python", python))
+
+    hooks_path = _git_config(repo, "core.hooksPath")
+    if hooks_path:
+        checks.append(Check(WARN, "core.hooksPath", f"hooks come from {hooks_path} (husky or a similar tool)", "if another tool rewrites that folder, re-run `gitgotchi install` after it does"))
+    return checks
+
+
+def _output_check(repo) -> Check:
+    from gitgotchi.hooks.post_commit import configured_output
+
+    style = configured_output(repo)
+    if style not in ("full", "line", "off"):
+        return Check(WARN, "Hook output", f"gitgotchi.output is '{style}', so full is used", "run `gitgotchi config line` (or full, or off)")
+    if style == "off":
+        return Check(WARN, "Hook output", "off: commits feed your pet silently", "run `gitgotchi config full` to see it again")
+    return Check(OK, "Hook output", style)
+
+
+def _terminal_checks(console) -> List[Check]:
+    from gitgotchi.render.terminal import graphics_protocol
+
+    checks = []
+    if not console.is_terminal:
+        checks.append(Check(WARN, "Terminal", "output isn't a terminal, so the pet is drawn as one line", "run this in a terminal to see the full pet"))
+        return checks
+
+    colors = console.color_system or "none"
+    if colors == "truecolor":
+        checks.append(Check(OK, "Colors", "true color"))
+    else:
+        checks.append(Check(WARN, "Colors", f"{colors}: the pet's colors are approximated", "use a true-color terminal (iTerm2, Kitty, WezTerm, Ghostty, VS Code, Windows Terminal), or set COLORTERM=truecolor if yours supports it"))
+
+    encoding = (getattr(sys.stdout, "encoding", "") or "").lower()
+    if "utf" not in encoding:
+        checks.append(Check(WARN, "Encoding", f"{encoding or 'unknown'}", "set PYTHONIOENCODING=utf-8"))
+
+    width = console.width
+    if width < 68:
+        checks.append(Check(WARN, "Width", f"{width} columns: the pet is drawn smaller", "widen the window to at least 68 columns"))
+    else:
+        checks.append(Check(OK, "Width", f"{width} columns"))
+
+    protocol = graphics_protocol()
+    checks.append(Check(OK, "Inline images", protocol or "not supported here; `card` saves a PNG instead"))
+    return checks
+
+
+def _api_key_check() -> Check:
+    # Never print any part of the key: this output gets pasted into issues
+    if not os.environ.get("ANTHROPIC_API_KEY"):
+        return Check(OK, "Claude stories", "no ANTHROPIC_API_KEY, so the séance tells its own stories")
+    return Check(OK, "Claude stories", "ANTHROPIC_API_KEY is set")
+
+
+def _hook_python(content: str) -> Optional[str]:
+    match = re.search(r"^GITGOTCHI_PYTHON=(.+)$", content, re.MULTILINE)
+    if not match:
+        return None
+    value = match.group(1).strip()
+    if len(value) >= 2 and value[0] == value[-1] and value[0] in "'\"":
+        value = value[1:-1].replace("'\"'\"'", "'")
+    return value
+
+
+def _probe(python: str) -> Optional[str]:
+    try:
+        result = subprocess.run(
+            [python, "-c", "import gitgotchi; print(gitgotchi.__version__)"],
+            capture_output=True,
+            text=True,
+            timeout=20,
+        )
+    except (OSError, subprocess.SubprocessError):
+        return None
+    return result.stdout.strip() if result.returncode == 0 else None
+
+
+def _git_config(repo, key: str) -> str:
+    try:
+        return repo.git.config("--get", key).strip()
+    except Exception:
+        return ""

{gitgotchi-0.3.1 → gitgotchi-0.4.0}/src/gitgotchi/hooks/post_commit.py

@@ -68,6 +68,14 @@ def amended_from(repo: Repo) -> Optional[str]:
     return None
 
 
+def configured_output(repo: Repo) -> str:
+    """`git config gitgotchi.output`: full, line or off (repo setting wins over global)."""
+    try:
+        return repo.git.config("--get", "gitgotchi.output").strip().lower() or "full"
+    except GitCommandError:  # not set
+        return "full"
+
+
 def handle_post_commit() -> None:
     """Handle post-commit hook."""
     try:
@@ -84,11 +92,12 @@ def handle_post_commit() -> None:
         if feeding is None:
             return
 
+        style = configured_output(repo)
         if feeding.evolved:
-            render_evolution(feeding.stats, feeding.old_form, feeding.stats.current_form)
+            render_evolution(feeding.stats, feeding.old_form, feeding.stats.current_form, style)
         else:
             render_commit_response(
-                feeding.stats, feeding.lines_added, feeding.lines_deleted, feeding.agent
+                feeding.stats, feeding.lines_added, feeding.lines_deleted, feeding.agent, style
             )
 
     except Exception as e:

{gitgotchi-0.3.1 → gitgotchi-0.4.0}/src/gitgotchi/pet/renderer.py

@@ -132,8 +132,30 @@ def evolution_frames(stats: PetStats, old_form: PetForm, new_form: PetForm, seco
             yield pet_view(new_stats, t=p, show_stats=False, flash=max(0.0, 1 - k * 1.6), sparkles=int((1 - k) * 22) + 4, seed=i)
 
 
-def render_evolution(stats: PetStats, old_form: PetForm, new_form: PetForm) -> None:
+OUTPUT_STYLES = ("full", "line", "off")
+
+
+def output_style(requested: str = "full") -> str:
+    """How much the hook prints: the user's setting, but never the full pet
+    when nobody is watching a terminal (an AI agent running git, CI)."""
+    style = requested if requested in OUTPUT_STYLES else "full"
+    if style == "full" and not console.is_terminal:
+        return "line"
+    return style
+
+
+def render_evolution(stats: PetStats, old_form: PetForm, new_form: PetForm, style: str = "full") -> None:
+    style = output_style(style)
+    if style == "off":
+        return
     old, new = theme.form_info(old_form), theme.form_info(new_form)
+    if style == "line":
+        console.print(
+            f"{new.icon} gitgotchi: {stats.pet_name} evolved: {old.title} → {new.title}",
+            markup=False,
+            highlight=False,
+        )
+        return
     if console.is_terminal:
         console.print(Text("\n  Something is happening in the repo...", style=f"italic {theme.PURPLE}"))
         animate(evolution_frames(stats, old_form, new_form))
@@ -151,19 +173,23 @@ def render_commit_response(
     lines_added: int,
     lines_deleted: int,
     agent: Optional[str] = None,
+    style: str = "full",
 ) -> None:
-    """React to a commit.
+    """React to a commit, as loudly as `style` (full, line or off) allows.
 
-    Outside a real terminal (an AI agent running git, CI) this prints a
+    Outside a real terminal (an AI agent running git, CI) "full" becomes a
     single line so it doesn't flood the agent's context.
     """
+    style = output_style(style)
+    if style == "off":
+        return
     if agent:
         line = random.choice(theme.AGENT_REACTIONS).format(name=stats.pet_name, agent=agent)
     else:
         line = random.choice(theme.COMMIT_REACTIONS).format(name=stats.pet_name)
     icon = theme.form_info(stats.current_form).icon
 
-    if not console.is_terminal:
+    if style == "line":
         console.print(f"{icon} gitgotchi: {line} (+{lines_added} -{lines_deleted})", markup=False, highlight=False)
         return
 

{gitgotchi-0.3.1 → gitgotchi-0.4.0}/src/gitgotchi/render/__init__.py

@@ -30,7 +30,8 @@ def render_scene(
         pose = Pose(yaw=0.0, bob=0.015 * np.sin(t * 2 * np.pi), squash=0.97, tilt=0.0)
         form.eyes_closed = True
 
-    frame = render(form, t, width, height, offset=(0.0, 0.12), pose=pose)
+    # Framed tight so the pet gets as many pixels as the canvas allows
+    frame = render(form, t, width, height, span=1.2, offset=(0.0, 0.07), pose=pose)
     frame.rgba = effects.flash(frame.rgba, flash)
     if not stage:
         return compose(frame)