Skip to content

docs(audit): sync Mermaid diagrams with v0.4.0 components#21

Merged
SchwartzKamel merged 1 commit into
mainfrom
docs/audit-2026-05-mermaid-drift
May 3, 2026
Merged

docs(audit): sync Mermaid diagrams with v0.4.0 components#21
SchwartzKamel merged 1 commit into
mainfrom
docs/audit-2026-05-mermaid-drift

Conversation

@SchwartzKamel

Copy link
Copy Markdown
Owner

Pass 4 of the docs audit: walk every ```mermaid block and reconcile against v0.4.0 reality (src/Drederick/ tree, AGENTS.md file→concept map).

Diagrams reviewed

Diagram File:line Drift?
Short architecture README.md:409 None — already lists HybridAgentRunner.
Layered subsystems docs/ARCHITECTURE.md:74 Updated — Runner node was missing 3 runners.
Post-ex data flow docs/POST_EXPLOITATION.md:151 Updated — LLM node missing 2 tools.
UI architecture docs/UI.md:147 None — UI→Host→Scanners still accurate.
Findings ER diagram docs/DATASETTE.md:274 None — schema matches SqliteReport.cs.

ARCHITECTURE.md — Runner node

Before: AdaptiveRunner (deterministic) + MicrosoftAgentRunner (LLM) only.
After: adds CopilotSdkAgentRunner (Copilot LLM provider), HybridAgentRunner (LLM-first with fallback, wired via --agent=hybrid), and AutopilotRunner (the recon→exploit→loot loop).

All four runners exist in the tree today (src/Drederick/Agent/{HybridAgentRunner,CopilotSdkAgentRunner}.cs, src/Drederick/Autopilot/AutopilotRunner.cs) and are documented in the AGENTS.md file→concept map.

POST_EXPLOITATION.md — LLM node

Before: LlmExploitTools only.
After: also lists LlmExecShellTool (src/Drederick/Exploit/LlmExecShellTool.cs) and LlmNotebookTool (src/Drederick/Agent/LlmNotebookTool.cs, the take_note tool wired in v0.4.0). Both are LLM-callable surfaces the planner uses during post-ex.

Verified-current (no edits)

  • FightNotebook / FightCorpus / Scaffolding / MalleableProfileLibrary / KbSubstitutionResolver are already represented in the ARCHITECTURE.md diagram (Present node, Exploit node, Empire C2 group).
  • JeopardySwarm lives in a parallel pipeline that's described in adjacent prose + docs/JEOPARDY.md; no separate node added (out of scope for the main offensive-harness diagram).

Minimal-diff updates only — no aesthetic redesign, no unrelated prose churn.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

@SchwartzKamel SchwartzKamel merged commit d54df3b into main May 3, 2026
2 of 3 checks passed
@SchwartzKamel SchwartzKamel deleted the docs/audit-2026-05-mermaid-drift branch May 3, 2026 01:52
ARCHITECTURE.md (layered subsystem diagram):
- Runner node now lists CopilotSdkAgentRunner, HybridAgentRunner, and
  AutopilotRunner alongside AdaptiveRunner / MicrosoftAgentRunner so the
  diagram matches src/Drederick/Agent/ + src/Drederick/Autopilot/ today.

POST_EXPLOITATION.md (post-ex data flow):
- LLM node now includes LlmExecShellTool and LlmNotebookTool in addition
  to LlmExploitTools, reflecting src/Drederick/Exploit/LlmExecShellTool.cs
  and src/Drederick/Agent/LlmNotebookTool.cs.

Other diagrams reviewed and current:
- README.md short architecture diagram (already mentions HybridAgentRunner).
- docs/UI.md (UI→Host→Scanners — structurally accurate).
- docs/DATASETTE.md (ER diagram — schema accurate).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant