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

{bob_dev-0.2.3 → bob_dev-0.4.1}/PKG-INFO

@@ -1,11 +1,25 @@
 Metadata-Version: 2.4
 Name: bob-dev
-Version: 0.2.3
+Version: 0.4.1
 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
+Requires-Dist: faiss-cpu>=1.9.0
+Requires-Dist: langchain>=0.3.0
+Requires-Dist: langchain-community>=0.3.0
+Requires-Dist: langchain-openai>=0.2.0
+Requires-Dist: langchain-text-splitters>=0.3.0
+Requires-Dist: openai>=1.50.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: InquirerPy>=0.3.4
+Requires-Dist: pydantic>=2.0
+Requires-Dist: atlassian-python-api>=3.41.0
+Requires-Dist: python-gitlab>=4.4.0
+Requires-Dist: summa>=1.2.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: rich>=13.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
@@ -13,7 +27,7 @@ Dynamic: license-file
 
 # BOB Dev
 
-**BOB Dev** is an AI-powered developer workflow CLI that bridges a task requirements, your codebase, and Claude Code.
+**BOB Dev** is an AI-powered developer workflow CLI that bridges task requirements, your codebase, and Claude Code.
 
 ![BOB-Dev Banner](https://github.com/samuelsantosdev/bob-dev/blob/main/assets/banner.png)
 
@@ -21,16 +35,17 @@ Given a task ID (Jira or GitLab) it will:
 
 1. **Fetch** the task title, description, and fix versions from Jira or GitLab.
 2. **Read** your project's Markdown documentation to build rich LLM context.
-3. **Generate** a precise Claude Code prompt (via GROK or OpenAI), including project-framework context, implementation steps, and test scenarios.
-4. **Analyse** the prompt for ambiguities and security concerns.
-5. **Select** (optionally) a Claude Code agent to run the implementation.
-6. **Execute** the prompt with the Claude Code CLI (optional – you can review first).
+3. **Detect** the project framework (Django, React, FastAPI, Spring Boot, and more).
+4. **Generate** a precise Claude Code prompt (via GROK or OpenAI), including framework context, implementation steps, and test scenarios.
+5. **Analyse** the prompt for ambiguities and security concerns.
+6. **Select** (optionally) a Claude Code agent to run the implementation.
+7. **Execute** the prompt with the Claude Code CLI (optional — you can review and edit first).
 
 ---
 
 ## 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
@@ -53,22 +68,42 @@ Run the interactive setup wizard the first time:
 bob-dev --configure
 ```
 
-This will prompt for your LLM API key, task manager (Jira or GitLab) credentials, and Claude Code API key.
+This prompts for your LLM backend, API key, task manager (Jira or GitLab), and their credentials. All values are saved to `~/.bob_dev/.env`.
 
 ### Environment variables
 
+**Required**
+
+| Variable | Options | Description |
+|----------|---------|-------------|
+| `AGENT` | `GROK` (default) / `OPENAI` | LLM backend |
+| `GROK_API_KEY` | — | xAI / GROK secret key (required if `AGENT=GROK`) |
+| `OPENAI_API_KEY` | — | OpenAI secret key (required if `AGENT=OPENAI`) |
+| `TASK_MANAGER` | `JIRA` (default) / `GITLAB` | Task management system |
+
+**Jira** (`TASK_MANAGER=JIRA`)
+
 | Variable | Description |
 |----------|-------------|
-| `AGENT` | LLM backend: `GROK` (default) or `OPENAI` |
-| `GROK_API_KEY` | xAI / GROK secret key |
-| `OPENAI_API_KEY` | OpenAI secret key |
-| `TASK_MANAGER` | Task manager: `JIRA` (default) or `GITLAB` |
 | `JIRA_URL` | e.g. `https://your-org.atlassian.net` |
 | `JIRA_EMAIL` | Atlassian account e-mail |
 | `JIRA_API_TOKEN` | Atlassian API token |
+
+**GitLab** (`TASK_MANAGER=GITLAB`)
+
+| Variable | Description |
+|----------|-------------|
 | `GITLAB_URL` | e.g. `https://gitlab.com` |
 | `GITLAB_API_TOKEN` | GitLab personal access token |
 
+**Optional**
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MAX_FILES` | `30` | Max number of Markdown files read for project context |
+| `MAX_CHARS` | `40000` | Max characters of Markdown content fed to the LLM |
+| `MAX_SUMMARY_WORDS` | `2000` | Max words when auto-summarising the project README |
+
 ---
 
 ## Usage
@@ -83,9 +118,9 @@ bob-dev --task_id 42 --path /path/to/your/repo
 
 | Flag | Description |
 |------|-------------|
-| `--task_id` | Task ID to process — Jira key (`PROJ-123`) or GitLab issue IID (`42`) |
+| `--task_id` | Task ID — Jira key (`PROJ-123`) or GitLab issue IID (`42`) |
 | `--path` | Path to the target repository (default: current directory) |
-| `--agent` | LLM backend: `GROK` or `OPENAI` (default: value of `AGENT` in `.env`) |
+| `--agent` | LLM backend: `GROK` or `OPENAI` (overrides the `AGENT` env var) |
 | `--configure` | Run the interactive configuration wizard |
 
 ---
@@ -95,6 +130,7 @@ bob-dev --task_id 42 --path /path/to/your/repo
 ```
 src/bob_dev/
 ├── cli.py                  # Entry point & main workflow orchestration
+├── settings.py             # Environment variable loading and validation
 ├── services/
 │   ├── terminal.py         # ANSI colours, print helpers, spinner animation
 │   ├── jira.py             # Jira API connection + ADF-to-text parsing
@@ -105,6 +141,22 @@ src/bob_dev/
 │   └── config.py           # .env management + credential validation
 └── constants/
     └── frameworks.py       # Known framework names used for auto-detection
+
+tests/
+├── test_cli.py
+├── test_config.py
+├── test_jira.py
+├── test_llm.py
+├── test_project.py
+└── test_terminal.py
+```
+
+---
+
+## Running tests
+
+```bash
+pytest tests/
 ```
 
 ---
@@ -115,6 +167,7 @@ src/bob_dev/
 |--------|---------|
 | Red    | Errors that stop execution |
 | Green  | Success messages |
+| Yellow | Warnings |
 | Plain  | Informational / default output |
 
 ---

bob_dev-0.2.3/src/bob_dev.egg-info/PKG-INFO → bob_dev-0.4.1/README.md

@@ -1,19 +1,6 @@
-Metadata-Version: 2.4
-Name: bob-dev
-Version: 0.2.3
-Summary: An AI developer to write code for you
-Author-email: Samuel Pereira dos Santos <samuelsantosdev@gmail.com>
-Requires-Python: >=3.14
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
-Dynamic: license-file
-
 # BOB Dev
 
-**BOB Dev** is an AI-powered developer workflow CLI that bridges a task requirements, your codebase, and Claude Code.
+**BOB Dev** is an AI-powered developer workflow CLI that bridges task requirements, your codebase, and Claude Code.
 
 ![BOB-Dev Banner](https://github.com/samuelsantosdev/bob-dev/blob/main/assets/banner.png)
 
@@ -21,16 +8,17 @@ Given a task ID (Jira or GitLab) it will:
 
 1. **Fetch** the task title, description, and fix versions from Jira or GitLab.
 2. **Read** your project's Markdown documentation to build rich LLM context.
-3. **Generate** a precise Claude Code prompt (via GROK or OpenAI), including project-framework context, implementation steps, and test scenarios.
-4. **Analyse** the prompt for ambiguities and security concerns.
-5. **Select** (optionally) a Claude Code agent to run the implementation.
-6. **Execute** the prompt with the Claude Code CLI (optional – you can review first).
+3. **Detect** the project framework (Django, React, FastAPI, Spring Boot, and more).
+4. **Generate** a precise Claude Code prompt (via GROK or OpenAI), including framework context, implementation steps, and test scenarios.
+5. **Analyse** the prompt for ambiguities and security concerns.
+6. **Select** (optionally) a Claude Code agent to run the implementation.
+7. **Execute** the prompt with the Claude Code CLI (optional — you can review and edit first).
 
 ---
 
 ## 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
@@ -53,22 +41,42 @@ Run the interactive setup wizard the first time:
 bob-dev --configure
 ```
 
-This will prompt for your LLM API key, task manager (Jira or GitLab) credentials, and Claude Code API key.
+This prompts for your LLM backend, API key, task manager (Jira or GitLab), and their credentials. All values are saved to `~/.bob_dev/.env`.
 
 ### Environment variables
 
+**Required**
+
+| Variable | Options | Description |
+|----------|---------|-------------|
+| `AGENT` | `GROK` (default) / `OPENAI` | LLM backend |
+| `GROK_API_KEY` | — | xAI / GROK secret key (required if `AGENT=GROK`) |
+| `OPENAI_API_KEY` | — | OpenAI secret key (required if `AGENT=OPENAI`) |
+| `TASK_MANAGER` | `JIRA` (default) / `GITLAB` | Task management system |
+
+**Jira** (`TASK_MANAGER=JIRA`)
+
 | Variable | Description |
 |----------|-------------|
-| `AGENT` | LLM backend: `GROK` (default) or `OPENAI` |
-| `GROK_API_KEY` | xAI / GROK secret key |
-| `OPENAI_API_KEY` | OpenAI secret key |
-| `TASK_MANAGER` | Task manager: `JIRA` (default) or `GITLAB` |
 | `JIRA_URL` | e.g. `https://your-org.atlassian.net` |
 | `JIRA_EMAIL` | Atlassian account e-mail |
 | `JIRA_API_TOKEN` | Atlassian API token |
+
+**GitLab** (`TASK_MANAGER=GITLAB`)
+
+| Variable | Description |
+|----------|-------------|
 | `GITLAB_URL` | e.g. `https://gitlab.com` |
 | `GITLAB_API_TOKEN` | GitLab personal access token |
 
+**Optional**
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MAX_FILES` | `30` | Max number of Markdown files read for project context |
+| `MAX_CHARS` | `40000` | Max characters of Markdown content fed to the LLM |
+| `MAX_SUMMARY_WORDS` | `2000` | Max words when auto-summarising the project README |
+
 ---
 
 ## Usage
@@ -83,9 +91,9 @@ bob-dev --task_id 42 --path /path/to/your/repo
 
 | Flag | Description |
 |------|-------------|
-| `--task_id` | Task ID to process — Jira key (`PROJ-123`) or GitLab issue IID (`42`) |
+| `--task_id` | Task ID — Jira key (`PROJ-123`) or GitLab issue IID (`42`) |
 | `--path` | Path to the target repository (default: current directory) |
-| `--agent` | LLM backend: `GROK` or `OPENAI` (default: value of `AGENT` in `.env`) |
+| `--agent` | LLM backend: `GROK` or `OPENAI` (overrides the `AGENT` env var) |
 | `--configure` | Run the interactive configuration wizard |
 
 ---
@@ -95,6 +103,7 @@ bob-dev --task_id 42 --path /path/to/your/repo
 ```
 src/bob_dev/
 ├── cli.py                  # Entry point & main workflow orchestration
+├── settings.py             # Environment variable loading and validation
 ├── services/
 │   ├── terminal.py         # ANSI colours, print helpers, spinner animation
 │   ├── jira.py             # Jira API connection + ADF-to-text parsing
@@ -105,6 +114,22 @@ src/bob_dev/
 │   └── config.py           # .env management + credential validation
 └── constants/
     └── frameworks.py       # Known framework names used for auto-detection
+
+tests/
+├── test_cli.py
+├── test_config.py
+├── test_jira.py
+├── test_llm.py
+├── test_project.py
+└── test_terminal.py
+```
+
+---
+
+## Running tests
+
+```bash
+pytest tests/
 ```
 
 ---
@@ -115,6 +140,7 @@ src/bob_dev/
 |--------|---------|
 | Red    | Errors that stop execution |
 | Green  | Success messages |
+| Yellow | Warnings |
 | Plain  | Informational / default output |
 
 ---

bob_dev-0.4.1/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bob-dev"
+version = "0.4.1"
+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.12.10"
+dependencies = [
+    "faiss-cpu>=1.9.0",
+    "langchain>=0.3.0",
+    "langchain-community>=0.3.0",
+    "langchain-openai>=0.2.0",
+    "langchain-text-splitters>=0.3.0",
+    "openai>=1.50.0",
+    "python-dotenv>=1.0.0",
+    "InquirerPy>=0.3.4",
+    "pydantic>=2.0",
+    "atlassian-python-api>=3.41.0",
+    "python-gitlab>=4.4.0",
+    "summa>=1.2.0",
+    "beautifulsoup4>=4.12.0",
+    "rich>=13.0.0",
+]
+
+[project.scripts]
+bob-dev = "bob_dev.cli:main"
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-asyncio>=0.23"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+filterwarnings = [
+    "ignore:.*langchain-community.*:DeprecationWarning",
+]