dsh-brief-sidebar: Rendering the DSH Session Briefing as a Right Sidebar

Introduction¶

In the DSH development workflow, session briefs usually contain task progress and deliverable information, but by default this information is scattered and hard to view in one place. The dsh-brief-sidebar plugin solves this issue. As a consumer of dsh-better-sidebar, it renders the brief content as a “Summary” tab in the right sidebar and masks the official todo panel, making the summary view the only visible surface for task progress.

Core Features¶

1. Right sidebar Summary tab: Renders the session brief as a summary tab inside the right sidebar.
2. Dual-list display:
   - Progress board: Shows the task progress projected from todos, including three status states and summaries.
   - Deliverables list: Shows the deliverables projected from dshSummaryDeliverables in real time, listing successfully written files. codeplan planning deliverables display a “Planning” label.
3. Masking the official panel: When better-sidebar is active, the plugin competes through registration priority to mask the official todo panel at the top of composer-band.
4. Read-only mode: Provides display only; it does not support editing, write-back, or multi-session aggregation.

Installation¶

Before installation, make sure your DSH version is on the 0.2.0 line (engines.dsh >=0.2.0-rc.1).

dsh plugin --profile web add dsh-brief-sidebar@dsh-0.2.0

After installation, refresh the page for the changes to take effect.

Usage¶

1. After installation is complete, a “Summary” tab appears in the right sidebar.
2. In the “Summary” tab, view the current session’s task progress and deliverables list.
3. Click a file path in the deliverables list to open the corresponding resource in the sidebar via ctx.sidebarRight.openResource.

Design Highlights¶

• Data pipeline: The plugin does not depend on the framework’s useProjection. Instead, it directly uses ctx.get('sessions') to obtain the SessionBinding and ProjectionsFace, then parses todos and dshSummaryDeliverables respectively.
• Masking logic: Using the SlotCore registration mechanism, the plugin registers the id: 'todo' entry with priority: -1, giving it higher precedence than the official default order: 0. This allows masking to take effect when better-sidebar is active.
• Deliverables folding: The folding rule for the deliverables list matches the official turn-deliverables behavior. Only files successfully written (write/edit/str_replace_editor) are counted, duplicates are removed, and failed items are ignored.
• Click to open: After clicking a deliverable path, the plugin uses the same Sidebar preview channel as the conversation flow (fileAddressFor), supporting both relative and absolute paths.

Limitations and Notes¶

• Read-only limitation: The plugin performs no editing or write-back operations, and it does not copy the third-party rendering layer, ensuring a single data flow.
• Compatibility: Only the DSH 0.2.0 line is supported. On the 0.1.x line, if better-sidebar is not active, the plugin remains inert (it does not render the tab and does not throw errors).
• Memory section: The third section of the brief, “Memory Recall,” currently only has a reserved layout slot. It is still planned and is not rendered in this release.

Summary¶

dsh-brief-sidebar provides a clear, read-only overview view for DSH sessions. By consolidating the task board and deliverables list in the right sidebar, developers can more intuitively track session progress and deliverables without switching between the official panel and the brief.

• Repository URL: https://github.com/drscrewdriver/dsh-brief-sidebar
• Directory page: https://www.skillhub.cn/plugins/drscrewdriver/dsh-brief-sidebar