devobin 1.0.0__py3-none-any.whl

devobin-1.0.0.dist-info/METADATA

@@ -0,0 +1,364 @@
+Metadata-Version: 2.4
+Name: devobin
+Version: 1.0.0
+Summary: AI Engineering Context Compiler and Prompt Architect CLI — reads your code, builds the perfect prompt
+Project-URL: Homepage, https://github.com/mobinhasanghasemi/devobin
+Project-URL: Repository, https://github.com/mobinhasanghasemi/devobin
+Project-URL: Issues, https://github.com/mobinhasanghasemi/devobin/issues
+Author-email: Mobin Hasanghasemi <mobin@devobin.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,claude,cli,codex,coding-agent,context-compilation,cursor,developer-tools,prompt-engineering
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.12
+Requires-Dist: aiofiles>=23.2.0
+Requires-Dist: anthropic>=0.18.0
+Requires-Dist: arabic-reshaper>=3.0.0
+Requires-Dist: google-genai>=1.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: openai>=1.10.0
+Requires-Dist: platformdirs>=4.2.0
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: python-bidi>=0.6.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: textual>=0.40.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.2.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<div dir="ltr">
+
+# DevObin AI
+
+> **AI Engineering Context Compiler & Prompt Architect**
+
+DevObin is a CLI-based prompt engineering system that autonomously reads your project code and produces customized engineering prompts for AI coding agents. It does NOT write code — it crafts the perfect prompt so Codex, Claude, Cursor, or any AI agent builds exactly what you need.
+
+---
+
+## What DevObin Does
+
+```
+You: "Add caching to my provider calls"
+   │
+   ▼
+DevObin scans your project → reads your actual code → understands your architecture
+   │
+   ▼
+DevObin writes: caching_feature_prompt.md  (in your directory)
+   │
+   ▼
+Give the file to Codex/Claude/Cursor → they implement it perfectly
+```
+
+**Key difference:** DevObin reads YOUR code and produces a prompt based on YOUR actual architecture — not a generic template.
+
+---
+
+## Installation
+
+```bash
+pip install devobin
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/mobinhasanghasemi/devobin.git
+cd devobin
+pip install -e .
+```
+
+---
+
+## Quick Start
+
+### 1. Launch DevObin
+
+```bash
+cd your-project/
+devobin
+```
+
+### 2. Connect an AI Provider
+
+```
+> /connect
+```
+
+| Provider | Key Format | Example Model |
+|----------|-----------|---------------|
+| OpenAI | `sk-...` | `gpt-4o` |
+| Anthropic | `sk-ant-...` | `claude-sonnet-4-20250514` |
+| Google | `AIza...` | `gemini-2.0-flash` |
+| Ollama | (no key) | `llama3` |
+
+### 3. Describe What You Want
+
+```
+> Add a caching layer to the provider calls
+```
+
+### 4. DevObin Does Everything
+
+1. **Scans** your workspace automatically
+2. **Asks permission** to read your files
+3. **Reads** every important source file
+4. **Understands** your real architecture
+5. **Writes** the prompt file to your directory
+6. **Tells you** "Created: caching_prompt.md"
+
+**You never type /export.** DevObin creates the file itself.
+
+### 5. Give the File to a Coding Agent
+
+```bash
+# The file is in your current directory
+cat caching_prompt.md
+
+# Give it to Codex, Claude, Cursor, or any AI agent
+```
+
+---
+
+## How It Works
+
+### Agent System
+
+DevObin has an autonomous agent that explores your codebase using tools:
+
+| Tool | What It Does |
+|------|-------------|
+| `[TOOL:glob:**/*.py]` | Find files by pattern |
+| `[TOOL:grep:regex]` | Search file contents |
+| `[TOOL:read:path]` | Read a file completely |
+| `[TOOL:ls:path]` | List directory contents |
+| `[TOOL:write:name.md]` | Create the prompt file |
+
+The agent runs up to **10 rounds** of tool calls to thoroughly understand your project before producing the prompt.
+
+### Permission System
+
+Before reading your files, DevObin asks permission:
+
+```
+┌─ File Access Permission ─────────────┐
+│ DevObin found 44 files.             │
+│ Allow file access?                  │
+│                                    │
+│ [Yes — Read All Files]             │
+│ [Ask Before Each File]             │
+│ [No — Skip File Reading]           │
+└────────────────────────────────────┘
+```
+
+### Grounding Check
+
+After generating the prompt, DevObin verifies it doesn't hallucinate technologies:
+
+- If your project has NO database → prompt won't mention PostgreSQL
+- If your project has NO Dockerfile → prompt won't mention Docker
+- If your project has NO frontend → prompt won't mention React
+
+If hallucinations are detected, DevObin automatically rewrites the prompt.
+
+### Session-Based History
+
+Each chat conversation is stored separately:
+
+```
+.devobin/projects/myproject/sessions/
+├── 2026-07-14T10-30-00.json
+├── 2026-07-14T11-15-00.json
+└── 2026-07-14T14-00-00.json
+```
+
+Use `/history` to browse past sessions.
+
+---
+
+## Commands
+
+### Chat Commands
+
+| Command | Description |
+|---------|-------------|
+| `/connect` | Set up an AI provider |
+| `/model <name>` | Switch model |
+| `/project create <name>` | Create project |
+| `/project switch <name>` | Switch project |
+| `/project list` | List projects |
+| `/scan` | Re-scan workspace |
+| `/history` | View past sessions |
+| `/memory` | View saved memories |
+| `/export [name]` | Manual export (rarely needed) |
+| `/settings` | Show settings |
+| `/clear` | Clear current chat |
+| `/help` | Command palette |
+
+### Shell Commands
+
+| Command | Description |
+|---------|-------------|
+| `/run <cmd>` | Execute shell command |
+| `/read <file>` | Read file |
+| `/ls [path]` | List directory |
+| `/git <args>` | Git commands |
+| `/pip <args>` | Pip commands |
+| `/python <args>` | Run Python |
+
+### Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Ctrl+K` | Command palette |
+| `Ctrl+L` | Clear chat |
+| `Ctrl+Q` | Quit |
+| `/` alone | Command palette |
+
+---
+
+## Example Session
+
+```
+$ cd my-python-project
+$ devobin
+
+> /connect
+  [Select: openai, enter API key, select gpt-4o]
+
+> بچین کدها رو و یه پرامپت مهندسی شده بساز
+
+  [Scanning workspace... 44 files found]
+  [Permission: Read All Files]
+  [Reading files... (round 1)]
+  [Reading files... (round 2)]
+  [Reading files... (round 3)]
+  [Creating prompt file... (round 4)]
+  Created: my_feature_prompt.md
+
+> یه caching اضافه کن
+
+  [Reading files... (round 1)]
+  [Reading existing prompt... (round 2)]
+  [Updating prompt file... (round 3)]
+  Updated: my_feature_prompt.md
+```
+
+---
+
+## Architecture
+
+```
+devobin/
+├── main.py              # Typer CLI entry
+├── app.py               # Textual TUI app
+├── core/
+│   ├── scanner.py       # Workspace scanner
+│   ├── tools.py         # Agent tools (glob/grep/read/ls/write)
+│   ├── validator.py     # Output + grounding validation
+│   ├── prompt_builder.py # Template-based prompts (fallback)
+│   ├── analyzer.py      # Tech detection
+│   ├── researcher.py    # Knowledge base
+│   ├── memory.py        # Cross-session memory
+│   ├── optimizer.py     # Token compression
+│   └── executor.py      # Shell & file ops
+├── providers/
+│   ├── __init__.py      # Provider registry
+│   ├── openai_provider.py
+│   ├── anthropic_provider.py
+│   ├── google_provider.py
+│   └── ollama_provider.py
+├── ui/
+│   ├── chat_screen.py   # Main screen + agent loop
+│   ├── export_modal.py  # Export dialog
+│   ├── ask_modal.py     # Question dialog
+│   ├── permission_modal.py # Permission dialog
+│   ├── history_modal.py # Session history
+│   └── command_palette.py
+├── config/
+│   └── settings.py      # Config + local_data_dir()
+└── storage/
+    └── database.py      # .devobin/ + sessions
+```
+
+---
+
+## Configuration
+
+### Platform Config (providers, settings)
+
+| Platform | Location |
+|----------|----------|
+| Windows | `%APPDATA%/devobin/` |
+| Linux | `~/.config/devobin/` |
+| macOS | `~/Library/Application Support/devobin/` |
+
+### Project Data (history, memory)
+
+Stored in `.devobin/` inside your project directory:
+
+```
+your-project/
+├── .devobin/
+│   └── projects/
+│       └── myproject/
+│           ├── memory.json
+│           ├── meta.json
+│           └── sessions/
+│               ├── 2026-07-14T10-30-00.json
+│               └── 2026-07-14T11-15-00.json
+├── src/
+│   └── ...
+└── caching_prompt.md   ← DevObin created this
+```
+
+---
+
+## Security
+
+- API keys stored locally, never sent anywhere except the provider
+- Tool `write` only allows `.md` files (no code execution)
+- Directory traversal blocked
+- File access requires explicit user permission
+- Grounding check prevents hallucinated technology suggestions
+
+---
+
+## Dependencies
+
+- Python ≥ 3.12
+- Typer (CLI)
+- Textual (TUI)
+- Rich (rendering)
+- openai / anthropic / google-genai (AI providers)
+- httpx (HTTP client)
+- platformdirs (config paths)
+- arabic-reshaper + python-bidi (RTL support)
+
+---
+
+## License
+
+MIT License
+
+## Author
+
+**Mobin Hasanghasemi**
+- GitHub: [github.com/mobinhasanghasemi](https://github.com/mobinhasanghasemi)
+
+</div>

devobin-1.0.0.dist-info/RECORD

@@ -0,0 +1,47 @@
+devobin/__init__.py,sha256=YjUkv0KxR0sxxj-0ysvIDPFyuH6aNxDoG9tYY2Pbrvc,125
+devobin/app.py,sha256=yTciS9ilhWXglkQnfe7WMqB-NmvjzjgJhMTJRfSVPEg,855
+devobin/main.py,sha256=1jhwSTUMJyGWReTWe2BYukZR4UHkfCXRXi4-kzawKek,840
+devobin/cli/__init__.py,sha256=iGXvJhmfACDqR543o2tHmSOo8dbAzxDagfC3gtgqnXk,27
+devobin/cli/chat.py,sha256=jj7hgPilkKQhvWQptii1FeCwbWUzo9Ulm_k8Oysibxg,31593
+devobin/cli/commands.py,sha256=KKE6-n0rdd8rDU54j4rCMCRQxWhgJH1xN8acdOrM1mk,11867
+devobin/cli/slash_menu.py,sha256=GZJUXKd0cPwCI_B0EW1s1x--7hij8wM7I2HJbK_tvVY,1971
+devobin/cli/terminal.py,sha256=WuIc-C0X4zsU-OrRKDAnpaCvLNYyiTa-cfeVaPobYOw,5693
+devobin/cli/ui.py,sha256=rNax2gzoamCrnirFf6eSd8RT3L0Dqqx0kpxz8sJLEH0,3828
+devobin/config/__init__.py,sha256=lKAyw6o0UPXPyZtHbct4-UTSa67CX6vrLEwqU5uZlnc,30
+devobin/config/settings.py,sha256=SwBpSfmzf3wPW8tMabaD8kh0ARR6C2YcQac-jaQt4js,4134
+devobin/core/__init__.py,sha256=-vM6pRScYrjYz9hPFnKZp6Il6OL9_nTREOo0LSPruOM,28
+devobin/core/analyzer.py,sha256=Uci1DnaWfYlgu_wMYle1E7M0ZqPP-XKFE8egt7xgmag,7848
+devobin/core/executor.py,sha256=bEbYxOhJjbbsJbbnkR4B-iYbLU1CfMcY7_Z4SiCd_A4,8551
+devobin/core/memory.py,sha256=5zCTzCVjZCwazIGDiD6Zpk34BFQNdAZ9r8oEKWwVS-g,3390
+devobin/core/optimizer.py,sha256=olnllOSc8x76ho1L9wlC1x1FuSI6H3OMC7HiWPJvZPk,3177
+devobin/core/prompt_builder.py,sha256=6f2QmYE2iS2fl_zFP82fg6ywpkFvfvptAe_9A9jTkvI,22693
+devobin/core/researcher.py,sha256=2bNrsGfFHb37ABEpmE0bDpcxgk3g7to1lxq6GMze1zw,12540
+devobin/core/rtl.py,sha256=vJ1v6SPLPzs3d2KoJMyO-8plQ6a2Cnosi0j4MIV6KgM,2615
+devobin/core/scanner.py,sha256=xg36tJU4YfFuICr-FiqMVT5Zc7JzvL88w5CvKA1tN-Y,7496
+devobin/core/tools.py,sha256=EiLy7arBgPp0HG7G5-SSuJYeOys3H-o0qYWf4wpDqiQ,11115
+devobin/core/validator.py,sha256=P0qrUi7QwB4rtBM70fudmp7j05hnZB4bV4HQyN6jqCQ,8167
+devobin/output/__init__.py,sha256=BxuchUlsC1eveO7X9YrjDd7eVF2TKX8XYV16LORMAmA,30
+devobin/providers/__init__.py,sha256=6M_BNaXOuJdu0JhQ2Avo8kXqwpjRfyHofxbPwp0jnW0,2643
+devobin/providers/anthropic_provider.py,sha256=IE0bhotNHmdsRAMNscFq76jlmhl38ZbYIT3lLHKhQ1I,2043
+devobin/providers/google_provider.py,sha256=hlxQA5f0Rtx7aIz4BWBJOj7EfXhcG-DSjI_nGIv6otY,2858
+devobin/providers/ollama_provider.py,sha256=QfAVtW9r7F339Yjg-4BcTFUuY5nhMuO5LSNR3i6VjbI,2562
+devobin/providers/openai_provider.py,sha256=vYQqQKAgPVdP2Ed_8ep0UdpndNB_PbAaNIYaI4i7krQ,3179
+devobin/storage/__init__.py,sha256=CCPB9nxM9mZ2mWQoh86RgrQZ_Nw1b1xUhxxjDe19tQ8,31
+devobin/storage/database.py,sha256=x2RGzC8z-UqMEA0wxW7k1SQE_BQZk4zCYfM2fdUuJcQ,7837
+devobin/ui/__init__.py,sha256=QhLE3PlkEauq79-Zqao5ICkAXp6Kh7EgNEyM-dNtj9g,26
+devobin/ui/ask_modal.py,sha256=liH6U64ha3ApPm7AV2_8zoUXUi3KwBWgm8h-a1fDCbc,2699
+devobin/ui/chat_screen.py,sha256=Azb0yGbnnkwSEIu3_PLreMkJZzyOOp-Y9knJWzL0rjc,42573
+devobin/ui/command_palette.py,sha256=Pppb8VlsAYqSBXzowSocGr-JCTcLCuWmQcm7Nv8BLx4,4319
+devobin/ui/connect_modal.py,sha256=ICG_2VwlyMbvhjys78osmJH1T1Gl6Xn8d3S4LX-c-Q8,5085
+devobin/ui/export_modal.py,sha256=pMRfdwPDvNdQqapbT3jX1GYMrUuBaYLwE6M2xe1BZXg,5248
+devobin/ui/history_modal.py,sha256=Xa86Tq523jEWGE1Pd03UBWGmDHOtPHiR3w62OIUPiCo,4222
+devobin/ui/memory_modal.py,sha256=_kTT0U-7_9sR9IbCGsUMKgGszwsh4u5zgx8AQQyUsPM,2295
+devobin/ui/model_modal.py,sha256=MOL9t8HD1iysAH_L9uokcGWr2tPeVGosHN2VpNU-rUg,4511
+devobin/ui/permission_modal.py,sha256=zo85dAw_11EJ3TOVTl3OS2VEpxhJ9aEDZ6Pc3cnEqXw,2672
+devobin/ui/project_modal.py,sha256=wY93Iqazkvm8Cba9UZynjxoBuiQAvqoQT-sF3pIBtxA,4072
+devobin/ui/settings_modal.py,sha256=25vmfVsNHtx74kbh_B9CRP4ydCcKOTBgrHAtyNJ4lgw,2299
+devobin-1.0.0.dist-info/METADATA,sha256=Gce4vlvQV7Djlt7BtUru-w9mJSgzqMDB2nwytGHPqrE,9906
+devobin-1.0.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+devobin-1.0.0.dist-info/entry_points.txt,sha256=uJzz0HzyVCrr_udp836p_b7otEXSd37_iBAhzeCn2CA,45
+devobin-1.0.0.dist-info/licenses/LICENSE,sha256=_AItAgR8WDoSrZNNdwGWh9BoK58lKVJxomCC4CPRlak,1069
+devobin-1.0.0.dist-info/RECORD,,

devobin-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

devobin-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+devobin = devobin.main:app

devobin-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 DevObin Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.