dsh-plugin-workspace-move-top 0.0.0-stage → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Workspace Hub contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,29 @@
-# Temporary Holding Version
+# Move to Top
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[中文说明](README.zh-CN.md)
+
+Add **Move to top** to a DSH workspace's `…` menu. One click performs one reorder through the host's official `workspaceRegistry.insertBefore` API, just like a long manual drag.
+
+- No stars, favorites, pinned categories, or automatic reordering.
+- Move another workspace later and the previous one naturally moves down.
+- Manual dragging remains yours; activation and synchronization never restore an old order.
+- Works independently of Workspace Hub.
+
+## Install
+
+```sh
+dsh plugin --profile desktop add dsh-plugin-workspace-move-top@0.2.1
+```
+
+## Compatibility and limits
+
+Tested with **DSH 0.2.1-rc.5 on macOS**. This release targets that exact host version. Menu copy follows the browser language: Chinese or English.
+
+The host has no workspace-menu extension slot, so the client uses the current workspace-row and menu DOM. If a future host changes that structure, the action may disappear. It must not reorder workspaces on its own. Windows and non-empty session-menu browser behavior have not been verified.
+
+## Verify
+
+```sh
+npm ci
+npm run check
+```

package/README.zh-CN.md

@@ -0,0 +1,29 @@
+# 移到最上面
+
+[English](README.md)
+
+在 DSH 工作区 `…` 菜单中增加“移到最上面”。点击一次，通过官方 `workspaceRegistry.insertBefore` 接口完成一次排序，相当于替你完成一次长距离拖动。
+
+- 没有星标、收藏区或自动归位。
+- 之后把另一个项目移到第一，原来的自然退到第二。
+- 仍可自由拖动；启动与同步时不恢复旧顺序。
+- 不依赖工作区同步插件，可单独安装。
+
+## 安装
+
+```sh
+dsh plugin --profile desktop add dsh-plugin-workspace-move-top@0.2.1
+```
+
+## 兼容性与限制
+
+已在 **macOS + DSH 0.2.1-rc.5** 验证，本版本精确对应该宿主。菜单根据浏览器语言显示中文或英文。
+
+宿主没有工作区菜单扩展位，因此客户端使用当前工作区行和菜单 DOM。宿主改变该结构后，菜单项可能消失；插件不会因此自行排序。Windows 真机与非空会话菜单的浏览器行为尚未验证。
+
+## 验证
+
+```sh
+npm ci
+npm run check
+```

package/client/client.js

@@ -0,0 +1,139 @@
+// One-shot workspace reorder. No favorites, pins, persistent state or row icons.
+window.__ModuleLoader__.load({
+  id: 'dsh-plugin-workspace-move-top',
+  factory: function (require) {
+    var module = { exports: {} }
+    var exports = module.exports
+    var MENU_ITEM = 'data-wshub-move-top'
+    var API_PATH = 'api/plugins/wshub-workspace-move-top/move'
+    // Menu copy follows the host UI language (navigator.language). Backend error
+    // messages are shown verbatim; only our own prefix is localized.
+    var LANGUAGE = (typeof navigator !== 'undefined' && navigator && navigator.language) || ''
+    var LABELS = /^zh/i.test(LANGUAGE)
+      ? { menu: '移到最上面', hint: '只调整一次顺序，之后仍可自由拖动', busy: '正在调整顺序…', done: '已移到最上面', failed: '调整失败：' }
+      : { menu: 'Move to top', hint: 'Moves this workspace once; you can still drag afterwards.', busy: 'Moving to top…', done: 'Moved to top', failed: 'Move failed: ' }
+
+    function apply(ctx) {
+      ctx.effect(function () {
+        var workspaceId = null
+        var busy = false
+        var observer = null
+        var timer = null
+        var buttons = new Set()
+
+        function rowId(target) {
+          var row = target && target.closest && target.closest('[data-row-key^="workspace:"]')
+          if (!row) return null
+          var key = row.getAttribute('data-row-key') || ''
+          return key.slice(10) || null
+        }
+
+        // Capture the row whose native workspace action button opened this menu.
+        function onPointerDown(event) {
+          if (!(event.target instanceof Element)) return
+          var button = event.target.closest('button[aria-label]')
+          if (event.target.closest('[role="menu"]')) return
+          if (!button || button.hasAttribute('aria-keyshortcuts')) {
+            workspaceId = null
+            return
+          }
+          var row = button.closest('[data-row-key^="workspace:"]')
+          workspaceId = row && row.querySelector('button[aria-label]') === button ? rowId(button) : null
+        }
+
+        async function moveToTop(button) {
+          var id = button.dataset.wshubWorkspaceId
+          if (!id || busy) return
+          busy = true
+          button.disabled = true
+          button.title = LABELS.busy
+          try {
+            var response = await fetch(API_PATH, {
+              method: 'POST',
+              headers: { 'content-type': 'application/json' },
+              body: JSON.stringify({ workspaceId: id, action: 'move-to-top' }),
+            })
+            var result = await response.json().catch(function () { return null })
+            if (!response.ok || !result || result.ok !== true) throw new Error((result && result.message) || ('HTTP ' + response.status))
+            button.title = LABELS.done
+            // Closing the native menu removes the extension row with it.
+            var trigger = document.activeElement
+            if (trigger && trigger.closest && trigger.closest('[data-row-key^="workspace:"]')) trigger.click()
+            var event = new KeyboardEvent('keydown', { key: 'Escape', bubbles: true })
+            document.dispatchEvent(event)
+            // DOM teardown is authoritative; the Host publishes the new order.
+          } catch (error) {
+            button.disabled = false
+            button.title = LABELS.failed + (error instanceof Error ? error.message : String(error))
+            button.setAttribute('aria-label', button.title)
+          } finally {
+            busy = false
+          }
+        }
+
+        function decorate() {
+          observer.disconnect()
+          try {
+            var menus = document.querySelectorAll('[role="menu"][data-menu-material="translucent"]')
+            for (var i = 0; i < menus.length; i++) {
+              var menu = menus[i]
+              if (!workspaceId || menu.querySelector('[' + MENU_ITEM + ']')) continue
+              var viewport = menu.querySelector('[role="presentation"]')
+              var template = viewport && viewport.querySelector('button[role="menuitem"]')
+              if (!template) continue
+              // Clone only native menu classes/row structure; do not copy its actions.
+              var wrapper = template.parentElement.cloneNode(false)
+              var button = template.cloneNode(false)
+              button.setAttribute(MENU_ITEM, '1')
+              button.dataset.wshubWorkspaceId = workspaceId
+              button.removeAttribute('class')
+              button.className = template.className
+              button.setAttribute('aria-label', LABELS.menu)
+              button.title = LABELS.hint
+              var spans = template.querySelectorAll('span')
+              if (spans[0]) {
+                var icon = document.createElement('span')
+                icon.className = spans[0].className
+                icon.textContent = '↑'
+                button.appendChild(icon)
+              }
+              var label = document.createElement('span')
+              var labelTemplate = spans[1] || spans[0]
+              if (labelTemplate) label.className = labelTemplate.className
+              label.textContent = LABELS.menu
+              button.appendChild(label)
+              button.addEventListener('click', function (event) {
+                event.preventDefault()
+                event.stopPropagation()
+                void moveToTop(event.currentTarget)
+              })
+              wrapper.appendChild(button)
+              viewport.insertBefore(wrapper, viewport.firstChild)
+              buttons.add(button)
+            }
+          } finally {
+            observer.observe(document.documentElement, { childList: true, subtree: true })
+          }
+        }
+        function schedule() {
+          if (timer !== null) return
+          timer = setTimeout(function () { timer = null; decorate() }, 40)
+        }
+        observer = new MutationObserver(schedule)
+        observer.observe(document.documentElement, { childList: true, subtree: true })
+        document.addEventListener('pointerdown', onPointerDown, true)
+        document.addEventListener('keydown', onPointerDown, true)
+        return function () {
+          document.removeEventListener('pointerdown', onPointerDown, true)
+          document.removeEventListener('keydown', onPointerDown, true)
+          observer.disconnect()
+          if (timer !== null) clearTimeout(timer)
+          buttons.forEach(function (button) { button.remove() })
+          buttons.clear()
+        }
+      })
+    }
+    exports.apply = apply
+    return module.exports
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: wshub-workspace-move-top
+      name: dsh-plugin-workspace-move-top
+      # Stateless one-shot ordering; no favorites or saved plugin state.

package/dsh-plugin.naming.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 1,
+  "policy": "dsh-plugin-naming/v1",
+  "plugin": {
+    "namespace": "dongsheng123132",
+    "name": "workspace-move-top",
+    "coordinate": "dongsheng123132/workspace-move-top",
+    "packageName": "dsh-plugin-workspace-move-top"
+  },
+  "names": {
+    "pluginNames": [
+      "workspace-move-top"
+    ],
+    "loaderIds": [
+      "wshub-workspace-move-top"
+    ],
+    "services": [
+      "wshubWorkspaceMoveTop"
+    ],
+    "tools": [],
+    "commands": [],
+    "skills": [],
+    "skillProviders": [],
+    "events": [],
+    "settingsNamespaces": [],
+    "routes": [
+      {
+        "kind": "exact",
+        "path": "/api/plugins/wshub-workspace-move-top/move"
+      }
+    ]
+  }
+}

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "workspace-move-top";
+export declare const inject: string[];
+export { WorkspaceMoveTopService, SERVICE_NAME } from './service.js';
+export { MOVE_ROUTE, handleMoveRequest } from './move-route.js';
+/** Activate the stateless move-to-top service. No startup reordering: the
+ * host's durable registry order is left untouched until a client asks to move
+ * one workspace to the top.
+ * @param ctx injected plugin scope
+ */
+export declare function apply(ctx: Context): Promise<void>;

package/lib/index.js

@@ -0,0 +1,15 @@
+import { WorkspaceMoveTopService } from './service.js';
+import { installMoveRoute } from './move-route.js';
+export const name = 'workspace-move-top';
+export const inject = ['workspaceRegistry'];
+export { WorkspaceMoveTopService, SERVICE_NAME } from './service.js';
+export { MOVE_ROUTE, handleMoveRequest } from './move-route.js';
+/** Activate the stateless move-to-top service. No startup reordering: the
+ * host's durable registry order is left untouched until a client asks to move
+ * one workspace to the top.
+ * @param ctx injected plugin scope
+ */
+export async function apply(ctx) {
+    const moveTop = new WorkspaceMoveTopService(ctx);
+    installMoveRoute(ctx, moveTop);
+}

package/lib/move-route.d.ts

@@ -0,0 +1,17 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { WorkspaceMoveTopService } from './service.js';
+/** Exact connection route the client calls for a one-shot move. */
+export declare const MOVE_ROUTE = "/api/plugins/wshub-workspace-move-top/move";
+export declare const MOVE_ACTION = "move-to-top";
+/** Handle an authenticated request.
+ * @param moveTop serialized service
+ * @param request owner authenticated request
+ * @returns JSON response
+ */
+export declare function handleMoveRequest(moveTop: WorkspaceMoveTopService, request: Request): Promise<Response>;
+/** Register the optional connection route with an effect disposer.
+ * @param ctx plugin context
+ * @param moveTop serialized service
+ * @returns nothing
+ */
+export declare function installMoveRoute(ctx: Context, moveTop: WorkspaceMoveTopService): void;

package/lib/move-route.js

@@ -0,0 +1,40 @@
+/** Exact connection route the client calls for a one-shot move. */
+export const MOVE_ROUTE = '/api/plugins/wshub-workspace-move-top/move';
+export const MOVE_ACTION = 'move-to-top';
+/** Handle an authenticated request.
+ * @param moveTop serialized service
+ * @param request owner authenticated request
+ * @returns JSON response
+ */
+export async function handleMoveRequest(moveTop, request) {
+    const headers = { 'cache-control': 'no-store' };
+    try {
+        if (request.method !== 'POST')
+            return Response.json({ ok: false, message: '不支持的请求方式' }, { status: 405, headers });
+        let body;
+        try {
+            body = await request.json();
+        }
+        catch {
+            return Response.json({ ok: false, message: '请求不是合法 JSON' }, { status: 400, headers });
+        }
+        if (!body || typeof body !== 'object' || Array.isArray(body) || !('workspaceId' in body) || typeof body.workspaceId !== 'string' || !body.workspaceId.trim() || !('action' in body) || body.action !== MOVE_ACTION) {
+            return Response.json({ ok: false, message: `需要工作区 ID 与 action: '${MOVE_ACTION}'` }, { status: 400, headers });
+        }
+        const result = await moveTop.moveToTop(body.workspaceId);
+        return Response.json(result, { status: result.ok ? 200 : 409, headers });
+    }
+    catch {
+        return Response.json({ ok: false, message: '移动未完成，请刷新后重试' }, { status: 500, headers });
+    }
+}
+/** Register the optional connection route with an effect disposer.
+ * @param ctx plugin context
+ * @param moveTop serialized service
+ * @returns nothing
+ */
+export function installMoveRoute(ctx, moveTop) {
+    ctx.inject(['connection'], scope => {
+        scope.effect(() => scope.connection.fetch.register({ path: MOVE_ROUTE, methods: ['POST'], requestBody: 'buffered', fetch: request => handleMoveRequest(moveTop, request) }));
+    });
+}

package/lib/service.d.ts

@@ -0,0 +1,47 @@
+import { Service, type Context } from '@deepseek-ai/cordis';
+export declare const SERVICE_NAME = "wshubWorkspaceMoveTop";
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        wshubWorkspaceMoveTop: WorkspaceMoveTopService;
+    }
+}
+/** Registry projection needed for ordering and the route payload. */
+export interface WorkspaceEntryView {
+    readonly id: string;
+    readonly path: string;
+    readonly title: string;
+}
+/** One successful move-to-top result. */
+export interface MoveToTopResult {
+    readonly ok: true;
+    /** Whether an `insertBefore` actually moved the workspace. */
+    readonly moved: boolean;
+    /** The complete durable order after the operation (top first). */
+    readonly order: readonly string[];
+    readonly workspaces: readonly WorkspaceEntryView[];
+}
+/** Failure result for an empty registry or an unknown workspace. */
+export interface MoveToTopError {
+    readonly ok: false;
+    readonly reason: 'none';
+    readonly message: string;
+}
+/** Stateless "move to top" service. Owns the registry ordering queue but no
+ * file or saved state: it never reorders on activation and keeps no ordering
+ * or favorites state. */
+export declare class WorkspaceMoveTopService extends Service {
+    private queue;
+    constructor(ctx: Context);
+    private enqueue;
+    private list;
+    /** Move one workspace to the top of the durable display order, exactly once.
+     *
+     * Reads the real registry order; an already-first workspace is a no-op and an
+     * unknown workspace is rejected without touching the order. Otherwise it asks
+     * the host for `insertBefore(id, firstId)` — the same durable write the
+     * official sidebar drag uses — so the result survives restart and no plugin
+     * startup pass re-applies it.
+     * @param workspaceId exact registry ID
+     */
+    moveToTop(workspaceId: string): Promise<MoveToTopResult | MoveToTopError>;
+}

package/lib/service.js

@@ -0,0 +1,48 @@
+import { Service } from '@deepseek-ai/cordis';
+export const SERVICE_NAME = 'wshubWorkspaceMoveTop';
+function toEntryView(entry) {
+    return { id: String(entry.id), path: entry.path, title: entry.title };
+}
+/** Stateless "move to top" service. Owns the registry ordering queue but no
+ * file or saved state: it never reorders on activation and keeps no ordering
+ * or favorites state. */
+export class WorkspaceMoveTopService extends Service {
+    queue = Promise.resolve();
+    constructor(ctx) {
+        super(ctx, SERVICE_NAME);
+    }
+    enqueue(action) {
+        const run = this.queue.then(action);
+        this.queue = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    list() {
+        return this.ctx.workspaceRegistry.list().map(toEntryView);
+    }
+    /** Move one workspace to the top of the durable display order, exactly once.
+     *
+     * Reads the real registry order; an already-first workspace is a no-op and an
+     * unknown workspace is rejected without touching the order. Otherwise it asks
+     * the host for `insertBefore(id, firstId)` — the same durable write the
+     * official sidebar drag uses — so the result survives restart and no plugin
+     * startup pass re-applies it.
+     * @param workspaceId exact registry ID
+     */
+    moveToTop(workspaceId) {
+        return this.enqueue(async () => {
+            const registry = this.ctx.workspaceRegistry;
+            const order = registry.list();
+            const first = order[0];
+            if (first === undefined)
+                return { ok: false, reason: 'none', message: '工作区列表为空' };
+            if (first.id === workspaceId) {
+                return { ok: true, moved: false, order: order.map(entry => String(entry.id)), workspaces: order.map(toEntryView) };
+            }
+            if (!order.some(entry => entry.id === workspaceId)) {
+                return { ok: false, reason: 'none', message: '工作区已不存在，请刷新列表' };
+            }
+            const next = await registry.insertBefore(workspaceId, first.id);
+            return { ok: true, moved: true, order: next.map(id => String(id)), workspaces: this.list() };
+        });
+    }
+}

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "dsh-plugin-workspace-move-top",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "description": "Move a workspace to the top once from its menu, without favorites or automatic reordering.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./client/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "client/",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh-CN.md",
+    "dsh-plugin.naming.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dongsheng123132/dsh-workspace-plugins.git",
+    "directory": "plugins/dsh-workspace-move-top"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test test/{client,composition}.test.mjs",
+    "check": "npm run typecheck && npm run build && npm test",
+    "prepack": "npm run build",
+    "pretest": "npm run build"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-workspace": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-rc.5"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-workspace": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-rc.5",
+    "@types/node": "24.10.1",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "workspace",
+    "move-top",
+    "ordering"
+  ],
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    }
+  }
+}