meta-sovereign 0.49.18 → 0.51.0

package/README.hi.md

@@ -55,9 +55,13 @@ node js/bin/meta-sovereign.js serve
 
 Package npm पर publish होने के बाद `npx -y meta-sovereign serve` (या `npm install -g meta-sovereign && meta-sovereign serve`) काम करेगा। तब तक toolchain के बिना server चलाने का तरीका desktop app (ऊपर) है।
 
-दोनों backend default रूप से <http://127.0.0.1:8787> पर listen करते हैं। JS server hosted app के origin (`https://link-foundation.github.io`) को CORS headers के साथ जवाब देता है; दूसरे origins `meta-sovereign serve --allow-origin=<origins>` या `MS_ALLOW_ORIGINS` से allow करें। Safari `https` pages को `http://127.0.0.1` तक नहीं पहुँचने देता, लेकिन `https://127.0.0.1` तक पहुँचने देता है; server अब उसी port पर HTTPS का भी जवाब देता है और इसके लिए localhost का अपना certificate बनाता है। एक बार `node js/bin/meta-sovereign.js trust` चलाएँ (macOS login keychain में जोड़ता है; दूसरे systems पर certificate का path print होता है) या Safari में `https://127.0.0.1:8787/trust` खोलें और prompts follow करें — उसके बाद hosted app Safari में सीधे server से connect हो जाता है। Trust से पहले notice server का नाम दिखाता है, उसकी copy (<http://127.0.0.1:8787>) और **सर्वर पर भरोसा करें** (<https://127.0.0.1:8787/trust>) का link देता है। `--tls=false` / `MS_TLS=off` HTTPS बंद करता है; server की अपनी copy fallback रहती है। Hosted SPA `discoverServer()` से local server खोजता है (saved override → `127.0.0.1` ports)। अगर browser auto-connect नहीं करता, app में **Settings → Server** खोलें और binary द्वारा print किया गया URL paste करें।
+दोनों backend default रूप से <http://127.0.0.1:8787> पर listen करते हैं। JS server hosted app के origin (`https://link-foundation.github.io`) को CORS headers के साथ जवाब देता है; दूसरे origins `meta-sovereign serve --allow-origin=<origins>` या `MS_ALLOW_ORIGINS` से allow करें। Safari `https` pages को `http://127.0.0.1` तक नहीं पहुँचने देता, लेकिन `https://127.0.0.1` तक पहुँचने देता है; server अब उसी port पर HTTPS का भी जवाब देता है और इसके लिए localhost का अपना certificate बनाता है। एक बार `node js/bin/meta-sovereign.js trust` चलाएँ (macOS login keychain में जोड़ता है; दूसरे systems पर certificate का path print होता है) या Safari में `https://127.0.0.1:8787/trust` खोलें और prompts follow करें — उसके बाद hosted app Safari में सीधे server से connect हो जाता है। Trust से पहले notice server का नाम और **सर्वर पर भरोसा करें** (<https://127.0.0.1:8787/trust>) दिखाता है; localhost UI का link तभी मिलता है जब वह स्पष्ट रूप से enable हो। `--tls=false` / `MS_TLS=off` HTTPS बंद करता है। Safari trusted local HTTPS API से hosted app उपयोग करता है; localhost UI वैकल्पिक है। Hosted SPA `discoverServer()` से local server खोजता है (saved override → `127.0.0.1` ports)। अगर browser auto-connect नहीं करता, app में **Settings → Server** खोलें और binary द्वारा print किया गया URL paste करें।
 
-Default UI hosted app है: `serve` उसका पता छापता है, <https://link-foundation.github.io/meta-sovereign/>, और app हमारे port 8787 पर server को खुद ढूँढ लेता है (वह 8788, 7001, 7002 और 3000 भी देखता है; किसी दूसरे port पर `serve` बताता है कि उसे **Settings → Server** में set करें), इसलिए server को web site host नहीं करनी पड़ती। <http://127.0.0.1:8787> पर उसकी अपनी copy Safari और बिना internet काम के लिए fallback रहती है; `serve --local-ui=false` (या `MS_LOCAL_UI=off`) उसे बंद करता है, और तब `/` hosted app खोलता है। `--ui-url=<url>` (या `MS_UI_URL`) कोई दूसरी hosted copy बताता है, जैसे किसी fork का Pages, और उसके origin को अनुमति देता है।
+Default UI hosted app है: `serve` उसका पता छापता है, <https://link-foundation.github.io/meta-sovereign/>, और app हमारे port 8787 पर server को खुद ढूँढ लेता है (वह 8788, 7001, 7002 और 3000 भी देखता है; किसी दूसरे port पर `serve` बताता है कि उसे **Settings → Server** में set करें), इसलिए server को web site host नहीं करनी पड़ती। Default रूप से `/` GitHub Pages पर redirect करता है और server केवल API, sync transports और connection helpers देता है। बिना internet के लिए localhost web app वैकल्पिक है: `serve --local-ui=true` (या `MS_LOCAL_UI=on`) से enable करें; फिर वह <http://127.0.0.1:8787> पर मिलता है। Desktop shell अपना bundled UI स्पष्ट रूप से enable करता है। `--ui-url=<url>` (या `MS_UI_URL`) कोई दूसरी hosted copy बताता है, जैसे किसी fork का Pages, और उसके origin को अनुमति देता है।
+
+macOS पर interactive `serve` पूरा setup करता है: इस installation की TLS key को Secure Enclave से protect करता है, certificate trust जाँचता है, जरूरत पर ही trust माँगता है और GitHub Pages app खोलता है। Headless launch: `node js/bin/meta-sovereign.js serve --trust=true --open=true`। `--trust=false` और `--open=false` से opt out करें। Swift helper को macOS Command Line Tools चाहिए; unsupported Mac पर `--hardware-key=false` स्पष्ट रूप से file key चुनता है। Hardware protection disk की key पर लागू है; Node key को memory में उपयोग करता है। नियम और सीमाएँ: [local server setup और security](docs/LOCAL-SERVER-SECURITY.md)।
+
+खुली चैट पहले लोड होती है और लोडिंग या पुनःप्रयास की स्थिति दिखाती है। सभी / निजी / समूह / चैनल फ़िल्टर हर Telegram फ़ोल्डर में उपलब्ध हैं। कॉलम की चौड़ाई ऊर्ध्वाधर डिवाइडर खींचकर बदलें; आकार याद रखे जाते हैं। कॉल मुख्य मेनू में चैट के बाद है और Telegram खाता संपादन प्रोफ़ाइल में है। डार्क थीम में नियंत्रण सफ़ेद रेखा आइकन इस्तेमाल करते हैं। JS सर्वर OS उपयोगकर्ता की ऐप फ़ोल्डर में डेटा रखता है: macOS में `~/Library/Application Support/Meta Sovereign/store`, Windows में `%APPDATA%/Meta Sovereign/store` और Linux में `${XDG_CONFIG_HOME:-~/.config}/Meta Sovereign/store`। पुराने checkout से `serve` चलाने पर `.meta-sovereign` एक बार स्थानांतरित होता है; संदेश, संपर्क, सत्र, मीडिया और प्रमाणपत्र सुरक्षित रहते हैं तथा लिंक पुराने पथ बनाए रखता है। रीस्टार्ट और अलग कार्य निर्देशिका में वही स्टोर इस्तेमाल होता है। `--store` या `META_SOVEREIGN_STORE_DIR` से बदलें। [चैट और डेटा संग्रहण](docs/CHAT-READINESS.md) देखें।
 
 ## SPA को server से जोड़ें
 
@@ -78,6 +82,8 @@ SPA server को इस क्रम में चुनता है ([`js/src
 - **एकीकृत इनबॉक्स**: VK, Telegram, X, WhatsApp, Facebook, Instagram, LinkedIn, ईमेल, GitHub, Upwork, PeoplePerHour और जॉब बोर्ड; जहाँ नेटवर्क अनुमति देता है वहाँ लाइव अपडेट (Telegram, VK Long Poll, incremental IMAP, GitHub), बाकी के लिए किसी भी आकार के आर्काइव का आयात।
 - **Telegram के अपने ऐप जैसी चैट**: हर संदेश एक बार भेजा जाता है, डिलीवरी टिक, लाइव अपडेट और अंतराल के बाद catch-up, पढ़ा-चिह्न, cloud ड्राफ़्ट, reload के बाद भी बचे रहने वाले retry ([`docs/CHAT-REFERENCES.hi.md`](docs/CHAT-REFERENCES.hi.md))।
 - **CRM**: किसी संपर्क के बारे में सब कुछ एक दृश्य में, अलग-अलग नेटवर्क पर वही व्यक्ति, communities और सदस्यताएँ, खोज, नियम से ऑडियंस (`friends:vk & chat:vk:… - list:blocked`)।
+- **संपर्क आयात**: macOS Contacts (सिंक किए गए iCloud खातों सहित) या किसी भी प्लेटफ़ॉर्म के vCard निर्यात का पूर्वावलोकन करके आयात करें। दोबारा आयात करने पर रिकॉर्ड की पहचान बनी रहती है। निर्देशिका सिंक के दौरान अपडेट होती है और बिना संदेश वाले लोग भी दिखाती है। [संपर्क आयात](docs/CONTACTS-IMPORT.md) देखें।
+
 - **Outreach, broadcast और ऑटोमेशन**: किसे, कब, किन शर्तों पर और किस पाठ से लिखना है; कौन क्या पाएगा इसका preview; डिफ़ॉल्ट रूप से सुरक्षित ड्राफ़्ट, या quiet hours, हर चैट का cooldown, दैनिक सीमा और opt-out सूची के साथ धीमी गति से स्वचालित भेजना। हर स्वचालित भेजना एक ही outbox से जाता है: अधिक से अधिक एक बार, और अस्पष्ट परिणाम अपने आप दोहराया नहीं जाता ([`docs/USER-GUIDE.hi.md`](docs/USER-GUIDE.hi.md), §11)।
 - **Operator कतार और उत्तर**: अपठित संदेश चैट-दर-चैट, आपके पिछले उत्तरों से सुझाव (Tab एक चुनता है), पैटर्न और उत्तर के रूप, मिलते संदेश पर auto-reply।
 - **व्यवसाय और community खाते**: VK community token Bots Long Poll चलाता है; Telegram Business के quick replies, स्वागत और अनुपस्थिति संदेश, कार्य-समय और chatbots।

package/README.md

@@ -55,9 +55,13 @@ node js/bin/meta-sovereign.js serve
 
 Once the package is published to npm, `npx -y meta-sovereign serve` (or `npm install -g meta-sovereign && meta-sovereign serve`) will work. Until then, the desktop app (above) is the way to run the server without a toolchain.
 
-Either backend listens on <http://127.0.0.1:8787> by default. The JS server answers the hosted app's origin (`https://link-foundation.github.io`) with CORS headers; allow other origins with `meta-sovereign serve --allow-origin=<origins>` or `MS_ALLOW_ORIGINS`. Safari does not let `https` pages reach `http://127.0.0.1`, but it allows `https://127.0.0.1`; the server also answers HTTPS on the same port with its own certificate for localhost — run `node js/bin/meta-sovereign.js trust` once (macOS adds it to the login keychain; other systems print the certificate path), or open `https://127.0.0.1:8787/trust` in Safari and follow the prompts, and the hosted app connects directly. Before trusting, the notice names the server, links its own copy (<http://127.0.0.1:8787>) and a **Trust the server** link (<https://127.0.0.1:8787/trust>). `--tls=false` / `MS_TLS=off` turns HTTPS off; the server's own copy remains the fallback. The hosted SPA discovers the local server automatically through `discoverServer()` (saved override → `127.0.0.1` ports). If your browser does not auto-connect, open the in-app **Settings → Server** prompt and paste the URL the binary printed.
+Either backend listens on <http://127.0.0.1:8787> by default. The JS server answers the hosted app's origin (`https://link-foundation.github.io`) with CORS headers; allow other origins with `meta-sovereign serve --allow-origin=<origins>` or `MS_ALLOW_ORIGINS`. Safari does not let `https` pages reach `http://127.0.0.1`, but it allows `https://127.0.0.1`; the server also answers HTTPS on the same port with its own certificate for localhost — run `node js/bin/meta-sovereign.js trust` once (macOS adds it to the login keychain; other systems print the certificate path), or open `https://127.0.0.1:8787/trust` in Safari and follow the prompts, and the hosted app connects directly. Before trusting, the notice names the server and offers **Trust the server** (<https://127.0.0.1:8787/trust>); it links a localhost UI only if that UI was explicitly enabled. `--tls=false` / `MS_TLS=off` turns HTTPS off. Safari uses the hosted app through the trusted local HTTPS API; the localhost UI is optional. The hosted SPA discovers the local server automatically through `discoverServer()` (saved override → `127.0.0.1` ports). If your browser does not auto-connect, open the in-app **Settings → Server** prompt and paste the URL the binary printed.
 
-The hosted app is the default UI: `serve` prints its address, <https://link-foundation.github.io/meta-sovereign/>, and the app finds the server on our port 8787 by itself (it also looks at 8788, 7001, 7002 and 3000; on another port `serve` says to set it in **Settings → Server**), so the server does not have to host a web site. Its own copy at <http://127.0.0.1:8787> stays as a fallback for Safari and for working offline; `serve --local-ui=false` (or `MS_LOCAL_UI=off`) turns it off, and `/` then opens the hosted app. `--ui-url=<url>` (or `MS_UI_URL`) names another hosted copy, such as a fork's Pages, and allows its origin.
+The hosted app is the default UI: `serve` prints its address, <https://link-foundation.github.io/meta-sovereign/>, and the app finds the server on our port 8787 by itself (it also looks at 8788, 7001, 7002 and 3000; on another port `serve` says to set it in **Settings → Server**), so the server does not have to host a web site. By default `/` redirects to GitHub Pages and the server serves only its API, sync transports and connection helpers. To opt into a localhost web app for offline use, run `serve --local-ui=true` (or set `MS_LOCAL_UI=on`); that copy is then available at <http://127.0.0.1:8787>. Desktop shells explicitly enable their bundled UI. `--ui-url=<url>` (or `MS_UI_URL`) names another hosted copy, such as a fork's Pages, and allows its origin.
+
+On macOS, interactive `serve` now handles the full setup: it protects this installation’s TLS key with Secure Enclave, detects existing certificate trust, requests trust only when needed, and opens the GitHub Pages app. For a headless launch use `node js/bin/meta-sovereign.js serve --trust=true --open=true`. `--trust=false` and `--open=false` opt out. The Swift helper needs the macOS Command Line Tools; `--hardware-key=false` explicitly opts into a file key on unsupported Macs. Hardware protection applies to the key on disk; Node uses it in memory. See [local server setup and security](docs/LOCAL-SERVER-SECURITY.md) for the exact access rules and limits.
+
+Open conversations load first and show loading or retry status until their history is ready. All / Private / Groups / Channels filters remain available inside every Telegram folder. Drag the vertical dividers to resize columns; widths are remembered. Calls is in the main menu after Chat, and Telegram account editing is under Profile. The default dark controls use white line icons. The JS server keeps its store under your OS user: `~/Library/Application Support/Meta Sovereign/store` on macOS, `%APPDATA%/Meta Sovereign/store` on Windows, and `${XDG_CONFIG_HOME:-~/.config}/Meta Sovereign/store` on Linux. Starting `serve` from an older checkout migrates its `.meta-sovereign` store once, preserving messages, contacts, sessions, media and certificate; a compatibility link preserves old paths. Restarts and a different working directory reuse the same store. `--store` or `META_SOVEREIGN_STORE_DIR` override it. See [chat readiness and data storage](docs/CHAT-READINESS.md).
 
 ## Connect the SPA to your server
 
@@ -78,6 +82,8 @@ The full user-facing flow — install nothing, install Rust server, install JS s
 - **Unified inbox** across VK, Telegram, X, WhatsApp, Facebook, Instagram, LinkedIn, email, GitHub, Upwork, PeoplePerHour and job boards, with live updates where the network allows (Telegram, the VK Long Poll, incremental IMAP, GitHub) and full-size archive imports for the rest.
 - **Chat that behaves like Telegram's own apps**: each message sent once, delivery ticks, live updates and catch-up after a gap, read marking, cloud drafts, retries that survive a reload. How the open-source Telegram, Signal and Element clients do it, pinned to the commits we read, is in [`docs/CHAT-REFERENCES.md`](docs/CHAT-REFERENCES.md).
 - **CRM**: everything known about a contact in one view, the same person across networks, communities and memberships, search, audiences by rule (`friends:vk & chat:vk:… - list:blocked`).
+- **Contact imports**: preview and import macOS Contacts (including synced iCloud accounts) or vCard exports from any platform; repeated imports keep stable identities. The directory updates during sync and includes people without messages. See [contact imports](docs/CONTACTS-IMPORT.md).
+
 - **Outreach, broadcasts and automations**: who to message, when, on what conditions and with which text; a preview of who gets what; safe drafts by default or paced auto-send with quiet hours, a per-chat cooldown, daily caps and an opt-out list. Every automated send goes through one outbox, so it happens at most once and an unclear result is never retried by itself ([`docs/USER-GUIDE.md` §11](docs/USER-GUIDE.md#11-automations-message-people-by-rule-safely)).
 - **Operator queue and replies**: walk unread messages chat by chat, reply suggestions from your own past answers (Tab takes one), patterns and reply variations, auto-replies on a matching message.
 - **Business and community accounts**: a VK community token runs the Bots Long Poll; Telegram Business quick replies, greeting and away messages, hours and chatbots.

package/README.ru.md

@@ -55,9 +55,13 @@ node js/bin/meta-sovereign.js serve
 
 Когда пакет будет опубликован в npm, заработают `npx -y meta-sovereign serve` (или `npm install -g meta-sovereign && meta-sovereign serve`). До тех пор запустить server без toolchain можно через desktop app (выше).
 
-Оба backend по умолчанию слушают <http://127.0.0.1:8787>. JS server отвечает origin hosted app (`https://link-foundation.github.io`) с CORS headers; другие origins разрешаются через `meta-sovereign serve --allow-origin=<origins>` или `MS_ALLOW_ORIGINS`. Safari не пускает `https` страницы на `http://127.0.0.1`, но пускает на `https://127.0.0.1`; сервер теперь отвечает по HTTPS на том же порту с собственным сертификатом для localhost. Выполните `node js/bin/meta-sovereign.js trust` один раз (macOS добавляет сертификат в login keychain; на других системах печатается путь к сертификату) или откройте `https://127.0.0.1:8787/trust` в Safari и следуйте подсказкам — после этого hosted app в Safari подключается к серверу напрямую. До того уведомление называет сервер, даёт ссылку на его копию (<http://127.0.0.1:8787>) и **Доверять серверу** (<https://127.0.0.1:8787/trust>). `--tls=false` / `MS_TLS=off` отключает HTTPS; копия приложения с сервера остаётся запасным вариантом. Hosted SPA автоматически находит локальный сервер через `discoverServer()` (сохраненный override → порты `127.0.0.1`). Если браузер не подключился сам, откройте **Settings → Server** в приложении и вставьте URL, который напечатал сервер.
+Оба backend по умолчанию слушают <http://127.0.0.1:8787>. JS server отвечает origin hosted app (`https://link-foundation.github.io`) с CORS headers; другие origins разрешаются через `meta-sovereign serve --allow-origin=<origins>` или `MS_ALLOW_ORIGINS`. Safari не пускает `https` страницы на `http://127.0.0.1`, но пускает на `https://127.0.0.1`; сервер теперь отвечает по HTTPS на том же порту с собственным сертификатом для localhost. Выполните `node js/bin/meta-sovereign.js trust` один раз (macOS добавляет сертификат в login keychain; на других системах печатается путь к сертификату) или откройте `https://127.0.0.1:8787/trust` в Safari и следуйте подсказкам — после этого hosted app в Safari подключается к серверу напрямую. До того уведомление называет сервер и предлагает **Доверять серверу** (<https://127.0.0.1:8787/trust>); ссылка на localhost-копию появляется только при её явном включении. `--tls=false` / `MS_TLS=off` отключает HTTPS. Safari использует размещённое приложение через доверенный локальный HTTPS API; localhost-интерфейс необязателен. Hosted SPA автоматически находит локальный сервер через `discoverServer()` (сохраненный override → порты `127.0.0.1`). Если браузер не подключился сам, откройте **Settings → Server** в приложении и вставьте URL, который напечатал сервер.
 
-По умолчанию интерфейс — размещённое приложение: `serve` печатает его адрес, <https://link-foundation.github.io/meta-sovereign/>, а приложение само находит сервер на нашем порту 8787 (а также смотрит 8788, 7001, 7002 и 3000; на другом порту `serve` подскажет указать его в **Settings → Server**), так что серверу не нужно держать сайт. Своя копия на <http://127.0.0.1:8787> остаётся запасной — для Safari и работы без интернета; `serve --local-ui=false` (или `MS_LOCAL_UI=off`) её выключает, и тогда `/` открывает размещённое приложение. `--ui-url=<url>` (или `MS_UI_URL`) задаёт другую размещённую копию, например Pages форка, и разрешает её origin.
+По умолчанию интерфейс — размещённое приложение: `serve` печатает его адрес, <https://link-foundation.github.io/meta-sovereign/>, а приложение само находит сервер на нашем порту 8787 (а также смотрит 8788, 7001, 7002 и 3000; на другом порту `serve` подскажет указать его в **Settings → Server**), так что серверу не нужно держать сайт. По умолчанию `/` перенаправляет на GitHub Pages, а сервер предоставляет API, синхронизацию и вспомогательные маршруты подключения. Копия на localhost для работы без интернета включается отдельно: `serve --local-ui=true` (или `MS_LOCAL_UI=on`), после чего она доступна на <http://127.0.0.1:8787>. Desktop-оболочка явно включает свой встроенный интерфейс. `--ui-url=<url>` (или `MS_UI_URL`) задаёт другую размещённую копию, например Pages форка, и разрешает её origin.
+
+В macOS интерактивный `serve` выполняет настройку целиком: защищает TLS-ключ этой установки через Secure Enclave, проверяет доверие сертификату, запрашивает его только при необходимости и открывает приложение на GitHub Pages. Без интерактивного терминала: `node js/bin/meta-sovereign.js serve --trust=true --open=true`. `--trust=false` и `--open=false` отключают эти действия. Для Swift-помощника нужны macOS Command Line Tools; `--hardware-key=false` явно выбирает файловый ключ на неподдерживаемом Mac. Аппаратная защита действует на диске; Node использует ключ в памяти. Правила и ограничения: [настройка и безопасность локального сервера](docs/LOCAL-SERVER-SECURITY.md).
+
+Открытый чат загружается первым и показывает загрузку или ожидание повторной попытки. Фильтры Все / Личные / Группы / Каналы доступны внутри каждой папки Telegram. Вертикальные разделители меняют ширину столбцов; размеры запоминаются. Звонки находятся в главном меню после Чата, редактор аккаунта Telegram — в Профиле. В тёмной теме элементы управления используют белые контурные значки. JS-сервер хранит данные в папке пользователя ОС: `~/Library/Application Support/Meta Sovereign/store` в macOS, `%APPDATA%/Meta Sovereign/store` в Windows и `${XDG_CONFIG_HOME:-~/.config}/Meta Sovereign/store` в Linux. Запуск `serve` из старого checkout однократно переносит `.meta-sovereign`, сохраняя сообщения, контакты, сессии, медиа и сертификат; ссылка сохраняет старые пути. Перезапуск и другой рабочий каталог используют то же хранилище. Переопределение: `--store` или `META_SOVEREIGN_STORE_DIR`. См. [чаты и хранение данных](docs/CHAT-READINESS.md).
 
 ## Подключение SPA к серверу
 
@@ -78,6 +82,8 @@ SPA выбирает сервер в таком порядке ([`js/src/web/dis
 - **Единый inbox** для VK, Telegram, X, WhatsApp, Facebook, Instagram, LinkedIn, почты, GitHub, Upwork, PeoplePerHour и сайтов вакансий: живые обновления там, где сеть это позволяет (Telegram, VK Long Poll, инкрементальный IMAP, GitHub), и импорт архивов любого размера для остальных.
 - **Чат, который ведёт себя как приложения Telegram**: каждое сообщение отправляется один раз, галочки доставки, живые обновления и догрузка после разрыва, отметки о прочтении, облачные черновики, повторы, переживающие перезагрузку ([`docs/CHAT-REFERENCES.ru.md`](docs/CHAT-REFERENCES.ru.md)).
 - **CRM**: всё о контакте в одном окне, один и тот же человек в разных сетях, сообщества и членства, поиск, аудитории по правилам (`friends:vk & chat:vk:… - list:blocked`).
+- **Импорт контактов**: предпросмотр и импорт из Контактов macOS (включая синхронизированные учётные записи iCloud) или файлов vCard на любой платформе; повторный импорт сохраняет идентичность записей. Список обновляется при синхронизации и включает людей без сообщений. См. [импорт контактов](docs/CONTACTS-IMPORT.md).
+
 - **Рассылки, broadcast и автоматизации**: кому писать, когда, при каких условиях и каким текстом; предпросмотр, кто что получит; по умолчанию безопасные черновики или отправка с паузами, тихими часами, перерывом для каждого чата, дневными лимитами и списком отписавшихся. Каждая автоматическая отправка идёт через один outbox: не больше одного раза, а неясный результат сам не повторяется ([`docs/USER-GUIDE.ru.md`](docs/USER-GUIDE.ru.md), §11).
 - **Очередь оператора и ответы**: непрочитанные сообщения чат за чатом, подсказки ответов из ваших прошлых ответов (Tab берёт подсказку), паттерны и варианты ответов, автоответы на подходящее сообщение.
 - **Аккаунты бизнеса и сообществ**: токен сообщества VK запускает Bots Long Poll; Telegram Business: быстрые ответы, приветствие и сообщение об отсутствии, часы работы, чат-боты.

package/README.zh.md

@@ -55,9 +55,13 @@ node js/bin/meta-sovereign.js serve
 
 包发布到 npm 之后，`npx -y meta-sovereign serve`（或 `npm install -g meta-sovereign && meta-sovereign serve`）才会可用。在此之前，不想装工具链的话可以使用桌面 app（见上文）。
 
-两个后端默认监听 <http://127.0.0.1:8787>。JS 服务器会对托管 app 的 origin（`https://link-foundation.github.io`）返回 CORS 头；其他 origin 可以用 `meta-sovereign serve --allow-origin=<origins>` 或 `MS_ALLOW_ORIGINS` 允许。Safari 不允许 `https` 页面访问 `http://127.0.0.1`，但允许访问 `https://127.0.0.1`；服务器现在也在同一端口上提供 HTTPS 服务，并使用专为 localhost 颁发的自签名证书。运行一次 `node js/bin/meta-sovereign.js trust`（macOS：将证书添加到 login keychain；其他系统：打印证书路径），或在 Safari 中打开 `https://127.0.0.1:8787/trust` 并按提示操作，之后托管 app 在 Safari 中即可直接连接服务器。信任之前，提示会显示服务器地址，并提供其自带副本的链接（<http://127.0.0.1:8787>）以及 **信任服务器**（<https://127.0.0.1:8787/trust>）链接。`--tls=false` / `MS_TLS=off` 可关闭 HTTPS；服务器自带副本仍作为备用保留。托管的 SPA 会通过 `discoverServer()` 自动发现本地服务器（保存的覆盖值 → `127.0.0.1` 端口）。如果浏览器没有自动连接，请打开应用内 **Settings → Server**，粘贴服务器打印的 URL。
+两个后端默认监听 <http://127.0.0.1:8787>。JS 服务器会对托管 app 的 origin（`https://link-foundation.github.io`）返回 CORS 头；其他 origin 可以用 `meta-sovereign serve --allow-origin=<origins>` 或 `MS_ALLOW_ORIGINS` 允许。Safari 不允许 `https` 页面访问 `http://127.0.0.1`，但允许访问 `https://127.0.0.1`；服务器现在也在同一端口上提供 HTTPS 服务，并使用专为 localhost 颁发的自签名证书。运行一次 `node js/bin/meta-sovereign.js trust`（macOS：将证书添加到 login keychain；其他系统：打印证书路径），或在 Safari 中打开 `https://127.0.0.1:8787/trust` 并按提示操作，之后托管 app 在 Safari 中即可直接连接服务器。信任之前，提示会显示服务器地址及 **信任服务器**（<https://127.0.0.1:8787/trust>）链接；仅当显式启用 localhost 界面时才显示其链接。`--tls=false` / `MS_TLS=off` 可关闭 HTTPS。Safari 通过受信任的本地 HTTPS API 使用托管应用；localhost 界面是可选的。托管的 SPA 会通过 `discoverServer()` 自动发现本地服务器（保存的覆盖值 → `127.0.0.1` 端口）。如果浏览器没有自动连接，请打开应用内 **Settings → Server**，粘贴服务器打印的 URL。
 
-默认界面是托管的应用：`serve` 会打印其地址 <https://link-foundation.github.io/meta-sovereign/>，应用会自行在我们的端口 8787 上找到服务器（也会查看 8788、7001、7002 和 3000；若使用其他端口，`serve` 会提示在 **Settings → Server** 中设置），因此服务器无需自己托管网站。它在 <http://127.0.0.1:8787> 上的副本作为备用保留，供 Safari 和离线使用；`serve --local-ui=false`（或 `MS_LOCAL_UI=off`）可将其关闭，此时 `/` 会打开托管的应用。`--ui-url=<url>`（或 `MS_UI_URL`）指定另一个托管副本（例如某个 fork 的 Pages），并允许其 origin。
+默认界面是托管的应用：`serve` 会打印其地址 <https://link-foundation.github.io/meta-sovereign/>，应用会自行在我们的端口 8787 上找到服务器（也会查看 8788、7001、7002 和 3000；若使用其他端口，`serve` 会提示在 **Settings → Server** 中设置），因此服务器无需自己托管网站。默认情况下，`/` 重定向到 GitHub Pages，服务器只提供 API、同步传输和连接辅助路由。如需离线使用 localhost 网页，请显式运行 `serve --local-ui=true`（或设置 `MS_LOCAL_UI=on`），随后可在 <http://127.0.0.1:8787> 访问该副本。桌面壳会显式启用其内置界面。`--ui-url=<url>`（或 `MS_UI_URL`）指定另一个托管副本（例如某个 fork 的 Pages），并允许其 origin。
+
+在 macOS 交互式终端中，`serve` 会完成整个设置：使用 Secure Enclave 保护本次安装的 TLS 私钥，检测证书是否已受信任，仅在需要时请求信任，并打开 GitHub Pages 应用。无交互终端时可运行 `node js/bin/meta-sovereign.js serve --trust=true --open=true`。`--trust=false` 和 `--open=false` 可关闭相应操作。Swift 辅助程序需要 macOS Command Line Tools；不支持的 Mac 可显式使用 `--hardware-key=false` 选择文件密钥。硬件保护针对磁盘上的密钥；Node 在内存中使用密钥。详见[本地服务器设置与安全](docs/LOCAL-SERVER-SECURITY.md)。
+
+打开的聊天优先加载，并显示加载或重试状态。全部 / 私聊 / 群组 / 频道筛选在每个 Telegram 文件夹内都可用。拖动竖直分隔线调整列宽，尺寸会保存。通话位于主菜单聊天之后，Telegram 账户编辑移到个人资料。默认深色控件使用白色线条图标。 JS 服务器将数据保存在操作系统用户的应用文件夹：macOS 为 `~/Library/Application Support/Meta Sovereign/store`，Windows 为 `%APPDATA%/Meta Sovereign/store`，Linux 为 `${XDG_CONFIG_HOME:-~/.config}/Meta Sovereign/store`。从旧 checkout 启动 `serve` 会一次性迁移 `.meta-sovereign`，保留消息、联系人、会话、媒体和证书，并用兼容目录链接保留旧路径。重启或改变工作目录仍使用同一存储。可通过 `--store` 或 `META_SOVEREIGN_STORE_DIR` 覆盖。参见[聊天就绪与数据存储](docs/CHAT-READINESS.md)。
 
 ## 将 SPA 连接到服务器
 
@@ -78,6 +82,8 @@ SPA 按以下顺序选择服务器（[`js/src/web/discover.js`](js/src/web/disco
 - **统一收件箱**：覆盖 VK、Telegram、X、WhatsApp、Facebook、Instagram、LinkedIn、电子邮件、GitHub、Upwork、PeoplePerHour 和招聘网站；网络允许时实时更新（Telegram、VK Long Poll、增量 IMAP、GitHub），其余可导入任意大小的存档。
 - **像 Telegram 官方应用一样的聊天**：每条消息只发送一次，送达对勾，实时更新与断线后补齐，已读标记，云端草稿，刷新后仍保留的重试（[`docs/CHAT-REFERENCES.zh.md`](docs/CHAT-REFERENCES.zh.md)）。
 - **CRM**：一个视图看到联系人的全部信息，跨网络识别同一个人，社区与成员关系，搜索，按规则定义受众（`friends:vk & chat:vk:… - list:blocked`）。
+- **导入联系人**：预览并导入 macOS 通讯录（包括已同步的 iCloud 账户）或任何平台导出的 vCard；重复导入保留记录身份。目录在同步期间自动更新，也包含没有消息的联系人。参见[联系人导入](docs/CONTACTS-IMPORT.md)。
+
 - **外联、群发与自动化**：给谁发、何时发、在什么条件下发、发什么内容；预览谁会收到什么；默认生成安全草稿，或按节奏自动发送，并有安静时段、每个聊天的冷却期、每日上限和退订名单。每次自动发送都经过同一个发件箱：最多发送一次，结果不明时不会自行重试（[`docs/USER-GUIDE.zh.md`](docs/USER-GUIDE.zh.md) 第 11 节）。
 - **Operator 队列与回复**：逐个聊天处理未读消息，根据您以往的回答给出回复建议（按 Tab 采用），模式与回复变体，对匹配消息自动回复。
 - **企业与社区账号**：VK 社区令牌运行 Bots Long Poll；Telegram Business 的快捷回复、问候与离开消息、营业时间和聊天机器人。

package/js/src/cli/automation-commands.js

@@ -19,6 +19,7 @@
  * the chat menu does); with `--test` the conditions are ignored there.
  */
 
+import { defaultStoreDir } from '../storage/app-directory.js';
 import { promises as fs } from 'node:fs';
 import { createInterface } from 'node:readline/promises';
 import { getSource } from '../sources/index.js';
@@ -383,7 +384,7 @@ const automationsCmd = async (args, log, deps) => {
     log(`unknown subcommand "${sub}"\n${AUTOMATION_HELP}`);
     return 1;
   }
-  const store = await deps.openStore(args.store ?? '.meta-sovereign');
+  const store = await deps.openStore(args.store ?? defaultStoreDir());
   const { runner, close } = runnerFor(store, args, deps);
   try {
     return await handler({

package/js/src/cli/browser-open.js

@@ -0,0 +1,25 @@
+// Open the hosted face of the app, including when the local UI is enabled.
+import { spawn } from 'node:child_process';
+
+export const maybeOpenHostedApp = (args, handle, log) => {
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  const enabled =
+    args.open === undefined ? interactive : String(args.open) !== 'false';
+  if (args.foreground === false || !enabled) {
+    return;
+  }
+  const [program, ...prefix] =
+    process.platform === 'darwin'
+      ? ['open']
+      : process.platform === 'win32'
+        ? ['rundll32.exe', 'url.dll,FileProtocolHandler']
+        : ['xdg-open'];
+  const browser = spawn(program, [...prefix, handle.uiUrl], {
+    detached: true,
+    stdio: 'ignore',
+  });
+  browser.on('error', () =>
+    log(`open the app in your browser → ${handle.uiUrl}`)
+  );
+  browser.unref();
+};

package/js/src/cli/contact-commands.js

@@ -0,0 +1,43 @@
+// Local address-book imports, with the same parser and plan as the app.
+import { defaultStoreDir } from '../storage/app-directory.js';
+import { promises as fs } from 'node:fs';
+import { decodeVcard, parseVcard } from '../sources/vcard.js';
+import { readSystemContacts } from '../sources/system-contacts.js';
+import {
+  planContactsImport,
+  applyContactsImport,
+} from '../sources/contacts-import.js';
+
+export const CONTACTS_HELP = `  contacts-import [--file=<contacts.vcf> | --system] [--store=<dir>] [--preview]
+                import a vCard export or macOS Contacts (including synced iCloud accounts); nothing is uploaded`;
+
+export const createContactCommands = ({ openStore }) => ({
+  'contacts-import': async (args, log) => {
+    const system = args.system === true || args.system === 'true';
+    if (system === Boolean(args.file)) {
+      log('choose --file=<contacts.vcf> or --system');
+      return 1;
+    }
+    const storeDir = args.store ?? defaultStoreDir();
+    const store = await openStore(storeDir);
+    try {
+      const rows = system
+        ? await readSystemContacts(storeDir)
+        : parseVcard(decodeVcard(await fs.readFile(args.file)));
+      const plan = await planContactsImport(store, rows, {
+        source: system ? 'system' : 'vcard',
+      });
+      const preview = args.preview === true || args.preview === 'true';
+      log(
+        JSON.stringify(
+          preview
+            ? { preview: true, ...plan.stats }
+            : await applyContactsImport(store, plan)
+        )
+      );
+      return 0;
+    } finally {
+      await store.close?.();
+    }
+  },
+});

package/js/src/cli/cv-commands.js

@@ -11,6 +11,7 @@
  * this module importing the entry point back.
  */
 
+import { defaultStoreDir } from '../storage/app-directory.js';
 import {
   compareAllCvs,
   cvPlatformCatalogue,
@@ -147,7 +148,7 @@ const planCmd = async (args, log) => {
 };
 
 const readCmd = async (args, log, openStore, injected) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const ids = parsePlatforms(args.platforms);
   const { entries, failures } = await readAllCvs(
     ids,
@@ -168,7 +169,7 @@ const readCmd = async (args, log, openStore, injected) => {
 };
 
 const diffCmd = async (args, log, openStore) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const entries = await loadStoredCvs(store, parsePlatforms(args.platforms));
   const comparison = compareAllCvs(entries, { prefer: args.prefer ?? null });
   const diffs = diffAllCvs(entries, null);
@@ -213,7 +214,7 @@ const applyConfirmed = async (preview, { args, log, ask, run }) => {
 };
 
 const syncCmd = async (args, log, openStore, injected) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const ids = parsePlatforms(args.platforms);
   const run = (dryRun, confirmed = null) =>
     syncCvAcross(ids, {
@@ -256,7 +257,7 @@ const syncCmd = async (args, log, openStore, injected) => {
 };
 
 const telemetryCmd = async (args, log, openStore) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const events = await loadCvTelemetry(store, {
     runId: args.run ?? null,
     platform: args.platform ?? null,

package/js/src/cli/greetings-commands.js

@@ -11,6 +11,7 @@
  * its own `openStore`, and the tests inject fake source adapters.
  */
 
+import { defaultStoreDir } from '../storage/app-directory.js';
 import { parseList } from './cv-commands.js';
 import { getSource } from '../sources/index.js';
 import {
@@ -40,7 +41,7 @@ const optionalNumber = (value) =>
 
 const asJson = (value) => JSON.stringify(value, null, 2);
 
-const storeOf = (args, openStore) => openStore(args.store ?? '.meta-sovereign');
+const storeOf = (args, openStore) => openStore(args.store ?? defaultStoreDir());
 
 /**
  * `--stickers=vk:21,facebook:369239263222822` → selection entries. The

package/js/src/cli/index.js

@@ -13,7 +13,10 @@
  * entry point unit-testable.
  */
 
+import { defaultStoreDir, resolveUserStore } from '../storage/app-directory.js';
 import path from 'node:path';
+import { maybeOpenHostedApp } from './browser-open.js';
+import { CONTACTS_HELP, createContactCommands } from './contact-commands.js';
 import { promises as fs } from 'node:fs';
 import { parseArgs } from './lino-args.js';
 import { CV_HELP, createCvCommands } from './cv-commands.js';
@@ -25,7 +28,11 @@ import {
   GREETINGS_HELP,
   createGreetingCommands,
 } from './greetings-commands.js';
-import { TRUST_HELP, createTrustCommands } from './trust-commands.js';
+import {
+  TRUST_HELP,
+  createTrustCommands,
+  setupLocalCertificate,
+} from './trust-commands.js';
 import {
   MIGRATE_HELP,
   SCHEMA_ERROR_CODES,
@@ -83,10 +90,13 @@ Commands:
   backup        --store=<dir> --archive=<dir> [--keep=<n>]
   restore       --file=<path> --store=<dir> [--replace]
   passcode      --clear [--store=<dir>]   (remove a forgotten local passcode)
-  serve         [--port=<n>] [--store=<dir>] [--allow-origin=<origins|none>] [--ui-url=<url>] [--local-ui=false] [--tls=false] [--quiet-logs]
+  serve         [--port=<n>] [--store=<dir>] [--allow-origin=<origins|none>] [--ui-url=<url>] [--local-ui=true] [--tls=false] [--trust=true|false] [--hardware-key=false] [--open=true|false] [--quiet-logs]
+                open https://link-foundation.github.io/meta-sovereign/; the localhost UI is opt-in
+                on macOS: protect the TLS key with Secure Enclave; detect trust, set it up once in an interactive terminal
                 verbose logs are written to <store>/logs/meta-sovereign.log by default
                 https is served on the same port (for Safari); --tls=false or MS_TLS=off turns it off
 ${TRUST_HELP}
+${CONTACTS_HELP}
   sources
   source-pull   --source=<name> [--protocol=<p>] [--host=<mail-host>] [--owner=<o>] [--repo=<r>] [--state=<s>] [--offset=<n>] [--limit=<n>] [--store=<dir>]
   email-send    --protocol=<gmail|microsoft-graph|jmap|smtp> --to=<email> --subject=<s> --text=<body> [--host=<mail-host>]
@@ -135,14 +145,14 @@ const importCmd = async (args, log) => {
   const file = args.file;
   const archive = await fs.readFile(file, 'utf8');
   const parsed = file.endsWith('.json') ? JSON.parse(archive) : archive;
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const n = await importInto(store, args.source, parsed);
   log(`imported ${n} messages from ${args.source}`);
   return 0;
 };
 
 const exportCmd = async (args, log) => {
-  const store = await openReadOnly(args.store ?? '.meta-sovereign');
+  const store = await openReadOnly(args.store ?? defaultStoreDir());
   const links = await store.query();
   await fs.writeFile(args.file, JSON.stringify(links, null, 2));
   log(`exported ${links.length} links to ${args.file}`);
@@ -150,7 +160,7 @@ const exportCmd = async (args, log) => {
 };
 
 const backupCmd = async (args, log) => {
-  const store = await openReadOnly(args.store ?? '.meta-sovereign');
+  const store = await openReadOnly(args.store ?? defaultStoreDir());
   const file = await createBackup(store, { archiveDir: args.archive });
   if (args.keep) {
     await pruneBackups({ archiveDir: args.archive, keep: Number(args.keep) });
@@ -166,7 +176,7 @@ const passcodeCmd = async (args, log) => {
     log('usage: meta-sovereign passcode --clear [--store=<dir>]');
     return 1;
   }
-  const cleared = clearPasscode(args.store ?? '.meta-sovereign');
+  const cleared = clearPasscode(args.store ?? defaultStoreDir());
   log(cleared ? 'local passcode cleared' : 'no local passcode was set');
   return 0;
 };
@@ -176,7 +186,7 @@ const restoreCmd = async (args, log) => {
     // Swap the whole log in one step; the store must not be in use (R-Z16).
     const n = await restoreBackupToDir(
       args.file,
-      args.store ?? '.meta-sovereign',
+      args.store ?? defaultStoreDir(),
       {
         replace: true,
       }
@@ -184,7 +194,7 @@ const restoreCmd = async (args, log) => {
     log(`replaced the store with ${n} records from ${args.file}`);
     return 0;
   }
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const n = await restoreBackup(store, args.file);
   log(`restored ${n} links from ${args.file}`);
   return 0;
@@ -196,7 +206,7 @@ const serveOptions = (args) => ({
   // back to MS_ALLOW_ORIGINS and then the built-in defaults.
   ...(args['allow-origin'] ? { allowOrigins: args['allow-origin'] } : {}),
   // The hosted app is the UI; the server's own copy is a fallback
-  // that `--local-ui=false` turns off (R-Y58, R-Y59).
+  // enabled with `--local-ui=true` (R-Y58, R-Y59).
   ...(args['ui-url'] ? { uiUrl: args['ui-url'] } : {}),
   ...(args['local-ui'] !== undefined ? { localUi: args['local-ui'] } : {}),
   // https beside http on the same port, for Safari (R-Y64).
@@ -221,12 +231,12 @@ const logAddresses = (handle, log) => {
   log(
     handle.localUi
       ? `local copy (fallback, e.g. for Safari or offline) → ${origin}/`
-      : `local copy off: ${origin}/ opens the app above`
+      : `local copy off: ${origin}/ opens the app above (enable with --local-ui=true)`
   );
 };
 
 const serveCmd = async (args, log) => {
-  const storeDir = args.store ?? '.meta-sovereign';
+  const storeDir = args.store ?? defaultStoreDir();
   // Verbose logging is on by default: every request, event and error is
   // written to a file in the app folder (and echoed here), so the root
   // cause of any issue is always on disk. `--quiet-logs` opts out.
@@ -242,6 +252,9 @@ const serveCmd = async (args, log) => {
   }
   let handle;
   try {
+    if (args.foreground !== false) {
+      await setupLocalCertificate(args, log);
+    }
     handle = await startServer({
       port: Number(args.port ?? 8787),
       storeDir,
@@ -256,6 +269,7 @@ const serveCmd = async (args, log) => {
     return 1;
   }
   logAddresses(handle, log);
+  maybeOpenHostedApp(args, handle, log);
   if (serverLog) {
     log(`verbose logs → ${serverLog.file}`);
   }
@@ -300,7 +314,7 @@ const rawEmailTransport = (args, protocol) =>
     : null;
 
 const sourcePullCmd = async (args, log) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const protocol = args.protocol;
   const result = await pullLiveInto(store, args.source, {
     protocol,
@@ -371,7 +385,7 @@ const githubLiveFromArgs = (args) =>
   });
 
 const githubCloneCmd = async (args, log) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const live = githubLiveFromArgs(args);
   const result = await live.cloneRepo({
     owner: args.owner,
@@ -477,7 +491,7 @@ const peoplePerHourMessageCmd = boardMessageCmd(
 );
 
 const audienceCmd = async (args, log) => {
-  const store = await openReadOnly(args.store ?? '.meta-sovereign');
+  const store = await openReadOnly(args.store ?? defaultStoreDir());
   const all = await store.query();
   const matched = evalAudience(all, args.query ?? '');
   log(JSON.stringify(matched, null, 2));
@@ -485,7 +499,7 @@ const audienceCmd = async (args, log) => {
 };
 
 const factsCmd = async (args, log) => {
-  const store = await openReadOnly(args.store ?? '.meta-sovereign');
+  const store = await openReadOnly(args.store ?? defaultStoreDir());
   const all = await store.query();
   const messages = all.filter((l) => l.id?.startsWith('msg:'));
   const patterns = all
@@ -502,7 +516,7 @@ const factsCmd = async (args, log) => {
 };
 
 const searchCmd = async (args, log) => {
-  const store = await openReadOnly(args.store ?? '.meta-sovereign');
+  const store = await openReadOnly(args.store ?? defaultStoreDir());
   const results = await localSearch(store, {
     query: args.query ?? '',
     min: Number(args.min ?? 0.2),
@@ -512,7 +526,7 @@ const searchCmd = async (args, log) => {
 };
 
 const broadcastCmd = async (args, log) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const networks = (args.networks?.split(',') ?? listSources()).filter((n) =>
     listSources().includes(n)
   );
@@ -530,7 +544,7 @@ const broadcastCmd = async (args, log) => {
 };
 
 const listByPrefixCmd = (prefix) => async (args, log) => {
-  const store = await openReadOnly(args.store ?? '.meta-sovereign');
+  const store = await openReadOnly(args.store ?? defaultStoreDir());
   const all = await store.query();
   log(
     JSON.stringify(
@@ -553,7 +567,7 @@ const patternsInferCmd = async (args, log) => {
 };
 
 const graphsRunCmd = async (args, log) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const persisted = await store.get(args.id);
   if (!persisted) {
     log(`graph ${args.id} not found`);
@@ -576,7 +590,7 @@ const graphsRunCmd = async (args, log) => {
 };
 
 const profileCmd = async (args, log) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   if (args.name || args.bio) {
     const profile = {
       id: 'profile:me',
@@ -606,7 +620,7 @@ const profileCmd = async (args, log) => {
 };
 
 const resumeCmd = async (args, log) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   if (args.title || args.body) {
     const resume = {
       id: 'resume:me',
@@ -635,7 +649,7 @@ const resumeCmd = async (args, log) => {
 };
 
 const syncListenCmd = async (args, log) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const peer = createPeer(store, {
     node: 'cli-listener',
     schemaVersion: CURRENT_SCHEMA,
@@ -649,7 +663,7 @@ const syncListenCmd = async (args, log) => {
 };
 
 const syncConnectCmd = async (args, log) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const peer = createPeer(store, {
     node: 'cli-client',
     schemaVersion: CURRENT_SCHEMA,
@@ -667,7 +681,7 @@ const syncConnectCmd = async (args, log) => {
 };
 
 const outreachCmd = async (args, log) => {
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const all = await store.query();
   const matched = evalAudience(all, args.query ?? '');
   const replyGroup = args.reply
@@ -689,7 +703,7 @@ const exportEncryptedCmd = async (args, log) => {
     log('export-encrypted: --passphrase is required (R-K13)');
     return 1;
   }
-  const store = await openReadOnly(args.store ?? '.meta-sovereign');
+  const store = await openReadOnly(args.store ?? defaultStoreDir());
   const file = await writeEncryptedExport(store, args.file, {
     passphrase: args.passphrase,
   });
@@ -702,7 +716,7 @@ const purgeTombstonesCmd = async (args, log) => {
     log('purge-tombstones: refusing without --confirm=true (R-K4)');
     return 1;
   }
-  const store = await openStore(args.store ?? '.meta-sovereign');
+  const store = await openStore(args.store ?? defaultStoreDir());
   const idPrefix = args['id-prefix'] ?? null;
   const olderThan = args['older-than']
     ? new Date(args['older-than']).toISOString()
@@ -728,7 +742,7 @@ const purgeTombstonesCmd = async (args, log) => {
 };
 
 const vaultFile = (args) =>
-  args.file ?? path.join(args.store ?? '.meta-sovereign', 'vault.json');
+  args.file ?? path.join(args.store ?? defaultStoreDir(), 'vault.json');
 
 const vaultInitCmd = async (args, log) => {
   const file = vaultFile(args);
@@ -816,6 +830,7 @@ const COMMANDS = {
   ...createGreetingCommands({ openStore }),
   // Let Safari trust the server's own certificate (R-Y64).
   ...createTrustCommands(),
+  ...createContactCommands({ openStore }),
   // Bring a store to the current data schema, or look first (R-Z17).
   ...createMigrateCommands(),
   help: async (_a, log) => {
@@ -846,7 +861,26 @@ export const runCli = async (argv, { log = console.log } = {}) => {
     return 1;
   }
   try {
-    return await handler(parseArgs(rest), log);
+    const args = parseArgs(rest);
+    if (
+      args.store === undefined &&
+      ![
+        'help',
+        '--help',
+        '-h',
+        'version',
+        '--version',
+        '-v',
+        undefined,
+      ].includes(cmd)
+    ) {
+      args.store =
+        ['serve', 'trust'].includes(cmd) &&
+        !process.env.META_SOVEREIGN_STORE_DIR
+          ? await resolveUserStore({ log })
+          : defaultStoreDir();
+    }
+    return await handler(args, log);
   } catch (error) {
     if (error?.code === 'STORE_LOCKED' || SCHEMA_ERROR_CODES.has(error?.code)) {
       log(error.message); // another process owns the store (R-Z2); the schema (R-Z17)