feat: complete API coverage in examples + wiki FastPlot-to-FastSense rename

* ci: migrate wiki to main repo with sync workflow

- Track wiki/ content in main repo as source of truth
- Add sync-wiki.yml to push wiki/ to GitHub Wiki repo on merge
- Update generate-docs.yml to write API docs to main repo wiki/
- Update wiki-links.yml to check main repo wiki/ instead of cloning remote

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: address CI workflow issues in wiki sync pipeline

- Add inline wiki sync to generate-docs.yml (GITHUB_TOKEN pushes don't re-trigger other workflows)
- Propagate deletions in sync-wiki.yml (rm stale files before copy)
- Add explicit permissions to wiki-links.yml

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: add generate_wiki.py with page mapping, change detection, and context assembly

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: address code quality issues in generate_wiki.py

- Add AUTO_GENERATED_NOTICE safety net on write
- Apply exclusion filter in --all mode
- Handle absolute paths in --changed-files
- Promote TOKEN_BUDGET to module-level constant
- Fix summary file newline handling

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: complete API coverage in examples + wiki FastPlot→FastSense rename

Enhance 12 example scripts to demonstrate 25+ previously uncovered APIs
including setScale, resetColorIndex, lookupMetadata, setLineMetadata,
openLoupe, distFig, resetDefaults, FastSenseDefaults, undockTab,
SensorRegistry register/unregister/printTable/viewer, DashboardEngine
exportScript/load/removeWidget/setWidgetPosition, color palettes,
setTileTheme, setViewMode, DeferDraw, ShowProgress, reapplyTheme,
setViolationsVisible, updateData, currentStatus, countViolations,
StateChannel.valueAt, ConsoleProgressBar, and DataStore.findViolations.

Also rename all class references in 13 wiki pages from the old FastPlot
names (FastPlotFigure, FastPlotDock, etc.) to the current FastSense names,
while preserving FastPlot as the project/brand name.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: add prompt templates for each wiki page type

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: add Claude API integration for wiki page generation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: harden Claude API response handling in generate_wiki.py

- Guard against empty response content list and non-text blocks
- Warn on max_tokens truncation
- Only strip trailing code fence when leading fence was detected

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: address PR review — remaining wiki FastPlot.m references

Fix three stale references found in code review:
- Architecture.md: directory tree showed libs/FastPlot/ and FastPlot.m
- Examples.md: "Proves FastPlot handles" → "Proves FastSense handles"
- Use-Case wiki: "in FastPlot.m" → "in FastSense.m"

Also add clarifying comment in example_dashboard_engine.m noting that
the JSON load restores the pre-mutation state.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: HanSur94

.github/workflows/generate-docs.yml

@@ -23,25 +23,43 @@ jobs:
         with:
           python-version: '3.12'
 
-      - name: Clone wiki repo
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          git clone "https://x-access-token:${GITHUB_TOKEN}@github.com/HanSur94/FastSense.wiki.git" wiki
-
       - name: Generate API docs
         run: python3 scripts/generate_api_docs.py
 
-      - name: Push updated wiki
+      - name: Commit updated wiki
         run: |
-          cd wiki
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add -A
+          git add wiki/
           if git diff --cached --quiet; then
             echo "No documentation changes"
           else
             git commit -m "docs: auto-update API reference from source code"
             git push
-            echo "Wiki API docs updated"
+            echo "Wiki API docs updated in main repo"
+          fi
+
+      - name: Sync to wiki repo
+        if: success()
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Only sync if the commit step actually pushed changes
+          if git log -1 --format='%s' | grep -q "auto-update API reference"; then
+            git clone "https://x-access-token:${GITHUB_TOKEN}@github.com/HanSur94/FastSense.wiki.git" wiki-remote
+            rm -f wiki-remote/*.md
+            cp wiki/*.md wiki-remote/
+            cd wiki-remote
+            git config user.name "github-actions[bot]"
+            git config user.email "github-actions[bot]@users.noreply.github.com"
+            git add -A
+            if git diff --cached --quiet; then
+              echo "Wiki repo already up to date"
+            else
+              git commit -m "docs: sync wiki from main repo"
+              git push
+              echo "Wiki repo synced"
+            fi
+          else
+            echo "No wiki changes were committed, skipping sync"
           fi

.github/workflows/sync-wiki.yml

@@ -0,0 +1,43 @@
+name: Sync Wiki
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'wiki/**'
+
+permissions:
+  contents: write
+
+jobs:
+  sync:
+    name: Sync wiki to GitHub Wiki repo
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main repo
+        uses: actions/checkout@v4
+
+      - name: Clone wiki repo
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git clone "https://x-access-token:${GITHUB_TOKEN}@github.com/HanSur94/FastSense.wiki.git" wiki-remote
+
+      - name: Copy wiki content
+        run: |
+          rm -f wiki-remote/*.md
+          cp wiki/*.md wiki-remote/
+
+      - name: Push to wiki repo
+        run: |
+          cd wiki-remote
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add -A
+          if git diff --cached --quiet; then
+            echo "No wiki changes to sync"
+          else
+            git commit -m "docs: sync wiki from main repo"
+            git push
+            echo "Wiki synced successfully"
+          fi

.github/workflows/wiki-links.yml

@@ -9,17 +9,16 @@ on:
     - cron: '0 6 * * 1'
   workflow_dispatch:
 
+permissions:
+  contents: read
+
 jobs:
   check-links:
     name: Check Wiki Links
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
 
-      - name: Clone wiki
-        run: |
-          git clone https://github.com/HanSur94/FastSense.wiki.git wiki-check
-
       - name: Check markdown links
         uses: lycheeverse/lychee-action@v2
         with:
@@ -28,5 +27,5 @@ jobs:
             --exclude-loopback
             --exclude 'github.com/HanSur94/FastSense/wiki'
             --suggest
-            wiki-check/*.md
+            wiki/*.md
           fail: true

examples/example_100M.m

@@ -11,19 +11,35 @@
 y = cumsum(randn(1, n)) / sqrt(n);  % random walk
 fprintf('Data generated in %.1f seconds.\n', toc);
 
-fprintf('Rendering with ShowProgress=true (default)...\n');
+fprintf('Rendering...\n');
 tic;
 
+% DeferDraw (default: false) — when true, skips drawnow during render.
+%   Useful in batch/headless workflows. Requires manual drawnow afterward.
+% ShowProgress (default: true) — when false, hides the console progress bar.
+%   The default shows a live progress bar during render.
+% Both are set to their non-default values here to demonstrate the options.
 fp = FastSense();
-fp.ShowProgress = true;   % show console progress bar during render (default)
-fp.DeferDraw = false;     % allow incremental drawing (default)
+fp.DeferDraw = true;
+fp.ShowProgress = false;
 fp.addLine(x, y, 'DisplayName', '100M Random Walk', 'Color', [0 0.4 0.8]);
 fp.addThreshold(3, 'Direction', 'upper', 'ShowViolations', true);
 fp.addThreshold(-3, 'Direction', 'lower', 'ShowViolations', true);
 fp.render();
+drawnow;  % manual drawnow needed since DeferDraw=true
 
 fprintf('Rendered in %.3f seconds. Zoom in to see detail!\n', toc);
 title(fp.hAxes, 'FastSense — 100M Points Stress Test');
 
-fprintf('\nDeferDraw=true skips drawnow during render (useful in batch/headless).\n');
-fprintf('ShowProgress=false hides the console progress bar.\n');
+%% ConsoleProgressBar — standalone usage for custom batch workflows
+% FastSense uses this internally when ShowProgress=true, but you can also
+% use it directly for your own long-running loops.
+pb = ConsoleProgressBar();
+pb.start();
+nSteps = 20;
+for k = 1:nSteps
+    pb.update(k, nSteps, 'Processing');
+    pause(0.05);
+end
+pb.finish();
+fprintf('ConsoleProgressBar demo complete.\n');

examples/example_alarm_bands.m

@@ -43,6 +43,6 @@
 %% setViolationsVisible — toggle violation markers on/off
 fp.setViolationsVisible(false);
 fprintf('setViolationsVisible(false): violation markers hidden.\n');
-pause(1);
+drawnow;
 fp.setViolationsVisible(true);
 fprintf('setViolationsVisible(true): violation markers restored.\n');

examples/example_basic.m

@@ -37,15 +37,23 @@
 % Exponential growth data is best viewed with log scaling
 n2 = 1e6;
 x2 = linspace(1, 1000, n2);
-y2 = exp(x2 / 200) + 0.1 * abs(randn(1, n2)) .* exp(x2 / 200);
+base2 = exp(x2 / 200);
+y2 = base2 .* (1 + 0.1 * abs(randn(1, n2)));
 
 fp2 = FastSense();
 fp2.addLine(x2, y2, 'DisplayName', 'Exponential Growth');
 fp2.addThreshold(100, 'Direction', 'upper', 'ShowViolations', true, ...
     'Label', 'Warning');
 fp2.render();
 
-% Switch Y axis to log scale (can be called before or after render)
+% Switch Y axis to log scale (can be called before or after render).
+% Try fp2.setScale('YScale', 'linear') to toggle back.
 fp2.setScale('YScale', 'log');
 title(fp2.hAxes, 'setScale — Logarithmic Y Axis');
 fprintf('setScale() demo: Y axis switched to log scale.\n');
+
+%% updateData — replace line data on an already-rendered plot
+newY = cos(x * 2*pi/15) + 0.4*randn(1, n);
+fp.updateData(1, x, newY);
+title(fp.hAxes, 'updateData — line data replaced in-place');
+fprintf('updateData() replaced 10M-point line data on the first plot.\n');

examples/example_dashboard.m

@@ -67,7 +67,8 @@
 fig.setTileXLabel(4, 'Time (s)');
 
 %% setTileTheme — per-tile theme overrides
-% Override individual tile appearance without changing the whole grid theme
+% Override individual tile appearance without changing the whole grid theme.
+% Uses custom dark colors for tile 4 only; the other tiles keep the grid theme.
 fig.setTileTheme(4, struct('Background', [0.15 0.15 0.2], ...
     'AxesColor', [0.1 0.1 0.15], 'ForegroundColor', [0.9 0.9 0.9]));
 fig.reapplyTheme();

examples/example_dashboard_engine.m

@@ -79,7 +79,18 @@
 d.exportScript(scriptPath);
 fprintf('Dashboard exported to script: %s\n', scriptPath);
 
-%% 5. Load from JSON (demonstrates roundtrip)
+%% 5. Programmatic widget management
+% setWidgetPosition — move/resize a widget on the 24-column grid
+d.setWidgetPosition(2, [1 9 12 8]);  % move pressure widget below, half-width
+fprintf('setWidgetPosition: moved pressure widget to [1 9 12 8].\n');
+
+% removeWidget — delete a widget by index
+d.removeWidget(3);  % remove the full-view temperature widget
+fprintf('removeWidget: removed widget 3 (full-view temperature).\n');
+
+%% 6. Load from JSON (demonstrates roundtrip)
+% Loads the original 3-widget layout saved in step 3, before the
+% removeWidget/setWidgetPosition mutations above.
 % SensorResolver maps sensor keys back to Sensor objects for the loaded config
 sensorMap = containers.Map({'T-401', 'P-201'}, {sTemp, sPress});
 d2 = DashboardEngine.load(jsonPath, 'SensorResolver', @(key) sensorMap(key));

examples/example_disk_storage.m

@@ -87,6 +87,12 @@
 fprintf('  First 5 status values: %s\n', strjoin(vals, ', '));
 fprintf('  Available columns: %s\n', strjoin(ds.listColumns(), ', '));
 
+% findViolations — find threshold violations directly on disk-backed data.
+% Skips chunks whose y_min/y_max can't contain violations, avoiding full reads.
+tic;
+[vx, vy] = ds.findViolations(1, n_large, 1.0, true);  % upper threshold at 1.0
+fprintf('  findViolations(upper > 1.0): %d violations in %.4f s\n', numel(vx), toc);
+
 ds.cleanup();  % explicit cleanup (also happens automatically on delete)
 fprintf('  DataStore cleaned up.\n');
 

examples/example_linked.m

@@ -38,8 +38,11 @@
 
 %% setViewMode — control how X-axis adjusts during live updates
 % 'preserve' keeps current zoom, 'follow' scrolls to track latest data,
-% 'reset' fits full X range.
+% 'reset' fits full X range. The mode takes effect when startLive() is
+% active; on a static plot like this it simply pre-configures the setting.
+% See example_event_detection_live.m for setViewMode in action with live data.
 fp1.setViewMode('follow');
 fp2.setViewMode('follow');
 fp3.setViewMode('follow');
-fprintf('setViewMode(''follow'') set on all 3 plots — ready for live scrolling.\n');
+fprintf('setViewMode(''follow'') set on all 3 plots — takes effect during live updates.\n');
+fprintf('  See example_event_detection_live.m for live scrolling in action.\n');