# djd1m/dz-harness architecture

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

- Interactive diagram: https://gitdiagram.com/djd1m/dz-harness
- Repository: https://github.com/djd1m/dz-harness

## Overview

This repository is a read-only public mirror of 56 published npm packages, not one integrated application. Its clearest end-to-end workflow is the harness MCP server exposing skill and preset operations, including compiling or verifying skills for agent platforms. Other substantial product branches include clinical evidence appraisal, multi-source scouting, and persistent memory. The README establishes the packages’ published scope; connections below are limited to relationships shown in excerpts or the source index, so many package-to-package links are intentionally omitted.

Main entry points: [`packages/mcp-server-tools/src/server.ts`](https://github.com/djd1m/dz-harness/blob/main/packages/mcp-server-tools/src/server.ts) (MCP server), [`packages/health-advisor/lib/appraisal-core.js`](https://github.com/djd1m/dz-harness/blob/main/packages/health-advisor/lib/appraisal-core.js) (Appraisal rules), [`packages/memory/src/sqlite-backend.ts`](https://github.com/djd1m/dz-harness/blob/main/packages/memory/src/sqlite-backend.ts) (SQLite backend), [`packages/health-advisor/lib/appraisal-checks/06-enrollment-actuality.js`](https://github.com/djd1m/dz-harness/blob/main/packages/health-advisor/lib/appraisal-checks/06-enrollment-actuality.js) (Enrollment check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_harness["Harness tools"]
  node_server["MCP server<br/>[server.ts]"]
  node_skills["Skill operations<br/>[skills.ts]"]
  node_presets["Harness presets<br/>[presets.ts]"]
  node_harnesscore["Harness core"]
end

subgraph group_adapters["Agent adapters"]
  node_claude["Claude adapter<br/>[compile.ts]"]
  node_cursor["Cursor adapter<br/>[index.ts]"]
  node_copilot["Copilot adapter<br/>[index.ts]"]
  node_windsurf["Windsurf adapter<br/>[index.ts]"]
  node_agentsmd["Agents MD adapter<br/>[index.ts]"]
end

subgraph group_health["Clinical evidence"]
  node_healthrun["Appraisal runner<br/>[appraisal-run.js]"]
  node_appraisal["Appraisal rules<br/>[appraisal-core.js]"]
  node_enrollment["Enrollment check"]
  node_registrytiming["Registry timing"]
end

subgraph group_scout["Discovery"]
  node_sources["Source aggregator<br/>[index.ts]"]
  node_sourcewatermark[("Source watermark")]
end

subgraph group_memory["Memory"]
  node_memorybackend["Memory backend API<br/>[backend.ts]"]
  node_sqlite[("SQLite backend<br/>[sqlite-backend.ts]")]
  node_tokenizer["Query tokenizer<br/>[tokenize.ts]"]
end

node_user(("MCP client"))

node_user -->|"requests tools"| node_server
node_server -->|"lists and loads"| node_skills
node_server -->|"lists presets"| node_presets
node_server -->|"checks gating"| node_harnesscore
node_server -->|"compiles or verifies"| node_claude
node_server -->|"compiles or verifies"| node_cursor
node_server -->|"compiles or verifies"| node_copilot
node_server -->|"compiles or verifies"| node_windsurf
node_server -->|"selects adapter"| node_agentsmd
node_appraisal -->|"references runner"| node_healthrun
node_appraisal -->|"references timing"| node_registrytiming
node_enrollment -->|"uses finding helpers"| node_appraisal
node_sources -.->|"related source state"| node_sourcewatermark
node_sqlite -->|"tokenizes queries"| node_tokenizer
node_sqlite -->|"implements backend"| node_memorybackend

click node_server "https://github.com/djd1m/dz-harness/blob/main/packages/mcp-server-tools/src/server.ts"
click node_skills "https://github.com/djd1m/dz-harness/blob/main/packages/mcp-server-tools/src/skills.ts"
click node_presets "https://github.com/djd1m/dz-harness/blob/main/packages/harness-presets/src/presets.ts"
click node_harnesscore "https://github.com/djd1m/dz-harness/blob/main/packages/harness-core/src/feature-adr-routing.ts"
click node_claude "https://github.com/djd1m/dz-harness/blob/main/packages/adapter-claude/src/compile.ts"
click node_cursor "https://github.com/djd1m/dz-harness/blob/main/packages/adapter-cursor/src/index.ts"
click node_copilot "https://github.com/djd1m/dz-harness/blob/main/packages/adapter-copilot/src/index.ts"
click node_windsurf "https://github.com/djd1m/dz-harness/blob/main/packages/adapter-windsurf/src/index.ts"
click node_agentsmd "https://github.com/djd1m/dz-harness/blob/main/packages/adapter-agents-md/src/index.ts"
click node_healthrun "https://github.com/djd1m/dz-harness/blob/main/packages/health-advisor/lib/appraisal-run.js"
click node_appraisal "https://github.com/djd1m/dz-harness/blob/main/packages/health-advisor/lib/appraisal-core.js"
click node_enrollment "https://github.com/djd1m/dz-harness/blob/main/packages/health-advisor/lib/appraisal-checks/06-enrollment-actuality.js"
click node_registrytiming "https://github.com/djd1m/dz-harness/blob/main/packages/health-advisor/lib/registry-edit-timing.js"
click node_sources "https://github.com/djd1m/dz-harness/blob/main/packages/scout/src/sources/index.ts"
click node_sourcewatermark "https://github.com/djd1m/dz-harness/blob/main/packages/scout/src/source-watermark.ts"
click node_memorybackend "https://github.com/djd1m/dz-harness/blob/main/packages/memory/src/backend.ts"
click node_sqlite "https://github.com/djd1m/dz-harness/blob/main/packages/memory/src/sqlite-backend.ts"
click node_tokenizer "https://github.com/djd1m/dz-harness/blob/main/packages/memory/src/tokenize.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_server,node_skills,node_presets,node_harnesscore,node_user toneBlue
class node_claude,node_cursor,node_copilot,node_windsurf,node_agentsmd toneAmber
class node_healthrun,node_appraisal,node_enrollment,node_registrytiming toneMint
class node_sources,node_sourcewatermark toneRose
class node_memorybackend,node_sqlite,node_tokenizer toneIndigo
```

## Components

### Harness tools

- [MCP server](https://github.com/djd1m/dz-harness/blob/main/packages/mcp-server-tools/src/server.ts): `packages/mcp-server-tools/src/server.ts`
- [Skill operations](https://github.com/djd1m/dz-harness/blob/main/packages/mcp-server-tools/src/skills.ts): `packages/mcp-server-tools/src/skills.ts`
- [Harness presets](https://github.com/djd1m/dz-harness/blob/main/packages/harness-presets/src/presets.ts): `packages/harness-presets/src/presets.ts`
- [Harness core](https://github.com/djd1m/dz-harness/blob/main/packages/harness-core/src/feature-adr-routing.ts): `packages/harness-core/src/feature-adr-routing.ts`

### Agent adapters

- [Claude adapter](https://github.com/djd1m/dz-harness/blob/main/packages/adapter-claude/src/compile.ts): `packages/adapter-claude/src/compile.ts`
- [Cursor adapter](https://github.com/djd1m/dz-harness/blob/main/packages/adapter-cursor/src/index.ts): `packages/adapter-cursor/src/index.ts`
- [Copilot adapter](https://github.com/djd1m/dz-harness/blob/main/packages/adapter-copilot/src/index.ts): `packages/adapter-copilot/src/index.ts`
- [Windsurf adapter](https://github.com/djd1m/dz-harness/blob/main/packages/adapter-windsurf/src/index.ts): `packages/adapter-windsurf/src/index.ts`
- [Agents MD adapter](https://github.com/djd1m/dz-harness/blob/main/packages/adapter-agents-md/src/index.ts): `packages/adapter-agents-md/src/index.ts`

### Clinical evidence

- [Appraisal runner](https://github.com/djd1m/dz-harness/blob/main/packages/health-advisor/lib/appraisal-run.js): `packages/health-advisor/lib/appraisal-run.js`
- [Appraisal rules](https://github.com/djd1m/dz-harness/blob/main/packages/health-advisor/lib/appraisal-core.js): `packages/health-advisor/lib/appraisal-core.js`
- [Enrollment check](https://github.com/djd1m/dz-harness/blob/main/packages/health-advisor/lib/appraisal-checks/06-enrollment-actuality.js): `packages/health-advisor/lib/appraisal-checks/06-enrollment-actuality.js`
- [Registry timing](https://github.com/djd1m/dz-harness/blob/main/packages/health-advisor/lib/registry-edit-timing.js): `packages/health-advisor/lib/registry-edit-timing.js`

### Discovery

- [Source aggregator](https://github.com/djd1m/dz-harness/blob/main/packages/scout/src/sources/index.ts): `packages/scout/src/sources/index.ts`
- [Source watermark](https://github.com/djd1m/dz-harness/blob/main/packages/scout/src/source-watermark.ts): `packages/scout/src/source-watermark.ts`

### Memory

- [Memory backend API](https://github.com/djd1m/dz-harness/blob/main/packages/memory/src/backend.ts): `packages/memory/src/backend.ts`
- [SQLite backend](https://github.com/djd1m/dz-harness/blob/main/packages/memory/src/sqlite-backend.ts): `packages/memory/src/sqlite-backend.ts`
- [Query tokenizer](https://github.com/djd1m/dz-harness/blob/main/packages/memory/src/tokenize.ts): `packages/memory/src/tokenize.ts`

### Other components

- **MCP client**

## Connections

- MCP client → MCP server: requests tools (evidence: `packages/mcp-server-tools/src/server.ts`)
- MCP server → Skill operations: lists and loads (evidence: `packages/mcp-server-tools/src/server.ts`)
- MCP server → Harness presets: lists presets (evidence: `packages/mcp-server-tools/src/server.ts`)
- MCP server → Harness core: checks gating (evidence: `packages/mcp-server-tools/src/server.ts`)
- MCP server → Claude adapter: compiles or verifies (evidence: `packages/mcp-server-tools/src/server.ts`)
- MCP server → Cursor adapter: compiles or verifies (evidence: `packages/mcp-server-tools/src/server.ts`)
- MCP server → Copilot adapter: compiles or verifies (evidence: `packages/mcp-server-tools/src/server.ts`)
- MCP server → Windsurf adapter: compiles or verifies (evidence: `packages/mcp-server-tools/src/server.ts`)
- MCP server → Agents MD adapter: selects adapter (evidence: `packages/mcp-server-tools/src/server.ts`)
- Appraisal rules → Appraisal runner: references runner (evidence: `packages/health-advisor/lib/appraisal-core.js`)
- Appraisal rules → Registry timing: references timing (evidence: `packages/health-advisor/lib/appraisal-core.js`)
- Enrollment check → Appraisal rules: uses finding helpers (evidence: `packages/health-advisor/lib/appraisal-checks/06-enrollment-actuality.js`)
- Source aggregator → Source watermark: related source state (evidence: `packages/scout/src/source-watermark.ts`)
- SQLite backend → Query tokenizer: tokenizes queries (evidence: `packages/memory/src/sqlite-backend.ts`)
- SQLite backend → Memory backend API: implements backend (evidence: `packages/memory/src/sqlite-backend.ts`)
