master.yml

name: Main

on:
  push:
    branches:
      - master
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]
  workflow_dispatch:

permissions:
  contents: read

concurrency:
  group: master-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

jobs:
  changes:
    uses: ./.github/workflows/ci-changes.yml

  quality:
    timeout-minutes: 20
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env

      - name: Resolve Python version for hook cache
        id: python
        run: echo "version=$(python -c 'import platform; print(platform.python_version())')" >> "$GITHUB_OUTPUT"

      - name: Cache prek environments
        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6
        with:
          path: ~/.cache/prek
          key: prek-v1-${{ runner.os }}-${{ runner.arch }}-${{ steps.python.outputs.version }}-${{ hashFiles('.pre-commit-config.yaml') }}

      - name: Run checks
        run: make check

      - name: Check OpenAPI contract
        run: make contract-test

  tests:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').tests) }}
    timeout-minutes: 40
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ["3.11", "3.12", "3.13", "3.14"]
        suite: [unit, e2e]
      fail-fast: false
    defaults:
      run:
        shell: bash
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env
        with:
          python-version: ${{ matrix.python-version }}

      - name: Set up project tools
        uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0

      - name: Cache DSH configuration dependencies
        if: matrix.suite == 'unit'
        uses: ./.github/actions/cache-pnpm
        with:
          working-directory: integrations/dsh/plugins/powercontext/tests/config-runtime
          cache-dependency-glob: integrations/dsh/plugins/powercontext/tests/config-runtime/pnpm-lock.yaml

      - name: Install and resolve native DSH configuration test APIs
        if: matrix.suite == 'unit'
        run: |
          pnpm --dir integrations/dsh/plugins/powercontext/tests/config-runtime install --frozen-lockfile
          boot="$(node --input-type=module -e "import { createRequire } from 'node:module'; import { resolve } from 'node:path'; const require = createRequire(resolve('integrations/dsh/plugins/powercontext/tests/config-runtime/package.json')); process.stdout.write(require.resolve('@deepseek-ai/dsh-app-boot'))")"
          test -n "$boot" && test -f "$boot" || { echo "DSH configuration runtime unresolved"; exit 1; }
          echo "DSH_TEST_CONFIG_BOOT=$boot" >> "$GITHUB_ENV"

      - name: Run unit tests
        if: matrix.suite == 'unit'
        env:
          PYTEST_ADDOPTS: --require-dsh-config-runtime
        run: make unit-test

      - name: Run end-to-end tests
        if: matrix.suite == 'e2e'
        run: make e2e-test

  isolated-installations:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').tests) }}
    timeout-minutes: 20
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        python-version: ["3.11", "3.14"]
        extras: ["builtin", "cli", "builtin,cli", "server,cli"]
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up Python
        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
        with:
          python-version: ${{ matrix.python-version }}

      - name: Set up uv
        uses: astral-sh/setup-uv@ae62891fec2bb8e7d6c99fc78c9fec3a63790f8d # v10.0.0
        with:
          version: "0.10.12"

      - name: Build and install only the requested wheel extras
        env:
          ROLE_EXTRAS: ${{ matrix.extras }}
        run: |
          uv build --wheel --out-dir "$RUNNER_TEMP/role-wheel"
          uv venv --python "$(command -v python)" "$RUNNER_TEMP/role-venv"
          wheel="$(find "$RUNNER_TEMP/role-wheel" -name '*.whl' -print -quit)"
          uv pip install --python "$RUNNER_TEMP/role-venv/bin/python" "$wheel[$ROLE_EXTRAS]"

      - name: Verify installed role behavior without checkout imports
        env:
          ROLE_EXTRAS: ${{ matrix.extras }}
        run: |
          "$RUNNER_TEMP/role-venv/bin/python" -I scripts/ci_role_smoke.py "$ROLE_EXTRAS"

      - name: Verify unrelated packages do not enable optional CLI roles
        if: matrix.extras == 'cli'
        run: |
          uv pip install --python "$RUNNER_TEMP/role-venv/bin/python" sqlalchemy fastapi
          "$RUNNER_TEMP/role-venv/bin/python" -I scripts/ci_role_smoke.py cli

  docs-tests:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').docs_tests) }}
    timeout-minutes: 15
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env
        with:
          python-version: "3.12"

      - name: Test documentation contracts
        run: |
          uv run --locked python -m pytest -q -ra \
            tests/test_release_version.py \
            tests/test_full_capability_docs.py \
            tests/test_integration_guidance_evaluation.py \
            tests/test_docs_remote_access_contract.py \
            tests/e2e/test_mcp_full_profile.py

  worker-observability:
    timeout-minutes: 15
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env
        with:
          python-version: "3.12"

      - name: Test worker traces and metrics without skips
        run: |
          uv run --locked --extra tracing-otlp python -m pytest -q -ra \
            tests/e2e/test_worker_otlp.py \
            tests/e2e/test_worker_model_usage.py \
            tests/test_observability_health.py \
            --junitxml="$RUNNER_TEMP/worker-observability.xml"
          uv run --locked --extra tracing-otlp python - <<'PY'
          import os
          import xml.etree.ElementTree as ET
          from pathlib import Path

          report = Path(os.environ["RUNNER_TEMP"]) / "worker-observability.xml"
          cases = list(ET.parse(report).iter("testcase"))
          if not cases or any(case.find(tag) is not None for case in cases for tag in ("skipped", "failure", "error")):
              raise SystemExit("Worker traces and metrics must execute and pass without skips")
          print(f"Worker observability: {len(cases)} cases passed without skips.")
          PY

      - name: Save worker observability results
        if: always()
        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
        with:
          name: worker-observability
          path: ${{ runner.temp }}/worker-observability.xml
          if-no-files-found: error

  evaluation-tests:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').evaluation) }}
    timeout-minutes: 20
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env
        with:
          cache-dependency-glob: |
            pyproject.toml
            uv.lock
            integrations/langchain/pyproject.toml
            integrations/langgraph/pyproject.toml
            integrations/opendal/pyproject.toml
            evaluation/pyproject.toml
            evaluation/uv.lock

      # Evaluation has its own uv project. Collect each suite's unit tests through
      # its dedicated path; the root project's testpaths do not include them.
      - name: Run the evaluation project unit tests
        run: |
          set -o pipefail
          make evaluation-unit-test 2>&1 | tee evaluation/pytest.log

      # A pull request from a fork cannot read this run's raw job log — the log
      # endpoint answers `Must have admin rights to Repository` — so a red check
      # is otherwise an exit code and nothing else. Both the step summary and an
      # annotation are readable by the contributor, and the annotation is the one
      # that still says something when the failure happened before the tests ran.
      - name: Report the failing cases
        if: failure()
        run: |
          {
            echo "### evaluation unit tests"
            echo
            echo '```'
            uv --version || true
            python3 -V || true
            echo '```'
            echo
            if grep -qE '^(FAILED|ERROR) ' evaluation/pytest.log; then
              echo '```'
              grep -E '^(FAILED|ERROR) ' evaluation/pytest.log
              echo '```'
            else
              echo "No failing case was reported, so the run failed before the tests ran:"
              echo
              echo '```'
              tail -n 40 evaluation/pytest.log
              echo '```'
            fi
          } >> "$GITHUB_STEP_SUMMARY"

          detail=$(tail -n 25 evaluation/pytest.log | awk '{gsub(/%/, "%25"); gsub(/\r/, "%0D"); printf "%s%%0A", $0}')
          echo "::error title=evaluation unit tests failed::${detail}"

  code-seekdb:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').database) }}
    timeout-minutes: 20
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        python-version: ["3.11", "3.14"]
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env
        with:
          python-version: ${{ matrix.python-version }}

      - name: Test code indexing with embedded seekdb
        run: make code-seekdb-test

      - name: Test unified migrations with embedded seekdb
        timeout-minutes: 10
        env:
          POWERCONTEXT_TEST_MIGRATION_SEEKDB: "1"
          POWERCONTEXT_TEST_MIGRATION_SQL_LOG: "1"
          PYTHONUNBUFFERED: "1"
          TMPDIR: ${{ runner.temp }}/seekdb-migration
        run: |
          set -o pipefail
          mkdir -p "$TMPDIR"
          collect_diagnostics() {
            df -h . /tmp
            # A timed-out pytest process cannot run fixture cleanup. Preserve
            # native startup/recovery evidence too: a tail alone can omit the
            # transaction that acquired the lock blocking the final SQL query.
            find "$TMPDIR" -type f \( -name '*.log' -o -name '*.log.wf' \) \
              -printf '%P\0' | tar -czf seekdb-native.tar.gz -C "$TMPDIR" --null -T -
          }
          trap collect_diagnostics EXIT
          df -h . /tmp
          uv run --locked --extra seekdb pytest -vv \
            -o faulthandler_timeout=120 --durations=20 \
            tests/builtin/persistence/test_database_migration_backends.py \
            tests/builtin/persistence/test_database_backup_providers.py \
            tests/builtin/persistence/test_database_migration_connections.py \
            tests/e2e/test_topic_memory_recovery_migration.py \
            tests/builtin/persistence/test_mysql_migration_checks.py \
            tests/builtin/persistence/test_mysql_migration_schema.py -k seekdb \
            2>&1 | tee seekdb-migrations.log
          uv run --locked --extra seekdb pytest --collect-only -q --color=no \
            tests/builtin/persistence/test_mysql_migration_runner.py -k seekdb \
            2>&1 | tee seekdb-runner-collection.log | tee -a seekdb-migrations.log
          mapfile -t seekdb_runner_nodes < <(
            sed -n '/^tests\/builtin\/persistence\/test_mysql_migration_runner\.py::/p' \
              seekdb-runner-collection.log
          )
          if [ "${#seekdb_runner_nodes[@]}" -eq 0 ]; then
            echo "No seekdb migration runner tests were collected" >&2
            exit 1
          fi
          for seekdb_runner_node in "${seekdb_runner_nodes[@]}"; do
            timeout --signal=TERM --kill-after=10s 180s \
              uv run --locked --extra seekdb pytest -vv \
              -o faulthandler_timeout=120 --durations=20 --log-cli-level=INFO \
              "$seekdb_runner_node" -k seekdb \
              2>&1 | tee -a seekdb-migrations.log
          done

      - name: Upload seekdb migration diagnostics
        if: always()
        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
        with:
          name: seekdb-migrations-${{ matrix.python-version }}
          path: |
            seekdb-migrations.log
            seekdb-native.tar.gz
          if-no-files-found: ignore

  atomic-memory-clean-seekdb:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').database) }}
    name: Atomic Memory clean migration (SeekDB)
    timeout-minutes: 50
    runs-on: ubuntu-latest
    env:
      POWERCONTEXT_TEST_MIGRATION_SEEKDB: "1"
      PYTHONUNBUFFERED: "1"
      MIGRATION_REPORTS: ${{ github.workspace }}/.powercontext/atomic-memory-clean-seekdb
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env
        with:
          python-version: "3.12"

      - name: Run clean migration evidence, grants and vectors without skips
        timeout-minutes: 35
        env:
          TMPDIR: ${{ runner.temp }}/am-seekdb
        run: |
          mkdir -p "$TMPDIR"
          uv run --locked --extra seekdb python scripts/run_atomic_memory_clean_migration.py \
            seekdb --output "$MIGRATION_REPORTS"

      - name: Test long-query retrieval and admission without skips
        timeout-minutes: 10
        env:
          TMPDIR: ${{ runner.temp }}/am-seekdb
        run: |
          uv run --locked --extra seekdb python scripts/run_atomic_memory_clean_migration.py \
            seekdb --output "$MIGRATION_REPORTS/long-query" --tests \
            tests/e2e/test_atomic_artifact_search_http.py \
            tests/e2e/test_atomic_memory_long_fts_query.py

      - name: Collect native diagnostics
        if: always()
        env:
          TMPDIR: ${{ runner.temp }}/am-seekdb
        run: |
          mkdir -p "$MIGRATION_REPORTS"
          df -h . /tmp > "$MIGRATION_REPORTS/disk.txt"
          if [ -d "$TMPDIR" ]; then
            find "$TMPDIR" -type f \( -name '*.log' -o -name '*.log.wf' \) \
              -print -exec tail -c 8388608 {} \; > "$MIGRATION_REPORTS/seekdb-native.log"
          fi

      - name: Save clean migration reports
        if: always()
        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
        with:
          name: atomic-memory-clean-seekdb-${{ github.sha }}
          path: ${{ env.MIGRATION_REPORTS }}/
          include-hidden-files: true
          if-no-files-found: error
          retention-days: 7

  windows-unit-portability:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').tests) }}
    timeout-minutes: 20
    runs-on: windows-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env

      - name: Check Windows worker types
        run: >-
          uv run --locked --no-sync ty check --python-platform win32
          src/powercontext/builtin/runtime/artifact_processing.py
          tests/builtin/runtime/test_artifact_processing.py

      - name: Verify spawned worker lifecycle on Windows
        run: uv run --locked --no-sync pytest -q tests/builtin/runtime/test_artifact_processing.py

      - name: Verify bootstrap receipt persistence and failure recovery on Windows
        run: >-
          uv run --locked --no-sync pytest -q
          tests/claude_code_plugin/test_bootstrap.py
          tests/codex_plugin/test_bootstrap.py

      - name: Verify unsupported native indexing is skipped on Windows
        run: >-
          uv run --locked --no-sync pytest -q
          tests/builtin/test_native_code.py
          tests/builtin/test_native_code_multilanguage.py
          tests/e2e/test_native_code_multilanguage.py

      - name: Verify Codex resolves and launches cmd shims on Windows
        run: >-
          uv run --locked --no-sync pytest -q
          tests/test_system_cli.py::test_codex_json_runner_launches_the_resolved_cmd_shim
          tests/test_system_cli.py::test_codex_mcp_list_runner_launches_the_resolved_cmd_shim
          tests/test_system_cli.py::test_codex_diagnostics_run_through_the_resolved_cmd_shim
          tests/test_system_cli.py::test_codex_runners_report_non_utf8_cmd_errors
          tests/test_system_cli.py::test_codex_runners_preserve_json_output
          tests/test_system_cli.py::test_codex_runners_report_a_missing_executable
          tests/test_system_cli.py::test_codex_batch_install_rejects_unsafe_input_before_launch
          tests/test_system_cli.py::test_codex_batch_alias_with_trailing_space_still_rejects_unsafe_arguments
          tests/test_system_cli.py::test_codex_runners_prefer_path_over_the_current_directory
          tests/test_system_cli.py::test_codex_runners_honor_an_explicit_dot_path_entry
          tests/test_system_cli.py::test_codex_path_executable_prefers_earlier_pathext_entries
          tests/test_system_cli.py::test_codex_path_executable_treats_an_empty_path_value_as_no_search
          tests/test_system_cli.py::test_codex_path_executable_resolves_empty_path_entries_in_the_working_directory
          tests/test_system_cli.py::test_codex_batch_install_preserves_supported_input
          tests/test_system_cli.py::test_codex_batch_install_rejects_unsafe_returned_marketplace
          tests/test_system_cli.py::test_codex_batch_runners_reject_unsafe_executable_path
          tests/test_system_cli.py::test_codex_native_executable_preserves_arguments

      - name: Verify managed guidance and exact rollback bytes on Windows
        run: >-
          uv run --locked --no-sync pytest -q
          tests/test_guidance_generation.py
          tests/test_guidance_installation.py
          tests/test_opencode_installation.py
          tests/test_cli_zcode.py::test_zcode_upgrade_rejects_missing_packaged_reference_and_preserves_installation
          tests/test_setup_rollback.py

      - name: Exercise fixtures without Windows long-path support
        shell: pwsh
        run: |
          Set-ItemProperty -LiteralPath 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem' -Name LongPathsEnabled -Value 0

      - name: Verify portable archive restoration and SQLite URI targets on Windows
        run: >-
          uv run --locked --no-sync pytest -q
          tests/builtin/portability/test_bundle.py
          tests/test_archive_cli.py
          tests/e2e/test_portable_archive.py

      # Keep pytest's default temporary root: a short --basetemp would hide
      # regressions in the nested checkout fixtures covered by issue #1501.
      - name: Run Windows portability regressions
        shell: pwsh
        run: >-
          uv run pytest -q
          tests/builtin/artifacts/skill/test_package.py
          tests/builtin/runtime/test_external_skills.py
          tests/test_cli.py::test_remote_enroll_can_install_automatic_service_in_one_command
          tests/test_openclaw_cli.py::test_build_openclaw_plugin_runs_pnpm_install_non_interactively
          tests/test_opencode_cli.py
          tests/test_service.py
          tests/test_service_bootstrap.py
          tests/test_service_environment.py

  dify-tools:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').dify) }}
    timeout-minutes: 15
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env
        with:
          python-version: "3.12"
          cache-dependency-glob: |
            pyproject.toml
            uv.lock
            integrations/langchain/pyproject.toml
            integrations/langgraph/pyproject.toml
            integrations/opendal/pyproject.toml
            integrations/dify/pyproject.toml
            integrations/dify/uv.lock

      - name: Check out the supported Dify host helpers
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          repository: langgenius/dify
          ref: 8387590ace4a094de812b7847fc6a4c3a27cd52b # 1.17.1
          path: .artifacts/dify-host
          persist-credentials: false
          sparse-checkout-cone-mode: false
          sparse-checkout: |
            api/core/entities/parameter_entities.py
            api/core/plugin/entities/parameters.py
            api/core/tools/__base/tool.py
            api/core/tools/entities/common_entities.py
            api/core/tools/entities/tool_entities.py
            docker/docker-compose.yaml
            web/app/components/workflow/nodes/tool/default.ts
            web/app/components/workflow/nodes/tool/output-schema-utils.ts
            web/app/components/workflow/nodes/_base/components/variable/utils.ts

      - name: Check out the default Dify plugin daemon entities
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          repository: langgenius/dify-plugin-daemon
          ref: 1310a18b2f6bc6f18768a0a6265484830891433c # 0.6.10 (Dify 1.17.1 compose default)
          path: .artifacts/dify-daemon
          persist-credentials: false

      - name: Set up Go for daemon entity serialization
        uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
        with:
          go-version-file: .artifacts/dify-daemon/go.mod
          cache-dependency-path: .artifacts/dify-daemon/go.sum

      - name: Set up project tools
        uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0

      - name: Check daemon serialization, host casting, Workflow selectors and SDK HTTP readback
        env:
          POWERCONTEXT_DIFY_SOURCE: ${{ github.workspace }}/.artifacts/dify-host
          POWERCONTEXT_DIFY_DAEMON_SOURCE: ${{ github.workspace }}/.artifacts/dify-daemon
        run: make dify-test

  hermes-skills:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').hermes) }}
    timeout-minutes: 15
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env

      - name: Check out the supported Hermes host
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          repository: NousResearch/hermes-agent
          ref: e624e9fde561e1add9388384012b295fde669ade # v2026.8.18 / CLI 0.20.4
          path: .hermes-native
          persist-credentials: false

      - name: Verify native Skill discovery and metadata
        env:
          POWERCONTEXT_HERMES_SOURCE: ${{ github.workspace }}/.hermes-native
        run: uv run pytest tests/e2e/test_hermes_skills.py

  dsh-package:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').dsh) }}
    timeout-minutes: 30
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the Python environment
        uses: ./.github/actions/setup-python-env

      - name: Set up project tools
        uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0

      - name: Cache DSH dependencies
        uses: ./.github/actions/cache-pnpm
        with:
          working-directory: integrations/dsh/plugins/powercontext
          cache-dependency-glob: integrations/dsh/plugins/powercontext/**/pnpm-lock.yaml

      - name: Test DSH package
        run: make js-test

      - name: Test built plugin in the real DSH runtime
        run: make dsh-runtime-test

      - name: Install native DSH configuration test APIs
        run: pnpm --dir integrations/dsh/plugins/powercontext/tests/config-runtime install --frozen-lockfile

      - name: Resolve required DSH test runtimes
        run: |
          bin="$(node --input-type=module -e "import { dshBin } from './integrations/dsh/plugins/powercontext/tests/runtime/fixture.mjs'; process.stdout.write(dshBin)")"
          test -n "$bin" && test -f "$bin" || { echo "DSH test executable unresolved"; exit 1; }
          boot="$(node --input-type=module -e "import { createRequire } from 'node:module'; import { resolve } from 'node:path'; const require = createRequire(resolve('integrations/dsh/plugins/powercontext/tests/config-runtime/package.json')); process.stdout.write(require.resolve('@deepseek-ai/dsh-app-boot'))")"
          test -n "$boot" && test -f "$boot" || { echo "DSH configuration runtime unresolved"; exit 1; }
          echo "DSH_TEST_EXECUTABLE=$bin" >> "$GITHUB_ENV"
          echo "DSH_TEST_CONFIG_BOOT=$boot" >> "$GITHUB_ENV"

      - name: Verify DSH setup with customized profiles
        run: uv run pytest tests/test_dsh_transport.py --require-dsh-runtime

      - name: Verify DSH guidance adapter requests and results
        run: uv run pytest tests/test_integration_guidance_evaluation.py::test_dsh_controlled_native_handoff_uses_only_mcp_tools_and_preserves_complete_carriers

  pi-package:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').pi) }}
    timeout-minutes: 20
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the Python environment
        uses: ./.github/actions/setup-python-env

      - name: Set up project tools
        uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0

      - name: Cache Pi dependencies
        uses: ./.github/actions/cache-pnpm
        with:
          working-directory: integrations/pi/plugins/powercontext
          cache-dependency-glob: integrations/pi/plugins/powercontext/pnpm-lock.yaml

      - name: Test Pi package
        run: make pi-test

      - name: Verify Pi guidance adapter requests and results
        run: uv run pytest "tests/test_integration_guidance_evaluation.py::test_native_adapter_handoff_uses_real_request_mapping_and_response_envelopes[pi]"

  opencode-package:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').opencode) }}
    timeout-minutes: 20
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false
      - name: Set up the Python environment
        uses: ./.github/actions/setup-python-env

      - uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0
      - name: Cache OpenCode dependencies
        uses: ./.github/actions/cache-pnpm
        with:
          working-directory: integrations/opencode/plugins/powercontext
          cache-dependency-glob: integrations/opencode/plugins/powercontext/pnpm-lock.yaml
      - name: Test OpenCode package
        run: make opencode-test

      - name: Verify OpenCode guidance adapter requests and results
        run: uv run pytest "tests/test_integration_guidance_evaluation.py::test_native_adapter_handoff_uses_real_request_mapping_and_response_envelopes[opencode]"

  openclaw-package:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').openclaw) }}
    timeout-minutes: 20
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false
      - name: Set up the Python environment
        uses: ./.github/actions/setup-python-env

      - uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0
      # The pinned OpenClaw SDK requires the SQLite runtime shipped with Node 24.15+.
      - run: mise install node@24.15.0
      - name: Cache OpenClaw dependencies
        uses: ./.github/actions/cache-pnpm
        with:
          working-directory: integrations/openclaw/plugins/memory-powercontext
          cache-dependency-glob: integrations/openclaw/plugins/memory-powercontext/pnpm-lock.yaml
      - name: Test OpenClaw package
        run: mise exec node@24.15.0 -- make openclaw-plugin-test

      - name: Verify OpenClaw guidance adapter requests and results
        run: mise exec node@24.15.0 -- uv run pytest tests/test_integration_guidance_evaluation.py::test_openclaw_handoff_adapter_preserves_generated_source_identity

  opendal-package:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').opendal) }}
    timeout-minutes: 20
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the Python environment
        uses: ./.github/actions/setup-python-env
        with:
          python-version: "3.12"

      - name: Test OpenDAL package
        run: make opendal-test


  website-link-validation-windows:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').website) }}
    timeout-minutes: 20
    runs-on: windows-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up website tools
        uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0

      - name: Cache website dependencies
        uses: ./.github/actions/cache-pnpm
        with:
          working-directory: website
          cache-dependency-glob: website/pnpm-lock.yaml

      - name: Install website dependencies
        run: pnpm --dir website install --frozen-lockfile

      - name: Test route scanning and link validation
        run: pnpm --dir website test:links

  check-website:
    needs: changes
    if: ${{ !cancelled() && (needs.changes.result != 'success' || fromJSON(needs.changes.outputs.suites || '{}').website) }}
    timeout-minutes: 20
    runs-on: ubuntu-latest
    steps:
      - name: Check out
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          persist-credentials: false

      - name: Set up the environment
        uses: ./.github/actions/setup-python-env

      - name: Set up website tools
        uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0

      - name: Cache website dependencies
        uses: ./.github/actions/cache-pnpm
        with:
          working-directory: website
          cache-dependency-glob: website/pnpm-lock.yaml

      - name: Check website
        run: make docs-test