yeaboi 2.8.0__tar.gz

yeaboi-2.8.0/.env.example

@@ -0,0 +1,126 @@
+# LLM Provider
+# Options: anthropic (default), openai, google
+# Install additional providers: uv sync --extra openai   or   uv sync --extra google
+LLM_PROVIDER=anthropic
+# Optional: override the default model for the selected provider
+# Anthropic default: claude-sonnet-4-20250514
+# OpenAI default:    gpt-4o
+# Google default:    gemini-2.0-flash
+LLM_MODEL=
+
+# Anthropic (required when LLM_PROVIDER=anthropic)
+ANTHROPIC_API_KEY=your-anthropic-api-key
+
+# OpenAI (required when LLM_PROVIDER=openai)
+OPENAI_API_KEY=your-openai-api-key
+
+# Google AI (required when LLM_PROVIDER=google)
+GOOGLE_API_KEY=your-google-api-key
+
+# LangSmith (optional — enables tracing for development)
+LANGSMITH_TRACING=true
+LANGSMITH_API_KEY=your-langsmith-api-key
+LANGSMITH_PROJECT=yeaboi
+
+# GitHub (optional — enables repo context tools; required for private repos and higher rate limits)
+# Fine-grained PAT: Contents=Read, Issues=Read, Metadata=Read
+# Classic PAT: public_repo (public repos) or repo (private repos)
+# No token: works for public repos at 60 req/hour (unauthenticated)
+GITHUB_TOKEN=your-github-personal-access-token
+
+# Azure DevOps (optional — enables repo context tools and board sync; required for private projects)
+# PAT permissions needed: Code=Read, Work Items=Read+Write, Project=Read
+AZURE_DEVOPS_TOKEN=your-azure-devops-personal-access-token
+# Organization URL (e.g. https://dev.azure.com/myorg) — required for board sync
+AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org
+# Project name — required for board sync
+AZURE_DEVOPS_PROJECT=MyProject
+# Team name (optional — defaults to "{project} Team")
+AZURE_DEVOPS_TEAM=
+
+# Jira Cloud / Atlassian (optional — enables Jira board read + issue creation tools)
+# API token: id.atlassian.com → Security → API tokens
+# No trailing slash on JIRA_BASE_URL
+JIRA_BASE_URL=https://your-org.atlassian.net
+JIRA_EMAIL=you@example.com
+JIRA_API_TOKEN=your-jira-api-token
+JIRA_PROJECT_KEY=MYPROJ
+
+# Team analysis (optional — extra API calls to improve “Repository activity”)
+# Jira: fetch dev-status (linked PRs/branches from Jira Software Development panel)
+#TEAM_ANALYSIS_JIRA_DEV_LINKS=true
+# Azure DevOps: scan recent Git PRs for work item links / id in branch name (per-repo cap)
+#TEAM_ANALYSIS_AZDO_BRANCH_SEARCH=true
+#TEAM_ANALYSIS_AZDO_PR_SEARCH_MAX_REPOS=10
+#TEAM_ANALYSIS_AZDO_PR_SEARCH_PRS_PER_REPO=75
+#TEAM_ANALYSIS_AZDO_REPO_ALLOWLIST=my-repo,other-repo
+
+# Confluence (optional — shares Atlassian auth with Jira; only space key is new)
+# Space key is the short identifier visible in your Confluence space URL
+CONFLUENCE_SPACE_KEY=MYSPACE
+
+# Notion (optional — its own doc tool, independent of Jira/Confluence)
+# Create an internal integration at https://www.notion.so/my-integrations, then
+# share the pages/databases you want the agent to read with that integration.
+NOTION_TOKEN=ntn_your-notion-integration-token
+# Optional: a root page or database ID used as the default parent for created
+# pages. Notion has no "space key"; search spans whatever the integration is granted.
+NOTION_ROOT_PAGE_ID=
+
+# Voice input (optional — double-tap Space in any text field to dictate)
+# Transcription runs locally & offline via faster-whisper (works with ANY LLM
+# provider, no API key). Install with: uv sync --extra voice
+# (self-contained on macOS/Windows; Linux also needs: apt install libportaudio2).
+# VOICE_MODEL is the local Whisper model size, not a cloud model name.
+# Options: tiny, base (default), small, medium, large-v3 (+ .en variants).
+# Larger = more accurate but slower and a bigger one-time download.
+VOICE_MODEL=base
+
+# On-screen tips
+# Rotating discoverability tips on the welcome screen + inline voice hints.
+# Default on; set to false to hide all tips. Toggle live by pressing "t" on the
+# welcome screen (the choice is saved back here automatically).
+TIPS_ENABLED=true
+
+# Session management
+# Auto-prune sessions older than N days (default 30, set to 0 to disable)
+SESSION_PRUNE_DAYS=30
+
+# Logging
+# Controls the file logger at ~/.yeaboi/logs/tui/yeaboi.log
+# Values: DEBUG, INFO, WARNING (default), ERROR
+# Set to DEBUG to capture full diagnostics for troubleshooting
+LOG_LEVEL=WARNING
+
+# ── Daily Standup mode ─────────────────────────────────────────────────
+# Detects team activity (Jira/AzDO/GitHub/Confluence/local git), computes
+# sprint day + confidence, and delivers a daily summary. Schedule time and
+# delivery-channel selection are configured per-project in the Daily Standup
+# TUI page (stored in SQLite); the values below are the shared secrets/creds.
+#
+# Your display name for your own standup update (default: "Me")
+# STANDUP_USER_NAME=Omar
+#
+# GitHub repo to scan for code activity (owner/repo or full URL)
+# STANDUP_GITHUB_REPO=owner/repo
+#
+# Slack delivery — incoming webhook URL (https://api.slack.com/messaging/webhooks)
+# SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx/yyy/zzz
+#
+# Email delivery — SMTP settings
+# STANDUP_SMTP_HOST=smtp.gmail.com
+# STANDUP_SMTP_PORT=587
+# STANDUP_SMTP_USER=you@example.com
+# STANDUP_SMTP_PASSWORD=your-app-password
+# STANDUP_SMTP_SENDER=you@example.com
+# STANDUP_EMAIL_RECIPIENTS=teammate1@example.com,teammate2@example.com
+
+# ─── Retro mode ─────────────────────────────────────────────────────────────
+# The Retro page starts a small LAN web server so teammates can add cards from a
+# browser. Base port to bind (walks upward if busy). Default: 5173.
+# RETRO_PORT=5173
+#
+# "Share Remotely" opens a public Cloudflare tunnel for off-network teammates.
+# The app auto-downloads cloudflared to ~/.yeaboi/bin/ (no account needed).
+# Set this only to point at an existing cloudflared binary instead.
+# CLOUDFLARED_PATH=/usr/local/bin/cloudflared

yeaboi-2.8.0/.github/workflows/auto-version.yml

@@ -0,0 +1,107 @@
+name: Auto Version Bump
+
+# Classify each PR and, for release-worthy changes, bump the version in
+# pyproject.toml on the PR branch. Merging then triggers publish.yml (which
+# releases whenever the version has no matching tag) — so releases happen with no
+# manual version bump. Cheap deterministic guards run first; the LLM is only asked
+# to choose the semver level when the change actually ships code.
+#
+# The bump lands on the PR *branch* (not main) on purpose: the human merge is what
+# pushes to main and triggers publish.yml. A workflow pushing to main with the
+# default GITHUB_TOKEN would NOT re-trigger publish.yml, so this avoids needing a PAT.
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, labeled]
+    branches: [main]
+
+concurrency:
+  group: auto-version-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  bump:
+    name: Decide & apply version bump
+    # Same-repo PRs only (forks can't push to the head branch or read secrets).
+    if: >
+      github.event.pull_request.head.repo.full_name == github.repository &&
+      github.event.pull_request.state == 'open'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # commit the bump to the PR branch
+      pull-requests: write # post the explanation comment
+      id-token: write # claude-code-action OIDC
+    steps:
+      - name: Checkout PR branch
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
+          fetch-depth: 0
+
+      - name: Deterministic guards
+        id: guard
+        env:
+          GH_TOKEN: ${{ github.token }}
+          BASE_REF: ${{ github.event.pull_request.base.ref }}
+          PR: ${{ github.event.pull_request.number }}
+          LABELS: ${{ join(github.event.pull_request.labels.*.name, ',') }}
+        run: |
+          set -euo pipefail
+          ver() { sed -nE 's/^version = "([^"]+)".*/\1/p' | head -1; }
+          git fetch --no-tags origin "$BASE_REF"
+          BASE_V=$(git show "FETCH_HEAD:pyproject.toml" | ver)
+          HEAD_V=$(ver < pyproject.toml)
+          echo "base=$BASE_V head=$HEAD_V labels=[$LABELS]"
+
+          # 1) Already bumped in this PR (manual, or a prior auto run) -> skip.
+          #    Keeps re-runs on `synchronize` idempotent and respects manual bumps.
+          if [ "$HEAD_V" != "$BASE_V" ]; then
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+            echo "::notice::version already changed in this PR ($BASE_V -> $HEAD_V); skipping."
+            exit 0
+          fi
+
+          # 2) A semver:* / release:skip label forces the LLM step to run.
+          case ",$LABELS," in
+            *,semver:major,*|*,semver:minor,*|*,semver:patch,*|*,semver:none,*|*,release:skip,*)
+              echo "skip=false" >> "$GITHUB_OUTPUT"; exit 0 ;;
+          esac
+
+          # 3) Trivial PR? No shipping code changed -> skip (docs/chore/tests/CI only).
+          if gh pr diff "$PR" --name-only | grep -qE '^src/yeaboi/'; then
+            echo "skip=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+            echo "::notice::no src/yeaboi changes; skipping version bump."
+          fi
+
+      - name: Classify & bump with Claude
+        if: steps.guard.outputs.skip == 'false'
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          claude_args: '--allowedTools "Bash,Read,Edit,Write"'
+          prompt: |
+            You are the release-versioning bot for this repository. Pull request #${{ github.event.pull_request.number }} is open; decide whether and how to bump the project version. The version lives only in pyproject.toml.
+
+            Follow these steps exactly:
+
+            1. Choose a semver level, in this priority order:
+               a. Labels win. If the PR has label `semver:major`, `semver:minor`, or `semver:patch`, use that level. If it has `release:skip` or `semver:none`, treat the level as "none".
+               b. Otherwise classify this PR's diff:
+                  - "major": a backward-incompatible change (removed/renamed CLI flags, changed output formats, breaking behavior or public API).
+                  - "minor": a new user-facing capability or feature.
+                  - "patch": a bug fix, performance, or internal refactor with no new user-facing surface.
+                  - "none": the diff only touches docs, comments, tests, or CI/workflow files.
+
+            2. If the level is "none": do NOT modify any file. Post one short PR comment: "🏷️ auto-version: no release-worthy change — skipping bump." Then stop.
+
+            3. Otherwise run exactly this command (it rewrites pyproject.toml and prints the NEW version):
+                 python scripts/bump_version.py <level>
+               Commit ONLY the pyproject.toml change to this PR branch and push it. Use commit message:
+                 chore: bump version to <new-version> [auto]
+               with trailer:
+                 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+            4. Post one short PR comment naming the level, the new version, and a one-sentence reason.
+
+            Rules: only ever edit pyproject.toml; never bump more than once; keep the comment to one or two lines.

yeaboi-2.8.0/.github/workflows/ci.yml

@@ -0,0 +1,79 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+# Least-privilege token — these jobs only check out code and run tests.
+permissions:
+  contents: read
+
+# Cancel in-progress runs on the same branch when a new push arrives.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # ── Fast gate ────────────────────────────────────────────────────────────
+  # Unit tests — also enforced locally by the pre-commit hook in
+  # .pre-commit-config.yaml. Running them in CI too catches contributors
+  # who haven't installed pre-commit.
+  unit:
+    name: Unit tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev
+      - run: make test-fast
+
+  # ── Slow suite ───────────────────────────────────────────────────────────
+  # Integration + contract tests (marked @pytest.mark.slow) — too slow for
+  # pre-commit but must pass before any PR merges. All external calls are
+  # mocked or VCR-replayed; no real API keys required.
+  integration:
+    name: Integration & contract tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev
+      - run: make test
+
+  # ── Golden evaluators ────────────────────────────────────────────────────
+  # LLM-output quality checks against the golden dataset.
+  # Kept separate so a quality regression doesn't block unrelated PRs.
+  eval:
+    name: Golden evaluators
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev
+      - run: make eval
+
+  # ── Code quality ─────────────────────────────────────────────────────────
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev
+      - run: make lint
+
+  format-check:
+    name: Format check (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev
+      - run: uv run ruff format --check src/ tests/

yeaboi-2.8.0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,48 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review, reopened]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          # Allow bot-initiated runs: auto-version.yml pushes a `chore: bump version`
+          # commit authored by the `claude` bot, whose `synchronize` event would
+          # otherwise be rejected ("Workflow initiated by non-human actor"). '*'
+          # permits any bot; narrow to 'claude' if you want only the version bumper.
+          allowed_bots: '*'
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options

yeaboi-2.8.0/.github/workflows/claude.yml

@@ -0,0 +1,49 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'

yeaboi-2.8.0/.github/workflows/publish.yml

@@ -0,0 +1,86 @@
+name: Publish to PyPI
+
+# Auto-release on version bump. On every push to main, publish to PyPI *iff* the
+# version in pyproject.toml has no matching git tag yet. So releasing is just:
+# bump `version` in pyproject.toml and merge to main — CI publishes, tags, and
+# cuts a GitHub Release. Normal merges (version unchanged) are a cheap no-op.
+#
+# The workflow filename MUST stay "publish.yml" to keep PyPI's OIDC trusted-
+# publisher configuration valid.
+on:
+  push:
+    branches: [main]
+  workflow_dispatch: {} # allow a manual re-run from the Actions tab
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    name: Check for version bump
+    runs-on: ubuntu-latest
+    outputs:
+      should_release: ${{ steps.v.outputs.should_release }}
+      version: ${{ steps.v.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # need full history + tags to check for an existing release
+      - id: v
+        run: |
+          VERSION=$(grep -m1 -E '^version = ' pyproject.toml | sed -E 's/^version = "([^"]+)".*/\1/')
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          if git rev-parse -q --verify "refs/tags/v$VERSION" >/dev/null; then
+            echo "should_release=false" >> "$GITHUB_OUTPUT"
+            echo "::notice::v$VERSION is already released — nothing to publish."
+          else
+            echo "should_release=true" >> "$GITHUB_OUTPUT"
+            echo "::notice::New version v$VERSION detected — building and publishing."
+          fi
+
+  test:
+    name: Lint & Test
+    needs: check
+    if: needs.check.outputs.should_release == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.12
+      - run: uv sync --extra dev
+      - run: make lint
+      - run: make test
+
+  publish:
+    name: Build & Publish to PyPI
+    needs: [check, test]
+    if: needs.check.outputs.should_release == 'true'
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # PyPI trusted publishing (OIDC)
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.12
+      - run: uv build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true # idempotent: re-runs won't fail if already published
+
+  release:
+    name: Tag & GitHub Release
+    needs: [check, publish]
+    if: needs.check.outputs.should_release == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # create the tag + GitHub Release
+    steps:
+      - uses: actions/checkout@v4
+      - name: Create tag and GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ needs.check.outputs.version }}
+          name: v${{ needs.check.outputs.version }}
+          generate_release_notes: true

yeaboi-2.8.0/.github/workflows/smoke.yml

@@ -0,0 +1,44 @@
+name: Smoke Tests
+
+on:
+  schedule:
+    # Every Monday at 06:00 UTC
+    - cron: "0 6 * * 1"
+  workflow_dispatch: # Allow manual trigger from GitHub UI
+
+# Least-privilege token — this job only checks out code and runs tests.
+# Real API credentials are injected via repository secrets, not GITHUB_TOKEN.
+permissions:
+  contents: read
+
+jobs:
+  smoke:
+    if: false  # Disabled — re-enable when secrets are configured
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev --extra all-providers
+
+      - name: Run smoke tests
+        env:
+          # Jira / Confluence
+          JIRA_BASE_URL: ${{ secrets.JIRA_BASE_URL }}
+          JIRA_EMAIL: ${{ secrets.JIRA_EMAIL }}
+          JIRA_API_TOKEN: ${{ secrets.JIRA_API_TOKEN }}
+          JIRA_PROJECT_KEY: ${{ secrets.JIRA_PROJECT_KEY }}
+          CONFLUENCE_SPACE_KEY: ${{ secrets.CONFLUENCE_SPACE_KEY }}
+          # SMOKE_GITHUB_TOKEN: a PAT for broader GitHub access (cross-org calls etc.)
+          # GITHUB_BUILTIN_TOKEN: always has contents:read for this repo; used as
+          # a runtime fallback in conftest.py when the PAT returns 404.
+          GITHUB_TOKEN: ${{ secrets.SMOKE_GITHUB_TOKEN }}
+          GITHUB_BUILTIN_TOKEN: ${{ github.token }}
+          # Azure DevOps
+          AZURE_DEVOPS_TOKEN: ${{ secrets.AZURE_DEVOPS_TOKEN }}
+          AZURE_DEVOPS_SMOKE_REPO_URL: ${{ secrets.AZURE_DEVOPS_SMOKE_REPO_URL }}
+          # LLM providers
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
+        run: make smoke-test

yeaboi-2.8.0/.gitignore

@@ -0,0 +1,62 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+eggs/
+*.whl
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Vector store
+chroma_db/
+
+# LangSmith / LangChain
+.langsmith/
+
+# Distribution
+*.tar.gz
+*.zip
+
+# Jupyter
+.ipynb_checkpoints/
+
+# Generated output
+scrum-plan.*
+scrum-questionnaire.md
+
+# References
+Capacity_Plan_Template.xlsx
+SCRUM.md
+
+# Allow test fixtures (overrides SCRUM.md ignore above)
+!tests/fixtures/SCRUM.md
+!projects/*/SCRUM.md

yeaboi-2.8.0/.pre-commit-config.yaml

@@ -0,0 +1,29 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+        exclude: \.ambr$
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        exclude: ^docs/
+      - id: check-merge-conflict
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.2
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  # Run unit tests before every commit (< 3s, no API keys, no graph compilation).
+  # Integration + contract tests run in CI on every PR — see .github/workflows/ci.yml.
+  - repo: local
+    hooks:
+      - id: unit-tests
+        name: Unit tests
+        language: system
+        entry: uv run pytest tests/unit/ --tb=short -q
+        pass_filenames: false
+        files: \.py$