dsh-archive-manager

A minimal out-of-tree DeepSeek Harness Web Cordis plugin that permanently
deletes the on-disk session directory of an archived session from the sidebar.

It does not modify the DSH core installation or any profile configuration.
The only durable effect on $DSH_HOME is the intended one: after the user
confirms, it deletes the selected session directory under
$DSH_HOME/sessions. No other DSH durable state (workspace registry,
projection cache, shared attachments) is written. The host half owns one HTTP
route; the client half adds a sidebar footer action that lists archived
sessions and deletes them after an explicit second confirmation.

What it does

• Host half (index.js) registers POST /archive-manager/delete.
• Client half (client.js) registers a sidebar.footer.action list entry
  (id: archive-manager, order: 80). Wide mode shows the label 已归档 N;
  the narrow rail shows only the archive icon.
• The modal lists only the ids in the workspace registry's archivedSessionIds
  that also have a session summary in the client session baseline, displaying
  displayTitle (or the id), cwd, and updatedAt.
• Each row has a trash button. Deleting requires a clear second confirmation
  stating that the session directory will be permanently deleted and cannot be
  restored.
• Deleting issues a same-origin POST /archive-manager/delete and, on
  success, refreshes both sessions and workspaces. A local deleted-id set
  hides the row even though the archived marker is intentionally left intact.

Install

This is an out-of-tree plugin: place it on disk and install it into the
existing web profile.

Option A — install from GitHub

dsh plugin --profile web add "github:zimixvx/dsh-archive-manager"

Option B — install from a local path

With the plugin directory at D:\Code\DeepseekHarness\plugins\dsh-archive-manager:

dsh plugin --profile web add "D:\Code\DeepseekHarness\plugins\dsh-archive-manager"

Then add the plugin to the web profile's bundle list in
$DSH_HOME/profiles/web/package.json:

{
  "name": "dsh-profile-web",
  "private": true,
  "dependencies": {
    "dsh-archive-manager": "file:D:/Code/DeepseekHarness/plugins/dsh-archive-manager"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-archive-manager"
      ]
    }
  }
}

The exact dependencies entry is written by dsh plugin --profile web add;
only the bundles list needs the manual addition.

The plugin's cordis.patch.yml (declared via dsh.bundle.patch) inserts the
host row:

- insert:
    - id: archive-manager
      name: dsh-archive-manager

Restart

A running process does not pick up new bundle rows, so restart the web profile:

dsh web

After a page refresh, the sidebar footer shows the archive-management action.

Safety and limitations

• Only archived sessions. The route refuses any id not present in
  workspaceRegistry.archivedSessionIds.
• Live sessions are refused — checked before the persistence lookup and
  again immediately before the rm, with HTTP 409.
• Raw-artifact backend required. The persistence backend must advertise
  supportsRawArtifacts === true and a locate() returning
  { kind: 'jsonl', path }. Otherwise the route answers 501.
• Deletes the session directory only. rm(dirname(location.path), { recursive: true, force: false }) removes the directory that holds the
  session's JSONL log (and any session-local files inside it). It does not
  modify the workspace registry, the archived markers, the projection cache,
  or content-addressed attachments (which live in a separate shared store and
  are shared across sessions).
• Stale archived markers. After a successful delete, the archived marker in
  archivedSessionIds remains by design (removing it would mutate the
  registry). Because the panel only lists archived ids that still have a
  session summary, and the physical deletion removes that summary, the leftover
  marker does not reappear after a page reload. A local deleted-id set also
  hides the row immediately even if the follow-up refresh fails.
• Not reversible. The deletion is a recursive rm with force: false.
  There is no trash or restore path.

Uninstall

Remove dsh-archive-manager from the profile's dsh.profile.bundles (and from
dependencies), then restart. The plugin adds no durable state of its own, so
there is nothing else to clean up.

License

MIT — see LICENSE.