# saramaebee/reducer architecture

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

- Interactive diagram: https://gitdiagram.com/saramaebee/reducer
- Repository: https://github.com/saramaebee/reducer

## Overview

This is a closed Node.js dependency-research monorepo, not an actively approved product build. Its preserved workflows are conservative analysis/build and dependency-placement research: analyze an application’s dependency universe, then either report conservative reachability or plan HOT/COLD placement while keeping omitted files recoverable. The graph includes shared tracing, universe discovery, hazard analysis, and the frozen linker components. Edges reflect README statements or shown calls/import references; unsampled planner internals and runtime recovery behavior are not inferred.

Main entry points: [`packages/hazard-domain/src/index.ts`](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/index.ts) (Hazard orchestrator), [`packages/working-set-planner/src/index.ts`](https://github.com/saramaebee/reducer/blob/main/packages/working-set-planner/src/index.ts) (HOT/COLD planner), [`packages/cli/src/build.ts`](https://github.com/saramaebee/reducer/blob/main/packages/cli/src/build.ts) (Artifact builder), [`packages/hazard-domain/src/facts.ts`](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/facts.ts) (Module facts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shared["Shared analysis"]
  node_manifest["Manifest schema<br/>[index.ts]"]
  node_tracer["NFT tracing<br/>[index.ts]"]
  node_universe["Production universe<br/>[index.ts]"]
end

subgraph group_hazard["Hazard analysis"]
  node_hazard["Hazard orchestrator<br/>[index.ts]"]
  node_facts["Module facts<br/>[facts.ts]"]
  node_capability["Capability flow<br/>[capability.ts]"]
  node_specifier["Specifier domains<br/>[specifier.ts]"]
  node_resolution["Target resolution<br/>[resolve.ts]"]
  node_fixpoint["Reachability fixpoint<br/>[fixpoint.ts]"]
  node_projection["Export projection<br/>[projection.ts]"]
  node_byteprediction["Byte prediction<br/>[bytes.ts]"]
  node_report["Analysis report<br/>[report.ts]"]
end

subgraph group_linker["Conservative linker"]
  node_cli["Pipeline CLI<br/>[index.ts]"]
  node_build["Artifact builder<br/>[build.ts]"]
  node_analyzer["Reachability analyzer<br/>[index.ts]"]
  node_transformer["Function stubbing<br/>[index.ts]"]
end

subgraph group_placement["Placement research"]
  node_planner["HOT/COLD planner<br/>[index.ts]"]
  node_storage[("Immutable artifact store")]
end

node_researcher(("Engineer"))
node_nodeapp["Node application"]

node_researcher -->|"runs analysis/build"| node_cli
node_cli -->|"dispatches build"| node_build
node_build -->|"requests analysis"| node_analyzer
node_build -->|"stubs functions"| node_transformer
node_build -->|"writes manifest"| node_manifest
node_analyzer -->|"uses trace"| node_tracer
node_hazard -->|"traces evidence"| node_tracer
node_hazard -->|"builds universe"| node_universe
node_hazard -->|"parses facts"| node_facts
node_facts -->|"tracks usage"| node_capability
node_capability -->|"evaluates domains"| node_specifier
node_facts -->|"resolves edges"| node_resolution
node_hazard -->|"runs fixpoint"| node_fixpoint
node_fixpoint -->|"resolves sinks"| node_resolution
node_hazard -->|"projects usage"| node_projection
node_projection -->|"widens edges"| node_resolution
node_hazard -->|"predicts bytes"| node_byteprediction
node_byteprediction -->|"models stubbing"| node_transformer
node_hazard -->|"assembles report"| node_report
node_researcher -->|"runs placement study"| node_planner
node_planner -->|"uses file universe"| node_universe
node_planner -.->|"uses positive evidence"| node_tracer
node_planner -.->|"places omitted files recoverably"| node_storage
node_nodeapp -.->|"supplies entrypoint"| node_cli
node_nodeapp -.->|"supplies dependency set"| node_planner

click node_cli "https://github.com/saramaebee/reducer/blob/main/packages/cli/src/index.ts"
click node_build "https://github.com/saramaebee/reducer/blob/main/packages/cli/src/build.ts"
click node_analyzer "https://github.com/saramaebee/reducer/blob/main/packages/conservative-analyzer/src/index.ts"
click node_transformer "https://github.com/saramaebee/reducer/blob/main/packages/conservative-transformer/src/index.ts"
click node_manifest "https://github.com/saramaebee/reducer/blob/main/packages/manifest/src/index.ts"
click node_tracer "https://github.com/saramaebee/reducer/blob/main/packages/tracer/src/index.ts"
click node_universe "https://github.com/saramaebee/reducer/blob/main/packages/production-universe/src/index.ts"
click node_hazard "https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/index.ts"
click node_facts "https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/facts.ts"
click node_capability "https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/capability.ts"
click node_specifier "https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/specifier.ts"
click node_resolution "https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/resolve.ts"
click node_fixpoint "https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/fixpoint.ts"
click node_projection "https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/projection.ts"
click node_byteprediction "https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/bytes.ts"
click node_report "https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/report.ts"
click node_planner "https://github.com/saramaebee/reducer/blob/main/packages/working-set-planner/src/index.ts"

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_manifest,node_tracer,node_universe toneBlue
class node_hazard,node_facts,node_capability,node_specifier,node_resolution,node_fixpoint,node_projection,node_byteprediction,node_report toneAmber
class node_cli,node_build,node_analyzer,node_transformer toneMint
class node_planner,node_storage toneRose
class node_researcher,node_nodeapp toneIndigo
```

## Components

### Shared analysis

- [Manifest schema](https://github.com/saramaebee/reducer/blob/main/packages/manifest/src/index.ts): `packages/manifest/src/index.ts`
- [NFT tracing](https://github.com/saramaebee/reducer/blob/main/packages/tracer/src/index.ts): `packages/tracer/src/index.ts`
- [Production universe](https://github.com/saramaebee/reducer/blob/main/packages/production-universe/src/index.ts): `packages/production-universe/src/index.ts`

### Hazard analysis

- [Hazard orchestrator](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/index.ts): `packages/hazard-domain/src/index.ts`
- [Module facts](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/facts.ts): `packages/hazard-domain/src/facts.ts`
- [Capability flow](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/capability.ts): `packages/hazard-domain/src/capability.ts`
- [Specifier domains](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/specifier.ts): `packages/hazard-domain/src/specifier.ts`
- [Target resolution](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/resolve.ts): `packages/hazard-domain/src/resolve.ts`
- [Reachability fixpoint](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/fixpoint.ts): `packages/hazard-domain/src/fixpoint.ts`
- [Export projection](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/projection.ts): `packages/hazard-domain/src/projection.ts`
- [Byte prediction](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/bytes.ts): `packages/hazard-domain/src/bytes.ts`
- [Analysis report](https://github.com/saramaebee/reducer/blob/main/packages/hazard-domain/src/report.ts): `packages/hazard-domain/src/report.ts`

### Conservative linker

- [Pipeline CLI](https://github.com/saramaebee/reducer/blob/main/packages/cli/src/index.ts): `packages/cli/src/index.ts`
- [Artifact builder](https://github.com/saramaebee/reducer/blob/main/packages/cli/src/build.ts): `packages/cli/src/build.ts`
- [Reachability analyzer](https://github.com/saramaebee/reducer/blob/main/packages/conservative-analyzer/src/index.ts): `packages/conservative-analyzer/src/index.ts`
- [Function stubbing](https://github.com/saramaebee/reducer/blob/main/packages/conservative-transformer/src/index.ts): `packages/conservative-transformer/src/index.ts`

### Placement research

- [HOT/COLD planner](https://github.com/saramaebee/reducer/blob/main/packages/working-set-planner/src/index.ts): `packages/working-set-planner/src/index.ts`
- **Immutable artifact store**

### Other components

- **Engineer**
- **Node application**

## Connections

- Engineer → Pipeline CLI: runs analysis/build (evidence: `README.md`)
- Pipeline CLI → Artifact builder: dispatches build (evidence: `packages/cli/src/index.ts`)
- Artifact builder → Reachability analyzer: requests analysis (evidence: `packages/cli/src/build.ts`)
- Artifact builder → Function stubbing: stubs functions (evidence: `packages/cli/src/build.ts`)
- Artifact builder → Manifest schema: writes manifest (evidence: `packages/cli/src/build.ts`)
- Reachability analyzer → NFT tracing: uses trace (evidence: `packages/conservative-analyzer/src/index.ts`)
- Hazard orchestrator → NFT tracing: traces evidence (evidence: `packages/hazard-domain/src/index.ts`)
- Hazard orchestrator → Production universe: builds universe (evidence: `packages/hazard-domain/src/index.ts`)
- Hazard orchestrator → Module facts: parses facts (evidence: `packages/hazard-domain/src/index.ts`)
- Module facts → Capability flow: tracks usage (evidence: `packages/hazard-domain/src/facts.ts`)
- Capability flow → Specifier domains: evaluates domains (evidence: `packages/hazard-domain/src/capability.ts`)
- Module facts → Target resolution: resolves edges (evidence: `packages/hazard-domain/src/facts.ts`)
- Hazard orchestrator → Reachability fixpoint: runs fixpoint (evidence: `packages/hazard-domain/src/index.ts`)
- Reachability fixpoint → Target resolution: resolves sinks (evidence: `packages/hazard-domain/src/fixpoint.ts`)
- Hazard orchestrator → Export projection: projects usage (evidence: `packages/hazard-domain/src/index.ts`)
- Export projection → Target resolution: widens edges (evidence: `packages/hazard-domain/src/projection.ts`)
- Hazard orchestrator → Byte prediction: predicts bytes (evidence: `packages/hazard-domain/src/index.ts`)
- Byte prediction → Function stubbing: models stubbing (evidence: `packages/hazard-domain/src/bytes.ts`)
- Hazard orchestrator → Analysis report: assembles report (evidence: `packages/hazard-domain/src/index.ts`)
- Engineer → HOT/COLD planner: runs placement study (evidence: `README.md`)
- HOT/COLD planner → Production universe: uses file universe (evidence: `packages/working-set-planner/src/index.ts`)
- HOT/COLD planner → NFT tracing: uses positive evidence (evidence: `README.md`)
- HOT/COLD planner → Immutable artifact store: places omitted files recoverably (evidence: `README.md`)
- Node application → Pipeline CLI: supplies entrypoint (evidence: `README.md`)
- Node application → HOT/COLD planner: supplies dependency set (evidence: `README.md`)
