# UHBS — full agent digest (llms-full.txt)

> Curated plain-text digest of UHBS v4.2.2 for answer engines and coding agents. Prefer the live docs and GitHub sources when they disagree with this file. Last aligned: 2026-07-27.

## What UHBS is

UHBS (Universal Honeypot Benchmarking Standard) is a **personal open-source beta evaluation framework** for comparing honeypots and deception systems by **decoy class** and **protocol**, not by vendor brand. Version **4.2.2**. License **Apache-2.0**. Author/maintainer: Moran Zavdi (@mziqudhd92).

It is **not** a consortium standard, not multi-party governed, and not a mandatory industry requirement. Suggested Production Baseline Profile (RECOMMENDED for internal use): **UHQS > 80** with Module D Safety Gate pass (containment C ≥ 95 → δ_C = 1.0).

Primary URLs:
- Landing: https://mziqudhd92.github.io/uhbs-standard/
- MkDocs: https://mziqudhd92.github.io/uhbs-standard/mkdocs/
- Repo: https://github.com/mziqudhd92/uhbs-standard
- Spec status: https://mziqudhd92.github.io/uhbs-standard/mkdocs/specification/status/
- MCP for AI hosts: https://mziqudhd92.github.io/uhbs-standard/mkdocs/tooling/mcp/

## Normative UHQS formula

UHQS = δ_C · (w_A·S_A + w_B·S_B + w_C·S_C + w_E·S_E + w_F·S_F)

- S_A…S_F: module scores 0–100 (A protocol, B behavior, C telemetry, D containment, E scale, F static)
- Weights w_* depend on profile class and sum to 1.00
- δ_C = 1.0 if C ≥ 95; else δ_C = (C/100)²
- UHQS rounded to **two** decimal places
- Letter grades: A≥90, B≥80, C≥70, D≥50, F<50

Single source of scoring math in package: `uhbs_core.uhqs_math` (CLI, MCP, and harness must agree).

## Profile classes (weights)

| Class | w_A | w_B | w_C | w_E | w_F |
| --- | --- | --- | --- | --- | --- |
| POSIX-Shell / GenAI-Shell | 0.20 | 0.25 | 0.20 | 0.15 | 0.20 |
| Low-Interaction | 0.30 | 0.15 | 0.25 | 0.10 | 0.20 |
| ICS-SCADA | 0.35 | 0.20 | 0.15 | 0.10 | 0.20 |
| Web-API | 0.25 | 0.20 | 0.20 | 0.15 | 0.20 |
| Database | 0.25 | 0.25 | 0.20 | 0.10 | 0.20 |

## Conformance levels

- **UHBS-Core:** valid TPS + scorecard schemas; recomputed UHQS/δ_C/grade integrity
- **UHBS-Lab:** UHBS-Core + Modules A–F harness (`uhbs[lab]` / `uhbs-lab`) + MANIFEST digests
- **UHBS-MCP:** optional stdio MCP server (`uhbs[mcp]` / `uhbs-mcp`) wrapping Core validators — no live lab exec

## Install & commands

```bash
pip install -e ".[lab,mcp]"
uhbs validate-profile templates/profile.yaml
uhbs validate-scorecard path/to/scorecard.json --strict
uhbs score --class Low-Interaction --scores scores.json
uhbs lab --list-protocols
# AI hosts (Cursor/Claude/VS Code): configure mcpServers → python -m uhbs_mcp
# Docs: https://mziqudhd92.github.io/uhbs-standard/mkdocs/tooling/mcp/
```

## MCP (Model Context Protocol)

Industry open standard for AI tool calling (AAIF / Linux Foundation). UHBS exposes local stdio tools: validate_scorecard, validate_profile, compute_uhqs, list_conformance_fixtures, get_scorecard_summary, list_lab_reports, plus schema/scoring resources. Metadata: https://github.com/mziqudhd92/uhbs-standard/blob/main/server.json

## Vendor neutrality

Normative docs and templates use **classes and protocols** only. Named products appear only under conformance fixtures / lab reports as evaluation **proof**, not as UHBS requirements.

Published full-lab proof (sanitized fixtures; prefer live fixture JSON if this digest drifts):
- ESPot (Web-API HTTP): UHQS **49.82** (F)
- miniprint (Low-Interaction PJL): UHQS **47.77** (F)
- Conpot (ICS-SCADA Modbus): UHQS **55.51** (D)
- Cowrie (Low-Interaction SSH): UHQS **61.37** (D)
- OpenCanary HTTP: UHQS **50.12** (D); FTP **59.43** (D); SSH **28.44** (F); Telnet **57.00** (D); Redis **48.26** (F)
- Endlessh (SSH tarpit / ssh_tarpit): UHQS **51.90** (D)
- CyberHalluciNet / POSIX-Shell lab (illustrative): UHQS **80.33** (B)

## Machine-readable artifacts

- Schemas: https://github.com/mziqudhd92/uhbs-standard/tree/main/schemas
- CITATION.cff: https://github.com/mziqudhd92/uhbs-standard/blob/main/CITATION.cff
- ROADMAP: https://github.com/mziqudhd92/uhbs-standard/blob/main/ROADMAP.md
- Repo llms.txt: https://github.com/mziqudhd92/uhbs-standard/blob/main/llms.txt
- MCP server.json: https://github.com/mziqudhd92/uhbs-standard/blob/main/server.json

## Citation note

Cite as a personal beta software/framework (see CITATION.cff). Do not describe UHBS as an adopted industry or academic standard unless Phase 6 roadmap exit criteria are met.