Skip to content

docs: investigate shared connection modeling - #2064

Merged
Brad-Edwards merged 1 commit into
devfrom
2060-shared-connection-design
Nov 15, 2026
Merged

Brad-Edwards merged 1 commit into
devfrom
2060-shared-connection-design

Conversation

@Brad-Edwards

Copy link
Copy Markdown
Collaborator

Summary

Compare application, network and electrical connections while preserving their distinct meanings. Reuse native SDL relationships and recursive profile contracts; identify the optional public domain-profile host as the remaining authoring gap.

Requirement UIDs

  • (none — bug/refactor/maintenance run; see Traceability section below)

Related Issues

Closes #2060

ADR Impact

  • ADR-052 (unchanged)
  • ADR-105 (unchanged)
  • ADR-121 (unchanged)

Changes

  • Compare HTTP forwarding, OPC UA connection points, RFC 8345 network links and CIM terminal/junction references against primary sources.
  • Define minimum connection and endpoint concepts with optional refinements, stable ownership and domain-specific direction and cycle rules.
  • Preserve current reference, composition, open/closed and provisioning semantics; include permitted and refused cases, a data-flow diagram and security boundaries.

Test Plan

  • Full completion suite required in CI before merge
  • Repository policy checks required in CI before merge (documentation/workflow guardrails)
  • Unit tests / integration tests: N/A — docs-only change

Passed: explicit-path nox -s docs-prose for both added documents (Vale and shared STE); tools/check_repo_policy.py --check-set file-local before and after edits; git diff --check; Markdown HTML rendering and local-link checks. Three selected cases in test_issue_1203_recursive_normal_form.py passed (open scopes, graph references and conjunction). Review found no issues. Source review: revision 3eb5790; pinned reference and recursive specs match issue revision 33c09e9. Primary sources: RFC 9110 §3.7, RFC 8345 §§4.2/4.4.5, OPC UA Devices 1.05.0 §§4.7/5.4/5.5, ENTSO-E RCP 2.3.1 p74 (retrieved via curl/pdftotext). Design prose only: no new executable behavior, schema, fixture or mutation test. Full suites remain in CI. Local HTML structure and links were inspected; no graphical Mermaid preview was available.

Ground Control Checks

  • Repository policy checks required in CI before merge
  • Pre-push Codex review completed; all findings fixed or dispositioned

Traceability

  • IMPLEMENTS: (none — bug/refactor/maintenance run)
  • TESTS: (none — documentation/configuration/structural-invariant run)

Checklist

  • Code follows the project's coding standards
  • Changelog: owned by Release Please (generated from the Conventional Commit PR title; no per-PR fragment)
  • Architectural docs updated if stack, package structure, or key behaviors changed

Documentation

Updated: see diff.

@Brad-Edwards
Brad-Edwards added this pull request to the merge queue Nov 15, 2026
Merged via the queue into dev with commit e853abc Nov 15, 2026
38 checks 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