Task #220 — Wire FOCAS into DriverFactoryRegistry bootstrap pipeline #199

dohertj2 · 2026-04-21T01:10:23-04:00

dohertj2 commented

2026-04-21 01:10:23 -04:00

Closes the non-hardware gap in #220. FOCAS had full Tier-C architecture (Driver.FOCAS + Driver.FOCAS.Host + Driver.FOCAS.Shared, supervisor, post-mortem MMF, NSSM scripts, 239 tests) but no factory registration, so config-DB DriverInstance rows of type FOCAS would fail at bootstrap with unknown driver type. Hardware-gated FwlibHostedBackend stays deferred under #222 lab-rig.

Ships FocasDriverFactoryExtensions.Register mirroring the Galaxy pattern. JSON schema selects backend via Backend field: ipc (default, Tier-C pipe to Host), fwlib (direct in-process P/Invoke), unimplemented (fail-fast stub). Devices / Tags / Probe / Timeout / Series feed into FocasDriverOptions with eager Series + DataType validation.

Tests: 13 new FocasDriverFactoryExtensionsTests. Regression: 202 FOCAS + 13 FOCAS.Host + 24 FOCAS.Shared + 239 Server all pass.

Closes the non-hardware gap in #220. FOCAS had full Tier-C architecture (Driver.FOCAS + Driver.FOCAS.Host + Driver.FOCAS.Shared, supervisor, post-mortem MMF, NSSM scripts, 239 tests) but no factory registration, so config-DB DriverInstance rows of type FOCAS would fail at bootstrap with unknown driver type. Hardware-gated FwlibHostedBackend stays deferred under #222 lab-rig. Ships FocasDriverFactoryExtensions.Register mirroring the Galaxy pattern. JSON schema selects backend via Backend field: ipc (default, Tier-C pipe to Host), fwlib (direct in-process P/Invoke), unimplemented (fail-fast stub). Devices / Tags / Probe / Timeout / Series feed into FocasDriverOptions with eager Series + DataType validation. Tests: 13 new FocasDriverFactoryExtensionsTests. Regression: 202 FOCAS + 13 FOCAS.Host + 24 FOCAS.Shared + 239 Server all pass.

dohertj2 added 1 commit 2026-04-21 01:10:24 -04:00

Task #220 — Wire FOCAS into DriverFactoryRegistry bootstrap pipeline dfe3731c73

Closes the non-hardware gap surfaced in the #220 audit: FOCAS had full Tier-C
architecture (Driver.FOCAS + Driver.FOCAS.Host + Driver.FOCAS.Shared, supervisor,
post-mortem MMF, NSSM scripts, 239 tests) but no factory registration, so config-DB
DriverInstance rows of type "FOCAS" would fail at bootstrap with "unknown driver
type". Hardware-gated FwlibHostedBackend (real Fwlib32 P/Invoke inside the Host
process) stays deferred under #222 lab-rig.

Ships:
  - FocasDriverFactoryExtensions.Register(registry) mirroring the Galaxy pattern.
    JSON schema selects backend via "Backend" field:
      "ipc" (default) — IpcFocasClientFactory → named-pipe FocasIpcClient →
                        Driver.FOCAS.Host process (Tier-C isolation)
      "fwlib"         — direct in-process FwlibFocasClientFactory (P/Invoke)
      "unimplemented" — UnimplementedFocasClientFactory (fail-fast on use —
                        useful for staging DriverInstance rows pre-Host-deploy)
  - Devices / Tags / Probe / Timeout / Series feed into FocasDriverOptions.
    Series validated eagerly at top-level so typos fail at bootstrap, not first
    read. Tag DataType + Series enum values surface clear errors listing valid
    options.
  - Program.cs adds FocasDriverFactoryExtensions.Register alongside Galaxy.
  - Driver.FOCAS.csproj references Core (for DriverFactoryRegistry).
  - Server.csproj adds Driver.FOCAS ProjectReference so the factory type is
    reachable from Program.cs.

Tests: 13 new FocasDriverFactoryExtensionsTests covering: registry entry,
case-insensitive lookup, ipc backend with full config, ipc defaults, missing
PipeName/SharedSecret errors, fwlib backend short-path, unimplemented backend,
unknown-backend error, unknown-Series error, tag missing DataType, null/ws args,
duplicate-register throws.

Regression: 202 FOCAS + 13 FOCAS.Host + 24 FOCAS.Shared + 239 Server all pass.

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

dohertj2 merged commit 443474f58f into v2

2026-04-21 01:10:42 -04:00

dohertj2 referenced this issue from a commit

2026-04-21 01:10:43 -04:00

Merge pull request 'Task #220 — Wire FOCAS into DriverFactoryRegistry bootstrap pipeline' (#199) from task-220-focas-factory-registration into v2

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: dohertj2/lmxopcua#199