tensorgrid-ui 1.0.0

package/lib/index.js

@@ -0,0 +1,151 @@
+/**
+ * Host-половина пакета Obsidian / Ion.
+ *
+ * Две задачи. Первая — быть строкой композиции: именно через неё
+ * `@deepseek-ai/dsh-client-modules` обходит дерево плагинов, находит секцию
+ * `dsh.client` в package.json и отдаёт браузеру `client.js`.
+ *
+ * Вторая — подменить иконку. Внутри страницы это не решается: и вкладка,
+ * и PWA-манифест ссылаются на один адрес `/favicon.svg`, а манифест —
+ * отдельный статический файл, до которого правкой HTML не добраться. Зато
+ * контракт веб-сервера прямо говорит, что статику фронтенда обслуживает
+ * fallback-место (`registerFallback`), а именованные маршруты матчатся
+ * раньше него. Поэтому один точный маршрут перехватывает обоих
+ * потребителей сразу.
+ *
+ * Импортов здесь намеренно нет: строка композиции загружается раньше, чем
+ * о пакете что-либо известно, и неразрешимый импорт уронил бы весь ряд.
+ */
+
+/**
+ * Знак TG. Контуры продублированы из `lib/client.js` осознанно: половины не
+ * делят модули, а host обязан оставаться без импортов. Совпадение контуров
+ * между половинами проверяет дымовой тест.
+ */
+const BRAND_VIEWBOX = '245 230 1047 566'
+const BRAND_PATHS = [
+  'M315 278H929L766 404H626Q620 404 620 410V724C620 737 610 748 597 748H516C503 748 493 738 493 725V411Q493 404 486 404H317C303 404 293 394 293 380V302C293 288 303 278 315 278Z',
+  'M968 278H1126C1190 278 1244 333 1244 402V421Q1244 435 1230 435H1128Q1117 435 1117 424Q1117 404 1099 404H889C867 404 849 422 849 444V604C849 625 866 638 887 638H1086C1103 638 1115 627 1115 611V572Q1115 564 1107 564H954C943 564 935 556 935 546V493C935 482 943 474 954 474H1225C1236 474 1244 483 1244 494V619C1244 691 1192 748 1121 748H847C778 748 724 696 724 625V510C724 475 733 455 755 438L968 278Z',
+]
+
+/**
+ * Иконка вкладки. Цвет переключает медиазапрос внутри самого SVG — тем же
+ * приёмом, что и поставочная иконка. Тему приложения фавиконка видеть не
+ * может, только схему ОС, поэтому здесь это единственный доступный способ.
+ */
+const FAVICON =
+  `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${BRAND_VIEWBOX}" width="1047" height="566" role="img" aria-label="TENSOR GRID">` +
+  '<style>path{fill:#0B0D12}@media (prefers-color-scheme:dark){path{fill:#FFFFFF}}</style>' +
+  BRAND_PATHS.map((d) => `<path d="${d}"/>`).join('') +
+  '</svg>'
+
+export const name = 'tensorgrid-ui'
+
+/**
+ * Занимает точный маршрут иконки, когда веб-сервер вообще есть. Через
+ * `ctx.inject` — чтобы пакет спокойно монтировался и в профиле без
+ * браузера: там эта часть просто не активируется.
+ * @param ctx - Host-контекст композиции.
+ */
+export function apply(ctx) {
+  ctx.inject(['webServer'], (web) => {
+    web.effect(() =>
+      web.webServer.register({
+        kind: 'exact',
+        path: '/favicon.svg',
+        handler(_req, res) {
+          res.writeHead(200, {
+            'content-type': 'image/svg+xml; charset=utf-8',
+            'cache-control': 'no-cache',
+          })
+          res.end(FAVICON)
+        },
+      }),
+    )
+
+    // Состояние обновлений держим в памяти: проверка ходит в сеть и в git,
+    // и дёргать её на каждый рендер настроек незачем.
+    let cached = null
+
+    // Модуль проверки грузится с ключом по времени правки файла.
+    //
+    // Без этого обновление не может обновить само себя: ESM кеширует
+    // модуль по адресу, и после замены файла Host продолжал бы работать по
+    // старой логике до перезапуска. Ключ меняется только когда файл
+    // действительно изменился, поэтому лишних копий в памяти не остаётся.
+    async function loadModule() {
+      const path = new URL('./update-check.js', import.meta.url)
+      let version = ''
+      try {
+        const { statSync } = await import('node:fs')
+        version = `?v=${statSync(path).mtimeMs}`
+      } catch {
+        version = ''
+      }
+      return import(`${path.href}${version}`)
+    }
+
+    async function refresh() {
+      const module = await loadModule()
+      cached = await module.collectStatus()
+      return cached
+    }
+
+    // Проверка при старте — отложенная. Поднимать приложение она не
+    // задерживает, а к моменту, когда пользователь откроет настройки,
+    // ответ уже готов.
+    const timer = setTimeout(() => {
+      refresh().catch((error) => {
+        cached = { problem: `проверка не удалась: ${String(error?.message ?? error)}`, checkedAt: new Date().toISOString() }
+      })
+    }, 8000)
+    web.effect(() => () => clearTimeout(timer))
+
+    function reply(res, code, value) {
+      const body = JSON.stringify(value)
+      res.writeHead(code, {
+        'content-type': 'application/json; charset=utf-8',
+        'cache-control': 'no-store',
+      })
+      res.end(body)
+    }
+
+    web.effect(() =>
+      web.webServer.register({
+        kind: 'exact',
+        path: '/api/tensorgrid.update',
+        async handler(req, res) {
+          try {
+            if (req.method === 'GET') {
+              // force=1 обходит кеш: кнопка «проверить» должна спрашивать заново.
+              const fresh = String(req.url ?? '').includes('force=1')
+              reply(res, 200, fresh || cached === null ? await refresh() : cached)
+              return
+            }
+
+            if (req.method === 'POST') {
+              // Запись требует JSON-заголовка: браузер не отправит такой
+              // запрос с чужой страницы без предварительной проверки CORS,
+              // а она на этот маршрут не настроена. Для инструмента,
+              // слушающего только петлевой интерфейс, этого достаточно.
+              const contentType = String(req.headers['content-type'] ?? '')
+              if (!contentType.includes('application/json')) {
+                reply(res, 415, { ok: false, problem: 'ожидается content-type: application/json' })
+                return
+              }
+              const module = await loadModule()
+              const result = await module.applyUpdate()
+              cached = result.status ?? cached
+              reply(res, result.ok ? 200 : 409, result)
+              return
+            }
+
+            reply(res, 405, { ok: false, problem: 'поддерживаются GET и POST' })
+          } catch (error) {
+            reply(res, 500, { ok: false, problem: String(error?.message ?? error) })
+          }
+        },
+      }),
+    )
+  })
+}

package/lib/update-check.js

@@ -0,0 +1,216 @@
+/**
+ * Проверка и применение обновлений — Host-сторона.
+ *
+ * Обновления приходят с двух сторон: от разработчика (новый коммит) и от
+ * DeepSeek (новая версия dsh в npm). Каналы независимы, и опасен второй без
+ * первого: пакет опирается на контракты dsh, и если их никто не проверил,
+ * поломка обнаружится у пользователя.
+ *
+ * Поэтому здесь НЕ предлагается обновить dsh самостоятельно. Показывается
+ * только то, что выпустил разработчик, — а он выпускает версию уже с
+ * отметкой, на какой версии dsh она проверена.
+ *
+ * Импортируются только встроенные модули Node: строка композиции грузится
+ * раньше, чем о пакете что-либо известно, и неразрешимый импорт уронил бы
+ * весь ряд.
+ */
+import { execFile } from 'node:child_process'
+import { readFile } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+/** Запуск команды с жёстким таймаутом: висящий git не должен держать проверку. */
+function run(command, args, cwd, timeout = 20000) {
+  return new Promise((resolve) => {
+    execFile(command, args, { cwd, timeout, windowsHide: true, shell: false }, (error, stdout, stderr) => {
+      resolve({
+        ok: !error,
+        stdout: String(stdout ?? '').trim(),
+        stderr: String(stderr ?? '').trim(),
+        message: error === null || error === undefined ? null : String(error.message ?? error),
+      })
+    })
+  })
+}
+
+/**
+ * Каталог профиля: отсюда `lib/index.js` лежит в
+ * `<профиль>/packages/<пакет>/lib/`. Поднимаемся, пока не найдём отметку об
+ * установке — так путь не зависит от того, как назван пакет.
+ */
+function findProfileRoot(startDir) {
+  let dir = startDir
+  for (let depth = 0; depth < 6; depth += 1) {
+    if (existsSync(join(dir, 'tensorgrid-installed.json'))) return dir
+    const parent = dirname(dir)
+    if (parent === dir) break
+    dir = parent
+  }
+  return null
+}
+
+async function readStamp(profileRoot) {
+  if (profileRoot === null) return null
+  try {
+    const text = await readFile(join(profileRoot, 'tensorgrid-installed.json'), 'utf8')
+    // BOM срезается намеренно: файл может быть записан инструментом
+    // Windows, а JSON.parse на строке с \uFEFF падает — и проверка
+    // обновлений молча решила бы, что установки не было.
+    return JSON.parse(text.replace(/^\uFEFF/, ''))
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Состояние обновлений. Ничего не меняет.
+ * @returns сведения об установленной и доступной версиях плюс причина, если проверить не удалось.
+ */
+export async function collectStatus() {
+  const here = dirname(fileURLToPath(import.meta.url))
+  const profileRoot = findProfileRoot(here)
+  const stamp = await readStamp(profileRoot)
+
+  const status = {
+    installedCommit: stamp?.commit ?? null,
+    installedAt: stamp?.installedAt ?? null,
+    dshExpected: stamp?.dshPinned ?? null,
+    dshActual: stamp?.dshActual ?? null,
+    source: stamp?.source ?? null,
+    available: null,
+    behind: 0,
+    updateAvailable: false,
+    canUpdate: false,
+    problem: null,
+    checkedAt: new Date().toISOString(),
+  }
+
+  if (stamp === null) {
+    status.problem = 'нет отметки об установке — запустите install.ps1'
+    return status
+  }
+  if (status.source === null || !existsSync(status.source)) {
+    status.problem = 'каталог с исходниками недоступен; обновление через интерфейс невозможно'
+    return status
+  }
+
+  // git fetch трогает сеть, но рабочее дерево не меняет: посмотреть, что
+  // выпущено, можно не забирая изменений.
+  const fetched = await run('git', ['fetch', '--quiet', 'origin'], status.source, 30000)
+  if (!fetched.ok) {
+    status.problem = `не удалось связаться с репозиторием: ${fetched.stderr || fetched.message || 'неизвестно'}`
+    return status
+  }
+
+  const head = await run('git', ['rev-parse', '--short', 'HEAD'], status.source)
+  const remote = await run('git', ['rev-parse', '--short', 'origin/HEAD'], status.source)
+  const remoteRef = remote.ok ? 'origin/HEAD' : 'origin/main'
+  const remoteShort = remote.ok ? remote.stdout : (await run('git', ['rev-parse', '--short', remoteRef], status.source)).stdout
+
+  status.available = remoteShort || null
+
+  // Сравнивается УСТАНОВЛЕННОЕ с выпущенным, а не рабочая копия с сервером.
+  //
+  // Разница принципиальна на машине разработчика: он коммитит в ту же
+  // рабочую копию, поэтому она всегда совпадает с сервером, а установленный
+  // продукт при этом может отставать на десяток коммитов. Но и у сотрудника
+  // это важно: `git pull` без запуска установщика обновляет исходники, не
+  // трогая то, что реально работает.
+  const installed = status.installedCommit
+  if (installed === null || installed === 'неизвестно') {
+    status.problem = 'не удалось определить установленную версию — переустановите'
+    return status
+  }
+
+  if (installed === status.available) {
+    status.behind = 0
+    status.updateAvailable = false
+  } else {
+    // Разные хеши — ещё не повод обновляться. Установленное может
+    // ОПЕРЕЖАТЬ выпущенное: так выглядит машина разработчика, который уже
+    // поставил себе то, что ещё не запушил. Решает направление, а не факт
+    // расхождения.
+    const behind = await run('git', ['rev-list', '--count', `${installed}..${remoteRef}`], status.source)
+    const ahead = await run('git', ['rev-list', '--count', `${remoteRef}..${installed}`], status.source)
+
+    if (!behind.ok) {
+      // Установленного коммита нет в истории — например, ветку переписали.
+      // Сравнить нечем, но молчать нельзя.
+      status.behind = 0
+      status.updateAvailable = true
+      status.unknownHistory = true
+    } else {
+      status.behind = Number.parseInt(behind.stdout, 10) || 0
+      status.ahead = ahead.ok ? Number.parseInt(ahead.stdout, 10) || 0 : 0
+      status.updateAvailable = status.behind > 0
+    }
+  }
+
+  // Обновлять можно только из чистого дерева: иначе git pull упрётся в
+  // локальные правки, а разбираться с этим из интерфейса нечем.
+  const dirty = await run('git', ['status', '--porcelain'], status.source)
+  const isDirty = dirty.ok && dirty.stdout.length > 0
+  status.canUpdate = status.updateAvailable && !isDirty && head.ok
+  if (status.updateAvailable && isDirty) {
+    status.problem = 'в каталоге с исходниками есть несохранённые правки — обновление через интерфейс отключено'
+  }
+
+  return status
+}
+
+/**
+ * Забирает новую версию и переустанавливает. Возвращает отчёт и признак
+ * того, достаточно ли перезагрузки страницы.
+ */
+export async function applyUpdate() {
+  const status = await collectStatus()
+  if (!status.canUpdate) {
+    return { ok: false, problem: status.problem ?? 'обновлять нечего', status }
+  }
+
+  const before = await run('git', ['rev-parse', 'HEAD'], status.source)
+  const pulled = await run('git', ['pull', '--ff-only'], status.source, 60000)
+  if (!pulled.ok) {
+    return { ok: false, problem: `git pull не удался: ${pulled.stderr || pulled.message}`, status }
+  }
+  const after = await run('git', ['rev-parse', 'HEAD'], status.source)
+
+  // Что именно изменилось, решает, хватит ли перезагрузки страницы.
+  // Браузерный бандл читается при загрузке страницы, а host-половина,
+  // патч-слой и пресет — только при старте приложения.
+  const changed = await run('git', ['diff', '--name-only', before.stdout, after.stdout], status.source)
+  const files = changed.ok ? changed.stdout.split('\n').map((line) => line.trim()).filter(Boolean) : []
+  const needsRestart = files.some((file) =>
+    file === 'lib/index.js' || file.startsWith('profile/') || file.startsWith('preset/') || file === 'install.ps1',
+  )
+
+  const installer = join(status.source, 'install.ps1')
+  if (!existsSync(installer)) {
+    return { ok: false, problem: `не найден установщик: ${installer}`, status }
+  }
+
+  const installed = await run(
+    'powershell',
+    ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', installer, '-NoAutostart'],
+    status.source,
+    180000,
+  )
+  if (!installed.ok) {
+    return {
+      ok: false,
+      problem: 'установщик завершился с ошибкой',
+      detail: (installed.stdout || installed.stderr || '').split('\n').slice(-12).join('\n'),
+      status,
+    }
+  }
+
+  return {
+    ok: true,
+    from: before.stdout.slice(0, 7),
+    to: after.stdout.slice(0, 7),
+    files: files.length,
+    needsRestart,
+    status: await collectStatus(),
+  }
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "tensorgrid-ui",
+  "version": "1.0.0",
+  "description": "TENSOR GRID — фирменный интерфейс поверх DeepSeek Harness: палитра, живой ambient-слой, айдентика и русский язык-пакет",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tayyarg07/tensorgrid-ui.git"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-theme"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "SEE LICENSE IN LICENSE"
+}