dsh-granular-prompt

Readme

# dsh-granular-prompt

A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH)
plugin: inspect and steer prompt composition while it happens, with system
prompts and personas you author yourself.

**See every section the next request will send.** A Prompt tab inside
Granular Settings lists the live census of sections, each with suppress,
replace (from the scratchpad), view full text, and revert. Ship your own
system prompts (or take over the whole prompt in complete mode). Keep a
persona library and pick one per session, with a picker right beside the
chat input.

## What you get

<img width="908" height="309" alt="image" src="https://github.com/user-attachments/assets/ce3918d7-9076-4e34-bd8f-063b89c94630" />

- **Live list**: every section that will render in the next assembly, with
  a suppress checkbox, view, replace, and revert. Suppression and
  replacement are mutually exclusive per section.
- **System prompts**: a library plus an active selection, additive or
  complete mode. Complete makes your text the ENTIRE prompt
  (registry-enforced).
- **Personas**: a library with a global default and per-session selection;
  `inherit` falls back to the default.
- **Composer picker**: the same Active persona choice, one click from the
  chat input (togglable in the Plugin tab, default on).

## How to install

Requires a DeepSeek Harness checkout and a profile, here `web`. Clone the
dependencies and this plugin into a plugins folder:

```sh
mkdir -p ~/dsh-plugins && cd ~/dsh-plugins
git clone https://github.com/joao-paulo-santos/dsh-scratchpad.git
git clone https://github.com/joao-paulo-santos/dsh-event-relay.git
git clone https://github.com/joao-paulo-santos/dsh-granular-settings.git
git clone https://github.com/joao-paulo-santos/dsh-granular-prompt.git

# from the harness checkout
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-scratchpad
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-event-relay
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-granular-settings
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-granular-prompt

# verify the profile still composes
pnpm dsh --profile web --dump-config
```

Restart the harness; the Prompt tab appears in Granular Settings.

## Mechanisms

- Census runs `systemPrompt.assemble` with a bypass marker its own
  waterfall listener honors, so the control surface always sees the
  UNFILTERED table.
- ONE waterfall listener applies suppress then replace, in that order;
  filter failures fall through unfiltered.
- The user system prompt (order -98) and persona (order 5) are registered
  sections with provider functions: switching applies to the NEXT request.
- Persona resolution: session setting, else default persona, else none.
- Store: `~/.dsh/settings/prompt-manager.json`, write-through memory with
  serialized writes.

## Debugging

The census behind the tab:

```
curl 'http://127.0.0.1:3080/granular-prompt/census'
curl 'http://127.0.0.1:3080/granular-prompt/census?session=<sid>'
```

## Dependencies

- [dsh-granular-settings](https://github.com/joao-paulo-santos/dsh-granular-settings) hosts the Prompt tab and owns the persona settings this plugin registers and reads
- [dsh-scratchpad](https://github.com/joao-paulo-santos/dsh-scratchpad) is the pad this plugin opens for full-text viewing, section replacement, and diff review (required; the UI does not activate without it)
- [dsh-event-relay](https://github.com/joao-paulo-santos/dsh-event-relay) carries change doorbells (optional; focus refetch covers its absence)

## Plugins dependent on this

*(none)*