dsh-healthcheck: session library scan + crash-tail inspection (read-only)

[jiatianyuan11]

dsh-healthcheck — a read-only health check for your dsh session library.

Repo: https://github.com/neufagents/dsh-healthcheck

Install:

dsh plugin --profile web add github:neufagents/dsh-healthcheck

One tool, health_check:

• No arguments — session-library scan: totals (sessions / size / events), largest sessions, and warnings when a session looks like a long-task OOM candidate (size & event-count thresholds).
• session_id="<id>" — deep inspection of one log: crash-tail detection (an unclosed turn means the log was interrupted by a crash; resume already repairs it — this just surfaces it), tool-call/result pairing, event distribution.

It reads through the official session-persistence service API (list/stat/open) and never writes a byte.

Built and tested against dsh 0.1.5-rc.2. Feedback very welcome — especially from anyone who has run into the "session suddenly huge" or "session doesn't resume cleanly" class of problems.

[jiatianyuan11]

A follow-up from the author — for anyone reading this before installing, and for plugin authors in general.

The first revision of this repo shipped raw TypeScript sources (main: src/index.ts). That doesn't work for installed plugins: Node refuses type-stripping for files under node_modules (ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING), so dsh fails to boot once the plugin is installed. Fixed in v0.1.1 — it now ships compiled JS in dist/.

Two small lessons worth sharing with anyone building dsh plugins:

1. Ship compiled JS, not TS sources. The --patch dev workflow tolerates .ts files, but installed plugins load from node_modules, where type-stripping is not allowed.
2. dsh plugin forwards to pnpm. On machines without pnpm on PATH it fails with a bare dsh: pnpm failed in profile directory ... message — worth mentioning in your install notes.

(Also happy to report: install → boot → composed config were all re-verified end-to-end against 0.1.5-rc.2 after the fix.)