Docs: bring READMEs in line with current state (net48, JSON wire)

- Root README: launcher is .NET Framework 4.8 (was .NET 6/x86); RPC is framed
  JSON (was BinaryFormatter); added Contract/ + SecureConfig/; dropped the
  now-resolved "known duplication" warning; corrected the lib/*.dll note
  (TeslaConsoleLaunchLib/TeslaSecureConfiguration are source-built, kept only as
  test baselines); added a short history section.
- Console README: Contract is net48-only; Launcher targets net48.
- Launcher README: net48 framework-dependent (was net8/x64 self-contained);
  needs .NET Framework 4.8 (built into Windows), no bundled runtime.
- DiffTests README: original 4.11.3.37076 vs recovered 4.11.4.x (no longer share
  identity); noted version-insensitive comparison + the new protocol/crypto guards.
- Removed Launcher/assets/MEMORY.md (stale leftover dev-notes, superseded by the
  README and now-moot post-BinaryFormatter).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Cyd
2026-06-30 13:44:06 -05:00
co-authored by Claude Opus 4.8
parent 2a3d1c1ef6
commit d5c4be26ce
5 changed files with 69 additions and 167 deletions
+9 -9
View File
@@ -39,10 +39,10 @@ The console references these assemblies. Most are vendored as binaries under
Two of these are no longer vendored binaries — they are built from source and
shared across the suite:
- `TeslaConsoleLaunchLib``../Contract/Tesla.Contract.csproj`, a multi-targeted
`net48;net8.0-windows` project: the single source of truth for the Console↔Launcher
RPC contract (wire types, the `PodManagerConnection` client, and the framed-JSON
`PodRpc` protocol), shared with the Launcher Service. The assembly keeps the
- `TeslaConsoleLaunchLib``../Contract/Tesla.Contract.csproj`, a net48 project: the
single source of truth for the Console↔Launcher RPC contract (wire types, the
`PodManagerConnection` client, and the framed-JSON `PodRpc` protocol), shared with the
Launcher Service. The assembly keeps the
`TeslaConsoleLaunchLib` name so the original-exe baseline still resolves in the
differential tests; the wire no longer embeds assembly names (see RPC note below).
- `TeslaSecureConfiguration``../SecureConfig/Tesla.SecureConfig.csproj` (net48),
@@ -58,11 +58,11 @@ decompiled to source the same way if full-source builds are needed.
The pod-management channel (TCP 53290) runs **length-prefixed System.Text.Json**
frames over the existing OFB-encrypted stream — see `Contract/PodRpcProtocol.cs`,
shared verbatim by both ends. This replaced the original `BinaryFormatter` +
serialized-`MethodBase` scheme (a remote-code-execution sink and the reason the
Launcher was pinned to EOL .NET 6); dispatch is now by method-name string. The
Launcher Service/Agent target **net8**. Note the Console still uses `BinaryFormatter`
for *local* disk persistence (`Site` config, mission results) — that is local file
I/O on net48, not the network surface, and is intentionally left alone.
serialized-`MethodBase` scheme (a remote-code-execution sink, and what had pinned the
Launcher to an old runtime); dispatch is now by method-name string. The Launcher
Service/Agent target **net48**, same as the Console. Note the Console still uses
`BinaryFormatter` for *local* disk persistence (`Site` config, mission results) — that
is local file I/O on net48, not the network surface, and is intentionally left alone.
## Layout
+18 -6
View File
@@ -6,12 +6,14 @@ source in this repo) behaves identically to the **original** reference binary in
## How it works
Both files carry the *exact same* assembly identity
(`TeslaConsole, Version=4.11.3.37076`), so the .NET loader will not hold both in
one AppDomain. The suite therefore loads each assembly into its **own child
AppDomain** (`DifferentialFixture`) and drives it through a `MarshalByRefObject`
proxy (`Invoker`). This is why the project targets **net48** — AppDomains are a
.NET Framework feature.
The suite loads each assembly into its **own child AppDomain**
(`DifferentialFixture`) and drives it through a `MarshalByRefObject` proxy
(`Invoker`). This is why the project targets **net48** — AppDomains are a .NET
Framework feature. The **original** is the `4.11.3.37076` baseline; the **recovered**
build is the modernized `4.11.4.x` line (same `TeslaConsole` assembly name, an
intentionally newer version). Because the two versions differ, the public-member
comparison strips `Version=` stamps before diffing — it compares type/member *names*,
not assembly versions.
Each child domain is given a probe directory (the recovered build's output, which
ships every dependency DLL) so the original — which is distributed without its
@@ -39,6 +41,16 @@ proprietary dependencies — still resolves its references for metadata inspecti
A negative-control test (`Harness_Distinguishes_Different_Outputs`) proves the
harness can actually see a difference, so a green run is never vacuous.
The project also carries two **byte-compatibility guards** — not original-vs-recovered
comparisons, but checks that the modernized protocol/crypto stays compatible with the
original binaries:
- `PodRpcProtocolTests` — round-trips the framed-JSON RPC ([`Contract/PodRpcProtocol.cs`](../../../Contract/PodRpcProtocol.cs))
in-process: every request/response shape encodes and decodes back to the same values.
- `SecureConfigCompatTests` — asserts the source-built `OFBCryptoStream` produces
byte-identical ciphertext to the original `TeslaSecureConfiguration.dll`, so the pod
provisioning handshake stays wire-compatible.
## Running
```