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:
+9
-9
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user