omnigent-rovo 0.1.0__tar.gz

omnigent_rovo-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install ruff
+      - run: ruff check .
+      - run: ruff format --check .
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+      - name: Run tests
+        run: pytest -v

omnigent_rovo-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Install build tools
+        run: pip install build
+      - name: Build package
+        run: python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

omnigent_rovo-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+.env
+*.so
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/

omnigent_rovo-0.1.0/.idea/.gitignore

@@ -0,0 +1,10 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Ignored default folder with query files
+/queries/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

omnigent_rovo-0.1.0/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+  </profile>
+</component>

omnigent_rovo-0.1.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

omnigent_rovo-0.1.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/omnigent-rovo.iml" filepath="$PROJECT_DIR$/.idea/omnigent-rovo.iml" />
+    </modules>
+  </component>
+</project>

omnigent_rovo-0.1.0/.idea/omnigent-rovo.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

omnigent_rovo-0.1.0/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

omnigent_rovo-0.1.0/.idea/workspace.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectViewState">
+    <option name="autoscrollFromSource" value="true" />
+    <option name="autoscrollToSource" value="true" />
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent">{}</component>
+</project>

omnigent_rovo-0.1.0/LICENSE

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

omnigent_rovo-0.1.0/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: omnigent-rovo
+Version: 0.1.0
+Summary: Rovo Dev harness plugin for Omnigent — drives Atlassian Rovo Dev via its ACP server.
+Project-URL: Homepage, https://github.com/shbhmrzd/omnigent-rovo
+Project-URL: Repository, https://github.com/shbhmrzd/omnigent-rovo
+Author: Shubham Raizada
+License-Expression: MIT
+License-File: LICENSE
+Keywords: acp,atlassian,harness,omnigent,rovo
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: omnigent>=0.4.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# omnigent-rovo
+
+Community harness plugin that brings [Atlassian Rovo Dev](https://support.atlassian.com/rovo/docs/use-rovo-dev-cli/) to [Omnigent](https://github.com/omnigent-ai/omnigent) as a first-class harness.
+
+Rovo Dev is an AI-powered development agent that runs in your terminal via the [Atlassian CLI (`acli`)](https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/). It can generate, review, and refactor code, analyze codebases, write documentation, debug issues, create tests, and integrates with Jira and Confluence — all from the command line.
+
+This plugin drives Rovo Dev via its **ACP (Agent Client Protocol)** server mode (`acli rovodev acp`) over stdio — no tmux terminal needed.
+
+## Quick start
+
+```bash
+# Install both packages
+uv pip install omnigent omnigent-rovo
+
+# Or with pip
+pip install omnigent omnigent-rovo
+```
+
+Once installed, Omnigent automatically discovers the plugin and makes `rovo` available as a harness:
+
+```yaml
+# agent.yaml
+harness: rovo
+```
+
+## Verifying the installation
+
+After installing both packages, confirm the plugin is detected:
+
+```bash
+python -c "
+from omnigent.harness_plugins import plugin_state, harness_aliases, harness_labels
+state = plugin_state()
+print('Contributions:', [c.name for c in state.contributions])
+print('rovo alias:', harness_aliases().get('rovo'))
+print('Label:', harness_labels().get('rovo-cli'))
+"
+```
+
+Expected output:
+
+```
+Contributions: ['omnigent', 'omnigent-rovo']
+rovo alias: rovo-cli
+Label: Rovo Dev
+```
+
+If `omnigent-rovo` does not appear in the list, make sure both packages are installed in the same Python environment.
+
+## Prerequisites
+
+1. **Rovo Dev subscription** — Rovo Dev CLI requires a paid [Rovo Dev Standard](https://www.atlassian.com/software/rovo-dev) subscription (not available during trial)
+2. **Atlassian CLI (`acli`)** — install or update to the latest version following the [official setup guide](https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/) for your OS (macOS, Linux, or Windows)
+3. **Authenticate** — run `acli rovodev auth login` and complete the browser flow (or use a [scoped API token](https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/))
+4. **Verify** — run `acli rovodev auth status` to confirm you're logged in
+
+> 📖 For full usage documentation, see [Use Rovo Dev CLI](https://support.atlassian.com/rovo/docs/use-rovo-dev-cli/) and [Rovo Dev CLI commands](https://support.atlassian.com/rovo/docs/rovo-dev-cli-commands/).
+
+## Configuration
+
+The harness reads configuration from environment variables (set automatically by the Omnigent runner, or manually for standalone use):
+
+| Variable | Description | Default |
+|---|---|---|
+| `HARNESS_ROVO_MODEL` | Model display name, e.g. `"Claude Sonnet 4.6"` | Rovo's default |
+| `HARNESS_ROVO_CWD` | Working directory for the Rovo Dev subprocess | Current directory |
+| `HARNESS_ROVO_ACLI_PATH` | Absolute path to the `acli` binary | `acli` from `PATH` |
+| `HARNESS_ROVO_CONFIG_FILE` | Rovo Dev `--config-file` path | `~/.rovodev/config.yml` |
+| `HARNESS_ROVO_SITE_URL` | Rovo Dev `--site-url` value | None |
+
+> See [Manage Rovo Dev CLI settings](https://support.atlassian.com/rovo/docs/manage-rovo-dev-cli-settings/) for details on the configuration file format.
+
+## How it works
+
+This plugin registers itself via Python's [entry points](https://packaging.python.org/en/latest/specifications/entry-points/) mechanism:
+
+```toml
+# pyproject.toml
+[project.entry-points."omnigent.community.harness"]
+rovo = "omnigent.community.harness.rovo.plugin:get_contribution"
+```
+
+At startup, Omnigent's plugin registry discovers all packages in the `omnigent.community.harness` entry point group and merges their contributions into the harness registry. This means:
+
+- `rovo` and `rovo-cli` become valid harness names
+- The Rovo executor and ACP client are loaded on demand
+- Model overrides via `/model` work seamlessly
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/shbhmrzd/omnigent-rovo.git
+cd omnigent-rovo
+
+# Create a virtual environment
+uv venv
+source .venv/bin/activate
+
+# Install in editable mode (with omnigent as a dependency)
+uv pip install -e .
+
+# Run the test suite
+uv run pytest
+
+# Run with verbose output
+uv run pytest -v
+```
+
+### Test structure
+
+| Path | Covers |
+|---|---|
+| `tests/conftest.py` | Lightweight stubs for `omnigent` core types so tests run without the full core installed |
+| `tests/test_plugin.py` | Plugin registration (`get_contribution`) |
+| `tests/test_acp_client.py` | ACP client — command building, JSON-RPC dispatch, permission auto-allow |
+| `tests/test_rovo_executor.py` | Executor — message parsing, update translation, session lifecycle, `run_turn` |
+| `tests/test_rovo_harness.py` | Harness entry point — env var config, `create_app()` |
+
+## Publishing to PyPI
+
+### First-time setup
+
+1. **Create a PyPI account** at https://pypi.org/account/register/
+2. **Create an API token** at https://pypi.org/manage/account/token/
+   - Scope: "Entire account" (for the first upload), or project-specific after the first release
+3. **Configure your token** — create/edit `~/.pypirc`:
+   ```ini
+   [pypi]
+   username = __token__
+   password = pypi-YOUR_TOKEN_HERE
+   ```
+
+### Building and publishing
+
+```bash
+# Install build tools
+uv pip install build twine
+
+# Build the package
+python -m build
+
+# This creates:
+#   dist/omnigent_rovo-0.1.0-py3-none-any.whl
+#   dist/omnigent_rovo-0.1.0.tar.gz
+
+# Upload to Test PyPI first (recommended for first release)
+twine upload --repository testpypi dist/*
+
+# Verify the test release works
+uv pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ omnigent-rovo
+
+# Upload to production PyPI
+twine upload dist/*
+```
+
+### Using a Trusted Publisher (recommended for GitHub repos)
+
+Instead of API tokens, you can set up [Trusted Publishing](https://docs.pypi.org/trusted-publishers/) with GitHub Actions:
+
+1. Go to https://pypi.org/manage/account/publishing/
+2. Add a new pending publisher:
+   - **PyPI project name**: `omnigent-rovo`
+   - **Owner**: `shbhmrzd`
+   - **Repository**: `omnigent-rovo`
+   - **Workflow name**: `publish.yml`
+   - **Environment**: `pypi`
+
+3. Create `.github/workflows/publish.yml` in your repo:
+   ```yaml
+   name: Publish to PyPI
+
+   on:
+     release:
+       types: [published]
+
+   jobs:
+     publish:
+       runs-on: ubuntu-latest
+       environment: pypi
+       permissions:
+         id-token: write
+       steps:
+         - uses: actions/checkout@v4
+         - uses: actions/setup-python@v5
+           with:
+             python-version: "3.12"
+         - run: pip install build
+         - run: python -m build
+         - uses: pypa/gh-action-pypi-publish@release/v1
+   ```
+
+4. Create a GitHub release → the workflow auto-publishes to PyPI.
+
+### Version bumps
+
+Update the version in `pyproject.toml`:
+```toml
+[project]
+version = "0.2.0"
+```
+
+Then build and publish as above.
+
+## License
+
+MIT

omnigent_rovo-0.1.0/README.md

@@ -0,0 +1,207 @@
+# omnigent-rovo
+
+Community harness plugin that brings [Atlassian Rovo Dev](https://support.atlassian.com/rovo/docs/use-rovo-dev-cli/) to [Omnigent](https://github.com/omnigent-ai/omnigent) as a first-class harness.
+
+Rovo Dev is an AI-powered development agent that runs in your terminal via the [Atlassian CLI (`acli`)](https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/). It can generate, review, and refactor code, analyze codebases, write documentation, debug issues, create tests, and integrates with Jira and Confluence — all from the command line.
+
+This plugin drives Rovo Dev via its **ACP (Agent Client Protocol)** server mode (`acli rovodev acp`) over stdio — no tmux terminal needed.
+
+## Quick start
+
+```bash
+# Install both packages
+uv pip install omnigent omnigent-rovo
+
+# Or with pip
+pip install omnigent omnigent-rovo
+```
+
+Once installed, Omnigent automatically discovers the plugin and makes `rovo` available as a harness:
+
+```yaml
+# agent.yaml
+harness: rovo
+```
+
+## Verifying the installation
+
+After installing both packages, confirm the plugin is detected:
+
+```bash
+python -c "
+from omnigent.harness_plugins import plugin_state, harness_aliases, harness_labels
+state = plugin_state()
+print('Contributions:', [c.name for c in state.contributions])
+print('rovo alias:', harness_aliases().get('rovo'))
+print('Label:', harness_labels().get('rovo-cli'))
+"
+```
+
+Expected output:
+
+```
+Contributions: ['omnigent', 'omnigent-rovo']
+rovo alias: rovo-cli
+Label: Rovo Dev
+```
+
+If `omnigent-rovo` does not appear in the list, make sure both packages are installed in the same Python environment.
+
+## Prerequisites
+
+1. **Rovo Dev subscription** — Rovo Dev CLI requires a paid [Rovo Dev Standard](https://www.atlassian.com/software/rovo-dev) subscription (not available during trial)
+2. **Atlassian CLI (`acli`)** — install or update to the latest version following the [official setup guide](https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/) for your OS (macOS, Linux, or Windows)
+3. **Authenticate** — run `acli rovodev auth login` and complete the browser flow (or use a [scoped API token](https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/))
+4. **Verify** — run `acli rovodev auth status` to confirm you're logged in
+
+> 📖 For full usage documentation, see [Use Rovo Dev CLI](https://support.atlassian.com/rovo/docs/use-rovo-dev-cli/) and [Rovo Dev CLI commands](https://support.atlassian.com/rovo/docs/rovo-dev-cli-commands/).
+
+## Configuration
+
+The harness reads configuration from environment variables (set automatically by the Omnigent runner, or manually for standalone use):
+
+| Variable | Description | Default |
+|---|---|---|
+| `HARNESS_ROVO_MODEL` | Model display name, e.g. `"Claude Sonnet 4.6"` | Rovo's default |
+| `HARNESS_ROVO_CWD` | Working directory for the Rovo Dev subprocess | Current directory |
+| `HARNESS_ROVO_ACLI_PATH` | Absolute path to the `acli` binary | `acli` from `PATH` |
+| `HARNESS_ROVO_CONFIG_FILE` | Rovo Dev `--config-file` path | `~/.rovodev/config.yml` |
+| `HARNESS_ROVO_SITE_URL` | Rovo Dev `--site-url` value | None |
+
+> See [Manage Rovo Dev CLI settings](https://support.atlassian.com/rovo/docs/manage-rovo-dev-cli-settings/) for details on the configuration file format.
+
+## How it works
+
+This plugin registers itself via Python's [entry points](https://packaging.python.org/en/latest/specifications/entry-points/) mechanism:
+
+```toml
+# pyproject.toml
+[project.entry-points."omnigent.community.harness"]
+rovo = "omnigent.community.harness.rovo.plugin:get_contribution"
+```
+
+At startup, Omnigent's plugin registry discovers all packages in the `omnigent.community.harness` entry point group and merges their contributions into the harness registry. This means:
+
+- `rovo` and `rovo-cli` become valid harness names
+- The Rovo executor and ACP client are loaded on demand
+- Model overrides via `/model` work seamlessly
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/shbhmrzd/omnigent-rovo.git
+cd omnigent-rovo
+
+# Create a virtual environment
+uv venv
+source .venv/bin/activate
+
+# Install in editable mode (with omnigent as a dependency)
+uv pip install -e .
+
+# Run the test suite
+uv run pytest
+
+# Run with verbose output
+uv run pytest -v
+```
+
+### Test structure
+
+| Path | Covers |
+|---|---|
+| `tests/conftest.py` | Lightweight stubs for `omnigent` core types so tests run without the full core installed |
+| `tests/test_plugin.py` | Plugin registration (`get_contribution`) |
+| `tests/test_acp_client.py` | ACP client — command building, JSON-RPC dispatch, permission auto-allow |
+| `tests/test_rovo_executor.py` | Executor — message parsing, update translation, session lifecycle, `run_turn` |
+| `tests/test_rovo_harness.py` | Harness entry point — env var config, `create_app()` |
+
+## Publishing to PyPI
+
+### First-time setup
+
+1. **Create a PyPI account** at https://pypi.org/account/register/
+2. **Create an API token** at https://pypi.org/manage/account/token/
+   - Scope: "Entire account" (for the first upload), or project-specific after the first release
+3. **Configure your token** — create/edit `~/.pypirc`:
+   ```ini
+   [pypi]
+   username = __token__
+   password = pypi-YOUR_TOKEN_HERE
+   ```
+
+### Building and publishing
+
+```bash
+# Install build tools
+uv pip install build twine
+
+# Build the package
+python -m build
+
+# This creates:
+#   dist/omnigent_rovo-0.1.0-py3-none-any.whl
+#   dist/omnigent_rovo-0.1.0.tar.gz
+
+# Upload to Test PyPI first (recommended for first release)
+twine upload --repository testpypi dist/*
+
+# Verify the test release works
+uv pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ omnigent-rovo
+
+# Upload to production PyPI
+twine upload dist/*
+```
+
+### Using a Trusted Publisher (recommended for GitHub repos)
+
+Instead of API tokens, you can set up [Trusted Publishing](https://docs.pypi.org/trusted-publishers/) with GitHub Actions:
+
+1. Go to https://pypi.org/manage/account/publishing/
+2. Add a new pending publisher:
+   - **PyPI project name**: `omnigent-rovo`
+   - **Owner**: `shbhmrzd`
+   - **Repository**: `omnigent-rovo`
+   - **Workflow name**: `publish.yml`
+   - **Environment**: `pypi`
+
+3. Create `.github/workflows/publish.yml` in your repo:
+   ```yaml
+   name: Publish to PyPI
+
+   on:
+     release:
+       types: [published]
+
+   jobs:
+     publish:
+       runs-on: ubuntu-latest
+       environment: pypi
+       permissions:
+         id-token: write
+       steps:
+         - uses: actions/checkout@v4
+         - uses: actions/setup-python@v5
+           with:
+             python-version: "3.12"
+         - run: pip install build
+         - run: python -m build
+         - uses: pypa/gh-action-pypi-publish@release/v1
+   ```
+
+4. Create a GitHub release → the workflow auto-publishes to PyPI.
+
+### Version bumps
+
+Update the version in `pyproject.toml`:
+```toml
+[project]
+version = "0.2.0"
+```
+
+Then build and publish as above.
+
+## License
+
+MIT

omnigent_rovo-0.1.0/omnigent/__init__.py

@@ -0,0 +1,4 @@
+# Namespace package — do not add code here.
+# This file makes ``omnigent`` a regular package within the plugin so that
+# ``omnigent.community.harness.rovo`` resolves correctly when both
+# ``omnigent`` (core) and ``omnigent-rovo`` (this plugin) are installed.

omnigent_rovo-0.1.0/omnigent/community/__init__.py

@@ -0,0 +1 @@
+# Namespace anchor — community harness plugins live under this package.

omnigent_rovo-0.1.0/omnigent/community/harness/__init__.py

@@ -0,0 +1 @@
+# Namespace anchor — each community harness is a sub-package here.

omnigent_rovo-0.1.0/omnigent/community/harness/rovo/__init__.py

@@ -0,0 +1 @@
+# omnigent-rovo: Rovo Dev harness plugin for Omnigent.

omnigent_rovo-0.1.0/omnigent/community/harness/rovo/inner/__init__.py

@@ -0,0 +1 @@
+# Inner harness modules for the Rovo Dev community plugin.