drydock-cli 2.7.3__tar.gz → 2.7.4__tar.gz

drydock_cli-2.7.4/.auto_release.lock

@@ -0,0 +1 @@
+3077212

drydock_cli-2.7.4/PKG-INFO

@@ -0,0 +1,333 @@
+Metadata-Version: 2.4
+Name: drydock-cli
+Version: 2.7.4
+Summary: Local-first CLI coding agent — tested with Gemma 4 26B via vLLM
+Project-URL: Homepage, https://github.com/fbobe321/drydock
+Project-URL: Repository, https://github.com/fbobe321/drydock
+Project-URL: Issues, https://github.com/fbobe321/drydock/issues
+Project-URL: Documentation, https://github.com/fbobe321/drydock#readme
+Author: Drydock contributors, Mistral AI (original)
+License: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: ai,cli,coding-assistant,developer-tools,drydock,gemma,llm,local-llm,tui,vllm
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: agent-client-protocol==0.8.1
+Requires-Dist: anyio>=4.12.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: cachetools>=5.5.0
+Requires-Dist: cryptography<=46.0.3,>=44.0.0
+Requires-Dist: gitpython>=3.1.46
+Requires-Dist: giturlparse>=0.14.0
+Requires-Dist: google-auth>=2.0.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: keyring>=25.6.0
+Requires-Dist: markdownify>=1.2.2
+Requires-Dist: mcp>=1.14.0
+Requires-Dist: mistralai==1.12.4
+Requires-Dist: packaging>=24.1
+Requires-Dist: pexpect>=4.9.0
+Requires-Dist: pydantic-settings>=2.12.0
+Requires-Dist: pydantic>=2.12.4
+Requires-Dist: pypdf>=4.0.0
+Requires-Dist: pyperclip>=1.11.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: requests>=2.20.0
+Requires-Dist: rich>=14.0.0
+Requires-Dist: textual-speedups>=0.2.1
+Requires-Dist: textual>=7.4.0
+Requires-Dist: tomli-w>=1.2.0
+Requires-Dist: tree-sitter-bash>=0.25.1
+Requires-Dist: tree-sitter>=0.25.2
+Requires-Dist: watchfiles>=1.1.1
+Requires-Dist: zstandard>=0.25.0
+Description-Content-Type: text/markdown
+
+# DryDock
+
+[![Python Version](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/release/python-3120/)
+[![License](https://img.shields.io/github/license/fbobe321/drydock)](https://github.com/fbobe321/drydock/blob/main/LICENSE)
+
+```
+     ____             ____             _    
+    |  _ \ _ __ _   _|  _ \  ___   ___| | __
+    | | | | '__| | | | | | |/ _ \ / __| |/ /
+    | |_| | |  | |_| | |_| | (_) | (__|   < 
+    |____/|_|   \__, |____/ \___/ \___|_|\_\
+                |___/                       
+```
+
+**Local-first CLI coding agent. Chart your course. Execute with precision.**
+
+DryDock is a TUI coding assistant designed to work with **local LLMs**. It provides a conversational interface to your codebase — explore, modify, build, and test projects through natural language and a powerful set of tools.
+
+> [!IMPORTANT]
+> DryDock is tested and optimized for **Gemma 4 26B-A4B** (26B MoE, 4B active parameters) served via vLLM. Other models and providers are supported (Mistral, OpenAI, Anthropic, Ollama) but are not as thoroughly tested. If you use a different model, expect to tune prompts and tool settings.
+
+## Tested Hardware + Model
+
+| Component | Spec |
+|-----------|------|
+| GPUs | 2x NVIDIA RTX 4060 Ti 16GB |
+| Model | [Gemma-4-26B-A4B-it-AWQ-4bit](https://huggingface.co/casperhansen/gemma-4-26b-a4b-it-AWQ-4bit) |
+| Serving | vLLM (Docker image `vllm/vllm-openai:gemma4`) |
+| Performance | ~70 tok/s, 131K context, 0% timeouts |
+| Active params | 4B per token (MoE architecture — fast inference) |
+
+### Install the model
+
+```bash
+# Download the model weights (requires HuggingFace access)
+pip install huggingface-hub
+huggingface-cli download casperhansen/gemma-4-26b-a4b-it-AWQ-4bit \
+    --local-dir /path/to/models/Gemma-4-26B-A4B-it-AWQ-4bit
+```
+
+### Start vLLM
+
+```bash
+docker run -d \
+    --gpus all \
+    --name gemma4 \
+    -p 8000:8000 \
+    -v /path/to/models:/models \
+    --ipc=host \
+    vllm/vllm-openai:gemma4 \
+    --model /models/Gemma-4-26B-A4B-it-AWQ-4bit \
+    --quantization compressed-tensors \
+    --tensor-parallel-size 2 \
+    --max-model-len 131072 \
+    --max-num-seqs 2 \
+    --gpu-memory-utilization 0.95 \
+    --kv-cache-dtype fp8 \
+    --served-model-name gemma4 \
+    --trust-remote-code \
+    --tool-call-parser gemma4 \
+    --enable-auto-tool-choice \
+    --attention-backend TRITON_ATTN
+```
+
+Key flags:
+- `--tensor-parallel-size 2` — split across 2 GPUs
+- `--kv-cache-dtype fp8` — reduce KV cache memory for longer contexts
+- `--tool-call-parser gemma4` + `--enable-auto-tool-choice` — required for Gemma 4 tool calling
+- `--max-num-seqs 2` — limit concurrent requests (prevents OOM on 16GB GPUs)
+
+Verify the model is running:
+```bash
+curl http://localhost:8000/v1/models
+```
+
+### Configure DryDock
+
+```toml
+# ~/.drydock/config.toml
+[models.gemma4]
+name = "gemma4"
+provider = "generic-openai"
+alias = "gemma4"
+temperature = 0.2
+thinking = "high"
+
+[providers.generic-openai]
+api_base = "http://localhost:8000/v1"
+api_style = "openai"
+```
+
+## Install
+
+```bash
+pip install drydock-cli
+```
+
+Or with uv:
+```bash
+uv tool install drydock-cli
+```
+
+> [!TIP]
+> **New install hitting weird behavior?** See [DEPLOYMENT.md](DEPLOYMENT.md)
+> for the exact known-working vLLM launch flags, `~/.drydock/config.toml`,
+> env vars, and a diagnostic checklist. Most "DryDock doesn't work" issues
+> trace back to missing vLLM flags (`--tool-call-parser gemma4`,
+> `--enable-auto-tool-choice`) or temperature/thinking config drift.
+
+## Quick Start
+
+```bash
+cd your-project/
+drydock
+```
+
+First run creates a config at `~/.drydock/config.toml` and prompts for your provider setup.
+
+```
+> Review the PRD and build the package
+```
+
+## Features
+
+- **TUI Interface**: Full terminal UI with streaming output, tool approval, and session management.
+- **Adaptive Thinking**: Automatically adjusts reasoning depth per turn — full thinking for planning, fast mode for file writes.
+- **Powerful Toolset**: Read, write, and patch files. Execute shell commands. Search code with `grep`. Delegate to subagents.
+- **Project-Aware**: Scans project structure, loads `AGENTS.md` / `DRYDOCK.md` for context.
+- **Subagent Delegation**: Large tasks can be delegated to builder/planner/explorer subagents with isolated context.
+- **Loop Detection**: Advisory-only detection that nudges the model away from repetitive actions without blocking.
+- **Conda/Pip Support**: Auto-approves `pip install`, `conda install`, `pytest`, and other dev commands.
+- **Bundled Skills**: Ships with skills like `create-presentation` for PowerPoint generation.
+- **MCP Support**: Connect Model Context Protocol servers for extended capabilities.
+- **Safety First**: Tool execution approval with `--dangerously-skip-permissions` for full auto-approve.
+
+### Built-in Agents
+
+- **`default`**: Standard agent that requires approval for tool executions.
+- **`plan`**: Read-only agent for exploration and planning.
+- **`accept-edits`**: Auto-approves file edits only.
+- **`auto-approve`**: Auto-approves all tool executions.
+
+```bash
+drydock --agent plan
+```
+
+### Gemma 4 Optimizations
+
+DryDock includes several optimizations specifically tuned for Gemma 4:
+
+- **Simplified prompt** (`gemma4.md`): 20-line system prompt instead of 125 lines. Complex prompts cause Gemma 4 to plan instead of act.
+- **Non-streaming mode**: Streaming breaks Gemma 4 tool call JSON parsing. DryDock automatically disables streaming for Gemma 4.
+- **Thinking token filtering**: Gemma 4 leaks `<|channel>thought<channel|>` tokens into text output. DryDock strips these before storing in context.
+- **Adaptive thinking**: Full thinking for planning (turn 1) and error recovery. Thinking OFF for routine file writes — eliminates 30-120s hangs between files.
+- **search_replace resilience**: Auto-detects already-applied edits, infers missing file paths, fuzzy-matches whitespace differences.
+- **Reduced tool set**: Disables tools that confuse Gemma 4 (`ask_user_question`, `task_create`, etc.).
+
+## Usage
+
+### Interactive Mode
+
+```bash
+drydock                        # Start interactive session
+drydock "Fix the login bug"    # Start with a prompt
+drydock --continue             # Resume last session
+drydock --resume abc123        # Resume specific session
+```
+
+**Keyboard shortcuts:**
+- `Ctrl+C` — Cancel current operation (double-tap to quit)
+- `Shift+Tab` — Toggle auto-approve mode
+- `Ctrl+O` — Toggle tool output
+- `Ctrl+G` — Open external editor
+- `@` — File path autocompletion
+- `!command` — Run shell command directly
+
+### Programmatic Mode
+
+```bash
+drydock --prompt "Analyze the codebase" --max-turns 5 --output json
+drydock --dangerously-skip-permissions -p "Fix all lint errors"
+```
+
+## Configuration
+
+DryDock is configured via `config.toml`. It looks first in `./.drydock/config.toml`, then `~/.drydock/config.toml`.
+
+### API Key
+
+```bash
+drydock --setup                              # Interactive setup
+export MISTRAL_API_KEY="your_key"            # Or set env var
+```
+
+Keys are saved to `~/.drydock/.env`.
+
+### Consultant Model
+
+Set a smarter model for the `/consult` command:
+
+```toml
+consultant_model = "gemini-2.5-pro"
+```
+
+The consultant provides read-only advice — it never calls tools. Use `/consult <question>` to ask it.
+
+### Custom Agents
+
+Create agent configs in `~/.drydock/agents/`:
+
+```toml
+# ~/.drydock/agents/redteam.toml
+active_model = "devstral-2"
+system_prompt_id = "redteam"
+disabled_tools = ["search_replace", "write_file"]
+```
+
+### Skills
+
+DryDock discovers skills from:
+1. Custom paths in `config.toml` via `skill_paths`
+2. Project `.drydock/skills/` or `.agents/skills/`
+3. Global `~/.drydock/skills/`
+4. Bundled skills (shipped with the package)
+
+### MCP Servers
+
+```toml
+[[mcp_servers]]
+name = "fetch_server"
+transport = "stdio"
+command = "uvx"
+args = ["mcp-server-fetch"]
+```
+
+## Testing
+
+DryDock uses a **shakedown harness** (`scripts/shakedown.py`) that drives the real TUI via pexpect and judges on user-perceptible criteria — not tool-call counts.
+
+```bash
+# Single project test
+python3 scripts/shakedown.py \
+    --cwd /path/to/project \
+    --prompt "review the PRD and build the package" \
+    --pkg package_name
+
+# Interactive back-and-forth test
+python3 scripts/shakedown_interactive.py \
+    --cwd /path/to/project \
+    --pkg package_name
+
+# Full regression suite (370 PRDs)
+bash scripts/shakedown_suite.sh
+```
+
+Pass criteria: no write loops, no ignored interrupts, no search_replace cascades, package executes, session finishes within time budget.
+
+## Slash Commands
+
+Type `/help` in the input for available commands. Create custom slash commands via the skills system.
+
+## Session Management
+
+```bash
+drydock --continue              # Continue last session
+drydock --resume abc123         # Resume specific session
+drydock --workdir /path/to/dir  # Set working directory
+```
+
+## License
+
+Copyright 2025 Mistral AI (original work)
+Copyright 2026 DryDock contributors (modifications)
+
+Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.
+
+DryDock is a fork of [mistralai/mistral-vibe](https://github.com/mistralai/mistral-vibe) (Apache 2.0). See [NOTICE](NOTICE) for attribution.

drydock_cli-2.7.4/pyproject.toml

@@ -0,0 +1,192 @@
+[project]
+name = "drydock-cli"
+version = "2.7.4"
+description = "Local-first CLI coding agent — tested with Gemma 4 26B via vLLM"
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "Apache-2.0" }
+authors = [{ name = "Drydock contributors" }, { name = "Mistral AI (original)" }]
+keywords = [
+    "ai",
+    "cli",
+    "coding-assistant",
+    "drydock",
+    "llm",
+    "developer-tools",
+    "gemma",
+    "vllm",
+    "local-llm",
+    "tui",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "agent-client-protocol==0.8.1",
+    "anyio>=4.12.0",
+    "beautifulsoup4>=4.12.0",
+    "cachetools>=5.5.0",
+    "cryptography>=44.0.0,<=46.0.3",
+    "gitpython>=3.1.46",
+    "giturlparse>=0.14.0",
+    "google-auth>=2.0.0",
+    "httpx>=0.28.1",
+    "keyring>=25.6.0",
+    "markdownify>=1.2.2",
+    "mcp>=1.14.0",
+    "mistralai==1.12.4",
+    "packaging>=24.1",
+    "pexpect>=4.9.0",
+    "pydantic>=2.12.4",
+    "pydantic-settings>=2.12.0",
+    "pypdf>=4.0.0",
+    "pyperclip>=1.11.0",
+    "python-dotenv>=1.0.0",
+    "pyyaml>=6.0.0",
+    "requests>=2.20.0",
+    "rich>=14.0.0",
+    "textual>=7.4.0",
+    "textual-speedups>=0.2.1",
+    "tomli-w>=1.2.0",
+    "tree-sitter>=0.25.2",
+    "tree-sitter-bash>=0.25.1",
+    "watchfiles>=1.1.1",
+    "zstandard>=0.25.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/fbobe321/drydock"
+Repository = "https://github.com/fbobe321/drydock"
+Issues = "https://github.com/fbobe321/drydock/issues"
+Documentation = "https://github.com/fbobe321/drydock#readme"
+
+[build-system]
+requires = ["hatchling", "hatch-vcs", "editables"]
+build-backend = "hatchling.build"
+
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.hatch.build.targets.wheel]
+include = ["drydock/"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"drydock/skills/create-presentation" = "drydock/skills/create-presentation"
+"drydock/skills/deep-research" = "drydock/skills/deep-research"
+"drydock/skills/investigate" = "drydock/skills/investigate"
+"drydock/skills/review" = "drydock/skills/review"
+"drydock/skills/ship" = "drydock/skills/ship"
+"drydock/skills/batch" = "drydock/skills/batch"
+"drydock/skills/simplify" = "drydock/skills/simplify"
+
+
+[project.scripts]
+drydock = "drydock.cli.entrypoint:main"
+drydock-acp = "drydock.acp.entrypoint:main"
+
+
+[tool.uv]
+package = true
+required-version = ">=0.8.0"
+
+
+[dependency-groups]
+dev = [
+    "debugpy>=1.8.19",
+    "pre-commit>=4.2.0",
+    "pyright>=1.1.403",
+    "pytest>=8.3.5",
+    "pytest-asyncio>=1.2.0",
+    "pytest-textual-snapshot>=1.1.0",
+    "pytest-timeout>=2.4.0",
+    "pytest-xdist>=3.8.0",
+    "respx>=0.22.0",
+    "ruff>=0.14.5",
+    "twine>=5.0.0",
+    "typos>=1.34.0",
+    "vulture>=2.14",
+]
+
+build = ["pyinstaller>=6.17.0"]
+
+[tool.pyright]
+pythonVersion = "3.12"
+reportMissingTypeStubs = false
+reportPrivateImportUsage = false
+include = ["drydock/**/*.py", "tests/**/*.py"]
+venvPath = "."
+venv = ".venv"
+
+[tool.ruff]
+include = ["drydock/**/*.py", "tests/**/*.py"]
+line-length = 88
+target-version = "py312"
+preview = true
+
+[tool.ruff.format]
+skip-magic-trailing-comma = true
+
+[tool.ruff.lint]
+select = [
+    "F",
+    "I",
+    "D2",
+    "UP",
+    "TID",
+    "ANN",
+    "PLR",
+    "B0",
+    "B905",
+    "DOC102",
+    "RUF022",
+    "RUF010",
+    "RUF012",
+    "RUF019",
+    "RUF100",
+]
+ignore = ["D203", "D205", "D213", "ANN401", "PLR6301"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["ANN", "PLR"]
+# Textual parent classes don't use ClassVar, so we can't either without breaking pyright
+"drydock/cli/textual_ui/ansi_markdown.py" = ["RUF012"]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.isort]
+known-first-party = ["drydock"]
+force-sort-within-sections = true
+split-on-trailing-comma = false
+combine-as-imports = true
+force-wrap-aliases = false
+order-by-type = true
+required-imports = ["from __future__ import annotations"]
+
+[tool.ruff.lint.pylint]
+max-statements = 50
+max-branches = 15
+max-locals = 15
+max-args = 9
+max-returns = 6
+max-nested-blocks = 4
+
+[tool.vulture]
+ignore_decorators = ["@*"]
+
+[tool.pytest.ini_options]
+addopts = "-vvvv -q -n auto --durations=10 --import-mode=importlib --maxschedchunk=1"
+timeout = 10
+filterwarnings = [
+    # (e2e) streaming mock server is started in a thread; and the cli is spawn in a fork
+    "ignore:This process \\(pid=.*\\) is multi-threaded, use of forkpty\\(\\) may lead to deadlocks in the child\\.:DeprecationWarning",
+]