Repository navigation
Commit 0753a45
committed
feat(audit): A3 witness MVP — RetentionPath extracted from PR #280, minus the dominator tree
The runtime-witness half of the flagship demo, resurrected as the minimal
core rather than a rebase of the geological layer: Heap.cs (mark-from-roots
census, sampled ranked retainers with the field named at every hop,
stack/finalizer vs real retention) + Program.cs (census / roots,
--pid|--dump, --type, --sample/--max-hops limits, --out runtime.json) +
the csproj. Deliberately NOT taken: Dominators.cs (444 lines of separate
proof surface the hero demo does not need), the pre-#278/#305/#306 corpus
slice, and the old runtime-contract docs.
Adapted to the A3 contract:
- verdict vocabulary — RETAINED (a root path was established, exit 1) |
OBSERVED_ONLY (instances exist, no path established — never called a
proven leak, exit 0) | ABSENT; usage documents it;
- the JSON artifact carries verdict + collector identity (mode
attach/dump, target, runtime, OS — no timestamps: identical heaps must
yield identical artifacts);
- a failed read stays exit 2, distinct from clean(0)/retained(1);
- net8.0 cross-platform (ClrMD 3.x live-attach works on Linux and
Windows; legacy net472 heaps are dump-only from here — the PR #280
live-attach build can be resurrected the day a live legacy target
matters).
Gate A builds the project and smokes the honest-failure surface on both
platforms: bare usage exits 2 with the verdict vocabulary documented, and
a failed attach exits 2 — never a clean scan.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015de4MezSeUnZBoWq1fFU5M1 parent a9a6e86 commit 0753a45
4 files changed
Lines changed: 706 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2427 | 2427 | | |
2428 | 2428 | | |
2429 | 2429 | | |
| 2430 | + | |
| 2431 | + | |
| 2432 | + | |
| 2433 | + | |
| 2434 | + | |
| 2435 | + | |
| 2436 | + | |
| 2437 | + | |
| 2438 | + | |
| 2439 | + | |
| 2440 | + | |
| 2441 | + | |
| 2442 | + | |
| 2443 | + | |
| 2444 | + | |
| 2445 | + | |
2430 | 2446 | | |
2431 | 2447 | | |
2432 | 2448 | | |
| |||
0 commit comments