Pure rule engine over already-parsed Windows registry/event-log records: cited observations for known physical-access compromise patterns, no verdicts
| Tier | infrastructure |
| Role | unclassified (baselined) |
| Path | crates/infrastructure/host-forensics |
| Edition | 2021 |
| Targets | infrastructure_host_forensics |
| Public items | 10 across 0 modules |
| Tests | 11 |
What it is for
Pure rule engine over already-parsed Windows registry/event-log records.
Each rule takes records produced by some other parser (out of scope here — see the crate README) and emits Observations: a fact plus the exact source citation, never a verdict. Interpretation ("is this malicious") happens outside the crate, by a human or an AI reading the citations — see docs/reference/STYLE.md in the workspace root for why that split is enforced.
Capabilities
crate root
Pure rule engine over already-parsed Windows registry/event-log records.
| Item |
|---|
fn ifeo_debugger_present(records : & RegistryRecord) -> Vec <Observation> |
fn credential_enrollment(records : & RegistryRecord) -> Vec <Observation> |
fn usbstor_history(records : & RegistryRecord) -> Vec <Observation> |
fn logon_events(events : & LogonEventRecord) -> Vec <Observation> |
ArtifactKind
Pure rule engine over already-parsed Windows registry/event-log records.
| Item |
|---|
pub enum ArtifactKind |
LogonEventRecord
Pure rule engine over already-parsed Windows registry/event-log records.
| Item |
|---|
pub struct LogonEventRecord |
Observation
Pure rule engine over already-parsed Windows registry/event-log records.
| Item |
|---|
pub struct Observation |
RegValue
Pure rule engine over already-parsed Windows registry/event-log records.
| Item |
|---|
pub enum RegValue |
RegValue :: fn fmt(& self, f : & mut std::fmt::Formatter <'_>) -> std::fmt::Result |
RegistryRecord
Pure rule engine over already-parsed Windows registry/event-log records.
| Item |
|---|
pub struct RegistryRecord |
How to use it
No examples/ target and no doctest in this crate's rustdoc. The tests listed under Verification are the closest executable usage.
Module structure
No public modules: the crate root is its whole surface.
Public surface
`crate root`
| Item | What it is |
|---|---|
pub enum RegValue | A single registry value as read from a hive, independent of which parser produced it. |
RegValue :: fn fmt(& self, f : & mut std::fmt::Formatter <'_>) -> std::fmt::Result | — |
pub struct RegistryRecord | One registry key/value pair, as read from a hive by any adapter. |
pub struct LogonEventRecord | One Windows event-log record relevant to logon activity. |
pub enum ArtifactKind | Which artifact family an Observation was drawn from. |
pub struct Observation | A fact plus its exact source citation |
fn ifeo_debugger_present(records : & RegistryRecord) -> Vec <Observation> | AC 1: an IFEO Debugger value set on an accessibility binary — the sticky-keys-class undocumented access path (works via IFEO hijack, not only the binary-swap variant). |
fn credential_enrollment(records : & RegistryRecord) -> Vec <Observation> | AC 2: enrolled alternate sign-in credentials (NGC PIN, Windows Hello biometrics, PassportForWork) — a way to sign in without ever knowing the account's password. |
fn usbstor_history(records : & RegistryRecord) -> Vec <Observation> | AC 3: USB storage device history — corroborates physical access. |
fn logon_events(events : & LogonEventRecord) -> Vec <Observation> | AC 4: logon events (4624 success / 4625 failure), classified by logon type |
No pub use re-exports: every item above is declared in this crate.
Boundary
Depends on no other workspace tier.
Shares tier infrastructure with 82 other crates: infrastructure-acquire, infrastructure-adapters-google-calendar, infrastructure-adapters-google-gmail, infrastructure-adapters-google-places, infrastructure-adapters-google-trends, infrastructure-adapters-shodan, infrastructure-adapters-yelp, infrastructure-agent, … (82 total).
_What this crate deliberately does NOT own is a judgment. No committed registry records one for it, so none is stated here._
Where it sits
| Tier (ontology) | infrastructure |
| Architectural role (taxonomy) | unclassified (baselined) |
| Location | crates/infrastructure/host-forensics |
| Vocabulary in force (lexicon) | current |
Dependencies
Runtime, from outside the workspace.
| Crate | Requirement | Features | Optional | Only on |
|---|---|---|---|---|
serde | ^1 | derive | no | always |
Development, from outside the workspace.
| Crate | Requirement | Features | Optional | Only on |
|---|---|---|---|---|
serde_json | ^1 | — | no | always |
Build. None.
Depended on by. 9 workspace crates.
Signal flow — what reaches this crate, and what it reaches.
flowchart LR n_infrastructure_bitlocker_forensics["infrastructure-bitlocker-forensics"] -->|uses| SELF n_infrastructure_firmware_forensics["infrastructure-firmware-forensics"] -->|uses| SELF n_infrastructure_hardware_forensics["infrastructure-hardware-forensics"] -->|uses| SELF n_infrastructure_memory_forensics["infrastructure-memory-forensics"] -->|uses| SELF n_infrastructure_registry_forensics["infrastructure-registry-forensics"] -->|uses| SELF n_infrastructure_write_blocker["infrastructure-write-blocker"] -->|uses| SELF n_operations_net_scan["operations-net-scan"] -->|uses| SELF n_operations_net_trace["operations-net-trace"] -->|uses| SELF n_tools_ir_triage["tools-ir-triage"] -->|uses| SELF SELF["infrastructure-host-forensics"] classDef self fill:#1f883d,stroke:#1f883d,color:#fff; class SELF self;
Feature flags
No Cargo features are defined: every capability is unconditional, so no consumer can receive a half-wired crate.
Targets
| Kind | Name | Source |
|---|---|---|
| lib | infrastructure_host_forensics | `src/lib.rs` |
Error model
No public error type was detected: no public item declares a type named *Error, and no public signature returns one.
Operational characteristics
| Property | Evidence |
|---|---|
| async public surface | none detected |
| async runtime | none detected |
| database access | none detected |
| network I/O | none detected |
| unsafe code | none detected |
| environment variables | none detected |
No unsafe block, unsafe fn, unsafe impl or unsafe trait was found by the parser anywhere in this crate's source.
Configuration
No environment variable is read with a literal name anywhere in this crate. A variable whose key is computed at run time cannot be listed here, and is not claimed to be absent.
Related capabilities
9 workspace crates depend on this one: infrastructure-bitlocker-forensics, infrastructure-firmware-forensics, infrastructure-hardware-forensics, infrastructure-memory-forensics, infrastructure-registry-forensics, infrastructure-write-blocker, operations-net-scan, operations-net-trace, tools-ir-triage.
Verification
| Kind | Count |
|---|---|
| Unit tests | 11 |
| Integration tests | 0 |
| Examples | 0 |
| Doctests | 0 |
Evidence by module. How often each public module is named by something executable.
| Module | Tests | Examples | Consumers |
|---|---|---|---|
crate root | 9 | 0 | 27 |
What the tests establish, by name:
credential_enrollment_ignores_unrelated_keys—src/lib.rscredential_enrollment_matches_ngc_winbio_and_passportforwork—src/lib.rsifeo_debugger_present_ignores_non_debugger_values_on_accessibility_binaries—src/lib.rsifeo_debugger_present_ignores_unrelated_ifeo_entries—src/lib.rsifeo_debugger_present_matches_sethc—src/lib.rslogon_events_ignores_unrelated_event_ids—src/lib.rslogon_events_includes_failed_logons—src/lib.rslogon_events_surfaces_both_interactive_and_rdp—src/lib.rsobservation_round_trips_through_json—src/lib.rsusbstor_history_ignores_unrelated_enum_entries—src/lib.rsusbstor_history_matches_case_insensitively—src/lib.rs
Documentation coverage
| Measure | Documented | Total |
|---|---|---|
| Public items with rustdoc | 9 | 10 |
Public modules with a //! block | 0 | 0 |
pie showData
title Public items with rustdoc
"Documented" : 9
"No rustdoc detected" : 1
Metrics
| Metric | Value |
|---|---|
| Rust source files | 1 |
| Source lines | 326 |
| Code lines | 275 |
| Public API items | 10 |
| Public modules | 0 |
| Tests | 11 |
| Examples | 0 |
| Cargo features | 0 |
| Direct runtime dependencies | 1 |
| Workspace reverse dependencies | 9 |
pie showData
title Public API by kind
"enum" : 2
"function" : 4
"method" : 1
"struct" : 3
pie showData
title Rust source composition
"Code" : 275
"Blank or comment" : 51
Generation
Rendered by tools-corpus corpus readme from repository evidence alone, renderer schema 2, lexicon current. No model, network service or database was consulted. Regenerate with tools-corpus corpus readme --write; verify with --check.