Meridian Hub — стартовое окно и брокер пакета

Документ приложения по соглашениям раздела 8 библии (docs/00-foundation.md). Версия 0.1 · 2026-10-03. Фаза 1 · все редакции, включая Free · своего формата нет · цвет --m-ink #0B3C5D (токен --app-hub в макетах = --m-ink) · значок — логотип пакета · идентификаторы экранов HUB-xx · эталонный макет mockups/hub.html (HUB-01…HUB-04).

Содержание: 1. Назначение и аналоги · 2. Функции · 3. Экраны · 4. Модель данных · 5. Алгоритмы и скрипты · 6. Форматы · 7. Горячие клавиши · 8. Критерии готовности · 9. Риски · 10. Вопросы к библии.

1. Назначение и аналоги

Meridian Hub — две сущности в одном модуле:

1. Стартовое окно (точка входа, лаунчер): недавние и закреплённые файлы, галерея шаблонов, создание документов, облачные подключения, «общие со мной», уведомления, «Что нового», обновления, аккаунт Meridian ID и состояние лицензии, параметры пакета, первый запуск.
2. Брокер (meridian-broker, фоновый процесс без окна): единственный экземпляр на сеанс пользователя; принимает файлы из командной строки/ОС/протокола meridian:// и направляет их в приложения; ведёт недавние, индекс содержимого, миниатюры, облачную синхронизацию, уведомления, журнал автосохранения и восстановление после сбоя, планировщик фоновых задач, проверку и установку обновлений, расширенный буфер обмена между окнами (библия, раздел 6: «общий брокер для буфера, недавних, облака и обновлений»).

Процессная модель (библия 6): каждое окно документа — отдельный процесс приложения (meridian-write, meridian-sheets, …); брокер живёт, пока открыто хотя бы одно окно пакета или включён «быстрый запуск» (значок в трее/меню-баре, опционально); Hub-окно — обычный клиент брокера.

Код: kernel/crates/meridian-hub/ (брокер: IPC, реестр недавних, индекс, планировщик, миниатюры, crash journal), kernel/crates/meridian-update/, kernel/crates/meridian-id/, kernel/crates/meridian-license/ (библия 9.5), shell/src/hub/ (QML/C++: окно Hub, параметры, мастер первого запуска, командная палитра — общий компонент для всех приложений), shell/src/account/ (диалоги входа/активации).

2. Функции

2.1 Стартовое окно

2.2 Брокер

3. Экраны

Каркас окна — по разделу 5.3 библии, но у Hub нет ribbon: заголовок (значок, «Meridian Office», поиск ⌘K, состояние облака, аватар), слева навигация, центр, справа боковая панель, строка состояния («Meridian Office 1.1.3 · Windows» · «Последняя синхронизация 19:12»). HUB-01…HUB-04 соответствуют макету mockups/hub.html один в один.

3.1 Вкладки параметров (HUB-03)

4. Модель данных

4.1 Хранилище профиля

<profile>/                     ← Windows: %LOCALAPPDATA%\Meridian\Office ; macOS: ~/Library/Application Support/Meridian Office ; Linux: $XDG_DATA_HOME/meridian-office
├── hub.db                     ← SQLite (схема ниже), WAL
├── settings.json              ← параметры пакета (без секретов), с подписью политики при управлении организацией
├── index/                     ← tantivy (поиск по содержимому)
├── thumbs/<hash[0..2]>/<hash>.webp   ← миниатюры (256 и 512 px)
├── journals/<app>/<doc-ulid>/ ← журналы автосохранения приложений (ops.log + snapshot.*)
├── templates/                 ← пользовательские шаблоны (.mwt, .mst, …)
├── extensions/<id>/           ← установленные расширения
├── cache/                     ← облачные файлы для автономного доступа (по подключениям), обновления (updates/)
├── logs/                      ← журналы процессов (ротация 7 дней)
└── license.mlic, device.id    ← лицензия и отпечаток (библия 9.3); токены — только в хранилище ОС

4.2 Схема hub.db

PRAGMA journal_mode = WAL; PRAGMA application_id = 0x4D485831; -- 'MHX1'

CREATE TABLE recent (
  id INTEGER PRIMARY KEY, uri TEXT NOT NULL UNIQUE,          -- file:///… | cloud://<account>/<id> | meridian://…
  app TEXT NOT NULL, title TEXT, ext TEXT, size INTEGER, mtime INTEGER,
  last_opened INTEGER NOT NULL, open_count INTEGER DEFAULT 1, device_id TEXT NOT NULL,
  thumb_hash TEXT, location TEXT CHECK(location IN ('local','cloud','shared','removable','network')),
  cloud_account INTEGER REFERENCES cloud_accounts(id) ON DELETE SET NULL, shared_by TEXT,
  favorite INTEGER DEFAULT 0, missing INTEGER DEFAULT 0, removed INTEGER DEFAULT 0, synced INTEGER DEFAULT 0
);
CREATE INDEX recent_opened ON recent(last_opened DESC);
CREATE TABLE pinned (recent_id INTEGER PRIMARY KEY REFERENCES recent(id) ON DELETE CASCADE, ord INTEGER NOT NULL, group_name TEXT);

CREATE TABLE templates (
  id TEXT PRIMARY KEY,                                        -- ulid или стабильный id каталога
  source TEXT NOT NULL CHECK(source IN ('builtin','user','org','online')), app TEXT NOT NULL, path TEXT, url TEXT,
  title TEXT NOT NULL, description TEXT, category TEXT, lang TEXT, tags TEXT, author TEXT, version TEXT,
  updated INTEGER, popularity INTEGER DEFAULT 0, thumb_hash TEXT, favorite INTEGER DEFAULT 0, indexed_at INTEGER
);
CREATE INDEX templates_app_cat ON templates(app, category);

CREATE TABLE cloud_accounts (
  id INTEGER PRIMARY KEY, provider TEXT NOT NULL CHECK(provider IN ('meridian','webdav','onedrive','gdrive','dropbox','yandex')),
  display_name TEXT, account_id TEXT, email TEXT, server_url TEXT, root TEXT,
  credential_ref TEXT NOT NULL,                               -- ключ в хранилище ОС (Keychain/DPAPI/Secret Service); никаких токенов здесь
  state TEXT CHECK(state IN ('ok','auth_required','error','disabled')) DEFAULT 'ok', last_error TEXT,
  quota_used INTEGER, quota_total INTEGER, last_sync INTEGER, delta_cursor TEXT, offline_folders TEXT, rate_limit INTEGER, ord INTEGER
);
CREATE TABLE cloud_items (                                    -- кэш метаданных облачных файлов / cloud metadata cache
  account_id INTEGER REFERENCES cloud_accounts(id) ON DELETE CASCADE, remote_id TEXT, parent_id TEXT, name TEXT, is_dir INTEGER,
  size INTEGER, mtime INTEGER, etag TEXT, local_path TEXT, local_state TEXT CHECK(local_state IN ('none','cached','dirty','conflict')),
  shared_by TEXT, PRIMARY KEY(account_id, remote_id)
);
CREATE INDEX cloud_items_parent ON cloud_items(account_id, parent_id);

CREATE TABLE notifications (
  id INTEGER PRIMARY KEY, ts INTEGER NOT NULL, source TEXT NOT NULL,   -- app id | cloud | update | license | system
  kind TEXT NOT NULL, title TEXT NOT NULL, body TEXT, icon TEXT, actions TEXT,   -- JSON [{id,label,command}]
  uri TEXT, read INTEGER DEFAULT 0, dismissed INTEGER DEFAULT 0, dedupe_key TEXT UNIQUE
);
CREATE INDEX notifications_ts ON notifications(ts DESC);

CREATE TABLE crash_journal (
  id INTEGER PRIMARY KEY, doc_id TEXT NOT NULL UNIQUE, app TEXT NOT NULL, uri TEXT, title TEXT,
  journal_path TEXT NOT NULL, pid INTEGER, started INTEGER, last_write INTEGER, last_heartbeat INTEGER,
  state TEXT CHECK(state IN ('open','closed_clean','crashed','recovered','discarded')) DEFAULT 'open', snapshot_thumb TEXT
);

CREATE TABLE index_state (                                    -- индексация содержимого / content indexing bookkeeping
  uri TEXT PRIMARY KEY, mtime INTEGER, size INTEGER, hash BLOB, indexed_at INTEGER, status TEXT, error TEXT
);
CREATE TABLE index_roots (path TEXT PRIMARY KEY, recursive INTEGER DEFAULT 1, enabled INTEGER DEFAULT 1);

CREATE TABLE tasks (                                          -- планировщик фоновых задач / background scheduler
  id INTEGER PRIMARY KEY, kind TEXT NOT NULL, payload TEXT, priority INTEGER DEFAULT 5,
  state TEXT CHECK(state IN ('queued','running','done','failed','cancelled','deferred')) DEFAULT 'queued',
  not_before INTEGER, attempts INTEGER DEFAULT 0, max_attempts INTEGER DEFAULT 5, last_error TEXT,
  requires TEXT,                                              -- JSON: {network:true, ac_power:false, idle:true}
  created INTEGER, started INTEGER, finished INTEGER, progress REAL
);
CREATE INDEX tasks_state ON tasks(state, priority, not_before);

CREATE TABLE devices (device_id TEXT PRIMARY KEY, name TEXT, os TEXT, last_seen INTEGER, is_this INTEGER);
CREATE TABLE windows (pid INTEGER, window_id TEXT, app TEXT, uri TEXT, title TEXT, opened INTEGER, PRIMARY KEY(pid, window_id));   -- живой реестр, очищается при старте
CREATE TABLE extensions (id TEXT PRIMARY KEY, kind TEXT, name TEXT, version TEXT, author TEXT, path TEXT, enabled INTEGER DEFAULT 1,
                         signature_state TEXT, permissions TEXT, installed INTEGER, update_url TEXT, latest_version TEXT);
CREATE TABLE file_assoc (ext TEXT PRIMARY KEY, app TEXT, registered INTEGER, is_default INTEGER);
CREATE TABLE updates (version TEXT PRIMARY KEY, channel TEXT, manifest TEXT, state TEXT, downloaded_path TEXT, size INTEGER, downloaded INTEGER, verified INTEGER, applied INTEGER, rolled_back INTEGER);
CREATE TABLE kv (key TEXT PRIMARY KEY, value TEXT);          -- мелкие состояния: last_whats_new, first_run_done, index_version…

4.3 Структуры брокера (Rust)

// kernel/crates/meridian-hub/src/broker.rs
pub struct Broker {
    db: Db, ipc: IpcServer, scheduler: Scheduler, index: ContentIndex, thumbs: ThumbCache,
    cloud: CloudManager, notify: Notifier, updates: Updater, session: IdSession, license: LicenseState,
    windows: WindowRegistry, journals: JournalRegistry, clipboard: SharedClipboard, policies: Policies,
}

/// Сообщения IPC (CBOR по сокету) / IPC messages (CBOR over socket)
#[derive(Serialize, Deserialize)]
pub enum Request {
    Hello { app: AppId, pid: u32, version: Version },
    Open { uris: Vec<Uri>, hint: Option<AppId>, activate: bool },
    New { app: AppId, template: Option<TemplateId> },
    RecentTouch { uri: Uri, app: AppId, title: String, size: u64, mtime: i64 },
    RecentList { filter: RecentFilter }, Pin { uri: Uri, pinned: bool },
    JournalOpen { doc_id: Ulid, app: AppId, uri: Option<Uri> }, JournalHeartbeat { doc_id: Ulid }, JournalClose { doc_id: Ulid, clean: bool },
    Notify { notification: Notification }, NotificationsList, NotificationAck { id: i64 },
    CloudList { account: i64, parent: Option<String> }, CloudGet { account: i64, id: String }, CloudPut { account: i64, parent: String, local: PathBuf },
    Search { query: String, scope: SearchScope, limit: u32 },
    Features, Session, SettingsGet { keys: Vec<String> }, SettingsSet { patch: Map },
    WindowRegister { window_id: String, uri: Option<Uri>, title: String }, WindowList, WindowActivate { window_id: String },
    ClipboardPut { formats: Vec<ClipFormat> }, ClipboardGet { format: ClipFormat },
    TaskEnqueue { task: TaskSpec }, TaskCancel { id: i64 },
    UpdateCheck, UpdateApplyOnExit { enable: bool }, Quit { all: bool },
}
#[derive(Serialize, Deserialize)]
pub enum Event { RecentChanged, NotificationsChanged, SettingsChanged { keys: Vec<String> }, FeaturesChanged(Features),
                 CloudStateChanged { account: i64 }, UpdateAvailable(UpdateInfo), SessionChanged, OpenRequest { uris: Vec<Uri> },
                 IndexProgress { done: u64, total: u64 }, TaskProgress { id: i64, progress: f32 } }

5. Алгоритмы и скрипты

5.1 Единственный экземпляр и IPC

• Транспорт: Unix domain socket $XDG_RUNTIME_DIR/meridian-office/broker.sock (Linux), ~/Library/Application Support/Meridian Office/broker.sock (macOS), именованный канал \\.\pipe\meridian-office-<sid> (Windows); кадры — длина (u32 LE) + CBOR (Request/Response/Event), мультиплексирование по request_id, подписка на события; аутентификация — проверка владельца сокета/пайпа (SID/uid) + nonce из файла с правами 0600.
• Запуск: любой исполняемый файл пакета (meridian-write file.docx) → connect_or_spawn():

pub fn connect_or_spawn() -> Result<BrokerClient> {
    let lock = Lock::try_acquire(profile().join("broker.lock"))?;       // flock / LockFileEx
    match lock {
        Lock::Held(_) => {                                              // брокера нет — мы становимся брокером / no broker: become one
            spawn_broker_process()?;                                    // отдельный процесс meridian-broker, lock передаётся ему
        }
        Lock::Busy => {}                                                // брокер есть / broker exists
    }
    // Подключение с повтором до 3 с; при неудаче — сброс устаревшего lock и повторная попытка один раз
    retry(Duration::from_secs(3), || BrokerClient::connect(socket_path()))
}

• Маршрутизация Open: detect_type(uri) — расширение → для ZIP читаем первый элемент mimetype → сигнатуры (PK, %PDF, D0 CF 11 E0 OLE → по внутренним потокам WordDocument/Workbook/PowerPoint Document, SQLite format 3 → Base, From → mbox, BEGIN:VCALENDAR/VCARD) → приложение; если файл уже открыт (windows.uri) — WindowActivate; иначе — запуск процесса приложения с аргументом --broker-token; несколько файлов разных типов — несколько процессов; meridian:// разбирается по схеме meridian://<app>/<action>?<params> (meridian://write/open?path=…, meridian://notes/clip, meridian://hub/template/<id>, meridian://account/activate?key=…).
• Жизненный цикл брокера: завершается через 60 с после закрытия последнего окна, если выключен «быстрый запуск»; при наличии незавершённых задач (загрузка обновления, синхронизация) — после их завершения или по таймауту 10 мин; аварийный выход брокера не трогает окна приложений (они работают автономно и переподключаются с backoff).

5.2 Планировщик фоновых задач с ограничением ресурсов

Scheduler (tokio, N воркеров = min(2, cores/2)):
  очереди по классам: interactive (миниатюры видимых, поиск) > sync (облако, недавние) > index (содержимое) > maintenance (очистка, обновления)
  выбор задачи: наивысший класс с готовой задачей (not_before <= now, requires выполнены), внутри класса — priority, затем FIFO
  requires: network (есть сеть и не «лимитный» тариф — NetworkInformation/SCNetworkReachability/NetworkManager), ac_power (не на батарее < 20 %),
            idle (пользователь неактивен ≥ 30 с — для index/maintenance), not_fullscreen (презентация/игра — пауза)
  ограничение ресурсов: index/maintenance — один воркер, низкий приоритет потока (SCHED_IDLE / BELOW_NORMAL / QOS_CLASS_BACKGROUND),
            IO-троттлинг (ionice idle / IOPOL_THROTTLE / Windows IO priority Low), пауза при CPU пользователя > 60 % 5 с подряд,
            лимит памяти на задачу (песочный процесс кодеков с RLIMIT/Job Object/task_set_limit)
  отказоустойчивость: повтор с backoff 2^attempts мин (макс 6 ч), max_attempts; после — failed с уведомлением (для sync) или тихо (index)
  отмена: cooperative (CancellationToken), прогресс в tasks.progress → Event::TaskProgress
  персистентность: tasks в hub.db; при старте running → queued

5.3 Индексация содержимого документов

• Источники: недавние файлы (всегда), index_roots (папки по выбору пользователя, по умолчанию «Документы»), облачные кэши; исключения (node_modules, скрытые, > 200 МБ, сетевые пути без согласия).
• Наблюдение: notify (inotify/FSEvents/ReadDirectoryChangesW) с дебаунсом 2 с; полный обход корней раз в 24 ч и при старте (сравнение mtime/size с index_state).
• Извлечение текста: задача index запускает песочный процесс кодеков (meridian-codec-host: без сети, ограниченный доступ к файловой системе — только входной файл, лимит памяти 1 ГБ, таймаут 60 с) → текст + метаданные (заголовок, автор, страницы/листы, число слов) → tantivy-документ: uri, app, title (boost 3), body (лимит 5 МБ текста), author, mtime, ext, tags, location; токенайзер meridian_ru_en (общий с Notes).
• Инкрементально: delete_term(uri) + add_document; коммит каждые 5 с или 100 документов; слияние сегментов в maintenance; удалённые файлы — удаление из индекса при обходе.
• Поиск: Search в брокере — объединение tantivy (содержимое) + SQLite (имена, недавние, шаблоны) + реестр команд; результаты ранжируются: точное имя > недавние (свежесть) > BM25 по содержимому; фрагменты — SnippetGenerator; лимит 50.
• Приватность: индекс только локальный, зашифрованные/защищённые документы не индексируются; «Очистить индекс» в параметрах; индексирование можно отключить целиком.

5.4 Генерация миниатюр

• Ключ кэша: BLAKE3(uri ‖ mtime ‖ size); файлы thumbs/<hash>.webp в размерах 256 и 512 px (HiDPI).
• Источник: 1) thumbnail.png из пакета MOP/OOXML/ODF (docProps/thumbnail.jpeg, Thumbnails/thumbnail.png), если есть и свежий; 2) рендер первой страницы/листа/слайда через Meridian Render в песочном процессе (лимит 5 с); 3) PDF — первая страница; изображения — уменьшенная копия; 4) иначе — значок типа.
• Приложения при сохранении обновляют миниатюру через RecentTouch (передают thumb PNG) — тогда рендер не нужен.
• ОС-интеграция (P1): Windows IThumbnailProvider, macOS QuickLook-плагин (.appex), Linux — thumbnailer .thumbnailer — все вызывают тот же рендер через CLI meridian-thumb.

5.5 Слияние недавних между устройствами (Cloud, фаза 6)

sync_recent(local, remote):                                  // remote — список записей из Cloud (по аккаунту)
  ключ = uri для cloud://; для file:// — (device_id, path): локальные пути другого устройства показываются
          как «на устройстве X» (открыть нельзя, но можно найти копию в облаке по cloud_id, если файл синхронизирован)
  объединение по ключу:
    last_opened = max(local, remote); open_count = сумма дельт (CRDT-счётчик по device_id)
    removed (пользователь удалил из списка) — LWW по времени удаления; favorite — LWW
    pinned — порядок как последовательность по устройству-источнику последней правки (LWW на список)
  усечение: 500 записей по last_opened; записи других устройств без cloud_id — не старше 90 дней
  конфликты не блокируют: результат пишется локально, выгружается дельта (только изменённые записи)

5.6 Журнал автосохранения и восстановление

• Приложение при открытии документа регистрирует JournalOpen(doc_id) и пишет журнал операций (библия 6) каждые 2 с в journals/<app>/<doc-ulid>/: ops.log (append-only, CRC на кадр) + периодический snapshot (полная модель) каждые 5 мин или 10 МБ журнала; JournalHeartbeat каждые 10 с.
• Брокер помечает crashed, если процесс исчез (pid не жив) без JournalClose(clean=true); при следующем запуске Hub (или приложения) показывает HUB-05; восстановление = snapshot + воспроизведение ops.log до последнего целого кадра (в приложении).
• Сбой самого брокера: записи open с мёртвыми pid при старте брокера переводятся в crashed.
• Очистка: closed_clean — журнал удаляется через 1 ч (на случай «вернуть несохранённое»), discarded — сразу, recovered — после сохранения документа; лимит на профиль 2 ГБ с вытеснением старых.

5.7 Обновления

check():   GET https://update.meridian-office.<tld>/v1/<channel>/<platform>-<arch>/manifest.json  (ETag; раз в сутки; прокси системный)
           manifest = { version, released, min_from, packages: [{ kind: full|delta, from, url, size, sha256, sig }], notes_url, mandatory, rollout: 0..100 }
           подпись: manifest.sig — Ed25519 (ключ зашит в сборку; резервный — для ротации); проверка ДО разбора JSON
           rollout: hash(device_id) % 100 < rollout → предложить; mandatory → нельзя отложить дольше 7 дней
download(): выбор пакета: delta (from == текущая версия) иначе full; загрузка в cache/updates/ с докачкой (Range), лимит скорости по настройке,
            проверка sha256 и подписи пакета (minisign-совместимая); при ошибке — full
apply():   «при выходе»: когда все окна закрыты (брокер ждёт) или по кнопке «сейчас» (брокер просит окна сохранить и закрыться)
           Windows (MSIX): PackageManager.AddPackageByUriAsync с DeferRegistration → регистрируется при следующем запуске; MSI — msiexec /qn с UAC;
           macOS: распаковка bundle в staging, проверка подписи/нотаризации (codesign --verify, spctl), атомарная замена через rename, перезапуск;
           Linux: Flatpak — `flatpak update` (через portal), AppImage — замена файла + сохранение прав, deb/rpm — уведомление «обновите через менеджер пакетов»
           дельты: формат bidiff/zstd по файлам внутри bundle (список файлов с хэшами «до/после»), применение в staging, затем верификация полного хэша
rollback(): предыдущая версия хранится (MSIX — встроенный откат; macOS — `Meridian Office.app.previous`; AppImage — `.previous`) 1 релиз; «Откатить» в параметрах

Hub после обновления показывает HUB-12 один раз; каналы beta/nightly — отдельный rollout и предупреждение.

5.8 Аккаунт, лицензия и флаги функций

Брокер держит сессию Meridian ID (refresh-токен в хранилище ОС, access — в памяти), раз в 7 дней подтверждает подписку (библия 9.3), читает license.mlic, вычисляет Features и раздаёт процессам при Hello и через Event::FeaturesChanged; окна показывают «замок» по Features::has(Feature::X). Плавающие лицензии (Enterprise, фаза 6): аренда на 1 ч продлевается брокером в фоне. Детали — docs/10-licensing-accounts.md.

5.9 MeridianScript API Hub

Объект App в контексте Hub и объект Meridian.hub из любого приложения (одно и то же API через брокер).

interface HubApp {
  recent: {
    list(opts?: { app?: AppId; limit?: number; location?: 'local'|'cloud'|'shared'; pinnedOnly?: boolean }): Promise<RecentItem[]>;
    pin(uri: string, pinned?: boolean): Promise<void>; remove(uri: string): Promise<void>; clear(): Promise<void>;
    open(uri: string, opts?: { app?: AppId; readOnly?: boolean }): Promise<void>;
    on(event: 'changed', h: () => void): Disposable;
  };
  templates: {
    list(filter?: { app?: AppId; category?: string; lang?: string; source?: 'builtin'|'user'|'org'|'online'; query?: string }): Promise<Template[]>;
    create(templateId: string, opts?: { title?: string; openIn?: 'window'|'tab' }): Promise<DocumentHandle>;
    register(path: string, meta?: { title?: string; category?: string; lang?: string }): Promise<Template>;
    unregister(id: string): Promise<void>; favorite(id: string, on?: boolean): Promise<void>;
  };
  cloud: {
    accounts: CloudAccount[]; connect(provider: 'meridian'|'webdav'|'onedrive'|'gdrive'|'dropbox'|'yandex', opts?: { serverUrl?: string }): Promise<CloudAccount>;
    disconnect(accountId: number): Promise<void>; sync(accountId?: number): Promise<void>;
    list(accountId: number, path?: string): Promise<CloudItem[]>; download(accountId: number, remoteId: string, localPath: string): Promise<void>;
    upload(accountId: number, localPath: string, remoteFolder: string): Promise<CloudItem>; status(): CloudStatus;
    on(event: 'stateChanged'|'syncCompleted', h: (e: { accountId: number }) => void): Disposable;
  };
  notifications: {
    post(n: { title: string; body?: string; icon?: string; uri?: string; actions?: { id: string; label: string }[]; dedupeKey?: string }): Promise<number>;
    list(opts?: { unreadOnly?: boolean; source?: string }): Promise<Notification[]>; markRead(id?: number): Promise<void>; dismiss(id: number): Promise<void>;
    on(event: 'action', h: (e: { id: number; actionId: string }) => void): Disposable;
  };
  search(query: string, scope?: ('files'|'content'|'templates'|'commands'|'settings')[]): Promise<SearchResult[]>;
  launch(app: AppId, opts?: { file?: string; template?: string }): Promise<void>;
  windows: { list(): Promise<WindowInfo[]>; activate(id: string): Promise<void> };
  commands: { register(cmd: { id: string; title: string; keywords?: string[]; shortcut?: string; run: () => void | Promise<void> }): Disposable };
  settings: { get<T = unknown>(key: string): Promise<T>; set(key: string, value: unknown): Promise<void>; on(event: 'changed', h: (keys: string[]) => void): Disposable };
  session: { user: User | null; features: string[]; edition: string; signIn(): Promise<User>; signOut(): Promise<void> };
  updates: { check(): Promise<UpdateInfo | null>; on(event: 'available', h: (u: UpdateInfo) => void): Disposable };
  tasks: { enqueue(spec: { kind: string; payload?: unknown; priority?: number; requires?: Requires }): Promise<number>; cancel(id: number): Promise<void> };
}

Примеры:

// 1. Команда в палитре: открыть вчерашние документы / Palette command: reopen yesterday's documents
Meridian.hub.commands.register({ id: 'my.reopenYesterday', title: 'Открыть вчерашние документы', run: async () => {
  const since = Date.now() - 864e5;
  for (const r of await Meridian.hub.recent.list({ limit: 50 })) if (r.lastOpened.getTime() > since) await Meridian.hub.recent.open(r.uri);
}});

// 2. Регистрация корпоративных шаблонов из общей папки / Register org templates from a shared folder
for (const f of await Meridian.fs.list('//fileserver/templates', { ext: ['.mwt', '.mst', '.mpt'] }))
  await Meridian.hub.templates.register(f.path, { category: 'Корпоративные' });

// 3. Уведомление с действием / Notification with an action
const id = await Meridian.hub.notifications.post({ title: 'Отчёт готов', body: 'Квартальный отчёт собран', actions: [{ id: 'open', label: 'Открыть' }], uri: 'file:///…/Отчёт.mwx' });
Meridian.hub.notifications.on('action', e => { if (e.id === id && e.actionId === 'open') Meridian.hub.recent.open('file:///…/Отчёт.mwx'); });

Скрипты Hub (автозапуск при старте брокера) — только из extensions/ с разрешениями hub.recent, hub.cloud, hub.notifications, fs.read; политика организации может их запретить.

6. Форматы

У Hub нет собственного формата документа. Форматы, которыми он оперирует:

7. Горячие клавиши

8. Критерии готовности

8.1 Hub 1.0 (фаза 1, вместе с Write)

1. Холодный запуск Hub ≤ 1,0 с до интерактивности (SSD, средний ноутбук), брокер ≤ 300 мс; повторное открытие файла из проводника при запущенном брокере — окно приложения ≤ 1,5 с.
2. Единственный экземпляр: 100 параллельных запусков meridian-write file.docx открывают один документ один раз; 10 разных файлов — 10 окон; протокол meridian:// работает на трёх ОС.
3. Недавние: 500 записей, миниатюры для всех форматов библии 3.3 (кэш, рендер в песочнице; падение рендера не ломает Hub); недоступные файлы помечены; вид «Папка».
4. Галерея: ≥ 60 встроенных шаблонов (Write/Sheets/Slides минимум) с миниатюрами, фильтры, предпросмотр, корпоративная папка; поиск по шаблонам ≤ 100 мс.
5. Параметры: все 10 вкладок; изменение темы/плотности применяется ко всем открытым окнам ≤ 200 мс; экспорт/импорт параметров; импорт настроек из MS Office/LibreOffice (словари, автозамена).
6. Первый запуск: мастер 4 шага, ассоциации файлов регистрируются на трёх ОС (MSIX-манифест, Info.plist UTI, .desktop + MIME XML), пробный период активируется.
7. Восстановление: kill -9 приложения с несохранённым документом → HUB-05 предлагает версию не старше 2 с; 100 итераций теста без потерь.
8. Обновления: проверка/загрузка/подпись/дельта/установка при выходе/откат — на трёх ОС (stable и beta); поддельный манифест или пакет отвергаются (тест с неверной подписью).
9. Аккаунт и лицензия: вход, активация ключом, офлайн-активация, отображение редакции, Features у всех окон; без сети и аккаунта Free работает полностью.
10. Облако: WebDAV/Nextcloud (открыть/сохранить/обзор/автономный кэш) и заглушка Meridian Cloud; токены только в хранилище ОС (аудит: grep профиля на токены — пусто).
11. Уведомления: системные тосты на трёх ОС с действиями, центр уведомлений, тишина.
12. Диагностика: архив собирается ≤ 10 с, не содержит содержимого документов и секретов (автотест).
13. Доступность Hub (экранный диктор, клавиатура, высокий контраст) и снимочные тесты HUB-01…HUB-16.

8.2 Hub 1.x

Поиск по содержимому (tantivy, песочный кодек-хост), провайдеры OneDrive/Google Drive/Dropbox/Яндекс Диск, ОС-миниатюры, менеджер расширений, «Что нового», проверка совместимости среды, политики организаций, слияние недавних между устройствами (фаза 6), онлайн-каталог шаблонов (фаза 7).

9. Риски

10. Вопросы к библии

1. Токен цвета Hub. В mds.css/макетах используется --app-hub, в таблице 5.2 библии его нет (Hub = --m-ink). Предлагаем добавить строку --app-hub = #0B3C5D (= --m-ink) для единообразия токенов.
2. Процесс брокера. Библия (раздел 6) называет брокером Hub; здесь уточнено: брокер — отдельный безоконный процесс meridian-broker, окно Hub — его клиент. Если это согласуется с 03-architecture.md, стоит отразить формулировку там.
3. Глобальные сочетания клавиш пакета (быстрая заметка, скриншот в Notes) — регистрирует брокер; просим зафиксировать перечень зарезервированных глобальных сочетаний в разделе 5.3 библии (см. также docs/apps/notes.md, вопрос 10.3).
4. Расширения .mext и схема .mkeys — новые расширения файлов, не входящие в таблицу 3.2 (она про документы); предлагаем отдельную таблицу «служебные форматы» в библии или в 03-architecture.md.
5. Онлайн-каталог шаблонов (templates.meridian-office.<tld>) и сервис обновлений уже есть в 9.4 (update-service); каталог шаблонов как сервис в 9.4 отсутствует — добавить в фазу 7 (магазин).