luckyd-code 1.2.2__tar.gz

luckyd_code-1.2.2/.gitignore

@@ -0,0 +1,77 @@
+# Debug output files
+test_results.txt
+test_v.txt
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+*.egg
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Environment / secrets
+.env
+*.env
+venv/
+.venv/
+
+# Personal / runtime history (may contain sensitive data)
+.deepseek_history
+*.deepseek_history
+.luckyd_history
+*.luckyd_history
+
+# Coverage reports
+.coverage
+coverage.xml
+htmlcov/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+Thumbs.db
+.DS_Store
+
+# Project runtime files
+*.deepseek_history
+.claude/
+CLAUDE.md
+.audit_lock
+.audit_daemon_paused
+.deepseek-code/
+.luckyd-code/
+_build/
+
+# Temp / debug / output files
+out.txt
+fail_output.txt
+full_test_output.txt
+test_output.txt
+hs_test.txt
+test_debug.txt
+test_out.txt
+*.log
+debug_*
+_debug_*.py
+_cleanup_*.py
+
+# Stale root scripts
+fetch_models.py
+test_models.py
+run.bat
+DeepSeek Code Web.bat
+PUSH_TO_GITHUB.md
+
+# Scripts temp
+scripts/_*
+test_results.txt
+test_v.txt
+deepseek_code/metrics/time_series.jsonl

luckyd_code-1.2.2/CHANGELOG.md

@@ -0,0 +1,142 @@
+# Changelog
+
+## [1.2.2] — 2026-05-06
+
+### Changed
+- **.gitignore** — added `.luckyd_history` and `.luckyd-code/` for project rename parity
+- **Docstring fix** (`_agent_loop.py`) — removed stale `/critique` reference in `run_config`
+
+## [1.2.1] — 2026-05-02
+
+**Change:** Fix high_complexity: Cyclomatic complexity is 78 in `C:\Users\dylan\OneDrive\Desktop\deepseek-code\luckyd_code\_agent_loop.py`
+
+**Files:** `luckyd_code/_agent_loop.py`
+
+
+All notable changes to DeepSeek Code will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [1.0.1] — 2026-05-05
+
+### Changed
+- **Agent loop** (`_agent_loop.py`) — complete harness overhaul targeting top-1% quality:
+  - **Self-critique gate** — `self_critique.py` is now wired and fires before every final response. If the critique scores FAIL or WARN with multiple issues, a corrective turn runs automatically.
+  - **Stuck-loop detection** — tracks hashes of recent tool-call batches; if the same batch repeats `_STUCK_WINDOW` times the loop breaks and asks the model to explain what's blocking it instead of burning all turns.
+  - **Turn budget injection** — when ≤ 2 turns remain, a system message is injected so the model can wrap up gracefully instead of being cut off mid-task.
+  - **Mid-loop model escalation** — on repeated verify failures the loop automatically promotes to the next tier in `_ESCALATION_LADDER` (`deepseek-v4-flash` → `deepseek-v4-pro`) for recovery turns.
+  - **Tool result truncation** — all tool results are capped at 8,000 characters before context injection, protecting the token budget on large file reads.
+  - **Re-read-after-write** — after every `Write` or `Edit` tool call, the file's existence and size are checked; if the write silently failed a warning is injected immediately.
+  - **Context-overflow protection** — `estimate_tokens()` is checked before every turn; if usage exceeds 85% of the compact threshold, `compact()` runs automatically.
+  - `LoopResult` gains `escalated_model` field to report any mid-loop model promotion.
+  - `RunConfig` gains `enable_self_critique` flag (default `True`) to opt out per-call.
+
+## [1.2.1] — 2026-05-02
+
+### Security
+- **Removed `.env` from git tracking** — the `.env` file containing the
+  `DEEPSEEK_API_KEY` was previously committed to the repository. It is now
+  untracked (`git rm --cached .env`). The `.gitignore` rule for `.env` already
+  existed but had no effect while the file was being tracked. **If you cloned
+  this repo before this release, rotate your API key at
+  [platform.deepseek.com/api_keys](https://platform.deepseek.com/api_keys).**
+
+### Fixed
+- **`SECURITY.md`** — updated supported versions table to reflect v1.2.x as the
+  current supported release.
+
+## [1.2.0] — 2026-05-02
+
+### Changed
+- **Shared agent loop** (`_agent_loop.py`) — extracted a single `run_agent_loop()`
+  function used by both `SubAgent` and `AgentHandoff`. Bug fixes now propagate
+  to all agentic paths automatically; `agent.py` and `orchestrator.py` are ~60%
+  shorter as a result.
+- **Retry in `stream_chat`** (`api.py`) — `_call_with_retry()` now wraps
+  `_stream_chat_raw` with up to 3 attempts using exponential backoff and jitter
+  (1 s base, 30 s cap). Rate-limit (429) and server errors (5xx) are retried;
+  auth and bad-request errors are not.
+- **Cost tracking** (`cost_tracker.py`) — switched from full-rewrite JSON to
+  append-only JSONL (`costs.jsonl`). Each API call is now O(1) instead of
+  O(session length). Existing `costs.json` files are migrated automatically on
+  first write.
+- **Memory search** (`memory/manager.py`) — `search_memories()` now uses
+  semantic cosine-similarity via `sentence-transformers` (all-MiniLM-L6-v2)
+  when the `rag` extra is installed, with keyword-frequency as an automatic
+  fallback. Thread-safe singleton (`_DEFAULT_MANAGER`) fixed with
+  double-checked locking.
+- **Orchestrator** (`orchestrator.py`) — reviewer handoff now uses
+  `_truncate_to_tokens()` instead of a hardcoded `[:3000]` char slice.
+  `parallel_orchestrate` thread pool capped at `min(len(sub_tasks), 4)` to
+  prevent unbounded concurrent API calls.
+- **`__all__` exports** — added to `memory/__init__.py`, `tools/__init__.py`,
+  `_agent_loop.py`, `agent.py`, and `orchestrator.py`.
+
+## [1.1.0] — 2026-05-01
+
+### Fixed
+- **Critical bug**: `orchestrator.py` — `stream_chat` was called but never imported,
+  causing a `NameError` crash on any `/orchestrate` command. Fixed by adding
+  `from .api import stream_chat` to the import block.
+- Removed unused `import time` from `orchestrator.py`.
+
+### Changed
+- **Model registry** (`model_registry.py`) — eliminated duplicate `ModelDef` entries.
+  `deepseek-v4-flash` and `deepseek-v4-pro` now each appear exactly once.
+  A `TIER_MODEL_MAP` dict handles the tier→model mapping; `get_unique_model_count()`
+  now correctly returns 2 instead of 4. `format_model_list()` updated to show
+  tier assignments alongside each model.
+- **Router** (`router.py`) — `classify_tier_llm()` no longer blocks the main thread.
+  The LLM API call now runs in a background `ThreadPoolExecutor`; the heuristic
+  result is returned immediately if the call doesn't finish within 4 seconds.
+  The LLM result is still cached once it arrives, so future identical prompts
+  are instant. Router now imports `TIER_MODEL_MAP` directly from `model_registry`
+  instead of maintaining a separate copy.
+- **Planner** (`planner.py`) — completely rebuilt from a plain file-manager into
+  a real AI-powered task decomposer. `ai_create_plan(name, goal, config)` calls
+  `deepseek-v4-flash` to break a goal into structured `PlanStep` objects with
+  agent assignments, dependency tracking, and time estimates. Plans are persisted
+  as both human-readable Markdown and machine-readable JSON. Added `load_plan`,
+  `save_plan`, `update_step_status`, and `delete_plan` helpers.
+
+### Added
+- **Tool result caching** (`tools/registry.py`) — `ToolRegistry` now caches results
+  from read-only tools (`Read`, `Glob`, `Grep`, `WebFetch`, `WebSearch`, `DateTime`)
+  for 5 minutes (configurable via `cache_ttl`). Identical calls within the TTL
+  window skip the underlying I/O entirely. Cache keys are derived from tool name +
+  sorted arguments. Write/Bash/Git tools are explicitly excluded. Added
+  `ToolRegistry.invalidate()` to clear entries by tool name or globally.
+- **Diff preview for Write and Edit tools** (`tools/file_ops.py`) — both `WriteTool`
+  and `EditTool` now accept a `dry_run=true` parameter. When set, the tool returns
+  a unified diff of the proposed change without modifying the file. `WriteTool`
+  also reports how many lines changed after every successful write.
+
+## [1.0.0] — 2025-04-28
+
+### Added
+- **AI Chat** — Conversational coding assistant with streaming responses and thinking/reasoning mode
+- **Smart Model Routing** — Auto-classifies prompt complexity into 4 tiers
+- **Knowledge Graph** — Automatic codebase indexing with vector search and dependency tracking
+- **Memory System** — Persistent `CLAUDE.md` memory across sessions with relevance search
+- **Cost Tracking** — Per-session and cumulative cost tracking across models
+- **Web UI** — Browser-based interface with cost panel, memory management, and model routing
+- **35+ Built-in Tools** — Read, Write, Edit, Glob, Grep, Bash, WebFetch, WebSearch, Git, Browser automation
+- **MCP Support** — Model Context Protocol for extending with custom tools
+- **DeepSeek API** — Native integration with `deepseek-v4-flash` and `deepseek-v4-pro`
+- **Context Management** — Auto-compaction with summarization to stay within context windows
+- **Background Agents** — Run tasks asynchronously while continuing to chat
+- **Orchestrator** — Researcher → Coder → Reviewer pipeline for complex tasks
+- **Hooks System** — Pre/post tool use, pre/post chat, lifecycle hooks
+- **Sandboxing** — Docker-based secure command execution
+- **Session Management** — Save, load, and auto-recover conversations
+- **Undo** — Revert file writes and edits
+- **Export** — Conversations to Markdown or HTML
+- **Shell Detection** — Auto-detects Git Bash → WSL → cmd.exe on Windows
+- **Playwright Browser** — Full browser automation for testing and web interaction
+- **Self-Improvement** — Automated audit and improvement system
+- **File Watching** — Watch files and auto-reindex knowledge graph
+- **Rate Limiting** — Per-IP rate limiting for Web UI
+- **Auth Support** — Bearer token authentication for Web UI
+- **First-run Wizard** — Interactive API key setup on first launch
+- **CLI Commands** — `/help`, `/clear`, `/compact`, `/undo`, `/model`, `/cost`, `/memory`, `/brain`, `/export`, `/sessions`, `/review`, `/orchestrate`

luckyd_code-1.2.2/CONTRIBUTING.md

@@ -0,0 +1,89 @@
+# Contributing
+
+Thanks for your interest in DeepSeek Code!
+
+## Development Setup
+
+```bash
+# Clone the repo
+git clone https://github.com/Dylanchess0320/DeepSeek-Code
+cd deepseek-code
+
+# Create virtual environment
+python -m venv .venv
+
+# Activate it
+# Windows: .venv\Scripts\activate
+# Linux/Mac: source .venv/bin/activate
+
+# Install in editable mode with dev dependencies
+pip install -e ".[dev]"
+
+# Install optional RAG dependencies
+pip install -e ".[rag-full]"
+```
+
+## Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# With coverage
+pytest --cov=luckyd_code
+
+# Specific test file
+pytest tests/test_router.py -v
+```
+
+## Type Checking
+
+```bash
+mypy luckyd_code
+```
+
+## Code Style
+
+- Target Python 3.10+
+- Follow PEP 8
+- Use type hints for all function signatures
+- Write docstrings for public APIs
+- Keep functions focused and small
+
+## Pull Request Process
+
+1. Create a feature branch from `main`
+2. Write tests for new functionality
+3. Ensure all existing tests pass
+4. Update documentation (README, CHANGELOG) as needed
+5. Submit the PR with a clear description
+
+## Project Structure
+
+```
+luckyd_code/
+├── cli.py               # Terminal UI and REPL
+├── cli_commands/        # Slash-command handlers
+├── web_app.py           # Web UI server (FastAPI)
+├── web_routes/          # Web UI route handlers
+├── api.py               # API streaming client
+├── router.py            # Model routing
+├── config.py            # Configuration
+├── context.py           # Conversation context
+├── cost_tracker.py      # Cost tracking
+├── hooks.py             # Lifecycle hooks
+├── model_registry.py    # Model definitions
+├── memory/              # Persistent memory
+├── brain/               # Knowledge graph & RAG
+├── tools/               # Tool registry (35+ tools)
+├── mcp/                 # MCP client
+├── permissions/         # Permission system
+├── skills/              # Review & security
+├── analytics/           # Usage analytics
+├── templates/           # Web UI assets
+└── background/          # Background agents
+```
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

luckyd_code-1.2.2/LICENSE

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

luckyd_code-1.2.2/MANIFEST.in

@@ -0,0 +1,12 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include CONTRIBUTING.md
+include pyproject.toml
+recursive-include deepseek_code/templates *
+recursive-include deepseek_code/templates/src *
+graft deepseek_code/templates
+global-exclude __pycache__
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude .DS_Store

luckyd_code-1.2.2/PKG-INFO

@@ -0,0 +1,297 @@
+Metadata-Version: 2.4
+Name: luckyd-code
+Version: 1.2.2
+Summary: LuckyD Code — AI coding assistant powered by DeepSeek
+Project-URL: Homepage, https://github.com/Dylanchess0320/LuckyD-Code
+Project-URL: BugTracker, https://github.com/Dylanchess0320/LuckyD-Code/issues
+Author-email: Dylan Kaye <dylanchess0320@users.noreply.github.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,assistant,cli,coding,luckyd
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: aiofiles>=23.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: nest-asyncio>=1.5.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tiktoken>=0.5.0
+Requires-Dist: uvicorn>=0.23.0
+Requires-Dist: websockets>=11.0
+Provides-Extra: browser
+Requires-Dist: playwright>=1.40.0; extra == 'browser'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: types-aiofiles; extra == 'dev'
+Requires-Dist: types-beautifulsoup4; extra == 'dev'
+Requires-Dist: types-pyyaml; extra == 'dev'
+Provides-Extra: rag
+Requires-Dist: numpy>=1.24.0; extra == 'rag'
+Requires-Dist: sentence-transformers>=2.2.0; extra == 'rag'
+Provides-Extra: rag-full
+Requires-Dist: faiss-cpu>=1.7.0; extra == 'rag-full'
+Requires-Dist: numpy>=1.24.0; extra == 'rag-full'
+Requires-Dist: sentence-transformers>=2.2.0; extra == 'rag-full'
+Requires-Dist: watchdog>=3.0.0; extra == 'rag-full'
+Description-Content-Type: text/markdown
+
+# LuckyD Code
+
+[![CI](https://github.com/Dylanchess0320/LuckyD-Code/actions/workflows/ci.yml/badge.svg)](https://github.com/Dylanchess0320/LuckyD-Code/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/luckyd-code)](https://pypi.org/project/luckyd-code/)
+
+A full-featured AI coding assistant for your terminal and browser, powered by the DeepSeek API. Features 35+ built-in tools, a semantic knowledge graph, Playwright browser automation, multi-agent orchestration, Docker sandboxing, and a live Web UI.
+
+---
+
+## Features
+
+- **AI Chat** — Conversational coding assistant with streaming responses and thinking/reasoning mode
+- **Smart Model Routing** — Auto-classifies prompt complexity into 4 tiers, escalating from cheap/fast to powerful/reasoning models
+- **Knowledge Graph** — Automatically indexes your codebase into a searchable vector graph; falls back to a keyword graph if vector dependencies aren't installed
+- **Memory System** — Persistent memory across sessions with auto-save and relevance search
+- **Cost Tracking** — Per-session and cumulative cost tracking across models
+- **Web UI** — Browser-based interface with cost panel, memory management, and model routing info
+- **35+ Built-in Tools** — File operations, search, code analysis, shell commands, and more
+- **MCP Support** — Model Context Protocol for extending with custom tools
+- **Plugin System** — Drop Python files into `~/.claude/plugins/` to register additional tools at runtime
+- **Context Management** — Auto-compaction with summarization to stay within context windows
+- **Background Agents** — Run tasks asynchronously while continuing to chat
+- **Orchestrator** — Researcher → Coder → Reviewer pipeline for complex tasks
+- **Hooks System** — Pre/post tool use, pre/post chat, and session lifecycle hooks
+- **Sandboxing** — Docker-based secure command execution
+- **Session Management** — Save and load conversations
+- **Undo** — Revert file writes and edits
+- **Export** — Export conversations to Markdown or HTML
+- **Shell Detection** — Auto-detects Git Bash → WSL → cmd.exe on Windows; rewrites interactive commands so the correct shell is always used
+- **Analytics** — Code health scoring, code smell detection, and trend tracking
+
+---
+
+## Prerequisites
+
+- **Python 3.10+**
+- **DeepSeek API key** — Get one free at [platform.deepseek.com/api_keys](https://platform.deepseek.com/api_keys)
+
+---
+
+## Quick Start — No setup required
+
+**Windows** — double-click one of these:
+- `Install and Run - Windows.bat` — CLI mode
+- `Install and Run Web UI - Windows.bat` — browser UI
+
+**Mac** — double-click `Install and Run - Mac.command`
+*(first time: right-click → Open to bypass Gatekeeper)*
+
+**Linux** — run in terminal:
+```bash
+chmod +x "Install and Run - Linux.sh"
+"./Install and Run - Linux.sh"
+```
+
+The launcher automatically creates a virtual environment, installs dependencies, and prompts for your API key on first run.
+
+---
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install luckyd-code
+```
+
+### From source
+
+```bash
+git clone https://github.com/Dylanchess0320/LuckyD-Code
+cd luckyd-code
+python -m venv .venv
+source .venv/bin/activate  # Windows: .venv\Scripts\activate
+pip install -e .
+```
+
+### Optional dependencies
+
+```bash
+# RAG support (semantic memory search)
+pip install -e ".[rag]"
+
+# Full RAG with FAISS vector search and file watching
+pip install -e ".[rag-full]"
+
+# Browser automation (Playwright)
+pip install -e ".[browser]"
+
+# Development dependencies
+pip install -e ".[dev]"
+```
+
+---
+
+## Usage
+
+### CLI mode
+
+```bash
+luckyd-code
+# or
+ldc
+# or
+python main.py
+```
+
+### Web UI mode
+
+```bash
+luckyd-code --web
+# or
+python main.py --web
+```
+
+Then open `http://localhost:8000` in your browser.
+
+### Commands
+
+Once in the CLI, use slash commands:
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show available commands |
+| `/model` | Switch model or view current model |
+| `/cost` | Show session cost |
+| `/memory` | View or search memory |
+| `/session` | Save, load, or list sessions |
+| `/export` | Export conversation |
+| `/undo` | Undo last file write/edit |
+| `/orchestrate` | Run multi-agent pipeline |
+| `/analytics` | Run code health analysis |
+| `/clear` | Clear conversation |
+| `/quit` | Exit |
+
+### Environment variables
+
+Copy `.env.example` to `.env` and set your API key:
+
+```bash
+cp .env.example .env
+```
+
+Then edit `.env`:
+
+```
+DEEPSEEK_API_KEY=sk-your-deepseek-key-here
+```
+
+---
+
+## Built-in Tools
+
+LuckyD Code includes 35+ tools for interacting with your codebase:
+
+- **File operations**: Read, Write, Edit, Glob, Grep, Delete, Move, Copy
+- **Code analysis**: Lint, TypeCheck, Complexity, Coverage
+- **Search**: Semantic search, keyword search, file search
+- **Shell**: Bash execution, PowerShell, Git operations
+- **Web**: Playwright browser automation, HTTP requests
+- **Knowledge**: Knowledge graph query, memory search
+- **Project**: Project scan, dependency analysis, code smell detection
+- **Utility**: Undo, Export, Session management
+
+---
+
+## Project Structure
+
+```
+luckyd_code/
+├── cli.py               # Terminal UI and REPL
+├── cli_commands/        # Slash-command handlers
+├── web_app.py           # Web UI server (FastAPI)
+├── web_routes/          # Web UI route handlers
+├── api.py               # API streaming client
+├── router.py            # Model routing
+├── config.py            # Configuration
+├── context.py           # Conversation context
+├── cost_tracker.py      # Cost tracking
+├── hooks.py             # Lifecycle hooks
+├── model_registry.py    # Model definitions
+├── memory/              # Persistent memory
+├── brain/               # Knowledge graph & RAG
+├── tools/               # Tool registry (35+ tools)
+├── mcp/                 # MCP client
+├── permissions/         # Permission system
+├── skills/              # Review & security
+├── analytics/           # Usage analytics
+├── templates/           # Web UI assets
+└── background/          # Background agents
+```
+
+---
+
+## Development
+
+```bash
+# Install in editable mode with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# With coverage
+pytest --cov=luckyd_code --cov-report=term
+
+# Type checking
+mypy luckyd_code
+
+# Build distribution
+make build
+```
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
+
+1. Fork the repository
+2. Create a feature branch from `main`
+3. Write tests for new functionality
+4. Ensure all existing tests pass
+5. Submit a pull request
+
+---
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## Security
+
+See [SECURITY.md](SECURITY.md) for supported versions and how to report vulnerabilities.
+
+---
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for a history of changes.