refactor: apply repository naming contract

Apply the accepted pre-release package, service, type, directory, and role renames as one repository-wide change.

packages/client/ui-jobs/src/client/JobListAction.module.css

@@ -0,0 +1,125 @@
+.root {
+  position: relative;
+}
+
+.trigger {
+  display: inline-flex;
+  align-items: center;
+  gap: 3px;
+  min-height: 28px;
+  padding: 3px 2px;
+  border: 0;
+  border-radius: 6px;
+  background: transparent;
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 12px;
+  line-height: 18px;
+  cursor: pointer;
+}
+
+.trigger:hover,
+.trigger:focus-visible {
+  color: var(--dsw-alias-label-secondary);
+}
+
+.trigger svg {
+  transition: transform 120ms ease;
+}
+
+.triggerOpen {
+  transform: rotate(180deg);
+}
+
+.triggerDot {
+  flex: none;
+}
+
+.count {
+  margin: 0 5px;
+}
+
+.menu {
+  position: absolute;
+  top: calc(100% + 5px);
+  left: 0;
+  z-index: 100;
+  box-sizing: border-box;
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+  width: 336px;
+  max-width: min(400px, calc(100vw - 32px));
+  max-height: min(420px, calc(100vh - 140px));
+  margin: 0;
+  padding: 4px;
+  overflow: auto;
+  list-style: none;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 12px;
+  background: var(--dsw-specific-menu);
+  --dsh-scrollbar-thumb: var(--dsw-alias-scrollbar-bg-l2);
+  --dsh-scrollbar-thumb-hover: var(--dsw-alias-scrollbar-hover-l2);
+  box-shadow: var(--dsw-shadow-lv3);
+}
+
+.row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  box-sizing: border-box;
+  width: 100%;
+  min-height: 32px;
+  padding: 6px 8px;
+  border-radius: 8px;
+  color: var(--dsw-alias-label-primary);
+  font-size: 13px;
+  line-height: 18px;
+}
+
+.rowSettled {
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.rowDot {
+  flex: none;
+}
+
+.kind {
+  flex: none;
+  padding: 0 6px;
+  border-radius: 5px;
+  background: var(--dsw-alias-fill-l2);
+  color: var(--dsw-alias-label-secondary);
+  font-size: 11px;
+  line-height: 18px;
+}
+
+.label {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  font-family: var(--dsw-font-mono);
+  white-space: nowrap;
+  text-overflow: ellipsis;
+}
+
+.status,
+.duration {
+  flex: none;
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 11px;
+  line-height: 18px;
+}
+
+/* A failed job's detail is the producer's raw error text, so it has no bound;
+   without this it widens the row past the menu instead of eliding like .label. */
+.status {
+  max-width: 40%;
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+}
+
+.duration {
+  font-variant-numeric: tabular-nums;
+}

packages/client/ui-jobs/src/client/JobListAction.tsx

@@ -0,0 +1,192 @@
+import { useEffect, useMemo, useRef, useState, type KeyboardEvent } from 'react'
+import type { JobView } from '@deepseek-ai/dsh-client-runtime/client'
+import { IconChevronDownOutline14, StateDot, type StateDotState } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { PropsLocale, PropsRuntime, TranslateNS } from '@deepseek-ai/dsh-client-ui-slots'
+import { NS } from './locales.ts'
+import type {} from '@deepseek-ai/dsh-client-ui-conversation/client'
+import css from './JobListAction.module.css'
+
+/** Full props for the session-header background-job action. */
+export type JobListActionProps =
+  PropsRuntime<'conversation.session.header.actions'> & PropsLocale<typeof NS>
+
+/** Stable empty list so a session with no jobs keeps one array identity. */
+const NO_TASKS: readonly JobView[] = []
+
+/** A job the registry still holds open, and whose duration therefore ticks. */
+function isLive(job: JobView): boolean {
+  return job.status === 'running' || job.status === 'stopping'
+}
+
+/** Closed-union exhaustiveness fence for the wire status set. */
+/* v8 ignore next 3 -- closed-union backstop; only reached if a status is forged */
+function assertNever(value: never): never {
+  throw new Error(`unhandled job status: ${JSON.stringify(value)}`)
+}
+
+/**
+ * Status marker semantics. `stopping` and `killed` share the attention color:
+ * both mean the work ended (or is ending) on request rather than on its own.
+ */
+function dotState(status: JobView['status']): StateDotState {
+  switch (status) {
+    case 'running': return 'ongoing'
+    case 'stopping': return 'warning'
+    case 'completed': return 'done'
+    case 'killed': return 'warning'
+    case 'failed': return 'error'
+    /* v8 ignore next -- closed wire status union */
+    default: return assertNever(status)
+  }
+}
+
+/** Human status word for the row and its accessible name. */
+function statusLabel(status: JobView['status'], t: TranslateNS<typeof NS>): string {
+  switch (status) {
+    case 'running': return t('status.running')
+    case 'stopping': return t('status.stopping')
+    case 'completed': return t('status.completed')
+    case 'killed': return t('status.killed')
+    case 'failed': return t('status.failed')
+    /* v8 ignore next -- closed wire status union */
+    default: return assertNever(status)
+  }
+}
+
+/**
+ * Elapsed time in at most two adjacent units. A background job that outlives
+ * an hour is already exceptional, so hours is the widest unit — beyond that the
+ * figure stays in hours rather than growing a day/month vocabulary no producer
+ * currently reaches.
+ */
+function formatDuration(elapsedMs: number, t: TranslateNS<typeof NS>): string {
+  const total = Math.max(0, Math.floor(elapsedMs / 1_000))
+  const seconds = total % 60
+  const minutes = Math.floor(total / 60) % 60
+  const hours = Math.floor(total / 3_600)
+  if (hours > 0) return t('duration.hours', { hours, minutes })
+  if (minutes > 0) return t('duration.minutes', { minutes, seconds })
+  return t('duration.seconds', { seconds })
+}
+
+/**
+ * Live rows first in start order, then settled rows newest-first. Two jobs
+ * that settled in the same millisecond fall back to start order, so the sort
+ * never depends on the host's map iteration.
+ */
+function ordered(jobs: readonly JobView[]): JobView[] {
+  return [...jobs].sort((left, right) => {
+    const liveLeft = isLive(left)
+    if (liveLeft !== isLive(right)) return liveLeft ? -1 : 1
+    if (liveLeft) return left.startedAt - right.startedAt
+    const finished = (right.finishedAt ?? right.startedAt) - (left.finishedAt ?? left.startedAt)
+    return finished !== 0 ? finished : left.startedAt - right.startedAt
+  })
+}
+
+/**
+ * Session-header entry point for this session's background jobs. It renders
+ * nothing at all until the session has at least one job, so an ordinary
+ * conversation never grows a control for a capability it is not using.
+ * @param props - runtime slot currency plus the namespace translator.
+ * @returns the trigger and its popover list, or null when there is nothing to show.
+ */
+export function JobListAction({ sessionId, useSessions, t }: JobListActionProps) {
+  const jobs = useSessions(state => state.jobsBySession[sessionId]) ?? NO_TASKS
+  const [open, setOpen] = useState(false)
+  const [now, setNow] = useState(() => Date.now())
+  const rootRef = useRef<HTMLDivElement>(null)
+  const triggerRef = useRef<HTMLButtonElement>(null)
+
+  const rows = useMemo(() => ordered(jobs), [jobs])
+  const liveCount = useMemo(() => jobs.filter(isLive).length, [jobs])
+
+  useEffect(() => {
+    if (!open) return
+    const closeOutside = (event: PointerEvent): void => {
+      if (event.target instanceof Node && !rootRef.current?.contains(event.target)) {
+        setOpen(false)
+      }
+    }
+    document.addEventListener('pointerdown', closeOutside)
+    return () => { document.removeEventListener('pointerdown', closeOutside) }
+  }, [open])
+
+  // The clock only runs while an open list is showing something that moves.
+  useEffect(() => {
+    if (!open || liveCount === 0) return
+    setNow(Date.now())
+    const timer = setInterval(() => { setNow(Date.now()) }, 1_000)
+    return () => { clearInterval(timer) }
+  }, [open, liveCount])
+
+  // The last job disappearing removes this control; close first so focus does
+  // not vanish from an unmounting node.
+  useEffect(() => {
+    if (jobs.length === 0 && open) setOpen(false)
+  }, [jobs.length, open])
+
+  if (jobs.length === 0) return null
+
+  const countKey = liveCount > 0
+    ? (liveCount === 1 ? 'count.live.one' : 'count.live.other')
+    : (jobs.length === 1 ? 'count.idle.one' : 'count.idle.other')
+  const countLabel = t(countKey, { count: liveCount > 0 ? liveCount : jobs.length })
+
+  const onKeyDown = (event: KeyboardEvent<HTMLDivElement>): void => {
+    if (event.key !== 'Escape' || !open) return
+    event.preventDefault()
+    setOpen(false)
+    triggerRef.current?.focus()
+  }
+
+  return (
+    <div ref={rootRef} className={css.root} onKeyDown={onKeyDown}>
+      <button
+        ref={triggerRef}
+        type="button"
+        className={css.trigger}
+        aria-expanded={open}
+        aria-label={countLabel}
+        onClick={() => {
+          // Sample the clock in the same commit that opens the list: the
+          // mount-time value predates every job, so the first painted frame
+          // would otherwise clamp a long-running row to zero until the
+          // open effect corrects it a frame later.
+          setNow(Date.now())
+          setOpen(current => !current)
+        }}
+      >
+        {liveCount > 0 ? <StateDot state="ongoing" className={css.triggerDot} /> : null}
+        <span className={css.count}>{countLabel}</span>
+        <IconChevronDownOutline14 className={open ? css.triggerOpen : undefined} />
+      </button>
+      {open
+        ? (
+          <ul className={css.menu} aria-label={t('list.aria')}>
+            {rows.map((job) => {
+              const live = isLive(job)
+              const elapsed = live ? now - job.startedAt : (job.finishedAt ?? job.startedAt) - job.startedAt
+              const duration = formatDuration(elapsed, t)
+              const status = statusLabel(job.status, t)
+              return (
+                <li key={job.id} className={live ? css.row : `${css.row} ${css.rowSettled}`}>
+                  <StateDot state={dotState(job.status)} className={css.rowDot} />
+                  <span className={css.kind}>{job.kind}</span>
+                  <span className={css.label} title={job.label}>{job.label}</span>
+                  <span className={css.status} title={job.detail ?? status}>{job.detail ?? status}</span>
+                  <span
+                    className={css.duration}
+                    title={t(live ? 'duration.title.live' : 'duration.title.done', { duration })}
+                  >
+                    {duration}
+                  </span>
+                </li>
+              )
+            })}
+          </ul>
+        )
+        : null}
+    </div>
+  )
+}

packages/client/ui-jobs/src/client/index.ts

@@ -0,0 +1,40 @@
+/**
+ * Background-job plugin, browser half: contributes one session-header action
+ * that renders this session's `ctx.jobs` records. The data arrives entirely
+ * through the `jobsBySession` list mirror, so the plugin issues no RPC and
+ * holds no state of its own beyond popover visibility.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import { JobListAction } from './JobListAction.tsx'
+import type {} from '@deepseek-ai/dsh-client-locale/client'
+import { en, NS, zh, type JobKey } from './locales.ts'
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    /** Background-job list copy. */
+    'job': JobKey
+  }
+}
+
+export type { JobListActionProps } from './JobListAction.tsx'
+
+/** Required services for locale registration and header-slot contribution. */
+export const inject = ['sessions', 'slots', 'locale']
+
+/**
+ * Client plugin body: register the dictionaries and the header action.
+ * @param ctx - client root context.
+ */
+export function apply(ctx: ClientContext): void {
+  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'ui-job: dictionaries')
+  ctx.slots.inject(
+    'conversation.session.header.actions',
+    () => ctx.slots.register({
+      name: 'conversation.session.header.actions',
+      id: 'job-list',
+      // After the subagent catalog: session lineage reads before process work.
+      order: 20,
+      locale: NS,
+    }, JobListAction),
+  )
+}

packages/client/ui-jobs/src/client/locales.ts

@@ -0,0 +1,45 @@
+/** `job` namespace dictionaries. */
+
+/** Dictionary namespace owned by this plugin. */
+export const NS = 'job'
+
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export const zh = {
+  'count.live.one': '{count} 个后台任务运行中',
+  'count.live.other': '{count} 个后台任务运行中',
+  'count.idle.one': '{count} 个后台任务',
+  'count.idle.other': '{count} 个后台任务',
+  'list.aria': '后台任务',
+  'status.running': '运行中',
+  'status.stopping': '正在停止',
+  'status.completed': '已完成',
+  'status.killed': '已取消',
+  'status.failed': '已失败',
+  'duration.seconds': '{seconds}秒',
+  'duration.minutes': '{minutes}分{seconds}秒',
+  'duration.hours': '{hours}小时{minutes}分',
+  'duration.title.live': '已运行 {duration}',
+  'duration.title.done': '耗时 {duration}',
+} as const
+
+/** English dictionary, key-identical to the Chinese source of truth. */
+export const en: Record<JobKey, string> = {
+  'count.live.one': '{count} background job running',
+  'count.live.other': '{count} background jobs running',
+  'count.idle.one': '{count} background job',
+  'count.idle.other': '{count} background jobs',
+  'list.aria': 'Background jobs',
+  'status.running': 'running',
+  'status.stopping': 'stopping',
+  'status.completed': 'completed',
+  'status.killed': 'cancelled',
+  'status.failed': 'failed',
+  'duration.seconds': '{seconds}s',
+  'duration.minutes': '{minutes}m {seconds}s',
+  'duration.hours': '{hours}h {minutes}m',
+  'duration.title.live': 'Running for {duration}',
+  'duration.title.done': 'Took {duration}',
+}
+
+/** Key domain of the `job` namespace (zh is the source of truth). */
+export type JobKey = keyof typeof zh

packages/client/ui-jobs/src/css-modules.d.ts

@@ -0,0 +1,6 @@
+declare module '*.module.css' {
+  const classes: Record<string, string>
+  export default classes
+}
+
+declare module '*.css'

packages/client/ui-jobs/src/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Background-job list plugin, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * dshClient declaration.
+ */
+
+/** Host plugin body — no host-side behavior for this source plugin. */
+export function apply(): void {}

packages/client/ui-jobs/src/invariant.ts

@@ -0,0 +1,32 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-jobs`.
+ * @module @deepseek-ai/dsh-client-ui-jobs/invariant
+ */
+
+/* jscpd:ignore-start */
+import type { Context } from '@deepseek-ai/cordis'
+import type { InvariantInstaller } from '@deepseek-ai/dsh-invariants'
+
+const PACKAGE_NAME = '@deepseek-ai/dsh-client-ui-jobs'
+
+/** Cordis companion plugin name. */
+export const name = 'client-ui-jobs-invariant'
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants']
+
+/**
+ * No runtime invariant: this package is a read-only projection of the
+ * `jobsBySession` mirror onto one header slot entry. It emits no cordis
+ * events, owns no cross-plugin mutable state, and its single slot registration
+ * proves disposal through the HMR-safety spec.
+ */
+const install: InvariantInstaller = () => {}
+
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx: Context): Promise<() => void> =>
+  Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install))
+/* jscpd:ignore-end */