Skip to content

docs/ci: add production gateway contract and fix test discovery - #1

Merged
masarray merged 2 commits into
mainfrom
chore/agent-engineering-contract-v3
Sep 10, 2026
Merged

docs/ci: add production gateway contract and fix test discovery#1
masarray merged 2 commits into
mainfrom
chore/agent-engineering-contract-v3

Conversation

@masarray

@masarray masarray commented Sep 10, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a stack-aware AGENTS.md for ARServer's WPF/.NET IEC 61850 MMS → runtime cache → Modbus TCP / MQTT architecture and fixes a CI test-discovery defect found while validating the branch.

Engineering contract

  • root-cause-first workflow with a three-patch circuit breaker
  • one authoritative runtime cache; Modbus/MQTT/UI consume coherent snapshots rather than creating separate truth
  • typed Result/Try failure contracts for expected protocol/runtime outcomes
  • infrastructure exceptions contained at boundaries rather than inner polling loops
  • zero UI blocking for MMS/SCL/network/export work
  • bounded queues/backpressure for polling, publishing, UI and diagnostics
  • async aggregated diagnostics; log failure cannot block gateway operation
  • transactional mapping/config promotion and explicit reconnect/session state
  • long-running resource/leak and >10% performance-regression review gates

CI root-cause fix

The first PR CI failure was not an ARServer build failure: ARServer.sln built successfully, but recursive test discovery entered .deps/ARIEC61850/tests and invoked dependency test projects with --no-build, even though those test assemblies were not built by the ARServer solution.

CI now:

  • keeps the ARIEC61850 dependency checkout required by the ARServer build;
  • excludes .deps, bin, and obj from repository-owned test discovery;
  • runs only ARServer-owned test projects when present;
  • leaves dependency test validation to the dependency's owning repository.

The corrected CI run #82 is green.

@masarray masarray changed the title docs: add production gateway engineering contract docs/ci: add production gateway contract and fix test discovery Sep 10, 2026
@masarray
masarray merged commit 53e22b8 into main Sep 10, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant