gitgotchi 0.1.0__py3-none-any.whl

gitgotchi-0.1.0.dist-info/METADATA

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: gitgotchi
+Version: 0.1.0
+Summary: A Stardew Valley-inspired terminal companion for your git repository
+Home-page: https://github.com/yourusername/gitgotchi
+Author: GitGotchi Team
+Author-email: GitGotchi Team <gitgotchi@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/gitgotchi
+Project-URL: Repository, https://github.com/yourusername/gitgotchi
+Project-URL: Issues, https://github.com/yourusername/gitgotchi/issues
+Project-URL: Documentation, https://github.com/yourusername/gitgotchi#readme
+Keywords: git,terminal,pet,companion,stardew-valley,ai,tamagotchi,devtools,hackathon,kiro
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.7.0
+Requires-Dist: gitpython>=3.1.40
+Requires-Dist: anthropic>=0.34.0
+Requires-Dist: sqlalchemy>=2.0.36
+Requires-Dist: typer>=0.9.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.3; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# 🎃 GitGotchi - Your Friendly Dev Companion 👻
+
+A Stardew Valley-inspired terminal companion that lives in your git repository!
+
+## ✨ Features
+- Adorable pixel art companion that evolves based on your coding habits
+- Warm, encouraging stories about your code history
+- Automatic feeding through git hooks
+- Friendship system inspired by Stardew Valley
+- Cozy terminal UI with sparkles and hearts
+- Fast evolution - see changes every 2-3 commits!
+
+## 🚀 Quick Start
+```bash
+pip install -r requirements.txt
+python gitgotchi.py install  # Install git hooks
+python gitgotchi.py status   # Meet your companion!
+```
+
+## 🎮 Commands
+- `gitgotchi status` - See your companion
+- `gitgotchi pet` - Give them affection
+- `gitgotchi story` - Hear a code story
+- `gitgotchi evolve` - Check evolution progress
+- `gitgotchi name <name>` - Give your companion a name
+
+## 🌟 Evolution Forms (Fast Track!)
+- 🥚 Egg (0-2 commits)
+- 👻 Ghost (3-5 commits)
+- 👼 Angel (6+ commits, high quality)
+- 😈 Demon (6+ commits, chaotic)
+- 🧟 Zombie (4+ reverts, needs coffee)
+- 🌙 Wraith (15+ commits, ultimate form)
+
+## 🎨 Theme
+GitGotchi is inspired by Stardew Valley's cozy, friendly aesthetic. Your companion is a warm, magical spirit - not scary! Think Junimos, sparkles, and autumn leaves.
+
+Built with ❤️ for Kiroween Hackathon 2024

gitgotchi-0.1.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+gitgotchi-0.1.0.dist-info/licenses/LICENSE,sha256=6k9l52nYfuS1Ktvxos5VGH5kVc8oxgykbKSzmh9tzqo,1092
+src/__init__.py,sha256=l_V_FObzZCzbJFX4e2u13AnYZEdE29dtdpSqYwfiMTk,284
+src/cli.py,sha256=WerXS_SX6of7SHn3u5JCpHE-XeI59CX6FX9dezV-6U4,5258
+src/db/__init__.py,sha256=LjqUEYU9TURCkPMkKAot0T9khEHOrkGZwcShXhuFobo,24
+src/db/migrations.py,sha256=fsKnfgU8uu7R0aHdmqq89dR2adXwRk2On_28Ypn56a4,3029
+src/db/models.py,sha256=QdXHkxR9ZaONaiup5q6NYvv6cxTw-HUntrDipzcv_CM,3573
+src/db/state_manager.py,sha256=Xr_L_qRC9x58ac0M4tkIZWUfV7XuIKN7zJFB0JIvLQQ,8871
+src/hooks/__init__.py,sha256=iJfxk3coNJu-Rd9_QU73lEaCW6cQBE2aJiq-idAzK40,25
+src/hooks/installer.py,sha256=nSKvigoOVtMibOiKQa3u7mz7TNGt0V_fGX0655Uf9ZY,3638
+src/hooks/post_commit.py,sha256=pYEG9cVtZvb_NYN3rALpEGT_6IcDMbMUMMx52NvznnY,2188
+src/pet/__init__.py,sha256=O2wViywLlqHFo5BLYsoR5eKM55N6gzWaPeNJq9zCTpE,19
+src/pet/evolution.py,sha256=sSsBBhysL3Vw0lgZvlTH2Xt8mFmwMnz4UdbpaijpQFY,92
+src/pet/renderer.py,sha256=1mYX787b0s2IkEz08Ylo4T4I3NiBCW0v9Sl3Di_F9hg,5440
+src/pet/states.py,sha256=XNREk3wxkWWzzBuNHneuouQwd0mQxSv-U6JtjYPzk_Y,4352
+src/seance/__init__.py,sha256=Dxose1-VsMTJPZgaNSzNIplDsFcNcSYEs0FWmVDw9Oo,43
+src/seance/git_analyzer.py,sha256=vkVphOCyA5D49Dq_AXobXHopFoEtK4jnXfeYeb8O1bA,93
+src/seance/story_gen.py,sha256=-L3xfaFw_FcRRkha7sxXLRlJnnzliCkGt-BwBYxqKRk,6659
+src/seance/templates.py,sha256=lmdkucuSrjZXmho94gIN6qouwTh2ATnAHOE0wj1n5cQ,42
+gitgotchi-0.1.0.dist-info/METADATA,sha256=Tg5je-Cpb-eJ8ZOyw04etNtlHRdPKwSzkgWZ9uQ1OpE,3034
+gitgotchi-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gitgotchi-0.1.0.dist-info/entry_points.txt,sha256=YU3rE0GiGuTPqgV3iy7gowLRS8Kuoe9U5h0f0hw_-DY,42
+gitgotchi-0.1.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+gitgotchi-0.1.0.dist-info/RECORD,,

gitgotchi-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

gitgotchi-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gitgotchi = src.cli:cli

gitgotchi-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 GitGotchi Team
+
+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.

gitgotchi-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+src

src/__init__.py

@@ -0,0 +1,13 @@
+"""
+GitGotchi - A Stardew Valley-inspired terminal companion for your git repository.
+
+Built for Kiroween Hackathon 2024.
+"""
+
+__version__ = "0.1.0"
+__author__ = "GitGotchi Team"
+__email__ = "gitgotchi@example.com"
+
+from src.cli import app, cli
+
+__all__ = ["app", "cli"]

src/cli.py

@@ -0,0 +1,182 @@
+"""Main CLI interface."""
+import typer
+from rich.console import Console
+from rich.panel import Panel
+
+from src.db.state_manager import StateManager
+from src.hooks.installer import install_hooks, uninstall_hooks
+from src.pet.renderer import render_error, render_pet
+
+app = typer.Typer(help="✨ GitGotchi - Your friendly dev companion")
+console = Console()
+
+
+def cli():
+    """Entry point for console script."""
+    app()
+
+
+@app.command()
+def status():
+    """Show your companion's current status."""
+    try:
+        state_manager = StateManager()
+        pet_stats = state_manager.get_pet_state()
+        render_pet(pet_stats, show_stats=True)
+    except Exception as e:
+        render_error(f"Failed to load companion state: {str(e)}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def install():
+    """Install GitGotchi git hooks for automatic feeding."""
+    if install_hooks():
+        console.print(
+            "\n[green]✨ Git hooks installed! Your companion will be fed automatically on commits.[/green]"
+        )
+        console.print("[dim]Make a commit to meet your new friend...[/dim]\n")
+    else:
+        raise typer.Exit(1)
+
+
+@app.command()
+def uninstall():
+    """Remove GitGotchi git hooks."""
+    if uninstall_hooks():
+        console.print(
+            "\n[yellow]👋 Git hooks removed. You can still feed manually with 'gitgotchi feed'.[/yellow]\n"
+        )
+    else:
+        raise typer.Exit(1)
+
+
+@app.command()
+def pet():
+    """Pet your companion (boosts mood slightly)."""
+    try:
+        state_manager = StateManager()
+        pet_stats = state_manager.get_pet_state()
+
+        # Interact with pet
+        message = pet_stats.interact()
+
+        # Save updated state
+        state_manager.save_pet_state(pet_stats)
+
+        # Show response
+        console.print(Panel(message, border_style="cyan", title="💛 Interaction"))
+        render_pet(pet_stats, show_stats=False)
+
+    except Exception as e:
+        render_error(f"Failed to interact: {str(e)}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def name(new_name: str):
+    """Give your companion a name."""
+    try:
+        state_manager = StateManager()
+        pet_stats = state_manager.get_pet_state()
+
+        old_name = pet_stats.pet_name
+        pet_stats.pet_name = new_name
+
+        state_manager.save_pet_state(pet_stats)
+
+        console.print(
+            f"\n[green]✨ Your companion is now named {new_name}![/green]"
+        )
+        if old_name != "Spirit":
+            console.print(f"[dim](Previously known as {old_name})[/dim]\n")
+
+    except Exception as e:
+        render_error(f"Failed to rename companion: {str(e)}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def evolve():
+    """Check evolution progress and requirements."""
+    try:
+        state_manager = StateManager()
+        pet_stats = state_manager.get_pet_state()
+
+        # Calculate progress
+        current_form = pet_stats.current_form.value
+        commits = pet_stats.total_commits
+        quality = pet_stats.quality_score
+
+        console.print(
+            Panel(
+                f"""[cyan]Current Form:[/cyan] {current_form}
+[cyan]Total Commits:[/cyan] {commits}
+[cyan]Quality Score:[/cyan] {quality:.1f}/100
+[cyan]Friend Level:[/cyan] {"❤️" * int(pet_stats.friend_level)} ({pet_stats.friend_level}/10)
+
+[yellow]Evolution Requirements:[/yellow]
+• Egg → Ghost: 3 commits (you have {commits})
+• Ghost → Angel: 6 commits + quality > 70
+• Ghost → Demon: 6 commits + quality < 30
+• Any → Zombie: 4 reverts (you have {pet_stats.reverts})
+• Any → Wraith: 15 commits (ultimate form!)
+""",
+                title="🌟 Evolution Progress",
+                border_style="cyan",
+            )
+        )
+
+    except Exception as e:
+        render_error(f"Failed to check evolution: {str(e)}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def story():
+    """Hear a story about your code's history."""
+    try:
+        from src.seance.story_gen import StoryGenerator
+
+        state_manager = StateManager()
+        pet_stats = state_manager.get_pet_state()
+
+        generator = StoryGenerator()
+
+        # Generate milestone story
+        context = {
+            "total_commits": pet_stats.total_commits,
+            "total_lines": pet_stats.lines_added + pet_stats.lines_deleted,
+            "days_together": (
+                pet_stats.last_fed - pet_stats.last_fed
+            ).days,  # Simplified
+        }
+
+        story_text = generator.generate_story(
+            "milestone", context, pet_stats.current_form.value
+        )
+
+        console.print(
+            Panel(
+                story_text,
+                title=f"📖 {pet_stats.pet_name}'s Story",
+                border_style="cyan",
+                padding=(1, 2),
+            )
+        )
+
+    except Exception as e:
+        render_error(f"Failed to generate story: {str(e)}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def version():
+    """Show GitGotchi version."""
+    console.print(
+        "GitGotchi v0.1.0 - Your friendly dev companion ✨", style="bold cyan"
+    )
+
+
+if __name__ == "__main__":
+    app()

src/db/__init__.py

@@ -0,0 +1 @@
+"""Database module."""

src/db/migrations.py

@@ -0,0 +1,100 @@
+"""Database migration utilities."""
+from pathlib import Path
+from typing import Optional
+
+from sqlalchemy import text
+from sqlalchemy.orm import Session
+
+from src.db.models import get_engine
+
+
+class MigrationManager:
+    """Handles database schema migrations."""
+
+    def __init__(self, db_path: str = ".gitgotchi/state.db") -> None:
+        """Initialize migration manager.
+
+        Args:
+            db_path: Path to SQLite database file
+        """
+        self.db_path = db_path
+        self.engine = get_engine(db_path)
+
+    def get_schema_version(self) -> int:
+        """Get current schema version.
+
+        Returns:
+            Schema version number, 0 if not set
+        """
+        try:
+            with Session(self.engine) as session:
+                result = session.execute(
+                    text("SELECT version FROM schema_version LIMIT 1")
+                )
+                row = result.fetchone()
+                return row[0] if row else 0
+        except Exception:
+            return 0
+
+    def set_schema_version(self, version: int) -> None:
+        """Set schema version.
+
+        Args:
+            version: Version number to set
+        """
+        with Session(self.engine) as session:
+            # Create table if not exists
+            session.execute(
+                text(
+                    """
+                CREATE TABLE IF NOT EXISTS schema_version (
+                    version INTEGER PRIMARY KEY
+                )
+                """
+                )
+            )
+
+            # Update or insert version
+            session.execute(text("DELETE FROM schema_version"))
+            session.execute(
+                text("INSERT INTO schema_version (version) VALUES (:version)"),
+                {"version": version},
+            )
+            session.commit()
+
+    def backup_database(self) -> Optional[str]:
+        """Create backup of database.
+
+        Returns:
+            Path to backup file if successful, None otherwise
+        """
+        try:
+            db_file = Path(self.db_path)
+            if not db_file.exists():
+                return None
+
+            backup_path = db_file.with_suffix(".db.backup")
+            backup_path.write_bytes(db_file.read_bytes())
+            return str(backup_path)
+        except Exception:
+            return None
+
+    def run_migrations(self) -> None:
+        """Run all pending migrations."""
+        current_version = self.get_schema_version()
+
+        # Define migrations
+        migrations = [
+            self._migration_v1_initial,
+            # Add future migrations here
+        ]
+
+        for version, migration in enumerate(migrations, start=1):
+            if version > current_version:
+                self.backup_database()
+                migration()
+                self.set_schema_version(version)
+
+    def _migration_v1_initial(self) -> None:
+        """Initial schema - handled by SQLAlchemy create_all."""
+        pass

src/db/models.py

@@ -0,0 +1,92 @@
+"""SQLite schemas."""
+from datetime import datetime
+from typing import Optional
+
+from sqlalchemy import Float, Integer, String, Text, create_engine
+from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, Session
+
+
+class Base(DeclarativeBase):
+    """Base class for all models."""
+
+    pass
+
+
+class PetState(Base):
+    """Singleton table storing current pet state (one row per repo)."""
+
+    __tablename__ = "pet_state"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    pet_name: Mapped[str] = mapped_column(String(100), default="Spirit")
+    total_commits: Mapped[int] = mapped_column(Integer, default=0)
+    lines_added: Mapped[int] = mapped_column(Integer, default=0)
+    lines_deleted: Mapped[int] = mapped_column(Integer, default=0)
+    merge_conflicts: Mapped[int] = mapped_column(Integer, default=0)
+    reverts: Mapped[int] = mapped_column(Integer, default=0)
+    quality_score: Mapped[float] = mapped_column(Float, default=50.0)
+    evolution_points: Mapped[int] = mapped_column(Integer, default=0)
+    friend_level: Mapped[float] = mapped_column(Float, default=1.0)
+    last_fed: Mapped[datetime] = mapped_column(default=datetime.now)
+    current_mood: Mapped[str] = mapped_column(String(20), default="content")
+    current_form: Mapped[str] = mapped_column(String(20), default="egg")
+    created_at: Mapped[datetime] = mapped_column(default=datetime.now)
+    updated_at: Mapped[datetime] = mapped_column(
+        default=datetime.now, onupdate=datetime.now
+    )
+
+
+class CommitHistory(Base):
+    """Log of all tracked commits."""
+
+    __tablename__ = "commit_history"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    commit_hash: Mapped[str] = mapped_column(String(40), unique=True, index=True)
+    author: Mapped[str] = mapped_column(String(255))
+    message: Mapped[str] = mapped_column(Text)
+    timestamp: Mapped[datetime] = mapped_column(index=True)
+    lines_added: Mapped[int] = mapped_column(Integer, default=0)
+    lines_deleted: Mapped[int] = mapped_column(Integer, default=0)
+    files_changed: Mapped[int] = mapped_column(Integer, default=0)
+    is_merge: Mapped[bool] = mapped_column(default=False)
+    is_revert: Mapped[bool] = mapped_column(default=False)
+    quality_impact: Mapped[float] = mapped_column(Float, default=0.0)
+    processed_at: Mapped[datetime] = mapped_column(default=datetime.now)
+
+
+class StoryMemory(Base):
+    """Cache of generated stories."""
+
+    __tablename__ = "story_memory"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    commit_hash: Mapped[str] = mapped_column(String(40), index=True)
+    story_text: Mapped[str] = mapped_column(Text)
+    story_type: Mapped[str] = mapped_column(String(50))
+    pet_form_at_time: Mapped[str] = mapped_column(String(20))
+    pet_mood_at_time: Mapped[str] = mapped_column(String(20))
+    generated_at: Mapped[datetime] = mapped_column(default=datetime.now)
+    tokens_used: Mapped[Optional[int]] = mapped_column(Integer, nullable=True)
+
+
+def get_engine(db_path: str = ".gitgotchi/state.db"):
+    """Create database engine.
+
+    Args:
+        db_path: Path to SQLite database file
+
+    Returns:
+        SQLAlchemy engine instance
+    """
+    return create_engine(f"sqlite:///{db_path}", echo=False)
+
+
+def init_db(db_path: str = ".gitgotchi/state.db") -> None:
+    """Initialize database schema.
+
+    Args:
+        db_path: Path to SQLite database file
+    """
+    engine = get_engine(db_path)
+    Base.metadata.create_all(engine)