openclose 0.1.0__tar.gz

openclose-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
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Lint (ruff)
+        run: uv run ruff check src/ tests/
+
+      - name: Type check (mypy)
+        run: uv run mypy --strict src/ tests/
+
+      - name: Test (pytest)
+        run: uv run pytest tests/ --cov=openclose --cov-report=term-missing --cov-fail-under=80

openclose-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.claude/
+.vscode/
+.openclose/
+*.sqlite
+*.db
+.coverage
+htmlcov/

openclose-0.1.0/ARCHITECTURE.md

@@ -0,0 +1,184 @@
+# Architecture — OpenClose
+
+## Overview
+
+OpenClose is a local-first Python AI coding assistant that uses OpenAI-compatible APIs (vLLM, llama.cpp, Ollama, OpenAI). All data stays local in SQLite. The UI is a simple HTML interface served by FastAPI.
+
+## Package Structure
+
+```
+src/openclose/
+├── __init__.py          # Version
+├── __main__.py          # python -m openclose entry
+├── id.py                # ULID-based ID generation
+├── flag.py              # Feature flags from environment
+├── log.py               # Structured logging (rich)
+│
+├── config/              # Multi-layer config (TOML + env + defaults)
+│   ├── config.py        # Load/merge/reload
+│   ├── paths.py         # Platform-specific directories
+│   ├── schema.py        # Pydantic v2 settings models
+│   └── agents.py        # Agent definitions + inheritance resolution
+│
+├── storage/             # SQLite persistence
+│   ├── db.py            # Engine + Database class
+│   ├── schema.py        # SQLModel tables (Session, Message, MessagePart, Project)
+│   └── migrations.py    # Schema versioning
+│
+├── bus/                 # Async event bus (pub/sub)
+│   └── bus.py
+│
+├── provider/            # OpenAI-compatible LLM provider
+│   ├── provider.py      # AsyncOpenAI wrapper, streaming
+│   ├── models.py        # Model registry
+│   └── auth.py          # API key resolution
+│
+├── agent/               # Agent definitions and orchestration
+│   ├── agent.py         # Build/Plan/General agents, custom agents
+│   ├── prompt.py        # System prompt assembly
+│   └── loop.py          # Main agent loop (stream → tool calls → repeat)
+│
+├── session/             # Conversation management
+│   ├── session.py       # CRUD operations
+│   ├── message.py       # Role/PartType enums
+│   ├── processor.py     # Orchestrates agent loop + persistence
+│   ├── compaction.py    # Context window management
+│   ├── prompt.py        # Message history builder
+│   └── cancel.py        # Session cancellation
+│
+├── tool/                # Tool system
+│   ├── tool.py          # Tool base class, OpenAI schema generation
+│   ├── registry.py      # Tool registry + executor
+│   ├── truncation.py    # Output truncation
+│   └── tools/           # Built-in tools (13)
+│       ├── read.py, write.py, edit.py   # File operations
+│       ├── glob.py, grep.py, ls.py      # Search/listing
+│       ├── bash.py                       # Shell execution
+│       ├── patch.py                      # Unified diff application
+│       ├── webfetch.py                   # HTTP fetch
+│       ├── todo.py                       # Todo list
+│       ├── question.py                   # User clarification
+│       ├── question_broker.py            # Async question broker
+│       ├── lint.py                       # Lint tool
+│       └── multiedit.py                  # Multi-file edits
+│
+├── permission/          # Tool access control
+│   ├── permission.py    # Evaluation engine
+│   ├── rules.py         # Allow/deny/ask rules
+│   ├── schema.py        # Request/response types
+│   ├── broker.py        # Async permission request broker
+│   └── extract.py       # Path extraction + sandbox checking
+│
+├── file/                # File system utilities
+│   ├── binary.py        # Binary file detection
+│   ├── ignore.py        # .gitignore pattern handling
+│   ├── diff.py          # Change tracking
+│   └── watcher.py       # File watching (watchfiles)
+│
+├── format/              # Auto-formatters (ruff, black, gofmt, etc.)
+│   └── formatter.py
+│
+├── lint/                # Linter integration (ruff, mypy, eslint, etc.)
+│   └── linter.py
+│
+├── project/             # Project/VCS management
+│   ├── project.py       # Detection and metadata
+│   ├── worktree.py      # Git worktree management
+│   └── snapshot.py      # Git GC and snapshots
+│
+├── patch/               # Unified diff engine
+│   └── patch.py
+│
+├── scheduler/           # Background task scheduling
+│   └── scheduler.py
+│
+├── server/              # FastAPI + HTML UI
+│   ├── app.py           # FastAPI app creation
+│   ├── routes.py        # API + HTML routes
+│   ├── sse.py           # Server-Sent Events streaming
+│   └── templates/       # Jinja2 HTML templates + static assets
+│
+├── cli/                 # Command-line interface
+│   └── cli.py           # serve, run -p, sessions commands
+│
+└── util/                # Shared utilities
+    ├── process.py       # Async subprocess
+    ├── git.py           # Git command wrapper
+    └── fs.py            # File system helpers
+```
+
+## Key Design Decisions
+
+### 1. OpenAI-compatible API only
+**Decision:** Use the `openai` Python SDK targeting any OpenAI-compatible endpoint.
+**Why:** Covers vLLM, llama.cpp, Ollama, and OpenAI with a single client. No need for 75+ provider adapters.
+
+### 2. Local-only, no cloud
+**Decision:** All data in local SQLite. No sharing, no remote auth, no cloud infra.
+**Why:** User requirement for data sovereignty and simplicity.
+
+### 3. HTML UI via FastAPI (not TUI)
+**Decision:** Replace the original Bubble Tea TUI with a simple HTML UI served by FastAPI + Jinja2 + vanilla JS.
+**Why:** Easier to customize and modify than a terminal UI framework. SSE provides real-time streaming.
+
+### 4. Synchronous SQLite via SQLModel
+**Decision:** Use SQLModel (SQLAlchemy under the hood) with synchronous access, not async.
+**Why:** SQLite is inherently single-writer. The overhead of async wrappers adds complexity without benefit for local-only usage. The main async work is in LLM streaming and tool execution.
+
+### 5. dict[str, Any] for LLM messages
+**Decision:** Use plain dicts internally for message passing to/from the LLM, not OpenAI typed dicts.
+**Why:** The OpenAI type system for `ChatCompletionMessageParam` is a complex union that creates unnecessary friction with mypy. We cast at the boundary when calling the API.
+
+### 6. Tool system with function callbacks
+**Decision:** Tools are defined as `Tool` objects with `ToolParameter` metadata and an async execute function.
+**Why:** Simple, composable, and generates OpenAI function-calling schemas automatically. No metaclass magic.
+
+### 7. Permission engine with last-match-wins
+**Decision:** Permission rules are evaluated in order; last matching rule determines the action.
+**Why:** Matches the OpenCode original and allows general rules early with specific overrides later.
+
+### 8. Agent loop as iterator
+**Decision:** `AgentLoop.run()` is an async iterator yielding `StreamEvent` objects.
+**Why:** Enables both SSE streaming (server) and direct consumption (CLI). The caller decides how to handle events.
+
+## Data Flow
+
+```
+User Input
+  → CLI (-p flag) or HTML UI (POST /api/sessions/{id}/messages)
+    → SessionProcessor
+      → Persists user message to SQLite
+      → Creates AgentLoop with tool schemas
+      → AgentLoop streams from Provider (OpenAI-compatible)
+        → Text chunks → StreamEvent("text")
+        → Tool calls → ToolRegistry.execute() → StreamEvent("tool_result")
+        → Loop continues until done or max_steps
+      → Persists assistant response to SQLite
+    → Response streamed via SSE (server) or printed (CLI)
+```
+
+## Configuration Priority
+
+1. Environment variables (`OPENCLOSE_*`)
+2. Project config (`.openclose/config.toml`)
+3. User config (`~/.config/openclose/config.toml`)
+4. Defaults (Pydantic model defaults)
+
+## Dependencies
+
+| Package | Purpose |
+|---|---|
+| pydantic / pydantic-settings | Config and data models |
+| sqlmodel | SQLite ORM |
+| openai | LLM API client |
+| tiktoken | Token counting |
+| fastapi / uvicorn / jinja2 | HTML UI server |
+| sse-starlette | Server-Sent Events |
+| httpx | HTTP client (webfetch tool) |
+| beautifulsoup4 | HTML parsing (webfetch tool) |
+| rich | Terminal output and logging |
+| watchfiles | File system monitoring |
+| pathspec | Gitignore pattern matching |
+| python-ulid | ID generation |
+| aiosqlite | Async SQLite adapter |
+| aiofiles | Async file I/O |

openclose-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 leflakk
+
+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.

openclose-0.1.0/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: openclose
+Version: 0.1.0
+Summary: A Python AI coding assistant — local-first, OpenAI-compatible
+Project-URL: Homepage, https://github.com/leflakk/openclose
+Project-URL: Repository, https://github.com/leflakk/openclose
+Project-URL: Issues, https://github.com/leflakk/openclose/issues
+Author: OpenClose Contributors
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.12
+Requires-Dist: aiofiles>=24.1
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: fastapi>=0.115
+Requires-Dist: httpx>=0.28
+Requires-Dist: jinja2>=3.1
+Requires-Dist: openai>=1.55
+Requires-Dist: pathspec>=0.12
+Requires-Dist: pydantic-settings>=2.5
+Requires-Dist: pydantic<3,>=2.9
+Requires-Dist: python-ulid>=3.0
+Requires-Dist: rich>=13.9
+Requires-Dist: sqlmodel>=0.0.22
+Requires-Dist: sse-starlette>=2.1
+Requires-Dist: tiktoken>=0.8
+Requires-Dist: uvicorn>=0.32
+Requires-Dist: watchfiles>=1.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# OpenClose
+
+A local-first Python AI coding assistant that works with any OpenAI-compatible API.
+
+OpenClose runs entirely on your machine. Connect it to vLLM, llama.cpp, Ollama, or OpenAI — all conversations and data stay in a local SQLite database. The web UI streams responses in real time via SSE, and a headless CLI mode lets you script it into workflows.
+
+## Features
+
+- **Local-first** — SQLite storage, no cloud, no remote auth, no telemetry
+- **Provider-agnostic** — works with any OpenAI-compatible endpoint (vLLM, llama.cpp, Ollama, OpenAI)
+- **Web UI** — three-column layout with session sidebar, chat, and context info panel
+- **Real-time streaming** — Server-Sent Events for live token-by-token output
+- **Two built-in agents** — `build` (full tool access) and `plan` (read-only analysis)
+- **Custom agents** — define your own in `config.toml` with inheritance, custom prompts, and tool restrictions
+- **13 built-in tools** — read, write, edit, glob, grep, ls, bash, patch, webfetch, todo, question, lint, multiedit
+- **Permission system** — per-tool allow/deny/ask rules with last-match-wins semantics
+- **Auto-formatting** — ruff, black, gofmt, rustfmt, prettier, shfmt, clang-format
+- **Linting** — ruff, mypy, eslint, golangci-lint, clippy, clang-tidy, cppcheck
+- **Context management** — automatic compaction when approaching the context window limit
+- **CLI mode** — `openclose run -p "..."` for non-interactive scripting with optional JSON output
+
+## Installation
+
+Requires **Python 3.12+**.
+
+### From PyPI
+
+```bash
+pip install openclose
+```
+
+### With uv (recommended)
+
+```bash
+uv pip install openclose
+```
+
+### From source
+
+```bash
+git clone https://github.com/leflakk/openclose.git
+cd openclose
+uv sync
+```
+
+## Quickstart
+
+### 1. Configure a provider
+
+Create `~/.config/openclose/config.toml` (Linux) or `~/Library/Application Support/openclose/config.toml` (macOS):
+
+```toml
+[[providers]]
+name = "default"
+base_url = "http://localhost:8000/v1"
+```
+
+If your provider requires an API key, set it via environment variable or config:
+
+```bash
+export OPENCLOSE_API_KEY="sk-..."
+# or
+export OPENAI_API_KEY="sk-..."
+```
+
+Key resolution order: `OPENCLOSE_API_KEY` env var > `OPENAI_API_KEY` env var > config file `api_key` field.
+
+### 2. Start the web UI
+
+```bash
+openclose serve
+```
+
+Opens your browser to `http://127.0.0.1:9876`. Use `--host`, `--port`, `--no-browser`, or `--project-dir` to customize.
+
+### 3. Or run headless
+
+```bash
+openclose run -p "Explain the main function in src/main.py"
+openclose run -p "Add error handling to the parser" --agent build
+openclose run -p "Analyze the test coverage gaps" --agent plan --json
+```
+
+### 4. List sessions
+
+```bash
+openclose sessions
+```
+
+## Configuration
+
+Configuration is loaded in priority order (highest wins):
+
+1. Environment variables (`OPENCLOSE_*`)
+2. Project config (`.openclose/config.toml` in your project directory)
+3. User config (`~/.config/openclose/config.toml`)
+4. Defaults
+
+Example `config.toml`:
+
+```toml
+# Provider — any OpenAI-compatible endpoint
+[[providers]]
+name = "default"
+base_url = "http://localhost:8000/v1"
+api_key = ""
+default_model = ""
+
+# Session defaults
+default_agent = "build"
+max_context_tokens = 128000
+compaction_threshold = 0.9
+
+# Override built-in agent settings
+[[agents]]
+name = "build"
+model = "qwen3-30b-a3b"
+
+# Custom agent with inheritance
+[[agents]]
+name = "review"
+extends = "plan"
+description = "Code reviewer"
+system_prompt = "You are a code reviewer. Focus on bugs, security, and clarity."
+
+# Permission rules (last match wins)
+[[permissions]]
+tool = "*"
+action = "ask"
+
+[[permissions]]
+tool = "read"
+action = "allow"
+
+[[permissions]]
+tool = "bash"
+path = "/tmp/*"
+action = "deny"
+```
+
+See [docs/guide-agents-customization.md](docs/guide-agents-customization.md) for the full agent customization guide.
+
+## Agents
+
+| Agent | Description | Tool restrictions |
+|-------|-------------|-------------------|
+| `build` | Primary agent with full tool access for code writing and execution | None |
+| `plan` | Read-only analysis agent (extends `build`) | Denied: write, edit, bash, patch |
+
+Custom agents support:
+
+- **Inheritance** via `extends` — create variants without repeating config
+- **Semantic traits** — e.g. `["readonly"]` adjusts the system prompt automatically
+- **Tool filtering** — `allowed_tools` and `denied_tools` control what the LLM can call
+- **Custom system prompts** with `$variable` substitution
+
+## Web UI
+
+The web UI has a three-column layout: sessions sidebar, chat panel, and context/files sidebar.
+
+### Slash commands
+
+| Command | Description |
+|---------|-------------|
+| `/new` | Start a new session |
+| `/sessions` | Switch to another session |
+| `/agents` | Switch agent |
+| `/compact` | Compress context window |
+| `/undo` | Remove last message pair |
+| `/export` | Export session as JSON |
+| `/copy` | Copy last response |
+| `/skip` | Toggle auto-approve permissions |
+| `/help` | Show available commands |
+
+Sessions can be forked to continue a conversation with a different agent.
+
+## Architecture
+
+See [ARCHITECTURE.md](ARCHITECTURE.md) for the full package structure, design decisions, and data flow diagrams.
+
+## Contributing
+
+```bash
+git clone https://github.com/leflakk/openclose.git
+cd openclose
+uv sync
+uv run pytest tests/
+```
+
+Code quality requirements:
+
+- **Linting** — `uv run ruff check src/ tests/`
+- **Type checking** — `uv run mypy --strict src/ tests/`
+- **Tests** — `uv run pytest tests/ --cov=openclose --cov-fail-under=80`
+
+CI runs all three checks on every push and pull request via GitHub Actions.
+
+## License
+
+[MIT](LICENSE)

openclose-0.1.0/README.md

@@ -0,0 +1,200 @@
+# OpenClose
+
+A local-first Python AI coding assistant that works with any OpenAI-compatible API.
+
+OpenClose runs entirely on your machine. Connect it to vLLM, llama.cpp, Ollama, or OpenAI — all conversations and data stay in a local SQLite database. The web UI streams responses in real time via SSE, and a headless CLI mode lets you script it into workflows.
+
+## Features
+
+- **Local-first** — SQLite storage, no cloud, no remote auth, no telemetry
+- **Provider-agnostic** — works with any OpenAI-compatible endpoint (vLLM, llama.cpp, Ollama, OpenAI)
+- **Web UI** — three-column layout with session sidebar, chat, and context info panel
+- **Real-time streaming** — Server-Sent Events for live token-by-token output
+- **Two built-in agents** — `build` (full tool access) and `plan` (read-only analysis)
+- **Custom agents** — define your own in `config.toml` with inheritance, custom prompts, and tool restrictions
+- **13 built-in tools** — read, write, edit, glob, grep, ls, bash, patch, webfetch, todo, question, lint, multiedit
+- **Permission system** — per-tool allow/deny/ask rules with last-match-wins semantics
+- **Auto-formatting** — ruff, black, gofmt, rustfmt, prettier, shfmt, clang-format
+- **Linting** — ruff, mypy, eslint, golangci-lint, clippy, clang-tidy, cppcheck
+- **Context management** — automatic compaction when approaching the context window limit
+- **CLI mode** — `openclose run -p "..."` for non-interactive scripting with optional JSON output
+
+## Installation
+
+Requires **Python 3.12+**.
+
+### From PyPI
+
+```bash
+pip install openclose
+```
+
+### With uv (recommended)
+
+```bash
+uv pip install openclose
+```
+
+### From source
+
+```bash
+git clone https://github.com/leflakk/openclose.git
+cd openclose
+uv sync
+```
+
+## Quickstart
+
+### 1. Configure a provider
+
+Create `~/.config/openclose/config.toml` (Linux) or `~/Library/Application Support/openclose/config.toml` (macOS):
+
+```toml
+[[providers]]
+name = "default"
+base_url = "http://localhost:8000/v1"
+```
+
+If your provider requires an API key, set it via environment variable or config:
+
+```bash
+export OPENCLOSE_API_KEY="sk-..."
+# or
+export OPENAI_API_KEY="sk-..."
+```
+
+Key resolution order: `OPENCLOSE_API_KEY` env var > `OPENAI_API_KEY` env var > config file `api_key` field.
+
+### 2. Start the web UI
+
+```bash
+openclose serve
+```
+
+Opens your browser to `http://127.0.0.1:9876`. Use `--host`, `--port`, `--no-browser`, or `--project-dir` to customize.
+
+### 3. Or run headless
+
+```bash
+openclose run -p "Explain the main function in src/main.py"
+openclose run -p "Add error handling to the parser" --agent build
+openclose run -p "Analyze the test coverage gaps" --agent plan --json
+```
+
+### 4. List sessions
+
+```bash
+openclose sessions
+```
+
+## Configuration
+
+Configuration is loaded in priority order (highest wins):
+
+1. Environment variables (`OPENCLOSE_*`)
+2. Project config (`.openclose/config.toml` in your project directory)
+3. User config (`~/.config/openclose/config.toml`)
+4. Defaults
+
+Example `config.toml`:
+
+```toml
+# Provider — any OpenAI-compatible endpoint
+[[providers]]
+name = "default"
+base_url = "http://localhost:8000/v1"
+api_key = ""
+default_model = ""
+
+# Session defaults
+default_agent = "build"
+max_context_tokens = 128000
+compaction_threshold = 0.9
+
+# Override built-in agent settings
+[[agents]]
+name = "build"
+model = "qwen3-30b-a3b"
+
+# Custom agent with inheritance
+[[agents]]
+name = "review"
+extends = "plan"
+description = "Code reviewer"
+system_prompt = "You are a code reviewer. Focus on bugs, security, and clarity."
+
+# Permission rules (last match wins)
+[[permissions]]
+tool = "*"
+action = "ask"
+
+[[permissions]]
+tool = "read"
+action = "allow"
+
+[[permissions]]
+tool = "bash"
+path = "/tmp/*"
+action = "deny"
+```
+
+See [docs/guide-agents-customization.md](docs/guide-agents-customization.md) for the full agent customization guide.
+
+## Agents
+
+| Agent | Description | Tool restrictions |
+|-------|-------------|-------------------|
+| `build` | Primary agent with full tool access for code writing and execution | None |
+| `plan` | Read-only analysis agent (extends `build`) | Denied: write, edit, bash, patch |
+
+Custom agents support:
+
+- **Inheritance** via `extends` — create variants without repeating config
+- **Semantic traits** — e.g. `["readonly"]` adjusts the system prompt automatically
+- **Tool filtering** — `allowed_tools` and `denied_tools` control what the LLM can call
+- **Custom system prompts** with `$variable` substitution
+
+## Web UI
+
+The web UI has a three-column layout: sessions sidebar, chat panel, and context/files sidebar.
+
+### Slash commands
+
+| Command | Description |
+|---------|-------------|
+| `/new` | Start a new session |
+| `/sessions` | Switch to another session |
+| `/agents` | Switch agent |
+| `/compact` | Compress context window |
+| `/undo` | Remove last message pair |
+| `/export` | Export session as JSON |
+| `/copy` | Copy last response |
+| `/skip` | Toggle auto-approve permissions |
+| `/help` | Show available commands |
+
+Sessions can be forked to continue a conversation with a different agent.
+
+## Architecture
+
+See [ARCHITECTURE.md](ARCHITECTURE.md) for the full package structure, design decisions, and data flow diagrams.
+
+## Contributing
+
+```bash
+git clone https://github.com/leflakk/openclose.git
+cd openclose
+uv sync
+uv run pytest tests/
+```
+
+Code quality requirements:
+
+- **Linting** — `uv run ruff check src/ tests/`
+- **Type checking** — `uv run mypy --strict src/ tests/`
+- **Tests** — `uv run pytest tests/ --cov=openclose --cov-fail-under=80`
+
+CI runs all three checks on every push and pull request via GitHub Actions.
+
+## License
+
+[MIT](LICENSE)