2 Commits

Author	SHA1	Message	Date
Joseph Doherty	b330faff03	mbproxy: cross-platform support — Linux/systemd alongside Windows ... Make the service build, run, and install on Linux as a first-class target while keeping the Windows Service + Event Log behaviour intact. - Build: drop the hardcoded win-x64 RID — single-file publish now works for any RID. publish.ps1 gains -Rid; new publish.sh for Linux hosts. - Diagnostics: DiagnosticSinkSelector picks the Error+ sink per host — Windows Event Log under the SCM, local syslog under systemd (Serilog.Sinks.SyslogMessages), none for interactive runs. The EventLog truncation helper is extracted so it is testable cross-OS. - Host: Program.cs registers AddSystemd() alongside AddWindowsService(). - Config: a RID-conditioned appsettings template ships Windows or Unix paths; both templates are schema-validated by a test. - Install: systemd unit (Type=exec) plus install.sh / uninstall.sh. Also fixes two cross-platform bugs found while testing: install.ps1 and uninstall.ps1 used New-EventLog / Remove-EventLog (absent in PowerShell 7), and the E2E sim launcher hardcoded Windows venv paths. - Docs updated across README, CLAUDE.md, and docs/ for dual-platform. 413 tests pass on Windows; 374 (all non-simulator) on Linux. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-15 09:41:59 -04:00
Joseph Doherty	f49e27e316	mbproxy/docs: split deep docs into focused PascalCase files per StyleGuide ... Adds 11 topic-focused docs under docs/{Architecture,Features,Operations,Reference,Testing}/ and links them from README.md's new "Detailed documentation" section. Existing top-level docs (design.md, kpi.md, operations.md) remain as canonical landings. Architecture/ - Overview.md (150 lines) — listener topology, request flow, per-PLC isolation - ConnectionModel.md (247 lines) — TxId multiplexer, watchdog, disconnect cascade - ReadCoalescing.md (243 lines) — in-flight FC03/04 dedup via InFlightByKeyMap - ResponseCache.md (398 lines) — opt-in per-tag TTL cache + range-overlap invalidation Features/ - BcdRewriting.md (252 lines) — codec, CDAB, FC scope, partial-overlap policy - HotReload.md (189 lines) — IOptionsMonitor + per-change-kind reconcile rules Operations/ - Configuration.md (422 lines) — every Mbproxy:* option + validation rules - StatusPage.md (334 lines) — admin endpoint surface, every JSON field - Troubleshooting.md (364 lines) — diagnosis playbook keyed to log events Reference/ - LogEvents.md (499 lines) — 28 events across 7 categories, grep-verified Testing/ - Simulator.md (235 lines) — pymodbus fixture, skip policy, 3.13 framer quirk Each doc was written by a dedicated agent against the StyleGuide.md rules with a per-doc phase gate (PascalCase filename, H1 Title Case, code-fence language tags, Related Documentation section with >=3 relative links, real type names verified against src/). Cross-references between docs use relative paths; all 18 README->docs links and all sibling links resolve. Known follow-up: docs/design.md lines 215-251 are stale on two log-event property templates (config.reload.applied and config.reload.rejected) and mention LogContext.PushProperty scoping that isn't actually used. Reference/ LogEvents.md is now the authoritative event catalog and source-of-truth. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-14 03:44:34 -04:00