Metadata-Version: 2.5
Name: harbor-dsh-evolution
Version: 0.2.0
Summary: Candidate identity, evaluation summaries, and promotion gates for DeepSeek Harness agents evaluated with Harbor.
Project-URL: Homepage, https://github.com/istarwyh/harbor-self-evolving
Project-URL: Documentation, https://github.com/istarwyh/harbor-self-evolving#readme
Project-URL: Issues, https://github.com/istarwyh/harbor-self-evolving/issues
Project-URL: Repository, https://github.com/istarwyh/harbor-self-evolving.git
Author: istarwyh
License-Expression: MIT
License-File: LICENSE
Keywords: agent-evaluation,agent-evolution,deepseek-harness,harbor
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Requires-Dist: harbor<0.22,>=0.21.0
Description-Content-Type: text/markdown

# harbor-dsh-evolution

Harbor-side integration for DeepSeek Harness Candidate evolution.

It provides:

- `DshCandidateAgent`: verifies and uploads an immutable Candidate, installs its locked npm dependencies, and runs it through Harbor's ACP runner.
- `EvolutionPlugin`: records Candidate identity, evaluation-context identity, Trial events, and `evaluation-summary.json` for each Job.
- `harbor-dsh`: snapshots/verifies Candidates, fingerprints datasets, summarizes Jobs, and runs the deterministic Promotion Gate.

Install it into the same Python environment as Harbor so the plugin entry point is discoverable:

```bash
uv venv .venv
uv pip install --python .venv/bin/python harbor-dsh-evolution
source .venv/bin/activate
harbor plugins list
harbor-dsh --help
```

Development from this repository:

```bash
uv sync
uv run harbor plugins list
uv run harbor-dsh --help
uv run harbor-dsh context ../../examples/deep-research/task
uv run pytest
uv build
```

Harbor and this package must be installed into the same Python environment for the `dsh-evolution` entry point to appear in `harbor plugins list`.

`snapshot` derives Candidate id and version from `package.json` unless they are explicitly supplied. Promotion rejects Jobs whose `evaluation-context` digests are missing or different.
