wtf-dev 0.1.0__tar.gz

wtf_dev-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment variables
+.env

wtf_dev-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

wtf_dev-0.1.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: wtf-dev
+Version: 0.1.0
+Summary: What did I work on? A snarky standup generator.
+Requires-Python: >=3.11
+Requires-Dist: inquirerpy>=0.3.4
+Requires-Dist: pydantic-settings>=2.12.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pyperclip>=1.11.0
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=14.3.1
+Requires-Dist: typer>=0.21.1
+Description-Content-Type: text/markdown
+
+# wtf-dev
+
+A CLI tool that tells you what you worked on - with personality.
+
+## Install
+
+```bash
+pip install wtf-dev
+```
+
+## Setup
+
+```bash
+wtf setup
+```
+
+This will prompt for your OpenRouter API key and let you pick a model.
+
+## Usage
+
+```bash
+# what did I do today?
+wtf
+
+# look back N days
+wtf --days 3
+
+# only current repo
+wtf --here
+
+# copy to clipboard
+wtf --copy
+```
+
+## Features
+
+- **Standup summary** - LLM-generated summary of your commits
+- **WIP tracking** - Shows uncommitted changes + what you're currently working on
+- **Streak counter** - Track your commit streak
+- **Late night detection** - Spots those 2am coding sessions
+- **Branch context** - Shows which branches you touched
+- **History** - View past standups with `wtf --history`
+- **Cost tracking** - Track API spending with `wtf --spending`
+
+## Output
+
+```
+PREVIOUSLY ON YOUR CODE...  Feb 02, 2026
+  * 5 day streak
+────────────────────────────────────────────────────────────
+
+   ai-platform (main) ─── 2 commits
+  ├─ feat(sdr): add langsmith tracing
+  └─ feat(sdr): add automatic follow-up
+
+   [wip]
+   ai-platform ─── 3 files changed
+  ├─ M src/api/routes.py
+  └─ A src/new_feature.py
+
+────────────────────────────────────────────────────────────
+
+  Added LangSmith tracing and automatic follow-up for stale
+  conversations in the SDR pipeline.
+
+  Currently working on: Adding new API routes for validation.
+
+  Two features down, infinite bugs to go.
+```
+
+## Flags
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--dir PATH` | `-d` | Scan a specific directory |
+| `--here` | `-H` | Only current repo |
+| `--days N` | `-n` | Look back N days (default: 1) |
+| `--author NAME` | `-a` | Filter by author |
+| `--copy` | `-c` | Copy to clipboard |
+| `--history` | | View past standups |
+| `--spending` | | Show API costs |
+| `--json` | | Output as JSON |

wtf_dev-0.1.0/README.md

@@ -0,0 +1,82 @@
+# wtf-dev
+
+A CLI tool that tells you what you worked on - with personality.
+
+## Install
+
+```bash
+pip install wtf-dev
+```
+
+## Setup
+
+```bash
+wtf setup
+```
+
+This will prompt for your OpenRouter API key and let you pick a model.
+
+## Usage
+
+```bash
+# what did I do today?
+wtf
+
+# look back N days
+wtf --days 3
+
+# only current repo
+wtf --here
+
+# copy to clipboard
+wtf --copy
+```
+
+## Features
+
+- **Standup summary** - LLM-generated summary of your commits
+- **WIP tracking** - Shows uncommitted changes + what you're currently working on
+- **Streak counter** - Track your commit streak
+- **Late night detection** - Spots those 2am coding sessions
+- **Branch context** - Shows which branches you touched
+- **History** - View past standups with `wtf --history`
+- **Cost tracking** - Track API spending with `wtf --spending`
+
+## Output
+
+```
+PREVIOUSLY ON YOUR CODE...  Feb 02, 2026
+  * 5 day streak
+────────────────────────────────────────────────────────────
+
+   ai-platform (main) ─── 2 commits
+  ├─ feat(sdr): add langsmith tracing
+  └─ feat(sdr): add automatic follow-up
+
+   [wip]
+   ai-platform ─── 3 files changed
+  ├─ M src/api/routes.py
+  └─ A src/new_feature.py
+
+────────────────────────────────────────────────────────────
+
+  Added LangSmith tracing and automatic follow-up for stale
+  conversations in the SDR pipeline.
+
+  Currently working on: Adding new API routes for validation.
+
+  Two features down, infinite bugs to go.
+```
+
+## Flags
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--dir PATH` | `-d` | Scan a specific directory |
+| `--here` | `-H` | Only current repo |
+| `--days N` | `-n` | Look back N days (default: 1) |
+| `--author NAME` | `-a` | Filter by author |
+| `--copy` | `-c` | Copy to clipboard |
+| `--history` | | View past standups |
+| `--spending` | | Show API costs |
+| `--json` | | Output as JSON |

wtf_dev-0.1.0/WTF.md

@@ -0,0 +1,128 @@
+# WTF - What The (F)iles Did I Work On?
+
+A CLI tool that tells you what you worked on yesterday - with personality.
+
+## What It Does
+
+`wtf` scans your git repositories, finds your recent commits, and generates a standup-ready summary with snarky commentary. No more staring at `git log` trying to remember what you did.
+
+```bash
+$ wtf
+
+🎬 PREVIOUSLY ON YOUR CODE...
+
+┌──────────────────────────────────────────────────────────────┐
+│ 📁 api-service (4 commits)                                   │
+├──────────────────────────────────────────────────────────────┤
+│ • Fixed auth bug                                             │
+│ • Fixed auth bug again                                       │
+│ • Actually fixed auth bug                                    │
+│ • Why is auth so hard                                        │
+│                                                              │
+│ 💬 Four commits, one bug. The bug is winning.                │
+└──────────────────────────────────────────────────────────────┘
+
+📋 STANDUP READY:
+"Yesterday I mass mass fixed the auth bug in api-service. It took a few
+attempts but we got there."
+
+[c] Copy to clipboard
+```
+
+## Installation
+
+```bash
+pip install wtf-cli
+```
+
+## Usage
+
+```bash
+# Basic - scan current directory for all repos
+wtf
+
+# Only current repo (not recursive)
+wtf --here
+
+# Scan specific directory
+wtf --dir ~/projects
+
+# Look back N days
+wtf --days 3
+
+# Copy standup to clipboard automatically
+wtf --copy
+
+# Different output styles
+wtf --style roast      # Extra snarky
+wtf --style haiku      # Poetic mode
+wtf --style corporate  # Buzzword bingo
+
+# Use AI for smarter commentary (requires API key)
+wtf --ai
+```
+
+## Flags
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--here` | `-h` | Only scan current repo, not subdirectories |
+| `--dir PATH` | `-d` | Scan a specific directory |
+| `--days N` | `-n` | Look back N days (default: 1, or since Friday if Monday) |
+| `--author NAME` | `-a` | Filter by author (default: git config user.name) |
+| `--copy` | `-c` | Copy standup summary to clipboard |
+| `--style STYLE` | `-s` | Output style: `normal`, `roast`, `haiku`, `corporate` |
+| `--ai` | | Use LLM for smarter roasts (requires OPENROUTER_API_KEY) |
+| `--json` | | Output as JSON (for piping to other tools) |
+
+## Configuration
+
+Set your API key for AI mode:
+
+```bash
+export OPENROUTER_API_KEY="your-key-here"
+```
+
+Or create `~/.wtf/config.json`:
+
+```json
+{
+  "default_style": "roast",
+  "auto_copy": true,
+  "ai_model": "anthropic/claude-3-haiku"
+}
+```
+
+## What It Detects
+
+- **Vague commits**: "WIP", "fix", "update" → roasts you
+- **Repeated fixes**: Same bug fixed 3 times → notes the struggle
+- **Late night coding**: Commits after midnight → comments on your sleep schedule
+- **Same file touched repeatedly**: Sign of a tricky problem
+- **Empty commit messages**: Shame.
+
+## Examples
+
+```bash
+# Monday morning - shows everything since Friday
+$ wtf
+🎬 PREVIOUSLY ON YOUR CODE... (Fri-Sun)
+
+# Quick standup, copy to clipboard
+$ wtf -c
+✅ Copied to clipboard!
+
+# Extra roasty
+$ wtf --style roast
+💬 "You mass mass mass mass made 12 commits and mass mass mass mass mass mass mass mass mass mass mass mass mass mass mass mass 8 of them say 'fix'. Are you okay?"
+
+# Haiku mode
+$ wtf --style haiku
+    Auth bug defeated
+    Four commits mass mass to find the truth
+    Sleep comes at last
+```
+
+## License
+
+MIT

wtf_dev-0.1.0/config.py

@@ -0,0 +1,14 @@
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(env_file=".env", env_file_encoding="utf-8")
+
+    # openrouter config
+    openrouter_api_key: str = ""
+    openrouter_url: str = "https://openrouter.ai/api/v1/chat/completions"
+    wtf_model: str = "openai/gpt-oss-120b"
+    wtf_provider: str = "deepinfra/fp4"
+
+
+settings = Settings()

wtf_dev-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[project]
+name = "wtf-dev"
+version = "0.1.0"
+description = "What did I work on? A snarky standup generator."
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "InquirerPy>=0.3.4",
+    "pydantic>=2.12.5",
+    "pydantic-settings>=2.12.0",
+    "pyperclip>=1.11.0",
+    "python-dotenv>=1.2.1",
+    "requests>=2.32.5",
+    "rich>=14.3.1",
+    "typer>=0.21.1",
+]
+
+[project.scripts]
+wtf = "src.cli:app"
+
+[tool.uv]
+package = true
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+    "pytest-mock>=3.15.1",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src"]
+
+[tool.pytest.ini_options]
+pythonpath = ["."]

wtf_dev-0.1.0/src/cli.py

@@ -0,0 +1,246 @@
+import json
+from datetime import datetime
+from pathlib import Path
+from typing import Optional
+
+import pyperclip
+import typer
+
+from . import formatter, storage
+from .git import (
+    find_git_repos,
+    get_commit_streak,
+    get_current_branch,
+    get_git_commits,
+    get_git_diff,
+    get_git_diff_stat,
+    get_git_user,
+)
+from .llm import analyze_commits, get_model
+from .models import Commit, RepoSummary, StandupResult, TimeStats, WipSummary
+
+app = typer.Typer(add_completion=False, invoke_without_command=True)
+
+
+@app.command()
+def setup():
+    from .setup import run_setup
+
+    run_setup()
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    dir: Optional[Path] = typer.Option(None, "--dir", "-d"),
+    here: bool = typer.Option(False, "--here", "-H"),
+    days: int = typer.Option(1, "--days", "-n"),
+    author: Optional[str] = typer.Option(None, "--author", "-a"),
+    copy: bool = typer.Option(False, "--copy", "-c"),
+    spending: bool = typer.Option(False, "--spending"),
+    history: bool = typer.Option(False, "--history"),
+    json_out: bool = typer.Option(False, "--json"),
+):
+    # if a subcommand was invoked, skip main logic
+    if ctx.invoked_subcommand is not None:
+        return
+
+    # check if configured, run setup if not
+    if not storage.is_configured():
+        formatter.console.print("[yellow]First time? Let's set up wtf.[/yellow]")
+        from .setup import run_setup
+
+        run_setup()
+        return
+
+    # handle --spending
+    if spending:
+        total = storage.get_total_spent()
+        formatter.render_spending(total)
+        return
+
+    # handle --history
+    if history:
+        past = storage.load_history()
+        for item in past:
+            formatter.console.print(f"[dim]{item.generated_at}[/dim]")
+            formatter.console.print(item.llm_response.summary)
+            formatter.console.print()
+        return
+
+    # main flow
+    scan_path = str(dir) if dir else "."
+    git_author = author or get_git_user() or "unknown"
+
+    # handle monday (show fri-sun)
+    if datetime.now().weekday() == 0:
+        days = max(days, 3)
+
+    # find repos and commits
+    if here:
+        repos = [scan_path]
+    else:
+        repos = find_git_repos(scan_path)
+
+    summaries = []
+    wip_summaries = []
+    all_commits = []
+
+    for repo_path in repos:
+        commits = get_commits(repo_path, git_author, f"{days} days ago")
+        branch = get_current_branch(repo_path)
+
+        if commits:
+            summaries.append(
+                RepoSummary(
+                    name=Path(repo_path).name,
+                    path=repo_path,
+                    commits=commits,
+                    branch=branch,
+                )
+            )
+            all_commits.extend(commits)
+
+        # gather wip (uncommitted changes)
+        diff_stat = get_git_diff_stat(repo_path)
+        if diff_stat:
+            diff = get_git_diff(repo_path)
+            wip_summaries.append(
+                WipSummary(
+                    repo_name=Path(repo_path).name,
+                    files_changed=diff_stat,
+                    diff_preview=diff[:2000],
+                )
+            )
+
+    if not summaries and not wip_summaries:
+        formatter.console.print("[yellow]No commits found.[/yellow]")
+        raise typer.Exit()
+
+    # calculate time stats
+    time_stats = calculate_time_stats(all_commits)
+
+    # get streak
+    streak = get_commit_streak(scan_path, git_author) if summaries else 0
+
+    # call llm
+    commits_text = format_for_llm(summaries) if summaries else "No commits."
+    diff_text = format_wip_for_llm(wip_summaries) if wip_summaries else None
+
+    try:
+        llm_response, cost = analyze_commits(commits_text, diff_text)
+        storage.add_spending(cost, get_model())
+    except Exception as e:
+        formatter.console.print(f"[red]LLM error: {e}[/red]")
+        raise typer.Exit(1)
+
+    # build result
+    result = StandupResult(
+        repos=summaries,
+        llm_response=llm_response,
+        generated_at=datetime.now(),
+        cost_usd=cost,
+        wip=wip_summaries,
+        time_stats=time_stats,
+        streak=streak,
+    )
+
+    # save to history
+    storage.save_standup(result)
+
+    # output
+    if json_out:
+        print(
+            json.dumps(
+                {
+                    "summary": result.llm_response.summary,
+                    "roast": result.llm_response.roast,
+                    "repos": [
+                        {"name": r.name, "commits": len(r.commits)} for r in summaries
+                    ],
+                },
+                indent=2,
+            )
+        )
+    else:
+        formatter.render(result)
+
+    # copy to clipboard
+    if copy:
+        pyperclip.copy(result.llm_response.summary)
+        formatter.render_copied()
+
+
+def get_commits(repo_path: str, author: str, since: str) -> list[Commit]:
+    raw = get_git_commits(repo_path, author, since)
+    if not raw:
+        return []
+
+    commits = []
+    for line in raw.split("\n"):
+        if "|" in line:
+            parts = line.split("|")
+            commits.append(
+                Commit(
+                    hash=parts[0],
+                    message=parts[1],
+                    date=parts[2] if len(parts) > 2 else "",
+                    time=parts[3] if len(parts) > 3 else "",
+                    repo_name=Path(repo_path).name,
+                )
+            )
+    return commits
+
+
+def format_for_llm(summaries: list[RepoSummary]) -> str:
+    lines = []
+    for s in summaries:
+        lines.append(f"\n{s.name} ({len(s.commits)} commits):")
+        for c in s.commits:
+            lines.append(f"  - {c.message}")
+    return "\n".join(lines)
+
+
+def format_wip_for_llm(wip_summaries: list[WipSummary]) -> str:
+    lines = []
+    for wip in wip_summaries:
+        lines.append(f"\n{wip.repo_name} ({len(wip.files_changed)} files changed):")
+        for f in wip.files_changed[:10]:
+            lines.append(f"  {f}")
+        if wip.diff_preview:
+            lines.append(f"\nDiff preview:\n{wip.diff_preview[:1500]}")
+    return "\n".join(lines)
+
+
+def calculate_time_stats(commits: list[Commit]) -> TimeStats:
+    if not commits:
+        return TimeStats()
+
+    late_night = 0
+    early_morning = 0
+
+    for c in commits:
+        if c.time:
+            try:
+                # time is in ISO format like 2026-02-02T23:45:00+05:30
+                hour = int(c.time[11:13])
+                if hour >= 22 or hour < 5:
+                    late_night += 1
+                elif hour < 7:
+                    early_morning += 1
+            except (ValueError, IndexError):
+                pass
+
+    # estimate hours: rough heuristic (15 min per commit minimum)
+    estimated_hours = len(commits) * 0.25
+
+    return TimeStats(
+        total_commits=len(commits),
+        late_night_commits=late_night,
+        early_morning_commits=early_morning,
+        estimated_hours=estimated_hours,
+    )
+
+
+if __name__ == "__main__":
+    app()