chore: adopt org config set + pinned clang-format gate + one-time reformat (#54) (#55)

* chore(fluxgraph): adopt org config files + pinned clang-format CI gate

Add the org template set fluxgraph was missing — .clang-format, .clang-tidy
(HeaderFilterRegex for fluxgraph's src/include/server/tools/tests), .editorconfig,
.gitattributes, justfile — and a cpp-format CI job using the setup-clang-tools
action (SHA-verified static LLVM 18.1.8). Config + CI only; the one-time reformat
follows in the next commit.

* style(fluxgraph): apply org clang-format (pinned 18.1.8) [pure reformat]

One-time mechanical reformat — adopt the org .clang-format style (Google base,
120 col, 4-space indent) across all 133 C++ files. Pure formatting (no logic
changes); recorded in .git-blame-ignore-revs so git blame skips it.

Previously fluxgraph ran clang-format with no .clang-format, so it used the
tool's default style; this aligns it with the rest of the org.

* chore(fluxgraph): add .git-blame-ignore-revs for the clang-format reformat

Lets git blame skip the pure-formatting commit. Enable per clone:
  git config blame.ignoreRevsFile .git-blame-ignore-revs

Author: CameronBrooks11

.clang-format

@@ -0,0 +1,7 @@
+---
+Language: Cpp
+BasedOnStyle: Google
+ColumnLimit: 120
+IndentWidth: 4
+AccessModifierOffset: -4
+...

.clang-tidy

@@ -0,0 +1,20 @@
+---
+# Shared provider clang-tidy config (mirrors the anolis runtime).
+# High-value signal only: keep diagnostics/analyzer/bugprone/performance, drop readability noise.
+Checks: >
+  clang-diagnostic-*,
+  clang-analyzer-*,
+  performance-*,
+  bugprone-*,
+  -readability-*,
+  -bugprone-macro-parentheses,
+  -bugprone-easily-swappable-parameters
+# Note: consider re-enabling specific readability checks once bugprone/perf are clean.
+WarningsAsErrors: ""
+# Limit diagnostics to the repo's own source roots. ADJUST per provider to match
+# its layout (e.g. "src", "include", "tests"); this default covers the common case.
+# Generated protobuf sources live under build/ and are excluded — also disable
+# clang-tidy on the protobuf CMake target so compile_commands does not drag them in.
+HeaderFilterRegex: ".*/(src|include|server|tools|tests)/.*"
+FormatStyle: file
+...

.editorconfig

@@ -0,0 +1,32 @@
+# Shared editor defaults for anolis providers. Copy to `.editorconfig` at the repo root.
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+
+# C/C++ — matches .clang-format (IndentWidth: 4)
+[*.{c,cc,cpp,cxx,h,hh,hpp,hxx}]
+indent_size = 4
+
+[*.{cmake,txt}]
+indent_size = 2
+
+[CMakeLists.txt]
+indent_size = 2
+
+[*.{yml,yaml,json}]
+indent_size = 2
+
+[*.py]
+indent_size = 4
+
+[justfile]
+indent_size = 4
+
+# Markdown — keep trailing whitespace (hard line breaks)
+[*.md]
+trim_trailing_whitespace = false

.git-blame-ignore-revs

@@ -0,0 +1,6 @@
+# Reformat commits to skip in `git blame` (see git config blame.ignoreRevsFile).
+#
+# Enable once per clone:  git config blame.ignoreRevsFile .git-blame-ignore-revs
+
+# style(fluxgraph): apply org clang-format (pinned 18.1.8) [pure reformat]
+7da3d53386e6c4bd38427b25b61ae9e192a01de0

.gitattributes

@@ -0,0 +1,21 @@
+# Normalize text files to LF across platforms.
+* text=auto eol=lf
+
+# Keep Windows-native script line endings where expected.
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+# Common binary assets.
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.bmp binary
+*.ico binary
+*.pdf binary
+*.zip binary
+*.7z binary
+*.bin binary
+*.hex binary
+*.elf binary

.github/workflows/ci.yml

@@ -303,10 +303,27 @@ jobs:
       python-version: '3.12'
       working-directory: '.'
 
+  cpp-format:
+    name: C++ Formatting (clang-format)
+    needs: [changes]
+    if: needs.changes.outputs.code == 'true'
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      - name: Install pinned clang-tools
+        # SHA-verified static LLVM 18.1.8 clang-format on PATH — the org source of
+        # truth, matching workstation-configs apps/clang-tools on dev boxes. See
+        # anolishq/.github#69.
+        uses: anolishq/.github/.github/actions/setup-clang-tools@43a0fe0a7feb87215f6e7677133be542ef6f1031 # setup-clang-tools
+      - name: Check formatting
+        run: git ls-files '*.c' '*.cc' '*.cpp' '*.cxx' '*.h' '*.hh' '*.hpp' '*.hxx' | xargs clang-format --dry-run --Werror
+
   ok:
     name: ok
     if: always()
-    needs: [changes, python-lint, python-typecheck, linux-matrix, strict-dimensional-validation, windows-core, windows-diagram, diagram-render-smoke, version-sync]
+    needs: [changes, python-lint, python-typecheck, linux-matrix, strict-dimensional-validation, windows-core, windows-diagram, diagram-render-smoke, version-sync, cpp-format]
     runs-on: ubuntu-24.04
     timeout-minutes: 5
     steps:

examples/01_basic_transform/main.cpp

@@ -5,52 +5,51 @@
 #include <iostream>
 
 int main() {
-  // 1. Create namespaces and signal store
-  fluxgraph::SignalNamespace sig_ns;
-  fluxgraph::FunctionNamespace func_ns;
-  fluxgraph::SignalStore store;
-
-  // 2. Build graph specification manually
-  fluxgraph::GraphSpec spec;
-
-  // Define edge: voltage_in --[scale=2.0, offset=1.0]--> voltage_out
-  fluxgraph::EdgeSpec edge;
-  edge.source_path = "sensor.voltage_in";
-  edge.target_path = "sensor.voltage_out";
-  edge.transform.type = "linear";
-  edge.transform.params["scale"] = 2.0;
-  edge.transform.params["offset"] = 1.0;
-  spec.edges.push_back(edge);
-
-  // 3. Compile graph
-  fluxgraph::GraphCompiler compiler;
-  auto program = compiler.compile(spec, sig_ns, func_ns);
-
-  // 4. Load into engine
-  fluxgraph::Engine engine;
-  engine.load(std::move(program));
-
-  // 5. Get signal IDs (these are your input/output "ports")
-  auto input_sig = sig_ns.resolve("sensor.voltage_in");
-  auto output_sig = sig_ns.resolve("sensor.voltage_out");
-
-  // 6. Simulation loop
-  std::cout << "Simple Transform: y = 2*x + 1\n";
-  std::cout << "================================\n";
-  for (int i = 0; i < 5; ++i) {
-    double input_val = i * 1.0;
-
-    // Write to input port
-    store.write(input_sig, input_val, "V");
-
-    // Execute graph (dt doesn't affect stateless linear transform)
-    engine.tick(0.1, store);
-
-    // Read from output port
-    double output_val = store.read_value(output_sig);
-    std::cout << "Input: " << input_val << "V -> Output: " << output_val
-              << "V\n";
-  }
-
-  return 0;
+    // 1. Create namespaces and signal store
+    fluxgraph::SignalNamespace sig_ns;
+    fluxgraph::FunctionNamespace func_ns;
+    fluxgraph::SignalStore store;
+
+    // 2. Build graph specification manually
+    fluxgraph::GraphSpec spec;
+
+    // Define edge: voltage_in --[scale=2.0, offset=1.0]--> voltage_out
+    fluxgraph::EdgeSpec edge;
+    edge.source_path = "sensor.voltage_in";
+    edge.target_path = "sensor.voltage_out";
+    edge.transform.type = "linear";
+    edge.transform.params["scale"] = 2.0;
+    edge.transform.params["offset"] = 1.0;
+    spec.edges.push_back(edge);
+
+    // 3. Compile graph
+    fluxgraph::GraphCompiler compiler;
+    auto program = compiler.compile(spec, sig_ns, func_ns);
+
+    // 4. Load into engine
+    fluxgraph::Engine engine;
+    engine.load(std::move(program));
+
+    // 5. Get signal IDs (these are your input/output "ports")
+    auto input_sig = sig_ns.resolve("sensor.voltage_in");
+    auto output_sig = sig_ns.resolve("sensor.voltage_out");
+
+    // 6. Simulation loop
+    std::cout << "Simple Transform: y = 2*x + 1\n";
+    std::cout << "================================\n";
+    for (int i = 0; i < 5; ++i) {
+        double input_val = i * 1.0;
+
+        // Write to input port
+        store.write(input_sig, input_val, "V");
+
+        // Execute graph (dt doesn't affect stateless linear transform)
+        engine.tick(0.1, store);
+
+        // Read from output port
+        double output_val = store.read_value(output_sig);
+        std::cout << "Input: " << input_val << "V -> Output: " << output_val << "V\n";
+    }
+
+    return 0;
 }

examples/02_thermal_mass/main.cpp

@@ -6,73 +6,73 @@
 #include <iostream>
 
 int main() {
-  // 1. Setup
-  fluxgraph::SignalNamespace sig_ns;
-  fluxgraph::FunctionNamespace func_ns;
-  fluxgraph::SignalStore store;
+    // 1. Setup
+    fluxgraph::SignalNamespace sig_ns;
+    fluxgraph::FunctionNamespace func_ns;
+    fluxgraph::SignalStore store;
 
-  // 2. Build graph with thermal mass model
-  fluxgraph::GraphSpec spec;
+    // 2. Build graph with thermal mass model
+    fluxgraph::GraphSpec spec;
 
-  // Define thermal mass model
-  fluxgraph::ModelSpec model;
-  model.id = "chamber_thermal";
-  model.type = "thermal_mass";
-  model.params["temp_signal"] = std::string("chamber.temperature");
-  model.params["power_signal"] = std::string("chamber.heater_power");
-  model.params["ambient_signal"] = std::string("chamber.ambient_temp");
-  model.params["thermal_mass"] = 1000.0;      // J/K
-  model.params["heat_transfer_coeff"] = 10.0; // W/K
-  model.params["initial_temp"] = 25.0;        // degC
-  spec.models.push_back(model);
+    // Define thermal mass model
+    fluxgraph::ModelSpec model;
+    model.id = "chamber_thermal";
+    model.type = "thermal_mass";
+    model.params["temp_signal"] = std::string("chamber.temperature");
+    model.params["power_signal"] = std::string("chamber.heater_power");
+    model.params["ambient_signal"] = std::string("chamber.ambient_temp");
+    model.params["thermal_mass"] = 1000.0;       // J/K
+    model.params["heat_transfer_coeff"] = 10.0;  // W/K
+    model.params["initial_temp"] = 25.0;         // degC
+    spec.models.push_back(model);
 
-  // Optional: Add noise to temperature reading
-  fluxgraph::EdgeSpec noise_edge;
-  noise_edge.source_path = "chamber.temperature";
-  noise_edge.target_path = "chamber.temperature_noisy";
-  noise_edge.transform.type = "noise";
-  noise_edge.transform.params["amplitude"] = 0.1; // +/- 0.1 degC noise
-  noise_edge.transform.params["seed"] = static_cast<int64_t>(42);
-  spec.edges.push_back(noise_edge);
+    // Optional: Add noise to temperature reading
+    fluxgraph::EdgeSpec noise_edge;
+    noise_edge.source_path = "chamber.temperature";
+    noise_edge.target_path = "chamber.temperature_noisy";
+    noise_edge.transform.type = "noise";
+    noise_edge.transform.params["amplitude"] = 0.1;  // +/- 0.1 degC noise
+    noise_edge.transform.params["seed"] = static_cast<int64_t>(42);
+    spec.edges.push_back(noise_edge);
 
-  // 3. Compile and load
-  fluxgraph::GraphCompiler compiler;
-  auto program = compiler.compile(spec, sig_ns, func_ns);
+    // 3. Compile and load
+    fluxgraph::GraphCompiler compiler;
+    auto program = compiler.compile(spec, sig_ns, func_ns);
 
-  fluxgraph::Engine engine;
-  engine.load(std::move(program));
+    fluxgraph::Engine engine;
+    engine.load(std::move(program));
 
-  // 4. Get signal IDs (input/output ports)
-  auto heater_sig = sig_ns.resolve("chamber.heater_power");
-  auto ambient_sig = sig_ns.resolve("chamber.ambient_temp");
-  auto temp_sig = sig_ns.resolve("chamber.temperature");
-  auto temp_noisy_sig = sig_ns.resolve("chamber.temperature_noisy");
+    // 4. Get signal IDs (input/output ports)
+    auto heater_sig = sig_ns.resolve("chamber.heater_power");
+    auto ambient_sig = sig_ns.resolve("chamber.ambient_temp");
+    auto temp_sig = sig_ns.resolve("chamber.temperature");
+    auto temp_noisy_sig = sig_ns.resolve("chamber.temperature_noisy");
 
-  // 5. Initialize ambient temperature
-  store.write(ambient_sig, 20.0, "degC");
+    // 5. Initialize ambient temperature
+    store.write(ambient_sig, 20.0, "degC");
 
-  // 6. Simulation: heat chamber for 5 seconds, then turn off
-  std::cout << "Thermal Mass Simulation\n";
-  std::cout << "=======================\n";
-  std::cout << std::fixed << std::setprecision(2);
+    // 6. Simulation: heat chamber for 5 seconds, then turn off
+    std::cout << "Thermal Mass Simulation\n";
+    std::cout << "=======================\n";
+    std::cout << std::fixed << std::setprecision(2);
 
-  for (double t = 0; t <= 10.0; t += 0.5) {
-    // Control heater: on for first 5 seconds, off after
-    double heater_power = (t < 5.0) ? 500.0 : 0.0;
-    store.write(heater_sig, heater_power, "W");
+    for (double t = 0; t <= 10.0; t += 0.5) {
+        // Control heater: on for first 5 seconds, off after
+        double heater_power = (t < 5.0) ? 500.0 : 0.0;
+        store.write(heater_sig, heater_power, "W");
 
-    // Execute physics
-    engine.tick(0.5, store);
+        // Execute physics
+        engine.tick(0.5, store);
 
-    // Read output ports
-    double temp = store.read_value(temp_sig);
-    double temp_noisy = store.read_value(temp_noisy_sig);
+        // Read output ports
+        double temp = store.read_value(temp_sig);
+        double temp_noisy = store.read_value(temp_noisy_sig);
 
-    std::cout << "t=" << std::setw(5) << t << "s  "
-              << "Heater=" << std::setw(5) << heater_power << "W  "
-              << "Temp=" << std::setw(6) << temp << " degC  "
-              << "Noisy=" << std::setw(6) << temp_noisy << " degC\n";
-  }
+        std::cout << "t=" << std::setw(5) << t << "s  "
+                  << "Heater=" << std::setw(5) << heater_power << "W  "
+                  << "Temp=" << std::setw(6) << temp << " degC  "
+                  << "Noisy=" << std::setw(6) << temp_noisy << " degC\n";
+    }
 
-  return 0;
+    return 0;
 }