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.