commitcraft-cli 0.1.0__tar.gz

commitcraft_cli-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check commitcraft/ tests/
+
+      - name: Test
+        run: pytest tests/ -v --cov=commitcraft --cov-report=term-missing

commitcraft_cli-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.pyc
+*.pyo
+.pytest_cache/
+.ruff_cache/
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+.env
+*.log
+.coverage
+htmlcov/

commitcraft_cli-0.1.0/.superpowers/sdd/.gitignore

@@ -0,0 +1 @@
+*

commitcraft_cli-0.1.0/.superpowers/sdd/progress.md

@@ -0,0 +1,39 @@
+# commitcraft — SDD Progress Ledger
+
+Plan: docs/superpowers/plans/2026-06-30-commitcraft.md
+
+## Tasks
+
+- [x] Task 1: Project Scaffolding
+- [x] Task 2: Git Diff Parser
+- [x] Task 3: File Filters
+- [x] Task 4: Complexity Classifier
+- [x] Task 5: Rule Engine
+- [x] Task 6: Provider ABC + Config Models
+- [x] Task 7: Ollama Provider
+- [x] Task 8: Anthropic, OpenAI, Gemini Providers
+- [x] Task 9: Config Store + Provider Factory + Setup Wizard
+- [x] Task 10: Context Builder
+- [x] Task 11: Commit Generator + Full `commitcraft commit` Command
+- [x] Task 12: PR Description Generator
+- [x] Task 13: Release Notes Generator
+- [x] Task 14: History Analyzer
+- [x] Task 15: README, CONTRIBUTING, Provider Docs, CI
+
+## Completed Tasks
+
+Task 1: complete (commits 4b825dc..e0ac712, review clean)
+Task 2: complete (commits e0ac712..5ebae75, review clean; minor: inline regex comments, import inside fn body)
+Task 3: complete (commits 5ebae75..791fe7b, review clean)
+Task 4: complete (commits 791fe7b..2ecf6ef, fix round: added type annotations to helpers)
+Task 5: complete (commits 2ecf6ef..ba368ce, review clean; Phase 1 done: 39/39 tests)
+Task 6: complete (commits ba368ce..1d0a3e5, review clean)
+Task 7: complete (commits 1d0a3e5..59992b8, review clean)
+Task 8: complete (commits 59992b8..ec92295, review clean)
+Task 9: complete (commits ec92295..30a7e6e, fix: removed unused Confirm import; 54/54 tests)
+Task 10: complete (commits 30a7e6e..f4f700d, review clean)
+Task 11: complete (commits f4f700d..805556e, fix round: removed dead classify block + pycache; 65/65)
+Task 12: complete (commits 805556e..7c6089c, review clean)
+Task 13: complete (commits 7c6089c..fa0a2f9, review clean)
+Task 14: complete (commits fa0a2f9..98fd4b8, review clean)
+Task 15: complete (commits 98fd4b8..4c64c74, ruff fixed 55 pre-existing issues; review clean)

commitcraft_cli-0.1.0/.superpowers/sdd/review-1d0a3e5..59992b8.diff

@@ -0,0 +1,141 @@
+# Review package: 1d0a3e5..HEAD
+
+## Commits
+59992b8 feat: implement Ollama provider with commit/PR/release-notes generation
+
+## Files changed
+ commitcraft/providers/ollama_provider.py | 60 ++++++++++++++++++++++++++++++++
+ tests/test_providers.py                  | 58 ++++++++++++++++++++++++++++++
+ 2 files changed, 118 insertions(+)
+
+## Diff
+diff --git a/commitcraft/providers/ollama_provider.py b/commitcraft/providers/ollama_provider.py
+new file mode 100644
+index 0000000..3e69a91
+--- /dev/null
++++ b/commitcraft/providers/ollama_provider.py
+@@ -0,0 +1,60 @@
++import httpx
++from commitcraft.config.models import CommitcraftConfig
++from commitcraft.providers.base import Provider
++
++_COMMIT_SYSTEM = (
++    "You are an expert at writing conventional commit messages. "
++    "Given a summary of code changes, write a single conventional commit message. "
++    "Format: <type>(<optional scope>): <description>. "
++    "Types: feat, fix, docs, style, refactor, test, chore, perf, ci, build. "
++    "Output ONLY the commit message — no explanation, no markdown, no quotes."
++)
++
++_PR_SYSTEM = (
++    "You are an expert at writing GitHub pull request descriptions. "
++    "Given a summary of code changes, write a clear PR description in markdown with: "
++    "a '## Summary' section (3-5 bullet points) and a '## Changes' section. "
++    "Be concise and factual."
++)
++
++_RELEASE_SYSTEM = (
++    "You are an expert at writing software release notes. "
++    "Given a list of commits or change summaries, produce structured release notes "
++    "grouped by: Features, Bug Fixes, Documentation, Other. Use markdown."
++)
++
++
++class OllamaProvider(Provider):
++    def __init__(self, config: CommitcraftConfig) -> None:
++        self._config = config
++        self._base_url = config.ollama_base_url
++        self._model = config.ollama_model
++
++    @property
++    def name(self) -> str:
++        return "ollama"
++
++    def _generate(self, system: str, prompt: str) -> str:
++        response = httpx.post(
++            f"{self._base_url}/api/generate",
++            json={"model": self._model, "system": system, "prompt": prompt, "stream": False},
++            timeout=60.0,
++        )
++        response.raise_for_status()
++        return response.json()["response"].strip()
++
++    def generate_commit_message(self, context: str) -> str:
++        return self._generate(_COMMIT_SYSTEM, context)
++
++    def generate_pr_description(self, context: str) -> str:
++        return self._generate(_PR_SYSTEM, context)
++
++    def generate_release_notes(self, context: str) -> str:
++        return self._generate(_RELEASE_SYSTEM, context)
++
++    def health_check(self) -> bool:
++        try:
++            httpx.get(f"{self._base_url}/api/tags", timeout=5.0).raise_for_status()
++            return True
++        except Exception:
++            return False
+diff --git a/tests/test_providers.py b/tests/test_providers.py
+new file mode 100644
+index 0000000..05045e6
+--- /dev/null
++++ b/tests/test_providers.py
+@@ -0,0 +1,58 @@
++import pytest
++from unittest.mock import patch, MagicMock
++from commitcraft.config.models import CommitcraftConfig, ProviderName
++from commitcraft.providers.ollama_provider import OllamaProvider
++
++
++@pytest.fixture
++def config():
++    return CommitcraftConfig(
++        provider=ProviderName.OLLAMA,
++        ollama_model="llama3.2",
++        ollama_base_url="http://localhost:11434",
++    )
++
++
++def test_ollama_provider_name(config):
++    p = OllamaProvider(config)
++    assert p.name == "ollama"
++
++
++def test_ollama_generate_commit_message(config):
++    mock_response = MagicMock()
++    mock_response.json.return_value = {"response": "feat: add user authentication"}
++    mock_response.raise_for_status = MagicMock()
++
++    with patch("httpx.post", return_value=mock_response) as mock_post:
++        p = OllamaProvider(config)
++        result = p.generate_commit_message("context: added login function")
++        assert result == "feat: add user authentication"
++        mock_post.assert_called_once()
++        call_args = mock_post.call_args
++        assert "llama3.2" in str(call_args)
++
++
++def test_ollama_generate_pr_description(config):
++    mock_response = MagicMock()
++    mock_response.json.return_value = {"response": "## Summary\n- Added auth"}
++    mock_response.raise_for_status = MagicMock()
++
++    with patch("httpx.post", return_value=mock_response):
++        p = OllamaProvider(config)
++        result = p.generate_pr_description("branch diff context")
++        assert "Summary" in result
++
++
++def test_ollama_health_check_success(config):
++    mock_response = MagicMock()
++    mock_response.raise_for_status = MagicMock()
++
++    with patch("httpx.get", return_value=mock_response):
++        p = OllamaProvider(config)
++        assert p.health_check() is True
++
++
++def test_ollama_health_check_failure(config):
++    with patch("httpx.get", side_effect=Exception("Connection refused")):
++        p = OllamaProvider(config)
++        assert p.health_check() is False

commitcraft_cli-0.1.0/.superpowers/sdd/review-2ecf6ef..ba368ce.diff

@@ -0,0 +1,211 @@
+# Review package: 2ecf6ef..HEAD
+
+## Commits
+ba368ce feat: implement rule engine for zero-AI commit message generation
+
+## Files changed
+ commitcraft/analysis/rule_engine.py | 91 ++++++++++++++++++++++++++++++++++
+ tests/test_rule_engine.py           | 97 +++++++++++++++++++++++++++++++++++++
+ 2 files changed, 188 insertions(+)
+
+## Diff
+diff --git a/commitcraft/analysis/rule_engine.py b/commitcraft/analysis/rule_engine.py
+new file mode 100644
+index 0000000..a521dfc
+--- /dev/null
++++ b/commitcraft/analysis/rule_engine.py
+@@ -0,0 +1,91 @@
++from dataclasses import dataclass
++from pathlib import Path
++from commitcraft.analysis.filters import FilteredDiff
++
++LOCKFILE_NAMES = {
++    "package-lock.json", "yarn.lock", "poetry.lock",
++    "Pipfile.lock", "composer.lock", "Gemfile.lock", "pnpm-lock.yaml",
++}
++
++DEPENDENCY_MANIFESTS = {
++    "requirements.txt", "requirements-dev.txt", "setup.cfg",
++    "package.json", "Pipfile", "pyproject.toml",
++}
++
++CONFIG_PATTERNS = {".yml", ".yaml", ".json", ".toml", ".ini", ".cfg", ".env"}
++CONFIG_DIRS = {".github", ".circleci", ".gitlab", "config", ".husky"}
++
++
++@dataclass
++class RuleResult:
++    matched: bool
++    message: str | None
++    rule_name: str | None
++
++
++def _all_paths(filtered: FilteredDiff) -> list[str]:
++    return [f.path for f in filtered.files]
++
++
++def _readme_only(paths: list[str]) -> RuleResult | None:
++    if len(paths) == 1 and Path(paths[0]).name.upper().startswith("README"):
++        return RuleResult(matched=True, message="docs: update README", rule_name="readme_only")
++    return None
++
++
++def _lockfile_only(paths: list[str]) -> RuleResult | None:
++    if all(Path(p).name in LOCKFILE_NAMES for p in paths):
++        return RuleResult(matched=True, message="chore: update lockfile", rule_name="lockfile_only")
++    return None
++
++
++def _dependency_bump(paths: list[str]) -> RuleResult | None:
++    if all(Path(p).name in DEPENDENCY_MANIFESTS for p in paths):
++        return RuleResult(matched=True, message="chore: bump dependencies", rule_name="dependency_bump")
++    return None
++
++
++def _docs_only(paths: list[str]) -> RuleResult | None:
++    doc_exts = {".md", ".rst", ".txt"}
++    doc_dirs = {"docs", "doc", "documentation"}
++    if all(
++        Path(p).suffix.lower() in doc_exts or Path(p).parts[0].lower() in doc_dirs
++        for p in paths
++    ):
++        return RuleResult(matched=True, message="docs: update documentation", rule_name="docs_only")
++    return None
++
++
++def _single_test_file(paths: list[str]) -> RuleResult | None:
++    if len(paths) == 1 and "test" in paths[0].lower():
++        name = Path(paths[0]).stem
++        return RuleResult(matched=True, message=f"test: add tests for {name}", rule_name="single_test_file")
++    return None
++
++
++def _config_only(paths: list[str]) -> RuleResult | None:
++    def is_config(p: str) -> bool:
++        parts = Path(p).parts
++        return (
++            Path(p).suffix.lower() in CONFIG_PATTERNS
++            and (parts[0] in CONFIG_DIRS or not any("src" in part or "lib" in part for part in parts))
++        )
++    if paths and all(is_config(p) for p in paths):
++        return RuleResult(matched=True, message="chore: update config", rule_name="config_only")
++    return None
++
++
++_RULES = [_readme_only, _lockfile_only, _dependency_bump, _docs_only, _single_test_file, _config_only]
++
++
++def apply_rules(filtered: FilteredDiff) -> RuleResult:
++    if not filtered.files:
++        return RuleResult(matched=False, message=None, rule_name=None)
++
++    paths = _all_paths(filtered)
++    for rule in _RULES:
++        result = rule(paths)
++        if result is not None:
++            return result
++
++    return RuleResult(matched=False, message=None, rule_name=None)
+diff --git a/tests/test_rule_engine.py b/tests/test_rule_engine.py
+new file mode 100644
+index 0000000..f8ec227
+--- /dev/null
++++ b/tests/test_rule_engine.py
+@@ -0,0 +1,97 @@
++import pytest
++from commitcraft.git.diff_parser import DiffFile
++from commitcraft.analysis.filters import FilteredDiff
++from commitcraft.analysis.rule_engine import apply_rules, RuleResult
++
++
++def _file(path: str, added: int = 3, removed: int = 1) -> DiffFile:
++    return DiffFile(
++        path=path, file_type="text", is_new=False, is_deleted=False,
++        added_lines=added, removed_lines=removed, raw_hunks="",
++        has_function_changes=False, has_class_changes=False,
++    )
++
++
++def _diff(*files: DiffFile) -> FilteredDiff:
++    return FilteredDiff(
++        files=list(files),
++        total_added=sum(f.added_lines for f in files),
++        total_removed=sum(f.removed_lines for f in files),
++    )
++
++
++def test_readme_only_matches():
++    result = apply_rules(_diff(_file("README.md")))
++    assert result.matched is True
++    assert result.message == "docs: update README"
++    assert result.rule_name == "readme_only"
++
++
++def test_lockfile_package_lock_matches():
++    result = apply_rules(_diff(_file("package-lock.json")))
++    assert result.matched is True
++    assert "chore" in result.message
++    assert result.rule_name == "lockfile_only"
++
++
++def test_lockfile_poetry_lock_matches():
++    result = apply_rules(_diff(_file("poetry.lock")))
++    assert result.matched is True
++    assert result.rule_name == "lockfile_only"
++
++
++def test_lockfile_yarn_lock_matches():
++    result = apply_rules(_diff(_file("yarn.lock")))
++    assert result.matched is True
++    assert result.rule_name == "lockfile_only"
++
++
++def test_requirements_txt_matches_dependency_bump():
++    result = apply_rules(_diff(_file("requirements.txt")))
++    assert result.matched is True
++    assert result.message == "chore: bump dependencies"
++    assert result.rule_name == "dependency_bump"
++
++
++def test_package_json_without_lock_matches_dependency_bump():
++    result = apply_rules(_diff(_file("package.json")))
++    assert result.matched is True
++    assert result.rule_name == "dependency_bump"
++
++
++def test_docs_directory_only():
++    result = apply_rules(_diff(_file("docs/guide.md"), _file("docs/api.md")))
++    assert result.matched is True
++    assert result.message == "docs: update documentation"
++    assert result.rule_name == "docs_only"
++
++
++def test_single_test_file_only():
++    f = _file("tests/test_utils.py")
++    result = apply_rules(_diff(f))
++    assert result.matched is True
++    assert "test" in result.message.lower()
++    assert result.rule_name == "single_test_file"
++
++
++def test_config_file_only():
++    result = apply_rules(_diff(_file(".github/workflows/ci.yml")))
++    assert result.matched is True
++    assert result.rule_name == "config_only"
++
++
++def test_complex_change_no_match():
++    result = apply_rules(_diff(_file("src/auth.py"), _file("src/db.py"), _file("tests/test_auth.py")))
++    assert result.matched is False
++    assert result.message is None
++    assert result.rule_name is None
++
++
++def test_mixed_readme_and_source_no_match():
++    result = apply_rules(_diff(_file("README.md"), _file("src/main.py")))
++    assert result.matched is False
++
++
++def test_result_is_rulesresult_type():
++    result = apply_rules(_diff(_file("README.md")))
++    assert isinstance(result, RuleResult)

commitcraft_cli-0.1.0/.superpowers/sdd/review-305ed0e..e0ac712.diff

@@ -0,0 +1,8 @@
+# Review package: 305ed0e..HEAD
+
+## Commits
+e0ac712 chore: scaffold commitcraft project with stubbed CLI commands
+
+## Files changed
+
+## Diff

commitcraft_cli-0.1.0/.superpowers/sdd/review-30a7e6e..f4f700d.diff

@@ -0,0 +1,172 @@
+# Review package: 30a7e6e..HEAD
+
+## Commits
+f4f700d feat: context builder produces condensed LLM prompts from filtered diff
+
+## Files changed
+ commitcraft/context/__init__.py                    |   0
+ .../context/__pycache__/__init__.cpython-312.pyc   | Bin 0 -> 152 bytes
+ .../context/__pycache__/builder.cpython-312.pyc    | Bin 0 -> 3321 bytes
+ commitcraft/context/builder.py                     |  52 ++++++++++++++++++
+ commitcraft/utils/__init__.py                      |   0
+ .../utils/__pycache__/__init__.cpython-312.pyc     | Bin 0 -> 150 bytes
+ .../__pycache__/token_estimator.cpython-312.pyc    | Bin 0 -> 396 bytes
+ commitcraft/utils/token_estimator.py               |   3 ++
+ tests/test_context_builder.py                      |  59 +++++++++++++++++++++
+ 9 files changed, 114 insertions(+)
+
+## Diff
+diff --git a/commitcraft/context/__init__.py b/commitcraft/context/__init__.py
+new file mode 100644
+index 0000000..e69de29
+diff --git a/commitcraft/context/__pycache__/__init__.cpython-312.pyc b/commitcraft/context/__pycache__/__init__.cpython-312.pyc
+new file mode 100644
+index 0000000..fd5bf45
+Binary files /dev/null and b/commitcraft/context/__pycache__/__init__.cpython-312.pyc differ
+diff --git a/commitcraft/context/__pycache__/builder.cpython-312.pyc b/commitcraft/context/__pycache__/builder.cpython-312.pyc
+new file mode 100644
+index 0000000..8f9985d
+Binary files /dev/null and b/commitcraft/context/__pycache__/builder.cpython-312.pyc differ
+diff --git a/commitcraft/context/builder.py b/commitcraft/context/builder.py
+new file mode 100644
+index 0000000..4a61ff6
+--- /dev/null
++++ b/commitcraft/context/builder.py
+@@ -0,0 +1,52 @@
++from commitcraft.analysis.filters import FilteredDiff
++
++
++def build_commit_context(filtered: FilteredDiff, recent_commits: list[str]) -> str:
++    lines: list[str] = []
++
++    lines.append("=== Changed Files ===")
++    for f in filtered.files:
++        markers = []
++        if f.is_new:
++            markers.append("NEW")
++        if f.is_deleted:
++            markers.append("DELETED")
++        if f.has_function_changes:
++            markers.append("has function/def changes")
++        if f.has_class_changes:
++            markers.append("has class changes")
++        marker_str = f" [{', '.join(markers)}]" if markers else ""
++        lines.append(f"  {f.path} (+{f.added_lines}/-{f.removed_lines}){marker_str}")
++
++    lines.append(f"\nTotal: +{filtered.total_added}/-{filtered.total_removed} lines across {len(filtered.files)} file(s)")
++
++    if recent_commits:
++        lines.append("\n=== Recent Commit Style (follow this format) ===")
++        for c in recent_commits[:5]:
++            lines.append(f"  {c}")
++
++    lines.append("\n=== Task ===")
++    lines.append("Write a single conventional commit message for the changes above.")
++    lines.append("Output ONLY the commit message. No explanation.")
++
++    return "\n".join(lines)
++
++
++def build_pr_context(branch_diff: str, branch_name: str, recent_commits: list[str]) -> str:
++    lines: list[str] = []
++    lines.append(f"Branch: {branch_name}")
++    lines.append(f"\nRecent commits on this branch:")
++    for c in recent_commits[:10]:
++        lines.append(f"  {c}")
++    lines.append("\n=== Task ===")
++    lines.append("Write a GitHub PR description for this branch. Use markdown with ## Summary and ## Changes sections.")
++    return "\n".join(lines)
++
++
++def build_release_context(tag_diff: str, tag_range: str) -> str:
++    lines: list[str] = [
++        f"Release range: {tag_range}",
++        "\n=== Task ===",
++        "Write structured release notes grouped by: Features, Bug Fixes, Documentation, Other. Use markdown.",
++    ]
++    return "\n".join(lines)
+diff --git a/commitcraft/utils/__init__.py b/commitcraft/utils/__init__.py
+new file mode 100644
+index 0000000..e69de29
+diff --git a/commitcraft/utils/__pycache__/__init__.cpython-312.pyc b/commitcraft/utils/__pycache__/__init__.cpython-312.pyc
+new file mode 100644
+index 0000000..3c18b7b
+Binary files /dev/null and b/commitcraft/utils/__pycache__/__init__.cpython-312.pyc differ
+diff --git a/commitcraft/utils/__pycache__/token_estimator.cpython-312.pyc b/commitcraft/utils/__pycache__/token_estimator.cpython-312.pyc
+new file mode 100644
+index 0000000..444a5ab
+Binary files /dev/null and b/commitcraft/utils/__pycache__/token_estimator.cpython-312.pyc differ
+diff --git a/commitcraft/utils/token_estimator.py b/commitcraft/utils/token_estimator.py
+new file mode 100644
+index 0000000..edafb04
+--- /dev/null
++++ b/commitcraft/utils/token_estimator.py
+@@ -0,0 +1,3 @@
++def estimate_tokens(text: str) -> int:
++    # Rough approximation: 1 token ≈ 4 characters (widely used heuristic)
++    return max(1, len(text) // 4)
+diff --git a/tests/test_context_builder.py b/tests/test_context_builder.py
+new file mode 100644
+index 0000000..f30177a
+--- /dev/null
++++ b/tests/test_context_builder.py
+@@ -0,0 +1,59 @@
++import pytest
++from commitcraft.git.diff_parser import DiffFile
++from commitcraft.analysis.filters import FilteredDiff
++from commitcraft.context.builder import build_commit_context, build_pr_context
++from commitcraft.utils.token_estimator import estimate_tokens
++
++
++def _file(path: str, added: int = 10, removed: int = 3, has_func: bool = False) -> DiffFile:
++    return DiffFile(
++        path=path, file_type="python", is_new=False, is_deleted=False,
++        added_lines=added, removed_lines=removed, raw_hunks=f"@@ hunk for {path} @@\n+new line",
++        has_function_changes=has_func, has_class_changes=False,
++    )
++
++
++def test_commit_context_contains_file_list():
++    diff = FilteredDiff(
++        files=[_file("src/auth.py"), _file("tests/test_auth.py")],
++        total_added=20, total_removed=6,
++    )
++    ctx = build_commit_context(diff, recent_commits=["feat: add login", "fix: fix typo"])
++    assert "src/auth.py" in ctx
++    assert "tests/test_auth.py" in ctx
++
++
++def test_commit_context_contains_line_counts():
++    diff = FilteredDiff(files=[_file("src/a.py", added=15, removed=3)], total_added=15, total_removed=3)
++    ctx = build_commit_context(diff, recent_commits=[])
++    assert "15" in ctx or "+15" in ctx
++
++
++def test_commit_context_mentions_function_changes():
++    diff = FilteredDiff(files=[_file("src/a.py", has_func=True)], total_added=10, total_removed=0)
++    ctx = build_commit_context(diff, recent_commits=[])
++    assert "function" in ctx.lower() or "def" in ctx.lower()
++
++
++def test_commit_context_includes_recent_commit_style():
++    recent = ["feat: add authentication", "fix: resolve login bug"]
++    diff = FilteredDiff(files=[_file("src/a.py")], total_added=5, total_removed=0)
++    ctx = build_commit_context(diff, recent_commits=recent)
++    assert "feat: add authentication" in ctx
++
++
++def test_commit_context_is_short():
++    diff = FilteredDiff(files=[_file("src/a.py", added=500)], total_added=500, total_removed=0)
++    ctx = build_commit_context(diff, recent_commits=[])
++    assert estimate_tokens(ctx) < 800
++
++
++def test_pr_context_contains_branch_name():
++    ctx = build_pr_context("diff content", "feature/add-auth", ["feat: add auth"])
++    assert "feature/add-auth" in ctx or "add-auth" in ctx
++
++
++def test_estimate_tokens_rough():
++    text = "hello world " * 100  # 200 words ~ 300 tokens
++    tokens = estimate_tokens(text)
++    assert 150 < tokens < 500