dsh-trace-narrator

After a DSH session, the raw trajectory is long, noisy, and hard to summarize. Answering "what actually happened, where it failed, and which steps deserve to be handed off" usually means scrolling through logs by hand. dsh-trace-narrator collapses that into a single command and a readable, self-contained report.

It first applies strict redaction to the trajectory, validates the LLM output against a schema, and then emits a self-contained HTML, Markdown, or JSON document. Built-in perspectives include summary, postmortem, tutorial, debug, and executive views. No third-party scripts are loaded. When DSH agent or inbox capabilities are available, the plugin also asks the conversation model to restate key findings and suggest next actions in the following turn; in headless or trimmed environments it simply returns the local report without extra network calls. Viewer upload is fully opt-in and restricted to HTTPS; with it disabled, no data leaves the machine.

It is aimed at developers running DSH for production or research work who need to hand off a session to a colleague or turn it into teaching material, and at teams that want structured post-mortems in CI or headless pipelines without pulling in a cloud dependency. Reports land locally by default, and the security model is explicit: no collection, no multi-session merging, no public knowledge base required.