dsh-plugin-graph

In a DSH plugin ecosystem where multiple plugins are mounted simultaneously, tool name collisions, service conflicts, circular dependencies, and pipeline interceptor overlaps often only surface at runtime, making debugging costly and error-prone. dsh-plugin-graph moves this check to install time: it statically parses plugin source and package.json without executing any plugin code, builds a full dependency graph, and blocks installation the moment a hard conflict is detected.

Detection spans four dimensions: tool and service name conflicts (error level), inter-plugin circular dependencies (identified via DFS three-color marking), pipeline interceptor overlap (warning level), and event listener overlap (info level). It also validates DSH version compatibility using simplified semver syntax (*, ^, ~, >=), ensuring declared minimum requirements match the current runtime. The CLI entry is dependency-free, emits machine-readable JSON, and returns exit code 0 or 1, ready to plug directly into CI as a final safety gate before deployment.

Built for teams shaping the DSH plugin ecosystem, maintainers auditing third-party plugins at scale, and developers who want compatibility checks in their pipeline. The pure-function business logic (lib/*.js) also lets you integrate it as a library into your own toolchain without depending on the DSH runtime.