Clean repo artifacts, add CONTRIBUTING guide, and add Windows diagram CI parity

Author: CameronBrooks11

.github/workflows/ci.yml

@@ -197,6 +197,29 @@ jobs:
       - name: Run C++ tests
         run: ctest --preset ci-windows-release
 
+  windows-diagram:
+    name: Windows diagram-dot
+    runs-on: windows-2022
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup vcpkg
+        uses: lukka/run-vcpkg@v11
+        with:
+          vcpkgGitCommitId: ${{ env.VCPKG_COMMIT }}
+          doNotCache: false
+
+      - name: Configure
+        run: cmake --preset ci-windows-release-diagram
+
+      - name: Build
+        run: cmake --build --preset ci-windows-release-diagram --parallel
+
+      - name: Run C++ tests
+        run: ctest --preset ci-windows-release-diagram
+
   diagram-render-smoke:
     name: Diagram Render Smoke
     runs-on: ubuntu-24.04

.gitignore

@@ -278,8 +278,13 @@ CTestTestfile.cmake
 _deps/
 compile_commands.json
 
+# Local diagram tool outputs
+graph_example*.dot
+graph_example*.svg
+graph_example*.png
+
 # vcpkg manifest-mode artifacts (machine-local)
 vcpkg_installed/
 
 # Custom
-working/
+working/

CMakePresets.json

@@ -81,6 +81,14 @@
         "CMAKE_BUILD_TYPE": "Release"
       }
     },
+    {
+      "name": "ci-windows-release-diagram",
+      "inherits": "ci-windows-release",
+      "cacheVariables": {
+        "FLUXGRAPH_BUILD_DIAGRAM_TOOL": "ON",
+        "FLUXGRAPH_JSON_ENABLED": "ON"
+      }
+    },
     {
       "name": "ci-linux-release-json",
       "inherits": "ci-linux-release",
@@ -162,6 +170,11 @@
       "configurePreset": "ci-windows-release",
       "configuration": "Release"
     },
+    {
+      "name": "ci-windows-release-diagram",
+      "configurePreset": "ci-windows-release-diagram",
+      "configuration": "Release"
+    },
     {
       "name": "ci-linux-release-json",
       "configurePreset": "ci-linux-release-json"
@@ -235,6 +248,14 @@
         "outputOnFailure": true
       }
     },
+    {
+      "name": "ci-windows-release-diagram",
+      "configurePreset": "ci-windows-release-diagram",
+      "configuration": "Release",
+      "output": {
+        "outputOnFailure": true
+      }
+    },
     {
       "name": "ci-linux-release-json",
       "configurePreset": "ci-linux-release-json",

CONTRIBUTING.md

@@ -0,0 +1,45 @@
+# Contributing to FluxGraph
+
+Thanks for contributing.
+
+FluxGraph is part of the FEAST ecosystem. For shared organization-level engineering and governance context, see:  
+https://github.com/FEASTorg/
+
+## Local Development
+
+Prerequisites:
+
+1. CMake 3.20+
+2. C++17 toolchain
+3. `VCPKG_ROOT` configured
+
+Typical loop:
+
+```bash
+cmake --preset dev-release
+cmake --build --preset dev-release
+ctest --preset dev-release --output-on-failure
+```
+
+Windows:
+
+```powershell
+cmake --preset dev-windows-release
+cmake --build --preset dev-windows-release --config Release
+ctest --preset dev-windows-release -C Release --output-on-failure
+```
+
+## Pull Request Expectations
+
+1. Keep changes scoped and cohesive.
+2. Add/update tests for behavioral changes.
+3. Update relevant docs for public-surface changes.
+4. Keep core dependency boundaries intact (see `docs/dependencies.md`).
+5. Ensure CI is green before merge.
+
+## Design and Semantics References
+
+1. `docs/semantics_spec.md`
+2. `docs/numerical-methods.md`
+3. `docs/graph-visualization.md`
+4. `docs/dependencies.md`

docs/dependencies.md

@@ -27,7 +27,7 @@ This document defines FluxGraph policy for dependency management, preset usage,
 
 ## CI Lane Tiers
 
-- **Required**: Linux core build/test lane, Windows core build/test lane.
+- **Required**: Linux core build/test lane, Linux diagram-dot lane, Windows core build/test lane, Windows diagram-dot lane, and diagram render smoke lane.
 - **Advisory/matrix**: Linux JSON, YAML, and server-enabled lanes.
 - **Optional heavy lanes**: extended sanitizer/stress/integration runs.