WS7/WS8 complete: unified examples on shared test harness, hardened environment and FluxGraph integration paths, enforced FluxGraph-enabled provider usage, logged resolved FluxGraph SHA in CI, and documented temporary floating-main policy with governance updates.

Author: CameronBrooks11

.ci/dependency-pins.yml

@@ -1,9 +1,10 @@
-# Cross-repo compatibility pins consumed by provider compatibility lanes.
-# DEV PHASE: refs are intentionally floating (`main`) for faster iteration.
-# Lock to immutable SHAs before release hardening.
+# Cross-repo compatibility refs consumed by provider compatibility lanes.
+# DEV PHASE: FluxGraph is intentionally floating (`main`) for the foreseeable
+# future while provider/graph integration is still evolving.
+# Revisit immutable SHA pinning before release hardening.
 
 fluxgraph:
   repository: FEASTorg/fluxgraph
   ref: main
-  updated_utc: 2026-02-22
-  rationale: "DEV PHASE: track latest FluxGraph main branch in required FluxGraph lane"
+  updated_utc: 2026-03-03
+  rationale: "DEV PHASE: keep floating main and rely on CI SHA logging for traceability"

.github/workflows/ci.yml

@@ -243,6 +243,23 @@ jobs:
           ref: ${{ steps.pins.outputs.ref }}
           path: fluxgraph
 
+      - name: Log FluxGraph resolved commit
+        shell: bash
+        run: |
+          set -euo pipefail
+          FLUXGRAPH_SHA=$(git -C fluxgraph rev-parse HEAD)
+          FLUXGRAPH_SUBJECT=$(git -C fluxgraph log -1 --pretty=%s)
+          echo "FluxGraph requested ref: ${{ steps.pins.outputs.ref }}"
+          echo "FluxGraph resolved commit: $FLUXGRAPH_SHA"
+          echo "FluxGraph HEAD subject: $FLUXGRAPH_SUBJECT"
+          {
+            echo "### FluxGraph Resolution (Windows FluxGraph build)"
+            echo ""
+            echo "- Ref: \`${{ steps.pins.outputs.ref }}\`"
+            echo "- Commit: \`$FLUXGRAPH_SHA\`"
+            echo "- Subject: $FLUXGRAPH_SUBJECT"
+          } >> "$GITHUB_STEP_SUMMARY"
+
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
@@ -297,6 +314,22 @@ jobs:
           ref: ${{ steps.pins.outputs.ref }}
           path: fluxgraph
 
+      - name: Log FluxGraph resolved commit
+        run: |
+          set -euo pipefail
+          FLUXGRAPH_SHA=$(git -C fluxgraph rev-parse HEAD)
+          FLUXGRAPH_SUBJECT=$(git -C fluxgraph log -1 --pretty=%s)
+          echo "FluxGraph requested ref: ${{ steps.pins.outputs.ref }}"
+          echo "FluxGraph resolved commit: $FLUXGRAPH_SHA"
+          echo "FluxGraph HEAD subject: $FLUXGRAPH_SUBJECT"
+          {
+            echo "### FluxGraph Resolution (Linux FluxGraph lane)"
+            echo ""
+            echo "- Ref: \`${{ steps.pins.outputs.ref }}\`"
+            echo "- Commit: \`$FLUXGRAPH_SHA\`"
+            echo "- Subject: $FLUXGRAPH_SUBJECT"
+          } >> "$GITHUB_STEP_SUMMARY"
+
       - name: Install system dependencies
         run: |
           sudo apt-get update

docs/dependencies.md

@@ -64,4 +64,6 @@ On Windows local development, use `dev-windows-*` presets.
 - `anolis-protocol` is consumed as pinned submodule.
 - FluxGraph integration remains explicit opt-in (`ENABLE_FLUXGRAPH`, `FLUXGRAPH_DIR`).
 - No hidden network dependency resolution in normal configure paths.
-- FluxGraph CI lane consumes a pinned commit from `.ci/dependency-pins.yml` (never floating branch heads).
+- FluxGraph CI lanes currently consume floating `main` from `.ci/dependency-pins.yml` by explicit phase decision.
+- Reproducibility is intentionally relaxed in this phase; each FluxGraph CI lane logs the resolved checked-out SHA.
+- Revisit immutable FluxGraph SHA pinning before release hardening.

examples/README.md

@@ -1,6 +1,8 @@
 # Provider-Sim Examples
 
-This directory contains configuration-first examples for each simulation mode.
+This directory contains scenario-focused examples for each simulation mode.
+Example scripts intentionally reuse the shared harness in `tests/support/` so
+transport/process/protobuf handling stays centralized in one place.
 
 ## Example Directories
 
@@ -10,7 +12,7 @@ This directory contains configuration-first examples for each simulation mode.
 
 ## Quick Start
 
-Build provider-sim first:
+Build provider-sim first.
 
 Linux/macOS:
 
@@ -24,38 +26,47 @@ Windows:
 .\scripts\build.ps1 -Preset dev-windows-release
 ```
 
-Run each mode with its example config:
+Run inert and non-interacting scenarios:
 
 Linux/macOS:
 
 ```bash
-bash ./scripts/run_local.sh --preset dev-release -- --config examples/inert_mode/provider.yaml
-bash ./scripts/run_local.sh --preset dev-release -- --config examples/non_interacting_mode/provider.yaml
+python examples/inert_mode/test_inert.py
+python examples/non_interacting_mode/test_non_interacting.py
 ```
 
 Windows:
 
 ```powershell
-.\scripts\run_local.ps1 -Preset dev-windows-release -- --config examples/inert_mode/provider.yaml
-.\scripts\run_local.ps1 -Preset dev-windows-release -- --config examples/non_interacting_mode/provider.yaml
+python .\examples\inert_mode\test_inert.py
+python .\examples\non_interacting_mode\test_non_interacting.py
 ```
 
-For `sim_mode`, build FluxGraph-enabled provider and pass `--sim-server`.
+If generated Python protobuf bindings are in a preset-specific build directory,
+set `ANOLIS_PROVIDER_SIM_BUILD_DIR` before running examples.
+Example (Windows):
+
+```powershell
+$env:ANOLIS_PROVIDER_SIM_BUILD_DIR="build/dev-windows-release"
+```
+
+`sim_mode` also requires FluxGraph server availability.
 
 ## FluxGraph (`sim_mode`)
 
 Linux/macOS:
 
 ```bash
 bash ./scripts/build.sh --preset ci-linux-release-fluxgraph -- -DFLUXGRAPH_DIR=../fluxgraph
-bash ./scripts/run_local.sh --preset ci-linux-release-fluxgraph -- --config examples/sim_mode/provider.yaml --sim-server localhost:50051
+python examples/sim_mode/test_sim.py
 ```
 
 Windows:
 
 ```powershell
 .\scripts\build.ps1 -Preset dev-windows-release-fluxgraph -- -DFLUXGRAPH_DIR=..\fluxgraph
-.\scripts\run_local.ps1 -Preset dev-windows-release-fluxgraph -- --config examples/sim_mode/provider.yaml --sim-server localhost:50051
+$env:ANOLIS_PROVIDER_SIM_BUILD_DIR="build/dev-windows-release-fluxgraph"
+python .\examples\sim_mode\test_sim.py
 ```
 
 ## Notes

examples/inert_mode/README.md

@@ -16,16 +16,20 @@ Linux/macOS:
 
 ```bash
 bash ./scripts/build.sh --preset dev-release
-bash ./scripts/run_local.sh --preset dev-release -- --config examples/inert_mode/provider.yaml
+python examples/inert_mode/test_inert.py
 ```
 
 Windows:
 
 ```powershell
 .\scripts\build.ps1 -Preset dev-windows-release
-.\scripts\run_local.ps1 -Preset dev-windows-release -- --config examples/inert_mode/provider.yaml
+$env:ANOLIS_PROVIDER_SIM_BUILD_DIR="build/dev-windows-release"
+python .\examples\inert_mode\test_inert.py
 ```
 
+The script uses shared helpers from `tests/support/` for protocol framing and
+process management; only inert-mode scenario logic lives in this file.
+
 ## Related
 
 - [Non-interacting mode](../non_interacting_mode/)