dsh-background-by-model 0.4.4 → 0.5.0

package/scripts/host-contract-scan.mjs

@@ -1,182 +0,0 @@
-/**
- * Host-contract scan — run this after a dsh upgrade.
- *
- *   pnpm bundle && node scripts/host-contract-scan.mjs [--host <dir>] [--json]
- *
- * The settings page's "Host check" tab answers the same question against the
- * RUNNING host, from the DOM, the host stylesheets and the Cordis services. This
- * answers it with no browser at all, straight from the installed files — which is
- * what makes it runnable in CI, or right after `npm i -g @deepseek-ai/dsh@latest`
- * and before anyone looks at the interface.
- *
- * It exits non-zero the moment a contract target is gone, so a host rename turns
- * into a red build instead of a support report. `src/host-contracts.ts` is the
- * single source of truth for WHAT is checked — this script only drives it, which
- * is why a newly added contract point cannot be forgotten here.
- *
- * It reads the built `lib/host-scan.js` (a node entry of its own) rather than the
- * TypeScript sources: that is the code that actually ships, and it keeps this
- * script runnable by plain `node` with no flags and no loader.
- */
-import { readFile, readdir } from 'node:fs/promises'
-import { dirname, join, resolve } from 'node:path'
-import { fileURLToPath, pathToFileURL } from 'node:url'
-
-const here = dirname(fileURLToPath(import.meta.url))
-const pluginDir = resolve(here, '..')
-
-const exists = async (p) => { try { await readFile(p); return true } catch { return false } }
-
-const scanPath = join(pluginDir, 'lib', 'host-scan.js')
-if (!(await exists(scanPath))) {
-  console.error(`contract scan: ${scanPath} is missing — run "pnpm bundle" first`)
-  process.exit(2)
-}
-const { HOST_CONTRACTS, DSH_FLOOR, checkHostOnDisk, resolveHostRoots, meetsFloor, versionOf } =
-  await import(pathToFileURL(scanPath).href)
-
-const args = process.argv.slice(2)
-const json = args.includes('--json')
-const hostFlag = args.indexOf('--host')
-if (hostFlag >= 0 && args[hostFlag + 1] !== undefined) {
-  process.env.DAB_HOST_ROOT = args[hostFlag + 1]
-}
-
-/**
- * Every installation of the host this machine can reach.
- *
- * A contract holds when ANY of them still contains the literal, because the dsh
- * that is running may not be the one a dev checkout resolves first. The roots the
- * plugin itself would pick come first, then the two layouts this project ships
- * against (a global npm install, and a dsh profile's own node_modules).
- */
-async function hostCandidates() {
-  const found = []
-  const push = (base, origin) => {
-    base = resolve(base)
-    if (!found.some(f => f.base === base)) found.push({ base, origin })
-  }
-  const resolved = await resolveHostRoots(pluginDir)
-  if (resolved.roots !== null) push(resolved.roots.packages, 'resolved')
-  // Two shipped layouts: a global npm install keeps its own `@deepseek-ai` scope
-  // (`dsh` moves to its latest release each time), and the dsh version the profile
-  // actually loads lives in that package's nested node_modules.
-  const roots = []
-  const appData = process.env.APPDATA
-  if (typeof appData === 'string' && appData !== '') roots.push(join(appData, 'npm', 'node_modules', '@deepseek-ai'))
-  const profileDir = process.env.DSH_PROFILE_DIR
-  if (typeof profileDir === 'string' && profileDir !== '') roots.push(join(profileDir, 'node_modules', '@deepseek-ai'))
-  const home = process.env.USERPROFILE ?? process.env.HOME
-  if (typeof home === 'string' && home !== '') roots.push(join(home, '.dsh', 'profiles'))
-  for (const root of roots) {
-    push(root, 'npm scope')
-    push(join(root, 'dsh', 'node_modules', '@deepseek-ai'), 'dsh nested')
-  }
-  return found
-}
-
-const usable = []
-for (const candidate of await hostCandidates()) {
-  // A scope counts only when it holds the UI plugin packages the contracts name.
-  // The runtime package itself may be a sibling (`<scope>/dsh`) or absent — on a
-  // global npm install the version the profile actually loads sits one level down,
-  // in `<scope>/dsh/node_modules/@deepseek-ai`, where `dsh` is NOT repeated — so
-  // requiring `<scope>/dsh/package.json` would reject the only real host on this
-  // machine and report every contract as missing.
-  if (!(await exists(join(candidate.base, 'dsh-client-ui-theme', 'lib', 'client.js')))) continue
-  const named = join(candidate.base, 'dsh', 'package.json')
-  const nested = join(candidate.base, 'dsh-app-boot', 'package.json')
-  const manifest = (await exists(named)) ? named : ((await exists(nested)) ? nested : '')
-  // The served frontend is NOT necessarily a sibling of the package scope: on a
-  // global install the scope lives inside the `dsh` package, so its web frontend
-  // is at `<sourceDir>/dsh-web-frontend`. Prefer wherever that package really is.
-  let frontend = join(candidate.base, 'dsh-web-frontend', 'dist', 'assets')
-  for (const guess of [join(dirname(candidate.base), 'dsh-web-frontend'), join(candidate.base, 'dsh', 'node_modules', '@deepseek-ai', 'dsh-web-frontend')]) {
-    if (await exists(join(guess, 'dist', 'assets'))) { frontend = join(guess, 'dist', 'assets'); break }
-  }
-  usable.push({ ...candidate, manifest, frontend })
-}
-
-if (usable.length === 0) {
-  const report = await checkHostOnDisk(pluginDir, 'en')
-  console.error('contract scan: no installed dsh was found.')
-  if (report.host.note !== '') console.error(`  ${report.host.note}`)
-  console.error('  pass --host <dir containing @deepseek-ai/dsh-app-boot> or set DAB_HOST_ROOT')
-  process.exit(2)
-}
-
-/** How one contract's sources fare in one candidate installation. */
-async function checkOne(contract, candidate) {
-  const bad = []
-  for (const source of contract.sources) {
-    const root = source.root === 'frontend' ? candidate.frontend : candidate.base
-    // `.` names the root directory: the literal is searched across the script and
-    // stylesheet files in it, for targets whose FILE name is not stable.
-    if (source.path === '.') {
-      let names = []
-      try { names = await readdir(root) } catch { /* missing */ }
-      let hit = ''
-      for (const name of names) {
-        if (!/\.(?:js|mjs|cjs|css|html|json)$/i.test(name)) continue
-        try {
-          if ((await readFile(join(root, name), 'utf8')).includes(source.literal)) { hit = name; break }
-        } catch { /* unreadable entry */ }
-      }
-      if (hit === '') bad.push(`${root} — no ${JSON.stringify(source.literal)} in any asset`)
-      continue
-    }
-    const file = source.path.startsWith('src/') ? join(pluginDir, source.path) : join(root, source.path)
-    let text = null
-    try { text = await readFile(file, 'utf8') } catch { /* missing */ }
-    if (text === null) bad.push(`${source.path} — file missing`)
-    else if (!text.includes(source.literal)) bad.push(`${source.path} — no ${JSON.stringify(source.literal)}`)
-  }
-  return bad
-}
-
-const rows = []
-for (const contract of HOST_CONTRACTS) {
-  let best = null
-  for (const candidate of usable) {
-    const bad = await checkOne(contract, candidate)
-    if (bad.length === 0) { best = { candidate, bad: [] }; break }
-    if (best === null || bad.length < best.bad.length) best = { candidate, bad }
-  }
-  rows.push({
-    id: contract.id,
-    group: contract.group,
-    criticality: contract.criticality,
-    target: contract.target,
-    ok: best !== null && best.bad.length === 0,
-    why: best === null ? ['no host found'] : best.bad,
-    where: best === null ? '' : best.candidate.origin,
-  })
-}
-
-const hosts = []
-for (const candidate of usable) {
-  const version = candidate.manifest === '' ? '' : await versionOf(dirname(candidate.manifest))
-  hosts.push({ origin: candidate.origin, path: candidate.base, version, meetsFloor: meetsFloor(version, DSH_FLOOR) })
-}
-
-if (json) {
-  console.log(JSON.stringify({ floor: DSH_FLOOR, hosts, contracts: rows }, null, 2))
-} else {
-  console.log('dsh-background-by-model — host contract scan')
-  console.log(`floor: dsh >=${DSH_FLOOR}`)
-  for (const h of hosts) {
-    const verdict = h.meetsFloor === null ? 'unknown' : h.meetsFloor ? 'ok' : 'BELOW FLOOR'
-    console.log(`host : ${h.version !== '' ? h.version : 'unreadable'}  [${verdict}]  ${h.path}`)
-  }
-  console.log('')
-  let failed = 0
-  for (const row of rows) {
-    if (!row.ok) failed++
-    console.log(`${row.ok ? 'PASS' : 'FAIL'}  ${row.id.padEnd(30)} ${row.target}`)
-    for (const why of row.why) console.log(`      > ${why}`)
-  }
-  console.log('')
-  console.log(`${rows.length - failed}/${rows.length} contracts hold`)
-}
-
-process.exit(rows.some(r => !r.ok) ? 1 : 0)

package/test/host-check.test.mjs

@@ -1,459 +0,0 @@
-/**
- * The host self-check's own tests 鈥?run with
- *
- *   pnpm test
- *
- * Three things are covered, and they are the three that can rot silently:
- *
- *  1. **The contract table holds together** 鈥?unique ids, machine-checkable
- *     sources, a known criticality, and at least one check or an explicit
- *     "documentation only" marker. A contract point added without a source would
- *     otherwise be invisible to the offline scan.
- *  2. **The probe reports what is actually there** 鈥?the whole probe is driven
- *     against a fixture written in the shape of a host DOM, so "the host renamed
- *     `--dsw-specific-menu`" produces exactly the failure the panel claims, and a
- *     surface that is merely off screen produces `n/a` rather than a false alarm.
- *  3. **The UI stylesheet, and the one piece of version logic** 鈥?every `dab-*`
- *     class a component uses is defined in it, and the floor comparison is exact
- *     on the release triple.
- *
- * The tests run against the BUILT node entries (`lib/testing.js`), not the
- * TypeScript sources: `node --test` cannot resolve extensionless relative imports
- * inside a `.ts` file, and asserting on the shipped bundle is the more honest
- * target anyway. `pnpm test` bundles first.
- */
-import { test } from 'node:test'
-import assert from 'node:assert/strict'
-import { dirname, join, resolve } from 'node:path'
-import { fileURLToPath, pathToFileURL } from 'node:url'
-
-const here = dirname(fileURLToPath(import.meta.url))
-const pluginDir = resolve(here, '..')
-const testingPath = join(pluginDir, 'lib', 'testing.js')
-
-const { HOST_CONTRACTS, DSH_FLOOR, probeContracts, verdictOf, meetsFloor, UI_CSS, OWN_SHEET_ATTR, OWN_SHEET_DATASET } =
-  await import(pathToFileURL(testingPath).href)
-
-const { readFile, readdir } = await import('node:fs/promises')
-
-// 鈹€鈹€ 1. the contract table 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
-
-test('contract ids are unique and non-empty', () => {
-  const seen = new Set()
-  for (const c of HOST_CONTRACTS) {
-    assert.ok(c.id.length > 0, 'a contract has an empty id')
-    assert.ok(!seen.has(c.id), `duplicate contract id ${c.id}`)
-    seen.add(c.id)
-  }
-})
-
-test('every contract is machine-checkable', () => {
-  for (const c of HOST_CONTRACTS) {
-    assert.ok(c.target.length > 0, `${c.id} has no target`)
-    assert.ok(c.sources.length > 0, `${c.id} declares no source, so the offline scan cannot see it`)
-    assert.ok(c.usedBy.length > 0, `${c.id} does not say which plugin file reads it`)
-    assert.ok(['core', 'looks', 'label'].includes(c.criticality), `${c.id} has an unknown criticality`)
-    assert.ok(['<=0.1.6', '0.1.7'].includes(c.since), `${c.id} has an unknown "since"`)
-    for (const s of c.sources) {
-      assert.ok(s.literal.length > 0, `${c.id} has a source without a literal`)
-      assert.ok(!s.path.includes('\\'), `${c.id} source path must use forward slashes: ${s.path}`)
-      if (s.path === '.') assert.equal(s.root, 'frontend', `${c.id}: "." only makes sense for the frontend root`)
-    }
-    if (c.checks.length === 0) {
-      // Documentation-only entries are allowed (a legacy alias we still accept),
-      // but they must be the minority and must not claim to be checkable.
-      assert.ok(c.criticality !== 'core', `${c.id} is critical but has no check`)
-    }
-  }
-})
-
-test('critical contracts carry a check that can fail', () => {
-  const critical = HOST_CONTRACTS.filter(c => c.criticality === 'core')
-  assert.ok(critical.length >= 4, 'the model hop and the menu split should be critical')
-  for (const c of critical) {
-    assert.ok(c.checks.length > 0, `${c.id} is critical but nothing verifies it at runtime`)
-  }
-})
-
-// 鈹€鈹€ 2. the probe, against a fixture in the shape of a host DOM 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
-
-/** A DOM stand-in with just enough selector support for the contract checks. */
-function makeDom(host) {
-  /**
-   * `selector 鈫?present`, including attribute and comma-OR forms. A descendant
-   * selector is satisfied when every compound in it is present 鈥?the stand-in has
-   * no tree, and the contracts are written so that "the elements exist" is the
-   * question being asked.
-   */
-  const one = part => {
-    // `*` is the universal selector: always satisfied.
-    if (part === '*') return true
-    if (host.has(part)) return true
-    const attr = /^\[([a-z-]+)\]$/.exec(part)
-    if (attr !== null && host.has(`[${attr[1]}]`)) return true
-    return false
-  }
-  const matches = sel => sel.split(',').map(p => p.trim()).some(
-    part => part.split(/\s+/).every(one),
-  )
-  return {
-    querySelector: sel => (matches(sel) ? { style: {} } : null),
-    // Where the host publishes its palette: `body` in the real client, and the
-    // fixture models exactly that. Reading the document element instead is what
-    // made seven healthy tokens report as empty.
-    tokenRoot: () => ({ style: {} }),
-    // `on` is null for an unscoped token check (the probe reads it off the token
-    // root) and the resolved element otherwise. The fixture answers from its own
-    // table either way 鈥?whether a value is readable is the host's own business,
-    // and that is exactly what the table stands in for.
-    computedValue: (token, _on) => (host.get(`computed:${token}`) ?? ''),
-    styleSheets: () => [],
-  }
-}
-
-/** Selectors for the surfaces that are on screen in every fixture. */
-const CORE_PRESENT = [
-  'div[data-sidebar-right-panel]',
-  'div[role="dialog"][aria-modal="true"][aria-labelledby]',
-  '[data-shell-overlay]',
-  '[data-composer-card]',
-  '[data-cordis-panel]',
-  '[data-chat-flow]',
-  '[data-conversation-scroll]',
-  '[data-conversation-composer-overlay]',
-  '.dab-root',
-  '[data-dockkit-strip]',
-]
-
-/** Every design token the contracts read; each one resolves in a healthy host. */
-const PRESENT_TOKENS = [
-  '--dsw-alias-bg-base',
-  '--dsw-alias-bg-layer-1',
-  '--dsw-alias-bg-layer-2',
-  '--dsw-alias-bg-layer-3',
-  '--dsw-specific-menu',
-  '--dsw-menu-surface-fill',
-  '--dsw-specific-sidebar-fill',
-  '--dsw-specific-input-major',
-  '--dsw-alias-label-caption',
-]
-
-/**
- * The literals the HOST's stylesheets declare. The two halves of a token
- * contract ask different questions 鈥?`rule` = "does the host still declare this
- * name", `computed` = "does it resolve to a value" 鈥?so both are listed.
- */
-const HOST_RULES = [
-  '--dsw-menu-surface-fill', '--dsw-specific-menu', '--dsw-specific-sidebar-fill',
-  '--dsw-specific-input-major', '--dsw-alias-bg-base', '--dsw-alias-bg-layer-1',
-  '--dsw-alias-label-caption',
-  '.md-table-wide', '[data-dockkit-content]', '[data-dockkit-empty]',
-  '[data-dockkit-float]', '[data-sidebar-right-open]', 'data-ds-dark-theme',
-]
-
-/** The one literal only THIS plugin's stylesheet declares (`.dab-card`, `side: 'own'`). */
-const OWN_RULES = ['.dab-card']
-
-/**
- * A stylesheet the probe may read.
- *
- * `own: true` writes this plugin's marker 鈥?the ONLY thing that tells our sheets
- * apart from the host's, since the host's own CSS modules set `data-plugin` on
- * theirs, so a probe keying off that skips the entire host theme.
- *
- * The fixture exposes the attribute the way a REAL element does: `getAttribute`
- * answers the dashed name, and `dataset` only the camel-cased key. Modelling this
- * wrong is how a probe that reads `dataset['data-dab-side']` passes here and
- * silently fails in a browser.
- */
-function sheet(literals, own = false) {
-  const attrs = {}
-  const dataset = {}
-  if (own) {
-    attrs[OWN_SHEET_ATTR] = 'own'
-    dataset[OWN_SHEET_DATASET] = 'own'
-  }
-  return {
-    ownerNode: {
-      dataset,
-      getAttribute: name => (name in attrs ? attrs[name] : null),
-      setAttribute: (name, value) => { attrs[name] = value },
-    },
-    cssRules: literals.map(l => ({ cssText: `.x{color:red}/* ${l} */` })),
-  }
-}
-
-/** The host's sheets plus our own, minus whatever a test removes. */
-function hostStyles(literals = HOST_RULES, ownLiterals = OWN_RULES) {
-  const sheets = [sheet(literals)]
-  if (ownLiterals.length > 0) sheets.push(sheet(ownLiterals, true))
-  return sheets
-}
-
-/**
- * A fixture host: `selectors` are the ones that match, `rules` the literals the
- * host stylesheet declares, and every token in `PRESENT_TOKENS` resolves unless
- * the caller drops it.
- */
-function hostEnv({ ctx, selectors = CORE_PRESENT, rules = HOST_RULES, tokens = PRESENT_TOKENS }) {
-  // A Map, not a Set: the fixture must answer with the token's VALUE, and only a
-  // Map carries one (a Set has no `get`).
-  const host = new Map()
-  for (const s of selectors) host.set(s, true)
-  for (const t of tokens) host.set(`computed:${t}`, '#123456')
-  return { ...makeDom(host), styleSheets: () => hostStyles(rules), ctx }
-}
-
-/**
- * The two states the dock alternates between. In the real DOM they live in
- * different panes (a populated tab host carries `data-dockkit-content`, an empty
- * pane carries `data-dockkit-empty`), and each contract's anchor is what says
- * whether its own attribute can be observed 鈥?so the fixture provides the anchor
- * for every contract it expects to answer, and omits the anchors of the ones it
- * expects to read as n/a.
- */
-const DOCK_POPULATED = [
-  'div[data-sidebar-right-panel]',
-  '[data-dockkit-tab]',
-  '[data-dockkit-content]',
-  '[data-dockkit-empty]',
-]
-const DOCK_EMPTY = ['div[data-sidebar-right-panel]', '[data-dockkit-empty]']
-
-/** The healthy fixtures: nothing missing, every service published. */
-const healthyEnv = (dock = DOCK_POPULATED) => hostEnv({
-  ctx: healthyCtx(),
-  selectors: [...CORE_PRESENT, ...dock],
-})
-
-/** A context publishing the four services the model hop needs. */
-function healthyCtx(overrides = {}) {
-  const face = { subscribe: () => () => {}, getSnapshot: () => ({}) }
-  const services = {
-    sessions: { list: face, binding: () => ({}) },
-    uiSession: { current: face },
-    modelDirectories: { directoryFor: () => ({ store: face }) },
-    ...overrides,
-  }
-  return { get: id => services[id] }
-}
-
-test('a healthy host passes every contract, in either dock state', () => {
-  for (const [name, dock] of [['populated tab', DOCK_POPULATED], ['empty seat', DOCK_EMPTY]]) {
-    const results = probeContracts(healthyEnv(dock), 'en')
-    const failed = results.filter(r => r.status === 'fail')
-    assert.deepEqual(failed.map(r => r.id), [],
-      `unexpected failures with a ${name}: ${failed.map(r => `${r.id}: ${r.reason}`).join('; ')}`)
-    assert.equal(verdictOf({ results, summary: { pass: results.length, fail: 0, skip: 0, total: results.length } }), 'ok')
-  }
-})
-
-test('a renamed menu token fails exactly that contract, and names the symptom', () => {
-  // The 0.1.8 rename: the host stops declaring the token the sticky group
-  // headings paint from. Everything else still answers.
-  const env = hostEnv({ ctx: healthyCtx(), rules: HOST_RULES.filter(l => l !== '--dsw-menu-surface-fill') })
-  const results = probeContracts(env, 'en')
-  const failed = results.filter(r => r.status === 'fail').map(r => r.id)
-  assert.deepEqual(failed, ['token.menuSurface'])
-  const row = results.find(r => r.id === 'token.menuSurface')
-  assert.match(row.reason, /--dsw-menu-surface-fill/)
-  assert.match(row.symptom, /solid band|white band|sticky/i)
-})
-
-test('a renamed token the host still aliases is caught by the rule half', () => {
-  // The 0.1.7 menu split in reverse: the host keeps the OLD name working (aliased)
-  // but stops declaring the new one. `computed` still answers 鈥?which is exactly
-  // how that bug stayed silent 鈥?so the `rule` half is the only thing that can
-  // tell "renamed" from "still there".
-  const env = hostEnv({
-    ctx: healthyCtx(),
-    rules: HOST_RULES.filter(l => l !== '--dsw-menu-surface-fill'),
-  })
-  const results = probeContracts(env, 'en')
-  const row = results.find(r => r.id === 'token.menuSurface')
-  assert.equal(row.status, 'fail')
-  // The computed half would have passed: the token still resolves a value.
-  assert.match(row.detail, /host stylesheet includes/)
-})
-
-test('a host that stops publishing the palette fails the computed half', () => {
-  // The other failure shape: the name is still declared somewhere, but body no
-  // longer carries a value 鈥?the case that made 7 healthy tokens look empty when
-  // the probe read the wrong element.
-  const env = hostEnv({
-    ctx: healthyCtx(),
-    tokens: PRESENT_TOKENS.filter(t => t !== '--dsw-alias-bg-base'),
-  })
-  const results = probeContracts(env, 'en')
-  const row = results.find(r => r.id === 'token.bgBase')
-  assert.equal(row.status, 'fail')
-  assert.match(row.reason, /--dsw-alias-bg-base/)
-})
-
-test('a dropped session service fails the model hop', () => {
-  const env = hostEnv({ ctx: healthyCtx({ sessions: undefined }) })
-  const results = probeContracts(env, 'en')
-  assert.equal(results.find(r => r.id === 'sessions.list').status, 'fail')
-  assert.equal(results.find(r => r.id === 'sessions.binding.projections').status, 'skip')
-})
-
-test('the plugin\'s own token stylesheet cannot make a host check pass', () => {
-  // The situation that produced the 0.1.7 white band: the plugin re-emits the
-  // menu fill itself, so its own sheet declares the token. That re-emission must
-  // never be accepted as evidence about the HOST 鈥?otherwise the check is green
-  // by construction on exactly the host where the token was renamed away.
-  const env = hostEnv({
-    ctx: healthyCtx(),
-    // The host sheet is readable but has moved on: it no longer declares the
-    // menu fill under this name.
-    rules: [],
-  })
-  env.styleSheets = () => [
-    sheet([]), // the host's own, readable, declaring nothing
-    sheet(['--dsw-menu-surface-fill', '--dsw-specific-menu', '.dab-card'], true),
-  ]
-  const results = probeContracts(env, 'en')
-  const byId = id => results.find(r => r.id === id)
-  assert.equal(byId('token.menuSurface').status, 'fail')
-  assert.match(byId('token.menuSurface').reason, /no host stylesheet declares/)
-  assert.equal(byId('token.menuAlias').status, 'fail')
-  // 鈥hile the contract whose other half IS our own sheet still passes: this is
-  // what `side: 'own'` is for, and why the two sides must never be merged.
-  assert.equal(byId('settings.card').status, 'pass')
-})
-
-test('a host sheet carrying data-plugin is not mistaken for ours', () => {
-  // Regression for the probe bug that reported 7 healthy tokens as renamed: the
-  // host's CSS modules ALSO set `data-plugin` on their <style> elements, so a
-  // probe that skips "sheets with data-plugin" skips the host's whole theme.
-  const hostSheet = sheet(['--dsw-alias-bg-base'])
-  hostSheet.ownerNode.dataset.plugin = '@deepseek-ai/dsh-client-ui-theme'
-  const env = hostEnv({ ctx: healthyCtx(), rules: [] })
-  env.styleSheets = () => [hostSheet]
-  const results = probeContracts(env, 'en')
-  assert.equal(results.find(r => r.id === 'token.bgBase').status, 'pass')
-})
-
-test('a closed dock holding only its empty seat is n/a, not a failure', () => {
-  // The state a healthy host sits in most of the time: the dock holds no tab, so
-  // `data-dockkit-content` (a JS-set attribute the host never styles) cannot be
-  // observed at all. It used to read as "no host stylesheet declares it" 鈥?a
-  // perfectly healthy host reported as broken.
-  const env = healthyEnv(DOCK_EMPTY)
-  const results = probeContracts(env, 'en')
-  const byId = id => results.find(r => r.id === id)
-  assert.equal(byId('dockkit.content').status, 'skip')
-  // The empty seat IS on screen here, so its own contract answers.
-  assert.equal(byId('dockkit.empty').status, 'pass')
-  assert.equal(byId('dockkit.float').status, 'skip')
-  assert.deepEqual(results.filter(r => r.status === 'fail').map(r => r.id), [])
-})
-
-test('a renamed dock tab attribute still fails once a tab is open', () => {
-  // The guard must not swallow a real rename: with a tab open the host has to
-  // carry `data-dockkit-content` on the tab host, and if the name moved, say so.
-  // A populated tab is on screen (the host marks the tab chip), but the attribute
-  // the contract names no longer matches anything.
-  const env = hostEnv({
-    ctx: healthyCtx(),
-    selectors: ['div[data-sidebar-right-panel]', '[data-dockkit-tab]'],
-  })
-  const results = probeContracts(env, 'en')
-  const row = results.find(r => r.id === 'dockkit.content')
-  assert.equal(row.status, 'fail')
-  assert.match(row.reason, /data-dockkit-content/)
-})
-
-test('a floating pane missing its flag is a failure while it is on screen', () => {
-  // The float flag is a JS attribute too, so it is only observable when the user
-  // has a pane floated 鈥?and then, if the host stopped setting it, the plugin
-  // would paint that pane like a docked one.
-  const env = hostEnv({
-    ctx: healthyCtx(),
-    selectors: [...CORE_PRESENT, ...DOCK_POPULATED, '[data-sidebar-right-mode="float"]'],
-  })
-  const results = probeContracts(env, 'en')
-  const row = results.find(r => r.id === 'dockkit.float')
-  assert.equal(row.status, 'fail')
-  assert.match(row.reason, /data-dockkit-float/)
-})
-
-test('a surface that is merely off screen is n/a, not a failure', () => {
-  // The app frame and every service are up (the settings section is rendered
-  // inside the frame, so the frame is always there) 鈥?but the conversation view,
-  // the right panel and the Cordis panel are not. Nothing is broken; those
-  // surfaces simply are not there to observe.
-  const env = hostEnv({
-    ctx: healthyCtx(),
-    selectors: ['.dab-root', 'div[role="dialog"][aria-modal="true"][aria-labelledby]', '[data-shell-overlay]'],
-  })
-  const results = probeContracts(env, 'en')
-  const byId = id => results.find(r => r.id === id)
-  assert.equal(byId('chat.flow').status, 'skip')
-  assert.equal(byId('conversation.scroll').status, 'skip')
-  assert.equal(byId('trajectory.root').status, 'skip')
-  assert.equal(byId('rightbar.panel').status, 'skip')
-  assert.equal(byId('cordis.panel').status, 'skip')
-  assert.equal(byId('composer.card').status, 'skip')
-  assert.equal(byId('settings.dialog').status, 'pass')
-  assert.deepEqual(results.filter(r => r.status === 'fail').map(r => r.id), [])
-})
-
-test('a mounted but marker-less surface is a failure, not n/a', () => {
-  // The dialog is open, so the right panel's anchor is off screen 鈥?but the
-  // dialog's own selector still matches. A surface whose anchor IS on screen and
-  // whose selector is not is a rename, and must not read as "not observable".
-  const env = hostEnv({
-    ctx: healthyCtx(),
-    // The dock chrome is mounted (the panel container exists) but the panel
-    // attribute the contract names is gone.
-    selectors: ['.dab-root', '[data-dockkit-strip]'],
-  })
-  const results = probeContracts(env, 'en')
-  const byId = id => results.find(r => r.id === id)
-  assert.equal(byId('rightbar.panel').status, 'fail')
-  assert.match(byId('rightbar.panel').reason, /data-sidebar-right-panel/)
-  assert.equal(byId('chat.flow').status, 'skip')
-})
-
-// 鈹€鈹€ 3. the settings UI's own stylesheet 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
-
-test('every dab-* class a component uses is defined in the UI stylesheet', async () => {
-  const dir = join(pluginDir, 'src', 'client')
-  const files = []
-  const walk = async d => {
-    for (const entry of await readdir(d, { withFileTypes: true })) {
-      const p = join(d, entry.name)
-      if (entry.isDirectory()) await walk(p)
-      else if (entry.name.endsWith('.tsx')) files.push(p)
-    }
-  }
-  await walk(dir)
-  assert.ok(files.length > 0, 'no component sources found')
-
-  const missing = []
-  for (const file of files) {
-    const text = await readFile(file, 'utf8')
-    for (const m of text.matchAll(/(?<![\w-])dab-[a-z0-9-]+/g)) {
-      const cls = m[0]
-      // `--dab-mono` and friends are this plugin's own CSS VARIABLES, not classes.
-      if (text.slice(Math.max(0, m.index - 2), m.index) === '--') continue
-      if (UI_CSS.includes(`.${cls}`)) continue
-      if (missing.some(x => x.cls === cls && x.file === file)) continue
-      missing.push({ cls, file: file.slice(pluginDir.length + 1) })
-    }
-  }
-  assert.deepEqual(missing, [], `classes used but never styled: ${missing.map(m => `${m.cls} (${m.file})`).join(', ')}`)
-})
-
-// 鈹€鈹€ 4. the floor comparison 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
-
-test('the floor comparison is coarse on purpose and exact on the triple', () => {
-  assert.equal(meetsFloor('0.1.7-rc.2', DSH_FLOOR), true, 'the floor itself satisfies the floor')
-  assert.equal(meetsFloor('0.1.7', DSH_FLOOR), true)
-  assert.equal(meetsFloor('0.2.0', DSH_FLOOR), true)
-  assert.equal(meetsFloor('1.0.0', DSH_FLOOR), true)
-  assert.equal(meetsFloor('0.1.6', DSH_FLOOR), false)
-  assert.equal(meetsFloor('0.1.0', DSH_FLOOR), false)
-  assert.equal(meetsFloor('not-a-version', DSH_FLOOR), null)
-})