# Contributing to dsh-compat

Thank you for helping make plugin migration to DeepSeek Harness explicit and auditable.

## Development

Requirements:

- Node.js 22 or newer;
- pnpm 11 or newer.

```bash
pnpm install
pnpm test:all
```

## Contribution contract

Every compatibility change must include:

1. a parser or schema update when the source format changes;
2. a stable rule ID and explicit `DIRECT`, `ADAPTED`, `UNSUPPORTED`, or `BLOCKED` decision;
3. a fixture and regression test;
4. a security test when paths, scripts, permissions, environment variables, or executables are involved;
5. official DSH documentation, source, or a behavior trace supporting any new compatibility claim.

Do not add mappings based only on similar field names. Unknown behavior must remain unsupported or blocked until it is proven.

## Pull requests

- Keep changes focused.
- Do not commit third-party plugin source unless its license explicitly permits redistribution.
- Store real-plugin corpus entries as source URL, fixed revision, digest, license metadata, and expected decisions where possible.
- Run `pnpm test:all` before requesting review.