update project docs

Author: ryanmerolle

.github/workflows/QUICKSTART.md

@@ -55,8 +55,8 @@ The `publish-pypi.yml` workflow uses a pre-built Docker image for faster executi
 **Or build locally:**
 
 ```bash
-docker build -t ghcr.io/opensecflow/netdriver/python-poetry:3.12 -f .github/Dockerfile.ci .
-docker push ghcr.io/opensecflow/netdriver/python-poetry:3.12
+docker build -t ghcr.io/opensecflow/netdriver/python-uv:3.12 -f .github/Dockerfile.ci .
+docker push ghcr.io/opensecflow/netdriver/python-uv:3.12
 ```
 
 **Note**: This only needs to be done once. The image will be cached and reused.
@@ -103,8 +103,8 @@ Before publishing to production PyPI, test with TestPyPI:
 
 ```bash
 # 1. Update version numbers
-poetry version -P projects/agent 0.3.1
-poetry version -P projects/simunet 0.3.1
+sed -i 's/^version = ".*"/version = "0.3.1"/' projects/agent/pyproject.toml
+sed -i 's/^version = ".*"/version = "0.3.1"/' projects/simunet/pyproject.toml
 
 # 2. Commit changes
 git add projects/*/pyproject.toml
@@ -156,20 +156,21 @@ The `release.yml` workflow will automatically:
 **Solution:** Version already exists on PyPI. Bump the version:
 
 ```bash
-poetry version -P projects/agent patch
-poetry version -P projects/simunet patch
+# Manually update version in pyproject.toml files
+sed -i 's/^version = ".*"/version = "0.3.2"/' projects/agent/pyproject.toml
+sed -i 's/^version = ".*"/version = "0.3.2"/' projects/simunet/pyproject.toml
 # Then rebuild and publish
 ```
 
-### Workflow fails with "Poetry not found" or image pull error
+### Workflow fails with "uv not found" or image pull error
 
 **Solution:** Build the CI Docker image first
 
 ```bash
 # Go to Actions → "Build CI Image" → Run workflow
 ```
 
-Or check the image name matches: `ghcr.io/opensecflow/netdriver/python-poetry:3.12`
+Or check the image name matches: `ghcr.io/opensecflow/netdriver/python-uv:3.12`
 
 ### Package shows as "0 B" or malformed
 
@@ -198,7 +199,7 @@ unzip -l projects/agent/dist/netdriver_agent-*.whl
 ### Release Process
 
 1. Develop features on branches
-2. Test locally: `poetry build-project -C projects/agent`
+2. Test locally: `uv build --directory projects/agent`
 3. Create PR and verify build test passes
 4. Merge to master
 5. Test on TestPyPI

.github/workflows/README.md

@@ -30,7 +30,7 @@ This directory contains GitHub Actions workflows for automated building, testing
 
 **What it does**:
 
-- Uses pre-built Docker container with Poetry installed
+- Uses pre-built Docker container with uv installed
 - Builds wheel packages for selected projects
 - Publishes to PyPI or TestPyPI
 - Uploads build artifacts
@@ -68,7 +68,7 @@ The project supports independent release workflows for agent and simunet:
 
 ```bash
 # Update agent version in pyproject.toml (optional, will be updated by workflow)
-poetry version 1.0.0 -C projects/agent
+sed -i 's/^version = ".*"/version = "1.0.0"/' projects/agent/pyproject.toml
 
 # Commit version changes (optional)
 git add projects/agent/pyproject.toml
@@ -98,7 +98,7 @@ git push origin agent-1.0.0
 
 ```bash
 # Update simunet version in pyproject.toml (optional, will be updated by workflow)
-poetry version 2.5.0 -C projects/simunet
+sed -i 's/^version = ".*"/version = "2.5.0"/' projects/simunet/pyproject.toml
 
 # Commit version changes (optional)
 git add projects/simunet/pyproject.toml
@@ -165,7 +165,7 @@ Use this when you only need to release the agent:
 1. **Update version number** (optional):
 
    ```bash
-   poetry version 1.0.0 -C projects/agent
+   sed -i 's/^version = ".*"/version = "1.0.0"/' projects/agent/pyproject.toml
    ```
 
 2. **Commit changes** (optional):
@@ -197,7 +197,7 @@ Use this when you need to release simunet:
 1. **Update version number** (optional):
 
    ```bash
-   poetry version 2.5.0 -C projects/simunet
+   sed -i 's/^version = ".*"/version = "2.5.0"/' projects/simunet/pyproject.toml
    ```
 
 2. **Commit changes** (optional):
@@ -235,8 +235,8 @@ To test publishing before official release:
 2. **Or use CLI**:
 
    ```bash
-   poetry publish -P projects/agent -r testpypi
-   poetry publish -P projects/simunet -r testpypi
+   uv publish --directory projects/agent --publish-url https://test.pypi.org/legacy/ --token $TESTPYPI_TOKEN
+   uv publish --directory projects/simunet --publish-url https://test.pypi.org/legacy/ --token $TESTPYPI_TOKEN
    ```
 
 3. **Verify on TestPyPI**:
@@ -382,12 +382,12 @@ The project uses prefixed tag patterns for independent releases:
 
 ### 5. Build CI Image (`build-ci-image.yml`)
 
-**Purpose**: Creates a Docker image with Poetry and Python pre-installed for faster CI/CD
+**Purpose**: Creates a Docker image with uv and Python pre-installed for faster CI/CD
 
 **What it includes**:
 
 - Python 3.12
-- Poetry with multiproject and polylith plugins
+- uv package manager
 - Git and essential build tools
 
 **Building the image**:
@@ -408,24 +408,24 @@ The `publish-pypi.yml` workflow uses this approach:
 jobs:
   publish:
     runs-on: ubuntu-latest
-    container:
-      image: ghcr.io/${{ github.repository }}/python-poetry:3.12
     steps:
       - uses: actions/checkout@v4
-      # Poetry and plugins are already installed!
-      - run: poetry build-project -C projects/agent
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install
+      - run: uv sync
+      - run: uv build --directory projects/agent
 ```
 
 **Benefits of using Docker image**:
 
-- ⚡ **Faster**: No need to install Poetry and plugins on every run
+- ⚡ **Faster**: No need to install uv on every run
 - 🔒 **Consistent**: Same environment across all workflows
 - 💾 **Cacheable**: Image layers are cached by Docker
 - 🎯 **Reproducible**: Exact same versions every time
 
 **Image locations**:
 
-- GitHub Container Registry: `ghcr.io/opensecflow/netdriver/python-poetry:3.12`
+- GitHub Container Registry: `ghcr.io/opensecflow/netdriver/python-uv:3.12`
 - Available tags: `latest`, `master`, `<branch>-<sha>`
 
 **Benefits**:
@@ -485,20 +485,18 @@ container:
     password: ${{ secrets.DOCKER_PASSWORD }}
 ```
 
-### 3. Verify Poetry is available
+### 3. Verify uv is available
 
-Poetry and plugins are pre-installed, so you can use them directly:
+uv is pre-installed, so you can use it directly:
 
 ```yaml
-- name: Verify Poetry installation
+- name: Verify uv installation
   run: |
-    poetry --version
-    poetry self show plugins
+    uv --version
 ```
 
 ## References
 
-- [Poetry Documentation](https://python-poetry.org/docs/)
-- [Poetry Polylith Plugin](https://github.com/DavidVujic/poetry-polylith-plugin)
+- [uv Documentation](https://docs.astral.sh/uv/)
 - [PyPI Publishing Guide](https://packaging.python.org/tutorials/packaging-projects/)
 - [GitHub Actions - Python](https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python)

CLAUDE.md

@@ -63,37 +63,33 @@ Sessions track device state including:
 
 ```bash
 # Install dependencies
-poetry install
-
-# Install Poetry plugins (if not already installed)
-poetry self add poetry-multiproject-plugin
-poetry self add poetry-polylith-plugin
+uv sync
 ```
 
 ### Running Services
 
 ```bash
 # Start agent service (REST API on http://localhost:8000)
-poetry run agent
+uv run agent
 
 # Start simulation network service (SSH servers on configured ports)
-poetry run simunet
+uv run simunet
 ```
 
 ### Testing
 
 ```bash
 # Run all tests
-poetry run pytest
+uv run pytest
 
 # Run unit tests only
-poetry run pytest -m unit
+uv run pytest -m unit
 
 # Run integration tests only
-poetry run pytest -m integration
+uv run pytest -m integration
 
 # Run specific test file
-poetry run pytest tests/bases/netdriver/agent/test_cisco_nexus.py
+uv run pytest tests/bases/netdriver/agent/test_cisco_nexus.py
 ```
 
 ### Configuration
@@ -176,7 +172,7 @@ Uses Loguru configured via `netdriver.log.logman`:
 ## Important Notes
 
 - Python 3.12+ required
-- Uses Poetry for dependency management
+- Uses uv for dependency management
 - All SSH operations are async (AsyncSSH-based)
 - Session keys format: `{protocol}:{username}@{ip}:{port}`
 - The agent runs with auto-reload enabled by default (suitable for development)

CONTRIBUTING.md

@@ -4,16 +4,37 @@ Thank you for your interest in contributing to NetDriver! We welcome contributio
 
 ## Table of Contents
 
-- [Code of Conduct](#code-of-conduct)
-- [Getting Started](#getting-started)
-- [Development Environment Setup](#development-environment-setup)
-- [How to Contribute](#how-to-contribute)
-- [Development Guidelines](#development-guidelines)
-- [Adding a New Device Plugin](#adding-a-new-device-plugin)
-- [Testing](#testing)
-- [Pull Request Process](#pull-request-process)
-- [Reporting Bugs](#reporting-bugs)
-- [Feature Requests](#feature-requests)
+- [Contributing to NetDriver](#contributing-to-netdriver)
+  - [Table of Contents](#table-of-contents)
+  - [Code of Conduct](#code-of-conduct)
+    - [Our Pledge](#our-pledge)
+    - [Our Standards](#our-standards)
+    - [Enforcement](#enforcement)
+  - [Getting Started](#getting-started)
+  - [Development Environment Setup](#development-environment-setup)
+    - [Prerequisites](#prerequisites)
+    - [Setup Steps](#setup-steps)
+  - [How to Contribute](#how-to-contribute)
+  - [Development Guidelines](#development-guidelines)
+    - [Code Style](#code-style)
+    - [Example Code Style](#example-code-style)
+    - [Commit Messages](#commit-messages)
+    - [Branch Naming](#branch-naming)
+  - [Adding a New Device Plugin](#adding-a-new-device-plugin)
+    - [1. Create Plugin File](#1-create-plugin-file)
+    - [2. Implement Plugin Class](#2-implement-plugin-class)
+    - [3. Add Tests](#3-add-tests)
+    - [4. Update Documentation](#4-update-documentation)
+  - [Testing](#testing)
+    - [Running Tests](#running-tests)
+    - [Writing Tests](#writing-tests)
+  - [Pull Request Process](#pull-request-process)
+  - [Reporting Bugs](#reporting-bugs)
+  - [Screenshots](#screenshots)
+  - [Feature Requests](#feature-requests)
+  - [Project Structure](#project-structure)
+  - [Questions or Need Help?](#questions-or-need-help)
+  - [Recognition](#recognition)
 
 ## Code of Conduct
 
@@ -59,7 +80,7 @@ Before you start contributing, please:
 ### Prerequisites
 
 - Python 3.12 or higher
-- Poetry 1.8.3 or higher
+- uv 0.9.26 or higher (https://docs.astral.sh/uv/)
 - Git
 
 ### Setup Steps
@@ -82,27 +103,23 @@ Before you start contributing, please:
    pyenv local 3.12.7
    ```
 
-3. **Install Poetry**
+3. **Install uv**
 
    ```bash
-   curl -sSL https://install.python-poetry.org | python3 -
-
-   # Install Poetry plugins
-   poetry self add poetry-multiproject-plugin
-   poetry self add poetry-polylith-plugin
+   curl -LsSf https://astral.sh/uv/install.sh | sh
    ```
 
 4. **Install Dependencies**
 
    ```bash
-   poetry install
+   uv sync
    ```
 
 5. **Verify Installation**
 
    ```bash
    # Run tests to ensure everything is working
-   poetry run pytest
+   uv run pytest
    ```
 
 ## How to Contribute
@@ -257,19 +274,19 @@ Add the new plugin to the supported devices list in the README.
 
 ```bash
 # Run all tests
-poetry run pytest
+uv run pytest
 
 # Run with coverage
-poetry run pytest --cov=components --cov=bases
+uv run pytest --cov=components --cov=bases
 
 # Run specific test file
-poetry run pytest tests/bases/netdriver/agent/test_cisco_nexus.py
+uv run pytest tests/bases/netdriver/agent/test_cisco_nexus.py
 
 # Run unit tests only
-poetry run pytest -m unit
+uv run pytest -m unit
 
 # Run integration tests only
-poetry run pytest -m integration
+uv run pytest -m integration
 ```
 
 ### Writing Tests

README.md

@@ -4,7 +4,7 @@
 <a name="top"></a>
 
 [![Python](https://img.shields.io/badge/Python-3.12%2B-blue.svg)](https://www.python.org/)
-[![Poetry](https://img.shields.io/badge/Poetry-1.8.3-60A5FA.svg)](https://python-poetry.org/)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
 [![License](https://img.shields.io/badge/License-Apache_2.0-green.svg)](./LICENSE)
 [![Build & Test](https://github.com/OpenSecFlow/netdriver/actions/workflows/build.yml/badge.svg)](https://github.com/OpenSecFlow/netdriver/actions/workflows/build.yml)
 [![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-orange.svg)](./CONTRIBUTING.md)

scripts/README.md

@@ -34,10 +34,10 @@ A convenient script to create and push release tags.
 ### What it does
 
 1. Validates input parameters
-2. Checks prerequisites (git repository, poetry installation)
+2. Checks prerequisites (git repository, uv installation)
 3. Verifies working directory is clean
 4. Verifies the tag doesn't already exist
-5. Updates version in `projects/<project>/pyproject.toml` using `poetry version`
+5. Updates version in `projects/<project>/pyproject.toml`
 6. Commits the version change
 7. Creates an annotated git tag (e.g., `agent-0.3.5`)
 8. Pushes the commit and tag to remote
@@ -84,7 +84,7 @@ git push origin :refs/tags/agent-0.3.5
 
 ### Prerequisites
 
-- **Poetry** installed and configured
+- **uv** installed and configured
 - **Git** configured and authenticated
 - Push permissions to the repository
 - **Clean working directory** (no uncommitted changes)

tests/bases/netdriver/agent/conftest.py

@@ -59,7 +59,7 @@ def simunet_process(request: pytest.FixtureRequest):
     # Start simunet process using uvicorn directly
     logman.logger.info("Starting simunet process for integration tests...")
     process = subprocess.Popen(
-        ["poetry", "run", "simunet"],
+        ["uv", "run", "simunet"],
         stdout=subprocess.PIPE,
         stderr=subprocess.PIPE,
         text=True