Initial project state: .NET reference, design, Rust port (M0+M1), evidence

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>
2026-05-05 06:21:00 -04:00
parent 43733699b0
commit fe2a6db786
3849 changed files with 352975 additions and 0 deletions
@@ -0,0 +1,67 @@
+# ---- .NET build artifacts ----
+**/bin/
+**/obj/
+*.user
+*.userprefs
+*.suo
+*.userosscache
+*.sln.docstates
+[Dd]ebug/
+[Rr]elease/
+.vs/
+
+# ---- Rust build artifacts (rust/ has its own .gitignore too) ----
+**/target/
+**/*.rs.bk
+Cargo.lock.bak
+# rust/Cargo.lock IS committed for workspace reproducibility.
+
+# ---- IDE / editor ----
+.idea/
+.vscode/
+*.swp
+*~
+*.bak
+*.tmp
+
+# ---- OS ----
+Thumbs.db
+Desktop.ini
+.DS_Store
+
+# ---- Local credential / state caches ----
+# (We never inline secrets — credentials live in Infisical via
+# tools/Setup-LiveProbeEnv.ps1. Anything in these patterns is
+# definitionally never tracked.)
+**/*.secret
+**/.env
+**/.env.local
+**/credentials.json
+
+# ---- Frida-generated test fixture symlinks ----
+# rust/tests/fixtures/ is populated at test time from captures/ per
+# design/60-roadmap.md M0; the actual symlink tree is not checked in.
+/rust/tests/fixtures/
+
+# ---- Plan files (project-local Claude Code plan staging) ----
+# These live under the user's ~/.claude/plans/ scope but appear at the
+# project root if accidentally created.
+/zazzy-napping-sketch.md
+
+# ---- Reverse-engineering working state ----
+# `analysis/ghidra/projects/` is Ghidra's transient project database
+# (~178 MB). It is regenerated by re-loading the binaries in
+# `analysis/ghidra/input/` and re-running the headless decompile scripts
+# under `analysis/ghidra/scripts/`. The actual evidence — the decompiled
+# C/C++ pseudo-source — lives under `analysis/ghidra/exports/` and IS
+# committed.
+/analysis/ghidra/projects/
+
+# `analysis/ghidra/input/` contains AVEVA's proprietary DLLs (Lmx.dll,
+# NmxSvc.exe, NmxAdptr.dll, NmxSvcps.dll, LmxProxy.dll, aaMxDataConsumer.dll,
+# WWProxyStub.dll) copied from a System Platform install. These are vendor
+# binaries; they are not ours to redistribute. The decompiled exports under
+# `analysis/ghidra/exports/` ARE committed (they are our analysis, not the
+# vendor binaries). To repopulate `input/` for a re-decompile, copy the
+# matching DLLs from a local AVEVA install and rerun the Ghidra scripts.
+/analysis/ghidra/input/