Joseph Doherty
fe2a6db786
rust / build / test / clippy / fmt (push) Has been cancelled
Layout:
- src/ .NET 10 x64 reference: MxNativeCodec, MxNativeClient,
MxAsbClient, probes, tests, harnesses. Executable spec.
- design/ Architectural plan for the Rust port (M0–M6), error
model, protocol invariants, risks (R1–R16), adversarial
review log (review.md).
- rust/ Rust workspace. M0 skeleton + M1 codec parity.
mxaccess-codec: 215 unit tests + 2 cross-implementation
parity tests (byte-identical against .NET reference).
Other crates are M0 stubs awaiting M2+.
- captures/ Frida + netsh + pcap evidence per CLAUDE.md
("captures are evidence, not throwaway logs").
- analysis/ Decompiled C# (frida/proxy/decompiled-*),
Ghidra exports for native DLLs (`exports/` only —
working state at `projects/` and AVEVA's input
binaries at `input/` are gitignored).
- docs/ Reverse-engineering reference docs.
- tools/ Setup-LiveProbeEnv.ps1 (Infisical credential fetcher),
Compute-Crc.ps1 (.NET parity helper).
- .github/workflows/ Rust CI: fmt + build + test + clippy on Windows.
- LICENSE MIT (Joseph Doherty, 2026).
Verified:
- cargo test --workspace → 217 passed (215 unit + 2 .NET parity), 0 failed
- cargo clippy --workspace -- -D warnings → clean
- cargo fmt --all -- --check → clean
- cargo publish --dry-run -p mxaccess-codec → packages cleanly
Excluded from history (see .gitignore):
- **/bin, **/obj, **/target — build artifacts
- analysis/ghidra/projects/ — Ghidra working state (regenerable)
- analysis/ghidra/input/ — AVEVA proprietary DLLs (vendor IP)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
52 lines
1.4 KiB
Markdown
52 lines
1.4 KiB
Markdown
# mxaccess (Rust port)
|
||
|
||
Native Rust replacement for AVEVA / Wonderware MXAccess. See `../design/` for
|
||
the architectural specification, `../src/` for the .NET reference (the
|
||
executable spec), and `../CLAUDE.md` for project-wide rules.
|
||
|
||
## Status
|
||
|
||
**M0** — Workspace skeleton. Stub types compile; nothing is implemented yet.
|
||
See `../design/60-roadmap.md` for the M0–M6 milestone plan.
|
||
|
||
## Layout
|
||
|
||
```
|
||
rust/
|
||
Cargo.toml workspace root
|
||
rust-toolchain.toml 1.85 stable
|
||
crates/
|
||
mxaccess-codec/ pure protocol codec, no I/O
|
||
mxaccess-galaxy/ Galaxy SQL resolver (tiberius)
|
||
mxaccess-rpc/ DCE/RPC + NTLMv2 + OXID + OBJREF
|
||
mxaccess-callback/ INmxSvcCallback RPC server
|
||
mxaccess-nmx/ INmxService2 client
|
||
mxaccess-asb-nettcp/ net.tcp framing (MC-NMF + MC-NBFX/NBFS)
|
||
mxaccess-asb/ IASBIDataV2 client
|
||
mxaccess/ async session + Transport trait + public API
|
||
mxaccess-compat/ LMXProxyServer-shaped facade
|
||
```
|
||
|
||
## Build
|
||
|
||
```powershell
|
||
cargo build --workspace
|
||
cargo test --workspace
|
||
cargo clippy --workspace -- -D warnings
|
||
cargo fmt --check
|
||
```
|
||
|
||
## Live probes
|
||
|
||
```powershell
|
||
. ..\tools\Setup-LiveProbeEnv.ps1
|
||
cargo test -p mxaccess --features live -- --ignored
|
||
```
|
||
|
||
The setup script fetches credentials from Infisical via
|
||
`wwtools/secrets/Get-Secret.ps1`. Never inline plaintext credentials.
|
||
|
||
## License
|
||
|
||
MIT — see `../LICENSE`.
|