@objectivex666/dsh-settings-search 1.0.0 → 1.1.0

package/README.en.md

@@ -0,0 +1,91 @@
+# dsh-settings-search
+
+> Instant search for the DSH (Cordis) settings panel — quickly locate settings pages and general settings items.
+
+[![npm version](https://img.shields.io/npm/v/@objectivex666/dsh-settings-search)](https://www.npmjs.com/package/@objectivex666/dsh-settings-search)
+[![license](https://img.shields.io/npm/l/@objectivex666/dsh-settings-search)](./LICENSE)
+[![node](https://img.shields.io/node/v/@objectivex666/dsh-settings-search)](https://nodejs.org)
+
+**English** · [中文](./README.md)
+
+---
+
+## Features
+
+- 🔍 **Live search** — a search box at the top of the settings panel's left navigation filters every registered settings page (`settings.section`) and general item (`settings.general.item`) as you type.
+- 🧭 **Navigation guidance** — clicking a result shows which left-navigation entry owns that setting, so you can jump straight to it.
+- 🌐 **i18n** — built-in Chinese/English dictionaries that follow the DSH localization system and are easy to extend.
+- 🎨 **Theme-aware** — styled entirely with CSS variables, automatically following the DSH theme (light/dark).
+- ⚡ **Reactive** — subscribes to settings entries being added, removed, or changed, and refreshes results automatically.
+
+---
+
+## Installation (command line)
+
+This plugin is a standard **DSH profile bundle**: once installed it wires itself into the settings panel — no manual edits to any DSH configuration file.
+
+### Prerequisites
+
+- **DeepSeek Harness (DSH)** — any release that ships the web UI (`dsh web`).
+- **Node.js** >= 18 (LTS recommended).
+
+### From npm (recommended)
+
+```bash
+dsh plugin --profile web add @objectivex666/dsh-settings-search
+```
+
+### From GitHub
+
+```bash
+dsh plugin --profile web add github:objectivex666/dsh-settings-search
+```
+
+### From a local checkout (development)
+
+```bash
+dsh plugin --profile web add /path/to/dsh-settings-search
+```
+
+After installing, **restart DSH** (`dsh web`); the search box appears at the top of the settings panel.
+
+To uninstall: `dsh plugin --profile web remove @objectivex666/dsh-settings-search`.
+
+> For a non-`web` profile, replace `--profile web` with your profile name.
+
+---
+
+## Manual wiring (when not using the command line)
+
+Add the package to your profile's dependencies and declare it as a bundle layer (`dsh plugin add` does both for you):
+
+```yaml
+# your profile's cordis.patch.yml (or pass it via --patch)
+- insert:
+    - id: settings-search
+      name: '@objectivex666/dsh-settings-search'
+```
+
+The package ships its own `cordis.patch.yml` (that exact content), which `dsh plugin add` applies automatically.
+
+---
+
+## Package layout
+
+```
+lib/index.js        Host half (no-op — makes the package a valid Cordis plugin row)
+lib/client.js       Browser half (search UI, __ModuleLoader__ format)
+cordis.patch.yml    Composition patch: inserts the settings-search plugin row
+scripts/check.mjs   Structural self-checks (npm test)
+dsh-settings-search.js  Dynamic-plugin source (optional: in-session cordis_define usage)
+```
+
+## Development
+
+```bash
+npm test   # validates the host half, the dsh.client manifest, and the client bundle handoff
+```
+
+## Dynamic-plugin usage (optional)
+
+Legacy usage: register the contents of `dsh-settings-search.js` as `code.client` through DSH's dynamic plugin system (`cordis_define`) — session-only and temporary. For anything persistent, use the profile-bundle install above.

package/README.md

@@ -1,2 +1,93 @@
-# dsh-settings-search
-A plugin that adds a search box to the DSH settings panel.
+# dsh-settings-search
+
+> 为 DSH（Cordis）设置面板提供即时搜索能力，快速定位设置页与通用设置项。
+
+[![npm version](https://img.shields.io/npm/v/@objectivex666/dsh-settings-search)](https://www.npmjs.com/package/@objectivex666/dsh-settings-search)
+[![license](https://img.shields.io/npm/l/@objectivex666/dsh-settings-search)](./LICENSE)
+[![node](https://img.shields.io/node/v/@objectivex666/dsh-settings-search)](https://nodejs.org)
+
+**中文** · [English](./README.en.md)
+
+---
+
+## 功能特性
+
+- 🔍 **实时搜索**：在设置面板左侧导航顶部嵌入搜索框，输入关键词立即过滤所有已注册的设置页（`settings.section`）与通用设置项（`settings.general.item`）。
+- 🧭 **导航引导**：点击搜索结果后，显示该设置所在导航项的标签，帮助用户快速定位。
+- 🌐 **多语言支持**：内置中英文国际化，可跟随 DSH 本地化系统扩展。
+- 🎨 **主题适配**：完全使用 CSS 变量，自动跟随 DSH 主题（亮/暗）。
+- ⚡ **动态响应**：实时订阅设置项的新增/删除/变更，搜索结果自动刷新。
+
+---
+
+## 安装（命令行）
+
+本插件是一个标准的 **DSH profile bundle**：安装后自动写入设置面板，
+无需手动修改任何 DSH 配置文件。
+
+### 前置要求
+
+- **DeepSeek Harness (DSH)**：任意包含 Web 界面（`dsh web`）的版本。
+- **Node.js** >= 18（推荐 LTS）。
+
+### 通过 npm 安装（推荐）
+
+```bash
+dsh plugin --profile web add @objectivex666/dsh-settings-search
+```
+
+### 通过 GitHub 安装
+
+```bash
+dsh plugin --profile web add github:objectivex666/dsh-settings-search
+```
+
+### 本地源码安装（开发调试）
+
+```bash
+dsh plugin --profile web add /path/to/dsh-settings-search
+```
+
+安装完成后**重启 DSH**（`dsh web`），打开设置面板即可看到顶部的搜索框。
+卸载：`dsh plugin --profile web remove @objectivex666/dsh-settings-search`。
+
+> 非 `web` profile 请把命令中的 `--profile web` 换成你的 profile 名。
+
+---
+
+## 手动接线（不通过命令行安装时）
+
+把本包加入 profile 依赖并声明为 bundle 层即可（`dsh plugin add` 会自动完成）：
+
+```yaml
+# 你的 profile 的 cordis.patch.yml（或通过 --patch 传入）
+- insert:
+    - id: settings-search
+      name: '@objectivex666/dsh-settings-search'
+```
+
+包内自带 `cordis.patch.yml`（本文件内容），`dsh plugin add` 会自动应用。
+
+---
+
+## 包结构
+
+```
+lib/index.js        Host half（空实现，保证作为合法 Cordis 插件行加载）
+lib/client.js       Browser half（搜索框 UI，__ModuleLoader__ 格式）
+cordis.patch.yml    组合补丁：插入 settings-search 插件行
+scripts/check.mjs   结构自检（npm test）
+dsh-settings-search.js  动态插件源（可选：DSH 会话内 cordis_define 用法）
+```
+
+## 开发
+
+```bash
+npm test   # 校验 host 半、dsh.client 清单、client bundle handoff
+```
+
+## 动态插件用法（可选）
+
+旧版用法：把 `dsh-settings-search.js` 的内容作为 `code.client` 通过 DSH 的
+动态插件系统（`cordis_define`）注册，仅供会话内临时使用；命令行安装请使用
+上文的 profile bundle 方式。

package/cordis.patch.yml

@@ -0,0 +1,9 @@
+# dsh-settings-search bundle layer: applied automatically when the package is
+# installed into a DSH profile (`dsh plugin add @objectivex666/dsh-settings-search`
+# or `dsh plugin add github:objectivex666/dsh-settings-search`), because the
+# manifest declares `dsh.bundle.patch`. No manual cordis.patch.yml edits are
+# needed. Later layers (the profile's own cordis.patch.yml, --patch overlays)
+# override these rows by id.
+- insert:
+    - id: settings-search
+      name: '@objectivex666/dsh-settings-search'

package/dsh-settings-search.js

@@ -1,9 +1,10 @@
 /**
- * settings-search 插件源文件（set-1 / pkg-4，正在运行）
+ * settings-search 动态插件源文件（legacy，仅会话内临时使用）
  *
  * 说明：
  * - 这是 DSH 动态 Cordis 插件（Client half）的源码，通过 cordis_define 注册到运行中的
- *   DSH 进程，不落盘；此文件是手动导出的副本，供查看 / 复用。
+ *   DSH 进程，不落盘。仅供会话内临时使用；命令行安装请改用本仓库的 profile bundle
+ *   形态（`dsh plugin add`，见 README），其浏览器半位于 lib/client.js，与本文件等价。
  * - 功能：在设置面板左侧导航栏顶部（settings.header 槽，priority:-1 shadow）添加搜索框，
  *   输入关键词实时搜索所有已注册设置页（settings.section）与通用设置项
  *   （settings.general.item），浮层展示结果，点击后显示左侧导航定位引导。

package/lib/client.js

@@ -0,0 +1,205 @@
+/**
+ * dsh-settings-search — browser half.
+ *
+ * Registered as a DSH client module: the package's `dsh.client` declaration
+ * makes the web app load this bundle (`/plugins/@objectivex666/dsh-settings-search/client.js`),
+ * where `window.__ModuleLoader__.load({ id, factory })` registers the code
+ * and the client kernel adopts the exported `{ apply, inject }` as the
+ * plugin's browser half.
+ *
+ * Behavior (identical to the dynamic-plugin source, `dsh-settings-search.js`):
+ * embed a live search box at the top of the settings panel's left navigation
+ * (`settings.header`, priority -1), filtering every registered settings page
+ * (`settings.section`) and general item (`settings.general.item`), with a
+ * navigation guide on selection.
+ */
+window.__ModuleLoader__.load({
+  id: '@objectivex666/dsh-settings-search',
+  factory: (require) => {
+    const module = { exports: {} }
+    const exports = module.exports
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+    const React = require('react')
+
+    const NS = 'settings-search-v4'
+    const zh = {
+      title: '设置',
+      placeholder: '搜索设置…',
+      empty: '没有匹配的设置',
+      pages: '设置页',
+      rows: '通用设置项',
+      guide: '该设置位于左侧导航「{label}」，点击左侧导航项即可打开',
+      page: '设置页',
+      row: '设置项',
+    }
+    const en = {
+      title: 'Settings',
+      placeholder: 'Search settings…',
+      empty: 'No matching settings',
+      pages: 'Settings pages',
+      rows: 'General items',
+      guide: 'This setting lives in "{label}" — open it from the left navigation',
+      page: 'Page',
+      row: 'Item',
+    }
+
+    const CSS = `
+      .sss-wrap { position: relative; display: flex; flex-direction: column; gap: 8px; }
+      .sss-title { font-size: 16px; font-weight: 500; line-height: 24px; }
+      .sss-box { position: relative; display: flex; align-items: center; }
+      .sss-icon { position: absolute; left: 9px; display: block; opacity: .6; pointer-events: none; }
+      .sss-input { width: 100%; box-sizing: border-box; padding: 6px 26px 6px 28px; border-radius: 8px; border: 1px solid var(--dsw-alias-border-l1); background: var(--dsw-alias-bg-layer-1); color: var(--dsw-alias-label-primary); font-size: 13px; line-height: 20px; outline: none; }
+      .sss-input:focus { border-color: var(--dsw-alias-brand-primary); }
+      .sss-input::placeholder { color: var(--dsw-alias-label-secondary); opacity: .8; }
+      .sss-clear { position: absolute; right: 6px; border: none; background: none; color: var(--dsw-alias-label-secondary); cursor: pointer; font-size: 11px; padding: 2px 4px; }
+      .sss-clear:hover { color: var(--dsw-alias-label-primary); }
+      .sss-pop { position: absolute; top: calc(100% + 6px); left: 0; right: 0; z-index: 20; background: var(--dsw-alias-bg-overlay); border: 1px solid var(--dsw-alias-border-l1); border-radius: 10px; box-shadow: var(--dsw-shadow-lv3); padding: 6px; max-height: 300px; overflow: auto; }
+      .sss-groups { display: flex; flex-direction: column; gap: 8px; }
+      .sss-group-title { font-size: 11px; color: var(--dsw-alias-label-secondary); letter-spacing: .05em; padding: 2px 6px; }
+      .sss-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 2px; }
+      .sss-item { display: flex; align-items: center; gap: 6px; padding: 7px 8px; border-radius: 7px; cursor: pointer; }
+      .sss-item:hover { background: var(--dsw-alias-interactive-bg-hover); }
+      .sss-item-label { flex: 1; min-width: 0; color: var(--dsw-alias-label-primary); font-size: 13px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+      .sss-item-id { font-size: 10px; color: var(--dsw-alias-label-secondary); flex-shrink: 0; }
+      .sss-empty { margin: 0; padding: 10px 8px; color: var(--dsw-alias-label-secondary); font-size: 13px; }
+      .sss-guide { padding: 7px 10px; border-radius: 8px; background: var(--dsw-alias-bg-layer-1); border: 1px solid var(--dsw-alias-border-l1); color: var(--dsw-alias-label-primary); font-size: 12px; line-height: 18px; }
+    `
+    let stylesInstalled = false
+    function installStyles() {
+      if (stylesInstalled || typeof document === 'undefined') return
+      stylesInstalled = true
+      const tag = document.createElement('style')
+      tag.dataset.plugin = '@objectivex666/dsh-settings-search'
+      tag.dataset.pluginCss = '@objectivex666/dsh-settings-search/panel'
+      tag.textContent = CSS
+      document.head.appendChild(tag)
+      return () => {
+        tag.remove()
+        stylesInstalled = false
+      }
+    }
+
+    const resolveLabel = (entry) => {
+      const raw = entry.options.label
+      if (typeof raw === 'function') return String(raw())
+      return raw == null ? '' : String(raw)
+    }
+
+    function apply(ctx) {
+      ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'settings-search: dictionaries')
+      const t = ctx.locale.bind(NS)
+      const removeStyles = installStyles()
+      if (typeof removeStyles === 'function') ctx.effect(removeStyles, 'settings-search: styles')
+
+      const readSections = () => ctx.slots.entries('settings.section')
+        .filter((e) => e.options.id !== 'settings-search')
+        .map((e) => ({ id: e.options.id, order: e.options.order ?? 0, label: resolveLabel(e) }))
+        .sort((a, b) => a.order - b.order)
+      const readRows = () => ctx.slots.entries('settings.general.item')
+        .map((e) => ({ id: e.options.id, order: e.options.order ?? 0, label: resolveLabel(e) }))
+        .sort((a, b) => a.order - b.order)
+
+      const SearchIcon = React.createElement('svg', {
+        className: 'sss-icon',
+        viewBox: '0 0 16.5 16.5',
+        width: 13,
+        height: 13,
+        xmlns: 'http://www.w3.org/2000/svg',
+        'aria-hidden': 'true',
+      }, [
+        React.createElement('path', {
+          d: 'M11.894845 6.647401C11.894845 3.725463 9.534486 1.356779 6.623219 1.35657C3.711786 1.35657 1.351635 3.725338 1.351635 6.647401C1.351843 9.569296 3.711911 11.938273 6.623219 11.938273C9.534361 11.938064 11.894637 9.569171 11.894845 6.647401ZM13.245462 6.647401C13.245254 10.317935 10.280401 13.293613 6.623219 13.293821C2.965871 13.293821 0.000204 10.31806 0 6.647401C0 2.976574 2.965746 0 6.623219 0C10.280526 0.000205 13.245462 2.9767 13.245462 6.647401Z',
+          fill: 'currentColor',
+        }),
+        React.createElement('path', {
+          d: 'M16.000417 15.041079L15.044449 16.000433L11.530434 12.473588L12.486298 11.514234L16.000417 15.041079Z',
+          fill: 'currentColor',
+        }),
+      ])
+
+      function SettingsHeaderSearch() {
+        const [query, setQuery] = React.useState('')
+        const [open, setOpen] = React.useState(false)
+        const [sections, setSections] = React.useState(readSections)
+        const [rows, setRows] = React.useState(readRows)
+        const [selected, setSelected] = React.useState(null)
+        React.useEffect(() => {
+          const refresh = () => {
+            setSections(readSections())
+            setRows(readRows())
+          }
+          const offs = [
+            ctx.slots.subscribe('settings.section', refresh),
+            ctx.slots.subscribe('settings.general.item', refresh),
+            ctx.locale.subscribe(refresh),
+          ]
+          return () => { for (const off of offs) off() }
+        }, [])
+
+        const q = query.trim().toLowerCase()
+        const tokens = q.split(/\s+/).filter(Boolean)
+        const match = (label, id) => tokens.every((tok) => (label + ' ' + id).toLowerCase().includes(tok))
+        const shownSections = tokens.length ? sections.filter((s) => match(s.label, s.id)) : []
+        const shownRows = tokens.length ? rows.filter((r) => match(r.label, r.id)) : []
+        const none = tokens.length > 0 && shownSections.length === 0 && shownRows.length === 0
+
+        const renderItem = (item, kind) => React.createElement('li', {
+          key: item.id,
+          className: 'sss-item',
+          onMouseDown: () => { setSelected(item); setOpen(false) },
+        }, [
+          React.createElement('span', { className: 'sss-item-label' }, item.label || item.id),
+          React.createElement('span', { className: 'sss-item-id' }, kind),
+        ])
+
+        return React.createElement('div', { className: 'sss-wrap' }, [
+          React.createElement('div', { className: 'sss-title' }, t('title')),
+          React.createElement('div', { className: 'sss-box' }, [
+            SearchIcon,
+            React.createElement('input', {
+              className: 'sss-input',
+              value: query,
+              placeholder: t('placeholder'),
+              spellCheck: false,
+              onChange: (e) => { setQuery(e.target.value); setOpen(true) },
+              onFocus: () => setOpen(true),
+              onBlur: () => setOpen(false),
+            }),
+            query !== '' ? React.createElement('button', {
+              className: 'sss-clear',
+              type: 'button',
+              onClick: () => { setQuery(''); setSelected(null); setOpen(false) },
+            }, '✕') : null,
+          ]),
+          open && tokens.length > 0 ? React.createElement('div', { className: 'sss-pop' }, [
+            none
+              ? React.createElement('p', { className: 'sss-empty' }, t('empty'))
+              : React.createElement('div', { className: 'sss-groups' }, [
+                  shownSections.length > 0 ? React.createElement('div', { className: 'sss-group' }, [
+                    React.createElement('div', { className: 'sss-group-title' }, t('pages')),
+                    React.createElement('ul', { className: 'sss-list' }, shownSections.map((s) => renderItem(s, t('page')))),
+                  ]) : null,
+                  shownRows.length > 0 ? React.createElement('div', { className: 'sss-group' }, [
+                    React.createElement('div', { className: 'sss-group-title' }, t('rows')),
+                    React.createElement('ul', { className: 'sss-list' }, shownRows.map((r) => renderItem(r, t('row')))),
+                  ]) : null,
+                ]),
+          ]) : null,
+          selected !== null
+            ? React.createElement('div', { className: 'sss-guide' }, t('guide').replace('{label}', selected.label || selected.id))
+            : null,
+        ])
+      }
+
+      ctx.slots.inject('settings.header', () => ctx.slots.register({
+        name: 'settings.header',
+        priority: -1,
+        locale: NS,
+      }, SettingsHeaderSearch))
+    }
+
+    exports.apply = apply
+    exports.inject = ['slots', 'locale']
+    return module.exports
+  },
+})

package/lib/index.js

@@ -0,0 +1,22 @@
+/**
+ * dsh-settings-search — host half.
+ *
+ * This plugin is client-only: every feature lives in the browser half
+ * (`./client` export, `lib/client.js`). This host half exists so the package
+ * is a *valid* Cordis plugin row when installed as a DSH profile bundle
+ * (`dsh plugin add @objectivex666/dsh-settings-search`): the profile
+ * composition loads the package's main entry as a plugin, and the bundle's
+ * `dsh.client` declaration tells the web app to fetch and mount the browser
+ * half. A no-op host is all that is required here.
+ */
+
+/** Plugin row id used by cordis.patch.yml (also the settings-nav id filter). */
+export const name = 'settings-search'
+
+/**
+ * Host half entry point. Nothing to do on the host — the search UI lives in
+ * the browser and needs no host services or RPC.
+ */
+export function apply() {
+  // client-only plugin; intentionally empty on the host
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@objectivex666/dsh-settings-search",
-  "version": "1.0.0",
-  "description": "DSH settings panel search plugin – instantly filter setting sections and general items with navigation guidance.",
+  "version": "1.1.0",
+  "description": "DSH settings panel search plugin – instantly filter setting sections and general items with navigation guidance. Installable via `dsh plugin add`.",
   "keywords": [
     "dsh",
     "cordis",
@@ -21,23 +21,43 @@
   },
   "license": "GPL-3.0",
   "author": "objectivex666",
-  "type": "commonjs",
-  "main": "dsh-settings-search.js",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
   "files": [
+    "lib",
+    "cordis.patch.yml",
+    "scripts",
     "dsh-settings-search.js",
     "README.md",
+    "README.en.md",
     "LICENSE"
   ],
-  "peerDependencies": {
-    "cordis": "^3.0.0 || ^4.0.0"
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ]
+    }
   },
   "engines": {
     "node": ">=18"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "node scripts/check.mjs"
   },
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/scripts/check.mjs

@@ -0,0 +1,61 @@
+/**
+ * Structural smoke checks for the installable package (run via `npm test`):
+ *  1. the host half loads as ESM and exports a Cordis plugin (`apply`);
+ *  2. the manifest carries the DSH bundle wiring (`dsh.bundle.patch`,
+ *     `dsh.client.platform`, `exports["./client"]`);
+ *  3. the client bundle registers the correct module id and its factory
+ *     materializes to `{ apply, inject }` under a stub module table.
+ */
+import { readFileSync } from 'node:fs'
+import vm from 'node:vm'
+
+const pkgUrl = new URL('../package.json', import.meta.url)
+const pkg = JSON.parse(readFileSync(pkgUrl, 'utf8'))
+let failed = 0
+const check = (cond, msg) => {
+  if (cond) return
+  failed += 1
+  console.error(`FAIL: ${msg}`)
+}
+
+// 1. host half
+const host = await import('../lib/index.js')
+check(typeof host.apply === 'function', 'lib/index.js must export apply(ctx)')
+
+// 2. manifest
+check(pkg.dsh?.bundle?.patch, 'dsh.bundle.patch is missing')
+check(pkg.dsh?.client?.platform === 'web', 'dsh.client.platform must be "web"')
+const clientExport = pkg.exports?.['./client']
+check(typeof clientExport === 'string', 'exports["./client"] must be a string path')
+check(typeof pkg.exports?.['./cordis.patch.yml'] === 'string', 'exports["./cordis.patch.yml"] must be a string path')
+check(Array.isArray(pkg.dsh.client.inject) && pkg.dsh.client.inject.every((i) => typeof i === 'string'),
+  'dsh.client.inject must be a string array')
+
+// 3. client bundle handoff
+const source = readFileSync(new URL(`../${clientExport}`, import.meta.url), 'utf8')
+let handoff = null
+const sandbox = {
+  window: {
+    __ModuleLoader__: { load: (h) => { handoff = h } },
+  },
+}
+vm.createContext(sandbox)
+vm.runInContext(source, sandbox, { filename: clientExport })
+check(handoff !== null, `client bundle must call window.__ModuleLoader__.load(...)`)
+check(handoff?.id === pkg.name, `client module id must equal the package name (${pkg.name}), got ${handoff?.id}`)
+const stubRequire = (spec) => {
+  if (spec === 'react') {
+    return { createElement: () => null, useState: () => [], useEffect: () => {} }
+  }
+  throw new Error(`unexpected require in client factory: ${spec}`)
+}
+const client = handoff.factory(stubRequire)
+check(typeof client.apply === 'function', 'client half must export apply(ctx)')
+check(Array.isArray(client.inject) && client.inject.includes('slots') && client.inject.includes('locale'),
+  'client half inject must include "slots" and "locale"')
+
+if (failed > 0) {
+  console.error(`${failed} check(s) failed`)
+  process.exit(1)
+}
+console.log(`ok: ${pkg.name}@${pkg.version} — host half, manifest, and client handoff are valid`)