ctrlrelay 0.1.5__tar.gz

ctrlrelay-0.1.5/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,45 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: 'bug'
+assignees: ''
+---
+
+## Bug Description
+
+A clear and concise description of what the bug is.
+
+## Steps to Reproduce
+
+1. Go to '...'
+2. Click on '...'
+3. Scroll down to '...'
+4. See error
+
+## Expected Behavior
+
+A clear and concise description of what you expected to happen.
+
+## Actual Behavior
+
+A clear and concise description of what actually happened.
+
+## Screenshots
+
+If applicable, add screenshots to help explain your problem.
+
+## Environment
+
+- **OS**: [e.g., macOS 13.0, Windows 11, Ubuntu 22.04]
+- **Browser**: [e.g., Chrome 119, Firefox 120, Safari 17] (if applicable)
+- **Version**: [e.g., 1.2.3]
+- **Node Version**: [e.g., 18.17.0] (if applicable)
+
+## Additional Context
+
+Add any other context about the problem here.
+
+## Possible Solution
+
+If you have suggestions on how to fix the bug, please describe them here.

ctrlrelay-0.1.5/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,41 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: 'enhancement'
+assignees: ''
+---
+
+## Feature Description
+
+A clear and concise description of the feature you'd like to see.
+
+## Problem Statement
+
+Describe the problem this feature would solve. Ex. I'm always frustrated when [...]
+
+## Proposed Solution
+
+A clear and concise description of what you want to happen.
+
+## Alternatives Considered
+
+Describe any alternative solutions or features you've considered.
+
+## Use Case
+
+Describe the use case(s) for this feature. Who would benefit from it and how?
+
+## Additional Context
+
+Add any other context, screenshots, or examples about the feature request here.
+
+## Implementation Ideas
+
+If you have ideas about how this could be implemented, please share them here.
+
+## Willingness to Contribute
+
+- [ ] I am willing to help implement this feature
+- [ ] I can help with documentation
+- [ ] I can help with testing

ctrlrelay-0.1.5/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,49 @@
+# Description
+
+Please include a summary of the changes and the related issue. Please also include relevant motivation and context.
+
+Fixes # (issue)
+
+## Type of Change
+
+Please delete options that are not relevant.
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Performance improvement
+- [ ] Code refactoring
+- [ ] Dependency update
+
+## How Has This Been Tested?
+
+Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce.
+
+- [ ] Test A
+- [ ] Test B
+
+**Test Configuration**:
+- OS:
+- Node version:
+- Other relevant details:
+
+## Checklist
+
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published
+- [ ] I have updated the CHANGELOG.md
+
+## Screenshots (if applicable)
+
+Add screenshots to help explain your changes.
+
+## Additional Notes
+
+Add any additional notes or context about the pull request here.

ctrlrelay-0.1.5/.github/dependabot.yml

@@ -0,0 +1,27 @@
+version: 2
+updates:
+  # Weekly updates for our own GitHub Actions workflows.
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "ci"
+
+  # Weekly updates for our Python runtime + dev dependencies.
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "chore(deps)"
+    # Respect our configured policies — patch auto, minor ask, major never.
+    versioning-strategy: "increase-if-necessary"

ctrlrelay-0.1.5/.github/workflows/build.yml

@@ -0,0 +1,51 @@
+name: Build Python distribution
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+  release:
+    types: [published]
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: Build sdist and wheel
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: List built artifacts
+        run: ls -la dist/
+
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/*
+          if-no-files-found: error
+
+      - name: Attach artifacts to GitHub release
+        if: github.event_name == 'release' || startsWith(github.ref, 'refs/tags/v')
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          TAG="${GITHUB_REF#refs/tags/}"
+          if [ "$GITHUB_EVENT_NAME" = "release" ]; then
+            TAG="${{ github.event.release.tag_name }}"
+          fi
+          echo "Uploading dist/* to release ${TAG}"
+          gh release upload "${TAG}" dist/* --repo "${GITHUB_REPOSITORY}" --clobber

ctrlrelay-0.1.5/.github/workflows/cla.yml

@@ -0,0 +1,28 @@
+name: CLA Assistant
+
+# Delegates to AInvirion's org-wide reusable CLA workflow, which wraps
+# `contributor-assistant/github-action` and enforces the Contributor
+# Assignment Agreement. See:
+#
+#   https://github.com/AInvirion/.github/blob/main/.github/workflows/cla.yml
+#
+# Requirements (configured at the org level, not in this repo):
+# - `CLA_TOKEN` organization secret with Contents + Pull requests
+#   write access.
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_target:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: write
+  pull-requests: write
+  actions: read
+
+jobs:
+  cla:
+    uses: AInvirion/.github/.github/workflows/cla.yml@main
+    secrets:
+      CLA_TOKEN: ${{ secrets.CLA_TOKEN }}

ctrlrelay-0.1.5/.github/workflows/pages.yml

@@ -0,0 +1,63 @@
+name: Deploy docs to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - ".github/workflows/pages.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: docs
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+          working-directory: docs
+
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v6
+
+      - name: Build site
+        env:
+          JEKYLL_ENV: production
+        run: |
+          bundle exec jekyll build \
+            --source . \
+            --destination ./_site
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5

ctrlrelay-0.1.5/.github/workflows/publish.yml

@@ -0,0 +1,67 @@
+name: Publish to PyPI
+
+# Publishes the built sdist + wheel to PyPI on every GitHub release.
+#
+# Uses PyPI Trusted Publishing (OIDC) — no API tokens stored as GitHub
+# secrets. The project must be registered on PyPI with a trusted
+# publisher pointing at this exact workflow:
+#
+#   Project:     ctrlrelay
+#   Owner:       AInvirion
+#   Repository:  ctrlrelay
+#   Workflow:    publish.yml
+#   Environment: pypi
+#
+# The `pypi` environment adds a manual approval gate — releases pause
+# at the "Publish" step until a repo maintainer approves, so a
+# compromised tag alone can't silently push to PyPI.
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build sdist and wheel
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+
+      - name: Build
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/*
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/ctrlrelay/
+    permissions:
+      id-token: write   # required for OIDC token exchange with PyPI
+
+    steps:
+      - name: Download built artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI (trusted publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1

ctrlrelay-0.1.5/.github/workflows/test.yml

@@ -0,0 +1,45 @@
+name: Tests and lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: pytest + ruff
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+
+      - name: Create virtual environment
+        # setup-uv@v7 dropped the implicit auto-venv that v5 created via
+        # VIRTUAL_ENV. Ubuntu 24.04's system Python is PEP 668 marked
+        # ("externally managed") so --system also fails. Create our own
+        # venv explicitly; uv exports VIRTUAL_ENV so subsequent uv pip /
+        # uv run steps pick it up automatically.
+        run: uv venv
+
+      - name: Install project with dev extras
+        run: uv pip install -e ".[dev]"
+
+      - name: Ruff lint
+        run: uv run ruff check src/ tests/
+
+      - name: Pytest
+        # Deselect the pre-existing unrelated docs-site test that asserts
+        # nav_order uniqueness across docs/ — tracked separately and
+        # unchanged by this PR.
+        run: |
+          uv run pytest tests/ -v \
+            --deselect tests/test_docs_site.py::test_nav_order_unique_per_sibling_group

ctrlrelay-0.1.5/.gitignore

@@ -0,0 +1,39 @@
+*.swp
+*.swo
+.DS_Store
+node_modules/
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+.coverage
+
+# IDE
+.idea/
+.vscode/
+
+# Claude local state (worktrees, sessions, etc.)
+.claude/
+
+# Jekyll (docs site)
+docs/_site/
+docs/.jekyll-cache/
+docs/.jekyll-metadata
+docs/vendor/
+docs/Gemfile.lock
+
+# Backup of old config system
+bkp/
+
+# Operator-specific config — ship only the .example. The real file
+# contains personal chat_id, private repo list, and local paths.
+config/orchestrator.yaml
+
+# Historic local artifact — not consumed by ctrlrelay itself. Keeps a
+# local list of repos to clone; no reason to track it publicly.
+repos.manifest
+
+
+# Lock file — not committed per AInvirion Python-SDK convention.
+uv.lock