bob-dev 0.2.3__tar.gz → 0.3.0__tar.gz

{bob_dev-0.2.3/src/bob_dev.egg-info → bob_dev-0.3.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: bob-dev
-Version: 0.2.3
+Version: 0.3.0
 Summary: An AI developer to write code for you
 Author-email: Samuel Pereira dos Santos <samuelsantosdev@gmail.com>
-Requires-Python: >=3.14
+Requires-Python: >=3.12.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: dev
@@ -30,7 +30,7 @@ Given a task ID (Jira or GitLab) it will:
 
 ## Requirements
 
-- Python 3.14+
+- Python 3.12+
 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and available on `$PATH` as `claude`
 - A **Jira Cloud** account with an [API token](https://id.atlassian.com/manage-profile/security/api-tokens) **or** a **GitLab** account with a [personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
 - An [xAI / GROK](https://console.x.ai/) **or** [OpenAI](https://platform.openai.com/) API key

{bob_dev-0.2.3 → bob_dev-0.3.0}/README.md

@@ -17,7 +17,7 @@ Given a task ID (Jira or GitLab) it will:
 
 ## Requirements
 
-- Python 3.14+
+- Python 3.12+
 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and available on `$PATH` as `claude`
 - A **Jira Cloud** account with an [API token](https://id.atlassian.com/manage-profile/security/api-tokens) **or** a **GitLab** account with a [personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
 - An [xAI / GROK](https://console.x.ai/) **or** [OpenAI](https://platform.openai.com/) API key

{bob_dev-0.2.3 → bob_dev-0.3.0}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bob-dev"
-version = "0.2.3"
+version = "0.3.0"
 description = "An AI developer to write code for you"
 readme = "README.md"
 authors = [{ name="Samuel Pereira dos Santos", email="samuelsantosdev@gmail.com" }]
-requires-python = ">=3.14"
+requires-python = ">=3.12.10"
 dependencies = []
 
 [project.scripts]

{bob_dev-0.2.3 → bob_dev-0.3.0}/src/bob_dev/cli.py

@@ -33,7 +33,7 @@ import sys
 import argparse
 import asyncio
 from pathlib import Path
-from time import sleep, time
+from time import sleep
 
 from InquirerPy import inquirer
 from dotenv import load_dotenv
@@ -51,8 +51,7 @@ from .services.terminal import (
 )
 from .services.jira import get_jira_task
 from .services.gitlab import get_gitlab_task
-from .services.claude import read_agents_from_claude
-from .services.llm import analyse_prompt, llm_model, prompt_claude_code
+from .services.llm import analyse_prompt, llm_model, prompt_claude_code, review_prompt
 from .services.project import build_md_context, identify_framework
 from .services.config import check_configuration, update_env_file
 
@@ -64,8 +63,6 @@ SCRIPT_DIR = Path(__file__).resolve().parent
 ENV_PATH = Path.home() / ".bob_dev" / ".env"
 load_dotenv(ENV_PATH)  # Load .env if it exists, but don't require it
 
-OPENAI_API_KEY = os.environ.get("OPENAI_API_KEY", "")
-GROK_API_KEY   = os.environ.get("GROK_API_KEY", "")
 AGENT          = os.environ.get("AGENT", "GROK").upper()   # "GROK" or "OPENAI"
 TASK_MANAGER   = os.environ.get("TASK_MANAGER", "JIRA").upper()  # "JIRA" or "GITLAB"
 
@@ -73,12 +70,18 @@ JIRA_URL       = os.environ.get("JIRA_URL", "")
 JIRA_EMAIL     = os.environ.get("JIRA_EMAIL", "")
 JIRA_API_TOKEN = os.environ.get("JIRA_API_TOKEN", "")
 
+GROK_API_KEY   = os.environ.get("GROK_API_KEY", "")
+OPENAI_API_KEY = os.environ.get("OPENAI_API_KEY", "")
+
 GITLAB_URL       = os.environ.get("GITLAB_URL", "")
 GITLAB_API_TOKEN = os.environ.get("GITLAB_API_TOKEN", "")
 
 REPO_BASE_PATH  = Path("./")   # Overridden by --path at runtime.
 CLAUDE_CODE_CMD = "claude"     # Must be on $PATH.
 
+MAX_FILES = int(os.environ.get("MAX_FILES", 30))
+MAX_CHARS = int(os.environ.get("MAX_CHARS", 40_000))
+MAX_SUMMARY_WORDS = int(os.environ.get("MAX_SUMMARY_WORDS", 2000))
 
 # ---------------------------------------------------------------------------
 # Main entry point
@@ -132,11 +135,11 @@ def main() -> None:
         sys.exit(1)
 
     if agent == "GROK" and not GROK_API_KEY:
-        print_error("GROK_API_KEY is not set. Run `bob-dev --configure`.")
+        print_error("GROK API key is not configured. Run `bob-dev --configure`.")
         sys.exit(1)
 
     if agent == "OPENAI" and not OPENAI_API_KEY:
-        print_error("OPENAI_API_KEY is not set. Run `bob-dev --configure`.")
+        print_error("OpenAI API key is not configured. Run `bob-dev --configure`.")
         sys.exit(1)
 
     # ── Resolve and validate the repository path ─────────────────────────────
@@ -147,9 +150,9 @@ def main() -> None:
         print_error(f"Invalid project path: {REPO_BASE_PATH}")
         sys.exit(1)
 
-    print_info(f"Project path  : {REPO_BASE_PATH}")
-    print_info(f"{TASK_MANAGER} task ID  : {task_id}")
-    print_info(f"LLM backend   : {agent} ({llm_model(agent)})")
+    print_success(f"Project path  : {REPO_BASE_PATH}")
+    print_success(f"{TASK_MANAGER} task ID  : {task_id}")
+    print_success(f"LLM backend   : {agent} ({llm_model(agent)})")
     print()
 
     # ── Step 1 – Fetch task ─────────────────────────────────────────────
@@ -184,7 +187,7 @@ def main() -> None:
 
     # Collect Markdown context (blocking I/O) inside the spinner thread.
     md_context = asyncio.run(run_with_spinner(
-        build_md_context, REPO_BASE_PATH,
+        build_md_context, REPO_BASE_PATH, MAX_SUMMARY_WORDS,
         label="Reading project docs",
     ))
 
@@ -196,58 +199,73 @@ def main() -> None:
         print_warn(str(exc))
         framework = "the project"
 
-    prompt_md = asyncio.run(run_with_spinner(
-        prompt_claude_code,
-        acceptance_criteria, md_context, framework,
-        agent, GROK_API_KEY, OPENAI_API_KEY,
-        label="Generating prompt",
-        task_meta=task,
-    ))
-
-    if not prompt_md.strip():
-        print_error("Failed to generate a prompt for Claude Code.")
-        sys.exit(1)
+    execute_prompt = False
+    while execute_prompt is False:
+        prompt_md = asyncio.run(run_with_spinner(
+            prompt_claude_code,
+            acceptance_criteria, md_context, framework,
+            agent, GROK_API_KEY, OPENAI_API_KEY,
+            label="Generating prompt",
+            task_meta=task,
+        ))
 
-    print_success("Prompt generated.")
-    print()
+        if not prompt_md.strip():
+            print_error("Failed to generate a prompt for Claude Code.")
+            sys.exit(1)
 
-    # ── Step 3 – Analyse the prompt ──────────────────────────────────────────
-    print_step("[3/4]", "Analysing the prompt for issues …")
+        print_success("Prompt generated.")
+        print()
 
-    analysis = asyncio.run(run_with_spinner(
-        analyse_prompt,
-        prompt_md, acceptance_criteria,
-        agent, GROK_API_KEY, OPENAI_API_KEY,
-        label="Analysing prompt",
-    ))
+        # ── Step 3 – Analyse the prompt ──────────────────────────────────────────
+        print_step("[3/4]", "Analysing the prompt for issues …")
 
-    print(f"\n{BOLD}── Prompt Analysis {'─' * 50}{RESET}")
-    for line in analysis.splitlines():
-        print(line)
-        sleep(0.02)  # Simulate a "typing" effect for better readability
-    print("─" * 68 + "\n")
-
-    # ── Confirm before handing off to Claude Code ────────────────────────────
-    answer = input("Proceed to prompt preview? [y/N] ").strip().lower()
-    if answer != "y":
-        prompt_file = SCRIPT_DIR / f"claude_prompt-{task_id}.md"
-        prompt_file.write_text(prompt_md, encoding="utf-8")
-        print_info(f"Aborted. Prompt saved to {prompt_file}")
-        sys.exit(0)
+        analysis = asyncio.run(run_with_spinner(
+            analyse_prompt,
+            prompt_md, acceptance_criteria,
+            agent, GROK_API_KEY, OPENAI_API_KEY,
+            label="Analysing prompt",
+        ))
 
-    print_info("\n\n\nPrompt preview:")
-    print("-" * 68)
-    for line in prompt_md.splitlines():
-        print(line)
-        sleep(0.02)  # Simulate a "typing" effect for better readability
-    print("-" * 68)
-    answer = input("\nAre you sure? This will run the Claude Code CLI with the generated prompt. [y/N] ").strip().lower()
-    if answer != "y":
-        print_info("Aborted by user.")
-        sys.exit(0)
+        print(f"\n{BOLD}── Prompt Analysis {'─' * 50}{RESET}")
+        for line in analysis.splitlines():
+            print(line)
+            sleep(0.02)  # Simulate a "typing" effect for better readability
+        print("─" * 68 + "\n")
+
+        # ── Confirm before handing off to Claude Code ────────────────────────────
+        answer = input("Proceed to prompt preview? [y/N/c] ").strip().lower()
+        if answer == "n":
+            prompt_file = SCRIPT_DIR / f"claude_prompt-{task_id}.md"
+            prompt_file.write_text(prompt_md, encoding="utf-8")
+            print_info(f"Aborted. Prompt saved to {prompt_file}")
+            sys.exit(0)
+        elif answer == "c":
+            answer = input("Write your considerations to change the prompt: ").strip().lower()
+            md_context = review_prompt(acceptance_criteria, md_context, answer, agent, GROK_API_KEY, OPENAI_API_KEY)
+            continue  # Regenerate the prompt with the new context and considerations.
+
+        print("\n\n")
+        print_step("[4/4]", "Passing prompt to Claude Code …")
+        print_success("Prompt preview:")
+        print("-" * 68)
+        for line in prompt_md.splitlines():
+            print(line)
+            sleep(0.02)  # Simulate a "typing" effect for better readability
+        print("-" * 68)
+        answer = input("\nAre you sure? This will run the Claude Code CLI with the generated prompt. [y/N/c] ").strip().lower()
+        if answer == "n":
+            print_info("Aborted by user.")
+            sys.exit(0)
+        elif answer == "c":
+            answer = input("Write your considerations to change the prompt: ").strip().lower()
+            md_context = review_prompt(acceptance_criteria, md_context, answer, agent, GROK_API_KEY, OPENAI_API_KEY)
+            continue  # Regenerate the prompt with the new context and considerations.
+
+        execute_prompt = True
+        break
+            
 
     # ── Step 4 – Pass prompt to Claude Code ──────────────────────────────────
-    print_step("[4/4]", "Passing prompt to Claude Code …")
     print()
     asyncio.run(_pass_to_claude_code(prompt_md, task_id, None))
 

{bob_dev-0.2.3 → bob_dev-0.3.0}/src/bob_dev/services/llm.py

@@ -3,8 +3,9 @@
 LLM integration for bob_dev:
   - Build an OpenAI-compatible client for GROK or OpenAI backends.
   - Return the appropriate model name for a given backend.
-  - Generate a Claude Code prompt from Jira acceptance criteria.
+  - Generate a Claude Code prompt from task acceptance criteria.
   - Analyse a generated prompt for gaps and security concerns.
+  - Regenerate a prompt based on user feedback after analysis.
 """
 
 from __future__ import annotations
@@ -12,26 +13,27 @@ from __future__ import annotations
 import textwrap
 
 from openai import OpenAI
+from openai import OpenAIError
 
 
-# ---------------------------------------------------------------------------
-# Client & model helpers
-# ---------------------------------------------------------------------------
-
 def build_llm_client(agent: str, grok_api_key: str, openai_api_key: str) -> OpenAI:
     """Return an OpenAI-compatible client for *agent* ("GROK" or "OPENAI").
 
     Raises EnvironmentError if the required API key is missing.
+    Raises ConnectionError if the LLM client cannot be created.
     """
-    if agent == "GROK":
-        if not grok_api_key:
-            raise EnvironmentError("GROK_API_KEY is not set in .env")
-        return OpenAI(api_key=grok_api_key, base_url="https://api.x.ai/v1")
+    try:
+        if agent == "GROK":
+            if not grok_api_key:
+                raise EnvironmentError("GROK_API_KEY is not set in .env")
+            return OpenAI(api_key=grok_api_key, base_url="https://api.x.ai/v1")
 
-    # Default: OpenAI
-    if not openai_api_key:
-        raise EnvironmentError("OPENAI_API_KEY is not set in .env")
-    return OpenAI(api_key=openai_api_key)
+        # Default: OpenAI
+        if not openai_api_key:
+            raise EnvironmentError("OPENAI_API_KEY is not set in .env")
+        return OpenAI(api_key=openai_api_key)
+    except OpenAIError as exc:
+        raise ConnectionError(f"Failed to create LLM client for {agent}: {exc}") from exc
 
 
 def llm_model(agent: str) -> str:
@@ -39,10 +41,6 @@ def llm_model(agent: str) -> str:
     return "grok-3" if agent == "GROK" else "gpt-4o"
 
 
-# ---------------------------------------------------------------------------
-# Prompt generation
-# ---------------------------------------------------------------------------
-
 def prompt_claude_code(
     acceptance_criteria: str,
     md_context: str,
@@ -64,8 +62,6 @@ def prompt_claude_code(
         Detected framework name (e.g. "Django REST Framework").
     agent:
         "GROK" or "OPENAI".
-    grok_api_key / openai_api_key:
-        API keys; the unused one may be an empty string.
     task_meta:
         Optional dict with 'task_id', 'title', 'fix_versions' for context.
 
@@ -141,10 +137,6 @@ def prompt_claude_code(
     return response.choices[0].message.content or ""
 
 
-# ---------------------------------------------------------------------------
-# Prompt analysis
-# ---------------------------------------------------------------------------
-
 def analyse_prompt(
     prompt_md: str,
     acceptance_criteria: str,
@@ -154,7 +146,18 @@ def analyse_prompt(
 ) -> str:
     """Ask the LLM to review *prompt_md* for ambiguities and security concerns.
 
-    Returns a short bullet-point analysis string (max ~300 words).
+    Parameters
+    ----------
+    prompt_md:
+        The generated Claude Code prompt in Markdown format.
+    acceptance_criteria:
+        The original acceptance criteria text from Jira.
+    agent:
+        "GROK" or "OPENAI".
+    Returns
+    -------
+    str
+        A concise analysis of the prompt's gaps, ambiguities, and security issues.
     """
     client = build_llm_client(agent, grok_api_key, openai_api_key)
     model  = llm_model(agent)
@@ -185,3 +188,71 @@ def analyse_prompt(
     )
 
     return response.choices[0].message.content or ""
+
+
+def review_prompt(
+    acceptance_criteria: str,
+    md_context: str,
+    considerations: str,
+    agent: str,
+    grok_api_key: str,
+    openai_api_key: str,
+) -> str:
+    """Ask the LLM to regenerate the prompt based on *considerations*.
+
+    This is used when the user wants to refine the prompt after an initial review.
+    
+    Parameters
+    ----------
+    acceptance_criteria:
+        Raw description text from the Jira task.
+    md_context:
+        Pre-built string of project Markdown files + summarised README.
+    considerations:
+        User-provided feedback on what to improve in the prompt.
+    agent:
+        "GROK" or "OPENAI".
+    Returns
+    -------
+    str
+        A new version of the Claude Code prompt, improved according to the feedback.
+    """
+    client = build_llm_client(agent, grok_api_key, openai_api_key)
+    model  = llm_model(agent)
+
+    system_prompt = textwrap.dedent(f"""
+        You are a senior software engineer refining a Claude Code prompt based on feedback.
+        The original prompt had the following issues:
+        {considerations}
+
+        Regenerate the Claude Code prompt, improving it according to the feedback above.
+        Maintain all original requirements and formatting instructions, but address the
+        identified issues to make it more actionable and secure.
+    """).strip()
+
+    user_message = textwrap.dedent(f"""
+        ## Project Documentation
+
+        {md_context}
+
+        ---
+
+        ## Original Acceptance Criteria
+
+        {acceptance_criteria}
+
+        ---
+
+        Regenerate the Claude Code prompt based on the feedback provided.
+    """).strip()
+
+    response = client.chat.completions.create(
+        model=model,
+        messages=[
+            {"role": "system", "content": system_prompt},
+            {"role": "user",   "content": user_message},
+        ],
+        temperature=0.3,
+    )
+
+    return response.choices[0].message.content or ""

{bob_dev-0.2.3 → bob_dev-0.3.0}/src/bob_dev/services/project.py

@@ -23,6 +23,7 @@ def collect_md_context(
     root: Path,
     max_files: int = 30,
     max_chars: int = 40_000,
+    max_words: int = 2000,
 ) -> str:
     """Walk *root* and return concatenated content of Markdown files.
 
@@ -33,6 +34,7 @@ def collect_md_context(
     parts: list[str] = []
     total = 0
 
+    summarize_context = sum(md.stat().st_size for md in md_files) > max_chars
     for md in md_files:
         try:
             text = md.read_text(encoding="utf-8", errors="ignore")
@@ -44,6 +46,9 @@ def collect_md_context(
 
         if total + len(chunk) > max_chars:
             break
+        
+        if summarize_context:
+            chunk = f"### {relative}\n\n" + summarize(text, words=max_words) + "\n\n"
 
         parts.append(chunk)
         total += len(chunk)
@@ -66,14 +71,14 @@ def read_readme(repo_path: Path) -> str:
     return ""
 
 
-def build_md_context(repo_path: Path) -> str:
+def build_md_context(repo_path: Path, max_summary_words: int = 2000) -> str:
     """Build a combined context string for LLM consumption.
 
-    Combines a summarised README (up to 300 words) with the full
+    Combines a summarised README (up to max_summary_words) with the full
     Markdown context collected from the repository.
     """
     readme_raw     = read_readme(repo_path)
-    readme_summary = summarize(readme_raw, words=300) if readme_raw.strip() else ""
+    readme_summary = summarize(readme_raw, words=max_summary_words) if readme_raw.strip() else ""
     md_context     = collect_md_context(repo_path)
 
     return "# README:\n" + readme_summary + "\n\n# Context:\n" + md_context

bob_dev-0.3.0/src/bob_dev/settings.py

@@ -0,0 +1,45 @@
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+def validate_variables():
+    """
+    Validates the environment variables for the application.
+    Raises a ValueError if any required variable is missing or invalid.
+    
+    Required variables:
+  - AGENT: Must be either "GROK" or "OPENAI".
+  - TASK_MANAGER: Must be either "GITLAB" or "JIRA".
+  - For GitLab: GITLAB_URL and GITLAB_API_TOKEN must be set.
+  - For Jira: JIRA_URL, JIRA_EMAIL, and JIRA_API_TOKEN must be set.
+    """
+
+    if AGENT not in ("GROK", "OPENAI"):
+        raise ValueError("AGENT must be either 'GROK' or 'OPENAI'")
+    if TASK_MANAGER not in ("GITLAB", "JIRA"):
+        raise ValueError("TASK_MANAGER must be either 'GITLAB' or 'JIRA'")
+    
+    if TASK_MANAGER == "GITLAB" and (not GITLAB_URL or not GITLAB_API_TOKEN):
+        raise ValueError("GITLAB_URL and GITLAB_API_TOKEN must be set for GitLab task management")
+    if TASK_MANAGER == "JIRA" and (not JIRA_URL or not JIRA_EMAIL or not JIRA_API_TOKEN):
+        raise ValueError("JIRA_URL, JIRA_EMAIL, and JIRA_API_TOKEN must be set for Jira task management")
+
+# LLM backend: GROK (default) or OPENAI
+AGENT        = os.environ.get("AGENT", "GROK").upper()
+TASK_MANAGER = os.environ.get("TASK_MANAGER", "JIRA").upper()
+
+# Grok (xAI)
+GROK_API_KEY = os.environ.get("GROK_API_KEY", "")
+
+# OpenAI (only needed when AGENT=OPENAI)
+OPENAI_API_KEY = os.environ.get("OPENAI_API_KEY", "")
+
+# Jira / Atlassian
+JIRA_URL       = os.environ.get("JIRA_URL", "")
+JIRA_EMAIL     = os.environ.get("JIRA_EMAIL", "")
+JIRA_API_TOKEN = os.environ.get("JIRA_API_TOKEN", "")
+
+# GitLab
+GITLAB_URL       = os.environ.get("GITLAB_URL", "")
+GITLAB_API_TOKEN = os.environ.get("GITLAB_API_TOKEN", "")

{bob_dev-0.2.3 → bob_dev-0.3.0/src/bob_dev.egg-info}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: bob-dev
-Version: 0.2.3
+Version: 0.3.0
 Summary: An AI developer to write code for you
 Author-email: Samuel Pereira dos Santos <samuelsantosdev@gmail.com>
-Requires-Python: >=3.14
+Requires-Python: >=3.12.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: dev
@@ -30,7 +30,7 @@ Given a task ID (Jira or GitLab) it will:
 
 ## Requirements
 
-- Python 3.14+
+- Python 3.12+
 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and available on `$PATH` as `claude`
 - A **Jira Cloud** account with an [API token](https://id.atlassian.com/manage-profile/security/api-tokens) **or** a **GitLab** account with a [personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
 - An [xAI / GROK](https://console.x.ai/) **or** [OpenAI](https://platform.openai.com/) API key

{bob_dev-0.2.3 → bob_dev-0.3.0}/src/bob_dev.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ pyproject.toml
 src/__init__.py
 src/bob_dev/__init__.py
 src/bob_dev/cli.py
+src/bob_dev/settings.py
 src/bob_dev.egg-info/PKG-INFO
 src/bob_dev.egg-info/SOURCES.txt
 src/bob_dev.egg-info/dependency_links.txt

{bob_dev-0.2.3 → bob_dev-0.3.0}/tests/test_cli.py

@@ -3,8 +3,7 @@
 from __future__ import annotations
 
 import sys
-from pathlib import Path
-from unittest.mock import AsyncMock, MagicMock, patch
+from unittest.mock import AsyncMock, patch
 
 import pytest