# NousResearch/hermes-agent · Handling non-mapping plugin.yaml without crashing

## Open now

- 1 issue, 3 PRs open on GitHub.
- #14066: plugins install crashes when plugin.yaml is valid YAML but not a mapping
- PR #14086: fix(plugins): tolerate non-mapping plugin manifests
- PR #14147: fix(plugins): ignore non-mapping manifests
- PR #23253: fix(plugins): ignore non-mapping plugin manifests

These issues and PRs concern how the plugin system should behave when a plugin.yaml file contains valid YAML that is not a mapping type, with various proposed approaches including rejecting, ignoring, or tolerating such manifests to prevent a crash.

## TL;DR

- 6 member(s): 1 open issue(s), 0 closed issue(s), 3 open PR(s), 0 merged PR(s), 2 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.33`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Open related issues

- #14066: plugins install crashes when plugin.yaml is valid YAML but not a mapping

## Prior & competing PRs

- **#14122: fix(plugins): treat non-mapping plugin.yaml as invalid instead of crashing**. closed without merge · fix tier `suggested`
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `#14077`, `#14086`, `#14066`
  - _suggested-tier fix detail withheld; re-request with `?tier=all` to include it._
- **#14077: fix(plugins): reject non-mapping plugin manifests**. closed without merge
  - maintainer direction: category `stale_abandoned`; implication `active`
- **#14086: fix(plugins): tolerate non-mapping plugin manifests**. open
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#14077`
  - files: `hermes_cli/plugins_cmd.py`, `tests/hermes_cli/test_plugins_cmd.py`
- **#14147: fix(plugins): ignore non-mapping manifests**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `hermes_cli/plugins.py`, `hermes_cli/plugins_cmd.py`, `tests/hermes_cli/test_plugins.py`, `tests/hermes_cli/test_plugins_cmd.py`
- **#23253: fix(plugins): ignore non-mapping plugin manifests**. open
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#14147`, `#14066`
  - files: `hermes_cli/plugins.py`, `hermes_cli/plugins_cmd.py`, `tests/hermes_cli/test_plugins.py`, `tests/hermes_cli/test_plugins_cmd.py`

## Fix status

- No merged fix on record.
- Subsystem: `hermes_cli`