@@ -4,12 +4,17 @@ RelayX is an OPSEC-aware NTLM relay exposure assessment, lab-calibrated
44validation, and controlled execution orchestration tool for authorized red
55teaming.
66
7- This roadmap tracks the product direction without using development phase
8- labels. The guiding standard is evidence-backed relay exposure analysis:
7+ This roadmap separates implemented product capability from data-dependent
8+ calibration work, deliberately disabled live capability, and future engineering
9+ tracks. The guiding standard is evidence-backed relay exposure analysis:
910RelayX should explain what it observed, what it inferred, what remains
1011uncertain, and what an operator is allowed to do next.
1112
12- ## Current Capabilities
13+ ## Implemented In v0.1.14
14+
15+ The v0.1.14 release completes the current engineering baseline for RelayX.
16+ These capabilities are implemented, schema-covered, documented, and guarded by
17+ the quality gate.
1318
1419- Native readiness assessment for SMB, HTTP/HTTPS NTLM, LDAP/LDAPS, and MSSQL.
1520- NTLM Type1/Type2 challenge-flow evidence for HTTP, LDAP/LDAPS, and MSSQL.
@@ -25,6 +30,8 @@ uncertain, and what an operator is allowed to do next.
2530 noise, blocker, remediation, and expected telemetry metadata.
2631- Route/Pivot Awareness for source sessions, segments, subnets, structured
2732 route hops, pivot type normalization, reachability state, and route risk.
33+ - Authorized direct TCP reachability checks from the operator runtime for route
34+ reports without opening or operating pivot sessions.
2835- Relay calculus annotations for rule ID, target family, preconditions,
2936 hardening gates, decision state, and defensive controls.
3037- Lab calibration profiles and baseline comparison for controlled IIS/AD CS,
@@ -46,40 +53,42 @@ uncertain, and what an operator is allowed to do next.
4653- Evidence source taxonomy for separating wire observations, policy
4754 inferences, lab-calibration evidence, source and route models, control
4855 mappings, operator context, errors, and unsupported boundaries.
56+ - OPSEC policies for validation, execution, source planning, listener planning,
57+ callback planning, connect checks, armed mode, and confirmed mode.
58+ - Operation controls for assessment, route-check, and validation commands,
59+ including rate-limit, delay, jitter, start-after, and stop-before.
4960- Guarded validation and controlled execution state machines with dry-run,
5061 armed, and confirmed modes.
5162- Execution module inventory, module planning, and Adapter SDK dispatch,
5263 including a supported offline audit-record adapter, credential/listener
53- policy guardrails, lifecycle audit, and explicit unsupported boundaries for
54- live relay adapters.
64+ policy guardrails, lifecycle audit, lab-only fixture boundaries, and explicit
65+ unsupported boundaries for live relay adapters.
5566- Versioned schema and evidence contract validation for results, lab profiles,
5667 corpuses, lab provenance reports, lab stability reports, execution records,
5768 module manifests, OPSEC policies, route reports, bundle manifests, quality
5869 gates, OpenGraph, JSONL, and CSV.
59- - Versioned lab confidence contracts for calibration decisions and baseline
60- comparisons, including evidence sources, discriminators, promotion gates, and
61- remaining uncertainty.
6270- Enterprise exports for OpenGraph-style graph analysis, JSONL, CSV, Markdown,
6371 HTML, Mermaid, multi-scan diffing, and remediation impact simulation.
6472- Enterprise bundle generation with manifest, artifact hashes, schema
6573 validation status, and optional route report.
66- - CI and release quality gates for package metadata, fixtures, schema
67- contracts, enterprise docs, GitHub workflows, wheel builds, and install
68- smoke tests.
74+ - Quality-gate v2 contract for release automation, including package metadata,
75+ fixture determinism, schema contracts, documentation coverage, GitHub
76+ workflow coverage, wheel build expectations, and install smoke tests.
6977- Short option aliases and curated help topics for common interactive CLI
7078 workflows, with safety-sensitive guardrails preserved.
7179- Complete offline tutorial and schema-validated example result fixtures that
7280 exercise assessment review, calibration, validation planning, offline
7381 execution audit, enterprise bundle, diff, and remediation simulation
7482 workflows.
83+ - Authorized AD/IIS/AD CS/MSSQL integration-test expectations documented in
84+ ` docs/INTEGRATION_TESTS.md ` .
7585
76- ## Evidence And Calibration
77-
78- The highest priority is to keep improving judgement quality. RelayX should
79- promote a conservative finding only when a lab profile, a baseline difference,
80- or an explicit protocol diagnostic supports the promotion.
86+ ## Data-Dependent Calibration Work
8187
82- Near-term work:
88+ This work is not blocked by missing framework code. It depends on authorized
89+ lab environments and repeated real captures. The current codebase already has
90+ the corpus, provenance, stability, differential, schema, and quality-gate
91+ contracts needed to ingest this data.
8392
8493- Populate the real lab profile corpus across Windows Server, IIS, AD CS,
8594 domain controller, and SQL Server policy matrices.
@@ -95,7 +104,7 @@ Near-term work:
95104- Keep synthetic authentication rejection states subdivided without treating
96105 invalid-credential rejection as proof of relayability.
97106
98- Relevant fixtures :
107+ Relevant fixture and contract files :
99108
100109- ` fixtures/protocol_validation_matrix.json `
101110- ` fixtures/relay_calculus_matrix.json `
@@ -105,98 +114,108 @@ Relevant fixtures:
105114- ` fixtures/enterprise_output_matrix.json `
106115- ` fixtures/execution_module_matrix.json `
107116- ` fixtures/route_pivot_matrix.json `
117+ - ` fixtures/lab_corpus/*.json `
108118
109- ## OPSEC And Scope
119+ ## Next Development Tracks
110120
111- RelayX should favor controlled, auditable action over broad probing.
121+ These tracks are suitable for continued development now because they improve
122+ trust, reporting, and reviewability without enabling uncontrolled live relay
123+ execution.
124+
125+ ### Enterprise Trust
112126
113- Current capabilities:
114-
115- - Assessment, route-check, and validation commands support rate-limit,
116- delay, jitter, start-after, and stop-before operation controls.
117- - Confirmed validation reprobes fail closed outside the configured operation
118- window; dry-run planning records the same window as a warning.
119- - Route reports can optionally run authorized direct TCP reachability checks
120- from the operator runtime without opening or operating pivot sessions.
121- - OPSEC policies can require explicit scope for connect checks, listener
122- planning, callback planning, source planning, armed mode, and confirmed mode.
123- - Source plans and execution plans record listener and callback scope contracts.
124- - Active and future-active operations record expected telemetry and rollback
125- steps in JSON artifacts and audit records.
126- - Machine-readable JSON, CSV, JSONL, HTML, Markdown, Mermaid, and graph exports
127- remain banner-free and stable by default.
128-
129- Future work:
130-
131- - Add policy-profile presets for common engagement windows and rate envelopes.
132- - Extend route reachability validation with authorized pre-existing proxy/tun
133- adapters while preserving no-broad-pivot defaults.
134- - Add deeper telemetry mapping by Windows event family, IIS log surface, SQL
135- audit source, and network sensor type.
136-
137- ## Controlled Execution
138-
139- The execution core currently supports safe offline audit recording through the
140- RelayX Adapter SDK. Live relay adapters remain disabled until they pass
141- protocol design review, credential handling review, OPSEC review, and
142- authorized lab regression.
143-
144- Current capabilities:
145-
146- - Execution module manifests support lab-only fixture contracts before any live
147- module can be registered as supported; lab-only modules hard-fail in
148- confirmed mode.
149- - Adapter contracts record one-shot behavior, fail-closed timeout behavior,
150- expected telemetry, and evidence capture requirements.
151- - Confirmed execution requires explicit operator identity, reason,
152- confirmation, scope, audit log, and acceptable OPSEC noise.
153- - Source-side triggers remain separated from target relay execution; future
154- network execution modules are blocked unless source-trigger planning and
155- target execution are individually scoped and audited.
156- - The only supported built-in adapter remains ` relayx_audit_record ` , which
157- performs offline audit recording without listeners, credential handling,
158- source triggers, or network relay.
159-
160- Future work:
161-
162- - Add authorized lab regression packs for protocol-specific live adapter
163- candidates before considering registration.
164- - Add adapter-specific integration tests that prove listener lifecycle,
165- credential handling, one-shot behavior, and rollback under isolated lab
166- conditions.
167-
168- ## Enterprise Output
169-
170- RelayX should be useful to operators, defenders, and reporting teams from the
171- same result file.
172-
173- Current capabilities:
174-
175- - OpenGraph exports include a field contract version, deterministic edge IDs,
176- explicit node/edge mappings, RelayX control nodes, and path-to-control edges.
177- - HTML reports include offline filters for severity, status, protocol, source
178- capability, target family, defensive control, and free-text review.
179- - CSV and JSONL exports use stable field contracts for SIEM, blue-team, and
180- spreadsheet ingestion.
181- - Multi-scan diffing reports exposure trend, score delta, control trends,
182- remediation regressions, and remediation improvements.
183- - Remediation simulation reports control dependencies, remaining controls,
184- remaining target families, and estimated residual exposure.
185-
186- Future work:
127+ Goal: strengthen enterprise handoff integrity and downstream ingestion.
187128
188129- Add signed export manifests for organizations that need immutable evidence
189130 handoff packages.
190- - Add optional team-defined CSV/JSONL field allowlists without changing the
191- default contract.
131+ - Add ` relayx bundle verify ` or equivalent manifest verification.
132+ - Add export profiles for team-defined CSV/JSONL allowlists while preserving
133+ the default stable field contract.
134+ - Add quality-gate checks for signed bundle metadata and export profile schema.
135+
136+ ### Telemetry Catalog
137+
138+ Goal: make expected telemetry more precise without pretending lab-specific
139+ event behavior is universal.
140+
141+ - Add a telemetry catalog schema and fixtures for Windows security events,
142+ LDAP bind failures, IIS logs, AD CS Web Enrollment logs, SQL Server audit or
143+ error events, and network sensor observations.
144+ - Map validation and execution plans to expected telemetry families.
145+ - Add report and bundle sections that show expected telemetry, collection
146+ surface, rollback notes, and remaining uncertainty.
147+ - Fill exact event IDs, log fields, and product-specific differences from
148+ authorized lab captures over time.
149+
150+ ### Route Adapter SDK
151+
152+ Goal: support richer authorized reachability checks while preserving the
153+ current no-broad-pivot default.
154+
155+ - Add route adapter contracts for pre-existing proxy, tun, or SOCKS contexts.
156+ - Keep proxy/tun checks disabled or lab-only until scope, audit, OPSEC, and
157+ regression requirements are satisfied.
158+ - Record adapter identity, route scope, expected telemetry, timeout behavior,
159+ and rollback assumptions.
160+ - Keep direct TCP checks as the default operator-runtime reachability mode.
161+
162+ ### Live Capability Review Pack
163+
164+ Goal: prepare for future live modules without registering live relay
165+ capability by default.
166+
167+ - Add protocol design review checklists for future live relay adapters.
168+ - Add credential handling policy checks for capture, forwarding, storage,
169+ masking, and audit boundaries.
170+ - Add listener lifecycle fixtures for bind, accept, timeout, cleanup, and
171+ rollback behavior.
172+ - Add mock/lab-only adapters and negative tests that prove unsupported or
173+ lab-only modules cannot dispatch in confirmed mode.
174+ - Add authorized lab regression harness requirements before any live adapter
175+ can be registered as supported.
176+
177+ ## Deliberately Disabled Pending Review
178+
179+ These capabilities are intentionally not enabled in the default product. They
180+ should remain disabled until they pass protocol design review, credential
181+ handling review, OPSEC review, and authorized lab regression.
182+
183+ - Live relay adapters.
184+ - Source trigger and target relay linked execution.
185+ - Credential capture or forwarding by RelayX execution modules.
186+ - Listener-backed live relay modules.
187+ - Proxy/tun route reachability adapters outside lab-only or explicitly
188+ authorized adapter contracts.
189+
190+ Current controlled execution support remains limited to safe offline audit
191+ recording through ` relayx_audit_record ` .
192+
193+ ## OPSEC Direction
194+
195+ RelayX should favor controlled, auditable action over broad probing.
196+
197+ Current OPSEC capabilities are implemented in v0.1.14. Future OPSEC work should
198+ focus on:
199+
200+ - Policy-profile presets for common engagement windows and rate envelopes.
201+ - Deeper telemetry mapping by Windows event family, IIS log surface, SQL audit
202+ source, LDAP diagnostic surface, AD CS web logs, and network sensor type.
203+ - Richer route reachability validation through authorized, scoped adapters
204+ while preserving no-broad-pivot defaults.
205+ - Stronger rollback recording for active or future-active operations.
192206
193- ## Engineering Quality
207+ ## Engineering Quality Direction
194208
195- Near-term work:
209+ The engineering quality baseline is implemented in v0.1.14. Future quality
210+ work should focus on keeping release automation trustworthy as the project adds
211+ real lab data and future adapter contracts.
196212
197- - Keep the ` relayx quality-gate ` contract stable enough for release automation.
198- - Keep CLI short-option coverage and documentation synchronized through the
199- quality gate.
213+ - Keep the ` relayx quality-gate ` contract stable for release automation.
214+ - Keep CLI short-option coverage, generated help, README, and CLI docs
215+ synchronized through the quality gate.
200216- Keep lab fixtures deterministic and tied to expected classifications.
201- - Document integration-test expectations for authorized AD/IIS/AD CS/MSSQL
217+ - Keep integration-test expectations current for authorized AD/IIS/AD CS/MSSQL
202218 labs.
219+ - Add quality-gate checks for signed bundle verification, telemetry catalog
220+ fixtures, route adapter contracts, and future live-capability review packs as
221+ those tracks are implemented.
0 commit comments