@boostkit-dsh/job-workbench 0.3.1

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# 更新记录
+
+## 0.3.1 - 2026-09-22
+
+- 首次发布前将包名统一为 `@boostkit-dsh/job-workbench`，去掉 scope 下重复的 `plugin-` 前缀。
+- 将 DSH 精确兼容基线升级为 `0.1.7-alpha.1`，并同步鉴权依赖到 `@boostkit-dsh/auth-management@0.1.1`。
+
+## 0.3.0 - 2026-09-22
+
+- 对鉴权与审计管理增加精确硬依赖。
+- SPEC 页面与读取接口在没有有效 GitCode ActorRef 时统一返回 `AUTH_REQUIRED`。
+
+## 0.2.0 - 2026-09-20
+
+- 新增右侧栏工作台面板：会话标题栏入口按钮 + `sidebar.right.pane.tab` 两阶段注册（`extension` 优先带）。
+- 面板展示特性分组（类型/生命周期/负责人/标题、Spec ID/路径/上游引用详情）、校验问题列表、概览统计，支持工作区选择与刷新。
+- 新增同源只读接口 `GET /kunpeng-workbench/state?workspaceId=...`。
+- `kunpengSpecs` 服务在未配置 `root` 时改为多根 facade（`forRoot`/`roots`）；显式 `root` 保持 0.1.0 行为。
+
+## 0.1.0 - 2026-09-19
+
+- 提供项目级 SPEC 扫描、类型注册和按 Feature ID 聚合能力。
+- 校验生命周期、类型、必填标识及重复 Spec ID。

package/README.md

@@ -0,0 +1,36 @@
+# @boostkit-dsh/job-workbench
+
+## 用途
+
+提供鲲鹏特性作业工作台的 SPEC 服务与右侧栏面板。插件扫描项目的 `.agents/specs/`，校验最小头部与目录一致性，并按稳定 Feature ID 聚合不同角色交付的 SPEC。
+
+该插件不保存共享作业状态，不负责跨 Session 同步，也不替代 Git 历史。
+
+## 用法
+
+通过计算插件市场安装，或使用 DSH `0.1.7-alpha.1` 的原生插件管理能力安装精确版本：
+
+```text
+@boostkit-dsh/job-workbench@0.3.0
+```
+
+### Host 服务 `ctx.kunpengSpecs`
+
+- 显式配置 `root` 时：单根服务，含 `scan()`、`listTypes()` 和 `registerType()`（0.1.0 行为）；
+- 未配置 `root` 时：多根 facade，`forRoot(projectRoot)` 返回指定项目根的服务（UI 按工作区解析项目根），`roots()` 列出已创建的根。
+
+当前版本精确依赖 `@boostkit-dsh/auth-management@0.1.1`。右侧栏和 `GET /kunpeng-workbench/state` 在扫描任何 SPEC 前验证当前 GitCode ActorRef；未鉴权或 PAT 失效返回 `AUTH_REQUIRED`，客户端会引导到鉴权页。
+
+### UI（0.2.0 新增）
+
+- 会话标题栏出现“鲲鹏工作台”入口按钮，点击在右侧栏打开工作台 tab（`extension` 优先带，两阶段注册）；
+- 面板内选择 DSH 工作区后展示：特性分组（类型/生命周期/负责人/标题，展开见 Spec ID、路径与上游引用）、校验问题列表（重复 ID、状态/类型不一致等）、概览统计与刷新；
+- 数据来自同源接口 `GET /kunpeng-workbench/state?workspaceId=...`，只读不拦截 Agent 运行。
+
+## 配置
+
+- `root`：可选的项目根目录；缺省按所选工作区解析（`.git` 向上发现项目根）。
+
+## 维护人
+
+@lujinxing

package/client.js

@@ -0,0 +1,269 @@
+// Generated from src/client.ts by scripts/build-clients.mjs. Do not edit.
+window.__ModuleLoader__.load({ id: "@boostkit-dsh/job-workbench", factory: (require2) => {
+  const module = { exports: {} };
+  const exports = module.exports;
+  const { createElement: h, useCallback, useEffect, useMemo, useState, useSyncExternalStore } = require2("react");
+  const NS = "kunpeng-job-workbench";
+  const TAB_ID = "@boostkit-dsh/job-workbench";
+  const TAB_KIND = "kunpeng-workbench";
+  const dictionaries = {
+    zh: {
+      tabTitle: "\u9CB2\u9E4F\u5DE5\u4F5C\u53F0",
+      entryButton: "\u6253\u5F00\u9CB2\u9E4F\u5DE5\u4F5C\u53F0",
+      targetWorkspace: "\u5DE5\u4F5C\u533A",
+      noWorkspace: "\u8BF7\u5148\u5728\u5DE6\u4FA7\u6DFB\u52A0\u4E00\u4E2A DSH \u5DE5\u4F5C\u533A\uFF0C\u518D\u67E5\u770B\u9879\u76EE SPEC\u3002",
+      refresh: "\u5237\u65B0",
+      loading: "\u6B63\u5728\u626B\u63CF SPEC\u2026",
+      failed: "\u626B\u63CF\u5931\u8D25",
+      featureUnit: "\u4E2A\u7279\u6027",
+      specUnit: "\u4E2A SPEC",
+      typeUnit: "\u4E2A\u7C7B\u578B",
+      issueUnit: "\u4E2A\u95EE\u9898",
+      features: "\u7279\u6027",
+      issues: "\u6821\u9A8C\u95EE\u9898",
+      emptySpecs: "\u672A\u53D1\u73B0 SPEC",
+      emptySpecsBody: "\u5728\u9879\u76EE\u6839\u7684 .agents/specs/<\u751F\u547D\u5468\u671F>/<\u7C7B\u578B>/ \u4E0B\u521B\u5EFA Markdown SPEC\uFF08\u6807\u9898 \u201C# Feature SPEC: \u2026\u201D\uFF0C\u5934\u90E8\u542B Feature/Spec/Type/Status/Owner \u5B57\u6BB5\uFF09\u540E\uFF0C\u5237\u65B0\u5373\u53EF\u770B\u5230\u3002",
+      owner: "\u8D1F\u8D23\u4EBA",
+      specId: "Spec ID",
+      status: "\u72B6\u6001",
+      path: "\u8DEF\u5F84",
+      upstream: "\u4E0A\u6E38\u5F15\u7528",
+      copy: "\u590D\u5236",
+      copied: "\u5DF2\u590D\u5236",
+      showDetails: "\u67E5\u770B\u8BE6\u60C5",
+      hideDetails: "\u6536\u8D77"
+    },
+    en: {
+      tabTitle: "Kunpeng Workbench",
+      entryButton: "Open the Kunpeng workbench",
+      targetWorkspace: "Workspace",
+      noWorkspace: "Add a DSH workspace in the sidebar before browsing project SPECs.",
+      refresh: "Refresh",
+      loading: "Scanning SPECs\u2026",
+      failed: "Scan failed",
+      featureUnit: "features",
+      specUnit: "SPECs",
+      typeUnit: "types",
+      issueUnit: "issues",
+      features: "Features",
+      issues: "Validation issues",
+      emptySpecs: "No SPECs found",
+      emptySpecsBody: 'Create Markdown SPECs under .agents/specs/<lifecycle>/<type>/ in the project root (title "# Feature SPEC: \u2026", header fields Feature/Spec/Type/Status/Owner), then refresh.',
+      owner: "Owner",
+      specId: "Spec ID",
+      status: "Status",
+      path: "Path",
+      upstream: "Upstream",
+      copy: "Copy",
+      copied: "Copied",
+      showDetails: "Details",
+      hideDetails: "Collapse"
+    }
+  };
+  const styles = {
+    pane: { flex: 1, minHeight: 0, overflow: "auto", boxSizing: "border-box", padding: "12px 12px 20px", display: "flex", flexDirection: "column", gap: 10, color: "var(--dsw-alias-label-primary)" },
+    row: { display: "flex", alignItems: "center", gap: 8, flexWrap: "wrap" },
+    grow: { flex: 1 },
+    title: { margin: 0, fontSize: 14, fontWeight: 700 },
+    muted: { fontSize: 12, color: "var(--dsw-alias-label-tertiary)", wordBreak: "break-word" },
+    select: { minWidth: 120, maxWidth: "100%", padding: "5px 8px", borderRadius: 7, border: "1px solid var(--dsw-alias-border-l2)", color: "var(--dsw-alias-label-primary)", background: "var(--dsw-alias-bg-layer-1)" },
+    button: { padding: "4px 10px", borderRadius: 7, border: "1px solid var(--dsw-alias-border-l2)", background: "var(--dsw-alias-bg-layer-1)", color: "var(--dsw-alias-label-primary)", cursor: "pointer", font: "inherit" },
+    iconButton: { display: "inline-flex", alignItems: "center", gap: 6, padding: "4px 8px", borderRadius: 7, border: "1px solid transparent", background: "none", color: "var(--dsw-alias-label-secondary)", cursor: "pointer", font: "inherit" },
+    badge: { padding: "1px 6px", borderRadius: 999, border: "1px solid var(--dsw-alias-border-l2)", fontSize: 11, color: "var(--dsw-alias-label-secondary)", whiteSpace: "nowrap" },
+    lifecycleBadge: { padding: "1px 6px", borderRadius: 999, border: "1px solid var(--dsw-alias-state-business-primary)", fontSize: 11, color: "var(--dsw-alias-state-business-primary)", whiteSpace: "nowrap" },
+    issueBadge: { padding: "1px 6px", borderRadius: 999, border: "1px solid var(--dsw-alias-state-error-primary)", fontSize: 11, color: "var(--dsw-alias-state-error-primary)", whiteSpace: "nowrap" },
+    sectionHeader: { display: "flex", alignItems: "center", gap: 8, fontSize: 12, fontWeight: 700, color: "var(--dsw-alias-label-secondary)", textTransform: "uppercase", letterSpacing: 0.4 },
+    feature: { display: "flex", flexDirection: "column", gap: 4, padding: "8px 10px", borderRadius: 9, border: "1px solid var(--dsw-alias-border-l1)", background: "var(--dsw-alias-bg-layer-1)" },
+    featureTitle: { display: "flex", alignItems: "center", gap: 8, fontSize: 13, fontWeight: 700, wordBreak: "break-all" },
+    specRow: { display: "flex", flexDirection: "column", gap: 3 },
+    specLine: { display: "flex", alignItems: "center", gap: 6, fontSize: 12 },
+    specTitle: { flex: 1, minWidth: 0, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap", cursor: "pointer", border: 0, padding: 0, background: "none", color: "inherit", font: "inherit", textAlign: "left" },
+    specDetail: { margin: 0, paddingLeft: 4, fontSize: 11.5, lineHeight: 1.6, color: "var(--dsw-alias-label-secondary)", borderLeft: "2px solid var(--dsw-alias-border-l2)", display: "flex", flexDirection: "column", gap: 2 },
+    detailLine: { display: "flex", gap: 6, alignItems: "baseline", wordBreak: "break-all" },
+    detailKey: { flex: "0 0 auto", color: "var(--dsw-alias-label-tertiary)" },
+    detailValue: { flex: 1, minWidth: 0, fontFamily: "var(--ds-font-family-code)", fontSize: 11 },
+    copyLink: { border: 0, padding: 0, background: "none", color: "var(--dsw-alias-state-business-primary)", cursor: "pointer", font: "inherit", fontSize: 11 },
+    issue: { display: "flex", flexDirection: "column", gap: 2, padding: "6px 8px", borderRadius: 8, border: "1px solid var(--dsw-alias-border-l1)" },
+    issuePath: { fontSize: 11.5, fontFamily: "var(--ds-font-family-code)", wordBreak: "break-all", color: "var(--dsw-alias-label-secondary)" },
+    issueText: { fontSize: 12, color: "var(--dsw-alias-label-secondary)" },
+    error: { padding: 10, borderRadius: 9, border: "1px solid var(--dsw-alias-state-error-primary)", color: "var(--dsw-alias-state-error-primary)", fontSize: 12, wordBreak: "break-all" },
+    empty: { padding: 12, borderRadius: 9, border: "1px dashed var(--dsw-alias-border-l2)", fontSize: 12, color: "var(--dsw-alias-label-secondary)", lineHeight: 1.6, wordBreak: "break-word" }
+  };
+  async function responseJson(response) {
+    const value = await response.json();
+    const code = value?.error?.code;
+    if (code === "AUTH_REQUIRED") window.dispatchEvent(new CustomEvent("kunpeng-auth-required"));
+    if (!response.ok || value?.ok === false) throw Object.assign(new Error(value?.error?.message ?? value?.error ?? `HTTP ${response.status}`), { code });
+    return value;
+  }
+  function WorkbenchIcon({ size = 16, active = false }) {
+    const color = active ? "var(--dsw-alias-state-business-primary)" : "currentColor";
+    return h(
+      "svg",
+      { width: size, height: size, viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true" },
+      h("path", { d: "M4 5.5h16v4H4v-4Zm0 5.5h9v8H4v-8Zm11 0h5v8h-5v-8Z", stroke: color, strokeWidth: 1.7, strokeLinejoin: "round" })
+    );
+  }
+  function SpecRow({ spec, t, language }) {
+    const [open, setOpen] = useState(false);
+    const [copied, setCopied] = useState(false);
+    const copy = useCallback(async () => {
+      try {
+        await navigator.clipboard?.writeText(spec.path);
+        setCopied(true);
+        setTimeout(() => setCopied(false), 1400);
+      } catch {
+      }
+    }, [spec.path]);
+    return h(
+      "div",
+      { style: styles.specRow },
+      h(
+        "div",
+        { style: styles.specLine },
+        h("span", { style: styles.badge }, spec.type),
+        h("span", { style: styles.lifecycleBadge }, spec.lifecycle),
+        h(
+          "button",
+          { type: "button", style: styles.specTitle, title: t(open ? "hideDetails" : "showDetails"), onClick: () => setOpen(!open) },
+          spec.title || spec.path
+        )
+      ),
+      open ? h(
+        "div",
+        { style: styles.specDetail },
+        h("div", { style: styles.detailLine }, h("span", { style: styles.detailKey }, `${t("specId")}\uFF1A`), h("span", { style: styles.detailValue }, spec.specId || "\u2014")),
+        h("div", { style: styles.detailLine }, h("span", { style: styles.detailKey }, `${t("owner")}\uFF1A`), h("span", { style: styles.detailValue }, spec.owner || "\u2014")),
+        h("div", { style: styles.detailLine }, h("span", { style: styles.detailKey }, `${t("status")}\uFF1A`), h("span", { style: styles.detailValue }, spec.status || "\u2014")),
+        h(
+          "div",
+          { style: styles.detailLine },
+          h("span", { style: styles.detailKey }, `${t("path")}\uFF1A`),
+          h("span", { style: styles.detailValue }, spec.path),
+          h("button", { type: "button", style: styles.copyLink, onClick: () => void copy() }, copied ? t("copied") : t("copy"))
+        ),
+        spec.upstream ? h("div", { style: styles.detailLine }, h("span", { style: styles.detailKey }, `${t("upstream")}\uFF1A`), h("span", { style: styles.detailValue }, spec.upstream)) : null
+      ) : null
+    );
+  }
+  function WorkbenchPane({ t, workspaceSource, load }) {
+    const [state, setState] = useState(null);
+    const [error, setError] = useState(null);
+    const [selectedWorkspaceId, setSelectedWorkspaceId] = useState(null);
+    const subscribeWorkspaces = useCallback((listener) => workspaceSource.subscribe(listener), [workspaceSource]);
+    const readWorkspaces = useCallback(() => workspaceSource.getSnapshot(), [workspaceSource]);
+    const workspaceSnapshot = useSyncExternalStore(subscribeWorkspaces, readWorkspaces);
+    const workspaces = workspaceSnapshot.items ?? [];
+    const selectedWorkspace = workspaces.find((workspace) => workspace.workspaceId === selectedWorkspaceId) ?? workspaces[0] ?? null;
+    const workspaceId = selectedWorkspace?.workspaceId ?? null;
+    const loadState = useCallback(async () => {
+      setError(null);
+      if (workspaceId === null) {
+        setState(null);
+        return;
+      }
+      try {
+        setState(await load(workspaceId));
+      } catch (err) {
+        setState(null);
+        setError(err?.message ?? String(err));
+      }
+    }, [load, workspaceId]);
+    useEffect(() => {
+      void loadState();
+    }, [loadState]);
+    const counts = useMemo(() => ({
+      features: state?.features?.length ?? 0,
+      specs: state?.specs?.length ?? 0,
+      types: state?.types?.length ?? 0,
+      issues: state?.issues?.length ?? 0
+    }), [state]);
+    return h(
+      "div",
+      { style: styles.pane },
+      h(
+        "div",
+        { style: styles.row },
+        h("h3", { style: styles.title }, t("tabTitle")),
+        h("span", { style: styles.grow }),
+        h("button", { type: "button", style: styles.button, disabled: workspaceId === null, onClick: () => void loadState() }, t("refresh"))
+      ),
+      h(
+        "label",
+        { style: styles.muted },
+        `${t("targetWorkspace")}\uFF1A`,
+        h(
+          "select",
+          { value: workspaceId ?? "", disabled: workspaces.length === 0, style: styles.select, onChange: (event) => setSelectedWorkspaceId(event.target.value) },
+          ...workspaces.map((workspace) => h("option", { key: workspace.workspaceId, value: workspace.workspaceId }, workspace.title))
+        )
+      ),
+      workspaceId === null ? h("div", { style: styles.empty }, t("noWorkspace")) : error ? h("div", { style: styles.error }, `${t("failed")}\uFF1A${error}`) : state === null ? h("div", { style: styles.muted }, t("loading")) : h(
+        "div",
+        { style: { display: "flex", flexDirection: "column", gap: 10 } },
+        h("div", { style: styles.muted }, `${counts.features} ${t("featureUnit")} \xB7 ${counts.specs} ${t("specUnit")} \xB7 ${counts.types} ${t("typeUnit")} \xB7 ${counts.issues} ${t("issueUnit")}`),
+        counts.specs === 0 ? h("div", { style: styles.empty }, h("strong", null, t("emptySpecs")), h("div", null, t("emptySpecsBody"))) : h(
+          "div",
+          { style: { display: "flex", flexDirection: "column", gap: 6 } },
+          h("div", { style: styles.sectionHeader }, t("features")),
+          ...state.features.map((feature) => h(
+            "section",
+            { key: feature.featureId, style: styles.feature },
+            h("div", { style: styles.featureTitle }, feature.featureId, h("span", { style: styles.badge }, String(feature.specs.length))),
+            ...feature.specs.map((spec) => h(SpecRow, { key: spec.path, spec, t }))
+          ))
+        ),
+        counts.issues > 0 ? h(
+          "div",
+          { style: { display: "flex", flexDirection: "column", gap: 6 } },
+          h("div", { style: styles.sectionHeader }, t("issues"), h("span", { style: styles.issueBadge }, String(counts.issues))),
+          ...state.issues.map((issue, index) => h(
+            "div",
+            { key: `${issue.path}:${issue.code}:${index}`, style: styles.issue },
+            h("span", { style: styles.issuePath }, issue.path),
+            h("span", { style: styles.issueText }, `${issue.code} \xB7 ${issue.message}`)
+          ))
+        ) : null
+      )
+    );
+  }
+  function WorkbenchTitle({ t }) {
+    return h("span", null, t("tabTitle"));
+  }
+  function WorkbenchEntryButton({ t, open }) {
+    return h(
+      "button",
+      { type: "button", style: styles.iconButton, title: t("entryButton"), "aria-label": t("entryButton"), onClick: open },
+      h(WorkbenchIcon, { size: 15 }),
+      t("tabTitle")
+    );
+  }
+  function apply(ctx) {
+    ctx.effect(() => ctx.locale.register(NS, dictionaries), "kunpeng-job-workbench: dictionaries");
+    const t = ctx.locale.bind(NS);
+    ctx.effect(() => ctx.sidebarRightTabs.register({
+      id: TAB_ID,
+      kind: TAB_KIND,
+      priority: "extension",
+      title: () => t("tabTitle")
+    }), "kunpeng-job-workbench: sidebar tab type");
+    const inject = () => ({
+      t,
+      workspaceSource: ctx.workspaces.list,
+      load: (workspaceId) => fetch(`/kunpeng-workbench/state?workspaceId=${encodeURIComponent(workspaceId)}`, { cache: "no-store" }).then(responseJson)
+    });
+    ctx.slots.inject("sidebar.right.pane.tab", () => ctx.slots.register({ name: "sidebar.right.pane.tab", key: TAB_ID, locale: NS, inject }, WorkbenchPane));
+    ctx.slots.inject("sidebar.right.pane.tab.title", () => ctx.slots.register({ name: "sidebar.right.pane.tab.title", key: TAB_ID, locale: NS, inject: () => ({ t }) }, WorkbenchTitle));
+    ctx.slots.inject("conversation.session.header.utilities", () => ctx.slots.register({
+      name: "conversation.session.header.utilities",
+      id: "kunpeng-job-workbench",
+      order: 46,
+      locale: NS,
+      inject: () => ({ t, open: () => ctx.sidebarRight.openTab(TAB_KIND, {}) })
+    }, WorkbenchEntryButton));
+  }
+  exports.name = "kunpeng-job-workbench-client";
+  exports.inject = ["slots", "locale", "workspaces", "sidebarRight", "sidebarRightTabs", "authManagementClient"];
+  exports.apply = apply;
+  return module.exports;
+} });

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# 鲲鹏特性作业工作台：提供项目级 SPEC 扫描服务。
+- insert:
+    - id: kunpeng-job-workbench
+      name: '@boostkit-dsh/job-workbench'

package/index.js

@@ -0,0 +1,117 @@
+import { existsSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+
+import { createSpecService } from './specs.js'
+
+export const name = 'kunpeng-job-workbench'
+export const inject = ['authManagement']
+
+const API_PREFIX = '/kunpeng-workbench'
+
+/** Match the filesystem Skill provider's upward `.git` project-root discovery. */
+function dshProjectRoot(cwd) {
+  let current = cwd
+  while (true) {
+    if (existsSync(join(current, '.git'))) return current
+    const parent = dirname(current)
+    if (parent === current) return cwd
+    current = parent
+  }
+}
+
+/** Resolve a registered workspace id to the project root DSH scans. */
+function workspaceProjectRoot(ctx, workspaceId) {
+  let registry
+  try { registry = ctx.get?.('workspaceRegistry') } catch { registry = undefined }
+  const workspace = registry?.get?.(workspaceId)
+  if (workspace === undefined || typeof workspace.path !== 'string') throw new Error(`所选 DSH 工作区不存在：${workspaceId}`)
+  return dshProjectRoot(workspace.path)
+}
+
+function sendJson(response, status, payload) {
+  if (response.destroyed || response.writableEnded) return
+  response.writeHead(status, { 'cache-control': 'no-store', 'content-type': 'application/json; charset=utf-8' })
+  response.end(JSON.stringify(payload))
+}
+
+function sendProtectedError(response, error) {
+  if (error?.code === 'AUTH_REQUIRED') return sendJson(response, 401, { ok: false, error: { code: 'AUTH_REQUIRED', message: String(error.message) } })
+  if (error?.code === 'AUTH_UNAVAILABLE') return sendJson(response, 503, { ok: false, error: { code: 'AUTH_UNAVAILABLE', message: String(error.message) } })
+  sendJson(response, 400, { ok: false, error: String(error?.message ?? error) })
+}
+
+function requestedWorkspaceId(value) {
+  return typeof value === 'string' && value.length > 0 && value.length <= 200 ? value : null
+}
+
+/**
+ * Register the SPEC service, the workbench state endpoint and lifecycle cleanup.
+ * An explicit `config.root` keeps the 0.1.0 single-root service shape; without
+ * it, a `forRoot(projectRoot)` facade lazily creates one service per project
+ * root (the UI resolves roots from DSH workspaces).
+ */
+export function apply(ctx, config = {}) {
+  const auth = ctx.get?.('authManagement') ?? ctx.authManagement
+  if (auth === undefined) throw new Error('kunpeng-job-workbench 需要 authManagement 服务')
+  const services = new Map()
+  let disposed = false
+
+  function serviceFor(projectRoot) {
+    const root = resolve(projectRoot)
+    let service = services.get(root)
+    if (service === undefined) {
+      service = createSpecService({ root })
+      services.set(root, service)
+    }
+    return service
+  }
+
+  function disposeAll() {
+    disposed = true
+    for (const service of services.values()) service.dispose()
+    services.clear()
+  }
+
+  if (config.root !== undefined) ctx.provide('kunpengSpecs', serviceFor(config.root))
+  else {
+    ctx.provide('kunpengSpecs', {
+      forRoot(projectRoot) {
+        if (disposed) throw new Error('kunpengSpecs service 已释放')
+        return serviceFor(projectRoot)
+      },
+      roots() { return [...services.keys()] },
+      dispose: disposeAll,
+    })
+  }
+
+  ctx.effect?.(() => () => disposeAll(), 'kunpeng-job-workbench.dispose')
+
+  ctx.inject(['webServer'], (host) => {
+    host.effect(() => {
+      const route = {
+        kind: 'exact',
+        path: `${API_PREFIX}/state`,
+        handler: (request, response) => {
+          if (request.method !== 'GET') { response.writeHead(405, { allow: 'GET' }); response.end(); return }
+          void auth.requireActor().then(() => {
+            let workspaceId = null
+            try {
+              const url = new URL(request.url ?? '', 'http://localhost')
+              workspaceId = requestedWorkspaceId(url.searchParams.get('workspaceId'))
+            } catch { /* invalid request URL */ }
+            if (workspaceId === null) return sendJson(response, 400, { ok: false, error: 'invalid workspaceId' })
+            const projectRoot = config.root === undefined ? workspaceProjectRoot(ctx, workspaceId) : resolve(config.root)
+            const state = serviceFor(projectRoot).scan()
+            sendJson(response, 200, { ok: true, workspaceId, ...state })
+          }).catch((error) => sendProtectedError(response, error))
+        },
+      }
+      const dispose = host.webServer.register(route)
+      return () => dispose()
+    }, 'kunpeng-job-workbench.http')
+  })
+}
+
+export { createSpecService } from './specs.js'
+
+export const __testing = { dshProjectRoot, workspaceProjectRoot }

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@boostkit-dsh/job-workbench",
+  "version": "0.3.1",
+  "type": "module",
+  "description": "扫描项目 SPEC 并派生特性、交付件和校验问题的工作台插件（服务 + 右侧栏面板）",
+  "main": "index.js",
+  "files": [
+    "CHANGELOG.md",
+    "README.md",
+    "client.js",
+    "cordis.patch.yml",
+    "index.js",
+    "specs.js"
+  ],
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitcode.com/lujinxing/kunpeng-dsh-demo.git",
+    "directory": "plugins/job-workbench"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "dependencies": {
+    "@boostkit-dsh/auth-management": "0.1.1"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "market": {
+      "displayName": {
+        "zh": "鲲鹏特性作业工作台",
+        "en": "Kunpeng Feature Workbench"
+      },
+      "category": "kunpeng-rd",
+      "maintainers": [
+        "@lujinxing"
+      ],
+      "compatibility": {
+        "dsh": "0.1.7-alpha.1"
+      },
+      "allowedBuilds": []
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-workspace-controller",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-sidebar-right"
+      ]
+    }
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  }
+}

package/specs.js

@@ -0,0 +1,138 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { join, relative, resolve, sep } from 'node:path'
+
+const TYPE_RE = /^[a-z][a-z0-9-]*$/
+const LIFECYCLES = ['proposed', 'approved', 'rejected', 'archived']
+const BUILTIN_TYPES = [
+  'requirement',
+  'design',
+  'implementation',
+  'verification',
+  'review',
+  'retrospective',
+]
+
+function filesUnder(directory) {
+  if (!existsSync(directory)) return []
+  const files = []
+  for (const entry of readdirSync(directory, { withFileTypes: true })) {
+    const path = join(directory, entry.name)
+    if (entry.isDirectory()) files.push(...filesUnder(path))
+    else if (entry.name.endsWith('.md')) files.push(path)
+  }
+  return files.sort()
+}
+
+function parseHeader(text) {
+  const lines = text.split(/\r?\n/)
+  const title = /^# Feature SPEC:\s*(.+)$/.exec(lines[0] ?? '')?.[1]?.trim() ?? ''
+  const fields = {}
+  for (const line of lines.slice(1, 24)) {
+    const match = /^([A-Za-z][A-Za-z-]*):\s*(.*)$/.exec(line)
+    if (match) fields[match[1].toLowerCase()] = match[2].trim()
+  }
+  return { title, fields }
+}
+
+function relativePath(root, file) {
+  return relative(root, file).split(sep).join('/')
+}
+
+function issue(code, path, message) {
+  return { code, path, message }
+}
+
+export function createSpecService(options = {}) {
+  const projectRoot = resolve(options.root ?? process.cwd())
+  const specsRoot = join(projectRoot, '.agents', 'specs')
+  const customTypes = new Map()
+  let disposed = false
+
+  function knownTypes() {
+    return [...BUILTIN_TYPES, ...customTypes.keys()].sort()
+  }
+
+  function registerType(type, definition = {}) {
+    if (disposed) throw new Error('kunpengSpecs service 已释放')
+    if (!TYPE_RE.test(type)) throw new Error(`SPEC 类型非法：${type}`)
+    if (BUILTIN_TYPES.includes(type) || customTypes.has(type)) throw new Error(`SPEC 类型已存在：${type}`)
+    customTypes.set(type, { type, ...definition })
+    let active = true
+    return () => {
+      if (!active) return
+      active = false
+      customTypes.delete(type)
+    }
+  }
+
+  function scan() {
+    if (disposed) throw new Error('kunpengSpecs service 已释放')
+    const specs = []
+    const issues = []
+    const seenSpecIds = new Map()
+    const allowedTypes = new Set(knownTypes())
+
+    for (const lifecycle of LIFECYCLES) {
+      const lifecycleRoot = join(specsRoot, lifecycle)
+      if (!existsSync(lifecycleRoot)) continue
+      for (const typeEntry of readdirSync(lifecycleRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).sort((left, right) => left.name.localeCompare(right.name))) {
+        const type = typeEntry.name
+        for (const file of filesUnder(join(lifecycleRoot, type))) {
+          const path = relativePath(projectRoot, file)
+          const { title, fields } = parseHeader(readFileSync(file, 'utf8'))
+          const record = {
+            path,
+            title,
+            lifecycle,
+            type,
+            status: fields.status ?? '',
+            featureId: fields.feature ?? '',
+            specId: fields.spec ?? '',
+            owner: fields.owner ?? '',
+            upstream: fields.upstream ?? '',
+          }
+          specs.push(record)
+
+          if (!allowedTypes.has(type)) issues.push(issue('unknown-type', path, `未注册的 SPEC 类型：${type}`))
+          if (record.status !== lifecycle) issues.push(issue('status-mismatch', path, `Status ${record.status || '<missing>'} 与目录 ${lifecycle} 不一致`))
+          if (fields.type !== type) issues.push(issue('type-mismatch', path, `Type ${fields.type || '<missing>'} 与目录 ${type} 不一致`))
+          if (title === '') issues.push(issue('missing-title', path, '缺少 # Feature SPEC 标题'))
+          if (record.featureId === '') issues.push(issue('missing-feature-id', path, '缺少 Feature 字段'))
+          if (record.specId === '') issues.push(issue('missing-spec-id', path, '缺少 Spec 字段'))
+          else if (seenSpecIds.has(record.specId)) issues.push(issue('duplicate-spec-id', path, `Spec ID 与 ${seenSpecIds.get(record.specId)} 重复`))
+          else seenSpecIds.set(record.specId, path)
+        }
+      }
+    }
+
+    const featureMap = new Map()
+    for (const spec of specs) {
+      if (spec.featureId === '') continue
+      if (!featureMap.has(spec.featureId)) featureMap.set(spec.featureId, [])
+      featureMap.get(spec.featureId).push(spec)
+    }
+    const features = [...featureMap.entries()].sort(([left], [right]) => left.localeCompare(right)).map(([featureId, featureSpecs]) => ({
+      featureId,
+      specs: featureSpecs.sort((left, right) => left.path.localeCompare(right.path)),
+    }))
+
+    return {
+      root: relativePath(projectRoot, specsRoot),
+      types: knownTypes(),
+      specs: specs.sort((left, right) => left.path.localeCompare(right.path)),
+      features,
+      issues: issues.sort((left, right) => left.path.localeCompare(right.path) || left.code.localeCompare(right.code)),
+    }
+  }
+
+  return {
+    root: specsRoot,
+    registerType,
+    scan,
+    listTypes: knownTypes,
+    dispose() {
+      disposed = true
+      customTypes.clear()
+    },
+  }
+}