robotframework-chat 1.0.0__tar.gz

robotframework_chat-1.0.0/.env.example

@@ -0,0 +1,50 @@
+# robotframework-chat environment configuration
+# Copy to .env and edit before running: cp .env.example .env
+
+# ── PostgreSQL ────────────────────────────────────────────────────────
+POSTGRES_USER=rfc
+POSTGRES_PASSWORD=changeme
+POSTGRES_DB=rfc
+POSTGRES_PORT=5433
+
+# ── Superset ──────────────────────────────────────────────────────────
+SUPERSET_SECRET_KEY=generate-a-random-secret-here
+SUPERSET_PORT=8088
+SUPERSET_ADMIN_USER=admin
+SUPERSET_ADMIN_PASSWORD=changeme
+SUPERSET_ADMIN_EMAIL=admin@rfc.local
+
+# ── Test runner ───────────────────────────────────────────────────────
+# DATABASE_URL tells the test harness to archive to PostgreSQL.
+# Construct from the variables above.
+DATABASE_URL=postgresql://rfc:changeme@localhost:5433/rfc
+
+# Ollama endpoint for LLM tests
+OLLAMA_ENDPOINT=http://localhost:11434
+DEFAULT_MODEL=gpt-oss:20b
+# Timeout in seconds for Ollama generate requests (increase for large models)
+OLLAMA_TIMEOUT=300
+
+# Comma-separated list of Ollama node hostnames for monitoring.
+# With host networking (default Docker setup), localhost and LAN names
+# resolve directly.  With bridge networking, localhost is auto-rewritten
+# to host.docker.internal.
+# Leave empty to use the nodes list from config/test_suites.yaml.
+OLLAMA_NODES_LIST=localhost
+
+# ── AI Code Review (OpenCode + OpenRouter) ─────────────────────────
+# Required for the review pipeline stage (ci/review.sh)
+OPENROUTER_API_KEY=
+
+# Model for markdown audit (default: ollama/qwen3-coder:30b-a3b-q4_K_M)
+# Override to use a different Ollama model or provider
+AUDIT_MODEL=
+
+# ── GitLab Pipeline Monitoring ───────────────────────────────────────
+# Set these to enable GitLab pipeline monitoring.
+# GITLAB_API_URL: Base URL of your GitLab instance (e.g. https://gitlab.example.com)
+# GITLAB_PROJECT_ID: Numeric project ID (Settings > General in GitLab)
+# GITLAB_TOKEN: Personal access token with read_api scope
+GITLAB_API_URL=
+GITLAB_PROJECT_ID=
+GITLAB_TOKEN=

robotframework_chat-1.0.0/.env.remote.example

@@ -0,0 +1,34 @@
+# Remote node environment configuration
+#
+# Copy to .env on each remote Ollama node and edit:
+#   cp .env.remote.example .env
+#
+# A "remote node" is any machine in the fleet (e.g. ai1, Mini1s-Mac-Mini)
+# that runs Ollama and executes Robot Framework tests locally, then sends
+# results back to the central server.
+
+# ── Node Identity ────────────────────────────────────────────────────
+# Friendly name for this node (used in result paths and metadata).
+# Should match the hostname in config/test_suites.yaml.
+NODE_NAME=my-node
+
+# ── Ollama (local to this node) ─────────────────────────────────────
+OLLAMA_ENDPOINT=http://localhost:11434
+DEFAULT_MODEL=llama3.2:latest
+
+# Comma-separated list of Ollama nodes to probe.
+# Set to just "localhost" when this node only tests its own models.
+OLLAMA_NODES_LIST=localhost
+
+# ── Central Database ────────────────────────────────────────────────
+# PostgreSQL connection string for the central results database.
+# Point this at the server running docker-compose (PostgreSQL + Superset).
+# Leave empty to fall back to local SQLite (data/test_history.db).
+DATABASE_URL=postgresql://rfc:changeme@central-server:5433/rfc
+
+# ── Results Server (for make send-results) ──────────────────────────
+# SSH connection details for rsync-ing results to the central server.
+RESULTS_SERVER=central-server
+RESULTS_SERVER_USER=rfc
+RESULTS_SERVER_PATH=/opt/rfc/results/
+RESULTS_SERVER_PORT=22

robotframework_chat-1.0.0/.gitattributes

@@ -0,0 +1,5 @@
+
+# Git LFS for test database
+data/*.db filter=lfs diff=lfs merge=lfs -text
+data/*.sqlite filter=lfs diff=lfs merge=lfs -text
+data/*.sqlite3 filter=lfs diff=lfs merge=lfs -text

robotframework_chat-1.0.0/.github/workflows/mirror-staging-to-gitlab.yml

@@ -0,0 +1,46 @@
+name: Mirror claude-code-staging to GitLab
+
+on:
+  push:
+    branches:
+      - claude-code-staging
+  workflow_dispatch:
+
+jobs:
+  mirror:
+    runs-on: self-hosted
+    environment: robotframework
+    steps:
+      - name: Checkout claude-code-staging (full history)
+        uses: actions/checkout@v4
+        with:
+          ref: claude-code-staging
+          fetch-depth: 0
+
+      - name: Push to GitLab
+        env:
+          GITLAB_TOKEN: ${{ secrets.GITLAB_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          echo "::add-mask::${GITLAB_TOKEN}"
+
+          if [ -z "${GITLAB_TOKEN:-}" ]; then
+            echo "::error::GITLAB_TOKEN secret must be configured."
+            echo "Create a GitLab personal access token with write_repository scope"
+            echo "and add it as a repository secret named GITLAB_TOKEN."
+            exit 1
+          fi
+
+          AUTH_URL="https://oauth2:${GITLAB_TOKEN}@gitlab.com/space-nomads/robotframework-chat.git"
+
+          if git remote get-url gitlab >/dev/null 2>&1; then
+            git remote set-url gitlab "${AUTH_URL}"
+          else
+            git remote add gitlab "${AUTH_URL}"
+          fi
+
+          echo "Mirroring claude-code-staging to GitLab"
+          git push gitlab refs/heads/claude-code-staging:refs/heads/claude-code-staging --force
+
+          echo "Mirror complete."

robotframework_chat-1.0.0/.github/workflows/pypi-publish.yml

@@ -0,0 +1,67 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+  id-token: write  # Required for OIDC trusted publishing
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Validate tag matches package version
+        run: |
+          PKG_VERSION=$(uv run python -c "
+          import tomllib, pathlib
+          data = tomllib.loads(pathlib.Path('pyproject.toml').read_text())
+          print(data['project']['version'])
+          ")
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          echo "Tag version:     $TAG_VERSION"
+          echo "Package version: $PKG_VERSION"
+          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
+            echo "::error::Tag $GITHUB_REF_NAME does not match pyproject.toml version $PKG_VERSION"
+            exit 1
+          fi
+
+      - name: Build sdist and wheel
+        run: uv run python -m build
+
+      - name: Verify distributions
+        run: uv run twine check dist/*
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: pypi
+      url: https://pypi.org/project/robotframework-chat/
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

robotframework_chat-1.0.0/.github/workflows/robot-tests.yml

@@ -0,0 +1,86 @@
+name: Robot Framework Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  lint:
+    name: Lint & Typecheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Ruff check
+        run: uv run ruff check .
+
+      - name: Mypy
+        run: uv run mypy src/
+
+  robot-dryrun:
+    name: Robot Suite Validation (dry-run)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Validate robot files (dry-run)
+        run: uv run robot --dryrun --exclude browser -d results/dryrun robot/
+
+      - name: Upload dry-run results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: dryrun-results
+          path: results/dryrun/
+
+  robot-tests:
+    name: Robot Tests
+    runs-on: self-hosted
+    needs: [lint, robot-dryrun]
+    if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
+    env:
+      LISTENERS: >-
+        --listener rfc.db_listener.DbListener
+        --listener rfc.git_metadata_listener.GitMetaData
+        --listener rfc.ollama_timestamp_listener.OllamaTimestampListener
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run math tests
+        run: uv run robot -d results/math $LISTENERS robot/math/tests/
+
+      - name: Run safety tests
+        if: always()
+        run: uv run robot -d results/safety $LISTENERS robot/safety/
+
+      - name: Run Docker tests
+        if: always()
+        run: uv run robot -d results/docker $LISTENERS robot/docker/
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: robot-results
+          path: results/

robotframework_chat-1.0.0/.github/workflows/sync-from-gitlab.yml

@@ -0,0 +1,88 @@
+name: Sync from GitLab
+
+on:
+  schedule:
+    # Run every 15 minutes to pick up GitLab changes
+    - cron: "*/15 * * * *"
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: "Branch to sync (leave empty for main only)"
+        required: false
+        default: ""
+      sync_tags:
+        description: "Also sync tags from GitLab"
+        required: false
+        default: "true"
+        type: choice
+        options:
+          - "true"
+          - "false"
+
+permissions:
+  contents: write
+
+jobs:
+  sync:
+    runs-on: self-hosted
+    environment: robotframework
+    steps:
+      - name: Checkout (full history)
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Pull from GitLab and push to GitHub
+        env:
+          GITLAB_TOKEN: ${{ secrets.GITLAB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          GITLAB_URL="https://gitlab.com/space-nomads/robotframework-chat.git"
+
+          echo "::add-mask::${GITLAB_TOKEN}"
+          echo "::add-mask::${GITLAB_URL}"
+
+          if [ -z "${GITLAB_TOKEN:-}" ]; then
+            echo "::error::GITLAB_TOKEN secret must be configured."
+            echo "Create a GitLab personal access token with read_repository scope"
+            echo "and add it as a repository secret named GITLAB_TOKEN."
+            exit 1
+          fi
+
+          AUTH_URL="https://oauth2:${GITLAB_TOKEN}@gitlab.com/space-nomads/robotframework-chat.git"
+
+          # Configure origin with GITHUB_TOKEN so pushes authenticate
+          git remote set-url origin "https://x-access-token:${GITHUB_TOKEN}@github.com/${{ github.repository }}.git"
+
+          # Add GitLab as a remote
+          if git remote get-url gitlab >/dev/null 2>&1; then
+            git remote set-url gitlab "${AUTH_URL}"
+          else
+            git remote add gitlab "${AUTH_URL}"
+          fi
+
+          # Fetch all branches and tags from GitLab
+          echo "Fetching from GitLab..."
+          git fetch gitlab --prune
+
+          BRANCH="${{ github.event.inputs.branch }}"
+
+          if [ -n "${BRANCH}" ]; then
+            echo "Syncing branch: ${BRANCH}"
+            git push origin "refs/remotes/gitlab/${BRANCH}:refs/heads/${BRANCH}" --force
+          else
+            echo "Syncing main from GitLab to GitHub"
+            git push origin refs/remotes/gitlab/main:refs/heads/main --force
+          fi
+
+          SYNC_TAGS="${{ github.event.inputs.sync_tags }}"
+          # Default to true for scheduled runs (inputs are empty)
+          if [ "${SYNC_TAGS}" = "true" ] || [ -z "${SYNC_TAGS}" ]; then
+            echo "Syncing tags from GitLab"
+            git fetch gitlab --tags --force
+            git push origin --tags --force
+          fi
+
+          echo "Sync from GitLab complete."

robotframework_chat-1.0.0/.github/workflows/sync-to-gitlab.yml

@@ -0,0 +1,73 @@
+name: Sync to GitLab
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: "Branch to sync (leave empty for all branches)"
+        required: false
+        default: ""
+      sync_tags:
+        description: "Also sync tags"
+        required: false
+        default: "true"
+        type: choice
+        options:
+          - "true"
+          - "false"
+
+jobs:
+  sync:
+    runs-on: self-hosted
+    environment: robotframework
+    steps:
+      - name: Checkout (full history)
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Push to GitLab
+        env:
+          GITLAB_TOKEN: ${{ secrets.GITLAB_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          GITLAB_URL="https://gitlab.com/space-nomads/robotframework-chat.git"
+
+          echo "::add-mask::${GITLAB_TOKEN}"
+          echo "::add-mask::${GITLAB_URL}"
+
+          if [ -z "${GITLAB_TOKEN:-}" ]; then
+            echo "::error::GITLAB_TOKEN secret must be configured."
+            echo "Create a GitLab personal access token with write_repository scope"
+            echo "and add it as a repository secret named GITLAB_TOKEN."
+            exit 1
+          fi
+
+          AUTH_URL="https://oauth2:${GITLAB_TOKEN}@gitlab.com/space-nomads/robotframework-chat.git"
+
+          if git remote get-url gitlab >/dev/null 2>&1; then
+            git remote set-url gitlab "${AUTH_URL}"
+          else
+            git remote add gitlab "${AUTH_URL}"
+          fi
+
+          BRANCH="${{ github.event.inputs.branch }}"
+
+          if [ -n "${BRANCH}" ]; then
+            echo "Syncing branch: ${BRANCH}"
+            git push gitlab "refs/heads/${BRANCH}:refs/heads/${BRANCH}" --force
+          else
+            echo "Syncing all branches"
+            git push gitlab --all --force
+          fi
+
+          if [ "${{ github.event.inputs.sync_tags }}" = "true" ]; then
+            echo "Syncing tags"
+            git push gitlab --tags --force
+          fi
+
+          echo "Sync complete."

robotframework_chat-1.0.0/.gitignore

@@ -0,0 +1,68 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Robot Framework results
+results/
+*.log
+log.html
+output.xml
+report.html
+ci_metadata.json
+ollama_timestamps.json
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Database
+data/
+
+# Metrics output (generated by CI)
+metrics/
+
+# Generated CI artifacts
+config/nodes_inventory.yaml
+generated-pipeline.yml
+generated-dynamic-pipeline.yml
+
+# Coverage
+.coverage
+htmlcov/
+
+# Project specific
+*.local

robotframework_chat-1.0.0/.gitlab-ci.yml

@@ -0,0 +1,152 @@
+# .gitlab-ci.yml - Bare-bones pipeline skeleton
+#
+# All logic lives in ci/*.sh scripts and Makefile targets.
+# This file is intentionally minimal. To modify pipeline behavior,
+# edit the scripts -- not this file.
+#
+# Pipeline modes:
+#   1. Test     - every push/MR, per-node `make run-local-models` (allow_failure)
+#   2. Release  - clean semver tag (v1.2.3), build + publish to PyPI
+#   3. Test Release - pre-release tag (v1.2.3-rc1), build + verify only
+#
+# Nodes: ai1, mini1, mini2, dev1, dev2 (matched by GitLab runner tags)
+#
+# See: ai/PIPELINES.md
+
+include:
+  - local: ci/common.yml
+
+stages:
+  - lint
+  - test
+  - report
+  - deploy
+  - release
+  - review
+
+variables:
+  OLLAMA_ENDPOINT: "http://localhost:11434"
+  DEFAULT_MODEL: "llama3"
+  ROBOT_OPTIONS: "--metadata CI:true"
+
+# ── Lint ─────────────────────────────────────────────────────────────
+
+lint:
+  extends: .uv-setup
+  stage: lint
+  script: [bash ci/lint.sh all]
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_TAG =~ /^v/
+    - if: $CI_COMMIT_BRANCH
+
+# ── Test: Per-Node Model Runs ──────────────────────────────────────
+
+.run-local-models:
+  extends: .robot-test
+  stage: test
+  needs:
+    - job: lint
+      artifacts: false
+  script: [make run-local-models]
+  allow_failure: true
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH
+
+run-local-models-ai1:
+  extends: .run-local-models
+  tags: [ai1]
+
+run-local-models-mini1:
+  extends: .run-local-models
+  tags: [mini1]
+
+run-local-models-mini2:
+  extends: .run-local-models
+  tags: [mini2]
+
+run-local-models-dev1:
+  extends: .run-local-models
+  tags: [dev1]
+
+run-local-models-dev2:
+  extends: .run-local-models
+  tags: [dev2]
+
+# ── Report ───────────────────────────────────────────────────────────
+
+repo-metrics:
+  extends: .uv-setup
+  stage: report
+  needs: []
+  script: [make ci-report POST_MR=1]
+  artifacts:
+    paths: [metrics/]
+    expire_in: 30 days
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+
+pipeline-summary:
+  extends: .uv-setup
+  stage: report
+  needs:
+    - job: lint
+      artifacts: false
+      optional: true
+  script: [bash ci/pipeline_report.sh --post-mr]
+  artifacts:
+    paths: [metrics/]
+    expire_in: 30 days
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+
+# ── Deploy ───────────────────────────────────────────────────────────
+
+deploy-superset:
+  stage: deploy
+  tags: [deploy]
+  script: [make ci-deploy]
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH && $SUPERSET_DEPLOY_HOST
+
+# ── Release ──────────────────────────────────────────────────────────
+# PyPI publishing is handled by GitHub Actions trusted publishing.
+# See .github/workflows/pypi-publish.yml
+#
+# This job only verifies the package builds correctly.
+build-check:
+  extends: .uv-setup
+  stage: release
+  needs:
+    - job: lint
+      artifacts: false
+  script: [make build-check]
+  artifacts:
+    paths: [dist/]
+    expire_in: 7 days
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+/
+
+# ── Review ───────────────────────────────────────────────────────────
+
+opencode-review:
+  stage: review
+  tags: [nodejs]
+  variables:
+    REVIEW_MODEL: "openrouter/moonshotai/kimi-k2.5"
+  before_script:
+    - npm install -g opencode-ai
+  script: [make opencode-pipeline-review]
+  artifacts:
+    paths:
+      - review-result.md
+      - review-fix-attempt.md
+      - review-patch-*.diff
+    expire_in: 30 days
+    when: always
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event" && $CI_MERGE_REQUEST_LABELS =~ /opencode-review/
+    - when: manual