# Documentation

> Install Harbor Self-Evolving, understand the evidence model, run both evaluation paths and inspect exact contracts.

---

LLMS index: [llms.txt](/harbor-self-evolving/llms.txt)

---

Choose the path that matches your question:

- [Install and start](https://istarwyh.github.io/harbor-self-evolving/docs/start/) — get the Plugin, Adapter and Skill into the selected DSH profile.
- [Historical diagnosis](https://istarwyh.github.io/harbor-self-evolving/docs/workflows/historical/) — learn from recent completed Sessions without calling them promotion evidence.
- [Candidate evaluation](https://istarwyh.github.io/harbor-self-evolving/docs/workflows/candidate/) — freeze identities, run a comparable regression and apply policy.
- [Plugin Workbench](https://istarwyh.github.io/harbor-self-evolving/docs/plugin/) — understand Context, Evidence, Artifacts and reviewed actions.
- [Concepts](https://istarwyh.github.io/harbor-self-evolving/docs/concepts/) — learn why valid score, raw reward and coverage are not interchangeable.
- [Architecture](https://istarwyh.github.io/harbor-self-evolving/docs/architecture/) — inspect protocols, execution environments and trust boundaries.
- [19-tool reference](https://istarwyh.github.io/harbor-self-evolving/docs/reference/tools/) — look up every Agent tool and approval boundary.
- [Security](https://istarwyh.github.io/harbor-self-evolving/docs/security/) — read the limits before running untrusted Tasks.

> [!IMPORTANT]
> Version baseline: **Harbor Self-Evolving 0.9.7 (Beta)**, compatible with **Harbor `>=0.21,<0.22`**. Development-preview behavior from an untagged checkout is labeled separately.

---

Section pages:

- [Install and start](/harbor-self-evolving/docs/start/): Install the registry release into the selected DSH profile, restart, verify the Plugin and choose an evaluation path.
- [Workflows](/harbor-self-evolving/docs/workflows/): Diagnose real Sessions, run Candidate regressions, and govern Evaluators.
- [Workbench, context, and reviewed actions](/harbor-self-evolving/docs/plugin/): Navigate the native DSH Workbench, bind page context, inspect evidence and review actions before execution.
- [Concepts and trustworthy scores](/harbor-self-evolving/docs/concepts/): Dataset, Generator, Evaluator, Optimizer, train/validation/test splits, meta-evaluation, trustworthy scores and promotion semantics.
- [Architecture and trust boundaries](/harbor-self-evolving/docs/architecture/): DSH Plugin, Skill, Python Adapter, two Context protocols, execution environments and the deterministic Gate.
- [Reference](/harbor-self-evolving/docs/reference/)
- [Security, privacy, and execution boundaries](/harbor-self-evolving/docs/security/): What the Plugin protects, what remains trusted, what can leave the machine, and why Harbor never deploys.
- [Troubleshooting](/harbor-self-evolving/docs/troubleshooting/): Diagnose installation, profile, Dataset, Context, Historical and execution-environment failures without overstating success.