# smaug123/woofware.pawprint architecture

> Architecture diagram of the GitHub repository smaug123/woofware.pawprint, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/smaug123/woofware.pawprint
- Repository: https://github.com/smaug123/woofware.pawprint

## Overview

PawPrint is an unfinished deterministic .NET 10 runtime: a user supplies a DLL, PawPrint runs its entry point while controlling nondeterminism, and repeated seeded runs can expose concurrency bugs. The README also documents partial async, task, reflection, synchronization, and console support. The supplied tree contains test guests and harnesses but no runtime implementation files, so runtime components have null paths; arrows below reflect documented behavior, not inspected implementation calls.

Main entry points: [`WoofWare.PawPrint.Test/sourcesImpure/WriteLine.cs`](https://github.com/smaug123/woofware.pawprint/blob/main/WoofWare.PawPrint.Test/sourcesImpure/WriteLine.cs) (Program output)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Program execution"]
  node_runtime["PawPrint runtime"]
  node_entry["Entry point"]
  node_output["Program output<br/>[WriteLine.cs]"]
end

subgraph group_determinism["Deterministic execution"]
  node_scheduler["Thread scheduler"]
  node_seeds["Run seeds"]
  node_history["Execution history"]
end

subgraph group_capabilities["Runtime capabilities"]
  node_managed["Managed runtime"]
  node_bcl["BCL support"]
end

node_user(("User"))
node_dll["Input DLL"]

node_user -->|"provides"| node_dll
node_dll -->|"loads"| node_runtime
node_runtime -->|"executes"| node_entry
node_runtime -.->|"controls execution"| node_scheduler
node_user -->|"varies seeds"| node_seeds
node_seeds -.->|"configures runs"| node_runtime
node_runtime -->|"records execution"| node_history
node_entry -->|"runs managed code"| node_managed
node_entry -.->|"uses supported APIs"| node_bcl
node_entry -->|"writes console output"| node_output

click node_output "https://github.com/smaug123/woofware.pawprint/blob/main/WoofWare.PawPrint.Test/sourcesImpure/WriteLine.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runtime,node_entry,node_output,node_user toneBlue
class node_scheduler,node_seeds,node_history toneAmber
class node_managed,node_bcl toneMint
class node_dll toneIndigo
```

## Components

### Program execution

- **PawPrint runtime**
- **Entry point**
- [Program output](https://github.com/smaug123/woofware.pawprint/blob/main/WoofWare.PawPrint.Test/sourcesImpure/WriteLine.cs): `WoofWare.PawPrint.Test/sourcesImpure/WriteLine.cs`

### Deterministic execution

- **Thread scheduler**
- **Run seeds**
- **Execution history**

### Runtime capabilities

- **Managed runtime**
- **BCL support**

### Other components

- **User**
- **Input DLL**

## Connections

- User → Input DLL: provides (evidence: `README.md`)
- Input DLL → PawPrint runtime: loads (evidence: `README.md`)
- PawPrint runtime → Entry point: executes (evidence: `README.md`)
- PawPrint runtime → Thread scheduler: controls execution
- User → Run seeds: varies seeds (evidence: `README.md`)
- Run seeds → PawPrint runtime: configures runs
- PawPrint runtime → Execution history: records execution (evidence: `README.md`)
- Entry point → Managed runtime: runs managed code (evidence: `README.md`)
- Entry point → BCL support: uses supported APIs
- Entry point → Program output: writes console output (evidence: `WoofWare.PawPrint.Test/sourcesImpure/WriteLine.cs`)
